@warlock.js/core 5.31.0 → 5.32.0

package/esm/tooling/generate/project-files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"project-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/project-files.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  symlinkSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Which project files a generation can see and change, and how they are\n * copied, hashed and compared.\n *\n * THE SCOPE: the files at the project root plus the `src/` tree. That is where\n * every generator writes (`src/app/**`, `src/config/**`, `package.json`,\n * `warlock.config.ts`, `tsconfig.json`). `.env` files are never copied, hashed\n * or diffed: they hold secrets, and a diff is text an agent will read.\n */\n\n/** Directory names never entered anywhere. */\nconst SKIPPED_DIRECTORIES = new Set([\".git\", \"node_modules\"]);\n\n/** Root directories outside the scope that a sandbox still never copies (listed for the walk of a sandbox). */\nconst SKIPPED_ROOT_DIRECTORIES = new Set([\n  \".git\",\n  \"node_modules\",\n  \".warlock\",\n  \"dist\",\n  \"storage\",\n  \"public\",\n  \"coverage\",\n]);\n\n/** Whether a file name is an env file (`.env`, `.env.local`, `.env.production`…). */\nexport function isEnvFile(name: string): boolean {\n  return name === \".env\" || name.startsWith(\".env.\");\n}\n\n/** A file's content hash, keyed by project-relative POSIX path. */\nexport type FileSnapshot = Map<string, string>;\n\nfunction toPosix(relative: string): string {\n  return relative.split(path.sep).join(\"/\");\n}\n\nfunction hashFile(file: string): string {\n  return createHash(\"sha256\").update(readFileSync(file)).digest(\"hex\");\n}\n\nfunction walk(\n  root: string,\n  directory: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(directory, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n      continue;\n    }\n\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, toPosix(path.relative(root, absolute)));\n    }\n  }\n}\n\n/**\n * Visit every file in the generation scope of `root`: root-level files and the\n * `src/` tree, skipping env files, symlinks, `node_modules` and `.git`.\n */\nexport function forEachScopedFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(path.join(root, entry.name), entry.name);\n    }\n  }\n\n  const source = path.join(root, \"src\");\n\n  if (existsSync(source)) walk(root, source, visit);\n}\n\n/**\n * Visit every file under `root` except env files, symlinks and the\n * {@link SKIPPED_ROOT_DIRECTORIES} — how a sandbox is read after a generator\n * ran, so a file written outside `src/` is still seen.\n */\nexport function forEachSandboxFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(root, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_ROOT_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n    } else if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, entry.name);\n    }\n  }\n}\n\n/** Hash every file the walker visits. */\nexport function snapshotFiles(\n  root: string,\n  walker: (root: string, visit: (absolute: string, relative: string) => void) => void,\n): FileSnapshot {\n  const snapshot: FileSnapshot = new Map();\n\n  walker(root, (absolute, relative) => {\n    snapshot.set(relative, hashFile(absolute));\n  });\n\n  return snapshot;\n}\n\n/**\n * Copy the generation scope of `projectRoot` into `sandboxRoot` and link the\n * project's `node_modules` into it, so `warlock.config.ts` and every package\n * resolve exactly as they do in the project. Nothing is copied from\n * `node_modules`; the link is removed with the sandbox, never followed.\n */\nexport function copyProjectScope(projectRoot: string, sandboxRoot: string): void {\n  forEachScopedFile(projectRoot, (absolute, relative) => {\n    const target = path.join(sandboxRoot, relative);\n\n    mkdirSync(path.dirname(target), { recursive: true });\n    copyFileSync(absolute, target);\n  });\n\n  const modules = path.join(projectRoot, \"node_modules\");\n\n  if (existsSync(modules)) {\n    // \"junction\" is ignored off Windows and makes the link work there without admin rights.\n    symlinkSync(modules, path.join(sandboxRoot, \"node_modules\"), \"junction\");\n  }\n}\n\n/** One file that differs between two snapshots. */\nexport type SnapshotChange = { path: string; status: \"created\" | \"modified\" | \"deleted\" };\n\n/** The files created, modified or deleted between two snapshots, sorted by path. */\nexport function compareSnapshots(before: FileSnapshot, after: FileSnapshot): SnapshotChange[] {\n  const changes: SnapshotChange[] = [];\n\n  for (const [file, hash] of after) {\n    const previous = before.get(file);\n\n    if (previous === undefined) changes.push({ path: file, status: \"created\" });\n    else if (previous !== hash) changes.push({ path: file, status: \"modified\" });\n  }\n\n  for (const file of before.keys()) {\n    if (!after.has(file)) changes.push({ path: file, status: \"deleted\" });\n  }\n\n  return changes.sort((first, second) => first.path.localeCompare(second.path));\n}\n\n/** Whether bytes look binary: a NUL in the first 8000 bytes, as git decides. */\nexport function isBinary(content: Buffer): boolean {\n  return content.subarray(0, 8000).includes(0);\n}\n"],"mappings":"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"}
+{"version":3,"file":"project-files.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/project-files.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  copyFileSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  symlinkSync,\n} from \"node:fs\";\nimport path from \"node:path\";\n\n/**\n * Which project files a generation can see and change, and how they are\n * copied, hashed and compared.\n *\n * THE SCOPE: the files at the project root plus the `src/` tree. That is where\n * every generator writes (`src/app/**`, `src/config/**`, `package.json`,\n * `warlock.config.ts`, `tsconfig.json`). `.env` files are never copied, hashed\n * or diffed: they hold secrets, and a diff is text an agent will read.\n */\n\n/** Directory names never entered anywhere. */\nconst SKIPPED_DIRECTORIES = new Set([\".git\", \"node_modules\"]);\n\n/** Root directories outside the scope that a sandbox still never copies (listed for the walk of a sandbox). */\nconst SKIPPED_ROOT_DIRECTORIES = new Set([\n  \".git\",\n  \"node_modules\",\n  \".warlock\",\n  \"dist\",\n  \"storage\",\n  \"public\",\n  \"coverage\",\n]);\n\n/** Whether a file name is an env file (`.env`, `.env.local`, `.env.production`…). */\nexport function isEnvFile(name: string): boolean {\n  return name === \".env\" || name.startsWith(\".env.\");\n}\n\n/** A file's content hash, keyed by project-relative POSIX path. */\nexport type FileSnapshot = Map<string, string>;\n\nfunction toPosix(relative: string): string {\n  return relative.split(path.sep).join(\"/\");\n}\n\nfunction hashFile(file: string): string {\n  return createHash(\"sha256\").update(readFileSync(file)).digest(\"hex\");\n}\n\nfunction walk(\n  root: string,\n  directory: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(directory, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(directory, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n      continue;\n    }\n\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, toPosix(path.relative(root, absolute)));\n    }\n  }\n}\n\n/**\n * Visit every file in the generation scope of `root`: root-level files and the\n * `src/` tree, skipping env files, symlinks, `node_modules` and `.git`.\n */\nexport function forEachScopedFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(path.join(root, entry.name), entry.name);\n    }\n  }\n\n  const source = path.join(root, \"src\");\n\n  if (existsSync(source)) walk(root, source, visit);\n}\n\n/**\n * Visit every file under `root` except env files, symlinks and the\n * {@link SKIPPED_ROOT_DIRECTORIES} — how a sandbox is read after a generator\n * ran, so a file written outside `src/` is still seen.\n */\nexport function forEachSandboxFile(\n  root: string,\n  visit: (absolute: string, relative: string) => void,\n): void {\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    if (entry.isSymbolicLink()) continue;\n\n    const absolute = path.join(root, entry.name);\n\n    if (entry.isDirectory()) {\n      if (!SKIPPED_ROOT_DIRECTORIES.has(entry.name)) walk(root, absolute, visit);\n    } else if (entry.isFile() && !isEnvFile(entry.name)) {\n      visit(absolute, entry.name);\n    }\n  }\n}\n\n/** Hash every file the walker visits. */\nexport function snapshotFiles(\n  root: string,\n  walker: (root: string, visit: (absolute: string, relative: string) => void) => void,\n): FileSnapshot {\n  const snapshot: FileSnapshot = new Map();\n\n  walker(root, (absolute, relative) => {\n    snapshot.set(relative, hashFile(absolute));\n  });\n\n  return snapshot;\n}\n\n/**\n * Copy the generation scope of `projectRoot` into `sandboxRoot` and link the\n * project's `node_modules` into it, so `warlock.config.ts` and every package\n * resolve exactly as they do in the project. Nothing is copied from\n * `node_modules`; the link is removed with the sandbox, never followed.\n */\nexport function copyProjectScope(projectRoot: string, sandboxRoot: string): void {\n  forEachScopedFile(projectRoot, (absolute, relative) => {\n    const target = path.join(sandboxRoot, relative);\n\n    mkdirSync(path.dirname(target), { recursive: true });\n    copyFileSync(absolute, target);\n  });\n\n  const modules = path.join(projectRoot, \"node_modules\");\n\n  if (existsSync(modules)) {\n    // \"junction\" is ignored off Windows and makes the link work there without admin rights.\n    symlinkSync(modules, path.join(sandboxRoot, \"node_modules\"), \"junction\");\n  }\n}\n\n/** One file that differs between two snapshots. */\nexport type SnapshotChange = { path: string; status: \"created\" | \"modified\" | \"deleted\" };\n\n/** The files created, modified or deleted between two snapshots, sorted by path. */\nexport function compareSnapshots(before: FileSnapshot, after: FileSnapshot): SnapshotChange[] {\n  const changes: SnapshotChange[] = [];\n\n  for (const [file, hash] of after) {\n    const previous = before.get(file);\n\n    if (previous === undefined) changes.push({ path: file, status: \"created\" });\n    else if (previous !== hash) changes.push({ path: file, status: \"modified\" });\n  }\n\n  for (const file of before.keys()) {\n    if (!after.has(file)) changes.push({ path: file, status: \"deleted\" });\n  }\n\n  return changes.sort((first, second) => first.path.localeCompare(second.path));\n}\n\n/** Whether bytes look binary: a NUL in the first 8000 bytes, as git decides. */\nexport function isBinary(content: Buffer): boolean {\n  return content.subarray(0, 8000).includes(0);\n}\n"],"mappings":"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"}

