@squadbase/vantage 0.6.1-dev2.5f947f1 → 0.6.2-dev1.0017a4d

package/dist/{docs-ZGDJUHJI.js.map → docs-JVP4RPKT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/docs.ts"],"names":["content"],"mappings":"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","file":"docs-ZGDJUHJI.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  DEFAULT_DOC_LANG,\n  DOC_LANGS,\n  docsForLang,\n  groupBySection,\n  isDocLang,\n  loadCatalog,\n  readDoc,\n  resolveDoc,\n  type DocEntry,\n  type DocLang,\n} from \"./docs-catalog\"\nimport { log, printJson, type ParsedArgs } from \"./util\"\n\n/** Highlight Markdown for a terminal. Piped output stays untouched. */\nfunction paint(markdown: string): string {\n  if (!process.stdout.isTTY) return markdown\n  let inFence = false\n  return markdown\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence\n        return pc.dim(line)\n      }\n      if (inFence) return line\n      if (/^#{1,6}\\s/.test(line)) return pc.bold(pc.magenta(line))\n      if (/^>\\s?/.test(line)) return pc.dim(line)\n      return line\n    })\n    .join(\"\\n\")\n}\n\nfunction printList(entries: DocEntry[]): void {\n  const width = Math.max(...entries.map((doc) => doc.slug.length), 0)\n  for (const group of groupBySection(entries)) {\n    console.log(\"\")\n    console.log(pc.bold(group.title))\n    for (const doc of group.docs) {\n      const slug = doc.slug.padEnd(width)\n      console.log(`  ${pc.cyan(slug)}  ${doc.description || doc.title}`)\n    }\n  }\n  console.log(\"\")\n  console.log(pc.dim(\"vantage docs <name>   show one page      --json   machine-readable\"))\n  console.log(pc.dim(\"vantage docs --all    show every page    --lang   ja | en\"))\n}\n\nfunction toJson(doc: DocEntry, content: string) {\n  return {\n    slug: doc.slug,\n    lang: doc.lang,\n    title: doc.title,\n    description: doc.description,\n    section: doc.section,\n    sectionTitle: doc.sectionTitle,\n    content,\n  }\n}\n\n/** `vantage docs [name] [--list] [--all] [--json] [--lang ja|en]` */\nexport async function docs(_root: string, args: ParsedArgs): Promise<number> {\n  const catalog = loadCatalog()\n  if (!catalog) {\n    log.error(\"The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.\")\n    return 1\n  }\n\n  const langFlag = args.flags.lang\n  if (langFlag !== undefined && !isDocLang(langFlag)) {\n    log.error(`Unknown --lang \"${String(langFlag)}\". Available: ${DOC_LANGS.join(\", \")}`)\n    return 1\n  }\n  const lang: DocLang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG\n\n  const entries = docsForLang(catalog, lang)\n  if (entries.length === 0) {\n    log.error(`No documentation bundled for \"${lang}\".`)\n    return 1\n  }\n\n  const json = Boolean(args.flags.json)\n  const name = args.positionals[1]\n\n  if (args.flags.all) {\n    const pages = entries.map((doc) => ({ doc, content: readDoc(doc) }))\n    if (json) {\n      printJson({ lang, docs: pages.map(({ doc, content }) => toJson(doc, content)) })\n      return 0\n    }\n    process.stdout.write(pages.map(({ content }) => content.trimEnd()).join(\"\\n\\n---\\n\\n\") + \"\\n\")\n    return 0\n  }\n\n  if (!name || args.flags.list) {\n    if (json) {\n      printJson({\n        lang,\n        docs: entries.map(({ slug, title, description, section, sectionTitle }) => ({\n          slug,\n          title,\n          description,\n          section,\n          sectionTitle,\n        })),\n      })\n      return 0\n    }\n    printList(entries)\n    return 0\n  }\n\n  const found = resolveDoc(entries, name)\n  if (found.kind === \"ambiguous\") {\n    log.error(`\"${name}\" matches several pages: ${found.matches.map((d) => d.slug).join(\", \")}`)\n    return 1\n  }\n  if (found.kind === \"missing\") {\n    const suggestions = found.suggestions.map((d) => d.slug)\n    log.error(\n      suggestions.length\n        ? `No page named \"${name}\". Did you mean: ${suggestions.slice(0, 8).join(\", \")}?`\n        : `No page named \"${name}\". Run \\`vantage docs\\` to list every page.`,\n    )\n    return 1\n  }\n\n  const content = readDoc(found.doc)\n  if (json) {\n    printJson(toJson(found.doc, content))\n    return 0\n  }\n  process.stdout.write(paint(content.trimEnd()) + \"\\n\")\n  return 0\n}\n"]}
+{"version":3,"sources":["../src/cli/docs.ts"],"names":["content"],"mappings":"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","file":"docs-JVP4RPKT.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  DEFAULT_DOC_LANG,\n  DOC_LANGS,\n  docsForLang,\n  groupBySection,\n  isDocLang,\n  loadCatalog,\n  readDoc,\n  resolveDoc,\n  type DocEntry,\n  type DocLang,\n} from \"./docs-catalog\"\nimport { log, printJson, type ParsedArgs } from \"./util\"\n\n/** Highlight Markdown for a terminal. Piped output stays untouched. */\nfunction paint(markdown: string): string {\n  if (!process.stdout.isTTY) return markdown\n  let inFence = false\n  return markdown\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence\n        return pc.dim(line)\n      }\n      if (inFence) return line\n      if (/^#{1,6}\\s/.test(line)) return pc.bold(pc.magenta(line))\n      if (/^>\\s?/.test(line)) return pc.dim(line)\n      return line\n    })\n    .join(\"\\n\")\n}\n\nfunction printList(entries: DocEntry[]): void {\n  const width = Math.max(...entries.map((doc) => doc.slug.length), 0)\n  for (const group of groupBySection(entries)) {\n    console.log(\"\")\n    console.log(pc.bold(group.title))\n    for (const doc of group.docs) {\n      const slug = doc.slug.padEnd(width)\n      console.log(`  ${pc.cyan(slug)}  ${doc.description || doc.title}`)\n    }\n  }\n  console.log(\"\")\n  console.log(pc.dim(\"vantage docs <name>   show one page      --json   machine-readable\"))\n  console.log(pc.dim(\"vantage docs --all    show every page    --lang   ja | en\"))\n}\n\nfunction toJson(doc: DocEntry, content: string) {\n  return {\n    slug: doc.slug,\n    lang: doc.lang,\n    title: doc.title,\n    description: doc.description,\n    section: doc.section,\n    sectionTitle: doc.sectionTitle,\n    content,\n  }\n}\n\n/** `vantage docs [name] [--list] [--all] [--json] [--lang ja|en]` */\nexport async function docs(_root: string, args: ParsedArgs): Promise<number> {\n  const catalog = loadCatalog()\n  if (!catalog) {\n    log.error(\"The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.\")\n    return 1\n  }\n\n  const langFlag = args.flags.lang\n  if (langFlag !== undefined && !isDocLang(langFlag)) {\n    log.error(`Unknown --lang \"${String(langFlag)}\". Available: ${DOC_LANGS.join(\", \")}`)\n    return 1\n  }\n  const lang: DocLang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG\n\n  const entries = docsForLang(catalog, lang)\n  if (entries.length === 0) {\n    log.error(`No documentation bundled for \"${lang}\".`)\n    return 1\n  }\n\n  const json = Boolean(args.flags.json)\n  const name = args.positionals[1]\n\n  if (args.flags.all) {\n    const pages = entries.map((doc) => ({ doc, content: readDoc(doc) }))\n    if (json) {\n      printJson({ lang, docs: pages.map(({ doc, content }) => toJson(doc, content)) })\n      return 0\n    }\n    process.stdout.write(pages.map(({ content }) => content.trimEnd()).join(\"\\n\\n---\\n\\n\") + \"\\n\")\n    return 0\n  }\n\n  if (!name || args.flags.list) {\n    if (json) {\n      printJson({\n        lang,\n        docs: entries.map(({ slug, title, description, section, sectionTitle }) => ({\n          slug,\n          title,\n          description,\n          section,\n          sectionTitle,\n        })),\n      })\n      return 0\n    }\n    printList(entries)\n    return 0\n  }\n\n  const found = resolveDoc(entries, name)\n  if (found.kind === \"ambiguous\") {\n    log.error(`\"${name}\" matches several pages: ${found.matches.map((d) => d.slug).join(\", \")}`)\n    return 1\n  }\n  if (found.kind === \"missing\") {\n    const suggestions = found.suggestions.map((d) => d.slug)\n    log.error(\n      suggestions.length\n        ? `No page named \"${name}\". Did you mean: ${suggestions.slice(0, 8).join(\", \")}?`\n        : `No page named \"${name}\". Run \\`vantage docs\\` to list every page.`,\n    )\n    return 1\n  }\n\n  const content = readDoc(found.doc)\n  if (json) {\n    printJson(toJson(found.doc, content))\n    return 0\n  }\n  process.stdout.write(paint(content.trimEnd()) + \"\\n\")\n  return 0\n}\n"]}

