joosy 1.2.0.alpha.41 → 1.2.0.alpha.51

data/source/joosy/modules/page/title.coffee

@@ -0,0 +1,18 @@
+Joosy.Modules.Page_Title =
+
+  #
+  # Sets the page HTML title.
+  #
+  # @note Title will be reverted on unload.
+  #
+  # @param [String] title       Title to set.
+  #
+  title: (title, separator=' / ') ->
+    @afterLoad ->
+      titleStr = if Object.isFunction(title) then title.apply(@) else title
+      titleStr = titleStr.join(separator) if Object.isArray(titleStr)
+      @__previousTitle = document.title
+      document.title = titleStr
+
+    @afterUnload ->
+      document.title = @__previousTitle

data/{src/joosy/core → source/joosy}/modules/renderer.coffee

@@ -1,6 +1,5 @@
-#= require joosy/core/joosy
-#= require_tree ../templaters
-#= require vendor/metamorph
+#= require metamorph
+#= require joosy/joosy
 
 #
 # Core DOM rendering mechanics
@@ -8,13 +7,6 @@
 # @mixin
 #
 Joosy.Modules.Renderer =
-
-  #
-  # Default behavior for non-set view (empty template?)
-  #
-  __renderDefault: ->
-    throw new Error "#{Joosy.Module.__className @constructor} does not have an attached template"
-
   #
   # Defines class-level helpers: @view and @helpers
   #
@@ -84,9 +76,12 @@ Joosy.Modules.Renderer =
     unless @__helpersInstance
       @__assignHelpers()
 
-      @__helpersInstance = Object.extended Joosy.Helpers.Application
+      @__helpersInstance = {}
       @__helpersInstance.__renderer = @
 
+      Joosy.Module.merge @__helpersInstance, Joosy.Helpers.Application
+      Joosy.Module.merge @__helpersInstance, Joosy.Helpers.Routes if Joosy.Helpers.Routes?
+
       if @__helpers
         for helper in @__helpers
           Joosy.Module.merge @__helpersInstance, helper
@@ -117,8 +112,8 @@ Joosy.Modules.Renderer =
 
     if Object.isString template
       if @__renderSection?
-        template = Joosy.Application.templater.resolveTemplate @__renderSection(), template, this
-      template = Joosy.Application.templater.buildView template
+        template = Joosy.templater().resolveTemplate @__renderSection(), template, this
+      template = Joosy.templater().buildView template
     else if !Object.isFunction template
       throw new Error "#{Joosy.Module.__className @}> template (maybe @view) does not look like a string or lambda"
 
@@ -209,3 +204,7 @@ Joosy.Modules.Renderer =
         remove stackPointer
     else
       remove stackPointer
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/modules/renderer', -> Joosy.Modules.Renderer

data/{src/joosy/core → source/joosy}/modules/time_manager.coffee

@@ -1,4 +1,4 @@
-#= require joosy/core/joosy
+#= require joosy/joosy
 
 #
 # Comfortable and clever wrappers for timeouts management
@@ -46,3 +46,7 @@ Joosy.Modules.TimeManager =
     if @__timeouts
       for entry in @__timeouts
         window.clearTimeout entry
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/modules/time_manager', -> Joosy.Modules.TimeManager

data/{src/joosy/core → source/joosy}/modules/widgets_manager.coffee

@@ -1,4 +1,4 @@
-#= require joosy/core/joosy
+#= require joosy/joosy
 
 #
 # Widgets management routines
@@ -51,10 +51,10 @@ Joosy.Modules.WidgetsManager =
 
     Object.each @__widgets, (selector, widget) =>
       if selector == '$container'
-        activeSelector = @container
+        activeSelector = @$container
       else
         selector = @__extractSelector(selector) if @__extractSelector?
-        activeSelector = $(selector, @container)
+        activeSelector = $(selector, @$container)
 
       registered[selector] = Object.extended()
 
@@ -64,7 +64,7 @@ Joosy.Modules.WidgetsManager =
         else
           instance = widget.call this, index
 
-        if Joosy.Application.config.debug
+        if Joosy.debug()
           registered[selector][Joosy.Module.__className instance] ||= 0
           registered[selector][Joosy.Module.__className instance]  += 1
 
@@ -72,7 +72,7 @@ Joosy.Modules.WidgetsManager =
 
     @__widgets = {}
 
-    if Joosy.Application.config.debug
+    if Joosy.debug()
       registered.each (selector, value) =>
         value.each (widget, count) =>
           Joosy.Modules.Log.debugAs @, "Widget #{widget} registered at '#{selector}'. Elements: #{count}"
