@squadbase/vantage 0.2.3 → 0.3.1

package/dist/doctor-N6JMEWKT.js

@@ -0,0 +1,58 @@
+import { runDiagnostics } from './chunk-PSEYFYAP.js';
+import './chunk-BAM33YZ6.js';
+import './chunk-VXAV2435.js';
+import { scanProject } from './chunk-D4Y5RWJA.js';
+import { printJson, frameworkVersion, log } from './chunk-OFFJ3OL5.js';
+import './chunk-C4MQRWXS.js';
+import fs from 'fs';
+import path from 'path';
+import { createRequire } from 'module';
+
+// @squadbase/vantage — generated build. Do not edit.
+async function doctor(root, args) {
+  const facets = [];
+  const nodeMajor = Number(process.versions.node.split(".")[0]);
+  facets.push({
+    name: "node",
+    ok: nodeMajor >= 20,
+    detail: `v${process.versions.node}${nodeMajor >= 20 ? "" : " (requires >= 20)"}`
+  });
+  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 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";
+  let vantageOk = false;
+  try {
+    const require2 = createRequire(path.join(root, "noop.js"));
+    const p = require2.resolve("@squadbase/vantage/package.json");
+    installedVantage = JSON.parse(fs.readFileSync(p, "utf8")).version;
+    vantageOk = true;
+  } catch {
+  }
+  facets.push({ name: "@squadbase/vantage", ok: vantageOk, detail: installedVantage });
+  const model = scanProject(root);
+  const errors = runDiagnostics(root, model).filter((d) => d.severity === "error");
+  facets.push({
+    name: "project",
+    ok: errors.length === 0,
+    detail: errors.length === 0 ? "no blocking errors" : `${errors.length} error(s) (run \`vantage check\`)`
+  });
+  const allOk = facets.every((f) => f.ok);
+  if (args.flags.json) {
+    printJson({ ok: allOk, cli: frameworkVersion(), facets });
+    return allOk ? 0 : 1;
+  }
+  log.brand(`doctor (cli v${frameworkVersion()})`);
+  for (const f of facets) {
+    const line = `${f.name.padEnd(22)} ${f.detail}`;
+    if (f.ok) log.ok(line);
+    else log.error(line);
+  }
+  return allOk ? 0 : 1;
+}
+
+export { doctor };
+//# sourceMappingURL=doctor-N6JMEWKT.js.map
+//# sourceMappingURL=doctor-N6JMEWKT.js.map

package/dist/doctor-N6JMEWKT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/doctor.ts"],"names":["require"],"mappings":"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","file":"doctor-N6JMEWKT.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 = [\"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/index.d.ts

@@ -10,6 +10,6 @@ import 'react';
  */
 
 /** Framework version, kept in sync with package.json at build time. */
-declare const VERSION = "0.2.3";
+declare const VERSION = "0.3.1";
 
 export { VERSION };

package/dist/index.js

@@ -6,7 +6,7 @@ function definePage(config) {
 }
 
 // src/index.ts
-var VERSION = "0.2.3";
+var VERSION = "0.3.1";
 
 export { VERSION, definePage };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/define-page.ts","../src/index.ts"],"names":[],"mappings":";;;AAyCO,SAAS,WAAW,MAAA,EAAgC;AACzD,EAAA,OAAO,MAAA;AACT;;;AChCO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["import type { ComponentType, ReactNode } from \"react\"\n\n/**\n * Optional per-page configuration. The only required part of a page module is\n * its default-exported component; `definePage` covers everything else.\n */\nexport interface PageConfig {\n  /** Document title applied when this route is active. */\n  title?: string\n  /** Description metadata for the page. */\n  description?: string\n  /**\n   * Short label for navigation built from `useRoutes()`. Defaults to `title`,\n   * which is often too long for a nav (\"Overview · Acme Analytics\").\n   */\n  navLabel?: string\n  /**\n   * Component rendered while the route is loading.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  pendingComponent?: ComponentType\n  /**\n   * Component rendered when the route throws.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  errorComponent?: ComponentType<{ error: unknown }>\n  /**\n   * Validate/transform the URL search params for this route.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  validateSearch?: (search: Record<string, unknown>) => Record<string, unknown>\n}\n\n/**\n * Declare optional page configuration.\n *\n * ```tsx\n * export const page = definePage({ title: \"Monthly Analysis\" })\n * export default function MonthlyAnalysis() { return <div/> }\n * ```\n */\nexport function definePage(config: PageConfig): PageConfig {\n  return config\n}\n\n/** Convenience type for a Vantage page component. */\nexport type PageComponent = ComponentType & { (): ReactNode }\n","/**\n * `@squadbase/vantage` — public runtime surface.\n *\n * The only import most pages need. Server state lives in\n * `@squadbase/vantage/query`, navigation in `@squadbase/vantage/router`,\n * UI in `@squadbase/vantage/ui`, and API types in `@squadbase/vantage/server`.\n */\nexport { definePage } from \"./runtime/define-page\"\nexport type { PageConfig, PageComponent } from \"./runtime/define-page\"\n\n/** Framework version, kept in sync with package.json at build time. */\nexport const VERSION = \"0.2.3\"\n"]}
