joosy 1.2.0.alpha.73 → 1.2.0.beta.1

data/source/joosy/extensions/resources/base.coffee

@@ -1,282 +0,0 @@
-#
-# Basic data wrapper with triggering and entity name binding
-#
-# @example Basic usage
-#   class R extends Joosy.Resources.Base
-#     @entity 'r'
-#
-#     @beforeLoad (data) ->
-#       data.real = true
-#
-#   r = R.build {r: {foo: {bar: 'baz'}}}
-#
-#   r('foo')                  # {baz: 'baz'}
-#   r('real')                 # true
-#   r('foo.bar')              # baz
-#   r('foo.bar', 'fluffy')    # triggers 'changed'
-#
-# @include Joosy.Modules.Log
-# @include Joosy.Modules.Events
-# @include Joosy.Modules.Filters
-#
-# @method .beforeLoad(callback)
-#   Allows to modify data before it gets stored.
-#   You can define several beforeLoad filters that will be chained.
-#   @param [Function] action    `(Object) -> Object` to call
-#
-#
-class Joosy.Resources.Base extends Joosy.Function
-  @include Joosy.Modules.Log
-  @include Joosy.Modules.Events
-  @include Joosy.Modules.Filters
-
-  #
-  # Default primary key field 'id'
-  #
-  __primaryKey: 'id'
-
-  #
-  # Clears the identity map cache. Recomended to be called during layout switch to
-  # ensure correct garbage collection.
-  #
-  @resetIdentity: ->
-    Joosy.Resources.Base.identity = {}
-
-  @registerPlainFilters 'beforeLoad'
-
-  #
-  # Sets the field containing primary key.
-  #
-  # @note It has no direct use inside the REST resource itself and can be omited.
-  #   But it usually should not since we have plans on adding some kind of Identity Map to Joosy.
-  #
-  # @param [String] primary     Name of the field
-  #
-  @primaryKey: (primaryKey) ->
-    @::__primaryKey = primaryKey
-
-  #
-  # Sets the entity text name:
-  #   required to do some magic like skipping the root node.
-  #
-  # @param [String] name    Singular name of resource
-  #
-  @entity: (name) ->
-    @::__entityName = name
-
-  #
-  # Dynamically creates collection of inline resources.
-  #
-  # Inline resources share the instance with direct data and therefore can be used
-  #   to handle inline changes with triggers and all that resources stuff
-  #
-  # @example Basic usage
-  #   class Zombie extends Joosy.Resources.Base
-  #     @entity 'zombie'
-  #   class Puppy extends Joosy.Resources.Base
-  #     @entity 'puppy'
-  #     @map 'zombies'
-  #
-  #   p = Puppy.build {zombies: [{foo: 'bar'}]}
-  #
-  #   p('zombies')            # Direct access: [{foo: 'bar'}]
-  #   p.zombies               # Wrapped Collection of Zombie instances
-  #   p.zombies.at(0)('foo')  # bar
-  #
-  # @param [String] name    Pluralized name of property to define
-  # @param [Class] klass    Resource class to instantiate
-  #
-  @map: (name, klass=false) ->
-    unless klass
-      klass = window[name.singularize().camelize()]
-
-    if !klass
-      throw new Error "#{Joosy.Module.__className @}> class can not be detected for '#{name}' mapping"
-
-    @beforeLoad (data) ->
-      klass = klass() unless Joosy.Module.hasAncestor(klass, Joosy.Resources.Base)
-
-      @__map(data, name, klass)
-
-  #
-  # Wraps instance of resource inside shim-function allowing to track
-  # data changes. See class example
-  #
-  # @return [Joosy.Resources.Base]
-  #
-  @build: (data={}) ->
-    if Object.isNumber(data) || Object.isString(data)
-      id   = data
-      data = {}
-      data[@::__primaryKey] = id
-
-    klass = @::__entityName
-    id    = data[@::__primaryKey]
-
-    if klass? && id?
-      Joosy.Resources.Base.identity            ?= {}
-      Joosy.Resources.Base.identity[klass]     ?= {}
-      Joosy.Resources.Base.identity[klass][id] ?= new @ id: id
-
-      Joosy.Resources.Base.identity[klass][id].load data
-    else
-      new @ data
-
-  #
-  # Creates new instance of Resource using values from form
-  #
-  # @param [DOMElement] form      Form to grab
-  #
-  @grab: (form) ->
-    @build({}).grab form
-
-  #
-  # Should NOT be called directly, use {::build} instead
-  #
-  # @private
-  # @param [Object] data      Data to store
-  #
-  constructor: (data={}) ->
-    return super ->
-      @__fillData data, false
-
-  id: ->
-    @data?[@__primaryKey]
-
-  knownAttributes: ->
-    Object.keys @data
-
-  #
-  # Set the resource data manually
-  #
-  # @param [Object] data      Data to store
-  #
-  # @return [Joosy.Resources.Base]      Returns self
-  #
-  load: (data, clear=false) ->
-    @data = {} if clear
-    @__fillData data
-    return @
-
-  #
-  # Updates the Resource with a data from given form
-  #
-  # @param [DOMElement] form      Form to grab
-  #
-  grab: (form) ->
-    data = {}
-    for field in $(form).serializeArray()
-      unless data[field.name]
-        data[field.name] = field.value
-      else
-        data[field.name] = [data[field.name]] unless data[field.name] instanceof Array
-        data[field.name].push field.value
-
-    @load data
-
-  #
-  # Getter for wrapped data
-  #
-  # @param [String] path    Attribute name to get. Can contain dots to get inline Objects values
-  # @return [mixed]
-  #
-  __get: (path) ->
-    target = @__callTarget path, true
-
-    if !target
-      return undefined
-    else if target[0] instanceof Joosy.Resources.Base
-      return target[0](target[1])
-    else
-      return target[0][target[1]]
-
-  #
-  # Setter for wrapped data, triggers `changed` event.
-  #
-  # @param [String] path    Attribute name to set. Can contain dots to get inline Objects values
-  # @param [mixed] value    Value to set
-  #
-  __set: (path, value) ->
-    target = @__callTarget path
-
-    if target[0] instanceof Joosy.Resources.Base
-      target[0](target[1], value)
-    else
-      target[0][target[1]] = value
-
-    @trigger 'changed'
-    null
-
-  #
-  # Locates the actual instance of attribute path `foo.bar` from get/set
-  #
-  # @param [String] path    Path to the attribute (`foo.bar`)
-  # @param [Boolean] safe   Indicates whether nested hashes should not be automatically created when they don't exist
-  # @return [Array]         Instance of object containing last step of path and keyword for required field
-  #
-  __callTarget: (path, safe=false) ->
-    if path.has(/\./) && !@data[path]?
-      path    = path.split '.'
-      keyword = path.pop()
-      target  = @data
-
-      for part in path
-        return false if safe && !target[part]?
-
-        target[part] ||= {}
-        if target instanceof Joosy.Resources.Base
-          target = target(part)
-        else
-          target = target[part]
-
-      [target, keyword]
-    else
-      [@data, path]
-
-  #
-  # Wrapper for {Joosy.Resources.Base.build} magic
-  #
-  __call: (path, value) ->
-    if arguments.length > 1
-      @__set path, value
-    else
-      @__get path
-
-  #
-  # Defines how exactly prepared data should be saved
-  #
-  # @param [Object] data    Raw data to store
-  #
-  __fillData: (data, notify=true) ->
-    @raw  = data
-    @data = {} unless @hasOwnProperty 'data'
-
-    Joosy.Module.merge @data, @__prepareData(data)
-
-    @trigger 'changed' if notify
-
-    null
-
-  #
-  # Prepares raw data: cuts the root node if it exists, runs before filters
-  #
-  # @param [Hash] data    Raw data to prepare
-  # @return [Hash]
-  #
-  __prepareData: (data) ->
-    if Object.isObject(data) && Object.keys(data).length == 1 && @__entityName
-      name = @__entityName.camelize(false)
-      data = data[name] if data[name]
-
-    @__applyBeforeLoads data
-
-  __map: (data, name, klass) ->
-    if Object.isArray data[name]
-      entries = data[name].map (x) -> klass.build x
-      data[name] = new Joosy.Resources.Array entries...
-    else if Object.isObject data[name]
-      data[name] = klass.build data[name]
-    data
-
-  toString: ->
-    "<Resource #{@__entityName}> #{JSON.stringify(@data)}"

