@squadbase/vantage 0.2.3 → 0.3.1

package/dist/chunk-D4Y5RWJA.js

@@ -0,0 +1,189 @@
+import { SRC_DIR, RESERVED_PAGE_NAMES, NON_ROUTE_DIRS, PAGE_EXTENSIONS, API_EXTENSIONS } from './chunk-C4MQRWXS.js';
+import fs from 'fs';
+import path from 'path';
+
+// @squadbase/vantage — generated build. Do not edit.
+
+// src/core/profile.ts
+var ENABLED = Boolean(process.env.VANTAGE_PROFILE);
+function report(label, ms) {
+  const since = (performance.now() / 1e3).toFixed(3);
+  process.stderr.write(`[vantage:profile] ${label.padEnd(24)} ${ms.toFixed(1).padStart(8)}ms  @${since}s
+`);
+}
+function timed(label, fn) {
+  if (!ENABLED) return fn();
+  const t0 = performance.now();
+  try {
+    return fn();
+  } finally {
+    report(label, performance.now() - t0);
+  }
+}
+async function timedAsync(label, fn) {
+  if (!ENABLED) return fn();
+  const t0 = performance.now();
+  try {
+    return await fn();
+  } finally {
+    report(label, performance.now() - t0);
+  }
+}
+function toPosix(root, abs) {
+  return path.relative(root, abs).split(path.sep).join("/");
+}
+function parseRawSegment(raw) {
+  const catchall = raw.match(/^\[\.\.\.(.+)\]$/);
+  if (catchall) return { kind: "catchall", name: catchall[1] };
+  const param = raw.match(/^\[(.+)\]$/);
+  if (param) return { kind: "param", name: param[1] };
+  return { kind: "static", value: raw };
+}
+function displayPath(segments) {
+  if (segments.length === 0) return "/";
+  const parts = segments.map((s) => {
+    if (s.kind === "static") return s.value;
+    if (s.kind === "param") return `:${s.name}`;
+    return "*";
+  });
+  return "/" + parts.join("/");
+}
+function fileToSegments(relNoExt) {
+  const raw = relNoExt.split("/");
+  if (raw[raw.length - 1] === "index") raw.pop();
+  return raw.map(parseRawSegment);
+}
+function stripExt(file, exts) {
+  for (const ext of exts) {
+    if (file.endsWith(ext)) return file.slice(0, -ext.length);
+  }
+  return file;
+}
+function hasExt(file, exts) {
+  return exts.some((ext) => file.endsWith(ext));
+}
+function walk(dir, root, out) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const abs = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (NON_ROUTE_DIRS.has(entry.name)) continue;
+      if (entry.name.startsWith(".")) continue;
+      walk(abs, root, out);
+    } else if (entry.isFile()) {
+      out.push(abs);
+    }
+  }
+}
+function resolvePageRoot(root) {
+  const abs = path.join(root, SRC_DIR);
+  try {
+    if (fs.statSync(abs).isDirectory()) return { dir: SRC_DIR, abs };
+  } catch {
+  }
+  return { dir: "", abs: root };
+}
+function scanPages(root, pageRoot) {
+  const files = [];
+  walk(pageRoot, pageRoot, files);
+  const pages = [];
+  const layouts = [];
+  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 });
+      continue;
+    }
+    if (nameNoExt === RESERVED_PAGE_NAMES.notFound) {
+      if (dirPosix === "") notFound = file;
+      continue;
+    }
+    if (nameNoExt === RESERVED_PAGE_NAMES.error) {
+      if (dirPosix === "") error = file;
+      continue;
+    }
+    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 };
+}
+function routeSortKey(p) {
+  return p.segments.map((s) => s.kind === "static" ? "0" + s.value : s.kind === "param" ? "1" : "2").join("/");
+}
+function scanApis(root) {
+  const apiDir = path.join(root, "server", "api");
+  if (!fs.existsSync(apiDir)) return [];
+  const files = [];
+  const walkApi = (dir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const abs = path.join(dir, entry.name);
+      if (entry.isDirectory()) walkApi(abs);
+      else if (entry.isFile()) files.push(abs);
+    }
+  };
+  walkApi(apiDir);
+  const apis = [];
+  for (const abs of files) {
+    const base = path.basename(abs);
+    if (!hasExt(base, API_EXTENSIONS)) continue;
+    const nameNoExt = stripExt(base, API_EXTENSIONS);
+    if (base.endsWith(".d.ts")) continue;
+    if (nameNoExt.startsWith("_")) continue;
+    const relFromServer = toPosix(path.join(root, "server"), abs);
+    const relNoExt = stripExt(relFromServer, API_EXTENSIONS);
+    const withoutApiPrefix = relNoExt.replace(/^api\/?/, "");
+    const segTokens = withoutApiPrefix === "" ? [] : withoutApiPrefix.split("/");
+    if (segTokens[segTokens.length - 1] === "index") segTokens.pop();
+    const segments = segTokens.map(parseRawSegment);
+    const routePath = "/api" + (segments.length ? displayPath(segments) : "");
+    const params = segments.filter((s) => s.kind !== "static").map((s) => s.name);
+    apis.push({
+      file: toPosix(root, abs),
+      absFile: abs,
+      routePath,
+      pattern: routePath,
+      segments,
+      params
+    });
+  }
+  apis.sort((a, b) => a.routePath.localeCompare(b.routePath));
+  return apis;
+}
+function scanProject(root) {
+  return timed("scan", () => {
+    const pageRoot = resolvePageRoot(root);
+    const { pages, layouts, notFound, error } = 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 };
+  });
+}
+
+export { resolvePageRoot, scanProject, timed, timedAsync };
+//# sourceMappingURL=chunk-D4Y5RWJA.js.map
+//# sourceMappingURL=chunk-D4Y5RWJA.js.map

