@knighted/duel 3.0.0 → 3.1.1

package/README.md

@@ -90,6 +90,10 @@ Note, there is a slight performance penalty since your project needs to be copie
 
 This feature is still a work in progress regarding transforming `exports` when targeting an ES module build (relies on [`@knighted/module`](https://github.com/knightedcodemonkey/module)).
 
+#### Pre-`tsc` transform (TypeScript 58658)
+
+When you pass `--modules`, `duel` copies your sources and runs [`@knighted/module`](https://github.com/knightedcodemonkey/module) **before** `tsc` so the transformed files no longer trigger TypeScript’s asymmetrical module-global errors (see [TypeScript#58658](https://github.com/microsoft/TypeScript/issues/58658)). No extra setup is needed: `--modules` is the pre-`tsc` mitigation.
+
 ## Options
 
 The available options are limited, because you should define most of them inside your project's `tsconfig.json` file.
@@ -98,6 +102,10 @@ The available options are limited, because you should define most of them inside
 - `--pkg-dir, -k` The directory to start looking for a package.json file. Defaults to `--project` dir.
 - `--modules, -m` Transform module globals for dual build target. Defaults to false.
 - `--dirs, -d` Outputs both builds to directories inside of `outDir`. Defaults to `false`.
+- `--exports, -e` Generate `package.json` `exports` from build output. Values: `wildcard` | `dir` | `name`.
+
+> [!NOTE]
+> Exports keys are extensionless by design; the target `import`/`require`/`types` entries keep explicit file extensions so Node resolution remains deterministic.
 
 You can run `duel --help` to get the same info. Below is the output of that:
 
@@ -118,7 +126,7 @@ These are definitely edge cases, and would only really come up if your project m
 
 - This is going to work best if your CJS-first project uses file extensions in _relative_ specifiers. This is completely acceptable in CJS projects, and [required in ESM projects](https://nodejs.org/api/esm.html#import-specifiers). This package makes no attempt to rewrite bare specifiers, or remap any relative specifiers to a directory index.
 
-- Unfortunately, `tsc` doesn't support [dual packages](https://nodejs.org/api/packages.html#dual-commonjses-module-packages) completely. One instance of unexpected behavior is when the compiler throws errors for ES module globals when running a dual CJS build, but not for the inverse case, despite both causing runtime errors in Node.js. See the [open issue](https://github.com/microsoft/TypeScript/issues/58658). You can circumvent this with `duel` by using the `--modules` option if your project uses module globals such as `import.meta` properties or `__dirname`, `__filename`, etc. in a CommonJS project.
+- Unfortunately, `tsc` doesn't support [dual packages](https://nodejs.org/api/packages.html#dual-commonjses-module-packages) completely. For mitigation details, see the pre-`tsc` transform note above (`--modules`).
 
 - If running `duel` with your project's package.json file open in your editor, you may temporarily see the content replaced. This is because `duel` dynamically creates a new package.json using the `type` necessary for the dual build. Your original package.json will be restored after the build completes.
 
@@ -131,3 +139,5 @@ Fortunately, Node.js has added `--experimental-require-module` so that you can [
 ## Documentation
 
 - [docs/faq.md](docs/faq.md)
+- [docs/exports.md](docs/exports.md)
+- [docs/migrate-v2-v3.md](docs/migrate-v2-v3.md)

package/dist/cjs/duel.cjs

@@ -13,15 +13,178 @@ const find_up_1 = require("find-up");
 const module_1 = require("@knighted/module");
 const init_js_1 = require("./init.cjs");
 const util_js_1 = require("./util.cjs");
+const stripKnownExt = path => {
+    return path.replace(/(\.d\.(?:ts|mts|cts)|\.(?:mjs|cjs|js))$/, '');
+};
+const ensureDotSlash = path => {
+    return path.startsWith('./') ? path : `./${path}`;
+};
+const getSubpath = (mode, relFromRoot) => {
+    const parsed = (0, node_path_1.parse)(relFromRoot);
+    const segments = parsed.dir.split('/').filter(Boolean);
+    if (mode === 'name') {
+        return parsed.name ? `./${parsed.name}` : null;
+    }
+    if (mode === 'dir') {
+        const last = segments.at(-1);
+        return last ? `./${last}` : null;
+    }
+    if (mode === 'wildcard') {
+        const first = segments[0];
+        return first ? `./${first}/*` : null;
+    }
+    return null;
+};
 const handleErrorAndExit = message => {
     const exitCode = Number(message);
     (0, util_js_1.logError)('Compilation errors found.');
     process.exit(exitCode);
 };
+const generateExports = async (options) => {
+    const { mode, pkg, pkgDir, esmRoot, cjsRoot, mainDefaultKind, mainPath } = options;
+    const toPosix = path => path.replace(/\\/g, '/');
+    const esmRootPosix = toPosix(esmRoot);
+    const cjsRootPosix = toPosix(cjsRoot);
+    const esmIgnore = ['node_modules/**'];
+    const cjsIgnore = ['node_modules/**'];
+    const baseMap = new Map();
+    const subpathMap = new Map();
+    const baseToSubpath = new Map();
+    if (cjsRootPosix.startsWith(`${esmRootPosix}/`)) {
+        esmIgnore.push(`${cjsRootPosix}/**`);
+    }
+    if (esmRootPosix.startsWith(`${cjsRootPosix}/`)) {
+        cjsIgnore.push(`${esmRootPosix}/**`);
+    }
+    const recordPath = (kind, filePath, root) => {
+        const relPkg = toPosix((0, node_path_1.relative)(pkgDir, filePath));
+        const relFromRoot = toPosix((0, node_path_1.relative)(root, filePath));
+        const withDot = ensureDotSlash(relPkg);
+        const baseKey = stripKnownExt(relPkg);
+        const baseEntry = baseMap.get(baseKey) ?? {};
+        baseEntry[kind] = withDot;
+        baseMap.set(baseKey, baseEntry);
+        const subpath = getSubpath(mode, relFromRoot);
+        if (kind === 'types') {
+            const mappedSubpath = baseToSubpath.get(baseKey);
+            if (mappedSubpath) {
+                const subEntry = subpathMap.get(mappedSubpath) ?? {};
+                subEntry.types = withDot;
+                subpathMap.set(mappedSubpath, subEntry);
+            }
+            return;
+        }
+        if (subpath && subpath !== '.') {
+            const subEntry = subpathMap.get(subpath) ?? {};
+            subEntry[kind] = withDot;
+            subpathMap.set(subpath, subEntry);
+            baseToSubpath.set(baseKey, subpath);
+        }
+    };
+    const esmFiles = await (0, glob_1.glob)(`${esmRootPosix}/**/*.{js,mjs,d.ts,d.mts}`, {
+        ignore: esmIgnore,
+    });
+    for (const file of esmFiles) {
+        if (/\.d\.(ts|mts)$/.test(file)) {
+            recordPath('types', file, esmRoot);
+        }
+        else {
+            recordPath('import', file, esmRoot);
+        }
+    }
+    const cjsFiles = await (0, glob_1.glob)(`${cjsRootPosix}/**/*.{js,cjs,d.ts,d.cts}`, {
+        ignore: cjsIgnore,
+    });
+    for (const file of cjsFiles) {
+        if (/\.d\.(ts|cts)$/.test(file)) {
+            recordPath('types', file, cjsRoot);
+        }
+        else {
+            recordPath('require', file, cjsRoot);
+        }
+    }
+    const exportsMap = {};
+    const mainBase = mainPath ? stripKnownExt(mainPath.replace(/^\.\//, '')) : null;
+    const mainEntry = mainBase ? (baseMap.get(mainBase) ?? {}) : {};
+    if (mainPath) {
+        const rootEntry = {};
+        if (mainEntry.types) {
+            rootEntry.types = mainEntry.types;
+        }
+        if (mainDefaultKind === 'import') {
+            rootEntry.import = mainEntry.import ?? ensureDotSlash(mainPath);
+            if (mainEntry.require) {
+                rootEntry.require = mainEntry.require;
+            }
+        }
+        else {
+            rootEntry.require = mainEntry.require ?? ensureDotSlash(mainPath);
+            if (mainEntry.import) {
+                rootEntry.import = mainEntry.import;
+            }
+        }
+        rootEntry.default = ensureDotSlash(mainPath);
+        exportsMap['.'] = rootEntry;
+    }
+    const defaultKind = mainDefaultKind ?? 'import';
+    for (const [subpath, entry] of subpathMap.entries()) {
+        const out = {};
+        if (entry.types) {
+            out.types = entry.types;
+        }
+        if (entry.import) {
+            out.import = entry.import;
+        }
+        if (entry.require) {
+            out.require = entry.require;
+        }
+        const def = defaultKind === 'import'
+            ? (entry.import ?? entry.require)
+            : (entry.require ?? entry.import);
+        if (def) {
+            out.default = def;
+        }
+        if (Object.keys(out).length) {
+            exportsMap[subpath] = out;
+        }
+    }
+    if (!exportsMap['.'] && baseMap.size) {
+        const [subpath, entry] = subpathMap.entries().next().value ?? [];
+        if (entry) {
+            const out = {};
+            if (entry.types) {
+                out.types = entry.types;
+            }
+            if (entry.import) {
+                out.import = entry.import;
+            }
+            if (entry.require) {
+                out.require = entry.require;
+            }
+            const def = defaultKind === 'import'
+                ? (entry.import ?? entry.require)
+                : (entry.require ?? entry.import);
+            if (def) {
+                out.default = def;
+            }
+            if (Object.keys(out).length) {
+                exportsMap['.'] = out;
+                exportsMap[subpath] ??= out;
+            }
+        }
+    }
+    if (Object.keys(exportsMap).length) {
+        const pkgJson = {
+            ...pkg.packageJson,
+            exports: exportsMap,
+        };
+        await (0, promises_1.writeFile)(pkg.path, `${JSON.stringify(pkgJson, null, 2)}\n`);
+    }
+};
 const duel = async (args) => {
     const ctx = await (0, init_js_1.init)(args);
     if (ctx) {
-        const { projectDir, tsconfig, configPath, modules, dirs, pkg } = ctx;
+        const { projectDir, tsconfig, configPath, modules, dirs, pkg, exports: exportsOpt, } = ctx;
         const tsc = await (0, find_up_1.findUp)(async (dir) => {
             const tscBin = (0, node_path_1.join)(dir, 'node_modules', '.bin', 'tsc');
             try {
@@ -45,6 +208,8 @@ const duel = async (args) => {
             });
         };
         const pkgDir = (0, node_path_1.dirname)(pkg.path);
+        const mainPath = pkg.packageJson.main;
+        const mainDefaultKind = mainPath?.endsWith('.cjs') ? 'require' : 'import';
         const outDir = tsconfig.compilerOptions?.outDir ?? 'dist';
         const absoluteOutDir = (0, node_path_1.resolve)(projectDir, outDir);
         const originalType = pkg.packageJson.type ?? 'commonjs';
@@ -93,6 +258,7 @@ const duel = async (args) => {
                 const writeOptions = {
                     target,
                     rewriteSpecifier,
+                    transformSyntax: 'globals-only',
                     ...(outFilename === filename ? { inPlace: true } : { out: outFilename }),
                 };
                 await (0, module_1.transform)(filename, writeOptions);
@@ -102,7 +268,7 @@ const duel = async (args) => {
             }
         };
         const logSuccess = start => {
-            (0, util_js_1.log)(`Successfully created a dual ${isCjsBuild ? 'CJS' : 'ESM'} build in ${Math.round(node_perf_hooks_1.performance.now() - start)}ms.`);
+            (0, util_js_1.logSuccess)(`Successfully created a dual ${isCjsBuild ? 'CJS' : 'ESM'} build in ${Math.round(node_perf_hooks_1.performance.now() - start)}ms.`);
         };
         (0, util_js_1.log)('Starting primary build...');
         let success = false;
@@ -149,7 +315,7 @@ const duel = async (args) => {
                     await (0, module_1.transform)(file, {
                         out: file,
                         target: isCjsBuild ? 'commonjs' : 'module',
-                        transformSyntax: false,
+                        transformSyntax: 'globals-only',
                     });
                 }
             }
@@ -192,6 +358,19 @@ const duel = async (args) => {
                     const primaryFiles = await (0, glob_1.glob)(`${primaryOutDir.replace(/\\/g, '/')}/**/*{.js,.d.ts}`, { ignore: 'node_modules/**' });
                     await updateSpecifiersAndFileExtensions(primaryFiles, 'commonjs', '.cjs');
                 }
+                if (exportsOpt) {
+                    const esmRoot = isCjsBuild ? primaryOutDir : absoluteDualOutDir;
+                    const cjsRoot = isCjsBuild ? absoluteDualOutDir : primaryOutDir;
+                    await generateExports({
+                        mode: exportsOpt,
+                        pkg,
+                        pkgDir,
+                        esmRoot,
+                        cjsRoot,
+                        mainDefaultKind,
+                        mainPath,
+                    });
+                }
                 logSuccess(startTime);
             }
         }

package/dist/cjs/init.cjs

@@ -37,6 +37,10 @@ const init = async (args) => {
                     short: 'd',
                     default: false,
                 },
+                exports: {
+                    type: 'string',
+                    short: 'e',
+                },
                 help: {
                     type: 'boolean',
                     short: 'h',
@@ -51,16 +55,18 @@ const init = async (args) => {
         return false;
     }
     if (parsed.help) {
-        (0, util_js_1.log)('Usage: duel [options]\n');
-        (0, util_js_1.log)('Options:');
-        (0, util_js_1.log)("--project, -p [path] \t Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'.");
-        (0, util_js_1.log)('--pkg-dir, -k [path] \t The directory to start looking for a package.json file. Defaults to --project directory.');
-        (0, util_js_1.log)('--modules, -m \t\t Transform module globals for dual build target. Defaults to false.');
-        (0, util_js_1.log)('--dirs, -d \t\t Output both builds to directories inside of outDir. [esm, cjs].');
-        (0, util_js_1.log)('--help, -h \t\t Print this message.');
+        const bare = { bare: true };
+        (0, util_js_1.log)('Usage: duel [options]\n', 'info', bare);
+        (0, util_js_1.log)('Options:', 'info', bare);
+        (0, util_js_1.log)("--project, -p [path] \t Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'.", 'info', bare);
+        (0, util_js_1.log)('--pkg-dir, -k [path] \t The directory to start looking for a package.json file. Defaults to --project directory.', 'info', bare);
+        (0, util_js_1.log)('--modules, -m \t\t Transform module globals for dual build target. Defaults to false.', 'info', bare);
+        (0, util_js_1.log)('--dirs, -d \t\t Output both builds to directories inside of outDir. [esm, cjs].', 'info', bare);
+        (0, util_js_1.log)('--exports, -e \t Generate package.json exports. Values: wildcard | dir | name.', 'info', bare);
+        (0, util_js_1.log)('--help, -h \t\t Print this message.', 'info', bare);
     }
     else {
-        const { project, 'target-extension': targetExt, 'pkg-dir': pkgDir, modules, dirs, } = parsed;
+        const { project, 'target-extension': targetExt, 'pkg-dir': pkgDir, modules, dirs, exports: exportsOpt, } = parsed;
         let configPath = (0, node_path_1.resolve)(project);
         let stats = null;
         let pkg = null;
@@ -96,10 +102,15 @@ const init = async (args) => {
             if (!tsconfig.compilerOptions?.outDir) {
                 (0, util_js_1.log)('No outDir defined in tsconfig.json. Build output will be in "dist".');
             }
+            if (exportsOpt && !['wildcard', 'dir', 'name'].includes(exportsOpt)) {
+                (0, util_js_1.logError)('--exports expects one of: wildcard | dir | name');
+                return false;
+            }
             return {
                 pkg,
                 dirs,
                 modules,
+                exports: exportsOpt,
                 tsconfig,
                 projectDir,
                 configPath,

package/dist/cjs/init.d.cts

@@ -2,6 +2,7 @@ export function init(args: any): Promise<false | {
     pkg: import("read-package-up", { with: { "resolution-mode": "import" } }).NormalizedReadResult;
     dirs: boolean;
     modules: boolean;
+    exports: string | undefined;
     tsconfig: {
         compilerOptions?: import("get-tsconfig").TsConfigJson.CompilerOptions | undefined;
         watchOptions?: import("get-tsconfig").TsConfigJson.WatchOptions | undefined;

package/dist/cjs/util.cjs

@@ -1,17 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCompileFiles = exports.getRealPathAsFileUrl = exports.logError = exports.log = void 0;
+exports.getCompileFiles = exports.getRealPathAsFileUrl = exports.logWarn = exports.logSuccess = exports.logError = exports.log = void 0;
 const node_url_1 = require("node:url");
 const promises_1 = require("node:fs/promises");
 const node_child_process_1 = require("node:child_process");
 const node_process_1 = require("node:process");
 const node_os_1 = require("node:os");
-const log = (color = '\x1b[30m', msg = '') => {
+const COLORS = {
+    reset: '\x1b[0m',
+    info: '\x1b[36m',
+    success: '\x1b[32m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m',
+};
+const log = (msg = '', level = 'info', opts = {}) => {
+    const { bare = false } = opts;
+    const palette = {
+        info: COLORS.info,
+        success: COLORS.success,
+        warn: COLORS.warn,
+        error: COLORS.error,
+    };
+    const badge = {
+        success: '[✓]',
+        warn: '[!]',
+        error: '[x]',
+        info: '[i]',
+    }[level];
+    const color = palette[level] ?? COLORS.info;
+    const prefix = !bare && badge ? `${badge} ` : '';
     // eslint-disable-next-line no-console
-    console.log(`${color}%s\x1b[0m`, msg);
+    console.log(`${color}${prefix}%s${COLORS.reset}`, msg);
 };
 exports.log = log;
-const logError = log.bind(null, '\x1b[31m');
+const logSuccess = msg => log(msg, 'success');
+exports.logSuccess = logSuccess;
+const logWarn = msg => log(msg, 'warn');
+exports.logWarn = logWarn;
+const logError = msg => log(msg, 'error');
 exports.logError = logError;
 const getRealPathAsFileUrl = async (path) => {
     const realPath = await (0, promises_1.realpath)(path);

package/dist/cjs/util.d.cts

@@ -1,4 +1,6 @@
-export function log(color?: string, msg?: string): void;
-export const logError: (msg?: string | undefined) => void;
+export function log(msg?: string, level?: string, opts?: {}): void;
+export function logError(msg: any): void;
+export function logSuccess(msg: any): void;
+export function logWarn(msg: any): void;
 export function getRealPathAsFileUrl(path: any): Promise<string>;
 export function getCompileFiles(tscBinPath: any, wd?: string): string[];

package/dist/esm/duel.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { argv, platform } from 'node:process';
-import { join, dirname, resolve, relative } from 'node:path';
+import { join, dirname, resolve, relative, parse as parsePath } from 'node:path';
 import { spawn } from 'node:child_process';
 import { writeFile, rm, rename, mkdir, cp, access, readFile } from 'node:fs/promises';
 import { randomBytes } from 'node:crypto';
@@ -9,16 +9,179 @@ import { glob } from 'glob';
 import { findUp } from 'find-up';
 import { transform } from '@knighted/module';
 import { init } from './init.js';
-import { getRealPathAsFileUrl, getCompileFiles, logError, log } from './util.js';
+import { getRealPathAsFileUrl, getCompileFiles, log, logError, logSuccess as logSuccessBadge, } from './util.js';
+const stripKnownExt = path => {
+    return path.replace(/(\.d\.(?:ts|mts|cts)|\.(?:mjs|cjs|js))$/, '');
+};
+const ensureDotSlash = path => {
+    return path.startsWith('./') ? path : `./${path}`;
+};
+const getSubpath = (mode, relFromRoot) => {
+    const parsed = parsePath(relFromRoot);
+    const segments = parsed.dir.split('/').filter(Boolean);
+    if (mode === 'name') {
+        return parsed.name ? `./${parsed.name}` : null;
+    }
+    if (mode === 'dir') {
+        const last = segments.at(-1);
+        return last ? `./${last}` : null;
+    }
+    if (mode === 'wildcard') {
+        const first = segments[0];
+        return first ? `./${first}/*` : null;
+    }
+    return null;
+};
 const handleErrorAndExit = message => {
     const exitCode = Number(message);
     logError('Compilation errors found.');
     process.exit(exitCode);
 };
+const generateExports = async (options) => {
+    const { mode, pkg, pkgDir, esmRoot, cjsRoot, mainDefaultKind, mainPath } = options;
+    const toPosix = path => path.replace(/\\/g, '/');
+    const esmRootPosix = toPosix(esmRoot);
+    const cjsRootPosix = toPosix(cjsRoot);
+    const esmIgnore = ['node_modules/**'];
+    const cjsIgnore = ['node_modules/**'];
+    const baseMap = new Map();
+    const subpathMap = new Map();
+    const baseToSubpath = new Map();
+    if (cjsRootPosix.startsWith(`${esmRootPosix}/`)) {
+        esmIgnore.push(`${cjsRootPosix}/**`);
+    }
+    if (esmRootPosix.startsWith(`${cjsRootPosix}/`)) {
+        cjsIgnore.push(`${esmRootPosix}/**`);
+    }
+    const recordPath = (kind, filePath, root) => {
+        const relPkg = toPosix(relative(pkgDir, filePath));
+        const relFromRoot = toPosix(relative(root, filePath));
+        const withDot = ensureDotSlash(relPkg);
+        const baseKey = stripKnownExt(relPkg);
+        const baseEntry = baseMap.get(baseKey) ?? {};
+        baseEntry[kind] = withDot;
+        baseMap.set(baseKey, baseEntry);
+        const subpath = getSubpath(mode, relFromRoot);
+        if (kind === 'types') {
+            const mappedSubpath = baseToSubpath.get(baseKey);
+            if (mappedSubpath) {
+                const subEntry = subpathMap.get(mappedSubpath) ?? {};
+                subEntry.types = withDot;
+                subpathMap.set(mappedSubpath, subEntry);
+            }
+            return;
+        }
+        if (subpath && subpath !== '.') {
+            const subEntry = subpathMap.get(subpath) ?? {};
+            subEntry[kind] = withDot;
+            subpathMap.set(subpath, subEntry);
+            baseToSubpath.set(baseKey, subpath);
+        }
+    };
+    const esmFiles = await glob(`${esmRootPosix}/**/*.{js,mjs,d.ts,d.mts}`, {
+        ignore: esmIgnore,
+    });
+    for (const file of esmFiles) {
+        if (/\.d\.(ts|mts)$/.test(file)) {
+            recordPath('types', file, esmRoot);
+        }
+        else {
+            recordPath('import', file, esmRoot);
+        }
+    }
+    const cjsFiles = await glob(`${cjsRootPosix}/**/*.{js,cjs,d.ts,d.cts}`, {
+        ignore: cjsIgnore,
+    });
+    for (const file of cjsFiles) {
+        if (/\.d\.(ts|cts)$/.test(file)) {
+            recordPath('types', file, cjsRoot);
+        }
+        else {
+            recordPath('require', file, cjsRoot);
+        }
+    }
+    const exportsMap = {};
+    const mainBase = mainPath ? stripKnownExt(mainPath.replace(/^\.\//, '')) : null;
+    const mainEntry = mainBase ? (baseMap.get(mainBase) ?? {}) : {};
+    if (mainPath) {
+        const rootEntry = {};
+        if (mainEntry.types) {
+            rootEntry.types = mainEntry.types;
+        }
+        if (mainDefaultKind === 'import') {
+            rootEntry.import = mainEntry.import ?? ensureDotSlash(mainPath);
+            if (mainEntry.require) {
+                rootEntry.require = mainEntry.require;
+            }
+        }
+        else {
+            rootEntry.require = mainEntry.require ?? ensureDotSlash(mainPath);
+            if (mainEntry.import) {
+                rootEntry.import = mainEntry.import;
+            }
+        }
+        rootEntry.default = ensureDotSlash(mainPath);
+        exportsMap['.'] = rootEntry;
+    }
+    const defaultKind = mainDefaultKind ?? 'import';
+    for (const [subpath, entry] of subpathMap.entries()) {
+        const out = {};
+        if (entry.types) {
+            out.types = entry.types;
+        }
+        if (entry.import) {
+            out.import = entry.import;
+        }
+        if (entry.require) {
+            out.require = entry.require;
+        }
+        const def = defaultKind === 'import'
+            ? (entry.import ?? entry.require)
+            : (entry.require ?? entry.import);
+        if (def) {
+            out.default = def;
+        }
+        if (Object.keys(out).length) {
+            exportsMap[subpath] = out;
+        }
+    }
+    if (!exportsMap['.'] && baseMap.size) {
+        const [subpath, entry] = subpathMap.entries().next().value ?? [];
+        if (entry) {
+            const out = {};
+            if (entry.types) {
+                out.types = entry.types;
+            }
+            if (entry.import) {
+                out.import = entry.import;
+            }
+            if (entry.require) {
+                out.require = entry.require;
+            }
+            const def = defaultKind === 'import'
+                ? (entry.import ?? entry.require)
+                : (entry.require ?? entry.import);
+            if (def) {
+                out.default = def;
+            }
+            if (Object.keys(out).length) {
+                exportsMap['.'] = out;
+                exportsMap[subpath] ??= out;
+            }
+        }
+    }
+    if (Object.keys(exportsMap).length) {
+        const pkgJson = {
+            ...pkg.packageJson,
+            exports: exportsMap,
+        };
+        await writeFile(pkg.path, `${JSON.stringify(pkgJson, null, 2)}\n`);
+    }
+};
 const duel = async (args) => {
     const ctx = await init(args);
     if (ctx) {
-        const { projectDir, tsconfig, configPath, modules, dirs, pkg } = ctx;
+        const { projectDir, tsconfig, configPath, modules, dirs, pkg, exports: exportsOpt, } = ctx;
         const tsc = await findUp(async (dir) => {
             const tscBin = join(dir, 'node_modules', '.bin', 'tsc');
             try {
@@ -42,6 +205,8 @@ const duel = async (args) => {
             });
         };
         const pkgDir = dirname(pkg.path);
+        const mainPath = pkg.packageJson.main;
+        const mainDefaultKind = mainPath?.endsWith('.cjs') ? 'require' : 'import';
         const outDir = tsconfig.compilerOptions?.outDir ?? 'dist';
         const absoluteOutDir = resolve(projectDir, outDir);
         const originalType = pkg.packageJson.type ?? 'commonjs';
@@ -90,6 +255,7 @@ const duel = async (args) => {
                 const writeOptions = {
                     target,
                     rewriteSpecifier,
+                    transformSyntax: 'globals-only',
                     ...(outFilename === filename ? { inPlace: true } : { out: outFilename }),
                 };
                 await transform(filename, writeOptions);
@@ -99,7 +265,7 @@ const duel = async (args) => {
             }
         };
         const logSuccess = start => {
-            log(`Successfully created a dual ${isCjsBuild ? 'CJS' : 'ESM'} build in ${Math.round(performance.now() - start)}ms.`);
+            logSuccessBadge(`Successfully created a dual ${isCjsBuild ? 'CJS' : 'ESM'} build in ${Math.round(performance.now() - start)}ms.`);
         };
         log('Starting primary build...');
         let success = false;
@@ -146,7 +312,7 @@ const duel = async (args) => {
                     await transform(file, {
                         out: file,
                         target: isCjsBuild ? 'commonjs' : 'module',
-                        transformSyntax: false,
+                        transformSyntax: 'globals-only',
                     });
                 }
             }
@@ -189,6 +355,19 @@ const duel = async (args) => {
                     const primaryFiles = await glob(`${primaryOutDir.replace(/\\/g, '/')}/**/*{.js,.d.ts}`, { ignore: 'node_modules/**' });
                     await updateSpecifiersAndFileExtensions(primaryFiles, 'commonjs', '.cjs');
                 }
+                if (exportsOpt) {
+                    const esmRoot = isCjsBuild ? primaryOutDir : absoluteDualOutDir;
+                    const cjsRoot = isCjsBuild ? absoluteDualOutDir : primaryOutDir;
+                    await generateExports({
+                        mode: exportsOpt,
+                        pkg,
+                        pkgDir,
+                        esmRoot,
+                        cjsRoot,
+                        mainDefaultKind,
+                        mainPath,
+                    });
+                }
                 logSuccess(startTime);
             }
         }

package/dist/esm/init.d.ts

@@ -2,6 +2,7 @@ export function init(args: any): Promise<false | {
     pkg: import("read-package-up").NormalizedReadResult;
     dirs: boolean;
     modules: boolean;
+    exports: string | undefined;
     tsconfig: {
         compilerOptions?: import("get-tsconfig").TsConfigJson.CompilerOptions | undefined;
         watchOptions?: import("get-tsconfig").TsConfigJson.WatchOptions | undefined;

package/dist/esm/init.js

@@ -34,6 +34,10 @@ const init = async (args) => {
                     short: 'd',
                     default: false,
                 },
+                exports: {
+                    type: 'string',
+                    short: 'e',
+                },
                 help: {
                     type: 'boolean',
                     short: 'h',
@@ -48,16 +52,18 @@ const init = async (args) => {
         return false;
     }
     if (parsed.help) {
-        log('Usage: duel [options]\n');
-        log('Options:');
-        log("--project, -p [path] \t Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'.");
-        log('--pkg-dir, -k [path] \t The directory to start looking for a package.json file. Defaults to --project directory.');
-        log('--modules, -m \t\t Transform module globals for dual build target. Defaults to false.');
-        log('--dirs, -d \t\t Output both builds to directories inside of outDir. [esm, cjs].');
-        log('--help, -h \t\t Print this message.');
+        const bare = { bare: true };
+        log('Usage: duel [options]\n', 'info', bare);
+        log('Options:', 'info', bare);
+        log("--project, -p [path] \t Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'.", 'info', bare);
+        log('--pkg-dir, -k [path] \t The directory to start looking for a package.json file. Defaults to --project directory.', 'info', bare);
+        log('--modules, -m \t\t Transform module globals for dual build target. Defaults to false.', 'info', bare);
+        log('--dirs, -d \t\t Output both builds to directories inside of outDir. [esm, cjs].', 'info', bare);
+        log('--exports, -e \t Generate package.json exports. Values: wildcard | dir | name.', 'info', bare);
+        log('--help, -h \t\t Print this message.', 'info', bare);
     }
     else {
-        const { project, 'target-extension': targetExt, 'pkg-dir': pkgDir, modules, dirs, } = parsed;
+        const { project, 'target-extension': targetExt, 'pkg-dir': pkgDir, modules, dirs, exports: exportsOpt, } = parsed;
         let configPath = resolve(project);
         let stats = null;
         let pkg = null;
@@ -93,10 +99,15 @@ const init = async (args) => {
             if (!tsconfig.compilerOptions?.outDir) {
                 log('No outDir defined in tsconfig.json. Build output will be in "dist".');
             }
+            if (exportsOpt && !['wildcard', 'dir', 'name'].includes(exportsOpt)) {
+                logError('--exports expects one of: wildcard | dir | name');
+                return false;
+            }
             return {
                 pkg,
                 dirs,
                 modules,
+                exports: exportsOpt,
                 tsconfig,
                 projectDir,
                 configPath,

package/dist/esm/util.d.ts

@@ -1,4 +1,6 @@
-export function log(color?: string, msg?: string): void;
-export const logError: (msg?: string | undefined) => void;
+export function log(msg?: string, level?: string, opts?: {}): void;
+export function logError(msg: any): void;
+export function logSuccess(msg: any): void;
+export function logWarn(msg: any): void;
 export function getRealPathAsFileUrl(path: any): Promise<string>;
 export function getCompileFiles(tscBinPath: any, wd?: string): string[];

package/dist/esm/util.js

@@ -3,11 +3,35 @@ import { realpath } from 'node:fs/promises';
 import { spawnSync } from 'node:child_process';
 import { cwd, platform } from 'node:process';
 import { EOL } from 'node:os';
-const log = (color = '\x1b[30m', msg = '') => {
+const COLORS = {
+    reset: '\x1b[0m',
+    info: '\x1b[36m',
+    success: '\x1b[32m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m',
+};
+const log = (msg = '', level = 'info', opts = {}) => {
+    const { bare = false } = opts;
+    const palette = {
+        info: COLORS.info,
+        success: COLORS.success,
+        warn: COLORS.warn,
+        error: COLORS.error,
+    };
+    const badge = {
+        success: '[✓]',
+        warn: '[!]',
+        error: '[x]',
+        info: '[i]',
+    }[level];
+    const color = palette[level] ?? COLORS.info;
+    const prefix = !bare && badge ? `${badge} ` : '';
     // eslint-disable-next-line no-console
-    console.log(`${color}%s\x1b[0m`, msg);
+    console.log(`${color}${prefix}%s${COLORS.reset}`, msg);
 };
-const logError = log.bind(null, '\x1b[31m');
+const logSuccess = msg => log(msg, 'success');
+const logWarn = msg => log(msg, 'warn');
+const logError = msg => log(msg, 'error');
 const getRealPathAsFileUrl = async (path) => {
     const realPath = await realpath(path);
     const asFileUrl = pathToFileURL(realPath).href;
@@ -24,4 +48,4 @@ const getCompileFiles = (tscBinPath, wd = cwd()) => {
         .split(EOL)
         .filter(path => !/node_modules|^$/.test(path));
 };
-export { log, logError, getRealPathAsFileUrl, getCompileFiles };
+export { log, logError, logSuccess, logWarn, getRealPathAsFileUrl, getCompileFiles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knighted/duel",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "TypeScript dual packages.",
   "type": "module",
   "main": "dist/esm/duel.js",
@@ -67,7 +67,6 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
-    "@knighted/module": "^1.0.0-rc.2",
     "@tsconfig/recommended": "^1.0.10",
     "@types/node": "^24.10.1",
     "c8": "^10.1.3",
@@ -83,6 +82,7 @@
     "vite": "^7.2.4"
   },
   "dependencies": {
+    "@knighted/module": "^1.0.0-rc.6",
     "find-up": "^8.0.0",
     "get-tsconfig": "^4.13.0",
     "glob": "^13.0.0",