luca 0.9.8 → 0.9.9

data/app/assets/javascripts/luca/development/component.coffee

@@ -0,0 +1,76 @@
+model = Luca.register  "Luca.models.Component"
+model.extends           "Luca.Model"
+
+model.configuration
+  defaults:
+    class_name: undefined
+    superClass: undefined
+    asset_id: undefined
+    source_file_contents: ""
+    defined_in_file: ""
+
+model.defines
+  idAttribute: "class_name"
+  
+  documentation: ()->
+    base = _( @toJSON() ).pick 'header_documentation', 'class_name', 'defined_in_file'
+
+    _.extend base, @metaData(), 
+      componentGroup: @componentGroup() 
+      componentType: @componentType() 
+      componentTypeAlias: @componentTypeAlias()
+      details:
+        publicMethods:        @documentationFor("publicMethods")
+        privateMethods:       @documentationFor("privateMethods")
+        privateProperties:    @documentationFor("privateProperties")
+        publicProperties:     @documentationFor("publicProperties")
+
+  documentationFor: (methodOrPropertyGroup="publicMethods")->
+    documentationSource = _.extend({}, @get("defines_methods"), @get("defines_properties"))
+
+    result = {}
+
+    if list = @metaData()?[ methodOrPropertyGroup ]?()
+      _(list).reduce (memo, methodOrProperty)->
+        memo[ methodOrProperty ] = documentationSource[ methodOrProperty ]
+        memo
+      , result  
+
+    result
+
+  url: ()->
+    "/project/components/#{ Luca.namespace }/#{ @classNameId() }"
+
+  metaData: ()->
+    Luca( @get("class_name") ).prototype.componentMetaData()
+
+  classNameId: ()->
+    @get("class_name").replace(/\./g,'__')
+
+  componentGroup: ()->
+    parts = @get('class_name').split('.')
+    parts.slice(0,2).join('.')
+
+  componentType: ()->
+    type  = "view"
+    parts = @get('class_name').split('.')
+
+    switch group = parts[1]
+      when "collections" then "collection"
+      when "models" then "model"
+      when ("views" || "components" || "pages") then "view"
+
+    return if group?
+
+    if componentPrototype = Luca.util.resolve( @get("class_name") )
+      return "view" if Luca.isViewPrototype( componentPrototype:: )
+      return "collection" if Luca.isCollectionPrototype( componentPrototype:: )
+      return "model" if Luca.isModelProtoype( componentPrototype:: )
+
+    # meh, but what about Router?
+    "view"
+
+  componentTypeAlias: ()->
+    parts = @get('class_name').split('.')
+    name = parts.pop()
+    _.str.underscored( name )

data/app/assets/javascripts/luca/development/components.coffee

@@ -0,0 +1,57 @@
+components = Luca.register   "Luca.collections.Components"
+components.extends            "Luca.Collection"
+
+components.configuration
+  model: Luca.models.Component
+  namespace: "components"
+
+components.classMethods
+  generate: ()->
+    @collection = new Luca.collections.Components()
+    @collection.fetch()
+    @collection
+
+components.defines
+  findByClassName: (class_name)->
+    @detect (model)->
+      model.get("class_name") is class_name
+        
+  filterByNamespace: (namespace)->
+    @query
+      class_name: $like: namespace
+
+  classNames: ()->
+    @pluck('class_name')
+
+  groupsInsideOf: (namespace)->
+    classes = @filterByNamespace(namespace)
+    unique = {}
+    
+    for component in classes when not unique[ component.componentGroup() ]?
+      if component.get("class_name")?.split('.')?.length > 2
+        unique[ component.componentGroup() ] = component.componentGroup().split('.')[1] 
+
+    _.values(unique)
+
+  namespaces: ()->
+    list = _( @classNames() ).map (className)->
+      className.split('.')[0]
+
+    _( list ).uniq()
+
+  fetch: (options={})->
+    @populateFromRegistry(options)
+
+  comparator: (model)->
+    model.get("class_name")
+      
+  populateFromRegistry: (options={})->
+    registeredClassNames = for class_name in Luca.registry.classes(true)
+      {class_name, name: class_name}
+
+    if options.namespace
+      registeredClassNames = for model in registeredClassNames when model.name.match(options.namespace)
+        model
+
+      
+    @reset(registeredClassNames, options={})

data/app/assets/javascripts/luca/development/console.coffee