+{"version":3,"sources":["../src/runtime/define-page.ts","../src/index.ts"],"names":[],"mappings":";;;AAyCO,SAAS,WAAW,MAAA,EAAgC;AACzD,EAAA,OAAO,MAAA;AACT;;;AChCO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["import type { ComponentType, ReactNode } from \"react\"\n\n/**\n * Optional per-page configuration. The only required part of a page module is\n * its default-exported component; `definePage` covers everything else.\n */\nexport interface PageConfig {\n  /** Document title applied when this route is active. */\n  title?: string\n  /** Description metadata for the page. */\n  description?: string\n  /**\n   * Short label for navigation built from `useRoutes()`. Defaults to `title`,\n   * which is often too long for a nav (\"Overview · Acme Analytics\").\n   */\n  navLabel?: string\n  /**\n   * Component rendered while the route is loading.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  pendingComponent?: ComponentType\n  /**\n   * Component rendered when the route throws.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  errorComponent?: ComponentType<{ error: unknown }>\n  /**\n   * Validate/transform the URL search params for this route.\n   * (Reserved — not yet applied to Vantage's code-split routes in the prototype.)\n   */\n  validateSearch?: (search: Record<string, unknown>) => Record<string, unknown>\n}\n\n/**\n * Declare optional page configuration.\n *\n * ```tsx\n * export const page = definePage({ title: \"Monthly Analysis\" })\n * export default function MonthlyAnalysis() { return <div/> }\n * ```\n */\nexport function definePage(config: PageConfig): PageConfig {\n  return config\n}\n\n/** Convenience type for a Vantage page component. */\nexport type PageComponent = ComponentType & { (): ReactNode }\n","/**\n * `@squadbase/vantage` — public runtime surface.\n *\n * The only import most pages need. Server state lives in\n * `@squadbase/vantage/query`, navigation in `@squadbase/vantage/router`,\n * UI in `@squadbase/vantage/ui`, and API types in `@squadbase/vantage/server`.\n */\nexport { definePage } from \"./runtime/define-page\"\nexport type { PageConfig, PageComponent } from \"./runtime/define-page\"\n\n/** Framework version, kept in sync with package.json at build time. */\nexport const VERSION = \"0.3.1\"\n"]}

package/dist/preview-CLALOEFE.js

