json-strict/src/prim/optional.coffee

Json Specification & Validation & Document Generation

require 'coffee-mate/global'
{typeclass, instance} = require '../typeclass'
{shape, match, constraints, show, samples, sample, htmlInline, htmlBlock} = require '../typespec'
{expandBlockHead, isTypeSpec} = require '../helpers'

class Optional
	constructor: (spec) ->
		unless isTypeSpec(spec)
			throw Error "Bad Optional Type Definition: TypeSpec as spec Expected"

		return {
			constructor: Optional
			spec: spec
		}

instance('TypeSpec')(Optional).where
	shape: ({spec}) -> Optional shape(spec)
	match: ({spec}) -> (v) ->
		not v? or match(spec) v
	constraints: (t) -> (v) -> if not v? then [] else [
		{
			label: -> "#{show t} Expected"
			sub: -> constraints(t.spec)(v)
		}
	]
	show: ({spec}) ->
		"Optional(#{show spec})"
	samples: ({spec}) ->
		ls = list take(2) samples spec
		concat repeat [ls[0], null, ls[1], undefined]
	htmlInline: ({spec}) ->
		"<span class='type-maker unwrapped'>Optional #{htmlInline spec}</span>"
	htmlBlock: ({spec}) ->
		expandBlockHead((head) ->
			"<span class='type-maker'>Optional #{head}</span>"
		) spec

module.exports = {Optional}