package/esm/tooling/generate/run-cli.d.mts

@@ -1,23 +1,27 @@
 //#region ../../packages/core/src/tooling/generate/run-cli.d.ts
 /** How one CLI run ended. */
-type CliRun = {
-  /** The exit code, or `null` when the process was killed. */exitCode: number | null; /** The signal that ended it, or `null`. */
+export type CliRun = {
+  /** The exit code, or `null` when the process was killed. */
+  exitCode: number | null;
+  /** The signal that ended it, or `null`. */
   signal: string | null;
   stdout: string;
-  stderr: string; /** Whether the run hit its timeout and was stopped. */
+  stderr: string;
+  /** Whether the run hit its timeout and was stopped. */
   timedOut: boolean;
 };
 /** What a {@link CliRunner} is asked to run: `node <entry> <args>` in `cwd`. */
-type CliInvocation = {
-  /** The CLI entry script (the `warlock` bin). */entry: string;
+export type CliInvocation = {
+  /** The CLI entry script (the `warlock` bin). */
+  entry: string;
   args: readonly string[];
   cwd: string;
   timeoutMs: number;
 };
 /** Runs the CLI. Injectable so tests never spawn the real one. */
-type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;
+export type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;
 /** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */
-declare const DEFAULT_GENERATION_TIMEOUT_MS = 120000;
+export declare const DEFAULT_GENERATION_TIMEOUT_MS = 120000;
 /**
  * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as
  * the project at `cwd` resolves the package, else the script this process
@@ -25,16 +29,15 @@ declare const DEFAULT_GENERATION_TIMEOUT_MS = 120000;
  *
  * @throws When neither is found; pass the entry explicitly then.
  */
-declare function resolveCliEntry(cwd?: string): string;
+export declare function resolveCliEntry(cwd?: string): string;
 /**
  * The default {@link CliRunner}: spawns `node <entry> <args>` with stdin
  * closed (a prompt reads end-of-input instead of hanging), colors off and
  * `CI=1`, and stops the child it spawned — that one process, by its own
  * handle — when the timeout passes.
  */
-declare const spawnCli: CliRunner;
+export declare const spawnCli: CliRunner;
 /** Output a plan carries: stdout then stderr, ANSI stripped, capped. */
-declare function describeRun(run: CliRun, limit?: number): string;
+export declare function describeRun(run: CliRun, limit?: number): string;
 //#endregion
-export { CliInvocation, CliRun, CliRunner, DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli };
 //# sourceMappingURL=run-cli.d.mts.map

package/esm/tooling/generate/run-cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"mappings":";;KAKY,MAAA;EAAM,4DAEhB,QAAA,iBAFgB;EAIhB,MAAA;EACA,MAAA;EACA,MAAA;EAEA,QAAA;AAAA;AAAQ;AAAA,KAIE,aAAA;EAAa,gDAEvB,KAAA;EACA,IAAA;EACA,GAAA;EACA,SAAA;AAAA;;KAIU,SAAA,IAAa,UAAA,EAAY,aAAA,KAAkB,OAAA,CAAQ,MAAA;AAJpD;AAAA,cAOE,6BAAA;;;;;;;;iBAYG,eAAA,CAAgB,GAAmB;;;;;AAfkB;AAGrE;cAsCa,QAAA,EAAU,SAyCnB;;iBAMY,WAAA,CAAY,GAAA,EAAK,MAAM,EAAE,KAAA"}
+{"version":3,"file":"run-cli.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"mappings":";;YAKY;;EAEV;;EAEA;EACA;EACA;;EAEA;;;YAIU;;EAEV;EACA;EACA;EACA;;;YAIU,aAAa,YAAY,kBAAkB,QAAQ;;qBAGlD;;;;;;;;wBAYG,gBAAgB;;;;;;;qBA0BnB,UAAU;;wBA+CP,YAAY,KAAK,QAAQ"}

package/esm/tooling/generate/run-cli.mjs

@@ -6,7 +6,7 @@ import { spawn } from "node:child_process";
 /** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */
 const DEFAULT_GENERATION_TIMEOUT_MS = 12e4;
 /** Output kept per stream; the rest is dropped (the diff is the result, not the log). */
-const MAX_STREAM_BYTES = 256 * 1024;
+const MAX_STREAM_BYTES = 262144;
 /**
 * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as
 * the project at `cwd` resolves the package, else the script this process
@@ -82,7 +82,7 @@ const spawnCli = (invocation) => new Promise((resolve) => {
 /** ANSI color and cursor sequences. */
 const ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\[[0-9;?]*[A-Za-z]`, "g");
 /** Output a plan carries: stdout then stderr, ANSI stripped, capped. */
-function describeRun(run, limit = 16 * 1024) {
+function describeRun(run, limit = 16384) {
 	const text = [run.stdout, run.stderr].map((part) => part.replace(ANSI_SEQUENCE, "").trim()).filter((part) => part.length > 0).join("\n");
 	const suffix = run.timedOut ? "\n(stopped: the command timed out)" : "";
 	return text.length > limit ? `${text.slice(0, limit)}\n… (output truncated)${suffix}` : `${text}${suffix}`;

package/esm/tooling/generate/run-cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\n/** How one CLI run ended. */\nexport type CliRun = {\n  /** The exit code, or `null` when the process was killed. */\n  exitCode: number | null;\n  /** The signal that ended it, or `null`. */\n  signal: string | null;\n  stdout: string;\n  stderr: string;\n  /** Whether the run hit its timeout and was stopped. */\n  timedOut: boolean;\n};\n\n/** What a {@link CliRunner} is asked to run: `node <entry> <args>` in `cwd`. */\nexport type CliInvocation = {\n  /** The CLI entry script (the `warlock` bin). */\n  entry: string;\n  args: readonly string[];\n  cwd: string;\n  timeoutMs: number;\n};\n\n/** Runs the CLI. Injectable so tests never spawn the real one. */\nexport type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;\n\n/** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */\nexport const DEFAULT_GENERATION_TIMEOUT_MS = 120_000;\n\n/** Output kept per stream; the rest is dropped (the diff is the result, not the log). */\nconst MAX_STREAM_BYTES = 256 * 1024;\n\n/**\n * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as\n * the project at `cwd` resolves the package, else the script this process\n * was started with when it is the `warlock` bin.\n *\n * @throws When neither is found; pass the entry explicitly then.\n */\nexport function resolveCliEntry(cwd = process.cwd()): string {\n  try {\n    const manifest = createRequire(path.join(cwd, \"package.json\")).resolve(\n      \"@warlock.js/core/package.json\",\n    );\n\n    return path.join(path.dirname(manifest), \"bin\", \"warlock.js\");\n  } catch {\n    // Not resolvable from the project; try the running script.\n  }\n\n  const invoked = process.argv[1];\n\n  if (invoked && /^warlock(\\.js)?$/.test(path.basename(invoked))) return invoked;\n\n  throw new Error(\n    \"Could not find the warlock CLI: install @warlock.js/core in the project, or pass cliEntry.\",\n  );\n}\n\n/**\n * The default {@link CliRunner}: spawns `node <entry> <args>` with stdin\n * closed (a prompt reads end-of-input instead of hanging), colors off and\n * `CI=1`, and stops the child it spawned — that one process, by its own\n * handle — when the timeout passes.\n */\nexport const spawnCli: CliRunner = (invocation) =>\n  new Promise((resolve) => {\n    const child = spawn(process.execPath, [invocation.entry, ...invocation.args], {\n      cwd: invocation.cwd,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      windowsHide: true,\n      env: { ...process.env, CI: \"1\", NO_COLOR: \"1\", FORCE_COLOR: \"0\" },\n    });\n    let stdout = \"\";\n    let stderr = \"\";\n    let timedOut = false;\n\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => {\n      if (stdout.length < MAX_STREAM_BYTES) stdout += chunk;\n    });\n    child.stderr.on(\"data\", (chunk: string) => {\n      if (stderr.length < MAX_STREAM_BYTES) stderr += chunk;\n    });\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill(\"SIGTERM\");\n    }, invocation.timeoutMs);\n\n    let settled = false;\n\n    const finish = (exitCode: number | null, signal: string | null) => {\n      if (settled) return;\n\n      settled = true;\n      clearTimeout(timer);\n      resolve({ exitCode, signal, stdout, stderr, timedOut });\n    };\n\n    child.on(\"error\", (error) => {\n      stderr += `${error.message}\\n`;\n      finish(null, null);\n    });\n    child.on(\"close\", (code, signal) => finish(code, signal));\n  });\n\n/** ANSI color and cursor sequences. */\nconst ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;?]*[A-Za-z]`, \"g\");\n\n/** Output a plan carries: stdout then stderr, ANSI stripped, capped. */\nexport function describeRun(run: CliRun, limit = 16 * 1024): string {\n  const text = [run.stdout, run.stderr]\n    .map((part) => part.replace(ANSI_SEQUENCE, \"\").trim())\n    .filter((part) => part.length > 0)\n    .join(\"\\n\");\n  const suffix = run.timedOut ? \"\\n(stopped: the command timed out)\" : \"\";\n\n  return text.length > limit\n    ? `${text.slice(0, limit)}\\n… (output truncated)${suffix}`\n    : `${text}${suffix}`;\n}\n"],"mappings":";;;;;;AA6BA,MAAa,gCAAgC;;AAG7C,MAAM,mBAAmB,MAAM;;;;;;;;AAS/B,SAAgB,gBAAgB,MAAM,QAAQ,IAAI,GAAW;CAC3D,IAAI;EACF,MAAM,WAAW,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,QAC7D,+BACF;EAEA,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,OAAO,YAAY;CAC9D,QAAQ,CAER;CAEA,MAAM,UAAU,QAAQ,KAAK;CAE7B,IAAI,WAAW,mBAAmB,KAAK,KAAK,SAAS,OAAO,CAAC,GAAG,OAAO;CAEvE,MAAM,IAAI,MACR,4FACF;AACF;;;;;;;AAQA,MAAa,YAAuB,eAClC,IAAI,SAAS,YAAY;CACvB,MAAM,QAAQ,MAAM,QAAQ,UAAU,CAAC,WAAW,OAAO,GAAG,WAAW,IAAI,GAAG;EAC5E,KAAK,WAAW;EAChB,OAAO;GAAC;GAAU;GAAQ;EAAM;EAChC,aAAa;EACb,KAAK;GAAE,GAAG,QAAQ;GAAK,IAAI;GAAK,UAAU;GAAK,aAAa;EAAI;CAClE,CAAC;CACD,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,WAAW;CAEf,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CACD,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CAED,MAAM,QAAQ,iBAAiB;EAC7B,WAAW;EACX,MAAM,KAAK,SAAS;CACtB,GAAG,WAAW,SAAS;CAEvB,IAAI,UAAU;CAEd,MAAM,UAAU,UAAyB,WAA0B;EACjE,IAAI,SAAS;EAEb,UAAU;EACV,aAAa,KAAK;EAClB,QAAQ;GAAE;GAAU;GAAQ;GAAQ;GAAQ;EAAS,CAAC;CACxD;CAEA,MAAM,GAAG,UAAU,UAAU;EAC3B,UAAU,GAAG,MAAM,QAAQ;EAC3B,OAAO,MAAM,IAAI;CACnB,CAAC;CACD,MAAM,GAAG,UAAU,MAAM,WAAW,OAAO,MAAM,MAAM,CAAC;AAC1D,CAAC;;AAGH,MAAM,gBAAgB,IAAI,OAAO,GAAG,OAAO,aAAa,EAAE,EAAE,sBAAsB,GAAG;;AAGrF,SAAgB,YAAY,KAAa,QAAQ,KAAK,MAAc;CAClE,MAAM,OAAO,CAAC,IAAI,QAAQ,IAAI,MAAM,CAAC,CAClC,KAAK,SAAS,KAAK,QAAQ,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CACrD,QAAQ,SAAS,KAAK,SAAS,CAAC,CAAC,CACjC,KAAK,IAAI;CACZ,MAAM,SAAS,IAAI,WAAW,uCAAuC;CAErE,OAAO,KAAK,SAAS,QACjB,GAAG,KAAK,MAAM,GAAG,KAAK,EAAE,wBAAwB,WAChD,GAAG,OAAO;AAChB"}
+{"version":3,"file":"run-cli.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/run-cli.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\n/** How one CLI run ended. */\nexport type CliRun = {\n  /** The exit code, or `null` when the process was killed. */\n  exitCode: number | null;\n  /** The signal that ended it, or `null`. */\n  signal: string | null;\n  stdout: string;\n  stderr: string;\n  /** Whether the run hit its timeout and was stopped. */\n  timedOut: boolean;\n};\n\n/** What a {@link CliRunner} is asked to run: `node <entry> <args>` in `cwd`. */\nexport type CliInvocation = {\n  /** The CLI entry script (the `warlock` bin). */\n  entry: string;\n  args: readonly string[];\n  cwd: string;\n  timeoutMs: number;\n};\n\n/** Runs the CLI. Injectable so tests never spawn the real one. */\nexport type CliRunner = (invocation: CliInvocation) => Promise<CliRun>;\n\n/** Two minutes: `add` features run setup hooks; a scaffold is far quicker. */\nexport const DEFAULT_GENERATION_TIMEOUT_MS = 120_000;\n\n/** Output kept per stream; the rest is dropped (the diff is the result, not the log). */\nconst MAX_STREAM_BYTES = 256 * 1024;\n\n/**\n * The `warlock` bin the project uses: `<@warlock.js/core>/bin/warlock.js` as\n * the project at `cwd` resolves the package, else the script this process\n * was started with when it is the `warlock` bin.\n *\n * @throws When neither is found; pass the entry explicitly then.\n */\nexport function resolveCliEntry(cwd = process.cwd()): string {\n  try {\n    const manifest = createRequire(path.join(cwd, \"package.json\")).resolve(\n      \"@warlock.js/core/package.json\",\n    );\n\n    return path.join(path.dirname(manifest), \"bin\", \"warlock.js\");\n  } catch {\n    // Not resolvable from the project; try the running script.\n  }\n\n  const invoked = process.argv[1];\n\n  if (invoked && /^warlock(\\.js)?$/.test(path.basename(invoked))) return invoked;\n\n  throw new Error(\n    \"Could not find the warlock CLI: install @warlock.js/core in the project, or pass cliEntry.\",\n  );\n}\n\n/**\n * The default {@link CliRunner}: spawns `node <entry> <args>` with stdin\n * closed (a prompt reads end-of-input instead of hanging), colors off and\n * `CI=1`, and stops the child it spawned — that one process, by its own\n * handle — when the timeout passes.\n */\nexport const spawnCli: CliRunner = (invocation) =>\n  new Promise((resolve) => {\n    const child = spawn(process.execPath, [invocation.entry, ...invocation.args], {\n      cwd: invocation.cwd,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      windowsHide: true,\n      env: { ...process.env, CI: \"1\", NO_COLOR: \"1\", FORCE_COLOR: \"0\" },\n    });\n    let stdout = \"\";\n    let stderr = \"\";\n    let timedOut = false;\n\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk: string) => {\n      if (stdout.length < MAX_STREAM_BYTES) stdout += chunk;\n    });\n    child.stderr.on(\"data\", (chunk: string) => {\n      if (stderr.length < MAX_STREAM_BYTES) stderr += chunk;\n    });\n\n    const timer = setTimeout(() => {\n      timedOut = true;\n      child.kill(\"SIGTERM\");\n    }, invocation.timeoutMs);\n\n    let settled = false;\n\n    const finish = (exitCode: number | null, signal: string | null) => {\n      if (settled) return;\n\n      settled = true;\n      clearTimeout(timer);\n      resolve({ exitCode, signal, stdout, stderr, timedOut });\n    };\n\n    child.on(\"error\", (error) => {\n      stderr += `${error.message}\\n`;\n      finish(null, null);\n    });\n    child.on(\"close\", (code, signal) => finish(code, signal));\n  });\n\n/** ANSI color and cursor sequences. */\nconst ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;?]*[A-Za-z]`, \"g\");\n\n/** Output a plan carries: stdout then stderr, ANSI stripped, capped. */\nexport function describeRun(run: CliRun, limit = 16 * 1024): string {\n  const text = [run.stdout, run.stderr]\n    .map((part) => part.replace(ANSI_SEQUENCE, \"\").trim())\n    .filter((part) => part.length > 0)\n    .join(\"\\n\");\n  const suffix = run.timedOut ? \"\\n(stopped: the command timed out)\" : \"\";\n\n  return text.length > limit\n    ? `${text.slice(0, limit)}\\n… (output truncated)${suffix}`\n    : `${text}${suffix}`;\n}\n"],"mappings":";;;;;;AA6BA,MAAa,gCAAgC;;AAG7C,MAAM,mBAAmB;;;;;;;;AASzB,SAAgB,gBAAgB,MAAM,QAAQ,IAAI,GAAW;CAC3D,IAAI;EACF,MAAM,WAAW,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,QAC7D,+BACF;EAEA,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAQ,GAAG,OAAO,YAAY;CAC9D,QAAQ,CAER;CAEA,MAAM,UAAU,QAAQ,KAAK;CAE7B,IAAI,WAAW,mBAAmB,KAAK,KAAK,SAAS,OAAO,CAAC,GAAG,OAAO;CAEvE,MAAM,IAAI,MACR,4FACF;AACF;;;;;;;AAQA,MAAa,YAAuB,eAClC,IAAI,SAAS,YAAY;CACvB,MAAM,QAAQ,MAAM,QAAQ,UAAU,CAAC,WAAW,OAAO,GAAG,WAAW,IAAI,GAAG;EAC5E,KAAK,WAAW;EAChB,OAAO;GAAC;GAAU;GAAQ;EAAM;EAChC,aAAa;EACb,KAAK;GAAE,GAAG,QAAQ;GAAK,IAAI;GAAK,UAAU;GAAK,aAAa;EAAI;CAClE,CAAC;CACD,IAAI,SAAS;CACb,IAAI,SAAS;CACb,IAAI,WAAW;CAEf,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CACD,MAAM,OAAO,GAAG,SAAS,UAAkB;EACzC,IAAI,OAAO,SAAS,kBAAkB,UAAU;CAClD,CAAC;CAED,MAAM,QAAQ,iBAAiB;EAC7B,WAAW;EACX,MAAM,KAAK,SAAS;CACtB,GAAG,WAAW,SAAS;CAEvB,IAAI,UAAU;CAEd,MAAM,UAAU,UAAyB,WAA0B;EACjE,IAAI,SAAS;EAEb,UAAU;EACV,aAAa,KAAK;EAClB,QAAQ;GAAE;GAAU;GAAQ;GAAQ;GAAQ;EAAS,CAAC;CACxD;CAEA,MAAM,GAAG,UAAU,UAAU;EAC3B,UAAU,GAAG,MAAM,QAAQ;EAC3B,OAAO,MAAM,IAAI;CACnB,CAAC;CACD,MAAM,GAAG,UAAU,MAAM,WAAW,OAAO,MAAM,MAAM,CAAC;AAC1D,CAAC;;AAGH,MAAM,gBAAgB,IAAI,OAAO,GAAG,OAAO,aAAa,EAAE,EAAE,sBAAsB,GAAG;;AAGrF,SAAgB,YAAY,KAAa,QAAQ,OAAmB;CAClE,MAAM,OAAO,CAAC,IAAI,QAAQ,IAAI,MAAM,CAAC,CAClC,KAAK,SAAS,KAAK,QAAQ,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CACrD,QAAQ,SAAS,KAAK,SAAS,CAAC,CAAC,CACjC,KAAK,IAAI;CACZ,MAAM,SAAS,IAAI,WAAW,uCAAuC;CAErE,OAAO,KAAK,SAAS,QACjB,GAAG,KAAK,MAAM,GAAG,KAAK,EAAE,wBAAwB,WAChD,GAAG,OAAO;AAChB"}

