luca 0.9.9 → 0.9.42

data/CHANGELOG

@@ -85,26 +85,26 @@
 0.9.1
   - Bugfix Release
 
-0.9.2
+0.9.2 
   - FormView has errorMessage, successMessage methods which use twitter bootstrap alerts as flash message
   - FormView toolbar accepts new options: true, both, bottom, or top
   - Luca.Collection has a property @remoteFiltering which makes applyFilter always use remote fetch
   - Bugfix in GridView collection change handler
   - Added Luca.isViewPrototype, Luca.isModelPrototype, Luca.isCollectionPrototype helpers
   - Added configuration option to control auto registration of components with the registry
-  - Added Luca.parentClass and Luca.inheritanceChain methods for inspecting a component or prototype
+  - Added Luca.parentClass and Luca.inheritanceChain methods for inspecting a component or prototype  
   - Changed single instance tracking mechanism on CollectionManager.  Will throw an error if more than one
     is created without specifying a name.
   - Added Luca.getCollectionManager() helper as an Alias for Luca.CollectionManager.get()
   - Luca.getApplication() and Luca.getCollectionManager() accept a name argument
   - Classes like Luca.Application and Luca.CollectionManager which normally are singletons
-    can have more than one instance if a unique name is given
+    can have more than one instance if a unique name is given 
 
 0.9.3
   - CardViews and Controllers set data attributes on their elements for the active card / page
   - Added convenience methods to container 'pluck', 'invoke'
   - Added methods to Controller for ease of autogenerating routes
-  - Added beforeInitialize hook on Luca.View
+  - Added beforeInitialize hook on Luca.View 
   - Luca.View can now automatically configure state machine models by passing `stateful:true`
     in your view definition.
   - Containers will respond to getter attributes set on their components, by defining a getter
@@ -118,9 +118,9 @@
   - adding a Luca.PageController component as an alias for Controller
 
 0.9.33
-  - added gridSpan property to Luca.View.  This will automatically add the span class for you to snap your view to the grid.
+  - added gridSpan property to Luca.View.  This will automatically add the span class for you to snap your view to the grid.  
     Accepts a number 0-12.
-  - fixed a bug in CardView.componentElements method with bodyClassName being present
+  - fixed a bug in CardView.componentElements method with bodyClassName being present 
   - Added LabelView component.  A form field which just displays a value.
 
 0.9.35
@@ -134,156 +134,12 @@
 
 0.9.4
   - Luca::Template can now configure its namespace, removing duplicate sprockets class
-  - Luca.Application triggers page:change and sub:page:change events
+  - Luca.Application triggers page:change and sub:page:change events  
   - Luca.Viewport gets enable / disable method for fluid and fullscreen mode
   - Add configurability to fullscreen behavior on viewport
 
 0.9.41
   - Changed asset pipeline payload so that luca-ui uses the index convention
 
