var stringlib = {
    prepend: function(str, chr) {
        return chr + str
    },
    append: function(str, chr) {
        return str + chr
    }
}
 
var chain = shackles(stringlib)
 
var result = chain('Hello')
    .prepend('(')
    .append('!')
    .append(')')
    .value() // (Hello!)

var chain = shackles(_)
 
var result = chain([1,2,3])
    .map(function (x) { return x*x })
    .filter(function (x) { return x > 2 })
    .value() // [4,9]

var chain = shackles({
    inc: function(x) { return x+1 }
    pi: 3.141592654
})
 
var result = chain(0)
    .inc()
    .inc()
    .num()
    .inc()
    .value() // 4.141592654

var chain = shackles(/* lib */)
 
var result = chain(10)
    .tap(function(value) {
        return value * 2;
    })
    .value() // 20

var chain = shackles({
    inc: function(x) { return x+1 }
})
 
var result = chain(0)
    .inc()
    .log() // 1
    .inc()
    .log() // 2
    .inc()
    .inc()
    .value() // 4

var doubled = null
 
var chain = shackles({}, {
    logger: {
        log: function(value) {
            doubled = value * 2
        }
    }
})
 
var result = chain(10)
    .log()
    .value() // 10
 
console.log(doubled) // 20

var history = []
 
var stringlib = {
    prepend: function(str, chr) {
        return chr + str
    },
    append: function(str, chr) {
        return str + chr
    }
}
 
var chain = shackles(stringlib, {
    logger: {
        log: function(value) {
            history.push(value)
        }
    }
})
 
var result = chain('Hello')
    .log(true)
    .prepend('(')
    .append('!')
    .append(')')
    .log(false)
    .append('?')
    .append('?')
    .append('?')
    .value() // (Hello!)???
 
console.log(history) 
/* [
    'Hello',
    '(Hello',
    '(Hello!',
    '(Hello!)'
]) */