@williamthorsen/nmr 0.16.0 → 0.17.1

package/AGENTS.md

@@ -38,7 +38,7 @@ Some root scripts (e.g. `lint`, `typecheck`, `test`) expand to `nmr root:X && pn
 
 ## Managed build
 
-The default `compile` script runs `nmr-compile`, a standalone bin that esbuild-compiles a package's `src` to `dist/esm`, rewriting `~/` (package-root) import aliases and `.ts`→`.js` specifiers, and skipping work when inputs are unchanged. There is no repo-local build script to maintain; `nmr build` runs `compile` then `generate-typings`. To find or debug the build, look to `nmr-compile`, not a `config/build.ts` in the consuming repo.
+The default `compile` script runs `nmr-compile`, a standalone bin that uses the TypeScript compiler API to emit a package's `src` to `dist/esm` as `.js` and `.d.ts` in one pass, rewriting relative `.ts`→`.js` specifiers and tsconfig `paths` aliases in both outputs, and skipping work when inputs are unchanged. `typescript` is a peer dependency (`>=5.7.0`). There is no repo-local build script to maintain, and no separate typings step; `nmr build` runs `compile` alone. To find or debug the build, look to `nmr-compile`, not a `config/build.ts` in the consuming repo.
 
 ## Override behaviors
 

package/README.md

@@ -3,19 +3,13 @@
 Context-aware script runner for PNPM monorepos. Ships an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v0.16.0 (2026-06-30)
-
-### 🎉 Features
-
-- 🚨 **Breaking:** Auto-activate integration test variant from config presence (#448)
-
-  A package can now separate its integration tests from its standalone suite simply by including a `vitest.integration.config.ts` (alongside a `vitest.standalone.config.ts`). The `--int-test` flag that previously enabled this is removed — that config-file pairing is now the only way to activate the separation. In such a package, `test` and `test:coverage` run only the standalone suite and skip integration tests, while a new `test:all` runs both suites together. The separation now holds even when tests run across every package at once, so a full-workspace `test` run still keeps integration tests out of the default suite. Packages that previously hand-copied these test scripts no longer need to.
+## Release notes — v0.17.1 (2026-07-01)
 
 ### 🐛 Bug fixes
 
-- Prevent CLI output truncation when piped before exit (#446)
+- Relocate nmr-compile's build cache out of the published dist (#457)
 
-  Fixes an issue where large output from the `nmr` and `v11y` commands could be truncated when captured through a pipe — for example, by a CI job.
+  Fixes an issue where packages built with nmr-compile shipped an internal build-cache file inside their published npm tarball.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -32,7 +26,7 @@ From a package directory:
 
 ```bash
 nmr test          # Run tests for the current package
-nmr build         # Compile + generate typings
+nmr build         # Compile to .js and .d.ts in one pass
 nmr check         # Typecheck, format check, lint check, and tests
 ```
 
@@ -75,11 +69,11 @@ Scripts resolve through three tiers. Higher tiers override lower ones:
 
 Given the `build` command for a package that defines its own build script:
 
-| Tier | Source                  | Value                             | Wins? |
-| ---- | ----------------------- | --------------------------------- | ----- |
-| 1    | Built-in default        | `['compile', 'generate-typings']` | —     |
-| 2    | `.config/nmr.config.ts` | _(not set)_                       | —     |
-| 3    | `package.json` scripts  | `"tsx custom-build.ts"`           | ✓     |
+| Tier | Source                  | Value                   | Wins? |
+| ---- | ----------------------- | ----------------------- | ----- |
+| 1    | Built-in default        | `['compile']`           | —     |
+| 2    | `.config/nmr.config.ts` | _(not set)_             | —     |
+| 3    | `package.json` scripts  | `"tsx custom-build.ts"` | ✓     |
 
 If no per-package override exists, the highest-tier value that is set wins. Set a script to `""` in `package.json` to skip it for that package.
 
@@ -90,8 +84,8 @@ If no per-package override exists, the highest-tier value that is set wins. Set
 Script values can be `string` or `string[]`. Arrays expand to chained `nmr` sub-invocations:
 
 ```ts
