docks_app 0.0.1

data/spec/fixtures/languages/stub.json

@@ -0,0 +1,3 @@
+{
+  "foo": "bar"
+}

data/spec/fixtures/languages/stub.yml

@@ -0,0 +1,2 @@
+---
+foo: bar

data/spec/fixtures/parsers/coffeescript_parser_fixture_basic.coffee

@@ -0,0 +1,20 @@
+defaults =
+  #*
+  # Determines what action will be taken on the original footnote markup: `"hide"` (using `display: none;`), `"delete"`, or `"ignore"` (leaves the original content in place). This action will also be taken on any elements containing the footnote if they are now empty.
+  #
+  # @access public
+  # @author Chris Sauve
+  # @since 0.0.1
+  # @returns {String}
+  # @default "hide"
+  actionOriginalFN    : "hide"
+
+  #*
+  # Specifies a function to call on a footnote popover that is being instantiated (before it is added to the DOM). The function will be passed two arguments: `$popover`, which is a jQuery object containing the new popover element, and `$button`, the button that was cblicked to instantiate the popover. This option can be useful for adding additional classes or styling information before a popover appears.
+  #
+  # @access public
+  # @author Chris Sauve
+  # @since 0.0.1
+  # @type {Function}
+  # @default function() {}
+  activateCallback    : () -> return

data/spec/fixtures/parsers/coffeescript_parser_fixture_complex.coffee

@@ -0,0 +1,80 @@
+
+
+#*
+# @pattern Bigfoot
+
+# The best footnote plugin around.
+
+#*
+# Groups the ID and HREF of a superscript/ anchor tag pair in data attributes.
+# This resolves the issue of the href and backlink id being separated between the two elements.
+
+# @param {jQuery} $footnoteAnchors   - Anchors that link to footnotes.
+# @param {Array}  footnoteLinks ([]) - An array on which the new anchors will be pushed.
+
+# @returns {undefined}
+
+cleanFootnoteLinks = ($footnoteAnchors, footnoteLinks = []) ->
+  $parent = undefined
+  $supChild = undefined
+  linkHREF = undefined
+  linkID = undefined
+
+  # Problem: backlink ID might point to containing superscript of the fn link
+  # Solution: Check if there is a superscript and move the href/ ID up to it.
+  # The combined id/ href of the sup/a pair are stored in sup using data attributes
+  $footnoteAnchors.each ->
+    $this = $(this)
+    linkHREF = "#" + ($this.attr("href")).split("#")[1] # just the fragment ID
+    $parent = $this.closest(settings.anchorParentTagsname)
+    $child = $this.find(settings.anchorParentTagsname)
+
+defaults =
+  #*
+  # Determines what action will be taken on the original footnote markup: `"hide"` (using `display: none;`), `"delete"`, or `"ignore"` (leaves the original content in place). This action will also be taken on any elements containing the footnote if they are now empty.
+  #
+  # @access public
+  # @default "hide"
+  actionOriginalFN    : "hide"
+
+  #*
+  # Specifies a function to call on a footnote popover that is being instantiated (before it is added to the DOM). The function will be passed two arguments: `$popover`, which is a jQuery object containing the new popover element, and `$button`, the button that was cblicked to instantiate the popover. This option can be useful for adding additional classes or styling information before a popover appears.
+  #
+  # @default function() {}
+  activateCallback    : () -> return
+
+#*
+# Footnote button/ content initializer (run on doc.ready).
+# Finds the likely footnote links and then uses their target to find the content.
+#
+# @returns {undefined}
+
+footnoteInit = ->
+  # Get all of the possible footnote links
+  footnoteButtonSearchQuery = if settings.scope
+                  "#{settings.scope} a[href*=\"#\"]"
+                else
+                  "a[href*=\"#\"]"
+
+  # Filter down to links that:
+  # - have an HREF referencing a footnote, OR
+  # - have a rel attribute of footnote
+  # - aren't a descendant of a footnote (prevents backlinks)
+  $footnoteAnchors = $(footnoteButtonSearchQuery).filter ->
+    $this = $(this)
+    relAttr = $this.attr "rel"
+    relAttr = "" if relAttr == "null" || !relAttr?
+    "#{$this.attr "href"}#{relAttr}".match(settings.anchorPattern) && $this.closest("[class*=#{settings.footnoteParentClass}]:not(a):not(#{settings.anchorParentTagsname})").length < 1
+
+      #*
+      # Removes any links from the footnote back to the footnote link as these don't make sense when the footnote is shown inline
+      #
+      # @param {String} footnoteHTML - The string version of the new footnote.
+      # @param {String} backlinkID   - The ID of the footnote link (that is to be removed from the footnote HTML).
+      #
+      # @returns {String} - The new HTML string with the relevant links taken out.
+
+      removeBackLinks = (footnoteHTML, backlinkID) ->
+        # First, though, take care of multiple ID's by getting rid of spaces
+        backlinkID = backlinkID.trim().replace(/\s+/g, "|")
+                                      .replace(/(.*)/g, "($1)") if backlinkID.indexOf(' ') >= 0

