@squadbase/vantage 0.6.2-dev1.9612525 → 0.6.2-dev1.9d7130b

package/dist/{chunk-LMUACBMA.js → chunk-SHZM3EXB.js}

@@ -1,11 +1,14 @@
-import { buildRouteTree, filePageModuleName, filePageKind } from './chunk-CEXAQQ5W.js';
-import { timed } from './chunk-ZVANIULZ.js';
+import { extractAppLang, buildRouteTree, filePageModuleName, filePageKind } from './chunk-S5MDTHH7.js';
+import { timed, routeSortKey } from './chunk-RNTDBX6S.js';
 import { VANTAGE_DIR, MANIFEST_SCHEMA_VERSION } from './chunk-C2CX6GLX.js';
 import fs from 'fs';
 import path from 'path';
 import { createRequire } from 'module';
 
 // @squadbase/vantage — generated build. Do not edit.
+
+// src/core/api-change.ts
+var API_CHANGE_EVENT = "vantage:api-change";
 var PKG = "@squadbase/vantage";
 var FILE_PAGES_DIR = "file-pages";
 var ASSET_QUERY = "?url&no-inline";
@@ -111,9 +114,9 @@ function renderServerRoutes(model) {
   lines.push("");
   return lines.join("\n");
 }
-function renderIndexHtml() {
+function renderIndexHtml(lang = "en") {
   return `<!doctype html>
-<html lang="en">
+<html lang="${lang}">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
@@ -126,12 +129,39 @@ function renderIndexHtml() {
 </html>
 `;
 }
-function renderClientEntry() {
+function renderClientEntry(draft) {
+  if (!draft) {
+    return `${BANNER}import { bootstrap } from "${PKG}/client"
+import { manifest } from "./route-tree.gen"
+import "./runtime.css"
+
+const app = bootstrap(manifest)
+
+// @ts-ignore -- HMR types are not part of the generated env
+if (import.meta.hot) {
+  // @ts-ignore -- HMR types are not part of the generated env
+  import.meta.hot.on("${API_CHANGE_EVENT}", () => app.refreshApi())
+}
+`;
+  }
   return `${BANNER}import { bootstrap } from "${PKG}/client"
+import type { ClientManifest } from "${PKG}/client"
 import { manifest } from "./route-tree.gen"
 import "./runtime.css"
 
-bootstrap(manifest)
+// @ts-ignore -- HMR types are not part of the generated env
+const hot = import.meta.hot
+const app = bootstrap(manifest, { hot })
+
+// @ts-ignore -- HMR types are not part of the generated env
+if (import.meta.hot) {
+  // @ts-ignore -- HMR types are not part of the generated env
+  import.meta.hot.on("${API_CHANGE_EVENT}", () => app.refreshApi())
+  // @ts-ignore -- HMR types are not part of the generated env
+  import.meta.hot.accept("./route-tree.gen", (mod: { manifest: ClientManifest } | undefined) => {
+    if (mod) app.update(mod.manifest)
+  })
+}
 `;
 }
 function renderRuntimeCss(root, pageDir) {
@@ -225,15 +255,41 @@ function writeFilePages(vantageDir, tree) {
     if (!keep.has(entry)) fs.rmSync(path.join(dir, entry), { force: true });
   }
 }
+var draftArtifacts = /* @__PURE__ */ new Map();
+function setDraftArtifacts(root, draft) {
+  if (draft) draftArtifacts.set(root, draft);
+  else draftArtifacts.delete(root);
+}
+function restoreClientEntry(root) {
+  const file = path.join(root, VANTAGE_DIR, "client-entry.tsx");
+  const content = renderClientEntry(Boolean(draftArtifacts.get(root)?.hmr));
+  try {
+    if (fs.readFileSync(file, "utf8") === content) return false;
+  } catch {
+  }
+  fs.writeFileSync(file, content);
+  return true;
+}
+function withDraftPages(model, draft) {
+  if (!draft || draft.pages.length === 0) return model;
+  const known = new Set(model.pages.map((p) => p.file));
+  const extra = draft.pages.filter((p) => !known.has(p.file));
+  if (extra.length === 0) return model;
+  return {
+    ...model,
+    pages: [...model.pages, ...extra].sort((a, b) => routeSortKey(a).localeCompare(routeSortKey(b)))
+  };
+}
 function generateArtifacts({ root, model }) {
   return timed("generate", () => {
     const vantageDir = path.join(root, VANTAGE_DIR);
     ensureDir(vantageDir);
     ensureDir(path.join(vantageDir, "types"));
     writeIfChanged(path.join(vantageDir, ".gitignore"), "*\n");
-    writeIfChanged(path.join(vantageDir, "index.html"), renderIndexHtml());
-    writeIfChanged(path.join(vantageDir, "client-entry.tsx"), renderClientEntry());
-    const tree = buildRouteTree(model);
+    writeIfChanged(path.join(vantageDir, "index.html"), renderIndexHtml(extractAppLang(model)));
+    const draft = draftArtifacts.get(root);
+    writeIfChanged(path.join(vantageDir, "client-entry.tsx"), renderClientEntry(Boolean(draft?.hmr)));
+    const tree = buildRouteTree(withDraftPages(model, draft));
     writeIfChanged(path.join(vantageDir, "route-tree.gen.ts"), renderRouteTree(tree));
     writeIfChanged(path.join(vantageDir, "runtime.css"), renderRuntimeCss(root, model.pageDir));
     writeIfChanged(path.join(vantageDir, "types", "env.d.ts"), renderEnvTypes());
@@ -246,6 +302,6 @@ function generateArtifacts({ root, model }) {
   });
 }
 
-export { generateArtifacts };
-//# sourceMappingURL=chunk-LMUACBMA.js.map
-//# sourceMappingURL=chunk-LMUACBMA.js.map
+export { API_CHANGE_EVENT, generateArtifacts, restoreClientEntry, setDraftArtifacts };
+//# sourceMappingURL=chunk-SHZM3EXB.js.map
+//# sourceMappingURL=chunk-SHZM3EXB.js.map

package/dist/chunk-SHZM3EXB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/api-change.ts","../src/core/generate.ts"],"names":["require"],"mappings":"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","file":"chunk-SHZM3EXB.js","sourcesContent":["/**\n * Custom HMR event the dev server sends when a `server/api` module is added,\n * changed or removed. Payload: `{ paths: string[] }` (project-relative). The\n * client entry listens and refetches the API queries; a client without the\n * listener ignores it.\n */\nexport const API_CHANGE_EVENT = \"vantage:api-change\"\n","import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { createRequire } from \"node:module\"\nimport { API_CHANGE_EVENT } from \"./api-change\"\nimport { MANIFEST_SCHEMA_VERSION, VANTAGE_DIR } from \"./constants\"\nimport { filePageKind, filePageModuleName } from \"./file-page\"\nimport { timed } from \"./profile\"\nimport { buildRouteTree, extractAppLang } from \"./route-tree\"\nimport type { BuiltPage, BuiltTree } from \"./route-tree\"\nimport { routeSortKey } from \"./scan\"\nimport type { PageRoute, RouteModel, Segment } from \"./types\"\n\nconst PKG = \"@squadbase/vantage\"\n\n/** Subdirectory of `.vantage/` holding one wrapper module per data-file page. */\nconst FILE_PAGES_DIR = \"file-pages\"\n\n/**\n * Vite inlines an asset under 4 KB as a base64 data URL, which would bury a\n * small `.csv` inside a JS chunk and leave the download link pointing at it.\n * `?no-inline` is checked before the size limit, so it always wins.\n */\nconst ASSET_QUERY = \"?url&no-inline\"\n\n/**\n * Resolve the absolute directory of the installed @squadbase/vantage package.\n * Memoized per root: module resolution is comparatively expensive and the answer\n * cannot change while the process lives.\n */\nconst vantageDirCache = new Map<string, string | null>()\n\nfunction resolveVantageDir(root: string): string | null {\n  const hit = vantageDirCache.get(root)\n  if (hit !== undefined) return hit\n  let dir: string | null\n  try {\n    const require = createRequire(path.join(root, \"noop.js\"))\n    dir = path.dirname(require.resolve(`${PKG}/package.json`))\n  } catch {\n    dir = null\n  }\n  vantageDirCache.set(root, dir)\n  return dir\n}\n\n/** POSIX import specifier from `.vantage/` to a project-relative file. */\nfunction importFromVantage(relFile: string): string {\n  return `../${relFile}`\n}\n\n/**\n * POSIX import specifier from `.vantage/file-pages/` to a project-relative\n * file — one level deeper than `importFromVantage`. Do not mix the two up. The\n * \".vantage/ sits exactly one level below the project root\" invariant still\n * holds for the directory itself; this is a second, explicit depth used only\n * by the generated wrappers.\n */\nfunction importFromFilePages(relFile: string): string {\n  return `../../${relFile}`\n}\n\nfunction ensureDir(dir: string): void {\n  fs.mkdirSync(dir, { recursive: true })\n}\n\nfunction writeIfChanged(file: string, content: string): void {\n  try {\n    if (fs.existsSync(file) && fs.readFileSync(file, \"utf8\") === content) return\n  } catch {\n    /* fall through to write */\n  }\n  fs.writeFileSync(file, content)\n}\n\nfunction serializeSegments(segments: Segment[]): string {\n  return (\n    \"[\" +\n    segments\n      .map((s) => {\n        if (s.kind === \"static\") return `{ kind: \"static\", value: ${JSON.stringify(s.value)} }`\n        if (s.kind === \"param\") return `{ kind: \"param\", name: ${JSON.stringify(s.name)} }`\n        return `{ kind: \"catchall\", name: ${JSON.stringify(s.name)} }`\n      })\n      .join(\", \") +\n    \"]\"\n  )\n}\n\nconst BANNER =\n  \"// AUTO-GENERATED by @squadbase/vantage. Do not edit — regenerated on every run.\\n\"\n\nfunction renderRouteTree(tree: BuiltTree): string {\n  const lines: string[] = []\n  lines.push(BANNER)\n  lines.push(`import type { ClientManifest } from \"${PKG}/client\"`)\n  lines.push(\"\")\n  lines.push(\"export const manifest: ClientManifest = {\")\n  lines.push(\n    `  rootLayout: ${tree.rootLayout ? `() => import(${JSON.stringify(importFromVantage(tree.rootLayout))})` : \"null\"},`,\n  )\n  lines.push(\n    `  notFound: ${tree.notFound ? `() => import(${JSON.stringify(importFromVantage(tree.notFound))})` : \"null\"},`,\n  )\n  lines.push(\n    `  error: ${tree.error ? `() => import(${JSON.stringify(importFromVantage(tree.error))})` : \"null\"},`,\n  )\n  lines.push(\"  layouts: [\")\n  for (const l of tree.layouts) {\n    lines.push(\n      `    { id: ${JSON.stringify(l.id)}, parentId: ${JSON.stringify(l.parentId)}, path: ${JSON.stringify(\n        l.path,\n      )}, load: () => import(${JSON.stringify(importFromVantage(l.file))}) },`,\n    )\n  }\n  lines.push(\"  ],\")\n  lines.push(\"  pages: [\")\n  for (const p of tree.pages) {\n    const extra: string[] = []\n    if (p.title) extra.push(`title: ${JSON.stringify(p.title)}`)\n    if (p.description) extra.push(`description: ${JSON.stringify(p.description)}`)\n    if (p.navLabel) extra.push(`navLabel: ${JSON.stringify(p.navLabel)}`)\n    if (p.kind !== \"module\") extra.push(`kind: ${JSON.stringify(p.kind)}`)\n    if (p.variant) extra.push(`variant: ${JSON.stringify(p.variant)}`)\n    // A data file is not a module, so the manifest loads the wrapper generated\n    // for it instead. Everything else about the entry is unchanged, which is\n    // why the client manifest shape stays the same.\n    const specifier =\n      p.kind === \"file\"\n        ? `./${FILE_PAGES_DIR}/${filePageModuleName(p)}`\n        : importFromVantage(p.file)\n    lines.push(\n      `    { parentLayoutId: ${JSON.stringify(p.parentLayoutId)}, path: ${JSON.stringify(\n        p.path,\n      )}, index: ${p.index}, routePath: ${JSON.stringify(p.routePath)}${\n        extra.length ? \", \" + extra.join(\", \") : \"\"\n      }, load: () => import(${JSON.stringify(specifier)}) },`,\n    )\n  }\n  lines.push(\"  ],\")\n  lines.push(\"}\")\n  lines.push(\"\")\n  return lines.join(\"\\n\")\n}\n\nfunction renderServerRoutes(model: RouteModel): string {\n  const lines: string[] = []\n  lines.push(BANNER)\n  lines.push(`import type { ProdApiRoute } from \"${PKG}/server/node\"`)\n  model.apis.forEach((a, i) => {\n    lines.push(`import * as m${i} from ${JSON.stringify(importFromVantage(a.file))}`)\n  })\n  lines.push(\"\")\n  lines.push(\"export const apiRoutes: ProdApiRoute[] = [\")\n  model.apis.forEach((a, i) => {\n    lines.push(\n      `  { routePath: ${JSON.stringify(a.routePath)}, segments: ${serializeSegments(\n        a.segments,\n      )}, module: m${i} },`,\n    )\n  })\n  lines.push(\"]\")\n  lines.push(\"\")\n  return lines.join(\"\\n\")\n}\n\nexport function renderIndexHtml(lang = \"en\"): string {\n  return `<!doctype html>\n<html lang=\"${lang}\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>Vantage</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/.vantage/client-entry.tsx\"></script>\n  </body>\n</html>\n`\n}\n\nfunction renderClientEntry(draft: boolean): string {\n  if (!draft) {\n    return `${BANNER}import { bootstrap } from \"${PKG}/client\"\nimport { manifest } from \"./route-tree.gen\"\nimport \"./runtime.css\"\n\nconst app = bootstrap(manifest)\n\n// @ts-ignore -- HMR types are not part of the generated env\nif (import.meta.hot) {\n  // @ts-ignore -- HMR types are not part of the generated env\n  import.meta.hot.on(\"${API_CHANGE_EVENT}\", () => app.refreshApi())\n}\n`\n  }\n  // Draft preview: the route tree is an HMR boundary, so a provisional page can\n  // join it without a reload. `import.meta.hot` is not in the generated env\n  // types (an app that pulls in vite/client would see a duplicate declaration\n  // if it were), hence the ignores.\n  return `${BANNER}import { bootstrap } from \"${PKG}/client\"\nimport type { ClientManifest } from \"${PKG}/client\"\nimport { manifest } from \"./route-tree.gen\"\nimport \"./runtime.css\"\n\n// @ts-ignore -- HMR types are not part of the generated env\nconst hot = import.meta.hot\nconst app = bootstrap(manifest, { hot })\n\n// @ts-ignore -- HMR types are not part of the generated env\nif (import.meta.hot) {\n  // @ts-ignore -- HMR types are not part of the generated env\n  import.meta.hot.on(\"${API_CHANGE_EVENT}\", () => app.refreshApi())\n  // @ts-ignore -- HMR types are not part of the generated env\n  import.meta.hot.accept(\"./route-tree.gen\", (mod: { manifest: ClientManifest } | undefined) => {\n    if (mod) app.update(mod.manifest)\n  })\n}\n`\n}\n\nfunction renderRuntimeCss(root: string, pageDir: string): string {\n  const parts: string[] = []\n  parts.push('@import \"tailwindcss\";')\n  parts.push(`@import \"${PKG}/theme.css\";`)\n  // The global stylesheet lives next to the pages: styles.css at the project\n  // root, or src/styles.css once src/ exists (`SRC_DIR_SPLIT` catches a leftover\n  // root-level one instead of importing both).\n  const stylesRel = pageDir === \"\" ? \"styles.css\" : `${pageDir}/styles.css`\n  if (fs.existsSync(path.join(root, stylesRel))) {\n    parts.push(`@import \"../${stylesRel}\";`)\n  }\n  // Tailwind auto-detects the Vite project root; the packaged components live\n  // in node_modules, which Tailwind skips by default, so register them here.\n  // The whole of dist/ has to be scanned, not just dist/ui and dist/components:\n  // tsup hoists code shared between entries into top-level dist/chunk-*.js, and\n  // that is where most of the component class strings end up.\n  const vantageDir = resolveVantageDir(root)\n  if (vantageDir) {\n    parts.push(`@source ${JSON.stringify(path.join(vantageDir, \"dist\"))};`)\n  }\n  return parts.join(\"\\n\") + \"\\n\"\n}\n\nfunction renderEnvTypes(): string {\n  return `${BANNER}\ninterface ImportMetaEnv {\n  readonly MODE: string\n  readonly DEV: boolean\n  readonly PROD: boolean\n  readonly SSR: boolean\n  readonly BASE_URL: string\n  readonly [key: \\`PUBLIC_\\${string}\\`]: string | undefined\n}\n\ninterface ImportMeta {\n  readonly env: ImportMetaEnv\n}\n\ndeclare module \"*.css\" {\n  const content: string\n  export default content\n}\n\n// Generated data-file pages import their source with Vite's asset query. The\n// app's tsconfig includes .vantage/**/*.tsx, so the wrappers are type-checked\n// alongside the app and need this declaration to resolve.\ndeclare module \"*?url&no-inline\" {\n  const src: string\n  export default src\n}\n`\n}\n\nfunction renderInternalManifest(model: RouteModel): string {\n  return (\n    JSON.stringify(\n      {\n        schemaVersion: MANIFEST_SCHEMA_VERSION,\n        pageDir: model.pageDir,\n        pages: model.pages.map((p) => ({ file: p.file, route: p.routePath })),\n        apis: model.apis.map((a) => ({ file: a.file, route: a.routePath })),\n        hasServer: model.hasServer,\n      },\n      null,\n      2,\n    ) + \"\\n\"\n  )\n}\n\n/**\n * The wrapper module standing in for one data-file page. Thin on purpose: the\n * asset import is what puts the file through Vite's pipeline (hashed in the\n * build, a stable URL in dev), and everything else lives in the viewer.\n */\nfunction renderFilePageWrapper(page: BuiltPage): string {\n  const fileName = path.posix.basename(page.file)\n  const props = [\n    `kind=${JSON.stringify(filePageKind(page))}`,\n    \"src={src}\",\n    `fileName={${JSON.stringify(fileName)}}`,\n    ...(page.title ? [`title={${JSON.stringify(page.title)}}`] : []),\n  ]\n  return `${BANNER}import { FilePageView } from \"${PKG}/table\"\nimport src from ${JSON.stringify(importFromFilePages(page.file) + ASSET_QUERY)}\n\n// ${page.file} -> ${page.routePath}\nexport default function FilePage() {\n  return <FilePageView ${props.join(\" \")} />\n}\n`\n}\n\n/**\n * One wrapper module per data-file page. `writeIfChanged` never deletes, so\n * orphans are pruned explicitly: a renamed `.csv` would otherwise leave behind\n * a wrapper importing a file that no longer exists — invisible to the build\n * (rollup only follows the manifest) but a hard error in the app's own `tsc`.\n */\nfunction writeFilePages(vantageDir: string, tree: { pages: BuiltPage[] }): void {\n  const dir = path.join(vantageDir, FILE_PAGES_DIR)\n  const filePages = tree.pages.filter((p) => p.kind === \"file\")\n  if (filePages.length === 0) {\n    fs.rmSync(dir, { recursive: true, force: true })\n    return\n  }\n  ensureDir(dir)\n  const keep = new Set<string>()\n  for (const page of filePages) {\n    const name = filePageModuleName(page)\n    keep.add(name)\n    writeIfChanged(path.join(dir, name), renderFilePageWrapper(page))\n  }\n  for (const entry of fs.readdirSync(dir)) {\n    if (!keep.has(entry)) fs.rmSync(path.join(dir, entry), { force: true })\n  }\n}\n\n/** Options controlling artifact generation. */\nexport interface GenerateOptions {\n  root: string\n  model: RouteModel\n}\n\n/**\n * What the draft preview layers over a plain scan. Held per project root rather\n * than passed in, because the dev watcher regenerates on its own and must keep\n * producing the same tree while a draft is open.\n */\nexport interface DraftArtifacts {\n  /** The client entry accepts route-tree updates instead of reloading. */\n  hmr: boolean\n  /** Pages with no file on disk yet, merged into the route tree. */\n  pages: PageRoute[]\n}\n\nconst draftArtifacts = new Map<string, DraftArtifacts>()\n\n/** Set (or, with `null`, clear) the draft layer for `root`. */\nexport function setDraftArtifacts(root: string, draft: DraftArtifacts | null): void {\n  if (draft) draftArtifacts.set(root, draft)\n  else draftArtifacts.delete(root)\n}\n\n/**\n * Write the client entry this root's dev server serves, if the file on disk is\n * something else. A `vantage build` run in the same project (a deploy's prebuild\n * next to a dev server with draft preview) writes the production entry, which has\n * no HMR hooks; the draft layer puts its own back (see `vite/draft/plugin.ts`).\n * Only the entry: a route tree with provisional pages must not reach a build.\n * True when it had to be rewritten.\n */\nexport function restoreClientEntry(root: string): boolean {\n  const file = path.join(root, VANTAGE_DIR, \"client-entry.tsx\")\n  const content = renderClientEntry(Boolean(draftArtifacts.get(root)?.hmr))\n  try {\n    if (fs.readFileSync(file, \"utf8\") === content) return false\n  } catch {\n    /* fall through to write */\n  }\n  fs.writeFileSync(file, content)\n  return true\n}\n\n/**\n * The model the route tree is built from: the scan plus the drafted pages. A\n * page the scan already found wins over its draft, so the tree is the same\n * before and after the file lands.\n */\nfunction withDraftPages(model: RouteModel, draft: DraftArtifacts | undefined): RouteModel {\n  if (!draft || draft.pages.length === 0) return model\n  const known = new Set(model.pages.map((p) => p.file))\n  const extra = draft.pages.filter((p) => !known.has(p.file))\n  if (extra.length === 0) return model\n  return {\n    ...model,\n    pages: [...model.pages, ...extra].sort((a, b) => routeSortKey(a).localeCompare(routeSortKey(b))),\n  }\n}\n\n/**\n * Regenerate the `.vantage/` directory from a route model. Idempotent and\n * content-stable so it does not thrash file watchers.\n */\nexport function generateArtifacts({ root, model }: GenerateOptions): string {\n  return timed(\"generate\", () => {\n    const vantageDir = path.join(root, VANTAGE_DIR)\n    ensureDir(vantageDir)\n    ensureDir(path.join(vantageDir, \"types\"))\n\n    // Everything in .vantage is generated and git/agent/search invisible.\n    writeIfChanged(path.join(vantageDir, \".gitignore\"), \"*\\n\")\n    writeIfChanged(path.join(vantageDir, \"index.html\"), renderIndexHtml(extractAppLang(model)))\n    const draft = draftArtifacts.get(root)\n    writeIfChanged(path.join(vantageDir, \"client-entry.tsx\"), renderClientEntry(Boolean(draft?.hmr)))\n    // Built once and shared: `renderRouteTree` and `writeFilePages` need the\n    // same tree, and building it twice re-reads every page module for metadata.\n    const tree = buildRouteTree(withDraftPages(model, draft))\n    writeIfChanged(path.join(vantageDir, \"route-tree.gen.ts\"), renderRouteTree(tree))\n    writeIfChanged(path.join(vantageDir, \"runtime.css\"), renderRuntimeCss(root, model.pageDir))\n    writeIfChanged(path.join(vantageDir, \"types\", \"env.d.ts\"), renderEnvTypes())\n    writeIfChanged(path.join(vantageDir, \"manifest.json\"), renderInternalManifest(model))\n\n    writeFilePages(vantageDir, tree)\n\n    if (model.hasServer) {\n      writeIfChanged(path.join(vantageDir, \"server-routes.gen.ts\"), renderServerRoutes(model))\n    }\n\n    return vantageDir\n  })\n}\n"]}

package/dist/chunk-TRMHNMMZ.js

@@ -0,0 +1,61 @@
+import { formatDelta } from './chunk-3RJEOP3J.js';
+import { useLocale, uiLanguage } from './chunk-ROHNXP7J.js';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
+
+// @squadbase/vantage — generated build. Do not edit.
+var MUTED = { color: "var(--doc-muted)" };
+var TEXT = {
+  ja: {
+    up: "\u5897",
+    down: "\u6E1B",
+    flat: "\u6A2A\u3070\u3044",
+    label: (word, text, good) => `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`
+  },
+  en: {
+    up: "Up",
+    down: "Down",
+    flat: "Flat",
+    label: (word, text, good) => `${word}, ${text}${good === void 0 ? "" : good ? ", improved" : ", worsened"}`
+  }
+};
+function DeltaText({ value, format, betterWhen = "up", comparisonLabel, locale: localeProp }) {
+  const locale = useLocale(localeProp);
+  const t = TEXT[uiLanguage(locale)];
+  const label = comparisonLabel ? /* @__PURE__ */ jsxs("span", { style: MUTED, children: [
+    comparisonLabel,
+    " "
+  ] }) : null;
+  if (value === null) {
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      label,
+      /* @__PURE__ */ jsx("span", { "data-slot": "delta-text", style: MUTED, children: "\u2014" })
+    ] });
+  }
+  const dir = value > 0 ? "up" : value < 0 ? "down" : "flat";
+  const mark = dir === "up" ? "\u25B2" : dir === "down" ? "\u25BC" : "\u2192";
+  const word = t[dir];
+  const good = dir === "flat" ? void 0 : dir === "up" === (betterWhen === "up");
+  const tone = good === void 0 ? void 0 : good ? "text-positive" : "text-negative";
+  const text = formatDelta(value, format, locale);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    label,
+    /* @__PURE__ */ jsxs(
+      "span",
+      {
+        "data-slot": "delta-text",
+        className: tone,
+        style: tone ? void 0 : MUTED,
+        "aria-label": t.label(word, text, good),
+        children: [
+          mark,
+          " ",
+          text
+        ]
+      }
+    )
+  ] });
+}
+
+export { DeltaText };
+//# sourceMappingURL=chunk-TRMHNMMZ.js.map
+//# sourceMappingURL=chunk-TRMHNMMZ.js.map

