@squadbase/vantage 0.5.3-dev.71d2349 → 0.6.0-dev.3cc6138

package/dist/{chunk-EHPJXDJU.js → chunk-SVNOWE5U.js}

@@ -28,6 +28,8 @@ function toRouteInfo(page) {
     dynamic: params.length > 0,
     index: page.index,
     label: page.navLabel ?? page.title ?? page.routePath,
+    kind: page.kind ?? "module",
+    ...page.variant ? { variant: page.variant } : {},
     ...page.title ? { title: page.title } : {},
     ...page.description ? { description: page.description } : {},
     ...page.navLabel ? { navLabel: page.navLabel } : {}
@@ -47,5 +49,5 @@ function findRoute(path) {
 }
 
 export { findRoute, getRoutes, setRoutes };
-//# sourceMappingURL=chunk-EHPJXDJU.js.map
-//# sourceMappingURL=chunk-EHPJXDJU.js.map
+//# sourceMappingURL=chunk-SVNOWE5U.js.map
+//# sourceMappingURL=chunk-SVNOWE5U.js.map

package/dist/chunk-SVNOWE5U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router/registry.ts"],"names":[],"mappings":";;;AAkDA,SAAS,UAAU,IAAA,EAAwB;AACzC,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA,CAAE,OAAO,OAAO,CAAA;AACvC;AAEA,SAAS,YAAY,IAAA,EAAwB;AAC3C,EAAA,OAAO,SAAA,CAAU,IAAI,CAAA,CAAE,OAAA,CAAQ,CAAC,KAAA,KAAU;AACxC,IAAA,IAAI,KAAA,CAAM,WAAW,GAAG,CAAA,SAAU,CAAC,KAAA,CAAM,KAAA,CAAM,CAAC,CAAC,CAAA;AAGjD,IAAA,IAAI,KAAA,KAAU,GAAA,EAAK,OAAO,CAAC,QAAQ,CAAA;AACnC,IAAA,OAAO,EAAC;AAAA,EACV,CAAC,CAAA;AACH;AAGA,SAAS,WAAW,IAAA,EAAsB;AACxC,EAAA,MAAM,SAAS,SAAA,CAAU,IAAI,CAAA,CAAE,GAAA,CAAI,CAAC,KAAA,KAAU;AAC5C,IAAA,IAAI,KAAA,CAAM,WAAW,GAAG,CAAA,SAAU,CAAA,CAAA,EAAI,KAAA,CAAM,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACpD,IAAA,IAAI,KAAA,KAAU,KAAK,OAAO,GAAA;AAC1B,IAAA,OAAO,KAAA;AAAA,EACT,CAAC,CAAA;AACD,EAAA,OAAO,GAAA,GAAM,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA;AAC9B;AAEA,SAAS,YAAY,IAAA,EAA6B;AAChD,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA;AACzC,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,SAAA;AAAA,IACX,EAAA,EAAI,UAAA,CAAW,IAAA,CAAK,SAAS,CAAA;AAAA,IAC7B,MAAA;AAAA,IACA,OAAA,EAAS,OAAO,MAAA,GAAS,CAAA;AAAA,IACzB,OAAO,IAAA,CAAK,KAAA;AAAA,IACZ,KAAA,EAAO,IAAA,CAAK,QAAA,IAAY,IAAA,CAAK,SAAS,IAAA,CAAK,SAAA;AAAA,IAC3C,IAAA,EAAM,KAAK,IAAA,IAAQ,QAAA;AAAA,IACnB,GAAI,KAAK,OAAA,GAAU,EAAE,SAAS,IAAA,CAAK,OAAA,KAAY,EAAC;AAAA,IAChD,GAAI,KAAK,KAAA,GAAQ,EAAE,OAAO,IAAA,CAAK,KAAA,KAAU,EAAC;AAAA,IAC1C,GAAI,KAAK,WAAA,GAAc,EAAE,aAAa,IAAA,CAAK,WAAA,KAAgB,EAAC;AAAA,IAC5D,GAAI,KAAK,QAAA,GAAW,EAAE,UAAU,IAAA,CAAK,QAAA,KAAa;AAAC,GACrD;AACF;AAEA,IAAI,SAAsB,EAAC;AAC3B,IAAI,MAAA,uBAAa,GAAA,EAAuB;AAGjC,SAAS,UAAU,QAAA,EAAgC;AACxD,EAAA,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,GAAA,CAAI,WAAW,CAAA;AACvC,EAAA,MAAA,GAAS,IAAI,GAAA,CAAI,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAU,CAAC,KAAA,CAAM,IAAA,EAAM,KAAK,CAAC,CAAC,CAAA;AAC7D;AAGO,SAAS,SAAA,GAAkC;AAChD,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,UAAU,IAAA,EAAqC;AAC7D,EAAA,OAAO,MAAA,CAAO,IAAI,IAAI,CAAA;AACxB","file":"chunk-SVNOWE5U.js","sourcesContent":["/**\n * The app's route list, published once by the client bootstrap and read by the\n * route hooks. A module-level store rather than React context: the list is\n * fixed for the lifetime of the bundle — the generated route tree is imported\n * by `.vantage/client-entry.tsx`, which accepts no HMR update, so adding a page\n * full-reloads the dev server — and pages can read it without a provider.\n *\n * `client/bootstrap` and `router/` are separate published subpaths but tsup\n * hoists this module into a shared chunk, so both see the same instance.\n */\nimport type {\n  ClientManifest,\n  ClientPage,\n  ClientPageKind,\n  ClientPageVariant,\n} from \"../client/manifest\"\n\n/** One page route, as described by the generated manifest. */\nexport interface RouteInfo {\n  /** Display path with `:param` placeholders — e.g. `/sales/:customerId`. */\n  path: string\n  /** The same path in `Link`'s token form — e.g. `/sales/$customerId`. */\n  to: string\n  /** Dynamic parameter names in order; a catch-all is reported as `_splat`. */\n  params: string[]\n  /** True when the route carries at least one dynamic parameter. */\n  dynamic: boolean\n  /** True for a directory's index route (`index.tsx`). */\n  index: boolean\n  /**\n   * Ready-to-render nav label: `navLabel`, else `title`, else the path. Always\n   * a string, so a nav needs no fallback of its own.\n   */\n  label: string\n  /** `definePage({ title })`, extracted statically at generate time. */\n  title?: string\n  /** `definePage({ description })`. */\n  description?: string\n  /** `definePage({ navLabel })`. */\n  navLabel?: string\n  /**\n   * What the page is rendered from: `\"module\"` for a `.tsx`/`.jsx` the app\n   * wrote, `\"file\"` for a `.csv`/`.xlsx` drawn by the built-in table viewer.\n   * A nav can group or badge by this without matching on file names.\n   */\n  kind: ClientPageKind\n  /** Page-kind suffix, e.g. `\"slide\"` for `june.slide.tsx`. */\n  variant?: ClientPageVariant\n}\n\nfunction splitPath(path: string): string[] {\n  return path.split(\"/\").filter(Boolean)\n}\n\nfunction parseParams(path: string): string[] {\n  return splitPath(path).flatMap((token) => {\n    if (token.startsWith(\":\")) return [token.slice(1)]\n    // A catch-all loses its name in the display path; TanStack exposes it as\n    // `_splat`, which is the name `useParams()` will actually return.\n    if (token === \"*\") return [\"_splat\"]\n    return []\n  })\n}\n\n/** `/sales/:customerId` -> `/sales/$customerId` (what `Link`'s `to` expects). */\nfunction toLinkPath(path: string): string {\n  const tokens = splitPath(path).map((token) => {\n    if (token.startsWith(\":\")) return `$${token.slice(1)}`\n    if (token === \"*\") return \"$\"\n    return token\n  })\n  return \"/\" + tokens.join(\"/\")\n}\n\nfunction toRouteInfo(page: ClientPage): RouteInfo {\n  const params = parseParams(page.routePath)\n  return {\n    path: page.routePath,\n    to: toLinkPath(page.routePath),\n    params,\n    dynamic: params.length > 0,\n    index: page.index,\n    label: page.navLabel ?? page.title ?? page.routePath,\n    kind: page.kind ?? \"module\",\n    ...(page.variant ? { variant: page.variant } : {}),\n    ...(page.title ? { title: page.title } : {}),\n    ...(page.description ? { description: page.description } : {}),\n    ...(page.navLabel ? { navLabel: page.navLabel } : {}),\n  }\n}\n\nlet routes: RouteInfo[] = []\nlet byPath = new Map<string, RouteInfo>()\n\n/** Publish the route list. Called by `bootstrap()`; not part of the app API. */\nexport function setRoutes(manifest: ClientManifest): void {\n  routes = manifest.pages.map(toRouteInfo)\n  byPath = new Map(routes.map((route) => [route.path, route]))\n}\n\n/** The published route list, in the framework's stable scan order. */\nexport function getRoutes(): readonly RouteInfo[] {\n  return routes\n}\n\n/** Look up a route by its display path (`/sales/:customerId`). */\nexport function findRoute(path: string): RouteInfo | undefined {\n  return byPath.get(path)\n}\n"]}