@@ -0,0 +1,49 @@
+import { log, parsePort } from './chunk-OFFJ3OL5.js';
+import './chunk-C4MQRWXS.js';
+import fs from 'fs';
+import path from 'path';
+import { spawn } from 'child_process';
+
+// @squadbase/vantage — generated build. Do not edit.
+async function preview(root, args) {
+  const manifestPath = path.join(root, "dist", "vantage-manifest.json");
+  if (!fs.existsSync(manifestPath)) {
+    log.error("No build found. Run `vantage build` first.");
+    return 1;
+  }
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  const port = parsePort(args.flags.port, 4173);
+  if (manifest.mode === "fullstack") {
+    const serverPath = path.join(root, "dist", "server", "index.mjs");
+    if (!fs.existsSync(serverPath)) {
+      log.error("Server bundle missing. Re-run `vantage build`.");
+      return 1;
+    }
+    log.brand(`preview (fullstack) \u2192 http://localhost:${port}`);
+    const child = spawn(process.execPath, [serverPath], {
+      stdio: "inherit",
+      env: { ...process.env, PORT: String(port) }
+    });
+    return new Promise((resolve) => {
+      child.on("exit", (code) => resolve(code ?? 0));
+      const stop = () => child.kill("SIGINT");
+      process.on("SIGINT", stop);
+      process.on("SIGTERM", stop);
+    });
+  }
+  const { preview: vitePreview } = await import('vite');
+  const server = await vitePreview({
+    configFile: false,
+    root,
+    build: { outDir: path.join(root, "dist", "client") },
+    preview: { port }
+  });
+  log.brand("preview (spa)");
+  server.printUrls();
+  return new Promise(() => {
+  });
+}
+
+export { preview };
+//# sourceMappingURL=preview-CLALOEFE.js.map
+//# sourceMappingURL=preview-CLALOEFE.js.map

package/dist/preview-CLALOEFE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/preview.ts"],"names":[],"mappings":";;;;;;;AAMA,eAAsB,OAAA,CAAQ,MAAc,IAAA,EAAmC;AAC7E,EAAA,MAAM,YAAA,GAAe,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,QAAQ,uBAAuB,CAAA;AACpE,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,YAAY,CAAA,EAAG;AAChC,IAAA,GAAA,CAAI,MAAM,4CAA4C,CAAA;AACtD,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,MAAM,WAAW,IAAA,CAAK,KAAA,CAAM,GAAG,YAAA,CAAa,YAAA,EAAc,MAAM,CAAC,CAAA;AACjE,EAAA,MAAM,IAAA,GAAO,SAAA,CAAU,IAAA,CAAK,KAAA,CAAM,MAAM,IAAI,CAAA;AAE5C,EAAA,IAAI,QAAA,CAAS,SAAS,WAAA,EAAa;AACjC,IAAA,MAAM,aAAa,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,MAAA,EAAQ,UAAU,WAAW,CAAA;AAChE,IAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,UAAU,CAAA,EAAG;AAC9B,MAAA,GAAA,CAAI,MAAM,gDAAgD,CAAA;AAC1D,MAAA,OAAO,CAAA;AAAA,IACT;AACA,IAAA,GAAA,CAAI,KAAA,CAAM,CAAA,4CAAA,EAA0C,IAAI,CAAA,CAAE,CAAA;AAC1D,IAAA,MAAM,QAAQ,KAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,CAAC,UAAU,CAAA,EAAG;AAAA,MAClD,KAAA,EAAO,SAAA;AAAA,MACP,GAAA,EAAK,EAAE,GAAG,OAAA,CAAQ,KAAK,IAAA,EAAM,MAAA,CAAO,IAAI,CAAA;AAAE,KAC3C,CAAA;AACD,IAAA,OAAO,IAAI,OAAA,CAAgB,CAAC,OAAA,KAAY;AACtC,MAAA,KAAA,CAAM,GAAG,MAAA,EAAQ,CAAC,SAAS,OAAA,CAAQ,IAAA,IAAQ,CAAC,CAAC,CAAA;AAC7C,MAAA,MAAM,IAAA,GAAO,MAAM,KAAA,CAAM,IAAA,CAAK,QAAQ,CAAA;AACtC,MAAA,OAAA,CAAQ,EAAA,CAAG,UAAU,IAAI,CAAA;AACzB,MAAA,OAAA,CAAQ,EAAA,CAAG,WAAW,IAAI,CAAA;AAAA,IAC5B,CAAC,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,EAAE,OAAA,EAAS,WAAA,EAAY,GAAI,MAAM,OAAO,MAAM,CAAA;AACpD,EAAA,MAAM,MAAA,GAAS,MAAM,WAAA,CAAY;AAAA,IAC/B,UAAA,EAAY,KAAA;AAAA,IACZ,IAAA;AAAA,IACA,KAAA,EAAO,EAAE,MAAA,EAAQ,IAAA,CAAK,KAAK,IAAA,EAAM,MAAA,EAAQ,QAAQ,CAAA,EAAE;AAAA,IACnD,OAAA,EAAS,EAAE,IAAA;AAAK,GACjB,CAAA;AACD,EAAA,GAAA,CAAI,MAAM,eAAe,CAAA;AACzB,EAAA,MAAA,CAAO,SAAA,EAAU;AACjB,EAAA,OAAO,IAAI,QAAgB,MAAM;AAAA,EAAC,CAAC,CAAA;AACrC","file":"preview-CLALOEFE.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { spawn } from \"node:child_process\"\nimport { log, parsePort, type ParsedArgs } 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 port = parsePort(args.flags.port, 4173)\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    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  const server = await vitePreview({\n    configFile: false,\n    root,\n    build: { outDir: path.join(root, \"dist\", \"client\") },\n    preview: { port },\n  })\n  log.brand(\"preview (spa)\")\n  server.printUrls()\n  return new Promise<number>(() => {})\n}\n"]}