package/dist/{doctor-VFKEMR54.js → doctor-5E2VEZPK.js}

@@ -1,8 +1,8 @@
-import { runDiagnostics } from './chunk-BCE22JSM.js';
-import './chunk-JGRMRXXZ.js';
-import './chunk-KLEIVDUV.js';
-import { scanProject } from './chunk-ZVANIULZ.js';
-import { printJson, frameworkVersion, log } from './chunk-3G43C6OL.js';
+import { runDiagnostics } from './chunk-7DZGJQ3P.js';
+import './chunk-JKLLFVEU.js';
+import './chunk-CEXAQQ5W.js';
+import { scanProject } from './chunk-RNTDBX6S.js';
+import { printJson, frameworkVersion, log } from './chunk-GNXCX4WE.js';
 import './chunk-C2CX6GLX.js';
 import fs from 'fs';
 import path from 'path';
@@ -19,7 +19,7 @@ async function doctor(root, args) {
   });
   const pkgPath = path.join(root, "package.json");
   facets.push({ name: "package.json", ok: fs.existsSync(pkgPath), detail: fs.existsSync(pkgPath) ? "found" : "missing" });
-  const lockfiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock"];
+  const lockfiles = ["bun.lock", "bun.lockb", "pnpm-lock.yaml", "package-lock.json", "yarn.lock"];
   const lock = lockfiles.find((f) => fs.existsSync(path.join(root, f)) || fs.existsSync(path.join(root, "..", f)) || fs.existsSync(path.join(root, "..", "..", f)));
   facets.push({ name: "lockfile", ok: Boolean(lock), detail: lock ?? "none found" });
   let installedVantage = "not installed";
@@ -54,5 +54,5 @@ async function doctor(root, args) {
 }
 
 export { doctor };
-//# sourceMappingURL=doctor-VFKEMR54.js.map
-//# sourceMappingURL=doctor-VFKEMR54.js.map
+//# sourceMappingURL=doctor-5E2VEZPK.js.map
+//# sourceMappingURL=doctor-5E2VEZPK.js.map

package/dist/doctor-5E2VEZPK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/doctor.ts"],"names":["require"],"mappings":";;;;;;;;;;;AAcA,eAAsB,MAAA,CAAO,MAAc,IAAA,EAAmC;AAC5E,EAAA,MAAM,SAAkB,EAAC;AAEzB,EAAA,MAAM,SAAA,GAAY,OAAO,OAAA,CAAQ,QAAA,CAAS,KAAK,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAC,CAAA;AAC5D,EAAA,MAAA,CAAO,IAAA,CAAK;AAAA,IACV,IAAA,EAAM,MAAA;AAAA,IACN,IAAI,SAAA,IAAa,EAAA;AAAA,IACjB,MAAA,EAAQ,IAAI,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EAAG,SAAA,IAAa,EAAA,GAAK,EAAA,GAAK,mBAAmB,CAAA;AAAA,GAC/E,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,cAAc,CAAA;AAC9C,EAAA,MAAA,CAAO,KAAK,EAAE,IAAA,EAAM,cAAA,EAAgB,EAAA,EAAI,GAAG,UAAA,CAAW,OAAO,CAAA,EAAG,MAAA,EAAQ,GAAG,UAAA,CAAW,OAAO,CAAA,GAAI,OAAA,GAAU,WAAW,CAAA;AAEtH,EAAA,MAAM,YAAY,CAAC,UAAA,EAAY,WAAA,EAAa,gBAAA,EAAkB,qBAAqB,WAAW,CAAA;AAC9F,EAAA,MAAM,IAAA,GAAO,SAAA,CAAU,IAAA,CAAK,CAAC,CAAA,KAAM,EAAA,CAAG,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,CAAC,CAAC,KAAK,EAAA,CAAG,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,KAAK,EAAA,CAAG,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,CAAC,CAAA;AAChK,EAAA,MAAA,CAAO,IAAA,CAAK,EAAE,IAAA,EAAM,UAAA,EAAY,EAAA,EAAI,OAAA,CAAQ,IAAI,CAAA,EAAG,MAAA,EAAQ,IAAA,IAAQ,YAAA,EAAc,CAAA;AAEjF,EAAA,IAAI,gBAAA,GAAmB,eAAA;AACvB,EAAA,IAAI,SAAA,GAAY,KAAA;AAChB,EAAA,IAAI;AACF,IAAA,MAAMA,WAAU,aAAA,CAAc,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,SAAS,CAAC,CAAA;AACxD,IAAA,MAAM,CAAA,GAAIA,QAAAA,CAAQ,OAAA,CAAQ,iCAAiC,CAAA;AAC3D,IAAA,gBAAA,GAAoB,KAAK,KAAA,CAAM,EAAA,CAAG,aAAa,CAAA,EAAG,MAAM,CAAC,CAAA,CAA0B,OAAA;AACnF,IAAA,SAAA,GAAY,IAAA;AAAA,EACd,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,MAAA,CAAO,IAAA,CAAK,EAAE,IAAA,EAAM,oBAAA,EAAsB,IAAI,SAAA,EAAW,MAAA,EAAQ,kBAAkB,CAAA;AAEnF,EAAA,MAAM,KAAA,GAAQ,YAAY,IAAI,CAAA;AAC9B,EAAA,MAAM,MAAA,GAAS,cAAA,CAAe,IAAA,EAAM,KAAK,CAAA,CAAE,OAAO,CAAC,CAAA,KAAM,CAAA,CAAE,QAAA,KAAa,OAAO,CAAA;AAC/E,EAAA,MAAA,CAAO,IAAA,CAAK;AAAA,IACV,IAAA,EAAM,SAAA;AAAA,IACN,EAAA,EAAI,OAAO,MAAA,KAAW,CAAA;AAAA,IACtB,QAAQ,MAAA,CAAO,MAAA,KAAW,IAAI,oBAAA,GAAuB,CAAA,EAAG,OAAO,MAAM,CAAA,iCAAA;AAAA,GACtE,CAAA;AAED,EAAA,MAAM,QAAQ,MAAA,CAAO,KAAA,CAAM,CAAC,CAAA,KAAM,EAAE,EAAE,CAAA;AAEtC,EAAA,IAAI,IAAA,CAAK,MAAM,IAAA,EAAM;AACnB,IAAA,SAAA,CAAU,EAAE,EAAA,EAAI,KAAA,EAAO,KAAK,gBAAA,EAAiB,EAAG,QAAQ,CAAA;AACxD,IAAA,OAAO,QAAQ,CAAA,GAAI,CAAA;AAAA,EACrB;AAEA,EAAA,GAAA,CAAI,KAAA,CAAM,CAAA,aAAA,EAAgB,gBAAA,EAAkB,CAAA,CAAA,CAAG,CAAA;AAC/C,EAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,IAAA,MAAM,IAAA,GAAO,GAAG,CAAA,CAAE,IAAA,CAAK,OAAO,EAAE,CAAC,CAAA,CAAA,EAAI,CAAA,CAAE,MAAM,CAAA,CAAA;AAC7C,IAAA,IAAI,CAAA,CAAE,EAAA,EAAI,GAAA,CAAI,EAAA,CAAG,IAAI,CAAA;AAAA,SAChB,GAAA,CAAI,MAAM,IAAI,CAAA;AAAA,EACrB;AACA,EAAA,OAAO,QAAQ,CAAA,GAAI,CAAA;AACrB","file":"doctor-5E2VEZPK.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { createRequire } from \"node:module\"\nimport { runDiagnostics } from \"../core/diagnostics\"\nimport { scanProject } from \"../core/scan\"\nimport { frameworkVersion, log, printJson, type ParsedArgs } from \"./util\"\n\ninterface Facet {\n  name: string\n  ok: boolean\n  detail: string\n}\n\n/** `vantage doctor` — environment and installation health checks. */\nexport async function doctor(root: string, args: ParsedArgs): Promise<number> {\n  const facets: Facet[] = []\n\n  const nodeMajor = Number(process.versions.node.split(\".\")[0])\n  facets.push({\n    name: \"node\",\n    ok: nodeMajor >= 20,\n    detail: `v${process.versions.node}${nodeMajor >= 20 ? \"\" : \" (requires >= 20)\"}`,\n  })\n\n  const pkgPath = path.join(root, \"package.json\")\n  facets.push({ name: \"package.json\", ok: fs.existsSync(pkgPath), detail: fs.existsSync(pkgPath) ? \"found\" : \"missing\" })\n\n  const lockfiles = [\"bun.lock\", \"bun.lockb\", \"pnpm-lock.yaml\", \"package-lock.json\", \"yarn.lock\"]\n  const lock = lockfiles.find((f) => fs.existsSync(path.join(root, f)) || fs.existsSync(path.join(root, \"..\", f)) || fs.existsSync(path.join(root, \"..\", \"..\", f)))\n  facets.push({ name: \"lockfile\", ok: Boolean(lock), detail: lock ?? \"none found\" })\n\n  let installedVantage = \"not installed\"\n  let vantageOk = false\n  try {\n    const require = createRequire(path.join(root, \"noop.js\"))\n    const p = require.resolve(\"@squadbase/vantage/package.json\")\n    installedVantage = (JSON.parse(fs.readFileSync(p, \"utf8\")) as { version: string }).version\n    vantageOk = true\n  } catch {\n    /* not resolvable */\n  }\n  facets.push({ name: \"@squadbase/vantage\", ok: vantageOk, detail: installedVantage })\n\n  const model = scanProject(root)\n  const errors = runDiagnostics(root, model).filter((d) => d.severity === \"error\")\n  facets.push({\n    name: \"project\",\n    ok: errors.length === 0,\n    detail: errors.length === 0 ? \"no blocking errors\" : `${errors.length} error(s) (run \\`vantage check\\`)`,\n  })\n\n  const allOk = facets.every((f) => f.ok)\n\n  if (args.flags.json) {\n    printJson({ ok: allOk, cli: frameworkVersion(), facets })\n    return allOk ? 0 : 1\n  }\n\n  log.brand(`doctor (cli v${frameworkVersion()})`)\n  for (const f of facets) {\n    const line = `${f.name.padEnd(22)} ${f.detail}`\n    if (f.ok) log.ok(line)\n    else log.error(line)\n  }\n  return allOk ? 0 : 1\n}\n"]}