package/dist/{chunk-C4MQRWXS.js → chunk-TDUIW7LD.js}

@@ -39,6 +39,20 @@ var SUSPICIOUS_ROUTE_DIRS = /* @__PURE__ */ new Set([
   "__tests__"
 ]);
 var PAGE_EXTENSIONS = [".tsx", ".jsx"];
+var PAGE_VARIANTS = ["slide"];
+var FILE_PAGE_EXTENSIONS = [".csv", ".xlsx"];
+var ROUTED_EXTENSIONS = [...PAGE_EXTENSIONS, ...FILE_PAGE_EXTENSIONS];
+var UNSUPPORTED_PAGE_EXTENSIONS = [
+  ".xls",
+  ".xlsm",
+  ".xlsb",
+  ".ods",
+  ".tsv",
+  ".numbers",
+  ".parquet"
+];
+var FILE_PAGE_MAX_BYTES = 25 * 1024 * 1024;
+var FILE_PAGE_MAX_ROWS = 2e5;
 var API_EXTENSIONS = [".ts", ".tsx", ".js"];
 var RESERVED_PAGE_NAMES = {
   layout: "_layout",
@@ -76,6 +90,6 @@ var FORBIDDEN_FILES = [
 var PUBLIC_ENV_PREFIX = "PUBLIC_";
 var MANIFEST_SCHEMA_VERSION = 1;
 
-export { API_EXTENSIONS, API_METHODS, FORBIDDEN_FILES, MANIFEST_SCHEMA_VERSION, NON_ROUTE_DIRS, PAGE_EXTENSIONS, PUBLIC_ENV_PREFIX, RESERVED_PAGE_NAMES, SRC_DIR, SUSPICIOUS_ROUTE_DIRS, VANTAGE_DIR };
-//# sourceMappingURL=chunk-C4MQRWXS.js.map
-//# sourceMappingURL=chunk-C4MQRWXS.js.map
+export { API_EXTENSIONS, API_METHODS, FILE_PAGE_EXTENSIONS, FILE_PAGE_MAX_BYTES, FILE_PAGE_MAX_ROWS, FORBIDDEN_FILES, MANIFEST_SCHEMA_VERSION, NON_ROUTE_DIRS, PAGE_EXTENSIONS, PAGE_VARIANTS, PUBLIC_ENV_PREFIX, RESERVED_PAGE_NAMES, ROUTED_EXTENSIONS, SRC_DIR, SUSPICIOUS_ROUTE_DIRS, UNSUPPORTED_PAGE_EXTENSIONS, VANTAGE_DIR };
+//# sourceMappingURL=chunk-TDUIW7LD.js.map
+//# sourceMappingURL=chunk-TDUIW7LD.js.map

package/dist/chunk-TDUIW7LD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/constants.ts"],"names":[],"mappings":";;;AAMO,IAAM,WAAA,GAAc;AASpB,IAAM,OAAA,GAAU;AAGhB,IAAM,cAAA,uBAAqB,GAAA,CAAI;AAAA,EACpC,YAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,cAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAC;AASM,IAAM,qBAAA,uBAA4B,GAAA,CAAI;AAAA,EAC3C,OAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,YAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF,CAAC;AAGM,IAAM,eAAA,GAAkB,CAAC,MAAA,EAAQ,MAAM;AAYvC,IAAM,aAAA,GAAgB,CAAC,OAAO;AAQ9B,IAAM,oBAAA,GAAuB,CAAC,MAAA,EAAQ,OAAO;AAI7C,IAAM,iBAAA,GAAuC,CAAC,GAAG,eAAA,EAAiB,GAAG,oBAAoB;AAQzF,IAAM,2BAAA,GAA8B;AAAA,EACzC,MAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAGO,IAAM,mBAAA,GAAsB,KAAK,IAAA,GAAO;AAGxC,IAAM,kBAAA,GAAqB;AAG3B,IAAM,cAAA,GAAiB,CAAC,KAAA,EAAO,MAAA,EAAQ,KAAK;AAG5C,IAAM,mBAAA,GAAsB;AAAA,EACjC,MAAA,EAAQ,SAAA;AAAA,EACR,QAAA,EAAU,MAAA;AAAA,EACV,KAAA,EAAO;AACT;AAGO,IAAM,cAAc,CAAC,KAAA,EAAO,QAAQ,KAAA,EAAO,OAAA,EAAS,UAAU,SAAS;AAOvE,IAAM,eAAA,GAAwE;AAAA,EACnF;AAAA,IACE,OAAA,EAAS,yCAAA;AAAA,IACT,KAAA,EAAO,aAAA;AAAA,IACP,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,OAAA,EAAS,qCAAA;AAAA,IACT,KAAA,EAAO,iBAAA;AAAA,IACP,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,OAAA,EAAS,oCAAA;AAAA,IACT,KAAA,EAAO,gBAAA;AAAA,IACP,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,OAAA,EAAS,oBAAA;AAAA,IACT,KAAA,EAAO,wBAAA;AAAA,IACP,MAAA,EAAQ;AAAA,GACV;AAAA,EACA;AAAA,IACE,OAAA,EAAS,oCAAA;AAAA,IACT,KAAA,EAAO,gBAAA;AAAA,IACP,MAAA,EAAQ;AAAA;AAEZ;AAGO,IAAM,iBAAA,GAAoB;AAG1B,IAAM,uBAAA,GAA0B","file":"chunk-TDUIW7LD.js","sourcesContent":["/**\n * Framework-wide constants: naming conventions and reserved paths.\n * These encode the \"convention over configuration\" contract from the design.\n */\n\n/** Directory that holds all generated, hidden artifacts. */\nexport const VANTAGE_DIR = \".vantage\"\n\n/**\n * Optional directory holding the app's client source. When it exists, it is the\n * one and only page-scan root; when it does not, pages live at the project root.\n * Both layouts are supported so a single-file app stays a single file, while an\n * app (or a coding agent) that reaches for the near-universal `src/` convention\n * gets routes that make sense instead of a `/src/...` prefix on every page.\n */\nexport const SRC_DIR = \"src\"\n\n/** Directories that are never scanned for pages. */\nexport const NON_ROUTE_DIRS = new Set([\n  \"components\",\n  \"hooks\",\n  \"lib\",\n  \"server\",\n  \"public\",\n  \"node_modules\",\n  VANTAGE_DIR,\n  \"dist\",\n])\n\n/**\n * Directory names that almost always mean \"framework scaffolding\", not \"a URL\n * segment\". Page scanning is a denylist (`NON_ROUTE_DIRS`), so any directory\n * not on it becomes part of the route path — `pages/sales.tsx` silently serves\n * `/pages/sales`. These names are still scanned (they may be deliberate), but\n * routes coming out of them raise `SUSPICIOUS_ROUTE_DIR`.\n */\nexport const SUSPICIOUS_ROUTE_DIRS = new Set([\n  SRC_DIR,\n  \"app\",\n  \"pages\",\n  \"routes\",\n  \"views\",\n  \"screens\",\n  \"features\",\n  \"containers\",\n  \"modules\",\n  \"layouts\",\n  \"utils\",\n  \"types\",\n  \"styles\",\n  \"assets\",\n  \"store\",\n  \"stores\",\n  \"context\",\n  \"contexts\",\n  \"providers\",\n  \"api\",\n  \"test\",\n  \"tests\",\n  \"__tests__\",\n])\n\n/** File extensions treated as page modules. */\nexport const PAGE_EXTENSIONS = [\".tsx\", \".jsx\"]\n\n/**\n * Page-kind suffixes. A page module may carry exactly one of these between its\n * name and its extension — `june.slide.tsx` is \"`/june`, rendered as a deck\".\n * The suffix never reaches the URL.\n *\n * Deliberately an allowlist rather than the general rule \"the last dot-separated\n * token is a suffix\": the general rule would silently move an existing\n * `report.v2.tsx` from `/report.v2` to `/report`. Generalize the mechanism,\n * register one entry.\n */\nexport const PAGE_VARIANTS = [\"slide\"] as const\nexport type PageVariant = (typeof PAGE_VARIANTS)[number]\n\n/**\n * Data files rendered as a page by a built-in viewer. Adding an entry here is\n * only half the job — `src/table/` has to be able to render it (see the switch\n * in `file-page-view.tsx`), or the page mounts and immediately errors.\n */\nexport const FILE_PAGE_EXTENSIONS = [\".csv\", \".xlsx\"] as const\nexport type FilePageExt = (typeof FILE_PAGE_EXTENSIONS)[number]\n\n/** Every extension that becomes a route under the page root. */\nexport const ROUTED_EXTENSIONS: readonly string[] = [...PAGE_EXTENSIONS, ...FILE_PAGE_EXTENSIONS]\n\n/**\n * Spreadsheet-ish extensions a user plausibly drops in expecting a page, that\n * Vantage has no viewer for. Deliberately *not* including `.json`/`.md`/`.txt`:\n * those have obvious non-page uses (`resolveJsonModule` is on, READMEs live\n * next to code) and warning about them would be noise.\n */\nexport const UNSUPPORTED_PAGE_EXTENSIONS = [\n  \".xls\",\n  \".xlsm\",\n  \".xlsb\",\n  \".ods\",\n  \".tsv\",\n  \".numbers\",\n  \".parquet\",\n]\n\n/** Past this, the browser cannot parse the file; the page shows an error. */\nexport const FILE_PAGE_MAX_BYTES = 25 * 1024 * 1024\n\n/** Past this, the table is truncated (with a banner) rather than rendered whole. */\nexport const FILE_PAGE_MAX_ROWS = 200_000\n\n/** File extensions treated as server API modules. */\nexport const API_EXTENSIONS = [\".ts\", \".tsx\", \".js\"]\n\n/** Reserved page filenames (without extension). */\nexport const RESERVED_PAGE_NAMES = {\n  layout: \"_layout\",\n  notFound: \"_404\",\n  error: \"_error\",\n} as const\n\n/** HTTP methods that an API module may export. */\nexport const API_METHODS = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"OPTIONS\"] as const\nexport type ApiMethod = (typeof API_METHODS)[number]\n\n/**\n * Files that must not exist in a Vantage project. Their presence means the\n * user is trying to escape the managed stack, which v1 forbids.\n */\nexport const FORBIDDEN_FILES: { pattern: RegExp; label: string; remedy: string }[] = [\n  {\n    pattern: /^vite\\.config\\.(ts|js|mjs|cjs|mts|cts)$/,\n    label: \"Vite config\",\n    remedy: \"Vantage owns the Vite configuration. Remove this file.\",\n  },\n  {\n    pattern: /^tailwind\\.config\\.(ts|js|mjs|cjs)$/,\n    label: \"Tailwind config\",\n    remedy: \"Customize theme tokens in styles.css instead.\",\n  },\n  {\n    pattern: /^postcss\\.config\\.(ts|js|mjs|cjs)$/,\n    label: \"PostCSS config\",\n    remedy: \"Vantage manages PostCSS/Tailwind. Remove this file.\",\n  },\n  {\n    pattern: /^components\\.json$/,\n    label: \"shadcn components.json\",\n    remedy: \"Use `vantage add ui <name>` to copy UI source instead.\",\n  },\n  {\n    pattern: /^vantage\\.config\\.(ts|js|mjs|cjs)$/,\n    label: \"Vantage config\",\n    remedy: \"v1 has no vantage.config. Configuration lives in file conventions.\",\n  },\n]\n\n/** Public env var prefix exposed to the client bundle. */\nexport const PUBLIC_ENV_PREFIX = \"PUBLIC_\"\n\n/** Manifest schema version emitted into build output. */\nexport const MANIFEST_SCHEMA_VERSION = 1\n"]}