package/dist/routes-YI25MKPF.js

@@ -0,0 +1,119 @@
+import { extractPageSpec, extractApiSpec } from './chunk-BAM33YZ6.js';
+import './chunk-VXAV2435.js';
+import { scanProject } from './chunk-D4Y5RWJA.js';
+import { printJson } from './chunk-OFFJ3OL5.js';
+import './chunk-C4MQRWXS.js';
+import pc from 'picocolors';
+
+// @squadbase/vantage — generated build. Do not edit.
+var ROUTE_COLUMN = 28;
+var LABEL_COLUMN = 9;
+function detailLine(indent, label, value) {
+  console.log(`${indent}${pc.dim(label.padEnd(LABEL_COLUMN))}${value}`);
+}
+function formatParams(params) {
+  return params.map((p) => p.kind === "catchall" ? `*${p.name}` : `:${p.name}`).join(", ");
+}
+function formatKeys(keys) {
+  return keys?.length ? ` { ${keys.join(", ")} }` : "";
+}
+function printPageSpec(spec) {
+  const indent = "      ";
+  if (spec.title) detailLine(indent, "title", spec.title);
+  if (spec.navLabel) detailLine(indent, "nav", spec.navLabel);
+  if (spec.description) detailLine(indent, "desc", spec.description);
+  if (spec.params.length) detailLine(indent, "params", formatParams(spec.params));
+}
+function printApiMethodSpec(method, params) {
+  const indent = "        ";
+  console.log(`      ${pc.bold(method.method)}`);
+  if (params.length) detailLine(indent, "path", formatParams(params));
+  if (method.query.length) detailLine(indent, "query", method.query.join(", "));
+  if (method.body) detailLine(indent, "body", method.body.format + formatKeys(method.body.keys));
+  for (const res of method.responses) {
+    const parts = [String(res.status), res.contentType].filter(Boolean).join(" ");
+    detailLine(indent, "response", parts + formatKeys(res.keys));
+  }
+  for (const err of method.errors) {
+    detailLine(indent, "error", `${err.status}${err.message ? ` "${err.message}"` : ""}`);
+  }
+}
+function printPages(model, detail) {
+  console.log(pc.bold("\nPages"));
+  if (model.pages.length === 0) console.log(pc.dim("  (none)"));
+  for (const p of model.pages) {
+    console.log(`  ${pc.green(p.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(p.file)}`);
+    if (detail) printPageSpec(extractPageSpec(p));
+  }
+  if (model.layouts.length || model.notFound || model.error) {
+    console.log(pc.bold("\nSpecial"));
+    for (const l of model.layouts) {
+      const label = "layout " + (l.dir === "" ? "/" : "/" + l.dir);
+      console.log(`  ${pc.cyan(label.padEnd(ROUTE_COLUMN))} ${pc.dim(l.file)}`);
+    }
+    if (model.notFound) console.log(`  ${pc.cyan("404".padEnd(ROUTE_COLUMN))} ${pc.dim(model.notFound)}`);
+    if (model.error) console.log(`  ${pc.cyan("error".padEnd(ROUTE_COLUMN))} ${pc.dim(model.error)}`);
+  }
+}
+function printApis(model, detail) {
+  console.log(pc.bold("\nAPI"));
+  if (!model.hasServer) {
+    console.log(pc.dim("  (none \u2014 this project has no server/ directory)"));
+    return;
+  }
+  if (model.apis.length === 0) console.log(pc.dim("  (none)"));
+  for (const a of model.apis) {
+    console.log(`  ${pc.yellow(a.routePath.padEnd(ROUTE_COLUMN))} ${pc.dim(a.file)}`);
+    if (!detail) continue;
+    const spec = extractApiSpec(a);
+    if (spec.methods.length === 0) console.log(`      ${pc.dim("(no HTTP method handler exported)")}`);
+    for (const method of spec.methods) printApiMethodSpec(method, spec.params);
+  }
+}
+function pageJson(p, detail) {
+  return {
+    route: p.routePath,
+    file: p.file,
+    dynamic: p.dynamic,
+    ...detail ? { spec: extractPageSpec(p) } : {}
+  };
+}
+function apiJson(a, detail) {
+  return {
+    route: a.routePath,
+    file: a.file,
+    params: a.params,
+    ...detail ? { spec: extractApiSpec(a) } : {}
+  };
+}
+async function routes(root, args) {
+  const model = scanProject(root);
+  const onlyPages = Boolean(args.flags.pages);
+  const onlyApis = Boolean(args.flags.apis);
+  const showPages = onlyPages || !onlyApis;
+  const showApis = onlyApis || !onlyPages;
+  const detail = Boolean(args.flags.detail);
+  if (args.flags.json) {
+    const payload = {};
+    if (showPages) {
+      payload.pages = model.pages.map((p) => pageJson(p, detail));
+      payload.layouts = model.layouts.map((l) => ({ dir: l.dir === "" ? "/" : l.dir, file: l.file }));
+      payload.notFound = model.notFound;
+      payload.error = model.error;
+    }
+    if (showApis) {
+      payload.apis = model.apis.map((a) => apiJson(a, detail));
+      payload.hasServer = model.hasServer;
+    }
+    printJson(payload);
+    return 0;
+  }
+  if (showPages) printPages(model, detail);
+  if (showApis && (model.hasServer || onlyApis)) printApis(model, detail);
+  console.log("");
+  return 0;
+}
+
+export { routes };
+//# sourceMappingURL=routes-YI25MKPF.js.map
+//# sourceMappingURL=routes-YI25MKPF.js.map