package/dist/format-U0cQl069.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Locale-aware number formatting shared by KPI cards, tables and charts. All
+ * shortening is delegated to `Intl.NumberFormat` (`notation: "compact"`); this
+ * module never hard-codes unit thresholds or unit strings.
+ *
+ * | `format`                                   | input        | ja-JP output   |
+ * |--------------------------------------------|--------------|----------------|
+ * | `"compact"` (default)                      | `48_200_000` | `4,820万`      |
+ * | `"number"`                                 | `1234.567`   | `1,234.57`     |
+ * | `"currency"` (JPY, compact)                | `48_200_000` | `¥4,820万`     |
+ * | `{ type: "currency", notation: "standard" }` | `48_200_000` | `¥48,200,000`  |
+ * | `{ type: "currency", currency: "USD" }`    | `1234.5`     | `$1,234.5`     |
+ * | `"percent"` — pass a **ratio**             | `0.124`      | `12.4%`        |
+ * | `{ type: "percent", digits: 0 }`           | `0.124`      | `12%`          |
+ * | `"multiple"`                               | `1.5`        | `1.5×`         |
+ * | `{ type: "number", unit: "件" }`           | `48_210`     | `48,210件`     |
+ * | `{ type: "compact", unit: "人" }`          | `12_345`     | `1.2万人`      |
+ * | `"duration"` — pass **seconds**            | `12_000`     | `3時間20分`    |
+ * | `{ type: "duration", durationUnit: "minute" }` | `2160`   | `1.5日`        |
+ *
+ * - `percent` takes a ratio (0.124 → 12.4%). Passing 12.4 renders 1,240%. The fraction
+ *   digits are **fixed**, never trimmed (`PERCENT_DIGITS` = 1: 0.14 → "14.0%", never "14%"
+ *   beside "11.9%"). Pass `digits` in the format to share another count across cards.
+ * - A minus sign is always U+2212 (`MINUS_SIGN`, "−1,234" / "−5.0%"), never the hyphen-minus.
+ * - `currency` defaults to JPY and to compact notation (万・億 in ja); pass
+ *   `notation: "standard"` for every digit (tables, invoices). In ja-JP the yen
+ *   sign is the half-width `¥`.
+ * - `unit` is a counter appended right after the number, with no space
+ *   ("48,210件", "1.2万人"), for `number` / `compact` / `currency`. It is
+ *   ignored for `percent` and `duration`, and for `multiple` it replaces the
+ *   default `×` ("2.7倍"). Do not write it into a `valueFormatter` by hand.
+ * - Charts take the same `format` a KpiCard takes (`format="currency"`).
+ *   `toValueFormatter(format)` turns it into a function for places that need
+ *   one (a `valueFormatter`, table cells).
+ * - Missing values (null / undefined / NaN) render as `—` (`EMPTY_VALUE`).
+ * - Dates go through `formatDate` (`Intl.DateTimeFormat`): `"date"` → `2026/10/20`,
+ *   `"datetime"` → `2026/10/20 14:30`, `"year-month"` → `2026年10月`, `"month"` → `10月`,
+ *   `"year"` → `2026年`.
+ * - A period goes through `formatDateRange`: `2026/9/23〜10/20` (same year drops the end year),
+ *   `2025/12/20〜2026/1/18` across years; month and day are not zero-padded.
+ */
+/**
+ * The kind of number a value is. Pick by what the number means, not by how
+ * long it is: `currency` for money, `percent` for a ratio, `multiple` for a
+ * factor ("1.5×"), `duration` for a length of time ("3時間20分"), `number` for
+ * exact counts in tables, `compact` (default) for large headline counts (万・億).
+ */
+type FormatKind = "number" | "compact" | "currency" | "percent" | "multiple" | "duration";
+/** The unit a `duration` value is measured in. */
+type DurationUnit = "second" | "minute" | "hour" | "day";
+/**
+ * How to display a number: a `FormatKind` alone, or an object for digits,
+ * currency, notation and a counter. The same value is accepted by KpiCard,
+ * Delta, the charts (`format`) and `formatValue`.
+ *
+ * @example
+ * "currency"                                   // ¥4,820万
+ * { type: "currency", notation: "standard" }   // ¥48,200,000
+ * { type: "percent", digits: 1 }               // 2.0%
+ * { type: "number", unit: "件" }               // 48,210件
+ */
+type ValueFormat = FormatKind | {
+    type: FormatKind;
+    /** Fixed number of fraction digits. */
+    digits?: number;
+    /** ISO 4217 code for `currency`. Default `"JPY"`. */
+    currency?: string;
+    /** `currency` only: `"compact"` (default, 万・億) or `"standard"` (every digit). */
+    notation?: "compact" | "standard";
+    /** Counter appended after the number, e.g. `"件"`, `"人"`. Ignored for `percent` and `duration`. For `multiple` it replaces the default `×` (`"倍"` → `2.7倍`). */
+    unit?: string;
+    /** 値をこの数で割ってから整形する。例: `divisor: 100`（セント → ドル）。0 と非有限は無視。 */
+    divisor?: number;
+    /** `duration` only: the unit the value is in. Default `"second"`. Reads as "45秒" / "12分" / "3時間20分" / "1.5日" (`digits` sets the fraction digits of days). */
+    durationUnit?: DurationUnit;
+};
+/** Locale used when none is passed. Every function here takes a `locale` to override it. */
+declare const DEFAULT_LOCALE = "ja-JP";
+/** Shown in place of a missing value (null / undefined / NaN). */
+declare const EMPTY_VALUE = "\u2014";
+/** The minus sign every formatter writes (U+2212), so a negative never mixes with a hyphen-minus. */
+declare const MINUS_SIGN = "\u2212";
+/** Extra options for `formatValue`. */
+interface FormatValueOptions {
+    /** `"auto"` (default) signs negatives only; `"exceptZero"` also writes `+` on positives (for differences). */
+    signDisplay?: "auto" | "exceptZero";
+    /** Round to this many significant digits (e.g. 3 for an estimate: 79,653,985 → 7,970万). */
+    significantDigits?: number;
+}
+/**
+ * The kind of a format, whether it was given as a string or an object. Use it
+ * to branch on the meaning of a metric (e.g. a `percent` metric compares in
+ * points) without unpacking `ValueFormat` yourself.
+ *
+ * @param format - The format as a KpiCard / chart takes it. `undefined` means the default.
+ * @returns The `FormatKind`; `"compact"` when `format` is omitted.
+ *
+ * @example
+ * formatKind("percent")                                // "percent"
+ * formatKind({ type: "currency", notation: "standard" }) // "currency"
+ * formatKind(undefined)                                // "compact"
+ */
+declare function formatKind(format: ValueFormat | undefined): FormatKind;
+/**
+ * Format a number for display — KPI values, table cells, chart labels and
+ * sentences built from data (titles, summaries). See the table at the top of
+ * this module.
+ *
+ * @param value - The number. `null` / `undefined` / `NaN` render as `—`.
+ *   For `percent`, a ratio (0.124 means 12.4%).
+ * @param format - How to display it. Default `"compact"`.
+ * @param locale - BCP 47 locale. Default `"ja-JP"`.
+ * @param options - `signDisplay` and `significantDigits` (rounding for estimates).
+ * @returns The display string. In ja-JP the yen sign is the half-width `¥`.
+ *
+ * @example
+ * formatValue(48_200_000, "currency")                              // "¥4,820万"
+ * formatValue(48_200_000, { type: "currency", notation: "standard" }) // "¥48,200,000"
+ * formatValue(0.021, "percent")                                    // "2.1%"
+ * formatValue(0.124, "percent", "ja-JP", { signDisplay: "exceptZero" }) // "+12.4%"
+ * formatValue(79_653_985, "currency", "ja-JP", { significantDigits: 3 }) // "¥7,970万"
+ * formatValue(48_210, { type: "number", unit: "件" })              // "48,210件"
+ * formatValue(1.5, "multiple")                                     // "1.5×"
+ * formatValue(null)                                                // "—"
+ */
+declare function formatValue(value: number | null | undefined, format?: ValueFormat, locale?: string, options?: FormatValueOptions): string;
+/**
+ * Like `formatValue`, but always signed (except zero) — for a difference
+ * between two values ("+¥530万", "−120件"). Use `formatPoints` instead for a
+ * difference between two rates.
+ *
+ * @param value - The difference (current − previous). Missing values render as `—`.
+ * @param format - Format of the metric itself. Default `"compact"`.
+ * @param locale - BCP 47 locale. Default `"ja-JP"`.
+ * @returns The signed display string; zero has no sign.
+ *
+ * @example
+ * formatDelta(5_300_000, "currency")                 // "+¥530万"
+ * formatDelta(-120, { type: "number", unit: "件" })  // "−120件"
+ * formatDelta(0.031, "percent")                      // "+3.1%"
+ * formatDelta(0, "currency")                         // "¥0"
+ */
+declare function formatDelta(value: number | null | undefined, format?: ValueFormat, locale?: string): string;
+/**
+ * A difference between two rates in percentage points, always signed:
+ * `formatPoints(0.021 - 0.026)` → `"−0.5pt"`. Use it instead of a relative
+ * change for rate metrics (churn, conversion), where "−19.2%" reads as a drop
+ * of nineteen points. `signDisplay: "never"` drops the sign ("あと 0.5pt").
+ *
+ * @param difference - The difference of two **ratios** (0.021 − 0.026). Missing values render as `—`.
+ * @param locale - BCP 47 locale. Default `"ja-JP"`.
+ * @param options - `digits`: fixed fraction digits (default `PERCENT_DIGITS` = 1, so "0.0pt" / "+0.5pt"); `signDisplay`:
+ *   `"exceptZero"` (default) or `"never"` when the sentence already says the direction.
+ * @returns The difference in points with the `pt` suffix.
+ *
+ * @example
+ * formatPoints(0.021 - 0.026)                                   // "−0.5pt"
+ * formatPoints(0.031 - 0.026)                                   // "+0.5pt"
+ * formatPoints(0.02 - 0.015, "ja-JP", { signDisplay: "never" }) // "0.5pt"（「目標まであと 0.5pt」）
+ */
+declare function formatPoints(difference: number | null | undefined, locale?: string, options?: {
+    digits?: number;
+    signDisplay?: "exceptZero" | "never";
+}): string;
+/**
+ * Binds a format and locale into a single-argument formatter, for a chart
+ * `valueFormatter` or a table cell: `valueFormatter={toValueFormatter("currency")}`.
+ * Prefer passing `format` to the chart directly; this is for APIs that only
+ * take a function.
+ *
+ * @param format - How to display each value. Default `"compact"`.
+ * @param locale - BCP 47 locale. Default `"ja-JP"`.
+ * @returns `(value) => string`, rendering missing values as `—`.
+ *
+ * @example
+ * const yen = toValueFormatter("currency")
+ * yen(48_200_000) // "¥4,820万"
+ * yen(null)       // "—"
+ * const count = toValueFormatter({ type: "number", unit: "件" })
+ * count(48_210)   // "48,210件"（表のセル）
+ */
+declare function toValueFormatter(format?: ValueFormat, locale?: string): (value: number | null | undefined) => string;
+/**
+ * 日付の書式。何を表す日付かで選ぶ: 日単位は `"date"`、時刻まで要るなら `"datetime"`、
+ * 月次の集計は `"year-month"`（年をまたぐ軸）か `"month"`（同じ年の中の軸）、年次は `"year"`。
+ */
+type DateStyle = "date" | "datetime" | "month" | "year-month" | "year";
+/** `formatDate` の追加オプション。 */
+interface FormatDateOptions {
+    /**
+     * IANA のタイムゾーン名（例: `"Asia/Tokyo"`）。既定は実行環境のタイムゾーン。
+     * サーバーとブラウザで描画が食い違う（SSR）なら固定する。日付だけの文字列（`"2026-10-20"`）には効かず、常にその暦日のまま出す。
+     */
+    timeZone?: string;
+}
+/**
+ * 日付を表示用の文字列にする。表のセル・タイトル・文に埋める日付に使い、`toLocaleString` や手組みの
+ * `getMonth() + 1` は使わない。
+ *
+ * @param value - `Date`、エポックミリ秒、または日付文字列（`"2026-10-20"`、ISO 8601）。`null` / `undefined` / 解釈できない値は `—`。
+ * @param style - 何を表す日付か。既定 `"date"`。
+ * @param locale - BCP 47 ロケール。既定 `"ja-JP"`。
+ * @param options - `timeZone`。
+ * @returns 表示文字列。
+ *
+ * @example
+ * formatDate("2026-10-20")                         // "2026/10/20"
+ * formatDate(new Date("2026-10-20T05:30:00Z"), "datetime", "ja-JP", { timeZone: "Asia/Tokyo" }) // "2026/10/20 14:30"
+ * formatDate("2026-10-01", "year-month")           // "2026年10月"
+ * formatDate("2026-10-01", "month")                // "10月"
+ * formatDate(null)                                 // "—"
+ */
+declare function formatDate(value: Date | string | number | null | undefined, style?: DateStyle, locale?: string, options?: FormatDateOptions): string;
+/** `formatDateRange` のオプション。 */
+interface FormatDateRangeOptions extends FormatDateOptions {
+    /** BCP 47 ロケール。既定 `"ja-JP"`。 */
+    locale?: string;
+}
+/**
+ * 期間を「2026/9/23〜10/20」の形にする。同じ年なら終了側の年を省き、年をまたぐときは両方に付ける。
+ * 月日はゼロ詰めしない。区切りは日本語で「〜」、それ以外のロケールでは「 – 」。始まりと終わりが同じ日なら 1 日だけ出す。
+ *
+ * @param start - 期間の最初の日（`Date`、エポックミリ秒、日付文字列）。`"2026-09-23"` のような日付だけの文字列はその暦日のまま出す。
+ * @param end - 期間の最後の日。
+ * @param options - `locale` と `timeZone`。
+ * @returns 表示文字列。どちらかが解釈できなければ `—`。
+ *
+ * @example
+ * formatDateRange("2026-09-23", "2026-10-20")  // "2026/9/23〜10/20"
+ * formatDateRange("2025-12-20", "2026-01-18")  // "2025/12/20〜2026/1/18"
+ */
+declare function formatDateRange(start: Date | string | number | null | undefined, end: Date | string | number | null | undefined, options?: FormatDateRangeOptions): string;
+/**
+ * 文中の ISO の年月・日付（`2023-04`、`2026-10-20`）を `formatDate` の書式に置き換える。期間や出典の注記のように、
+ * 利用者が文字列で渡す文に日付が混ざるときの表示用（`"2023-04 以降"` → `"2023年4月 以降"`）。日付でない数字は触らない。
+ *
+ * @param text - 日付を含みうる文。
+ * @param locale - BCP 47 ロケール。既定 `"ja-JP"`。
+ * @returns ISO の年月は `"year-month"`、年月日は `"date"` で整形した文。
+ */
+declare function formatDatesInText(text: string, locale?: string): string;
+
+export { DEFAULT_LOCALE as D, EMPTY_VALUE as E, type FormatDateOptions as F, MINUS_SIGN as M, type ValueFormat as V, type DateStyle as a, type FormatKind as b, type FormatValueOptions as c, formatDateRange as d, formatDatesInText as e, formatDate as f, formatDelta as g, formatKind as h, formatPoints as i, formatValue as j, toValueFormatter as t };

