luca 0.9.2 → 0.9.4

data/.gitignore

@@ -6,3 +6,4 @@ vendor/assets/stylesheets/luca-ui
 node_modules
 tmp
 public/sandbox/temp.js
+*sublime-*

data/.rvmrc

@@ -1 +1 @@
-rvm use 1.9.2-p290
+rvm use 1.9.3-p194@luca --create

data/CHANGELOG

@@ -85,11 +85,55 @@
 0.9.1
   - Bugfix Release
 
-0.9.2 ( not yet released )
+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
-  - Only View Prototypes will be registered with the component registry
+  - 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 
+
+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 
+  - 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
+    on the container
+
+0.9.31
+  - lazyComponent type property now goes through a map to allow for aliasing
+  - add ability to customize container / component render method by overriding Luca.core.Container.componentRenderer
+  - rename appendContainers property to generateComponentElements
+  - adding a Luca.PageView component as an alias for CardView
+  - 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.  
+    Accepts a number 0-12.
+  - 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
+  - fixes bug in FormView.getFields() when passing in a filter.  getField by name falls back to input name check if name check fails.
+  - fixes checkbox method for checking if underlying component is checked or not
+  - adds valueType option to core field object.  allows for typecasting on getValue function
+  - change behavior on enableKeyEvents on text field
+  - added Luca.util.launchers for Development Tools usage
+  - added gridRow and gridRowFluid option to luca views to add row classes
+  - added gridOffset to add grid offset bootstrap classes
+
+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.Viewport gets enable / disable method for fluid and fullscreen mode
+  - Add configurability to fullscreen behavior on viewport

data/Gemfile

@@ -11,7 +11,7 @@ gem 'haml'
 group :test, :development do
   gem 'faker'
   gem 'guard-sprockets2'
-  gem 'rb-fsevent'
+  gem 'rb-fsevent', '>= 0.9.1'
   gem 'pry'
   gem 'guard-jasmine'
 end

data/Gemfile.lock

@@ -39,7 +39,7 @@ GEM
     rack (1.3.5)
     rack-protection (1.1.4)
       rack
-    rb-fsevent (0.4.3.1)
+    rb-fsevent (0.9.1)
     ruby_parser (2.3.1)
       sexp_processor (~> 3.0)
     sass (3.1.12)
@@ -70,7 +70,7 @@ DEPENDENCIES
   guard-sprockets2
   haml
   pry
-  rb-fsevent
+  rb-fsevent (>= 0.9.1)
   sass (>= 3.1.10)
   sinatra
   sprockets (>= 2.0.2)

data/Guardfile

@@ -4,7 +4,7 @@ assets_path = Dir.pwd + '/vendor/assets'
 javascript_path = File.join( assets_path, 'javascripts' )
 stylesheets_path = File.join( assets_path, 'stylesheets' )
 
-unless ENV['TEST_MODE']
+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/.+$})

data/README.md

@@ -1,44 +1,81 @@
-Documentation and Sandbox
--------------------------
-http://datapimp.github.com/luca
+# Component Driven Architecture with Luca.JS
 
+Luca is a component architecture framework based on Backbone.js, which includes
+many development helpers, classes, patterns, and tools needed to build scalable
+and clean single page applications.
 
-What Is Luca?
--------------
-Luca is a component / container library for Backbone.js which
-encompasses all of the best practices for laying out a large
-app with many nested views and containers.
+It uses twitter bootstrap compatible markup and css naming conventions, 
+making it possible to generate completely styled user interfaces with JSON alone.
 
-To run the sandbox:
+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.
 
-* `bundle install`
-* `rackup`
+### Dependencies
 
