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

data/src/joosy/core/modules/events.coffee

@@ -1,188 +0,0 @@
-#= require joosy/core/joosy
-
-#
-# Basic events implementation
-#
-# @mixin
-#
-Joosy.Modules.Events =
-
-  #
-  # Waits for the list of given events to happen at least once. Then runs callback.
-  #
-  # @param [String|Array] events        List of events to wait for separated by space
-  # @param [Function] callback          Action to run when all events were triggered at least once
-  # @param [Hash] options               Options
-  #
-  wait: (name, events, callback) ->
-    @__oneShotEvents ||= {}
-
-    # unnamed binding
-    if Object.isFunction(events)
-      callback = events
-      events   = name
-      name     = Object.keys(@__oneShotEvents).length.toString()
-
-    @__oneShotEvents[name] = [@__splitEvents(events), callback]
-    name
-
-  #
-  # Removes waiter action
-  #
-  # @param [Function] target            Name of waiter to unbind
-  #
-  unwait: (target) ->
-    delete @__oneShotEvents[target]
-
-  #
-  # Binds action to run each time any of given event was triggered
-  #
-  # @param [String|Array] events        List of events separated by space
-  # @param [Function] callback          Action to run on trigger
-  # @param [Hash] options               Options
-  #
-  bind: (name, events, callback) ->
-    @__boundEvents ||= {}
-
-    # unnamed binding
-    if Object.isFunction(events)
-      callback = events
-      events   = name
-      name     = Object.keys(@__boundEvents).length.toString()
-
-    @__boundEvents[name] = [@__splitEvents(events), callback]
-    name
-
-  #
-  # Unbinds action from runing on trigger
-  #
-  # @param [Function] target            Name of bind to unbind
-  #
-  unbind: (target) ->
-    delete @__boundEvents[target]
-
-  #
-  # Triggers event for {bind} and {wait}
-  #
-  # @param [String]           Name of event to trigger
-  #
-  trigger: (event, data...) ->
-    Joosy.Modules.Log.debugAs @, "Event #{event} triggered"
-
-    if @__oneShotEvents
-      fire = []
-      for name, [events, callback] of @__oneShotEvents
-        events.remove event
-        if events.length == 0
-          fire.push name
-      fire.each (name) =>
-        callback = @__oneShotEvents[name][1]
-        delete @__oneShotEvents[name]
-        callback data...
-
-    if @__boundEvents
-      for name, [events, callback] of @__boundEvents
-        if events.any event
-          callback data...
-
-  #
-  # Runs set of callbacks finializing with result callback
-  #
-  # @example Basic usage
-  #   Joosy.synchronize (context) ->
-  #     contet.do (done) -> done()
-  #     contet.do (done) -> done()
-  #     content.after ->
-  #       console.log 'Success!'
-  #
-  # @param [Function] block           Configuration block (see example)
-  #
-  synchronize: (block) ->
-    context = new Joosy.Events.SynchronizationContext(@)
-    block.call(@, context)
-
-    if context.expectations.length == 0
-      context.after.call(@)
-    else
-      @wait context.expectations, => context.after.call(@)
-      context.actions.each (data) =>
-        data[0].call @, =>
-          @trigger data[1]
-
-  __splitEvents: (events) ->
-    if Object.isString events
-      if events.isBlank()
-        events = []
-      else
-        events = events.trim().split /\s+/
-
-    unless Object.isArray(events) && events.length > 0
-      throw new Error "#{Joosy.Module.__className @}> bind invalid events: #{events}"
-
-    events
-
-#
-# Additional events helpers and tools
-#
-Joosy.namespace 'Joosy.Events', ->
-  #
-  # Events namespace
-  #
-  # Creates unified collection of bindings to a particular instance
-  # that can be unbinded alltogether
-  #
-  # @example
-  #   namespace = Joosy.Events.Namespace(something)
-  #
-  #   namespace.bind 'event1', ->
-  #   namespace.bind 'event2', ->
-  #   namespace.unbind() # unbinds both bindings
-  #
-  class @Namespace
-    #
-    # @param [Object] @parent         Any instance that can trigger events
-    #
-    constructor: (@parent) ->
-      @bindings = []
-
-    bind: (args...) -> @bindings.push @parent.bind(args...)
-    unbind: ->
-      @parent.unbind b for b in @bindings
-      @bindings = []
-
-  #
-  # Internal representation of {Joosy.Modules.Events.synchronize} context
-  #
-  # @see Joosy.Modules.Events.synchronize
-  #
-  class @SynchronizationContext
-    @uid = 0
-
-    constructor: (@parent) ->
-      @expectations = []
-      @actions = []
-
-    #
-    # Internal simple counter to separate given synchronization actions
-    #
-    uid: ->
-      @constructor.uid += 1
-
-    #
-    # Registeres another async function that should be synchronized
-    #
-    # @param [Function] action        `(Function) -> null` to call.
-    #   Should call given function to mark itself complete.
-    #
-    do: (action) ->
-      event = "synchro-#{@uid()}"
-      @expectations.push event
-      @actions.push [action, event]
-
-    #
-    # Registers finalizer: the action that will be called when all do-functions
-    #   marked themselves as complete.
-    #
-    # @param [Function] after       Function to call.
-    #
-    after: (@after) ->

