@knighted/module 1.0.0-rc.6 → 1.1.0

package/README.md

@@ -11,14 +11,16 @@ Node.js utility for transforming a JavaScript or TypeScript file from an ES modu
 
 Highlights
 
+- ESM ➡️ CJS and CJS ➡️ ESM with one function call.
 - Defaults to safe CommonJS output: strict live bindings, import.meta shims, and specifier preservation.
-- Opt into stricter/looser behaviors: live binding enforcement, import.meta.main gating, and top-level await strategies.
-- Can optionally rewrite relative specifiers and write transformed output to disk.
+- Configurable lowering modes: full syntax transforms or globals-only.
+- Specifier tools: add extensions, add directory indexes, or map with a custom callback.
+- Output control: write to disk (`out`/`inPlace`) or return the transformed string.
 
 > [!IMPORTANT]  
 > All parsing logic is applied under the assumption the code is in [strict mode](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Strict_mode) which [modules run under by default](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules#other_differences_between_modules_and_classic_scripts).
 
-By default `@knighted/module` transforms the one-to-one [differences between ES modules and CommonJS](https://nodejs.org/api/esm.html#differences-between-es-modules-and-commonjs). Options let you control syntax rewriting, specifier updates, and output.
+By default `@knighted/module` transforms the one-to-one [differences between ES modules and CommonJS](https://nodejs.org/api/esm.html#differences-between-es-modules-and-commonjs). Options let you control syntax rewriting (full vs globals-only), specifier updates, and output.
 
 ## Requirements
 
@@ -30,9 +32,9 @@ By default `@knighted/module` transforms the one-to-one [differences between ES
 npm install @knighted/module
 ```
 
-## Example
+## Quick examples
 
-Given an ES module:
+ESM ➡️ CJS:
 
 **file.js**
 
@@ -93,6 +95,17 @@ use@computer: $ node file.cjs
 invoked directly by node
 ```
 
+CJS ➡️ ESM:
+
+```js
+import { transform } from '@knighted/module'
+
+await transform('./file.cjs', {
+  target: 'module',
+  out: './file.mjs',
+})
+```
+
 ## Options
 
 ```ts
@@ -117,29 +130,34 @@ type ModuleOptions = {
   requireMainStrategy?: 'import-meta-main' | 'realpath'
   detectCircularRequires?: 'off' | 'warn' | 'error'
   requireSource?: 'builtin' | 'create-require'
+  importMetaPrelude?: 'off' | 'auto' | 'on'
   cjsDefault?: 'module-exports' | 'auto' | 'none'
+  idiomaticExports?: 'off' | 'safe' | 'aggressive'
   topLevelAwait?: 'error' | 'wrap' | 'preserve'
   out?: string
   inPlace?: boolean
 }
 ```
 
-Behavior notes (defaults in parentheses)
+### Behavior notes (defaults in parentheses)
 
 - `target` (`commonjs`): output module system.
 - `transformSyntax` (true): enable/disable the ESM↔CJS lowering pass; set to `'globals-only'` to rewrite module globals (`import.meta.*`, `__dirname`, `__filename`, `require.main` shims) while leaving import/export syntax untouched. In `'globals-only'`, no helpers are injected (e.g., `__requireResolve`), `require.resolve` rewrites to `import.meta.resolve`, and `idiomaticExports` is skipped. See [globals-only](#globals-only-scope).
 - `liveBindings` (`strict`): getter-based live bindings, or snapshot (`loose`/`off`).
 - `appendJsExtension` (`relative-only` when targeting ESM): append `.js` to relative specifiers; never touches bare specifiers.
 - `appendDirectoryIndex` (`index.js`): when a relative specifier ends with a slash, append this index filename (set `false` to disable).
+- `appenders` precedence: `rewriteSpecifier` runs first; if it returns a string, that result is used. If it returns `undefined` or `null`, `appendJsExtension` and `appendDirectoryIndex` still run. Bare specifiers are never modified by appenders.
 - `dirFilename` (`inject`): inject `__dirname`/`__filename`, preserve existing, or throw.
 - `importMeta` (`shim`): rewrite `import.meta.*` to CommonJS equivalents.
 - `importMetaMain` (`shim`): gate `import.meta.main` with shimming/warning/error when Node support is too old.
 - `requireMainStrategy` (`import-meta-main`): use `import.meta.main` or the realpath-based `pathToFileURL(realpathSync(process.argv[1])).href` check.
+- `importMetaPrelude` (`auto`): emit a no-op `void import.meta.filename;` touch. `on` always emits; `off` never emits; `auto` emits only when helpers that reference `import.meta.*` are synthesized (e.g., `__dirname`/`__filename` in CJS→ESM, require-main shims, createRequire helpers). Useful for bundlers/transpilers that do usage-based `import.meta` polyfilling.
 - `detectCircularRequires` (`off`): optionally detect relative static require cycles and warn/throw.
 - `topLevelAwait` (`error`): throw, wrap, or preserve when TLA appears in CommonJS output.
-- `rewriteSpecifier` (off): rewrite relative specifiers to a chosen extension or via a callback.
+- `rewriteSpecifier` (off): rewrite relative specifiers to a chosen extension or via a callback. Precedence: the callback (if provided) runs first; if it returns a string, that wins. If it returns `undefined` or `null`, the appenders still apply.
 - `requireSource` (`builtin`): whether `require` comes from Node or `createRequire`.
 - `cjsDefault` (`auto`): bundler-style default interop vs direct `module.exports`.
+- `idiomaticExports` (`safe`): when raising CJS to ESM, attempt to synthesize `export` statements directly when it is safe. `off` always uses the helper bag; `aggressive` currently matches `safe` heuristics.
 - `out`/`inPlace`: write the transformed code to a file; otherwise the function returns the transformed string only.
 - CommonJS → ESM lowering will throw on `with` statements and unshadowed `eval` calls to avoid unsound rewrites.
 

package/dist/cjs/format.cjs

@@ -607,6 +607,8 @@ const format = async (src, ast, opts) => {
   let requireMainNeedsRealpath = false;
   let needsRequireResolveHelper = false;
   const nestedRequireStrategy = opts.nestedRequireStrategy ?? 'create-require';
+  const importMetaPreludeMode = opts.importMetaPrelude ?? 'auto';
+  let importMetaRef = false;
   const shouldLowerCjs = opts.target === 'commonjs' && fullTransform;
   const shouldRaiseEsm = opts.target === 'module' && fullTransform;
   let hoistedImports = [];
@@ -654,6 +656,10 @@ const format = async (src, ast, opts) => {
             const mainExpr = requireMainStrategy === 'import-meta-main' ? 'import.meta.main' : 'import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href';
             if (requireMainStrategy === 'realpath') {
               requireMainNeedsRealpath = true;
+              importMetaRef = true;
+            }
+            if (requireMainStrategy === 'import-meta-main') {
+              importMetaRef = true;
             }
             code.update(node.start, node.end, negate ? `!(${mainExpr})` : mainExpr);
             return;
@@ -772,6 +778,9 @@ const format = async (src, ast, opts) => {
         }
       }
       if ((0, _identifier2.isIdentifierName)(node)) {
+        if (shouldRaiseEsm && node.type === 'Identifier' && (node.name === '__dirname' || node.name === '__filename')) {
+          importMetaRef = true;
+        }
         (0, _identifier.identifier)({
           node,
           ancestors,
@@ -827,8 +836,14 @@ const format = async (src, ast, opts) => {
     const asExportName = name => isValidExportName(name) ? name : JSON.stringify(name);
     const accessProp = name => isValidExportName(name) ? `${_exports.exportsRename}.${name}` : `${_exports.exportsRename}[${JSON.stringify(name)}]`;
     const exportValueFor = name => {
-      if (name === '__dirname') return 'import.meta.dirname';
-      if (name === '__filename') return 'import.meta.filename';
+      if (name === '__dirname') {
+        importMetaRef = true;
+        return 'import.meta.dirname';
+      }
+      if (name === '__filename') {
+        importMetaRef = true;
+        return 'import.meta.filename';
+      }
       return name;
     };
     const tempNameFor = name => {
@@ -884,6 +899,9 @@ const format = async (src, ast, opts) => {
   }
   if (shouldRaiseEsm && fullTransform) {
     const importPrelude = [];
+    if (needsCreateRequire || needsRequireResolveHelper) {
+      importMetaRef = true;
+    }
     if (needsCreateRequire || needsRequireResolveHelper) {
       importPrelude.push('import { createRequire } from "node:module";\n');
     }
@@ -916,9 +934,13 @@ const format = async (src, ast, opts) => {
     const exportsBagInit = useExportsBag ? `let ${_exports.exportsRename} = {};
 ` : '';
     const modulePrelude = '';
-    const prelude = `${importPrelude.join('')}${importPrelude.length ? '\n' : ''}${setupPrelude.join('')}${setupPrelude.length ? '\n' : ''}${requireInit}${requireResolveInit}${exportsBagInit}${modulePrelude}void import.meta.filename;
-`;
-    code.prepend(prelude);
+    const prelude = `${importPrelude.join('')}${importPrelude.length ? '\n' : ''}${setupPrelude.join('')}${setupPrelude.length ? '\n' : ''}${requireInit}${requireResolveInit}${exportsBagInit}${modulePrelude}`;
+    const importMetaTouch = (() => {
+      if (importMetaPreludeMode === 'on') return 'void import.meta.filename;\n';
+      if (importMetaPreludeMode === 'off') return '';
+      return importMetaRef ? 'void import.meta.filename;\n' : '';
+    })();
+    code.prepend(`${prelude}${importMetaTouch}`);
   }
   if (opts.target === 'commonjs' && fullTransform && containsTopLevelAwait) {
     const body = code.toString();

package/dist/cjs/module.cjs

@@ -47,7 +47,7 @@ const rewriteSpecifierValue = (value, rewriteSpecifier) => {
   const collapsed = collapseSpecifier(value);
   const relative = /^(?:\.\.?)\//;
   if (relative.test(collapsed)) {
-    return value.replace(/(.+)\.(?:m|c)?(?:j|t)s([)'"]*)?$/, `$1${rewriteSpecifier}$2`);
+    return value.replace(/(.+)\.(?:m|c)?(?:j|t)sx?([)'"]*)?$/, `$1${rewriteSpecifier}$2`);
   }
 };
 const normalizeBuiltinSpecifier = value => {
@@ -161,6 +161,7 @@ const defaultOptions = {
   nestedRequireStrategy: 'create-require',
   cjsDefault: 'auto',
   idiomaticExports: 'safe',
+  importMetaPrelude: 'auto',
   topLevelAwait: 'error',
   out: undefined,
   inPlace: false

package/dist/cjs/specifier.cjs

@@ -118,6 +118,9 @@ const formatSpecifiers = async (src, ast, cb) => {
   };
   await (0, _walk.walk)(ast.program, {
     enter(node) {
+      if (node.type === 'ImportExpression') {
+        formatExpression(node);
+      }
       if (node.type === 'ExpressionStatement') {
         const {
           expression

package/dist/cjs/types.d.cts

@@ -21,7 +21,8 @@ export type ModuleOptions = {
     appendJsExtension?: 'off' | 'relative-only' | 'all';
     /** Add directory index (e.g. /index.js) or disable. */
     appendDirectoryIndex?: string | false;
-    /** Control __dirname and __filename handling. */
+    /** Precedence: rewriteSpecifier runs first; if it returns a string that wins. If it returns undefined or null, appenders apply. Bare specifiers are never modified by appenders. */
+    /** Control __dirname/__filename handling (inject shims, preserve existing, or throw on use). */
     dirFilename?: 'inject' | 'preserve' | 'error';
     /** How to treat import.meta. */
     importMeta?: 'preserve' | 'shim' | 'error';
@@ -39,6 +40,8 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Emit idiomatic exports when raising CJS to ESM. */
     idiomaticExports?: 'off' | 'safe' | 'aggressive';
+    /** Control whether a no-op import.meta prelude is emitted. */
+    importMetaPrelude?: 'off' | 'auto' | 'on';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
     /** Optional diagnostics sink for warnings/errors emitted during transform. */

package/dist/format.js

@@ -600,6 +600,8 @@ const format = async (src, ast, opts) => {
   let requireMainNeedsRealpath = false;
   let needsRequireResolveHelper = false;
   const nestedRequireStrategy = opts.nestedRequireStrategy ?? 'create-require';
+  const importMetaPreludeMode = opts.importMetaPrelude ?? 'auto';
+  let importMetaRef = false;
   const shouldLowerCjs = opts.target === 'commonjs' && fullTransform;
   const shouldRaiseEsm = opts.target === 'module' && fullTransform;
   let hoistedImports = [];
@@ -647,6 +649,10 @@ const format = async (src, ast, opts) => {
             const mainExpr = requireMainStrategy === 'import-meta-main' ? 'import.meta.main' : 'import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href';
             if (requireMainStrategy === 'realpath') {
               requireMainNeedsRealpath = true;
+              importMetaRef = true;
+            }
+            if (requireMainStrategy === 'import-meta-main') {
+              importMetaRef = true;
             }
             code.update(node.start, node.end, negate ? `!(${mainExpr})` : mainExpr);
             return;
@@ -765,6 +771,9 @@ const format = async (src, ast, opts) => {
         }
       }
       if (isIdentifierName(node)) {
+        if (shouldRaiseEsm && node.type === 'Identifier' && (node.name === '__dirname' || node.name === '__filename')) {
+          importMetaRef = true;
+        }
         identifier({
           node,
           ancestors,
@@ -820,8 +829,14 @@ const format = async (src, ast, opts) => {
     const asExportName = name => isValidExportName(name) ? name : JSON.stringify(name);
     const accessProp = name => isValidExportName(name) ? `${exportsRename}.${name}` : `${exportsRename}[${JSON.stringify(name)}]`;
     const exportValueFor = name => {
-      if (name === '__dirname') return 'import.meta.dirname';
-      if (name === '__filename') return 'import.meta.filename';
+      if (name === '__dirname') {
+        importMetaRef = true;
+        return 'import.meta.dirname';
+      }
+      if (name === '__filename') {
+        importMetaRef = true;
+        return 'import.meta.filename';
+      }
       return name;
     };
     const tempNameFor = name => {
@@ -877,6 +892,9 @@ const format = async (src, ast, opts) => {
   }
   if (shouldRaiseEsm && fullTransform) {
     const importPrelude = [];
+    if (needsCreateRequire || needsRequireResolveHelper) {
+      importMetaRef = true;
+    }
     if (needsCreateRequire || needsRequireResolveHelper) {
       importPrelude.push('import { createRequire } from "node:module";\n');
     }
@@ -909,9 +927,13 @@ const format = async (src, ast, opts) => {
     const exportsBagInit = useExportsBag ? `let ${exportsRename} = {};
 ` : '';
     const modulePrelude = '';
-    const prelude = `${importPrelude.join('')}${importPrelude.length ? '\n' : ''}${setupPrelude.join('')}${setupPrelude.length ? '\n' : ''}${requireInit}${requireResolveInit}${exportsBagInit}${modulePrelude}void import.meta.filename;
-`;
-    code.prepend(prelude);
+    const prelude = `${importPrelude.join('')}${importPrelude.length ? '\n' : ''}${setupPrelude.join('')}${setupPrelude.length ? '\n' : ''}${requireInit}${requireResolveInit}${exportsBagInit}${modulePrelude}`;
+    const importMetaTouch = (() => {
+      if (importMetaPreludeMode === 'on') return 'void import.meta.filename;\n';
+      if (importMetaPreludeMode === 'off') return '';
+      return importMetaRef ? 'void import.meta.filename;\n' : '';
+    })();
+    code.prepend(`${prelude}${importMetaTouch}`);
   }
   if (opts.target === 'commonjs' && fullTransform && containsTopLevelAwait) {
     const body = code.toString();

package/dist/module.js

@@ -44,7 +44,7 @@ const rewriteSpecifierValue = (value, rewriteSpecifier) => {
   const collapsed = collapseSpecifier(value);
   const relative = /^(?:\.\.?)\//;
   if (relative.test(collapsed)) {
-    return value.replace(/(.+)\.(?:m|c)?(?:j|t)s([)'"]*)?$/, `$1${rewriteSpecifier}$2`);
+    return value.replace(/(.+)\.(?:m|c)?(?:j|t)sx?([)'"]*)?$/, `$1${rewriteSpecifier}$2`);
   }
 };
 const normalizeBuiltinSpecifier = value => {
@@ -158,6 +158,7 @@ const defaultOptions = {
   nestedRequireStrategy: 'create-require',
   cjsDefault: 'auto',
   idiomaticExports: 'safe',
+  importMetaPrelude: 'auto',
   topLevelAwait: 'error',
   out: undefined,
   inPlace: false

package/dist/specifier.js

@@ -111,6 +111,9 @@ const formatSpecifiers = async (src, ast, cb) => {
   };
   await walk(ast.program, {
     enter(node) {
+      if (node.type === 'ImportExpression') {
+        formatExpression(node);
+      }
       if (node.type === 'ExpressionStatement') {
         const {
           expression

package/dist/src/types.d.ts

@@ -21,7 +21,8 @@ export type ModuleOptions = {
     appendJsExtension?: 'off' | 'relative-only' | 'all';
     /** Add directory index (e.g. /index.js) or disable. */
     appendDirectoryIndex?: string | false;
-    /** Control __dirname and __filename handling. */
+    /** Precedence: rewriteSpecifier runs first; if it returns a string that wins. If it returns undefined or null, appenders apply. Bare specifiers are never modified by appenders. */
+    /** Control __dirname/__filename handling (inject shims, preserve existing, or throw on use). */
     dirFilename?: 'inject' | 'preserve' | 'error';
     /** How to treat import.meta. */
     importMeta?: 'preserve' | 'shim' | 'error';
@@ -39,6 +40,8 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Emit idiomatic exports when raising CJS to ESM. */
     idiomaticExports?: 'off' | 'safe' | 'aggressive';
+    /** Control whether a no-op import.meta prelude is emitted. */
+    importMetaPrelude?: 'off' | 'auto' | 'on';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
     /** Optional diagnostics sink for warnings/errors emitted during transform. */

package/dist/types.d.ts

@@ -21,7 +21,8 @@ export type ModuleOptions = {
     appendJsExtension?: 'off' | 'relative-only' | 'all';
     /** Add directory index (e.g. /index.js) or disable. */
     appendDirectoryIndex?: string | false;
-    /** Control __dirname and __filename handling. */
+    /** Precedence: rewriteSpecifier runs first; if it returns a string that wins. If it returns undefined or null, appenders apply. Bare specifiers are never modified by appenders. */
+    /** Control __dirname/__filename handling (inject shims, preserve existing, or throw on use). */
     dirFilename?: 'inject' | 'preserve' | 'error';
     /** How to treat import.meta. */
     importMeta?: 'preserve' | 'shim' | 'error';
@@ -39,6 +40,8 @@ export type ModuleOptions = {
     cjsDefault?: 'module-exports' | 'auto' | 'none';
     /** Emit idiomatic exports when raising CJS to ESM. */
     idiomaticExports?: 'off' | 'safe' | 'aggressive';
+    /** Control whether a no-op import.meta prelude is emitted. */
+    importMetaPrelude?: 'off' | 'auto' | 'on';
     /** Handling for top-level await constructs. */
     topLevelAwait?: 'error' | 'wrap' | 'preserve';
     /** Optional diagnostics sink for warnings/errors emitted during transform. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/module",
-  "version": "1.0.0-rc.6",
+  "version": "1.1.0",
   "description": "Bidirectional transform for ES modules and CommonJS.",
   "type": "module",
   "main": "dist/module.js",
@@ -19,12 +19,12 @@
     "./package.json": "./package.json"
   },
   "imports": {
-    "#parse": "./dist/parse.js",
-    "#format": "./dist/format.js",
-    "#utils/*.js": "./dist/utils/*.js",
-    "#walk": "./dist/walk.js",
-    "#helpers/*.js": "./dist/helpers/*.js",
-    "#formatters/*.js": "./dist/formatters/*.js"
+    "#parse": "./src/parse.js",
+    "#format": "./src/format.js",
+    "#utils/*.js": "./src/utils/*.js",
+    "#walk": "./src/walk.js",
+    "#helpers/*.js": "./src/helpers/*.js",
+    "#formatters/*.js": "./src/formatters/*.js"
   },
   "engines": {
     "node": ">=22.21.1 <23 || >=24 <25"

package/dist/assignmentExpression.d.cts

@@ -1,12 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, AssignmentExpression } from 'oxc-parser';
-import type { FormatterOptions, ExportsMeta } from '../types.cjs';
-type AssignmentExpressionArg = {
-    node: AssignmentExpression;
-    parent: Node | null;
-    code: MagicString;
-    opts: FormatterOptions;
-    meta: ExportsMeta;
-};
-export declare const assignmentExpression: ({ node, parent: _parent, code: _code, opts, meta: _meta, }: AssignmentExpressionArg) => Promise<void>;
-export {};

package/dist/cjs/helpers/scope.cjs

@@ -1,12 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.scopes = exports.scope = void 0;
-const scopes = exports.scopes = ['BlockStatement', 'FunctionDeclaration', 'FunctionExpression', 'ArrowFunctionExpression', 'ClassDeclaration', 'ClassExpression', 'ClassBody', 'StaticBlock'];
-const scope = exports.scope = {
-  isScope(node) {
-    return scopes.includes(node.type);
-  }
-};

package/dist/cjs/scope.d.cts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-declare const scopes: string[];
-declare const scope: {
-    isScope(node: Node): boolean;
-};
-export { scopes, scope };

package/dist/exports.d.cts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-import type { CjsExport } from '../types.cjs';
-declare const exportsRename = "__exports";
-declare const requireMainRgx: RegExp;
-declare const collectCjsExports: (ast: Node) => Promise<Map<string, CjsExport>>;
-export { exportsRename, requireMainRgx, collectCjsExports };

package/dist/expressionStatement.d.cts

@@ -1,4 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, ExpressionStatement } from 'oxc-parser';
-import type { FormatterOptions } from '../types.cjs';
-export declare const expressionStatement: (node: ExpressionStatement, parent: Node | null, src: MagicString, options: FormatterOptions) => void;

package/dist/format.d.cts

@@ -1,9 +0,0 @@
-import type { ParseResult } from 'oxc-parser';
-import type { FormatterOptions } from './types.cjs';
-/**
- * Node added support for import.meta.main.
- * Added in: v24.2.0, v22.18.0
- * @see https://nodejs.org/api/esm.html#importmetamain
- */
-declare const format: (src: string, ast: ParseResult, opts: FormatterOptions) => Promise<string>;
-export { format };

package/dist/formatters/assignmentExpression.d.ts

@@ -1,12 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, AssignmentExpression } from 'oxc-parser';
-import type { FormatterOptions, ExportsMeta } from '../types.js';
-type AssignmentExpressionArg = {
-    node: AssignmentExpression;
-    parent: Node | null;
-    code: MagicString;
-    opts: FormatterOptions;
-    meta: ExportsMeta;
-};
-export declare const assignmentExpression: ({ node, parent: _parent, code: _code, opts, meta: _meta, }: AssignmentExpressionArg) => Promise<void>;
-export {};

package/dist/formatters/expressionStatement.d.ts

@@ -1,4 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, ExpressionStatement } from 'oxc-parser';
-import type { FormatterOptions } from '../types.js';
-export declare const expressionStatement: (node: ExpressionStatement, parent: Node | null, src: MagicString, options: FormatterOptions) => void;

package/dist/formatters/identifier.d.ts

@@ -1,12 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, IdentifierName } from 'oxc-parser';
-import type { FormatterOptions, ExportsMeta } from '../types.js';
-type IdentifierArg = {
-    node: IdentifierName;
-    ancestors: Node[];
-    code: MagicString;
-    opts: FormatterOptions;
-    meta: ExportsMeta;
-};
-export declare const identifier: ({ node, ancestors, code, opts, meta }: IdentifierArg) => void;
-export {};

package/dist/formatters/memberExpression.d.ts

@@ -1,4 +0,0 @@
-import MagicString from 'magic-string';
-import type { MemberExpression, Node } from 'oxc-parser';
-import type { FormatterOptions } from '../types.js';
-export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions) => void;

package/dist/formatters/metaProperty.d.ts

@@ -1,4 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, MetaProperty } from 'oxc-parser';
-import type { FormatterOptions } from '../types.js';
-export declare const metaProperty: (node: MetaProperty, parent: Node | null, src: MagicString, options: FormatterOptions) => void;

package/dist/helpers/identifier.d.ts

@@ -1,31 +0,0 @@
-import type { Node, IdentifierName } from 'oxc-parser';
-/**
- * Focus exclusively on IdentifierName type as it has the name property,
- * which is what the identifer utilities are interested in.
- *
- * Explicitly ignore the TSThisParameter type as it is not a valid identifier name.
- */
-declare const isIdentifierName: (node: Node) => node is IdentifierName;
-/**
- * All methods receive the full set of ancestors, which
- * specifically includes the node itself as the last element.
- * The second to last element is the parent node, and so on.
- * The first element is the root node.
- */
-declare const identifier: {
-    isNamed: (node: Node) => node is IdentifierName;
-    isMetaProperty(ancestors: Node[]): boolean;
-    isModuleScope(ancestors: Node[], includeImports?: boolean): boolean;
-    isMemberExpressionRoot(ancestors: Node[]): boolean;
-    isDeclaration(ancestors: Node[]): boolean;
-    isClassOrFuncDeclarationId(ancestors: Node[]): boolean;
-    isVarDeclarationInGlobalScope(ancestors: Node[]): boolean;
-    isIife(ancestors: Node[]): boolean;
-    isFunctionExpressionId(ancestors: Node[]): boolean;
-    isExportSpecifierAlias(ancestors: Node[]): boolean;
-    isClassPropertyKey(ancestors: Node[]): boolean;
-    isMethodDefinitionKey(ancestors: Node[]): boolean;
-    isMemberKey(ancestors: Node[]): boolean;
-    isPropertyKey(ancestors: Node[]): boolean;
-};
-export { identifier, isIdentifierName };

package/dist/helpers/scope.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-declare const scopes: string[];
-declare const scope: {
-    isScope(node: Node): boolean;
-};
-export { scopes, scope };

package/dist/helpers/scope.js

@@ -1,7 +0,0 @@
-const scopes = ['BlockStatement', 'FunctionDeclaration', 'FunctionExpression', 'ArrowFunctionExpression', 'ClassDeclaration', 'ClassExpression', 'ClassBody', 'StaticBlock'];
-const scope = {
-  isScope(node) {
-    return scopes.includes(node.type);
-  }
-};
-export { scopes, scope };

package/dist/identifier.d.cts

@@ -1,31 +0,0 @@
-import type { Node, IdentifierName } from 'oxc-parser';
-/**
- * Focus exclusively on IdentifierName type as it has the name property,
- * which is what the identifer utilities are interested in.
- *
- * Explicitly ignore the TSThisParameter type as it is not a valid identifier name.
- */
-declare const isIdentifierName: (node: Node) => node is IdentifierName;
-/**
- * All methods receive the full set of ancestors, which
- * specifically includes the node itself as the last element.
- * The second to last element is the parent node, and so on.
- * The first element is the root node.
- */
-declare const identifier: {
-    isNamed: (node: Node) => node is IdentifierName;
-    isMetaProperty(ancestors: Node[]): boolean;
-    isModuleScope(ancestors: Node[], includeImports?: boolean): boolean;
-    isMemberExpressionRoot(ancestors: Node[]): boolean;
-    isDeclaration(ancestors: Node[]): boolean;
-    isClassOrFuncDeclarationId(ancestors: Node[]): boolean;
-    isVarDeclarationInGlobalScope(ancestors: Node[]): boolean;
-    isIife(ancestors: Node[]): boolean;
-    isFunctionExpressionId(ancestors: Node[]): boolean;
-    isExportSpecifierAlias(ancestors: Node[]): boolean;
-    isClassPropertyKey(ancestors: Node[]): boolean;
-    isMethodDefinitionKey(ancestors: Node[]): boolean;
-    isMemberKey(ancestors: Node[]): boolean;
-    isPropertyKey(ancestors: Node[]): boolean;
-};
-export { identifier, isIdentifierName };

package/dist/identifiers.d.cts

@@ -1,19 +0,0 @@
-import type { Node } from 'oxc-parser';
-import type { IdentMeta, Scope } from '../types.cjs';
-declare const collectScopeIdentifiers: (node: Node, scopes: Scope[]) => void;
-/**
- * Collects all module scope identifiers in the AST.
- *
- * Ignores identifiers that are in functions or classes.
- * Ignores new scopes for StaticBlock nodes (can only reference static class members).
- *
- * Special case handling for these which create their own scopes,
- * but are also valid module scope identifiers:
- * - ClassDeclaration
- * - FunctionDeclaration
- *
- * Special case handling for var inside BlockStatement
- * which are also valid module scope identifiers.
- */
-declare const collectModuleIdentifiers: (ast: Node, hoisting?: boolean) => Promise<Map<string, IdentMeta>>;
-export { collectScopeIdentifiers, collectModuleIdentifiers };

package/dist/lang.d.cts

@@ -1,3 +0,0 @@
-import type { ParserOptions } from 'oxc-parser';
-declare const getLangFromExt: (filename: string) => ParserOptions["lang"] | undefined;
-export { getLangFromExt };

package/dist/memberExpression.d.cts

@@ -1,13 +0,0 @@
-import MagicString from 'magic-string';
-import type { MemberExpression, Node } from 'oxc-parser';
-import type { FormatterOptions } from '../types.cjs';
-type MemberExpressionExtras = {
-    onRequireResolve?: () => void;
-    requireResolveName?: string;
-    onDiagnostic?: (code: string, message: string, loc?: {
-        start: number;
-        end: number;
-    }) => void;
-};
-export declare const memberExpression: (node: MemberExpression, parent: Node | null, src: MagicString, options: FormatterOptions, shadowed?: Set<string>, extras?: MemberExpressionExtras, useExportsBag?: boolean, rewriteExports?: boolean) => void;
-export {};

package/dist/metaProperty.d.cts

@@ -1,4 +0,0 @@
-import MagicString from 'magic-string';
-import type { Node, MetaProperty } from 'oxc-parser';
-import type { FormatterOptions } from '../types.cjs';
-export declare const metaProperty: (node: MetaProperty, parent: Node | null, src: MagicString, options: FormatterOptions) => void;

package/dist/module.d.cts

@@ -1,3 +0,0 @@
-import type { ModuleOptions } from './types.cjs';
-declare const transform: (filename: string, options?: ModuleOptions) => Promise<string>;
-export { transform };

package/dist/parse.d.cts

@@ -1,2 +0,0 @@
-declare const parse: (filename: string, code: string) => import("oxc-parser").ParseResult;
-export { parse };

package/dist/scope.d.cts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-declare const scopes: string[];
-declare const scope: {
-    isScope(node: Node): boolean;
-};
-export { scopes, scope };

package/dist/scope.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-declare const scopes: string[];
-declare const scope: {
-    isScope(node: Node): boolean;
-};
-export { scopes, scope };

package/dist/scopeNodes.d.cts

@@ -1,2 +0,0 @@
-declare const scopeNodes: string[];
-export { scopeNodes };

package/dist/specifier.d.cts

@@ -1,16 +0,0 @@
-import type { ParserOptions, StringLiteral, TemplateLiteral, BinaryExpression, NewExpression, ImportDeclaration, ExportNamedDeclaration, ExportAllDeclaration, TSImportType, ImportExpression, CallExpression } from 'oxc-parser';
-type Spec = {
-    type: 'StringLiteral' | 'TemplateLiteral' | 'BinaryExpression' | 'NewExpression';
-    node: StringLiteral | TemplateLiteral | BinaryExpression | NewExpression;
-    parent: CallExpression | ImportDeclaration | ExportNamedDeclaration | ExportAllDeclaration | ImportExpression | TSImportType;
-    start: number;
-    end: number;
-    value: string;
-};
-type Callback = (spec: Spec) => string | void;
-declare const specifier: {
-    update(path: string, callback: Callback): Promise<string>;
-    updateSrc(src: string, lang: ParserOptions["lang"], callback: Callback): Promise<string>;
-};
-export { specifier };
-export type { Spec, Callback };

package/dist/src/helpers/scope.d.ts

@@ -1,6 +0,0 @@
-import type { Node } from 'oxc-parser';
-declare const scopes: string[];
-declare const scope: {
-    isScope(node: Node): boolean;
-};
-export { scopes, scope };

package/dist/types.d.cts

@@ -1,90 +0,0 @@
-import type { Node, Span, IdentifierName, IdentifierReference, BindingIdentifier, LabelIdentifier, TSIndexSignatureName } from 'oxc-parser';
-export type RewriteSpecifier = '.js' | '.mjs' | '.cjs' | '.ts' | '.mts' | '.cts' | ((value: string) => string | null | undefined);
-/** Options that control how modules are parsed, transformed, and emitted. */
-export type ModuleOptions = {
-    /** Output format to emit. */
-    target: 'module' | 'commonjs';
-    /** Explicit source type; auto infers from file extension. */
-    sourceType?: 'auto' | 'module' | 'commonjs';
-    /**
-     * Enable syntax transforms beyond parsing.
-     * - true: full CJS↔ESM lowering/raising
-     * - 'globals-only': rewrite module-global differences (import.meta, __dirname/filename, require.main shims) while leaving import/export shapes untouched
-     * - false/undefined: no syntax transforms
-     */
-    transformSyntax?: boolean | 'globals-only';
-    /** How to emit live bindings for ESM exports. */
-    liveBindings?: 'strict' | 'loose' | 'off';
-    /** Rewrite import specifiers (e.g. add extensions). */
-    rewriteSpecifier?: RewriteSpecifier;
-    /** Whether to append .js to relative imports. */
-    appendJsExtension?: 'off' | 'relative-only' | 'all';
-    /** Add directory index (e.g. /index.js) or disable. */
-    appendDirectoryIndex?: string | false;
-    /** Control __dirname and __filename handling. */
-    dirFilename?: 'inject' | 'preserve' | 'error';
-    /** How to treat import.meta. */
-    importMeta?: 'preserve' | 'shim' | 'error';
-    /** Strategy for import.meta.main emulation. */
-    importMetaMain?: 'shim' | 'warn' | 'error';
-    /** Resolution strategy for detecting the main module. */
-    requireMainStrategy?: 'import-meta-main' | 'realpath';
-    /** Detect circular require usage level. */
-    detectCircularRequires?: 'off' | 'warn' | 'error';
-    /** Source used to provide require in ESM output. */
-    requireSource?: 'builtin' | 'create-require';
-    /** How to rewrite nested or non-hoistable require calls. */
-    nestedRequireStrategy?: 'create-require' | 'dynamic-import';
-    /** Default interop style for CommonJS default imports. */
-    cjsDefault?: 'module-exports' | 'auto' | 'none';
-    /** Emit idiomatic exports when raising CJS to ESM. */
-    idiomaticExports?: 'off' | 'safe' | 'aggressive';
-    /** Handling for top-level await constructs. */
-    topLevelAwait?: 'error' | 'wrap' | 'preserve';
-    /** Optional diagnostics sink for warnings/errors emitted during transform. */
-    diagnostics?: (diag: Diagnostic) => void;
-    /** Optional source file path used for diagnostics context. */
-    filePath?: string;
-    /** Output directory or file path when writing. */
-    out?: string;
-    /** Overwrite input files instead of writing to out. */
-    inPlace?: boolean;
-};
-export type Diagnostic = {
-    level: 'warning' | 'error';
-    code: string;
-    message: string;
-    filePath?: string;
-    loc?: {
-        start: number;
-        end: number;
-    };
-};
-export type SpannedNode = Node & Span;
-export type ExportsMeta = {
-    hasExportsBeenReassigned: boolean;
-    hasDefaultExportBeenReassigned: boolean;
-    hasDefaultExportBeenAssigned: boolean;
-    defaultExportValue: unknown;
-};
-export type CjsExport = {
-    key: string;
-    writes: SpannedNode[];
-    fromIdentifier?: string;
-    via: Set<'exports' | 'module.exports'>;
-    reassignments: SpannedNode[];
-    hasGetter?: boolean;
-    hasNonTopLevelWrite?: boolean;
-};
-export type IdentMeta = {
-    declare: SpannedNode[];
-    read: SpannedNode[];
-};
-export type Scope = {
-    type: string;
-    name: string;
-    node: Node;
-    idents: Set<string>;
-};
-export type FormatterOptions = Omit<ModuleOptions, 'out' | 'inPlace'>;
-export type Identifier = IdentifierName | IdentifierReference | BindingIdentifier | LabelIdentifier | TSIndexSignatureName;

package/dist/url.d.cts

@@ -1,2 +0,0 @@
-declare const isValidUrl: (url: string) => boolean;
-export { isValidUrl };

package/dist/utils.d.cts

@@ -1,23 +0,0 @@
-import type { Node } from 'oxc-parser';
-import type { IdentMeta, Scope, CjsExport } from './types.cjs';
-declare const isValidUrl: (url: string) => boolean;
-declare const exportsRename = "__exports";
-declare const requireMainRgx: RegExp;
-declare const collectCjsExports: (ast: Node) => Promise<Map<string, CjsExport>>;
-declare const collectScopeIdentifiers: (node: Node, scopes: Scope[]) => void;
-/**
- * Collects all module scope identifiers in the AST.
- *
- * Ignores identifiers that are in functions or classes.
- * Ignores new scopes for StaticBlock nodes (can only reference static class members).
- *
- * Special case handling for these which create their own scopes,
- * but are also valid module scope identifiers:
- * - ClassDeclaration
- * - FunctionDeclaration
- *
- * Special case handling for var inside BlockStatement
- * which are also valid module scope identifiers.
- */
-declare const collectModuleIdentifiers: (ast: Node, hoisting?: boolean) => Promise<Map<string, IdentMeta>>;
-export { isValidUrl, collectScopeIdentifiers, collectModuleIdentifiers, collectCjsExports, exportsRename, requireMainRgx, };

package/dist/walk.d.cts

@@ -1,20 +0,0 @@
-import type { Node } from 'oxc-parser';
-/**
- * Using visitorKeys instead of oxc Visitor to keep
- * an ancestor-aware enter/leave API with this.skip()
- * without per-node method boilerplate.
- */
-type AncestorContext = {
-    skip: () => void;
-};
-type AncestorVisitor = {
-    enter?: (this: AncestorContext, node: Node, ancestors: Node[]) => void | Promise<void>;
-    leave?: (this: AncestorContext, node: Node, ancestors: Node[]) => void | Promise<void>;
-};
-type WalkVisitor = {
-    enter?: (this: AncestorContext, node: Node, parent: Node | null) => void | Promise<void>;
-    leave?: (this: AncestorContext, node: Node, parent: Node | null) => void | Promise<void>;
-};
-declare const ancestorWalk: (node: Node, visitors: AncestorVisitor) => Promise<void>;
-declare const walk: (node: Node, visitors: WalkVisitor) => Promise<void>;
-export { ancestorWalk, walk };