luca 0.9.76 → 0.9.89

data/CHANGELOG

@@ -204,13 +204,76 @@
 
 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. 
+    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
+    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 @_events property on their prototypes will have 
+    that event configuration persist into @events of views which extend from them

data/Gemfile

@@ -7,7 +7,11 @@ gem "sass", '>= 3.1.10'
 gem "sprockets", '>= 2.0.2'
 gem 'ejs'
 gem 'haml'
+gem 'redcarpet'
 gem 'rake'
+gem 'hogan_assets'
+gem 'haml_assets'
+gem 'active_support'
 
 group :test, :development do
   gem 'faker'

data/Gemfile.lock

@@ -1,6 +1,9 @@
 GEM
   remote: http://rubygems.org/
   specs:
+    active_support (3.0.0)
+      activesupport (= 3.0.0)
+    activesupport (3.0.0)
     addressable (2.3.2)
     childprocess (0.3.1)
       ffi (~> 1.0.6)
@@ -28,7 +31,14 @@ GEM
       guard
       sprockets (~> 2.0)
     haml (3.1.4)
+    haml_assets (0.2.1)
+      haml
+      tilt
     hike (1.2.1)
+    hogan_assets (1.3.4)
+      execjs (>= 1.2.9)
+      sprockets (>= 2.0.3)
+      tilt (>= 1.3.3)
     i18n (0.6.0)
     jasmine (1.3.0)
       jasmine-core (>= 1.3.0)
@@ -47,11 +57,12 @@ GEM
       method_source (~> 0.6.7)
       ruby_parser (>= 2.3.1)
       slop (~> 2.1.0)
-    rack (1.3.5)
+    rack (1.5.2)
     rack-protection (1.1.4)
       rack
     rake (0.9.2.2)
     rb-fsevent (0.9.1)
+    redcarpet (2.2.2)
     rspec (2.12.0)
       rspec-core (~> 2.12.0)
       rspec-expectations (~> 2.12.0)
@@ -75,8 +86,9 @@ GEM
       rack-protection (~> 1.1, >= 1.1.2)
       tilt (~> 1.3, >= 1.3.3)
     slop (2.1.0)
-    sprockets (2.1.2)
+    sprockets (2.8.2)
       hike (~> 1.2)
+      multi_json (~> 1.0)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
     thor (0.14.6)
@@ -90,16 +102,20 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  active_support
   coffee-script (>= 2.2.0)
   ejs
   faker
   guard-jasmine
   guard-sprockets2
   haml
+  haml_assets
+  hogan_assets
   jasmine
   pry
   rake
   rb-fsevent (>= 0.9.1)
+  redcarpet
   sass (>= 3.1.10)
   sinatra
   sprockets (>= 2.0.2)

data/Guardfile

@@ -1,27 +1,5 @@
 require './app'
-
-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
+guard 'jasmine' do
+  watch(%r{src/(.+)\.coffee}) {|m| "spec/#{ m[1] }_spec.coffee" }
+  watch(%r{spec/(.+)_spec\.coffee})
 end

data/README.md

@@ -7,21 +7,6 @@ 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
@@ -33,41 +18,59 @@ In your css manifest:
 
 ```css
   /*
-   *= require 'luca-ui-full'
-   *= require 'luca-ui-development-tools'
+   *= require 'luca'
   */
 ```
 
 All Javascript Dependencies:
 
 ```javascript
-   //= 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'
-```
-
-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'
+  //= require 'luca/dependencies'
+  //= require 'luca'
 ```
 
-## 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>
+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()
+  })
 ```
 
 ## Rails Generator
@@ -75,22 +78,11 @@ 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>
 