package/esm/tooling/generate/unified-diff.d.mts

@@ -11,12 +11,16 @@
  * still a correct (if larger) diff.
  */
 /** Lines of context around each change. */
-declare const DIFF_CONTEXT_LINES = 3;
+export declare const DIFF_CONTEXT_LINES = 3;
 /** Inputs of {@link unifiedDiff}. */
-type UnifiedDiffInput = {
-  /** Project-relative POSIX path, used in the headers. */path: string; /** The old content; `null` when the file is created. */
-  before: string | null; /** The new content; `null` when the file is deleted. */
-  after: string | null; /** Lines of context. Default {@link DIFF_CONTEXT_LINES}. */
+export type UnifiedDiffInput = {
+  /** Project-relative POSIX path, used in the headers. */
+  path: string;
+  /** The old content; `null` when the file is created. */
+  before: string | null;
+  /** The new content; `null` when the file is deleted. */
+  after: string | null;
+  /** Lines of context. Default {@link DIFF_CONTEXT_LINES}. */
   context?: number;
 };
 /**
@@ -31,7 +35,6 @@ type UnifiedDiffInput = {
  * //  a
  * // +b
  */
-declare function unifiedDiff(input: UnifiedDiffInput): string;
+export declare function unifiedDiff(input: UnifiedDiffInput): string;
 //#endregion
-export { DIFF_CONTEXT_LINES, UnifiedDiffInput, unifiedDiff };
 //# sourceMappingURL=unified-diff.d.mts.map

package/esm/tooling/generate/unified-diff.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-diff.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/unified-diff.ts"],"mappings":";;AAaA;;;;AAA+B;AAuH/B;;;;;;cAvHa,kBAAA;;KAuHD,gBAAA;EAQH,wDANP,IAAA,UAqByB;EAnBzB,MAAA,iBAmBiC;EAjBjC,KAAA;EAEA,OAAA;AAAA;;;;;;;;;;;;;iBAec,WAAA,CAAY,KAAuB,EAAhB,gBAAgB"}
+{"version":3,"file":"unified-diff.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/unified-diff.ts"],"mappings":";;;;;;;;;;;;;qBAaa;;YAuHD;;EAEV;;EAEA;;EAEA;;EAEA;;;;;;;;;;;;;;wBAec,YAAY,OAAO"}