@@ -84,3 +84,7 @@ Joosy.Modules.WidgetsManager =
     if @__activeWidgets
       for widget in @__activeWidgets
         widget.__unload()
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/modules/widgets_manager', -> Joosy.Modules.WidgetsManager

data/source/joosy/page.coffee

@@ -0,0 +1,68 @@
+#= require joosy/joosy
+#= require joosy/widget
+#= require joosy/layout
+#= require joosy/modules/page/scrolling
+#= require joosy/modules/page/title
+
+#
+# Base class for Joosy Pages.
+#
+# @example Sample application page
+#   class @RumbaPage extends Joosy.Page
+#     @view 'rumba'
+#
+# @include Joosy.Modules.Page_Scrolling
+# @extend  Joosy.Modules.Page_Title
+#
+class Joosy.Page extends Joosy.Widget
+  #
+  # Sets layout for current page
+  #
+  # @param [Class] layoutClass      Layout to use
+  #
+  @layout: (layoutClass) ->
+    @::__layoutClass = layoutClass
+
+  @include Joosy.Modules.Page_Scrolling
+  @extend  Joosy.Modules.Page_Title
+
+  #
+  # @params [Hash] params             Route params
+  # @params [Joosy.Page] previous     Previous page to unload
+  #
+  constructor: (@params, @previous) ->
+    @layoutShouldChange = @previous?.__layoutClass != @__layoutClass
+
+    @halted = !@__runBeforeLoads()
+    @layout = switch
+      when @layoutShouldChange && @__layoutClass
+        new @__layoutClass(params, @previous?.layout)
+      when !@layoutShouldChange
+        @previous?.layout
+
+    # If the page has no layout defined while the previous had one
+    # we should declare ourselves as a relpacement to the layout, not the page
+    @previous = @previous.layout if @layoutShouldChange && !@layout
+
+  ######
+  ###### Widget extensions
+  ######
+
+  #
+  # This is required by {Joosy.Modules.Renderer}
+  # Sets the base template dir to app_name/templates/pages
+  #
+  __renderSection: ->
+    'pages'
+
+  #
+  # Unlike widget that injects straightforwardly into given container
+  # page injects itself into the content of Layout and uses given container
+  # as a fallback for cases when no Layout has been set
+  #
+  __bootstrapDefault: (applicationContainer) ->
+    @__bootstrap @__nestingMap(), @layout?.content() || applicationContainer
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/page', -> Joosy.Page

data/{src/joosy/core → source/joosy}/resources/watcher.coffee

@@ -48,4 +48,8 @@ class Joosy.Resources.Watcher extends Joosy.Module
     if @__beforeLoads?
       data = bl.call(this, data) for bl in @__beforeLoads
 
-    data
+    data
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/resources/watcher', -> Joosy.Resources.Watcher

data/source/joosy/router.coffee

