@flex-development/mlly 1.0.0-alpha.17 → 1.0.0-alpha.19

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

@@ -1,17 +0,0 @@
-/**
- * @file Enums - SpecifierKind
- * @module mlly/enums/SpecifierKind
- */
-/**
- * Module specifier types.
- *
- * @see https://nodejs.org/api/esm.html#terminology
- *
- * @enum {Lowercase<string>}
- */
-declare enum SpecifierKind {
-    ABSOLUTE = "absolute",
-    BARE = "bare",
-    RELATIVE = "relative"
-}
-export default SpecifierKind;

package/dist/enums/kind-specifier.mjs

@@ -1,4 +0,0 @@
-var SpecifierKind = /* @__PURE__ */ ((SpecifierKind2) => (SpecifierKind2.ABSOLUTE = "absolute", SpecifierKind2.BARE = "bare", SpecifierKind2.RELATIVE = "relative", SpecifierKind2))(SpecifierKind || {}), kind_specifier_default = SpecifierKind;
-export {
-  kind_specifier_default as default
-};

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

@@ -1,22 +0,0 @@
-/**
- * @file Enums - StatementSyntaxKind
- * @module mlly/enums/StatementSyntaxKind
- */
-/**
- * CommonJS and ESM statement syntax kinds.
- *
- * @enum {Lowercase<string>}
- */
-declare enum StatementSyntaxKind {
-    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 StatementSyntaxKind;

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

@@ -1,4 +0,0 @@
-var StatementSyntaxKind = /* @__PURE__ */ ((StatementSyntaxKind2) => (StatementSyntaxKind2.DECLARATION = "declaration", StatementSyntaxKind2.DEFAULT = "default", StatementSyntaxKind2.DEFAULT_WITH_NAMED = "default-with-named", StatementSyntaxKind2.DEFAULT_WITH_NAMESPACE = "default-with-namespace", StatementSyntaxKind2.DYNAMIC = "dynamic", StatementSyntaxKind2.LIST = "list", StatementSyntaxKind2.NAMED = "named", StatementSyntaxKind2.NAMESPACE = "namespace", StatementSyntaxKind2.REQUIRE = "require", StatementSyntaxKind2.SIDE_EFFECT = "side-effect", StatementSyntaxKind2))(StatementSyntaxKind || {}), kind_statement_syntax_default = StatementSyntaxKind;
-export {
-  kind_statement_syntax_default as default
-};

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

@@ -1,15 +0,0 @@
-/**
- * @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

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

package/dist/index.mjs.map

@@ -1,8 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "sourceRoot": "file://",
-  "sourcesContent": ["/**\n * @file Package Entry Point\n * @module mlly\n */\n\nexport * from './enums'\nexport * from './interfaces'\nexport * from './types'\nexport * from './utils'\n"],
-  "mappings": "AAKA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
-  "names": []
-}

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

