@flex-development/mlly 1.0.0-alpha.1 → 1.0.0-alpha.11

package/dist/enums/kind-statement.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/enums/kind-statement.ts"],
+  "mappings": "AAUA,IAAK,gBAAL,kBAAKA,mBAAL;AACE,EAAAA,eAAA,YAAS;AACT,EAAAA,eAAA,YAAS;AACT,EAAAA,eAAA,aAAU;AAHP,SAAAA;AAAA,GAAA;AAML,IAAO,yBAAQ;",
+  "names": ["StatementKind"]
+}

package/dist/index.d.mts

@@ -2,7 +2,7 @@
  * @file Package Entry Point
  * @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';
+export * from './utils/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";
+export * from "./utils/index.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "mappings": "AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

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

@@ -0,0 +1,20 @@
+/**
+ * @file Interfaces - ImportAssertions
+ * @module mlly/interfaces/ImportAssertions
+ */
+import type { AssertType } from '../enums/index.mjs';
+import type { LiteralUnion } from '@flex-development/tutils';
+/**
+ * `import` assertions schema.
+ *
+ * @see {@linkcode AssertType}
+ * @see https://github.com/tc39/proposal-import-assertions
+ */
+interface ImportAssertions {
+    [key: string]: string;
+    /**
+     * Assertion type.
+     */
+    type?: LiteralUnion<AssertType, string>;
+}
+export type { ImportAssertions as default };

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

@@ -2,22 +2,42 @@
  * @file Interfaces - DynamicImport
  * @module mlly/interfaces/DynamicImport
  */
+import type { StatementSyntaxKind } 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 {@linkcode StatementSyntaxKind}
+ * @see {@linkcode SyntaxKindImport}
+ * @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, StatementSyntaxKind.DYNAMIC>;
 }
 export type { DynamicImport as default };

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

@@ -2,18 +2,36 @@
  * @file Interfaces - StaticImport
  * @module mlly/interfaces/StaticImport
  */
+import type { StatementSyntaxKind } 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}
+ * @see {@linkcode StatementSyntaxKind}
+ * @see {@linkcode SyntaxKindImport}
  *
  * @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, StatementSyntaxKind.DEFAULT | StatementSyntaxKind.DEFAULT_WITH_NAMED | StatementSyntaxKind.DEFAULT_WITH_NAMESPACE | StatementSyntaxKind.NAMED | StatementSyntaxKind.NAMESPACE | StatementSyntaxKind.SIDE_EFFECT>;
+    /**
+     * Type-only import statement check.
+     */
+    type: boolean;
 }
 export type { StaticImport as default };

package/dist/interfaces/index.d.mts

@@ -2,10 +2,22 @@
  * @file Interfaces
  * @module mlly/interfaces
  */
+export type { default as ImportAssertions } from './import-assertions.mjs';
 export type { default as DynamicImport } from './import-dynamic.mjs';
 export type { default as StaticImport } from './import-static.mjs';
+export type { default as FillModuleOptions } from './options-fill-module.mjs';
+export type { default as FindSubpathOptions } from './options-find-subpath.mjs';
+export type { default as GetFormatOptions } from './options-get-format.mjs';
+export type { default as GetSourceOptions } from './options-get-source.mjs';
+export type { default as ParseModuleIdOptions } from './options-parse-module-id.mjs';
+export type { default as ParseSubpathOptions } from './options-parse-subpath.mjs';
 export type { default as ResolveOptions } from './options-resolve.mjs';
 export type { default as ResolveAliasOptions } from './options-resolve-alias.mjs';
+export type { default as ResolveModuleOptions } from './options-resolve-module.mjs';
+export type { default as PackageScope } from './package-scope.mjs';
+export type { default as ParsedDataUrl } from './parsed-data-url.mjs';
+export type { default as ParsedModuleId } from './parsed-module-id.mjs';
+export type { default as ParsedSubpath } from './parsed-subpath.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';

package/dist/interfaces/index.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=index.mjs.map

package/dist/interfaces/index.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": [],
+  "mappings": "",
+  "names": []
+}

package/dist/interfaces/options-fill-module.d.mts

