@flex-development/mlly 1.0.0-alpha.2 → 1.0.0-alpha.4

package/CHANGELOG.md

@@ -1,3 +1,92 @@
+## [1.0.0-alpha.4](https://github.com/flex-development/mlly/compare/1.0.0-alpha.3...1.0.0-alpha.4) (2022-12-26)
+
+
+### :robot: Continuous Integration
+
+* **workflows:** [`publish`] fix registry url ([c06d3ca](https://github.com/flex-development/mlly/commit/c06d3ca72de415e507d901864afc410c9f5239b3))
+
+
+### :pencil: Documentation
+
+* fix changelog entries ([128f8f4](https://github.com/flex-development/mlly/commit/128f8f450eda1fc10ff89ac272fbe8bde870c516))
+
+## [1.0.0-alpha.3](https://github.com/flex-development/mlly/compare/1.0.0-alpha.2...1.0.0-alpha.3) (2022-12-26)
+
+
+### ⚠ BREAKING CHANGES
+
+* **types:** remove `Ext`
+* **types:** `SpecifierType` -> `ModuleSpecifierType`
+* statements
+
+### :package: Build
+
+* **deps-dev:** add @flex-development/docast ([42b8ed2](https://github.com/flex-development/mlly/commit/42b8ed2360e8b4478202ba7db7e2b5cacae9ec90))
+* **deps-dev:** bump @flex-development/docast-parse to 1.0.0-alpha.4 ([9634f8d](https://github.com/flex-development/mlly/commit/9634f8d4ec4375e7d29ad709c36ce1d398293718))
+* **deps-dev:** bump @flex-development/mkbuild from 1.0.0-alpha.8 to 1.0.0-alpha.9 ([0262207](https://github.com/flex-development/mlly/commit/026220768f780149e143c0a5e6d35f9c2a4f0215))
+* **deps-dev:** bump deps according to `yarn upgrade-interactive` ([ab0b8ce](https://github.com/flex-development/mlly/commit/ab0b8ced1e664a9bb6a9f4a7189d870bdf76c8c0))
+* **deps-dev:** bump deps according to `yarn upgrade-interactive` ([bddfa7c](https://github.com/flex-development/mlly/commit/bddfa7c3f8864ab38fe35dc295ab46e472df187e))
+* **deps:** add @flex-development/tsconfig-types ([a7c38e5](https://github.com/flex-development/mlly/commit/a7c38e50ea583dde948078569b41e0aebde8cfbf))
+* **deps:** replace upath with @flex-development/pathe ([8a584d6](https://github.com/flex-development/mlly/commit/8a584d6dc2fed8c4cae491c290cf58ded9ca038e))
+* **docs:** [site] use flex-development/docast-parse@27c73c7c03df4d92585c538c1f8214886b1fd0a9 ([b696cf6](https://github.com/flex-development/mlly/commit/b696cf676ecb0ace14647727415a49d03092d0d5))
+
+
+### :robot: Continuous Integration
+
+* configure private package registry for [@dependabot](https://github.com/dependabot) ([e188761](https://github.com/flex-development/mlly/commit/e1887618c8a2c5fe9cb69babd15498b618e64e66))
+* fix [@dependabot](https://github.com/dependabot) npm package-ecosystem x yarn integration ([126dfab](https://github.com/flex-development/mlly/commit/126dfab8d937f3526ea109acc91565accf3b2653))
+* **deps:** bump actions/add-to-project from 0.3.0 to 0.4.0 ([b5e8279](https://github.com/flex-development/mlly/commit/b5e8279269f75cee5076d86b7c34578b74f306df))
+* **deps:** bump actions/checkout from 3.1.0 to 3.2.0 ([0637831](https://github.com/flex-development/mlly/commit/063783140fb475f29f821408837389219c471625))
+* **deps:** bump dessant/lock-threads from 3.0.0 to 4.0.0 ([ba6063c](https://github.com/flex-development/mlly/commit/ba6063cb88556d106fb01c3948ba03d8f4848a47))
+* **deps:** bump flex-development/dist-tag-action from 1.1.1 to 1.1.2 ([e19b975](https://github.com/flex-development/mlly/commit/e19b97514d655b2c89e7fa4b09aa3ea93a0f8415))
+* **workflows:** [`add-to-project`] add items from repo admin account ([e271e8a](https://github.com/flex-development/mlly/commit/e271e8afe22244e3d270aa02a833ccb4b077f296))
+* **workflows:** [`ci`] add node.js matrix ([28a0fa6](https://github.com/flex-development/mlly/commit/28a0fa6d809c94af458c6d5c9b661bb9d564b70a))
+* **workflows:** [`ci`] archive production artifacts ([701caea](https://github.com/flex-development/mlly/commit/701caea0edc1e2d36d7a1323a88e1e714e88743d))
+* **workflows:** [`ci`] let [@dependabot](https://github.com/dependabot) modify lockfile ([74ec538](https://github.com/flex-development/mlly/commit/74ec5381fd5339d0d29b1a5529e48d8b86fc2419))
+* **workflows:** [`ci`] re-add node14 to matrix ([44801d8](https://github.com/flex-development/mlly/commit/44801d803774588c46299050ff858027605a2079))
+* **workflows:** [`ci`] update codecov environment ([32518bd](https://github.com/flex-development/mlly/commit/32518bdd2650e01bc92dd6e212ef9420f239ac9f))
+* **workflows:** [`ci`] update node setup ([b326f5d](https://github.com/flex-development/mlly/commit/b326f5d35c968fd4f1145a50a769e8d645190941))
+* **workflows:** [`ci`] upload coverage reports to codecov ([a24776b](https://github.com/flex-development/mlly/commit/a24776ba0c3aad87e36881f5558eba58f5f7a866))
+* **workflows:** [`publish`] cleanup registry scope ([ba5b355](https://github.com/flex-development/mlly/commit/ba5b355f30e62cb863abd35eddaa28b5b0885f56))
+* **workflows:** [`publish`] print contents of `.npmrc` file ([2c16ff6](https://github.com/flex-development/mlly/commit/2c16ff62786d8ecc1f403d364af4d6db372e5a75))
+* **workflows:** [`publish`] use node version file ([80d68c1](https://github.com/flex-development/mlly/commit/80d68c13aac5cdb0005c236d56bb8db90bd831a0))
+* **workflows:** [`release`] publish releases from repo admin account ([bbda19c](https://github.com/flex-development/mlly/commit/bbda19ca37155411a0a4e9bf4e734a7b7ad959c8))
+
+
+### :pencil: Documentation
+
+* add "contributor covenant code of conduct" ([8f1285b](https://github.com/flex-development/mlly/commit/8f1285b12b7c74401c962d614e2c79a6a0c89585))
+
+
+### :bug: Fixes
+
+* **install:** [git] make `postinstall` script work with git install ([1a70af2](https://github.com/flex-development/mlly/commit/1a70af2bed20cbb6667ca0dd3e8d2e7d6a38da4b))
+
+
+### :house_with_garden: Housekeeping
+
+* project qa ([4acf639](https://github.com/flex-development/mlly/commit/4acf639b6b28c20a782e39d6f4a8c4b2adb0ae20))
+* project qa ([3120990](https://github.com/flex-development/mlly/commit/312099035d0a90f044688e6619ec84dd6049d8bb))
+* **github:** add commit scope `install` ([065dbbb](https://github.com/flex-development/mlly/commit/065dbbbfd271e576d5031fcd155e91007cb95f62))
+* **github:** add label `scope:install` ([3ddc9c2](https://github.com/flex-development/mlly/commit/3ddc9c29e92e0e254f48f87ce7052196b79c9cc1))
+* **internal:** remove barrel file ([e0ba89c](https://github.com/flex-development/mlly/commit/e0ba89cceee97e99111dd4ab7c63601b593a24d5))
+* **pkg:** add keywords `ecmascript-modules` and `esmodules` ([e994f4b](https://github.com/flex-development/mlly/commit/e994f4bb182f0861f3c1c3c68c1a9d0a9a3d6631))
+* **tests:** local codecov integration ([bdbae1d](https://github.com/flex-development/mlly/commit/bdbae1d44cc60409a3dabb23acae79f8180b187a))
+* **yarn:** bump yarn from 4.0.0-rc.14 to 4.0.0-rc.34 ([045ee62](https://github.com/flex-development/mlly/commit/045ee6252342027657771d7bbdab6748fbb9a36a))
+
+
+### :zap: Refactors
+
+* statements ([731bd2a](https://github.com/flex-development/mlly/commit/731bd2a770671ad771ff38e8b12fce513034db27))
+* **ts:** enforce `exactOptionalPropertyTypes` ([f3109b4](https://github.com/flex-development/mlly/commit/f3109b4cb6b33528ac2655e9c90eb86a2512b00d))
+* **types:** `SpecifierType` -> `ModuleSpecifierType` ([263e98b](https://github.com/flex-development/mlly/commit/263e98b4e8189315157dfb4940df76e61a661922))
+* **types:** remove `Ext` ([303de20](https://github.com/flex-development/mlly/commit/303de200e3eddf4c6c33fd41db6f6f0ad84fe8ec))
+
+
+### :white_check_mark: Testing
+
+* **ts:** add remaining type tests ([7a5430f](https://github.com/flex-development/mlly/commit/7a5430f4d95392b9fa6637d09765dcdd79d275b4))
+
 ## [1.0.0-alpha.2](https://github.com/flex-development/mlly/compare/1.0.0-alpha.1...1.0.0-alpha.2) (2022-11-06)
 
 
@@ -120,10 +209,10 @@
 ### :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)
+* disable eslint rule `unicorn/no-unsafe-regex` ([8d24eda](https://github.com/flex-development/mlly/commit/8d24edada5a7c6edfee6d316239cd29dc076531c))
 * 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)
+* **docs:** scrap `vc dev` usage ([5ce8c0f](https://github.com/flex-development/mlly/commit/5ce8c0f0468b2def494922f8f3b58ebb60a5a19c))
 * **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))
@@ -153,4 +242,3 @@
 * **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/README.md

@@ -1,11 +1,13 @@
 # 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)
+[![codecov](https://codecov.io/gh/flex-development/mlly/branch/main/graph/badge.svg?token=R2TPEBGWXB)](https://codecov.io/gh/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)
+[![module type: esm](https://img.shields.io/badge/module%20type-esm-brightgreen)](https://github.com/voxpelli/badges-cjs-esm)
+[![conventional commits](https://img.shields.io/badge/-conventional%20commits-fe5196?logo=conventional-commits&logoColor=ffffff)](https://conventionalcommits.org/)
+[![typescript](https://img.shields.io/badge/-typescript-3178c6?logo=typescript&logoColor=ffffff)](https://typescriptlang.org/)
+[![vitest](https://img.shields.io/badge/-vitest-6e9f18?style=flat&logo=vitest&logoColor=ffffff)](https://vitest.dev/)
+[![yarn](https://img.shields.io/badge/-yarn-2c8ebb?style=flat&logo=yarn&logoColor=ffffff)](https://yarnpkg.com/)
 
 > [ECMAScript module][1] utilities.
 

package/dist/constants.d.mts

@@ -2,7 +2,7 @@
  * @file Constants
  * @module mlly/constants
  */
-import type { Ext } from './types/index.mjs';
+import type { Ext } from '@flex-development/pathe';
 /**
  * Default export conditions.
  *
@@ -14,6 +14,8 @@ export declare const CONDITIONS: Readonly<Set<string>>;
 /**
  * Default resolvable file extensions.
  *
+ * @see {@linkcode Ext}
+ *
  * @const {ReadonlyArray<Ext>} RESOLVE_EXTENSIONS
  */
 export declare const RESOLVE_EXTENSIONS: readonly Ext[];

package/dist/enums/index.d.mts

@@ -0,0 +1,7 @@
+/**
+ * @file Entry Point - Enums
+ * @module mlly/enums
+ */
+export { default as SpecifierKind } from './kind-specifier.mjs';
+export { default as StatementKind } from './kind-statement.mjs';
+export { default as SyntaxKind } from './kind-syntax.mjs';

package/dist/enums/index.mjs

@@ -0,0 +1,8 @@
+import { default as default2 } from "./kind-specifier.mjs";
+import { default as default3 } from "./kind-statement.mjs";
+import { default as default4 } from "./kind-syntax.mjs";
+export {
+  default2 as SpecifierKind,
+  default3 as StatementKind,
+  default4 as SyntaxKind
+};

package/dist/enums/kind-specifier.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @file Enums - SpecifierKind
+ * @module mlly/enums/SpecifierKind
+ */
+/**
+ * Specifier kinds.
+ *
+ * @enum {Lowercase<string>}
+ */
+declare enum SpecifierKind {
+    DYNAMIC = "dynamic",
+    STATIC = "static"
+}
+export default SpecifierKind;

package/dist/enums/kind-specifier.mjs

@@ -0,0 +1,9 @@
+var SpecifierKind = /* @__PURE__ */ ((SpecifierKind2) => {
+  SpecifierKind2["DYNAMIC"] = "dynamic";
+  SpecifierKind2["STATIC"] = "static";
+  return SpecifierKind2;
+})(SpecifierKind || {});
+var kind_specifier_default = SpecifierKind;
+export {
+  kind_specifier_default as default
+};

package/dist/enums/kind-statement.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @file Enums - StatementKind
+ * @module mlly/enums/StatementKind
+ */
+/**
+ * CommonJS and ESM statement kinds.
+ *
+ * @enum {Lowercase<string>}
+ */
+declare enum StatementKind {
+    EXPORT = "export",
+    IMPORT = "import",
+    REQUIRE = "require"
+}
+export default StatementKind;

package/dist/enums/kind-statement.mjs

@@ -0,0 +1,10 @@
+var StatementKind = /* @__PURE__ */ ((StatementKind2) => {
+  StatementKind2["EXPORT"] = "export";
+  StatementKind2["IMPORT"] = "import";
+  StatementKind2["REQUIRE"] = "require";
+  return StatementKind2;
+})(StatementKind || {});
+var kind_statement_default = StatementKind;
+export {
+  kind_statement_default as default
+};

package/dist/enums/kind-syntax.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @file Enums - SyntaxKind
+ * @module mlly/enums/SyntaxKind
+ */
+/**
+ * CommonJS and ESM statement syntax kinds.
+ *
+ * @enum {Lowercase<string>}
+ */
+declare enum SyntaxKind {
+    DECLARATION = "declaration",
+    DEFAULT = "default",
+    DEFAULT_WITH_NAMED = "default-with-named",
+    DEFAULT_WITH_NAMESPACE = "default-with-namespace",
+    DYNAMIC = "dynamic",
+    LIST = "list",
+    NAMED = "named",
+    NAMESPACE = "namespace",
+    REQUIRE = "require",
+    SIDE_EFFECT = "side-effect"
+}
+export default SyntaxKind;

package/dist/enums/kind-syntax.mjs

@@ -0,0 +1,17 @@
+var SyntaxKind = /* @__PURE__ */ ((SyntaxKind2) => {
+  SyntaxKind2["DECLARATION"] = "declaration";
+  SyntaxKind2["DEFAULT"] = "default";
+  SyntaxKind2["DEFAULT_WITH_NAMED"] = "default-with-named";
+  SyntaxKind2["DEFAULT_WITH_NAMESPACE"] = "default-with-namespace";
+  SyntaxKind2["DYNAMIC"] = "dynamic";
+  SyntaxKind2["LIST"] = "list";
+  SyntaxKind2["NAMED"] = "named";
+  SyntaxKind2["NAMESPACE"] = "namespace";
+  SyntaxKind2["REQUIRE"] = "require";
+  SyntaxKind2["SIDE_EFFECT"] = "side-effect";
+  return SyntaxKind2;
+})(SyntaxKind || {});
+var kind_syntax_default = SyntaxKind;
+export {
+  kind_syntax_default as default
+};

package/dist/index.d.mts

@@ -3,6 +3,7 @@
  * @module mlly
  */
 export * from './constants.mjs';
+export * from './enums/index.mjs';
 export * from './interfaces/index.mjs';
 export * from './lib/index.mjs';
 export * from './types/index.mjs';

package/dist/index.mjs

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

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

@@ -2,22 +2,40 @@
  * @file Interfaces - DynamicImport
  * @module mlly/interfaces/DynamicImport
  */
+import type { SyntaxKind } from '../enums/index.mjs';
+import type { SyntaxKindImport } from '../types/index.mjs';
+import type { EmptyString, LiteralUnion } from '@flex-development/tutils';
 import type ImportStatement from './statement-import.mjs';
 /**
- * Dynamic import statement object schema.
+ * Dynamic import statement object.
  *
- * @see {@link ImportStatement}
+ * @see {@linkcode ImportStatement}
+ * @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/import
  *
  * @extends {ImportStatement}
  */
 interface DynamicImport extends ImportStatement {
     /**
-     * Module specifier type.
+     * Import expression.
+     *
+     * @example
+     *  'import("foo.json")'
+     * @example
+     *  'import(foo)'
      */
-    specifier_type: 'dynamic' | 'static';
+    expression: LiteralUnion<EmptyString, string>;
     /**
-     * Import statement type.
+     * Options bag.
+     *
+     * @see https://github.com/tc39/proposal-import-assertions#dynamic-import
+     *
+     * @example
+     *  '{ assert: { type: "json" } }'
      */
-    type: 'dynamic';
+    options: LiteralUnion<EmptyString, string>;
+    /**
+     * Statement syntax kind.
+     */
+    syntax: Extract<SyntaxKindImport, SyntaxKind.DYNAMIC>;
 }
 export type { DynamicImport as default };

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

@@ -2,18 +2,34 @@
  * @file Interfaces - StaticImport
  * @module mlly/interfaces/StaticImport
  */
+import type { SyntaxKind } from '../enums/index.mjs';
+import type { SyntaxKindImport } from '../types/index.mjs';
+import type { EmptyString, LiteralUnion } from '@flex-development/tutils';
 import type ImportStatement from './statement-import.mjs';
 /**
- * Static import statement object schema.
+ * Static import statement object.
  *
- * @see {@link ImportStatement}
+ * @see {@linkcode ImportStatement}
  *
  * @extends {ImportStatement}
  */
 interface StaticImport extends ImportStatement {
     /**
-     * Import statement type.
+     * Assertion options.
+     *
+     * @see https://github.com/tc39/proposal-import-assertions#import-statements
+     *
+     * @example
+     *  '{ type: "json" }'
      */
-    type: 'default' | 'named' | 'star';
+    assertion: LiteralUnion<EmptyString, string>;
+    /**
+     * Statement syntax kind.
+     */
+    syntax: Extract<SyntaxKindImport, SyntaxKind.DEFAULT | SyntaxKind.DEFAULT_WITH_NAMED | SyntaxKind.DEFAULT_WITH_NAMESPACE | SyntaxKind.NAMED | SyntaxKind.NAMESPACE | SyntaxKind.SIDE_EFFECT>;
+    /**
+     * Type-only import statement check.
+     */
+    type: boolean;
 }
 export type { StaticImport as default };

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

@@ -16,7 +16,7 @@ interface ResolveAliasOptions {
      *
      * @default process.cwd()
      */
-    baseUrl?: string;
+    baseUrl?: string | undefined;
     /**
      * Module extensions to probe for.
      *
@@ -24,7 +24,7 @@ interface ResolveAliasOptions {
      *
      * @default RESOLVE_EXTENSIONS
      */
-    extensions?: string[] | readonly string[];
+    extensions?: string[] | readonly string[] | undefined;
     /**
      * Checks for the existence of a file at `path`.
      *
@@ -39,21 +39,21 @@ interface ResolveAliasOptions {
      *
      * @default ['main', 'module']
      */
-    mainFields?: OneOrMany<string>[];
+    mainFields?: OneOrMany<string>[] | undefined;
     /**
      * Absolute path to file containing path alias.
      */
-    parent?: string;
+    parent?: string | undefined;
     /**
      * Path mappings.
      *
-     * **Note**: Should be relative to {@link baseUrl}.
+     * **Note**: Should be relative to {@linkcode baseUrl}.
      *
      * @see https://www.typescriptlang.org/tsconfig#paths
      *
      * @default {}
      */
-    paths?: Record<string, string[]>;
+    paths?: Record<string, string[]> | undefined;
     /**
      * Synchronously returns the contents of `filename`.
      *
@@ -64,6 +64,6 @@ interface ResolveAliasOptions {
     /**
      * Absolute path to tsconfig file.
      */
-    tsconfig?: string;
+    tsconfig?: string | undefined;
 }
 export type { ResolveAliasOptions as default };

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

@@ -3,7 +3,8 @@
  * @module mlly/interfaces/ResolveOptions
  */
 /// <reference types="node" />
-import type { Ext, SpecifierType } from '../types/index.mjs';
+import type { ModuleSpecifierType } from '../types/index.mjs';
+import type { Ext } from '@flex-development/pathe';
 import type { EmptyString } from '@flex-development/tutils';
 import type { URL } from 'node:url';
 /**
@@ -19,15 +20,15 @@ interface ResolveOptions {
      *
      * @default CONDITIONS
      */
-    conditions?: Set<string> | string[] | readonly string[];
+    conditions?: Set<string> | string[] | readonly string[] | undefined;
     /**
      * Remove or replace file extension.
      *
-     * **Note**: {@link type} must be set to `relative`.
+     * **Note**: {@linkcode type} must be set to `relative`.
      *
-     * @see {@link Ext}
+     * @see {@linkcode Ext}
      */
-    ext?: Ext | false | ((specifier: string, resolved: string) => EmptyString | Ext | PromiseLike<EmptyString | Ext>);
+    ext?: Ext | false | ((specifier: string, resolved: string) => EmptyString | Ext | PromiseLike<EmptyString | Ext>) | undefined;
     /**
      * Module extensions to probe for.
      *
@@ -35,26 +36,26 @@ interface ResolveOptions {
      *
      * @default RESOLVE_EXTENSIONS
      */
-    extensions?: string[] | readonly string[];
+    extensions?: string[] | readonly string[] | undefined;
     /**
      * Parent module URL or path to resolve from.
      *
      * @default import.meta.url
      */
-    parent?: URL | string;
+    parent?: URL | string | undefined;
     /**
      * Keep symlinks instead of resolving them.
      *
      * @default false
      */
-    preserveSymlinks?: boolean;
+    preserveSymlinks?: boolean | undefined;
     /**
      * Module specifier type or a function to determine module specifier type.
      *
-     * @see {@link SpecifierType}
+     * @see {@linkcode ModuleSpecifierType}
      *
      * @default 'absolute'
      */
-    type?: SpecifierType | ((resolved: string) => PromiseLike<SpecifierType> | SpecifierType);
+    type?: ModuleSpecifierType | ((resolved: string) => ModuleSpecifierType | PromiseLike<ModuleSpecifierType>) | undefined;
 }
 export type { ResolveOptions as default };

package/dist/interfaces/statement-export.d.mts

@@ -2,30 +2,43 @@
  * @file Interfaces - ExportStatement
  * @module mlly/interfaces/ExportStatement
  */
-import type { Declaration } from '../types/index.mjs';
+import type { StatementKind } from '../enums/index.mjs';
+import type { Declaration, SyntaxKindExport } from '../types/index.mjs';
+import type { Nullable } from '@flex-development/tutils';
 import type Statement from './statement.mjs';
 /**
- * Export statement object schema.
+ * Export statement object.
  *
- * @see {@link Declaration}
- * @see {@link Statement}
+ * @see {@linkcode Declaration}
+ * @see {@linkcode Statement}
+ * @see {@linkcode SyntaxKindExport}
  *
  * @extends {Statement}
  */
 interface ExportStatement extends Statement {
     /**
      * Export declaration, if any.
-     *
-     * @see {@link Declaration}
      */
-    declaration: Declaration | undefined;
+    declaration: Nullable<Declaration>;
     /**
      * Export names.
      */
     exports: string[];
     /**
-     * Export statement type.
+     * Statement kind.
      */
-    type: 'declaration' | 'default' | 'named' | 'star';
+    kind: StatementKind.EXPORT;
+    /**
+     * Modifier keywords.
+     */
+    modifiers: string[];
+    /**
+     * Statement syntax kind.
+     */
+    syntax: SyntaxKindExport;
+    /**
+     * Type-only export statement check.
+     */
+    type: boolean;
 }
 export type { ExportStatement as default };

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

@@ -2,11 +2,14 @@
  * @file Interfaces - ImportStatement
  * @module mlly/interfaces/ImportStatement
  */
+import type { StatementKind } from '../enums/index.mjs';
+import type { SyntaxKindImport } from '../types/index.mjs';
 import type Statement from './statement.mjs';
 /**
- * Import statement object schema.
+ * Import statement object.
  *
- * @see {@link Statement}
+ * @see {@linkcode Statement}
+ * @see {@linkcode SyntaxKindImport}
  *
  * @extends {Statement}
  */
@@ -15,13 +18,21 @@ interface ImportStatement extends Statement {
      * Import names.
      */
     imports: string[];
+    /**
+     * Statement kind.
+     */
+    kind: StatementKind.IMPORT;
     /**
      * Module specifier.
      */
     specifier: NonNullable<Statement['specifier']>;
     /**
-     * Import statement type.
+     * Module specifier kind.
+     */
+    specifier_kind: NonNullable<Statement['specifier_kind']>;
+    /**
+     * Statement syntax kind.
      */
-    type: 'default' | 'dynamic' | 'named' | 'star';
+    syntax: SyntaxKindImport;
 }
 export type { ImportStatement as default };

package/dist/interfaces/statement-require.d.mts

@@ -2,11 +2,14 @@
  * @file Interfaces - RequireStatement
  * @module mlly/interfaces/RequireStatement
  */
+import type { StatementKind } from '../enums/index.mjs';
+import type { SyntaxKindRequire } from '../types/index.mjs';
 import type Statement from './statement.mjs';
 /**
- * Require statement object schema.
+ * Require statement object.
  *
- * @see {@link Statement}
+ * @see {@linkcode Statement}
+ * @see {@linkcode SyntaxKindRequire}
  *
  * @extends {Statement}
  */
@@ -15,13 +18,21 @@ interface RequireStatement extends Statement {
      * Import names.
      */
     imports: string[];
+    /**
+     * Statement kind.
+     */
+    kind: StatementKind.REQUIRE;
     /**
      * Module specifier.
      */
     specifier: NonNullable<Statement['specifier']>;
     /**
-     * Import statement type.
+     * Module specifier kind.
+     */
+    specifier_kind: NonNullable<Statement['specifier_kind']>;
+    /**
+     * Statement syntax kind.
      */
-    type: 'require';
+    syntax: SyntaxKindRequire;
 }
 export type { RequireStatement as default };