package/esm/tooling/index.d.mts

@@ -29,6 +29,7 @@ import { AppModuleImporter } from "./inspect/collect-packages.mjs";
 import { InspectOptions, inspectApp, isInspectSection, parseInspectSections } from "./inspect/inspect-app.mjs";
 import { InspectBootResult, bootForInspect, inspectOptionsFromBoot } from "./inspect/boot-for-inspect.mjs";
 import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect/inspect-report.schema.mjs";
+import "./inspect/index.mjs";
 import { DbSchema, DbSchemaColumn, DbSchemaTable, buildDbSchema } from "./mcp/db-schema.mjs";
 import { DOCS_CORPUS_GLOBS, DocsCorpus, DocsSearchHit, DocsSection, loadDocsCorpus, readDocsFile, searchDocs, searchTerms, splitSections } from "./mcp/docs-search.mjs";
 import { McpInputProperty, McpInputSchema, inputSchema, toStandardSchema, validateToolInput } from "./mcp/tool-input.mjs";

package/esm/tooling/inspect/boot-for-inspect.d.mts

@@ -1,13 +1,14 @@
 import { DoctorBootContext } from "../../cli/commands/doctor/check.types.mjs";
 import { RecordedListener } from "./event-recorder.mjs";
 import { InspectOptions } from "./inspect-app.mjs";
-
 //#region ../../packages/core/src/tooling/inspect/boot-for-inspect.d.ts
 /** What the boot pass observed, ready to hand to `inspectApp`. */
-type InspectBootResult = {
+export type InspectBootResult = {
   context: DoctorBootContext;
-  events: RecordedListener[]; /** Names resource classes by the export of their `*.resource.ts` module. */
-  resolveResourceName: (resource: unknown) => string | undefined; /** Resource modules that could not be read while naming resources. */
+  events: RecordedListener[];
+  /** Names resource classes by the export of their `*.resource.ts` module. */
+  resolveResourceName: (resource: unknown) => string | undefined;
+  /** Resource modules that could not be read while naming resources. */
   warnings: string[];
 };
 /**
@@ -15,9 +16,8 @@ type InspectBootResult = {
  * started, no connection opened and no port bound — while recording the event
  * listeners app modules register.
  */
-declare function bootForInspect(cwd?: string): Promise<InspectBootResult>;
+export declare function bootForInspect(cwd?: string): Promise<InspectBootResult>;
 /** The `inspectApp` inputs a boot pass provides. */
-declare function inspectOptionsFromBoot(result: InspectBootResult): InspectOptions;
+export declare function inspectOptionsFromBoot(result: InspectBootResult): InspectOptions;
 //#endregion
-export { InspectBootResult, bootForInspect, inspectOptionsFromBoot };
 //# sourceMappingURL=boot-for-inspect.d.mts.map

package/esm/tooling/inspect/boot-for-inspect.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"boot-for-inspect.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/boot-for-inspect.ts"],"mappings":";;;;;;KAYY,iBAAA;EACV,OAAA,EAAS,iBAAA;EACT,MAAA,EAAQ,gBAAgB;EAExB,mBAAA,GAAsB,QAAA,kCAHtB;EAKA,QAAA;AAAA;;;;;;iBAyBoB,cAAA,CAAe,GAAA,YAAsB,OAAO,CAAC,iBAAA;AAAnE;AAAA,iBAyBgB,sBAAA,CAAuB,MAAA,EAAQ,iBAAA,GAAoB,cAAc"}
+{"version":3,"file":"boot-for-inspect.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/boot-for-inspect.ts"],"mappings":";;;;;YAYY;EACV,SAAS;EACT,QAAQ;;EAER,sBAAsB;;EAEtB;;;;;;;wBAyBoB,eAAe,eAAsB,QAAQ;;wBAyBnD,uBAAuB,QAAQ,oBAAoB"}

package/esm/tooling/inspect/collect-config.mjs

@@ -1,4 +1,4 @@
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import path from "node:path";
 import { existsSync } from "node:fs";
 