@@ -0,0 +1,23 @@
+/**
+ * @file Interfaces - FillModuleOptions
+ * @module mlly/interfaces/FillModuleOptions
+ */
+import type { ChangeExtFn } from '../types/index.mjs';
+import type ResolveModuleOptions from './options-resolve-module.mjs';
+/**
+ * Options for fully specifying modules.
+ *
+ * @see {@linkcode ChangeExtFn}
+ * @see {@linkcode ResolveModuleOptions}
+ * @see https://nodejs.org/api/esm.html#mandatory-file-extensions
+ *
+ * @extends {ResolveModuleOptions}
+ */
+interface FillModuleOptions extends ResolveModuleOptions {
+    /**
+     * File extension to add to absolute and relative specifiers or a function
+     * that returns a file extension.
+     */
+    ext: ChangeExtFn<string> | string;
+}
+export type { FillModuleOptions as default };

package/dist/interfaces/options-find-subpath.d.mts

@@ -0,0 +1,49 @@
+/**
+ * @file Interfaces - FindSubpathOptions
+ * @module mlly/interfaces/FindSubpathOptions
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Subpath search options.
+ *
+ * @see {@linkcode ModuleId}
+ */
+interface FindSubpathOptions {
+    /**
+     * Export condition to apply.
+     *
+     * @see https://nodejs.org/api/packages.html#conditional-exports
+     *
+     * @default 'default'
+     */
+    condition?: string | undefined;
+    /**
+     * Export conditions.
+     *
+     * **Note**: Should be sorted by priority.
+     *
+     * @see https://nodejs.org/api/packages.html#conditional-exports
+     *
+     * @default CONDITIONS
+     */
+    conditions?: Set<string> | undefined;
+    /**
+     * URL of directory containing relevant `package.json` file.
+     */
+    dir: ModuleId;
+    /**
+     * Package [`imports`][1] hint.
+     *
+     * [1]: https://nodejs.org/api/packages.html#imports
+     *
+     * @default false
+     */
+    internal?: boolean | undefined;
+    /**
+     * URL of module to resolve from.
+     *
+     * **Note**: Used for error reporting only.
+     */
+    parent: ModuleId;
+}
+export type { FindSubpathOptions as default };

package/dist/interfaces/options-get-format.d.mts

@@ -0,0 +1,83 @@
+/**
+ * @file Interfaces - GetFormatOptions
+ * @module mlly/interfaces/GetFormatOptions
+ */
+import type { Format } from '../enums/index.mjs';
+import type { ModuleId } from '../types/index.mjs';
+import type { Ext } from '@flex-development/pathe';
+import type { EmptyString } from '@flex-development/tutils';
+import type { RequestInit } from 'node-fetch';
+/**
+ * Module format retrieval options.
+ *
+ * @see {@linkcode Ext}
+ * @see {@linkcode Format}
+ * @see {@linkcode ModuleId}
+ * @see {@linkcode RequestInit}
+ */
+interface GetFormatOptions {
+    /**
+     * Base URL to resolve module id against if module id is not absolute.
+     *
+     * @see {@linkcode ModuleId}
+     *
+     * @default undefined
+     */
+    base?: ModuleId | undefined;
+    /**
+     * Enable support for JSON modules.
+     *
+     * @see https://nodejs.org/docs/latest-v14.x/api/esm.html#esm_json_modules
+     *
+     * @default true
+     */
+    experimental_json_modules?: boolean | undefined;
+    /**
+     * Enable support for network based modules.
+     *
+     * **Note**: Requires [`node-fetch`][1].
+     *
+     * [1]: https://github.com/node-fetch/node-fetch
+     *
+     * @see https://nodejs.org/docs/latest-v16.x/api/esm.html#https-and-http-imports
+     *
+     * @default false
+     */
+    experimental_network_imports?: boolean | undefined;
+    /**
+     * Enable support for WebAssembly modules.
+     *
+     * @see https://nodejs.org/docs/latest-v14.x/api/esm.html#esm_wasm_modules
+     *
+     * @default false
+     */
+    experimental_wasm_modules?: boolean | undefined;
+    /**
+     * Map file extensions to module formats.
+     *
+     * @default EXTENSION_FORMAT_MAP
+     */
+    extension_format_map?: Map<EmptyString | Ext, Format> | undefined;
+    /**
+     * Return `undefined` when module format is not found, rather than `null`.
+     *
+     * An explicit `undefined` return value indicates [`load`][1] hooks should
+     * re-run module format checks.
+     *
+     * [1]: https://nodejs.org/docs/latest-v16.x/api/esm.html#loadurl-context-nextload
+     *
+     * @default false
+     */
+    ignore_errors?: boolean | undefined;
+    /**
+     * Request options for network based modules.
+     *
+     * Only applicable if {@linkcode experimental_network_imports} is enabled.
+     *
+     * @see {@linkcode RequestInit}
+     *
+     * @default undefined
+     */
+    req?: RequestInit | undefined;
+}
+export type { GetFormatOptions as default };

