{"_id":"@k3imagine/routing-library","_rev":"62-34efa70fd4ebc3e9cede887aea4ae560","name":"@k3imagine/routing-library","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@k3imagine/routing-library","version":"0.1.0","keywords":["typescript","library-starter","rollup","jest"],"author":{"name":"Victor Valenzuela"},"license":"MIT","_id":"@k3imagine/routing-library@0.1.0","maintainers":[{"name":"tdog360","email":"tinnaa93@gmail.com"},{"name":"k3vineely","email":"vinee.ly@k3btg.com"},{"name":"brynjar.bragason.k3","email":"brynjar.bragason@k3btg.com"},{"name":"marinop","email":"marinop@gmail.com"},{"name":"a-kildahl","email":"anders.johansen@k3btg.com"},{"name":"k3imagine.com","email":"imagine@k3btg.com"},{"name":"victor.valenzuela.k3btg","email":"victor.valenzuela@k3btg.com"},{"name":"mattywarr","email":"matthew.warr@k3btg.com"}],"dist":{"shasum":"2375105f81c5fc507cb2e760dec0fe3b7feb432d","tarball":"https://registry.npmjs.org/@k3imagine/routing-library/-/routing-library-0.1.0.tgz","fileCount":103,"integrity":"sha512-piiGHGWLw9Kath3Uu5KHtUCx1+HhXQug5PVMl7eaP6vIw2RBurPkieFkevvCEW5VvNuo8ns3STx7OemYvOMmVw==","signatures":[{"sig":"MEYCIQCYHzEXh8tqKSPMTxBgN94vgbXFsuMHVa7iuW0r9jrA9QIhAPRpFOwI7w5NjKLtfBByYkbVyQYVLs22lvmsaS3yU6e9","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1935916,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJcD889CRA9TVsSAnZWagAAngwQAJSfqNk4ObjpZD3AqJCj\nUpArl2j7/k72resVNc6jTQpScICqHFmZhQE2PxzE0+RU4c9FTq4Rd5tZvimf\n8TepgxkdWR9KYRK6ayirjmH2BhQu5GwkDnWgiwWJGqdweznkYJh4WRDpJRfh\n5ZYNEH3e5eMj/jaN/fyVvcgxMpYLdk9WKJ8LHCsAAg38zYj9ZSBJWyApPBu1\nzedTy+OJdN2UkNygoaoRj2X/YrypVbzVto8UbJT/cmB1iwH4uz+sdF3gZcTz\nIT5hgzFhQHAz4cRizqfsxMEFyZOjbi9BFDDo4Tnc5XpkDfKC9K5NzVKjggzZ\nFsM64gdreDeTr2qBIeoUdL5YYu5hQQdPQwZh0uXRDnhDz3PKo551mTF7kkZT\nOY+x/aNJgI7MEKGaxg3/qRexnn5uPZvsTGVqiZGSHTUelkr2XhCGPEVt7uCo\nwPqhFH2EnF0jbVERZF2sZ1lf7xcrufX04bQik4l1e+nE6udBahlW7qrJ6KXm\nKDpKpb4jijrJX8Umxijl59VY89FF7QODxPab2RgKfLu7wAYc+vUzPDb00IEL\nW/Qes3JtTx3fvWsPagrqeSZwbcU6IJUi7a/DdCZWdoyh99RS3+sLG4U/VieH\nILvNVWyqgnsgnHmQna+t8OuBWqNT9mglCV0irggvFwkjwjmtukPtSOtp2cbN\nKEXX\r\n=p0q/\r\n-----END PGP SIGNATURE-----\r\n"},"main":"./bundles/index.umd.js","husky":{"hooks":{"pre-push":"npm run style && npm test -- --bail --onlyChanged","commit-msg":"commitlint --config config/commitlint.config.js -E HUSKY_GIT_PARAMS","pre-commit":"lint-staged"}},"config":{"commitizen":{"path":"./node_modules/cz-conventional-changelog"}},"es2015":"./esm2015/index.js","module":"./esm5/index.js","engines":{"node":">=8.5"},"scripts":{"docs":"typedoc -p . --theme minimal --target 'es6' --excludeNotExported --excludePrivate --ignoreCompilerErrors --exclude \"**/src/**/__tests__/*.*\" --out docs src/","lint":"tslint --project tsconfig.json --format codeFrame","size":"npm run size:umd && npm run size:fesm","test":"jest -c ./config/jest.config.js","build":"tsc && tsc --target es2018 --outDir dist/esm2015 && rollup -c config/rollup.config.js && rollup -c config/rollup.config.js --environment NODE_ENV:production","style":"npm run format -- --list-different && npm run lint","commit":"git-cz","format":"prettier --config config/prettier.config.js \"**/*.{ts,tsx,js,jsx,css,scss,sass,less,md}\"","verify":"npm run validate-js && npm run test:ci","cleanup":"shx rm -rf dist","release":"standard-version","test:ci":"npm t -- --ci","lint:fix":"npm run lint -- --fix","prebuild":"npm run cleanup && npm run verify","size:umd":"shx echo \"Gzipped+minified UMD bundle Size:\" && cross-var strip-json-comments --no-whitespace \"./dist/bundles/index.umd.min.js\" | gzip-size","postbuild":"node scripts/copy.js && npm run size","size:fesm":"shx echo \"Gzipped+minified FESM bundle Size:\" && strip-json-comments --no-whitespace \"./dist/bundles/index.esm.min.js\" | gzip-size","style:fix":"npm run format:fix && npm run lint:fix","format:fix":"npm run format -- --write","prerelease":"npm run build","test:watch":"npm t -- --watch","postrelease":"node scripts/copy.js && npm run release:github && npm run release:npm","release:npm":"cd dist && npm publish","validate-js":"tsc -p ./config && tsc -p ./scripts","test:coverage":"npm t -- --coverage","release:github":"git push --no-verify --follow-tags origin master","release:preflight":"cd dist && npm pack"},"typings":"./types/index.d.ts","_npmUser":{"name":"victor.valenzuela.k3btg","email":"victor.valenzuela@k3btg.com"},"repository":{"url":"https://www.github.com/K3Imagine/routing-library","type":"git"},"description":"Routing library for the Imagine project, taking you whenever you need to go","directories":{},"licenseText":"MIT License\n\nCopyright (c) 2018 Martin Hochel\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","lint-staged":{"src/**/*.{ts,tsx}":["git add"],"**/*.{ts,tsx,js,jsx,css,scss,sass,less,md}":["prettier --config config/prettier.config.js --write","git add"]},"sideEffects":false,"dependencies":{"axios":"0.18.0","rollup-plugin-node-builtins":"2.1.2"},"_hasShrinkwrap":false,"devDependencies":{"shx":"0.3.2","jest":"23.6.0","husky":"1.2.0","json5":"2.1.0","tldjs":"2.3.1","tslib":"1.9.3","rollup":"0.67.3","tslint":"5.11.0","ts-jest":"23.10.5","typedoc":"0.13.0","prettier":"1.15.2","cross-var":"1.1.0","es-cookie":"1.2.0","commitizen":"3.0.5","tslint-etc":"1.2.7","typescript":"2.9.2","@types/jest":"23.3.9","@types/node":"10.12.10","lint-staged":"8.1.0","@types/json5":"0.0.30","@types/tldjs":"2.3.0","tslint-react":"3.6.0","gzip-size-cli":"3.0.0","@commitlint/cli":"7.2.1","@types/chokidar":"1.7.5","@types/prettier":"1.15.1","sort-object-keys":"1.1.2","standard-version":"4.4.0","rollup-plugin-json":"3.1.0","jest-watch-typeahead":"0.2.0","rollup-plugin-terser":"3.0.0","rollup-plugin-uglify":"6.0.0","webpack-config-utils":"2.3.1","rollup-plugin-replace":"2.1.0","rollup-plugin-commonjs":"9.2.0","tslint-config-prettier":"1.16.0","tslint-config-standard":"8.0.1","strip-json-comments-cli":"1.0.1","rollup-plugin-sourcemaps":"0.4.2","cz-conventional-changelog":"2.1.0","rollup-plugin-node-resolve":"3.4.0","@types/webpack-config-utils":"2.3.0","@commitlint/config-conventional":"7.1.2"},"peerDependencies":{"tslib":">=1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/routing-library_0.1.0_1544539965030_0.5633664827981115","host":"s3://npm-registry-packages"}},"0.2.0":{"name":"@k3imagine/routing-library","version":"0.2.0","keywords":["typescript","library-starter","rollup","jest"],"author":{"name":"Victor Valenzuela"},"license":"MIT","_id":"@k3imagine/routing-library@0.2.0","maintainers":[{"name":"a-kildahl","email":"anders.johansen@k3btg.com"},{"name":"brynjar.bragason.k3","email":"brynjar.bragason@k3btg.com"},{"name":"k3imagine.com","email":"imagine@k3btg.com"},{"name":"k3vineely","email":"vinee.ly@k3btg.com"},{"name":"marinop","email":"marinop@gmail.com"},{"name":"mattywarr","email":"matthew.warr@k3btg.com"},{"name":"tdog360","email":"tinnaa93@gmail.com"},{"name":"victor.valenzuela.k3btg","email":"victor.valenzuela@k3btg.com"}],"dist":{"shasum":"c44f20a42c26ee3b0acba3b66a9cf905c9add87d","tarball":"https://registry.npmjs.org/@k3imagine/routing-library/-/routing-library-0.2.0.tgz","fileCount":87,"integrity":"sha512-bfpGQR9Fc2GrHcBFJ8DtkFGUZdK2AUYQV1+1wePTb2M63PkbFgrCeC/2IoCitItbUAJe3idbR2elgUSkT9Ekkg==","signatures":[{"sig":"MEYCIQDFDctUDmuio2XB8FDVTu7CI/VByO9Ki3F5Qo47VEH7aQIhALyhufmQ10hzoy3TVhIOmjbmzyU3DN3lI2rVQkJbrwlo","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":1912077,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJh2NXXCRA9TVsSAnZWagAA0VAP+wZuBFNhMqI8clKwWh93\nJ9V6QDTFI3ZeQPrxu72dAtS6VXKeKaBGg4M/hlp443UJA10YzUKy1Gqx5dgG\nlt4/BvFRV33UVlpyH+qKeKTHT6HKwo62k4Tk88tEee72kdf7DOJgdS6kpw9T\nDJK8mrLddDtvzCk2Zp30xdw2UGbeQ/yXgTp5uWz0uJc4NSXtb/Cbaj7aJKDR\n6Cu7qsWHs0WTnjrlc8lAPJhPlzjcYY0uplkJRgJ3A3VsL0I3zUR3n7DYjFPT\nicmn8w/ahmFFdXwZveGmH+kQSHz8tauE/TFVBS7+j0M/LL+AUC/3IGi4gszY\noSHqo0N8uUBptXn6CR2uvcsGPdjRdBzKot2egkYWKci43trjIJd+yphBAcSl\na2J5Koga1X0slTua01OSlJmogIcBWZ76dVpcjPr+6jOYqRt4DUVy2gcdcVM4\nSjr+Dsgc1LM5ZS/I0PSzLqYfo9RBlU5Lwkc/diJZFd76AZ0rAd0z0lnpqZ3r\ngXB2xIUztXm9Upc8Bz2CZKh89WQDxufls+PxVM6fPMUQxuuH6nbUJjc3N3Tn\nt5TxDWHEiukzaby/zHMaxI1HLNx/g1W9d9JdbQWvwSAh/8cq7/bTExFZLMeu\nEsDpJsgd7TJrEZSDUVZKjomfwgPzkcaK1bZYEFD5aIvDmLhSn2xcEUEZCgBv\n+9LP\r\n=8rBF\r\n-----END PGP SIGNATURE-----\r\n"},"main":"./dist/bundles/index.umd.js","es2015":"./dist/esm2015/index.js","module":"./dist/esm5/index.js","typings":"./dist/types/index.d.ts","_npmUser":{"name":"victor.valenzuela.k3btg","email":"victor.valenzuela@k3btg.com"},"repository":{"url":"https://www.github.com/K3Imagine/routing-library","type":"git"},"_npmVersion":"6.1.0","description":"Routing library for the Imagine project, taking you whenever you need to go","directories":{},"sideEffects":false,"_nodeVersion":"10.7.0","dependencies":{"axios":"0.18.0","rollup-plugin-node-builtins":"2.1.2"},"_hasShrinkwrap":false,"peerDependencies":{"tslib":">=1.9.0"},"_npmOperationalInternal":{"tmp":"tmp/routing-library_0.2.0_1544540576191_0.8563591044545933","host":"s3://npm-registry-packages"}}},"time":{"created":"2018-12-11T14:52:45.029Z","modified":"2026-03-02T16:39:05.689Z","0.1.0":"2018-12-11T14:52:45.242Z","0.2.0":"2018-12-11T15:02:56.366Z"},"author":{"name":"Victor Valenzuela"},"license":"MIT","keywords":["typescript","library-starter","rollup","jest"],"repository":{"url":"https://www.github.com/K3Imagine/routing-library","type":"git"},"description":"Routing library for the Imagine project, taking you whenever you need to go","maintainers":[{"email":"imagine@k3btg.com","name":"k3imagine.com"},{"email":"simon@retalia.com","name":"sismith"},{"email":"dave@retalia.com","name":"daveretalia"},{"email":"adalsteinn@retalia.com","name":"adalsteinn"},{"email":"mahendra@retalia.com","name":"mahendra.retalia"},{"email":"adam@retalia.com","name":"adamchramiecretalia"},{"email":"tom@retalia.com","name":"tomretalia"}],"readme":"# Typescript lib starter\r\n\r\n[![Greenkeeper badge](https://badges.greenkeeper.io/Hotell/typescript-lib-starter.svg)](https://greenkeeper.io/)\r\n\r\n[![Build Status](https://travis-ci.org/Hotell/typescript-lib-starter.svg?branch=master)](https://travis-ci.org/Hotell/typescript-lib-starter)\r\n[![NPM version](https://img.shields.io/npm/v/%40martin_hotell%2Ftypescript-lib-starter.svg)](https://www.npmjs.com/package/@martin_hotell/typescript-lib-starter)\r\n![Downloads](https://img.shields.io/npm/dm/@martin_hotell/typescript-lib-starter.svg)\r\n[![Standard Version](https://img.shields.io/badge/release-standard%20version-brightgreen.svg)](https://github.com/conventional-changelog/standard-version)\r\n[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier)\r\n[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)\r\n\r\nThis npm library starter:\r\n\r\n- creates package for both Node and Browser\r\n- build will creates 4 standard \"package\" formats:\r\n - `umd` 👉 UMD bundle for Node and Browser\r\n > `main` field in package.json\r\n - `esm5` 👉 transpiled files to ES5 + es2015 modules for tree shaking\r\n > `module` field in package.json\r\n - `esm2015` 👉 raw javascript files transpiled from typescript to latest ES standard ( es2018 )\r\n > `es2015` field in package.json\r\n >\r\n > this is useful if you wanna transpile everything or just wanna ship untranspiled esNext code for evergreen browsers)\r\n - `fesm` 👉 experimental bundle type introduced by Angular team (TL;DR: it's an es2015 flattened bundle, like UMD but with latest ECMAscript and JS modules)\r\n- type definitions are automatically generated and shipped with your package\r\n - > `types` field in package.json\r\n- `sideEffects` 👉 [support proper tree-shaking](https://webpack.js.org/guides/tree-shaking/#mark-the-file-as-side-effect-free) for whole library ( Webpack >= 4). Turn this off or adjust as needed if your modules are not pure!\r\n\r\n## Start coding in 4 steps !\r\n\r\n1. `git clone https://github.com/Hotell/typescript-lib-starter && cd $_`\r\n\r\n2. `rm -rf .git && git init`\r\n\r\n3. in `package.json` reset following fields:\r\n\r\n```diff\r\n{\r\n- \"name\": \"@next-gen/typescript-lib-starter\",\r\n+ \"name\": \"{yourLibraryPackageName}\",\r\n- \"version\": \"1.7.0\",\r\n+ \"version\": \"1.0.0\",\r\n- \"description\": \"TypeScript library setup for multiple compilation targets using tsc and webpack\",\r\n+ \"description\": \"What is your library all about...\",\r\n- \"keywords\": [ \"typescript\", \"library-starter\", \"rollup\", \"jest\" ]\r\n+ \"keywords\": [ \"typescript\", \"your library keyowrds\" ]\r\n- \"author\": \"Martin Hochel\",\r\n+ \"author\": \"{yourName}\",\r\n- \"license\": \"MIT\",\r\n+ \"license\": \"{yourLicense}\",\r\n \"repository\": {\r\n \"type\": \"git\",\r\n- \"url\": \"https://www.github.com/Hotell/typescript-lib-starter\"\r\n+ \"url\": \"https://www.github.com/{yourAccountName}/{yourLibraryPackageName}\"\r\n }\r\n}\r\n```\r\n\r\n4. Install all dependencies `yarn install`\r\n\r\nHappy coding ! 🖖\r\n\r\n## Consumption of published library:\r\n\r\n1. install it 🤖\r\n\r\n```sh\r\nyarn add my-new-library\r\n# OR\r\nnpm install my-new-library\r\n```\r\n\r\n1. use it 💪\r\n\r\n### Webpack\r\n\r\n> #### NOTE:\r\n>\r\n> Don't forget to turn off ES modules transpilation to enable tree-shaking!\r\n>\r\n> - babel: `{\"modules\": false}`\r\n> - typescript: `{\"module\": \"esnext\"}`\r\n\r\n```ts\r\n// main.ts or main.js\r\nimport { Greeter } from 'my-new-library'\r\n\r\nconst mountPoint = document.getElementById('app')\r\nconst App = () => {\r\n const greeter = new Greeter('Stranger')\r\n return `

${greeter.greet()}

`\r\n}\r\nconst render = (Root: Function, where: HTMLElement) => {\r\n where.innerHTML = Root()\r\n}\r\n\r\nrender(App, mountPoint)\r\n```\r\n\r\n```html\r\n\r\n\r\n \r\n \r\n \r\n \r\n
\r\n \r\n\r\n```\r\n\r\n### UMD/ES2015 module aware browsers ( no bundler )\r\n\r\n```html\r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n
\r\n \r\n\r\n```\r\n\r\n## Publish your library\r\n\r\n> #### NOTE:\r\n>\r\n> you have to create npm account and register token on your machine\r\n> 👉 `npm adduser`\r\n>\r\n> If you are using scope ( you definitely should 👌) don't forget to [`--scope`](https://docs.npmjs.com/cli/adduser#scope)\r\n\r\nExecute `yarn release` which will handle following tasks:\r\n\r\n- bump package version and git tag\r\n- update/(create if it doesn't exist) CHANGELOG.md\r\n- push to github master branch + push tags\r\n- publish build packages to npm\r\n\r\n> **NOTE:**\r\n>\r\n> all package files are gonna be within `/dist` folder from where `npm publish` will be executed\r\n\r\n> releases are handled by awesome [standard-version](https://github.com/conventional-changelog/standard-version)\r\n\r\n### Initial Release (without bumping package.json version):\r\n\r\n`yarn release --first-release`\r\n\r\n### Pre-release\r\n\r\n- To get from `1.1.2` to `1.1.2-0`:\r\n\r\n`yarn release --prerelease`\r\n\r\n- **Alpha**: To get from `1.1.2` to `1.1.2-alpha.0`:\r\n\r\n`yarn release --prerelease alpha`\r\n\r\n- **Beta**: To get from `1.1.2` to `1.1.2-beta.0`:\r\n\r\n`yarn release --prerelease beta`\r\n\r\n### Dry run mode\r\n\r\nSee what commands would be run, without committing to git or updating files\r\n\r\n`yarn release --dry-run`\r\n\r\n## Check what files are gonna be published to npm\r\n\r\n- `cd dist && yarn pack` OR `yarn release:preflight` which will create a tarball with everything that would get published to NPM\r\n\r\n## Check size of your published NPM bundle\r\n\r\n`yarn size`\r\n\r\n## Format and fix lint errors\r\n\r\n`yarn ts:style:fix`\r\n\r\n## Generate documentation\r\n\r\n`yarn docs`\r\n\r\n## Commit ( via commitizen )\r\n\r\n- this is preferred way how to create conventional-changelog valid commits\r\n- if you prefer your custom tool we provide a commit hook linter which will error out, it you provide invalid commit message\r\n- if you are in rush and just wanna skip commit message validation just prefix your message with `WIP: something done` ( if you do this please squash your work when you're done with proper commit message so standard-version can create Changelog and bump version of your library appropriately )\r\n\r\n`yarn commit` - will invoke [commitizen CLI](https://github.com/commitizen/cz-cli)\r\n\r\n### Troubleshooting\r\n\r\n#### dynamic `import()`\r\n\r\nThis starter uses latest **TypeScript >=2.9** which has support for lazy loading chunks/modules via `import()` and also definition acquisition via [`import('../path-to-module').TypeFoo`](http://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-9.html#import-types)\r\n\r\nBefore TS 2.9, it wasn't possible to properly generate ambient definitions if you used dynamic `import()`. This works now as expected without any hacks ❤️ !\r\n\r\n---\r\n\r\n> ### Before TS 2.9\r\n>\r\n> Please note that if you wanna use that feature, compiler will complain because declaration generation is turned on, and currently TS can't handle type generation with types that will be loaded in the future ( lazily )\r\n>\r\n> **How to solve this:**\r\n>\r\n> - turn of type checking and don't generate types for that lazy import: `import('./components/button') as any`\r\n> - or you can use this [temporary workaround](https://github.com/Microsoft/TypeScript/issues/16603#issuecomment-310208259)\r\n","readmeFilename":"README.md"}