data/spec/fixtures/parsers/css_parser_fixture_basic.css

@@ -0,0 +1,44 @@
+/**
+
+ * A simple button. Nice.
+
+ * Lorem ipsum dolor sit amet, consectetur adipisicing elit.
+ * Aliquam expedita repellendus magnam similique eum assumenda velit doloribus omnis labore debitis. Molestiae debitis soluta earum minima maxime inventore aperiam, et omnis.
+
+*/
+
+.button {
+  cursor: pointer;
+  display: inline-block;
+  height: 32px;
+  line-height: 30px;
+}
+
+.button:hover,
+.button:focus {
+  background: #efefef; /* slightly different on hover/ focus */
+}
+
+
+/**
+ * A button that is indicating the loading of content.
+ *
+ * @demo_type joint
+ * @set_by :loading?
+ */
+
+.button--is-loading {
+}
+
+/* Don't do this for disabled buttons */
+.button--is-loading:not(.button--is-disabled) {
+  color: transparent;
+  cursor: default;
+  background-repeat: no-repeat;
+  background-position: center center;
+}
+
+.button--is-loading:not(.button--is-disabled):hover,
+.button--is-loading:not(.button--is-disabled):focus {
+  background-color: #fcfcfc;
+}

data/spec/fixtures/parsers/css_parser_fixture_complex.css

@@ -0,0 +1,120 @@
+/**
+ *
+ * @pattern Buttons
+ * @tagline Those sweet, sweet clicks.
+ * @since 1.0
+ */
+
+/**
+ * A simple button. Nice.
+ *
+ * Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aliquam expedita repellendus magnam similique eum assumenda velit doloribus omnis labore debitis. Molestiae debitis soluta earum minima maxime inventore aperiam, et omnis.
+ *
+ * @variant --primary           (demo type: joint, set by: :primary?)
+ * @variant --destroy           (demo type: joint, set by: :destroy?) - This button indicates that you want to remove something.
+ * @variant --destroy-no-hover  (demo type: joint)
+ * @variant --icon              (demo type: hidden)
+ * @variant --large             (demo type: select, set by: :size (SIZE_LARGE)) - A much larger button for special situations.
+ * @variant --plain             (demo type: select, precludes: --is-disabled, set by: :plain?)
+ */
+
+.button {
+  cursor: pointer;
+  display: inline-block;
+  height: 32px;
+  line-height: 30px;
+}
+
+/**
+ * A button that is indicating the loading of content.
+ *
+ * @demo_type joint
+ * @set_by :loading? */
+
+.button--is-loading {
+  /* Don't do this for disabled buttons */
+  color: transparent;
+  cursor: default;
+  background-repeat: no-repeat;
+  background-position: center center;
+}
+
+/**
+ * @precludes .button--large
+ * @demo_type select
+ * @set_by NextButton#resize, :size (SIZE_SLIM)
+ */
+
+.button--slim {
+  height: 28px;
+  line-height: 26px;
+}
+
+.button--plain {
+  background: transparent;
+  border: none;
+}
+
+/**
+ * A button that can't be activated. In order for this button to
+ * function correctly, both the class and the disabled attribute
+ * must be placed on the button.
+
+ * For example, the following will produce a button that *looks* disabled,
+ * but that is still clickable:
+
+ * ```html
+ * <button class="button button--is-disabled">Not really disabled button</button>
+ * ```
+
+ * But this one creates an appropriately unclickable button:
+
+ * ```html_demo
+ * <button class="button button--is-disabled" disabled="disabled">Really disabled!</button>
+ * ```
+
+ * @demo_type select
+ * @javascript_action $(this).addClass('button--is-disabled').attr('disabled', true)
+ * @set_by :disabled?
+ * @precludes button--is-loading
+ */
+
+.button--is-disabled,
+.button--is-disabled:hover,
+.button--is-disabled:focus {
+  color: #999;
+  border-color: #e3e3e3;
+  background: #fcfcfc;
+}
+
+
+
+/**
+ * Two or more buttons that control the same function.
+
+ * @title Segmented Button Group
+ * @demo_type own
+ */
+
+.button__segmented-group {
+  display: flex;
+}
+
+/* Adjusts details for buttons that are part of the
+   button group. */
+
+.button__segmented-group .button {
+  display: block;
+  flex: 0 1 auto;
+  margin: 0;
+}
+
+
+/* A segmented group that spans the entire container.
+   @demo_type select */
+
+.button__segmented-group--full-width {
+  .button {
+    flex: 1 1 auto;
+  }
+}