package/dist/chunk-TRMHNMMZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../squadkit/registry/blocks/delta-text/delta-text.tsx"],"names":[],"mappings":";;;;;AAgCA,IAAM,KAAA,GAAQ,EAAE,KAAA,EAAO,kBAAA,EAAmB;AAE1C,IAAM,IAAA,GAAO;AAAA,EACX,EAAA,EAAI;AAAA,IACF,EAAA,EAAI,QAAA;AAAA,IACJ,IAAA,EAAM,QAAA;AAAA,IACN,IAAA,EAAM,oBAAA;AAAA,IACN,KAAA,EAAO,CAAC,IAAA,EAAc,IAAA,EAAc,SAClC,CAAA,EAAG,IAAI,CAAA,MAAA,EAAI,IAAI,GAAG,IAAA,KAAS,MAAA,GAAY,EAAA,GAAK,IAAA,GAAO,uBAAQ,oBAAK,CAAA;AAAA,GACpE;AAAA,EACA,EAAA,EAAI;AAAA,IACF,EAAA,EAAI,IAAA;AAAA,IACJ,IAAA,EAAM,MAAA;AAAA,IACN,IAAA,EAAM,MAAA;AAAA,IACN,KAAA,EAAO,CAAC,IAAA,EAAc,IAAA,EAAc,SAClC,CAAA,EAAG,IAAI,CAAA,EAAA,EAAK,IAAI,GAAG,IAAA,KAAS,MAAA,GAAY,EAAA,GAAK,IAAA,GAAO,eAAe,YAAY,CAAA;AAAA;AAErF,CAAA;AAEO,SAAS,SAAA,CAAU,EAAE,KAAA,EAAO,MAAA,EAAQ,aAAa,IAAA,EAAM,eAAA,EAAiB,MAAA,EAAQ,UAAA,EAAW,EAAmB;AACnH,EAAA,MAAM,MAAA,GAAS,UAAU,UAAU,CAAA;AACnC,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,UAAA,CAAW,MAAM,CAAC,CAAA;AACjC,EAAA,MAAM,KAAA,GAAQ,eAAA,mBAAkB,IAAA,CAAC,MAAA,EAAA,EAAK,OAAO,KAAA,EAAQ,QAAA,EAAA;AAAA,IAAA,eAAA;AAAA,IAAgB;AAAA,GAAA,EAAC,CAAA,GAAU,IAAA;AAChF,EAAA,IAAI,UAAU,IAAA,EAAM;AAClB,IAAA,uBACE,IAAA,CAAA,QAAA,EAAA,EACG,QAAA,EAAA;AAAA,MAAA,KAAA;AAAA,0BACA,MAAA,EAAA,EAAK,WAAA,EAAU,YAAA,EAAa,KAAA,EAAO,OAAO,QAAA,EAAA,QAAA,EAE3C;AAAA,KAAA,EACF,CAAA;AAAA,EAEJ;AACA,EAAA,MAAM,MAAM,KAAA,GAAQ,CAAA,GAAI,IAAA,GAAO,KAAA,GAAQ,IAAI,MAAA,GAAS,MAAA;AACpD,EAAA,MAAM,OAAO,GAAA,KAAQ,IAAA,GAAO,QAAA,GAAM,GAAA,KAAQ,SAAS,QAAA,GAAM,QAAA;AACzD,EAAA,MAAM,IAAA,GAAO,EAAE,GAAG,CAAA;AAClB,EAAA,MAAM,OAAO,GAAA,KAAQ,MAAA,GAAS,MAAA,GAAa,GAAA,KAAQ,UAAW,UAAA,KAAe,IAAA,CAAA;AAC7E,EAAA,MAAM,IAAA,GAAO,IAAA,KAAS,MAAA,GAAY,MAAA,GAAY,OAAO,eAAA,GAAkB,eAAA;AACvE,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,KAAA,EAAO,MAAA,EAAQ,MAAM,CAAA;AAC9C,EAAA,uBACE,IAAA,CAAA,QAAA,EAAA,EACG,QAAA,EAAA;AAAA,IAAA,KAAA;AAAA,oBACD,IAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,WAAA,EAAU,YAAA;AAAA,QACV,SAAA,EAAW,IAAA;AAAA,QACX,KAAA,EAAO,OAAO,MAAA,GAAY,KAAA;AAAA,QAC1B,YAAA,EAAY,CAAA,CAAE,KAAA,CAAM,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,QAEnC,QAAA,EAAA;AAAA,UAAA,IAAA;AAAA,UAAK,GAAA;AAAA,UAAE;AAAA;AAAA;AAAA;AACV,GAAA,EACF,CAAA;AAEJ","file":"chunk-TRMHNMMZ.js","sourcesContent":["\"use client\"\n\n/**\n * delta-text — a change as a bare inline `span`: mark + signed value (\"▲ +3.2%\"), so print and\n * colour-blind readers get the direction; colour only adds good / bad. It sets no text size, so it\n * takes the size of the line it sits in (doc blocks, slide text).\n *\n * - The direction comes from the sign of `value`; `betterWhen` (\"up\" by default; `\"down\"` for churn,\n *   cost) decides good / bad. Zero is \"→\" in the muted colour; `null` is \"—\".\n * - `value` is the change itself, formatted by `format` with an explicit sign.\n * - `comparisonLabel` (\"前月比\") is printed in front, muted.\n *\n * @example\n * import { DeltaText } from \"@/blocks/delta-text/delta-text\"\n * <DeltaText value={0.032} format=\"percent\" comparisonLabel=\"前月比\" />\n */\nimport { useLocale } from \"../../hooks/use-locale\"\nimport { formatDelta, type ValueFormat } from \"../../lib/format\"\nimport { uiLanguage } from \"../../lib/locale\"\n\nexport interface DeltaTextProps {\n  /** The change itself; its direction comes from the sign. `null` shows \"—\". */\n  value: number | null\n  format?: ValueFormat\n  /** Which way is good. Default `\"up\"`. */\n  betterWhen?: \"up\" | \"down\"\n  /** Name of the comparison, e.g. \"前月比\". Printed before the change; omit to print only the change. */\n  comparisonLabel?: string\n  /** Locale of the value and the screen-reader text. Default the page's (`<html lang>`). */\n  locale?: string\n}\n\nconst MUTED = { color: \"var(--doc-muted)\" } as const\n\nconst TEXT = {\n  ja: {\n    up: \"増\",\n    down: \"減\",\n    flat: \"横ばい\",\n    label: (word: string, text: string, good: boolean | undefined) =>\n      `${word}、${text}${good === undefined ? \"\" : good ? \"、改善\" : \"、悪化\"}`,\n  },\n  en: {\n    up: \"Up\",\n    down: \"Down\",\n    flat: \"Flat\",\n    label: (word: string, text: string, good: boolean | undefined) =>\n      `${word}, ${text}${good === undefined ? \"\" : good ? \", improved\" : \", worsened\"}`,\n  },\n}\n\nexport function DeltaText({ value, format, betterWhen = \"up\", comparisonLabel, locale: localeProp }: DeltaTextProps) {\n  const locale = useLocale(localeProp)\n  const t = TEXT[uiLanguage(locale)]\n  const label = comparisonLabel ? <span style={MUTED}>{comparisonLabel} </span> : null\n  if (value === null) {\n    return (\n      <>\n        {label}\n        <span data-slot=\"delta-text\" style={MUTED}>\n          —\n        </span>\n      </>\n    )\n  }\n  const dir = value > 0 ? \"up\" : value < 0 ? \"down\" : \"flat\"\n  const mark = dir === \"up\" ? \"▲\" : dir === \"down\" ? \"▼\" : \"→\"\n  const word = t[dir]\n  const good = dir === \"flat\" ? undefined : (dir === \"up\") === (betterWhen === \"up\")\n  const tone = good === undefined ? undefined : good ? \"text-positive\" : \"text-negative\"\n  const text = formatDelta(value, format, locale)\n  return (\n    <>\n      {label}\n      <span\n        data-slot=\"delta-text\"\n        className={tone}\n        style={tone ? undefined : MUTED}\n        aria-label={t.label(word, text, good)}\n      >\n        {mark} {text}\n      </span>\n    </>\n  )\n}\n\nexport default DeltaText\n"]}