package/dist/markdown/index.js

@@ -1,4 +1,4 @@
-import { cn } from '../chunk-A2UUGASH.js';
+import { cn } from '../chunk-U736PVHY.js';
 import { forwardRef } from 'react';
 import { Streamdown } from 'streamdown';
 import { code } from '@streamdown/code';

package/dist/markdown/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/markdown/index.tsx"],"names":["MarkdownRenderer"],"mappings":";;;;;;;;AAyBO,IAAM,gBAAA,GAAmB,UAAA;AAAA,EAC9B,SAASA,iBAAAA,CAAiB,EAAE,OAAA,EAAS,SAAA,IAAa,GAAA,EAAK;AACrD,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,WAAA,EAAU,mBAAA;AAAA,QACV,SAAA,EAAW,EAAA,CAAG,yBAAA,EAA2B,SAAS,CAAA;AAAA,QAElD,8BAAC,UAAA,EAAA,EAAW,OAAA,EAAS,EAAE,IAAA,IAAS,QAAA,EAAA,OAAA,EAAQ;AAAA;AAAA,KAC1C;AAAA,EAEJ;AACF;AACA,gBAAA,CAAiB,WAAA,GAAc,kBAAA","file":"index.js","sourcesContent":["/**\n * `@squadbase/vantage/markdown` — markdown rendering, on its own subpath.\n *\n * This lives apart from `@squadbase/vantage/components` on purpose. Streamdown\n * bundles Shiki with every language grammar it supports — several hundred\n * chunks and roughly 11 MB of build output. Re-exporting it from the shared\n * `components` barrel would create an import edge that bundlers cannot drop,\n * so every app would emit that payload whether or not it renders markdown.\n * Behind its own entry, only apps that import this pay for it.\n */\nimport { forwardRef } from \"react\"\nimport { Streamdown } from \"streamdown\"\nimport { code } from \"@streamdown/code\"\n\nimport { cn } from \"../ui/cn\"\n\n// Streamdown's own stylesheet. Vite resolves this in the app build; it is\n// scoped to this optional entry, so apps that never import it stay unaffected.\nimport \"streamdown/styles.css\"\n\nexport interface MarkdownRendererProps {\n  content: string\n  className?: string\n}\n\nexport const MarkdownRenderer = forwardRef<HTMLDivElement, MarkdownRendererProps>(\n  function MarkdownRenderer({ content, className }, ref) {\n    return (\n      <div\n        ref={ref}\n        data-slot=\"markdown-renderer\"\n        className={cn(\"text-sm leading-relaxed\", className)}\n      >\n        <Streamdown plugins={{ code }}>{content}</Streamdown>\n      </div>\n    )\n  },\n)\nMarkdownRenderer.displayName = \"MarkdownRenderer\"\n"]}
+{"version":3,"sources":["../../src/markdown/index.tsx"],"names":["MarkdownRenderer"],"mappings":";;;;;;;;AAyBO,IAAM,gBAAA,GAAmB,UAAA;AAAA,EAC9B,SAASA,iBAAAA,CAAiB,EAAE,OAAA,EAAS,SAAA,IAAa,GAAA,EAAK;AACrD,IAAA,uBACE,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,WAAA,EAAU,mBAAA;AAAA,QACV,SAAA,EAAW,EAAA,CAAG,yBAAA,EAA2B,SAAS,CAAA;AAAA,QAElD,8BAAC,UAAA,EAAA,EAAW,OAAA,EAAS,EAAE,IAAA,IAAS,QAAA,EAAA,OAAA,EAAQ;AAAA;AAAA,KAC1C;AAAA,EAEJ;AACF;AACA,gBAAA,CAAiB,WAAA,GAAc,kBAAA","file":"index.js","sourcesContent":["/**\n * `@squadbase/vantage/markdown` — markdown rendering, on its own subpath.\n *\n * This lives apart from `@squadbase/vantage/components` on purpose. Streamdown\n * bundles Shiki with every language grammar it supports — several hundred\n * chunks and roughly 11 MB of build output. Re-exporting it from the shared\n * `components` barrel would create an import edge that bundlers cannot drop,\n * so every app would emit that payload whether or not it renders markdown.\n * Behind its own entry, only apps that import this pay for it.\n */\nimport { forwardRef } from \"react\"\nimport { Streamdown } from \"streamdown\"\nimport { code } from \"@streamdown/code\"\n\nimport { cn } from \"@squadbase/squadkit/lib/utils\"\n\n// Streamdown's own stylesheet. Vite resolves this in the app build; it is\n// scoped to this optional entry, so apps that never import it stay unaffected.\nimport \"streamdown/styles.css\"\n\nexport interface MarkdownRendererProps {\n  content: string\n  className?: string\n}\n\nexport const MarkdownRenderer = forwardRef<HTMLDivElement, MarkdownRendererProps>(\n  function MarkdownRenderer({ content, className }, ref) {\n    return (\n      <div\n        ref={ref}\n        data-slot=\"markdown-renderer\"\n        className={cn(\"text-sm leading-relaxed\", className)}\n      >\n        <Streamdown plugins={{ code }}>{content}</Streamdown>\n      </div>\n    )\n  },\n)\nMarkdownRenderer.displayName = \"MarkdownRenderer\"\n"]}