package/dist/routes-YI25MKPF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/routes.ts"],"names":[],"mappings":"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","file":"routes-YI25MKPF.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\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)}`)\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    ...(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    }\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-5TYAIQ7C.js

@@ -0,0 +1,325 @@
+import { loadCatalog, isDocLang, DOC_LANGS, DEFAULT_DOC_LANG, docsForLang, readDoc } from './chunk-2KRCGXBY.js';
+import { log, printJson } from './chunk-OFFJ3OL5.js';
+import './chunk-C4MQRWXS.js';
+import pc from 'picocolors';
+
+// @squadbase/vantage — generated build. Do not edit.
+
+// src/cli/search-index.ts
+var FIELD_WEIGHTS = { slug: 3, title: 3, description: 2, body: 1 };
+var K1 = 1.2;
+var B = 0.75;
+var TOKEN_RE = /[a-z0-9]+|[぀-ヿ㐀-䶿一-鿿]+/g;
+var LATIN_RE = /^[a-z0-9]+$/;
+var TOKEN_RE_ANYCASE = /[a-zA-Z0-9]+|[぀-ヿ㐀-䶿一-鿿]+/g;
+var CJK_RE = /[぀-ヿ㐀-䶿一-鿿]/;
+var SCRIPT_RE = /[ぁ-ゟ]+|[゠-ヿ]+|[㐀-䶿一-鿿]+/g;
+var HIRAGANA_RE = /^[ぁ-ゟ]$/;
+function singular(word) {
+  if (word.length >= 5 && word.endsWith("ies")) return `${word.slice(0, -3)}y`;
+  if (word.length >= 4 && word.endsWith("s") && !/(ss|us|is)$/.test(word)) return word.slice(0, -1);
+  return word;
+}
+function tokenize(text) {
+  const normalized = text.normalize("NFKC").replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase();
+  const tokens = [];
+  for (const match of normalized.matchAll(TOKEN_RE)) {
+    const run = match[0];
+    if (LATIN_RE.test(run)) {
+      tokens.push(singular(run));
+      continue;
+    }
+    for (const segment of run.match(SCRIPT_RE) ?? []) {
+      if (segment.length === 1 && HIRAGANA_RE.test(segment)) continue;
+      if (segment.length <= 2) {
+        tokens.push(segment);
+        continue;
+      }
+      tokens.push(segment);
+      for (let i = 0; i < segment.length - 1; i++) tokens.push(segment.slice(i, i + 2));
+    }
+  }
+  return tokens;
+}
+function queryPhrases(query) {
+  const phrases = [];
+  for (const match of query.normalize("NFKC").matchAll(TOKEN_RE_ANYCASE)) {
+    const run = match[0];
+    if (!CJK_RE.test(run)) {
+      phrases.push(run);
+      continue;
+    }
+    for (const segment of run.match(SCRIPT_RE) ?? []) {
+      if (segment.length === 1 && HIRAGANA_RE.test(segment)) continue;
+      phrases.push(segment);
+    }
+  }
+  return [...new Set(phrases)];
+}
+function buildIndex(entries) {
+  const docs = entries.map((entry) => {
+    const body = readDoc(entry);
+    const tf = /* @__PURE__ */ new Map();
+    let length = 0;
+    const add = (text, weight) => {
+      for (const token of tokenize(text)) {
+        tf.set(token, (tf.get(token) ?? 0) + weight);
+        length += weight;
+      }
+    };
+    add(entry.slug, FIELD_WEIGHTS.slug);
+    add(entry.title, FIELD_WEIGHTS.title);
+    add(entry.description, FIELD_WEIGHTS.description);
+    add(body, FIELD_WEIGHTS.body);
+    return { entry, body, tf, length };
+  });
+  const df = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    for (const term of doc.tf.keys()) df.set(term, (df.get(term) ?? 0) + 1);
+  }
+  const total = docs.length;
+  const avgLength = total ? docs.reduce((sum, doc) => sum + doc.length, 0) / total : 1;
+  return {
+    search(query) {
+      const terms = [...new Set(tokenize(query))];
+      if (terms.length === 0) return [];
+      const hits = [];
+      for (const doc of docs) {
+        let score = 0;
+        for (const term of terms) {
+          const tf = doc.tf.get(term);
+          if (!tf) continue;
+          const n = df.get(term) ?? 0;
+          const idf = Math.log(1 + (total - n + 0.5) / (n + 0.5));
+          const norm = 1 - B + B * doc.length / avgLength;
+          score += idf * (tf * (K1 + 1) / (tf + K1 * norm));
+        }
+        if (score > 0) hits.push({ entry: doc.entry, score, terms, body: doc.body });
+      }
+      hits.sort((a, b) => b.score - a.score || a.entry.slug.localeCompare(b.entry.slug));
+      return hits;
+    }
+  };
+}
+var SNIPPET_LENGTH = 150;
+function snippet(body, terms, length = SNIPPET_LENGTH) {
+  let best = "";
+  let bestHits = 0;
+  let bestIndex = 0;
+  let bestIsHeading = true;
+  for (const raw of body.split("\n").slice(1)) {
+    const line = raw.replace(/^\s*[-*]\s+/, "").replace(/\s+/g, " ").trim();
+    if (!line || /^(```|~~~|\|\s*-{2,})/.test(line)) continue;
+    const haystack = line.toLowerCase();
+    const heading = line.startsWith("#");
+    let hits = 0;
+    let first = -1;
+    for (const term of terms) {
+      const at = haystack.indexOf(term);
+      if (at === -1) continue;
+      hits++;
+      if (first === -1 || at < first) first = at;
+    }
+    if (hits > bestHits || hits === bestHits && hits > 0 && bestIsHeading && !heading) {
+      best = line;
+      bestHits = hits;
+      bestIndex = first;
+      bestIsHeading = heading;
+    }
+  }
+  if (!bestHits) return "";
+  if (best.length <= length) return best;
+  const start = Math.max(0, bestIndex - Math.floor(length / 4));
+  const text = best.slice(start, start + length).trim();
+  return `${start > 0 ? "\u2026" : ""}${text}${start + length < best.length ? "\u2026" : ""}`;
+}
+
+// src/cli/search.ts
+var DEFAULT_LIMIT = 10;
+var MAX_REGEX_LINES = 3;
+function parseLimit(value, fallback) {
+  if (typeof value === "string") {
+    const n = Number(value);
+    if (Number.isInteger(n) && n > 0) return n;
+  }
+  return fallback;
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function paintMatches(text, re) {
+  if (!process.stdout.isTTY) return text;
+  let out = "";
+  let last = 0;
+  for (const match of text.matchAll(re)) {
+    const at = match.index ?? 0;
+    if (!match[0]) continue;
+    out += pc.dim(text.slice(last, at)) + pc.yellow(match[0]);
+    last = at + match[0].length;
+  }
+  return out + pc.dim(text.slice(last));
+}
+function paintTerms(text, words) {
+  if (!process.stdout.isTTY) return text;
+  if (words.length === 0) return pc.dim(text);
+  return paintMatches(text, new RegExp(words.map(escapeRegExp).join("|"), "gi"));
+}
+function header(count, query, lang, mode) {
+  const label = `${count} result${count === 1 ? "" : "s"} for "${query}"`;
+  console.log("");
+  console.log(pc.bold(label) + pc.dim(`  ${lang} \xB7 ${mode}`));
+  console.log("");
+}
+function footer(total, shown, lines) {
+  if (total > shown) {
+    console.log("");
+    console.log(pc.dim(`  ${total - shown} more \u2014 raise --limit to see them`));
+  }
+  console.log("");
+  for (const line of lines) console.log(pc.dim(line));
+}
+function noResults(query) {
+  log.warn(`Nothing matches "${query}".`);
+  console.log(pc.dim("  Try fewer or more general words, or run `vantage docs --list` to browse every page."));
+}
+function meta(entry) {
+  return {
+    slug: entry.slug,
+    title: entry.title,
+    description: entry.description,
+    section: entry.section,
+    sectionTitle: entry.sectionTitle,
+    command: `vantage docs ${entry.slug}`
+  };
+}
+function runRanked(entries, query, lang, limit, json) {
+  const hits = buildIndex(entries).search(query);
+  const shown = hits.slice(0, limit);
+  const passage = (hit) => snippet(hit.body, hit.terms);
+  if (json) {
+    printJson({
+      query,
+      mode: "bm25",
+      lang,
+      count: hits.length,
+      results: shown.map((hit) => ({
+        ...meta(hit.entry),
+        score: Math.round(hit.score * 1e3) / 1e3,
+        snippet: passage(hit)
+      }))
+    });
+    return 0;
+  }
+  if (hits.length === 0) {
+    noResults(query);
+    return 0;
+  }
+  const words = queryPhrases(query);
+  const width = Math.max(...shown.map((hit) => hit.entry.slug.length));
+  header(hits.length, query, lang, "bm25");
+  for (const hit of shown) {
+    const title = `${hit.entry.title}${pc.dim(` \xB7 ${hit.entry.sectionTitle}`)}`;
+    console.log(`  ${pc.cyan(hit.entry.slug.padEnd(width))}  ${title}`);
+    const text = passage(hit);
+    if (text) console.log(`  ${" ".repeat(width)}  ${paintTerms(text, words)}`);
+  }
+  footer(hits.length, shown.length, [
+    "vantage docs <name>      open one result       --regex   treat the query as a regular expression",
+    "vantage search --json    machine-readable      --limit   max results (default 10)"
+  ]);
+  return 0;
+}
+function runRegex(entries, query, lang, limit, json) {
+  let scan;
+  let probe;
+  try {
+    scan = new RegExp(query, "gi");
+    probe = new RegExp(query, "i");
+  } catch (err) {
+    log.error(err instanceof Error ? err.message : `Invalid regular expression: ${String(err)}`);
+    return 1;
+  }
+  const results = [];
+  for (const entry of entries) {
+    const lines = readDoc(entry).split("\n");
+    const matches = [];
+    let matchCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+      const found = [...lines[i].matchAll(scan)];
+      if (found.length === 0) continue;
+      matchCount += found.length;
+      if (matches.length < MAX_REGEX_LINES) {
+        matches.push({ line: i + 1, text: lines[i].replace(/\s+/g, " ").trim() });
+      }
+    }
+    const inMeta = probe.test(entry.slug) || probe.test(entry.title) || probe.test(entry.description);
+    if (matchCount === 0 && !inMeta) continue;
+    results.push({ entry, matchCount, matches });
+  }
+  results.sort((a, b) => b.matchCount - a.matchCount);
+  const shown = results.slice(0, limit);
+  if (json) {
+    printJson({
+      query,
+      mode: "regex",
+      lang,
+      count: results.length,
+      results: shown.map((result) => ({
+        ...meta(result.entry),
+        matchCount: result.matchCount,
+        matches: result.matches
+      }))
+    });
+    return 0;
+  }
+  if (results.length === 0) {
+    noResults(query);
+    return 0;
+  }
+  header(results.length, query, lang, "regex");
+  for (const result of shown) {
+    const count = pc.dim(
+      result.matchCount ? `  ${result.matchCount} match${result.matchCount === 1 ? "" : "es"}` : "  name match"
+    );
+    console.log(`  ${pc.cyan(result.entry.slug)}  ${result.entry.title}${count}`);
+    for (const match of result.matches) {
+      console.log(`    ${pc.dim(String(match.line).padStart(4))}  ${paintMatches(match.text, scan)}`);
+    }
+  }
+  footer(results.length, shown.length, [
+    "vantage docs <name>      open one result       --limit   max results (default 10)",
+    "vantage search --json    machine-readable      --lang    ja | en"
+  ]);
+  return 0;
+}
+async function search(_root, args) {
+  const query = args.positionals.slice(1).join(" ").trim();
+  if (!query) {
+    log.error("Usage: vantage search <query> [--regex] [--limit <n>] [--lang ja|en] [--json]");
+    return 1;
+  }
+  const catalog = loadCatalog();
+  if (!catalog) {
+    log.error("The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.");
+    return 1;
+  }
+  const langFlag = args.flags.lang;
+  if (langFlag !== void 0 && !isDocLang(langFlag)) {
+    log.error(`Unknown --lang "${String(langFlag)}". Available: ${DOC_LANGS.join(", ")}`);
+    return 1;
+  }
+  const lang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG;
+  const entries = docsForLang(catalog, lang);
+  if (entries.length === 0) {
+    log.error(`No documentation bundled for "${lang}".`);
+    return 1;
+  }
+  const searchable = entries.filter((entry) => entry.searchable !== false);
+  const limit = parseLimit(args.flags.limit, DEFAULT_LIMIT);
+  const json = Boolean(args.flags.json);
+  return args.flags.regex ? runRegex(searchable, query, lang, limit, json) : runRanked(searchable, query, lang, limit, json);
+}
+
+export { search };
+//# sourceMappingURL=search-5TYAIQ7C.js.map
+//# sourceMappingURL=search-5TYAIQ7C.js.map