ultimate-base 0.2.2 → 0.2.3

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ultimate-base (0.2.1)
+    ultimate-base (0.2.3)
 
 GEM
   remote: http://rubygems.org/

data/app/assets/javascripts/ultimate/backbone/app.js.coffee

@@ -1,4 +1,4 @@
-(@Ultimate ||= {}).Backbone ||= {}
+#= require ./base
 
 class Ultimate.Backbone.App
   @App: null
@@ -13,6 +13,7 @@ class Ultimate.Backbone.App
   scopes: ["Models", "Collections", "Routers", "Views"]
 
   constructor: (name = null) ->
+    Ultimate.Backbone.debug ".App.constructor()", @
     if @constructor.App
       throw new Error("Can't create new Ultimate.Backbone.App because the single instance has already been created");
     else

data/app/assets/javascripts/ultimate/backbone/base.js.coffee

@@ -0,0 +1,15 @@
+#= require ultimate/helpers
+
+(@Ultimate ||= {}).Backbone =
+
+  debugMode: false
+
+  debug: ->
+    if @debugMode
+      a = ["info", "Ultimate.Backbone"]
+      Array::push.apply a, arguments  if arguments.length > 0
+      cout.apply @, a
+
+  isView: (viewClass) -> viewClass instanceof Backbone.View
+
+  isViewClass: (viewClass) -> (viewClass::) instanceof Backbone.View

data/app/assets/javascripts/ultimate/backbone/collection.js.coffee

@@ -1,7 +1,11 @@
-(@Ultimate ||= {}).Backbone ||= {}
+#= require ./base
 
 class Ultimate.Backbone.Collection extends Backbone.Collection
 
+  constructor: ->
+    Ultimate.Backbone.debug ".Collection.constructor()", @
+    super
+
   ready: (callback, context = @) ->
     unless @length
       @readyDeferred ||= $.Deferred()

data/app/assets/javascripts/ultimate/backbone/extra/jquery-ext.js.coffee

@@ -0,0 +1,94 @@
+#= require ../base
+
+do ($ = jQuery) ->
+
+  # TODO arguments
+  $.fn.getViews = (viewClass = null, inheritance = false, domDeep = false) ->
+    if not @length
+      return []
+    else if @length is 1
+      views = @data("views") or []
+    else
+      # TODO check work and perf tests
+      views = _.flatten($(o).data("views") or []  for o in @, true)
+      #2: @map -> $(@).data("views") or []
+      #3: _.flatten ( @map -> $(@).data("views") or [] ), true
+    if viewClass?
+      _.filter views, if inheritance then (w) -> w instanceof viewClass else (w) -> w.costructor is viewClass
+    else
+      views
+
+  $.fn.getView = (viewClass, inheritance = false) ->
+    if _.isString(viewClass)
+      for o in @
+        views = $(o).data("views") or []
+        for view in views
+          return view  if view.constructor.className is viewClass
+    else if Ultimate.Backbone.isViewClass(viewClass)
+      for o in @
+        views = $(o).data("views") or []
+        if inheritance
+          for view in views
+            return view  if view instanceof viewClass
+        else
+          for view in views
+            return view  if view.constructor is viewClass
+    false
+
+  $.fn.hasView = (viewClass) ->
+    if _.isString(viewClass)
+      for o in @
+        return true  if _.any $(o).data("views") or [], (w) -> w.constructor.className is viewClass
+    else if Ultimate.Backbone.isViewClass(viewClass)
+      for o in @
+        return true  if _.any $(o).data("views") or [], (w) -> w.constructor is viewClass
+    false
+
+#  $.fn.bindOneView = (viewClass, options = {}) ->
+#    Ultimate.gcViews()
+#    bindedView = null
+#    if @length
+#      selector = "#{viewClass.selector}:not(.prevent-binding)"
+#      jContainer = if @is(selector) then @filter(selector) else @find(selector)
+#      if (l = jContainer.length)
+#        if l is 1
+#          bindedView = Ultimate.createView viewClass, jContainer, options
+#        else
+#          warning "$.fn.bindOneView() found #{l} elements by #{selector}, when need only 1"
+#      else
+#        warning "$.fn.bindOneView() not found elements by #{selector}"
+#    else
+#      warning "$.fn.bindOneView() call from empty jQuery()"
+#    bindedView
+#
+#  $.fn.bindView = (viewClass, options = {}) ->
+#    Ultimate.gcViews()
+#    bindedViews = []
+#    if @length
+#      ( if @is(viewClass.selector) then @ else @find(viewClass.selector) ).filter(":not(.prevent-binding)").each ->
+#        if viewClass.canCreateInstance()
+#          jContainer = $ @
+#          if view = Ultimate.createView viewClass, jContainer, options
+#            bindedViews.push view
+#        else
+#          false
+#    bindedViews
+#
+#  $.fn.bindViews = (viewClasses = Ultimate.LazyViews, options = {}) ->
+#    cout "info", "bindViews begin"
+#    bindedViews = []
+#    if @length
+#      bindedViews = for viewName, viewClass of viewClasses when viewClass.canCreateInstance()
+#        viewClass.constructor.className ||= viewName
+#        @bindView viewClass, options
+#    _.flatten bindedViews, true
+
+
+
+#  # TODO filtering by viewClass
+#  # TODO enother algorithm with enother projection
+#  $.fn.closestViews = (viewClass = null) ->
+#    views = []
+#    jTry = @
+#    jTry = jTry.parent()  while jTry.length and not (views = jTry.getViews()).length
+#    views

