luca 0.8.06 → 0.8.59

data/CHANGELOG

@@ -1,3 +1,34 @@
 0.7.3:
   - Models being loaded by the FormView will now call
-    beforeFormLoad methods if they exist on those models
+    beforeFormLoad methods if they exist on those models
+
+0.8.1
+  - Adds many style fixes for GridView
+  - Fixes style conflicts for Bootstrap grid-* css selectors
+  - Adds getForm() and getModel() methods to Luca.Field classes that belong to a form
+
+0.8.2
+  - Adds checkbox group field component ( thanks nick desteffen )
+
+0.8.3
+  - Stop mixing in underscore.string onto the global underscore object
+  - the ctype property used to create objects from hashes, can now be named 'type'
+  - Adds Luca.util.classify function for converting strings into class names
+
+0.8.4
+  - Fixes bug in development console
+  - Colorizes Development Console
+  - Introduces Luca.template helper to find template by regex in Luca.templates
+    or window.JST.  Optionally compiling the template if you pass variables to it.
+  - Introduces Luca.View.applyStyles which delegates to @$el.css
+
+0.8.5
+  - Luca.define() can be used to extend components, and retain references
+    to the inheritance chain.  Components defined this way will have
+    _className attributes as well as _superClass() references.  This
+    allows for introspection of components as well as advanced
+    querying of the Luca Component Cache
+
+  _ Added _.component as an alias to Luca.define
+
+  - All Luca components have been migrated over to the new Luca.define() API

data/Guardfile

@@ -5,18 +5,23 @@ javascript_path = File.join( assets_path, 'javascripts' )
 stylesheets_path = File.join( assets_path, 'stylesheets' )
 
 unless ENV['TEST_MODE']
-  guard 'sprockets2', :clean=>false, :assets_path => javascript_path, :sprockets => App.sprockets, :precompile=>[/^luca-ui.+(coffee|js)$/], :digest => false, :gz => false do
-    watch(%r{^src/.+$})
-    watch(%r{^spec/.+$})
+  unless ENV['SKIP_JAVASCRIPTS']
+    guard 'sprockets2', :clean=>false, :assets_path => javascript_path, :sprockets => App.sprockets, :precompile=>[/^luca-ui.+(coffee|js)$/], :digest => false, :gz => false do
+      watch(%r{^src/.+$})
+      watch(%r{^spec/.+$})
+    end
   end
 
-  guard 'sprockets2', :clean=>false, :assets_path => stylesheets_path, :sprockets => App.sprockets, :precompile=>[/^luca-ui.+(scss|css)$/], :digest => false, :gz => false do
-    watch(%r{^src/stylesheets/.+$})
+  unless ENV['SKIP_STYLESHEETS']
+    guard 'sprockets2', :clean=>false, :assets_path => stylesheets_path, :sprockets => App.sprockets, :precompile=>[/^luca-ui.+(scss|css)$/], :digest => false, :gz => false do
+      watch(%r{^src/stylesheets/.+$})
+    end
   end
 end
 
-# TODO: Couldn't detect phantomjs
-guard 'jasmine' do
-  watch(%r{src/(.+)\.coffee}) {|m| "spec/#{ m[1] }_spec.coffee" }
-  watch(%r{spec/(.+)_spec\.coffee})
+unless ENV['COMPILE_MODE']
+  guard 'jasmine' do
+    watch(%r{src/(.+)\.coffee}) {|m| "spec/#{ m[1] }_spec.coffee" }
+    watch(%r{spec/(.+)_spec\.coffee})
+  end
 end

data/app.rb

@@ -1,3 +1,4 @@
+#
 require 'rubygems'
 require 'bundler'
 Bundler.require

data/assets/javascripts/sandbox/config.coffee

@@ -1,4 +1,4 @@
-(window || global).Sandbox =
+window.Sandbox =
   views: {}
   collections: {}
   models: {}

data/assets/javascripts/sandbox/views/pages/pages_controller.coffee

@@ -1,4 +1,6 @@
 Sandbox.views.PagesController = Luca.components.Controller.extend
+  # the main component is the tab view which
+  # has its own individual demos
   components:[
     ctype: 'tab_view'
     name: 'pages_tab_view'
@@ -27,6 +29,10 @@ Sandbox.views.PagesController = Luca.components.Controller.extend
       ctype: 'development_console'
       name: 'development_console'
       title: "Development Console"
+    ,
+      ctype: "collection_inspector"
+      name: "collection_inspector"
+      title: "Collection Inspector"
     ]
   ]
 