package/dist/interfaces/options-get-source.d.mts

@@ -0,0 +1,63 @@
+/**
+ * @file Interfaces - GetSourceOptions
+ * @module mlly/interfaces/GetSourceOptions
+ */
+import type { Format } from '../enums/index.mjs';
+import type { ModuleId } from '../types/index.mjs';
+import type { RequestInit } from 'node-fetch';
+/**
+ * Source code retrieval options.
+ *
+ * @see {@linkcode Format}
+ * @see {@linkcode ModuleId}
+ * @see {@linkcode RequestInit}
+ */
+interface GetSourceOptions {
+    /**
+     * Base URL to resolve module id against if module id is not absolute.
+     *
+     * @see {@linkcode ModuleId}
+     *
+     * @default undefined
+     */
+    base?: ModuleId | undefined;
+    /**
+     * Enable support for network based modules.
+     *
+     * **Note**: Requires [`node-fetch`][1].
+     *
+     * [1]: https://github.com/node-fetch/node-fetch
+     *
+     * @see https://nodejs.org/docs/latest-v16.x/api/esm.html#https-and-http-imports
+     *
+     * @default false
+     */
+    experimental_network_imports?: boolean | undefined;
+    /**
+     * Module format hint.
+     *
+     * @see {@linkcode Format}
+     *
+     * @default undefined
+     */
+    format?: Format | Lowercase<keyof typeof Format> | undefined;
+    /**
+     * Ignore [`ERR_UNSUPPORTED_ESM_URL_SCHEME`][1] if thrown.
+     *
+     * [1]: https://nodejs.org/api/errors.html#err_unsupported_esm_url_scheme
+     *
+     * @default false
+     */
+    ignore_errors?: boolean | undefined;
+    /**
+     * Request options for network based modules.
+     *
+     * Only applicable if {@linkcode experimental_network_imports} is enabled.
+     *
+     * @see {@linkcode RequestInit}
+     *
+     * @default undefined
+     */
+    req?: RequestInit | undefined;
+}
+export type { GetSourceOptions as default };

package/dist/interfaces/options-parse-module-id.d.mts

@@ -0,0 +1,33 @@
+/**
+ * @file Interfaces - ParseModuleIdOptions
+ * @module mlly/interfaces/ParseModuleIdOptions
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Module id parsing options.
+ *
+ * @see {@linkcode ModuleId}
+ */
+interface ParseModuleIdOptions {
+    /**
+     * Ensure module id is a valid internal specifier, syntactically.
+     *
+     * @see https://nodejs.org/api/packages.html#subpath-imports
+     *
+     * @default id instanceof URL ? false : id.startsWith('#')
+     */
+    internal?: boolean | undefined;
+    /**
+     * URL of module to resolve from.
+     *
+     * **Note**: Used for error reporting only.
+     *
+     * @default undefined
+     */
+    parent?: ModuleId | undefined;
+    /**
+     * Ensure module id begins with a valid package name.
+     */
+    pkgname?: boolean | undefined;
+}
+export type { ParseModuleIdOptions as default };

package/dist/interfaces/options-parse-subpath.d.mts

@@ -0,0 +1,31 @@
+/**
+ * @file Interfaces - ParseSubpathOptions
+ * @module mlly/interfaces/ParseSubpathOptions
+ */
+import type { ModuleId } from '../types/index.mjs';
+/**
+ * Subpath parsing options.
+ *
+ * @see {@linkcode ModuleId}
+ */
+interface ParseSubpathOptions {
+    /**
+     * URL of directory containing relevant `package.json` file.
+     */
+    dir: ModuleId;
+    /**
+     * Package [`imports`][1] hint.
+     *
+     * [1]: https://nodejs.org/api/packages.html#imports
+     *
+     * @default specifier.startsWith('#')
+     */
+    internal?: boolean | undefined;
+    /**
+     * URL of module to resolve from.
+     *
+     * **Note**: Used for error reporting only.
+     */
+    parent: ModuleId;
+}
+export type { ParseSubpathOptions as default };

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

@@ -2,68 +2,52 @@
  * @file Interfaces - ResolveAliasOptions
  * @module mlly/interfaces/ResolveAliasOptions
  */