@@ -46,7 +46,7 @@ function configFileFor(cwd, section) {
 * @param source The loaded config tree; defaults to everything `config` holds.
 */
 function collectConfig(cwd, source) {
-	const tree = source ?? config.list();
+	const tree = source ?? baseConfig.list();
 	const keys = [];
 	if (!isPlainObject(tree)) return keys;
 	const walk = (value, prefix, depth, file) => {
@@ -73,5 +73,5 @@ function collectConfig(cwd, source) {
 }
 
 //#endregion
-export { collectConfig };
+export { collectConfig, configValueType };
 //# sourceMappingURL=collect-config.mjs.map

package/esm/tooling/inspect/collect-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-config.mjs","names":["baseConfig"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-config.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectConfigKey } from \"./inspect-report.types\";\n\n/** How deep nested config objects are walked. Deeper keys are reported as `object`. */\nconst MAX_DEPTH = 4;\n\n/** Extensions a `src/config/<name>` file may have. */\nconst CONFIG_EXTENSIONS = [\".ts\", \".tsx\", \".js\", \".mjs\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\n/** The JS type of a config value, without the value. */\nexport function configValueType(value: unknown): string {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  if (value instanceof RegExp) return \"regexp\";\n  if (value instanceof Date) return \"date\";\n  if (isPlainObject(value)) return \"object\";\n\n  if (typeof value === \"object\") {\n    const constructorName = Reflect.get(Object.getPrototypeOf(value) ?? {}, \"constructor\");\n\n    return typeof constructorName === \"function\" && constructorName.name\n      ? constructorName.name\n      : \"object\";\n  }\n\n  return typeof value;\n}\n\nfunction configFileFor(cwd: string, section: string): string | null {\n  for (const extension of CONFIG_EXTENSIONS) {\n    const relative = `src/config/${section}${extension}`;\n\n    if (existsSync(path.join(cwd, relative))) return relative;\n  }\n\n  return null;\n}\n\n/**\n * Every loaded config key as a dotted path with its type — NEVER its value,\n * because config holds secrets. Plain objects are walked up to\n * {@link MAX_DEPTH} levels; arrays, class instances and functions are leaves.\n *\n * @param cwd Project root, used to name the `src/config/*` file of each section.\n * @param source The loaded config tree; defaults to everything `config` holds.\n */\nexport function collectConfig(cwd: string, source?: Record<string, unknown>): InspectConfigKey[] {\n  const tree: unknown = source ?? baseConfig.list();\n  const keys: InspectConfigKey[] = [];\n\n  if (!isPlainObject(tree)) return keys;\n\n  const walk = (value: unknown, prefix: string, depth: number, file: string | null) => {\n    if (isPlainObject(value) && depth < MAX_DEPTH && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${prefix}.${key}`, depth + 1, file);\n      }\n\n      return;\n    }\n\n    keys.push({ key: prefix, type: configValueType(value), file });\n  };\n\n  for (const [section, value] of Object.entries(tree)) {\n    const file = configFileFor(cwd, section);\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${section}.${key}`, 2, file);\n      }\n    } else {\n      keys.push({ key: section, type: configValueType(value), file });\n    }\n  }\n\n  return keys.sort((first, second) => first.key.localeCompare(second.key));\n}\n"],"mappings":";;;;;;AAMA,MAAM,YAAY;;AAGlB,MAAM,oBAAoB;CAAC;CAAO;CAAQ;CAAO;AAAM;AAEvD,SAAS,cAAc,OAAkD;CACvE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,YAAY,OAAO,eAAe,KAAK;CAE7C,OAAO,cAAc,OAAO,aAAa,cAAc;AACzD;;AAGA,SAAgB,gBAAgB,OAAwB;CACtD,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO;CACjC,IAAI,iBAAiB,QAAQ,OAAO;CACpC,IAAI,iBAAiB,MAAM,OAAO;CAClC,IAAI,cAAc,KAAK,GAAG,OAAO;CAEjC,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,kBAAkB,QAAQ,IAAI,OAAO,eAAe,KAAK,KAAK,CAAC,GAAG,aAAa;EAErF,OAAO,OAAO,oBAAoB,cAAc,gBAAgB,OAC5D,gBAAgB,OAChB;CACN;CAEA,OAAO,OAAO;AAChB;AAEA,SAAS,cAAc,KAAa,SAAgC;CAClE,KAAK,MAAM,aAAa,mBAAmB;EACzC,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,WAAW,KAAK,KAAK,KAAK,QAAQ,CAAC,GAAG,OAAO;CACnD;CAEA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,cAAc,KAAa,QAAsD;CAC/F,MAAM,OAAgB,UAAUA,OAAW,KAAK;CAChD,MAAM,OAA2B,CAAC;CAElC,IAAI,CAAC,cAAc,IAAI,GAAG,OAAO;CAEjC,MAAM,QAAQ,OAAgB,QAAgB,OAAe,SAAwB;EACnF,IAAI,cAAc,KAAK,KAAK,QAAQ,aAAa,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GAAG;GAC9E,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,OAAO,GAAG,OAAO,QAAQ,GAAG,IAAI;GAGjD;EACF;EAEA,KAAK,KAAK;GAAE,KAAK;GAAQ,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAC/D;CAEA,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,IAAI,GAAG;EACnD,MAAM,OAAO,cAAc,KAAK,OAAO;EAEvC,IAAI,cAAc,KAAK,KAAK,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACtD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI;OAG1C,KAAK,KAAK;GAAE,KAAK;GAAS,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAElE;CAEA,OAAO,KAAK,MAAM,OAAO,WAAW,MAAM,IAAI,cAAc,OAAO,GAAG,CAAC;AACzE"}
+{"version":3,"file":"collect-config.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-config.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectConfigKey } from \"./inspect-report.types\";\n\n/** How deep nested config objects are walked. Deeper keys are reported as `object`. */\nconst MAX_DEPTH = 4;\n\n/** Extensions a `src/config/<name>` file may have. */\nconst CONFIG_EXTENSIONS = [\".ts\", \".tsx\", \".js\", \".mjs\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) return false;\n\n  const prototype = Object.getPrototypeOf(value);\n\n  return prototype === Object.prototype || prototype === null;\n}\n\n/** The JS type of a config value, without the value. */\nexport function configValueType(value: unknown): string {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  if (value instanceof RegExp) return \"regexp\";\n  if (value instanceof Date) return \"date\";\n  if (isPlainObject(value)) return \"object\";\n\n  if (typeof value === \"object\") {\n    const constructorName = Reflect.get(Object.getPrototypeOf(value) ?? {}, \"constructor\");\n\n    return typeof constructorName === \"function\" && constructorName.name\n      ? constructorName.name\n      : \"object\";\n  }\n\n  return typeof value;\n}\n\nfunction configFileFor(cwd: string, section: string): string | null {\n  for (const extension of CONFIG_EXTENSIONS) {\n    const relative = `src/config/${section}${extension}`;\n\n    if (existsSync(path.join(cwd, relative))) return relative;\n  }\n\n  return null;\n}\n\n/**\n * Every loaded config key as a dotted path with its type — NEVER its value,\n * because config holds secrets. Plain objects are walked up to\n * {@link MAX_DEPTH} levels; arrays, class instances and functions are leaves.\n *\n * @param cwd Project root, used to name the `src/config/*` file of each section.\n * @param source The loaded config tree; defaults to everything `config` holds.\n */\nexport function collectConfig(cwd: string, source?: Record<string, unknown>): InspectConfigKey[] {\n  const tree: unknown = source ?? baseConfig.list();\n  const keys: InspectConfigKey[] = [];\n\n  if (!isPlainObject(tree)) return keys;\n\n  const walk = (value: unknown, prefix: string, depth: number, file: string | null) => {\n    if (isPlainObject(value) && depth < MAX_DEPTH && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${prefix}.${key}`, depth + 1, file);\n      }\n\n      return;\n    }\n\n    keys.push({ key: prefix, type: configValueType(value), file });\n  };\n\n  for (const [section, value] of Object.entries(tree)) {\n    const file = configFileFor(cwd, section);\n\n    if (isPlainObject(value) && Object.keys(value).length > 0) {\n      for (const [key, child] of Object.entries(value)) {\n        walk(child, `${section}.${key}`, 2, file);\n      }\n    } else {\n      keys.push({ key: section, type: configValueType(value), file });\n    }\n  }\n\n  return keys.sort((first, second) => first.key.localeCompare(second.key));\n}\n"],"mappings":";;;;;;AAMA,MAAM,YAAY;;AAGlB,MAAM,oBAAoB;CAAC;CAAO;CAAQ;CAAO;AAAM;AAEvD,SAAS,cAAc,OAAkD;CACvE,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,YAAY,OAAO,eAAe,KAAK;CAE7C,OAAO,cAAc,OAAO,aAAa,cAAc;AACzD;;AAGA,SAAgB,gBAAgB,OAAwB;CACtD,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO;CACjC,IAAI,iBAAiB,QAAQ,OAAO;CACpC,IAAI,iBAAiB,MAAM,OAAO;CAClC,IAAI,cAAc,KAAK,GAAG,OAAO;CAEjC,IAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,kBAAkB,QAAQ,IAAI,OAAO,eAAe,KAAK,KAAK,CAAC,GAAG,aAAa;EAErF,OAAO,OAAO,oBAAoB,cAAc,gBAAgB,OAC5D,gBAAgB,OAChB;CACN;CAEA,OAAO,OAAO;AAChB;AAEA,SAAS,cAAc,KAAa,SAAgC;CAClE,KAAK,MAAM,aAAa,mBAAmB;EACzC,MAAM,WAAW,cAAc,UAAU;EAEzC,IAAI,WAAW,KAAK,KAAK,KAAK,QAAQ,CAAC,GAAG,OAAO;CACnD;CAEA,OAAO;AACT;;;;;;;;;AAUA,SAAgB,cAAc,KAAa,QAAsD;CAC/F,MAAM,OAAgB,UAAU,WAAW,KAAK;CAChD,MAAM,OAA2B,CAAC;CAElC,IAAI,CAAC,cAAc,IAAI,GAAG,OAAO;CAEjC,MAAM,QAAQ,OAAgB,QAAgB,OAAe,SAAwB;EACnF,IAAI,cAAc,KAAK,KAAK,QAAQ,aAAa,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GAAG;GAC9E,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,OAAO,GAAG,OAAO,QAAQ,GAAG,IAAI;GAGjD;EACF;EAEA,KAAK,KAAK;GAAE,KAAK;GAAQ,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAC/D;CAEA,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,IAAI,GAAG;EACnD,MAAM,OAAO,cAAc,KAAK,OAAO;EAEvC,IAAI,cAAc,KAAK,KAAK,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACtD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAC7C,KAAK,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI;OAG1C,KAAK,KAAK;GAAE,KAAK;GAAS,MAAM,gBAAgB,KAAK;GAAG;EAAK,CAAC;CAElE;CAEA,OAAO,KAAK,MAAM,OAAO,WAAW,MAAM,IAAI,cAAc,OAAO,GAAG,CAAC;AACzE"}

