@squadbase/vantage 0.6.2-dev1.3e69e88 → 0.6.2-dev1.42c4e48

package/dist/{chunk-KLEIVDUV.js → chunk-CEXAQQ5W.js}

@@ -4,6 +4,119 @@ import fs from 'fs';
 
 // @squadbase/vantage — generated build. Do not edit.
 
+// src/core/placeholder.ts
+var PLACEHOLDER_HOME_PAGE = `import { definePage } from "@squadbase/vantage"
+import {
+  DashboardCardPreset,
+  EChart,
+  PageShell,
+  PageShellContent,
+  PageShellDescription,
+  PageShellHeader,
+  PageShellHeading,
+  PageShellTitle,
+  Placeholder,
+  Sparkline,
+  type EChartsOption,
+} from "@squadbase/vantage/components"
+
+export const page = definePage({
+  title: "Dashboard",
+  description: "Sample data \u2014 replace with your own to get started.",
+  navLabel: "Home",
+})
+
+const METRICS = [
+  { label: "Metric 1", value: "1,234", trend: [3, 4, 3, 5, 6, 5, 7] },
+  { label: "Metric 2", value: "5,678", trend: [6, 5, 6, 4, 5, 6, 6] },
+  { label: "Metric 3", value: "90.1%", trend: [2, 3, 5, 4, 6, 7, 8] },
+  { label: "Metric 4", value: "$12.3k", trend: [5, 6, 4, 6, 5, 7, 6] },
+]
+
+// Sample charts. \`EChart\` paints series with \`--chart-1..5\` and the sparklines
+// use \`--primary\` (both from \`styles.css\`), so a theme change shows up here.
+const BAR_OPTION: EChartsOption = {
+  legend: { top: 0 },
+  grid: { top: 36, right: 8, bottom: 24, left: 36 },
+  xAxis: { type: "category", data: ["Jan", "Feb", "Mar", "Apr", "May", "Jun"] },
+  yAxis: { type: "value" },
+  series: [
+    { name: "Series A", type: "bar", data: [12, 18, 15, 22, 26, 24] },
+    { name: "Series B", type: "bar", data: [8, 11, 13, 12, 16, 19] },
+    { name: "Series C", type: "bar", data: [5, 7, 6, 9, 8, 11] },
+  ],
+}
+
+const PIE_OPTION: EChartsOption = {
+  legend: { bottom: 0 },
+  series: [
+    {
+      type: "pie",
+      radius: ["45%", "70%"],
+      center: ["50%", "45%"],
+      label: { show: false },
+      data: [
+        { name: "Category A", value: 35 },
+        { name: "Category B", value: 25 },
+        { name: "Category C", value: 18 },
+        { name: "Category D", value: 12 },
+        { name: "Category E", value: 10 },
+      ],
+    },
+  ],
+}
+
+const CHARTS = [
+  { title: "Chart 1", option: BAR_OPTION },
+  { title: "Chart 2", option: PIE_OPTION },
+]
+
+export default function HomePage() {
+  return (
+    <PageShell>
+      <PageShellHeader>
+        <PageShellHeading>
+          <PageShellTitle>Dashboard</PageShellTitle>
+          <PageShellDescription>
+            Sample data \u2014 replace with your own to get started.
+          </PageShellDescription>
+        </PageShellHeading>
+      </PageShellHeader>
+
+      <PageShellContent>
+        <section className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
+          {METRICS.map((metric) => (
+            <DashboardCardPreset key={metric.label} title={metric.label}>
+              <Placeholder className="text-2xl font-bold">{metric.value}</Placeholder>
+              <Sparkline
+                className="mt-2"
+                data={metric.trend.map((value) => ({ value }))}
+                color="text-primary"
+                area
+              />
+            </DashboardCardPreset>
+          ))}
+        </section>
+
+        <section className="grid grid-cols-1 gap-4 lg:grid-cols-2">
+          {CHARTS.map((chart) => (
+            <DashboardCardPreset key={chart.title} title={chart.title}>
+              <EChart option={chart.option} height={256} ariaLabel={chart.title} />
+            </DashboardCardPreset>
+          ))}
+        </section>
+      </PageShellContent>
+    </PageShell>
+  )
+}
+`;
+function isPlaceholderHomePage(content) {
+  if (/\bplaceholder\s*:\s*true\b/.test(content)) return true;
+  return content.trim() === PLACEHOLDER_HOME_PAGE.trim();
+}
+function isHomePagePath(file) {
+  return file === "index.tsx" || file === "src/index.tsx";
+}
 function humanize(stem) {
   return stem.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[-_\s]+/).filter(Boolean).map((word) => word === word.toUpperCase() ? word : word[0].toUpperCase() + word.slice(1)).join(" ");
 }
@@ -80,6 +193,7 @@ function parsePageMeta(src) {
   if (title) meta.title = title;
   if (description) meta.description = description;
   if (navLabel) meta.navLabel = navLabel;
+  if (/\bplaceholder\s*:\s*true\b/.test(args)) meta.placeholder = true;
   return meta;
 }
 function extractPageMeta(absFile) {
@@ -98,6 +212,11 @@ function extractPageMeta(absFile) {
     return {};
   }
   const meta = parsePageMeta(src);
+  const fileName = absFile.split(/[/\\]/).pop() ?? "";
+  const relPath = absFile.includes("/src/") ? `src/${fileName}` : fileName;
+  if (isHomePagePath(relPath) && isPlaceholderHomePage(src)) {
+    meta.placeholder = true;
+  }
   metaCache.set(absFile, { mtimeMs: stat.mtimeMs, size: stat.size, meta });
   return meta;
 }