data/lib/luca/rails/version.rb

@@ -1,6 +1,6 @@
 module Luca
   module Rails
-    VERSION = "0.8.06"
+    VERSION = "0.8.59"
   end
 end
 

data/spec/framework_spec.coffee

@@ -70,4 +70,36 @@ describe "The Luca Framework", ->
     expect( Luca.isBackboneModel({}) ).toEqual false
 
 
-describe
+describe "Luca Component Definition", ->
+  beforeEach ->
+    Luca.define("Luca.random.ComponentDefinition").extends("Luca.View").with
+      property: "value"
+
+  it "should create the namespace for us", ->
+    expect( Luca.random ).toBeDefined()
+
+  it "should automatically register the namespace in the registry", ->
+    expect( Luca.registry.namespaces ).toContain 'Luca.random'
+
+  it "should automatically register the component in the registry", ->
+    expect( Luca.registry.lookup("component_definition") ).toBeDefined()
+
+  it "should reference the name of the extending class", ->
+    instance = new Luca.random.ComponentDefinition
+    expect( instance._className ).toEqual "Luca.random.ComponentDefinition"
+
+  it "should reference the extended class", ->
+    instance = new Luca.random.ComponentDefinition
+    expect( instance._superClass() ).toEqual Luca.View
+
+  it "should reference the name of the extended class", ->
+    instance = new Luca.random.ComponentDefinition
+    expect( instance._superClass()._className ).toEqual 'Luca.View'
+
+  it "should use the backbone.extend functionality properly", ->
+    instance = new Luca.random.ComponentDefinition
+    expect( instance.property ).toEqual "value"
+
+  it "should alias to _.component", ->
+    proxy = _.component('Luca.random.ComponentDefition')
+    expect( proxy.with ).toBeDefined()

data/src/components/application.coffee