data/app/assets/javascripts/ultimate/backbone/extra/jquery-plugin-adapter.js.coffee

@@ -0,0 +1,66 @@
+#= require ./jquery-ext
+
+do ($ = jQuery) ->
+  $.fn.ultimateBackboneViewPluginAdapter = (pluginName, viewClass, pluginArgs) ->
+    a = []
+    Array::push.apply a, pluginArgs  if pluginArgs.length > 0
+    argsLength = a.length
+    # Shall return the View, if have arguments and last argument of the call is a Boolean true.
+    _returnView =
+      if argsLength and _.isBoolean(_.last(a))
+        argsLength--
+        a.pop()
+      else
+        false
+    unless @length
+      return if _returnView then undefined else @
+    # get the first   TODO analize, maybe each?
+    jContainer = @first()
+    # try to get the View-object, controlling everything that happens in our magical container
+    view = jContainer.getView(viewClass)
+    if view and view.$el[0] is jContainer[0]
+      command = null
+      if argsLength and _.isString(a[0])
+        command = a.shift()
+      else
+        return view  if _returnView
+        return jContainer  unless argsLength
+        command = "updateSettings"
+      if view[command]
+        return getValue(view, command)
+      else
+        $.error "Command [#{command}] does not exist on jQuery.#{pluginName}()"
+    else
+      options = if argsLength then a[0] else {}
+      if $.isPlainObject(options)
+        view = new viewClass(_.extend({}, options, el: jContainer[0]))
+      else
+        $.error "First argument of jQuery.#{pluginName}() must be plain object"
+    if _returnView then view else jContainer
+
+
+# TODO rewrite docs
+###
+ * Invoke Ultimate Flash functionality for the first element in the set of matched elements.
+ * If last argument {Boolean} true, then returns {View}.
+ * @usage
+ *** standart actions ***
+ * construction    .ultimateFlash([Object options = {}])                  ~ {jQuery} jContainer
+ * show            .ultimateFlash("show", String type, String text)       ~ {jQuery} jFlash | {Boolean} false
+ * notice          .ultimateFlash("notice", String text)                  ~ {jQuery} jFlash | {Boolean} false
+ * alert           .ultimateFlash("alert", String text)                   ~ {jQuery} jFlash | {Boolean} false
+ *** extended actions ***
+ * getSettings     .ultimateFlash("getSettings")                          ~ {Object} settings
+ * setSettings     .ultimateFlash("setSettings", {Object} settings)       ~ {jQuery} jContainer
+ * updateSettings  .ultimateFlash({Object} options)                       ~ {Object} settings
+ * auto            .ultimateFlash("auto", {ArrayOrObject} obj)            ~ {Array} ajFlashes | {Boolean} false
+ * ajaxSuccess     .ultimateFlash("ajaxSuccess"[, Arguments successArgs = []])
+ * ajaxError       .ultimateFlash("ajaxError"[, String text = settings.translations.defaultErrorText][, Arguments errorArgs = []])
+###
+
+Ultimate.Backbone.createJQueryPlugin = (pluginName, viewClass) ->
+  cout "info", "Ultimate.Backbone.createJQueryPlugin", pluginName, viewClass
+  if Ultimate.Backbone.isViewClass(viewClass)
+    jQuery.fn[pluginName] = -> @ultimateBackboneViewPluginAdapter pluginName, viewClass, arguments
+  else
+    jQuery.error "Second argument of Ultimate.Backbone.createJQueryPlugin() must be View class inherited from Backbone.View"

