kickstart_rails 3.0.39 → 3.0.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e0c66b6581eb62b53ab2d405883821068784e535
-  data.tar.gz: 17b7e728bb509115bf112b6c96fa9f35898eae44
+  metadata.gz: 1392983d4cb6ba0696aa53cacf07e56c54ae2a06
+  data.tar.gz: bbb85a8f300a847d8752f33ef62a9551bd0dae43
 SHA512:
-  metadata.gz: a0a2a4f4c89a20fdcfd75d1eb2d0a829ab7b2e93f2aa775a9a20dcb66917b229fe0cc6e8940d6b1a1a44827e29707a625a5175e7c69c6a13e8f609f9c0fe3b01
-  data.tar.gz: 78449b7d1e946183b7135f9449e0cb1fcb374b8aa2cf13ba5004193b45ac791e5ab23359b10c850bc9980b004f0843580db039458bf0f6ad9ce552894460eb4a
+  metadata.gz: 6d36d3661755a02f91a293c87141f10c381468e231b1a4853c0873f2db5f01ffdb0d4244032db34f84ff6d8b4566dfebfd5eb47ca0e7e722535c229995102844
+  data.tar.gz: 48834a41145fa5eddf133fe6b343c79fd70e4ceb4c08f4c7fb5fd182d6637c18213cce94c01d4f4662d22803a2e5d63b378875e2cd0c2261467ae9254c2d1fe4

data/app/assets/javascripts/kickstart_rails/app.coffee

@@ -0,0 +1,17 @@
+KS        = require './ks'
+Modal     = require './modal'
+Dropdown  = require './dropdown'
+Navbar    = require './navbar'
+Debounce  = require './debouncer'
+Status    = require './status'
+Tabs      = require './tabs'
+Throttler = require './throttler'
+Buttons   = require './buttons'
+Buffer    = require './buffer'
+Growl     = require './growl'
+
+k$.ready = ->
+  k$.button()
+  k$.dropdown()
+
+document.addEventListener 'DOMContentLoaded', -> k$.ready()

data/app/assets/javascripts/kickstart_rails/buffer.coffee

@@ -0,0 +1,32 @@
+buffer = (fn, delay) ->
+
+  # Create a new bufferArray if one does not exist already.
+  k$.bufferArray = k$.bufferArray || new Array()
+  if not k$.bufferArray.length
+    k$.bufferArray = new Array()
+
+    delay = delay || 500
+
+    # Create an interval to fire the fns in bufferArray
+    i = 1
+
+    k$.bufferInterval = setInterval ->
+      k$.bufferArray[i]() if k$.bufferArray[i]
+      i++
+      if i >= k$.bufferArray.length
+        clearInterval k$.bufferInterval
+        k$.bufferArray = undefined
+        i = 1
+    , delay
+
+  # Add this function to the array.
+  k$.bufferArray.push fn
+
+  # Fire right away if it's the first in line.
+  k$.bufferArray[0]() if k$.bufferArray.length == 1
+
+  console.info "Function queued (#{k$.bufferArray.length} in queue)"
+
+k$.buffer = buffer
+
+module.exports = buffer

data/app/assets/javascripts/kickstart_rails/buttons.coffee

@@ -0,0 +1,8 @@
+button = ->
+
+  ($button.classList.add 'menu-item' if $button.querySelectorAll('ul').length) for $button in k$.$$("button")
+  $buttonDropdown.parentNode.classList.add 'menu-item' for $buttonDropdown in k$.$$ '.button-dropdown'
+
+k$.button = button
+
+module.exports = button

data/app/assets/javascripts/kickstart_rails/debouncer.coffee

@@ -0,0 +1,14 @@
+debounce = (fn, id, delay) ->
+
+  $delay = delay || 1000
+
+  k$.debounceQueue = id if k$.debounceQueue == null
+  clearTimeout k$.debounceTimer if id == k$.debounceQueue
+  k$.debounceTimer = setTimeout ->
+    fn()
+    k$.debounceQueue = null
+  , $delay
+
+k$.debounce = debounce
+
+module.exports = debounce

data/app/assets/javascripts/kickstart_rails/docs.coffee

