@sntlr/registry-shell 1.1.1 → 1.1.3

package/dist/cli/build.js

@@ -1,12 +1,17 @@
 /**
  * `registry-shell build` — run `next build` against the user's project.
  *
- * Writes the Next build output to `<user-project>/.next` via `distDir` so
- * generic Next.js hosts (Vercel, self-hosted) find it where they expect.
- * Without this, the output would land inside
- * `node_modules/@sntlr/registry-shell/src/next-app/.next` and no external
- * host could discover it.
+ * Strategy: `next build` writes to its default `<next-project>/.next`
+ * location (inside our node_modules). After a successful build, MOVE that
+ * directory to `<user-project>/<paths.buildOutput ?? ".next">`.
+ *
+ * Why not use Next's `distDir` config? Next silently ignores absolute
+ * paths that point outside the Next project dir (the output ends up back
+ * in the default location). The env-var approach we tried first worked
+ * locally on Windows but failed on Vercel. A post-build move is
+ * platform-independent.
  */
+import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { NEXT_BIN, buildEnvVars, clearStaleNextCacheIfModeChanged, loadUserConfig, nextAppDir, writeUserSourcesCss, } from "./shared.js";
@@ -14,18 +19,40 @@ export async function run(args) {
     const loaded = loadUserConfig();
     clearStaleNextCacheIfModeChanged(loaded);
     writeUserSourcesCss(loaded);
-    const userDistDir = loaded
-        ? path.resolve(loaded.root, loaded.config.paths?.buildOutput ?? ".next")
-        : undefined;
-    const env = {
-        ...process.env,
-        ...buildEnvVars(loaded),
-        ...(userDistDir ? { USER_DIST_DIR: userDistDir } : {}),
-    };
-    const child = spawn(process.execPath, [NEXT_BIN, "build", nextAppDir(), ...args], {
-        stdio: "inherit",
-        env,
+    const shellNextApp = nextAppDir();
+    const env = { ...process.env, ...buildEnvVars(loaded) };
+    const child = spawn(process.execPath, [NEXT_BIN, "build", shellNextApp, ...args], { stdio: "inherit", env });
+    child.on("exit", (code) => {
+        if (code !== 0) {
+            process.exit(code ?? 1);
+        }
+        if (loaded)
+            relocateBuildOutput(shellNextApp, loaded.root, loaded.config.paths?.buildOutput);
+        process.exit(0);
     });
-    child.on("exit", (code) => process.exit(code ?? 0));
+}
+/**
+ * Moves `<shellNextApp>/.next` → `<userRoot>/<outputName ?? ".next">`.
+ * Idempotent: removes stale destination first. Noop if source is missing
+ * (e.g. Next's distDir *did* happen to work) or source and dest are the
+ * same path.
+ */
+function relocateBuildOutput(shellNextApp, userRoot, outputName) {
+    const src = path.join(shellNextApp, ".next");
+    const dest = path.resolve(userRoot, outputName ?? ".next");
+    if (src === dest)
+        return;
+    if (!fs.existsSync(src))
+        return;
+    if (fs.existsSync(dest)) {
+        fs.rmSync(dest, {
+            recursive: true,
+            force: true,
+            maxRetries: 5,
+            retryDelay: 200,
+        });
+    }
+    fs.renameSync(src, dest);
+    console.log(`[registry-shell] Build output moved to ${dest}`);
 }
 //# sourceMappingURL=build.js.map

package/dist/cli/build.js.map

@@ -1 +1 @@
-{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,gCAAgC,EAChC,cAAc,EACd,UAAU,EACV,mBAAmB,GACpB,MAAM,aAAa,CAAA;AAEpB,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAC3B,MAAM,WAAW,GAAG,MAAM;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,OAAO,CAAC;QACxE,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,GAAG,GAAG;QACV,GAAG,OAAO,CAAC,GAAG;QACd,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE;QAChF,KAAK,EAAE,SAAS;QAChB,GAAG;KACJ,CAAC,CAAA;IACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,gCAAgC,EAChC,cAAc,EACd,UAAU,EACV,mBAAmB,GACpB,MAAM,aAAa,CAAA;AAEpB,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAE3B,MAAM,YAAY,GAAG,UAAU,EAAE,CAAA;IACjC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvD,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,EAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAC1B,CAAA;IAED,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;QACzB,CAAC;QACD,IAAI,MAAM;YAAE,mBAAmB,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAC1B,YAAoB,EACpB,QAAgB,EAChB,UAA8B;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,IAAI,OAAO,CAAC,CAAA;IAC1D,IAAI,GAAG,KAAK,IAAI;QAAE,OAAM;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAM;IAE/B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;YACd,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,GAAG;SAChB,CAAC,CAAA;IACJ,CAAC;IACD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IACxB,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAA;AAC/D,CAAC"}

package/dist/cli/start.js

@@ -1,24 +1,47 @@
 /**
  * `registry-shell start` — run `next start` for a prior `registry-shell build`.
  *
- * Mirrors build.ts: passes `USER_DIST_DIR` pointing at `<user-project>/.next`
- * so `next start` reads the build output from where build.ts wrote it.
+ * Build writes `.next/` to the user's project root (so Vercel / Netlify /
+ * generic Next hosts find it). `next start` expects it at its default
+ * location inside the Next project dir. Move it back before starting.
+ * Safe to run even if the move has already happened on a prior start.
  */
+import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
 import { NEXT_BIN, buildEnvVars, loadUserConfig, nextAppDir } from "./shared.js";
 export async function run(args) {
     const loaded = loadUserConfig();
-    const userDistDir = loaded
-        ? path.resolve(loaded.root, loaded.config.paths?.buildOutput ?? ".next")
-        : undefined;
-    const env = {
-        ...process.env,
-        ...buildEnvVars(loaded),
-        ...(userDistDir ? { USER_DIST_DIR: userDistDir } : {}),
-    };
+    const env = { ...process.env, ...buildEnvVars(loaded) };
     const portArgs = loaded?.config.port ? ["-p", String(loaded.config.port)] : [];
-    const child = spawn(process.execPath, [NEXT_BIN, "start", nextAppDir(), ...portArgs, ...args], { stdio: "inherit", env });
+    const shellNextApp = nextAppDir();
+    if (loaded) {
+        restoreBuildOutput(shellNextApp, loaded.root, loaded.config.paths?.buildOutput);
+    }
+    const child = spawn(process.execPath, [NEXT_BIN, "start", shellNextApp, ...portArgs, ...args], { stdio: "inherit", env });
     child.on("exit", (code) => process.exit(code ?? 0));
 }
+/**
+ * Inverse of build.ts's relocation: moves `<userRoot>/<buildOutput>` back
+ * to `<shellNextApp>/.next` so `next start` can find it. Noop when the
+ * user-side `.next` is missing — we assume they ran `registry-shell start`
+ * against a shell-side build or are otherwise in a good state.
+ */
+function restoreBuildOutput(shellNextApp, userRoot, outputName) {
+    const dest = path.join(shellNextApp, ".next");
+    const src = path.resolve(userRoot, outputName ?? ".next");
+    if (src === dest)
+        return;
+    if (!fs.existsSync(src))
+        return;
+    if (fs.existsSync(dest)) {
+        fs.rmSync(dest, {
+            recursive: true,
+            force: true,
+            maxRetries: 5,
+            retryDelay: 200,
+        });
+    }
+    fs.renameSync(src, dest);
+}
 //# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,WAAW,GAAG,MAAM;QACxB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,IAAI,OAAO,CAAC;QACxE,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,GAAG,GAAG;QACV,GAAG,OAAO,CAAC,GAAG;QACd,GAAG,YAAY,CAAC,MAAM,CAAC;QACvB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAA;IACD,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,EACvD,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAC1B,CAAA;IACD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAA;IAC/B,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAA;IACvD,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,YAAY,GAAG,UAAU,EAAE,CAAA;IAEjC,IAAI,MAAM,EAAE,CAAC;QACX,kBAAkB,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACjF,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,EACvD,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAC1B,CAAA;IACD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAA;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CACzB,YAAoB,EACpB,QAAgB,EAChB,UAA8B;IAE9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,IAAI,OAAO,CAAC,CAAA;IACzD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAM;IACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAM;IAE/B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;YACd,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,GAAG;SAChB,CAAC,CAAA;IACJ,CAAC;IACD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sntlr/registry-shell",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Generic Next.js viewer for component registries. Drop a registry-shell.config.ts into your registry and get a full docs/components/blocks site on localhost:3000.",
   "keywords": [
     "shadcn",

package/src/cli/build.ts

@@ -1,12 +1,17 @@
 /**
  * `registry-shell build` — run `next build` against the user's project.
  *
- * Writes the Next build output to `<user-project>/.next` via `distDir` so
- * generic Next.js hosts (Vercel, self-hosted) find it where they expect.
- * Without this, the output would land inside
- * `node_modules/@sntlr/registry-shell/src/next-app/.next` and no external
- * host could discover it.
+ * Strategy: `next build` writes to its default `<next-project>/.next`
+ * location (inside our node_modules). After a successful build, MOVE that
+ * directory to `<user-project>/<paths.buildOutput ?? ".next">`.
+ *
+ * Why not use Next's `distDir` config? Next silently ignores absolute
+ * paths that point outside the Next project dir (the output ends up back
+ * in the default location). The env-var approach we tried first worked
+ * locally on Windows but failed on Vercel. A post-build move is
+ * platform-independent.
  */
+import fs from "node:fs"
 import path from "node:path"
 import { spawn } from "node:child_process"
 import {
@@ -22,17 +27,48 @@ export async function run(args: string[]): Promise<void> {
   const loaded = loadUserConfig()
   clearStaleNextCacheIfModeChanged(loaded)
   writeUserSourcesCss(loaded)
-  const userDistDir = loaded
-    ? path.resolve(loaded.root, loaded.config.paths?.buildOutput ?? ".next")
-    : undefined
-  const env = {
-    ...process.env,
-    ...buildEnvVars(loaded),
-    ...(userDistDir ? { USER_DIST_DIR: userDistDir } : {}),
-  }
-  const child = spawn(process.execPath, [NEXT_BIN, "build", nextAppDir(), ...args], {
-    stdio: "inherit",
-    env,
+
+  const shellNextApp = nextAppDir()
+  const env = { ...process.env, ...buildEnvVars(loaded) }
+  const child = spawn(
+    process.execPath,
+    [NEXT_BIN, "build", shellNextApp, ...args],
+    { stdio: "inherit", env },
+  )
+
+  child.on("exit", (code) => {
+    if (code !== 0) {
+      process.exit(code ?? 1)
+    }
+    if (loaded) relocateBuildOutput(shellNextApp, loaded.root, loaded.config.paths?.buildOutput)
+    process.exit(0)
   })
-  child.on("exit", (code) => process.exit(code ?? 0))
+}
+
+/**
+ * Moves `<shellNextApp>/.next` → `<userRoot>/<outputName ?? ".next">`.
+ * Idempotent: removes stale destination first. Noop if source is missing
+ * (e.g. Next's distDir *did* happen to work) or source and dest are the
+ * same path.
+ */
+function relocateBuildOutput(
+  shellNextApp: string,
+  userRoot: string,
+  outputName: string | undefined,
+): void {
+  const src = path.join(shellNextApp, ".next")
+  const dest = path.resolve(userRoot, outputName ?? ".next")
+  if (src === dest) return
+  if (!fs.existsSync(src)) return
+
+  if (fs.existsSync(dest)) {
+    fs.rmSync(dest, {
+      recursive: true,
+      force: true,
+      maxRetries: 5,
+      retryDelay: 200,
+    })
+  }
+  fs.renameSync(src, dest)
+  console.log(`[registry-shell] Build output moved to ${dest}`)
 }

package/src/cli/start.ts

@@ -1,28 +1,57 @@
 /**
  * `registry-shell start` — run `next start` for a prior `registry-shell build`.
  *
- * Mirrors build.ts: passes `USER_DIST_DIR` pointing at `<user-project>/.next`
- * so `next start` reads the build output from where build.ts wrote it.
+ * Build writes `.next/` to the user's project root (so Vercel / Netlify /
+ * generic Next hosts find it). `next start` expects it at its default
+ * location inside the Next project dir. Move it back before starting.
+ * Safe to run even if the move has already happened on a prior start.
  */
+import fs from "node:fs"
 import path from "node:path"
 import { spawn } from "node:child_process"
 import { NEXT_BIN, buildEnvVars, loadUserConfig, nextAppDir } from "./shared.js"
 
 export async function run(args: string[]): Promise<void> {
   const loaded = loadUserConfig()
-  const userDistDir = loaded
-    ? path.resolve(loaded.root, loaded.config.paths?.buildOutput ?? ".next")
-    : undefined
-  const env = {
-    ...process.env,
-    ...buildEnvVars(loaded),
-    ...(userDistDir ? { USER_DIST_DIR: userDistDir } : {}),
-  }
+  const env = { ...process.env, ...buildEnvVars(loaded) }
   const portArgs = loaded?.config.port ? ["-p", String(loaded.config.port)] : []
+  const shellNextApp = nextAppDir()
+
+  if (loaded) {
+    restoreBuildOutput(shellNextApp, loaded.root, loaded.config.paths?.buildOutput)
+  }
+
   const child = spawn(
     process.execPath,
-    [NEXT_BIN, "start", nextAppDir(), ...portArgs, ...args],
+    [NEXT_BIN, "start", shellNextApp, ...portArgs, ...args],
     { stdio: "inherit", env },
   )
   child.on("exit", (code) => process.exit(code ?? 0))
 }
+
+/**
+ * Inverse of build.ts's relocation: moves `<userRoot>/<buildOutput>` back
+ * to `<shellNextApp>/.next` so `next start` can find it. Noop when the
+ * user-side `.next` is missing — we assume they ran `registry-shell start`
+ * against a shell-side build or are otherwise in a good state.
+ */
+function restoreBuildOutput(
+  shellNextApp: string,
+  userRoot: string,
+  outputName: string | undefined,
+): void {
+  const dest = path.join(shellNextApp, ".next")
+  const src = path.resolve(userRoot, outputName ?? ".next")
+  if (src === dest) return
+  if (!fs.existsSync(src)) return
+
+  if (fs.existsSync(dest)) {
+    fs.rmSync(dest, {
+      recursive: true,
+      force: true,
+      maxRetries: 5,
+      retryDelay: 200,
+    })
+  }
+  fs.renameSync(src, dest)
+}

package/src/next-app/lib/registry-adapter.ts

@@ -98,9 +98,10 @@ export interface BrandingConfig {
 }
 
 /**
- * The complete server-side contract the shell consumes. A registry package
- * implements this (typically in `adapter.ts`) and the shell imports the
- * default export via `ui-registry/registry.config.ts`.
+ * The complete server-side contract the shell consumes. The default
+ * (convention-based) implementation lives in `src/adapter/default.ts`;
+ * registries can override specific methods via a custom adapter module
+ * pointed at by `adapter` in their `registry-shell.config.ts`.
  *
  * All filesystem reads, registry-JSON serving, and MDX parsing live here —
  * the shell never touches the registry's files directly. This is what makes

package/src/next-app/next.config.ts

@@ -45,15 +45,16 @@ function resolveUserModule(relativePath: string, fallback: string): string {
 
 const USER_PREVIEWS = resolveUserModule("components/previews", "fallback/previews.ts")
 
-// The CLI's `build` / `start` commands set USER_DIST_DIR to
-// `<user-project>/.next` so Next writes its output (and reads it back on
-// start) at the user's project root, not inside node_modules. Absolute
-// path — Next accepts that for `distDir`.
-const USER_DIST_DIR = process.env.USER_DIST_DIR
-
 const nextConfig: NextConfig = {
   output: process.env.BUILD_STANDALONE === "true" ? "standalone" : undefined,
-  ...(USER_DIST_DIR ? { distDir: toPosix(USER_DIST_DIR) } : {}),
+
+  // Next's file tracer figures out which node_modules files each
+  // serverless function needs. With pnpm (and our setup, where Next
+  // runs from inside node_modules), the tracer can't walk pnpm's
+  // virtual store without knowing the real project root. Point it at
+  // the user's project — that's the dir that contains `node_modules/.pnpm`
+  // on Vercel and any other pnpm-installed host.
+  ...(USER_ROOT ? { outputFileTracingRoot: toPosix(USER_ROOT) } : {}),
 
   // When installed as an external package (link:../registry-shell, npm, etc.),
   // the shell's TSX lives under the user's node_modules and Next won't