@@ -1,20 +0,0 @@
-/**
- * @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

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

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

@@ -1,35 +0,0 @@
-/**
- * @file Interfaces - StaticImport
- * @module mlly/interfaces/StaticImport
- */
-import type { StatementSyntaxKind } from '../enums/index.mjs';
-import type { EmptyString, LiteralUnion } from '@flex-development/tutils';
-import type ImportStatement from './statement-import.mjs';
-/**
- * Static import statement object.
- *
- * @see {@linkcode ImportStatement}
- * @see {@linkcode StatementSyntaxKind}
- *
- * @extends {ImportStatement}
- */
-interface StaticImport extends ImportStatement {
-    /**
-     * Assertion options.
-     *
-     * @see https://github.com/tc39/proposal-import-assertions#import-statements
-     *
-     * @example
-     *  '{ type: "json" }'
-     */
-    assertion: LiteralUnion<EmptyString, string>;
-    /**
-     * Statement syntax kind.
-     */
-    syntax: 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/options-fill-module.d.mts

@@ -1,23 +0,0 @@
-/**
- * @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

@@ -1,50 +0,0 @@
-/**
- * @file Interfaces - FindSubpathOptions
- * @module mlly/interfaces/FindSubpathOptions
- */
-import type { ModuleId } from '../types/index.mjs';
-import type { Optional } from '@flex-development/tutils';
-/**
- * Subpath search options.
- *
- * @see {@linkcode ModuleId}
- */
-interface FindSubpathOptions {
-    /**
-     * Export condition to apply.
-     *
-     * @see https://nodejs.org/api/packages.html#conditional-exports
-     *
-     * @default 'default'
-     */
-    condition?: Optional<string>;
-    /**
-     * Export conditions.
-     *
-     * **Note**: Should be sorted by priority.
-     *
-     * @see https://nodejs.org/api/packages.html#conditional-exports
-     *
-     * @default CONDITIONS
-     */
-    conditions?: Optional<Set<string>>;
-    /**
-     * 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?: Optional<boolean>;
-    /**
-     * 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

@@ -1,73 +0,0 @@
-/**
- * @file Interfaces - GetFormatOptions
- * @module mlly/interfaces/GetFormatOptions
- */
-import type { Format } from '../enums/index.mjs';
-import type { Ext } from '@flex-development/pathe';
-import type { EmptyString, Optional } from '@flex-development/tutils';
-/**
- * Module format retrieval options.
- *
- * @see {@linkcode Ext}
- * @see {@linkcode Format}
- * @see {@linkcode RequestInit}
- */
-interface GetFormatOptions {
-    /**
-     * Enable support for JSON modules.
-     *
-     * @see https://nodejs.org/docs/latest-v14.x/api/esm.html#esm_json_modules
-     *
-     * @default true
-     */
-    experimental_json_modules?: Optional<boolean>;
-    /**
-     * 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?: Optional<boolean>;
-    /**
-     * Enable support for WebAssembly modules.
-     *
-     * @see https://nodejs.org/docs/latest-v14.x/api/esm.html#esm_wasm_modules
-     *
-     * @default false
-     */
-    experimental_wasm_modules?: Optional<boolean>;
-    /**
-     * Map file extensions to module formats.
-     *
-     * @default EXTENSION_FORMAT_MAP
-     */
-    extension_format_map?: Optional<Map<EmptyString | Ext, Format>>;
-    /**
-     * 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?: Optional<boolean>;
-    /**
-     * Request options for network based modules.
-     *
-     * Only applicable if {@linkcode experimental_network_imports} is enabled.
-     *
-     * @see {@linkcode RequestInit}
-     *
-     * @default {}
-     */
-    // @ts-ignore peer dependency
-    req?: Optional<import('node-fetch').RequestInit>;
-}
-export type { GetFormatOptions as default };

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

@@ -1,34 +0,0 @@
-/**
- * @file Interfaces - ParseModuleIdOptions
- * @module mlly/interfaces/ParseModuleIdOptions
- */
-import type { ModuleId } from '../types/index.mjs';
-import type { Optional } from '@flex-development/tutils';
-/**
- * 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?: Optional<boolean>;
-    /**
-     * URL of module to resolve from.
-     *
-     * **Note**: Used for error reporting only.
-     *
-     * @default undefined
-     */
-    parent?: Optional<ModuleId>;
-    /**
-     * Ensure module id begins with a valid package name.
-     */
-    pkgname?: Optional<boolean>;
-}
-export type { ParseModuleIdOptions as default };

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

@@ -1,50 +0,0 @@
-/**
- * @file Interfaces - ParseSubpathOptions
- * @module mlly/interfaces/ParseSubpathOptions
- */
-import type { ModuleId } from '../types/index.mjs';
-import type { Optional } from '@flex-development/tutils';
-/**
- * Subpath parsing options.
- *
- * @see {@linkcode ModuleId}
- */
-interface ParseSubpathOptions {
-    /**
-     * Export condition to apply.
-     *
-     * @see https://nodejs.org/api/packages.html#conditional-exports
-     *
-     * @default 'default'
-     */
-    condition?: Optional<string>;
-    /**
-     * Export conditions.
-     *
-     * **Note**: Should be sorted by priority.
-     *
-     * @see https://nodejs.org/api/packages.html#conditional-exports
-     *
-     * @default CONDITIONS
-     */
-    conditions?: Optional<Set<string> | string[]>;
-    /**
-     * 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?: Optional<boolean>;
-    /**
-     * URL of module to resolve from.
-     *
-     * **Note**: Used for error reporting only.
-     */
-    parent: ModuleId;
-}
-export type { ParseSubpathOptions as default };

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

@@ -1,15 +0,0 @@
-/**
- * @file Interfaces - ResolveOptions
- * @module mlly/interfaces/ResolveOptions
- */
-import type ResolveModuleOptions from './options-resolve-module.mjs';
-/**
- * Resolution options.
- *
- * @see {@linkcode ResolveModuleOptions}
- *
- * @extends {ResolveModuleOptions}
- */
-interface ResolveOptions extends ResolveModuleOptions {
-}
-export type { ResolveOptions as default };

package/dist/interfaces/package-scope.d.mts

@@ -1,25 +0,0 @@
-/**
- * @file Interfaces - PackageScope
- * @module mlly/interfaces/PackageScope
- */
-import type { PackageJson } from '@flex-development/pkg-types';
-/**
- * Object representing a package scope.
- *
- * @see {@linkcode PackageJson}
- */
-interface PackageScope {
-    /**
-     * URL of directory containing `package.json` file.
-     */
-    dir: string;
-    /**
-     * URL of `package.json` file.
-     */
-    pkg: string;
-    /**
-     * `package.json` object.
-     */
-    pkgjson: PackageJson;
-}
-export type { PackageScope as default };

package/dist/interfaces/parsed-data-url.d.mts

@@ -1,56 +0,0 @@
-/**
- * @file Interfaces - ParsedDataUrl
- * @module mlly/interfaces/ParsedDataUrl
- */
-/// <reference types="node" />
-import type { MimeType, Protocol } from '../types/index.mjs';
-import type { EmptyString, LiteralUnion } from '@flex-development/tutils';
-import type { URL } from 'node:url';
-/**
- * Object representing a [`data:` URL][1].
- *
- * [1]: https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
- *
- * @see {@linkcode Protocol}
- * @see {@linkcode MimeType}
- * @see https://nodejs.org/api/esm.html#data-imports
- */
-interface ParsedDataUrl {
-    /**
-     * [base64][1] encoding check.
-     *
-     * [1]: https://developer.mozilla.org/docs/Glossary/Base64
-     */
-    base64: boolean;
-    /**
-     * Data portion of URL.
-     *
-     * If {@linkcode base64} is `true`, `data` is base64-encoded.
-     */
-    data: LiteralUnion<EmptyString, string>;
-    /**
-     * Serialized `data:` URL.
-     *
-     * @see https://nodejs.org/api/url.html#urlhref
-     */
-    href: URL['href'];
-    /**
-     * MIME type.
-     *
-     * @see https://developer.mozilla.org/docs/Web/HTTP/Basics_of_HTTP/MIME_types
-     */
-    mime: LiteralUnion<MimeType, string>;
-    /**
-     * Path portion of URL.
-     *
-     * @see https://nodejs.org/api/url.html#urlpathname
-     */
-    pathname: URL['pathname'];
-    /**
-     * Protocol portion of URL.
-     *
-     * @see https://nodejs.org/api/url.html#urlprotocol
-     */
-    protocol: Extract<Protocol, 'data:'>;
-}
-export type { ParsedDataUrl as default };

package/dist/interfaces/parsed-module-id.d.mts

@@ -1,80 +0,0 @@
-/**
- * @file Interfaces - ParsedModuleId
- * @module mlly/interfaces/ParsedModuleId
- */
-import type { Protocol } from '../types/index.mjs';
-import type { SemanticVersion } from '@flex-development/pkg-types';
-import type { EmptyString, LiteralUnion } from '@flex-development/tutils';
-/**
- * Object representing a ECMAScript module id.
- *
- * @see {@linkcode Protocol}
- * @see {@linkcode SemanticVersion}
- */
-interface ParsedModuleId {
-    /**
-     * Subpath import (internal specifier) check.
-     *
-     * @see https://nodejs.org/api/packages.html#imports
-     * @see https://nodejs.org/api/packages.html#subpath-imports
-     */
-    internal: boolean;
-    /**
-     * One of the following:
-     *
-     * - Possible [subpath export][1] (includes leading `'.'`)
-     * - Possible [subpath import][2]
-     * - URL [`host`][3], [`pathname`][4], and [`port`][5]
-     * - Raw module id ({@linkcode raw})
-     *
-     * [1]: https://nodejs.org/api/packages.html#subpath-exports
-     * [2]: https://nodejs.org/api/packages.html#subpath-imports
-     * [3]: https://nodejs.org/api/url.html#urlhost
-     * [4]: https://nodejs.org/api/url.html#urlpathname
-     * [5]: https://nodejs.org/api/url.html#urlport
-     */
-    path: string;
-    /**
-     * Package name if module id begins with valid package name (e.g. is a [bare
-     * specifier][1]).
-     *
-     * If the module id is a bare specifier *and* [internal][2], this value will
-     * instead be the first path segement in the module id (i.e. `'#src'` given
-     * `'#src/foo'`). This **may or may not** be the subpath defined by the
-     * package maintainer.
-     *
-     * [1]: https://nodejs.org/api/esm.html#terminology
-     * [2]: https://nodejs.org/api/packages.html#subpath-imports
-     */
-    pkg: LiteralUnion<EmptyString, string>;
-    /**
-     * URL scheme if module id is a URL.
-     */
-    protocol: LiteralUnion<EmptyString | Protocol, string>;
-    /**
-     * Raw module id.
-     */
-    raw: string;
-    /**
-     * Package scope if module id begins with valid package name (e.g. is a [bare
-     * specifier][1]).
-     *
-     * [1]: https://nodejs.org/api/esm.html#terminology
-     */
-    scope: LiteralUnion<EmptyString, string>;
-    /**
-     * Package version if specified and module id begins with valid package name
-     * (e.g. is a [bare specifier][1]).
-     *
-     * **Note**: Version follows [Semantic Versioning 2.0.0][2] specification.
-     *
-     * [1]: https://nodejs.org/api/esm.html#terminology
-     * [2]: https://semver.org/spec/v2.0.0.html
-     */
-    version: LiteralUnion<EmptyString | SemanticVersion, string>;
-    /**
-     * Package {@linkcode version} prefix.
-     */
-    version_prefix: LiteralUnion<EmptyString | 'v', string>;
-}
-export type { ParsedModuleId as default };

package/dist/interfaces/parsed-subpath.d.mts

@@ -1,44 +0,0 @@
-/**
- * @file Interfaces - ParsedSubpath
- * @module mlly/interfaces/ParsedSubpath
- */
-import type { EmptyString, LiteralUnion, Nullable } from '@flex-development/tutils';
-/**
- * Object representing a package subpath.
- *
- * @see https://nodejs.org/api/packages.html#subpath-exports
- * @see https://nodejs.org/api/packages.html#subpath-imports
- */
-interface ParsedSubpath {
-    /**
-     * Subpath without entry prefix ({@linkcode key}).
-     */
-    base: LiteralUnion<EmptyString, string>;
-    /**
-     * Subpath import check.
-     *
-     * @see https://nodejs.org/api/packages.html#imports
-     * @see https://nodejs.org/api/packages.html#subpath-imports
-     */
-    internal: boolean;
-    /**
-     * Subpath defined in `package.json` file.
-     *
-     * @see https://nodejs.org/api/packages.html#exports
-     * @see https://nodejs.org/api/packages.html#imports
-     */
-    key: string;
-    /**
-     * Subpath passed by user in module specifier.
-     */
-    raw: string;
-    /**
-     * Module specifier passed by user.
-     */
-    specifier: string;
-    /**
-     * Package target as documented in `package.json` file.
-     */
-    target: Nullable<string>;
-}
-export type { ParsedSubpath as default };