package/dist/chunk-D4Y5RWJA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/profile.ts","../src/core/scan.ts"],"names":[],"mappings":";;;;;;;AAQA,IAAM,OAAA,GAAU,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,eAAe,CAAA;AAKnD,SAAS,MAAA,CAAO,OAAe,EAAA,EAAkB;AAC/C,EAAA,MAAM,SAAS,WAAA,CAAY,GAAA,EAAI,GAAI,GAAA,EAAM,QAAQ,CAAC,CAAA;AAClD,EAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA,kBAAA,EAAqB,KAAA,CAAM,MAAA,CAAO,EAAE,CAAC,CAAA,CAAA,EAAI,EAAA,CAAG,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA,CAAS,CAAC,CAAC,QAAQ,KAAK,CAAA;AAAA,CAAK,CAAA;AAC3G;AAGO,SAAS,KAAA,CAAS,OAAe,EAAA,EAAgB;AACtD,EAAA,IAAI,CAAC,OAAA,EAAS,OAAO,EAAA,EAAG;AACxB,EAAA,MAAM,EAAA,GAAK,YAAY,GAAA,EAAI;AAC3B,EAAA,IAAI;AACF,IAAA,OAAO,EAAA,EAAG;AAAA,EACZ,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,KAAA,EAAO,WAAA,CAAY,GAAA,EAAI,GAAI,EAAE,CAAA;AAAA,EACtC;AACF;AAGA,eAAsB,UAAA,CAAc,OAAe,EAAA,EAAkC;AACnF,EAAA,IAAI,CAAC,OAAA,EAAS,OAAO,EAAA,EAAG;AACxB,EAAA,MAAM,EAAA,GAAK,YAAY,GAAA,EAAI;AAC3B,EAAA,IAAI;AACF,IAAA,OAAO,MAAM,EAAA,EAAG;AAAA,EAClB,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,KAAA,EAAO,WAAA,CAAY,GAAA,EAAI,GAAI,EAAE,CAAA;AAAA,EACtC;AACF;ACzBA,SAAS,OAAA,CAAQ,MAAc,GAAA,EAAqB;AAClD,EAAA,OAAO,IAAA,CAAK,QAAA,CAAS,IAAA,EAAM,GAAG,CAAA,CAAE,MAAM,IAAA,CAAK,GAAG,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAC1D;AAGA,SAAS,gBAAgB,GAAA,EAAsB;AAC7C,EAAA,MAAM,QAAA,GAAW,GAAA,CAAI,KAAA,CAAM,kBAAkB,CAAA;AAC7C,EAAA,IAAI,QAAA,SAAiB,EAAE,IAAA,EAAM,YAAY,IAAA,EAAM,QAAA,CAAS,CAAC,CAAA,EAAG;AAC5D,EAAA,MAAM,KAAA,GAAQ,GAAA,CAAI,KAAA,CAAM,YAAY,CAAA;AACpC,EAAA,IAAI,KAAA,SAAc,EAAE,IAAA,EAAM,SAAS,IAAA,EAAM,KAAA,CAAM,CAAC,CAAA,EAAG;AACnD,EAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,KAAA,EAAO,GAAA,EAAI;AACtC;AAGA,SAAS,YAAY,QAAA,EAA6B;AAChD,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,CAAA,EAAG,OAAO,GAAA;AAClC,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM;AAChC,IAAA,IAAI,CAAA,CAAE,IAAA,KAAS,QAAA,EAAU,OAAO,CAAA,CAAE,KAAA;AAClC,IAAA,IAAI,EAAE,IAAA,KAAS,OAAA,EAAS,OAAO,CAAA,CAAA,EAAI,EAAE,IAAI,CAAA,CAAA;AACzC,IAAA,OAAO,GAAA;AAAA,EACT,CAAC,CAAA;AACD,EAAA,OAAO,GAAA,GAAM,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAC7B;AAGA,SAAS,eAAe,QAAA,EAA6B;AACnD,EAAA,MAAM,GAAA,GAAM,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA;AAE9B,EAAA,IAAI,IAAI,GAAA,CAAI,MAAA,GAAS,CAAC,CAAA,KAAM,OAAA,MAAa,GAAA,EAAI;AAC7C,EAAA,OAAO,GAAA,CAAI,IAAI,eAAe,CAAA;AAChC;AAGA,SAAS,QAAA,CAAS,MAAc,IAAA,EAAwB;AACtD,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG,OAAO,KAAK,KAAA,CAAM,CAAA,EAAG,CAAC,GAAA,CAAI,MAAM,CAAA;AAAA,EAC1D;AACA,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,MAAA,CAAO,MAAc,IAAA,EAAyB;AACrD,EAAA,OAAO,KAAK,IAAA,CAAK,CAAC,QAAQ,IAAA,CAAK,QAAA,CAAS,GAAG,CAAC,CAAA;AAC9C;AAGA,SAAS,IAAA,CAAK,GAAA,EAAa,IAAA,EAAc,GAAA,EAAqB;AAC5D,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,GAAG,WAAA,CAAY,GAAA,EAAK,EAAE,aAAA,EAAe,MAAM,CAAA;AAAA,EACvD,CAAA,CAAA,MAAQ;AACN,IAAA;AAAA,EACF;AACA,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,GAAA,EAAK,MAAM,IAAI,CAAA;AACrC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,IAAI,cAAA,CAAe,GAAA,CAAI,KAAA,CAAM,IAAI,CAAA,EAAG;AACpC,MAAA,IAAI,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,EAAG;AAChC,MAAA,IAAA,CAAK,GAAA,EAAK,MAAM,GAAG,CAAA;AAAA,IACrB,CAAA,MAAA,IAAW,KAAA,CAAM,MAAA,EAAO,EAAG;AACzB,MAAA,GAAA,CAAI,KAAK,GAAG,CAAA;AAAA,IACd;AAAA,EACF;AACF;AAOO,SAAS,gBAAgB,IAAA,EAA4C;AAC1E,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,OAAO,CAAA;AACnC,EAAA,IAAI;AACF,IAAA,IAAI,EAAA,CAAG,QAAA,CAAS,GAAG,CAAA,CAAE,WAAA,IAAe,OAAO,EAAE,GAAA,EAAK,OAAA,EAAS,GAAA,EAAI;AAAA,EACjE,CAAA,CAAA,MAAQ;AAAA,EAER;AACA,EAAA,OAAO,EAAE,GAAA,EAAK,EAAA,EAAI,GAAA,EAAK,IAAA,EAAK;AAC9B;AASA,SAAS,SAAA,CACP,MACA,QAAA,EAMA;AACA,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAA,CAAK,QAAA,EAAU,UAAU,KAAK,CAAA;AAE9B,EAAA,MAAM,QAAqB,EAAC;AAC5B,EAAA,MAAM,UAAyB,EAAC;AAChC,EAAA,IAAI,QAAA,GAA0B,IAAA;AAC9B,EAAA,IAAI,KAAA,GAAuB,IAAA;AAE3B,EAAA,KAAA,MAAW,OAAO,KAAA,EAAO;AACvB,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAC9B,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,QAAA,EAAU,GAAG,CAAA;AACjC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,QAAA,CAAS,GAAG,CAAA;AACpC,IAAA,IAAI,CAAC,MAAA,CAAO,IAAA,EAAM,eAAe,CAAA,EAAG;AAEpC,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,IAAA,EAAM,eAAe,CAAA;AAChD,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,OAAA,CAAQ,GAAG,CAAA;AAClC,IAAA,MAAM,QAAA,GAAW,GAAA,KAAQ,GAAA,GAAM,EAAA,GAAK,GAAA;AAGpC,IAAA,IAAI,SAAA,KAAc,oBAAoB,MAAA,EAAQ;AAC5C,MAAA,OAAA,CAAQ,KAAK,EAAE,IAAA,EAAM,SAAS,GAAA,EAAK,GAAA,EAAK,UAAU,CAAA;AAClD,MAAA;AAAA,IACF;AACA,IAAA,IAAI,SAAA,KAAc,oBAAoB,QAAA,EAAU;AAC9C,MAAA,IAAI,QAAA,KAAa,IAAI,QAAA,GAAW,IAAA;AAChC,MAAA;AAAA,IACF;AACA,IAAA,IAAI,SAAA,KAAc,oBAAoB,KAAA,EAAO;AAC3C,MAAA,IAAI,QAAA,KAAa,IAAI,KAAA,GAAQ,IAAA;AAC7B,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,SAAA,CAAU,UAAA,CAAW,GAAG,CAAA,EAAG;AAE/B,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,GAAA,EAAK,eAAe,CAAA;AAC9C,IAAA,MAAM,QAAA,GAAW,eAAe,QAAQ,CAAA;AACxC,IAAA,MAAM,SAAA,GAAY,YAAY,QAAQ,CAAA;AACtC,IAAA,MAAM,UAAU,QAAA,CAAS,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,QAAQ,CAAA;AACxD,IAAA,KAAA,CAAM,IAAA,CAAK,EAAE,IAAA,EAAM,OAAA,EAAS,GAAA,EAAK,WAAW,QAAA,EAAU,GAAA,EAAK,QAAA,EAAU,OAAA,EAAS,CAAA;AAAA,EAChF;AAGA,EAAA,KAAA,CAAM,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,YAAA,CAAa,CAAC,CAAA,CAAE,aAAA,CAAc,YAAA,CAAa,CAAC,CAAC,CAAC,CAAA;AACnE,EAAA,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,GAAA,CAAI,aAAA,CAAc,CAAA,CAAE,GAAG,CAAC,CAAA;AACjD,EAAA,OAAO,EAAE,KAAA,EAAO,OAAA,EAAS,QAAA,EAAU,KAAA,EAAM;AAC3C;AAGA,SAAS,aAAa,CAAA,EAAsB;AAC1C,EAAA,OAAO,EAAE,QAAA,CACN,GAAA,CAAI,CAAC,CAAA,KAAO,CAAA,CAAE,SAAS,QAAA,GAAW,GAAA,GAAM,CAAA,CAAE,KAAA,GAAQ,EAAE,IAAA,KAAS,OAAA,GAAU,MAAM,GAAI,CAAA,CACjF,KAAK,GAAG,CAAA;AACb;AAGA,SAAS,SAAS,IAAA,EAA0B;AAC1C,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,UAAU,KAAK,CAAA;AAC9C,EAAA,IAAI,CAAC,EAAA,CAAG,UAAA,CAAW,MAAM,CAAA,SAAU,EAAC;AAEpC,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,MAAM,OAAA,GAAU,CAAC,GAAA,KAAgB;AAC/B,IAAA,IAAI,OAAA;AACJ,IAAA,IAAI;AACF,MAAA,OAAA,GAAU,GAAG,WAAA,CAAY,GAAA,EAAK,EAAE,aAAA,EAAe,MAAM,CAAA;AAAA,IACvD,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AACA,IAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,MAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,GAAA,EAAK,MAAM,IAAI,CAAA;AACrC,MAAA,IAAI,KAAA,CAAM,WAAA,EAAY,EAAG,OAAA,CAAQ,GAAG,CAAA;AAAA,WAAA,IAC3B,KAAA,CAAM,MAAA,EAAO,EAAG,KAAA,CAAM,KAAK,GAAG,CAAA;AAAA,IACzC;AAAA,EACF,CAAA;AACA,EAAA,OAAA,CAAQ,MAAM,CAAA;AAEd,EAAA,MAAM,OAAmB,EAAC;AAC1B,EAAA,KAAA,MAAW,OAAO,KAAA,EAAO;AACvB,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA;AAC9B,IAAA,IAAI,CAAC,MAAA,CAAO,IAAA,EAAM,cAAc,CAAA,EAAG;AACnC,IAAA,MAAM,SAAA,GAAY,QAAA,CAAS,IAAA,EAAM,cAAc,CAAA;AAE/C,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,OAAO,CAAA,EAAG;AAC5B,IAAA,IAAI,SAAA,CAAU,UAAA,CAAW,GAAG,CAAA,EAAG;AAE/B,IAAA,MAAM,gBAAgB,OAAA,CAAQ,IAAA,CAAK,KAAK,IAAA,EAAM,QAAQ,GAAG,GAAG,CAAA;AAC5D,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,aAAA,EAAe,cAAc,CAAA;AACvD,IAAA,MAAM,gBAAA,GAAmB,QAAA,CAAS,OAAA,CAAQ,SAAA,EAAW,EAAE,CAAA;AACvD,IAAA,MAAM,YAAY,gBAAA,KAAqB,EAAA,GAAK,EAAC,GAAI,gBAAA,CAAiB,MAAM,GAAG,CAAA;AAC3E,IAAA,IAAI,UAAU,SAAA,CAAU,MAAA,GAAS,CAAC,CAAA,KAAM,OAAA,YAAmB,GAAA,EAAI;AAC/D,IAAA,MAAM,QAAA,GAAW,SAAA,CAAU,GAAA,CAAI,eAAe,CAAA;AAC9C,IAAA,MAAM,YAAY,MAAA,IAAU,QAAA,CAAS,MAAA,GAAS,WAAA,CAAY,QAAQ,CAAA,GAAI,EAAA,CAAA;AACtE,IAAA,MAAM,MAAA,GAAS,QAAA,CACZ,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,KAAS,QAAQ,CAAA,CACjC,GAAA,CAAI,CAAC,CAAA,KAAO,EAAuB,IAAI,CAAA;AAE1C,IAAA,IAAA,CAAK,IAAA,CAAK;AAAA,MACR,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAAA,MACvB,OAAA,EAAS,GAAA;AAAA,MACT,SAAA;AAAA,MACA,OAAA,EAAS,SAAA;AAAA,MACT,QAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAEA,EAAA,IAAA,CAAK,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,EAAE,SAAA,CAAU,aAAA,CAAc,CAAA,CAAE,SAAS,CAAC,CAAA;AAC1D,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,YAAY,IAAA,EAA0B;AACpD,EAAA,OAAO,KAAA,CAAM,QAAQ,MAAM;AACzB,IAAA,MAAM,QAAA,GAAW,gBAAgB,IAAI,CAAA;AACrC,IAAA,MAAM,EAAE,OAAO,OAAA,EAAS,QAAA,EAAU,OAAM,GAAI,SAAA,CAAU,IAAA,EAAM,QAAA,CAAS,GAAG,CAAA;AAGxE,IAAA,MAAM,YAAY,EAAA,CAAG,UAAA,CAAW,KAAK,IAAA,CAAK,IAAA,EAAM,QAAQ,CAAC,CAAA;AACzD,IAAA,MAAM,IAAA,GAAO,SAAA,GAAY,QAAA,CAAS,IAAI,IAAI,EAAC;AAC3C,IAAA,OAAO,EAAE,OAAO,OAAA,EAAS,QAAA,EAAU,OAAO,IAAA,EAAM,SAAA,EAAW,OAAA,EAAS,QAAA,CAAS,GAAA,EAAI;AAAA,EACnF,CAAC,CAAA;AACH","file":"chunk-D4Y5RWJA.js","sourcesContent":["/**\n * Opt-in phase timing, enabled with `VANTAGE_PROFILE=1`.\n *\n * Every line goes to **stderr**, so turning it on never corrupts the `--json`\n * payloads other commands write to stdout. Disabled, `timed()` is a direct call\n * through — no timers, no allocation.\n */\n\nconst ENABLED = Boolean(process.env.VANTAGE_PROFILE)\n\n/** Whether profiling output is on. Cheap enough to branch on in hot paths. */\nexport const profiling = ENABLED\n\nfunction report(label: string, ms: number): void {\n  const since = (performance.now() / 1000).toFixed(3)\n  process.stderr.write(`[vantage:profile] ${label.padEnd(24)} ${ms.toFixed(1).padStart(8)}ms  @${since}s\\n`)\n}\n\n/** Time a synchronous phase. */\nexport function timed<T>(label: string, fn: () => T): T {\n  if (!ENABLED) return fn()\n  const t0 = performance.now()\n  try {\n    return fn()\n  } finally {\n    report(label, performance.now() - t0)\n  }\n}\n\n/** Time an asynchronous phase. */\nexport async function timedAsync<T>(label: string, fn: () => Promise<T>): Promise<T> {\n  if (!ENABLED) return fn()\n  const t0 = performance.now()\n  try {\n    return await fn()\n  } finally {\n    report(label, performance.now() - t0)\n  }\n}\n\n/** Record a one-off duration measured by the caller. */\nexport function note(label: string, ms: number): void {\n  if (ENABLED) report(label, ms)\n}\n","import fs from \"node:fs\"\nimport path from \"node:path\"\nimport {\n  API_EXTENSIONS,\n  NON_ROUTE_DIRS,\n  PAGE_EXTENSIONS,\n  RESERVED_PAGE_NAMES,\n  SRC_DIR,\n} from \"./constants\"\nimport { timed } from \"./profile\"\nimport type { ApiRoute, LayoutRoute, PageRoute, RouteModel, Segment } from \"./types\"\n\n/** Convert an absolute path to a project-relative POSIX path. */\nfunction toPosix(root: string, abs: string): string {\n  return path.relative(root, abs).split(path.sep).join(\"/\")\n}\n\n/** Parse one raw path token into a segment descriptor. */\nfunction parseRawSegment(raw: string): Segment {\n  const catchall = raw.match(/^\\[\\.\\.\\.(.+)\\]$/)\n  if (catchall) return { kind: \"catchall\", name: catchall[1]! }\n  const param = raw.match(/^\\[(.+)\\]$/)\n  if (param) return { kind: \"param\", name: param[1]! }\n  return { kind: \"static\", value: raw }\n}\n\n/** Build a human/display route path from segments. */\nfunction displayPath(segments: Segment[]): string {\n  if (segments.length === 0) return \"/\"\n  const parts = segments.map((s) => {\n    if (s.kind === \"static\") return s.value\n    if (s.kind === \"param\") return `:${s.name}`\n    return \"*\"\n  })\n  return \"/\" + parts.join(\"/\")\n}\n\n/** Split a relative POSIX file (without extension) into route segments. */\nfunction fileToSegments(relNoExt: string): Segment[] {\n  const raw = relNoExt.split(\"/\")\n  // A trailing `index` maps to its directory (drop it).\n  if (raw[raw.length - 1] === \"index\") raw.pop()\n  return raw.map(parseRawSegment)\n}\n\n/** Strip a known extension from a filename. */\nfunction stripExt(file: string, exts: string[]): string {\n  for (const ext of exts) {\n    if (file.endsWith(ext)) return file.slice(0, -ext.length)\n  }\n  return file\n}\n\nfunction hasExt(file: string, exts: string[]): boolean {\n  return exts.some((ext) => file.endsWith(ext))\n}\n\n/** Recursively collect files under a directory, respecting ignore rules. */\nfunction walk(dir: string, root: string, out: string[]): 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    const abs = path.join(dir, entry.name)\n    if (entry.isDirectory()) {\n      if (NON_ROUTE_DIRS.has(entry.name)) continue\n      if (entry.name.startsWith(\".\")) continue\n      walk(abs, root, out)\n    } else if (entry.isFile()) {\n      out.push(abs)\n    }\n  }\n}\n\n/**\n * Decide where pages are scanned from: `<root>/src` when that directory exists,\n * the project root otherwise. The two never mix — a project that has `src/`\n * keeps every page inside it (`SRC_DIR_SPLIT` reports the leftovers).\n */\nexport function resolvePageRoot(root: string): { dir: string; abs: string } {\n  const abs = path.join(root, SRC_DIR)\n  try {\n    if (fs.statSync(abs).isDirectory()) return { dir: SRC_DIR, abs }\n  } catch {\n    /* no src/ — pages live at the project root */\n  }\n  return { dir: \"\", abs: root }\n}\n\n/**\n * Discover page and layout routes under the page root. `file` stays relative to\n * the *project* root (generated imports resolve from `.vantage/`), while\n * `dir`/`segments`/`routePath` are relative to the *page* root so that `src/`\n * never leaks into a URL — and so `dir` keeps matching `segments` one-to-one,\n * which is how `buildRouteTree` pairs pages with their layouts.\n */\nfunction scanPages(\n  root: string,\n  pageRoot: string,\n): {\n  pages: PageRoute[]\n  layouts: LayoutRoute[]\n  notFound: string | null\n  error: string | null\n} {\n  const files: string[] = []\n  walk(pageRoot, pageRoot, files)\n\n  const pages: PageRoute[] = []\n  const layouts: LayoutRoute[] = []\n  let notFound: string | null = null\n  let error: string | null = null\n\n  for (const abs of files) {\n    const file = toPosix(root, abs)\n    const rel = toPosix(pageRoot, abs)\n    const base = path.posix.basename(rel)\n    if (!hasExt(base, PAGE_EXTENSIONS)) continue\n\n    const nameNoExt = stripExt(base, PAGE_EXTENSIONS)\n    const dir = path.posix.dirname(rel)\n    const dirPosix = dir === \".\" ? \"\" : dir\n\n    // Reserved modules.\n    if (nameNoExt === RESERVED_PAGE_NAMES.layout) {\n      layouts.push({ file, absFile: abs, dir: dirPosix })\n      continue\n    }\n    if (nameNoExt === RESERVED_PAGE_NAMES.notFound) {\n      if (dirPosix === \"\") notFound = file\n      continue\n    }\n    if (nameNoExt === RESERVED_PAGE_NAMES.error) {\n      if (dirPosix === \"\") error = file\n      continue\n    }\n    // Any other underscore-prefixed file is a private module, not a route.\n    if (nameNoExt.startsWith(\"_\")) continue\n\n    const relNoExt = stripExt(rel, PAGE_EXTENSIONS)\n    const segments = fileToSegments(relNoExt)\n    const routePath = displayPath(segments)\n    const dynamic = segments.some((s) => s.kind !== \"static\")\n    pages.push({ file, absFile: abs, routePath, segments, dir: dirPosix, dynamic })\n  }\n\n  // Stable ordering: shallow before deep, static before dynamic, alpha.\n  pages.sort((a, b) => routeSortKey(a).localeCompare(routeSortKey(b)))\n  layouts.sort((a, b) => a.dir.localeCompare(b.dir))\n  return { pages, layouts, notFound, error }\n}\n\n/** Sort key that keeps static routes ahead of dynamic ones at each depth. */\nfunction routeSortKey(p: PageRoute): string {\n  return p.segments\n    .map((s) => (s.kind === \"static\" ? \"0\" + s.value : s.kind === \"param\" ? \"1\" : \"2\"))\n    .join(\"/\")\n}\n\n/** Discover server API routes under `server/api`. */\nfunction scanApis(root: string): ApiRoute[] {\n  const apiDir = path.join(root, \"server\", \"api\")\n  if (!fs.existsSync(apiDir)) return []\n\n  const files: string[] = []\n  const walkApi = (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      const abs = path.join(dir, entry.name)\n      if (entry.isDirectory()) walkApi(abs)\n      else if (entry.isFile()) files.push(abs)\n    }\n  }\n  walkApi(apiDir)\n\n  const apis: ApiRoute[] = []\n  for (const abs of files) {\n    const base = path.basename(abs)\n    if (!hasExt(base, API_EXTENSIONS)) continue\n    const nameNoExt = stripExt(base, API_EXTENSIONS)\n    // Type declaration files and private helpers are not routes.\n    if (base.endsWith(\".d.ts\")) continue\n    if (nameNoExt.startsWith(\"_\")) continue\n\n    const relFromServer = toPosix(path.join(root, \"server\"), abs) // e.g. api/customers/[id].ts\n    const relNoExt = stripExt(relFromServer, API_EXTENSIONS) // api/customers/[id]\n    const withoutApiPrefix = relNoExt.replace(/^api\\/?/, \"\") // customers/[id] or \"\" for api/index\n    const segTokens = withoutApiPrefix === \"\" ? [] : withoutApiPrefix.split(\"/\")\n    if (segTokens[segTokens.length - 1] === \"index\") segTokens.pop()\n    const segments = segTokens.map(parseRawSegment)\n    const routePath = \"/api\" + (segments.length ? displayPath(segments) : \"\")\n    const params = segments\n      .filter((s) => s.kind !== \"static\")\n      .map((s) => (s as { name: string }).name)\n\n    apis.push({\n      file: toPosix(root, abs),\n      absFile: abs,\n      routePath,\n      pattern: routePath,\n      segments,\n      params,\n    })\n  }\n\n  apis.sort((a, b) => a.routePath.localeCompare(b.routePath))\n  return apis\n}\n\n/** Scan a project into a full route model. */\nexport function scanProject(root: string): RouteModel {\n  return timed(\"scan\", () => {\n    const pageRoot = resolvePageRoot(root)\n    const { pages, layouts, notFound, error } = scanPages(root, pageRoot.abs)\n    // server/ is always at the project root: it is the other side of the\n    // client/server boundary, not part of the client source tree.\n    const hasServer = fs.existsSync(path.join(root, \"server\"))\n    const apis = hasServer ? scanApis(root) : []\n    return { pages, layouts, notFound, error, apis, hasServer, pageDir: pageRoot.dir }\n  })\n}\n\n/** Convert a display route path segment list into a TanStack Router path. */\nexport function toRouterPath(segments: Segment[]): string {\n  if (segments.length === 0) return \"/\"\n  const parts = segments.map((s) => {\n    if (s.kind === \"static\") return s.value\n    if (s.kind === \"param\") return `$${s.name}`\n    return \"$\" // TanStack splat\n  })\n  return \"/\" + parts.join(\"/\")\n}\n"]}

