@flex-development/mlly 1.0.0-alpha.16 → 1.0.0-alpha.18

package/src/interfaces/import-assertions.ts

@@ -1,24 +0,0 @@
-/**
- * @file Interfaces - ImportAssertions
- * @module mlly/interfaces/ImportAssertions
- */
-
-import type { AssertType } from '#src/enums'
-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/src/interfaces/import-dynamic.ts

@@ -1,46 +0,0 @@
-/**
- * @file Interfaces - DynamicImport
- * @module mlly/interfaces/DynamicImport
- */
-
-import type { StatementSyntaxKind } from '#src/enums'
-import type { EmptyString, LiteralUnion } from '@flex-development/tutils'
-import type ImportStatement from './statement-import'
-
-/**
- * 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/src/interfaces/import-static.ts

@@ -1,46 +0,0 @@
-/**
- * @file Interfaces - StaticImport
- * @module mlly/interfaces/StaticImport
- */
-
-import type { StatementSyntaxKind } from '#src/enums'
-import type { EmptyString, LiteralUnion } from '@flex-development/tutils'
-import type ImportStatement from './statement-import'
-
-/**
- * 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/src/interfaces/index.ts

@@ -1,25 +0,0 @@
-/**
- * @file Interfaces
- * @module mlly/interfaces
- */
-
-export type { default as ImportAssertions } from './import-assertions'
-export type { default as DynamicImport } from './import-dynamic'
-export type { default as StaticImport } from './import-static'
-export type { default as FillModuleOptions } from './options-fill-module'
-export type { default as FindSubpathOptions } from './options-find-subpath'
-export type { default as GetFormatOptions } from './options-get-format'
-export type { default as GetSourceOptions } from './options-get-source'
-export type { default as ParseModuleIdOptions } from './options-parse-module-id'
-export type { default as ParseSubpathOptions } from './options-parse-subpath'
-export type { default as ResolveOptions } from './options-resolve'
-export type { default as ResolveAliasOptions } from './options-resolve-alias'
-export type { default as ResolveModuleOptions } from './options-resolve-module'
-export type { default as PackageScope } from './package-scope'
-export type { default as ParsedDataUrl } from './parsed-data-url'
-export type { default as ParsedModuleId } from './parsed-module-id'
-export type { default as ParsedSubpath } from './parsed-subpath'
-export type { default as Statement } from './statement'
-export type { default as ExportStatement } from './statement-export'
-export type { default as ImportStatement } from './statement-import'
-export type { default as RequireStatement } from './statement-require'

package/src/interfaces/options-fill-module.ts

@@ -1,26 +0,0 @@
-/**
- * @file Interfaces - FillModuleOptions
- * @module mlly/interfaces/FillModuleOptions
- */
-
-import type { ChangeExtFn } from '#src/types'
-import type ResolveModuleOptions from './options-resolve-module'
-
-/**
- * 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/src/interfaces/options-find-subpath.ts

@@ -1,57 +0,0 @@
-/**
- * @file Interfaces - FindSubpathOptions
- * @module mlly/interfaces/FindSubpathOptions
- */
-
-import type { ModuleId } from '#src/types'
-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/src/interfaces/options-get-format.ts

@@ -1,80 +0,0 @@
-/**
- * @file Interfaces - GetFormatOptions
- * @module mlly/interfaces/GetFormatOptions
- */
-
-import type { Format } from '#src/enums'
-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 {}
-   */
-  req?: Optional<import('node-fetch').RequestInit>
-}
-
-export type { GetFormatOptions as default }

package/src/interfaces/options-get-source.ts