package/esm/tooling/inspect/collect-models.d.mts

@@ -1,9 +1,10 @@
+import "../../openapi/schema-registry.mjs";
 //#region ../../packages/core/src/tooling/inspect/collect-models.d.ts
 /** A model module the boot pass imported: its file and its exports. */
-type InspectModelModule = {
-  /** Project-relative path. */file: string;
+export type InspectModelModule = {
+  /** Project-relative path. */
+  file: string;
   exports: Record<string, unknown>;
 };
 //#endregion
-export { InspectModelModule };
 //# sourceMappingURL=collect-models.d.mts.map

package/esm/tooling/inspect/collect-models.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"collect-models.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-models.ts"],"mappings":";;KAaY,kBAAA;EAAkB,6BAE5B,IAAA;EACA,OAAA,EAAS,MAAM;AAAA"}
+{"version":3,"file":"collect-models.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-models.ts"],"mappings":";;;YAaY;;EAEV;EACA,SAAS"}

package/esm/tooling/inspect/collect-models.mjs

@@ -150,5 +150,5 @@ function collectResources(registry, resourceModels) {
 }
 
 //#endregion
-export { collectModels, collectResources };
+export { collectModels, collectResources, isModelClass };
 //# sourceMappingURL=collect-models.mjs.map

package/esm/tooling/inspect/collect-packages.d.mts

@@ -4,7 +4,6 @@
  * module instance (and registry) the app's own modules populated. Resolves to
  * `undefined` when the app does not have the package.
  */
-type AppModuleImporter = (specifier: string) => Promise<unknown>;
+export type AppModuleImporter = (specifier: string) => Promise<unknown>;
 //#endregion
-export { AppModuleImporter };
 //# sourceMappingURL=collect-packages.d.mts.map

package/esm/tooling/inspect/collect-packages.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"collect-packages.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-packages.ts"],"mappings":";AAgBA;;;;AAA8D;AAA9D,KAAY,iBAAA,IAAqB,SAAA,aAAsB,OAAO"}
+{"version":3,"file":"collect-packages.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-packages.ts"],"mappings":";;;;;;YAgBY,qBAAqB,sBAAsB"}

package/esm/tooling/inspect/collect-pages.mjs

@@ -1,7 +1,7 @@
 import { connectorsManager } from "../../connectors/connectors-manager.mjs";
+import { declarationName, hasModifier, isExportDeclaration, isFunctionDeclaration, isIdentifier, isVariableStatement, nameNode, parseSourceFile, topLevelDeclarations, valueText } from "../syntax/ast.mjs";
 import path from "node:path";
 import { existsSync, readFileSync } from "node:fs";