package/dist/chunk-OFFJ3OL5.js

@@ -0,0 +1,121 @@
+import { PAGE_EXTENSIONS } from './chunk-C4MQRWXS.js';
+import fs from 'fs';
+import path from 'path';
+import pc from 'picocolors';
+
+// @squadbase/vantage — generated build. Do not edit.
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
+  "json",
+  "help",
+  "force",
+  "verbose",
+  "version",
+  "all",
+  "list",
+  "regex",
+  "pages",
+  "apis",
+  "detail",
+  "h",
+  "v"
+]);
+function parseArgs(argv) {
+  const positionals = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const eq = arg.indexOf("=");
+      if (eq !== -1) {
+        flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+        continue;
+      }
+      const key = arg.slice(2);
+      if (BOOLEAN_FLAGS.has(key)) {
+        flags[key] = true;
+        continue;
+      }
+      const next = argv[i + 1];
+      if (next !== void 0 && !next.startsWith("-")) {
+        flags[key] = next;
+        i++;
+      } else {
+        flags[key] = true;
+      }
+    } else if (arg.length > 1 && arg.startsWith("-") && !/^-\d/.test(arg)) {
+      for (const ch of arg.slice(1)) flags[ch] = true;
+    } else {
+      positionals.push(arg);
+    }
+  }
+  return { positionals, flags };
+}
+function applyApiBaseUrlFlag(args) {
+  const value = args.flags["api-base-url"];
+  if (typeof value === "string" && value.length) {
+    process.env.PUBLIC_API_BASE_URL = value;
+  }
+}
+function parsePort(value, fallback) {
+  if (typeof value === "string") {
+    const n = Number(value);
+    if (Number.isInteger(n) && n > 0 && n < 65536) return n;
+  }
+  return fallback;
+}
+function resolveRoot(flags) {
+  const raw = typeof flags.root === "string" ? flags.root : process.cwd();
+  return path.resolve(raw);
+}
+var QUICK_ROOT_MAX_DEPTH = 5;
+function resolveQuickRoot(target) {
+  try {
+    const abs = path.resolve(target);
+    const stat = fs.statSync(abs);
+    if (stat.isDirectory()) return abs;
+    if (stat.isFile() && PAGE_EXTENSIONS.some((ext) => abs.endsWith(ext))) {
+      let dir = path.dirname(abs);
+      for (let i = 0; i <= QUICK_ROOT_MAX_DEPTH; i++) {
+        if (fs.existsSync(path.join(dir, "package.json"))) return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir) break;
+        dir = parent;
+      }
+      return path.dirname(abs);
+    }
+  } catch {
+  }
+  return null;
+}
+var log = {
+  info: (msg) => console.log(msg),
+  step: (msg) => console.log(pc.cyan("\u2192 ") + msg),
+  ok: (msg) => console.log(pc.green("\u2713 ") + msg),
+  warn: (msg) => console.log(pc.yellow("! ") + msg),
+  error: (msg) => console.error(pc.red("\u2717 ") + msg),
+  brand: (msg) => console.log(pc.bold(pc.magenta("vantage ")) + msg)
+};
+function printDiagnostics(diags) {
+  for (const d of diags) {
+    const badge = d.severity === "error" ? pc.red(pc.bold(" ERROR ")) : pc.yellow(pc.bold(" WARN "));
+    console.log(`${badge} ${pc.dim(d.code)} ${d.message}`);
+    if (d.files?.length) console.log(`        ${pc.dim("files:")} ${d.files.join(", ")}`);
+    if (d.fix) console.log(`        ${pc.dim("fix:")} ${d.fix}`);
+  }
+}
+function printJson(payload) {
+  process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
+}
+function frameworkVersion() {
+  try {
+    const url = new URL("../package.json", import.meta.url);
+    const pkg = JSON.parse(fs.readFileSync(url, "utf8"));
+    return pkg.version;
+  } catch {
+    return "0.0.0";
+  }
+}
+
+export { applyApiBaseUrlFlag, frameworkVersion, log, parseArgs, parsePort, printDiagnostics, printJson, resolveQuickRoot, resolveRoot };
+//# sourceMappingURL=chunk-OFFJ3OL5.js.map
+//# sourceMappingURL=chunk-OFFJ3OL5.js.map

