makersclaw 0.7.0 → 0.8.0

package/registry/blocks/chat/README.md

@@ -127,7 +127,10 @@ not run.
   has no `author`.
 - `emptyTitle` · `emptyBody` · `emptyState` — what an empty thread says;
   `emptyState` replaces the whole thing.
-- `height` — default `"min(40rem, 80dvh)"`; the list scrolls inside it.
+- `height` — default `"min(40rem, 80dvh)"` (the block's own); the list
+  scrolls inside it. Yours is a length (`"40rem"`) or `"100%"` in a sized
+  box, such as the kit's `AppLayout contentMode="fill"`: a `vh` length in
+  your code is refused by `npm run check`.
 - `label` — what the thread is called to a screen reader.
 - `className` — layout around it (width, margin). Never colour.
 

package/registry/blocks/chat/demo.jsx

@@ -233,7 +233,7 @@ function SupportDemo() {
         emptyTitle="No messages yet"
         emptyBody="Ask about billing, your workspace or an invoice — Ada answers in a few seconds."
         label="Support chat"
-        height="min(44rem, 85dvh)"
+        height="44rem"
       />
     </div>
   );
@@ -412,7 +412,7 @@ function AssistantDemo() {
         emptyTitle="What should we look at?"
         emptyBody="Pip reads your orders, stock and returns. Pick a question or ask your own."
         label="Planning assistant"
-        height="min(40rem, 85dvh)"
+        height="40rem"
       />
     </div>
   );

package/registry/blocks/flow-canvas/README.md

@@ -111,7 +111,10 @@ re-route as cards move; handle ids are not stored.
   screen). `onExitPresentation()` — Esc and the bar's Exit call it; turn
   `presentation` off there.
 - `height` — the canvas's height, default `560` (px; any CSS length works:
-  `"70vh"`, `"100%"` inside a sized box).
+  `"100%"` inside a sized box, such as the kit's `AppLayout
+  contentMode="fill"` for a board that is the whole surface, the
+  Example). Never a `vh` length: `npm run check` refuses a size taken
+  from the window.
 - `bare` — `false` (default: rounded, bordered). `true`: no border or
   radius, for a full-page board.
 - `label` — the board's accessible name, default `"Board"`; also the list
@@ -370,6 +373,7 @@ import { useState } from "react";
 import { useSearchParams } from "next/navigation";
 import { useRow } from "../lib/data";
 import { updateRow } from "../lib/actions";
+import { AppLayout } from "../components/ui";
 import { FlowCanvas } from "../components/blocks/flow-canvas";
 
 export default function LaunchSurface() {
@@ -382,13 +386,16 @@ export default function LaunchSurface() {
 function LaunchBoard({ project }) {
   const [board, setBoard] = useState(project.board);   // jsonb, may be null; read once per project
   return (
-    <FlowCanvas
-      value={board ?? undefined}
-      onChange={setBoard}
-      onSave={(b) => updateRow({ source: "projects", id: project.id, patch: { board: b } })}
-      label={`${project.name} board`}
-      height="calc(100dvh - 8rem)"
-    />
+    <AppLayout contentMode="fill">
+      <FlowCanvas
+        value={board ?? undefined}
+        onChange={setBoard}
+        onSave={(b) => updateRow({ source: "projects", id: project.id, patch: { board: b } })}
+        label={`${project.name} board`}
+        height="100%"
+        bare
+      />
+    </AppLayout>
   );
 }
 ```

package/registry/blocks/footer/README.md

@@ -117,8 +117,9 @@ In a server-mode app the same calls are `loadRows` in a server surface and the S
 
 - Change the language or currency by itself: `locales[].onChange` is
   yours.
-- Stick to the bottom of a short page: that is your layout's
-  `min-h-dvh` flex column.
+- Stick to the bottom of a short page: that is your layout's. The kit's
+  `AppLayout` content is a flex column, so a `flex-1` above the footer
+  pushes it down on a short page and lets it follow a long one.
 - Paint itself in the primary colour: the look is the workspace
   theme's.
 - Draw store badges: "Get the app" is two buttons with the Apple and

package/registry/blocks/mind-map/README.md

@@ -96,7 +96,9 @@ string, or nothing (a fresh map). The component runs it on `value`.
 - `placeholder` — what an empty topic shows while it is typed (default
   "New topic").
 - `height` — px or any CSS length, default `600`. A height class in