package/dist/{chunk-X44ZTKID.js → chunk-V2FV5OJ6.js}

@@ -1,5 +1,5 @@
-import { resolvePageRoot } from './chunk-D4Y5RWJA.js';
-import { log } from './chunk-HQDEYCDP.js';
+import { resolvePageRoot } from './chunk-YE4CPCXX.js';
+import { log } from './chunk-CIJWVFJD.js';
 import fs from 'fs';
 import path from 'path';
 import { createRequire } from 'module';
@@ -163,12 +163,26 @@ function addSkill(root, name, all, force, dir) {
   return failed === 0 ? 0 : 1;
 }
 var AGENTS_FILE = "AGENTS.md";
+var AGENTS_KNOWLEDGE_DIR = "agents";
 function bundledAgentsPath(root) {
   const dir = resolvePackageDir(root, "templates");
   if (!dir) return null;
   const src = path.join(dir, AGENTS_FILE);
   return fs.existsSync(src) ? src : null;
 }
+function bundledAgentsDir(root) {
+  const dir = resolvePackageDir(root, "templates");
+  if (!dir) return null;
+  const sub = path.join(dir, AGENTS_KNOWLEDGE_DIR);
+  return fs.existsSync(sub) ? sub : null;
+}
+function listBundledAgentsFiles(agentsDir) {
+  try {
+    return fs.readdirSync(agentsDir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".md")).map((e) => e.name).sort();
+  } catch {
+    return [];
+  }
+}
 function addAgents(root, force) {
   const src = bundledAgentsPath(root);
   if (!src) {
@@ -182,17 +196,55 @@ function addAgents(root, force) {
   }
   fs.copyFileSync(src, dest);
   log.ok(`Added ${path.relative(root, dest) || AGENTS_FILE}`);
+  const agentsDir = bundledAgentsDir(root);
+  const destAgentsDir = path.join(root, AGENTS_KNOWLEDGE_DIR);
+  if (agentsDir) {
+    fs.mkdirSync(destAgentsDir, { recursive: true });
+    const skipped = [];
+    for (const name of listBundledAgentsFiles(agentsDir)) {
+      const destFile = path.join(destAgentsDir, name);
+      if (fs.existsSync(destFile) && !force) {
+        skipped.push(name);
+        continue;
+      }
+      fs.copyFileSync(path.join(agentsDir, name), destFile);
+      log.ok(`Added ${path.relative(root, destFile)}`);
+    }
+    if (skipped.length > 0) {
+      log.warn(
+        `Skipped existing ${skipped.join(", ")} in ${AGENTS_KNOWLEDGE_DIR}/. Use --force to overwrite.`
+      );
+    }
+  }
   return 0;
 }
 function syncAgentsFile(root) {
   const dest = path.join(root, AGENTS_FILE);
   if (!fs.existsSync(dest)) return "absent";
+  let changed = false;
   const src = bundledAgentsPath(root);
-  if (!src) return "unchanged";
-  const next = fs.readFileSync(src, "utf8");
-  if (fs.readFileSync(dest, "utf8") === next) return "unchanged";
-  fs.writeFileSync(dest, next);
-  return "updated";
+  if (src) {
+    const next = fs.readFileSync(src, "utf8");
+    if (fs.readFileSync(dest, "utf8") !== next) {
+      fs.writeFileSync(dest, next);
+      changed = true;
+    }
+  }
+  const agentsDir = bundledAgentsDir(root);
+  if (agentsDir) {
+    const destAgentsDir = path.join(root, AGENTS_KNOWLEDGE_DIR);
+    fs.mkdirSync(destAgentsDir, { recursive: true });
+    for (const name of listBundledAgentsFiles(agentsDir)) {
+      const srcFile = path.join(agentsDir, name);
+      const destFile = path.join(destAgentsDir, name);
+      const next = fs.readFileSync(srcFile, "utf8");
+      if (!fs.existsSync(destFile) || fs.readFileSync(destFile, "utf8") !== next) {
+        fs.writeFileSync(destFile, next);
+        changed = true;
+      }
+    }
+  }
+  return changed ? "updated" : "unchanged";
 }
 function copyFromRegistry(root, kind, name, force) {
   const registry = resolveRegistryDir(root);
@@ -263,5 +315,5 @@ async function add(root, args) {
 }
 
 export { add, syncAgentsFile };
-//# sourceMappingURL=chunk-X44ZTKID.js.map
-//# sourceMappingURL=chunk-X44ZTKID.js.map
+//# sourceMappingURL=chunk-V2FV5OJ6.js.map
+//# sourceMappingURL=chunk-V2FV5OJ6.js.map

package/dist/chunk-V2FV5OJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/add.ts"],"names":["require"],"mappings":"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","file":"chunk-V2FV5OJ6.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { createRequire } from \"node:module\"\nimport { resolvePageRoot } from \"../core/scan\"\nimport { log, type ParsedArgs } from \"./util\"\n\nconst PKG = \"@squadbase/vantage\"\n\nfunction toPascalCase(segment: string): string {\n  const cleaned = segment.replace(/\\[|\\]|\\./g, \"\").replace(/\\.\\.\\./g, \"\")\n  const words = cleaned.split(/[^a-zA-Z0-9]+/).filter(Boolean)\n  const pascal = words.map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(\"\")\n  return /^[A-Za-z]/.test(pascal) ? pascal : \"Page\"\n}\n\nfunction pageTemplate(name: string): string {\n  const last = name.split(\"/\").pop() ?? name\n  const component = last === \"index\" ? toPascalCase(name.split(\"/\").slice(-2)[0] ?? \"Home\") : toPascalCase(last)\n  const title = last.replace(/-/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase())\n  return `import { definePage } from \"${PKG}\"\n\nexport const page = definePage({ title: ${JSON.stringify(title)} })\n\nexport default function ${component}() {\n  return (\n    <main className=\"p-6\">\n      <h1 className=\"text-2xl font-semibold\">${title}</h1>\n    </main>\n  )\n}\n`\n}\n\nfunction apiTemplate(): string {\n  return `import type { ApiContext } from \"${PKG}/server\"\n\nexport async function GET({ request, params }: ApiContext) {\n  return Response.json({ ok: true, params })\n}\n`\n}\n\nfunction resolvePackageDir(root: string, sub: string): string | null {\n  try {\n    const require = createRequire(path.join(root, \"noop.js\"))\n    const pkgJson = require.resolve(`${PKG}/package.json`)\n    return path.join(path.dirname(pkgJson), sub)\n  } catch {\n    return null\n  }\n}\n\nfunction resolveRegistryDir(root: string): string | null {\n  return resolvePackageDir(root, \"registry\")\n}\n\nconst SKILL_FILE = \"SKILL.md\"\n\n/** Directories a placed skill never lives in — skipped while scanning. */\nconst SKILL_SCAN_SKIP = new Set([\n  \"node_modules\",\n  \".git\",\n  \".vantage\",\n  \"dist\",\n  \"build\",\n  \"out\",\n  \"coverage\",\n  \".next\",\n  \".turbo\",\n  \".cache\",\n  \".vercel\",\n])\n\n/** How deep below the root the scan goes (`.claude/skills/<name>` is depth 3). */\nconst SKILL_SCAN_DEPTH = 4\n\n/** List the skill directories bundled with the installed framework. */\nfunction listBundledSkills(skillsDir: string): string[] {\n  try {\n    return fs\n      .readdirSync(skillsDir, { withFileTypes: true })\n      .filter((e) => e.isDirectory() && fs.existsSync(path.join(skillsDir, e.name, SKILL_FILE)))\n      .map((e) => e.name)\n      .sort()\n  } catch {\n    return []\n  }\n}\n\n/** Paths outside the project read better absolute than as a pile of `../`. */\nfunction displayPath(root: string, target: string): string {\n  const rel = path.relative(root, target)\n  return !rel ? \".\" : rel.startsWith(\"..\") ? target : rel\n}\n\n/**\n * Find where the bundled skills already live in this project.\n *\n * Placement is a convention, not a fixed path: apps keep them under the root,\n * under `.claude/skills/`, under `.squadbase/skills/`, … so `add skill` looks\n * for the skill *directories* rather than guessing one destination and adding a\n * second copy next to the one that is already there.\n */\nfunction findPlacedSkills(\n  root: string,\n  names: readonly string[],\n  skillsDir: string,\n): Map<string, string[]> {\n  const wanted = new Set(names)\n  const found = new Map<string, string[]>()\n  // A workspace that links the framework by path (not through node_modules)\n  // would otherwise report the framework's own `skills/` as a placement.\n  const isSource = (p: string) => !path.relative(skillsDir, p).startsWith(\"..\")\n  const walk = (dir: string, depth: number): void => {\n    let entries: fs.Dirent[]\n    try {\n      entries = fs.readdirSync(dir, { withFileTypes: true })\n    } catch {\n      return\n    }\n    for (const entry of entries) {\n      if (!entry.isDirectory() || SKILL_SCAN_SKIP.has(entry.name)) continue\n      const abs = path.join(dir, entry.name)\n      if (wanted.has(entry.name) && fs.existsSync(path.join(abs, SKILL_FILE))) {\n        if (!isSource(abs)) found.set(entry.name, [...(found.get(entry.name) ?? []), abs])\n        continue // skills never nest inside one another\n      }\n      if (depth < SKILL_SCAN_DEPTH) walk(abs, depth + 1)\n    }\n  }\n  walk(root, 1)\n  for (const list of found.values()) list.sort()\n  return found\n}\n\n/** Copy one bundled skill directory to `dest`, creating parents as needed. */\nfunction writeSkill(root: string, skillsDir: string, name: string, dest: string, verb: string): void {\n  fs.mkdirSync(path.dirname(dest), { recursive: true })\n  fs.cpSync(path.join(skillsDir, name), dest, { recursive: true, force: true })\n  log.ok(`${verb} skill ${displayPath(root, dest)}/`)\n}\n\n/** `vantage add skill` with no name — the bundled list plus where each one sits. */\nfunction printSkillList(root: string, available: string[], placed: Map<string, string[]>): number {\n  const width = Math.max(...available.map((n) => n.length))\n  log.info(\"Bundled skills:\")\n  for (const name of available) {\n    const where = placed.get(name)\n    const status = where?.length\n      ? where.map((p) => displayPath(root, p) + \"/\").join(\", \")\n      : \"not placed\"\n    log.info(`  ${name.padEnd(width)}  ${status}`)\n  }\n  const missing = available.filter((n) => !placed.get(n)?.length)\n  if (missing.length) {\n    log.info(\"\")\n    log.info(\"Place the missing ones with: vantage add skill --all [--dir <path>]\")\n  }\n  return 0\n}\n\n/**\n * `vantage add skill [<name>|--all] [--dir <path>]` — copy Claude Code skills\n * out of the package.\n *\n * The command scans the project first: a skill that is already placed anywhere\n * (root, `.claude/skills/`, `.squadbase/skills/`, …) is a no-op and its location\n * is reported, so re-running never produces a second copy. `--force` refreshes\n * the placements that were found, in place. Only when nothing is found does the\n * destination matter — the project root, or `--dir` when given (an explicit\n * `--dir` also wins over refreshing somewhere else).\n */\nfunction addSkill(\n  root: string,\n  name: string | undefined,\n  all: boolean,\n  force: boolean,\n  dir: string | undefined,\n): number {\n  const skillsDir = resolvePackageDir(root, \"skills\")\n  if (!skillsDir) {\n    log.error(\"Could not resolve the Vantage skills directory.\")\n    return 1\n  }\n  const available = listBundledSkills(skillsDir)\n  if (available.length === 0) {\n    log.error(\"No skills are bundled with this version of Vantage.\")\n    return 1\n  }\n  const placed = findPlacedSkills(root, available, skillsDir)\n  if (!all && !name) return printSkillList(root, available, placed)\n\n  const destDir = path.resolve(root, dir ?? \".\")\n  const targets = all ? available : [name as string]\n  let failed = 0\n  for (const target of targets) {\n    if (!available.includes(target)) {\n      log.error(`Unknown skill \"${target}\". Available: ${available.join(\", \")}`)\n      failed++\n      continue\n    }\n    const existing = placed.get(target) ?? []\n    if (existing.length > 0 && !force) {\n      const where = existing.map((p) => displayPath(root, p) + \"/\").join(\", \")\n      log.info(`Skill ${target} is already placed at ${where} — skipped (--force to refresh).`)\n      continue\n    }\n    // `--dir` names a destination explicitly, so it wins over refreshing copies\n    // that live somewhere else; without it, `--force` updates them where they are.\n    const inDestDir = existing.filter((p) => path.dirname(p) === destDir)\n    const refresh = dir === undefined ? existing : inDestDir\n    if (refresh.length > 0) {\n      for (const dest of refresh) writeSkill(root, skillsDir, target, dest, \"Updated\")\n      continue\n    }\n    if (existing.length > 0) {\n      const where = existing.map((p) => displayPath(root, p) + \"/\").join(\", \")\n      log.warn(`Skill ${target} is also placed at ${where} — left untouched.`)\n    }\n    writeSkill(root, skillsDir, target, path.join(destDir, target), \"Added\")\n  }\n  return failed === 0 ? 0 : 1\n}\n\nconst AGENTS_FILE = \"AGENTS.md\"\nconst AGENTS_KNOWLEDGE_DIR = \"agents\"\n\n/** Path to the framework's canonical AGENTS.md, or null if unresolved/absent. */\nfunction bundledAgentsPath(root: string): string | null {\n  const dir = resolvePackageDir(root, \"templates\")\n  if (!dir) return null\n  const src = path.join(dir, AGENTS_FILE)\n  return fs.existsSync(src) ? src : null\n}\n\n/** Directory bundling the per-artifact-type knowledge files (`agents/*.md`). */\nfunction bundledAgentsDir(root: string): string | null {\n  const dir = resolvePackageDir(root, \"templates\")\n  if (!dir) return null\n  const sub = path.join(dir, AGENTS_KNOWLEDGE_DIR)\n  return fs.existsSync(sub) ? sub : null\n}\n\n/** List the bundled `agents/*.md` knowledge file names. */\nfunction listBundledAgentsFiles(agentsDir: string): string[] {\n  try {\n    return fs\n      .readdirSync(agentsDir, { withFileTypes: true })\n      .filter((e) => e.isFile() && e.name.endsWith(\".md\"))\n      .map((e) => e.name)\n      .sort()\n  } catch {\n    return []\n  }\n}\n\n/**\n * `vantage add agents` — copy the app-author AGENTS.md map, plus the\n * per-artifact-type knowledge files under `agents/`, into the app root.\n */\nfunction addAgents(root: string, force: boolean): number {\n  const src = bundledAgentsPath(root)\n  if (!src) {\n    log.error(\"AGENTS.md is not bundled with this version of Vantage.\")\n    return 1\n  }\n  const dest = path.join(root, AGENTS_FILE)\n  if (fs.existsSync(dest) && !force) {\n    log.error(`${AGENTS_FILE} already exists. Use --force to overwrite.`)\n    return 1\n  }\n  fs.copyFileSync(src, dest)\n  log.ok(`Added ${path.relative(root, dest) || AGENTS_FILE}`)\n\n  const agentsDir = bundledAgentsDir(root)\n  const destAgentsDir = path.join(root, AGENTS_KNOWLEDGE_DIR)\n  if (agentsDir) {\n    fs.mkdirSync(destAgentsDir, { recursive: true })\n    const skipped: string[] = []\n    for (const name of listBundledAgentsFiles(agentsDir)) {\n      const destFile = path.join(destAgentsDir, name)\n      if (fs.existsSync(destFile) && !force) {\n        skipped.push(name)\n        continue\n      }\n      fs.copyFileSync(path.join(agentsDir, name), destFile)\n      log.ok(`Added ${path.relative(root, destFile)}`)\n    }\n    if (skipped.length > 0) {\n      log.warn(\n        `Skipped existing ${skipped.join(\", \")} in ${AGENTS_KNOWLEDGE_DIR}/. Use --force to overwrite.`,\n      )\n    }\n  }\n  return 0\n}\n\n/**\n * Re-sync a managed AGENTS.md (and its `agents/*.md` knowledge files) from the\n * framework's canonical copies. Only touches the app when AGENTS.md is already\n * present (opt-in via `vantage add agents`), and only rewrites files whose\n * content actually changed; bundled files missing locally are created, but\n * local files outside the bundle are never deleted. Used by `vantage upgrade`\n * so a single source-of-truth update reflects into apps that adopted the guide.\n */\nexport function syncAgentsFile(root: string): \"updated\" | \"unchanged\" | \"absent\" {\n  const dest = path.join(root, AGENTS_FILE)\n  if (!fs.existsSync(dest)) return \"absent\"\n\n  let changed = false\n\n  const src = bundledAgentsPath(root)\n  if (src) {\n    const next = fs.readFileSync(src, \"utf8\")\n    if (fs.readFileSync(dest, \"utf8\") !== next) {\n      fs.writeFileSync(dest, next)\n      changed = true\n    }\n  }\n\n  const agentsDir = bundledAgentsDir(root)\n  if (agentsDir) {\n    const destAgentsDir = path.join(root, AGENTS_KNOWLEDGE_DIR)\n    fs.mkdirSync(destAgentsDir, { recursive: true })\n    for (const name of listBundledAgentsFiles(agentsDir)) {\n      const srcFile = path.join(agentsDir, name)\n      const destFile = path.join(destAgentsDir, name)\n      const next = fs.readFileSync(srcFile, \"utf8\")\n      if (!fs.existsSync(destFile) || fs.readFileSync(destFile, \"utf8\") !== next) {\n        fs.writeFileSync(destFile, next)\n        changed = true\n      }\n    }\n  }\n\n  return changed ? \"updated\" : \"unchanged\"\n}\n\nfunction copyFromRegistry(root: string, kind: \"ui\" | \"block\", name: string, force: boolean): number {\n  const registry = resolveRegistryDir(root)\n  if (!registry) {\n    log.error(\"Could not resolve the Vantage registry.\")\n    return 1\n  }\n  const sub = kind === \"ui\" ? \"ui\" : \"blocks\"\n  const src = path.join(registry, sub, `${name}.tsx`)\n  if (!fs.existsSync(src)) {\n    const available = fs.existsSync(path.join(registry, sub))\n      ? fs.readdirSync(path.join(registry, sub)).map((f) => f.replace(/\\.tsx$/, \"\"))\n      : []\n    log.error(`Unknown ${kind} \"${name}\". Available: ${available.join(\", \") || \"(none)\"}`)\n    return 1\n  }\n  // Copies land next to the pages that import them (src/components/… when the\n  // project has a src/ layout).\n  const destDir = path.join(resolvePageRoot(root).abs, \"components\", kind === \"ui\" ? \"ui\" : \"blocks\")\n  const dest = path.join(destDir, `${name}.tsx`)\n  if (fs.existsSync(dest) && !force) {\n    log.error(`${path.relative(root, dest)} already exists. Use --force to overwrite.`)\n    return 1\n  }\n  fs.mkdirSync(destDir, { recursive: true })\n  fs.copyFileSync(src, dest)\n  log.ok(`Added ${path.relative(root, dest)}`)\n  return 0\n}\n\n/** `vantage add <page|api|ui|block|skill> <name>` */\nexport async function add(root: string, args: ParsedArgs): Promise<number> {\n  const kind = args.positionals[1]\n  const name = args.positionals[2]\n  const force = Boolean(args.flags.force)\n  const all = Boolean(args.flags.all)\n\n  // `skill` accepts `--all` in place of a name, and `agents` takes no name at\n  // all; handle both before the name guard.\n  if (kind === \"skill\") {\n    const dir = typeof args.flags.dir === \"string\" ? args.flags.dir : undefined\n    return addSkill(root, name, all, force, dir)\n  }\n  if (kind === \"agents\") return addAgents(root, force)\n\n  if (!kind || !name) {\n    log.error(\"Usage: vantage add <page|api|ui|block|skill|agents> <name>\")\n    return 1\n  }\n\n  if (kind === \"page\") {\n    // Pages are named by their route, so they go under the page root — src/\n    // when the project has one, the project root otherwise.\n    const pageRoot = resolvePageRoot(root).abs\n    const file = path.join(pageRoot, name.endsWith(\".tsx\") ? name : `${name}.tsx`)\n    if (fs.existsSync(file) && !force) {\n      log.error(`${path.relative(root, file)} already exists. Use --force to overwrite.`)\n      return 1\n    }\n    fs.mkdirSync(path.dirname(file), { recursive: true })\n    fs.writeFileSync(file, pageTemplate(name))\n    log.ok(`Added page ${path.relative(root, file)}`)\n    return 0\n  }\n\n  if (kind === \"api\") {\n    const rel = name.startsWith(\"server/api/\") ? name : path.join(\"server\", \"api\", name)\n    const file = path.join(root, rel.endsWith(\".ts\") ? rel : `${rel}.ts`)\n    if (fs.existsSync(file) && !force) {\n      log.error(`${path.relative(root, file)} already exists. Use --force to overwrite.`)\n      return 1\n    }\n    fs.mkdirSync(path.dirname(file), { recursive: true })\n    fs.writeFileSync(file, apiTemplate())\n    log.ok(`Added API ${path.relative(root, file)}`)\n    return 0\n  }\n\n  if (kind === \"ui\") return copyFromRegistry(root, \"ui\", name, force)\n  if (kind === \"block\") return copyFromRegistry(root, \"block\", name, force)\n\n  log.error(`Unknown add target \"${kind}\". Use one of: page, api, ui, block, skill, agents.`)\n  return 1\n}\n"]}