-visit http://localhost:9292
+- [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
 
-Using it with Rails
--------------------
 ```ruby
-# Gemfile
-gem 'luca'
+  # Gemfile
+  gem 'luca', '>= 0.9.2', :git => "git@github.com:datapimp/luca.git" 
+```
+
+In your css manifest:
+
+```css
+  /*
+   *= require 'luca-ui-full'
+   *= require 'luca-ui-development-tools'
+  */
 ```
 
-javascript manifest
+All Javascript Dependencies:
 
 ```javascript
-//= require luca-ui
+   //= 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'
 ```
 
-stylesheet manifest
+Or you can just use the dependencies we rely on.  Latest backbone.js, underscore.js, underscore.string.js, twitter boostrap js and css:
 
-```css
-/*
- *= require luca-ui
-*/
 ```
+  //= require 'luca-ui-full.min.js'
+```
+
+## 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>
+```
+
+## Interactive Documentation and Examples
+
+[View the Sandbox](http://datapimp.com/luca)
+
+## Thanks To
 
-Thanks To
----------
 @jashkenas for making coffeescript, underscore, backbone.js.
 
 @twitter for making bootstrap 2.0
@@ -49,6 +86,6 @@ Thanks To
 
 @luca. who i spent only two minutes making and am exponentially more proud to have created.
 
+## Contributing
 
-https://raw.github.com/datapimp/luca/development-tools/assets/javascripts/dependencies/underscore-string.min.js
-https://raw.github.com/datapimp/luca/development-tools/assets/javascripts/dependencies/backbond-string.min.js
+Please!

data/ROADMAP

@@ -1,9 +1,18 @@
+Framework
+---------
+Extract hooks into module
+
 General
 -------
 - Make development mode options easily disabled
 - Integrate with requireJs or some other AMD system
-- Move to node.js
+- 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
 ---------
@@ -15,4 +24,10 @@ Containers
 
 Luca.CollectionManager
 ----------------------
-- Add concept of base params for a given scope of the collection manager
+- 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

data/Rakefile

@@ -1,3 +1,4 @@
+
 task :environment do
   require './app'
   require 'pry'
@@ -7,11 +8,48 @@ 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)
@@ -22,7 +60,12 @@ namespace :release do
 
     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 all the assets"
@@ -35,6 +78,10 @@ namespace :release do
       fh.puts(App.sprockets["luca-ui.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)
+    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)
     end
@@ -43,11 +90,12 @@ namespace :release do
   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`
   end
 
   desc "Build the gem"
-  task :gem,  do
+  task :gem do
     `gem build luca.gemspec`
   end
 

data/app.rb

@@ -11,9 +11,17 @@ module AssetHelpers
   end
 end
 
-require "#{ File.expand_path('../', __FILE__) }/lib/sprockets/luca_template.rb"
+require "#{ File.expand_path('../', __FILE__) }/lib/luca/template.rb"
 require "#{ File.expand_path('../', __FILE__) }/lib/luca/code_browser.rb"
 
+module Luca
+  class Template
+    def self.namespace
+      "Luca.templates"
+    end
+  end
+end
+
 class App < Sinatra::Base
   set :root, File.expand_path('../', __FILE__)
   set :sprockets, Sprockets::Environment.new(root)
@@ -21,12 +29,15 @@ class App < Sinatra::Base
   set :assets_prefix, 'assets'
   set :assets_path, File.join(root, 'public', assets_prefix)
 
-  sprockets.register_engine '.luca', Sprockets::LucaTemplate
+  sprockets.register_engine '.luca', Luca::Template 
 
   configure do
     sprockets.append_path(File.join(root, 'assets', 'stylesheets'))
     sprockets.append_path(File.join(root, 'assets', 'javascripts'))
+    sprockets.append_path(File.join(root, 'vendor', 'assets', 'javascripts'))
+    sprockets.append_path(File.join(root, 'vendor', 'assets', 'stylesheets'))
     sprockets.append_path(File.join(root, 'assets', 'images'))
+    sprockets.append_path(File.join(root, 'vendor', 'assets', 'images'))
 
     sprockets.context_class.instance_eval do
       include AssetHelpers
@@ -47,6 +58,31 @@ class App < Sinatra::Base
 
   Luca::CodeBrowser.look_for_source_in( File.join(File.expand_path('../', __FILE__),'src') )
 
+  get "/luca/source-map.js" do
+    source_map = {}
+
+    files = (["src/**/*.coffee","assets/javascripts/sandbox/**/*.coffee"]).map do |location|
+      Dir.glob("#{ App.root }/#{ location }")
+    end
+
+    files.flatten.each do |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
+            source_map[ componentId ] = {className:componentId,file:file,source:IO.read(file)}
+          end
+        end
+      end      
+    end
+
+    JSON.generate source_map.values
+  end
+
   get "/components" do
     if params[:component]
       component = params[:component]

data/assets/javascripts/luca-ui-base.coffee

@@ -1,20 +1 @@
-#= require ./luca-ui/framework
-#= require ./luca-ui/core/util
-#= require ./luca-ui/core/core
-#= require ./luca-ui/core/registry
-#= require ./luca-ui/core/view
-#= require ./luca-ui/core/model
-#= require ./luca-ui/core/collection
-#= require ./luca-ui/core/panel
-
-#= require_tree ./luca-ui/modules
-#= require_tree ./luca-ui/templates
-
-#= require ./luca-ui/core/observer
-#= require ./luca-ui/core/field
-#= require ./luca-ui/core/container
-
-#= require_tree ./luca-ui/managers
-#= require ./luca-ui/containers/split_view
-#= require ./luca-ui/containers/column_view
-#= require_tree ./luca-ui/containers
+#= require ./luca-ui/luca

data/assets/javascripts/luca-ui-full.js

@@ -0,0 +1,3 @@
+//= require ./dependencies
+//= require ./luca-ui-bootstrap
+//= require ./luca-ui

data/assets/javascripts/luca-ui.coffee

@@ -1,8 +1,3 @@
 #= require ./luca-ui-base
 #= require ./luca-ui/components/template
 #= require_tree ./luca-ui/components
-
-_.extend Luca, Luca.Events
-_.extend Luca.View::, Luca.Events
-_.extend Luca.Collection::, Luca.Events
-_.extend Luca.Model::, Luca.Events

data/assets/javascripts/sandbox/application.coffee

@@ -1,35 +1,46 @@
-Sandbox.Application = Luca.Application.extend
-  name: 'sandbox_application'
+_.def('Sandbox.Application').extends('Luca.Application').with
+
+  autoBoot: true
+
+  name: 'SandboxApp'
+
+  router: "Sandbox.Router"
+
   el: '#viewport'
+
   fluid: true
 
   topNav:'top_navigation'
 
-  useKeyRouter: true
+  useKeyHandler: false
 
   keyEvents:
     meta:
       forwardslash: "developmentConsole"
 
+  collectionManager:
+    initialCollections: ["components"]
+
   components:[
     ctype: 'controller'
     name: 'pages'
     components:[
       name: "main"
+      className:"marketing-content"
       bodyTemplate: 'main'
     ,
-      name :"class_browser"
-      ctype: "class_browser"
+      name: "intro"
+      className:"marketing-content"
+      bodyTemplate: "readme"
+    ,
+      name: "build"
+      ctype: "builder"
     ,
-      name: "component_tester"
-      ctype: "component_tester"
+      name: "docs"
+      ctype: "docs_controller"
     ]
   ]
 
-  initialize: (@options={})->
-    Luca.Application::initialize.apply @, arguments
-    @router = new Sandbox.Router(app: @)
-
   developmentConsole: ()->
     @developmentConsole = Luca "coffeescript-console", ()->
       new Luca.tools.DevelopmentConsole(name:"coffeescript-console")
@@ -42,10 +53,5 @@ Sandbox.Application = Luca.Application.extend
 
     $('#devtools-console-wrapper').modal(backdrop:false,show:true)
 
-  afterRender: ()->
-    @_super("afterRender", @, arguments)
-
-$ do ->
-  (window || global).SandboxApp = new Sandbox.Application()
-  SandboxApp.boot()
-  prettyPrint()
+$ -> 
+  new Sandbox.Application()

data/assets/javascripts/sandbox/router.coffee

@@ -1,14 +1,24 @@
 Sandbox.Router = Luca.Router.extend
   routes:
     ""                : "default"
-    "class_browser"   : "class_browser"
-    "component_tester"   : "component_tester"
+    "build"           : "build"
+    "intro"           : "intro"
+    "application"     : "inspector"
+    "docs"            : "docs"
+    "docs/:section"   : "docs"
 
   default: ()->
     @app.navigate_to("pages").navigate_to "main"
 
-  class_browser: ()->
-    @app.navigate_to("pages").navigate_to "class_browser"
+  build: ()->
+    @app.navigate_to("pages").navigate_to "build"
 
-  component_tester: ()->
-    @app.navigate_to("pages").navigate_to "component_tester"
+  docs: (section="docs_index")->
+    @app.navigate_to("docs").navigate_to(section)
+
+  intro: ()->
+    @app.navigate_to("pages").navigate_to "intro"
+
+  inspector: ()->
+    inspector = Luca "application_inspector", new Sandbox.views.ApplicationInspector() 
+    inspector.toggle()

data/assets/javascripts/sandbox/templates/builder/component_list.luca

@@ -0,0 +1 @@
+.component

data/assets/javascripts/sandbox/templates/builder.luca

@@ -0,0 +1,2 @@
+%h1 Luca.JS Component Builder
+%p This is coming soon.  The Luca.JS sandbox application will provide interactive examples of various components and explain the architectural pieces that go into a well designed single page application.

data/assets/javascripts/sandbox/templates/main.luca

@@ -39,12 +39,13 @@
     .row
       .span4
         %h3 Development Tools
-        %p If you enable the Luca development tools, you have access to things like an in browser Coffeescript console, a CodeMirror based IDE to edit and test your components which live reloads javascript prototype changes and re-renders your components, so that you can experiment directly in the browser. 
+        %p Luca's development tools include an in-browser Coffeescript console, a CodeMirror based IDE which performs live updates in the browser. 
         %p Live reloading of your code changes is also supported if you use the ruby gem and make changes in your favorite editor.
       .span4
         %h3 Experimentation and Debugging
-        %p The way the Luca framework was designed encourages us to define our apps mostly using JSON configuration, which then gets interpreted, and structural components and style rules are generated for us.  Events get binded, and things just work.  
-        %p Because large parts of the application's code are just configuration strings, it is very easy to provide you with a suite of development tools that allow you to inspect what is going on behind the scenes and make changes directly in the environment if you want to experiment with some ideas.
+        %p The Luca framework was designed encourage developers to define apps mostly using JSON configuration, The structural components and style rules are generated for us,  events get bound, and things just work.
+        %p 
+          %a{href:"#application"} Take a look at this application in the inspector.
 
       .span4
         %h3 Not only for Ruby Developers

data/assets/javascripts/sandbox/templates/sandbox/docs_index.luca

@@ -0,0 +1 @@
+%h1 Documentation

data/assets/javascripts/sandbox/templates/sandbox/navigation.luca

@@ -1,3 +1,8 @@
 %ul.nav
   %li
-    %a{:href=>"#"} Intro
+    %a{:href=>"#intro"} Intro
+  %li
+    %a{:href=>"#build"} Component Builder
+  %li
+    %a{:href=>"#docs"} Documentation
+    

data/assets/javascripts/sandbox/templates/sandbox/readme.luca

@@ -0,0 +1,30 @@
+.container
+  %h1 Component Driven Architecture with Luca.JS
+
+  %p Luca is a component architecture framework based on Backbone.js, which includes
+  many development helpers, classes, patterns, and tools needed to build scalable
+  and clean single page applications.
+
+  %p It uses twitter bootstrap compatible markup and css naming conventions, 
+  making it possible to generate completely styled user interfaces with JSON alone.
+
+  %p 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.
+
+  %h3 Dependencies
+
+  %ul
+    %li
+      %a{href:"https://twitter.github.com/bootstrap"} Bootstrap by Twitter
+    %li 
+      %a{href:"https://github.com/davidgtonge/backbone_query"} Backbone-Query by David Tonge
+    %li
+      %a{href:"https://github.com/epeli/underscore.string"} Underscore String by Esa-Matti Suuronen
+
+  %h3 Development Tool Dependencies
+
+  %ul
+    %li
+      %a{href:"https://codemirror.net"} CodeMirror IDE
+    %li
+      %a{href:"https://coffeescript.org"}CoffeeScript Compiler

data/assets/javascripts/sandbox/views/builder/builder_canvas.coffee

@@ -0,0 +1,3 @@
+_.def("Sandbox.views.BuilderCanvas").extends("Luca.View").with
+  name: "builder_canvas"
+  bodyTemplate: "builder"

data/assets/javascripts/sandbox/views/builder/builder_editor.coffee

@@ -0,0 +1,6 @@
+_.def("Sandbox.views.BuilderEditor").extends("Luca.tools.CoffeeEditor").with
+  name: "builder_editor"
+
+
+  toggleSource:()->
+    @_super("toggleMode", @, arguments)