@@ -0,0 +1,305 @@
+#= require joosy/joosy
+#= require joosy/modules/events
+#= require joosy/page
+#= require joosy/helpers/routes
+
+#
+# Router. Reacts on URI change event and loads proper pages
+#
+# Internal storage rules:
+#   * HTML5 Prefix option is stored with both leading and trailing slashes
+#   * Helpers pathes are stored without leading trailing slash
+#   * Route matchers declare leading and trailing slashes as optional
+#
+# Example:
+#   Joosy.Router.map
+#     404             : (path) -> alert "Page '#{path}' was not found :("
+#     '/'             : Welcome.IndexPage
+#     '/resources'    :
+#     '/'             : Resource.IndexPage
+#     '/:id'          : Resource.ShowPage
+#     '/:id/edit'     : Resource.EditPage
+#     '/new'          : Resource.EditPage
+#
+# @mixin
+#
+class Joosy.Router extends Joosy.Module
+  @extend Joosy.Modules.Events
+
+  # We need to be constantly subscribed to popstate event to filter
+  # the first event that always happens on the initial load
+  $(window).bind 'popstate', (event) =>
+    if window.history.loaded?
+      @trigger 'popstate', event
+    else
+      window.history.loaded = true
+
+  $(document).on 'click', 'a[data-joosy]', (event) =>
+    @navigate event.target.getAttribute('href')
+    false
+
+  #
+  # Rails-like wrapper around internal raw routes representation
+  #
+  class Drawer
+    @run: (block, namespace='', alias='') ->
+      context = new Drawer namespace, alias
+      block.call(context)
+
+    constructor: (@__namespace, @__alias) ->
+
+    #
+    # Match route (ads it to @rawRoutes)
+    #
+    # @param [String] route       similar to ones sent in map hash
+    #
+    # @param  options [String] to  function to which the route routes
+    # @option options [String] as  name of the route, used for reverse routing
+    #
+    match: (route, options={}) ->
+      if options.as?
+        if @__alias
+          as = @__alias + options.as.charAt(0).toUpperCase() + options.as.slice(1)
+        else
+          as = options.as
+
+      route = @__namespace + route
+
+      Joosy.Router.compileRoute route, options.to, as
+
+    #
+    # Shortcut to match "/"
+    #
+    # @param  options [String] to  function to which the route routes
+    # @option options [String] as  name of the route, used for reverse routing
+    #                              default it is "root"
+    #
+    root: (options={}) ->
+      @match "/", to: options.to, as: options.as || 'root'
+
+    #
+    # Routes the 404
+    #
+    # @param options [String] to  function to which the route routes
+    #
+    notFound: (options={}) ->
+      @match 404, to: options.to
+
+    #
+    # Namespaces a match route
+    #
+    # @param [String] name     name of the namespace, prefixes other commands
+    #
+    # @option [Hash] options   "as", prefixes all other "as" commands
+    # @param [Function] block  callback for child commands
+    namespace: (name, options={}, block) ->
+      if Object.isFunction(options)
+        block = options
+        options = {}
+
+      Drawer.run block, @__namespace+name, options.as?.toString()
+
+  #
+  # Registers a set of raw routes
+  # The method saves hash of routes for further activation
+  #
+  # @param [Object] routes        Set of routes in inner format (see class description)
+  #
+  @map: (routes, namespace) ->
+    Object.each routes, (path, to) =>
+      path = namespace + '/' + path if namespace?
+      if Object.isFunction(to) || to.prototype
+        @compileRoute path, to
+      else
+        @map to, path
+
+  #
+  # Draws the routes similar to Ruby on Rails
+  #
+  # @param [Function] block   callback for child commands
+  #
+  @draw: (block)->
+    Drawer.run block
+
+  #
+  # Inits the routing system and loads the current route
+  #
+  @setup: (@config, @responder, respond=true) ->
+    @config.html5    = false unless history.pushState
+    @config.prefix ||= ''
+    @config.prefix   = ('/'+@config.prefix+'/').replace(/\/{2,}/g, '/') if @config.html5
+
+    @respond @canonizeLocation() if respond
+
+    if @config.html5
+      @listener = @bind 'popstate pushstate', =>
+        @respond @canonizeLocation()
+
+    else
+      $(window).bind 'hashchange.JoosyRouter', =>
+        @respond @canonizeLocation()
+
+  #
+  # Clears current map of routes and deactivates bindings
+  #
+  @reset: ->
+    @unbind @listener
+    $(window).unbind '.JoosyRouter'
+    @restriction = false
+    @routes = {}
+
+  #
+  # Sets the restriction pattern.
+  # Makes Router ignore URI modification if it matches given regexp.
+  # Set `false` to make router react on all modifications.
+  #
+  # @param [Regexp] restriction
+  #
+  @restrict: (@restriction) ->
+
+  #
+  # Changes current URI and therefore triggers route loading
+  #
+  # @param [String] to                       Route to navigate to
+  #
+  # @option options [Boolean] respond        If false just changes route without responding
+  # @option options [Boolean] replaceState   If true replaces history entry instead of adding. Works only in browsers supporting history.pushState
+  #
+  @navigate: (to, options={}) ->
+    path = to
+
+    if @config.html5
+      path = path.substr(1) if path[0] == '/'
+      path = @config.prefix+path
+    else
+      path = path.substr(1) if path[0] == '#'
+
+      if @config.prefix && !path.startsWith(@config.prefix)
+        path = @config.prefix + path
+
+    if @config.html5
+      history.pushState {}, '', path
+      @trigger 'pushstate'
+    else
+      location.hash = path
+    return
+
+  #
+  # Gets current route out of the window location
+  #
+  # @note canonized location always starts with leading /
+  #
+  @canonizeLocation: ->
+    if @config.html5
+      location.pathname.replace(///^#{RegExp.escape @config.prefix}?///, '/')+location.search
+    else
+      location.hash.replace ///^\#(#{@config.prefix})?\/?///, '/'
+
+  #
+  # Compiles one single route
+  #
+  # @param [String] path            Full path from raw route
+  # @param [Class] response         Class that should be instantiated at this route
+  # @param [Function] response      Lambda to call at this route
+  #
+  @compileRoute: (path, to, as) ->
+    if path.toString() == '404'
+      @wildcardAction = to
+      return
+
+    path = path.substr(1) if path[0] == '/'
+
+    matcher = path.replace /\/{2,}/g, '/'
+    result  = {}
+
+    # Full RegExp matcher for the route
+    matcher = matcher.replace(/\/:([^\/]+)/g, '/([^/]+)')   # Turning :params into regexp section
+    matcher = matcher.replace(/^\/?/, '^/?')                # Making leading slash optional
+    matcher = matcher.replace(/\/?$/, '/?$')                # Making trailing slash optional
+
+    # Array of parameter names
+    params  = (path.match(/\/:[^\/]+/g) || []).map (str) ->
+      str.substr 2
+
+    @routes ||= {}
+    @routes[matcher] =
+      to: to,
+      capture: params
+      as: as
+
+    @defineHelpers path, as if as?
+
+  #
+  # Searches given route at compiled routes and reacts
+  #
+  # @param [String] hash        Hash value to search route for
+  #
+  @respond: (path) ->
+    Joosy.Modules.Log.debug "Router> Answering '#{path}'"
+
+    if (@restriction && path.match(@restriction) == null)
+      @trigger 'restricted', path
+      return
+
+    [path, query] = path.split '?'
+    query = query?.split?('&') || []
+
+    for regex, route of @routes when @routes.hasOwnProperty regex
+      if match = path.match new RegExp(regex)
+        @responder route.to, @__grabParams(query, route, match)
+        @trigger 'responded', path
+        return
+
+    if @wildcardAction?
+      @responder @wildcardAction, path
+      @trigger 'responded'
+    else
+      @trigger 'missed'
+
+  #
+  # Registers Rails-like route helpers (`fooPath()`, `fooUrl()`)
+  #
+  # @param [String] path             String route representation to wrap into helper
+  # @param [String] as               Helpers base name
+  #
+  @defineHelpers: (path, as) ->
+    helper = (options) ->
+      result = path
+
+      path.match(/\/:[^\/]+/g)?.each? (param) ->
+        result = result.replace(param.substr(1), options[param.substr(2)])
+
+      if Joosy.Router.config.html5
+        "#{Joosy.Router.config.prefix}#{result}"
+      else
+        "##{Joosy.Router.config.prefix}#{result}"
+
+    Joosy.helpers 'Routes', ->
+      @["#{as}Path"] = helper
+
+      @["#{as}Url"] = (options) ->
+        if Joosy.Router.config.html5
+          "#{location.origin}#{helper(options)}"
+        else
+          "#{location.origin}#{location.pathname}#{helper(options)}"
+
+  @__grabParams: (query, route=null, match=[]) ->
+    params = {}
+
+    # Collect parameters from route placeholers
+    match.shift() # First entry is full route regexp match that should be just skipped
+
+    route?.capture?.each (key) ->
+      params[key] = decodeURIComponent match.shift()
+
+    # Collect parameters from URL query section
+    query.each (entry) ->
+      unless entry.isBlank()
+        [key, value] = entry.split '='
+        params[key] = value
+
+    params
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/router', -> Joosy.Router

data/{src/joosy/core → source/joosy}/templaters/jst.coffee

@@ -1,12 +1,11 @@
-#= require joosy/core/joosy
+#= require joosy/joosy
 
 #
 # JST template precompilation binding
 #
 class Joosy.Templaters.JST
-  constructor: (applicationName) ->
-    if Object.isString(applicationName) && applicationName.length > 0
-      @applicationName = applicationName
+  constructor: (@config={}) ->
+    @prefix = @config.prefix if @config.prefix? && @config.prefix.length > 0
 
   #
   # Gets template lambda by its full name
@@ -16,10 +15,10 @@ class Joosy.Templaters.JST
   buildView: (name) ->
     template = false
 
-    if @applicationName
+    if @prefix
       haystack = [
-        "#{@applicationName}/templates/#{name}-#{I18n?.locale}",
-        "#{@applicationName}/templates/#{name}"
+        "#{@prefix}/templates/#{name}-#{I18n?.locale}",
+        "#{@prefix}/templates/#{name}"
       ]
     else
       haystack = [
@@ -47,3 +46,7 @@ class Joosy.Templaters.JST
     path.unshift section
 
     "#{path.join '/'}/#{template}"
+
+# AMD wrapper
+if define?.amd?
+  define 'joosy/templaters/jst', -> Joosy.Templaters.JST