@@ -186,7 +186,7 @@ Luca.util.inspectComponent = (component)->
 
 Luca.util.launchers.developmentConsole = (name="luca-development-console")->
   @_lucaDevConsole = Luca name, ()=>
-    @$el.append Backbone.View::make("div", id: "#{ name }-wrapper", class: "modal fade large")
+    @$el.append Luca.View::make("div", id: "#{ name }-wrapper", class: "modal fade large")
 
     dconsole = new Luca.tools.DevelopmentConsole
       name: name

data/app/assets/javascripts/luca/development/index.coffee

@@ -1,2 +1,5 @@
 #= require ./code_mirror_field
-#= require ./console
+#= require ./console
+#= require ./code_sync_manager
+#= require ./component
+#= require ./components

data/app/assets/javascripts/luca/framework.coffee

@@ -22,7 +22,7 @@ lucaUtilityHelper = (payload, args...)->
 
 (window || global).Luca = ()-> lucaUtilityHelper.apply(@, arguments)
 
-Luca.VERSION = '0.9.8'
+Luca.VERSION = '0.9.9'
 
 _.extend Luca,
   core: {}
@@ -63,7 +63,10 @@ Luca.setupCollectionSpace = (options={})->
 # Creates a basic Namespace for you to begin defining
 # your application and all of its components.
 Luca.initialize = (namespace, options={})->
-  defaults = 
+  Luca.namespace = namespace.toLowerCase()
+  existing       = Luca.util.resolve(namespace, window || global) || {}
+
+  _.defaults existing,
     views: {}
     collections: {}
     models: {}
@@ -83,11 +86,12 @@ Luca.initialize = (namespace, options={})->
 
 
   object = {}
-  object[ namespace ] = _.extend(Luca.getHelper(), defaults)
+  object[ namespace ] = _.defaults(Luca.getHelper(), existing)
 
   _.extend(Luca.config, options)
   _.extend (window || global), object
 
+  Luca.lastNamespace = namespace
   Luca.concern.namespace "#{ namespace }.concerns"
   Luca.registry.namespace "#{ namespace }.views"
   Luca.Collection.namespace "#{ namespace }.collections"

data/app/assets/javascripts/luca/index.coffee

@@ -1,8 +1,9 @@
+#= require_self
 #= require_tree ./templates
 #= require ./framework
 #= require ./config
 #= require ./util
-#= require ./managers
 #= require ./core
+#= require ./managers
 #= require ./containers
 #= require ./components

data/app/assets/javascripts/luca/managers/collection_manager.coffee

@@ -88,7 +88,6 @@ class Luca.CollectionManager
 
   collectionCountDidChange: ()->
     if @allCollectionsLoaded() 
-      # for backwards compat
       @trigger "all_collections_loaded" 
       @trigger "initial:load"
 
@@ -157,12 +156,12 @@ loadInitialCollections = ()->
 
 handleInitialCollections = ()->
   @state.set({loaded_collections_count: 0, collections_count: @initialCollections.length })
-  @state.bind "change:loaded_collections_count", ()=> @collectionCountDidChange()
+  @state.bind "change:loaded_collections_count", ()=> 
+    @collectionCountDidChange()
 
   if @useProgressLoader
     @loaderView ||= new Luca.components.CollectionLoaderView(manager: @,name:"collection_loader_view")
 
   loadInitialCollections.call(@)
 
-  @initialCollectionsLoadedu
   @

data/app/assets/javascripts/luca/managers/index.coffee

@@ -1,2 +1,2 @@
 #= require ./collection_manager
-#= require ./socket_manager
+#= require ./socket_manager

data/app/assets/javascripts/luca/managers/socket_manager.coffee

@@ -1,7 +1,20 @@
 # The SocketManager provides communication between a Websocket / Pubsub
 # system and routes messages through the application to instances
-# of the 
-class Luca.SocketManager extends Backbone.Model
+# of a specific view, model, collection, or other Backbone.Events object. 
+#
+# You will need to create the socket manager specifying your provider and host:
+#       @socket = new Luca.SocketManager(host:"//localhost:9292/faye")
+#
+socketManager = Luca.register "Luca.SocketManager"
+socketManager.extends         "Luca.Model"
+
+socketManager.defines
+  # The SocketManager can be configured with the following options:
+  #
+  # autoStart: default(true) immediately begins to load the provider
+  # script, setup the connection, etc
+  #
+  # provider: faye.js or socket.io
   defaults:
     autoStart: true  
     providerAvailable: false
@@ -9,26 +22,35 @@ class Luca.SocketManager extends Backbone.Model
     provider: "faye.js"
 
   initialize: (@attributes={})->