-0.9.42
-  - Added TableView component, which inherits from Luca.components.CollectionView
-  - Expose ways of customizing Luca.View internals.
-  - Added support for @template property on Luca.View. Behaves the same as @bodyTemplate
-
-0.9.45
-  - Luca.decorate( componentPrototype ).with( mixinName ), Luca.mixin( mixinName )
-  - View mixins use _initializer methods
-  - FilterableView mixin for CollectionView classes
-  - Added Rails Generator for Luca.Application skeleton. ( thanks @nick-desteffen )
-  - Adds ability to pass a function reference as a component.  The container will call the function, in
-    the context of the container, and use the returned object as the component definition template
-  - Adds a defaults property to containers.  This will apply the values as defaults to each component.
-  - Adds Luca.EventsExt an optional core extension which provides additional event binding sugar
-  - Fixes to CollectionView
-  - Improved container / component bindings via html data attributes
-  - bugfixes in CardView
-
-0.9.5
-  - Luca.Model gets a 'read' method which will a getter function,
-    or get an attribute for the given property you are trying to 'read'
-  - CollectionView is modifiable through several mixins:
-    - Filterable
-    - Paginatable
-    - Loadmaskable
-  - Introduces component definition helpers: extends,
-    behavesAs, triggers, defaultsTo which allow for a more
-    "literate" component definiton style
-  - View helpers moved into mixins:
-    - StateModel
-    - EnhancedProperties
-    - CollectionEventBindings
-    - ApplicationEventBindings
-  - Changed syntax for @componentEvents configuration on Luca.core.Container.
-    - now accepts role, name, or getter method
-    - now accepts * for component, to bind to the same event on all components
-
-0.9.65
-  - Luca.core.Container components can now be configured with a @container property
-    which accepts any valid CSS selector so long as it is scoped within that container view's @$el.
-    Previously required an element with a specific ID which made it harder to build extendable components
-    with specific render targets
-
-0.9.66
-  - Luca.core.Container components can now be extended by subclasses by specifying an @extensions property.
-    @extensions work by applying the hash to the component in the same index'd position as that component
-    configuration in the superclass.
-  - Luca.components.CollectionView now has a @loadModels() method which resets the collection with the passed models.
-  - Added @componentMetaData() method which is going to replace the trickery done behind the scenes in Luca.extend
-  - Luca.config.autoApplyCssClassHierarchy if set to true, will add css class names to your luca components to make inheritance based styling easier.
-
-0.9.7
-  - Introduced publicInterface, publicConfiguration, privateInterface, and privateConfiguration as component registry methods.
-    These methods are intended to offer finer grain control over the component definition process for the purposes of building
-    our auto-generated documentation tool.
-  - Added Luca.concern support on Collection and Model
-  - Renaming 'mixin' and 'module' functionality to 'concern'
-  - Luca.concerns now follow the active support concern in spirit, with __included hooks, ClassMethods handling, etc
-  - Introducing an optional Concern for Luca.Model classes, called ModelPresenter.
-  - The callback argument passed to CardView activate, now gets called in the context of the activated component
-
-0.9.75
-  - Component registration is now beautifully readable and self documenting,
-    and flexible.  Minimally only requires one call to Luca.register().  
-    This allows you to be as descriptive as you like when defining a component, 
-    and does not require you to call any definition methods which do not 
-    make literary sense in your component description. 
-
-  - Component definition now supports specifying class methods.
-
-  - Luca.initialize('Namespace') will setup a complete namespace for 
-    your application, and give you a Namespace() method which works similar
-    to the Luca() helper.
-
-  - Added Luca.config.modelBootrstrap and Luca.config.baseParams as pointers
-    to either properties, or methods, which can be used to configure Luca.Collection behavior
-  - Luca.onReady is now the preferred way of launching the application.
-  - Added Luca.Application.routeTo, Luca.Application.controller 
-    route building helpers
-
-0.9.78
-  - Added experimental ability to integrate router into the application itself, via the @routes property
-  - Temporary fix for double rendering bug in containers which had css class based assignments on their containers.
-  - Added experimental support for Luca.SocketManager
-  - Introducing @stateChangeEvents property for views which mixin the StateModel concern. 
-  - Added additional ComponentDefinition methods: public, private, configuration, methods
-  - Component MetaData tracks descendants()
-  - SelectField defaults to valueType integer when valueField is "id"
-
-0.9.8
-  - Luca follows Sprockets / Asset Pipeline Conventions
-  - Renamed 
-    - Luca.core.Container to Luca.Container
-    - Luca.components.Panel to Luca.Panel
-  - Added Sortable Concern
-  - Added Luca.log()
-  - Added ability to create aliases / deprecations of components with warning messages
-
-0.9.81
-  - Added support for HoganAssets via hogan.js and HoganAssets gem by Les Hill
-  - Renamed Luca.components.CollectionView to Luca.CollectionView.  Moved CollectionView to core.
-  - beforeSubmit, and beforeReset on formView can return false to stop the action
-  - Added scrollable table component to replace ugly ass GridView 
-
-0.9.83
-  - Added sortOptionsBy property to select field.  Expects an attribute to sort by.
-  - firstActivation event will be queue'd until after:render has been fired
-  - setting @rendered = true on views
-  - adding event on controller activation
-  - Bugfix on CollectionView refresh method
-
-0.9.84
-  - Added Luca::Collection::Endpoint to provide cheap throwaway persistence 
-
-0.9.85
-  - Documentation / Comments parser and generator.
-  - Luca.config.developmentMode revamp. 
-  - Added experimental Guard::Luca which uses Faye to send asset changes to the running Luca.Application()
-  - Added Luca.CodeSyncManager which keeps css, templates, and component definitions in sync as you change them on the file system.   
-  - Better refreshing of instantiated components with updated prototype code via CodeSyncManager
-  - Integrated Luca.FormView improvements from @grilix
-
-0.9.86
-  - Introducing GridLayoutView component which is a CollectionView which uses bootstraps row and spans to form an even grid.
-  - Introducing SimpleCollectionView which is a CollectionView without any mixins applied
-
-0.9.87
-  - Adds support for keymaster.js for keybinding config.  Thanks @madrobby.
-  - Adds ability for the Application, and components which belong sto Luca.components.Controller to define their own global keybindings
-  - Luca::ComponentDefinition renders comments as MarkDown
-  - Adds Luca.util.setupKeyBindings helper for views to instrument their own keybindings / scopes
-
-0.9.88
-  - Fixed a bug in StateModel concern
-  - Luca.View which define an @_inheritEvents property on their prototypes will have 
-    that event configuration persist into @events of views which extend from them
-
-0.9.9
-  - Added luca executable which includes:
-    - documentation generator
-    - sync command for running Luca.CodeSyncManager in development
-  - Removes some unused components
-  - API changes for Luca.components.Controller
-  - Removing rails dependencies
-  - Middleman site for documentation and examples 
-  - Improving documentation for core components
+0.9.42 
+  - Added TableView component, which inherits from Luca.components.CollectionView