-import type { OneOrMany } from '@flex-development/tutils';
+import type { ModuleId } from '../types/index.mjs';
+import type { MapLike, OneOrMany } from '@flex-development/tutils';
+import type ResolveModuleOptions from './options-resolve-module.mjs';
 /**
  * Path alias resolution options.
  *
- * @see https://github.com/dividab/tsconfig-paths
+ * @see {@linkcode ModuleId}
+ *
+ * @extends {ResolveModuleOptions}
  */
-interface ResolveAliasOptions {
-    /**
-     * Base directory to resolve non-absolute module names.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#baseUrl
-     *
-     * @default process.cwd()
-     */
-    baseUrl?: string;
+interface ResolveAliasOptions extends ResolveModuleOptions {
     /**
-     * Module extensions to probe for.
-     *
-     * **Note**: Should be sorted by priority.
+     * Return resolved module URL as absolute specifier (a [`file:` URL][1]).
      *
-     * @default RESOLVE_EXTENSIONS
-     */
-    extensions?: string[] | readonly string[];
-    /**
-     * Checks for the existence of a file at `path`.
+     * If `false`, return resolved module URL as bare or relative specifier.
      *
-     * @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.
+     * [1]: https://nodejs.org/api/esm.html#file-urls
      *
-     * A nested field can be selected by passing an array of field names.
+     * @see https://nodejs.org/api/esm.html#terminology
      *
-     * @default ['main', 'module']
-     */
-    mainFields?: OneOrMany<string>[];
-    /**
-     * Absolute path to file containing path alias.
+     * @default true
      */
-    parent?: string;
+    absolute?: boolean | undefined;
     /**
      * Path mappings.
      *
-     * **Note**: Should be relative to {@link baseUrl}.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
+     * **Note**: Paths should be relative to {@linkcode cwd}.
      *
      * @default {}
      */
-    paths?: Record<string, string[]>;
+    aliases?: MapLike<OneOrMany<string>> | undefined;
     /**
-     * Synchronously returns the contents of `filename`.
+     * Directory to resolve non-absolute modules from.
      *
-     * @param {string} filename - Filename
-     * @return {string} Contents of `filename`
+     * @default pathToFileURL('.')
      */
-    readFile?(this: void, filename: string): string;
+    cwd?: ModuleId | undefined;
     /**
-     * Absolute path to tsconfig file.
+     * Id of module to resolve from.
+     *
+     * **Note**: Should be an absolute path or [`file:` URL][1].
+     *
+     * [1]: https://nodejs.org/api/esm.html#file-urls
+     *
+     * @default import.meta.url
      */
-    tsconfig?: string;
+    parent?: ModuleId | undefined;
 }
 export type { ResolveAliasOptions as default };

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

@@ -0,0 +1,64 @@
+/**
+ * @file Interfaces - ResolveModuleOptions
+ * @module mlly/interfaces/ResolveModuleOptions
+ */
+import type { ChangeExtFn, ModuleId } from '../types/index.mjs';
+import type { Nilable } from '@flex-development/tutils';
+/**
+ * Module resolution options.
+ *
+ * @see {@linkcode ChangeExtFn}
+ * @see {@linkcode ModuleId}
+ */
+interface ResolveModuleOptions {
+    /**
+     * Export condition to apply.
+     *
+     * @see https://nodejs.org/api/packages.html#conditional-exports
+     *
+     * @default 'default'
+     */
+    condition?: string | undefined;
+    /**
+     * Export conditions.
+     *
+     * **Note**: Should be sorted by priority.
+     *
+     * @see https://nodejs.org/api/packages.html#conditional-exports
+     *
+     * @default CONDITIONS
+     */
+    conditions?: Set<string> | string[] | undefined;
+    /**
+     * Replacement file extension or function that returns a file extension.
+     *
+     * An empty string (`''`) will remove a file extension; `null` or `undefined`
+     * will skip extension replacement.
+     *
+     * @default undefined
+     */
+    ext?: ChangeExtFn | Nilable<string>;
+    /**
+     * Module extensions to probe for.
+     *
+     * **Note**: Should be sorted by priority.
+     *
+     * @default RESOLVE_EXTENSIONS
+     */
+    extensions?: Set<string> | string[] | undefined;
+    /**
+     * URL of module to resolve from.
+     *
+     * @see {@linkcode ModuleId}
+     *
+     * @default import.meta.url
+     */
+    parent?: ModuleId | undefined;
+    /**
+     * Keep symlinks instead of resolving them.
+     *
+     * @default false
+     */
+    preserveSymlinks?: boolean | undefined;
+}
+export type { ResolveModuleOptions as default };