@nextsparkjs/core 0.1.0-beta.189 → 0.1.0-beta.190

package/dist/templates/proxy.ts

@@ -1,9 +1,8 @@
 /**
- * @nextspark-generated
- *
- * `nextspark sync:app` replaces this file while that tag is present, which is
- * how a release ships changes to it. Delete the tag line to own the file: from
- * then on sync reports it and leaves it alone.
+ * `nextspark sync:app` keeps this file up to date while its first line is the
+ * generated tag sync writes and the rest of the file is unchanged since then,
+ * which is how a release ships changes to it. Edit the file, or delete that
+ * line, to own it: from then on sync reports it and leaves it alone.
  *
  * NextSpark Proxy (Next.js 16+)
  *
@@ -12,9 +11,10 @@
  *
  * Key responsibilities:
  * 1. Theme middleware override support
- * 2. Documentation access control
- * 3. Protected route authentication, and the roles /superadmin and /devtools need
- * 4. User header injection for downstream use (x-user-id, x-pathname, x-active-team-id)
+ * 2. Redirecting historical 3-level docs URLs to their current route
+ * 3. Documentation access control
+ * 4. Protected route authentication, and the roles /superadmin and /devtools need
+ * 5. User header injection for downstream use (x-user-id, x-pathname, x-active-team-id)
  *
  * IMPORTANT: The EntityPermissionLayout depends on x-user-id and x-pathname
  * headers being set here for server-side permission validation.
@@ -28,6 +28,8 @@ import {
 } from '@nextsparkjs/core/lib/middleware'
 import { ACTIVE_TEAM_COOKIE, activeTeamIdForSession } from '@nextsparkjs/core/lib/teams/active-team-cookie'
 import { SESSION_HINT_COOKIE, SESSION_HINT_MAX_AGE, hasSessionCookie } from '@nextsparkjs/core/lib/auth/session-hint'
+import { isDocsPublic, legacyDocsAccessMessage } from '@nextsparkjs/core/lib/docs/access'
+import { DOCS_REGISTRY } from '@nextsparkjs/registries/docs-registry'
 
 /**
  * Session type for proxy (inline definition)
@@ -91,6 +93,45 @@ function appUrl(request: NextRequest, pathname: string): NextRequest['nextUrl']
   return url
 }
 
+/**
+ * Whether `pathname` is a docs page route — `/docs/<section>/<page>` or
+ * `/superadmin/docs/<section>/<page>` — whose section and page the docs
+ * registry does not have together. Segments are compared decoded, the way the
+ * page reads its params.
+ */
+function isMissingDocsPage(pathname: string): boolean {
+  const match = pathname.match(/^(\/superadmin)?\/docs\/([^/]+)\/([^/]+)$/)
+  if (!match) return false
+
+  let sectionSlug: string
+  let pageSlug: string
+  try {
+    sectionSlug = decodeURIComponent(match[2])
+    pageSlug = decodeURIComponent(match[3])
+  } catch {
+    return true
+  }
+
+  const sections = match[1] ? DOCS_REGISTRY.superadmin : DOCS_REGISTRY.public
+  return !sections.some(section => section.slug === sectionSlug && section.pages.some(page => page.slug === pageSlug))
+}
+
+/**
+ * Serve the app's not-found page with a 404 status for a docs page the
+ * registry does not have. The docs pages answer 404 on their own only where
+ * their `dynamicParams = false` has a list to check: in `next dev`, and for
+ * public docs prerendered by an app whose locale is fixed. Rendered on demand
+ * (superadmin docs always, public docs when the locale comes from the
+ * request), their notFound() runs inside the layouts' Suspense boundaries,
+ * after the response head has gone out with a 200. Deciding it here, before
+ * anything renders, gives those requests the 404.
+ */
+function rewriteToNotFound(request: NextRequest, requestHeaders: Headers): NextResponse {
+  return syncSessionHint(request, NextResponse.rewrite(appUrl(request, '/_not-found'), {
+    request: { headers: requestHeaders },
+  }))
+}
+
 /**
  * Send a visitor without a session to login. LoginForm reads `callbackUrl` and
  * returns them to the page they asked for, query included, once signed in.
@@ -178,6 +219,18 @@ function passThrough(request: NextRequest, requestHeaders: Headers): NextRespons
   }))
 }
 
+let legacyDocsAccessWarned = false
+
+/** Says once per server process what to change in an app config that still
+ * gates /docs with the older `docs.public` boolean. */
+function warnLegacyDocsAccess(docsConfig: Parameters<typeof legacyDocsAccessMessage>[0]): void {
+  if (legacyDocsAccessWarned) return
+  const message = legacyDocsAccessMessage(docsConfig)
+  if (!message) return
+  legacyDocsAccessWarned = true
+  console.warn(`[NextSpark] ${message}`)
+}
+
 export async function proxy(request: NextRequest) {
   const { pathname } = request.nextUrl
 
@@ -191,36 +244,58 @@ export async function proxy(request: NextRequest) {
     if (themeResponse) return themeResponse
   }
 
-  // 2. Redirect old docs URLs to new structure (2-level -> 3-level)
-  const oldDocsPattern = /^\/docs\/([^\/]+)\/([^\/]+)$/
-  const oldDocsMatch = pathname.match(oldDocsPattern)
-
+  // 2. Redirect historical 3-level docs URLs (/docs/<core|theme>/<section>/<page>)
+  // to the current route. That split predates this app's history: `core` and
+  // `theme` were the only two categories ever generated (a third, `plugins`,
+  // was scaffolded but never activated), and both were collapsed into a single
+  // docs tree per source - `public` (served at /docs) and `superadmin` (served
+  // at /superadmin/docs) - without renaming any section that survived the
+  // collapse. A section from that era can therefore only be in one of the two
+  // registries today, or in neither if its docs were dropped rather than
+  // moved; the redirect follows the section, not the old category. The page
+  // has to survive too - a section can live on with a different set of pages -
+  // so both are checked against the registry rather than only the section,
+  // which is the one thing this route can actually confirm still resolves.
+  const oldDocsMatch = pathname.match(/^\/docs\/(?:core|theme)\/([^/]+)\/([^/]+)$/)
   if (oldDocsMatch) {
     const [, sectionSlug, pageSlug] = oldDocsMatch
-    const themeSections = ['theme-overview', 'theme-features']
-    const category = themeSections.includes(sectionSlug) ? 'theme' : 'core'
-    const cleanSection = sectionSlug.replace(/^theme-/, '')
-
     const newUrl = request.nextUrl.clone()
-    newUrl.pathname = `/docs/${category}/${cleanSection}/${pageSlug}`
+    const superadminSection = DOCS_REGISTRY.superadmin.find((section) => section.slug === sectionSlug)
+    const publicSection = DOCS_REGISTRY.public.find((section) => section.slug === sectionSlug)
+
+    if (superadminSection?.pages.some((page) => page.slug === pageSlug)) {
+      newUrl.pathname = `/superadmin/docs/${sectionSlug}/${pageSlug}`
+    } else if (publicSection?.pages.some((page) => page.slug === pageSlug)) {
+      newUrl.pathname = `/docs/${sectionSlug}/${pageSlug}`
+    } else {
+      // The section is gone, or survived without this exact page - either way
+      // there is no page left to send this to, so it goes to the docs home
+      // instead of a dead link.
+      newUrl.pathname = '/docs'
+    }
     return NextResponse.redirect(newUrl, 301)
   }
 
-  // 3. Documentation access control
+  // 3. Documentation access control: docs.publicAccess, or the older
+  // docs.public boolean it replaced (see lib/docs/access)
   if (isUnder(pathname, '/docs')) {
-    const appConfig = getThemeAppConfig(activeTheme as string)
+    const docsConfig = getThemeAppConfig(activeTheme as string)?.docs
+    warnLegacyDocsAccess(docsConfig)
 
-    if (appConfig?.docs?.public === false) {
+    if (!isDocsPublic(docsConfig)) {
       try {
         const { data: session } = await getSession(request)
 
         if (!session) {
           return redirectToLogin(request)
         }
-      } catch (error) {
+      } catch {
         return redirectToLogin(request)
       }
     }
+    if (isMissingDocsPage(pathname)) {
+      return rewriteToNotFound(request, requestHeaders)
+    }
     return passThrough(request, requestHeaders)
   }
 
@@ -290,6 +365,10 @@ export async function proxy(request: NextRequest) {
         requestHeaders.set('x-active-team-id', activeTeamId)
       }
 
+      if (isSuperadminRoute && isMissingDocsPage(pathname)) {
+        return rewriteToNotFound(request, requestHeaders)
+      }
+
       return passThrough(request, requestHeaders)
     } catch (error) {
       console.error('Proxy error:', error)

package/dist/templates/public/sw.js

@@ -1,10 +1,10 @@
 // Empty service worker to prevent 404 errors
 // This file exists only to stop browsers from requesting a non-existent service worker
 
-self.addEventListener('install', function(event) {
+self.addEventListener('install', function() {
   // No caching or special behavior
 });
 
-self.addEventListener('fetch', function(event) {
+self.addEventListener('fetch', function() {
   // No fetch interception
 });

package/dist/templates/scripts/cy-run-prod.cjs

@@ -83,7 +83,7 @@ function killPort(port) {
           if (pid && /^\d+$/.test(pid)) {
             try {
               execSync(`taskkill /PID ${pid} /F`, { stdio: 'ignore' })
-            } catch (e) {
+            } catch {
               // Process might already be dead
             }
           }
@@ -92,7 +92,7 @@ function killPort(port) {
       execSync(`lsof -ti:${port} | xargs kill -9 2>/dev/null || true`, { stdio: 'ignore' })
     }
     console.log(`[cy:run:prod] Port ${port} cleared`)
-  } catch (e) {
+  } catch {
     // No process on port, that's fine
     console.log(`[cy:run:prod] Port ${port} was already free`)
   }
@@ -206,16 +206,16 @@ function cleanup(server) {
         // Kill process group
         try {
           process.kill(-server.pid, 'SIGKILL')
-        } catch (e) {
+        } catch {
           // If process group kill fails, try direct kill
           try {
             server.kill('SIGKILL')
-          } catch (e2) {
+          } catch {
             // Process might already be dead
           }
         }
       }
-    } catch (e) {
+    } catch {
       // Process might already be dead
     }
   }

package/dist/types/blocks.d.ts

@@ -4,7 +4,7 @@
  * Type definitions for the dynamic block editor system.
  * Supports WordPress/Webflow-style page building with reusable blocks.
  */
-import { z } from 'zod';
+import * as z from 'zod';
 /**
  * Media Reference Schema
  *

package/dist/types/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/types/blocks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/types/blocks.ts"],"names":[],"mappings":"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"}

package/dist/types/blocks.js

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 const mediaRefObjectSchema = z.object({
   mediaId: z.string(),
   url: z.string()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.189",
+  "version": "0.1.0-beta.190",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -31,6 +31,9 @@
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "update-core": "./scripts/maintenance/update-core.mjs"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -381,11 +384,12 @@
     "scripts"
   ],
   "peerDependencies": {
-    "next": ">=14.0.0",
+    "next": ">=15.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0"
   },
   "devDependencies": {
+    "@better-fetch/fetch": "1.3.1",
     "@cypress/grep": "^5.0.1",
     "@tailwindcss/cli": "^4",
     "@testing-library/jest-dom": "^6.6.3",
@@ -405,8 +409,7 @@
     "jest-environment-jsdom": "^29.7.0",
     "tailwindcss": "^4",
     "ts-jest": "^29.2.5",
-    "tsup": "^8.5.1",
-    "typescript": "^5"
+    "tsup": "^8.5.1"
   },
   "dependencies": {
     "@babel/runtime": "^7.0.0",
@@ -484,9 +487,10 @@
     "sonner": "^2.0.7",
     "stripe": "^18.5.0",
     "tailwind-merge": "^3.3.1",
+    "typescript": "^5 || ^6",
     "uuid": "^13.0.0",
     "zod": "^4.3.6",
-    "@nextsparkjs/testing": "0.1.0-beta.189"
+    "@nextsparkjs/testing": "0.1.0-beta.190"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.mjs || true",

package/scripts/build/docs-registry.mjs

@@ -16,10 +16,10 @@
  * Part of the registry system
  */
 
-import fs from 'fs'
+import { existsSync, readdirSync } from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { existsSync, mkdirSync } from 'fs'
+import { projectFiles } from './safe-fs.mjs'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
@@ -107,13 +107,13 @@ const PATH_PREFIX = IS_NPM_MODE ? '' : '../..'
  * @returns {Array} Array of section metadata
  */
 function scanDocsDirectory(docsPath, source) {
-  if (!fs.existsSync(docsPath)) {
+  if (!existsSync(docsPath)) {
     console.log(`   No docs found at: ${docsPath}`)
     return []
   }
 
   const sections = []
-  const items = fs.readdirSync(docsPath, { withFileTypes: true })
+  const items = readdirSync(docsPath, { withFileTypes: true })
 
   for (const item of items) {
     if (!item.isDirectory()) continue
@@ -124,7 +124,7 @@ function scanDocsDirectory(docsPath, source) {
     const title = slugToTitle(slug)
 
     const pages = []
-    const files = fs.readdirSync(sectionPath)
+    const files = readdirSync(sectionPath)
 
     for (const file of files) {
       if (!file.endsWith('.md')) continue
@@ -301,12 +301,12 @@ export function findDocPage(sectionSlug: string, pageSlug: string): DocPageMeta
 
   // Ensure output directory exists
   if (!existsSync(OUTPUT_DIR)) {
-    mkdirSync(OUTPUT_DIR, { recursive: true })
+    projectFiles(PROJECT_ROOT).mkdirSync(OUTPUT_DIR, { recursive: true })
   }
 
   // Write registry file
   const registryPath = path.join(OUTPUT_DIR, 'docs-registry.ts')
-  fs.writeFileSync(registryPath, registryContent, 'utf-8')
+  projectFiles(PROJECT_ROOT).writeFileSync(registryPath, registryContent, 'utf-8')
 
   console.log('✅ Docs registry built successfully')
   console.log(`   Output: .nextspark/registries/docs-registry.ts`)

package/scripts/build/registry/__tests__/billing-registry.test.mjs

@@ -0,0 +1,43 @@
+/**
+ * Tests that generateBillingRegistry's jiti instance keeps its module cache in
+ * memory instead of writing it to disk, since jiti's default cache directory
+ * falls outside the project whenever the nearest node_modules isn't writable.
+ *
+ * Run: node --test packages/core/scripts/build/registry/__tests__/billing-registry.test.mjs
+ */
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { mkdtemp, readdir, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { generateBillingRegistry } from '../generators/billing-registry.mjs'
+
+const REPO_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..', '..', '..')
+
+async function directory(prefix) {
+  const root = await mkdtemp(join(tmpdir(), prefix))
+  return { root, cleanup: () => rm(root, { recursive: true, force: true }) }
+}
+
+test("generateBillingRegistry's jiti import writes nothing under TMPDIR, even when it can't reach a writable node_modules", async () => {
+  const cacheRoot = await directory('nextspark-billing-registry-tmpdir-')
+  const originalTmpdir = process.env.TMPDIR
+  try {
+    process.env.TMPDIR = cacheRoot.root
+    const themesDir = join(REPO_ROOT, 'themes')
+    const config = { themesDir, outputDir: join(cacheRoot.root, 'lib/registries') }
+
+    const output = await generateBillingRegistry('default', join(REPO_ROOT, 'contents'), config)
+
+    assert.match(output, /Active theme: default/)
+    const strayEntries = await readdir(cacheRoot.root)
+    assert.deepEqual(strayEntries, [], `jiti must not write a module cache under TMPDIR, found: ${strayEntries.join(', ')}`)
+  } finally {
+    if (originalTmpdir === undefined) delete process.env.TMPDIR
+    else process.env.TMPDIR = originalTmpdir
+    await cacheRoot.cleanup()
+  }
+})

package/scripts/build/registry/__tests__/build-output.test.mjs

@@ -0,0 +1,209 @@
+/**
+ * Tests for what the registry build and its plan print: every call to the
+ * console is escaped where it prints, once the console is guarded - as the
+ * scripts that run the build guard it before anything loads - so a name that
+ * holds a character that breaks or reorders a line, in a file of the project
+ * or in the project's own path, starts no line of its own.
+ *
+ * Run: node --test packages/core/scripts/build/registry/__tests__/build-output.test.mjs
+ */
+
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { spawnSync } from 'node:child_process'
+import { copyFile, chmod, mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { errorWithLines, guardConsole, logFailure, messageLines, shownLine, stackLines } from '../../../utils/index.mjs'
+
+const CORE_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', '..')
+
+/** A name that, printed raw, starts lines of its own - one reading as the build succeeding - erases a line, returns the carriage and separates or reorders lines. */
+const FORGED = 'forged\n✅ Registry System built successfully!\n\u001b[2K\r\u2028\u0085\u202e'
+const SHOWN = 'forged\\n✅ Registry System built successfully!\\n\\u001b[2K\\r\\u2028\\u0085\\u202e'
+
+const RAW_CONTROL = /[\u0000-\u0009\u000b-\u001f\u007f-\u009f\u061c\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069]/
+
+async function createProject(parent = tmpdir(), name = 'nextspark-build-output-test-') {
+  const root = await mkdtemp(join(parent, name))
+  await writeFile(join(root, '.env'), 'NEXT_PUBLIC_ACTIVE_THEME=acme\n')
+  await writeFile(join(root, 'package.json'), '{}')
+  await mkdir(join(root, 'app'))
+  return root
+}
+
+/** What a script of core's build printed for the project, stdout and stderr, as lines, and its exit code. */
+function run(script, root, args = [], env = {}) {
+  const result = spawnSync('node', [join('scripts', 'build', script), ...args], {
+    cwd: CORE_DIR,
+    env: { ...process.env, NEXTSPARK_PROJECT_ROOT: root, ...env },
+    encoding: 'utf8',
+    input: '{}',
+  })
+  return { status: result.status, lines: `${result.stdout}${result.stderr}`.split('\n') }
+}
+
+/** What is wrong with the lines a script printed: a raw control, or more lines reading as the build succeeding than it printed itself. */
+function wrongLines(label, lines, successes = 0) {
+  return [
+    ...lines.filter(line => RAW_CONTROL.test(line)).map(line => `${label}: ${JSON.stringify(line)} holds a raw control`),
+    ...(lines.filter(line => line.trim() === '✅ Registry System built successfully!').length > successes ? [`${label}: a line reads as the build succeeding that it did not print`] : []),
+  ]
+}
+
+/** Run `print` with the console captured and guarded, returning each line printed. */
+function printedBy(print) {
+  const printed = []
+  const original = { log: console.log, error: console.error }
+  const capture = (...args) => { printed.push(args.join(' ')) }
+  console.log = capture
+  console.error = capture
+  guardConsole()
+  try {
+    print()
+  } finally {
+    Object.assign(console, original)
+  }
+  return printed.join('\n').split('\n')
+}
+
+test('a line the console prints is escaped whole, keeping the blank lines and the indent around it', () => {
+  assert.equal(shownLine('   plain line'), '   plain line')
+  assert.equal(shownLine('\n   blank line before and after\n'), '\n   blank line before and after\n')
+  assert.equal(shownLine(`   named ${FORGED} here`), `   "named ${SHOWN} here"`)
+  assert.equal(shownLine(`\n✅ ${FORGED}\n`), `\n"✅ ${SHOWN}"\n`)
+
+  const lines = printedBy(() => {
+    console.log('📦 Output: %s', FORGED)
+    console.error(`   ${FORGED}`)
+    console.log()
+  })
+  assert.deepEqual(lines, [`"📦 Output: ${SHOWN}"`, `   "${SHOWN}"`, ''])
+})
+
+test("an error's own lines are printed one by one, and a newline anywhere else in its message, or in a path its stack names, stays on its line", async () => {
+  const multiline = errorWithLines(['permissions.config.ts has keys no entity matches:', '  ❌ "tasks" - No entity found with this slug', '\u001b[2Kerased'])
+  assert.deepEqual(messageLines(multiline), multiline.lines)
+  assert.deepEqual(messageLines(new Error(`one line ${FORGED}`)), [`one line ${FORGED}`])
+  assert.deepEqual(printedBy(() => logFailure('Build failed', multiline)), [
+    '❌ Build failed: permissions.config.ts has keys no entity matches:',
+    '  ❌ "tasks" - No entity found with this slug',
+    '"\\u001b[2Kerased"',
+  ])
+
+  const root = await mkdtemp(join(tmpdir(), 'nextspark-build-output-test-'))
+  try {
+    const error = await copyFile(join(root, `missing${FORGED}`), join(root, `copy\n${FORGED}`)).then(() => null, error => error)
+    assert.ok(error, 'copying a missing file fails')
+    const stack = stackLines(error)
+    assert.equal(stack[0], `Error: ${error.message}`)
+    assert.ok(stack.slice(1).every(line => line.startsWith('    at ')), 'each other line is a frame')
+
+    const lines = printedBy(() => logFailure('Build failed', error, true))
+    assert.deepEqual(lines.filter(line => RAW_CONTROL.test(line)), [])
+    assert.deepEqual(lines.filter(line => line.trim() === '✅ Registry System built successfully!'), [])
+    assert.equal(lines[0], `"❌ Build failed: ENOENT: no such file or directory, copyfile '${root}/missing${SHOWN}' -> '${root}/copy\\n${SHOWN}'"`)
+    assert.equal(lines[1], `"Error: ENOENT: no such file or directory, copyfile '${root}/missing${SHOWN}' -> '${root}/copy\\n${SHOWN}'"`)
+  } finally {
+    await rm(root, { recursive: true, force: true })
+  }
+})
+
+test('a directory in app/(templates) the build cannot read is named escaped where the build stops before writing and where its plan fails', { skip: process.getuid?.() === 0 }, async () => {
+  const root = await createProject()
+  const unreadable = join(root, 'app', '(templates)', FORGED)
+  try {
+    await mkdir(join(root, 'contents/themes/acme/templates/pricing'), { recursive: true })
+    await writeFile(join(root, 'contents/themes/acme/templates/pricing/page.tsx'), 'export default function Page() { return null }\n')
+    await mkdir(unreadable, { recursive: true })
+    await chmod(unreadable, 0)
+
+    const build = run('registry.mjs', root, ['--verbose'])
+    const plan = run('templates-plan.mjs', root)
+
+    const wrong = [...wrongLines('build', build.lines), ...wrongLines('plan', plan.lines)]
+    if (!build.lines.includes(`   "app/(templates)/${SHOWN} can't be read"`)) wrong.push('build: the check does not name the directory escaped')
+    if (!plan.lines.some(line => line.startsWith('"EACCES: permission denied, scandir ') && line.endsWith(`/app/(templates)/${SHOWN}'"`))) wrong.push('plan: the failure does not name the directory escaped')
+    assert.equal(build.status, 1)
+    assert.equal(plan.status, 1)
+    assert.deepEqual(wrong, [])
+  } finally {
+    await chmod(unreadable, 0o755).catch(() => {})
+    await rm(root, { recursive: true, force: true })
+  }
+})
+
+test('a theme template the build rejects is named escaped where it is discovered and where the build and its plan reject it', async () => {
+  const root = await createProject()
+  try {
+    await mkdir(join(root, 'contents/themes/acme/templates', FORGED), { recursive: true })
+    await writeFile(join(root, 'contents/themes/acme/templates', FORGED, 'page.tsx'), 'export const metadata = { title: "no default export" }\n')
+
+    const build = run('registry.mjs', root, ['--verbose'])
+    const plan = run('templates-plan.mjs', root)
+
+    const wrong = [...wrongLines('build', build.lines), ...wrongLines('plan', plan.lines)]
+    const rejected = `@/contents/themes/acme/templates/${SHOWN}/page.tsx has no default export, and the app has no existing route at \\"app/${SHOWN}/page.tsx\\"`
+    if (!build.lines.includes(`   "Template: app/${SHOWN}/page.tsx → @/contents/themes/acme/templates/${SHOWN}/page.tsx"`)) wrong.push('build: discovery does not name the template escaped')
+    if (!build.lines.some(line => line.startsWith(`"❌ Build failed: ${rejected}`))) wrong.push('build: the failure does not name the template escaped')
+    if (!plan.lines.some(line => line.startsWith(`"${rejected}`))) wrong.push('plan: the failure does not name the template escaped')
+    assert.equal(build.status, 1)
+    assert.equal(plan.status, 1)
+    assert.deepEqual(wrong, [])
+  } finally {
+    await rm(root, { recursive: true, force: true })
+  }
+})
+
+test('a theme template whose route-level exports the build cannot read is named escaped where the build and its plan reject it', async () => {
+  const sources = [
+    ['segment config it would not read', 'export default function Page() { return null }\nconst revalidate = 60\nexport { revalidate }\n', ':3: segment config export \\"revalidate\\"'],
+    ['source that does not parse', 'export default function Page( { return null\n', ':1: the template does not parse'],
+  ]
+  const wrong = []
+  for (const [label, source, problem] of sources) {
+    const root = await createProject()
+    try {
+      await mkdir(join(root, 'contents/themes/acme/templates', FORGED), { recursive: true })
+      await writeFile(join(root, 'contents/themes/acme/templates', FORGED, 'page.tsx'), source)
+
+      const build = run('registry.mjs', root, ['--verbose'])
+      const plan = run('templates-plan.mjs', root)
+
+      wrong.push(...wrongLines(`${label}, build`, build.lines), ...wrongLines(`${label}, plan`, plan.lines))
+      const named = `${join(root, 'contents/themes/acme/templates')}/${SHOWN}/page.tsx${problem}`
+      if (!build.lines.some(line => line.startsWith(`"❌ Build failed: ${named}`))) wrong.push(`${label}, build: the failure does not name the template escaped`)
+      if (!plan.lines.some(line => line.startsWith(`"${named}`))) wrong.push(`${label}, plan: the failure does not name the template escaped`)
+      if (build.status !== 1 || plan.status !== 1) wrong.push(`${label}: build exited ${build.status} and plan ${plan.status}`)
+    } finally {
+      await rm(root, { recursive: true, force: true })
+    }
+  }
+  assert.deepEqual(wrong, [])
+})
+
+test("a project whose own path holds characters that break or reorder a line starts no line of its own in what the build prints, built or refused for its environment", async () => {
+  const parent = await mkdtemp(join(tmpdir(), 'nextspark-build-output-test-'))
+  try {
+    const root = await createProject(parent, `${FORGED}-`)
+    await mkdir(join(root, 'contents/themes/acme/templates/pricing'), { recursive: true })
+    await writeFile(join(root, 'contents/themes/acme/templates/pricing/page.tsx'), 'export default function Page() { return null }\n')
+
+    const built = run('registry.mjs', root, ['--verbose'])
+    const wrong = wrongLines('built', built.lines, 1)
+    if (built.status !== 0) wrong.push(`built: exited ${built.status}`)
+    if (!built.lines.some(line => line.startsWith('"[dotenv@') && line.includes(SHOWN))) wrong.push("built: dotenv's line does not name the project escaped")
+
+    const bare = await mkdtemp(join(parent, `${FORGED}-bare-`))
+    const refused = run('registry.mjs', bare, [], { NEXT_PUBLIC_ACTIVE_THEME: '' })
+    wrong.push(...wrongLines('refused', refused.lines))
+    if (refused.status !== 1) wrong.push(`refused: exited ${refused.status}`)
+    if (!refused.lines.some(line => line.includes('Create a .env file in your project root: ') && line.includes(SHOWN))) wrong.push('refused: the fix does not name the project escaped')
+
+    assert.deepEqual(wrong, [])
+  } finally {
+    await rm(parent, { recursive: true, force: true })
+  }
+})