lol_framework 0.1.0

data/vendor/assets/javascripts/lol.js

@@ -0,0 +1,18 @@
+//= require ./lol_framework/Library/date-functions
+//= require ./lol_framework/Library/jquery.dataTables.min
+//= require ./lol_framework/Library/jquery.mobile
+//= require ./lol_framework/Lol
+//= require ./lol_framework/Lang/en-us
+//= require ./lol_framework/Lang/pt-br
+//= require ./lol_framework/I18n
+//= require ./lol_framework/Debug
+//= require ./lol_framework/Utils
+//= require ./lol_framework/Core
+//= require ./lol_framework/Alert
+//= require ./lol_framework/Button
+//= require ./lol_framework/Loader
+//= require ./lol_framework/Ajax
+//= require ./lol_framework/Modal
+//= require ./lol_framework/Model
+//= require ./lol_framework/Model/Rest
+//= require ./lol_framework/Datatable

data/vendor/assets/javascripts/lol_framework/Ajax.coffee

@@ -0,0 +1,183 @@
+###
+@summary     Lol Framework
+@description Framework of RIAs applications
+@version     1.0.0
+@file        Ajax.js
+@author      Welington Sampaio (http://welington.zaez.net/)
+@contact     http://welington.zaez.net/site/contato
+
+@copyright Copyright 2012 Welington Sampaio, all rights reserved.
+
+This source file is free software, under the license MIT, available at:
+http://lolframework.zaez.net/license
+
+This source file is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the license files for details.
+
+For details please refer to: http://welington.zaez.net
+###
+
+###
+Create a new instance of Ajax.
+
+@classDescription This class creates a new Ajax.
+@param  {Object}     Receives configuration to create the Ajax, @see Lol.ajax.defaults
+@return {Ajax}       Returns a new Ajax.
+@type   {Object}
+@example
+  *-* Manual Configuration *-*
+  var lol_ajax = new Lol.Ajax({
+    autoExecute: true,
+    useLoader  : true,
+    contentType: 'application/x-www-form-urlencoded; charset=UTF-8',
+    url        : 'http://www.google.com/',
+    method     : 'GET',
+    data       : {},
+    dataType   : 'html',
+    callbacks: {
+      beforeSend: function(jqXHR, settings){},
+      complete:   function(jqXHR, textStatus){},
+      error:      function(jqXHR, textStatus, errorThrown){},
+      success:    function(data, textStatus, jqXHR){}
+    }
+  });
+###
+class Lol.Ajax extends Lol.Core
+  # declaration of variables
+  debugPrefix : 'Lol_Ajax'
+  namespace   : '.ajax'
+  # the methods
+  constructor: (args={})->
+    return false unless @verifyJQuery()
+    @settings = jQuery.extend true, {}, Lol.ajax.defaults, args
+    @generateId()
+    @execute() if @settings.autoExecute
+  ###
+  Get all the configuration data
+  sent and configures sending
+  @see http://api.jquery.com/jQuery.ajax/
+  ###
+  execute: ->
+    @debug 'Executing the ajax requisition', @
+    if not @settings.url or not @settings.callbacks.error or not @settings.callbacks.success
+      throw 'Fields requireds not setting'
+    _this = @
+    Lol.Loader.show() if @settings.userLoader
+    jQuery.ajax
+      contentType: @settings.contentType
+      url        : @settings.url
+      type       : @settings.method
+      data       : jQuery.param @settings.data
+      dataType   : @settings.dataType
+      beforeSend : _this.settings.callbacks.beforeSend
+      complete   : _this.settings.callbacks.complete
+      error      : (jqXHR, textStatus, errorThrown)->
+        Lol.Loader.remove()
+        _this.settings.callbacks.error(jqXHR, textStatus, errorThrown)
+      success    : (data, textStatus, jqXHR)->
+        Lol.Loader.remove()
+        _this.settings.callbacks.success(data, textStatus, jqXHR)
+  ###
+  Set a new ContentType
+  @see http://api.jquery.com/jQuery.ajax/
+  @param  {String}
+  @return {String}
+  ###
+  setContentType: (value)-> @settings.contentType = value
+  ###
+  Indicates whether to lock the screen with a loader
+  @param  {Boolean}
+  @return {Boolean}
+  ###
+  setUseLoader:   (value)-> @settings.useLoader   = value
+  ###
+  Set a new Url
+  @see http://api.jquery.com/jQuery.ajax/
+  @param  {String}
+  @return {String}
+  ###
+  setUrl:         (value)-> @settings.url         = value
+  ###
+  Set a new Method
+  @see http://api.jquery.com/jQuery.ajax/
+  @param  {String}
+  @return {String}
+  ###
+  setMethod:      (value)-> @settings.method      = value
+  ###
+  Set a new Data content
+  @see http://api.jquery.com/jQuery.ajax/
+  @param  {Object}
+  @return {Object}
+  ###
+  setData:        (value)-> @settings.data        = value
+  ###
+  Set a new DataType
+  @see http://api.jquery.com/jQuery.ajax/
+  @param  {String}
+  @return {String}
+  ###
+  setDataType:    (value)-> @settings.dataType    = value
+
+###
+Contains the definitions of standards Lol.Ajax
+@type {Object}
+###
+Lol.ajax =
+  defaults:
+    ###
+    Indicates whether the object should
+    be executed at the end of its creation
+    @type {Boolean}
+    ###
+    autoExecute: true
+    ###
+    Indicates whether the object should use
+    a loader to stop, until the completion
+    of the request
+    @type {Boolean}
+    ###
+    useLoader  : true
+    ###
+    Indicates the content type of the request
+    @type {String}
+    ###
+    contentType: 'application/x-www-form-urlencoded; charset=UTF-8'
+    ###
+    Indicates the url of the request
+    @type {String}
+    ###
+    url        : null
+    ###
+    Indicates the method of the request
+    options : GET | POST | PUT | DELETE
+    @type {String}
+    ###
+    method     : 'GET'
+    ###
+    Indicates the content of the request
+    @type {Object}
+    ###
+    data       : {}
+    ###
+    Indicates the type of expected return
+    after the completion of request
+    @type {String}
+    ###
+    dataType   : 'json'
+    ###
+    Callbacks run through the requisition
+    @see http://api.jquery.com/jQuery.ajax/
+    ###
+    callbacks:
+      beforeSend: (jqXHR, settings)->
+      complete: (jqXHR, textStatus)->
+      error: (jqXHR, textStatus, errorThrown)->
+      success: (data, textStatus, jqXHR)->
+
+# if is rails application and using csrf-token
+jQuery ->
+  jQuery(document).ajaxSend (e, xhr, options)->
+    token = $("meta[name='csrf-token']").attr "content"
+    xhr.setRequestHeader("X-CSRF-Token", token)

data/vendor/assets/javascripts/lol_framework/Alert.coffee

@@ -0,0 +1,113 @@
+###
+@summary     Lol Framework
+@description Framework of RIAs applications
+@version     1.0.0
+@file        Alert.js
+@author      Welington Sampaio (http://welington.zaez.net/)
+@contact     http://welington.zaez.net/site/contato
+
+@copyright Copyright 2012 Welington Sampaio, all rights reserved.
+
+This source file is free software, under the license MIT, available at:
+http://lolframework.zaez.net/license
+
+This source file is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the license files for details.
+
+For details please refer to: http://welington.zaez.net
+###
+
+###
+Create a new instance of Alert.
+
+@classDescription This class creates a new Alert.
+@param  {Object}     Receives configuration to create the Alert, @see Lol.alert.defaults
+@return {Alert}       Returns a new Alert.
+@type   {Object}
+@example
+  *-* Create manual alert *-*
+  var lol_alert = new Lol.Alert({
+    autoRemove : true,
+    type       : 'success',
+    message    : 'Success to create a new object LolAlert',
+    delayRemove: 7000,
+    objects : {
+      containerID: '#alerts',
+      classes: {
+        container: 'alerts',
+        success  : 'alert-success',
+        error    : 'alert-error',
+        warning  : 'alert-warning',
+        info     : 'alert-info'
+      }
+    }
+  });
+###
+class Lol.Alert extends Lol.Core
+# declaration of variables
+  debugPrefix : 'Lol_Alert'
+  namespace   : '.alert'
+  # the methods
+  constructor: (args={})->
+    return false unless @verifyJQuery()
+    @settings = jQuery.extend true, {}, Lol.alert.defaults, args
+    @generateId()
+    return false unless @setContainer()
+    @createAlert()
+    @setEvents()
+    @setInterval()
+  appendClose: ->
+    @debug 'Create and append close button to alert'
+    @close = jQuery "<span></span>"
+    @close.append "x"
+    @close.appendTo @alert
+  createAlert: ->
+    @debug 'Create an object Alert'
+    @alert = jQuery '<div></div>'
+    @alert.addClass "alert #{@settings.objects.classes[@settings.type]}"
+    @alert.append @settings.message
+    @appendClose()
+    @alert.appendTo @container
+  destroy: ->
+    @debug 'Initializing the destroy method'
+    @alert.slideUp ->
+      jQuery(@).remove()
+    clearInterval(@interval) if @settings.autoRemove
+    super
+  setContainer: ->
+    @debug 'Setting a container object'
+    if not jQuery( @settings.objects.containerID )
+      throw  "Required container Alert: #{@settings.objects.containerID}"
+      return false
+    @container = jQuery @settings.objects.containerID
+  setInterval: ->
+    @debug 'Setting interval?',@settings.autoRemove, 'With delay:',@settings.delayRemove
+    _this = @
+    @interval = setInterval(->
+      _this.destroy()
+    , @settings.delayRemove) if @settings.autoRemove
+  setEvents: ->
+    @debug 'Setting all events'
+    _this = @
+    @close.bind "click#{@namespace}", ->
+      _this.debug 'Dispatch event clickon close button'
+      _this.destroy()
+
+Lol.alert =
+#  private:
+#    dataset:
+
+  defaults:
+    autoRemove : true
+    type       : 'success' # Options success | error | warning | info
+    message    : null
+    delayRemove: 7000
+    objects :
+      containerID: '#alerts'
+      classes:
+        container: 'alerts'
+        success  : 'alert-success'
+        error    : 'alert-error'
+        warning  : 'alert-warning'
+        info     : 'alert-info'

data/vendor/assets/javascripts/lol_framework/Button.coffee

@@ -0,0 +1,268 @@
+###
+@summary     Lol Framework
+@description Framework of RIAs applications
+@version     1.0.0
+@file        Button.js
+@author      Welington Sampaio (http://welington.zaez.net/)
+@contact     http://welington.zaez.net/site/contato
+
+@copyright Copyright 2012 Welington Sampaio, all rights reserved.
+
+This source file is free software, under the license MIT, available at:
+http://lolframework.zaez.net/license
+
+This source file is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+or FITNESS FOR A PARTICULAR PURPOSE. See the license files for details.
+
+For details please refer to: http://welington.zaez.net
+###
+
+###
+Create a new instance of Button.
+
+@classDescription This class creates a new Button.
+@param  {Object}     Receives configuration to create the Button, @see Lol.button.defaults
+@return {Button}       Returns a new Button.
+@type   {Object}
+###
+class Lol.Button extends Lol.Core
+  # Variables declaration
+  debugPrefix	: 'Lol_Button'
+  namespace		: '.button'
+  # The methods
+  constructor: (args={})->
+    return false unless @verifyJQuery()
+    @settings = jQuery.extend true, {}, Lol.button.defaults, args
+    @generateId()
+    @buttons = []
+    @createButtons()
+    return @buttons if @buttons.length
+    @createButton()
+    @addAttributes()
+    @setEvents()
+    @addToContainer()
+  ###
+  Adds attributes to the button
+  ###
+  addAttributes: ->
+    @debug "Add attributes to button: ", @settings.atribute
+    for key,value of @settings.atribute
+      @button.attr key, value
+  ###
+  Adds attributes to the button
+  ###
+  addToContainer: ->
+    @container = $ @settings.container
+    if @buttons.length
+      for btn in @buttons
+        @container.append btn
+    else
+      @container.append @button
+  ###
+  Creates the buttons on block
+  options: OK | CANCEL | YES | NO
+  ###
+  createButtons: ->
+    throw 'Invalid button' if not @settings.buttons and not @settings.text
+    if @settings.buttons
+      @debug 'Creating buttons:', @settings.buttons
+      text = new String @settings.buttons
+      if text.indexOf('YES') isnt -1
+        @buttons.push new Lol.Button
+          text : 'YES'
+          attribute: @settings.attributes.YES
+          container: @settings.container
+          class: @settings.classes.YES
+          debug: @settings.debug
+          callback:
+            click: @settings.fn.YES_CLICK
+      if text.indexOf('NO') isnt -1
+        @buttons.push new Lol.Button
+          text : 'NO'
+          attribute: @settings.attributes.NO
+          container: @settings.container
+          class: @settings.classes.NO
+          debug: @settings.debug
+          callback:
+            click: @settings.fn.NO_CLICK
+      if text.indexOf('OK') isnt -1
+        @buttons.push new Lol.Button
+          text : 'OK'
+          attribute: @settings.attributes.OK
+          container: @settings.container
+          class: @settings.classes.OK
+          debug: @settings.debug
+          callback:
+            click: @settings.fn.OK_CLICK
+      if text.indexOf('CANCEL') isnt -1
+        @buttons.push new Lol.Button
+          text : 'CANCEL'
+          attribute: @settings.attributes.CANCEL
+          container: @settings.container
+          class: @settings.classes.CANCEL
+          debug: @settings.debug
+          callback:
+            click: @settings.fn.CANCEL_CLICK
+  ###
+  Creates the button specified in the settings
+  ###
+  createButton: (text)->
+    @debug 'Creating button: ', @settings.text
+    @debug "Add class '#{@settings.class}' to current button"
+    @button = $ '<a></a>'
+    @button.html Lol.t(@settings.text)
+    @button.addClass @settings.class
+  ###
+  Creates the button specified in the settings
+  ###
+  unsetEvents: ->
+    @debug "Remove all events with namespace: '#{@namespace}'"
+    @button.unbind @namespace
+  ###
+  Adds all events related to this button
+  ###
+  setEvents: ->
+    @unsetEvents()
+    @debug "Add click event with namespace: '#{@namespace}'"
+    _this = @
+    @button.bind("click#{@namespace}", (event)->
+      _this.debug "Dispath click event, with return: ", _this.settings.return_handler
+      r_callback = _this.settings.callback.click(event, _this)
+      return r_callback if _this.settings.return_handler
+      _this.settings.return_handler
+    )
+
+###
+Contains the definitions of standards Lol.Button
+@type {Object}
+###
+Lol.button =
+  defaults:
+    ###
+    It contains attributes related
+    to the button in question
+    @type {Object}
+    ###
+    attribute     : {}
+    ###
+    String with the text referring to
+    the block to create buttons
+    @options YES | NO | OK | CANCEL
+    @type {String}
+    ###
+    buttons       : null
+    ###
+    Contains CSS classes to add to the button
+    @type {String}
+    ###
+    class         : ''
+    ###
+    Object or container where the button
+    should be added
+    @type {String or DOMObject}
+    ###
+    container     : 'body'
+    ###
+    Specifies whether the object should
+    print debug messages
+    @type {Boolean}
+    ###
+    debug         : false
+    ###
+    Specifies what should be the return of
+    the event after shooting
+    @type {Boolean}
+    ###
+    return_handler: false
+    ###
+    Enter the text within the button
+    @type {String}
+    ###
+    text          : null
+    ###
+    Object that contains the attributes
+    of the buttons on the block
+    @type {Object}
+    ###
+    attributes:
+      ###
+      Attributes for the CANCEL button
+      @type {Object}
+      ###
+      CANCEL : {}
+      ###
+      Attributes for the NO button
+      @type {Object}
+      ###
+      NO     : {}
+      ###
+      Attributes for the OK button
+      @type {Object}
+      ###
+      OK     : {}
+      ###
+      Attributes for the YES button
+      @type {Object}
+      ###
+      YES    : {}
+    ###
+    Specifies the events for the button
+    @type {Object}
+    ###
+    callback:
+      ###
+      Click event to the button
+      @type {Function}
+      ###
+      click: ->
+    ###
+    Contains classes to add buttons on the block
+    @type {Object}
+    ###
+    classes:
+      ###
+      Contains CSS classes to add to the OK button
+      @type {String}
+      ###
+      OK    : 'btn'
+      ###
+      Contains CSS classes to add to the CANCEL button
+      @type {String}
+      ###
+      CANCEL: 'btn'
+      ###
+      Contains CSS classes to add to the YES button
+      @type {String}
+      ###
+      YES   : 'btn'
+      ###
+      Contains CSS classes to add to the NO button
+      @type {String}
+      ###
+      NO    : 'btn'
+    ###
+    Contains events to add buttons on the block
+    @type {String}
+    ###
+    fn:
+      ###
+      Click event to the OK button
+      @type {Function}
+      ###
+      OK_CLICK: ->
+      ###
+      Click event to the CANCEL button
+      @type {Function}
+      ###
+      CANCEL_CLICK: ->
+      ###
+      Click event to the YES button
+      @type {Function}
+      ###
+      YES_CLICK: ->
+      ###
+      Click event to the NO button
+      @type {Function}
+      ###
+      NO_CLICK: ->