data/spec/fixtures/parsers/javascript_parser_fixture_basic.js

@@ -0,0 +1,27 @@
+var defaults = {
+  //*
+  // Determines what action will be taken on the original footnote markup: `"hide"` (using `display: none;`), `"delete"`, or `"ignore"` (leaves the original content in place). This action will also be taken on any elements containing the footnote if they are now empty.
+  //
+  // @access public
+  // @author Chris Sauve
+  // @since 0.0.1
+  // @returns {String}
+  // @default "hide"
+  actionOriginalFN: "hide",
+
+  /**
+   * Specifies a function to call on a footnote popover that is being instantiated
+   * (before it is added to the DOM). The function will be passed two arguments:
+   * `$popover`, which is a jQuery object containing the new popover element, and
+   * `$button`, the button that was cblicked to instantiate the popover. This
+   * option can be useful for adding additional classes or styling information
+   * before a popover appears.
+   *
+   * @access public
+   * @author Chris Sauve
+   * @since 0.0.1
+   * @type {Function}
+   * @default function() {}
+   */
+  activateCallback: function() {}
+};

data/spec/fixtures/parsers/javascript_parser_fixture_complex.js

@@ -0,0 +1,85 @@
+
+//*
+// @pattern Bigfoot
+
+// The best footnote plugin around.
+
+//*
+// Groups the ID and HREF of a superscript/ anchor tag pair in data attributes.
+// This resolves the issue of the href and backlink id being separated between the two elements.
+
+// @param {jQuery} $footnoteAnchors   - Anchors that link to footnotes.
+// @param {Array}  footnoteLinks ([]) - An array on which the new anchors will be pushed.
+
+// @returns {undefined}
+
+function cleanFootnoteLinks($footnoteAnchors, footnoteLinks) {
+  $parent = undefined;
+  $supChild = undefined;
+  linkHREF = undefined;
+  linkID = undefined;
+
+  // Problem: backlink ID might point to containing superscript of the fn link
+  // Solution: Check if there is a superscript and move the href/ ID up to it.
+  // The combined id/ href of the sup/a pair are stored in sup using data attributes
+  $footnoteAnchors.each(function() {
+    $this = $(this);
+    linkHREF = "#" + ($this.attr("href")).split("#")[1]; // just the fragment ID
+    $parent = $this.closest(settings.anchorParentTagsname);
+    $child = $this.find(settings.anchorParentTagsname);
+  });
+};
+
+defaults = {
+  //*
+  // Determines what action will be taken on the original footnote markup: `"hide"` (using `display: none;`), `"delete"`, or `"ignore"` (leaves the original content in place). This action will also be taken on any elements containing the footnote if they are now empty.
+  //
+  // @access public
+  // @default "hide"
+  actionOriginalFN: "hide",
+
+  //*
+  // Specifies a function to call on a footnote popover that is being instantiated (before it is added to the DOM). The function will be passed two arguments: `$popover`, which is a jQuery object containing the new popover element, and `$button`, the button that was cblicked to instantiate the popover. This option can be useful for adding additional classes or styling information before a popover appears.
+  //
+  // @default function() {}
+  activateCallback: function() {}
+};
+
+//*
+// Footnote button/ content initializer (run on doc.ready).
+// Finds the likely footnote links and then uses their target to find the content.
+//
+// @returns {undefined}
+
+function footnoteInit() {
+  // Get all of the possible footnote links
+  footnoteButtonSearchQuery = settings.scope ? "#{settings.scope} a[href*=\"#\"]" : "a[href*=\"#\"]";
+
+  // Filter down to links that:
+  // - have an HREF referencing a footnote, OR
+  // - have a rel attribute of footnote
+  // - aren't a descendant of a footnote (prevents backlinks)
+  $footnoteAnchors = $(footnoteButtonSearchQuery).filter(function() {
+    $this = $(this);
+    relAttr = $this.attr("rel");
+    if(relAttr == "null" || !relAttr) { relAttr = "" }
+
+    ("" + $this.attr("href") + relAttr).match(settings.anchorPattern) && $this.closest("[class*=" + settings.footnoteParentClass + "]:not(a):not(" + settings.anchorParentTagsname + ")").length < 1
+
+    //*
+    // Removes any links from the footnote back to the footnote link as these don't make sense when the footnote is shown inline
+    //
+    // @param {String} footnoteHTML - The string version of the new footnote.
+    // @param {String} backlinkID   - The ID of the footnote link (that is to be removed from the footnote HTML).
+    //
+    // @returns {String} - The new HTML string with the relevant links taken out.
+
+    function removeBackLinks(footnoteHTML, backlinkID) {
+      // First, though, take care of multiple ID's by getting rid of spaces
+      if(backlinkID.indexOf(" ") >= 0) {
+        backlinkID = backlinkID.trim().replace(/\s+/g, "|")
+                                      .replace(/(.*)/g, "($1)");
+      }
+    }
+  });
+}