-    @loadProviderSource() unless @providerAvailable() is true
+    unless @providerLibraryIsAvailable()
+      @loadProviderSource() 
 
     Luca.Model::initialize?.apply(@, arguments)
 
     model = @
 
-    connectOnReady = ()=> @connect() if @isReady()
+    connectOnReady = ()=> 
+      @connect() if @isReady()
 
-    model.on "change", ()->
+    model.on "change:ready", ()->
       connectOnReady()
-      model.unbind("change", @)
+      model.unbind("change:ready", @)
+
+    model.on "change:providerAvailable", ()->
+      connectOnReady()
+      model.unbind("change:ready", @)
 
     @on "ready", _.once ()=> @set('ready', true)
 
     @trigger "change"
 
+  # The socket manager is ready once 'ready' event has been
+  # triggered on it.  ( usually by the application ). and once
+  # the provider client library as been loaded.
   isReady: ()->
     @get("ready") is true and @get("providerAvailable") is true
 
-  providerAvailable: ()->
+  providerLibraryIsAvailable: ()->
     providerTest = switch @get('provider')
       when "socket.io"
         "io"
@@ -42,7 +64,8 @@ class Luca.SocketManager extends Backbone.Model
       when "socket.io"
         @client = io.connect( @get('host') )
       when "faye.js"
-        @client = new Faye.Client( @get('host')  + ( @get('namespace')  || "") )
+        @client = new Faye.Client(@get('host'))
+        @set("client", @client)
 
   providerSourceLoaded: ()-> 
     @set "providerAvailable", true

data/app/assets/javascripts/luca/templates/components/nav_bar.jst.ejs

@@ -1,4 +1,19 @@
 <div class="navbar-inner">
-  <div class="luca-ui-navbar-body container">
+  <div class="luca-ui-navbar-body">
+    <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
+      <span class="icon-bar"></span>
+      <span class="icon-bar"></span>
+      <span class="icon-bar"></span>
+    </button>
+
+    <a class="brand" href="#">Set @brand</a>
+    
+    <div class="nav-collapse collapse">
+      <ul class="nav">
+        <li class="active">
+          <a href="#">Home</a>
+        </li>
+      </ul>
+    </div>
   </div>
 </div>

data/app/assets/javascripts/luca/templates/containers/tab_view.jst.ejs

@@ -1,2 +1,2 @@
-<ul id="<%= cid %>-tabs-selector" class="nav <%= navClass %>"></ul>
+<ul id="<%= cid %>-tabs-selector" class="nav nav-tabs"></ul>
 <div id="<%= cid %>-tab-view-content" class="tab-content"></div>

data/app/assets/javascripts/luca/util/index.coffee

@@ -1,3 +1,4 @@
 #= require ./luca
 #= require ./logging
 #= require ./deprecations
+#= require ./keybindings

data/app/assets/javascripts/luca/util/keybindings.coffee

@@ -0,0 +1,24 @@
+# Luca.util.setupKeymaster(config, keyScope).on(view)
+#
+# Keymaster understands the following modifiers:
+# `⇧`, `shift`, `option`, `⌥`, `alt`, `ctrl`, `control`, `command`, and `⌘`.
+
+# The following special keys can be used for shortcuts:
+# `backspace`, `tab`, `clear`, `enter`, `return`, `esc`, `escape`, `space`,
+# `up`, `down`, `left`, `right`, `home`, `end`, `pageup`, `pagedown`, `del`, `delete`
+# and `f1` through `f19`.
+Luca.util.setupKeymaster = Luca.util.setupKeyBindings = (config, keyScope="all")->
+  unless _.isFunction(Luca.key)
+    throw "Keymaster library has not been included."
+
+  on: (view)->
+    view.on "before:remove", ()->
+      Luca.key?.deleteScope(keyScope)
+
+    for key, handler of config
+      if _.isString(handler) and _.isFunction(view[handler])
+        handler = view[handler]
+
+      if _.isFunction(handler)
+        handler = _.bind(handler, view)
+        Luca.key(key, keyScope, handler)    

data/app/assets/javascripts/luca/util/logging.coffee

@@ -1,3 +1,18 @@
+Luca.stats = {}
+
+Luca.stats.reset = ()-> Luca.__stats = {}
+
+Luca.stats.increment = (counter)->
+  Luca.__stats ||= {}
+  Luca.__stats[counter] ||= 1
+  Luca.__stats[counter] = Luca.__stats[counter] + 1
+  Luca.__stats[counter]  
+
+Luca.stats.report = ()->
+  console.log "Stats..."
+  for key, value of Luca.__stats
+    console.log key, value
+
 Luca.warn = (args...)->
   return unless Luca.config.showWarnings is true
 

