node_modules ignore

This commit is contained in:
2025-05-08 23:43:47 +02:00
parent e19d52f172
commit 4574544c9f
65041 changed files with 10593536 additions and 0 deletions

906
server/node_modules/xdg-app-paths/CHANGELOG.mkd generated vendored Normal file
View File

@@ -0,0 +1,906 @@
<!-- deno-fmt-ignore-file -->
<!-- lint disable -->
<!-- markdownlint-disable -->
<!-- spellchecker:disable -->
# CHANGELOG <br/> [xdg-app-paths](https://github.com/rivy/js.xdg-app-paths)
<div style="font-size: 0.9em; line-height: 1.1em;">
> This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
> <br/>
> The changelog format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) using [conventional/semantic commits](https://nitayneeman.com/posts/understanding-semantic-commit-messages-using-git-and-angular).<small><sup>[`@`](https://archive.is/jnup8)</sup></small>
</div>
<div id='last-line-of-prefix'></div>
---
## [v8.3.0](https://github.com/rivy/js.xdg-app-paths/compare/v8.2.0...v8.3.0) <small>(2023-02-06)</small>
<details open><summary><small><em>[v8.3.0; details]</em></small></summary>
#### Fixes
* bugfix ~ (package) work-around for `npm publish` bug (see GH:npm/cli[#6137](https://github.com/rivy/js.xdg-app-paths/issues/6137)) &ac; [`6ffa1d4`](https://github.com/rivy/js.xdg-app-paths/commit/6ffa1d47f445bb5c35c463523124861ace90c9b6)
#### Dependency Updates
* update *(deps)*: (up-to XDG-v10.6.0); latest &ac; [`48b7319`](https://github.com/rivy/js.xdg-app-paths/commit/48b7319054a11539535aa30e0231b5e0d17b7eae)
#### Documentation
* docs ~ (README) commentary polish &ac; [`231753a`](https://github.com/rivy/js.xdg-app-paths/commit/231753aa39a3c797f8a0b5d5d65284466c112134)
* docs ~ (README) revise setup/build/test instructions &ac; [`294ba7f`](https://github.com/rivy/js.xdg-app-paths/commit/294ba7ffa698b1421be9f8cd37333ecd2459944d)
* docs ~ fix updated ESLint complaints (eslint-comments/no-unused-disable) &ac; [`1ec73ce`](https://github.com/rivy/js.xdg-app-paths/commit/1ec73ceb6f826dc20baac5efd34ebb303b453e5b)
* docs ~ add `cspell` dictionary word(s) &ac; [`1953225`](https://github.com/rivy/js.xdg-app-paths/commit/195322579614b95eda1ae63da5a08eead47c501f)
* docs ~ (README) update download/install URLs and commentary &ac; [`d6bc6a6`](https://github.com/rivy/js.xdg-app-paths/commit/d6bc6a696a608a07ccca95a647baf59ca2f879b0)
* docs ~ (README) fix/polish discussion commentary &ac; [`f5b7bd5`](https://github.com/rivy/js.xdg-app-paths/commit/f5b7bd5d13468ac12245411add1b4693f58228d8)
* docs ~ (README) fix formatting errors &ac; [`566002c`](https://github.com/rivy/js.xdg-app-paths/commit/566002c1b03c986985e0db5e085880c6ceda03bc)
* docs ~ (README) fix GHA workflow badge &ac; [`0f636e3`](https://github.com/rivy/js.xdg-app-paths/commit/0f636e3c71eedc5b6740953249602b792317a7cd)
* docs ~ (README) fix reproducible install instructions &ac; [`7880836`](https://github.com/rivy/js.xdg-app-paths/commit/7880836bedf1336fc3a782025a0bc29b9069b803)
* docs ~ (README) remove references to TravisCI &ac; [`1998740`](https://github.com/rivy/js.xdg-app-paths/commit/1998740dc20474b327dd9f0d1e0c5a3800bb3f6f)
* docs ~ add `cspell` dictionary word(s) &ac; [`9081e91`](https://github.com/rivy/js.xdg-app-paths/commit/9081e91157121b613a00306778b4357d4599c7c0)
#### Maintenance
* maint *(CICD)*: (TravisCI) *remove* TravisCI (TravisCI no longer supports FOSS) &ac; [`8cca2b0`](https://github.com/rivy/js.xdg-app-paths/commit/8cca2b0ba6147c121a4b2ebb3fa92a791197837c)
* maint *(build)*: (package) add color to 'help' output &ac; [`bb9e206`](https://github.com/rivy/js.xdg-app-paths/commit/bb9e2065e272d8c85b3259b194d9fbe189f00890)
* maint *(build)*: prepare support for 'modern' v2+ `yarn` &ac; [`6004d2c`](https://github.com/rivy/js.xdg-app-paths/commit/6004d2cf8da4992a8276363578e5c8ed93e81673)
* maint *(build)*: (package) fix coverage view/send branch logic &ac; [`b77ad7a`](https://github.com/rivy/js.xdg-app-paths/commit/b77ad7acbedaf94b702f21217f8561d9ec43f23b)
* maint *(build)*: add `bmp` configuration &ac; [`7ab1c7e`](https://github.com/rivy/js.xdg-app-paths/commit/7ab1c7e0a62ef81058f397e17c54947b50e8d28b)
* maint *(build)*: (package) move coverage data storage to less visible location &ac; [`53ba291`](https://github.com/rivy/js.xdg-app-paths/commit/53ba291244dcb6f236ea1e67324d7c5a58f911a2)
* maint *(build)*: (package) add `npm audit` linter &ac; [`43badbd`](https://github.com/rivy/js.xdg-app-paths/commit/43badbd084e8ebbe0822312014cebd3498e9c004)
* maint *(build)*: (package) enable handling of scoped package names &ac; [`c7862ac`](https://github.com/rivy/js.xdg-app-paths/commit/c7862acc93c2fe321ec5c5485be94332c547a7e9)
* maint *(build)*: (package) remove 'rimraf' (use `shx rm -fr ...`) &ac; [`c7476b1`](https://github.com/rivy/js.xdg-app-paths/commit/c7476b1685fab4bb1be3ea80c1040e55f5c7719a)
* maint *(build)*: (package) fix coverage HTML output target &ac; [`fa60bde`](https://github.com/rivy/js.xdg-app-paths/commit/fa60bde855635be041a112834332c60d68212589)
* maint *(build)*: (package) add final NL for non-WinOS output equivalence &ac; [`4ee0d3e`](https://github.com/rivy/js.xdg-app-paths/commit/4ee0d3e76cfc6d89041c1a4a7dfd22ac52eb4a16)
* maint *(deps)*: update deps locks (NodeJS v10.23.1, npm v7.24.2, yarn v1.22.19) &ac; [`569c185`](https://github.com/rivy/js.xdg-app-paths/commit/569c1851ae96617d4342ef281458bf70acffa2b0)
* maint *(dev)*: (deps) revise/loosen `eslint` related deps &ac; [`a3e15fa`](https://github.com/rivy/js.xdg-app-paths/commit/a3e15fa5a50ea5087903f2984ab34aaec254b93a)
* maint *(dev)*: revise various configs for 'modern' v2+ `yarn` use &ac; [`47e7591`](https://github.com/rivy/js.xdg-app-paths/commit/47e759164a4258e95f25941c2ea7cfbe8c54af15)
* maint *(dev)*: (markdown-lint/Remark) update config; adds dual use (Deno or NodeJS projects) &ac; [`2b22938`](https://github.com/rivy/js.xdg-app-paths/commit/2b2293869f2a70c693618565eecab75d03d5d79d)
* maint *(dev)*: (Prettier) update config; adds dual use (Deno or NodeJS projects) &ac; [`6bdb066`](https://github.com/rivy/js.xdg-app-paths/commit/6bdb066b6b3286f61331d3801d353aec7bc23246)
* maint *(dev)*: (gitignore) update config notes &ac; [`c70aa5a`](https://github.com/rivy/js.xdg-app-paths/commit/c70aa5a2874eefb1575b2a5089718530ed54403d)
* maint *(dev)*: (ESLint) update config; merge Deno and JS configs &ac; [`9ddfaee`](https://github.com/rivy/js.xdg-app-paths/commit/9ddfaee484fa8fbedb25fe2cb9f265afaecd0595)
* maint *(dev)*: (CommitLint) update config; add relaxed linting for development &ac; [`7712fcf`](https://github.com/rivy/js.xdg-app-paths/commit/7712fcf4deec348fbba3800d63f79d7a7fecb801)
* maint *(dev)*: (git-changelog) configuration and template updates &ac; [`4f82518`](https://github.com/rivy/js.xdg-app-paths/commit/4f82518ca77133bb1bc068742a5a03c9f0a1aa81)
</details>
---
## [v8.2.0](https://github.com/rivy/js.xdg-app-paths/compare/v8.1.1...v8.2.0) <small>(2022-08-13)</small>
<details><summary><small><em>[v8.2.0; details]</em></small></summary>
#### Dependency Updates
* update Deno deps (*down-to* std[@0](https://github.com/0).134.0; *pin*); avoid permission prompt(s) &ac; [`0b81528`](https://github.com/rivy/js.xdg-app-paths/commit/0b815284bb79358bd347e2faf85479046a748c68)
* update *(deps)*: (up-to XDG-v10.5.0); uses std[@0](https://github.com/0).134.0 &ac; [`e59d677`](https://github.com/rivy/js.xdg-app-paths/commit/e59d677ffdd802184886e2809af6f1d4976efdd6)
#### Documentation
* docs ~ (README) revise Package/Publish notes (removing tag/version check) &ac; [`f22ce18`](https://github.com/rivy/js.xdg-app-paths/commit/f22ce186aaeab853380c987599558e009115c21b)
#### Maintenance
* maint *(CICD)*: (GHA) add platform label to coverage uploads (via `--flags=...`) &ac; [`dbe1a7c`](https://github.com/rivy/js.xdg-app-paths/commit/dbe1a7c07e2674b16c5fd1bef9d8578a2e7089c4)
* maint *(CICD)*: (GHA) expand NodeJS test versions &ac; [`0a8cccb`](https://github.com/rivy/js.xdg-app-paths/commit/0a8cccb37fc9b20a067f064c9df7a8f71243bda6)
* maint *(CICD)*: (TravisCI) expand NodeJS test versions &ac; [`105ecfe`](https://github.com/rivy/js.xdg-app-paths/commit/105ecfe92892a1910f9432c719656084b7f817d8)
* maint *(build)*: add `refresh` (aka `rebuild:all`) and `refresh:dist` run target &ac; [`bf4b446`](https://github.com/rivy/js.xdg-app-paths/commit/bf4b44617660ef9d510e6b46cbd7e3b4492885c1)
* maint *(build)*: (package) add '_:debug:env' run target &ac; [`774c3d3`](https://github.com/rivy/js.xdg-app-paths/commit/774c3d3fe921d9dc52bd4e78835da22cd68b907e)
* maint *(build)*: (package) revise 'cov:send' to support user-defined options &ac; [`a6fb3b8`](https://github.com/rivy/js.xdg-app-paths/commit/a6fb3b8aceab0af1db5b2c9d9f25f179e74d05f6)
* maint *(build)*: (package) commit linters now check more deeply/robustly into past commits &ac; [`445ae2b`](https://github.com/rivy/js.xdg-app-paths/commit/445ae2b837921e657050451f4867bc943a51400f)
* maint *(build)*: (package) revise help generation to match HELP_TEXT more narrowly; add commentary &ac; [`afe7e5b`](https://github.com/rivy/js.xdg-app-paths/commit/afe7e5bed2833a38c686fded4bd0ccfde6222407)
* maint *(build)*: (package) revise and surface availability of test harness options to user &ac; [`c4080c1`](https://github.com/rivy/js.xdg-app-paths/commit/c4080c13952fe354ca75363644bb7c7246b60b9c)
* maint *(dev)*: (CommitLint) allow fixup!/squash! commits iff not prerelease &ac; [`1f3a1a2`](https://github.com/rivy/js.xdg-app-paths/commit/1f3a1a223a195b42d7d081913f1bf4a58d1aa6de)
* maint *(dev)*: revise `cspell` to allow local exceptions &ac; [`6a30e83`](https://github.com/rivy/js.xdg-app-paths/commit/6a30e83434ec0eb9f139c31f306a7102250e6d17)
* maint *(dev)*: add CodeCov config (reports will be solely informational/no-fail) &ac; [`0bc475d`](https://github.com/rivy/js.xdg-app-paths/commit/0bc475d49213a2aa47c6c11dd28ef17910bfca5f)
* maint *(dev)*: (CommitLint) update (improves commit lints, capturing more flawed commits) &ac; [`ba1bf28`](https://github.com/rivy/js.xdg-app-paths/commit/ba1bf283b726c35969c40328a8cc0939a5041fde)
#### Test Improvements
* tests ~ revise ESLint directives (local preferred over global) &ac; [`56deca1`](https://github.com/rivy/js.xdg-app-paths/commit/56deca18d54450fbf91533cb228d7684484c27f0)
* test *(refactor)*: move version consistency checks from package lint to distribution test &ac; [`1ddba6c`](https://github.com/rivy/js.xdg-app-paths/commit/1ddba6c6537b115061d73ef7cb83e8103316dae9)
</details>
---
## [v8.1.1](https://github.com/rivy/js.xdg-app-paths/compare/v8.1.0...v8.1.1) <small>(2022-08-06)</small>
<details><summary><small><em>[v8.1.1; details]</em></small></summary>
#### Documentation
* docs ~ (eg) update os-paths import versions &ac; [`0460f8b`](https://github.com/rivy/js.xdg-app-paths/commit/0460f8bfb8c167edd350a5357cae97b149e78c11)
</details>
---
## [v8.1.0](https://github.com/rivy/js.xdg-app-paths/compare/v8.0.2...v8.1.0) <small>(2022-08-06)</small>
<details><summary><small><em>[v8.1.0; details]</em></small></summary>
#### Dependency Updates
* update Deno deps (up-to std[@0](https://github.com/0).150.0) &ac; [`e7f8729`](https://github.com/rivy/js.xdg-app-paths/commit/e7f87297583e156bc403a496e5b7049e47e223c4)
* update *(deps)*: (up-to XDG-v10.2.0) * uses std[@0](https://github.com/0).150.0 &ac; [`cbc9e45`](https://github.com/rivy/js.xdg-app-paths/commit/cbc9e45cc9cd8e26c446d8cc862cf57d9662af73)
#### Documentation
* docs ~ (eg) add Deno permissions gates &ac; [`ff46640`](https://github.com/rivy/js.xdg-app-paths/commit/ff46640dc6ab716c53fb4107a50c329b95acc299)
* docs ~ (eg) update Deno (up-to std[@0](https://github.com/0).150.0) &ac; [`42c348f`](https://github.com/rivy/js.xdg-app-paths/commit/42c348f1797238d076c0687f8372b2b83b6a83f0)
* docs ~ (README) improve Packaging/Publishing instructions &ac; [`920867d`](https://github.com/rivy/js.xdg-app-paths/commit/920867d2235661c8174ade5002c95abc6c303176)
#### Maintenance
* maint *(dev)*: (package) refactor 'prerelease' and 'prepublishOnly' for clarity &ac; [`554458c`](https://github.com/rivy/js.xdg-app-paths/commit/554458cb393d18d52b4c8ca70260f1ccbed64fad)
* maint *(dev)*: revise/update TypeScript 'tsconfig' files &ac; [`df9443f`](https://github.com/rivy/js.xdg-app-paths/commit/df9443f2dd12df4346912dd98d5ed97248ae9a22)
* maint *(dev)*: add/restore *.test.* and *.spec.* to ignore-list for `nyc` coverage calculations &ac; [`a8c1003`](https://github.com/rivy/js.xdg-app-paths/commit/a8c10033c953021c177416bff0b73af5d4f32af3)
</details>
---
## [v8.0.2](https://github.com/rivy/js.xdg-app-paths/compare/v8.0.1...v8.0.2) <small>(2022-08-06)</small>
<details><summary><small><em>[v8.0.2; details]</em></small></summary>
#### Dependency Updates
* update *(deps)*: (up-to XDG-v10.0.0); *no-panic*/*no-prompt* import (for Deno platform-adapter) &ac; [`b88e427`](https://github.com/rivy/js.xdg-app-paths/commit/b88e42744d8c77d92119b1dd275d7cae1267e1b4)
#### Maintenance
* maint *(dev)*: narrow/reduce ignore-list for `nyc` coverage calculations &ac; [`7a43c9e`](https://github.com/rivy/js.xdg-app-paths/commit/7a43c9e971182bd78b3d43acc5934d7fd8b5a7bc)
#### Test Improvements
* tests ~ return to *.test.* test file name (re-enables automatic `ava` testing) &ac; [`40898b7`](https://github.com/rivy/js.xdg-app-paths/commit/40898b735644de12bca796489c0ad3fc25778035)
* tests ~ restore 100% test coverage &ac; [`d646f00`](https://github.com/rivy/js.xdg-app-paths/commit/d646f008f34e2b29dbe9fbe90ee00da4aea5c001)
</details>
---
## [v8.0.1](https://github.com/rivy/js.xdg-app-paths/compare/v8.0.0...v8.0.1) <small>(2022-08-05)</small>
<details><summary><small><em>[v8.0.1; details]</em></small></summary>
#### Documentation
* docs ~ (eg) update xdg-app-paths import versions &ac; [`2a49f2d`](https://github.com/rivy/js.xdg-app-paths/commit/2a49f2d6416f5fe42fa8bf25a621d827bd2a6834)
* docs ~ (README) update versions for import examples &ac; [`9d083b5`](https://github.com/rivy/js.xdg-app-paths/commit/9d083b55200125e39c0d42a8f72808efb4b01f55)
</details>
---
## [v8.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v7.3.0...v8.0.0) <small>(2022-08-04)</small>
<details><summary><small><em>[v8.0.0; details]</em></small></summary>
#### Changes
* change ~ (deno) avoid panic if read permission is not granted &ac; [`50133da`](https://github.com/rivy/js.xdg-app-paths/commit/50133da858aad6dc5520e0d6513b948c8f0e4f46)
* change ~ use '$eval' as final application name fallback &ac; [`685282e`](https://github.com/rivy/js.xdg-app-paths/commit/685282ed96c7b82a94f4d24daa23d95df56aa934)
* change *(!)*: add graceful degradation for missing permission(s) (avoiding Deno panic or prompt) &ac; [`8fed4ae`](https://github.com/rivy/js.xdg-app-paths/commit/8fed4ae47273b743074f42468bb4e26d03ff4363)
#### Fixes
* fix *(deps)*: hack around early version `npm ci` failure &ac; [`eb6a8e4`](https://github.com/rivy/js.xdg-app-paths/commit/eb6a8e4532b05a1127ac2352bf7c0e95c697612c)
#### Dependency Updates
* update *(deps)*: (up-to XDG-v10.0.0); *no-panic*/*no-prompt* import &ac; [`7474149`](https://github.com/rivy/js.xdg-app-paths/commit/7474149452bd29dfe2b621cdc083433e9a87f979)
#### Documentation
* docs ~ (eg) fix `deno lint` complaint (ban-ts-comment) &ac; [`387ea3d`](https://github.com/rivy/js.xdg-app-paths/commit/387ea3da97b2b1a6a501fa3144b175dbb5b0daa8)
* docs ~ (tests) revise spell-checker exceptions &ac; [`8f9386e`](https://github.com/rivy/js.xdg-app-paths/commit/8f9386e7aad2b2c754d85651253eb61fb329da07)
* docs ~ (README) add markdown-lint complaint exception (no-emphasis-as-heading) &ac; [`3e69cda`](https://github.com/rivy/js.xdg-app-paths/commit/3e69cdab60b4927d2dbe5805dba10707d24b8951)
* docs ~ (README) update Deno requirements &ac; [`98c2968`](https://github.com/rivy/js.xdg-app-paths/commit/98c2968443e1a8878cde3889899bfb403d7cce92)
* docs ~ (README) add new developer run targets to summary &ac; [`e3335f6`](https://github.com/rivy/js.xdg-app-paths/commit/e3335f6c98bd6cc02d832e3b1b1fd8e1ca834ebb)
* docs ~ (README) updated build/contribution documentation &ac; [`ea18173`](https://github.com/rivy/js.xdg-app-paths/commit/ea18173c5b41f2f294a105160bba66e5f8019aac)
* docs ~ (README) revise markdown-lint exception directives &ac; [`ba82a9a`](https://github.com/rivy/js.xdg-app-paths/commit/ba82a9a9e4ed00f3c06645a80a564d7639b0568a)
* docs ~ (README) stabilize formatting against changes by deno and/or dprint formatters &ac; [`fbaf0e4`](https://github.com/rivy/js.xdg-app-paths/commit/fbaf0e4db89f9f4c4f15e672073d910beffe189c)
* docs ~ (README) add clarity/polish &ac; [`9d69967`](https://github.com/rivy/js.xdg-app-paths/commit/9d699678a151435f81a1e473b2c5dcc70312e9fb)
* docs ~ add `cspell` dictionary word(s) &ac; [`b733497`](https://github.com/rivy/js.xdg-app-paths/commit/b733497bcf184a1327efa6bdf2d9635774d7100c)
* docs ~ add spell-checker exceptions &ac; [`7e3195d`](https://github.com/rivy/js.xdg-app-paths/commit/7e3195d3b8e406b90b9305dd2cbeb138f75db686)
* docs ~ update to note '$eval' as final app name fallback &ac; [`9b14142`](https://github.com/rivy/js.xdg-app-paths/commit/9b14142fe0ca29399f9ca94347c87608af903b1e)
#### Maintenance
* maint *(CICD)*: add a step showing dependencies to GHA CI and polish commentary &ac; [`bd7608f`](https://github.com/rivy/js.xdg-app-paths/commit/bd7608f2f6c1d2ec8afb848ddca1a4cb509b6216)
* maint *(build)*: (package.json) fix/improve/update development run targets &ac; [`685d90a`](https://github.com/rivy/js.xdg-app-paths/commit/685d90a08ab18b5140b52f1a590f3c27824623f8)
* maint *(build)*: expand TS compiler exclusions to exclude '*[._]spec.*' and '*[._]test.*' files &ac; [`5149056`](https://github.com/rivy/js.xdg-app-paths/commit/51490569a42569787a30646ca646219d7457f114)
* maint *(build)*: add 'deno' to main exports to publicize Deno support &ac; [`c59d5aa`](https://github.com/rivy/js.xdg-app-paths/commit/c59d5aa402cda04c07dd73265eee5f2dcc494416)
* maint *(build)*: revise destination/naming for transpiled test code (testbed => lab) &ac; [`1efbb69`](https://github.com/rivy/js.xdg-app-paths/commit/1efbb69a5bf0653c6f63c96f8561207019cbb87d)
* maint *(deps)*: store package locks (for CI/dev reproducibility) &ac; [`608710b`](https://github.com/rivy/js.xdg-app-paths/commit/608710bbf4e4d8a2f3b1cf0d67cceef1e4f9fc30)
* maint *(deps)*: update package locks &ac; [`5b65ea6`](https://github.com/rivy/js.xdg-app-paths/commit/5b65ea670a2ff12e3ad9365d1579e5d9493612ef)
* maint *(dev)*: update EditorConfig &ac; [`164e558`](https://github.com/rivy/js.xdg-app-paths/commit/164e5588eab668676b56ebbc33ac2f28d2ec254c)
* maint *(dev)*: update VSCode settings &ac; [`478adb3`](https://github.com/rivy/js.xdg-app-paths/commit/478adb381d46578a637a2a3259bb70092103be91)
* maint *(dev)*: (markdown-lint/Remark) disable list-item-spacing checks &ac; [`f2db43a`](https://github.com/rivy/js.xdg-app-paths/commit/f2db43ac92210120ae3536d7fffc82debe1f2e52)
* maint *(dev)*: update Prettier configuration/ignores &ac; [`ed804c2`](https://github.com/rivy/js.xdg-app-paths/commit/ed804c2202e81df1157dadca69b4324e6113b1d6)
* maint *(dev)*: configure git for storage of package lock files within '.deps-lock' &ac; [`0c11120`](https://github.com/rivy/js.xdg-app-paths/commit/0c11120e06d4d984f2e5627db46a73fcd0fad740)
* maint *(dev)*: (gitattributes) fix, revise, and polish commentary &ac; [`e35eedd`](https://github.com/rivy/js.xdg-app-paths/commit/e35eedd333a202edfe879855a27dcd1f37b6b5ed)
* maint *(dev)*: (gitattributes) revise commentary and add version stamp &ac; [`9a8ad70`](https://github.com/rivy/js.xdg-app-paths/commit/9a8ad70559fb9220cd54bd73ecb69fca347c4107)
* maint *(dev)*: (ESLint) ignore 'vendor' files (and polish) &ac; [`444deb9`](https://github.com/rivy/js.xdg-app-paths/commit/444deb9723792941f1ffe1bc0c9e73102e2819d0)
* maint *(dev)*: add and use EditorConfig-checker config file &ac; [`0076cb3`](https://github.com/rivy/js.xdg-app-paths/commit/0076cb3760d7767d14519eb117d4e086beb529fd)
* maint *(dev)*: consolidate and polish CommitLint configuration &ac; [`f23e11b`](https://github.com/rivy/js.xdg-app-paths/commit/f23e11bc84d83c567c9eca70ea43cca30ed735a3)
* maint *(dev)*: (QA) update CodeClimate config (polish) &ac; [`b83845c`](https://github.com/rivy/js.xdg-app-paths/commit/b83845c8949302ad44a9e0244845e8e914b0e2fc)
* maint *(dev)*: (QA) update Codacy config (polish) &ac; [`bdebabd`](https://github.com/rivy/js.xdg-app-paths/commit/bdebabd21d24a98eb7aca99a073f980b699d1cfe)
* maint *(dev)*: (git-changelog) template fixes and improvements &ac; [`39a0f09`](https://github.com/rivy/js.xdg-app-paths/commit/39a0f094a15944c145f9fae39691ddd181ce0a06)
* maint *(dev)*: (git-changelog) configuration fixes and improvements &ac; [`10cabdf`](https://github.com/rivy/js.xdg-app-paths/commit/10cabdf2c291614290676943e8af09e384a2996a)
* maint *(dev)*: update vendored deno types (up-to Deno v1.8.0) &ac; [`82aeedf`](https://github.com/rivy/js.xdg-app-paths/commit/82aeedf89d54344b9e4974aae732a93805d74935)
* maint *(dev)*: (vendor) treat all vendor code as 'binary' to reduce useless diff output &ac; [`54df78a`](https://github.com/rivy/js.xdg-app-paths/commit/54df78a1a1c8e401349710d665dba7de7d5869d3)
* maint *(dev)*: add Scrutinizer configuration &ac; [`6014421`](https://github.com/rivy/js.xdg-app-paths/commit/601442115d1fd5eb67a3ef4ad6b9770bd4960457)
* maint *(dev)*: (deps) update (and *pin*) deps &ac; [`0532ff1`](https://github.com/rivy/js.xdg-app-paths/commit/0532ff103b8e0b3a3c5073d962c778f305c79881)
* maint *(dev)*: revise `rollup` type bundling process &ac; [`4177edd`](https://github.com/rivy/js.xdg-app-paths/commit/4177edd625efc45b173b690bddaf64fd35dea951)
* maint *(dev)*: (gitattributes) remove top-level .deps-lock specifics (favor localized config) &ac; [`f61d123`](https://github.com/rivy/js.xdg-app-paths/commit/f61d123b581d3efacca9fd8ff52a82819affe9be)
* maint *(dev)*: (package) fix 'rebuild:lab' to include a copy of esm-wrapper &ac; [`1519ee4`](https://github.com/rivy/js.xdg-app-paths/commit/1519ee4df0639b570c0c7c32873450805e2c2f64)
* maint *(dev)*: (fix) use 'https:' protocol (instead of 'git:') for direct GitHub dependency &ac; [`de05ab1`](https://github.com/rivy/js.xdg-app-paths/commit/de05ab1c6ffc8c76070155de312856acd44515f6)
* maint *(dev)*: add `dprint` formatting exceptions &ac; [`7c80052`](https://github.com/rivy/js.xdg-app-paths/commit/7c80052ea7dabfc754566e2d439326e433d8f387)
* maint *(dev)*: block `deno fmt` (poor defaults; non-customizable) &ac; [`8c59b51`](https://github.com/rivy/js.xdg-app-paths/commit/8c59b51e4b4f5607fa33ce9e295f41bd8c26145b)
#### Refactoring
* refactor *(polish)*: fix `deno lint` complaint (ban-ts-comment) &ac; [`068eb0c`](https://github.com/rivy/js.xdg-app-paths/commit/068eb0c9456c859b7384fe743b2744af49e18f53)
* refactor *(polish)*: `npm run fix:style` &ac; [`4554669`](https://github.com/rivy/js.xdg-app-paths/commit/4554669d9b58b0be466f4475d09577ea8cd667d4)
#### Test Improvements
* tests ~ add additional type tests &ac; [`5c381c8`](https://github.com/rivy/js.xdg-app-paths/commit/5c381c80c22dac5547129bf56160d862f106f65b)
* tests ~ correct skip text and minor comment revision &ac; [`6b816b0`](https://github.com/rivy/js.xdg-app-paths/commit/6b816b0c20fd0fe698d3e8bd66ab1ce44e85c5ef)
* tests ~ improve test feedback/logging (adds STDERR output) &ac; [`4064979`](https://github.com/rivy/js.xdg-app-paths/commit/4064979a902802ca62abde85d5b3157745eb9b4a)
* tests ~ fix `deno lint` complaint (camel-case) &ac; [`7cc6b2b`](https://github.com/rivy/js.xdg-app-paths/commit/7cc6b2bc073c362523116d09a583c59e2e5ee770)
* tests ~ version gate Deno example run testing &ac; [`69fd4aa`](https://github.com/rivy/js.xdg-app-paths/commit/69fd4aa5c7da09f70a2cc932e3f2bdfc4123eb1b)
* tests ~ revise ESLint exception directives &ac; [`41f4dea`](https://github.com/rivy/js.xdg-app-paths/commit/41f4deae9cdaccdfa359a22ff114238037e6d722)
* tests ~ deno loads module without panic or prompt (while using *no permissions*) &ac; [`e6ba58c`](https://github.com/rivy/js.xdg-app-paths/commit/e6ba58c4b5fa98573162c8a555b5156f90d60f10)
* tests ~ refactor/rename for clarity/consistency and DRY &ac; [`1f8bcfc`](https://github.com/rivy/js.xdg-app-paths/commit/1f8bcfcdc5678c2b124051d1ac15f784fe929918)
* tests ~ fix `--test-dist` flag detection &ac; [`feb5dda`](https://github.com/rivy/js.xdg-app-paths/commit/feb5ddac3667e23523f941a10c84445a4e7c1188)
* tests ~ revise in-place test file name for clarity vs code files &ac; [`a1e1429`](https://github.com/rivy/js.xdg-app-paths/commit/a1e1429b31b1ca88322dd500e736b605b8fea0d7)
* test *(fix)*: expand Deno version gate criteria for example execution testing &ac; [`2712cac`](https://github.com/rivy/js.xdg-app-paths/commit/2712cac59a3034ca73828ab5d71baf9f56f07aa6)
#### BREAKING CHANGE
Adds a Deno v1.8.0+ minimum version requirement.
</details>
---
## [v7.3.0](https://github.com/rivy/js.xdg-app-paths/compare/v7.2.0...v7.3.0) <small>(2021-02-27)</small>
<details><summary><small><em>[v7.3.0; details]</em></small></summary>
#### Documentation
* docs ~ (README) sync with JSDocs descriptions &ac; [`6ab0c02`](https://github.com/rivy/js.xdg-app-paths/commit/6ab0c027b742032a077aa0de70e92adea778b1f5)
* docs ~ JSDocs polish &ac; [`0833db2`](https://github.com/rivy/js.xdg-app-paths/commit/0833db2c0f2f02fc1cc8dc848027dbdb27b2a007)
* docs ~ add `cspell` dictionary word(s) &ac; [`25540e4`](https://github.com/rivy/js.xdg-app-paths/commit/25540e4dcf2c039d2d929aa0595e6c2f1c3fc2a4)
#### Maintenance
* maint *(deps)*: add 'typedoc' (dev; for future use) &ac; [`fd8e7f0`](https://github.com/rivy/js.xdg-app-paths/commit/fd8e7f05c90a84cf208d37ef701b302078598028)
</details>
---
## [v7.2.0](https://github.com/rivy/js.xdg-app-paths/compare/v7.1.1...v7.2.0) <small>(2021-02-21)</small>
<details><summary><small><em>[v7.2.0; details]</em></small></summary>
#### Documentation
* docs ~ revise `XDGAppPaths` interface/type (show methods not properties) &ac; [`ca428a4`](https://github.com/rivy/js.xdg-app-paths/commit/ca428a496da2601bb27afec8db735d0e22cad5af)
* docs ~ redefine `XDGAppPaths` as an interface (for better automatic doc generation) &ac; [`fa6717c`](https://github.com/rivy/js.xdg-app-paths/commit/fa6717c5ac20ce6400a424c97cac9843ca123c39)
* docs ~ add JSDocs descriptions &ac; [`9765b63`](https://github.com/rivy/js.xdg-app-paths/commit/9765b638731739cb864e4899d0b7c91ba97aed45)
#### Maintenance
* maint *(build)*: remove unneeded intermediate 'default' export object &ac; [`6c4d26b`](https://github.com/rivy/js.xdg-app-paths/commit/6c4d26b10c05bb76ac14ee9403df00d5a0a38732)
* maint *(build)*: fix CJS type rewrite &ac; [`15c007f`](https://github.com/rivy/js.xdg-app-paths/commit/15c007facdb98f9012557cefd8f62bc40c60b320)
#### Refactoring
* refactor ~ replace intermediate default export object to improve `deno docs` results &ac; [`7d5e0d2`](https://github.com/rivy/js.xdg-app-paths/commit/7d5e0d29b908767664c4a36e48b6fd35f9bd3a6c)
</details>
---
## [v7.1.1](https://github.com/rivy/js.xdg-app-paths/compare/v7.1.0...v7.1.1) <small>(2021-02-21)</small>
<details><summary><small><em>[v7.1.1; details]</em></small></summary>
#### Documentation
* docs ~ README corrections &ac; [`b68009c`](https://github.com/rivy/js.xdg-app-paths/commit/b68009c32e79d42622b6955a6e02d7f9e62c641d)
</details>
---
## [v7.1.0](https://github.com/rivy/js.xdg-app-paths/compare/v7.0.0...v7.1.0) <small>(2021-02-20)</small>
<details><summary><small><em>[v7.1.0; details]</em></small></summary>
#### Documentation
* docs ~ add Deno examples using remote imports &ac; [`d5fb0a9`](https://github.com/rivy/js.xdg-app-paths/commit/d5fb0a97e6eb5d8dce696f3df5e21bd097396145)
* docs ~ disable `remark` lint complaint (maximum-heading-length) &ac; [`a521003`](https://github.com/rivy/js.xdg-app-paths/commit/a521003e3aa2c71425d40035a329fbb44ec638a5)
* docs ~ (README) fix Deno required permissions list &ac; [`add23f7`](https://github.com/rivy/js.xdg-app-paths/commit/add23f7ce6b02f41765ae5a3e324c92191d6a50e)
</details>
---
## [v7.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v6.0.0...v7.0.0) <small>(2021-02-20)</small>
Add support for [Deno](https://deno.land).
<details><summary><small><em>[v7.0.0; details]</em></small></summary>
#### Changes
* add support for Deno &ac; [`09fb1d3`](https://github.com/rivy/js.xdg-app-paths/commit/09fb1d37084d15419c83ae92bad29064cf005199)
#### Documentation
* docs ~ README revisions for Deno &ac; [`2d09289`](https://github.com/rivy/js.xdg-app-paths/commit/2d0928976e901db1d660200eb2a4a7f3e916fd28)
* docs ~ add Deno example &ac; [`5a64a43`](https://github.com/rivy/js.xdg-app-paths/commit/5a64a4315f77487049630119c4eea51ef2da4045)
#### Maintenance
* maint *(dev)*: add Deno types &ac; [`57c6ba7`](https://github.com/rivy/js.xdg-app-paths/commit/57c6ba71ccc52934eb08c4dadd17149326f7b1c4)
#### Refactoring
* refactor ~ add support (Platform.Adapter) for other platforms (eg, Deno) &ac; [`1c6405a`](https://github.com/rivy/js.xdg-app-paths/commit/1c6405a775d46814a79fbb6b8c918d2a2e97c2e8)
#### Test Improvements
* tests ~ add Deno example test to '--test-dist' testing &ac; [`68d1e3c`](https://github.com/rivy/js.xdg-app-paths/commit/68d1e3c90cdc625041a62389a0851e04e3208a46)
</details>
---
## [v6.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.5.1...v6.0.0) <small>(2021-02-20)</small>
The `XDGAppPaths` project has undergone a full conversion to TypeScript.
CJS and ESM packages, as well as the associated type declarations, are generated from
the source TypeScript and are then packaged and stored within the project repository
(ie, a 'dist' model).
Exports are now all declared via 'exports' in the package configuration file (but with
continued support for older non-'exports' aware tooling). And all project exports/packages
are available both directly from the project repository or via various distributors
(jsdelivr, npmJS, ...).
<details><summary><small><em>[v6.0.0; details]</em></small></summary>
#### Changes
* add support for 'pkg' packaged applications &ac; [`5d405f2`](https://github.com/rivy/js.xdg-app-paths/commit/5d405f2e99b2c44864f21dd4628960d05c5c6421)
* add 'hack' to correctly auto-generate `$name` under ts-node/ESM &ac; [`fb08259`](https://github.com/rivy/js.xdg-app-paths/commit/fb08259c2fb0f291224e640a6993e2cc0a3d0c45)
* add 'hack' to auto-generate application name for ESM scripts &ac; [`43424a3`](https://github.com/rivy/js.xdg-app-paths/commit/43424a385a02594aa639e68e172b4a3e4f15891f)
* add ESM support (via 'esm-wrapper') &ac; [`e4bfa58`](https://github.com/rivy/js.xdg-app-paths/commit/e4bfa58e8d078d7b761d2e32c3e9ce2e248073ff)
* change *(API!)*: add package 'exports' to publicize ESM support &ac; [`aaa478c`](https://github.com/rivy/js.xdg-app-paths/commit/aaa478c81d8d6c493010bf4c2f21cc7dbd5345c4)
#### Fixes
* fix ~ use 'an-anonymous-script' as name for scripts w/o 'require.main.filename' &ac; [`02dd0c9`](https://github.com/rivy/js.xdg-app-paths/commit/02dd0c9f138d32dedae6084095c3f413c1630ca5)
* fix `remark .` complaint (passive voice) &ac; [`9378936`](https://github.com/rivy/js.xdg-app-paths/commit/9378936c1c2934c172eea433485ce071280680c1)
#### Dependency Updates
* update ~ remove unneeded dep &ac; [`00330ae`](https://github.com/rivy/js.xdg-app-paths/commit/00330ae9a86d4a4c5b710e3a631db7a5bc0a9a4b)
#### Documentation
* docs ~ polish/update CHANGELOG format template &ac; [`ee32f02`](https://github.com/rivy/js.xdg-app-paths/commit/ee32f02c7cd89e5c8cc48bc8c989fa4eb96b9399)
* docs ~ add `cspell` dictionary words &ac; [`9d552d8`](https://github.com/rivy/js.xdg-app-paths/commit/9d552d8a65bbfdc74c15a94274adaba12904f6a5)
* docs ~ README polish and updates &ac; [`d2ff230`](https://github.com/rivy/js.xdg-app-paths/commit/d2ff230037e2d6136d06592bdd9e96e4c8c917e6)
* docs ~ restore Node-v4+ compatibility for CJS example &ac; [`0802c32`](https://github.com/rivy/js.xdg-app-paths/commit/0802c32003c6c114dccc494be60b02b41ff3a334)
* docs ~ add ESM example &ac; [`4bb33ea`](https://github.com/rivy/js.xdg-app-paths/commit/4bb33ea83bd2fc31c4b35304c72fb249a4f97e27)
* docs ~ revise CJS and TS examples (imports, naming, ...) &ac; [`a776960`](https://github.com/rivy/js.xdg-app-paths/commit/a77696066ffb6d70d7dd70f6fa6ef7219ad3a63f)
* docs ~ add XDG reference comment &ac; [`58fdbb3`](https://github.com/rivy/js.xdg-app-paths/commit/58fdbb3a08b4827086b19cae0e85bbad19c7e880)
* docs ~ revise spell-checker exceptions &ac; [`b986eeb`](https://github.com/rivy/js.xdg-app-paths/commit/b986eeb32c0284d75ccc3c847432ac4114e28c01)
* docs ~ rewrite examples for TypeScript-based package &ac; [`f3bf949`](https://github.com/rivy/js.xdg-app-paths/commit/f3bf949a3ebd45a220c63a0967b67e887757d58a)
* docs ~ (package.json) polish module description &ac; [`751262d`](https://github.com/rivy/js.xdg-app-paths/commit/751262d5003457d3a951944590f53965ea1649c7)
#### Maintenance
* maint *(CICD)*: disable NodeJS-v14 on TravisCI (broken TravisCI-side for Linux/NodeJS-v14) &ac; [`a6a95c6`](https://github.com/rivy/js.xdg-app-paths/commit/a6a95c6232e40f3b376203184f6d0c73fa84ed8e)
* maint *(CICD)*: update CI for NodeJS-v10+ build/test requirement &ac; [`10fa159`](https://github.com/rivy/js.xdg-app-paths/commit/10fa159bcce6e6b3c777723c8359562aefe73f99)
* maint *(build)*: (gitignore) revise for new 'dist' packaging model &ac; [`370d3db`](https://github.com/rivy/js.xdg-app-paths/commit/370d3db15ba096a0b75fa9d1225816a7dbbd22de)
* maint *(build)*: avoid transpilation for test fixtures &ac; [`5399a29`](https://github.com/rivy/js.xdg-app-paths/commit/5399a2991cb7a3a925cd1bcb89ca5b214901a159)
* maint *(build)*: add esm-wrapper to tests build folder &ac; [`c638dcb`](https://github.com/rivy/js.xdg-app-paths/commit/c638dcbd4e93082ba460410df27bf04c062a0027)
* maint *(build)*: (package.json) update files for 'dist' project model &ac; [`920cb98`](https://github.com/rivy/js.xdg-app-paths/commit/920cb9889e44d631f03c711c146a5764a5ed5234)
* maint *(build)*: (package.json) declare package support for NodeJS-v4+ engines &ac; [`ce80dab`](https://github.com/rivy/js.xdg-app-paths/commit/ce80dab1f90e815541dc448f306dc5680e9dd157)
* maint *(build)*: (package.json) revise packages tags to advertise support for NodeJS-v4+ &ac; [`5fe1e2c`](https://github.com/rivy/js.xdg-app-paths/commit/5fe1e2c3438c16857520ed54f680abdd3b04c3d2)
* maint *(build)*: add 'cjs' directory to distribution for tools w/o 'exports' support &ac; [`8073b3e`](https://github.com/rivy/js.xdg-app-paths/commit/8073b3ebe1ea934f358d5369885b52c04a955589)
* maint *(build)*: name revision (tests_ => testbed) &ac; [`896663b`](https://github.com/rivy/js.xdg-app-paths/commit/896663bed6138161555badb9f2f6317444018820)
* maint *(dev)*: add RemarkLint config &ac; [`8a60f98`](https://github.com/rivy/js.xdg-app-paths/commit/8a60f9890d5e48c45f9a81431ec8cfbfd3cbc9fb)
* maint *(dev)*: update ESLint config for TypeScript-based package &ac; [`1d5d1d7`](https://github.com/rivy/js.xdg-app-paths/commit/1d5d1d7ee0cdeb763af0002c5aebc8de067214ff)
* maint *(dev)*: add CommitLint config &ac; [`b97c098`](https://github.com/rivy/js.xdg-app-paths/commit/b97c0989f7cb6976a36e5f977496a7f911b975c8)
* maint *(dev)*: update dep (xdg-portable; for Node-v4+ compatibility) &ac; [`f2e8831`](https://github.com/rivy/js.xdg-app-paths/commit/f2e883122316ecf149a0661e558fcbaefe4adb4a)
* maint *(dev)*: revise VSCode 'ToDO Tree' settings (ignore 'vendor') &ac; [`0f8bd67`](https://github.com/rivy/js.xdg-app-paths/commit/0f8bd670f165e6ad797e093ec70a95eb00f75255)
* maint *(dev)*: (package.json) add rebuild:all script &ac; [`6151867`](https://github.com/rivy/js.xdg-app-paths/commit/615186745aa4fc08b9969b3933656d16ed95337e)
* maint *(dev)*: ignore non-test build folders for code coverage calculations &ac; [`c046331`](https://github.com/rivy/js.xdg-app-paths/commit/c046331f02fb1b3f23829cc5086884f4bef59a6c)
* maint *(dev)*: (npm) suppress annoying update messages &ac; [`10f5e08`](https://github.com/rivy/js.xdg-app-paths/commit/10f5e0821bedd5d29c7952b9205ab3688a38785c)
* maint *(dev)*: add `rollup` config for type bundling &ac; [`63c9270`](https://github.com/rivy/js.xdg-app-paths/commit/63c9270ef5dc2a121a60c88cbf7e46c6730e4d01)
* maint *(dev)*: (package.json) update dev scripts and deps (for dev, new min NodeJS of v10.14+) &ac; [`a82e531`](https://github.com/rivy/js.xdg-app-paths/commit/a82e53195b5f31e7fcffc7067e5a568bcaaa99c2)
* maint *(dev)*: add TypeScript 'tsconfig' files &ac; [`9ae72b3`](https://github.com/rivy/js.xdg-app-paths/commit/9ae72b395f647dcab48d35aedabda5435c047a31)
* maint *(dev)*: add TypeScript dev deps &ac; [`79b67ab`](https://github.com/rivy/js.xdg-app-paths/commit/79b67abe924d911c6d99ec2da72c4c3d8a2cdf37)
* maint *(dev)*: update VSCode settings (includes `cspell` config/dictionaries) &ac; [`8ce27fd`](https://github.com/rivy/js.xdg-app-paths/commit/8ce27fd4a7cba268d01c53e06f99e9c13762c199)
* maint *(dev)*: relocate Prettier config from 'package.json' to external file &ac; [`e707bdb`](https://github.com/rivy/js.xdg-app-paths/commit/e707bdb76a9c12aa10cdf4d1a3fd86f3182c3967)
* maint *(dev)*: update EditorConfig &ac; [`d5a95b5`](https://github.com/rivy/js.xdg-app-paths/commit/d5a95b5e1e6468908658319037e97809e7bfea40)
* maint *(dev)*: (QA) add CodeClimate config &ac; [`e8d3139`](https://github.com/rivy/js.xdg-app-paths/commit/e8d3139e0fee261eb9bdc54ff56e960d12902dd1)
* maint *(dev)*: (QA) add Codacy configuration (with cloud-side config notes) &ac; [`a50f0c5`](https://github.com/rivy/js.xdg-app-paths/commit/a50f0c555845d7bf63eee9bddff09d6ff31b68bf)
#### Refactoring
* refactor ~ common code consolidation and changes to improve testability &ac; [`6566325`](https://github.com/rivy/js.xdg-app-paths/commit/6566325de98a0490a30c99821d5c504311d94f84)
* refactor ~ remove redundant null-coalesce &ac; [`a55bea2`](https://github.com/rivy/js.xdg-app-paths/commit/a55bea2b7f23a2397b2ef3ea997d4bd49fda20fe)
* refactor ~ remove unneeded manual type specifications &ac; [`21722f3`](https://github.com/rivy/js.xdg-app-paths/commit/21722f3b8b612aaa2007f45031d232720b422996)
* refactor ~ sort XDGAppPaths type definitions and exports &ac; [`38047e0`](https://github.com/rivy/js.xdg-app-paths/commit/38047e04c47bd0b505cd7c8cd91090e2cf40ea78)
* refactor ~ minimize use of `typeof x` to avoid loss of eslint variable tracking &ac; [`540bccc`](https://github.com/rivy/js.xdg-app-paths/commit/540bcccf57cfa429d9d3fbb1148ae485e0f6f923)
* refactor ~ convert to TypeScript &ac; [`a228c2f`](https://github.com/rivy/js.xdg-app-paths/commit/a228c2fd695e600baf53ad216bc4bb94379e51b8)
#### Test Improvements
* tests ~ add tests for 'pkg' packaged application support &ac; [`0819a45`](https://github.com/rivy/js.xdg-app-paths/commit/0819a452b8606c6ac6300700d6e8ffbc6c32838b)
* tests ~ add spell-checker exceptions &ac; [`0e6e2b0`](https://github.com/rivy/js.xdg-app-paths/commit/0e6e2b0ba58a49e7777f90b13c714bc8a845d3e8)
* tests ~ fix direct script shell portability &ac; [`0ed4a9c`](https://github.com/rivy/js.xdg-app-paths/commit/0ed4a9c7dd0fc99aa66b886abb3649725e61bd64)
* tests ~ add tests to improve code coverage &ac; [`b7c7f4b`](https://github.com/rivy/js.xdg-app-paths/commit/b7c7f4b2f177fb0379f6e5d2b8b78eb74602718a)
* tests ~ increase testing coverage of builds (via more fixtures) &ac; [`d41c81b`](https://github.com/rivy/js.xdg-app-paths/commit/d41c81b2bc3fb85efcc90a801d6b096dd61c2c25)
* tests ~ fix test fixture references &ac; [`f7cd135`](https://github.com/rivy/js.xdg-app-paths/commit/f7cd1352ace05cb081109e564fa896557eea3e3e)
* tests ~ test more build/transpilation targets (fixtures) &ac; [`815818c`](https://github.com/rivy/js.xdg-app-paths/commit/815818c73fb36d7e709f549b5ea2abb1cac3b323)
* tests ~ add distribution tests &ac; [`9e5d45f`](https://github.com/rivy/js.xdg-app-paths/commit/9e5d45ffe49c8c039b8df084893532604a028935)
* tests ~ remove redundant tests &ac; [`917a611`](https://github.com/rivy/js.xdg-app-paths/commit/917a6115a678d1a71b1b84b4bfa48f7c0e12dd3a)
* tests ~ remove TypeError tests (depend on tooling for type safety) &ac; [`141d531`](https://github.com/rivy/js.xdg-app-paths/commit/141d531b6f938b0d11907473b3325eb3624cfe0b)
* tests ~ refactor for TypeScript-based package &ac; [`58310ff`](https://github.com/rivy/js.xdg-app-paths/commit/58310ff865564a0b00f0200b60bcd47d0315d81a)
</details>
---
## [v5.5.1](https://github.com/rivy/js.xdg-app-paths/compare/v5.5.0...v5.5.1) <small>(2020-12-15)</small>
<details><summary><small><em>[v5.5.1; details]</em></small></summary>
#### Fixes
* fix examples (restore Node-v6 compatibility) &ac; [`a76fe7d`](https://github.com/rivy/js.xdg-app-paths/commit/a76fe7d2ad52ebcb8df554427c13a0449ddf110d)
</details>
---
## [v5.5.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.4.1...v5.5.0) <small>(2020-12-15)</small>
<details><summary><small><em>[v5.5.0; details]</em></small></summary>
#### Fixes
* fix ~ remove erroneous devDependency ('fs[@0](https://github.com/0).0.1-security') &ac; [`d9d97ce`](https://github.com/rivy/js.xdg-app-paths/commit/d9d97ce74f52248a15d23b4da682d5d46bab4f67)
#### Documentation
* docs ~ refactor examples (improved flexibility and robustness) &ac; [`b4c702d`](https://github.com/rivy/js.xdg-app-paths/commit/b4c702d904b0cb5e6d99a83db25cbfdfda0fc354)
* docs ~ add CHANGELOG spell-checker exceptions &ac; [`d26c92e`](https://github.com/rivy/js.xdg-app-paths/commit/d26c92e38881c7cf30683d9607b44ce1bead16d4)
* docs ~ add TypeScript example &ac; [`655beee`](https://github.com/rivy/js.xdg-app-paths/commit/655beeefbcc36d0f53640810f3f8a7f08c102129)
* docs ~ polish README &ac; [`73414bc`](https://github.com/rivy/js.xdg-app-paths/commit/73414bc998944b5d54f8fa8a35efbc6da6611591)
#### Maintenance
* maint *(build)*: fix package keywords &ac; [`0240b3a`](https://github.com/rivy/js.xdg-app-paths/commit/0240b3a91d249d333a8194f86fe3b49e05430f2c)
* maint *(build)*: include CHANGELOG in distribution file list &ac; [`ce467f3`](https://github.com/rivy/js.xdg-app-paths/commit/ce467f3dc559a5e83a7abe7ce45a4a82e28e81cd)
* maint *(build)*: update 'README.md' filename in package manifest &ac; [`708ad3a`](https://github.com/rivy/js.xdg-app-paths/commit/708ad3af461b9cc7bcb2a8c24efb432e50b699c1)
* maint *(dev)*: refactor/polish package.json &ac; [`bdd0cff`](https://github.com/rivy/js.xdg-app-paths/commit/bdd0cff0ac07f8269eb711118922e394bdec7bbf)
* maint *(dev)*: npm script polish &ac; [`3c5f95a`](https://github.com/rivy/js.xdg-app-paths/commit/3c5f95a539be18f0a3f92891cd39aa96b8d4a91a)
* maint *(dev)*: include .history (for VSCode plugin) in .prettierignore &ac; [`f6fd80c`](https://github.com/rivy/js.xdg-app-paths/commit/f6fd80ca6a66c2c9db088ae24bde9d0a93a4d05d)
* maint *(dev)*: include .history (for VSCode plugin) in .gitignore &ac; [`c58b821`](https://github.com/rivy/js.xdg-app-paths/commit/c58b82108f93457004e90bd02b736f7d66332653)
#### Test Improvements
* tests ~ minor refactor of type tests &ac; [`2cd7c00`](https://github.com/rivy/js.xdg-app-paths/commit/2cd7c001fb69b96d421dbbe116b43578dee98d0b)
* tests ~ test examples for successful execution &ac; [`4b6e1aa`](https://github.com/rivy/js.xdg-app-paths/commit/4b6e1aafb9385e8a550a4943ef93c8ac728f8264)
</details>
---
## [v5.4.1](https://github.com/rivy/js.xdg-app-paths/compare/v5.4.0...v5.4.1) <small>(2020-11-05)</small>
<details><summary><small><em>[v5.4.1; details]</em></small></summary>
#### Documentation
* docs ~ README filename change (NPMjs requires 'README.md') &ac; [`b728ae5`](https://github.com/rivy/js.xdg-app-paths/commit/b728ae5f41e62d441f21f33363ccf0307fd7487a)
</details>
---
## [v5.4.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.3.0...v5.4.0) <small>(2020-11-04)</small>
<details><summary><small><em>[v5.4.0; details]</em></small></summary>
#### Fixes
* fix options normalization logic error &ac; [`28857ac`](https://github.com/rivy/js.xdg-app-paths/commit/28857acc6c3c3f2e00693ea024710b03c2dbe577)
#### Documentation
* docs ~ polish README badges &ac; [`33b40aa`](https://github.com/rivy/js.xdg-app-paths/commit/33b40aa1b8a4501fe2029182d38175480dc30d1e)
* docs ~ update LICENSE filename &ac; [`92257b0`](https://github.com/rivy/js.xdg-app-paths/commit/92257b03f8765643217604e48a956132cdaa594b)
* docs ~ update README &ac; [`4feb8c6`](https://github.com/rivy/js.xdg-app-paths/commit/4feb8c6ad4c418cf7b65eeccf469bc10bf550f65)
* docs ~ update example code (improved `appPaths.log()`) &ac; [`8e12d9f`](https://github.com/rivy/js.xdg-app-paths/commit/8e12d9f8e846d4b584e6c2aa870ef014c7d913ca)
* docs ~ update README &ac; [`14f4c59`](https://github.com/rivy/js.xdg-app-paths/commit/14f4c590d9273dd68ac68f0c141f767a7b2dddb7)
* docs *(polish)*: minor comment reformatting &ac; [`20610fd`](https://github.com/rivy/js.xdg-app-paths/commit/20610fd53ce8f5b394ed8e44299906f158adf584)
* docs *(polish)*: improved show-paths.js example &ac; [`29f9de5`](https://github.com/rivy/js.xdg-app-paths/commit/29f9de5ee4543614063a2c33dc0e79d5183a45e7)
#### Maintenance
* maint *(CICD)*: add MacOS CI testing &ac; [`2da1365`](https://github.com/rivy/js.xdg-app-paths/commit/2da1365799c8815e4c23186e707919664d5241b8)
* maint *(CICD)*: synchronize GHA CI name/config &ac; [`a331ef3`](https://github.com/rivy/js.xdg-app-paths/commit/a331ef3581d6d791160c3da857e7ed924e85457e)
* maint *(build)*: refactor package NodeJS engine compatibility specification &ac; [`dd45719`](https://github.com/rivy/js.xdg-app-paths/commit/dd457190b4cd98528b61951d84415ec1b8096429)
* maint *(build)*: update package files for LICENSE and README &ac; [`51d31a9`](https://github.com/rivy/js.xdg-app-paths/commit/51d31a9ef729a5e829cd5dea68096b841014024c)
* maint *(build)*: refactor npm scripts &ac; [`f9e9c4f`](https://github.com/rivy/js.xdg-app-paths/commit/f9e9c4fded7814be45bdf47b96554171501cd9d8)
* maint *(build)*: update CHANGELOG template with markdown-lint and spell-checker signals &ac; [`d367cdd`](https://github.com/rivy/js.xdg-app-paths/commit/d367cdd2dbfc1a62210063fcd4aa172a2652ee61)
* maint *(build)*: update EditorConfig (include more file types and commentary) &ac; [`a835c2d`](https://github.com/rivy/js.xdg-app-paths/commit/a835c2df2177a2692f9fecef61cea4cf7e837787)
* maint *(build)*: revise and polish npm scripts &ac; [`60f91fa`](https://github.com/rivy/js.xdg-app-paths/commit/60f91fa6e2bed2c1e08c78c1ba535604fce8ce11)
* maint *(build)*: add explanation for NPMrc `package-lock=false` &ac; [`c9f6092`](https://github.com/rivy/js.xdg-app-paths/commit/c9f60920a3b6b1e93f664b226d5ac01b393ff318)
* maint *(build)*: reorganize package.json &ac; [`0c9c821`](https://github.com/rivy/js.xdg-app-paths/commit/0c9c8213cd3f6a959c6837be04a8d694bcafc32f)
* maint *(dev)*: add Prettier ignore file (to simplify automation) &ac; [`881586a`](https://github.com/rivy/js.xdg-app-paths/commit/881586a8d6120e1052961f2c405fd7f4153f9b6a)
* maint *(dev)*: add Prettier &ac; [`69e18ad`](https://github.com/rivy/js.xdg-app-paths/commit/69e18ad9a86d73f02fc30019944cb462b89c7d37)
* maint *(dev)*: XO => ESLint/Prettier (better tooling + TypeScript prep) &ac; [`258445b`](https://github.com/rivy/js.xdg-app-paths/commit/258445bf24cf5084c776d9992ff138c63a8ca7fc)
* maint *(dev)*: change to 'eslintrc.js' configuration file &ac; [`15af0d2`](https://github.com/rivy/js.xdg-app-paths/commit/15af0d2a8cf53536dc1ae67db5b4f84297fe3d66)
* maint *(dev)*: add ESLint &ac; [`91df9e0`](https://github.com/rivy/js.xdg-app-paths/commit/91df9e063f8aea80eae18728669a41095c97acb5)
* maint *(dev)*: remove XO &ac; [`47d12b5`](https://github.com/rivy/js.xdg-app-paths/commit/47d12b5322dfddf703f774de9bacf8b093ae6e84)
* maint *(dev)*: add VSCode settings (ENABLE auto-format on save) &ac; [`84378e5`](https://github.com/rivy/js.xdg-app-paths/commit/84378e5f0de50409260f7ecde8c183ee967b995f)
* maint *(dev)*: add/update .gitattributes &ac; [`62d06d6`](https://github.com/rivy/js.xdg-app-paths/commit/62d06d6916c75d9c7298382a77dcd6caa70502fe)
* maint *(dev)*: update .gitignore files &ac; [`8f13ac7`](https://github.com/rivy/js.xdg-app-paths/commit/8f13ac7c4a91969505e4b472d6952e5b9d4603f9)
* maint *(dev)*: add Prettier configuration &ac; [`c2e9f42`](https://github.com/rivy/js.xdg-app-paths/commit/c2e9f42ae545bfb504b15f2a02de375c48cd37fc)
#### Refactoring
* refactor ~ remove unnecessary extra test for `xdg.runtime()` &ac; [`a5fa5d0`](https://github.com/rivy/js.xdg-app-paths/commit/a5fa5d0332dff202b3f04de976d8cd2eacebc223)
* refactor ~ remove unnecessary `dirOptions.isolated` tests &ac; [`cfa4ed3`](https://github.com/rivy/js.xdg-app-paths/commit/cfa4ed3b90070f67e357e2ee8218934031d0a3ba)
* refactor ~ minimize use of `typeof x` to avoid loss of linter variable tracking &ac; [`3d0a586`](https://github.com/rivy/js.xdg-app-paths/commit/3d0a586802bc4852cfbc1fdafacc2e6195c810a8)
* refactor ~ remove unnecessary OS-specific code &ac; [`472ea08`](https://github.com/rivy/js.xdg-app-paths/commit/472ea0819eebd42b10c3522d5df84efbcbcbeadb)
* refactor *(polish)*: fix ESLint complaints &ac; [`1a3853d`](https://github.com/rivy/js.xdg-app-paths/commit/1a3853db79348861a60f35f70bd576ea98415a60)
* refactor *(polish)*: `prettier` re-format &ac; [`c8330ea`](https://github.com/rivy/js.xdg-app-paths/commit/c8330ea473c561b66cc1047b6033de7c5e8c0fe3)
#### Test Improvements
* tests ~ add integration testing &ac; [`8b949da`](https://github.com/rivy/js.xdg-app-paths/commit/8b949daf0241a606fbef7fa47f04385ea644a36e)
* tests ~ specify unit tests (by filename) &ac; [`8a42cc7`](https://github.com/rivy/js.xdg-app-paths/commit/8a42cc79263fc06abb347906b92842f1bc261a6c)
* tests ~ consolidate type tests into test directory &ac; [`63ce73d`](https://github.com/rivy/js.xdg-app-paths/commit/63ce73db4d127621b5148050738290e1f4d56283)
* tests ~ expand/improve type definition and testing &ac; [`7e2d898`](https://github.com/rivy/js.xdg-app-paths/commit/7e2d89837d7fd2e7bbc9e13e26a923a1f7a904b5)
* tests ~ use more functional syntax (for => forEach) + add more tests &ac; [`268c91b`](https://github.com/rivy/js.xdg-app-paths/commit/268c91badaf141eecb9252fea17c61d7b1d850bd)
* test *(refactor)*: minimize use of `typeof x` to avoid loss of linter variable tracking &ac; [`3f43127`](https://github.com/rivy/js.xdg-app-paths/commit/3f43127bb9c092f92ab4d58edf30ebb09d11e7fb)
</details>
---
## [v5.3.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.2.0...v5.3.0) <small>(2020-10-26)</small>
<details><summary><small><em>[v5.3.0; details]</em></small></summary>
#### Fixes
* fix `npx xo` warnings &ac; [`bbfb8aa`](https://github.com/rivy/js.xdg-app-paths/commit/bbfb8aa63c13e672139acd551a5991608537b071)
#### Dependency Updates
* update dependencies &ac; [`382ec3c`](https://github.com/rivy/js.xdg-app-paths/commit/382ec3c5180b16adf4f33ad6f86911c219315802)
#### Maintenance
* maint ~ reconfigure for `git-changelog` (from GH:rivy-go) &ac; [`69611f1`](https://github.com/rivy/js.xdg-app-paths/commit/69611f152d1d4b15cf33eab51c1258dc55cbe370)
* maint *(CICD)*: add GitHub Actions CI &ac; [`b893e31`](https://github.com/rivy/js.xdg-app-paths/commit/b893e31340232d9b5fcf3a4e24e609bd0e4ef4fc)
* maint *(build)*: refactor run-scripts for code coverage to run only for Node-v10+ &ac; [`fba5f36`](https://github.com/rivy/js.xdg-app-paths/commit/fba5f36821eeb220cb6ae0c94a924ca0ab09ce79)
* maint *(build)*: refactor run-scripts for updated `cspell`, `tsd`, and `xo` to run only for Node-v10+ &ac; [`29a92ed`](https://github.com/rivy/js.xdg-app-paths/commit/29a92ed7c7678eab96358803d19ca23f7ad8d0d7)
* maint *(dev)*: update editorconfig + whitespace cleanup &ac; [`398555d`](https://github.com/rivy/js.xdg-app-paths/commit/398555d7bdf58fcd08c666493037ed4e0b28de98)
#### Refactoring
* refactor ~ add state functions after adding base platform-dependent extension functions &ac; [`9632d64`](https://github.com/rivy/js.xdg-app-paths/commit/9632d6419f94069f1fabf3a6f8b33b17e149fb85)
* refactor ~ remove unusual use of return in class constructor &ac; [`f69c9f2`](https://github.com/rivy/js.xdg-app-paths/commit/f69c9f261f683dc41984439c6eea77234e12daaf)
* refactor repository directory structure prior to typescript (and then deno) conversion &ac; [`d680042`](https://github.com/rivy/js.xdg-app-paths/commit/d680042f7292675f0841449d49d65873ad9f64ed)
</details>
---
## [v5.2.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.1.0...v5.2.0) <small>(2019-10-04)</small>
<details><summary><small><em>[v5.2.0; details]</em></small></summary>
#### Documentation
* docs ~ update README badges &ac; [`6fdaa5b`](https://github.com/rivy/js.xdg-app-paths/commit/6fdaa5be213a1d32cb1f5e6162d57465de9dbecd)
* docs ~ add CHANGELOG (via `git-chglog`) &ac; [`1a458ba`](https://github.com/rivy/js.xdg-app-paths/commit/1a458ba347fe232e963bfea884c55f2a1d7fcaa5)
* docs ~ update module keywords &ac; [`0fd867e`](https://github.com/rivy/js.xdg-app-paths/commit/0fd867eb7caad0f0819c09b6c20377f7d25251ec)
#### Maintenance
* maint ~ add git-chglog configuration &ac; [`64c61e8`](https://github.com/rivy/js.xdg-app-paths/commit/64c61e8e56ba9476b66946f90041042d54e2c5a7)
* maint *(CI)*: fix CI testing using NodeJS v6 &ac; [`d1e5192`](https://github.com/rivy/js.xdg-app-paths/commit/d1e5192da1338ed090470061ba70b946eda17cb1)
* maint *(build)*: refactor lint/test run-scripts &ac; [`ed1f035`](https://github.com/rivy/js.xdg-app-paths/commit/ed1f035b59ab730e76491f77dface15f83e7f377)
#### Refactoring
* refactor tests for NodeJS v6 compatibility &ac; [`612c4c9`](https://github.com/rivy/js.xdg-app-paths/commit/612c4c93adee2059825b27596ba199bb9d11426c)
* refactor ~ support module use back to NodeJS v6 &ac; [`6076f97`](https://github.com/rivy/js.xdg-app-paths/commit/6076f9766f8ce4fa468712e1d19726bf9420be0a)
</details>
---
## [v5.1.0](https://github.com/rivy/js.xdg-app-paths/compare/v5.0.0...v5.1.0) <small>(2019-08-18)</small>
<details><summary><small><em>[v5.1.0; details]</em></small></summary>
#### Fixes
* fix typescript definitions and testing &ac; [`7a99d84`](https://github.com/rivy/js.xdg-app-paths/commit/7a99d84f6667133b455437bafbed8a9298d4b35c)
</details>
---
## [v5.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v4.0.3...v5.0.0) <small>(2019-08-04)</small>
<details><summary><small><em>[v5.0.0; details]</em></small></summary>
#### Changes
* change ~ remove dissonant, unneeded `temp()` method &ac; [`ceed5d0`](https://github.com/rivy/js.xdg-app-paths/commit/ceed5d077fe403784122d88b0444a0469090515d)
#### Documentation
* docs ~ polish README &ac; [`32afd69`](https://github.com/rivy/js.xdg-app-paths/commit/32afd69ff694eeb4eb27f4b93558203c738fe947)
* docs ~ improve example &ac; [`ec43fce`](https://github.com/rivy/js.xdg-app-paths/commit/ec43fceeaa747084ebb8584bd4180ac9c2635a42)
* docs ~ fix broken CI README badges (point to repo master branch) &ac; [`d043db5`](https://github.com/rivy/js.xdg-app-paths/commit/d043db5229874faaa78f7f6e191c5cbe0cefbfe4)
</details>
---
## [v4.0.3](https://github.com/rivy/js.xdg-app-paths/compare/v4.0.2...v4.0.3) <small>(2019-07-28)</small>
<details><summary><small><em>[v4.0.3; details]</em></small></summary>
#### Documentation
* docs ~ fix README example code &ac; [`0f4bd17`](https://github.com/rivy/js.xdg-app-paths/commit/0f4bd176c09044f3444549ea2976281b64e435f1)
#### Maintenance
* maint ~ fix spelling in tests &ac; [`2fc9283`](https://github.com/rivy/js.xdg-app-paths/commit/2fc9283b78cc90721aaa855b56401eb41801aede)
</details>
---
## [v4.0.2](https://github.com/rivy/js.xdg-app-paths/compare/v4.0.1...v4.0.2) <small>(2019-07-28)</small>
<details><summary><small><em>[v4.0.2; details]</em></small></summary>
#### Changes
* change ~ remove unneeded 'flexible' constructor code &ac; [`86704c5`](https://github.com/rivy/js.xdg-app-paths/commit/86704c5ee0f86638184c4a8813a78d3a8577064f)
#### Fixes
* fix parsing of 'options' &ac; [`c43fdb2`](https://github.com/rivy/js.xdg-app-paths/commit/c43fdb2fe20e83dc987f62e5023ca6a148e682cb)
#### Documentation
* docs ~ fix README &ac; [`3ebc5d3`](https://github.com/rivy/js.xdg-app-paths/commit/3ebc5d3b2071d99b8555400b7a33d4d483c910a0)
#### Maintenance
* maint ~ add and improve tests &ac; [`c53aa2e`](https://github.com/rivy/js.xdg-app-paths/commit/c53aa2e69e7a554c7af405c48cb82bec5efbfe17)
#### Refactoring
* refactor ~ convert to ES2015 class notation &ac; [`ab2b9d7`](https://github.com/rivy/js.xdg-app-paths/commit/ab2b9d73b6aa4f85b2d13b44ad936978a9e5a196)
* refactor ~ revise internal naming &ac; [`ec56ae1`](https://github.com/rivy/js.xdg-app-paths/commit/ec56ae12f9b7b2e1656fb466ae508e74f58e6d08)
</details>
---
## [v4.0.1](https://github.com/rivy/js.xdg-app-paths/compare/v4.0.0...v4.0.1) <small>(2019-07-22)</small>
<details><summary><small><em>[v4.0.1; details]</em></small></summary>
#### Documentation
* docs ~ fix and polish README &ac; [`2829fe2`](https://github.com/rivy/js.xdg-app-paths/commit/2829fe2a15bfa07b8fbe107318e9b96f108381b7)
#### Maintenance
* maint ~ improve code coverage testing and reporting &ac; [`5636d68`](https://github.com/rivy/js.xdg-app-paths/commit/5636d683382ebfc01ec6fef42a931d4ffc71b83a)
* maint ~ expand testing to include NodeJS v12 &ac; [`ecf5f9b`](https://github.com/rivy/js.xdg-app-paths/commit/ecf5f9b268d4b301f4b0b100222a5898960f45a5)
</details>
---
## [v4.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v3.0.2...v4.0.0) <small>(2019-07-07)</small>
<details><summary><small><em>[v4.0.0; details]</em></small></summary>
#### Changes
* change ~ improve/update example for new API &ac; [`9978c1f`](https://github.com/rivy/js.xdg-app-paths/commit/9978c1f8d59e8c3bfac69a010bc3cc1f3a726ea5)
* change ~ API! - change to method-based API &ac; [`7d1f8a3`](https://github.com/rivy/js.xdg-app-paths/commit/7d1f8a3bb19f5fdcc68a2ef507d7a8a047bef0d2)
* change ~ rename module to 'xdg-app-paths' &ac; [`5bc765a`](https://github.com/rivy/js.xdg-app-paths/commit/5bc765a954ccb26688b6c6e24f869619b6df2303)
* change ~ remove '.default' export &ac; [`7b21ad2`](https://github.com/rivy/js.xdg-app-paths/commit/7b21ad2b97cdafc4221ec5e91b6e06d88941f0f2)
* add example &ac; [`bb51888`](https://github.com/rivy/js.xdg-app-paths/commit/bb51888e82732d78f835e8a6d61fc4b491ff9b6a)
#### Documentation
* docs ~ update/improve README &ac; [`db03fab`](https://github.com/rivy/js.xdg-app-paths/commit/db03fab57d35f09a4fec1383bb259ff7afc0f57d)
#### Maintenance
* maint ~ add coverage testing &ac; [`37f5a69`](https://github.com/rivy/js.xdg-app-paths/commit/37f5a693dce722d7c4e32f7b189c51779e9937bf)
* maint ~ be strict about node version &ac; [`a3b98dc`](https://github.com/rivy/js.xdg-app-paths/commit/a3b98dc1f14d820e24d230ab0515f42702483ef5)
* maint ~ improve linting support for IDEs &ac; [`4aa4407`](https://github.com/rivy/js.xdg-app-paths/commit/4aa4407e916ded94b89418f624d4c7f74befd7d2)
* maint ~ add AppVeyor CI &ac; [`3dea7e5`](https://github.com/rivy/js.xdg-app-paths/commit/3dea7e5e7811fb48dacac4c19d15e1b7c0ffe3c5)
#### Refactoring
* refactor ~ use 'xdg-portable' &ac; [`1c016d1`](https://github.com/rivy/js.xdg-app-paths/commit/1c016d19b1b7f47d9f368d4b1a14e5effa7c8f48)
</details>
---
## [v3.0.2](https://github.com/rivy/js.xdg-app-paths/compare/v3.0.1...v3.0.2) <small>(2019-06-29)</small>
<details><summary><small><em>[v3.0.2; details]</em></small></summary>
#### Documentation
* docs ~ polish and add XDG references &ac; [`1696b46`](https://github.com/rivy/js.xdg-app-paths/commit/1696b462d336a047b5041685b4fade914eeebd6a)
</details>
---
## [v3.0.1](https://github.com/rivy/js.xdg-app-paths/compare/v2.2.0...v3.0.1) <small>(2019-06-29)</small>
<details><summary><small><em>[v3.0.1; details]</em></small></summary>
#### Changes
* add improved XDG support (CONFIG_DIRS and DATA_DIRS) &ac; [`c6a250b`](https://github.com/rivy/js.xdg-app-paths/commit/c6a250bdcb899b83179b2414b9f5607fbf0e29bc)
* add cross-platform XDG support (plus comment polish) &ac; [`4d87f8d`](https://github.com/rivy/js.xdg-app-paths/commit/4d87f8d06d39a3c87d8dc49b5b00a720fbcf75e7)
* add note about the user needing to create the actual directories &ac; [`294db55`](https://github.com/rivy/js.xdg-app-paths/commit/294db5514d82a39424b4325d8e59879241174365)
#### Fixes
* fix ~ windows 'data' should roam with user &ac; [`a0b2f75`](https://github.com/rivy/js.xdg-app-paths/commit/a0b2f75b9a6ff09a74b2e49899863e844257c885)
#### Maintenance
* maint ~ comment polish &ac; [`dab0324`](https://github.com/rivy/js.xdg-app-paths/commit/dab0324f2302eb87a7631044c4a997b935583dcd)
* maint ~ add README linting and corrections &ac; [`aaf1e6c`](https://github.com/rivy/js.xdg-app-paths/commit/aaf1e6ca0b7407a095adbf1877b6fd5c85061eac)
* maint ~ add spell-checker exceptions &ac; [`bf9d759`](https://github.com/rivy/js.xdg-app-paths/commit/bf9d7595a99f9eae2c8db1e05d504cc912b5baaf)
#### Refactoring
* refactor ~ reorganize properties &ac; [`f376e0c`](https://github.com/rivy/js.xdg-app-paths/commit/f376e0c142b303a1313710914490ff521b4b9dd7)
</details>
---
## [v2.2.0](https://github.com/rivy/js.xdg-app-paths/compare/v2.1.0...v2.2.0) <small>(2019-04-01)</small>
<details><summary><small><em>[v2.2.0; details]</em></small></summary>
#### Refactoring
* refactor TypeScript definition to CommonJS compatible export ([#12](https://github.com/rivy/js.xdg-app-paths/issues/12)) &ac; [`dacf4e9`](https://github.com/rivy/js.xdg-app-paths/commit/dacf4e91cf27b1dccf5f2341bb2bec766307de0f)
</details>
---
## [v2.1.0](https://github.com/rivy/js.xdg-app-paths/compare/v2.0.0...v2.1.0) <small>(2019-03-04)</small>
<details><summary><small><em>[v2.1.0; details]</em></small></summary>
#### Changes
* add TypeScript definition ([#11](https://github.com/rivy/js.xdg-app-paths/issues/11)) &ac; [`949cd22`](https://github.com/rivy/js.xdg-app-paths/commit/949cd224975f15bfeb1fd2d3a2e7ad284d4cbeab)
</details>
---
## [v2.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v1.0.0...v2.0.0) <small>(2018-11-05)</small>
<details><summary><small><em>[v2.0.0; details]</em></small></summary>
<br/>
*No changelog for this release.*
</details>
---
## [v1.0.0](https://github.com/rivy/js.xdg-app-paths/compare/v0.3.1...v1.0.0) <small>(2017-01-10)</small>
<details><summary><small><em>[v1.0.0; details]</em></small></summary>
#### Fixes
* fix incorrect paths on Linux ([#6](https://github.com/rivy/js.xdg-app-paths/issues/6)) &ac; [`3a2ba84`](https://github.com/rivy/js.xdg-app-paths/commit/3a2ba84dc8be3103158225b4f0a3bd36ba9288b6)
</details>
---
## [v0.3.1](https://github.com/rivy/js.xdg-app-paths/compare/v0.3.0...v0.3.1) <small>(2016-10-18)</small>
<details><summary><small><em>[v0.3.1; details]</em></small></summary>
<br/>
*No changelog for this release.*
</details>
---
## [v0.3.0](https://github.com/rivy/js.xdg-app-paths/compare/v0.2.0...v0.3.0) <small>(2016-07-02)</small>
<details><summary><small><em>[v0.3.0; details]</em></small></summary>
#### Fixes
* fix usage example &ac; [`88a5908`](https://github.com/rivy/js.xdg-app-paths/commit/88a5908a9409422fa21cab38a4965701f74281fe)
</details>
---
## [v0.2.0](https://github.com/rivy/js.xdg-app-paths/compare/v0.1.0...v0.2.0) <small>(2016-06-24)</small>
<details><summary><small><em>[v0.2.0; details]</em></small></summary>
#### Changes
* add suffix to prevent possible conflict with native apps &ac; [`c2fda19`](https://github.com/rivy/js.xdg-app-paths/commit/c2fda19d629e56f308c8265506a1baf0c5c7e6dc)
</details>
---
## v0.1.0 <small>(2016-06-21)</small>
<details><summary><small><em>[v0.1.0; details]</em></small></summary>
<br/>
*No changelog for this release.*
</details><br/>

10
server/node_modules/xdg-app-paths/LICENSE generated vendored Normal file
View File

@@ -0,0 +1,10 @@
MIT License
Copyright (c) Roy Ivy III <rivy.dev@gmail.com>
Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
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.

599
server/node_modules/xdg-app-paths/README.md generated vendored Normal file
View File

@@ -0,0 +1,599 @@
<!-- dprint-ignore-file -->
<!-- deno-fmt-ignore-start -->
<!-- @prettier -->
<!DOCTYPE markdown><!-- markdownlint-disable first-line-heading no-inline-html -->
<meta charset="utf-8" content="text/markdown" lang="en">
<!-- -## editors ## (emacs/sublime) -*- coding: utf8-nix; tab-width: 4; mode: markdown; indent-tabs-mode: nil; basic-offset: 2; st-word_wrap: 'true' -*- ## (jEdit) :tabSize=4:indentSize=4:mode=markdown: ## (notepad++) vim:tabstop=4:syntax=markdown:expandtab:smarttab:softtabstop=2 ## modeline (see <https://archive.is/djTUD>@@<http://webcitation.org/66W3EhCAP> ) -->
<!-- spell-checker:ignore expandtab markdownlint modeline smarttab softtabstop -->
<!-- markdownlint-disable heading-increment no-duplicate-heading no-emphasis-as-heading -->
<!-- spell-checker:ignore (abbrev/jargon) CICD NodeJS -->
<!-- spell-checker:ignore (JS/TS) concat mkdirp readonly typeof -->
<!-- spell-checker:ignore (markdown) nbsp nodejsv -->
<!-- spell-checker:ignore (npm/targets) realclean -->
<!-- spell-checker:ignore (platform/windows) APPDATA LOCALAPPDATA -->
<!-- spell-checker:ignore (people) Roy Ivy III * rivy ; Sindre Sorhus * sindresorhus -->
<!-- spell-checker:ignore (utils) dprint uutils -->
# [xdg-app-paths](https://github.com/rivy/js.xdg-app-paths)
> Determine ([XDG](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)-compatible) paths for storing application files (cache, config, data, etc)
[![Build status (GHA)][gha-image]][gha-url]
[![Build status (AppVeyor)][appveyor-image]][appveyor-url]
[![Coverage status][coverage-image]][coverage-url]
[![License][license-image]][license-url]
[![Style Guide][style-image]][style-url]
&nbsp; <br/>
[![Repository][repository-image]][repository-url]
[![Deno version][deno-image]][deno-url]
[![NPM version][npm-image]][npm-url]
[![NodeJS version][nodejsv-image]][repository-url]
[![npmJS Downloads][downloads-image]][downloads-url]
[![JSDelivr Downloads][jsdelivr-image]][jsdelivr-url]
<!--
XDG references
# ref: <https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html> @@ <https://archive.is/aAhtw>
# ref: <https://specifications.freedesktop.org/basedir-spec/latest/ar01s03.html> @@ <https://archive.is/7N0TN>
# ref: <https://wiki.archlinux.org/index.php/XDG_Base_Directory> @@ <https://archive.is/VdO9n>
# ref: <https://wiki.debian.org/XDGBaseDirectorySpecification#state> @@ <http://archive.is/pahId>
# ref: <https://ploum.net/207-modify-your-application-to-use-xdg-folders> @@ <https://archive.is/f43Gk>
-->
## Installation (CJS/ESM/TypeScript)
<!-- ref: [JSDelivr ~ GitHub](https://www.jsdelivr.com/documentation#id-github) @@ <https://archive.is/c8s9Y> -->
```shell
npm install xdg-app-paths
# or... `npm install "git:github.com/rivy/js.xdg-app-paths"`
# or... `npm install "git:github.com/rivy/js.xdg-app-paths#v8.3.0"`
# or... `npm install "https://cdn.jsdelivr.net/gh/rivy/js.xdg-app-paths@v8.3.0/dist/xdg-app-paths.tgz"`
# or... `npm install "https://cdn.jsdelivr.net/gh/rivy/js.xdg-app-paths@COMMIT_SHA/dist/xdg-app-paths.tgz"`
```
## Usage
#### CommonJS (CJS)
```js
// MyApp.js
const xdgAppPaths = require('xdg-app-paths/cjs');
const cache = xdgAppPaths.cache();
//(nix)=> '/home/rivy/.cache/MyApp.js'
//(win)=> 'C:\\Users\\rivy\\AppData\\Local\\MyApp\\Cache'
const config = xdgAppPaths.config();
//(nix)=> '/home/rivy/.config/MyApp.js'
//(win)=> 'C:\\Users\\rivy\\AppData\\Roaming\\MyApp\\Config'
const data = xdgAppPaths.data();
//(nix)=> '/home/rivy/.local/share/MyApp.js'
//(win)=> 'C:\\Users\\rivy\\AppData\\Roaming\\MyApp\\Data'
```
#### ECMAScript (ESM)/TypeScript
```js
import xdgAppPaths from 'xdg-app-paths';
const configDirs = xdgAppPaths.configDirs();
//...
```
#### Deno
<!-- ref: [JSDelivr ~ GitHub](https://www.jsdelivr.com/documentation#id-github) @@ <https://archive.is/c8s9Y> -->
```ts
import xdgAppPaths from 'https://deno.land/x/xdg_app_paths@v8.3.0/src/mod.deno.ts';
//or (via CDN, [ie, JSDelivr with GitHub version/version-range, commit, 'latest' support])...
//import xdgAppPaths from 'https://cdn.jsdelivr.net/gh/rivy/js.xdg-app-paths@v8.3.0/src/mod.deno.ts';
//import xdgAppPaths from 'https://cdn.jsdelivr.net/gh/rivy/js.xdg-app-paths@COMMIT_SHA/src/mod.deno.ts';
const configDirs = xdgAppPaths.configDirs();
//...
```
## API
### Construction/Initialization
#### `XDGAppPaths( Options? )`
```js
// CJS
const xdgAppPaths = require('xdg-app-paths/cjs');
// or ...
const xdgAppPaths = require('xdg-app-paths/cjs')(options);
// ESM/TypeScript
import xdgAppPaths from 'xdg-app-paths';
// or ...
import XDGAppPaths from 'xdg-app-paths';
const xdgAppPaths = XDGAppPaths(options);
// Deno
import xdgAppPaths from 'https://deno.land/x/xdg_app_paths/src/mod.deno.ts';
// or ...
import XDGAppPaths from 'https://deno.land/x/xdg_app_paths/src/mod.deno.ts';
const xdgAppPaths = XDGAppPaths(options);
```
When importing this module, the object returned is a function object, `XDGAppPaths`, augmented with attached methods. Additional `XDGAppPaths` objects may be constructed by direct call of the imported `XDGAppPaths` object (eg, `const x = xdgAppPaths(...)`) or by using `new` (eg, `const x = new xdgAppPaths(...)`).
Upon construction, if not supplied with a specified name (via `Options.name`), `XDGAppPaths` will generate an application name which is used to further generate isolated application directories, where needed. "$eval" is used as the fallback value when automatically generating names (ie, for immediate mode scripts such as `node -e "..."`). The generated or supplied name is stored during `XDGAppPaths` construction and subsequently accessible via the `$name()` method.
### Interfaces/Types
```js
import type { DirOptions, Options, XDGAppPaths } from 'xdg-app-paths'; // TypeScript
//or...
//import type { DirOptions, Options, XDGAppPaths } from 'https://deno.land/x/xdg_app_paths/src/mod.deno.ts'; // Deno
```
#### `XDGAppPaths`
_`XDGAppPaths` API; also, the interface/type of the default function object export_
---
#### `DirOptions`
_Configuration options supplied to `XDGAppPaths` methods_
<small>
> **`DirOptions: boolean` => `{ isolated: boolean }`** <br/> As a shortcut, when `DirOptions` is supplied as a `boolean`, it is directly interpreted as the `isolated` property (ie, `dirOptions = { isolated: dirOptions }`).
>
> ---
>
> **`DirOptions: object`** <br/> &bullet; default = `{ isolated: true }`
>
> **`DirOptions.isolated: boolean`** <br/> &bullet; default = `true` <br/> _Isolation flag; used to override the default isolation mode, when needed_
</small>
#### `Options`
_Configuration options supplied when constructing `XDGAppPaths`_
<small>
> **`Options: string` => `{ name: string }`** <br/> As a shortcut, when `Options` is supplied as a `string`, is interpreted directly as the `name` property (ie, `options = { name: options }`).
>
> ---
>
> **`Options: object`** <br/> &bullet; default = `{ name: '', suffix: '', isolated: true }`
>
> **`Options.name: string`** <br/> &bullet; default = `''` <br/> _Name of the application; used to generate isolated application paths_ <br/> When missing (`undefined`, `null`, or empty (`''`)), it is generated automatically from the process main file name, where determinable. `'$eval'` is used as a final fallback value when the application name cannot otherwise be determined. Note, Deno reports `'$deno$eval'` as the main file name when executing `deno eval ...`.
>
> **`Options.suffix: string`** <br/> &bullet; default = `''` <br/> _Suffix which is appended to the application name when generating the application paths_
>
> **`Options.isolated: boolean`** <br/> &bullet; default = `true` <br/> _Default isolation flag (used when no isolation flag is supplied for `DirOptions`)_
</small>
All interfaces/types listed are exported individually by name (eg, as "XDGAppPaths").
### Methods
All returned path strings are simple, platform-compatible, strings and are _not_ guaranteed to exist. The application is responsible for construction of the directories. If needed, [`make-dir`](https://www.npmjs.com/package/make-dir) or [`mkdirp`](https://www.npmjs.com/package/mkdirp) can be used to create the directories.
#### `xdgAppPaths.cache( DirOptions? ): string`
_Returns the directory for non-essential data files_
> Deletion of the data contained here might cause an application to slow down.
#### `xdgAppPaths.config( DirOptions? ): string`
_Returns the directory for config files_
> Deletion of the data contained here might require the user to reconfigure an application.
#### `xdgAppPaths.data( DirOptions? ): string`
_Returns the directory for data files_
> Deletion of the data contained here might force the user to restore from backups.
#### `xdgAppPaths.runtime( DirOptions? ): string?`
_Returns the directory for runtime files; may return `undefined`_
> Deletion of the data contained here might interfere with a currently executing application but should have no effect on future executions.
#### `xdgAppPaths.state( DirOptions? ): string`
_Returns the directory for state files_
> Deletion of the data contained here should not materially interfere with execution of an application.
#### `xdgAppPaths.configDirs( DirOptions? ): readonly string[]`
_Returns a priority-sorted list of possible directories for configuration file storage (includes `paths.config()` as the first entry)_
#### `xdgAppPaths.dataDirs( DirOptions? ): readonly string[]`
_Returns a priority-sorted list of possible directories for data file storage (includes `paths.data()` as the first entry)_
#### `xdgAppPaths.$name(): string`
_Application name used for path construction (from supplied configuration or auto-generated)_
#### `xdgAppPaths.$isolated(): boolean`
_Default isolation mode used by the particular `XDGAppPaths` instance_
## Example
```js
// MyApp.js
const locatePath = require('locate-path');
const mkdirp = require('mkdirp');
const path = require('path');
const xdgAppPaths = require('xdg-app-paths/cjs');
// Extend appPaths with a "log" location function
xdgAppPaths.log = function (dirOptions) {
const self = xdgAppPaths; // * bind `self` to `xdgAppPaths` => avoids `this` variability due to caller context
function typeOf(x) {
// use avoids circumvention of eslint variable tracking for `x`
return typeof x;
}
if (typeOf(dirOptions) === 'boolean') {
dirOptions = { isolated: dirOptions };
}
if (
typeOf(dirOptions) !== 'object' ||
dirOptions === null ||
typeOf(dirOptions.isolated) !== 'boolean'
) {
dirOptions = { isolated: self.$isolated() };
}
return path.join(self.state(dirOptions), (dirOptions.isolated ? '' : self.$name() + '-') + 'log');
};
// log file
const logPath = path.join(xdgAppPaths.log(), 'debug.txt');
mkdirp.sync(path.dirname(logPath), 0o700);
// config file
// * search for config file within user preferred directories; otherwise, use preferred directory
const possibleConfigPaths = xdgAppPaths
.configDirs()
.concat(xdgAppPaths.configDirs({ isolated: !xdgAppPaths.$isolated() }))
.map((v) => path.join(v, xdgAppPaths.$name() + '.json'));
const configPath = locatePath.sync(possibleConfigPaths) || possibleConfigPaths[0];
// debug(logPath, 'configPath="%s"', configPath);
mkdirp.sync(path.dirname(configPath), 0o700);
// cache file
const cacheDir = path.join(xdgAppPaths.cache());
// debug(logPath, 'cacheDir="%s"', cacheDir);
mkdirp.sync(cacheDir, 0o700);
const cachePath = {};
cachePath.orders = path.join(cacheDir, 'orders.json');
cachePath.customers = path.join(cacheDir, 'customers.json');
//...
```
## Supported Platforms
### NodeJS
> #### Requirements
>
> NodeJS >= 4.0[^*]
<!--{blockquote: .--info style="font-size:75%;"}-->
[^*]: With the conversion to a TypeScript-based project, due to tooling constraints, building and testing are more difficult and more limited on Node platforms earlier than NodeJS-v10. However, the generated CommonJS/UMD project code is fully tested (for NodeJS-v10+) and continues to be compatible with NodeJS-v4+.
#### CommonJS modules (CJS; `*.js` and `*.cjs`)
CJS is the basic supported output (with support for NodeJS versions as early as NodeJS-v4).
```js
const xdgAppPaths = require('xdg-app-paths/cjs');
console.log(xdgAppPaths.config());
```
> Note: for CJS, `require('xdg-app-paths')` is supported for backward-compatibility and will execute correctly at run-time. However, `require('xdg-app-paths')` links to the default package type declarations which, though _correct_ for Deno/ESM/TypeScript, are _incorrect_ for CJS. This, then, leads to incorrect analysis of CJS files by static analysis tools such as TypeScript and Intellisense.
>
> Using `require('xdg-app-paths/cjs')` is preferred as it associates the proper CJS type declarations and provides correct information to static analysis tools.
#### ECMAScript modules (ESM; `*.mjs`)
- <small><span title="ESM support added in v6.0">Requires `XDGAppPaths` `v6.0`+.</span></small>
`XDGAppPaths` fully supports ESM imports.
```js
import xdgAppPaths from 'xdg-app-paths';
console.log(xdgAppPaths.config());
```
### TypeScript (`*.ts`)
- <small><span title="TypeScript support added in v6.0">Requires `XDGAppPaths` `v6.0`+.</span></small>
As of `v6.0`+, `XDGAppPaths` has been converted to a TypeScript-based module.
As a consequence, TypeScript type definitions are automatically generated, bundled, and exported by the module.
### Deno
> #### Requirements
>
> Deno >= v1.8.0[^deno-version-req]
<!--{blockquote: .--info style="font-size:75%;"}-->
[^deno-version-req]: The `Deno.permissions` API (stabilized in Deno v1.8.0) is required to avoid needless panics or prompts by Deno during static imports of this module/package. Note: Deno v1.3.0+ may be used if the run flag `--unstable` is also used.
> #### Required Permissions
>
> - `--allow-env` &middot; _allow access to the process environment variables_<br>
> This is a transitive requirement from the 'xdg'/'xdg-portable' module; `XDG` requires access to various environment variable to determine platform and user configuration (eg, XDG configuration variables, location of temp and user directories, ...).
> - `--allow-read` &middot; _allow read(-only) access to the file system_<br>
> This permission is required to use `Deno.mainModule`, which is, in turn, required to auto-generate the application name used for data isolation.
<!--{blockquote: .--info style="font-size:75%;"}-->
- <small><span title="Deno support added in v7.0">Requires `XDGAppPaths` `v7.0`+.</span></small>
`XDGAppPaths` also fully supports use by Deno.
```js deno
import xdgAppPaths from 'https://deno.land/x/xdg_app_paths/src/mod.deno.ts';
console.log(xdgAppPaths.config());
```
## Discussion
The [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)<small><sup>&shy;[@](https://archive.is/J0mTC)</sup></small> defines categories of user information (ie, "cache", "config", "data", ...), defines their standard storage locations, and defines the standard process for user configuration of those locations (using `XDG_CACHE_HOME`, etc).
Applications supporting the XDG convention are expected to store user-specific files within these locations, either within the common/shared directory (eg, `` `${xdg.cache()}/filename` ``) or within a more isolated application-defined subdirectory (eg, `` `${xdg.config()}/DIR/filename` ``; `DIR` usually being the application name).
### Windows ("win32") specific notes
Windows has an alternate convention, offering just two standard locations for applications to persist data, either `%APPDATA%` (for files which may "roam" with the user between hosts) and `%LOCALAPPDATA%` (for local-machine-only files). All application files are expected to be stored within an application-unique subdirectory in one of those two locations, usually under a directory matching the application name. There is no further popular convention used to segregate the file types (ie, into "cache", "config", ...) in any way similar to the XDG specification.
So, to support basic XDG-like behavior (that is, segregating the information types into type-specific directories), this module supports a new convention for Windows hosts (taken from [`xdg-portable`](https://www.npmjs.com/package/xdg-portable)), placing the specific types of files into subdirectories under either `%APPDATA%` or `%LOCALAPPDATA%`, as appropriate for the file type. The default directories used for the windows platform are listed by [`xdg-portable`](https://www.npmjs.com/package/xdg-portable#api).
By default, this module returns paths which are isolated, application-specific sub-directories under the respective common/shared base directories. These sub-directories are purely dedicated to use by the application. If, however, the application requires access to the common/shared areas, the `isolated: false` option may be used during initialization (or as an optional override for specific function calls) to generate and return the common/shared paths. Note, that when using the command/shared directories, take care to use file names which do not collide with those used by other applications.
### Origins
This module was forked from [sindresorhus/env-paths](https://github.com/sindresorhus/env-paths) in order to add cross-platform portability and support simpler cross-platform applications.
## Building and Contributing
[![Repository][repository-image]][repository-url]
[![Build status (GHA)][gha-image]][gha-url]
[![Build status (AppVeyor)][appveyor-image]][appveyor-url]
[![Coverage status][coverage-image]][coverage-url]
&nbsp; <br/>
[![Quality status (Codacy)][codacy-image]][codacy-url]
[![Quality status (CodeClimate)][codeclimate-image]][codeclimate-url]
[![Quality status (CodeFactor)][codefactor-image]][codefactor-url]
### Build requirements
- NodeJS >= 10.14
- a JavaScript package/project manager ([`npm`](https://www.npmjs.com/get-npm) or [`yarn`](https://yarnpkg.com))
- [`git`](https://git-scm.com)
> #### optional
>
> - [`bmp`](https://deno.land/x/bmp@v0.0.6) (v0.0.6+) ... synchronizes version strings within the project
> - [`git-changelog`](https://github.com/rivy-go/git-changelog) (v1.1+) ... enables changelog automation
### Quick build/test
```shell
npm install-test
```
### Contributions/development
#### _Reproducible_ setup (for CI or local development)
```shell
git clone "https://github.com/rivy/js.xdg-app-paths"
cd js.xdg-app-paths
# * note: for WinOS, replace `cp` with `copy` (or use [uutils](https://github.com/uutils/coreutils))
# npm
cp .deps-lock/package-lock.json .
npm clean-install
# yarn
cp .deps-lock/yarn.lock .
yarn --immutable --immutable-cache --check-cache
```
#### Project development scripts
```shell
> npm run help
...
usage: `npm run TARGET` or `npx run-s TARGET [TARGET..]`
TARGETs:
build build/compile package
clean remove build artifacts
coverage calculate and display (or send) code coverage [alias: 'cov']
fix fix package issues (automated/non-interactive)
fix:lint fix ESLint issues
fix:style fix Prettier formatting issues
help display help
lint check for package code 'lint'
lint:audit check for `npm audit` violations in project code
lint:commits check for commit flaws (using `commitlint` and `cspell`)
lint:editorconfig check for EditorConfig format flaws (using `editorconfig-checker`)
lint:lint check for code 'lint' (using `eslint`)
lint:markdown check for markdown errors (using `remark`)
lint:spell check for spelling errors (using `cspell`)
lint:style check for format imperfections (using `prettier`)
prerelease clean, rebuild, and fully test (useful prior to publish/release)
realclean remove all generated files
rebuild clean and (re-)build project
refresh clean and rebuild/regenerate all project artifacts
refresh:dist clean, rebuild, and regenerate project distribution
retest clean and (re-)test project
reset:hard remove *all* generated files and reinstall dependencies
show:deps show package dependencies
test test package
test:code test package code (use `--test-code=...` to pass options to testing harness)
test:types test for type declaration errors (using `tsd`)
update update/prepare for distribution [alias: 'dist']
update:changelog update CHANGELOG (using `git changelog ...`)
update:dist update distribution content
verify fully (and verbosely) test package
```
#### Packaging & Publishing
##### Package
```shell
#=== * POSIX
# update project VERSION strings (package.json,...)
# * `bmp --[major|minor|patch]`; next VERSION in M.m.r (semver) format
bmp --minor
VERSION=$(cat VERSION)
git-changelog --next-tag "v${VERSION}" > CHANGELOG.mkd
# create/commit updates and distribution
git add package.json CHANGELOG.mkd README.md VERSION .bmp.yml
git commit -m "${VERSION}"
npm run clean && npm run update:dist && git add dist && git commit --amend --no-edit
# (optional) update/save dependency locks
# * note: `yarn import` of 'package-lock.json' (when available) is faster but may not work for later versions of 'package-lock.json'
rm -f package-lock.json yarn.lock
npm install --package-lock
yarn install
mkdir .deps-lock 2> /dev/null
cp package-lock.json .deps-lock/
cp yarn.lock .deps-lock/
git add .deps-lock
git commit --amend --no-edit
# tag VERSION commit
git tag -f "v${VERSION}"
# (optional) prerelease checkup
npm run prerelease
#=== * WinOS
@rem # update project VERSION strings (package.json,...)
@rem # * `bmp --[major|minor|patch]`; next VERSION in M.m.r (semver) format
bmp --minor
for /f %G in (VERSION) do @set "VERSION=%G"
git-changelog --next-tag "v%VERSION%" > CHANGELOG.mkd
@rem # create/commit updates and distribution
git add package.json CHANGELOG.mkd README.md VERSION .bmp.yml
git commit -m "%VERSION%"
npm run clean && npm run update:dist && git add dist && git commit --amend --no-edit
@rem # (optional) update/save dependency locks
@rem # * note: `yarn import` of 'package-lock.json' (when available) is faster but may not work for later versions of 'package-lock.json'
del package-lock.json yarn.lock 2>NUL
npm install --package-lock
yarn install
mkdir .deps-lock 2>NUL
copy /y package-lock.json .deps-lock >NUL
copy /y yarn.lock .deps-lock >NUL
git add .deps-lock
git commit --amend --no-edit
@rem # tag VERSION commit
git tag -f "v%VERSION%"
@rem # (optional) prerelease checkup
npm run prerelease
```
##### Publish
```shell
# publish
# * optional (will be done in 'prePublishOnly' by `npm publish`)
npm run clean && npm run test && npm run dist && git-changelog > CHANGELOG.mkd #expect exit code == 0
git diff-index --quiet HEAD || echo "[lint] ERROR uncommitted changes" # expect no output and exit code == 0
# *
npm publish # `npm publish --dry-run` will perform all prepublication actions and stop just before the actual publish push
# * if published to NPMjs with no ERRORs; push to deno.land with tag push
git push origin --tags
```
### Contributions
Contributions are welcome.
Any pull requests should be based off of the default branch (`master`). And, whenever possible, please include tests for any new code, ensuring that local (via `npm test`) and remote CI testing passes.
By contributing to the project, you are agreeing to provide your contributions under the same [license](./LICENSE) as the project itself.
## Related
- [`xdg-portable`](https://www.npmjs.com/package/xdg-portable) ... XDG Base Directory paths (cross-platform)
- [`env-paths`](https://www.npmjs.com/package/env-paths) ... inspiration for this module
## License
[MIT](./LICENSE) © [Roy Ivy III](https://github.com/rivy)
<!-- badge references -->
<!-- Repository -->
<!-- Note: for '[repository-image] ...', `%E2%81%A3` == utf-8 sequence of "Unicode Character 'INVISIBLE SEPARATOR' (U+2063)"; ref: <https://codepoints.net/U+2063> -->
[repository-image]: https://img.shields.io/github/v/tag/rivy/js.xdg-app-paths?sort=semver&label=%E2%81%A3&logo=github&logoColor=white
[repository-url]: https://github.com/rivy/js.xdg-app-paths
[license-image]: https://img.shields.io/npm/l/xdg-app-paths.svg?color=tomato&style=flat
[license-url]: license
[nodejsv-image]: https://img.shields.io/node/v/xdg-app-paths?color=slateblue
[style-image]: https://img.shields.io/badge/code_style-prettier-mediumvioletred.svg
[style-url]: https://prettier.io
<!-- Continuous integration/deployment (CICD) -->
[appveyor-image]: https://img.shields.io/appveyor/ci/rivy/js-xdg-app-paths/master.svg?style=flat&logo=AppVeyor&logoColor=deepskyblue
[appveyor-url]: https://ci.appveyor.com/project/rivy/js-xdg-app-paths
[gha-image]: https://img.shields.io/github/actions/workflow/status/rivy/js.xdg-app-paths/CI.yml?branch=master&label=CI&logo=github
[gha-url]: https://github.com/rivy/js.xdg-app-paths/actions?query=workflow%3ACI
<!-- Code quality -->
[coverage-image]: https://img.shields.io/codecov/c/github/rivy/js.xdg-app-paths/master.svg
[coverage-url]: https://codecov.io/gh/rivy/js.xdg-app-paths
[codeclimate-url]: https://codeclimate.com/github/rivy/js.xdg-app-paths
[codeclimate-image]: https://img.shields.io/codeclimate/maintainability/rivy/js.xdg-app-paths?label=codeclimate
[codacy-image]: https://img.shields.io/codacy/grade/6f019c41b12b4c35a5ac5693744e4b96?label=codacy
[codacy-url]: https://app.codacy.com/gh/rivy/js.xdg-app-paths/dashboard
[codefactor-image]: https://img.shields.io/codefactor/grade/github/rivy/js.xdg-app-paths?label=codefactor
[codefactor-url]: https://www.codefactor.io/repository/github/rivy/js.xdg-app-paths
<!-- Distributors/Registries -->
[deno-image]: https://img.shields.io/github/v/tag/rivy/js.xdg-app-paths?label=deno
[deno-url]: https://deno.land/x/xdg_app_paths
[downloads-image]: http://img.shields.io/npm/dm/xdg-app-paths.svg?style=flat
[downloads-url]: https://npmjs.org/package/xdg-app-paths
[jsdelivr-image]: https://img.shields.io/jsdelivr/gh/hm/rivy/js.xdg-app-paths?style=flat
[jsdelivr-url]: https://www.jsdelivr.com/package/gh/rivy/js.xdg-app-paths
[npm-image]: https://img.shields.io/npm/v/xdg-app-paths.svg?style=flat
[npm-url]: https://npmjs.org/package/xdg-app-paths
<!-- Alternate/Old image/URL links -->
<!-- [appveyor-image]: https://ci.appveyor.com/api/projects/status/.../branch/master?svg=true -->
<!-- [coverage-image]: https://img.shields.io/coveralls/github/rivy/xdg-app-paths/master.svg -->
<!-- [coverage-url]: https://coveralls.io/github/rivy/xdg-app-paths -->
<!-- [npm-image]: https://img.shields.io/npm/v/xdg-app-paths.svg?style=flat&label=npm&logo=NPM&logoColor=linen -->
<!-- [repository-image]:https://img.shields.io/badge/%E2%9D%A4-darkcyan?style=flat&logo=github -->
<!-- [style-image]: https://img.shields.io/badge/code_style-standard-darkcyan.svg -->
<!-- [style-url]: https://standardjs.com -->
<!-- [travis-image]: https://img.shields.io/travis/rivy/js.xdg-app-paths/master.svg?style=flat&logo=Travis-CI&logoColor=silver -->
<!-- [travis-image]: https://travis-ci.org/rivy/js.xdg-app-paths.svg?branch=master -->
<!-- [travis-image]: https://img.shields.io/travis/rivy/js.xdg-app-paths/master.svg?style=flat&logo=travis -->
<!-- [travis-url]: https://travis-ci.org/rivy/js.xdg-app-paths -->

5
server/node_modules/xdg-app-paths/cjs/package.json generated vendored Normal file
View File

@@ -0,0 +1,5 @@
{
"type": "commonjs",
"main": "../dist/cjs/mod.cjs.js",
"types": "../dist/cjs/mod.cjs.d.ts"
}

View File

@@ -0,0 +1,5 @@
// deno-fmt-ignore-file ## prefer customized `prettier` formatting
import _ from '../mod.cjs.js';
export * from '../mod.cjs.js';
export default _;

View File

@@ -0,0 +1 @@
{"type": "module"}

View File

@@ -0,0 +1,85 @@
'use strict';
exports.__esModule = true;
exports.Adapt = void 0;
function isBoolean(t) {
return typeOf(t) === 'boolean';
}
function isObject(t) {
return typeOf(t) === 'object';
}
function isString(t) {
return typeOf(t) === 'string';
}
function typeOf(t) {
return typeof t;
}
function Adapt(adapter_) {
var meta = adapter_.meta, path = adapter_.path, xdg = adapter_.xdg;
var XDGAppPaths_ = (function () {
function XDGAppPaths_(options_) {
if (options_ === void 0) { options_ = {}; }
var _a, _b, _c;
function XDGAppPaths(options) {
if (options === void 0) { options = {}; }
return new XDGAppPaths_(options);
}
var options = (isObject(options_) ? options_ : { name: options_ });
var suffix = (_a = options.suffix) !== null && _a !== void 0 ? _a : '';
var isolated_ = (_b = options.isolated) !== null && _b !== void 0 ? _b : true;
var namePriorityList = [
options.name,
meta.pkgMainFilename(),
meta.mainFilename(),
];
var nameFallback = '$eval';
var name = path.parse(((_c = namePriorityList.find(function (e) { return isString(e); })) !== null && _c !== void 0 ? _c : nameFallback) + suffix).name;
XDGAppPaths.$name = function $name() {
return name;
};
XDGAppPaths.$isolated = function $isolated() {
return isolated_;
};
function isIsolated(dirOptions) {
var _a;
dirOptions = dirOptions !== null && dirOptions !== void 0 ? dirOptions : { isolated: isolated_ };
var isolated = isBoolean(dirOptions) ? dirOptions : (_a = dirOptions.isolated) !== null && _a !== void 0 ? _a : isolated_;
return isolated;
}
function finalPathSegment(dirOptions) {
return isIsolated(dirOptions) ? name : '';
}
XDGAppPaths.cache = function cache(dirOptions) {
return path.join(xdg.cache(), finalPathSegment(dirOptions));
};
XDGAppPaths.config = function config(dirOptions) {
return path.join(xdg.config(), finalPathSegment(dirOptions));
};
XDGAppPaths.data = function data(dirOptions) {
return path.join(xdg.data(), finalPathSegment(dirOptions));
};
XDGAppPaths.runtime = function runtime(dirOptions) {
return xdg.runtime()
? path.join(xdg.runtime(), finalPathSegment(dirOptions))
: void 0;
};
XDGAppPaths.state = function state(dirOptions) {
return path.join(xdg.state(), finalPathSegment(dirOptions));
};
XDGAppPaths.configDirs = function configDirs(dirOptions) {
return xdg
.configDirs()
.map(function (s) { return path.join(s, finalPathSegment(dirOptions)); });
};
XDGAppPaths.dataDirs = function dataDirs(dirOptions) {
return xdg
.dataDirs()
.map(function (s) { return path.join(s, finalPathSegment(dirOptions)); });
};
return XDGAppPaths;
}
return XDGAppPaths_;
}());
return { XDGAppPaths: new XDGAppPaths_() };
}
exports.Adapt = Adapt;
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiWERHQXBwUGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL1hER0FwcFBhdGhzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUdBLFlBQVksQ0FBQzs7O0FBbUZiLFNBQVMsU0FBUyxDQUFJLENBQWM7SUFDbkMsT0FBTyxNQUFNLENBQUMsQ0FBQyxDQUFDLEtBQUssU0FBUyxDQUFDO0FBQ2hDLENBQUM7QUFFRCxTQUFTLFFBQVEsQ0FBSSxDQUE4QjtJQUNsRCxPQUFPLE1BQU0sQ0FBQyxDQUFDLENBQUMsS0FBSyxRQUFRLENBQUM7QUFDL0IsQ0FBQztBQUVELFNBQVMsUUFBUSxDQUFJLENBQUk7SUFDeEIsT0FBTyxNQUFNLENBQUMsQ0FBQyxDQUFDLEtBQUssUUFBUSxDQUFDO0FBQy9CLENBQUM7QUFFRCxTQUFTLE1BQU0sQ0FBSSxDQUFJO0lBQ3RCLE9BQU8sT0FBTyxDQUFDLENBQUM7QUFDakIsQ0FBQztBQUVELFNBQVMsS0FBSyxDQUFDLFFBQTBCO0lBQ2hDLElBQUEsSUFBSSxHQUFnQixRQUFRLEtBQXhCLEVBQUUsSUFBSSxHQUFVLFFBQVEsS0FBbEIsRUFBRSxHQUFHLEdBQUssUUFBUSxJQUFiLENBQWM7SUFFckM7UUFDQyxzQkFBWSxRQUErQjtZQUEvQix5QkFBQSxFQUFBLGFBQStCOztZQUMxQyxTQUFTLFdBQVcsQ0FBQyxPQUE4QjtnQkFBOUIsd0JBQUEsRUFBQSxZQUE4QjtnQkFDbEQsT0FBTyxJQUFJLFlBQVksQ0FBQyxPQUFPLENBQWdCLENBQUM7WUFDakQsQ0FBQztZQUVELElBQU0sT0FBTyxHQUFHLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxDQUFZLENBQUM7WUFFaEYsSUFBTSxNQUFNLEdBQUcsTUFBQSxPQUFPLENBQUMsTUFBTSxtQ0FBSSxFQUFFLENBQUM7WUFDcEMsSUFBTSxTQUFTLEdBQUcsTUFBQSxPQUFPLENBQUMsUUFBUSxtQ0FBSSxJQUFJLENBQUM7WUFHM0MsSUFBTSxnQkFBZ0IsR0FBNkM7Z0JBQ2xFLE9BQU8sQ0FBQyxJQUFJO2dCQUNaLElBQUksQ0FBQyxlQUFlLEVBQUU7Z0JBQ3RCLElBQUksQ0FBQyxZQUFZLEVBQUU7YUFDbkIsQ0FBQztZQUNGLElBQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQztZQUM3QixJQUFNLElBQUksR0FBRyxJQUFJLENBQUMsS0FBSyxDQUN0QixDQUFDLE1BQUEsZ0JBQWdCLENBQUMsSUFBSSxDQUFDLFVBQUMsQ0FBQyxJQUFLLE9BQUEsUUFBUSxDQUFDLENBQUMsQ0FBQyxFQUFYLENBQVcsQ0FBQyxtQ0FBSSxZQUFZLENBQUMsR0FBRyxNQUFNLENBQ3BFLENBQUMsSUFBSSxDQUFDO1lBRVAsV0FBVyxDQUFDLEtBQUssR0FBRyxTQUFTLEtBQUs7Z0JBQ2pDLE9BQU8sSUFBSSxDQUFDO1lBQ2IsQ0FBQyxDQUFDO1lBQ0YsV0FBVyxDQUFDLFNBQVMsR0FBRyxTQUFTLFNBQVM7Z0JBQ3pDLE9BQU8sU0FBUyxDQUFDO1lBQ2xCLENBQUMsQ0FBQztZQUVGLFNBQVMsVUFBVSxDQUFDLFVBQWlDOztnQkFDcEQsVUFBVSxHQUFHLFVBQVUsYUFBVixVQUFVLGNBQVYsVUFBVSxHQUFJLEVBQUUsUUFBUSxFQUFFLFNBQVMsRUFBRSxDQUFDO2dCQUNuRCxJQUFNLFFBQVEsR0FBRyxTQUFTLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsTUFBQSxVQUFVLENBQUMsUUFBUSxtQ0FBSSxTQUFTLENBQUM7Z0JBQ3ZGLE9BQU8sUUFBUSxDQUFDO1lBQ2pCLENBQUM7WUFFRCxTQUFTLGdCQUFnQixDQUFDLFVBQWlDO2dCQUMxRCxPQUFPLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7WUFDM0MsQ0FBQztZQUVELFdBQVcsQ0FBQyxLQUFLLEdBQUcsU0FBUyxLQUFLLENBQUMsVUFBaUM7Z0JBQ25FLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUUsZ0JBQWdCLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQztZQUM3RCxDQUFDLENBQUM7WUFFRixXQUFXLENBQUMsTUFBTSxHQUFHLFNBQVMsTUFBTSxDQUFDLFVBQWlDO2dCQUNyRSxPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxFQUFFLGdCQUFnQixDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUM7WUFDOUQsQ0FBQyxDQUFDO1lBRUYsV0FBVyxDQUFDLElBQUksR0FBRyxTQUFTLElBQUksQ0FBQyxVQUFpQztnQkFDakUsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLEVBQUUsRUFBRSxnQkFBZ0IsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDO1lBQzVELENBQUMsQ0FBQztZQUVGLFdBQVcsQ0FBQyxPQUFPLEdBQUcsU0FBUyxPQUFPLENBQUMsVUFBaUM7Z0JBQ3ZFLE9BQU8sR0FBRyxDQUFDLE9BQU8sRUFBRTtvQkFDbkIsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBWSxFQUFFLGdCQUFnQixDQUFDLFVBQVUsQ0FBQyxDQUFDO29CQUNsRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDWCxDQUFDLENBQUM7WUFFRixXQUFXLENBQUMsS0FBSyxHQUFHLFNBQVMsS0FBSyxDQUFDLFVBQWlDO2dCQUNuRSxPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxFQUFFLGdCQUFnQixDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUM7WUFDN0QsQ0FBQyxDQUFDO1lBRUYsV0FBVyxDQUFDLFVBQVUsR0FBRyxTQUFTLFVBQVUsQ0FBQyxVQUFpQztnQkFDN0UsT0FBTyxHQUFHO3FCQUNSLFVBQVUsRUFBRTtxQkFDWixHQUFHLENBQUMsVUFBQyxDQUFDLElBQUssT0FBQSxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsRUFBRSxnQkFBZ0IsQ0FBQyxVQUFVLENBQUMsQ0FBQyxFQUExQyxDQUEwQyxDQUFzQixDQUFDO1lBQy9FLENBQUMsQ0FBQztZQUVGLFdBQVcsQ0FBQyxRQUFRLEdBQUcsU0FBUyxRQUFRLENBQUMsVUFBaUM7Z0JBQ3pFLE9BQU8sR0FBRztxQkFDUixRQUFRLEVBQUU7cUJBQ1YsR0FBRyxDQUFDLFVBQUMsQ0FBQyxJQUFLLE9BQUEsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsZ0JBQWdCLENBQUMsVUFBVSxDQUFDLENBQUMsRUFBMUMsQ0FBMEMsQ0FBc0IsQ0FBQztZQUMvRSxDQUFDLENBQUM7WUFFRixPQUFPLFdBQTBCLENBQUM7UUFDbkMsQ0FBQztRQUNGLG1CQUFDO0lBQUQsQ0FBQyxBQTNFRCxJQTJFQztJQUVELE9BQU8sRUFBRSxXQUFXLEVBQUUsSUFBSSxZQUFZLEVBQWlCLEVBQUUsQ0FBQztBQUMzRCxDQUFDO0FBR1Esc0JBQUsifQ==

View File

@@ -0,0 +1,56 @@
/** Configuration options supplied to `XDGAppPaths` methods */
interface DirOptions {
/** Isolation flag; used to override the default isolation mode, when needed. */
readonly isolated?: boolean | null;
}
/** Configuration options supplied when constructing `XDGAppPaths` */
interface Options {
/** Name of the application; used to generate isolated application paths.
> When missing (`undefined`), `null`, or empty (`''`), it is generated automatically from the process main file name, where determinable.
> "$eval" is used as a final fallback value when the application name cannot otherwise be determined.
*/
readonly name?: string | null;
/** Suffix which is appended to the application name when generating the application paths. */
readonly suffix?: string | null;
/** Default isolation flag (used when no isolation flag is supplied for `DirOptions`). */
readonly isolated?: boolean | null;
}
/** `XDGAppPaths` (API) - Determine (XDG-compatible) paths for storing application files (cache, config, data, etc) */
interface XDGAppPaths {
/** Create an `XDGAppPaths` object (a preceding `new` is optional). */
(options?: Options | string): XDGAppPaths;
/** Create an `XDGAppPaths` object (`new` is optional). */
new (options?: Options | string): XDGAppPaths;
/** Returns the directory for non-essential data files.
> Deletion of the data contained here might cause an application to slow down.
*/
cache(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for config files.
> Deletion of the data contained here might require the user to reconfigure an application.
*/
config(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for data files.
> Deletion of the data contained here might force the user to restore from backups.
*/
data(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for runtime files; may return `undefined`.
> Deletion of the data contained here might interfere with a currently executing application but should have no effect on future executions.
*/
runtime(dirOptions?: DirOptions | boolean): string | undefined;
/** Returns the directory for state files.
> Deletion of the data contained here should not materially interfere with execution of an application.
*/
state(dirOptions?: DirOptions | boolean): string;
/** Returns a priority-sorted list of possible directories for configuration file storage (includes `paths.config()` as the first entry). */
configDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Returns a priority-sorted list of possible directories for data file storage (includes `paths.data()` as the first entry). */
dataDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Application name used for path construction (from supplied configuration or auto-generated). */
$name(): string;
/** Default isolation mode used by the particular `XDGAppPaths` instance. */
$isolated(): boolean;
}
declare const _default: XDGAppPaths;
export = _default;

View File

@@ -0,0 +1,5 @@
"use strict";
var XDGAppPaths_js_1 = require("./lib/XDGAppPaths.js");
var node_js_1 = require("./platform-adapters/node.js");
module.exports = XDGAppPaths_js_1.Adapt(node_js_1.adapter).XDGAppPaths;
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9kLmNqcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9tb2QuY2pzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFFQSx1REFBNkM7QUFFN0MsdURBQXNEO0FBRXRELGlCQUFTLHNCQUFLLENBQUMsaUJBQU8sQ0FBQyxDQUFDLFdBQTBCLENBQUMifQ==

View File

@@ -0,0 +1,3 @@
"use strict";
exports.__esModule = true;
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiX2Jhc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvcGxhdGZvcm0tYWRhcHRlcnMvX2Jhc2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

View File

@@ -0,0 +1,48 @@
"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
__setModuleDefault(result, mod);
return result;
};
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
exports.__esModule = true;
exports.adapter = void 0;
var path = __importStar(require("path"));
var xdg_portable_1 = __importDefault(require("xdg-portable"));
exports.adapter = {
atImportPermissions: { env: true, read: true },
meta: {
mainFilename: function () {
var requireMain = typeof require !== 'undefined' && require !== null && require.main
? require.main
: { filename: void 0 };
var requireMainFilename = requireMain.filename;
var filename = (requireMainFilename !== process.execArgv[0] ? requireMainFilename : void 0) ||
(typeof process._eval === 'undefined' ? process.argv[1] : void 0);
return filename;
},
pkgMainFilename: function () {
return process.pkg ? process.execPath : void 0;
}
},
path: path,
process: process,
xdg: xdg_portable_1["default"]
};
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm9kZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9wbGF0Zm9ybS1hZGFwdGVycy9ub2RlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFQSx5Q0FBNkI7QUFFN0IsOERBQStCO0FBSWxCLFFBQUEsT0FBTyxHQUFxQjtJQUN4QyxtQkFBbUIsRUFBRSxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRTtJQUM5QyxJQUFJLEVBQUU7UUFDTCxZQUFZLEVBQUU7WUFDYixJQUFNLFdBQVcsR0FDaEIsT0FBTyxPQUFPLEtBQUssV0FBVyxJQUFJLE9BQU8sS0FBSyxJQUFJLElBQUksT0FBTyxDQUFDLElBQUk7Z0JBQ2pFLENBQUMsQ0FBQyxPQUFPLENBQUMsSUFBSTtnQkFDZCxDQUFDLENBQUMsRUFBRSxRQUFRLEVBQUUsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUN6QixJQUFNLG1CQUFtQixHQUFHLFdBQVcsQ0FBQyxRQUFRLENBQUM7WUFDakQsSUFBTSxRQUFRLEdBRWIsQ0FBQyxtQkFBbUIsS0FBSyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7Z0JBRzVFLENBQUMsT0FBUSxPQUFlLENBQUMsS0FBSyxLQUFLLFdBQVcsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztZQUM1RSxPQUFPLFFBQVEsQ0FBQztRQUNqQixDQUFDO1FBQ0QsZUFBZSxFQUFFO1lBRWhCLE9BQVEsT0FBZSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDekQsQ0FBQztLQUNEO0lBQ0QsSUFBSSxNQUFBO0lBQ0osT0FBTyxTQUFBO0lBQ1AsR0FBRywyQkFBQTtDQUNILENBQUMifQ==

View File

@@ -0,0 +1,56 @@
/** Configuration options supplied to `XDGAppPaths` methods */
interface DirOptions {
/** Isolation flag; used to override the default isolation mode, when needed. */
readonly isolated?: boolean | null;
}
/** Configuration options supplied when constructing `XDGAppPaths` */
interface Options {
/** Name of the application; used to generate isolated application paths.
> When missing (`undefined`), `null`, or empty (`''`), it is generated automatically from the process main file name, where determinable.
> "$eval" is used as a final fallback value when the application name cannot otherwise be determined.
*/
readonly name?: string | null;
/** Suffix which is appended to the application name when generating the application paths. */
readonly suffix?: string | null;
/** Default isolation flag (used when no isolation flag is supplied for `DirOptions`). */
readonly isolated?: boolean | null;
}
/** `XDGAppPaths` (API) - Determine (XDG-compatible) paths for storing application files (cache, config, data, etc) */
interface XDGAppPaths {
/** Create an `XDGAppPaths` object (a preceding `new` is optional). */
(options?: Options | string): XDGAppPaths;
/** Create an `XDGAppPaths` object (`new` is optional). */
new (options?: Options | string): XDGAppPaths;
/** Returns the directory for non-essential data files.
> Deletion of the data contained here might cause an application to slow down.
*/
cache(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for config files.
> Deletion of the data contained here might require the user to reconfigure an application.
*/
config(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for data files.
> Deletion of the data contained here might force the user to restore from backups.
*/
data(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for runtime files; may return `undefined`.
> Deletion of the data contained here might interfere with a currently executing application but should have no effect on future executions.
*/
runtime(dirOptions?: DirOptions | boolean): string | undefined;
/** Returns the directory for state files.
> Deletion of the data contained here should not materially interfere with execution of an application.
*/
state(dirOptions?: DirOptions | boolean): string;
/** Returns a priority-sorted list of possible directories for configuration file storage (includes `paths.config()` as the first entry). */
configDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Returns a priority-sorted list of possible directories for data file storage (includes `paths.data()` as the first entry). */
dataDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Application name used for path construction (from supplied configuration or auto-generated). */
$name(): string;
/** Default isolation mode used by the particular `XDGAppPaths` instance. */
$isolated(): boolean;
}
declare const _default: XDGAppPaths;
export = _default;

56
server/node_modules/xdg-app-paths/dist/types/mod.d.ts generated vendored Normal file
View File

@@ -0,0 +1,56 @@
/** Configuration options supplied to `XDGAppPaths` methods */
interface DirOptions {
/** Isolation flag; used to override the default isolation mode, when needed. */
readonly isolated?: boolean | null;
}
/** Configuration options supplied when constructing `XDGAppPaths` */
interface Options {
/** Name of the application; used to generate isolated application paths.
> When missing (`undefined`), `null`, or empty (`''`), it is generated automatically from the process main file name, where determinable.
> "$eval" is used as a final fallback value when the application name cannot otherwise be determined.
*/
readonly name?: string | null;
/** Suffix which is appended to the application name when generating the application paths. */
readonly suffix?: string | null;
/** Default isolation flag (used when no isolation flag is supplied for `DirOptions`). */
readonly isolated?: boolean | null;
}
/** `XDGAppPaths` (API) - Determine (XDG-compatible) paths for storing application files (cache, config, data, etc) */
interface XDGAppPaths {
/** Create an `XDGAppPaths` object (a preceding `new` is optional). */
(options?: Options | string): XDGAppPaths;
/** Create an `XDGAppPaths` object (`new` is optional). */
new (options?: Options | string): XDGAppPaths;
/** Returns the directory for non-essential data files.
> Deletion of the data contained here might cause an application to slow down.
*/
cache(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for config files.
> Deletion of the data contained here might require the user to reconfigure an application.
*/
config(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for data files.
> Deletion of the data contained here might force the user to restore from backups.
*/
data(dirOptions?: DirOptions | boolean): string;
/** Returns the directory for runtime files; may return `undefined`.
> Deletion of the data contained here might interfere with a currently executing application but should have no effect on future executions.
*/
runtime(dirOptions?: DirOptions | boolean): string | undefined;
/** Returns the directory for state files.
> Deletion of the data contained here should not materially interfere with execution of an application.
*/
state(dirOptions?: DirOptions | boolean): string;
/** Returns a priority-sorted list of possible directories for configuration file storage (includes `paths.config()` as the first entry). */
configDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Returns a priority-sorted list of possible directories for data file storage (includes `paths.data()` as the first entry). */
dataDirs(dirOptions?: DirOptions | boolean): readonly string[];
/** Application name used for path construction (from supplied configuration or auto-generated). */
$name(): string;
/** Default isolation mode used by the particular `XDGAppPaths` instance. */
$isolated(): boolean;
}
declare const _: XDGAppPaths;
export { DirOptions, Options, XDGAppPaths, _ as default };

277
server/node_modules/xdg-app-paths/package.json generated vendored Normal file
View File

@@ -0,0 +1,277 @@
{
"name": "xdg-app-paths",
"version": "8.3.0",
"description": "Determine (XDG-compatible) paths for storing application files (cache, config, data, etc)",
"license": "MIT",
"repository": "rivy/js.xdg-app-paths",
"author": {
"name": "Roy Ivy III",
"email": "rivy.dev@gmail.com"
},
"engines": {
"node": ">= 4.0"
},
"packageManager": "yarn@1.22.19",
"files": [
"cjs",
"dist/cjs",
"dist/types",
"CHANGELOG.mkd",
"LICENSE",
"README.md",
"package.json"
],
"type": "commonjs",
"main": "./dist/cjs/mod.cjs.js",
"module": "./dist/cjs/esm-wrapper/mod.esm.js",
"types": "./dist/types/mod.d.ts",
"exports": {
".": {
"deno": "./src/mod.deno.ts",
"import": "./dist/cjs/esm-wrapper/mod.esm.js",
"require": "./dist/cjs/mod.cjs.js",
"types": "./dist/types/mod.d.ts",
"default": "./dist/cjs/mod.cjs.js"
},
"./package.json": "./package.json",
"./cjs": {
"require": "./dist/cjs/mod.cjs.js",
"types": "./dist/cjs/mod.cjs.d.ts"
}
},
"keywords": [
"appdir",
"application",
"cache",
"common",
"config",
"cross-platform",
"data",
"directory",
"environment",
"linux",
"mac",
"macos",
"node4",
"node6",
"node-v4",
"node-v6",
"osx",
"path",
"paths",
"portable",
"runtime",
"state",
"unix",
"user",
"windows",
"xdg"
],
"scripts": {
"# build # build/compile package": "",
"build": "run-s --silent \"build:*\"",
"build:cjs": "exec-if-updated --source package.json --source tsconfig.json --source \"tsconfig/**\" --source \"rollup.*.config.js\" --source \"src/**\" --target build/.targets/build-cjs.succeeded \"run-s -n rebuild:cjs\"",
"build:esm": "exec-if-updated --source package.json --source tsconfig.json --source \"tsconfig/**\" --source \"rollup.*.config.js\" --source \"src/**\" --target build/.targets/build-esm.succeeded \"run-s -n rebuild:esm\"",
"build:umd": "exec-if-updated --source package.json --source tsconfig.json --source \"tsconfig/**\" --source \"rollup.*.config.js\" --source \"src/**\" --target build/.targets/build-umd.succeeded \"run-s -n rebuild:umd\"",
"build:lab": "exec-if-updated --source package.json --source tsconfig.json --source \"tsconfig/**\" --source \"rollup.*.config.js\" --source \"src/**\" --target build/.targets/build-lab.succeeded \"run-s -n rebuild:lab\"",
"build:types": "exec-if-updated --source package.json --source tsconfig.json --source \"tsconfig/**\" --source \"rollup.*.config.js\" --source \"src/**\" --target build/.targets/build-types.succeeded \"run-s -n rebuild:types\"",
"# clean # remove build artifacts": "",
"clean": "shx rm -fr build dist",
"# coverage # calculate and display (or send) code coverage [alias: 'cov']": "",
"coverage": "run-s --silent +:max-node-8 && shx echo \"[coverage] WARN Code coverage skipped [for NodeJS < v10]\" 1>&2 || run-s \"+:coverage\"",
"cov": "run-s coverage",
"cov:html": "nyc report --reporter=html --report-dir=.coverage",
"#* cov:send # use `--cov-send=...` to pass options to coverage uploader": "",
"cov:send": "shx mkdir -p .coverage && nyc report --reporter=text-lcov > \".coverage/@coverage.lcov\" && cross-env-shell codecov --disable=gcov --file=\".coverage/@coverage.lcov\" $npm_config_cov_send",
"cov:text": "nyc report",
"cov:view": "run-s cov:html && cd .coverage && open-cli index.html",
"dist": "run-s update",
"# fix # fix package issues (automated/non-interactive)": "",
"fix": "run-s fix:*",
"# fix:lint # fix ESLint issues": "",
"fix:lint": "eslint . --fix",
"# fix:style # fix Prettier formatting issues": "",
"fix:style": "prettier . --write --list-different",
"# help # display help": "",
"help": "run-s --silent _:help",
"# lint # check for package code 'lint'": "",
"lint": "run-s --silent +:max-node-8 && shx echo \"[lint] WARN Lint checks skipped [for NodeJS < v10]\" 1>&2 || run-p --print-name \"lint:*\"",
"# lint:audit # check for `npm audit` violations in project code": "",
"lint:audit": "run-s --silent -- npm audit --omit dev",
"# lint:commits # check for commit flaws (using `commitlint` and `cspell`)": "",
"lint:commits": "run-p --silent \"_:lint:commits:new:*\"",
"# lint:editorconfig # check for EditorConfig format flaws (using `editorconfig-checker`)": "",
"lint:editorconfig": "editorconfig-checker -config .ecrc.JS.json",
"# lint:lint # check for code 'lint' (using `eslint`)": "",
"lint:lint": "eslint .",
"# lint:markdown # check for markdown errors (using `remark`)": "",
"lint:markdown": "remark --quiet .",
"# lint:spell # check for spelling errors (using `cspell`)": "",
"lint:spell": "cspell {eg,examples,src,test}/**/* CHANGELOG{,.md,.mkd} README{,.md,.mkd} --no-summary --config \".vscode/cspell.json\"",
"# lint:style # check for format imperfections (using `prettier`)": "",
"lint:style": "prettier . --check --loglevel warn",
"# prerelease # clean, rebuild, and fully test (useful prior to publish/release)": "",
"prerelease": "run-s clean update verify",
"# realclean # remove all generated files": "",
"realclean": "run-s clean && shx rm -fr .coverage .nyc_output",
"# rebuild # clean and (re-)build project": "",
"rebuild": "run-s clean build",
"rebuild:all": "run-s clean build update",
"rebuild:cjs": "shx rm -fr build/cjs && tsc -p tsconfig/tsconfig.cjs.json && shx cp -r src/esm-wrapper build/cjs/src && shx mkdir -p build/.targets && shx touch build/.targets/build-cjs.succeeded",
"rebuild:esm": "shx rm -fr build/esm && tsc -p tsconfig/tsconfig.esm.json && shx cp src/esm-wrapper/package.json build/esm/src && shx mkdir -p build/.targets && shx touch build/.targets/build-esm.succeeded",
"rebuild:umd": "shx rm -fr build/umd && tsc -p tsconfig/tsconfig.umd.json && shx mkdir -p build/.targets && shx touch build/.targets/build-umd.succeeded",
"rebuild:lab": "shx rm -fr build/lab && tsc -p tsconfig/tsconfig.lab.json && shx cp -r src/esm-wrapper build/lab/src && shx mkdir -p build/.targets && shx touch build/.targets/build-lab.succeeded",
"rebuild:types": "shx rm -fr build/types && tsc -p tsconfig/tsconfig.types.json && shx mkdir -p build/.targets && shx touch build/.targets/build-types.succeeded",
"# refresh # clean and rebuild/regenerate all project artifacts": "",
"refresh": "run-s rebuild:all",
"# refresh:dist # clean, rebuild, and regenerate project distribution": "",
"refresh:dist": "run-s rebuild update:dist",
"# retest # clean and (re-)test project": "",
"retest": "run-s clean test",
"# reset:hard # remove *all* generated files and reinstall dependencies": "",
"reset:hard": "git clean -dfx && git reset --hard && npm install",
"# show:deps # show package dependencies": "",
"show:deps": "run-s --silent _:show:deps:prod _:show:deps:dev || shx true",
"# test # test package": "",
"test": "run-s --silent lint update:dist && run-p test:*",
"# test:code # test package code (use `--test-code=...` to pass options to testing harness)": "",
"test:code": "run-s --silent +:max-node-8 && cross-env-shell ava $npm_config_test_code || ( run-s --silent +:min-node-10 && cross-env-shell nyc --silent ava $npm_config_test_code )",
"# test:types # test for type declaration errors (using `tsd`)": "",
"test:types": "run-s --silent +:max-node-8 && shx echo \"[test:types] WARN Type testing skipped [for NodeJS < v10]\" 1>&2 || tsd",
"# update # update/prepare for distribution [alias: 'dist']": "",
"update": "run-s update:changelog update:dist",
"# update:changelog # update CHANGELOG (using `git changelog ...`)": "",
"update:changelog": "run-s --silent _:update:changelog && git diff --quiet --exit-code CHANGELOG.mkd || shx echo \"[update] info CHANGELOG updated\"",
"# update:dist # update distribution content": "",
"update:dist": "run-s --silent build && exec-if-updated --source \"build/**\" --target \"dist/**\" --target build/.targets/update-dist.succeeded \"run-s --silent _:update:dist:rebuild\"",
"# verify # fully (and verbosely) test package": "",
"verify": "cross-env npm_config_test_dist=true npm_config_test=--verbose run-s test",
"## +:... == sub-scripts (may run 'visibly', but not user-facing)": "",
"+:coverage": "run-s build test:code && ( is-ci && run-s cov:send ) || ( run-s --silent _:is-not-ci && run-s cov:view )",
"+:max-node-8": "is-node-not-modern 10",
"+:min-node-10": "is-node-modern 10",
"## _:... == sub-scripts ('hidden'; generally should be run 'silently' using `run-s/run-p --silent ...`": "",
"_:debug:env": "node -e \"console.log({env: process.env})\"",
"_:exists:git-changelog": "node -e \"if (!require('command-exists').sync('git-changelog')){process.exit(1);};\" || ( shx echo \"WARN `git-changelog` missing (try `go get -u github.com/rivy-go/git-changelog/cmd/git-changelog`)\" & exit 1 )",
"* _:help # print usage/TARGETs by matching lines containing leading double-quoted text like `# TARGET_NAME # HELP_TEXT`": "",
"_:help": "< package.json node -e \"s = {p:'',e:'npm'}; if (new String(process.env.npm_execpath).match(/yarn.js$/)) { s = {p:'\\n',e:'yarn'}; }; console.log('%sUsage: \\`\\x1b[2m%s run TARGET\\x1b[m\\` or \\`\\x1b[2mnpx run-s TARGET [TARGET..]\\x1b[m\\`\\n\\nTARGETs:\\n', s.p, s.e); re = /^.*?\\x22(?:#\\s*)(\\w[^#\\x22]*)\\s+#+\\s+([^\\x22]+?)(\\s+#+)?\\x22.*$/; require('readline').createInterface({ input: process.stdin, output: process.stdout, terminal: false }).on('line', function(line){ if (match = re.exec(line)) { console.log('\\x1b[0;32m%s\\x1b[m %s', match[1].padEnd(19), match[2]); } }).on('close', () => { /^win/i.test(process.platform) || console.log(); });\"",
"_:is-not-ci": "is-ci && exit 1 || exit 0",
"_:lint:commits:all:spell": "node -e \"result=require('child_process').spawnSync('git log --color=never | cspell stdin --no-summary --config \".vscode/cspell.json\"',{shell:true,encoding:'utf-8'}); if (result.status != 0) {console.error('[cspell] ERR! Unknown words in commit(s)\\n'+result.stdout+'\\n'+result.stderr); process.exit(1);} else {console.log(result.stdout);};\"",
"* _:lint:commits:new:... * note: review from 'origin/last' or tag just prior to version-sorted latest, with fallback to first commit": "",
"_:lint:commits:new:commitlint": "node -e \"result=require('child_process').spawnSync('( git tag --list [#v]* --contains origin/last --sort=v:refname || shx true ) && ( git describe --tags --abbrev=0 HEAD~1 || shx true ) && ( git rev-list --max-parents=0 HEAD --abbrev-commit --abbrev=16 || shx true )',{shell:true,encoding:'utf-8'}); o=result.stdout.split(/\\r?\\n/).filter((s)=>!!s); vs=o; v=vs[0]; result=require('child_process').spawnSync('commitlint --config .commitlint.config.js --from '+v,{shell:true,encoding:'utf-8'}); if (result.status != 0) {console.error('[commitlint] ERR! Flawed commit(s) found (within \\'%s..HEAD\\')\\n'+result.stdout+'\\n'+result.stderr, v); process.exit(1);} else { (result.stdout.length > 0) && console.log(result.stdout);};\" || shx true",
"_:lint:commits:new:spell": "node -e \"result=require('child_process').spawnSync('( git tag --list [#v]* --contains origin/last --sort=v:refname || shx true ) && ( git describe --tags --abbrev=0 HEAD~1 || shx true ) && ( git rev-list --max-parents=0 HEAD --abbrev-commit --abbrev=16 || shx true )',{shell:true,encoding:'utf-8'}); o=result.stdout.split(/\\r?\\n/).filter((s)=>!!s); vs=o; v=vs[0]; result=require('child_process').spawnSync('git log '+v+'.. --color=never | cspell stdin --no-summary --config \".vscode/cspell.json\"',{shell:true,encoding:'utf-8'}); if (result.status != 0) {console.error('[cspell] ERR! Unknown words in commit(s) (within \\'%s..HEAD\\')\\n'+result.stdout+'\\n'+result.stderr, v); process.exit(1);} else {(result.stdout.length > 0) && console.log(result.stdout);};\" || shx true",
"_:show:deps:dev": "npm --silent ls --only development || shx true",
"_:show:deps:prod": "npm --silent ls --only production || shx true",
"_:vcs-clean": "git diff --quiet",
"_:vcs-clean-err": "run-s --silent _:vcs-clean || ( shx echo \"[vcs] ERR! Uncommitted changes\" 1>&2 & exit 1 )",
"_:vcs-strictly-clean": "git status --porcelain | node -e \"process.stdin.on('data',function(_){process.exit(1);});\"",
"_:vcs-strictly-clean-err": "run-s --silent _:vcs-strictly-clean || ( shx echo \"[vcs] ERR! Uncommitted changes and/or untracked files\" 1>&2 & exit 1 )",
"_:update:changelog": "run-s --silent _:exists:git-changelog && git changelog > CHANGELOG.mkd || shx echo \"[update] WARN CHANGELOG not updated\" 1>&2",
"_:update:dist.build": "shx rm -fr dist/cjs dist/esm && shx mkdir -p dist/cjs dist/esm && shx cp -r build/cjs/src/* dist/cjs && shx cp -r build/esm/src/* dist/esm",
"_:update:dist.normalizeEOL": "eolConverter lf dist/**/*.{cjs,js,mjs,ts,json}",
"_:update:dist.pack": "node -e \"delete process.env.npm_config_dry_run; name=require('./package.json').name; name=name.replace(/^@/,'').replace('/','-'); result=require('child_process').spawnSync('npm pack && shx mkdir -p dist && shx mv '+name+'-*.tgz dist/'+name+'.tgz',{shell:true,encoding:'utf-8'}); if (result.status != 0) {console.error('[update] ERR! Unable to package (into *.tgz) for distribution\\n'+result.stdout+'\\n'+result.stderr); process.exit(1);} else {console.log(result.stdout);};\"",
"_:update:dist.types": "shx mkdir -p dist && shx rm -fr dist/types && rollup --config .rollup.config.types.js && replace-in-file \"export { _default as default }\" \"export = _default\" dist/types/mod.cjs.d.ts --quiet && shx mkdir -p dist/cjs && shx cp dist/types/*.cjs.d.ts dist/cjs",
"_:update:dist:rebuild": "shx rm -fr dist && run-s --silent _:update:dist.build _:update:dist.types _:update:dist.normalizeEOL _:update:dist.pack && shx mkdir -p dist/.targets && shx touch build/.targets/update-dist.succeeded",
"_:version:spell:changelog_update": "run-s --silent _:exists:git-changelog && git changelog -u | cspell stdin --config \".vscode/cspell.json\" || shx echo \"[lint] WARN CHANGELOG update `cspell` exception\" 1>&2",
"_:version:update:changelog": "run-s --silent _:exists:git-changelog && node -e \"v=require('./package.json').version; result=require('child_process').spawnSync('git changelog --next-tag-now --next-tag v'+v,{shell:true,encoding:'utf-8'}); if (result.status != 0) {console.error('ERR! '+result.stderr); process.exit(1);} else {m='fs';require(m).writeFileSync('CHANGELOG.mkd',result.stdout);};\" || shx echo \"[version] WARN CHANGELOG not updated\" 1>&2",
"## npm lifecycle scripts ##": "",
"prepublishOnly": "run-s clean update && cross-env npm_config_test_dist=true npm run test && run-s --silent update _:vcs-strictly-clean-err",
"## npm-version scripts ##": "",
"preversion": "run-s --silent _:version:spell:changelog_update && cross-env npm_config_test_dist=true npm run test",
"version": "run-s --silent _:version:update:changelog && run-s lint:spell && run-s --silent update:dist && git add CHANGELOG.mkd dist"
},
"dependencies": {
"xdg-portable": "^10.6.0"
},
"devDependencies:#": "* for testing, Node-v6 requires ava < v2 and nyc < v15",
"devDependencies": {
"@ava/typescript": "^1.1.1",
"@commitlint/cli": "^11.0.0",
"@commitlint/config-conventional": "^11.0.0",
"@istanbuljs/nyc-config-typescript": "^1.0.1",
"@types/node": "^14.14.20",
"@typescript-eslint/eslint-plugin": "^4",
"@typescript-eslint/parser": "^4",
"ava": "^3.15.0",
"codecov": "^3.5.0",
"command-exists": "^1.2.9",
"cross-env": "^7.0.3",
"cross-spawn": "^7.0.3",
"cspell": "^4.2.7",
"editorconfig-checker": "^3.3.0",
"eol-converter-cli": "^1.0.8",
"eslint": "^7",
"eslint-config-prettier": "^7",
"eslint-plugin-eslint-comments": "^3",
"eslint-plugin-functional": "^3",
"eslint-plugin-import": "^2",
"eslint-plugin-security": "^1",
"eslint-plugin-security-node": "^1",
"exec-if-updated": "https://cdn.jsdelivr.net/gh/rivy/js-cli.exec-if-updated@2.2.0/dist/pkg/exec-if-updated.tgz",
"is-ci": "^2.0.0",
"is-node-modern": "^1.0.0",
"npm-run-all": "^4.1.5",
"nyc": "^15.1.0",
"open-cli": ">=6.0 <7.0",
"prettier": "^2.1.1",
"remark-cli": "=9.0.0",
"remark-footnotes": "^3.0.0",
"remark-preset-lint-consistent": "^4.0.0",
"remark-preset-lint-markdown-style-guide": "^4.0.0",
"remark-preset-lint-recommended": "^5.0.0",
"remark-retext": "^4.0.0",
"replace-in-file": "=6.3.0",
"retext-english": "^3.0.4",
"retext-passive": "^3.0.0",
"retext-repeated-words": "^3.0.0",
"retext-sentence-spacing": "^4.0.0",
"retext-syntax-urls": "^2.0.0",
"rollup": "^2.36.1",
"rollup-plugin-dts": "^2.0.1",
"rollup-plugin-typescript2": "^0.29.0",
"shx": "^0.3.3",
"ts-node": "^9.0.0",
"tsd": "^0.14.0",
"typedoc": "^0.20.27",
"typescript": "~4.2.0",
"unified": "^9.2.0"
},
"optionalDependencies:#": "* 'fsevents' included to avoid `npm ci` errors with early npm versions; ref: <https://github.com/bahmutov/npm-install/issues/103>",
"optionalDependencies": {
"fsevents": "*"
},
"ava": {
"files": [
"!**/*.test-d.ts"
],
"timeout": "60s",
"typescript": {
"rewritePaths": {
"src/": "build/lab/src/"
}
}
},
"nyc": {
"extends": "@istanbuljs/nyc-config-typescript",
"exclude": [
"build/cjs/**",
"build/esm/**",
"build/umd/**",
"dist/**",
"eg/**",
"test/**",
"**/*.test.*",
"**/*.spec.*"
],
"reporter": [
"html",
"text"
],
"lines": "100",
"branches": "96",
"statements": "100"
},
"tsd": {
"directory": "test"
}
}