data/Gemfile

@@ -4,17 +4,9 @@ gem "sinatra", :require => "sinatra/base"
 gem 'coffee-script', '>= 2.2.0'
 gem "uglifier", '>= 1.0.3'
 gem "sass", '>= 3.1.10'
-gem "sprockets", ">= 2.4.5"
+gem "sprockets", '>= 2.0.2'
 gem 'ejs'
 gem 'haml'
-gem 'redcarpet'
-gem 'rake'
-gem 'hogan_assets'
-gem 'haml_assets'
-gem 'activesupport', '>= 3.2.12'
-gem 'listen'
-gem 'faye'
-gem 'thin'
 
 group :test, :development do
   gem 'faker'
@@ -22,5 +14,4 @@ group :test, :development do
   gem 'rb-fsevent', '>= 0.9.1'
   gem 'pry'
   gem 'guard-jasmine'
-  gem 'jasmine'
 end

data/Gemfile.lock

@@ -1,150 +1,77 @@
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (3.2.12)
-      i18n (~> 0.6)
-      multi_json (~> 1.0)
-    addressable (2.3.2)
-    childprocess (0.3.8)
-      ffi (~> 1.0, >= 1.0.11)
-    coderay (1.0.9)
+    childprocess (0.3.1)
+      ffi (~> 1.0.6)
+    coderay (0.9.8)
     coffee-script (2.2.0)
       coffee-script-source
       execjs
-    coffee-script-source (1.4.0)
-    cookiejar (0.3.0)
-    daemons (1.1.9)
-    diff-lcs (1.1.3)
-    ejs (1.1.1)
-    em-http-request (1.0.3)
-      addressable (>= 2.2.3)
-      cookiejar
-      em-socksify
-      eventmachine (>= 1.0.0.beta.4)
-      http_parser.rb (>= 0.5.3)
-    em-socksify (0.2.1)
-      eventmachine (>= 1.0.0.beta.4)
-    eventmachine (1.0.0)
-    execjs (1.4.0)
+    coffee-script-source (1.2.0)
+    ejs (1.0.0)
+    execjs (1.2.13)
       multi_json (~> 1.0)
