diff --git a/.eslintrc.js b/.eslintrc.js index e159ae8b..56d763e9 100644 --- a/.eslintrc.js +++ b/.eslintrc.js @@ -22,6 +22,7 @@ module.exports = { ], }, ignorePatterns: [ + 'vendor-src/**/*.*js', 'src/**/javascripts/**/*.js', 'examples/output/javascripts/**/*.js', ], diff --git a/.github/dependabot.yml b/.github/dependabot.yml index da3309c9..097ef389 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -7,3 +7,20 @@ updates: open-pull-requests-limit: 10 reviewers: - newhouse +- package-ecosystem: npm + target-branch: 1.x + directory: "/" + schedule: + interval: weekly + open-pull-requests-limit: 10 + reviewers: + - newhouse +- package-ecosystem: npm + target-branch: rc-2-0-0 + directory: "/" + schedule: + interval: weekly + open-pull-requests-limit: 10 + reviewers: + - newhouse + diff --git a/.github/workflows/lint-and-test.yml b/.github/workflows/lint-and-test.yml index cf2f5b32..80d8f93a 100644 --- a/.github/workflows/lint-and-test.yml +++ b/.github/workflows/lint-and-test.yml @@ -1,42 +1,102 @@ -# This workflow will do a clean install of node dependencies, cache/restore them, build the source code and run tests across different versions of node -# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions - name: CI Lint And Test on: push: branches: [ main ] pull_request: - # Leave out to test branches off of branches - # branches: [ main ] + +env: + NODE_VERSION_MAJOR: 16 + GITHUB_SHA: ${{ github.event.pull_request.head.sha }} + TARBALL_PATH: test/e2e/spectaql.tgz jobs: + + prepare-node: + name: Prepare Node + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v3 + + - name: Use Node.js ${{ env.NODE_VERSION_MAJOR }}.x + uses: actions/setup-node@v3 + with: + node-version: ${{ env.NODE_VERSION_MAJOR }} + cache: 'yarn' + - run: yarn install + lint: name: Lint runs-on: ubuntu-latest + needs: prepare-node + steps: - - uses: actions/checkout@v2 - - name: Use Node.js 16.x - uses: actions/setup-node@v2 + - uses: actions/checkout@v3 + + - name: Use Node.js ${{ env.NODE_VERSION_MAJOR }}.x + uses: actions/setup-node@v3 with: - node-version: 16.x + node-version: ${{ env.NODE_VERSION_MAJOR }} cache: 'yarn' + - run: yarn install - run: yarn lint:quiet - test: - name: Test + build-e2e-package: + name: Build E2E Package + runs-on: ubuntu-latest + needs: prepare-node + + steps: + - uses: actions/checkout@v3 + + - name: Cache Package Build + id: cache-package-build + uses: actions/cache@v3 + with: + # We'll cache this file + path: ${{ env.TARBALL_PATH }} + key: ${{ runner.os }}-node-v${{ env.NODE_VERSION_MAJOR }}-${{ env.GITHUB_SHA }} + + - name: Use Node.js ${{ env.NODE_VERSION_MAJOR }}.x + uses: actions/setup-node@v3 + with: + node-version: ${{ env.NODE_VERSION_MAJOR }} + cache: 'yarn' + + - run: yarn install + - run: yarn test-e2e:build + + unit-test-and-package-test: + name: Unit Test & Package Test runs-on: ubuntu-latest + needs: build-e2e-package strategy: matrix: - node-version: [12.x, 14.x, 16.x] - # See supported Node.js release schedule at https://nodejs.org/en/about/releases/ + node-version: [14, 16, 18] + steps: - - uses: actions/checkout@v2 + - uses: actions/checkout@v3 + + - name: Cache Package Build + id: cache-package-build + uses: actions/cache@v3 + with: + # This is the file to cache / restore + path: ${{ env.TARBALL_PATH }} + key: ${{ runner.os }}-node-v${{ env.NODE_VERSION_MAJOR }}-${{ env.GITHUB_SHA }} + - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v2 + uses: actions/setup-node@v3 with: node-version: ${{ matrix.node-version }} cache: 'yarn' + + # Node 14 ships with a version of NPM that does not work for us + - name: Optionally update NPM if needed + if: ${{ matrix.node-version == '14' }} + run: npm i -g npm@7 + - run: yarn test-e2e:install-and-test - run: yarn install - run: yarn test diff --git a/.gitignore b/.gitignore index 5fffd4bd..a6566739 100644 --- a/.gitignore +++ b/.gitignore @@ -1,10 +1,12 @@ dist/ +vendor/ public node_modules scratch config-local.yml +**/*.tgz **/.DS_STORE **/.DS_Store ~* diff --git a/.nvmrc b/.nvmrc index dae199ae..6f7f377b 100644 --- a/.nvmrc +++ b/.nvmrc @@ -1 +1 @@ -v12 +v16 diff --git a/.prettierignore b/.prettierignore index 7925d9ed..8f2f3c89 100644 --- a/.prettierignore +++ b/.prettierignore @@ -1 +1,3 @@ +vendor/**/*.js +vendor-src/**/*.js src/javascripts diff --git a/CHANGELOG.md b/CHANGELOG.md index 21312e05..a7adf281 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,31 @@ +### 2.0.0 + - BREAKING CHANGE: Drops support for Node 12. Requires Node `>=14` + - BREAKING CHANGE: Requires `npm >= 7` + - BREAKING CHANGE: The `run` and `loadData` commands are now asynchronous and return a promise. + - Fixes bugs and adds better support for various `example` generation scenarios. + - BREAKING CHANGE: `Subscriptions` are now listed under `Operations` alongside `Queries` and `Mutations` in the default theme. + - BREAKING CHANGE: No external fonts are loaded in the included themes, so the `loadExternalFont` option was removed. + - `config` yaml will have environment variable substitution performed. + - `config` yaml can now be specified as a CLI option, instead of only as the first argument. + - Themes written as ESM/`.mjs` modules are now supported. + - BREAKING CHANGE: Accessibility improvements for `` tags deeper than `
` using the `aria-level` attribute. + - `embeddable`, `oneFile` and `targetDir` are now options that can be specified in the config yaml (previously was only CLI). + - `targetDir` can be set to `null` in order to not write any output to a user directory. + - BREAKING CHANGE: `headers` CLI option is now `-H` instead of `-A` + - Moves a number of unmaintained Grunt dependencies "in-house" so that they can be updated for vulnerabilities and bugs. + - BREAKING CHANGE: Dropped support for accidental `queryNameStategy` option. 🤦 + +### 1.5.9 +- Updated dependencies. + +### 1.5.8 +- Add option to disable 3rd party font request in some built-in themes via the `loadExternalFont` option. https://github.com/anvilco/spectaql/pull/556 + +### 1.5.7 +- Default a few deconstructed object params to be an empty object. https://github.com/anvilco/spectaql/pull/553 +- Fix bug where config and SDL files were not being properly watched in some cases. https://github.com/anvilco/spectaql/pull/554 +- Fix bug, now allow anything but `undefined` to be used as an example. https://github.com/anvilco/spectaql/issues/547 + ### 1.5.6 - Re-publish after some reverts diff --git a/README.md b/README.md index b1abd779..c03d0a88 100644 --- a/README.md +++ b/README.md @@ -121,6 +121,8 @@ That config will direct a build that flexes the most interesting parts of Specta To generate your documentation, SpectaQL requires a configuration YAML. This file is where you can specify most of the options to make your output the way you'd like it. All the supported options and their descriptions can be found in the [`config-example.yml`](https://github.com/anvilco/spectaql/blob/master/config-example.yml) file. +Environment variable substitution will be performed, so feel free to use environment variables in your config. + You can also see a minimal-ish working example YAML in the [examples/config.yml](https://github.com/anvilco/spectaql/blob/master/examples/config.yml) file. ## Command Line Options @@ -169,9 +171,23 @@ Here's what you need to know: { key: String!, value: String! } ``` - All the `value` fields should be provided as strings, and they will be appropriately parsed based on the supported value of the `key` field. -- You do not need to add the definition of the `spectaql` directive, nor its `SpectaQLOption` input type. They will be added (and removed) by SpectaQL automatically if you enable the feature. +- SpectaQL does not need you to add the definition of the `spectaql` directive, nor its `SpectaQLOption` input type to your SDL. They will be added (and removed) by SpectaQL automatically if you enable the feature. However, if you are using that same SDL to create an executable schema, you will need to add the directive and options definitions. - The directive can be added to your SDL anywhere that directives are supported by GraphQL SDL syntax, but they may only have an impact on the areas that SpectaQL supports. +The directive-related SDL is: +```sdl +directive @spectaql(options: [SpectaQLOption]) on QUERY | MUTATION | SUBSCRIPTION | FIELD | FRAGMENT_DEFINITION | FRAGMENT_SPREAD | INLINE_FRAGMENT | VARIABLE_DEFINITION | SCHEMA | SCALAR | OBJECT | FIELD_DEFINITION | ARGUMENT_DEFINITION | INTERFACE | UNION | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION +input SpectaQLOption { key: String!, value: String! } +```` + +Or you can generate the required directive SDL programmatically like so: +```node +import { generateSpectaqlSdl } from 'spectaql' + +const spectaqlSdl = generateSpectaqlSdl() +// Do something with this SDL +``` + Once enabled, the directive can be used like so: ```sdl type MyType { diff --git a/babel.config.js b/babel.config.js index bd7784c7..f0c2276f 100644 --- a/babel.config.js +++ b/babel.config.js @@ -15,8 +15,13 @@ module.exports = { // modules: 'commonjs', targets: { // Keep this roughly in-line with our "engines.node" value in package.json - node: '12', + node: '14', }, + exclude: [ + // Node 14+ supports this natively AND we need it to operate natively + // so do NOT transpile it + 'proposal-dynamic-import', + ], }, ], ], diff --git a/bin/build-vendor.mjs b/bin/build-vendor.mjs new file mode 100644 index 00000000..576ee5b1 --- /dev/null +++ b/bin/build-vendor.mjs @@ -0,0 +1,198 @@ +import path from 'path' +import fs from 'fs' +import { readdir } from 'fs/promises' +import { fileURLToPath } from 'url' +import { execSync as exec } from 'child_process' + +const __filename = fileURLToPath(import.meta.url) +const __dirname = path.dirname(__filename) + +export const root = path.join(__dirname, '..') + +const CACHE_FILE_NAME = '.spectaql-cache' +const vendorSrcDir = path.join(root, 'vendor-src') + +if (!pathExists(vendorSrcDir)) { + console.warn(`No vendor-src directory. Not building vendor packages.`) + process.exit() +} +const vendorTargetDir = path.join(root, 'vendor') + +let isDryRun = isDryRunFn() +// isDryRun = true + +ensureDirectory(vendorTargetDir) +;(async function () { + const sourceDirectoryNames = ( + await readdir(vendorSrcDir, { withFileTypes: true }) + ) + .filter((entry) => entry.isDirectory()) + .map((entry) => entry.name) + + for (const sourceDirectoryName of sourceDirectoryNames) { + // Pack the thing.... + const packageName = sourceDirectoryName + const packageDirectory = path.join(vendorTargetDir, packageName) + const sourceDirectory = path.join(vendorSrcDir, sourceDirectoryName) + + // Only set this value if we want/need to write to the FS + let newCacheValue + + const entry = await getOldestFileInDirectoryTs(sourceDirectory) + const calculatedValue = Math.max( + entry.stats.ctime.getTime(), + entry.stats.mtime.getTime() + ).toString() + const existingValue = getCacheValue(sourceDirectory) + if (!pathExists(packageDirectory)) { + // Always write it and always do it if the thing did not exist + newCacheValue = calculatedValue + } else { + if (existingValue === calculatedValue) { + if (!shouldForce()) { + continue + } + } else { + newCacheValue = calculatedValue + } + } + + console.log(`Building managed vendor dependency: ${packageName}`) + + // See if we can skip doing this again + if (pathExists(packageDirectory)) { + const entry = await getOldestFileInDirectoryTs(sourceDirectory) + const calculatedValue = Math.max( + entry.stats.ctime.getTime(), + entry.stats.mtime.getTime() + ).toString() + const existingValue = getCacheValue(sourceDirectory) + if (existingValue === calculatedValue) { + if (!shouldForce()) { + continue + } + } else { + newCacheValue = calculatedValue + } + } + + let options = [`--pack-destination ${vendorTargetDir}`] + + if (isDryRun) { + options.push('--dry-run') + } + + let args = options.join(' ') + let command = `npm pack ${args}` + + let tarballName = await exec(command, { + cwd: path.join(vendorSrcDir, sourceDirectoryName), + stdio: [undefined, undefined, 'ignore'], + }) + + tarballName = getTarballNameFromOutput(tarballName.toString()) + + // Unpack the thing... + const tarballPath = path.join(vendorTargetDir, tarballName) + + ensureDirectory(packageDirectory) + + options = ['--strip-components 1', `-C ${packageDirectory}`, '-xvf'] + + args = options.join(' ') + command = `tar ${args} ${tarballPath}` + + if (isDryRun) { + continue + } + + await exec(command, { stdio: [undefined, undefined, 'ignore'] }) + + // Remove the tarball + await exec(`rm ${tarballPath}`) + + // Only should be set when we should write it to the file system + if (newCacheValue) { + setCacheValue(sourceDirectory, newCacheValue) + } + + console.log('Done.') + } +})() + +function isDryRunFn() { + return process.env.npm_config_dry_run === true +} + +function stripSpecial(str) { + while (['\n', '\t'].includes(str[str.length - 1])) { + str = str.slice(0, -1) + } + return str +} + +function pathExists(pth) { + return fs.existsSync(pth) +} + +function ensureDirectory(pth) { + if (!pathExists(pth)) { + fs.mkdirSync(pth) + } +} + +function getTarballNameFromOutput(str) { + str = stripSpecial(str) + return str.split('\n').pop() +} + +function shouldForce() { + return process.argv.includes('--force') +} + +async function getOldestFileInDirectoryTs(pth) { + const fileStats = await gatherFileStats(pth) + const orderedFileStats = orderFileStats(fileStats) + return orderedFileStats?.[0] +} + +function orderFileStats(fileStats) { + return fileStats.sort((a, b) => b.stats.mtimeMs - a.stats.mtimeMs) +} + +async function gatherFileStats(pth, files = []) { + for (const entry of await readdir(pth, { withFileTypes: true })) { + const entryPath = path.join(pth, entry.name) + if (entry.isDirectory()) { + // Don't go into node_modules + if (entry.name === 'node_modules') { + continue + } + await gatherFileStats(entryPath, files) + } else { + // Don't count our cache file + if (entry.name === CACHE_FILE_NAME) { + continue + } + files.push({ + name: entry.name, + stats: fs.lstatSync(entryPath), + }) + } + } + + return files +} + +function getCacheValue(dir) { + const pth = path.join(dir, CACHE_FILE_NAME) + if (!pathExists(pth)) { + return + } + return fs.readFileSync(pth, 'utf8') +} + +function setCacheValue(dir, value) { + const pth = path.join(dir, CACHE_FILE_NAME) + return fs.writeFileSync(pth, value.toString()) +} diff --git a/config-example.yml b/config-example.yml index 1bb4e9c0..79970f67 100644 --- a/config-example.yml +++ b/config-example.yml @@ -1,7 +1,23 @@ # This config will not run "as-is" and will need to be modified. You can see a minimal working # config in /examples/config.yml +# +# Environment variable substitution will be performed by SpectaQL on all strings encountered spectaql: + # Optional Boolean indicating whether to omit the HTML and generate the documentation content only + # Default: false + embeddable: false + + # Optional Boolean indicating whether to embed all resources (CSS and JS) into the same file + # Default: false + oneFile: false + + # Optional path to the target build directory. + # Set to null to not write the output to the filesystem, making it only available via the API (default: public) + # + # Default: public + targetDir: path/to/output + # Optional path to an image to use as the logo in the top-left of the output logoFile: path/to/logo.png # Optional boolean indicating whether to preserve the filname of the logo provided. diff --git a/dev/README.md b/dev/README.md new file mode 100644 index 00000000..629c2611 --- /dev/null +++ b/dev/README.md @@ -0,0 +1,5 @@ +#### Publishing beta releases: +- `npm version M.m.p-beta.x` +- `npm prepublish` +- `npm publish --tag beta` + diff --git a/dev/build-e2e.mjs b/dev/build-e2e.mjs new file mode 100644 index 00000000..1f9ee870 --- /dev/null +++ b/dev/build-e2e.mjs @@ -0,0 +1,48 @@ +import path from 'path' +import fs from 'fs' +import { readdir } from 'fs/promises' +import {fileURLToPath} from 'url' +import { execSync } from 'child_process' + +import { + root, + isDryRun as isDryRunFn, + getTarballNameFromOutput, + ensureDirectory, +} from './utils.mjs' + + +let isDryRun = isDryRunFn() +// isDryRun = true + +const e2eDir = path.join(root, 'test/e2e') +ensureDirectory(e2eDir) + +// Pack the thing.... +const packageName = 'spectaql' +let options = [ + `--pack-destination ${e2eDir}` +] + +if (isDryRun) { + options.push( + '--dry-run' + ) +} + +let args = options.join(' ') +let command = `npm pack ${args}` + +let tarballName = await execSync( + command, + { + cwd: root, + } +) +tarballName = getTarballNameFromOutput(tarballName.toString()) + +// Rename the thing +const orginalPath = path.join(e2eDir, tarballName) +const newPath = path.join(e2eDir, 'spectaql.tgz') + +await execSync(`mv ${orginalPath} ${newPath}`) diff --git a/dev/echoDirectiveSdl.mjs b/dev/echoDirectiveSdl.mjs new file mode 100644 index 00000000..39821730 --- /dev/null +++ b/dev/echoDirectiveSdl.mjs @@ -0,0 +1,3 @@ +import { generateSpectaqlSdl }from '../dist/index.js' + +console.log(generateSpectaqlSdl()) diff --git a/dev/utils.mjs b/dev/utils.mjs new file mode 100644 index 00000000..254570c5 --- /dev/null +++ b/dev/utils.mjs @@ -0,0 +1,31 @@ +import path from 'path' +import fs from 'fs' +import { fileURLToPath } from 'url' + +const __filename = fileURLToPath(import.meta.url); +const __dirname = path.dirname(__filename); + +export const root = path.join(__dirname, '..') + +export function isDryRun () { + return process.env.npm_config_dry_run === true +} + +export function stripSpecial (str) { + while (['\n', '\t'].includes(str[str.length - 1])) { + str = str.slice(0, -1) + } + return str +} + +export function ensureDirectory (path) { + if (!fs.existsSync(path)){ + fs.mkdirSync(path); + } +} + +export function getTarballNameFromOutput (str) { + str = stripSpecial(str) + return str.split('\n').pop() +} + diff --git a/examples/data/schema.gql b/examples/data/schema.gql index fc018242..16220972 100644 --- a/examples/data/schema.gql +++ b/examples/data/schema.gql @@ -1,10 +1,13 @@ +directive @spectaql(options: [SpectaQLOption]) on QUERY | MUTATION | SUBSCRIPTION | FIELD | FRAGMENT_DEFINITION | FRAGMENT_SPREAD | INLINE_FRAGMENT | VARIABLE_DEFINITION | SCHEMA | SCALAR | OBJECT | FIELD_DEFINITION | ARGUMENT_DEFINITION | INTERFACE | UNION | ENUM | ENUM_VALUE | INPUT_OBJECT | INPUT_FIELD_DEFINITION +input SpectaQLOption { key: String!, value: String! } + "This is a `DateTime` scalar" scalar DateTime "This is a Phone" scalar PhoneNumber -scalar URL +scalar URL @spectaql(options: [{key: "example", value: "https://work.com" }]) scalar JSON scalar JSONObject scalar Void @@ -17,7 +20,7 @@ interface Node { } "`Markdown` and reference interpolation like [`[String!]!`]({{Types.String}}) are supported" -type SimpleTypeOne implements Node { +type SimpleTypeOne implements Node @spectaql(options: [{key: "example", value: "{\"id\": \"123\", \"myType\":[{\"id\": \"myTypeId\", \"name\": \"myTypeName\"}]}" }, {key: "undocumented", value: "false" }]) { id: String! "`Markdown` and reference interpolation like [`[String!]!`]({{Types.String}}) are supported" myType: [MyType!]! diff --git a/examples/themes/deep-nesting-data/README.md b/examples/themes/deep-nesting-data/README.md new file mode 100644 index 00000000..1c8f6007 --- /dev/null +++ b/examples/themes/deep-nesting-data/README.md @@ -0,0 +1 @@ +Will highlight what happens when deep-nesting things to the point where we go beyond `
` and the `aria-leval` attribute will come into play. diff --git a/examples/themes/deep-nesting-data/data.mjs b/examples/themes/deep-nesting-data/data.mjs new file mode 100644 index 00000000..1034fef6 --- /dev/null +++ b/examples/themes/deep-nesting-data/data.mjs @@ -0,0 +1,117 @@ +import _ from 'lodash' + +import { Microfiber as IntrospectionManipulator } from 'microfiber' + +const { get, sortBy } = _ + +export default ({ + introspectionResponse, + graphQLSchema: _graphQLSchema, + allOptions: _allOptions, + introspectionOptions, +}) => { + const introspectionManipulator = new IntrospectionManipulator( + introspectionResponse, + introspectionOptions?.microfiberOptions + ) + const queryType = introspectionManipulator.getQueryType() + const mutationType = introspectionManipulator.getMutationType() + const subscriptionType = introspectionManipulator.getSubscriptionType() + const otherTypes = introspectionManipulator.getAllTypes({ + includeQuery: false, + includeMutation: false, + includeSubscription: false, + }) + + const hasQueries = get(queryType, 'fields.length') + const hasMutations = get(mutationType, 'fields.length') + const hasQueriesOrMutations = hasQueries || hasMutations + const hasSubscriptions = get(subscriptionType, 'fields.length') + const hasOtherTypes = get(otherTypes, 'length') + + return [ + hasQueriesOrMutations + ? { + name: 'Operations', + hideInContent: true, + items: [ + hasQueries + ? { + name: 'Queries Outside', + makeNavSection: true, + makeContentSection: true, + items: [ + { + name: 'Queries Middle Out', + makeNavSection: true, + makeContentSection: true, + items: [ + { + name: 'Queries Middle In', + makeNavSection: true, + makeContentSection: true, + items: [ + { + name: 'Queries Inside', + makeNavSection: true, + makeContentSection: true, + items: sortBy( + queryType.fields.map((query) => ({ + ...query, + isQuery: true, + })), + 'name' + ), + }, + ] + } + ], + }, + ], + } + : null, + hasMutations + ? { + name: 'Mutations', + makeNavSection: true, + makeContentSection: true, + items: sortBy( + mutationType.fields.map((query) => ({ + ...query, + isMutation: true, + })), + 'name' + ), + } + : null, + ], + } + : null, + hasOtherTypes + ? { + name: 'Types', + makeContentSection: true, + items: sortBy( + otherTypes.map((type) => ({ + ...type, + isType: true, + })), + 'name' + ), + } + : null, + hasSubscriptions + ? { + name: 'Subscriptions', + makeContentSection: true, + items: sortBy( + subscriptionType.fields.map((type) => ({ + ...type, + isSubscription: true, + })), + 'name' + ), + } + : null, + ].filter(Boolean) +} diff --git a/examples/themes/my-partial-theme/data/index.js b/examples/themes/my-partial-theme/data/index.js index 4a79ca36..fbfe8321 100644 --- a/examples/themes/my-partial-theme/data/index.js +++ b/examples/themes/my-partial-theme/data/index.js @@ -2,7 +2,6 @@ // MANNER BEFORE A MAJOR RELEASE. // // USE AT YOUR OWN RISK. - const { Microfiber: IntrospectionManipulator } = require('microfiber') function sortByName(a, b) { diff --git a/nodemon.json b/nodemon.json index b2ad0735..51f19c24 100644 --- a/nodemon.json +++ b/nodemon.json @@ -1,11 +1,12 @@ { "delay": 1000, "verbose": true, - "ext": "js,json,yaml,yml,css,scss,hbs,txt,gql,graphql,graphqls", + "ext": "js,mjs,json,yaml,yml,css,scss,hbs,txt,gql,graphql,graphqls", "ignore": [ ".git", - "docs", - "public", - "dist" + "docs/", + "public/", + "vendor/", + "dist/" ] } diff --git a/package.json b/package.json index 73511dd2..5f0098e7 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "spectaql", - "version": "1.5.6", + "version": "2.0.0-beta.3", "description": "A powerful library for autogenerating static GraphQL API documentation", "author": "Anvil Foundry Inc. ", "homepage": "https://github.com/anvilco/spectaql", @@ -23,7 +23,8 @@ "generator" ], "engines": { - "node": ">=12" + "node": ">=14", + "npm": ">=7" }, "main": "index.js", "bin": { @@ -34,27 +35,46 @@ "README.md", "LICENSE.md", "CHANGELOG.md", + "bin/", + "vendor/", "dist/", "examples/", "!**/.DS_STORE", "!**/.DS_Store" ], "scripts": { - "clean": "yarn rimraf ./dist", - "build": "babel src --out-dir ./dist --copy-files", - "build:with-maps": "yarn build --source-maps", - "clean-build": "yarn clean && yarn build", - "prepare": "husky install && yarn clean && yarn build", - "pub:dry-run": "yarn prepare && npm publish --dry-run", - "test": "mocha --config ./test/mocha-config.js", - "test:debug": "yarn test --node-option inspect=0.0.0.0:9223", - "test:watch": "nodemon -x 'yarn clean-build && yarn test'", - "test:debug:watch": "nodemon -x 'yarn clean-build && yarn test:debug'", - "develop": "nodemon -x 'yarn clean-build && node bin/spectaql' -D", + "clean:dist": "yarn rimraf ./dist", + "clean:vendor": "yarn rimraf ./vendor", + "clean": "yarn clean:dist && yarn clean:vendor", + "build:with-maps": "yarn build:src --source-maps", "build:site": "node bin/spectaql", "build:example": "yarn build:site --target-dir ./examples/output ./examples/config.yml", + "build:src": "babel src --out-dir ./dist --copy-files", + "build:vendor": "node bin/build-vendor.mjs", + "build": "yarn build:vendor && yarn build:src", + "clean-build:src": "yarn clean:dist && yarn build:src", + "clean-build:vendor": "yarn clean:vendor && yarn build:vendor", + "clean-build": "yarn clean && yarn build", + "preinstall": "yarn build:vendor", + "prepack": "husky install && yarn clean-build", + "publish:dry-run": "npm pack --dry-run", + "publish:version": "npm version", + "publish:beta": "npm publish --tag beta", + "test": "NODE_ENV=test yarn build:vendor && yarn clean-build:src && NODE_ENV=test yarn mocha --config ./test/mocha-config.js", + "test:watch": "nodemon -x 'yarn test'", + "test:debug": "yarn test --node-option inspect=0.0.0.0:9223", + "test:debug:watch": "nodemon -x 'yarn test:debug'", + "develop": "nodemon -x 'yarn clean-build:src && node bin/spectaql' -- -D", + "develop:deep-nesting": "yarn develop --theme-dir ./examples/themes/deep-nesting-data --config ./examples/config.yml", + "develop:echo-directive-sdl": "yarn node dev/echoDirectiveSdl.mjs", + "test-e2e:build": "yarn clean-build && rm -rf test/e2e/spectaql.tgz && yarn node dev/build-e2e.mjs", + "test-e2e:install": "yarn --cwd test/e2e prep && yarn --cwd test/e2e install", + "test-e2e:test": "yarn --cwd test/e2e test", + "test-e2e:build-and-install": "yarn test-e2e:build && yarn test-e2e:install", + "test-e2e:install-and-test": "yarn test-e2e:install && yarn test-e2e:test", + "test-e2e:all": "yarn test-e2e:build && yarn test-e2e:install && yarn test-e2e:test", "prettify": "prettier 'src/**/*.js' 'bin/**/*.js' 'test/**/*.js'", - "lint": "eslint 'src/**/*.js' 'bin/**/*.js' 'test/**/*.js'", + "lint": "eslint 'src/**/*.*js' 'bin/**/*.*js' 'test/**/*.*js'", "lint:fix": "yarn lint --fix", "lint:quiet": "yarn lint --quiet", "lint:quiet:fix": "yarn lint:quiet --fix", @@ -64,7 +84,6 @@ }, "dependencies": { "@anvilco/apollo-server-plugin-introspection-metadata": "^1.2.0", - "@anvilco/grunt-embed": "^0.0.1", "@graphql-tools/load-files": "^6.3.2", "@graphql-tools/merge": "^8.1.2", "@graphql-tools/schema": "^9.0.1", @@ -72,29 +91,31 @@ "cheerio": "^1.0.0-rc.10", "coffeescript": "^2.6.1", "commander": "^9.1.0", + "fast-glob": "^3.2.12", "foundation-sites": "^6.7.2", + "graceful-fs": "~2.0.2", "graphql": "^16.3.0", "graphql-scalars": "^1.15.0", - "grunt": "^1.4.1", - "grunt-compile-handlebars": "^2.0.2", + "grunt": "^1.5.3", "grunt-contrib-clean": "^2.0.0", "grunt-contrib-concat": "^2.1.0", "grunt-contrib-connect": "^3.0.0", "grunt-contrib-copy": "^1.0.0", "grunt-contrib-cssmin": "^4.0.0", - "grunt-contrib-handlebars": "^3.0.0", "grunt-contrib-uglify": "^5.0.1", "grunt-contrib-watch": "^1.1.0", - "grunt-prettify": "^0.4.0", "grunt-sass": "^3.0.2", - "handlebars": "^4.3.0", + "handlebars": "^4.7.7", "highlight.js": "^11.4.0", + "htmlparser2": "~3.5.0", + "js-beautify": "~1.5.4", "js-yaml": "^4.1.0", "json-stringify-pretty-compact": "^3.0.0", "json5": "^2.2.0", "lodash": "^4.17.12", "marked": "^4.0.12", "microfiber": "^1.3.1", + "postcss": "^7.0.36", "sass": "^1.32.13", "sync-request": "^6.1.0", "tmp": "0.2.1" @@ -107,6 +128,7 @@ "app-module-path": "^2.2.0", "bdd-lazy-var": "^2.6.0", "chai": "^4.3.0", + "chai-as-promised": "^7.1.1", "chai-exclude": "^2.0.2", "eslint": "^8.10.0", "eslint-config-standard": "^16.0.3", @@ -115,12 +137,12 @@ "eslint-plugin-standard": "^5.0.0", "husky": ">=6", "lint-staged": ">=10", - "mocha": "^9.2.1", - "nodemon": "^2.0.15", + "mocha": "^10.1.0", + "nodemon": "^2.0.20", "prettier": "^2.5.1", "rewire": "^6.0.0", "rimraf": "^3.0.2", - "sinon": "^13.0.1", + "sinon": "^14.0.1", "sinon-chai": "^3.7.0" }, "resolutions": { diff --git a/src/cli.js b/src/cli.js index 9153de25..5030050c 100644 --- a/src/cli.js +++ b/src/cli.js @@ -9,11 +9,39 @@ export default function () { program .version(pkg.version) - .usage('[options] ') + .usage('[options] [-c | ]') .description(pkg.description) .option( - '-N, --noop', - 'This option does nothing, but may be useful in complex CLI scenarios to get argument parsing correct' + '-q, --quiet', + 'Silence the output from the generator (default: false)' + ) + .option( + '-c, --config ', + 'Specify the config yaml. Will take precedence over passing via the first argument.' + ) + + .option( + '-t, --target-dir ', + 'the target build directory. Set to "null" to not write the output to the filesystem, making it only available via the API (default: public)', + String + ) + + // This option specifies where the generated documentation HTML files will be output. + .option( + '-f, --target-file ', + 'the target build HTML file (default: index.html)', + String + ) + + // This option lets you build a minimal version of the documentation without the HTML `` tags, so you can embed + // SpectaQL into your own website template. + .option( + '-e, --embeddable', + 'omit the HTML and generate the documentation content only (default: false)' + ) + .option( + '-1, --one-file', + 'Embed all resources (CSS and JS) into the same file (default: false)' ) //************************************** @@ -50,62 +78,6 @@ export default function () { // //************************************** - // This option lets you build a minimal version of the documentation without the HTML `` tags, so you can embed - // SpectaQL into your own website template. - .option( - '-e, --embeddable', - 'omit the HTML and generate the documentation content only (default: false)' - ) - - .option( - '-1, --one-file', - 'Embed all resources (CSS and JS) into the same file (default: false)' - ) - .option( - '-d, --development-mode', - 'start HTTP server with the file watcher (default: false)' - ) - .option( - '-D, --development-mode-live', - 'start HTTP server with the file watcher and live reload (default: false)' - ) - .option( - '-s, --start-server', - 'start the HTTP server without any development features' - ) - .option( - '-p, --port ', - 'the port number for the HTTP server to listen on (default: 4400)', - Number - ) - .option( - '-P, --port-live ', - 'the port number for the live reload to listen on (default: 4401)', - Number - ) - .option( - '-t, --target-dir ', - 'the target build directory (default: public)', - String - ) - - // This option specifies where the generated documentation HTML files will be output. - .option( - '-f, --target-file ', - 'the target build HTML file (default: index.html)', - String - ) - - // This option overrides the default directory which contains all the Handlebars templates, SCSS, and JavaScript - // source files. This option is useful if you've copied the contents of `app` to a remote location or a separate - // repo and customized it. Probably not something you need to use if you have cloned/forked the repo and customized - // it - .option( - '-a, --app-dir ', - 'the application source directory (default: app)', - String - ) - .option( '--logo-file ', 'specify a custom logo file (default: null)', @@ -150,35 +122,68 @@ export default function () { 'specify a JS module that will dynamically generate schema examples (default: none', String ) + .option( - '-g, --grunt-config-file ', - 'specify a custom Grunt configuration file (default: dist/lib/gruntConfig.js)', + '-H, --headers ', + 'specify arbitrary HTTP headers for the Introspection Query as a JSON string (default: none)', String ) - // TODO: remove this option in favor of --headers as part of a breaking change + + .option( + '-d, --development-mode', + 'start HTTP server with the file watcher (default: false)' + ) + .option( + '-D, --development-mode-live', + 'start HTTP server with the file watcher and live reload (default: false)' + ) .option( - '-H, --header
', - 'specify a custom auth token for the header (default: none)' + '-s, --start-server', + 'start the HTTP server without any development features' + ) + .option( + '-p, --port ', + 'the port number for the HTTP server to listen on (default: 4400)', + Number + ) + .option( + '-P, --port-live ', + 'the port number for the live reload to listen on (default: 4401)', + Number + ) + + // This option overrides the default directory which contains all the Handlebars templates, SCSS, and JavaScript + // source files. This option is useful if you've copied the contents of `app` to a remote location or a separate + // repo and customized it. Probably not something you need to use if you have cloned/forked the repo and customized + // it + .option( + '-a, --app-dir ', + 'the application source directory (default: app)', + String ) .option( - '-A, --headers ', - 'specify arbitrary headers for the Introspection Query as a JSON string (default: none)', + '-g, --grunt-config-file ', + 'specify a custom Grunt configuration file (default: dist/lib/gruntConfig.js)', String ) .option( - '-q, --quiet', - 'Silence the output from the generator (default: false)' + '-N, --noop', + 'This option does nothing, but may be useful in complex CLI scenarios to get argument parsing correct' ) - // .option('-f, --spec-file ', 'the input OpenAPI/Swagger spec file (default: test/fixtures/petstore.json)', String, 'test/fixtures/petstore.json') .parse(process.argv) - // Show help if no specfile or options are specified - if (program.args.length < 1) { + const options = program.opts() + + if (options.config) { + // config => specFile + options.specFile = options.config + delete options.config + } else if (program.args.length >= 1) { + options.specFile = program.args[0] + } else { + // Show help if no specfile or options are specified program.help() } - const options = program.opts() - options.specFile = program.args[0] - return options } diff --git a/src/index.js b/src/index.js index 50a32319..ea7e9da5 100644 --- a/src/index.js +++ b/src/index.js @@ -1,6 +1,5 @@ import path from 'path' import _ from 'lodash' -import tmp from 'tmp' import grunt from 'grunt' import pkg from '../package.json' @@ -10,6 +9,7 @@ import { normalizePathFromCwd, pathToRoot, readTextFile, + tmpFolder, writeTextFile, } from './spectaql/utils' @@ -25,9 +25,6 @@ const defaultAppDir = normalizePathFromRoot('dist') let spectaql = require(path.resolve(defaultAppDir, 'spectaql/index')) let gruntConfigFn -// Ensures temporary files are cleaned up on program close, even if errors are encountered. -tmp.setGracefulCleanup() - //********************************************************************* // // These possible "themeDir" values are special and get translated @@ -56,17 +53,15 @@ const defaults = Object.freeze({ gruntConfigFile: normalizePathFromRoot('dist/lib/gruntConfig.js'), themeDir: defaultThemeDir, defaultThemeDir, - cacheDir: tmp.dirSync({ - unsafeCleanup: true, - prefix: 'spectaql-', - }).name, - oneFile: false, + cacheDir: tmpFolder(), specData: {}, }) // Things that may get set from either the CLI or the YAML.spectaql area, but if nothing // is set, then use these: const spectaqlOptionDefaults = Object.freeze({ + oneFile: false, + embeddable: false, errorOnInterpolationReferenceNotFound: true, displayAllServers: false, resolveWithOutput: true, @@ -76,6 +71,7 @@ const spectaqlDirectiveDefault = Object.freeze({ enable: true, directiveName: 'spectaql', optionsTypeName: 'SpectaQLOption', + onlyAddIfMissing: true, }) const introspectionOptionDefaults = Object.freeze({ @@ -283,6 +279,10 @@ export function resolveOptions(cliOptions) { // OK, layer in any defaults that may be set by the CLI and the YAML, but may not have been: opts = _.defaults({}, opts, spectaqlOptionDefaults) + if (!opts.targetDir || opts.targetDir.endsWith('/null')) { + opts.targetDir = tmpFolder() + } + if (opts.logoFile) { // Keep or don't keep the original logoFile name when copying to the target opts.logoFileTargetName = opts.preserveLogoName @@ -312,13 +312,13 @@ export function resolveOptions(cliOptions) { /** * Run SpectaQL and configured tasks **/ -export const run = function (cliOptions = {}) { +export const run = async function (cliOptions = {}) { const opts = resolveOptions(cliOptions) // //= Load the specification and init configuration - const gruntConfig = gruntConfigFn(grunt, opts, loadData(opts)) + const gruntConfig = gruntConfigFn(grunt, opts, await loadData(opts)) // //= Setup Grunt to do the heavy lifting @@ -348,10 +348,14 @@ export const run = function (cliOptions = {}) { grunt.loadNpmTasks('grunt-contrib-clean') grunt.loadNpmTasks('grunt-contrib-copy') grunt.loadNpmTasks('grunt-contrib-connect') - grunt.loadNpmTasks('grunt-compile-handlebars') - grunt.loadNpmTasks('grunt-prettify') grunt.loadNpmTasks('grunt-sass') - grunt.loadNpmTasks('@anvilco/grunt-embed') + + // These are the "local" grunt tasks that we maintain + grunt.loadTasks( + normalizePathFromRoot('vendor/grunt-compile-handlebars/tasks') + ) + grunt.loadTasks(normalizePathFromRoot('vendor/grunt-prettify/tasks')) + grunt.loadTasks(normalizePathFromRoot('vendor/grunt-embed/tasks')) process.chdir(cwd) @@ -421,26 +425,21 @@ export const run = function (cliOptions = {}) { 'prettify', ]) - grunt.registerTask('default', [ - 'clean-things', - 'copy-theme-stuff', - 'stylesheets', - 'javascripts', - 'templates', - ]) + const defaultTasks = [] grunt.registerTask('server', ['connect']) grunt.registerTask('develop', ['server', 'watch']) // Reload template data when watch files change - grunt.event.on('watch', function () { + grunt.event.on('watch', async function () { try { grunt.config.set( 'compile-handlebars.compile.templateData', - loadData(opts) + await loadData(opts) ) } catch (e) { + console.error(e) grunt.fatal(e) } }) @@ -478,13 +477,14 @@ export const run = function (cliOptions = {}) { const copiesToTarget = ['html-to-target'] + let doDevelop = false if (opts.startServer) { - grunt.task.run('server') + defaultTasks.push('server') } else { - grunt.task.run('clean-things') - grunt.task.run('copy-theme-stuff') + defaultTasks.push('clean-things') + defaultTasks.push('copy-theme-stuff') - grunt.task.run('stylesheets') + defaultTasks.push('stylesheets') // If not oneFile/embedding JS/CSS, then we'll need to copy the files if (!opts.oneFile) { @@ -492,7 +492,7 @@ export const run = function (cliOptions = {}) { } if (!opts.disableJs) { - grunt.task.run('javascripts') + defaultTasks.push('javascripts') // If not oneFile/embedding JS/CSS, then we'll need to copy the files if (!opts.oneFile) { @@ -506,16 +506,16 @@ export const run = function (cliOptions = {}) { copiesToTarget.unshift('favicon-to-target') } - grunt.task.run('templates') + defaultTasks.push('templates') // Resolve all the (local) JS and CSS requests and put them into the HTML // file itself if (opts.oneFile) { - grunt.task.run('embed') + defaultTasks.push('embed') } copiesToTarget.forEach((flavor) => { - grunt.task.run(`copy:${flavor}`) + defaultTasks.push(`copy:${flavor}`) }) // Delete the entire cache/temp directory @@ -525,10 +525,18 @@ export const run = function (cliOptions = {}) { // I don't know why, but if you drop into this block and run 'develop' // then the 'embed' task will not run...and vice versa` if (opts.developmentMode || opts.developmentModeLive) { - grunt.task.run('develop') + doDevelop = true } } + grunt.registerTask('default', defaultTasks) + grunt.task.run('default') + + if (doDevelop) { + // This one seems to freeze everything else up, so it should be done last + grunt.task.run('develop') + } + grunt.task.start() return donePromise diff --git a/src/lib/common.js b/src/lib/common.js index e517b117..debecb18 100644 --- a/src/lib/common.js +++ b/src/lib/common.js @@ -9,6 +9,7 @@ import { // hljsFunction as hljsGraphqlLang, } from '../spectaql/graphql-hl' import { analyzeTypeIntrospection } from '../spectaql/type-helpers' +import { isUndef, firstNonUndef } from '../spectaql/utils' import { Microfiber as IntrospectionManipulator } from 'microfiber' import { getExampleForGraphQLScalar } from '../themes/default/helpers/graphql-scalars' @@ -262,7 +263,7 @@ function introspectionArgToVariable({ } // If there is an example, use it. - if (arg.example) { + if (!isUndef(arg.example)) { return arg.example } @@ -367,19 +368,23 @@ function generateIntrospectionReturnTypeExample( { thing, underlyingTypeDefinition, originalType, quoteEnum = false }, otherOptions ) { - let example = - thing.example || - originalType.example || - underlyingTypeDefinition.example || - (underlyingTypeDefinition.kind === 'ENUM' && - underlyingTypeDefinition.enumValues.length && - (quoteEnum - ? addQuoteTags(underlyingTypeDefinition.enumValues[0].name) - : underlyingTypeDefinition.enumValues[0].name)) || - (underlyingTypeDefinition.kind === 'UNION' && - underlyingTypeDefinition.possibleTypes.length && - addSpecialTags(underlyingTypeDefinition.possibleTypes[0].name)) || - getExampleForScalarDefinition(underlyingTypeDefinition, otherOptions) + let example = firstNonUndef([ + thing.example, + originalType.example, + underlyingTypeDefinition.example, + ]) + if (isUndef(example)) { + example = + (underlyingTypeDefinition.kind === 'ENUM' && + underlyingTypeDefinition.enumValues.length && + (quoteEnum + ? addQuoteTags(underlyingTypeDefinition.enumValues[0].name) + : underlyingTypeDefinition.enumValues[0].name)) || + (underlyingTypeDefinition.kind === 'UNION' && + underlyingTypeDefinition.possibleTypes.length && + addSpecialTags(underlyingTypeDefinition.possibleTypes[0].name)) || + getExampleForScalarDefinition(underlyingTypeDefinition, otherOptions) + } if (typeof example !== 'undefined') { // example = unwindTags(example) diff --git a/src/lib/gruntConfig.js b/src/lib/gruntConfig.js index 53dc35f5..1a6e62d0 100644 --- a/src/lib/gruntConfig.js +++ b/src/lib/gruntConfig.js @@ -2,7 +2,22 @@ import path from 'path' import sass from 'sass' // Gotta keep this a commonjs export because of dynamic requiring -module.exports = function (grunt, options, spec) { +module.exports = function (grunt, options, spectaqlData) { + // Watch them schema file(s) + let schemaFiles = options.specData.introspection.schemaFile + if (!schemaFiles) { + schemaFiles = [] + } else if (Array.isArray(schemaFiles)) { + // Copy the Array so that the addition of the specFile does not get passed to + // the graphql schema merger + schemaFiles = [...schemaFiles] + } else { + schemaFiles = [schemaFiles] + } + + // And the spec file + schemaFiles.push(options.specFile) + return { // Compile SCSS source files into the cache directory sass: { @@ -91,7 +106,7 @@ module.exports = function (grunt, options, spec) { dest: options.cacheDir + '/' + options.targetFile, }, ], - templateData: spec, + templateData: spectaqlData, partials: options.cacheDir + '/views/partials/**/*.hbs', helpers: [ // You get all the built-in helpers for free @@ -218,13 +233,16 @@ module.exports = function (grunt, options, spec) { }, templates: { files: [ - options.specFile, options.themeDir + '/views/**/*.hbs', options.themeDir + '/helpers/**/*.js', options.themeDir + '/lib/**/*.js', ], tasks: ['templates'], }, + inputs: { + files: schemaFiles, + tasks: ['default'], + }, }, } } diff --git a/src/lib/interpolation.js b/src/lib/interpolation.js new file mode 100644 index 00000000..efc50a41 --- /dev/null +++ b/src/lib/interpolation.js @@ -0,0 +1,62 @@ +export function substituteEnvOnObject(obj) { + if (obj?.constructor.name !== 'Object') { + return obj + } + + return Object.entries(obj).reduce((acc, [key, value]) => { + acc[substituteEnv(key)] = substituteEnv(value) + return acc + }, {}) +} + +export function substituteEnv(valueIn) { + if (Array.isArray(valueIn)) { + return valueIn.map(substituteEnv) + } + if (valueIn.constructor.name === 'Object') { + return substituteEnvOnObject(valueIn) + } + if (!valueIn || typeof valueIn !== 'string') { + return valueIn + } + + // Quite heavily borrowed from https://github.com/motdotla/dotenv-expand + // which has over 10mm weekly downloads, so this feels solid. + const matches = valueIn.match(/(.?\${*[\w]*(?::-[\w/]*)?}*)/g) || [] + + return matches.reduce((newValue, match, index) => { + const parts = /(.?)\${*([\w]*(?::-[\w/]*)?)?}*/g.exec(match) + if (!parts || parts.length === 0) { + return newValue + } + + const prefix = parts[1] + let value, replacePart + + if (prefix === '\\') { + replacePart = parts[0] + value = replacePart.replace('\\$', '$') + } else { + const keyParts = parts[2].split(':-') + const key = keyParts[0] + const defautValue = keyParts[1] || '' + + replacePart = parts[0].substring(prefix.length) + value = Object.prototype.hasOwnProperty.call(process.env, key) + ? process.env[key] + : defautValue + + // If the value is found, remove nested expansions. + if (keyParts.length > 1 && value) { + const replaceNested = matches[index + 1] + matches[index + 1] = '' + + newValue = newValue.replace(replaceNested, '') + } + // Resolve recursive substitutesions + value = substituteEnv(value) + } + + return newValue.replace(replacePart, value) + }, valueIn) +} diff --git a/src/lib/loadYaml.js b/src/lib/loadYaml.js index 9e586c51..443743c7 100644 --- a/src/lib/loadYaml.js +++ b/src/lib/loadYaml.js @@ -1,7 +1,10 @@ import fs from 'fs' import yaml from 'js-yaml' -export default function (path) { +import { substituteEnvOnObject } from './interpolation' + +export default function loadYaml(path) { const fileContent = fs.readFileSync(path, 'utf8') - return yaml.load(fileContent) + const loadedYaml = yaml.load(fileContent) + return substituteEnvOnObject(loadedYaml) } diff --git a/src/spectaql/augmenters.js b/src/spectaql/augmenters.js index 773ff18a..6b4d32c5 100644 --- a/src/spectaql/augmenters.js +++ b/src/spectaql/augmenters.js @@ -6,6 +6,7 @@ import { typesAreSame, } from 'microfiber' +import { isUndef } from './utils' import { analyzeTypeIntrospection } from './type-helpers' import { addSpecialTags, addQuoteTags } from '../lib/common' import stripTrailing from '../themes/default/helpers/stripTrailing' @@ -305,6 +306,7 @@ export function addExamples(args = {}) { const queryType = introspectionManipulator.getQueryType() const mutationType = introspectionManipulator.getMutationType() + const subscriptionType = introspectionManipulator.getSubscriptionType() for (const type of types) { // Don't mess with reserved GraphQL types at all @@ -312,16 +314,19 @@ export function addExamples(args = {}) { continue } - const isQueryOrMutation = + const isQueryOrMutationOrSubscription = !!(queryType && typesAreSame(type, queryType)) || - !!(mutationType && typesAreSame(type, mutationType)) + !!(mutationType && typesAreSame(type, mutationType)) || + !!(subscriptionType && typesAreSame(type, subscriptionType)) - handleExamples({ type, isType: true }) + if (!isQueryOrMutationOrSubscription) { + handleExamples({ type }) + } for (const field of type.fields || []) { // Don't add examples to fields on the Query or Mutation types...because they are actually // queries or mutations, and we don't support that. - if (!isQueryOrMutation) { + if (!isQueryOrMutationOrSubscription) { handleExamples({ type, field }) } @@ -346,7 +351,6 @@ export function addExamples(args = {}) { function getExistingExample(thing) { let { example, examples } = _.get(thing, metadatasPath, {}) - if (examples && examples.length) { example = examples[Math.floor(Math.random() * examples.length)] } @@ -354,18 +358,18 @@ export function addExamples(args = {}) { return example } - function handleExamples({ type, field, inputField, arg, isType }) { + function handleExamples({ type, field, inputField, arg }) { const thing = arg || inputField || field || type const typeForAnalysis = thing === type ? type : thing.type const typeAnalysis = analyzeTypeIntrospection(typeForAnalysis) let example = getExistingExample(thing) - // Allow Scalars to have examples from the metadata...not 100% sure why not everything - if (!isUndef(example) && (!isType || type.kind === KINDS.SCALAR)) { + if (!isUndef(example)) { thing.example = example } example = processor({ ...typeAnalysis, type, field, arg, inputField }) + if (!isUndef(example)) { thing.example = example } @@ -438,7 +442,3 @@ export function removeTrailingPeriodsFromDescriptions(obj) { return obj } - -function isUndef(item) { - return typeof item === 'undefined' -} diff --git a/src/spectaql/directive.js b/src/spectaql/directive.js index ae12a0ab..ea74fe72 100644 --- a/src/spectaql/directive.js +++ b/src/spectaql/directive.js @@ -39,7 +39,7 @@ const OPTION_TO_CONVERTER_FN = { export function generateSpectaqlSdl({ directiveName = DEFAULT_DIRECTIVE_NAME, optionsTypeName = DEFAULT_DIRECTIVE_OPTION_NAME, -}) { +} = {}) { return ( generateDirectiveSdl({ directiveName, optionsTypeName }) + '\n' + @@ -51,7 +51,7 @@ export function generateSpectaqlSdl({ export function generateDirectiveSdl({ directiveName = DEFAULT_DIRECTIVE_NAME, optionsTypeName = DEFAULT_DIRECTIVE_OPTION_NAME, -}) { +} = {}) { // https://www.apollographql.com/docs/apollo-server/schema/creating-directives/#supported-locations // QUERY | MUTATION | SUBSCRIPTION | FIELD | FRAGMENT_DEFINITION | FRAGMENT_SPREAD | INLINE_FRAGMENT | // VARIABLE_DEFINITION | SCHEMA | SCALAR | OBJECT | FIELD_DEFINITION | ARGUMENT_DEFINITION | INTERFACE | @@ -63,7 +63,7 @@ export function generateDirectiveSdl({ export function generateOptionsSdl({ optionsTypeName = DEFAULT_DIRECTIVE_OPTION_NAME, -}) { +} = {}) { return `input ${optionsTypeName} { key: String!, value: String! }` } @@ -76,11 +76,34 @@ function processDirective(directive) { }, {}) } -export function generateSpectaqlDirectiveSupport( - spectaqlDirectiveOptions = {} -) { +export function generateSpectaqlDirectiveSupport({ + options: spectaqlDirectiveOptions = {}, + userSdl = '', +} = {}) { const directables = [] + const { + onlyAddIfMissing, + directiveName = DEFAULT_DIRECTIVE_NAME, + optionsTypeName = DEFAULT_DIRECTIVE_OPTION_NAME, + } = spectaqlDirectiveOptions + + let { directiveSdl, optionsSdl } = spectaqlDirectiveOptions + + if ( + !directiveSdl && + (!userSdl.includes(`directive @${directiveName}`) || !onlyAddIfMissing) + ) { + directiveSdl = generateSpectaqlSdl(spectaqlDirectiveOptions) + } + + if ( + !optionsSdl && + (!userSdl.includes(`input ${optionsTypeName}`) || !onlyAddIfMissing) + ) { + optionsSdl = generateOptionsSdl(spectaqlDirectiveOptions) + } + function typeHandler(type, schema, mapperKind) { const directive = getDirective(schema, type, 'spectaql')?.[0] if (!isEmpty(directive)) { @@ -155,13 +178,6 @@ export function generateSpectaqlDirectiveSupport( // [MapperKind.DIRECTIVE]: (...args) => configHandler(...args, MapperKind.DIRECTIVE), } - const { - directiveName = DEFAULT_DIRECTIVE_NAME, - directiveSdl = generateSpectaqlSdl(spectaqlDirectiveOptions), - optionsTypeName = DEFAULT_DIRECTIVE_OPTION_NAME, - optionsSdl = generateOptionsSdl(spectaqlDirectiveOptions), - } = spectaqlDirectiveOptions - return { directables, directiveName, diff --git a/src/spectaql/generate-graphql-example-data.js b/src/spectaql/generate-graphql-example-data.js index 1afb1133..40231abb 100644 --- a/src/spectaql/generate-graphql-example-data.js +++ b/src/spectaql/generate-graphql-example-data.js @@ -47,7 +47,6 @@ export function generateQuery({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) { let fieldExpansionDepth = @@ -76,26 +75,20 @@ export function generateQuery({ const cleanedQuery = queryResult.query.replace(/ : [\w![\]]+/g, '') - let consolidatedQueryNameStrategy = queryNameStrategy || queryNameStategy let queryName = field.name - if ( - !consolidatedQueryNameStrategy || - consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_NONE - ) { + if (!queryNameStrategy || queryNameStrategy === QUERY_NAME_STATEGY_NONE) { // no op - } else if ( - consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_CAPITALIZE_FIRST - ) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_CAPITALIZE_FIRST) { queryName = capitalizeFirstLetter(queryName) - } else if (consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_CAPITALIZE) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_CAPITALIZE) { queryName = capitalize(queryName) - } else if (consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_CAMELCASE) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_CAMELCASE) { queryName = camelCase(queryName) - } else if (consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_SNAKECASE) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_SNAKECASE) { queryName = snakeCase(queryName) - } else if (consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_UPPERCASE) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_UPPERCASE) { queryName = upperCase(queryName) - } else if (consolidatedQueryNameStrategy === QUERY_NAME_STATEGY_LOWERCASE) { + } else if (queryNameStrategy === QUERY_NAME_STATEGY_LOWERCASE) { queryName = lowerCase(queryName) } diff --git a/src/spectaql/graphql-loaders.js b/src/spectaql/graphql-loaders.js index befebe1c..cb0f3314 100644 --- a/src/spectaql/graphql-loaders.js +++ b/src/spectaql/graphql-loaders.js @@ -93,11 +93,21 @@ export const loadSchemaFromSDLFile = ({ optionsTypeName, transformer, directables, - } = generateSpectaqlDirectiveSupport(spectaqlDirectiveOptions)) + } = generateSpectaqlDirectiveSupport({ + options: spectaqlDirectiveOptions, + userSdl: printedTypeDefs, + })) } let schema = makeExecutableSchema({ - typeDefs: [directiveSdl, optionsSdl, printedTypeDefs], + typeDefs: [ + directiveSdl, + optionsSdl, + // I assume that these are processed in-order, so it's important to do the user-provided + // SDL *after* the spectaql generated directive-related SDL so that if they've defined + // or overridden things that will take precedence. + printedTypeDefs, + ], }) schema = transformer(schema) diff --git a/src/spectaql/index.js b/src/spectaql/index.js index b439d8d6..3f488f6e 100644 --- a/src/spectaql/index.js +++ b/src/spectaql/index.js @@ -3,21 +3,15 @@ import path from 'path' import buildSchemas from './build-schemas' import { augmentData } from './augmenters' import arrangeDataDefaultFn from '../themes/default/data' -import { fileExists } from './utils' +import { dynamicImport, fileExists, takeDefaultExport } from './utils' import preProcessData from './pre-process' -function run(opts) { +async function run(opts) { const { logo, favicon, specData: spec, themeDir } = opts const { introspection: introspectionOptions, - introspection: { - url: introspectionUrl, - queryNameStrategy, - // Ugh. Typo but gotta leave it now. - // TODO: remove in next Major / breaking release - queryNameStategy, - }, + introspection: { url: introspectionUrl, queryNameStrategy }, extensions = {}, servers = [], info = {}, @@ -55,17 +49,47 @@ function run(opts) { const { introspectionResponse, graphQLSchema } = buildSchemas(opts) // Figure out what data arranger to use...the default one, or the one from the theme - const customDataArrangerExists = ['data/index.js', 'data.js'].some( - (pathSuffix) => { - return fileExists(path.normalize(`${themeDir}/${pathSuffix}`)) + const customDataArrangerSuffixThatExists = [ + 'data/index.js', + 'data/index.mjs', + 'data.js', + 'data.mjs', + ].find((pathSuffix) => { + return fileExists(path.normalize(`${themeDir}/${pathSuffix}`)) + }) + + let arrangeDataModule = arrangeDataDefaultFn + if (customDataArrangerSuffixThatExists) { + try { + arrangeDataModule = await dynamicImport( + path.normalize(`${themeDir}/${customDataArrangerSuffixThatExists}`) + ) + } catch (err) { + console.error(err) + if ( + err instanceof SyntaxError && + err.message.includes('Cannot use import statement outside a module') + ) { + const messages = [ + '***', + 'It appears your theme code is written in ESM but not indicated as such.', + ] + if (!customDataArrangerSuffixThatExists.endsWith('.mjs')) { + messages.push( + 'You can try renaming your file with an "mjs" extension, or seting "type"="module" in your package.json' + ) + } else { + messages.push('Try setting "type"="module" in your package.json') + } + + messages.push('***') + messages.forEach((msg) => console.error(msg)) + } + throw err } - ) - const arrangeDataModule = customDataArrangerExists - ? require(path.normalize(`${themeDir}/data`)) - : arrangeDataDefaultFn - const arrangeData = arrangeDataModule.default - ? arrangeDataModule.default - : arrangeDataModule + } + + const arrangeData = takeDefaultExport(arrangeDataModule) const items = arrangeData({ introspectionResponse, @@ -81,7 +105,6 @@ function run(opts) { graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions: opts, }) diff --git a/src/spectaql/pre-process.js b/src/spectaql/pre-process.js index 1197f017..fbe50920 100644 --- a/src/spectaql/pre-process.js +++ b/src/spectaql/pre-process.js @@ -9,7 +9,6 @@ export default function preProcess({ graphQLSchema, extensions = {}, queryNameStrategy, - queryNameStategy, allOptions, }) { handleItems(items, { @@ -17,7 +16,6 @@ export default function preProcess({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -31,7 +29,6 @@ function handleItems( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, } = {} ) { @@ -47,7 +44,6 @@ function handleItems( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -62,7 +58,6 @@ function handleItem( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, } ) { @@ -90,7 +85,6 @@ function handleItem( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -106,7 +100,6 @@ function handleItem( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } else if (item.isMutation) { @@ -117,7 +110,6 @@ function handleItem( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } else if (item.isSubscription) { @@ -128,13 +120,12 @@ function handleItem( graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } else { // It's a definition anchorPrefix = 'definition' - addDefinitionToItem({ + addThingsToDefinitionItem({ item, introspectionResponse, graphQLSchema, @@ -152,7 +143,6 @@ function addQueryToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) { return _addQueryToItem({ @@ -162,7 +152,6 @@ function addQueryToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -173,7 +162,6 @@ function addMutationToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) { return _addQueryToItem({ @@ -183,7 +171,6 @@ function addMutationToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -194,7 +181,6 @@ function addSubscriptionToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) { return _addQueryToItem({ @@ -204,7 +190,6 @@ function addSubscriptionToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) } @@ -216,7 +201,6 @@ function _addQueryToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) { const stuff = generateQueryExample({ @@ -226,7 +210,6 @@ function _addQueryToItem({ graphQLSchema, extensions, queryNameStrategy, - queryNameStategy, allOptions, }) const { query, variables, response } = stuff @@ -246,17 +229,20 @@ function _addQueryToItem({ } } -function addDefinitionToItem({ +function addThingsToDefinitionItem({ item, introspectionResponse, graphQLSchema, extensions, // allOptions, }) { - item.example = generateIntrospectionTypeExample({ - type: item, - introspectionResponse, - graphQLSchema, - extensions, - }) + // Only if not already present + if (typeof item.example === 'undefined') { + item.example = generateIntrospectionTypeExample({ + type: item, + introspectionResponse, + graphQLSchema, + extensions, + }) + } } diff --git a/src/spectaql/utils.js b/src/spectaql/utils.js index 6be1bd5c..a7e72375 100644 --- a/src/spectaql/utils.js +++ b/src/spectaql/utils.js @@ -1,6 +1,10 @@ import path from 'path' import fs from 'fs' import _ from 'lodash' +import tmp from 'tmp' + +// Ensures temporary files are cleaned up on program close, even if errors are encountered. +tmp.setGracefulCleanup() const cwd = process.cwd() @@ -9,6 +13,35 @@ const numDirsToRoot = 2 export const pathToRoot = path.resolve(__dirname, '../'.repeat(numDirsToRoot)) +export const TMP_PREFIX = 'spectaqltmp-' + +export function tmpFolder(options = {}) { + const { unsafeCleanup = true, prefix = TMP_PREFIX } = options + + return tmp.dirSync({ + unsafeCleanup, + prefix, + }).name +} + +export function takeDefaultExport(mojule) { + return mojule?.default ? mojule.default : mojule +} + +export async function dynamicImport(path) { + const mojule = await import(path) + // Some babelizing oddities result in a nested export structure sometimes, so let's + // normalize that + if ( + mojule.__esModule === true && + mojule.default?.default && + Object.keys(mojule).length === 2 + ) { + return mojule.default + } + return mojule +} + function normalizePathFn(pth, { start = cwd } = {}) { if (!path.isAbsolute(pth)) { pth = path.join(start, pth) @@ -167,3 +200,14 @@ export function upperCase(string) { export function lowerCase(string) { return string.toLowerCase() } + +export function isUndef(thing) { + return typeof thing === 'undefined' +} + +export function firstNonUndef(array) { + if (!Array.isArray(array)) { + return + } + return array.find((item) => !isUndef(item)) +} diff --git a/src/themes/default/data/index.js b/src/themes/default/data/index.js index 4660a04d..d77ffb6b 100644 --- a/src/themes/default/data/index.js +++ b/src/themes/default/data/index.js @@ -61,6 +61,20 @@ export default ({ ), } : null, + hasSubscriptions + ? { + name: 'Subscriptions', + makeNavSection: true, + makeContentSection: true, + items: sortBy( + subscriptionType.fields.map((type) => ({ + ...type, + isSubscription: true, + })), + 'name' + ), + } + : null, ], } : null, @@ -77,18 +91,5 @@ export default ({ ), } : null, - hasSubscriptions - ? { - name: 'Subscriptions', - makeContentSection: true, - items: sortBy( - subscriptionType.fields.map((type) => ({ - ...type, - isSubscription: true, - })), - 'name' - ), - } - : null, ].filter(Boolean) } diff --git a/src/themes/default/helpers/ariaLevel.js b/src/themes/default/helpers/ariaLevel.js new file mode 100644 index 00000000..03532ae5 --- /dev/null +++ b/src/themes/default/helpers/ariaLevel.js @@ -0,0 +1,9 @@ +const LARGEST_HEADING = 6 + +module.exports = function (headingNumber, _options) { + if (!headingNumber || headingNumber <= LARGEST_HEADING) { + return '' + } + + return 'aria-level="' + headingNumber + '"' +} diff --git a/src/themes/default/helpers/itemHeadingTag.js b/src/themes/default/helpers/itemHeadingTag.js new file mode 100644 index 00000000..440f4e04 --- /dev/null +++ b/src/themes/default/helpers/itemHeadingTag.js @@ -0,0 +1,5 @@ +const LARGEST_HEADING = 6 + +module.exports = function (headingNumber, _options) { + return 'h' + Math.min(headingNumber || LARGEST_HEADING, LARGEST_HEADING) +} diff --git a/src/themes/default/helpers/math.js b/src/themes/default/helpers/math.js new file mode 100644 index 00000000..80e84496 --- /dev/null +++ b/src/themes/default/helpers/math.js @@ -0,0 +1,11 @@ +module.exports = function (lvalue, operator, rvalue) { + lvalue = parseFloat(lvalue) + rvalue = parseFloat(rvalue) + return { + '+': lvalue + rvalue, + '-': lvalue - rvalue, + '*': lvalue * rvalue, + '/': lvalue / rvalue, + '%': lvalue % rvalue, + }[operator] +} diff --git a/src/themes/default/javascripts/scroll-spy.js b/src/themes/default/javascripts/scroll-spy.js index 9d0cd6bf..4b249241 100644 --- a/src/themes/default/javascripts/scroll-spy.js +++ b/src/themes/default/javascripts/scroll-spy.js @@ -71,11 +71,6 @@ function scrollSpy() { currentIndex = index var section = sections[index] - var getParentSection = function (el) { - if (!el || !el.closest) return null - return el.closest(EXPANDABLE_SELECTOR) - } - var activeEl = document.querySelector(`.${ACTIVE_CLASS}`) var nextEl = section ? document.querySelector('#nav a[href*=' + section.id + ']') @@ -86,10 +81,10 @@ function scrollSpy() { var isDifferentParent = parentActiveEl !== parentNextEl if (parentActiveEl && isDifferentParent) { - parentActiveEl.classList.remove(EXPAND_CLASS) + toggleSectionExpansion(parentActiveEl, false) } if (parentNextEl && isDifferentParent) { - parentNextEl.classList.add(EXPAND_CLASS) + toggleSectionExpansion(parentNextEl, true) } if (nextEl) { @@ -106,6 +101,19 @@ function scrollSpy() { } }, SCROLL_DEBOUNCE_MS) + function toggleSectionExpansion(element, shouldExpand) { + const classListFunc = shouldExpand ? 'add' : 'remove' + while (element) { + element.classList[classListFunc](EXPAND_CLASS) + element = getParentSection(element.parentNode) + } + } + + function getParentSection(el) { + if (!el || !el.closest) return null + return el.closest(EXPANDABLE_SELECTOR) + } + function getVisibleSectionIndex(scrollPosition) { var positionToCheck = scrollPosition + PADDING for (var i = 0; i < sections.length; i++) { diff --git a/src/themes/default/stylesheets/custom.scss b/src/themes/default/stylesheets/custom.scss index 9b9fe7ef..6b5ffbb3 100644 --- a/src/themes/default/stylesheets/custom.scss +++ b/src/themes/default/stylesheets/custom.scss @@ -47,7 +47,6 @@ // Style variables ////////////////// // -// $font-family: 'Barlow','Open Sans',serif; // $font-family-monospaced: Consolas, Monaco, Andale Mono, Ubuntu Mono, monospace; // $text-color: #222222; // $text-color-subtle: #999999; diff --git a/src/themes/default/stylesheets/main.scss b/src/themes/default/stylesheets/main.scss index 6adb1adb..d8e1f655 100644 --- a/src/themes/default/stylesheets/main.scss +++ b/src/themes/default/stylesheets/main.scss @@ -20,7 +20,7 @@ $size-desktop-large: 64em; // Variables used in this theme ////////////////////// -$font-family: 'Barlow','Open Sans',serif; // See Barlow import below... +$font-family: -apple-system, BlinkMacSystemFont, system-ui, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; $font-family-monospaced: Consolas, Monaco, Andale Mono, Ubuntu Mono, monospace; $text-color: #222222; $text-color-subtle: #999999; @@ -71,8 +71,6 @@ $background-arguments: #fafbfc; @import 'syntax-highlighting'; // Custom font -@import url('https://fonts.googleapis.com/css?family=Barlow:ital,wght@0,400;0,700;1,400;1,700&display=swap'); - // Custom styles ////////////////////// diff --git a/src/themes/default/views/partials/graphql/_description-with-defaults.hbs b/src/themes/default/views/partials/graphql/_description-with-defaults.hbs new file mode 100644 index 00000000..d8f31333 --- /dev/null +++ b/src/themes/default/views/partials/graphql/_description-with-defaults.hbs @@ -0,0 +1,10 @@ +{{ md ( + concat + (interpolateReferences description) + (ternary defaultValue + (concat "Default = " (codify defaultValue)) + "" + ) + joiner=". " filterFalsy=true + ) stripParagraph=true +}} \ No newline at end of file diff --git a/src/themes/default/views/partials/graphql/_query-or-mutation-arguments.hbs b/src/themes/default/views/partials/graphql/_query-or-mutation-arguments.hbs index 1324df11..219a9437 100644 --- a/src/themes/default/views/partials/graphql/_query-or-mutation-arguments.hbs +++ b/src/themes/default/views/partials/graphql/_query-or-mutation-arguments.hbs @@ -18,16 +18,7 @@ {{! The Description column }} - {{ md ( - concat - (interpolateReferences description) - (ternary defaultValue - (concat "Default = " (codify defaultValue)) - "" - ) - joiner=". " filterFalsy=true - ) stripParagraph=true - }} + {{>graphql/_description-with-defaults}} {{/each}} diff --git a/src/themes/default/views/partials/graphql/kinds/_fields.hbs b/src/themes/default/views/partials/graphql/kinds/_fields.hbs index 48cbab45..4494212d 100644 --- a/src/themes/default/views/partials/graphql/kinds/_fields.hbs +++ b/src/themes/default/views/partials/graphql/kinds/_fields.hbs @@ -19,7 +19,7 @@ {{! The Description column }} {{#if description}} - {{md (interpolateReferences description) stripParagraph=true}} + {{>graphql/_description-with-defaults}} {{/if}} {{#if (and deprecationReason (not @root.info.x-hideDeprecationReason))}} {{ md deprecationReason stripParagraph=true }} diff --git a/src/themes/default/views/partials/graphql/kinds/input-object.hbs b/src/themes/default/views/partials/graphql/kinds/input-object.hbs index 62d5e725..94544a61 100644 --- a/src/themes/default/views/partials/graphql/kinds/input-object.hbs +++ b/src/themes/default/views/partials/graphql/kinds/input-object.hbs @@ -25,7 +25,7 @@ {{! The Description column }} {{#if description}} - {{md (interpolateReferences description)}} + {{>graphql/_description-with-defaults}} {{/if}} diff --git a/src/themes/default/views/partials/layout/nav/item.hbs b/src/themes/default/views/partials/layout/nav/item.hbs index 93e64c02..c4928c5d 100644 --- a/src/themes/default/views/partials/layout/nav/item.hbs +++ b/src/themes/default/views/partials/layout/nav/item.hbs @@ -1,13 +1,13 @@ {{#unless hideInNav}} {{#if items}}
-

{{name}}

+ <{{ itemHeadingTag headingNumber }} class="nav-group-title" {{{ ariaLevel headingNumber }}}>{{name}}
    {{#each items}} {{#if makeNavSection}} - {{>layout/nav/section-item}} + {{>layout/nav/section-item headingNumber=(math ../headingNumber "+" 1 )}} {{else}} - {{>layout/nav/item}} + {{>layout/nav/item headingNumber=(math ../headingNumber "+" 1 )}} {{/if}} {{/each}}
diff --git a/src/themes/default/views/partials/layout/nav/main.hbs b/src/themes/default/views/partials/layout/nav/main.hbs index 736099ee..0329c228 100644 --- a/src/themes/default/views/partials/layout/nav/main.hbs +++ b/src/themes/default/views/partials/layout/nav/main.hbs @@ -28,7 +28,7 @@ {{/unless}} {{#if (nempty items)}} {{#each items}} - {{>layout/nav/item}} + {{>layout/nav/item headingNumber=4}} {{/each}} {{/if}} diff --git a/src/themes/default/views/partials/layout/nav/section-item.hbs b/src/themes/default/views/partials/layout/nav/section-item.hbs index fbc51816..e2cd1a81 100644 --- a/src/themes/default/views/partials/layout/nav/section-item.hbs +++ b/src/themes/default/views/partials/layout/nav/section-item.hbs @@ -1,11 +1,11 @@ {{#unless hideInNav}}
  • -
    + <{{ itemHeadingTag headingNumber }} class="nav-group-section-title" {{{ ariaLevel headingNumber }}}> {{name}} -
    +
      {{#each items}} - {{>layout/nav/item}} + {{>layout/nav/item headingNumber=(math ../headingNumber "+" 1 )}} {{/each}}
    • diff --git a/src/themes/spectaql/stylesheets/main.scss b/src/themes/spectaql/stylesheets/main.scss index 1f8ece44..4ddab094 100644 --- a/src/themes/spectaql/stylesheets/main.scss +++ b/src/themes/spectaql/stylesheets/main.scss @@ -81,8 +81,6 @@ $background-sidebar: $background-subtle; @import 'syntax-highlighting'; // Custom font -@import url('https://fonts.googleapis.com/css?family=Barlow:ital,wght@0,400;0,700;1,400;1,700&display=swap'); - // Custom styles ////////////////////// diff --git a/test/e2e/.gitignore b/test/e2e/.gitignore new file mode 100644 index 00000000..5ebada87 --- /dev/null +++ b/test/e2e/.gitignore @@ -0,0 +1,4 @@ +*.tgz +node_modules +yarn.lock +package-lock.json diff --git a/test/e2e/README.md b/test/e2e/README.md new file mode 100644 index 00000000..6a467a64 --- /dev/null +++ b/test/e2e/README.md @@ -0,0 +1,3 @@ +This is just a folder where we'll simulate installing the built package as a dependency and making sure it runs on every Node engine we support. + +The `lint-and-test.yml` will package things up and put it here. \ No newline at end of file diff --git a/test/e2e/alive.mjs b/test/e2e/alive.mjs new file mode 100644 index 00000000..565c8387 --- /dev/null +++ b/test/e2e/alive.mjs @@ -0,0 +1,104 @@ +import { strict as assert } from 'node:assert' +import { + run, + parseCliOptions, + resolveOptions as resolveOptionsFunction, + loadData, + buildSchemas, + augmentData, + generateSpectaqlSdl, + generateDirectiveSdl, + generateOptionsSdl, +} from 'spectaql' + +import { TMP_PREFIX } from 'spectaql/dist/spectaql/utils.js' + +console.warn('Trying on Node ' + process.version) + +assert(typeof run === 'function') + +const cliOptions = parseCliOptions() +assert.deepEqual(cliOptions, { + specFile: './config.yml', +}) + +let options = { + ...cliOptions, + themeDir: './custom-theme', +} + +let resolvedOptions = resolveOptionsFunction(options) +assert(resolvedOptions.targetDir.endsWith('/public')) +;(async function () { + let result = run(resolvedOptions) + assert(result instanceof Promise) + + let { html } = await result + + assert(typeof html === 'string') + + assert(html.includes('Operationzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz')) + + result = loadData(resolvedOptions) + assert(result instanceof Promise) + + let data = await result + assert(Array.isArray(data.items)) + assert(data.items.length === 2) + assert.equal(data.items[0].name, 'Operationzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz') + + result = generateSpectaqlSdl() + assert( + result.includes('directive @spectaql(options: [SpectaQLOption]) on QUERY') + ) + assert( + result.includes('input SpectaQLOption { key: String!, value: String! }') + ) + + result = generateDirectiveSdl() + assert( + result.includes('directive @spectaql(options: [SpectaQLOption]) on QUERY') + ) + + result = generateOptionsSdl() + assert( + result.includes('input SpectaQLOption { key: String!, value: String! }') + ) + + result = buildSchemas(resolvedOptions) + const { graphQLSchema, introspectionResponse } = result + + assert.equal(graphQLSchema.constructor.name, 'GraphQLSchema') + + assert(Array.isArray(introspectionResponse.__schema.types)) + + result = augmentData({ + introspectionResponse, + introspectionOptions: { + ...resolvedOptions.specData.introspection, + }, + }) + + assert(Array.isArray(result.__schema.types)) + + // Try it with some different options + options = { + ...resolvedOptions, + } + options.targetDir = null + + resolvedOptions = resolveOptionsFunction(options) + // A tmp directory + assert(resolvedOptions.targetDir.split('/').pop().startsWith(TMP_PREFIX)) + + result = run(resolvedOptions) + assert(result instanceof Promise) + ;({ html } = await result) + + assert(typeof html === 'string') + + console.log('I worked!') +})().catch((err) => { + console.error(err) + process.exit(1) +}) diff --git a/test/e2e/config.yml b/test/e2e/config.yml new file mode 100644 index 00000000..a7b6af4c --- /dev/null +++ b/test/e2e/config.yml @@ -0,0 +1,44 @@ +spectaql: + logoFile: ../fixtures/logo.png + faviconFile: ../fixtures/favicon.png + displayAllServers: true + +introspection: + removeTrailingPeriodFromDescriptions: false + schemaFile: ../../examples/data/schema.gql + metadataFile: ../../examples/data/metadata.json + dynamicExamplesProcessingModule: ../../examples/customizations/examples + queryNameStrategy: capitalizeFirst + fieldExpansionDepth: 2 + + spectaqlDirective: + enable: true + +extensions: + graphqlScalarExamples: true + +info: + title: GraphQL API Reference + description: Welcome to the party! + termsOfService: https://www.example.com/terms + contact: + name: API Support + url: http://www.example.com/support + email: support@example.com + license: + name: Apache 2.0 + url: https://www.apache.org/licenses/LICENSE-2.0.html + x-introItems: + - title: Important thing 1 + description: Some important stuff we wanted you to know. Supports `markdown` + +servers: + - url: https://staging.example.com/graphql + description: Staging + - url: https://example.com/graphql + description: Production + production: true + headers: + - name: Authorization + example: Bearer + comment: Your foo from bar diff --git a/test/e2e/custom-theme/data/index.mjs b/test/e2e/custom-theme/data/index.mjs new file mode 100644 index 00000000..6bd528c8 --- /dev/null +++ b/test/e2e/custom-theme/data/index.mjs @@ -0,0 +1,102 @@ +// THIS IS AN EXPERIMENTAL API AND IT COULD CHANGE AT ANY TIME IN A BREAKING +// MANNER BEFORE A MAJOR RELEASE. +// +// USE AT YOUR OWN RISK. +import { + Microfiber as IntrospectionManipulator, +} from 'microfiber' + +function sortByName(a, b) { + if (a.name > b.name) { + return 1 + } + if (a.name < b.name) { + return -1 + } + + return 0 +} + +export default ({ + // The Introspection Query Response after all the augmentation and metadata directives + // have been applied to it + introspectionResponse, + // All the options that are specifically for the introspection related behaviors, such a this area. + introspectionOptions, + // A GraphQLSchema instance that was constructed from the provided introspectionResponse + graphQLSchema: _graphQLSchema, + // All of the SpectaQL options in case you need them for something. + allOptions: _allOptions, +}) => { + const introspectionManipulator = new IntrospectionManipulator( + introspectionResponse, + // microfiberOptions come from converting some of the introspection options to a corresponding + // option for microfiber via the `src/index.js:introspectionOptionsToMicrofiberOptions()` function + introspectionOptions?.microfiberOptions, + ) + + const queryType = introspectionManipulator.getQueryType() + const normalTypes = introspectionManipulator.getAllTypes({ + includeQuery: false, + includeMutation: false, + includeSubscription: false, + }) + + // This is a contrived example that shows how you can generate your own simple or nested set + // of data and items to create the output you want for SpectaQL. This example will only + // output the Queries in a sub-heading called "Queries" under an outer heading called "Operations", + // and then all the "normal" Types in the schema under a heading called "Types". + // + // What should be noted is that you can nest things (more than once) for ultimate + // control over what data you display, and in what arrangement. Yay! + return [ + // The idea is to return an Array of Objects with the following structure: + { + // The name for this group of items wherever it will be displayed + name: 'Operationzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz', + // Should this item be hidden in the Navigation area? + hideInNav: false, + // Should this item be its own Navigation section and create a collapse? + // Probably not at the top-level like this. + makeNavSection: false, + // Should this item be hidden in the main Content area? + hideInContent: true, + // Should this item be its own Content area section and have an

    tag? + // Probably not at the top-level like this. + makeContentSection: false, + items: [ + { + name: 'Queries', + makeNavSection: true, + makeContentSection: true, + items: queryType.fields + .map((query) => ({ + ...query, + // What is this thing? Pick one: + // + // Is this item a Query? + isQuery: true, + // Is this item a Mutation? + isMutation: false, + // Is this item a Subscription? + isSubscription: false, + // Is this item a Type? + isType: false, + })) + .sort(sortByName), + }, + // Just Queries...gonna leave out Mutations just to prove the point. + ], + }, + { + name: 'Types', + makeContentSection: true, + items: normalTypes + .map((type) => ({ + ...type, + isType: true, + })) + .sort(sortByName), + }, + ].filter(Boolean) +} diff --git a/test/e2e/custom-theme/helpers/dumb.js b/test/e2e/custom-theme/helpers/dumb.js new file mode 100644 index 00000000..3cb442cc --- /dev/null +++ b/test/e2e/custom-theme/helpers/dumb.js @@ -0,0 +1,3 @@ +module.exports = function (_value, _options) { + return 'This is pretty dumb' +} diff --git a/test/e2e/custom-theme/javascripts/hello.js b/test/e2e/custom-theme/javascripts/hello.js new file mode 100644 index 00000000..1bbc1bdf --- /dev/null +++ b/test/e2e/custom-theme/javascripts/hello.js @@ -0,0 +1 @@ +console.log('Hello, World!') diff --git a/test/e2e/custom-theme/stylesheets/custom.css b/test/e2e/custom-theme/stylesheets/custom.css new file mode 100644 index 00000000..730298e9 --- /dev/null +++ b/test/e2e/custom-theme/stylesheets/custom.css @@ -0,0 +1,4 @@ +/* Make some things blue! */ +#spectaql .doc-row .doc-copy code { + background-color: blue; +} diff --git a/test/e2e/custom-theme/views/partials/graphql/query.hbs b/test/e2e/custom-theme/views/partials/graphql/query.hbs new file mode 100644 index 00000000..5a087a64 --- /dev/null +++ b/test/e2e/custom-theme/views/partials/graphql/query.hbs @@ -0,0 +1 @@ +{{ dumb }}, but Query!
    \ No newline at end of file diff --git a/test/e2e/package.json b/test/e2e/package.json new file mode 100644 index 00000000..1493832d --- /dev/null +++ b/test/e2e/package.json @@ -0,0 +1,18 @@ +{ + "name": "e2e", + "version": "1.0.0", + "description": "e2e tester", + "main": "index.js", + "scripts": { + "prep": "yarn clean-cache && yarn remove-files", + "remove-files": "rm -rf yarn.lock node_modules/spectaql", + "clean-cache": "rm -rf $(yarn cache dir)/.tmp", + "test": "yarn node alive.mjs ./config.yml" + }, + "author": "", + "license": "ISC", + "dependencies": { + "microfiber": "latest", + "spectaql": "file:spectaql.tgz" + } +} diff --git a/test/helpers.js b/test/helpers.js index e67d9699..08bf832d 100644 --- a/test/helpers.js +++ b/test/helpers.js @@ -29,6 +29,11 @@ const pathToNonStandardQueryMutationSchema = path.resolve( './fixtures/non-standard-query-mutation-schema.gql' ) +const pathToExampleTheme = path.resolve( + __dirname, + '../examples/themes/my-partial-theme' +) + const generateIntrospectionQueryResult = ({ schemaType = 'simple' }) => { switch (schemaType) { case 'non-standard-query-mutation-schema': { @@ -55,5 +60,6 @@ module.exports = { pathToSimpleSchemaWithDirectives, pathToSimpleSchemaSupplement, pathToComplexSchema, + pathToExampleTheme, pathToNonStandardQueryMutationSchema, } diff --git a/test/mocha-environment.js b/test/mocha-environment.js index 129c2911..6104a5f1 100644 --- a/test/mocha-environment.js +++ b/test/mocha-environment.js @@ -1,15 +1,16 @@ const path = require('path') const appModulePath = require('app-module-path') +// Allow for imports starting from the project root +appModulePath.addPath(path.join(__dirname, '..')) const sinon = require('sinon') const sinonChai = require('sinon-chai') const chai = require('chai') const chaiExclude = require('chai-exclude') - -// Allow for imports starting from the project root -appModulePath.addPath(path.join(__dirname, '..')) +const chaiAsPromised = require('chai-as-promised') chai.use(sinonChai) chai.use(chaiExclude) +chai.use(chaiAsPromised) global.chai = chai global.expect = chai.expect diff --git a/test/src/helpers/generateApiEndpoints.test.js b/test/src/helpers/generateApiEndpoints.test.js index 3892d6cd..44361281 100644 --- a/test/src/helpers/generateApiEndpoints.test.js +++ b/test/src/helpers/generateApiEndpoints.test.js @@ -1,4 +1,4 @@ -const generateApiEndpoints = require('../../../dist/themes/default/helpers/generateApiEndpoints') +import generateApiEndpoints from 'dist/themes/default/helpers/generateApiEndpoints' describe('generateApiEndpoints', function () { def('displayAllServers', false) diff --git a/test/src/helpers/interpolateReferences.test.js b/test/src/helpers/interpolateReferences.test.js index ab5ccf4d..b969c1ef 100644 --- a/test/src/helpers/interpolateReferences.test.js +++ b/test/src/helpers/interpolateReferences.test.js @@ -1,4 +1,4 @@ -const interpolateReferences = require('../../../dist/themes/default/helpers/interpolateReferences') +import interpolateReferences from 'dist/themes/default/helpers/interpolateReferences' describe('interpolateReferences', function () { beforeEach(function () { diff --git a/test/src/index.test.js b/test/src/index.test.js index 1b9ec0e6..ed694c07 100644 --- a/test/src/index.test.js +++ b/test/src/index.test.js @@ -1,4 +1,5 @@ import * as loadYaml from 'dist/lib/loadYaml' +import { TMP_PREFIX } from 'dist/spectaql/utils' const rewire = require('rewire') const index = rewire('dist/index') @@ -14,14 +15,15 @@ describe('index', function () { const resolveOptions = index.__get__('resolveOptions') const options = resolveOptions($.options) - expect(options.oneFile).to.be.false - expect(options).to.include({ targetFile: 'index.html', + embeddable: false, oneFile: false, resolveWithOutput: true, }) + expect(options.targetDir.endsWith('/public')).to.be.true + expect(options.specData.introspection).to.include({ removeTrailingPeriodFromDescriptions: false, @@ -56,9 +58,6 @@ describe('index', function () { context('config yaml specifies some options', function () { beforeEach(function () { sinon.stub(loadYaml, 'default').callsFake(() => $.config) - // revert = index.__set__({ - // loadYaml: () => $.config, - // }) }) def('_options', () => ({ @@ -69,7 +68,9 @@ describe('index', function () { def('config', () => ({ spectaql: { + embeddable: true, oneFile: true, + targetDir: null, themeDir: './my-custom-theme', resolveWithOutput: false, }, @@ -88,9 +89,18 @@ describe('index', function () { const resolveOptions = index.__get__('resolveOptions') const options = resolveOptions($.options) - expect(options.oneFile).to.be.true + expect(options).to.include({ + embeddable: true, + oneFile: true, + resolveWithOutput: false, + }) + + // A temp dir + expect( + options.targetDir.split('/').pop().startsWith(TMP_PREFIX) + ).to.be.true expect(options.themeDir.endsWith('my-custom-theme')).to.be.true - expect(options.resolveWithOutput).to.be.false + // Not a path expect(options.specData.introspection.url).to.eql( 'http://mysite.com/graphql' @@ -106,7 +116,9 @@ describe('index', function () { context('CLI specifies some options', function () { def('options', () => ({ ...$._options, + embeddable: false, oneFile: false, + targetDir: 'null', themeDir: './my-custom-theme-yo-yo', })) @@ -114,7 +126,15 @@ describe('index', function () { const resolveOptions = index.__get__('resolveOptions') const options = resolveOptions($.options) - expect(options.oneFile).to.be.false + expect(options).to.include({ + embeddable: false, + oneFile: false, + }) + + // A temp dir + expect( + options.targetDir.split('/').pop().startsWith(TMP_PREFIX) + ).to.be.true expect(options.themeDir.endsWith('my-custom-theme-yo-yo')).to.be.true }) }) diff --git a/test/src/lib/common.test.js b/test/src/lib/common.test.js index 822c1529..ce236b48 100644 --- a/test/src/lib/common.test.js +++ b/test/src/lib/common.test.js @@ -1,6 +1,6 @@ const rewire = require('rewire') -const common = rewire('../../../dist/lib/common') +const common = rewire('dist/lib/common') describe('common', function () { let SPECIAL_TAG diff --git a/test/src/lib/interpolate.test.js b/test/src/lib/interpolate.test.js new file mode 100644 index 00000000..cf65d6f5 --- /dev/null +++ b/test/src/lib/interpolate.test.js @@ -0,0 +1,98 @@ +import * as interpolation from 'dist/lib/interpolation' + +const TEST_ENV_PREFIX = 'spectaqltest' + +describe('interpolation', function () { + describe('substituteEnvOnObject', function () { + beforeEach(function () { + const env = $.env + for (const [key, value] of Object.entries(env)) { + process.env[`${TEST_ENV_PREFIX}_${key}`] = value + } + }) + + afterEach(function () { + const env = $.env + for (const key of Object.keys(env)) { + delete process.env[`${TEST_ENV_PREFIX}_${key}`] + } + }) + + def('env', () => ({ + SOME_VAR: 'it worked', + })) + + it('substitutes things from the environment', function () { + function generateNormal() { + return { + normalString: 'one', + normalArray: ['one', 1], + normalObject: { + nestedNormalString: 'one', + nestedNormalArray: ['one', 1], + }, + } + } + const obj = { + ...generateNormal(), + substituteString: '${spectaqltest_SOME_VAR}', + substituteArray: ['one', '${spectaqltest_SOME_VAR}'], + substituteObject: { + ...generateNormal(), + substituteString: '${spectaqltest_SOME_VAR}', + substituteArray: ['one', '${spectaqltest_SOME_VAR}'], + }, + substituteStringDefault: + '${spectaqltest_SOME_NON_EXISTENT_VAR:-defaulted}', + substituteArrayDefault: [ + 'one', + '${spectaqltest_SOME_NON_EXISTENT_VAR:-defaulted}', + ], + substituteObjectDefault: { + ...generateNormal(), + substituteStringDefault: + '${spectaqltest_SOME_NON_EXISTENT_VAR:-defaulted}', + substituteArrayDefault: [ + 'one', + '${spectaqltest_SOME_NON_EXISTENT_VAR:-defaulted}', + ], + }, + } + + const substitutedObject = interpolation.substituteEnvOnObject(obj) + + expect(substitutedObject).to.deep.equal({ + normalString: 'one', + normalArray: ['one', 1], + normalObject: { + nestedNormalString: 'one', + nestedNormalArray: ['one', 1], + }, + substituteString: 'it worked', + substituteArray: ['one', 'it worked'], + substituteObject: { + normalString: 'one', + normalArray: ['one', 1], + normalObject: { + nestedNormalString: 'one', + nestedNormalArray: ['one', 1], + }, + substituteString: 'it worked', + substituteArray: ['one', 'it worked'], + }, + substituteStringDefault: 'defaulted', + substituteArrayDefault: ['one', 'defaulted'], + substituteObjectDefault: { + normalString: 'one', + normalArray: ['one', 1], + normalObject: { + nestedNormalString: 'one', + nestedNormalArray: ['one', 1], + }, + substituteStringDefault: 'defaulted', + substituteArrayDefault: ['one', 'defaulted'], + }, + }) + }) + }) +}) diff --git a/test/src/spectaql/augmenters.test.js b/test/src/spectaql/augmenters.test.js index b50e7568..9f45d7c5 100644 --- a/test/src/spectaql/augmenters.test.js +++ b/test/src/spectaql/augmenters.test.js @@ -1,20 +1,20 @@ -const _ = require('lodash') +import _ from 'lodash' -const { +import { introspectionResponseFromSchemaSDL, graphQLSchemaFromIntrospectionResponse, -} = require('dist/spectaql/graphql-loaders') +} from 'dist/spectaql/graphql-loaders' -const { introspectionOptionsToMicrofiberOptions } = require('dist') -const { addMetadata } = require('dist/spectaql/metadata-loaders') +import { introspectionOptionsToMicrofiberOptions } from 'dist' +import { addMetadata } from 'dist/spectaql/metadata-loaders' -const { +import { createIntrospectionManipulator, hideThingsBasedOnMetadata, addExamples, // addExamplesFromMetadata, // addExamplesDynamically, -} = require('dist/spectaql/augmenters') +} from 'dist/spectaql/augmenters' import { KINDS } from 'microfiber' @@ -66,6 +66,11 @@ describe('augmenters', function () { myOtherMutation: MyType } + type Subscription { + mySubscription(input: ID): MyType + myOtherSubscription: MyType + } + input MyInput { inputOne: String inputTwo: Int @@ -122,6 +127,11 @@ describe('augmenters', function () { def('mutationArgDocumentedDefault', true) def('hideMutationsWithUndocumentedReturnType', true) + def('subscriptionsDocumentedDefault', true) + def('subscriptionDocumentedDefault', true) + def('subscriptionArgDocumentedDefault', true) + def('hideSubscriptionsWithUndocumentedReturnType', true) + def('introspectionOptionsBase', () => { const base = { metadata: $.doMetadata, @@ -160,6 +170,12 @@ describe('augmenters', function () { mutationArgDocumentedDefault: $.mutationArgDocumentedDefault, hideMutationsWithUndocumentedReturnType: $.hideMutationsWithUndocumentedReturnType, + + subscriptionsDocumentedDefault: $.subscriptionsDocumentedDefault, + subscriptionDocumentedDefault: $.subscriptionDocumentedDefault, + subscriptionArgDocumentedDefault: $.subscriptionArgDocumentedDefault, + hideSubscriptionsWithUndocumentedReturnType: + $.hideSubscriptionsWithUndocumentedReturnType, } base.microfiberOptions = introspectionOptionsToMicrofiberOptions(base) @@ -554,7 +570,7 @@ describe('augmenters', function () { }) }) - describe('Queries and Mutations', function () { + describe('Queries, Mutations and Subscriptions', function () { afterEach(() => { // Make sure it does not mess up Types expect($.introspectionManipulator.getAllTypes({})) @@ -573,13 +589,21 @@ describe('augmenters', function () { expect( $.introspectionManipulator.getMutation({ name: 'myOtherMutation' }) ).to.be.ok + expect( + $.introspectionManipulator.getSubscription({ name: 'mySubscription' }) + ).to.be.ok }) // Tests for top-level "should we document this at all" options ;[ - ['queriesDocumentedDefault', 'Query', 'Mutation'], - ['mutationsDocumentedDefault', 'Mutation', 'Query'], - ].forEach(([option, thing, otherThing]) => { + ['queriesDocumentedDefault', 'Query', ['Mutation', 'Subscription']], + ['mutationsDocumentedDefault', 'Mutation', ['Query', 'Subscription']], + [ + 'subscriptionsDocumentedDefault', + 'Subscription', + ['Query', 'Mutation'], + ], + ].forEach(([option, thing, otherThings]) => { context(`${option} is false`, function () { def(option, false) @@ -589,9 +613,10 @@ describe('augmenters', function () { expect(response).to.not.eql(responseBefore) expect($.introspectionManipulator[`get${thing}Type`]()).to.not.be.ok - expect( - $.introspectionManipulator[`get${otherThing}Type`]() - ).to.be.ok + for (const otherThing of otherThings) { + expect($.introspectionManipulator[`get${otherThing}Type`]()).to.be + .ok + } }) }) }) @@ -601,29 +626,40 @@ describe('augmenters', function () { [ 'queryDocumentedDefault', 'Query', - 'Mutation', + ['Mutation', 'Subscription'], 'myOtherQuery', - 'myMutation', + ['myMutation', 'mySubscription'], ], [ 'mutationDocumentedDefault', 'Mutation', - 'Query', + ['Query', 'Subscription'], 'myOtherMutation', - 'myQuery', + ['myQuery', 'mySubscription'], + ], + [ + 'subscriptionDocumentedDefault', + 'Subscription', + ['Query', 'Mutation'], + 'myOtherSubscription', + ['myQuery', 'myMutation'], ], ].forEach( - ([option, thing, otherThing, exceptionName, otherThingTest]) => { + ([option, thing, otherThings, exceptionName, otherThingsTest]) => { context(`${option} is false`, function () { def(option, false) afterEach(() => { - // Make sure that at least 1 thing from the other thing is OK - expect( - $.introspectionManipulator[`get${otherThing}`]({ - name: otherThingTest, - }) - ).to.be.ok + for (let i = 0; i < otherThings.length; i++) { + const otherThing = otherThings[i] + const otherThingTest = otherThingsTest[i] + // Make sure that at least 1 thing from the other thing is OK + expect( + $.introspectionManipulator[`get${otherThing}`]({ + name: otherThingTest, + }) + ).to.be.ok + } }) it(`does not show any ${thing}s`, function () { @@ -633,7 +669,7 @@ describe('augmenters', function () { const thingType = $.introspectionManipulator[`get${thing}Type`]() const otherThingType = - $.introspectionManipulator[`get${otherThing}Type`]() + $.introspectionManipulator[`get${otherThings[0]}Type`]() // Both things should be there expect(thingType).to.be.ok @@ -663,7 +699,7 @@ describe('augmenters', function () { const thingType = $.introspectionManipulator[`get${thing}Type`]() const otherThingType = - $.introspectionManipulator[`get${otherThing}Type`]() + $.introspectionManipulator[`get${otherThings[0]}Type`]() // Both things should be there expect(thingType).to.be.ok @@ -806,7 +842,7 @@ describe('augmenters', function () { def('metadataBase', () => ({ OBJECT: { MyType: { - // Should have no impact, example-wise + // Should have an impact, example-wise metadata: $.theMetadata, fields: { myField: { @@ -847,6 +883,20 @@ describe('augmenters', function () { }, }, }, + Subscription: { + // Should have no impact, example-wise + metadata: $.theMetadata, + fields: { + myQuery: { + metadata: $.theMetadata, + args: { + myArg: { + metadata: $.theMetadata, + }, + }, + }, + }, + }, }, INPUT_OBJECT: { MyInput: { @@ -879,10 +929,10 @@ describe('augmenters', function () { const response = $.response expect(response).to.not.eql(responseBefore) - // No top-level examples, even if ther was something in the metadata for them expect($.introspectionManipulator.getType({ name: 'MyType' })) .to.be.an('object') - .that.does.not.have.any.keys('example') + .that.does.have.any.keys('example') + expect( $.introspectionManipulator.getType({ name: 'MyInput', @@ -890,7 +940,9 @@ describe('augmenters', function () { }) ) .to.be.an('object') - .that.does.not.have.any.keys('example') + .that.does.have.any.keys('example') + + // No top-level examples, even if ther was something in the metadata for them expect($.introspectionManipulator.getType({ name: 'Query' })) .to.be.an('object') .that.does.not.have.any.keys('example') @@ -898,6 +950,10 @@ describe('augmenters', function () { .to.be.an('object') .that.does.not.have.any.keys('example') + expect($.introspectionManipulator.getType({ name: 'Subscription' })) + .to.be.an('object') + .that.does.not.have.any.keys('example') + // Type Fields have example... expect( $.introspectionManipulator.getField({ diff --git a/test/src/spectaql/graphql-loaders.test.js b/test/src/spectaql/graphql-loaders.test.js index f8ba9dc4..40cb8359 100644 --- a/test/src/spectaql/graphql-loaders.test.js +++ b/test/src/spectaql/graphql-loaders.test.js @@ -1,15 +1,15 @@ -const { +import { pathToSimpleSchema, pathToSimpleSchemaWithDirectives, pathToSimpleSchemaSupplement, pathToNonStandardQueryMutationSchema, -} = require('test/helpers') +} from 'test/helpers' -const { +import { loadSchemaFromSDLFile, introspectionResponseFromSchema, graphQLSchemaFromIntrospectionResponse, -} = require('dist/spectaql/graphql-loaders') +} from 'dist/spectaql/graphql-loaders' describe('graphql-loaders', function () { describe('loadSchemaFromSDLFile', function () { diff --git a/test/src/spectaql/index.test.js b/test/src/spectaql/index.test.js index 1fb9cf06..c7b8f0e6 100644 --- a/test/src/spectaql/index.test.js +++ b/test/src/spectaql/index.test.js @@ -1,12 +1,18 @@ -const spectaql = require('dist/spectaql') -const { pathToSimpleSchema, pathToComplexSchema } = require('test/helpers') +import spectaql from 'dist/spectaql' +import { + pathToSimpleSchema, + pathToComplexSchema, + pathToExampleTheme, +} from 'test/helpers' describe('index', function () { def('opts', () => ({ specData: $.specData, + themeDir: $.themeDir, })) def('specData', () => ({ + spectaql: $.spectaql, introspection: $.introspection, info: $.info, servers: $.servers, @@ -63,7 +69,7 @@ describe('index', function () { context('no x-url', function () { def('url', () => undefined) it('errors', function () { - return expect(() => spectaql($.opts)).to.throw( + return expect(spectaql($.opts)).to.eventually.be.rejectedWith( 'Please provide either: introspection.url OR servers.url OR info.x-url' ) }) @@ -83,8 +89,8 @@ describe('index', function () { }, ]) - it("doesn't error and processes headers", function () { - const result = spectaql($.opts) + it("doesn't error and processes headers", async function () { + const result = await spectaql($.opts) expect(result).to.be.ok expect(result.headers).to.eql( `# Get your Foo from Bar\nFoo: Bar ` @@ -97,8 +103,8 @@ describe('index', function () { def('schemaFile', () => undefined) def('introspectionUrl', () => 'http://foo.com') - it("doesn't error", function () { - const result = spectaql($.opts) + it("doesn't error", async function () { + const result = await spectaql($.opts) return expect(result).to.be.ok }) }) @@ -107,17 +113,19 @@ describe('index', function () { describe('e2e sanity check', function () { def('schemaFile', () => pathToComplexSchema) + it('does not blow up', async function () { - const result = spectaql($.opts) + const result = await spectaql($.opts) expect(result).be.an('object').that.includes.keys('items') - expect(result.items).to.have.length.gt(0) + expect(result.items).to.have.length(2) expect(result.items[0]).to.include({ name: 'Operations', }) - expect(result.items[0].items).to.have.length.gt(0) + expect(result.items[0].items).to.have.length(3) + expect(result.items[0].items[0]).to.include({ name: 'Queries', }) @@ -125,7 +133,6 @@ describe('index', function () { result.items[0].items[0].items.find((item) => item.name === 'myQuery') ).to.be.ok - expect(result.items[0].items).to.have.length.gt(0) expect(result.items[0].items[1]).to.include({ name: 'Mutations', }) @@ -135,21 +142,64 @@ describe('index', function () { ) ).to.be.ok + expect(result.items[0].items[2]).to.include({ + name: 'Subscriptions', + }) + expect( + result.items[0].items[2].items.find( + (item) => item.name === 'myTypeUpdatedSubscription' + ) + ).to.be.ok + expect(result.items[1]).to.include({ name: 'Types', }) - expect(result.items[1].items).to.have.length.gt(0) expect( result.items[1].items.find((item) => item.name === 'SimpleTypeOne') ).to.be.ok }) + + context('it uses custom theme that is MJS', function () { + def('themeDir', () => pathToExampleTheme) + + // Skipping this in favor of an e2e test using the ./test/build + // Maybe when this is resolved? + // https://github.com/nodejs/node/issues/35889 + it.skip('does not blow up', async function () { + const result = await spectaql($.opts) + expect(result).be.an('object').that.includes.keys('items') + + expect(result.items).to.have.length(2) + + expect(result.items[0]).to.include({ + name: 'Operations', + }) + + expect(result.items[0].items).to.have.length(1) + + expect(result.items[0].items[0]).to.include({ + name: 'Queries', + }) + expect( + result.items[0].items[0].items.find((item) => item.name === 'myQuery') + ).to.be.ok + + expect(result.items[1]).to.include({ + name: 'Types', + }) + expect(result.items[1].items).to.have.length.gt(0) + expect( + result.items[1].items.find((item) => item.name === 'SimpleTypeOne') + ).to.be.ok + }) + }) }) describe('trailing period removal', function () { def('schemaFile', () => pathToSimpleSchema) it('does not strip trailing periods by default', async function () { - const result = spectaql($.opts) + const result = await spectaql($.opts) expect(result).be.an('object').that.includes.keys('items') expect(result.items).to.have.length.gt(0) @@ -180,7 +230,7 @@ describe('index', function () { def('removeTrailingPeriodFromDescriptions', () => true) it('does strip trailing periods when asked', async function () { - const result = spectaql($.opts) + const result = await spectaql($.opts) expect(result).be.an('object').that.includes.keys('items') expect(result.items).to.have.length.gt(0) @@ -213,7 +263,7 @@ describe('index', function () { def('schemaFile', () => './test/fixtures/bad-schema.gql') it('raises error', function () { - return expect(() => spectaql($.opts)).to.throw( + return expect(spectaql($.opts)).to.eventually.be.rejectedWith( 'Problem with Introspection Query Response' ) }) diff --git a/vendor-src/.gitignore b/vendor-src/.gitignore new file mode 100644 index 00000000..cfee9278 --- /dev/null +++ b/vendor-src/.gitignore @@ -0,0 +1 @@ +.spectaql-cache \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/.gitignore b/vendor-src/grunt-compile-handlebars/.gitignore new file mode 100644 index 00000000..26c1012f --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/.gitignore @@ -0,0 +1,4 @@ +node_modules +tmp +yarn.lock +npm-debug.log diff --git a/vendor-src/grunt-compile-handlebars/.jshintrc b/vendor-src/grunt-compile-handlebars/.jshintrc new file mode 100644 index 00000000..05ac8707 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/.jshintrc @@ -0,0 +1,14 @@ +{ + "eqeqeq": true, + "immed": true, + "latedef": true, + "newcap": true, + "noarg": true, + "sub": true, + "undef": true, + "boss": true, + "eqnull": true, + "node": true, + "unused": true, + "undef": true +} diff --git a/vendor-src/grunt-compile-handlebars/.npmignore b/vendor-src/grunt-compile-handlebars/.npmignore new file mode 100644 index 00000000..d4106977 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/.npmignore @@ -0,0 +1,2 @@ +/node_modules/ +.git diff --git a/vendor-src/grunt-compile-handlebars/.travis.yml b/vendor-src/grunt-compile-handlebars/.travis.yml new file mode 100644 index 00000000..81ce6bd5 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/.travis.yml @@ -0,0 +1,7 @@ +language: node_js +node_js: + - 0.8 + - 0.10 +before_install: + - npm install -g npm@~1.4.6 + - npm install -g grunt-cli diff --git a/vendor-src/grunt-compile-handlebars/CONTRIBUTORS.md b/vendor-src/grunt-compile-handlebars/CONTRIBUTORS.md new file mode 100644 index 00000000..3b9b8fb1 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/CONTRIBUTORS.md @@ -0,0 +1,14 @@ +Contributors +============ + +These people have gone out of their way to add value to this little tool. + +- Patrick Kettner - [github](https://github.com/patrickkettner) [twitter](https://twitter.com/patrickkettner) +- Robin Qu - [github](https://github.com/RobinQu) [twitter](https://twitter.com/robinqu) +- Martin Götte [github](https://github.com/goette) [twitter](https://twitter.com/mrtngtt) +- Matthew Galizia [github](https://github.com/mattcg) [twitter](https://twitter.com/mcaruanagalizia) +- Scott Timmins [github](https://github.com/stimmins) +- Anders D. Johnson [github](https://github.com/adjohnson916) [twitter](https://twitter.com/adjohnson916) [website](http://andrz.me) +- Paul Mason [github](https://github.com/paulmason) +- Igor Sadovskiy [github](https://github.com/isadovskiy) +- Gašper Č. [github](https://github.com/gapipro) \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/Gruntfile.js b/vendor-src/grunt-compile-handlebars/Gruntfile.js new file mode 100644 index 00000000..13a71ab3 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/Gruntfile.js @@ -0,0 +1,185 @@ +/* + * grunt-compile-handlebars + * http://gruntjs.com/ + * + * Copyright (c) 2014 Patrick Kettner, contributors + * Licensed under the MIT license. + */ + +'use strict'; + +module.exports = function(grunt) { + + // Project configuration. + grunt.initConfig({ + + jshint: { + all: [ + 'Gruntfile.js', + 'tasks/*.js', + '<%= nodeunit.tests %>' + ], + options: { + jshintrc: '.jshintrc' + } + }, + + clean: { + test: ['tmp'] + }, + + // Configuration to be run (and then tested). + 'compile-handlebars': { + allStatic: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/allStatic.html' + }], + preHTML: 'test/fixtures/pre-dev.html', + postHTML: 'test/fixtures/post-dev.html', + templateData: 'test/fixtures/data.json' + }, + dynamicHandlebars: { + files: [{ + src: '

    ', + dest: 'tmp/dynamicHandlebars.html' + }], + templateData: {}, + handlebars: 'node_modules/handlebars' + }, + jsonHandlebars: { + files: [{ + src: 'test/fixtures/sweedishTemplate.json', + dest: 'tmp/sweedish.json' + }], + templateData: 'test/fixtures/sweedishData.json' + }, + dynamicTemplate: { + files: [{ + src: '

    {{salutation}}{{punctuation}} {{location}}

    ', + dest: 'tmp/dynamicTemplate.html' + }], + template: '

    {{salutation}}{{punctuation}} {{location}}

    ', + templateData: 'test/fixtures/data.json' + }, + dynamicTemplateData: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicTemplateData.html' + }], + templateData: { + "salutation": "Hallo", + "punctuation": ",", + "location": "Welt" + } + }, + dynamicPre: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicPre.html' + }], + preHTML: '
    INLINE HEADER
    ', + templateData: 'test/fixtures/data.json' + }, + dynamicPost: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicPost.html' + }], + postHTML: '
    INLINE FOOTER
    ', + templateData: 'test/fixtures/data.json' + }, + anyArray: { + files: [{ + src: ['test/fixtures/deep/romanian.handlebars', 'test/fixtures/deep/german.handlebars'], + dest: ['tmp/deep/romanian.html','tmp/deep/german.html'] + }], + templateData: ['test/fixtures/deep/romanian.json', 'test/fixtures/deep/german.json'], + helpers: ['test/helpers/super_helper.js'], + partials: ['test/fixtures/partials/foo.handlebars'] + }, + globbedTemplateAndOutput: { + files: [{ + expand: true, + cwd: 'test/fixtures/', + src: 'deep/**/*.handlebars', + dest: 'tmp/', + ext: '.html' + }], + templateData: 'test/fixtures/deep/**/*.json', + helpers: 'test/helpers/**/*.js', + partials: 'test/fixtures/partials/**/*.handlebars' + }, + globalJsonGlobbedTemplate: { + files: [{ + expand: true, + cwd: 'test/fixtures/', + src: 'deep/**/*.handlebars', + dest: 'tmp/', + ext: '.html' + }], + templateData: 'test/fixtures/deep/**/*.json', + helpers: 'test/helpers/**/*.js', + partials: 'test/fixtures/partials/**/*.handlebars', + globals: [ + 'test/globals/info.json', + 'test/globals/textspec.json', + { + textspec: { + "ps": "P.S. from Gruntfile.js" + } + } + ] + }, + registerFullPath: { + files: [{ + src: '

    {{salutation}}{{punctuation}} {{location}}

    {{> test/fixtures/partials/pathTest}}', + dest: 'tmp/fullPath.html' + }], + templateData: { + "salutation": "Hallo", + "punctuation": ",", + "location": "Welt" + }, + partials: 'test/fixtures/partials/**/*.handlebars', + registerFullPath: true + }, + concatGlobbed: { + files: [{ + src: 'test/fixtures/deep/**/*.handlebars', + dest: 'tmp/concatGlobbed.html' + }], + templateData: 'test/fixtures/deep/**/*.json', + helpers: 'test/helpers/**/*.js', + partials: 'test/fixtures/partials/**/*.handlebars' + }, + oneTemplateToManyOutputs: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: ['tmp/oneTemplateToManyOutputs1.html', 'tmp/oneTemplateToManyOutputs2.html'] + }], + templateData: ['test/fixtures/oneTemplateToManyOutputs1.json', 'test/fixtures/oneTemplateToManyOutputs2.json'] + } + }, + + // Unit tests. + nodeunit: { + tests: ['test/*_test.js'] + } + }); + + // Actually load this plugin's task(s). + grunt.loadTasks('tasks'); + + // These plugins provide necessary tasks. + grunt.loadNpmTasks('grunt-contrib-clean'); + grunt.loadNpmTasks('grunt-contrib-jshint'); + grunt.loadNpmTasks('grunt-contrib-nodeunit'); + + // Whenever the 'test' task is run, first create some files to be cleaned, + // then run this plugin's task(s), then test the result. + grunt.registerTask('test', ['clean', 'compile-handlebars', 'nodeunit']); + + // By default, lint and run all tests. + grunt.registerTask('default', ['jshint', 'test']); +}; diff --git a/vendor-src/grunt-compile-handlebars/LICENSE-MIT b/vendor-src/grunt-compile-handlebars/LICENSE-MIT new file mode 100644 index 00000000..026251ad --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/LICENSE-MIT @@ -0,0 +1,22 @@ +Copyright (c) 2014 Patrick Kettner + +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. diff --git a/vendor-src/grunt-compile-handlebars/README.md b/vendor-src/grunt-compile-handlebars/README.md new file mode 100644 index 00000000..15928fad --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/README.md @@ -0,0 +1,249 @@ +# grunt-compile-handlebars [![Build Status](https://secure.travis-ci.org/patrickkettner/grunt-compile-handlebars.png?branch=master)](http://travis-ci.org/patrickkettner/grunt-compile-handlebars) + +Compiles handlebar templates, outputs static HTML + +## Getting Started +Install this grunt plugin next to your project's [grunt.js gruntfile][getting_started] with: `npm install grunt-compile-handlebars` + +Then add this line to your project's `Gruntfile.js` gruntfile: + +```javascript +grunt.loadNpmTasks('grunt-compile-handlebars'); +``` + +[grunt]: https://github.com/gruntjs/grunt +[getting_started]: https://github.com/gruntjs/grunt/blob/master/docs/getting_started.md + +## Documentation +### Who +patrick kettner - a web developer who consistently worked with large static data sets. + +### What +grunt-compile-handlebars takes in a handlebars template (and optionally static pre and post html), runs a dataset over it, and outputs static html. + +### Where +inside of a grunt task. I assume you know what gruntjs is, but if not - [gruntjs.com](http://gruntjs.com) + +### When +You have ton of data that rarely changes that you want to template. + +### How +There are a lot of different ways to input data, it accepts most any dynamic and static +input. +Heres a few of the ways you can use it + +```javascript +'compile-handlebars': { + allStatic: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/allStatic.html' + }], + preHTML: 'test/fixtures/pre-dev.html', + postHTML: 'test/fixtures/post-dev.html', + templateData: 'test/fixtures/data.json' + }, + dynamicHandlebars: { + files: [{ + src: '

    ', + dest: 'tmp/dynamicHandlebars.html' + }], + templateData: {}, + handlebars: 'node_modules/handlebars' + }, + jsonHandlebars: { + files: [{ + src: 'test/fixtures/sweedishTemplate.json', + dest: 'tmp/sweedish.json' + }], + templateData: 'test/fixtures/sweedishData.json' + }, + dynamicTemplate: { + files: [{ + src: '

    {{salutation}}{{punctuation}} {{location}}

    ', + dest: 'tmp/dynamicTemplate.html' + }], + template: '

    {{salutation}}{{punctuation}} {{location}}

    ', + templateData: 'test/fixtures/data.json' + }, + dynamicTemplateData: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicTemplateData.html' + }], + templateData: { + "salutation": "Hallo", + "punctuation": ",", + "location": "Welt" + } + }, + dynamicPre: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicPre.html' + }], + preHTML: '
    INLINE HEADER
    ', + templateData: 'test/fixtures/data.json' + }, + dynamicPost: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: 'tmp/dynamicPost.html' + }], + postHTML: '
    INLINE FOOTER
    ', + templateData: 'test/fixtures/data.json' + }, + anyArray: { + files: [{ + src: ['test/fixtures/deep/romanian.handlebars', 'test/fixtures/deep/german.handlebars'], + dest: ['tmp/deep/romanian.html','tmp/deep/german.html'] + }], + templateData: ['test/fixtures/deep/romanian.json', 'test/fixtures/deep/german.json'], + helpers: ['test/helpers/super_helper.js'], + partials: ['test/fixtures/deep/shared/foo.handlebars'] + }, + globbedTemplateAndOutput: { + files: [{ + expand: true, + cwd: 'test/fixtures/', + src: 'deep/**/*.handlebars', + dest: 'tmp/', + ext: '.html' + }], + templateData: 'test/fixtures/deep/**/*.json', + helpers: 'test/helpers/**/*.js', + partials: 'test/fixtures/deep/shared/**/*.handlebars' + }, + globalJsonGlobbedTemplate: { + files: [{ + expand: true, + cwd: 'test/fixtures/', + src: 'deep/**/*.handlebars', + dest: 'tmp/', + ext: '.html' + }], + templateData: 'test/fixtures/deep/**/*.json', + helpers: 'test/helpers/**/*.js', + partials: 'test/fixtures/deep/shared/**/*.handlebars', + globals: [ + 'test/globals/info.json', + 'test/globals/textspec.json', + { + textspec: { + "ps": "P.S. from Gruntfile.js" + } + } + ] + }, + registerFullPath: { + files: [{ + src: '

    {{salutation}}{{punctuation}} {{location}}

    {{> test/fixtures/deep/shared/pathTest}}', + dest: 'tmp/fullPath.html' + }], + templateData: { + "salutation": "Hallo", + "punctuation": ",", + "location": "Welt" + }, + partials: 'test/fixtures/deep/shared/**/*.handlebars', + registerFullPath: true + }, + concatGlobbed: { + files: [{ + src: 'test/fixtures/deep/**/*.handlebars', + dest: 'tmp/concatGlobbed.html' + }], + templateData: 'test/fixtures/deep/**/*.json' + }, + oneTemplateToManyOutputs: { + files: [{ + src: 'test/fixtures/template.handlebars', + dest: ['tmp/oneTemplateToManyOutputs1.html', 'tmp/oneTemplateToManyOutputs2.html'] + }], + templateData: ['test/fixtures/oneTemplateToManyOutputs1.json', 'test/fixtures/oneTemplateToManyOutputs2.json'] + } +}, +``` + +The available configuration options are as follows + +Unless otherwise noted, all configurable values can be represented as +* a string representing the path to a specific file +* a string representing the path to a [globbed representation](http://gruntjs.com/api/grunt.file#globbing-patterns) of the files, matched up against the values resolved from the `template` configuration +* an array of literal paths, globbed paths, or a combination of the two + +__`files`__ - A typical [grunt files object](http://gruntjs.com/configuring-tasks#building-the-files-object-dynamically). The `src` are your handlebar templates, the `dest` is your html ouput. See the grunt documentation and the usage examples above for more info on how to use this object. + +__`preHTML`__ - Static text to be inserted before the compiled template +__`postHTML`__ - Static text to be inserted after the compiled template + +__`templateData` ~~ The data being fed to compiled template, in addition to the normal configurable values, this can be +* an inline string representation of a data (I don't know why you would do that though, when you can do...) +* an inline JSON representation of a data + +__`globals`__ - globals that can be included, useful for when you have template specific data, but want some data available to all templates +__`helpers`__ - handlebars helpers +__`partials`__ - handlebars partials + +__`registerFullPath`__ - normally, helpers and partials are registered under their basename, rather than their path (e.g. partial at `partials/deep/awesomePartial.handlebars` is registered as `{{> awesomePartial}}`). When set to `true`, helpers and partials are registered under their full paths (e.g. {{> partials/deep/awesomePartial}}), to prevent clobbering after resolving globbed values. + +`handlebars` - a string representing the path to an instance of handlebars (if you don't want to use the bundeled version). +Note: This __cannot__ be `require('handlebars')`, as that creates a circular reference. You need to pass the path to the instance you want to use, i.e. `handlebars: "./node_modules/handlebars"` + +#### A note on globing + +When you specify templates using globs, the values from `template` are used to create the values for output, for example, if your file structure looks like this + +``` +|-foo + |-bar.handlebars + |-baz.handlebars + |-bar.json + |-baz.json +``` + +and your configuration looks like this + +``` +files: [{ + expand: true, + cwd: './foo/', + src: '*.handlebars', + dest: './foo/', + ext: '.html' +}], +"templateData": "./foo/*.json", +``` + +the output would be `./foo/bar.html` and `./foo/baz.html` + + +### Why +I had to work with several hundred repeated data structures that never changed. Keeping them all in html was silly, but pushing out a template engine for the end user to compile the same information multiple times was even sillier. This allows you to have your templated cake and eat it too. + +## Release History + * 2.0.2 - Gadge - fixup Grunt PeerDeps requirement for 1.0 compatibility, have templateData return an empty object when omitted + * 2.0.1 - Candy - @jrylander updated the lodash dependency to fix breakages introduced in lodash v4 + * 2.0.0 - Jed - @timhettler rewrote larges swaths of the task to use the [Grunt file object](http://gruntjs.com/configuring-tasks#files-object-format) + * 1.0.1 - Lazy-Eye - @gapipro added path cache for partials and helpers, and fixed using mulitple templates with the same filename + * 1.0.0 - Serge - Add inline object support for `globals`, fix `outputInInput` + * 0.7.8 - Eli - add `outputInInput` setting to send outputted files back to their handlebars directory + * 0.7.7 - Uzi - swap out `JSON.parse` for `alce.parse`, allowing for (technically invalid) single quoted json + * 0.7.6 - Kristofferson - explicitly check that `isGlob` is undefined, preventing a false negative on empty strings + * 0.7.5 - Redford - add `registerFullPath` option to prevent partial/helper registration clobbering, update README + * 0.7.4 - M. Jean - don't send objects to handlebars.compile, code cleanup + * 0.7.3 - Cousin Ben - switch from require to readFile to allow for html in partials + * 0.7.2 - Bernice - @stimmins improved handling of templateData and globals + * 0.7.1 - Margaret - fix 0.8 compatibility + * 0.7.0 - Rosemary - Allow for arrays instead of globbing, remove depreicated grunt methods + * 0.6.3 - Pelé - @mattcg fixed an issue with large amounts of templates + * 0.6.2 - Dignan - @goette added support for a global json config + * 0.6.1 - Grace - @robinqu added support for handlebars partials + * 0.6.0 - Future Man - added globbing, lots more test + * 0.4.0 - Oseary - upgraded to grunt 0.4, removed extra tasks, added tests + * 0.0.2 - Inez - changed to grunt's native json parser (thanks to @sebslomski). Updated Readme + * 0.0.1 - Dudley - Initial commit + +## License +Copyright (c) 2014 Patrick Kettner +Licensed under the MIT license. diff --git a/vendor-src/grunt-compile-handlebars/bin/grunt-compile-handlebars b/vendor-src/grunt-compile-handlebars/bin/grunt-compile-handlebars new file mode 100644 index 00000000..ba07cdbd --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/bin/grunt-compile-handlebars @@ -0,0 +1,2 @@ +#!/usr/bin/env node +require('grunt').npmTasks('grunt-compile-handlebars').cli(); diff --git a/vendor-src/grunt-compile-handlebars/package.json b/vendor-src/grunt-compile-handlebars/package.json new file mode 100644 index 00000000..68daf61c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/package.json @@ -0,0 +1,60 @@ +{ + "name": "grunt-compile-handlebars", + "description": "Compile handlebar templates, outputting static HTML", + "version": "1.0.0", + "homepage": "https://github.com/patrickkettner/grunt-compile-handlebars", + "author": { + "name": "Patrick Kettner", + "email": "patrick@patrickkettner.com", + "url": "https://github.com/patrickkettner" + }, + "repository": { + "type": "git", + "url": "git://github.com/patrickkettner/grunt-compile-handlebars.git" + }, + "bugs": { + "url": "https://github.com/patrickkettner/grunt-compile-handlebars/issues" + }, + "licenses": [ + { + "type": "MIT", + "url": "https://github.com/patrickkettner/grunt-compile-handlebars/blob/master/LICENSE-MIT" + } + ], + "keywords": [ + "gruntplugin", + "handlebars" + ], + "main": "grunt.js", + "bin": "bin/grunt-compile-handlebars", + "engines": { + "node": ">=14" + }, + "scripts": { + "test": "grunt test" + }, + "files": [ + "package.json", + "README.md", + "Gruntfile.js", + "bin/", + "tasks/", + "!**/.DS_STORE", + "!**/.DS_Store" + ], + "devDependencies": { + "grunt": "^1.5.3", + "grunt-contrib-clean": "~0.4.0", + "grunt-contrib-jshint": "~0.2.0", + "grunt-contrib-nodeunit": "~0.2.0", + "handlebars": ">= 4", + "json5": "^2.2.0", + "lodash": "^4.17.12" + }, + "peerDependencies": { + "grunt": "^1.5.3", + "handlebars": ">= 4", + "json5": "^2.2.0", + "lodash": "^4.17.12" + } +} diff --git a/vendor-src/grunt-compile-handlebars/tasks/compile-handlebars.js b/vendor-src/grunt-compile-handlebars/tasks/compile-handlebars.js new file mode 100644 index 00000000..576e7ef9 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/tasks/compile-handlebars.js @@ -0,0 +1,291 @@ +/* +* grunt-compile-handlebars +* https://github.com/patrickkettner/grunt-compile-handlebars +* +* Copyright (c) 2014 Patrick Kettner, contributors +* Licensed under the MIT license. +*/ + +'use strict'; + +module.exports = function(grunt) { + var _merge = require('lodash/merge'); + var _toArray = require('lodash/toArray'); + var JSON5 = require('json5'); + var path = require('path'); + var handlebarsPath; + var handlebars; + var usedPartials = []; + var usedHelpers = []; + + // Normalizes the input so that it is always an array for the forEach loop + var getConfig = function(config) { + if (!config) { + return []; + } + + var files = grunt.file.expand(config); + + if (files.length) { + return files; + } + + return [config]; + }; + + // Gets the final representation of the input, whether it be object, or string + var parseData = function(data, dontParse) { + // grunt.file chokes on objects, so we check for it immiedietly + if (typeof data === 'object') { + return data; + } + + // `data` isn't an object, so its probably a file + try { + // JSON5 allows us to parse single-quote JSON (which is tehcnically invalid, and thereby chokes JSON.parse) + data = grunt.file.read(data); + if (!dontParse) { + data = JSON5.parse(data); + } + } + catch (e) {} + + return data; + }; + + // Checks if the input is a glob and if so, returns the unglobbed version of the filename + var isGlob = function(filename) { + if (!filename || typeof filename === 'object') { + return; + } + + var match = filename.match(/[^\*]*/); + + if (match[0] !== filename) { + return match.pop(); + } + }; + + // Figures out the name of the file before any globs are used, so the globbed outputs can be generated + var getBasename = function(filename, template, outputInInput) { + var basename; + var glob; + + template = Array.isArray(template) ? filename : template; + glob = isGlob(template); + if (outputInInput) { + basename = _toArray(filename.split('.').pop()) ; + } else if (glob) { + basename = filename.slice(glob.length, filename.length).split('.'); + basename.pop(); + } else { + basename = filename.split('/').pop().split('.'); + basename.pop(); + } + return basename.join('.'); + }; + + var mergeJson = function(source, globals) { + var json = {} + var fragment; + + globals.forEach(function(global) { + if (grunt.util.kindOf(global) === 'object') { + fragment = global; + } else { + if (!grunt.file.exists(global)) { + return grunt.log.error('JSON file ' + global + ' not found.'); + } else { + try { + fragment = grunt.file.readJSON(global); + } + catch (e) { + return grunt.fail.warn(e); + } + } + } + _merge(json, fragment); + }); + + if (typeof source === 'object') { + _merge(json, source); + } + + return json; + }; + + var shouldRegisterFullPaths = function(itShould, type) { + + if (itShould && typeof itShould === 'string') { + itShould = itShould.toLowerCase().indexOf(type) === 0; + } + + return itShould; + }; + + var getTemplateData = function(templateData, filepath, index) { + var data; + if (templateData === undefined) { + return {}; + } + if (Array.isArray(templateData)) { + data = templateData[index]; + if (data) { + return data; + } + + grunt.log.error('You need to assign the same number of data files as source files when using array notation.'); + + return; + } + if (typeof templateData === 'object') { + return templateData; + } + if (grunt.file.exists(templateData)) { + return templateData; + } + if (isGlob(templateData) !== undefined) { + data = filepath.replace(path.extname(filepath), path.extname(templateData)); + if (data) { + return data; + } + + return grunt.log.error('No matching data file for ' + filepath + '.'); + } + + return templateData; + }; + + var getDest = function(destConfig, index) { + var dest; + if (Array.isArray(destConfig)) { + dest = destConfig[index]; + if (dest) { + return dest; + } + grunt.log.error('You need to assign the same number of destination files as source files when using array notation.'); + return; + } + if (isGlob(destConfig) !== undefined) { + dest = grunt.file.expand(destConfig)[index]; + if (dest) { + return dest; + } + grunt.log.error('You need to assign the same number of destination files as source files when using glob notation.'); + return; + } + return destConfig; + }; + + grunt.registerMultiTask('compile-handlebars', 'Compile Handlebars templates ', function() { + var fs = require('fs'); + var path = require('path'); + var files = this.files; + var config = this.data; + var helpers = getConfig(config.helpers); + var partials = getConfig(config.partials); + var done = this.async(); + + handlebarsPath = config.handlebars ? path.resolve(config.handlebars) : 'handlebars'; + // Create a new instance so that we don't clobber our old defs when tasks are re-run + // in the same process lifetime + handlebars = require(handlebarsPath).create(); + + helpers.forEach(function(helper) { + var fullPath = helper.replace(/\.[^/.]+$/, ''); + var name = shouldRegisterFullPaths(config.registerFullPath, 'helpers') ? + // full path, minus extention + fullPath : + // just the file's name + getBasename(helper, config.helpers); + + if (handlebars.helpers[name] && usedHelpers.indexOf(fullPath) === -1) { + grunt.log.error(name + ' is already registered, clobbering with the new value. Consider setting `registerFullPath` to true'); + } else { + usedHelpers.push(fullPath); + } + + handlebars.registerHelper(name, require(fs.realpathSync(helper))); + }); + + partials.forEach(function(partial) { + var fullPath = partial.replace(/\.[^/.]+$/, ''); + var name = shouldRegisterFullPaths(config.registerFullPath, 'partials') ? + // full path, minus extention + fullPath : + // just the file's name + getBasename(partial, config.partials); + + if (handlebars.partials[name] && usedPartials.indexOf(fullPath) === -1) { + grunt.log.error(name + ' is already registered, clobbering with the new value. Consider setting `registerFullPath` to true'); + } else { + usedPartials.push(fullPath); + } + + handlebars.registerPartial(name, fs.readFileSync(fs.realpathSync(partial), 'utf8')); + }); + + var compile = function(file, filepath, index) { + var dest = file.dest || ''; + var template = filepath; + var compiledTemplate = handlebars.compile(parseData(template, true)); + var templateData = getTemplateData(config.templateData, filepath, index); + var outputPath = getDest(dest, index); + var appendToFile = (outputPath === file.orig.dest && grunt.file.exists(outputPath)); + var operation = appendToFile ? 'appendFileSync' : 'writeFileSync'; + var html = ''; + var json; + + if (config.preHTML) { + html += parseData(config.preHTML); + } + + json = mergeJson(parseData(templateData), config.globals || []); + + html += compiledTemplate(json); + + if (config.postHTML) { + html += parseData(config.postHTML); + } + + // shamefully copied straight out of grunt's file command, to allow for appending + // http://git.io/ZYGLEw + grunt.file.mkdir(path.dirname(outputPath)); + + try { + fs[operation](outputPath, html); + grunt.verbose.ok(); + return true; + } catch (e) { + grunt.verbose.error(); + throw grunt.util.error('Unable to write "' + outputPath + '" file (Error code: ' + e.code + ').', e); + } + + }; + + files.forEach(function(file) { + if (Array.isArray(file.dest) && file.dest.length > file.src.length) { + if (file.src.length > 1) { + grunt.log.error('You may only have one source file when there are more destination files than source files.'); + return; + } else { + file.dest.forEach(function(destpath, index) { + compile(file, file.src[0], index); + }); + } + } else { + if (file.src.length > 0) { + file.src.forEach(function(filepath, index) { + compile(file, filepath, index); + }); + } else { + file.orig.src.forEach(function(template, index) { + compile(file, template, index); + }); + } + } + }); + + process.nextTick(done); + }); +}; diff --git a/vendor-src/grunt-compile-handlebars/test/compile_handlebars_test.js b/vendor-src/grunt-compile-handlebars/test/compile_handlebars_test.js new file mode 100644 index 00000000..1989575c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/compile_handlebars_test.js @@ -0,0 +1,208 @@ +'use strict' + +var grunt = require('grunt') + +exports.clean = { + allStatic: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/allStatic.html') + var expected = grunt.file.read('test/expected/allStatic.html') + + test.equal(actual, expected, 'all static files should work') + + test.done() + }, + dynamicHandlebars: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/dynamicHandlebars.html') + var expected = grunt.file.read('test/expected/dynamicHandlebars.html') + + test.equal(actual, expected, 'Passed reference to handlebars should work') + + test.done() + }, + jsonHandlebars: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/sweedish.json') + var expected = grunt.file.read('test/expected/sweedish.json') + + test.equal(actual, expected, 'json handlebars templates should work') + + test.done() + }, + dynamicTemplate: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/dynamicTemplate.html') + var expected = grunt.file.read('test/expected/dynamicTemplate.html') + + test.equal(actual, expected, 'Inline handlebars should work') + + test.done() + }, + dynamicTemplateData: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/dynamicTemplateData.html') + var expected = grunt.file.read('test/expected/dynamicTemplateData.html') + + test.equal(actual, expected, 'Inline JSON objects as data should work') + + test.done() + }, + dynamicPre: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/dynamicPre.html') + var expected = grunt.file.read('test/expected/dynamicPre.html') + + test.equal( + actual, + expected, + 'Inline html as static data before template should work' + ) + + test.done() + }, + dynamicPost: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/dynamicPost.html') + var expected = grunt.file.read('test/expected/dynamicPost.html') + + test.equal( + actual, + expected, + 'Inline html as static data after template should work' + ) + + test.done() + }, + allArray: function (test) { + test.expect(2) + var germanActual = grunt.file.read('tmp/deep/german.html') + var romanianActual = grunt.file.read('tmp/deep/romanian.html') + var germanExpected = grunt.file.read('test/expected/german.html') + var romanianExpected = grunt.file.read('test/expected/romanian.html') + + test.equal(germanActual, germanExpected) + test.equal( + romanianActual, + romanianExpected, + 'array output should be working' + ) + + test.done() + }, + globbedTemplateAndOutput: function (test) { + test.expect(2) + + var shallowActual = grunt.file.read('tmp/deep/spanish.html') + var shallowExpected = grunt.file.read('test/expected/deep/spanish.html') + var deepActual = grunt.file.read('tmp/deep/deeper/portuguese.html') + var deepExpected = grunt.file.read( + 'test/expected/deep/deeper/portuguese.html' + ) + + test.equal( + shallowActual, + shallowExpected, + 'Shallow globbed files should generated equally named output files' + ) + + test.equal( + deepActual, + deepExpected, + 'Deeply globbed files should generated equally named output files' + ) + + test.done() + }, + globalJsonGlobbedTemplate: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/deep/globalJsonGlobbedTemplate.html') + var expected = grunt.file.read( + 'test/expected/globalJsonGlobbedTemplate.html' + ) + + test.equal( + actual, + expected, + 'Use specific templateName.json per templateName.handlebars (as in globbedTemplateAndOutput) plus multiple global json on top' + ) + + test.done() + }, + registerFullPath: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/fullPath.html') + var expected = grunt.file.read('test/expected/fullPath.html') + + test.equal( + actual, + expected, + 'Partials and helpers referenced at their full paths should work when registerFullParth is true' + ) + + test.done() + }, + concatGlobbed: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/concatGlobbed.html') + var expected = grunt.file.read('test/expected/concatGlobbed.html') + + test.equal( + actual, + expected, + 'Globbed templates should append when output is a single file' + ) + + test.done() + }, + oneTemplateToManyOutputs: function (test) { + test.expect(2) + + var actual1 = grunt.file.read('tmp/oneTemplateToManyOutputs1.html') + var expected1 = grunt.file.read( + 'test/expected/oneTemplateToManyOutputs1.html' + ) + + var actual2 = grunt.file.read('tmp/oneTemplateToManyOutputs2.html') + var expected2 = grunt.file.read( + 'test/expected/oneTemplateToManyOutputs2.html' + ) + + test.equal( + actual1, + expected1, + 'Output should use same template but different data when it is a single file' + ) + test.equal( + actual2, + expected2, + 'Output should use same template but different data when it is a single file' + ) + + test.done() + }, + helperAndPartial: function (test) { + test.expect(1) + + var actual = grunt.file.read('tmp/deep/helperAndPartial.html') + var expected = grunt.file.read('test/expected/helperAndPartial.html') + + test.equal( + actual, + expected, + 'Helpers and partials should be corrected renderred' + ) + + test.done() + }, +} diff --git a/vendor-src/grunt-compile-handlebars/test/expected/allStatic.html b/vendor-src/grunt-compile-handlebars/test/expected/allStatic.html new file mode 100644 index 00000000..33a4ea2e --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/allStatic.html @@ -0,0 +1,13 @@ + + + + + static local + + + + +
    static local header
    +

    Hello, World

    + + diff --git a/vendor-src/grunt-compile-handlebars/test/expected/concatGlobbed.html b/vendor-src/grunt-compile-handlebars/test/expected/concatGlobbed.html new file mode 100644 index 00000000..20542701 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/concatGlobbed.html @@ -0,0 +1,9 @@ +

    Ola, mundo

    +

    Hallo, Welt

    +

    I'm global:

    +

    Me too:

    +

    And I'm embedded global:

    +

    I'm local and this template is called: globalJsonGlobbedTemplate

    super helper! +
    foo partial
    +

    Alo, mundo

    +

    hola, mundo

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/deep/deeper/portuguese.html b/vendor-src/grunt-compile-handlebars/test/expected/deep/deeper/portuguese.html new file mode 100644 index 00000000..0b6f4dd0 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/deep/deeper/portuguese.html @@ -0,0 +1 @@ +

    Ola, mundo

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/deep/spanish.html b/vendor-src/grunt-compile-handlebars/test/expected/deep/spanish.html new file mode 100644 index 00000000..08aa0bb8 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/deep/spanish.html @@ -0,0 +1 @@ +

    hola, mundo

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/dynamicHandlebars.html b/vendor-src/grunt-compile-handlebars/test/expected/dynamicHandlebars.html new file mode 100644 index 00000000..0ec5d8d8 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/dynamicHandlebars.html @@ -0,0 +1 @@ +

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/dynamicPost.html b/vendor-src/grunt-compile-handlebars/test/expected/dynamicPost.html new file mode 100644 index 00000000..00e9695d --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/dynamicPost.html @@ -0,0 +1,2 @@ +

    Hello, World

    +
    INLINE FOOTER
    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/dynamicPre.html b/vendor-src/grunt-compile-handlebars/test/expected/dynamicPre.html new file mode 100644 index 00000000..7d572250 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/dynamicPre.html @@ -0,0 +1 @@ +
    INLINE HEADER

    Hello, World

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplate.html b/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplate.html new file mode 100644 index 00000000..b9b75526 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplate.html @@ -0,0 +1 @@ +

    Hello, World

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplateData.html b/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplateData.html new file mode 100644 index 00000000..a8d6d66c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/dynamicTemplateData.html @@ -0,0 +1 @@ +

    Hallo, Welt

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/fullPath.html b/vendor-src/grunt-compile-handlebars/test/expected/fullPath.html new file mode 100644 index 00000000..e0c6d51d --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/fullPath.html @@ -0,0 +1 @@ +

    Hallo, Welt

    full paths!!!
    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/german.html b/vendor-src/grunt-compile-handlebars/test/expected/german.html new file mode 100644 index 00000000..774a4195 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/german.html @@ -0,0 +1 @@ +

    Hallo, Welt

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/globalJsonGlobbedTemplate.html b/vendor-src/grunt-compile-handlebars/test/expected/globalJsonGlobbedTemplate.html new file mode 100644 index 00000000..8e879fb5 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/globalJsonGlobbedTemplate.html @@ -0,0 +1,4 @@ +

    I'm global: Written by Mr. HelloWorld

    +

    Me too: Hello from textspec.json

    +

    And I'm embedded global: P.S. from Gruntfile.js

    +

    I'm local and this template is called: globalJsonGlobbedTemplate

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/expected/helperAndPartial.html b/vendor-src/grunt-compile-handlebars/test/expected/helperAndPartial.html new file mode 100644 index 00000000..91526db3 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/helperAndPartial.html @@ -0,0 +1,2 @@ +super helper! +
    foo partial
    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs1.html b/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs1.html new file mode 100644 index 00000000..93a3562a --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs1.html @@ -0,0 +1 @@ +

    Hello, World

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs2.html b/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs2.html new file mode 100644 index 00000000..a8d6d66c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/oneTemplateToManyOutputs2.html @@ -0,0 +1 @@ +

    Hallo, Welt

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/prod.html b/vendor-src/grunt-compile-handlebars/test/expected/prod.html new file mode 100644 index 00000000..93a3562a --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/prod.html @@ -0,0 +1 @@ +

    Hello, World

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/romanian.html b/vendor-src/grunt-compile-handlebars/test/expected/romanian.html new file mode 100644 index 00000000..40e07c6c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/romanian.html @@ -0,0 +1 @@ +

    Alo, mundo

    diff --git a/vendor-src/grunt-compile-handlebars/test/expected/sweedish.json b/vendor-src/grunt-compile-handlebars/test/expected/sweedish.json new file mode 100644 index 00000000..26370971 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/expected/sweedish.json @@ -0,0 +1,5 @@ +{ +   "hälsning": "Hej", +   "skiljetecken": ",", +   "läge": "Världen" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/data.json b/vendor-src/grunt-compile-handlebars/test/fixtures/data.json new file mode 100644 index 00000000..aef1ded5 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/data.json @@ -0,0 +1,5 @@ +{ + "salutation": "Hello", + "punctuation": ",", + "location": "World" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.handlebars new file mode 100644 index 00000000..fb3e3d92 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.handlebars @@ -0,0 +1 @@ +

    {{saudacao}}{{pontuacao}} {{localizacao}}

    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.json new file mode 100644 index 00000000..e11f1545 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/deeper/portuguese.json @@ -0,0 +1,5 @@ +{ + "saudacao": "Ola", + "pontuacao": ",", + "localizacao": "mundo" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.handlebars new file mode 100644 index 00000000..135d4c8a --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.handlebars @@ -0,0 +1 @@ +

    {{Anrede}}{{Zeichensetzung}} {{Lage}}

    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.json new file mode 100644 index 00000000..9990d92d --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/german.json @@ -0,0 +1,5 @@ +{ + "Anrede": "Hallo", + "Zeichensetzung": ", ", + "Lage": "Welt" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.handlebars new file mode 100644 index 00000000..e4154ac7 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.handlebars @@ -0,0 +1,4 @@ +

    I'm global: {{author}}

    +

    Me too: {{textspec.hi}}

    +

    And I'm embedded global: {{textspec.ps}}

    +

    I'm local and this template is called: {{templateName}}

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.json new file mode 100644 index 00000000..f71af60a --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/globalJsonGlobbedTemplate.json @@ -0,0 +1,3 @@ +{ + "templateName": "globalJsonGlobbedTemplate" +} \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.handlebars new file mode 100644 index 00000000..0e39b3e8 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.handlebars @@ -0,0 +1,2 @@ +{{super_helper}} +{{> foo}} \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.json new file mode 100644 index 00000000..eeedd400 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/helperAndPartial.json @@ -0,0 +1,3 @@ +{ + "hello": "world" +} \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.handlebars new file mode 100644 index 00000000..44c6ea04 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.handlebars @@ -0,0 +1 @@ +

    {{salut}}{{punctuație}} {{localizare}}

    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.json new file mode 100644 index 00000000..f94897d9 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/romanian.json @@ -0,0 +1,5 @@ +{ + "salut": "Alo", + "punctuație": ",", + "localizare": "mundo" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.handlebars new file mode 100644 index 00000000..b0549bea --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.handlebars @@ -0,0 +1 @@ +

    {{saludo}}{{puntuacion}} {{ubicacion}}

    \ No newline at end of file diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.json b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.json new file mode 100644 index 00000000..dcaa0b45 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/deep/spanish.json @@ -0,0 +1,5 @@ +{ + "saludo": "hola", + "puntuacion": ",", + "ubicacion": "mundo" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs1.json b/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs1.json new file mode 100644 index 00000000..aef1ded5 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs1.json @@ -0,0 +1,5 @@ +{ + "salutation": "Hello", + "punctuation": ",", + "location": "World" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs2.json b/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs2.json new file mode 100644 index 00000000..6f03fdb9 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/oneTemplateToManyOutputs2.json @@ -0,0 +1,5 @@ +{ + "salutation": "Hallo", + "punctuation": ",", + "location": "Welt" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/partials/foo.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/partials/foo.handlebars new file mode 100644 index 00000000..c871d1b5 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/partials/foo.handlebars @@ -0,0 +1 @@ +
    foo partial
    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/partials/pathTest.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/partials/pathTest.handlebars new file mode 100644 index 00000000..cd610e37 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/partials/pathTest.handlebars @@ -0,0 +1 @@ +
    full paths!!!
    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/post-dev.html b/vendor-src/grunt-compile-handlebars/test/fixtures/post-dev.html new file mode 100644 index 00000000..308b1d01 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/post-dev.html @@ -0,0 +1,2 @@ + + diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/pre-dev.html b/vendor-src/grunt-compile-handlebars/test/fixtures/pre-dev.html new file mode 100644 index 00000000..79531f75 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/pre-dev.html @@ -0,0 +1,10 @@ + + + + + static local + + + + +
    static local header
    diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishData.json b/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishData.json new file mode 100644 index 00000000..c8b428e1 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishData.json @@ -0,0 +1,5 @@ +{ + "salutation": "Hej", + "punctuation": ",", + "location": "Världen" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishTemplate.json b/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishTemplate.json new file mode 100644 index 00000000..85d78d46 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/sweedishTemplate.json @@ -0,0 +1,5 @@ +{ +   "hälsning": "{{salutation}}", +   "skiljetecken": "{{punctuation}}", +   "läge": "{{location}}" +} diff --git a/vendor-src/grunt-compile-handlebars/test/fixtures/template.handlebars b/vendor-src/grunt-compile-handlebars/test/fixtures/template.handlebars new file mode 100644 index 00000000..112f442c --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/fixtures/template.handlebars @@ -0,0 +1 @@ +

    {{salutation}}{{punctuation}} {{location}}

    diff --git a/vendor-src/grunt-compile-handlebars/test/globals/info.json b/vendor-src/grunt-compile-handlebars/test/globals/info.json new file mode 100644 index 00000000..ea6ca5d7 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/globals/info.json @@ -0,0 +1,7 @@ +{ + "templateName": "infoTemplate", + "author": "Written by Mr. HelloWorld", + "textspec": { + "hi": "Goodbye from info.json" + } +} diff --git a/vendor-src/grunt-compile-handlebars/test/globals/textspec.json b/vendor-src/grunt-compile-handlebars/test/globals/textspec.json new file mode 100644 index 00000000..e7714045 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/globals/textspec.json @@ -0,0 +1,6 @@ +{ + "templateName": "textspecTemplate", + "textspec": { + "hi": "Hello from textspec.json" + } +} diff --git a/vendor-src/grunt-compile-handlebars/test/helpers/super_helper.js b/vendor-src/grunt-compile-handlebars/test/helpers/super_helper.js new file mode 100644 index 00000000..1e11d6a8 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/helpers/super_helper.js @@ -0,0 +1,3 @@ +module.exports = function (context, option) { + return 'super helper!' +} diff --git a/vendor-src/grunt-compile-handlebars/test/index.html b/vendor-src/grunt-compile-handlebars/test/index.html new file mode 100644 index 00000000..12422255 --- /dev/null +++ b/vendor-src/grunt-compile-handlebars/test/index.html @@ -0,0 +1,12 @@ + + + + + local dev + + +
    local dev
    +

    + + + diff --git a/vendor-src/grunt-embed/.gitignore b/vendor-src/grunt-embed/.gitignore new file mode 100644 index 00000000..c5585fb4 --- /dev/null +++ b/vendor-src/grunt-embed/.gitignore @@ -0,0 +1,3 @@ +node_modules +tmp +yarn.lock diff --git a/vendor-src/grunt-embed/.travis.yml b/vendor-src/grunt-embed/.travis.yml new file mode 100644 index 00000000..244b7e88 --- /dev/null +++ b/vendor-src/grunt-embed/.travis.yml @@ -0,0 +1,3 @@ +language: node_js +node_js: + - '0.10' diff --git a/vendor-src/grunt-embed/Gruntfile.coffee b/vendor-src/grunt-embed/Gruntfile.coffee new file mode 100644 index 00000000..a7a830d0 --- /dev/null +++ b/vendor-src/grunt-embed/Gruntfile.coffee @@ -0,0 +1,49 @@ +### + grunt-embed + https://github.com/callumlocke/grunt-embed + + Copyright 2013 Callum Locke + Licensed under the MIT license. +### + +module.exports = (grunt) -> + + # Project configuration. + grunt.initConfig + + clean: + tests: ['tmp'] + + nodeunit: + tests: ['test/*_test.coffee'] + + embed: + default_options: + files: + 'tmp/default.html': 'test/fixtures/input.html' + + custom_options: + options: + threshold: '2kb' + stylesheets: false + files: + 'tmp/custom.html': 'test/fixtures/input.html' + + watch: + all: + files: [ + 'tasks/*.coffee' + 'test/*.coffee' + ] + tasks: ['test'] + + + grunt.loadTasks 'tasks' # this plugin's own tasks + grunt.loadNpmTasks task for task in [ + 'grunt-contrib-clean' + 'grunt-contrib-nodeunit' + 'grunt-contrib-watch' + ] + + grunt.registerTask 'test', ['clean', 'embed', 'nodeunit'] + grunt.registerTask 'default', ['watch'] diff --git a/vendor-src/grunt-embed/README.md b/vendor-src/grunt-embed/README.md new file mode 100644 index 00000000..9201f8ff --- /dev/null +++ b/vendor-src/grunt-embed/README.md @@ -0,0 +1,121 @@ +# grunt-embed + +[![Build Status](https://secure.travis-ci.org/callumlocke/grunt-embed.png?branch=master)](http://travis-ci.org/callumlocke/grunt-embed) [![Dependency Status](https://david-dm.org/callumlocke/grunt-embed.svg)](https://david-dm.org/callumlocke/grunt-embed) + +> This is a Grunt plugin wrapper around [resource-embedder](https://github.com/callumlocke/resource-embedder). + +Turns short external scripts and stylesheets into embedded ones: + +* `` becomes `` +* `` becomes `` + +The default behaviour is to embed anything under 5KB in size, but this threshold is configurable. + +**Should you embed your scripts?** Depends. Embedding reduces the number of HTTP requests, and can reduce blocking of subsequent requests and page rendering, but it also means the resources can't be cached individually and shared between pages. + +You should do your own measurements to work out if this is a good trade-off in your situation. But, as a guide: short, blocking scripts in the head are often a good candidate for embedding. + +A small Modernizr build is a good example: if it's embedded (as a script before your main stylesheet), it will have been executed and applied any special CSS classes to the `` tag before your styles are received. Then as soon as the styles are received, any subsequent background-image downloads can be started immediately, because Modernizr's classes will already have been added to the `` tag. + + +## Getting Started + +This plugin requires [Grunt](http://gruntjs.com/) (see [Getting Started](http://gruntjs.com/getting-started)). + +Install: + +```shell +npm install grunt-embed --save-dev +``` + +Load the task in your Gruntfile: + +```js +grunt.loadNpmTasks('grunt-embed'); +``` + + +## The "embed" task + +### Overview + +In your Gruntfile, add a section named `embed` to the data object passed into `grunt.initConfig()`. + +```js +grunt.initConfig({ + embed: { + options: { + // Task-specific options go here. + }, + your_target: { + // Target-specific file lists and/or options go here. + }, + }, +}) +``` + +### Options + +Any options will be passed through to `resource-embedder` – see [full list of options](https://github.com/callumlocke/resource-embedder#options). + +### Usage Examples + +#### Default Options + +Embed any external scripts and stylesheets under 5KB in size (the default threshold): + +```js +grunt.initConfig({ + embed: { + some_target: { + files: { + 'dest/output.html': 'src/input.html' + } + } + } +}) +``` + +#### Custom Options + +Custom threshold – embed anything under 3KB in size: + +```js +grunt.initConfig({ + embed: { + options: { + threshold: '3KB' + }, + some_target: { + files: { + 'dest/output.html': 'src/input.html' + } + } + } +}) +``` + +#### Overriding the options for a given script/stylesheet + +You can use `data-embed` attributes to override the options for an individual resource. + +```html + + + +``` + + +## Contributing + +In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [Grunt](http://gruntjs.com/). + + +## Release History + +_(Nothing yet)_ + + +## License + +Copyright (c) 2013 Callum Locke. Licensed under the MIT license. diff --git a/vendor-src/grunt-embed/package.json b/vendor-src/grunt-embed/package.json new file mode 100644 index 00000000..cac93bd1 --- /dev/null +++ b/vendor-src/grunt-embed/package.json @@ -0,0 +1,49 @@ +{ + "private": true, + "name": "grunt-embed", + "version": "1.0.0", + "description": "Grunt plugin to convert external scripts and stylesheets into embedded ones.", + "homepage": "https://github.com/anvilco/grunt-embed", + "bugs": "https://github.com/anvilco/grunt-embed/issues", + "author": { + "name": "Callum Locke", + "url": "https://github.com/callumlocke" + }, + "repository": { + "type": "git", + "url": "https://github.com/anvilco/grunt-embed.git" + }, + "licenses": [ + { + "type": "MIT" + } + ], + "keywords": [ + "gruntplugin" + ], + "engines": { + "node": ">=14" + }, + "main": "Gruntfile.js", + "scripts": { + "test": "grunt test" + }, + "files": [ + "package.json", + "README.md", + "Gruntfile.coffee", + "tasks/", + "!**/.DS_STORE", + "!**/.DS_Store" + ], + "devDependencies": { + "grunt": "^1.5.3", + "grunt-cli": "~0.1.9", + "grunt-contrib-clean": "~0.5.0", + "grunt-contrib-watch": "~0.5.3", + "grunt-contrib-nodeunit": "~0.2.0" + }, + "peerDependencies": { + "grunt": "^1.5.3" + } +} diff --git a/vendor-src/grunt-embed/tasks/embed.coffee b/vendor-src/grunt-embed/tasks/embed.coffee new file mode 100644 index 00000000..f7c008c7 --- /dev/null +++ b/vendor-src/grunt-embed/tasks/embed.coffee @@ -0,0 +1,34 @@ +### + grunt-embed + https://github.com/callumlocke/grunt-embed + + Copyright 2013 Callum Locke + Licensed under the MIT license. +### + +ResourceEmbedder = require '../../resource-embedder' +path = require 'path' + +module.exports = (grunt) -> + + grunt.registerMultiTask 'embed', 'Converts external scripts and stylesheets into embedded ones.', -> + done = @async() + + @files.forEach (file) => + srcFile = file.orig.src + if typeof srcFile isnt 'string' + if srcFile.length > 1 + grunt.log.warn 'Multiple source files supplied; only the first will be used.' + srcFile = srcFile[0] + + if not grunt.file.exists srcFile + grunt.log.warn "Source file \"#{path.resolve(srcFile)}\" not found." + + else + embedder = new ResourceEmbedder srcFile, @options() + embedder.get (output, warnings) -> + grunt.file.write file.dest, output + if warnings? + grunt.log.warn warning for warning in warnings + grunt.log.ok "File \"#{file.dest}\" created." + done() diff --git a/vendor-src/grunt-embed/test/embed_test.coffee b/vendor-src/grunt-embed/test/embed_test.coffee new file mode 100644 index 00000000..07336bf4 --- /dev/null +++ b/vendor-src/grunt-embed/test/embed_test.coffee @@ -0,0 +1,20 @@ +grunt = require 'grunt' + +exports.embed = + setUp: (done) -> + # setup here if necessary + done() + + default_options: (test) -> + test.expect 1 + actual = grunt.file.read 'tmp/default.html' + expected = grunt.file.read 'test/expected/default.html' + test.equal actual, expected, 'should embed resources correctly with default options.' + test.done() + + custom_options: (test) -> + test.expect 1 + actual = grunt.file.read 'tmp/custom.html' + expected = grunt.file.read 'test/expected/custom.html' + test.equal actual, expected, 'should embed resources correctly with custom options.' + test.done() diff --git a/vendor-src/grunt-embed/test/expected/custom.html b/vendor-src/grunt-embed/test/expected/custom.html new file mode 100644 index 00000000..a8a7e153 --- /dev/null +++ b/vendor-src/grunt-embed/test/expected/custom.html @@ -0,0 +1,13 @@ + + + Hello + + + + +

    Hi

    + + + + + diff --git a/vendor-src/grunt-embed/test/expected/default.html b/vendor-src/grunt-embed/test/expected/default.html new file mode 100644 index 00000000..ee03ca52 --- /dev/null +++ b/vendor-src/grunt-embed/test/expected/default.html @@ -0,0 +1,18 @@ + + + Hello + + + + +

    Hi

    + + + + + diff --git a/vendor-src/grunt-embed/test/fixtures/input.html b/vendor-src/grunt-embed/test/fixtures/input.html new file mode 100644 index 00000000..416afcda --- /dev/null +++ b/vendor-src/grunt-embed/test/fixtures/input.html @@ -0,0 +1,13 @@ + + + Hello + + + + +

    Hi

    + + + + + diff --git a/vendor-src/grunt-embed/test/fixtures/scripts/log.js b/vendor-src/grunt-embed/test/fixtures/scripts/log.js new file mode 100644 index 00000000..22674cfc --- /dev/null +++ b/vendor-src/grunt-embed/test/fixtures/scripts/log.js @@ -0,0 +1 @@ +console.log('Something'); diff --git a/vendor-src/grunt-embed/test/fixtures/scripts/modernizr.js b/vendor-src/grunt-embed/test/fixtures/scripts/modernizr.js new file mode 100644 index 00000000..bd4325fb --- /dev/null +++ b/vendor-src/grunt-embed/test/fixtures/scripts/modernizr.js @@ -0,0 +1,4 @@ +/* Modernizr 2.6.2 (Custom Build) | MIT & BSD + * Build: http://modernizr.com/download/#-shiv-cssclasses + */ +;window.Modernizr=function(a,b,c){function u(a){j.cssText=a}function v(a,b){return u(prefixes.join(a+";")+(b||""))}function w(a,b){return typeof a===b}function x(a,b){return!!~(""+a).indexOf(b)}function y(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:w(f,"function")?f.bind(d||b):f}return!1}var d="2.6.2",e={},f=!0,g=b.documentElement,h="modernizr",i=b.createElement(h),j=i.style,k,l={}.toString,m={},n={},o={},p=[],q=p.slice,r,s={}.hasOwnProperty,t;!w(s,"undefined")&&!w(s.call,"undefined")?t=function(a,b){return s.call(a,b)}:t=function(a,b){return b in a&&w(a.constructor.prototype[b],"undefined")},Function.prototype.bind||(Function.prototype.bind=function(b){var c=this;if(typeof c!="function")throw new TypeError;var d=q.call(arguments,1),e=function(){if(this instanceof e){var a=function(){};a.prototype=c.prototype;var f=new a,g=c.apply(f,d.concat(q.call(arguments)));return Object(g)===g?g:f}return c.apply(b,d.concat(q.call(arguments)))};return e});for(var z in m)t(m,z)&&(r=z.toLowerCase(),e[r]=m[z](),p.push((e[r]?"":"no-")+r));return e.addTest=function(a,b){if(typeof a=="object")for(var d in a)t(a,d)&&e.addTest(d,a[d]);else{a=a.toLowerCase();if(e[a]!==c)return e;b=typeof b=="function"?b():b,typeof f!="undefined"&&f&&(g.className+=" "+(b?"":"no-")+a),e[a]=b}return e},u(""),i=k=null,function(a,b){function k(a,b){var c=a.createElement("p"),d=a.getElementsByTagName("head")[0]||a.documentElement;return c.innerHTML="x",d.insertBefore(c.lastChild,d.firstChild)}function l(){var a=r.elements;return typeof a=="string"?a.split(" "):a}function m(a){var b=i[a[g]];return b||(b={},h++,a[g]=h,i[h]=b),b}function n(a,c,f){c||(c=b);if(j)return c.createElement(a);f||(f=m(c));var g;return f.cache[a]?g=f.cache[a].cloneNode():e.test(a)?g=(f.cache[a]=f.createElem(a)).cloneNode():g=f.createElem(a),g.canHaveChildren&&!d.test(a)?f.frag.appendChild(g):g}function o(a,c){a||(a=b);if(j)return a.createDocumentFragment();c=c||m(a);var d=c.frag.cloneNode(),e=0,f=l(),g=f.length;for(;e",f="hidden"in a,j=a.childNodes.length==1||function(){b.createElement("a");var a=b.createDocumentFragment();return typeof a.cloneNode=="undefined"||typeof a.createDocumentFragment=="undefined"||typeof a.createElement=="undefined"}()}catch(c){f=!0,j=!0}})();var r={elements:c.elements||"abbr article aside audio bdi canvas data datalist details figcaption figure footer header hgroup mark meter nav output progress section summary time video",shivCSS:c.shivCSS!==!1,supportsUnknownElements:j,shivMethods:c.shivMethods!==!1,type:"default",shivDocument:q,createElement:n,createDocumentFragment:o};a.html5=r,q(b)}(this,b),e._version=d,g.className=g.className.replace(/(^|\s)no-js(\s|$)/,"$1$2")+(f?" js "+p.join(" "):""),e}(this,this.document); diff --git a/vendor-src/grunt-embed/test/fixtures/stylesheets/reset.css b/vendor-src/grunt-embed/test/fixtures/stylesheets/reset.css new file mode 100644 index 00000000..87df8360 --- /dev/null +++ b/vendor-src/grunt-embed/test/fixtures/stylesheets/reset.css @@ -0,0 +1,48 @@ +/* http://meyerweb.com/eric/tools/css/reset/ + v2.0 | 20110126 + License: none (public domain) +*/ + +html, body, div, span, applet, object, iframe, +h1, h2, h3, h4, h5, h6, p, blockquote, pre, +a, abbr, acronym, address, big, cite, code, +del, dfn, em, img, ins, kbd, q, s, samp, +small, strike, strong, sub, sup, tt, var, +b, u, i, center, +dl, dt, dd, ol, ul, li, +fieldset, form, label, legend, +table, caption, tbody, tfoot, thead, tr, th, td, +article, aside, canvas, details, embed, +figure, figcaption, footer, header, hgroup, +menu, nav, output, ruby, section, summary, +time, mark, audio, video { + margin: 0; + padding: 0; + border: 0; + font-size: 100%; + font: inherit; + vertical-align: baseline; +} +/* HTML5 display-role reset for older browsers */ +article, aside, details, figcaption, figure, +footer, header, hgroup, menu, nav, section { + display: block; +} +body { + line-height: 1; +} +ol, ul { + list-style: none; +} +blockquote, q { + quotes: none; +} +blockquote:before, blockquote:after, +q:before, q:after { + content: ''; + content: none; +} +table { + border-collapse: collapse; + border-spacing: 0; +} diff --git a/vendor-src/grunt-embed/test/fixtures/stylesheets/tiny.css b/vendor-src/grunt-embed/test/fixtures/stylesheets/tiny.css new file mode 100644 index 00000000..31fc5b8a --- /dev/null +++ b/vendor-src/grunt-embed/test/fixtures/stylesheets/tiny.css @@ -0,0 +1 @@ +body { background: red; } diff --git a/vendor-src/grunt-prettify/.gitattributes b/vendor-src/grunt-prettify/.gitattributes new file mode 100644 index 00000000..759c2c5a --- /dev/null +++ b/vendor-src/grunt-prettify/.gitattributes @@ -0,0 +1,14 @@ +# Enforce Unix newlines +*.* text eol=lf +*.css text eol=lf +*.html text eol=lf +*.js text eol=lf +*.json text eol=lf +*.less text eol=lf +*.md text eol=lf +*.yml text eol=lf + +*.jpg binary +*.gif binary +*.png binary +*.jpeg binary \ No newline at end of file diff --git a/vendor-src/grunt-prettify/.gitignore b/vendor-src/grunt-prettify/.gitignore new file mode 100644 index 00000000..c5bf9f62 --- /dev/null +++ b/vendor-src/grunt-prettify/.gitignore @@ -0,0 +1,56 @@ +node_modules +tmp +yarn.lock + +# Numerous always-ignore extensions +*.csv +*.dat +*.diff +*.err +*.gz +*.log +*.orig +*.out +*.pid +*.rar +*.rej +*.seed +*.swo +*.swp +*.vi +*.yo-rc.json +*.zip +*~ +.ruby-version +lib-cov +npm-debug.log + +# Always-ignore dirs +/bower_components/ +/node_modules/ +/temp/ +/tmp/ +/vendor/ +_gh_pages + +# OS or Editor folders +*.esproj +*.komodoproject +.komodotools +*.sublime-* +._* +.cache +.DS_Store +.idea +.project +.settings +.tmproj +nbproject +Thumbs.db + +# grunt-html-validation +validation-status.json +validation-report.json + +# misc +TODO.md diff --git a/vendor-src/grunt-prettify/.jsbeautifyrc b/vendor-src/grunt-prettify/.jsbeautifyrc new file mode 100644 index 00000000..6487d4fd --- /dev/null +++ b/vendor-src/grunt-prettify/.jsbeautifyrc @@ -0,0 +1,48 @@ +{ + "brace_style": "collapse", + "indent_char": " ", + "indent_inner_html": true, + "indent_scripts": "keep", + "indent_size": 2, + "max_preserve_newlines": 0, + "preserve_newlines": true, + "wrap_line_length": 0, + "unformatted": [ + "a", + "abbr", + "acronym", + "address", + "b", + "bdo", + "big", + "cite", + "code", + "del", + "dfn", + "dt", + "em", + "font", + "h1", + "h2", + "h3", + "h4", + "h5", + "h6", + "i", + "ins", + "kbd", + "pre", + "q", + "s", + "samp", + "small", + "span", + "strike", + "strong", + "sub", + "sup", + "tt", + "u", + "var" + ] +} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/.jshintrc b/vendor-src/grunt-prettify/.jshintrc new file mode 100644 index 00000000..e4104fea --- /dev/null +++ b/vendor-src/grunt-prettify/.jshintrc @@ -0,0 +1,22 @@ +{ + "esnext": true, + "boss": true, + "curly": true, + "eqeqeq": true, + "eqnull": true, + "immed": true, + "latedef": true, + "newcap": true, + "noarg": true, + "node": true, + "sub": true, + "undef": true, + "unused": true, + "globals": { + "define": true, + "before": true, + "after": true, + "describe": true, + "it": true + } +} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/.travis.yml b/vendor-src/grunt-prettify/.travis.yml new file mode 100644 index 00000000..a5c1b7d4 --- /dev/null +++ b/vendor-src/grunt-prettify/.travis.yml @@ -0,0 +1,6 @@ +language: node_js +node_js: + - "0.8" +before_script: + - npm install -g grunt-cli + - npm install grunt diff --git a/vendor-src/grunt-prettify/.verbrc.md b/vendor-src/grunt-prettify/.verbrc.md new file mode 100644 index 00000000..11cb5cda --- /dev/null +++ b/vendor-src/grunt-prettify/.verbrc.md @@ -0,0 +1,32 @@ +# {%= name %} {%= badge("fury") %} + +> {%= description %} + +## Install +{%= include("install") %} + +Once the plugin has been installed, add the following line to your Gruntfile: + +```js +grunt.loadNpmTasks('grunt-prettify'); +``` + +### Overview +{%= docs("overview") %} + +### Options +{%= docs("options") %} + +## Usage Examples +{%= docs("examples") %} + +## Author +{%= include("author") %} + +## License +{%= copyright() %} +{%= license() %} + +*** + +{%= include("footer") %} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/CHANGELOG b/vendor-src/grunt-prettify/CHANGELOG new file mode 100644 index 00000000..1f86ac8b --- /dev/null +++ b/vendor-src/grunt-prettify/CHANGELOG @@ -0,0 +1,18 @@ +v0.3.0: + date: "2013-11-25" + changes: + - Adds option to preserve byte-order marks in output. + - General task improvements +v0.2.7: + date: "2013-08-18" + changes: + - Options updated to use new config option from js-beautify. +v0.1.1: + date: "2013-04-21" + changes: + - Create plugin, run tests. + - Add assemble task to generate test HTML from templates. +v0.1.0: + date: "2013-04-21" + changes: + - First commit. diff --git a/vendor-src/grunt-prettify/CONTRIBUTING.md b/vendor-src/grunt-prettify/CONTRIBUTING.md new file mode 100644 index 00000000..c9ff6c81 --- /dev/null +++ b/vendor-src/grunt-prettify/CONTRIBUTING.md @@ -0,0 +1 @@ +Please see the [Contributing to Assemble](http://assemble.io/contributing) guide for information on contributing to this project. diff --git a/vendor-src/grunt-prettify/Gruntfile.js b/vendor-src/grunt-prettify/Gruntfile.js new file mode 100644 index 00000000..c2c1b617 --- /dev/null +++ b/vendor-src/grunt-prettify/Gruntfile.js @@ -0,0 +1,112 @@ +/* + * grunt-prettify + * https://github.com/jonschlinkert/grunt-prettify + * + * Copyright (c) 2013 Jon Schlinkert + * Licensed under the MIT license. + */ + +'use strict'; + +module.exports = function(grunt) { + + // Project configuration. + grunt.initConfig({ + + // Lint. + jshint: { + options: {jshintrc: '.jshintrc'}, + all: [ + 'Gruntfile.js', + 'tasks/*.js' + ] + }, + + // Build HTML for tests. + assemble: { + options: { + flatten: true, + assets: 'test/actual/assets', + data: 'test/fixtures/data/*.{json,yml}', + partials: 'test/fixtures/includes/*.hbs', + layoutdir: 'test/fixtures/layouts', + layout: 'default.hbs' + }, + pages: { + src: ['test/fixtures/pages/*.{hbs,md}'], + dest: 'test/actual/ugly/' + } + }, + + prettify: { + options: { + ocd: true + }, + // Prettify a single file + single: { + src: 'test/actual/ugly/index.html', + dest: 'test/actual/single/index.html' + }, + // Use defaults + defaults: { + files: [ + {expand: true, cwd: 'test/actual/ugly/', src: ['*.html'], dest: 'test/actual/defaults/', ext: '.html'} + ] + }, + // Use .jsbeautifyrc + jsbeautifyrc: { + options: { + config: '.jsbeautifyrc' + }, + files: [ + {expand: true, cwd: 'test/actual/ugly/', src: ['*.html'], dest: 'test/actual/jsbeautifyrc/', ext: '.html'} + ] + }, + // Indent by 6 spaces + custom_indentation: { + options: { + config: '.jsbeautifyrc' + }, + src: 'test/actual/ugly/index.html', + dest: 'test/actual/single/index.html' + }, + // Use condense option to reduce extra newlines + condense: { + files: [ + {expand: true, cwd: 'test/actual/ugly/', src: ['*.html'], dest: 'test/actual/custom_indentation/', ext: '.html'} + ] + }, + // Specify a number to padcomments + padcomments: { + options: { + padcomments: 3 + }, + files: [ + {expand: true, cwd: 'test/actual/ugly/', src: ['*.html'], dest: 'test/actual/padcomments/', ext: '.html'} + ] + } + }, + + // Before generating any new files, + // remove files from previous build. + clean: { + dest: { + src: ['test/actual/**/*.html'] + } + } + }); + + // Actually load this plugin. + grunt.loadTasks('tasks'); + + // Load npm plugins to provide necessary tasks. + grunt.loadNpmTasks('assemble'); + grunt.loadNpmTasks('grunt-contrib-jshint'); + grunt.loadNpmTasks('grunt-contrib-clean'); + grunt.loadNpmTasks('grunt-readme'); + + grunt.registerTask('test', ['jshint', 'prettify']); + + // By default, lint and run all tests. + grunt.registerTask('default', ['jshint', 'clean', 'assemble', 'prettify', 'readme']); +}; diff --git a/vendor-src/grunt-prettify/LICENSE-MIT b/vendor-src/grunt-prettify/LICENSE-MIT new file mode 100644 index 00000000..e25dca2f --- /dev/null +++ b/vendor-src/grunt-prettify/LICENSE-MIT @@ -0,0 +1,22 @@ +Copyright (c) 2014 Jon Schlinkert + +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. diff --git a/vendor-src/grunt-prettify/README.md b/vendor-src/grunt-prettify/README.md new file mode 100644 index 00000000..02f07a50 --- /dev/null +++ b/vendor-src/grunt-prettify/README.md @@ -0,0 +1,231 @@ +# grunt-prettify [![NPM version](https://badge.fury.io/js/grunt-prettify.svg)](http://badge.fury.io/js/grunt-prettify) + + +> HTML prettifier with options to format HTML according to your own preferences. + +## Install +#### Install with [npm](npmjs.org): + +```bash +npm i grunt-prettify --save-dev +``` + +Once the plugin has been installed, add the following line to your Gruntfile: + +```js +grunt.loadNpmTasks('grunt-prettify'); +``` + +### Overview +In your project's Gruntfile, add a section named `prettify` to the data object passed into `grunt.initConfig()`. + +```javascript +grunt.initConfig({ + prettify: { + options: { + // Task-specific options go here. + }, + html: { + // Target-specific file lists and/or options go here. + } + } +}); +``` + +### Options +#### config +Type: `String` +Default value: `null` + +Path to `.jsbeautifyrc`. If this option is specified, options defined therein will be used. The `.jsbeautifyrc` file must be valid JSON and looks something like this: + +```json +{ + "indent": 4, + "condense": true, + "indent_inner_html": true, + "unformatted": [ + "a", + "pre" + ] +} +``` + +Note that options defined in `.jsbeautifyrc` override the default options, and options defined in the Gruntfile override all other options. + +#### condense +Type: `Boolean` +Default value: `true` + +Removes extra newlines and retains indenting. + +#### preserveBOM +Type: `Boolean` +Default value: `false` + +Preserve byte-order marks that might exist. Also see the [Grunt.js source](https://github.com/gruntjs/grunt/blob/master/lib/grunt/file.js#L217). + +#### padcomments +Type: `Boolean|Number` +Default value: `false` + +Add newlines above each code comment. For backwards compatibility, you may set to `true` to add a single newline, or specify the number of newlines you want to add. + +#### indent +Type: `Number` +Default value: `2` + +The indentation size to be used on the output HTML. This is an alias for `indent_size`. So either `indent` or `indent_size` may be used. + +#### indent_char +Type: `String` +Default value: `' '` (space) +Options: `space`|`tab` (use an actual space or tab, not the word) + +Character with which to indent the output HTML. + +#### indent_scripts +Type: `String` +Default value: `keep` +Options: `keep`|`separate`|`normal` + +The indentation character to use to indent the output HTML. + +#### indent_inner_html +Type: `Boolean` +Default value: `true` + +Indent `` and `` sections. + +#### brace_style +Type: `String` +Default value: `expand` + +Options: + +* `collapse`: (default) puts braces on the same line as control statements +* `expand`: put all braces on their own lines (Allman / ANSI style) +* `end-expand`: put _end_ braces only on their own line. + +#### wrap_line_length +Type: `Number` +Default value: `0` (disabled) + +Maximum characters per line. `0` disables, max is `250`. + +#### preserve_newlines +Type: `Boolean` +Default value: `false` + +Preserve existing line-breaks. + +#### max_preserve_newlines +Type: `Number` +Default value: `unlimited` + +Maximum number of consecutive line-breaks to be preserved. + +#### unformatted +Type: `String|Array` +Default value: `["pre", "code"]` + +Array of tags that should not be re-formatted in the output. Defaults to inline. + +_Attention:_ Make sure you play around with the settings and view the HTML in the browser. Pay special attention to whitespace around links and other inline elements, such as `` and ``. If you specify a list of elements to remain `unformatted`, you will definitely need to make sure that whitepace is rendering the way you want it to. + +## Usage Examples +### Default Options +The default setup in this project's Gruntfile uses an external `.prettifyrc` file for controlling the task's options. + +```js +grunt.initConfig({ + prettify: { + options: { + config: '.prettifyrc' + }, + files: { + 'pretty/index.html': ['ugly/index.html'] + } + } +}); +``` + +The default options are set to: + +``` json +{ + "indent": 2, + "indent_char": " ", + "indent_scripts": "normal", + "wrap_line_length": 0, + "brace_style": "collapse", + "preserve_newlines": true, + "max_preserve_newlines": 1, + "unformatted": [ + "a", + "code", + "pre" + ] +} +``` + +### Custom Options + +You can also specify the options in the Gruntfile if you wish, like this: + +```js +prettify: { + options: { + indent: 2, + indent_char: ' ', + wrap_line_length: 78, + brace_style: 'expand', + unformatted: ['a', 'sub', 'sup', 'b', 'i', 'u'] + }, + ... +} +``` + +Example configurations for prettifying one file at a time, or entire directories of files: + +```js +prettify: { + options: { + config: '.prettifyrc' + }, + // Prettify a directory of files + all: { + expand: true, + cwd: 'test/actual/ugly/', + ext: '.html', + src: ['*.html'], + dest: 'test/actual/pretty/' + }, + // Or prettify one file at a time using the "files object" format + files: { + 'pretty/index.html': ['ugly/index.html'] + }, + // Or the "compact" src-dest format + one: { + src: 'test/actual/ugly/index.html', + dest: 'test/actual/pretty/index.html' + } +} +``` + +See the [grunt][] docs for more information about task configuration. + +## Author + +**jonschlinkert** + ++ [github/jonschlinkert](https://github.com/jonschlinkert) ++ [twitter/jonschlinkert](http://twitter.com/jonschlinkert) + +## License +Copyright (c) 2014 jonschlinkert, contributors. +Released under the MIT license + +*** + +_This file was generated by [verb-cli](https://github.com/assemble/verb-cli) on October 10, 2014._ \ No newline at end of file diff --git a/vendor-src/grunt-prettify/docs/examples.md b/vendor-src/grunt-prettify/docs/examples.md new file mode 100644 index 00000000..5d80930f --- /dev/null +++ b/vendor-src/grunt-prettify/docs/examples.md @@ -0,0 +1,80 @@ +## Default Options +The default setup in this project's Gruntfile uses an external `.prettifyrc` file for controlling the task's options. + +```js +grunt.initConfig({ + prettify: { + options: { + config: '.prettifyrc' + }, + files: { + 'pretty/index.html': ['ugly/index.html'] + } + } +}); +``` + +The default options are set to: + +``` json +{ + "indent": 2, + "indent_char": " ", + "indent_scripts": "normal", + "wrap_line_length": 0, + "brace_style": "collapse", + "preserve_newlines": true, + "max_preserve_newlines": 1, + "unformatted": [ + "a", + "code", + "pre" + ] +} +``` + +## Custom Options + +You can also specify the options in the Gruntfile if you wish, like this: + +```js +prettify: { + options: { + indent: 2, + indent_char: ' ', + wrap_line_length: 78, + brace_style: 'expand', + unformatted: ['a', 'sub', 'sup', 'b', 'i', 'u'] + }, + ... +} +``` + +Example configurations for prettifying one file at a time, or entire directories of files: + +```js +prettify: { + options: { + config: '.prettifyrc' + }, + // Prettify a directory of files + all: { + expand: true, + cwd: 'test/actual/ugly/', + ext: '.html', + src: ['*.html'], + dest: 'test/actual/pretty/' + }, + // Or prettify one file at a time using the "files object" format + files: { + 'pretty/index.html': ['ugly/index.html'] + }, + // Or the "compact" src-dest format + one: { + src: 'test/actual/ugly/index.html', + dest: 'test/actual/pretty/index.html' + } +} +``` + +See the [grunt][] docs for more information about task configuration. \ No newline at end of file diff --git a/vendor-src/grunt-prettify/docs/options.md b/vendor-src/grunt-prettify/docs/options.md new file mode 100644 index 00000000..8534878b --- /dev/null +++ b/vendor-src/grunt-prettify/docs/options.md @@ -0,0 +1,99 @@ +### config +Type: `String` +Default value: `null` + +Path to `.jsbeautifyrc`. If this option is specified, options defined therein will be used. The `.jsbeautifyrc` file must be valid JSON and looks something like this: + +```json +{ + "indent": 4, + "condense": true, + "indent_inner_html": true, + "unformatted": [ + "a", + "pre" + ] +} +``` + +Note that options defined in `.jsbeautifyrc` override the default options, and options defined in the Gruntfile override all other options. + +### condense +Type: `Boolean` +Default value: `true` + +Removes extra newlines and retains indenting. + +### preserveBOM +Type: `Boolean` +Default value: `false` + +Preserve byte-order marks that might exist. Also see the [Grunt.js source](https://github.com/gruntjs/grunt/blob/master/lib/grunt/file.js#L217). + +### padcomments +Type: `Boolean|Number` +Default value: `false` + +Add newlines above each code comment. For backwards compatibility, you may set to `true` to add a single newline, or specify the number of newlines you want to add. + +### indent +Type: `Number` +Default value: `2` + +The indentation size to be used on the output HTML. This is an alias for `indent_size`. So either `indent` or `indent_size` may be used. + +### indent_char +Type: `String` +Default value: `' '` (space) +Options: `space`|`tab` (use an actual space or tab, not the word) + +Character with which to indent the output HTML. + +### indent_scripts +Type: `String` +Default value: `keep` +Options: `keep`|`separate`|`normal` + +The indentation character to use to indent the output HTML. + +### indent_inner_html +Type: `Boolean` +Default value: `true` + +Indent `` and `` sections. + +### brace_style +Type: `String` +Default value: `expand` + +Options: + +* `collapse`: (default) puts braces on the same line as control statements +* `expand`: put all braces on their own lines (Allman / ANSI style) +* `end-expand`: put _end_ braces only on their own line. + +### wrap_line_length +Type: `Number` +Default value: `0` (disabled) + +Maximum characters per line. `0` disables, max is `250`. + +### preserve_newlines +Type: `Boolean` +Default value: `false` + +Preserve existing line-breaks. + +### max_preserve_newlines +Type: `Number` +Default value: `unlimited` + +Maximum number of consecutive line-breaks to be preserved. + +### unformatted +Type: `String|Array` +Default value: `["pre", "code"]` + +Array of tags that should not be re-formatted in the output. Defaults to inline. + +_Attention:_ Make sure you play around with the settings and view the HTML in the browser. Pay special attention to whitespace around links and other inline elements, such as `` and ``. If you specify a list of elements to remain `unformatted`, you will definitely need to make sure that whitepace is rendering the way you want it to. \ No newline at end of file diff --git a/vendor-src/grunt-prettify/docs/overview.md b/vendor-src/grunt-prettify/docs/overview.md new file mode 100644 index 00000000..7d82ad15 --- /dev/null +++ b/vendor-src/grunt-prettify/docs/overview.md @@ -0,0 +1,14 @@ +In your project's Gruntfile, add a section named `prettify` to the data object passed into `grunt.initConfig()`. + +```javascript +grunt.initConfig({ + prettify: { + options: { + // Task-specific options go here. + }, + html: { + // Target-specific file lists and/or options go here. + } + } +}); +``` \ No newline at end of file diff --git a/vendor-src/grunt-prettify/docs/quickstart.md b/vendor-src/grunt-prettify/docs/quickstart.md new file mode 100644 index 00000000..1a98297e --- /dev/null +++ b/vendor-src/grunt-prettify/docs/quickstart.md @@ -0,0 +1,13 @@ +This plugin requires Grunt `~0.4.1` + +If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command: + +```shell +npm install grunt-prettify --save-dev +``` + +Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript: + +```js +grunt.loadNpmTasks('grunt-prettify'); +``` \ No newline at end of file diff --git a/vendor-src/grunt-prettify/package.json b/vendor-src/grunt-prettify/package.json new file mode 100644 index 00000000..ac0cf06e --- /dev/null +++ b/vendor-src/grunt-prettify/package.json @@ -0,0 +1,73 @@ +{ + "private": true, + "name": "grunt-prettify", + "description": "HTML prettifier with options to format HTML according to your own preferences.", + "version": "1.0.0", + "homepage": "https://github.com/jonschlinkert/grunt-prettify", + "author": { + "name": "jonschlinkert", + "url": "http://github.com/jonschlinkert/" + }, + "repository": { + "type": "git", + "url": "https://github.com/jonschlinkert/grunt-prettify.git" + }, + "bugs": { + "url": "https://github.com/jonschlinkert/grunt-prettify/issues" + }, + "licenses": [ + { + "type": "MIT", + "url": "https://github.com/jonschlinkert/grunt-prettify/blob/master/LICENSE-MIT" + } + ], + "keywords": [ + "beautifier", + "beautify", + "code", + "format", + "formatter", + "formatting", + "grunt", + "gruntplugin", + "html", + "indent", + "indenter", + "plugin", + "prettifier", + "prettify" + ], + "main": "Gruntfile.js", + "engines": { + "node": ">=14" + }, + "scripts": { + "test": "grunt test" + }, + "files": [ + "package.json", + "README.md", + "Gruntfile.js", + ".jsbeautifyrc", + "tasks/", + "!**/.DS_STORE", + "!**/.DS_Store" + ], + "devDependencies": { + "assemble": "~0.4.27", + "fast-glob": "^3.2.12", + "grunt": "^1.5.3", + "grunt-contrib-clean": "~0.5.0", + "grunt-contrib-jshint": "~0.7.2", + "js-beautify": "~1.5.4", + "lodash": "^4.17.21", + "mocha": "*", + "verb": ">= 0.2.6" + }, + "peerDependencies": { + "fast-glob": "^3.2.12", + "grunt": "^1.5.3", + "js-beautify": "~1.5.4", + "lodash": "^4.17.21" + } +} diff --git a/vendor-src/grunt-prettify/tasks/prettify.js b/vendor-src/grunt-prettify/tasks/prettify.js new file mode 100644 index 00000000..4fcddd0b --- /dev/null +++ b/vendor-src/grunt-prettify/tasks/prettify.js @@ -0,0 +1,138 @@ +/*! + * grunt-prettify + * + * Copyright (c) 2014 Jon Schlinkert + * Licensed under the MIT license. + */ + +'use strict'; + +/** + * Module dependencies + */ + +var fs = require('fs'); +var fastGlob = require('fast-glob'); +var prettify = require('js-beautify').html; +var _ = require('lodash'); + +module.exports = function (grunt) { + + grunt.task.registerMultiTask('prettify', 'Prettify HTML.', function () { + // Merge task-specific and/or target-specific options with these defaults. + var opts = this.options({ + // Custom options + indent_size: 2, + condense: true, + padcomments: false, + preserveBOM: false, + + // js-beautify options + indent_char: " ", + indent_inner_html: true, + indent_scripts: "keep", + brace_style: "expand", + preserve_newline: false, + max_preserve_newline: 0, + wrap_line_length: 0 + }); + + // Extend default options with options from specified .jsbeautifyrc file + if (opts.config) { + opts = _.extend(opts, grunt.file.readJSON(opts.config)); + } + + // If user has used alias for indent_size + if (!_.isUndefined(opts.indent)) { + opts.indent_size = opts.indent; + } + + this.files.forEach(function (fp) { + var files = fastGlob.sync(fp.src); + var html = files.map(read).join(opts.separator); + var str = prettify(html, opts); + + // Reduce multiple newlines to a single newline + if (opts.condense === true) { + str = condense(str); + } + + // Use at your own risk. This option will slow down the build. + // What does "ocd" mean? Just look at the function, then lookup + // ocd on wikipedia. + if (opts.ocd === true) { + str = ocd(str); + } + + // Add a single newline above code comments. + if (opts.padcomments === true) { + str = padcomments(str, 1); + } + + if (_.isNumber(opts.padcomments)) { + str = padcomments(str, opts.padcomments); + } + + if (str.length < 1) { + grunt.log.warn('Destination not written because dest file was empty.'); + } else { + // Write the destination file. + grunt.file.write(fp.dest, str); + // Print a success message. + grunt.log.ok('File "' + fp.dest + '" prettified.'); + } + }); + }); + + function read(fp) { + var str = fs.readFileSync(fp, 'utf8'); + str = normalize(str); + return stripBOM(str); + } + + function normalize(str) { + return str.replace(/\r/g, ''); + } + + function stripBOM(str) { + if (str.charCodeAt(0) === 0xFEFF) { + return str.slice(1); + } + return str; + } + + // Normalize and condense all newlines + function condense(str) { + return str.replace(/(\r\n|\n\r|\n|\r){2,}/g, '\n'); + } + + // fix multiline, Bootstrap-style comments + function padcomments(str, num) { + var nl = _.repeat('\n', (num || 1)); + return str.replace(/(\s*)(' }, + { cN: 'xmlDocTag', b: '' }, + ], + }, + a.CLCM, + a.CBLCLM, + { + cN: 'preprocessor', + b: '#', + e: '$', + k: 'if else elif endif define undef warning error line region endregion pragma checksum', + }, + { cN: 'string', b: '@"', e: '"', c: [{ b: '""' }] }, + a.ASM, + a.QSM, + a.CNM, + ], + } +})(hljs) +hljs.LANGUAGES.ruby = (function (e) { + var a = '[a-zA-Z_][a-zA-Z0-9_]*(\\!|\\?)?' + var j = + '[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?' + var g = { + keyword: + 'and false then defined module in return redo if BEGIN retry end for true self when next until do begin unless END rescue nil else break undef not super class case require yield alias while ensure elsif or include', + } + var c = { cN: 'yardoctag', b: '@[A-Za-z]+' } + var k = [ + { cN: 'comment', b: '#', e: '$', c: [c] }, + { cN: 'comment', b: '^\\=begin', e: '^\\=end', c: [c], r: 10 }, + { cN: 'comment', b: '^__END__', e: '\\n$' }, + ] + var d = { cN: 'subst', b: '#\\{', e: '}', l: a, k: g } + var i = [e.BE, d] + var b = [ + { cN: 'string', b: "'", e: "'", c: i, r: 0 }, + { cN: 'string', b: '"', e: '"', c: i, r: 0 }, + { cN: 'string', b: '%[qw]?\\(', e: '\\)', c: i }, + { cN: 'string', b: '%[qw]?\\[', e: '\\]', c: i }, + { cN: 'string', b: '%[qw]?{', e: '}', c: i }, + { cN: 'string', b: '%[qw]?<', e: '>', c: i, r: 10 }, + { cN: 'string', b: '%[qw]?/', e: '/', c: i, r: 10 }, + { cN: 'string', b: '%[qw]?%', e: '%', c: i, r: 10 }, + { cN: 'string', b: '%[qw]?-', e: '-', c: i, r: 10 }, + { cN: 'string', b: '%[qw]?\\|', e: '\\|', c: i, r: 10 }, + ] + var h = { + cN: 'function', + bWK: true, + e: ' |$|;', + k: 'def', + c: [ + { cN: 'title', b: j, l: a, k: g }, + { cN: 'params', b: '\\(', e: '\\)', l: a, k: g }, + ].concat(k), + } + var f = k.concat( + b.concat([ + { + cN: 'class', + bWK: true, + e: '$|;', + k: 'class module', + c: [ + { cN: 'title', b: '[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?', r: 0 }, + { + cN: 'inheritance', + b: '<\\s*', + c: [{ cN: 'parent', b: '(' + e.IR + '::)?' + e.IR }], + }, + ].concat(k), + }, + h, + { cN: 'constant', b: '(::)?(\\b[A-Z]\\w*(::)?)+', r: 0 }, + { cN: 'symbol', b: ':', c: b.concat([{ b: j }]), r: 0 }, + { cN: 'symbol', b: a + ':', r: 0 }, + { + cN: 'number', + b: '(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b', + r: 0, + }, + { cN: 'number', b: '\\?\\w' }, + { cN: 'variable', b: '(\\$\\W)|((\\$|\\@\\@?)(\\w+))' }, + { + b: '(' + e.RSR + ')\\s*', + c: k.concat([ + { cN: 'regexp', b: '/', e: '/[a-z]*', i: '\\n', c: [e.BE, d] }, + ]), + r: 0, + }, + ]) + ) + d.c = f + h.c[1].c = f + return { l: a, k: g, c: f } +})(hljs) +hljs.LANGUAGES.diff = (function (a) { + return { + c: [ + { cN: 'chunk', b: '^\\@\\@ +\\-\\d+,\\d+ +\\+\\d+,\\d+ +\\@\\@$', r: 10 }, + { cN: 'chunk', b: '^\\*\\*\\* +\\d+,\\d+ +\\*\\*\\*\\*$', r: 10 }, + { cN: 'chunk', b: '^\\-\\-\\- +\\d+,\\d+ +\\-\\-\\-\\-$', r: 10 }, + { cN: 'header', b: 'Index: ', e: '$' }, + { cN: 'header', b: '=====', e: '=====$' }, + { cN: 'header', b: '^\\-\\-\\-', e: '$' }, + { cN: 'header', b: '^\\*{3} ', e: '$' }, + { cN: 'header', b: '^\\+\\+\\+', e: '$' }, + { cN: 'header', b: '\\*{5}', e: '\\*{5}$' }, + { cN: 'addition', b: '^\\+', e: '$' }, + { cN: 'deletion', b: '^\\-', e: '$' }, + { cN: 'change', b: '^\\!', e: '$' }, + ], + } +})(hljs) +hljs.LANGUAGES.javascript = (function (a) { + return { + k: { + keyword: + 'in if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const', + literal: 'true false null undefined NaN Infinity', + }, + c: [ + a.ASM, + a.QSM, + a.CLCM, + a.CBLCLM, + a.CNM, + { + b: '(' + a.RSR + '|\\b(case|return|throw)\\b)\\s*', + k: 'return throw case', + c: [ + a.CLCM, + a.CBLCLM, + { cN: 'regexp', b: '/', e: '/[gim]*', i: '\\n', c: [{ b: '\\\\/' }] }, + { b: '<', e: '>;', sL: 'xml' }, + ], + r: 0, + }, + { + cN: 'function', + bWK: true, + e: '{', + k: 'function', + c: [ + { cN: 'title', b: '[A-Za-z$_][0-9A-Za-z$_]*' }, + { + cN: 'params', + b: '\\(', + e: '\\)', + c: [a.CLCM, a.CBLCLM], + i: '["\'\\(]', + }, + ], + i: '\\[|%', + }, + ], + } +})(hljs) +hljs.LANGUAGES.css = (function (a) { + var b = { cN: 'function', b: a.IR + '\\(', e: '\\)', c: [a.NM, a.ASM, a.QSM] } + return { + cI: true, + i: "[=/|']", + c: [ + a.CBLCLM, + { cN: 'id', b: '\\#[A-Za-z0-9_-]+' }, + { cN: 'class', b: '\\.[A-Za-z0-9_-]+', r: 0 }, + { cN: 'attr_selector', b: '\\[', e: '\\]', i: '$' }, + { cN: 'pseudo', b: ':(:)?[a-zA-Z0-9\\_\\-\\+\\(\\)\\"\\\']+' }, + { + cN: 'at_rule', + b: '@(font-face|page)', + l: '[a-z-]+', + k: 'font-face page', + }, + { + cN: 'at_rule', + b: '@', + e: '[{;]', + eE: true, + k: 'import page media charset', + c: [b, a.ASM, a.QSM, a.NM], + }, + { cN: 'tag', b: a.IR, r: 0 }, + { + cN: 'rules', + b: '{', + e: '}', + i: '[^\\s]', + r: 0, + c: [ + a.CBLCLM, + { + cN: 'rule', + b: '[^\\s]', + rB: true, + e: ';', + eW: true, + c: [ + { + cN: 'attribute', + b: '[A-Z\\_\\.\\-]+', + e: ':', + eE: true, + i: '[^\\s]', + starts: { + cN: 'value', + eW: true, + eE: true, + c: [ + b, + a.NM, + a.QSM, + a.ASM, + a.CBLCLM, + { cN: 'hexcolor', b: '\\#[0-9A-F]+' }, + { cN: 'important', b: '!important' }, + ], + }, + }, + ], + }, + ], + }, + ], + } +})(hljs) +hljs.LANGUAGES.xml = (function (a) { + var c = '[A-Za-z0-9\\._:-]+' + var b = { + eW: true, + c: [ + { cN: 'attribute', b: c, r: 0 }, + { b: '="', rB: true, e: '"', c: [{ cN: 'value', b: '"', eW: true }] }, + { b: "='", rB: true, e: "'", c: [{ cN: 'value', b: "'", eW: true }] }, + { b: '=', c: [{ cN: 'value', b: '[^\\s/>]+' }] }, + ], + } + return { + cI: true, + c: [ + { cN: 'pi', b: '<\\?', e: '\\?>', r: 10 }, + { + cN: 'doctype', + b: '', + r: 10, + c: [{ b: '\\[', e: '\\]' }], + }, + { cN: 'comment', b: '', r: 10 }, + { cN: 'cdata', b: '<\\!\\[CDATA\\[', e: '\\]\\]>', r: 10 }, + { + cN: 'tag', + b: '|$)', + e: '>', + k: { title: 'style' }, + c: [b], + starts: { e: '', rE: true, sL: 'css' }, + }, + { + cN: 'tag', + b: '|$)', + e: '>', + k: { title: 'script' }, + c: [b], + starts: { e: '', rE: true, sL: 'javascript' }, + }, + { b: '<%', e: '%>', sL: 'vbscript' }, + { cN: 'tag', b: '', c: [{ cN: 'title', b: '[^ />]+' }, b] }, + ], + } +})(hljs) +hljs.LANGUAGES.http = (function (a) { + return { + i: '\\S', + c: [ + { + cN: 'status', + b: '^HTTP/[0-9\\.]+', + e: '$', + c: [{ cN: 'number', b: '\\b\\d{3}\\b' }], + }, + { + cN: 'request', + b: '^[A-Z]+ (.*?) HTTP/[0-9\\.]+$', + rB: true, + e: '$', + c: [{ cN: 'string', b: ' ', e: ' ', eB: true, eE: true }], + }, + { + cN: 'attribute', + b: '^\\w', + e: ': ', + eE: true, + i: '\\n|\\s|=', + starts: { cN: 'string', e: '$' }, + }, + { b: '\\n\\n', starts: { sL: '', eW: true } }, + ], + } +})(hljs) +hljs.LANGUAGES.java = (function (a) { + return { + k: 'false synchronized int abstract float private char boolean static null if const for true while long throw strictfp finally protected import native final return void enum else break transient new catch instanceof byte super volatile case assert short package default double public try this switch continue throws', + c: [ + { + cN: 'javadoc', + b: '/\\*\\*', + e: '\\*/', + c: [{ cN: 'javadoctag', b: '@[A-Za-z]+' }], + r: 10, + }, + a.CLCM, + a.CBLCLM, + a.ASM, + a.QSM, + { + cN: 'class', + bWK: true, + e: '{', + k: 'class interface', + i: ':', + c: [ + { bWK: true, k: 'extends implements', r: 10 }, + { cN: 'title', b: a.UIR }, + ], + }, + a.CNM, + { cN: 'annotation', b: '@[A-Za-z]+' }, + ], + } +})(hljs) +hljs.LANGUAGES.php = (function (a) { + var e = { cN: 'variable', b: '\\$+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*' } + var b = [ + a.inherit(a.ASM, { i: null }), + a.inherit(a.QSM, { i: null }), + { cN: 'string', b: 'b"', e: '"', c: [a.BE] }, + { cN: 'string', b: "b'", e: "'", c: [a.BE] }, + ] + var c = [a.BNM, a.CNM] + var d = { cN: 'title', b: a.UIR } + return { + cI: true, + k: 'and include_once list abstract global private echo interface as static endswitch array null if endwhile or const for endforeach self var while isset public protected exit foreach throw elseif include __FILE__ empty require_once do xor return implements parent clone use __CLASS__ __LINE__ else break print eval new catch __METHOD__ case exception php_user_filter default die require __FUNCTION__ enddeclare final try this switch continue endfor endif declare unset true false namespace trait goto instanceof insteadof __DIR__ __NAMESPACE__ __halt_compiler', + c: [ + a.CLCM, + a.HCM, + { + cN: 'comment', + b: '/\\*', + e: '\\*/', + c: [{ cN: 'phpdoc', b: '\\s@[A-Za-z]+' }], + }, + { cN: 'comment', eB: true, b: '__halt_compiler.+?;', eW: true }, + { cN: 'string', b: '<<<[\'"]?\\w+[\'"]?$', e: '^\\w+;', c: [a.BE] }, + { cN: 'preprocessor', b: '<\\?php', r: 10 }, + { cN: 'preprocessor', b: '\\?>' }, + e, + { + cN: 'function', + bWK: true, + e: '{', + k: 'function', + i: '\\$|\\[|%', + c: [ + d, + { + cN: 'params', + b: '\\(', + e: '\\)', + c: ['self', e, a.CBLCLM].concat(b).concat(c), + }, + ], + }, + { + cN: 'class', + bWK: true, + e: '{', + k: 'class', + i: '[:\\(\\$]', + c: [{ bWK: true, eW: true, k: 'extends', c: [d] }, d], + }, + { b: '=>' }, + ] + .concat(b) + .concat(c), + } +})(hljs) +hljs.LANGUAGES.python = (function (a) { + var f = { cN: 'prompt', b: '^(>>>|\\.\\.\\.) ' } + var c = [ + { cN: 'string', b: "(u|b)?r?'''", e: "'''", c: [f], r: 10 }, + { cN: 'string', b: '(u|b)?r?"""', e: '"""', c: [f], r: 10 }, + { cN: 'string', b: "(u|r|ur)'", e: "'", c: [a.BE], r: 10 }, + { cN: 'string', b: '(u|r|ur)"', e: '"', c: [a.BE], r: 10 }, + { cN: 'string', b: "(b|br)'", e: "'", c: [a.BE] }, + { cN: 'string', b: '(b|br)"', e: '"', c: [a.BE] }, + ].concat([a.ASM, a.QSM]) + var e = { cN: 'title', b: a.UIR } + var d = { cN: 'params', b: '\\(', e: '\\)', c: ['self', a.CNM, f].concat(c) } + var b = { bWK: true, e: ':', i: '[${=;\\n]', c: [e, d], r: 10 } + return { + k: { + keyword: + 'and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda nonlocal|10', + built_in: 'None True False Ellipsis NotImplemented', + }, + i: '(|\\?)', + c: c.concat([ + f, + a.HCM, + a.inherit(b, { cN: 'function', k: 'def' }), + a.inherit(b, { cN: 'class', k: 'class' }), + a.CNM, + { cN: 'decorator', b: '@', e: '$' }, + { b: '\\b(print|exec)\\(' }, + ]), + } +})(hljs) +hljs.LANGUAGES.sql = (function (a) { + return { + cI: true, + c: [ + { + cN: 'operator', + b: '(begin|start|commit|rollback|savepoint|lock|alter|create|drop|rename|call|delete|do|handler|insert|load|replace|select|truncate|update|set|show|pragma|grant)\\b(?!:)', + e: ';', + eW: true, + k: { + keyword: + 'all partial global month current_timestamp using go revoke smallint indicator end-exec disconnect zone with character assertion to add current_user usage input local alter match collate real then rollback get read timestamp session_user not integer bit unique day minute desc insert execute like ilike|2 level decimal drop continue isolation found where constraints domain right national some module transaction relative second connect escape close system_user for deferred section cast current sqlstate allocate intersect deallocate numeric public preserve full goto initially asc no key output collation group by union session both last language constraint column of space foreign deferrable prior connection unknown action commit view or first into float year primary cascaded except restrict set references names table outer open select size are rows from prepare distinct leading create only next inner authorization schema corresponding option declare precision immediate else timezone_minute external varying translation true case exception join hour default double scroll value cursor descriptor values dec fetch procedure delete and false int is describe char as at in varchar null trailing any absolute current_time end grant privileges when cross check write current_date pad begin temporary exec time update catalog user sql date on identity timezone_hour natural whenever interval work order cascade diagnostics nchar having left call do handler load replace truncate start lock show pragma exists number', + aggregate: 'count sum min max avg', + }, + c: [ + { cN: 'string', b: "'", e: "'", c: [a.BE, { b: "''" }], r: 0 }, + { cN: 'string', b: '"', e: '"', c: [a.BE, { b: '""' }], r: 0 }, + { cN: 'string', b: '`', e: '`', c: [a.BE] }, + a.CNM, + ], + }, + a.CBLCLM, + { cN: 'comment', b: '--', e: '$' }, + ], + } +})(hljs) +hljs.LANGUAGES.ini = (function (a) { + return { + cI: true, + i: '[^\\s]', + c: [ + { cN: 'comment', b: ';', e: '$' }, + { cN: 'title', b: '^\\[', e: '\\]' }, + { + cN: 'setting', + b: '^[a-z0-9\\[\\]_-]+[ \\t]*=[ \\t]*', + e: '$', + c: [ + { + cN: 'value', + eW: true, + k: 'on off true false yes no', + c: [a.QSM, a.NM], + }, + ], + }, + ], + } +})(hljs) +hljs.LANGUAGES.perl = (function (e) { + var a = + 'getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qqfileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmgetsub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedirioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when' + var d = { cN: 'subst', b: '[$@]\\{', e: '\\}', k: a, r: 10 } + var b = { cN: 'variable', b: '\\$\\d' } + var i = { + cN: 'variable', + b: '[\\$\\%\\@\\*](\\^\\w\\b|#\\w+(\\:\\:\\w+)*|[^\\s\\w{]|{\\w+}|\\w+(\\:\\:\\w*)*)', + } + var f = [e.BE, d, b, i] + var h = { b: '->', c: [{ b: e.IR }, { b: '{', e: '}' }] } + var g = { cN: 'comment', b: '^(__END__|__DATA__)', e: '\\n$', r: 5 } + var c = [ + b, + i, + e.HCM, + g, + { cN: 'comment', b: '^\\=\\w', e: '\\=cut', eW: true }, + h, + { cN: 'string', b: 'q[qwxr]?\\s*\\(', e: '\\)', c: f, r: 5 }, + { cN: 'string', b: 'q[qwxr]?\\s*\\[', e: '\\]', c: f, r: 5 }, + { cN: 'string', b: 'q[qwxr]?\\s*\\{', e: '\\}', c: f, r: 5 }, + { cN: 'string', b: 'q[qwxr]?\\s*\\|', e: '\\|', c: f, r: 5 }, + { cN: 'string', b: 'q[qwxr]?\\s*\\<', e: '\\>', c: f, r: 5 }, + { cN: 'string', b: 'qw\\s+q', e: 'q', c: f, r: 5 }, + { cN: 'string', b: "'", e: "'", c: [e.BE], r: 0 }, + { cN: 'string', b: '"', e: '"', c: f, r: 0 }, + { cN: 'string', b: '`', e: '`', c: [e.BE] }, + { cN: 'string', b: '{\\w+}', r: 0 }, + { cN: 'string', b: '-?\\w+\\s*\\=\\>', r: 0 }, + { + cN: 'number', + b: '(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b', + r: 0, + }, + { + b: '(' + e.RSR + '|\\b(split|return|print|reverse|grep)\\b)\\s*', + k: 'split return print reverse grep', + r: 0, + c: [ + e.HCM, + g, + { + cN: 'regexp', + b: '(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*', + r: 10, + }, + { cN: 'regexp', b: '(m|qr)?/', e: '/[a-z]*', c: [e.BE], r: 0 }, + ], + }, + { cN: 'sub', bWK: true, e: '(\\s*\\(.*?\\))?[;{]', k: 'sub', r: 5 }, + { cN: 'operator', b: '-\\w\\b', r: 0 }, + ] + d.c = c + h.c[1].c = c + return { k: a, c: c } +})(hljs) +hljs.LANGUAGES.json = (function (a) { + var e = { literal: 'true false null' } + var d = [a.QSM, a.CNM] + var c = { cN: 'value', e: ',', eW: true, eE: true, c: d, k: e } + var b = { + b: '{', + e: '}', + c: [ + { + cN: 'attribute', + b: '\\s*"', + e: '"\\s*:\\s*', + eB: true, + eE: true, + c: [a.BE], + i: '\\n', + starts: c, + }, + ], + i: '\\S', + } + var f = { b: '\\[', e: '\\]', c: [a.inherit(c, { cN: null })], i: '\\S' } + d.splice(d.length, 0, b, f) + return { c: d, k: e, i: '\\S' } +})(hljs) +hljs.LANGUAGES.cpp = (function (a) { + var b = { + keyword: + 'false int float while private char catch export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const struct for static_cast|10 union namespace unsigned long throw volatile static protected bool template mutable if public friend do return goto auto void enum else break new extern using true class asm case typeid short reinterpret_cast|10 default double register explicit signed typename try this switch continue wchar_t inline delete alignof char16_t char32_t constexpr decltype noexcept nullptr static_assert thread_local restrict _Bool complex', + built_in: + 'std string cin cout cerr clog stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr', + } + return { + k: b, + i: '', + k: b, + r: 10, + c: ['self'], + }, + ], + } +})(hljs) + +hljs.initHighlightingOnLoad() diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/basic.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/basic.html new file mode 100644 index 00000000..f9d74b95 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/basic.html @@ -0,0 +1,45 @@ + + + + + Basic + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Basic

    +
    + +
    Data for the alert partial. You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +
    + + +

    Assemble

    + +

    Upstage

    + +

    Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. Upstage laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo.

    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/conditional-comment-output.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/conditional-comment-output.html new file mode 100644 index 00000000..845e7e0d --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/conditional-comment-output.html @@ -0,0 +1,76 @@ + + + + + + + + + Home + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + + + +
    + + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/gist.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/gist.html new file mode 100644 index 00000000..a3a966e8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/gist.html @@ -0,0 +1,64 @@ + + + + + Multiple Posts + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Example of using an associative array in YAML front matter to embed multiple gists on one page.

    +
    +

    Gists were embedded using the {{gist}} helper from the handlebars-helpers library.

    + 
    var stripBOM = function(content) {  if (content.charCodeAt(0) === 0xFEFF) {
+    content = content.slice(1);
+  }
+  return content;
+};
+var condense = function(str) {
+  return str.replace(/(\n|\r){2,}/g, '\n'
+);
+};
+var padcomments = function(str, num) {
+  var nl = _str.repeat('\n', (num || 1
+));
+  return str.replace(/(\s*<!--\s)/g, nl + 
+    '$1'
+  );
+};
+var prettifyHTML = function(source, options) {
+  try
+ {
+    return format(source, options);
+  } catch (e) {
+    grunt.log.error(e);
+    grunt.fail.warn('HTML prettification failed.');
+  }
+};
    +

    +
    +

    + + +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/index.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/index.html new file mode 100644 index 00000000..67324195 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/index.html @@ -0,0 +1,65 @@ + + + + + Home + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/markdown.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/markdown.html new file mode 100644 index 00000000..aa67f716 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/markdown.html @@ -0,0 +1,57 @@ + + + + + Markdown + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Markdown

    +
    +

    You're looking at inline markdown content, wrapped with handlebarstags!

    +

    Behold... some examples:

    +

    Heading 1

    +

    Heading 2

    +

    Heading 3

    +

    Heading 4

    +
    Heading 5
    +
    Heading 6
    +

    italic words

    +

    bold words

    +
    +

    this is a quote

    +
    +
      +
    1. First ordered list item
      2. +
    2. Second item
      3. +
    3. Third Item
      4. +
    +

    Finally, end a line with two or more spaces to do a manual line break.

    +
    +

    Markdown

    +
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/custom_indentation/partials.html b/vendor-src/grunt-prettify/test/actual/custom_indentation/partials.html new file mode 100644 index 00000000..6558ebe0 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/custom_indentation/partials.html @@ -0,0 +1,41 @@ + + + + + Partials + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Partials

    +
    +

    Alert example

    + +
    External data example. This alert was assembled from a partial and YAML data fron in './src/data/`
    +

    Button example

    + + Visit Assemble +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/basic.html b/vendor-src/grunt-prettify/test/actual/defaults/basic.html new file mode 100644 index 00000000..f9d74b95 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/basic.html @@ -0,0 +1,45 @@ + + + + + Basic + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Basic

    +
    + +
    Data for the alert partial. You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +
    + + +

    Assemble

    + +

    Upstage

    + +

    Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. Upstage laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo.

    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/conditional-comment-output.html b/vendor-src/grunt-prettify/test/actual/defaults/conditional-comment-output.html new file mode 100644 index 00000000..845e7e0d --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/conditional-comment-output.html @@ -0,0 +1,76 @@ + + + + + + + + + Home + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + + + +
    + + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/gist.html b/vendor-src/grunt-prettify/test/actual/defaults/gist.html new file mode 100644 index 00000000..a3a966e8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/gist.html @@ -0,0 +1,64 @@ + + + + + Multiple Posts + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Example of using an associative array in YAML front matter to embed multiple gists on one page.

    +
    +

    Gists were embedded using the {{gist}} helper from the handlebars-helpers library.

    + 
    var stripBOM = function(content) {  if (content.charCodeAt(0) === 0xFEFF) {
+    content = content.slice(1);
+  }
+  return content;
+};
+var condense = function(str) {
+  return str.replace(/(\n|\r){2,}/g, '\n'
+);
+};
+var padcomments = function(str, num) {
+  var nl = _str.repeat('\n', (num || 1
+));
+  return str.replace(/(\s*<!--\s)/g, nl + 
+    '$1'
+  );
+};
+var prettifyHTML = function(source, options) {
+  try
+ {
+    return format(source, options);
+  } catch (e) {
+    grunt.log.error(e);
+    grunt.fail.warn('HTML prettification failed.');
+  }
+};
    +

    +
    +

    + + +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/index.html b/vendor-src/grunt-prettify/test/actual/defaults/index.html new file mode 100644 index 00000000..67324195 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/index.html @@ -0,0 +1,65 @@ + + + + + Home + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/markdown.html b/vendor-src/grunt-prettify/test/actual/defaults/markdown.html new file mode 100644 index 00000000..aa67f716 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/markdown.html @@ -0,0 +1,57 @@ + + + + + Markdown + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Markdown

    +
    +

    You're looking at inline markdown content, wrapped with handlebarstags!

    +

    Behold... some examples:

    +

    Heading 1

    +

    Heading 2

    +

    Heading 3

    +

    Heading 4

    +
    Heading 5
    +
    Heading 6
    +

    italic words

    +

    bold words

    +
    +

    this is a quote

    +
    +
      +
    1. First ordered list item
      2. +
    2. Second item
      3. +
    3. Third Item
      4. +
    +

    Finally, end a line with two or more spaces to do a manual line break.

    +
    +

    Markdown

    +
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/defaults/partials.html b/vendor-src/grunt-prettify/test/actual/defaults/partials.html new file mode 100644 index 00000000..6558ebe0 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/defaults/partials.html @@ -0,0 +1,41 @@ + + + + + Partials + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Partials

    +
    +

    Alert example

    + +
    External data example. This alert was assembled from a partial and YAML data fron in './src/data/`
    +

    Button example

    + + Visit Assemble +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/basic.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/basic.html new file mode 100644 index 00000000..f9d74b95 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/basic.html @@ -0,0 +1,45 @@ + + + + + Basic + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Basic

    +
    + +
    Data for the alert partial. You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +
    + + +

    Assemble

    + +

    Upstage

    + +

    Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. Upstage laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo.

    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/conditional-comment-output.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/conditional-comment-output.html new file mode 100644 index 00000000..845e7e0d --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/conditional-comment-output.html @@ -0,0 +1,76 @@ + + + + + + + + + Home + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + + + +
    + + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/gist.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/gist.html new file mode 100644 index 00000000..a3a966e8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/gist.html @@ -0,0 +1,64 @@ + + + + + Multiple Posts + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Example of using an associative array in YAML front matter to embed multiple gists on one page.

    +
    +

    Gists were embedded using the {{gist}} helper from the handlebars-helpers library.

    + 
    var stripBOM = function(content) {  if (content.charCodeAt(0) === 0xFEFF) {
+    content = content.slice(1);
+  }
+  return content;
+};
+var condense = function(str) {
+  return str.replace(/(\n|\r){2,}/g, '\n'
+);
+};
+var padcomments = function(str, num) {
+  var nl = _str.repeat('\n', (num || 1
+));
+  return str.replace(/(\s*<!--\s)/g, nl + 
+    '$1'
+  );
+};
+var prettifyHTML = function(source, options) {
+  try
+ {
+    return format(source, options);
+  } catch (e) {
+    grunt.log.error(e);
+    grunt.fail.warn('HTML prettification failed.');
+  }
+};
    +

    +
    +

    + + +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/index.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/index.html new file mode 100644 index 00000000..67324195 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/index.html @@ -0,0 +1,65 @@ + + + + + Home + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/markdown.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/markdown.html new file mode 100644 index 00000000..aa67f716 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/markdown.html @@ -0,0 +1,57 @@ + + + + + Markdown + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Markdown

    +
    +

    You're looking at inline markdown content, wrapped with handlebarstags!

    +

    Behold... some examples:

    +

    Heading 1

    +

    Heading 2

    +

    Heading 3

    +

    Heading 4

    +
    Heading 5
    +
    Heading 6
    +

    italic words

    +

    bold words

    +
    +

    this is a quote

    +
    +
      +
    1. First ordered list item
      2. +
    2. Second item
      3. +
    3. Third Item
      4. +
    +

    Finally, end a line with two or more spaces to do a manual line break.

    +
    +

    Markdown

    +
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/partials.html b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/partials.html new file mode 100644 index 00000000..6558ebe0 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/jsbeautifyrc/partials.html @@ -0,0 +1,41 @@ + + + + + Partials + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Partials

    +
    +

    Alert example

    + +
    External data example. This alert was assembled from a partial and YAML data fron in './src/data/`
    +

    Button example

    + + Visit Assemble +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/basic.html b/vendor-src/grunt-prettify/test/actual/padcomments/basic.html new file mode 100644 index 00000000..350c4fbf --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/basic.html @@ -0,0 +1,48 @@ + + + + + Basic + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Basic

    +
    + + + + +
    Data for the alert partial. You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +
    + + +

    Assemble

    + +

    Upstage

    + +

    Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. Upstage laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo.

    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/conditional-comment-output.html b/vendor-src/grunt-prettify/test/actual/padcomments/conditional-comment-output.html new file mode 100644 index 00000000..f5cdcf83 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/conditional-comment-output.html @@ -0,0 +1,103 @@ + + + + + + + + + + + + + + + + + + Home + + + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + + +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + + + + + + + + + + + + +
    + + + + + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/gist.html b/vendor-src/grunt-prettify/test/actual/padcomments/gist.html new file mode 100644 index 00000000..a3a966e8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/gist.html @@ -0,0 +1,64 @@ + + + + + Multiple Posts + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Example of using an associative array in YAML front matter to embed multiple gists on one page.

    +
    +

    Gists were embedded using the {{gist}} helper from the handlebars-helpers library.

    + 
    var stripBOM = function(content) {  if (content.charCodeAt(0) === 0xFEFF) {
+    content = content.slice(1);
+  }
+  return content;
+};
+var condense = function(str) {
+  return str.replace(/(\n|\r){2,}/g, '\n'
+);
+};
+var padcomments = function(str, num) {
+  var nl = _str.repeat('\n', (num || 1
+));
+  return str.replace(/(\s*<!--\s)/g, nl + 
+    '$1'
+  );
+};
+var prettifyHTML = function(source, options) {
+  try
+ {
+    return format(source, options);
+  } catch (e) {
+    grunt.log.error(e);
+    grunt.fail.warn('HTML prettification failed.');
+  }
+};
    +

    +
    +

    + + +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/index.html b/vendor-src/grunt-prettify/test/actual/padcomments/index.html new file mode 100644 index 00000000..67324195 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/index.html @@ -0,0 +1,65 @@ + + + + + Home + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/markdown.html b/vendor-src/grunt-prettify/test/actual/padcomments/markdown.html new file mode 100644 index 00000000..aa67f716 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/markdown.html @@ -0,0 +1,57 @@ + + + + + Markdown + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Markdown

    +
    +

    You're looking at inline markdown content, wrapped with handlebarstags!

    +

    Behold... some examples:

    +

    Heading 1

    +

    Heading 2

    +

    Heading 3

    +

    Heading 4

    +
    Heading 5
    +
    Heading 6
    +

    italic words

    +

    bold words

    +
    +

    this is a quote

    +
    +
      +
    1. First ordered list item
      2. +
    2. Second item
      3. +
    3. Third Item
      4. +
    +

    Finally, end a line with two or more spaces to do a manual line break.

    +
    +

    Markdown

    +
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/padcomments/partials.html b/vendor-src/grunt-prettify/test/actual/padcomments/partials.html new file mode 100644 index 00000000..1322375d --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/padcomments/partials.html @@ -0,0 +1,47 @@ + + + + + Partials + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Partials

    +
    +

    Alert example

    + + + + +
    External data example. This alert was assembled from a partial and YAML data fron in './src/data/`
    +

    Button example

    + + + + + Visit Assemble +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/single/index.html b/vendor-src/grunt-prettify/test/actual/single/index.html new file mode 100644 index 00000000..67324195 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/single/index.html @@ -0,0 +1,65 @@ + + + + + Home + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    +
    +
    +

    Home

    +
    +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    + 
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    + 
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    + 
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    + 
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    +
    + + + \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/actual/ugly/basic.html b/vendor-src/grunt-prettify/test/actual/ugly/basic.html new file mode 100644 index 00000000..9bc89f20 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/basic.html @@ -0,0 +1,68 @@ + + + + + Basic + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Basic

    +
    + + +
    Data for the alert partial. You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +
    + + + + + +

    Assemble

    + +

    Upstage

    + +

    Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. Upstage laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo.

    + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/actual/ugly/conditional-comment-output.html b/vendor-src/grunt-prettify/test/actual/ugly/conditional-comment-output.html new file mode 100644 index 00000000..27a37785 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/conditional-comment-output.html @@ -0,0 +1,97 @@ + + + + + + + + + Home + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Home

    +
    + +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    + + +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    +
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    +
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    +
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    +
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + + + + + + + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/actual/ugly/gist.html b/vendor-src/grunt-prettify/test/actual/ugly/gist.html new file mode 100644 index 00000000..c5eeb665 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/gist.html @@ -0,0 +1,85 @@ + + + + + Multiple Posts + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Example of using an associative array in YAML front matter to embed multiple gists on one page.

    +
    +

    Gists were embedded using the {{gist}} helper from the handlebars-helpers library.

    +
    var stripBOM = function(content) {
+  if (content.charCodeAt(0) === 0xFEFF) {
+    content = content.slice(1);
+  }
+  return content;
+};
+
+var condense = function(str) {
+  return str.replace(/(\n|\r){2,}/g, '\n');
+};
+
+var padcomments = function(str, num) {
+  var nl = _str.repeat('\n', (num || 1));
+  return str.replace(/(\s*<!--\s)/g, nl + '$1');
+};
+
+var prettifyHTML = function(source, options) {
+  try {
+    return format(source, options);
+  } catch (e) {
+    grunt.log.error(e);
+    grunt.fail.warn('HTML prettification failed.');
+  }
+};
    +


    + + + + + + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/actual/ugly/index.html b/vendor-src/grunt-prettify/test/actual/ugly/index.html new file mode 100644 index 00000000..085b2837 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/index.html @@ -0,0 +1,88 @@ + + + + + Home + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Home

    +
    + +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    + + +

    Code

    +

    Inline code

    +

    To include code (formatted in monospace font), you can either surround inline code with a single backtick (` ): some code

    +
    some code
    +

    Indented code

    +

    Or indent several lines of code by at least four spaces, as in:

    +
    // Some comments
+line 1 of code
+line 2 of code
+line 3 of code
    +

    Code "fences"

    +

    Or wrap the code with backtick "fences" before and after the code: ```

    +
    line 1 of code
+line 2 of code
+line 3 of code
    +
    +

    kdfslkf

    +
    +

    Code highlighting

    +

    GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ``` js

    +
    assemble: {
+  // Files to build into pages
+  pages: {
+    src:  'templates/pages/*.hbs',
+    dest: 'dist/'
+  }
+}
    + + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/actual/ugly/markdown.html b/vendor-src/grunt-prettify/test/actual/ugly/markdown.html new file mode 100644 index 00000000..1f5eea09 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/markdown.html @@ -0,0 +1,83 @@ + + + + + Markdown + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Markdown

    +
    + + + + +

    You're looking at inline markdown content, wrapped with handlebarstags!

    +

    Behold... some examples:

    +

    Heading 1

    +

    Heading 2

    +

    Heading 3

    +

    Heading 4

    +
    Heading 5
    +
    Heading 6
    +

    italic words

    +

    bold words

    +
    +

    this is a quote

    +
    +
      +
    1. First ordered list item
      2. +
    2. Second item
      3. +
    3. Third Item
      4. +
    +

    Finally, end a line with two or more spaces to do a manual line break.

    + + + +
    +

    Markdown

    +
    + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/actual/ugly/partials.html b/vendor-src/grunt-prettify/test/actual/ugly/partials.html new file mode 100644 index 00000000..348d30a3 --- /dev/null +++ b/vendor-src/grunt-prettify/test/actual/ugly/partials.html @@ -0,0 +1,66 @@ + + + + + Partials + + + + + +
    +
    +
    + ASSEMBLE + + +
    +
    +
    + + + +
    + +
    +

    Partials

    +
    + + + +

    Alert example

    + +
    External data example. This alert was assembled from a partial and YAML data fron in './src/data/`
    + + + +

    Button example

    + + Visit Assemble + +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/fixtures/content/code.md b/vendor-src/grunt-prettify/test/fixtures/content/code.md new file mode 100644 index 00000000..db663577 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/content/code.md @@ -0,0 +1,50 @@ +## Code + +#### Inline code + +To include code (formatted in monospace font), you can either surround inline code with a single backtick (`` ` ``): `some code` + +``` +some code +``` + + +{{#handlebars}} +{{/handlebars}} + +#### Indented code + +Or indent several lines of code by at least four spaces, as in: + + // Some comments + line 1 of code + line 2 of code + line 3 of code + + +#### Code "fences" + +Or wrap the code with backtick "fences" before and after the code: ` ``` ` + +``` +line 1 of code +line 2 of code +line 3 of code +``` + +> kdfslkf + + +#### Code highlighting + +GFM, or "GitHub Flavored Markdown" also supports syntax highlighting. To activate it, simply add the file extension of the language you want to use directly after the first "fence": ` ``` js ` + +``` js +assemble: { + // Files to build into pages + pages: { + src: 'templates/pages/*.hbs', + dest: 'dist/' + } +} +``` diff --git a/vendor-src/grunt-prettify/test/fixtures/content/links.md b/vendor-src/grunt-prettify/test/fixtures/content/links.md new file mode 100644 index 00000000..ef15f720 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/content/links.md @@ -0,0 +1,10 @@ +### Links + +### Basic link +[Assemble](http://github.com/assemble/) + +### Basic link with title +[Upstage](http://github.com/upstage/ "Visit Upstage!") + +### Link within a paragraph +Aliquam hendrerit congue mauris at imperdiet. Suspendisse sit amet justo eu lacus tempor malesuada aliquam et massa. Proin malesuada, sem id facilisis facilisis, ipsum lacus tincidunt dui, ut tincidunt diam urna vitae tellus. Etiam auctor dapibus felis, auctor eleifend erat semper non. [Upstage](http://github.com/upstage/) laoreet metus. Duis odio elit, venenatis nec malesuada at, pretium ut quam. Aenean sagittis eleifend rutrum. Ut dictum volutpat metus sit amet imperdiet. Integer iaculis massa vel ipsum tincidunt dictum. In fringilla pellentesque massa eget faucibus. Quisque vitae ligula justo. \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/fixtures/data/alert.json b/vendor-src/grunt-prettify/test/fixtures/data/alert.json new file mode 100644 index 00000000..7a1ad1ec --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/data/alert.json @@ -0,0 +1,5 @@ +{ + "strong": "External data example.", + "modifier": "alert-info", + "message": "This alert was assembled from a partial and YAML data fron in './src/data/`" +} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/fixtures/data/button.json b/vendor-src/grunt-prettify/test/fixtures/data/button.json new file mode 100644 index 00000000..71d9ec6e --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/data/button.json @@ -0,0 +1,5 @@ +{ + "text": "Visit Assemble", + "url": "https://github.com/assemble/assemble/", + "modifier": "btn-primary btn-large" +} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/fixtures/includes/alert.hbs b/vendor-src/grunt-prettify/test/fixtures/includes/alert.hbs new file mode 100644 index 00000000..30b1fc74 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/includes/alert.hbs @@ -0,0 +1,2 @@ + +
    {{ alert.strong }} {{ alert.message }}
    diff --git a/vendor-src/grunt-prettify/test/fixtures/includes/button.hbs b/vendor-src/grunt-prettify/test/fixtures/includes/button.hbs new file mode 100644 index 00000000..0572b821 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/includes/button.hbs @@ -0,0 +1,2 @@ + + {{ button.text }} diff --git a/vendor-src/grunt-prettify/test/fixtures/includes/nav.hbs b/vendor-src/grunt-prettify/test/fixtures/includes/nav.hbs new file mode 100644 index 00000000..e3960eb8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/includes/nav.hbs @@ -0,0 +1,29 @@ +
    +
    +
    + ASSEMBLE + + +
    +
    +
    diff --git a/vendor-src/grunt-prettify/test/fixtures/layouts/comments-example.hbs b/vendor-src/grunt-prettify/test/fixtures/layouts/comments-example.hbs new file mode 100644 index 00000000..b0a2aec3 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/layouts/comments-example.hbs @@ -0,0 +1,24 @@ + + + + + + + + + {{ title }} + + + + + {{> nav }} + + +
    + {{> body }} +
    + + + + + diff --git a/vendor-src/grunt-prettify/test/fixtures/layouts/default.hbs b/vendor-src/grunt-prettify/test/fixtures/layouts/default.hbs new file mode 100644 index 00000000..0406f612 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/layouts/default.hbs @@ -0,0 +1,24 @@ + + + + + {{ title }} + + + + + {{!-- "nav" partial + ======================================= --}} + {{> nav }} + + {{!-- content + ======================================= --}} +
    + {{> body }} +
    + + {{!-- scripts + ======================================= --}} + + + diff --git a/vendor-src/grunt-prettify/test/fixtures/layouts/markdown.hbs b/vendor-src/grunt-prettify/test/fixtures/layouts/markdown.hbs new file mode 100644 index 00000000..38b02d47 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/layouts/markdown.hbs @@ -0,0 +1,6 @@ +--- +layout: default.hbs +--- +{{#markdown}} +{{> body }} +{{/markdown}} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/fixtures/pages/basic.hbs b/vendor-src/grunt-prettify/test/fixtures/pages/basic.hbs new file mode 100644 index 00000000..ed13707b --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/pages/basic.hbs @@ -0,0 +1,16 @@ +--- +title: Basic +alert: + strong: Data for the alert partial. + message: > + You can specify data in the YAML front-matter as we're doing here, or in external JSON or YAML files, or inside the Assemble task in the Gruntfile. +content: test/fixtures/content/links.md +--- +
    +

    {{ title }}

    +
    + +{{> alert }} + +{{! the path for this content is specified in the YAML front-matter }} +{{{md content}}} \ No newline at end of file diff --git a/vendor-src/grunt-prettify/test/fixtures/pages/conditional-comment-output.hbs b/vendor-src/grunt-prettify/test/fixtures/pages/conditional-comment-output.hbs new file mode 100644 index 00000000..04b812b8 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/pages/conditional-comment-output.hbs @@ -0,0 +1,21 @@ +--- +title: Home +docs: http://assemble.io/docs/YAML-front-matter.html +layout: comments-example.hbs +--- +
    +

    {{ title }}

    +
    + +

    In this example, at the top of each page you can use + YAML Front-Matter for providing metadata and configuration data for the page +

    + +{{! content from the path specified }} +{{{md 'test/fixtures/content/code.md'}}} + + + + + + diff --git a/vendor-src/grunt-prettify/test/fixtures/pages/gist.md b/vendor-src/grunt-prettify/test/fixtures/pages/gist.md new file mode 100644 index 00000000..a1726824 --- /dev/null +++ b/vendor-src/grunt-prettify/test/fixtures/pages/gist.md @@ -0,0 +1,44 @@ +--- +layout: markdown.hbs + +title: Multiple Posts +section: Blog +description: Example of using an associative array in YAML front matter to embed multiple gists on one page. + +gists: ['5898072', '5898077'] +--- +> {{{description}}} + +Gists were embedded using the `\{{gist}}` helper from the [handlebars-helpers](https://github.com/assemble/handlebars-helpers) library. + +```js +var stripBOM = function(content) { + if (content.charCodeAt(0) === 0xFEFF) { + content = content.slice(1); + } + return content; +}; + +var condense = function(str) { + return str.replace(/(\n|\r){2,}/g, '\n'); +}; + +var padcomments = function(str, num) { + var nl = _str.repeat('\n', (num || 1)); + return str.replace(/(\s* + + + + + + + + + + +

    Some content here.

    + + + + + +

    Some content here.

    + + + + + diff --git a/vendor-src/resource-embedder/test/fixtures/expected/urls.css b/vendor-src/resource-embedder/test/fixtures/expected/urls.css new file mode 100644 index 00000000..b7f0ae55 --- /dev/null +++ b/vendor-src/resource-embedder/test/fixtures/expected/urls.css @@ -0,0 +1,59 @@ +@font-face { + font-family: 'coool'; + font-style: normal; + font-weight: 400; + src: url(styles/fonts/coool.woff) format('woff'); + src:url("styles/fonts/coool.eot?#iefix") format("embedded-opentype"),url("styles/fonts/coool.woff") format("woff"),url("styles/fonts/coool.ttf") format("truetype"),url("styles/fonts/coool.svg#coool") format("svg") +} + +.something { + /* filter src should NOT be converted, as it's supposed to be relative to the document already */ + filter: progid:DXImageTransform.Microsoft.AlphaImageLoader( + src='images/test.jpg', + sizingMethod='scale' + ); + + background-image: url('images/foo.png'); + background-image: url('images/bar.png?12345'); + background-image: url(images/foo.png); + background-image: url( images/bar.png ); + background-image: url( + images/bar.png + ) +} + +.another-thing { + background-image: url(styles/more-images/bar.jpg?12345); + background-image: url( styles/more-images/bar.jpg?12345 ); + background-image: url( 'styles/more-images/bar.jpg' ); + background-image: url( + styles/more-images/bar.jpg + ); + background-image : url(styles/images/thing.jpg); +} + +.other-things { + background-image: url(data:image/gif;base64,R0lGODlhAQABAPAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==); + background-image: url( data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw== ); +} + +.moar-things { + background-image: url(/styles/more-images/thing.jpg); + background-image: url(http://i.imgur.com/C5XQm.gif); + filter: progid:DXImageTransform.Microsoft.AlphaImageLoader( + src='http://example.com/images/test.jpg', + sizingMethod='scale' + ); +} + +*, *:before, *:after { + box-sizing: border-box; + /* urls in IE's 'behavior' property should NOT be converted as it's already relative to the document... */ + + /* without hack */ + behavior: url(scripts/boxsizing.htc); + behavior : url( scripts/boxsizing.htc ); + + /* with IE<8 hack */ + *behavior: url(scripts/boxsizing.htc); +} diff --git a/vendor-src/resource-embedder/test/fixtures/messy.html b/vendor-src/resource-embedder/test/fixtures/messy.html new file mode 100644 index 00000000..52223ff4 --- /dev/null +++ b/vendor-src/resource-embedder/test/fixtures/messy.html @@ -0,0 +1,48 @@ + + + + + + + + + +My stupid test page + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Some content here.

    + + + + + +

    Some content here.

    + + + + + diff --git a/vendor-src/resource-embedder/test/fixtures/scripts/big.js b/vendor-src/resource-embedder/test/fixtures/scripts/big.js new file mode 100644 index 00000000..40bd5e81 --- /dev/null +++ b/vendor-src/resource-embedder/test/fixtures/scripts/big.js @@ -0,0 +1,3 @@ +(function(e,undefined){var t,n,r=typeof undefined,i=e.location,o=e.document,s=o.documentElement,a=e.jQuery,u=e.$,l={},c=[],p="2.0.3",f=c.concat,h=c.push,d=c.slice,g=c.indexOf,m=l.toString,y=l.hasOwnProperty,v=p.trim,x=function(e,n){return new x.fn.init(e,n,t)},b=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,w=/\S+/g,T=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,C=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,k=/^-ms-/,N=/-([\da-z])/gi,E=function(e,t){return t.toUpperCase()},S=function(){o.removeEventListener("DOMContentLoaded",S,!1),e.removeEventListener("load",S,!1),x.ready()};x.fn=x.prototype={jquery:p,constructor:x,init:function(e,t,n){var r,i;if(!e)return this;if("string"==typeof e){if(r="<"===e.charAt(0)&&">"===e.charAt(e.length-1)&&e.length>=3?[null,e,null]:T.exec(e),!r||!r[1]&&t)return!t||t.jquery?(t||n).find(e):this.constructor(t).find(e);if(r[1]){if(t=t instanceof x?t[0]:t,x.merge(this,x.parseHTML(r[1],t&&t.nodeType?t.ownerDocument||t:o,!0)),C.test(r[1])&&x.isPlainObject(t))for(r in t)x.isFunction(this[r])?this[r](t[r]):this.attr(r,t[r]);return this}return i=o.getElementById(r[2]),i&&i.parentNode&&(this.length=1,this[0]=i),this.context=o,this.selector=e,this}return e.nodeType?(this.context=this[0]=e,this.length=1,this):x.isFunction(e)?n.ready(e):(e.selector!==undefined&&(this.selector=e.selector,this.context=e.context),x.makeArray(e,this))},selector:"",length:0,toArray:function(){return d.call(this)},get:function(e){return null==e?this.toArray():0>e?this[this.length+e]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t.context=this.context,t},each:function(e,t){return x.each(this,e,t)},ready:function(e){return x.ready.promise().done(e),this},slice:function(){return this.pushStack(d.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(0>e?t:0);return this.pushStack(n>=0&&t>n?[this[n]]:[])},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:h,sort:[].sort,splice:[].splice},x.fn.init.prototype=x.fn,x.extend=x.fn.extend=function(){var e,t,n,r,i,o,s=arguments[0]||{},a=1,u=arguments.length,l=!1;for("boolean"==typeof s&&(l=s,s=arguments[1]||{},a=2),"object"==typeof s||x.isFunction(s)||(s={}),u===a&&(s=this,--a);u>a;a++)if(null!=(e=arguments[a]))for(t in e)n=s[t],r=e[t],s!==r&&(l&&r&&(x.isPlainObject(r)||(i=x.isArray(r)))?(i?(i=!1,o=n&&x.isArray(n)?n:[]):o=n&&x.isPlainObject(n)?n:{},s[t]=x.extend(l,o,r)):r!==undefined&&(s[t]=r));return s},x.extend({expando:"jQuery"+(p+Math.random()).replace(/\D/g,""),noConflict:function(t){return e.$===x&&(e.$=u),t&&e.jQuery===x&&(e.jQuery=a),x},isReady:!1,readyWait:1,holdReady:function(e){e?x.readyWait++:x.ready(!0)},ready:function(e){(e===!0?--x.readyWait:x.isReady)||(x.isReady=!0,e!==!0&&--x.readyWait>0||(n.resolveWith(o,[x]),x.fn.trigger&&x(o).trigger("ready").off("ready")))},isFunction:function(e){return"function"===x.type(e)},isArray:Array.isArray,isWindow:function(e){return null!=e&&e===e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?l[m.call(e)]||"object":typeof e},isPlainObject:function(e){if("object"!==x.type(e)||e.nodeType||x.isWindow(e))return!1;try{if(e.constructor&&!y.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(t){return!1}return!0},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw Error(e)},parseHTML:function(e,t,n){if(!e||"string"!=typeof e)return null;"boolean"==typeof t&&(n=t,t=!1),t=t||o;var r=C.exec(e),i=!n&&[];return r?[t.createElement(r[1])]:(r=x.buildFragment([e],t,i),i&&x(i).remove(),x.merge([],r.childNodes))},parseJSON:JSON.parse,parseXML:function(e){var t,n;if(!e||"string"!=typeof e)return null;try{n=new DOMParser,t=n.parseFromString(e,"text/xml")}catch(r){t=undefined}return(!t||t.getElementsByTagName("parsererror").length)&&x.error("Invalid XML: "+e),t},noop:function(){},globalEval:function(e){var t,n=eval;e=x.trim(e),e&&(1===e.indexOf("use strict")?(t=o.createElement("script"),t.text=e,o.head.appendChild(t).parentNode.removeChild(t)):n(e))},camelCase:function(e){return e.replace(k,"ms-").replace(N,E)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,t,n){var r,i=0,o=e.length,s=j(e);if(n){if(s){for(;o>i;i++)if(r=t.apply(e[i],n),r===!1)break}else for(i in e)if(r=t.apply(e[i],n),r===!1)break}else if(s){for(;o>i;i++)if(r=t.call(e[i],i,e[i]),r===!1)break}else for(i in e)if(r=t.call(e[i],i,e[i]),r===!1)break;return e},trim:function(e){return null==e?"":v.call(e)},makeArray:function(e,t){var n=t||[];return null!=e&&(j(Object(e))?x.merge(n,"string"==typeof e?[e]:e):h.call(n,e)),n},inArray:function(e,t,n){return null==t?-1:g.call(t,e,n)},merge:function(e,t){var n=t.length,r=e.length,i=0;if("number"==typeof n)for(;n>i;i++)e[r++]=t[i];else while(t[i]!==undefined)e[r++]=t[i++];return e.length=r,e},grep:function(e,t,n){var r,i=[],o=0,s=e.length;for(n=!!n;s>o;o++)r=!!t(e[o],o),n!==r&&i.push(e[o]);return i},map:function(e,t,n){var r,i=0,o=e.length,s=j(e),a=[];if(s)for(;o>i;i++)r=t(e[i],i,n),null!=r&&(a[a.length]=r);else for(i in e)r=t(e[i],i,n),null!=r&&(a[a.length]=r);return f.apply([],a)},guid:1,proxy:function(e,t){var n,r,i;return"string"==typeof t&&(n=e[t],t=e,e=n),x.isFunction(e)?(r=d.call(arguments,2),i=function(){return e.apply(t||this,r.concat(d.call(arguments)))},i.guid=e.guid=e.guid||x.guid++,i):undefined},access:function(e,t,n,r,i,o,s){var a=0,u=e.length,l=null==n;if("object"===x.type(n)){i=!0;for(a in n)x.access(e,t,a,n[a],!0,o,s)}else if(r!==undefined&&(i=!0,x.isFunction(r)||(s=!0),l&&(s?(t.call(e,r),t=null):(l=t,t=function(e,t,n){return l.call(x(e),n)})),t))for(;u>a;a++)t(e[a],n,s?r:r.call(e[a],a,t(e[a],n)));return i?e:l?t.call(e):u?t(e[0],n):o},now:Date.now,swap:function(e,t,n,r){var i,o,s={};for(o in t)s[o]=e.style[o],e.style[o]=t[o];i=n.apply(e,r||[]);for(o in t)e.style[o]=s[o];return i}}),x.ready.promise=function(t){return n||(n=x.Deferred(),"complete"===o.readyState?setTimeout(x.ready):(o.addEventListener("DOMContentLoaded",S,!1),e.addEventListener("load",S,!1))),n.promise(t)},x.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(e,t){l["[object "+t+"]"]=t.toLowerCase()});function j(e){var t=e.length,n=x.type(e);return x.isWindow(e)?!1:1===e.nodeType&&t?!0:"array"===n||"function"!==n&&(0===t||"number"==typeof t&&t>0&&t-1 in e)}t=x(o),function(e,undefined){var t,n,r,i,o,s,a,u,l,c,p,f,h,d,g,m,y,v="sizzle"+-new Date,b=e.document,w=0,T=0,C=st(),k=st(),N=st(),E=!1,S=function(e,t){return e===t?(E=!0,0):0},j=typeof undefined,D=1<<31,A={}.hasOwnProperty,L=[],q=L.pop,H=L.push,O=L.push,F=L.slice,P=L.indexOf||function(e){var t=0,n=this.length;for(;n>t;t++)if(this[t]===e)return t;return-1},R="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",M="[\\x20\\t\\r\\n\\f]",W="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",$=W.replace("w","w#"),B="\\["+M+"*("+W+")"+M+"*(?:([*^$|!~]?=)"+M+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+$+")|)|)"+M+"*\\]",I=":("+W+")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|"+B.replace(3,8)+")*)|.*)\\)|)",z=RegExp("^"+M+"+|((?:^|[^\\\\])(?:\\\\.)*)"+M+"+$","g"),_=RegExp("^"+M+"*,"+M+"*"),X=RegExp("^"+M+"*([>+~]|"+M+")"+M+"*"),U=RegExp(M+"*[+~]"),Y=RegExp("="+M+"*([^\\]'\"]*)"+M+"*\\]","g"),V=RegExp(I),G=RegExp("^"+$+"$"),J={ID:RegExp("^#("+W+")"),CLASS:RegExp("^\\.("+W+")"),TAG:RegExp("^("+W.replace("w","w*")+")"),ATTR:RegExp("^"+B),PSEUDO:RegExp("^"+I),CHILD:RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+M+"*(even|odd|(([+-]|)(\\d*)n|)"+M+"*(?:([+-]|)"+M+"*(\\d+)|))"+M+"*\\)|)","i"),bool:RegExp("^(?:"+R+")$","i"),needsContext:RegExp("^"+M+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+M+"*((?:-\\d)?\\d*)"+M+"*\\)|)(?=[^-]|$)","i")},Q=/^[^{]+\{\s*\[native \w/,K=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,Z=/^(?:input|select|textarea|button)$/i,et=/^h\d$/i,tt=/'|\\/g,nt=RegExp("\\\\([\\da-f]{1,6}"+M+"?|("+M+")|.)","ig"),rt=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:0>r?String.fromCharCode(r+65536):String.fromCharCode(55296|r>>10,56320|1023&r)};try{O.apply(L=F.call(b.childNodes),b.childNodes),L[b.childNodes.length].nodeType}catch(it){O={apply:L.length?function(e,t){H.apply(e,F.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function ot(e,t,r,i){var o,s,a,u,l,f,g,m,x,w;if((t?t.ownerDocument||t:b)!==p&&c(t),t=t||p,r=r||[],!e||"string"!=typeof e)return r;if(1!==(u=t.nodeType)&&9!==u)return[];if(h&&!i){if(o=K.exec(e))if(a=o[1]){if(9===u){if(s=t.getElementById(a),!s||!s.parentNode)return r;if(s.id===a)return r.push(s),r}else if(t.ownerDocument&&(s=t.ownerDocument.getElementById(a))&&y(t,s)&&s.id===a)return r.push(s),r}else{if(o[2])return O.apply(r,t.getElementsByTagName(e)),r;if((a=o[3])&&n.getElementsByClassName&&t.getElementsByClassName)return O.apply(r,t.getElementsByClassName(a)),r}if(n.qsa&&(!d||!d.test(e))){if(m=g=v,x=t,w=9===u&&e,1===u&&"object"!==t.nodeName.toLowerCase()){f=gt(e),(g=t.getAttribute("id"))?m=g.replace(tt,"\\$&"):t.setAttribute("id",m),m="[id='"+m+"'] ",l=f.length;while(l--)f[l]=m+mt(f[l]);x=U.test(e)&&t.parentNode||t,w=f.join(",")}if(w)try{return O.apply(r,x.querySelectorAll(w)),r}catch(T){}finally{g||t.removeAttribute("id")}}}return kt(e.replace(z,"$1"),t,r,i)}function st(){var e=[];function t(n,r){return e.push(n+=" ")>i.cacheLength&&delete t[e.shift()],t[n]=r}return t}function at(e){return e[v]=!0,e}function ut(e){var t=p.createElement("div");try{return!!e(t)}catch(n){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function lt(e,t){var n=e.split("|"),r=e.length;while(r--)i.attrHandle[n[r]]=t}function ct(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&(~t.sourceIndex||D)-(~e.sourceIndex||D);if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function pt(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function ft(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function ht(e){return at(function(t){return t=+t,at(function(n,r){var i,o=e([],n.length,t),s=o.length;while(s--)n[i=o[s]]&&(n[i]=!(r[i]=n[i]))})})}s=ot.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?"HTML"!==t.nodeName:!1},n=ot.support={},c=ot.setDocument=function(e){var t=e?e.ownerDocument||e:b,r=t.defaultView;return t!==p&&9===t.nodeType&&t.documentElement?(p=t,f=t.documentElement,h=!s(t),r&&r.attachEvent&&r!==r.top&&r.attachEvent("onbeforeunload",function(){c()}),n.attributes=ut(function(e){return e.className="i",!e.getAttribute("className")}),n.getElementsByTagName=ut(function(e){return e.appendChild(t.createComment("")),!e.getElementsByTagName("*").length}),n.getElementsByClassName=ut(function(e){return e.innerHTML="
    ",e.firstChild.className="i",2===e.getElementsByClassName("i").length}),n.getById=ut(function(e){return f.appendChild(e).id=v,!t.getElementsByName||!t.getElementsByName(v).length}),n.getById?(i.find.ID=function(e,t){if(typeof t.getElementById!==j&&h){var n=t.getElementById(e);return n&&n.parentNode?[n]:[]}},i.filter.ID=function(e){var t=e.replace(nt,rt);return function(e){return e.getAttribute("id")===t}}):(delete i.find.ID,i.filter.ID=function(e){var t=e.replace(nt,rt);return function(e){var n=typeof e.getAttributeNode!==j&&e.getAttributeNode("id");return n&&n.value===t}}),i.find.TAG=n.getElementsByTagName?function(e,t){return typeof t.getElementsByTagName!==j?t.getElementsByTagName(e):undefined}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},i.find.CLASS=n.getElementsByClassName&&function(e,t){return typeof t.getElementsByClassName!==j&&h?t.getElementsByClassName(e):undefined},g=[],d=[],(n.qsa=Q.test(t.querySelectorAll))&&(ut(function(e){e.innerHTML="",e.querySelectorAll("[selected]").length||d.push("\\["+M+"*(?:value|"+R+")"),e.querySelectorAll(":checked").length||d.push(":checked")}),ut(function(e){var n=t.createElement("input");n.setAttribute("type","hidden"),e.appendChild(n).setAttribute("t",""),e.querySelectorAll("[t^='']").length&&d.push("[*^$]="+M+"*(?:''|\"\")"),e.querySelectorAll(":enabled").length||d.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),d.push(",.*:")})),(n.matchesSelector=Q.test(m=f.webkitMatchesSelector||f.mozMatchesSelector||f.oMatchesSelector||f.msMatchesSelector))&&ut(function(e){n.disconnectedMatch=m.call(e,"div"),m.call(e,"[s!='']:x"),g.push("!=",I)}),d=d.length&&RegExp(d.join("|")),g=g.length&&RegExp(g.join("|")),y=Q.test(f.contains)||f.compareDocumentPosition?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},S=f.compareDocumentPosition?function(e,r){if(e===r)return E=!0,0;var i=r.compareDocumentPosition&&e.compareDocumentPosition&&e.compareDocumentPosition(r);return i?1&i||!n.sortDetached&&r.compareDocumentPosition(e)===i?e===t||y(b,e)?-1:r===t||y(b,r)?1:l?P.call(l,e)-P.call(l,r):0:4&i?-1:1:e.compareDocumentPosition?-1:1}:function(e,n){var r,i=0,o=e.parentNode,s=n.parentNode,a=[e],u=[n];if(e===n)return E=!0,0;if(!o||!s)return e===t?-1:n===t?1:o?-1:s?1:l?P.call(l,e)-P.call(l,n):0;if(o===s)return ct(e,n);r=e;while(r=r.parentNode)a.unshift(r);r=n;while(r=r.parentNode)u.unshift(r);while(a[i]===u[i])i++;return i?ct(a[i],u[i]):a[i]===b?-1:u[i]===b?1:0},t):p},ot.matches=function(e,t){return ot(e,null,null,t)},ot.matchesSelector=function(e,t){if((e.ownerDocument||e)!==p&&c(e),t=t.replace(Y,"='$1']"),!(!n.matchesSelector||!h||g&&g.test(t)||d&&d.test(t)))try{var r=m.call(e,t);if(r||n.disconnectedMatch||e.document&&11!==e.document.nodeType)return r}catch(i){}return ot(t,p,null,[e]).length>0},ot.contains=function(e,t){return(e.ownerDocument||e)!==p&&c(e),y(e,t)},ot.attr=function(e,t){(e.ownerDocument||e)!==p&&c(e);var r=i.attrHandle[t.toLowerCase()],o=r&&A.call(i.attrHandle,t.toLowerCase())?r(e,t,!h):undefined;return o===undefined?n.attributes||!h?e.getAttribute(t):(o=e.getAttributeNode(t))&&o.specified?o.value:null:o},ot.error=function(e){throw Error("Syntax error, unrecognized expression: "+e)},ot.uniqueSort=function(e){var t,r=[],i=0,o=0;if(E=!n.detectDuplicates,l=!n.sortStable&&e.slice(0),e.sort(S),E){while(t=e[o++])t===e[o]&&(i=r.push(o));while(i--)e.splice(r[i],1)}return e},o=ot.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=o(e)}else if(3===i||4===i)return e.nodeValue}else for(;t=e[r];r++)n+=o(t);return n},i=ot.selectors={cacheLength:50,createPseudo:at,match:J,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(nt,rt),e[3]=(e[4]||e[5]||"").replace(nt,rt),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||ot.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&ot.error(e[0]),e},PSEUDO:function(e){var t,n=!e[5]&&e[2];return J.CHILD.test(e[0])?null:(e[3]&&e[4]!==undefined?e[2]=e[4]:n&&V.test(n)&&(t=gt(n,!0))&&(t=n.indexOf(")",n.length-t)-n.length)&&(e[0]=e[0].slice(0,t),e[2]=n.slice(0,t)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(nt,rt).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=C[e+" "];return t||(t=RegExp("(^|"+M+")"+e+"("+M+"|$)"))&&C(e,function(e){return t.test("string"==typeof e.className&&e.className||typeof e.getAttribute!==j&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=ot.attr(r,e);return null==i?"!="===t:t?(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i+" ").indexOf(n)>-1:"|="===t?i===n||i.slice(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),s="last"!==e.slice(-4),a="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,u){var l,c,p,f,h,d,g=o!==s?"nextSibling":"previousSibling",m=t.parentNode,y=a&&t.nodeName.toLowerCase(),x=!u&&!a;if(m){if(o){while(g){p=t;while(p=p[g])if(a?p.nodeName.toLowerCase()===y:1===p.nodeType)return!1;d=g="only"===e&&!d&&"nextSibling"}return!0}if(d=[s?m.firstChild:m.lastChild],s&&x){c=m[v]||(m[v]={}),l=c[e]||[],h=l[0]===w&&l[1],f=l[0]===w&&l[2],p=h&&m.childNodes[h];while(p=++h&&p&&p[g]||(f=h=0)||d.pop())if(1===p.nodeType&&++f&&p===t){c[e]=[w,h,f];break}}else if(x&&(l=(t[v]||(t[v]={}))[e])&&l[0]===w)f=l[1];else while(p=++h&&p&&p[g]||(f=h=0)||d.pop())if((a?p.nodeName.toLowerCase()===y:1===p.nodeType)&&++f&&(x&&((p[v]||(p[v]={}))[e]=[w,f]),p===t))break;return f-=i,f===r||0===f%r&&f/r>=0}}},PSEUDO:function(e,t){var n,r=i.pseudos[e]||i.setFilters[e.toLowerCase()]||ot.error("unsupported pseudo: "+e);return r[v]?r(t):r.length>1?(n=[e,e,"",t],i.setFilters.hasOwnProperty(e.toLowerCase())?at(function(e,n){var i,o=r(e,t),s=o.length;while(s--)i=P.call(e,o[s]),e[i]=!(n[i]=o[s])}):function(e){return r(e,0,n)}):r}},pseudos:{not:at(function(e){var t=[],n=[],r=a(e.replace(z,"$1"));return r[v]?at(function(e,t,n,i){var o,s=r(e,null,i,[]),a=e.length;while(a--)(o=s[a])&&(e[a]=!(t[a]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),!n.pop()}}),has:at(function(e){return function(t){return ot(e,t).length>0}}),contains:at(function(e){return function(t){return(t.textContent||t.innerText||o(t)).indexOf(e)>-1}}),lang:at(function(e){return G.test(e||"")||ot.error("unsupported lang: "+e),e=e.replace(nt,rt).toLowerCase(),function(t){var n;do if(n=h?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===f},focus:function(e){return e===p.activeElement&&(!p.hasFocus||p.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeName>"@"||3===e.nodeType||4===e.nodeType)return!1;return!0},parent:function(e){return!i.pseudos.empty(e)},header:function(e){return et.test(e.nodeName)},input:function(e){return Z.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||t.toLowerCase()===e.type)},first:ht(function(){return[0]}),last:ht(function(e,t){return[t-1]}),eq:ht(function(e,t,n){return[0>n?n+t:n]}),even:ht(function(e,t){var n=0;for(;t>n;n+=2)e.push(n);return e}),odd:ht(function(e,t){var n=1;for(;t>n;n+=2)e.push(n);return e}),lt:ht(function(e,t,n){var r=0>n?n+t:n;for(;--r>=0;)e.push(r);return e}),gt:ht(function(e,t,n){var r=0>n?n+t:n;for(;t>++r;)e.push(r);return e})}},i.pseudos.nth=i.pseudos.eq;for(t in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})i.pseudos[t]=pt(t);for(t in{submit:!0,reset:!0})i.pseudos[t]=ft(t);function dt(){}dt.prototype=i.filters=i.pseudos,i.setFilters=new dt;function gt(e,t){var n,r,o,s,a,u,l,c=k[e+" "];if(c)return t?0:c.slice(0);a=e,u=[],l=i.preFilter;while(a){(!n||(r=_.exec(a)))&&(r&&(a=a.slice(r[0].length)||a),u.push(o=[])),n=!1,(r=X.exec(a))&&(n=r.shift(),o.push({value:n,type:r[0].replace(z," ")}),a=a.slice(n.length));for(s in i.filter)!(r=J[s].exec(a))||l[s]&&!(r=l[s](r))||(n=r.shift(),o.push({value:n,type:s,matches:r}),a=a.slice(n.length));if(!n)break}return t?a.length:a?ot.error(e):k(e,u).slice(0)}function mt(e){var t=0,n=e.length,r="";for(;n>t;t++)r+=e[t].value;return r}function yt(e,t,n){var i=t.dir,o=n&&"parentNode"===i,s=T++;return t.first?function(t,n,r){while(t=t[i])if(1===t.nodeType||o)return e(t,n,r)}:function(t,n,a){var u,l,c,p=w+" "+s;if(a){while(t=t[i])if((1===t.nodeType||o)&&e(t,n,a))return!0}else while(t=t[i])if(1===t.nodeType||o)if(c=t[v]||(t[v]={}),(l=c[i])&&l[0]===p){if((u=l[1])===!0||u===r)return u===!0}else if(l=c[i]=[p],l[1]=e(t,n,a)||r,l[1]===!0)return!0}}function vt(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function xt(e,t,n,r,i){var o,s=[],a=0,u=e.length,l=null!=t;for(;u>a;a++)(o=e[a])&&(!n||n(o,r,i))&&(s.push(o),l&&t.push(a));return s}function bt(e,t,n,r,i,o){return r&&!r[v]&&(r=bt(r)),i&&!i[v]&&(i=bt(i,o)),at(function(o,s,a,u){var l,c,p,f=[],h=[],d=s.length,g=o||Ct(t||"*",a.nodeType?[a]:a,[]),m=!e||!o&&t?g:xt(g,f,e,a,u),y=n?i||(o?e:d||r)?[]:s:m;if(n&&n(m,y,a,u),r){l=xt(y,h),r(l,[],a,u),c=l.length;while(c--)(p=l[c])&&(y[h[c]]=!(m[h[c]]=p))}if(o){if(i||e){if(i){l=[],c=y.length;while(c--)(p=y[c])&&l.push(m[c]=p);i(null,y=[],l,u)}c=y.length;while(c--)(p=y[c])&&(l=i?P.call(o,p):f[c])>-1&&(o[l]=!(s[l]=p))}}else y=xt(y===s?y.splice(d,y.length):y),i?i(null,s,y,u):O.apply(s,y)})}function wt(e){var t,n,r,o=e.length,s=i.relative[e[0].type],a=s||i.relative[" "],l=s?1:0,c=yt(function(e){return e===t},a,!0),p=yt(function(e){return P.call(t,e)>-1},a,!0),f=[function(e,n,r){return!s&&(r||n!==u)||((t=n).nodeType?c(e,n,r):p(e,n,r))}];for(;o>l;l++)if(n=i.relative[e[l].type])f=[yt(vt(f),n)];else{if(n=i.filter[e[l].type].apply(null,e[l].matches),n[v]){for(r=++l;o>r;r++)if(i.relative[e[r].type])break;return bt(l>1&&vt(f),l>1&&mt(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(z,"$1"),n,r>l&&wt(e.slice(l,r)),o>r&&wt(e=e.slice(r)),o>r&&mt(e))}f.push(n)}return vt(f)}function Tt(e,t){var n=0,o=t.length>0,s=e.length>0,a=function(a,l,c,f,h){var d,g,m,y=[],v=0,x="0",b=a&&[],T=null!=h,C=u,k=a||s&&i.find.TAG("*",h&&l.parentNode||l),N=w+=null==C?1:Math.random()||.1;for(T&&(u=l!==p&&l,r=n);null!=(d=k[x]);x++){if(s&&d){g=0;while(m=e[g++])if(m(d,l,c)){f.push(d);break}T&&(w=N,r=++n)}o&&((d=!m&&d)&&v--,a&&b.push(d))}if(v+=x,o&&x!==v){g=0;while(m=t[g++])m(b,y,l,c);if(a){if(v>0)while(x--)b[x]||y[x]||(y[x]=q.call(f));y=xt(y)}O.apply(f,y),T&&!a&&y.length>0&&v+t.length>1&&ot.uniqueSort(f)}return T&&(w=N,u=C),b};return o?at(a):a}a=ot.compile=function(e,t){var n,r=[],i=[],o=N[e+" "];if(!o){t||(t=gt(e)),n=t.length;while(n--)o=wt(t[n]),o[v]?r.push(o):i.push(o);o=N(e,Tt(i,r))}return o};function Ct(e,t,n){var r=0,i=t.length;for(;i>r;r++)ot(e,t[r],n);return n}function kt(e,t,r,o){var s,u,l,c,p,f=gt(e);if(!o&&1===f.length){if(u=f[0]=f[0].slice(0),u.length>2&&"ID"===(l=u[0]).type&&n.getById&&9===t.nodeType&&h&&i.relative[u[1].type]){if(t=(i.find.ID(l.matches[0].replace(nt,rt),t)||[])[0],!t)return r;e=e.slice(u.shift().value.length)}s=J.needsContext.test(e)?0:u.length;while(s--){if(l=u[s],i.relative[c=l.type])break;if((p=i.find[c])&&(o=p(l.matches[0].replace(nt,rt),U.test(u[0].type)&&t.parentNode||t))){if(u.splice(s,1),e=o.length&&mt(u),!e)return O.apply(r,o),r;break}}}return a(e,f)(o,t,!h,r,U.test(e)),r}n.sortStable=v.split("").sort(S).join("")===v,n.detectDuplicates=E,c(),n.sortDetached=ut(function(e){return 1&e.compareDocumentPosition(p.createElement("div"))}),ut(function(e){return e.innerHTML="","#"===e.firstChild.getAttribute("href")})||lt("type|href|height|width",function(e,t,n){return n?undefined:e.getAttribute(t,"type"===t.toLowerCase()?1:2)}),n.attributes&&ut(function(e){return e.innerHTML="",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||lt("value",function(e,t,n){return n||"input"!==e.nodeName.toLowerCase()?undefined:e.defaultValue}),ut(function(e){return null==e.getAttribute("disabled")})||lt(R,function(e,t,n){var r;return n?undefined:(r=e.getAttributeNode(t))&&r.specified?r.value:e[t]===!0?t.toLowerCase():null}),x.find=ot,x.expr=ot.selectors,x.expr[":"]=x.expr.pseudos,x.unique=ot.uniqueSort,x.text=ot.getText,x.isXMLDoc=ot.isXML,x.contains=ot.contains}(e);var D={};function A(e){var t=D[e]={};return x.each(e.match(w)||[],function(e,n){t[n]=!0}),t}x.Callbacks=function(e){e="string"==typeof e?D[e]||A(e):x.extend({},e);var t,n,r,i,o,s,a=[],u=!e.once&&[],l=function(p){for(t=e.memory&&p,n=!0,s=i||0,i=0,o=a.length,r=!0;a&&o>s;s++)if(a[s].apply(p[0],p[1])===!1&&e.stopOnFalse){t=!1;break}r=!1,a&&(u?u.length&&l(u.shift()):t?a=[]:c.disable())},c={add:function(){if(a){var n=a.length;(function s(t){x.each(t,function(t,n){var r=x.type(n);"function"===r?e.unique&&c.has(n)||a.push(n):n&&n.length&&"string"!==r&&s(n)})})(arguments),r?o=a.length:t&&(i=n,l(t))}return this},remove:function(){return a&&x.each(arguments,function(e,t){var n;while((n=x.inArray(t,a,n))>-1)a.splice(n,1),r&&(o>=n&&o--,s>=n&&s--)}),this},has:function(e){return e?x.inArray(e,a)>-1:!(!a||!a.length)},empty:function(){return a=[],o=0,this},disable:function(){return a=u=t=undefined,this},disabled:function(){return!a},lock:function(){return u=undefined,t||c.disable(),this},locked:function(){return!u},fireWith:function(e,t){return!a||n&&!u||(t=t||[],t=[e,t.slice?t.slice():t],r?u.push(t):l(t)),this},fire:function(){return c.fireWith(this,arguments),this},fired:function(){return!!n}};return c},x.extend({Deferred:function(e){var t=[["resolve","done",x.Callbacks("once memory"),"resolved"],["reject","fail",x.Callbacks("once memory"),"rejected"],["notify","progress",x.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return x.Deferred(function(n){x.each(t,function(t,o){var s=o[0],a=x.isFunction(e[t])&&e[t];i[o[1]](function(){var e=a&&a.apply(this,arguments);e&&x.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[s+"With"](this===r?n.promise():this,a?[e]:arguments)})}),e=null}).promise()},promise:function(e){return null!=e?x.extend(e,r):r}},i={};return r.pipe=r.then,x.each(t,function(e,o){var s=o[2],a=o[3];r[o[1]]=s.add,a&&s.add(function(){n=a},t[1^e][2].disable,t[2][2].lock),i[o[0]]=function(){return i[o[0]+"With"](this===i?r:this,arguments),this},i[o[0]+"With"]=s.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=d.call(arguments),r=n.length,i=1!==r||e&&x.isFunction(e.promise)?r:0,o=1===i?e:x.Deferred(),s=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?d.call(arguments):r,n===a?o.notifyWith(t,n):--i||o.resolveWith(t,n)}},a,u,l;if(r>1)for(a=Array(r),u=Array(r),l=Array(r);r>t;t++)n[t]&&x.isFunction(n[t].promise)?n[t].promise().done(s(t,l,n)).fail(o.reject).progress(s(t,u,a)):--i;return i||o.resolveWith(l,n),o.promise()}}),x.support=function(t){var n=o.createElement("input"),r=o.createDocumentFragment(),i=o.createElement("div"),s=o.createElement("select"),a=s.appendChild(o.createElement("option"));return n.type?(n.type="checkbox",t.checkOn=""!==n.value,t.optSelected=a.selected,t.reliableMarginRight=!0,t.boxSizingReliable=!0,t.pixelPosition=!1,n.checked=!0,t.noCloneChecked=n.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!a.disabled,n=o.createElement("input"),n.value="t",n.type="radio",t.radioValue="t"===n.value,n.setAttribute("checked","t"),n.setAttribute("name","t"),r.appendChild(n),t.checkClone=r.cloneNode(!0).cloneNode(!0).lastChild.checked,t.focusinBubbles="onfocusin"in e,i.style.backgroundClip="content-box",i.cloneNode(!0).style.backgroundClip="",t.clearCloneStyle="content-box"===i.style.backgroundClip,x(function(){var n,r,s="padding:0;margin:0;border:0;display:block;-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box",a=o.getElementsByTagName("body")[0];a&&(n=o.createElement("div"),n.style.cssText="border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px",a.appendChild(n).appendChild(i),i.innerHTML="",i.style.cssText="-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%",x.swap(a,null!=a.style.zoom?{zoom:1}:{},function(){t.boxSizing=4===i.offsetWidth}),e.getComputedStyle&&(t.pixelPosition="1%"!==(e.getComputedStyle(i,null)||{}).top,t.boxSizingReliable="4px"===(e.getComputedStyle(i,null)||{width:"4px"}).width,r=i.appendChild(o.createElement("div")),r.style.cssText=i.style.cssText=s,r.style.marginRight=r.style.width="0",i.style.width="1px",t.reliableMarginRight=!parseFloat((e.getComputedStyle(r,null)||{}).marginRight)),a.removeChild(n))}),t):t}({});var L,q,H=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,O=/([A-Z])/g;function F(){Object.defineProperty(this.cache={},0,{get:function(){return{}}}),this.expando=x.expando+Math.random()}F.uid=1,F.accepts=function(e){return e.nodeType?1===e.nodeType||9===e.nodeType:!0},F.prototype={key:function(e){if(!F.accepts(e))return 0;var t={},n=e[this.expando];if(!n){n=F.uid++;try{t[this.expando]={value:n},Object.defineProperties(e,t)}catch(r){t[this.expando]=n,x.extend(e,t)}}return this.cache[n]||(this.cache[n]={}),n},set:function(e,t,n){var r,i=this.key(e),o=this.cache[i];if("string"==typeof t)o[t]=n;else if(x.isEmptyObject(o))x.extend(this.cache[i],t);else for(r in t)o[r]=t[r];return o},get:function(e,t){var n=this.cache[this.key(e)];return t===undefined?n:n[t]},access:function(e,t,n){var r;return t===undefined||t&&"string"==typeof t&&n===undefined?(r=this.get(e,t),r!==undefined?r:this.get(e,x.camelCase(t))):(this.set(e,t,n),n!==undefined?n:t)},remove:function(e,t){var n,r,i,o=this.key(e),s=this.cache[o];if(t===undefined)this.cache[o]={};else{x.isArray(t)?r=t.concat(t.map(x.camelCase)):(i=x.camelCase(t),t in s?r=[t,i]:(r=i,r=r in s?[r]:r.match(w)||[])),n=r.length;while(n--)delete s[r[n]]}},hasData:function(e){return!x.isEmptyObject(this.cache[e[this.expando]]||{})},discard:function(e){e[this.expando]&&delete this.cache[e[this.expando]]}},L=new F,q=new F,x.extend({acceptData:F.accepts,hasData:function(e){return L.hasData(e)||q.hasData(e)},data:function(e,t,n){return L.access(e,t,n)},removeData:function(e,t){L.remove(e,t)},_data:function(e,t,n){return q.access(e,t,n)},_removeData:function(e,t){q.remove(e,t)}}),x.fn.extend({data:function(e,t){var n,r,i=this[0],o=0,s=null;if(e===undefined){if(this.length&&(s=L.get(i),1===i.nodeType&&!q.get(i,"hasDataAttrs"))){for(n=i.attributes;n.length>o;o++)r=n[o].name,0===r.indexOf("data-")&&(r=x.camelCase(r.slice(5)),P(i,r,s[r]));q.set(i,"hasDataAttrs",!0)}return s}return"object"==typeof e?this.each(function(){L.set(this,e)}):x.access(this,function(t){var n,r=x.camelCase(e);if(i&&t===undefined){if(n=L.get(i,e),n!==undefined)return n;if(n=L.get(i,r),n!==undefined)return n;if(n=P(i,r,undefined),n!==undefined)return n}else this.each(function(){var n=L.get(this,r);L.set(this,r,t),-1!==e.indexOf("-")&&n!==undefined&&L.set(this,e,t)})},null,t,arguments.length>1,null,!0)},removeData:function(e){return this.each(function(){L.remove(this,e)})}});function P(e,t,n){var r;if(n===undefined&&1===e.nodeType)if(r="data-"+t.replace(O,"-$1").toLowerCase(),n=e.getAttribute(r),"string"==typeof n){try{n="true"===n?!0:"false"===n?!1:"null"===n?null:+n+""===n?+n:H.test(n)?JSON.parse(n):n}catch(i){}L.set(e,t,n)}else n=undefined;return n}x.extend({queue:function(e,t,n){var r;return e?(t=(t||"fx")+"queue",r=q.get(e,t),n&&(!r||x.isArray(n)?r=q.access(e,t,x.makeArray(n)):r.push(n)),r||[]):undefined},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t),s=function(){x.dequeue(e,t) +};"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,s,o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return q.get(e,n)||q.access(e,n,{empty:x.Callbacks("once memory").add(function(){q.remove(e,[t+"queue",n])})})}}),x.fn.extend({queue:function(e,t){var n=2;return"string"!=typeof e&&(t=e,e="fx",n--),n>arguments.length?x.queue(this[0],e):t===undefined?this:this.each(function(){var n=x.queue(this,e,t);x._queueHooks(this,e),"fx"===e&&"inprogress"!==n[0]&&x.dequeue(this,e)})},dequeue:function(e){return this.each(function(){x.dequeue(this,e)})},delay:function(e,t){return e=x.fx?x.fx.speeds[e]||e:e,t=t||"fx",this.queue(t,function(t,n){var r=setTimeout(t,e);n.stop=function(){clearTimeout(r)}})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,t){var n,r=1,i=x.Deferred(),o=this,s=this.length,a=function(){--r||i.resolveWith(o,[o])};"string"!=typeof e&&(t=e,e=undefined),e=e||"fx";while(s--)n=q.get(o[s],e+"queueHooks"),n&&n.empty&&(r++,n.empty.add(a));return a(),i.promise(t)}});var R,M,W=/[\t\r\n\f]/g,$=/\r/g,B=/^(?:input|select|textarea|button)$/i;x.fn.extend({attr:function(e,t){return x.access(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})},prop:function(e,t){return x.access(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return this.each(function(){delete this[x.propFix[e]||e]})},addClass:function(e){var t,n,r,i,o,s=0,a=this.length,u="string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).addClass(e.call(this,t,this.className))});if(u)for(t=(e||"").match(w)||[];a>s;s++)if(n=this[s],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(W," "):" ")){o=0;while(i=t[o++])0>r.indexOf(" "+i+" ")&&(r+=i+" ");n.className=x.trim(r)}return this},removeClass:function(e){var t,n,r,i,o,s=0,a=this.length,u=0===arguments.length||"string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).removeClass(e.call(this,t,this.className))});if(u)for(t=(e||"").match(w)||[];a>s;s++)if(n=this[s],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(W," "):"")){o=0;while(i=t[o++])while(r.indexOf(" "+i+" ")>=0)r=r.replace(" "+i+" "," ");n.className=e?x.trim(r):""}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):x.isFunction(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if("string"===n){var t,i=0,o=x(this),s=e.match(w)||[];while(t=s[i++])o.hasClass(t)?o.removeClass(t):o.addClass(t)}else(n===r||"boolean"===n)&&(this.className&&q.set(this,"__className__",this.className),this.className=this.className||e===!1?"":q.get(this,"__className__")||"")})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;r>n;n++)if(1===this[n].nodeType&&(" "+this[n].className+" ").replace(W," ").indexOf(t)>=0)return!0;return!1},val:function(e){var t,n,r,i=this[0];{if(arguments.length)return r=x.isFunction(e),this.each(function(n){var i;1===this.nodeType&&(i=r?e.call(this,n,x(this).val()):e,null==i?i="":"number"==typeof i?i+="":x.isArray(i)&&(i=x.map(i,function(e){return null==e?"":e+""})),t=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()],t&&"set"in t&&t.set(this,i,"value")!==undefined||(this.value=i))});if(i)return t=x.valHooks[i.type]||x.valHooks[i.nodeName.toLowerCase()],t&&"get"in t&&(n=t.get(i,"value"))!==undefined?n:(n=i.value,"string"==typeof n?n.replace($,""):null==n?"":n)}}}),x.extend({valHooks:{option:{get:function(e){var t=e.attributes.value;return!t||t.specified?e.value:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,o="select-one"===e.type||0>i,s=o?null:[],a=o?i+1:r.length,u=0>i?a:o?i:0;for(;a>u;u++)if(n=r[u],!(!n.selected&&u!==i||(x.support.optDisabled?n.disabled:null!==n.getAttribute("disabled"))||n.parentNode.disabled&&x.nodeName(n.parentNode,"optgroup"))){if(t=x(n).val(),o)return t;s.push(t)}return s},set:function(e,t){var n,r,i=e.options,o=x.makeArray(t),s=i.length;while(s--)r=i[s],(r.selected=x.inArray(x(r).val(),o)>=0)&&(n=!0);return n||(e.selectedIndex=-1),o}}},attr:function(e,t,n){var i,o,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return typeof e.getAttribute===r?x.prop(e,t,n):(1===s&&x.isXMLDoc(e)||(t=t.toLowerCase(),i=x.attrHooks[t]||(x.expr.match.bool.test(t)?M:R)),n===undefined?i&&"get"in i&&null!==(o=i.get(e,t))?o:(o=x.find.attr(e,t),null==o?undefined:o):null!==n?i&&"set"in i&&(o=i.set(e,n,t))!==undefined?o:(e.setAttribute(t,n+""),n):(x.removeAttr(e,t),undefined))},removeAttr:function(e,t){var n,r,i=0,o=t&&t.match(w);if(o&&1===e.nodeType)while(n=o[i++])r=x.propFix[n]||n,x.expr.match.bool.test(n)&&(e[r]=!1),e.removeAttribute(n)},attrHooks:{type:{set:function(e,t){if(!x.support.radioValue&&"radio"===t&&x.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},propFix:{"for":"htmlFor","class":"className"},prop:function(e,t,n){var r,i,o,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return o=1!==s||!x.isXMLDoc(e),o&&(t=x.propFix[t]||t,i=x.propHooks[t]),n!==undefined?i&&"set"in i&&(r=i.set(e,n,t))!==undefined?r:e[t]=n:i&&"get"in i&&null!==(r=i.get(e,t))?r:e[t]},propHooks:{tabIndex:{get:function(e){return e.hasAttribute("tabindex")||B.test(e.nodeName)||e.href?e.tabIndex:-1}}}}),M={set:function(e,t,n){return t===!1?x.removeAttr(e,n):e.setAttribute(n,n),n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,t){var n=x.expr.attrHandle[t]||x.find.attr;x.expr.attrHandle[t]=function(e,t,r){var i=x.expr.attrHandle[t],o=r?undefined:(x.expr.attrHandle[t]=undefined)!=n(e,t,r)?t.toLowerCase():null;return x.expr.attrHandle[t]=i,o}}),x.support.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&t.parentNode&&t.parentNode.selectedIndex,null}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,t){return x.isArray(t)?e.checked=x.inArray(x(e).val(),t)>=0:undefined}},x.support.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var I=/^key/,z=/^(?:mouse|contextmenu)|click/,_=/^(?:focusinfocus|focusoutblur)$/,X=/^([^.]*)(?:\.(.+)|)$/;function U(){return!0}function Y(){return!1}function V(){try{return o.activeElement}catch(e){}}x.event={global:{},add:function(e,t,n,i,o){var s,a,u,l,c,p,f,h,d,g,m,y=q.get(e);if(y){n.handler&&(s=n,n=s.handler,o=s.selector),n.guid||(n.guid=x.guid++),(l=y.events)||(l=y.events={}),(a=y.handle)||(a=y.handle=function(e){return typeof x===r||e&&x.event.triggered===e.type?undefined:x.event.dispatch.apply(a.elem,arguments)},a.elem=e),t=(t||"").match(w)||[""],c=t.length;while(c--)u=X.exec(t[c])||[],d=m=u[1],g=(u[2]||"").split(".").sort(),d&&(f=x.event.special[d]||{},d=(o?f.delegateType:f.bindType)||d,f=x.event.special[d]||{},p=x.extend({type:d,origType:m,data:i,handler:n,guid:n.guid,selector:o,needsContext:o&&x.expr.match.needsContext.test(o),namespace:g.join(".")},s),(h=l[d])||(h=l[d]=[],h.delegateCount=0,f.setup&&f.setup.call(e,i,g,a)!==!1||e.addEventListener&&e.addEventListener(d,a,!1)),f.add&&(f.add.call(e,p),p.handler.guid||(p.handler.guid=n.guid)),o?h.splice(h.delegateCount++,0,p):h.push(p),x.event.global[d]=!0);e=null}},remove:function(e,t,n,r,i){var o,s,a,u,l,c,p,f,h,d,g,m=q.hasData(e)&&q.get(e);if(m&&(u=m.events)){t=(t||"").match(w)||[""],l=t.length;while(l--)if(a=X.exec(t[l])||[],h=g=a[1],d=(a[2]||"").split(".").sort(),h){p=x.event.special[h]||{},h=(r?p.delegateType:p.bindType)||h,f=u[h]||[],a=a[2]&&RegExp("(^|\\.)"+d.join("\\.(?:.*\\.|)")+"(\\.|$)"),s=o=f.length;while(o--)c=f[o],!i&&g!==c.origType||n&&n.guid!==c.guid||a&&!a.test(c.namespace)||r&&r!==c.selector&&("**"!==r||!c.selector)||(f.splice(o,1),c.selector&&f.delegateCount--,p.remove&&p.remove.call(e,c));s&&!f.length&&(p.teardown&&p.teardown.call(e,d,m.handle)!==!1||x.removeEvent(e,h,m.handle),delete u[h])}else for(h in u)x.event.remove(e,h+t[l],n,r,!0);x.isEmptyObject(u)&&(delete m.handle,q.remove(e,"events"))}},trigger:function(t,n,r,i){var s,a,u,l,c,p,f,h=[r||o],d=y.call(t,"type")?t.type:t,g=y.call(t,"namespace")?t.namespace.split("."):[];if(a=u=r=r||o,3!==r.nodeType&&8!==r.nodeType&&!_.test(d+x.event.triggered)&&(d.indexOf(".")>=0&&(g=d.split("."),d=g.shift(),g.sort()),c=0>d.indexOf(":")&&"on"+d,t=t[x.expando]?t:new x.Event(d,"object"==typeof t&&t),t.isTrigger=i?2:3,t.namespace=g.join("."),t.namespace_re=t.namespace?RegExp("(^|\\.)"+g.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,t.result=undefined,t.target||(t.target=r),n=null==n?[t]:x.makeArray(n,[t]),f=x.event.special[d]||{},i||!f.trigger||f.trigger.apply(r,n)!==!1)){if(!i&&!f.noBubble&&!x.isWindow(r)){for(l=f.delegateType||d,_.test(l+d)||(a=a.parentNode);a;a=a.parentNode)h.push(a),u=a;u===(r.ownerDocument||o)&&h.push(u.defaultView||u.parentWindow||e)}s=0;while((a=h[s++])&&!t.isPropagationStopped())t.type=s>1?l:f.bindType||d,p=(q.get(a,"events")||{})[t.type]&&q.get(a,"handle"),p&&p.apply(a,n),p=c&&a[c],p&&x.acceptData(a)&&p.apply&&p.apply(a,n)===!1&&t.preventDefault();return t.type=d,i||t.isDefaultPrevented()||f._default&&f._default.apply(h.pop(),n)!==!1||!x.acceptData(r)||c&&x.isFunction(r[d])&&!x.isWindow(r)&&(u=r[c],u&&(r[c]=null),x.event.triggered=d,r[d](),x.event.triggered=undefined,u&&(r[c]=u)),t.result}},dispatch:function(e){e=x.event.fix(e);var t,n,r,i,o,s=[],a=d.call(arguments),u=(q.get(this,"events")||{})[e.type]||[],l=x.event.special[e.type]||{};if(a[0]=e,e.delegateTarget=this,!l.preDispatch||l.preDispatch.call(this,e)!==!1){s=x.event.handlers.call(this,e,u),t=0;while((i=s[t++])&&!e.isPropagationStopped()){e.currentTarget=i.elem,n=0;while((o=i.handlers[n++])&&!e.isImmediatePropagationStopped())(!e.namespace_re||e.namespace_re.test(o.namespace))&&(e.handleObj=o,e.data=o.data,r=((x.event.special[o.origType]||{}).handle||o.handler).apply(i.elem,a),r!==undefined&&(e.result=r)===!1&&(e.preventDefault(),e.stopPropagation()))}return l.postDispatch&&l.postDispatch.call(this,e),e.result}},handlers:function(e,t){var n,r,i,o,s=[],a=t.delegateCount,u=e.target;if(a&&u.nodeType&&(!e.button||"click"!==e.type))for(;u!==this;u=u.parentNode||this)if(u.disabled!==!0||"click"!==e.type){for(r=[],n=0;a>n;n++)o=t[n],i=o.selector+" ",r[i]===undefined&&(r[i]=o.needsContext?x(i,this).index(u)>=0:x.find(i,this,null,[u]).length),r[i]&&r.push(o);r.length&&s.push({elem:u,handlers:r})}return t.length>a&&s.push({elem:this,handlers:t.slice(a)}),s},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(e,t){return null==e.which&&(e.which=null!=t.charCode?t.charCode:t.keyCode),e}},mouseHooks:{props:"button buttons clientX clientY offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(e,t){var n,r,i,s=t.button;return null==e.pageX&&null!=t.clientX&&(n=e.target.ownerDocument||o,r=n.documentElement,i=n.body,e.pageX=t.clientX+(r&&r.scrollLeft||i&&i.scrollLeft||0)-(r&&r.clientLeft||i&&i.clientLeft||0),e.pageY=t.clientY+(r&&r.scrollTop||i&&i.scrollTop||0)-(r&&r.clientTop||i&&i.clientTop||0)),e.which||s===undefined||(e.which=1&s?1:2&s?3:4&s?2:0),e}},fix:function(e){if(e[x.expando])return e;var t,n,r,i=e.type,s=e,a=this.fixHooks[i];a||(this.fixHooks[i]=a=z.test(i)?this.mouseHooks:I.test(i)?this.keyHooks:{}),r=a.props?this.props.concat(a.props):this.props,e=new x.Event(s),t=r.length;while(t--)n=r[t],e[n]=s[n];return e.target||(e.target=o),3===e.target.nodeType&&(e.target=e.target.parentNode),a.filter?a.filter(e,s):e},special:{load:{noBubble:!0},focus:{trigger:function(){return this!==V()&&this.focus?(this.focus(),!1):undefined},delegateType:"focusin"},blur:{trigger:function(){return this===V()&&this.blur?(this.blur(),!1):undefined},delegateType:"focusout"},click:{trigger:function(){return"checkbox"===this.type&&this.click&&x.nodeName(this,"input")?(this.click(),!1):undefined},_default:function(e){return x.nodeName(e.target,"a")}},beforeunload:{postDispatch:function(e){e.result!==undefined&&(e.originalEvent.returnValue=e.result)}}},simulate:function(e,t,n,r){var i=x.extend(new x.Event,n,{type:e,isSimulated:!0,originalEvent:{}});r?x.event.trigger(i,null,t):x.event.dispatch.call(t,i),i.isDefaultPrevented()&&n.preventDefault()}},x.removeEvent=function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n,!1)},x.Event=function(e,t){return this instanceof x.Event?(e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||e.getPreventDefault&&e.getPreventDefault()?U:Y):this.type=e,t&&x.extend(this,t),this.timeStamp=e&&e.timeStamp||x.now(),this[x.expando]=!0,undefined):new x.Event(e,t)},x.Event.prototype={isDefaultPrevented:Y,isPropagationStopped:Y,isImmediatePropagationStopped:Y,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=U,e&&e.preventDefault&&e.preventDefault()},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=U,e&&e.stopPropagation&&e.stopPropagation()},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=U,this.stopPropagation()}},x.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(e,t){x.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,o=e.handleObj;return(!i||i!==r&&!x.contains(r,i))&&(e.type=o.origType,n=o.handler.apply(this,arguments),e.type=t),n}}}),x.support.focusinBubbles||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=0,r=function(e){x.event.simulate(t,e.target,x.event.fix(e),!0)};x.event.special[t]={setup:function(){0===n++&&o.addEventListener(e,r,!0)},teardown:function(){0===--n&&o.removeEventListener(e,r,!0)}}}),x.fn.extend({on:function(e,t,n,r,i){var o,s;if("object"==typeof e){"string"!=typeof t&&(n=n||t,t=undefined);for(s in e)this.on(s,t,n,e[s],i);return this}if(null==n&&null==r?(r=t,n=t=undefined):null==r&&("string"==typeof t?(r=n,n=undefined):(r=n,n=t,t=undefined)),r===!1)r=Y;else if(!r)return this;return 1===i&&(o=r,r=function(e){return x().off(e),o.apply(this,arguments)},r.guid=o.guid||(o.guid=x.guid++)),this.each(function(){x.event.add(this,e,r,n,t)})},one:function(e,t,n,r){return this.on(e,t,n,r,1)},off:function(e,t,n){var r,i;if(e&&e.preventDefault&&e.handleObj)return r=e.handleObj,x(e.delegateTarget).off(r.namespace?r.origType+"."+r.namespace:r.origType,r.selector,r.handler),this;if("object"==typeof e){for(i in e)this.off(i,t,e[i]);return this}return(t===!1||"function"==typeof t)&&(n=t,t=undefined),n===!1&&(n=Y),this.each(function(){x.event.remove(this,e,n,t)})},trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,t){var n=this[0];return n?x.event.trigger(e,t,n,!0):undefined}});var G=/^.[^:#\[\.,]*$/,J=/^(?:parents|prev(?:Until|All))/,Q=x.expr.match.needsContext,K={children:!0,contents:!0,next:!0,prev:!0};x.fn.extend({find:function(e){var t,n=[],r=this,i=r.length;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;i>t;t++)if(x.contains(r[t],this))return!0}));for(t=0;i>t;t++)x.find(e,r[t],n);return n=this.pushStack(i>1?x.unique(n):n),n.selector=this.selector?this.selector+" "+e:e,n},has:function(e){var t=x(e,this),n=t.length;return this.filter(function(){var e=0;for(;n>e;e++)if(x.contains(this,t[e]))return!0})},not:function(e){return this.pushStack(et(this,e||[],!0))},filter:function(e){return this.pushStack(et(this,e||[],!1))},is:function(e){return!!et(this,"string"==typeof e&&Q.test(e)?x(e):e||[],!1).length},closest:function(e,t){var n,r=0,i=this.length,o=[],s=Q.test(e)||"string"!=typeof e?x(e,t||this.context):0;for(;i>r;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(11>n.nodeType&&(s?s.index(n)>-1:1===n.nodeType&&x.find.matchesSelector(n,e))){n=o.push(n);break}return this.pushStack(o.length>1?x.unique(o):o)},index:function(e){return e?"string"==typeof e?g.call(x(e),this[0]):g.call(this,e.jquery?e[0]:e):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){var n="string"==typeof e?x(e,t):x.makeArray(e&&e.nodeType?[e]:e),r=x.merge(this.get(),n);return this.pushStack(x.unique(r))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}});function Z(e,t){while((e=e[t])&&1!==e.nodeType);return e}x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return x.dir(e,"parentNode")},parentsUntil:function(e,t,n){return x.dir(e,"parentNode",n)},next:function(e){return Z(e,"nextSibling")},prev:function(e){return Z(e,"previousSibling")},nextAll:function(e){return x.dir(e,"nextSibling")},prevAll:function(e){return x.dir(e,"previousSibling")},nextUntil:function(e,t,n){return x.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return x.dir(e,"previousSibling",n)},siblings:function(e){return x.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return x.sibling(e.firstChild)},contents:function(e){return e.contentDocument||x.merge([],e.childNodes)}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(K[e]||x.unique(i),J.test(e)&&i.reverse()),this.pushStack(i)}}),x.extend({filter:function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},dir:function(e,t,n){var r=[],i=n!==undefined;while((e=e[t])&&9!==e.nodeType)if(1===e.nodeType){if(i&&x(e).is(n))break;r.push(e)}return r},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n}});function et(e,t,n){if(x.isFunction(t))return x.grep(e,function(e,r){return!!t.call(e,r,e)!==n});if(t.nodeType)return x.grep(e,function(e){return e===t!==n});if("string"==typeof t){if(G.test(t))return x.filter(t,e,n);t=x.filter(t,e)}return x.grep(e,function(e){return g.call(t,e)>=0!==n})}var tt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,nt=/<([\w:]+)/,rt=/<|&#?\w+;/,it=/<(?:script|style|link)/i,ot=/^(?:checkbox|radio)$/i,st=/checked\s*(?:[^=]|=\s*.checked.)/i,at=/^$|\/(?:java|ecma)script/i,ut=/^true\/(.*)/,lt=/^\s*\s*$/g,ct={option:[1,""],thead:[1,"","
    "],col:[2,"","
    "],tr:[2,"","
    "],td:[3,"","
    "],_default:[0,"",""]};ct.optgroup=ct.option,ct.tbody=ct.tfoot=ct.colgroup=ct.caption=ct.thead,ct.th=ct.td,x.fn.extend({text:function(e){return x.access(this,function(e){return e===undefined?x.text(this):this.empty().append((this[0]&&this[0].ownerDocument||o).createTextNode(e))},null,e,arguments.length)},append:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=pt(this,e);t.appendChild(e)}})},prepend:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=pt(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},remove:function(e,t){var n,r=e?x.filter(e,this):this,i=0;for(;null!=(n=r[i]);i++)t||1!==n.nodeType||x.cleanData(mt(n)),n.parentNode&&(t&&x.contains(n.ownerDocument,n)&&dt(mt(n,"script")),n.parentNode.removeChild(n));return this},empty:function(){var e,t=0;for(;null!=(e=this[t]);t++)1===e.nodeType&&(x.cleanData(mt(e,!1)),e.textContent="");return this},clone:function(e,t){return e=null==e?!1:e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return x.access(this,function(e){var t=this[0]||{},n=0,r=this.length;if(e===undefined&&1===t.nodeType)return t.innerHTML;if("string"==typeof e&&!it.test(e)&&!ct[(nt.exec(e)||["",""])[1].toLowerCase()]){e=e.replace(tt,"<$1>");try{for(;r>n;n++)t=this[n]||{},1===t.nodeType&&(x.cleanData(mt(t,!1)),t.innerHTML=e);t=0}catch(i){}}t&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=x.map(this,function(e){return[e.nextSibling,e.parentNode]}),t=0;return this.domManip(arguments,function(n){var r=e[t++],i=e[t++];i&&(r&&r.parentNode!==i&&(r=this.nextSibling),x(this).remove(),i.insertBefore(n,r))},!0),t?this:this.remove()},detach:function(e){return this.remove(e,!0)},domManip:function(e,t,n){e=f.apply([],e);var r,i,o,s,a,u,l=0,c=this.length,p=this,h=c-1,d=e[0],g=x.isFunction(d);if(g||!(1>=c||"string"!=typeof d||x.support.checkClone)&&st.test(d))return this.each(function(r){var i=p.eq(r);g&&(e[0]=d.call(this,r,i.html())),i.domManip(e,t,n)});if(c&&(r=x.buildFragment(e,this[0].ownerDocument,!1,!n&&this),i=r.firstChild,1===r.childNodes.length&&(r=i),i)){for(o=x.map(mt(r,"script"),ft),s=o.length;c>l;l++)a=r,l!==h&&(a=x.clone(a,!0,!0),s&&x.merge(o,mt(a,"script"))),t.call(this[l],a,l);if(s)for(u=o[o.length-1].ownerDocument,x.map(o,ht),l=0;s>l;l++)a=o[l],at.test(a.type||"")&&!q.access(a,"globalEval")&&x.contains(u,a)&&(a.src?x._evalUrl(a.src):x.globalEval(a.textContent.replace(lt,"")))}return this}}),x.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){x.fn[e]=function(e){var n,r=[],i=x(e),o=i.length-1,s=0;for(;o>=s;s++)n=s===o?this:this.clone(!0),x(i[s])[t](n),h.apply(r,n.get());return this.pushStack(r)}}),x.extend({clone:function(e,t,n){var r,i,o,s,a=e.cloneNode(!0),u=x.contains(e.ownerDocument,e);if(!(x.support.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(s=mt(a),o=mt(e),r=0,i=o.length;i>r;r++)yt(o[r],s[r]);if(t)if(n)for(o=o||mt(e),s=s||mt(a),r=0,i=o.length;i>r;r++)gt(o[r],s[r]);else gt(e,a);return s=mt(a,"script"),s.length>0&&dt(s,!u&&mt(e,"script")),a},buildFragment:function(e,t,n,r){var i,o,s,a,u,l,c=0,p=e.length,f=t.createDocumentFragment(),h=[];for(;p>c;c++)if(i=e[c],i||0===i)if("object"===x.type(i))x.merge(h,i.nodeType?[i]:i);else if(rt.test(i)){o=o||f.appendChild(t.createElement("div")),s=(nt.exec(i)||["",""])[1].toLowerCase(),a=ct[s]||ct._default,o.innerHTML=a[1]+i.replace(tt,"<$1>")+a[2],l=a[0];while(l--)o=o.lastChild;x.merge(h,o.childNodes),o=f.firstChild,o.textContent=""}else h.push(t.createTextNode(i));f.textContent="",c=0;while(i=h[c++])if((!r||-1===x.inArray(i,r))&&(u=x.contains(i.ownerDocument,i),o=mt(f.appendChild(i),"script"),u&&dt(o),n)){l=0;while(i=o[l++])at.test(i.type||"")&&n.push(i)}return f},cleanData:function(e){var t,n,r,i,o,s,a=x.event.special,u=0;for(;(n=e[u])!==undefined;u++){if(F.accepts(n)&&(o=n[q.expando],o&&(t=q.cache[o]))){if(r=Object.keys(t.events||{}),r.length)for(s=0;(i=r[s])!==undefined;s++)a[i]?x.event.remove(n,i):x.removeEvent(n,i,t.handle);q.cache[o]&&delete q.cache[o]}delete L.cache[n[L.expando]]}},_evalUrl:function(e){return x.ajax({url:e,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})}});function pt(e,t){return x.nodeName(e,"table")&&x.nodeName(1===t.nodeType?t:t.firstChild,"tr")?e.getElementsByTagName("tbody")[0]||e.appendChild(e.ownerDocument.createElement("tbody")):e}function ft(e){return e.type=(null!==e.getAttribute("type"))+"/"+e.type,e}function ht(e){var t=ut.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function dt(e,t){var n=e.length,r=0;for(;n>r;r++)q.set(e[r],"globalEval",!t||q.get(t[r],"globalEval"))}function gt(e,t){var n,r,i,o,s,a,u,l;if(1===t.nodeType){if(q.hasData(e)&&(o=q.access(e),s=q.set(t,o),l=o.events)){delete s.handle,s.events={};for(i in l)for(n=0,r=l[i].length;r>n;n++)x.event.add(t,i,l[i][n])}L.hasData(e)&&(a=L.access(e),u=x.extend({},a),L.set(t,u))}}function mt(e,t){var n=e.getElementsByTagName?e.getElementsByTagName(t||"*"):e.querySelectorAll?e.querySelectorAll(t||"*"):[];return t===undefined||t&&x.nodeName(e,t)?x.merge([e],n):n}function yt(e,t){var n=t.nodeName.toLowerCase();"input"===n&&ot.test(e.type)?t.checked=e.checked:("input"===n||"textarea"===n)&&(t.defaultValue=e.defaultValue)}x.fn.extend({wrapAll:function(e){var t;return x.isFunction(e)?this.each(function(t){x(this).wrapAll(e.call(this,t))}):(this[0]&&(t=x(e,this[0].ownerDocument).eq(0).clone(!0),this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstElementChild)e=e.firstElementChild;return e}).append(this)),this)},wrapInner:function(e){return x.isFunction(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=x.isFunction(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){x.nodeName(this,"body")||x(this).replaceWith(this.childNodes)}).end()}});var vt,xt,bt=/^(none|table(?!-c[ea]).+)/,wt=/^margin/,Tt=RegExp("^("+b+")(.*)$","i"),Ct=RegExp("^("+b+")(?!px)[a-z%]+$","i"),kt=RegExp("^([+-])=("+b+")","i"),Nt={BODY:"block"},Et={position:"absolute",visibility:"hidden",display:"block"},St={letterSpacing:0,fontWeight:400},jt=["Top","Right","Bottom","Left"],Dt=["Webkit","O","Moz","ms"];function At(e,t){if(t in e)return t;var n=t.charAt(0).toUpperCase()+t.slice(1),r=t,i=Dt.length;while(i--)if(t=Dt[i]+n,t in e)return t;return r}function Lt(e,t){return e=t||e,"none"===x.css(e,"display")||!x.contains(e.ownerDocument,e)}function qt(t){return e.getComputedStyle(t,null)}function Ht(e,t){var n,r,i,o=[],s=0,a=e.length;for(;a>s;s++)r=e[s],r.style&&(o[s]=q.get(r,"olddisplay"),n=r.style.display,t?(o[s]||"none"!==n||(r.style.display=""),""===r.style.display&&Lt(r)&&(o[s]=q.access(r,"olddisplay",Rt(r.nodeName)))):o[s]||(i=Lt(r),(n&&"none"!==n||!i)&&q.set(r,"olddisplay",i?n:x.css(r,"display"))));for(s=0;a>s;s++)r=e[s],r.style&&(t&&"none"!==r.style.display&&""!==r.style.display||(r.style.display=t?o[s]||"":"none"));return e}x.fn.extend({css:function(e,t){return x.access(this,function(e,t,n){var r,i,o={},s=0;if(x.isArray(t)){for(r=qt(e),i=t.length;i>s;s++)o[t[s]]=x.css(e,t[s],!1,r);return o}return n!==undefined?x.style(e,t,n):x.css(e,t)},e,t,arguments.length>1)},show:function(){return Ht(this,!0)},hide:function(){return Ht(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){Lt(this)?x(this).show():x(this).hide()})}}),x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=vt(e,"opacity");return""===n?"1":n}}}},cssNumber:{columnCount:!0,fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":"cssFloat"},style:function(e,t,n,r){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var i,o,s,a=x.camelCase(t),u=e.style;return t=x.cssProps[a]||(x.cssProps[a]=At(u,a)),s=x.cssHooks[t]||x.cssHooks[a],n===undefined?s&&"get"in s&&(i=s.get(e,!1,r))!==undefined?i:u[t]:(o=typeof n,"string"===o&&(i=kt.exec(n))&&(n=(i[1]+1)*i[2]+parseFloat(x.css(e,t)),o="number"),null==n||"number"===o&&isNaN(n)||("number"!==o||x.cssNumber[a]||(n+="px"),x.support.clearCloneStyle||""!==n||0!==t.indexOf("background")||(u[t]="inherit"),s&&"set"in s&&(n=s.set(e,n,r))===undefined||(u[t]=n)),undefined)}},css:function(e,t,n,r){var i,o,s,a=x.camelCase(t);return t=x.cssProps[a]||(x.cssProps[a]=At(e.style,a)),s=x.cssHooks[t]||x.cssHooks[a],s&&"get"in s&&(i=s.get(e,!0,n)),i===undefined&&(i=vt(e,t,r)),"normal"===i&&t in St&&(i=St[t]),""===n||n?(o=parseFloat(i),n===!0||x.isNumeric(o)?o||0:i):i}}),vt=function(e,t,n){var r,i,o,s=n||qt(e),a=s?s.getPropertyValue(t)||s[t]:undefined,u=e.style;return s&&(""!==a||x.contains(e.ownerDocument,e)||(a=x.style(e,t)),Ct.test(a)&&wt.test(t)&&(r=u.width,i=u.minWidth,o=u.maxWidth,u.minWidth=u.maxWidth=u.width=a,a=s.width,u.width=r,u.minWidth=i,u.maxWidth=o)),a};function Ot(e,t,n){var r=Tt.exec(t);return r?Math.max(0,r[1]-(n||0))+(r[2]||"px"):t}function Ft(e,t,n,r,i){var o=n===(r?"border":"content")?4:"width"===t?1:0,s=0;for(;4>o;o+=2)"margin"===n&&(s+=x.css(e,n+jt[o],!0,i)),r?("content"===n&&(s-=x.css(e,"padding"+jt[o],!0,i)),"margin"!==n&&(s-=x.css(e,"border"+jt[o]+"Width",!0,i))):(s+=x.css(e,"padding"+jt[o],!0,i),"padding"!==n&&(s+=x.css(e,"border"+jt[o]+"Width",!0,i)));return s}function Pt(e,t,n){var r=!0,i="width"===t?e.offsetWidth:e.offsetHeight,o=qt(e),s=x.support.boxSizing&&"border-box"===x.css(e,"boxSizing",!1,o);if(0>=i||null==i){if(i=vt(e,t,o),(0>i||null==i)&&(i=e.style[t]),Ct.test(i))return i;r=s&&(x.support.boxSizingReliable||i===e.style[t]),i=parseFloat(i)||0}return i+Ft(e,t,n||(s?"border":"content"),r,o)+"px"}function Rt(e){var t=o,n=Nt[e];return n||(n=Mt(e,t),"none"!==n&&n||(xt=(xt||x("