dss_tech_docs 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.editorconfig +29 -0
- data/.gitignore +37 -0
- data/.rspec +2 -0
- data/.rubocop.yml +11 -0
- data/.ruby-version +1 -0
- data/.travis.yml +9 -0
- data/CHANGELOG.md +274 -0
- data/CONTRIBUTING.md +9 -0
- data/Gemfile +4 -0
- data/LICENCE +21 -0
- data/README.md +89 -0
- data/Rakefile +13 -0
- data/docs/configuration.md +205 -0
- data/docs/core-layout-without-sidebar.png +0 -0
- data/docs/core-layout.png +0 -0
- data/docs/expired-page.png +0 -0
- data/docs/frontmatter.md +145 -0
- data/docs/last-reviewed-only.png +0 -0
- data/docs/last-reviewed-only.svg +1 -0
- data/docs/layout-layout.png +0 -0
- data/docs/not-expired-page.png +0 -0
- data/docs/page-expiry.md +85 -0
- data/dss_tech_docs.gemspec +46 -0
- data/example/.ruby-version +1 -0
- data/example/Gemfile +3 -0
- data/example/config.rb +9 -0
- data/example/config/hide-expiry.yml +51 -0
- data/example/config/tech-docs.yml +50 -0
- data/example/source/api-path.html.md +7 -0
- data/example/source/api-reference.html.md +5 -0
- data/example/source/child-of-expired-page.html.md +8 -0
- data/example/source/core-layout-without-sidebar.html.md.erb +7 -0
- data/example/source/core-layout.html.md.erb +12 -0
- data/example/source/expired-page-with-owner.html.md +10 -0
- data/example/source/expired-page.html.md +9 -0
- data/example/source/headings.html.md +11 -0
- data/example/source/index.html.md.erb +19 -0
- data/example/source/javascripts/application.js +1 -0
- data/example/source/not-expired-page.html.md +9 -0
- data/example/source/pets.yml +109 -0
- data/example/source/stylesheets/print.css.scss +3 -0
- data/example/source/stylesheets/screen-old-ie.css.scss +4 -0
- data/example/source/stylesheets/screen.css.scss +1 -0
- data/example/source/templates/proxy_template.html.md +8 -0
- data/lib/assets/javascripts/_analytics.js +58 -0
- data/lib/assets/javascripts/_govuk/modules.js +57 -0
- data/lib/assets/javascripts/_modules/anchored-headings.js +18 -0
- data/lib/assets/javascripts/_modules/collapsible-navigation.js +95 -0
- data/lib/assets/javascripts/_modules/in-page-navigation.js +132 -0
- data/lib/assets/javascripts/_modules/navigation.js +34 -0
- data/lib/assets/javascripts/_modules/page-expiry.js +15 -0
- data/lib/assets/javascripts/_modules/search.js +367 -0
- data/lib/assets/javascripts/_modules/table-of-contents.js +111 -0
- data/lib/assets/javascripts/_start-modules.js +13 -0
- data/lib/assets/javascripts/_vendor/fixedsticky.js +194 -0
- data/lib/assets/javascripts/_vendor/jquery.js +5 -0
- data/lib/assets/javascripts/_vendor/jquery.mark.js +1081 -0
- data/lib/assets/javascripts/_vendor/lodash.js +613 -0
- data/lib/assets/javascripts/_vendor/modernizr.js +3 -0
- data/lib/assets/javascripts/govuk_tech_docs.js +10 -0
- data/lib/assets/stylesheets/_accessibility.scss +9 -0
- data/lib/assets/stylesheets/_core.scss +71 -0
- data/lib/assets/stylesheets/_fonts.scss +29 -0
- data/lib/assets/stylesheets/_govuk_tech_docs.scss +2 -0
- data/lib/assets/stylesheets/_syntax-highlighting.scss +196 -0
- data/lib/assets/stylesheets/_variables.scss +12 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_colours.scss +2 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_conditionals.scss +81 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_css3.scss +90 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_device-pixels.scss +10 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_font_stack.scss +19 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_grid_layout.scss +136 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_helpers.scss +16 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_measurements.scss +14 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_shims.scss +55 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_typography.scss +249 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/_url-helpers.scss +16 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/colours/_organisation.scss +103 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/colours/_palette.scss +77 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_alpha-beta.scss +66 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_breadcrumbs.scss +53 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_buttons.scss +141 -0
- data/lib/assets/stylesheets/govuk_frontend_toolkit/design-patterns/_media-player.scss +242 -0
- data/lib/assets/stylesheets/modules/_anchored-heading.scss +54 -0
- data/lib/assets/stylesheets/modules/_app-pane.scss +64 -0
- data/lib/assets/stylesheets/modules/_collapsible.scss +52 -0
- data/lib/assets/stylesheets/modules/_contribution-banner.scss +22 -0
- data/lib/assets/stylesheets/modules/_footer.scss +130 -0
- data/lib/assets/stylesheets/modules/_govuk-logo.scss +47 -0
- data/lib/assets/stylesheets/modules/_header.scss +290 -0
- data/lib/assets/stylesheets/modules/_page-review.scss +35 -0
- data/lib/assets/stylesheets/modules/_phase-banner.scss +22 -0
- data/lib/assets/stylesheets/modules/_search.scss +137 -0
- data/lib/assets/stylesheets/modules/_skip-link.scss +31 -0
- data/lib/assets/stylesheets/modules/_technical-documentation.scss +241 -0
- data/lib/assets/stylesheets/modules/_toc.scss +216 -0
- data/lib/assets/stylesheets/modules/_warning-text.scss +73 -0
- data/lib/assets/stylesheets/palette/_syntax-highlighting.scss +23 -0
- data/lib/assets/stylesheets/utilities/_fonts.scss +29 -0
- data/lib/assets/stylesheets/utilities/_printable.scss +13 -0
- data/lib/assets/stylesheets/vendor/_fixedsticky.scss +22 -0
- data/lib/dss_tech_docs.rb +121 -0
- data/lib/govuk_tech_docs/api_reference/api_reference_extension.rb +101 -0
- data/lib/govuk_tech_docs/api_reference/api_reference_renderer.rb +279 -0
- data/lib/govuk_tech_docs/api_reference/templates/api_reference_full.html.erb +19 -0
- data/lib/govuk_tech_docs/api_reference/templates/operation.html.erb +11 -0
- data/lib/govuk_tech_docs/api_reference/templates/parameters.html.erb +28 -0
- data/lib/govuk_tech_docs/api_reference/templates/path.html.erb +4 -0
- data/lib/govuk_tech_docs/api_reference/templates/responses.html.erb +33 -0
- data/lib/govuk_tech_docs/api_reference/templates/schema.html.erb +29 -0
- data/lib/govuk_tech_docs/contribution_banner.rb +62 -0
- data/lib/govuk_tech_docs/meta_tags.rb +67 -0
- data/lib/govuk_tech_docs/page_review.rb +52 -0
- data/lib/govuk_tech_docs/pages.rb +32 -0
- data/lib/govuk_tech_docs/redirects.rb +39 -0
- data/lib/govuk_tech_docs/table_of_contents/heading.rb +30 -0
- data/lib/govuk_tech_docs/table_of_contents/heading_tree.rb +27 -0
- data/lib/govuk_tech_docs/table_of_contents/heading_tree_builder.rb +41 -0
- data/lib/govuk_tech_docs/table_of_contents/heading_tree_renderer.rb +46 -0
- data/lib/govuk_tech_docs/table_of_contents/headings_builder.rb +39 -0
- data/lib/govuk_tech_docs/table_of_contents/helpers.rb +79 -0
- data/lib/govuk_tech_docs/tech_docs_html_renderer.rb +34 -0
- data/lib/govuk_tech_docs/unique_identifier_extension.rb +13 -0
- data/lib/govuk_tech_docs/unique_identifier_generator.rb +72 -0
- data/lib/govuk_tech_docs/version.rb +3 -0
- data/lib/govuk_tech_docs/warning_text_extension.rb +23 -0
- data/lib/source/api/pages.json.erb +1 -0
- data/lib/source/favicon.ico +0 -0
- data/lib/source/images/anchored-heading-icon-2x.png +0 -0
- data/lib/source/images/anchored-heading-icon.png +0 -0
- data/lib/source/images/gov.uk_logotype_crown-2x.png +0 -0
- data/lib/source/images/gov.uk_logotype_crown.png +0 -0
- data/lib/source/images/gov.uk_logotype_crown_invert_trans.png +0 -0
- data/lib/source/images/govuk-crest-2x.png +0 -0
- data/lib/source/images/govuk-crest.png +0 -0
- data/lib/source/images/govuk-icn-close.png +0 -0
- data/lib/source/images/govuk-icn-close@2x.png +0 -0
- data/lib/source/images/govuk-icn-numbered-list.png +0 -0
- data/lib/source/images/govuk-icn-numbered-list@2x.png +0 -0
- data/lib/source/images/open-government-licence.png +0 -0
- data/lib/source/images/open-government-licence_2x.png +0 -0
- data/lib/source/images/search-result-caret.svg +13 -0
- data/lib/source/layouts/_analytics.erb +15 -0
- data/lib/source/layouts/_footer.erb +10 -0
- data/lib/source/layouts/_header.erb +44 -0
- data/lib/source/layouts/_page_review.erb +22 -0
- data/lib/source/layouts/_search.erb +16 -0
- data/lib/source/layouts/core.erb +82 -0
- data/lib/source/layouts/layout.erb +18 -0
- metadata +474 -0
|
@@ -0,0 +1,613 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Lodash (Custom Build) <https://lodash.com/>
|
|
4
|
+
* Build: `lodash -d -o lodash.js include="debounce" exports="global"`
|
|
5
|
+
* Copyright JS Foundation and other contributors <https://js.foundation/>
|
|
6
|
+
* Released under MIT license <https://lodash.com/license>
|
|
7
|
+
* Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
|
|
8
|
+
* Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
|
|
9
|
+
*/
|
|
10
|
+
;(function() {
|
|
11
|
+
|
|
12
|
+
/** Used as a safe reference for `undefined` in pre-ES5 environments. */
|
|
13
|
+
var undefined;
|
|
14
|
+
|
|
15
|
+
/** Used as the semantic version number. */
|
|
16
|
+
var VERSION = '4.17.4';
|
|
17
|
+
|
|
18
|
+
/** Error message constants. */
|
|
19
|
+
var FUNC_ERROR_TEXT = 'Expected a function';
|
|
20
|
+
|
|
21
|
+
/** Used as references for various `Number` constants. */
|
|
22
|
+
var NAN = 0 / 0;
|
|
23
|
+
|
|
24
|
+
/** `Object#toString` result references. */
|
|
25
|
+
var nullTag = '[object Null]',
|
|
26
|
+
symbolTag = '[object Symbol]',
|
|
27
|
+
undefinedTag = '[object Undefined]';
|
|
28
|
+
|
|
29
|
+
/** Used to match leading and trailing whitespace. */
|
|
30
|
+
var reTrim = /^\s+|\s+$/g;
|
|
31
|
+
|
|
32
|
+
/** Used to detect bad signed hexadecimal string values. */
|
|
33
|
+
var reIsBadHex = /^[-+]0x[0-9a-f]+$/i;
|
|
34
|
+
|
|
35
|
+
/** Used to detect binary string values. */
|
|
36
|
+
var reIsBinary = /^0b[01]+$/i;
|
|
37
|
+
|
|
38
|
+
/** Used to detect octal string values. */
|
|
39
|
+
var reIsOctal = /^0o[0-7]+$/i;
|
|
40
|
+
|
|
41
|
+
/** Built-in method references without a dependency on `root`. */
|
|
42
|
+
var freeParseInt = parseInt;
|
|
43
|
+
|
|
44
|
+
/** Detect free variable `global` from Node.js. */
|
|
45
|
+
var freeGlobal = typeof global == 'object' && global && global.Object === Object && global;
|
|
46
|
+
|
|
47
|
+
/** Detect free variable `self`. */
|
|
48
|
+
var freeSelf = typeof self == 'object' && self && self.Object === Object && self;
|
|
49
|
+
|
|
50
|
+
/** Used as a reference to the global object. */
|
|
51
|
+
var root = freeGlobal || freeSelf || Function('return this')();
|
|
52
|
+
|
|
53
|
+
/*--------------------------------------------------------------------------*/
|
|
54
|
+
|
|
55
|
+
/** Used for built-in method references. */
|
|
56
|
+
var objectProto = Object.prototype;
|
|
57
|
+
|
|
58
|
+
/** Used to check objects for own properties. */
|
|
59
|
+
var hasOwnProperty = objectProto.hasOwnProperty;
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* Used to resolve the
|
|
63
|
+
* [`toStringTag`](http://ecma-international.org/ecma-262/7.0/#sec-object.prototype.tostring)
|
|
64
|
+
* of values.
|
|
65
|
+
*/
|
|
66
|
+
var nativeObjectToString = objectProto.toString;
|
|
67
|
+
|
|
68
|
+
/** Built-in value references. */
|
|
69
|
+
var Symbol = root.Symbol,
|
|
70
|
+
symToStringTag = Symbol ? Symbol.toStringTag : undefined;
|
|
71
|
+
|
|
72
|
+
/* Built-in method references for those with the same name as other `lodash` methods. */
|
|
73
|
+
var nativeMax = Math.max,
|
|
74
|
+
nativeMin = Math.min;
|
|
75
|
+
|
|
76
|
+
/** Used to lookup unminified function names. */
|
|
77
|
+
var realNames = {};
|
|
78
|
+
|
|
79
|
+
/*------------------------------------------------------------------------*/
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Creates a `lodash` object which wraps `value` to enable implicit method
|
|
83
|
+
* chain sequences. Methods that operate on and return arrays, collections,
|
|
84
|
+
* and functions can be chained together. Methods that retrieve a single value
|
|
85
|
+
* or may return a primitive value will automatically end the chain sequence
|
|
86
|
+
* and return the unwrapped value. Otherwise, the value must be unwrapped
|
|
87
|
+
* with `_#value`.
|
|
88
|
+
*
|
|
89
|
+
* Explicit chain sequences, which must be unwrapped with `_#value`, may be
|
|
90
|
+
* enabled using `_.chain`.
|
|
91
|
+
*
|
|
92
|
+
* The execution of chained methods is lazy, that is, it's deferred until
|
|
93
|
+
* `_#value` is implicitly or explicitly called.
|
|
94
|
+
*
|
|
95
|
+
* Lazy evaluation allows several methods to support shortcut fusion.
|
|
96
|
+
* Shortcut fusion is an optimization to merge iteratee calls; this avoids
|
|
97
|
+
* the creation of intermediate arrays and can greatly reduce the number of
|
|
98
|
+
* iteratee executions. Sections of a chain sequence qualify for shortcut
|
|
99
|
+
* fusion if the section is applied to an array and iteratees accept only
|
|
100
|
+
* one argument. The heuristic for whether a section qualifies for shortcut
|
|
101
|
+
* fusion is subject to change.
|
|
102
|
+
*
|
|
103
|
+
* Chaining is supported in custom builds as long as the `_#value` method is
|
|
104
|
+
* directly or indirectly included in the build.
|
|
105
|
+
*
|
|
106
|
+
* In addition to lodash methods, wrappers have `Array` and `String` methods.
|
|
107
|
+
*
|
|
108
|
+
* The wrapper `Array` methods are:
|
|
109
|
+
* `concat`, `join`, `pop`, `push`, `shift`, `sort`, `splice`, and `unshift`
|
|
110
|
+
*
|
|
111
|
+
* The wrapper `String` methods are:
|
|
112
|
+
* `replace` and `split`
|
|
113
|
+
*
|
|
114
|
+
* The wrapper methods that support shortcut fusion are:
|
|
115
|
+
* `at`, `compact`, `drop`, `dropRight`, `dropWhile`, `filter`, `find`,
|
|
116
|
+
* `findLast`, `head`, `initial`, `last`, `map`, `reject`, `reverse`, `slice`,
|
|
117
|
+
* `tail`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, and `toArray`
|
|
118
|
+
*
|
|
119
|
+
* The chainable wrapper methods are:
|
|
120
|
+
* `after`, `ary`, `assign`, `assignIn`, `assignInWith`, `assignWith`, `at`,
|
|
121
|
+
* `before`, `bind`, `bindAll`, `bindKey`, `castArray`, `chain`, `chunk`,
|
|
122
|
+
* `commit`, `compact`, `concat`, `conforms`, `constant`, `countBy`, `create`,
|
|
123
|
+
* `curry`, `debounce`, `defaults`, `defaultsDeep`, `defer`, `delay`,
|
|
124
|
+
* `difference`, `differenceBy`, `differenceWith`, `drop`, `dropRight`,
|
|
125
|
+
* `dropRightWhile`, `dropWhile`, `extend`, `extendWith`, `fill`, `filter`,
|
|
126
|
+
* `flatMap`, `flatMapDeep`, `flatMapDepth`, `flatten`, `flattenDeep`,
|
|
127
|
+
* `flattenDepth`, `flip`, `flow`, `flowRight`, `fromPairs`, `functions`,
|
|
128
|
+
* `functionsIn`, `groupBy`, `initial`, `intersection`, `intersectionBy`,
|
|
129
|
+
* `intersectionWith`, `invert`, `invertBy`, `invokeMap`, `iteratee`, `keyBy`,
|
|
130
|
+
* `keys`, `keysIn`, `map`, `mapKeys`, `mapValues`, `matches`, `matchesProperty`,
|
|
131
|
+
* `memoize`, `merge`, `mergeWith`, `method`, `methodOf`, `mixin`, `negate`,
|
|
132
|
+
* `nthArg`, `omit`, `omitBy`, `once`, `orderBy`, `over`, `overArgs`,
|
|
133
|
+
* `overEvery`, `overSome`, `partial`, `partialRight`, `partition`, `pick`,
|
|
134
|
+
* `pickBy`, `plant`, `property`, `propertyOf`, `pull`, `pullAll`, `pullAllBy`,
|
|
135
|
+
* `pullAllWith`, `pullAt`, `push`, `range`, `rangeRight`, `rearg`, `reject`,
|
|
136
|
+
* `remove`, `rest`, `reverse`, `sampleSize`, `set`, `setWith`, `shuffle`,
|
|
137
|
+
* `slice`, `sort`, `sortBy`, `splice`, `spread`, `tail`, `take`, `takeRight`,
|
|
138
|
+
* `takeRightWhile`, `takeWhile`, `tap`, `throttle`, `thru`, `toArray`,
|
|
139
|
+
* `toPairs`, `toPairsIn`, `toPath`, `toPlainObject`, `transform`, `unary`,
|
|
140
|
+
* `union`, `unionBy`, `unionWith`, `uniq`, `uniqBy`, `uniqWith`, `unset`,
|
|
141
|
+
* `unshift`, `unzip`, `unzipWith`, `update`, `updateWith`, `values`,
|
|
142
|
+
* `valuesIn`, `without`, `wrap`, `xor`, `xorBy`, `xorWith`, `zip`,
|
|
143
|
+
* `zipObject`, `zipObjectDeep`, and `zipWith`
|
|
144
|
+
*
|
|
145
|
+
* The wrapper methods that are **not** chainable by default are:
|
|
146
|
+
* `add`, `attempt`, `camelCase`, `capitalize`, `ceil`, `clamp`, `clone`,
|
|
147
|
+
* `cloneDeep`, `cloneDeepWith`, `cloneWith`, `conformsTo`, `deburr`,
|
|
148
|
+
* `defaultTo`, `divide`, `each`, `eachRight`, `endsWith`, `eq`, `escape`,
|
|
149
|
+
* `escapeRegExp`, `every`, `find`, `findIndex`, `findKey`, `findLast`,
|
|
150
|
+
* `findLastIndex`, `findLastKey`, `first`, `floor`, `forEach`, `forEachRight`,
|
|
151
|
+
* `forIn`, `forInRight`, `forOwn`, `forOwnRight`, `get`, `gt`, `gte`, `has`,
|
|
152
|
+
* `hasIn`, `head`, `identity`, `includes`, `indexOf`, `inRange`, `invoke`,
|
|
153
|
+
* `isArguments`, `isArray`, `isArrayBuffer`, `isArrayLike`, `isArrayLikeObject`,
|
|
154
|
+
* `isBoolean`, `isBuffer`, `isDate`, `isElement`, `isEmpty`, `isEqual`,
|
|
155
|
+
* `isEqualWith`, `isError`, `isFinite`, `isFunction`, `isInteger`, `isLength`,
|
|
156
|
+
* `isMap`, `isMatch`, `isMatchWith`, `isNaN`, `isNative`, `isNil`, `isNull`,
|
|
157
|
+
* `isNumber`, `isObject`, `isObjectLike`, `isPlainObject`, `isRegExp`,
|
|
158
|
+
* `isSafeInteger`, `isSet`, `isString`, `isUndefined`, `isTypedArray`,
|
|
159
|
+
* `isWeakMap`, `isWeakSet`, `join`, `kebabCase`, `last`, `lastIndexOf`,
|
|
160
|
+
* `lowerCase`, `lowerFirst`, `lt`, `lte`, `max`, `maxBy`, `mean`, `meanBy`,
|
|
161
|
+
* `min`, `minBy`, `multiply`, `noConflict`, `noop`, `now`, `nth`, `pad`,
|
|
162
|
+
* `padEnd`, `padStart`, `parseInt`, `pop`, `random`, `reduce`, `reduceRight`,
|
|
163
|
+
* `repeat`, `result`, `round`, `runInContext`, `sample`, `shift`, `size`,
|
|
164
|
+
* `snakeCase`, `some`, `sortedIndex`, `sortedIndexBy`, `sortedLastIndex`,
|
|
165
|
+
* `sortedLastIndexBy`, `startCase`, `startsWith`, `stubArray`, `stubFalse`,
|
|
166
|
+
* `stubObject`, `stubString`, `stubTrue`, `subtract`, `sum`, `sumBy`,
|
|
167
|
+
* `template`, `times`, `toFinite`, `toInteger`, `toJSON`, `toLength`,
|
|
168
|
+
* `toLower`, `toNumber`, `toSafeInteger`, `toString`, `toUpper`, `trim`,
|
|
169
|
+
* `trimEnd`, `trimStart`, `truncate`, `unescape`, `uniqueId`, `upperCase`,
|
|
170
|
+
* `upperFirst`, `value`, and `words`
|
|
171
|
+
*
|
|
172
|
+
* @name _
|
|
173
|
+
* @constructor
|
|
174
|
+
* @category Seq
|
|
175
|
+
* @param {*} value The value to wrap in a `lodash` instance.
|
|
176
|
+
* @returns {Object} Returns the new `lodash` wrapper instance.
|
|
177
|
+
* @example
|
|
178
|
+
*
|
|
179
|
+
* function square(n) {
|
|
180
|
+
* return n * n;
|
|
181
|
+
* }
|
|
182
|
+
*
|
|
183
|
+
* var wrapped = _([1, 2, 3]);
|
|
184
|
+
*
|
|
185
|
+
* // Returns an unwrapped value.
|
|
186
|
+
* wrapped.reduce(_.add);
|
|
187
|
+
* // => 6
|
|
188
|
+
*
|
|
189
|
+
* // Returns a wrapped value.
|
|
190
|
+
* var squares = wrapped.map(square);
|
|
191
|
+
*
|
|
192
|
+
* _.isArray(squares);
|
|
193
|
+
* // => false
|
|
194
|
+
*
|
|
195
|
+
* _.isArray(squares.value());
|
|
196
|
+
* // => true
|
|
197
|
+
*/
|
|
198
|
+
function lodash() {
|
|
199
|
+
// No operation performed.
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/*------------------------------------------------------------------------*/
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* The base implementation of `getTag` without fallbacks for buggy environments.
|
|
206
|
+
*
|
|
207
|
+
* @private
|
|
208
|
+
* @param {*} value The value to query.
|
|
209
|
+
* @returns {string} Returns the `toStringTag`.
|
|
210
|
+
*/
|
|
211
|
+
function baseGetTag(value) {
|
|
212
|
+
if (value == null) {
|
|
213
|
+
return value === undefined ? undefinedTag : nullTag;
|
|
214
|
+
}
|
|
215
|
+
return (symToStringTag && symToStringTag in Object(value))
|
|
216
|
+
? getRawTag(value)
|
|
217
|
+
: objectToString(value);
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/**
|
|
221
|
+
* A specialized version of `baseGetTag` which ignores `Symbol.toStringTag` values.
|
|
222
|
+
*
|
|
223
|
+
* @private
|
|
224
|
+
* @param {*} value The value to query.
|
|
225
|
+
* @returns {string} Returns the raw `toStringTag`.
|
|
226
|
+
*/
|
|
227
|
+
function getRawTag(value) {
|
|
228
|
+
var isOwn = hasOwnProperty.call(value, symToStringTag),
|
|
229
|
+
tag = value[symToStringTag];
|
|
230
|
+
|
|
231
|
+
try {
|
|
232
|
+
value[symToStringTag] = undefined;
|
|
233
|
+
var unmasked = true;
|
|
234
|
+
} catch (e) {}
|
|
235
|
+
|
|
236
|
+
var result = nativeObjectToString.call(value);
|
|
237
|
+
if (unmasked) {
|
|
238
|
+
if (isOwn) {
|
|
239
|
+
value[symToStringTag] = tag;
|
|
240
|
+
} else {
|
|
241
|
+
delete value[symToStringTag];
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
return result;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* Converts `value` to a string using `Object.prototype.toString`.
|
|
249
|
+
*
|
|
250
|
+
* @private
|
|
251
|
+
* @param {*} value The value to convert.
|
|
252
|
+
* @returns {string} Returns the converted string.
|
|
253
|
+
*/
|
|
254
|
+
function objectToString(value) {
|
|
255
|
+
return nativeObjectToString.call(value);
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/*------------------------------------------------------------------------*/
|
|
259
|
+
|
|
260
|
+
/**
|
|
261
|
+
* Gets the timestamp of the number of milliseconds that have elapsed since
|
|
262
|
+
* the Unix epoch (1 January 1970 00:00:00 UTC).
|
|
263
|
+
*
|
|
264
|
+
* @static
|
|
265
|
+
* @memberOf _
|
|
266
|
+
* @since 2.4.0
|
|
267
|
+
* @category Date
|
|
268
|
+
* @returns {number} Returns the timestamp.
|
|
269
|
+
* @example
|
|
270
|
+
*
|
|
271
|
+
* _.defer(function(stamp) {
|
|
272
|
+
* console.log(_.now() - stamp);
|
|
273
|
+
* }, _.now());
|
|
274
|
+
* // => Logs the number of milliseconds it took for the deferred invocation.
|
|
275
|
+
*/
|
|
276
|
+
var now = function() {
|
|
277
|
+
return root.Date.now();
|
|
278
|
+
};
|
|
279
|
+
|
|
280
|
+
/*------------------------------------------------------------------------*/
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Creates a debounced function that delays invoking `func` until after `wait`
|
|
284
|
+
* milliseconds have elapsed since the last time the debounced function was
|
|
285
|
+
* invoked. The debounced function comes with a `cancel` method to cancel
|
|
286
|
+
* delayed `func` invocations and a `flush` method to immediately invoke them.
|
|
287
|
+
* Provide `options` to indicate whether `func` should be invoked on the
|
|
288
|
+
* leading and/or trailing edge of the `wait` timeout. The `func` is invoked
|
|
289
|
+
* with the last arguments provided to the debounced function. Subsequent
|
|
290
|
+
* calls to the debounced function return the result of the last `func`
|
|
291
|
+
* invocation.
|
|
292
|
+
*
|
|
293
|
+
* **Note:** If `leading` and `trailing` options are `true`, `func` is
|
|
294
|
+
* invoked on the trailing edge of the timeout only if the debounced function
|
|
295
|
+
* is invoked more than once during the `wait` timeout.
|
|
296
|
+
*
|
|
297
|
+
* If `wait` is `0` and `leading` is `false`, `func` invocation is deferred
|
|
298
|
+
* until to the next tick, similar to `setTimeout` with a timeout of `0`.
|
|
299
|
+
*
|
|
300
|
+
* See [David Corbacho's article](https://css-tricks.com/debouncing-throttling-explained-examples/)
|
|
301
|
+
* for details over the differences between `_.debounce` and `_.throttle`.
|
|
302
|
+
*
|
|
303
|
+
* @static
|
|
304
|
+
* @memberOf _
|
|
305
|
+
* @since 0.1.0
|
|
306
|
+
* @category Function
|
|
307
|
+
* @param {Function} func The function to debounce.
|
|
308
|
+
* @param {number} [wait=0] The number of milliseconds to delay.
|
|
309
|
+
* @param {Object} [options={}] The options object.
|
|
310
|
+
* @param {boolean} [options.leading=false]
|
|
311
|
+
* Specify invoking on the leading edge of the timeout.
|
|
312
|
+
* @param {number} [options.maxWait]
|
|
313
|
+
* The maximum time `func` is allowed to be delayed before it's invoked.
|
|
314
|
+
* @param {boolean} [options.trailing=true]
|
|
315
|
+
* Specify invoking on the trailing edge of the timeout.
|
|
316
|
+
* @returns {Function} Returns the new debounced function.
|
|
317
|
+
* @example
|
|
318
|
+
*
|
|
319
|
+
* // Avoid costly calculations while the window size is in flux.
|
|
320
|
+
* jQuery(window).on('resize', _.debounce(calculateLayout, 150));
|
|
321
|
+
*
|
|
322
|
+
* // Invoke `sendMail` when clicked, debouncing subsequent calls.
|
|
323
|
+
* jQuery(element).on('click', _.debounce(sendMail, 300, {
|
|
324
|
+
* 'leading': true,
|
|
325
|
+
* 'trailing': false
|
|
326
|
+
* }));
|
|
327
|
+
*
|
|
328
|
+
* // Ensure `batchLog` is invoked once after 1 second of debounced calls.
|
|
329
|
+
* var debounced = _.debounce(batchLog, 250, { 'maxWait': 1000 });
|
|
330
|
+
* var source = new EventSource('/stream');
|
|
331
|
+
* jQuery(source).on('message', debounced);
|
|
332
|
+
*
|
|
333
|
+
* // Cancel the trailing debounced invocation.
|
|
334
|
+
* jQuery(window).on('popstate', debounced.cancel);
|
|
335
|
+
*/
|
|
336
|
+
function debounce(func, wait, options) {
|
|
337
|
+
var lastArgs,
|
|
338
|
+
lastThis,
|
|
339
|
+
maxWait,
|
|
340
|
+
result,
|
|
341
|
+
timerId,
|
|
342
|
+
lastCallTime,
|
|
343
|
+
lastInvokeTime = 0,
|
|
344
|
+
leading = false,
|
|
345
|
+
maxing = false,
|
|
346
|
+
trailing = true;
|
|
347
|
+
|
|
348
|
+
if (typeof func != 'function') {
|
|
349
|
+
throw new TypeError(FUNC_ERROR_TEXT);
|
|
350
|
+
}
|
|
351
|
+
wait = toNumber(wait) || 0;
|
|
352
|
+
if (isObject(options)) {
|
|
353
|
+
leading = !!options.leading;
|
|
354
|
+
maxing = 'maxWait' in options;
|
|
355
|
+
maxWait = maxing ? nativeMax(toNumber(options.maxWait) || 0, wait) : maxWait;
|
|
356
|
+
trailing = 'trailing' in options ? !!options.trailing : trailing;
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
function invokeFunc(time) {
|
|
360
|
+
var args = lastArgs,
|
|
361
|
+
thisArg = lastThis;
|
|
362
|
+
|
|
363
|
+
lastArgs = lastThis = undefined;
|
|
364
|
+
lastInvokeTime = time;
|
|
365
|
+
result = func.apply(thisArg, args);
|
|
366
|
+
return result;
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
function leadingEdge(time) {
|
|
370
|
+
// Reset any `maxWait` timer.
|
|
371
|
+
lastInvokeTime = time;
|
|
372
|
+
// Start the timer for the trailing edge.
|
|
373
|
+
timerId = setTimeout(timerExpired, wait);
|
|
374
|
+
// Invoke the leading edge.
|
|
375
|
+
return leading ? invokeFunc(time) : result;
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
function remainingWait(time) {
|
|
379
|
+
var timeSinceLastCall = time - lastCallTime,
|
|
380
|
+
timeSinceLastInvoke = time - lastInvokeTime,
|
|
381
|
+
result = wait - timeSinceLastCall;
|
|
382
|
+
|
|
383
|
+
return maxing ? nativeMin(result, maxWait - timeSinceLastInvoke) : result;
|
|
384
|
+
}
|
|
385
|
+
|
|
386
|
+
function shouldInvoke(time) {
|
|
387
|
+
var timeSinceLastCall = time - lastCallTime,
|
|
388
|
+
timeSinceLastInvoke = time - lastInvokeTime;
|
|
389
|
+
|
|
390
|
+
// Either this is the first call, activity has stopped and we're at the
|
|
391
|
+
// trailing edge, the system time has gone backwards and we're treating
|
|
392
|
+
// it as the trailing edge, or we've hit the `maxWait` limit.
|
|
393
|
+
return (lastCallTime === undefined || (timeSinceLastCall >= wait) ||
|
|
394
|
+
(timeSinceLastCall < 0) || (maxing && timeSinceLastInvoke >= maxWait));
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
function timerExpired() {
|
|
398
|
+
var time = now();
|
|
399
|
+
if (shouldInvoke(time)) {
|
|
400
|
+
return trailingEdge(time);
|
|
401
|
+
}
|
|
402
|
+
// Restart the timer.
|
|
403
|
+
timerId = setTimeout(timerExpired, remainingWait(time));
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
function trailingEdge(time) {
|
|
407
|
+
timerId = undefined;
|
|
408
|
+
|
|
409
|
+
// Only invoke if we have `lastArgs` which means `func` has been
|
|
410
|
+
// debounced at least once.
|
|
411
|
+
if (trailing && lastArgs) {
|
|
412
|
+
return invokeFunc(time);
|
|
413
|
+
}
|
|
414
|
+
lastArgs = lastThis = undefined;
|
|
415
|
+
return result;
|
|
416
|
+
}
|
|
417
|
+
|
|
418
|
+
function cancel() {
|
|
419
|
+
if (timerId !== undefined) {
|
|
420
|
+
clearTimeout(timerId);
|
|
421
|
+
}
|
|
422
|
+
lastInvokeTime = 0;
|
|
423
|
+
lastArgs = lastCallTime = lastThis = timerId = undefined;
|
|
424
|
+
}
|
|
425
|
+
|
|
426
|
+
function flush() {
|
|
427
|
+
return timerId === undefined ? result : trailingEdge(now());
|
|
428
|
+
}
|
|
429
|
+
|
|
430
|
+
function debounced() {
|
|
431
|
+
var time = now(),
|
|
432
|
+
isInvoking = shouldInvoke(time);
|
|
433
|
+
|
|
434
|
+
lastArgs = arguments;
|
|
435
|
+
lastThis = this;
|
|
436
|
+
lastCallTime = time;
|
|
437
|
+
|
|
438
|
+
if (isInvoking) {
|
|
439
|
+
if (timerId === undefined) {
|
|
440
|
+
return leadingEdge(lastCallTime);
|
|
441
|
+
}
|
|
442
|
+
if (maxing) {
|
|
443
|
+
// Handle invocations in a tight loop.
|
|
444
|
+
timerId = setTimeout(timerExpired, wait);
|
|
445
|
+
return invokeFunc(lastCallTime);
|
|
446
|
+
}
|
|
447
|
+
}
|
|
448
|
+
if (timerId === undefined) {
|
|
449
|
+
timerId = setTimeout(timerExpired, wait);
|
|
450
|
+
}
|
|
451
|
+
return result;
|
|
452
|
+
}
|
|
453
|
+
debounced.cancel = cancel;
|
|
454
|
+
debounced.flush = flush;
|
|
455
|
+
return debounced;
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
/*------------------------------------------------------------------------*/
|
|
459
|
+
|
|
460
|
+
/**
|
|
461
|
+
* Checks if `value` is the
|
|
462
|
+
* [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types)
|
|
463
|
+
* of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
|
|
464
|
+
*
|
|
465
|
+
* @static
|
|
466
|
+
* @memberOf _
|
|
467
|
+
* @since 0.1.0
|
|
468
|
+
* @category Lang
|
|
469
|
+
* @param {*} value The value to check.
|
|
470
|
+
* @returns {boolean} Returns `true` if `value` is an object, else `false`.
|
|
471
|
+
* @example
|
|
472
|
+
*
|
|
473
|
+
* _.isObject({});
|
|
474
|
+
* // => true
|
|
475
|
+
*
|
|
476
|
+
* _.isObject([1, 2, 3]);
|
|
477
|
+
* // => true
|
|
478
|
+
*
|
|
479
|
+
* _.isObject(_.noop);
|
|
480
|
+
* // => true
|
|
481
|
+
*
|
|
482
|
+
* _.isObject(null);
|
|
483
|
+
* // => false
|
|
484
|
+
*/
|
|
485
|
+
function isObject(value) {
|
|
486
|
+
var type = typeof value;
|
|
487
|
+
return value != null && (type == 'object' || type == 'function');
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
/**
|
|
491
|
+
* Checks if `value` is object-like. A value is object-like if it's not `null`
|
|
492
|
+
* and has a `typeof` result of "object".
|
|
493
|
+
*
|
|
494
|
+
* @static
|
|
495
|
+
* @memberOf _
|
|
496
|
+
* @since 4.0.0
|
|
497
|
+
* @category Lang
|
|
498
|
+
* @param {*} value The value to check.
|
|
499
|
+
* @returns {boolean} Returns `true` if `value` is object-like, else `false`.
|
|
500
|
+
* @example
|
|
501
|
+
*
|
|
502
|
+
* _.isObjectLike({});
|
|
503
|
+
* // => true
|
|
504
|
+
*
|
|
505
|
+
* _.isObjectLike([1, 2, 3]);
|
|
506
|
+
* // => true
|
|
507
|
+
*
|
|
508
|
+
* _.isObjectLike(_.noop);
|
|
509
|
+
* // => false
|
|
510
|
+
*
|
|
511
|
+
* _.isObjectLike(null);
|
|
512
|
+
* // => false
|
|
513
|
+
*/
|
|
514
|
+
function isObjectLike(value) {
|
|
515
|
+
return value != null && typeof value == 'object';
|
|
516
|
+
}
|
|
517
|
+
|
|
518
|
+
/**
|
|
519
|
+
* Checks if `value` is classified as a `Symbol` primitive or object.
|
|
520
|
+
*
|
|
521
|
+
* @static
|
|
522
|
+
* @memberOf _
|
|
523
|
+
* @since 4.0.0
|
|
524
|
+
* @category Lang
|
|
525
|
+
* @param {*} value The value to check.
|
|
526
|
+
* @returns {boolean} Returns `true` if `value` is a symbol, else `false`.
|
|
527
|
+
* @example
|
|
528
|
+
*
|
|
529
|
+
* _.isSymbol(Symbol.iterator);
|
|
530
|
+
* // => true
|
|
531
|
+
*
|
|
532
|
+
* _.isSymbol('abc');
|
|
533
|
+
* // => false
|
|
534
|
+
*/
|
|
535
|
+
function isSymbol(value) {
|
|
536
|
+
return typeof value == 'symbol' ||
|
|
537
|
+
(isObjectLike(value) && baseGetTag(value) == symbolTag);
|
|
538
|
+
}
|
|
539
|
+
|
|
540
|
+
/**
|
|
541
|
+
* Converts `value` to a number.
|
|
542
|
+
*
|
|
543
|
+
* @static
|
|
544
|
+
* @memberOf _
|
|
545
|
+
* @since 4.0.0
|
|
546
|
+
* @category Lang
|
|
547
|
+
* @param {*} value The value to process.
|
|
548
|
+
* @returns {number} Returns the number.
|
|
549
|
+
* @example
|
|
550
|
+
*
|
|
551
|
+
* _.toNumber(3.2);
|
|
552
|
+
* // => 3.2
|
|
553
|
+
*
|
|
554
|
+
* _.toNumber(Number.MIN_VALUE);
|
|
555
|
+
* // => 5e-324
|
|
556
|
+
*
|
|
557
|
+
* _.toNumber(Infinity);
|
|
558
|
+
* // => Infinity
|
|
559
|
+
*
|
|
560
|
+
* _.toNumber('3.2');
|
|
561
|
+
* // => 3.2
|
|
562
|
+
*/
|
|
563
|
+
function toNumber(value) {
|
|
564
|
+
if (typeof value == 'number') {
|
|
565
|
+
return value;
|
|
566
|
+
}
|
|
567
|
+
if (isSymbol(value)) {
|
|
568
|
+
return NAN;
|
|
569
|
+
}
|
|
570
|
+
if (isObject(value)) {
|
|
571
|
+
var other = typeof value.valueOf == 'function' ? value.valueOf() : value;
|
|
572
|
+
value = isObject(other) ? (other + '') : other;
|
|
573
|
+
}
|
|
574
|
+
if (typeof value != 'string') {
|
|
575
|
+
return value === 0 ? value : +value;
|
|
576
|
+
}
|
|
577
|
+
value = value.replace(reTrim, '');
|
|
578
|
+
var isBinary = reIsBinary.test(value);
|
|
579
|
+
return (isBinary || reIsOctal.test(value))
|
|
580
|
+
? freeParseInt(value.slice(2), isBinary ? 2 : 8)
|
|
581
|
+
: (reIsBadHex.test(value) ? NAN : +value);
|
|
582
|
+
}
|
|
583
|
+
|
|
584
|
+
/*------------------------------------------------------------------------*/
|
|
585
|
+
|
|
586
|
+
// Add methods that return wrapped values in chain sequences.
|
|
587
|
+
lodash.debounce = debounce;
|
|
588
|
+
|
|
589
|
+
/*------------------------------------------------------------------------*/
|
|
590
|
+
|
|
591
|
+
// Add methods that return unwrapped values in chain sequences.
|
|
592
|
+
lodash.isObject = isObject;
|
|
593
|
+
lodash.isObjectLike = isObjectLike;
|
|
594
|
+
lodash.isSymbol = isSymbol;
|
|
595
|
+
lodash.now = now;
|
|
596
|
+
lodash.toNumber = toNumber;
|
|
597
|
+
|
|
598
|
+
/*------------------------------------------------------------------------*/
|
|
599
|
+
|
|
600
|
+
/**
|
|
601
|
+
* The semantic version number.
|
|
602
|
+
*
|
|
603
|
+
* @static
|
|
604
|
+
* @memberOf _
|
|
605
|
+
* @type {string}
|
|
606
|
+
*/
|
|
607
|
+
lodash.VERSION = VERSION;
|
|
608
|
+
|
|
609
|
+
/*--------------------------------------------------------------------------*/
|
|
610
|
+
|
|
611
|
+
// Export to the global object.
|
|
612
|
+
root._ = lodash;
|
|
613
|
+
}.call(this));
|