@@ -0,0 +1,179 @@
+document.addEventListener 'DOMContentLoaded', ->
+
+  window.$$ = (el) -> document.querySelectorAll(el)
+  window.$ = (el) -> $$(el)[0]
+
+  ###
+  CRUD DOCUMENTATION SETTINGS
+  ###
+
+  # Default settings
+  defaults =
+    viewOptions:
+      jquery: false
+      semantic: true
+
+  booleanViewOptions = ['jquery', 'semantic']
+
+  # Retrieve user's saved settings
+  options = JSON.parse localStorage.getItem 'kickstartDocs'
+
+  # Create shallow extend function
+  # (http://andrewdupont.net/2009/08/28/deep-extending-objects-in-javascript/)
+  extend = (destination, source) ->
+    for property of source
+      if source[property] and source[property].constructor and source[property].constructor is Object
+        destination[property] = destination[property] or {}
+        arguments.callee destination[property], source[property]
+      else
+        destination[property] = source[property]
+    destination
+
+  # Extend from defaults
+  settings = if options then extend defaults, options else defaults
+
+  # Create function to write to localStorage
+  setSettings = (settings) ->
+    localStorage.setItem 'kickstartDocs', JSON.stringify settings
+
+    for option in booleanViewOptions
+      if settings.viewOptions["#{option}"]
+        document.body.classList.add "show-#{option}"
+      else
+        document.body.classList.remove "show-#{option}"
+
+  # Write to localStorage
+  setSettings(settings)
+
+  els = []
+  for option in booleanViewOptions
+    option = "#docs-#{option}"
+    els.push option
+
+  if $$(els).length
+    # This page has checkboxes for view options.
+    for option in booleanViewOptions
+      # Closure needed for event listeners
+      do (option) ->
+        window["$opt#{option}"] = $ "#docs-#{option}"
+
+        # Set state of buttons based on saved options in localStorage
+        window["$opt#{option}"].checked = (if settings.viewOptions["#{option}"] then true else false)
+
+        # Listen for checkbox changes
+        window["$opt#{option}"].addEventListener 'click', ->
+          settings.viewOptions["#{option}"] = this.checked
+          setSettings settings
+
+  # Show growls
+  if k$.$('#example-showGrowl')
+    k$.$('#example-showGrowl').addEventListener 'click', ->
+      growls = [
+        {
+          title: 'Document Saved.',
+          text: 'Your document was successfully saved.'
+          type: 'alert-green'
+        },
+        {
+          title: 'Library book not found'
+          text: 'Sorry, we could find that library book.',
+          type: 'alert-red'
+        },
+        {
+          title: 'Wide clearance selection',
+          text: 'Remember to check out our clearance',
+          type: 'alert-blue'
+        },
+        {
+          title: 'Deadline approaching',
+          text: 'Friendly reminder that your deadline is quickly approaching.',
+          type: 'alert-yellow'
+        }
+      ]
+
+      k$.exampleCounter++
+      k$.exampleCounter = 0 if not k$.exampleCounter or k$.exampleCounter > 3
+
+      k$.growl growls[k$.exampleCounter]
+
+  # Show status message
+  if k$.$('#example-showStatus')
+    k$.$('#example-showStatus').addEventListener 'click', ->
+      statuses = [
+        {
+          text: 'Document Saved.',
+          type: 'status-green'
+        },
+        {
+          text: 'Sorry, we could find that library book.',
+          type: 'status-red'
+        },
+        {
+          text: 'Remember to check out our clearance',
+          type: 'status-blue'
+        },
+        {
+          text: 'Deadline is approaching!',
+          type: 'status-yellow'
+        }
+      ]
+
+      k$.exampleCounter++
+      k$.exampleCounter = 0 if not k$.exampleCounter or k$.exampleCounter > 3
+
+      k$.status(statuses[k$.exampleCounter])
+
+  k$.slugify = (str) ->
+    `str.toLowerCase().replace(/ /g,'-').replace(/[^\w-]+/g,'')`
+
+  # Create a table of contents
+
+  if k$.$$('#toc').length
+    k$.$('.creating-table').parentNode.removeChild k$.$('.creating-table')
+    $toc = document.createElement 'ul'
+    $toc.className = "list list-unstyled"
+    $link = document.createElement('li')
+    $link.innerHTML = '<a></a>'
+
+    # Assuming proper html, start with h1.
+    $headingLevel = 1
+
+    # The node we're currently appending to. Always a ul.
+    $targetNode = $toc
+
+    $documentContainer = k$.$('.document-container')
+    for heading in $documentContainer.querySelectorAll('h1, h2, h3, h4, h5, h6')
+      # Ignore headings that declare themselves as exempt from the TOC
+      if not heading.classList.contains 'toc-exempt'
+        # For extra unique names.
+        # heading.id = "#{k$.slugify heading.innerHTML}-#{_k}"
+
+        heading.id = k$.slugify heading.innerHTML
+
+        # If this is a lower level.
+        $thisHeadingLevel = parseInt(heading.tagName.substr(1, 2))
+
+        if $thisHeadingLevel > $headingLevel
+          # Append a new submenu and make that the targetNode.
+          $newSubmenu = document.createElement 'ul'
+          $targetNode.children[$targetNode.children.length - 1].appendChild $newSubmenu 
+          $targetNode = $newSubmenu
+          $headingLevel = $thisHeadingLevel
+
+        # If this is a higher level
+        if $thisHeadingLevel < $headingLevel
+          $stepsUp = $headingLevel - $thisHeadingLevel
+
+          while $stepsUp > -1
+            $targetNode = $targetNode.parentNode
+            $stepsUp--
+
+          $headingLevel = $thisHeadingLevel
+
+        # Make a new li and append it to the target ul node.
+        $menuItem = $link.cloneNode true
+        $menuItem.querySelector('a').href = "##{heading.id}"
+        $menuItem.querySelector('a').innerHTML = heading.innerHTML
+        $targetNode.appendChild $menuItem
+
+    k$.$('#toc').appendChild $toc