-// "build": ["compile", "generate-typings"]
-// expands to: nmr compile && nmr generate-typings
+// "fix": ["lint", "fmt"]
+// expands to: nmr lint && nmr fmt
 ```
 
 ## Configuration
@@ -145,26 +139,26 @@ These scripts are available out of the box. Repo-wide config (tier 2) and per-pa
 
 ### Workspace scripts
 
-| Command            | Runs                                                     |
-| ------------------ | -------------------------------------------------------- |
-| `build`            | `compile`, `generate-typings`                            |
-| `check`            | `typecheck`, `fmt:check`, `lint:check`, `test`           |
-| `check:strict`     | `typecheck`, `fmt:check`, `lint:strict`, `test:coverage` |
-| `clean`            | `pnpm exec rimraf dist/*`                                |
-| `compile`          | `nmr-compile`                                            |
-| `fix`              | `lint`, `fmt`                                            |
-| `fix:check`        | `fmt:check`, `lint:check`                                |
-| `fmt`              | `prettier --list-different --write .`                    |
-| `fmt:check`        | `prettier --check .`                                     |
-| `generate-typings` | `tsc --project tsconfig.generate-typings.json`           |
-| `lint`             | `eslint --fix .`                                         |
-| `lint:check`       | `eslint .`                                               |
-| `lint:strict`      | `strict-lint`                                            |
-| `test`             | `pnpm exec vitest`                                       |
-| `test:coverage`    | `pnpm exec vitest --coverage`                            |
-| `test:watch`       | `pnpm exec vitest --watch`                               |
-| `typecheck`        | `tsgo --noEmit`                                          |
-| `view-coverage`    | `open coverage/index.html`                               |
+| Command         | Runs                                                             |
+| --------------- | ---------------------------------------------------------------- |
+| `attw`          | `attw --pack --profile esm-only`                                 |
+| `build`         | `compile`                                                        |
+| `check`         | `typecheck`, `fmt:check`, `lint:check`, `test`                   |
+| `check:strict`  | `typecheck`, `fmt:check`, `lint:strict`, `test:coverage`, `attw` |
+| `clean`         | `pnpm exec rimraf dist/*`                                        |
+| `compile`       | `nmr-compile`                                                    |
+| `fix`           | `lint`, `fmt`                                                    |
+| `fix:check`     | `fmt:check`, `lint:check`                                        |
+| `fmt`           | `prettier --list-different --write .`                            |
+| `fmt:check`     | `prettier --check .`                                             |
+| `lint`          | `eslint --fix .`                                                 |
+| `lint:check`    | `eslint .`                                                       |
+| `lint:strict`   | `strict-lint`                                                    |
+| `test`          | `pnpm exec vitest`                                               |
+| `test:coverage` | `pnpm exec vitest --coverage`                                    |
+| `test:watch`    | `pnpm exec vitest --watch`                                       |
+| `typecheck`     | `tsgo --noEmit`                                                  |
+| `view-coverage` | `open coverage/index.html`                                       |
 
 #### Integration test variant
 
@@ -190,11 +184,12 @@ A package gets this variant automatically when it contains a `vitest.integration
 
 #### Check and quality
 
-| Command             | Runs                                                                          |
-| ------------------- | ----------------------------------------------------------------------------- |
-| `check`             | `typecheck`, `fmt:check`, `lint:check`, `test`                                |
-| `check:agent-files` | `nmr-sync-agent-files --check`                                                |
-| `check:strict`      | `typecheck`, `fmt:check`, `lint:strict`, `test:coverage`, `check:agent-files` |
+| Command             | Runs                                                                                  |
+| ------------------- | ------------------------------------------------------------------------------------- |
+| `attw`              | `pnpm --recursive exec nmr attw`                                                      |
+| `check`             | `typecheck`, `fmt:check`, `lint:check`, `test`                                        |
+| `check:agent-files` | `nmr-sync-agent-files --check`                                                        |
+| `check:strict`      | `typecheck`, `fmt:check`, `lint:strict`, `test:coverage`, `attw`, `check:agent-files` |
 
 #### Fix
 
@@ -293,7 +288,7 @@ nmr [flags] <command> [args...]
 ```bash
 # From a package directory
 nmr test                    # Run workspace test script
-nmr build                   # Compile + generate typings
+nmr build                   # Compile to .js and .d.ts in one pass
 
 # From the monorepo root
 nmr test                    # Root tests + recursive workspace tests
@@ -350,7 +345,9 @@ nmr sync-pnpm-version
 
 ### `nmr-compile`
 
-Compile a single package's `src` tree to `dist/esm` with esbuild. Rewrites `~/` (package-root) import aliases and `.ts`→`.js` specifiers to match the emitted output, and skips the build when no input has changed (a content-and-path hash is cached in `dist/esm/.cache`). This is the default `compile` script — run it from a package directory.
+Compile a single package's `src` tree to `dist/esm` with the TypeScript compiler API, emitting `.js` and `.d.ts` in one pass. Because the compiler parses each source file, every relative import form — static, re-export, dynamic `import()`, and bare side-effect — is rewritten from `.ts` to `.js` in both outputs, and `.ts` occurrences inside strings and comments are left intact. tsconfig `paths` aliases are resolved to runnable relative `.js` specifiers in both outputs, sourced from the package's tsconfig. The build is skipped when no input has changed (a content-and-path hash is cached under `node_modules/.cache/nmr-compile/`, outside the published output). This is the default `compile` script — run it from a package directory.
+
+`typescript` is a peer dependency (`>=5.7.0`, required for `rewriteRelativeImportExtensions`); the consuming repo provides it. Relative imports in source must carry explicit `.ts` extensions for them to be rewritten.
 
 ```bash
 nmr-compile

package/dist/esm/cli-build.js

@@ -1,8 +1,8 @@
 import { buildPackage } from "./commands/build.js";
 try {
-  await buildPackage(process.cwd());
-} catch (error) {
-  process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-  process.exitCode = 1;
+    await buildPackage(process.cwd());
+}
+catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
 }

package/dist/esm/cli-ensure-prepublish-hooks.js

@@ -1,44 +1,43 @@
-import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { DEFAULT_HOOK, ensurePrepublishHooks } from "./commands/ensure-prepublish-hooks.js";
 import { findMonorepoRoot } from "./context.js";
 const flagSchema = {
-  fix: { long: "--fix", type: "boolean" },
-  dryRun: { long: "--dry-run", type: "boolean" },
-  command: { long: "--command", type: "string" }
+    fix: { long: '--fix', type: 'boolean' },
+    dryRun: { long: '--dry-run', type: 'boolean' },
+    command: { long: '--command', type: 'string' },
 };
 const { fix, dryRun, command } = parseArgsOrExit(process.argv.slice(2), flagSchema).flags;
 try {
-  const monorepoRoot = findMonorepoRoot();
-  const hookCommand = command ?? DEFAULT_HOOK;
-  const options = command ? { fix, dryRun, command } : { fix, dryRun };
-  const result = ensurePrepublishHooks(monorepoRoot, options);
-  for (const pkg of result.packages) {
-    if (pkg.isPrivate) {
-      continue;
+    const monorepoRoot = findMonorepoRoot();
+    const hookCommand = command ?? DEFAULT_HOOK;
+    const options = command ? { fix, dryRun, command } : { fix, dryRun };
+    const result = ensurePrepublishHooks(monorepoRoot, options);
+    for (const pkg of result.packages) {
+        if (pkg.isPrivate) {
+            continue;
+        }
+        switch (pkg.action) {
+            case 'ok':
+                console.info(`✓ ${pkg.packageName}: prepublishOnly = "${pkg.prepublishOnly}"`);
+                break;
+            case 'missing':
+                console.warn(`✗ ${pkg.packageName}: missing prepublishOnly`);
+                break;
+            case 'fixed':
+                console.info(`✓ ${pkg.packageName}: added prepublishOnly = "${hookCommand}"`);
+                break;
+            case 'would-fix':
+                console.info(`~ ${pkg.packageName}: would add prepublishOnly = "${hookCommand}"`);
+                break;
+        }
     }
-    switch (pkg.action) {
-      case "ok":
-        console.info(`\u2713 ${pkg.packageName}: prepublishOnly = "${pkg.prepublishOnly}"`);
-        break;
-      case "missing":
-        console.warn(`\u2717 ${pkg.packageName}: missing prepublishOnly`);
-        break;
-      case "fixed":
-        console.info(`\u2713 ${pkg.packageName}: added prepublishOnly = "${hookCommand}"`);
-        break;
-      case "would-fix":
-        console.info(`~ ${pkg.packageName}: would add prepublishOnly = "${hookCommand}"`);
-        break;
+    if (result.hasFailures) {
+        const missing = result.packages.filter((p) => p.action === 'missing').length;
+        process.stderr.write(`\n${missing} package(s) missing prepublishOnly. Use --fix to add it.\n`);
+        process.exitCode = 1;
     }
-  }
-  if (result.hasFailures) {
-    const missing = result.packages.filter((p) => p.action === "missing").length;
-    process.stderr.write(`
-${missing} package(s) missing prepublishOnly. Use --fix to add it.
-`);
+}
+catch (error) {
+    reportError(error instanceof Error ? error.message : String(error));
     process.exitCode = 1;
-  }
-} catch (error) {
-  reportError(error instanceof Error ? error.message : String(error));
-  process.exitCode = 1;
 }

package/dist/esm/cli-report-overrides.js

@@ -1,10 +1,11 @@
-import { reportError } from "@williamthorsen/nmr-core";
+import { reportError } from '@williamthorsen/nmr-core';
 import { reportOverrides } from "./commands/report-overrides.js";
 import { findMonorepoRoot } from "./context.js";
 try {
-  const monorepoRoot = findMonorepoRoot();
-  reportOverrides(monorepoRoot);
-} catch (error) {
-  reportError(error instanceof Error ? error.message : String(error));
-  process.exitCode = 1;
+    const monorepoRoot = findMonorepoRoot();
+    reportOverrides(monorepoRoot);
+}
+catch (error) {
+    reportError(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
 }

package/dist/esm/cli-sync-agent-files.js

@@ -1,31 +1,29 @@
-import { parseArgsOrExit, reportError } from "@williamthorsen/nmr-core";
+import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { check, sync } from "./commands/sync-agent-files.js";
 import { findMonorepoRoot } from "./context.js";
 const flagSchema = {
-  check: { long: "--check", type: "boolean" }
+    check: { long: '--check', type: 'boolean' },
 };
 const { flags } = parseArgsOrExit(process.argv.slice(2), flagSchema);
 try {
-  runCommand(flags.check);
-} catch (error) {
-  reportError(error instanceof Error ? error.message : String(error));
-  process.exit(1);
+    runCommand(flags.check);
+}
+catch (error) {
+    reportError(error instanceof Error ? error.message : String(error));
+    process.exit(1);
 }
 function runCommand(checkOnly) {
-  const monorepoRoot = findMonorepoRoot();
-  if (!checkOnly) {
-    const { path: destinationPath, packageSpecifier, changed } = sync(monorepoRoot);
-    console.info(
-      changed ? `\u2713 Wrote ${destinationPath} (${packageSpecifier})` : `\u2713 ${destinationPath} already up to date`
-    );
-    process.exit(0);
-  }
-  const result = check(monorepoRoot);
-  if (result.ok) {
-    console.info("\u2713 .agents/nmr/AGENTS.md is in sync");
-    process.exit(0);
-  }
-  process.stderr.write(`${result.reason}
-`);
-  process.exit(1);
+    const monorepoRoot = findMonorepoRoot();
+    if (!checkOnly) {
+        const { path: destinationPath, packageSpecifier, changed } = sync(monorepoRoot);
+        console.info(changed ? `✓ Wrote ${destinationPath} (${packageSpecifier})` : `✓ ${destinationPath} already up to date`);
+        process.exit(0);
+    }
+    const result = check(monorepoRoot);
+    if (result.ok) {
+        console.info('✓ .agents/nmr/AGENTS.md is in sync');
+        process.exit(0);
+    }
+    process.stderr.write(`${result.reason}\n`);
+    process.exit(1);
 }

package/dist/esm/cli-sync-pnpm-version.js

@@ -1,10 +1,11 @@
-import { reportError } from "@williamthorsen/nmr-core";
+import { reportError } from '@williamthorsen/nmr-core';
 import { syncPnpmVersion } from "./commands/sync-pnpm-version.js";
 import { findMonorepoRoot } from "./context.js";
 try {
-  const monorepoRoot = findMonorepoRoot();
-  syncPnpmVersion(monorepoRoot);
-} catch (error) {
-  reportError(error instanceof Error ? error.message : String(error));
-  process.exitCode = 1;
+    const monorepoRoot = findMonorepoRoot();
+    syncPnpmVersion(monorepoRoot);
+}
+catch (error) {
+    reportError(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
 }

package/dist/esm/cli.js

@@ -1,16 +1,16 @@
-import process from "node:process";
+import process from 'node:process';
 import { runCli } from "./runCli.js";
 try {
-  const { exitCode } = await runCli({
-    args: process.argv.slice(2),
-    cwd: process.cwd(),
-    env: process.env,
-    stdout: process.stdout,
-    stderr: process.stderr
-  });
-  process.exitCode = exitCode;
-} catch (error) {
-  process.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}
-`);
-  process.exitCode = 1;
+    const { exitCode } = await runCli({
+        args: process.argv.slice(2),
+        cwd: process.cwd(),
+        env: process.env,
+        stdout: process.stdout,
+        stderr: process.stderr,
+    });
+    process.exitCode = exitCode;
+}
+catch (error) {
+    process.stderr.write(`${error instanceof Error ? (error.stack ?? error.message) : String(error)}\n`);
+    process.exitCode = 1;
 }

package/dist/esm/commands/build.d.ts

@@ -1,15 +1,9 @@
-import { type Format, type Platform } from 'esbuild';
 export interface BuildOptions {
-    aliases?: Record<string, string>;
     entryGlobs?: string[];
     ignore?: string[];
     outdir?: string;
-    cacheFile?: string;
-    format?: Format;
-    platform?: Platform;
-    target?: string;
 }
 export declare function buildPackage(packageDir: string, options?: BuildOptions): Promise<void>;
-export declare function computeBuildHash(packageDir: string, files: string[], outputConfig: object): Promise<string>;
-export declare function resolveAliasImports(code: string, fileDir: string, aliasMap: Record<string, string>, packageDir: string): string;
-export declare function rewriteTsImportExtensions(code: string): string;
+export declare function computeBuildHash(packageDir: string, files: string[], emitConfig: object): Promise<string>;
+export declare function resolveTsconfigChain(packageDir: string, configFileName?: string): string[];
+export declare function resolveBuildCachePath(packageDir: string): string;