@@ -137,29 +256,49 @@ function buildRouteTree(model) {
     const index = remaining.length === 0;
     const path2 = index ? "/" : remaining.map(segToRouter).join("/");
     const meta = page.kind === "file" ? filePageMeta(page) : extractPageMeta(page.absFile);
-    return {
+    const builtPage = {
       file: page.file,
       routePath: page.routePath,
       parentLayoutId: owner ? owner.id : null,
       path: path2,
       index,
-      ...meta.title ? { title: meta.title } : {},
-      ...meta.description ? { description: meta.description } : {},
-      ...meta.navLabel ? { navLabel: meta.navLabel } : {},
-      kind: page.kind,
-      ...page.fileExt ? { fileExt: page.fileExt } : {},
-      ...page.variant ? { variant: page.variant } : {}
+      kind: page.kind
     };
+    if (meta.title) builtPage.title = meta.title;
+    if (meta.description) builtPage.description = meta.description;
+    if (meta.navLabel) builtPage.navLabel = meta.navLabel;
+    if (page.fileExt) builtPage.fileExt = page.fileExt;
+    if (page.variant) builtPage.variant = page.variant;
+    if (meta.placeholder) builtPage.placeholder = meta.placeholder;
+    return builtPage;
   });
+  const byRoutePath = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const group = byRoutePath.get(page.routePath) ?? { placeholder: [], nonPlaceholder: [] };
+    if (page.placeholder) {
+      group.placeholder.push(page);
+    } else {
+      group.nonPlaceholder.push(page);
+    }
+    byRoutePath.set(page.routePath, group);
+  }
+  const filteredPages = [];
+  for (const group of byRoutePath.values()) {
+    if (group.nonPlaceholder.length > 0) {
+      filteredPages.push(...group.nonPlaceholder);
+    } else {
+      filteredPages.push(...group.placeholder);
+    }
+  }
   return {
     rootLayout: rootLayoutRoute ? rootLayoutRoute.file : null,
     notFound: model.notFound,
     error: model.error,
     layouts: built,
-    pages
+    pages: filteredPages
   };
 }
 
-export { buildRouteTree, extractPageMeta, filePageKind, filePageMeta, filePageModuleName };
-//# sourceMappingURL=chunk-KLEIVDUV.js.map
-//# sourceMappingURL=chunk-KLEIVDUV.js.map
+export { buildRouteTree, extractPageMeta, filePageKind, filePageMeta, filePageModuleName, isHomePagePath, isPlaceholderHomePage };
+//# sourceMappingURL=chunk-CEXAQQ5W.js.map
+//# sourceMappingURL=chunk-CEXAQQ5W.js.map

