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

package/src/utils/extract-statements.ts

@@ -1,46 +0,0 @@
-/**
- * @file extractStatements
- * @module mlly/utils/extractStatements
- */
-
-import type { Statement } from '#src/interfaces'
-import validateString from '#src/internal/validate-string'
-import type { NodeError } from '@flex-development/errnode'
-import { sort, trim } from '@flex-development/tutils'
-import findDynamicImports from './find-dynamic-imports'
-import findExports from './find-exports'
-import findRequires from './find-requires'
-import findStaticImports from './find-static-imports'
-
-/**
- * Finds all `export`, `import`, and/or  `require` statements in `code`.
- *
- * Ignores matches in comments.
- *
- * @see {@linkcode findDynamicImports}
- * @see {@linkcode findExports}
- * @see {@linkcode findRequires}
- * @see {@linkcode findStaticImports}
- *
- * @param {string} [code=''] - Code to evaluate
- * @return {Statement[]} Extracted statements
- * @throws {NodeError<TypeError>} If `code` is not a string
- */
-const extractStatements = (code: string = ''): Statement[] => {
-  validateString(code, 'code')
-
-  // code shorter than first shortest keyword => no possible matches
-  if (trim(code).length < 'export'.length) return []
-
-  return sort(
-    [
-      ...findDynamicImports(code),
-      ...findExports(code),
-      ...findRequires(code),
-      ...findStaticImports(code)
-    ],
-    (s1: Statement, s2: Statement): number => s1.start - s2.start
-  )
-}
-
-export default extractStatements

package/src/utils/fill-modules.ts

@@ -1,133 +0,0 @@
-/**
- * @file fillModules
- * @module mlly/utils/fillModules
- */
-
-import { SpecifierSyntaxKind } from '#src/enums'
-import type { FillModuleOptions } from '#src/interfaces'
-import validateArraySet from '#src/internal/validate-array-set'
-import validateURLString from '#src/internal/validate-url-string'
-import {
-  ERR_UNKNOWN_FILE_EXTENSION,
-  type NodeError
-} from '@flex-development/errnode'
-import pathe from '@flex-development/pathe'
-import {
-  DOT,
-  isFunction,
-  regexp,
-  trim,
-  type Optional
-} from '@flex-development/tutils'
-import type { URL } from 'node:url'
-import CONDITIONS from './conditions'
-import extractStatements from './extract-statements'
-import isAbsoluteSpecifier from './is-absolute-specifier'
-import isBareSpecifier from './is-bare-specifier'
-import resolveModule from './resolve-module'
-import toBareSpecifier from './to-bare-specifier'
-import toRelativeSpecifier from './to-relative-specifier'
-
-/**
- * Ensures all absolute and relative module specifiers in the given piece of
- * source `code` are fully specified.
- *
- * Ignores specifiers that already have file extensions.
- *
- * @see {@linkcode FillModuleOptions}
- * @see https://nodejs.org/api/esm.html#mandatory-file-extensions
- * @see https://nodejs.org/api/esm.html#terminology
- *
- * @async
- *
- * @param {string} code - Code to evaluate
- * @param {FillModuleOptions} options - Module fill options
- * @return {Promise<string>} `code` with fully specified module specifiers
- * @throws {NodeError<TypeError>}
- */
-const fillModules = async (
-  code: string,
-  options: FillModuleOptions
-): Promise<string> => {
-  const { conditions = CONDITIONS, ext, parent = import.meta.url } = options
-
-  // validate options
-  validateArraySet(conditions, 'options.conditions')
-  validateURLString(parent, 'options.parent')
-
-  // ensure specifiers have file extensions
-  for (const statement of extractStatements(code)) {
-    if (statement.specifier) {
-      if (statement.specifier_syntax !== SpecifierSyntaxKind.DYNAMIC) {
-        /**
-         * Resolved module URL.
-         *
-         * @const {URL} url
-         */
-        const url: URL = await resolveModule(statement.specifier, {
-          ...options,
-          /**
-           * Returns a replacement file extension for the given `specifier` if
-           * it is non-bare and does not already have an extension.
-           *
-           * Throws [`ERR_UNKNOWN_FILE_EXTENSION`][1] if the new extension is
-           * `null`, `undefined`, an empty string, or a dot character (`'.'`).
-           *
-           * [1]: https://nodejs.org/api/errors.html#err_unknown_file_extension
-           *
-           * @async
-           *
-           * @param {string} specifier - Module specifier
-           * @param {URL} url - Resolved module URL
-           * @return {Promise<Optional<string>>} New file extension
-           */
-          async ext(specifier: string, url: URL): Promise<Optional<string>> {
-            // skip replacement for bare specifiers
-            if (isBareSpecifier(specifier)) return void 0
-
-            // skip replacement for specifiers that are already fully specified
-            if (pathe.extname(specifier) === pathe.extname(url.href)) {
-              return void 0
-            }
-
-            /**
-             * Replacement file extension.
-             *
-             * @var {string} rext
-             */
-            const rext: string = isFunction(ext)
-              ? await ext(specifier, url)
-              : ext
-
-            // ensure replacement extension is non-empty and non-dot ('.')
-            if (!(rext && trim(rext).length > (rext.startsWith(DOT) ? 1 : 0))) {
-              throw new ERR_UNKNOWN_FILE_EXTENSION(rext, specifier)
-            }
-
-            return rext
-          }
-        })
-
-        // replace original module specifier
-        code = code.replace(
-          statement.code,
-          statement.code.replace(
-            new RegExp(`(?<=["'])${regexp(statement.specifier)}(?=["'])`),
-            // convert module url back to absolute, bare, or relative specifier
-            statement.specifier.startsWith('#')
-              ? statement.specifier
-              : isAbsoluteSpecifier(statement.specifier)
-              ? url.href
-              : isBareSpecifier(statement.specifier)
-              ? toBareSpecifier(url, parent, new Set(conditions))
-              : toRelativeSpecifier(url, parent)
-          )
-        )
-      }
-    }
-  }
-
-  return code
-}
-
-export default fillModules

