@marktiderman/genesis-cli 1.20.0 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.md +168 -9
  2. package/dist/cli.js +1114 -103
  3. package/dist/cli.js.map +1 -1
  4. package/dist/{config-Dj_f9T7J.d.ts → config-HOmiOLQc.d.ts} +2 -0
  5. package/dist/doctor.d.ts +10 -5
  6. package/dist/doctor.js +1515 -1095
  7. package/dist/doctor.js.map +1 -1
  8. package/dist/expo.d.ts +2 -2
  9. package/dist/expo.js +10 -0
  10. package/dist/expo.js.map +1 -1
  11. package/dist/genesis-catalog.json +140 -20
  12. package/dist/index.d.ts +114 -2
  13. package/dist/index.js +1538 -1099
  14. package/dist/index.js.map +1 -1
  15. package/dist/starter/README.md +8 -5
  16. package/dist/starter/__tests__/components/setup.ts +11 -0
  17. package/dist/starter/__tests__/starter.test.ts +28 -0
  18. package/dist/starter/package.json +4 -3
  19. package/dist/starter/pnpm-workspace.yaml +22 -0
  20. package/dist/starter/src/lib/app.ts +13 -5
  21. package/dist/starter/src/lib/check-in.ts +5 -3
  22. package/dist/starter/src/lib/define-starter.ts +1 -1
  23. package/dist/starter/src/lib/devtools-overlay.ts +3 -4
  24. package/dist/starter/src/lib/native-modules.ts +9 -2
  25. package/dist/starter/src/lib/offline.ts +14 -0
  26. package/dist/starter/supabase/migrations/20261024000750_support_default_tenant.sql +18 -0
  27. package/dist/starter/supabase/migrations/20261024000800_genesis_support_tickets.sql +800 -0
  28. package/dist/starter/supabase/migrations/20261025000070_starter_tenancy.sql +26 -0
  29. package/dist/starter/supabase/migrations/20261025000080_genesis_chat_tenants.sql +716 -0
  30. package/dist/starter/supabase/migrations/20261025000090_genesis_chat_attachment_paths.sql +80 -0
  31. package/dist/starter/supabase/tests/database/chat_people.test.sql +1 -1
  32. package/dist/starter/supabase/tests/database/genesis_chat.test.sql +10 -2
  33. package/dist/starter/supabase/tests/database/genesis_chat_attachment_paths.test.sql +111 -0
  34. package/dist/starter/supabase/tests/database/genesis_chat_coaching.test.sql +8 -0
  35. package/dist/starter/supabase/tests/database/genesis_chat_search_threads.test.sql +8 -0
  36. package/dist/starter/supabase/tests/database/genesis_chat_tenants.test.sql +259 -0
  37. package/dist/starter/supabase/tests/database/genesis_support.test.sql +15 -3
  38. package/dist/starter/supabase/tests/database/genesis_support_findings.test.sql +10 -0
  39. package/dist/starter/supabase/tests/database/genesis_support_tickets.test.sql +327 -0
  40. package/dist/starter/supabase/tests/database/starter_tenancy.test.sql +19 -0
  41. package/dist/vite.js +1514 -1094
  42. package/dist/vite.js.map +1 -1
  43. package/package.json +3 -3
package/dist/vite.js CHANGED
@@ -1,18 +1,23 @@
1
- import * as path20 from 'path';
1
+ import * as path21 from 'path';
2
2
  import { spawnSync } from 'child_process';
3
3
  import { existsSync, readFileSync, statSync, realpathSync, readdirSync, lstatSync } from 'fs';
4
4
  import { builtinModules, createRequire } from 'module';
5
+ import { overlayUpstream, readOverlayMarker } from '@marktiderman/genesis-features';
5
6
  import { createHash } from 'crypto';
6
7
  import { FEATURE_PLATFORMS, defineBlock, BlockError } from '@marktiderman/genesis-features/blocks';
7
8
  import { pathToFileURL, fileURLToPath } from 'url';
8
- import { overlayUpstream, readOverlayMarker } from '@marktiderman/genesis-features';
9
9
  import { createJiti } from 'jiti';
10
10
  import 'os';
11
11
 
12
12
  var __defProp = Object.defineProperty;
13
13
  var __getOwnPropNames = Object.getOwnPropertyNames;