package/dist/{chunk-A2UUGASH.js → chunk-U736PVHY.js}

@@ -8,5 +8,5 @@ function cn(...inputs) {
 }
 
 export { cn };
-//# sourceMappingURL=chunk-A2UUGASH.js.map
-//# sourceMappingURL=chunk-A2UUGASH.js.map
+//# sourceMappingURL=chunk-U736PVHY.js.map
+//# sourceMappingURL=chunk-U736PVHY.js.map

package/dist/chunk-U736PVHY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../squadkit/registry/lib/utils.ts"],"names":[],"mappings":";;;;;AAUO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"chunk-U736PVHY.js","sourcesContent":["/**\n * Class merger used by every component in the kit. `clsx` resolves conditional\n * class values, `tailwind-merge` drops the earlier of two conflicting Tailwind\n * utilities so a caller's `className` always wins over a component default.\n */\nimport { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport type { ClassValue }\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs))\n}\n"]}

package/dist/{chunk-JKLLFVEU.js → chunk-UWSQUHX6.js}

@@ -1,103 +1,8 @@
-import { filePageMeta, extractPageMeta } from './chunk-CEXAQQ5W.js';
+import { filePageMeta, extractPageMeta, stripComments, readBracketBody, splitTopLevel } from './chunk-S5MDTHH7.js';
 import { API_METHODS } from './chunk-C2CX6GLX.js';
 import fs from 'fs';
 
 // @squadbase/vantage — generated build. Do not edit.