-    faker (1.1.2)
-      i18n (~> 0.5)
-    faye (0.8.8)
-      cookiejar (>= 0.3.0)
-      em-http-request (>= 0.3.0)
-      eventmachine (>= 0.12.0)
-      faye-websocket (>= 0.4.0)
-      rack (>= 1.0.0)
-      yajl-ruby (>= 1.0.0)
-    faye-websocket (0.4.7)
-      eventmachine (>= 0.12.0)
-    ffi (1.4.0)
-    guard (1.6.2)
-      listen (>= 0.6.0)
-      lumberjack (>= 1.0.2)
-      pry (>= 0.9.10)
-      terminal-table (>= 1.4.3)
-      thor (>= 0.14.6)
-    guard-jasmine (1.13.0)
+    faker (1.0.1)
+      i18n (~> 0.4)
+    ffi (1.0.11)
+    guard (0.9.2)
+      ffi (>= 0.5.0)
+      thor (~> 0.14.6)
+    guard-jasmine (0.9.13)
       childprocess
-      guard (>= 1.1.0)
+      guard (>= 0.8.3)
       multi_json
       thor
     guard-sprockets2 (0.0.6)
       guard
       sprockets (~> 2.0)
-    haml (4.0.0)
-      tilt
-    haml_assets (0.2.1)
-      haml
-      tilt
+    haml (3.1.4)
     hike (1.2.1)
-    hogan_assets (1.5.0)
-      execjs (>= 1.2.9)
-      sprockets (>= 2.0.3)
-      tilt (>= 1.3.3)
-    http_parser.rb (0.5.3)
-    i18n (0.6.1)
-    jasmine (1.3.1)
-      jasmine-core (~> 1.3.1)
-      rack (~> 1.0)
-      rspec (>= 1.3.1)
-      selenium-webdriver (>= 0.1.3)
-    jasmine-core (1.3.1)
-    listen (0.7.2)
-    lumberjack (1.0.2)
-    method_source (0.8.1)
-    multi_json (1.6.1)
-    pry (0.9.12)
-      coderay (~> 1.0.5)
-      method_source (~> 0.8)
-      slop (~> 3.4)
-    rack (1.5.2)
-    rack-protection (1.3.2)
+    i18n (0.6.0)
+    method_source (0.6.7)
+      ruby_parser (>= 2.3.1)
+    multi_json (1.0.4)
+    pry (0.9.7.4)
+      coderay (~> 0.9.8)
+      method_source (~> 0.6.7)
+      ruby_parser (>= 2.3.1)
+      slop (~> 2.1.0)
+    rack (1.3.5)
+    rack-protection (1.1.4)
       rack
-    rake (10.0.3)
-    rb-fsevent (0.9.3)
-    redcarpet (2.2.2)
-    rspec (2.12.0)
-      rspec-core (~> 2.12.0)
-      rspec-expectations (~> 2.12.0)
-      rspec-mocks (~> 2.12.0)
-    rspec-core (2.12.2)
-    rspec-expectations (2.12.1)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.12.2)
-    rubyzip (0.9.9)
-    sass (3.2.5)
-    selenium-webdriver (2.30.0)
-      childprocess (>= 0.2.5)
-      multi_json (~> 1.0)
-      rubyzip
-      websocket (~> 1.0.4)
-    sinatra (1.3.4)
-      rack (~> 1.4)
-      rack-protection (~> 1.3)
+    rb-fsevent (0.9.1)
+    ruby_parser (2.3.1)
+      sexp_processor (~> 3.0)
+    sass (3.1.12)
+    sexp_processor (3.0.9)
+    sinatra (1.3.1)
+      rack (~> 1.3, >= 1.3.4)
+      rack-protection (~> 1.1, >= 1.1.2)
       tilt (~> 1.3, >= 1.3.3)
