@warlock.js/core 5.31.0 → 5.32.0

package/esm/tooling/check/tests-step.d.mts

@@ -1,34 +1,33 @@
 import { ToolingProblem } from "../problem.mjs";
-
 //#region ../../packages/core/src/tooling/check/tests-step.d.ts
 /** How a vitest run ended: its exit code, output, and the JSON report if one was written. */
-type VitestRun = {
+export type VitestRun = {
   code: number | null;
   signal: string | null;
   stdout: string;
-  stderr: string; /** The `--reporter=json` report, parsed; `undefined` when none was written. */
+  stderr: string;
+  /** The `--reporter=json` report, parsed; `undefined` when none was written. */
   report: unknown;
 };
 /** Runs the app's vitest with the given arguments. Injectable for tests. */
-type VitestRunner = (binary: string, args: readonly string[], cwd: string) => Promise<VitestRun>;
+export type VitestRunner = (binary: string, args: readonly string[], cwd: string) => Promise<VitestRun>;
 /**
  * The app's own vitest CLI entry, resolved from the app root — never a global
  * install — or `undefined` when the app does not have vitest.
  */
-declare function findVitest(cwd: string): string | undefined;
+export declare function findVitest(cwd: string): string | undefined;
 /**
  * The default {@link VitestRunner}: `node <vitest> <args> --reporter=json
  * --outputFile=<tmp>`, reading the report back from the file so test output on
  * stdout cannot corrupt it.
  */
-declare const runVitest: VitestRunner;
+export declare const runVitest: VitestRunner;
 /**
  * Turn vitest's JSON report (the Jest-compatible shape `--reporter=json`
  * writes) into problems: a failed test is `WL7301`, a file that failed before
  * its tests ran is `WL7302`, and a failure caused by an unreachable service or
  * a busy port is the matching environment code instead.
  */
-declare function parseVitestReport(report: unknown, cwd: string): ToolingProblem[];
+export declare function parseVitestReport(report: unknown, cwd: string): ToolingProblem[];
 //#endregion
-export { VitestRun, VitestRunner, findVitest, parseVitestReport, runVitest };
 //# sourceMappingURL=tests-step.d.mts.map

package/esm/tooling/check/tests-step.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tests-step.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/tests-step.ts"],"mappings":";;;;KASY,SAAA;EACV,IAAA;EACA,MAAA;EACA,MAAA;EACA,MAAA,UAHA;EAKA,MAAA;AAAA;;KAIU,YAAA,IACV,MAAA,UACA,IAAA,qBACA,GAAA,aACG,OAAO,CAAC,SAAA;;AARL;AAIR;;iBAagB,UAAA,CAAW,GAAW;;;;;;cA6BzB,SAAA,EAAW,YAoCvB;AAsDD;;;;;;AAAA,iBAAgB,iBAAA,CAAkB,MAAA,WAAiB,GAAA,WAAc,cAAc"}
+{"version":3,"file":"tests-step.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/check/tests-step.ts"],"mappings":";;;YASY;EACV;EACA;EACA;EACA;;EAEA;;;YAIU,gBACV,gBACA,yBACA,gBACG,QAAQ;;;;;wBASG,WAAW;;;;;;qBA6Bd,WAAW;;;;;;;wBA0FR,kBAAkB,iBAAiB,cAAc"}

package/esm/tooling/check/tests-step.mjs

@@ -8,7 +8,7 @@ import os from "node:os";
 
 //#region ../../packages/core/src/tooling/check/tests-step.ts
 /** Ten minutes: a suite slower than that is reported as a crashed tool, not a failure. */