-
-// src/core/source.ts
-function stripComments(src) {
-  return src.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:"'`\\])\/\/[^\n]*/g, "$1");
-}
-var OPENERS = { "(": ")", "[": "]", "{": "}" };
-function readBracketBody(src, openIndex) {
-  const open = src[openIndex];
-  if (!open || !OPENERS[open]) return null;
-  let depth = 0;
-  let quote = null;
-  for (let i = openIndex; i < src.length; i++) {
-    const c = src[i];
-    if (quote) {
-      if (c === "\\") i++;
-      else if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      quote = c;
-      continue;
-    }
-    if (OPENERS[c]) depth++;
-    else if (c === ")" || c === "]" || c === "}") {
-      if (--depth === 0) return src.slice(openIndex + 1, i);
-    }
-  }
-  return null;
-}
-function splitTopLevel(body) {
-  const parts = [];
-  let depth = 0;
-  let quote = null;
-  let start = 0;
-  for (let i = 0; i < body.length; i++) {
-    const c = body[i];
-    if (quote) {
-      if (c === "\\") i++;
-      else if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      quote = c;
-      continue;
-    }
-    if (OPENERS[c]) depth++;
-    else if (c === ")" || c === "]" || c === "}") depth--;
-    else if (c === "," && depth === 0) {
-      parts.push(body.slice(start, i));
-      start = i + 1;
-    }
-  }
-  parts.push(body.slice(start));
-  return parts.map((p) => p.trim()).filter(Boolean);
-}
-function maskSource(src) {
-  const out = src.split("");
-  const inString = new Uint8Array(src.length);
-  let i = 0;
-  while (i < src.length) {
-    const c = src[i];
-    const next = src[i + 1];
-    if (c === "/" && next === "/" && src[i - 1] !== ":") {
-      while (i < src.length && src[i] !== "\n") out[i++] = " ";
-      continue;
-    }
-    if (c === "/" && next === "*") {
-      const end = src.indexOf("*/", i + 2);
-      const stop = end === -1 ? src.length : end + 2;
-      for (; i < stop; i++) if (src[i] !== "\n") out[i] = " ";
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      i++;
-      while (i < src.length) {
-        const d = src[i];
-        if (d === "\\") {
-          inString[i] = 1;
-          inString[i + 1] = 1;
-          i += 2;
-          continue;
-        }
-        if (d === c) break;
-        if (d === "\n" && c !== "`") break;
-        inString[i++] = 1;
-      }
-      i++;
-      continue;
-    }
-    i++;
-  }
-  return { code: out.join(""), inString };
-}
-
-// src/core/route-spec.ts
 function detectApiMethods(src) {
   return API_METHODS.filter(
     (m) => new RegExp(`export\\s+(async\\s+)?(function|const|let|var)\\s+${m}\\b`).test(src) || new RegExp(`export\\s*\\{[^}]*\\b${m}\\b[^}]*\\}`).test(src)
@@ -236,6 +141,6 @@ function extractApiSpec(api) {
   return { params, methods };
 }
 
-export { detectApiMethods, extractApiSpec, extractPageSpec, maskSource, stripComments };
-//# sourceMappingURL=chunk-JKLLFVEU.js.map
-//# sourceMappingURL=chunk-JKLLFVEU.js.map
+export { detectApiMethods, extractApiSpec, extractPageSpec };
+//# sourceMappingURL=chunk-UWSQUHX6.js.map
+//# sourceMappingURL=chunk-UWSQUHX6.js.map

package/dist/chunk-UWSQUHX6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/route-spec.ts"],"names":[],"mappings":"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","file":"chunk-UWSQUHX6.js","sourcesContent":["import fs from \"node:fs\"\nimport { API_METHODS, type ApiMethod } from \"./constants\"\nimport { filePageMeta } from \"./file-page\"\nimport { extractPageMeta } from \"./route-tree\"\nimport { readBracketBody, splitTopLevel, stripComments } from \"./source\"\nimport type { ApiRoute, PageRoute, Segment } from \"./types\"\n\n/**\n * Best-effort *static* specs for the routes `vantage routes --detail` prints:\n * what a page takes in its path, and what an API route accepts and answers\n * with. Like `diagnostics.ts` this only reads text — user modules are never\n * imported or executed — so every field is a hint derived from the source, not\n * a guarantee. Callers pass sources through {@link stripComments} first.\n */\n\n/** A dynamic segment of a route path. */\nexport interface RouteParam {\n  name: string\n  kind: \"param\" | \"catchall\"\n}\n\n/** Static spec of a page route. */\nexport interface PageSpec {\n  params: RouteParam[]\n  title?: string\n  description?: string\n  navLabel?: string\n}\n\n/** The request body an API handler reads, when detectable. */\nexport interface ApiBodySpec {\n  format: \"json\" | \"formData\" | \"text\" | \"binary\"\n  /** Top-level keys, when the handler destructures them. */\n  keys?: string[]\n}\n\n/** A response an API handler returns. */\nexport interface ApiResponseSpec {\n  status: number\n  /** Response content type, omitted when it can't be derived. */\n  contentType?: string\n  /** Top-level keys, when the payload is an object literal. */\n  keys?: string[]\n}\n\n/** An `HttpError` an API handler throws. */\nexport interface ApiErrorSpec {\n  status: number\n  message?: string\n}\n\n/** Static spec of one HTTP method handler. */\nexport interface ApiMethodSpec {\n  method: ApiMethod\n  /** Query string keys read via `searchParams`. */\n  query: string[]\n  body?: ApiBodySpec\n  responses: ApiResponseSpec[]\n  errors: ApiErrorSpec[]\n}\n\n/** Static spec of an API route module. */\nexport interface ApiSpec {\n  params: RouteParam[]\n  methods: ApiMethodSpec[]\n}\n\n/**\n * HTTP method handlers a module exports (direct declaration or export list).\n * `src` must be comment-stripped. Shared with the `INVALID_API_EXPORT`\n * diagnostic so both agree on what counts as a handler.\n */\nexport function detectApiMethods(src: string): ApiMethod[] {\n  return API_METHODS.filter(\n    (m) =>\n      new RegExp(`export\\\\s+(async\\\\s+)?(function|const|let|var)\\\\s+${m}\\\\b`).test(src) ||\n      new RegExp(`export\\\\s*\\\\{[^}]*\\\\b${m}\\\\b[^}]*\\\\}`).test(src),\n  )\n}\n\n/**\n * Slice the module into one source region per handler: from a handler's export\n * declaration to the next one (or EOF). Coarse on purpose — matching a function\n * body would have to cope with arrow bodies, overloads and trailing helpers —\n * and good enough because handlers are written one after another. A method\n * exported only through an export list gets the whole module as its region.\n */\nfunction methodRegions(src: string): Map<ApiMethod, string> {\n  const re = new RegExp(\n    `export\\\\s+(?:async\\\\s+)?(?:function|const|let|var)\\\\s+(${API_METHODS.join(\"|\")})\\\\b`,\n    \"g\",\n  )\n  const decls: { method: ApiMethod; index: number }[] = []\n  let m: RegExpExecArray | null\n  while ((m = re.exec(src))) decls.push({ method: m[1] as ApiMethod, index: m.index })\n\n  const regions = new Map<ApiMethod, string>()\n  decls.forEach((d, i) => {\n    regions.set(d.method, src.slice(d.index, decls[i + 1]?.index ?? src.length))\n  })\n  for (const method of detectApiMethods(src)) {\n    if (!regions.has(method)) regions.set(method, src)\n  }\n  return regions\n}\n\n/** Top-level keys of an object literal expression, `…` standing in for spreads. */\nfunction objectKeys(expr: string): string[] | undefined {\n  const trimmed = expr.trim()\n  if (!trimmed.startsWith(\"{\")) return undefined\n  const body = readBracketBody(trimmed, 0)\n  if (body == null) return undefined\n  const keys: string[] = []\n  for (const part of splitTopLevel(body)) {\n    if (part.startsWith(\"...\")) {\n      keys.push(\"…\")\n      continue\n    }\n    const name = part.match(/^[\"'`]?([A-Za-z0-9_$]+)/)\n    if (name) keys.push(name[1]!)\n  }\n  return keys.length ? keys : undefined\n}\n\n/** Read `status: 201` out of a `ResponseInit` literal. */\nfunction initStatus(init: string | undefined): number | undefined {\n  const m = init?.match(/\\bstatus\\s*:\\s*(\\d{3})\\b/)\n  return m ? Number(m[1]) : undefined\n}\n\n/** Read a content-type header out of a `ResponseInit` literal. */\nfunction initContentType(init: string | undefined): string | undefined {\n  const m = init?.match(/[\"']?content-type[\"']?\\s*:\\s*[\"']([^\"';]+)/i)\n  return m ? m[1]!.trim() : undefined\n}\n\n/** Every `Response.json(…)` / `json(…)` / `new Response(…)` in a handler region. */\nfunction extractResponses(region: string): ApiResponseSpec[] {\n  const re = /\\bnew\\s+Response\\s*\\(|\\bResponse\\s*\\.\\s*json\\s*\\(|(?<![.\\w$])json\\s*\\(/g\n  const out: ApiResponseSpec[] = []\n  const seen = new Set<string>()\n  let m: RegExpExecArray | null\n  while ((m = re.exec(region))) {\n    const isJson = !m[0].startsWith(\"new\")\n    const args = readBracketBody(region, m.index + m[0].length - 1)\n    if (args == null) continue\n    const [payload, init] = splitTopLevel(args)\n    const contentType = isJson\n      ? \"application/json\"\n      : (initContentType(init) ??\n        (payload?.startsWith(\"JSON.stringify\") ? \"application/json\" : undefined))\n    const keys = isJson && payload ? objectKeys(payload) : undefined\n    const spec: ApiResponseSpec = {\n      status: initStatus(init) ?? 200,\n      ...(contentType ? { contentType } : {}),\n      ...(keys ? { keys } : {}),\n    }\n    const key = JSON.stringify(spec)\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(spec)\n  }\n  return out\n}\n\n/** Every `new HttpError(status, \"message\")` in a handler region. */\nfunction extractErrors(region: string): ApiErrorSpec[] {\n  const re = /\\bHttpError\\s*\\(\\s*(\\d{3})\\s*(?:,\\s*(?:([\"'`])((?:\\\\.|(?!\\2)[\\s\\S])*)\\2))?/g\n  const out: ApiErrorSpec[] = []\n  const seen = new Set<string>()\n  let m: RegExpExecArray | null\n  while ((m = re.exec(region))) {\n    const message = m[3]?.replace(/\\\\(.)/g, \"$1\")\n    const spec: ApiErrorSpec = { status: Number(m[1]), ...(message ? { message } : {}) }\n    const key = JSON.stringify(spec)\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(spec)\n  }\n  return out\n}\n\n/** Query keys read through `searchParams.get/getAll/has(\"x\")`. */\nfunction extractQuery(region: string): string[] {\n  const re = /searchParams\\s*\\.\\s*(?:get|getAll|has)\\s*\\(\\s*[\"'`]([^\"'`]+)[\"'`]/g\n  const out = new Set<string>()\n  let m: RegExpExecArray | null\n  while ((m = re.exec(region))) out.add(m[1]!)\n  return [...out]\n}\n\n/** The request body a handler reads, plus destructured keys when present. */\nfunction extractBody(region: string): ApiBodySpec | undefined {\n  const read = region.match(/\\b(?:request|req)\\s*\\.\\s*(json|formData|text|arrayBuffer|blob)\\s*\\(/)\n  if (!read) return undefined\n  const method = read[1]!\n  const format: ApiBodySpec[\"format\"] =\n    method === \"json\" || method === \"formData\" || method === \"text\" ? method : \"binary\"\n\n  const destructured = region.match(\n    /(?:const|let|var)\\s*(\\{[\\s\\S]*?\\})\\s*=\\s*(?:await\\s+)?[\\w.]*\\.json\\s*\\(/,\n  )\n  const keys = format === \"json\" && destructured ? objectKeys(destructured[1]!) : undefined\n  return { format, ...(keys ? { keys } : {}) }\n}\n\nfunction toParams(segments: Segment[]): RouteParam[] {\n  const out: RouteParam[] = []\n  for (const s of segments) {\n    if (s.kind === \"static\") continue\n    out.push({ name: s.name, kind: s.kind })\n  }\n  return out\n}\n\n/** Static spec of a page: its path params and its `definePage` metadata. */\nexport function extractPageSpec(page: PageRoute): PageSpec {\n  // A data file has no `definePage` to read, and reading it as UTF-8 would\n  // decode megabytes of spreadsheet binary; its title is derived from the name.\n  const meta = page.kind === \"file\" ? filePageMeta(page) : extractPageMeta(page.absFile)\n  return { params: toParams(page.segments), ...meta }\n}\n\n/** Static spec of an API route: path params and a per-method request/response sketch. */\nexport function extractApiSpec(api: ApiRoute): ApiSpec {\n  const params = toParams(api.segments)\n  let src: string\n  try {\n    src = stripComments(fs.readFileSync(api.absFile, \"utf8\"))\n  } catch {\n    return { params, methods: [] }\n  }\n  const regions = methodRegions(src)\n  const methods = API_METHODS.filter((m) => regions.has(m)).map((method) => {\n    const region = regions.get(method)!\n    const body = extractBody(region)\n    return {\n      method,\n      query: extractQuery(region),\n      ...(body ? { body } : {}),\n      responses: extractResponses(region),\n      errors: extractErrors(region),\n    }\n  })\n  return { params, methods }\n}\n"]}

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { parseArgs, frameworkVersion, resolveQuickRoot, log, resolveRoot } from './chunk-QI3XQKHS.js';
+import { parseArgs, frameworkVersion, resolveQuickRoot, log, resolveRoot } from './chunk-GNXCX4WE.js';
 import './chunk-C2CX6GLX.js';
 import path from 'path';
 import pc from 'picocolors';