package/dist/{preview-QDCIVVSR.js → preview-T6CLSQVX.js}

@@ -1,4 +1,4 @@
-import { log, resolvePortOptions, reportPortInUse } from './chunk-3G43C6OL.js';
+import { log, resolvePortOptions, resolveHostOptions, reportPortInUse } from './chunk-GNXCX4WE.js';
 import './chunk-C2CX6GLX.js';
 import fs from 'fs';
 import path from 'path';
@@ -18,6 +18,11 @@ async function preview(root, args) {
     return 1;
   }
   const { port, strictPort } = ports;
+  const hosts = resolveHostOptions(args.flags);
+  if (!hosts.ok) {
+    log.error(hosts.error);
+    return 1;
+  }
   if (manifest.mode === "fullstack") {
     const serverPath = path.join(root, "dist", "server", "index.mjs");
     if (!fs.existsSync(serverPath)) {
@@ -25,6 +30,9 @@ async function preview(root, args) {
       return 1;
     }
     if (!strictPort) log.info("  --no-strict-port has no effect on a fullstack preview");
+    if (Object.keys(hosts.options).length) {
+      log.info("  --host / --allowed-hosts have no effect on a fullstack preview");
+    }
     log.brand(`preview (fullstack) \u2192 http://localhost:${port}`);
     const child = spawn(process.execPath, [serverPath], {
       stdio: "inherit",
@@ -44,7 +52,7 @@ async function preview(root, args) {
       configFile: false,
       root,
       build: { outDir: path.join(root, "dist", "client") },
-      preview: { port, strictPort }
+      preview: { port, strictPort, ...hosts.options }
     });
   } catch (err) {
     if (reportPortInUse(err, port, strictPort)) return 1;
@@ -57,5 +65,5 @@ async function preview(root, args) {
 }
 
 export { preview };
-//# sourceMappingURL=preview-QDCIVVSR.js.map
-//# sourceMappingURL=preview-QDCIVVSR.js.map
+//# sourceMappingURL=preview-T6CLSQVX.js.map
+//# sourceMappingURL=preview-T6CLSQVX.js.map

package/dist/preview-T6CLSQVX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/preview.ts"],"names":[],"mappings":"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","file":"preview-T6CLSQVX.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { spawn } from \"node:child_process\"\nimport {\n  log,\n  reportPortInUse,\n  resolveHostOptions,\n  resolvePortOptions,\n  type ParsedArgs,\n} from \"./util\"\n\n/** `vantage preview` — run the production build locally. */\nexport async function preview(root: string, args: ParsedArgs): Promise<number> {\n  const manifestPath = path.join(root, \"dist\", \"vantage-manifest.json\")\n  if (!fs.existsSync(manifestPath)) {\n    log.error(\"No build found. Run `vantage build` first.\")\n    return 1\n  }\n  const manifest = JSON.parse(fs.readFileSync(manifestPath, \"utf8\")) as { mode: string }\n  const ports = resolvePortOptions(args.flags, 4173)\n  if (!ports.ok) {\n    log.error(ports.error)\n    return 1\n  }\n  const { port, strictPort } = ports\n  const hosts = resolveHostOptions(args.flags)\n  if (!hosts.ok) {\n    log.error(hosts.error)\n    return 1\n  }\n\n  if (manifest.mode === \"fullstack\") {\n    const serverPath = path.join(root, \"dist\", \"server\", \"index.mjs\")\n    if (!fs.existsSync(serverPath)) {\n      log.error(\"Server bundle missing. Re-run `vantage build`.\")\n      return 1\n    }\n    // The production Node server binds exactly one port and exits on EADDRINUSE,\n    // so a fullstack preview is always strict — there is no walk to opt out of.\n    if (!strictPort) log.info(\"  --no-strict-port has no effect on a fullstack preview\")\n    // The Node server listens on every interface and does no Host check, so\n    // there is nothing for these to configure there.\n    if (Object.keys(hosts.options).length) {\n      log.info(\"  --host / --allowed-hosts have no effect on a fullstack preview\")\n    }\n    log.brand(`preview (fullstack) → http://localhost:${port}`)\n    const child = spawn(process.execPath, [serverPath], {\n      stdio: \"inherit\",\n      env: { ...process.env, PORT: String(port) },\n    })\n    return new Promise<number>((resolve) => {\n      child.on(\"exit\", (code) => resolve(code ?? 0))\n      const stop = () => child.kill(\"SIGINT\")\n      process.on(\"SIGINT\", stop)\n      process.on(\"SIGTERM\", stop)\n    })\n  }\n\n  // SPA-only preview via Vite's static preview server.\n  const { preview: vitePreview } = await import(\"vite\")\n  let server: Awaited<ReturnType<typeof vitePreview>>\n  try {\n    server = await vitePreview({\n      configFile: false,\n      root,\n      build: { outDir: path.join(root, \"dist\", \"client\") },\n      preview: { port, strictPort, ...hosts.options },\n    })\n  } catch (err) {\n    if (reportPortInUse(err, port, strictPort)) return 1\n    throw err\n  }\n  log.brand(\"preview (spa)\")\n  server.printUrls()\n  return new Promise<number>(() => {})\n}\n"]}

package/dist/query/index.d.ts

@@ -8,17 +8,6 @@ export { QueryClient, QueryKey, UseInfiniteQueryOptions, UseMutationOptions, Use
  */
 declare function createQueryClient(): QueryClient;
 
-/**
- * The one seam for calling the API from client code. All `/api/*` requests go
- * through here so a split deployment (client on S3/CloudFront, server on Lambda)
- * can point the client at a different origin without touching page code.
- *
- * The base is read from `import.meta.env.PUBLIC_API_BASE_URL` — a `PUBLIC_`
- * prefixed var so it is inlined into the client bundle (see envPrefix in the
- * Vite plugin). It can be set in `.env` or injected at build time via
- * `vantage build --api-base-url <url>`. When unset it is empty, so requests stay
- * same-origin relative paths — identical to hand-written `fetch("/api/...")`.
- */
 /** The configured API base URL (no trailing slash), or "" for same-origin. */
 declare function apiBaseUrl(): string;
 /**

package/dist/query/index.js

@@ -1,4 +1,4 @@
-export { ApiError, QueryClient, apiBaseUrl, apiFetch, apiJson, apiPath, apiUrl, keepPreviousData, useApiMutation, useApiQuery, useInfiniteQuery, useIsFetching, useIsMutating, useMutation, useQueries, useQuery, useQueryClient } from '../chunk-PVTHHV7X.js';
-export { createQueryClient } from '../chunk-DTDVSFRY.js';
+export { ApiError, QueryClient, apiBaseUrl, apiFetch, apiJson, apiPath, apiUrl, keepPreviousData, useApiMutation, useApiQuery, useInfiniteQuery, useIsFetching, useIsMutating, useMutation, useQueries, useQuery, useQueryClient } from '../chunk-V3LF7BE7.js';
+export { createQueryClient } from '../chunk-XQUSGIDG.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{routes-RHP5FVGD.js → routes-3SGAFDMC.js}

@@ -1,7 +1,7 @@
-import { extractPageSpec, extractApiSpec } from './chunk-JGRMRXXZ.js';
-import './chunk-KLEIVDUV.js';
-import { scanProject } from './chunk-ZVANIULZ.js';
-import { printJson } from './chunk-3G43C6OL.js';
+import { extractPageSpec, extractApiSpec } from './chunk-JKLLFVEU.js';
+import './chunk-CEXAQQ5W.js';
+import { scanProject } from './chunk-RNTDBX6S.js';
+import { printJson } from './chunk-GNXCX4WE.js';
 import './chunk-C2CX6GLX.js';
 import pc from 'picocolors';
 
@@ -124,5 +124,5 @@ async function routes(root, args) {
 }
 
 export { routes };
-//# sourceMappingURL=routes-RHP5FVGD.js.map
-//# sourceMappingURL=routes-RHP5FVGD.js.map
+//# sourceMappingURL=routes-3SGAFDMC.js.map
+//# sourceMappingURL=routes-3SGAFDMC.js.map

package/dist/{routes-RHP5FVGD.js.map → routes-3SGAFDMC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/routes.ts"],"names":[],"mappings":"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","file":"routes-RHP5FVGD.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  extractApiSpec,\n  extractPageSpec,\n  type ApiMethodSpec,\n  type PageSpec,\n  type RouteParam,\n} from \"../core/route-spec\"\nimport { scanProject } from \"../core/scan\"\nimport type { ApiRoute, PageRoute, RouteModel } from \"../core/types\"\nimport { printJson, type ParsedArgs } from \"./util\"\n\nconst ROUTE_COLUMN = 28\nconst LABEL_COLUMN = 9\n\n/** Print an indented `label  value` line under a route. */\nfunction detailLine(indent: string, label: string, value: string): void {\n  console.log(`${indent}${pc.dim(label.padEnd(LABEL_COLUMN))}${value}`)\n}\n\n/** Render params as `:id`, `*rest`. */\nfunction formatParams(params: RouteParam[]): string {\n  return params.map((p) => (p.kind === \"catchall\" ? `*${p.name}` : `:${p.name}`)).join(\", \")\n}\n\nfunction formatKeys(keys: string[] | undefined): string {\n  return keys?.length ? ` { ${keys.join(\", \")} }` : \"\"\n}\n\nfunction printPageSpec(spec: PageSpec): void {\n  const indent = \"      \"\n  if (spec.title) detailLine(indent, \"title\", spec.title)\n  if (spec.navLabel) detailLine(indent, \"nav\", spec.navLabel)\n  if (spec.description) detailLine(indent, \"desc\", spec.description)\n  if (spec.params.length) detailLine(indent, \"params\", formatParams(spec.params))\n}\n\nfunction printApiMethodSpec(method: ApiMethodSpec, params: RouteParam[]): void {\n  const indent = \"        \"\n  console.log(`      ${pc.bold(method.method)}`)\n  if (params.length) detailLine(indent, \"path\", formatParams(params))\n  if (method.query.length) detailLine(indent, \"query\", method.query.join(\", \"))\n  if (method.body) detailLine(indent, \"body\", method.body.format + formatKeys(method.body.keys))\n  for (const res of method.responses) {\n    const parts = [String(res.status), res.contentType].filter(Boolean).join(\" \")\n    detailLine(indent, \"response\", parts + formatKeys(res.keys))\n  }\n  for (const err of method.errors) {\n    detailLine(indent, \"error\", `${err.status}${err.message ? ` \"${err.message}\"` : \"\"}`)\n  }\n}\n\n/**\n * How a page is rendered, when it is not the plain case. Without this a\n * `.slide.tsx` and a `.tsx` that resolve to the same URL look identical here,\n * and the whole point of `routes` is to show what the scan understood.\n */\nfunction pageBadge(page: PageRoute): string {\n  if (page.kind === \"file\") return pc.magenta(` (${(page.fileExt ?? \"\").slice(1)})`)\n  if (page.variant) return pc.magenta(` (${page.variant})`)\n  return \"\"\n}\n\nfunction printPages(model: RouteModel, detail: boolean): void {\n  console.log(pc.bold(\"\\nPages\"))\n  if (model.pages.length === 0) console.log(pc.dim(\"  (none)\"))\n  for (const p of model.pages) {\n    console.log(`  ${pc.green(p.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(p.file)}${pageBadge(p)}`)\n    if (detail) printPageSpec(extractPageSpec(p))\n  }\n\n  if (model.layouts.length || model.notFound || model.error) {\n    console.log(pc.bold(\"\\nSpecial\"))\n    for (const l of model.layouts) {\n      const label = \"layout \" + (l.dir === \"\" ? \"/\" : \"/\" + l.dir)\n      console.log(`  ${pc.cyan(label.padEnd(ROUTE_COLUMN))} ${pc.dim(l.file)}`)\n    }\n    if (model.notFound) console.log(`  ${pc.cyan(\"404\".padEnd(ROUTE_COLUMN))} ${pc.dim(model.notFound)}`)\n    if (model.error) console.log(`  ${pc.cyan(\"error\".padEnd(ROUTE_COLUMN))} ${pc.dim(model.error)}`)\n  }\n}\n\nfunction printApis(model: RouteModel, detail: boolean): void {\n  console.log(pc.bold(\"\\nAPI\"))\n  if (!model.hasServer) {\n    console.log(pc.dim(\"  (none — this project has no server/ directory)\"))\n    return\n  }\n  if (model.apis.length === 0) console.log(pc.dim(\"  (none)\"))\n  for (const a of model.apis) {\n    console.log(`  ${pc.yellow(a.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(a.file)}`)\n    if (!detail) continue\n    const spec = extractApiSpec(a)\n    if (spec.methods.length === 0) console.log(`      ${pc.dim(\"(no HTTP method handler exported)\")}`)\n    for (const method of spec.methods) printApiMethodSpec(method, spec.params)\n  }\n}\n\nfunction pageJson(p: PageRoute, detail: boolean) {\n  return {\n    route: p.routePath,\n    file: p.file,\n    dynamic: p.dynamic,\n    kind: p.kind,\n    ...(p.fileExt ? { fileExt: p.fileExt } : {}),\n    ...(p.variant ? { variant: p.variant } : {}),\n    ...(detail ? { spec: extractPageSpec(p) } : {}),\n  }\n}\n\nfunction apiJson(a: ApiRoute, detail: boolean) {\n  return {\n    route: a.routePath,\n    file: a.file,\n    params: a.params,\n    ...(detail ? { spec: extractApiSpec(a) } : {}),\n  }\n}\n\n/**\n * `vantage routes` — show the page and API URL map.\n * `--pages` / `--apis` narrow the map to one side; `--detail` adds the static\n * spec of each route (page path params + definePage meta, API methods with\n * their request input and response shape).\n */\nexport async function routes(root: string, args: ParsedArgs): Promise<number> {\n  const model = scanProject(root)\n  const onlyPages = Boolean(args.flags.pages)\n  const onlyApis = Boolean(args.flags.apis)\n  // Neither flag (or both) means \"everything\", so the two are never exclusive.\n  const showPages = onlyPages || !onlyApis\n  const showApis = onlyApis || !onlyPages\n  const detail = Boolean(args.flags.detail)\n\n  if (args.flags.json) {\n    const payload: Record<string, unknown> = {}\n    if (showPages) {\n      payload.pages = model.pages.map((p) => pageJson(p, detail))\n      payload.layouts = model.layouts.map((l) => ({ dir: l.dir === \"\" ? \"/\" : l.dir, file: l.file }))\n      payload.notFound = model.notFound\n      payload.error = model.error\n      // Files the scan skipped. `check` explains them; listing them here means\n      // an agent reading `routes --json` sees them without a second command.\n      payload.unrouted = model.unrouted\n    }\n    if (showApis) {\n      payload.apis = model.apis.map((a) => apiJson(a, detail))\n      payload.hasServer = model.hasServer\n    }\n    printJson(payload)\n    return 0\n  }\n\n  if (showPages) printPages(model, detail)\n  // Without --apis, an API-less project stays silent (nothing to say about it).\n  if (showApis && (model.hasServer || onlyApis)) printApis(model, detail)\n  console.log(\"\")\n  return 0\n}\n"]}
+{"version":3,"sources":["../src/cli/routes.ts"],"names":[],"mappings":"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","file":"routes-3SGAFDMC.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  extractApiSpec,\n  extractPageSpec,\n  type ApiMethodSpec,\n  type PageSpec,\n  type RouteParam,\n} from \"../core/route-spec\"\nimport { scanProject } from \"../core/scan\"\nimport type { ApiRoute, PageRoute, RouteModel } from \"../core/types\"\nimport { printJson, type ParsedArgs } from \"./util\"\n\nconst ROUTE_COLUMN = 28\nconst LABEL_COLUMN = 9\n\n/** Print an indented `label  value` line under a route. */\nfunction detailLine(indent: string, label: string, value: string): void {\n  console.log(`${indent}${pc.dim(label.padEnd(LABEL_COLUMN))}${value}`)\n}\n\n/** Render params as `:id`, `*rest`. */\nfunction formatParams(params: RouteParam[]): string {\n  return params.map((p) => (p.kind === \"catchall\" ? `*${p.name}` : `:${p.name}`)).join(\", \")\n}\n\nfunction formatKeys(keys: string[] | undefined): string {\n  return keys?.length ? ` { ${keys.join(\", \")} }` : \"\"\n}\n\nfunction printPageSpec(spec: PageSpec): void {\n  const indent = \"      \"\n  if (spec.title) detailLine(indent, \"title\", spec.title)\n  if (spec.navLabel) detailLine(indent, \"nav\", spec.navLabel)\n  if (spec.description) detailLine(indent, \"desc\", spec.description)\n  if (spec.params.length) detailLine(indent, \"params\", formatParams(spec.params))\n}\n\nfunction printApiMethodSpec(method: ApiMethodSpec, params: RouteParam[]): void {\n  const indent = \"        \"\n  console.log(`      ${pc.bold(method.method)}`)\n  if (params.length) detailLine(indent, \"path\", formatParams(params))\n  if (method.query.length) detailLine(indent, \"query\", method.query.join(\", \"))\n  if (method.body) detailLine(indent, \"body\", method.body.format + formatKeys(method.body.keys))\n  for (const res of method.responses) {\n    const parts = [String(res.status), res.contentType].filter(Boolean).join(\" \")\n    detailLine(indent, \"response\", parts + formatKeys(res.keys))\n  }\n  for (const err of method.errors) {\n    detailLine(indent, \"error\", `${err.status}${err.message ? ` \"${err.message}\"` : \"\"}`)\n  }\n}\n\n/**\n * How a page is rendered, when it is not the plain case. Without this a\n * `.slide.tsx` and a `.tsx` that resolve to the same URL look identical here,\n * and the whole point of `routes` is to show what the scan understood.\n */\nfunction pageBadge(page: PageRoute): string {\n  if (page.kind === \"file\") return pc.magenta(` (${(page.fileExt ?? \"\").slice(1)})`)\n  if (page.variant) return pc.magenta(` (${page.variant})`)\n  return \"\"\n}\n\nfunction printPages(model: RouteModel, detail: boolean): void {\n  console.log(pc.bold(\"\\nPages\"))\n  if (model.pages.length === 0) console.log(pc.dim(\"  (none)\"))\n  for (const p of model.pages) {\n    console.log(`  ${pc.green(p.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(p.file)}${pageBadge(p)}`)\n    if (detail) printPageSpec(extractPageSpec(p))\n  }\n\n  if (model.layouts.length || model.notFound || model.error) {\n    console.log(pc.bold(\"\\nSpecial\"))\n    for (const l of model.layouts) {\n      const label = \"layout \" + (l.dir === \"\" ? \"/\" : \"/\" + l.dir)\n      console.log(`  ${pc.cyan(label.padEnd(ROUTE_COLUMN))} ${pc.dim(l.file)}`)\n    }\n    if (model.notFound) console.log(`  ${pc.cyan(\"404\".padEnd(ROUTE_COLUMN))} ${pc.dim(model.notFound)}`)\n    if (model.error) console.log(`  ${pc.cyan(\"error\".padEnd(ROUTE_COLUMN))} ${pc.dim(model.error)}`)\n  }\n}\n\nfunction printApis(model: RouteModel, detail: boolean): void {\n  console.log(pc.bold(\"\\nAPI\"))\n  if (!model.hasServer) {\n    console.log(pc.dim(\"  (none — this project has no server/ directory)\"))\n    return\n  }\n  if (model.apis.length === 0) console.log(pc.dim(\"  (none)\"))\n  for (const a of model.apis) {\n    console.log(`  ${pc.yellow(a.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(a.file)}`)\n    if (!detail) continue\n    const spec = extractApiSpec(a)\n    if (spec.methods.length === 0) console.log(`      ${pc.dim(\"(no HTTP method handler exported)\")}`)\n    for (const method of spec.methods) printApiMethodSpec(method, spec.params)\n  }\n}\n\nfunction pageJson(p: PageRoute, detail: boolean) {\n  return {\n    route: p.routePath,\n    file: p.file,\n    dynamic: p.dynamic,\n    kind: p.kind,\n    ...(p.fileExt ? { fileExt: p.fileExt } : {}),\n    ...(p.variant ? { variant: p.variant } : {}),\n    ...(detail ? { spec: extractPageSpec(p) } : {}),\n  }\n}\n\nfunction apiJson(a: ApiRoute, detail: boolean) {\n  return {\n    route: a.routePath,\n    file: a.file,\n    params: a.params,\n    ...(detail ? { spec: extractApiSpec(a) } : {}),\n  }\n}\n\n/**\n * `vantage routes` — show the page and API URL map.\n * `--pages` / `--apis` narrow the map to one side; `--detail` adds the static\n * spec of each route (page path params + definePage meta, API methods with\n * their request input and response shape).\n */\nexport async function routes(root: string, args: ParsedArgs): Promise<number> {\n  const model = scanProject(root)\n  const onlyPages = Boolean(args.flags.pages)\n  const onlyApis = Boolean(args.flags.apis)\n  // Neither flag (or both) means \"everything\", so the two are never exclusive.\n  const showPages = onlyPages || !onlyApis\n  const showApis = onlyApis || !onlyPages\n  const detail = Boolean(args.flags.detail)\n\n  if (args.flags.json) {\n    const payload: Record<string, unknown> = {}\n    if (showPages) {\n      payload.pages = model.pages.map((p) => pageJson(p, detail))\n      payload.layouts = model.layouts.map((l) => ({ dir: l.dir === \"\" ? \"/\" : l.dir, file: l.file }))\n      payload.notFound = model.notFound\n      payload.error = model.error\n      // Files the scan skipped. `check` explains them; listing them here means\n      // an agent reading `routes --json` sees them without a second command.\n      payload.unrouted = model.unrouted\n    }\n    if (showApis) {\n      payload.apis = model.apis.map((a) => apiJson(a, detail))\n      payload.hasServer = model.hasServer\n    }\n    printJson(payload)\n    return 0\n  }\n\n  if (showPages) printPages(model, detail)\n  // Without --apis, an API-less project stays silent (nothing to say about it).\n  if (showApis && (model.hasServer || onlyApis)) printApis(model, detail)\n  console.log(\"\")\n  return 0\n}\n"]}

package/dist/{search-RFBELGY7.js → search-5LC4XPB5.js}

@@ -1,5 +1,5 @@
 import { loadCatalog, isDocLang, DOC_LANGS, DEFAULT_DOC_LANG, docsForLang, readDoc } from './chunk-2KRCGXBY.js';
-import { log, printJson } from './chunk-3G43C6OL.js';
+import { log, printJson } from './chunk-GNXCX4WE.js';
 import './chunk-C2CX6GLX.js';
 import pc from 'picocolors';
 
@@ -321,5 +321,5 @@ async function search(_root, args) {
 }
 
 export { search };
-//# sourceMappingURL=search-RFBELGY7.js.map
-//# sourceMappingURL=search-RFBELGY7.js.map
+//# sourceMappingURL=search-5LC4XPB5.js.map
+//# sourceMappingURL=search-5LC4XPB5.js.map