@williamthorsen/nmr 2.0.0 → 2.0.1

package/.meta/changelog.json

@@ -1,4 +1,78 @@
 [
+  {
+    "version": "2.0.1",
+    "date": "2026-11-11",
+    "sections": [
+      {
+        "title": "🐛 Bug fixes",
+        "audience": "all",
+        "items": [
+          {
+            "description": "Fixes the issue that `nmr-clean`, `nmr-compile`, `nmr-report-catalog`, and `nmr-report-overrides` ignored their arguments, so `--help` or a mistyped option ran the command, and `nmr-clean --help` removed build output instead of printing usage. (#1273)",
+            "hash": "a4bfd2bc9c298a919c15070bae4437188c0edb37",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "♻️ Refactoring",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Adds an optional `spawn` adapter to `runPrettier` in `packages/nmr/src/commands/fmt.ts`, which defaults to `spawnSync` with inherited stdio, so that a test can replace the Prettier process without mocking `node:child_process`. (#1271)",
+            "hash": "18227bf9c7d8fb0fb11bf3382602be131603419a",
+            "entry": 1
+          },
+          {
+            "description": "Extracts the unchanged-build skip report from `detectBuildChanges` into the exported `reportUnchangedBuild`, which takes the environment as a parameter rather than reading `process.env`. (#1272)",
+            "hash": "7708c82fe5b528709dd3c822c1449b6a843292c4",
+            "entry": 1
+          },
+          {
+            "description": "Replaces the copies of the entry-point `glob` call in `buildPackage` and `hasBuildOutput` with one function, `resolveEntryPoints` in `build-output.ts`, so the build and the check cache's probe for build output cannot select different files. (#1274)",
+            "hash": "aadd160714f8a4b00aa9965897b97fb15ee8500b",
+            "entry": 1
+          },
+          {
+            "description": "Moves the printing of the build's progress and outcome lines from `buildPackage` to `nmr-compile`, which renders the `BuildOutcome` returned by `buildPackage` and the events from its new `onProgress` callback through `build-report.ts`. (#1277)",
+            "hash": "7204e9ebbb7ef2d60f0ddf74a1ea4de4b62e50c0",
+            "entry": 1
+          },
+          {
+            "description": "Moves the emit's staging, swap by rename, and scratch-directory handling from `build.ts` and `build-output.ts` into `publish-output.ts`, which `build.ts` now calls with the emit directory. (#1278)",
+            "hash": "27bc6915156ae739206679b977baf91267f73fa9",
+            "entry": 1
+          },
+          {
+            "description": "Makes `cleanFrom` in `clean.ts` return a `CleanOutcome` and report each completed step through an `onProgress` callback rather than print, leaving `runClean` as the only function that prints, through the renderers in the new `clean-report.ts`. (#1279)",
+            "hash": "5188dd2411cd737d337ae8bf232fc68d5bc911c6",
+            "entry": 1
+          }
+        ]
+      },
+      {
+        "title": "🧪 Tests",
+        "audience": "dev",
+        "items": [
+          {
+            "description": "Moves the `runPrettier` cases from `fmt.tool.test.ts` to a new `fmt.unit.test.ts` that asserts on the invocations recorded by a spawn fake, and adds cases for a spawn error and for a Prettier process killed by a signal. (#1271)",
+            "hash": "18227bf9c7d8fb0fb11bf3382602be131603419a",
+            "entry": 2
+          },
+          {
+            "description": "Replaces six skip-report cases in `build.publication.tool.test.ts`, each of which compiled a package to seed the cache, with unit tests of `reportUnchangedBuild` in `build.unit.test.ts` that write the recorded emit duration directly. (#1272)",
+            "hash": "7708c82fe5b528709dd3c822c1449b6a843292c4",
+            "entry": 2
+          },
+          {
+            "description": "Tests `resolveEntryPoints` directly in `build-output.unit.test.ts` and removes the tool-tier tests in `build.tool.test.ts` that checked the same default exclusions, `ignorePatterns` override, and `extraIgnorePatterns` composition through a full build. (#1274)",
+            "hash": "aadd160714f8a4b00aa9965897b97fb15ee8500b",
+            "entry": 2
+          }
+        ]
+      }
+    ]
+  },
   {
     "version": "2.0.0",
     "date": "2026-11-10",

package/.readyup/kits/default.js

@@ -1,6 +1,6 @@
 /** @noformat -- @generated. Do not edit. Compiled by rdy. */
 /* eslint-disable */
-export const __readyupVersion = "0.45.0";
+export const __readyupVersion = "0.45.1";
 import { createRequire as __rdyCreateRequire } from 'node:module';
 const require = __rdyCreateRequire(import.meta.url);
 
@@ -7382,12 +7382,12 @@ import { isRecord, listTrackedFiles } from "readyup/check-utils";
 import { globSync } from "node:fs";
 import { basename, join, sep } from "node:path";
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.1/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/isError.js
 function isError(error) {
   return error instanceof Error || Object.prototype.toString.call(error) === "[object Error]";
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.0/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.errors@0.9.1/node_modules/@williamthorsen/toolbelt.errors/dist/esm/4-release/describeError.js
 function describeError(error) {
   try {
     if (isError(error) && typeof error.message === "string" && error.message !== "") {
@@ -8162,11 +8162,11 @@ function formatMalformedScript(dir, key, value) {
   return `${rejection} A step list belongs in \`${CONFIG_RELATIVE_PATH}\` under \`${field}\`.`;
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
 import path6 from "node:path";
 import process2 from "node:process";
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/UsageError.js
 var UsageError = class extends Error {
   constructor(message, options) {
     super(message, options);
@@ -8174,7 +8174,7 @@ var UsageError = class extends Error {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/ParseError.js
 var ParseError = class extends UsageError {
   kind;
   token;
@@ -8186,12 +8186,12 @@ var ParseError = class extends UsageError {
   }
 };
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/resolveLongName.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/resolveLongName.js
 function resolveLongName(key, definition) {
   return definition.long ?? key.replaceAll(/[A-Z]/g, (capital) => `-${capital.toLowerCase()}`);
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/tokenizeArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/tokenizeArgs.js
 import { parseArgs as nodeParseArgs } from "node:util";
 function tokenizeArgs(argv, schema, extraBooleans = []) {
   const nodeOptions = {};
@@ -8221,7 +8221,7 @@ function findFlagEntry(flagsByName, token) {
   return entry.definition.short === token.rawName.slice(1) ? entry : void 0;
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/validateSpec.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/validateSpec.js
 var CAMEL_CASE_KEY = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]+)*$/;
 function validateSpec(spec) {
   validateFlags(spec.flags ?? {});
@@ -8302,7 +8302,7 @@ function validateOperands(operands) {
   }
 }
 
-// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.0/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
+// ../../node_modules/.pnpm/@williamthorsen+toolbelt.cli@0.8.1/node_modules/@williamthorsen/toolbelt.cli/dist/esm/3-candidate/parseArgs.js
 function parseArgs(argv, spec, options = {}) {
   validateSpec(spec);
   return parseValidatedArgs(argv, spec, options);
@@ -9595,7 +9595,7 @@ function hasSupportedStrictLintVersion() {
   });
 }
 function getMinVersion() {
-  const pickedFields = { "version": "2.0.0" };
+  const pickedFields = { "version": "2.0.1" };
   if (typeof pickedFields["version"] !== "string") {
     throw new TypeError("nmr/package.json: 'version' must be a string");
   }

package/.readyup/manifest.json

@@ -3,19 +3,19 @@
   "kits": [
     {
       "bundledDependencies": {
-        "@williamthorsen/toolbelt.arrays": "6.4.1",
-        "@williamthorsen/toolbelt.cli": "0.8.0",
-        "@williamthorsen/toolbelt.datetime": "4.1.1",
-        "@williamthorsen/toolbelt.errors": "0.9.0",
-        "@williamthorsen/toolbelt.filesystem": "0.10.0",
-        "@williamthorsen/toolbelt.guards": "4.2.0",
-        "@williamthorsen/toolbelt.numbers": "7.3.1",
-        "@williamthorsen/toolbelt.objects": "4.4.0",
-        "@williamthorsen/toolbelt.packaging": "0.7.0",
+        "@williamthorsen/toolbelt.arrays": "6.4.2",
+        "@williamthorsen/toolbelt.cli": "0.8.1",
+        "@williamthorsen/toolbelt.datetime": "4.1.2",
+        "@williamthorsen/toolbelt.errors": "0.9.1",
+        "@williamthorsen/toolbelt.filesystem": "0.10.1",
+        "@williamthorsen/toolbelt.guards": "4.2.1",
+        "@williamthorsen/toolbelt.numbers": "7.3.2",
+        "@williamthorsen/toolbelt.objects": "4.4.1",
+        "@williamthorsen/toolbelt.packaging": "0.7.1",
         "@williamthorsen/toolbelt.sets": "3.1.0",
-        "@williamthorsen/toolbelt.strings": "8.2.1",
+        "@williamthorsen/toolbelt.strings": "8.2.2",
         "@williamthorsen/toolbelt.terminal": "0.3.0",
-        "ansi-regex": "6.5.0",
+        "ansi-regex": "6.6.0",
         "ansi-styles": "6.2.3",
         "cli-truncate": "6.1.1",
         "diff": "9.0.0",
@@ -32,7 +32,7 @@
           "checklist": "nmr",
           "checks": [
             "@williamthorsen/nmr in devDependencies",
-            "@williamthorsen/nmr >= 2.0.0",
+            "@williamthorsen/nmr >= 2.0.1",
             "pnpm-workspace.yaml exists",
             "catalogued dependencies use catalog:",
             "package.json has packageManager field",
@@ -236,7 +236,7 @@
           "path": "lib/workspace-build.ts"
         },
         {
-          "hash": "6933f29e",
+          "hash": "c0b5a504",
           "kind": "inline",
           "path": "../package.json",
           "paths": [
@@ -356,10 +356,10 @@
       ],
       "name": "default",
       "path": "kits/default.js",
-      "readyupVersion": "0.45.0",
+      "readyupVersion": "0.45.1",
       "source": "kits/default.ts",
       "sourceHash": "9fd61bf4",
-      "targetHash": "7ddb0518"
+      "targetHash": "8eca943d"
     }
   ]
 }

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## 2.0.1 — 2026-11-11
+
+### 🐛 Bug fixes
+
+- Fixes the issue that `nmr-clean`, `nmr-compile`, `nmr-report-catalog`, and `nmr-report-overrides` ignored their arguments, so `--help` or a mistyped option ran the command, and `nmr-clean --help` removed build output instead of printing usage. (#1273)
+
+### ♻️ Refactoring
+
+- Adds an optional `spawn` adapter to `runPrettier` in `packages/nmr/src/commands/fmt.ts`, which defaults to `spawnSync` with inherited stdio, so that a test can replace the Prettier process without mocking `node:child_process`. (#1271)
+- Extracts the unchanged-build skip report from `detectBuildChanges` into the exported `reportUnchangedBuild`, which takes the environment as a parameter rather than reading `process.env`. (#1272)
+- Replaces the copies of the entry-point `glob` call in `buildPackage` and `hasBuildOutput` with one function, `resolveEntryPoints` in `build-output.ts`, so the build and the check cache's probe for build output cannot select different files. (#1274)
+- Moves the printing of the build's progress and outcome lines from `buildPackage` to `nmr-compile`, which renders the `BuildOutcome` returned by `buildPackage` and the events from its new `onProgress` callback through `build-report.ts`. (#1277)
+- Moves the emit's staging, swap by rename, and scratch-directory handling from `build.ts` and `build-output.ts` into `publish-output.ts`, which `build.ts` now calls with the emit directory. (#1278)
+- Makes `cleanFrom` in `clean.ts` return a `CleanOutcome` and report each completed step through an `onProgress` callback rather than print, leaving `runClean` as the only function that prints, through the renderers in the new `clean-report.ts`. (#1279)
+
+### 🧪 Tests
+
+- Moves the `runPrettier` cases from `fmt.tool.test.ts` to a new `fmt.unit.test.ts` that asserts on the invocations recorded by a spawn fake, and adds cases for a spawn error and for a Prettier process killed by a signal. (#1271)
+- Replaces six skip-report cases in `build.publication.tool.test.ts`, each of which compiled a package to seed the cache, with unit tests of `reportUnchangedBuild` in `build.unit.test.ts` that write the recorded emit duration directly. (#1272)
+- Tests `resolveEntryPoints` directly in `build-output.unit.test.ts` and removes the tool-tier tests in `build.tool.test.ts` that checked the same default exclusions, `ignorePatterns` override, and `extraIgnorePatterns` composition through a full build. (#1274)
+
 ## 2.0.0 — 2026-11-10
 
 ### 🪦 Removed

package/README.md

@@ -5,11 +5,11 @@
 Context-aware script runner for pnpm monorepos. Includes an `nmr` (node-monorepo run) binary that provides centralized, consistent script execution across workspace packages and the monorepo root.
 
 <!-- section:release-notes -->
-## Release notes — v2.0.0 (2026-11-10)
+## Release notes — v2.0.1 (2026-11-11)
 
-### 🪦 Removed
+### 🐛 Bug fixes
 
-- 🚨 **Breaking:** Removes the `devBin` root-config field of `@williamthorsen/nmr`, which replaced the first token of a resolved command with a command that ran a bin from source. (#1269)
+- Fixes the issue that `nmr-clean`, `nmr-compile`, `nmr-report-catalog`, and `nmr-report-overrides` ignored their arguments, so `--help` or a mistyped option ran the command, and `nmr-clean --help` removed build output instead of printing usage. (#1273)
 <!-- /section:release-notes -->
 
 ## Installation

package/dist/esm/cli-build.js

@@ -1,16 +1,9 @@
+import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_COMPILE_BIN } from "./bins.js";
-import { buildPackage } from "./commands/build.js";
-import { loadWorkspaceConfig } from "./config.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
+import { runCompile } from "./commands/compile.js";
 try {
-    const { stdout } = resolveBinStyles();
-    const packageDir = process.cwd();
-    const { build } = await loadWorkspaceConfig(packageDir);
-    await buildPackage(packageDir, {
-        style: stdout,
-        ...(build?.extraIgnorePatterns !== undefined && { extraIgnorePatterns: build.extraIgnorePatterns }),
-    });
+    process.exitCode = await runCompile(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_COMPILE_BIN, error);

package/dist/esm/cli-clean.js

@@ -2,9 +2,8 @@ import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_CLEAN_BIN } from "./bins.js";
 import { runClean } from "./commands/clean.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
 try {
-    await runClean(process.cwd(), resolveBinStyles().stdout);
+    process.exitCode = await runClean(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_CLEAN_BIN, error);

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

@@ -1,10 +1,9 @@
 import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_REPORT_CATALOG_BIN } from "./bins.js";
-import { reportCatalog } from "./commands/report-catalog.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
+import { runReportCatalog } from "./commands/report-catalog.js";
 try {
-    reportCatalog(process.cwd(), resolveBinStyles().stderr);
+    process.exitCode = await runReportCatalog(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_REPORT_CATALOG_BIN, error);

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

@@ -1,11 +1,9 @@
+import process from 'node:process';
 import { reportFailure } from '@williamthorsen/nmr-core';
 import { NMR_REPORT_OVERRIDES_BIN } from "./bins.js";
-import { reportOverrides } from "./commands/report-overrides.js";
-import { resolveBinStyles } from "./resolveBinStyles.js";
-import { findMonorepoRoot } from "./workspace.js";
+import { runReportOverrides } from "./commands/report-overrides.js";
 try {
-    const monorepoRoot = findMonorepoRoot();
-    reportOverrides(monorepoRoot, resolveBinStyles().stderr);
+    process.exitCode = await runReportOverrides(process.argv.slice(2), process.cwd());
 }
 catch (error) {
     reportFailure(NMR_REPORT_OVERRIDES_BIN, error);

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

@@ -6,28 +6,13 @@ export interface BuildOptions {
     ignorePatterns?: string[];
     outdir?: string;
 }
-/** The pair of directories through which a build publishes, both siblings of the emit directory. */
-export interface ScratchDirs {
-    previousDir: string;
-    stagingDir: string;
-}
-export declare const DEFAULT_ENTRY_GLOBS: string[];
-/**
- * Directories holding test scaffolding rather than published code, excluded from entry-point selection so that a
- * package does not publish its own helpers. The list differs from the vitest factory's `COVERAGE_EXCLUDE`, which
- * leaves `test-utils/` inside the coverage include set, and neither list can be derived from the other.
- *
- * Ignoring a file removes it as an entry point, not from the emit. The compiler still emits whatever the
- * surviving entry points import, which keeps a production module that uses a helper from emitting a dangling
- * specifier. Widening this list can therefore only drop files that production code does not import.
- */
-export declare const DEFAULT_IGNORE_PATTERNS: string[];
 export declare const DEFAULT_OUTDIR = "dist/esm/";
 /**
- * Reports whether the output that a build of `packageDir` would produce is currently on disk. Applies the build's
- * own rule, on the same options that the build was given, so a caller probing for output and the build deciding
- * whether to rebuild cannot disagree: A package whose entry points emit nothing does not expect any output, and
- * reports present. Passing options that the build was not given would make the two disagree.
+ * Reports whether the output that a build of `packageDir` would produce is currently on disk. Selects entry points
+ * through `resolveEntryPoints` and tests them through `hasExpectedBuildOutput`, as the build does, so a caller
+ * probing for output and the build deciding whether to rebuild cannot disagree: A package whose entry points emit
+ * nothing does not expect any output, and reports present. Passing options that the build was not given would make
+ * the two disagree.
  */
 export declare function hasBuildOutput(packageDir: string, options?: BuildOptions): Promise<boolean>;
 /**
@@ -65,18 +50,8 @@ export declare function resolveBuildCachePath(packageDir: string): string;
  * `readBuildDigest` returns.
  */
 export declare function resolveEmitDurationPath(packageDir: string): string;
-/**
- * Resolves the two scratch directories through which a build publishes: `staging`, which the emit is written to,
- * and `previous`, which the outgoing output is renamed aside to. Both are siblings of the emit directory, so a
- * rename between them never crosses a filesystem, and both are dot-prefixed so that a leftover stays out of the
- * globs that select sources.
- *
- * The names are fixed rather than unique because the build removes both before use. A unique name would need a
- * sweep to accomplish that removal, and a sweep cannot tell a directory orphaned by a killed run from one that a
- * concurrent build is still writing. Because a directory left behind by a failed build is cleared the same way,
- * the failure path does not need any cleanup of its own.
- */
-export declare function resolveScratchDirs(emitDir: string): ScratchDirs;
+/** Selects the entry points that a build of `packageDir` compiles, as paths relative to `packageDir`. */
+export declare function resolveEntryPoints(packageDir: string, options?: BuildOptions): Promise<string[]>;
 /**
  * Resolves the fingerprint of the nmr compiling `packageDir`, the `BuildToolchain` member that identifies nmr. It
  * is nmr's own build digest when one is on disk, which changes on a dev-loop edit that the version does not

package/dist/esm/commands/build-output.js

@@ -3,17 +3,14 @@ import path from 'node:path';
 import { findPackageRoot, readCacheEntry, readGuardedCacheEntry, resolveCacheEntryPath, writeGuardedCacheEntry, } from '@williamthorsen/nmr-core';
 import { glob } from 'glob';
 import { readPackageJson } from "../helpers/package-json.js";
-export const DEFAULT_ENTRY_GLOBS = ['src/**/*.{ts,tsx}'];
-export const DEFAULT_IGNORE_PATTERNS = ['**/__fixtures__/**', '**/__mocks__/**', '**/__tests__/**', '**/test-utils/**'];
+const DEFAULT_ENTRY_GLOBS = ['src/**/*.{ts,tsx}'];
+const DEFAULT_IGNORE_PATTERNS = ['**/__fixtures__/**', '**/__mocks__/**', '**/__tests__/**', '**/test-utils/**'];
 export const DEFAULT_OUTDIR = 'dist/esm/';
 const BUILD_CACHE_TOOL = 'nmr-compile';
 const SELF_DIR = findPackageRoot(import.meta.url);
 export async function hasBuildOutput(packageDir, options = {}) {
     const outdir = options.outdir ?? DEFAULT_OUTDIR;
-    const entryPoints = await glob(options.entryGlobs ?? DEFAULT_ENTRY_GLOBS, {
-        cwd: packageDir,
-        ignore: [...(options.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS), ...(options.extraIgnorePatterns ?? [])],
-    });
+    const entryPoints = await resolveEntryPoints(packageDir, options);
     return hasExpectedBuildOutput(packageDir, outdir, entryPoints);
 }
 export function hasExpectedBuildOutput(packageDir, outdir, entryPoints) {
@@ -49,13 +46,11 @@ export function resolveEmitDurationPath(packageDir) {
         extension: '.duration.json',
     });
 }
-export function resolveScratchDirs(emitDir) {
-    const parent = path.dirname(emitDir);
-    const name = path.basename(emitDir);
-    return {
-        previousDir: path.join(parent, `.${name}.previous`),
-        stagingDir: path.join(parent, `.${name}.staging`),
-    };
+export async function resolveEntryPoints(packageDir, options = {}) {
+    return glob(options.entryGlobs ?? DEFAULT_ENTRY_GLOBS, {
+        cwd: packageDir,
+        ignore: [...(options.ignorePatterns ?? DEFAULT_IGNORE_PATTERNS), ...(options.extraIgnorePatterns ?? [])],
+    });
 }
 export async function resolveToolchainFingerprint(packageDir, selfDir = SELF_DIR) {
     if (!isSameDir(packageDir, selfDir)) {

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

@@ -0,0 +1,6 @@
+import { type OutputStyle } from '@williamthorsen/nmr-core';
+import type { BuildOutcome, BuildProgress } from './build.js';
+/** Renders the line that closes a build: the skip, naming the saving when it is worth naming, or the emit. */
+export declare function renderBuildOutcome(outcome: BuildOutcome, packageName: string, style: OutputStyle): string;
+/** Renders the line that announces an emit, naming why the build is about to run. */
+export declare function renderBuildProgress(progress: BuildProgress, packageName: string, style: OutputStyle): string;

package/dist/esm/commands/build-report.js

@@ -0,0 +1,21 @@
+import { formatGlyphLine, STATUS_GLYPHS } from '@williamthorsen/nmr-core';
+import { NMR_GLYPHS } from "../glyphs.js";
+import { formatSaving } from "../helpers/duration.js";
+export function renderBuildOutcome(outcome, packageName, style) {
+    if (outcome.kind === 'unchanged') {
+        const saving = formatSaving(outcome.savedMs ?? 0);
+        const savingClause = saving === undefined ? '' : `, ${saving}`;
+        return `${STATUS_GLYPHS[style].skipped.text} ${packageName}: No changes detected. Skipping build${savingClause}.`;
+    }
+    return formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: ${describeEmit(outcome.fileCount, outcome.outdir)}`);
+}
+export function renderBuildProgress(progress, packageName, style) {
+    const message = progress.kind === 'output-missing' ? 'Build output is missing. Rebuilding.' : 'Changes detected.';
+    return formatGlyphLine(NMR_GLYPHS, style, 'package', `${packageName}: ${message}`);
+}
+function describeEmit(fileCount, outdir) {
+    if (fileCount === 0) {
+        return 'Did not emit any output.';
+    }
+    return `Compiled ${fileCount} files to ${outdir.replace(/\/+$/u, '')}.`;
+}

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

@@ -1,6 +1,23 @@
-import { type OutputStyle } from '@williamthorsen/nmr-core';
 import type * as TypeScript from 'typescript';
 import { type BuildOptions } from './build-output.js';
+/**
+ * How a build ended: skipped because its inputs and output were unchanged, with the emit time recorded for those
+ * inputs when one was; or emitted, with the count of files that it published to `outdir`.
+ */
+export type BuildOutcome = {
+    kind: 'unchanged';
+    savedMs?: number;
+} | {
+    kind: 'emitted';
+    fileCount: number;
+    outdir: string;
+};
+/** Why a build is about to emit: its inputs changed, or its inputs match the cache and its output is missing. */
+export type BuildProgress = {
+    kind: 'inputs-changed';
+} | {
+    kind: 'output-missing';
+};
 /**
  * The toolchain from which a build's emit comes: the resolved compiler and the nmr running it. `computeBuildHash`
  * folds both into the build hash, because the same sources can compile to different output under a different
@@ -10,9 +27,10 @@ export interface BuildToolchain {
     compilerVersion: string;
     fingerprint: string;
 }
-/** What a build needs beyond its sources: the options shaping the emit, and the style in which it reports. */
+/** What a build needs beyond its sources: the options shaping the emit, and a listener for its progress. */
 export interface BuildPackageOptions extends BuildOptions {
-    style: OutputStyle;
+    /** Called before the emit begins, so that a caller can report the build ahead of a slow compile. */
+    onProgress?: (progress: BuildProgress) => void;
     /**
      * Overridable so that a missing `typescript` peer is reachable without uninstalling it.
      *
@@ -30,10 +48,15 @@ export interface BuildPackageOptions extends BuildOptions {
  * current inputs rather than an accumulation of every build that ever ran. Assets belong outside it, or in a
  * `build:post` hook, which runs after the output is published.
  */
-export declare function buildPackage(packageDir: string, options: BuildPackageOptions): Promise<void>;
+export declare function buildPackage(packageDir: string, options?: BuildPackageOptions): Promise<BuildOutcome>;
 /**
  * Produces a digest of the given files (paths and contents), the emit config, and the toolchain.
  * The file list is sorted so that the digest is order-invariant, and each path is folded in so that renames are
  * detected.
  */
 export declare function computeBuildHash(packageDir: string, files: string[], emitConfig: object, toolchain: BuildToolchain): Promise<string>;
+/**
+ * Records a build skipped on unchanged inputs: states the `build-unchanged` outcome with the emit time recorded under
+ * `digest`, and returns that time, which is absent when none was recorded.
+ */
+export declare function recordUnchangedBuild(packageDir: string, digest: string, env: NodeJS.ProcessEnv): Promise<number | undefined>;