-const TEST_TIMEOUT_MS = 600 * 1e3;
+const TEST_TIMEOUT_MS = 6e5;
 /**
 * The app's own vitest CLI entry, resolved from the app root — never a global
 * install — or `undefined` when the app does not have vitest.
@@ -45,7 +45,7 @@ const runVitest = (binary, args, cwd) => {
 			encoding: "utf8",
 			windowsHide: true,
 			timeout: TEST_TIMEOUT_MS,
-			maxBuffer: 64 * 1024 * 1024,
+			maxBuffer: 67108864,
 			env: {
 				...process.env,
 				CI: process.env.CI ?? "1"
@@ -173,5 +173,5 @@ function vitestRunFailure(run) {
 }
 
 //#endregion
-export { findVitest, parseVitestReport, runVitest, vitestArguments, vitestRunFailure };
+export { environmentCodeOf, findVitest, parseVitestReport, runVitest, vitestArguments, vitestRunFailure };
 //# sourceMappingURL=tests-step.mjs.map

package/esm/tooling/check/tests-step.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tests-step.mjs","names":["relative"],"sources":["../../../../../../../../../packages/core/src/tooling/check/tests-step.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { existsSync, mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { errorCodeOf } from \"../../errors/error-codes\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\n\n/** How a vitest run ended: its exit code, output, and the JSON report if one was written. */\nexport type VitestRun = {\n  code: number | null;\n  signal: string | null;\n  stdout: string;\n  stderr: string;\n  /** The `--reporter=json` report, parsed; `undefined` when none was written. */\n  report: unknown;\n};\n\n/** Runs the app's vitest with the given arguments. Injectable for tests. */\nexport type VitestRunner = (\n  binary: string,\n  args: readonly string[],\n  cwd: string,\n) => Promise<VitestRun>;\n\n/** Ten minutes: a suite slower than that is reported as a crashed tool, not a failure. */\nconst TEST_TIMEOUT_MS = 10 * 60 * 1000;\n\n/**\n * The app's own vitest CLI entry, resolved from the app root — never a global\n * install — or `undefined` when the app does not have vitest.\n */\nexport function findVitest(cwd: string): string | undefined {\n  try {\n    const require = createRequire(path.join(cwd, \"package.json\"));\n    const manifestPath = require.resolve(\"vitest/package.json\");\n    const manifest: unknown = JSON.parse(readFileSync(manifestPath, \"utf8\"));\n    const bin =\n      typeof manifest === \"object\" && manifest !== null ? Reflect.get(manifest, \"bin\") : undefined;\n    const entry =\n      typeof bin === \"string\"\n        ? bin\n        : typeof bin === \"object\" && bin !== null\n          ? Reflect.get(bin, \"vitest\")\n          : undefined;\n\n    if (typeof entry !== \"string\") return undefined;\n\n    const binary = path.resolve(path.dirname(manifestPath), entry);\n\n    return existsSync(binary) ? binary : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The default {@link VitestRunner}: `node <vitest> <args> --reporter=json\n * --outputFile=<tmp>`, reading the report back from the file so test output on\n * stdout cannot corrupt it.\n */\nexport const runVitest: VitestRunner = (binary, args, cwd) => {\n  const directory = mkdtempSync(path.join(os.tmpdir(), \"warlock-check-vitest-\"));\n  const outputFile = path.join(directory, \"report.json\");\n\n  return new Promise((resolve) => {\n    execFile(\n      process.execPath,\n      [binary, ...args, \"--reporter=json\", `--outputFile=${outputFile}`],\n      {\n        cwd,\n        encoding: \"utf8\",\n        windowsHide: true,\n        timeout: TEST_TIMEOUT_MS,\n        maxBuffer: 64 * 1024 * 1024,\n        env: { ...process.env, CI: process.env.CI ?? \"1\" },\n      },\n      (error, stdout, stderr) => {\n        let report: unknown;\n\n        try {\n          report = JSON.parse(readFileSync(outputFile, \"utf8\"));\n        } catch {\n          report = undefined;\n        }\n\n        rmSync(directory, { recursive: true, force: true });\n        resolve({\n          code: error === null ? 0 : typeof error.code === \"number\" ? error.code : null,\n          signal: error?.signal ?? null,\n          stdout,\n          stderr,\n          report,\n        });\n      },\n    );\n  });\n};\n\n/**\n * The vitest arguments for a run. Verified against `vitest --help` (4.1):\n * `run` executes once without watch; `related <files> --run` runs only the\n * tests that import the given source files; `--passWithNoTests` exits 0 when\n * nothing matches; `--reporter=json --outputFile=<file>` writes the report.\n */\nexport function vitestArguments(files: readonly string[] | null): string[] {\n  if (files === null) return [\"run\", \"--passWithNoTests\"];\n\n  return [\"related\", ...files, \"--run\", \"--passWithNoTests\"];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** ANSI color sequences, which vitest leaves in failure messages. */\nconst ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;]*m`, \"g\");\n\n/** The first meaningful lines of a failure message, bounded for one JSON field. */\nfunction summarize(message: string): string {\n  const text = message.replace(ANSI_SEQUENCE, \"\").trim();\n\n  return text.length > 1000 ? `${text.slice(0, 1000)}…` : text;\n}\n\n/**\n * Whether a failure message shows the machine rather than the code: a\n * refused/unreachable service (`WL8003`) or a port already taken (`WL8004`).\n */\nexport function environmentCodeOf(message: string): \"WL8003\" | \"WL8004\" | undefined {\n  const errno = /\\b(ECONNREFUSED|ENOTFOUND|EHOSTUNREACH|EADDRINUSE)\\b/.exec(message)?.[1];\n\n  if (!errno) return undefined;\n\n  const code = errorCodeOf({ code: errno });\n\n  return code === \"WL8003\" || code === \"WL8004\" ? code : undefined;\n}\n\nfunction relative(cwd: string, file: unknown): string | null {\n  if (typeof file !== \"string\" || file.length === 0) return null;\n\n  return (path.isAbsolute(file) ? path.relative(cwd, file) : file).split(path.sep).join(\"/\");\n}\n\n/**\n * Turn vitest's JSON report (the Jest-compatible shape `--reporter=json`\n * writes) into problems: a failed test is `WL7301`, a file that failed before\n * its tests ran is `WL7302`, and a failure caused by an unreachable service or\n * a busy port is the matching environment code instead.\n */\nexport function parseVitestReport(report: unknown, cwd: string): ToolingProblem[] {\n  if (!isRecord(report) || !Array.isArray(report.testResults)) return [];\n\n  const problems: ToolingProblem[] = [];\n\n  for (const suite of report.testResults) {\n    if (!isRecord(suite)) continue;\n\n    const file = relative(cwd, suite.name);\n    const assertions = Array.isArray(suite.assertionResults) ? suite.assertionResults : [];\n    const failed = assertions.filter(\n      (assertion): assertion is Record<string, unknown> =>\n        isRecord(assertion) && assertion.status === \"failed\",\n    );\n\n    for (const assertion of failed) {\n      const messages = Array.isArray(assertion.failureMessages)\n        ? assertion.failureMessages.filter(\n            (message): message is string => typeof message === \"string\",\n          )\n        : [];\n      const message = summarize(messages.join(\"\\n\") || \"Test failed.\");\n      const location = isRecord(assertion.location) ? assertion.location : undefined;\n      const name =\n        typeof assertion.fullName === \"string\"\n          ? assertion.fullName\n          : typeof assertion.title === \"string\"\n            ? assertion.title\n            : null;\n      const environment = environmentCodeOf(message);\n\n      problems.push(\n        createProblem({\n          code: environment ?? \"WL7301\",\n          source: environment ? \"environment\" : \"vitest\",\n          message,\n          file,\n          line: typeof location?.line === \"number\" ? location.line : null,\n          column: typeof location?.column === \"number\" ? location.column : null,\n          rule: name,\n        }),\n      );\n    }\n\n    const suiteMessage = typeof suite.message === \"string\" ? suite.message.trim() : \"\";\n\n    if (suite.status === \"failed\" && failed.length === 0) {\n      const message = summarize(suiteMessage || \"The test file failed before its tests ran.\");\n      const environment = environmentCodeOf(message);\n\n      problems.push(\n        createProblem({\n          code: environment ?? \"WL7302\",\n          source: environment ? \"environment\" : \"vitest\",\n          message,\n          file,\n        }),\n      );\n    }\n  }\n\n  return problems;\n}\n\n/**\n * Problems for a vitest run that produced no report: a crash, a timeout or a\n * signal is the tool (`WL8007`); an exit without a report after a config or\n * import error is the code (`WL7302`).\n */\nexport function vitestRunFailure(run: VitestRun): ToolingProblem[] {\n  const output = summarize(`${run.stderr}\\n${run.stdout}`) || \"vitest wrote no report.\";\n\n  if (\n    run.signal !== null ||\n    run.code === null ||\n    run.code > 1 ||\n    /heap out of memory/i.test(output)\n  ) {\n    return [\n      createProblem({\n        code: \"WL8007\",\n        source: \"environment\",\n        message: `vitest ${run.signal ? `was killed (${run.signal})` : `exited with ${run.code ?? \"no code\"}`}: ${output}`,\n      }),\n    ];\n  }\n\n  const environment = environmentCodeOf(output);\n\n  return [\n    createProblem({\n      code: environment ?? \"WL7302\",\n      source: environment ? \"environment\" : \"vitest\",\n      message: output,\n    }),\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"tests-step.mjs","names":["relative"],"sources":["../../../../../../../../../packages/core/src/tooling/check/tests-step.ts"],"sourcesContent":["import { execFile } from \"node:child_process\";\nimport { existsSync, mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { errorCodeOf } from \"../../errors/error-codes\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\n\n/** How a vitest run ended: its exit code, output, and the JSON report if one was written. */\nexport type VitestRun = {\n  code: number | null;\n  signal: string | null;\n  stdout: string;\n  stderr: string;\n  /** The `--reporter=json` report, parsed; `undefined` when none was written. */\n  report: unknown;\n};\n\n/** Runs the app's vitest with the given arguments. Injectable for tests. */\nexport type VitestRunner = (\n  binary: string,\n  args: readonly string[],\n  cwd: string,\n) => Promise<VitestRun>;\n\n/** Ten minutes: a suite slower than that is reported as a crashed tool, not a failure. */\nconst TEST_TIMEOUT_MS = 10 * 60 * 1000;\n\n/**\n * The app's own vitest CLI entry, resolved from the app root — never a global\n * install — or `undefined` when the app does not have vitest.\n */\nexport function findVitest(cwd: string): string | undefined {\n  try {\n    const require = createRequire(path.join(cwd, \"package.json\"));\n    const manifestPath = require.resolve(\"vitest/package.json\");\n    const manifest: unknown = JSON.parse(readFileSync(manifestPath, \"utf8\"));\n    const bin =\n      typeof manifest === \"object\" && manifest !== null ? Reflect.get(manifest, \"bin\") : undefined;\n    const entry =\n      typeof bin === \"string\"\n        ? bin\n        : typeof bin === \"object\" && bin !== null\n          ? Reflect.get(bin, \"vitest\")\n          : undefined;\n\n    if (typeof entry !== \"string\") return undefined;\n\n    const binary = path.resolve(path.dirname(manifestPath), entry);\n\n    return existsSync(binary) ? binary : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The default {@link VitestRunner}: `node <vitest> <args> --reporter=json\n * --outputFile=<tmp>`, reading the report back from the file so test output on\n * stdout cannot corrupt it.\n */\nexport const runVitest: VitestRunner = (binary, args, cwd) => {\n  const directory = mkdtempSync(path.join(os.tmpdir(), \"warlock-check-vitest-\"));\n  const outputFile = path.join(directory, \"report.json\");\n\n  return new Promise((resolve) => {\n    execFile(\n      process.execPath,\n      [binary, ...args, \"--reporter=json\", `--outputFile=${outputFile}`],\n      {\n        cwd,\n        encoding: \"utf8\",\n        windowsHide: true,\n        timeout: TEST_TIMEOUT_MS,\n        maxBuffer: 64 * 1024 * 1024,\n        env: { ...process.env, CI: process.env.CI ?? \"1\" },\n      },\n      (error, stdout, stderr) => {\n        let report: unknown;\n\n        try {\n          report = JSON.parse(readFileSync(outputFile, \"utf8\"));\n        } catch {\n          report = undefined;\n        }\n\n        rmSync(directory, { recursive: true, force: true });\n        resolve({\n          code: error === null ? 0 : typeof error.code === \"number\" ? error.code : null,\n          signal: error?.signal ?? null,\n          stdout,\n          stderr,\n          report,\n        });\n      },\n    );\n  });\n};\n\n/**\n * The vitest arguments for a run. Verified against `vitest --help` (4.1):\n * `run` executes once without watch; `related <files> --run` runs only the\n * tests that import the given source files; `--passWithNoTests` exits 0 when\n * nothing matches; `--reporter=json --outputFile=<file>` writes the report.\n */\nexport function vitestArguments(files: readonly string[] | null): string[] {\n  if (files === null) return [\"run\", \"--passWithNoTests\"];\n\n  return [\"related\", ...files, \"--run\", \"--passWithNoTests\"];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** ANSI color sequences, which vitest leaves in failure messages. */\nconst ANSI_SEQUENCE = new RegExp(`${String.fromCharCode(27)}\\\\[[0-9;]*m`, \"g\");\n\n/** The first meaningful lines of a failure message, bounded for one JSON field. */\nfunction summarize(message: string): string {\n  const text = message.replace(ANSI_SEQUENCE, \"\").trim();\n\n  return text.length > 1000 ? `${text.slice(0, 1000)}…` : text;\n}\n\n/**\n * Whether a failure message shows the machine rather than the code: a\n * refused/unreachable service (`WL8003`) or a port already taken (`WL8004`).\n */\nexport function environmentCodeOf(message: string): \"WL8003\" | \"WL8004\" | undefined {\n  const errno = /\\b(ECONNREFUSED|ENOTFOUND|EHOSTUNREACH|EADDRINUSE)\\b/.exec(message)?.[1];\n\n  if (!errno) return undefined;\n\n  const code = errorCodeOf({ code: errno });\n\n  return code === \"WL8003\" || code === \"WL8004\" ? code : undefined;\n}\n\nfunction relative(cwd: string, file: unknown): string | null {\n  if (typeof file !== \"string\" || file.length === 0) return null;\n\n  return (path.isAbsolute(file) ? path.relative(cwd, file) : file).split(path.sep).join(\"/\");\n}\n\n/**\n * Turn vitest's JSON report (the Jest-compatible shape `--reporter=json`\n * writes) into problems: a failed test is `WL7301`, a file that failed before\n * its tests ran is `WL7302`, and a failure caused by an unreachable service or\n * a busy port is the matching environment code instead.\n */\nexport function parseVitestReport(report: unknown, cwd: string): ToolingProblem[] {\n  if (!isRecord(report) || !Array.isArray(report.testResults)) return [];\n\n  const problems: ToolingProblem[] = [];\n\n  for (const suite of report.testResults) {\n    if (!isRecord(suite)) continue;\n\n    const file = relative(cwd, suite.name);\n    const assertions = Array.isArray(suite.assertionResults) ? suite.assertionResults : [];\n    const failed = assertions.filter(\n      (assertion): assertion is Record<string, unknown> =>\n        isRecord(assertion) && assertion.status === \"failed\",\n    );\n\n    for (const assertion of failed) {\n      const messages = Array.isArray(assertion.failureMessages)\n        ? assertion.failureMessages.filter(\n            (message): message is string => typeof message === \"string\",\n          )\n        : [];\n      const message = summarize(messages.join(\"\\n\") || \"Test failed.\");\n      const location = isRecord(assertion.location) ? assertion.location : undefined;\n      const name =\n        typeof assertion.fullName === \"string\"\n          ? assertion.fullName\n          : typeof assertion.title === \"string\"\n            ? assertion.title\n            : null;\n      const environment = environmentCodeOf(message);\n\n      problems.push(\n        createProblem({\n          code: environment ?? \"WL7301\",\n          source: environment ? \"environment\" : \"vitest\",\n          message,\n          file,\n          line: typeof location?.line === \"number\" ? location.line : null,\n          column: typeof location?.column === \"number\" ? location.column : null,\n          rule: name,\n        }),\n      );\n    }\n\n    const suiteMessage = typeof suite.message === \"string\" ? suite.message.trim() : \"\";\n\n    if (suite.status === \"failed\" && failed.length === 0) {\n      const message = summarize(suiteMessage || \"The test file failed before its tests ran.\");\n      const environment = environmentCodeOf(message);\n\n      problems.push(\n        createProblem({\n          code: environment ?? \"WL7302\",\n          source: environment ? \"environment\" : \"vitest\",\n          message,\n          file,\n        }),\n      );\n    }\n  }\n\n  return problems;\n}\n\n/**\n * Problems for a vitest run that produced no report: a crash, a timeout or a\n * signal is the tool (`WL8007`); an exit without a report after a config or\n * import error is the code (`WL7302`).\n */\nexport function vitestRunFailure(run: VitestRun): ToolingProblem[] {\n  const output = summarize(`${run.stderr}\\n${run.stdout}`) || \"vitest wrote no report.\";\n\n  if (\n    run.signal !== null ||\n    run.code === null ||\n    run.code > 1 ||\n    /heap out of memory/i.test(output)\n  ) {\n    return [\n      createProblem({\n        code: \"WL8007\",\n        source: \"environment\",\n        message: `vitest ${run.signal ? `was killed (${run.signal})` : `exited with ${run.code ?? \"no code\"}`}: ${output}`,\n      }),\n    ];\n  }\n\n  const environment = environmentCodeOf(output);\n\n  return [\n    createProblem({\n      code: environment ?? \"WL7302\",\n      source: environment ? \"environment\" : \"vitest\",\n      message: output,\n    }),\n  ];\n}\n"],"mappings":";;;;;;;;;;AA0BA,MAAM,kBAAkB;;;;;AAMxB,SAAgB,WAAW,KAAiC;CAC1D,IAAI;EAEF,MAAM,eADU,cAAc,KAAK,KAAK,KAAK,cAAc,CAChC,CAAC,CAAC,QAAQ,qBAAqB;EAC1D,MAAM,WAAoB,KAAK,MAAM,aAAa,cAAc,MAAM,CAAC;EACvE,MAAM,MACJ,OAAO,aAAa,YAAY,aAAa,OAAO,QAAQ,IAAI,UAAU,KAAK,IAAI;EACrF,MAAM,QACJ,OAAO,QAAQ,WACX,MACA,OAAO,QAAQ,YAAY,QAAQ,OACjC,QAAQ,IAAI,KAAK,QAAQ,IACzB;EAER,IAAI,OAAO,UAAU,UAAU,OAAO;EAEtC,MAAM,SAAS,KAAK,QAAQ,KAAK,QAAQ,YAAY,GAAG,KAAK;EAE7D,OAAO,WAAW,MAAM,IAAI,SAAS;CACvC,QAAQ;EACN;CACF;AACF;;;;;;AAOA,MAAa,aAA2B,QAAQ,MAAM,QAAQ;CAC5D,MAAM,YAAY,YAAY,KAAK,KAAK,GAAG,OAAO,GAAG,uBAAuB,CAAC;CAC7E,MAAM,aAAa,KAAK,KAAK,WAAW,aAAa;CAErD,OAAO,IAAI,SAAS,YAAY;EAC9B,SACE,QAAQ,UACR;GAAC;GAAQ,GAAG;GAAM;GAAmB,gBAAgB;EAAY,GACjE;GACE;GACA,UAAU;GACV,aAAa;GACb,SAAS;GACT,WAAW;GACX,KAAK;IAAE,GAAG,QAAQ;IAAK,IAAI,QAAQ,IAAI,MAAM;GAAI;EACnD,IACC,OAAO,QAAQ,WAAW;GACzB,IAAI;GAEJ,IAAI;IACF,SAAS,KAAK,MAAM,aAAa,YAAY,MAAM,CAAC;GACtD,QAAQ;IACN,SAAS;GACX;GAEA,OAAO,WAAW;IAAE,WAAW;IAAM,OAAO;GAAK,CAAC;GAClD,QAAQ;IACN,MAAM,UAAU,OAAO,IAAI,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;IACzE,QAAQ,OAAO,UAAU;IACzB;IACA;IACA;GACF,CAAC;EACH,CACF;CACF,CAAC;AACH;;;;;;;AAQA,SAAgB,gBAAgB,OAA2C;CACzE,IAAI,UAAU,MAAM,OAAO,CAAC,OAAO,mBAAmB;CAEtD,OAAO;EAAC;EAAW,GAAG;EAAO;EAAS;CAAmB;AAC3D;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;AAGA,MAAM,gBAAgB,IAAI,OAAO,GAAG,OAAO,aAAa,EAAE,EAAE,cAAc,GAAG;;AAG7E,SAAS,UAAU,SAAyB;CAC1C,MAAM,OAAO,QAAQ,QAAQ,eAAe,EAAE,CAAC,CAAC,KAAK;CAErD,OAAO,KAAK,SAAS,MAAO,GAAG,KAAK,MAAM,GAAG,GAAI,EAAE,KAAK;AAC1D;;;;;AAMA,SAAgB,kBAAkB,SAAkD;CAClF,MAAM,QAAQ,uDAAuD,KAAK,OAAO,CAAC,GAAG;CAErF,IAAI,CAAC,OAAO,OAAO;CAEnB,MAAM,OAAO,YAAY,EAAE,MAAM,MAAM,CAAC;CAExC,OAAO,SAAS,YAAY,SAAS,WAAW,OAAO;AACzD;AAEA,SAASA,WAAS,KAAa,MAA8B;CAC3D,IAAI,OAAO,SAAS,YAAY,KAAK,WAAW,GAAG,OAAO;CAE1D,QAAQ,KAAK,WAAW,IAAI,IAAI,KAAK,SAAS,KAAK,IAAI,IAAI,KAAI,CAAE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC3F;;;;;;;AAQA,SAAgB,kBAAkB,QAAiB,KAA+B;CAChF,IAAI,CAAC,SAAS,MAAM,KAAK,CAAC,MAAM,QAAQ,OAAO,WAAW,GAAG,OAAO,CAAC;CAErE,MAAM,WAA6B,CAAC;CAEpC,KAAK,MAAM,SAAS,OAAO,aAAa;EACtC,IAAI,CAAC,SAAS,KAAK,GAAG;EAEtB,MAAM,OAAOA,WAAS,KAAK,MAAM,IAAI;EAErC,MAAM,UADa,MAAM,QAAQ,MAAM,gBAAgB,IAAI,MAAM,mBAAmB,CAAC,EAC5D,CAAC,QACvB,cACC,SAAS,SAAS,KAAK,UAAU,WAAW,QAChD;EAEA,KAAK,MAAM,aAAa,QAAQ;GAM9B,MAAM,UAAU,WALC,MAAM,QAAQ,UAAU,eAAe,IACpD,UAAU,gBAAgB,QACvB,YAA+B,OAAO,YAAY,QACrD,IACA,CAAC,EAC6B,CAAC,KAAK,IAAI,KAAK,cAAc;GAC/D,MAAM,WAAW,SAAS,UAAU,QAAQ,IAAI,UAAU,WAAW;GACrE,MAAM,OACJ,OAAO,UAAU,aAAa,WAC1B,UAAU,WACV,OAAO,UAAU,UAAU,WACzB,UAAU,QACV;GACR,MAAM,cAAc,kBAAkB,OAAO;GAE7C,SAAS,KACP,cAAc;IACZ,MAAM,eAAe;IACrB,QAAQ,cAAc,gBAAgB;IACtC;IACA;IACA,MAAM,OAAO,UAAU,SAAS,WAAW,SAAS,OAAO;IAC3D,QAAQ,OAAO,UAAU,WAAW,WAAW,SAAS,SAAS;IACjE,MAAM;GACR,CAAC,CACH;EACF;EAEA,MAAM,eAAe,OAAO,MAAM,YAAY,WAAW,MAAM,QAAQ,KAAK,IAAI;EAEhF,IAAI,MAAM,WAAW,YAAY,OAAO,WAAW,GAAG;GACpD,MAAM,UAAU,UAAU,gBAAgB,4CAA4C;GACtF,MAAM,cAAc,kBAAkB,OAAO;GAE7C,SAAS,KACP,cAAc;IACZ,MAAM,eAAe;IACrB,QAAQ,cAAc,gBAAgB;IACtC;IACA;GACF,CAAC,CACH;EACF;CACF;CAEA,OAAO;AACT;;;;;;AAOA,SAAgB,iBAAiB,KAAkC;CACjE,MAAM,SAAS,UAAU,GAAG,IAAI,OAAO,IAAI,IAAI,QAAQ,KAAK;CAE5D,IACE,IAAI,WAAW,QACf,IAAI,SAAS,QACb,IAAI,OAAO,KACX,sBAAsB,KAAK,MAAM,GAEjC,OAAO,CACL,cAAc;EACZ,MAAM;EACN,QAAQ;EACR,SAAS,UAAU,IAAI,SAAS,eAAe,IAAI,OAAO,KAAK,eAAe,IAAI,QAAQ,YAAY,IAAI;CAC5G,CAAC,CACH;CAGF,MAAM,cAAc,kBAAkB,MAAM;CAE5C,OAAO,CACL,cAAc;EACZ,MAAM,eAAe;EACrB,QAAQ,cAAc,gBAAgB;EACtC,SAAS;CACX,CAAC,CACH;AACF"}

package/esm/tooling/dev-state/dev-server-state.d.mts

@@ -1,6 +1,6 @@
 //#region ../../packages/core/src/tooling/dev-state/dev-server-state.d.ts
 /** Where `warlock dev` records the address of the running server, under the project root. */
-declare const DEV_SERVER_STATE_FILE = ".warlock/dev-server.json";
+export declare const DEV_SERVER_STATE_FILE = ".warlock/dev-server.json";
 /**
  * What a running `warlock dev` worker records about itself, so `warlock trace`
  * and `warlock mcp` can find it without guessing a port.
@@ -9,31 +9,35 @@ declare const DEV_SERVER_STATE_FILE = ".warlock/dev-server.json";
  * when the worker shuts down. A crashed worker can leave a stale file behind,
  * so readers confirm the server answers before trusting it.
  */
-type DevServerState = {
-  schemaVersion: 1; /** The worker process id (informational: readers never signal it). */
-  pid: number; /** The address to send requests to, e.g. `http://localhost:2030`. */
-  url: string; /** ISO time the worker became ready. */
-  startedAt: string; /** The devtools mount, when `@warlock.js/devtools` was registered. */
+export type DevServerState = {
+  schemaVersion: 1;
+  /** The worker process id (informational: readers never signal it). */
+  pid: number;
+  /** The address to send requests to, e.g. `http://localhost:2030`. */
+  url: string;
+  /** ISO time the worker became ready. */
+  startedAt: string;
+  /** The devtools mount, when `@warlock.js/devtools` was registered. */
   devtools: {
     path: string;
-  } | null; /** The MCP endpoint `warlock dev --mcp` serves, when it is on. */
+  } | null;
+  /** The MCP endpoint `warlock dev --mcp` serves, when it is on. */
   mcp: {
     url: string;
   } | null;
 };
 /** Narrow parsed JSON to a {@link DevServerState}; `undefined` for anything else. */
-declare function parseDevServerState(value: unknown): DevServerState | undefined;
+export declare function parseDevServerState(value: unknown): DevServerState | undefined;
 /** The recorded state, or `undefined` when no dev server recorded one. */
-declare function readDevServerState(cwd?: string): DevServerState | undefined;
+export declare function readDevServerState(cwd?: string): DevServerState | undefined;
 /** Record the state atomically (temp file + rename), creating `.warlock/` when needed. */
-declare function writeDevServerState(state: DevServerState, cwd?: string): void;
+export declare function writeDevServerState(state: DevServerState, cwd?: string): void;
 /** Merge fields into the recorded state; a no-op when there is none. */
-declare function updateDevServerState(patch: Partial<Omit<DevServerState, "schemaVersion">>, cwd?: string): void;
+export declare function updateDevServerState(patch: Partial<Omit<DevServerState, "schemaVersion">>, cwd?: string): void;
 /**
  * Remove the state file — only when it still belongs to `pid`, so a worker
  * that shuts down late never deletes the record of the worker that replaced it.
  */
-declare function removeDevServerState(pid?: number, cwd?: string): void;
+export declare function removeDevServerState(pid?: number, cwd?: string): void;
 //#endregion
-export { DEV_SERVER_STATE_FILE, DevServerState, parseDevServerState, readDevServerState, removeDevServerState, updateDevServerState, writeDevServerState };
 //# sourceMappingURL=dev-server-state.d.mts.map

package/esm/tooling/dev-state/dev-server-state.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server-state.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/dev-state/dev-server-state.ts"],"mappings":";;cAIa,qBAAA;;;;AAAqB;AAUlC;;;;KAAY,cAAA;EACV,aAAA,KAIA;EAFA,GAAA,UAMA;EAJA,GAAA,UAMA;EAJA,SAAA,UAIU;EAFV,QAAA;IAAY,IAAA;EAAA;EAEZ,GAAA;IAAO,GAAA;EAAA;AAAA;;iBAYO,mBAAA,CAAoB,KAAA,YAAiB,cAAc;AAsBI;AAAA,iBAAvD,kBAAA,CAAmB,GAAA,YAAsB,cAAc;;iBAavD,mBAAA,CAAoB,KAAA,EAAO,cAAc,EAAE,GAAA;;iBAU3C,oBAAA,CACd,KAAA,EAAO,OAAA,CAAQ,IAAA,CAAK,cAAA,qBACpB,GAAA;;;;AAZ4E;iBAyB9D,oBAAA,CAAqB,GAAA,WAAmB,GAAmB"}
+{"version":3,"file":"dev-server-state.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/dev-state/dev-server-state.ts"],"mappings":";;qBAIa;;;;;;;;;YAUD;EACV;;EAEA;;EAEA;;EAEA;;EAEA;IAAY;;;EAEZ;IAAO;;;;wBAYO,oBAAoB,iBAAiB;;wBAsBrC,mBAAmB,eAAsB;;wBAazC,oBAAoB,OAAO,gBAAgB;;wBAU3C,qBACd,OAAO,QAAQ,KAAK,mCACpB;;;;;wBAac,qBAAqB,cAAmB"}

package/esm/tooling/devtools/devtools-client.d.mts

@@ -7,18 +7,18 @@
  * optional dev dependency, and this module must load without it.
  */
 /** The devtools mount every app uses unless it wired devtools by hand. */
-declare const DEFAULT_DEVTOOLS_PATH = "/__warlock";
+export declare const DEFAULT_DEVTOOLS_PATH = "/__warlock";
 /** The `fetch` this client calls; injectable for tests. */
-type DevtoolsFetch = (input: string, init?: RequestInit) => Promise<Response>;
+export type DevtoolsFetch = (input: string, init?: RequestInit) => Promise<Response>;
 /** One timed phase: `route.match`, `middleware` (with `attrs.name`), `validation`, `handler`. */
-type DevtoolsPhaseRecord = {
+export type DevtoolsPhaseRecord = {
   name: string;
   startedAt: number;
   durationMs: number;
   attrs?: Record<string, unknown>;
 };
 /** The row `GET <path>/api/requests` returns. */
-type DevtoolsRequestSummaryRecord = {
+export type DevtoolsRequestSummaryRecord = {
   id: string;
   method: string;
   path: string;
@@ -30,37 +30,47 @@ type DevtoolsRequestSummaryRecord = {
   warningCount: number;
 };
 /** Everything devtools recorded for one request (`GET <path>/api/requests/:id`). */
-type DevtoolsRequestRecord = {
+export type DevtoolsRequestRecord = {
   id: string;
   method: string;
   path: string;
   route?: string;
   status?: number;
-  startedAt: number; /** Absent while the request is still in flight. */
+  startedAt: number;
+  /** Absent while the request is still in flight. */
   durationMs?: number;
   error?: string;
-  phases: DevtoolsPhaseRecord[]; /** Queries: `sql`/`collection`, `durationMs`, `shape`, `caller`, `error`. */
+  phases: DevtoolsPhaseRecord[];
+  /** Queries: `sql`/`collection`, `durationMs`, `shape`, `caller`, `error`. */
   queries: Record<string, unknown>[];
   cache: Record<string, unknown>[];
   logs: Record<string, unknown>[];
-  mails: string[]; /** `{ type: "n+1", message, shape, count, caller }` entries. */
+  mails: string[];
+  /** `{ type: "n+1", message, shape, count, caller }` entries. */
   warnings: Record<string, unknown>[];
 };
 /** Where the dev server and its devtools API live. */
-type DevtoolsEndpoint = {
-  /** The dev server origin, e.g. `http://localhost:2030`. */url: string; /** The devtools mount, e.g. `/__warlock`. */
+export type DevtoolsEndpoint = {
+  /** The dev server origin, e.g. `http://localhost:2030`. */
+  url: string;
+  /** The devtools mount, e.g. `/__warlock`. */
   devtoolsPath: string;
 };
 /** Options of {@link connectDevtools}. */
-type ConnectDevtoolsOptions = {
-  /** Project root, where `.warlock/dev-server.json` is read. Default: `process.cwd()`. */cwd?: string; /** The dev server address; overrides the recorded one. */
-  url?: string; /** The devtools mount; overrides the recorded one. */
+export type ConnectDevtoolsOptions = {
+  /** Project root, where `.warlock/dev-server.json` is read. Default: `process.cwd()`. */
+  cwd?: string;
+  /** The dev server address; overrides the recorded one. */
+  url?: string;
+  /** The devtools mount; overrides the recorded one. */
   devtoolsPath?: string;
   fetch?: DevtoolsFetch;
 };
 /** A connected devtools API. */
-type DevtoolsClient = DevtoolsEndpoint & {
-  /** The summaries devtools holds, newest last (the order the collector keeps). */listRequests(): Promise<DevtoolsRequestSummaryRecord[]>; /** One request's full record, or `undefined` when devtools does not hold it. */
+export type DevtoolsClient = DevtoolsEndpoint & {
+  /** The summaries devtools holds, newest last (the order the collector keeps). */
+  listRequests(): Promise<DevtoolsRequestSummaryRecord[]>;
+  /** One request's full record, or `undefined` when devtools does not hold it. */
   getRequest(id: string): Promise<DevtoolsRequestRecord | undefined>;
   /**
    * Poll until the request is recorded AND settled (`durationMs` set), or the
@@ -73,11 +83,11 @@ type DevtoolsClient = DevtoolsEndpoint & {
   }): Promise<DevtoolsRequestRecord | undefined>;
 };
 /** Narrow one summary row; `undefined` when it is not one. */
-declare function parseRequestSummary(value: unknown): DevtoolsRequestSummaryRecord | undefined;
+export declare function parseRequestSummary(value: unknown): DevtoolsRequestSummaryRecord | undefined;
 /** Narrow a full request record; `undefined` when it is not one. */
-declare function parseRequestRecord(value: unknown): DevtoolsRequestRecord | undefined;
+export declare function parseRequestRecord(value: unknown): DevtoolsRequestRecord | undefined;
 /** Where the dev server is: the explicit option, else `.warlock/dev-server.json`. Throws `WL8008`. */
-declare function resolveDevServerEndpoint(options?: ConnectDevtoolsOptions): DevtoolsEndpoint;
+export declare function resolveDevServerEndpoint(options?: ConnectDevtoolsOptions): DevtoolsEndpoint;
 /**
  * Connect to the devtools API of the running dev server.
  *
@@ -85,7 +95,6 @@ declare function resolveDevServerEndpoint(options?: ConnectDevtoolsOptions): Dev
  * `WL8009` when it answers but devtools is not mounted (404, or anything that
  * is not the devtools JSON).
  */
-declare function connectDevtools(options?: ConnectDevtoolsOptions): Promise<DevtoolsClient>;
+export declare function connectDevtools(options?: ConnectDevtoolsOptions): Promise<DevtoolsClient>;
 //#endregion
-export { ConnectDevtoolsOptions, DEFAULT_DEVTOOLS_PATH, DevtoolsClient, DevtoolsEndpoint, DevtoolsFetch, DevtoolsPhaseRecord, DevtoolsRequestRecord, DevtoolsRequestSummaryRecord, connectDevtools, parseRequestRecord, parseRequestSummary, resolveDevServerEndpoint };
 //# sourceMappingURL=devtools-client.d.mts.map

package/esm/tooling/devtools/devtools-client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"devtools-client.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/devtools/devtools-client.ts"],"mappings":";;AAYA;;;;AAAkC;AAGlC;;cAHa,qBAAA;;KAGD,aAAA,IAAiB,KAAA,UAAe,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,QAAA;;KAG/D,mBAAA;EACV,IAAA;EACA,SAAA;EACA,UAAA;EACA,KAAA,GAAQ,MAAM;AAAA;;KAIJ,4BAAA;EACV,EAAA;EACA,MAAA;EACA,IAAA;EACA,KAAA;EACA,MAAA;EACA,SAAA;EACA,UAAA;EACA,UAAA;EACA,YAAA;AAAA;;KAIU,qBAAA;EACV,EAAA;EACA,MAAA;EACA,IAAA;EACA,KAAA;EACA,MAAA;EACA,SAAA,UAhBA;EAkBA,UAAA;EACA,KAAA;EACA,MAAA,EAAQ,mBAAA,IAhBR;EAkBA,OAAA,EAAS,MAAA;EACT,KAAA,EAAO,MAAA;EACP,IAAA,EAAM,MAAA;EACN,KAAA,YAfU;EAiBV,QAAA,EAAU,MAAA;AAAA;;KAIA,gBAAA;EARH,2DAUP,GAAA,UANU;EAQV,YAAY;AAAA;;KAIF,sBAAA;EA1BV,wFA4BA,GAAA,WA1BA;EA4BA,GAAA,WAzBA;EA2BA,YAAA;EACA,KAAA,GAAQ,aAAa;AAAA;;KAIX,cAAA,GAAiB,gBAAA;EA3B3B,iFA6BA,YAAA,IAAgB,OAAA,CAAQ,4BAAA,KA5BxB;EA8BA,UAAA,CAAW,EAAA,WAAa,OAAA,CAAQ,qBAAA;EA7BhC;;;;AAEgB;EAiChB,cAAA,CACE,EAAA,UACA,OAAA;IAAY,SAAA;IAAoB,UAAA;EAAA,IAC/B,OAAA,CAAQ,qBAAA;AAAA;AAxBb;AAAA,iBA4CgB,mBAAA,CAAoB,KAAA,YAAiB,4BAA4B;;iBAmBjE,kBAAA,CAAmB,KAAA,YAAiB,qBAAqB;;iBAsDzD,wBAAA,CAAyB,OAAA,GAAS,sBAAA,GAA8B,gBAAgB;;;;;AA9GzE;AAIvB;;iBAmIsB,eAAA,CACpB,OAAA,GAAS,sBAAA,GACR,OAAA,CAAQ,cAAA"}
+{"version":3,"file":"devtools-client.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/devtools/devtools-client.ts"],"mappings":";;;;;;;;;qBAYa;;YAGD,iBAAiB,eAAe,OAAO,gBAAgB,QAAQ;;YAG/D;EACV;EACA;EACA;EACA,QAAQ;;;YAIE;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;YAIU;EACV;EACA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA,QAAQ;;EAER,SAAS;EACT,OAAO;EACP,MAAM;EACN;;EAEA,UAAU;;;YAIA;;EAEV;;EAEA;;;YAIU;;EAEV;;EAEA;;EAEA;EACA,QAAQ;;;YAIE,iBAAiB;;EAE3B,gBAAgB,QAAQ;;EAExB,WAAW,aAAa,QAAQ;;;;;;EAMhC,eACE,YACA;IAAY;IAAoB;MAC/B,QAAQ;;;wBAoBG,oBAAoB,iBAAiB;;wBAmBrC,mBAAmB,iBAAiB;;wBAsDpC,yBAAyB,UAAS,yBAA8B;;;;;;;;wBAyB1D,gBACpB,UAAS,yBACR,QAAQ"}

package/esm/tooling/generate/generation.d.mts

@@ -1,28 +1,35 @@
 import { GeneratorSpec } from "./generator-spec.mjs";
 import { CliRunner } from "./run-cli.mjs";
-
 //#region ../../packages/core/src/tooling/generate/generation.d.ts
 /** The largest diff kept per file; a longer one is cut with a note. */
-declare const MAX_FILE_DIFF_BYTES: number;
+export declare const MAX_FILE_DIFF_BYTES: number;
 /** One file a generation creates, changes or removes. */
-type GeneratedFile = {
-  /** Project-relative POSIX path. */path: string;
-  status: "created" | "modified" | "deleted"; /** Unified diff against the project's current content (`""` for a binary file). */
-  diff: string; /** Set when the file is binary; `diff` is then empty. */
+export type GeneratedFile = {
+  /** Project-relative POSIX path. */
+  path: string;
+  status: "created" | "modified" | "deleted";
+  /** Unified diff against the project's current content (`""` for a binary file). */
+  diff: string;
+  /** Set when the file is binary; `diff` is then empty. */
   binary?: boolean;
 };
 /** What a generation would do (or did). */
-type GenerationPlan = {
-  spec: GeneratorSpec; /** The argv that ran, starting with `warlock`. */
-  command: string[]; /** Whether the command exited 0. A failed run usually lists no files. */
+export type GenerationPlan = {
+  spec: GeneratorSpec;
+  /** The argv that ran, starting with `warlock`. */
+  command: string[];
+  /** Whether the command exited 0. A failed run usually lists no files. */
   ok: boolean;
   exitCode: number | null;
-  files: GeneratedFile[]; /** The command's stdout and stderr, ANSI stripped and capped. */
+  files: GeneratedFile[];
+  /** The command's stdout and stderr, ANSI stripped and capped. */
   output: string;
 };
 /** Options every backend accepts. */
-type GenerationPlanOptions = {
-  /** Project root. Default: `process.cwd()`. */cwd?: string; /** Default {@link DEFAULT_GENERATION_TIMEOUT_MS}. */
+export type GenerationPlanOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** Default {@link DEFAULT_GENERATION_TIMEOUT_MS}. */
   timeoutMs?: number;
 };
 /**
@@ -31,13 +38,16 @@ type GenerationPlanOptions = {
  * The seam a native `warlock generate.* --dry-run --json` can implement later;
  * {@link sandboxBackend} implements it by generating into a throwaway copy.
  */
-type GenerationBackend = {
+export type GenerationBackend = {
   plan(spec: GeneratorSpec, options?: GenerationPlanOptions): Promise<GenerationPlan>;
 };
 /** Options of {@link sandboxBackend}. */
-type SandboxBackendOptions = {
-  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */cliEntry?: string; /** How the CLI runs. Default: {@link spawnCli}. */
-  runner?: CliRunner; /** Where sandboxes are created. Default: `os.tmpdir()`. */
+export type SandboxBackendOptions = {
+  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */
+  cliEntry?: string;
+  /** How the CLI runs. Default: {@link spawnCli}. */
+  runner?: CliRunner;
+  /** Where sandboxes are created. Default: `os.tmpdir()`. */
   tempDirectory?: string;
 };
 /**
@@ -57,11 +67,14 @@ type SandboxBackendOptions = {
  * );
  * plan.files.map((file) => `${file.status} ${file.path}`);
  */
-declare function sandboxBackend(options?: SandboxBackendOptions): GenerationBackend;
+export declare function sandboxBackend(options?: SandboxBackendOptions): GenerationBackend;
 /** Options of {@link applyGeneration}. */
-type ApplyGenerationOptions = GenerationPlanOptions & {
-  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */cliEntry?: string; /** How the CLI runs. Default: {@link spawnCli}. */
-  runner?: CliRunner; /** For `add`: install the packages it records. Default `true`. */
+export type ApplyGenerationOptions = GenerationPlanOptions & {
+  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */
+  cliEntry?: string;
+  /** How the CLI runs. Default: {@link spawnCli}. */
+  runner?: CliRunner;
+  /** For `add`: install the packages it records. Default `true`. */
   install?: boolean;
 };
 /**
@@ -72,7 +85,6 @@ type ApplyGenerationOptions = GenerationPlanOptions & {
  * compared. This WRITES the project: `warlock mcp` exposes it only with
  * `--allow-writes`.
  */
-declare function applyGeneration(spec: GeneratorSpec, options?: ApplyGenerationOptions): Promise<GenerationPlan>;
+export declare function applyGeneration(spec: GeneratorSpec, options?: ApplyGenerationOptions): Promise<GenerationPlan>;
 //#endregion
-export { ApplyGenerationOptions, GeneratedFile, GenerationBackend, GenerationPlan, GenerationPlanOptions, MAX_FILE_DIFF_BYTES, SandboxBackendOptions, applyGeneration, sandboxBackend };
 //# sourceMappingURL=generation.d.mts.map

package/esm/tooling/generate/generation.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generation.ts"],"mappings":";;;;;cAwBa,mBAAA;AAAb;AAAA,KAGY,aAAA;qCAEV,IAAA;EACA,MAAA,sCAHU;EAKV,IAAA;EAEA,MAAA;AAAA;;KAIU,cAAA;EACV,IAAA,EAAM,aAAA,EALA;EAON,OAAA,YAHU;EAKV,EAAA;EACA,QAAA;EACA,KAAA,EAAO,aAAa,IANpB;EAQA,MAAA;AAAA;;KAIU,qBAAA;EANV,8CAQA,GAAA,WANA;EAQA,SAAS;AAAA;AAJX;;;;AAIW;AASX;AAbA,KAaY,iBAAA;EACV,IAAA,CAAK,IAAA,EAAM,aAAA,EAAe,OAAA,GAAU,qBAAA,GAAwB,OAAA,CAAQ,cAAA;AAAA;;KAI1D,qBAAA;EAJkD,kEAM5D,QAAA,WANmE;EAQnE,MAAA,GAAS,SAAS,EARP;EAUX,aAAA;AAAA;;;;;AAVkF;AAIpF;;;;;;;;;AAMe;AA6Ef;;iBAAgB,cAAA,CAAe,OAAA,GAAS,qBAAA,GAA6B,iBAAiB;;KA2C1E,sBAAA,GAAyB,qBAAA;EA3CN,kEA6C7B,QAAA,WA7CoF;EA+CpF,MAAA,GAAS,SAAS,EAJR;EAMV,OAAA;AAAA;;;;;;;;AAAO;iBAWa,eAAA,CACpB,IAAA,EAAM,aAAA,EACN,OAAA,GAAS,sBAAA,GACR,OAAA,CAAQ,cAAA"}
+{"version":3,"file":"generation.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generation.ts"],"mappings":";;;;qBAwBa;;YAGD;;EAEV;EACA;;EAEA;;EAEA;;;YAIU;EACV,MAAM;;EAEN;;EAEA;EACA;EACA,OAAO;;EAEP;;;YAIU;;EAEV;;EAEA;;;;;;;;YASU;EACV,KAAK,MAAM,eAAe,UAAU,wBAAwB,QAAQ;;;YAI1D;;EAEV;;EAEA,SAAS;;EAET;;;;;;;;;;;;;;;;;;;wBA6Ec,eAAe,UAAS,wBAA6B;;YA2CzD,yBAAyB;;EAEnC;;EAEA,SAAS;;EAET;;;;;;;;;;wBAWoB,gBACpB,MAAM,eACN,UAAS,yBACR,QAAQ"}

package/esm/tooling/generate/generation.mjs

@@ -8,7 +8,7 @@ import os from "node:os";
 
 //#region ../../packages/core/src/tooling/generate/generation.ts
 /** The largest diff kept per file; a longer one is cut with a note. */
-const MAX_FILE_DIFF_BYTES = 200 * 1024;
+const MAX_FILE_DIFF_BYTES = 204800;
 function readOrNull(file) {
 	return existsSync(file) ? readFileSync(file) : null;
 }
@@ -74,12 +74,14 @@ function sandboxBackend(options = {}) {
 		try {
 			copyProjectScope(cwd, sandbox);
 			const before = snapshotFiles(sandbox, forEachSandboxFile);
-			return planFrom(spec, args, await runner({
+			const run = await runner({
 				entry: options.cliEntry ?? resolveCliEntry(),
 				args,
 				cwd: sandbox,
 				timeoutMs: planOptions.timeoutMs ?? 12e4
-			}), compareSnapshots(before, snapshotFiles(sandbox, forEachSandboxFile)).flatMap((change) => {
+			});
+			const after = snapshotFiles(sandbox, forEachSandboxFile);
+			return planFrom(spec, args, run, compareSnapshots(before, after).flatMap((change) => {
 				const file = describeChange(change, readOrNull(path.join(cwd, change.path)), change.status === "deleted" ? null : readOrNull(path.join(sandbox, change.path)));
 				return file ? [file] : [];
 			}));
@@ -107,12 +109,14 @@ async function applyGeneration(spec, options = {}) {
 		contents.set(relative, readFileSync(absolute));
 	});
 	const before = snapshotFiles(cwd, forEachScopedFile);
-	return planFrom(spec, args, await (options.runner ?? spawnCli)({
+	const run = await (options.runner ?? spawnCli)({
 		entry: options.cliEntry ?? resolveCliEntry(),
 		args,
 		cwd,
 		timeoutMs: options.timeoutMs ?? 12e4
-	}), compareSnapshots(before, snapshotFiles(cwd, forEachScopedFile)).flatMap((change) => {
+	});
+	const after = snapshotFiles(cwd, forEachScopedFile);
+	return planFrom(spec, args, run, compareSnapshots(before, after).flatMap((change) => {
 		const file = describeChange(change, contents.get(change.path) ?? null, change.status === "deleted" ? null : readOrNull(path.join(cwd, change.path)));
 		return file ? [file] : [];
 	}));

package/esm/tooling/generate/generation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generation.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generation.ts"],"sourcesContent":["import { existsSync, mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { buildGeneratorArgs, type GeneratorSpec } from \"./generator-spec\";\nimport {\n  compareSnapshots,\n  copyProjectScope,\n  forEachSandboxFile,\n  forEachScopedFile,\n  isBinary,\n  type SnapshotChange,\n  snapshotFiles,\n} from \"./project-files\";\nimport {\n  type CliRun,\n  type CliRunner,\n  DEFAULT_GENERATION_TIMEOUT_MS,\n  describeRun,\n  resolveCliEntry,\n  spawnCli,\n} from \"./run-cli\";\nimport { unifiedDiff } from \"./unified-diff\";\n\n/** The largest diff kept per file; a longer one is cut with a note. */\nexport const MAX_FILE_DIFF_BYTES = 200 * 1024;\n\n/** One file a generation creates, changes or removes. */\nexport type GeneratedFile = {\n  /** Project-relative POSIX path. */\n  path: string;\n  status: \"created\" | \"modified\" | \"deleted\";\n  /** Unified diff against the project's current content (`\"\"` for a binary file). */\n  diff: string;\n  /** Set when the file is binary; `diff` is then empty. */\n  binary?: boolean;\n};\n\n/** What a generation would do (or did). */\nexport type GenerationPlan = {\n  spec: GeneratorSpec;\n  /** The argv that ran, starting with `warlock`. */\n  command: string[];\n  /** Whether the command exited 0. A failed run usually lists no files. */\n  ok: boolean;\n  exitCode: number | null;\n  files: GeneratedFile[];\n  /** The command's stdout and stderr, ANSI stripped and capped. */\n  output: string;\n};\n\n/** Options every backend accepts. */\nexport type GenerationPlanOptions = {\n  /** Project root. Default: `process.cwd()`. */\n  cwd?: string;\n  /** Default {@link DEFAULT_GENERATION_TIMEOUT_MS}. */\n  timeoutMs?: number;\n};\n\n/**\n * Computes what a generation would change without touching the project.\n *\n * The seam a native `warlock generate.* --dry-run --json` can implement later;\n * {@link sandboxBackend} implements it by generating into a throwaway copy.\n */\nexport type GenerationBackend = {\n  plan(spec: GeneratorSpec, options?: GenerationPlanOptions): Promise<GenerationPlan>;\n};\n\n/** Options of {@link sandboxBackend}. */\nexport type SandboxBackendOptions = {\n  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */\n  cliEntry?: string;\n  /** How the CLI runs. Default: {@link spawnCli}. */\n  runner?: CliRunner;\n  /** Where sandboxes are created. Default: `os.tmpdir()`. */\n  tempDirectory?: string;\n};\n\nfunction readOrNull(file: string): Buffer | null {\n  return existsSync(file) ? readFileSync(file) : null;\n}\n\nfunction capDiff(diff: string): string {\n  return diff.length > MAX_FILE_DIFF_BYTES\n    ? `${diff.slice(0, MAX_FILE_DIFF_BYTES)}\\n… (diff truncated)\\n`\n    : diff;\n}\n\n/**\n * Build the {@link GeneratedFile} for one change from the two contents, or\n * `undefined` when they are byte-identical (a file rewritten unchanged).\n */\nfunction describeChange(\n  change: SnapshotChange,\n  before: Buffer | null,\n  after: Buffer | null,\n): GeneratedFile | undefined {\n  if (before !== null && after !== null && before.equals(after)) return undefined;\n\n  const status: GeneratedFile[\"status\"] =\n    before === null ? \"created\" : after === null ? \"deleted\" : \"modified\";\n\n  if ((before && isBinary(before)) || (after && isBinary(after))) {\n    return { path: change.path, status, diff: \"\", binary: true };\n  }\n\n  return {\n    path: change.path,\n    status,\n    diff: capDiff(\n      unifiedDiff({\n        path: change.path,\n        before: before === null ? null : before.toString(\"utf8\"),\n        after: after === null ? null : after.toString(\"utf8\"),\n      }),\n    ),\n  };\n}\n\nfunction planFrom(\n  spec: GeneratorSpec,\n  args: string[],\n  run: CliRun,\n  files: GeneratedFile[],\n): GenerationPlan {\n  return {\n    spec,\n    command: [\"warlock\", ...args],\n    ok: run.exitCode === 0 && !run.timedOut,\n    exitCode: run.exitCode,\n    files,\n    output: describeRun(run),\n  };\n}\n\n/**\n * The sandbox {@link GenerationBackend}: copies the project's root files and\n * `src/` tree (never `.env` files) into a temporary directory, links the\n * project's `node_modules` into it, runs the real `warlock` command there,\n * and reports every file that changed as a unified diff against the project.\n * The project is never written; the sandbox is always removed.\n *\n * `add` runs with `--no-install`: package.json shows the dependencies it\n * would record, and nothing is downloaded.\n *\n * @example\n * const plan = await sandboxBackend().plan(\n *   { type: \"make\", generator: \"service\", name: \"users/send-welcome\" },\n *   { cwd: projectRoot },\n * );\n * plan.files.map((file) => `${file.status} ${file.path}`);\n */\nexport function sandboxBackend(options: SandboxBackendOptions = {}): GenerationBackend {\n  const runner = options.runner ?? spawnCli;\n\n  return {\n    async plan(spec, planOptions = {}) {\n      const cwd = path.resolve(planOptions.cwd ?? process.cwd());\n      const args = buildGeneratorArgs(spec, { install: false });\n      const sandbox = mkdtempSync(\n        path.join(options.tempDirectory ?? os.tmpdir(), \"warlock-generate-\"),\n      );\n\n      try {\n        copyProjectScope(cwd, sandbox);\n\n        const before = snapshotFiles(sandbox, forEachSandboxFile);\n        const run = await runner({\n          entry: options.cliEntry ?? resolveCliEntry(),\n          args,\n          cwd: sandbox,\n          timeoutMs: planOptions.timeoutMs ?? DEFAULT_GENERATION_TIMEOUT_MS,\n        });\n        const after = snapshotFiles(sandbox, forEachSandboxFile);\n        const files = compareSnapshots(before, after).flatMap((change) => {\n          // Compared with the PROJECT, not the sandbox copy: a file outside the\n          // copied scope that the project already has is a change, not a creation.\n          const file = describeChange(\n            change,\n            readOrNull(path.join(cwd, change.path)),\n            change.status === \"deleted\" ? null : readOrNull(path.join(sandbox, change.path)),\n          );\n\n          return file ? [file] : [];\n        });\n\n        return planFrom(spec, args, run, files);\n      } finally {\n        rmSync(sandbox, { recursive: true, force: true });\n      }\n    },\n  };\n}\n\n/** Options of {@link applyGeneration}. */\nexport type ApplyGenerationOptions = GenerationPlanOptions & {\n  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */\n  cliEntry?: string;\n  /** How the CLI runs. Default: {@link spawnCli}. */\n  runner?: CliRunner;\n  /** For `add`: install the packages it records. Default `true`. */\n  install?: boolean;\n};\n\n/**\n * Run a generation in the real project and report what it changed, as a\n * {@link GenerationPlan} whose diffs compare the files before and after.\n *\n * Only the generation scope (root files and `src/`, never `.env` files) is\n * compared. This WRITES the project: `warlock mcp` exposes it only with\n * `--allow-writes`.\n */\nexport async function applyGeneration(\n  spec: GeneratorSpec,\n  options: ApplyGenerationOptions = {},\n): Promise<GenerationPlan> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const args = buildGeneratorArgs(spec, { install: options.install ?? true });\n  const contents = new Map<string, Buffer>();\n\n  forEachScopedFile(cwd, (absolute, relative) => {\n    contents.set(relative, readFileSync(absolute));\n  });\n\n  const before = snapshotFiles(cwd, forEachScopedFile);\n  const run = await (options.runner ?? spawnCli)({\n    entry: options.cliEntry ?? resolveCliEntry(),\n    args,\n    cwd,\n    timeoutMs: options.timeoutMs ?? DEFAULT_GENERATION_TIMEOUT_MS,\n  });\n  const after = snapshotFiles(cwd, forEachScopedFile);\n  const files = compareSnapshots(before, after).flatMap((change) => {\n    const file = describeChange(\n      change,\n      contents.get(change.path) ?? null,\n      change.status === \"deleted\" ? null : readOrNull(path.join(cwd, change.path)),\n    );\n\n    return file ? [file] : [];\n  });\n\n  return planFrom(spec, args, run, files);\n}\n"],"mappings":"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"}
+{"version":3,"file":"generation.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generation.ts"],"sourcesContent":["import { existsSync, mkdtempSync, readFileSync, rmSync } from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { buildGeneratorArgs, type GeneratorSpec } from \"./generator-spec\";\nimport {\n  compareSnapshots,\n  copyProjectScope,\n  forEachSandboxFile,\n  forEachScopedFile,\n  isBinary,\n  type SnapshotChange,\n  snapshotFiles,\n} from \"./project-files\";\nimport {\n  type CliRun,\n  type CliRunner,\n  DEFAULT_GENERATION_TIMEOUT_MS,\n  describeRun,\n  resolveCliEntry,\n  spawnCli,\n} from \"./run-cli\";\nimport { unifiedDiff } from \"./unified-diff\";\n\n/** The largest diff kept per file; a longer one is cut with a note. */\nexport const MAX_FILE_DIFF_BYTES = 200 * 1024;\n\n/** One file a generation creates, changes or removes. */\nexport type GeneratedFile = {\n  /** Project-relative POSIX path. */\n  path: string;\n  status: \"created\" | \"modified\" | \"deleted\";\n  /** Unified diff against the project's current content (`\"\"` for a binary file). */\n  diff: string;\n  /** Set when the file is binary; `diff` is then empty. */\n  binary?: boolean;\n};\n\n/** What a generation would do (or did). */\nexport type GenerationPlan = {\n  spec: GeneratorSpec;\n  /** The argv that ran, starting with `warlock`. */\n  command: string[];\n  /** Whether the command exited 0. A failed run usually lists no files. */\n  ok: boolean;\n  exitCode: number | null;\n  files: GeneratedFile[];\n  /** The command's stdout and stderr, ANSI stripped and capped. */\n  output: string;\n};\n\n/** Options every backend accepts. */\nexport type GenerationPlanOptions = {\n  /** Project root. Default: `process.cwd()`. */\n  cwd?: string;\n  /** Default {@link DEFAULT_GENERATION_TIMEOUT_MS}. */\n  timeoutMs?: number;\n};\n\n/**\n * Computes what a generation would change without touching the project.\n *\n * The seam a native `warlock generate.* --dry-run --json` can implement later;\n * {@link sandboxBackend} implements it by generating into a throwaway copy.\n */\nexport type GenerationBackend = {\n  plan(spec: GeneratorSpec, options?: GenerationPlanOptions): Promise<GenerationPlan>;\n};\n\n/** Options of {@link sandboxBackend}. */\nexport type SandboxBackendOptions = {\n  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */\n  cliEntry?: string;\n  /** How the CLI runs. Default: {@link spawnCli}. */\n  runner?: CliRunner;\n  /** Where sandboxes are created. Default: `os.tmpdir()`. */\n  tempDirectory?: string;\n};\n\nfunction readOrNull(file: string): Buffer | null {\n  return existsSync(file) ? readFileSync(file) : null;\n}\n\nfunction capDiff(diff: string): string {\n  return diff.length > MAX_FILE_DIFF_BYTES\n    ? `${diff.slice(0, MAX_FILE_DIFF_BYTES)}\\n… (diff truncated)\\n`\n    : diff;\n}\n\n/**\n * Build the {@link GeneratedFile} for one change from the two contents, or\n * `undefined` when they are byte-identical (a file rewritten unchanged).\n */\nfunction describeChange(\n  change: SnapshotChange,\n  before: Buffer | null,\n  after: Buffer | null,\n): GeneratedFile | undefined {\n  if (before !== null && after !== null && before.equals(after)) return undefined;\n\n  const status: GeneratedFile[\"status\"] =\n    before === null ? \"created\" : after === null ? \"deleted\" : \"modified\";\n\n  if ((before && isBinary(before)) || (after && isBinary(after))) {\n    return { path: change.path, status, diff: \"\", binary: true };\n  }\n\n  return {\n    path: change.path,\n    status,\n    diff: capDiff(\n      unifiedDiff({\n        path: change.path,\n        before: before === null ? null : before.toString(\"utf8\"),\n        after: after === null ? null : after.toString(\"utf8\"),\n      }),\n    ),\n  };\n}\n\nfunction planFrom(\n  spec: GeneratorSpec,\n  args: string[],\n  run: CliRun,\n  files: GeneratedFile[],\n): GenerationPlan {\n  return {\n    spec,\n    command: [\"warlock\", ...args],\n    ok: run.exitCode === 0 && !run.timedOut,\n    exitCode: run.exitCode,\n    files,\n    output: describeRun(run),\n  };\n}\n\n/**\n * The sandbox {@link GenerationBackend}: copies the project's root files and\n * `src/` tree (never `.env` files) into a temporary directory, links the\n * project's `node_modules` into it, runs the real `warlock` command there,\n * and reports every file that changed as a unified diff against the project.\n * The project is never written; the sandbox is always removed.\n *\n * `add` runs with `--no-install`: package.json shows the dependencies it\n * would record, and nothing is downloaded.\n *\n * @example\n * const plan = await sandboxBackend().plan(\n *   { type: \"make\", generator: \"service\", name: \"users/send-welcome\" },\n *   { cwd: projectRoot },\n * );\n * plan.files.map((file) => `${file.status} ${file.path}`);\n */\nexport function sandboxBackend(options: SandboxBackendOptions = {}): GenerationBackend {\n  const runner = options.runner ?? spawnCli;\n\n  return {\n    async plan(spec, planOptions = {}) {\n      const cwd = path.resolve(planOptions.cwd ?? process.cwd());\n      const args = buildGeneratorArgs(spec, { install: false });\n      const sandbox = mkdtempSync(\n        path.join(options.tempDirectory ?? os.tmpdir(), \"warlock-generate-\"),\n      );\n\n      try {\n        copyProjectScope(cwd, sandbox);\n\n        const before = snapshotFiles(sandbox, forEachSandboxFile);\n        const run = await runner({\n          entry: options.cliEntry ?? resolveCliEntry(),\n          args,\n          cwd: sandbox,\n          timeoutMs: planOptions.timeoutMs ?? DEFAULT_GENERATION_TIMEOUT_MS,\n        });\n        const after = snapshotFiles(sandbox, forEachSandboxFile);\n        const files = compareSnapshots(before, after).flatMap((change) => {\n          // Compared with the PROJECT, not the sandbox copy: a file outside the\n          // copied scope that the project already has is a change, not a creation.\n          const file = describeChange(\n            change,\n            readOrNull(path.join(cwd, change.path)),\n            change.status === \"deleted\" ? null : readOrNull(path.join(sandbox, change.path)),\n          );\n\n          return file ? [file] : [];\n        });\n\n        return planFrom(spec, args, run, files);\n      } finally {\n        rmSync(sandbox, { recursive: true, force: true });\n      }\n    },\n  };\n}\n\n/** Options of {@link applyGeneration}. */\nexport type ApplyGenerationOptions = GenerationPlanOptions & {\n  /** The `warlock` bin to run. Default: {@link resolveCliEntry}. */\n  cliEntry?: string;\n  /** How the CLI runs. Default: {@link spawnCli}. */\n  runner?: CliRunner;\n  /** For `add`: install the packages it records. Default `true`. */\n  install?: boolean;\n};\n\n/**\n * Run a generation in the real project and report what it changed, as a\n * {@link GenerationPlan} whose diffs compare the files before and after.\n *\n * Only the generation scope (root files and `src/`, never `.env` files) is\n * compared. This WRITES the project: `warlock mcp` exposes it only with\n * `--allow-writes`.\n */\nexport async function applyGeneration(\n  spec: GeneratorSpec,\n  options: ApplyGenerationOptions = {},\n): Promise<GenerationPlan> {\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const args = buildGeneratorArgs(spec, { install: options.install ?? true });\n  const contents = new Map<string, Buffer>();\n\n  forEachScopedFile(cwd, (absolute, relative) => {\n    contents.set(relative, readFileSync(absolute));\n  });\n\n  const before = snapshotFiles(cwd, forEachScopedFile);\n  const run = await (options.runner ?? spawnCli)({\n    entry: options.cliEntry ?? resolveCliEntry(),\n    args,\n    cwd,\n    timeoutMs: options.timeoutMs ?? DEFAULT_GENERATION_TIMEOUT_MS,\n  });\n  const after = snapshotFiles(cwd, forEachScopedFile);\n  const files = compareSnapshots(before, after).flatMap((change) => {\n    const file = describeChange(\n      change,\n      contents.get(change.path) ?? null,\n      change.status === \"deleted\" ? null : readOrNull(path.join(cwd, change.path)),\n    );\n\n    return file ? [file] : [];\n  });\n\n  return planFrom(spec, args, run, files);\n}\n"],"mappings":"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"}

package/esm/tooling/generate/generator-spec.d.mts

@@ -7,14 +7,14 @@
  * are accepted, and no value can be read as another flag.
  */
 /** The `warlock generate.<name>` scaffolders. */
-declare const MAKE_GENERATORS: readonly ["module", "controller", "service", "use-case", "model", "repository", "resource", "migration"];
+export declare const MAKE_GENERATORS: readonly ["module", "controller", "service", "use-case", "model", "repository", "resource", "migration"];
 /** One `warlock generate.<name>` scaffolder. */
-type MakeGenerator = (typeof MAKE_GENERATORS)[number];
+export type MakeGenerator = (typeof MAKE_GENERATORS)[number];
 /**
  * The flags each generator declares (see `cli/commands/generate/generate.command.ts`),
  * minus `--dry-run`: the sandbox generates for real into a throwaway copy.
  */
-declare const MAKE_GENERATOR_FLAGS: Readonly<Record<MakeGenerator, readonly string[]>>;
+export declare const MAKE_GENERATOR_FLAGS: Readonly<Record<MakeGenerator, readonly string[]>>;
 /**
  * A generation request.
  *
@@ -22,17 +22,18 @@ declare const MAKE_GENERATOR_FLAGS: Readonly<Record<MakeGenerator, readonly stri
  *   command takes (`users`, `users/create-user`, a model path for `migration`).
  * - `add`: `warlock add <features…>`.
  */
-type GeneratorSpec = {
+export type GeneratorSpec = {
   type: "make";
   generator: MakeGenerator;
-  name: string; /** `true` → `--flag`, `false` → `--flag=false`, a string → `--flag=value`. */
+  name: string;
+  /** `true` → `--flag`, `false` → `--flag=false`, a string → `--flag=value`. */
   flags?: Record<string, string | boolean>;
 } | {
   type: "add";
   features: string[];
 };
 /** Options of {@link buildGeneratorArgs}. */
-type GeneratorArgsOptions = {
+export type GeneratorArgsOptions = {
   /**
    * For `add`: install the packages (`false` adds `--no-install`, which still
    * records them in package.json). Default `false`.
@@ -40,7 +41,7 @@ type GeneratorArgsOptions = {
   install?: boolean;
 };
 /** Whether a string names a `warlock generate.*` scaffolder. */
-declare function isMakeGenerator(value: string): value is MakeGenerator;
+export declare function isMakeGenerator(value: string): value is MakeGenerator;
 /**
  * The `warlock` arguments (without the `warlock` itself) that run a spec.
  * Throws on an unknown generator, flag or feature, or an unsafe name or value.
@@ -51,7 +52,6 @@ declare function isMakeGenerator(value: string): value is MakeGenerator;
  * buildGeneratorArgs({ type: "add", features: ["devtools"] });
  * // ["add", "devtools", "--no-install"]
  */
-declare function buildGeneratorArgs(spec: GeneratorSpec, options?: GeneratorArgsOptions): string[];
+export declare function buildGeneratorArgs(spec: GeneratorSpec, options?: GeneratorArgsOptions): string[];
 //#endregion
-export { GeneratorArgsOptions, GeneratorSpec, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MakeGenerator, buildGeneratorArgs, isMakeGenerator };
 //# sourceMappingURL=generator-spec.d.mts.map

package/esm/tooling/generate/generator-spec.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generator-spec.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generator-spec.ts"],"mappings":";;AASA;;;;AASU;AAGV;;cAZa,eAAA;;KAYD,aAAA,WAAwB,eAAe;AAMnD;;;;AAAA,cAAa,oBAAA,EAAsB,QAAA,CAAS,MAAA,CAAO,aAAA;;;;;;;;KAkBvC,aAAA;EAEN,IAAA;EACA,SAAA,EAAW,aAAA;EACX,IAAA,UAEc;EAAd,KAAA,GAAQ,MAAM;AAAA;EAGd,IAAA;EACA,QAAA;AAAA;;KAIM,oBAAA;EAJN;;AAAQ;AAId;EAKE,OAAO;AAAA;;iBAQO,eAAA,CAAgB,KAAA,WAAgB,KAAA,IAAS,aAAa;AAAtE;;;;;;;;AAAsE;AA+CtE;AA/CA,iBA+CgB,kBAAA,CACd,IAAA,EAAM,aAAA,EACN,OAAA,GAAS,oBAAyB"}
+{"version":3,"file":"generator-spec.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/generate/generator-spec.ts"],"mappings":";;;;;;;;;qBASa;;YAYD,wBAAwB;;;;;qBAMvB,sBAAsB,SAAS,OAAO;;;;;;;;YAkBvC;EAEN;EACA,WAAW;EACX;;EAEA,QAAQ;;EAGR;EACA;;;YAIM;;;;;EAKV;;;wBAQc,gBAAgB,gBAAgB,SAAS;;;;;;;;;;;wBA+CzC,mBACd,MAAM,eACN,UAAS"}

package/esm/tooling/generate/index.mjs

@@ -3,4 +3,4 @@ import { DEFAULT_GENERATION_TIMEOUT_MS, describeRun, resolveCliEntry, spawnCli }
 import { DIFF_CONTEXT_LINES, unifiedDiff } from "./unified-diff.mjs";
 import { MAX_FILE_DIFF_BYTES, applyGeneration, sandboxBackend } from "./generation.mjs";
 
-export {  };
+export { DEFAULT_GENERATION_TIMEOUT_MS, DIFF_CONTEXT_LINES, MAKE_GENERATORS, MAKE_GENERATOR_FLAGS, MAX_FILE_DIFF_BYTES, applyGeneration, buildGeneratorArgs, describeRun, isMakeGenerator, resolveCliEntry, sandboxBackend, spawnCli, unifiedDiff };

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

@@ -13,9 +13,9 @@ import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, symlink
 * or diffed: they hold secrets, and a diff is text an agent will read.
 */
 /** Directory names never entered anywhere. */
-const SKIPPED_DIRECTORIES = new Set([".git", "node_modules"]);
+const SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
 /** Root directories outside the scope that a sandbox still never copies (listed for the walk of a sandbox). */
-const SKIPPED_ROOT_DIRECTORIES = new Set([
+const SKIPPED_ROOT_DIRECTORIES = /* @__PURE__ */ new Set([
 	".git",
 	"node_modules",
 	".warlock",
@@ -117,5 +117,5 @@ function isBinary(content) {
 }
 
 //#endregion
-export { compareSnapshots, copyProjectScope, forEachSandboxFile, forEachScopedFile, isBinary, snapshotFiles };
+export { compareSnapshots, copyProjectScope, forEachSandboxFile, forEachScopedFile, isBinary, isEnvFile, snapshotFiles };
 //# sourceMappingURL=project-files.mjs.map