-  `className` (`h-dvh`, `h-full`, `flex-1`) replaces it.
+  `className` (`h-full`, `min-h-0 flex-1`) replaces it: `min-h-0 flex-1`
+  fills what the surface has left (the Example). Never `h-dvh` or a `vh`
+  height, which `npm run check` refuses.
 - `label` — the map's accessible name (default "Mind map").
 - `onSelectionChange(topic | null)` — the selected topic changed (a side
   panel with its notes).
@@ -186,7 +188,7 @@ function PlanMap({ plan }) {
       onChange={setMap}
       onSave={(m) => updateRow({ source: "plans", id: plan.id, patch: { map: m, map_text: mindMapToText(m) } })}
       label={`${plan.name} map`}
-      className="h-[calc(100dvh-8rem)]"
+      className="min-h-0 flex-1"
     />
   );
 }

package/registry/blocks/org-chart/README.md

@@ -73,7 +73,9 @@ One row per person, as a table holds them:
   reports: kit parts (their open deals, a "Message" button).
 - `onSelectionChange(person | null)` — the selected card changed.
 - `height` — px or any CSS length, default `640`. A height class in
-  `className` (`h-dvh`, `h-full`, `flex-1`) replaces it.
+  `className` (`h-full`, `min-h-0 flex-1`) replaces it: `min-h-0 flex-1`
+  fills what the surface has left (the Example). Never `h-dvh` or a `vh`
+  height, which `npm run check` refuses.
 - `label` — the chart's accessible name (default "Org chart").
 - `className` — layout around it (margin, width, height). Never colour.
 
@@ -124,7 +126,7 @@ export default function TeamChart() {
         if (res.ok) await whenLanded(); // the people are read again: the chart draws the new manager
         return res;
       }}
-      className="h-[calc(100dvh-8rem)]"
+      className="min-h-0 flex-1"
     />
   );
 }

package/registry/blocks/page-builder/README.md

@@ -105,7 +105,7 @@ variables the app's Tailwind utilities read. The built-in blocks' CSS
 | `actions` | — | Extra top-bar controls before Save, such as landing-builder's Publish. Use kit `Button`s at `size="sm"`. |
 | `saveLabel` | `"Save"` | The Save button's words. |
 | `builderRef` | — | A ref from `usePageBuilder()`. It receives the handle. |
-| `height` | `720` | The builder's height: a number (px) or any CSS length (`"min(760px, 88dvh)"`). It fills its width. |
+| `height` | `720` | The builder's height: a number (px) or any CSS length (`"100%"` in a sized box, such as the kit's `AppLayout contentMode="fill"`; never a `vh` length, which `npm run check` refuses). It fills its width. |
 | `className` | — | Added to the frame. |
 
 ### The handle

package/registry/blocks/page-builder/demo.jsx