data/app/assets/javascripts/kickstart_rails/dropdown.coffee

@@ -0,0 +1,40 @@
+dropdown = () ->
+
+  # The following should apply to several elements.
+
+  $menuItems = k$.$$ '.menu-item'
+
+  for $_menuItem in $menuItems
+
+    $menuItem = $_menuItem.cloneNode true
+    $_menuItem.parentNode.replaceChild $menuItem, $_menuItem
+
+    do ($menuItem) ->
+      # TODO: Is there a way we could not have an event listener for every
+      # single one?
+      $menuItem.addEventListener 'click', (e) ->
+
+        # Just close it if it's already open
+        if $menuItem.classList.contains 'open'
+          $menuItem.classList.remove 'open'
+          return
+
+        # Reset all
+        _$menuItem.classList.remove 'open' for _$menuItem in document.querySelectorAll('.menu-item')
+        $openable = $menuItem.querySelector 'ul'
+
+        # Open this one
+        if $openable
+          $menuItem.classList.add 'open'
+
+        # Prevent bubbling
+        e.stopPropagation()
+
+  # Dismiss all
+  document.body.addEventListener 'click', ->
+    $ul.parentNode.classList.remove 'open' for $ul in k$.$$('.menu-item > ul')
+    $li.classList.remove 'open' for $li in k$.$$('.menu-item.open')
+
+k$.dropdown = dropdown
+
+module.exports = dropdown

data/app/assets/javascripts/kickstart_rails/growl.coffee