package/dist/chunk-CEXAQQ5W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/placeholder.ts","../src/core/file-page.ts","../src/core/route-tree.ts"],"names":["depth","path"],"mappings":"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","file":"chunk-CEXAQQ5W.js","sourcesContent":["/**\n * Detect whether a file is an untouched template placeholder.\n *\n * When a Vantage project is initialized from the template, it includes\n * a placeholder home page at `src/index.tsx` (or `index.tsx` at the root).\n * If that file remains completely untouched and a new artifact (e.g. a slide)\n * wants to claim route `/`, we allow it by treating the placeholder as yieldable\n * instead of reporting ROUTE_CONFLICT.\n */\n\n/**\n * Expected content of the template placeholder `src/index.tsx`.\n * This is the exact content from @squadbase/vantage-template 0.1.1.\n * When the template is updated, this constant must be updated as well.\n */\nconst PLACEHOLDER_HOME_PAGE = `import { definePage } from \"@squadbase/vantage\"\nimport {\n  DashboardCardPreset,\n  EChart,\n  PageShell,\n  PageShellContent,\n  PageShellDescription,\n  PageShellHeader,\n  PageShellHeading,\n  PageShellTitle,\n  Placeholder,\n  Sparkline,\n  type EChartsOption,\n} from \"@squadbase/vantage/components\"\n\nexport const page = definePage({\n  title: \"Dashboard\",\n  description: \"Sample data — replace with your own to get started.\",\n  navLabel: \"Home\",\n})\n\nconst METRICS = [\n  { label: \"Metric 1\", value: \"1,234\", trend: [3, 4, 3, 5, 6, 5, 7] },\n  { label: \"Metric 2\", value: \"5,678\", trend: [6, 5, 6, 4, 5, 6, 6] },\n  { label: \"Metric 3\", value: \"90.1%\", trend: [2, 3, 5, 4, 6, 7, 8] },\n  { label: \"Metric 4\", value: \"$12.3k\", trend: [5, 6, 4, 6, 5, 7, 6] },\n]\n\n// Sample charts. \\`EChart\\` paints series with \\`--chart-1..5\\` and the sparklines\n// use \\`--primary\\` (both from \\`styles.css\\`), so a theme change shows up here.\nconst BAR_OPTION: EChartsOption = {\n  legend: { top: 0 },\n  grid: { top: 36, right: 8, bottom: 24, left: 36 },\n  xAxis: { type: \"category\", data: [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\"] },\n  yAxis: { type: \"value\" },\n  series: [\n    { name: \"Series A\", type: \"bar\", data: [12, 18, 15, 22, 26, 24] },\n    { name: \"Series B\", type: \"bar\", data: [8, 11, 13, 12, 16, 19] },\n    { name: \"Series C\", type: \"bar\", data: [5, 7, 6, 9, 8, 11] },\n  ],\n}\n\nconst PIE_OPTION: EChartsOption = {\n  legend: { bottom: 0 },\n  series: [\n    {\n      type: \"pie\",\n      radius: [\"45%\", \"70%\"],\n      center: [\"50%\", \"45%\"],\n      label: { show: false },\n      data: [\n        { name: \"Category A\", value: 35 },\n        { name: \"Category B\", value: 25 },\n        { name: \"Category C\", value: 18 },\n        { name: \"Category D\", value: 12 },\n        { name: \"Category E\", value: 10 },\n      ],\n    },\n  ],\n}\n\nconst CHARTS = [\n  { title: \"Chart 1\", option: BAR_OPTION },\n  { title: \"Chart 2\", option: PIE_OPTION },\n]\n\nexport default function HomePage() {\n  return (\n    <PageShell>\n      <PageShellHeader>\n        <PageShellHeading>\n          <PageShellTitle>Dashboard</PageShellTitle>\n          <PageShellDescription>\n            Sample data — replace with your own to get started.\n          </PageShellDescription>\n        </PageShellHeading>\n      </PageShellHeader>\n\n      <PageShellContent>\n        <section className=\"grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4\">\n          {METRICS.map((metric) => (\n            <DashboardCardPreset key={metric.label} title={metric.label}>\n              <Placeholder className=\"text-2xl font-bold\">{metric.value}</Placeholder>\n              <Sparkline\n                className=\"mt-2\"\n                data={metric.trend.map((value) => ({ value }))}\n                color=\"text-primary\"\n                area\n              />\n            </DashboardCardPreset>\n          ))}\n        </section>\n\n        <section className=\"grid grid-cols-1 gap-4 lg:grid-cols-2\">\n          {CHARTS.map((chart) => (\n            <DashboardCardPreset key={chart.title} title={chart.title}>\n              <EChart option={chart.option} height={256} ariaLabel={chart.title} />\n            </DashboardCardPreset>\n          ))}\n        </section>\n      </PageShellContent>\n    </PageShell>\n  )\n}\n`\n\n/**\n * Check if a file content matches the template placeholder home page.\n * Returns true if the file is the exact untouched placeholder.\n * \n * This is a fallback for projects created from the older template (0.1.1-dev1.2be5c44)\n * before the explicit `placeholder: true` marker was added.\n */\nexport function isPlaceholderHomePage(content: string): boolean {\n  // First check for explicit placeholder marker\n  if (/\\bplaceholder\\s*:\\s*true\\b/.test(content)) return true\n  \n  // Fallback: exact content match for older templates\n  return content.trim() === PLACEHOLDER_HOME_PAGE.trim()\n}\n\n/**\n * Check if a file path is the home page (index.tsx at root or in src/).\n */\nexport function isHomePagePath(file: string): boolean {\n  return file === \"index.tsx\" || file === \"src/index.tsx\"\n}\n","/**\n * Everything the rest of the framework needs to know about a data-file page:\n * its title, the token the viewer switches on, and the name of the wrapper\n * module generated for it. One source of truth, the same way\n * `route-spec.ts`'s `detectApiMethods` is the one source for API methods —\n * `route-tree.ts` (metadata) and `generate.ts` (codegen) both read from here.\n */\nimport path from \"node:path\"\nimport { createHash } from \"node:crypto\"\n\n/** The parts of a file page each helper below needs. */\ninterface FileNamed {\n  /** Project-relative POSIX path. */\n  file: string\n}\ninterface FileTyped {\n  /** The data-file extension, e.g. `\".csv\"`. */\n  fileExt?: string\n}\n/** Metadata also needs the page-root-relative directory, which the URL uses. */\ntype FileMetaInput = FileNamed & FileTyped & { dir: string }\n\n/** The same shape `definePage` metadata takes, so callers can spread either. */\ninterface PageMeta {\n  title?: string\n  description?: string\n  navLabel?: string\n  placeholder?: boolean\n}\n\n/**\n * Turn a file stem into a title: `monthly_report-2024` -> \"Monthly Report\n * 2024\", `salesByRegion` -> \"Sales By Region\". All-caps tokens are left alone\n * (`KPI` stays `KPI`) because they are almost always acronyms.\n */\nexport function humanize(stem: string): string {\n  return stem\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .split(/[-_\\s]+/)\n    .filter(Boolean)\n    .map((word) => (word === word.toUpperCase() ? word : word[0]!.toUpperCase() + word.slice(1)))\n    .join(\" \")\n}\n\n/**\n * Title for a data-file page, derived from its name — a spreadsheet cannot\n * carry a `definePage`. `index.csv` borrows its directory's name (its own name\n * is not in the URL either); a root-level `index.csv` gets no title at all,\n * exactly like a root `index.tsx` without `definePage`.\n */\nexport function filePageMeta(page: FileMetaInput): PageMeta {\n  const base = path.posix.basename(page.file)\n  let stem = page.fileExt ? base.slice(0, -page.fileExt.length) : base\n  if (stem.toLowerCase() === \"index\") stem = page.dir.split(\"/\").filter(Boolean).pop() ?? \"\"\n  if (stem === \"\") return {}\n  return { title: humanize(stem) }\n}\n\n/** The token handed to the client viewer: `\".xlsx\"` -> `\"xlsx\"`. */\nexport function filePageKind(page: FileTyped): string {\n  return (page.fileExt ?? \"\").slice(1)\n}\n\n/**\n * Name of the wrapper module generated for a data-file page. Derived from the\n * source path so it is stable across runs (`writeIfChanged` stays a no-op) and\n * readable in a stack trace; the hash suffix keeps `a/b.csv` and `a-b.csv` from\n * colliding once slugified.\n */\nexport function filePageModuleName(page: FileNamed): string {\n  const slug = page.file\n    .replace(/[^A-Za-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .toLowerCase()\n  const hash = createHash(\"sha256\").update(page.file).digest(\"hex\").slice(0, 8)\n  return `${slug}-${hash}.tsx`\n}\n","import fs from \"node:fs\"\nimport type { FilePageExt, PageVariant } from \"./constants\"\nimport { filePageMeta } from \"./file-page\"\nimport { isHomePagePath, isPlaceholderHomePage } from \"./placeholder\"\nimport type { PageKind, RouteModel, Segment } from \"./types\"\n\n/** A layout route (path-bearing) in the built tree. */\nexport interface BuiltLayout {\n  id: string\n  dir: string\n  parentId: string | null\n  /** Router path relative to its parent (TanStack `$param` form). */\n  path: string\n  file: string\n}\n\n/** A page route in the built tree. */\nexport interface BuiltPage {\n  file: string\n  routePath: string\n  parentLayoutId: string | null\n  /** Router path relative to parent, or \"/\" for an index route. */\n  path: string\n  index: boolean\n  title?: string\n  description?: string\n  navLabel?: string\n  kind: PageKind\n  fileExt?: FilePageExt\n  variant?: PageVariant\n  placeholder?: boolean\n}\n\n/** The structured route tree emitted for the client runtime. */\nexport interface BuiltTree {\n  rootLayout: string | null\n  notFound: string | null\n  error: string | null\n  layouts: BuiltLayout[]\n  pages: BuiltPage[]\n}\n\nfunction segToRouter(s: Segment): string {\n  if (s.kind === \"static\") return s.value\n  if (s.kind === \"param\") return `$${s.name}`\n  return \"$\"\n}\n\n/** Convert a relative directory string (may contain `[param]`) to a router path. */\nfunction dirToRouterPath(relDir: string): string {\n  return relDir\n    .split(\"/\")\n    .filter(Boolean)\n    .map((token) => {\n      const catchall = token.match(/^\\[\\.\\.\\.(.+)\\]$/)\n      if (catchall) return \"$\"\n      const param = token.match(/^\\[(.+)\\]$/)\n      if (param) return `$${param[1]}`\n      return token\n    })\n    .join(\"/\")\n}\n\nfunction isAncestorDir(ancestor: string, dir: string): boolean {\n  if (ancestor === \"\") return true\n  return dir === ancestor || dir.startsWith(ancestor + \"/\")\n}\n\nfunction isStrictAncestorDir(ancestor: string, dir: string): boolean {\n  return dir.startsWith(ancestor + \"/\")\n}\n\nfunction depth(dir: string): number {\n  return dir === \"\" ? 0 : dir.split(\"/\").length\n}\n\n/**\n * Extract the argument object body of the first `definePage({ ... })` call\n * using balanced-brace scanning, so nested objects/functions (e.g.\n * `validateSearch: (s) => ({ ... })`) don't truncate the match. Returns null\n * when there is no definePage call — the caller then emits no metadata rather\n * than falling back to the whole file (which would match unrelated `title:`\n * keys in chart/option configs).\n */\nfunction extractDefinePageArgs(src: string): string | null {\n  const call = src.match(/\\bdefinePage\\s*\\(/)\n  if (!call) return null\n  let i = (call.index ?? 0) + call[0].length\n  while (i < src.length && /\\s/.test(src[i]!)) i++\n  if (src[i] !== \"{\") return null\n  const start = i\n  let depth = 0\n  for (; i < src.length; i++) {\n    const c = src[i]\n    if (c === \"{\") depth++\n    else if (c === \"}\" && --depth === 0) return src.slice(start + 1, i)\n  }\n  return null\n}\n\n/**\n * Match `key: \"...\"` allowing the value's own quote character to differ and\n * handling escapes, so values containing an apostrophe/quote are not truncated.\n */\nfunction matchStringField(scope: string, key: string): string | undefined {\n  const re = new RegExp(\n    `\\\\b${key}\\\\s*:\\\\s*(?:\"((?:\\\\\\\\.|[^\"\\\\\\\\])*)\"|'((?:\\\\\\\\.|[^'\\\\\\\\])*)'|\\`((?:\\\\\\\\.|[^\\`\\\\\\\\])*)\\`)`,\n  )\n  const m = scope.match(re)\n  if (!m) return undefined\n  return (m[1] ?? m[2] ?? m[3] ?? \"\").replace(/\\\\(.)/g, \"$1\")\n}\n\ninterface PageMeta {\n  title?: string\n  description?: string\n  navLabel?: string\n  placeholder?: boolean\n}\n\n/**\n * Cache keyed on mtime+size. A long-lived dev server regenerates the route tree\n * on every structural change, and re-reading + re-parsing every page module for\n * metadata that almost never changes is pure waste. `statSync` is an order of\n * magnitude cheaper than the read plus the brace scan it feeds.\n */\nconst metaCache = new Map<string, { mtimeMs: number; size: number; meta: PageMeta }>()\n\nfunction parsePageMeta(src: string): PageMeta {\n  const args = extractDefinePageArgs(src)\n  if (args == null) return {}\n  const meta: PageMeta = {}\n  const title = matchStringField(args, \"title\")\n  const description = matchStringField(args, \"description\")\n  const navLabel = matchStringField(args, \"navLabel\")\n  if (title) meta.title = title\n  if (description) meta.description = description\n  if (navLabel) meta.navLabel = navLabel\n  // Check for placeholder: true (boolean literal)\n  if (/\\bplaceholder\\s*:\\s*true\\b/.test(args)) meta.placeholder = true\n  return meta\n}\n\n/** Best-effort static extraction of definePage title/description/navLabel. */\nexport function extractPageMeta(absFile: string): PageMeta {\n  let stat: fs.Stats\n  try {\n    stat = fs.statSync(absFile)\n  } catch {\n    return {}\n  }\n  const hit = metaCache.get(absFile)\n  if (hit && hit.mtimeMs === stat.mtimeMs && hit.size === stat.size) return hit.meta\n\n  let src: string\n  try {\n    src = fs.readFileSync(absFile, \"utf8\")\n  } catch {\n    return {}\n  }\n  const meta = parsePageMeta(src)\n  \n  // Check for placeholder using the robust detection from placeholder.ts\n  // This includes both explicit marker and fallback exact match\n  const fileName = absFile.split(/[/\\\\]/).pop() ?? \"\"\n  const relPath = absFile.includes(\"/src/\") ? `src/${fileName}` : fileName\n  if (isHomePagePath(relPath) && isPlaceholderHomePage(src)) {\n    meta.placeholder = true\n  }\n  \n  metaCache.set(absFile, { mtimeMs: stat.mtimeMs, size: stat.size, meta })\n  return meta\n}\n\n/**\n * Build the structured route tree from a scan. Layouts become path-bearing\n * routes; pages attach to the deepest layout that owns their directory.\n */\nexport function buildRouteTree(model: RouteModel): BuiltTree {\n  const rootLayoutRoute = model.layouts.find((l) => l.dir === \"\") ?? null\n  const nestedLayouts = model.layouts\n    .filter((l) => l.dir !== \"\")\n    .sort((a, b) => depth(a.dir) - depth(b.dir))\n\n  const built: BuiltLayout[] = []\n  const dirToId = new Map<string, string>()\n\n  nestedLayouts.forEach((layout, i) => {\n    const id = `L${i}`\n    // Parent = deepest other layout that is a strict ancestor of this dir.\n    let parent: { id: string; dir: string } | null = null\n    for (const cand of built) {\n      if (isStrictAncestorDir(cand.dir, layout.dir)) {\n        if (!parent || depth(cand.dir) > depth(parent.dir)) parent = { id: cand.id, dir: cand.dir }\n      }\n    }\n    const parentDir = parent ? parent.dir : \"\"\n    const relDir = parentDir === \"\" ? layout.dir : layout.dir.slice(parentDir.length + 1)\n    built.push({\n      id,\n      dir: layout.dir,\n      parentId: parent ? parent.id : null,\n      path: dirToRouterPath(relDir),\n      file: layout.file,\n    })\n    dirToId.set(layout.dir, id)\n  })\n\n  const pages: BuiltPage[] = model.pages.map((page) => {\n    // Owner = deepest layout whose dir is an ancestor-or-equal of the page dir.\n    let owner: BuiltLayout | null = null\n    for (const l of built) {\n      if (isAncestorDir(l.dir, page.dir)) {\n        if (!owner || depth(l.dir) > depth(owner.dir)) owner = l\n      }\n    }\n    const ownerSegCount = owner ? depth(owner.dir) : 0\n    const remaining = page.segments.slice(ownerSegCount)\n    const index = remaining.length === 0\n    const path = index ? \"/\" : remaining.map(segToRouter).join(\"/\")\n    // `extractPageMeta` reads the file as UTF-8 and runs regexes over it, so a\n    // data file must never reach it — a few MB of spreadsheet binary would be\n    // decoded and scanned for a `definePage` that cannot exist there.\n    const meta = page.kind === \"file\" ? filePageMeta(page) : extractPageMeta(page.absFile)\n    const builtPage: BuiltPage = {\n      file: page.file,\n      routePath: page.routePath,\n      parentLayoutId: owner ? owner.id : null,\n      path,\n      index,\n      kind: page.kind,\n    }\n    if (meta.title) builtPage.title = meta.title\n    if (meta.description) builtPage.description = meta.description\n    if (meta.navLabel) builtPage.navLabel = meta.navLabel\n    if (page.fileExt) builtPage.fileExt = page.fileExt\n    if (page.variant) builtPage.variant = page.variant\n    if (meta.placeholder) builtPage.placeholder = meta.placeholder\n    return builtPage\n  })\n\n  // Filter out placeholder pages when there's another page at the same route.\n  // This allows new artifacts (e.g. index.slide.tsx) to claim \"/\" when the\n  // template's placeholder home page is untouched.\n  const byRoutePath = new Map<string, { placeholder: BuiltPage[]; nonPlaceholder: BuiltPage[] }>()\n  for (const page of pages) {\n    const group = byRoutePath.get(page.routePath) ?? { placeholder: [], nonPlaceholder: [] }\n    if (page.placeholder) {\n      group.placeholder.push(page)\n    } else {\n      group.nonPlaceholder.push(page)\n    }\n    byRoutePath.set(page.routePath, group)\n  }\n\n  const filteredPages: BuiltPage[] = []\n  for (const group of byRoutePath.values()) {\n    // If there are non-placeholder pages, use only those\n    if (group.nonPlaceholder.length > 0) {\n      filteredPages.push(...group.nonPlaceholder)\n    } else {\n      // Otherwise, use the placeholder(s)\n      filteredPages.push(...group.placeholder)\n    }\n  }\n\n  return {\n    rootLayout: rootLayoutRoute ? rootLayoutRoute.file : null,\n    notFound: model.notFound,\n    error: model.error,\n    layouts: built,\n    pages: filteredPages,\n  }\n}\n"]}

package/dist/{chunk-QI3XQKHS.js → chunk-GNXCX4WE.js}

@@ -20,6 +20,7 @@ var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "no-strict-port",
   "overlay",
   "no-overlay",
+  "draft-preview",
   "h",
   "v"
 ]);
