JSPM – @stamp/it@1.1.0

Package Exports

@stamp/it

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@stamp/it) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

# @stamp/it

Utility belt implementation of the compose standard

This module is the new cool modern version of the stampit module. Consider @stamp/it as stampit v4.

Usage

Install:

$ npm i -S @stamp/it

Import:

import stampit from '@stamp/it'

Or import utility functions only:

import {
    methods,
    
    props,
    properties,
    
    statics,
    staticProperties,
    
    conf,
    configuration,
    
    deepProps,
    deepProperties,
    
    deepStatics,
    staticDeepProperties,
    
    deepConf,
    deepConfiguration,
    
    init,
    initializers,
    
    composers,
    
    propertyDescriptors,
    
    staticPropertyDescriptors
} from '@stamp/it'

const Stamp1 = methods({ foo() {} })
const Stamp2 = props({ bar: 'my bar' })
const Stamp3 = conf({ my: 'configuration' })
const Stamp4 = init(function (options, {stamp, instance, args}) {
  console.log('bla')
})

API

Arguments

See more examples in this blog post.

Create a new empty stamp:

const S1 = stampit()

Create a new stamp with a method:

const S2 = stampit({
  methods: {
    myMethod() { }
  }
})

Create a new stamp with a property:

const S3 = stampit({
  props: { // or properties:
    myProperty: 42
  }
})

Create a new stamp with a static property:

const S4 = stampit({
  statics: { // or staticProperties:
    myStaticProperty: 42
  }
})

Create a new stamp with initializer(s):

const S5 = stampit({
  init: function () { console.log('hi form initializer') }
})
// or
const S6 = stampit({
  init: [ // or initializers:
    function () { },
    function () { }
  ]
})

Create a new stamp with a configuration:

const S7 = stampit({
  conf: { // or configuration:
    myConfiguration: { anything: 'here' }
  }
})

Compose the stamps above together:

const Stamp = compose(S1, S2, S3, S4, S5, S6, S7)
console.log(Stamp)
// { compose: [function] { properties, methods, staticProperties, initializers, configuration } }

const obj = Stamp()
console.log(obj)
// { myProperty: 42 }
console.log(Object.getPrototypeOf(obj))
// { myMethod: [function] }

See more examples in this blog post.

Static methods

The Stamp.create() static method

Calling Stamp.create() is identical to calling Stamp().

Shortcut static methods

All stamps receive few static properties. These are taken from the @stamp/shortcut stamp. For example:

stampit()
  .props({ foo: 'foo' })
  .deepConf({ things: ['bar'] })
  .methods({ baz() {} })
  // etc

Shortcut exported methods

The module exports a range of shortcut methods. These are taken from the @stamp/shortcut stamp.

import {methods, props, init, statics, /* etc */} from '@stamp/it'

Each returns a stampit-flavoured stamp.

NOTE! Unlike the @stamp/shortcut module, all the exported functions of @stamp/it are stampit-flavoured. Meaning that:

import {methods} from '@stamp/it'
const Stamp = methods({ foo() {} })
.props({bar: 1})                    // THIS WILL WORK
.statics({baz: 2})                  // AND THIS WILL WORK TOO