data/app/assets/javascripts/luca/util/luca.coffee

@@ -112,7 +112,8 @@ Luca.util.loadScript = (url, callback) ->
   script.src = url
   document.body.appendChild(script)
 
-Luca.util.make = Backbone.View::make
+Luca.util.make = (tagName="div", attributes={}, contents="")->
+  Luca.View::make.apply(@, arguments)
 
 Luca.util.list = (list,options={},ordered)->
   container = if ordered then "ol" else "ul"
@@ -144,6 +145,10 @@ Luca.util.setupHooks = (set)->
     fn = Luca.util.hook( eventId )
 
     callback = ()->
+      #if @[fn]?
+      #  Luca.stats.increment("empty:hook")
+      #else
+      #  Luca.stats.increment("valid:hook")
       @[fn]?.apply @, arguments
 
     callback = _.once(callback) if eventId?.match(/once:/)
@@ -181,3 +186,6 @@ Luca.util.rejectBlanks = (object)->
     processed[key] = value 
 
   processed
+
+Luca.util.enableDropdowns = (selector=".dropdown-toggle")->
+  $(selector).dropdown?()

data/app/assets/stylesheets/luca/components/table_view.scss

@@ -0,0 +1,85 @@
+  /* define height and width of scrollable area. Add 16px to width for scrollbar          */
+  ._scrollable-wrapper {
+    clear: both;
+    overflow: auto;
+  }
+
+  /* Reset overflow value to hidden for all non-IE browsers. */
+  ._scrollable-wrapper {
+    overflow: hidden;
+  }
+
+  /* define width of table. IE browsers only                 */
+  .scrollable-wrapper table {
+  }
+
+  /* define width of table. Add 16px to width for scrollbar.           */
+  /* All other non-IE browsers.                                        */
+  .scrollable-wrapper table {
+  }
+
+.luca-scrollable-table-view {
+
+  /* set table header to a fixed position. WinIE 6.x only                                       */
+  /* In WinIE 6.x, any element with a position property set to relative and is a child of       */
+  /* an element that has an overflow property set, the relative value translates into fixed.    */
+  /* Ex: parent element DIV with a class of tableContainer has an overflow property set to auto */
+  thead.fixed tr {
+    position: relative
+  }
+
+  /* set THEAD element to have block level attributes. All other non-IE browsers            */
+  /* this enables overflow to work on TBODY element. All other non-IE, non-Mozilla browsers */
+  thead.fixed tr {
+    display: block
+  }
+
+  /* make the TH elements pretty */
+  thead.fixed th {
+    font-weight: bold;
+    text-align: left
+  }
+
+  /* make the A elements pretty. makes for nice clickable headers                */
+  thead.fixed a, thead.fixed a:link, thead.fixed a:visited {
+    color: #FFF;
+    display: block;
+    text-decoration: none;
+    width: 100%
+  }
+
+  /* make the A elements pretty. makes for nice clickable headers                */
+  /* WARNING: swapping the background on hover may cause problems in WinIE 6.x   */
+  thead.fixed a:hover {
+    color: #FFF;
+    display: block;
+    text-decoration: underline;
+    width: 100%
+  }
+
+  /* define the table content to be scrollable                                              */
+  /* set TBODY element to have block level attributes. All other non-IE browsers            */
+  /* this enables overflow to work on TBODY element. All other non-IE, non-Mozilla browsers */
+  /* induced side effect is that child TDs no longer accept width: auto                     */
+  tbody.scrollable {
+    display: block;
+    overflow: auto;
+    width: 100%
+  }
+
+  /* define width of TH elements: 1st, 2nd, and 3rd respectively.          */
+  /* Add 16px to last TH for scrollbar padding. All other non-IE browsers. */
+  /* http://www.w3.org/TR/REC-CSS2/selector.html#adjacent-selectors        */
+  thead.fixed th {
+    padding: 5px;
+  }
+
+  /* define width of TD elements: 1st, 2nd, and 3rd respectively.          */
+  /* All other non-IE browsers.                                            */
+  /* http://www.w3.org/TR/REC-CSS2/selector.html#adjacent-selectors        */
+  tbody.scrollable td {
+    padding: 5px;
+  }
+
+}
+