Alex2Node/scripts/build.mjs
David 70072d39e3 build: the ES module build gets its own declarations
An ES module TypeScript consumer was given the CommonJS declarations in dist/types. With those,
`import alex2node from "alex2node"` compiled (module Node16) and then failed when Node loaded it: "The requested
module 'alex2node' does not provide an export named 'default'". The ES module build has named exports only.

tsconfig.esm.json now emits declarations next to dist/esm/*.js, under that directory's {"type": "module"}, and
"exports" selects per condition: import -> dist/esm/index.d.ts, require -> dist/types/index.d.ts. The default
import is now refused with TS1192; named imports are unchanged. "main", "module" and "types" are as before.

test/fixtures/types.mts holds the default import under @ts-expect-error, and a new test requires "types" before
"default" and a declaration for every built file. dist/: 25 files, 132,291 B -> 33 files, 155,647 B; the npm
tarball 25,125 B -> 25,837 B. npm test: 25 pass in 5.6 s.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-28 14:31:34 +00:00

51 lines
2.4 KiB
JavaScript

// npm run build - the only writer of dist/.
//
// node scripts/build.mjs [--out <dir>] <dir> defaults to dist/ in the package
//
// Two compiler runs over src/: CommonJS with its declarations (cjs/, types/), then ES modules with theirs (esm/).
// TypeScript reads a .d.ts as CommonJS or as an ES module by the package.json above it, so each build needs its own
// set: the one in types/ would tell an ES module consumer that a default import works. Both runs write to a staging
// directory that replaces the three directories only after both passed, so a failed build leaves the tracked dist/
// as it was. Files of sources that no longer exist go with the old directories.
import { spawnSync } from "node:child_process";
import { mkdirSync, mkdtempSync, renameSync, rmSync, writeFileSync } from "node:fs";
import { createRequire } from "node:module";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";
const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
const tsc = createRequire(import.meta.url).resolve("typescript/bin/tsc");
function outputDirectory(args) {
const at = args.indexOf("--out");
if (at === -1) return join(root, "dist");
if (!args[at + 1]) throw new Error("--out needs a directory");
return resolve(args[at + 1]);
}
function compile(project, options) {
const run = spawnSync(process.execPath, [tsc, "-p", join(root, project), ...options], { cwd: root, stdio: "inherit" });
if (run.error) throw run.error;
if (run.status !== 0) throw new Error(`tsc -p ${project} failed, ${out} is unchanged`);
}
let out;
let staging;
try {
out = outputDirectory(process.argv.slice(2));
mkdirSync(out, { recursive: true });
staging = mkdtempSync(join(out, ".build-"));
compile("tsconfig.cjs.json", ["--outDir", join(staging, "cjs"), "--declarationDir", join(staging, "types")]);
compile("tsconfig.esm.json", ["--outDir", join(staging, "esm")]);
// The package is "type": "commonjs"; this marks the .js files under esm/ as ES modules.
writeFileSync(join(staging, "esm", "package.json"), JSON.stringify({ type: "module" }, null, 2) + "\n");
for (const part of ["cjs", "esm", "types"]) {
rmSync(join(out, part), { recursive: true, force: true });
renameSync(join(staging, part), join(out, part));
}
} catch (err) {
console.error(`build: ${err.message}`);
process.exitCode = 1;
} finally {
if (staging) rmSync(staging, { recursive: true, force: true });
}