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

package/src/interfaces/statement-export.ts

@@ -1,52 +0,0 @@
-/**
- * @file Interfaces - ExportStatement
- * @module mlly/interfaces/ExportStatement
- */
-
-import type { StatementKind } from '#src/enums'
-import type { Declaration, SyntaxKindExport } from '#src/types'
-import type { Nullable } from '@flex-development/tutils'
-import type Statement from './statement'
-
-/**
- * Export statement object.
- *
- * @see {@linkcode Declaration}
- * @see {@linkcode Statement}
- * @see {@linkcode SyntaxKindExport}
- *
- * @extends {Statement}
- */
-interface ExportStatement extends Statement {
-  /**
-   * Export declaration, if any.
-   */
-  declaration: Nullable<Declaration>
-
-  /**
-   * Export names.
-   */
-  exports: string[]
-
-  /**
-   * Statement kind.
-   */
-  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/src/interfaces/statement-import.ts

@@ -1,45 +0,0 @@
-/**
- * @file Interfaces - ImportStatement
- * @module mlly/interfaces/ImportStatement
- */
-
-import type { StatementKind } from '#src/enums'
-import type { SyntaxKindImport } from '#src/types'
-import type Statement from './statement'
-
-/**
- * Import statement object.
- *
- * @see {@linkcode Statement}
- * @see {@linkcode SyntaxKindImport}
- *
- * @extends {Statement}
- */
-interface ImportStatement extends Statement {
-  /**
-   * Import names.
-   */
-  imports: string[]
-
-  /**
-   * Statement kind.
-   */
-  kind: StatementKind.IMPORT
-
-  /**
-   * Module specifier.
-   */
-  specifier: NonNullable<Statement['specifier']>
-
-  /**
-   * Module specifier syntax type.
-   */
-  specifier_syntax: NonNullable<Statement['specifier_syntax']>
-
-  /**
-   * Statement syntax kind.
-   */
-  syntax: SyntaxKindImport
-}
-
-export type { ImportStatement as default }

package/src/interfaces/statement-require.ts

@@ -1,45 +0,0 @@
-/**
- * @file Interfaces - RequireStatement
- * @module mlly/interfaces/RequireStatement
- */
-
-import type { StatementKind } from '#src/enums'
-import type { SyntaxKindRequire } from '#src/types'
-import type Statement from './statement'
-
-/**
- * Require statement object.
- *
- * @see {@linkcode Statement}
- * @see {@linkcode SyntaxKindRequire}
- *
- * @extends {Statement}
- */
-interface RequireStatement extends Statement {
-  /**
-   * Import names.
-   */
-  imports: string[]
-
-  /**
-   * Statement kind.
-   */
-  kind: StatementKind.REQUIRE
-
-  /**
-   * Module specifier.
-   */
-  specifier: NonNullable<Statement['specifier']>
-
-  /**
-   * Module specifier syntax type.
-   */
-  specifier_syntax: NonNullable<Statement['specifier_syntax']>
-
-  /**
-   * Statement syntax kind.
-   */
-  syntax: SyntaxKindRequire
-}
-
-export type { RequireStatement as default }

package/src/interfaces/statement.ts

@@ -1,64 +0,0 @@
-/**
- * @file Interfaces - Statement
- * @module mlly/interfaces/Statement
- */
-
-import type {
-  SpecifierKind,
-  SpecifierSyntaxKind,
-  StatementKind,
-  StatementSyntaxKind
-} from '#src/enums'
-import type { Nullable } from '@flex-development/tutils'
-
-/**
- * CommonJS or ESM statement object.
- *
- * @see {@linkcode SpecifierKind}
- * @see {@linkcode SpecifierSyntaxKind}
- * @see {@linkcode StatementKind}
- * @see {@linkcode StatementSyntaxKind}
- */
-interface Statement {
-  /**
-   * Statement snippet.
-   */
-  code: string
-
-  /**
-   * End index of {@linkcode code} in source content.
-   */
-  end: number
-
-  /**
-   * Statement kind.
-   */
-  kind: StatementKind
-
-  /**
-   * Module specifier.
-   */
-  specifier: Nullable<string>
-
-  /**
-   * Module specifier type.
-   */
-  specifier_kind: Nullable<SpecifierKind>
-
-  /**
-   * Module specifier syntax type.
-   */
-  specifier_syntax: Nullable<SpecifierSyntaxKind>
-
-  /**
-   * Start index of {@linkcode code} in source content.
-   */
-  start: number
-
-  /**
-   * Statement syntax kind.
-   */
-  syntax: StatementSyntaxKind
-}
-
-export type { Statement as default }

package/src/internal/dequote.ts

@@ -1,18 +0,0 @@
-/**
- * @file Internal - dequote
- * @module mlly/internal/dequote
- */
-
-import { trim } from '@flex-development/tutils'
-
-/**
- * Removes quotes from the beginning and end of a string.
- *
- * @internal
- *
- * @param {string} str - String to dequote
- * @return {string} String with quotes removed
- */
-const dequote = (str: string): string => trim(str).replace(/^["']|["']$/g, '')
-
-export default dequote

package/src/internal/format-type-map.ts

@@ -1,28 +0,0 @@
-/**
- * @file Internal - FORMAT_TYPE_MAP
- * @module mlly/internal/FORMAT_TYPE_MAP
- */
-
-import { AssertType, Format } from '#src/enums'
-
-/**
- * Module format to `import` assertion type map.
- *
- * **Note**:  It's unclear whether or not the HTML spec will require assertion
- * types for WebAssembly modules.
- *
- * @see https://github.com/WebAssembly/esm-integration/issues/42
- *
- * @internal
- *
- * @const {Map<Format, AssertType>} FORMAT_TYPE_MAP
- */
-const FORMAT_TYPE_MAP: Map<Format, AssertType> = new Map<Format, AssertType>([
-  [Format.BUILTIN, AssertType.IMPLICIT],
-  [Format.COMMONJS, AssertType.IMPLICIT],
-  [Format.JSON, AssertType.JSON],
-  [Format.MODULE, AssertType.IMPLICIT],
-  [Format.WASM, AssertType.IMPLICIT]
-])
-
-export default FORMAT_TYPE_MAP

package/src/internal/get-specifier-kind.ts

@@ -1,41 +0,0 @@
-/**
- * @file Internal - getSpecifierKind
- * @module mlly/internal/getSpecifierKind
- */
-
-import { SpecifierKind } from '#src/enums'
-import isAbsoluteSpecifier from '#src/utils/is-absolute-specifier'
-import isRelativeSpecifier from '#src/utils/is-relative-specifier'
-import type { NodeError } from '@flex-development/errnode'
-import type { Nullable } from '@flex-development/tutils'
-import dequote from './dequote'
-import validateString from './validate-string'
-
-/**
- * Determines a specifier type for the given module `specifier`.
- *
- * @see {@linkcode SpecifierKind}
- *
- * @internal
- *
- * @param {string} specifier - Module specifier to evaluate
- * @return {Nullable<SpecifierKind>} Module `specifier` type or `null`
- * @throws {NodeError<TypeError>} If `specifier` is not a string
- */
-const getSpecifierKind = (specifier: string): Nullable<SpecifierKind> => {
-  validateString(specifier, 'specifier')
-
-  // dequote specifier (quotes could lead to a specifier being classified as
-  // 'bare' when it is actually absolute or relative)
-  specifier = dequote(specifier)
-
-  return specifier
-    ? isAbsoluteSpecifier(specifier)
-      ? SpecifierKind.ABSOLUTE
-      : isRelativeSpecifier(specifier)
-      ? SpecifierKind.RELATIVE
-      : SpecifierKind.BARE
-    : null
-}
-
-export default getSpecifierKind

package/src/internal/get-subpaths.ts

@@ -1,43 +0,0 @@
-/**
- * @file Internal - getSubpaths
- * @module mlly/internal/getSubpaths
- */
-
-import type { ModuleId } from '#src/types'
-import isExportsSugar from '#src/utils/is-exports-sugar'
-import type { Exports, Imports } from '@flex-development/pkg-types'
-import { DOT, isNIL, keys, type Nilable } from '@flex-development/tutils'
-
-/**
- * Returns an array containing subpaths defined in the given package `context`,
- * a `package.json` [`exports`][1] or [`imports`][2] field.
- *
- * If `context` is using [exports sugar][3], the array will contain a single
- * subpath, `'.'`.
- *
- * [1]: https://nodejs.org/api/packages.html#exports
- * [2]: https://nodejs.org/api/packages.html#imports
- * [3]: https://nodejs.org/api/packages.html#exports-sugar
- *
- * @internal
- *
- * @param {Nilable<Exports | Imports>} context - Package context
- * @param {boolean} internal - Package `imports` hint
- * @param {ModuleId} pkg - URL of relevant `package.json` file
- * @param {ModuleId} parent - URL of module to resolve from
- * @return {string[]} Subpaths defined in `context`
- */
-const getSubpaths = (
-  context: Nilable<Exports | Imports>,
-  internal: boolean,
-  pkg: ModuleId,
-  parent: ModuleId
-): string[] => {
-  return isNIL(context)
-    ? []
-    : !internal && isExportsSugar(context, pkg, parent)
-    ? [DOT]
-    : keys(context)
-}
-
-export default getSubpaths

package/src/internal/regex-encoded-sep.ts

@@ -1,17 +0,0 @@
-/**
- * @file Internal - ENCODED_SEP_REGEX
- * @module mlly/internal/ENCODED_SEP_REGEX
- */
-
-/**
- * Regex pattern matching encoded path separators (e.g `/`, `\\`).
- *
- * @see https://regex101.com/r/XV7HzM
- *
- * @internal
- *
- * @const {RegExp} ENCODED_SEP_REGEX
- */
-const ENCODED_SEP_REGEX: RegExp = /%2f|%5c/i
-
-export default ENCODED_SEP_REGEX

package/src/internal/regex-internal-specifier.ts

@@ -1,19 +0,0 @@
-/**
- * @file Internal - INTERNAL_SPECIFIER_REGEX
- * @module mlly/internal/INTERNAL_SPECIFIER_REGEX
- */
-
-/**
- * Regex pattern matching subpath imports.
- *
- * @see https://regex101.com/r/ppVRw7
- * @see https://nodejs.org/api/packages.html#subpath-imports
- *
- * @internal
- *
- * @const {RegExp} INTERNAL_SPECIFIER_REGEX
- */
-const INTERNAL_SPECIFIER_REGEX: RegExp =
-  /^(?!.*(?:%2[Ff]|%5[Cc]))(?<root>#[^\s/]+?(?=\s|$|\/))(?<path>\/.+[^/](?=\s|$))?(?!\/)/
-
-export default INTERNAL_SPECIFIER_REGEX

package/src/internal/regex-invalid-segment.ts

@@ -1,25 +0,0 @@
-/**
- * @file Internal - invalidSegmentRegex
- * @module mlly/internal/invalidSegmentRegex
- */
-
-/**
- * Returns a regular expression matching invalid path segments.
- *
- * @see https://github.com/nodejs/node/blob/v19.6.1/lib/internal/modules/esm/resolve.js#L299-L300
- *
- * @internal
- *
- * @param {'deprecated'?} type - Pattern type
- * @return {RegExp} Regular expression matching invalid path segments
- */
-const invalidSegmentRegex = (type?: 'deprecated'): RegExp => {
-  return new RegExp(
-    `(^|\\\\|\\/)((\\.|%2e)(\\.|%2e)?|(n|%6e|%4e)(o|%6f|%4f)(d|%64|%44)(e|%65|%45)(_|%5f)(m|%6d|%4d)(o|%6f|%4f)(d|%64|%44)(u|%75|%55)(l|%6c|%4c)(e|%65|%45)(s|%73|%53))${
-      type === 'deprecated' ? '' : '?'
-    }(\\\\|\\/|$)`,
-    'i'
-  )
-}
-
-export default invalidSegmentRegex

package/src/internal/regex-package-name.ts

@@ -1,18 +0,0 @@
-/**
- * @file Internal - PACKAGE_NAME_REGEX
- * @module mlly/internal/PACKAGE_NAME_REGEX
- */
-
-/**
- * Regex pattern matching package names.
- *
- * @see https://regex101.com/r/BHcJfc
- *
- * @internal
- *
- * @const {RegExp} PACKAGE_NAME_REGEX
- */
-const PACKAGE_NAME_REGEX: RegExp =
-  /^(?:(?<scope>@[\d*a-z~-][\w*.~-]*)\/)?[\da-z~-][\w.~-]*$/
-
-export default PACKAGE_NAME_REGEX

package/src/internal/regex-package-path.ts

@@ -1,20 +0,0 @@
-/**
- * @file Internal - PACKAGE_PATH_REGEX
- * @module mlly/internal/PACKAGE_PATH_REGEX
- */
-
-/**
- * Regex pattern matching bare specifiers beginning with valid package names.
- *
- * **Note**: Does **not** match specifiers beginning with `'node_modules'`.
- *
- * @see https://regex101.com/r/z0MPgj
- *
- * @internal
- *
- * @const {RegExp} PACKAGE_PATH_REGEX
- */
-const PACKAGE_PATH_REGEX: RegExp =
-  /^(?!\S+:|node_modules)(?<pkg>(?:(?:(?<scope>@[\d*a-z~-][\w*.~-]*)\/)?[\da-z~-][\w.~-]*))@?(?<version_prefix>v)?(?<version>(?:(?:0|[1-9]\d*)\.){2}(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*))*)?(?:\+[\da-z-]+(?:\.[\da-z-]+)*)?)?(?<subpath>\/.*)?(?<!.*(?:%2[Ff]|%5[Cc]))/
-
-export default PACKAGE_PATH_REGEX