package/dist/chunk-OFFJ3OL5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/util.ts"],"names":[],"mappings":"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","file":"chunk-OFFJ3OL5.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport pc from \"picocolors\"\nimport { PAGE_EXTENSIONS } from \"../core/constants\"\nimport type { Diagnostic } from \"../core/types\"\n\n/** Parsed CLI arguments. */\nexport interface ParsedArgs {\n  positionals: string[]\n  flags: Record<string, string | boolean>\n}\n\n/** Flags that never take a value, so they don't swallow the next token. */\nconst BOOLEAN_FLAGS = new Set([\n  \"json\",\n  \"help\",\n  \"force\",\n  \"verbose\",\n  \"version\",\n  \"all\",\n  \"list\",\n  \"regex\",\n  \"pages\",\n  \"apis\",\n  \"detail\",\n  \"h\",\n  \"v\",\n])\n\n/** Minimal argv parser: `--json`, `--port 3000`, `--port=3000`, `-v`, positionals. */\nexport function parseArgs(argv: string[]): ParsedArgs {\n  const positionals: string[] = []\n  const flags: Record<string, string | boolean> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]!\n    if (arg.startsWith(\"--\")) {\n      const eq = arg.indexOf(\"=\")\n      if (eq !== -1) {\n        flags[arg.slice(2, eq)] = arg.slice(eq + 1)\n        continue\n      }\n      const key = arg.slice(2)\n      if (BOOLEAN_FLAGS.has(key)) {\n        flags[key] = true\n        continue\n      }\n      const next = argv[i + 1]\n      if (next !== undefined && !next.startsWith(\"-\")) {\n        flags[key] = next\n        i++\n      } else {\n        flags[key] = true\n      }\n    } else if (arg.length > 1 && arg.startsWith(\"-\") && !/^-\\d/.test(arg)) {\n      // Single-dash short flags, e.g. `-v`, `-h` (each char is a boolean).\n      for (const ch of arg.slice(1)) flags[ch] = true\n    } else {\n      positionals.push(arg)\n    }\n  }\n  return { positionals, flags }\n}\n\n/**\n * Apply a `--api-base-url <url>` flag by setting `process.env.PUBLIC_API_BASE_URL`\n * so Vite inlines it into the client bundle (via envPrefix). Setting it on\n * process.env gives the flag precedence over any `.env` file value. No-op when\n * the flag is absent, leaving any `.env` value in effect.\n */\nexport function applyApiBaseUrlFlag(args: ParsedArgs): void {\n  const value = args.flags[\"api-base-url\"]\n  if (typeof value === \"string\" && value.length) {\n    process.env.PUBLIC_API_BASE_URL = value\n  }\n}\n\n/** Parse a `--port` flag value into a valid port, falling back to a default. */\nexport function parsePort(value: string | boolean | undefined, fallback: number): number {\n  if (typeof value === \"string\") {\n    const n = Number(value)\n    if (Number.isInteger(n) && n > 0 && n < 65536) return n\n  }\n  return fallback\n}\n\n/** Resolve the project root, honoring `--root`, defaulting to cwd. */\nexport function resolveRoot(flags: Record<string, string | boolean>): string {\n  const raw = typeof flags.root === \"string\" ? flags.root : process.cwd()\n  return path.resolve(raw)\n}\n\n/** How far up from a page file to look for the package root. */\nconst QUICK_ROOT_MAX_DEPTH = 5\n\n/**\n * Resolve a positional path to a quick-run project root.\n * A directory → itself; a page file (.tsx/.jsx) → its project; else null.\n */\nexport function resolveQuickRoot(target: string): string | null {\n  try {\n    const abs = path.resolve(target)\n    const stat = fs.statSync(abs)\n    if (stat.isDirectory()) return abs\n    if (stat.isFile() && PAGE_EXTENSIONS.some((ext) => abs.endsWith(ext))) {\n      // Walk up to the nearest package.json so `vantage ./demo/src/index.tsx`\n      // starts in ./demo — the directory holding the page is not the project\n      // root once pages live under src/ (or in any nested route directory).\n      let dir = path.dirname(abs)\n      for (let i = 0; i <= QUICK_ROOT_MAX_DEPTH; i++) {\n        if (fs.existsSync(path.join(dir, \"package.json\"))) return dir\n        const parent = path.dirname(dir)\n        if (parent === dir) break\n        dir = parent\n      }\n      return path.dirname(abs)\n    }\n  } catch {\n    // statSync throws when the path does not exist → null (not a quick target)\n  }\n  return null\n}\n\nexport const log = {\n  info: (msg: string) => console.log(msg),\n  step: (msg: string) => console.log(pc.cyan(\"→ \") + msg),\n  ok: (msg: string) => console.log(pc.green(\"✓ \") + msg),\n  warn: (msg: string) => console.log(pc.yellow(\"! \") + msg),\n  error: (msg: string) => console.error(pc.red(\"✗ \") + msg),\n  brand: (msg: string) => console.log(pc.bold(pc.magenta(\"vantage \")) + msg),\n}\n\n/** Print diagnostics as human-readable text. */\nexport function printDiagnostics(diags: Diagnostic[]): void {\n  for (const d of diags) {\n    const badge =\n      d.severity === \"error\" ? pc.red(pc.bold(\" ERROR \")) : pc.yellow(pc.bold(\" WARN \"))\n    console.log(`${badge} ${pc.dim(d.code)} ${d.message}`)\n    if (d.files?.length) console.log(`        ${pc.dim(\"files:\")} ${d.files.join(\", \")}`)\n    if (d.fix) console.log(`        ${pc.dim(\"fix:\")} ${d.fix}`)\n  }\n}\n\n/** Emit a JSON payload to stdout (for agent consumption). */\nexport function printJson(payload: unknown): void {\n  process.stdout.write(JSON.stringify(payload, null, 2) + \"\\n\")\n}\n\n/** Read the vantage package version. */\nexport function frameworkVersion(): string {\n  try {\n    // dist/cli.js (and shared chunks) live in dist/, so package.json is one up.\n    const url = new URL(\"../package.json\", import.meta.url)\n    const pkg = JSON.parse(fs.readFileSync(url, \"utf8\")) as { version: string }\n    return pkg.version\n  } catch {\n    return \"0.0.0\"\n  }\n}\n\nexport function fileExists(p: string): boolean {\n  try {\n    return fs.existsSync(p)\n  } catch {\n    return false\n  }\n}\n"]}