@@ -114,6 +115,12 @@ function resolveHmrOverlay(flags) {
   if (flags.overlay) return true;
   return !flags["no-overlay"];
 }
+function resolveDraftPreview(flags) {
+  const flag = flags["draft-preview"];
+  if (flag === true || flag === "true" || flag === "1") return true;
+  if (flag !== void 0) return false;
+  return process.env.VANTAGE_DRAFT_PREVIEW === "1";
+}
 function reportPortInUse(err, port, strictPort) {
   if (!strictPort || !(err instanceof Error) || !/already in use/.test(err.message)) return false;
   log.error(`Port ${port} is already in use.`);
@@ -173,6 +180,6 @@ function frameworkVersion() {
   }
 }
 
-export { applyApiBaseUrlFlag, frameworkVersion, log, parseArgs, printDiagnostics, printJson, reportPortInUse, resolveHmrOverlay, resolveHostOptions, resolvePortOptions, resolveQuickRoot, resolveRoot };
-//# sourceMappingURL=chunk-QI3XQKHS.js.map
-//# sourceMappingURL=chunk-QI3XQKHS.js.map
+export { applyApiBaseUrlFlag, frameworkVersion, log, parseArgs, printDiagnostics, printJson, reportPortInUse, resolveDraftPreview, resolveHmrOverlay, resolveHostOptions, resolvePortOptions, resolveQuickRoot, resolveRoot };
+//# sourceMappingURL=chunk-GNXCX4WE.js.map
+//# sourceMappingURL=chunk-GNXCX4WE.js.map