data/source/joosy/extensions/resources/index.coffee

@@ -1 +0,0 @@
-#= require_tree ./

data/source/joosy/extensions/resources-form/helpers/form.coffee

@@ -1,104 +0,0 @@
-#= require ../form
-
-#
-# Form helper
-#
-Joosy.helpers 'Application', ->
-
-  description = (resource, method, extendIds, idSuffix) ->
-    if Joosy.Module.hasAncestor resource.constructor, Joosy.Resources.Base
-      id        = resource.id()
-      resource  = resource.__entityName
-
-    name: resource + "#{if method.match(/^\[.*\]$/) then method else "[#{method}]"}"
-    id:   resource + (if id && extendIds then '_'+id else '') + "_#{method.parameterize().underscore()}" + (if idSuffix then '_'+idSuffix else '')
-
-  input = (type, resource, method, options={}) =>
-    d = description(resource, method, options.extendIds, options.idSuffix)
-    delete options.extendIds
-    delete options.idSuffix
-    @tag 'input', Joosy.Module.merge {type: type, name: d.name, id: d.id}, options
-
-  #
-  # @private
-  #
-  class Form
-    constructor: (@context, @resource, @options) ->
-
-    label: (method, options={}, content='') ->
-      if !Object.isObject(options)
-        content = options
-        options = {}
-
-      @context.label(@resource, method, Joosy.Module.merge(extendIds: @options.extendIds, options), content)
-
-    radioButton: (method, tagValue, options={}) -> @context.radioButton(@resource, method, tagValue, Joosy.Module.merge(extendIds: @options.extendIds, options))
-    textArea: (method, options={}) -> @context.textArea(@resource, method, Joosy.Module.merge(extendIds: @options.extendIds, options))
-    checkBox: (method, options={}, checkedValue=1, uncheckedValue=0) -> @context.checkBox(@resource, method, Joosy.Module.merge(extendIds: @options.extendIds, options), checkedValue, uncheckedValue)
-    select: (method, options={}, htmlOptions={}) -> @context.select @resource, method, options, Joosy.Module.merge(extendIds: @options.extendIds, htmlOptions)
-
-  ['text', 'file', 'hidden', 'password'].each (type) =>
-    Form.prototype[type+'Field'] = (method, options={}) ->
-      @context[type+'Field'] @resource, method, Joosy.Module.merge(extendIds: @options.extendIds, options)
-
-  @formFor = (resource, options={}, block) ->
-    if Object.isFunction(options)
-      block   = options
-      options = {}
-
-    uuid = Joosy.uuid()
-    form = @tag 'form', Joosy.Module.merge(options.html || {}, id: uuid), block?.call(this, new Form(this, resource, options))
-
-    @onRefresh? -> Joosy.Form.attach '#'+uuid, Joosy.Module.merge(options, resource: resource)
-
-    form
-
-  @label = (resource, method, options={}, content='') ->
-    if !Object.isObject(options)
-      content = options
-      options = {}
-
-    d = description(resource, method, options.extendIds)
-    delete options.extendIds
-
-    @contentTag 'label', content, Joosy.Module.merge(options, for: d.id)
-
-  ['text', 'file', 'hidden', 'password'].each (type) =>
-    @[type+'Field'] = (resource, method, options={}) -> input type, resource, method, options
-
-  @radioButton = (resource, method, tagValue, options={}) -> input 'radio', resource, method, Joosy.Module.merge(value: tagValue, idSuffix: tagValue, options)
-
-  @checkBox = (resource, method, options={}, checkedValue=1, uncheckedValue=0) ->
-    spy = @tag 'input', Joosy.Module.merge(name: description(resource, method).name, value: uncheckedValue, type: 'hidden')
-    box = input 'checkbox', resource, method, Joosy.Module.merge(value: checkedValue, options)
-
-    spy+box
-
-  @select = (resource, method, options, htmlOptions) ->
-    if Object.isObject options
-      opts = []
-      for key, val of options
-        opts.push [val, key]
-    else
-      opts = options
-    if htmlOptions.includeBlank
-      delete htmlOptions.includeBlank
-      opts.unshift ['', '']
-    opts = opts.reduce (str, vals) =>
-      params = if Object.isArray vals then ['option', vals[0], { value: vals[1] }] else ['option', vals, {}]
-      if htmlOptions.value == (if Object.isArray(vals) then vals[1] else vals)
-        params[2].selected = 'selected'
-      str += @contentTag.apply @, params
-    , ''
-    extendIds = htmlOptions.extendIds
-    delete htmlOptions.value
-    delete htmlOptions.extendIds
-    @contentTag 'select', opts, Joosy.Module.merge(description(resource, method, extendIds), htmlOptions)
-
-  @textArea = (resource, method, options={}) ->
-    value     = options.value
-    extendIds = options.extendIds
-    delete options.value
-    delete options.extendIds
-
-    @contentTag 'textarea', value, Joosy.Module.merge(description(resource, method, extendIds), options)

data/source/joosy/extensions/resources-form/index.coffee

@@ -1 +0,0 @@
-#= require_tree ./