data/spec/fixtures/parsers/sass_parser_fixture_basic.scss

@@ -0,0 +1,39 @@
+//*
+// A simple button. Nice.
+//
+// Lorem ipsum dolor sit amet, consectetur adipisicing elit.
+// Aliquam expedita repellendus magnam similique eum assumenda velit doloribus omnis labore debitis.
+// Molestiae debitis soluta earum minima maxime inventore aperiam, et omnis.
+
+.button {
+  cursor: pointer;
+  display: inline-block;
+  height: 32px;
+  line-height: 30px;
+
+  &:hover,
+  &:focus {
+    background: #efefef; // slightly different on hover/ focus
+  }
+
+  //*
+  // A button that is indicating the loading of content.
+  //
+  // @demo_type joint
+  // @set_by :loading?
+
+  &.button--is-loading {
+    // Don't do this for disabled buttons
+    &:not(.button--is-disabled) {
+      color: transparent;
+      cursor: default;
+      background-repeat: no-repeat;
+      background-position: center center;
+
+      &:hover,
+      &:focus {
+        background-color: #fcfcfc;
+      }
+    }
+  }
+}

data/spec/fixtures/parsers/sass_parser_fixture_complex.scss

@@ -0,0 +1,149 @@
+//*
+// @pattern Buttons
+// @tagline Those sweet, sweet clicks.
+// @since 1.0
+
+.foo {}
+
+/**
+ * A simple button. Nice.
+ *
+ * Lorem ipsum dolor sit amet, consectetur adipisicing elit. Aliquam expedita repellendus magnam similique eum assumenda velit doloribus omnis labore debitis. Molestiae debitis soluta earum minima maxime inventore aperiam, et omnis.
+ *
+ * @variant --primary           (demo type: joint, set by: :primary?)
+ * @variant --destroy           (demo type: joint, set by: :destroy?) - This button indicates that you want to remove something.
+ * @variant --destroy-no-hover  (demo type: joint)
+ * @variant --icon              (demo type: hidden)
+ * @variant --large             (demo type: select, set by: :size (SIZE_LARGE)) - A much larger button for special situations.
+ * @variant --plain             (demo type: select, precludes: --is-disabled, set by: :plain?)
+ */
+
+.button {
+  cursor: pointer;
+  display: inline-block;
+  height: 32px;
+  line-height: 30px;
+
+  &:hover,
+  &:focus {
+    background: #efefef; // slightly different on hover/ focus
+  }
+
+  //*
+  // A button that is indicating the loading of content.
+  //
+  // @demo_type joint
+  // @set_by :loading?
+
+  &.button--is-loading {
+    // Don't do this for disabled buttons
+    &:not(.button--is-disabled) {
+      color: transparent;
+      cursor: default;
+      background-repeat: no-repeat;
+      background-position: center center;
+
+      &:hover,
+      &:focus {
+        background-color: #fcfcfc;
+      }
+    }
+  }
+}
+
+//*
+// @precludes .button--large
+// @demo_type select
+// @set_by NextButton#resize, :size (SIZE_SLIM)
+
+.button--slim {
+  height: 28px;
+  line-height: 26px;
+}
+
+.button--plain {
+  background: transparent;
+  border: none;
+}
+
+//*
+// A button that can't be activated. In order for this button to
+// function correctly, both the class and the disabled attribute
+// must be placed on the button.
+
+// For example, the following will produce a button that *looks* disabled,
+// but that is still clickable:
+
+// ```html
+// <button class="button button--is-disabled">Not really disabled button</button>
+// ```
+
+// But this one creates an appropriately unclickable button:
+
+// ```html_demo
+// <button class="button button--is-disabled" disabled="disabled">Really disabled!</button>
+// ```
+
+// @demo_type select
+// @javascript_action $(this).addClass('button--is-disabled').attr('disabled', true)
+// @set_by :disabled?
+// @precludes button--is-loading
+
+.button--is-disabled {
+  &,
+  &:hover,
+  &:focus {
+    color: #999;
+    border-color: #e3e3e3;
+    background: #fcfcfc;
+  }
+}
+
+
+
+//*
+// Two or more buttons that control the same function.
+
+// @title Segmented Button Group
+// @demo_type own
+
+.button__segmented-group {
+  display: flex;
+
+  .button {
+    display: block;
+    flex: 0 1 auto;
+    margin: 0;
+
+    // Adjusts details for buttons that are part of the
+    // button group.
+    &:not(:first-of-type) {
+      margin-left: -1px;
+    }
+
+    &:first-of-type {
+      border-top-right-radius: 0;
+      border-bottom-right-radius: 0;
+    }
+
+    &:last-of-type {
+      border-top-left-radius: 0;
+      border-bottom-left-radius: 0;
+    }
+
+    &:not(:last-of-type):not(:first-of-type) {
+      border-radius: 0;
+    }
+  }
+}
+
+
+// A segmented group that spans the entire container.
+
+// @demo_type select
+
+.button__segmented-group--full-width {
+  .button {
+    flex: 1 1 auto;
+  }
+}

data/spec/fixtures/parsers/stylus_parser_fixture_basic.styl

@@ -0,0 +1,34 @@
+//*
+// A simple button. Nice.
+//
+// Lorem ipsum dolor sit amet, consectetur adipisicing elit.
+// Aliquam expedita repellendus magnam similique eum assumenda velit doloribus omnis labore debitis.
+// Molestiae debitis soluta earum minima maxime inventore aperiam, et omnis.
+
+.button
+  cursor: pointer
+  display: inline-block
+  height: 32px
+  line-height: 30px
+
+  &:hover,
+  &:focus
+    background: #efefef // slightly different on hover/ focus
+
+  //*
+  // A button that is indicating the loading of content.
+  //
+  // @demo_type joint
+  // @set_by :loading?
+
+  &.button--is-loading
+    // Don't do this for disabled buttons
+    &:not(.button--is-disabled)
+      color: transparent
+      cursor: default
+      background-repeat: no-repeat
+      background-position: center center
+
+      &:hover,
+      &:focus
+        background-color: #fcfcfc