@@ -1,4 +1,4 @@
-Luca.Application = Luca.containers.Viewport.extend
+_.component('Luca.Application').extends('Luca.containers.Viewport').with
 
   components:[
     ctype: 'controller'
@@ -61,10 +61,8 @@ Luca.Application = Luca.containers.Viewport.extend
   # sort of data processing, whatever your application requires to run outside
   # of the views
   boot: ()->
-    console.log "Sup?"
     @trigger "ready"
 
-
   # delegate to the collection manager's get or create function.
   # use App.collection() to create or access existing collections
   collection: ()->

data/src/components/base_toolbar.coffee

@@ -1,16 +1,15 @@
-Luca.components.Toolbar = Luca.core.Container.extend
+_.component('Luca.components.Toolbar').extends('Luca.core.Container').with
+
   className: 'luca-ui-toolbar'
-  
+
   position: 'bottom'
 
   initialize: (@options={})->
     Luca.core.Container::initialize.apply @, arguments
 
   prepareComponents: ()->
-    _( @components ).each (component)=> 
+    _( @components ).each (component)=>
       component.container = @el
 
   render: ()->
-    $(@container).append(@el)
-
-Luca.register "toolbar", "Luca.components.Toolbar"
+    $(@container).append(@el)

data/src/components/collection_inspector.coffee

@@ -0,0 +1,2 @@
+_.component('Luca.components.CollectionInspector').extends('Luca.View').with
+  name: "collection_inspector"

data/src/components/collection_loader_view.coffee

@@ -2,8 +2,10 @@
 # You can provide your own template for the collection loader modal
 # if you want to. Default implementation uses twitter bootstrap modal and
 # progress bar (http://twitter.github.com/bootstrap/). You template
-# should have contain `progress`, `bar` and `message` classes
-Luca.components.CollectionLoaderView = Luca.components.Template.extend
+# should contain `progress`, `bar` and `message` classes
+_.component('Luca.components.CollectionLoaderView')
+.extends('Luca.components.Template').with
+
   className: 'luca-ui-collection-loader-view'
 
   template: "components/collection_loader_view"
@@ -24,14 +26,13 @@ Luca.components.CollectionLoaderView = Luca.components.Template.extend
       loaded   = @manager.loadedCollectionsCount()
       total    = @manager.totalCollectionsCount()
       progress = parseInt((loaded / total) * 100)
+      collectionName = _.string.titleize( _.string.humanize( name ) )
 
       @modalContainer().find('.progress .bar').attr("style", "width: #{progress}%;")
-      @modalContainer().find('.message').html("Loaded #{ _(name).chain().humanize().titleize().value() }...")
+      @modalContainer().find('.message').html("Loaded #{ collectionName }...")
 
     @manager.bind "all_collections_loaded", ()=>
       @modalContainer().find('.message').html("All done!")
       _.delay ()=>
         @modalContainer().modal('hide')
-      , 400
-
-Luca.register "collection_loader_view","Luca.components.CollectionLoaderView"
+      , 400

data/src/components/controller.coffee

@@ -1,4 +1,6 @@
-Luca.components.Controller = Luca.containers.CardView.extend
+_.component('Luca.components.Controller')
+.extends('Luca.containers.CardView').with
+
   initialize: (@options)->
     Luca.containers.CardView::initialize.apply @, arguments
 

data/src/components/development_console.coffee

@@ -1,5 +1,7 @@
-Luca.components.DevelopmentConsole = Luca.View.extend
+_.component('Luca.components.DevelopmentConsole').extends('Luca.View').with
+
   name: "development_console"
+
   className: 'luca-ui-development-console'
 
   initialize: (@options={})->
@@ -34,11 +36,12 @@ Luca.components.DevelopmentConsole = Luca.View.extend
 
       returnValue: (val)->
         return "undefined" unless val?
-        val?.toString()
+        val?.toString() || ""
 
       parseLine: (line)->
-        _( line ).strip()
+        line = _.string.strip(line)
         line = line.replace(/^return/,' ')
+
         "return #{ line }"
 
       commandHandle: (line)->
@@ -53,4 +56,4 @@ Luca.components.DevelopmentConsole = Luca.View.extend
           if error.message.match /circular structure to JSON/
             return ret.toString()
 
-          error.toString()
+          error.toString()

data/src/components/fields/button_field.coffee

@@ -1,5 +1,4 @@
-Luca.fields.ButtonField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.ButtonField').extends('Luca.core.Field').with
 
   readOnly: true
 
@@ -36,6 +35,4 @@ Luca.fields.ButtonField = Luca.core.Field.extend
     @icon_class = "icon-#{ @icon_class }" if @icon_class.length and !@icon_class.match(/^icon-/)
     @icon_class += " icon-white" if @white
 
-  setValue: ()-> true
-
-Luca.register "button_field", "Luca.fields.ButtonField"
+  setValue: ()-> true

data/src/components/fields/checkbox_array.coffee

@@ -0,0 +1,64 @@
+_.component('Luca.fields.CheckboxArray').extends('Luca.core.Field').with
+
+  template: "fields/checkbox_array"
+
+  events:
+    "click input" : "clickHandler"
+
+  initialize: (@options={})->
+    _.extend @, @options
+    _.extend @, Luca.modules.Deferrable
+    _.bindAll @, "populateCheckboxes", "clickHandler", "_updateModel"
+
+    Luca.core.Field::initialize.apply @, arguments
+
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
+    @label ||= @name
+    @valueField ||= "id"
+    @displayField ||= "name"
+    @selectedItems = []
+
+  afterInitialize: (@options={})->
+    try
+      @configure_collection()
+    catch e
+      console.log "Error Configuring Collection", @, e.message
+
+    @collection.bind "reset", @populateCheckboxes
+
+  afterRender: ()->
+    if @collection?.models?.length > 0
+      @populateCheckboxes()
+    else
+      @collection.trigger("reset")
+
+  clickHandler: (event)->
+    checkbox = event.target
+    if checkbox.checked
+      @selectedItems.push(checkbox.value)
+    else
+      if @selectedItems.indexOf(checkbox.value) isnt -1
+        @selectedItems = _.without(@selectedItems, [checkbox.value])
+
+    @_updateModel()
+
+  populateCheckboxes: ()->
+    controls = $(@el).find('.controls')
+    controls.empty()
+    unless _.isUndefined(@getModel())
+      @selectedItems = @getModel().get(@name)
+
+    @collection.each (model)=>
+      value = model.get(@valueField)
+      label = model.get(@displayField)
+      input_id = _.uniqueId('field')
+      controls.append(Luca.templates["fields/checkbox_array_item"]({label: label, value: value, input_id: input_id, input_name: @input_name}))
+      @$("##{input_id}").attr("checked", "checked") unless @selectedItems.indexOf(value) is -1
+
+    $(@container).append(@$el)
+
+  _updateModel: ()->
+    attributes = {}
+    attributes[@name] = @selectedItems
+    @getModel().set(attributes)

data/src/components/fields/checkbox_field.coffee

@@ -1,21 +1,20 @@
-Luca.fields.CheckboxField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.CheckboxField').extends('Luca.core.Field').with
 
   events:
     "change input" : "change_handler"
 
   change_handler: (e)->
     me = my = $(e.currentTarget)
-    
+
     @trigger "on:change", @, e
-    
+
     if me.checked is true
       @trigger "checked"
     else
       @trigger "unchecked"
 
   className: 'luca-ui-checkbox-field luca-ui-field'
-  
+
   template: 'fields/checkbox_field'
 
   hooks: ["checked","unchecked"]
@@ -27,8 +26,8 @@ Luca.fields.CheckboxField = Luca.core.Field.extend
     Luca.core.Field::initialize.apply @, arguments
 
   afterInitialize: ()->
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @input_value ||= 1
     @label ||= @name
 
@@ -36,6 +35,4 @@ Luca.fields.CheckboxField = Luca.core.Field.extend
     @input.attr('checked', checked)
 
   getValue:()->
-    @input.attr('checked') is true
-
-Luca.register "checkbox_field", "Luca.fields.CheckboxField"
+    @input.attr('checked') is true

data/src/components/fields/file_upload_field.coffee

@@ -1,5 +1,4 @@
-Luca.fields.FileUploadField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.FileUploadField').extends('Luca.core.Field').with
 
   template: 'fields/file_upload_field'
 
@@ -7,9 +6,7 @@ Luca.fields.FileUploadField = Luca.core.Field.extend
     Luca.core.Field::initialize.apply @, arguments
 
   afterInitialize: ()->
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @label ||= @name
     @helperText ||= ""
-
-Luca.register "file_upload_field", "Luca.fields.FileUploadField"

data/src/components/fields/hidden_field.coffee

@@ -1,5 +1,4 @@
-Luca.fields.HiddenField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.HiddenField').extends('Luca.core.Field').with
 
   template: 'fields/hidden_field'
 
@@ -7,12 +6,7 @@ Luca.fields.HiddenField = Luca.core.Field.extend
     Luca.core.Field::initialize.apply @, arguments
 
   afterInitialize: ()->
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @input_value ||= @value
-    @label ||= @name
-
-Luca.register "hidden_field", "Luca.fields.HiddenField"
-
-
-
+    @label ||= @name

data/src/components/fields/select_field.coffee

@@ -1,9 +1,8 @@
-Luca.fields.SelectField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.SelectField').extends('Luca.core.Field').with
 
   events:
     "change select" : "change_handler"
-  
+
   hooks:[
     "after:select"
   ]
@@ -17,16 +16,16 @@ Luca.fields.SelectField = Luca.core.Field.extend
   blankValue: ''
 
   blankText: 'Select One'
- 
+
   initialize: (@options={})->
     _.extend @, @options
     _.extend @, Luca.modules.Deferrable
     _.bindAll @, "change_handler", "populateOptions", "beforeFetch"
 
     Luca.core.Field::initialize.apply @, arguments
-    
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @label ||= @name
     @retainValue = true if _.isUndefined @retainValue
 
@@ -43,7 +42,7 @@ Luca.fields.SelectField = Luca.core.Field.extend
 
     @collection.bind "before:fetch", @beforeFetch
     @collection.bind "reset", @populateOptions
- 
+
   # if the select field is configured with a data property
   # then parse that data into the proper format.  either
   # an array of objects with the valueField and displayField
@@ -57,7 +56,7 @@ Luca.fields.SelectField = Luca.core.Field.extend
 
       hash
 
- 
+
   afterRender: ()->
     @input = $('select', @el)
 
@@ -65,7 +64,7 @@ Luca.fields.SelectField = Luca.core.Field.extend
       @populateOptions()
     else
       @collection.trigger("reset")
-  
+
   setValue: (value)->
     @currentValue = value
     Luca.core.Field::setValue.apply @, arguments
@@ -74,18 +73,18 @@ Luca.fields.SelectField = Luca.core.Field.extend
     @resetOptions()
 
   change_handler: (e)->
-    @trigger "on:change", @, e 
-    
+    @trigger "on:change", @, e
+
   resetOptions: ()->
     @input.html('')
-    
+
     if @includeBlank
       @input.append("<option value='#{ @blankValue }'>#{ @blankText }</option>")
 
 
   populateOptions: ()->
     @resetOptions()
-    
+
     if @collection?.each?
       @collection.each (model) =>
         value = model.get( @valueField )
@@ -93,8 +92,6 @@ Luca.fields.SelectField = Luca.core.Field.extend
         selected = "selected" if @selected and value is @selected
         option = "<option #{ selected } value='#{ value }'>#{ display }</option>"
         @input.append( option )
-    
-    @trigger "after:populate:options", @
-    @setValue( @currentValue )
 
-Luca.register "select_field", "Luca.fields.SelectField"
+    @trigger "after:populate:options", @
+    @setValue( @currentValue )

data/src/components/fields/text_area_field.coffee

@@ -1,5 +1,4 @@
-Luca.fields.TextAreaField = Luca.core.Field.extend
-  form_field: true
+_.component('Luca.fields.TextAreaField').extends('Luca.core.Field').with
 
   events:
     "keydown input" : "keydown_handler"
@@ -16,8 +15,8 @@ Luca.fields.TextAreaField = Luca.core.Field.extend
 
     Luca.core.Field::initialize.apply @, arguments
 
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @label ||= @name
     @input_class ||= @class
     @inputStyles ||= "height:#{ @height };width:#{ @width }"
@@ -27,7 +26,7 @@ Luca.fields.TextAreaField = Luca.core.Field.extend
 
   getValue: ()->
     $( @field() ).val()
-  
+
   field: ()->
     @input = $("textarea##{ @input_id }", @el)
 
@@ -38,6 +37,4 @@ Luca.fields.TextAreaField = Luca.core.Field.extend
     me = my = $( e.currentTarget )
 
   focus_handler: (e)->
-    me = my = $( e.currentTarget )
-
-Luca.register "text_area_field", "Luca.fields.TextAreaField"
+    me = my = $( e.currentTarget )

data/src/components/fields/text_field.coffee

@@ -1,6 +1,4 @@
-Luca.fields.TextField = Luca.core.Field.extend
-  form_field: true
-
+_.component('Luca.fields.TextField').extends('Luca.core.Field').with
   events:
     "keydown input" : "keydown_handler"
     "blur input" : "blur_handler"
@@ -13,15 +11,15 @@ Luca.fields.TextField = Luca.core.Field.extend
     _.bindAll @, "keydown_handler", "blur_handler", "focus_handler"
     Luca.core.Field::initialize.apply @, arguments
 
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @label ||= @name
     @input_class ||= @class
 
     if @prepend
-      @$el.addClass('input-prepend')  
+      @$el.addClass('input-prepend')
       @addOn = @prepend
-    
+
     if @append
       @$el.addClass('input-append')
       @addOn = @append
@@ -33,11 +31,6 @@ Luca.fields.TextField = Luca.core.Field.extend
 
   focus_handler: (e)->
     me = my = $( e.currentTarget )
-  
-  change_handler: (e)->
-    @trigger "on:change", @, e
-
-
-Luca.register "text_field", "Luca.fields.TextField"
-
 
+  change_handler: (e)->
+    @trigger "on:change", @, e

data/src/components/fields/type_ahead_field.coffee

@@ -1,10 +1,8 @@
-Luca.fields.TypeAheadField = Luca.fields.TextField.extend
-  form_field: true
-
+_.component('Luca.fields.TypeAheadField').extends('Luca.fields.TextField').with
   className: 'luca-ui-field'
 
   afterInitialize: ()->
-    @input_id ||= _.uniqueId('field') 
-    @input_name ||= @name 
+    @input_id ||= _.uniqueId('field')
+    @input_name ||= @name
     @label ||= @name
-  
+

data/src/components/form_button_toolbar.coffee

@@ -1,10 +1,12 @@
-Luca.components.FormButtonToolbar = Luca.components.Toolbar.extend
+_.component('Luca.components.FormButtonToolbar')
+.extends('Luca.components.Toolbar').with
+
   className: 'luca-ui-form-toolbar form-actions'
 
   position: 'bottom'
 
   includeReset: false
-  
+
   render: ()->
     $(@container).append(@el)
 
@@ -22,5 +24,3 @@ Luca.components.FormButtonToolbar = Luca.components.Toolbar.extend
         ctype: 'button_field'
         label: 'Reset'
         class: 'btn reset-button'
-
-Luca.register "form_button_toolbar", "Luca.components.FormButtonToolbar"