-import ts from "typescript";
 
 //#region ../../packages/core/src/tooling/inspect/collect-pages.ts
 function isInstalledPage(value) {
@@ -45,7 +45,7 @@ function layoutChainOf(pageFile, cwd) {
 }
 /**
 * Whether a module's source exports a binding named `name`, read with the
-* TypeScript parser (the page files are TSX that Node cannot import directly).
+* OXC parser (the page files are TSX that Node cannot import directly).
 */
 function exportsName(file, name) {
 	let source;
@@ -54,14 +54,14 @@ function exportsName(file, name) {
 	} catch {
 		return false;
 	}
-	const sourceFile = ts.createSourceFile(file, source, ts.ScriptTarget.Latest, false, ts.ScriptKind.TSX);
-	for (const statement of sourceFile.statements) {
-		const exported = ts.canHaveModifiers(statement) ? (ts.getModifiers(statement) ?? []).some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword) : false;
-		if (exported && ts.isVariableStatement(statement)) {
-			if (statement.declarationList.declarations.some((declaration) => ts.isIdentifier(declaration.name) && declaration.name.text === name)) return true;
+	const sourceFile = parseSourceFile(file, source);
+	for (const statement of topLevelDeclarations(sourceFile)) {
+		const exported = hasModifier(statement, "export");
+		if (exported && isVariableStatement(statement)) {
+			if (statement.declarations.some((declaration) => isIdentifier(nameNode(declaration)) && valueText(declaration.id) === name)) return true;
 		}
-		if (exported && ts.isFunctionDeclaration(statement) && statement.name?.text === name) return true;
-		if (ts.isExportDeclaration(statement) && statement.exportClause && ts.isNamedExports(statement.exportClause) && statement.exportClause.elements.some((element) => element.name.text === name)) return true;
+		if (exported && isFunctionDeclaration(statement) && declarationName(statement) === name) return true;
+		if (isExportDeclaration(statement) && statement.specifiers.some((element) => valueText(element.exported) === name)) return true;
 	}
 	return false;
 }
@@ -104,5 +104,5 @@ function collectPages(pages, cwd, warnings) {
 }
 
 //#endregion
-export { collectPages, installedPagesFromConnectors };
+export { collectPages, exportsName, installedPagesFromConnectors, layoutChainOf };
 //# sourceMappingURL=collect-pages.mjs.map

package/esm/tooling/inspect/collect-pages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect-pages.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-pages.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport ts from \"typescript\";\nimport { connectorsManager } from \"../../connectors/connectors-manager\";\nimport type { InspectPage, InspectWarning } from \"./inspect-report.types\";\n\n/** The fields of `@warlock.js/web`'s installed page record that inspect reads. */\ntype InstalledPageLike = {\n  path: string;\n  name?: unknown;\n  file: string;\n  actions?: unknown;\n  guard?: unknown;\n};\n\nfunction isInstalledPage(value: unknown): value is InstalledPageLike {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof Reflect.get(value, \"path\") === \"string\" &&\n    typeof Reflect.get(value, \"file\") === \"string\"\n  );\n}\n\n/**\n * The pages the `web` connector installed, read through its public\n * `getInstalledPages()` without importing `@warlock.js/web`. `undefined` when\n * no such connector is registered (an API-only app).\n */\nexport function installedPagesFromConnectors(): unknown[] | undefined {\n  const web = connectorsManager.list().find((connector) => connector.name === \"web\");\n  const read = web ? Reflect.get(web, \"getInstalledPages\") : undefined;\n\n  if (typeof read !== \"function\") return undefined;\n\n  const pages: unknown = read.call(web);\n\n  return Array.isArray(pages) ? pages : undefined;\n}\n\nfunction toPosix(file: string): string {\n  return file.split(path.sep).join(\"/\");\n}\n\nfunction relativeTo(cwd: string, file: string): string {\n  return toPosix(path.isAbsolute(file) ? path.relative(cwd, file) : file);\n}\n\n/**\n * The page's layout chain, outermost first: every `layout.tsx` from the web\n * root (the nearest ancestor holding `root.tsx`, else `src/`) down to the\n * page's own directory — the rule `@warlock.js/web` applies.\n */\nexport function layoutChainOf(pageFile: string, cwd: string): string[] {\n  const srcRoot = path.join(cwd, \"src\");\n  const directories: string[] = [];\n  let current = path.dirname(pageFile);\n\n  while (current.startsWith(srcRoot)) {\n    directories.unshift(current);\n\n    if (existsSync(path.join(current, \"root.tsx\")) || current === srcRoot) break;\n\n    const parent = path.dirname(current);\n\n    if (parent === current) break;\n\n    current = parent;\n  }\n\n  return directories\n    .map((directory) => path.join(directory, \"layout.tsx\"))\n    .filter((candidate) => existsSync(candidate));\n}\n\n/**\n * Whether a module's source exports a binding named `name`, read with the\n * TypeScript parser (the page files are TSX that Node cannot import directly).\n */\nexport function exportsName(file: string, name: string): boolean {\n  let source: string;\n\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return false;\n  }\n\n  const sourceFile = ts.createSourceFile(\n    file,\n    source,\n    ts.ScriptTarget.Latest,\n    false,\n    ts.ScriptKind.TSX,\n  );\n\n  for (const statement of sourceFile.statements) {\n    const exported = ts.canHaveModifiers(statement)\n      ? (ts.getModifiers(statement) ?? []).some(\n          (modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword,\n        )\n      : false;\n\n    if (exported && ts.isVariableStatement(statement)) {\n      if (\n        statement.declarationList.declarations.some(\n          (declaration) => ts.isIdentifier(declaration.name) && declaration.name.text === name,\n        )\n      ) {\n        return true;\n      }\n    }\n\n    if (exported && ts.isFunctionDeclaration(statement) && statement.name?.text === name) {\n      return true;\n    }\n\n    if (\n      ts.isExportDeclaration(statement) &&\n      statement.exportClause &&\n      ts.isNamedExports(statement.exportClause) &&\n      statement.exportClause.elements.some((element) => element.name.text === name)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Describe the installed pages: route path and name, page file, layout chain,\n * the files on that chain exporting a `loader`, actions and guard.\n *\n * @param pages The connector's installed page records; see {@link installedPagesFromConnectors}.\n */\nexport function collectPages(\n  pages: readonly unknown[] | undefined,\n  cwd: string,\n  warnings: InspectWarning[],\n): InspectPage[] {\n  if (!pages) return [];\n\n  const collected: InspectPage[] = [];\n\n  for (const page of pages) {\n    if (!isInstalledPage(page)) {\n      warnings.push({ code: null, message: \"A page record has no path or file.\", source: \"pages\" });\n      continue;\n    }\n\n    const pageFile = path.isAbsolute(page.file) ? page.file : path.join(cwd, page.file);\n    const layouts = layoutChainOf(pageFile, cwd);\n    const loaders = [...layouts, pageFile].filter((file) => exportsName(file, \"loader\"));\n    const actions = Array.isArray(page.actions)\n      ? page.actions.filter((action): action is string => typeof action === \"string\")\n      : [];\n\n    collected.push({\n      path: page.path,\n      name: typeof page.name === \"string\" && page.name.length > 0 ? page.name : null,\n      file: relativeTo(cwd, pageFile),\n      layouts: layouts.map((file) => relativeTo(cwd, file)),\n      loaders: loaders.map((file) => relativeTo(cwd, file)),\n      actions: [...actions].sort(),\n      guard: typeof page.guard === \"string\" ? page.guard : null,\n    });\n  }\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return first.file.localeCompare(second.file);\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"collect-pages.mjs","names":["ast.parseSourceFile","ast.topLevelDeclarations","ast.hasModifier","ast.isVariableStatement","ast.isIdentifier","ast.nameNode","ast.valueText","ast.isFunctionDeclaration","ast.declarationName","ast.isExportDeclaration"],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/collect-pages.ts"],"sourcesContent":["import { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as ast from \"../syntax/ast\";\nimport { connectorsManager } from \"../../connectors/connectors-manager\";\nimport type { InspectPage, InspectWarning } from \"./inspect-report.types\";\n\n/** The fields of `@warlock.js/web`'s installed page record that inspect reads. */\ntype InstalledPageLike = {\n  path: string;\n  name?: unknown;\n  file: string;\n  actions?: unknown;\n  guard?: unknown;\n};\n\nfunction isInstalledPage(value: unknown): value is InstalledPageLike {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof Reflect.get(value, \"path\") === \"string\" &&\n    typeof Reflect.get(value, \"file\") === \"string\"\n  );\n}\n\n/**\n * The pages the `web` connector installed, read through its public\n * `getInstalledPages()` without importing `@warlock.js/web`. `undefined` when\n * no such connector is registered (an API-only app).\n */\nexport function installedPagesFromConnectors(): unknown[] | undefined {\n  const web = connectorsManager.list().find((connector) => connector.name === \"web\");\n  const read = web ? Reflect.get(web, \"getInstalledPages\") : undefined;\n\n  if (typeof read !== \"function\") return undefined;\n\n  const pages: unknown = read.call(web);\n\n  return Array.isArray(pages) ? pages : undefined;\n}\n\nfunction toPosix(file: string): string {\n  return file.split(path.sep).join(\"/\");\n}\n\nfunction relativeTo(cwd: string, file: string): string {\n  return toPosix(path.isAbsolute(file) ? path.relative(cwd, file) : file);\n}\n\n/**\n * The page's layout chain, outermost first: every `layout.tsx` from the web\n * root (the nearest ancestor holding `root.tsx`, else `src/`) down to the\n * page's own directory — the rule `@warlock.js/web` applies.\n */\nexport function layoutChainOf(pageFile: string, cwd: string): string[] {\n  const srcRoot = path.join(cwd, \"src\");\n  const directories: string[] = [];\n  let current = path.dirname(pageFile);\n\n  while (current.startsWith(srcRoot)) {\n    directories.unshift(current);\n\n    if (existsSync(path.join(current, \"root.tsx\")) || current === srcRoot) break;\n\n    const parent = path.dirname(current);\n\n    if (parent === current) break;\n\n    current = parent;\n  }\n\n  return directories\n    .map((directory) => path.join(directory, \"layout.tsx\"))\n    .filter((candidate) => existsSync(candidate));\n}\n\n/**\n * Whether a module's source exports a binding named `name`, read with the\n * OXC parser (the page files are TSX that Node cannot import directly).\n */\nexport function exportsName(file: string, name: string): boolean {\n  let source: string;\n\n  try {\n    source = readFileSync(file, \"utf8\");\n  } catch {\n    return false;\n  }\n\n  const sourceFile = ast.parseSourceFile(file, source);\n\n  for (const statement of ast.topLevelDeclarations(sourceFile)) {\n    const exported = ast.hasModifier(statement, \"export\");\n\n    if (exported && ast.isVariableStatement(statement)) {\n      if (\n        statement.declarations.some(\n          (declaration) =>\n            ast.isIdentifier(ast.nameNode(declaration)) && ast.valueText(declaration.id) === name,\n        )\n      ) {\n        return true;\n      }\n    }\n\n    if (\n      exported &&\n      ast.isFunctionDeclaration(statement) &&\n      ast.declarationName(statement) === name\n    ) {\n      return true;\n    }\n\n    if (\n      ast.isExportDeclaration(statement) &&\n      statement.specifiers.some((element) => ast.valueText(element.exported) === name)\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Describe the installed pages: route path and name, page file, layout chain,\n * the files on that chain exporting a `loader`, actions and guard.\n *\n * @param pages The connector's installed page records; see {@link installedPagesFromConnectors}.\n */\nexport function collectPages(\n  pages: readonly unknown[] | undefined,\n  cwd: string,\n  warnings: InspectWarning[],\n): InspectPage[] {\n  if (!pages) return [];\n\n  const collected: InspectPage[] = [];\n\n  for (const page of pages) {\n    if (!isInstalledPage(page)) {\n      warnings.push({ code: null, message: \"A page record has no path or file.\", source: \"pages\" });\n      continue;\n    }\n\n    const pageFile = path.isAbsolute(page.file) ? page.file : path.join(cwd, page.file);\n    const layouts = layoutChainOf(pageFile, cwd);\n    const loaders = [...layouts, pageFile].filter((file) => exportsName(file, \"loader\"));\n    const actions = Array.isArray(page.actions)\n      ? page.actions.filter((action): action is string => typeof action === \"string\")\n      : [];\n\n    collected.push({\n      path: page.path,\n      name: typeof page.name === \"string\" && page.name.length > 0 ? page.name : null,\n      file: relativeTo(cwd, pageFile),\n      layouts: layouts.map((file) => relativeTo(cwd, file)),\n      loaders: loaders.map((file) => relativeTo(cwd, file)),\n      actions: [...actions].sort(),\n      guard: typeof page.guard === \"string\" ? page.guard : null,\n    });\n  }\n\n  return collected.sort((first, second) => {\n    if (first.path !== second.path) return first.path < second.path ? -1 : 1;\n\n    return first.file.localeCompare(second.file);\n  });\n}\n"],"mappings":"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"}

package/esm/tooling/inspect/collect-routes.mjs

@@ -164,5 +164,5 @@ function collectRoutes(routes, registry, warnings) {
 }
 
 //#endregion
-export { collectRoutes };
+export { collectRoutes, functionName };
 //# sourceMappingURL=collect-routes.mjs.map

package/esm/tooling/inspect/event-recorder.d.mts

@@ -1,10 +1,11 @@
 import { InspectEvent } from "./inspect-report.types.mjs";
-
 //#region ../../packages/core/src/tooling/inspect/event-recorder.d.ts
 /** One listener an app module registered. */
-type RecordedListener = {
-  event: string; /** The listener's function name, `"anonymous"` when it has none. */
-  name: string; /** Project-relative file whose import registered it. */
+export type RecordedListener = {
+  event: string;
+  /** The listener's function name, `"anonymous"` when it has none. */
+  name: string;
+  /** Project-relative file whose import registered it. */
   sourceFile: string;
 };
 /**
@@ -17,7 +18,7 @@ type RecordedListener = {
  * at that moment. Listeners registered outside an app module import (by the
  * framework itself) are not app facts and are not recorded.
  */
-declare class EventRecorder {
+export declare class EventRecorder {
   private readonly records;
   private readonly restores;
   /**
@@ -31,7 +32,6 @@ declare class EventRecorder {
   list(): RecordedListener[];
 }
 /** Group recorded listeners by event, sorted, for the report. */
-declare function groupListeners(records: readonly RecordedListener[]): InspectEvent[];
+export declare function groupListeners(records: readonly RecordedListener[]): InspectEvent[];
 //#endregion
-export { EventRecorder, RecordedListener, groupListeners };
 //# sourceMappingURL=event-recorder.d.mts.map

package/esm/tooling/inspect/event-recorder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"event-recorder.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/event-recorder.ts"],"mappings":";;;;KAIY,gBAAA;EACV,KAAA,UAD0B;EAG1B,IAAA,UAH0B;EAK1B,UAAA;AAAA;;;AAAU;AA6CZ;;;;;;;cAAa,aAAA;EAAA,iBACM,OAAA;EAAA,iBAEA,QAAA;EAkDF;;AAAgB;AAMjC;EAlDS,KAAA,CAAM,KAAA;;EAmCN,IAAA;EAewC;EANxC,IAAA,IAAQ,gBAAgB;AAAA;;iBAMjB,cAAA,CAAe,OAAA,WAAkB,gBAAA,KAAqB,YAAY"}
+{"version":3,"file":"event-recorder.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/event-recorder.ts"],"mappings":";;;YAIY;EACV;;EAEA;;EAEA;;;;;;;;;;;;qBA6CW;mBACM;mBAEA;;;;;EAMV,MAAM;;EAmCN;;EASA,QAAQ;;;wBAMD,eAAe,kBAAkB,qBAAqB"}