package/dist/chunk-PSEYFYAP.js

@@ -0,0 +1,276 @@
+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 fs from 'fs';
+import path from 'path';
+
+// @squadbase/vantage — generated build. Do not edit.
+var ALLOWED_ENV_KEYS = /* @__PURE__ */ new Set(["MODE", "DEV", "PROD", "SSR", "BASE_URL", "PUBLIC_"]);
+function hasDefaultExport(src) {
+  return /\bexport\s+default\b/.test(src) || /\bexport\s*\{[^}]*\bas\s+default\b[^}]*\}/.test(src) || /\bexport\s*\{[^}]*\bdefault\b[^}]*\}\s*from\b/.test(src);
+}
+function collectClientFiles(root) {
+  const out = [];
+  const skipDirs = /* @__PURE__ */ new Set(["node_modules", ".vantage", "dist", "server", "public"]);
+  const walk = (dir) => {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith(".")) continue;
+      const abs = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (skipDirs.has(entry.name)) continue;
+        walk(abs);
+      } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
+        out.push(abs);
+      }
+    }
+  };
+  walk(root);
+  return out;
+}
+function createCtx(root, model) {
+  const sources = /* @__PURE__ */ new Map();
+  let clientFiles = null;
+  let rootEntries = null;
+  return {
+    root,
+    model,
+    source(abs) {
+      const hit = sources.get(abs);
+      if (hit !== void 0) return hit;
+      let src;
+      try {
+        src = stripComments(fs.readFileSync(abs, "utf8"));
+      } catch {
+        src = null;
+      }
+      sources.set(abs, src);
+      return src;
+    },
+    clientFiles() {
+      return clientFiles ??= collectClientFiles(root);
+    },
+    rootEntries() {
+      if (rootEntries) return rootEntries;
+      try {
+        rootEntries = fs.readdirSync(root);
+      } catch {
+        rootEntries = [];
+      }
+      return rootEntries;
+    }
+  };
+}
+function rel(root, abs) {
+  return path.relative(root, abs).split(path.sep).join("/");
+}
+function checkForbiddenFiles(ctx) {
+  const diags = [];
+  for (const name of ctx.rootEntries()) {
+    for (const rule of FORBIDDEN_FILES) {
+      if (rule.pattern.test(name)) {
+        diags.push({
+          code: "FORBIDDEN_FILE",
+          severity: "error",
+          message: `${rule.label} file "${name}" is not allowed in a Vantage project.`,
+          files: [name],
+          fix: rule.remedy
+        });
+      }
+    }
+  }
+  return diags;
+}
+function checkSrcLayout(ctx) {
+  const { root, model } = ctx;
+  if (model.pageDir === "") return [];
+  const diags = [];
+  const entries = ctx.rootEntries();
+  const strayPages = entries.filter((name) => PAGE_EXTENSIONS.some((ext) => name.endsWith(ext)));
+  if (strayPages.length > 0) {
+    diags.push({
+      code: "SRC_DIR_SPLIT",
+      severity: "error",
+      message: `${strayPages.length} page module(s) sit at the project root, but ${SRC_DIR}/ exists so pages are only scanned from ${SRC_DIR}/.`,
+      files: strayPages.sort(),
+      fix: `Move them into ${SRC_DIR}/, or delete ${SRC_DIR}/ to keep a root-level layout.`
+    });
+  }
+  if (entries.includes("styles.css")) {
+    diags.push({
+      code: "SRC_DIR_SPLIT",
+      severity: "error",
+      message: `styles.css sits at the project root, but ${SRC_DIR}/ exists so the global stylesheet is read from ${SRC_DIR}/styles.css.`,
+      files: ["styles.css"],
+      fix: `Move it to ${SRC_DIR}/styles.css.`
+    });
+  }
+  if (fs.existsSync(path.join(root, SRC_DIR, "server"))) {
+    diags.push({
+      code: "SRC_DIR_SPLIT",
+      severity: "error",
+      message: `${SRC_DIR}/server/ is never scanned: server code lives at the project root, outside the client source tree.`,
+      files: [`${SRC_DIR}/server`],
+      fix: `Move it to server/ at the project root.`
+    });
+  }
+  return diags;
+}
+function checkSuspiciousRouteDirs(model) {
+  const byDir = /* @__PURE__ */ new Map();
+  for (const page of model.pages) {
+    const top = page.dir.split("/")[0] ?? "";
+    if (top === "" || !SUSPICIOUS_ROUTE_DIRS.has(top)) continue;
+    const hit = byDir.get(top) ?? { files: [], routes: [] };
+    hit.files.push(page.file);
+    hit.routes.push(page.routePath);
+    byDir.set(top, hit);
+  }
+  const diags = [];
+  for (const [dir, hit] of byDir) {
+    diags.push({
+      code: "SUSPICIOUS_ROUTE_DIR",
+      severity: "warning",
+      message: `${dir}/ is part of the URL: ${hit.routes.slice(0, 3).join(", ")}${hit.routes.length > 3 ? ", \u2026" : ""}`,
+      files: hit.files,
+      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.`
+    });
+  }
+  return diags;
+}
+function checkRouteConflicts(model) {
+  const byPath = /* @__PURE__ */ new Map();
+  for (const page of model.pages) {
+    const list = byPath.get(page.routePath) ?? [];
+    list.push(page.file);
+    byPath.set(page.routePath, list);
+  }
+  const diags = [];
+  for (const [routePath, files] of byPath) {
+    if (files.length > 1) {
+      diags.push({
+        code: "ROUTE_CONFLICT",
+        severity: "error",
+        message: `${files.length} files resolve to ${routePath}`,
+        files,
+        fix: "Rename or remove one route file so each route is unique."
+      });
+    }
+  }
+  return diags;
+}
+function checkPageExports(ctx) {
+  const { root, model } = ctx;
+  const diags = [];
+  const pageFiles = [
+    ...model.pages.map((p) => p.absFile),
+    ...model.layouts.map((l) => l.absFile),
+    model.notFound && path.join(root, model.notFound),
+    model.error && path.join(root, model.error)
+  ].filter((x) => Boolean(x));
+  for (const abs of pageFiles) {
+    const src = ctx.source(abs);
+    if (src === null) continue;
+    if (!hasDefaultExport(src)) {
+      diags.push({
+        code: "MISSING_DEFAULT_EXPORT",
+        severity: "error",
+        message: `Page module has no default export.`,
+        files: [rel(root, abs)],
+        fix: "A page/layout must `export default` a React component."
+      });
+    }
+  }
+  return diags;
+}
+function checkApiExports(ctx) {
+  const diags = [];
+  for (const api of ctx.model.apis) {
+    const src = ctx.source(api.absFile);
+    if (src === null) continue;
+    const exported = detectApiMethods(src);
+    if (exported.length === 0) {
+      const lower = ["get", "post", "put", "patch", "delete", "options"].filter(
+        (m) => new RegExp(`export\\s+(async\\s+)?function\\s+${m}\\b`).test(src)
+      );
+      diags.push({
+        code: "INVALID_API_EXPORT",
+        severity: "error",
+        message: `API module exports no HTTP method handler${lower.length ? ` (found lowercase "${lower.join(", ")}")` : ""}.`,
+        files: [api.file],
+        fix: `Export one of: ${API_METHODS.join(", ")} (uppercase).`
+      });
+    }
+  }
+  return diags;
+}
+function checkClientSources(ctx) {
+  const { root } = ctx;
+  const boundary = [];
+  const env = [];
+  const importRe = /(?:import|export)[^'"]*?from\s+["']([^"']+)["']|import\s*\(\s*["']([^"']+)["']\s*\)/g;
+  const envRe = /import\.meta\.env\.([A-Za-z_][A-Za-z0-9_]*)/g;
+  for (const abs of ctx.clientFiles()) {
+    const src = ctx.source(abs);
+    if (src === null) continue;
+    let m;
+    importRe.lastIndex = 0;
+    while (m = importRe.exec(src)) {
+      const spec = m[1] ?? m[2];
+      if (!spec) continue;
+      const isServer = spec === "server" || spec.startsWith("server/") || /(^|\/)\.\.?\/server(\/|$)/.test(spec) || /\/server\//.test(spec);
+      if (isServer) {
+        boundary.push({
+          code: "CLIENT_IMPORTS_SERVER",
+          severity: "error",
+          message: `Client module imports from server/ ("${spec}").`,
+          files: [rel(root, abs)],
+          fix: "server/ code must never be imported by the client. Move shared code to lib/."
+        });
+      }
+    }
+    envRe.lastIndex = 0;
+    const bad = /* @__PURE__ */ new Set();
+    while (m = envRe.exec(src)) {
+      const key = m[1];
+      if (ALLOWED_ENV_KEYS.has(key)) continue;
+      if (key.startsWith(PUBLIC_ENV_PREFIX)) continue;
+      bad.add(key);
+    }
+    for (const key of bad) {
+      env.push({
+        code: "PUBLIC_ENV_MISUSE",
+        severity: "warning",
+        message: `Client reads non-public env "import.meta.env.${key}".`,
+        files: [rel(root, abs)],
+        fix: `Only ${PUBLIC_ENV_PREFIX}* vars reach the client. Read secrets via ApiContext.env in server/.`
+      });
+    }
+  }
+  return { boundary, env };
+}
+function runDiagnostics(root, model) {
+  return timed("diagnostics", () => {
+    const ctx = createCtx(root, model);
+    const client = checkClientSources(ctx);
+    return [
+      ...checkForbiddenFiles(ctx),
+      ...checkSrcLayout(ctx),
+      ...checkSuspiciousRouteDirs(model),
+      ...checkRouteConflicts(model),
+      ...checkPageExports(ctx),
+      ...checkApiExports(ctx),
+      ...client.boundary,
+      ...client.env
+    ];
+  });
+}
+
+export { runDiagnostics };
+//# sourceMappingURL=chunk-PSEYFYAP.js.map
+//# sourceMappingURL=chunk-PSEYFYAP.js.map