package/src/utils/find-dynamic-imports.ts

@@ -1,75 +0,0 @@
-/**
- * @file findDynamicImports
- * @module mlly/utils/findDynamicImports
- */
-
-import {
-  SpecifierSyntaxKind,
-  StatementKind,
-  StatementSyntaxKind
-} from '#src/enums'
-import type { DynamicImport } from '#src/interfaces'
-import dequote from '#src/internal/dequote'
-import getSpecifierKind from '#src/internal/get-specifier-kind'
-import validateString from '#src/internal/validate-string'
-import type { NodeError } from '@flex-development/errnode'
-import { DYNAMIC_IMPORT_REGEX } from '@flex-development/import-regex'
-import { split, trim } from '@flex-development/tutils'
-
-/**
- * Finds all dynamic import statements in `code`. Ignores matches in comments.
- *
- * @see {@linkcode DynamicImport}
- * @see https://regex101.com/r/PTPAvU
- * @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Operators/import
- *
- * @param {string} [code=''] - Code to evaluate
- * @return {DynamicImport[]} Dynamic import statement objects
- * @throws {NodeError<TypeError>} If `code` is not a string
- */
-const findDynamicImports = (code: string = ''): DynamicImport[] => {
-  validateString(code, 'code')
-
-  return [...code.matchAll(DYNAMIC_IMPORT_REGEX)].map(match => {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const {
-      expression = '',
-      imports = '',
-      options = '',
-      specifier = ''
-    } = groups
-
-    /**
-     * Module specifier syntax.
-     *
-     * @const {SpecifierSyntaxKind} specifier_syntax
-     */
-    const specifier_syntax: SpecifierSyntaxKind = /^["']/.test(specifier)
-      ? SpecifierSyntaxKind.STATIC
-      : SpecifierSyntaxKind.DYNAMIC
-
-    return {
-      code,
-      end: start + code.length,
-      expression,
-      imports:
-        imports === ''
-          ? []
-          : split(imports.replace(/^{|}$/g, ''), ',')
-              .map(trim)
-              .filter(e => !!e.length),
-      kind: StatementKind.IMPORT,
-      options,
-      specifier: dequote(specifier),
-      specifier_kind:
-        specifier_syntax === SpecifierSyntaxKind.DYNAMIC
-          ? null
-          : getSpecifierKind(specifier),
-      specifier_syntax,
-      start,
-      syntax: StatementSyntaxKind.DYNAMIC
-    }
-  })
-}
-
-export default findDynamicImports

package/src/utils/find-exports.ts

@@ -1,156 +0,0 @@
-/**
- * @file findExports
- * @module mlly/utils/findExports
- */
-
-import {
-  SpecifierSyntaxKind,
-  StatementKind,
-  StatementSyntaxKind
-} from '#src/enums'
-import type { ExportStatement } from '#src/interfaces'
-import getSpecifierKind from '#src/internal/get-specifier-kind'
-import validateString from '#src/internal/validate-string'
-import type { NodeError } from '@flex-development/errnode'
-import {
-  EXPORT_AGGREGATE_REGEX,
-  EXPORT_DECLARATION_REGEX,
-  EXPORT_DEFAULT_REGEX,
-  EXPORT_LIST_REGEX
-} from '@flex-development/export-regex'
-import { cast, sort, split, trim } from '@flex-development/tutils'
-
-/**
- * Finds all export statements in `code`. Ignores matches in comments.
- *
- * @see {@linkcode ExportStatement}
- * @see https://regex101.com/r/JtvRUt
- * @see https://regex101.com/r/8HpMrA
- * @see https://regex101.com/r/G7GhEt
- * @see https://regex101.com/r/KQEDdZ
- * @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/export
- *
- * @param {string} [code=''] - Code to evaluate
- * @return {ExportStatement[]} Export statement objects
- * @throws {NodeError<TypeError>} If `code` is not a string
- */
-const findExports = (code: string = ''): ExportStatement[] => {
-  validateString(code, 'code')
-
-  /**
-   * `export` statement objects.
-   *
-   * @const {ExportStatement[]} statements
-   */
-  const statements: ExportStatement[] = []
-
-  // get aggregate export statements
-  for (const match of code.matchAll(EXPORT_AGGREGATE_REGEX)) {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { exports = '', specifier = '', type = '' } = groups
-
-    statements.push({
-      code,
-      declaration: null,
-      end: start + code.length,
-      exports: exports.startsWith('*')
-        ? [exports]
-        : split(exports.replace(/^{|}$/g, ''), ',')
-            .map(trim)
-            .filter(e => !!e.length),
-      kind: StatementKind.EXPORT,
-      modifiers: [],
-      specifier,
-      specifier_kind: getSpecifierKind(specifier),
-      specifier_syntax: SpecifierSyntaxKind.STATIC,
-      start,
-      syntax: exports.startsWith('{')
-        ? StatementSyntaxKind.NAMED
-        : StatementSyntaxKind.NAMESPACE,
-      type: !!type
-    })
-  }
-
-  // get declaration export statements
-  for (const match of code.matchAll(EXPORT_DECLARATION_REGEX)) {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { declaration = '', exports = '', modifiers = '' } = groups
-
-    statements.push({
-      code,
-      declaration: cast(declaration),
-      end: start + code.length,
-      exports: /^\w+$/.test(exports)
-        ? [exports]
-        : split(exports.replace(/^[[{]|[\]}]$/g, ''), ',')
-            .map(e => trim(e).replace(/\s*=\s*.*$/, ''))
-            .filter(e => !!e.length),
-      kind: StatementKind.EXPORT,
-      modifiers:
-        modifiers === ''
-          ? []
-          : split(modifiers, ' ')
-              .map(trim)
-              .filter(e => !!e.length),
-      specifier: null,
-      specifier_kind: null,
-      specifier_syntax: null,
-      start,
-      syntax: StatementSyntaxKind.DECLARATION,
-      type: false
-    })
-  }
-
-  // get export default statements
-  for (const match of code.matchAll(EXPORT_DEFAULT_REGEX)) {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { exports = '', kind: declaration = '', modifiers = '' } = groups
-
-    statements.push({
-      code,
-      declaration: declaration ? cast(declaration) : null,
-      end: start + code.length,
-      exports: exports === '' ? [] : [exports],
-      kind: StatementKind.EXPORT,
-      modifiers:
-        modifiers === ''
-          ? []
-          : split(modifiers, ' ')
-              .map(trim)
-              .filter(e => !!e.length),
-      specifier: null,
-      specifier_kind: null,
-      specifier_syntax: null,
-      start,
-      syntax: StatementSyntaxKind.DEFAULT,
-      type: false
-    })
-  }
-
-  // get list export statements
-  for (const match of code.matchAll(EXPORT_LIST_REGEX)) {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { exports = '', type = '' } = groups
-
-    statements.push({
-      code,
-      declaration: null,
-      end: start + code.length,
-      exports: split(exports.replace(/^{|}$/g, ''), ',')
-        .map(trim)
-        .filter(e => !!e.length),
-      kind: StatementKind.EXPORT,
-      modifiers: [],
-      specifier: null,
-      specifier_kind: null,
-      specifier_syntax: null,
-      start,
-      syntax: StatementSyntaxKind.LIST,
-      type: !!type
-    })
-  }
-
-  return sort(statements, (s1, s2): number => s1.start - s2.start)
-}
-
-export default findExports

package/src/utils/find-requires.ts

@@ -1,75 +0,0 @@
-/**
- * @file findRequires
- * @module mlly/utils/findRequires
- */
-
-import {
-  SpecifierSyntaxKind,
-  StatementKind,
-  StatementSyntaxKind
-} from '#src/enums'
-import type { RequireStatement } from '#src/interfaces'
-import dequote from '#src/internal/dequote'
-import getSpecifierKind from '#src/internal/get-specifier-kind'
-import validateString from '#src/internal/validate-string'
-import type { NodeError } from '@flex-development/errnode'
-import { split, trim } from '@flex-development/tutils'
-
-/**
- * Finds all `require` statements in `code`. Ignores matches in comments.
- *
- * @see {@linkcode RequireStatement}
- * @see https://regex101.com/r/uCqSYB
- * @see https://nodejs.org/api/modules.html#requireid
- *
- * @param {string} [code=''] - Code to evaluate
- * @return {RequireStatement[]} Require statement objects
- * @throws {NodeError<TypeError>} If `code` is not a string
- */
-const findRequires = (code: string = ''): RequireStatement[] => {
-  validateString(code, 'code')
-
-  /**
-   * `require` statement regex.
-   *
-   * @const {RegExp} REQUIRE_REGEX
-   */
-  const REQUIRE_REGEX: RegExp =
-    /(?<=^|[\s,:;([])\b(?:(?:const\s*|let\s*|var\s*)?(?:(?<=(?:const\s*|let\s*|var\s*))(?<imports>(?:[$_\p{ID_Start}][$\u200C\u200D\p{ID_Continue}]*)|(?:[\w\t\n\r "$'*,./:{}-]+?)))?\s*=?\s*(?<kind>require)\((?<specifier>["']?[\S\t\n\r]+?["']?)\))(?<!(?:\/\/|\*).*)/gu
-
-  return [...code.matchAll(REQUIRE_REGEX)].map(match => {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { imports = '', specifier = '' } = groups
-
-    /**
-     * Module specifier syntax.
-     *
-     * @const {SpecifierSyntaxKind} specifier_syntax
-     */
-    const specifier_syntax: SpecifierSyntaxKind = /^["']/.test(specifier)
-      ? SpecifierSyntaxKind.STATIC
-      : SpecifierSyntaxKind.DYNAMIC
-
-    return {
-      code,
-      end: start + code.length,
-      imports:
-        imports === ''
-          ? []
-          : split(imports.replace(/^{|}$/g, ''), ',')
-              .map(trim)
-              .filter(e => !!e.length),
-      kind: StatementKind.REQUIRE,
-      specifier: dequote(specifier),
-      specifier_kind:
-        specifier_syntax === SpecifierSyntaxKind.DYNAMIC
-          ? null
-          : getSpecifierKind(specifier),
-      specifier_syntax,
-      start,
-      syntax: StatementSyntaxKind.REQUIRE
-    }
-  })
-}
-
-export default findRequires

package/src/utils/find-static-imports.ts

@@ -1,86 +0,0 @@
-/**
- * @file findStaticImports
- * @module mlly/utils/findStaticImports
- */
-
-import {
-  SpecifierSyntaxKind,
-  StatementKind,
-  StatementSyntaxKind
-} from '#src/enums'
-import type { StaticImport } from '#src/interfaces'
-import getSpecifierKind from '#src/internal/get-specifier-kind'
-import validateString from '#src/internal/validate-string'
-import type { NodeError } from '@flex-development/errnode'
-import { STATIC_IMPORT_REGEX } from '@flex-development/import-regex'
-import { split, trim } from '@flex-development/tutils'
-
-/**
- * Finds all static import statements in `code`. Ignores matches in comments.
- *
- * @see {@linkcode StaticImport}
- * @see https://regex101.com/r/wlYQUN
- * @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/import
- *
- * @param {string} [code=''] - Code to evaluate
- * @return {StaticImport[]} Static import statement objects
- * @throws {NodeError<TypeError>} If `code` is not a string
- */
-const findStaticImports = (code: string = ''): StaticImport[] => {
-  validateString(code, 'code')
-
-  return [...code.matchAll(STATIC_IMPORT_REGEX)].map(match => {
-    const { 0: code = '', index: start = 0, groups = {} } = match
-    const { assertion = '', imports = '', specifier = '', type = '' } = groups
-
-    /**
-     * Statement syntax kind.
-     *
-     * @const {StaticImport['syntax']} syntax
-     */
-    const syntax: StaticImport['syntax'] =
-      imports === ''
-        ? StatementSyntaxKind.SIDE_EFFECT
-        : imports.startsWith('* as')
-        ? StatementSyntaxKind.NAMESPACE
-        : imports.startsWith('{')
-        ? StatementSyntaxKind.NAMED
-        : /^\w+$/.test(imports)
-        ? StatementSyntaxKind.DEFAULT
-        : /^\w+,\s*{/.test(imports)
-        ? StatementSyntaxKind.DEFAULT_WITH_NAMED
-        : StatementSyntaxKind.DEFAULT_WITH_NAMESPACE
-
-    return {
-      assertion,
-      code,
-      end: start + code.length,
-      imports:
-        syntax === StatementSyntaxKind.SIDE_EFFECT
-          ? []
-          : syntax === StatementSyntaxKind.NAMED
-          ? split(imports.replace(/^{|}$/g, ''), ',')
-              .map(trim)
-              .filter(i => !!i.length)
-          : syntax === StatementSyntaxKind.DEFAULT_WITH_NAMED
-          ? split(imports, ',')
-              .map(i => trim(i).replace(/^{|}$/g, ''))
-              .map(trim)
-              .filter(i => !!i.length)
-          : syntax === StatementSyntaxKind.DEFAULT_WITH_NAMESPACE
-          ? split(imports, ',')
-              .map(trim)
-              .filter(i => !!i.length)
-          : [imports],
-      kind: StatementKind.IMPORT,
-      specifier,
-      specifier_kind: getSpecifierKind(specifier),
-      specifier_syntax: SpecifierSyntaxKind.STATIC,
-      start,
-      syntax,
-      type: !!type
-    }
-  })
-}
-
-export default findStaticImports