-## Interactive Documentation and Examples
-
-[View the Sandbox](http://datapimp.com/luca)
+## Contributing
+You will need to run 'rake release:all' to compile/minify the asset which gets released.
 
 ## Thanks To
+@jashkenas, @davidgtonge, @twitter, @madrobby, et al.
 
-@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!
+## Contributors
+@tjbladez, @grilix, @nick-desteffen

data/ROADMAP

@@ -1,33 +1,16 @@
-Framework
----------
-Extract hooks into module
+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
 
-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
+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

data/Rakefile

@@ -8,98 +8,39 @@ end
 stylesheets = ["luca-ui-bootstrap.css","luca-ui-development-tools.css","sandbox.css"]  
 scripts = ["dependencies.js","sandbox.js"]
 
-namespace :source do
-  desc "Create a source map for the project"
-  task :map => :environment do
-    require 'json'
-    source_map = {}
-
-    (["src/**/*.coffee","assets/javascripts/sandbox/**/*.coffee"]).map do |location|
-      files = Dir.glob( location )
-      files.inject(source_map) do |memo,file|
-        definitions = IO.read(file).lines.to_a.grep /_\.def/
-
-        definitions.each do |definition|
-          component = definition.match(/_\.def\(['"](.+)['"]\)\./)
-
-          if component and component[1]
-            componentId = component[1].gsub(/['"].*$/,'')
-            if componentId
-              memo[ componentId ] = {className:componentId,file:file,source:IO.read(file)}
-            end
-          end
-        end
-
-        memo
-      end
-
-    end
-
-    sourceMapFile = File.join( App.root, 'site', 'source-map.js')
-
-    File.open(sourceMapFile,'w+') do |fh| 
-      fh.puts( JSON.generate( source_map.values ) )
-    end
-
-  end
-end
-
 namespace :release do
-  desc "Release new version of sandbox site"
-  task :sandbox => [:assets, :minify] do
-
-    asset_folder = File.join(App.root,'site','assets')
-    img_folder = File.join(App.root,'site','img')
-
-    [stylesheets,scripts].flatten.each do |filename|
-      asset = App.sprockets.find_asset(filename)
-      File.open( File.join( App.root, 'site', 'assets', filename) , 'w+' ) do |fh|
-        fh.puts(asset.to_s)
-      end
-    end    
-
-    FileUtils.cp( File.join(App.root,'assets','javascripts','dependencies','bootstrap.min.js'), asset_folder)
-    FileUtils.cp( File.join(App.root,'vendor/assets/javascripts/luca-ui.min.js'), asset_folder)
-    FileUtils.cp( File.join(App.root,'vendor/assets/javascripts/luca-ui-full.min.js'), asset_folder)
-    FileUtils.cp( File.join(App.root,'vendor/assets/javascripts/luca-ui-development-tools.min.js'), asset_folder)
-
-    FileUtils.cp( File.join(App.root,'vendor/assets/images/glyphicons-halflings-white.png'), img_folder )
-    FileUtils.cp( File.join(App.root,'vendor/assets/images/glyphicons-halflings.png'), img_folder )
-
-  end
-
+  desc "Compile and Minify"
+  task :all => [:assets,:minify]
   desc "Compile all the assets"
   task :assets => :environment do
-    File.open( File.join(App.root,'vendor','assets','stylesheets','luca-ui.css'), 'w+' ) do |fh|
-      fh.puts(App.sprockets["luca-ui.css"].to_s)
+    File.open( File.join(App.root,'vendor','assets','stylesheets','luca-development.css'), 'w+' ) do |fh|
+      fh.puts(App.sprockets["luca/development.css"].to_s)
     end
-
-    File.open( File.join(App.root,'vendor','assets','javascripts','luca-ui-templates.js'), 'w+' ) do |fh|
-      fh.puts(App.sprockets["luca-templates.js"].to_s)
+    File.open( File.join(App.root,'vendor','assets','stylesheets','luca-components.css'), 'w+' ) do |fh|
+      fh.puts(App.sprockets["luca.css"].to_s)
     end
-
-    File.open( File.join(App.root,'vendor','assets','javascripts','luca-ui.js'), 'w+' ) do |fh|
-      fh.puts(App.sprockets["luca-ui.js"].to_s)
+    File.open( File.join(App.root,'tmp','luca.js'), 'w+' ) do |fh|
+      fh.puts(App.sprockets["luca.js"].to_s)
     end
-
-    File.open( File.join(App.root,'vendor','assets','javascripts','luca-ui-full.js'), 'w+' ) do |fh|
-      fh.puts(App.sprockets["luca-ui-full.js"].to_s)
+    File.open( File.join(App.root,'tmp','luca-development.js'), 'w+' ) do |fh|
+      fh.puts(App.sprockets["luca/development.js"].to_s)
     end
-
-    File.open( File.join(App.root,'vendor','assets','javascripts','luca-ui-development-tools.js'), 'w+' ) do |fh|
-      fh.puts(App.sprockets["luca-ui-development-tools.coffee"].to_s)
+    File.open( File.join(App.root,'tmp','luca-dependencies.js'), 'w+' ) do |fh|
+      fh.puts(App.sprockets["luca/dependencies.js"].to_s)
     end
   end
 
   desc "Minify the assets"
   task :minify do
-    `uglifyjs vendor/assets/javascripts/luca-ui.js > vendor/assets/javascripts/luca-ui.min.js`
-    `uglifyjs vendor/assets/javascripts/luca-ui-full.js > vendor/assets/javascripts/luca-ui-full.min.js`
-    `uglifyjs vendor/assets/javascripts/luca-ui-development-tools.js > vendor/assets/javascripts/luca-ui-development-tools.min.js`
+    `uglifyjs tmp/luca.js > vendor/assets/javascripts/luca.min.js`
+    `uglifyjs tmp/luca-development.js > vendor/assets/javascripts/luca-development.min.js`
+    `uglifyjs tmp/luca-dependencies.js > vendor/assets/javascripts/luca-dependencies.min.js`
+    `cat vendor/assets/javascripts/luca-dependencies.min.js vendor/assets/javascripts/luca.min.js > vendor/assets/javascripts/luca.full.min.js`
+    `rm tmp/*.js`
   end
 
   desc "Build the gem"
-  task :gem do
+  task :gem => [:assets,:minify] do
     `gem build luca.gemspec`
   end