14
- var __esm = (fn, res) => function __init() {
15
- return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
14
+ var __esm = (fn, res, err) => function __init() {
15
+ if (err) throw err[0];
16
+ try {
17
+ return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
18
+ } catch (e) {
19
+ throw err = [e], e;
20
+ }
16
21
  };
17
22
  var __export = (target, all) => {
18
23
  for (var name in all)
@@ -455,14 +460,14 @@ function inherit(own, source) {
455
460
  }
456
461
  function resolveViews(relations) {
457
462
  const done = /* @__PURE__ */ new Set();
458
- const resolve18 = (relation, depth) => {
463
+ const resolve19 = (relation, depth) => {
459
464
  if (done.has(relation.oid) || !relation.origins || depth > MAX_VIEW_DEPTH) return;
460
465
  done.add(relation.oid);
461
466
  const sources = new Set([...relation.origins.values()].map((o) => o.relation));
462
467
  if (sources.size !== 1) return;
463
468
  const source = relations.get([...sources][0]);
464
469
  if (!source) return;
465
- resolve18(source, depth + 1);
470
+ resolve19(source, depth + 1);
466
471
  const viewAttnumOf = /* @__PURE__ */ new Map();
467
472
  for (const [attnum, origin] of relation.origins) {
468
473
  const own = relation.columns.get(attnum);
@@ -485,7 +490,7 @@ function resolveViews(relations) {
485
490
  };
486
491
  if (Object.keys(inherited).length) relation.table.settings = { ...inherited, ...relation.table.settings };
487
492
  };
488
- for (const relation of relations.values()) resolve18(relation, 0);
493
+ for (const relation of relations.values()) resolve19(relation, 0);
489
494
  }
490
495
  async function introspectPostgres(sql, schemas, options = {}) {
491
496
  const relations = /* @__PURE__ */ new Map();
@@ -721,19 +726,19 @@ var init_introspect = __esm({
721
726
  var BUILD_GUARD_ENV = "GENESIS_DOCTOR_BUILDING";
722
727
  function buildCommands(root, config) {
723
728
  if (config.build) return config.build;
724
- const pkgFile = path20.join(root, "package.json");
729
+ const pkgFile = path21.join(root, "package.json");
725
730
  const scripts = existsSync(pkgFile) ? JSON.parse(readFileSync(pkgFile, "utf8")).scripts ?? {} : {};
726
731
  const pm = packageManager(root);
727
732
  return ["typecheck", "build"].filter((s) => scripts[s]).map((s) => `${pm} run ${s}`);
728
733
  }
729
734
  function packageManager(root) {
730
- let dir = path20.resolve(root);
735
+ let dir = path21.resolve(root);
731
736
  for (; ; ) {
732
- if (existsSync(path20.join(dir, "pnpm-lock.yaml"))) return "pnpm";
733
- if (existsSync(path20.join(dir, "bun.lock")) || existsSync(path20.join(dir, "bun.lockb"))) return "bun";
734
- if (existsSync(path20.join(dir, "yarn.lock"))) return "yarn";
735
- if (existsSync(path20.join(dir, "package-lock.json"))) return "npm";
736
- const parent = path20.dirname(dir);
737
+ if (existsSync(path21.join(dir, "pnpm-lock.yaml"))) return "pnpm";
738
+ if (existsSync(path21.join(dir, "bun.lock")) || existsSync(path21.join(dir, "bun.lockb"))) return "bun";
739
+ if (existsSync(path21.join(dir, "yarn.lock"))) return "yarn";
740
+ if (existsSync(path21.join(dir, "package-lock.json"))) return "npm";
741
+ const parent = path21.dirname(dir);
737
742
  if (parent === dir) return "npm";
738
743
  dir = parent;
739
744
  }
@@ -848,25 +853,25 @@ var PACK_KEYS = {
848
853
  };
849
854
  function appPath(v, where2, fail) {
850
855
  if (typeof v !== "string" || !v.trim()) return fail(`${where2} must be a non-empty path`);
851
- if (path20.isAbsolute(v) || /^[A-Za-z]:[\\/]/.test(v)) fail(`${where2} must be relative to the app, not absolute ("${v}")`);
852
- const norm = path20.posix.normalize(v.replace(/\\/g, "/")).replace(/\/+$/, "");
856
+ if (path21.isAbsolute(v) || /^[A-Za-z]:[\\/]/.test(v)) fail(`${where2} must be relative to the app, not absolute ("${v}")`);
857
+ const norm = path21.posix.normalize(v.replace(/\\/g, "/")).replace(/\/+$/, "");
853
858
  if (norm === "." || norm === ".." || norm.startsWith("../")) fail(`${where2} must be a folder inside the app ("${v}")`);
854
859
  return norm;
855
860
  }
856
861
  function loadConfig(root, configPath) {
857
862
  if (configPath) {
858
- const file = path20.resolve(root, configPath);
863
+ const file = path21.resolve(root, configPath);
859
864
  if (!existsSync(file)) throw new DoctorConfigError(`Config file not found: ${configPath}`);
860
865
  const json = readJson(file);
861
- const block = path20.basename(file) === "package.json" ? json?.genesis?.doctor : json?.doctor ?? json;
862
- return { config: validateConfig(block ?? {}, file), file, dir: path20.dirname(file) };
866
+ const block = path21.basename(file) === "package.json" ? json?.genesis?.doctor : json?.doctor ?? json;
867
+ return { config: validateConfig(block ?? {}, file), file, dir: path21.dirname(file) };
863
868
  }
864
- const own = path20.join(root, "genesis.config.json");
869
+ const own = path21.join(root, "genesis.config.json");
865
870
  if (existsSync(own)) {
866
871
  const block = readGenesisConfig(root)?.raw.doctor;
867
872
  return { config: validateConfig(block ?? {}, own), file: own, dir: root };
868
873
  }
869
- const pkg = path20.join(root, "package.json");
874
+ const pkg = path21.join(root, "package.json");
870
875
  if (existsSync(pkg)) {
871
876
  const block = readJson(pkg)?.genesis?.doctor;
872
877
  if (block !== void 0 && !isPackageDeclaration(block)) return { config: validateConfig(block, pkg), file: pkg, dir: root };
@@ -875,7 +880,7 @@ function loadConfig(root, configPath) {
875
880
  }
876
881
  function doctorBlock(json, file, explicit) {
877
882
  const j = json;
878
- if (path20.basename(file) === "package.json") return j?.genesis?.doctor;
883
+ if (path21.basename(file) === "package.json") return j?.genesis?.doctor;
879
884
  return explicit ? j?.doctor ?? j : j?.doctor;
880
885
  }
881
886
  function isPackageDeclaration(block) {
@@ -892,7 +897,7 @@ function readJson(file) {
892
897
  }
893
898
  }
894
899
  function readGenesisConfig(root) {
895
- const file = path20.join(root, "genesis.config.json");
900
+ const file = path21.join(root, "genesis.config.json");
896
901
  if (!existsSync(file)) return null;
897
902
  const raw = readJson(file);
898
903
  if (!isObject(raw)) throw new GenesisConfigError(`${file}: the config must be a JSON object`);
@@ -903,8 +908,18 @@ function readGenesisConfig(root) {
903
908
  const supabase = validateSupabase(raw.supabase, file);
904
909
  if (supabase !== true) out.supabase = supabase;
905
910
  }
911
+ if (raw.appFolder !== void 0) out.appFolder = validateAppFolder(raw.appFolder, file);
906
912
  return out;
907
913
  }
914
+ var PLAIN_FOLDER = /^[A-Za-z0-9_][A-Za-z0-9_.-]{0,59}(?:\/[A-Za-z0-9_][A-Za-z0-9_.-]{0,59}){0,7}$/;
915
+ function isPlainFolder(value) {
916
+ return PLAIN_FOLDER.test(value) && !value.split("/").includes("..");
917
+ }
918
+ function validateAppFolder(raw, source = "config") {
919
+ const norm = typeof raw === "string" ? raw.replace(/^\.\//, "").replace(/\/+$/, "") : "";
920
+ if (!isPlainFolder(norm)) throw new GenesisConfigError(`${source}: "appFolder" must be the app's folder from the repository root, such as "mobile" or "apps/phone" (got ${JSON.stringify(raw)})`);
921
+ return norm;
922
+ }
908
923
  function validateSupabase(raw, source = "config") {
909
924
  const fail = (msg) => {
910
925
  throw new GenesisConfigError(`${source}: ${msg}`);
@@ -914,8 +929,8 @@ function validateSupabase(raw, source = "config") {
914
929
  for (const key2 of Object.keys(raw)) if (key2 !== "app" && key2 !== "$comment") fail(`supabase: unknown setting "${key2}" (known: app)`);
915
930
  const app = raw.app;
916
931
  if (typeof app !== "string" || !app.trim()) return fail(`supabase.app must be the folder of the app that holds supabase/, relative to this one (e.g. "../app")`);
917
- if (path20.isAbsolute(app) || /^[A-Za-z]:[\\/]/.test(app) || app.includes("\\")) fail(`supabase.app must be relative to this app, with forward slashes ("${app}")`);
918
- const norm = path20.posix.normalize(app).replace(/\/+$/, "");
932
+ if (path21.isAbsolute(app) || /^[A-Za-z]:[\\/]/.test(app) || app.includes("\\")) fail(`supabase.app must be relative to this app, with forward slashes ("${app}")`);
933
+ const norm = path21.posix.normalize(app).replace(/\/+$/, "");
919
934
  if (norm === "." || norm === "") fail(`supabase.app names this app itself; leave "supabase" out instead`);
920
935
  return { app: norm };
921
936
  }
@@ -1075,7 +1090,7 @@ function validateConfig(raw, source = "config") {
1075
1090
  if (!(c.packs ?? []).includes("supabase")) fail(`"contracts" is set but the supabase pack is not in "packs"`);
1076
1091
  if (contracts.out !== void 0) {
1077
1092
  if (typeof contracts.out !== "string" || !contracts.out.trim()) fail(`contracts.out must be a file path`);
1078
- if (path20.isAbsolute(contracts.out) || contracts.out.replace(/\\/g, "/").split("/").includes("..")) fail(`contracts.out must be a file inside the app`);
1093
+ if (path21.isAbsolute(contracts.out) || contracts.out.replace(/\\/g, "/").split("/").includes("..")) fail(`contracts.out must be a file inside the app`);
1079
1094
  }
1080
1095
  if (contracts.schemas !== void 0 && !isStringList(contracts.schemas)) fail(`contracts.schemas must be a list of schema names`);
1081
1096
  if (contracts.databaseEnv !== void 0 && (typeof contracts.databaseEnv !== "string" || !/^[A-Za-z_][A-Za-z0-9_]*$/.test(contracts.databaseEnv))) {
@@ -1143,409 +1158,140 @@ function globToRegExp(glob) {
1143
1158
  }
1144
1159
  function globMatcher(globs) {
1145
1160
  const res = (globs ?? []).filter((g) => g.trim()).map(globToRegExp);
1146
- return (path44) => res.some((re) => re.test(path44));
1161
+ return (path49) => res.some((re) => re.test(path49));
1147
1162
  }
1148
- var DEFAULT_UI_PACKAGE = "@marktiderman/genesis-ui";
1149
- var NATIVE_UI_PACKAGE = "@marktiderman/genesis-ui-native";
1150
- var DESIGN_SYSTEM_PACKAGE = "@marktiderman/genesis-design-system";
1151
- var DEFAULT_COMPONENT_PACKAGES = ["@marktiderman/genesis-forms-studio"];
1152
- var TAGS = ["button", "input", "textarea", "select", "label", "table", "dialog", "progress", "details", "summary"];
1153
- var TAG_ALIASES = { hr: "Separator" };
1154
- var NON_COMPONENT_SUFFIX = /(Props|Variant|Variants|Type|Types|Config|Context|Options|Status)$/;
1155
- var TAILWIND_PALETTE = [
1156
- "black",
1157
- "white",
1158
- "slate",
1159
- "gray",
1160
- "zinc",
1161
- "neutral",
1162
- "stone",
1163
- "red",
1164
- "orange",
1165
- "amber",
1166
- "yellow",
1167
- "lime",
1168
- "green",
1169
- "emerald",
1170
- "teal",
1171
- "cyan",
1172
- "sky",
1173
- "blue",
1174
- "indigo",
1175
- "violet",
1176
- "purple",
1177
- "fuchsia",
1178
- "pink",
1179
- "rose",
1180
- "taupe",
1181
- "mauve",
1182
- "mist",
1183
- "olive"
1184
- ];
1185
- function findPackageDir(from, name) {
1186
- let dir = path20.resolve(from);
1187
- for (; ; ) {
1188
- const candidate = path20.join(dir, "node_modules", name);
1189
- if (existsSync(path20.join(candidate, "package.json"))) return candidate;
1190
- const parent = path20.dirname(dir);
1191
- if (parent === dir) return null;
1192
- dir = parent;
1163
+ var GENESIS_PACKAGE = /^@marktiderman\/genesis(-[a-z0-9-]+)?$/;
1164
+ var BLOCK_ID = /^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*$/;
1165
+ var MIGRATION_FILE = /^(\d{4})_([a-z0-9_]+)\.sql$/;
1166
+ var FUNCTION_NAME = /^[a-z0-9][a-z0-9_-]*$/;
1167
+ var ROUTE = /^\/(?:[A-Za-z0-9_\-[\]().]+\/?)*$/;
1168
+ var INSTALL_SPEC = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9.^~<>=|* -]+)?$/;
1169
+ var SECRET = /^[A-Z][A-Z0-9_]*$/;
1170
+ var SQL_FUNCTION = /^[a-z_][a-z0-9_]*\.[a-z_][a-z0-9_]*$/;
1171
+ var ManifestError = class extends Error {
1172
+ constructor(problems) {
1173
+ super(`Invalid block manifest:
1174
+ ${problems.map((p) => ` - ${p}`).join("\n")}`);
1175
+ this.problems = problems;
1176
+ this.name = "ManifestError";
1193
1177
  }
1178
+ problems;
1179
+ };
1180
+ function safeRelative(value) {
1181
+ if (typeof value !== "string" || !value || value.length > 300) return null;
1182
+ if (/[\0\\:]/.test(value) || value.startsWith("/") || value.startsWith("~")) return null;
1183
+ const segments = value.split("/");
1184
+ if (segments.some((s) => s === "" || s === "." || s === ".." || s.startsWith("-"))) return null;
1185
+ return value;
1194
1186
  }
1195
- function uiPackageFor(config) {
1196
- return config.uiPackage ?? (config.packs?.includes("native") ? NATIVE_UI_PACKAGE : DEFAULT_UI_PACKAGE);
1197
- }
1198
- function loadGenesis(root, config) {
1199
- const uiPackage = uiPackageFor(config);
1200
- const pkg = readPackageExports(root, uiPackage);
1201
- if (!pkg) throw new DoctorConfigError(`${uiPackage} is not installed here. Install it, or set doctor.uiPackage.`);
1202
- const { dir: uiDir, exports: exportNames, values, components } = pkg;
1203
- const tokens = /* @__PURE__ */ new Set();
1204
- const themeFiles = resolveThemeFiles(root, config, uiDir);
1205
- for (const file of themeFiles) for (const t of declaredTokens(readFileSync(file, "utf8"))) tokens.add(t);
1206
- const byLower = new Map(components.map((c) => [c.toLowerCase(), c]));
1207
- const rawTags = /* @__PURE__ */ new Map();
1208
- for (const tag of TAGS) if (byLower.has(tag)) rawTags.set(tag, byLower.get(tag));
1209
- for (const [tag, comp] of Object.entries(TAG_ALIASES)) if (values.has(comp)) rawTags.set(tag, comp);
1210
- for (const [tag, comp] of Object.entries(config.rawTags ?? {})) {
1211
- if (comp === false) rawTags.delete(tag);
1212
- else rawTags.set(tag, comp);
1213
- }
1214
- return {
1215
- uiPackage,
1216
- uiVersion: pkg.version,
1217
- exports: exportNames,
1218
- values,
1219
- components,
1220
- tokens,
1221
- rawTags,
1222
- palette: loadPalette(root),
1223
- companions: loadCompanions(root, config, uiPackage)
1187
+ var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
1188
+ var strings = (v) => Array.isArray(v) && v.every((s) => typeof s === "string");
1189
+ function parseManifest(home, id, raw, version, options = {}) {
1190
+ const problems = [];
1191
+ const at = `${home} genesis.blocks.${id}`;
1192
+ if (!GENESIS_PACKAGE.test(home) && !options.local) problems.push(`${home}: only Genesis packages (@marktiderman/genesis*) and the app's local packages declare blocks`);
1193
+ if (!BLOCK_ID.test(id)) problems.push(`${at}: "${id}" is not a feature id`);
1194
+ if (!isObject2(raw)) throw new ManifestError([...problems, `${at}: must be an object`]);
1195
+ const pkgOf = (value, where2) => {
1196
+ if (value === void 0) return home;
1197
+ if (typeof value !== "string" || !(GENESIS_PACKAGE.test(value) || options.local && value === home)) {
1198
+ problems.push(`${where2}: package must be a Genesis package${options.local ? " or this local package" : ""}, not ${JSON.stringify(value)}`);
1199
+ return home;
1200
+ }
1201
+ return value;
1224
1202
  };
1225
- }
1226
- function loadCompanions(root, config, uiPackage) {
1227
- const out = [];
1228
- for (const name of config.componentPackages ?? DEFAULT_COMPONENT_PACKAGES) {
1229
- if (name === uiPackage) continue;
1230
- try {
1231
- const pkg = readPackageExports(root, name);
1232
- if (pkg) out.push({ package: name, version: pkg.version, components: pkg.components });
1233
- } catch (err) {
1234
- if (!(err instanceof DoctorConfigError)) throw err;
1203
+ const pathOf = (value, where2) => {
1204
+ const safe = safeRelative(value);
1205
+ if (!safe) problems.push(`${where2}: ${JSON.stringify(value)} is not a plain path inside the package`);
1206
+ return safe ?? "";
1207
+ };
1208
+ const list = (key2) => {
1209
+ const v = raw[key2];
1210
+ if (v === void 0) return [];
1211
+ if (!Array.isArray(v)) {
1212
+ problems.push(`${at}.${key2}: must be a list`);
1213
+ return [];
1235
1214
  }
1215
+ return v;
1216
+ };
1217
+ const requires = list("requires").filter((r) => {
1218
+ const ok = typeof r === "string" && BLOCK_ID.test(r);
1219
+ if (!ok) problems.push(`${at}.requires: ${JSON.stringify(r)} is not a feature id`);
1220
+ return ok;
1221
+ });
1222
+ let platforms;
1223
+ if (raw["platforms"] !== void 0) {
1224
+ platforms = list("platforms").filter((p) => {
1225
+ const ok = typeof p === "string" && FEATURE_PLATFORMS.includes(p);
1226
+ if (!ok) problems.push(`${at}.platforms: ${JSON.stringify(p)} is not one of ${FEATURE_PLATFORMS.join(", ")}`);
1227
+ return ok;
1228
+ });
1236
1229
  }
1237
- return out;
1238
- }
1239
- function readPackageExports(root, uiPackage) {
1240
- const uiDir = findPackageDir(root, uiPackage);
1241
- if (!uiDir) return null;
1242
- const uiPkg = JSON.parse(readFileSync(path20.join(uiDir, "package.json"), "utf8"));
1243
- const subpaths = Object.values(uiPkg.exports ?? {});
1244
- const declared = uiPkg.types ?? uiPkg.typings ?? exportTypes(uiPkg.exports?.["."] ?? uiPkg.exports);
1245
- const fromSource = typeof declared !== "string" && !subpaths.some((t) => typeof exportTypes(t) === "string");
1246
- const entryOf = fromSource ? exportSource : exportTypes;
1247
- const typeEntries = /* @__PURE__ */ new Set();
1248
- const mainTypes = fromSource ? exportSource(uiPkg.exports?.["."] ?? uiPkg.exports) ?? (isTsSource(uiPkg.main) ? uiPkg.main : void 0) : declared;
1249
- if (typeof mainTypes === "string") typeEntries.add(mainTypes);
1250
- for (const target of subpaths) {
1251
- const t = entryOf(target);
1252
- if (typeof t === "string" && !t.includes("*")) typeEntries.add(t);
1253
- }
1254
- const exportNames = /* @__PURE__ */ new Set();
1255
- const reexportedPackages = /* @__PURE__ */ new Set();
1256
- let readAny = false;
1257
- const seen = /* @__PURE__ */ new Set();
1258
- const readEntry = (file) => {
1259
- if (seen.has(file) || !insidePackage(uiDir, file) || !existsSync(file)) return;
1260
- seen.add(file);
1261
- readAny = true;
1262
- const code = fromSource ? stripComments(readFileSync(file, "utf8")) : readFileSync(file, "utf8");
1263
- for (const name of fromSource ? parseSourceExportNames(code) : parseExportNames(code)) exportNames.add(name);
1264
- for (const m of code.matchAll(/export\s+(?:type\s+)?(?:\{[^}]*\}|\*)\s*from\s*["']([^"'.][^"']*)["']/g)) {
1265
- reexportedPackages.add(packageName(m[1]));
1230
+ const packages = list("packages").map((p, i) => pkgOf(p, `${at}.packages[${i}]`));
1231
+ const install = list("install").filter((s) => {
1232
+ const ok = typeof s === "string" && INSTALL_SPEC.test(s) && !s.startsWith("-");
1233
+ if (!ok) problems.push(`${at}.install: ${JSON.stringify(s)} is not a package name with an optional range`);
1234
+ return ok;
1235
+ });
1236
+ const migrations = list("migrations").map((m, i) => {
1237
+ const where2 = `${at}.migrations[${i}]`;
1238
+ if (!isObject2(m)) {
1239
+ problems.push(`${where2}: must be an object`);
1240
+ return { package: home, file: "" };
1266
1241
  }
1267
- if (fromSource) {
1268
- for (const m of code.matchAll(/export\s+\*\s+from\s*["'](\.[^"']*)["']/g)) {
1269
- const next = resolveSource(path20.dirname(file), m[1]);
1270
- if (next) readEntry(next);
1242
+ const file = pathOf(m["file"], `${where2}.file`);
1243
+ if (file && !MIGRATION_FILE.test(file.split("/").pop())) problems.push(`${where2}.file: "${file}" must be named NNNN_name.sql (lowercase letters, digits, _)`);
1244
+ const out = { package: pkgOf(m["package"], where2), file };
1245
+ if (m["provides"] !== void 0) {
1246
+ if (!Array.isArray(m["provides"])) problems.push(`${where2}.provides: must be a list of { package, file }`);
1247
+ else {
1248
+ out.provides = m["provides"].map((p, j) => {
1249
+ const at2 = `${where2}.provides[${j}]`;
1250
+ if (!isObject2(p)) {
1251
+ problems.push(`${at2}: must be an object`);
1252
+ return { package: home, file: "" };
1253
+ }
1254
+ const provided = { package: pkgOf(p["package"], at2), file: pathOf(p["file"], `${at2}.file`) };
1255
+ if (p["functions"] !== void 0) {
1256
+ if (!Array.isArray(p["functions"])) problems.push(`${at2}.functions: must be a list of function folders`);
1257
+ else provided.functions = p["functions"].map((f, k) => pathOf(f, `${at2}.functions[${k}]`));
1258
+ }
1259
+ if (provided.file && !MIGRATION_FILE.test(provided.file.split("/").pop())) problems.push(`${at2}.file: "${provided.file}" must be named NNNN_name.sql`);
1260
+ if (provided.package === out.package && provided.file === file) problems.push(`${at2}: a migration can't provide itself`);
1261
+ return provided;
1262
+ });
1271
1263
  }
1272
1264
  }
1273
- };
1274
- for (const entry of typeEntries) readEntry(path20.join(uiDir, entry));
1275
- if (!readAny) {
1276
- const what = fromSource ? "type declarations or TypeScript source" : "type declarations";
1277
- throw new DoctorConfigError(`${uiPackage} has no ${what} to read (is it built?). Looked for: ${[...typeEntries].join(", ") || "none"}`);
1278
- }
1279
- const valueDecls = /* @__PURE__ */ new Set();
1280
- const typeDecls = /* @__PURE__ */ new Set();
1281
- const declRoot = typeof mainTypes === "string" ? path20.dirname(path20.join(uiDir, mainTypes)) : uiDir;
1282
- const declFiles = fromSource ? walkSource(declRoot) : walkDts(declRoot);
1283
- for (const pkg of reexportedPackages) {
1284
- const dir = findPackageDir(uiDir, pkg);
1285
- if (dir) walkDts(path20.join(dir, "dist"), declFiles);
1286
- }
1287
- for (const file of declFiles) {
1288
- const text = readFileSync(file, "utf8");
1289
- for (const m of text.matchAll(/\b(?:declare\s+)?(?:const|let|var|function|class|enum)\s+([A-Za-z_$][\w$]*)/g)) valueDecls.add(m[1]);
1290
- for (const m of text.matchAll(/\b(?:interface|type)\s+([A-Za-z_$][\w$]*)/g)) typeDecls.add(m[1]);
1291
- }
1292
- const isTypeOnly = (n) => typeDecls.has(n) && !valueDecls.has(n);
1293
- const values = new Set([...exportNames].filter((n) => !isTypeOnly(n)));
1294
- const components = [...values].filter((n) => /^[A-Z][A-Za-z0-9]*$/.test(n) && !(n.length > 2 && n === n.toUpperCase()) && !NON_COMPONENT_SUFFIX.test(n)).sort();
1295
- return { dir: uiDir, version: String(uiPkg.version ?? "unknown"), exports: exportNames, values, components };
1296
- }
1297
- function parseExportNames(dts) {
1298
- const names = [];
1299
- for (const m of dts.matchAll(/export\s+(?:type\s+)?\{([^}]*)\}/g)) {
1300
- for (const part of m[1].split(",")) {
1301
- const name = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).pop()?.trim();
1302
- if (name && name !== "default") names.push(name);
1265
+ if (m["needs"] !== void 0) {
1266
+ if (!Array.isArray(m["needs"])) problems.push(`${where2}.needs: must be a list of { function, how }`);
1267
+ else {
1268
+ out.needs = m["needs"].flatMap((n, j) => {
1269
+ const at2 = `${where2}.needs[${j}]`;
1270
+ if (!isObject2(n) || typeof n["function"] !== "string" || typeof n["how"] !== "string" || !n["how"].trim()) {
1271
+ problems.push(`${at2}: must be { function: "schema.name", how: "what to add" }`);
1272
+ return [];
1273
+ }
1274
+ if (!SQL_FUNCTION.test(n["function"])) {
1275
+ problems.push(`${at2}.function: "${n["function"]}" must be a schema-qualified function name, like private.genesis_viewer_people`);
1276
+ return [];
1277
+ }
1278
+ return [{ function: n["function"], how: n["how"].trim() }];
1279
+ });
1280
+ }
1303
1281
  }
1304
- }
1305
- for (const m of dts.matchAll(/export\s+(?:declare\s+)?(?:const|let|function|class|enum|interface|type)\s+([A-Za-z_$][\w$]*)/g)) {
1306
- names.push(m[1]);
1307
- }
1308
- return names;
1309
- }
1310
- function declaredTokens(css) {
1311
- return [...css.matchAll(/(--[A-Za-z0-9_-]+)\s*:/g)].map((m) => m[1]);
1312
- }
1313
- function packageName(specifier) {
1314
- const parts = specifier.split("/");
1315
- return parts.slice(0, specifier.startsWith("@") ? 2 : 1).join("/");
1316
- }
1317
- function parseSourceExportNames(code) {
1318
- const names = parseExportNames(code);
1319
- for (const m of code.matchAll(/export\s+(?:default\s+)?(?:declare\s+)?(?:abstract\s+)?(?:async\s+)?(?:var|class|function\*?)\s+([A-Za-z_$][\w$]*)/g)) names.push(m[1]);
1320
- for (const m of code.matchAll(/export\s+\*\s+as\s+([A-Za-z_$][\w$]*)/g)) names.push(m[1]);
1321
- return [...new Set(names)];
1322
- }
1323
- var TS_SOURCE = /\.(?:[cm]?tsx?)$/;
1324
- var isTsSource = (v) => typeof v === "string" && TS_SOURCE.test(v) && !/\.d\.[cm]?ts$/.test(v);
1325
- function exportSource(target) {
1326
- if (isTsSource(target)) return target;
1327
- if (!target || typeof target !== "object") return void 0;
1328
- for (const value of Object.values(target)) {
1329
- const nested = exportSource(value);
1330
- if (nested) return nested;
1331
- }
1332
- return void 0;
1333
- }
1334
- function resolveSource(dir, spec) {
1335
- const base = path20.resolve(dir, spec.replace(/\.js$/, ""));
1336
- const candidates = [base, ...[".ts", ".tsx", ".mts", ".cts"].map((e) => base + e), ...["index.ts", "index.tsx"].map((i) => path20.join(base, i))];
1337
- return candidates.find((f) => TS_SOURCE.test(f) && existsSync(f) && statSync(f).isFile()) ?? null;
1338
- }
1339
- function insidePackage(dir, file) {
1340
- const rel = path20.relative(path20.resolve(dir), path20.resolve(file));
1341
- return rel === "" || !rel.startsWith("..") && !path20.isAbsolute(rel);
1342
- }
1343
- function stripComments(code) {
1344
- let out = "";
1345
- let i = 0;
1346
- while (i < code.length) {
1347
- const c = code[i];
1348
- const next = code[i + 1];
1349
- if (c === "/" && next === "*") {
1350
- const end = code.indexOf("*/", i + 2);
1351
- const stop = end < 0 ? code.length : end + 2;
1352
- out += code.slice(i, stop).replace(/[^\n]/g, " ");
1353
- i = stop;
1354
- } else if (c === "/" && next === "/") {
1355
- const end = code.indexOf("\n", i);
1356
- i = end < 0 ? code.length : end;
1357
- } else if (c === '"' || c === "'" || c === "`") {
1358
- let j = i + 1;
1359
- while (j < code.length && code[j] !== c) {
1360
- if (code[j] === "\\") j++;
1361
- else if (c !== "`" && code[j] === "\n") break;
1362
- j++;
1363
- }
1364
- out += code.slice(i, j + 1);
1365
- i = j + 1;
1366
- } else {
1367
- out += c;
1368
- i++;
1369
- }
1370
- }
1371
- return out;
1372
- }
1373
- function walkSource(dir, out = []) {
1374
- if (!existsSync(dir)) return out;
1375
- for (const entry of readdirSync(dir, { withFileTypes: true })) {
1376
- if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
1377
- const p = path20.join(dir, entry.name);
1378
- if (entry.isDirectory()) walkSource(p, out);
1379
- else if (isTsSource(entry.name) || /\.d\.[cm]?ts$/.test(entry.name)) out.push(p);
1380
- }
1381
- return out;
1382
- }
1383
- function exportTypes(target) {
1384
- if (!target || typeof target !== "object") return void 0;
1385
- const t = target;
1386
- if (typeof t.types === "string") return t.types;
1387
- for (const key2 of ["import", "default", "require"]) {
1388
- const nested = exportTypes(t[key2]);
1389
- if (nested) return nested;
1390
- }
1391
- return void 0;
1392
- }
1393
- function walkDts(dir, out = []) {
1394
- if (!existsSync(dir)) return out;
1395
- for (const entry of readdirSync(dir, { withFileTypes: true })) {
1396
- if (entry.name === "node_modules") continue;
1397
- const p = path20.join(dir, entry.name);
1398
- if (entry.isDirectory()) walkDts(p, out);
1399
- else if (/\.d\.[cm]?ts$/.test(entry.name)) out.push(p);
1400
- }
1401
- return out;
1402
- }
1403
- function resolveThemeFiles(root, config, uiDir) {
1404
- if (config.themeCss) {
1405
- const specs = typeof config.themeCss === "string" ? [config.themeCss] : config.themeCss;
1406
- return specs.map((spec) => {
1407
- const file = resolveSpec(root, spec);
1408
- if (!file) throw new DoctorConfigError(`doctor.themeCss: cannot find ${spec}`);
1409
- return file;
1410
- });
1411
- }
1412
- const files = [];
1413
- const ds = findPackageDir(root, DESIGN_SYSTEM_PACKAGE);
1414
- const themes = ds && path20.join(ds, "dist", "themes");
1415
- if (themes && existsSync(themes)) {
1416
- for (const name of readdirSync(themes).sort()) if (name.endsWith(".css")) files.push(path20.join(themes, name));
1417
- }
1418
- if (files.length === 0) {
1419
- throw new DoctorConfigError(
1420
- `No Genesis theme stylesheet found (${DESIGN_SYSTEM_PACKAGE}/dist/themes/*.css). Install the design system, or set doctor.themeCss.`
1421
- );
1422
- }
1423
- const uiStyles = path20.join(uiDir, "dist", "styles.css");
1424
- if (existsSync(uiStyles)) files.push(uiStyles);
1425
- return files;
1426
- }
1427
- function resolveSpec(root, spec) {
1428
- const local = path20.resolve(root, spec);
1429
- if (spec.startsWith(".") || path20.isAbsolute(spec)) return existsSync(local) ? local : null;
1430
- const parts = spec.split("/");
1431
- const nameLength = spec.startsWith("@") ? 2 : 1;
1432
- const dir = findPackageDir(root, parts.slice(0, nameLength).join("/"));
1433
- if (dir) {
1434
- const file = path20.join(dir, ...parts.slice(nameLength));
1435
- if (existsSync(file) && statSync(file).isFile()) return file;
1436
- }
1437
- return existsSync(local) ? local : null;
1438
- }
1439
- function loadPalette(root) {
1440
- const names = new Set(TAILWIND_PALETTE);
1441
- try {
1442
- const req = createRequire(path20.join(root, "package.json"));
1443
- const colors = req("tailwindcss/colors");
1444
- for (const key2 of Object.keys(colors?.default ?? colors ?? {})) {
1445
- if (/^[a-z]+$/.test(key2) && !["inherit", "current", "transparent"].includes(key2)) names.add(key2);
1446
- }
1447
- } catch {
1448
- }
1449
- return [...names].sort();
1450
- }
1451
- var GENESIS_PACKAGE = /^@marktiderman\/genesis(-[a-z0-9-]+)?$/;
1452
- var BLOCK_ID = /^[a-z][a-z0-9]*(?:[-_.][a-z0-9]+)*$/;
1453
- var MIGRATION_FILE = /^(\d{4})_([a-z0-9_]+)\.sql$/;
1454
- var FUNCTION_NAME = /^[a-z0-9][a-z0-9_-]*$/;
1455
- var ROUTE = /^\/(?:[A-Za-z0-9_\-[\]().]+\/?)*$/;
1456
- var INSTALL_SPEC = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*(@[A-Za-z0-9.^~<>=|* -]+)?$/;
1457
- var SECRET = /^[A-Z][A-Z0-9_]*$/;
1458
- var ManifestError = class extends Error {
1459
- constructor(problems) {
1460
- super(`Invalid block manifest:
1461
- ${problems.map((p) => ` - ${p}`).join("\n")}`);
1462
- this.problems = problems;
1463
- this.name = "ManifestError";
1464
- }
1465
- problems;
1466
- };
1467
- function safeRelative(value) {
1468
- if (typeof value !== "string" || !value || value.length > 300) return null;
1469
- if (/[\0\\:]/.test(value) || value.startsWith("/") || value.startsWith("~")) return null;
1470
- const segments = value.split("/");
1471
- if (segments.some((s) => s === "" || s === "." || s === ".." || s.startsWith("-"))) return null;
1472
- return value;
1473
- }
1474
- var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
1475
- var strings = (v) => Array.isArray(v) && v.every((s) => typeof s === "string");
1476
- function parseManifest(home, id, raw, version, options = {}) {
1477
- const problems = [];
1478
- const at = `${home} genesis.blocks.${id}`;
1479
- if (!GENESIS_PACKAGE.test(home) && !options.local) problems.push(`${home}: only Genesis packages (@marktiderman/genesis*) and the app's local packages declare blocks`);
1480
- if (!BLOCK_ID.test(id)) problems.push(`${at}: "${id}" is not a feature id`);
1481
- if (!isObject2(raw)) throw new ManifestError([...problems, `${at}: must be an object`]);
1482
- const pkgOf = (value, where2) => {
1483
- if (value === void 0) return home;
1484
- if (typeof value !== "string" || !(GENESIS_PACKAGE.test(value) || options.local && value === home)) {
1485
- problems.push(`${where2}: package must be a Genesis package${options.local ? " or this local package" : ""}, not ${JSON.stringify(value)}`);
1486
- return home;
1487
- }
1488
- return value;
1489
- };
1490
- const pathOf = (value, where2) => {
1491
- const safe = safeRelative(value);
1492
- if (!safe) problems.push(`${where2}: ${JSON.stringify(value)} is not a plain path inside the package`);
1493
- return safe ?? "";
1494
- };
1495
- const list = (key2) => {
1496
- const v = raw[key2];
1497
- if (v === void 0) return [];
1498
- if (!Array.isArray(v)) {
1499
- problems.push(`${at}.${key2}: must be a list`);
1500
- return [];
1501
- }
1502
- return v;
1503
- };
1504
- const requires = list("requires").filter((r) => {
1505
- const ok = typeof r === "string" && BLOCK_ID.test(r);
1506
- if (!ok) problems.push(`${at}.requires: ${JSON.stringify(r)} is not a feature id`);
1507
- return ok;
1508
- });
1509
- let platforms;
1510
- if (raw["platforms"] !== void 0) {
1511
- platforms = list("platforms").filter((p) => {
1512
- const ok = typeof p === "string" && FEATURE_PLATFORMS.includes(p);
1513
- if (!ok) problems.push(`${at}.platforms: ${JSON.stringify(p)} is not one of ${FEATURE_PLATFORMS.join(", ")}`);
1514
- return ok;
1515
- });
1516
- }
1517
- const packages = list("packages").map((p, i) => pkgOf(p, `${at}.packages[${i}]`));
1518
- const install = list("install").filter((s) => {
1519
- const ok = typeof s === "string" && INSTALL_SPEC.test(s) && !s.startsWith("-");
1520
- if (!ok) problems.push(`${at}.install: ${JSON.stringify(s)} is not a package name with an optional range`);
1521
- return ok;
1522
- });
1523
- const migrations = list("migrations").map((m, i) => {
1524
- const where2 = `${at}.migrations[${i}]`;
1525
- if (!isObject2(m)) {
1526
- problems.push(`${where2}: must be an object`);
1527
- return { package: home, file: "" };
1528
- }
1529
- const file = pathOf(m["file"], `${where2}.file`);
1530
- if (file && !MIGRATION_FILE.test(file.split("/").pop())) problems.push(`${where2}.file: "${file}" must be named NNNN_name.sql (lowercase letters, digits, _)`);
1531
- const out = { package: pkgOf(m["package"], where2), file };
1532
- if (m["provides"] !== void 0) {
1533
- if (!Array.isArray(m["provides"])) problems.push(`${where2}.provides: must be a list of { package, file }`);
1282
+ if (m["runsBefore"] !== void 0) {
1283
+ if (!Array.isArray(m["runsBefore"])) problems.push(`${where2}.runsBefore: must be a list of { package, file }`);
1534
1284
  else {
1535
- out.provides = m["provides"].map((p, j) => {
1536
- const at2 = `${where2}.provides[${j}]`;
1537
- if (!isObject2(p)) {
1285
+ out.runsBefore = m["runsBefore"].map((r, j) => {
1286
+ const at2 = `${where2}.runsBefore[${j}]`;
1287
+ if (!isObject2(r)) {
1538
1288
  problems.push(`${at2}: must be an object`);
1539
1289
  return { package: home, file: "" };
1540
1290
  }
1541
- const provided = { package: pkgOf(p["package"], at2), file: pathOf(p["file"], `${at2}.file`) };
1542
- if (p["functions"] !== void 0) {
1543
- if (!Array.isArray(p["functions"])) problems.push(`${at2}.functions: must be a list of function folders`);
1544
- else provided.functions = p["functions"].map((f, k) => pathOf(f, `${at2}.functions[${k}]`));
1545
- }
1546
- if (provided.file && !MIGRATION_FILE.test(provided.file.split("/").pop())) problems.push(`${at2}.file: "${provided.file}" must be named NNNN_name.sql`);
1547
- if (provided.package === out.package && provided.file === file) problems.push(`${at2}: a migration can't provide itself`);
1548
- return provided;
1291
+ const before = { package: pkgOf(r["package"], at2), file: pathOf(r["file"], `${at2}.file`) };
1292
+ if (before.file && !MIGRATION_FILE.test(before.file.split("/").pop())) problems.push(`${at2}.file: "${before.file}" must be named NNNN_name.sql`);
1293
+ if (before.package === out.package && before.file === file) problems.push(`${at2}: a migration can't run before itself`);
1294
+ return before;
1549
1295
  });
1550
1296
  }
1551
1297
  }
@@ -1663,15 +1409,15 @@ function isBlockDef(value) {
1663
1409
  // src/blocks/files.ts
1664
1410
  var sha256 = (text) => createHash("sha256").update(text).digest("hex");
1665
1411
  function inside(parent, child) {
1666
- const rel = path20.relative(parent, child);
1667
- return rel === "" || !rel.startsWith("..") && !path20.isAbsolute(rel);
1412
+ const rel = path21.relative(parent, child);
1413
+ return rel === "" || !rel.startsWith("..") && !path21.isAbsolute(rel);
1668
1414
  }
1669
1415
  function appPath2(root, rel) {
1670
1416
  const safe = safeRelative(rel.replace(/^\.\//, ""));
1671
1417
  if (!safe) throw new Error(`"${rel}" is not a plain path inside the app`);
1672
1418
  if (safe.split("/").some((s) => s.toLowerCase() === ".git")) throw new Error(`"${rel}" is inside .git; refused`);
1673
1419
  const realRoot = realpathSync(root);
1674
- const target = path20.join(realRoot, ...safe.split("/"));
1420
+ const target = path21.join(realRoot, ...safe.split("/"));
1675
1421
  const there = (p) => {
1676
1422
  try {
1677
1423
  lstatSync(p);
@@ -1680,20 +1426,18 @@ function appPath2(root, rel) {
1680
1426
  return false;
1681
1427
  }
1682
1428
  };
1683
- let probe = path20.dirname(target);
1684
- while (!there(probe)) probe = path20.dirname(probe);
1429
+ let probe = path21.dirname(target);
1430
+ while (!there(probe)) probe = path21.dirname(probe);
1685
1431
  let real2;
1686
1432
  try {
1687
1433
  real2 = realpathSync(probe);
1688
1434
  } catch {
1689
- throw new Error(`${rel} goes through a broken symlink (${path20.relative(realRoot, probe)}); refused`);
1435
+ throw new Error(`${rel} goes through a broken symlink (${path21.relative(realRoot, probe)}); refused`);
1690
1436
  }
1691
1437
  if (!inside(realRoot, real2)) throw new Error(`${rel} is outside the app (a symlinked folder?)`);
1692
1438
  if (there(target) && lstatSync(target).isSymbolicLink()) throw new Error(`${rel} is a symlink; left alone`);
1693
1439
  return target;
1694
1440
  }
1695
-
1696
- // src/blocks/local.ts
1697
1441
  var LOCAL_PACKAGES_KEY = "localPackages";
1698
1442
  var LocalPackagesError = class extends Error {
1699
1443
  name = "LocalPackagesError";
@@ -1703,8 +1447,8 @@ function validateLocalPackages(raw, source = "genesis.config.json") {
1703
1447
  return raw.map((entry, i) => {
1704
1448
  const where2 = `${source}: ${LOCAL_PACKAGES_KEY}[${i}]`;
1705
1449
  if (typeof entry !== "string" || !entry.trim()) throw new LocalPackagesError(`${where2} must be a non-empty folder`);
1706
- if (path20.isAbsolute(entry) || /^[A-Za-z]:[\\/]/.test(entry)) throw new LocalPackagesError(`${where2} must be relative to the app ("${entry}")`);
1707
- const norm = path20.posix.normalize(entry.replace(/\\/g, "/")).replace(/\/+$/, "");
1450
+ if (path21.isAbsolute(entry) || /^[A-Za-z]:[\\/]/.test(entry)) throw new LocalPackagesError(`${where2} must be relative to the app ("${entry}")`);
1451
+ const norm = path21.posix.normalize(entry.replace(/\\/g, "/")).replace(/\/+$/, "");
1708
1452
  if (norm === "." || /^(\.\.\/)*\.\.$/.test(norm)) throw new LocalPackagesError(`${where2} must name a package folder, not the app or a parent of it ("${entry}")`);
1709
1453
  const parts = norm.split("/");
1710
1454
  if (parts.some((p, k) => p.includes("*") && (p !== "*" || k !== parts.length - 1))) {
@@ -1715,7 +1459,7 @@ function validateLocalPackages(raw, source = "genesis.config.json") {
1715
1459
  });
1716
1460
  }
1717
1461
  function localPackageGlobs(root) {
1718
- const file = path20.join(root, "genesis.config.json");
1462
+ const file = path21.join(root, "genesis.config.json");
1719
1463
  if (!existsSync(file)) return [];
1720
1464
  let raw;
1721
1465
  try {
@@ -1729,14 +1473,14 @@ function localPackageGlobs(root) {
1729
1473
  var cache = /* @__PURE__ */ new Map();
1730
1474
  function repositoryRoot(appRoot) {
1731
1475
  for (let dir = appRoot; ; ) {
1732
- if (existsSync(path20.join(dir, ".git"))) return dir;
1733
- const parent = path20.dirname(dir);
1476
+ if (existsSync(path21.join(dir, ".git"))) return dir;
1477
+ const parent = path21.dirname(dir);
1734
1478
  if (parent === dir) return appRoot;
1735
1479
  dir = parent;
1736
1480
  }
1737
1481
  }
1738
1482
  function localPackages(root) {
1739
- const appRoot = path20.resolve(root);
1483
+ const appRoot = path21.resolve(root);
1740
1484
  const globs = localPackageGlobs(appRoot);
1741
1485
  const key2 = `${appRoot}
1742
1486
  ${globs.join("\n")}`;
@@ -1745,24 +1489,24 @@ ${globs.join("\n")}`;
1745
1489
  const dirs = /* @__PURE__ */ new Set();
1746
1490
  for (const glob of globs) {
1747
1491
  if (glob.endsWith("/*") || glob === "*") {
1748
- const parent = path20.join(appRoot, glob === "*" ? "" : glob.slice(0, -2));
1492
+ const parent = path21.join(appRoot, glob === "*" ? "" : glob.slice(0, -2));
1749
1493
  if (!existsSync(parent) || !statSync(parent).isDirectory()) continue;
1750
1494
  for (const entry of readdirSync(parent).sort()) {
1751
1495
  if (entry.startsWith(".") || entry === "node_modules") continue;
1752
- dirs.add(path20.join(parent, entry));
1496
+ dirs.add(path21.join(parent, entry));
1753
1497
  }
1754
1498
  } else {
1755
- dirs.add(path20.join(appRoot, glob));
1499
+ dirs.add(path21.join(appRoot, glob));
1756
1500
  }
1757
1501
  }
1758
1502
  const real2 = realpathSync(repositoryRoot(appRoot));
1759
1503
  const out = [];
1760
1504
  const byName = /* @__PURE__ */ new Map();
1761
1505
  for (const dir of [...dirs].sort()) {
1762
- const manifest = path20.join(dir, "package.json");
1506
+ const manifest = path21.join(dir, "package.json");
1763
1507
  if (!existsSync(manifest)) continue;
1764
1508
  if (!inside(real2, realpathSync(dir))) {
1765
- throw new LocalPackagesError(`${path20.relative(appRoot, dir) || dir} is outside the repository; localPackages may only list folders inside it`);
1509
+ throw new LocalPackagesError(`${path21.relative(appRoot, dir) || dir} is outside the repository; localPackages may only list folders inside it`);
1766
1510
  }
1767
1511
  let pkg;
1768
1512
  try {
@@ -1771,7 +1515,7 @@ ${globs.join("\n")}`;
1771
1515
  continue;
1772
1516
  }
1773
1517
  if (typeof pkg.name !== "string" || !pkg.name) continue;
1774
- const rel = path20.relative(appRoot, dir).split(path20.sep).join("/");
1518
+ const rel = path21.relative(appRoot, dir).split(path21.sep).join("/");
1775
1519
  const other = byName.get(pkg.name);
1776
1520
  if (other) throw new LocalPackagesError(`${other} and ${rel} are both named ${pkg.name}`);
1777
1521
  byName.set(pkg.name, rel);
@@ -1959,35 +1703,35 @@ var DEFAULT_IGNORE = [
1959
1703
  ];
1960
1704
  var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", ".next", ".output", ".turbo", "coverage"]);
1961
1705
  var MAX_FILE_BYTES = 2 * 1024 * 1024;
1962
- var toPosix = (p) => p.split(path20.sep).join("/");
1706
+ var toPosix = (p) => p.split(path21.sep).join("/");
1963
1707
  function scanFiles(root, config) {
1964
1708
  const extensions = new Set(config.extensions ?? DEFAULT_EXTENSIONS);
1965
1709
  const ignored = globMatcher([...DEFAULT_IGNORE, ...config.ignore ?? []]);
1966
1710
  const files = [];
1967
1711
  const seen = /* @__PURE__ */ new Set();
1968
1712
  const visit = (abs) => {
1969
- const rel = toPosix(path20.relative(root, abs));
1713
+ const rel = toPosix(path21.relative(root, abs));
1970
1714
  if (seen.has(rel) || ignored(rel)) return;
1971
- const ext = path20.extname(abs);
1715
+ const ext = path21.extname(abs);
1972
1716
  if (!extensions.has(ext)) return;
1973
1717
  if (statSync(abs).size > MAX_FILE_BYTES) return;
1974
1718
  seen.add(rel);
1975
1719
  const text = readFileSync(abs, "utf8");
1976
1720
  files.push({ path: rel, absolutePath: abs, ext, text, code: stripBlockComments(text, LINE_COMMENT_EXTS.has(ext)) });
1977
1721
  };
1978
- const walk2 = (dir) => {
1722
+ const walk3 = (dir) => {
1979
1723
  for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
1980
1724
  if (entry.isDirectory()) {
1981
- if (!SKIP_DIRS.has(entry.name)) walk2(path20.join(dir, entry.name));
1725
+ if (!SKIP_DIRS.has(entry.name)) walk3(path21.join(dir, entry.name));
1982
1726
  } else if (entry.isFile()) {
1983
- visit(path20.join(dir, entry.name));
1727
+ visit(path21.join(dir, entry.name));
1984
1728
  }
1985
1729
  }
1986
1730
  };
1987
1731
  for (const src of config.src ?? (config.packs?.includes("native") ? DEFAULT_NATIVE_SRC : DEFAULT_SRC)) {
1988
- const abs = path20.resolve(root, src);
1732
+ const abs = path21.resolve(root, src);
1989
1733
  if (!existsSync(abs)) continue;
1990
- if (statSync(abs).isDirectory()) walk2(abs);
1734
+ if (statSync(abs).isDirectory()) walk3(abs);
1991
1735
  else visit(abs);
1992
1736
  }
1993
1737
  let local = [];
@@ -1996,7 +1740,7 @@ function scanFiles(root, config) {
1996
1740
  } catch {
1997
1741
  local = [];
1998
1742
  }
1999
- for (const pkg of local) walk2(pkg.dir);
1743
+ for (const pkg of local) walk3(pkg.dir);
2000
1744
  return files;
2001
1745
  }
2002
1746
  function lineAt(text, index) {
@@ -2005,147 +1749,11 @@ function lineAt(text, index) {
2005
1749
  return line;
2006
1750
  }
2007
1751
 
2008
- // src/doctor/patterns.ts
2009
- function parseRulesMarkdown(markdown) {
2010
- const rules = [];
2011
- let current = null;
2012
- for (const line of markdown.split("\n")) {
2013
- const heading = line.match(/^###\s+([A-Za-z0-9_-]+)\s*$/);
2014
- if (heading) {
2015
- current = { id: heading[1] };
2016
- rules.push(current);
2017
- continue;
2018
- }
2019
- if (/^#{1,2}\s/.test(line)) {
2020
- current = null;
2021
- continue;
2022
- }
2023
- const kv = current && line.match(/^-\s+(level|files|exclude|forbid|require|path|message|newOnly):\s*(.*)$/);
2024
- if (!current || !kv) continue;
2025
- const [, key2, raw] = kv;
2026
- const value = raw.trim();
2027
- if (key2 === "files" || key2 === "exclude") current[key2] = value.split(",").map((s) => s.trim()).filter(Boolean);
2028
- else if (key2 === "level") current.level = value;
2029
- else if (key2 === "newOnly") current.newOnly = value === "true" ? true : value === "false" ? false : value;
2030
- else current[key2] = value;
2031
- }
2032
- return rules;
2033
- }
2034
- function toRegExp(source, flags = "") {
2035
- if (source.startsWith("(?i)")) return new RegExp(source.slice(4), flags + "i");
2036
- return new RegExp(source, flags);
2037
- }
2038
- function compilePatternRules(rules, source) {
2039
- const ids = /* @__PURE__ */ new Set();
2040
- const out = [];
2041
- for (const rule of rules) {
2042
- if (ids.has(rule.id)) throw new DoctorConfigError(`${source}: rule "${rule.id}" is defined twice`);
2043
- ids.add(rule.id);
2044
- const level = rule.level ?? "error";
2045
- if (!["error", "warn", "info", "guide"].includes(level)) {
2046
- throw new DoctorConfigError(`${source}: rule "${rule.id}" has level "${level}" (use error, warn, info or guide)`);
2047
- }
2048
- if (rule.newOnly !== void 0 && typeof rule.newOnly !== "boolean") {
2049
- throw new DoctorConfigError(`${source}: rule "${rule.id}" has newOnly "${String(rule.newOnly)}" (use true or false)`);
2050
- }
2051
- if (level === "guide") continue;
2052
- if (!rule.files?.length) throw new DoctorConfigError(`${source}: rule "${rule.id}" needs "files" (or level: guide)`);
2053
- if (!rule.forbid && !rule.require && !rule.path) {
2054
- throw new DoctorConfigError(`${source}: rule "${rule.id}" needs forbid, require or path (or level: guide)`);
2055
- }
2056
- try {
2057
- out.push({
2058
- rule,
2059
- level,
2060
- includes: globMatcher(rule.files),
2061
- excludes: globMatcher(rule.exclude),
2062
- forbid: rule.forbid ? toRegExp(rule.forbid, "m") : void 0,
2063
- require: rule.require ? toRegExp(rule.require, "m") : void 0,
2064
- path: rule.path ? toRegExp(rule.path) : void 0
2065
- });
2066
- } catch (err) {
2067
- throw new DoctorConfigError(`${source}: rule "${rule.id}" has an invalid pattern: ${err.message}`);
2068
- }
2069
- }
2070
- return out;
2071
- }
2072
- function loadPatternRules(root, patterns, rulesDoc) {
2073
- const compiled = compilePatternRules(patterns ?? [], "doctor.patterns");
2074
- let all = compiled;
2075
- if (rulesDoc) {
2076
- const file = path20.resolve(root, rulesDoc);
2077
- if (!existsSync(file)) throw new DoctorConfigError(`doctor.rulesDoc: ${rulesDoc} not found`);
2078
- const fromDoc = compilePatternRules(parseRulesMarkdown(readFileSync(file, "utf8")), rulesDoc);
2079
- const clash = fromDoc.find((d) => compiled.some((c) => c.rule.id === d.rule.id));
2080
- if (clash) throw new DoctorConfigError(`rule "${clash.rule.id}" is defined in both doctor.patterns and ${rulesDoc}`);
2081
- all = [...compiled, ...fromDoc];
2082
- }
2083
- if (all.length === 0) return null;
2084
- return {
2085
- count: all.length,
2086
- ids: all.map((r) => r.rule.id),
2087
- newOnly: all.filter((r) => r.rule.newOnly).map((r) => r.rule.id),
2088
- plugin: {
2089
- name: "patterns",
2090
- check(ctx) {
2091
- for (const r of all) {
2092
- const message = r.rule.message ?? "breaks a design rule";
2093
- for (const file of ctx.files) {
2094
- if (!r.includes(file.path) || r.excludes(file.path)) continue;
2095
- const report = (line) => ctx.report({ rule: r.rule.id, level: r.level, file: file.path, line, message });
2096
- if (r.path && !r.path.test(file.path)) report(0);
2097
- if (r.require && !r.require.test(file.code)) report(0);
2098
- if (r.forbid) {
2099
- const m = r.forbid.exec(file.code);
2100
- if (m) report(lineAt(file.code, m.index));
2101
- }
2102
- }
2103
- }
2104
- }
2105
- }
2106
- };
2107
- }
2108
- async function loadPlugins(specs, configDir) {
2109
- const plugins = [];
2110
- for (const spec of specs ?? []) {
2111
- const [id, options] = typeof spec === "string" ? [spec, void 0] : spec;
2112
- const file = resolvePlugin(id, configDir);
2113
- const url = `${pathToFileURL(file).href}?mtime=${statSync(file).mtimeMs}`;
2114
- let mod;
2115
- try {
2116
- mod = await import(url);
2117
- } catch (err) {
2118
- throw new DoctorConfigError(`doctor.plugins: could not load ${id}: ${err.message}`);
2119
- }
2120
- let value = mod.default;
2121
- if (typeof value === "function") value = await value(options);
2122
- const list = Array.isArray(value) ? value : [value];
2123
- for (const p of list) {
2124
- if (!p || typeof p !== "object" || typeof p.check !== "function" || typeof p.name !== "string") {
2125
- throw new DoctorConfigError(`doctor.plugins: ${id} must default-export { name, check(context) } (or an array, or a factory returning one)`);
2126
- }
2127
- plugins.push(p);
2128
- }
2129
- }
2130
- return plugins;
2131
- }
2132
- function resolvePlugin(id, configDir) {
2133
- try {
2134
- if (id.startsWith(".") || path20.isAbsolute(id)) return resolveFrom(path20.resolve(configDir, id), configDir);
2135
- return resolveFrom(id, configDir);
2136
- } catch {
2137
- throw new DoctorConfigError(`doctor.plugins: cannot find ${id} (relative paths resolve from ${configDir})`);
2138
- }
2139
- }
2140
- function resolveFrom(id, from) {
2141
- return createRequire(path20.join(from, "noop.js")).resolve(id);
2142
- }
2143
-
2144
- // src/doctor/semver.ts
2145
- var VERSION = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
2146
- function parseVersion(v) {
2147
- const m = VERSION.exec(v.trim());
2148
- return m ? { major: +m[1], minor: +m[2], patch: +m[3], pre: m[4] ? m[4].split(".") : [] } : null;
1752
+ // src/doctor/semver.ts
1753
+ var VERSION = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
1754
+ function parseVersion(v) {
1755
+ const m = VERSION.exec(v.trim());
1756
+ return m ? { major: +m[1], minor: +m[2], patch: +m[3], pre: m[4] ? m[4].split(".") : [] } : null;
2149
1757
  }
2150
1758
  function compareVersions(a, b) {
2151
1759
  for (const k of ["major", "minor", "patch"]) if (a[k] !== b[k]) return a[k] < b[k] ? -1 : 1;
@@ -2260,46 +1868,6 @@ function satisfies(version, range) {
2260
1868
  (set) => set.every((c) => test(c, v)) && (!v.pre.length || set.some((c) => c.pre && c.v.major === v.major && c.v.minor === v.minor && c.v.patch === v.patch))
2261
1869
  );
2262
1870
  }
2263
- var UMBRELLA_PACKAGE = "@marktiderman/genesis";
2264
- function readReleaseManifest(root) {
2265
- const dir = findPackageDir(root, UMBRELLA_PACKAGE);
2266
- const file = dir && path20.join(dir, "dist", "versions.json");
2267
- if (!file || !existsSync(file)) return null;
2268
- return JSON.parse(readFileSync(file, "utf8"));
2269
- }
2270
- function checkVersionSkew(ctx) {
2271
- const manifest = readReleaseManifest(ctx.root);
2272
- if (!manifest) return;
2273
- const overlays = markedOverlays(ctx);
2274
- for (const [name, want] of Object.entries(manifest.packages)) {
2275
- const overlay = overlays.get(name);
2276
- if (overlay) {
2277
- const from = overlay.marker.upstream.slice(overlay.marker.upstream.lastIndexOf("@") + 1);
2278
- const behind = parseVersion(from) && parseVersion(want) && compareVersions(parseVersion(from), parseVersion(want)) < 0;
2279
- if (from !== want && !behind) {
2280
- ctx.report({
2281
- rule: "version-skew",
2282
- level: "warn",
2283
- file: "package.json",
2284
- subject: name,
2285
- message: `the app's overlay of ${name} was copied from ${from}, but ${UMBRELLA_PACKAGE} ${manifest.version} was released with ${want}. Bring the overlay onto ${want} (or promote it and adopt the release).`
2286
- });
2287
- }
2288
- continue;
2289
- }
2290
- const dir = findPackageDir(ctx.root, name);
2291
- if (!dir) continue;
2292
- const have = JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8")).version;
2293
- if (have === want) continue;
2294
- ctx.report({
2295
- rule: "version-skew",
2296
- level: "warn",
2297
- file: "package.json",
2298
- subject: name,
2299
- message: `${name} is ${have}, but ${UMBRELLA_PACKAGE} ${manifest.version} was released with ${want}. Install ${name}@${want}, or move every Genesis package to one release.`
2300
- });
2301
- }
2302
- }
2303
1871
 
2304
1872
  // src/doctor/overlays.ts
2305
1873
  var GENESIS_PACKAGE_NAME = /^@marktiderman\/genesis(?:-[a-z0-9-]+)?$/;
@@ -2315,7 +1883,7 @@ function overlayState(name, json) {
2315
1883
  function overlaySetupProblems(root, config, dir, name, json) {
2316
1884
  const problems = [];
2317
1885
  if (json.private !== true) problems.push(`${name}: an overlay is the app's own copy and never publishes; set "private": true`);
2318
- const rel = path20.relative(path20.resolve(root), path20.resolve(dir)).split(path20.sep).join("/");
1886
+ const rel = path21.relative(path21.resolve(root), path21.resolve(dir)).split(path21.sep).join("/");
2319
1887
  const sources = (config.src ?? (config.packs?.includes("native") ? DEFAULT_NATIVE_SRC : DEFAULT_SRC)).map((s) => s.replace(/^\.\//, "").replace(/\/+$/, ""));
2320
1888
  const holds = sources.find((s) => rel === "" || s === rel || s.startsWith(`${rel}/`));
2321
1889
  if (holds !== void 0) problems.push(`${name}: an overlay lives in a package folder of its own, not in ${rel || "the app root"}, which holds the app's source (${holds})`);
@@ -2352,92 +1920,757 @@ function pinnedVersion(root, name, manifests = ["package.json"]) {
2352
1920
  for (const file of manifests) {
2353
1921
  let json;
2354
1922
  try {
2355
- json = JSON.parse(readFileSync(path20.join(root, file), "utf8"));
2356
- } catch {
2357
- continue;
1923
+ json = JSON.parse(readFileSync(path21.join(root, file), "utf8"));
1924
+ } catch {
1925
+ continue;
1926
+ }
1927
+ for (const section2 of ["dependencies", "devDependencies", "optionalDependencies"]) {
1928
+ const spec = json[section2]?.[name];
1929
+ const v = typeof spec === "string" ? /^[\^~=]?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/.exec(spec)?.[1] : void 0;
1930
+ const parsed = v && parseVersion(v);
1931
+ if (parsed && (!best || compareVersions(parsed, parseVersion(best)) > 0)) best = v;
1932
+ }
1933
+ }
1934
+ return best;
1935
+ }
1936
+ function checkOverlays(ctx, now = /* @__PURE__ */ new Date()) {
1937
+ let packages;
1938
+ try {
1939
+ packages = localPackages(ctx.root);
1940
+ } catch {
1941
+ return;
1942
+ }
1943
+ for (const pkg of packages) {
1944
+ if (!GENESIS_PACKAGE_NAME.test(pkg.name)) continue;
1945
+ const file = `${pkg.rel}/package.json`;
1946
+ let json;
1947
+ try {
1948
+ json = JSON.parse(readFileSync(path21.join(pkg.dir, "package.json"), "utf8"));
1949
+ } catch {
1950
+ continue;
1951
+ }
1952
+ const state = overlayState(pkg.name, json);
1953
+ if (state.kind === "none") {
1954
+ ctx.report({
1955
+ rule: "overlay-unmarked",
1956
+ file,
1957
+ subject: pkg.name,
1958
+ message: `${pkg.name} is a local package with a Genesis package's name, so it shadows the published one, but it carries no overlay marker; add "genesis": { "overlay": { "upstream": "${pkg.name}@<version copied>", "since": "YYYY-MM-DD", "owner": "\u2026", "reason": "\u2026" } }, or rename it`
1959
+ });
1960
+ continue;
1961
+ }
1962
+ if (state.kind === "invalid") {
1963
+ for (const problem of state.problems) ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: problem });
1964
+ continue;
1965
+ }
1966
+ const { marker } = state;
1967
+ for (const problem of overlaySetupProblems(ctx.root, ctx.config, pkg.dir, pkg.name, json)) ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: problem });
1968
+ const age = overlayAgeDays(marker.since, now);
1969
+ if (age < -1) {
1970
+ ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: `${pkg.name} genesis.overlay.since: ${marker.since} is in the future; use the day the overlay was made` });
1971
+ } else if (age > OVERLAY_NOTICE_DAYS) {
1972
+ ctx.report({
1973
+ rule: "overlay-age",
1974
+ level: age > OVERLAY_WARN_DAYS ? "warn" : "info",
1975
+ file,
1976
+ subject: pkg.name,
1977
+ message: `the overlay of ${marker.upstream} is ${age} days old (since ${marker.since}, owner ${marker.owner}); promote its change to Genesis and adopt the release, or drop it (an overlay is reported after ${OVERLAY_NOTICE_DAYS} days, and after ${OVERLAY_WARN_DAYS} it warns, which fails --strict)`
1978
+ });
1979
+ }
1980
+ const upstream = overlayUpstream(marker).version;
1981
+ const version = typeof json.version === "string" ? json.version : "";
1982
+ if (LOCAL_VERSION.exec(version)?.[1] !== upstream) {
1983
+ ctx.report({
1984
+ rule: "overlay-version",
1985
+ level: "warn",
1986
+ file,
1987
+ subject: version || "(none)",
1988
+ message: `the overlay of ${marker.upstream} is version ${version || "(none)"}; use ${upstream}+local.N (or ${upstream} itself) so it reads as a local build of ${upstream} and still satisfies peer ranges`
1989
+ });
1990
+ }
1991
+ const pinned = pinnedVersion(ctx.root, pkg.name);
1992
+ const from = parseVersion(upstream);
1993
+ const to = pinned ? parseVersion(pinned) : null;
1994
+ if (from && to && compareVersions(from, to) < 0) {
1995
+ ctx.report({
1996
+ rule: "overlay-behind",
1997
+ level: "warn",
1998
+ file,
1999
+ subject: pkg.name,
2000
+ message: `the overlay of ${marker.upstream} is behind ${pkg.name}@${pinned}, the version the app now pins; run genesis upgrade, which rebases the overlay onto it (dropping what Genesis now ships) and moves the marker's upstream, or rebase it by hand`
2001
+ });
2002
+ }
2003
+ }
2004
+ }
2005
+
2006
+ // src/doctor/versions.ts
2007
+ var UMBRELLA_PACKAGE = "@marktiderman/genesis";
2008
+ function readReleaseManifest(root) {
2009
+ const dir = findPackageDir(root, UMBRELLA_PACKAGE);
2010
+ const file = dir && path21.join(dir, "dist", "versions.json");
2011
+ if (!file || !existsSync(file)) return null;
2012
+ return JSON.parse(readFileSync(file, "utf8"));
2013
+ }
2014
+ function checkVersionSkew(ctx) {
2015
+ const manifest = readReleaseManifest(ctx.root);
2016
+ if (!manifest) return;
2017
+ const overlays = markedOverlays(ctx);
2018
+ for (const [name, want] of Object.entries(manifest.packages)) {
2019
+ const overlay = overlays.get(name);
2020
+ if (overlay) {
2021
+ const from = overlay.marker.upstream.slice(overlay.marker.upstream.lastIndexOf("@") + 1);
2022
+ const behind = parseVersion(from) && parseVersion(want) && compareVersions(parseVersion(from), parseVersion(want)) < 0;
2023
+ if (from !== want && !behind) {
2024
+ ctx.report({
2025
+ rule: "version-skew",
2026
+ level: "warn",
2027
+ file: "package.json",
2028
+ subject: name,
2029
+ message: `the app's overlay of ${name} was copied from ${from}, but ${UMBRELLA_PACKAGE} ${manifest.version} was released with ${want}. Bring the overlay onto ${want} (or promote it and adopt the release).`
2030
+ });
2031
+ }
2032
+ continue;
2033
+ }
2034
+ const dir = findPackageDir(ctx.root, name);
2035
+ if (!dir) continue;
2036
+ const have = JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8")).version;
2037
+ if (have === want) continue;
2038
+ ctx.report({
2039
+ rule: "version-skew",
2040
+ level: "warn",
2041
+ file: "package.json",
2042
+ subject: name,
2043
+ message: `${name} is ${have}, but ${UMBRELLA_PACKAGE} ${manifest.version} was released with ${want}. Install ${name}@${want}, or move every Genesis package to one release.`
2044
+ });
2045
+ }
2046
+ }
2047
+ function buildCatalog(packagesDir) {
2048
+ const packages = {};
2049
+ for (const dir of readdirSync(packagesDir).sort()) {
2050
+ const file = path21.join(packagesDir, dir, "package.json");
2051
+ if (!existsSync(file)) continue;
2052
+ const pkg = JSON.parse(readFileSync(file, "utf8"));
2053
+ if (!pkg.name || !pkg.version || pkg.private || !pkg.name.startsWith("@marktiderman/genesis")) continue;
2054
+ packages[pkg.name] = { version: pkg.version, ...pkg.genesis?.blocks ? { blocks: pkg.genesis.blocks } : {} };
2055
+ }
2056
+ return { packages };
2057
+ }
2058
+
2059
+ // src/blocks/discover.ts
2060
+ var CLI_PACKAGE = "@marktiderman/genesis-cli";
2061
+ function cliPackageDir() {
2062
+ let dir = path21.dirname(fileURLToPath(import.meta.url));
2063
+ for (; ; ) {
2064
+ const file = path21.join(dir, "package.json");
2065
+ if (existsSync(file) && JSON.parse(readFileSync(file, "utf8")).name === CLI_PACKAGE) return dir;
2066
+ const parent = path21.dirname(dir);
2067
+ if (parent === dir) throw new Error("Can't find the genesis-cli package folder.");
2068
+ dir = parent;
2069
+ }
2070
+ }
2071
+ function workspacePackagesDir() {
2072
+ const dir = path21.resolve(cliPackageDir(), "..");
2073
+ return existsSync(path21.join(dir, "features", "package.json")) && existsSync(path21.join(dir, "..", "pnpm-workspace.yaml")) ? dir : null;
2074
+ }
2075
+ var catalogCache;
2076
+ function readCatalog() {
2077
+ if (catalogCache) return catalogCache;
2078
+ const workspace = workspacePackagesDir();
2079
+ if (workspace) return catalogCache = buildCatalog(workspace);
2080
+ const file = path21.join(cliPackageDir(), "dist", "genesis-catalog.json");
2081
+ catalogCache = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : { packages: {} };
2082
+ return catalogCache;
2083
+ }
2084
+ var INSTALL_ROOT_MARKERS = [".git", "pnpm-lock.yaml", "pnpm-workspace.yaml", "bun.lock", "bun.lockb", "yarn.lock", "package-lock.json"];
2085
+ function installedGenesis(root) {
2086
+ const found = /* @__PURE__ */ new Map();
2087
+ let dir = path21.resolve(root);
2088
+ for (; ; ) {
2089
+ const atInstallRoot = INSTALL_ROOT_MARKERS.some((m) => existsSync(path21.join(dir, m)));
2090
+ const scope = path21.join(dir, "node_modules", "@marktiderman");
2091
+ if (existsSync(scope)) {
2092
+ for (const entry of readdirSync(scope)) {
2093
+ const name = `@marktiderman/${entry}`;
2094
+ if (!GENESIS_PACKAGE.test(name) || found.has(name)) continue;
2095
+ if (existsSync(path21.join(scope, entry, "package.json"))) found.set(name, path21.join(scope, entry));
2096
+ }
2097
+ }
2098
+ const parent = path21.dirname(dir);
2099
+ if (atInstallRoot || parent === dir) return found;
2100
+ dir = parent;
2101
+ }
2102
+ }
2103
+ var declarationCache = /* @__PURE__ */ new Map();
2104
+ function declarationsOf(dir, warnings) {
2105
+ const pkg = JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8"));
2106
+ const key2 = `${realpathSync(dir)}@${pkg.version ?? ""}`;
2107
+ let cached = declarationCache.get(key2);
2108
+ if (!cached) {
2109
+ cached = loadDeclarations(dir, warnings);
2110
+ declarationCache.set(key2, cached);
2111
+ }
2112
+ return cached;
2113
+ }
2114
+ async function loadDeclarations(dir, warnings) {
2115
+ const pkg = JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8"));
2116
+ const entry = pkg.exports?.["./blocks"];
2117
+ const target = typeof entry === "string" ? entry : entry && typeof entry === "object" ? entry["import"] ?? entry["default"] : void 0;
2118
+ if (typeof target !== "string") return {};
2119
+ const rel = safeRelative(target.replace(/^\.\//, ""));
2120
+ const file = rel && path21.join(dir, ...rel.split("/"));
2121
+ if (!file || !inside(dir, file) || !existsSync(file)) return {};
2122
+ try {
2123
+ const jiti = createJiti(path21.join(dir, "package.json"), { moduleCache: false });
2124
+ const mod = await jiti.import(file);
2125
+ const out = {};
2126
+ for (const value of Object.values(mod)) if (isBlockDef(value)) out[value.id] = declarationFields(value);
2127
+ return out;
2128
+ } catch (err) {
2129
+ warnings.push(`${pkg.name}/blocks didn't load in Node (${err instanceof Error ? err.message.split("\n")[0] : String(err)}); using its package.json manifest only.`);
2130
+ return {};
2131
+ }
2132
+ }
2133
+ async function blocksOfInstalled(dir, warnings = [], options = {}) {
2134
+ const pkg = JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8"));
2135
+ const raw = rawBlocksOf(pkg);
2136
+ const declared = await declarationsOf(dir, warnings);
2137
+ const ids = /* @__PURE__ */ new Set([...Object.keys(raw), ...Object.keys(declared)]);
2138
+ const out = [];
2139
+ for (const id of [...ids].sort()) {
2140
+ const fromJson = raw[id] ?? {};
2141
+ const merged = { ...fromJson, ...declared[id] };
2142
+ if (declared[id]?.["migrations"] && Array.isArray(fromJson["migrations"])) merged["migrations"] = withProvides(declared[id]["migrations"], fromJson["migrations"]);
2143
+ const manifest = tryParse(() => parseManifest(pkg.name, id, merged, pkg.version, options), warnings);
2144
+ if (manifest) out.push(manifest);
2145
+ }
2146
+ return out;
2147
+ }
2148
+ function withProvides(declared, json) {
2149
+ if (!Array.isArray(declared)) return declared;
2150
+ const fileOf = (m) => m && typeof m === "object" ? m["file"] : void 0;
2151
+ return declared.map((m) => {
2152
+ const same = json.find((j) => fileOf(j) === fileOf(m));
2153
+ return same?.["provides"] !== void 0 && m && typeof m === "object" && !("provides" in m) ? { ...m, provides: same["provides"] } : m;
2154
+ });
2155
+ }
2156
+ async function allBlocks(root, warnings = []) {
2157
+ const out = [];
2158
+ for (const local of localPackages(root)) {
2159
+ for (const manifest of await blocksOfInstalled(local.dir, warnings, { local: true })) out.push({ manifest, from: "local" });
2160
+ }
2161
+ const installed = installedGenesis(root);
2162
+ for (const [, dir] of installed) for (const manifest of await blocksOfInstalled(dir, warnings)) out.push({ manifest, from: "installed" });
2163
+ for (const [name, entry] of Object.entries(readCatalog().packages)) {
2164
+ if (installed.has(name)) continue;
2165
+ for (const [id, raw] of Object.entries(entry.blocks ?? {})) {
2166
+ const manifest = tryParse(() => parseManifest(name, id, raw, entry.version), warnings);
2167
+ if (manifest) out.push({ manifest, from: "catalog" });
2168
+ }
2169
+ }
2170
+ return out;
2171
+ }
2172
+ function tryParse(parse2, warnings) {
2173
+ try {
2174
+ return parse2();
2175
+ } catch (err) {
2176
+ if (!(err instanceof ManifestError)) throw err;
2177
+ warnings.push(err.message);
2178
+ return null;
2179
+ }
2180
+ }
2181
+ function catalogBlocks(warnings = []) {
2182
+ const out = [];
2183
+ for (const [name, entry] of Object.entries(readCatalog().packages)) {
2184
+ for (const [id, raw] of Object.entries(entry.blocks ?? {})) {
2185
+ const manifest = tryParse(() => parseManifest(name, id, raw, entry.version), warnings);
2186
+ if (manifest) out.push(manifest);
2187
+ }
2188
+ }
2189
+ return out;
2190
+ }
2191
+ async function findBlock(root, id, options = {}) {
2192
+ const all = (await allBlocks(root, options.warnings)).filter((b) => b.manifest.id === id && (!options.package || b.manifest.package === options.package));
2193
+ if (all.length === 0) {
2194
+ const known = [...new Set((await allBlocks(root)).map((b) => b.manifest.id))].sort();
2195
+ throw new Error(`No Genesis or local package declares a block "${id}"${options.package ? ` in ${options.package}` : ""}. Known blocks: ${known.join(", ") || "none"}.`);
2196
+ }
2197
+ if (all.length > 1) throw new Error(`"${id}" is declared by ${all.map((b) => b.manifest.package).join(" and ")}; pass --package to pick one.`);
2198
+ return all[0];
2199
+ }
2200
+
2201
+ // src/blocks/pm.ts
2202
+ function findLockfile(root) {
2203
+ let dir = path21.resolve(root);
2204
+ for (; ; ) {
2205
+ if (existsSync(path21.join(dir, "pnpm-lock.yaml"))) return { pm: "pnpm", dir };
2206
+ if (existsSync(path21.join(dir, "bun.lock")) || existsSync(path21.join(dir, "bun.lockb"))) return { pm: "bun", dir };
2207
+ if (existsSync(path21.join(dir, "yarn.lock"))) return { pm: "yarn", dir };
2208
+ if (existsSync(path21.join(dir, "package-lock.json"))) return { pm: "npm", dir };
2209
+ const parent = path21.dirname(dir);
2210
+ if (parent === dir) return null;
2211
+ dir = parent;
2212
+ }
2213
+ }
2214
+ function detectPackageManager(root) {
2215
+ return findLockfile(root)?.pm ?? "npm";
2216
+ }
2217
+ function installCommand(pm) {
2218
+ return pm === "yarn" ? ["yarn", "install"] : [pm, "install"];
2219
+ }
2220
+ var shellLine = (argv) => argv.map((a) => /^[\w@./:^~=-]+$/.test(a) ? a : `'${a.replace(/'/g, "'\\''")}'`).join(" ");
2221
+
2222
+ // src/doctor/genesis.ts
2223
+ var DEFAULT_UI_PACKAGE = "@marktiderman/genesis-ui";
2224
+ var NATIVE_UI_PACKAGE = "@marktiderman/genesis-ui-native";
2225
+ var DESIGN_SYSTEM_PACKAGE = "@marktiderman/genesis-design-system";
2226
+ var DEFAULT_COMPONENT_PACKAGES = ["@marktiderman/genesis-forms-studio"];
2227
+ var TAGS = ["button", "input", "textarea", "select", "label", "table", "dialog", "progress", "details", "summary"];
2228
+ var TAG_ALIASES = { hr: "Separator" };
2229
+ var NON_COMPONENT_SUFFIX = /(Props|Variant|Variants|Type|Types|Config|Context|Options|Status)$/;
2230
+ var TAILWIND_PALETTE = [
2231
+ "black",
2232
+ "white",
2233
+ "slate",
2234
+ "gray",
2235
+ "zinc",
2236
+ "neutral",
2237
+ "stone",
2238
+ "red",
2239
+ "orange",
2240
+ "amber",
2241
+ "yellow",
2242
+ "lime",
2243
+ "green",
2244
+ "emerald",
2245
+ "teal",
2246
+ "cyan",
2247
+ "sky",
2248
+ "blue",
2249
+ "indigo",
2250
+ "violet",
2251
+ "purple",
2252
+ "fuchsia",
2253
+ "pink",
2254
+ "rose",
2255
+ "taupe",
2256
+ "mauve",
2257
+ "mist",
2258
+ "olive"
2259
+ ];
2260
+ function findPackageDir(from, name) {
2261
+ let dir = path21.resolve(from);
2262
+ for (; ; ) {
2263
+ const candidate = path21.join(dir, "node_modules", name);
2264
+ if (existsSync(path21.join(candidate, "package.json"))) return candidate;
2265
+ const parent = path21.dirname(dir);
2266
+ if (parent === dir) return null;
2267
+ dir = parent;
2268
+ }
2269
+ }
2270
+ function uiPackageFor(config) {
2271
+ return config.uiPackage ?? (config.packs?.includes("native") ? NATIVE_UI_PACKAGE : DEFAULT_UI_PACKAGE);
2272
+ }
2273
+ function loadGenesis(root, config) {
2274
+ const uiPackage = uiPackageFor(config);
2275
+ const pkg = readPackageExports(root, uiPackage);
2276
+ if (!pkg) throw new DoctorConfigError(notInstalled(root, uiPackage));
2277
+ const { dir: uiDir, exports: exportNames, values, components } = pkg;
2278
+ const tokens = /* @__PURE__ */ new Set();
2279
+ const themeFiles = resolveThemeFiles(root, config, uiDir);
2280
+ for (const file of themeFiles) for (const t of declaredTokens(readFileSync(file, "utf8"))) tokens.add(t);
2281
+ const byLower = new Map(components.map((c) => [c.toLowerCase(), c]));
2282
+ const rawTags = /* @__PURE__ */ new Map();
2283
+ for (const tag of TAGS) if (byLower.has(tag)) rawTags.set(tag, byLower.get(tag));
2284
+ for (const [tag, comp] of Object.entries(TAG_ALIASES)) if (values.has(comp)) rawTags.set(tag, comp);
2285
+ for (const [tag, comp] of Object.entries(config.rawTags ?? {})) {
2286
+ if (comp === false) rawTags.delete(tag);
2287
+ else rawTags.set(tag, comp);
2288
+ }
2289
+ return {
2290
+ uiPackage,
2291
+ uiVersion: pkg.version,
2292
+ exports: exportNames,
2293
+ values,
2294
+ components,
2295
+ tokens,
2296
+ rawTags,
2297
+ palette: loadPalette(root),
2298
+ companions: loadCompanions(root, config, uiPackage)
2299
+ };
2300
+ }
2301
+ function notInstalled(root, uiPackage) {
2302
+ let declared = false;
2303
+ try {
2304
+ const pkg = JSON.parse(readFileSync(path21.join(root, "package.json"), "utf8"));
2305
+ declared = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"].some((s) => pkg[s]?.[uiPackage] !== void 0);
2306
+ } catch {
2307
+ }
2308
+ if (!declared) return `${uiPackage} is not installed here and isn't in this app's package.json. Add it, or set doctor.uiPackage.`;
2309
+ return `${uiPackage} is in package.json but not installed, so this app's dependencies aren't installed. Run \`${shellLine(installCommand(detectPackageManager(root)))}\`, then run this again.`;
2310
+ }
2311
+ function loadCompanions(root, config, uiPackage) {
2312
+ const out = [];
2313
+ for (const name of config.componentPackages ?? DEFAULT_COMPONENT_PACKAGES) {
2314
+ if (name === uiPackage) continue;
2315
+ try {
2316
+ const pkg = readPackageExports(root, name);
2317
+ if (pkg) out.push({ package: name, version: pkg.version, components: pkg.components });
2318
+ } catch (err) {
2319
+ if (!(err instanceof DoctorConfigError)) throw err;
2320
+ }
2321
+ }
2322
+ return out;
2323
+ }
2324
+ function readPackageExports(root, uiPackage) {
2325
+ const uiDir = findPackageDir(root, uiPackage);
2326
+ if (!uiDir) return null;
2327
+ const uiPkg = JSON.parse(readFileSync(path21.join(uiDir, "package.json"), "utf8"));
2328
+ const subpaths = Object.values(uiPkg.exports ?? {});
2329
+ const declared = uiPkg.types ?? uiPkg.typings ?? exportTypes(uiPkg.exports?.["."] ?? uiPkg.exports);
2330
+ const fromSource = typeof declared !== "string" && !subpaths.some((t) => typeof exportTypes(t) === "string");
2331
+ const entryOf = fromSource ? exportSource : exportTypes;
2332
+ const typeEntries = /* @__PURE__ */ new Set();
2333
+ const mainTypes = fromSource ? exportSource(uiPkg.exports?.["."] ?? uiPkg.exports) ?? (isTsSource(uiPkg.main) ? uiPkg.main : void 0) : declared;
2334
+ if (typeof mainTypes === "string") typeEntries.add(mainTypes);
2335
+ for (const target of subpaths) {
2336
+ const t = entryOf(target);
2337
+ if (typeof t === "string" && !t.includes("*")) typeEntries.add(t);
2338
+ }
2339
+ const exportNames = /* @__PURE__ */ new Set();
2340
+ const reexportedPackages = /* @__PURE__ */ new Set();
2341
+ let readAny = false;
2342
+ const seen = /* @__PURE__ */ new Set();
2343
+ const readEntry = (file) => {
2344
+ if (seen.has(file) || !insidePackage(uiDir, file) || !existsSync(file)) return;
2345
+ seen.add(file);
2346
+ readAny = true;
2347
+ const code = fromSource ? stripComments(readFileSync(file, "utf8")) : readFileSync(file, "utf8");
2348
+ for (const name of fromSource ? parseSourceExportNames(code) : parseExportNames(code)) exportNames.add(name);
2349
+ for (const m of code.matchAll(/export\s+(?:type\s+)?(?:\{[^}]*\}|\*)\s*from\s*["']([^"'.][^"']*)["']/g)) {
2350
+ reexportedPackages.add(packageName(m[1]));
2351
+ }
2352
+ if (fromSource) {
2353
+ for (const m of code.matchAll(/export\s+\*\s+from\s*["'](\.[^"']*)["']/g)) {
2354
+ const next = resolveSource(path21.dirname(file), m[1]);
2355
+ if (next) readEntry(next);
2356
+ }
2357
+ }
2358
+ };
2359
+ for (const entry of typeEntries) readEntry(path21.join(uiDir, entry));
2360
+ if (!readAny) {
2361
+ const what = fromSource ? "type declarations or TypeScript source" : "type declarations";
2362
+ throw new DoctorConfigError(`${uiPackage} has no ${what} to read (is it built?). Looked for: ${[...typeEntries].join(", ") || "none"}`);
2363
+ }
2364
+ const valueDecls = /* @__PURE__ */ new Set();
2365
+ const typeDecls = /* @__PURE__ */ new Set();
2366
+ const declRoot = typeof mainTypes === "string" ? path21.dirname(path21.join(uiDir, mainTypes)) : uiDir;
2367
+ const declFiles = fromSource ? walkSource(declRoot) : walkDts(declRoot);
2368
+ for (const pkg of reexportedPackages) {
2369
+ const dir = findPackageDir(uiDir, pkg);
2370
+ if (dir) walkDts(path21.join(dir, "dist"), declFiles);
2371
+ }
2372
+ for (const file of declFiles) {
2373
+ const text = readFileSync(file, "utf8");
2374
+ for (const m of text.matchAll(/\b(?:declare\s+)?(?:const|let|var|function|class|enum)\s+([A-Za-z_$][\w$]*)/g)) valueDecls.add(m[1]);
2375
+ for (const m of text.matchAll(/\b(?:interface|type)\s+([A-Za-z_$][\w$]*)/g)) typeDecls.add(m[1]);
2376
+ }
2377
+ const isTypeOnly = (n) => typeDecls.has(n) && !valueDecls.has(n);
2378
+ const values = new Set([...exportNames].filter((n) => !isTypeOnly(n)));
2379
+ const components = [...values].filter((n) => /^[A-Z][A-Za-z0-9]*$/.test(n) && !(n.length > 2 && n === n.toUpperCase()) && !NON_COMPONENT_SUFFIX.test(n)).sort();
2380
+ return { dir: uiDir, version: String(uiPkg.version ?? "unknown"), exports: exportNames, values, components };
2381
+ }
2382
+ function parseExportNames(dts) {
2383
+ const names = [];
2384
+ for (const m of dts.matchAll(/export\s+(?:type\s+)?\{([^}]*)\}/g)) {
2385
+ for (const part of m[1].split(",")) {
2386
+ const name = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).pop()?.trim();
2387
+ if (name && name !== "default") names.push(name);
2388
+ }
2389
+ }
2390
+ for (const m of dts.matchAll(/export\s+(?:declare\s+)?(?:const|let|function|class|enum|interface|type)\s+([A-Za-z_$][\w$]*)/g)) {
2391
+ names.push(m[1]);
2392
+ }
2393
+ return names;
2394
+ }
2395
+ function declaredTokens(css) {
2396
+ return [...css.matchAll(/(--[A-Za-z0-9_-]+)\s*:/g)].map((m) => m[1]);
2397
+ }
2398
+ function packageName(specifier) {
2399
+ const parts = specifier.split("/");
2400
+ return parts.slice(0, specifier.startsWith("@") ? 2 : 1).join("/");
2401
+ }
2402
+ function parseSourceExportNames(code) {
2403
+ const names = parseExportNames(code);
2404
+ for (const m of code.matchAll(/export\s+(?:default\s+)?(?:declare\s+)?(?:abstract\s+)?(?:async\s+)?(?:var|class|function\*?)\s+([A-Za-z_$][\w$]*)/g)) names.push(m[1]);
2405
+ for (const m of code.matchAll(/export\s+\*\s+as\s+([A-Za-z_$][\w$]*)/g)) names.push(m[1]);
2406
+ return [...new Set(names)];
2407
+ }
2408
+ var TS_SOURCE = /\.(?:[cm]?tsx?)$/;
2409
+ var isTsSource = (v) => typeof v === "string" && TS_SOURCE.test(v) && !/\.d\.[cm]?ts$/.test(v);
2410
+ function exportSource(target) {
2411
+ if (isTsSource(target)) return target;
2412
+ if (!target || typeof target !== "object") return void 0;
2413
+ for (const value of Object.values(target)) {
2414
+ const nested = exportSource(value);
2415
+ if (nested) return nested;
2416
+ }
2417
+ return void 0;
2418
+ }
2419
+ function resolveSource(dir, spec) {
2420
+ const base = path21.resolve(dir, spec.replace(/\.js$/, ""));
2421
+ const candidates = [base, ...[".ts", ".tsx", ".mts", ".cts"].map((e) => base + e), ...["index.ts", "index.tsx"].map((i) => path21.join(base, i))];
2422
+ return candidates.find((f) => TS_SOURCE.test(f) && existsSync(f) && statSync(f).isFile()) ?? null;
2423
+ }
2424
+ function insidePackage(dir, file) {
2425
+ const rel = path21.relative(path21.resolve(dir), path21.resolve(file));
2426
+ return rel === "" || !rel.startsWith("..") && !path21.isAbsolute(rel);
2427
+ }
2428
+ function stripComments(code) {
2429
+ let out = "";
2430
+ let i = 0;
2431
+ while (i < code.length) {
2432
+ const c = code[i];
2433
+ const next = code[i + 1];
2434
+ if (c === "/" && next === "*") {
2435
+ const end = code.indexOf("*/", i + 2);
2436
+ const stop = end < 0 ? code.length : end + 2;
2437
+ out += code.slice(i, stop).replace(/[^\n]/g, " ");
2438
+ i = stop;
2439
+ } else if (c === "/" && next === "/") {
2440
+ const end = code.indexOf("\n", i);
2441
+ i = end < 0 ? code.length : end;
2442
+ } else if (c === '"' || c === "'" || c === "`") {
2443
+ let j = i + 1;
2444
+ while (j < code.length && code[j] !== c) {
2445
+ if (code[j] === "\\") j++;
2446
+ else if (c !== "`" && code[j] === "\n") break;
2447
+ j++;
2448
+ }
2449
+ out += code.slice(i, j + 1);
2450
+ i = j + 1;
2451
+ } else {
2452
+ out += c;
2453
+ i++;
2454
+ }
2455
+ }
2456
+ return out;
2457
+ }
2458
+ function walkSource(dir, out = []) {
2459
+ if (!existsSync(dir)) return out;
2460
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
2461
+ if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
2462
+ const p = path21.join(dir, entry.name);
2463
+ if (entry.isDirectory()) walkSource(p, out);
2464
+ else if (isTsSource(entry.name) || /\.d\.[cm]?ts$/.test(entry.name)) out.push(p);
2465
+ }
2466
+ return out;
2467
+ }
2468
+ function exportTypes(target) {
2469
+ if (!target || typeof target !== "object") return void 0;
2470
+ const t = target;
2471
+ if (typeof t.types === "string") return t.types;
2472
+ for (const key2 of ["import", "default", "require"]) {
2473
+ const nested = exportTypes(t[key2]);
2474
+ if (nested) return nested;
2475
+ }
2476
+ return void 0;
2477
+ }
2478
+ function walkDts(dir, out = []) {
2479
+ if (!existsSync(dir)) return out;
2480
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
2481
+ if (entry.name === "node_modules") continue;
2482
+ const p = path21.join(dir, entry.name);
2483
+ if (entry.isDirectory()) walkDts(p, out);
2484
+ else if (/\.d\.[cm]?ts$/.test(entry.name)) out.push(p);
2485
+ }
2486
+ return out;
2487
+ }
2488
+ function resolveThemeFiles(root, config, uiDir) {
2489
+ if (config.themeCss) {
2490
+ const specs = typeof config.themeCss === "string" ? [config.themeCss] : config.themeCss;
2491
+ return specs.map((spec) => {
2492
+ const file = resolveSpec(root, spec);
2493
+ if (!file) throw new DoctorConfigError(`doctor.themeCss: cannot find ${spec}`);
2494
+ return file;
2495
+ });
2496
+ }
2497
+ const files = [];
2498
+ const ds = findPackageDir(root, DESIGN_SYSTEM_PACKAGE);
2499
+ const themes = ds && path21.join(ds, "dist", "themes");
2500
+ if (themes && existsSync(themes)) {
2501
+ for (const name of readdirSync(themes).sort()) if (name.endsWith(".css")) files.push(path21.join(themes, name));
2502
+ }
2503
+ if (files.length === 0) {
2504
+ throw new DoctorConfigError(
2505
+ `No Genesis theme stylesheet found (${DESIGN_SYSTEM_PACKAGE}/dist/themes/*.css). Install the design system, or set doctor.themeCss.`
2506
+ );
2507
+ }
2508
+ const uiStyles = path21.join(uiDir, "dist", "styles.css");
2509
+ if (existsSync(uiStyles)) files.push(uiStyles);
2510
+ return files;
2511
+ }
2512
+ function resolveSpec(root, spec) {
2513
+ const local = path21.resolve(root, spec);
2514
+ if (spec.startsWith(".") || path21.isAbsolute(spec)) return existsSync(local) ? local : null;
2515
+ const parts = spec.split("/");
2516
+ const nameLength = spec.startsWith("@") ? 2 : 1;
2517
+ const dir = findPackageDir(root, parts.slice(0, nameLength).join("/"));
2518
+ if (dir) {
2519
+ const file = path21.join(dir, ...parts.slice(nameLength));
2520
+ if (existsSync(file) && statSync(file).isFile()) return file;
2521
+ }
2522
+ return existsSync(local) ? local : null;
2523
+ }
2524
+ function loadPalette(root) {
2525
+ const names = new Set(TAILWIND_PALETTE);
2526
+ try {
2527
+ const req = createRequire(path21.join(root, "package.json"));
2528
+ const colors = req("tailwindcss/colors");
2529
+ for (const key2 of Object.keys(colors?.default ?? colors ?? {})) {
2530
+ if (/^[a-z]+$/.test(key2) && !["inherit", "current", "transparent"].includes(key2)) names.add(key2);
2531
+ }
2532
+ } catch {
2533
+ }
2534
+ return [...names].sort();
2535
+ }
2536
+ function parseRulesMarkdown(markdown) {
2537
+ const rules = [];
2538
+ let current = null;
2539
+ for (const line of markdown.split("\n")) {
2540
+ const heading = line.match(/^###\s+([A-Za-z0-9_-]+)\s*$/);
2541
+ if (heading) {
2542
+ current = { id: heading[1] };
2543
+ rules.push(current);
2544
+ continue;
2545
+ }
2546
+ if (/^#{1,2}\s/.test(line)) {
2547
+ current = null;
2548
+ continue;
2549
+ }
2550
+ const kv = current && line.match(/^-\s+(level|files|exclude|forbid|require|path|message|newOnly):\s*(.*)$/);
2551
+ if (!current || !kv) continue;
2552
+ const [, key2, raw] = kv;
2553
+ const value = raw.trim();
2554
+ if (key2 === "files" || key2 === "exclude") current[key2] = value.split(",").map((s) => s.trim()).filter(Boolean);
2555
+ else if (key2 === "level") current.level = value;
2556
+ else if (key2 === "newOnly") current.newOnly = value === "true" ? true : value === "false" ? false : value;
2557
+ else current[key2] = value;
2558
+ }
2559
+ return rules;
2560
+ }
2561
+ function toRegExp(source, flags = "") {
2562
+ if (source.startsWith("(?i)")) return new RegExp(source.slice(4), flags + "i");
2563
+ return new RegExp(source, flags);
2564
+ }
2565
+ function compilePatternRules(rules, source) {
2566
+ const ids = /* @__PURE__ */ new Set();
2567
+ const out = [];
2568
+ for (const rule of rules) {
2569
+ if (ids.has(rule.id)) throw new DoctorConfigError(`${source}: rule "${rule.id}" is defined twice`);
2570
+ ids.add(rule.id);
2571
+ const level = rule.level ?? "error";
2572
+ if (!["error", "warn", "info", "guide"].includes(level)) {
2573
+ throw new DoctorConfigError(`${source}: rule "${rule.id}" has level "${level}" (use error, warn, info or guide)`);
2574
+ }
2575
+ if (rule.newOnly !== void 0 && typeof rule.newOnly !== "boolean") {
2576
+ throw new DoctorConfigError(`${source}: rule "${rule.id}" has newOnly "${String(rule.newOnly)}" (use true or false)`);
2577
+ }
2578
+ if (level === "guide") continue;
2579
+ if (!rule.files?.length) throw new DoctorConfigError(`${source}: rule "${rule.id}" needs "files" (or level: guide)`);
2580
+ if (!rule.forbid && !rule.require && !rule.path) {
2581
+ throw new DoctorConfigError(`${source}: rule "${rule.id}" needs forbid, require or path (or level: guide)`);
2582
+ }
2583
+ try {
2584
+ out.push({
2585
+ rule,
2586
+ level,
2587
+ includes: globMatcher(rule.files),
2588
+ excludes: globMatcher(rule.exclude),
2589
+ forbid: rule.forbid ? toRegExp(rule.forbid, "m") : void 0,
2590
+ require: rule.require ? toRegExp(rule.require, "m") : void 0,
2591
+ path: rule.path ? toRegExp(rule.path) : void 0
2592
+ });
2593
+ } catch (err) {
2594
+ throw new DoctorConfigError(`${source}: rule "${rule.id}" has an invalid pattern: ${err.message}`);
2595
+ }
2596
+ }
2597
+ return out;
2598
+ }
2599
+ function loadPatternRules(root, patterns, rulesDoc) {
2600
+ const compiled = compilePatternRules(patterns ?? [], "doctor.patterns");
2601
+ let all = compiled;
2602
+ if (rulesDoc) {
2603
+ const file = path21.resolve(root, rulesDoc);
2604
+ if (!existsSync(file)) throw new DoctorConfigError(`doctor.rulesDoc: ${rulesDoc} not found`);
2605
+ const fromDoc = compilePatternRules(parseRulesMarkdown(readFileSync(file, "utf8")), rulesDoc);
2606
+ const clash = fromDoc.find((d) => compiled.some((c) => c.rule.id === d.rule.id));
2607
+ if (clash) throw new DoctorConfigError(`rule "${clash.rule.id}" is defined in both doctor.patterns and ${rulesDoc}`);
2608
+ all = [...compiled, ...fromDoc];
2609
+ }
2610
+ if (all.length === 0) return null;
2611
+ return {
2612
+ count: all.length,
2613
+ ids: all.map((r) => r.rule.id),
2614
+ newOnly: all.filter((r) => r.rule.newOnly).map((r) => r.rule.id),
2615
+ plugin: {
2616
+ name: "patterns",
2617
+ check(ctx) {
2618
+ for (const r of all) {
2619
+ const message = r.rule.message ?? "breaks a design rule";
2620
+ for (const file of ctx.files) {
2621
+ if (!r.includes(file.path) || r.excludes(file.path)) continue;
2622
+ const report = (line) => ctx.report({ rule: r.rule.id, level: r.level, file: file.path, line, message });
2623
+ if (r.path && !r.path.test(file.path)) report(0);
2624
+ if (r.require && !r.require.test(file.code)) report(0);
2625
+ if (r.forbid) {
2626
+ const m = r.forbid.exec(file.code);
2627
+ if (m) report(lineAt(file.code, m.index));
2628
+ }
2629
+ }
2630
+ }
2631
+ }
2632
+ }
2633
+ };
2634
+ }
2635
+ async function loadPlugins(specs, configDir) {
2636
+ const plugins = [];
2637
+ for (const spec of specs ?? []) {
2638
+ const [id, options] = typeof spec === "string" ? [spec, void 0] : spec;
2639
+ const file = resolvePlugin(id, configDir);
2640
+ const url = `${pathToFileURL(file).href}?mtime=${statSync(file).mtimeMs}`;
2641
+ let mod;
2642
+ try {
2643
+ mod = await import(url);
2644
+ } catch (err) {
2645
+ throw new DoctorConfigError(`doctor.plugins: could not load ${id}: ${err.message}`);
2358
2646
  }
2359
- for (const section2 of ["dependencies", "devDependencies", "optionalDependencies"]) {
2360
- const spec = json[section2]?.[name];
2361
- const v = typeof spec === "string" ? /^[\^~=]?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)$/.exec(spec)?.[1] : void 0;
2362
- const parsed = v && parseVersion(v);
2363
- if (parsed && (!best || compareVersions(parsed, parseVersion(best)) > 0)) best = v;
2647
+ let value = mod.default;
2648
+ if (typeof value === "function") value = await value(options);
2649
+ const list = Array.isArray(value) ? value : [value];
2650
+ for (const p of list) {
2651
+ if (!p || typeof p !== "object" || typeof p.check !== "function" || typeof p.name !== "string") {
2652
+ throw new DoctorConfigError(`doctor.plugins: ${id} must default-export { name, check(context) } (or an array, or a factory returning one)`);
2653
+ }
2654
+ plugins.push(p);
2364
2655
  }
2365
2656
  }
2366
- return best;
2657
+ return plugins;
2367
2658
  }
2368
- function checkOverlays(ctx, now = /* @__PURE__ */ new Date()) {
2369
- let packages;
2659
+ function resolvePlugin(id, configDir) {
2370
2660
  try {
2371
- packages = localPackages(ctx.root);
2661
+ if (id.startsWith(".") || path21.isAbsolute(id)) return resolveFrom(path21.resolve(configDir, id), configDir);
2662
+ return resolveFrom(id, configDir);
2372
2663
  } catch {
2373
- return;
2374
- }
2375
- for (const pkg of packages) {
2376
- if (!GENESIS_PACKAGE_NAME.test(pkg.name)) continue;
2377
- const file = `${pkg.rel}/package.json`;
2378
- let json;
2379
- try {
2380
- json = JSON.parse(readFileSync(path20.join(pkg.dir, "package.json"), "utf8"));
2381
- } catch {
2382
- continue;
2383
- }
2384
- const state = overlayState(pkg.name, json);
2385
- if (state.kind === "none") {
2386
- ctx.report({
2387
- rule: "overlay-unmarked",
2388
- file,
2389
- subject: pkg.name,
2390
- message: `${pkg.name} is a local package with a Genesis package's name, so it shadows the published one, but it carries no overlay marker; add "genesis": { "overlay": { "upstream": "${pkg.name}@<version copied>", "since": "YYYY-MM-DD", "owner": "\u2026", "reason": "\u2026" } }, or rename it`
2391
- });
2392
- continue;
2393
- }
2394
- if (state.kind === "invalid") {
2395
- for (const problem of state.problems) ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: problem });
2396
- continue;
2397
- }
2398
- const { marker } = state;
2399
- for (const problem of overlaySetupProblems(ctx.root, ctx.config, pkg.dir, pkg.name, json)) ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: problem });
2400
- const age = overlayAgeDays(marker.since, now);
2401
- if (age < -1) {
2402
- ctx.report({ rule: "overlay-invalid", file, subject: pkg.name, message: `${pkg.name} genesis.overlay.since: ${marker.since} is in the future; use the day the overlay was made` });
2403
- } else if (age > OVERLAY_NOTICE_DAYS) {
2404
- ctx.report({
2405
- rule: "overlay-age",
2406
- level: age > OVERLAY_WARN_DAYS ? "warn" : "info",
2407
- file,
2408
- subject: pkg.name,
2409
- message: `the overlay of ${marker.upstream} is ${age} days old (since ${marker.since}, owner ${marker.owner}); promote its change to Genesis and adopt the release, or drop it (an overlay is reported after ${OVERLAY_NOTICE_DAYS} days, and after ${OVERLAY_WARN_DAYS} it warns, which fails --strict)`
2410
- });
2411
- }
2412
- const upstream = overlayUpstream(marker).version;
2413
- const version = typeof json.version === "string" ? json.version : "";
2414
- if (LOCAL_VERSION.exec(version)?.[1] !== upstream) {
2415
- ctx.report({
2416
- rule: "overlay-version",
2417
- level: "warn",
2418
- file,
2419
- subject: version || "(none)",
2420
- message: `the overlay of ${marker.upstream} is version ${version || "(none)"}; use ${upstream}+local.N (or ${upstream} itself) so it reads as a local build of ${upstream} and still satisfies peer ranges`
2421
- });
2422
- }
2423
- const pinned = pinnedVersion(ctx.root, pkg.name);
2424
- const from = parseVersion(upstream);
2425
- const to = pinned ? parseVersion(pinned) : null;
2426
- if (from && to && compareVersions(from, to) < 0) {
2427
- ctx.report({
2428
- rule: "overlay-behind",
2429
- level: "warn",
2430
- file,
2431
- subject: pkg.name,
2432
- message: `the overlay of ${marker.upstream} is behind ${pkg.name}@${pinned}, the version the app now pins; run genesis upgrade, which rebases the overlay onto it (dropping what Genesis now ships) and moves the marker's upstream, or rebase it by hand`
2433
- });
2434
- }
2664
+ throw new DoctorConfigError(`doctor.plugins: cannot find ${id} (relative paths resolve from ${configDir})`);
2435
2665
  }
2436
2666
  }
2437
-
2438
- // src/doctor/rules.ts
2667
+ function resolveFrom(id, from) {
2668
+ return createRequire(path21.join(from, "noop.js")).resolve(id);
2669
+ }
2439
2670
  var BUILTIN_RULES = [
2440
2671
  "local-primitives",
2672
+ // figma (figma/routes.ts; runs when genesis.config.json has a figma block)
2673
+ "figma-routes",
2441
2674
  "starter-leftover",
2442
2675
  "forbidden-import",
2443
2676
  "raw-tag",
@@ -2530,7 +2763,7 @@ function importSpecifiers(file) {
2530
2763
  }
2531
2764
  function checkProjectLayout(ctx) {
2532
2765
  for (const dir of ctx.config.localPrimitiveDirs ?? DEFAULT_LOCAL_PRIMITIVE_DIRS) {
2533
- if (existsSync(path20.join(ctx.root, dir))) {
2766
+ if (existsSync(path21.join(ctx.root, dir))) {
2534
2767
  ctx.report({
2535
2768
  rule: "local-primitives",
2536
2769
  file: dir,
@@ -2540,7 +2773,7 @@ function checkProjectLayout(ctx) {
2540
2773
  }
2541
2774
  }
2542
2775
  for (const file of STARTER_LEFTOVERS) {
2543
- if (existsSync(path20.join(ctx.root, file))) {
2776
+ if (existsSync(path21.join(ctx.root, file))) {
2544
2777
  ctx.report({
2545
2778
  rule: "starter-leftover",
2546
2779
  level: "warn",
@@ -2630,7 +2863,7 @@ function checkTokens(ctx) {
2630
2863
  }
2631
2864
  for (const pattern of ctx.config.tokenFiles ?? []) {
2632
2865
  if (/[*?]/.test(pattern)) continue;
2633
- const abs = path20.join(ctx.root, pattern);
2866
+ const abs = path21.join(ctx.root, pattern);
2634
2867
  if (!ctx.files.some((f) => f.absolutePath === abs) && existsSync(abs)) {
2635
2868
  for (const t of declaredTokens(readFileSync(abs, "utf8"))) defined.add(t);
2636
2869
  }
@@ -2654,7 +2887,7 @@ function checkShadowedExports(ctx) {
2654
2887
  file.code.split("\n").forEach((text, i) => {
2655
2888
  for (const m of text.matchAll(re)) {
2656
2889
  if (!ctx.genesis.values.has(m[1])) continue;
2657
- ctx.report({ rule: "shadowed-export", file: file.path, line: i + 1, subject: m[1], message: `shadows the Genesis export '${m[1]}'; reuse or extend Genesis ${m[1]}` });
2890
+ ctx.report({ rule: "shadowed-export", file: file.path, line: i + 1, subject: m[1], message: `shadows the Genesis export '${m[1]}'; reuse or extend ${m[1]} from ${ctx.genesis.uiPackage} (or rename yours if it's a different thing)` });
2658
2891
  }
2659
2892
  });
2660
2893
  }
@@ -2753,10 +2986,10 @@ var SCRIPT_EXTS2 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mts"
2753
2986
  var JSX_EXTS2 = /* @__PURE__ */ new Set([".tsx", ".jsx"]);
2754
2987
  var RESOLVE_EXTS = [".tsx", ".ts", ".jsx", ".js"];
2755
2988
  function resolveLocal(root, fromFile, spec) {
2756
- const bases = spec.startsWith(".") ? [path20.resolve(path20.dirname(fromFile), spec)] : [path20.join(root, spec.slice(2)), path20.join(root, "src", spec.slice(2))];
2989
+ const bases = spec.startsWith(".") ? [path21.resolve(path21.dirname(fromFile), spec)] : [path21.join(root, spec.slice(2)), path21.join(root, "src", spec.slice(2))];
2757
2990
  for (const base of bases) {
2758
- const hit = [base, ...RESOLVE_EXTS.map((e) => base + e), ...RESOLVE_EXTS.map((e) => path20.join(base, `index${e}`))].find(
2759
- (p) => SCRIPT_EXTS2.has(path20.extname(p)) && existsSync(p)
2991
+ const hit = [base, ...RESOLVE_EXTS.map((e) => base + e), ...RESOLVE_EXTS.map((e) => path21.join(base, `index${e}`))].find(
2992
+ (p) => SCRIPT_EXTS2.has(path21.extname(p)) && existsSync(p)
2760
2993
  );
2761
2994
  if (hit) return hit;
2762
2995
  }
@@ -2877,13 +3110,13 @@ function checkNativePack(ctx) {
2877
3110
  }
2878
3111
  function checkEasPlaceholders(ctx) {
2879
3112
  const files = [];
2880
- if (existsSync(path20.join(ctx.root, "eas.json"))) files.push("eas.json");
2881
- const workflows = path20.join(ctx.root, ".eas", "workflows");
3113
+ if (existsSync(path21.join(ctx.root, "eas.json"))) files.push("eas.json");
3114
+ const workflows = path21.join(ctx.root, ".eas", "workflows");
2882
3115
  if (existsSync(workflows)) {
2883
3116
  for (const name of readdirSync(workflows).sort()) if (/\.ya?ml$/.test(name)) files.push(`.eas/workflows/${name}`);
2884
3117
  }
2885
3118
  for (const file of files) {
2886
- for (const hit of findPlaceholders(file, readFileSync(path20.join(ctx.root, file), "utf8"))) {
3119
+ for (const hit of findPlaceholders(file, readFileSync(path21.join(ctx.root, file), "utf8"))) {
2887
3120
  const key2 = placeholderKey(hit.text, hit.placeholder);
2888
3121
  const what = EAS_PLACEHOLDERS[hit.placeholder];
2889
3122
  ctx.report({
@@ -2962,7 +3195,7 @@ function checkCustomHeaders(ctx, pkg) {
2962
3195
  if (!JSX_EXTS3.has(file.ext)) continue;
2963
3196
  const code = file.code;
2964
3197
  const hidden = HIDES_HEADER.exec(code);
2965
- if (hidden && /(?:^|\/)_layout\.[jt]sx$/.test(file.path)) hidingLayouts.set(path20.posix.dirname(file.path), file.path);
3198
+ if (hidden && /(?:^|\/)_layout\.[jt]sx$/.test(file.path)) hidingLayouts.set(path21.posix.dirname(file.path), file.path);
2966
3199
  const own = hidden ? ownHeader(code, pkg) : null;
2967
3200
  if (hidden && own) {
2968
3201
  reported.add(file.path);
@@ -2990,7 +3223,7 @@ function checkCustomHeaders(ctx, pkg) {
2990
3223
  }
2991
3224
  for (const file of ctx.files) {
2992
3225
  if (!JSX_EXTS3.has(file.ext) || reported.has(file.path) || !file.path.startsWith(`${rootDir}/`) || NON_SCREEN_ROUTE.test(file.path)) continue;
2993
- const layout = hidingLayouts.get(path20.posix.dirname(file.path));
3226
+ const layout = hidingLayouts.get(path21.posix.dirname(file.path));
2994
3227
  const own = layout ? ownHeader(file.code, pkg) : null;
2995
3228
  if (!layout || !own) continue;
2996
3229
  ctx.report({
@@ -3012,13 +3245,13 @@ function isLoadingOnlyRoute(code) {
3012
3245
  }
3013
3246
  function routerRoot(ctx) {
3014
3247
  if (ctx.config.native?.routerRoot) return ctx.config.native.routerRoot.replace(/\/+$/, "");
3015
- return existsSync(path20.join(ctx.root, "src", "app")) ? "src/app" : "app";
3248
+ return existsSync(path21.join(ctx.root, "src", "app")) ? "src/app" : "app";
3016
3249
  }
3017
3250
  function checkScreenLayouts(ctx, pkg) {
3018
3251
  const layouts = nativeLayouts(pkg);
3019
3252
  if (layouts.length === 0) return;
3020
3253
  const rootDir = routerRoot(ctx);
3021
- if (!existsSync(path20.join(ctx.root, rootDir))) {
3254
+ if (!existsSync(path21.join(ctx.root, rootDir))) {
3022
3255
  ctx.report({ rule: "native-screen-layout", level: "warn", file: rootDir, message: `no Expo Router root at ${rootDir}; set doctor.native.routerRoot` });
3023
3256
  return;
3024
3257
  }
@@ -3074,7 +3307,7 @@ var GENESIS_PLUGIN_IMPORT = /\bfrom\s*["']@marktiderman\/genesis-cli[^"']*["']|\
3074
3307
  function readExpoConfigs(root) {
3075
3308
  const out = [];
3076
3309
  for (const name of EXPO_CONFIGS) {
3077
- const abs = path20.join(root, name);
3310
+ const abs = path21.join(root, name);
3078
3311
  if (!existsSync(abs)) continue;
3079
3312
  const text = readFileSync(abs, "utf8");
3080
3313
  let json = null;
@@ -3108,13 +3341,13 @@ function pluginOptions(json, module) {
3108
3341
  return null;
3109
3342
  }
3110
3343
  function dependencies(root) {
3111
- const file = path20.join(root, "package.json");
3344
+ const file = path21.join(root, "package.json");
3112
3345
  if (!existsSync(file)) return /* @__PURE__ */ new Set();
3113
3346
  const pkg = JSON.parse(readFileSync(file, "utf8"));
3114
3347
  return /* @__PURE__ */ new Set([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
3115
3348
  }
3116
3349
  function runtimeDependencies(root) {
3117
- const file = path20.join(root, "package.json");
3350
+ const file = path21.join(root, "package.json");
3118
3351
  if (!existsSync(file)) return {};
3119
3352
  return JSON.parse(readFileSync(file, "utf8")).dependencies ?? {};
3120
3353
  }
@@ -3368,14 +3601,14 @@ function readTsconfig(root, file, seen = /* @__PURE__ */ new Set()) {
3368
3601
  seen.add(file);
3369
3602
  const json = readJsonc(file);
3370
3603
  if (!json) return {};
3371
- const dir = path20.dirname(file);
3604
+ const dir = path21.dirname(file);
3372
3605
  let merged = {};
3373
3606
  const parents = typeof json.extends === "string" ? [json.extends] : Array.isArray(json.extends) ? json.extends : [];
3374
3607
  for (const ext of parents) {
3375
3608
  if (typeof ext !== "string") continue;
3376
3609
  let target = null;
3377
- if (ext.startsWith(".") || path20.isAbsolute(ext)) {
3378
- const abs = path20.resolve(dir, ext);
3610
+ if (ext.startsWith(".") || path21.isAbsolute(ext)) {
3611
+ const abs = path21.resolve(dir, ext);
3379
3612
  target = existsSync(abs) && statSync(abs).isFile() ? abs : existsSync(`${abs}.json`) ? `${abs}.json` : null;
3380
3613
  } else {
3381
3614
  const parts = ext.split("/");
@@ -3383,14 +3616,14 @@ function readTsconfig(root, file, seen = /* @__PURE__ */ new Set()) {
3383
3616
  const pkgDir = findPackageDir(root, parts.slice(0, nameLength).join("/"));
3384
3617
  if (pkgDir) {
3385
3618
  const sub = parts.slice(nameLength).join("/");
3386
- const abs = path20.join(pkgDir, sub || "tsconfig.json");
3619
+ const abs = path21.join(pkgDir, sub || "tsconfig.json");
3387
3620
  target = existsSync(abs) && statSync(abs).isFile() ? abs : existsSync(`${abs}.json`) ? `${abs}.json` : null;
3388
3621
  }
3389
3622
  }
3390
3623
  if (target) merged = { ...merged, ...readTsconfig(root, target, seen) };
3391
3624
  }
3392
3625
  const opts = json.compilerOptions ?? {};
3393
- if (typeof opts.baseUrl === "string") merged.baseUrl = path20.resolve(dir, opts.baseUrl);
3626
+ if (typeof opts.baseUrl === "string") merged.baseUrl = path21.resolve(dir, opts.baseUrl);
3394
3627
  if (opts.paths && typeof opts.paths === "object") {
3395
3628
  merged.paths = opts.paths;
3396
3629
  merged.pathsDir = dir;
@@ -3401,7 +3634,7 @@ function aliases(root) {
3401
3634
  const table = [];
3402
3635
  let baseUrl = null;
3403
3636
  for (const name of ["tsconfig.json", "tsconfig.app.json", "jsconfig.json"]) {
3404
- const file = path20.join(root, name);
3637
+ const file = path21.join(root, name);
3405
3638
  if (!existsSync(file)) continue;
3406
3639
  const config = readTsconfig(root, file);
3407
3640
  baseUrl ??= config.baseUrl ?? null;
@@ -3409,22 +3642,22 @@ function aliases(root) {
3409
3642
  for (const [pattern, targets] of Object.entries(config.paths ?? {})) {
3410
3643
  if (!Array.isArray(targets)) continue;
3411
3644
  const exact = !pattern.endsWith("*");
3412
- table.push({ prefix: pattern.replace(/\*$/, ""), exact, targets: targets.map((t) => path20.join(base, String(t).replace(/\*$/, ""))) });
3645
+ table.push({ prefix: pattern.replace(/\*$/, ""), exact, targets: targets.map((t) => path21.join(base, String(t).replace(/\*$/, ""))) });
3413
3646
  }
3414
3647
  }
3415
- const pkg = readJsonc(path20.join(root, "package.json"));
3648
+ const pkg = readJsonc(path21.join(root, "package.json"));
3416
3649
  for (const [pattern, target] of Object.entries(pkg?.imports ?? {})) {
3417
3650
  if (typeof target !== "string") continue;
3418
- table.push({ prefix: pattern.replace(/\*.*$/, ""), exact: !pattern.includes("*"), targets: [path20.join(root, target.replace(/\*.*$/, ""))] });
3651
+ table.push({ prefix: pattern.replace(/\*.*$/, ""), exact: !pattern.includes("*"), targets: [path21.join(root, target.replace(/\*.*$/, ""))] });
3419
3652
  }
3420
- for (const prefix of ["@/", "~/", "#/"]) table.push({ prefix, exact: false, targets: [path20.join(root, "src") + path20.sep, root + path20.sep] });
3653
+ for (const prefix of ["@/", "~/", "#/"]) table.push({ prefix, exact: false, targets: [path21.join(root, "src") + path21.sep, root + path21.sep] });
3421
3654
  return { table, baseUrl };
3422
3655
  }
3423
3656
  function resolveFile(base) {
3424
- const tries = [base, ...RESOLVE_EXTS2.map((e) => base + e), ...RESOLVE_EXTS2.map((e) => path20.join(base, `index${e}`))];
3657
+ const tries = [base, ...RESOLVE_EXTS2.map((e) => base + e), ...RESOLVE_EXTS2.map((e) => path21.join(base, `index${e}`))];
3425
3658
  if (/\.[mc]?js$/.test(base)) tries.push(...[".ts", ".tsx"].map((e) => base.replace(/\.[mc]?js$/, e)));
3426
3659
  for (const p of tries) {
3427
- if (SCRIPT_EXTS2.has(path20.extname(p)) && existsSync(p) && statSync(p).isFile()) return p;
3660
+ if (SCRIPT_EXTS2.has(path21.extname(p)) && existsSync(p) && statSync(p).isFile()) return p;
3428
3661
  }
3429
3662
  return null;
3430
3663
  }
@@ -3438,7 +3671,7 @@ function createTrail(ctx) {
3438
3671
  const { table, baseUrl } = aliases(ctx.root);
3439
3672
  let declared = null;
3440
3673
  try {
3441
- const pkg = JSON.parse(readFileSync(path20.join(ctx.root, "package.json"), "utf8"));
3674
+ const pkg = JSON.parse(readFileSync(path21.join(ctx.root, "package.json"), "utf8"));
3442
3675
  declared = new Set(["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"].flatMap((k) => Object.keys(pkg[k] ?? {})));
3443
3676
  } catch {
3444
3677
  declared = null;
@@ -3469,17 +3702,17 @@ function createTrail(ctx) {
3469
3702
  if (/^(?:node:|https?:|data:|virtual:)/.test(spec) || /\.(?:css|scss|sass|less|svg|png|jpe?g|gif|webp|json|md|mdx)(?:\?.*)?$/.test(spec)) continue;
3470
3703
  let resolved = null;
3471
3704
  if (spec.startsWith(".")) {
3472
- resolved = resolveFile(path20.resolve(path20.dirname(file.absolutePath), spec));
3705
+ resolved = resolveFile(path21.resolve(path21.dirname(file.absolutePath), spec));
3473
3706
  if (!resolved) lost = true;
3474
3707
  } else {
3475
3708
  const alias = table.find((a) => a.exact ? spec === a.prefix : spec.startsWith(a.prefix));
3476
3709
  if (alias) {
3477
3710
  for (const t of alias.targets) {
3478
- resolved = resolveFile(alias.exact ? t : path20.join(t, spec.slice(alias.prefix.length)));
3711
+ resolved = resolveFile(alias.exact ? t : path21.join(t, spec.slice(alias.prefix.length)));
3479
3712
  if (resolved) break;
3480
3713
  }
3481
3714
  }
3482
- if (!resolved && baseUrl && !spec.startsWith("#")) resolved = resolveFile(path20.join(baseUrl, spec));
3715
+ if (!resolved && baseUrl && !spec.startsWith("#")) resolved = resolveFile(path21.join(baseUrl, spec));
3483
3716
  if (!resolved) {
3484
3717
  const pkg = spec.split("/").slice(0, spec.startsWith("@") ? 2 : 1).join("/");
3485
3718
  if (spec.startsWith("#") || declared && !declared.has(pkg) && !findPackageDir(ctx.root, pkg)) lost = true;
@@ -3491,217 +3724,64 @@ function createTrail(ctx) {
3491
3724
  importsCache.set(file.absolutePath, out);
3492
3725
  return out;
3493
3726
  };
3494
- const strippedCache = /* @__PURE__ */ new Map();
3495
- const stripped = (file) => {
3496
- if (!strippedCache.has(file.absolutePath)) strippedCache.set(file.absolutePath, stripForImports(file.code));
3497
- return strippedCache.get(file.absolutePath);
3498
- };
3499
- const memo = /* @__PURE__ */ new WeakMap();
3500
- const reach = (file, test2, depth, seen) => {
3501
- let cache2 = memo.get(test2);
3502
- if (!cache2) memo.set(test2, cache2 = { free: /* @__PURE__ */ new Map(), cut: /* @__PURE__ */ new Map() });
3503
- const k = `${file.absolutePath}\0${depth}`;
3504
- const free = cache2.free.get(k);
3505
- if (free) return [free, /* @__PURE__ */ new Set()];
3506
- const reusable = cache2.cut.get(k)?.find((e) => e.cut.every((m) => seen.has(m)));
3507
- if (reusable) return [reusable.result, new Set(reusable.cut)];
3508
- let result;
3509
- const cut = /* @__PURE__ */ new Set();
3510
- const code = stripped(file);
3511
- if (code === null) result = "unknown";
3512
- else if (test2(code)) result = "yes";
3513
- else {
3514
- const { files, lost } = importsOf(file);
3515
- let unknown = lost && depth > 0;
3516
- result = "no";
3517
- if (depth > 0) {
3518
- seen.add(file.absolutePath);
3519
- for (const abs of files) {
3520
- if (seen.has(abs)) {
3521
- cut.add(abs);
3522
- continue;
3523
- }
3524
- const target = read2(abs);
3525
- if (!target) {
3526
- unknown = true;
3527
- continue;
3528
- }
3529
- const [r, c] = reach(target, test2, depth - 1, seen);
3530
- for (const m of c) cut.add(m);
3531
- if (r === "yes") {
3532
- result = "yes";
3533
- break;
3534
- }
3535
- if (r === "unknown") unknown = true;
3536
- }
3537
- seen.delete(file.absolutePath);
3538
- cut.delete(file.absolutePath);
3539
- }
3540
- if (result === "no" && unknown) result = "unknown";
3541
- }
3542
- if (result === "yes" || cut.size === 0) {
3543
- cache2.free.set(k, result);
3544
- return [result, /* @__PURE__ */ new Set()];
3545
- }
3546
- const entries = cache2.cut.get(k) ?? [];
3547
- entries.push({ cut: [...cut], result });
3548
- cache2.cut.set(k, entries);
3549
- return [result, cut];
3550
- };
3551
- return { reach: (file, test2, depth = TRAIL_DEPTH) => reach(file, test2, depth, /* @__PURE__ */ new Set())[0] };
3552
- }
3553
- function buildCatalog(packagesDir) {
3554
- const packages = {};
3555
- for (const dir of readdirSync(packagesDir).sort()) {
3556
- const file = path20.join(packagesDir, dir, "package.json");
3557
- if (!existsSync(file)) continue;
3558
- const pkg = JSON.parse(readFileSync(file, "utf8"));
3559
- if (!pkg.name || !pkg.version || pkg.private || !pkg.name.startsWith("@marktiderman/genesis")) continue;
3560
- packages[pkg.name] = { version: pkg.version, ...pkg.genesis?.blocks ? { blocks: pkg.genesis.blocks } : {} };
3561
- }
3562
- return { packages };
3563
- }
3564
-
3565
- // src/blocks/discover.ts
3566
- var CLI_PACKAGE = "@marktiderman/genesis-cli";
3567
- function cliPackageDir() {
3568
- let dir = path20.dirname(fileURLToPath(import.meta.url));
3569
- for (; ; ) {
3570
- const file = path20.join(dir, "package.json");
3571
- if (existsSync(file) && JSON.parse(readFileSync(file, "utf8")).name === CLI_PACKAGE) return dir;
3572
- const parent = path20.dirname(dir);
3573
- if (parent === dir) throw new Error("Can't find the genesis-cli package folder.");
3574
- dir = parent;
3575
- }
3576
- }
3577
- function workspacePackagesDir() {
3578
- const dir = path20.resolve(cliPackageDir(), "..");
3579
- return existsSync(path20.join(dir, "features", "package.json")) && existsSync(path20.join(dir, "..", "pnpm-workspace.yaml")) ? dir : null;
3580
- }
3581
- var catalogCache;
3582
- function readCatalog() {
3583
- if (catalogCache) return catalogCache;
3584
- const workspace = workspacePackagesDir();
3585
- if (workspace) return catalogCache = buildCatalog(workspace);
3586
- const file = path20.join(cliPackageDir(), "dist", "genesis-catalog.json");
3587
- catalogCache = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : { packages: {} };
3588
- return catalogCache;
3589
- }
3590
- var INSTALL_ROOT_MARKERS = [".git", "pnpm-lock.yaml", "pnpm-workspace.yaml", "bun.lock", "bun.lockb", "yarn.lock", "package-lock.json"];
3591
- function installedGenesis(root) {
3592
- const found = /* @__PURE__ */ new Map();
3593
- let dir = path20.resolve(root);
3594
- for (; ; ) {
3595
- const atInstallRoot = INSTALL_ROOT_MARKERS.some((m) => existsSync(path20.join(dir, m)));
3596
- const scope = path20.join(dir, "node_modules", "@marktiderman");
3597
- if (existsSync(scope)) {
3598
- for (const entry of readdirSync(scope)) {
3599
- const name = `@marktiderman/${entry}`;
3600
- if (!GENESIS_PACKAGE.test(name) || found.has(name)) continue;
3601
- if (existsSync(path20.join(scope, entry, "package.json"))) found.set(name, path20.join(scope, entry));
3602
- }
3603
- }
3604
- const parent = path20.dirname(dir);
3605
- if (atInstallRoot || parent === dir) return found;
3606
- dir = parent;
3607
- }
3608
- }
3609
- var declarationCache = /* @__PURE__ */ new Map();
3610
- function declarationsOf(dir, warnings) {
3611
- const pkg = JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8"));
3612
- const key2 = `${realpathSync(dir)}@${pkg.version ?? ""}`;
3613
- let cached = declarationCache.get(key2);
3614
- if (!cached) {
3615
- cached = loadDeclarations(dir, warnings);
3616
- declarationCache.set(key2, cached);
3617
- }
3618
- return cached;
3619
- }
3620
- async function loadDeclarations(dir, warnings) {
3621
- const pkg = JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8"));
3622
- const entry = pkg.exports?.["./blocks"];
3623
- const target = typeof entry === "string" ? entry : entry && typeof entry === "object" ? entry["import"] ?? entry["default"] : void 0;
3624
- if (typeof target !== "string") return {};
3625
- const rel = safeRelative(target.replace(/^\.\//, ""));
3626
- const file = rel && path20.join(dir, ...rel.split("/"));
3627
- if (!file || !inside(dir, file) || !existsSync(file)) return {};
3628
- try {
3629
- const jiti = createJiti(path20.join(dir, "package.json"), { moduleCache: false });
3630
- const mod = await jiti.import(file);
3631
- const out = {};
3632
- for (const value of Object.values(mod)) if (isBlockDef(value)) out[value.id] = declarationFields(value);
3633
- return out;
3634
- } catch (err) {
3635
- warnings.push(`${pkg.name}/blocks didn't load in Node (${err instanceof Error ? err.message.split("\n")[0] : String(err)}); using its package.json manifest only.`);
3636
- return {};
3637
- }
3638
- }
3639
- async function blocksOfInstalled(dir, warnings = [], options = {}) {
3640
- const pkg = JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8"));
3641
- const raw = rawBlocksOf(pkg);
3642
- const declared = await declarationsOf(dir, warnings);
3643
- const ids = /* @__PURE__ */ new Set([...Object.keys(raw), ...Object.keys(declared)]);
3644
- const out = [];
3645
- for (const id of [...ids].sort()) {
3646
- const fromJson = raw[id] ?? {};
3647
- const merged = { ...fromJson, ...declared[id] };
3648
- if (declared[id]?.["migrations"] && Array.isArray(fromJson["migrations"])) merged["migrations"] = withProvides(declared[id]["migrations"], fromJson["migrations"]);
3649
- const manifest = tryParse(() => parseManifest(pkg.name, id, merged, pkg.version, options), warnings);
3650
- if (manifest) out.push(manifest);
3651
- }
3652
- return out;
3653
- }
3654
- function withProvides(declared, json) {
3655
- if (!Array.isArray(declared)) return declared;
3656
- const fileOf = (m) => m && typeof m === "object" ? m["file"] : void 0;
3657
- return declared.map((m) => {
3658
- const same = json.find((j) => fileOf(j) === fileOf(m));
3659
- return same?.["provides"] !== void 0 && m && typeof m === "object" && !("provides" in m) ? { ...m, provides: same["provides"] } : m;
3660
- });
3661
- }
3662
- async function allBlocks(root, warnings = []) {
3663
- const out = [];
3664
- for (const local of localPackages(root)) {
3665
- for (const manifest of await blocksOfInstalled(local.dir, warnings, { local: true })) out.push({ manifest, from: "local" });
3666
- }
3667
- const installed = installedGenesis(root);
3668
- for (const [, dir] of installed) for (const manifest of await blocksOfInstalled(dir, warnings)) out.push({ manifest, from: "installed" });
3669
- for (const [name, entry] of Object.entries(readCatalog().packages)) {
3670
- if (installed.has(name)) continue;
3671
- for (const [id, raw] of Object.entries(entry.blocks ?? {})) {
3672
- const manifest = tryParse(() => parseManifest(name, id, raw, entry.version), warnings);
3673
- if (manifest) out.push({ manifest, from: "catalog" });
3727
+ const strippedCache = /* @__PURE__ */ new Map();
3728
+ const stripped = (file) => {
3729
+ if (!strippedCache.has(file.absolutePath)) strippedCache.set(file.absolutePath, stripForImports(file.code));
3730
+ return strippedCache.get(file.absolutePath);
3731
+ };
3732
+ const memo = /* @__PURE__ */ new WeakMap();
3733
+ const reach = (file, test2, depth, seen) => {
3734
+ let cache2 = memo.get(test2);
3735
+ if (!cache2) memo.set(test2, cache2 = { free: /* @__PURE__ */ new Map(), cut: /* @__PURE__ */ new Map() });
3736
+ const k = `${file.absolutePath}\0${depth}`;
3737
+ const free = cache2.free.get(k);
3738
+ if (free) return [free, /* @__PURE__ */ new Set()];
3739
+ const reusable = cache2.cut.get(k)?.find((e) => e.cut.every((m) => seen.has(m)));
3740
+ if (reusable) return [reusable.result, new Set(reusable.cut)];
3741
+ let result;
3742
+ const cut = /* @__PURE__ */ new Set();
3743
+ const code = stripped(file);
3744
+ if (code === null) result = "unknown";
3745
+ else if (test2(code)) result = "yes";
3746
+ else {
3747
+ const { files, lost } = importsOf(file);
3748
+ let unknown = lost && depth > 0;
3749
+ result = "no";
3750
+ if (depth > 0) {
3751
+ seen.add(file.absolutePath);
3752
+ for (const abs of files) {
3753
+ if (seen.has(abs)) {
3754
+ cut.add(abs);
3755
+ continue;
3756
+ }
3757
+ const target = read2(abs);
3758
+ if (!target) {
3759
+ unknown = true;
3760
+ continue;
3761
+ }
3762
+ const [r, c] = reach(target, test2, depth - 1, seen);
3763
+ for (const m of c) cut.add(m);
3764
+ if (r === "yes") {
3765
+ result = "yes";
3766
+ break;
3767
+ }
3768
+ if (r === "unknown") unknown = true;
3769
+ }
3770
+ seen.delete(file.absolutePath);
3771
+ cut.delete(file.absolutePath);
3772
+ }
3773
+ if (result === "no" && unknown) result = "unknown";
3674
3774
  }
3675
- }
3676
- return out;
3677
- }
3678
- function tryParse(parse2, warnings) {
3679
- try {
3680
- return parse2();
3681
- } catch (err) {
3682
- if (!(err instanceof ManifestError)) throw err;
3683
- warnings.push(err.message);
3684
- return null;
3685
- }
3686
- }
3687
- function catalogBlocks(warnings = []) {
3688
- const out = [];
3689
- for (const [name, entry] of Object.entries(readCatalog().packages)) {
3690
- for (const [id, raw] of Object.entries(entry.blocks ?? {})) {
3691
- const manifest = tryParse(() => parseManifest(name, id, raw, entry.version), warnings);
3692
- if (manifest) out.push(manifest);
3775
+ if (result === "yes" || cut.size === 0) {
3776
+ cache2.free.set(k, result);
3777
+ return [result, /* @__PURE__ */ new Set()];
3693
3778
  }
3694
- }
3695
- return out;
3696
- }
3697
- async function findBlock(root, id, options = {}) {
3698
- const all = (await allBlocks(root, options.warnings)).filter((b) => b.manifest.id === id && (!options.package || b.manifest.package === options.package));
3699
- if (all.length === 0) {
3700
- const known = [...new Set((await allBlocks(root)).map((b) => b.manifest.id))].sort();
3701
- throw new Error(`No Genesis or local package declares a block "${id}"${options.package ? ` in ${options.package}` : ""}. Known blocks: ${known.join(", ") || "none"}.`);
3702
- }
3703
- if (all.length > 1) throw new Error(`"${id}" is declared by ${all.map((b) => b.manifest.package).join(" and ")}; pass --package to pick one.`);
3704
- return all[0];
3779
+ const entries = cache2.cut.get(k) ?? [];
3780
+ entries.push({ cut: [...cut], result });
3781
+ cache2.cut.set(k, entries);
3782
+ return [result, cut];
3783
+ };
3784
+ return { reach: (file, test2, depth = TRAIL_DEPTH) => reach(file, test2, depth, /* @__PURE__ */ new Set())[0] };
3705
3785
  }
3706
3786
  var ROUTES_DIR_CANDIDATES = ["src/routes", "src/app", "app", "src/pages", "pages"];
3707
3787
  var STEMS = {
@@ -3720,7 +3800,7 @@ var RENDERS_OUTLET = (code) => /<Outlet(?=[\s>/])/.test(code);
3720
3800
  var OWN_CONTENT = /(?<![=-])>\s*[A-Za-z][^<>{}]*</.source + "|" + /(?<![\w$.])<(?:h[1-6]|ul|ol|table|dl|H[1-6]|[A-Z]\w*(?:Heading|Title|Table|List|Grid))(?=[\s>/])/.source;
3721
3801
  function routesDir(ctx) {
3722
3802
  if (ctx.config.routesDir) return ctx.config.routesDir;
3723
- return ROUTES_DIR_CANDIDATES.find((d) => existsSync(path20.join(ctx.root, d))) ?? null;
3803
+ return ROUTES_DIR_CANDIDATES.find((d) => existsSync(path21.join(ctx.root, d))) ?? null;
3724
3804
  }
3725
3805
  var key = (segments) => segments.map((s) => s.replace(/_$/, "")).join("/");
3726
3806
  function flavorOf(dir, rels) {
@@ -3855,7 +3935,7 @@ function validateDeclaration(raw, packageName3, packageDir, ignored) {
3855
3935
  });
3856
3936
  if (typeof raw === "string") {
3857
3937
  if (!packageDir) fail(`points at ${raw}, but the package folder is unknown`);
3858
- const file = path20.resolve(packageDir, raw);
3938
+ const file = path21.resolve(packageDir, raw);
3859
3939
  if (!inside(packageDir, file)) fail(`points outside the package (${raw})`);
3860
3940
  if (!existsSync(file)) fail(`points at ${raw}, which doesn't exist (is it in package.json "files"?)`);
3861
3941
  let parsed;
@@ -3904,7 +3984,7 @@ function validateDeclaration(raw, packageName3, packageDir, ignored) {
3904
3984
  if (typeof c.plugin === "string") {
3905
3985
  if (!packageDir) plugin = c.plugin;
3906
3986
  else {
3907
- plugin = path20.resolve(packageDir, c.plugin);
3987
+ plugin = path21.resolve(packageDir, c.plugin);
3908
3988
  if (!inside(packageDir, plugin)) fail(`plugin points outside the package (${c.plugin})`);
3909
3989
  }
3910
3990
  }
@@ -3954,7 +4034,7 @@ function checkPattern(v, where2, fail) {
3954
4034
  }
3955
4035
  var discoveryCache = /* @__PURE__ */ new Map();
3956
4036
  function readDeclaringPackage(dir, local) {
3957
- const file = path20.join(dir, "package.json");
4037
+ const file = path21.join(dir, "package.json");
3958
4038
  let stamp;
3959
4039
  let real2;
3960
4040
  try {
@@ -3977,7 +4057,7 @@ ${local}`;
3977
4057
  const pkg = {
3978
4058
  name: json.name,
3979
4059
  version: typeof json.version === "string" ? json.version : "0.0.0",
3980
- dir: path20.resolve(dir),
4060
+ dir: path21.resolve(dir),
3981
4061
  namespace: ruleNamespace(json.name),
3982
4062
  local,
3983
4063
  private: json.private === true,
@@ -3991,7 +4071,7 @@ ${local}`;
3991
4071
  if (raw !== void 0) {
3992
4072
  const ignored = [];
3993
4073
  try {
3994
- pkg.declaration = validateDeclaration(raw, json.name, path20.resolve(dir), ignored);
4074
+ pkg.declaration = validateDeclaration(raw, json.name, path21.resolve(dir), ignored);
3995
4075
  if (ignored.length) pkg.ignored = ignored;
3996
4076
  } catch (err) {
3997
4077
  pkg.error = err.message;
@@ -4010,14 +4090,14 @@ function discoverPackages(root) {
4010
4090
  for (const dir of installed) {
4011
4091
  let scope;
4012
4092
  try {
4013
- scope = path20.dirname(realpathSync(dir));
4093
+ scope = path21.dirname(realpathSync(dir));
4014
4094
  } catch {
4015
4095
  continue;
4016
4096
  }
4017
- if (path20.basename(scope) !== "@marktiderman" || !existsSync(scope)) continue;
4097
+ if (path21.basename(scope) !== "@marktiderman" || !existsSync(scope)) continue;
4018
4098
  for (const entry of readdirSync(scope)) {
4019
4099
  if (byName.has(`@marktiderman/${entry}`) || !GENESIS.test(`@marktiderman/${entry}`)) continue;
4020
- const pkg = readDeclaringPackage(path20.join(scope, entry), false);
4100
+ const pkg = readDeclaringPackage(path21.join(scope, entry), false);
4021
4101
  if (pkg) byName.set(pkg.name, pkg);
4022
4102
  }
4023
4103
  }
@@ -4201,10 +4281,10 @@ var IMPORT = /(?:\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*)["']([
4201
4281
  var TYPE_ONLY = /\b(?:import|export)\s+type\s+(?:\{[^}]*\}|\*\s+as\s+[\w$]+|\*|[\w$]+)\s*from\s*["'][^"']+["']/g;
4202
4282
  function sourceFiles(dir, rel = "") {
4203
4283
  const out = [];
4204
- for (const entry of readdirSync(path20.join(dir, rel)).sort()) {
4284
+ for (const entry of readdirSync(path21.join(dir, rel)).sort()) {
4205
4285
  if (entry.startsWith(".") || SKIP_DIRS2.has(entry)) continue;
4206
4286
  const child = rel ? `${rel}/${entry}` : entry;
4207
- const stat = lstatSync(path20.join(dir, child));
4287
+ const stat = lstatSync(path21.join(dir, child));
4208
4288
  if (stat.isSymbolicLink()) continue;
4209
4289
  if (stat.isDirectory()) out.push(...sourceFiles(dir, child));
4210
4290
  else if (SOURCE.test(entry) && !entry.endsWith(".d.ts")) out.push(child);
@@ -4227,13 +4307,13 @@ function matchPattern(pattern, spec) {
4227
4307
  return spec.startsWith(head) && spec.endsWith(tail) && spec.length >= head.length + tail.length ? spec.slice(head.length, spec.length - tail.length) : null;
4228
4308
  }
4229
4309
  function tsconfigPaths(dir) {
4230
- const file = path20.join(dir, "tsconfig.json");
4310
+ const file = path21.join(dir, "tsconfig.json");
4231
4311
  if (!existsSync(file)) return [];
4232
4312
  try {
4233
4313
  const text = readFileSync(file, "utf8").replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[\s{,[])\/\/[^\n]*/g, "$1").replace(/,(\s*[}\]])/g, "$1");
4234
4314
  const options = JSON.parse(text).compilerOptions ?? {};
4235
- const base = path20.resolve(dir, options.baseUrl ?? ".");
4236
- return Object.entries(options.paths ?? {}).map(([pattern, targets]) => ({ pattern, targets: targets.map((t) => path20.resolve(base, t)) }));
4315
+ const base = path21.resolve(dir, options.baseUrl ?? ".");
4316
+ return Object.entries(options.paths ?? {}).map(([pattern, targets]) => ({ pattern, targets: targets.map((t) => path21.resolve(base, t)) }));
4237
4317
  } catch {
4238
4318
  return [];
4239
4319
  }
@@ -4247,8 +4327,8 @@ function checkImports2(ctx, pkg, json) {
4247
4327
  const hit = matchPattern(pattern, spec);
4248
4328
  if (hit === null) continue;
4249
4329
  return targets.some((t) => {
4250
- const rel = path20.relative(pkg.dir, t.replace("*", hit));
4251
- return !rel.startsWith("..") && !path20.isAbsolute(rel);
4330
+ const rel = path21.relative(pkg.dir, t.replace("*", hit));
4331
+ return !rel.startsWith("..") && !path21.isAbsolute(rel);
4252
4332
  });
4253
4333
  }
4254
4334
  return null;
@@ -4261,7 +4341,7 @@ function checkImports2(ctx, pkg, json) {
4261
4341
  ...Object.keys(json.optionalDependencies ?? {})
4262
4342
  ]);
4263
4343
  for (const file of sourceFiles(pkg.dir)) {
4264
- const code = stripForImports(readFileSync(path20.join(pkg.dir, file), "utf8"));
4344
+ const code = stripForImports(readFileSync(path21.join(pkg.dir, file), "utf8"));
4265
4345
  if (code === null) continue;
4266
4346
  const at = `${pkg.rel}/${file}`;
4267
4347
  const typeOnly = [...code.matchAll(TYPE_ONLY)].map((m) => [m.index, m.index + m[0].length]);
@@ -4286,9 +4366,9 @@ function checkImports2(ctx, pkg, json) {
4286
4366
  continue;
4287
4367
  }
4288
4368
  if (spec.startsWith(".")) {
4289
- const target = path20.resolve(pkg.dir, path20.dirname(file), spec);
4290
- const rel = path20.relative(pkg.dir, target);
4291
- if (rel.startsWith("..") || path20.isAbsolute(rel)) {
4369
+ const target = path21.resolve(pkg.dir, path21.dirname(file), spec);
4370
+ const rel = path21.relative(pkg.dir, target);
4371
+ if (rel.startsWith("..") || path21.isAbsolute(rel)) {
4292
4372
  ctx.report({ rule: "package-app-import", file: at, line, subject: spec, message: `${pkg.name} reaches outside its folder (${spec}); move what it needs into the package or a dependency` });
4293
4373
  }
4294
4374
  continue;
@@ -4325,12 +4405,12 @@ function checkMigrations(ctx, pkg, json, locals) {
4325
4405
  const from = own ? "" : ` (in ${m.package})`;
4326
4406
  if (typeof m.file === "string" && typeof m.test !== "string") {
4327
4407
  ctx.report({ rule: "package-migration-test", file: `${pkg.rel}/package.json`, subject: m.file, message: `${pkg.name} block ${id}: ${m.file}${from} has no pgTAP test; declare one as "test" beside it` });
4328
- } else if (typeof m.test === "string" && !existsSync(path20.join(home, m.test))) {
4408
+ } else if (typeof m.test === "string" && !existsSync(path21.join(home, m.test))) {
4329
4409
  ctx.report({ rule: "package-migration-test", file: `${pkg.rel}/package.json`, subject: m.test, message: `${pkg.name} block ${id}: its test ${m.test}${from} doesn't exist` });
4330
4410
  }
4331
4411
  }
4332
4412
  }
4333
- const dir = path20.join(pkg.dir, "migrations");
4413
+ const dir = path21.join(pkg.dir, "migrations");
4334
4414
  if (!existsSync(dir)) return;
4335
4415
  const seen = /* @__PURE__ */ new Map();
4336
4416
  for (const name of readdirSync(dir).sort()) {
@@ -4339,21 +4419,21 @@ function checkMigrations(ctx, pkg, json, locals) {
4339
4419
  const other = seen.get(m[1]);
4340
4420
  if (other) ctx.report({ rule: "package-migration-number", file: `${pkg.rel}/migrations/${name}`, subject: m[1], message: `${pkg.name}: ${name} and ${other} share the number ${m[1]}; give each migration its own` });
4341
4421
  else seen.set(m[1], name);
4342
- if (!declaredFiles.has(`migrations/${name}`) && !existsSync(path20.join(dir, "tests", name.replace(/\.sql$/, ".test.sql")))) {
4422
+ if (!declaredFiles.has(`migrations/${name}`) && !existsSync(path21.join(dir, "tests", name.replace(/\.sql$/, ".test.sql")))) {
4343
4423
  ctx.report({ rule: "package-migration-test", file: `${pkg.rel}/migrations/${name}`, subject: name, message: `${pkg.name}: ${name} has no pgTAP test (migrations/tests/${name.replace(/\.sql$/, ".test.sql")})` });
4344
4424
  }
4345
4425
  }
4346
4426
  }
4347
4427
  function checkExports(ctx, pkg, json) {
4348
4428
  const targets = [];
4349
- const walk2 = (v) => {
4429
+ const walk3 = (v) => {
4350
4430
  if (typeof v === "string") targets.push(v);
4351
- else if (v && typeof v === "object") for (const x of Object.values(v)) walk2(x);
4431
+ else if (v && typeof v === "object") for (const x of Object.values(v)) walk3(x);
4352
4432
  };
4353
- walk2(json.exports);
4433
+ walk3(json.exports);
4354
4434
  for (const t of targets) {
4355
4435
  if (!t.startsWith("./") || t.includes("*") || !/\.(?:[cm]?tsx?|json)$/.test(t) || /\.d\.[cm]?ts$/.test(t)) continue;
4356
- if (!existsSync(path20.join(pkg.dir, t))) {
4436
+ if (!existsSync(path21.join(pkg.dir, t))) {
4357
4437
  ctx.report({ rule: "package-export-missing", file: `${pkg.rel}/package.json`, subject: t, message: `${pkg.name} exports ${t}, which doesn't exist` });
4358
4438
  }
4359
4439
  }
@@ -4371,11 +4451,11 @@ function checkBlocks(ctx, pkg, json) {
4371
4451
  function checkTaggedTests(ctx, pkg) {
4372
4452
  const tests = sourceFiles(pkg.dir).filter((f) => /\.(test|spec)\.[cm]?[jt]sx?$/.test(f));
4373
4453
  if (!tests.length) return;
4374
- const tagged = tests.some((f) => /@feat:[a-z]/.test(readFileSync(path20.join(pkg.dir, f), "utf8")));
4454
+ const tagged = tests.some((f) => /@feat:[a-z]/.test(readFileSync(path21.join(pkg.dir, f), "utf8")));
4375
4455
  if (!tagged) ctx.report({ rule: "package-untagged-tests", level: "warn", file: pkg.rel, message: `${pkg.name}'s tests name no feature; tag them with // @feat:<feature id>` });
4376
4456
  }
4377
4457
  function checkRegistered(ctx, pkg) {
4378
- const file = path20.join(ctx.root, "features.json");
4458
+ const file = path21.join(ctx.root, "features.json");
4379
4459
  if (!existsSync(file)) return;
4380
4460
  let doc;
4381
4461
  try {
@@ -4385,7 +4465,7 @@ function checkRegistered(ctx, pkg) {
4385
4465
  }
4386
4466
  const top = git(ctx.root, ["rev-parse", "--show-toplevel"])?.trim();
4387
4467
  const forms = /* @__PURE__ */ new Set([pkg.rel]);
4388
- if (top) forms.add(path20.relative(top, realpathSync(pkg.dir)).split(path20.sep).join("/"));
4468
+ if (top) forms.add(path21.relative(top, realpathSync(pkg.dir)).split(path21.sep).join("/"));
4389
4469
  const covered = (doc.features ?? []).some(
4390
4470
  (f) => (f.links?.code ?? []).some((c) => {
4391
4471
  const norm = c.replace(/^\.\//, "").replace(/\/+$/, "");
@@ -4415,8 +4495,8 @@ function mergeBaseOf(root, base) {
4415
4495
  function checkChanges(ctx, pkg, json, base, mergeBase) {
4416
4496
  const top = git(ctx.root, ["rev-parse", "--show-toplevel"])?.trim();
4417
4497
  if (!top) return;
4418
- const appRelative = (fromTop) => path20.relative(realpathSync(ctx.root), path20.join(top, fromTop)).split(path20.sep).join("/");
4419
- const inRepo = path20.relative(top, realpathSync(pkg.dir)).split(path20.sep).join("/");
4498
+ const appRelative = (fromTop) => path21.relative(realpathSync(ctx.root), path21.join(top, fromTop)).split(path21.sep).join("/");
4499
+ const inRepo = path21.relative(top, realpathSync(pkg.dir)).split(path21.sep).join("/");
4420
4500
  const diff = (git(top, ["diff", "--name-status", "-M", mergeBase, "--", inRepo]) ?? "").split("\n").filter(Boolean).map((row) => row.split(" ").map((cell2, i) => i === 0 ? cell2 : appRelative(cell2)).join(" ")).join("\n");
4421
4501
  const untracked = (git(top, ["ls-files", "--others", "--exclude-standard", "--", inRepo]) ?? "").split("\n").filter(Boolean).map(appRelative);
4422
4502
  const changed = [...diff.split("\n").filter(Boolean).map((row) => row.split(" ").at(-1)), ...untracked].filter(
@@ -4439,11 +4519,11 @@ function checkChanges(ctx, pkg, json, base, mergeBase) {
4439
4519
  const now = typeof json.version === "string" ? parseVersion(json.version) : null;
4440
4520
  const was = typeof versionBefore === "string" ? parseVersion(versionBefore) : null;
4441
4521
  const bumped = before === null || now !== null && was !== null && compareVersions(now, was) > 0;
4442
- const changesets = top ? (git(top, ["diff", "--name-only", "--diff-filter=A", mergeBase, "--", ".changeset"]) ?? "").split("\n").concat((git(top, ["ls-files", "--others", "--exclude-standard", "--", ".changeset"]) ?? "").split("\n")).filter((f) => f.endsWith(".md")).map((f) => path20.join(top, f)) : [];
4522
+ const changesets = top ? (git(top, ["diff", "--name-only", "--diff-filter=A", mergeBase, "--", ".changeset"]) ?? "").split("\n").concat((git(top, ["ls-files", "--others", "--exclude-standard", "--", ".changeset"]) ?? "").split("\n")).filter((f) => f.endsWith(".md")).map((f) => path21.join(top, f)) : [];
4443
4523
  const naming = changesets.filter((p) => existsSync(p) && changesetNames(readFileSync(p, "utf8")).has(json.name));
4444
4524
  const named = naming.length > 0;
4445
4525
  if (named && !naming.some((p) => /^Features:\s*\S/m.test(readFileSync(p, "utf8")))) {
4446
- ctx.report({ rule: "package-unversioned-change", level: "warn", file: path20.relative(realpathSync(ctx.root), naming[0]), message: `the changeset for ${pkg.name} has no "Features:" line; name the features it changes` });
4526
+ ctx.report({ rule: "package-unversioned-change", level: "warn", file: path21.relative(realpathSync(ctx.root), naming[0]), message: `the changeset for ${pkg.name} has no "Features:" line; name the features it changes` });
4447
4527
  }
4448
4528
  let jsonBefore = null;
4449
4529
  try {
@@ -4453,7 +4533,7 @@ function checkChanges(ctx, pkg, json, base, mergeBase) {
4453
4533
  }
4454
4534
  const raw = json;
4455
4535
  if (jsonBefore && (JSON.stringify(jsonBefore.genesis) !== JSON.stringify(raw.genesis) || JSON.stringify(jsonBefore.exports) !== JSON.stringify(raw.exports))) {
4456
- const appInRepo = path20.relative(top, realpathSync(ctx.root)).split(path20.sep).join("/");
4536
+ const appInRepo = path21.relative(top, realpathSync(ctx.root)).split(path21.sep).join("/");
4457
4537
  const candidates = [.../* @__PURE__ */ new Set(["features.ts", "src/features.ts", ...appInRepo ? [`${appInRepo}/features.ts`, `${appInRepo}/src/features.ts`] : []])];
4458
4538
  const registry = (git(top, ["diff", "--name-only", mergeBase, "--", ...candidates]) ?? "").trim();
4459
4539
  if (!registry) ctx.report({ rule: "package-unversioned-change", level: "warn", file: `${pkg.rel}/package.json`, message: `${pkg.name}'s blocks or exports changed but features.ts didn't; update the features they belong to` });
@@ -4505,7 +4585,7 @@ function checkPackagesPack(ctx) {
4505
4585
  ctx.report({ rule: "package-unversioned-change", level: base ? "warn" : "info", file: "genesis.config.json", message: `change gate skipped: ${merge.reason}` });
4506
4586
  }
4507
4587
  for (const pkg of packages) {
4508
- const json = JSON.parse(readFileSync(path20.join(pkg.dir, "package.json"), "utf8"));
4588
+ const json = JSON.parse(readFileSync(path21.join(pkg.dir, "package.json"), "utf8"));
4509
4589
  checkImports2(ctx, pkg, json);
4510
4590
  checkExports(ctx, pkg, json);
4511
4591
  checkBlocks(ctx, pkg, json);
@@ -4522,7 +4602,7 @@ function emptyLock() {
4522
4602
  return { version: 1, blocks: {}, files: {} };
4523
4603
  }
4524
4604
  function readLock(root) {
4525
- const file = path20.join(root, LOCK_FILE);
4605
+ const file = path21.join(root, LOCK_FILE);
4526
4606
  if (!existsSync(file)) return emptyLock();
4527
4607
  const raw = JSON.parse(readFileSync(file, "utf8"));
4528
4608
  if (raw.version !== 1) throw new Error(`${LOCK_FILE} has version ${String(raw.version)}; this CLI reads version 1.`);
@@ -4545,11 +4625,11 @@ function databaseElsewhere(root) {
4545
4625
  const setting = readGenesisConfig(root)?.supabase;
4546
4626
  if (setting === void 0) return null;
4547
4627
  if (setting === false) return { app: null, dir: null, hasSupabase: false };
4548
- const resolved = path20.resolve(root, setting.app);
4628
+ const resolved = path21.resolve(root, setting.app);
4549
4629
  const real2 = (p) => existsSync(p) ? realpathSync(p) : p;
4550
4630
  const dir = real2(resolved);
4551
- if (dir === real2(path20.resolve(root))) throw new GenesisConfigError(`${path20.join(root, "genesis.config.json")}: supabase.app "${setting.app}" is this app itself; leave "supabase" out instead`);
4552
- return { app: setting.app, dir, hasSupabase: existsSync(path20.join(dir, "supabase")) };
4631
+ if (dir === real2(path21.resolve(root))) throw new GenesisConfigError(`${path21.join(root, "genesis.config.json")}: supabase.app "${setting.app}" is this app itself; leave "supabase" out instead`);
4632
+ return { app: setting.app, dir, hasSupabase: existsSync(path21.join(dir, "supabase")) };
4553
4633
  }
4554
4634
  function isSupabasePath(rel) {
4555
4635
  return rel === "supabase" || rel.startsWith("supabase/");
@@ -4739,9 +4819,9 @@ function checkSupabasePack(ctx) {
4739
4819
  if (databaseElsewhere(ctx.root)) return;
4740
4820
  const settings = ctx.config.supabase ?? {};
4741
4821
  const dir = settings.migrations ?? DEFAULT_MIGRATIONS;
4742
- const abs = path20.join(ctx.root, dir);
4822
+ const abs = path21.join(ctx.root, dir);
4743
4823
  if (!existsSync(abs)) throw new DoctorConfigError(`the supabase pack reads ${dir}, which doesn't exist; set doctor.supabase.migrations`);
4744
- const migrations = readdirSync(abs).filter((n) => n.endsWith(".sql")).sort().map((n) => ({ file: `${dir}/${n}`, statements: sqlStatements(readFileSync(path20.join(abs, n), "utf8")) }));
4824
+ const migrations = readdirSync(abs).filter((n) => n.endsWith(".sql")).sort().map((n) => ({ file: `${dir}/${n}`, statements: sqlStatements(readFileSync(path21.join(abs, n), "utf8")) }));
4745
4825
  const exposed = new Set((settings.exposedSchemas ?? DEFAULT_EXPOSED).map((s) => s.toLowerCase()));
4746
4826
  const base = settings.base ?? DEFAULT_BASE;
4747
4827
  const view = gitView(ctx.root, dir, base);
@@ -4758,7 +4838,7 @@ function checkSupabasePack(ctx) {
4758
4838
  }
4759
4839
  }
4760
4840
  const since = settings.since;
4761
- const afterSince = (file) => since === void 0 || path20.posix.basename(file) >= since;
4841
+ const afterSince = (file) => since === void 0 || path21.posix.basename(file) >= since;
4762
4842
  if ("reason" in view && since === void 0) {
4763
4843
  ctx.report({
4764
4844
  rule: "migration-grants",
@@ -5041,7 +5121,7 @@ var DEV_TOOLS = /* @__PURE__ */ new Set(["@marktiderman/genesis-cli"]);
5041
5121
  var NON_SHIPPING = /^(?:@marktiderman\/genesis-cli|vitest|@vitest\/.+|jest|jest-.+|@jest\/.+|ts-jest|babel-jest|mocha|ava|c8|nyc|@playwright\/test|playwright|cypress|@testing-library\/.+|happy-dom|jsdom|msw|@types\/.+|typescript|tsx|ts-node|eslint|eslint-.+|@eslint\/.+|@typescript-eslint\/.+|typescript-eslint|prettier|prettier-.+|@biomejs\/.+|oxlint|vite|@vitejs\/.+|vite-plugin-.+|webpack|webpack-.+|rollup|@rollup\/.+|esbuild|tsup|turbo|@storybook\/.+|storybook|@changesets\/.+|husky|lint-staged|wrangler|knip|concurrently|npm-run-all2?|rimraf|cross-env|dotenv-cli)$/;
5042
5122
  var readManifest = (dir) => {
5043
5123
  try {
5044
- return JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8"));
5124
+ return JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8"));
5045
5125
  } catch {
5046
5126
  return null;
5047
5127
  }
@@ -5055,18 +5135,18 @@ var real = (p) => {
5055
5135
  };
5056
5136
  var LOCKFILES = ["bun.lock", "bun.lockb", "package-lock.json", "npm-shrinkwrap.json", "yarn.lock", "pnpm-lock.yaml"];
5057
5137
  function nodeModulesOf(dir) {
5058
- const parent = path20.dirname(dir);
5059
- return path20.basename(parent).startsWith("@") ? path20.dirname(parent) : parent;
5138
+ const parent = path21.dirname(dir);
5139
+ return path21.basename(parent).startsWith("@") ? path21.dirname(parent) : parent;
5060
5140
  }
5061
5141
  function packagesIn(nodeModules) {
5062
5142
  if (!existsSync(nodeModules)) return [];
5063
5143
  const out = [];
5064
5144
  for (const entry of readdirSync(nodeModules)) {
5065
5145
  if (entry.startsWith(".")) continue;
5066
- const p = path20.join(nodeModules, entry);
5146
+ const p = path21.join(nodeModules, entry);
5067
5147
  if (entry.startsWith("@")) {
5068
5148
  try {
5069
- for (const sub of readdirSync(p)) out.push(path20.join(p, sub));
5149
+ for (const sub of readdirSync(p)) out.push(path21.join(p, sub));
5070
5150
  } catch {
5071
5151
  }
5072
5152
  } else {
@@ -5078,7 +5158,7 @@ function packagesIn(nodeModules) {
5078
5158
  function genesisInstalls(root) {
5079
5159
  const copies = /* @__PURE__ */ new Map();
5080
5160
  const realRoot = real(root);
5081
- const rel = (abs) => path20.relative(realRoot, abs).split(path20.sep).join("/") || ".";
5161
+ const rel = (abs) => path21.relative(realRoot, abs).split(path21.sep).join("/") || ".";
5082
5162
  const via = /* @__PURE__ */ new Map();
5083
5163
  const record = (real2, manifest, by, range, root2) => {
5084
5164
  let copy = copies.get(real2);
@@ -5090,7 +5170,7 @@ function genesisInstalls(root) {
5090
5170
  via.get(real2).add(root2);
5091
5171
  if (!copy.requiredBy.some((r) => r.by === by)) copy.requiredBy.push({ by, ...range ? { range } : {} });
5092
5172
  };
5093
- const walk2 = (kind, roots) => {
5173
+ const walk3 = (kind, roots) => {
5094
5174
  const expanded = /* @__PURE__ */ new Set();
5095
5175
  const queue = [];
5096
5176
  const visit = (dir, by, range) => {
@@ -5123,7 +5203,7 @@ function genesisInstalls(root) {
5123
5203
  if (!dir) return null;
5124
5204
  if (!ownInstall || name in declared) return dir;
5125
5205
  const realDir = real(dir);
5126
- if (realDir.startsWith(realRoot + path20.sep)) return dir;
5206
+ if (realDir.startsWith(realRoot + path21.sep)) return dir;
5127
5207
  return nodeModulesOf(realDir) === nodeModulesOf(from) ? dir : null;
5128
5208
  };
5129
5209
  const rootsOf = (deps, by) => Object.entries(deps).flatMap(([name, range]) => {
@@ -5131,7 +5211,7 @@ function genesisInstalls(root) {
5131
5211
  return dir ? [{ dir, by, ...range ? { range } : {} }] : [];
5132
5212
  });
5133
5213
  const app = readManifest(root);
5134
- const ownInstall = LOCKFILES.some((f) => existsSync(path20.join(root, f)));
5214
+ const ownInstall = LOCKFILES.some((f) => existsSync(path21.join(root, f)));
5135
5215
  const declared = { ...app?.devDependencies, ...app?.peerDependencies, ...app?.optionalDependencies, ...app?.dependencies };
5136
5216
  const declaredDev = Object.entries(app?.devDependencies ?? {});
5137
5217
  const runtimeDeps = {
@@ -5141,18 +5221,18 @@ function genesisInstalls(root) {
5141
5221
  ...app?.dependencies
5142
5222
  };
5143
5223
  const devDeps = Object.fromEntries(declaredDev.filter(([n]) => NON_SHIPPING.test(n) && !(n in runtimeDeps)));
5144
- walk2("runtime", rootsOf(runtimeDeps, "the app"));
5145
- const top = path20.join(root, "node_modules");
5146
- walk2(
5224
+ walk3("runtime", rootsOf(runtimeDeps, "the app"));
5225
+ const top = path21.join(root, "node_modules");
5226
+ walk3(
5147
5227
  "hoisted",
5148
5228
  packagesIn(top).filter((dir) => {
5149
- const name = path20.relative(top, dir).split(path20.sep).join("/");
5229
+ const name = path21.relative(top, dir).split(path21.sep).join("/");
5150
5230
  return !(name in runtimeDeps) && !(name in devDeps);
5151
5231
  }).map((dir) => ({ dir, by: "hoisted, not a direct dependency" }))
5152
5232
  );
5153
5233
  const devRoots = { ...devDeps };
5154
5234
  for (const tool of DEV_TOOLS) if (!(tool in devRoots) && tool in runtimeDeps) devRoots[tool] = runtimeDeps[tool];
5155
- walk2("dev", rootsOf(devRoots, "the app (dev)"));
5235
+ walk3("dev", rootsOf(devRoots, "the app (dev)"));
5156
5236
  for (const [key2, copy] of copies) {
5157
5237
  const kinds = via.get(key2);
5158
5238
  copy.runtime = kinds.has("runtime");
@@ -5188,7 +5268,7 @@ function checkDuplicatePackages(ctx) {
5188
5268
  }
5189
5269
  }
5190
5270
  function checkPeerRanges(ctx) {
5191
- const rel = (abs) => path20.relative(ctx.root, abs).split(path20.sep).join("/");
5271
+ const rel = (abs) => path21.relative(ctx.root, abs).split(path21.sep).join("/");
5192
5272
  for (const copies of genesisInstalls(ctx.root).values()) {
5193
5273
  for (const copy of copies) {
5194
5274
  const dir = copy.absolutePath;
@@ -5375,6 +5455,24 @@ function checkIsoDateSlices(ctx) {
5375
5455
  }
5376
5456
  }
5377
5457
  }
5458
+ var SKIP_DIRS3 = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", ".next", ".output", ".turbo", ".expo", "coverage", "ios", "android"]);
5459
+ var SCRIPT2 = /\.(?:[cm]?[jt]sx?)$/;
5460
+ var MAX_BYTES = 2 * 1024 * 1024;
5461
+ function appScripts(root) {
5462
+ const out = [];
5463
+ const walk3 = (dir) => {
5464
+ for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
5465
+ const abs = path21.join(dir, entry.name);
5466
+ if (entry.isDirectory()) {
5467
+ if (!SKIP_DIRS3.has(entry.name)) walk3(abs);
5468
+ } else if (entry.isFile() && SCRIPT2.test(entry.name) && statSync(abs).size <= MAX_BYTES) {
5469
+ out.push(path21.relative(root, abs).split(path21.sep).join("/"));
5470
+ }
5471
+ }
5472
+ };
5473
+ walk3(root);
5474
+ return out;
5475
+ }
5378
5476
 
5379
5477
  // src/upgrade/scope-names.ts
5380
5478
  var IMPORTS_GENESIS = /\bfrom\s*["']@marktiderman\/genesis[\w/-]*["']/;
@@ -5569,11 +5667,11 @@ var ESLINT_EXPORT = "@marktiderman/genesis-cli/eslint";
5569
5667
  var TESTING_LIBRARY = "eslint-plugin-testing-library";
5570
5668
  var FLAT_CONFIG_FILES = ["eslint.config.js", "eslint.config.mjs", "eslint.config.cjs", "eslint.config.ts", "eslint.config.mts", "eslint.config.cts"];
5571
5669
  function findEslintConfig(root) {
5572
- return FLAT_CONFIG_FILES.find((name) => existsSync(path20.join(root, name))) ?? null;
5670
+ return FLAT_CONFIG_FILES.find((name) => existsSync(path21.join(root, name))) ?? null;
5573
5671
  }
5574
5672
  function readPackageJson(root) {
5575
5673
  try {
5576
- return JSON.parse(readFileSync(path20.join(root, "package.json"), "utf8"));
5674
+ return JSON.parse(readFileSync(path21.join(root, "package.json"), "utf8"));
5577
5675
  } catch {
5578
5676
  return null;
5579
5677
  }
@@ -5589,26 +5687,6 @@ function usesGenesisLint(text) {
5589
5687
  return text.includes(ESLINT_EXPORT);
5590
5688
  }
5591
5689
 
5592
- // src/upgrade/codemods.ts
5593
- var SKIP_DIRS3 = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", ".next", ".output", ".turbo", ".expo", "coverage", "ios", "android"]);
5594
- var SCRIPT2 = /\.(?:[cm]?[jt]sx?)$/;
5595
- var MAX_BYTES = 2 * 1024 * 1024;
5596
- function appScripts(root) {
5597
- const out = [];
5598
- const walk2 = (dir) => {
5599
- for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
5600
- const abs = path20.join(dir, entry.name);
5601
- if (entry.isDirectory()) {
5602
- if (!SKIP_DIRS3.has(entry.name)) walk2(abs);
5603
- } else if (entry.isFile() && SCRIPT2.test(entry.name) && statSync(abs).size <= MAX_BYTES) {
5604
- out.push(path20.relative(root, abs).split(path20.sep).join("/"));
5605
- }
5606
- }
5607
- };
5608
- walk2(root);
5609
- return out;
5610
- }
5611
-
5612
5690
  // src/doctor/api-usage.ts
5613
5691
  var SCRIPT_EXTS5 = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"]);
5614
5692
  function openingTag(code, start) {
@@ -5689,7 +5767,7 @@ var ROOT_REQUIRE = /\brequire\s*\(\s*["']@marktiderman\/genesis-studio-server["'
5689
5767
  function moduleFiles(ctx) {
5690
5768
  const scanned = new Set(ctx.files.map((f) => f.path));
5691
5769
  const ignored = globMatcher([...DEFAULT_IGNORE, ...ctx.config.ignore ?? []]);
5692
- const extra = appScripts(ctx.root).filter((rel) => /\.(c|m)js$/.test(rel) && !scanned.has(rel) && !ignored(rel)).map((rel) => ({ path: rel, code: stripBlockComments(readFileSync(path20.join(ctx.root, rel), "utf8"), true) }));
5770
+ const extra = appScripts(ctx.root).filter((rel) => /\.(c|m)js$/.test(rel) && !scanned.has(rel) && !ignored(rel)).map((rel) => ({ path: rel, code: stripBlockComments(readFileSync(path21.join(ctx.root, rel), "utf8"), true) }));
5693
5771
  return [...ctx.files.filter((f) => SCRIPT_EXTS5.has(f.ext)), ...extra];
5694
5772
  }
5695
5773
  function checkStudioServerImports(ctx) {
@@ -5725,7 +5803,7 @@ var REMOVED_WORDS = {
5725
5803
  };
5726
5804
  function checkRemovedScopeNames(ctx) {
5727
5805
  let augmentedMemo;
5728
- const augmented = () => augmentedMemo ??= ctx.files.some((f) => augmentsResourceScope(f.code)) || appScripts(ctx.root).filter((rel) => rel.endsWith(".d.ts")).some((rel) => augmentsResourceScope(readFileSync(path20.join(ctx.root, rel), "utf8")));
5806
+ const augmented = () => augmentedMemo ??= ctx.files.some((f) => augmentsResourceScope(f.code)) || appScripts(ctx.root).filter((rel) => rel.endsWith(".d.ts")).some((rel) => augmentsResourceScope(readFileSync(path21.join(ctx.root, rel), "utf8")));
5729
5807
  for (const file of ctx.files) {
5730
5808
  if (!SCRIPT_EXTS5.has(file.ext)) continue;
5731
5809
  for (const hit of findRemovedScopeNames(file.code)) {
@@ -5797,16 +5875,16 @@ function genesisNamedImports(source) {
5797
5875
  }
5798
5876
  function declarationFiles(dir, out = []) {
5799
5877
  for (const name of readdirSync(dir)) {
5800
- const full = path20.join(dir, name);
5878
+ const full = path21.join(dir, name);
5801
5879
  if (statSync(full).isDirectory()) declarationFiles(full, out);
5802
5880
  else if (/\.d\.[cm]?ts$/.test(name)) out.push(full);
5803
5881
  }
5804
5882
  return out;
5805
5883
  }
5806
5884
  function readPackageTags(dir) {
5807
- const pkg = JSON.parse(readFileSync(path20.join(dir, "package.json"), "utf8"));
5885
+ const pkg = JSON.parse(readFileSync(path21.join(dir, "package.json"), "utf8"));
5808
5886
  const tags = { dir, byFile: /* @__PURE__ */ new Map(), declaredIn: /* @__PURE__ */ new Map(), exports: typeof pkg.exports === "object" && pkg.exports ? pkg.exports : {} };
5809
- const dist = path20.join(dir, "dist");
5887
+ const dist = path21.join(dir, "dist");
5810
5888
  if (!existsSync(dist)) return tags;
5811
5889
  for (const file of declarationFiles(dist)) {
5812
5890
  const text = readFileSync(file, "utf8");
@@ -5824,7 +5902,7 @@ function entryFile(tags, pkg, specifier) {
5824
5902
  const subpath = `.${specifier.slice(pkg.length)}` || ".";
5825
5903
  const target = tags.exports[subpath === "." ? "." : subpath];
5826
5904
  const types = typeof target === "object" && target ? target.types : null;
5827
- return typeof types === "string" ? path20.join(tags.dir, types) : null;
5905
+ return typeof types === "string" ? path21.join(tags.dir, types) : null;
5828
5906
  }
5829
5907
  function tagFor(tags, entry, name) {
5830
5908
  if (entry && tags.declaredIn.get(name)?.includes(entry)) return tags.byFile.get(entry)?.get(name);
@@ -5879,7 +5957,7 @@ function showAt(dir, rev, file) {
5879
5957
  function configAtBase(root, base, explicitFile) {
5880
5958
  const mergeBase = git3(root, ["merge-base", base, "HEAD"])?.trim();
5881
5959
  if (!mergeBase) return null;
5882
- const candidates = explicitFile ? [{ dir: path20.dirname(explicitFile), file: path20.basename(explicitFile), explicit: true }] : [
5960
+ const candidates = explicitFile ? [{ dir: path21.dirname(explicitFile), file: path21.basename(explicitFile), explicit: true }] : [
5883
5961
  { dir: root, file: "genesis.config.json", explicit: false },
5884
5962
  { dir: root, file: "package.json", explicit: false }
5885
5963
  ];
@@ -5991,7 +6069,7 @@ async function checkContracts(ctx, read2 = postgresContract) {
5991
6069
  const env = settings.databaseEnv ?? DEFAULT_DATABASE_ENV;
5992
6070
  let current = null;
5993
6071
  try {
5994
- current = lf(readFileSync(path20.join(ctx.root, out), "utf8"));
6072
+ current = lf(readFileSync(path21.join(ctx.root, out), "utf8"));
5995
6073
  } catch {
5996
6074
  current = null;
5997
6075
  }
@@ -6015,7 +6093,7 @@ async function checkContracts(ctx, read2 = postgresContract) {
6015
6093
  ctx.report({ rule: "contracts-stale", level: generation ? "error" : "warn", file: out, message: generation ? `couldn't be generated: ${message}` : `couldn't read the database through ${env}: ${message}` });
6016
6094
  return;
6017
6095
  }
6018
- const target = path20.relative(process.cwd(), path20.join(ctx.root, out)) || out;
6096
+ const target = path21.relative(process.cwd(), path21.join(ctx.root, out)) || out;
6019
6097
  const command = `genesis introspect -o ${shellArg(target)} -s ${shellArg(schemas.join(","))}${env === DEFAULT_DATABASE_ENV ? "" : ` --database-env ${shellArg(env)}`}`;
6020
6098
  if (current !== expected) {
6021
6099
  ctx.report({
@@ -6029,7 +6107,7 @@ var GENESIS_DOCS = "https://github.com/marktiderman/genesis/blob/main/docs";
6029
6107
  var CORE = [
6030
6108
  {
6031
6109
  need: "anything, before building it",
6032
- use: 'search what exists: `genesis features find <term>`, this catalog, and the doctor\'s "Available but unused" list',
6110
+ use: 'search what exists: `genesis features find <term>`, this catalog, and the "Available but unused" list in `genesis doctor --verbose`',
6033
6111
  docs: `${GENESIS_DOCS}/FRAMEWORK.md`,
6034
6112
  from: "genesis-cli"
6035
6113
  },
@@ -6158,8 +6236,8 @@ function currentAgentsBlock(agents) {
6158
6236
  var read = (file) => existsSync(file) ? readFileSync(file, "utf8") : null;
6159
6237
  function agentGuideState(root, packages, agentsFile = "AGENTS.md") {
6160
6238
  const rows = primitivesCatalog(packages);
6161
- const skill = read(path20.join(root, SKILL_PATH))?.replace(/\r\n/g, "\n") ?? null;
6162
- const block = currentAgentsBlock(read(path20.join(root, agentsFile)));
6239
+ const skill = read(path21.join(root, SKILL_PATH))?.replace(/\r\n/g, "\n") ?? null;
6240
+ const block = currentAgentsBlock(read(path21.join(root, agentsFile)));
6163
6241
  return {
6164
6242
  skill: skill === null ? "missing" : skill === renderSkill(rows) ? "ok" : "stale",
6165
6243
  agents: block === null || block === "broken" ? block ?? "missing" : block === renderAgentsBlock(rows) ? "ok" : "stale"
@@ -6181,36 +6259,14 @@ function checkAgentGuide(ctx) {
6181
6259
  ctx.report({ rule: "agent-guide-stale", level: "warn", file: "AGENTS.md", message });
6182
6260
  }
6183
6261
  }
6184
- var CLI = "@marktiderman/genesis-cli";
6185
- function ownedKeyProblem(key2, source, localNames = /* @__PURE__ */ new Set()) {
6186
- let parsed;
6187
- try {
6188
- parsed = parseSource(source);
6189
- } catch (err) {
6190
- return err instanceof Error ? err.message : String(err);
6191
- }
6192
- const { package: pkg, path: rel } = parsed;
6193
- if (!GENESIS_PACKAGE.test(pkg) && !localNames.has(pkg)) return `${key2}'s source ${pkg} isn't a Genesis or local package`;
6194
- if (!safeRelative(rel) || !safeRelative(key2)) return `${key2} or its source isn't a plain path`;
6195
- if (key2.startsWith("supabase/migrations/")) return `${key2} is a migration; migrations are never refreshed`;
6196
- const base = rel.split("/").pop();
6197
- if (pkg === CLI && rel.startsWith("templates/")) {
6198
- return /^(eas\.json|\.eas\/[\w./-]+|\.maestro\/[\w./-]+|\.github\/workflows\/[\w.-]+\.ya?ml)$/.test(key2) ? null : `${key2} isn't where a template goes`;
6199
- }
6200
- const fn = /^functions\/([a-z0-9][a-z0-9_-]*)\/([A-Za-z0-9][A-Za-z0-9._-]*)$/.exec(rel);
6201
- if (fn) return key2 === `supabase/functions/${fn[1]}/${fn[2]}` ? null : `${key2} isn't where ${rel} goes`;
6202
- if (/\.test\.sql$/.test(base)) return key2 === `supabase/tests/database/${base.replace(/^\d{4}_/, "")}` ? null : `${key2} isn't where ${rel} goes`;
6203
- if (/^\.claude\/skills\/[a-z0-9][a-z0-9_-]*\/[A-Za-z0-9][A-Za-z0-9._-]*$/.test(key2) && key2.endsWith(`/${base}`)) return null;
6204
- return `${key2} doesn't match its source ${source}`;
6205
- }
6206
6262
 
6207
6263
  // src/blocks/templates.ts
6208
6264
  function starterDir() {
6209
6265
  const workspace = workspacePackagesDir();
6210
- const live = workspace && path20.join(workspace, "..", "apps", "genesis-rn-starter");
6211
- if (live && existsSync(path20.join(live, "package.json"))) return live;
6212
- const packaged = path20.join(cliPackageDir(), "dist", "starter");
6213
- if (existsSync(path20.join(packaged, "package.json"))) return packaged;
6266
+ const live = workspace && path21.join(workspace, "..", "apps", "genesis-rn-starter");
6267
+ if (live && existsSync(path21.join(live, "package.json"))) return live;
6268
+ const packaged = path21.join(cliPackageDir(), "dist", "starter");
6269
+ if (existsSync(path21.join(packaged, "package.json"))) return packaged;
6214
6270
  throw new Error("This genesis-cli has no starter (dist/starter is missing): reinstall @marktiderman/genesis-cli.");
6215
6271
  }
6216
6272
 
@@ -6284,7 +6340,7 @@ function readText(file) {
6284
6340
  }
6285
6341
  function starterBlockMap(root) {
6286
6342
  if (root) {
6287
- const file = path20.join(root, GENESIS_CONFIG);
6343
+ const file = path21.join(root, GENESIS_CONFIG);
6288
6344
  const text2 = readText(file);
6289
6345
  const own = text2 === null ? null : parseStarterBlocks(text2, file);
6290
6346
  if (own) return own;
@@ -6295,7 +6351,7 @@ function starterBlockMap(root) {
6295
6351
  } catch {
6296
6352
  return {};
6297
6353
  }
6298
- const text = readText(path20.join(dir, GENESIS_CONFIG));
6354
+ const text = readText(path21.join(dir, GENESIS_CONFIG));
6299
6355
  return (text === null ? null : parseStarterBlocks(text)) ?? {};
6300
6356
  }
6301
6357
  function blocksSwitchedOff(switches, map, manifests, present) {
@@ -6315,10 +6371,10 @@ function blocksSwitchedOff(switches, map, manifests, present) {
6315
6371
  return off;
6316
6372
  }
6317
6373
  function appBlocksSwitchedOff(root, manifests, present) {
6318
- const text = readText(path20.join(root, STARTER_CONFIG));
6374
+ const text = readText(path21.join(root, STARTER_CONFIG));
6319
6375
  const switches = text === null ? null : parseStarterFeatures(text);
6320
6376
  if (!switches) return /* @__PURE__ */ new Map();
6321
- return blocksSwitchedOff(switches, starterBlockMap(existsSync(path20.join(root, GENESIS_CONFIG)) ? root : void 0), manifests, present);
6377
+ return blocksSwitchedOff(switches, starterBlockMap(existsSync(path21.join(root, GENESIS_CONFIG)) ? root : void 0), manifests, present);
6322
6378
  }
6323
6379
  function blockOfSource(source, manifests) {
6324
6380
  const at = source.indexOf(":");
@@ -6331,6 +6387,34 @@ function blockOfSource(source, manifests) {
6331
6387
  }
6332
6388
  return null;
6333
6389
  }
6390
+
6391
+ // src/blocks/app-folder.ts
6392
+ function appFolderOf(root) {
6393
+ return readGenesisConfig(root)?.appFolder ?? null;
6394
+ }
6395
+ var isRepositoryWorkflow = (rel) => rel.startsWith(".github/workflows/");
6396
+ var CLI = "@marktiderman/genesis-cli";
6397
+ function ownedKeyProblem(key2, source, localNames = /* @__PURE__ */ new Set()) {
6398
+ let parsed;
6399
+ try {
6400
+ parsed = parseSource(source);
6401
+ } catch (err) {
6402
+ return err instanceof Error ? err.message : String(err);
6403
+ }
6404
+ const { package: pkg, path: rel } = parsed;
6405
+ if (!GENESIS_PACKAGE.test(pkg) && !localNames.has(pkg)) return `${key2}'s source ${pkg} isn't a Genesis or local package`;
6406
+ if (!safeRelative(rel) || !safeRelative(key2)) return `${key2} or its source isn't a plain path`;
6407
+ if (key2.startsWith("supabase/migrations/")) return `${key2} is a migration; migrations are never refreshed`;
6408
+ const base = rel.split("/").pop();
6409
+ if (pkg === CLI && rel.startsWith("templates/")) {
6410
+ return /^(eas\.json|\.eas\/[\w./-]+|\.maestro\/[\w./-]+|\.github\/workflows\/[\w.-]+\.ya?ml)$/.test(key2) ? null : `${key2} isn't where a template goes`;
6411
+ }
6412
+ const fn = /^functions\/([a-z0-9][a-z0-9_-]*)\/([A-Za-z0-9][A-Za-z0-9._-]*)$/.exec(rel);
6413
+ if (fn) return key2 === `supabase/functions/${fn[1]}/${fn[2]}` ? null : `${key2} isn't where ${rel} goes`;
6414
+ if (/\.test\.sql$/.test(base)) return key2 === `supabase/tests/database/${base.replace(/^\d{4}_/, "")}` ? null : `${key2} isn't where ${rel} goes`;
6415
+ if (/^\.claude\/skills\/[a-z0-9][a-z0-9_-]*\/[A-Za-z0-9][A-Za-z0-9._-]*$/.test(key2) && key2.endsWith(`/${base}`)) return null;
6416
+ return `${key2} doesn't match its source ${source}`;
6417
+ }
6334
6418
  var BUN_LOCK = "bun.lock";
6335
6419
  var GENESIS_TAIL = /(?:^|\/)(@marktiderman\/genesis(?:-[a-z0-9-]+)?)$/;
6336
6420
  var PLAIN_VERSION = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]+)?$/;
@@ -6463,21 +6547,9 @@ function staleNestedEntries(text, want = () => null) {
6463
6547
  return out;
6464
6548
  }
6465
6549
  function readBunLock(dir) {
6466
- const file = path20.join(dir, BUN_LOCK);
6550
+ const file = path21.join(dir, BUN_LOCK);
6467
6551
  return existsSync(file) ? readFileSync(file, "utf8") : null;
6468
6552
  }
6469
- function findLockfile(root) {
6470
- let dir = path20.resolve(root);
6471
- for (; ; ) {
6472
- if (existsSync(path20.join(dir, "pnpm-lock.yaml"))) return { pm: "pnpm", dir };
6473
- if (existsSync(path20.join(dir, "bun.lock")) || existsSync(path20.join(dir, "bun.lockb"))) return { pm: "bun", dir };
6474
- if (existsSync(path20.join(dir, "yarn.lock"))) return { pm: "yarn", dir };
6475
- if (existsSync(path20.join(dir, "package-lock.json"))) return { pm: "npm", dir };
6476
- const parent = path20.dirname(dir);
6477
- if (parent === dir) return null;
6478
- dir = parent;
6479
- }
6480
- }
6481
6553
 
6482
6554
  // src/doctor/lock-files.ts
6483
6555
  function checkBunLock(ctx) {
@@ -6485,7 +6557,7 @@ function checkBunLock(ctx) {
6485
6557
  if (found?.pm !== "bun") return;
6486
6558
  const text = readBunLock(found.dir);
6487
6559
  if (text === null) return;
6488
- const file = path20.relative(ctx.root, path20.join(found.dir, BUN_LOCK)).split(path20.sep).join("/");
6560
+ const file = path21.relative(ctx.root, path21.join(found.dir, BUN_LOCK)).split(path21.sep).join("/");
6489
6561
  let stale;
6490
6562
  try {
6491
6563
  stale = staleNestedEntries(text);
@@ -6504,7 +6576,7 @@ function checkBunLock(ctx) {
6504
6576
  }
6505
6577
  async function checkLockFiles(ctx) {
6506
6578
  checkBunLock(ctx);
6507
- if (!existsSync(path20.join(ctx.root, LOCK_FILE))) return;
6579
+ if (!existsSync(path21.join(ctx.root, LOCK_FILE))) return;
6508
6580
  let lock;
6509
6581
  try {
6510
6582
  lock = readLock(ctx.root);
@@ -6537,6 +6609,11 @@ async function checkLockFiles(ctx) {
6537
6609
  home = databaseElsewhere(ctx.root);
6538
6610
  } catch {
6539
6611
  }
6612
+ let appFolder = null;
6613
+ try {
6614
+ appFolder = appFolderOf(ctx.root);
6615
+ } catch {
6616
+ }
6540
6617
  const elsewhere = home ? Object.keys(lock.files).filter(isSupabasePath) : [];
6541
6618
  if (home && elsewhere.length) {
6542
6619
  ctx.report({
@@ -6572,6 +6649,7 @@ async function checkLockFiles(ctx) {
6572
6649
  }
6573
6650
  if (text === null) {
6574
6651
  if (entry.deleted) continue;
6652
+ if (appFolder && isRepositoryWorkflow(rel)) continue;
6575
6653
  ctx.report({
6576
6654
  rule: "lock-files",
6577
6655
  level: "warn",
@@ -6606,7 +6684,7 @@ function checkDatabaseHome(ctx) {
6606
6684
  message: `supabase.app is ${home.app}, which has no supabase folder; name the app that holds this app's database (its migrations, tests and Edge Functions)`
6607
6685
  });
6608
6686
  }
6609
- if (existsSync(path20.join(ctx.root, "supabase"))) {
6687
+ if (existsSync(path21.join(ctx.root, "supabase"))) {
6610
6688
  ctx.report({
6611
6689
  rule: "database-elsewhere",
6612
6690
  level: "warn",
@@ -6624,7 +6702,7 @@ function checkEslintConfig(ctx) {
6624
6702
  if (!file) return;
6625
6703
  let text;
6626
6704
  try {
6627
- text = readFileSync(path20.join(ctx.root, file), "utf8");
6705
+ text = readFileSync(path21.join(ctx.root, file), "utf8");
6628
6706
  } catch {
6629
6707
  return;
6630
6708
  }
@@ -6644,11 +6722,352 @@ function checkEslintConfig(ctx) {
6644
6722
  subject: TESTING_LIBRARY,
6645
6723
  message: `${file} loads Genesis's native lint rules, which need ${TESTING_LIBRARY}: add it to devDependencies (pnpm add -D ${TESTING_LIBRARY}), or the lint can't load its config`
6646
6724
  });
6725
+ } else if (!findPackageDir(ctx.root, TESTING_LIBRARY)) {
6726
+ ctx.report({
6727
+ rule: "genesis-eslint-config",
6728
+ level: "warn",
6729
+ file: "package.json",
6730
+ subject: TESTING_LIBRARY,
6731
+ message: `lists ${TESTING_LIBRARY}, which ${file} needs, but it isn't installed, so the lint can't load its config: run ${shellLine(installCommand(detectPackageManager(ctx.root)))}`
6732
+ });
6733
+ }
6734
+ }
6735
+ var FigmaConfigError = class extends Error {
6736
+ };
6737
+ function validateFigmaConfig(raw, source = "genesis.config.json") {
6738
+ const obj = raw;
6739
+ if (!obj || typeof obj !== "object" || Array.isArray(obj)) throw new FigmaConfigError(`${source}: figma must be an object`);
6740
+ if (typeof obj.file !== "string" || !/^[A-Za-z0-9]+$/.test(obj.file)) throw new FigmaConfigError(`${source}: figma.file must be the file key (letters and digits, from the file's URL)`);
6741
+ const pages = obj.pages;
6742
+ if (!pages || typeof pages !== "object" || Array.isArray(pages)) throw new FigmaConfigError(`${source}: figma.pages must be { "web"?: "<page>", "native"?: "<page>" }`);
6743
+ const out = {};
6744
+ for (const [k, v] of Object.entries(pages)) {
6745
+ if (k !== "web" && k !== "native") throw new FigmaConfigError(`${source}: figma.pages.${k}: only "web" and "native"`);
6746
+ if (typeof v !== "string" || !v) throw new FigmaConfigError(`${source}: figma.pages.${k} must be a page name`);
6747
+ out[k] = v;
6748
+ }
6749
+ if (!out.web && !out.native) throw new FigmaConfigError(`${source}: figma.pages needs "web" or "native"`);
6750
+ if (obj.proposalsPage !== void 0 && (typeof obj.proposalsPage !== "string" || !obj.proposalsPage)) throw new FigmaConfigError(`${source}: figma.proposalsPage must be a page name`);
6751
+ return { file: obj.file, pages: out, proposalsPage: obj.proposalsPage ?? "Proposals" };
6752
+ }
6753
+ function readFigmaConfig(root) {
6754
+ const file = path21.join(root, "genesis.config.json");
6755
+ if (!existsSync(file)) return null;
6756
+ let raw;
6757
+ try {
6758
+ raw = JSON.parse(readFileSync(file, "utf8"));
6759
+ } catch (err) {
6760
+ throw new FigmaConfigError(`${file} isn't valid JSON: ${err.message}`);
6761
+ }
6762
+ return raw?.figma === void 0 ? null : validateFigmaConfig(raw.figma, file);
6763
+ }
6764
+ var CODE = /\.(?:tsx|ts|jsx|js)$/;
6765
+ var FIGMA_ID = /^\s*\/\/\s*figma:\s*(\d+[:-]\d+)\s*$/;
6766
+ function walk2(dir, out = []) {
6767
+ if (!existsSync(dir)) return out;
6768
+ for (const name of readdirSync(dir).sort()) {
6769
+ if (name === "node_modules" || name.startsWith(".")) continue;
6770
+ const full = path21.join(dir, name);
6771
+ if (statSync(full).isDirectory()) walk2(full, out);
6772
+ else if (CODE.test(name) && !/\.(?:test|spec|d)\.[jt]sx?$/.test(name)) out.push(full);
6773
+ }
6774
+ return out;
6775
+ }
6776
+ function figmaIdOf(code) {
6777
+ for (const line of code.split("\n").slice(0, 5)) {
6778
+ const m = FIGMA_ID.exec(line);
6779
+ if (m) return m[1].replace("-", ":");
6780
+ }
6781
+ return void 0;
6782
+ }
6783
+ function tanstackSegments(stem) {
6784
+ const out = [];
6785
+ let cur = "";
6786
+ let depth = 0;
6787
+ for (const ch of stem) {
6788
+ if (ch === "{") depth++;
6789
+ if (ch === "}") depth--;
6790
+ if (ch === "." && depth === 0) {
6791
+ out.push(cur);
6792
+ cur = "";
6793
+ } else cur += ch;
6794
+ }
6795
+ out.push(cur);
6796
+ return out;
6797
+ }
6798
+ function expoRoot(root) {
6799
+ for (const dir of ["src/app", "app"]) if (existsSync(path21.join(root, dir))) return dir;
6800
+ return null;
6801
+ }
6802
+ function appRoutes(root) {
6803
+ const out = [];
6804
+ const rel = (f) => path21.relative(root, f).split(path21.sep).join("/");
6805
+ const expo = expoRoot(root);
6806
+ if (expo) {
6807
+ for (const f of walk2(path21.join(root, expo))) {
6808
+ const parts = path21.relative(path21.join(root, expo), f).split(path21.sep);
6809
+ const stem = parts.pop().replace(CODE, "");
6810
+ if (stem === "_layout" || stem.startsWith("+")) continue;
6811
+ if (stem !== "index") parts.push(stem);
6812
+ out.push(withId({ route: parts.join("/") || "index", platform: "native", file: rel(f) }, f));
6813
+ }
6814
+ }
6815
+ const tanstack = path21.join(root, "src/routes");
6816
+ if (existsSync(tanstack)) {
6817
+ const seen = /* @__PURE__ */ new Set();
6818
+ for (const f of walk2(tanstack)) {
6819
+ const parts = path21.relative(tanstack, f).split(path21.sep);
6820
+ const stem = parts.pop().replace(CODE, "").replace(/\.lazy$/, "");
6821
+ if (stem === "__root" || stem === "route" || stem.startsWith("-") || parts.some((p) => p.startsWith("-"))) continue;
6822
+ const segs = [...parts.flatMap(tanstackSegments), ...tanstackSegments(stem)];
6823
+ if (segs.at(-1) === "index") segs.pop();
6824
+ const route = segs.join("/") || "index";
6825
+ if (seen.has(route)) continue;
6826
+ seen.add(route);
6827
+ out.push(withId({ route, platform: "web", file: rel(f) }, f));
6828
+ }
6829
+ }
6830
+ return out;
6831
+ }
6832
+ function withId(r, file) {
6833
+ const id = figmaIdOf(readFileSync(file, "utf8"));
6834
+ return id ? { ...r, figmaId: id } : r;
6835
+ }
6836
+ function urlSegments(route) {
6837
+ return route.replace(/^\/+/, "").split("/").filter((s) => s && s !== "index" && !/^\(.*\)$/.test(s) && !/^_/.test(s)).map((s) => s.replace(/_$/, "")).map((s) => /^\{-\$.*\}$/.test(s) ? "?" : /^\[\.\.\..+\]$/.test(s) ? "**" : /^\$|^\[.*\]$/.test(s) ? "*" : s);
6838
+ }
6839
+ function routeMatches(route, target) {
6840
+ const pattern = urlSegments(route);
6841
+ const url = target.split(/[?#]/)[0].split("/").filter(Boolean);
6842
+ if (/(?:^|\/)\$$/.test(route)) {
6843
+ const head = pattern.slice(0, -1);
6844
+ return url.length >= head.length && head.every((p, i) => p === "*" || p === url[i]);
6845
+ }
6846
+ const go = (i, j) => {
6847
+ if (i === pattern.length) return j === url.length;
6848
+ const p = pattern[i];
6849
+ if (p === "?") return go(i + 1, j) || j < url.length && go(i + 1, j + 1);
6850
+ if (j === url.length) return false;
6851
+ if (p === "**") {
6852
+ for (let k = j + 1; k <= url.length; k++) if (go(i + 1, k)) return true;
6853
+ return false;
6854
+ }
6855
+ return (p === "*" || p === url[j]) && go(i + 1, j + 1);
6856
+ };
6857
+ return go(0, 0);
6858
+ }
6859
+ function sameScreen(a, b) {
6860
+ return a.replace(/^\/+/, "") === b.replace(/^\/+/, "") || urlSegments(a).join("/") === urlSegments(b).join("/");
6861
+ }
6862
+ var STR = String.raw`(?:"([^"\n]*)"|'([^'\n]*)'|` + "`([^`$\\n]*)`)";
6863
+ var NAV_PATTERNS = [
6864
+ new RegExp(String.raw`\brouter\.(?:push|replace|navigate)\(\s*` + STR, "g"),
6865
+ new RegExp(String.raw`<Link\b[^>]*?\b(?:href|to)=\{?\s*` + STR, "g"),
6866
+ new RegExp(String.raw`\bnavigate\(\s*\{[^}]*?\bto\s*:\s*` + STR, "g")
6867
+ ];
6868
+ var DYNAMIC_PATTERNS = [
6869
+ new RegExp(String.raw`\brouter\.(?:push|replace|navigate)\(\s*` + "(`[^`\\n]*\\$\\{[^`\\n]*`)", "g"),
6870
+ new RegExp(String.raw`<Link\b[^>]*?\b(?:href|to)=\{\s*` + "(`[^`\\n]*\\$\\{[^`\\n]*`)", "g"),
6871
+ new RegExp(String.raw`\bnavigate\(\s*\{[^}]*?\bto\s*:\s*` + "(`[^`\\n]*\\$\\{[^`\\n]*`)", "g"),
6872
+ new RegExp(String.raw`\brouter\.(?:push|replace|navigate)\(\s*(\{[^}\n]*?\bpathname\b[^}\n]*\}?)`, "g"),
6873
+ new RegExp(String.raw`<Link\b[^>]*?\bhref=\{(\{[^}\n]*?\bpathname\b[^}\n]*\}?)`, "g")
6874
+ ];
6875
+ function dynamicNavTargets(code, file) {
6876
+ const out = [];
6877
+ for (const re of DYNAMIC_PATTERNS) {
6878
+ for (const m of code.matchAll(re)) {
6879
+ const raw = m[1].trim();
6880
+ out.push({ file, line: code.slice(0, m.index).split("\n").length, target: raw.length > 60 ? `${raw.slice(0, 57)}...` : raw });
6881
+ }
6882
+ }
6883
+ return out.sort((a, b) => a.line - b.line);
6884
+ }
6885
+ function navTargets(code, file) {
6886
+ const out = [];
6887
+ for (const re of NAV_PATTERNS) {
6888
+ for (const m of code.matchAll(re)) {
6889
+ const target = m[1] ?? m[2] ?? m[3];
6890
+ if (target === void 0 || /^[a-z]+:/i.test(target) || target.startsWith("#") || target.startsWith(".")) continue;
6891
+ out.push({ file, line: code.slice(0, m.index).split("\n").length, target });
6892
+ }
6893
+ }
6894
+ return out.sort((a, b) => a.line - b.line);
6895
+ }
6896
+ function appNavTargets(root) {
6897
+ const files = [.../* @__PURE__ */ new Set([...walk2(path21.join(root, "src")), ...walk2(path21.join(root, "app"))])];
6898
+ return files.flatMap((f) => navTargets(readFileSync(f, "utf8"), path21.relative(root, f).split(path21.sep).join("/")));
6899
+ }
6900
+ function appDynamicNavTargets(root) {
6901
+ const files = [.../* @__PURE__ */ new Set([...walk2(path21.join(root, "src")), ...walk2(path21.join(root, "app"))])];
6902
+ return files.flatMap((f) => dynamicNavTargets(readFileSync(f, "utf8"), path21.relative(root, f).split(path21.sep).join("/")));
6903
+ }
6904
+ var FIGMA_API = "https://api.figma.com";
6905
+ var FIGMA_TIMEOUT_MS = 3e4;
6906
+ function splitName(name) {
6907
+ const i = name.indexOf(" \xB7 ");
6908
+ return i < 0 ? { route: name.trim() } : { route: name.slice(0, i).trim(), state: name.slice(i + 3).trim() };
6909
+ }
6910
+ function destinations(node, out = /* @__PURE__ */ new Set()) {
6911
+ if (node.transitionNodeID) out.add(node.transitionNodeID);
6912
+ for (const i of node.interactions ?? []) {
6913
+ for (const a of i.actions ?? []) if (a?.type === "NODE" && a.destinationId && a.navigation !== "CHANGE_TO") out.add(a.destinationId);
6914
+ }
6915
+ for (const c of node.children ?? []) destinations(c, out);
6916
+ return out;
6917
+ }
6918
+ var SCREEN_TYPES = /* @__PURE__ */ new Set(["FRAME", "COMPONENT", "COMPONENT_SET", "INSTANCE"]);
6919
+ async function readFigma(config, token, fetchImpl = fetch, timeoutMs = FIGMA_TIMEOUT_MS) {
6920
+ const get2 = async (p) => {
6921
+ const where2 = p.split("?")[0];
6922
+ try {
6923
+ const res = await fetchImpl(`${FIGMA_API}${p}`, { headers: { "X-Figma-Token": token }, signal: AbortSignal.timeout(timeoutMs) });
6924
+ if (!res.ok) throw new Error(`Figma API ${where2} answered ${res.status}${res.status === 403 ? " (check FIGMA_ACCESS_TOKEN and its access to the file)" : ""}`);
6925
+ return await res.json();
6926
+ } catch (err) {
6927
+ const name = err?.name;
6928
+ if (name === "TimeoutError" || name === "AbortError") throw new Error(`Figma API ${where2} didn't answer within ${Math.round(timeoutMs / 1e3)}s`);
6929
+ throw err;
6930
+ }
6931
+ };
6932
+ const nodes = async (ids, depth) => {
6933
+ const out = [];
6934
+ for (let i = 0; i < ids.length; i += 50) {
6935
+ const chunk = ids.slice(i, i + 50);
6936
+ const body = await get2(`/v1/files/${config.file}/nodes?ids=${encodeURIComponent(chunk.join(","))}${depth ? `&depth=${depth}` : ""}`);
6937
+ for (const id of chunk) {
6938
+ const doc = body.nodes[id]?.document;
6939
+ if (doc) out.push(doc);
6940
+ }
6941
+ }
6942
+ return out;
6943
+ };
6944
+ const file = await get2(`/v1/files/${config.file}?depth=2`);
6945
+ const canvases = file.document.children ?? [];
6946
+ const wanted = /* @__PURE__ */ new Set([...Object.values(config.pages), config.proposalsPage]);
6947
+ const frames = [];
6948
+ const sections = [];
6949
+ for (const page of canvases) {
6950
+ if (!wanted.has(page.name)) continue;
6951
+ for (const child of page.children ?? []) {
6952
+ if (child.type === "SECTION") sections.push({ id: child.id, name: child.name, page: page.name });
6953
+ else if (SCREEN_TYPES.has(child.type)) frames.push({ id: child.id, name: child.name, page: page.name, ...splitName(child.name) });
6954
+ }
6955
+ }
6956
+ for (const s of await nodes(sections.map((x) => x.id), 1)) {
6957
+ const section2 = sections.find((x) => x.id === s.id);
6958
+ for (const child of s.children ?? []) {
6959
+ if (SCREEN_TYPES.has(child.type)) frames.push({ id: child.id, name: child.name, page: section2.page, section: section2.name, ...splitName(child.name) });
6960
+ }
6961
+ }
6962
+ const hotspots = [];
6963
+ for (const tree of await nodes(frames.filter((f) => f.page !== config.proposalsPage).map((f) => f.id))) {
6964
+ for (const to of destinations(tree)) if (to !== tree.id) hotspots.push({ from: tree.id, to });
6965
+ }
6966
+ return { pages: canvases.map((p) => p.name), frames, hotspots };
6967
+ }
6968
+ function compare(config, routes, targets, figma, dynamicTargets = []) {
6969
+ const platformOf = (page) => config.pages.web === page ? "web" : config.pages.native === page ? "native" : void 0;
6970
+ const routeFrames = figma.frames.filter((f) => platformOf(f.page));
6971
+ const framesFor = (r) => routeFrames.filter((f) => platformOf(f.page) === r.platform && (sameScreen(f.route, r.route) || r.route === "index" && f.route === "/"));
6972
+ const byId = new Map(figma.frames.map((f) => [f.id, f]));
6973
+ const framed = new Set(routes.flatMap((r) => framesFor(r).map((f) => f.id)));
6974
+ const covered = routes.filter((r) => framesFor(r).length > 0);
6975
+ const routesWithoutFrame = routes.filter((r) => framesFor(r).length === 0);
6976
+ const framesWithoutRoute = routeFrames.filter((f) => !framed.has(f.id));
6977
+ const proposals = {};
6978
+ for (const f of figma.frames.filter((x) => x.page === config.proposalsPage)) (proposals[f.section ?? "(no section)"] ??= []).push(f);
6979
+ const missingHotspots = [];
6980
+ const seen = /* @__PURE__ */ new Set();
6981
+ for (const t of targets) {
6982
+ const source = routes.find((r) => r.file === t.file);
6983
+ if (!source) continue;
6984
+ const from = framesFor(source);
6985
+ if (!from.length) continue;
6986
+ const dest = routes.find((r) => r.platform === source.platform && routeMatches(r.route, t.target));
6987
+ if (!dest || dest === source) continue;
6988
+ const key2 = `${source.route}\u2192${dest.route}`;
6989
+ if (seen.has(key2)) continue;
6990
+ seen.add(key2);
6991
+ const to = new Set(framesFor(dest).map((f) => f.id));
6992
+ const linked = figma.hotspots.some((h) => from.some((f) => f.id === h.from) && to.has(h.to));
6993
+ if (!linked) missingHotspots.push({ ...t, from: source.route, to: dest.route, targetHasFrame: to.size > 0 });
6994
+ }
6995
+ const deadHotspots = [];
6996
+ for (const h of figma.hotspots) {
6997
+ const from = byId.get(h.from);
6998
+ const to = byId.get(h.to);
6999
+ if (from && to && platformOf(to.page) && !framed.has(to.id)) deadHotspots.push({ from, to });
7000
+ }
7001
+ const idMismatches = routes.filter((r) => r.figmaId && !framesFor(r).some((f) => f.id === r.figmaId)).map((r) => ({ ...r, frames: framesFor(r).map((f) => f.id) }));
7002
+ const wantedPages = [...Object.values(config.pages), config.proposalsPage];
7003
+ const missingPages = wantedPages.filter((p) => !figma.pages.includes(p));
7004
+ const uncheckedNavigation = dynamicTargets.filter((t) => routes.some((r) => r.file === t.file));
7005
+ return {
7006
+ file: config.file,
7007
+ summary: {
7008
+ routes: routes.length,
7009
+ frames: routeFrames.length,
7010
+ covered: covered.length,
7011
+ coveredPercent: routes.length ? Math.round(covered.length / routes.length * 100) : 100,
7012
+ hotspots: figma.hotspots.length,
7013
+ missing: missingPages.length + routesWithoutFrame.length + missingHotspots.length + idMismatches.length
7014
+ },
7015
+ missingPages,
7016
+ routesWithoutFrame,
7017
+ framesWithoutRoute,
7018
+ proposals,
7019
+ missingHotspots,
7020
+ deadHotspots,
7021
+ idMismatches,
7022
+ uncheckedNavigation
7023
+ };
7024
+ }
7025
+ async function checkFigmaRoutes(options) {
7026
+ const config = options.config ?? readFigmaConfig(options.root);
7027
+ if (!config) throw new FigmaConfigError(`no "figma" block in ${path21.join(options.root, "genesis.config.json")}`);
7028
+ const token = options.token ?? process.env.FIGMA_ACCESS_TOKEN;
7029
+ if (!token) throw new FigmaConfigError("FIGMA_ACCESS_TOKEN isn't set");
7030
+ const figma = await readFigma(config, token, options.fetch);
7031
+ return compare(config, appRoutes(options.root), appNavTargets(options.root), figma, appDynamicNavTargets(options.root));
7032
+ }
7033
+ function coverageFindings(r, strict) {
7034
+ const gap = strict ? "warn" : "info";
7035
+ return [
7036
+ ...r.missingPages.map((p) => ({ level: gap, file: `figma:${p}`, message: `the Figma file has no page "${p}" (named in genesis.config.json figma)`, subject: p })),
7037
+ ...r.routesWithoutFrame.map((x) => ({ level: gap, file: x.file, message: `route ${x.route} has no ${x.platform} frame in the Figma file`, subject: x.route })),
7038
+ ...r.missingHotspots.map((m) => ({ level: gap, file: m.file, line: m.line, message: `navigates to ${m.to}, but the ${m.from} frame has no hotspot to it${m.targetHasFrame ? "" : " (and it has no frame)"}`, subject: m.to })),
7039
+ ...r.idMismatches.map((m) => ({ level: gap, file: m.file, line: 1, message: `// figma: ${m.figmaId} isn't the frame named ${m.route} (${m.frames.join(", ") || "none"})`, subject: m.route })),
7040
+ ...r.framesWithoutRoute.map((f) => ({ level: "info", file: `figma:${f.page}`, message: `frame "${f.name}" (${f.id}) has no route: move it to Proposals, or add the route`, subject: f.route })),
7041
+ ...r.deadHotspots.map((d) => ({ level: "info", file: `figma:${d.from.page}`, message: `"${d.from.name}" links to "${d.to.name}", which has no route`, subject: d.to.route })),
7042
+ ...r.uncheckedNavigation.map((t) => ({ level: "info", file: t.file, line: t.line, message: `navigation to ${t.target} isn't a string literal, so it isn't checked against the Figma file`, subject: t.target }))
7043
+ ];
7044
+ }
7045
+
7046
+ // src/doctor/figma-routes.ts
7047
+ async function checkFigmaRoutesRule(ctx) {
7048
+ let config;
7049
+ try {
7050
+ config = readFigmaConfig(ctx.root);
7051
+ } catch (err) {
7052
+ if (!(err instanceof FigmaConfigError)) throw err;
7053
+ ctx.report({ rule: "figma-routes", level: "warn", file: "genesis.config.json", message: err.message });
7054
+ return;
7055
+ }
7056
+ if (!config) return;
7057
+ if (!process.env.FIGMA_ACCESS_TOKEN) {
7058
+ ctx.report({ rule: "figma-routes", level: "info", file: "genesis.config.json", message: "skipped: FIGMA_ACCESS_TOKEN isn't set (CI sets it from a secret)" });
7059
+ return;
7060
+ }
7061
+ try {
7062
+ const report = await checkFigmaRoutes({ root: ctx.root, config });
7063
+ for (const f of coverageFindings(report, ctx.strict ?? false)) ctx.report({ rule: "figma-routes", ...f });
7064
+ } catch (err) {
7065
+ ctx.report({ rule: "figma-routes", level: "info", file: "genesis.config.json", message: `skipped: ${err.message}` });
6647
7066
  }
6648
7067
  }
6649
7068
  var RATCHETED_BY_DEFAULT = ["deprecated-import", "genesis-eslint-config"];
6650
7069
  async function runDoctor(options = {}) {
6651
- const root = path20.resolve(options.root ?? process.cwd());
7070
+ const root = path21.resolve(options.root ?? process.cwd());
6652
7071
  const loaded = options.config ? { config: options.config, dir: root } : loadConfig(root, options.configPath);
6653
7072
  const config = loaded.config;
6654
7073
  const genesis = options.genesis ?? loadGenesis(root, config);
@@ -6663,7 +7082,7 @@ async function runDoctor(options = {}) {
6663
7082
  }
6664
7083
  const raw = [];
6665
7084
  const ctx = { root, files, genesis, config, packages, ...options.base ? { base: options.base } : {}, ...options.strict ? { strict: true } : {}, report: (f) => raw.push(f) };
6666
- for (const plugin of [...builtinChecks(config, { contracts: options.contracts ?? true }), ...packagePlugins, ...patterns ? [patterns.plugin] : [], ...plugins]) {
7085
+ for (const plugin of [...builtinChecks(config, { contracts: options.contracts ?? true, figma: options.figma ?? true }), ...packagePlugins, ...patterns ? [patterns.plugin] : [], ...plugins]) {
6667
7086
  try {
6668
7087
  await plugin.check(ctx);
6669
7088
  } catch (err) {
@@ -6702,7 +7121,7 @@ async function runDoctor(options = {}) {
6702
7121
  }
6703
7122
  let findings = applyConfig(raw, config, packageRuleIds(packages));
6704
7123
  if (options.base && changed) {
6705
- findings = applyRatchet(findings, { config, newOnly, changed, base: options.base, isAppPath: (f) => existsSync(path20.join(root, f)) });
7124
+ findings = applyRatchet(findings, { config, newOnly, changed, base: options.base, isAppPath: (f) => existsSync(path21.join(root, f)) });
6706
7125
  }
6707
7126
  const errors = findings.filter((f) => f.level === "error").length;
6708
7127
  const warnings = findings.filter((f) => f.level === "warn").length;
@@ -6751,6 +7170,7 @@ function builtinChecks(config, options = {}) {
6751
7170
  { name: "database-elsewhere", check: checkDatabaseHome },
6752
7171
  { name: "eslint-config", check: checkEslintConfig },
6753
7172
  ...(config.packs ?? []).map((p) => packs[p]),
7173
+ ...options.figma !== false ? [{ name: "figma-routes", check: checkFigmaRoutesRule }] : [],
6754
7174
  ...config.packs?.includes("supabase") && config.contracts && options.contracts !== false ? [{ name: "contracts", check: (ctx) => checkContracts(ctx) }] : []
6755
7175
  ];
6756
7176
  }
@@ -6803,7 +7223,7 @@ function applyConfig(raw, config, packageIds) {
6803
7223
  }
6804
7224
  return out.sort((x, y) => x.file.localeCompare(y.file) || x.line - y.line || x.rule.localeCompare(y.rule));
6805
7225
  }
6806
- function formatReport(result) {
7226
+ function formatReport(result, options = {}) {
6807
7227
  const g = result.genesis;
6808
7228
  const lines = [
6809
7229
  `Genesis doctor: ${g.uiPackage}@${g.uiVersion}, ${g.components.length} components, ${g.tokens.size} tokens, ${result.ruleCount} app rules; raw tags checked: ${[...g.rawTags.keys()].join(", ") || "none"}`
@@ -6811,7 +7231,7 @@ function formatReport(result) {
6811
7231
  for (const f of result.findings) {
6812
7232
  lines.push(`${f.level.toUpperCase().padEnd(5)} ${f.file}${f.line ? `:${f.line}` : ""} [${f.rule}] ${f.message}`);
6813
7233
  }
6814
- lines.push(`Available but unused (${result.unused.length}): ${result.unused.join(", ") || "none"}`);
7234
+ lines.push(options.verbose ? `Available but unused (${result.unused.length}): ${result.unused.join(", ") || "none"}` : `Available but unused: ${result.unused.length} (genesis doctor --verbose lists them)`);
6815
7235
  lines.push(`Primitives: ${result.primitives.rules} rules from ${result.primitives.packages} packages; see genesis catalog`);
6816
7236
  const info = result.infos ? `, ${result.infos} info` : "";
6817
7237
  lines.push(result.ok ? `PASS (${result.warnings} warnings${info})` : `FAIL (${result.errors} errors, ${result.warnings} warnings${info})`);
@@ -6830,7 +7250,7 @@ function genesisDoctor(options = {}) {
6830
7250
  root = options.root ?? config.root;
6831
7251
  },
6832
7252
  async buildStart() {
6833
- const result = await runDoctor({ root, configPath: options.configPath, strict: options.strict, contracts: false });
7253
+ const result = await runDoctor({ root, configPath: options.configPath, strict: options.strict, contracts: false, figma: false });
6834
7254
  if (!result.ok) this.error(`Genesis doctor found problems:
6835
7255
  ${formatProblems(result, options.strict)}`);
6836
7256
  if (result.warnings > 0) this.warn(formatReport(result));
@@ -6863,7 +7283,7 @@ ${formatProblems(result, options.strict)}`);
6863
7283
  running = true;
6864
7284
  try {
6865
7285
  genesis ??= loadGenesis(root, loadConfig(root, options.configPath).config);
6866
- const result = await runDoctor({ root, configPath: options.configPath, genesis, contracts: false });
7286
+ const result = await runDoctor({ root, configPath: options.configPath, genesis, contracts: false, figma: false });
6867
7287
  if (result.errors > 0) {
6868
7288
  showError(`Genesis doctor found problems:
6869
7289
  ${formatProblems(result)}`);
@@ -6883,15 +7303,15 @@ ${formatProblems(result)}`);
6883
7303
  }
6884
7304
  }
6885
7305
  };
6886
- const explicit = /* @__PURE__ */ new Set([path20.join(root, "genesis.config.json"), ...options.configPath ? [path20.resolve(root, options.configPath)] : []]);
7306
+ const explicit = /* @__PURE__ */ new Set([path21.join(root, "genesis.config.json"), ...options.configPath ? [path21.resolve(root, options.configPath)] : []]);
6887
7307
  try {
6888
7308
  const { config } = loadConfig(root, options.configPath);
6889
- if (config.rulesDoc) explicit.add(path20.resolve(root, config.rulesDoc));
7309
+ if (config.rulesDoc) explicit.add(path21.resolve(root, config.rulesDoc));
6890
7310
  } catch {
6891
7311
  }
6892
7312
  const schedule = (file) => {
6893
- if (!explicit.has(path20.resolve(file))) {
6894
- const rel = path20.relative(root, file).split(path20.sep).join("/");
7313
+ if (!explicit.has(path21.resolve(file))) {
7314
+ const rel = path21.relative(root, file).split(path21.sep).join("/");
6895
7315
  if (rel.startsWith("..") || rel.includes("node_modules/")) return;
6896
7316
  }
6897
7317
  clearTimeout(timer);