@@ -34,6 +34,7 @@ ${pc.bold("Options")}
   --allowed-hosts <h> Hostnames to serve behind a reverse proxy: a,b or true (dev/preview)
                       (env: VANTAGE_ALLOWED_HOSTS; the flag wins)
   --no-overlay        Hide the full-screen HMR error overlay (dev)
+  --draft-preview     Accept unfinished files at POST /__vantage_draft (dev; env: VANTAGE_DRAFT_PREVIEW=1)
   --root <dir>        Project root (default: cwd)
   --force             Overwrite when scaffolding
   --pages             Show only page routes (routes)
@@ -49,16 +50,16 @@ ${pc.bold("Options")}
   -h, --help          Print this help
 `;
 var COMMANDS = {
-  dev: () => import('./dev-GDKATCC7.js').then((m) => m.dev),
-  build: () => import('./build-TVKFIVFQ.js').then((m) => m.build),
-  preview: () => import('./preview-OGMCNQUO.js').then((m) => m.preview),
-  check: () => import('./check-3KHZXZMQ.js').then((m) => m.check),
-  routes: () => import('./routes-MWBWWOJ2.js').then((m) => m.routes),
-  add: () => import('./add-DY4AXANK.js').then((m) => m.add),
-  docs: () => import('./docs-EJJ3BECT.js').then((m) => m.docs),
-  search: () => import('./search-6Y422SV6.js').then((m) => m.search),
-  doctor: () => import('./doctor-WQXPXP6K.js').then((m) => m.doctor),
-  upgrade: () => import('./upgrade-HCANX4GQ.js').then((m) => m.upgrade)
+  dev: () => import('./dev-O42JFQ64.js').then((m) => m.dev),
+  build: () => import('./build-U7GO26HR.js').then((m) => m.build),
+  preview: () => import('./preview-T6CLSQVX.js').then((m) => m.preview),
+  check: () => import('./check-MRVAIHG5.js').then((m) => m.check),
+  routes: () => import('./routes-PVKNT777.js').then((m) => m.routes),
+  add: () => import('./add-4GHF2TX2.js').then((m) => m.add),
+  docs: () => import('./docs-JVP4RPKT.js').then((m) => m.docs),
+  search: () => import('./search-5LC4XPB5.js').then((m) => m.search),
+  doctor: () => import('./doctor-YD3XAAOT.js').then((m) => m.doctor),
+  upgrade: () => import('./upgrade-6DT7ADRP.js').then((m) => m.upgrade)
 };
 var NO_ROOT_POSITIONAL = /* @__PURE__ */ new Set(["add", "docs", "search"]);
 async function main() {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["#!/usr/bin/env node\nimport path from \"node:path\"\nimport pc from \"picocolors\"\nimport {\n  frameworkVersion,\n  log,\n  parseArgs,\n  resolveQuickRoot,\n  resolveRoot,\n  type ParsedArgs,\n} from \"./cli/util\"\n\nconst HELP = `${pc.bold(pc.magenta(\"vantage\"))} — data dashboard framework for Squadbase\n\n${pc.bold(\"Usage\")}\n  vantage <command> [path] [options]\n  vantage <path>                     Quick dev shortcut (folder or entry file)\n\n${pc.bold(\"Commands\")}\n  dev                 Start the dev server (HMR + optional API)\n  build               Build client and optional server into dist/\n  preview             Run the production build locally\n  check               Static verification (routes, boundaries, forbidden files)\n  routes              Show page and API URL map (--pages | --apis | --detail)\n  add <kind> <name>   Scaffold a page | api | ui | block | skill | agents\n                      (add skill with no name lists the skills and where they sit;\n                      add agents places AGENTS.md + agents/*.md)\n  docs [name]         Show the bundled guide and component reference\n  search <query>      Find components and docs by meaning, or by regex\n  doctor              Environment and installation health checks\n  upgrade             Regenerate artifacts, sync AGENTS.md + agents/ / apply migrations\n\n${pc.bold(\"Options\")}\n  --json              Machine-readable output (check, routes, doctor, build, docs, search)\n  --port <n>          Port for dev/preview — exact: fails when it is taken\n  --strict-port       Require the default port too (dev/preview)\n  --no-strict-port    Let --port fall through to the next free port\n  --host [addr]       Listen on every interface, or only on <addr> (dev/preview)\n  --allowed-hosts <h> Hostnames to serve behind a reverse proxy: a,b or true (dev/preview)\n                      (env: VANTAGE_ALLOWED_HOSTS; the flag wins)\n  --no-overlay        Hide the full-screen HMR error overlay (dev)\n  --root <dir>        Project root (default: cwd)\n  --force             Overwrite when scaffolding\n  --pages             Show only page routes (routes)\n  --apis              Show only API routes (routes)\n  --detail            Add each route's static spec (routes)\n  --list              List pages without showing one (docs)\n  --lang <ja|en>      Documentation language (docs, search, default: ja)\n  --regex             Treat the query as a regular expression (search)\n  --limit <n>         Max results (search, default: 10)\n  --all               Add every bundled skill (add skill --all) | show every page (docs)\n  --dir <path>        Where to place skills when none is found (add skill, default: project root)\n  -v, --version       Print version\n  -h, --help          Print this help\n`\n\ntype Command = (root: string, args: ParsedArgs) => Promise<number>\n\n/**\n * Commands are loaded on demand, never statically. A static import graph would\n * pull Vite and the Tailwind plugin into *every* invocation — ~165ms of module\n * loading that `check`, `routes`, `docs`, `search` and `add` never use (and\n * that even `--version` used to pay). Keep these as `import()` thunks: tsup's\n * code splitting then emits one chunk per command and the dispatcher stays\n * dependency-free.\n */\ntype CommandLoader = () => Promise<Command>\n\nconst COMMANDS: Record<string, CommandLoader> = {\n  dev: () => import(\"./cli/dev\").then((m) => m.dev),\n  build: () => import(\"./cli/build\").then((m) => m.build),\n  preview: () => import(\"./cli/preview\").then((m) => m.preview),\n  check: () => import(\"./cli/check\").then((m) => m.check),\n  routes: () => import(\"./cli/routes\").then((m) => m.routes),\n  add: () => import(\"./cli/add\").then((m) => m.add),\n  docs: () => import(\"./cli/docs\").then((m) => m.docs),\n  search: () => import(\"./cli/search\").then((m) => m.search),\n  doctor: () => import(\"./cli/doctor\").then((m) => m.doctor),\n  upgrade: () => import(\"./cli/upgrade\").then((m) => m.upgrade),\n}\n\n/**\n * Commands whose trailing positionals are their own arguments, not a project\n * root: `add` takes kind/name, `docs` a page name, `search` a query.\n */\nconst NO_ROOT_POSITIONAL = new Set([\"add\", \"docs\", \"search\"])\n\nasync function main(): Promise<void> {\n  const args = parseArgs(process.argv.slice(2))\n  const command = args.positionals[0]\n\n  if (args.flags.version || args.flags.v) {\n    console.log(frameworkVersion())\n    return\n  }\n  if (!command || args.flags.help || args.flags.h || command === \"help\") {\n    console.log(HELP)\n    return\n  }\n\n  let load = COMMANDS[command]\n  let root: string\n\n  if (load) {\n    // Known command. Every root-scoped command may take a trailing path\n    // positional as its root, except the ones that use positionals themselves.\n    const targetArg = !NO_ROOT_POSITIONAL.has(command) ? args.positionals[1] : undefined\n    if (targetArg !== undefined) {\n      const quick = resolveQuickRoot(targetArg)\n      if (!quick) {\n        log.error(`No such file or directory: \"${targetArg}\"`)\n        process.exitCode = 1\n        return\n      }\n      root = quick\n    } else {\n      root = resolveRoot(args.flags)\n    }\n  } else {\n    // Unknown first positional: if it's a path, quick-run dev on it; else error.\n    const quick = resolveQuickRoot(command)\n    if (!quick) {\n      log.error(`Unknown command \"${command}\".`)\n      console.log(HELP)\n      process.exitCode = 1\n      return\n    }\n    load = COMMANDS.dev!\n    root = quick\n    log.brand(`quick dev → ${path.relative(process.cwd(), root) || \".\"}`)\n  }\n\n  try {\n    const run = await load()\n    const code = await run(root, args)\n    process.exitCode = code\n  } catch (err) {\n    log.error(err instanceof Error ? err.message : String(err))\n    if (process.env.VANTAGE_DEBUG && err instanceof Error) console.error(err.stack)\n    process.exitCode = 1\n  }\n}\n\nvoid main()\n"]}
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;AAYA,IAAM,IAAA,GAAO,GAAG,EAAA,CAAG,IAAA,CAAK,GAAG,OAAA,CAAQ,SAAS,CAAC,CAAC,CAAA;;AAAA,EAE5C,EAAA,CAAG,IAAA,CAAK,OAAO,CAAC;AAAA;AAAA;;AAAA,EAIhB,EAAA,CAAG,IAAA,CAAK,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA,EAcnB,EAAA,CAAG,IAAA,CAAK,SAAS,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAqCpB,IAAM,QAAA,GAA0C;AAAA,EAC9C,GAAA,EAAK,MAAM,OAAO,mBAAW,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,GAAG,CAAA;AAAA,EAChD,KAAA,EAAO,MAAM,OAAO,qBAAa,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,KAAK,CAAA;AAAA,EACtD,OAAA,EAAS,MAAM,OAAO,uBAAe,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAA;AAAA,EAC5D,KAAA,EAAO,MAAM,OAAO,qBAAa,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,KAAK,CAAA;AAAA,EACtD,MAAA,EAAQ,MAAM,OAAO,sBAAc,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA;AAAA,EACzD,GAAA,EAAK,MAAM,OAAO,mBAAW,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,GAAG,CAAA;AAAA,EAChD,IAAA,EAAM,MAAM,OAAO,oBAAY,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAA;AAAA,EACnD,MAAA,EAAQ,MAAM,OAAO,sBAAc,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA;AAAA,EACzD,MAAA,EAAQ,MAAM,OAAO,sBAAc,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAA;AAAA,EACzD,OAAA,EAAS,MAAM,OAAO,uBAAe,EAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO;AAC9D,CAAA;AAMA,IAAM,qCAAqB,IAAI,GAAA,CAAI,CAAC,KAAA,EAAO,MAAA,EAAQ,QAAQ,CAAC,CAAA;AAE5D,eAAe,IAAA,GAAsB;AACnC,EAAA,MAAM,OAAO,SAAA,CAAU,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AAC5C,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA;AAElC,EAAA,IAAI,IAAA,CAAK,KAAA,CAAM,OAAA,IAAW,IAAA,CAAK,MAAM,CAAA,EAAG;AACtC,IAAA,OAAA,CAAQ,GAAA,CAAI,kBAAkB,CAAA;AAC9B,IAAA;AAAA,EACF;AACA,EAAA,IAAI,CAAC,WAAW,IAAA,CAAK,KAAA,CAAM,QAAQ,IAAA,CAAK,KAAA,CAAM,CAAA,IAAK,OAAA,KAAY,MAAA,EAAQ;AACrE,IAAA,OAAA,CAAQ,IAAI,IAAI,CAAA;AAChB,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,GAAO,SAAS,OAAO,CAAA;AAC3B,EAAA,IAAI,IAAA;AAEJ,EAAA,IAAI,IAAA,EAAM;AAGR,IAAA,MAAM,SAAA,GAAY,CAAC,kBAAA,CAAmB,GAAA,CAAI,OAAO,CAAA,GAAI,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA,GAAI,MAAA;AAC3E,IAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,MAAA,MAAM,KAAA,GAAQ,iBAAiB,SAAS,CAAA;AACxC,MAAA,IAAI,CAAC,KAAA,EAAO;AACV,QAAA,GAAA,CAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,SAAS,CAAA,CAAA,CAAG,CAAA;AACrD,QAAA,OAAA,CAAQ,QAAA,GAAW,CAAA;AACnB,QAAA;AAAA,MACF;AACA,MAAA,IAAA,GAAO,KAAA;AAAA,IACT,CAAA,MAAO;AACL,MAAA,IAAA,GAAO,WAAA,CAAY,KAAK,KAAK,CAAA;AAAA,IAC/B;AAAA,EACF,CAAA,MAAO;AAEL,IAAA,MAAM,KAAA,GAAQ,iBAAiB,OAAO,CAAA;AACtC,IAAA,IAAI,CAAC,KAAA,EAAO;AACV,MAAA,GAAA,CAAI,KAAA,CAAM,CAAA,iBAAA,EAAoB,OAAO,CAAA,EAAA,CAAI,CAAA;AACzC,MAAA,OAAA,CAAQ,IAAI,IAAI,CAAA;AAChB,MAAA,OAAA,CAAQ,QAAA,GAAW,CAAA;AACnB,MAAA;AAAA,IACF;AACA,IAAA,IAAA,GAAO,QAAA,CAAS,GAAA;AAChB,IAAA,IAAA,GAAO,KAAA;AACP,IAAA,GAAA,CAAI,KAAA,CAAM,CAAA,iBAAA,EAAe,IAAA,CAAK,QAAA,CAAS,OAAA,CAAQ,KAAI,EAAG,IAAI,CAAA,IAAK,GAAG,CAAA,CAAE,CAAA;AAAA,EACtE;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,EAAK;AACvB,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAM,IAAI,CAAA;AACjC,IAAA,OAAA,CAAQ,QAAA,GAAW,IAAA;AAAA,EACrB,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,MAAM,GAAA,YAAe,KAAA,GAAQ,IAAI,OAAA,GAAU,MAAA,CAAO,GAAG,CAAC,CAAA;AAC1D,IAAA,IAAI,OAAA,CAAQ,IAAI,aAAA,IAAiB,GAAA,YAAe,OAAO,OAAA,CAAQ,KAAA,CAAM,IAAI,KAAK,CAAA;AAC9E,IAAA,OAAA,CAAQ,QAAA,GAAW,CAAA;AAAA,EACrB;AACF;AAEA,KAAK,IAAA,EAAK","file":"cli.js","sourcesContent":["#!/usr/bin/env node\nimport path from \"node:path\"\nimport pc from \"picocolors\"\nimport {\n  frameworkVersion,\n  log,\n  parseArgs,\n  resolveQuickRoot,\n  resolveRoot,\n  type ParsedArgs,\n} from \"./cli/util\"\n\nconst HELP = `${pc.bold(pc.magenta(\"vantage\"))} — data dashboard framework for Squadbase\n\n${pc.bold(\"Usage\")}\n  vantage <command> [path] [options]\n  vantage <path>                     Quick dev shortcut (folder or entry file)\n\n${pc.bold(\"Commands\")}\n  dev                 Start the dev server (HMR + optional API)\n  build               Build client and optional server into dist/\n  preview             Run the production build locally\n  check               Static verification (routes, boundaries, forbidden files)\n  routes              Show page and API URL map (--pages | --apis | --detail)\n  add <kind> <name>   Scaffold a page | api | ui | block | skill | agents\n                      (add skill with no name lists the skills and where they sit;\n                      add agents places AGENTS.md + agents/*.md)\n  docs [name]         Show the bundled guide and component reference\n  search <query>      Find components and docs by meaning, or by regex\n  doctor              Environment and installation health checks\n  upgrade             Regenerate artifacts, sync AGENTS.md + agents/ / apply migrations\n\n${pc.bold(\"Options\")}\n  --json              Machine-readable output (check, routes, doctor, build, docs, search)\n  --port <n>          Port for dev/preview — exact: fails when it is taken\n  --strict-port       Require the default port too (dev/preview)\n  --no-strict-port    Let --port fall through to the next free port\n  --host [addr]       Listen on every interface, or only on <addr> (dev/preview)\n  --allowed-hosts <h> Hostnames to serve behind a reverse proxy: a,b or true (dev/preview)\n                      (env: VANTAGE_ALLOWED_HOSTS; the flag wins)\n  --no-overlay        Hide the full-screen HMR error overlay (dev)\n  --draft-preview     Accept unfinished files at POST /__vantage_draft (dev; env: VANTAGE_DRAFT_PREVIEW=1)\n  --root <dir>        Project root (default: cwd)\n  --force             Overwrite when scaffolding\n  --pages             Show only page routes (routes)\n  --apis              Show only API routes (routes)\n  --detail            Add each route's static spec (routes)\n  --list              List pages without showing one (docs)\n  --lang <ja|en>      Documentation language (docs, search, default: ja)\n  --regex             Treat the query as a regular expression (search)\n  --limit <n>         Max results (search, default: 10)\n  --all               Add every bundled skill (add skill --all) | show every page (docs)\n  --dir <path>        Where to place skills when none is found (add skill, default: project root)\n  -v, --version       Print version\n  -h, --help          Print this help\n`\n\ntype Command = (root: string, args: ParsedArgs) => Promise<number>\n\n/**\n * Commands are loaded on demand, never statically. A static import graph would\n * pull Vite and the Tailwind plugin into *every* invocation — ~165ms of module\n * loading that `check`, `routes`, `docs`, `search` and `add` never use (and\n * that even `--version` used to pay). Keep these as `import()` thunks: tsup's\n * code splitting then emits one chunk per command and the dispatcher stays\n * dependency-free.\n */\ntype CommandLoader = () => Promise<Command>\n\nconst COMMANDS: Record<string, CommandLoader> = {\n  dev: () => import(\"./cli/dev\").then((m) => m.dev),\n  build: () => import(\"./cli/build\").then((m) => m.build),\n  preview: () => import(\"./cli/preview\").then((m) => m.preview),\n  check: () => import(\"./cli/check\").then((m) => m.check),\n  routes: () => import(\"./cli/routes\").then((m) => m.routes),\n  add: () => import(\"./cli/add\").then((m) => m.add),\n  docs: () => import(\"./cli/docs\").then((m) => m.docs),\n  search: () => import(\"./cli/search\").then((m) => m.search),\n  doctor: () => import(\"./cli/doctor\").then((m) => m.doctor),\n  upgrade: () => import(\"./cli/upgrade\").then((m) => m.upgrade),\n}\n\n/**\n * Commands whose trailing positionals are their own arguments, not a project\n * root: `add` takes kind/name, `docs` a page name, `search` a query.\n */\nconst NO_ROOT_POSITIONAL = new Set([\"add\", \"docs\", \"search\"])\n\nasync function main(): Promise<void> {\n  const args = parseArgs(process.argv.slice(2))\n  const command = args.positionals[0]\n\n  if (args.flags.version || args.flags.v) {\n    console.log(frameworkVersion())\n    return\n  }\n  if (!command || args.flags.help || args.flags.h || command === \"help\") {\n    console.log(HELP)\n    return\n  }\n\n  let load = COMMANDS[command]\n  let root: string\n\n  if (load) {\n    // Known command. Every root-scoped command may take a trailing path\n    // positional as its root, except the ones that use positionals themselves.\n    const targetArg = !NO_ROOT_POSITIONAL.has(command) ? args.positionals[1] : undefined\n    if (targetArg !== undefined) {\n      const quick = resolveQuickRoot(targetArg)\n      if (!quick) {\n        log.error(`No such file or directory: \"${targetArg}\"`)\n        process.exitCode = 1\n        return\n      }\n      root = quick\n    } else {\n      root = resolveRoot(args.flags)\n    }\n  } else {\n    // Unknown first positional: if it's a path, quick-run dev on it; else error.\n    const quick = resolveQuickRoot(command)\n    if (!quick) {\n      log.error(`Unknown command \"${command}\".`)\n      console.log(HELP)\n      process.exitCode = 1\n      return\n    }\n    load = COMMANDS.dev!\n    root = quick\n    log.brand(`quick dev → ${path.relative(process.cwd(), root) || \".\"}`)\n  }\n\n  try {\n    const run = await load()\n    const code = await run(root, args)\n    process.exitCode = code\n  } catch (err) {\n    log.error(err instanceof Error ? err.message : String(err))\n    if (process.env.VANTAGE_DEBUG && err instanceof Error) console.error(err.stack)\n    process.exitCode = 1\n  }\n}\n\nvoid main()\n"]}

package/dist/client/index.d.ts

@@ -1,8 +1,28 @@
 import { a as ClientManifest } from '../manifest-DiOjyinq.js';
 export { C as ClientLayout, b as ClientPage, L as Loader, P as PageModule } from '../manifest-DiOjyinq.js';
-import 'react';
+import { ReactNode } from 'react';
 import '../define-page-BfhrK99G.js';
 
+/** The slice of Vite's HMR context the draft layer uses. */
+interface DraftHot {
+    on(event: string, cb: (data: any) => void): void;
+    send(event: string, data?: unknown): void;
+}
+
+interface BootstrapOptions {
+    /**
+     * The HMR context of the generated entry, passed only when the draft preview
+     * is on. Its presence is what switches the draft behaviour on; without it the
+     * client is exactly what it was.
+     */
+    hot?: DraftHot;
+}
+interface BootstrapHandle {
+    /** The route tree changed (a page appeared or went away): draw from the new manifest. */
+    update(manifest: ClientManifest): void;
+    /** A `server/api` module changed (dev): refetch the API queries, errored ones included. */
+    refreshApi(): void;
+}
 /**
  * Client entrypoint. The generated `.vantage/client-entry.tsx` calls this with
  * the route manifest. Owns React root creation and the provider tree:
@@ -10,7 +30,18 @@ import '../define-page-BfhrK99G.js';
  *   <AppErrorBoundary>
  *     <QueryClientProvider>
  *       <RouterProvider />
+ *
+ * With the draft preview on (`options.hot`) the router sits in a swappable
+ * holder inside a `DraftFreezeBoundary`, so a new route tree can replace it and
+ * a failing draft can keep the previous screen.
+ */
+declare function bootstrap(manifest: ClientManifest, options?: BootstrapOptions): BootstrapHandle;
+
+/**
+ * A frame with nothing in it, drawn where a part has not been written yet. Same
+ * look as the placeholder the draft layer declares for a missing component, so
+ * the two read as one thing on screen.
  */
-declare function bootstrap(manifest: ClientManifest): void;
+declare function DraftSkeleton(): ReactNode;
 
-export { ClientManifest, bootstrap };
+export { type BootstrapHandle, type BootstrapOptions, ClientManifest, DraftSkeleton, bootstrap };