@@ -1,59 +0,0 @@
-/**
- * @file Interfaces - GetSourceOptions
- * @module mlly/interfaces/GetSourceOptions
- */
-
-import type { Format } from '#src/enums'
-import type { Optional, OrLowercase } from '@flex-development/tutils'
-
-/**
- * Source code retrieval options.
- *
- * @see {@linkcode Format}
- * @see {@linkcode RequestInit}
- */
-interface GetSourceOptions {
-  /**
-   * 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>
-
-  /**
-   * Module format hint.
-   *
-   * @see {@linkcode Format}
-   *
-   * @default undefined
-   */
-  format?: Optional<OrLowercase<Format>>
-
-  /**
-   * 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?: Optional<boolean>
-
-  /**
-   * Request options for network based modules.
-   *
-   * Only applicable if {@linkcode experimental_network_imports} is enabled.
-   *
-   * @see {@linkcode RequestInit}
-   *
-   * @default {}
-   */
-  req?: Optional<import('node-fetch').RequestInit>
-}
-
-export type { GetSourceOptions as default }

package/src/interfaces/options-parse-module-id.ts

@@ -1,39 +0,0 @@
-/**
- * @file Interfaces - ParseModuleIdOptions
- * @module mlly/interfaces/ParseModuleIdOptions
- */
-
-import type { ModuleId } from '#src/types'
-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/src/interfaces/options-parse-subpath.ts

@@ -1,57 +0,0 @@
-/**
- * @file Interfaces - ParseSubpathOptions
- * @module mlly/interfaces/ParseSubpathOptions
- */
-
-import type { ModuleId } from '#src/types'
-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/src/interfaces/options-resolve-alias.ts

@@ -1,59 +0,0 @@
-/**
- * @file Interfaces - ResolveAliasOptions
- * @module mlly/interfaces/ResolveAliasOptions
- */
-
-import type { ModuleId } from '#src/types'
-import type { MapLike, OneOrMany, Optional } from '@flex-development/tutils'
-import type ResolveModuleOptions from './options-resolve-module'
-
-/**
- * Path alias resolution options.
- *
- * @see {@linkcode ModuleId}
- *
- * @extends {ResolveModuleOptions}
- */
-interface ResolveAliasOptions extends ResolveModuleOptions {
-  /**
-   * Return resolved module URL as absolute specifier (a [`file:` URL][1]).
-   *
-   * If `false`, return resolved module URL as bare or relative specifier.
-   *
-   * [1]: https://nodejs.org/api/esm.html#file-urls
-   *
-   * @see https://nodejs.org/api/esm.html#terminology
-   *
-   * @default true
-   */
-  absolute?: Optional<boolean>
-
-  /**
-   * Path mappings.
-   *
-   * **Note**: Paths should be relative to {@linkcode cwd}.
-   *
-   * @default {}
-   */
-  aliases?: Optional<MapLike<OneOrMany<string>>>
-
-  /**
-   * Directory to resolve non-absolute modules from.
-   *
-   * @default pathToFileURL('.')
-   */
-  cwd?: Optional<ModuleId>
-
-  /**
-   * 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
-   */
-  parent?: Optional<ModuleId>
-}
-
-export type { ResolveAliasOptions as default }

package/src/interfaces/options-resolve-module.ts

@@ -1,72 +0,0 @@
-/**
- * @file Interfaces - ResolveModuleOptions
- * @module mlly/interfaces/ResolveModuleOptions
- */
-
-import type { ChangeExtFn, ModuleId } from '#src/types'
-import type { Nilable, Optional } 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?: 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[]>
-
-  /**
-   * 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?: Optional<Set<string> | string[]>
-
-  /**
-   * URL of module to resolve from.
-   *
-   * @see {@linkcode ModuleId}
-   *
-   * @default import.meta.url
-   */
-  parent?: Optional<ModuleId>
-
-  /**
-   * Keep symlinks instead of resolving them.
-   *
-   * @default false
-   */
-  preserveSymlinks?: Optional<boolean>
-}
-
-export type { ResolveModuleOptions as default }

package/src/interfaces/options-resolve.ts

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

package/src/interfaces/package-scope.ts

@@ -1,30 +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 }