-    slop (3.4.3)
-    sprockets (2.8.2)
+    slop (2.1.0)
+    sprockets (2.1.2)
       hike (~> 1.2)
-      multi_json (~> 1.0)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
-    terminal-table (1.4.5)
-    thin (1.5.0)
-      daemons (>= 1.0.9)
-      eventmachine (>= 0.12.6)
-      rack (>= 1.0.0)
-    thor (0.17.0)
+    thor (0.14.6)
     tilt (1.3.3)
-    uglifier (1.3.0)
+    uglifier (1.2.0)
       execjs (>= 0.3.0)
-      multi_json (~> 1.0, >= 1.0.2)
-    websocket (1.0.7)
-    yajl-ruby (1.1.0)
+      multi_json (>= 1.0.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport (>= 3.2.12)
   coffee-script (>= 2.2.0)
   ejs
   faker
-  faye
   guard-jasmine
   guard-sprockets2
   haml
-  haml_assets
-  hogan_assets
-  jasmine
-  listen
   pry
-  rake
   rb-fsevent (>= 0.9.1)
-  redcarpet
   sass (>= 3.1.10)
   sinatra
-  sprockets (>= 2.4.5)
-  thin
+  sprockets (>= 2.0.2)
   uglifier (>= 1.0.3)

data/Guardfile

@@ -1,5 +1,27 @@
 require './app'
-guard 'jasmine' do
-  watch(%r{src/(.+)\.coffee}) {|m| "spec/#{ m[1] }_spec.coffee" }
-  watch(%r{spec/(.+)_spec\.coffee})
+
+assets_path = Dir.pwd + '/vendor/assets'
+javascript_path = File.join( assets_path, 'javascripts' )
+stylesheets_path = File.join( assets_path, 'stylesheets' )
+
+unless ENV['TEST_MODE'] or ENV['RUN_TESTS']
+  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
+
+  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
+
+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/README.md

@@ -7,6 +7,21 @@ and clean single page applications.
 It uses twitter bootstrap compatible markup and css naming conventions, 
 making it possible to generate completely styled user interfaces with JSON alone.
 
+Luca combines the functionality of other open source libraries as well, but you are not
+required to use any of them if you don't like.
+
+### Dependencies
+
+- [Bootstrap by Twitter](https://twitter.github.com/bootstrap)
+- [Backbone-Query by David Tonge](https://github.com/davidgtonge/backbone_query)
+- [Underscore String by Esa-Matti Suuronen](https://github.com/epeli/underscore.string)
+
+### Development Tool Dependencies:
+
+- [CodeMirror IDE](https://codemirror.net)
+- [CoffeeScript Compiler](https://coffeescript.org)
+
+
 ### Using With Rails Asset Pipeline
 
 ```ruby
@@ -18,71 +33,59 @@ In your css manifest:
 
 ```css
   /*
-   *= require 'luca'
+   *= require 'luca-ui-full'
+   *= require 'luca-ui-development-tools'
   */
 ```
 
 All Javascript Dependencies:
 
 ```javascript
-  //= require 'luca/dependencies'
-  //= require 'luca'
+   //= require 'underscore'
+   //= require 'underscore-string.min'
+   //= require 'jquery'
+   //= require 'backbone'
+   //= require 'bootstrap.min.js'
+   //= require 'luca-ui.min.js'
+   //= require 'luca-ui-development-tools.min.js'
 ```
 
-Your App:
-```javascript
-  Luca.initialize('App', {
-    // will look in window.AppBootstrap for an object
-    // keyed on your collection's cache_keys() for automatically
-    // populating collections on page load
-    modelBootstrap: true,
-    // will look in window.AppBaseParams for an object
-    // or function used to determine the query parameters to
-    // be sent on every request
-    baseParams: true
-  });
-
-  JST['home'] = function() {
-    // content
-  };
-
-  App.register('App.views.Home').extends('Luca.View').defines({
-    template: "home",
-    events: {
-      "click .menu-handler" : "clickMenuHandler"
-    },
-    clickMenuHandler: function(e){
-
-    }
-  });
-
-  App.register('App.Application').extends('Luca.Application').defines({
-    // will use the Application classes internal controller
-    // to make the home 'page' active in the viewport
-    routes:{
-      "" : "home"  
-    }
-    components:[
-      name: "home"
-      type: "home"
-    ]
-  });
-
-  AppNamespace.onReady(function(){
-    (new AppNamespace.Application).boot()
-  })
+Or you can just use the dependencies we rely on.  Latest backbone.js, underscore.js, underscore.string.js, twitter boostrap js and css:
+
+```
+  //= require 'luca-ui-full.min.js'
 ```
 
-## Rails Generator
-To generate Luca application skeleton run:   
-`rails generate luca:application <app_name>`  
-This will generate a controller, view, route, and the Luca application structure under assets/javascripts/<app_name>
+## Standalone With Twitter Bootstrap ( development tools are optional )
+```html
+  <html>
+    <head>
+      <link rel="stylesheet" href='luca-ui-full.css' />
+      <link rel="stylesheet" href='luca-ui-development-tools.css' />
+    </head>
+    <body>
+      <script type='text/javascript' src="luca-ui-full.min.js" /> 
+      <script type='text/javascript' src="luca-ui-development-tools.min.js" /> 
+    </body>
+  </html>
+```
 
-## Contributing
-You will need to run 'rake release:all' to compile/minify the asset which gets released.
+## Interactive Documentation and Examples
+
+[View the Sandbox](http://datapimp.com/luca)
 
 ## Thanks To
-@jashkenas, @davidgtonge, @twitter, @madrobby, et al.
 
-## Contributors
-@tjbladez, @grilix, @nick-desteffen
+@jashkenas for making coffeescript, underscore, backbone.js.
+
+@twitter for making bootstrap 2.0
+
+@davidtonge for making backbone-query
+
+@benchprep for giving me the freedom
+
+@luca. who i spent only two minutes making and am exponentially more proud to have created.
+
+## Contributing
+
+Please!

data/ROADMAP

@@ -1,16 +1,33 @@
-Minor Initiatives:
-  - make sure hooks and mixins are inherited properly
-  - upgrade to backbone 0.9.9
-  - remove / delegate features in luca which have been provided by backbone
-  - ComponentDefinition will become a Backbone.Model
-  - ComponentDefinition registry will become a Backbone.Collection
-  - InstanceCache will become a Backbone.Collection
-  - Make CardView less noisy in the DOM
-  - Remove component defined classNames in favor of styleHierarchy
-  - make styleHierarchy less noisy
+Framework
+---------
+Extract hooks into module
 
-Major Initiatives:
-  - improve Panel toolbar
-  - improve FormView and Field configuration APIs
-  - implement rendering strategy for deferrable rendering
-  - provide ability to restore application / component state from DOM
+General
+-------
+- Make development mode options easily disabled
+- Integrate with requireJs or some other AMD system
+- Move to node.js for build / testing
+- Replace .luca template with standard jst
+- Eliminate underscore-string dependency.  just copy necessary functions.
+- Eliminate pointless CSS selectors
+
+- Rely on data attributes for functionality instead of css selectors
+- BUT in general don't tie views to the DOM anyway
+
+Luca.View
+---------
+- Add StateMachine model to all instances of Luca.View
+
+Containers
+----------
+- Luca.core.Container should relay all activation events to @components
+
+Luca.CollectionManager
+----------------------
+- Add concept of base params for a given scope of the collection manager
+
+Luca.Application
+----------------
+- Modify boot sequence so that rendering can happen on DOM ready, but all other
+  operations, such as fetching collections, etc, can happen immediately upon
+  initialization