package/esm/tooling/inspect/index.d.mts

@@ -4,4 +4,5 @@ import { InspectModelModule } from "./collect-models.mjs";
 import { AppModuleImporter } from "./collect-packages.mjs";
 import { InspectOptions, inspectApp, isInspectSection, parseInspectSections } from "./inspect-app.mjs";
 import { InspectBootResult, bootForInspect, inspectOptionsFromBoot } from "./boot-for-inspect.mjs";
-import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect-report.schema.mjs";
+import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect-report.schema.mjs";
+export { type AppModuleImporter, EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, type InspectBootResult, InspectConfigKey, InspectEvent, InspectJob, InspectModel, InspectModelColumn, type InspectModelModule, InspectModelRelation, type InspectOptions, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema, type RecordedListener, bootForInspect, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };

package/esm/tooling/inspect/index.mjs

@@ -4,4 +4,4 @@ import { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS } from "./inspect-report.types
 import { inspectApp, isInspectSection, parseInspectSections } from "./inspect-app.mjs";
 import { INSPECT_REPORT_JSON_SCHEMA } from "./inspect-report.schema.mjs";
 
-export {  };
+export { EventRecorder, INSPECT_REPORT_JSON_SCHEMA, INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, bootForInspect, groupListeners, inspectApp, inspectOptionsFromBoot, isInspectSection, parseInspectSections };

package/esm/tooling/inspect/inspect-app.d.mts

@@ -3,37 +3,47 @@ import { InspectReport, InspectSection, InspectWarning } from "./inspect-report.
 import { RecordedListener } from "./event-recorder.mjs";
 import { InspectModelModule } from "./collect-models.mjs";
 import { AppModuleImporter } from "./collect-packages.mjs";
-
 //#region ../../packages/core/src/tooling/inspect/inspect-app.d.ts
 /** Inputs of {@link inspectApp}. Every field is optional. */
-type InspectOptions = {
-  /** Project root. Default: `process.cwd()`. */cwd?: string; /** The sections to include. Default: all of {@link INSPECT_SECTIONS}. */
-  sections?: readonly InspectSection[]; /** The routes to describe. Default: `router.list()`. */
-  routes?: readonly Route[]; /** Model modules the boot pass imported (their exports are scanned for model classes). */
-  modelModules?: readonly InspectModelModule[]; /** Listeners recorded while app modules were imported (see `EventRecorder`). */
-  events?: readonly RecordedListener[]; /** Warnings found before inspecting (by the boot pass); listed first. */
-  warnings?: readonly InspectWarning[]; /** App modules that failed to import; each becomes a `WL2001` warning. */
+export type InspectOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** The sections to include. Default: all of {@link INSPECT_SECTIONS}. */
+  sections?: readonly InspectSection[];
+  /** The routes to describe. Default: `router.list()`. */
+  routes?: readonly Route[];
+  /** Model modules the boot pass imported (their exports are scanned for model classes). */
+  modelModules?: readonly InspectModelModule[];
+  /** Listeners recorded while app modules were imported (see `EventRecorder`). */
+  events?: readonly RecordedListener[];
+  /** Warnings found before inspecting (by the boot pass); listed first. */
+  warnings?: readonly InspectWarning[];
+  /** App modules that failed to import; each becomes a `WL2001` warning. */
   moduleFailures?: readonly {
     file: string;
     message: string;
-  }[]; /** The `web` connector's installed pages. Default: read from the registered connectors. */
+  }[];
+  /** The `web` connector's installed pages. Default: read from the registered connectors. */
   pages?: readonly unknown[];
   /**
    * Name a resource class in `components.schemas`, usually by its export name
    * (`PostResource`). Unnamed resources fall back to the class name.
    */
-  resolveResourceName?: (resource: unknown) => string | undefined; /** The loaded config tree. Default: everything `config` holds. */
-  config?: Record<string, unknown>; /** How packages are imported as the app resolves them (`@warlock.js/queue`, `/scheduler`). */
-  importFromApp?: AppModuleImporter; /** Clock, for `generatedAt`. */
+  resolveResourceName?: (resource: unknown) => string | undefined;
+  /** The loaded config tree. Default: everything `config` holds. */
+  config?: Record<string, unknown>;
+  /** How packages are imported as the app resolves them (`@warlock.js/queue`, `/scheduler`). */
+  importFromApp?: AppModuleImporter;
+  /** Clock, for `generatedAt`. */
   now?: () => Date;
 };
 /** Whether a string is a section name. */
-declare function isInspectSection(value: string): value is InspectSection;
+export declare function isInspectSection(value: string): value is InspectSection;
 /**
  * Parse a `--section routes,models` value. Throws on an unknown name, listing
  * the valid ones. An empty value means every section.
  */
-declare function parseInspectSections(value: string | undefined): InspectSection[];
+export declare function parseInspectSections(value: string | undefined): InspectSection[];
 /**
  * Describe the application from its in-process registries: routes, models,
  * resources, config keys, event listeners, pages, queue jobs, scheduled
@@ -47,7 +57,6 @@ declare function parseInspectSections(value: string | undefined): InspectSection
  * const report = await inspectApp({ sections: ["routes"] });
  * report.routes?.filter((route) => !route.auth.required && route.method !== "GET");
  */
-declare function inspectApp(options?: InspectOptions): Promise<InspectReport>;
+export declare function inspectApp(options?: InspectOptions): Promise<InspectReport>;
 //#endregion
-export { InspectOptions, inspectApp, isInspectSection, parseInspectSections };
 //# sourceMappingURL=inspect-app.d.mts.map

package/esm/tooling/inspect/inspect-app.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-app.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-app.ts"],"mappings":";;;;;;;;KA0BY,cAAA;EAAA,8CAEV,GAAA;EAEA,QAAA,YAAoB,cAAA,IAEF;EAAlB,MAAA,YAAkB,KAAA,IAIA;EAFlB,YAAA,YAAwB,kBAAA,IAef;EAbT,MAAA,YAAkB,gBAAA,IAiBN;EAfZ,QAAA,YAAoB,cAAA,IAeJ;EAbhB,cAAA;IAA4B,IAAA;IAAc,OAAA;EAAA,KARxB;EAUlB,KAAA;EARwB;;;;EAaxB,mBAAA,IAAuB,QAAA,kCAPvB;EASA,MAAA,GAAS,MAAA,mBATiC;EAW1C,aAAA,GAAgB,iBAAA,EAJhB;EAMA,GAAA,SAAY,IAAA;AAAA;;iBAIE,gBAAA,CAAiB,KAAA,WAAgB,KAAA,IAAS,cAAc;;;;;iBAQxD,oBAAA,CAAqB,KAAA,uBAA4B,cAAc;AAR/E;;;;;;;;AAAwE;AAQxE;;;;AARA,iBAuCsB,UAAA,CAAW,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,aAAA"}
+{"version":3,"file":"inspect-app.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-app.ts"],"mappings":";;;;;;;YA0BY;;EAEV;;EAEA,oBAAoB;;EAEpB,kBAAkB;;EAElB,wBAAwB;;EAExB,kBAAkB;;EAElB,oBAAoB;;EAEpB;IAA4B;IAAc;;;EAE1C;;;;;EAKA,uBAAuB;;EAEvB,SAAS;;EAET,gBAAgB;;EAEhB,YAAY;;;wBAIE,iBAAiB,gBAAgB,SAAS;;;;;wBAQ1C,qBAAqB,4BAA4B;;;;;;;;;;;;;;wBA+B3C,WAAW,UAAS,iBAAsB,QAAQ"}

package/esm/tooling/inspect/inspect-report.schema.d.mts

@@ -9,7 +9,6 @@
  * validator written today must accept tomorrow's reports.
  */
 /** The report's JSON Schema, draft 2020-12. */
-declare const INSPECT_REPORT_JSON_SCHEMA: Record<string, unknown>;
+export declare const INSPECT_REPORT_JSON_SCHEMA: Record<string, unknown>;
 //#endregion
-export { INSPECT_REPORT_JSON_SCHEMA };
 //# sourceMappingURL=inspect-report.schema.d.mts.map

package/esm/tooling/inspect/inspect-report.schema.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-report.schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-report.schema.ts"],"mappings":";;AAkRA;;;;AAA+C;;;;;cAAlC,0BAAA,EAA4B,MAAM"}
+{"version":3,"file":"inspect-report.schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-report.schema.ts"],"mappings":";;;;;;;;;;;qBAkRa,4BAA4B"}