@@ -0,0 +1,56 @@
+growl = (params) ->
+
+  k$.buffer ->
+    defaults =
+      title: undefined
+      text: undefined
+      delay: 2000
+      type: 'alert-warn'
+      id: Date.now()
+
+    params = k$.extend defaults, params
+
+    # Create growl container
+    if not k$.$$('.growl_container').length
+      growlContainer = document.createElement 'div'
+      growlContainer.className = 'growl_container'
+      document.body.appendChild growlContainer
+
+    # Create growl
+    growl = document.createElement 'div'
+
+    # Add appropriate classes
+    className = "alert growl show #{params.type} growl-#{params.id}"
+    growl.className = className
+
+    # Add content
+    content = ""
+    content += "<h1>#{params.title}</h1>" if params.title
+    content += "<p>#{params.text}</p>" if params.text
+    growl.innerHTML = content
+
+    # Append child to container
+    k$.$('.growl_container').appendChild growl
+
+    delay = params.delay
+    id = params.id
+
+    if delay > 0
+      do (delay, id) ->
+        setTimeout ->
+          $growl = k$.$(".growl-#{id}")
+          $growl.classList.remove('show')
+          $newGrowl = $growl.cloneNode true
+          $growl.parentNode.replaceChild $newGrowl, $growl
+          $newGrowl.classList.add('hide')
+
+          do (delay, id) ->
+            setTimeout ->
+              # Remove ghost growls
+              k$.$('.growl_container').parentNode.removeChild k$.$('.growl_container') if not k$.$$('.growl.show').length
+            , 500
+        , delay
+
+k$.growl = growl
+
+module.exports = growl

data/app/assets/javascripts/kickstart_rails/ks.coffee

@@ -0,0 +1,16 @@
+global.k$ = new Object()
+
+k$.$$ = (el) -> document.querySelectorAll el
+k$.$ = (el) -> k$.$$(el)[0]
+k$.debounceTimer = false
+k$.debounceQueue = null
+k$.extend = (destination, source) ->
+  for property of source
+    if source[property] and source[property].constructor and source[property].constructor is Object
+      destination[property] = destination[property] or {}
+      arguments.callee destination[property], source[property]
+    else
+      destination[property] = source[property]
+  destination
+
+module.exports = k$

data/app/assets/javascripts/kickstart_rails/modal.coffee

@@ -0,0 +1,29 @@
+modal = (el) ->
+
+  `var iOS = /(iPad|iPhone|iPod)/g.test( navigator.userAgent )`
+  
+  # Cursor pointer hack if iOS
+  document.body.classList.add 'dismiss-modal' if iOS
+
+  do (el) ->
+
+    $hideModal = ->
+      k$.$(el).style.display = 'none'
+
+    # Allow modal to dismiss when clicked outside
+    document.body.addEventListener 'click', ->
+      $hideModal()
+
+    k$.$(el).addEventListener 'click', (e) ->
+      return e.stopPropagation()
+
+    $closer = k$.$(el).querySelector('a[data-modal-close]')
+    if $closer
+      $closer.addEventListener 'click', ->
+        $hideModal()
+
+  k$.$ el
+
+k$.modal = modal
+
+module.exports = modal

data/app/assets/javascripts/kickstart_rails/navbar-fixer.coffee

@@ -0,0 +1,9 @@
+window.onscroll = ->
+  $marker = k$.$('#marker')
+  $fixedArea = k$.$('.fixed-area')
+  $offset = $marker.getBoundingClientRect().top
+  $isFixed = $fixedArea.classList.contains 'fixed'
+  if $offset < 1
+    $fixedArea.classList.add 'fixed' if not $isFixed
+  else
+    $fixedArea.classList.remove 'fixed' if $isFixed

data/app/assets/javascripts/kickstart_rails/navbar.coffee

@@ -0,0 +1,36 @@
+nav = (el) ->
+
+  try
+    # Wire up menu items
+    $menuItems = k$.$(el).querySelectorAll('ul > li')
+
+    # Prune items that don't contain uls
+    _$menuItems = new Array()
+    for $menuItem in $menuItems
+      if $menuItem.querySelectorAll('ul').length and !$menuItem.querySelectorAll('[role="button"]').length
+        _$menuItems.push $menuItem
+
+    $menuItems = _$menuItems
+    for $menuItem in $menuItems
+
+      # For styling
+      $menuItem.classList.add 'menu-item'
+
+    # Wire up the menu
+    k$.dropdown()
+
+  catch e
+    console.error "Could not instantiate as a nav.", e.message
+
+  $button = k$.$(el).querySelector('.navbar-title button')
+  if $button
+    $button.addEventListener 'click', ->
+      $nav = k$.$(el).querySelector('nav')
+      if $nav.classList.contains 'expand'
+        $nav.classList.remove 'expand'
+      else
+        $nav.classList.add 'expand'
+
+k$.nav = nav
+
+module.exports = nav