package/dist/{chunk-PSEYFYAP.js → chunk-VVOXG6ZU.js}

@@ -1,6 +1,6 @@
-import { detectApiMethods, stripComments } from './chunk-BAM33YZ6.js';
-import { timed } from './chunk-D4Y5RWJA.js';
-import { PUBLIC_ENV_PREFIX, FORBIDDEN_FILES, PAGE_EXTENSIONS, SRC_DIR, SUSPICIOUS_ROUTE_DIRS, API_METHODS } from './chunk-C4MQRWXS.js';
+import { detectApiMethods, stripComments } from './chunk-B45WAO5Q.js';
+import { timed } from './chunk-YE4CPCXX.js';
+import { PUBLIC_ENV_PREFIX, FORBIDDEN_FILES, ROUTED_EXTENSIONS, SRC_DIR, SUSPICIOUS_ROUTE_DIRS, FILE_PAGE_EXTENSIONS, FILE_PAGE_MAX_BYTES, API_METHODS } from './chunk-TDUIW7LD.js';
 import fs from 'fs';
 import path from 'path';
 
@@ -35,6 +35,7 @@ function collectClientFiles(root) {
 }
 function createCtx(root, model) {
   const sources = /* @__PURE__ */ new Map();
+  const sizes = /* @__PURE__ */ new Map();
   let clientFiles = null;
   let rootEntries = null;
   return {
@@ -52,6 +53,18 @@ function createCtx(root, model) {
       sources.set(abs, src);
       return src;
     },
+    size(abs) {
+      const hit = sizes.get(abs);
+      if (hit !== void 0) return hit;
+      let bytes;
+      try {
+        bytes = fs.statSync(abs).size;
+      } catch {
+        bytes = null;
+      }
+      sizes.set(abs, bytes);
+      return bytes;
+    },
     clientFiles() {
       return clientFiles ??= collectClientFiles(root);
     },
@@ -91,7 +104,9 @@ function checkSrcLayout(ctx) {
   if (model.pageDir === "") return [];
   const diags = [];
   const entries = ctx.rootEntries();
-  const strayPages = entries.filter((name) => PAGE_EXTENSIONS.some((ext) => name.endsWith(ext)));
+  const strayPages = entries.filter(
+    (name) => ROUTED_EXTENSIONS.some((ext) => name.toLowerCase().endsWith(ext))
+  );
   if (strayPages.length > 0) {
     diags.push({
       code: "SRC_DIR_SPLIT",
@@ -158,17 +173,60 @@ function checkRouteConflicts(model) {
         severity: "error",
         message: `${files.length} files resolve to ${routePath}`,
         files,
-        fix: "Rename or remove one route file so each route is unique."
+        fix: "Rename or remove one route file so each route is unique. A page-kind suffix and a data-file extension both drop out of the URL, so `june.slide.tsx`, `june.csv` and `june.tsx` all resolve to /june."
       });
     }
   }
   return diags;
 }
+function checkUnroutedFiles(ctx) {
+  const diags = [];
+  for (const entry of ctx.model.unrouted) {
+    if (entry.reason === "extension") {
+      diags.push({
+        code: "UNSUPPORTED_PAGE_FILE",
+        severity: "warning",
+        message: `"${entry.file}" is not a page: Vantage has no viewer for "${path.posix.extname(
+          entry.file
+        )}".`,
+        files: [entry.file],
+        fix: `Only ${FILE_PAGE_EXTENSIONS.join(" and ")} files become pages. Convert it, or render it from a .tsx page with <TableViewer> from @squadbase/vantage/table.`
+      });
+      continue;
+    }
+    diags.push({
+      code: "INVALID_PAGE_VARIANT",
+      severity: "error",
+      message: `"${entry.file}" carries the "${entry.variant}" page kind but is not a page module, so it is not routed.`,
+      files: [entry.file],
+      fix: `A page kind only applies to a page module that becomes a route: name it <name>.${entry.variant}.tsx. Layouts, _404/_error and underscore-prefixed modules cannot carry one.`
+    });
+  }
+  return diags;
+}
+function checkFilePageSize(ctx) {
+  const diags = [];
+  for (const page of ctx.model.pages) {
+    if (page.kind !== "file") continue;
+    const size = ctx.size(page.absFile);
+    if (size === null || size <= FILE_PAGE_MAX_BYTES) continue;
+    diags.push({
+      code: "FILE_PAGE_TOO_LARGE",
+      severity: "warning",
+      message: `${page.file} is ${(size / 1024 / 1024).toFixed(1)} MB, so ${page.routePath} will show an error instead of a table.`,
+      files: [page.file],
+      fix: `Data-file pages are parsed in the browser and capped at ${FILE_PAGE_MAX_BYTES / 1024 / 1024} MB. Serve larger data from server/api/ and render it with DataTable.`
+    });
+  }
+  return diags;
+}
 function checkPageExports(ctx) {
   const { root, model } = ctx;
   const diags = [];
   const pageFiles = [
-    ...model.pages.map((p) => p.absFile),
+    // Data-file pages have no default export to look for — their component is
+    // the generated wrapper, not the `.csv` itself.
+    ...model.pages.filter((p) => p.kind === "module").map((p) => p.absFile),
     ...model.layouts.map((l) => l.absFile),
     model.notFound && path.join(root, model.notFound),
     model.error && path.join(root, model.error)
@@ -263,6 +321,8 @@ function runDiagnostics(root, model) {
       ...checkSrcLayout(ctx),
       ...checkSuspiciousRouteDirs(model),
       ...checkRouteConflicts(model),
+      ...checkUnroutedFiles(ctx),
+      ...checkFilePageSize(ctx),
       ...checkPageExports(ctx),
       ...checkApiExports(ctx),
       ...client.boundary,
@@ -272,5 +332,5 @@ function runDiagnostics(root, model) {
 }
 
 export { runDiagnostics };
-//# sourceMappingURL=chunk-PSEYFYAP.js.map
-//# sourceMappingURL=chunk-PSEYFYAP.js.map
+//# sourceMappingURL=chunk-VVOXG6ZU.js.map
+//# sourceMappingURL=chunk-VVOXG6ZU.js.map

package/dist/chunk-VVOXG6ZU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/diagnostics.ts"],"names":[],"mappings":"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","file":"chunk-VVOXG6ZU.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport {\n  API_METHODS,\n  FILE_PAGE_EXTENSIONS,\n  FILE_PAGE_MAX_BYTES,\n  FORBIDDEN_FILES,\n  PUBLIC_ENV_PREFIX,\n  ROUTED_EXTENSIONS,\n  SRC_DIR,\n  SUSPICIOUS_ROUTE_DIRS,\n} from \"./constants\"\nimport { timed } from \"./profile\"\nimport { detectApiMethods } from \"./route-spec\"\nimport { stripComments } from \"./source\"\nimport type { Diagnostic, RouteModel } from \"./types\"\n\n/** Vite/env identifiers that are always allowed on `import.meta.env`. */\nconst ALLOWED_ENV_KEYS = new Set([\"MODE\", \"DEV\", \"PROD\", \"SSR\", \"BASE_URL\", \"PUBLIC_\"])\n\n/** Whether a module has a default export (direct, aliased, or re-exported). */\nfunction hasDefaultExport(src: string): boolean {\n  return (\n    /\\bexport\\s+default\\b/.test(src) ||\n    /\\bexport\\s*\\{[^}]*\\bas\\s+default\\b[^}]*\\}/.test(src) ||\n    /\\bexport\\s*\\{[^}]*\\bdefault\\b[^}]*\\}\\s*from\\b/.test(src)\n  )\n}\n\n/** Collect client-side source files (everything outside server/ and generated dirs). */\nfunction collectClientFiles(root: string): string[] {\n  const out: string[] = []\n  const skipDirs = new Set([\"node_modules\", \".vantage\", \"dist\", \"server\", \"public\"])\n  const walk = (dir: string) => {\n    let entries: fs.Dirent[]\n    try {\n      entries = fs.readdirSync(dir, { withFileTypes: true })\n    } catch {\n      return\n    }\n    for (const entry of entries) {\n      if (entry.name.startsWith(\".\")) continue\n      const abs = path.join(dir, entry.name)\n      if (entry.isDirectory()) {\n        if (skipDirs.has(entry.name)) continue\n        walk(abs)\n      } else if (/\\.(tsx?|jsx?)$/.test(entry.name)) {\n        out.push(abs)\n      }\n    }\n  }\n  walk(root)\n  return out\n}\n\n/**\n * Per-run scratch space. Every checker reads the filesystem through this, so a\n * `check` walks the project once and reads (and `stripComments`) each source\n * file at most once — page modules used to be read three times over, and the\n * client tree used to be walked twice.\n */\ninterface Ctx {\n  root: string\n  model: RouteModel\n  /** Comment-stripped source for an absolute path; null when unreadable. */\n  source(abs: string): string | null\n  /**\n   * Byte size of a file; null when unreadable. Separate from `source` because\n   * `source` decodes as UTF-8 and strips comments — fine for a page module,\n   * ruinous for a few MB of spreadsheet.\n   */\n  size(abs: string): number | null\n  /** Client-side source files, walked lazily and only once. */\n  clientFiles(): string[]\n  /** `readdir` of the project root, read lazily and only once. */\n  rootEntries(): string[]\n}\n\nfunction createCtx(root: string, model: RouteModel): Ctx {\n  const sources = new Map<string, string | null>()\n  const sizes = new Map<string, number | null>()\n  let clientFiles: string[] | null = null\n  let rootEntries: string[] | null = null\n\n  return {\n    root,\n    model,\n    source(abs) {\n      const hit = sources.get(abs)\n      if (hit !== undefined) return hit\n      let src: string | null\n      try {\n        src = stripComments(fs.readFileSync(abs, \"utf8\"))\n      } catch {\n        src = null\n      }\n      sources.set(abs, src)\n      return src\n    },\n    size(abs) {\n      const hit = sizes.get(abs)\n      if (hit !== undefined) return hit\n      let bytes: number | null\n      try {\n        bytes = fs.statSync(abs).size\n      } catch {\n        bytes = null\n      }\n      sizes.set(abs, bytes)\n      return bytes\n    },\n    clientFiles() {\n      return (clientFiles ??= collectClientFiles(root))\n    },\n    rootEntries() {\n      if (rootEntries) return rootEntries\n      try {\n        rootEntries = fs.readdirSync(root)\n      } catch {\n        rootEntries = []\n      }\n      return rootEntries\n    },\n  }\n}\n\nfunction rel(root: string, abs: string): string {\n  return path.relative(root, abs).split(path.sep).join(\"/\")\n}\n\n/** Detect forbidden config files at the project root. */\nfunction checkForbiddenFiles(ctx: Ctx): Diagnostic[] {\n  const diags: Diagnostic[] = []\n  for (const name of ctx.rootEntries()) {\n    for (const rule of FORBIDDEN_FILES) {\n      if (rule.pattern.test(name)) {\n        diags.push({\n          code: \"FORBIDDEN_FILE\",\n          severity: \"error\",\n          message: `${rule.label} file \"${name}\" is not allowed in a Vantage project.`,\n          files: [name],\n          fix: rule.remedy,\n        })\n      }\n    }\n  }\n  return diags\n}\n\n/**\n * Detect a project split between `src/` and the project root. Once `src/`\n * exists it is the only page-scan root, so anything left behind at the root is\n * silently dead — and `server/` moved *into* `src/` is silently unserved.\n */\nfunction checkSrcLayout(ctx: Ctx): Diagnostic[] {\n  const { root, model } = ctx\n  if (model.pageDir === \"\") return []\n  const diags: Diagnostic[] = []\n\n  const entries = ctx.rootEntries()\n  // Lowercased before matching, as scan does: `Sales.CSV` at the root is a\n  // stray page too, and saying so is the whole point of this check.\n  const strayPages = entries.filter((name) =>\n    ROUTED_EXTENSIONS.some((ext) => name.toLowerCase().endsWith(ext)),\n  )\n  if (strayPages.length > 0) {\n    diags.push({\n      code: \"SRC_DIR_SPLIT\",\n      severity: \"error\",\n      message: `${strayPages.length} page module(s) sit at the project root, but ${SRC_DIR}/ exists so pages are only scanned from ${SRC_DIR}/.`,\n      files: strayPages.sort(),\n      fix: `Move them into ${SRC_DIR}/, or delete ${SRC_DIR}/ to keep a root-level layout.`,\n    })\n  }\n\n  if (entries.includes(\"styles.css\")) {\n    diags.push({\n      code: \"SRC_DIR_SPLIT\",\n      severity: \"error\",\n      message: `styles.css sits at the project root, but ${SRC_DIR}/ exists so the global stylesheet is read from ${SRC_DIR}/styles.css.`,\n      files: [\"styles.css\"],\n      fix: `Move it to ${SRC_DIR}/styles.css.`,\n    })\n  }\n\n  if (fs.existsSync(path.join(root, SRC_DIR, \"server\"))) {\n    diags.push({\n      code: \"SRC_DIR_SPLIT\",\n      severity: \"error\",\n      message: `${SRC_DIR}/server/ is never scanned: server code lives at the project root, outside the client source tree.`,\n      files: [`${SRC_DIR}/server`],\n      fix: `Move it to server/ at the project root.`,\n    })\n  }\n\n  return diags\n}\n\n/** Flag routes generated from directories that are almost certainly scaffolding. */\nfunction checkSuspiciousRouteDirs(model: RouteModel): Diagnostic[] {\n  const byDir = new Map<string, { files: string[]; routes: string[] }>()\n  for (const page of model.pages) {\n    const top = page.dir.split(\"/\")[0] ?? \"\"\n    if (top === \"\" || !SUSPICIOUS_ROUTE_DIRS.has(top)) continue\n    const hit = byDir.get(top) ?? { files: [], routes: [] }\n    hit.files.push(page.file)\n    hit.routes.push(page.routePath)\n    byDir.set(top, hit)\n  }\n\n  const diags: Diagnostic[] = []\n  for (const [dir, hit] of byDir) {\n    diags.push({\n      code: \"SUSPICIOUS_ROUTE_DIR\",\n      severity: \"warning\",\n      message: `${dir}/ is part of the URL: ${hit.routes.slice(0, 3).join(\", \")}${\n        hit.routes.length > 3 ? \", …\" : \"\"\n      }`,\n      files: hit.files,\n      fix: `Directory names become route segments. Non-page modules belong in components/, hooks/ or lib/ (never scanned); if ${dir}/ really is meant to be a URL segment, ignore this warning.`,\n    })\n  }\n  return diags\n}\n\n/** Detect two page files resolving to the same route path. */\nfunction checkRouteConflicts(model: RouteModel): Diagnostic[] {\n  const byPath = new Map<string, string[]>()\n  for (const page of model.pages) {\n    const list = byPath.get(page.routePath) ?? []\n    list.push(page.file)\n    byPath.set(page.routePath, list)\n  }\n  const diags: Diagnostic[] = []\n  for (const [routePath, files] of byPath) {\n    if (files.length > 1) {\n      diags.push({\n        code: \"ROUTE_CONFLICT\",\n        severity: \"error\",\n        message: `${files.length} files resolve to ${routePath}`,\n        files,\n        fix: \"Rename or remove one route file so each route is unique. A page-kind suffix and a data-file extension both drop out of the URL, so `june.slide.tsx`, `june.csv` and `june.tsx` all resolve to /june.\",\n      })\n    }\n  }\n  return diags\n}\n\n/**\n * Speak up about files the scan walked past. Neither case reaches the router,\n * so nothing else in the toolchain has an opportunity to mention them: the\n * page simply never appears in `routes`, in the nav, or at a URL. Without this\n * the only symptom is absence.\n */\nfunction checkUnroutedFiles(ctx: Ctx): Diagnostic[] {\n  const diags: Diagnostic[] = []\n  for (const entry of ctx.model.unrouted) {\n    if (entry.reason === \"extension\") {\n      diags.push({\n        code: \"UNSUPPORTED_PAGE_FILE\",\n        severity: \"warning\",\n        message: `\"${entry.file}\" is not a page: Vantage has no viewer for \"${path.posix.extname(\n          entry.file,\n        )}\".`,\n        files: [entry.file],\n        fix: `Only ${FILE_PAGE_EXTENSIONS.join(\" and \")} files become pages. Convert it, or render it from a .tsx page with <TableViewer> from @squadbase/vantage/table.`,\n      })\n      continue\n    }\n    diags.push({\n      code: \"INVALID_PAGE_VARIANT\",\n      severity: \"error\",\n      message: `\"${entry.file}\" carries the \"${entry.variant}\" page kind but is not a page module, so it is not routed.`,\n      files: [entry.file],\n      fix: `A page kind only applies to a page module that becomes a route: name it <name>.${entry.variant}.tsx. Layouts, _404/_error and underscore-prefixed modules cannot carry one.`,\n    })\n  }\n  return diags\n}\n\n/**\n * Data-file pages are parsed in the browser, so an oversized file does not\n * fail the build — it renders an error on its own page. A warning, not an\n * error, keeps one large export from blocking a deploy of everything else.\n */\nfunction checkFilePageSize(ctx: Ctx): Diagnostic[] {\n  const diags: Diagnostic[] = []\n  for (const page of ctx.model.pages) {\n    if (page.kind !== \"file\") continue\n    const size = ctx.size(page.absFile)\n    if (size === null || size <= FILE_PAGE_MAX_BYTES) continue\n    diags.push({\n      code: \"FILE_PAGE_TOO_LARGE\",\n      severity: \"warning\",\n      message: `${page.file} is ${(size / 1024 / 1024).toFixed(1)} MB, so ${page.routePath} will show an error instead of a table.`,\n      files: [page.file],\n      fix: `Data-file pages are parsed in the browser and capped at ${\n        FILE_PAGE_MAX_BYTES / 1024 / 1024\n      } MB. Serve larger data from server/api/ and render it with DataTable.`,\n    })\n  }\n  return diags\n}\n\n/** Ensure every page module has a default export. */\nfunction checkPageExports(ctx: Ctx): Diagnostic[] {\n  const { root, model } = ctx\n  const diags: Diagnostic[] = []\n  const pageFiles = [\n    // Data-file pages have no default export to look for — their component is\n    // the generated wrapper, not the `.csv` itself.\n    ...model.pages.filter((p) => p.kind === \"module\").map((p) => p.absFile),\n    ...model.layouts.map((l) => l.absFile),\n    model.notFound && path.join(root, model.notFound),\n    model.error && path.join(root, model.error),\n  ].filter((x): x is string => Boolean(x))\n\n  for (const abs of pageFiles) {\n    const src = ctx.source(abs)\n    if (src === null) continue\n    if (!hasDefaultExport(src)) {\n      diags.push({\n        code: \"MISSING_DEFAULT_EXPORT\",\n        severity: \"error\",\n        message: `Page module has no default export.`,\n        files: [rel(root, abs)],\n        fix: \"A page/layout must `export default` a React component.\",\n      })\n    }\n  }\n  return diags\n}\n\n/** Ensure every API module exports at least one valid HTTP method handler. */\nfunction checkApiExports(ctx: Ctx): Diagnostic[] {\n  const diags: Diagnostic[] = []\n  for (const api of ctx.model.apis) {\n    const src = ctx.source(api.absFile)\n    if (src === null) continue\n    const exported = detectApiMethods(src)\n    if (exported.length === 0) {\n      // Common mistake: lowercase method names.\n      const lower = [\"get\", \"post\", \"put\", \"patch\", \"delete\", \"options\"].filter((m) =>\n        new RegExp(`export\\\\s+(async\\\\s+)?function\\\\s+${m}\\\\b`).test(src),\n      )\n      diags.push({\n        code: \"INVALID_API_EXPORT\",\n        severity: \"error\",\n        message: `API module exports no HTTP method handler${\n          lower.length ? ` (found lowercase \"${lower.join(\", \")}\")` : \"\"\n        }.`,\n        files: [api.file],\n        fix: `Export one of: ${API_METHODS.join(\", \")} (uppercase).`,\n      })\n    }\n  }\n  return diags\n}\n\n/**\n * The two source-level client checks — the server-import boundary and non-public\n * env reads — in a single pass over the client tree. They used to walk and read\n * the whole tree once each; the diagnostics are still emitted grouped by code so\n * the reported order is unchanged.\n */\nfunction checkClientSources(ctx: Ctx): { boundary: Diagnostic[]; env: Diagnostic[] } {\n  const { root } = ctx\n  const boundary: Diagnostic[] = []\n  const env: Diagnostic[] = []\n  const importRe = /(?:import|export)[^'\"]*?from\\s+[\"']([^\"']+)[\"']|import\\s*\\(\\s*[\"']([^\"']+)[\"']\\s*\\)/g\n  const envRe = /import\\.meta\\.env\\.([A-Za-z_][A-Za-z0-9_]*)/g\n\n  for (const abs of ctx.clientFiles()) {\n    const src = ctx.source(abs)\n    if (src === null) continue\n\n    let m: RegExpExecArray | null\n    importRe.lastIndex = 0\n    while ((m = importRe.exec(src))) {\n      const spec = m[1] ?? m[2]\n      if (!spec) continue\n      const isServer =\n        spec === \"server\" ||\n        spec.startsWith(\"server/\") ||\n        /(^|\\/)\\.\\.?\\/server(\\/|$)/.test(spec) ||\n        /\\/server\\//.test(spec)\n      if (isServer) {\n        boundary.push({\n          code: \"CLIENT_IMPORTS_SERVER\",\n          severity: \"error\",\n          message: `Client module imports from server/ (\"${spec}\").`,\n          files: [rel(root, abs)],\n          fix: \"server/ code must never be imported by the client. Move shared code to lib/.\",\n        })\n      }\n    }\n\n    envRe.lastIndex = 0\n    const bad = new Set<string>()\n    while ((m = envRe.exec(src))) {\n      const key = m[1]!\n      if (ALLOWED_ENV_KEYS.has(key)) continue\n      if (key.startsWith(PUBLIC_ENV_PREFIX)) continue\n      bad.add(key)\n    }\n    for (const key of bad) {\n      env.push({\n        code: \"PUBLIC_ENV_MISUSE\",\n        severity: \"warning\",\n        message: `Client reads non-public env \"import.meta.env.${key}\".`,\n        files: [rel(root, abs)],\n        fix: `Only ${PUBLIC_ENV_PREFIX}* vars reach the client. Read secrets via ApiContext.env in server/.`,\n      })\n    }\n  }\n  return { boundary, env }\n}\n\n/** Run all static diagnostics for a project. */\nexport function runDiagnostics(root: string, model: RouteModel): Diagnostic[] {\n  return timed(\"diagnostics\", () => {\n    const ctx = createCtx(root, model)\n    const client = checkClientSources(ctx)\n    return [\n      ...checkForbiddenFiles(ctx),\n      ...checkSrcLayout(ctx),\n      ...checkSuspiciousRouteDirs(model),\n      ...checkRouteConflicts(model),\n      ...checkUnroutedFiles(ctx),\n      ...checkFilePageSize(ctx),\n      ...checkPageExports(ctx),\n      ...checkApiExports(ctx),\n      ...client.boundary,\n      ...client.env,\n    ]\n  })\n}\n"]}

package/dist/{chunk-D4Y5RWJA.js → chunk-YE4CPCXX.js}

@@ -1,4 +1,4 @@
-import { SRC_DIR, RESERVED_PAGE_NAMES, NON_ROUTE_DIRS, PAGE_EXTENSIONS, API_EXTENSIONS } from './chunk-C4MQRWXS.js';
+import { SRC_DIR, RESERVED_PAGE_NAMES, PAGE_VARIANTS, UNSUPPORTED_PAGE_EXTENSIONS, NON_ROUTE_DIRS, PAGE_EXTENSIONS, FILE_PAGE_EXTENSIONS, API_EXTENSIONS } from './chunk-TDUIW7LD.js';
 import fs from 'fs';
 import path from 'path';
 
@@ -59,6 +59,22 @@ function stripExt(file, exts) {
   }
   return file;
 }
+function splitPageVariant(nameNoExt) {
+  for (const variant of PAGE_VARIANTS) {
+    const suffix = `.${variant}`;
+    if (nameNoExt.endsWith(suffix) && nameNoExt.length > suffix.length) {
+      return { base: nameNoExt.slice(0, -suffix.length), variant };
+    }
+  }
+  return { base: nameNoExt, variant: null };
+}
+function matchFilePageExt(base) {
+  const lower = base.toLowerCase();
+  return FILE_PAGE_EXTENSIONS.find((ext) => lower.endsWith(ext));
+}
+function isLockFile(base) {
+  return base.startsWith("~$");
+}
 function hasExt(file, exts) {
   return exts.some((ext) => file.endsWith(ext));
 }
@@ -93,38 +109,82 @@ function scanPages(root, pageRoot) {
   walk(pageRoot, pageRoot, files);
   const pages = [];
   const layouts = [];
+  const unrouted = [];
   let notFound = null;
   let error = null;
   for (const abs of files) {
     const file = toPosix(root, abs);
     const rel = toPosix(pageRoot, abs);
     const base = path.posix.basename(rel);
-    if (!hasExt(base, PAGE_EXTENSIONS)) continue;
-    const nameNoExt = stripExt(base, PAGE_EXTENSIONS);
     const dir = path.posix.dirname(rel);
     const dirPosix = dir === "." ? "" : dir;
-    if (nameNoExt === RESERVED_PAGE_NAMES.layout) {
-      layouts.push({ file, absFile: abs, dir: dirPosix });
+    if (hasExt(base, PAGE_EXTENSIONS)) {
+      const nameNoExt = stripExt(base, PAGE_EXTENSIONS);
+      if (nameNoExt === RESERVED_PAGE_NAMES.layout) {
+        layouts.push({ file, absFile: abs, dir: dirPosix });
+        continue;
+      }
+      if (nameNoExt === RESERVED_PAGE_NAMES.notFound) {
+        if (dirPosix === "") notFound = file;
+        continue;
+      }
+      if (nameNoExt === RESERVED_PAGE_NAMES.error) {
+        if (dirPosix === "") error = file;
+        continue;
+      }
+      const { base: pageName, variant } = splitPageVariant(nameNoExt);
+      if (pageName.startsWith("_")) {
+        if (variant) unrouted.push({ file, reason: "variant", variant });
+        continue;
+      }
+      const relNoExt = stripExt(rel, PAGE_EXTENSIONS);
+      const relForSegments = variant ? relNoExt.slice(0, -(variant.length + 1)) : relNoExt;
+      const segments = fileToSegments(relForSegments);
+      const routePath = displayPath(segments);
+      const dynamic = segments.some((s) => s.kind !== "static");
+      pages.push({
+        file,
+        absFile: abs,
+        routePath,
+        segments,
+        dir: dirPosix,
+        dynamic,
+        kind: "module",
+        ...variant ? { variant } : {}
+      });
       continue;
     }
-    if (nameNoExt === RESERVED_PAGE_NAMES.notFound) {
-      if (dirPosix === "") notFound = file;
+    const fileExt = matchFilePageExt(base);
+    if (fileExt) {
+      if (base.startsWith("_") || base.startsWith(".") || isLockFile(base)) continue;
+      const relNoExt = rel.slice(0, -fileExt.length);
+      const segments = fileToSegments(relNoExt);
+      const routePath = displayPath(segments);
+      const dynamic = segments.some((s) => s.kind !== "static");
+      pages.push({
+        file,
+        absFile: abs,
+        routePath,
+        segments,
+        dir: dirPosix,
+        dynamic,
+        kind: "file",
+        fileExt
+      });
       continue;
     }
-    if (nameNoExt === RESERVED_PAGE_NAMES.error) {
-      if (dirPosix === "") error = file;
-      continue;
+    const lower = base.toLowerCase();
+    const strayVariant = PAGE_VARIANTS.find((v) => lower.includes(`.${v}.`));
+    if (strayVariant) {
+      unrouted.push({ file, reason: "variant", variant: strayVariant });
+    } else if (UNSUPPORTED_PAGE_EXTENSIONS.some((ext) => lower.endsWith(ext))) {
+      unrouted.push({ file, reason: "extension" });
     }
-    if (nameNoExt.startsWith("_")) continue;
-    const relNoExt = stripExt(rel, PAGE_EXTENSIONS);
-    const segments = fileToSegments(relNoExt);
-    const routePath = displayPath(segments);
-    const dynamic = segments.some((s) => s.kind !== "static");
-    pages.push({ file, absFile: abs, routePath, segments, dir: dirPosix, dynamic });
   }
   pages.sort((a, b) => routeSortKey(a).localeCompare(routeSortKey(b)));
   layouts.sort((a, b) => a.dir.localeCompare(b.dir));
-  return { pages, layouts, notFound, error };
+  unrouted.sort((a, b) => a.file.localeCompare(b.file));
+  return { pages, layouts, notFound, error, unrouted };
 }
 function routeSortKey(p) {
   return p.segments.map((s) => s.kind === "static" ? "0" + s.value : s.kind === "param" ? "1" : "2").join("/");
@@ -177,13 +237,13 @@ function scanApis(root) {
 function scanProject(root) {
   return timed("scan", () => {
     const pageRoot = resolvePageRoot(root);
-    const { pages, layouts, notFound, error } = scanPages(root, pageRoot.abs);
+    const { pages, layouts, notFound, error, unrouted } = scanPages(root, pageRoot.abs);
     const hasServer = fs.existsSync(path.join(root, "server"));
     const apis = hasServer ? scanApis(root) : [];
-    return { pages, layouts, notFound, error, apis, hasServer, pageDir: pageRoot.dir };
+    return { pages, layouts, notFound, error, apis, hasServer, pageDir: pageRoot.dir, unrouted };
   });
 }
 
 export { resolvePageRoot, scanProject, timed, timedAsync };
-//# sourceMappingURL=chunk-D4Y5RWJA.js.map
-//# sourceMappingURL=chunk-D4Y5RWJA.js.map
+//# sourceMappingURL=chunk-YE4CPCXX.js.map
+//# sourceMappingURL=chunk-YE4CPCXX.js.map