@@ -78,7 +78,7 @@ export default function PageBuilderDemo() {
         <Landing />
       </TabPanel>
       <TabPanel tab="fresh" value={tab}>
-        <PageBuilder title="New page" height="min(720px, 88dvh)" />
+        <PageBuilder title="New page" height={720} />
       </TabPanel>
       <TabPanel tab="own" value={tab}>
         <PageBuilder
@@ -86,7 +86,7 @@ export default function PageBuilderDemo() {
           builtIns="basics"
           blocks={OWN_BLOCKS}
           templates={OWN_TEMPLATES}
-          height="min(720px, 88dvh)"
+          height={720}
           onSave={async () => {
             await new Promise((r) => setTimeout(r, 400));
             toast.success("Page saved");
@@ -122,7 +122,7 @@ function Landing() {
         page={{ html: LAUNCH.html }}
         onSave={onSave}
         builderRef={builder}
-        height="min(760px, 88dvh)"
+        height={760}
         onUploadImage={async (file) => {
           await new Promise((r) => setTimeout(r, 500));
           // In an app: upload to storage and return its public address.

package/registry/blocks/pdf-viewer/README.md

@@ -108,7 +108,10 @@ Store a highlight as a row in its own table (`document_id`, `page`,
 - `notes` — open the Highlights list on a wide viewer at first. Default:
   open when there are highlights.
 - `height` — the viewer's height, any CSS length. Default
-  `"min(80vh, 860px)"`; it never goes under 384px.
+  `"min(80vh, 860px)"` (the block's own); it never goes under 384px.
+  Yours is a length, or `"100%"` in a sized box such as the kit's
+  `AppLayout contentMode="fill"`: a `vh` length in your code is refused
+  by `npm run check`.
 - `loading` — `true` shows the skeleton (while you fetch or make the
   file) instead of the empty state.
 - `emptyTitle` · `emptyBody` — the words when `file` is empty. Default

package/registry/blocks/sidebar/README.md

@@ -57,8 +57,11 @@ true) is where it starts. The icon rail shows every group unfolded.
 - `shortcut` — Cmd/Ctrl + this key toggles it; default `"b"`, `null` for none.
 - `variant` — `"inset"` draws the page as a card on the frame's ground.
   Default: the Sidebar's own `variant`, so you rarely pass it here.
-- `className` — the frame's height and edges (`min-h-dvh` in a shell).
-  Never colour.
+- `className` — the frame's edges, and its height from its parent: in a
+  shell it sits in the kit's `AppLayout contentMode="fill"` with
+  `min-h-0 flex-1` (the Example). The kit's `AppLayout` owns the
+  window's height; `min-h-dvh` or `h-dvh` here is refused by `npm run
+  check`. Never colour.
 
 ### Sidebar
 
@@ -138,6 +141,7 @@ The header button: opens the sheet on a phone, collapses to icons from
 // app/shell.jsx — the app's shell, the surfaces as the sidebar's items
 "use client";
 import { usePathname } from "next/navigation";
+import { AppLayout } from "../components/ui";
 import { Sidebar, SidebarLayout, SidebarTrigger } from "../components/blocks/sidebar";
 
 const ICONS = { inbox: "inbox", deals: "dollar", contacts: "users", reports: "chart" };
@@ -153,18 +157,24 @@ export default function Shell({ name, surfaces, children }) {
     active: s.key === activeKey,
     badge: s.built ? undefined : "planned",
   }));
+  // The outer AppLayout owns the window; the inner one (it fills its
+  // slot) is the content that scrolls, back to its top on a new route.
   return (
-    <SidebarLayout
-      storageKey={`${name}.sidebar`}
-      className="min-h-dvh"
-      sidebar={<Sidebar title={name} items={items} label={`${name} surfaces`} />}
-    >
-      <header className="flex min-h-14 items-center gap-2 border-b border-border px-2 md:hidden">
-        <SidebarTrigger />
-        <span className="font-semibold">{name}</span>
-      </header>
-      <main className="min-w-0 flex-1 p-4 sm:p-6">{children}</main>
-    </SidebarLayout>
+    <AppLayout contentMode="fill">
+      <SidebarLayout
+        storageKey={`${name}.sidebar`}
+        className="min-h-0 flex-1"
+        sidebar={<Sidebar title={name} items={items} label={`${name} surfaces`} />}
+      >
+        <header className="flex min-h-14 items-center gap-2 border-b border-border px-2 md:hidden">
+          <SidebarTrigger />
+          <span className="font-semibold">{name}</span>
+        </header>
+        <AppLayout contentClassName="p-4 sm:p-6" scrollKey={pathname}>
+          {children}
+        </AppLayout>
+      </SidebarLayout>
+    </AppLayout>
   );
 }
 ```

package/registry/blocks/sketch-canvas/README.md

@@ -130,8 +130,11 @@ A sketch is plain JSON. Store it as it comes out of `onChange` / `onSave`
 - `onReady(handle)` — once, when the canvas has mounted.
 - `label` — the accessible name of the canvas region (default "Sketch").
 - `className` — layout: width, margin, height. The default height is
-  `h-[32rem]`; a height class of yours (`h-dvh`, `h-full`, `min-h-…`,
-  `flex-1`) replaces it. Never colour.
+  `h-[32rem]`; a height class of yours (`h-full`, `min-h-…`, `min-h-0
+  flex-1`) replaces it. A canvas that is the whole surface sits in an
+  `AppLayout contentMode="fill"` from the kit with `min-h-0 flex-1` (the
+  Example): never `h-dvh` or a `vh` height, which `npm run check`
+  refuses. Never colour.
 
 ### The handle
 
@@ -220,6 +223,7 @@ A whiteboard that saves itself:
 import { useSearchParams } from "next/navigation";
 import { useRow } from "../lib/data";
 import { updateRow } from "../lib/actions";
+import { AppLayout } from "../components/ui";
 import { SketchCanvas } from "../components/blocks/sketch-canvas";
 
 export default function Board() {
@@ -227,13 +231,15 @@ export default function Board() {
   const { row: board, loading } = useRow({ source: "boards", id });
   if (loading || !board) return null;
   return (
-    <SketchCanvas
-      key={board.id}
-      label={board.title}
-      defaultValue={board.sketch}                       // jsonb, may be null; read once per board
-      onSave={(sketch) => updateRow({ source: "boards", id: board.id, patch: { sketch } })}
-      className="h-dvh rounded-none border-0"
-    />
+    <AppLayout contentMode="fill">
+      <SketchCanvas
+        key={board.id}
+        label={board.title}
+        defaultValue={board.sketch}                       // jsonb, may be null; read once per board
+        onSave={(sketch) => updateRow({ source: "boards", id: board.id, patch: { sketch } })}
+        className="min-h-0 flex-1 rounded-none border-0"
+      />
+    </AppLayout>
   );
 }
 ```

package/registry/blocks/whiteboard/README.md

@@ -93,8 +93,11 @@ for agents.
   receives the canvas handle: `exportImage()`, `getScene()`,
   `insertElements()`… (sketch-canvas README, "The handle").
 - `className` — layout: width, margin, height. The default height is
-  `h-[40rem]`; a height class of yours (`h-dvh` for a full page, `h-full`,
-  `flex-1`) replaces it. Never colour.
+  `h-[40rem]`; a height class of yours (`h-full`, `min-h-0 flex-1`)
+  replaces it. A board that is the whole surface sits in an `AppLayout
+  contentMode="fill"` from the kit with `min-h-0 flex-1` (the Example):
+  never `h-dvh` or a `vh` height, which `npm run check` refuses. Never
+  colour.
 
 ### Templates
 
@@ -118,6 +121,7 @@ A board page that saves itself:
 import { useSearchParams } from "next/navigation";
 import { useRow, whenLanded } from "../lib/data";
 import { updateRow } from "../lib/actions";
+import { AppLayout } from "../components/ui";
 import { Whiteboard } from "../components/blocks/whiteboard";
 import { sketchToText } from "../components/blocks/sketch-canvas";
 
@@ -126,18 +130,20 @@ export default function BoardPage() {
   const { row: board, loading } = useRow({ source: "boards", id });
   if (loading || !board) return null;
   return (
-    <Whiteboard
-      key={board.id}
-      title={board.title}
-      onRename={async (next) => {
-        const res = await updateRow({ source: "boards", id: board.id, patch: { title: next } });
-        if (res.ok) await whenLanded(); // the board is read again: the title is the new one
-        return res;
-      }}
-      defaultValue={board.sketch}                       // jsonb, may be null; read once per board
-      onSave={(sketch) => updateRow({ source: "boards", id: board.id, patch: { sketch, sketch_text: sketchToText(sketch) } })}
-      className="h-dvh rounded-none border-0"
-    />
+    <AppLayout contentMode="fill">
+      <Whiteboard
+        key={board.id}
+        title={board.title}
+        onRename={async (next) => {
+          const res = await updateRow({ source: "boards", id: board.id, patch: { title: next } });
+          if (res.ok) await whenLanded(); // the board is read again: the title is the new one
+          return res;
+        }}
+        defaultValue={board.sketch}                       // jsonb, may be null; read once per board
+        onSave={(sketch) => updateRow({ source: "boards", id: board.id, patch: { sketch, sketch_text: sketchToText(sketch) } })}
+        className="min-h-0 flex-1 rounded-none border-0"
+      />
+    </AppLayout>
   );
 }
 ```

package/src/cli.mjs

@@ -107,7 +107,7 @@ const listLine = (paths, n = 6) => (paths.length > n ? `${paths.slice(0, n).join
 
 function packageLines(changes) {
   if (!changes.length) return [];
-  return [`  package.json: ${changes.map((c) => `${c.name} ${c.from ?? "(new)"} → ${c.to}`).join(" · ")}`];
+  return [`  package.json: ${changes.map((c) => `${c.name} ${c.from ?? "(new)"} → ${c.to ?? "(removed)"}`).join(" · ")}`];
 }
 
 /** The lock's line, when it was written. What it left out is a note. */
@@ -230,7 +230,7 @@ function diffText(r) {
     return lines.join("\n");
   }
   for (const e of r.entries) lines.push(`  ${e.item.padEnd(14)} ${e.status.padEnd(8)} ${e.path}${e.detail ? ` — ${e.detail}` : ""}`);
-  for (const c of r.package) lines.push(`  ${"package.json".padEnd(14)} ${c.key}.${c.name}: ${c.from ?? "(new)"} → ${c.to}`);
+  for (const c of r.package) lines.push(`  ${"package.json".padEnd(14)} ${c.key}.${c.name}: ${c.from ?? "(new)"} → ${c.to ?? "(removed)"}`);
   lines.push(`next: npx makersclaw update${r.compatible ? "" : " --major"}`);
   return lines.join("\n");
 }

package/src/install.mjs

@@ -28,7 +28,7 @@ import { join } from "node:path";
 import { hashFile, readJson, removeFile, sha256, walk, writeFile, writeJson } from "./fsutil.mjs";
 import { LOCKFILE, LockError, deriveLock, parseLock } from "./lockfile.mjs";
 import { NPM_LOCKFILE, PNPM_VERSION, installDeps } from "./pm.mjs";
-import { BASE_MODE, BLOCK_DIR, loadBlocks, loadItems, loadTemplate, modeFiles, packageInfo, readmeOf, suggest, templateNames } from "./registry.mjs";
+import { BASE_MODE, BLOCK_DIR, loadBlocks, loadItems, loadTemplate, modeDropScripts, modeFiles, modePackage, packageInfo, readmeOf, suggest, templateNames } from "./registry.mjs";
 
 export const MANIFEST = "makersclaw.json";
 export const PINS = "check/pins.json";
@@ -231,8 +231,11 @@ function loadTemplateOrFail(name) {
 }
 
 /** package.json: the template's scripts and dependencies win for the keys
- *  it names; every other key is the app's. */
-function mergePackage(app, tpl) {
+ *  it names; every other key is the app's. `dropScripts` are the scripts
+ *  the app's mode has none of (registry modeDropScripts): removed whatever
+ *  they say, so a server app switched to browser loses its `start`; a
+ *  removal is a change `to: null`. */
+function mergePackage(app, tpl, dropScripts = []) {
   const out = { ...app };
   const changes = [];
   for (const key of ["scripts", "dependencies", "devDependencies"]) {
@@ -244,6 +247,12 @@ function mergePackage(app, tpl) {
       out[key][name] = value;
     }
   }
+  for (const name of dropScripts) {
+    if (out.scripts?.[name] === undefined) continue;
+    out.scripts = { ...out.scripts };
+    changes.push({ key: "scripts", name, from: out.scripts[name], to: null });
+    delete out.scripts[name];
+  }
   return { out, changes };
 }
 
@@ -346,8 +355,10 @@ function lay(dir, tpl, before, { tables, mode } = {}) {
       kept.push(f.path);
       continue;
     }
+    // package.json is the mode's (registry modePackage): a browser app's
+    // has no start script, whether it is laid new or merged.
     if (f.class === "merged" && existsSync(to)) {
-      const { out, changes } = mergePackage(readJson(to), readJson(f.from));
+      const { out, changes } = mergePackage(readJson(to), modePackage(tpl, appMode), modeDropScripts(tpl, appMode));
       if (changes.length) {
         writeJson(to, out);
         written.push(f.path);
@@ -355,6 +366,11 @@ function lay(dir, tpl, before, { tables, mode } = {}) {
       pkg = changes;
       continue;
     }
+    if (f.class === "merged") {
+      writeJson(to, modePackage(tpl, appMode));
+      written.push(f.path);
+      continue;
+    }
     const bytes = readFileSync(f.from);
     const hash = sha256(bytes);
     if (hashFile(to) !== hash) {
@@ -768,13 +784,14 @@ export function diff(dir) {
 
   const pkgPath = join(dir, "package.json");
   const tplPkg = tpl.files.find((f) => f.class === "merged");
-  const pkg = existsSync(pkgPath) && tplPkg ? mergePackage(readJson(pkgPath), readJson(tplPkg.from)).changes : [];
+  const drop = modeDropScripts(tpl, appMode);
+  const pkg = existsSync(pkgPath) && tplPkg ? mergePackage(readJson(pkgPath), modePackage(tpl, appMode), drop).changes : [];
   // …and the installed blocks' npm packages, which update lays with them.
   const blockDeps = Object.assign({}, ...Object.keys(manifest.blocks ?? {}).map((n) => known.find((b) => b.name === n)?.dependencies ?? {}));
   if (existsSync(pkgPath) && Object.keys(blockDeps).length) pkg.push(...mergePackage(readJson(pkgPath), { dependencies: blockDeps }).changes);
   // …and the lock update would cut for the package.json it would leave.
   if (existsSync(pkgPath) && tplPkg) {
-    const after = mergePackage(mergePackage(readJson(pkgPath), readJson(tplPkg.from)).out, { dependencies: blockDeps }).out;
+    const after = mergePackage(mergePackage(readJson(pkgPath), modePackage(tpl, appMode), drop).out, { dependencies: blockDeps }).out;
     const cut = cutLock(dir, tpl, after);
     if (cut && cut.text !== cut.before) entries.push({ item: "template", path: LOCKFILE, status: cut.before === null ? "new" : "changed" });
   }

package/src/registry.mjs

@@ -81,8 +81,10 @@ export const BASE_MODE = "server";
  *   - Each dropped file is a fixed file of the base: a drop the base does
  *     not ship drops nothing, without a word, and only a pinned file is
  *     the template's to remove from an app.
+ *   - Each dropped script (`dropScripts`, 0.8.0) is a script of the base's
+ *     package.json (`scripts`, its names), for the same reason.
  */
-export function checkMode(template, mode, { base, overlay, drop }) {
+export function checkMode(template, mode, { base, overlay, drop, scripts = [], dropScripts = [] }) {
   const fixed = new Set(base.filter((f) => f.class === "fixed").map((f) => f.path));
   const dropped = new Set(drop);
   for (const path of overlay) {
@@ -94,6 +96,9 @@ export function checkMode(template, mode, { base, overlay, drop }) {
   for (const path of drop) {
     if (!fixed.has(path)) throw new Error(`template ${template}: mode ${mode} drops ${path}, which is not a fixed file of files/ — it would drop nothing`);
   }
+  for (const name of dropScripts) {
+    if (!scripts.includes(name)) throw new Error(`template ${template}: mode ${mode} drops the script ${name}, which files/package.json has not — it would drop nothing`);
+  }
 }
 
 /** A mode's overlay folder: beside files/, a plain name. */
@@ -112,8 +117,11 @@ function loadModes(name, dir, meta, base) {
     // files out. Browser mode's own files come after its drop list does.
     const overlay = existsSync(root) ? walk(root) : [];
     const drop = [...(spec.drop ?? [])];
-    checkMode(name, mode, { base, overlay, drop });
-    modes[mode] = { root, drop, files: overlay.map((path) => ({ path, class: "fixed", from: join(root, path) })) };
+    const dropScripts = [...(spec.dropScripts ?? [])];
+    const merged = base.find((f) => f.class === "merged");
+    const scripts = Object.keys((merged && readJson(merged.from)?.scripts) ?? {});
+    checkMode(name, mode, { base, overlay, drop, scripts, dropScripts });
+    modes[mode] = { root, drop, dropScripts, files: overlay.map((path) => ({ path, class: "fixed", from: join(root, path) })) };
   }
   return modes;
 }
@@ -132,6 +140,29 @@ export function modeFiles(template, mode = BASE_MODE) {
   return template.files.filter((f) => !drop.has(f.path)).map((f) => over.get(f.path) ?? f);
 }
 
+/**
+ * The scripts an app in this mode has none of (template.json
+ * `modes.<mode>.dropScripts`). Browser mode drops `start` (0.8.0): a
+ * browser app is built once and served as files, nothing ever starts it,
+ * and the store refuses a browser app's package.json that names one (its
+ * own-rules.mjs, browserScriptRefusals). Until 0.8.0 init laid the base's
+ * `start` into every app.
+ */
+export function modeDropScripts(template, mode = BASE_MODE) {
+  return mode === BASE_MODE ? [] : [...(template.modes?.[mode]?.dropScripts ?? [])];
+}
+
+/** The template's package.json as a mode lays it: the base's, less the
+ *  scripts the mode drops. null when the template has no merged file. */
+export function modePackage(template, mode = BASE_MODE) {
+  const merged = template.files.find((f) => f.class === "merged");
+  if (!merged) return null;
+  const pkg = readJson(merged.from);
+  const drop = modeDropScripts(template, mode);
+  if (drop.length && pkg.scripts) pkg.scripts = Object.fromEntries(Object.entries(pkg.scripts).filter(([name]) => !drop.includes(name)));
+  return pkg;
+}
+
 export function loadTemplate(name) {
   const dir = join(TEMPLATES, name);
   const meta = readJson(join(dir, "template.json"));