data/app/assets/javascripts/ultimate/backbone/model.js.coffee

@@ -1,7 +1,11 @@
-(@Ultimate ||= {}).Backbone ||= {}
+#= require ./base
 
 class Ultimate.Backbone.Model extends Backbone.Model
 
+  constructor: ->
+    Ultimate.Backbone.debug ".Model.constructor()", @
+    super
+
   ready: (callback, context = @) ->
     if _.isEmpty(@attributes)
       @readyDeferred ||= $.Deferred()

data/app/assets/javascripts/ultimate/backbone/router.js.coffee

@@ -1,7 +1,11 @@
-(@Ultimate ||= {}).Backbone ||= {}
+#= require ./base
 
 class Ultimate.Backbone.Router extends Backbone.Router
 
+  constructor: ->
+    Ultimate.Backbone.debug ".Router.constructor()", @
+    super
+
   namedParam    = /:\w+/g
   splatParam    = /\*\w+/g
   escapeRegExp  = /[-[\]{}()+?.,\\^$|#\s]/g

data/app/assets/javascripts/ultimate/backbone/view.js.coffee

@@ -1,4 +1,4 @@
-(@Ultimate ||= {}).Backbone ||= {}
+#= require ./base
 
 class Ultimate.Backbone.View extends Backbone.View
 
@@ -11,13 +11,24 @@ class Ultimate.Backbone.View extends Backbone.View
   loadingOverlayClass: "loading-overlay"
 
   constructor: ->
+    Ultimate.Backbone.debug ".View.constructor()", @
     super
 
 
 
-  # Overload parent method Backbone.View.setElement() as hook for findNodes().
-  setElement: (element, delegate) ->
+  # Overload parent method Backbone.View.setElement() as hook for findNodes() and trick for data("views").
+  setElement: (element, delegate, sideCall = false) ->
+    if @$el?.length and not sideCall
+      views = @$el.data("views")
+      for view in views  when view isnt @
+        view.setElement element, delegate, true
+      @$el.data("views", [])
     super
+    if @$el.length
+      if views = @$el.data("views")
+        views.push @
+      else
+        @$el.data "views", [@]
     @findNodes()
     @
 
@@ -53,9 +64,10 @@ class Ultimate.Backbone.View extends Backbone.View
       normalizedEvents = {}
       for key, method of events
         [[], eventName, selector] = key.match(delegateEventSplitter)
-        jObj = @[selector]
-        if jObj instanceof jQuery and _.isString(jObj.selector)
-          key = "#{eventName} #{jObj.selector}"
+        selector = getValue(@, selector)
+        selector = selector.selector if selector instanceof jQuery
+        if _.isString(selector)
+          key = "#{eventName} #{selector}"
         normalizedEvents[key] = method
       events = normalizedEvents
     events
@@ -67,7 +79,8 @@ class Ultimate.Backbone.View extends Backbone.View
     super
     @reflectOptions()
 
-  reflectOptions: (viewOptions = @viewOptions, options = @options) ->
+  reflectOptions: (viewOptions, options = @options) ->
+    viewOptions = getValue(@, "viewOptions")  unless viewOptions
     @[attr] = options[attr]  for attr in viewOptions  when options[attr]
 
 

data/app/assets/javascripts/ultimate/backbone/views/typed-fields.js.coffee

@@ -0,0 +1,40 @@
+#= require ultimate/improves/typed-fields
+
+Ultimate.Backbone.Views ||= {}
+
+class Ultimate.Backbone.Views.TypedFields extends Ultimate.Backbone.View
+
+  selector: "input:text[data-data-type], input:text[data-regexp-mask]"
+
+  events: ->
+    "keypress   selector": "onKeyPress"
+    "change     selector": "onChange"
+    "paste      selector": "onPasteOrDrop"
+    "drop       selector": "onPasteOrDrop"
+
+  viewOptions: ["selector"]
+
+  onKeyPress: (event) ->
+    if event.metaKey
+      @onPasteOrDrop event
+      return true
+    return true  unless event.charCode
+    jField = $(event.currentTarget)
+    oldValue = jField.val()
+    newValue = oldValue.substring(0, @selectionStart) + String.fromCharCode(event.charCode) + oldValue.substring(@selectionEnd)
+    return false  unless jField.getRegExpMask().test(newValue)
+    jField.data "value", newValue
+
+  onChange: (event) ->
+    jField = $(event.currentTarget)
+    if jField.getRegExpMask().test(jField.val())
+      jField.data "value", jField.val()
+    else
+      jField.val jField.data("value")
+
+  onPasteOrDrop: (event) ->
+    setTimeout ( -> $(event.currentTarget).trigger "change", arguments ), 100
+
+
+
+Ultimate.Backbone.createJQueryPlugin? "typedFields", Ultimate.Backbone.Views.TypedFields

data/app/assets/javascripts/ultimate/improves/{typed-field.js.coffee → typed-fields.js.coffee}

@@ -70,33 +70,4 @@
         .change()
     @
 
-  #class Backbone.Ultimate.
-
-  $.fn.observeTypedFields = (selector = 'input:text[data-data-type], input:text[data-regexp-mask]') ->
-
-
-    return @  unless @length
-
-    @on 'keypress', selector, (event) ->
-      if event.metaKey
-        $(@).trigger 'paste', arguments
-        return true
-      return true  unless event.charCode
-      jThis = $ @
-      oldValue = jThis.val()
-      newValue = oldValue.substring(0, @selectionStart) + String.fromCharCode(event.charCode) + oldValue.substring(@selectionEnd)
-      return false  unless jThis.getRegExpMask().test(newValue)
-      jThis.data 'value', newValue
-
-    @on 'change', selector, ->
-      jThis = $ @
-      if jThis.getRegExpMask().test(jThis.val())
-        jThis.data 'value', jThis.val()
-      else
-        jThis.val jThis.data('value')
-        
-    @on 'paste drop', selector, ->
-      jThis = $ @
-      setTimeout ( -> jThis.trigger 'change', arguments ), 100
-
 )( jQuery )

