@flex-development/mlly 1.0.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,149 @@
+## 1.0.0-alpha.1 (2022-11-06)
+
+
+### :package: Build
+
+* cleanup build target settings ([b809be9](https://github.com/flex-development/mlly/commit/b809be9934c6661c98bdcfd3a568e7d34c0fe445))
+* remove `src` files from distribution ([0603ebe](https://github.com/flex-development/mlly/commit/0603ebefae0002c13f7d255ff2cc20cdf4057c7e))
+* require node `>=14.16` ([cd0dda9](https://github.com/flex-development/mlly/commit/cd0dda9dfae0bd205875f34d8fd8f2022e36d303))
+* **deps-dev:** bump @flex-development/mkbuild from 1.0.0-alpha.6 to 1.0.0-alpha.8 ([567bea8](https://github.com/flex-development/mlly/commit/567bea892e46be9cc04885e97a0d76235e68bd0c))
+* **deps-dev:** bump deps according to `yarn upgrade-interactive` ([e3649d4](https://github.com/flex-development/mlly/commit/e3649d4d98a59562a0ee27800eb33d1f6cc73c03))
+* **deps-dev:** bump deps according to `yarn upgrade-interactive` ([cdfc9af](https://github.com/flex-development/mlly/commit/cdfc9af3bbce508aceb0fa80d41b9de567383a14))
+* **deps-dev:** bump deps according to `yarn upgrade-interactive` ([24ee68b](https://github.com/flex-development/mlly/commit/24ee68b94523fca0ea9498068efc1765eb8f0a97))
+* **deps:** replace `pathe` with `upath` ([f705671](https://github.com/flex-development/mlly/commit/f705671f193a7c3a0d24e49e7769683b5876aeae))
+* **docs:** [site] use flex-development/docast@48367224ce9b9aa804d872071fc7e6fc6a2f38b3 ([06324f7](https://github.com/flex-development/mlly/commit/06324f723d88320e0de86563b2b78e7d3d02618c))
+* **docs:** [site] use flex-development/docast@dd4b6c3b2d4e770df99f3a2b90032f228dcd76a8 ([3de807d](https://github.com/flex-development/mlly/commit/3de807d36c5b06760c9cd8d72b98ca4b0a7233ff))
+* **pkg:** remove extraneous `bin` field ([b56c209](https://github.com/flex-development/mlly/commit/b56c2098cf328b89f8e6c34862ebc63668f9e348))
+* **syntax:** export `detectSyntax` ([4f3850f](https://github.com/flex-development/mlly/commit/4f3850f60fe9c4981337452d377f29cb6bcceb6d))
+* **syntax:** export `hasESMSyntax` ([64a89b2](https://github.com/flex-development/mlly/commit/64a89b235e8ae23c0e63fa013c110a3ca173785a))
+* **ts:** reorganize `typesVersions` ([53430fe](https://github.com/flex-development/mlly/commit/53430fe8d4e99a0792e4b64a136d8ba779d51e21))
+
+
+### :robot: Continuous Integration
+
+* add [@dependabot](https://github.com/dependabot) config ([ca31ac5](https://github.com/flex-development/mlly/commit/ca31ac58e4fcedb5feb2a86a134503ef2819fe00))
+* **deps:** bump actions/checkout from 3.0.2 to 3.1.0 ([#1](https://github.com/flex-development/mlly/issues/1)) ([a7fdf9e](https://github.com/flex-development/mlly/commit/a7fdf9e9a3d84f37e7f436a544e98692f8988cac))
+* **deps:** bump actions/github-script from 6.3.1 to 6.3.2 ([#3](https://github.com/flex-development/mlly/issues/3)) ([ef9e10d](https://github.com/flex-development/mlly/commit/ef9e10d9a08699961fee8acd664fadf8f1b95729))
+* **deps:** bump actions/github-script from 6.3.2 to 6.3.3 ([#5](https://github.com/flex-development/mlly/issues/5)) ([68306db](https://github.com/flex-development/mlly/commit/68306db8078fdcaa0a0a6ef80195335c5d7b825d))
+* **deps:** bump actions/setup-node from 3.5.0 to 3.5.1 ([#6](https://github.com/flex-development/mlly/issues/6)) ([c303f3e](https://github.com/flex-development/mlly/commit/c303f3e592508eb73e1e7f26a64cf1d3cd5f4808))
+* **deps:** Bump crazy-max/ghaction-import-gpg from 5.1.0 to 5.2.0 ([#7](https://github.com/flex-development/mlly/issues/7)) ([e87d930](https://github.com/flex-development/mlly/commit/e87d9302e3cec93872c4ccf119aba75446839291))
+* **deps:** Bump dependabot/fetch-metadata from 1.3.4 to 1.3.5 ([#8](https://github.com/flex-development/mlly/issues/8)) ([9d64f86](https://github.com/flex-development/mlly/commit/9d64f8640e10c7795bda75b183a47ffcbc2c6586))
+* **deps:** bump hmarr/debug-action from 2.0.1 to 2.1.0 ([#2](https://github.com/flex-development/mlly/issues/2)) ([3b25af3](https://github.com/flex-development/mlly/commit/3b25af3b01d82dbf195fe5d16686063cfb6533a5))
+* **deps:** bump octokit/graphql-action from 2.2.22 to 2.2.23 ([#4](https://github.com/flex-development/mlly/issues/4)) ([93e8994](https://github.com/flex-development/mlly/commit/93e89941b7bd6c5a4539cd1770d400a216c55525))
+* **workflows:** `preview` ([2936463](https://github.com/flex-development/mlly/commit/2936463896eec04a5f5025c981d74361f0ee13df))
+* **workflows:** deploy docs to production on github release ([876e5b0](https://github.com/flex-development/mlly/commit/876e5b09fe5b8f076133d1bbd78bf02eed206036))
+* **workflows:** ensure docs preview is deployed with all `src` updates ([74bdb73](https://github.com/flex-development/mlly/commit/74bdb73a81ebf38fa606f63245140c2c437d20e3))
+
+
+### :pencil: Documentation
+
+* [`hasESMSyntax`] fix typo in `@return` description ([c9f6a85](https://github.com/flex-development/mlly/commit/c9f6a8571034c82a2ac801db62632f7fc7033efc))
+* [site] add `/api/interfaces` ([95eebeb](https://github.com/flex-development/mlly/commit/95eebeb47adc9cbf8e0dc576dbb3211fd241d432))
+* [site] add `/api/types` ([cf7f5be](https://github.com/flex-development/mlly/commit/cf7f5be2af20ee33cb6b93a2809eeaf667334d15))
+* [site] add `robots.txt` generation to postbuild tasks ([ef98b86](https://github.com/flex-development/mlly/commit/ef98b86bc3e76cf52781495a52bd7b725bdf5db2))
+* [site] add esm only warning to install guide ([19dbe66](https://github.com/flex-development/mlly/commit/19dbe662ef869d26d7ac0f5412445dd392116895))
+* [site] add google site verification ([8cd42d6](https://github.com/flex-development/mlly/commit/8cd42d6fe457cc342ca22d7130cf5572d81b6e48))
+* [site] add initial front-end checklist ([1403dc3](https://github.com/flex-development/mlly/commit/1403dc357ac8db9ee9f3308b93f7d558d48be170))
+* [site] algolia search integration ([1af849d](https://github.com/flex-development/mlly/commit/1af849d7be31c618ab6742c4a9ee2cd22038999c))
+* [site] configure google analytics ([3c244ec](https://github.com/flex-development/mlly/commit/3c244ec3294b2ff6bcd6afdaf6b3238155ee25a2))
+* [site] fix canonical url ([aea7a10](https://github.com/flex-development/mlly/commit/aea7a105d3fa928c52fc5c8a67fc20acb0c6b266))
+* [site] fix duplicate meta description ([188d914](https://github.com/flex-development/mlly/commit/188d914bbdd99683a2eeaccb2c4e0080ecba5af3))
+* [site] init `/api/` ([a5084d3](https://github.com/flex-development/mlly/commit/a5084d3b1b25b6e33b570e302b91aba41c012075))
+* [site] move search indexing to `buildEnd` hook ([4b71095](https://github.com/flex-development/mlly/commit/4b71095d3e8895dcfc9c8355e9c2286da2c5c6d5))
+* [site] prevent tab nabbing ([1929374](https://github.com/flex-development/mlly/commit/1929374cf03a52d03216d39a43e1fd94d2f75431))
+* [site] specify text directionality ([1807a41](https://github.com/flex-development/mlly/commit/1807a41f31fa1a337be2722dda5771269e121522))
+* [site] update front-end checklist ([70fd41d](https://github.com/flex-development/mlly/commit/70fd41d216b6f5d2ceb8f913ea6b87f744c15877))
+* [site]: add `/api/constants` ([ed2bb9f](https://github.com/flex-development/mlly/commit/ed2bb9f8d54525a0da49dff9c879a9831cccef2d))
+* [site]: resolve `@link` ([6ed82f8](https://github.com/flex-development/mlly/commit/6ed82f84e248a2ea21f73559fa40dba25bd88db5))
+* [site]: update `/api/` title and intro ([3e60e88](https://github.com/flex-development/mlly/commit/3e60e884b5e7f551be3621ccbb2c4dabed783f73))
+* [site]: update `/api/constants` intro ([2d1d525](https://github.com/flex-development/mlly/commit/2d1d52590e7098006f4df4c58e8d75af2ebb471a))
+* init docs site ([df39382](https://github.com/flex-development/mlly/commit/df39382d9472d3eb97eb0eca37fd147634a65ff3))
+* merge zsh docs into contributing guide ([f2e2a6c](https://github.com/flex-development/mlly/commit/f2e2a6c64d3cd8cf3376c912236deec7cfab4f37))
+* reorganize gpr install guide ([0a8ef6e](https://github.com/flex-development/mlly/commit/0a8ef6ec08490807c3727398ae402d57c4b32f3d))
+* temporarily remove `detectSyntax` example ([afc41e9](https://github.com/flex-development/mlly/commit/afc41e9d16c6f869d26db44bbac7579b24f6123c))
+* update descriptions and reference links ([8bd5702](https://github.com/flex-development/mlly/commit/8bd570288ef8ed66fce4bd24bf3bc84b9e113dd2))
+
+
+### :sparkles: Features
+
+* **analyze:** `extractStatements` ([08b9124](https://github.com/flex-development/mlly/commit/08b9124a76e5c4aa182221d87dea903b3876efd4))
+* **analyze:** `findDynamicImports` ([a03089a](https://github.com/flex-development/mlly/commit/a03089a6ab374adaa1c0908bf304677f11e8b8e2))
+* **analyze:** `findExports` ([7a66d78](https://github.com/flex-development/mlly/commit/7a66d781caa6d5f522d4a51e345eafb16b48974e))
+* **analyze:** `findRequires` ([1d58008](https://github.com/flex-development/mlly/commit/1d58008174cc0622c2b1a54ce0dbd8741553cacc))
+* **analyze:** `findStaticImports` ([673294c](https://github.com/flex-development/mlly/commit/673294cae8156f26538f7f1db51efcab74678fcc))
+* **interfaces:** `CompilerOptionsJson` ([39c1abf](https://github.com/flex-development/mlly/commit/39c1abf9856886566277f771eddf27d3cb6aabd6))
+* **interfaces:** `DynamicImport` ([b7474a1](https://github.com/flex-development/mlly/commit/b7474a18e482bd74f9c1337c78adc3299d2b0be5))
+* **interfaces:** `ExportStatement` ([4384be4](https://github.com/flex-development/mlly/commit/4384be4525b22858e4cbcc782e5a57352583fd60))
+* **interfaces:** `ImportStatement` ([6a16d74](https://github.com/flex-development/mlly/commit/6a16d74c491ee2f0453b31a3ea4bf15b9ab62289))
+* **interfaces:** `RequireStatement` ([0dc6d7a](https://github.com/flex-development/mlly/commit/0dc6d7a8cb6a4c00f20621a3232cd0b37476025b))
+* **interfaces:** `Statement` ([ec25911](https://github.com/flex-development/mlly/commit/ec25911670d0d204d196eb0039a95948ef7174c1))
+* **interfaces:** `StaticImport` ([78816b7](https://github.com/flex-development/mlly/commit/78816b748cde2eec6bbfc821370be46008e46a21))
+* **lib:** `getCompilerOptions` ([08c4b84](https://github.com/flex-development/mlly/commit/08c4b8492f7640f74dc676c073a7075115846698))
+* **lib:** `isBuiltin` ([b0a618b](https://github.com/flex-development/mlly/commit/b0a618bf910b5a135a0f44df06dffcc0b6747774))
+* **lib:** `toDataURL` ([57647dd](https://github.com/flex-development/mlly/commit/57647dd958bc29ff578c1661c3977021034ea5aa))
+* **resolve:** [`resolveModule`] `@types` detection ([bcd1de7](https://github.com/flex-development/mlly/commit/bcd1de782395a784e0536f7184072acdaef7f33e))
+* **resolve:** `resolveAlias` ([4014515](https://github.com/flex-development/mlly/commit/4014515682448d909fff777d41ed114f2a5ae072))
+* **resolve:** `resolveAliases` ([25895cf](https://github.com/flex-development/mlly/commit/25895cf8455d932973593193db50fa28ea882d29))
+* **resolve:** `resolveModule` ([90ae6b5](https://github.com/flex-development/mlly/commit/90ae6b55f197d161023119f82d394abb1d2dd5d3))
+* **resolve:** `resolveModules` ([e7394ad](https://github.com/flex-development/mlly/commit/e7394ad44ce4965ff2d14ee4a7a7d61a23a7be1e))
+* **specifiers:** [`toBareSpecifier`] `@types` detection + `types` entry point support ([6991fae](https://github.com/flex-development/mlly/commit/6991fae7631aa0f2ceb0c3c120349b7d5de55e0e))
+* **specifiers:** `toAbsoluteSpecifier` ([83578ac](https://github.com/flex-development/mlly/commit/83578ac87e2600ad1cb7751a260667a13aac77f4))
+* **specifiers:** `toBareSpecifier` ([1407d5e](https://github.com/flex-development/mlly/commit/1407d5e059442fec95bd017aa4f8853856cd3166))
+* **specifiers:** `toRelativeSpecifier` ([26b7096](https://github.com/flex-development/mlly/commit/26b70967a8d2c06b2449b79002d2ebf7a7bbb990))
+* **syntax:** `detectSyntax` ([184950f](https://github.com/flex-development/mlly/commit/184950faba5ee78597b69a2e4b1219338ff56bc7))
+* **syntax:** `hasCJSSyntax` ([7d64e65](https://github.com/flex-development/mlly/commit/7d64e657002e4fd6ace32775bb2c274574765781))
+* **syntax:** `hasESMSyntax` ([6888620](https://github.com/flex-development/mlly/commit/688862056a14d0ddd633d74cc9708b07b6fc2922))
+* **syntax:** detect dynamic imports in commonjs ([05b4d8f](https://github.com/flex-development/mlly/commit/05b4d8f69302d7d6c991bc4dd12a874b0947ca34))
+* **types:** `Declaration` ([1427995](https://github.com/flex-development/mlly/commit/1427995fd8999090fd76ae59adb6ecbadf19e263))
+* **types:** `Ext` ([2ccd483](https://github.com/flex-development/mlly/commit/2ccd4832690367959ba207df0378409a1d4ee2ab))
+* **types:** `MIMEType` ([8ff6a94](https://github.com/flex-development/mlly/commit/8ff6a944207b32f45eddda8a7fd6ac38bf47f634))
+* **types:** `SpecifierType` ([6feccb1](https://github.com/flex-development/mlly/commit/6feccb15fca8affeb51efd6ce78f4ae267056910))
+* **types:** `StatementType` ([b0feb6c](https://github.com/flex-development/mlly/commit/b0feb6cbf79b5a2d5364b728a2f2a45b8c6f5a50))
+
+
+### :bug: Fixes
+
+* **docs:** [site] sitemap urls ([95cfad6](https://github.com/flex-development/mlly/commit/95cfad6e10d047d8d9d3bf8ffa0620f50c47472d))
+* **internal:** `STATIC_IMPORT_REGEX` matches `:` in ternary statements ([d2027f8](https://github.com/flex-development/mlly/commit/d2027f83515065a28992d6d91ee3e22b2062c1d1))
+* **internal:** `STATIC_IMPORT_REGEX` matches `import` in module specifiers ([a58ec20](https://github.com/flex-development/mlly/commit/a58ec2055750747743bc537f32f33ad7676fdcf4))
+* **resolve:** [`resolveModules`] ignore dynamic import statements with dynamic specifiers ([48c20bd](https://github.com/flex-development/mlly/commit/48c20bd4915c16914c80e198a420485b9c8a0582))
+* **tests:** [`findDynamicImports`] dynamic specifier test ([ee1b01b](https://github.com/flex-development/mlly/commit/ee1b01b6c727b54fecf64b0142ef6409fe30c941))
+
+
+### :house_with_garden: Housekeeping
+
+* add empty changelog ([7dfb431](https://github.com/flex-development/mlly/commit/7dfb431e5f7ced07d6a9a5028347016f2dd5b4c9))
+* disable eslint rule `unicorn/no-unsafe-regex` ([8d24eda](https://github.com/flex-development/mlly/commit/8d24edada5a7c6edfee6d316239cd29dc076531c)), closes [sindresorhus/eslint-plugin-unicorn#153](https://github.com/sindresorhus/eslint-plugin-unicorn/issues/153)
+* improve vercel integration ([1db75bc](https://github.com/flex-development/mlly/commit/1db75bc420b42652c440ec0a09742dc319c857f5))
+* update editorconfig properties ([60256a8](https://github.com/flex-development/mlly/commit/60256a822ddc721781fe6d6579459fcc9e51a2ec))
+* **docs:** scrap `vc dev` usage ([5ce8c0f](https://github.com/flex-development/mlly/commit/5ce8c0f0468b2def494922f8f3b58ebb60a5a19c)), closes [vercel/vercel#8121](https://github.com/vercel/vercel/issues/8121)
+* **github:** add commit scope `analyze` ([f3aaee9](https://github.com/flex-development/mlly/commit/f3aaee92ddbac08744d671cb7b905dbb36dba0f6))
+* **github:** add commit scope `docs` ([6111249](https://github.com/flex-development/mlly/commit/61112490c88de111f1906a4725d98abaa5c7247a))
+* **github:** add commit scope `interfaces` ([15fc6d9](https://github.com/flex-development/mlly/commit/15fc6d97ff06304710b55bf67768cb14e4ba4295))
+* **github:** add commit scope `internal` ([63c3470](https://github.com/flex-development/mlly/commit/63c34707f54d5c5dbeea0ef06d3eea3bd927d888))
+* **github:** add commit scope `specifiers` ([a7b3eb3](https://github.com/flex-development/mlly/commit/a7b3eb32b6cced07607af5be3f7c5c1240bcf3c2))
+* **github:** add commit scope `types` ([da9f588](https://github.com/flex-development/mlly/commit/da9f588beac0d8e00daa60e40739306e424a3fa7))
+* **github:** add label `scope:docs` ([6a98495](https://github.com/flex-development/mlly/commit/6a98495c6f1feabe786509c4bfc5aa6cb63573cb))
+* **github:** add label `scope:internal` ([daca7af](https://github.com/flex-development/mlly/commit/daca7afda87a3f1dd2d292ed5e06cde42b3d5929))
+* **ts:** enforce `import type` for type-only imports ([acd84b8](https://github.com/flex-development/mlly/commit/acd84b8c004fce22da9b2ea16b5281089fb5b15d))
+
+
+### :fire: Performance Improvements
+
+* **docs:** [site] improve speed of first search query ([0ad65db](https://github.com/flex-development/mlly/commit/0ad65db1a6f731f7452d40375359f7584266a5d1))
+* **docs:** [site] use exact urls to increase speed ([55c1267](https://github.com/flex-development/mlly/commit/55c1267864fe9540c38cd8e5bc970a855cd497bf))
+
+
+### :zap: Refactors
+
+* **docs:** [site] comments compilation ([f66861c](https://github.com/flex-development/mlly/commit/f66861c9dca4e2f17403d8bc5684c2f120d4ebaa))
+* **interfaces:** `AliasResolverOptions` -> `ResolveAliasOptions` ([602d11a](https://github.com/flex-development/mlly/commit/602d11a71c6ee288e7f73454a49cfdaaa5e71cc5))
+* **internal:** add internals ([7a486c7](https://github.com/flex-development/mlly/commit/7a486c7ed3c84f39b0b4b7143f92729ce7912d81))
+* **lib:** move `getCompilerOptions` to `internal` ([7c5656d](https://github.com/flex-development/mlly/commit/7c5656d70bd67c18a9c126abb6e84ff838552ad8))
+* **lib:** replace `isBuiltin` with `@flex-development/is-builtin` ([c868cec](https://github.com/flex-development/mlly/commit/c868cec9b5fce91014b1666b3f9aceef60acf079))
+* **resolve:** [`resolveAliases`] signature ([190fb52](https://github.com/flex-development/mlly/commit/190fb5260adb4559beaf0f3666c68b1cc1a16094))
+* **resolve:** [options] allow readonly arrays ([6df4a4b](https://github.com/flex-development/mlly/commit/6df4a4bb3836adef0b6f15884575edb6ce78c2a0))
+* **resolve:** [options] pass original module specifier to `ext` ([4615851](https://github.com/flex-development/mlly/commit/46158510fdd0e3d8e0e60757290a655606ad836e))
+* **resolve:** sort `RESOLVE_EXTENSIONS` according to priority ([0266ca9](https://github.com/flex-development/mlly/commit/0266ca9a5593d0c66e950ba1fe2c8f6df8422ff9))
+* **specifiers:** [`toBareSpecifier`] improve `exports` path search ([36c4b74](https://github.com/flex-development/mlly/commit/36c4b7475c9bb6c924f5e75c8d6d215a8d23e79c))
+

package/LICENSE.md

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2022, Flex Development, LLC All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,17 @@
+# mlly
+
+[![conventional commits](https://img.shields.io/badge/conventional%20commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
+[![module type: esm](https://img.shields.io/badge/module%20type-esm-brightgreen)](https://github.com/voxpelli/badges-cjs-esm)
+[![npm](https://img.shields.io/npm/v/@flex-development/mlly.svg)](https://npmjs.com/package/@flex-development/mlly)
+[![license](https://img.shields.io/github/license/flex-development/mlly.svg)](LICENSE.md)
+[![typescript](https://badgen.net/badge/-/typescript?color=2a72bc&icon=typescript&label)](https://typescriptlang.org)
+
+> [ECMAScript module][1] utilities.
+
+## Getting Started
+
+See the [docs][2] for install and usage instructions.
+
+[1]: https://nodejs.org/api/esm.html
+[2]: https://mlly.vercel.app/

package/changelog.config.cts

@@ -0,0 +1,204 @@
+/**
+ * @file Changelog Configuration
+ * @module config/changelog
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli
+ */
+
+import type { Config } from 'conventional-changelog-cli'
+import type { Options } from 'conventional-changelog-core'
+import type {
+  CommitGroup,
+  GeneratedContext
+} from 'conventional-changelog-writer'
+import type { Commit, CommitRaw } from 'conventional-commits-parser'
+import dateformat from 'dateformat'
+import fs from 'node:fs'
+import pkg from './package.json'
+
+/**
+ * Changlog context.
+ *
+ * @extends {GeneratedContext}
+ */
+interface Context extends GeneratedContext {
+  currentTag: string
+  linkCompare: boolean
+  previousTag: string
+}
+
+/**
+ * Changelog configuration options.
+ *
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-conventionalcommits
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-core
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-commits-parser
+ * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/git-raw-commits
+ *
+ * @const {Config} config
+ */
+const config: Config = {
+  options: {
+    preset: {
+      header: '',
+      name: 'conventionalcommits',
+      releaseCommitMessageFormat: 'release: {{currentTag}}',
+      types: [
+        { section: ':package: Build', type: 'build' },
+        { section: ':house_with_garden: Housekeeping', type: 'chore' },
+        { section: ':robot: Continuous Integration', type: 'ci' },
+        { section: ':pencil: Documentation', type: 'docs' },
+        { section: ':sparkles: Features', type: 'feat' },
+        { section: ':bug: Fixes', type: 'fix' },
+        { section: ':fire: Performance Improvements', type: 'perf' },
+        { section: ':zap: Refactors', type: 'refactor' },
+        { section: ':rewind: Reverts', type: 'revert' },
+        { hidden: true, type: 'style' },
+        { section: ':white_check_mark: Testing', type: 'test' },
+        { hidden: true, type: 'wip' }
+      ]
+    },
+    skipUnstable: false,
+    tagPrefix: pkg.tagPrefix,
+    /**
+     * Raw commit transformer.
+     *
+     * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-core#transform-1
+     *
+     * @param {CommitRaw} commit - Raw commit object
+     * @param {Options.Transform.Callback} apply - Commit handler
+     * @return {void} Nothing when complete
+     */
+    transform(commit: CommitRaw, apply: Options.Transform.Callback): void {
+      commit.committerDate = dateformat(commit.committerDate, 'yyyy-mm-dd')
+
+      if (commit.gitTags) {
+        /**
+         * Regex expression used to check {@link commit.gitTags} for the release
+         * {@link commit} belongs to.
+         *
+         * @const {RegExp} vgx
+         */
+        const vgx: RegExp = pkg.tagPrefix
+          ? new RegExp(`tag:\\s*[=]?${pkg.tagPrefix}(.+?)[,)]`, 'gi')
+          : /tag:\s*[=v]?(.+?)[),]/gi
+
+        commit = Object.assign({}, commit, {
+          version: vgx.exec(commit.gitTags)?.[1] ?? undefined
+        })
+      }
+
+      commit.notes = commit.notes.map(note => ({
+        ...note,
+        text: note.text.replace(/(\n?\n?Signed-off-by:).+/gm, '')
+      }))
+
+      return void apply(null, {
+        ...commit,
+        raw: commit,
+        shortHash: commit.hash.slice(0, 7)
+      })
+    }
+  },
+  parserOpts: {
+    issuePrefixesCaseSensitive: true
+  },
+  writerOpts: {
+    /**
+     * Sorts commit groups in descending order by group title.
+     *
+     * GitHub emojis in titles will be ignored.
+     *
+     * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer#commitgroupssort
+     *
+     * @param {CommitGroup} a - Commit group object
+     * @param {CommitGroup} b - Commit group object to compare to `a`
+     * @return {number} Compare result
+     */
+    commitGroupsSort(a: CommitGroup, b: CommitGroup): number {
+      if (a.title === false) return 1
+      if (b.title === false) return -1
+
+      /**
+       * Regex used to extract commit group titles without GitHub emojis.
+       *
+       * @const {RegExp} tgx - Regex used to extract commit group title
+       */
+      const tgx: RegExp = /([A-Z])\w+/
+
+      return tgx.exec(a.title)![0]!.localeCompare(tgx.exec(b.title)![0]!)
+    },
+    /**
+     * Sorts commits in descending order by commit header and date.
+     *
+     * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer#commitssort
+     *
+     * @param {Commit} a - Commit object
+     * @param {Commit} b - Commit object to compare to `b`
+     * @return {number} Compare result
+     */
+    commitsSort(a: Commit, b: Commit): number {
+      /**
+       * Compare result for {@link b.committerDate} & {@link a.committerDate}.
+       *
+       * @const {number} by_date
+       */
+      const by_date: number =
+        new Date(b.committerDate).getTime() -
+        new Date(a.committerDate).getTime()
+
+      return a.header && b.header
+        ? a.header.localeCompare(b.header) || by_date
+        : by_date
+    },
+    /**
+     * Modifies `context` before the changelog is generated.
+     *
+     * This includes:
+     *
+     * - Setting the release date to the current date
+     * - Setting the current release tag
+     * - Setting the previous release tag
+     * - Setting compare link generation
+     *
+     * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-core#finalizecontext
+     * @see https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer#finalizecontext
+     *
+     * @param {GeneratedContext} context - Generated changelog context
+     * @return {Context} Final changelog context
+     */
+    finalizeContext(context: GeneratedContext): Context {
+      /**
+       * Use current date as release date instead of date of most recent commit.
+       *
+       * @see https://github.com/conventional-changelog/conventional-changelog/blob/master/packages/conventional-changelog-writer/lib/util.js#L194-L196
+       */
+      context.date = dateformat(new Date(), 'yyyy-mm-dd')
+
+      /**
+       * Release tag for upcoming version.
+       *
+       * @const {string} currentTag
+       */
+      const currentTag: string = pkg.tagPrefix + pkg.version
+
+      /**
+       * Release tag for previous version.
+       *
+       * @const {string} previousTag
+       */
+      const previousTag: string = context.gitSemverTags[0]!
+
+      return {
+        ...context,
+        currentTag,
+        linkCompare: currentTag !== previousTag,
+        previousTag
+      }
+    },
+    headerPartial: fs.readFileSync('templates/changelog/header.hbs', 'utf8'),
+    ignoreReverted: false
+  }
+}
+
+module.exports = config

package/dist/constants.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @file Constants
+ * @module mlly/constants
+ */
+import type { Ext } from './types/index.mjs';
+/**
+ * Default export conditions.
+ *
+ * @see https://nodejs.org/api/packages.html#conditional-exports
+ *
+ * @const {Readonly<Set<string>>} CONDITIONS
+ */
+export declare const CONDITIONS: Readonly<Set<string>>;
+/**
+ * Default resolvable file extensions.
+ *
+ * @const {ReadonlyArray<Ext>} RESOLVE_EXTENSIONS
+ */
+export declare const RESOLVE_EXTENSIONS: readonly Ext[];

package/dist/constants.mjs

@@ -0,0 +1,24 @@
+const CONDITIONS = Object.freeze(
+  /* @__PURE__ */ new Set(["node", "import"])
+);
+const RESOLVE_EXTENSIONS = Object.freeze([
+  ".mjs",
+  ".mts",
+  ".cjs",
+  ".cts",
+  ".js",
+  ".ts",
+  ".jsx",
+  ".tsx",
+  ".css",
+  ".json",
+  ".node",
+  ".wasm",
+  ".d.mts",
+  ".d.cts",
+  ".d.ts"
+]);
+export {
+  CONDITIONS,
+  RESOLVE_EXTENSIONS
+};

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @file Package Entry Point
+ * @module mlly
+ */
+export * from './constants.mjs';
+export * from './interfaces/index.mjs';
+export * from './lib/index.mjs';
+export * from './types/index.mjs';

package/dist/index.mjs

@@ -0,0 +1,4 @@
+export * from "./constants.mjs";
+export * from "./interfaces/index.mjs";
+export * from "./lib/index.mjs";
+export * from "./types/index.mjs";

package/dist/interfaces/import-dynamic.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file Interfaces - DynamicImport
+ * @module mlly/interfaces/DynamicImport
+ */
+import type ImportStatement from './statement-import.mjs';
+/**
+ * Dynamic import statement object schema.
+ *
+ * @see {@link ImportStatement}
+ *
+ * @extends {ImportStatement}
+ */
+interface DynamicImport extends ImportStatement {
+    /**
+     * Module specifier type.
+     */
+    specifier_type: 'dynamic' | 'static';
+    /**
+     * Import statement type.
+     */
+    type: 'dynamic';
+}
+export type { DynamicImport as default };

package/dist/interfaces/import-static.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @file Interfaces - StaticImport
+ * @module mlly/interfaces/StaticImport
+ */
+import type ImportStatement from './statement-import.mjs';
+/**
+ * Static import statement object schema.
+ *
+ * @see {@link ImportStatement}
+ *
+ * @extends {ImportStatement}
+ */
+interface StaticImport extends ImportStatement {
+    /**
+     * Import statement type.
+     */
+    type: 'default' | 'named' | 'star';
+}
+export type { StaticImport as default };

package/dist/interfaces/index.d.mts

@@ -0,0 +1,12 @@
+/**
+ * @file Interfaces
+ * @module mlly/interfaces
+ */
+export type { default as DynamicImport } from './import-dynamic.mjs';
+export type { default as StaticImport } from './import-static.mjs';
+export type { default as ResolveOptions } from './options-resolve.mjs';
+export type { default as ResolveAliasOptions } from './options-resolve-alias.mjs';
+export type { default as Statement } from './statement.mjs';
+export type { default as ExportStatement } from './statement-export.mjs';
+export type { default as ImportStatement } from './statement-import.mjs';
+export type { default as RequireStatement } from './statement-require.mjs';

package/dist/interfaces/options-resolve-alias.d.mts

@@ -0,0 +1,69 @@
+/**
+ * @file Interfaces - ResolveAliasOptions
+ * @module mlly/interfaces/ResolveAliasOptions
+ */
+import type { OneOrMany } from '@flex-development/tutils';
+/**
+ * Path alias resolution options.
+ *
+ * @see https://github.com/dividab/tsconfig-paths
+ */
+interface ResolveAliasOptions {
+    /**
+     * Base directory to resolve non-absolute module names.
+     *
+     * @see https://www.typescriptlang.org/tsconfig#baseUrl
+     *
+     * @default process.cwd()
+     */
+    baseUrl?: string;
+    /**
+     * Module extensions to probe for.
+     *
+     * **Note**: Should be sorted by priority.
+     *
+     * @default RESOLVE_EXTENSIONS
+     */
+    extensions?: string[] | readonly string[];
+    /**
+     * Checks for the existence of a file at `path`.
+     *
+     * @param {string} path - Path to check
+     * @return {boolean} `true` if file exists, `false` otherwise
+     */
+    fileExists?(this: void, path: string): boolean;
+    /**
+     * `package.json` fields to check when resolving modules.
+     *
+     * A nested field can be selected by passing an array of field names.
+     *
+     * @default ['main', 'module']
+     */
+    mainFields?: OneOrMany<string>[];
+    /**
+     * Absolute path to file containing path alias.
+     */
+    parent?: string;
+    /**
+     * Path mappings.
+     *
+     * **Note**: Should be relative to {@link baseUrl}.
+     *
+     * @see https://www.typescriptlang.org/tsconfig#paths
+     *
+     * @default {}
+     */
+    paths?: Record<string, string[]>;
+    /**
+     * Synchronously returns the contents of `filename`.
+     *
+     * @param {string} filename - Filename
+     * @return {string} Contents of `filename`
+     */
+    readFile?(this: void, filename: string): string;
+    /**
+     * Absolute path to tsconfig file.
+     */
+    tsconfig?: string;
+}
+export type { ResolveAliasOptions as default };