package/dist/chunk-GNXCX4WE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/util.ts"],"names":[],"mappings":"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","file":"chunk-GNXCX4WE.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport pc from \"picocolors\"\nimport { PAGE_EXTENSIONS } from \"../core/constants\"\nimport type { Diagnostic } from \"../core/types\"\n\n/** Parsed CLI arguments. */\nexport interface ParsedArgs {\n  positionals: string[]\n  flags: Record<string, string | boolean>\n}\n\n/** Flags that never take a value, so they don't swallow the next token. */\nconst BOOLEAN_FLAGS = new Set([\n  \"json\",\n  \"help\",\n  \"force\",\n  \"verbose\",\n  \"version\",\n  \"all\",\n  \"list\",\n  \"regex\",\n  \"pages\",\n  \"apis\",\n  \"detail\",\n  \"strict-port\",\n  \"no-strict-port\",\n  \"overlay\",\n  \"no-overlay\",\n  \"draft-preview\",\n  \"h\",\n  \"v\",\n])\n\n/**\n * Flags whose value is optional: bare `--host` means `true` (all interfaces),\n * `--host 0.0.0.0` / `--host=::` carry the address. The next token is taken as\n * the value only when it does not look like another flag, so `--host --port 3000`\n * still reads as two flags. Write `--host=<addr>` when the following token could\n * be mistaken for the value (e.g. a positional).\n */\nconst OPTIONAL_VALUE_FLAGS = new Set([\"host\"])\n\n/** Minimal argv parser: `--json`, `--port 3000`, `--port=3000`, `-v`, positionals. */\nexport function parseArgs(argv: string[]): ParsedArgs {\n  const positionals: string[] = []\n  const flags: Record<string, string | boolean> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]!\n    if (arg.startsWith(\"--\")) {\n      const eq = arg.indexOf(\"=\")\n      if (eq !== -1) {\n        flags[arg.slice(2, eq)] = arg.slice(eq + 1)\n        continue\n      }\n      const key = arg.slice(2)\n      if (BOOLEAN_FLAGS.has(key)) {\n        flags[key] = true\n        continue\n      }\n      const next = argv[i + 1]\n      if (OPTIONAL_VALUE_FLAGS.has(key)) {\n        if (next !== undefined && !next.startsWith(\"-\")) {\n          flags[key] = next\n          i++\n        } else {\n          flags[key] = true\n        }\n        continue\n      }\n      if (next !== undefined && !next.startsWith(\"-\")) {\n        flags[key] = next\n        i++\n      } else {\n        flags[key] = true\n      }\n    } else if (arg.length > 1 && arg.startsWith(\"-\") && !/^-\\d/.test(arg)) {\n      // Single-dash short flags, e.g. `-v`, `-h` (each char is a boolean).\n      for (const ch of arg.slice(1)) flags[ch] = true\n    } else {\n      positionals.push(arg)\n    }\n  }\n  return { positionals, flags }\n}\n\n/**\n * Apply a `--api-base-url <url>` flag by setting `process.env.PUBLIC_API_BASE_URL`\n * so Vite inlines it into the client bundle (via envPrefix). Setting it on\n * process.env gives the flag precedence over any `.env` file value. No-op when\n * the flag is absent, leaving any `.env` value in effect.\n */\nexport function applyApiBaseUrlFlag(args: ParsedArgs): void {\n  const value = args.flags[\"api-base-url\"]\n  if (typeof value === \"string\" && value.length) {\n    process.env.PUBLIC_API_BASE_URL = value\n  }\n}\n\n/** A resolved `--port`, or the reason it could not be resolved. */\nexport type PortResolution =\n  | { ok: true; port: number; strictPort: boolean }\n  | { ok: false; error: string }\n\n/**\n * Resolve `--port` / `--strict-port` / `--no-strict-port` into Vite's server\n * options.\n *\n * An explicit `--port` is strict by default: writing `--port 3000` means the\n * port is a contract with something outside this process — a reverse proxy, a\n * container port mapping, an OAuth redirect URI — so binding 3001 instead is a\n * silent failure, not a recovery (a supervisor that only checks \"is anything\n * listening on 3000\" will happily report a server that nobody can reach).\n * Without the flag the default is merely \"some free port\", so Vite keeps\n * walking to the next one as it always has, and running two projects at once\n * needs no ceremony. `--strict-port` / `--no-strict-port` override either way.\n *\n * A bad value is an error rather than a silent fallback, for the same reason:\n * a typo'd `--port` that quietly became 5173 is exactly the failure strictness\n * exists to prevent.\n */\nexport function resolvePortOptions(\n  flags: Record<string, string | boolean>,\n  fallback: number,\n): PortResolution {\n  const raw = flags.port\n  let port = fallback\n  if (raw !== undefined) {\n    if (typeof raw !== \"string\") return { ok: false, error: \"--port needs a number, e.g. --port 3000\" }\n    const n = Number(raw)\n    if (!Number.isInteger(n) || n < 1 || n > 65535) {\n      return { ok: false, error: `Invalid --port \"${raw}\" — use an integer between 1 and 65535.` }\n    }\n    port = n\n  }\n  const strictPort = flags[\"no-strict-port\"]\n    ? false\n    : Boolean(flags[\"strict-port\"]) || raw !== undefined\n  return { ok: true, port, strictPort }\n}\n\n/** Environment variable read for `allowedHosts` when the flag is absent. */\nexport const ALLOWED_HOSTS_ENV = \"VANTAGE_ALLOWED_HOSTS\"\n\n/** Resolved `--host` / `--allowed-hosts`, or the reason they could not be resolved. */\nexport type HostResolution =\n  | { ok: true; options: { host?: string | true; allowedHosts?: string[] | true } }\n  | { ok: false; error: string }\n\n/**\n * Resolve `--host [addr]` and `--allowed-hosts <list|true>` (falling back to\n * `VANTAGE_ALLOWED_HOSTS`) into the subset of Vite's server options they map to.\n *\n * Only the keys that were actually set are returned, so spreading the result\n * into `server` / `preview` leaves Vite's defaults untouched when neither is\n * given — the default behaviour must not change for anyone who never asked.\n *\n * `allowedHosts` exists because Vite rejects (403) any request whose `Host`\n * is not localhost or the bound address. A reverse proxy in front of the dev\n * server — a sandbox preview proxy, a tunnel, a container network — presents\n * its own hostname, so that hostname must be listed (or the check disabled\n * with the literal `true`). The env form is for supervisors that start the\n * server and know the hostname; an explicit flag still wins over it.\n */\nexport function resolveHostOptions(\n  flags: Record<string, string | boolean>,\n  env: NodeJS.ProcessEnv = process.env,\n): HostResolution {\n  const options: { host?: string | true; allowedHosts?: string[] | true } = {}\n\n  const host = flags.host\n  // bare `--host` and `--host=` both mean \"every interface\"\n  if (host === true || host === \"\") options.host = true\n  else if (typeof host === \"string\") options.host = host\n\n  const flag = flags[\"allowed-hosts\"]\n  if (flag === true) {\n    return {\n      ok: false,\n      error: `--allowed-hosts needs a comma-separated list of hostnames, or \"true\" to allow any`,\n    }\n  }\n  const raw = typeof flag === \"string\" ? flag : env[ALLOWED_HOSTS_ENV]\n  const allowedHosts = parseAllowedHosts(raw)\n  if (allowedHosts !== undefined) options.allowedHosts = allowedHosts\n\n  return { ok: true, options }\n}\n\n/** `\"a,b\"` → `[\"a\",\"b\"]`, the literal `true` → `true`, unset/blank → undefined (Vite default). */\nfunction parseAllowedHosts(raw: string | undefined): string[] | true | undefined {\n  if (raw === undefined) return undefined\n  const trimmed = raw.trim()\n  if (trimmed === \"\") return undefined\n  if (trimmed === \"true\") return true\n  const hosts = trimmed\n    .split(\",\")\n    .map((h) => h.trim())\n    .filter((h) => h.length > 0)\n  return hosts.length ? hosts : undefined\n}\n\n/**\n * Resolve `--overlay` / `--no-overlay` into Vite's `server.hmr.overlay`.\n *\n * The overlay stays on by default — it is the fastest way for a human to see a\n * runtime error. `--no-overlay` is for the cases where a full-screen error card\n * is in the way rather than helpful: screenshots and demos, and agent-driven\n * sessions where the error already arrives in the terminal through console\n * forwarding and the overlay only obscures the page being inspected.\n */\nexport function resolveHmrOverlay(flags: Record<string, string | boolean>): boolean {\n  if (flags.overlay) return true\n  return !flags[\"no-overlay\"]\n}\n\n/**\n * Whether `dev` accepts unfinished files (`--draft-preview` or\n * `VANTAGE_DRAFT_PREVIEW=1`). Off by default: the endpoint it opens is only for\n * a supervisor (the Squadbase sandbox) that streams an agent's half-written\n * files into the preview, and a plain dev server should not have it.\n */\nexport function resolveDraftPreview(flags: Record<string, string | boolean>): boolean {\n  const flag = flags[\"draft-preview\"]\n  if (flag === true || flag === \"true\" || flag === \"1\") return true\n  if (flag !== undefined) return false\n  return process.env.VANTAGE_DRAFT_PREVIEW === \"1\"\n}\n\n/**\n * Report a strict bind that lost the port, in the one shape dev and preview\n * share. Returns false when `err` is anything else, so the caller rethrows.\n * Vite throws a plain Error (no `code`) for this, hence the message match — a\n * reworded Vite message degrades to the generic handler, not to a wrong one.\n */\nexport function reportPortInUse(err: unknown, port: number, strictPort: boolean): boolean {\n  if (!strictPort || !(err instanceof Error) || !/already in use/.test(err.message)) return false\n  log.error(`Port ${port} is already in use.`)\n  log.info(\"  free that port, pass a different --port, or --no-strict-port to take the next one\")\n  return true\n}\n\n/** Resolve the project root, honoring `--root`, defaulting to cwd. */\nexport function resolveRoot(flags: Record<string, string | boolean>): string {\n  const raw = typeof flags.root === \"string\" ? flags.root : process.cwd()\n  return path.resolve(raw)\n}\n\n/** How far up from a page file to look for the package root. */\nconst QUICK_ROOT_MAX_DEPTH = 5\n\n/**\n * Resolve a positional path to a quick-run project root.\n * A directory → itself; a page file (.tsx/.jsx) → its project; else null.\n */\nexport function resolveQuickRoot(target: string): string | null {\n  try {\n    const abs = path.resolve(target)\n    const stat = fs.statSync(abs)\n    if (stat.isDirectory()) return abs\n    if (stat.isFile() && PAGE_EXTENSIONS.some((ext) => abs.endsWith(ext))) {\n      // Walk up to the nearest package.json so `vantage ./demo/src/index.tsx`\n      // starts in ./demo — the directory holding the page is not the project\n      // root once pages live under src/ (or in any nested route directory).\n      let dir = path.dirname(abs)\n      for (let i = 0; i <= QUICK_ROOT_MAX_DEPTH; i++) {\n        if (fs.existsSync(path.join(dir, \"package.json\"))) return dir\n        const parent = path.dirname(dir)\n        if (parent === dir) break\n        dir = parent\n      }\n      return path.dirname(abs)\n    }\n  } catch {\n    // statSync throws when the path does not exist → null (not a quick target)\n  }\n  return null\n}\n\nexport const log = {\n  info: (msg: string) => console.log(msg),\n  step: (msg: string) => console.log(pc.cyan(\"→ \") + msg),\n  ok: (msg: string) => console.log(pc.green(\"✓ \") + msg),\n  warn: (msg: string) => console.log(pc.yellow(\"! \") + msg),\n  error: (msg: string) => console.error(pc.red(\"✗ \") + msg),\n  brand: (msg: string) => console.log(pc.bold(pc.magenta(\"vantage \")) + msg),\n}\n\n/** Print diagnostics as human-readable text. */\nexport function printDiagnostics(diags: Diagnostic[]): void {\n  for (const d of diags) {\n    const badge =\n      d.severity === \"error\" ? pc.red(pc.bold(\" ERROR \")) : pc.yellow(pc.bold(\" WARN \"))\n    console.log(`${badge} ${pc.dim(d.code)} ${d.message}`)\n    if (d.files?.length) console.log(`        ${pc.dim(\"files:\")} ${d.files.join(\", \")}`)\n    if (d.fix) console.log(`        ${pc.dim(\"fix:\")} ${d.fix}`)\n  }\n}\n\n/** Emit a JSON payload to stdout (for agent consumption). */\nexport function printJson(payload: unknown): void {\n  process.stdout.write(JSON.stringify(payload, null, 2) + \"\\n\")\n}\n\n/** Read the vantage package version. */\nexport function frameworkVersion(): string {\n  try {\n    // dist/cli.js (and shared chunks) live in dist/, so package.json is one up.\n    const url = new URL(\"../package.json\", import.meta.url)\n    const pkg = JSON.parse(fs.readFileSync(url, \"utf8\")) as { version: string }\n    return pkg.version\n  } catch {\n    return \"0.0.0\"\n  }\n}\n\nexport function fileExists(p: string): boolean {\n  try {\n    return fs.existsSync(p)\n  } catch {\n    return false\n  }\n}\n"]}