data/lib/ultimate-base/version.rb

@@ -1,5 +1,5 @@
 module Ultimate
   module Base
-    VERSION = "0.2.2"
+    VERSION = "0.2.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ultimate-base
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-14 00:00:00.000000000 Z
+date: 2012-08-15 00:00:00.000000000 Z
 dependencies: []
 description: Ultimate UI core, base helpers and improves for Ruby on Rails Front-end
 email:
@@ -27,12 +27,16 @@ files:
 - README.md
 - Rakefile
 - app/assets/javascripts/ultimate/backbone/app.js.coffee
+- app/assets/javascripts/ultimate/backbone/base.js.coffee
 - app/assets/javascripts/ultimate/backbone/collection.js.coffee
+- app/assets/javascripts/ultimate/backbone/extra/jquery-ext.js.coffee
+- app/assets/javascripts/ultimate/backbone/extra/jquery-plugin-adapter.js.coffee
 - app/assets/javascripts/ultimate/backbone/lib/backbone.js
 - app/assets/javascripts/ultimate/backbone/model.js.coffee
 - app/assets/javascripts/ultimate/backbone/router.js.coffee
 - app/assets/javascripts/ultimate/backbone/view.js.coffee
 - app/assets/javascripts/ultimate/backbone/views/slider.js.coffee
+- app/assets/javascripts/ultimate/backbone/views/typed-fields.js.coffee
 - app/assets/javascripts/ultimate/base.js.coffee
 - app/assets/javascripts/ultimate/bus.js.coffee
 - app/assets/javascripts/ultimate/devise.js.coffee
@@ -52,7 +56,7 @@ files:
 - app/assets/javascripts/ultimate/improves/form.js.coffee
 - app/assets/javascripts/ultimate/improves/magic-radios.js.coffee
 - app/assets/javascripts/ultimate/improves/tablesorter.js
-- app/assets/javascripts/ultimate/improves/typed-field.js.coffee
+- app/assets/javascripts/ultimate/improves/typed-fields.js.coffee
 - app/assets/javascripts/ultimate/underscore/underscore.js
 - app/assets/javascripts/ultimate/underscore/underscore.string.js
 - app/assets/javascripts/ultimate/widgets/dock.js.coffee