data/src/joosy/core/modules/filters.coffee

@@ -1,42 +0,0 @@
-#= require joosy/core/joosy
-
-#
-# Filters registration routines
-#
-# @mixin
-#
-Joosy.Modules.Filters =
-
-  #
-  # Defines static registration routines
-  #
-  # @example Set of methods
-  #   class Test
-  #     @beforeLoad ->  # supposed to run before load and control loading queue
-  #     @afterLoad ->   # supposed to run after load to finalize loading
-  #     @afterUnload -> # supposed to run after unload to collect garbage
-  #
-  #     # private
-  #
-  #     @__runBeforeLoads() # Runs filters registered as beforeLoad
-  #     @__runAfterLoads() # Runs filters registered as afterLoad
-  #     @__runAfterUnloads() # Runs filters registered as afterUnload
-  #
-  included: ->
-    ['beforeLoad', 'afterLoad', 'afterUnload'].each (filter) =>
-      @[filter] = (callback) ->
-        unless @::hasOwnProperty "__#{filter}s"
-          @::["__#{filter}s"] = [].concat @.__super__["__#{filter}s"] || []
-        @::["__#{filter}s"].push callback
-
-
-['beforeLoad', 'afterLoad', 'afterUnload'].each (filter) =>
-  camelized = filter.charAt(0).toUpperCase() + filter.slice(1);
-
-  Joosy.Modules.Filters["__run#{camelized}s"] = (opts...) ->
-    return true unless @["__#{filter}s"]
-
-    @["__#{filter}s"].reduce (flag, func) =>
-      func = @[func] unless Object.isFunction func
-      flag && func.apply(@, opts) != false
-    , true

data/src/joosy/core/page.coffee

