@williamthorsen/nmr 0.17.0 → 0.17.1

package/README.md

@@ -3,13 +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.17.0 (2026-07-01)
+## Release notes — v0.17.1 (2026-07-01)
 
-### 🎉 Features
+### 🐛 Bug fixes
 
-- 🚨 **Breaking:** Rebuild nmr-compile on a unified tsc emit (#455)
+- Relocate nmr-compile's build cache out of the published dist (#457)
 
-  `nmr` now compiles a package's JavaScript and type declarations in one step, rewriting every import form — static, re-export, dynamic `import()`, bare side-effect, and tsconfig `paths` aliases — to runnable `.js` in both outputs. It now requires TypeScript 5.7 or newer as a peer dependency.
+  Fixes an issue where packages built with nmr-compile shipped an internal build-cache file inside their published npm tarball.
 <!-- /section:release-notes -->
 
 ## Installation
@@ -345,7 +345,7 @@ nmr sync-pnpm-version
 
 ### `nmr-compile`
 
-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 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.
 

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

@@ -2,8 +2,8 @@ export interface BuildOptions {
     entryGlobs?: string[];
     ignore?: string[];
     outdir?: string;
-    cacheFile?: string;
 }
 export declare function buildPackage(packageDir: string, options?: BuildOptions): Promise<void>;
 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;

package/dist/esm/commands/build.js

@@ -9,7 +9,6 @@ const SKIPPED_ICON = '⏭️';
 const DEFAULT_ENTRY_GLOBS = ['src/**/*.ts'];
 const DEFAULT_IGNORE = ['**/__tests__/**'];
 const DEFAULT_OUTDIR = 'dist/esm/';
-const DEFAULT_CACHE_FILE = 'dist/esm/.cache';
 const SOURCE_ROOT = 'src';
 const MINIMUM_TYPESCRIPT_MAJOR = 5;
 const MINIMUM_TYPESCRIPT_MINOR = 7;
@@ -17,7 +16,7 @@ const TS_EXTENSION = '.ts';
 const JS_EXTENSION = '.js';
 export async function buildPackage(packageDir, options = {}) {
     assertSupportedTypeScript();
-    const cacheFile = options.cacheFile ?? DEFAULT_CACHE_FILE;
+    const cachePath = resolveBuildCachePath(packageDir);
     const outdir = options.outdir ?? DEFAULT_OUTDIR;
     const emitConfig = { outdir, declaration: true, rewriteRelativeImportExtensions: true };
     const entryPoints = await glob(options.entryGlobs ?? DEFAULT_ENTRY_GLOBS, {
@@ -25,12 +24,12 @@ export async function buildPackage(packageDir, options = {}) {
         ignore: options.ignore ?? DEFAULT_IGNORE,
     });
     const dependencies = ['package.json', ...resolveTsconfigChain(packageDir)];
-    const { changed, currentHash } = await detectBuildChanges(packageDir, [...entryPoints, ...dependencies], emitConfig, cacheFile);
+    const { changed, currentHash } = await detectBuildChanges(packageDir, [...entryPoints, ...dependencies], emitConfig, cachePath);
     if (!changed) {
         return;
     }
     emitPackage(packageDir, entryPoints, outdir);
-    await writeBuildCache(packageDir, cacheFile, currentHash);
+    await writeBuildCache(cachePath, currentHash);
 }
 export async function computeBuildHash(packageDir, files, emitConfig) {
     const hash = createHash('sha256');
@@ -181,9 +180,27 @@ function getModuleSpecifier(node) {
     }
     return undefined;
 }
-async function detectBuildChanges(packageDir, files, emitConfig, cacheFile) {
+export function resolveBuildCachePath(packageDir) {
+    const absolutePackageDir = path.resolve(packageDir);
+    const home = findNearestNodeModulesHost(absolutePackageDir) ?? absolutePackageDir;
+    const digest = createHash('sha256').update(absolutePackageDir).digest('hex').slice(0, 8);
+    const key = `${path.basename(absolutePackageDir)}-${digest}.hash`;
+    return path.join(home, 'node_modules', '.cache', 'nmr-compile', key);
+}
+function findNearestNodeModulesHost(startDir) {
+    let current = startDir;
+    let parent = path.dirname(current);
+    while (!existsSync(path.join(current, 'node_modules'))) {
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+        parent = path.dirname(current);
+    }
+    return current;
+}
+async function detectBuildChanges(packageDir, files, emitConfig, cachePath) {
     const packageName = path.basename(packageDir);
-    const cachePath = path.join(packageDir, cacheFile);
     const previousHash = existsSync(cachePath) ? readFileSync(cachePath, 'utf8') : undefined;
     const currentHash = await computeBuildHash(packageDir, files, emitConfig);
     if (previousHash === currentHash) {
@@ -193,8 +210,7 @@ async function detectBuildChanges(packageDir, files, emitConfig, cacheFile) {
     console.info(`${PACKAGE_ICON} ${packageName}: Changes detected.`);
     return { changed: true, currentHash };
 }
-async function writeBuildCache(packageDir, cacheFile, hash) {
-    const cachePath = path.join(packageDir, cacheFile);
+async function writeBuildCache(cachePath, hash) {
     await mkdir(path.dirname(cachePath), { recursive: true });
     await writeFile(cachePath, hash);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/nmr",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "private": false,
   "description": "Context-aware script runner for PNPM monorepos",
   "keywords": [

package/dist/esm/.cache

@@ -1 +0,0 @@
-49f79592247d14646b1445473aa445a8bcbeafb478c6dc9949eb31cee8e2a627