Repository: coffeedoc/codo Branch: master Commit: a02771cbf23a Files: 165 Total size: 594.0 KB Directory structure: gitextract_nbr74owg/ ├── .codoopts ├── .gitignore ├── .travis.yml ├── Gruntfile.coffee ├── LICENSE.md ├── README.md ├── bin/ │ └── codo ├── lib/ │ ├── _entities.coffee │ ├── _meta.coffee │ ├── _tools.coffee │ ├── codo.coffee │ ├── command.coffee │ ├── documentation.coffee │ ├── entities/ │ │ ├── class.coffee │ │ ├── extra.coffee │ │ ├── file.coffee │ │ ├── method.coffee │ │ ├── mixin.coffee │ │ ├── property.coffee │ │ └── variable.coffee │ ├── entity.coffee │ ├── environment.coffee │ ├── meta/ │ │ ├── method.coffee │ │ └── parameter.coffee │ ├── tools/ │ │ ├── markdown.coffee │ │ └── referencer.coffee │ └── traverser.coffee ├── package.json ├── spec/ │ ├── _templates/ │ │ ├── angular/ │ │ │ ├── angular-with-new.coffee │ │ │ ├── angular-with-new.json │ │ │ ├── angular.coffee │ │ │ └── angular.json │ │ ├── classes/ │ │ │ ├── class_description_markdown.coffee │ │ │ ├── class_description_markdown.json │ │ │ ├── class_documentation.coffee │ │ │ ├── class_documentation.json │ │ │ ├── class_extends.coffee │ │ │ ├── class_extends.json │ │ │ ├── empty_class.coffee │ │ │ ├── empty_class.json │ │ │ ├── export_class.coffee │ │ │ ├── export_class.json │ │ │ ├── global_class.coffee │ │ │ ├── global_class.json │ │ │ ├── inner_class.coffee │ │ │ ├── inner_class.json │ │ │ ├── namespaced_class.coffee │ │ │ ├── namespaced_class.json │ │ │ ├── simple_class.coffee │ │ │ └── simple_class.json │ │ ├── complicateds/ │ │ │ ├── methods.coffee │ │ │ └── variables.coffee │ │ ├── environment/ │ │ │ ├── class.coffee │ │ │ ├── mixin.coffee │ │ │ └── result.json │ │ ├── example/ │ │ │ ├── CHANGELOG │ │ │ ├── README.md │ │ │ ├── package.json │ │ │ └── src/ │ │ │ ├── angry_animal.coffee │ │ │ ├── animal.coffee │ │ │ ├── lion.coffee │ │ │ ├── over_documented_class.coffee │ │ │ └── over_documented_mixin.coffee │ │ ├── extras/ │ │ │ ├── README │ │ │ └── README.md │ │ ├── files/ │ │ │ ├── non_class_file.coffee │ │ │ └── non_class_file.json │ │ ├── methods/ │ │ │ ├── assigned_parameters.coffee │ │ │ ├── assigned_parameters.json │ │ │ ├── class_methods.coffee │ │ │ ├── class_methods.json │ │ │ ├── curly_method_documentation.coffee │ │ │ ├── curly_method_documentation.json │ │ │ ├── dynamic_methods.coffee │ │ │ ├── dynamic_methods.json │ │ │ ├── instance_methods.coffee │ │ │ ├── instance_methods.json │ │ │ ├── method_documentation.coffee │ │ │ ├── method_documentation.json │ │ │ ├── method_events.coffee │ │ │ ├── method_events.json │ │ │ ├── method_example.coffee │ │ │ ├── method_example.json │ │ │ ├── named_parameters.coffee │ │ │ ├── named_parameters.json │ │ │ ├── overload_method.coffee │ │ │ └── overload_method.json │ │ ├── mixins/ │ │ │ ├── concern.coffee │ │ │ ├── concern.json │ │ │ ├── extend_mixin.coffee │ │ │ ├── extend_mixin.json │ │ │ ├── include_mixin.coffee │ │ │ ├── include_mixin.json │ │ │ ├── missing_mixins.coffee │ │ │ ├── missing_mixins.json │ │ │ ├── mixin_documentation.coffee │ │ │ ├── mixin_documentation.json │ │ │ ├── mixin_methods.coffee │ │ │ └── mixin_methods.json │ │ ├── properties/ │ │ │ ├── properties.coffee │ │ │ └── properties.json │ │ └── variables/ │ │ ├── class_variables.coffee │ │ ├── class_variables.json │ │ ├── constant_variables.coffee │ │ ├── constant_variables.json │ │ ├── instance_variables.coffee │ │ └── instance_variables.json │ ├── lib/ │ │ ├── api_spec.coffee │ │ ├── codo_spec.coffee │ │ ├── entities/ │ │ │ ├── class_spec.coffee │ │ │ └── mixin_spec.coffee │ │ ├── environment_spec.coffee │ │ ├── meta/ │ │ │ ├── method_spec.coffee │ │ │ └── parameter_spec.coffee │ │ └── tools/ │ │ └── markdown_spec.coffee │ └── themes/ │ └── default/ │ └── lib/ │ ├── templater_spec.coffee │ ├── theme_spec.coffee │ └── tree_builder_spec.coffee └── themes/ └── default/ ├── assets/ │ ├── javascript/ │ │ ├── application.js │ │ ├── codo.coffee │ │ ├── frames.coffee │ │ ├── fuzzy.coffee │ │ ├── keys.coffee │ │ ├── sidebar.coffee │ │ ├── toc.coffee │ │ └── vendor/ │ │ ├── fuzzy.coffee │ │ ├── highlight.coffeescript.js │ │ ├── highlight.js │ │ ├── jquery.js │ │ ├── keymaster.js │ │ └── underscore.js │ └── stylesheets/ │ ├── alphabetical_index.styl │ ├── application.styl │ ├── base.styl │ ├── class.styl │ ├── footer.styl │ ├── header.styl │ ├── lists.styl │ ├── toc.styl │ └── vendor/ │ └── highlight.css ├── lib/ │ ├── _theme.coffee │ ├── templater.coffee │ ├── theme.coffee │ └── tree_builder.coffee └── templates/ ├── alphabetical_index.hamlc ├── class.hamlc ├── class_list.hamlc ├── extra.hamlc ├── extra_list.hamlc ├── file.hamlc ├── file_list.hamlc ├── frames.hamlc ├── layout/ │ ├── footer.hamlc │ ├── header.hamlc │ └── intro.hamlc ├── method_list.hamlc ├── mixin.hamlc ├── mixin_list.hamlc └── partials/ ├── documentation.hamlc ├── list_nav.hamlc ├── method_list.hamlc ├── method_signature.hamlc ├── method_summary.hamlc ├── type_link.hamlc └── variable_list.hamlc ================================================ FILE CONTENTS ================================================ ================================================ FILE: .codoopts ================================================ --title "Codo Documentation" lib/ themes/ ================================================ FILE: .gitignore ================================================ .DS_Store node_modules .bundle .idea doc npm-debug.log ================================================ FILE: .travis.yml ================================================ language: node_js branches: only: - master - 1.x notifications: recipients: - michi@netzpiraten.ch - boris@staal.io ================================================ FILE: Gruntfile.coffee ================================================ module.exports = (grunt) -> grunt.loadNpmTasks 'grunt-release' grunt.initConfig release: options: bump: false add: false commit: false push: false ================================================ FILE: LICENSE.md ================================================ # MIT License Copyright (c) 2012-2013 Michael Kessler, Boris Staal Template components are derivative works of YARD (http://yardoc.org) Copyright (c) Loren Segal and licensed under the MIT license Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ================================================ FILE: README.md ================================================ # Codo [![Build Status](https://secure.travis-ci.org/coffeedoc/codo.png)](https://travis-ci.org/coffeedoc/codo) Codo is a [CoffeeScript](http://coffeescript.org/) API documentation generator, similar to [YARD](http://yardoc.org/). Its generated documentation is focused on CoffeeScript class syntax for classical inheritance. ## Features * Detects classes, methods, constants, mixins & concerns. * Many tags to add semantics to your code. * Generates a nice site to browse your code documentation in various ways. * Can be used to assure minimum documentation * ~~Documentation generation and hosting as a service on [CoffeeDoc.info](http://coffeedoc.info)~~ (we no longer have the access to domain and the service is currently inaccessible) ## Codo in action Annotate your source with Codo tags to add semantic information to your code. It looks like this: ```CoffeeScript # Base class for all animals. # # @example How to subclass an animal # class Lion extends Animal # move: (direction, speed): -> # class Example.Animal # The Answer to the Ultimate Question of Life, the Universe, and Everything @ANSWER = 42 # Construct a new animal. # # @param [String] name the name of the animal # @param [Date] birthDate when the animal was born # constructor: (@name, @birthDate = new Date()) -> # Move the animal. # # @example Move an animal # new Lion('Simba').move(direction: 'south', speed: 12) # # @param [Object] options the moving options # @option options [String] direction the moving direction # @option options [Number] speed the speed in mph # move: (options = {}) -> ``` Then generate the documentation with the `codo` command line tool. You can browse some generated Codo documentation on [CoffeeDoc.info](http://coffeedoc.info) to get a feeling how you can navigate in various ways through your code layers. In the `Example` namespace you'll find some classes and mixins that makes absolutely no sense, its purpose is only to show the many features Codo offers. ## Installation Codo is available in NPM and can be installed with: ```bash $ npm install -g codo ``` Please have a look at the [CHANGELOG](https://github.com/coffeedoc/codo/releases) when upgrading to a newer Codo version with `npm update`. ## Tags You have to annotate your code with Codo tags to give it some meaning to the parser that generates the documentation. Each tag starts with the `@` sign followed by the tag name. See the following overview for a minimal description of all available tags. Most tags are self-explaining and the one that aren't are described afterwards in more detail. Tags can take multiple lines, just indent subsequent lines by two spaces. ### Overview The following table shows the list of all available tags in alphabetical order with its expected options. An option in parenthesis is optional and the square brackets are part of the Codo tag format and must actually be written. Some tags can be defined multiple times and they can be applied to different contexts, either in the comment for a class, a comment for a mixin or in a method comment.
Tag format Multiple occurrences Classes Mixins Methods
@namespace namespace ✔ ✔
@abstract (message) ✔ ✔ ✔
@author name ✔ ✔ ✔ ✔
@concern mixin ✔ ✔
@copyright name ✔ ✔ ✔
@deprecated ✔ ✔ ✔
@example (title)
  Code		 ✔ ✔ ✔ ✔
@extend mixin ✔ ✔
@include mixin ✔ ✔
@note message ✔ ✔ ✔ ✔
@method signature
  Method tags		 ✔ ✔
@mixin ✔
@option option [type] name description ✔ ✔
@event name [description]
  Event tags		 ✔ ✔ ✔
@overload signature
  Method tags		 ✔ ✔
@param [type] name description
@param name [type] description
 ✔ ✔
@private ✔ ✔ ✔
@property [type] description ✔
@public ✔ ✔
@return [type] description ✔
@see link/reference ✔ ✔ ✔ ✔
@since version ✔ ✔ ✔
@throw message ✔ ✔
@todo message ✔ ✔ ✔ ✔
@version version ✔ ✔ ✔
@nodoc ✔ ✔ ✔
### Alternative syntax You can also use curly braces instead of square brackets if you prefer: ```CoffeeScript # Move the animal. # # @example Move an animal # new Lion('Simba').move('south', 12) # # @param {Object} options the moving options # @option options {String} direction the moving direction # @option options {Number} speed the speed in mph # move: (options = {}) -> ``` It's also possible to use [CoffeeScript block comments](http://coffeescript.org/#strings) instead of the normal comments. If you solely use block comments, you may want to use the `--cautious` flag to disable the internal comment conversion. ```CoffeeScript ### Move the animal. @example Move an animal new Lion('Simba').move('south', 12) @param [Object] options the moving options @option options [String] direction the moving direction @option options [Number] speed the speed in mph ### move: (options = {}) -> ``` If you want to compile your JavaScript with Google Closure and make use of the special block comments with an asterisk, you want to use the `--closure` flag so that Codo ignores the asterisk. ### Parameters There are two different format recognized for your parameters, so you can chose your favorite. This one is with the parameter after the parameter type: ```CoffeeScript # Feed the animal # # @param [World.Food] food the food to eat # @param [Object] options the feeding options # @option options [String] time the time to feed # feed: (food) -> ``` And this one with the name before the type: ```CoffeeScript # Feed the animal # # @param food [World.Food] the food to eat # @param options [Object] the feeding options # @option options time [String] the time to feed # feed: (food) -> ``` The parameter type can contain multiple comma separated types: ```CoffeeScript # Feed the animal # # @param [String, Char] input # @return [Integer, Float] output # do: (input) -> ``` Each known type will be automatically linked. Also named parameters are recognized: ```CoffeeScript class Classmate # @param {string} name Full name (first + last) # @param {string} phone Phone number # @param {obj} picture JPG of the person constructor: ( {@name, @phone, picture} ) -> # @param {string} reason Why I'm no longer friends # @param {Date} revisit_decision_on When to reconsider unfriend: ( {reason, revisit_decision_on} ) -> ``` ### Options If you have an object as parameter and you like to define the accepted properties as options to the method, you can use the `@options` tag: ```CoffeeScript # Feed the animal # # @param [Object] options the calculation options # @option options [Integer] age the age of the animal # @option options [Integer] weight the weight of the animal # expectationOfLife: (options) -> ``` The first parameter to the option tag is the parameter name it describes, followed by the parameter type, name and description. ### Types The object types for the `@param`, `@option` and `@return` tags are parsed for known classes or mixins and linked. You can also define types for Arrays with: ```CoffeeScript # # @param [World.Region] region the region of the herd # @return [Array] the animals in the herd # getHerdMembers: (regions) -> ``` ### Properties You can mark an instance variable as property of the class by using the `@property` tag like: ```CoffeeScript class Person # @property [Array] the nicknames nicknames: [] ``` In addition, the following properties pattern is detected: ```CoffeeScript class Person get = (props) => @::__defineGetter__ name, getter for name, getter of props set = (props) => @::__defineSetter__ name, setter for name, setter of props # @property [String] The person name get name: -> @_name set name: (@_name) -> # The persons age get age: -> @_age ``` If you follow this convention, they will be shown in the generated documentation with its read/write status shown. To specify type of the property, use the `@property` tag. ### Method overloading If you allow your method to take different parameters, you can describe the method overloading with the `@overload` tag: ```CoffeeScript # This is a generic Store set method. # # @overload set(key, value) # Sets a value on key # @param [Symbol] key describe key param # @param [Object] value describe value param # # @overload set(value) # Sets a value on the default key `:foo` # @param [Object] value describe value param # @return [Boolean] true when success # set: (args...) -> ``` The `@overload` tag must be followed by the alternative method signature that will appear in the documentation, followed by any method tag indented by two spaces. ### Virtual methods If you copy over functions from other objects without using mixins or concerns, you can add documentation for this virtual (or dynamic) method with the `@method` tag: ```CoffeeScript # This class has a virtual method, that doesn't # exist in the source but appears in the documentation. # # @method #set(key, value) # Sets a value on key # @param [Symbol] key describe key param # @param [Object] value describe value param # class VirtualMethods ``` The `@method` tag must be followed by the method signature that will appear in the documentation, followed by any method tag indented by two spaces. The difference to the `@overload` tag beside the different context is that the signature should contain either the instance prefix `#` or the class prefix `.`. ### Mixins It's common practice to mix in objects to share common logic when inheritance is not suited. You can read more about mixins in the [The Little Book on CoffeeScript](http://arcturo.github.io/library/coffeescript/03_classes.html). Simply mark any plain CoffeeScript object with the `@mixin` tag to have a mixin page generated that supports many tags: ```CoffeeScript # Speed calculation for animal. # # @mixin # @author Rockstar Ninja # Example.Animal.Speed = # Get the distance the animal will put back in a certain time. # # @param [Integer] time Number of seconds # @return [Integer] The distance in miles # distance: (time) -> ``` Next mark the target object that includes one or multiple mixins: ```CoffeeScript # @include Example.Animal.Speed class Example.Animal.Lion ``` and you'll see the mixin methods appear as instance methods in the lion class documentation. You can also extend a mixin: ```CoffeeScript # @extend Example.Animal.Speed class Example.Animal.Lion ``` so its methods will show up as class methods. #### Concerns A concern is a combination of two mixins, one for instance methods and the other for class methods and it's automatically detected when a mixin has both a `ClassMethods` and an `InstanceMethods` property: ```CoffeeScript # Speed calculations for animal. # # @mixin # @author Rockstar Ninja # Example.Animal.Speed = InstanceMethods: # Get the distance the animal will put back in a certain time. # # @param [Integer] time Number of seconds # @return [Integer] The distance in miles # distance: (time) -> ClassMethods: # Get the common speed of the animal in MPH. # # @param [Integer] age The age of the animal # @return [Integer] The speed in MPH # speed: (age) -> ``` You can use `@concern` to include and extend the correspondent properties: ```CoffeeScript # @concern Example.Animal.Speed class Example.Animal.Lion ``` ### Non-class methods and variables You can also document your non-class, top level functions and constants within a file. As soon Codo detects these types within a file, it will be added to the file list and you can browse your file methods and constants. ## Text processing ### GitHub Flavored Markdown Codo class, mixin and method documentation and extra files written in [Markdown](http://daringfireball.net/projects/markdown/) syntax are rendered as full [GitHub Flavored Markdown](https://github.github.com/github-flavored-markdown/). The `@return`, `@param`, `@option`, `@see`, `@author`, `@copyright`, `@note`, `@todo`, `@since`, `@version` and `@deprecated` tags rendered with a limited Markdown syntax, which means that only inline elements will be returned. ### Automatically link references Codo comments and all tag texts will be parsed for references to other classes, methods and mixins, and are automatically linked. The reference searching will not take place within code blocks, thus you can avoid reference searching errors by surround your code block that contains curly braces with backticks. There are several ways of link types supported and all can take an optional label after the link. * Normal URL links: `{http://coffeescript.org/}` or `{http://coffeescript.org/ Try CoffeeScript}` * Link to a class or mixin: `{Animal.Lion}` or `{Animal.Lion The mighty lion}` * Direct link to an instance method: `{Animal.Lion#walk}` or `{Animal.Lion#walk The lion walks}` * Direct link to a class method: `{Animal.Lion.constructor}` or `{Animal.Lion.constructor A new king was born}` * Direct link to a module method: `{MyModule~method}` or `{MyModule~method ZOMG I can even refer modules!}` The `@see` tag supports the same link types, just without the curly braces: ```CoffeeScript @see https://en.wikipedia.org/wiki/Lion The wikipedia page about lions ``` ## Generate After the installation you will have a `codo` binary that can be used to generate the documentation recursively for all CoffeeScript files within a directory. ```bash $ codo --help Usage: codo [options] [source_files [- extra_files]] Options: --help, -h Show this help --version Show version --extension, -x Coffee files extension [default: "coffee"] --output, -o The output directory [default: "./doc"] --min-coverage, -m Require a minimum percentage to be documented or fail [default: 0] --test, -t Do not create any output files. Use with min-coverage [default: 0] --theme The theme to be used [default: "default"] --name, -n The project name used --readme, -r The readme file used --quiet, -q Supress warnings [default: false] --verbose, -v Show parsing errors [default: false] --undocumented, -u List undocumented objects [default: false] --closure Try to parse closure-like block comments [default: false] --private, -p Show privates [default: false] --analytics, -a The Google analytics ID [default: false] --title, -t HTML Title [default: "Codo Documentation"] ``` Codo wants to be smart and tries to detect the best default settings for the sources, the readme, the extra files and the project name, so the above defaults may be different on your project. ### Project defaults You can define your project defaults by writing your command line options to a `.codoopts` file: ```bash --name "Codo" --readme README.md --title "Codo Documentation" --private --quiet --extension coffee --output ./doc ./src - LICENSE CHANGELOG.md ``` Put each option flag on a separate line, followed by the source directories or files, and optionally any extra file that should be included into the documentation separated by a dash (`-`). If your extra file has the extension `.md`, it'll be rendered as Markdown. ### API usage If you want to use codo in your build tool, you can require `codo/lib/command.coffee`: ```coffeescript CodoCLI = require 'codo/lib/command.coffee' codoCLI = new CodoCLI() codoCLI.generate "path/to/base/dir", options, (exitCode) -> process.exit exitCode ``` `option` is an object with options as above. Please note that they are *not* CamelCase (e.g. `min-coverage` instead of `minCoverage`). Furthermore only global defaults will be used, project defaults are ignored if Codo is used via API. ## Keyboard navigation You can quickly search and jump through the documentation by using the fuzzy finder dialog: * Open fuzzy finder dialog: `T` In frame mode you can toggle the list naviation frame on the left side: * Toggle list view: `L` You can focus a list in frame mode or toggle a tab in frameless mode: * Class list: `C` * Mixin list: `I` * File list: `F` * Method list: `M` * Extras list: `E` You can focus and blur the search input: * Focus search input: `S` * Blur search input: `Esc` In frameless mode you can close the list tab: * Close list tab: `Esc` ## Report issues Issues hosted at [GitHub Issues](https://github.com/coffeedoc/codo/issues). The Codo specs are template based, so make sure you provide a code snippet that can be added as failing spec to the project when reporting an issue with parsing your CoffeeScript code. The other thing that might be useful is the actual exception happening (run with `-d`). ## Development Source hosted at [GitHub](https://github.com/coffeedoc/codo). Pull requests are very welcome! Please try to follow these simple rules if applicable: * Please create a topic branch for every separate change you make. * Make sure your patches are well tested. * Update the documentation. * Update the README. * Update the CHANGELOG for noteworthy changes. * Please **do not change** the version number. ## Alternatives * [Docco](http://jashkenas.github.io/docco/) is a quick-and-dirty, literate-programming-style documentation generator. * [CoffeeDoc](https://github.com/omarkhan/coffeedoc) an alternative API documentation generator for CoffeeScript. * [JsDoc](https://github.com/micmath/jsdoc) an automatic documentation generator for JavaScript. * [Dox](https://github.com/tj/dox) JavaScript documentation generator for node using markdown and jsdoc. ## Core Team * [Boris Staal](https://github.com/inossidabile) ([@_inossidabile](http://twitter.com/#!/_inossidabile)) * [Michael Kessler](https://github.com/netzpirat) ([@netzpirat](http://twitter.com/#!/netzpirat), [FlinkFinger](http://www.blackbeans.ch)) ## Acknowledgment - [Jeremy Ashkenas](https://github.com/jashkenas) for [CoffeeScript](http://coffeescript.org/), that mighty language that compiles to JavaScript and makes me enjoy JavaScript development. - [Loren Segal](https://github.com/lsegal) for creating YARD and giving me the perfect documentation syntax for dynamic programming languages. - [Stratus Editor](https://github.com/stratuseditor) for open sourcing their [fuzzy filter](https://github.com/stratuseditor/fuzzy-filter). ## License (The MIT License) Copyright (c) 2012-2016 Michael Kessler, Boris Staal Template components are derivative works of YARD (http://yardoc.org) Copyright (c) Loren Segal and licensed under the MIT license Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. [![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/coffeedoc/codo/trend.png)](https://bitdeli.com/free "Bitdeli Badge") ================================================ FILE: bin/codo ================================================ #!/usr/bin/env node 'use strict'; var compiler = require('coffee-script'); var location = require('path').join( __dirname, '..', 'lib', 'command' ) if (compiler.register) { compiler.register(); } require(location).run(); ================================================ FILE: lib/_entities.coffee ================================================ module.exports = Entities = {} ================================================ FILE: lib/_meta.coffee ================================================ module.exports = Meta = {} ================================================ FILE: lib/_tools.coffee ================================================ module.exports = Tools = {} ================================================ FILE: lib/codo.coffee ================================================ FS = require 'fs' Path = require 'path' walkdir = require 'walkdir' Winston = require 'winston' module.exports = Codo = Environment: require './environment' Tools: Markdown: require './tools/markdown' Referencer: require './tools/referencer' Entities: File: require './entities/file' Class: require './entities/class' Method: require './entities/method' Variable: require './entities/variable' Property: require './entities/property' Mixin: require './entities/mixin' Extra: require './entities/extra' Meta: Method: require './meta/method' Parameter: require './meta/parameter' version: -> JSON.parse( FS.readFileSync(Path.join(__dirname, '..', 'package.json'), 'utf-8') )['version'] parseProject: (path, options={}) -> options.name ||= @detectName(path) options.readme ||= @detectReadme(path) options.basedir ||= path options.extension ||= 'coffee' environment = new @Environment(options) if environment.options.readme environment.readExtra(Path.join path, environment.options.readme) for extra in (options.extras || @detectExtras(path)) environment.readExtra(Path.join path, extra) for input in (options.inputs || [path]) if FS.existsSync(input) if FS.lstatSync(input).isDirectory() for filename in walkdir.sync(input) when filename.match("\\._?#{options.extension}$") environment.readCoffee(filename) else environment.readCoffee(Path.resolve input) else Winston.warn("#{input} (#{Path.join process.cwd(), input}) skipped – does not exist") environment.linkify() environment detectDefaults: (path) -> results = _: [] try if FS.existsSync(Path.join path, '.codoopts') configs = FS.readFileSync Path.join(path, '.codoopts'), 'utf8' for config in configs.split('\n') # Key value configs if option = /^-{1,2}([\w-]+)\s+(['"])?(.*?)\2?$/.exec config results[option[1]] = option[3] # Boolean configs else if bool = /^-{1,2}([\w-]+)\s*$/.exec config results[bool[1]] = true # Argv configs else if config != '' results._.push(config) results catch error Winston.error("Cannot parse .codoopts file: #{error.message}") unless @quiet # Find the project name by either parse `package.json` # or get the current working directory name. # detectName: (path) -> if FS.existsSync(Path.join path, 'package.json') name = JSON.parse(FS.readFileSync Path.join(path, 'package.json'), 'utf-8')['name'] if !name && FS.existsSync(Path.join path, '.git', 'config') config = FS.readFileSync(Path.join(path, '.git', 'config'), 'utf-8') name = /github\.com[:/][^/]+\/(.*)\.git/.exec(config)?[1] if !name name = Path.basename(path) return name.charAt(0).toUpperCase() + name.slice(1) # Find the project README. # detectReadme: (path) -> attempts = [ 'README.markdown' 'README.md' 'README' ] return attempt for attempt in attempts when FS.existsSync(Path.join path, attempt) # Find extra project files. # detectExtras: (path) -> [ 'CHANGELOG' 'CHANGELOG.markdown' 'CHANGELOG.md' 'AUTHORS' 'AUTHORS.md' 'AUTHORS.markdown' 'LICENSE' 'LICENSE.md' 'LICENSE.markdown' 'LICENSE.MIT' 'LICENSE.GPL' 'README.markdown' 'README.md' 'README' ].filter (attempt) -> FS.existsSync(Path.join path, attempt) ================================================ FILE: lib/command.coffee ================================================ Path = require 'path' Codo = require './codo' Optimist = require 'optimist' Theme = require '../themes/default/lib/theme' Table = require 'cli-table' colors = require 'colors/safe' module.exports = class Command options: [ {name: 'help', alias: 'h', describe: 'Show this help'} {name: 'version', describe: 'Show version'} {name: 'extension', alias: 'x', describe: 'Coffee files extension', default: 'coffee'} {name: 'output', alias: 'o', describe: 'The output directory', default: './doc'} {name: 'min-coverage', alias: 'm', describe: 'Require a minimum percentage to be documented or fail', default: '0'} {name: 'output-dir'} {name: 'theme', describe: 'The theme to be used', default: 'default'} {name: 'name', alias: 'n', describe: 'The project name used'} {name: 'readme', alias: 'r', describe: 'The readme file used'} {name: 'quiet', alias: 'q', describe: 'Supress warnings', boolean: true, default: false} {name: 'verbose', alias: 'v', describe: 'Show parsing errors', boolean: true, default: false} {name: 'undocumented', alias: 'u', describe: 'List undocumented objects', boolean: true, default: false} {name: 'closure', describe: 'Try to parse closure-like block comments', boolean: true, default: false} {name: 'debug', alias: 'd', boolean: true} ] @run: -> new @().run (code) -> process.exit code extendOptimist: (optimist, defaults={}, options={}) -> for option in options optimist.options option.name, alias: option.alias, describe: option.describe, boolean: option.boolean, default: defaults[option.name] || defaults[option.alias] || option.default lookupTheme: (name) -> if name == 'default' @theme = Theme else try @theme = require "codo-theme-#{name}" catch try @theme = require Path.resolve("node_modules/codo-theme-#{name}") catch console.log "Error loading theme #{name}: are you sure you have codo-theme-#{name} package installed?" process.exit() prepareOptions: (optimist, defaults) -> options = optimist.argv options._.push entry for entry in defaults._ keyword = 'inputs' for entry in options._ if entry == '-' keyword = 'extras' else options[keyword] ?= [] options[keyword].push entry delete options._ options run: (cb) -> defaults = Codo.detectDefaults(process.cwd()) optimist = Optimist.usage('Usage: $0 [options] [source_files [- extra_files]]') @extendOptimist(optimist, defaults, @options) @theme = @lookupTheme(optimist.argv.theme) @extendOptimist(optimist, defaults, @theme::options) @options = @prepareOptions(optimist, defaults) if @options['output-dir'] console.log "The usage of outdated `--output-dir` option detected. Please switch to `--output`." process.exit() if @options.help console.log optimist.help() else if @options.version console.log Codo.version() else @generate(process.cwd(), @options, cb) collectStats: (environment) -> sections = Classes: total: environment.allClasses().length undocumented: environment.allClasses().filter((e) -> !e.documentation?).map (x) -> [x.name, x.file.path] Mixins: total: environment.allMixins().length undocumented: environment.allMixins().filter((e) -> !e.documentation?).map (x) -> [x.name, x.file.path] Methods: total: environment.allMethods().length undocumented: environment.allMethods().filter((e) -> !e.entity.documentation?).map (x) -> ["#{x.entity.name} (#{x.owner.name})", x.owner.file.path] sections generate: (dir = process.cwd(), options = @options, cb) -> for option in @options if option.default? options[option.name] ?= option.default @theme ?= @lookupTheme(options.theme) for option in @theme::options if option.default? options[option.name] ?= option.default environment = Codo.parseProject(dir, options) sections = @collectStats(environment) unless options.test @theme.compile(environment) overall = 0 undocumented = 0 for section, data of sections overall += data.total undocumented += data.undocumented.length if options.undocumented for section, data of sections when data.undocumented.length != 0 table = new Table head: [section, 'Path'] table.push(entry) for entry in data.undocumented unless options.test console.log table.toString() console.log '' else table = new Table head: ['', 'Total', 'Undocumented'] undocumented_percent = 100/overall*undocumented || 0 table.push( ['Files', environment.allFiles().length, ''], ['Extras', environment.allExtras().length, ''], ['Classes', sections['Classes'].total, sections['Classes'].undocumented.length], ['Mixins', sections['Mixins'].total, sections['Mixins'].undocumented.length], ['Methods', sections['Methods'].total, sections['Methods'].undocumented.length] ) unless options.test console.log table.toString() console.log '' console.log " Totally documented: #{(100 - undocumented_percent).toFixed(2)}%" console.log '' documentedRatio = 100 - (100*undocumented/overall).toFixed(2) if documentedRatio < options["min-coverage"] unless options.test console.error colors.red(" Expected " + options["min-coverage"] + "% to be documented, but only " + documentedRatio + "% were.") cb 1 if cb else cb() if cb ================================================ FILE: lib/documentation.coffee ================================================ module.exports = class Documentation constructor: (comment) -> @parseTags(comment) # Parse the given lines and adds the result # to the result object. # # @param [Array] lines the lines to parse # parseTags: (lines) -> comment = [] while (line = lines.shift()) isnt undefined # Look ahead unless /^@example|@overload|@method|@event/.exec line while /^\s{2}\S+/.test(lines[0]) line += lines.shift().substring(1) if property = /^@nodoc/i.exec line @nodoc = true if property = /^@property\s+[\[\{](.+?)[\]\}](?:\s+(.+))?/i.exec line @property = property[1] lines.unshift property[2] if property[2]? else if returns = /^@return\s+[\[\{](.+?)[\]\}](?:\s+(.+))?/i.exec line @returns = type: returns[1] description: returns[2] else if returns = /^@return\s+(.+)/i.exec line @returns = type: '?' description: returns[1] else if throws = /^@throw\s+[\[\{](.+?)[\]\}](?:\s+(.+))?/i.exec line @throws ?= [] @throws.push type: throws[1] description: throws[2] else if throws = /^@throw\s+(.+)/i.exec line @throws ?= [] @throws.push type: '?' description: throws[1] else if param = /^@param\s+[\[\{](.+?)[\]}]\s+\[([^\]]+)](?:\s+(.+))?/i.exec line @params ?= [] if paramNameVal = /^([^ ]+)\s*=\s*([^ ]+)/.exec param[2] paramName = paramNameVal[1] defValue = paramNameVal[2] else defValue = null paramName = param[2] @params.push type: param[1] name: paramName description: param[3] defaultState: defValue optional: yes else if param = /^@param\s+([^ ]+)\s+[\[\{](.+?)[\]\}](?:\s+(.+))?/i.exec line @params ?= [] @params.push type: param[2] name: param[1] description: param[3] else if param = /^@param\s+[\[\{](.+?)[\]\}]\s+([^ ]+)(?:\s+(.+))?/i.exec line @params ?= [] @params.push type: param[1] name: param[2] description: param[3] else if option = /^@option\s+([^ ]+)\s+[\[\{](.+?)[\]\}]\s+([^ ]+)(?:\s+(.+))?/i.exec line @options ?= {} @options[option[1]] ?= [] @options[option[1]].push type: option[2] name: option[3] description: option[4] else if option = /^@option\s+([^ ]+)\s+([^ ]+)\s+[\[\{](.+?)[\]\}](?:\s+(.+))?/i.exec line @options ?= {} @options[option[1]] ?= [] @options[option[1]].push type: option[3] name: option[2] description: option[4] else if see = /^@see\s+([^\s]+)(?:\s+(.+))?/i.exec line @see ?= [] @see.push reference: see[1] label: see[2] else if author = /^@author\s+(.+)/i.exec line @authors ?= [] @authors.push author[1] || '' else if copyright = /^@copyright\s+(.+)/i.exec line @copyright = copyright[1] || '' else if note = /^@note\s+(.+)/i.exec line @notes ?= [] @notes.push note[1] || '' else if todo = /^@todo\s+(.+)/i.exec line @todos ?= [] @todos.push todo[1] || '' else if example = /^@example(?:\s+(.+))?/i.exec line title = example[1] || '' code = [] while /^\s{2}.*/.test(lines[0]) or (/^$/.test(lines[0]) and /^\s{2}.*/.test(lines[1])) code.push lines.shift().substring(2) if code.length isnt 0 @examples ?= [] @examples.push title: title code: code.join '\n' else if namespace = /^@namespace\s+(.+)/i.exec line @namespace = namespace[1] || '' else if abstract = /^@abstract(?:\s+(.+))?/i.exec line @abstract = abstract[1] || '' else if /^@private/.exec line @private = true else if /^@public/.exec line @public = true else if since = /^@since\s+(.+)/i.exec line @since = since[1] || '' else if version = /^@version\s+(.+)/i.exec line @version = version[1] || '' else if deprecated = /^@deprecated(\s+)?(.*)/i.exec line @deprecated = deprecated[2] || '' else if mixin = /^@mixin/i.exec line @mixin = true else if concern = /^@concern\s+(.+)/i.exec line @concerns ?= [] @concerns.push concern[1] else if include = /^@include\s+(.+)/i.exec line @includes ?= [] @includes.push include[1] else if extend = /^@extend\s+(.+)/i.exec line @extends ?= [] @extends.push extend[1] else if event = /^@event\s+(\S+)(\s+(.+))?/i.exec line @events ?= [] innerComment = [] innerComment.push(event[2]) if event[2] doc = {} while /^\s{2}.*/.test(lines[0]) || /^\s*$/.test(lines[0]) innerComment.push lines.shift().substring(2) @parseTags.call(doc, innerComment) if innerComment @events.push name: event[1] documentation: doc else if overload = /^@overload\s+(.+)/i.exec line signature = overload[1] innerComment = [] while /^\s{2}.*/.test(lines[0]) || /^\s*$/.test(lines[0]) innerComment.push lines.shift().substring(2) if innerComment.length != 0 @overloads ?= [] doc = {} @parseTags.call doc, innerComment @overloads.push signature: signature documentation: doc else if method = /^@method\s+(.+)/i.exec line signature = method[1] innerComment = [] while /^\s{2}.*/.test(lines[0]) or /^\s*$/.test(lines[0]) innerComment.push lines.shift().substring(2) if innerComment.length isnt 0 @methods ?= [] doc = {} @parseTags.call doc, innerComment @methods.push signature: signature documentation: doc else comment.push line text = comment.join('\n') @comment = text.trim() sentence = /((?:.|\n)*?[.#][\s$])/.exec(text) sentence = sentence[1].replace(/\s*#\s*$/, '') if sentence @summary = (sentence || text || '').trim() inspect: -> { comment: @comment summary: @summary notes: @notes see: @see namespace: @namespace abstract: @abstract private: @private public: @public deprecated: @deprecated version: @version since: @since authors: @authors copyright: @copyright todos: @todos includes: @includes extends: @extends concerns: @concerns examples: @examples params: @params options: @options returns: @returns throws: @throws overloads: @overloads events: @events methods: @methods property: @property } ================================================ FILE: lib/entities/class.coffee ================================================ Entity = require '../entity' Method = require './method' Variable = require './variable' Property = require './property' Mixin = require './mixin' MetaMethod = require '../meta/method' Entities = require '../_entities' Winston = require 'winston' module.exports = class Entities.Class extends Entity @name = "Class" @looksLike: (node) -> node.constructor.name is 'Class' && node.variable?.base?.value? constructor: (@environment, @file, @node) -> [@selfish, @container] = @determineContainment(@node.variable) @parent = @fetchParent(@node.parent) if @node.parent @documentation = @node.documentation @name = @fetchName(@node.variable, @selfish, @container) @methods = [] @variables = [] @properties = [] @includes = [] @extends = [] @concerns = [] @descendants = [] name = @name.split('.') @basename = name.pop() @namespace = @documentation?.namespace or name.join('.') if @environment.options.debug Winston.info "Creating new Class Entity" Winston.info " name: " + @name Winston.info " documentation: " + @documentation @ # Determines if the class definition at given node is using @assignation # and if in such case this class is nested into another one determineContainment: (node) -> if node.base?.value == 'this' selfish = true # class @Foo container = @lookup(Class, node) # class Foo \n class @Bar [selfish, container] fetchParent: (source) -> [selfish, container] = @determineContainment(source) @fetchName(source, selfish, container) fetchName: (source, selfish, container) -> name = [] # Nested class definition inherits # the namespace from the containing class name.push container.name if container # Take the actual name of assignation unless # we are prefixed with `@` name.push source.base.value if !selfish && source.base? # Get the rest of actual assignation path if source.properties name.push prop.name.value for prop in source.properties when prop.name? # Here comes the magic! name.join('.') linkify: -> super for node in @node.body.expressions if node.constructor.name == 'Assign' && node.entities? @linkifyAssign(node) if node.constructor.name == 'Value' @linkifyValue(node) if node.constructor.name == 'Call' && node.entities? @linkifyCall(node) @linkifyParent() @linkifyMixins() linkifyAssign: (node) -> for entity in node.entities when entity.selfish # class Foo # @foo = -> if entity instanceof Method entity.kind = 'static' @methods.push entity # class Foo # @foo = 'test' if entity instanceof Variable entity.kind = 'static' @variables.push entity linkifyValue: (node) -> for property in node.base.properties when property.entities? for entity in property.entities # class Foo # @foo: -> # foo: -> if entity instanceof Method entity.kind = if entity.selfish then 'static' else 'dynamic' @methods.push entity # class Foo # foo: 'test' if entity instanceof Variable entity.kind = if entity.selfish then 'static' else 'dynamic' @variables.push entity if entity instanceof Property @properties.push entity linkifyCall: (node) -> for entity in node.entities if entity instanceof Property found = false for property in @properties if property.name == entity.name entity.unite(property) found = true @properties.push(entity) unless found linkifyParent: -> if @parent @parent = @environment.find(Class, @parent) || @parent @parent.descendants?.push(@) linkifyMixins: -> if @documentation?.includes? for entry in @documentation.includes mixin = @environment.find(Mixin, entry) || entry @includes.push(mixin) mixin.inclusions?.push(@) if @documentation?.extends? for entry in @documentation.extends mixin = @environment.find(Mixin, entry) || entry @extends.push(mixin) mixin.extensions?.push(@) if @documentation?.concerns? for entry in @documentation.concerns mixin = @environment.find(Mixin, entry) || entry @concerns.push(mixin) mixin.concerns?.push(@) effectiveMethods: -> return @_effectiveMethods if @_effectiveMethods? @_effectiveMethods = [] for method in @methods @_effectiveMethods.push(MetaMethod.fromMethodEntity method) if @documentation?.methods for method in @documentation.methods @_effectiveMethods.push(MetaMethod.fromDocumentationMethod method) @_effectiveMethods allMethods: -> methods = @effectiveMethods().map (method) => { entity: method owner: @ } resolvers = includes: 'effectiveInclusionMethods' extends: 'effectiveExtensionMethods' concerns: 'effectiveConcernMethods' for storage, resolver of resolvers for mixin in @[storage] if mixin[resolver] for method in mixin[resolver]() methods.push entity: method owner: mixin methods inherited: (getter) -> return [] if !@parent || !@parent.name? found = {} entries = getter() entries.filter (entry) -> found[entry.entity.name] = true unless found[entry.entity.name] inheritedMethods: -> @_inheritedMethods ||= @inherited => @parent.allMethods().concat @parent.inheritedMethods() inheritedVariables: -> @_inheritedVariables ||= @inherited => variables = @parent.variables.map (variable) => { entity: variable owner: @parent } variables.concat @parent.inheritedVariables() inheritedProperties: -> @_inheritedProperties ||= @inherited => properties = @parent.properties.map (property) => { entity: property owner: @parent } properties.concat @parent.inheritedProperties() inspect: -> { file: @file.path documentation: @documentation?.inspect() selfish: @selfish name: @name container: @container?.inspect() parent: @parent?.inspect?() || @parent methods: @methods.map (x) -> x.inspect() variables: @variables.map (x) -> x.inspect() properties: @properties.map (x) -> x.inspect() includes: @includes.map (x) -> x.inspect?() || x extends: @extends.map (x) -> x.inspect?() || x concerns: @concerns.map (x) -> x.inspect?() || x } ================================================ FILE: lib/entities/extra.coffee ================================================ FS = require 'fs' Path = require 'path' Entities = require '../_entities' Markdown = require '../tools/markdown' module.exports = class Entities.Extra @name: "Extra" constructor: (@environment, @path) -> @name = Path.relative(@environment.options.basedir, @path) @content = FS.readFileSync @path, 'utf-8' if @environment.options.debug Winston.info "Creating new Extra Entity" Winston.info " name: " + @name Winston.info " content: " + @content @parsed = if /\.(markdown|md)$/.test @path Markdown.convert(@content) else "

"+@content.replace(/\n/g, '
')+"

" linkify: -> inspect: -> { path: @path, parsed: @parsed } ================================================ FILE: lib/entities/file.coffee ================================================ Entity = require '../entity' Path = require 'path' Method = require './method' Variable = require './variable' Mixin = require './mixin' Class = require './class' MetaMethod = require '../meta/method' Entities = require '../_entities' Winston = require 'winston' module.exports = class Entities.File extends Entity @Name: "File" constructor: (@environment, @path, @node) -> @file = @ @name = Path.relative(@environment.options.basedir, @path) @basename = Path.basename(@name) @dirname = Path.dirname(@name) @methods = [] @variables = [] @mixins = [] @classes = [] if @environment.options.debug Winston.info "Creating new File Entity" Winston.info " name: " + @name Winston.info " path: " + @path linkify: -> super for node in @node.expressions # Checking direct members unless entities = node.entities # And members prefixed with `module.exports =` if node.variable?.base?.value == 'module' if node.variable?.properties?[0]?.name?.value == 'exports' entities = node.value?.entities if entities for entity in entities if entity instanceof Method @methods.push(entity) if entity.name.length > 0 if entity instanceof Variable @variables.push entity if entity instanceof Mixin @mixins.push entity if entity instanceof Class @classes.push entity effectiveMethods: -> @_effectiveMethods ||= @methods.map (method) -> MetaMethod.fromMethodEntity method inspect: -> { file: @name methods: @methods.map (x) -> x.inspect() variables: @variables.map (x) -> x.inspect() } ================================================ FILE: lib/entities/method.coffee ================================================ Entity = require '../entity' Parameter = require '../meta/parameter' Entities = require '../_entities' Winston = require 'winston' module.exports = class Entities.Method extends Entity @name: "Method" @looksLike: (node) -> node.constructor.name == 'Assign' && node.value?.constructor.name == 'Code' constructor: (@environment, @file, @node) -> Winston.info "Creating new Method Entity" if @environment.options.debug @name = [@node.variable.base.value] @name.push prop.name.value for prop in @node.variable.properties when prop.name? if @name[0] == 'this' @selfish = true @name = @name.slice(1) if @name[0] == 'module' && @name[1] == 'exports' @name = @name.slice(2) if @name[0] == 'exports' @name = @name.slice(1) @name = @name.join('.') @bound = @node.value.bound @documentation = @node.documentation @parameters = @node.value.params.map (node) -> Parameter.fromNode(node) if @environment.options.debug Winston.info " name: " + @name Winston.info " documentation: " + @documentation inspect: -> { file: @file.path name: @name bound: @bound documentation: @documentation?.inspect() selfish: @selfish kind: @kind parameters: @parameters.map (x) -> x.inspect() } ================================================ FILE: lib/entities/mixin.coffee ================================================ Entity = require '../entity' Method = require './method' Variable = require './variable' MetaMethod = require '../meta/method' Entities = require '../_entities' Winston = require 'winston' module.exports = class Entities.Mixin extends Entity @name: "Mixin" @looksLike: (node) -> node.constructor.name == 'Assign' && node.value?.base?.properties? @is: (node) -> node.documentation?.mixin && super(node) @isConcernSection: (node) -> node.constructor.name == 'Assign' && node.value?.constructor.name == 'Value' && ( node.variable.base.value == 'ClassMethods' || node.variable.base.value == 'InstanceMethods' ) constructor: (@environment, @file, @node) -> [@name, @selfish] = @fetchName() @documentation = @node.documentation @methods = [] @variables = [] @inclusions = [] @extensions = [] @concerns = [] for property in @node.value.base.properties # Recognize assigned code on the mixin @concern = true if @constructor.isConcernSection(property) if @concern @classMethods = [] @instanceMethods = [] name = @name.split('.') @basename = name.pop() @namespace = @documentation?.namespace or name.join('.') if @environment.options.debug Winston.info "Creating new Mixin Entity" Winston.info " name: " + @name Winston.info " documentation: " + @documentation linkify: -> super @grabMethods @methods, @node if @concern for property in @node.value.base.properties # Recognize concerns as inner mixins if property.value?.constructor.name is 'Value' switch property.variable.base.value when 'ClassMethods' @grabMethods @classMethods, property when 'InstanceMethods' @grabMethods @instanceMethods, property grabMethods: (container, node) -> for property in node.value.base.properties if property.entities? for entity in property.entities # Foo = # foo: -> container.push entity if entity instanceof Method aggregateEffectiveMethods: (kind) -> methods = [] overrides = {} overrides.kind = kind if kind? for method in @methods methods.push(MetaMethod.fromMethodEntity method, overrides) if @documentation.methods for method in @documentation.methods methods.push(MetaMethod.fromDocumentationMethod method, overrides) methods effectiveMethods: -> return @effectiveConcernMethods() if @concern @_effectiveMethods ||= @aggregateEffectiveMethods() effectiveInclusionMethods: -> @_effectiveInclusionMethods ||= @aggregateEffectiveMethods('dynamic') effectiveExtensionMethods: -> @_effectiveExtensionMethods ||= @aggregateEffectiveMethods('static') effectiveConcernMethods: -> return @_effectiveConcernMethods if @_effectiveConcernMethods? @_effectiveConcernMethods = [] for method in @classMethods @_effectiveConcernMethods.push(MetaMethod.fromMethodEntity method, kind: 'static') for method in @instanceMethods @_effectiveConcernMethods.push(MetaMethod.fromMethodEntity method, kind: 'dynamic') if @documentation.methods for method in @documentation.methods @_effectiveConcernMethods.push(MetaMethod.fromDocumentationMethod method) @_effectiveConcernMethods inspect: -> { file: @file.path name: @name concern: @concern documentation: @documentation?.inspect() selfish: @selfish methods: @methods.map (x) -> x.inspect() classMethods: @classMethods?.map (x) -> x.inspect() instanceMethods: @instanceMethods?.map (x) -> x.inspect() variables: @variables.map (x) -> x.inspect() } ================================================ FILE: lib/entities/property.coffee ================================================ Entity = require '../entity' Entities = require '../_entities' Winston = require 'winston' # # Supported formats: # # foo: [] # # get foo: -> # set foo: (value) -> # # @property 'foo' # @property 'foo', -> # @property 'foo', # get: -> # set: (value) -> # module.exports = class Entities.Property extends Entity @name: "Property" @looksLike: (node) -> (node.constructor.name == 'Assign' && node.value?.constructor.name == 'Value') || (node.constructor.name == 'Call' && node.variable?.base?.value == 'this') || ( node.constructor.name == 'Call' && node.args?[0]?.base?.properties?[0]?.variable?.base?.value && (node.variable?.base?.value == 'set' || node.variable?.base?.value == 'get') ) @is: (node) -> super(node) && ( node.documentation?.property || (node.constructor.name == 'Call' && node.variable?.base?.value != 'this') ) constructor: (@environment, @file, @node) -> if @node.constructor.name == 'Call' && @node.variable?.base?.value != 'this' @name = @node.args[0].base.properties[0].variable.base.value @setter = @node.variable.base.value == 'set' @getter = @node.variable.base.value == 'get' else if @node.constructor.name == 'Call' && @node.variable?.base?.value == 'this' @name = @node.args[0].base.value.replace(/["']/g, '') if @node.args.length > 1 if @node.args[1].constructor.name == 'Value' # @property 'test', {set: ->, get: ->} @setter = false @getter = false for property in @node.args[1].base?.properties @setter = true if property.variable?.base.value == 'set' @getter = true if property.variable?.base.value == 'get' else # @property 'test', -> @setter = false @getter = true else # @property 'test' @setter = true @getter = true else [@name, @selfish] = @fetchVariableName() @setter = true @getter = true @documentation = @node.documentation if @environment.options.debug Winston.info "Creating new Property Entity" Winston.info " name: " + @name Winston.info " documentation: " + @documentation fetchVariableName: -> @fetchName() unite: (property) -> for attribute in ['documentation', 'getter', 'setter'] property[attribute] = @[attribute] = property[attribute] || @[attribute] inspect: -> { file: @file.path name: @name getter: @getter setter: @setter documentation: @documentation?.inspect() } ================================================ FILE: lib/entities/variable.coffee ================================================ Entity = require '../entity' Entities = require '../_entities' Winston = require 'winston' module.exports = class Entities.Variable extends Entity @name: "Variable" @looksLike: (node) -> node.constructor.name == 'Assign' && node.value?.constructor.name == 'Value' && node.variable?.base?.value? && node.value.base.constructor.name isnt 'Call' @is: (node) -> !node.documentation?.property && !node.documentation?.mixin && super(node) constructor: (@environment, @file, @node) -> [@name, @selfish] = @fetchName() @constant = /^[A-Z_-]*$/.test @name try @value = @node.value.base.compile indent: '' # Workaround to replace CoffeeScript internal # representations with something reasonable @value = 'undefined' if @value == 'void 0' @documentation = @node.documentation if @environment.options.debug Winston.info "Creating new Variable Entity" Winston.info " name: " + @name Winston.info " documentation: " + @documentation inspect: -> { file: @file.path name: @name constant: @constant value: @value documentation: @documentation?.inspect() selfish: @selfish kind: @kind } ================================================ FILE: lib/entity.coffee ================================================ # Base class for all entities. # module.exports = class Entity @is: (node) -> !node.documentation?.nodoc linkify: -> visible: -> @environment.options.private || !@node.documentation?.private fetchName: -> name = [@node.variable.base.value] name.push prop.name.value for prop in @node.variable.properties when prop.name? if name[0] == 'this' selfish = true name = name.slice(1) [name.join('.'), selfish] lookup: (Entity, node) -> if node.ancestor if node.ancestor.entities? for entity in node.ancestor.entities return entity if entity instanceof Entity @lookup Entity, node.ancestor ================================================ FILE: lib/environment.coffee ================================================ FS = require 'fs' Path = require 'path' Traverser = require './traverser' File = require './entities/file' Class = require './entities/class' Method = require './entities/method' Variable = require './entities/variable' Property = require './entities/property' Mixin = require './entities/mixin' Extra = require './entities/extra' walkdir = require 'walkdir' Winston = require 'winston' module.exports = class Environment @read: (files, options={}) -> files = [files] unless Array.isArray(files) environment = new @(options) environment.readCoffee(file) for file in files environment.linkify() environment constructor: (@options={}) -> @version = JSON.parse( FS.readFileSync(Path.join(__dirname, '..', 'package.json'), 'utf-8') )['version'] @options.name ?= 'Unknown Project' @options.verbose ?= false @options.debug ?= false @options.cautios ?= false @options.quiet ?= false @options.closure ?= false @options.output ?= 'doc' @options.basedir ?= process.cwd() @needles = [] @entities = [] @references = {} @parsed = {} @needles.push Class @needles.push Method @needles.push Variable @needles.push Property @needles.push Mixin readCoffee: (file) -> return if @parsed[file] Winston.info("Parsing Codo file #{file}") if @options.verbose try Traverser.read(file, @) catch error throw error if @options.debug Winston.error("Cannot parse Coffee file #{file}: #{error.message}") unless @options.quiet finally @parsed[file] = true readExtra: (file) -> return if @parsed[file] Winston.info("Parsing Extra file #{file}") if @options.verbose try @registerEntity(new Extra @, file) catch error throw error if @options.debug Winston.error("Cannot parse Extra file #{file}: #{error.message}") unless @options.quiet finally @parsed[file] = true registerEntity: (entity) -> @entities.push entity all: (Entity, haystack = []) -> for entity in @entities haystack.push(entity) if entity instanceof Entity haystack visibleFiles: -> @allFiles() visibleClasses: -> @allClasses().filter((x) -> x.visible()) visibleMixins: -> @allMixins().filter((x) -> x.visible()) visibleExtras: -> @allExtras() visibleMethods: -> @allMethods().filter((x) -> x.entity.visible && x.owner.visible()) visibleVariables: -> @allVariables() allFiles: -> @_allFiles ||= @all(File) allClasses: -> @_allClasses ||= @all(Class) allMixins: -> @_allMixins ||= @all(Mixin) allExtras: -> @_allExtras ||= @all(Extra) allMethods: -> return @_allMethods if @_allMethods? @_allMethods = [] for source in [@allFiles(), @allClasses(), @allMixins()] for entry in source for method in entry.effectiveMethods() @_allMethods.push {entity: method, owner: entry} @_allMethods.sort (a, b) -> return -1 if a.entity.name < b.entity.name return 1 if a.entity.name > b.entity.name return 0 allVariables: -> return @_allVariables if @_allVariables? @_allVariables = [] for source in [@allFiles(), @allClasses(), @allMixins()] for entry in source for variable in entry.variables @_allVariables.push {entity: variable, owner: entry} @_allVariables find: (Entity, name) -> for entity in @entities if entity instanceof Entity && entity.name == name return entity findReadme: -> @find Extra, Path.relative(@options.basedir, @options.readme) linkify: -> entity.linkify() for entity in @entities for basics in [@allFiles(), @allClasses(), @allMixins()] for basic in basics @references[basic.name] = basic for variable in @allVariables() keyword = variable.owner.name + '.' + variable.entity.name @references[keyword] = variable for method in @allMethods() keyword = method.owner.name + method.entity.shortSignature() @references[keyword] = method reference: (needle, context='') -> needle = needle.split(' ')[0] if @references[needle] @references[needle] else if @references[context+needle] @references[context+needle] else needle inspect: -> @entities.map (entity) -> entity.inspect() ================================================ FILE: lib/meta/method.coffee ================================================ Parameter = require './parameter' Meta = require '../_meta' module.exports = class Meta.Method @override: (options, overrides) -> options[key] = value for key, value of overrides options @fromMethodEntity: (entity, overrides={}) -> options = name: entity.name.match(/[$A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]*/)?[0] kind: entity.kind || '' bound: entity.bound parameters: entity.parameters.map (x) -> x.toString() visible: entity.visible() documentation: entity.documentation new @(@override options, overrides) @fromDocumentationMethod: (entry, overrides={}) -> kind = switch entry.signature[0] when '#' 'dynamic' when '.' 'static' options = name: entry.signature.replace /^[\#\.]?["']?([^\("']+)\(.+/, '$1' kind: kind || '' parameters: Parameter.fromSignature(entry.signature).map (x) -> x.toString() documentation: entry.documentation visible: true # force this to be always visible new @(@override options, overrides) constructor: (options={}) -> @constructor.override @, options effectiveOverloads: -> return @_effectiveOverloads if @_effectiveOverloads? @_effectiveOverloads = [] if @documentation?.overloads for overload in @documentation.overloads @_effectiveOverloads.push(Method.fromDocumentationMethod overload) else @_effectiveOverloads.push(@) @_effectiveOverloads kindSignature: -> switch @kind when 'dynamic' '#' when 'static' '.' else '~' shortSignature: -> @kindSignature() + @name typeSignature: -> '('+(@documentation?.returns?.type || 'void')+')' paramsSignature: -> '('+@parameters.join(', ')+')' inspect: -> { name: @name, kind: @kind, bound: @bound, parameters: @parameters } ================================================ FILE: lib/meta/parameter.coffee ================================================ CoffeeScript = require 'coffee-script' Meta = require '../_meta' module.exports = class Meta.Parameter @fromNode: (node) -> new @ @fetchName(node), !!node.splat, @fetchDefault(node) @fromSignature: (signature) -> signature = signature.replace /^.([^\(]+)/, "x=" nodes = CoffeeScript.nodes("#{signature} ->").expressions[0].value.params nodes.map (node) => @fromNode(node) @fetchName: (node) -> # Normal attribute `do: (it) ->` name = node.name.value # Named parameters a la python: # `make_fac : ({numerator, divisor}) ->` # Also works for class constructors: # `constructor : ( { @name, @key, opts }) -> unless name if (o = node.name.objects)? vars = for v in o if v.base if v.base.value is 'this' then v.properties[0].name.value else v.base.value else if v.variable && v.value "#{v.variable.base.value}:#{v.value.base.value}" else throw new Error('Unhandled syntax') name = "{#{vars.join ', '}}" # Assigned attributes `do: (@it) ->` unless name if node.name.properties name = node.name.properties[0]?.name.value name @fetchDefault: (node) -> try node.value?.compile indent: '' catch error if node?.value?.base?.value is 'this' value = node.value.properties[0]?.name.compile indent: '' "@#{value}" constructor: (@name, @splat, @default) -> toString: -> splat = '...' if @splat defauld = " = #{@default}" if @default [@name, splat, defauld].join('') inspect: -> { name: @name splat: @splat default: @default } ================================================ FILE: lib/tools/markdown.coffee ================================================ marked = require 'marked' Tools = require '../_tools' # It looks like all the markdown libraries for node doesn't get # GitHub flavored markdown right. This helper class post-processes # the best available output from the marked library to conform to # GHM. In addition the allowed tags can be limited. # module.exports = class Tools.Markdown # Tags to keep when parsing is limited @limitedTags: 'a,abbr,acronym,b,big,cite,code,del,em,i,ins,sub,sup,span,small,strike,strong,q,tt,u' # Convert markdown to Html. If the param `limit` # is true, then all unwanted elements are stripped from the # result and also all existing newlines. # # @param [String] markdown the markdown markup # @param [Boolean] limit if elements should be limited # @convert: (markdown, limit = false, allowed = Markdown.limitedTags) -> return if markdown is undefined html = marked(markdown) if limit html = html.replace(/\n/, ' ') html = Markdown.limit(html, allowed) # Remove newlines around open and closing paragraph tags html = html.replace /(?:\n+)?<(\/?p)>(?:\n+)?/mg, '<$1>' # Add '.html' to relative markdown links html = html.replace /href="(?!https?:\/\/)(.*\.md)"/mg, 'href="$1.html"' html # Strips all unwanted tag from the html # # @param [String] html the Html to clean # @param [String] allowed the comma separated list of allowed tags # @return [String] the cleaned Html # @limit: (html, allowed) -> allowed = allowed.split ',' replace = (html) -> result = html.replace /<([a-z0-9]+)\s*(?:\s[^>]+)?>([\s\S]+?)<\/\1>/g, (match, tag, text) -> if allowed.indexOf(tag) is -1 then text else match if result == html result else replace(result) replace(html) ================================================ FILE: lib/tools/referencer.coffee ================================================ Tools = require '../_tools' module.exports = class Tools.Referencer constructor: (@environment) -> resolve: (text, replacer) -> # Make curly braces within code blocks undetectable text = text.replace /\`[^\`]*\`/mg, (match) -> match.replace(/\{/mg, "\u0091").replace(/\}/mg, "\u0092") # Search for references and replace them text = text.replace /\{([^\}]*)\}/gm, (match, link) => link = link.split(' ') href = link.shift() label = link.join(' ') replacement = @environment.reference(href) if replacement != href || /\:\/\/\w+((\:\d+)?\/\S*)?/.test(href) replacer replacement, label || href else match # Restore curly braces within code blocks text = text.replace /\`[^\`]*\`/mg, (match) -> match.replace(/\u0091/mg, '{').replace(/\u0092/mg, '}') ================================================ FILE: lib/traverser.coffee ================================================ FS = require 'fs' _ = require 'underscore' _.str = require 'underscore.string' CoffeeScript = require 'coffee-script' Environment = require './environment' Documentation = require './documentation' File = require './entities/file' Winston = require 'winston' # # The class takes CS nodes tree and recursively injects # additional meta-data into it: # # 1. For each possible node it tries every registered # entity and pushes an instance of it into tree if it suites. # 2. For every suitable node it finds the suitable comment block # respecting things like `this.` and `module.exports =` and # links it to the tree as well. # # Since the transformation is happening upside down, nested entities # can interact with initialized parents (for instance a class can find # parent class; method can find the class/mixin/file it belongs to). # module.exports = class Traverser @read: (file, environment) -> content = FS.readFileSync(file, 'utf8') content = @convertComments(content, environment.options.closure) unless environment.options.cautios new @(file, content, environment) # Attach each parent to its children, so we are able # to traverse the ancestor parse tree. Since the # parent attribute is already used in the class node, # the parent is stored as `ancestor`. # # @param [Base] nodes the CoffeeScript nodes # @linkAncestors: (node) -> node.eachChild (child) => child.ancestor = node @linkAncestors child node # Convert the comments to block comments, # so they appear in the nodes. # # The methods replaces starting # symbols with invisible # unicode whitespace to keep empty lines formatted. # # @param [String] content the CoffeeScript file content # @convertComments: (content, closure=false) -> result = [] comment = [] inComment = false inBlockComment = false indentComment = 0 for line in content.split('\n') blockComment = /^\s*#{3}/.exec(line) && !/^\s*#{3}.+#{3}/.exec(line) if blockComment || inBlockComment line = line.replace /#{3}\*/, "###" if closure inBlockComment = !inBlockComment if blockComment result.push line else commentLine = /^(\s*#)\s?(\s*.*)/.exec(line) if commentLine if inComment comment.push @whitespace(indentComment) + commentLine[2]?.replace /#/g, "\u0091#" else inComment = true indentComment = commentLine[1].length - 1 comment.push @whitespace(indentComment) + '###' comment.push @whitespace(indentComment) + commentLine[2]?.replace /#/g, "\u0091#" else if inComment inComment = false comment.push @whitespace(indentComment) + '###' # Push here comments only before certain lines if /// ( # class Foo class\s*@?[$A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]* | # variable = ^\s*[$A-Za-z_\x7f-\uffff][$\w\x7f-\uffff.]*\s+\= | # method: -> (?:[$A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]*|["'].*["'])\s*:\s*(\(.*\)\s*)?[-=]> | # @method = -> @[A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]*\s*=\s*(\(.*\)\s*)?[-=]> | # CONSTANT ^\s*@[$A-Z_][A-Z_]* | # property: ^\s*[$A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]*: | # @property 'foo' @[A-Za-z_\x7f-\uffff][$\w\x7f-\uffff]*\s+['"].+['"] ) ///.exec line result.push c for c in comment comment = [] result.push line result.join('\n') # Whitespace helper function # # @param [Number] n the number of spaces # @return [String] the space string # @whitespace: (n) -> a = [] while a.length < n a.push ' ' a.join '' constructor: (@path, @content, @environment) -> @environment ?= new Environment @history = [] @root = @constructor.linkAncestors(CoffeeScript.nodes @content) @file = @prepare(@root, @path, File) @root.traverseChildren true, (node) => for Entity in @environment.needles when Entity.looksLike(node) Winston.info "Adding entity " + Entity.name if @environment.options.debug @prepare(node, @file, Entity) @history.push node prepare: (node, file, Entity) -> node.entities ?= [] unless node.documentation? # Find actual comment node previous = @history[@history.length-1] if @environment.options.debug Winston.info "Type of previous is " + previous?.constructor.name Winston.info "History is " + @history.map (entry) -> entry.constructor.name switch previous?.constructor.name # A comment is preceding the entity declaration when 'Comment' doc = previous when 'Literal', 'PropertyName' # The node is exported `module.exports = ...`, take the comment before `module` if previous.value is 'exports' previous = @history[@history.length-6] doc = previous if previous?.constructor.name is 'Comment' # An assign that is handled as an object by CoffeeScript when 'Obj' if @history[@history.length-2]?.constructor.name is 'Value' previous = @history[@history.length-3] doc = previous if previous?.constructor.name is 'Comment' # An operator precedes the definition, e.g. `new class ClassName` when 'Op' previous = @history[@history.length-2] doc = previous if previous?.constructor.name is 'Comment' Winston.info "Doc is " + doc?.comment if @environment.options.debug if doc?.comment? node.documentation = new Documentation(@leftTrimBlock doc.comment) if Entity.is(node) entity = new Entity @environment, file, node node.entities.push(entity) @environment.registerEntity(entity) entity # Detect whitespace on the left and removes # the minimum whitespace ammount. # # The method additionally drops invisible UTF # whitespace introduced by `convertComments` # # @example left trim all lines # leftTrimBlock(['', ' Escape at maximum speed.', '', ' @param (see #move)', ' ']) # => ['', 'Escape at maximum speed.', '', '@param (see #move)', ''] # # This will keep indention for examples intact. # # @param [Array] lines the comment lines # @return [Array] lines left trimmed lines # leftTrimBlock: (text) -> return unless text lines = text.replace(/\u0091/gm, '').split('\n') # Detect minimal left trim amount trimMap = lines.map (line) -> line.length - _.str.ltrim(line).length if line.length != 0 minimalTrim = _.min _.without(trimMap, undefined) # If we have a common amount of left trim if minimalTrim > 0 && minimalTrim < Infinity # Trim same amount of left space on each line lines = for line in lines line = line.substring(minimalTrim, line.length) line # Strip empty prepending lines lines = lines.slice(1) while lines[0].length == 0 # Strip empty postponing lines lines = lines.slice(0, -1) while lines[lines.length-1].length == 0 lines inspect: -> @environment.inspect() ================================================ FILE: package.json ================================================ { "name": "codo", "description": "A CoffeeScript documentation generator.", "keywords": [ "coffeescript", "doc" ], "author": "Michael Kessler ", "maintainers": [ { "name": "Michael Kessler" }, { "name": "Boris Staal" } ], "version": "2.1.2", "license": "MIT", "engines": { "node": ">=0.9.0" }, "directories": { "lib": "./src", "theme/default/assets": "./theme/default/assets", "theme/default/templates": "./theme/default/templates" }, "main": "./lib/codo.coffee", "bin": { "codo": "./bin/codo" }, "dependencies": { "coffee-script": ">= 1.6.0", "walkdir": ">= 0.0.2", "optimist": ">= 0.3.0", "marked": ">= 0.2.10", "underscore": ">= 0.1.0", "underscore.string": ">= 0.1.0", "haml-coffee": ">= 0.6.0", "mkdirp": ">= 0.1.0", "connect": ">= 0.1.0", "colors": ">= 1.1.2", "async": ">= 0.1.22", "mincer": "~0.5.11", "stylus": "~0.38.0", "nib": "~1.0.0", "winston": "~0.8.0", "cli-table": "~0.2.0", "strftime": "~0.6.2" }, "devDependencies": { "diff": ">=2.1.1", "jasmine-node": ">= 1.13.1", "deep-eql": "*", "rimraf": "~2.2.2", "grunt": "~0.4.1", "grunt-release": "~0.6.0" }, "homepage": "https://github.com/coffeedoc/codo", "repository": { "type": "git", "url": "git://github.com/coffeedoc/codo.git" }, "bugs": { "url": "https://github.com/coffeedoc/codo/issues" }, "scripts": { "test": "jasmine-node --coffee spec" } } ================================================ FILE: spec/_templates/angular/angular-with-new.coffee ================================================ module.exports = require('angular').module 'module-name', ['some-dependency'] .factory 'a-factory', ['some-dependency', (someDependency) -> ### This is a testy test class with a documenty documentation ### new class MyTestClass ] .name ================================================ FILE: spec/_templates/angular/angular-with-new.json ================================================ [ { "file": "spec/_templates/angular/angular-with-new.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/angular/angular-with-new.coffee", "documentation": { "comment": "This is a testy test class with a documenty documentation", "summary": "This is a testy test class with a documenty documentation" }, "name": "MyTestClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/angular/angular.coffee ================================================ module.exports = require('angular').module 'module-name', ['some-dependency'] .factory 'a-factory', ['some-dependency', (someDependency) -> ### This is a testy test class with a documenty documentation ### class MyTestClass ] .name ================================================ FILE: spec/_templates/angular/angular.json ================================================ [ { "file": "spec/_templates/angular/angular.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/angular/angular.coffee", "documentation": { "comment": "This is a testy test class with a documenty documentation", "summary": "This is a testy test class with a documenty documentation" }, "name": "MyTestClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/class_description_markdown.coffee ================================================ # Codo - the CoffeeScript API documentation generator # # # Header 1 # # This is a paragraph. # # ## Header 2 # # This is a paragraph. # # ### Header 3 # # This is a paragraph. # # #### Header 4 # # This is a paragraph. # # ##### Header 5 # # This is a paragraph. # # ###### Header 6 # # This is a paragraph. # # @abstract _Template methods_ must be implemented # @note Also notes have _now_ Markdown # @todo Allow **markdown** in todos # # @author Mickey # @author **Donald** # @copyright _No Copyright_ # @since **1.0.0** # @version _1.1.0_ # @deprecated **nobody** uses this # class TestMarkdownDocumentation ================================================ FILE: spec/_templates/classes/class_description_markdown.json ================================================ [ { "file": "spec/_templates/classes/class_description_markdown.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/class_description_markdown.coffee", "documentation": { "comment": "Codo - the CoffeeScript API documentation generator\n\n# Header 1\n\nThis is a paragraph.\n\n## Header 2\n\nThis is a paragraph.\n\n### Header 3\n\nThis is a paragraph.\n\n#### Header 4\n\nThis is a paragraph.\n\n##### Header 5\n\nThis is a paragraph.\n\n###### Header 6\n\nThis is a paragraph.", "summary": "Codo - the CoffeeScript API documentation generator", "notes": [ "Also notes have _now_ Markdown" ], "abstract": "_Template methods_ must be implemented", "deprecated": "**nobody** uses this", "version": "_1.1.0_", "since": "**1.0.0**", "authors": [ "Mickey", "**Donald**" ], "copyright": "_No Copyright_", "todos": [ "Allow **markdown** in todos" ] }, "name": "TestMarkdownDocumentation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/class_documentation.coffee ================================================ # This is a test class with `inline.dot`. Beware. # # @note Please use # this carefully # @note For internal use only # # @example # Class.getType('cat') # # @example Use it in this way # new Class() # # @example Alternatively also this is possible # cl = Class.for(obj) # cl.execute() # # @todo Clean up socket handler # @todo Refactor # property factory # @author Netzpirat # @author Plasticman # @abstract Each listener implementation must inherit # @private # @public # @deprecated Use other class # which is thread safe # @since 1.0.0 # @version 1.0.2 # class TestClassDocumentation ================================================ FILE: spec/_templates/classes/class_documentation.json ================================================ [ { "file": "spec/_templates/classes/class_documentation.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/class_documentation.coffee", "documentation": { "comment": "This is a test class with `inline.dot`. Beware.", "summary": "This is a test class with `inline.dot`.", "notes": [ "Please use this carefully", "For internal use only" ], "abstract": "Each listener implementation must inherit", "private": true, "public": true, "deprecated": "Use other class which is thread safe", "version": "1.0.2", "since": "1.0.0", "authors": [ "Netzpirat", "Plasticman" ], "todos": [ "Clean up socket handler", "Refactor property factory" ], "examples": [ { "title": "", "code": "Class.getType('cat')" }, { "title": "Use it in this way", "code": "new Class()" }, { "title": "Alternatively also this is possible", "code": "cl = Class.for(obj)\ncl.execute()" } ] }, "name": "TestClassDocumentation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/class_extends.coffee ================================================ class NS.Clazz extends Another.Clazz ================================================ FILE: spec/_templates/classes/class_extends.json ================================================ [ { "file": "spec/_templates/classes/class_extends.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/class_extends.coffee", "name": "NS.Clazz", "parent": "Another.Clazz", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/empty_class.coffee ================================================ class A class extends A ================================================ FILE: spec/_templates/classes/empty_class.json ================================================ [ { "file": "spec/_templates/classes/empty_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/empty_class.coffee", "name": "A", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/export_class.coffee ================================================ # Yep, this should be assigned to the class module.exports = class TestExportClass ================================================ FILE: spec/_templates/classes/export_class.json ================================================ [ { "file": "spec/_templates/classes/export_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/export_class.coffee", "documentation": { "comment": "Yep, this should be assigned to the class", "summary": "Yep, this should be assigned to the class" }, "name": "TestExportClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/global_class.coffee ================================================ # This is a test class class @GlobalTestClass ================================================ FILE: spec/_templates/classes/global_class.json ================================================ [ { "file": "spec/_templates/classes/global_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/global_class.coffee", "documentation": { "comment": "This is a test class", "summary": "This is a test class" }, "selfish": true, "name": "GlobalTestClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/inner_class.coffee ================================================ class Tower.Model.Relation.HasMany extends Tower.Model.Relation class @Scope class @Scope2 extends @Scope ================================================ FILE: spec/_templates/classes/inner_class.json ================================================ [ { "file": "spec/_templates/classes/inner_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/inner_class.coffee", "name": "Tower.Model.Relation.HasMany", "parent": "Tower.Model.Relation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/classes/inner_class.coffee", "selfish": true, "name": "Tower.Model.Relation.HasMany.Scope", "container": { "file": "spec/_templates/classes/inner_class.coffee", "name": "Tower.Model.Relation.HasMany", "parent": "Tower.Model.Relation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/classes/inner_class.coffee", "selfish": true, "name": "Tower.Model.Relation.HasMany.Scope2", "container": { "file": "spec/_templates/classes/inner_class.coffee", "name": "Tower.Model.Relation.HasMany", "parent": "Tower.Model.Relation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, "parent": { "file": "spec/_templates/classes/inner_class.coffee", "selfish": true, "name": "Tower.Model.Relation.HasMany.Scope", "container": { "file": "spec/_templates/classes/inner_class.coffee", "name": "Tower.Model.Relation.HasMany", "parent": "Tower.Model.Relation", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/namespaced_class.coffee ================================================ # Test description class Some.Namespace.MyClass # Test description class @Another.Namespace.MyClass # Test description # @namespace Manual.Namespace class MyClass ================================================ FILE: spec/_templates/classes/namespaced_class.json ================================================ [ { "file": "spec/_templates/classes/namespaced_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/namespaced_class.coffee", "documentation": { "comment": "Test description", "summary": "Test description" }, "name": "Some.Namespace.MyClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/classes/namespaced_class.coffee", "documentation": { "comment": "Test description", "summary": "Test description" }, "selfish": true, "name": "Another.Namespace.MyClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/classes/namespaced_class.coffee", "documentation": { "comment": "Test description", "summary": "Test description", "namespace": "Manual.Namespace" }, "name": "MyClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/classes/simple_class.coffee ================================================ class MyTestClass ================================================ FILE: spec/_templates/classes/simple_class.json ================================================ [ { "file": "spec/_templates/classes/simple_class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/classes/simple_class.coffee", "name": "MyTestClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/complicateds/methods.coffee ================================================ # @include Mixin # @extend Mixin # @concern Concern # # @method #x(key, value) # Sets a value # class Class z: -> # @mixin Mixin = m: -> # @mixin Concern = ClassMethods: cs: -> InstanceMethods: cd: -> class Subclass extends Class x: -> class Subsubclass extends Subclass y: -> ================================================ FILE: spec/_templates/complicateds/variables.coffee ================================================ class Class z: '123' class Subclass extends Class z: '456' class Subsubclass extends Subclass y: '123' ================================================ FILE: spec/_templates/environment/class.coffee ================================================ # # @include LookAndFeel # class Fluffy ================================================ FILE: spec/_templates/environment/mixin.coffee ================================================ # # @mixin # LookAndFeel = look: -> feel: -> ================================================ FILE: spec/_templates/environment/result.json ================================================ [ { "file": "spec/_templates/environment/class.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/environment/class.coffee", "documentation": { "comment": "", "summary": "", "includes": [ "LookAndFeel" ] }, "name": "Fluffy", "methods": [], "variables": [], "properties": [], "includes": [ { "file": "spec/_templates/environment/mixin.coffee", "name": "LookAndFeel", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/environment/mixin.coffee", "name": "look", "bound": false, "parameters": [] }, { "file": "spec/_templates/environment/mixin.coffee", "name": "feel", "bound": false, "parameters": [] } ], "variables": [] } ], "extends": [], "concerns": [] }, { "file": "spec/_templates/environment/mixin.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/environment/mixin.coffee", "name": "LookAndFeel", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/environment/mixin.coffee", "name": "look", "bound": false, "parameters": [] }, { "file": "spec/_templates/environment/mixin.coffee", "name": "feel", "bound": false, "parameters": [] } ], "variables": [] }, { "file": "spec/_templates/environment/mixin.coffee", "name": "look", "bound": false, "parameters": [] }, { "file": "spec/_templates/environment/mixin.coffee", "name": "feel", "bound": false, "parameters": [] } ] ================================================ FILE: spec/_templates/example/CHANGELOG ================================================ Changelog This project is actually so incredible that it never changes. Seriously!!! ================================================ FILE: spec/_templates/example/README.md ================================================ # Readme That's how we do it, this is how we do it (c) ================================================ FILE: spec/_templates/example/package.json ================================================ { "name": "example", "description": "The best ever project about lines and wildness!", "keywords": [ "coffeescript", "doc" ], "version": "0.1.0" } ================================================ FILE: spec/_templates/example/src/angry_animal.coffee ================================================ # Ola-la # @abstract TROLOLO = 'test' # @mixin Example.AngryAnimal = roar: -> # Ola-la once more # # @overload ?globalMethod(a, b) # Overload this animal for once! # # @deprecated Don't use it anymore! globalMethod = ({a, b}) -> ================================================ FILE: spec/_templates/example/src/animal.coffee ================================================ # Base class for all animals. # # @note This is not used for codo, its purpose is to show # all possible tags within a class. # # @todo Provide more examples # # @example How to subclass an animal # class Lion extends Animal # move: (direction, speed): -> # # @abstract Each animal implementation must inherit from {Animal} # # @author Michael Kessler # @deprecated This class is not used anymore # @version 0.2.0 # @since 0.1.0 # class Example.Animal # The Answer to the Ultimate Question of Life, the Universe, and Everything @ANSWER = 42 # Construct a new animal. # # @todo Clean up # @param [String] name the name of the animal # @param [Date] birthDate when the animal was born # constructor: (@name, @birthDate = new Date()) -> # Move the animal. # # @example Move an animal # new Lion('Simba').move('south', 12) # # @abstract # @param [Object] options the moving options # @option options [String] direction the moving direction # @option options [Number] speed the speed in mph # move: (options = {}) -> # Copulate another animal. # # @note Don't take it seriously # # @private # @author Michael Kessler # @param [Animal] animal the partner animal # @return [Boolean] true when success # @deprecated Do not copulate # @version 0.2.0 # @since 0.1.0 # copulate: (animal) => # Moves all animal into the ark. # # @return [Boolean] true when all in Ark # @enterArk: -> ================================================ FILE: spec/_templates/example/src/lion.coffee ================================================ # A dangerous lion. Take care. # # @author Simba # @see http://en.wikipedia.org/wiki/Lion # @include Example.AngryAnimal # @extend MissingMixin # class Example.Animal.Lion extends Example.Animal # Maximum speed in MPH @MAX_SPEED = 50 # Move the lion fast # # @param [String] direction the moving direction # @param [Number] speed the moving speed # move: (direction, speed) -> super({ diection: direction, speed: speed }) # Escape at maximum speed. # # @param (see #move) # escape: (direction) -> @move(direction, @MAX_SPEED) ================================================ FILE: spec/_templates/example/src/over_documented_class.coffee ================================================ # # This class is SO DOCUMENTED! Seriously, Just look at that! This is so incredible! # # It even has some links: {http://www.google.com Google for instance} {OverDocumentedClass} # {OverDocumentedClass itself} {http://www.github.com} {OverDocumentedMixin~mixed_method} # {Casper The ghost!} # # @abstract It's so abstract! ^_^ {http://www.github.com} # @author The great Yoda {http://www.github.com} # @include OverDocumentedMixin # @include Casper # @extend OverDocumentedMixin # @extend Casper # @copyright The great Yoda {http://www.github.com} # @deprecated Don't use this anymore!!11 # @example Foobar # foo = bar # @note Never fortget this thing! {http://www.github.com} # @method #virtual_method({a, b}) # This is the virtual method ZOMG # @private # @see www.github.com # @since 1.0 # @todo Run with the wolves {http://www.github.com} # @version 1.1 class OverDocumentedClass # The constant that is SO DOCUMENTED as well (I feel sick about it) # @abstract It's so abstract! ^_^ {http://www.github.com} # @author The great Yoda {http://www.github.com} # @copyright The great Yoda {http://www.github.com} # @deprecated Don't use this anymore!!11 # @example Foobar # foo = bar # @note Never fortget this thing! {http://www.github.com} # @private # @see www.github.com # @since 1.0 # @todo Run with the wolves {http://www.github.com} # @version 1.1 CONSTANT: foo: 'bar' # @property [OverDocumentedClass] Returns the {OverDocumentedClass clone}. @property 'clone', get: -> new OverDocumentedClass # @abstract It's so abstract! ^_^ {http://www.github.com} # @author The great Yoda {http://www.github.com} # @copyright The great Yoda {http://www.github.com} # @deprecated Don't use this anymore!!11 # @example Foobar # foo = bar # @note Never fortget this thing! {http://www.github.com} # @private # @see www.github.com # @since 1.0 # @todo Run with the wolves {http://www.github.com} # @version 1.1 # @throw [OverDocumentedClass] EXCEPTION OMG # @return [OverDocumentedClass] RETVAL OMG # @param [String] foo The first parameter # @param [Integer] bar The second parameter (all of a sudden) # @option options [String] option The only option (wtf?) # @event simpleEvent # @event notSoSimpleEvent Having description # @event complicatedEvent # Having description and parameters # @param [String] The string @class_method: (foo, bar, options={}) -> # @abstract It's so abstract! ^_^ {http://www.github.com} # @author The great Yoda {http://www.github.com} # @copyright The great Yoda {http://www.github.com} # @deprecated Don't use this anymore!!11 # @example Foobar # foo = bar # @note Never fortget this thing! {http://www.github.com} # @private # @see www.github.com # @since 1.0 # @todo Run with the wolves {http://www.github.com} # @version 1.1 # @throw [String] EXCEPTION OMG # @return [String] RETVAL OMG # @overload #instance_method(foo, bar) # Obviously you can omit the last parameter # @overload #instance_method(foo, bar, options) # Or you can set it! instance_method: (foo, bar, options={}) -> ================================================ FILE: spec/_templates/example/src/over_documented_mixin.coffee ================================================ # # This mixin is SO DOCUMENTED! Seriously, Just look at that! This is so incredible! # # It even has some links: {http://www.google.com Google for instance} {OverDocumentedMixin} # {OverDocumentedMixin itself} {http://www.github.com} {OverDocumentedClass.class_method} # {Casper The ghost!} # # @mixin # @abstract It's so abstract! ^_^ {http://www.github.com} # @author The great Yoda {http://www.github.com} # @copyright The great Yoda {http://www.github.com} # @deprecated Don't use this anymore!!11 # @example Foobar # foo = bar # @note Never fortget this thing! {http://www.github.com} # @method #virtual_method({a, b}) # This is the virtual method ZOMG # @private # @see www.github.com # @since 1.0 # @todo Run with the wolves {http://www.github.com} # @version 1.1 OverDocumentedMixin = mixed_method: -> ================================================ FILE: spec/_templates/extras/README ================================================ This is a test README ================================================ FILE: spec/_templates/extras/README.md ================================================ # This is a test README We even have some content here. [With links!](http://github.com) ## And nested menus And even more content ### Actually... I feel terribly sick writing this. It's like talking to myself. [With relative markdown links too](SomeOtherFile.md) ================================================ FILE: spec/_templates/files/non_class_file.coffee ================================================ # The greeting GREETING = 'Hay' # Hey, check this out! module.exports = FOO = 'Foo constant!' # Says hello to a person # # @param [String] name the name of the person # hello = (name) -> console.log GREETING, name # Says bye to a person # # @param [String] name the name of the person # bye = (name) -> console.log "Bye, bye #{ name }" # Say hi to a person # # @param [String] name the name of the person # module.exports.sayHi = (hi) -> console.log "Hi #{ hi}!" # A fooer for fooing foos. # # @note Foo module.exports = foo = (foos) -> logger.info 'Fooing...' ================================================ FILE: spec/_templates/files/non_class_file.json ================================================ [ { "file": "spec/_templates/files/non_class_file.coffee", "methods": [ { "file": "spec/_templates/files/non_class_file.coffee", "name": "hello", "bound": false, "documentation": { "comment": "Says hello to a person", "summary": "Says hello to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "name", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "bye", "bound": false, "documentation": { "comment": "Says bye to a person", "summary": "Says bye to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "name", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "sayHi", "bound": false, "documentation": { "comment": "Say hi to a person", "summary": "Say hi to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "hi", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "foo", "bound": false, "documentation": { "comment": "A fooer for fooing foos.", "summary": "A fooer for fooing foos.", "notes": [ "Foo" ] }, "parameters": [ { "name": "foos", "splat": false } ] } ], "variables": [ { "file": "spec/_templates/files/non_class_file.coffee", "name": "GREETING", "constant": true, "value": "'Hay'", "documentation": { "comment": "The greeting", "summary": "The greeting" } }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "FOO", "constant": true, "value": "'Foo constant!'", "documentation": { "comment": "Hey, check this out!", "summary": "Hey, check this out!" } } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "GREETING", "constant": true, "value": "'Hay'", "documentation": { "comment": "The greeting", "summary": "The greeting" } }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "FOO", "constant": true, "value": "'Foo constant!'", "documentation": { "comment": "Hey, check this out!", "summary": "Hey, check this out!" } }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "hello", "bound": false, "documentation": { "comment": "Says hello to a person", "summary": "Says hello to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "name", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "bye", "bound": false, "documentation": { "comment": "Says bye to a person", "summary": "Says bye to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "name", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "sayHi", "bound": false, "documentation": { "comment": "Say hi to a person", "summary": "Say hi to a person", "params": [ { "type": "String", "name": "name", "description": "the name of the person" } ] }, "parameters": [ { "name": "hi", "splat": false } ] }, { "file": "spec/_templates/files/non_class_file.coffee", "name": "foo", "bound": false, "documentation": { "comment": "A fooer for fooing foos.", "summary": "A fooer for fooing foos.", "notes": [ "Foo" ] }, "parameters": [ { "name": "foos", "splat": false } ] } ] ================================================ FILE: spec/_templates/methods/assigned_parameters.coffee ================================================ class TestAssignedParameters help: (@me) -> ================================================ FILE: spec/_templates/methods/assigned_parameters.json ================================================ [ { "file": "spec/_templates/methods/assigned_parameters.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/assigned_parameters.coffee", "name": "TestAssignedParameters", "methods": [ { "file": "spec/_templates/methods/assigned_parameters.coffee", "name": "help", "bound": false, "kind": "dynamic", "parameters": [ { "name": "me", "splat": false } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/assigned_parameters.coffee", "name": "help", "bound": false, "kind": "dynamic", "parameters": [ { "name": "me", "splat": false } ] } ] ================================================ FILE: spec/_templates/methods/class_methods.coffee ================================================ class TestClassMethods @helper: -> @another: (a, b) -> @withDefault: (a = 2, c, d = 'hi', d, e = { a: 2 }, f = new TestClassMethods()) -> @nowWithSpalt: (foo, bar...) -> @andSoDoesThis = (foo, bar) -> ================================================ FILE: spec/_templates/methods/class_methods.json ================================================ [ { "file": "spec/_templates/methods/class_methods.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "TestClassMethods", "methods": [ { "file": "spec/_templates/methods/class_methods.coffee", "name": "helper", "bound": false, "selfish": true, "kind": "static", "parameters": [] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "another", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "withDefault", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "a", "splat": false, "default": "2" }, { "name": "c", "splat": false }, { "name": "d", "splat": false, "default": "'hi'" }, { "name": "d", "splat": false }, { "name": "e", "splat": false, "default": "{\n a: 2\n}" }, { "name": "f", "splat": false, "default": "new TestClassMethods()" } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "nowWithSpalt", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "andSoDoesThis", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": false } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "helper", "bound": false, "selfish": true, "kind": "static", "parameters": [] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "another", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "withDefault", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "a", "splat": false, "default": "2" }, { "name": "c", "splat": false }, { "name": "d", "splat": false, "default": "'hi'" }, { "name": "d", "splat": false }, { "name": "e", "splat": false, "default": "{\n a: 2\n}" }, { "name": "f", "splat": false, "default": "new TestClassMethods()" } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "a", "constant": false, "value": "2" }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "nowWithSpalt", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] }, { "file": "spec/_templates/methods/class_methods.coffee", "name": "andSoDoesThis", "bound": false, "selfish": true, "kind": "static", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": false } ] } ] ================================================ FILE: spec/_templates/methods/curly_method_documentation.coffee ================================================ class App.TestMethodDocumentation extends App.Doc # Should be overloaded to change fetch limit. # # @return Number of items per fetch # fetchLimit: () -> 5 # Do it! # # @see #undo for more information # # @private # @param {String} it The thing to do # @param again {Boolean} Do it again # @param {Object} options The do options # @option options {String} speed The speed # @option options {Number} repeat How wany time to repeat # @option options {Array} tasks The tasks to do # @return {Boolean} When successful executed # do: (it, again, options) -> # Do it! # # @see #undo for more information # # @private # @param {String} it The thing to do # @param again {Boolean} Do it again # @param {Object} options The do options # @option options {String} speed The speed # @option options {Number} repeat How wany time to repeat # @option options {Array} tasks The tasks to do # @return {Boolean} When successful executed # doWithoutSpace:(it, again, options)-> # Do it! # # @see {#undo} for more information # # @private # @param {String} it The thing to do # @param {Object} options The do options # @option options {String} speed The speed # @option options {Number} repeat How wany time to repeat # @option options {Array} tasks The tasks to do # @return {Boolean} When successful executed # @lets_do_it = (it, options) -> ================================================ FILE: spec/_templates/methods/curly_method_documentation.json ================================================ [ { "file": "spec/_templates/methods/curly_method_documentation.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "App.TestMethodDocumentation", "parent": "App.Doc", "methods": [ { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "fetchLimit", "bound": false, "documentation": { "comment": "Should be overloaded to change fetch limit.", "summary": "Should be overloaded to change fetch limit.", "returns": { "type": "?", "description": "Number of items per fetch" } }, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "do", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "doWithoutSpace", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "lets_do_it", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "{#undo}", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "selfish": true, "kind": "static", "parameters": [ { "name": "it", "splat": false }, { "name": "options", "splat": false } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "fetchLimit", "bound": false, "documentation": { "comment": "Should be overloaded to change fetch limit.", "summary": "Should be overloaded to change fetch limit.", "returns": { "type": "?", "description": "Number of items per fetch" } }, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "do", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "doWithoutSpace", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/curly_method_documentation.coffee", "name": "lets_do_it", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "{#undo}", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "selfish": true, "kind": "static", "parameters": [ { "name": "it", "splat": false }, { "name": "options", "splat": false } ] } ] ================================================ FILE: spec/_templates/methods/dynamic_methods.coffee ================================================ # This class has virtual methods, which doesn't # exist in the source but appears in the documentation. # # @method #set(key, value) # Sets a value # @param [String] key describe key param # @param [Object] value describe value param # @option value [String] string # @option value [Integer] number # @option value [Object] whatever # # @method .get(key) # Gets a value # @param [String] key describe key param # @return [Object] describe value param # # @method #delete({key, passion}, foo='bar') # Deletes a key from the data. # # Another line # # @param [String] key describe key param # # @example Delete a key. # emv = new Example.Methods.Virtual # emv.set 'foo', 'bar' # val = emv.get 'foo' # # # now, proclaim you're done with foo. # emv.delete 'foo' # # This line should be part of the class description, and the method declaration # shouldn't have messed it up. # class Example.Methods.Virtual ================================================ FILE: spec/_templates/methods/dynamic_methods.json ================================================ [ { "file": "spec/_templates/methods/dynamic_methods.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/dynamic_methods.coffee", "documentation": { "comment": "This class has virtual methods, which doesn't\nexist in the source but appears in the documentation.\n\nThis line should be part of the class description, and the method declaration\nshouldn't have messed it up.", "summary": "This class has virtual methods, which doesn't\nexist in the source but appears in the documentation.", "methods": [ { "signature": "#set(key, value)", "documentation": { "params": [ { "type": "String", "name": "key", "description": "describe key param" }, { "type": "Object", "name": "value", "description": "describe value param" } ], "options": { "value": [ { "type": "String", "name": "string" }, { "type": "Integer", "name": "number" }, { "type": "Object", "name": "whatever" } ] }, "comment": "Sets a value", "summary": "Sets a value" } }, { "signature": ".get(key)", "documentation": { "params": [ { "type": "String", "name": "key", "description": "describe key param" } ], "returns": { "type": "Object", "description": "describe value param" }, "comment": "Gets a value", "summary": "Gets a value" } }, { "signature": "#delete({key, passion}, foo='bar')", "documentation": { "params": [ { "type": "String", "name": "key", "description": "describe key param" } ], "examples": [ { "title": "Delete a key.", "code": "emv = new Example.Methods.Virtual\nemv.set 'foo', 'bar'\nval = emv.get 'foo'\n\n# now, proclaim you're done with foo.\nemv.delete 'foo'" } ], "comment": "Deletes a key from the data.\n\nAnother line", "summary": "Deletes a key from the data." } } ] }, "name": "Example.Methods.Virtual", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/methods/instance_methods.coffee ================================================ class TestInstanceMethods helper: -> another: (param, obj) -> anotherWithValues: (param = 123, obj = { a: 1 }, yup, comp = new TestInstanceMethods()) -> nowWithSpalt: (foo, bar...) -> bound: => # This is not exposed to the outside world. internalToClassClosure = -> alert 'internal!' ================================================ FILE: spec/_templates/methods/instance_methods.json ================================================ [ { "file": "spec/_templates/methods/instance_methods.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "TestInstanceMethods", "methods": [ { "file": "spec/_templates/methods/instance_methods.coffee", "name": "helper", "bound": false, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "another", "bound": false, "kind": "dynamic", "parameters": [ { "name": "param", "splat": false }, { "name": "obj", "splat": false } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "anotherWithValues", "bound": false, "kind": "dynamic", "parameters": [ { "name": "param", "splat": false, "default": "123" }, { "name": "obj", "splat": false, "default": "{\n a: 1\n}" }, { "name": "yup", "splat": false }, { "name": "comp", "splat": false, "default": "new TestInstanceMethods()" } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "nowWithSpalt", "bound": false, "kind": "dynamic", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "bound", "bound": true, "kind": "dynamic", "parameters": [] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "helper", "bound": false, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "another", "bound": false, "kind": "dynamic", "parameters": [ { "name": "param", "splat": false }, { "name": "obj", "splat": false } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "anotherWithValues", "bound": false, "kind": "dynamic", "parameters": [ { "name": "param", "splat": false, "default": "123" }, { "name": "obj", "splat": false, "default": "{\n a: 1\n}" }, { "name": "yup", "splat": false }, { "name": "comp", "splat": false, "default": "new TestInstanceMethods()" } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "a", "constant": false, "value": "1" }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "nowWithSpalt", "bound": false, "kind": "dynamic", "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "bound", "bound": true, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/instance_methods.coffee", "name": "internalToClassClosure", "bound": false, "documentation": { "comment": "This is not exposed to the outside world.", "summary": "This is not exposed to the outside world." }, "parameters": [] } ] ================================================ FILE: spec/_templates/methods/method_documentation.coffee ================================================ class App.TestMethodDocumentation extends App.Doc # Should be overloaded to change fetch limit. # # @public # @return Number of items per fetch # fetchLimit: () -> 5 # Do it! # # @see #undo for more information # # @private # @param [String] it The thing to do # @param again [Boolean] Do it again # @param [Object] options The do options # @option options [String] speed The speed # @option options [Number] repeat How wany time to repeat # @option options [Array] tasks The tasks to do # @return [Boolean] When successful executed # @throw [TypeError] when it can't be done # do: (it, again, options) -> # Do it! # # @see #undo for more information # # @private # @param [String] it The thing to do # @param again [Boolean] Do it again # @param [Object] options The do options # @option options [String] speed The speed # @option options [Number] repeat How wany time to repeat # @option options [Array] tasks The tasks to do # @return [Boolean] When successful executed # doWithoutSpace:(it, again, options)-> # Do it! # # @see {#undo} for more information # # @private # @param [String] it The thing to do # @param [Object] options The do options # @option options [String] speed The speed # @option options [Number] repeat How wany time to repeat # @option options [Array] tasks The tasks to do # @return [Boolean] When successful executed # @lets_do_it = (it, options) -> ================================================ FILE: spec/_templates/methods/method_documentation.json ================================================ [ { "file": "spec/_templates/methods/method_documentation.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "App.TestMethodDocumentation", "parent": "App.Doc", "methods": [ { "file": "spec/_templates/methods/method_documentation.coffee", "name": "fetchLimit", "bound": false, "documentation": { "comment": "Should be overloaded to change fetch limit.", "summary": "Should be overloaded to change fetch limit.", "public": true, "returns": { "type": "?", "description": "Number of items per fetch" } }, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "do", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" }, "throws": [ { "type": "TypeError", "description": "when it can't be done" } ] }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "doWithoutSpace", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "lets_do_it", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "{#undo}", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "selfish": true, "kind": "static", "parameters": [ { "name": "it", "splat": false }, { "name": "options", "splat": false } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "fetchLimit", "bound": false, "documentation": { "comment": "Should be overloaded to change fetch limit.", "summary": "Should be overloaded to change fetch limit.", "public": true, "returns": { "type": "?", "description": "Number of items per fetch" } }, "kind": "dynamic", "parameters": [] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "do", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" }, "throws": [ { "type": "TypeError", "description": "when it can't be done" } ] }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "doWithoutSpace", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "#undo", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Boolean", "name": "again", "description": "Do it again" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "kind": "dynamic", "parameters": [ { "name": "it", "splat": false }, { "name": "again", "splat": false }, { "name": "options", "splat": false } ] }, { "file": "spec/_templates/methods/method_documentation.coffee", "name": "lets_do_it", "bound": false, "documentation": { "comment": "Do it!", "summary": "Do it!", "see": [ { "reference": "{#undo}", "label": "for more information" } ], "private": true, "params": [ { "type": "String", "name": "it", "description": "The thing to do" }, { "type": "Object", "name": "options", "description": "The do options" } ], "options": { "options": [ { "type": "String", "name": "speed", "description": "The speed" }, { "type": "Number", "name": "repeat", "description": "How wany time to repeat" }, { "type": "Array", "name": "tasks", "description": "The tasks to do" } ] }, "returns": { "type": "Boolean", "description": "When successful executed" } }, "selfish": true, "kind": "static", "parameters": [ { "name": "it", "splat": false }, { "name": "options", "splat": false } ] } ] ================================================ FILE: spec/_templates/methods/method_events.coffee ================================================ class Example.Events # This is a generic Events emit method. # # @event theBasic.One # @event theWeirdOne Omg this event is so weird o_O # @event theComplicatedOne # This is the complicated event yo # @param [String] the incredible string # # This should be more description for the method itself, and events # shouldn't have messed it up. # emit: (args...) -> ================================================ FILE: spec/_templates/methods/method_events.json ================================================ [ { "file": "spec/_templates/methods/method_events.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/method_events.coffee", "name": "Example.Events", "methods": [ { "file": "spec/_templates/methods/method_events.coffee", "name": "emit", "bound": false, "documentation": { "comment": "This is a generic Events emit method.\n\nThis should be more description for the method itself, and events\nshouldn't have messed it up.", "summary": "This is a generic Events emit method.", "events": [ { "name": "theBasic.One", "documentation": { "comment": "", "summary": "" } }, { "name": "theWeirdOne", "documentation": { "comment": "Omg this event is so weird o_O", "summary": "Omg this event is so weird o_O" } }, { "name": "theComplicatedOne", "documentation": { "params": [ { "type": "String", "name": "the", "description": "incredible string" } ], "comment": "This is the complicated event yo", "summary": "This is the complicated event yo" } } ] }, "kind": "dynamic", "parameters": [ { "name": "args", "splat": true } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/method_events.coffee", "name": "emit", "bound": false, "documentation": { "comment": "This is a generic Events emit method.\n\nThis should be more description for the method itself, and events\nshouldn't have messed it up.", "summary": "This is a generic Events emit method.", "events": [ { "name": "theBasic.One", "documentation": { "comment": "", "summary": "" } }, { "name": "theWeirdOne", "documentation": { "comment": "Omg this event is so weird o_O", "summary": "Omg this event is so weird o_O" } }, { "name": "theComplicatedOne", "documentation": { "params": [ { "type": "String", "name": "the", "description": "incredible string" } ], "comment": "This is the complicated event yo", "summary": "This is the complicated event yo" } } ] }, "kind": "dynamic", "parameters": [ { "name": "args", "splat": true } ] } ] ================================================ FILE: spec/_templates/methods/method_example.coffee ================================================ class TestExample # @example Run generation # codo = require 'codo' # # file = (filename, content) -> # console.log "New file %s with content %s", filename, content # # done = (err) -> # if err # console.log "Cannot generate documentation:", err # else # console.log "Documentation generated" # # codo.run file, done run: -> ================================================ FILE: spec/_templates/methods/method_example.json ================================================ [ { "file": "spec/_templates/methods/method_example.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/method_example.coffee", "name": "TestExample", "methods": [ { "file": "spec/_templates/methods/method_example.coffee", "name": "run", "bound": false, "documentation": { "comment": "", "summary": "", "examples": [ { "title": "Run generation", "code": "codo = require 'codo'\n\nfile = (filename, content) ->\n console.log \"New file %s with content %s\", filename, content\n\ndone = (err) ->\n if err\n console.log \"Cannot generate documentation:\", err\n else\n console.log \"Documentation generated\"\n\ncodo.run file, done" } ] }, "kind": "dynamic", "parameters": [] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/method_example.coffee", "name": "run", "bound": false, "documentation": { "comment": "", "summary": "", "examples": [ { "title": "Run generation", "code": "codo = require 'codo'\n\nfile = (filename, content) ->\n console.log \"New file %s with content %s\", filename, content\n\ndone = (err) ->\n if err\n console.log \"Cannot generate documentation:\", err\n else\n console.log \"Documentation generated\"\n\ncodo.run file, done" } ] }, "kind": "dynamic", "parameters": [] } ] ================================================ FILE: spec/_templates/methods/named_parameters.coffee ================================================ class TestNamedParameters constructor : ({@cat, @dog, eel}, @fish, gorilla = 400, hog...) -> burp : ({a, b, c}, e = 20, {f, g, h}, i = 10) -> ================================================ FILE: spec/_templates/methods/named_parameters.json ================================================ [ { "file": "spec/_templates/methods/named_parameters.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/named_parameters.coffee", "name": "TestNamedParameters", "methods": [ { "file": "spec/_templates/methods/named_parameters.coffee", "name": "constructor", "bound": false, "kind": "dynamic", "parameters": [ { "name": "{cat, dog, eel}", "splat": false }, { "name": "fish", "splat": false }, { "name": "gorilla", "splat": false, "default": "400" }, { "name": "hog", "splat": true } ] }, { "file": "spec/_templates/methods/named_parameters.coffee", "name": "burp", "bound": false, "kind": "dynamic", "parameters": [ { "name": "{a, b, c}", "splat": false }, { "name": "e", "splat": false, "default": "20" }, { "name": "{f, g, h}", "splat": false }, { "name": "i", "splat": false, "default": "10" } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/named_parameters.coffee", "name": "constructor", "bound": false, "kind": "dynamic", "parameters": [ { "name": "{cat, dog, eel}", "splat": false }, { "name": "fish", "splat": false }, { "name": "gorilla", "splat": false, "default": "400" }, { "name": "hog", "splat": true } ] }, { "file": "spec/_templates/methods/named_parameters.coffee", "name": "burp", "bound": false, "kind": "dynamic", "parameters": [ { "name": "{a, b, c}", "splat": false }, { "name": "e", "splat": false, "default": "20" }, { "name": "{f, g, h}", "splat": false }, { "name": "i", "splat": false, "default": "10" } ] } ] ================================================ FILE: spec/_templates/methods/overload_method.coffee ================================================ class Example.Overload # This is a generic Store set method. # # @overload set(key, value) # Sets a value on key # @param [Symbol] key describe key param # @param [Object] value describe value param # @param [Object] options the options # @option options test [String] the test option # # @overload set(value) # # Sets a value on the default key `:foo` # # @param [Object] value describe value param # @return [Boolean] true when success # # This should be more description for the method itself, and overload # shouldn't have messed it up. # set: (args...) -> ================================================ FILE: spec/_templates/methods/overload_method.json ================================================ [ { "file": "spec/_templates/methods/overload_method.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/methods/overload_method.coffee", "name": "Example.Overload", "methods": [ { "file": "spec/_templates/methods/overload_method.coffee", "name": "set", "bound": false, "documentation": { "comment": "This is a generic Store set method.\n\nThis should be more description for the method itself, and overload\nshouldn't have messed it up.", "summary": "This is a generic Store set method.", "overloads": [ { "signature": "set(key, value)", "documentation": { "params": [ { "type": "Symbol", "name": "key", "description": "describe key param" }, { "type": "Object", "name": "value", "description": "describe value param" }, { "type": "Object", "name": "options", "description": "the options" } ], "options": { "options": [ { "type": "String", "name": "test", "description": "the test option" } ] }, "comment": "Sets a value on key", "summary": "Sets a value on key" } }, { "signature": "set(value)", "documentation": { "params": [ { "type": "Object", "name": "value", "description": "describe value param" } ], "returns": { "type": "Boolean", "description": "true when success" }, "comment": "Sets a value on the default key `:foo`", "summary": "Sets a value on the default key `:foo`" } } ] }, "kind": "dynamic", "parameters": [ { "name": "args", "splat": true } ] } ], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/methods/overload_method.coffee", "name": "set", "bound": false, "documentation": { "comment": "This is a generic Store set method.\n\nThis should be more description for the method itself, and overload\nshouldn't have messed it up.", "summary": "This is a generic Store set method.", "overloads": [ { "signature": "set(key, value)", "documentation": { "params": [ { "type": "Symbol", "name": "key", "description": "describe key param" }, { "type": "Object", "name": "value", "description": "describe value param" }, { "type": "Object", "name": "options", "description": "the options" } ], "options": { "options": [ { "type": "String", "name": "test", "description": "the test option" } ] }, "comment": "Sets a value on key", "summary": "Sets a value on key" } }, { "signature": "set(value)", "documentation": { "params": [ { "type": "Object", "name": "value", "description": "describe value param" } ], "returns": { "type": "Boolean", "description": "true when success" }, "comment": "Sets a value on the default key `:foo`", "summary": "Sets a value on the default key `:foo`" } } ] }, "kind": "dynamic", "parameters": [ { "name": "args", "splat": true } ] } ] ================================================ FILE: spec/_templates/mixins/concern.coffee ================================================ # This is my concern # @mixin Example.Mixins.Concern = ClassMethods: # @param [String] a This is the a parameter # @param [String] b This is the a parameter # @param [String] c This is the a parameter a: (a, b, c) -> # @param [String] x This is the x parameter # @param [String] y This is the y parameter # @param [String] z This is the z parameter z: (x, y, z) -> InstanceMethods: # Say hi # @param [String] to the name hi: (to) -> # Say goodbye # @param [String] to the name goodbye: (to) -> # @concern Example.Mixins.Concern class Example.Concern ================================================ FILE: spec/_templates/mixins/concern.json ================================================ [ { "file": "spec/_templates/mixins/concern.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "Example.Mixins.Concern", "concern": true, "documentation": { "comment": "This is my concern", "summary": "This is my concern" }, "methods": [], "classMethods": [ { "file": "spec/_templates/mixins/concern.coffee", "name": "a", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "a", "description": "This is the a parameter" }, { "type": "String", "name": "b", "description": "This is the a parameter" }, { "type": "String", "name": "c", "description": "This is the a parameter" } ] }, "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false }, { "name": "c", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "z", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "x", "description": "This is the x parameter" }, { "type": "String", "name": "y", "description": "This is the y parameter" }, { "type": "String", "name": "z", "description": "This is the z parameter" } ] }, "parameters": [ { "name": "x", "splat": false }, { "name": "y", "splat": false }, { "name": "z", "splat": false } ] } ], "instanceMethods": [ { "file": "spec/_templates/mixins/concern.coffee", "name": "hi", "bound": false, "documentation": { "comment": "Say hi", "summary": "Say hi", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "goodbye", "bound": false, "documentation": { "comment": "Say goodbye", "summary": "Say goodbye", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] } ], "variables": [] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "ClassMethods", "constant": false, "value": "{\n\n /*\n @param [String] a This is the a parameter\n @param [String] b This is the a parameter\n @param [String] c This is the a parameter\n */\n a: function(a, b, c) {},\n\n /*\n @param [String] x This is the x parameter\n @param [String] y This is the y parameter\n @param [String] z This is the z parameter\n */\n z: function(x, y, z) {}\n}" }, { "file": "spec/_templates/mixins/concern.coffee", "name": "a", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "a", "description": "This is the a parameter" }, { "type": "String", "name": "b", "description": "This is the a parameter" }, { "type": "String", "name": "c", "description": "This is the a parameter" } ] }, "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false }, { "name": "c", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "z", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "x", "description": "This is the x parameter" }, { "type": "String", "name": "y", "description": "This is the y parameter" }, { "type": "String", "name": "z", "description": "This is the z parameter" } ] }, "parameters": [ { "name": "x", "splat": false }, { "name": "y", "splat": false }, { "name": "z", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "InstanceMethods", "constant": false, "value": "{\n\n /*\n Say hi\n @param [String] to the name\n */\n hi: function(to) {},\n\n /*\n Say goodbye\n @param [String] to the name\n */\n goodbye: function(to) {}\n}" }, { "file": "spec/_templates/mixins/concern.coffee", "name": "hi", "bound": false, "documentation": { "comment": "Say hi", "summary": "Say hi", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "goodbye", "bound": false, "documentation": { "comment": "Say goodbye", "summary": "Say goodbye", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "documentation": { "comment": "", "summary": "", "concerns": [ "Example.Mixins.Concern" ] }, "name": "Example.Concern", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [], "concerns": [ { "file": "spec/_templates/mixins/concern.coffee", "name": "Example.Mixins.Concern", "concern": true, "documentation": { "comment": "This is my concern", "summary": "This is my concern" }, "methods": [], "classMethods": [ { "file": "spec/_templates/mixins/concern.coffee", "name": "a", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "a", "description": "This is the a parameter" }, { "type": "String", "name": "b", "description": "This is the a parameter" }, { "type": "String", "name": "c", "description": "This is the a parameter" } ] }, "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false }, { "name": "c", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "z", "bound": false, "documentation": { "comment": "", "summary": "", "params": [ { "type": "String", "name": "x", "description": "This is the x parameter" }, { "type": "String", "name": "y", "description": "This is the y parameter" }, { "type": "String", "name": "z", "description": "This is the z parameter" } ] }, "parameters": [ { "name": "x", "splat": false }, { "name": "y", "splat": false }, { "name": "z", "splat": false } ] } ], "instanceMethods": [ { "file": "spec/_templates/mixins/concern.coffee", "name": "hi", "bound": false, "documentation": { "comment": "Say hi", "summary": "Say hi", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] }, { "file": "spec/_templates/mixins/concern.coffee", "name": "goodbye", "bound": false, "documentation": { "comment": "Say goodbye", "summary": "Say goodbye", "params": [ { "type": "String", "name": "to", "description": "the name" } ] }, "parameters": [ { "name": "to", "splat": false } ] } ], "variables": [] } ] } ] ================================================ FILE: spec/_templates/mixins/extend_mixin.coffee ================================================ # @mixin Name.Space.MyMixin = hello: -> goodbye: -> # @extend Name.Space.MyMixin class SomeNamespace.MyClass ================================================ FILE: spec/_templates/mixins/extend_mixin.json ================================================ [ { "file": "spec/_templates/mixins/extend_mixin.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "Name.Space.MyMixin", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] } ], "variables": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "documentation": { "comment": "", "summary": "", "extends": [ "Name.Space.MyMixin" ] }, "name": "SomeNamespace.MyClass", "methods": [], "variables": [], "properties": [], "includes": [], "extends": [ { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "Name.Space.MyMixin", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/extend_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] } ], "variables": [] } ], "concerns": [] } ] ================================================ FILE: spec/_templates/mixins/include_mixin.coffee ================================================ # @mixin Name.Space.MyMixin = hello: -> goodbye: -> # @include Name.Space.MyMixin class SomeNamespace.MyClass ================================================ FILE: spec/_templates/mixins/include_mixin.json ================================================ [ { "file": "spec/_templates/mixins/include_mixin.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "Name.Space.MyMixin", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] } ], "variables": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "documentation": { "comment": "", "summary": "", "includes": [ "Name.Space.MyMixin" ] }, "name": "SomeNamespace.MyClass", "methods": [], "variables": [], "properties": [], "includes": [ { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "Name.Space.MyMixin", "documentation": { "comment": "", "summary": "" }, "methods": [ { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "hello", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/include_mixin.coffee", "name": "goodbye", "bound": false, "parameters": [] } ], "variables": [] } ], "extends": [], "concerns": [] } ] ================================================ FILE: spec/_templates/mixins/missing_mixins.coffee ================================================ # @include Name.Space.MyMixin # @extend Name.Space.MyMixin class SomeNamespace.MyClass ================================================ FILE: spec/_templates/mixins/missing_mixins.json ================================================ [ { "file": "spec/_templates/mixins/missing_mixins.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/missing_mixins.coffee", "documentation": { "comment": "", "summary": "", "includes": [ "Name.Space.MyMixin" ], "extends": [ "Name.Space.MyMixin" ] }, "name": "SomeNamespace.MyClass", "methods": [], "variables": [], "properties": [], "includes": [ "Name.Space.MyMixin" ], "extends": [ "Name.Space.MyMixin" ], "concerns": [] } ] ================================================ FILE: spec/_templates/mixins/mixin_documentation.coffee ================================================ # This is a test module with `inline.dot`. Beware. # # @note Please use # this carefully # @note For internal use only # # @example Use it in this way # class Rumba # @include Foo.Bar # # @todo Clean up socket handler # @todo Refactor # property factory # @author Netzpirat # @author Supermakaka # @abstract Each listener implementation must include # @private # @deprecated Use other module # which is thread safe # @since 1.0.0 # @version 1.0.2 # # @namespace Manual.Namespace # @mixin # Foo.Bar = {} ================================================ FILE: spec/_templates/mixins/mixin_documentation.json ================================================ [ { "file": "spec/_templates/mixins/mixin_documentation.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/mixin_documentation.coffee", "name": "Foo.Bar", "documentation": { "comment": "This is a test module with `inline.dot`. Beware.", "summary": "This is a test module with `inline.dot`.", "notes": [ "Please use this carefully", "For internal use only" ], "abstract": "Each listener implementation must include", "private": true, "deprecated": "Use other module which is thread safe", "version": "1.0.2", "since": "1.0.0", "authors": [ "Netzpirat", "Supermakaka" ], "todos": [ "Clean up socket handler", "Refactor property factory" ], "examples": [ { "title": "Use it in this way", "code": "class Rumba\n @include Foo.Bar" } ], "namespace": "Manual.Namespace" }, "methods": [], "variables": [] } ] ================================================ FILE: spec/_templates/mixins/mixin_methods.coffee ================================================ # # @method #set(key, value) # Sets a value # @param [String] key describe key param # @param [Object] value describe value param # @option value [String] string # @option value [Integer] number # @option value [Object] whatever # # @mixin Foo = helper: -> another: (a, b) -> withDefault: (a = 2, c, d = 'hi', d, e = { a: 2 }, f = new TestClassMethods()) -> nowWithSpalt: (foo, bar...) -> ================================================ FILE: spec/_templates/mixins/mixin_methods.json ================================================ [ { "file": "spec/_templates/mixins/mixin_methods.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "Foo", "documentation": { "comment": "", "summary": "", "methods": [ { "signature": "#set(key, value)", "documentation": { "params": [ { "type": "String", "name": "key", "description": "describe key param" }, { "type": "Object", "name": "value", "description": "describe value param" } ], "options": { "value": [ { "type": "String", "name": "string" }, { "type": "Integer", "name": "number" }, { "type": "Object", "name": "whatever" } ] }, "comment": "Sets a value", "summary": "Sets a value" } } ] }, "methods": [ { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "helper", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "another", "bound": false, "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false } ] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "withDefault", "bound": false, "parameters": [ { "name": "a", "splat": false, "default": "2" }, { "name": "c", "splat": false }, { "name": "d", "splat": false, "default": "'hi'" }, { "name": "d", "splat": false }, { "name": "e", "splat": false, "default": "{\n a: 2\n}" }, { "name": "f", "splat": false, "default": "new TestClassMethods()" } ] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "nowWithSpalt", "bound": false, "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] } ], "variables": [] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "helper", "bound": false, "parameters": [] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "another", "bound": false, "parameters": [ { "name": "a", "splat": false }, { "name": "b", "splat": false } ] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "withDefault", "bound": false, "parameters": [ { "name": "a", "splat": false, "default": "2" }, { "name": "c", "splat": false }, { "name": "d", "splat": false, "default": "'hi'" }, { "name": "d", "splat": false }, { "name": "e", "splat": false, "default": "{\n a: 2\n}" }, { "name": "f", "splat": false, "default": "new TestClassMethods()" } ] }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "a", "constant": false, "value": "2" }, { "file": "spec/_templates/mixins/mixin_methods.coffee", "name": "nowWithSpalt", "bound": false, "parameters": [ { "name": "foo", "splat": false }, { "name": "bar", "splat": true } ] } ] ================================================ FILE: spec/_templates/properties/properties.coffee ================================================ # Property test class. It's almost the most difficult # part to come up with stupid examples. # module.exports = class Person # @property [Array] The nicknames # # All the nicknames the person is known by. nicknames: [] # @property [Object] # The entity's position position: x: 0 y: 0 # Language helpers get = (props) => @::__defineGetter__ name, getter for name, getter of props set = (props) => @::__defineSetter__ name, setter for name, setter of props # @property [String] The first name get firstname: -> @_firstname set firstname: (@_firstname) -> # The last name get lastname: -> @_lastname set lastname: (@_lastname) -> # @property [Date] The day # (of birth) get birth: -> @_birth # The twitter handle get twitter: -> @_twitter # @property [String] The confession set confession: (@_confession) -> # @property [String] Something different @property 'test', get: -> 'test' set: (k,v) -> # @property [String] Something different 2 @property 'test2', -> 'test' # @property [String] Something different 3 @property 'test3', set: -> 'test' # The email address offer set email: (@_email) -> # This should not be swallowed test: -> ================================================ FILE: spec/_templates/properties/properties.json ================================================ [ { "file": "spec/_templates/properties/properties.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/properties/properties.coffee", "documentation": { "comment": "Property test class. It's almost the most difficult\npart to come up with stupid examples.", "summary": "Property test class." }, "name": "Person", "methods": [ { "file": "spec/_templates/properties/properties.coffee", "name": "test", "bound": false, "documentation": { "comment": "This should not be swallowed", "summary": "This should not be swallowed" }, "kind": "dynamic", "parameters": [] } ], "variables": [], "properties": [ { "file": "spec/_templates/properties/properties.coffee", "name": "nicknames", "getter": true, "setter": true, "documentation": { "comment": "The nicknames\n\nAll the nicknames the person is known by.", "summary": "The nicknames\n\nAll the nicknames the person is known by.", "property": "Array" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "position", "getter": true, "setter": true, "documentation": { "comment": "The entity's position", "summary": "The entity's position", "property": "Object" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "firstname", "getter": true, "setter": true, "documentation": { "comment": "The first name", "summary": "The first name", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "lastname", "getter": true, "setter": true, "documentation": { "comment": "The last name", "summary": "The last name" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "birth", "getter": true, "setter": false, "documentation": { "comment": "The day (of birth)", "summary": "The day (of birth)", "property": "Date" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "twitter", "getter": true, "setter": false, "documentation": { "comment": "The twitter handle", "summary": "The twitter handle" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "confession", "getter": false, "setter": true, "documentation": { "comment": "The confession", "summary": "The confession", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "test", "getter": true, "setter": true, "documentation": { "comment": "Something different", "summary": "Something different", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "test2", "getter": true, "setter": false, "documentation": { "comment": "Something different 2", "summary": "Something different 2", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "test3", "getter": false, "setter": true, "documentation": { "comment": "Something different 3", "summary": "Something different 3", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "email", "getter": false, "setter": true, "documentation": { "comment": "The email address offer", "summary": "The email address offer" } } ], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "nicknames", "getter": true, "setter": true, "documentation": { "comment": "The nicknames\n\nAll the nicknames the person is known by.", "summary": "The nicknames\n\nAll the nicknames the person is known by.", "property": "Array" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "position", "getter": true, "setter": true, "documentation": { "comment": "The entity's position", "summary": "The entity's position", "property": "Object" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "x", "constant": false, "value": "0" }, { "file": "spec/_templates/properties/properties.coffee", "name": "y", "constant": false, "value": "0" }, { "file": "spec/_templates/properties/properties.coffee", "name": "get", "bound": true, "documentation": { "comment": "Language helpers", "summary": "Language helpers" }, "parameters": [ { "name": "props", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "set", "bound": true, "parameters": [ { "name": "props", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "firstname", "getter": true, "setter": true, "documentation": { "comment": "The first name", "summary": "The first name", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "firstname", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "firstname", "getter": true, "setter": true, "documentation": { "comment": "The first name", "summary": "The first name", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "firstname", "bound": false, "parameters": [ { "name": "_firstname", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "lastname", "getter": true, "setter": true, "documentation": { "comment": "The last name", "summary": "The last name" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "lastname", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "lastname", "getter": true, "setter": true, "documentation": { "comment": "The last name", "summary": "The last name" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "lastname", "bound": false, "parameters": [ { "name": "_lastname", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "birth", "getter": true, "setter": false, "documentation": { "comment": "The day (of birth)", "summary": "The day (of birth)", "property": "Date" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "birth", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "twitter", "getter": true, "setter": false, "documentation": { "comment": "The twitter handle", "summary": "The twitter handle" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "twitter", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "confession", "getter": false, "setter": true, "documentation": { "comment": "The confession", "summary": "The confession", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "confession", "bound": false, "parameters": [ { "name": "_confession", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "test", "getter": true, "setter": true, "documentation": { "comment": "Something different", "summary": "Something different", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "get", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "set", "bound": false, "parameters": [ { "name": "k", "splat": false }, { "name": "v", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "test2", "getter": true, "setter": false, "documentation": { "comment": "Something different 2", "summary": "Something different 2", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "test3", "getter": false, "setter": true, "documentation": { "comment": "Something different 3", "summary": "Something different 3", "property": "String" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "set", "bound": false, "parameters": [] }, { "file": "spec/_templates/properties/properties.coffee", "name": "email", "getter": false, "setter": true, "documentation": { "comment": "The email address offer", "summary": "The email address offer" } }, { "file": "spec/_templates/properties/properties.coffee", "name": "email", "bound": false, "parameters": [ { "name": "_email", "splat": false } ] }, { "file": "spec/_templates/properties/properties.coffee", "name": "test", "bound": false, "documentation": { "comment": "This should not be swallowed", "summary": "This should not be swallowed" }, "kind": "dynamic", "parameters": [] } ] ================================================ FILE: spec/_templates/variables/class_variables.coffee ================================================ class TestClassVariables @empty = undefined @test = 'Hi' @another = ['a', 'b'] @more = a: 1 b: 2 ================================================ FILE: spec/_templates/variables/class_variables.json ================================================ [ { "file": "spec/_templates/variables/class_variables.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "TestClassVariables", "methods": [], "variables": [ { "file": "spec/_templates/variables/class_variables.coffee", "name": "empty", "constant": false, "value": "undefined", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "test", "constant": false, "value": "'Hi'", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "another", "constant": false, "value": "['a', 'b']", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "more", "constant": false, "value": "{\n a: 1,\n b: 2\n}", "selfish": true, "kind": "static" } ], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "empty", "constant": false, "value": "undefined", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "test", "constant": false, "value": "'Hi'", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "another", "constant": false, "value": "['a', 'b']", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "more", "constant": false, "value": "{\n a: 1,\n b: 2\n}", "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "a", "constant": false, "value": "1" }, { "file": "spec/_templates/variables/class_variables.coffee", "name": "b", "constant": false, "value": "2" } ] ================================================ FILE: spec/_templates/variables/constant_variables.coffee ================================================ class TestContstantVariables # Modify it here @TEST = 'Hi' @ANOTHER_CONST: ['a', 'b'] ================================================ FILE: spec/_templates/variables/constant_variables.json ================================================ [ { "file": "spec/_templates/variables/constant_variables.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/variables/constant_variables.coffee", "name": "TestContstantVariables", "methods": [], "variables": [ { "file": "spec/_templates/variables/constant_variables.coffee", "name": "TEST", "constant": true, "value": "'Hi'", "documentation": { "comment": "Modify it here", "summary": "Modify it here" }, "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/constant_variables.coffee", "name": "ANOTHER_CONST", "constant": true, "value": "['a', 'b']", "selfish": true, "kind": "static" } ], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/variables/constant_variables.coffee", "name": "TEST", "constant": true, "value": "'Hi'", "documentation": { "comment": "Modify it here", "summary": "Modify it here" }, "selfish": true, "kind": "static" }, { "file": "spec/_templates/variables/constant_variables.coffee", "name": "ANOTHER_CONST", "constant": true, "value": "['a', 'b']", "selfish": true, "kind": "static" } ] ================================================ FILE: spec/_templates/variables/instance_variables.coffee ================================================ class TestInstanceVariables empty: undefined test: 'Hi' another: ['a', 'b'] more: a: 1 b: 2 ================================================ FILE: spec/_templates/variables/instance_variables.json ================================================ [ { "file": "spec/_templates/variables/instance_variables.coffee", "methods": [], "variables": [] }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "TestInstanceVariables", "methods": [], "variables": [ { "file": "spec/_templates/variables/instance_variables.coffee", "name": "empty", "constant": false, "value": "undefined", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "test", "constant": false, "value": "'Hi'", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "another", "constant": false, "value": "['a', 'b']", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "more", "constant": false, "value": "{\n a: 1,\n b: 2\n}", "kind": "dynamic" } ], "properties": [], "includes": [], "extends": [], "concerns": [] }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "empty", "constant": false, "value": "undefined", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "test", "constant": false, "value": "'Hi'", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "another", "constant": false, "value": "['a', 'b']", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "more", "constant": false, "value": "{\n a: 1,\n b: 2\n}", "kind": "dynamic" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "a", "constant": false, "value": "1" }, { "file": "spec/_templates/variables/instance_variables.coffee", "name": "b", "constant": false, "value": "2" } ] ================================================ FILE: spec/lib/api_spec.coffee ================================================ API = require '../../lib/command.coffee' Path = require 'path' describe 'API', -> it 'parses project', (done) -> api = new API() api.generate Path.join(__dirname, '../_templates/example'), { test: true }, (err) -> expect(err).toBeUndefined() done() it 'fails if coverage is too low', (done) -> api = new API() api.generate Path.join(__dirname, '../_templates/example'), { test: true, "min-coverage": 90 }, (err) -> expect(err).toBe 1 done() ================================================ FILE: spec/lib/codo_spec.coffee ================================================ Path = require 'path' Codo = require '../../lib/codo' describe 'Codo', -> it 'parses project', -> environment = Codo.parseProject(Path.join __dirname, '../_templates/example') expect(environment.allFiles().map (file) -> file.inspect().file).toEqual [ 'src/angry_animal.coffee', 'src/animal.coffee', 'src/lion.coffee', 'src/over_documented_class.coffee', 'src/over_documented_mixin.coffee' ].map (file) -> Path.normalize file expect(environment.allExtras().map (e) -> e.name).toEqual [ 'README.md', 'CHANGELOG' ] expect(environment.options.readme).toEqual 'README.md' ================================================ FILE: spec/lib/entities/class_spec.coffee ================================================ Environment = require '../../../lib/environment' Method = require '../../../lib/entities/mixin' describe 'Class', -> it 'lists effective methods', -> environment = Environment.read('spec/_templates/complicateds/methods.coffee') methods = environment.entities[1].effectiveMethods() expect(methods[0].inspect()).toEqual { name: 'z', kind: 'dynamic', bound: false, parameters: [] } expect(methods[1].inspect()).toEqual { name : 'x', kind : 'dynamic', parameters : [ 'key', 'value' ] } it 'lists inherited methods', -> environment = Environment.read('spec/_templates/complicateds/methods.coffee') methods = environment.entities[12].inheritedMethods().map (x) -> x.entity.inspect() expect(methods).toEqual( [ { name: 'x', kind: 'dynamic', bound: false, parameters: [ ] }, { name: 'z', kind: 'dynamic', bound: false, parameters: [ ] }, { name: 'm', kind: 'dynamic', bound: false, parameters: [ ] }, { name: 'cs', kind: 'static', bound: false, parameters: [ ] }, { name: 'cd', kind: 'dynamic', bound: false, parameters: [ ] } ] ) it 'lists inherited variables', -> environment = Environment.read('spec/_templates/complicateds/variables.coffee') variables = environment.entities[5].inheritedVariables().map (x) -> x.entity.inspect() expect(variables).toEqual( [ { file: 'spec/_templates/complicateds/variables.coffee', name: 'z', constant: false, value: "'456'", kind: 'dynamic' } ] ) ================================================ FILE: spec/lib/entities/mixin_spec.coffee ================================================ Environment = require '../../../lib/environment' Method = require '../../../lib/entities/mixin' describe 'Mixin', -> describe 'effective methods', -> it 'get listed for inclusion', -> environment = Environment.read('spec/_templates/mixins/mixin_methods.coffee') methods = environment.entities[1].effectiveInclusionMethods().map (m) -> m.inspect() expect(methods).toEqual( [ { name: 'helper', kind: 'dynamic', bound: false, parameters: [] }, { name: 'another', kind: 'dynamic', bound: false, parameters: [ 'a', 'b' ] }, { name: 'withDefault', kind: 'dynamic', bound: false, parameters: [ 'a = 2', 'c', 'd = \'hi\'', 'd', 'e = {\n a: 2\n}', 'f = new TestClassMethods()' ] }, { name: 'nowWithSpalt', kind: 'dynamic', bound: false, parameters: [ 'foo', 'bar...' ] }, { name: 'set', kind: 'dynamic', parameters: [ 'key', 'value' ] } ] ) it 'get listed for extension', -> environment = Environment.read('spec/_templates/mixins/mixin_methods.coffee') methods = environment.entities[1].effectiveExtensionMethods().map (m) -> m.inspect() expect(methods).toEqual( [ { name: 'helper', kind: 'static', bound: false, parameters: [] }, { name: 'another', kind: 'static', bound: false, parameters: [ 'a', 'b' ] }, { name: 'withDefault', kind: 'static', bound: false, parameters: [ 'a = 2', 'c', 'd = \'hi\'', 'd', 'e = {\n a: 2\n}', 'f = new TestClassMethods()' ] }, { name: 'nowWithSpalt', kind: 'static', bound: false, parameters: [ 'foo', 'bar...' ] }, { name: 'set', kind: 'static', parameters: [ 'key', 'value' ] } ] ) it 'get listed for concern', -> environment = Environment.read('spec/_templates/mixins/concern.coffee') methods = environment.entities[1].effectiveConcernMethods().map (m) -> m.inspect() expect(methods).toEqual( [ { name: 'a', kind: 'static', bound: false, parameters: [ 'a', 'b', 'c' ] }, { name: 'z', kind: 'static', bound: false, parameters: [ 'x', 'y', 'z' ] }, { name: 'hi', kind: 'dynamic', bound: false, parameters: [ 'to' ] }, { name: 'goodbye', kind: 'dynamic', bound: false, parameters: [ 'to' ] } ] ) ================================================ FILE: spec/lib/environment_spec.coffee ================================================ FS = require 'fs' jsdiff = require 'diff' Path = require 'path' walkdir = require 'walkdir' Environment = require '../../lib/environment' normalizePathsInObject = (obj) -> return if typeof obj is "string" if obj.file? then obj.file = Path.normalize obj.file for key, val of obj # ['variables', 'methods', 'properties', 'includes', 'container', 'parent', 'extends'] if Array.isArray val val.forEach normalizePathsInObject else normalizePathsInObject obj[key] beforeEach -> @addMatchers toTraverseTo: (expected) -> environment = new Environment parser = environment.readCoffee(@actual) environment.linkify() actual = JSON.parse JSON.stringify environment.inspect() expected = JSON.parse FS.readFileSync(expected, 'utf8') expected.forEach (entry) -> normalizePathsInObject entry diff = "" for part in jsdiff.diffJson(expected, actual) if part.added diff += part.value.green else if part.removed diff += part.value.red else diff += part.value diff @message = -> report = "\n-------------------- CoffeeScript ----------------------\n" report += parser.content report += "\n--------------------- JSON diff -----------------------\n" report += diff report += "\n-------------------------------------------------------\n" require('deep-eql')(expected, actual) describe 'Environment', -> describe 'Extras', -> beforeEach -> @environment = new Environment it 'reads plain text', -> @environment.readExtra 'spec/_templates/extras/README' expect(@environment.allExtras().map (e) -> e.inspect()).toEqual([{ path: 'spec/_templates/extras/README', parsed: '

This is a test README

' }]) it 'reads markdown', -> @environment.readExtra 'spec/_templates/extras/README.md' expect(@environment.allExtras().map (e) -> e.inspect()).toEqual([{ path: 'spec/_templates/extras/README.md', parsed: '

This is a test README

We even have some content here. With links!

And nested menus

And even more content

Actually...

I feel terribly sick writing this. It's like talking to myself.

' parsed: '

This is a test README

We even have some content here. With links!

And nested menus

And even more content

Actually...

I feel terribly sick writing this. It's like talking to myself.

With relative markdown links too

' }]) describe 'Class', -> for filename in walkdir.sync './spec/_templates/classes' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'Variable', -> for filename in walkdir.sync './spec/_templates/variables' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'Property', -> for filename in walkdir.sync './spec/_templates/properties' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'File', -> it 'parses non-class file', -> expect(Path.normalize 'spec/_templates/files/non_class_file.coffee').toTraverseTo( 'spec/_templates/files/non_class_file.json' ) describe 'Mixin', -> for filename in walkdir.sync './spec/_templates/mixins' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'Method', -> for filename in walkdir.sync './spec/_templates/methods' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'Angular', -> for filename in walkdir.sync './spec/_templates/angular' when filename.match /\.coffee$/ do (filename) -> it "parses #{filename}", -> expect(filename.substring process.cwd().length + 1) .toTraverseTo(filename.replace(/\.coffee$/, '.json')) describe 'Environment', -> it 'handles multiple files', -> environment = Environment.read [ 'spec/_templates/environment/class.coffee', 'spec/_templates/environment/mixin.coffee' ].map Path.normalize actual = JSON.stringify(environment.inspect(), null, 2) expected = JSON.parse FS.readFileSync 'spec/_templates/environment/result.json', 'utf8' expected.forEach normalizePathsInObject expected = JSON.stringify expected, null, 2 expect(actual).toEqual expected expect(Object.keys environment.references).toEqual [ 'spec/_templates/environment/class.coffee', 'spec/_templates/environment/mixin.coffee', 'Fluffy', 'LookAndFeel', 'LookAndFeel~feel', 'LookAndFeel~look' ].map Path.normalize ================================================ FILE: spec/lib/meta/method_spec.coffee ================================================ Environment = require '../../../lib/environment' Method = require '../../../lib/meta/method' describe 'Method', -> it 'parses documentation', -> environment = Environment.read('spec/_templates/methods/dynamic_methods.coffee') method = Method.fromDocumentationMethod environment.entities[1].documentation.methods[0] expect(method.inspect()).toEqual name: 'set' kind: 'dynamic' parameters: ['key', 'value'] method = Method.fromDocumentationMethod environment.entities[1].documentation.methods[1] expect(method.inspect()).toEqual name: 'get' kind: 'static' parameters: ['key'] method = Method.fromDocumentationMethod environment.entities[1].documentation.methods[2] expect(method.inspect()).toEqual name: 'delete' kind: 'dynamic' parameters: ['{key, passion}', "foo = 'bar'"] it 'parses entities', -> environment = Environment.read('spec/_templates/methods/method_documentation.coffee') method = Method.fromMethodEntity environment.entities[2] expect(method.inspect()).toEqual name: 'fetchLimit' kind: 'dynamic' bound: false parameters: [] method = Method.fromMethodEntity environment.entities[3] expect(method.inspect()).toEqual name: 'do' kind: 'dynamic' bound: false parameters: ['it', 'again', 'options'] method = Method.fromMethodEntity environment.entities[4] expect(method.inspect()).toEqual name: 'doWithoutSpace' kind: 'dynamic' bound: false parameters: ['it', 'again', 'options'] method = Method.fromMethodEntity environment.entities[5] expect(method.inspect()).toEqual name: 'lets_do_it' kind: 'static' bound: false parameters: ['it', 'options'] ================================================ FILE: spec/lib/meta/parameter_spec.coffee ================================================ Parameter = require '../../../lib/meta/parameter' describe 'Parameter', -> describe 'signature parsing', -> it 'understands basic stuff', -> expect( Parameter.fromSignature('#foo(a,b)').map (x) -> x.inspect() ).toEqual [ { name: 'a' splat: false }, { name: 'b', splat: false } ] it 'understands complex stuff', -> expect( Parameter.fromSignature('#foo({a,b}, x="test", y...)').map (x) -> x.inspect() ).toEqual [ { name: '{a, b}' splat: false }, { name: 'x', splat: false default: '"test"' }, { name: 'y' splat: true } ] ================================================ FILE: spec/lib/tools/markdown_spec.coffee ================================================ Markdown = require '../../../lib/tools/markdown' jsdiff = require 'diff' describe 'Markdown', -> describe 'limited markdown conversion', -> limit = true it 'removes non-inline tags', -> markdown = """ # A markdown list - THING_1 - THING_2 - A long, mulitline list element """ expect(Markdown.convert(markdown, limit)).toEqual(""" A markdown list THING_1 THING_2 - A long, mulitline list element """) ================================================ FILE: spec/themes/default/lib/templater_spec.coffee ================================================ Environment = require '../../../../lib/environment' Templater = require '../../../../themes/default/lib/templater' describe 'Templater', -> it 'parses all the templates', -> templater = new Templater(new Environment) expect(Object.keys(templater.JST)).toEqual( [ 'alphabetical_index', 'class', 'class_list', 'extra', 'extra_list', 'file', 'file_list', 'frames', 'layout/footer', 'layout/header', 'layout/intro', 'method_list', 'mixin', 'mixin_list', 'partials/documentation', 'partials/list_nav', 'partials/method_list', 'partials/method_signature', 'partials/method_summary', 'partials/type_link', 'partials/variable_list' ] ) ================================================ FILE: spec/themes/default/lib/theme_spec.coffee ================================================ OS = require 'os' Path = require 'path' Environment = require '../../../../lib/environment' Theme = require '../../../../themes/default/lib/theme' rimraf = require 'rimraf' describe 'Theme', -> beforeEach -> @output = Path.join OS.tmpdir(), 'codo_theme_spec' rimraf.sync @output it 'generates', -> environment = new Environment output: @output environment.readExtra 'spec/_templates/example/CHANGELOG' environment.readExtra 'spec/_templates/example/README.md', true environment.readCoffee 'spec/_templates/example/src/over_documented_class.coffee' environment.readCoffee 'spec/_templates/example/src/over_documented_mixin.coffee' environment.linkify() Theme.compile(environment) ================================================ FILE: spec/themes/default/lib/tree_builder_spec.coffee ================================================ TreeBuilder = require '../../../../themes/default/lib/tree_builder' describe 'Tree Builder', -> it 'builds proper tree', -> data = [ {name: 'foo.bar'}, {name: 'foo.bar.baz'}, {name: 'foo.baz'}, {name: 'dummy'} ] builder = new TreeBuilder data, (entry) -> path = entry.name.split('.') [path.pop(), path] expect(builder.tree).toEqual [ { name:'foo', children:[ { name:'bar', children:[ { name:'baz', children:[], entity:{ name:'foo.bar.baz' } } ], entity:{ name:'foo.bar' } }, { name:'baz', children:[], entity:{ name:'foo.baz' } } ], entity:undefined }, { name:'dummy', children:[], entity:{ name:'dummy' } } ] ================================================ FILE: themes/default/assets/javascript/application.js ================================================ //= require_tree './vendor' //= require ./codo //= require ./sidebar //= require ./toc //= require ./keys //= require ./fuzzy //= require ./frames ================================================ FILE: themes/default/assets/javascript/codo.coffee ================================================ $ -> # Highlight code $('pre code').each (i, e) -> hljs.highlightBlock e, ' ' # Show external links in the main doc to avoid frame blocking by X-Frame-Options. $('#content a').each -> $(@).attr('target', '_top') if /^https?:\/\//i.test $(@).attr('href') ================================================ FILE: themes/default/assets/javascript/frames.coffee ================================================ $ -> if $('frameset').length > 0 parser = document.createElement('a') parser.href = location.href starter = parser.hash.substr(1) if starter.length > 0 $('#content')[0].contentWindow.location.href = starter $('#content').load -> hash = encodeURI(@contentWindow.location.href) if history.pushState history.replaceState(null, document.title, '#'+hash); else location.hash = hash ================================================ FILE: themes/default/assets/javascript/fuzzy.coffee ================================================ $ -> $('#search_frame').hide() window.lastSearch = '' # Global fuzzy search # $('#fuzzySearch input').keyup (event) -> text = $(@).val() resultList = $('#fuzzySearch ol') if event.keyCode is 13 location.href = $('#fuzzySearch ol li.selected a').attr 'href' else if event.keyCode is 38 items = resultList.children() index = items.index($('#fuzzySearch ol li.selected')) $(items.get(index)).removeClass 'selected' index -= 1 index = items.length - 1 if index is -1 $(items.get(index)).addClass 'selected' else if event.keyCode is 40 items = resultList.children() index = items.index($('#fuzzySearch ol li.selected')) $(items.get(index)).removeClass 'selected' index += 1 index = 0 if index is items.length $(items.get(index)).addClass 'selected' else if text && text isnt lastSearch window.lastSearch = text resultList.empty() path = $('#base').attr 'data-path' matches = fuzzy text, _.pluck(searchData, 't'), { limit: 25 } highlights = fuzzy text, _.pluck(searchData, 't'), { pre: '', post: '', limit: 25 } for match, index in matches data = _.find(searchData, (d) -> d.t is match) resultList.append $("
  • #{ highlights[index] }#{ if data.h then "(#{ data.h })" else '' }
    • ") $('#fuzzySearch ol li:first').addClass 'selected' $('#fuzzySearch').height(resultList.height() + 45) $('#fuzzySearch ol li').each (i, el) -> if i % 2 is 0 then $(el).addClass('stripe') else $(el).removeClass('stripe') else if text isnt lastSearch resultList.empty() $('#fuzzySearch').height(45) ================================================ FILE: themes/default/assets/javascript/keys.coffee ================================================ $ -> loadSearch = (url, link) -> parent.frames.list.location.href = url unless /#{ url }$/.test parent.frames.list.location.href # Allow ESC to blur #search key.filter = (e) -> tagname = (e.target || e.srcElement).tagName tagname isnt 'INPUT' || e.keyCode is 27 || e.ctrlKey is true # Focus search input key 's', (e) -> e.preventDefault() try parent.frames.list.$('#search input').focus().select() try $('#search input').focus().select() # Unblur the search input key 'esc', -> try parent.frames.list.$('#search input').blur() parent.frames.main.$('#help').hide() parent.frames.main.$('#fuzzySearch').hide() try parent.$("#search .active").click() parent.$('#help').hide() parent.$('#fuzzySearch').hide() try $('#search input').blur() $('#help').hide() $('#fuzzySearch').hide() # Hide list navigation # FIXME: Manually resize the frame confuses the toggle key 'l', -> body = $(parent.document.body) if body.data('toggled') parent.document.body.cols = '25%, *' body.data 'toggled', false else parent.document.body.cols = '0, *' body.data 'toggled', true # List navigation key 'c', -> loadSearch 'class_list.html', 'class_list_link' key 'm', -> loadSearch 'method_list.html', 'method_list_link' key 'i', -> loadSearch 'mixin_list.html', 'mixin_list_link' key 'f', -> loadSearch 'file_list.html', 'file_list_link' key 'e', -> loadSearch 'extra_list.html', 'extra_list_link' # Show help key 'h', -> try parent.frames.main.$('#help').toggle() catch try $('#help').toggle() # Fuzzy class search key 't', (e) -> e.preventDefault() try $('#fuzzySearch').toggle() $('#fuzzySearch input').focus().select() try parent.frames.main.$('#fuzzySearch').show() parent.frames.main.$('#fuzzySearch input').focus().select() ================================================ FILE: themes/default/assets/javascript/sidebar.coffee ================================================ $ -> # Create stripes window.createStripes = -> $('#content.list li:visible').each (i, el) -> if i % 2 is 0 then $(el).addClass('stripe') else $(el).removeClass('stripe') # Indent nested Lists window.indentTree = (el, width) -> $(el).find('> ul').each -> $(@).find('> li').css 'padding-left', "#{ width }px" window.indentTree $(@), width + 20 # # Add tree arrow links # $('#content.tree ul > ul').each -> $(@).prev().prepend $('') # # Search List # $('#search input').keyup (event) -> search = $(@).val().toLowerCase() if search.length == 0 $('#content.list ul li').each -> if $('#content').hasClass 'tree' $(@).removeClass 'result' $(@).css 'padding-left', $(@).data 'padding' $(@).show() else $('#content.list ul li').each -> if $(@).find('a').text().toLowerCase().indexOf(search) == -1 $(@).hide() else if $('#content').hasClass 'tree' $(@).addClass 'result' padding = $(@).css('padding-left') $(@).data 'padding', padding unless padding == '0px' $(@).css 'padding-left', 0 $(@).show() window.createStripes() # # Navigate from a Search List # $('body #content.list ul').on 'click', 'li', (event) -> link = $(@).find('a:not(.toggle)').attr('href') top.frames['main'].location.href = link if link && link != '#' event.preventDefault() # # Collapse/expand sub trees # $('#content.tree a.toggle').click -> $(@).toggleClass 'collapsed' $(@).parent().next().toggle() window.createStripes() # # Initialize # indentTree $('#content.list > ul'), 20 createStripes() ================================================ FILE: themes/default/assets/javascript/toc.coffee ================================================ $ -> # # Create file TOC from the headings # $('#filecontents').each -> nav = $('nav.toc') target = nav level = 0 ancestors = [] for heading, index in $('h2,h3,h4,h5,h6', @) heading = $(heading) heading.before $("") depth = parseInt heading.get(0).tagName.substring(1) # Create a nested list if depth > level list = $('
      ') target.append list ancestors.push target target = list level = depth # Go up one list level else if depth < level target = ancestors.pop() for i in [0...level - depth] target = $('nav.toc ol:first') unless target level = depth target.append $("
    1. #{ heading.text() }
      2. ") nav.hide() if $('ol', nav).length is 0 # # Toggle the TOC visibility # $('a.hide_toc').click -> $('nav.toc').toggleClass 'hidden' # # Toggle the float position status between floating and inline # $('a.float_toc').click -> $('nav.toc').toggleClass 'inline' $(@).text if $('nav.toc').hasClass 'inline' then 'float' else 'left' ================================================ FILE: themes/default/assets/javascript/vendor/fuzzy.coffee ================================================ # Taken from: https://github.com/stratuseditor/fuzzy-filter/blob/master/index.coffee # Public: Filter a list of items. # # pattern - The fuzzy String to match against. # items - An Array of String. # options - (optional) # * pre - String to insert before matching text. # * post - String to insert after matching text. # * limit - Integer maximum number of results. # * separator - String separator. Match against the last # section of the String by default. # * ignorecase - Boolean (default: true). # * ignorespace - Boolean (default: true). # * separate - Boolean (default: false). If set to true, the # function returns an array of an array of strings, # where each array is # [beforeLastSeparator, afterLastSeparator]. # If set, `separator` must also be passed. # # Note: If `pre` is passed, you also have to pass `post` (and vice-versa). # # Examples # # fuzzy = require 'fuzzy-filter' # fuzzy "cs", ["cheese", "pickles", "crackers", "pirate attack", "cs!!"] # # => ["cs!!", "cheese", "crackers"] # # fuzzy "cs", ["cheese", "pickles", "crackers", "pirate attack", "cs!!"], # pre: "" # post: "" # # => ["cs!!", "cheese", "crackers"] # # fuzzy "cs", ["cookies", "cheese/pie", "fried/cheese", "cheese/cookies"], # pre: "" # post: "" # separator: "/" # # => [ "cookies" # # , "fried/cheese" # # , "cheese/cookies" ] # # fuzzy "cs/", ["cookies", "cheese/pie", "fried/cheese", "cheese/cookies"], # pre: "" # post: "" # separator: "/" # # => [ "cheese/pie" # # , "cheese/cookies" ] # # fuzzy "cs/p", ["cookies", "cheese/pie", "fried/cheese", "cheese/cookies"], # pre: "" # post: "" # separator: "/" # # => ["cheese/pie"] # # fuzzy "cs/p", ["cookies", "cheese/pie", "fried/cheese", "cheese/cookies"], # pre: "" # post: "" # separator: "/" # separate: true # # => [ ["cheese", "pie"] ] # # Returns an Array of String. window.fuzzy = (pattern, items, options={}) -> {pre, post, limit, separator, ignorecase, ignorespace, separate} = options ignorecase ?= true ignorespace ?= true separate ?= false # `separate` requires a separator. if separate && !separator throw new Error "You must pass a separator when options.separate is true." pattern = pattern.replace /\s/g, "" if ignorespace matches = [] flags = (ignorecase && "i") || "" doHighlight = pre && post # Internal: # before - The matched text before the last separator. # after - The matched text after the last separator. # method - "unshift" or "push" addMatch = (before, after, method) -> if separate matches[method] [before, after] else if before matches[method] before + separator + after else matches[method] after # Internal: Add a match to the end of the matches Array. # Returns nothing. appendMatch = (before, after) -> addMatch before, after, "push" # Internal: Prepend a match to the matches Array. # Returns nothing. prependMatch = (before, after) -> addMatch before, after, "unshift" if separator preParts = pattern.split separator postPart = preParts.pop() prePart = preParts.join separator inner = _.map preParts, ((p) -> makePattern(p)) inner = inner.join ".*?#{ separator }.*?" preSepRegex = new RegExp "^.*?#{ inner }.*?$", flags else preParts = false postPart = pattern preSepRegex = false postSepRegex = new RegExp "^.*?#{ makePattern(postPart) }.*$", flags for item in items break if matches.length == limit hasTextBeforeSeparator = separator && !!~item.indexOf(separator) # Match the beginning of the item. if !hasTextBeforeSeparator && item.indexOf(pattern) == 0 if doHighlight len = pattern.length prependMatch "", pre + item.slice(0, len) + post + item.slice(len) else prependMatch "", item continue if hasTextBeforeSeparator parts = item.split separator preSep = parts[0..-2].join separator postSep = _.last parts else preSep = "" postSep = item # Match the part before the last separator. isMatch = !preSepRegex || preSepRegex.test(preSep) # Match the part after the last separator. isMatch &&= !postSepRegex || postSepRegex.test(postSep) continue unless isMatch if doHighlight after = surroundMatch postSep, postPart, pre, post, ignorecase if hasTextBeforeSeparator before = surroundMatch preSep, prePart, pre, post, ignorecase appendMatch before, after else appendMatch "", after else appendMatch preSep, postSep return matches # Internal: # # Returns a String to be turned into a RegExp. makePattern = (pattern) -> chars = pattern.split "" regex = [] for c in chars c = if c is "\\" then "\\\\" else c regex.push "([#{ c }])" return regex.join "[^/]*?" # Internal: # # Examples # # surroundMatch "cheese", "cs", "", "" # # => "cheese" # # Returns String. surroundMatch = (string, pattern, pre, post, ignorecase) -> done = "" pattern = pattern.split "" nextChar = pattern.shift() for c in string.split("") if nextChar sameChar = false if ignorecase && c.toLowerCase() == nextChar.toLowerCase() sameChar = true else if !ignorecase && c == nextChar sameChar = true if sameChar done += "#{pre}#{c}#{post}" nextChar = pattern.shift() continue done += c return done ================================================ FILE: themes/default/assets/javascript/vendor/highlight.coffeescript.js ================================================ //= require ./highlight /* Language: CoffeeScript Author: Dmytrii Nagirniak Contributors: Oleg Efimov Description: CoffeeScript is a programming language that transcompiles to JavaScript. For info about language see http://coffeescript.org/ */ hljs.LANGUAGES.coffeescript = function() { var keywords = { 'keyword': { // JS keywords 'in': 1, 'if': 1, 'for': 1, 'while': 1, 'finally': 1, 'new': 1, 'do': 1, 'return': 1, 'else': 1, 'break': 1, 'catch': 1, 'instanceof': 1, 'throw': 1, 'try': 1, 'this': 1, 'switch': 1, 'continue': 1, 'typeof': 1, 'delete': 1, 'debugger': 1, 'class': 1, 'extends': 1, 'super': 1, // Coffee keywords 'then': 1, 'unless': 1, 'until': 1, 'loop': 2, 'of': 2, 'by': 1, 'when': 2, 'and': 1, 'or': 1, 'is': 1, 'isnt': 2, 'not': 1 }, 'literal': { // JS literals 'true': 1, 'false': 1, 'null': 1, 'undefined': 1, // Coffee literals 'yes': 1, 'no': 1, 'on': 1, 'off': 1 }, 'reserved': { 'case': 1, 'default': 1, 'function': 1, 'var': 1, 'void': 1, 'with': 1, 'const': 1, 'let': 1, 'enum': 1, 'export': 1, 'import': 1, 'native': 1, '__hasProp': 1 , '__extends': 1 , '__slice': 1 , '__bind': 1 , '__indexOf': 1 } }; var JS_IDENT_RE = '[A-Za-z$_][0-9A-Za-z$_]*'; var COFFEE_QUOTE_STRING_SUBST_MODE = { className: 'subst', begin: '#\\{', end: '}', keywords: keywords, contains: [hljs.C_NUMBER_MODE, hljs.BINARY_NUMBER_MODE] }; var COFFEE_QUOTE_STRING_MODE = { className: 'string', begin: '"', end: '"', relevance: 0, contains: [hljs.BACKSLASH_ESCAPE, COFFEE_QUOTE_STRING_SUBST_MODE] }; var COFFEE_HEREDOC_MODE = { className: 'string', begin: '"""', end: '"""', contains: [hljs.BACKSLASH_ESCAPE, COFFEE_QUOTE_STRING_SUBST_MODE] }; var COFFEE_HERECOMMENT_MODE = { className: 'comment', begin: '###', end: '###' }; var COFFEE_HEREGEX_MODE = { className: 'regexp', begin: '///', end: '///', contains: [hljs.HASH_COMMENT_MODE] }; var COFFEE_FUNCTION_DECLARATION_MODE = { className: 'function', begin: JS_IDENT_RE + '\\s*=\\s*(\\(.+\\))?\\s*[-=]>', returnBegin: true, contains: [ { className: 'title', begin: JS_IDENT_RE }, { className: 'params', begin: '\\(', end: '\\)' } ] }; var COFFEE_EMBEDDED_JAVASCRIPT = { className: 'javascript', begin: '`', end: '`', excludeBegin: true, excludeEnd: true, subLanguage: 'javascript' }; return { defaultMode: { keywords: keywords, contains: [ // Numbers hljs.C_NUMBER_MODE, hljs.BINARY_NUMBER_MODE, // Strings hljs.APOS_STRING_MODE, COFFEE_HEREDOC_MODE, // Should be before COFFEE_QUOTE_STRING_MODE for greater priority COFFEE_QUOTE_STRING_MODE, // Comments COFFEE_HERECOMMENT_MODE, // Should be before hljs.HASH_COMMENT_MODE for greater priority hljs.HASH_COMMENT_MODE, // CoffeeScript specific modes COFFEE_HEREGEX_MODE, COFFEE_EMBEDDED_JAVASCRIPT, COFFEE_FUNCTION_DECLARATION_MODE ] } }; }(); ================================================ FILE: themes/default/assets/javascript/vendor/highlight.js ================================================ /* Syntax highlighting with language autodetection. http://softwaremaniacs.org/soft/highlight/ */ var hljs = new function() { /* Utility functions */ function escape(value) { return value.replace(/&/gm, '&').replace(/'; } while (stream1.length || stream2.length) { var current = selectStream().splice(0, 1)[0]; result += escape(value.substr(processed, current.offset - processed)); processed = current.offset; if ( current.event == 'start') { result += open(current.node); nodeStack.push(current.node); } else if (current.event == 'stop') { var node, i = nodeStack.length; do { i--; node = nodeStack[i]; result += (''); } while (node != current.node); nodeStack.splice(i, 1); while (i < nodeStack.length) { result += open(nodeStack[i]); i++; } } } return result + escape(value.substr(processed)); } /* Initialization */ function compileModes() { function compileMode(mode, language, is_default) { if (mode.compiled) return; var group; if (!is_default) { mode.beginRe = langRe(language, mode.begin ? mode.begin : '\\B|\\b'); if (!mode.end && !mode.endsWithParent) mode.end = '\\B|\\b'; if (mode.end) mode.endRe = langRe(language, mode.end); } if (mode.illegal) mode.illegalRe = langRe(language, mode.illegal); if (mode.relevance === undefined) mode.relevance = 1; if (mode.keywords) { mode.lexemsRe = langRe(language, mode.lexems || hljs.IDENT_RE, true); for (var className in mode.keywords) { if (!mode.keywords.hasOwnProperty(className)) continue; if (mode.keywords[className] instanceof Object) { group = mode.keywords[className]; } else { group = mode.keywords; className = 'keyword'; } for (var keyword in group) { if (!group.hasOwnProperty(keyword)) continue; mode.keywords[keyword] = [className, group[keyword]]; } } } if (!mode.contains) { mode.contains = []; } // compiled flag is set before compiling submodes to avoid self-recursion // (see lisp where quoted_list contains quoted_list) mode.compiled = true; for (var i = 0; i < mode.contains.length; i++) { if (mode.contains[i] == 'self') { mode.contains[i] = mode; } compileMode(mode.contains[i], language, false); } if (mode.starts) { compileMode(mode.starts, language, false); } } for (var i in languages) { if (!languages.hasOwnProperty(i)) continue; compileMode(languages[i].defaultMode, languages[i], true); } } /* Core highlighting function. Accepts a language name and a string with the code to highlight. Returns an object with the following properties: - relevance (int) - keyword_count (int) - value (an HTML string with highlighting markup) */ function highlight(language_name, value) { if (!compileModes.called) { compileModes(); compileModes.called = true; } function subMode(lexem, mode) { for (var i = 0; i < mode.contains.length; i++) { if (mode.contains[i].beginRe.test(lexem)) { return mode.contains[i]; } } } function endOfMode(mode_index, lexem) { if (modes[mode_index].end && modes[mode_index].endRe.test(lexem)) return 1; if (modes[mode_index].endsWithParent) { var level = endOfMode(mode_index - 1, lexem); return level ? level + 1 : 0; } return 0; } function isIllegal(lexem, mode) { return mode.illegal && mode.illegalRe.test(lexem); } function compileTerminators(mode, language) { var terminators = []; for (var i = 0; i < mode.contains.length; i++) { terminators.push(mode.contains[i].begin); } var index = modes.length - 1; do { if (modes[index].end) { terminators.push(modes[index].end); } index--; } while (modes[index + 1].endsWithParent); if (mode.illegal) { terminators.push(mode.illegal); } return langRe(language, '(' + terminators.join('|') + ')', true); } function eatModeChunk(value, index) { var mode = modes[modes.length - 1]; if (!mode.terminators) { mode.terminators = compileTerminators(mode, language); } mode.terminators.lastIndex = index; var match = mode.terminators.exec(value); if (match) return [value.substr(index, match.index - index), match[0], false]; else return [value.substr(index), '', true]; } function keywordMatch(mode, match) { var match_str = language.case_insensitive ? match[0].toLowerCase() : match[0]; var value = mode.keywords[match_str]; if (value && value instanceof Array) return value; return false; } function processKeywords(buffer, mode) { buffer = escape(buffer); if (!mode.keywords) return buffer; var result = ''; var last_index = 0; mode.lexemsRe.lastIndex = 0; var match = mode.lexemsRe.exec(buffer); while (match) { result += buffer.substr(last_index, match.index - last_index); var keyword_match = keywordMatch(mode, match); if (keyword_match) { keyword_count += keyword_match[1]; result += '' + match[0] + ''; } else { result += match[0]; } last_index = mode.lexemsRe.lastIndex; match = mode.lexemsRe.exec(buffer); } return result + buffer.substr(last_index, buffer.length - last_index); } function processBuffer(buffer, mode) { if (mode.subLanguage && languages[mode.subLanguage]) { var result = highlight(mode.subLanguage, buffer); keyword_count += result.keyword_count; return result.value; } else { return processKeywords(buffer, mode); } } function startNewMode(mode, lexem) { var markup = mode.className?'':''; if (mode.returnBegin) { result += markup; mode.buffer = ''; } else if (mode.excludeBegin) { result += escape(lexem) + markup; mode.buffer = ''; } else { result += markup; mode.buffer = lexem; } modes.push(mode); relevance += mode.relevance; } function processModeInfo(buffer, lexem, end) { var current_mode = modes[modes.length - 1]; if (end) { result += processBuffer(current_mode.buffer + buffer, current_mode); return false; } var new_mode = subMode(lexem, current_mode); if (new_mode) { result += processBuffer(current_mode.buffer + buffer, current_mode); startNewMode(new_mode, lexem); return new_mode.returnBegin; } var end_level = endOfMode(modes.length - 1, lexem); if (end_level) { var markup = current_mode.className?'':''; if (current_mode.returnEnd) { result += processBuffer(current_mode.buffer + buffer, current_mode) + markup; } else if (current_mode.excludeEnd) { result += processBuffer(current_mode.buffer + buffer, current_mode) + markup + escape(lexem); } else { result += processBuffer(current_mode.buffer + buffer + lexem, current_mode) + markup; } while (end_level > 1) { markup = modes[modes.length - 2].className?'':''; result += markup; end_level--; modes.length--; } var last_ended_mode = modes[modes.length - 1]; modes.length--; modes[modes.length - 1].buffer = ''; if (last_ended_mode.starts) { startNewMode(last_ended_mode.starts, ''); } return current_mode.returnEnd; } if (isIllegal(lexem, current_mode)) throw 'Illegal'; } var language = languages[language_name]; var modes = [language.defaultMode]; var relevance = 0; var keyword_count = 0; var result = ''; try { var mode_info, index = 0; language.defaultMode.buffer = ''; do { mode_info = eatModeChunk(value, index); var return_lexem = processModeInfo(mode_info[0], mode_info[1], mode_info[2]); index += mode_info[0].length; if (!return_lexem) { index += mode_info[1].length; } } while (!mode_info[2]); if(modes.length > 1) throw 'Illegal'; return { relevance: relevance, keyword_count: keyword_count, value: result }; } catch (e) { if (e == 'Illegal') { return { relevance: 0, keyword_count: 0, value: escape(value) }; } else { throw e; } } } /* Highlighting with language detection. Accepts a string with the code to highlight. Returns an object with the following properties: - language (detected language) - relevance (int) - keyword_count (int) - value (an HTML string with highlighting markup) - second_best (object with the same structure for second-best heuristically detected language, may be absent) */ function highlightAuto(text) { var result = { keyword_count: 0, relevance: 0, value: escape(text) }; var second_best = result; for (var key in languages) { if (!languages.hasOwnProperty(key)) continue; var current = highlight(key, text); current.language = key; if (current.keyword_count + current.relevance > second_best.keyword_count + second_best.relevance) { second_best = current; } if (current.keyword_count + current.relevance > result.keyword_count + result.relevance) { second_best = result; result = current; } } if (second_best.language) { result.second_best = second_best; } return result; } /* Post-processing of the highlighted markup: - replace TABs with something more useful - replace real line-breaks with '
      ' for non-pre containers */ function fixMarkup(value, tabReplace, useBR) { if (tabReplace) { value = value.replace(/^((<[^>]+>|\t)+)/gm, function(match, p1, offset, s) { return p1.replace(/\t/g, tabReplace); }); } if (useBR) { value = value.replace(/\n/g, '
      '); } return value; } /* Applies highlighting to a DOM node containing code. Accepts a DOM node and two optional parameters for fixMarkup. */ function highlightBlock(block, tabReplace, useBR) { var text = blockText(block, useBR); var language = blockLanguage(block); var result, pre; if (language == 'no-highlight') return; if (language) { result = highlight(language, text); } else { result = highlightAuto(text); language = result.language; } var original = nodeStream(block); if (original.length) { pre = document.createElement('pre'); pre.innerHTML = result.value; result.value = mergeStreams(original, nodeStream(pre), text); } result.value = fixMarkup(result.value, tabReplace, useBR); var class_name = block.className; if (!class_name.match('(\\s|^)(language-)?' + language + '(\\s|$)')) { class_name = class_name ? (class_name + ' ' + language) : language; } if (/MSIE [678]/.test(navigator.userAgent) && block.tagName == 'CODE' && block.parentNode.tagName == 'PRE') { // This is for backwards compatibility only. IE needs this strange // hack becasue it cannot just cleanly replace block contents. pre = block.parentNode; var container = document.createElement('div'); container.innerHTML = '
      ' + result.value + '
      '; block = container.firstChild.firstChild; container.firstChild.className = pre.className; pre.parentNode.replaceChild(container.firstChild, pre); } else { block.innerHTML = result.value; } block.className = class_name; block.result = { language: language, kw: result.keyword_count, re: result.relevance }; if (result.second_best) { block.second_best = { language: result.second_best.language, kw: result.second_best.keyword_count, re: result.second_best.relevance }; } } /* Applies highlighting to all 
      ..
      blocks on a page. */ function initHighlighting() { if (initHighlighting.called) return; initHighlighting.called = true; var pres = document.getElementsByTagName('pre'); for (var i = 0; i < pres.length; i++) { var code = findCode(pres[i]); if (code) highlightBlock(code, hljs.tabReplace); } } /* Attaches highlighting to the page load event. */ function initHighlightingOnLoad() { if (window.addEventListener) { window.addEventListener('DOMContentLoaded', initHighlighting, false); window.addEventListener('load', initHighlighting, false); } else if (window.attachEvent) window.attachEvent('onload', initHighlighting); else window.onload = initHighlighting; } var languages = {}; // a shortcut to avoid writing "this." everywhere /* Interface definition */ this.LANGUAGES = languages; this.highlight = highlight; this.highlightAuto = highlightAuto; this.fixMarkup = fixMarkup; this.highlightBlock = highlightBlock; this.initHighlighting = initHighlighting; this.initHighlightingOnLoad = initHighlightingOnLoad; // Common regexps this.IDENT_RE = '[a-zA-Z][a-zA-Z0-9_]*'; this.UNDERSCORE_IDENT_RE = '[a-zA-Z_][a-zA-Z0-9_]*'; this.NUMBER_RE = '\\b\\d+(\\.\\d+)?'; this.C_NUMBER_RE = '\\b(0[xX][a-fA-F0-9]+|(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)'; // 0x..., 0..., decimal, float this.BINARY_NUMBER_RE = '\\b(0b[01]+)'; // 0b... this.RE_STARTERS_RE = '!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|\\.|-|-=|/|/=|:|;|<|<<|<<=|<=|=|==|===|>|>=|>>|>>=|>>>|>>>=|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~'; // Common modes this.BACKSLASH_ESCAPE = { begin: '\\\\.', relevance: 0 }; this.APOS_STRING_MODE = { className: 'string', begin: '\'', end: '\'', illegal: '\\n', contains: [this.BACKSLASH_ESCAPE], relevance: 0 }; this.QUOTE_STRING_MODE = { className: 'string', begin: '"', end: '"', illegal: '\\n', contains: [this.BACKSLASH_ESCAPE], relevance: 0 }; this.C_LINE_COMMENT_MODE = { className: 'comment', begin: '//', end: '$' }; this.C_BLOCK_COMMENT_MODE = { className: 'comment', begin: '/\\*', end: '\\*/' }; this.HASH_COMMENT_MODE = { className: 'comment', begin: '#', end: '$' }; this.NUMBER_MODE = { className: 'number', begin: this.NUMBER_RE, relevance: 0 }; this.C_NUMBER_MODE = { className: 'number', begin: this.C_NUMBER_RE, relevance: 0 }; this.BINARY_NUMBER_MODE = { className: 'number', begin: this.BINARY_NUMBER_RE, relevance: 0 }; // Utility functions this.inherit = function(parent, obj) { var result = {} for (var key in parent) result[key] = parent[key]; if (obj) for (var key in obj) result[key] = obj[key]; return result; } }(); ================================================ FILE: themes/default/assets/javascript/vendor/jquery.js ================================================ /*! * jQuery JavaScript Library v1.8.1 * http://jquery.com/ * * Includes Sizzle.js * http://sizzlejs.com/ * * Copyright 2012 jQuery Foundation and other contributors * Released under the MIT license * http://jquery.org/license * * Date: Thu Aug 30 2012 17:17:22 GMT-0400 (Eastern Daylight Time) */ (function( window, undefined ) { var // A central reference to the root jQuery(document) rootjQuery, // The deferred used on DOM ready readyList, // Use the correct document accordingly with window argument (sandbox) document = window.document, location = window.location, navigator = window.navigator, // Map over jQuery in case of overwrite _jQuery = window.jQuery, // Map over the $ in case of overwrite _$ = window.$, // Save a reference to some core methods core_push = Array.prototype.push, core_slice = Array.prototype.slice, core_indexOf = Array.prototype.indexOf, core_toString = Object.prototype.toString, core_hasOwn = Object.prototype.hasOwnProperty, core_trim = String.prototype.trim, // Define a local copy of jQuery jQuery = function( selector, context ) { // The jQuery object is actually just the init constructor 'enhanced' return new jQuery.fn.init( selector, context, rootjQuery ); }, // Used for matching numbers core_pnum = /[\-+]?(?:\d*\.|)\d+(?:[eE][\-+]?\d+|)/.source, // Used for detecting and trimming whitespace core_rnotwhite = /\S/, core_rspace = /\s+/, // Make sure we trim BOM and NBSP (here's looking at you, Safari 5.0 and IE) rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, // A simple way to check for HTML strings // Prioritize #id over to avoid XSS via location.hash (#9521) rquickExpr = /^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/, // Match a standalone tag rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>|)$/, // JSON RegExp rvalidchars = /^[\],:{}\s]*$/, rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, rvalidescape = /\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g, rvalidtokens = /"[^"\\\r\n]*"|true|false|null|-?(?:\d\d*\.|)\d+(?:[eE][\-+]?\d+|)/g, // Matches dashed string for camelizing rmsPrefix = /^-ms-/, rdashAlpha = /-([\da-z])/gi, // Used by jQuery.camelCase as callback to replace() fcamelCase = function( all, letter ) { return ( letter + "" ).toUpperCase(); }, // The ready event handler and self cleanup method DOMContentLoaded = function() { if ( document.addEventListener ) { document.removeEventListener( "DOMContentLoaded", DOMContentLoaded, false ); jQuery.ready(); } else if ( document.readyState === "complete" ) { // we're here because readyState === "complete" in oldIE // which is good enough for us to call the dom ready! document.detachEvent( "onreadystatechange", DOMContentLoaded ); jQuery.ready(); } }, // [[Class]] -> type pairs class2type = {}; jQuery.fn = jQuery.prototype = { constructor: jQuery, init: function( selector, context, rootjQuery ) { var match, elem, ret, doc; // Handle $(""), $(null), $(undefined), $(false) if ( !selector ) { return this; } // Handle $(DOMElement) if ( selector.nodeType ) { this.context = this[0] = selector; this.length = 1; return this; } // Handle HTML strings if ( typeof selector === "string" ) { if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { // Assume that strings that start and end with <> are HTML and skip the regex check match = [ null, selector, null ]; } else { match = rquickExpr.exec( selector ); } // Match html or make sure no context is specified for #id if ( match && (match[1] || !context) ) { // HANDLE: $(html) -> $(array) if ( match[1] ) { context = context instanceof jQuery ? context[0] : context; doc = ( context && context.nodeType ? context.ownerDocument || context : document ); // scripts is true for back-compat selector = jQuery.parseHTML( match[1], doc, true ); if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) { this.attr.call( selector, context, true ); } return jQuery.merge( this, selector ); // HANDLE: $(#id) } else { elem = document.getElementById( match[2] ); // Check parentNode to catch when Blackberry 4.6 returns // nodes that are no longer in the document #6963 if ( elem && elem.parentNode ) { // Handle the case where IE and Opera return items // by name instead of ID if ( elem.id !== match[2] ) { return rootjQuery.find( selector ); } // Otherwise, we inject the element directly into the jQuery object this.length = 1; this[0] = elem; } this.context = document; this.selector = selector; return this; } // HANDLE: $(expr, $(...)) } else if ( !context || context.jquery ) { return ( context || rootjQuery ).find( selector ); // HANDLE: $(expr, context) // (which is just equivalent to: $(context).find(expr) } else { return this.constructor( context ).find( selector ); } // HANDLE: $(function) // Shortcut for document ready } else if ( jQuery.isFunction( selector ) ) { return rootjQuery.ready( selector ); } if ( selector.selector !== undefined ) { this.selector = selector.selector; this.context = selector.context; } return jQuery.makeArray( selector, this ); }, // Start with an empty selector selector: "", // The current version of jQuery being used jquery: "1.8.1", // The default length of a jQuery object is 0 length: 0, // The number of elements contained in the matched element set size: function() { return this.length; }, toArray: function() { return core_slice.call( this ); }, // Get the Nth element in the matched element set OR // Get the whole matched element set as a clean array get: function( num ) { return num == null ? // Return a 'clean' array this.toArray() : // Return just the object ( num < 0 ? this[ this.length + num ] : this[ num ] ); }, // Take an array of elements and push it onto the stack // (returning the new matched element set) pushStack: function( elems, name, selector ) { // Build a new jQuery matched element set var ret = jQuery.merge( this.constructor(), elems ); // Add the old object onto the stack (as a reference) ret.prevObject = this; ret.context = this.context; if ( name === "find" ) { ret.selector = this.selector + ( this.selector ? " " : "" ) + selector; } else if ( name ) { ret.selector = this.selector + "." + name + "(" + selector + ")"; } // Return the newly-formed element set return ret; }, // Execute a callback for every element in the matched set. // (You can seed the arguments with an array of args, but this is // only used internally.) each: function( callback, args ) { return jQuery.each( this, callback, args ); }, ready: function( fn ) { // Add the callback jQuery.ready.promise().done( fn ); return this; }, eq: function( i ) { i = +i; return i === -1 ? this.slice( i ) : this.slice( i, i + 1 ); }, first: function() { return this.eq( 0 ); }, last: function() { return this.eq( -1 ); }, slice: function() { return this.pushStack( core_slice.apply( this, arguments ), "slice", core_slice.call(arguments).join(",") ); }, map: function( callback ) { return this.pushStack( jQuery.map(this, function( elem, i ) { return callback.call( elem, i, elem ); })); }, end: function() { return this.prevObject || this.constructor(null); }, // For internal use only. // Behaves like an Array's method, not like a jQuery method. push: core_push, sort: [].sort, splice: [].splice }; // Give the init function the jQuery prototype for later instantiation jQuery.fn.init.prototype = jQuery.fn; jQuery.extend = jQuery.fn.extend = function() { var options, name, src, copy, copyIsArray, clone, target = arguments[0] || {}, i = 1, length = arguments.length, deep = false; // Handle a deep copy situation if ( typeof target === "boolean" ) { deep = target; target = arguments[1] || {}; // skip the boolean and the target i = 2; } // Handle case when target is a string or something (possible in deep copy) if ( typeof target !== "object" && !jQuery.isFunction(target) ) { target = {}; } // extend jQuery itself if only one argument is passed if ( length === i ) { target = this; --i; } for ( ; i < length; i++ ) { // Only deal with non-null/undefined values if ( (options = arguments[ i ]) != null ) { // Extend the base object for ( name in options ) { src = target[ name ]; copy = options[ name ]; // Prevent never-ending loop if ( target === copy ) { continue; } // Recurse if we're merging plain objects or arrays if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { if ( copyIsArray ) { copyIsArray = false; clone = src && jQuery.isArray(src) ? src : []; } else { clone = src && jQuery.isPlainObject(src) ? src : {}; } // Never move original objects, clone them target[ name ] = jQuery.extend( deep, clone, copy ); // Don't bring in undefined values } else if ( copy !== undefined ) { target[ name ] = copy; } } } } // Return the modified object return target; }; jQuery.extend({ noConflict: function( deep ) { if ( window.$ === jQuery ) { window.$ = _$; } if ( deep && window.jQuery === jQuery ) { window.jQuery = _jQuery; } return jQuery; }, // Is the DOM ready to be used? Set to true once it occurs. isReady: false, // A counter to track how many items to wait for before // the ready event fires. See #6781 readyWait: 1, // Hold (or release) the ready event holdReady: function( hold ) { if ( hold ) { jQuery.readyWait++; } else { jQuery.ready( true ); } }, // Handle when the DOM is ready ready: function( wait ) { // Abort if there are pending holds or we're already ready if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { return; } // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). if ( !document.body ) { return setTimeout( jQuery.ready, 1 ); } // Remember that the DOM is ready jQuery.isReady = true; // If a normal DOM Ready event fired, decrement, and wait if need be if ( wait !== true && --jQuery.readyWait > 0 ) { return; } // If there are functions bound, to execute readyList.resolveWith( document, [ jQuery ] ); // Trigger any bound ready events if ( jQuery.fn.trigger ) { jQuery( document ).trigger("ready").off("ready"); } }, // See test/unit/core.js for details concerning isFunction. // Since version 1.3, DOM methods and functions like alert // aren't supported. They return false on IE (#2968). isFunction: function( obj ) { return jQuery.type(obj) === "function"; }, isArray: Array.isArray || function( obj ) { return jQuery.type(obj) === "array"; }, isWindow: function( obj ) { return obj != null && obj == obj.window; }, isNumeric: function( obj ) { return !isNaN( parseFloat(obj) ) && isFinite( obj ); }, type: function( obj ) { return obj == null ? String( obj ) : class2type[ core_toString.call(obj) ] || "object"; }, isPlainObject: function( obj ) { // Must be an Object. // Because of IE, we also have to check the presence of the constructor property. // Make sure that DOM nodes and window objects don't pass through, as well if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { return false; } try { // Not own constructor property must be Object if ( obj.constructor && !core_hasOwn.call(obj, "constructor") && !core_hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { return false; } } catch ( e ) { // IE8,9 Will throw exceptions on certain host objects #9897 return false; } // Own properties are enumerated firstly, so to speed up, // if last one is own, then all properties are own. var key; for ( key in obj ) {} return key === undefined || core_hasOwn.call( obj, key ); }, isEmptyObject: function( obj ) { var name; for ( name in obj ) { return false; } return true; }, error: function( msg ) { throw new Error( msg ); }, // data: string of html // context (optional): If specified, the fragment will be created in this context, defaults to document // scripts (optional): If true, will include scripts passed in the html string parseHTML: function( data, context, scripts ) { var parsed; if ( !data || typeof data !== "string" ) { return null; } if ( typeof context === "boolean" ) { scripts = context; context = 0; } context = context || document; // Single tag if ( (parsed = rsingleTag.exec( data )) ) { return [ context.createElement( parsed[1] ) ]; } parsed = jQuery.buildFragment( [ data ], context, scripts ? null : [] ); return jQuery.merge( [], (parsed.cacheable ? jQuery.clone( parsed.fragment ) : parsed.fragment).childNodes ); }, parseJSON: function( data ) { if ( !data || typeof data !== "string") { return null; } // Make sure leading/trailing whitespace is removed (IE can't handle it) data = jQuery.trim( data ); // Attempt to parse using the native JSON parser first if ( window.JSON && window.JSON.parse ) { return window.JSON.parse( data ); } // Make sure the incoming data is actual JSON // Logic borrowed from http://json.org/json2.js if ( rvalidchars.test( data.replace( rvalidescape, "@" ) .replace( rvalidtokens, "]" ) .replace( rvalidbraces, "")) ) { return ( new Function( "return " + data ) )(); } jQuery.error( "Invalid JSON: " + data ); }, // Cross-browser xml parsing parseXML: function( data ) { var xml, tmp; if ( !data || typeof data !== "string" ) { return null; } try { if ( window.DOMParser ) { // Standard tmp = new DOMParser(); xml = tmp.parseFromString( data , "text/xml" ); } else { // IE xml = new ActiveXObject( "Microsoft.XMLDOM" ); xml.async = "false"; xml.loadXML( data ); } } catch( e ) { xml = undefined; } if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { jQuery.error( "Invalid XML: " + data ); } return xml; }, noop: function() {}, // Evaluates a script in a global context // Workarounds based on findings by Jim Driscoll // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context globalEval: function( data ) { if ( data && core_rnotwhite.test( data ) ) { // We use execScript on Internet Explorer // We use an anonymous function so that context is window // rather than jQuery in Firefox ( window.execScript || function( data ) { window[ "eval" ].call( window, data ); } )( data ); } }, // Convert dashed to camelCase; used by the css and data modules // Microsoft forgot to hump their vendor prefix (#9572) camelCase: function( string ) { return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); }, nodeName: function( elem, name ) { return elem.nodeName && elem.nodeName.toUpperCase() === name.toUpperCase(); }, // args is for internal usage only each: function( obj, callback, args ) { var name, i = 0, length = obj.length, isObj = length === undefined || jQuery.isFunction( obj ); if ( args ) { if ( isObj ) { for ( name in obj ) { if ( callback.apply( obj[ name ], args ) === false ) { break; } } } else { for ( ; i < length; ) { if ( callback.apply( obj[ i++ ], args ) === false ) { break; } } } // A special, fast, case for the most common use of each } else { if ( isObj ) { for ( name in obj ) { if ( callback.call( obj[ name ], name, obj[ name ] ) === false ) { break; } } } else { for ( ; i < length; ) { if ( callback.call( obj[ i ], i, obj[ i++ ] ) === false ) { break; } } } } return obj; }, // Use native String.trim function wherever possible trim: core_trim && !core_trim.call("\uFEFF\xA0") ? function( text ) { return text == null ? "" : core_trim.call( text ); } : // Otherwise use our own trimming functionality function( text ) { return text == null ? "" : text.toString().replace( rtrim, "" ); }, // results is for internal usage only makeArray: function( arr, results ) { var type, ret = results || []; if ( arr != null ) { // The window, strings (and functions) also have 'length' // Tweaked logic slightly to handle Blackberry 4.7 RegExp issues #6930 type = jQuery.type( arr ); if ( arr.length == null || type === "string" || type === "function" || type === "regexp" || jQuery.isWindow( arr ) ) { core_push.call( ret, arr ); } else { jQuery.merge( ret, arr ); } } return ret; }, inArray: function( elem, arr, i ) { var len; if ( arr ) { if ( core_indexOf ) { return core_indexOf.call( arr, elem, i ); } len = arr.length; i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0; for ( ; i < len; i++ ) { // Skip accessing in sparse arrays if ( i in arr && arr[ i ] === elem ) { return i; } } } return -1; }, merge: function( first, second ) { var l = second.length, i = first.length, j = 0; if ( typeof l === "number" ) { for ( ; j < l; j++ ) { first[ i++ ] = second[ j ]; } } else { while ( second[j] !== undefined ) { first[ i++ ] = second[ j++ ]; } } first.length = i; return first; }, grep: function( elems, callback, inv ) { var retVal, ret = [], i = 0, length = elems.length; inv = !!inv; // Go through the array, only saving the items // that pass the validator function for ( ; i < length; i++ ) { retVal = !!callback( elems[ i ], i ); if ( inv !== retVal ) { ret.push( elems[ i ] ); } } return ret; }, // arg is for internal usage only map: function( elems, callback, arg ) { var value, key, ret = [], i = 0, length = elems.length, // jquery objects are treated as arrays isArray = elems instanceof jQuery || length !== undefined && typeof length === "number" && ( ( length > 0 && elems[ 0 ] && elems[ length -1 ] ) || length === 0 || jQuery.isArray( elems ) ) ; // Go through the array, translating each of the items to their if ( isArray ) { for ( ; i < length; i++ ) { value = callback( elems[ i ], i, arg ); if ( value != null ) { ret[ ret.length ] = value; } } // Go through every key on the object, } else { for ( key in elems ) { value = callback( elems[ key ], key, arg ); if ( value != null ) { ret[ ret.length ] = value; } } } // Flatten any nested arrays return ret.concat.apply( [], ret ); }, // A global GUID counter for objects guid: 1, // Bind a function to a context, optionally partially applying any // arguments. proxy: function( fn, context ) { var tmp, args, proxy; if ( typeof context === "string" ) { tmp = fn[ context ]; context = fn; fn = tmp; } // Quick check to determine if target is callable, in the spec // this throws a TypeError, but we will just return undefined. if ( !jQuery.isFunction( fn ) ) { return undefined; } // Simulated bind args = core_slice.call( arguments, 2 ); proxy = function() { return fn.apply( context, args.concat( core_slice.call( arguments ) ) ); }; // Set the guid of unique handler to the same of original handler, so it can be removed proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; return proxy; }, // Multifunctional method to get and set values of a collection // The value/s can optionally be executed if it's a function access: function( elems, fn, key, value, chainable, emptyGet, pass ) { var exec, bulk = key == null, i = 0, length = elems.length; // Sets many values if ( key && typeof key === "object" ) { for ( i in key ) { jQuery.access( elems, fn, i, key[i], 1, emptyGet, value ); } chainable = 1; // Sets one value } else if ( value !== undefined ) { // Optionally, function values get executed if exec is true exec = pass === undefined && jQuery.isFunction( value ); if ( bulk ) { // Bulk operations only iterate when executing function values if ( exec ) { exec = fn; fn = function( elem, key, value ) { return exec.call( jQuery( elem ), value ); }; // Otherwise they run against the entire set } else { fn.call( elems, value ); fn = null; } } if ( fn ) { for (; i < length; i++ ) { fn( elems[i], key, exec ? value.call( elems[i], i, fn( elems[i], key ) ) : value, pass ); } } chainable = 1; } return chainable ? elems : // Gets bulk ? fn.call( elems ) : length ? fn( elems[0], key ) : emptyGet; }, now: function() { return ( new Date() ).getTime(); } }); jQuery.ready.promise = function( obj ) { if ( !readyList ) { readyList = jQuery.Deferred(); // Catch cases where $(document).ready() is called after the browser event has already occurred. // we once tried to use readyState "interactive" here, but it caused issues like the one // discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15 if ( document.readyState === "complete" ) { // Handle it asynchronously to allow scripts the opportunity to delay ready setTimeout( jQuery.ready, 1 ); // Standards-based browsers support DOMContentLoaded } else if ( document.addEventListener ) { // Use the handy event callback document.addEventListener( "DOMContentLoaded", DOMContentLoaded, false ); // A fallback to window.onload, that will always work window.addEventListener( "load", jQuery.ready, false ); // If IE event model is used } else { // Ensure firing before onload, maybe late but safe also for iframes document.attachEvent( "onreadystatechange", DOMContentLoaded ); // A fallback to window.onload, that will always work window.attachEvent( "onload", jQuery.ready ); // If IE and not a frame // continually check to see if the document is ready var top = false; try { top = window.frameElement == null && document.documentElement; } catch(e) {} if ( top && top.doScroll ) { (function doScrollCheck() { if ( !jQuery.isReady ) { try { // Use the trick by Diego Perini // http://javascript.nwbox.com/IEContentLoaded/ top.doScroll("left"); } catch(e) { return setTimeout( doScrollCheck, 50 ); } // and execute any waiting functions jQuery.ready(); } })(); } } } return readyList.promise( obj ); }; // Populate the class2type map jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) { class2type[ "[object " + name + "]" ] = name.toLowerCase(); }); // All jQuery objects should point back to these rootjQuery = jQuery(document); // String to Object options format cache var optionsCache = {}; // Convert String-formatted options into Object-formatted ones and store in cache function createOptions( options ) { var object = optionsCache[ options ] = {}; jQuery.each( options.split( core_rspace ), function( _, flag ) { object[ flag ] = true; }); return object; } /* * Create a callback list using the following parameters: * * options: an optional list of space-separated options that will change how * the callback list behaves or a more traditional option object * * By default a callback list will act like an event callback list and can be * "fired" multiple times. * * Possible options: * * once: will ensure the callback list can only be fired once (like a Deferred) * * memory: will keep track of previous values and will call any callback added * after the list has been fired right away with the latest "memorized" * values (like a Deferred) * * unique: will ensure a callback can only be added once (no duplicate in the list) * * stopOnFalse: interrupt callings when a callback returns false * */ jQuery.Callbacks = function( options ) { // Convert options from String-formatted to Object-formatted if needed // (we check in cache first) options = typeof options === "string" ? ( optionsCache[ options ] || createOptions( options ) ) : jQuery.extend( {}, options ); var // Last fire value (for non-forgettable lists) memory, // Flag to know if list was already fired fired, // Flag to know if list is currently firing firing, // First callback to fire (used internally by add and fireWith) firingStart, // End of the loop when firing firingLength, // Index of currently firing callback (modified by remove if needed) firingIndex, // Actual callback list list = [], // Stack of fire calls for repeatable lists stack = !options.once && [], // Fire callbacks fire = function( data ) { memory = options.memory && data; fired = true; firingIndex = firingStart || 0; firingStart = 0; firingLength = list.length; firing = true; for ( ; list && firingIndex < firingLength; firingIndex++ ) { if ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) { memory = false; // To prevent further calls using add break; } } firing = false; if ( list ) { if ( stack ) { if ( stack.length ) { fire( stack.shift() ); } } else if ( memory ) { list = []; } else { self.disable(); } } }, // Actual Callbacks object self = { // Add a callback or a collection of callbacks to the list add: function() { if ( list ) { // First, we save the current length var start = list.length; (function add( args ) { jQuery.each( args, function( _, arg ) { var type = jQuery.type( arg ); if ( type === "function" && ( !options.unique || !self.has( arg ) ) ) { list.push( arg ); } else if ( arg && arg.length && type !== "string" ) { // Inspect recursively add( arg ); } }); })( arguments ); // Do we need to add the callbacks to the // current firing batch? if ( firing ) { firingLength = list.length; // With memory, if we're not firing then // we should call right away } else if ( memory ) { firingStart = start; fire( memory ); } } return this; }, // Remove a callback from the list remove: function() { if ( list ) { jQuery.each( arguments, function( _, arg ) { var index; while( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { list.splice( index, 1 ); // Handle firing indexes if ( firing ) { if ( index <= firingLength ) { firingLength--; } if ( index <= firingIndex ) { firingIndex--; } } } }); } return this; }, // Control if a given callback is in the list has: function( fn ) { return jQuery.inArray( fn, list ) > -1; }, // Remove all callbacks from the list empty: function() { list = []; return this; }, // Have the list do nothing anymore disable: function() { list = stack = memory = undefined; return this; }, // Is it disabled? disabled: function() { return !list; }, // Lock the list in its current state lock: function() { stack = undefined; if ( !memory ) { self.disable(); } return this; }, // Is it locked? locked: function() { return !stack; }, // Call all callbacks with the given context and arguments fireWith: function( context, args ) { args = args || []; args = [ context, args.slice ? args.slice() : args ]; if ( list && ( !fired || stack ) ) { if ( firing ) { stack.push( args ); } else { fire( args ); } } return this; }, // Call all the callbacks with the given arguments fire: function() { self.fireWith( this, arguments ); return this; }, // To know if the callbacks have already been called at least once fired: function() { return !!fired; } }; return self; }; jQuery.extend({ Deferred: function( func ) { var tuples = [ // action, add listener, listener list, final state [ "resolve", "done", jQuery.Callbacks("once memory"), "resolved" ], [ "reject", "fail", jQuery.Callbacks("once memory"), "rejected" ], [ "notify", "progress", jQuery.Callbacks("memory") ] ], state = "pending", promise = { state: function() { return state; }, always: function() { deferred.done( arguments ).fail( arguments ); return this; }, then: function( /* fnDone, fnFail, fnProgress */ ) { var fns = arguments; return jQuery.Deferred(function( newDefer ) { jQuery.each( tuples, function( i, tuple ) { var action = tuple[ 0 ], fn = fns[ i ]; // deferred[ done | fail | progress ] for forwarding actions to newDefer deferred[ tuple[1] ]( jQuery.isFunction( fn ) ? function() { var returned = fn.apply( this, arguments ); if ( returned && jQuery.isFunction( returned.promise ) ) { returned.promise() .done( newDefer.resolve ) .fail( newDefer.reject ) .progress( newDefer.notify ); } else { newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); } } : newDefer[ action ] ); }); fns = null; }).promise(); }, // Get a promise for this deferred // If obj is provided, the promise aspect is added to the object promise: function( obj ) { return typeof obj === "object" ? jQuery.extend( obj, promise ) : promise; } }, deferred = {}; // Keep pipe for back-compat promise.pipe = promise.then; // Add list-specific methods jQuery.each( tuples, function( i, tuple ) { var list = tuple[ 2 ], stateString = tuple[ 3 ]; // promise[ done | fail | progress ] = list.add promise[ tuple[1] ] = list.add; // Handle state if ( stateString ) { list.add(function() { // state = [ resolved | rejected ] state = stateString; // [ reject_list | resolve_list ].disable; progress_list.lock }, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock ); } // deferred[ resolve | reject | notify ] = list.fire deferred[ tuple[0] ] = list.fire; deferred[ tuple[0] + "With" ] = list.fireWith; }); // Make the deferred a promise promise.promise( deferred ); // Call given func if any if ( func ) { func.call( deferred, deferred ); } // All done! return deferred; }, // Deferred helper when: function( subordinate /* , ..., subordinateN */ ) { var i = 0, resolveValues = core_slice.call( arguments ), length = resolveValues.length, // the count of uncompleted subordinates remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0, // the master Deferred. If resolveValues consist of only a single Deferred, just use that. deferred = remaining === 1 ? subordinate : jQuery.Deferred(), // Update function for both resolve and progress values updateFunc = function( i, contexts, values ) { return function( value ) { contexts[ i ] = this; values[ i ] = arguments.length > 1 ? core_slice.call( arguments ) : value; if( values === progressValues ) { deferred.notifyWith( contexts, values ); } else if ( !( --remaining ) ) { deferred.resolveWith( contexts, values ); } }; }, progressValues, progressContexts, resolveContexts; // add listeners to Deferred subordinates; treat others as resolved if ( length > 1 ) { progressValues = new Array( length ); progressContexts = new Array( length ); resolveContexts = new Array( length ); for ( ; i < length; i++ ) { if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) { resolveValues[ i ].promise() .done( updateFunc( i, resolveContexts, resolveValues ) ) .fail( deferred.reject ) .progress( updateFunc( i, progressContexts, progressValues ) ); } else { --remaining; } } } // if we're not waiting on anything, resolve the master if ( !remaining ) { deferred.resolveWith( resolveContexts, resolveValues ); } return deferred.promise(); } }); jQuery.support = (function() { var support, all, a, select, opt, input, fragment, eventName, i, isSupported, clickFn, div = document.createElement("div"); // Preliminary tests div.setAttribute( "className", "t" ); div.innerHTML = "
      a"; all = div.getElementsByTagName("*"); a = div.getElementsByTagName("a")[ 0 ]; a.style.cssText = "top:1px;float:left;opacity:.5"; // Can't get basic test support if ( !all || !all.length || !a ) { return {}; } // First batch of supports tests select = document.createElement("select"); opt = select.appendChild( document.createElement("option") ); input = div.getElementsByTagName("input")[ 0 ]; support = { // IE strips leading whitespace when .innerHTML is used leadingWhitespace: ( div.firstChild.nodeType === 3 ), // Make sure that tbody elements aren't automatically inserted // IE will insert them into empty tables tbody: !div.getElementsByTagName("tbody").length, // Make sure that link elements get serialized correctly by innerHTML // This requires a wrapper element in IE htmlSerialize: !!div.getElementsByTagName("link").length, // Get the style information from getAttribute // (IE uses .cssText instead) style: /top/.test( a.getAttribute("style") ), // Make sure that URLs aren't manipulated // (IE normalizes it by default) hrefNormalized: ( a.getAttribute("href") === "/a" ), // Make sure that element opacity exists // (IE uses filter instead) // Use a regex to work around a WebKit issue. See #5145 opacity: /^0.5/.test( a.style.opacity ), // Verify style float existence // (IE uses styleFloat instead of cssFloat) cssFloat: !!a.style.cssFloat, // Make sure that if no value is specified for a checkbox // that it defaults to "on". // (WebKit defaults to "" instead) checkOn: ( input.value === "on" ), // Make sure that a selected-by-default option has a working selected property. // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) optSelected: opt.selected, // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7) getSetAttribute: div.className !== "t", // Tests for enctype support on a form(#6743) enctype: !!document.createElement("form").enctype, // Makes sure cloning an html5 element does not cause problems // Where outerHTML is undefined, this still works html5Clone: document.createElement("nav").cloneNode( true ).outerHTML !== "<:nav>", // jQuery.support.boxModel DEPRECATED in 1.8 since we don't support Quirks Mode boxModel: ( document.compatMode === "CSS1Compat" ), // Will be defined later submitBubbles: true, changeBubbles: true, focusinBubbles: false, deleteExpando: true, noCloneEvent: true, inlineBlockNeedsLayout: false, shrinkWrapBlocks: false, reliableMarginRight: true, boxSizingReliable: true, pixelPosition: false }; // Make sure checked status is properly cloned input.checked = true; support.noCloneChecked = input.cloneNode( true ).checked; // Make sure that the options inside disabled selects aren't marked as disabled // (WebKit marks them as disabled) select.disabled = true; support.optDisabled = !opt.disabled; // Test to see if it's possible to delete an expando from an element // Fails in Internet Explorer try { delete div.test; } catch( e ) { support.deleteExpando = false; } if ( !div.addEventListener && div.attachEvent && div.fireEvent ) { div.attachEvent( "onclick", clickFn = function() { // Cloning a node shouldn't copy over any // bound event handlers (IE does this) support.noCloneEvent = false; }); div.cloneNode( true ).fireEvent("onclick"); div.detachEvent( "onclick", clickFn ); } // Check if a radio maintains its value // after being appended to the DOM input = document.createElement("input"); input.value = "t"; input.setAttribute( "type", "radio" ); support.radioValue = input.value === "t"; input.setAttribute( "checked", "checked" ); // #11217 - WebKit loses check when the name is after the checked attribute input.setAttribute( "name", "t" ); div.appendChild( input ); fragment = document.createDocumentFragment(); fragment.appendChild( div.lastChild ); // WebKit doesn't clone checked state correctly in fragments support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; // Check if a disconnected checkbox will retain its checked // value of true after appended to the DOM (IE6/7) support.appendChecked = input.checked; fragment.removeChild( input ); fragment.appendChild( div ); // Technique from Juriy Zaytsev // http://perfectionkills.com/detecting-event-support-without-browser-sniffing/ // We only care about the case where non-standard event systems // are used, namely in IE. Short-circuiting here helps us to // avoid an eval call (in setAttribute) which can cause CSP // to go haywire. See: https://developer.mozilla.org/en/Security/CSP if ( div.attachEvent ) { for ( i in { submit: true, change: true, focusin: true }) { eventName = "on" + i; isSupported = ( eventName in div ); if ( !isSupported ) { div.setAttribute( eventName, "return;" ); isSupported = ( typeof div[ eventName ] === "function" ); } support[ i + "Bubbles" ] = isSupported; } } // Run tests that need a body at doc ready jQuery(function() { var container, div, tds, marginDiv, divReset = "padding:0;margin:0;border:0;display:block;overflow:hidden;", body = document.getElementsByTagName("body")[0]; if ( !body ) { // Return for frameset docs that don't have a body return; } container = document.createElement("div"); container.style.cssText = "visibility:hidden;border:0;width:0;height:0;position:static;top:0;margin-top:1px"; body.insertBefore( container, body.firstChild ); // Construct the test element div = document.createElement("div"); container.appendChild( div ); // Check if table cells still have offsetWidth/Height when they are set // to display:none and there are still other visible table cells in a // table row; if so, offsetWidth/Height are not reliable for use when // determining if an element has been hidden directly using // display:none (it is still safe to use offsets if a parent element is // hidden; don safety goggles and see bug #4512 for more information). // (only IE 8 fails this test) div.innerHTML = "
      t
      "; tds = div.getElementsByTagName("td"); tds[ 0 ].style.cssText = "padding:0;margin:0;border:0;display:none"; isSupported = ( tds[ 0 ].offsetHeight === 0 ); tds[ 0 ].style.display = ""; tds[ 1 ].style.display = "none"; // Check if empty table cells still have offsetWidth/Height // (IE <= 8 fail this test) support.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 ); // Check box-sizing and margin behavior div.innerHTML = ""; div.style.cssText = "box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;"; support.boxSizing = ( div.offsetWidth === 4 ); support.doesNotIncludeMarginInBodyOffset = ( body.offsetTop !== 1 ); // NOTE: To any future maintainer, we've window.getComputedStyle // because jsdom on node.js will break without it. if ( window.getComputedStyle ) { support.pixelPosition = ( window.getComputedStyle( div, null ) || {} ).top !== "1%"; support.boxSizingReliable = ( window.getComputedStyle( div, null ) || { width: "4px" } ).width === "4px"; // Check if div with explicit width and no margin-right incorrectly // gets computed margin-right based on width of container. For more // info see bug #3333 // Fails in WebKit before Feb 2011 nightlies // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right marginDiv = document.createElement("div"); marginDiv.style.cssText = div.style.cssText = divReset; marginDiv.style.marginRight = marginDiv.style.width = "0"; div.style.width = "1px"; div.appendChild( marginDiv ); support.reliableMarginRight = !parseFloat( ( window.getComputedStyle( marginDiv, null ) || {} ).marginRight ); } if ( typeof div.style.zoom !== "undefined" ) { // Check if natively block-level elements act like inline-block // elements when setting their display to 'inline' and giving // them layout // (IE < 8 does this) div.innerHTML = ""; div.style.cssText = divReset + "width:1px;padding:1px;display:inline;zoom:1"; support.inlineBlockNeedsLayout = ( div.offsetWidth === 3 ); // Check if elements with layout shrink-wrap their children // (IE 6 does this) div.style.display = "block"; div.style.overflow = "visible"; div.innerHTML = "
      "; div.firstChild.style.width = "5px"; support.shrinkWrapBlocks = ( div.offsetWidth !== 3 ); container.style.zoom = 1; } // Null elements to avoid leaks in IE body.removeChild( container ); container = div = tds = marginDiv = null; }); // Null elements to avoid leaks in IE fragment.removeChild( div ); all = a = select = opt = input = fragment = div = null; return support; })(); var rbrace = /(?:\{[\s\S]*\}|\[[\s\S]*\])$/, rmultiDash = /([A-Z])/g; jQuery.extend({ cache: {}, deletedIds: [], // Please use with caution uuid: 0, // Unique for each copy of jQuery on the page // Non-digits removed to match rinlinejQuery expando: "jQuery" + ( jQuery.fn.jquery + Math.random() ).replace( /\D/g, "" ), // The following elements throw uncatchable exceptions if you // attempt to add expando properties to them. noData: { "embed": true, // Ban all objects except for Flash (which handle expandos) "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000", "applet": true }, hasData: function( elem ) { elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; return !!elem && !isEmptyDataObject( elem ); }, data: function( elem, name, data, pvt /* Internal Use Only */ ) { if ( !jQuery.acceptData( elem ) ) { return; } var thisCache, ret, internalKey = jQuery.expando, getByName = typeof name === "string", // We have to handle DOM nodes and JS objects differently because IE6-7 // can't GC object references properly across the DOM-JS boundary isNode = elem.nodeType, // Only DOM nodes need the global jQuery cache; JS object data is // attached directly to the object so GC can occur automatically cache = isNode ? jQuery.cache : elem, // Only defining an ID for JS objects if its cache already exists allows // the code to shortcut on the same path as a DOM node with no cache id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey; // Avoid doing any more work than we need to when trying to get data on an // object that has no data at all if ( (!id || !cache[id] || (!pvt && !cache[id].data)) && getByName && data === undefined ) { return; } if ( !id ) { // Only DOM nodes need a new unique ID for each element since their data // ends up in the global cache if ( isNode ) { elem[ internalKey ] = id = jQuery.deletedIds.pop() || ++jQuery.uuid; } else { id = internalKey; } } if ( !cache[ id ] ) { cache[ id ] = {}; // Avoids exposing jQuery metadata on plain JS objects when the object // is serialized using JSON.stringify if ( !isNode ) { cache[ id ].toJSON = jQuery.noop; } } // An object can be passed to jQuery.data instead of a key/value pair; this gets // shallow copied over onto the existing cache if ( typeof name === "object" || typeof name === "function" ) { if ( pvt ) { cache[ id ] = jQuery.extend( cache[ id ], name ); } else { cache[ id ].data = jQuery.extend( cache[ id ].data, name ); } } thisCache = cache[ id ]; // jQuery data() is stored in a separate object inside the object's internal data // cache in order to avoid key collisions between internal data and user-defined // data. if ( !pvt ) { if ( !thisCache.data ) { thisCache.data = {}; } thisCache = thisCache.data; } if ( data !== undefined ) { thisCache[ jQuery.camelCase( name ) ] = data; } // Check for both converted-to-camel and non-converted data property names // If a data property was specified if ( getByName ) { // First Try to find as-is property data ret = thisCache[ name ]; // Test for null|undefined property data if ( ret == null ) { // Try to find the camelCased property ret = thisCache[ jQuery.camelCase( name ) ]; } } else { ret = thisCache; } return ret; }, removeData: function( elem, name, pvt /* Internal Use Only */ ) { if ( !jQuery.acceptData( elem ) ) { return; } var thisCache, i, l, isNode = elem.nodeType, // See jQuery.data for more information cache = isNode ? jQuery.cache : elem, id = isNode ? elem[ jQuery.expando ] : jQuery.expando; // If there is already no cache entry for this object, there is no // purpose in continuing if ( !cache[ id ] ) { return; } if ( name ) { thisCache = pvt ? cache[ id ] : cache[ id ].data; if ( thisCache ) { // Support array or space separated string names for data keys if ( !jQuery.isArray( name ) ) { // try the string as a key before any manipulation if ( name in thisCache ) { name = [ name ]; } else { // split the camel cased version by spaces unless a key with the spaces exists name = jQuery.camelCase( name ); if ( name in thisCache ) { name = [ name ]; } else { name = name.split(" "); } } } for ( i = 0, l = name.length; i < l; i++ ) { delete thisCache[ name[i] ]; } // If there is no data left in the cache, we want to continue // and let the cache object itself get destroyed if ( !( pvt ? isEmptyDataObject : jQuery.isEmptyObject )( thisCache ) ) { return; } } } // See jQuery.data for more information if ( !pvt ) { delete cache[ id ].data; // Don't destroy the parent cache unless the internal data object // had been the only thing left in it if ( !isEmptyDataObject( cache[ id ] ) ) { return; } } // Destroy the cache if ( isNode ) { jQuery.cleanData( [ elem ], true ); // Use delete when supported for expandos or `cache` is not a window per isWindow (#10080) } else if ( jQuery.support.deleteExpando || cache != cache.window ) { delete cache[ id ]; // When all else fails, null } else { cache[ id ] = null; } }, // For internal use only. _data: function( elem, name, data ) { return jQuery.data( elem, name, data, true ); }, // A method for determining if a DOM node can handle the data expando acceptData: function( elem ) { var noData = elem.nodeName && jQuery.noData[ elem.nodeName.toLowerCase() ]; // nodes accept data unless otherwise specified; rejection can be conditional return !noData || noData !== true && elem.getAttribute("classid") === noData; } }); jQuery.fn.extend({ data: function( key, value ) { var parts, part, attr, name, l, elem = this[0], i = 0, data = null; // Gets all values if ( key === undefined ) { if ( this.length ) { data = jQuery.data( elem ); if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) { attr = elem.attributes; for ( l = attr.length; i < l; i++ ) { name = attr[i].name; if ( name.indexOf( "data-" ) === 0 ) { name = jQuery.camelCase( name.substring(5) ); dataAttr( elem, name, data[ name ] ); } } jQuery._data( elem, "parsedAttrs", true ); } } return data; } // Sets multiple values if ( typeof key === "object" ) { return this.each(function() { jQuery.data( this, key ); }); } parts = key.split( ".", 2 ); parts[1] = parts[1] ? "." + parts[1] : ""; part = parts[1] + "!"; return jQuery.access( this, function( value ) { if ( value === undefined ) { data = this.triggerHandler( "getData" + part, [ parts[0] ] ); // Try to fetch any internally stored data first if ( data === undefined && elem ) { data = jQuery.data( elem, key ); data = dataAttr( elem, key, data ); } return data === undefined && parts[1] ? this.data( parts[0] ) : data; } parts[1] = value; this.each(function() { var self = jQuery( this ); self.triggerHandler( "setData" + part, parts ); jQuery.data( this, key, value ); self.triggerHandler( "changeData" + part, parts ); }); }, null, value, arguments.length > 1, null, false ); }, removeData: function( key ) { return this.each(function() { jQuery.removeData( this, key ); }); } }); function dataAttr( elem, key, data ) { // If nothing was found internally, try to fetch any // data from the HTML5 data-* attribute if ( data === undefined && elem.nodeType === 1 ) { var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); data = elem.getAttribute( name ); if ( typeof data === "string" ) { try { data = data === "true" ? true : data === "false" ? false : data === "null" ? null : // Only convert to a number if it doesn't change the string +data + "" === data ? +data : rbrace.test( data ) ? jQuery.parseJSON( data ) : data; } catch( e ) {} // Make sure we set the data so it isn't changed later jQuery.data( elem, key, data ); } else { data = undefined; } } return data; } // checks a cache object for emptiness function isEmptyDataObject( obj ) { var name; for ( name in obj ) { // if the public data object is empty, the private is still empty if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) { continue; } if ( name !== "toJSON" ) { return false; } } return true; } jQuery.extend({ queue: function( elem, type, data ) { var queue; if ( elem ) { type = ( type || "fx" ) + "queue"; queue = jQuery._data( elem, type ); // Speed up dequeue by getting out quickly if this is just a lookup if ( data ) { if ( !queue || jQuery.isArray(data) ) { queue = jQuery._data( elem, type, jQuery.makeArray(data) ); } else { queue.push( data ); } } return queue || []; } }, dequeue: function( elem, type ) { type = type || "fx"; var queue = jQuery.queue( elem, type ), startLength = queue.length, fn = queue.shift(), hooks = jQuery._queueHooks( elem, type ), next = function() { jQuery.dequeue( elem, type ); }; // If the fx queue is dequeued, always remove the progress sentinel if ( fn === "inprogress" ) { fn = queue.shift(); startLength--; } if ( fn ) { // Add a progress sentinel to prevent the fx queue from being // automatically dequeued if ( type === "fx" ) { queue.unshift( "inprogress" ); } // clear up the last queue stop function delete hooks.stop; fn.call( elem, next, hooks ); } if ( !startLength && hooks ) { hooks.empty.fire(); } }, // not intended for public consumption - generates a queueHooks object, or returns the current one _queueHooks: function( elem, type ) { var key = type + "queueHooks"; return jQuery._data( elem, key ) || jQuery._data( elem, key, { empty: jQuery.Callbacks("once memory").add(function() { jQuery.removeData( elem, type + "queue", true ); jQuery.removeData( elem, key, true ); }) }); } }); jQuery.fn.extend({ queue: function( type, data ) { var setter = 2; if ( typeof type !== "string" ) { data = type; type = "fx"; setter--; } if ( arguments.length < setter ) { return jQuery.queue( this[0], type ); } return data === undefined ? this : this.each(function() { var queue = jQuery.queue( this, type, data ); // ensure a hooks for this queue jQuery._queueHooks( this, type ); if ( type === "fx" && queue[0] !== "inprogress" ) { jQuery.dequeue( this, type ); } }); }, dequeue: function( type ) { return this.each(function() { jQuery.dequeue( this, type ); }); }, // Based off of the plugin by Clint Helfers, with permission. // http://blindsignals.com/index.php/2009/07/jquery-delay/ delay: function( time, type ) { time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; type = type || "fx"; return this.queue( type, function( next, hooks ) { var timeout = setTimeout( next, time ); hooks.stop = function() { clearTimeout( timeout ); }; }); }, clearQueue: function( type ) { return this.queue( type || "fx", [] ); }, // Get a promise resolved when queues of a certain type // are emptied (fx is the type by default) promise: function( type, obj ) { var tmp, count = 1, defer = jQuery.Deferred(), elements = this, i = this.length, resolve = function() { if ( !( --count ) ) { defer.resolveWith( elements, [ elements ] ); } }; if ( typeof type !== "string" ) { obj = type; type = undefined; } type = type || "fx"; while( i-- ) { tmp = jQuery._data( elements[ i ], type + "queueHooks" ); if ( tmp && tmp.empty ) { count++; tmp.empty.add( resolve ); } } resolve(); return defer.promise( obj ); } }); var nodeHook, boolHook, fixSpecified, rclass = /[\t\r\n]/g, rreturn = /\r/g, rtype = /^(?:button|input)$/i, rfocusable = /^(?:button|input|object|select|textarea)$/i, rclickable = /^a(?:rea|)$/i, rboolean = /^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i, getSetAttribute = jQuery.support.getSetAttribute; jQuery.fn.extend({ attr: function( name, value ) { return jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 ); }, removeAttr: function( name ) { return this.each(function() { jQuery.removeAttr( this, name ); }); }, prop: function( name, value ) { return jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 ); }, removeProp: function( name ) { name = jQuery.propFix[ name ] || name; return this.each(function() { // try/catch handles cases where IE balks (such as removing a property on window) try { this[ name ] = undefined; delete this[ name ]; } catch( e ) {} }); }, addClass: function( value ) { var classNames, i, l, elem, setClass, c, cl; if ( jQuery.isFunction( value ) ) { return this.each(function( j ) { jQuery( this ).addClass( value.call(this, j, this.className) ); }); } if ( value && typeof value === "string" ) { classNames = value.split( core_rspace ); for ( i = 0, l = this.length; i < l; i++ ) { elem = this[ i ]; if ( elem.nodeType === 1 ) { if ( !elem.className && classNames.length === 1 ) { elem.className = value; } else { setClass = " " + elem.className + " "; for ( c = 0, cl = classNames.length; c < cl; c++ ) { if ( !~setClass.indexOf( " " + classNames[ c ] + " " ) ) { setClass += classNames[ c ] + " "; } } elem.className = jQuery.trim( setClass ); } } } } return this; }, removeClass: function( value ) { var removes, className, elem, c, cl, i, l; if ( jQuery.isFunction( value ) ) { return this.each(function( j ) { jQuery( this ).removeClass( value.call(this, j, this.className) ); }); } if ( (value && typeof value === "string") || value === undefined ) { removes = ( value || "" ).split( core_rspace ); for ( i = 0, l = this.length; i < l; i++ ) { elem = this[ i ]; if ( elem.nodeType === 1 && elem.className ) { className = (" " + elem.className + " ").replace( rclass, " " ); // loop over each item in the removal list for ( c = 0, cl = removes.length; c < cl; c++ ) { // Remove until there is nothing to remove, while ( className.indexOf(" " + removes[ c ] + " ") > -1 ) { className = className.replace( " " + removes[ c ] + " " , " " ); } } elem.className = value ? jQuery.trim( className ) : ""; } } } return this; }, toggleClass: function( value, stateVal ) { var type = typeof value, isBool = typeof stateVal === "boolean"; if ( jQuery.isFunction( value ) ) { return this.each(function( i ) { jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); }); } return this.each(function() { if ( type === "string" ) { // toggle individual class names var className, i = 0, self = jQuery( this ), state = stateVal, classNames = value.split( core_rspace ); while ( (className = classNames[ i++ ]) ) { // check each className given, space separated list state = isBool ? state : !self.hasClass( className ); self[ state ? "addClass" : "removeClass" ]( className ); } } else if ( type === "undefined" || type === "boolean" ) { if ( this.className ) { // store className if set jQuery._data( this, "__className__", this.className ); } // toggle whole className this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; } }); }, hasClass: function( selector ) { var className = " " + selector + " ", i = 0, l = this.length; for ( ; i < l; i++ ) { if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) > -1 ) { return true; } } return false; }, val: function( value ) { var hooks, ret, isFunction, elem = this[0]; if ( !arguments.length ) { if ( elem ) { hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { return ret; } ret = elem.value; return typeof ret === "string" ? // handle most common string cases ret.replace(rreturn, "") : // handle cases where value is null/undef or number ret == null ? "" : ret; } return; } isFunction = jQuery.isFunction( value ); return this.each(function( i ) { var val, self = jQuery(this); if ( this.nodeType !== 1 ) { return; } if ( isFunction ) { val = value.call( this, i, self.val() ); } else { val = value; } // Treat null/undefined as ""; convert numbers to string if ( val == null ) { val = ""; } else if ( typeof val === "number" ) { val += ""; } else if ( jQuery.isArray( val ) ) { val = jQuery.map(val, function ( value ) { return value == null ? "" : value + ""; }); } hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; // If set returns undefined, fall back to normal setting if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { this.value = val; } }); } }); jQuery.extend({ valHooks: { option: { get: function( elem ) { // attributes.value is undefined in Blackberry 4.7 but // uses .value. See #6932 var val = elem.attributes.value; return !val || val.specified ? elem.value : elem.text; } }, select: { get: function( elem ) { var value, i, max, option, index = elem.selectedIndex, values = [], options = elem.options, one = elem.type === "select-one"; // Nothing was selected if ( index < 0 ) { return null; } // Loop through all the selected options i = one ? index : 0; max = one ? index + 1 : options.length; for ( ; i < max; i++ ) { option = options[ i ]; // Don't return options that are disabled or in a disabled optgroup if ( option.selected && (jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null) && (!option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" )) ) { // Get the specific value for the option value = jQuery( option ).val(); // We don't need an array for one selects if ( one ) { return value; } // Multi-Selects return an array values.push( value ); } } // Fixes Bug #2551 -- select.val() broken in IE after form.reset() if ( one && !values.length && options.length ) { return jQuery( options[ index ] ).val(); } return values; }, set: function( elem, value ) { var values = jQuery.makeArray( value ); jQuery(elem).find("option").each(function() { this.selected = jQuery.inArray( jQuery(this).val(), values ) >= 0; }); if ( !values.length ) { elem.selectedIndex = -1; } return values; } } }, // Unused in 1.8, left in so attrFn-stabbers won't die; remove in 1.9 attrFn: {}, attr: function( elem, name, value, pass ) { var ret, hooks, notxml, nType = elem.nodeType; // don't get/set attributes on text, comment and attribute nodes if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { return; } if ( pass && jQuery.isFunction( jQuery.fn[ name ] ) ) { return jQuery( elem )[ name ]( value ); } // Fallback to prop when attributes are not supported if ( typeof elem.getAttribute === "undefined" ) { return jQuery.prop( elem, name, value ); } notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); // All attributes are lowercase // Grab necessary hook if one is defined if ( notxml ) { name = name.toLowerCase(); hooks = jQuery.attrHooks[ name ] || ( rboolean.test( name ) ? boolHook : nodeHook ); } if ( value !== undefined ) { if ( value === null ) { jQuery.removeAttr( elem, name ); return; } else if ( hooks && "set" in hooks && notxml && (ret = hooks.set( elem, value, name )) !== undefined ) { return ret; } else { elem.setAttribute( name, "" + value ); return value; } } else if ( hooks && "get" in hooks && notxml && (ret = hooks.get( elem, name )) !== null ) { return ret; } else { ret = elem.getAttribute( name ); // Non-existent attributes return null, we normalize to undefined return ret === null ? undefined : ret; } }, removeAttr: function( elem, value ) { var propName, attrNames, name, isBool, i = 0; if ( value && elem.nodeType === 1 ) { attrNames = value.split( core_rspace ); for ( ; i < attrNames.length; i++ ) { name = attrNames[ i ]; if ( name ) { propName = jQuery.propFix[ name ] || name; isBool = rboolean.test( name ); // See #9699 for explanation of this approach (setting first, then removal) // Do not do this for boolean attributes (see #10870) if ( !isBool ) { jQuery.attr( elem, name, "" ); } elem.removeAttribute( getSetAttribute ? name : propName ); // Set corresponding property to false for boolean attributes if ( isBool && propName in elem ) { elem[ propName ] = false; } } } } }, attrHooks: { type: { set: function( elem, value ) { // We can't allow the type property to be changed (since it causes problems in IE) if ( rtype.test( elem.nodeName ) && elem.parentNode ) { jQuery.error( "type property can't be changed" ); } else if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { // Setting the type on a radio button after the value resets the value in IE6-9 // Reset value to it's default in case type is set after value // This is for element creation var val = elem.value; elem.setAttribute( "type", value ); if ( val ) { elem.value = val; } return value; } } }, // Use the value property for back compat // Use the nodeHook for button elements in IE6/7 (#1954) value: { get: function( elem, name ) { if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { return nodeHook.get( elem, name ); } return name in elem ? elem.value : null; }, set: function( elem, value, name ) { if ( nodeHook && jQuery.nodeName( elem, "button" ) ) { return nodeHook.set( elem, value, name ); } // Does not return so that setAttribute is also used elem.value = value; } } }, propFix: { tabindex: "tabIndex", readonly: "readOnly", "for": "htmlFor", "class": "className", maxlength: "maxLength", cellspacing: "cellSpacing", cellpadding: "cellPadding", rowspan: "rowSpan", colspan: "colSpan", usemap: "useMap", frameborder: "frameBorder", contenteditable: "contentEditable" }, prop: function( elem, name, value ) { var ret, hooks, notxml, nType = elem.nodeType; // don't get/set properties on text, comment and attribute nodes if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { return; } notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); if ( notxml ) { // Fix name and attach hooks name = jQuery.propFix[ name ] || name; hooks = jQuery.propHooks[ name ]; } if ( value !== undefined ) { if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { return ret; } else { return ( elem[ name ] = value ); } } else { if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { return ret; } else { return elem[ name ]; } } }, propHooks: { tabIndex: { get: function( elem ) { // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ var attributeNode = elem.getAttributeNode("tabindex"); return attributeNode && attributeNode.specified ? parseInt( attributeNode.value, 10 ) : rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? 0 : undefined; } } } }); // Hook for boolean attributes boolHook = { get: function( elem, name ) { // Align boolean attributes with corresponding properties // Fall back to attribute presence where some booleans are not supported var attrNode, property = jQuery.prop( elem, name ); return property === true || typeof property !== "boolean" && ( attrNode = elem.getAttributeNode(name) ) && attrNode.nodeValue !== false ? name.toLowerCase() : undefined; }, set: function( elem, value, name ) { var propName; if ( value === false ) { // Remove boolean attributes when set to false jQuery.removeAttr( elem, name ); } else { // value is true since we know at this point it's type boolean and not false // Set boolean attributes to the same name and set the DOM property propName = jQuery.propFix[ name ] || name; if ( propName in elem ) { // Only set the IDL specifically if it already exists on the element elem[ propName ] = true; } elem.setAttribute( name, name.toLowerCase() ); } return name; } }; // IE6/7 do not support getting/setting some attributes with get/setAttribute if ( !getSetAttribute ) { fixSpecified = { name: true, id: true, coords: true }; // Use this for any attribute in IE6/7 // This fixes almost every IE6/7 issue nodeHook = jQuery.valHooks.button = { get: function( elem, name ) { var ret; ret = elem.getAttributeNode( name ); return ret && ( fixSpecified[ name ] ? ret.value !== "" : ret.specified ) ? ret.value : undefined; }, set: function( elem, value, name ) { // Set the existing or create a new attribute node var ret = elem.getAttributeNode( name ); if ( !ret ) { ret = document.createAttribute( name ); elem.setAttributeNode( ret ); } return ( ret.value = value + "" ); } }; // Set width and height to auto instead of 0 on empty string( Bug #8150 ) // This is for removals jQuery.each([ "width", "height" ], function( i, name ) { jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { set: function( elem, value ) { if ( value === "" ) { elem.setAttribute( name, "auto" ); return value; } } }); }); // Set contenteditable to false on removals(#10429) // Setting to empty string throws an error as an invalid value jQuery.attrHooks.contenteditable = { get: nodeHook.get, set: function( elem, value, name ) { if ( value === "" ) { value = "false"; } nodeHook.set( elem, value, name ); } }; } // Some attributes require a special call on IE if ( !jQuery.support.hrefNormalized ) { jQuery.each([ "href", "src", "width", "height" ], function( i, name ) { jQuery.attrHooks[ name ] = jQuery.extend( jQuery.attrHooks[ name ], { get: function( elem ) { var ret = elem.getAttribute( name, 2 ); return ret === null ? undefined : ret; } }); }); } if ( !jQuery.support.style ) { jQuery.attrHooks.style = { get: function( elem ) { // Return undefined in the case of empty string // Normalize to lowercase since IE uppercases css property names return elem.style.cssText.toLowerCase() || undefined; }, set: function( elem, value ) { return ( elem.style.cssText = "" + value ); } }; } // Safari mis-reports the default selected property of an option // Accessing the parent's selectedIndex property fixes it if ( !jQuery.support.optSelected ) { jQuery.propHooks.selected = jQuery.extend( jQuery.propHooks.selected, { get: function( elem ) { var parent = elem.parentNode; if ( parent ) { parent.selectedIndex; // Make sure that it also works with optgroups, see #5701 if ( parent.parentNode ) { parent.parentNode.selectedIndex; } } return null; } }); } // IE6/7 call enctype encoding if ( !jQuery.support.enctype ) { jQuery.propFix.enctype = "encoding"; } // Radios and checkboxes getter/setter if ( !jQuery.support.checkOn ) { jQuery.each([ "radio", "checkbox" ], function() { jQuery.valHooks[ this ] = { get: function( elem ) { // Handle the case where in Webkit "" is returned instead of "on" if a value isn't specified return elem.getAttribute("value") === null ? "on" : elem.value; } }; }); } jQuery.each([ "radio", "checkbox" ], function() { jQuery.valHooks[ this ] = jQuery.extend( jQuery.valHooks[ this ], { set: function( elem, value ) { if ( jQuery.isArray( value ) ) { return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 ); } } }); }); var rformElems = /^(?:textarea|input|select)$/i, rtypenamespace = /^([^\.]*|)(?:\.(.+)|)$/, rhoverHack = /(?:^|\s)hover(\.\S+|)\b/, rkeyEvent = /^key/, rmouseEvent = /^(?:mouse|contextmenu)|click/, rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, hoverHack = function( events ) { return jQuery.event.special.hover ? events : events.replace( rhoverHack, "mouseenter$1 mouseleave$1" ); }; /* * Helper functions for managing events -- not part of the public interface. * Props to Dean Edwards' addEvent library for many of the ideas. */ jQuery.event = { add: function( elem, types, handler, data, selector ) { var elemData, eventHandle, events, t, tns, type, namespaces, handleObj, handleObjIn, handlers, special; // Don't attach events to noData or text/comment nodes (allow plain objects tho) if ( elem.nodeType === 3 || elem.nodeType === 8 || !types || !handler || !(elemData = jQuery._data( elem )) ) { return; } // Caller can pass in an object of custom data in lieu of the handler if ( handler.handler ) { handleObjIn = handler; handler = handleObjIn.handler; selector = handleObjIn.selector; } // Make sure that the handler has a unique ID, used to find/remove it later if ( !handler.guid ) { handler.guid = jQuery.guid++; } // Init the element's event structure and main handler, if this is the first events = elemData.events; if ( !events ) { elemData.events = events = {}; } eventHandle = elemData.handle; if ( !eventHandle ) { elemData.handle = eventHandle = function( e ) { // Discard the second event of a jQuery.event.trigger() and // when an event is called after a page has unloaded return typeof jQuery !== "undefined" && (!e || jQuery.event.triggered !== e.type) ? jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : undefined; }; // Add elem as a property of the handle fn to prevent a memory leak with IE non-native events eventHandle.elem = elem; } // Handle multiple events separated by a space // jQuery(...).bind("mouseover mouseout", fn); types = jQuery.trim( hoverHack(types) ).split( " " ); for ( t = 0; t < types.length; t++ ) { tns = rtypenamespace.exec( types[t] ) || []; type = tns[1]; namespaces = ( tns[2] || "" ).split( "." ).sort(); // If event changes its type, use the special event handlers for the changed type special = jQuery.event.special[ type ] || {}; // If selector defined, determine special event api type, otherwise given type type = ( selector ? special.delegateType : special.bindType ) || type; // Update special based on newly reset type special = jQuery.event.special[ type ] || {}; // handleObj is passed to all event handlers handleObj = jQuery.extend({ type: type, origType: tns[1], data: data, handler: handler, guid: handler.guid, selector: selector, namespace: namespaces.join(".") }, handleObjIn ); // Init the event handler queue if we're the first handlers = events[ type ]; if ( !handlers ) { handlers = events[ type ] = []; handlers.delegateCount = 0; // Only use addEventListener/attachEvent if the special events handler returns false if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { // Bind the global event handler to the element if ( elem.addEventListener ) { elem.addEventListener( type, eventHandle, false ); } else if ( elem.attachEvent ) { elem.attachEvent( "on" + type, eventHandle ); } } } if ( special.add ) { special.add.call( elem, handleObj ); if ( !handleObj.handler.guid ) { handleObj.handler.guid = handler.guid; } } // Add to the element's handler list, delegates in front if ( selector ) { handlers.splice( handlers.delegateCount++, 0, handleObj ); } else { handlers.push( handleObj ); } // Keep track of which events have ever been used, for event optimization jQuery.event.global[ type ] = true; } // Nullify elem to prevent memory leaks in IE elem = null; }, global: {}, // Detach an event or set of events from an element remove: function( elem, types, handler, selector, mappedTypes ) { var t, tns, type, origType, namespaces, origCount, j, events, special, eventType, handleObj, elemData = jQuery.hasData( elem ) && jQuery._data( elem ); if ( !elemData || !(events = elemData.events) ) { return; } // Once for each type.namespace in types; type may be omitted types = jQuery.trim( hoverHack( types || "" ) ).split(" "); for ( t = 0; t < types.length; t++ ) { tns = rtypenamespace.exec( types[t] ) || []; type = origType = tns[1]; namespaces = tns[2]; // Unbind all events (on this namespace, if provided) for the element if ( !type ) { for ( type in events ) { jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); } continue; } special = jQuery.event.special[ type ] || {}; type = ( selector? special.delegateType : special.bindType ) || type; eventType = events[ type ] || []; origCount = eventType.length; namespaces = namespaces ? new RegExp("(^|\\.)" + namespaces.split(".").sort().join("\\.(?:.*\\.|)") + "(\\.|$)") : null; // Remove matching events for ( j = 0; j < eventType.length; j++ ) { handleObj = eventType[ j ]; if ( ( mappedTypes || origType === handleObj.origType ) && ( !handler || handler.guid === handleObj.guid ) && ( !namespaces || namespaces.test( handleObj.namespace ) ) && ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { eventType.splice( j--, 1 ); if ( handleObj.selector ) { eventType.delegateCount--; } if ( special.remove ) { special.remove.call( elem, handleObj ); } } } // Remove generic event handler if we removed something and no more handlers exist // (avoids potential for endless recursion during removal of special event handlers) if ( eventType.length === 0 && origCount !== eventType.length ) { if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) { jQuery.removeEvent( elem, type, elemData.handle ); } delete events[ type ]; } } // Remove the expando if it's no longer used if ( jQuery.isEmptyObject( events ) ) { delete elemData.handle; // removeData also checks for emptiness and clears the expando if empty // so use it instead of delete jQuery.removeData( elem, "events", true ); } }, // Events that are safe to short-circuit if no handlers are attached. // Native DOM events should not be added, they may have inline handlers. customEvent: { "getData": true, "setData": true, "changeData": true }, trigger: function( event, data, elem, onlyHandlers ) { // Don't do events on text and comment nodes if ( elem && (elem.nodeType === 3 || elem.nodeType === 8) ) { return; } // Event object or event type var cache, exclusive, i, cur, old, ontype, special, handle, eventPath, bubbleType, type = event.type || event, namespaces = []; // focus/blur morphs to focusin/out; ensure we're not firing them right now if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { return; } if ( type.indexOf( "!" ) >= 0 ) { // Exclusive events trigger only for the exact event (no namespaces) type = type.slice(0, -1); exclusive = true; } if ( type.indexOf( "." ) >= 0 ) { // Namespaced trigger; create a regexp to match event type in handle() namespaces = type.split("."); type = namespaces.shift(); namespaces.sort(); } if ( (!elem || jQuery.event.customEvent[ type ]) && !jQuery.event.global[ type ] ) { // No jQuery handlers for this event type, and it can't have inline handlers return; } // Caller can pass in an Event, Object, or just an event type string event = typeof event === "object" ? // jQuery.Event object event[ jQuery.expando ] ? event : // Object literal new jQuery.Event( type, event ) : // Just the event type (string) new jQuery.Event( type ); event.type = type; event.isTrigger = true; event.exclusive = exclusive; event.namespace = namespaces.join( "." ); event.namespace_re = event.namespace? new RegExp("(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)") : null; ontype = type.indexOf( ":" ) < 0 ? "on" + type : ""; // Handle a global trigger if ( !elem ) { // TODO: Stop taunting the data cache; remove global events and always attach to document cache = jQuery.cache; for ( i in cache ) { if ( cache[ i ].events && cache[ i ].events[ type ] ) { jQuery.event.trigger( event, data, cache[ i ].handle.elem, true ); } } return; } // Clean up the event in case it is being reused event.result = undefined; if ( !event.target ) { event.target = elem; } // Clone any incoming data and prepend the event, creating the handler arg list data = data != null ? jQuery.makeArray( data ) : []; data.unshift( event ); // Allow special events to draw outside the lines special = jQuery.event.special[ type ] || {}; if ( special.trigger && special.trigger.apply( elem, data ) === false ) { return; } // Determine event propagation path in advance, per W3C events spec (#9951) // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) eventPath = [[ elem, special.bindType || type ]]; if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { bubbleType = special.delegateType || type; cur = rfocusMorph.test( bubbleType + type ) ? elem : elem.parentNode; for ( old = elem; cur; cur = cur.parentNode ) { eventPath.push([ cur, bubbleType ]); old = cur; } // Only add window if we got to document (e.g., not plain obj or detached DOM) if ( old === (elem.ownerDocument || document) ) { eventPath.push([ old.defaultView || old.parentWindow || window, bubbleType ]); } } // Fire handlers on the event path for ( i = 0; i < eventPath.length && !event.isPropagationStopped(); i++ ) { cur = eventPath[i][0]; event.type = eventPath[i][1]; handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" ); if ( handle ) { handle.apply( cur, data ); } // Note that this is a bare JS function and not a jQuery handler handle = ontype && cur[ ontype ]; if ( handle && jQuery.acceptData( cur ) && handle.apply( cur, data ) === false ) { event.preventDefault(); } } event.type = type; // If nobody prevented the default action, do it now if ( !onlyHandlers && !event.isDefaultPrevented() ) { if ( (!special._default || special._default.apply( elem.ownerDocument, data ) === false) && !(type === "click" && jQuery.nodeName( elem, "a" )) && jQuery.acceptData( elem ) ) { // Call a native DOM method on the target with the same name name as the event. // Can't use an .isFunction() check here because IE6/7 fails that test. // Don't do default actions on window, that's where global variables be (#6170) // IE<9 dies on focus/blur to hidden element (#1486) if ( ontype && elem[ type ] && ((type !== "focus" && type !== "blur") || event.target.offsetWidth !== 0) && !jQuery.isWindow( elem ) ) { // Don't re-trigger an onFOO event when we call its FOO() method old = elem[ ontype ]; if ( old ) { elem[ ontype ] = null; } // Prevent re-triggering of the same event, since we already bubbled it above jQuery.event.triggered = type; elem[ type ](); jQuery.event.triggered = undefined; if ( old ) { elem[ ontype ] = old; } } } } return event.result; }, dispatch: function( event ) { // Make a writable jQuery.Event from the native event object event = jQuery.event.fix( event || window.event ); var i, j, cur, ret, selMatch, matched, matches, handleObj, sel, related, handlers = ( (jQuery._data( this, "events" ) || {} )[ event.type ] || []), delegateCount = handlers.delegateCount, args = [].slice.call( arguments ), run_all = !event.exclusive && !event.namespace, special = jQuery.event.special[ event.type ] || {}, handlerQueue = []; // Use the fix-ed jQuery.Event rather than the (read-only) native event args[0] = event; event.delegateTarget = this; // Call the preDispatch hook for the mapped type, and let it bail if desired if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { return; } // Determine handlers that should run if there are delegated events // Avoid non-left-click bubbling in Firefox (#3861) if ( delegateCount && !(event.button && event.type === "click") ) { for ( cur = event.target; cur != this; cur = cur.parentNode || this ) { // Don't process clicks (ONLY) on disabled elements (#6911, #8165, #11382, #11764) if ( cur.disabled !== true || event.type !== "click" ) { selMatch = {}; matches = []; for ( i = 0; i < delegateCount; i++ ) { handleObj = handlers[ i ]; sel = handleObj.selector; if ( selMatch[ sel ] === undefined ) { selMatch[ sel ] = jQuery( sel, this ).index( cur ) >= 0; } if ( selMatch[ sel ] ) { matches.push( handleObj ); } } if ( matches.length ) { handlerQueue.push({ elem: cur, matches: matches }); } } } } // Add the remaining (directly-bound) handlers if ( handlers.length > delegateCount ) { handlerQueue.push({ elem: this, matches: handlers.slice( delegateCount ) }); } // Run delegates first; they may want to stop propagation beneath us for ( i = 0; i < handlerQueue.length && !event.isPropagationStopped(); i++ ) { matched = handlerQueue[ i ]; event.currentTarget = matched.elem; for ( j = 0; j < matched.matches.length && !event.isImmediatePropagationStopped(); j++ ) { handleObj = matched.matches[ j ]; // Triggered event must either 1) be non-exclusive and have no namespace, or // 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). if ( run_all || (!event.namespace && !handleObj.namespace) || event.namespace_re && event.namespace_re.test( handleObj.namespace ) ) { event.data = handleObj.data; event.handleObj = handleObj; ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) .apply( matched.elem, args ); if ( ret !== undefined ) { event.result = ret; if ( ret === false ) { event.preventDefault(); event.stopPropagation(); } } } } } // Call the postDispatch hook for the mapped type if ( special.postDispatch ) { special.postDispatch.call( this, event ); } return event.result; }, // Includes some event props shared by KeyEvent and MouseEvent // *** attrChange attrName relatedNode srcElement are not normalized, non-W3C, deprecated, will be removed in 1.8 *** props: "attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), fixHooks: {}, keyHooks: { props: "char charCode key keyCode".split(" "), filter: function( event, original ) { // Add which for key events if ( event.which == null ) { event.which = original.charCode != null ? original.charCode : original.keyCode; } return event; } }, mouseHooks: { props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "), filter: function( event, original ) { var eventDoc, doc, body, button = original.button, fromElement = original.fromElement; // Calculate pageX/Y if missing and clientX/Y available if ( event.pageX == null && original.clientX != null ) { eventDoc = event.target.ownerDocument || document; doc = eventDoc.documentElement; body = eventDoc.body; event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); } // Add relatedTarget, if necessary if ( !event.relatedTarget && fromElement ) { event.relatedTarget = fromElement === event.target ? original.toElement : fromElement; } // Add which for click: 1 === left; 2 === middle; 3 === right // Note: button is not normalized, so don't use it if ( !event.which && button !== undefined ) { event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); } return event; } }, fix: function( event ) { if ( event[ jQuery.expando ] ) { return event; } // Create a writable copy of the event object and normalize some properties var i, prop, originalEvent = event, fixHook = jQuery.event.fixHooks[ event.type ] || {}, copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; event = jQuery.Event( originalEvent ); for ( i = copy.length; i; ) { prop = copy[ --i ]; event[ prop ] = originalEvent[ prop ]; } // Fix target property, if necessary (#1925, IE 6/7/8 & Safari2) if ( !event.target ) { event.target = originalEvent.srcElement || document; } // Target should not be a text node (#504, Safari) if ( event.target.nodeType === 3 ) { event.target = event.target.parentNode; } // For mouse/key events, metaKey==false if it's undefined (#3368, #11328; IE6/7/8) event.metaKey = !!event.metaKey; return fixHook.filter? fixHook.filter( event, originalEvent ) : event; }, special: { load: { // Prevent triggered image.load events from bubbling to window.load noBubble: true }, focus: { delegateType: "focusin" }, blur: { delegateType: "focusout" }, beforeunload: { setup: function( data, namespaces, eventHandle ) { // We only want to do this special case on windows if ( jQuery.isWindow( this ) ) { this.onbeforeunload = eventHandle; } }, teardown: function( namespaces, eventHandle ) { if ( this.onbeforeunload === eventHandle ) { this.onbeforeunload = null; } } } }, simulate: function( type, elem, event, bubble ) { // Piggyback on a donor event to simulate a different one. // Fake originalEvent to avoid donor's stopPropagation, but if the // simulated event prevents default then we do the same on the donor. var e = jQuery.extend( new jQuery.Event(), event, { type: type, isSimulated: true, originalEvent: {} } ); if ( bubble ) { jQuery.event.trigger( e, null, elem ); } else { jQuery.event.dispatch.call( elem, e ); } if ( e.isDefaultPrevented() ) { event.preventDefault(); } } }; // Some plugins are using, but it's undocumented/deprecated and will be removed. // The 1.7 special event interface should provide all the hooks needed now. jQuery.event.handle = jQuery.event.dispatch; jQuery.removeEvent = document.removeEventListener ? function( elem, type, handle ) { if ( elem.removeEventListener ) { elem.removeEventListener( type, handle, false ); } } : function( elem, type, handle ) { var name = "on" + type; if ( elem.detachEvent ) { // #8545, #7054, preventing memory leaks for custom events in IE6-8 – // detachEvent needed property on element, by name of that event, to properly expose it to GC if ( typeof elem[ name ] === "undefined" ) { elem[ name ] = null; } elem.detachEvent( name, handle ); } }; jQuery.Event = function( src, props ) { // Allow instantiation without the 'new' keyword if ( !(this instanceof jQuery.Event) ) { return new jQuery.Event( src, props ); } // Event object if ( src && src.type ) { this.originalEvent = src; this.type = src.type; // Events bubbling up the document may have been marked as prevented // by a handler lower down the tree; reflect the correct value. this.isDefaultPrevented = ( src.defaultPrevented || src.returnValue === false || src.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse; // Event type } else { this.type = src; } // Put explicitly provided properties onto the event object if ( props ) { jQuery.extend( this, props ); } // Create a timestamp if incoming event doesn't have one this.timeStamp = src && src.timeStamp || jQuery.now(); // Mark it as fixed this[ jQuery.expando ] = true; }; function returnFalse() { return false; } function returnTrue() { return true; } // jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding // http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html jQuery.Event.prototype = { preventDefault: function() { this.isDefaultPrevented = returnTrue; var e = this.originalEvent; if ( !e ) { return; } // if preventDefault exists run it on the original event if ( e.preventDefault ) { e.preventDefault(); // otherwise set the returnValue property of the original event to false (IE) } else { e.returnValue = false; } }, stopPropagation: function() { this.isPropagationStopped = returnTrue; var e = this.originalEvent; if ( !e ) { return; } // if stopPropagation exists run it on the original event if ( e.stopPropagation ) { e.stopPropagation(); } // otherwise set the cancelBubble property of the original event to true (IE) e.cancelBubble = true; }, stopImmediatePropagation: function() { this.isImmediatePropagationStopped = returnTrue; this.stopPropagation(); }, isDefaultPrevented: returnFalse, isPropagationStopped: returnFalse, isImmediatePropagationStopped: returnFalse }; // Create mouseenter/leave events using mouseover/out and event-time checks jQuery.each({ mouseenter: "mouseover", mouseleave: "mouseout" }, function( orig, fix ) { jQuery.event.special[ orig ] = { delegateType: fix, bindType: fix, handle: function( event ) { var ret, target = this, related = event.relatedTarget, handleObj = event.handleObj, selector = handleObj.selector; // For mousenter/leave call the handler if related is outside the target. // NB: No relatedTarget if the mouse left/entered the browser window if ( !related || (related !== target && !jQuery.contains( target, related )) ) { event.type = handleObj.origType; ret = handleObj.handler.apply( this, arguments ); event.type = fix; } return ret; } }; }); // IE submit delegation if ( !jQuery.support.submitBubbles ) { jQuery.event.special.submit = { setup: function() { // Only need this for delegated form submit events if ( jQuery.nodeName( this, "form" ) ) { return false; } // Lazy-add a submit handler when a descendant form may potentially be submitted jQuery.event.add( this, "click._submit keypress._submit", function( e ) { // Node name check avoids a VML-related crash in IE (#9807) var elem = e.target, form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined; if ( form && !jQuery._data( form, "_submit_attached" ) ) { jQuery.event.add( form, "submit._submit", function( event ) { event._submit_bubble = true; }); jQuery._data( form, "_submit_attached", true ); } }); // return undefined since we don't need an event listener }, postDispatch: function( event ) { // If form was submitted by the user, bubble the event up the tree if ( event._submit_bubble ) { delete event._submit_bubble; if ( this.parentNode && !event.isTrigger ) { jQuery.event.simulate( "submit", this.parentNode, event, true ); } } }, teardown: function() { // Only need this for delegated form submit events if ( jQuery.nodeName( this, "form" ) ) { return false; } // Remove delegated handlers; cleanData eventually reaps submit handlers attached above jQuery.event.remove( this, "._submit" ); } }; } // IE change delegation and checkbox/radio fix if ( !jQuery.support.changeBubbles ) { jQuery.event.special.change = { setup: function() { if ( rformElems.test( this.nodeName ) ) { // IE doesn't fire change on a check/radio until blur; trigger it on click // after a propertychange. Eat the blur-change in special.change.handle. // This still fires onchange a second time for check/radio after blur. if ( this.type === "checkbox" || this.type === "radio" ) { jQuery.event.add( this, "propertychange._change", function( event ) { if ( event.originalEvent.propertyName === "checked" ) { this._just_changed = true; } }); jQuery.event.add( this, "click._change", function( event ) { if ( this._just_changed && !event.isTrigger ) { this._just_changed = false; } // Allow triggered, simulated change events (#11500) jQuery.event.simulate( "change", this, event, true ); }); } return false; } // Delegated event; lazy-add a change handler on descendant inputs jQuery.event.add( this, "beforeactivate._change", function( e ) { var elem = e.target; if ( rformElems.test( elem.nodeName ) && !jQuery._data( elem, "_change_attached" ) ) { jQuery.event.add( elem, "change._change", function( event ) { if ( this.parentNode && !event.isSimulated && !event.isTrigger ) { jQuery.event.simulate( "change", this.parentNode, event, true ); } }); jQuery._data( elem, "_change_attached", true ); } }); }, handle: function( event ) { var elem = event.target; // Swallow native change events from checkbox/radio, we already triggered them above if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) { return event.handleObj.handler.apply( this, arguments ); } }, teardown: function() { jQuery.event.remove( this, "._change" ); return !rformElems.test( this.nodeName ); } }; } // Create "bubbling" focus and blur events if ( !jQuery.support.focusinBubbles ) { jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { // Attach a single capturing handler while someone wants focusin/focusout var attaches = 0, handler = function( event ) { jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); }; jQuery.event.special[ fix ] = { setup: function() { if ( attaches++ === 0 ) { document.addEventListener( orig, handler, true ); } }, teardown: function() { if ( --attaches === 0 ) { document.removeEventListener( orig, handler, true ); } } }; }); } jQuery.fn.extend({ on: function( types, selector, data, fn, /*INTERNAL*/ one ) { var origFn, type; // Types can be a map of types/handlers if ( typeof types === "object" ) { // ( types-Object, selector, data ) if ( typeof selector !== "string" ) { // && selector != null // ( types-Object, data ) data = data || selector; selector = undefined; } for ( type in types ) { this.on( type, selector, data, types[ type ], one ); } return this; } if ( data == null && fn == null ) { // ( types, fn ) fn = selector; data = selector = undefined; } else if ( fn == null ) { if ( typeof selector === "string" ) { // ( types, selector, fn ) fn = data; data = undefined; } else { // ( types, data, fn ) fn = data; data = selector; selector = undefined; } } if ( fn === false ) { fn = returnFalse; } else if ( !fn ) { return this; } if ( one === 1 ) { origFn = fn; fn = function( event ) { // Can use an empty set, since event contains the info jQuery().off( event ); return origFn.apply( this, arguments ); }; // Use same guid so caller can remove using origFn fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); } return this.each( function() { jQuery.event.add( this, types, fn, data, selector ); }); }, one: function( types, selector, data, fn ) { return this.on( types, selector, data, fn, 1 ); }, off: function( types, selector, fn ) { var handleObj, type; if ( types && types.preventDefault && types.handleObj ) { // ( event ) dispatched jQuery.Event handleObj = types.handleObj; jQuery( types.delegateTarget ).off( handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, handleObj.selector, handleObj.handler ); return this; } if ( typeof types === "object" ) { // ( types-object [, selector] ) for ( type in types ) { this.off( type, selector, types[ type ] ); } return this; } if ( selector === false || typeof selector === "function" ) { // ( types [, fn] ) fn = selector; selector = undefined; } if ( fn === false ) { fn = returnFalse; } return this.each(function() { jQuery.event.remove( this, types, fn, selector ); }); }, bind: function( types, data, fn ) { return this.on( types, null, data, fn ); }, unbind: function( types, fn ) { return this.off( types, null, fn ); }, live: function( types, data, fn ) { jQuery( this.context ).on( types, this.selector, data, fn ); return this; }, die: function( types, fn ) { jQuery( this.context ).off( types, this.selector || "**", fn ); return this; }, delegate: function( selector, types, data, fn ) { return this.on( types, selector, data, fn ); }, undelegate: function( selector, types, fn ) { // ( namespace ) or ( selector, types [, fn] ) return arguments.length == 1? this.off( selector, "**" ) : this.off( types, selector || "**", fn ); }, trigger: function( type, data ) { return this.each(function() { jQuery.event.trigger( type, data, this ); }); }, triggerHandler: function( type, data ) { if ( this[0] ) { return jQuery.event.trigger( type, data, this[0], true ); } }, toggle: function( fn ) { // Save reference to arguments for access in closure var args = arguments, guid = fn.guid || jQuery.guid++, i = 0, toggler = function( event ) { // Figure out which function to execute var lastToggle = ( jQuery._data( this, "lastToggle" + fn.guid ) || 0 ) % i; jQuery._data( this, "lastToggle" + fn.guid, lastToggle + 1 ); // Make sure that clicks stop event.preventDefault(); // and execute the function return args[ lastToggle ].apply( this, arguments ) || false; }; // link all the functions, so any of them can unbind this click handler toggler.guid = guid; while ( i < args.length ) { args[ i++ ].guid = guid; } return this.click( toggler ); }, hover: function( fnOver, fnOut ) { return this.mouseenter( fnOver ).mouseleave( fnOut || fnOver ); } }); jQuery.each( ("blur focus focusin focusout load resize scroll unload click dblclick " + "mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave " + "change select submit keydown keypress keyup error contextmenu").split(" "), function( i, name ) { // Handle event binding jQuery.fn[ name ] = function( data, fn ) { if ( fn == null ) { fn = data; data = null; } return arguments.length > 0 ? this.on( name, null, data, fn ) : this.trigger( name ); }; if ( rkeyEvent.test( name ) ) { jQuery.event.fixHooks[ name ] = jQuery.event.keyHooks; } if ( rmouseEvent.test( name ) ) { jQuery.event.fixHooks[ name ] = jQuery.event.mouseHooks; } }); /*! * Sizzle CSS Selector Engine * Copyright 2012 jQuery Foundation and other contributors * Released under the MIT license * http://sizzlejs.com/ */ (function( window, undefined ) { var dirruns, cachedruns, assertGetIdNotName, Expr, getText, isXML, contains, compile, sortOrder, hasDuplicate, baseHasDuplicate = true, strundefined = "undefined", expando = ( "sizcache" + Math.random() ).replace( ".", "" ), document = window.document, docElem = document.documentElement, done = 0, slice = [].slice, push = [].push, // Augment a function for special use by Sizzle markFunction = function( fn, value ) { fn[ expando ] = value || true; return fn; }, createCache = function() { var cache = {}, keys = []; return markFunction(function( key, value ) { // Only keep the most recent entries if ( keys.push( key ) > Expr.cacheLength ) { delete cache[ keys.shift() ]; } return (cache[ key ] = value); }, cache ); }, classCache = createCache(), tokenCache = createCache(), compilerCache = createCache(), // Regex // Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace whitespace = "[\\x20\\t\\r\\n\\f]", // http://www.w3.org/TR/css3-syntax/#characters characterEncoding = "(?:\\\\.|[-\\w]|[^\\x00-\\xa0])+", // Loosely modeled on CSS identifier characters // An unquoted value should be a CSS identifier (http://www.w3.org/TR/css3-selectors/#attribute-selectors) // Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier identifier = characterEncoding.replace( "w", "w#" ), // Acceptable operators http://www.w3.org/TR/selectors/#attribute-selectors operators = "([*^$|!~]?=)", attributes = "\\[" + whitespace + "*(" + characterEncoding + ")" + whitespace + "*(?:" + operators + whitespace + "*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|(" + identifier + ")|)|)" + whitespace + "*\\]", // Prefer arguments not in parens/brackets, // then attribute selectors and non-pseudos (denoted by :), // then anything else // These preferences are here to reduce the number of selectors // needing tokenize in the PSEUDO preFilter pseudos = ":(" + characterEncoding + ")(?:\\((?:(['\"])((?:\\\\.|[^\\\\])*?)\\2|([^()[\\]]*|(?:(?:" + attributes + ")|[^:]|\\\\.)*|.*))\\)|)", // For matchExpr.POS and matchExpr.needsContext pos = ":(nth|eq|gt|lt|first|last|even|odd)(?:\\(((?:-\\d)?\\d*)\\)|)(?=[^-]|$)", // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), rcombinators = new RegExp( "^" + whitespace + "*([\\x20\\t\\r\\n\\f>+~])" + whitespace + "*" ), rpseudo = new RegExp( pseudos ), // Easily-parseable/retrievable ID or TAG or CLASS selectors rquickExpr = /^(?:#([\w\-]+)|(\w+)|\.([\w\-]+))$/, rnot = /^:not/, rsibling = /[\x20\t\r\n\f]*[+~]/, rendsWithNot = /:not\($/, rheader = /h\d/i, rinputs = /input|select|textarea|button/i, rbackslash = /\\(?!\\)/g, matchExpr = { "ID": new RegExp( "^#(" + characterEncoding + ")" ), "CLASS": new RegExp( "^\\.(" + characterEncoding + ")" ), "NAME": new RegExp( "^\\[name=['\"]?(" + characterEncoding + ")['\"]?\\]" ), "TAG": new RegExp( "^(" + characterEncoding.replace( "w", "w*" ) + ")" ), "ATTR": new RegExp( "^" + attributes ), "PSEUDO": new RegExp( "^" + pseudos ), "CHILD": new RegExp( "^:(only|nth|last|first)-child(?:\\(" + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), "POS": new RegExp( pos, "ig" ), // For use in libraries implementing .is() "needsContext": new RegExp( "^" + whitespace + "*[>+~]|" + pos, "i" ) }, // Support // Used for testing something on an element assert = function( fn ) { var div = document.createElement("div"); try { return fn( div ); } catch (e) { return false; } finally { // release memory in IE div = null; } }, // Check if getElementsByTagName("*") returns only elements assertTagNameNoComments = assert(function( div ) { div.appendChild( document.createComment("") ); return !div.getElementsByTagName("*").length; }), // Check if getAttribute returns normalized href attributes assertHrefNotNormalized = assert(function( div ) { div.innerHTML = ""; return div.firstChild && typeof div.firstChild.getAttribute !== strundefined && div.firstChild.getAttribute("href") === "#"; }), // Check if attributes should be retrieved by attribute nodes assertAttributes = assert(function( div ) { div.innerHTML = ""; var type = typeof div.lastChild.getAttribute("multiple"); // IE8 returns a string for some attributes even when not present return type !== "boolean" && type !== "string"; }), // Check if getElementsByClassName can be trusted assertUsableClassName = assert(function( div ) { // Opera can't find a second classname (in 9.6) div.innerHTML = ""; if ( !div.getElementsByClassName || !div.getElementsByClassName("e").length ) { return false; } // Safari 3.2 caches class attributes and doesn't catch changes div.lastChild.className = "e"; return div.getElementsByClassName("e").length === 2; }), // Check if getElementById returns elements by name // Check if getElementsByName privileges form controls or returns elements by ID assertUsableName = assert(function( div ) { // Inject content div.id = expando + 0; div.innerHTML = "
      "; docElem.insertBefore( div, docElem.firstChild ); // Test var pass = document.getElementsByName && // buggy browsers will return fewer than the correct 2 document.getElementsByName( expando ).length === 2 + // buggy browsers will return more than the correct 0 document.getElementsByName( expando + 0 ).length; assertGetIdNotName = !document.getElementById( expando ); // Cleanup docElem.removeChild( div ); return pass; }); // If slice is not available, provide a backup try { slice.call( docElem.childNodes, 0 )[0].nodeType; } catch ( e ) { slice = function( i ) { var elem, results = []; for ( ; (elem = this[i]); i++ ) { results.push( elem ); } return results; }; } function Sizzle( selector, context, results, seed ) { results = results || []; context = context || document; var match, elem, xml, m, nodeType = context.nodeType; if ( nodeType !== 1 && nodeType !== 9 ) { return []; } if ( !selector || typeof selector !== "string" ) { return results; } xml = isXML( context ); if ( !xml && !seed ) { if ( (match = rquickExpr.exec( selector )) ) { // Speed-up: Sizzle("#ID") if ( (m = match[1]) ) { if ( nodeType === 9 ) { elem = context.getElementById( m ); // Check parentNode to catch when Blackberry 4.6 returns // nodes that are no longer in the document #6963 if ( elem && elem.parentNode ) { // Handle the case where IE, Opera, and Webkit return items // by name instead of ID if ( elem.id === m ) { results.push( elem ); return results; } } else { return results; } } else { // Context is not a document if ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) && contains( context, elem ) && elem.id === m ) { results.push( elem ); return results; } } // Speed-up: Sizzle("TAG") } else if ( match[2] ) { push.apply( results, slice.call(context.getElementsByTagName( selector ), 0) ); return results; // Speed-up: Sizzle(".CLASS") } else if ( (m = match[3]) && assertUsableClassName && context.getElementsByClassName ) { push.apply( results, slice.call(context.getElementsByClassName( m ), 0) ); return results; } } } // All others return select( selector, context, results, seed, xml ); } Sizzle.matches = function( expr, elements ) { return Sizzle( expr, null, null, elements ); }; Sizzle.matchesSelector = function( elem, expr ) { return Sizzle( expr, null, null, [ elem ] ).length > 0; }; // Returns a function to use in pseudos for input types function createInputPseudo( type ) { return function( elem ) { var name = elem.nodeName.toLowerCase(); return name === "input" && elem.type === type; }; } // Returns a function to use in pseudos for buttons function createButtonPseudo( type ) { return function( elem ) { var name = elem.nodeName.toLowerCase(); return (name === "input" || name === "button") && elem.type === type; }; } /** * Utility function for retrieving the text value of an array of DOM nodes * @param {Array|Element} elem */ getText = Sizzle.getText = function( elem ) { var node, ret = "", i = 0, nodeType = elem.nodeType; if ( nodeType ) { if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { // Use textContent for elements // innerText usage removed for consistency of new lines (see #11153) if ( typeof elem.textContent === "string" ) { return elem.textContent; } else { // Traverse its children for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { ret += getText( elem ); } } } else if ( nodeType === 3 || nodeType === 4 ) { return elem.nodeValue; } // Do not include comment or processing instruction nodes } else { // If no nodeType, this is expected to be an array for ( ; (node = elem[i]); i++ ) { // Do not traverse comment nodes ret += getText( node ); } } return ret; }; isXML = Sizzle.isXML = function isXML( elem ) { // documentElement is verified for cases where it doesn't yet exist // (such as loading iframes in IE - #4833) var documentElement = elem && (elem.ownerDocument || elem).documentElement; return documentElement ? documentElement.nodeName !== "HTML" : false; }; // Element contains another contains = Sizzle.contains = docElem.contains ? function( a, b ) { var adown = a.nodeType === 9 ? a.documentElement : a, bup = b && b.parentNode; return a === bup || !!( bup && bup.nodeType === 1 && adown.contains && adown.contains(bup) ); } : docElem.compareDocumentPosition ? function( a, b ) { return b && !!( a.compareDocumentPosition( b ) & 16 ); } : function( a, b ) { while ( (b = b.parentNode) ) { if ( b === a ) { return true; } } return false; }; Sizzle.attr = function( elem, name ) { var attr, xml = isXML( elem ); if ( !xml ) { name = name.toLowerCase(); } if ( Expr.attrHandle[ name ] ) { return Expr.attrHandle[ name ]( elem ); } if ( assertAttributes || xml ) { return elem.getAttribute( name ); } attr = elem.getAttributeNode( name ); return attr ? typeof elem[ name ] === "boolean" ? elem[ name ] ? name : null : attr.specified ? attr.value : null : null; }; Expr = Sizzle.selectors = { // Can be adjusted by the user cacheLength: 50, createPseudo: markFunction, match: matchExpr, order: new RegExp( "ID|TAG" + (assertUsableName ? "|NAME" : "") + (assertUsableClassName ? "|CLASS" : "") ), // IE6/7 return a modified href attrHandle: assertHrefNotNormalized ? {} : { "href": function( elem ) { return elem.getAttribute( "href", 2 ); }, "type": function( elem ) { return elem.getAttribute("type"); } }, find: { "ID": assertGetIdNotName ? function( id, context, xml ) { if ( typeof context.getElementById !== strundefined && !xml ) { var m = context.getElementById( id ); // Check parentNode to catch when Blackberry 4.6 returns // nodes that are no longer in the document #6963 return m && m.parentNode ? [m] : []; } } : function( id, context, xml ) { if ( typeof context.getElementById !== strundefined && !xml ) { var m = context.getElementById( id ); return m ? m.id === id || typeof m.getAttributeNode !== strundefined && m.getAttributeNode("id").value === id ? [m] : undefined : []; } }, "TAG": assertTagNameNoComments ? function( tag, context ) { if ( typeof context.getElementsByTagName !== strundefined ) { return context.getElementsByTagName( tag ); } } : function( tag, context ) { var results = context.getElementsByTagName( tag ); // Filter out possible comments if ( tag === "*" ) { var elem, tmp = [], i = 0; for ( ; (elem = results[i]); i++ ) { if ( elem.nodeType === 1 ) { tmp.push( elem ); } } return tmp; } return results; }, "NAME": function( tag, context ) { if ( typeof context.getElementsByName !== strundefined ) { return context.getElementsByName( name ); } }, "CLASS": function( className, context, xml ) { if ( typeof context.getElementsByClassName !== strundefined && !xml ) { return context.getElementsByClassName( className ); } } }, relative: { ">": { dir: "parentNode", first: true }, " ": { dir: "parentNode" }, "+": { dir: "previousSibling", first: true }, "~": { dir: "previousSibling" } }, preFilter: { "ATTR": function( match ) { match[1] = match[1].replace( rbackslash, "" ); // Move the given value to match[3] whether quoted or unquoted match[3] = ( match[4] || match[5] || "" ).replace( rbackslash, "" ); if ( match[2] === "~=" ) { match[3] = " " + match[3] + " "; } return match.slice( 0, 4 ); }, "CHILD": function( match ) { /* matches from matchExpr.CHILD 1 type (only|nth|...) 2 argument (even|odd|\d*|\d*n([+-]\d+)?|...) 3 xn-component of xn+y argument ([+-]?\d*n|) 4 sign of xn-component 5 x of xn-component 6 sign of y-component 7 y of y-component */ match[1] = match[1].toLowerCase(); if ( match[1] === "nth" ) { // nth-child requires argument if ( !match[2] ) { Sizzle.error( match[0] ); } // numeric x and y parameters for Expr.filter.CHILD // remember that false/true cast respectively to 0/1 match[3] = +( match[3] ? match[4] + (match[5] || 1) : 2 * ( match[2] === "even" || match[2] === "odd" ) ); match[4] = +( ( match[6] + match[7] ) || match[2] === "odd" ); // other types prohibit arguments } else if ( match[2] ) { Sizzle.error( match[0] ); } return match; }, "PSEUDO": function( match, context, xml ) { var unquoted, excess; if ( matchExpr["CHILD"].test( match[0] ) ) { return null; } if ( match[3] ) { match[2] = match[3]; } else if ( (unquoted = match[4]) ) { // Only check arguments that contain a pseudo if ( rpseudo.test(unquoted) && // Get excess from tokenize (recursively) (excess = tokenize( unquoted, context, xml, true )) && // advance to the next closing parenthesis (excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { // excess is a negative index unquoted = unquoted.slice( 0, excess ); match[0] = match[0].slice( 0, excess ); } match[2] = unquoted; } // Return only captures needed by the pseudo filter method (type and argument) return match.slice( 0, 3 ); } }, filter: { "ID": assertGetIdNotName ? function( id ) { id = id.replace( rbackslash, "" ); return function( elem ) { return elem.getAttribute("id") === id; }; } : function( id ) { id = id.replace( rbackslash, "" ); return function( elem ) { var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id"); return node && node.value === id; }; }, "TAG": function( nodeName ) { if ( nodeName === "*" ) { return function() { return true; }; } nodeName = nodeName.replace( rbackslash, "" ).toLowerCase(); return function( elem ) { return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; }; }, "CLASS": function( className ) { var pattern = classCache[ expando ][ className ]; if ( !pattern ) { pattern = classCache( className, new RegExp("(^|" + whitespace + ")" + className + "(" + whitespace + "|$)") ); } return function( elem ) { return pattern.test( elem.className || (typeof elem.getAttribute !== strundefined && elem.getAttribute("class")) || "" ); }; }, "ATTR": function( name, operator, check ) { if ( !operator ) { return function( elem ) { return Sizzle.attr( elem, name ) != null; }; } return function( elem ) { var result = Sizzle.attr( elem, name ), value = result + ""; if ( result == null ) { return operator === "!="; } switch ( operator ) { case "=": return value === check; case "!=": return value !== check; case "^=": return check && value.indexOf( check ) === 0; case "*=": return check && value.indexOf( check ) > -1; case "$=": return check && value.substr( value.length - check.length ) === check; case "~=": return ( " " + value + " " ).indexOf( check ) > -1; case "|=": return value === check || value.substr( 0, check.length + 1 ) === check + "-"; } }; }, "CHILD": function( type, argument, first, last ) { if ( type === "nth" ) { var doneName = done++; return function( elem ) { var parent, diff, count = 0, node = elem; if ( first === 1 && last === 0 ) { return true; } parent = elem.parentNode; if ( parent && (parent[ expando ] !== doneName || !elem.sizset) ) { for ( node = parent.firstChild; node; node = node.nextSibling ) { if ( node.nodeType === 1 ) { node.sizset = ++count; if ( node === elem ) { break; } } } parent[ expando ] = doneName; } diff = elem.sizset - last; if ( first === 0 ) { return diff === 0; } else { return ( diff % first === 0 && diff / first >= 0 ); } }; } return function( elem ) { var node = elem; switch ( type ) { case "only": case "first": while ( (node = node.previousSibling) ) { if ( node.nodeType === 1 ) { return false; } } if ( type === "first" ) { return true; } node = elem; /* falls through */ case "last": while ( (node = node.nextSibling) ) { if ( node.nodeType === 1 ) { return false; } } return true; } }; }, "PSEUDO": function( pseudo, argument, context, xml ) { // pseudo-class names are case-insensitive // http://www.w3.org/TR/selectors/#pseudo-classes // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters var args, fn = Expr.pseudos[ pseudo ] || Expr.pseudos[ pseudo.toLowerCase() ]; if ( !fn ) { Sizzle.error( "unsupported pseudo: " + pseudo ); } // The user may use createPseudo to indicate that // arguments are needed to create the filter function // just as Sizzle does if ( !fn[ expando ] ) { if ( fn.length > 1 ) { args = [ pseudo, pseudo, "", argument ]; return function( elem ) { return fn( elem, 0, args ); }; } return fn; } return fn( argument, context, xml ); } }, pseudos: { "not": markFunction(function( selector, context, xml ) { // Trim the selector passed to compile // to avoid treating leading and trailing // spaces as combinators var matcher = compile( selector.replace( rtrim, "$1" ), context, xml ); return function( elem ) { return !matcher( elem ); }; }), "enabled": function( elem ) { return elem.disabled === false; }, "disabled": function( elem ) { return elem.disabled === true; }, "checked": function( elem ) { // In CSS3, :checked should return both checked and selected elements // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked var nodeName = elem.nodeName.toLowerCase(); return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); }, "selected": function( elem ) { // Accessing this property makes selected-by-default // options in Safari work properly if ( elem.parentNode ) { elem.parentNode.selectedIndex; } return elem.selected === true; }, "parent": function( elem ) { return !Expr.pseudos["empty"]( elem ); }, "empty": function( elem ) { // http://www.w3.org/TR/selectors/#empty-pseudo // :empty is only affected by element nodes and content nodes(including text(3), cdata(4)), // not comment, processing instructions, or others // Thanks to Diego Perini for the nodeName shortcut // Greater than "@" means alpha characters (specifically not starting with "#" or "?") var nodeType; elem = elem.firstChild; while ( elem ) { if ( elem.nodeName > "@" || (nodeType = elem.nodeType) === 3 || nodeType === 4 ) { return false; } elem = elem.nextSibling; } return true; }, "contains": markFunction(function( text ) { return function( elem ) { return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; }; }), "has": markFunction(function( selector ) { return function( elem ) { return Sizzle( selector, elem ).length > 0; }; }), "header": function( elem ) { return rheader.test( elem.nodeName ); }, "text": function( elem ) { var type, attr; // IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) // use getAttribute instead to test this case return elem.nodeName.toLowerCase() === "input" && (type = elem.type) === "text" && ( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === type ); }, // Input types "radio": createInputPseudo("radio"), "checkbox": createInputPseudo("checkbox"), "file": createInputPseudo("file"), "password": createInputPseudo("password"), "image": createInputPseudo("image"), "submit": createButtonPseudo("submit"), "reset": createButtonPseudo("reset"), "button": function( elem ) { var name = elem.nodeName.toLowerCase(); return name === "input" && elem.type === "button" || name === "button"; }, "input": function( elem ) { return rinputs.test( elem.nodeName ); }, "focus": function( elem ) { var doc = elem.ownerDocument; return elem === doc.activeElement && (!doc.hasFocus || doc.hasFocus()) && !!(elem.type || elem.href); }, "active": function( elem ) { return elem === elem.ownerDocument.activeElement; } }, setFilters: { "first": function( elements, argument, not ) { return not ? elements.slice( 1 ) : [ elements[0] ]; }, "last": function( elements, argument, not ) { var elem = elements.pop(); return not ? elements : [ elem ]; }, "even": function( elements, argument, not ) { var results = [], i = not ? 1 : 0, len = elements.length; for ( ; i < len; i = i + 2 ) { results.push( elements[i] ); } return results; }, "odd": function( elements, argument, not ) { var results = [], i = not ? 0 : 1, len = elements.length; for ( ; i < len; i = i + 2 ) { results.push( elements[i] ); } return results; }, "lt": function( elements, argument, not ) { return not ? elements.slice( +argument ) : elements.slice( 0, +argument ); }, "gt": function( elements, argument, not ) { return not ? elements.slice( 0, +argument + 1 ) : elements.slice( +argument + 1 ); }, "eq": function( elements, argument, not ) { var elem = elements.splice( +argument, 1 ); return not ? elements : elem; } } }; function siblingCheck( a, b, ret ) { if ( a === b ) { return ret; } var cur = a.nextSibling; while ( cur ) { if ( cur === b ) { return -1; } cur = cur.nextSibling; } return 1; } sortOrder = docElem.compareDocumentPosition ? function( a, b ) { if ( a === b ) { hasDuplicate = true; return 0; } return ( !a.compareDocumentPosition || !b.compareDocumentPosition ? a.compareDocumentPosition : a.compareDocumentPosition(b) & 4 ) ? -1 : 1; } : function( a, b ) { // The nodes are identical, we can exit early if ( a === b ) { hasDuplicate = true; return 0; // Fallback to using sourceIndex (in IE) if it's available on both nodes } else if ( a.sourceIndex && b.sourceIndex ) { return a.sourceIndex - b.sourceIndex; } var al, bl, ap = [], bp = [], aup = a.parentNode, bup = b.parentNode, cur = aup; // If the nodes are siblings (or identical) we can do a quick check if ( aup === bup ) { return siblingCheck( a, b ); // If no parents were found then the nodes are disconnected } else if ( !aup ) { return -1; } else if ( !bup ) { return 1; } // Otherwise they're somewhere else in the tree so we need // to build up a full list of the parentNodes for comparison while ( cur ) { ap.unshift( cur ); cur = cur.parentNode; } cur = bup; while ( cur ) { bp.unshift( cur ); cur = cur.parentNode; } al = ap.length; bl = bp.length; // Start walking down the tree looking for a discrepancy for ( var i = 0; i < al && i < bl; i++ ) { if ( ap[i] !== bp[i] ) { return siblingCheck( ap[i], bp[i] ); } } // We ended someplace up the tree so do a sibling check return i === al ? siblingCheck( a, bp[i], -1 ) : siblingCheck( ap[i], b, 1 ); }; // Always assume the presence of duplicates if sort doesn't // pass them to our comparison function (as in Google Chrome). [0, 0].sort( sortOrder ); baseHasDuplicate = !hasDuplicate; // Document sorting and removing duplicates Sizzle.uniqueSort = function( results ) { var elem, i = 1; hasDuplicate = baseHasDuplicate; results.sort( sortOrder ); if ( hasDuplicate ) { for ( ; (elem = results[i]); i++ ) { if ( elem === results[ i - 1 ] ) { results.splice( i--, 1 ); } } } return results; }; Sizzle.error = function( msg ) { throw new Error( "Syntax error, unrecognized expression: " + msg ); }; function tokenize( selector, context, xml, parseOnly ) { var matched, match, tokens, type, soFar, groups, group, i, preFilters, filters, checkContext = !xml && context !== document, // Token cache should maintain spaces key = ( checkContext ? "" : "" ) + selector.replace( rtrim, "$1" ), cached = tokenCache[ expando ][ key ]; if ( cached ) { return parseOnly ? 0 : slice.call( cached, 0 ); } soFar = selector; groups = []; i = 0; preFilters = Expr.preFilter; filters = Expr.filter; while ( soFar ) { // Comma and first run if ( !matched || (match = rcomma.exec( soFar )) ) { if ( match ) { soFar = soFar.slice( match[0].length ); tokens.selector = group; } groups.push( tokens = [] ); group = ""; // Need to make sure we're within a narrower context if necessary // Adding a descendant combinator will generate what is needed if ( checkContext ) { soFar = " " + soFar; } } matched = false; // Combinators if ( (match = rcombinators.exec( soFar )) ) { group += match[0]; soFar = soFar.slice( match[0].length ); // Cast descendant combinators to space matched = tokens.push({ part: match.pop().replace( rtrim, " " ), string: match[0], captures: match }); } // Filters for ( type in filters ) { if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || ( match = preFilters[ type ](match, context, xml) )) ) { group += match[0]; soFar = soFar.slice( match[0].length ); matched = tokens.push({ part: type, string: match.shift(), captures: match }); } } if ( !matched ) { break; } } // Attach the full group as a selector if ( group ) { tokens.selector = group; } // Return the length of the invalid excess // if we're just parsing // Otherwise, throw an error or return tokens return parseOnly ? soFar.length : soFar ? Sizzle.error( selector ) : // Cache the tokens slice.call( tokenCache(key, groups), 0 ); } function addCombinator( matcher, combinator, context, xml ) { var dir = combinator.dir, doneName = done++; if ( !matcher ) { // If there is no matcher to check, check against the context matcher = function( elem ) { return elem === context; }; } return combinator.first ? function( elem ) { while ( (elem = elem[ dir ]) ) { if ( elem.nodeType === 1 ) { return matcher( elem ) && elem; } } } : xml ? function( elem ) { while ( (elem = elem[ dir ]) ) { if ( elem.nodeType === 1 ) { if ( matcher( elem ) ) { return elem; } } } } : function( elem ) { var cache, dirkey = doneName + "." + dirruns, cachedkey = dirkey + "." + cachedruns; while ( (elem = elem[ dir ]) ) { if ( elem.nodeType === 1 ) { if ( (cache = elem[ expando ]) === cachedkey ) { return elem.sizset; } else if ( typeof cache === "string" && cache.indexOf(dirkey) === 0 ) { if ( elem.sizset ) { return elem; } } else { elem[ expando ] = cachedkey; if ( matcher( elem ) ) { elem.sizset = true; return elem; } elem.sizset = false; } } } }; } function addMatcher( higher, deeper ) { return higher ? function( elem ) { var result = deeper( elem ); return result && higher( result === true ? elem : result ); } : deeper; } // ["TAG", ">", "ID", " ", "CLASS"] function matcherFromTokens( tokens, context, xml ) { var token, matcher, i = 0; for ( ; (token = tokens[i]); i++ ) { if ( Expr.relative[ token.part ] ) { matcher = addCombinator( matcher, Expr.relative[ token.part ], context, xml ); } else { matcher = addMatcher( matcher, Expr.filter[ token.part ].apply(null, token.captures.concat( context, xml )) ); } } return matcher; } function matcherFromGroupMatchers( matchers ) { return function( elem ) { var matcher, j = 0; for ( ; (matcher = matchers[j]); j++ ) { if ( matcher(elem) ) { return true; } } return false; }; } compile = Sizzle.compile = function( selector, context, xml ) { var group, i, len, cached = compilerCache[ expando ][ selector ]; // Return a cached group function if already generated (context dependent) if ( cached && cached.context === context ) { return cached; } // Generate a function of recursive functions that can be used to check each element group = tokenize( selector, context, xml ); for ( i = 0, len = group.length; i < len; i++ ) { group[i] = matcherFromTokens(group[i], context, xml); } // Cache the compiled function cached = compilerCache( selector, matcherFromGroupMatchers(group) ); cached.context = context; cached.runs = cached.dirruns = 0; return cached; }; function multipleContexts( selector, contexts, results, seed ) { var i = 0, len = contexts.length; for ( ; i < len; i++ ) { Sizzle( selector, contexts[i], results, seed ); } } function handlePOSGroup( selector, posfilter, argument, contexts, seed, not ) { var results, fn = Expr.setFilters[ posfilter.toLowerCase() ]; if ( !fn ) { Sizzle.error( posfilter ); } if ( selector || !(results = seed) ) { multipleContexts( selector || "*", contexts, (results = []), seed ); } return results.length > 0 ? fn( results, argument, not ) : []; } function handlePOS( groups, context, results, seed ) { var group, part, j, groupLen, token, selector, anchor, elements, match, matched, lastIndex, currentContexts, not, i = 0, len = groups.length, rpos = matchExpr["POS"], // This is generated here in case matchExpr["POS"] is extended rposgroups = new RegExp( "^" + rpos.source + "(?!" + whitespace + ")", "i" ), // This is for making sure non-participating // matching groups are represented cross-browser (IE6-8) setUndefined = function() { var i = 1, len = arguments.length - 2; for ( ; i < len; i++ ) { if ( arguments[i] === undefined ) { match[i] = undefined; } } }; for ( ; i < len; i++ ) { group = groups[i]; part = ""; elements = seed; for ( j = 0, groupLen = group.length; j < groupLen; j++ ) { token = group[j]; selector = token.string; if ( token.part === "PSEUDO" ) { // Reset regex index to 0 rpos.exec(""); anchor = 0; while ( (match = rpos.exec( selector )) ) { matched = true; lastIndex = rpos.lastIndex = match.index + match[0].length; if ( lastIndex > anchor ) { part += selector.slice( anchor, match.index ); anchor = lastIndex; currentContexts = [ context ]; if ( rcombinators.test(part) ) { if ( elements ) { currentContexts = elements; } elements = seed; } if ( (not = rendsWithNot.test( part )) ) { part = part.slice( 0, -5 ).replace( rcombinators, "$&*" ); anchor++; } if ( match.length > 1 ) { match[0].replace( rposgroups, setUndefined ); } elements = handlePOSGroup( part, match[1], match[2], currentContexts, elements, not ); } part = ""; } } if ( !matched ) { part += selector; } matched = false; } if ( part ) { if ( rcombinators.test(part) ) { multipleContexts( part, elements || [ context ], results, seed ); } else { Sizzle( part, context, results, seed ? seed.concat(elements) : elements ); } } else { push.apply( results, elements ); } } // Do not sort if this is a single filter return len === 1 ? results : Sizzle.uniqueSort( results ); } function select( selector, context, results, seed, xml ) { // Remove excessive whitespace selector = selector.replace( rtrim, "$1" ); var elements, matcher, cached, elem, i, tokens, token, lastToken, findContext, type, match = tokenize( selector, context, xml ), contextNodeType = context.nodeType; // POS handling if ( matchExpr["POS"].test(selector) ) { return handlePOS( match, context, results, seed ); } if ( seed ) { elements = slice.call( seed, 0 ); // To maintain document order, only narrow the // set if there is one group } else if ( match.length === 1 ) { // Take a shortcut and set the context if the root selector is an ID if ( (tokens = slice.call( match[0], 0 )).length > 2 && (token = tokens[0]).part === "ID" && contextNodeType === 9 && !xml && Expr.relative[ tokens[1].part ] ) { context = Expr.find["ID"]( token.captures[0].replace( rbackslash, "" ), context, xml )[0]; if ( !context ) { return results; } selector = selector.slice( tokens.shift().string.length ); } findContext = ( (match = rsibling.exec( tokens[0].string )) && !match.index && context.parentNode ) || context; // Reduce the set if possible lastToken = ""; for ( i = tokens.length - 1; i >= 0; i-- ) { token = tokens[i]; type = token.part; lastToken = token.string + lastToken; if ( Expr.relative[ type ] ) { break; } if ( Expr.order.test(type) ) { elements = Expr.find[ type ]( token.captures[0].replace( rbackslash, "" ), findContext, xml ); if ( elements == null ) { continue; } else { selector = selector.slice( 0, selector.length - lastToken.length ) + lastToken.replace( matchExpr[ type ], "" ); if ( !selector ) { push.apply( results, slice.call(elements, 0) ); } break; } } } } // Only loop over the given elements once if ( selector ) { matcher = compile( selector, context, xml ); dirruns = matcher.dirruns++; if ( elements == null ) { elements = Expr.find["TAG"]( "*", (rsibling.test( selector ) && context.parentNode) || context ); } for ( i = 0; (elem = elements[i]); i++ ) { cachedruns = matcher.runs++; if ( matcher(elem) ) { results.push( elem ); } } } return results; } if ( document.querySelectorAll ) { (function() { var disconnectedMatch, oldSelect = select, rescape = /'|\\/g, rattributeQuotes = /\=[\x20\t\r\n\f]*([^'"\]]*)[\x20\t\r\n\f]*\]/g, rbuggyQSA = [], // matchesSelector(:active) reports false when true (IE9/Opera 11.5) // A support test would require too much code (would include document ready) // just skip matchesSelector for :active rbuggyMatches = [":active"], matches = docElem.matchesSelector || docElem.mozMatchesSelector || docElem.webkitMatchesSelector || docElem.oMatchesSelector || docElem.msMatchesSelector; // Build QSA regex // Regex strategy adopted from Diego Perini assert(function( div ) { // Select is set to empty string on purpose // This is to test IE's treatment of not explictly // setting a boolean content attribute, // since its presence should be enough // http://bugs.jquery.com/ticket/12359 div.innerHTML = ""; // IE8 - Some boolean attributes are not treated correctly if ( !div.querySelectorAll("[selected]").length ) { rbuggyQSA.push( "\\[" + whitespace + "*(?:checked|disabled|ismap|multiple|readonly|selected|value)" ); } // Webkit/Opera - :checked should return selected option elements // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked // IE8 throws error here (do not put tests after this one) if ( !div.querySelectorAll(":checked").length ) { rbuggyQSA.push(":checked"); } }); assert(function( div ) { // Opera 10-12/IE9 - ^= $= *= and empty values // Should not select anything div.innerHTML = "

      "; if ( div.querySelectorAll("[test^='']").length ) { rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:\"\"|'')" ); } // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) // IE8 throws error here (do not put tests after this one) div.innerHTML = ""; if ( !div.querySelectorAll(":enabled").length ) { rbuggyQSA.push(":enabled", ":disabled"); } }); rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); select = function( selector, context, results, seed, xml ) { // Only use querySelectorAll when not filtering, // when this is not xml, // and when no QSA bugs apply if ( !seed && !xml && (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { if ( context.nodeType === 9 ) { try { push.apply( results, slice.call(context.querySelectorAll( selector ), 0) ); return results; } catch(qsaError) {} // qSA works strangely on Element-rooted queries // We can work around this by specifying an extra ID on the root // and working up from there (Thanks to Andrew Dupont for the technique) // IE 8 doesn't work on object elements } else if ( context.nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { var groups, i, len, old = context.getAttribute("id"), nid = old || expando, newContext = rsibling.test( selector ) && context.parentNode || context; if ( old ) { nid = nid.replace( rescape, "\\$&" ); } else { context.setAttribute( "id", nid ); } groups = tokenize(selector, context, xml); // Trailing space is unnecessary // There is always a context check nid = "[id='" + nid + "']"; for ( i = 0, len = groups.length; i < len; i++ ) { groups[i] = nid + groups[i].selector; } try { push.apply( results, slice.call( newContext.querySelectorAll( groups.join(",") ), 0 ) ); return results; } catch(qsaError) { } finally { if ( !old ) { context.removeAttribute("id"); } } } } return oldSelect( selector, context, results, seed, xml ); }; if ( matches ) { assert(function( div ) { // Check to see if it's possible to do matchesSelector // on a disconnected node (IE 9) disconnectedMatch = matches.call( div, "div" ); // This should fail with an exception // Gecko does not error, returns false instead try { matches.call( div, "[test!='']:sizzle" ); rbuggyMatches.push( matchExpr["PSEUDO"].source, matchExpr["POS"].source, "!=" ); } catch ( e ) {} }); // rbuggyMatches always contains :active, so no need for a length check rbuggyMatches = /* rbuggyMatches.length && */ new RegExp( rbuggyMatches.join("|") ); Sizzle.matchesSelector = function( elem, expr ) { // Make sure that attribute selectors are quoted expr = expr.replace( rattributeQuotes, "='$1']" ); // rbuggyMatches always contains :active, so no need for an existence check if ( !isXML( elem ) && !rbuggyMatches.test( expr ) && (!rbuggyQSA || !rbuggyQSA.test( expr )) ) { try { var ret = matches.call( elem, expr ); // IE 9's matchesSelector returns false on disconnected nodes if ( ret || disconnectedMatch || // As well, disconnected nodes are said to be in a document // fragment in IE 9 elem.document && elem.document.nodeType !== 11 ) { return ret; } } catch(e) {} } return Sizzle( expr, null, null, [ elem ] ).length > 0; }; } })(); } // Deprecated Expr.setFilters["nth"] = Expr.setFilters["eq"]; // Back-compat Expr.filters = Expr.pseudos; // Override sizzle attribute retrieval Sizzle.attr = jQuery.attr; jQuery.find = Sizzle; jQuery.expr = Sizzle.selectors; jQuery.expr[":"] = jQuery.expr.pseudos; jQuery.unique = Sizzle.uniqueSort; jQuery.text = Sizzle.getText; jQuery.isXMLDoc = Sizzle.isXML; jQuery.contains = Sizzle.contains; })( window ); var runtil = /Until$/, rparentsprev = /^(?:parents|prev(?:Until|All))/, isSimple = /^.[^:#\[\.,]*$/, rneedsContext = jQuery.expr.match.needsContext, // methods guaranteed to produce a unique set when starting from a unique set guaranteedUnique = { children: true, contents: true, next: true, prev: true }; jQuery.fn.extend({ find: function( selector ) { var i, l, length, n, r, ret, self = this; if ( typeof selector !== "string" ) { return jQuery( selector ).filter(function() { for ( i = 0, l = self.length; i < l; i++ ) { if ( jQuery.contains( self[ i ], this ) ) { return true; } } }); } ret = this.pushStack( "", "find", selector ); for ( i = 0, l = this.length; i < l; i++ ) { length = ret.length; jQuery.find( selector, this[i], ret ); if ( i > 0 ) { // Make sure that the results are unique for ( n = length; n < ret.length; n++ ) { for ( r = 0; r < length; r++ ) { if ( ret[r] === ret[n] ) { ret.splice(n--, 1); break; } } } } } return ret; }, has: function( target ) { var i, targets = jQuery( target, this ), len = targets.length; return this.filter(function() { for ( i = 0; i < len; i++ ) { if ( jQuery.contains( this, targets[i] ) ) { return true; } } }); }, not: function( selector ) { return this.pushStack( winnow(this, selector, false), "not", selector); }, filter: function( selector ) { return this.pushStack( winnow(this, selector, true), "filter", selector ); }, is: function( selector ) { return !!selector && ( typeof selector === "string" ? // If this is a positional/relative selector, check membership in the returned set // so $("p:first").is("p:last") won't return true for a doc with two "p". rneedsContext.test( selector ) ? jQuery( selector, this.context ).index( this[0] ) >= 0 : jQuery.filter( selector, this ).length > 0 : this.filter( selector ).length > 0 ); }, closest: function( selectors, context ) { var cur, i = 0, l = this.length, ret = [], pos = rneedsContext.test( selectors ) || typeof selectors !== "string" ? jQuery( selectors, context || this.context ) : 0; for ( ; i < l; i++ ) { cur = this[i]; while ( cur && cur.ownerDocument && cur !== context && cur.nodeType !== 11 ) { if ( pos ? pos.index(cur) > -1 : jQuery.find.matchesSelector(cur, selectors) ) { ret.push( cur ); break; } cur = cur.parentNode; } } ret = ret.length > 1 ? jQuery.unique( ret ) : ret; return this.pushStack( ret, "closest", selectors ); }, // Determine the position of an element within // the matched set of elements index: function( elem ) { // No argument, return index in parent if ( !elem ) { return ( this[0] && this[0].parentNode ) ? this.prevAll().length : -1; } // index in selector if ( typeof elem === "string" ) { return jQuery.inArray( this[0], jQuery( elem ) ); } // Locate the position of the desired element return jQuery.inArray( // If it receives a jQuery object, the first element is used elem.jquery ? elem[0] : elem, this ); }, add: function( selector, context ) { var set = typeof selector === "string" ? jQuery( selector, context ) : jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), all = jQuery.merge( this.get(), set ); return this.pushStack( isDisconnected( set[0] ) || isDisconnected( all[0] ) ? all : jQuery.unique( all ) ); }, addBack: function( selector ) { return this.add( selector == null ? this.prevObject : this.prevObject.filter(selector) ); } }); jQuery.fn.andSelf = jQuery.fn.addBack; // A painfully simple check to see if an element is disconnected // from a document (should be improved, where feasible). function isDisconnected( node ) { return !node || !node.parentNode || node.parentNode.nodeType === 11; } function sibling( cur, dir ) { do { cur = cur[ dir ]; } while ( cur && cur.nodeType !== 1 ); return cur; } jQuery.each({ parent: function( elem ) { var parent = elem.parentNode; return parent && parent.nodeType !== 11 ? parent : null; }, parents: function( elem ) { return jQuery.dir( elem, "parentNode" ); }, parentsUntil: function( elem, i, until ) { return jQuery.dir( elem, "parentNode", until ); }, next: function( elem ) { return sibling( elem, "nextSibling" ); }, prev: function( elem ) { return sibling( elem, "previousSibling" ); }, nextAll: function( elem ) { return jQuery.dir( elem, "nextSibling" ); }, prevAll: function( elem ) { return jQuery.dir( elem, "previousSibling" ); }, nextUntil: function( elem, i, until ) { return jQuery.dir( elem, "nextSibling", until ); }, prevUntil: function( elem, i, until ) { return jQuery.dir( elem, "previousSibling", until ); }, siblings: function( elem ) { return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); }, children: function( elem ) { return jQuery.sibling( elem.firstChild ); }, contents: function( elem ) { return jQuery.nodeName( elem, "iframe" ) ? elem.contentDocument || elem.contentWindow.document : jQuery.merge( [], elem.childNodes ); } }, function( name, fn ) { jQuery.fn[ name ] = function( until, selector ) { var ret = jQuery.map( this, fn, until ); if ( !runtil.test( name ) ) { selector = until; } if ( selector && typeof selector === "string" ) { ret = jQuery.filter( selector, ret ); } ret = this.length > 1 && !guaranteedUnique[ name ] ? jQuery.unique( ret ) : ret; if ( this.length > 1 && rparentsprev.test( name ) ) { ret = ret.reverse(); } return this.pushStack( ret, name, core_slice.call( arguments ).join(",") ); }; }); jQuery.extend({ filter: function( expr, elems, not ) { if ( not ) { expr = ":not(" + expr + ")"; } return elems.length === 1 ? jQuery.find.matchesSelector(elems[0], expr) ? [ elems[0] ] : [] : jQuery.find.matches(expr, elems); }, dir: function( elem, dir, until ) { var matched = [], cur = elem[ dir ]; while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { if ( cur.nodeType === 1 ) { matched.push( cur ); } cur = cur[dir]; } return matched; }, sibling: function( n, elem ) { var r = []; for ( ; n; n = n.nextSibling ) { if ( n.nodeType === 1 && n !== elem ) { r.push( n ); } } return r; } }); // Implement the identical functionality for filter and not function winnow( elements, qualifier, keep ) { // Can't pass null or undefined to indexOf in Firefox 4 // Set to 0 to skip string check qualifier = qualifier || 0; if ( jQuery.isFunction( qualifier ) ) { return jQuery.grep(elements, function( elem, i ) { var retVal = !!qualifier.call( elem, i, elem ); return retVal === keep; }); } else if ( qualifier.nodeType ) { return jQuery.grep(elements, function( elem, i ) { return ( elem === qualifier ) === keep; }); } else if ( typeof qualifier === "string" ) { var filtered = jQuery.grep(elements, function( elem ) { return elem.nodeType === 1; }); if ( isSimple.test( qualifier ) ) { return jQuery.filter(qualifier, filtered, !keep); } else { qualifier = jQuery.filter( qualifier, filtered ); } } return jQuery.grep(elements, function( elem, i ) { return ( jQuery.inArray( elem, qualifier ) >= 0 ) === keep; }); } function createSafeFragment( document ) { var list = nodeNames.split( "|" ), safeFrag = document.createDocumentFragment(); if ( safeFrag.createElement ) { while ( list.length ) { safeFrag.createElement( list.pop() ); } } return safeFrag; } var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" + "header|hgroup|mark|meter|nav|output|progress|section|summary|time|video", rinlinejQuery = / jQuery\d+="(?:null|\d+)"/g, rleadingWhitespace = /^\s+/, rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi, rtagName = /<([\w:]+)/, rtbody = /]", "i"), rcheckableType = /^(?:checkbox|radio)$/, // checked="checked" or checked rchecked = /checked\s*(?:[^=]|=\s*.checked.)/i, rscriptType = /\/(java|ecma)script/i, rcleanScript = /^\s*\s*$/g, wrapMap = { option: [ 1, "" ], legend: [ 1, "
      ", "
      " ], thead: [ 1, "", "
      " ], tr: [ 2, "", "
      " ], td: [ 3, "", "
      " ], col: [ 2, "", "
      " ], area: [ 1, "", "" ], _default: [ 0, "", "" ] }, safeFragment = createSafeFragment( document ), fragmentDiv = safeFragment.appendChild( document.createElement("div") ); wrapMap.optgroup = wrapMap.option; wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; wrapMap.th = wrapMap.td; // IE6-8 can't serialize link, script, style, or any html5 (NoScope) tags, // unless wrapped in a div with non-breaking characters in front of it. if ( !jQuery.support.htmlSerialize ) { wrapMap._default = [ 1, "X
      ", "
      " ]; } jQuery.fn.extend({ text: function( value ) { return jQuery.access( this, function( value ) { return value === undefined ? jQuery.text( this ) : this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) ); }, null, value, arguments.length ); }, wrapAll: function( html ) { if ( jQuery.isFunction( html ) ) { return this.each(function(i) { jQuery(this).wrapAll( html.call(this, i) ); }); } if ( this[0] ) { // The elements to wrap the target around var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true); if ( this[0].parentNode ) { wrap.insertBefore( this[0] ); } wrap.map(function() { var elem = this; while ( elem.firstChild && elem.firstChild.nodeType === 1 ) { elem = elem.firstChild; } return elem; }).append( this ); } return this; }, wrapInner: function( html ) { if ( jQuery.isFunction( html ) ) { return this.each(function(i) { jQuery(this).wrapInner( html.call(this, i) ); }); } return this.each(function() { var self = jQuery( this ), contents = self.contents(); if ( contents.length ) { contents.wrapAll( html ); } else { self.append( html ); } }); }, wrap: function( html ) { var isFunction = jQuery.isFunction( html ); return this.each(function(i) { jQuery( this ).wrapAll( isFunction ? html.call(this, i) : html ); }); }, unwrap: function() { return this.parent().each(function() { if ( !jQuery.nodeName( this, "body" ) ) { jQuery( this ).replaceWith( this.childNodes ); } }).end(); }, append: function() { return this.domManip(arguments, true, function( elem ) { if ( this.nodeType === 1 || this.nodeType === 11 ) { this.appendChild( elem ); } }); }, prepend: function() { return this.domManip(arguments, true, function( elem ) { if ( this.nodeType === 1 || this.nodeType === 11 ) { this.insertBefore( elem, this.firstChild ); } }); }, before: function() { if ( !isDisconnected( this[0] ) ) { return this.domManip(arguments, false, function( elem ) { this.parentNode.insertBefore( elem, this ); }); } if ( arguments.length ) { var set = jQuery.clean( arguments ); return this.pushStack( jQuery.merge( set, this ), "before", this.selector ); } }, after: function() { if ( !isDisconnected( this[0] ) ) { return this.domManip(arguments, false, function( elem ) { this.parentNode.insertBefore( elem, this.nextSibling ); }); } if ( arguments.length ) { var set = jQuery.clean( arguments ); return this.pushStack( jQuery.merge( this, set ), "after", this.selector ); } }, // keepData is for internal use only--do not document remove: function( selector, keepData ) { var elem, i = 0; for ( ; (elem = this[i]) != null; i++ ) { if ( !selector || jQuery.filter( selector, [ elem ] ).length ) { if ( !keepData && elem.nodeType === 1 ) { jQuery.cleanData( elem.getElementsByTagName("*") ); jQuery.cleanData( [ elem ] ); } if ( elem.parentNode ) { elem.parentNode.removeChild( elem ); } } } return this; }, empty: function() { var elem, i = 0; for ( ; (elem = this[i]) != null; i++ ) { // Remove element nodes and prevent memory leaks if ( elem.nodeType === 1 ) { jQuery.cleanData( elem.getElementsByTagName("*") ); } // Remove any remaining nodes while ( elem.firstChild ) { elem.removeChild( elem.firstChild ); } } return this; }, clone: function( dataAndEvents, deepDataAndEvents ) { dataAndEvents = dataAndEvents == null ? false : dataAndEvents; deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; return this.map( function () { return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); }); }, html: function( value ) { return jQuery.access( this, function( value ) { var elem = this[0] || {}, i = 0, l = this.length; if ( value === undefined ) { return elem.nodeType === 1 ? elem.innerHTML.replace( rinlinejQuery, "" ) : undefined; } // See if we can take a shortcut and just use innerHTML if ( typeof value === "string" && !rnoInnerhtml.test( value ) && ( jQuery.support.htmlSerialize || !rnoshimcache.test( value ) ) && ( jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value ) ) && !wrapMap[ ( rtagName.exec( value ) || ["", ""] )[1].toLowerCase() ] ) { value = value.replace( rxhtmlTag, "<$1>" ); try { for (; i < l; i++ ) { // Remove element nodes and prevent memory leaks elem = this[i] || {}; if ( elem.nodeType === 1 ) { jQuery.cleanData( elem.getElementsByTagName( "*" ) ); elem.innerHTML = value; } } elem = 0; // If using innerHTML throws an exception, use the fallback method } catch(e) {} } if ( elem ) { this.empty().append( value ); } }, null, value, arguments.length ); }, replaceWith: function( value ) { if ( !isDisconnected( this[0] ) ) { // Make sure that the elements are removed from the DOM before they are inserted // this can help fix replacing a parent with child elements if ( jQuery.isFunction( value ) ) { return this.each(function(i) { var self = jQuery(this), old = self.html(); self.replaceWith( value.call( this, i, old ) ); }); } if ( typeof value !== "string" ) { value = jQuery( value ).detach(); } return this.each(function() { var next = this.nextSibling, parent = this.parentNode; jQuery( this ).remove(); if ( next ) { jQuery(next).before( value ); } else { jQuery(parent).append( value ); } }); } return this.length ? this.pushStack( jQuery(jQuery.isFunction(value) ? value() : value), "replaceWith", value ) : this; }, detach: function( selector ) { return this.remove( selector, true ); }, domManip: function( args, table, callback ) { // Flatten any nested arrays args = [].concat.apply( [], args ); var results, first, fragment, iNoClone, i = 0, value = args[0], scripts = [], l = this.length; // We can't cloneNode fragments that contain checked, in WebKit if ( !jQuery.support.checkClone && l > 1 && typeof value === "string" && rchecked.test( value ) ) { return this.each(function() { jQuery(this).domManip( args, table, callback ); }); } if ( jQuery.isFunction(value) ) { return this.each(function(i) { var self = jQuery(this); args[0] = value.call( this, i, table ? self.html() : undefined ); self.domManip( args, table, callback ); }); } if ( this[0] ) { results = jQuery.buildFragment( args, this, scripts ); fragment = results.fragment; first = fragment.firstChild; if ( fragment.childNodes.length === 1 ) { fragment = first; } if ( first ) { table = table && jQuery.nodeName( first, "tr" ); // Use the original fragment for the last item instead of the first because it can end up // being emptied incorrectly in certain situations (#8070). // Fragments from the fragment cache must always be cloned and never used in place. for ( iNoClone = results.cacheable || l - 1; i < l; i++ ) { callback.call( table && jQuery.nodeName( this[i], "table" ) ? findOrAppend( this[i], "tbody" ) : this[i], i === iNoClone ? fragment : jQuery.clone( fragment, true, true ) ); } } // Fix #11809: Avoid leaking memory fragment = first = null; if ( scripts.length ) { jQuery.each( scripts, function( i, elem ) { if ( elem.src ) { if ( jQuery.ajax ) { jQuery.ajax({ url: elem.src, type: "GET", dataType: "script", async: false, global: false, "throws": true }); } else { jQuery.error("no ajax"); } } else { jQuery.globalEval( ( elem.text || elem.textContent || elem.innerHTML || "" ).replace( rcleanScript, "" ) ); } if ( elem.parentNode ) { elem.parentNode.removeChild( elem ); } }); } } return this; } }); function findOrAppend( elem, tag ) { return elem.getElementsByTagName( tag )[0] || elem.appendChild( elem.ownerDocument.createElement( tag ) ); } function cloneCopyEvent( src, dest ) { if ( dest.nodeType !== 1 || !jQuery.hasData( src ) ) { return; } var type, i, l, oldData = jQuery._data( src ), curData = jQuery._data( dest, oldData ), events = oldData.events; if ( events ) { delete curData.handle; curData.events = {}; for ( type in events ) { for ( i = 0, l = events[ type ].length; i < l; i++ ) { jQuery.event.add( dest, type, events[ type ][ i ] ); } } } // make the cloned public data object a copy from the original if ( curData.data ) { curData.data = jQuery.extend( {}, curData.data ); } } function cloneFixAttributes( src, dest ) { var nodeName; // We do not need to do anything for non-Elements if ( dest.nodeType !== 1 ) { return; } // clearAttributes removes the attributes, which we don't want, // but also removes the attachEvent events, which we *do* want if ( dest.clearAttributes ) { dest.clearAttributes(); } // mergeAttributes, in contrast, only merges back on the // original attributes, not the events if ( dest.mergeAttributes ) { dest.mergeAttributes( src ); } nodeName = dest.nodeName.toLowerCase(); if ( nodeName === "object" ) { // IE6-10 improperly clones children of object elements using classid. // IE10 throws NoModificationAllowedError if parent is null, #12132. if ( dest.parentNode ) { dest.outerHTML = src.outerHTML; } // This path appears unavoidable for IE9. When cloning an object // element in IE9, the outerHTML strategy above is not sufficient. // If the src has innerHTML and the destination does not, // copy the src.innerHTML into the dest.innerHTML. #10324 if ( jQuery.support.html5Clone && (src.innerHTML && !jQuery.trim(dest.innerHTML)) ) { dest.innerHTML = src.innerHTML; } } else if ( nodeName === "input" && rcheckableType.test( src.type ) ) { // IE6-8 fails to persist the checked state of a cloned checkbox // or radio button. Worse, IE6-7 fail to give the cloned element // a checked appearance if the defaultChecked value isn't also set dest.defaultChecked = dest.checked = src.checked; // IE6-7 get confused and end up setting the value of a cloned // checkbox/radio button to an empty string instead of "on" if ( dest.value !== src.value ) { dest.value = src.value; } // IE6-8 fails to return the selected option to the default selected // state when cloning options } else if ( nodeName === "option" ) { dest.selected = src.defaultSelected; // IE6-8 fails to set the defaultValue to the correct value when // cloning other types of input fields } else if ( nodeName === "input" || nodeName === "textarea" ) { dest.defaultValue = src.defaultValue; // IE blanks contents when cloning scripts } else if ( nodeName === "script" && dest.text !== src.text ) { dest.text = src.text; } // Event data gets referenced instead of copied if the expando // gets copied too dest.removeAttribute( jQuery.expando ); } jQuery.buildFragment = function( args, context, scripts ) { var fragment, cacheable, cachehit, first = args[ 0 ]; // Set context from what may come in as undefined or a jQuery collection or a node // Updated to fix #12266 where accessing context[0] could throw an exception in IE9/10 & // also doubles as fix for #8950 where plain objects caused createDocumentFragment exception context = context || document; context = !context.nodeType && context[0] || context; context = context.ownerDocument || context; // Only cache "small" (1/2 KB) HTML strings that are associated with the main document // Cloning options loses the selected state, so don't cache them // IE 6 doesn't like it when you put or elements in a fragment // Also, WebKit does not clone 'checked' attributes on cloneNode, so don't cache // Lastly, IE6,7,8 will not correctly reuse cached fragments that were created from unknown elems #10501 if ( args.length === 1 && typeof first === "string" && first.length < 512 && context === document && first.charAt(0) === "<" && !rnocache.test( first ) && (jQuery.support.checkClone || !rchecked.test( first )) && (jQuery.support.html5Clone || !rnoshimcache.test( first )) ) { // Mark cacheable and look for a hit cacheable = true; fragment = jQuery.fragments[ first ]; cachehit = fragment !== undefined; } if ( !fragment ) { fragment = context.createDocumentFragment(); jQuery.clean( args, context, fragment, scripts ); // Update the cache, but only store false // unless this is a second parsing of the same content if ( cacheable ) { jQuery.fragments[ first ] = cachehit && fragment; } } return { fragment: fragment, cacheable: cacheable }; }; jQuery.fragments = {}; jQuery.each({ appendTo: "append", prependTo: "prepend", insertBefore: "before", insertAfter: "after", replaceAll: "replaceWith" }, function( name, original ) { jQuery.fn[ name ] = function( selector ) { var elems, i = 0, ret = [], insert = jQuery( selector ), l = insert.length, parent = this.length === 1 && this[0].parentNode; if ( (parent == null || parent && parent.nodeType === 11 && parent.childNodes.length === 1) && l === 1 ) { insert[ original ]( this[0] ); return this; } else { for ( ; i < l; i++ ) { elems = ( i > 0 ? this.clone(true) : this ).get(); jQuery( insert[i] )[ original ]( elems ); ret = ret.concat( elems ); } return this.pushStack( ret, name, insert.selector ); } }; }); function getAll( elem ) { if ( typeof elem.getElementsByTagName !== "undefined" ) { return elem.getElementsByTagName( "*" ); } else if ( typeof elem.querySelectorAll !== "undefined" ) { return elem.querySelectorAll( "*" ); } else { return []; } } // Used in clean, fixes the defaultChecked property function fixDefaultChecked( elem ) { if ( rcheckableType.test( elem.type ) ) { elem.defaultChecked = elem.checked; } } jQuery.extend({ clone: function( elem, dataAndEvents, deepDataAndEvents ) { var srcElements, destElements, i, clone; if ( jQuery.support.html5Clone || jQuery.isXMLDoc(elem) || !rnoshimcache.test( "<" + elem.nodeName + ">" ) ) { clone = elem.cloneNode( true ); // IE<=8 does not properly clone detached, unknown element nodes } else { fragmentDiv.innerHTML = elem.outerHTML; fragmentDiv.removeChild( clone = fragmentDiv.firstChild ); } if ( (!jQuery.support.noCloneEvent || !jQuery.support.noCloneChecked) && (elem.nodeType === 1 || elem.nodeType === 11) && !jQuery.isXMLDoc(elem) ) { // IE copies events bound via attachEvent when using cloneNode. // Calling detachEvent on the clone will also remove the events // from the original. In order to get around this, we use some // proprietary methods to clear the events. Thanks to MooTools // guys for this hotness. cloneFixAttributes( elem, clone ); // Using Sizzle here is crazy slow, so we use getElementsByTagName instead srcElements = getAll( elem ); destElements = getAll( clone ); // Weird iteration because IE will replace the length property // with an element if you are cloning the body and one of the // elements on the page has a name or id of "length" for ( i = 0; srcElements[i]; ++i ) { // Ensure that the destination node is not null; Fixes #9587 if ( destElements[i] ) { cloneFixAttributes( srcElements[i], destElements[i] ); } } } // Copy the events from the original to the clone if ( dataAndEvents ) { cloneCopyEvent( elem, clone ); if ( deepDataAndEvents ) { srcElements = getAll( elem ); destElements = getAll( clone ); for ( i = 0; srcElements[i]; ++i ) { cloneCopyEvent( srcElements[i], destElements[i] ); } } } srcElements = destElements = null; // Return the cloned set return clone; }, clean: function( elems, context, fragment, scripts ) { var i, j, elem, tag, wrap, depth, div, hasBody, tbody, len, handleScript, jsTags, safe = context === document && safeFragment, ret = []; // Ensure that context is a document if ( !context || typeof context.createDocumentFragment === "undefined" ) { context = document; } // Use the already-created safe fragment if context permits for ( i = 0; (elem = elems[i]) != null; i++ ) { if ( typeof elem === "number" ) { elem += ""; } if ( !elem ) { continue; } // Convert html string into DOM nodes if ( typeof elem === "string" ) { if ( !rhtml.test( elem ) ) { elem = context.createTextNode( elem ); } else { // Ensure a safe container in which to render the html safe = safe || createSafeFragment( context ); div = context.createElement("div"); safe.appendChild( div ); // Fix "XHTML"-style tags in all browsers elem = elem.replace(rxhtmlTag, "<$1>"); // Go to html and back, then peel off extra wrappers tag = ( rtagName.exec( elem ) || ["", ""] )[1].toLowerCase(); wrap = wrapMap[ tag ] || wrapMap._default; depth = wrap[0]; div.innerHTML = wrap[1] + elem + wrap[2]; // Move to the right depth while ( depth-- ) { div = div.lastChild; } // Remove IE's autoinserted from table fragments if ( !jQuery.support.tbody ) { // String was a , *may* have spurious hasBody = rtbody.test(elem); tbody = tag === "table" && !hasBody ? div.firstChild && div.firstChild.childNodes : // String was a bare or wrap[1] === "
      " && !hasBody ? div.childNodes : []; for ( j = tbody.length - 1; j >= 0 ; --j ) { if ( jQuery.nodeName( tbody[ j ], "tbody" ) && !tbody[ j ].childNodes.length ) { tbody[ j ].parentNode.removeChild( tbody[ j ] ); } } } // IE completely kills leading whitespace when innerHTML is used if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) { div.insertBefore( context.createTextNode( rleadingWhitespace.exec(elem)[0] ), div.firstChild ); } elem = div.childNodes; // Take out of fragment container (we need a fresh div each time) div.parentNode.removeChild( div ); } } if ( elem.nodeType ) { ret.push( elem ); } else { jQuery.merge( ret, elem ); } } // Fix #11356: Clear elements from safeFragment if ( div ) { elem = div = safe = null; } // Reset defaultChecked for any radios and checkboxes // about to be appended to the DOM in IE 6/7 (#8060) if ( !jQuery.support.appendChecked ) { for ( i = 0; (elem = ret[i]) != null; i++ ) { if ( jQuery.nodeName( elem, "input" ) ) { fixDefaultChecked( elem ); } else if ( typeof elem.getElementsByTagName !== "undefined" ) { jQuery.grep( elem.getElementsByTagName("input"), fixDefaultChecked ); } } } // Append elements to a provided document fragment if ( fragment ) { // Special handling of each script element handleScript = function( elem ) { // Check if we consider it executable if ( !elem.type || rscriptType.test( elem.type ) ) { // Detach the script and store it in the scripts array (if provided) or the fragment // Return truthy to indicate that it has been handled return scripts ? scripts.push( elem.parentNode ? elem.parentNode.removeChild( elem ) : elem ) : fragment.appendChild( elem ); } }; for ( i = 0; (elem = ret[i]) != null; i++ ) { // Check if we're done after handling an executable script if ( !( jQuery.nodeName( elem, "script" ) && handleScript( elem ) ) ) { // Append to fragment and handle embedded scripts fragment.appendChild( elem ); if ( typeof elem.getElementsByTagName !== "undefined" ) { // handleScript alters the DOM, so use jQuery.merge to ensure snapshot iteration jsTags = jQuery.grep( jQuery.merge( [], elem.getElementsByTagName("script") ), handleScript ); // Splice the scripts into ret after their former ancestor and advance our index beyond them ret.splice.apply( ret, [i + 1, 0].concat( jsTags ) ); i += jsTags.length; } } } } return ret; }, cleanData: function( elems, /* internal */ acceptData ) { var data, id, elem, type, i = 0, internalKey = jQuery.expando, cache = jQuery.cache, deleteExpando = jQuery.support.deleteExpando, special = jQuery.event.special; for ( ; (elem = elems[i]) != null; i++ ) { if ( acceptData || jQuery.acceptData( elem ) ) { id = elem[ internalKey ]; data = id && cache[ id ]; if ( data ) { if ( data.events ) { for ( type in data.events ) { if ( special[ type ] ) { jQuery.event.remove( elem, type ); // This is a shortcut to avoid jQuery.event.remove's overhead } else { jQuery.removeEvent( elem, type, data.handle ); } } } // Remove cache only if it was not already removed by jQuery.event.remove if ( cache[ id ] ) { delete cache[ id ]; // IE does not allow us to delete expando properties from nodes, // nor does it have a removeAttribute function on Document nodes; // we must handle all of these cases if ( deleteExpando ) { delete elem[ internalKey ]; } else if ( elem.removeAttribute ) { elem.removeAttribute( internalKey ); } else { elem[ internalKey ] = null; } jQuery.deletedIds.push( id ); } } } } } }); // Limit scope pollution from any deprecated API (function() { var matched, browser; // Use of jQuery.browser is frowned upon. // More details: http://api.jquery.com/jQuery.browser // jQuery.uaMatch maintained for back-compat jQuery.uaMatch = function( ua ) { ua = ua.toLowerCase(); var match = /(chrome)[ \/]([\w.]+)/.exec( ua ) || /(webkit)[ \/]([\w.]+)/.exec( ua ) || /(opera)(?:.*version|)[ \/]([\w.]+)/.exec( ua ) || /(msie) ([\w.]+)/.exec( ua ) || ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec( ua ) || []; return { browser: match[ 1 ] || "", version: match[ 2 ] || "0" }; }; matched = jQuery.uaMatch( navigator.userAgent ); browser = {}; if ( matched.browser ) { browser[ matched.browser ] = true; browser.version = matched.version; } // Chrome is Webkit, but Webkit is also Safari. if ( browser.chrome ) { browser.webkit = true; } else if ( browser.webkit ) { browser.safari = true; } jQuery.browser = browser; jQuery.sub = function() { function jQuerySub( selector, context ) { return new jQuerySub.fn.init( selector, context ); } jQuery.extend( true, jQuerySub, this ); jQuerySub.superclass = this; jQuerySub.fn = jQuerySub.prototype = this(); jQuerySub.fn.constructor = jQuerySub; jQuerySub.sub = this.sub; jQuerySub.fn.init = function init( selector, context ) { if ( context && context instanceof jQuery && !(context instanceof jQuerySub) ) { context = jQuerySub( context ); } return jQuery.fn.init.call( this, selector, context, rootjQuerySub ); }; jQuerySub.fn.init.prototype = jQuerySub.fn; var rootjQuerySub = jQuerySub(document); return jQuerySub; }; })(); var curCSS, iframe, iframeDoc, ralpha = /alpha\([^)]*\)/i, ropacity = /opacity=([^)]*)/, rposition = /^(top|right|bottom|left)$/, // swappable if display is none or starts with table except "table", "table-cell", or "table-caption" // see here for display values: https://developer.mozilla.org/en-US/docs/CSS/display rdisplayswap = /^(none|table(?!-c[ea]).+)/, rmargin = /^margin/, rnumsplit = new RegExp( "^(" + core_pnum + ")(.*)$", "i" ), rnumnonpx = new RegExp( "^(" + core_pnum + ")(?!px)[a-z%]+$", "i" ), rrelNum = new RegExp( "^([-+])=(" + core_pnum + ")", "i" ), elemdisplay = {}, cssShow = { position: "absolute", visibility: "hidden", display: "block" }, cssNormalTransform = { letterSpacing: 0, fontWeight: 400 }, cssExpand = [ "Top", "Right", "Bottom", "Left" ], cssPrefixes = [ "Webkit", "O", "Moz", "ms" ], eventsToggle = jQuery.fn.toggle; // return a css property mapped to a potentially vendor prefixed property function vendorPropName( style, name ) { // shortcut for names that are not vendor prefixed if ( name in style ) { return name; } // check for vendor prefixed names var capName = name.charAt(0).toUpperCase() + name.slice(1), origName = name, i = cssPrefixes.length; while ( i-- ) { name = cssPrefixes[ i ] + capName; if ( name in style ) { return name; } } return origName; } function isHidden( elem, el ) { elem = el || elem; return jQuery.css( elem, "display" ) === "none" || !jQuery.contains( elem.ownerDocument, elem ); } function showHide( elements, show ) { var elem, display, values = [], index = 0, length = elements.length; for ( ; index < length; index++ ) { elem = elements[ index ]; if ( !elem.style ) { continue; } values[ index ] = jQuery._data( elem, "olddisplay" ); if ( show ) { // Reset the inline display of this element to learn if it is // being hidden by cascaded rules or not if ( !values[ index ] && elem.style.display === "none" ) { elem.style.display = ""; } // Set elements which have been overridden with display: none // in a stylesheet to whatever the default browser style is // for such an element if ( elem.style.display === "" && isHidden( elem ) ) { values[ index ] = jQuery._data( elem, "olddisplay", css_defaultDisplay(elem.nodeName) ); } } else { display = curCSS( elem, "display" ); if ( !values[ index ] && display !== "none" ) { jQuery._data( elem, "olddisplay", display ); } } } // Set the display of most of the elements in a second loop // to avoid the constant reflow for ( index = 0; index < length; index++ ) { elem = elements[ index ]; if ( !elem.style ) { continue; } if ( !show || elem.style.display === "none" || elem.style.display === "" ) { elem.style.display = show ? values[ index ] || "" : "none"; } } return elements; } jQuery.fn.extend({ css: function( name, value ) { return jQuery.access( this, function( elem, name, value ) { return value !== undefined ? jQuery.style( elem, name, value ) : jQuery.css( elem, name ); }, name, value, arguments.length > 1 ); }, show: function() { return showHide( this, true ); }, hide: function() { return showHide( this ); }, toggle: function( state, fn2 ) { var bool = typeof state === "boolean"; if ( jQuery.isFunction( state ) && jQuery.isFunction( fn2 ) ) { return eventsToggle.apply( this, arguments ); } return this.each(function() { if ( bool ? state : isHidden( this ) ) { jQuery( this ).show(); } else { jQuery( this ).hide(); } }); } }); jQuery.extend({ // Add in style property hooks for overriding the default // behavior of getting and setting a style property cssHooks: { opacity: { get: function( elem, computed ) { if ( computed ) { // We should always get a number back from opacity var ret = curCSS( elem, "opacity" ); return ret === "" ? "1" : ret; } } } }, // Exclude the following css properties to add px cssNumber: { "fillOpacity": true, "fontWeight": true, "lineHeight": true, "opacity": true, "orphans": true, "widows": true, "zIndex": true, "zoom": true }, // Add in properties whose names you wish to fix before // setting or getting the value cssProps: { // normalize float css property "float": jQuery.support.cssFloat ? "cssFloat" : "styleFloat" }, // Get and set the style property on a DOM Node style: function( elem, name, value, extra ) { // Don't set styles on text and comment nodes if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { return; } // Make sure that we're working with the right name var ret, type, hooks, origName = jQuery.camelCase( name ), style = elem.style; name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( style, origName ) ); // gets hook for the prefixed version // followed by the unprefixed version hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; // Check if we're setting a value if ( value !== undefined ) { type = typeof value; // convert relative number strings (+= or -=) to relative numbers. #7345 if ( type === "string" && (ret = rrelNum.exec( value )) ) { value = ( ret[1] + 1 ) * ret[2] + parseFloat( jQuery.css( elem, name ) ); // Fixes bug #9237 type = "number"; } // Make sure that NaN and null values aren't set. See: #7116 if ( value == null || type === "number" && isNaN( value ) ) { return; } // If a number was passed in, add 'px' to the (except for certain CSS properties) if ( type === "number" && !jQuery.cssNumber[ origName ] ) { value += "px"; } // If a hook was provided, use that value, otherwise just set the specified value if ( !hooks || !("set" in hooks) || (value = hooks.set( elem, value, extra )) !== undefined ) { // Wrapped to prevent IE from throwing errors when 'invalid' values are provided // Fixes bug #5509 try { style[ name ] = value; } catch(e) {} } } else { // If a hook was provided get the non-computed value from there if ( hooks && "get" in hooks && (ret = hooks.get( elem, false, extra )) !== undefined ) { return ret; } // Otherwise just get the value from the style object return style[ name ]; } }, css: function( elem, name, numeric, extra ) { var val, num, hooks, origName = jQuery.camelCase( name ); // Make sure that we're working with the right name name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( elem.style, origName ) ); // gets hook for the prefixed version // followed by the unprefixed version hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; // If a hook was provided get the computed value from there if ( hooks && "get" in hooks ) { val = hooks.get( elem, true, extra ); } // Otherwise, if a way to get the computed value exists, use that if ( val === undefined ) { val = curCSS( elem, name ); } //convert "normal" to computed value if ( val === "normal" && name in cssNormalTransform ) { val = cssNormalTransform[ name ]; } // Return, converting to number if forced or a qualifier was provided and val looks numeric if ( numeric || extra !== undefined ) { num = parseFloat( val ); return numeric || jQuery.isNumeric( num ) ? num || 0 : val; } return val; }, // A method for quickly swapping in/out CSS properties to get correct calculations swap: function( elem, options, callback ) { var ret, name, old = {}; // Remember the old values, and insert the new ones for ( name in options ) { old[ name ] = elem.style[ name ]; elem.style[ name ] = options[ name ]; } ret = callback.call( elem ); // Revert the old values for ( name in options ) { elem.style[ name ] = old[ name ]; } return ret; } }); // NOTE: To any future maintainer, we've window.getComputedStyle // because jsdom on node.js will break without it. if ( window.getComputedStyle ) { curCSS = function( elem, name ) { var ret, width, minWidth, maxWidth, computed = window.getComputedStyle( elem, null ), style = elem.style; if ( computed ) { ret = computed[ name ]; if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) { ret = jQuery.style( elem, name ); } // A tribute to the "awesome hack by Dean Edwards" // Chrome < 17 and Safari 5.0 uses "computed value" instead of "used value" for margin-right // Safari 5.1.7 (at least) returns percentage for a larger set of values, but width seems to be reliably pixels // this is against the CSSOM draft spec: http://dev.w3.org/csswg/cssom/#resolved-values if ( rnumnonpx.test( ret ) && rmargin.test( name ) ) { width = style.width; minWidth = style.minWidth; maxWidth = style.maxWidth; style.minWidth = style.maxWidth = style.width = ret; ret = computed.width; style.width = width; style.minWidth = minWidth; style.maxWidth = maxWidth; } } return ret; }; } else if ( document.documentElement.currentStyle ) { curCSS = function( elem, name ) { var left, rsLeft, ret = elem.currentStyle && elem.currentStyle[ name ], style = elem.style; // Avoid setting ret to empty string here // so we don't default to auto if ( ret == null && style && style[ name ] ) { ret = style[ name ]; } // From the awesome hack by Dean Edwards // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291 // If we're not dealing with a regular pixel number // but a number that has a weird ending, we need to convert it to pixels // but not position css attributes, as those are proportional to the parent element instead // and we can't measure the parent instead because it might trigger a "stacking dolls" problem if ( rnumnonpx.test( ret ) && !rposition.test( name ) ) { // Remember the original values left = style.left; rsLeft = elem.runtimeStyle && elem.runtimeStyle.left; // Put in the new values to get a computed value out if ( rsLeft ) { elem.runtimeStyle.left = elem.currentStyle.left; } style.left = name === "fontSize" ? "1em" : ret; ret = style.pixelLeft + "px"; // Revert the changed values style.left = left; if ( rsLeft ) { elem.runtimeStyle.left = rsLeft; } } return ret === "" ? "auto" : ret; }; } function setPositiveNumber( elem, value, subtract ) { var matches = rnumsplit.exec( value ); return matches ? Math.max( 0, matches[ 1 ] - ( subtract || 0 ) ) + ( matches[ 2 ] || "px" ) : value; } function augmentWidthOrHeight( elem, name, extra, isBorderBox ) { var i = extra === ( isBorderBox ? "border" : "content" ) ? // If we already have the right measurement, avoid augmentation 4 : // Otherwise initialize for horizontal or vertical properties name === "width" ? 1 : 0, val = 0; for ( ; i < 4; i += 2 ) { // both box models exclude margin, so add it if we want it if ( extra === "margin" ) { // we use jQuery.css instead of curCSS here // because of the reliableMarginRight CSS hook! val += jQuery.css( elem, extra + cssExpand[ i ], true ); } // From this point on we use curCSS for maximum performance (relevant in animations) if ( isBorderBox ) { // border-box includes padding, so remove it if we want content if ( extra === "content" ) { val -= parseFloat( curCSS( elem, "padding" + cssExpand[ i ] ) ) || 0; } // at this point, extra isn't border nor margin, so remove border if ( extra !== "margin" ) { val -= parseFloat( curCSS( elem, "border" + cssExpand[ i ] + "Width" ) ) || 0; } } else { // at this point, extra isn't content, so add padding val += parseFloat( curCSS( elem, "padding" + cssExpand[ i ] ) ) || 0; // at this point, extra isn't content nor padding, so add border if ( extra !== "padding" ) { val += parseFloat( curCSS( elem, "border" + cssExpand[ i ] + "Width" ) ) || 0; } } } return val; } function getWidthOrHeight( elem, name, extra ) { // Start with offset property, which is equivalent to the border-box value var val = name === "width" ? elem.offsetWidth : elem.offsetHeight, valueIsBorderBox = true, isBorderBox = jQuery.support.boxSizing && jQuery.css( elem, "boxSizing" ) === "border-box"; // some non-html elements return undefined for offsetWidth, so check for null/undefined // svg - https://bugzilla.mozilla.org/show_bug.cgi?id=649285 // MathML - https://bugzilla.mozilla.org/show_bug.cgi?id=491668 if ( val <= 0 || val == null ) { // Fall back to computed then uncomputed css if necessary val = curCSS( elem, name ); if ( val < 0 || val == null ) { val = elem.style[ name ]; } // Computed unit is not pixels. Stop here and return. if ( rnumnonpx.test(val) ) { return val; } // we need the check for style in case a browser which returns unreliable values // for getComputedStyle silently falls back to the reliable elem.style valueIsBorderBox = isBorderBox && ( jQuery.support.boxSizingReliable || val === elem.style[ name ] ); // Normalize "", auto, and prepare for extra val = parseFloat( val ) || 0; } // use the active box-sizing model to add/subtract irrelevant styles return ( val + augmentWidthOrHeight( elem, name, extra || ( isBorderBox ? "border" : "content" ), valueIsBorderBox ) ) + "px"; } // Try to determine the default display value of an element function css_defaultDisplay( nodeName ) { if ( elemdisplay[ nodeName ] ) { return elemdisplay[ nodeName ]; } var elem = jQuery( "<" + nodeName + ">" ).appendTo( document.body ), display = elem.css("display"); elem.remove(); // If the simple way fails, // get element's real default display by attaching it to a temp iframe if ( display === "none" || display === "" ) { // Use the already-created iframe if possible iframe = document.body.appendChild( iframe || jQuery.extend( document.createElement("iframe"), { frameBorder: 0, width: 0, height: 0 }) ); // Create a cacheable copy of the iframe document on first call. // IE and Opera will allow us to reuse the iframeDoc without re-writing the fake HTML // document to it; WebKit & Firefox won't allow reusing the iframe document. if ( !iframeDoc || !iframe.createElement ) { iframeDoc = ( iframe.contentWindow || iframe.contentDocument ).document; iframeDoc.write(""); iframeDoc.close(); } elem = iframeDoc.body.appendChild( iframeDoc.createElement(nodeName) ); display = curCSS( elem, "display" ); document.body.removeChild( iframe ); } // Store the correct default display elemdisplay[ nodeName ] = display; return display; } jQuery.each([ "height", "width" ], function( i, name ) { jQuery.cssHooks[ name ] = { get: function( elem, computed, extra ) { if ( computed ) { // certain elements can have dimension info if we invisibly show them // however, it must have a current display style that would benefit from this if ( elem.offsetWidth === 0 && rdisplayswap.test( curCSS( elem, "display" ) ) ) { return jQuery.swap( elem, cssShow, function() { return getWidthOrHeight( elem, name, extra ); }); } else { return getWidthOrHeight( elem, name, extra ); } } }, set: function( elem, value, extra ) { return setPositiveNumber( elem, value, extra ? augmentWidthOrHeight( elem, name, extra, jQuery.support.boxSizing && jQuery.css( elem, "boxSizing" ) === "border-box" ) : 0 ); } }; }); if ( !jQuery.support.opacity ) { jQuery.cssHooks.opacity = { get: function( elem, computed ) { // IE uses filters for opacity return ropacity.test( (computed && elem.currentStyle ? elem.currentStyle.filter : elem.style.filter) || "" ) ? ( 0.01 * parseFloat( RegExp.$1 ) ) + "" : computed ? "1" : ""; }, set: function( elem, value ) { var style = elem.style, currentStyle = elem.currentStyle, opacity = jQuery.isNumeric( value ) ? "alpha(opacity=" + value * 100 + ")" : "", filter = currentStyle && currentStyle.filter || style.filter || ""; // IE has trouble with opacity if it does not have layout // Force it by setting the zoom level style.zoom = 1; // if setting opacity to 1, and no other filters exist - attempt to remove filter attribute #6652 if ( value >= 1 && jQuery.trim( filter.replace( ralpha, "" ) ) === "" && style.removeAttribute ) { // Setting style.filter to null, "" & " " still leave "filter:" in the cssText // if "filter:" is present at all, clearType is disabled, we want to avoid this // style.removeAttribute is IE Only, but so apparently is this code path... style.removeAttribute( "filter" ); // if there there is no filter style applied in a css rule, we are done if ( currentStyle && !currentStyle.filter ) { return; } } // otherwise, set new filter values style.filter = ralpha.test( filter ) ? filter.replace( ralpha, opacity ) : filter + " " + opacity; } }; } // These hooks cannot be added until DOM ready because the support test // for it is not run until after DOM ready jQuery(function() { if ( !jQuery.support.reliableMarginRight ) { jQuery.cssHooks.marginRight = { get: function( elem, computed ) { // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right // Work around by temporarily setting element display to inline-block return jQuery.swap( elem, { "display": "inline-block" }, function() { if ( computed ) { return curCSS( elem, "marginRight" ); } }); } }; } // Webkit bug: https://bugs.webkit.org/show_bug.cgi?id=29084 // getComputedStyle returns percent when specified for top/left/bottom/right // rather than make the css module depend on the offset module, we just check for it here if ( !jQuery.support.pixelPosition && jQuery.fn.position ) { jQuery.each( [ "top", "left" ], function( i, prop ) { jQuery.cssHooks[ prop ] = { get: function( elem, computed ) { if ( computed ) { var ret = curCSS( elem, prop ); // if curCSS returns percentage, fallback to offset return rnumnonpx.test( ret ) ? jQuery( elem ).position()[ prop ] + "px" : ret; } } }; }); } }); if ( jQuery.expr && jQuery.expr.filters ) { jQuery.expr.filters.hidden = function( elem ) { return ( elem.offsetWidth === 0 && elem.offsetHeight === 0 ) || (!jQuery.support.reliableHiddenOffsets && ((elem.style && elem.style.display) || curCSS( elem, "display" )) === "none"); }; jQuery.expr.filters.visible = function( elem ) { return !jQuery.expr.filters.hidden( elem ); }; } // These hooks are used by animate to expand properties jQuery.each({ margin: "", padding: "", border: "Width" }, function( prefix, suffix ) { jQuery.cssHooks[ prefix + suffix ] = { expand: function( value ) { var i, // assumes a single number if not a string parts = typeof value === "string" ? value.split(" ") : [ value ], expanded = {}; for ( i = 0; i < 4; i++ ) { expanded[ prefix + cssExpand[ i ] + suffix ] = parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; } return expanded; } }; if ( !rmargin.test( prefix ) ) { jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; } }); var r20 = /%20/g, rbracket = /\[\]$/, rCRLF = /\r?\n/g, rinput = /^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i, rselectTextarea = /^(?:select|textarea)/i; jQuery.fn.extend({ serialize: function() { return jQuery.param( this.serializeArray() ); }, serializeArray: function() { return this.map(function(){ return this.elements ? jQuery.makeArray( this.elements ) : this; }) .filter(function(){ return this.name && !this.disabled && ( this.checked || rselectTextarea.test( this.nodeName ) || rinput.test( this.type ) ); }) .map(function( i, elem ){ var val = jQuery( this ).val(); return val == null ? null : jQuery.isArray( val ) ? jQuery.map( val, function( val, i ){ return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; }) : { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; }).get(); } }); //Serialize an array of form elements or a set of //key/values into a query string jQuery.param = function( a, traditional ) { var prefix, s = [], add = function( key, value ) { // If value is a function, invoke it and return its value value = jQuery.isFunction( value ) ? value() : ( value == null ? "" : value ); s[ s.length ] = encodeURIComponent( key ) + "=" + encodeURIComponent( value ); }; // Set traditional to true for jQuery <= 1.3.2 behavior. if ( traditional === undefined ) { traditional = jQuery.ajaxSettings && jQuery.ajaxSettings.traditional; } // If an array was passed in, assume that it is an array of form elements. if ( jQuery.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { // Serialize the form elements jQuery.each( a, function() { add( this.name, this.value ); }); } else { // If traditional, encode the "old" way (the way 1.3.2 or older // did it), otherwise encode params recursively. for ( prefix in a ) { buildParams( prefix, a[ prefix ], traditional, add ); } } // Return the resulting serialization return s.join( "&" ).replace( r20, "+" ); }; function buildParams( prefix, obj, traditional, add ) { var name; if ( jQuery.isArray( obj ) ) { // Serialize array item. jQuery.each( obj, function( i, v ) { if ( traditional || rbracket.test( prefix ) ) { // Treat each array item as a scalar. add( prefix, v ); } else { // If array item is non-scalar (array or object), encode its // numeric index to resolve deserialization ambiguity issues. // Note that rack (as of 1.0.0) can't currently deserialize // nested arrays properly, and attempting to do so may cause // a server error. Possible fixes are to modify rack's // deserialization algorithm or to provide an option or flag // to force array serialization to be shallow. buildParams( prefix + "[" + ( typeof v === "object" ? i : "" ) + "]", v, traditional, add ); } }); } else if ( !traditional && jQuery.type( obj ) === "object" ) { // Serialize object item. for ( name in obj ) { buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); } } else { // Serialize scalar item. add( prefix, obj ); } } var // Document location ajaxLocation, // Document location segments ajaxLocParts, rhash = /#.*$/, rheaders = /^(.*?):[ \t]*([^\r\n]*)\r?$/mg, // IE leaves an \r character at EOL // #7653, #8125, #8152: local protocol detection rlocalProtocol = /^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/, rnoContent = /^(?:GET|HEAD)$/, rprotocol = /^\/\//, rquery = /\?/, rscript = /)<[^<]*)*<\/script>/gi, rts = /([?&])_=[^&]*/, rurl = /^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/, // Keep a copy of the old load method _load = jQuery.fn.load, /* Prefilters * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) * 2) These are called: * - BEFORE asking for a transport * - AFTER param serialization (s.data is a string if s.processData is true) * 3) key is the dataType * 4) the catchall symbol "*" can be used * 5) execution will start with transport dataType and THEN continue down to "*" if needed */ prefilters = {}, /* Transports bindings * 1) key is the dataType * 2) the catchall symbol "*" can be used * 3) selection will start with transport dataType and THEN go to "*" if needed */ transports = {}, // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression allTypes = ["*/"] + ["*"]; // #8138, IE may throw an exception when accessing // a field from window.location if document.domain has been set try { ajaxLocation = location.href; } catch( e ) { // Use the href attribute of an A element // since IE will modify it given document.location ajaxLocation = document.createElement( "a" ); ajaxLocation.href = ""; ajaxLocation = ajaxLocation.href; } // Segment location into parts ajaxLocParts = rurl.exec( ajaxLocation.toLowerCase() ) || []; // Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport function addToPrefiltersOrTransports( structure ) { // dataTypeExpression is optional and defaults to "*" return function( dataTypeExpression, func ) { if ( typeof dataTypeExpression !== "string" ) { func = dataTypeExpression; dataTypeExpression = "*"; } var dataType, list, placeBefore, dataTypes = dataTypeExpression.toLowerCase().split( core_rspace ), i = 0, length = dataTypes.length; if ( jQuery.isFunction( func ) ) { // For each dataType in the dataTypeExpression for ( ; i < length; i++ ) { dataType = dataTypes[ i ]; // We control if we're asked to add before // any existing element placeBefore = /^\+/.test( dataType ); if ( placeBefore ) { dataType = dataType.substr( 1 ) || "*"; } list = structure[ dataType ] = structure[ dataType ] || []; // then we add to the structure accordingly list[ placeBefore ? "unshift" : "push" ]( func ); } } }; } // Base inspection function for prefilters and transports function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR, dataType /* internal */, inspected /* internal */ ) { dataType = dataType || options.dataTypes[ 0 ]; inspected = inspected || {}; inspected[ dataType ] = true; var selection, list = structure[ dataType ], i = 0, length = list ? list.length : 0, executeOnly = ( structure === prefilters ); for ( ; i < length && ( executeOnly || !selection ); i++ ) { selection = list[ i ]( options, originalOptions, jqXHR ); // If we got redirected to another dataType // we try there if executing only and not done already if ( typeof selection === "string" ) { if ( !executeOnly || inspected[ selection ] ) { selection = undefined; } else { options.dataTypes.unshift( selection ); selection = inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR, selection, inspected ); } } } // If we're only executing or nothing was selected // we try the catchall dataType if not done already if ( ( executeOnly || !selection ) && !inspected[ "*" ] ) { selection = inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR, "*", inspected ); } // unnecessary when only executing (prefilters) // but it'll be ignored by the caller in that case return selection; } // A special extend for ajax options // that takes "flat" options (not to be deep extended) // Fixes #9887 function ajaxExtend( target, src ) { var key, deep, flatOptions = jQuery.ajaxSettings.flatOptions || {}; for ( key in src ) { if ( src[ key ] !== undefined ) { ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; } } if ( deep ) { jQuery.extend( true, target, deep ); } } jQuery.fn.load = function( url, params, callback ) { if ( typeof url !== "string" && _load ) { return _load.apply( this, arguments ); } // Don't do a request if no elements are being requested if ( !this.length ) { return this; } var selector, type, response, self = this, off = url.indexOf(" "); if ( off >= 0 ) { selector = url.slice( off, url.length ); url = url.slice( 0, off ); } // If it's a function if ( jQuery.isFunction( params ) ) { // We assume that it's the callback callback = params; params = undefined; // Otherwise, build a param string } else if ( params && typeof params === "object" ) { type = "POST"; } // Request the remote document jQuery.ajax({ url: url, // if "type" variable is undefined, then "GET" method will be used type: type, dataType: "html", data: params, complete: function( jqXHR, status ) { if ( callback ) { self.each( callback, response || [ jqXHR.responseText, status, jqXHR ] ); } } }).done(function( responseText ) { // Save response for use in complete callback response = arguments; // See if a selector was specified self.html( selector ? // Create a dummy div to hold the results jQuery("
      ") // inject the contents of the document in, removing the scripts // to avoid any 'Permission Denied' errors in IE .append( responseText.replace( rscript, "" ) ) // Locate the specified elements .find( selector ) : // If not, just inject the full result responseText ); }); return this; }; // Attach a bunch of functions for handling common AJAX events jQuery.each( "ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split( " " ), function( i, o ){ jQuery.fn[ o ] = function( f ){ return this.on( o, f ); }; }); jQuery.each( [ "get", "post" ], function( i, method ) { jQuery[ method ] = function( url, data, callback, type ) { // shift arguments if data argument was omitted if ( jQuery.isFunction( data ) ) { type = type || callback; callback = data; data = undefined; } return jQuery.ajax({ type: method, url: url, data: data, success: callback, dataType: type }); }; }); jQuery.extend({ getScript: function( url, callback ) { return jQuery.get( url, undefined, callback, "script" ); }, getJSON: function( url, data, callback ) { return jQuery.get( url, data, callback, "json" ); }, // Creates a full fledged settings object into target // with both ajaxSettings and settings fields. // If target is omitted, writes into ajaxSettings. ajaxSetup: function( target, settings ) { if ( settings ) { // Building a settings object ajaxExtend( target, jQuery.ajaxSettings ); } else { // Extending ajaxSettings settings = target; target = jQuery.ajaxSettings; } ajaxExtend( target, settings ); return target; }, ajaxSettings: { url: ajaxLocation, isLocal: rlocalProtocol.test( ajaxLocParts[ 1 ] ), global: true, type: "GET", contentType: "application/x-www-form-urlencoded; charset=UTF-8", processData: true, async: true, /* timeout: 0, data: null, dataType: null, username: null, password: null, cache: null, throws: false, traditional: false, headers: {}, */ accepts: { xml: "application/xml, text/xml", html: "text/html", text: "text/plain", json: "application/json, text/javascript", "*": allTypes }, contents: { xml: /xml/, html: /html/, json: /json/ }, responseFields: { xml: "responseXML", text: "responseText" }, // List of data converters // 1) key format is "source_type destination_type" (a single space in-between) // 2) the catchall symbol "*" can be used for source_type converters: { // Convert anything to text "* text": window.String, // Text to html (true = no transformation) "text html": true, // Evaluate text as a json expression "text json": jQuery.parseJSON, // Parse text as xml "text xml": jQuery.parseXML }, // For options that shouldn't be deep extended: // you can add your own custom options here if // and when you create one that shouldn't be // deep extended (see ajaxExtend) flatOptions: { context: true, url: true } }, ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), ajaxTransport: addToPrefiltersOrTransports( transports ), // Main method ajax: function( url, options ) { // If url is an object, simulate pre-1.5 signature if ( typeof url === "object" ) { options = url; url = undefined; } // Force options to be an object options = options || {}; var // ifModified key ifModifiedKey, // Response headers responseHeadersString, responseHeaders, // transport transport, // timeout handle timeoutTimer, // Cross-domain detection vars parts, // To know if global events are to be dispatched fireGlobals, // Loop variable i, // Create the final options object s = jQuery.ajaxSetup( {}, options ), // Callbacks context callbackContext = s.context || s, // Context for global events // It's the callbackContext if one was provided in the options // and if it's a DOM node or a jQuery collection globalEventContext = callbackContext !== s && ( callbackContext.nodeType || callbackContext instanceof jQuery ) ? jQuery( callbackContext ) : jQuery.event, // Deferreds deferred = jQuery.Deferred(), completeDeferred = jQuery.Callbacks( "once memory" ), // Status-dependent callbacks statusCode = s.statusCode || {}, // Headers (they are sent all at once) requestHeaders = {}, requestHeadersNames = {}, // The jqXHR state state = 0, // Default abort message strAbort = "canceled", // Fake xhr jqXHR = { readyState: 0, // Caches the header setRequestHeader: function( name, value ) { if ( !state ) { var lname = name.toLowerCase(); name = requestHeadersNames[ lname ] = requestHeadersNames[ lname ] || name; requestHeaders[ name ] = value; } return this; }, // Raw string getAllResponseHeaders: function() { return state === 2 ? responseHeadersString : null; }, // Builds headers hashtable if needed getResponseHeader: function( key ) { var match; if ( state === 2 ) { if ( !responseHeaders ) { responseHeaders = {}; while( ( match = rheaders.exec( responseHeadersString ) ) ) { responseHeaders[ match[1].toLowerCase() ] = match[ 2 ]; } } match = responseHeaders[ key.toLowerCase() ]; } return match === undefined ? null : match; }, // Overrides response content-type header overrideMimeType: function( type ) { if ( !state ) { s.mimeType = type; } return this; }, // Cancel the request abort: function( statusText ) { statusText = statusText || strAbort; if ( transport ) { transport.abort( statusText ); } done( 0, statusText ); return this; } }; // Callback for when everything is done // It is defined here because jslint complains if it is declared // at the end of the function (which would be more logical and readable) function done( status, nativeStatusText, responses, headers ) { var isSuccess, success, error, response, modified, statusText = nativeStatusText; // Called once if ( state === 2 ) { return; } // State is "done" now state = 2; // Clear timeout if it exists if ( timeoutTimer ) { clearTimeout( timeoutTimer ); } // Dereference transport for early garbage collection // (no matter how long the jqXHR object will be used) transport = undefined; // Cache response headers responseHeadersString = headers || ""; // Set readyState jqXHR.readyState = status > 0 ? 4 : 0; // Get response data if ( responses ) { response = ajaxHandleResponses( s, jqXHR, responses ); } // If successful, handle type chaining if ( status >= 200 && status < 300 || status === 304 ) { // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. if ( s.ifModified ) { modified = jqXHR.getResponseHeader("Last-Modified"); if ( modified ) { jQuery.lastModified[ ifModifiedKey ] = modified; } modified = jqXHR.getResponseHeader("Etag"); if ( modified ) { jQuery.etag[ ifModifiedKey ] = modified; } } // If not modified if ( status === 304 ) { statusText = "notmodified"; isSuccess = true; // If we have data } else { isSuccess = ajaxConvert( s, response ); statusText = isSuccess.state; success = isSuccess.data; error = isSuccess.error; isSuccess = !error; } } else { // We extract error from statusText // then normalize statusText and status for non-aborts error = statusText; if ( !statusText || status ) { statusText = "error"; if ( status < 0 ) { status = 0; } } } // Set data for the fake xhr object jqXHR.status = status; jqXHR.statusText = "" + ( nativeStatusText || statusText ); // Success/Error if ( isSuccess ) { deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); } else { deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); } // Status-dependent callbacks jqXHR.statusCode( statusCode ); statusCode = undefined; if ( fireGlobals ) { globalEventContext.trigger( "ajax" + ( isSuccess ? "Success" : "Error" ), [ jqXHR, s, isSuccess ? success : error ] ); } // Complete completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); if ( fireGlobals ) { globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); // Handle the global AJAX counter if ( !( --jQuery.active ) ) { jQuery.event.trigger( "ajaxStop" ); } } } // Attach deferreds deferred.promise( jqXHR ); jqXHR.success = jqXHR.done; jqXHR.error = jqXHR.fail; jqXHR.complete = completeDeferred.add; // Status-dependent callbacks jqXHR.statusCode = function( map ) { if ( map ) { var tmp; if ( state < 2 ) { for ( tmp in map ) { statusCode[ tmp ] = [ statusCode[tmp], map[tmp] ]; } } else { tmp = map[ jqXHR.status ]; jqXHR.always( tmp ); } } return this; }; // Remove hash character (#7531: and string promotion) // Add protocol if not provided (#5866: IE7 issue with protocol-less urls) // We also use the url parameter if available s.url = ( ( url || s.url ) + "" ).replace( rhash, "" ).replace( rprotocol, ajaxLocParts[ 1 ] + "//" ); // Extract dataTypes list s.dataTypes = jQuery.trim( s.dataType || "*" ).toLowerCase().split( core_rspace ); // Determine if a cross-domain request is in order if ( s.crossDomain == null ) { parts = rurl.exec( s.url.toLowerCase() ); s.crossDomain = !!( parts && ( parts[ 1 ] != ajaxLocParts[ 1 ] || parts[ 2 ] != ajaxLocParts[ 2 ] || ( parts[ 3 ] || ( parts[ 1 ] === "http:" ? 80 : 443 ) ) != ( ajaxLocParts[ 3 ] || ( ajaxLocParts[ 1 ] === "http:" ? 80 : 443 ) ) ) ); } // Convert data if not already a string if ( s.data && s.processData && typeof s.data !== "string" ) { s.data = jQuery.param( s.data, s.traditional ); } // Apply prefilters inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); // If request was aborted inside a prefilter, stop there if ( state === 2 ) { return jqXHR; } // We can fire global events as of now if asked to fireGlobals = s.global; // Uppercase the type s.type = s.type.toUpperCase(); // Determine if request has content s.hasContent = !rnoContent.test( s.type ); // Watch for a new set of requests if ( fireGlobals && jQuery.active++ === 0 ) { jQuery.event.trigger( "ajaxStart" ); } // More options handling for requests with no content if ( !s.hasContent ) { // If data is available, append data to url if ( s.data ) { s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.data; // #9682: remove data so that it's not used in an eventual retry delete s.data; } // Get ifModifiedKey before adding the anti-cache parameter ifModifiedKey = s.url; // Add anti-cache in url if needed if ( s.cache === false ) { var ts = jQuery.now(), // try replacing _= if it is there ret = s.url.replace( rts, "$1_=" + ts ); // if nothing was replaced, add timestamp to the end s.url = ret + ( ( ret === s.url ) ? ( rquery.test( s.url ) ? "&" : "?" ) + "_=" + ts : "" ); } } // Set the correct header, if data is being sent if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { jqXHR.setRequestHeader( "Content-Type", s.contentType ); } // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. if ( s.ifModified ) { ifModifiedKey = ifModifiedKey || s.url; if ( jQuery.lastModified[ ifModifiedKey ] ) { jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ ifModifiedKey ] ); } if ( jQuery.etag[ ifModifiedKey ] ) { jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ ifModifiedKey ] ); } } // Set the Accepts header for the server, depending on the dataType jqXHR.setRequestHeader( "Accept", s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[0] ] ? s.accepts[ s.dataTypes[0] ] + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : s.accepts[ "*" ] ); // Check for headers option for ( i in s.headers ) { jqXHR.setRequestHeader( i, s.headers[ i ] ); } // Allow custom headers/mimetypes and early abort if ( s.beforeSend && ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || state === 2 ) ) { // Abort if not done already and return return jqXHR.abort(); } // aborting is no longer a cancellation strAbort = "abort"; // Install callbacks on deferreds for ( i in { success: 1, error: 1, complete: 1 } ) { jqXHR[ i ]( s[ i ] ); } // Get transport transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); // If no transport, we auto-abort if ( !transport ) { done( -1, "No Transport" ); } else { jqXHR.readyState = 1; // Send global event if ( fireGlobals ) { globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); } // Timeout if ( s.async && s.timeout > 0 ) { timeoutTimer = setTimeout( function(){ jqXHR.abort( "timeout" ); }, s.timeout ); } try { state = 1; transport.send( requestHeaders, done ); } catch (e) { // Propagate exception as error if not done if ( state < 2 ) { done( -1, e ); // Simply rethrow otherwise } else { throw e; } } } return jqXHR; }, // Counter for holding the number of active queries active: 0, // Last-Modified header cache for next request lastModified: {}, etag: {} }); /* Handles responses to an ajax request: * - sets all responseXXX fields accordingly * - finds the right dataType (mediates between content-type and expected dataType) * - returns the corresponding response */ function ajaxHandleResponses( s, jqXHR, responses ) { var ct, type, finalDataType, firstDataType, contents = s.contents, dataTypes = s.dataTypes, responseFields = s.responseFields; // Fill responseXXX fields for ( type in responseFields ) { if ( type in responses ) { jqXHR[ responseFields[type] ] = responses[ type ]; } } // Remove auto dataType and get content-type in the process while( dataTypes[ 0 ] === "*" ) { dataTypes.shift(); if ( ct === undefined ) { ct = s.mimeType || jqXHR.getResponseHeader( "content-type" ); } } // Check if we're dealing with a known content-type if ( ct ) { for ( type in contents ) { if ( contents[ type ] && contents[ type ].test( ct ) ) { dataTypes.unshift( type ); break; } } } // Check to see if we have a response for the expected dataType if ( dataTypes[ 0 ] in responses ) { finalDataType = dataTypes[ 0 ]; } else { // Try convertible dataTypes for ( type in responses ) { if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[0] ] ) { finalDataType = type; break; } if ( !firstDataType ) { firstDataType = type; } } // Or just use first one finalDataType = finalDataType || firstDataType; } // If we found a dataType // We add the dataType to the list if needed // and return the corresponding response if ( finalDataType ) { if ( finalDataType !== dataTypes[ 0 ] ) { dataTypes.unshift( finalDataType ); } return responses[ finalDataType ]; } } // Chain conversions given the request and the original response function ajaxConvert( s, response ) { var conv, conv2, current, tmp, // Work with a copy of dataTypes in case we need to modify it for conversion dataTypes = s.dataTypes.slice(), prev = dataTypes[ 0 ], converters = {}, i = 0; // Apply the dataFilter if provided if ( s.dataFilter ) { response = s.dataFilter( response, s.dataType ); } // Create converters map with lowercased keys if ( dataTypes[ 1 ] ) { for ( conv in s.converters ) { converters[ conv.toLowerCase() ] = s.converters[ conv ]; } } // Convert to each sequential dataType, tolerating list modification for ( ; (current = dataTypes[++i]); ) { // There's only work to do if current dataType is non-auto if ( current !== "*" ) { // Convert response if prev dataType is non-auto and differs from current if ( prev !== "*" && prev !== current ) { // Seek a direct converter conv = converters[ prev + " " + current ] || converters[ "* " + current ]; // If none found, seek a pair if ( !conv ) { for ( conv2 in converters ) { // If conv2 outputs current tmp = conv2.split(" "); if ( tmp[ 1 ] === current ) { // If prev can be converted to accepted input conv = converters[ prev + " " + tmp[ 0 ] ] || converters[ "* " + tmp[ 0 ] ]; if ( conv ) { // Condense equivalence converters if ( conv === true ) { conv = converters[ conv2 ]; // Otherwise, insert the intermediate dataType } else if ( converters[ conv2 ] !== true ) { current = tmp[ 0 ]; dataTypes.splice( i--, 0, current ); } break; } } } } // Apply converter (if not an equivalence) if ( conv !== true ) { // Unless errors are allowed to bubble, catch and return them if ( conv && s["throws"] ) { response = conv( response ); } else { try { response = conv( response ); } catch ( e ) { return { state: "parsererror", error: conv ? e : "No conversion from " + prev + " to " + current }; } } } } // Update prev for next iteration prev = current; } } return { state: "success", data: response }; } var oldCallbacks = [], rquestion = /\?/, rjsonp = /(=)\?(?=&|$)|\?\?/, nonce = jQuery.now(); // Default jsonp settings jQuery.ajaxSetup({ jsonp: "callback", jsonpCallback: function() { var callback = oldCallbacks.pop() || ( jQuery.expando + "_" + ( nonce++ ) ); this[ callback ] = true; return callback; } }); // Detect, normalize options and install callbacks for jsonp requests jQuery.ajaxPrefilter( "json jsonp", function( s, originalSettings, jqXHR ) { var callbackName, overwritten, responseContainer, data = s.data, url = s.url, hasCallback = s.jsonp !== false, replaceInUrl = hasCallback && rjsonp.test( url ), replaceInData = hasCallback && !replaceInUrl && typeof data === "string" && !( s.contentType || "" ).indexOf("application/x-www-form-urlencoded") && rjsonp.test( data ); // Handle iff the expected data type is "jsonp" or we have a parameter to set if ( s.dataTypes[ 0 ] === "jsonp" || replaceInUrl || replaceInData ) { // Get callback name, remembering preexisting value associated with it callbackName = s.jsonpCallback = jQuery.isFunction( s.jsonpCallback ) ? s.jsonpCallback() : s.jsonpCallback; overwritten = window[ callbackName ]; // Insert callback into url or form data if ( replaceInUrl ) { s.url = url.replace( rjsonp, "$1" + callbackName ); } else if ( replaceInData ) { s.data = data.replace( rjsonp, "$1" + callbackName ); } else if ( hasCallback ) { s.url += ( rquestion.test( url ) ? "&" : "?" ) + s.jsonp + "=" + callbackName; } // Use data converter to retrieve json after script execution s.converters["script json"] = function() { if ( !responseContainer ) { jQuery.error( callbackName + " was not called" ); } return responseContainer[ 0 ]; }; // force json dataType s.dataTypes[ 0 ] = "json"; // Install callback window[ callbackName ] = function() { responseContainer = arguments; }; // Clean-up function (fires after converters) jqXHR.always(function() { // Restore preexisting value window[ callbackName ] = overwritten; // Save back as free if ( s[ callbackName ] ) { // make sure that re-using the options doesn't screw things around s.jsonpCallback = originalSettings.jsonpCallback; // save the callback name for future use oldCallbacks.push( callbackName ); } // Call if it was a function and we have a response if ( responseContainer && jQuery.isFunction( overwritten ) ) { overwritten( responseContainer[ 0 ] ); } responseContainer = overwritten = undefined; }); // Delegate to script return "script"; } }); // Install script dataType jQuery.ajaxSetup({ accepts: { script: "text/javascript, application/javascript, application/ecmascript, application/x-ecmascript" }, contents: { script: /javascript|ecmascript/ }, converters: { "text script": function( text ) { jQuery.globalEval( text ); return text; } } }); // Handle cache's special case and global jQuery.ajaxPrefilter( "script", function( s ) { if ( s.cache === undefined ) { s.cache = false; } if ( s.crossDomain ) { s.type = "GET"; s.global = false; } }); // Bind script tag hack transport jQuery.ajaxTransport( "script", function(s) { // This transport only deals with cross domain requests if ( s.crossDomain ) { var script, head = document.head || document.getElementsByTagName( "head" )[0] || document.documentElement; return { send: function( _, callback ) { script = document.createElement( "script" ); script.async = "async"; if ( s.scriptCharset ) { script.charset = s.scriptCharset; } script.src = s.url; // Attach handlers for all browsers script.onload = script.onreadystatechange = function( _, isAbort ) { if ( isAbort || !script.readyState || /loaded|complete/.test( script.readyState ) ) { // Handle memory leak in IE script.onload = script.onreadystatechange = null; // Remove the script if ( head && script.parentNode ) { head.removeChild( script ); } // Dereference the script script = undefined; // Callback if not abort if ( !isAbort ) { callback( 200, "success" ); } } }; // Use insertBefore instead of appendChild to circumvent an IE6 bug. // This arises when a base node is used (#2709 and #4378). head.insertBefore( script, head.firstChild ); }, abort: function() { if ( script ) { script.onload( 0, 1 ); } } }; } }); var xhrCallbacks, // #5280: Internet Explorer will keep connections alive if we don't abort on unload xhrOnUnloadAbort = window.ActiveXObject ? function() { // Abort all pending requests for ( var key in xhrCallbacks ) { xhrCallbacks[ key ]( 0, 1 ); } } : false, xhrId = 0; // Functions to create xhrs function createStandardXHR() { try { return new window.XMLHttpRequest(); } catch( e ) {} } function createActiveXHR() { try { return new window.ActiveXObject( "Microsoft.XMLHTTP" ); } catch( e ) {} } // Create the request object // (This is still attached to ajaxSettings for backward compatibility) jQuery.ajaxSettings.xhr = window.ActiveXObject ? /* Microsoft failed to properly * implement the XMLHttpRequest in IE7 (can't request local files), * so we use the ActiveXObject when it is available * Additionally XMLHttpRequest can be disabled in IE7/IE8 so * we need a fallback. */ function() { return !this.isLocal && createStandardXHR() || createActiveXHR(); } : // For all other browsers, use the standard XMLHttpRequest object createStandardXHR; // Determine support properties (function( xhr ) { jQuery.extend( jQuery.support, { ajax: !!xhr, cors: !!xhr && ( "withCredentials" in xhr ) }); })( jQuery.ajaxSettings.xhr() ); // Create transport if the browser can provide an xhr if ( jQuery.support.ajax ) { jQuery.ajaxTransport(function( s ) { // Cross domain only allowed if supported through XMLHttpRequest if ( !s.crossDomain || jQuery.support.cors ) { var callback; return { send: function( headers, complete ) { // Get a new xhr var handle, i, xhr = s.xhr(); // Open the socket // Passing null username, generates a login popup on Opera (#2865) if ( s.username ) { xhr.open( s.type, s.url, s.async, s.username, s.password ); } else { xhr.open( s.type, s.url, s.async ); } // Apply custom fields if provided if ( s.xhrFields ) { for ( i in s.xhrFields ) { xhr[ i ] = s.xhrFields[ i ]; } } // Override mime type if needed if ( s.mimeType && xhr.overrideMimeType ) { xhr.overrideMimeType( s.mimeType ); } // X-Requested-With header // For cross-domain requests, seeing as conditions for a preflight are // akin to a jigsaw puzzle, we simply never set it to be sure. // (it can always be set on a per-request basis or even using ajaxSetup) // For same-domain requests, won't change header if already provided. if ( !s.crossDomain && !headers["X-Requested-With"] ) { headers[ "X-Requested-With" ] = "XMLHttpRequest"; } // Need an extra try/catch for cross domain requests in Firefox 3 try { for ( i in headers ) { xhr.setRequestHeader( i, headers[ i ] ); } } catch( _ ) {} // Do send the request // This may raise an exception which is actually // handled in jQuery.ajax (so no try/catch here) xhr.send( ( s.hasContent && s.data ) || null ); // Listener callback = function( _, isAbort ) { var status, statusText, responseHeaders, responses, xml; // Firefox throws exceptions when accessing properties // of an xhr when a network error occurred // http://helpful.knobs-dials.com/index.php/Component_returned_failure_code:_0x80040111_(NS_ERROR_NOT_AVAILABLE) try { // Was never called and is aborted or complete if ( callback && ( isAbort || xhr.readyState === 4 ) ) { // Only called once callback = undefined; // Do not keep as active anymore if ( handle ) { xhr.onreadystatechange = jQuery.noop; if ( xhrOnUnloadAbort ) { delete xhrCallbacks[ handle ]; } } // If it's an abort if ( isAbort ) { // Abort it manually if needed if ( xhr.readyState !== 4 ) { xhr.abort(); } } else { status = xhr.status; responseHeaders = xhr.getAllResponseHeaders(); responses = {}; xml = xhr.responseXML; // Construct response list if ( xml && xml.documentElement /* #4958 */ ) { responses.xml = xml; } // When requesting binary data, IE6-9 will throw an exception // on any attempt to access responseText (#11426) try { responses.text = xhr.responseText; } catch( _ ) { } // Firefox throws an exception when accessing // statusText for faulty cross-domain requests try { statusText = xhr.statusText; } catch( e ) { // We normalize with Webkit giving an empty statusText statusText = ""; } // Filter status for non standard behaviors // If the request is local and we have data: assume a success // (success with no data won't get notified, that's the best we // can do given current implementations) if ( !status && s.isLocal && !s.crossDomain ) { status = responses.text ? 200 : 404; // IE - #1450: sometimes returns 1223 when it should be 204 } else if ( status === 1223 ) { status = 204; } } } } catch( firefoxAccessException ) { if ( !isAbort ) { complete( -1, firefoxAccessException ); } } // Call complete if needed if ( responses ) { complete( status, statusText, responses, responseHeaders ); } }; if ( !s.async ) { // if we're in sync mode we fire the callback callback(); } else if ( xhr.readyState === 4 ) { // (IE6 & IE7) if it's in cache and has been // retrieved directly we need to fire the callback setTimeout( callback, 0 ); } else { handle = ++xhrId; if ( xhrOnUnloadAbort ) { // Create the active xhrs callbacks list if needed // and attach the unload handler if ( !xhrCallbacks ) { xhrCallbacks = {}; jQuery( window ).unload( xhrOnUnloadAbort ); } // Add to list of active xhrs callbacks xhrCallbacks[ handle ] = callback; } xhr.onreadystatechange = callback; } }, abort: function() { if ( callback ) { callback(0,1); } } }; } }); } var fxNow, timerId, rfxtypes = /^(?:toggle|show|hide)$/, rfxnum = new RegExp( "^(?:([-+])=|)(" + core_pnum + ")([a-z%]*)$", "i" ), rrun = /queueHooks$/, animationPrefilters = [ defaultPrefilter ], tweeners = { "*": [function( prop, value ) { var end, unit, prevScale, tween = this.createTween( prop, value ), parts = rfxnum.exec( value ), target = tween.cur(), start = +target || 0, scale = 1; if ( parts ) { end = +parts[2]; unit = parts[3] || ( jQuery.cssNumber[ prop ] ? "" : "px" ); // We need to compute starting value if ( unit !== "px" && start ) { // Iteratively approximate from a nonzero starting point // Prefer the current property, because this process will be trivial if it uses the same units // Fallback to end or a simple constant start = jQuery.css( tween.elem, prop, true ) || end || 1; do { // If previous iteration zeroed out, double until we get *something* // Use a string for doubling factor so we don't accidentally see scale as unchanged below prevScale = scale = scale || ".5"; // Adjust and apply start = start / scale; jQuery.style( tween.elem, prop, start + unit ); // Update scale, tolerating zeroes from tween.cur() scale = tween.cur() / target; // Stop looping if we've hit the mark or scale is unchanged } while ( scale !== 1 && scale !== prevScale ); } tween.unit = unit; tween.start = start; // If a +=/-= token was provided, we're doing a relative animation tween.end = parts[1] ? start + ( parts[1] + 1 ) * end : end; } return tween; }] }; // Animations created synchronously will run synchronously function createFxNow() { setTimeout(function() { fxNow = undefined; }, 0 ); return ( fxNow = jQuery.now() ); } function createTweens( animation, props ) { jQuery.each( props, function( prop, value ) { var collection = ( tweeners[ prop ] || [] ).concat( tweeners[ "*" ] ), index = 0, length = collection.length; for ( ; index < length; index++ ) { if ( collection[ index ].call( animation, prop, value ) ) { // we're done with this property return; } } }); } function Animation( elem, properties, options ) { var result, index = 0, tweenerIndex = 0, length = animationPrefilters.length, deferred = jQuery.Deferred().always( function() { // don't match elem in the :animated selector delete tick.elem; }), tick = function() { var currentTime = fxNow || createFxNow(), remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), percent = 1 - ( remaining / animation.duration || 0 ), index = 0, length = animation.tweens.length; for ( ; index < length ; index++ ) { animation.tweens[ index ].run( percent ); } deferred.notifyWith( elem, [ animation, percent, remaining ]); if ( percent < 1 && length ) { return remaining; } else { deferred.resolveWith( elem, [ animation ] ); return false; } }, animation = deferred.promise({ elem: elem, props: jQuery.extend( {}, properties ), opts: jQuery.extend( true, { specialEasing: {} }, options ), originalProperties: properties, originalOptions: options, startTime: fxNow || createFxNow(), duration: options.duration, tweens: [], createTween: function( prop, end, easing ) { var tween = jQuery.Tween( elem, animation.opts, prop, end, animation.opts.specialEasing[ prop ] || animation.opts.easing ); animation.tweens.push( tween ); return tween; }, stop: function( gotoEnd ) { var index = 0, // if we are going to the end, we want to run all the tweens // otherwise we skip this part length = gotoEnd ? animation.tweens.length : 0; for ( ; index < length ; index++ ) { animation.tweens[ index ].run( 1 ); } // resolve when we played the last frame // otherwise, reject if ( gotoEnd ) { deferred.resolveWith( elem, [ animation, gotoEnd ] ); } else { deferred.rejectWith( elem, [ animation, gotoEnd ] ); } return this; } }), props = animation.props; propFilter( props, animation.opts.specialEasing ); for ( ; index < length ; index++ ) { result = animationPrefilters[ index ].call( animation, elem, props, animation.opts ); if ( result ) { return result; } } createTweens( animation, props ); if ( jQuery.isFunction( animation.opts.start ) ) { animation.opts.start.call( elem, animation ); } jQuery.fx.timer( jQuery.extend( tick, { anim: animation, queue: animation.opts.queue, elem: elem }) ); // attach callbacks from options return animation.progress( animation.opts.progress ) .done( animation.opts.done, animation.opts.complete ) .fail( animation.opts.fail ) .always( animation.opts.always ); } function propFilter( props, specialEasing ) { var index, name, easing, value, hooks; // camelCase, specialEasing and expand cssHook pass for ( index in props ) { name = jQuery.camelCase( index ); easing = specialEasing[ name ]; value = props[ index ]; if ( jQuery.isArray( value ) ) { easing = value[ 1 ]; value = props[ index ] = value[ 0 ]; } if ( index !== name ) { props[ name ] = value; delete props[ index ]; } hooks = jQuery.cssHooks[ name ]; if ( hooks && "expand" in hooks ) { value = hooks.expand( value ); delete props[ name ]; // not quite $.extend, this wont overwrite keys already present. // also - reusing 'index' from above because we have the correct "name" for ( index in value ) { if ( !( index in props ) ) { props[ index ] = value[ index ]; specialEasing[ index ] = easing; } } } else { specialEasing[ name ] = easing; } } } jQuery.Animation = jQuery.extend( Animation, { tweener: function( props, callback ) { if ( jQuery.isFunction( props ) ) { callback = props; props = [ "*" ]; } else { props = props.split(" "); } var prop, index = 0, length = props.length; for ( ; index < length ; index++ ) { prop = props[ index ]; tweeners[ prop ] = tweeners[ prop ] || []; tweeners[ prop ].unshift( callback ); } }, prefilter: function( callback, prepend ) { if ( prepend ) { animationPrefilters.unshift( callback ); } else { animationPrefilters.push( callback ); } } }); function defaultPrefilter( elem, props, opts ) { var index, prop, value, length, dataShow, tween, hooks, oldfire, anim = this, style = elem.style, orig = {}, handled = [], hidden = elem.nodeType && isHidden( elem ); // handle queue: false promises if ( !opts.queue ) { hooks = jQuery._queueHooks( elem, "fx" ); if ( hooks.unqueued == null ) { hooks.unqueued = 0; oldfire = hooks.empty.fire; hooks.empty.fire = function() { if ( !hooks.unqueued ) { oldfire(); } }; } hooks.unqueued++; anim.always(function() { // doing this makes sure that the complete handler will be called // before this completes anim.always(function() { hooks.unqueued--; if ( !jQuery.queue( elem, "fx" ).length ) { hooks.empty.fire(); } }); }); } // height/width overflow pass if ( elem.nodeType === 1 && ( "height" in props || "width" in props ) ) { // Make sure that nothing sneaks out // Record all 3 overflow attributes because IE does not // change the overflow attribute when overflowX and // overflowY are set to the same value opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; // Set display property to inline-block for height/width // animations on inline elements that are having width/height animated if ( jQuery.css( elem, "display" ) === "inline" && jQuery.css( elem, "float" ) === "none" ) { // inline-level elements accept inline-block; // block-level elements need to be inline with layout if ( !jQuery.support.inlineBlockNeedsLayout || css_defaultDisplay( elem.nodeName ) === "inline" ) { style.display = "inline-block"; } else { style.zoom = 1; } } } if ( opts.overflow ) { style.overflow = "hidden"; if ( !jQuery.support.shrinkWrapBlocks ) { anim.done(function() { style.overflow = opts.overflow[ 0 ]; style.overflowX = opts.overflow[ 1 ]; style.overflowY = opts.overflow[ 2 ]; }); } } // show/hide pass for ( index in props ) { value = props[ index ]; if ( rfxtypes.exec( value ) ) { delete props[ index ]; if ( value === ( hidden ? "hide" : "show" ) ) { continue; } handled.push( index ); } } length = handled.length; if ( length ) { dataShow = jQuery._data( elem, "fxshow" ) || jQuery._data( elem, "fxshow", {} ); if ( hidden ) { jQuery( elem ).show(); } else { anim.done(function() { jQuery( elem ).hide(); }); } anim.done(function() { var prop; jQuery.removeData( elem, "fxshow", true ); for ( prop in orig ) { jQuery.style( elem, prop, orig[ prop ] ); } }); for ( index = 0 ; index < length ; index++ ) { prop = handled[ index ]; tween = anim.createTween( prop, hidden ? dataShow[ prop ] : 0 ); orig[ prop ] = dataShow[ prop ] || jQuery.style( elem, prop ); if ( !( prop in dataShow ) ) { dataShow[ prop ] = tween.start; if ( hidden ) { tween.end = tween.start; tween.start = prop === "width" || prop === "height" ? 1 : 0; } } } } } function Tween( elem, options, prop, end, easing ) { return new Tween.prototype.init( elem, options, prop, end, easing ); } jQuery.Tween = Tween; Tween.prototype = { constructor: Tween, init: function( elem, options, prop, end, easing, unit ) { this.elem = elem; this.prop = prop; this.easing = easing || "swing"; this.options = options; this.start = this.now = this.cur(); this.end = end; this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); }, cur: function() { var hooks = Tween.propHooks[ this.prop ]; return hooks && hooks.get ? hooks.get( this ) : Tween.propHooks._default.get( this ); }, run: function( percent ) { var eased, hooks = Tween.propHooks[ this.prop ]; if ( this.options.duration ) { this.pos = eased = jQuery.easing[ this.easing ]( percent, this.options.duration * percent, 0, 1, this.options.duration ); } else { this.pos = eased = percent; } this.now = ( this.end - this.start ) * eased + this.start; if ( this.options.step ) { this.options.step.call( this.elem, this.now, this ); } if ( hooks && hooks.set ) { hooks.set( this ); } else { Tween.propHooks._default.set( this ); } return this; } }; Tween.prototype.init.prototype = Tween.prototype; Tween.propHooks = { _default: { get: function( tween ) { var result; if ( tween.elem[ tween.prop ] != null && (!tween.elem.style || tween.elem.style[ tween.prop ] == null) ) { return tween.elem[ tween.prop ]; } // passing any value as a 4th parameter to .css will automatically // attempt a parseFloat and fallback to a string if the parse fails // so, simple values such as "10px" are parsed to Float. // complex values such as "rotate(1rad)" are returned as is. result = jQuery.css( tween.elem, tween.prop, false, "" ); // Empty strings, null, undefined and "auto" are converted to 0. return !result || result === "auto" ? 0 : result; }, set: function( tween ) { // use step hook for back compat - use cssHook if its there - use .style if its // available and use plain properties where available if ( jQuery.fx.step[ tween.prop ] ) { jQuery.fx.step[ tween.prop ]( tween ); } else if ( tween.elem.style && ( tween.elem.style[ jQuery.cssProps[ tween.prop ] ] != null || jQuery.cssHooks[ tween.prop ] ) ) { jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); } else { tween.elem[ tween.prop ] = tween.now; } } } }; // Remove in 2.0 - this supports IE8's panic based approach // to setting things on disconnected nodes Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { set: function( tween ) { if ( tween.elem.nodeType && tween.elem.parentNode ) { tween.elem[ tween.prop ] = tween.now; } } }; jQuery.each([ "toggle", "show", "hide" ], function( i, name ) { var cssFn = jQuery.fn[ name ]; jQuery.fn[ name ] = function( speed, easing, callback ) { return speed == null || typeof speed === "boolean" || // special check for .toggle( handler, handler, ... ) ( !i && jQuery.isFunction( speed ) && jQuery.isFunction( easing ) ) ? cssFn.apply( this, arguments ) : this.animate( genFx( name, true ), speed, easing, callback ); }; }); jQuery.fn.extend({ fadeTo: function( speed, to, easing, callback ) { // show any hidden elements after setting opacity to 0 return this.filter( isHidden ).css( "opacity", 0 ).show() // animate to the value specified .end().animate({ opacity: to }, speed, easing, callback ); }, animate: function( prop, speed, easing, callback ) { var empty = jQuery.isEmptyObject( prop ), optall = jQuery.speed( speed, easing, callback ), doAnimation = function() { // Operate on a copy of prop so per-property easing won't be lost var anim = Animation( this, jQuery.extend( {}, prop ), optall ); // Empty animations resolve immediately if ( empty ) { anim.stop( true ); } }; return empty || optall.queue === false ? this.each( doAnimation ) : this.queue( optall.queue, doAnimation ); }, stop: function( type, clearQueue, gotoEnd ) { var stopQueue = function( hooks ) { var stop = hooks.stop; delete hooks.stop; stop( gotoEnd ); }; if ( typeof type !== "string" ) { gotoEnd = clearQueue; clearQueue = type; type = undefined; } if ( clearQueue && type !== false ) { this.queue( type || "fx", [] ); } return this.each(function() { var dequeue = true, index = type != null && type + "queueHooks", timers = jQuery.timers, data = jQuery._data( this ); if ( index ) { if ( data[ index ] && data[ index ].stop ) { stopQueue( data[ index ] ); } } else { for ( index in data ) { if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { stopQueue( data[ index ] ); } } } for ( index = timers.length; index--; ) { if ( timers[ index ].elem === this && (type == null || timers[ index ].queue === type) ) { timers[ index ].anim.stop( gotoEnd ); dequeue = false; timers.splice( index, 1 ); } } // start the next in the queue if the last step wasn't forced // timers currently will call their complete callbacks, which will dequeue // but only if they were gotoEnd if ( dequeue || !gotoEnd ) { jQuery.dequeue( this, type ); } }); } }); // Generate parameters to create a standard animation function genFx( type, includeWidth ) { var which, attrs = { height: type }, i = 0; // if we include width, step value is 1 to do all cssExpand values, // if we don't include width, step value is 2 to skip over Left and Right includeWidth = includeWidth? 1 : 0; for( ; i < 4 ; i += 2 - includeWidth ) { which = cssExpand[ i ]; attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; } if ( includeWidth ) { attrs.opacity = attrs.width = type; } return attrs; } // Generate shortcuts for custom animations jQuery.each({ slideDown: genFx("show"), slideUp: genFx("hide"), slideToggle: genFx("toggle"), fadeIn: { opacity: "show" }, fadeOut: { opacity: "hide" }, fadeToggle: { opacity: "toggle" } }, function( name, props ) { jQuery.fn[ name ] = function( speed, easing, callback ) { return this.animate( props, speed, easing, callback ); }; }); jQuery.speed = function( speed, easing, fn ) { var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { complete: fn || !fn && easing || jQuery.isFunction( speed ) && speed, duration: speed, easing: fn && easing || easing && !jQuery.isFunction( easing ) && easing }; opt.duration = jQuery.fx.off ? 0 : typeof opt.duration === "number" ? opt.duration : opt.duration in jQuery.fx.speeds ? jQuery.fx.speeds[ opt.duration ] : jQuery.fx.speeds._default; // normalize opt.queue - true/undefined/null -> "fx" if ( opt.queue == null || opt.queue === true ) { opt.queue = "fx"; } // Queueing opt.old = opt.complete; opt.complete = function() { if ( jQuery.isFunction( opt.old ) ) { opt.old.call( this ); } if ( opt.queue ) { jQuery.dequeue( this, opt.queue ); } }; return opt; }; jQuery.easing = { linear: function( p ) { return p; }, swing: function( p ) { return 0.5 - Math.cos( p*Math.PI ) / 2; } }; jQuery.timers = []; jQuery.fx = Tween.prototype.init; jQuery.fx.tick = function() { var timer, timers = jQuery.timers, i = 0; for ( ; i < timers.length; i++ ) { timer = timers[ i ]; // Checks the timer has not already been removed if ( !timer() && timers[ i ] === timer ) { timers.splice( i--, 1 ); } } if ( !timers.length ) { jQuery.fx.stop(); } }; jQuery.fx.timer = function( timer ) { if ( timer() && jQuery.timers.push( timer ) && !timerId ) { timerId = setInterval( jQuery.fx.tick, jQuery.fx.interval ); } }; jQuery.fx.interval = 13; jQuery.fx.stop = function() { clearInterval( timerId ); timerId = null; }; jQuery.fx.speeds = { slow: 600, fast: 200, // Default speed _default: 400 }; // Back Compat <1.8 extension point jQuery.fx.step = {}; if ( jQuery.expr && jQuery.expr.filters ) { jQuery.expr.filters.animated = function( elem ) { return jQuery.grep(jQuery.timers, function( fn ) { return elem === fn.elem; }).length; }; } var rroot = /^(?:body|html)$/i; jQuery.fn.offset = function( options ) { if ( arguments.length ) { return options === undefined ? this : this.each(function( i ) { jQuery.offset.setOffset( this, options, i ); }); } var box, docElem, body, win, clientTop, clientLeft, scrollTop, scrollLeft, top, left, elem = this[ 0 ], doc = elem && elem.ownerDocument; if ( !doc ) { return; } if ( (body = doc.body) === elem ) { return jQuery.offset.bodyOffset( elem ); } docElem = doc.documentElement; // Make sure we're not dealing with a disconnected DOM node if ( !jQuery.contains( docElem, elem ) ) { return { top: 0, left: 0 }; } box = elem.getBoundingClientRect(); win = getWindow( doc ); clientTop = docElem.clientTop || body.clientTop || 0; clientLeft = docElem.clientLeft || body.clientLeft || 0; scrollTop = win.pageYOffset || docElem.scrollTop; scrollLeft = win.pageXOffset || docElem.scrollLeft; top = box.top + scrollTop - clientTop; left = box.left + scrollLeft - clientLeft; return { top: top, left: left }; }; jQuery.offset = { bodyOffset: function( body ) { var top = body.offsetTop, left = body.offsetLeft; if ( jQuery.support.doesNotIncludeMarginInBodyOffset ) { top += parseFloat( jQuery.css(body, "marginTop") ) || 0; left += parseFloat( jQuery.css(body, "marginLeft") ) || 0; } return { top: top, left: left }; }, setOffset: function( elem, options, i ) { var position = jQuery.css( elem, "position" ); // set position first, in-case top/left are set even on static elem if ( position === "static" ) { elem.style.position = "relative"; } var curElem = jQuery( elem ), curOffset = curElem.offset(), curCSSTop = jQuery.css( elem, "top" ), curCSSLeft = jQuery.css( elem, "left" ), calculatePosition = ( position === "absolute" || position === "fixed" ) && jQuery.inArray("auto", [curCSSTop, curCSSLeft]) > -1, props = {}, curPosition = {}, curTop, curLeft; // need to be able to calculate position if either top or left is auto and position is either absolute or fixed if ( calculatePosition ) { curPosition = curElem.position(); curTop = curPosition.top; curLeft = curPosition.left; } else { curTop = parseFloat( curCSSTop ) || 0; curLeft = parseFloat( curCSSLeft ) || 0; } if ( jQuery.isFunction( options ) ) { options = options.call( elem, i, curOffset ); } if ( options.top != null ) { props.top = ( options.top - curOffset.top ) + curTop; } if ( options.left != null ) { props.left = ( options.left - curOffset.left ) + curLeft; } if ( "using" in options ) { options.using.call( elem, props ); } else { curElem.css( props ); } } }; jQuery.fn.extend({ position: function() { if ( !this[0] ) { return; } var elem = this[0], // Get *real* offsetParent offsetParent = this.offsetParent(), // Get correct offsets offset = this.offset(), parentOffset = rroot.test(offsetParent[0].nodeName) ? { top: 0, left: 0 } : offsetParent.offset(); // Subtract element margins // note: when an element has margin: auto the offsetLeft and marginLeft // are the same in Safari causing offset.left to incorrectly be 0 offset.top -= parseFloat( jQuery.css(elem, "marginTop") ) || 0; offset.left -= parseFloat( jQuery.css(elem, "marginLeft") ) || 0; // Add offsetParent borders parentOffset.top += parseFloat( jQuery.css(offsetParent[0], "borderTopWidth") ) || 0; parentOffset.left += parseFloat( jQuery.css(offsetParent[0], "borderLeftWidth") ) || 0; // Subtract the two offsets return { top: offset.top - parentOffset.top, left: offset.left - parentOffset.left }; }, offsetParent: function() { return this.map(function() { var offsetParent = this.offsetParent || document.body; while ( offsetParent && (!rroot.test(offsetParent.nodeName) && jQuery.css(offsetParent, "position") === "static") ) { offsetParent = offsetParent.offsetParent; } return offsetParent || document.body; }); } }); // Create scrollLeft and scrollTop methods jQuery.each( {scrollLeft: "pageXOffset", scrollTop: "pageYOffset"}, function( method, prop ) { var top = /Y/.test( prop ); jQuery.fn[ method ] = function( val ) { return jQuery.access( this, function( elem, method, val ) { var win = getWindow( elem ); if ( val === undefined ) { return win ? (prop in win) ? win[ prop ] : win.document.documentElement[ method ] : elem[ method ]; } if ( win ) { win.scrollTo( !top ? val : jQuery( win ).scrollLeft(), top ? val : jQuery( win ).scrollTop() ); } else { elem[ method ] = val; } }, method, val, arguments.length, null ); }; }); function getWindow( elem ) { return jQuery.isWindow( elem ) ? elem : elem.nodeType === 9 ? elem.defaultView || elem.parentWindow : false; } // Create innerHeight, innerWidth, height, width, outerHeight and outerWidth methods jQuery.each( { Height: "height", Width: "width" }, function( name, type ) { jQuery.each( { padding: "inner" + name, content: type, "": "outer" + name }, function( defaultExtra, funcName ) { // margin is only for outerHeight, outerWidth jQuery.fn[ funcName ] = function( margin, value ) { var chainable = arguments.length && ( defaultExtra || typeof margin !== "boolean" ), extra = defaultExtra || ( margin === true || value === true ? "margin" : "border" ); return jQuery.access( this, function( elem, type, value ) { var doc; if ( jQuery.isWindow( elem ) ) { // As of 5/8/2012 this will yield incorrect results for Mobile Safari, but there // isn't a whole lot we can do. See pull request at this URL for discussion: // https://github.com/jquery/jquery/pull/764 return elem.document.documentElement[ "client" + name ]; } // Get document width or height if ( elem.nodeType === 9 ) { doc = elem.documentElement; // Either scroll[Width/Height] or offset[Width/Height] or client[Width/Height], whichever is greatest // unfortunately, this causes bug #3838 in IE6/8 only, but there is currently no good, small way to fix it. return Math.max( elem.body[ "scroll" + name ], doc[ "scroll" + name ], elem.body[ "offset" + name ], doc[ "offset" + name ], doc[ "client" + name ] ); } return value === undefined ? // Get width or height on the element, requesting but not forcing parseFloat jQuery.css( elem, type, value, extra ) : // Set width or height on the element jQuery.style( elem, type, value, extra ); }, type, chainable ? margin : undefined, chainable, null ); }; }); }); // Expose jQuery to the global object window.jQuery = window.$ = jQuery; // Expose jQuery as an AMD module, but only for AMD loaders that // understand the issues with loading multiple versions of jQuery // in a page that all might call define(). The loader will indicate // they have special allowances for multiple jQuery versions by // specifying define.amd.jQuery = true. Register as a named module, // since jQuery can be concatenated with other files that may use define, // but not use a proper concatenation script that understands anonymous // AMD modules. A named AMD is safest and most robust way to register. // Lowercase jquery is used because AMD module names are derived from // file names, and jQuery is normally delivered in a lowercase file name. // Do this after creating the global so that if an AMD module wants to call // noConflict to hide this version of jQuery, it will work. if ( typeof define === "function" && define.amd && define.amd.jQuery ) { define( "jquery", [], function () { return jQuery; } ); } })( window ); ================================================ FILE: themes/default/assets/javascript/vendor/keymaster.js ================================================ // keymaster.js // (c) 2011 Thomas Fuchs // keymaster.js may be freely distributed under the MIT license. ;(function(global){ var k, _handlers = {}, _mods = { 16: false, 18: false, 17: false, 91: false }, _scope = 'all', // modifier keys _MODIFIERS = { '⇧': 16, shift: 16, '⌥': 18, alt: 18, option: 18, '⌃': 17, ctrl: 17, control: 17, '⌘': 91, command: 91 }, // special keys _MAP = { backspace: 8, tab: 9, clear: 12, enter: 13, 'return': 13, esc: 27, escape: 27, space: 32, left: 37, up: 38, right: 39, down: 40, del: 46, 'delete': 46, home: 36, end: 35, pageup: 33, pagedown: 34, ',': 188, '.': 190, '/': 191, '`': 192, '-': 189, '=': 187, ';': 186, '\'': 222, '[': 219, ']': 221, '\\': 220 }; for(k=1;k<20;k++) _MODIFIERS['f'+k] = 111+k; // IE doesn't support Array#indexOf, so have a simple replacement function index(array, item){ var i = array.length; while(i--) if(array[i]===item) return i; return -1; } // handle keydown event function dispatch(event, scope){ var key, handler, k, i, modifiersMatch; key = event.keyCode; // if a modifier key, set the key. property to true and return if(key == 93 || key == 224) key = 91; // right command on webkit, command on Gecko if(key in _mods) { _mods[key] = true; // 'assignKey' from inside this closure is exported to window.key for(k in _MODIFIERS) if(_MODIFIERS[k] == key) assignKey[k] = true; return; } // see if we need to ignore the keypress (ftiler() can can be overridden) // by default ignore key presses if a select, textarea, or input is focused if(!assignKey.filter.call(this, event)) return; // abort if no potentially matching shortcuts found if (!(key in _handlers)) return; // for each potential shortcut for (i = 0; i < _handlers[key].length; i++) { handler = _handlers[key][i]; // see if it's in the current scope if(handler.scope == scope || handler.scope == 'all'){ // check if modifiers match if any modifiersMatch = handler.mods.length > 0; for(k in _mods) if((!_mods[k] && index(handler.mods, +k) > -1) || (_mods[k] && index(handler.mods, +k) == -1)) modifiersMatch = false; // call the handler and stop the event if neccessary if((handler.mods.length == 0 && !_mods[16] && !_mods[18] && !_mods[17] && !_mods[91]) || modifiersMatch){ if(handler.method(event, handler)===false){ if(event.preventDefault) event.preventDefault(); else event.returnValue = false; if(event.stopPropagation) event.stopPropagation(); if(event.cancelBubble) event.cancelBubble = true; } } } } }; // unset modifier keys on keyup function clearModifier(event){ var key = event.keyCode, k; if(key == 93 || key == 224) key = 91; if(key in _mods) { _mods[key] = false; for(k in _MODIFIERS) if(_MODIFIERS[k] == key) assignKey[k] = false; } }; function resetModifiers() { for(k in _mods) _mods[k] = false; for(k in _MODIFIERS) assignKey[k] = false; } // parse and assign shortcut function assignKey(key, scope, method){ var keys, mods, i, mi; if (method === undefined) { method = scope; scope = 'all'; } key = key.replace(/\s/g,''); keys = key.split(','); if((keys[keys.length-1])=='') keys[keys.length-2] += ','; // for each shortcut for (i = 0; i < keys.length; i++) { // set modifier keys if any mods = []; key = keys[i].split('+'); if(key.length > 1){ mods = key.slice(0,key.length-1); for (mi = 0; mi < mods.length; mi++) mods[mi] = _MODIFIERS[mods[mi]]; key = [key[key.length-1]]; } // convert to keycode and... key = key[0] key = _MAP[key] || key.toUpperCase().charCodeAt(0); // ...store handler if (!(key in _handlers)) _handlers[key] = []; _handlers[key].push({ shortcut: keys[i], scope: scope, method: method, key: keys[i], mods: mods }); } }; function filter(event){ var tagName = (event.target || event.srcElement).tagName; // ignore keypressed in any elements that support keyboard data input return !(tagName == 'INPUT' || tagName == 'SELECT' || tagName == 'TEXTAREA'); } // initialize key. to false for(k in _MODIFIERS) assignKey[k] = false; // set current scope (default 'all') function setScope(scope){ _scope = scope || 'all' }; function getScope(){ return _scope || 'all' }; // delete all handlers for a given scope function deleteScope(scope){ var key, handlers, i; for (key in _handlers) { handlers = _handlers[key]; for (i = 0; i < handlers.length; ) { if (handlers[i].scope === scope) handlers.splice(i, 1); else i++; } } }; // cross-browser events function addEvent(object, event, method) { if (object.addEventListener) object.addEventListener(event, method, false); else if(object.attachEvent) object.attachEvent('on'+event, function(){ method(window.event) }); }; // set the handlers globally on document addEvent(document, 'keydown', function(event) { dispatch(event, _scope) }); // Passing _scope to a callback to ensure it remains the same by execution. Fixes #48 addEvent(document, 'keyup', clearModifier); // reset modifiers to false whenever the window is (re)focused. addEvent(window, 'focus', resetModifiers); // set window.key and window.key.set/get/deleteScope, and the default filter global.key = assignKey; global.key.setScope = setScope; global.key.getScope = getScope; global.key.deleteScope = deleteScope; global.key.filter = filter; if(typeof module !== 'undefined') module.exports = key; })(this); ================================================ FILE: themes/default/assets/javascript/vendor/underscore.js ================================================ // Underscore.js 1.3.3 // (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc. // Underscore is freely distributable under the MIT license. // Portions of Underscore are inspired or borrowed from Prototype, // Oliver Steele's Functional, and John Resig's Micro-Templating. // For all details and documentation: // http://documentcloud.github.com/underscore (function() { // Baseline setup // -------------- // Establish the root object, `window` in the browser, or `global` on the server. var root = this; // Save the previous value of the `_` variable. var previousUnderscore = root._; // Establish the object that gets returned to break out of a loop iteration. var breaker = {}; // Save bytes in the minified (but not gzipped) version: var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype; // Create quick reference variables for speed access to core prototypes. var slice = ArrayProto.slice, unshift = ArrayProto.unshift, toString = ObjProto.toString, hasOwnProperty = ObjProto.hasOwnProperty; // All **ECMAScript 5** native function implementations that we hope to use // are declared here. var nativeForEach = ArrayProto.forEach, nativeMap = ArrayProto.map, nativeReduce = ArrayProto.reduce, nativeReduceRight = ArrayProto.reduceRight, nativeFilter = ArrayProto.filter, nativeEvery = ArrayProto.every, nativeSome = ArrayProto.some, nativeIndexOf = ArrayProto.indexOf, nativeLastIndexOf = ArrayProto.lastIndexOf, nativeIsArray = Array.isArray, nativeKeys = Object.keys, nativeBind = FuncProto.bind; // Create a safe reference to the Underscore object for use below. var _ = function(obj) { return new wrapper(obj); }; // Export the Underscore object for **Node.js**, with // backwards-compatibility for the old `require()` API. If we're in // the browser, add `_` as a global object via a string identifier, // for Closure Compiler "advanced" mode. if (typeof exports !== 'undefined') { if (typeof module !== 'undefined' && module.exports) { exports = module.exports = _; } exports._ = _; } else { root['_'] = _; } // Current version. _.VERSION = '1.3.3'; // Collection Functions // -------------------- // The cornerstone, an `each` implementation, aka `forEach`. // Handles objects with the built-in `forEach`, arrays, and raw objects. // Delegates to **ECMAScript 5**'s native `forEach` if available. var each = _.each = _.forEach = function(obj, iterator, context) { if (obj == null) return; if (nativeForEach && obj.forEach === nativeForEach) { obj.forEach(iterator, context); } else if (obj.length === +obj.length) { for (var i = 0, l = obj.length; i < l; i++) { if (i in obj && iterator.call(context, obj[i], i, obj) === breaker) return; } } else { for (var key in obj) { if (_.has(obj, key)) { if (iterator.call(context, obj[key], key, obj) === breaker) return; } } } }; // Return the results of applying the iterator to each element. // Delegates to **ECMAScript 5**'s native `map` if available. _.map = _.collect = function(obj, iterator, context) { var results = []; if (obj == null) return results; if (nativeMap && obj.map === nativeMap) return obj.map(iterator, context); each(obj, function(value, index, list) { results[results.length] = iterator.call(context, value, index, list); }); if (obj.length === +obj.length) results.length = obj.length; return results; }; // **Reduce** builds up a single result from a list of values, aka `inject`, // or `foldl`. Delegates to **ECMAScript 5**'s native `reduce` if available. _.reduce = _.foldl = _.inject = function(obj, iterator, memo, context) { var initial = arguments.length > 2; if (obj == null) obj = []; if (nativeReduce && obj.reduce === nativeReduce) { if (context) iterator = _.bind(iterator, context); return initial ? obj.reduce(iterator, memo) : obj.reduce(iterator); } each(obj, function(value, index, list) { if (!initial) { memo = value; initial = true; } else { memo = iterator.call(context, memo, value, index, list); } }); if (!initial) throw new TypeError('Reduce of empty array with no initial value'); return memo; }; // The right-associative version of reduce, also known as `foldr`. // Delegates to **ECMAScript 5**'s native `reduceRight` if available. _.reduceRight = _.foldr = function(obj, iterator, memo, context) { var initial = arguments.length > 2; if (obj == null) obj = []; if (nativeReduceRight && obj.reduceRight === nativeReduceRight) { if (context) iterator = _.bind(iterator, context); return initial ? obj.reduceRight(iterator, memo) : obj.reduceRight(iterator); } var reversed = _.toArray(obj).reverse(); if (context && !initial) iterator = _.bind(iterator, context); return initial ? _.reduce(reversed, iterator, memo, context) : _.reduce(reversed, iterator); }; // Return the first value which passes a truth test. Aliased as `detect`. _.find = _.detect = function(obj, iterator, context) { var result; any(obj, function(value, index, list) { if (iterator.call(context, value, index, list)) { result = value; return true; } }); return result; }; // Return all the elements that pass a truth test. // Delegates to **ECMAScript 5**'s native `filter` if available. // Aliased as `select`. _.filter = _.select = function(obj, iterator, context) { var results = []; if (obj == null) return results; if (nativeFilter && obj.filter === nativeFilter) return obj.filter(iterator, context); each(obj, function(value, index, list) { if (iterator.call(context, value, index, list)) results[results.length] = value; }); return results; }; // Return all the elements for which a truth test fails. _.reject = function(obj, iterator, context) { var results = []; if (obj == null) return results; each(obj, function(value, index, list) { if (!iterator.call(context, value, index, list)) results[results.length] = value; }); return results; }; // Determine whether all of the elements match a truth test. // Delegates to **ECMAScript 5**'s native `every` if available. // Aliased as `all`. _.every = _.all = function(obj, iterator, context) { var result = true; if (obj == null) return result; if (nativeEvery && obj.every === nativeEvery) return obj.every(iterator, context); each(obj, function(value, index, list) { if (!(result = result && iterator.call(context, value, index, list))) return breaker; }); return !!result; }; // Determine if at least one element in the object matches a truth test. // Delegates to **ECMAScript 5**'s native `some` if available. // Aliased as `any`. var any = _.some = _.any = function(obj, iterator, context) { iterator || (iterator = _.identity); var result = false; if (obj == null) return result; if (nativeSome && obj.some === nativeSome) return obj.some(iterator, context); each(obj, function(value, index, list) { if (result || (result = iterator.call(context, value, index, list))) return breaker; }); return !!result; }; // Determine if a given value is included in the array or object using `===`. // Aliased as `contains`. _.include = _.contains = function(obj, target) { var found = false; if (obj == null) return found; if (nativeIndexOf && obj.indexOf === nativeIndexOf) return obj.indexOf(target) != -1; found = any(obj, function(value) { return value === target; }); return found; }; // Invoke a method (with arguments) on every item in a collection. _.invoke = function(obj, method) { var args = slice.call(arguments, 2); return _.map(obj, function(value) { return (_.isFunction(method) ? method || value : value[method]).apply(value, args); }); }; // Convenience version of a common use case of `map`: fetching a property. _.pluck = function(obj, key) { return _.map(obj, function(value){ return value[key]; }); }; // Return the maximum element or (element-based computation). _.max = function(obj, iterator, context) { if (!iterator && _.isArray(obj) && obj[0] === +obj[0]) return Math.max.apply(Math, obj); if (!iterator && _.isEmpty(obj)) return -Infinity; var result = {computed : -Infinity}; each(obj, function(value, index, list) { var computed = iterator ? iterator.call(context, value, index, list) : value; computed >= result.computed && (result = {value : value, computed : computed}); }); return result.value; }; // Return the minimum element (or element-based computation). _.min = function(obj, iterator, context) { if (!iterator && _.isArray(obj) && obj[0] === +obj[0]) return Math.min.apply(Math, obj); if (!iterator && _.isEmpty(obj)) return Infinity; var result = {computed : Infinity}; each(obj, function(value, index, list) { var computed = iterator ? iterator.call(context, value, index, list) : value; computed < result.computed && (result = {value : value, computed : computed}); }); return result.value; }; // Shuffle an array. _.shuffle = function(obj) { var shuffled = [], rand; each(obj, function(value, index, list) { rand = Math.floor(Math.random() * (index + 1)); shuffled[index] = shuffled[rand]; shuffled[rand] = value; }); return shuffled; }; // Sort the object's values by a criterion produced by an iterator. _.sortBy = function(obj, val, context) { var iterator = _.isFunction(val) ? val : function(obj) { return obj[val]; }; return _.pluck(_.map(obj, function(value, index, list) { return { value : value, criteria : iterator.call(context, value, index, list) }; }).sort(function(left, right) { var a = left.criteria, b = right.criteria; if (a === void 0) return 1; if (b === void 0) return -1; return a < b ? -1 : a > b ? 1 : 0; }), 'value'); }; // Groups the object's values by a criterion. Pass either a string attribute // to group by, or a function that returns the criterion. _.groupBy = function(obj, val) { var result = {}; var iterator = _.isFunction(val) ? val : function(obj) { return obj[val]; }; each(obj, function(value, index) { var key = iterator(value, index); (result[key] || (result[key] = [])).push(value); }); return result; }; // Use a comparator function to figure out at what index an object should // be inserted so as to maintain order. Uses binary search. _.sortedIndex = function(array, obj, iterator) { iterator || (iterator = _.identity); var low = 0, high = array.length; while (low < high) { var mid = (low + high) >> 1; iterator(array[mid]) < iterator(obj) ? low = mid + 1 : high = mid; } return low; }; // Safely convert anything iterable into a real, live array. _.toArray = function(obj) { if (!obj) return []; if (_.isArray(obj)) return slice.call(obj); if (_.isArguments(obj)) return slice.call(obj); if (obj.toArray && _.isFunction(obj.toArray)) return obj.toArray(); return _.values(obj); }; // Return the number of elements in an object. _.size = function(obj) { return _.isArray(obj) ? obj.length : _.keys(obj).length; }; // Array Functions // --------------- // Get the first element of an array. Passing **n** will return the first N // values in the array. Aliased as `head` and `take`. The **guard** check // allows it to work with `_.map`. _.first = _.head = _.take = function(array, n, guard) { return (n != null) && !guard ? slice.call(array, 0, n) : array[0]; }; // Returns everything but the last entry of the array. Especcialy useful on // the arguments object. Passing **n** will return all the values in // the array, excluding the last N. The **guard** check allows it to work with // `_.map`. _.initial = function(array, n, guard) { return slice.call(array, 0, array.length - ((n == null) || guard ? 1 : n)); }; // Get the last element of an array. Passing **n** will return the last N // values in the array. The **guard** check allows it to work with `_.map`. _.last = function(array, n, guard) { if ((n != null) && !guard) { return slice.call(array, Math.max(array.length - n, 0)); } else { return array[array.length - 1]; } }; // Returns everything but the first entry of the array. Aliased as `tail`. // Especially useful on the arguments object. Passing an **index** will return // the rest of the values in the array from that index onward. The **guard** // check allows it to work with `_.map`. _.rest = _.tail = function(array, index, guard) { return slice.call(array, (index == null) || guard ? 1 : index); }; // Trim out all falsy values from an array. _.compact = function(array) { return _.filter(array, function(value){ return !!value; }); }; // Return a completely flattened version of an array. _.flatten = function(array, shallow) { return _.reduce(array, function(memo, value) { if (_.isArray(value)) return memo.concat(shallow ? value : _.flatten(value)); memo[memo.length] = value; return memo; }, []); }; // Return a version of the array that does not contain the specified value(s). _.without = function(array) { return _.difference(array, slice.call(arguments, 1)); }; // Produce a duplicate-free version of the array. If the array has already // been sorted, you have the option of using a faster algorithm. // Aliased as `unique`. _.uniq = _.unique = function(array, isSorted, iterator) { var initial = iterator ? _.map(array, iterator) : array; var results = []; // The `isSorted` flag is irrelevant if the array only contains two elements. if (array.length < 3) isSorted = true; _.reduce(initial, function (memo, value, index) { if (isSorted ? _.last(memo) !== value || !memo.length : !_.include(memo, value)) { memo.push(value); results.push(array[index]); } return memo; }, []); return results; }; // Produce an array that contains the union: each distinct element from all of // the passed-in arrays. _.union = function() { return _.uniq(_.flatten(arguments, true)); }; // Produce an array that contains every item shared between all the // passed-in arrays. (Aliased as "intersect" for back-compat.) _.intersection = _.intersect = function(array) { var rest = slice.call(arguments, 1); return _.filter(_.uniq(array), function(item) { return _.every(rest, function(other) { return _.indexOf(other, item) >= 0; }); }); }; // Take the difference between one array and a number of other arrays. // Only the elements present in just the first array will remain. _.difference = function(array) { var rest = _.flatten(slice.call(arguments, 1), true); return _.filter(array, function(value){ return !_.include(rest, value); }); }; // Zip together multiple lists into a single array -- elements that share // an index go together. _.zip = function() { var args = slice.call(arguments); var length = _.max(_.pluck(args, 'length')); var results = new Array(length); for (var i = 0; i < length; i++) results[i] = _.pluck(args, "" + i); return results; }; // If the browser doesn't supply us with indexOf (I'm looking at you, **MSIE**), // we need this function. Return the position of the first occurrence of an // item in an array, or -1 if the item is not included in the array. // Delegates to **ECMAScript 5**'s native `indexOf` if available. // If the array is large and already in sort order, pass `true` // for **isSorted** to use binary search. _.indexOf = function(array, item, isSorted) { if (array == null) return -1; var i, l; if (isSorted) { i = _.sortedIndex(array, item); return array[i] === item ? i : -1; } if (nativeIndexOf && array.indexOf === nativeIndexOf) return array.indexOf(item); for (i = 0, l = array.length; i < l; i++) if (i in array && array[i] === item) return i; return -1; }; // Delegates to **ECMAScript 5**'s native `lastIndexOf` if available. _.lastIndexOf = function(array, item) { if (array == null) return -1; if (nativeLastIndexOf && array.lastIndexOf === nativeLastIndexOf) return array.lastIndexOf(item); var i = array.length; while (i--) if (i in array && array[i] === item) return i; return -1; }; // Generate an integer Array containing an arithmetic progression. A port of // the native Python `range()` function. See // [the Python documentation](http://docs.python.org/library/functions.html#range). _.range = function(start, stop, step) { if (arguments.length <= 1) { stop = start || 0; start = 0; } step = arguments[2] || 1; var len = Math.max(Math.ceil((stop - start) / step), 0); var idx = 0; var range = new Array(len); while(idx < len) { range[idx++] = start; start += step; } return range; }; // Function (ahem) Functions // ------------------ // Reusable constructor function for prototype setting. var ctor = function(){}; // Create a function bound to a given object (assigning `this`, and arguments, // optionally). Binding with arguments is also known as `curry`. // Delegates to **ECMAScript 5**'s native `Function.bind` if available. // We check for `func.bind` first, to fail fast when `func` is undefined. _.bind = function bind(func, context) { var bound, args; if (func.bind === nativeBind && nativeBind) return nativeBind.apply(func, slice.call(arguments, 1)); if (!_.isFunction(func)) throw new TypeError; args = slice.call(arguments, 2); return bound = function() { if (!(this instanceof bound)) return func.apply(context, args.concat(slice.call(arguments))); ctor.prototype = func.prototype; var self = new ctor; var result = func.apply(self, args.concat(slice.call(arguments))); if (Object(result) === result) return result; return self; }; }; // Bind all of an object's methods to that object. Useful for ensuring that // all callbacks defined on an object belong to it. _.bindAll = function(obj) { var funcs = slice.call(arguments, 1); if (funcs.length == 0) funcs = _.functions(obj); each(funcs, function(f) { obj[f] = _.bind(obj[f], obj); }); return obj; }; // Memoize an expensive function by storing its results. _.memoize = function(func, hasher) { var memo = {}; hasher || (hasher = _.identity); return function() { var key = hasher.apply(this, arguments); return _.has(memo, key) ? memo[key] : (memo[key] = func.apply(this, arguments)); }; }; // Delays a function for the given number of milliseconds, and then calls // it with the arguments supplied. _.delay = function(func, wait) { var args = slice.call(arguments, 2); return setTimeout(function(){ return func.apply(null, args); }, wait); }; // Defers a function, scheduling it to run after the current call stack has // cleared. _.defer = function(func) { return _.delay.apply(_, [func, 1].concat(slice.call(arguments, 1))); }; // Returns a function, that, when invoked, will only be triggered at most once // during a given window of time. _.throttle = function(func, wait) { var context, args, timeout, throttling, more, result; var whenDone = _.debounce(function(){ more = throttling = false; }, wait); return function() { context = this; args = arguments; var later = function() { timeout = null; if (more) func.apply(context, args); whenDone(); }; if (!timeout) timeout = setTimeout(later, wait); if (throttling) { more = true; } else { result = func.apply(context, args); } whenDone(); throttling = true; return result; }; }; // Returns a function, that, as long as it continues to be invoked, will not // be triggered. The function will be called after it stops being called for // N milliseconds. If `immediate` is passed, trigger the function on the // leading edge, instead of the trailing. _.debounce = function(func, wait, immediate) { var timeout; return function() { var context = this, args = arguments; var later = function() { timeout = null; if (!immediate) func.apply(context, args); }; if (immediate && !timeout) func.apply(context, args); clearTimeout(timeout); timeout = setTimeout(later, wait); }; }; // Returns a function that will be executed at most one time, no matter how // often you call it. Useful for lazy initialization. _.once = function(func) { var ran = false, memo; return function() { if (ran) return memo; ran = true; return memo = func.apply(this, arguments); }; }; // Returns the first function passed as an argument to the second, // allowing you to adjust arguments, run code before and after, and // conditionally execute the original function. _.wrap = function(func, wrapper) { return function() { var args = [func].concat(slice.call(arguments, 0)); return wrapper.apply(this, args); }; }; // Returns a function that is the composition of a list of functions, each // consuming the return value of the function that follows. _.compose = function() { var funcs = arguments; return function() { var args = arguments; for (var i = funcs.length - 1; i >= 0; i--) { args = [funcs[i].apply(this, args)]; } return args[0]; }; }; // Returns a function that will only be executed after being called N times. _.after = function(times, func) { if (times <= 0) return func(); return function() { if (--times < 1) { return func.apply(this, arguments); } }; }; // Object Functions // ---------------- // Retrieve the names of an object's properties. // Delegates to **ECMAScript 5**'s native `Object.keys` _.keys = nativeKeys || function(obj) { if (obj !== Object(obj)) throw new TypeError('Invalid object'); var keys = []; for (var key in obj) if (_.has(obj, key)) keys[keys.length] = key; return keys; }; // Retrieve the values of an object's properties. _.values = function(obj) { return _.map(obj, _.identity); }; // Return a sorted list of the function names available on the object. // Aliased as `methods` _.functions = _.methods = function(obj) { var names = []; for (var key in obj) { if (_.isFunction(obj[key])) names.push(key); } return names.sort(); }; // Extend a given object with all the properties in passed-in object(s). _.extend = function(obj) { each(slice.call(arguments, 1), function(source) { for (var prop in source) { obj[prop] = source[prop]; } }); return obj; }; // Return a copy of the object only containing the whitelisted properties. _.pick = function(obj) { var result = {}; each(_.flatten(slice.call(arguments, 1)), function(key) { if (key in obj) result[key] = obj[key]; }); return result; }; // Fill in a given object with default properties. _.defaults = function(obj) { each(slice.call(arguments, 1), function(source) { for (var prop in source) { if (obj[prop] == null) obj[prop] = source[prop]; } }); return obj; }; // Create a (shallow-cloned) duplicate of an object. _.clone = function(obj) { if (!_.isObject(obj)) return obj; return _.isArray(obj) ? obj.slice() : _.extend({}, obj); }; // Invokes interceptor with the obj, and then returns obj. // The primary purpose of this method is to "tap into" a method chain, in // order to perform operations on intermediate results within the chain. _.tap = function(obj, interceptor) { interceptor(obj); return obj; }; // Internal recursive comparison function. function eq(a, b, stack) { // Identical objects are equal. `0 === -0`, but they aren't identical. // See the Harmony `egal` proposal: http://wiki.ecmascript.org/doku.php?id=harmony:egal. if (a === b) return a !== 0 || 1 / a == 1 / b; // A strict comparison is necessary because `null == undefined`. if (a == null || b == null) return a === b; // Unwrap any wrapped objects. if (a._chain) a = a._wrapped; if (b._chain) b = b._wrapped; // Invoke a custom `isEqual` method if one is provided. if (a.isEqual && _.isFunction(a.isEqual)) return a.isEqual(b); if (b.isEqual && _.isFunction(b.isEqual)) return b.isEqual(a); // Compare `[[Class]]` names. var className = toString.call(a); if (className != toString.call(b)) return false; switch (className) { // Strings, numbers, dates, and booleans are compared by value. case '[object String]': // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is // equivalent to `new String("5")`. return a == String(b); case '[object Number]': // `NaN`s are equivalent, but non-reflexive. An `egal` comparison is performed for // other numeric values. return a != +a ? b != +b : (a == 0 ? 1 / a == 1 / b : a == +b); case '[object Date]': case '[object Boolean]': // Coerce dates and booleans to numeric primitive values. Dates are compared by their // millisecond representations. Note that invalid dates with millisecond representations // of `NaN` are not equivalent. return +a == +b; // RegExps are compared by their source patterns and flags. case '[object RegExp]': return a.source == b.source && a.global == b.global && a.multiline == b.multiline && a.ignoreCase == b.ignoreCase; } if (typeof a != 'object' || typeof b != 'object') return false; // Assume equality for cyclic structures. The algorithm for detecting cyclic // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`. var length = stack.length; while (length--) { // Linear search. Performance is inversely proportional to the number of // unique nested structures. if (stack[length] == a) return true; } // Add the first object to the stack of traversed objects. stack.push(a); var size = 0, result = true; // Recursively compare objects and arrays. if (className == '[object Array]') { // Compare array lengths to determine if a deep comparison is necessary. size = a.length; result = size == b.length; if (result) { // Deep compare the contents, ignoring non-numeric properties. while (size--) { // Ensure commutative equality for sparse arrays. if (!(result = size in a == size in b && eq(a[size], b[size], stack))) break; } } } else { // Objects with different constructors are not equivalent. if ('constructor' in a != 'constructor' in b || a.constructor != b.constructor) return false; // Deep compare objects. for (var key in a) { if (_.has(a, key)) { // Count the expected number of properties. size++; // Deep compare each member. if (!(result = _.has(b, key) && eq(a[key], b[key], stack))) break; } } // Ensure that both objects contain the same number of properties. if (result) { for (key in b) { if (_.has(b, key) && !(size--)) break; } result = !size; } } // Remove the first object from the stack of traversed objects. stack.pop(); return result; } // Perform a deep comparison to check if two objects are equal. _.isEqual = function(a, b) { return eq(a, b, []); }; // Is a given array, string, or object empty? // An "empty" object has no enumerable own-properties. _.isEmpty = function(obj) { if (obj == null) return true; if (_.isArray(obj) || _.isString(obj)) return obj.length === 0; for (var key in obj) if (_.has(obj, key)) return false; return true; }; // Is a given value a DOM element? _.isElement = function(obj) { return !!(obj && obj.nodeType == 1); }; // Is a given value an array? // Delegates to ECMA5's native Array.isArray _.isArray = nativeIsArray || function(obj) { return toString.call(obj) == '[object Array]'; }; // Is a given variable an object? _.isObject = function(obj) { return obj === Object(obj); }; // Is a given variable an arguments object? _.isArguments = function(obj) { return toString.call(obj) == '[object Arguments]'; }; if (!_.isArguments(arguments)) { _.isArguments = function(obj) { return !!(obj && _.has(obj, 'callee')); }; } // Is a given value a function? _.isFunction = function(obj) { return toString.call(obj) == '[object Function]'; }; // Is a given value a string? _.isString = function(obj) { return toString.call(obj) == '[object String]'; }; // Is a given value a number? _.isNumber = function(obj) { return toString.call(obj) == '[object Number]'; }; // Is a given object a finite number? _.isFinite = function(obj) { return _.isNumber(obj) && isFinite(obj); }; // Is the given value `NaN`? _.isNaN = function(obj) { // `NaN` is the only value for which `===` is not reflexive. return obj !== obj; }; // Is a given value a boolean? _.isBoolean = function(obj) { return obj === true || obj === false || toString.call(obj) == '[object Boolean]'; }; // Is a given value a date? _.isDate = function(obj) { return toString.call(obj) == '[object Date]'; }; // Is the given value a regular expression? _.isRegExp = function(obj) { return toString.call(obj) == '[object RegExp]'; }; // Is a given value equal to null? _.isNull = function(obj) { return obj === null; }; // Is a given variable undefined? _.isUndefined = function(obj) { return obj === void 0; }; // Has own property? _.has = function(obj, key) { return hasOwnProperty.call(obj, key); }; // Utility Functions // ----------------- // Run Underscore.js in *noConflict* mode, returning the `_` variable to its // previous owner. Returns a reference to the Underscore object. _.noConflict = function() { root._ = previousUnderscore; return this; }; // Keep the identity function around for default iterators. _.identity = function(value) { return value; }; // Run a function **n** times. _.times = function (n, iterator, context) { for (var i = 0; i < n; i++) iterator.call(context, i); }; // Escape a string for HTML interpolation. _.escape = function(string) { return (''+string).replace(/&/g, '&').replace(//g, '>').replace(/"/g, '"').replace(/'/g, ''').replace(/\//g,'/'); }; // If the value of the named property is a function then invoke it; // otherwise, return it. _.result = function(object, property) { if (object == null) return null; var value = object[property]; return _.isFunction(value) ? value.call(object) : value; }; // Add your own custom functions to the Underscore object, ensuring that // they're correctly added to the OOP wrapper as well. _.mixin = function(obj) { each(_.functions(obj), function(name){ addToWrapper(name, _[name] = obj[name]); }); }; // Generate a unique integer id (unique within the entire client session). // Useful for temporary DOM ids. var idCounter = 0; _.uniqueId = function(prefix) { var id = idCounter++; return prefix ? prefix + id : id; }; // By default, Underscore uses ERB-style template delimiters, change the // following template settings to use alternative delimiters. _.templateSettings = { evaluate : /<%([\s\S]+?)%>/g, interpolate : /<%=([\s\S]+?)%>/g, escape : /<%-([\s\S]+?)%>/g }; // When customizing `templateSettings`, if you don't want to define an // interpolation, evaluation or escaping regex, we need one that is // guaranteed not to match. var noMatch = /.^/; // Certain characters need to be escaped so that they can be put into a // string literal. var escapes = { '\\': '\\', "'": "'", 'r': '\r', 'n': '\n', 't': '\t', 'u2028': '\u2028', 'u2029': '\u2029' }; for (var p in escapes) escapes[escapes[p]] = p; var escaper = /\\|'|\r|\n|\t|\u2028|\u2029/g; var unescaper = /\\(\\|'|r|n|t|u2028|u2029)/g; // Within an interpolation, evaluation, or escaping, remove HTML escaping // that had been previously added. var unescape = function(code) { return code.replace(unescaper, function(match, escape) { return escapes[escape]; }); }; // JavaScript micro-templating, similar to John Resig's implementation. // Underscore templating handles arbitrary delimiters, preserves whitespace, // and correctly escapes quotes within interpolated code. _.template = function(text, data, settings) { settings = _.defaults(settings || {}, _.templateSettings); // Compile the template source, taking care to escape characters that // cannot be included in a string literal and then unescape them in code // blocks. var source = "__p+='" + text .replace(escaper, function(match) { return '\\' + escapes[match]; }) .replace(settings.escape || noMatch, function(match, code) { return "'+\n_.escape(" + unescape(code) + ")+\n'"; }) .replace(settings.interpolate || noMatch, function(match, code) { return "'+\n(" + unescape(code) + ")+\n'"; }) .replace(settings.evaluate || noMatch, function(match, code) { return "';\n" + unescape(code) + "\n;__p+='"; }) + "';\n"; // If a variable is not specified, place data values in local scope. if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n'; source = "var __p='';" + "var print=function(){__p+=Array.prototype.join.call(arguments, '')};\n" + source + "return __p;\n"; var render = new Function(settings.variable || 'obj', '_', source); if (data) return render(data, _); var template = function(data) { return render.call(this, data, _); }; // Provide the compiled function source as a convenience for build time // precompilation. template.source = 'function(' + (settings.variable || 'obj') + '){\n' + source + '}'; return template; }; // Add a "chain" function, which will delegate to the wrapper. _.chain = function(obj) { return _(obj).chain(); }; // The OOP Wrapper // --------------- // If Underscore is called as a function, it returns a wrapped object that // can be used OO-style. This wrapper holds altered versions of all the // underscore functions. Wrapped objects may be chained. var wrapper = function(obj) { this._wrapped = obj; }; // Expose `wrapper.prototype` as `_.prototype` _.prototype = wrapper.prototype; // Helper function to continue chaining intermediate results. var result = function(obj, chain) { return chain ? _(obj).chain() : obj; }; // A method to easily add functions to the OOP wrapper. var addToWrapper = function(name, func) { wrapper.prototype[name] = function() { var args = slice.call(arguments); unshift.call(args, this._wrapped); return result(func.apply(_, args), this._chain); }; }; // Add all of the Underscore functions to the wrapper object. _.mixin(_); // Add all mutator Array functions to the wrapper. each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) { var method = ArrayProto[name]; wrapper.prototype[name] = function() { var wrapped = this._wrapped; method.apply(wrapped, arguments); var length = wrapped.length; if ((name == 'shift' || name == 'splice') && length === 0) delete wrapped[0]; return result(wrapped, this._chain); }; }); // Add all accessor Array functions to the wrapper. each(['concat', 'join', 'slice'], function(name) { var method = ArrayProto[name]; wrapper.prototype[name] = function() { return result(method.apply(this._wrapped, arguments), this._chain); }; }); // Start chaining a wrapped Underscore object. wrapper.prototype.chain = function() { this._chain = true; return this; }; // Extracts the result from a wrapped and chained object. wrapper.prototype.value = function() { return this._wrapped; }; }).call(this); ================================================ FILE: themes/default/assets/stylesheets/alphabetical_index.styl ================================================ .alphaindex { margin-top: 0; font-size: 22px; } .noborder { border-top: 0px; margin-top: 0; padding-top: 4px; } .title { margin-bottom: 10px; } #files { padding: 0; font-size: 1.1em; li { list-style: none; display: inline; padding: 7px 12px; line-height: 35px; background: #F0F0F0; margin-right: 5px; } } .index { column-count: 3; column-width: 33%; > ul { margin: 0; padding: 0; padding-bottom: 10px; font-size: 1.1em; list-style: none; > li.letter { -webkit-column-break-after: avoid; font-size: 1.4em; padding-bottom: 10px; text-transform: uppercase; } > ul { margin: 0; padding-left: 20px; small { color: #666; font-size: 0.7em; } } } } ================================================ FILE: themes/default/assets/stylesheets/application.styl ================================================ //= require_tree ./vendor @import 'nib'; @import 'base'; @import 'class'; @import 'footer'; @import 'header'; @import 'alphabetical_index'; @import 'lists'; @import 'toc'; ================================================ FILE: themes/default/assets/stylesheets/base.styl ================================================ body { padding: 0 5px; font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif; font-size: 13px; } h1 { font-size: 25px; margin: 0.8em 0 0.5em; padding-top: 4px; border-top: 1px dotted #d5d5d5; } h2 { padding: 0; padding-bottom: 3px; border-bottom: 1px #aaa solid; font-size: 1.4em; margin: 1.8em 0 0.5em; } #base { display: none; } #fuzzySearch { box-shadow: rgba(0, 0, 0, 0.5) 0px 10px 30px 10px; border-radius: 10px; position: fixed; z-index: 8000; left: 0; right: 0; top: 25px; width: 80%; height: 45px; margin: 0 auto; display: none; background-color: #fff; padding-top: 25px; padding-bottom: 25px; input { margin-left: 10%; border-radius: 5px; width: 80%; border: 2px solid #05a; font-size: 20px; padding: 5px; } ol { list-style-type: none; margin: 10px 0 0 0; padding: 0; li { padding: 3px; &.stripe { background: #F0F0F0; } &.selected { background: #05a; a { color: #fff; &:visited { color: #fff; } &:hover { color: #05a; } span { color: #05a; } } } a { color: #05a; font-size: 18px; text-decoration: none; &:visited { color: #05a; } &:hover { background: #ffffa5; } span { background-color: #ff0; } } small { font-size: 14px; padding-left: 10px; color: #888; } } } } #help { box-shadow: rgba(0, 0, 0, 0.5) 0px 10px 30px 10px; border-radius: 10px; position: fixed; z-index: 8000; left: 0; right: 0; top: 50%; width: 500px; height: 460px; margin: 0 auto; margin-top: -265px; display: none; padding: 25px; background-color: #fff; ul { list-style-type: none; margin: 0; padding: 0; li { height: 35px; span { box-shadow: rgba(0, 0, 0, 0.5) 1px 1px 2px; border-radius: 3px; display: block; float: left; width: 50px; padding: 5px; margin-right: 20px; background: #eee; text-align: center; } font-weight: bold; } } } #content { a:link, a:visited { text-decoration: none; color: #05a; } a:hover { background: #ffffa5; } #filecontents { img { border: 0; } li { line-height: 25px; } table { padding: 0; border-collapse: collapse; border-spacing: 0; tr { border-top: 1px solid #CCC; background-color: white; margin: 0; padding: 0; td { border: 1px solid #CCC; text-align: left; margin: 0; padding: 6px 13px; } } } } } ================================================ FILE: themes/default/assets/stylesheets/class.styl ================================================ #content { table.box { font-size: 1em; line-height: 2; border-spacing: 0; border-collapse: collapse; tr { background-color: #fff; &:first-child { background-color: #EEE; } td { border: 1px solid #AAA; } td:first-child { width: 100px; padding-right: 10px; text-align: right; font-weight: bold; } td:last-child { min-width: 420px; padding-left: 10px; padding-right: 10px; } } } h1 .note, li .note, .properties .note, .method_details .signature .note { font-weight: normal; padding: 3px 5px; position: relative; top: -3px; text-transform: capitalize; display: inline; } .method_details .signature .note { font-size: 0.6em; top: -1px; } h1 .note { font-size: 0.5em; } li .note { top: 0px; font-size: 0.9em; } .properties .note { top: 0px; font-size: 0.85em; } ul.summary, .properties { list-style: none; font-family: monospace; font-size: 1em; line-height: 1.5em; li { margin-bottom: 5px; } .signature { border-radius: 3px; padding: 1px 10px; color: #05A; background: #EAEAFF; border: 1px solid #DFDFE5; a:hover { background: transparent; } } li[deprecated] .signature { text-decoration: line-through; } .signature + .note.title { margin-left: 7px; } .desc { margin-left: 32px; display: block; font-family: sans-serif; p { padding: 0; margin: 0; } } } dl.constants { dt { font-weight: bold; } } dl.constants, dl.properties { margin-left: 40px; dt { font-size: 1.1em; margin-bottom: 5px; .docstring { margin-left: 32px; font-size: 0.9em; font-weight: normal; } } dd { margin-bottom: 18px; } } .method_details { border-top: 1px dotted #AAA; margin-top: 15px; padding-top: 0; &:first-child { border: none; } p.signature { border-radius: 3px; font-size: 1.1em; font-weight: normal; font-family: Monaco, Consolas, Courier, monospace; padding: 6px 10px; margin-top: 18px; background: #E5E8FF; border: 1px solid #D8D8E5; } } .tags { font-size: 13px; h3 { font-size: 1em; margin-bottom: 3px; } ul { margin-top: 0px; padding-left: 30px; list-style: square; .name { font-family: monospace; font-weight: bold; } .defaultState { font-style: italic; } } .overloads { h3 { margin-bottom: 0px; } .overload { margin-left: 20px; p.signature { padding-top: 2px; padding-bottom: 2px; } } } .events { h3 { margin-bottom: 0px; } .event { margin-left: 20px; p.signature { padding-top: 2px; padding-bottom: 2px; } } } } .note { border-radius: 3px; margin-top: 10px; color: #222; background: #E3E4E3; border: 1px solid #D5D5D5; padding: 7px 10px; display: block; } .deprecated { background: #FFE5E5; border-color: #E9DADA; } .writeonly { background: #d3ff97; border-color: #c3eb8b; } .readonly { background: #FFE5E5; border-color: #E9DADA; } .bound { background: #d3ff97; border-color: #c3eb8b; } .todo { background: #FFFFC5; border-color: #ECECAA; } .private { background: #D5D5D5; border-color: #C5C5C5; } .constructor { color: white; background: #6A98D6; border-color: #6689D6; } h3.inherited, h3.included, h3.extended { font-style: italic; font-family: "Lucida Sans", "Lucida Grande", Verdana, Arial, sans-serif; font-weight: normal; padding: 0; margin: 0; margin-top: 12px; margin-bottom: 3px; font-size: 13px; } p.inherited, p.included, p.extended { word-spacing: 5px; font-size: 1.2em; padding: 0; margin: 0; margin-left: 25px; a { font-family: monospace; font-size: 0.9em; } } } ================================================ FILE: themes/default/assets/stylesheets/footer.styl ================================================ #footer { margin-top: 15px; border-top: 1px solid #ccc; text-align: center; padding: 7px 0; font-size: 12px; color: #999; a:link, a:visited { color: #999; text-decoration: none; border-bottom: 1px dotted #bbd; } a:hover { color: #05a; } } ================================================ FILE: themes/default/assets/stylesheets/header.styl ================================================ #menu { font-size: 1.3em; color: #bbb; top: -5px; position: relative; .title, a { font-size: 0.7em; } .title a { font-size: 1em; } .title { color: #555; } a:link, a:visited { color: #333; text-decoration: none; border-bottom: 1px dotted #bbd; } a:hover { color: #05a; } } #header { nav { float: right; color: #000; font-size: 0.7em; ul { list-style-type: none; &, & li { margin: 0px; padding: 0px; display: inline; } margin: 4px !important; } a { font-size: 1em; } } #search { float: right; margin-top: -3px; a:link, a:visited { box-shadow: #ddd -1px 1px 3px; border-bottom-left-radius: 3px; border-bottom-right-radius: 3px; display: block; float: left; margin-right: 4px; padding: 8px 10px; color: #05a; background: #eaf0ff; text-decoration: none; border: 1px solid #d8d8e5; } a:hover { background: #f5faff; color: #06b; } a.active { border-top-left-radius: 5px; border-top-right-radius: 5px; padding-bottom: 20px; color: #fff; background: #568; border: 1px solid #457; } a.inactive { color: #999; } } } #search_frame { box-shadow: #aaa -7px 5px 25px; display: none; position: absolute; overflow-y: scroll; z-index: 9999; top: 36px; right: 18px; width: 500px; height: 80%; background: white; border: 1px solid #999; border-collapse: collapse; } ================================================ FILE: themes/default/assets/stylesheets/lists.styl ================================================ body.list { padding: 0; margin: 0; } body { #content.list { #search { position: relative; margin-top: 5px; margin-left: 10px; } } } #content.list.tree { > ul { margin-top: 13px !important; } ul { font-size: 16px; margin: 0; padding: 0; li { margin: 0; padding: 5px; color: #000; font-size: 1em; list-style: none; white-space: nowrap; overflow: hidden; cursor: pointer; &.namespace { overflow: visible; } > a.toggle { display: block; float: left; width: 10px; height: 10px; margin-top: 5px; margin-left: 5px; background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAASCAYAAABb0P4QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAK8AAACvABQqw0mAAAABx0RVh0U29mdHdhcmUAQWRvYmUgRmlyZXdvcmtzIENTM5jWRgMAAAAVdEVYdENyZWF0aW9uIFRpbWUAMy8xNC8wOeNZPpQAAAE2SURBVDiNrZTBccIwEEXfelIAHUA6CZ24BGaWO+FuzZAK4k6gg5QAdGAq+Bxs2Yqx7BzyL7Llp/VfzZeQhCTc/ezuGzKKnKSzpCxXJM8fwNXda3df5RZETlIt6YUzSQDs93sl8w3wBZxCCE10GM1OcWbWjB2mWgEH4Mfdyxm3PSepBHibgQE2wLe7r4HjEidpnXMYdQPKEMJcsZ4zs2POYQOcaPfwMVOo58zsAdMt18BuoVDPxUJRacELbXv3hUIX2vYmOUvi8C8ydz/ThjXrqKqqLbDIAdsCKBd+Wo7GWa7o9qzOQHVVVXeAbs+yHHCH4aTsaCOQqunmUy1yBUAXkdMIfMlgF5EXLo2OpV/c/Up7jG4hhHcYLgWzAZXUc2b2ixsfvc/RmNNfOXD3Q/oeL9axJE1yT9IOoUu6MGUkAAAAAElFTkSuQmCC'); background-repeat: no-repeat; background-position: 0px -10px; &.collapsed { background-position: 0px 0px; } } > span, a { margin-left: 20px; text-decoration: none; } > a.toggle + span, a.toggle + a { margin-left: 5px; } small { color: #888; white-space: nowrap; } small.namespace { display: none; } &.result { a.toggle { visibility: hidden; } small.namespace { display: inline; } small.parent { display: none; } } } } } #content.list { padding: 0; margin: 0; h1 { padding: 12px 10px; padding-bottom: 10px; margin: 0; font-size: 1.4em; } a:hover { background: transparent; } nav { margin-left: 10px; } #search { color: #888; input { border-radius: 3px; border: 1px solid #BBB; } } a { color: #05A; cursor: pointer; text-decoration: none; } a:hover { text-decoration: underline; } ul { padding: 0; list-style: none; margin-left: 0; li[deprecated] { text-decoration: line-through; } li { padding: 5px; padding-left: 12px; margin: 0; font-size: 1.1em; list-style: none; color: #888; cursor: pointer; &.stripe { background: #F0F0F0; } &:hover { background: #ddd; } } } } ================================================ FILE: themes/default/assets/stylesheets/toc.styl ================================================ nav.toc { box-shadow: #bbb -2px 2px 6px; overflow: hidden; float: right; z-index: 500; right: 0px; max-width: 300px; padding: 20px; padding-right: 30px; margin-left: 20px; margin-bottom: 20px; background: white; border: 1px solid #DDD; p.title { margin-top: 5px; } ol { padding-left: 1.8em; } li { font-size: 1.1em; line-height: 1.7em; } > ol > li { font-size: 1.1em; font-weight: bold; } ol > ol { font-size: 0.9em; } } nav.toc.inline { box-shadow: #fff 0px 0px 0px; position: relative; float: none; padding: 0; margin: 5px 0 0 0; border: 0px; &.hidden { background: none; padding: 0; text-align: left; } } nav.toc.hidden { height: 26px; width: 140px; padding: 5px; background: #F6F6F6; text-align: center; p.title small { display: none; } } ================================================ FILE: themes/default/assets/stylesheets/vendor/highlight.css ================================================ pre code{display:block;padding:.5em;background:#f0f0f0}pre code,pre .subst,pre .tag .title,pre .lisp .title,pre .clojure .built_in,pre .nginx .title{color:black}pre .string,pre .title,pre .constant,pre .parent,pre .tag .value,pre .rules .value,pre .rules .value .number,pre .preprocessor,pre .haml .symbol,pre .ruby .symbol,pre .ruby .symbol .string,pre .aggregate,pre .template_tag,pre .django .variable,pre .smalltalk .class,pre .addition,pre .flow,pre .stream,pre .bash .variable,pre .apache .tag,pre .apache .cbracket,pre .tex .command,pre .tex .special,pre .erlang_repl .function_or_atom,pre .asciidoc .header,pre .markdown .header,pre .coffeescript .attribute{color:#800}pre .comment,pre .annotation,pre .template_comment,pre .diff .header,pre .chunk,pre .asciidoc .blockquote,pre .markdown .blockquote{color:#888}pre .number,pre .date,pre .regexp,pre .literal,pre .hexcolor,pre .smalltalk .symbol,pre .smalltalk .char,pre .go .constant,pre .change,pre .lasso .variable,pre .asciidoc .bullet,pre .markdown .bullet,pre .asciidoc .link_url,pre .markdown .link_url{color:#080}pre .label,pre .javadoc,pre .ruby .string,pre .decorator,pre .filter .argument,pre .localvars,pre .array,pre .attr_selector,pre .important,pre .pseudo,pre .pi,pre .haml .bullet,pre .doctype,pre .deletion,pre .envvar,pre .shebang,pre .apache .sqbracket,pre .nginx .built_in,pre .tex .formula,pre .erlang_repl .reserved,pre .prompt,pre .asciidoc .link_label,pre .markdown .link_label,pre .vhdl .attribute,pre .clojure .attribute,pre .asciidoc .attribute,pre .lasso .attribute,pre .coffeescript .property{color:#88F}pre .keyword,pre .id,pre .title,pre .built_in,pre .aggregate,pre .css .tag,pre .javadoctag,pre .phpdoc,pre .yardoctag,pre .smalltalk .class,pre .winutils,pre .bash .variable,pre .apache .tag,pre .go .typename,pre .tex .command,pre .asciidoc .strong,pre .markdown .strong,pre .request,pre .status{font-weight:bold}pre .asciidoc .emphasis,pre .markdown .emphasis{font-style:italic}pre .nginx .built_in{font-weight:normal}pre .coffeescript .javascript,pre .javascript .xml,pre .lasso .markup,pre .tex .formula,pre .xml .javascript,pre .xml .vbscript,pre .xml .css,pre .xml .cdata{opacity:.5} ================================================ FILE: themes/default/lib/_theme.coffee ================================================ module.exports = {} ================================================ FILE: themes/default/lib/templater.coffee ================================================ FS = require 'fs' Path = require 'path' mkdirp = require 'mkdirp' _ = require 'underscore' hamlc = require 'haml-coffee' walkdir = require 'walkdir' Mincer = require 'mincer' Nib = require 'nib' Theme = require './_theme' module.exports = class Theme.Templater sourceOf: (subject) -> Path.join(__dirname, '..', subject) constructor: (@destination) -> Mincer.StylusEngine.configure (stylus) => stylus.use Nib() Mincer.CoffeeEngine.configure bare: false @JST = [] templates = @sourceOf('templates') for template in walkdir.sync(templates) unless FS.lstatSync(template).isDirectory() relative = Path.relative(templates, template) dirname = Path.dirname(relative) basename = Path.basename(template, '.hamlc') keyword = basename keyword = dirname + '/' + basename unless dirname == '.' @JST[keyword] = hamlc.compile FS.readFileSync(template, 'utf8'), escapeAttributes: false compileAsset: (from, to=false) -> mincer = new Mincer.Environment() mincer.appendPath @sourceOf('assets') asset = mincer.findAsset(from) file = Path.join(@destination, to || from) dir = Path.dirname(file) mkdirp.sync(dir) FS.writeFileSync(file, asset.buffer) # Render the given template with the context and the # global context object merged as template data. Writes # the file as the output filename. # # @param [String] template the template name # @param [Object] context the context object # @param [String] filename the output file name # render: (template, context = {}, filename = '') -> html = @JST[template](context) if filename.length > 0 file = Path.join @destination, filename dir = Path.dirname(file) mkdirp.sync(dir) FS.writeFileSync(file, html) html ================================================ FILE: themes/default/lib/theme.coffee ================================================ strftime = require 'strftime' FS = require 'fs' Path = require 'path' Templater = require './templater' TreeBuilder = require './tree_builder' Theme = require './_theme' Codo = require '../../../lib/codo' module.exports = class Theme.Theme options: [ {name: 'private', alias: 'p', describe: 'Show privates', boolean: true, default: false} {name: 'analytics', alias: 'a', describe: 'The Google analytics ID', default: false} {name: 'title', alias: 't', describe: 'HTML Title', default: 'CoffeeScript API Documentation'} ] @compile: (environment) -> theme = new @(environment) theme.compile() constructor: (@environment) -> @templater = new Templater(@environment.options.output) @referencer = new Codo.Tools.Referencer(@environment) compile: -> @templater.compileAsset('javascript/application.js') @templater.compileAsset('stylesheets/application.css') @renderAlphabeticalIndex() @render 'method_list', 'method_list.html' @renderClasses() @renderMixins() @renderFiles() @renderExtras() @renderIndex() @renderFuzzySearchData() # # HELPERS # awareOf: (needle) -> @environment.references[needle]? reference: (needle, prefix) -> @pathFor(@environment.reference(needle), undefined, prefix) anchorFor: (entity) -> if entity instanceof Codo.Meta.Method "#{entity.name}-#{entity.kind}" else if entity instanceof Codo.Entities.Property "#{entity.name}-property" else if entity instanceof Codo.Entities.Variable "#{entity.name}-variable" pathFor: (kind, entity, prefix='') -> unless entity? entity = kind kind = 'class' if entity instanceof Codo.Entities.Class kind = 'mixin' if entity instanceof Codo.Entities.Mixin kind = 'file' if entity instanceof Codo.Entities.File kind = 'extra' if entity instanceof Codo.Entities.Extra kind = 'method' if entity.entity instanceof Codo.Meta.Method kind = 'variable' if entity.entity instanceof Codo.Entities.Variable kind = 'property' if entity.entity instanceof Codo.Entities.Property switch kind when 'file', 'extra' prefix + kind + '/' + entity.name + '.html' when 'class', 'mixin' prefix + kind + '/' + entity.name.replace(/\./, '/') + '.html' when 'method', 'variable', 'property' @pathFor(entity.owner, undefined, prefix) + '#' + @anchorFor(entity.entity) else entity activate: (text, prefix, limit=false) -> text = @referencer.resolve text, (link, label) => "#{label}" Codo.Tools.Markdown.convert(text, limit) generateBreadcrumbs: (entries = []) -> entries = [entries] unless Array.isArray(entries) breadcrumbs = [] if @environment.options.readme breadcrumbs.push href: @pathFor('extra', @environment.findReadme()) title: @environment.options.name breadcrumbs.push(href: 'alphabetical_index.html', title: 'Index') for entry in entries if entry instanceof Object breadcrumbs.push entry else breadcrumbs.push {title: entry} breadcrumbs calculatePath: (filename) -> dirname = Path.dirname(filename) dirname.split(/[\/\\]/).map(-> '..').join('/')+'/' unless dirname == '.' render: (source, destination, context={}) -> globalContext = environment: @environment path: @calculatePath(destination) strftime: strftime anchorFor: @anchorFor pathFor: @pathFor reference: @reference awareOf: @awareOf activate: => @activate(arguments...) render: (template, context={}) => context[key] = value for key, value of globalContext @templater.render template, context context[key] = value for key, value of globalContext @templater.render source, context, destination # # RENDERERS # # Generate the alphabetical index of all classes and mixins. # renderAlphabeticalIndex: -> classes = {} mixins = {} files = {} # Sort in character group for code in [97..122] char = String.fromCharCode(code) map = [ [@environment.visibleClasses(), classes], [@environment.visibleMixins(), mixins], [@environment.visibleFiles(), files] ] for [list, storage] in map for entry in list if entry.basename.toLowerCase()[0] == char storage[char] ?= [] storage[char].push(entry) @render 'alphabetical_index', 'alphabetical_index.html', classes: classes mixins: mixins files: files renderIndex: -> list = if @environment.visibleClasses().length > 0 'class_list.html' else if @environment.visibleFiles().length > 0 'file_list.html' else if @environment.visibleMixins().length > 0 'mixin_list.html' else if @environment.visibleExtras().length > 0 'extra_list.html' else 'method_list.html' main = if @environment.options.readme @pathFor('extra', @environment.findReadme()) else 'alphabetical_index.html' @render 'frames', 'index.html', list: list main: main renderClasses: -> @render 'class_list', 'class_list.html', tree: TreeBuilder.build @environment.visibleClasses(), (klass) -> [klass.basename, klass.namespace.split('.')] for klass in @environment.visibleClasses() @render 'class', @pathFor('class', klass), entity: klass, breadcrumbs: @generateBreadcrumbs(klass.name.split '.') renderMixins: -> @render 'mixin_list', 'mixin_list.html', tree: TreeBuilder.build @environment.visibleMixins(), (klass) -> [klass.basename, klass.namespace.split('.')] for mixin in @environment.visibleMixins() @render 'mixin', @pathFor('mixin', mixin), entity: mixin breadcrumbs: @generateBreadcrumbs(mixin.name.split '.') renderFiles: -> @render 'file_list', 'file_list.html', tree: TreeBuilder.build @environment.visibleFiles(), (file) -> [file.basename, file.dirname.split('/')] for file in @environment.visibleFiles() @render 'file', @pathFor('file', file), entity: file, breadcrumbs: @generateBreadcrumbs(file.name.split '/') renderExtras: -> @render 'extra_list', 'extra_list.html', tree: TreeBuilder.build @environment.visibleExtras(), (extra) -> result = extra.name.split('/') [result.pop(), result] for extra in @environment.visibleExtras() @render 'extra', @pathFor('extra', extra), entity: extra breadcrumbs: @generateBreadcrumbs(extra.name.split '/') renderFuzzySearchData: -> search = [] everything = [ @environment.visibleClasses(), @environment.visibleMixins(), @environment.visibleFiles(), @environment.visibleExtras() ] for basics in everything for basic in basics search.push t: basic.name p: @pathFor(basic) for method in @environment.visibleMethods() search.push t: "#{method.owner.name}#{method.entity.shortSignature()}" p: @pathFor(method) content = 'window.searchData = ' + JSON.stringify(search) output = Path.join(@environment.options.output, 'javascript', 'search.js') FS.writeFileSync output, content ================================================ FILE: themes/default/lib/tree_builder.coffee ================================================ Theme = require './_theme' module.exports = class Theme.TreeBuilder @build: (collection, resolver) -> (new @ collection, resolver).tree constructor: (@collection, @resolver) -> @tree = [] for entry in @collection do (entry) => storage = @tree [name, path] = @resolver(entry) for segment in path when segment.length > 0 storage = @situate(storage, segment) @situate(storage, name, entry) situate: (storage, name, entity) -> for entry in storage if entry.name == name entry.entity = entry.entity || entity return entry.children storage.push entry = name: name children: [] entity: entity entry.children ================================================ FILE: themes/default/templates/alphabetical_index.hamlc ================================================ !!! %html != @render 'layout/header' %body != @render 'layout/intro' #content %h1.noborder.title= @title #listing %h1.alphaindex Alphabetical Index %h2 Extra File Listing - if @environment.visibleExtras().length > 0 %ul#files - for extra in @environment.visibleExtras() %li %a{href: @pathFor('extra', extra, @path), title: extra.name} = extra.name - if @environment.visibleClasses().length > 0 %h2 Class Listing A-Z .index - for char, classes of @classes %ul %li.letter= char %ul - for klass in classes %li %a{href: @pathFor('class', klass, @path)} = klass.basename - if klass.namespace %small = surround '(', ')', -> klass.namespace - if @environment.visibleMixins().length > 0 %h2 Mixins Listing A-Z .index - for char, mixins of @mixins %ul %li.letter= char %ul - for mixin in mixins %li %a{href: @pathFor('mixin', mixin, @path)} = mixin.basename - if mixin.namespace %small = surround '(', ')', -> mixin.namespace - if @environment.visibleFiles().length > 0 %h2 File Listing A-Z .index - for char, files of @files %ul %li.letter= char %ul - for file in files %li %a{href: @pathFor('file', file, @path)} = file.basename - if file.dirname %small = surround '(', ')', -> file.dirname != @render 'layout/footer' ================================================ FILE: themes/default/templates/class.hamlc ================================================ !!! %html != @render 'layout/header' %body != @render 'layout/intro', breadcrumbs: @breadcrumbs #content %h1 Class: = @entity.name - if @entity.documentation?.abstract? %span.note.title Abstract - if @entity.documentation?.deprecated? %span.deprecated.note.title Deprecated - if @entity.documentation?.private? %span.private.note.title Private - if @entity.documentation?.public? %span.public.note.title Public %table.box %tr %td Defined in: %td= @entity.file.name - if @entity.parent %tr %td Inherits: %td - if @entity.parent.visible?() %a{href: @pathFor('class', @entity.parent, @path)}= @entity.parent.name - else = @entity.parent.name || @entity.parent - if @entity.extends.length > 0 %tr %td Extends: %td - for extension, i in @entity.extends - if extension.visible?() %a{href: @pathFor('mixin', extension, @path)}= extension.name - else = extension.name || extension - if @entity.includes.length > 0 %tr %td Includes: %td - for include, i in @entity.includes - if include.visible?() %a{href: @pathFor('mixin', include, @path)}= include.name - else = include.name || include - if @entity.concerns.length > 0 %tr %td Concerns: %td - for concern, i in @entity.concerns - if concern.visible?() %a{href: @pathFor('mixin', concern, @path)}= concern.name - else = concern.name || concern - if @entity.documentation? %h2 Overview != @render 'partials/documentation', documentation: @entity.documentation, kind: 'class' - if @entity.descendants.filter((x) -> x.visible()).length > 0 %h2 Direct Known Subclasses %p.children - for descendant in @entity.descendants.filter((x) -> x.visible()) %a{href: @pathFor('class', descendant, @path)}= descendant.name - if @entity.properties.length > 0 || @entity.inheritedProperties().length > 0 %h2 Property Summary - if @entity.properties.length > 0 %dl.properties - for property in @entity.properties %dt{id: @anchorFor(property)} %span.signature - if property.documentation?.property = "(#{property.documentation.property})" - else (?) %b = property.name - unless property.setter %span.readonly.note.title Readonly - unless property.getter %span.writeonly.note.title Writeonly %dd.desc != @activate property.documentation.comment, @path, true - if @entity.parent?.visible?() && @entity.inheritedProperties().length > 0 %h3.inherited Properties inherited from %a{href: @pathFor('class', @entity.parent, @path)}= @entity.parent.name %p.inherited - for property in @entity.inheritedProperties() %a{href: @pathFor(property, undefined, @path)}= property.entity.name - if @entity.variables.length > 0 || @entity.parent?.visible?() && @entity.inheritedVariables().length > 0 %h2 Variables Summary != @render 'partials/variable_list', variables: @entity.variables - if @entity.parent?.visible?() && @entity.inheritedVariables().length > 0 %h3.inherited Variable inherited from %a{href: @pathFor('class', @entity.parent, @path)}= @entity.parent.name %p.inherited - for variable in @entity.inheritedVariables() %a{href: @pathFor(variable, undefined, @path)}= variable.entity.name - staticMethods = @entity.effectiveMethods().filter (m) -> m.kind == 'static' && m.visible - dynamicMethods = @entity.effectiveMethods().filter (m) -> m.kind == 'dynamic' && m.name != 'constructor' && m.visible - constructor = @entity.effectiveMethods().filter (m) -> m.kind == 'dynamic' && m.name == 'constructor' - if staticMethods.length > 0 %h2 Class Method Summary != @render 'partials/method_summary', methods: staticMethods - if dynamicMethods.length > 0 %h2 Instance Method Summary != @render 'partials/method_summary', methods: dynamicMethods - if @entity.parent?.visible?() && @entity.inheritedMethods().filter((x) -> x.entity.visible).length > 0 %h2 %small Inherited Method Summary %h3.inherited Methods inherited from %a{href: @pathFor('class', @entity.parent, @path)}= @entity.parent.name %p.inherited - for method in @entity.inheritedMethods().filter((x) -> x.entity.visible) %a{href: @pathFor(method, undefined, @path)}= method.entity.shortSignature() - if @entity.extends.filter((x) -> x.visible?()).length > 0 %h2 %small Extended Method Summary - for mixin in @entity.extends.filter((x) -> x.visible?()) %h3.inherited Methods extended from %a{href: @pathFor('mixin', mixin, @path)}= mixin.name %p.inherited - for method in mixin.effectiveExtensionMethods().filter((x) -> x.visible) %a{href: "#{@pathFor 'mixin', mixin, @path}##{@anchorFor(method)}"}= method.shortSignature() - if @entity.includes.filter((x) -> x.visible?()).length > 0 %h2 %small Included Method Summary - for mixin in @entity.includes.filter((x) -> x.visible?()) %h3.inherited Methods included from %a{href: @pathFor('mixin', mixin, @path)}= mixin.name %p.inherited - for method in mixin.effectiveInclusionMethods().filter((x) -> x.visible) %a{href: "#{@pathFor 'mixin', mixin, @path}##{@anchorFor(method)}"}= method.shortSignature() - if @entity.concerns.filter((x) -> x.visible?()).length > 0 %h2 %small Concerned Method Summary - for mixin in @entity.concerns.filter((x) -> x.visible?()) %h3.inherited Methods concerned from %a{href: @pathFor('mixin', mixin, @path)}= mixin.name %p.inherited - for method in mixin.effectiveConcernMethods().filter((x) -> x.visible) %a{href: "#{@pathFor 'mixin', mixin, @path}##{@anchorFor(method)}"}= method.shortSignature() - if staticMethods.length > 0 %h2 Class Method Details != @render 'partials/method_list', methods: staticMethods - if constructor.length == 1 %h2 Constructor Details != @render 'partials/method_list', methods: constructor - if dynamicMethods.length > 0 %h2 Instance Method Details != @render 'partials/method_list', methods: dynamicMethods != @render 'layout/footer' ================================================ FILE: themes/default/templates/class_list.hamlc ================================================ !!! %html != @render 'layout/header' %body.list #content.tree.list %h1.full_list_header Class List != @render 'partials/list_nav' #search Search: %input{ type: 'text' } - createLevel = (tree) => %ul - for entry in tree %li - if entry.entity %a{href: @pathFor('class', entry.entity, @path), target: 'main'} = entry.entity.basename - if entry.entity.parent %small.parent < = entry.entity.parent.name || entry.entity.parent %small.namespace = entry.entity.namespace - else %span = entry.name = createLevel(entry.children) if entry.children.length > 0 = createLevel @tree ================================================ FILE: themes/default/templates/extra.hamlc ================================================ !!! %html != @render 'layout/header' %body != @render 'layout/intro', breadcrumbs: @breadcrumbs #content %nav.toc %p.title %a.hide_toc{href: '#'} %strong Table of Contents %small != surround '(', ')', -> %a.float_toc{href: '#'}> left #filecontents != @entity.parsed != @render 'layout/footer' ================================================ FILE: themes/default/templates/extra_list.hamlc ================================================ !!! %html != @render 'layout/header' %body.list #content.tree.list %h1.full_list_header File List != @render 'partials/list_nav' #search Search: %input{ type: 'text' } - createLevel = (tree) => %ul - for entry in tree %li - if entry.entity %a{href: @pathFor('extra', entry.entity, @path), target: 'main'} = entry.name - else %span = entry.name = createLevel(entry.children) if entry.children.length > 0 = createLevel @tree ================================================ FILE: themes/default/templates/file.hamlc ================================================ !!! %html != @render 'layout/header' %body != @render 'layout/intro', breadcrumbs: @breadcrumbs #content %h1 File: = @entity.basename %table.box %tr %td Defined in: %td= @entity.dirname - if @entity.classes.length > 0 %tr %td Classes: %td - for klass in @entity.classes %a{href: @pathFor('class', klass, @path)} = klass.name - if @entity.mixins.length > 0 %tr %td Mixins: %td - for mixin in @entity.mixins %a{href: @pathFor('mixin', mixin, @path)} = mixin.name - if @entity.variables.length > 0 %h2 Variables Summary != @render 'partials/variable_list', variables: @entity.variables - if @entity.effectiveMethods().length > 0 %h2 Method Summary != @render 'partials/method_summary', methods: @entity.effectiveMethods() %h2 Method Details != @render 'partials/method_list', methods: @entity.effectiveMethods() != @render 'layout/footer' ================================================ FILE: themes/default/templates/file_list.hamlc ================================================ !!! %html != @render 'layout/header' %body.list #content.tree.list %h1.full_list_header File List != @render 'partials/list_nav' #search Search: %input{ type: 'text' } - createLevel = (tree) => %ul - for entry in tree %li - if entry.entity %a{href: @pathFor('file', entry.entity, @path), target: 'main'} = entry.entity.basename %small.namespace = entry.entity.dirname - else %span = entry.name = createLevel(entry.children) if entry.children.length > 0 = createLevel @tree ================================================ FILE: themes/default/templates/frames.hamlc ================================================ !!! %html != @render 'layout/header' %frameset{ cols: '25%, *' } %frame{ name: 'list', src: "#{@list}" } %frame#content{ name: 'main', src: "#{@main}" } ================================================ FILE: themes/default/templates/layout/footer.hamlc ================================================ #footer By %a{href: 'https://github.com/coffeedoc/codo', title: 'CoffeeScript API documentation generator'} Codo = @environment.version ✲ Press H to see the keyboard shortcuts ✲ %a{href: 'http://twitter.com/netzpirat', target: '_parent'} @netzpirat ✲ %a{href: 'http://twitter.com/_inossidabile', target: '_parent'} @_inossidabile %iframe#search_frame #fuzzySearch %input{type: 'text'} %ol #help %p Quickly fuzzy find classes, mixins, methods, file: %ul %li %span T Open fuzzy finder dialog %p Control the navigation frame: %ul %li %span L Toggle list view %li %span C Show class list %li %span I Show mixin list %li %span F Show file list %li %span M Show method list %li %span E Show extras list %p You can focus and blur the search input: %ul %li %span S Focus search input %li %span Esc Blur search input ================================================ FILE: themes/default/templates/layout/header.hamlc ================================================ %head %meta{charset: 'UTF-8'} %title= @environment.options.title %script{src: "#{@path}javascript/application.js"} %script{src: "#{@path}javascript/search.js"} %link{rel: 'stylesheet', href: "#{@path}stylesheets/application.css", type: 'text/css'} - if @environment.options.analytics :javascript var _gaq = _gaq || []; _gaq.push(['_setAccount', '#{@analytics}']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); ================================================ FILE: themes/default/templates/layout/intro.hamlc ================================================ #base{data: {path: @path}} #header #menu - if @breadcrumbs?.length > 0 - current = @breadcrumbs.pop() - for breadcrumb in @breadcrumbs - if breadcrumb.href %a{href: "#{@path}#{breadcrumb.href}", title: breadcrumb.title} = breadcrumb.title - else %span.title= breadcrumb.title » %span.title= current.title ================================================ FILE: themes/default/templates/method_list.hamlc ================================================ !!! %html != @render 'layout/header' %body.list #content.list %h1.full_list_header Method List != @render 'partials/list_nav' #search Search: %input{ type: 'text' } %ul - for method in @environment.visibleMethods() %li{deprecated: if method.documentation?.deprecated then true else false} %a{href: @pathFor(method), target: 'main', title: method.entity.name} = method.entity.shortSignature() %small = surround '(', ')', -> method.owner.name ================================================ FILE: themes/default/templates/mixin.hamlc ================================================ !!! %html != @render 'layout/header' %body != @render 'layout/intro', breadcrumbs: @breadcrumbs #content %h1 Mixin: = @entity.name - if @entity.documentation?.abstract %span.note.title Abstract - if @entity.documentation?.deprecated %span.deprecated.note.title Deprecated - if @entity.concern %span.note.concern Concern - if @entity.documentation?.private %span.note.private Private %table.box %tr %td Defined in: %td= @entity.file.name - if @entity.extensions.filter((x) -> x.visible()).length > 0 %tr %td Extended in: %td - for klass in @entity.extensions.filter((x) -> x.visible()) %a{href: @pathFor('class', klass, @path)}= klass.name - if @entity.inclusions.filter((x) -> x.visible()).length > 0 %tr %td Included in: %td - for klass in @entity.inclusions.filter((x) -> x.visible()) %a{href: @pathFor('class', klass, @path)}= klass.name - if @entity.concerns.filter((x) -> x.visible()).length > 0 %tr %td Concerned in: %td - for klass in @entity.concerns.filter((x) -> x.visible()) %a{href: @pathFor('class', klass, @path)}= klass.name - if @entity.documentation? %h2 Overview != @render 'partials/documentation', documentation: @entity.documentation, kind: 'mixin' - if @entity.concern - staticMethods = @entity.effectiveConcernMethods().filter (m) -> m.kind == 'static' && m.visible - dynamicMethods = @entity.effectiveConcernMethods().filter (m) -> m.kind == 'dynamic' && m.visible - if staticMethods.length > 0 %h2 Class Method Summary != @render 'partials/method_summary', methods: staticMethods - if dynamicMethods.length > 0 %h2 Instance Method Summary != @render 'partials/method_summary', methods: dynamicMethods - if staticMethods.length > 0 %h2 Class Method Details != @render 'partials/method_list', methods: staticMethods - if dynamicMethods.length > 0 %h2 Instance Method Details != @render 'partials/method_list', methods: dynamicMethods - else - if @entity.effectiveMethods().length > 0 %h2 Method Summary != @render 'partials/method_summary', methods: @entity.effectiveMethods().filter((m) -> m.visible) %h2 Method Details != @render 'partials/method_list', methods: @entity.effectiveMethods().filter((m) -> m.visible) != @render 'layout/footer' ================================================ FILE: themes/default/templates/mixin_list.hamlc ================================================ !!! %html != @render 'layout/header' %body.list #content.tree.list %h1.full_list_header Mixin List != @render 'partials/list_nav' #search Search: %input{ type: 'text' } - createLevel = (tree) => %ul - for entry in tree %li - if entry.entity %a{href: @pathFor('mixin', entry.entity, @path), target: 'main'} = entry.entity.basename - if entry.entity.parent %small.parent < = entry.entity.parent.name %small.namespace = entry.entity.namespace - else %span = entry.name = createLevel(entry.children) if entry.children.length > 0 = createLevel @tree ================================================ FILE: themes/default/templates/partials/documentation.hamlc ================================================ - if @documentation - show_description = false - show_description ||= @documentation[field] for field in ['deprecated', 'abstract', 'todos', 'notes', 'comment', 'examples'] - if show_description .docstring - if @documentation.deprecated? .note.deprecated %strong Deprecated. != @activate @documentation.deprecated, @path, true - if @documentation.abstract? .note.abstract %strong This = @kind is abstract. != @activate @documentation.abstract, @path, true - if @documentation.todos - for todo in @documentation.todos .note.todo %strong TODO: != @activate todo, @path, true - if @documentation.notes - for note in @documentation.notes .note %strong Note: != @activate note, @path, true != @activate @documentation.comment, @path - if @documentation.examples .examples %h3 Examples: - for example in @documentation.examples %h4 = example.title %pre %code.coffeescript= example.code .tags - if @documentation.params %h3 Parameters: %ul.param - for param in @documentation.params %li - if param.optional %span.name= '['+param.name+']' - else %span.name= param.name %span.type ( != @render('partials/type_link', type: param.type) ) - if param.defaultState %span.defaultState= ' = '+param.defaultState - if param.description — %span.desc!= @activate param.description, @path, true - if @documentation.options - for hash, options of @documentation.options %h3 Options Hash: = surround '(', '):', -> hash %ul.options - for option in options %li %span.name= option.name %span.type ( != @render('partials/type_link', type: option.type) ) - if option.description — %span.desc!= @activate option.description, @path, true - if @documentation.events .events %h3 Events: - for event in @documentation.events .event %p.signature = event.name != @render('partials/documentation', documentation: event.documentation) - if @documentation.throws %h3 Throws: %ul.throw - for throws in @documentation.throws %li %span.type - if throws.description ( != @render('partials/type_link', type: throws.type) ) — %span.desc!= @activate throws.description, @path, true - else != @render('partials/type_link', type: throws.type) - if @documentation.returns %h3 Returns: %ul.return %li %span.type - if @documentation.returns.description ( != @render('partials/type_link', type: @documentation.returns.type) ) — %span.desc!= @activate @documentation.returns.description, @path, true - else != @render('partials/type_link', type: @documentation.returns.type) - if @documentation.authors %h3 Author: %ul.author - for author in @documentation.authors %li != @activate author, @path, true - if @documentation.copyright %h3 Copyright: %ul.copyright %li != @activate @documentation.copyright, @path, true - if @documentation.since %h3 Since: %ul.since %li != @activate @documentation.since, @path, true - if @documentation.version %h3 Version: %ul.version %li != @activate @documentation.version, @path, true - if @documentation.see %h3 See also: %ul.see - for see in @documentation.see %li - if see.reference && see.label %a{href: @reference(see.reference, @path)}= see.label - else if see.reference %a{href: @reference(see.reference, @path)}= see.reference - else = see.label - if @documentation.overloads && @entity?.effectiveOverloads? .overloads %h3 Overloads: - for overload in @entity.effectiveOverloads() .overload %p.signature != @render 'partials/method_signature', method: overload != @render('partials/documentation', documentation: overload.documentation, type: 'overload') ================================================ FILE: themes/default/templates/partials/list_nav.hamlc ================================================ %nav - if @environment.visibleClasses().length > 0 %a{target: '_self', href: 'class_list.html'} Classes - if @environment.visibleMixins().length > 0 %a{target: '_self', href: 'mixin_list.html'} Mixins - if @environment.visibleFiles().length > 0 %a{target: '_self', href: 'file_list.html'} Files - if @environment.visibleMethods().length > 0 %a{target: '_self', href: 'method_list.html'} Methods - if @environment.visibleExtras().length > 0 %a{target: '_self', href: 'extra_list.html'} Extras ================================================ FILE: themes/default/templates/partials/method_list.hamlc ================================================ .methods - for method in @methods .method_details %p.signature{id: "#{method.name}-#{method.kind}"} - for overload in method.effectiveOverloads() != @render 'partials/method_signature', method: overload - if overload.bound %span.bound.note Bound - if overload.documentation?.private %span.private.note Private %br != @render 'partials/documentation', documentation: method.documentation, kind: 'method', entity: method ================================================ FILE: themes/default/templates/partials/method_signature.hamlc ================================================ = @method.kindSignature() = @method.typeSignature() %b= @method.name %span>= @method.paramsSignature() ================================================ FILE: themes/default/templates/partials/method_summary.hamlc ================================================ %ul.summary - for method in @methods %li{deprecated: if method.documentation?.deprecated? then true else false} %span.signature %a{href: '#'+@anchorFor(method)} != @render 'partials/method_signature', method: method.effectiveOverloads()[0] - if method.name == 'constructor' %span.constructor.note.title Constructor - if method.bound %span.bound.note.title Bound - if method.documentation?.private? %span.private.note.title Private - if method.documentation?.abstract? %span.abstract.note.title Abstract - if method.documentation?.deprecated? %span.deprecated.note.title Deprecated %span.desc - if method.documentation?.deprecated? %strong Deprecated. != @activate method.documentation?.deprecated, @path, true - else if method.documentation?.summary != @activate method.documentation?.summary, @path, true ================================================ FILE: themes/default/templates/partials/type_link.hamlc ================================================ - if @awareOf(@type) %tt<> %a{href: @reference(@type, @path)}<> = @type - else %tt<> = @type ================================================ FILE: themes/default/templates/partials/variable_list.hamlc ================================================ - if @variables? && @variables.length > 0 %dl.constants - for variable in @variables %dt{ id: "#{variable.name}-variable" } = variable.name \= %dd %pre %code.coffeescript= variable.value != @render 'partials/documentation', documentation: variable.documentation, kind: 'variable'