@@ -1,383 +0,0 @@
-#= require joosy/core/joosy
-#= require joosy/core/modules/log
-#= require joosy/core/modules/events
-#= require joosy/core/modules/container
-#= require joosy/core/modules/renderer
-#= require joosy/core/modules/time_manager
-#= require joosy/core/modules/widgets_manager
-#= require joosy/core/modules/filters
-
-#
-# Base class for all of your Joosy Pages.
-# @see http://guides.joosy.ws/guides/blog/layouts-pages-and-routing.html
-#
-# @example Sample application page
-#   class @RumbaPage extends Joosy.Layout
-#     @view 'rumba'
-#
-# @include Joosy.Modules.Log
-# @include Joosy.Modules.Events
-# @include Joosy.Modules.Container
-# @include Joosy.Modules.Renderer
-# @include Joosy.Modules.TimeManager
-# @include Joosy.Modules.WidgetsManager
-# @include Joosy.Modules.Filters
-#
-class Joosy.Page extends Joosy.Module
-  @include Joosy.Modules.Log
-  @include Joosy.Modules.Events
-  @include Joosy.Modules.Container
-  @include Joosy.Modules.Renderer
-  @include Joosy.Modules.TimeManager
-  @include Joosy.Modules.WidgetsManager
-  @include Joosy.Modules.Filters
-
-  halted: false
-
-  #
-  # Default layout is no layout.
-  #
-  layout: false
-
-  #
-  # Previous page.
-  #
-  previous: false
-
-  #
-  # Route params.
-  #
-  params: false
-
-  #
-  # Prefetched page data.
-  #
-  data: false
-  dataFetched: false
-
-  #
-  # Sets layout for current page
-  #
-  # @param [Class] layoutClass      Layout to use
-  #
-  @layout: (layoutClass) ->
-    @::__layoutClass = layoutClass
-
-  #
-  # Sets the method which will controll the painting preparation proccess.
-  #
-  # This method will be called right ater previous page {Joosy.Page.erase} and in parallel with
-  #   page data fetching so you can use it to initiate preloader.
-  #
-  # @note Given method will be called with `complete` function as parameter. As soon as your
-  #   preparations are done you should call that function.
-  #
-  # @example Sample before painter
-  #   @beforePaint (container, complete) ->
-  #     if !@data # checks if parallel fetching finished
-  #       $('preloader').slideDown -> complete()
-  #
-  #
-  @beforePaint: (callback) ->
-    @::__beforePaint = callback
-
-  #
-  # Sets the method which will controll the painting proccess.
-  #
-  # This method will be called after fetching, erasing and beforePaint is complete.
-  # It should be used to setup appearance effects of page.
-  #
-  # @note Given method will be called with `complete` function as parameter. As soon as your
-  #   preparations are done you should call that function.
-  #
-  # @example Sample painter
-  #   @paint (container, complete) ->
-  #     @container.fadeIn -> complete()
-  #
-  @paint: (callback) ->
-    @::__paint = callback
-
-  @afterPaint: (callback) ->
-    @::__afterPaint = callback
-
-  #
-  # Sets the method which will controll the erasing proccess.
-  #
-  # Use this method to setup hiding effect.
-  #
-  # @note Given method will be called with `complete` function as parameter. As soon as your
-  #   preparations are done you should call that function.
-  #
-  # @note This method will be caled _before_ unload routines so in theory you can
-  #   access page data from that. Think twice if you are doing it right though.
-  #
-  # @example Sample eraser
-  #   @erase (container, complete) ->
-  #     @container.fadeOut -> complete()
-  #
-  @erase: (callback) ->
-    @::__erase = callback
-
-  #
-  # Sets the method which will controll the data fetching proccess.
-  #
-  # @note Given method will be called with `complete` function as parameter. As soon as your
-  #   preparations are done you should call that function.
-  #
-  # @example Basic usage
-  #   @fetch (complete) ->
-  #     $.get '/rumbas', (@data) => complete()
-  #
-  @fetch: (callback) ->
-    @::__fetch = (complete) ->
-      @data = {}
-      callback.call this, =>
-        @dataFetched = true
-        complete()
-
-  #
-  # Sets the several separate methods that will fetch data in parallel.
-  #
-  # @note This will work through {Joosy.Modules.Events.synchronize}
-  #
-  # @example Basic usage
-  #   @fetchSynchronized (context) ->
-  #     context.do (done) ->
-  #       $.get '/rumbas', (data) =>
-  #         @data.rumbas = data
-  #         done()
-  #
-  #     context.do (done) ->
-  #       $.get '/kutuzkas', (data) =>
-  #         @data.kutuzkas = data
-  #         done()
-  #
-  @fetchSynchronized: (callback) ->
-    @::__fetch = (complete) ->
-      @synchronize (context) ->
-        context.after -> complete()
-        callback.call(this, context)
-
-  #
-  # Sets the position where page will be scrolled to after load.
-  #
-  # @note If you use animated scroll joosy will atempt to temporarily fix the
-  #   height of your document while scrolling to prevent jump effect.
-  #
-  # @param [jQuery] element         Element to scroll to
-  # @param [Hash] options
-  #
-  # @option options [Integer] speed       Sets the animation duration (500 is default)
-  # @option options [Integer] margin      Defines the margin from element position.
-  #   Can be negative.
-  #
-  @scroll: (element, options={}) ->
-    @::__scrollElement = element
-    @::__scrollSpeed = options.speed || 500
-    @::__scrollMargin = options.margin || 0
-
-  #
-  # Scrolls page to stored positions
-  #
-  __performScrolling: ->
-    scroll = $(@__extractSelector @__scrollElement).offset()?.top + @__scrollMargin
-    Joosy.Modules.Log.debugAs @, "Scrolling to #{@__extractSelector @__scrollElement}"
-    $('html, body').animate {scrollTop: scroll}, @__scrollSpeed, =>
-      if @__scrollSpeed != 0
-        @__releaseHeight()
-
-  #
-  # 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(this) else title
-      titleStr = titleStr.join(separator) if Object.isArray(titleStr)
-      @__previousTitle = document.title
-      document.title = titleStr
-
-    @afterUnload ->
-      document.title = @__previousTitle
-
-  #
-  # Constructor is very destructive (c), it calls bootstrap directly so use with caution.
-  #
-  # @params [Hash] params             Route params
-  # @params [Joosy.Page] previous     Previous page to unload
-  #
-  constructor: (@params, @previous) ->
-    @__layoutClass ||= ApplicationLayout
-
-    unless @halted = !@__runBeforeLoads(@params, @previous)
-      Joosy.Application.loading = true
-
-      if !@previous?.layout?.uid? || @previous?.__layoutClass != @__layoutClass
-        @__bootstrapLayout()
-      else
-        @__bootstrap()
-
-  #
-  # @see Joosy.Router.navigate
-  #
-  navigate: (args...) ->
-    Joosy.Router.navigate(args...)
-
-  #
-  # This is required by {Joosy.Modules.Renderer}
-  # Sets the base template dir to app_name/templates/pages
-  #
-  __renderSection: ->
-    'pages'
-
-  #
-  # Freezes the page height through $(html).
-  #
-  # Required to implement better {Joosy.Page.scroll} behavior.
-  #
-  __fixHeight: ->
-    $('html').css 'min-height', $(document).height()
-
-  #
-  # Undo {#__fixHeight}
-  #
-  __releaseHeight: ->
-    $('html').css 'min-height', ''
-
-  #
-  # Page bootstrap proccess
-  #
-  #   * {Joosy.Modules.Container.__assignElements}
-  #   * {Joosy.Modules.Container.__delegateEvents}
-  #   * {Joosy.Modules.WidgetsManager.__setupWidgets}
-  #   * Scrolling
-  #
-  __load: ->
-    @__assignElements()
-    @__delegateEvents()
-    @__setupWidgets()
-    @__runAfterLoads @params, @previous
-    @__performScrolling() if @__scrollElement
-    Joosy.Application.loading = false
-    Joosy.Router.trigger 'loaded', this
-    @trigger 'loaded'
-
-    Joosy.Modules.Log.debugAs @, "Page loaded"
-
-  #
-  # Page destruction proccess.
-  #
-  #   * {Joosy.Modules.TimeManager.__clearTime}
-  #   * {Joosy.Modules.WidgetsManager.__unloadWidgets}
-  #   * {Joosy.Modules.Renderer.__removeMetamorphs}
-  #
-  __unload: ->
-    @__clearTime()
-    @__unloadWidgets()
-    @__removeMetamorphs()
-    @__runAfterUnloads @params, @previous
-    delete @previous
-
-  #
-  # Proxies callback through possible async wrapper.
-  #
-  # If wrapper is defined, it will be called with given callback as one of parameters.
-  # If wrapper is not defined callback will be called directly.
-  #
-  # @note Magic People Voodoo People
-  #
-  # @param [Object] entity        Object possibly containing wrapper method
-  # @param [String] receiver      String name of wrapper method inside entity
-  # @param [Hash] params          Params to send to wrapper, callback will be
-  #   attached as the last of them.
-  # @param [Function] callback    Callback to run
-  #
-  __callSyncedThrough: (entity, receiver, params, callback) ->
-    if entity?[receiver]?
-      entity[receiver].apply entity, params.clone().add(callback)
-    else
-      callback()
-
-  #
-  # The single page (without layout reloading) bootstrap logic
-  #
-  # @example Hacky boot sequence description
-  #   previous::erase  \
-  #   previous::unload  \
-  #   beforePaint        \
-  #                       > paint
-  #   fetch             /
-  #
-  __bootstrap: ->
-    Joosy.Modules.Log.debugAs @, "Boostraping page"
-    @layout = @previous.layout
-
-    callbacksParams = [@layout.content()]
-
-    if @__scrollElement && @__scrollSpeed != 0
-      @__fixHeight()
-
-    @wait "stageClear dataReceived", =>
-      @previous?.__afterPaint?(callbacksParams)
-      @__callSyncedThrough this, '__paint', callbacksParams, =>
-        # Page HTML
-        @swapContainer @layout.content(), @__renderDefault(@data || {})
-        @container = @layout.content()
-
-        # Loading
-        @__load()
-
-    @__callSyncedThrough @previous, '__erase', callbacksParams, =>
-      @previous?.__unload()
-      @__callSyncedThrough @, '__beforePaint', callbacksParams, =>
-        @trigger 'stageClear'
-
-    @__callSyncedThrough @, '__fetch', [], =>
-      Joosy.Modules.Log.debugAs @, "Fetch complete"
-      @trigger 'dataReceived'
-
-  #
-  # The page+layout bootstrap logic
-  #
-  # @example Hacky boot sequence description
-  #   previous::erase  \
-  #   previous::unload  \
-  #   beforePaint        \
-  #                       > paint
-  #   fetch             /
-  #
-  __bootstrapLayout: ->
-    Joosy.Modules.Log.debugAs @, "Boostraping page with layout"
-    @layout = new @__layoutClass(@params)
-
-    callbacksParams = [Joosy.Application.content(), this]
-
-    if @__scrollElement && @__scrollSpeed != 0
-      @__fixHeight()
-
-    @wait "stageClear dataReceived", =>
-      @__callSyncedThrough @layout, '__paint', callbacksParams, =>
-        # Layout HTML
-        @swapContainer Joosy.Application.content(), @layout.__renderDefault(@layout.data || {})
-
-        # Page HTML
-        @swapContainer @layout.content(), @__renderDefault(@data || {})
-        @container = @layout.content()
-
-        # Loading
-        @layout.__load Joosy.Application.content()
-        @__load()
-
-    @__callSyncedThrough @previous?.layout, '__erase', callbacksParams, =>
-      @previous?.layout?.__unload?()
-      @previous?.__unload()
-      @__callSyncedThrough @layout, '__beforePaint', callbacksParams, =>
-        @trigger 'stageClear'
-
-    @__callSyncedThrough @layout, '__fetch', [], =>
-      @__callSyncedThrough @, '__fetch', [], =>
-        Joosy.Modules.Log.debugAs @, "Fetch complete"
-        @trigger 'dataReceived'