@warlock.js/core 5.26.0 → 5.27.0

package/esm/dev-server/model-resource-typings.mjs

@@ -0,0 +1,246 @@
+import { dirname, isAbsolute, relative } from "node:path";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import ts from "typescript";
+
+//#region ../core/src/dev-server/model-resource-typings.ts
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function hasModifier(node, kind) {
+	return ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false);
+}
+function unwrapParentheses(expression) {
+	let current = expression;
+	while (ts.isParenthesizedExpression(current)) current = current.expression;
+	return current;
+}
+/** Top-level names this file declares, and the names each is exported under. */
+function readLocalDeclarations(sourceFile) {
+	const declared = /* @__PURE__ */ new Set();
+	const exportNames = /* @__PURE__ */ new Map();
+	const addExport = (local, exported) => {
+		const names = exportNames.get(local) ?? [];
+		names.push(exported);
+		exportNames.set(local, names);
+	};
+	for (const statement of sourceFile.statements) {
+		const exported = hasModifier(statement, ts.SyntaxKind.ExportKeyword);
+		const isDefault = hasModifier(statement, ts.SyntaxKind.DefaultKeyword);
+		if ((ts.isClassDeclaration(statement) || ts.isFunctionDeclaration(statement) || ts.isEnumDeclaration(statement)) && statement.name) {
+			declared.add(statement.name.text);
+			if (exported) addExport(statement.name.text, isDefault ? "default" : statement.name.text);
+			continue;
+		}
+		if (ts.isVariableStatement(statement)) {
+			for (const declaration of statement.declarationList.declarations) {
+				if (!ts.isIdentifier(declaration.name)) continue;
+				declared.add(declaration.name.text);
+				if (exported) addExport(declaration.name.text, declaration.name.text);
+			}
+			continue;
+		}
+		if (ts.isExportDeclaration(statement) && !statement.moduleSpecifier && !statement.isTypeOnly && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
+			for (const element of statement.exportClause.elements) {
+				if (element.isTypeOnly) continue;
+				addExport((element.propertyName ?? element.name).text, element.name.text);
+			}
+			continue;
+		}
+		if (ts.isExportAssignment(statement) && !statement.isExportEquals && ts.isIdentifier(statement.expression)) addExport(statement.expression.text, "default");
+	}
+	return {
+		declared,
+		exportNames
+	};
+}
+/** Prefer a named export over `default`; among named exports, the first sorted. */
+function pickExportName(names) {
+	if (!names || names.length === 0) return void 0;
+	return names.filter((name) => name !== "default").sort()[0] ?? "default";
+}
+function readImportBindings(sourceFile) {
+	const bindings = /* @__PURE__ */ new Map();
+	for (const statement of sourceFile.statements) {
+		if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) continue;
+		const clause = statement.importClause;
+		const specifier = statement.moduleSpecifier.text;
+		if (!clause) continue;
+		if (clause.name) bindings.set(clause.name.text, {
+			specifier,
+			exportName: "default"
+		});
+		if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) for (const element of clause.namedBindings.elements) bindings.set(element.name.text, {
+			specifier,
+			exportName: (element.propertyName ?? element.name).text
+		});
+	}
+	return bindings;
+}
+/** The identifier a class assigns to `static resource`, when it is a bare identifier. */
+function readStaticResourceReference(member) {
+	if (!ts.isPropertyDeclaration(member)) return void 0;
+	if (!hasModifier(member, ts.SyntaxKind.StaticKeyword)) return void 0;
+	if (hasModifier(member, ts.SyntaxKind.DeclareKeyword)) return void 0;
+	if (!((ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) && member.name.text === "resource")) return void 0;
+	if (!member.initializer) return void 0;
+	const initializer = unwrapParentheses(member.initializer);
+	return ts.isIdentifier(initializer) ? { name: initializer.text } : "computed";
+}
+/**
+* Read every model class of one file that declares `static resource = <Identifier>`
+* and resolve it to a model export plus a resource export. Pure: the only
+* outside knowledge is the injected {@link ExtractModelResourcesInput.resolveImport}.
+*/
+function extractModelResourceEntries(input) {
+	const result = {
+		entries: [],
+		skipped: []
+	};
+	if (!input.source.includes("resource")) return result;
+	const sourceFile = ts.createSourceFile(input.absolutePath, input.source, ts.ScriptTarget.ESNext, false, input.absolutePath.endsWith("x") ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+	const { declared, exportNames } = readLocalDeclarations(sourceFile);
+	const imports = readImportBindings(sourceFile);
+	for (const statement of sourceFile.statements) {
+		if (!ts.isClassDeclaration(statement) || !statement.name) continue;
+		const className = statement.name.text;
+		let reference;
+		for (const member of statement.members) reference = readStaticResourceReference(member) ?? reference;
+		if (reference === void 0) continue;
+		const skip = (reason) => {
+			result.skipped.push({
+				className,
+				modelFile: input.absolutePath,
+				reason
+			});
+		};
+		if (reference === "computed") {
+			skip("`static resource` is not a plain identifier");
+			continue;
+		}
+		if (statement.typeParameters?.some((parameter) => parameter.default === void 0)) {
+			skip("the model class is generic");
+			continue;
+		}
+		const modelExport = pickExportName(exportNames.get(className));
+		if (modelExport === void 0) {
+			skip("the model class is not exported");
+			continue;
+		}
+		if (modelExport !== "default" && !IDENTIFIER.test(modelExport)) {
+			skip("the model export name is not an identifier");
+			continue;
+		}
+		const binding = imports.get(reference.name);
+		let resourceFile;
+		let resourceExport;
+		if (binding) {
+			resourceFile = input.resolveImport(binding.specifier);
+			resourceExport = binding.exportName;
+		} else if (declared.has(reference.name)) {
+			resourceFile = input.absolutePath;
+			resourceExport = pickExportName(exportNames.get(reference.name));
+		}
+		if (resourceFile === void 0 || resourceExport === void 0) {
+			skip(`\`${reference.name}\` cannot be resolved to an exported module member`);
+			continue;
+		}
+		if (resourceExport !== "default" && !IDENTIFIER.test(resourceExport)) {
+			skip("the resource export name is not an identifier");
+			continue;
+		}
+		result.entries.push({
+			className,
+			modelFile: input.absolutePath,
+			modelExport,
+			resourceFile,
+			resourceExport
+		});
+	}
+	return result;
+}
+/** Module specifier, relative to the typings directory, without a TypeScript extension. */
+function toTypeImportSpecifier(typingsDirectory, absoluteFile) {
+	const path = relative(typingsDirectory, absoluteFile).replaceAll("\\", "/");
+	if (isAbsolute(path)) return void 0;
+	const withoutExtension = path.replace(/\.(?:d\.)?(?:ts|tsx|mts|cts)$/, "");
+	return withoutExtension.startsWith(".") ? withoutExtension : `./${withoutExtension}`;
+}
+/**
+* Registry keys: the class name, suffixed `_2`, `_3`, ... when several model
+* files declare the same class name. Order is by class name, then by file path,
+* so the same set of models always yields the same keys and the same text.
+*/
+function assignRegistryKeys(entries) {
+	const sorted = [...entries].sort((a, b) => a.className.localeCompare(b.className, "en") || a.modelFile.localeCompare(b.modelFile, "en") || a.modelExport.localeCompare(b.modelExport, "en"));
+	const taken = /* @__PURE__ */ new Set();
+	const counts = /* @__PURE__ */ new Map();
+	return sorted.map((entry) => {
+		let count = (counts.get(entry.className) ?? 0) + 1;
+		let key = count === 1 ? entry.className : `${entry.className}_${count}`;
+		while (taken.has(key)) {
+			count += 1;
+			key = `${entry.className}_${count}`;
+		}
+		counts.set(entry.className, count);
+		taken.add(key);
+		return {
+			key,
+			entry
+		};
+	});
+}
+/**
+* Text of the generated declaration file.
+*
+* @param entries Every resolved model, in any order.
+* @param typingsDirectory Absolute directory the file is written to; import
+* specifiers are relative to it.
+*/
+function renderModelResourceRegistry(entries, typingsDirectory) {
+	const lines = [];
+	for (const { key, entry } of assignRegistryKeys(entries)) {
+		const modelPath = toTypeImportSpecifier(typingsDirectory, entry.modelFile);
+		const resourcePath = toTypeImportSpecifier(typingsDirectory, entry.resourceFile);
+		if (modelPath === void 0 || resourcePath === void 0) continue;
+		const model = `import(${JSON.stringify(modelPath)}).${entry.modelExport}`;
+		const resource = `typeof import(${JSON.stringify(resourcePath)}).${entry.resourceExport}`;
+		lines.push(`    ${JSON.stringify(key)}: { model: ${model}; resource: ${resource} };`);
+	}
+	return `// Auto-generated by Warlock.js - DO NOT EDIT
+// One entry per model class that declares \`static resource = <Resource>\`, so
+// \`Serialized<Model>\` resolves to the resource output. Models whose resource
+// cannot be resolved statically are left out.
+
+import "@warlock.js/core";
+
+declare module "@warlock.js/core" {
+  interface ModelResourceRegistry {
+${lines.join("\n")}
+  }
+}
+`;
+}
+/**
+* Write `content` to `filePath` through a temporary sibling and a rename, so a
+* reader (the editor's TypeScript server) never sees a half-written file, and
+* skip the write entirely when the file already holds exactly this text.
+*
+* @returns `true` when the file was written.
+*/
+async function writeFileIfChanged(filePath, content) {
+	try {
+		if (await readFile(filePath, "utf-8") === content) return false;
+	} catch {}
+	await mkdir(dirname(filePath), { recursive: true });
+	const temporaryPath = `${filePath}.${process.pid}.tmp`;
+	try {
+		await writeFile(temporaryPath, content, "utf-8");
+		await rename(temporaryPath, filePath);
+	} catch (error) {
+		await rm(temporaryPath, { force: true });
+		throw error;
+	}
+	return true;
+}
+
+//#endregion
+export { extractModelResourceEntries, renderModelResourceRegistry, writeFileIfChanged };
+//# sourceMappingURL=model-resource-typings.mjs.map

package/esm/dev-server/model-resource-typings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-resource-typings.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/model-resource-typings.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, relative } from \"node:path\";\nimport ts from \"typescript\";\n\n/**\n * Static `ModelResourceRegistry` generation.\n *\n * `Serialized<User>` can only resolve a model to its resource output through an\n * entry in the augmentable `ModelResourceRegistry` (see `http/serialized.ts`).\n * This module derives those entries from source: a model class that declares\n * `static resource = UserResource` produces\n *\n * ```ts\n * \"User\": { model: import(\"<model file>\").User; resource: typeof import(\"<resource file>\").UserResource };\n * ```\n *\n * Everything here is syntactic. It reads one `ts.createSourceFile` AST per model\n * file, follows the identifier through that file's own imports, and never\n * imports or executes application code (`read-config-ast.ts` explains why a\n * type checker is not an option). Anything it cannot prove from the AST alone\n * (a computed expression, `lazy(...)`, a namespace import, a class that is not\n * exported) is skipped, and nothing is recorded for it: a guessed entry would\n * make `Serialized` lie, which is worse than the raw-data type it falls back to.\n */\n\n/** One model class whose resource could be resolved statically. */\nexport type ModelResourceEntry = {\n  /** The model class name (the registry key before de-duplication). */\n  className: string;\n  /** Absolute path of the model file. */\n  modelFile: string;\n  /** How the model file exports the class: its export name, or `\"default\"`. */\n  modelExport: string;\n  /** Absolute path of the module that exports the resource. */\n  resourceFile: string;\n  /** How that module exports the resource: its export name, or `\"default\"`. */\n  resourceExport: string;\n};\n\n/** A model that declares `static resource` but could not be resolved. */\nexport type SkippedModelResource = {\n  className: string;\n  modelFile: string;\n  reason: string;\n};\n\nexport type ModelResourceExtraction = {\n  entries: ModelResourceEntry[];\n  skipped: SkippedModelResource[];\n};\n\nexport type ExtractModelResourcesInput = {\n  /** Source text of the model file. */\n  source: string;\n  /** Absolute path of the model file. */\n  absolutePath: string;\n  /**\n   * Resolve an import specifier of the model file (relative or tsconfig alias) to\n   * an absolute file path, or `undefined` when it does not point at app source.\n   */\n  resolveImport: (specifier: string) => string | undefined;\n};\n\ntype ImportBinding = { specifier: string; exportName: string };\n\nconst IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\nfunction hasModifier(node: ts.Node, kind: ts.SyntaxKind): boolean {\n  return ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some((m) => m.kind === kind) ?? false);\n}\n\nfunction unwrapParentheses(expression: ts.Expression): ts.Expression {\n  let current = expression;\n\n  while (ts.isParenthesizedExpression(current)) {\n    current = current.expression;\n  }\n\n  return current;\n}\n\n/** Top-level names this file declares, and the names each is exported under. */\nfunction readLocalDeclarations(sourceFile: ts.SourceFile): {\n  declared: Set<string>;\n  exportNames: Map<string, string[]>;\n} {\n  const declared = new Set<string>();\n  const exportNames = new Map<string, string[]>();\n\n  const addExport = (local: string, exported: string): void => {\n    const names = exportNames.get(local) ?? [];\n\n    names.push(exported);\n    exportNames.set(local, names);\n  };\n\n  for (const statement of sourceFile.statements) {\n    const exported = hasModifier(statement, ts.SyntaxKind.ExportKeyword);\n    const isDefault = hasModifier(statement, ts.SyntaxKind.DefaultKeyword);\n\n    if (\n      (ts.isClassDeclaration(statement) ||\n        ts.isFunctionDeclaration(statement) ||\n        ts.isEnumDeclaration(statement)) &&\n      statement.name\n    ) {\n      declared.add(statement.name.text);\n\n      if (exported) {\n        addExport(statement.name.text, isDefault ? \"default\" : statement.name.text);\n      }\n\n      continue;\n    }\n\n    if (ts.isVariableStatement(statement)) {\n      for (const declaration of statement.declarationList.declarations) {\n        if (!ts.isIdentifier(declaration.name)) continue;\n\n        declared.add(declaration.name.text);\n\n        if (exported) {\n          addExport(declaration.name.text, declaration.name.text);\n        }\n      }\n\n      continue;\n    }\n\n    // `export { A, B as C }` (local form only; a `from` clause re-exports a foreign name).\n    if (\n      ts.isExportDeclaration(statement) &&\n      !statement.moduleSpecifier &&\n      !statement.isTypeOnly &&\n      statement.exportClause &&\n      ts.isNamedExports(statement.exportClause)\n    ) {\n      for (const element of statement.exportClause.elements) {\n        if (element.isTypeOnly) continue;\n\n        addExport((element.propertyName ?? element.name).text, element.name.text);\n      }\n\n      continue;\n    }\n\n    // `export default UserResource;`\n    if (\n      ts.isExportAssignment(statement) &&\n      !statement.isExportEquals &&\n      ts.isIdentifier(statement.expression)\n    ) {\n      addExport(statement.expression.text, \"default\");\n    }\n  }\n\n  return { declared, exportNames };\n}\n\n/** Prefer a named export over `default`; among named exports, the first sorted. */\nfunction pickExportName(names: readonly string[] | undefined): string | undefined {\n  if (!names || names.length === 0) return undefined;\n\n  const named = names.filter((name) => name !== \"default\").sort();\n\n  return named[0] ?? \"default\";\n}\n\nfunction readImportBindings(sourceFile: ts.SourceFile): Map<string, ImportBinding> {\n  const bindings = new Map<string, ImportBinding>();\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)) {\n      continue;\n    }\n\n    const clause = statement.importClause;\n    const specifier = statement.moduleSpecifier.text;\n\n    if (!clause) continue;\n\n    if (clause.name) {\n      bindings.set(clause.name.text, { specifier, exportName: \"default\" });\n    }\n\n    // A namespace import (`import * as ns`) cannot be the bare identifier a\n    // `static resource = X` reads, so it never becomes a binding.\n    if (clause.namedBindings && ts.isNamedImports(clause.namedBindings)) {\n      for (const element of clause.namedBindings.elements) {\n        bindings.set(element.name.text, {\n          specifier,\n          exportName: (element.propertyName ?? element.name).text,\n        });\n      }\n    }\n  }\n\n  return bindings;\n}\n\n/** The identifier a class assigns to `static resource`, when it is a bare identifier. */\nfunction readStaticResourceReference(\n  member: ts.ClassElement,\n): { name: string } | \"computed\" | undefined {\n  if (!ts.isPropertyDeclaration(member)) return undefined;\n  if (!hasModifier(member, ts.SyntaxKind.StaticKeyword)) return undefined;\n  if (hasModifier(member, ts.SyntaxKind.DeclareKeyword)) return undefined;\n\n  const isResourceName =\n    (ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)) &&\n    member.name.text === \"resource\";\n\n  if (!isResourceName) return undefined;\n  if (!member.initializer) return undefined;\n\n  const initializer = unwrapParentheses(member.initializer);\n\n  return ts.isIdentifier(initializer) ? { name: initializer.text } : \"computed\";\n}\n\n/**\n * Read every model class of one file that declares `static resource = <Identifier>`\n * and resolve it to a model export plus a resource export. Pure: the only\n * outside knowledge is the injected {@link ExtractModelResourcesInput.resolveImport}.\n */\nexport function extractModelResourceEntries(\n  input: ExtractModelResourcesInput,\n): ModelResourceExtraction {\n  const result: ModelResourceExtraction = { entries: [], skipped: [] };\n\n  // Cheap exit: most model files declare no resource.\n  if (!input.source.includes(\"resource\")) return result;\n\n  const sourceFile = ts.createSourceFile(\n    input.absolutePath,\n    input.source,\n    ts.ScriptTarget.ESNext,\n    /* setParentNodes */ false,\n    input.absolutePath.endsWith(\"x\") ? ts.ScriptKind.TSX : ts.ScriptKind.TS,\n  );\n\n  const { declared, exportNames } = readLocalDeclarations(sourceFile);\n  const imports = readImportBindings(sourceFile);\n\n  for (const statement of sourceFile.statements) {\n    if (!ts.isClassDeclaration(statement) || !statement.name) continue;\n\n    const className = statement.name.text;\n\n    let reference: { name: string } | \"computed\" | undefined;\n\n    for (const member of statement.members) {\n      reference = readStaticResourceReference(member) ?? reference;\n    }\n\n    if (reference === undefined) continue;\n\n    const skip = (reason: string): void => {\n      result.skipped.push({ className, modelFile: input.absolutePath, reason });\n    };\n\n    if (reference === \"computed\") {\n      skip(\"`static resource` is not a plain identifier\");\n      continue;\n    }\n\n    const requiresTypeArguments = statement.typeParameters?.some(\n      (parameter) => parameter.default === undefined,\n    );\n\n    if (requiresTypeArguments) {\n      skip(\"the model class is generic\");\n      continue;\n    }\n\n    const modelExport = pickExportName(exportNames.get(className));\n\n    if (modelExport === undefined) {\n      skip(\"the model class is not exported\");\n      continue;\n    }\n\n    if (modelExport !== \"default\" && !IDENTIFIER.test(modelExport)) {\n      skip(\"the model export name is not an identifier\");\n      continue;\n    }\n\n    const binding = imports.get(reference.name);\n\n    let resourceFile: string | undefined;\n    let resourceExport: string | undefined;\n\n    if (binding) {\n      resourceFile = input.resolveImport(binding.specifier);\n      resourceExport = binding.exportName;\n    } else if (declared.has(reference.name)) {\n      resourceFile = input.absolutePath;\n      resourceExport = pickExportName(exportNames.get(reference.name));\n    }\n\n    if (resourceFile === undefined || resourceExport === undefined) {\n      skip(`\\`${reference.name}\\` cannot be resolved to an exported module member`);\n      continue;\n    }\n\n    if (resourceExport !== \"default\" && !IDENTIFIER.test(resourceExport)) {\n      skip(\"the resource export name is not an identifier\");\n      continue;\n    }\n\n    result.entries.push({\n      className,\n      modelFile: input.absolutePath,\n      modelExport,\n      resourceFile,\n      resourceExport,\n    });\n  }\n\n  return result;\n}\n\n/** Module specifier, relative to the typings directory, without a TypeScript extension. */\nfunction toTypeImportSpecifier(typingsDirectory: string, absoluteFile: string): string | undefined {\n  const path = relative(typingsDirectory, absoluteFile).replaceAll(\"\\\\\", \"/\");\n\n  // A different drive (Windows) has no relative form; do not emit a guess.\n  if (isAbsolute(path)) return undefined;\n\n  const withoutExtension = path.replace(/\\.(?:d\\.)?(?:ts|tsx|mts|cts)$/, \"\");\n\n  return withoutExtension.startsWith(\".\") ? withoutExtension : `./${withoutExtension}`;\n}\n\n/**\n * Registry keys: the class name, suffixed `_2`, `_3`, ... when several model\n * files declare the same class name. Order is by class name, then by file path,\n * so the same set of models always yields the same keys and the same text.\n */\nexport function assignRegistryKeys(\n  entries: readonly ModelResourceEntry[],\n): Array<{ key: string; entry: ModelResourceEntry }> {\n  const sorted = [...entries].sort(\n    (a, b) =>\n      a.className.localeCompare(b.className, \"en\") ||\n      a.modelFile.localeCompare(b.modelFile, \"en\") ||\n      a.modelExport.localeCompare(b.modelExport, \"en\"),\n  );\n\n  const taken = new Set<string>();\n  const counts = new Map<string, number>();\n\n  return sorted.map((entry) => {\n    let count = (counts.get(entry.className) ?? 0) + 1;\n    let key = count === 1 ? entry.className : `${entry.className}_${count}`;\n\n    while (taken.has(key)) {\n      count += 1;\n      key = `${entry.className}_${count}`;\n    }\n\n    counts.set(entry.className, count);\n    taken.add(key);\n\n    return { key, entry };\n  });\n}\n\n/**\n * Text of the generated declaration file.\n *\n * @param entries Every resolved model, in any order.\n * @param typingsDirectory Absolute directory the file is written to; import\n * specifiers are relative to it.\n */\nexport function renderModelResourceRegistry(\n  entries: readonly ModelResourceEntry[],\n  typingsDirectory: string,\n): string {\n  const lines: string[] = [];\n\n  for (const { key, entry } of assignRegistryKeys(entries)) {\n    const modelPath = toTypeImportSpecifier(typingsDirectory, entry.modelFile);\n    const resourcePath = toTypeImportSpecifier(typingsDirectory, entry.resourceFile);\n\n    if (modelPath === undefined || resourcePath === undefined) continue;\n\n    const model = `import(${JSON.stringify(modelPath)}).${entry.modelExport}`;\n    const resource = `typeof import(${JSON.stringify(resourcePath)}).${entry.resourceExport}`;\n\n    lines.push(`    ${JSON.stringify(key)}: { model: ${model}; resource: ${resource} };`);\n  }\n\n  return `// Auto-generated by Warlock.js - DO NOT EDIT\n// One entry per model class that declares \\`static resource = <Resource>\\`, so\n// \\`Serialized<Model>\\` resolves to the resource output. Models whose resource\n// cannot be resolved statically are left out.\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ModelResourceRegistry {\n${lines.join(\"\\n\")}\n  }\n}\n`;\n}\n\n/**\n * Write `content` to `filePath` through a temporary sibling and a rename, so a\n * reader (the editor's TypeScript server) never sees a half-written file, and\n * skip the write entirely when the file already holds exactly this text.\n *\n * @returns `true` when the file was written.\n */\nexport async function writeFileIfChanged(filePath: string, content: string): Promise<boolean> {\n  try {\n    if ((await readFile(filePath, \"utf-8\")) === content) return false;\n  } catch {\n    // Missing file: write it.\n  }\n\n  await mkdir(dirname(filePath), { recursive: true });\n\n  const temporaryPath = `${filePath}.${process.pid}.tmp`;\n\n  try {\n    await writeFile(temporaryPath, content, \"utf-8\");\n    await rename(temporaryPath, filePath);\n  } catch (error) {\n    await rm(temporaryPath, { force: true });\n\n    throw error;\n  }\n\n  return true;\n}\n"],"mappings":"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"}

package/esm/dev-server/type-generator.mjs

@@ -3,13 +3,15 @@ import { warlockPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { parseLocaleDictionary } from "../localization/parse-locale-dictionary.mjs";
 import "../localization/index.mjs";
-import { devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
+import { devLogDim, devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
+import { parseImports } from "./parse-imports.mjs";
 import { getFilesFromDirectory } from "./utils.mjs";
 import { extractTranslationKeys } from "./extract-translation-keys.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { readConfigAst } from "./read-config-ast.mjs";
 import { runTypingsGeneration } from "./run-typings-generation.mjs";
 import { isModuleLocaleDictionaryPath, isTranslationRegisteringSource } from "./translation-keys-sources.mjs";
+import { extractModelResourceEntries, renderModelResourceRegistry, writeFileIfChanged } from "./model-resource-typings.mjs";
 import { join, resolve } from "path";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import { constants } from "fs";
@@ -58,6 +60,7 @@ var TypeGenerator = class {
 		this.manifest = null;
 		this.configCache = /* @__PURE__ */ new Map();
 		this.translationSourceFiles = /* @__PURE__ */ new Set();
+		this.modelResourceSourceFiles = /* @__PURE__ */ new Set();
 	}
 	/**
 	* Generate all framework type definitions
@@ -83,6 +86,7 @@ var TypeGenerator = class {
 			await this.reconcile();
 		}
 		await this.generateTranslationTypes();
+		await this.generateModelResourceTypes();
 		await this.saveManifest();
 	}
 	/**
@@ -278,6 +282,42 @@ ${Array.from(keys).sort().map((key) => `    ${JSON.stringify(key)}: true;`).join
 		await writeFile(join(this.outputDir, "translations.d.ts"), content, "utf-8");
 		devLogSuccess(`Generated translation types: ${keys.size} keys`);
 	}
+	/**
+	* Generate `model-resources.d.ts`: the `ModelResourceRegistry` augmentation
+	* behind `Serialized<Model>`.
+	*
+	* Reads every discovered model file (`*.model.ts`) and records the ones that
+	* declare `static resource = <Identifier>`. Static AST read only, no app
+	* module is imported; see `model-resource-typings.ts` for what is skipped.
+	* The file is rewritten only when its text changes.
+	*/
+	async generateModelResourceTypes() {
+		try {
+			const entries = [];
+			const sourceFiles = /* @__PURE__ */ new Set();
+			const skippedModels = [];
+			for (const [path, fileManager] of filesOrchestrator.getFiles()) {
+				if (fileManager.type !== "model" || !fileManager.source.includes("resource")) continue;
+				const imports = await parseImports(fileManager.source, fileManager.absolutePath);
+				const extraction = extractModelResourceEntries({
+					source: fileManager.source,
+					absolutePath: fileManager.absolutePath,
+					resolveImport: (specifier) => imports.get(specifier)?.absolutePath
+				});
+				if (extraction.entries.length > 0) sourceFiles.add(path);
+				for (const entry of extraction.entries) {
+					entries.push(entry);
+					sourceFiles.add(Path.toRelative(entry.resourceFile));
+				}
+				for (const skipped of extraction.skipped) skippedModels.push(`${skipped.className} (${skipped.reason})`);
+			}
+			this.modelResourceSourceFiles = sourceFiles;
+			if (await writeFileIfChanged(join(this.outputDir, "model-resources.d.ts"), renderModelResourceRegistry(entries, this.outputDir))) devLogSuccess(`Generated model resource types: ${entries.length} models`);
+			if (skippedModels.length > 0) devLogDim(`Model resources not typed (not statically resolvable): ${skippedModels.join(", ")}`);
+		} catch (error) {
+			devServeLog(`⚠️ Failed to generate model resource types: ${error}`);
+		}
+	}
 	isLocalesFile(path) {
 		return Path.normalize(path).includes("/utils/locales.");
 	}
@@ -535,12 +575,16 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 	*/
 	async executeTypingsGenerator(upcomingFiles) {
 		const files = filesOrchestrator.getFiles();
-		if (!(Array.from(this.translationSourceFiles).some((path) => !files.has(path)) || Array.from(new Set(upcomingFiles)).some((file) => {
+		const aKnownTranslationSourceVanished = Array.from(this.translationSourceFiles).some((path) => !files.has(path));
+		const aKnownModelResourceSourceVanished = Array.from(this.modelResourceSourceFiles).some((path) => !files.has(path));
+		if (!(aKnownTranslationSourceVanished || aKnownModelResourceSourceVanished || Array.from(new Set(upcomingFiles)).some((file) => {
 			const normalizedPath = Path.normalize(file);
 			if (normalizedPath.includes("src/config/")) return true;
 			if (isRouteLocalesJsonPath(normalizedPath)) return true;
 			if (isModuleLocaleDictionaryPath(normalizedPath)) return true;
 			if (this.translationSourceFiles.has(normalizedPath)) return true;
+			if (this.modelResourceSourceFiles.has(normalizedPath)) return true;
+			if (files.get(normalizedPath)?.type === "model") return true;
 			const fileManager = files.get(normalizedPath);
 			return fileManager !== void 0 && isTranslationRegisteringSource(normalizedPath, fileManager.source);
 		}))) return;

package/esm/dev-server/type-generator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/type-generator.ts"],"sourcesContent":["import { ensureDirectoryAsync } from \"@warlock.js/fs\";\nimport { constants } from \"fs\";\nimport { access, readFile, writeFile } from \"fs/promises\";\nimport { moduleResolve } from \"import-meta-resolve\";\nimport { join, resolve } from \"path\";\nimport { pathToFileURL } from \"node:url\";\nimport ts from \"typescript\";\nimport { warlockPath } from \"../utils\";\nimport { devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\nimport { readConfigAst } from \"./read-config-ast\";\nimport { runTypingsGeneration, type TypingsGenerationPorts } from \"./run-typings-generation\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\nimport { extractTranslationKeys } from \"./extract-translation-keys\";\nimport {\n  isModuleLocaleDictionaryPath,\n  isTranslationRegisteringSource,\n} from \"./translation-keys-sources\";\nimport { parseLocaleDictionary } from \"../localization\";\nimport { getFilesFromDirectory } from \"./utils\";\n\ntype RouteLocaleBuildModule = {\n  listRouteLocaleKeys?: (options: {\n    appRoot?: string;\n  }) => readonly string[] | Promise<readonly string[]>;\n};\n\nconst WEB_PACKAGE = \"@warlock.js/web\";\nconst WEB_BUILD_PACKAGE = \"@warlock.js/web/build\";\n\nfunction isAbsentOptionalWebPackage(thrown: unknown): boolean {\n  return (\n    typeof thrown === \"object\" &&\n    thrown !== null &&\n    \"code\" in thrown &&\n    (thrown as { code?: unknown }).code === \"ERR_MODULE_NOT_FOUND\" &&\n    thrown instanceof Error &&\n    thrown.message.includes(`Cannot find package '${WEB_PACKAGE}'`)\n  );\n}\n\n/** Load the build-only web key lister without creating a core-to-web static edge. */\nexport async function listRouteLocaleKeysForTypeGeneration(\n  appRoot = process.cwd(),\n): Promise<readonly string[]> {\n  // Published web entries are import-only. Resolve with ESM conditions from\n  // the consuming project; require.resolve rejects those installed exports.\n  const projectUrl = pathToFileURL(resolve(appRoot, \"package.json\"));\n\n  try {\n    moduleResolve(WEB_PACKAGE, projectUrl);\n  } catch (thrown) {\n    if (isAbsentOptionalWebPackage(thrown)) return [];\n    throw thrown;\n  }\n\n  const buildModuleUrl = moduleResolve(WEB_BUILD_PACKAGE, projectUrl);\n  const buildModule = (await import(buildModuleUrl.href)) as RouteLocaleBuildModule;\n\n  if (typeof buildModule.listRouteLocaleKeys !== \"function\") {\n    throw new Error(\n      `${WEB_BUILD_PACKAGE} does not export listRouteLocaleKeys. Upgrade @warlock.js/web to a compatible version.`,\n    );\n  }\n\n  return buildModule.listRouteLocaleKeys({ appRoot });\n}\n\n/** True only for the route-locales convention under the canonical web root. */\nexport function isRouteLocalesJsonPath(path: string): boolean {\n  const normalized = Path.normalize(path);\n  const relativePath = normalized.startsWith(\"src/\") ? normalized : Path.toRelative(normalized);\n  return /^src\\/web(?:\\/.*)?\\/locales\\.json$/.test(relativePath);\n}\n\n/**\n * Typings manifest structure for tracking file hashes\n */\ntype TypingsManifest = {\n  version: string;\n  lastBuildTime: number;\n  storage: {\n    sourceHash: string;\n    drivers: string[];\n  } | null;\n  config: Record<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >;\n};\n\n/**\n * TypeGenerator - Generates TypeScript type definitions from config files\n *\n * Parses source config files using the TypeScript Compiler API to extract\n * keys and generate module augmentation types for IDE autocomplete.\n *\n * Uses manifest-based reconciliation to only regenerate when source files change.\n */\nexport class TypeGenerator {\n  /**\n   * Output directory for generated typings\n   */\n  private outputDir = warlockPath(\"typings\");\n\n  /**\n   * Path to typings manifest file\n   */\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\n\n  /**\n   * Cached manifest data\n   */\n  private manifest: TypingsManifest | null = null;\n\n  /**\n   * Cache for config type info and keys\n   */\n  private configCache = new Map<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >();\n\n  /**\n   * Generate all framework type definitions\n   *\n   * Uses manifest-based reconciliation:\n   * - If output files don't exist: full regeneration\n   * - If files exist: only regenerate changed configs\n   */\n  public async generateAll(): Promise<void> {\n    await this.ensureOutputDir();\n\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\n    const configFile = join(this.outputDir, \"config.d.ts\");\n    const translationsFile = join(this.outputDir, \"translations.d.ts\");\n\n    const [manifestExists, storageExists, configExists, translationsExist] = await Promise.all([\n      this.exists(this.manifestPath),\n      this.exists(storageFile),\n      this.exists(configFile),\n      this.exists(translationsFile),\n    ]);\n\n    if (!manifestExists || !storageExists || !configExists || !translationsExist) {\n      // Full regeneration (first run or files deleted)\n      await this.fullGeneration();\n    } else {\n      // Load manifest for hash comparison\n      await this.loadManifest();\n      // Reconciliation: only regenerate changed files\n      await this.reconcile();\n    }\n\n    await this.generateTranslationTypes();\n\n    await this.saveManifest();\n  }\n\n  /**\n   * Full regeneration of all type files\n   */\n  private async fullGeneration(): Promise<void> {\n    // Generate storage types\n    const storageConfigPath = await this.findConfigFile(\"storage\");\n    if (storageConfigPath) {\n      this.generateStorageTypes(storageConfigPath);\n    }\n\n    // Generate config types\n    await this.generateConfigTypes();\n  }\n\n  /**\n   * Reconcile: only regenerate changed files\n   */\n  private async reconcile(): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n    let storageChanged = false;\n    let configChanged = false;\n    let unchangedCount = 0;\n\n    this.configCache.clear();\n\n    // Check storage config\n    for (const [path, fileManager] of files) {\n      if (path.startsWith(\"src/config/storage\")) {\n        const manifestEntry = this.manifest?.storage;\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n          storageChanged = true;\n          await this.generateStorageTypes(path);\n        }\n        break;\n      }\n    }\n\n    // Check config files\n    for (const [path, fileManager] of files) {\n      if (!path.startsWith(\"src/config/\")) continue;\n      if (\n        path\n          .split(\"/\")\n          .pop()\n          ?.replace(/[.][^.]+$/, \"\") === \"index\"\n      )\n        continue;\n\n      // Extract config name (remove dir prefix and extension)\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n      const manifestEntry = this.manifest?.config[configName];\n\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n        // File changed or new - regenerate\n        configChanged = true;\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      } else {\n        // Unchanged - load from manifest\n        unchangedCount++;\n        this.configCache.set(configName, manifestEntry);\n      }\n    }\n\n    if (configChanged) {\n      await this.writeConfigTypesFromCache();\n    } else {\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\n    }\n  }\n\n  /**\n   * Generate storage driver name types\n   */\n  public async generateStorageTypes(configPath: string): Promise<void> {\n    try {\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\n\n      if (driverKeys.length === 0) {\n        devServeLog(\"⚠️ No storage drivers found in config\");\n        return;\n      }\n\n      // Get file hash from filesOrchestrator\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\n      const sourceHash = fileManager?.hash || \"\";\n\n      // Update manifest\n      if (!this.manifest) {\n        this.manifest = this.createEmptyManifest();\n      }\n      this.manifest.storage = {\n        sourceHash,\n        drivers: driverKeys,\n      };\n\n      const interfaceContent = driverKeys\n        .map((k) => `    ${this.toInterfaceKey(k)}: true;`)\n        .join(\"\\n\");\n\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from: ${configPath}\n// Regenerates on dev-server start and when storage config changes\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface StorageDriverRegistry {\n${interfaceContent}\n  }\n}\n`;\n\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\n      await writeFile(outputPath, content, \"utf-8\");\n\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\n    }\n  }\n\n  /**\n   * Check if a file change should trigger type regeneration\n   */\n  public shouldRegenerateTypes(changedPath: string): boolean {\n    return (\n      changedPath.includes(\"src/config/\") ||\n      changedPath.includes(\"config/\") ||\n      this.isLocalesFile(changedPath) ||\n      isRouteLocalesJsonPath(changedPath)\n    );\n  }\n\n  /**\n   * Handle file change - uses incremental update via cache\n   */\n  public async handleFileChange(changedPath: string): Promise<void> {\n    if (!this.shouldRegenerateTypes(changedPath)) {\n      return;\n    }\n\n    // Regenerate storage types if storage config changed\n    if (changedPath.includes(\"config/storage\")) {\n      await this.generateStorageTypes(changedPath);\n      await this.saveManifest();\n      return;\n    }\n\n    if (this.isLocalesFile(changedPath) || isRouteLocalesJsonPath(changedPath)) {\n      await this.generateTranslationTypes();\n      return;\n    }\n\n    // Extract config name from path\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\n    if (!match) {\n      return;\n    }\n\n    const configName = match[1];\n    if (!configName || configName === \"index\") return;\n\n    devLogInfo(`Config changed: ${configName}, updating...`);\n\n    // Get file manager for hash\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\n    const sourceHash = fileManager?.hash || Date.now().toString();\n\n    // Update only the changed config in cache (use optimized combined extraction)\n    const configDir = join(process.cwd(), \"src/config\");\n    const configPath = join(configDir, `${configName}.ts`);\n\n    const info = await this.extractConfigInfo(configPath, configName);\n\n    this.configCache.set(configName, {\n      sourceHash,\n      typeName: info.typeName,\n      importSource: info.importSource,\n      keys: info.keys,\n    });\n\n    // Regenerate config.d.ts from cache\n    await this.writeConfigTypesFromCache();\n    await this.saveManifest();\n  }\n\n  /**\n   * Generate config types - populates cache and writes file\n   */\n  public async generateConfigTypes(): Promise<void> {\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      // Clear and repopulate cache\n      this.configCache.clear();\n\n      for (const [path, fileManager] of files) {\n        if (!path.startsWith(\"src/config/\")) continue;\n        if (\n          path\n            .split(\"/\")\n            .pop()\n            ?.replace(/[.][^.]+$/, \"\") === \"index\"\n        )\n          continue;\n\n        // Extract config name\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n        // One parse per config, both extractions off it — see `read-config-ast.ts`.\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      }\n\n      await this.writeConfigTypesFromCache();\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\n    }\n  }\n\n  /**\n   * Files (relative paths) that contributed to the last generated registry —\n   * used to notice a registering file being deleted, since by the time a\n   * delete event reaches {@link executeTypingsGenerator} the file is already\n   * gone from `filesOrchestrator`'s map and its content can no longer be\n   * inspected.\n   */\n  private translationSourceFiles = new Set<string>();\n\n  /**\n   * Generate web's app-augmented translation-key registry.\n   *\n   * Scans every discovered app source file — not only dedicated\n   * `utils/locales.*` files — for `groupedTranslations` calls, both the\n   * named-group and object forms, at any nesting depth. Dynamic group names,\n   * dictionaries, or keys cannot be resolved statically and are skipped; an\n   * app relying on those must document them itself.\n   */\n  private async generateTranslationTypes(): Promise<void> {\n    const keys = new Set<string>();\n    const sourceFiles = new Set<string>();\n\n    for (const [path, fileManager] of filesOrchestrator.getFiles()) {\n      if (!isTranslationRegisteringSource(path, fileManager.source)) {\n        continue;\n      }\n\n      sourceFiles.add(path);\n\n      if (isModuleLocaleDictionaryPath(path)) {\n        const dictionary = parseLocaleDictionary({\n          sourceFile: path,\n          source: fileManager.source,\n          defaultNamespace: path.split(\"/\")[2]!,\n        });\n        for (const key of Object.keys(dictionary.entries)) {\n          keys.add(key);\n        }\n        continue;\n      }\n\n      const sourceFile = await readConfigAst(fileManager.absolutePath);\n      if (sourceFile) {\n        for (const key of extractTranslationKeys(sourceFile)) {\n          keys.add(key);\n        }\n      }\n    }\n\n    // The dev source map intentionally tracks executable TypeScript only. Module\n    // dictionaries are JSON data, so discover them directly without loading app\n    // code; use the runtime parser to keep `$group` and flattening identical.\n    for (const absolutePath of await getFilesFromDirectory(\n      join(process.cwd(), \"src\", \"app\"),\n      \"**/utils/locales.json\",\n    )) {\n      const path = Path.toRelative(absolutePath);\n      sourceFiles.add(path);\n      const dictionary = parseLocaleDictionary({\n        sourceFile: path,\n        source: await readFile(absolutePath, \"utf-8\"),\n        defaultNamespace: path.split(\"/\")[2]!,\n      });\n      for (const key of Object.keys(dictionary.entries)) {\n        keys.add(key);\n      }\n    }\n\n    for (const key of await listRouteLocaleKeysForTypeGeneration()) {\n      keys.add(key);\n    }\n\n    this.translationSourceFiles = sourceFiles;\n\n    const entries = Array.from(keys)\n      .sort()\n      .map((key) => `    ${JSON.stringify(key)}: true;`)\n      .join(\"\\n\");\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from groupedTranslations calls and route-locales JSON in discovered\n// app source. Dynamic group names/keys cannot be resolved statically and are\n// not included here — document those yourself.\n\nimport \"@warlock.js/web\";\n\ndeclare module \"@warlock.js/web\" {\n  interface TranslationKeyRegistry {\n${entries}\n  }\n}\n`;\n\n    await writeFile(join(this.outputDir, \"translations.d.ts\"), content, \"utf-8\");\n    devLogSuccess(`Generated translation types: ${keys.size} keys`);\n  }\n\n  private isLocalesFile(path: string): boolean {\n    return Path.normalize(path).includes(\"/utils/locales.\");\n  }\n\n  /**\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\n   * to keep the output clean.\n   */\n  private toInterfaceKey(name: string): string {\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n  }\n\n  /**\n   * Write config.d.ts from cached data\n   */\n  private async writeConfigTypesFromCache(): Promise<void> {\n    const configTypeInfos: Array<{\n      name: string;\n      typeName: string | null;\n      importSource: string | null;\n    }> = [];\n    const allKeys: string[] = [];\n\n    // Update manifest config section\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.config = {};\n\n    for (const [name, data] of this.configCache) {\n      configTypeInfos.push({\n        name,\n        typeName: data.typeName,\n        importSource: data.importSource,\n      });\n      allKeys.push(...data.keys);\n\n      // Store in manifest\n      this.manifest.config[name] = data;\n    }\n\n    // Group imports by source\n    const imports = new Map<string, Set<string>>();\n    for (const info of configTypeInfos) {\n      if (info.typeName && info.importSource) {\n        if (!imports.has(info.importSource)) {\n          imports.set(info.importSource, new Set());\n        }\n        imports.get(info.importSource)!.add(info.typeName);\n      }\n    }\n\n    const importStatements = Array.from(imports.entries())\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\n      .join(\"\\n\");\n\n    const configEntries = configTypeInfos\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\n      .join(\"\\n\");\n\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\n\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Regenerates on dev-server start and when config files change\n\n${importStatements}\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ConfigRegistry {\n${configEntries}\n  }\n\n  interface ConfigKeyRegistry {\n${keyEntries}\n  }\n}\n`;\n\n    const outputPath = join(this.outputDir, \"config.d.ts\");\n    await writeFile(outputPath, content, \"utf-8\");\n\n    devLogSuccess(\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\n    );\n  }\n\n  // ============================================================\n  // Manifest Management\n  // ============================================================\n\n  /**\n   * Load manifest from disk\n   */\n  private async loadManifest(): Promise<boolean> {\n    try {\n      if (await this.exists(this.manifestPath)) {\n        const content = await readFile(this.manifestPath, \"utf-8\");\n        this.manifest = JSON.parse(content);\n        return true;\n      }\n    } catch {\n      // Manifest corrupted or missing\n    }\n    this.manifest = null;\n    return false;\n  }\n\n  /**\n   * Save manifest to disk\n   */\n  private async saveManifest(): Promise<void> {\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.lastBuildTime = Date.now();\n\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\n  }\n\n  /**\n   * Create empty manifest structure\n   */\n  private createEmptyManifest(): TypingsManifest {\n    return {\n      version: \"1.0.0\",\n      lastBuildTime: Date.now(),\n      storage: null,\n      config: {},\n    };\n  }\n\n  // ============================================================\n  // Type Extraction Methods\n  // ============================================================\n\n  /**\n   * Extract BOTH type info AND keys in a single pass\n   *\n   * One parse serves both extractions. It used to be one whole TypeScript\n   * Program per file — halved from two by an earlier pass, which optimised\n   * inside a premise that did not need to hold. `read-config-ast.ts` has the\n   * numbers.\n   *\n   * @param configPath Absolute path to the config file\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\n   * @returns Combined result with type info and keys\n   */\n  private async extractConfigInfo(\n    configPath: string,\n    configName: string,\n  ): Promise<{\n    typeName: string | null;\n    importSource: string | null;\n    keys: string[];\n  }> {\n    if (!(await this.exists(configPath))) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // Parse, do not resolve — `read-config-ast.ts` explains why, with numbers.\n    const sourceFile = await readConfigAst(configPath);\n\n    if (!sourceFile) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // === Type Info Extraction ===\n    const importedTypes = new Map<string, string>();\n    const localExportedTypes = new Set<string>();\n    let foundTypeName: string | null = null;\n\n    // === Keys Extraction ===\n    const keys: string[] = [];\n\n    const visitForTypes = (node: ts.Node): void => {\n      // Collect imported types\n      if (ts.isImportDeclaration(node)) {\n        const moduleSpecifier = node.moduleSpecifier;\n        if (ts.isStringLiteral(moduleSpecifier)) {\n          const source = moduleSpecifier.text;\n          const importClause = node.importClause;\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\n            for (const element of importClause.namedBindings.elements) {\n              importedTypes.set(element.name.text, source);\n            }\n          }\n        }\n      }\n\n      // Collect locally exported types\n      if (ts.isTypeAliasDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Collect locally exported interfaces\n      if (ts.isInterfaceDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Find type used on config variable + extract keys\n      if (ts.isVariableDeclaration(node)) {\n        // Type info\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\n          foundTypeName = node.type.typeName.getText(sourceFile);\n        }\n\n        // Keys extraction\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\n            for (const prop of objNode.properties) {\n              if (ts.isPropertyAssignment(prop) && prop.name) {\n                const keyName = prop.name.getText(sourceFile);\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\n                keys.push(fullKey);\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\n                  visitKeys(prop.initializer, fullKey);\n                }\n              }\n            }\n          };\n          visitKeys(node.initializer, configName);\n        }\n      }\n\n      ts.forEachChild(node, visitForTypes);\n    };\n\n    ts.forEachChild(sourceFile, visitForTypes);\n\n    // Resolve type info\n    let typeName: string | null = null;\n    let importSource: string | null = null;\n\n    if (foundTypeName) {\n      if (importedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        importSource = importedTypes.get(foundTypeName)!;\n      } else if (localExportedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\n        importSource = `../../${relativePath}`;\n      }\n    }\n\n    return { typeName, importSource, keys };\n  }\n\n  /**\n   * Extract driver keys from storage config\n   */\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\n    const absolutePath = resolve(configPath);\n\n    if (!(await this.exists(absolutePath))) {\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\n      return [];\n    }\n\n    const sourceFile = await readConfigAst(absolutePath);\n\n    if (!sourceFile) {\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\n      return [];\n    }\n\n    const keys: string[] = [];\n\n    const visit = (node: ts.Node): void => {\n      if (ts.isPropertyAssignment(node)) {\n        const propName = node.name.getText(sourceFile);\n\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\n          for (const prop of node.initializer.properties) {\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\n              const keyName = prop.name?.getText(sourceFile);\n\n              if (keyName) {\n                keys.push(keyName);\n              }\n            }\n          }\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    ts.forEachChild(sourceFile, visit);\n\n    return keys;\n  }\n\n  /**\n   * Find a config file by name\n   */\n  private async findConfigFile(configName: string): Promise<string | undefined> {\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\n\n    for (const path of possiblePaths) {\n      const fullPath = join(process.cwd(), path);\n\n      if (await this.exists(fullPath)) {\n        return path;\n      }\n    }\n\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      for (const [filePath] of files) {\n        if (filePath.includes(`config/${configName}`)) {\n          return filePath;\n        }\n      }\n    } catch {\n      // Files orchestrator not initialized yet\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Ensure output directory exists\n   */\n  private async ensureOutputDir(): Promise<void> {\n    await ensureDirectoryAsync(this.outputDir);\n  }\n\n  /**\n   * Check if a path exists (async wrapper)\n   */\n  private async exists(path: string): Promise<boolean> {\n    try {\n      await access(path, constants.F_OK);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * The ports `runTypingsGeneration` needs, bound to this instance and this\n   * package's dev logger.\n   */\n  private get typingsGenerationPorts(): TypingsGenerationPorts {\n    return {\n      generate: () => this.generateAll(),\n      info: (message) => devLogInfo(message),\n      success: (message) => devLogSuccess(message),\n      error: (message) => devLogError(message),\n    };\n  }\n\n  /**\n   * Generate every config's typings.\n   *\n   * Runs IN THIS PROCESS. It used to spawn `npx warlock generate.typings`,\n   * which could not resolve in a source checkout — see\n   * `run-typings-generation.ts` for the whole story.\n   */\n  public async executeGenerateAllCommand(): Promise<void> {\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n\n  /**\n   * Regenerate typings after a batch reload — but only when the batch\n   * plausibly touched something the typings depend on: a config file, a file\n   * that registers translation keys, or a registering file that was deleted.\n   *\n   * A deleted file is already gone from `filesOrchestrator` by the time this\n   * runs (deletes are processed before `dev-server:batch-complete` fires), so\n   * its content can't be re-checked here — `translationSourceFiles` is the\n   * set from the last generation, kept for exactly this comparison.\n   */\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n\n    const aKnownTranslationSourceVanished = Array.from(this.translationSourceFiles).some(\n      (path) => !files.has(path),\n    );\n\n    const touchedAConfig =\n      aKnownTranslationSourceVanished ||\n      Array.from(new Set(upcomingFiles)).some((file) => {\n        const normalizedPath = Path.normalize(file);\n        if (normalizedPath.includes(\"src/config/\")) return true;\n        if (isRouteLocalesJsonPath(normalizedPath)) return true;\n        if (isModuleLocaleDictionaryPath(normalizedPath)) return true;\n        if (this.translationSourceFiles.has(normalizedPath)) return true;\n\n        const fileManager = files.get(normalizedPath);\n        return (\n          fileManager !== undefined &&\n          isTranslationRegisteringSource(normalizedPath, fileManager.source)\n        );\n      });\n\n    if (!touchedAConfig) return;\n\n    /*\n      The changed paths are deliberately NOT passed along. The previous version\n      built a `files` array here and then threw it away, spawning the same\n      whole-project command as the branch above — so \"incremental\" was a name,\n      not a behaviour. `generateAll()` reads the orchestrator, which the batch\n      reload has already updated, so the full pass is both correct and the only\n      pass that ever actually ran.\n    */\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n}\n\n/**\n * Singleton instance for use throughout dev-server\n */\nexport const typeGenerator = new TypeGenerator();\n"],"mappings":"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"}
+{"version":3,"file":"type-generator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/type-generator.ts"],"sourcesContent":["import { ensureDirectoryAsync } from \"@warlock.js/fs\";\nimport { constants } from \"fs\";\nimport { access, readFile, writeFile } from \"fs/promises\";\nimport { moduleResolve } from \"import-meta-resolve\";\nimport { join, resolve } from \"path\";\nimport { pathToFileURL } from \"node:url\";\nimport ts from \"typescript\";\nimport { warlockPath } from \"../utils\";\nimport { devLogDim, devLogError, devLogInfo, devLogSuccess, devServeLog } from \"./dev-logger\";\nimport { readConfigAst } from \"./read-config-ast\";\nimport { runTypingsGeneration, type TypingsGenerationPorts } from \"./run-typings-generation\";\nimport { filesOrchestrator } from \"./files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\nimport { extractTranslationKeys } from \"./extract-translation-keys\";\nimport {\n  isModuleLocaleDictionaryPath,\n  isTranslationRegisteringSource,\n} from \"./translation-keys-sources\";\nimport { parseLocaleDictionary } from \"../localization\";\nimport { getFilesFromDirectory } from \"./utils\";\nimport {\n  extractModelResourceEntries,\n  renderModelResourceRegistry,\n  writeFileIfChanged,\n  type ModelResourceEntry,\n} from \"./model-resource-typings\";\nimport { parseImports } from \"./parse-imports\";\n\ntype RouteLocaleBuildModule = {\n  listRouteLocaleKeys?: (options: {\n    appRoot?: string;\n  }) => readonly string[] | Promise<readonly string[]>;\n};\n\nconst WEB_PACKAGE = \"@warlock.js/web\";\nconst WEB_BUILD_PACKAGE = \"@warlock.js/web/build\";\n\nfunction isAbsentOptionalWebPackage(thrown: unknown): boolean {\n  return (\n    typeof thrown === \"object\" &&\n    thrown !== null &&\n    \"code\" in thrown &&\n    (thrown as { code?: unknown }).code === \"ERR_MODULE_NOT_FOUND\" &&\n    thrown instanceof Error &&\n    thrown.message.includes(`Cannot find package '${WEB_PACKAGE}'`)\n  );\n}\n\n/** Load the build-only web key lister without creating a core-to-web static edge. */\nexport async function listRouteLocaleKeysForTypeGeneration(\n  appRoot = process.cwd(),\n): Promise<readonly string[]> {\n  // Published web entries are import-only. Resolve with ESM conditions from\n  // the consuming project; require.resolve rejects those installed exports.\n  const projectUrl = pathToFileURL(resolve(appRoot, \"package.json\"));\n\n  try {\n    moduleResolve(WEB_PACKAGE, projectUrl);\n  } catch (thrown) {\n    if (isAbsentOptionalWebPackage(thrown)) return [];\n    throw thrown;\n  }\n\n  const buildModuleUrl = moduleResolve(WEB_BUILD_PACKAGE, projectUrl);\n  const buildModule = (await import(buildModuleUrl.href)) as RouteLocaleBuildModule;\n\n  if (typeof buildModule.listRouteLocaleKeys !== \"function\") {\n    throw new Error(\n      `${WEB_BUILD_PACKAGE} does not export listRouteLocaleKeys. Upgrade @warlock.js/web to a compatible version.`,\n    );\n  }\n\n  return buildModule.listRouteLocaleKeys({ appRoot });\n}\n\n/** True only for the route-locales convention under the canonical web root. */\nexport function isRouteLocalesJsonPath(path: string): boolean {\n  const normalized = Path.normalize(path);\n  const relativePath = normalized.startsWith(\"src/\") ? normalized : Path.toRelative(normalized);\n  return /^src\\/web(?:\\/.*)?\\/locales\\.json$/.test(relativePath);\n}\n\n/**\n * Typings manifest structure for tracking file hashes\n */\ntype TypingsManifest = {\n  version: string;\n  lastBuildTime: number;\n  storage: {\n    sourceHash: string;\n    drivers: string[];\n  } | null;\n  config: Record<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >;\n};\n\n/**\n * TypeGenerator - Generates TypeScript type definitions from config files\n *\n * Parses source config files using the TypeScript Compiler API to extract\n * keys and generate module augmentation types for IDE autocomplete.\n *\n * Uses manifest-based reconciliation to only regenerate when source files change.\n */\nexport class TypeGenerator {\n  /**\n   * Output directory for generated typings\n   */\n  private outputDir = warlockPath(\"typings\");\n\n  /**\n   * Path to typings manifest file\n   */\n  private manifestPath = join(this.outputDir, \"typings-manifest.json\");\n\n  /**\n   * Cached manifest data\n   */\n  private manifest: TypingsManifest | null = null;\n\n  /**\n   * Cache for config type info and keys\n   */\n  private configCache = new Map<\n    string,\n    {\n      sourceHash: string;\n      typeName: string | null;\n      importSource: string | null;\n      keys: string[];\n    }\n  >();\n\n  /**\n   * Generate all framework type definitions\n   *\n   * Uses manifest-based reconciliation:\n   * - If output files don't exist: full regeneration\n   * - If files exist: only regenerate changed configs\n   */\n  public async generateAll(): Promise<void> {\n    await this.ensureOutputDir();\n\n    const storageFile = join(this.outputDir, \"storage.d.ts\");\n    const configFile = join(this.outputDir, \"config.d.ts\");\n    const translationsFile = join(this.outputDir, \"translations.d.ts\");\n\n    const [manifestExists, storageExists, configExists, translationsExist] = await Promise.all([\n      this.exists(this.manifestPath),\n      this.exists(storageFile),\n      this.exists(configFile),\n      this.exists(translationsFile),\n    ]);\n\n    if (!manifestExists || !storageExists || !configExists || !translationsExist) {\n      // Full regeneration (first run or files deleted)\n      await this.fullGeneration();\n    } else {\n      // Load manifest for hash comparison\n      await this.loadManifest();\n      // Reconciliation: only regenerate changed files\n      await this.reconcile();\n    }\n\n    await this.generateTranslationTypes();\n    await this.generateModelResourceTypes();\n\n    await this.saveManifest();\n  }\n\n  /**\n   * Full regeneration of all type files\n   */\n  private async fullGeneration(): Promise<void> {\n    // Generate storage types\n    const storageConfigPath = await this.findConfigFile(\"storage\");\n    if (storageConfigPath) {\n      this.generateStorageTypes(storageConfigPath);\n    }\n\n    // Generate config types\n    await this.generateConfigTypes();\n  }\n\n  /**\n   * Reconcile: only regenerate changed files\n   */\n  private async reconcile(): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n    let storageChanged = false;\n    let configChanged = false;\n    let unchangedCount = 0;\n\n    this.configCache.clear();\n\n    // Check storage config\n    for (const [path, fileManager] of files) {\n      if (path.startsWith(\"src/config/storage\")) {\n        const manifestEntry = this.manifest?.storage;\n        if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n          storageChanged = true;\n          await this.generateStorageTypes(path);\n        }\n        break;\n      }\n    }\n\n    // Check config files\n    for (const [path, fileManager] of files) {\n      if (!path.startsWith(\"src/config/\")) continue;\n      if (\n        path\n          .split(\"/\")\n          .pop()\n          ?.replace(/[.][^.]+$/, \"\") === \"index\"\n      )\n        continue;\n\n      // Extract config name (remove dir prefix and extension)\n      const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n      const manifestEntry = this.manifest?.config[configName];\n\n      if (!manifestEntry || manifestEntry.sourceHash !== fileManager.hash) {\n        // File changed or new - regenerate\n        configChanged = true;\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      } else {\n        // Unchanged - load from manifest\n        unchangedCount++;\n        this.configCache.set(configName, manifestEntry);\n      }\n    }\n\n    if (configChanged) {\n      await this.writeConfigTypesFromCache();\n    } else {\n      devLogInfo(`Config types unchanged (${unchangedCount} configs cached)`);\n    }\n  }\n\n  /**\n   * Generate storage driver name types\n   */\n  public async generateStorageTypes(configPath: string): Promise<void> {\n    try {\n      const driverKeys = await this.extractStorageDriverKeys(configPath);\n\n      if (driverKeys.length === 0) {\n        devServeLog(\"⚠️ No storage drivers found in config\");\n        return;\n      }\n\n      // Get file hash from filesOrchestrator\n      const fileManager = filesOrchestrator.getFiles().get(configPath);\n      const sourceHash = fileManager?.hash || \"\";\n\n      // Update manifest\n      if (!this.manifest) {\n        this.manifest = this.createEmptyManifest();\n      }\n      this.manifest.storage = {\n        sourceHash,\n        drivers: driverKeys,\n      };\n\n      const interfaceContent = driverKeys\n        .map((k) => `    ${this.toInterfaceKey(k)}: true;`)\n        .join(\"\\n\");\n\n      const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from: ${configPath}\n// Regenerates on dev-server start and when storage config changes\n\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface StorageDriverRegistry {\n${interfaceContent}\n  }\n}\n`;\n\n      const outputPath = join(this.outputDir, \"storage.d.ts\");\n      await writeFile(outputPath, content, \"utf-8\");\n\n      devLogSuccess(`Generated storage types: ${driverKeys.join(\", \")}`);\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate storage types: ${error}`);\n    }\n  }\n\n  /**\n   * Check if a file change should trigger type regeneration\n   */\n  public shouldRegenerateTypes(changedPath: string): boolean {\n    return (\n      changedPath.includes(\"src/config/\") ||\n      changedPath.includes(\"config/\") ||\n      this.isLocalesFile(changedPath) ||\n      isRouteLocalesJsonPath(changedPath)\n    );\n  }\n\n  /**\n   * Handle file change - uses incremental update via cache\n   */\n  public async handleFileChange(changedPath: string): Promise<void> {\n    if (!this.shouldRegenerateTypes(changedPath)) {\n      return;\n    }\n\n    // Regenerate storage types if storage config changed\n    if (changedPath.includes(\"config/storage\")) {\n      await this.generateStorageTypes(changedPath);\n      await this.saveManifest();\n      return;\n    }\n\n    if (this.isLocalesFile(changedPath) || isRouteLocalesJsonPath(changedPath)) {\n      await this.generateTranslationTypes();\n      return;\n    }\n\n    // Extract config name from path\n    const match = changedPath.match(/config\\/([^/]+)\\.[^.]+$/);\n    if (!match) {\n      return;\n    }\n\n    const configName = match[1];\n    if (!configName || configName === \"index\") return;\n\n    devLogInfo(`Config changed: ${configName}, updating...`);\n\n    // Get file manager for hash\n    const fileManager = filesOrchestrator.getFiles().get(changedPath);\n    const sourceHash = fileManager?.hash || Date.now().toString();\n\n    // Update only the changed config in cache (use optimized combined extraction)\n    const configDir = join(process.cwd(), \"src/config\");\n    const configPath = join(configDir, `${configName}.ts`);\n\n    const info = await this.extractConfigInfo(configPath, configName);\n\n    this.configCache.set(configName, {\n      sourceHash,\n      typeName: info.typeName,\n      importSource: info.importSource,\n      keys: info.keys,\n    });\n\n    // Regenerate config.d.ts from cache\n    await this.writeConfigTypesFromCache();\n    await this.saveManifest();\n  }\n\n  /**\n   * Generate config types - populates cache and writes file\n   */\n  public async generateConfigTypes(): Promise<void> {\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      // Clear and repopulate cache\n      this.configCache.clear();\n\n      for (const [path, fileManager] of files) {\n        if (!path.startsWith(\"src/config/\")) continue;\n        if (\n          path\n            .split(\"/\")\n            .pop()\n            ?.replace(/[.][^.]+$/, \"\") === \"index\"\n        )\n          continue;\n\n        // Extract config name\n        const configName = path.replace(\"src/config/\", \"\").replace(/\\.[^.]+$/, \"\");\n\n        // One parse per config, both extractions off it — see `read-config-ast.ts`.\n        const info = await this.extractConfigInfo(fileManager.absolutePath, configName);\n\n        this.configCache.set(configName, {\n          sourceHash: fileManager.hash,\n          typeName: info.typeName,\n          importSource: info.importSource,\n          keys: info.keys,\n        });\n      }\n\n      await this.writeConfigTypesFromCache();\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate config types: ${error}`);\n    }\n  }\n\n  /**\n   * Files (relative paths) that contributed to the last generated registry —\n   * used to notice a registering file being deleted, since by the time a\n   * delete event reaches {@link executeTypingsGenerator} the file is already\n   * gone from `filesOrchestrator`'s map and its content can no longer be\n   * inspected.\n   */\n  private translationSourceFiles = new Set<string>();\n\n  /**\n   * Generate web's app-augmented translation-key registry.\n   *\n   * Scans every discovered app source file — not only dedicated\n   * `utils/locales.*` files — for `groupedTranslations` calls, both the\n   * named-group and object forms, at any nesting depth. Dynamic group names,\n   * dictionaries, or keys cannot be resolved statically and are skipped; an\n   * app relying on those must document them itself.\n   */\n  private async generateTranslationTypes(): Promise<void> {\n    const keys = new Set<string>();\n    const sourceFiles = new Set<string>();\n\n    for (const [path, fileManager] of filesOrchestrator.getFiles()) {\n      if (!isTranslationRegisteringSource(path, fileManager.source)) {\n        continue;\n      }\n\n      sourceFiles.add(path);\n\n      if (isModuleLocaleDictionaryPath(path)) {\n        const dictionary = parseLocaleDictionary({\n          sourceFile: path,\n          source: fileManager.source,\n          defaultNamespace: path.split(\"/\")[2]!,\n        });\n        for (const key of Object.keys(dictionary.entries)) {\n          keys.add(key);\n        }\n        continue;\n      }\n\n      const sourceFile = await readConfigAst(fileManager.absolutePath);\n      if (sourceFile) {\n        for (const key of extractTranslationKeys(sourceFile)) {\n          keys.add(key);\n        }\n      }\n    }\n\n    // The dev source map intentionally tracks executable TypeScript only. Module\n    // dictionaries are JSON data, so discover them directly without loading app\n    // code; use the runtime parser to keep `$group` and flattening identical.\n    for (const absolutePath of await getFilesFromDirectory(\n      join(process.cwd(), \"src\", \"app\"),\n      \"**/utils/locales.json\",\n    )) {\n      const path = Path.toRelative(absolutePath);\n      sourceFiles.add(path);\n      const dictionary = parseLocaleDictionary({\n        sourceFile: path,\n        source: await readFile(absolutePath, \"utf-8\"),\n        defaultNamespace: path.split(\"/\")[2]!,\n      });\n      for (const key of Object.keys(dictionary.entries)) {\n        keys.add(key);\n      }\n    }\n\n    for (const key of await listRouteLocaleKeysForTypeGeneration()) {\n      keys.add(key);\n    }\n\n    this.translationSourceFiles = sourceFiles;\n\n    const entries = Array.from(keys)\n      .sort()\n      .map((key) => `    ${JSON.stringify(key)}: true;`)\n      .join(\"\\n\");\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Generated from groupedTranslations calls and route-locales JSON in discovered\n// app source. Dynamic group names/keys cannot be resolved statically and are\n// not included here — document those yourself.\n\nimport \"@warlock.js/web\";\n\ndeclare module \"@warlock.js/web\" {\n  interface TranslationKeyRegistry {\n${entries}\n  }\n}\n`;\n\n    await writeFile(join(this.outputDir, \"translations.d.ts\"), content, \"utf-8\");\n    devLogSuccess(`Generated translation types: ${keys.size} keys`);\n  }\n\n  /**\n   * Files that contributed to the last `model-resources.d.ts`: the model files\n   * and the modules their resources were resolved to. Kept for the same reason\n   * as {@link translationSourceFiles}: a deleted file is already gone from the\n   * orchestrator when the batch reaches {@link executeTypingsGenerator}.\n   */\n  private modelResourceSourceFiles = new Set<string>();\n\n  /**\n   * Generate `model-resources.d.ts`: the `ModelResourceRegistry` augmentation\n   * behind `Serialized<Model>`.\n   *\n   * Reads every discovered model file (`*.model.ts`) and records the ones that\n   * declare `static resource = <Identifier>`. Static AST read only, no app\n   * module is imported; see `model-resource-typings.ts` for what is skipped.\n   * The file is rewritten only when its text changes.\n   */\n  private async generateModelResourceTypes(): Promise<void> {\n    try {\n      const entries: ModelResourceEntry[] = [];\n      const sourceFiles = new Set<string>();\n      const skippedModels: string[] = [];\n\n      for (const [path, fileManager] of filesOrchestrator.getFiles()) {\n        if (fileManager.type !== \"model\" || !fileManager.source.includes(\"resource\")) continue;\n\n        const imports = await parseImports(fileManager.source, fileManager.absolutePath);\n        const extraction = extractModelResourceEntries({\n          source: fileManager.source,\n          absolutePath: fileManager.absolutePath,\n          resolveImport: (specifier) => imports.get(specifier)?.absolutePath,\n        });\n\n        if (extraction.entries.length > 0) sourceFiles.add(path);\n\n        for (const entry of extraction.entries) {\n          entries.push(entry);\n          sourceFiles.add(Path.toRelative(entry.resourceFile));\n        }\n\n        for (const skipped of extraction.skipped) {\n          skippedModels.push(`${skipped.className} (${skipped.reason})`);\n        }\n      }\n\n      this.modelResourceSourceFiles = sourceFiles;\n\n      const written = await writeFileIfChanged(\n        join(this.outputDir, \"model-resources.d.ts\"),\n        renderModelResourceRegistry(entries, this.outputDir),\n      );\n\n      if (written) devLogSuccess(`Generated model resource types: ${entries.length} models`);\n\n      if (skippedModels.length > 0) {\n        devLogDim(\n          `Model resources not typed (not statically resolvable): ${skippedModels.join(\", \")}`,\n        );\n      }\n    } catch (error) {\n      devServeLog(`⚠️ Failed to generate model resource types: ${error}`);\n    }\n  }\n\n  private isLocalesFile(path: string): boolean {\n    return Path.normalize(path).includes(\"/utils/locales.\");\n  }\n\n  /**\n   * Quote an interface key that isn't a valid JS identifier (e.g. a config\n   * named `use-cases` or a storage driver `do-spaces`) so the generated\n   * `.d.ts` stays syntactically valid. Identifier-safe names are left bare\n   * to keep the output clean.\n   */\n  private toInterfaceKey(name: string): string {\n    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : JSON.stringify(name);\n  }\n\n  /**\n   * Write config.d.ts from cached data\n   */\n  private async writeConfigTypesFromCache(): Promise<void> {\n    const configTypeInfos: Array<{\n      name: string;\n      typeName: string | null;\n      importSource: string | null;\n    }> = [];\n    const allKeys: string[] = [];\n\n    // Update manifest config section\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.config = {};\n\n    for (const [name, data] of this.configCache) {\n      configTypeInfos.push({\n        name,\n        typeName: data.typeName,\n        importSource: data.importSource,\n      });\n      allKeys.push(...data.keys);\n\n      // Store in manifest\n      this.manifest.config[name] = data;\n    }\n\n    // Group imports by source\n    const imports = new Map<string, Set<string>>();\n    for (const info of configTypeInfos) {\n      if (info.typeName && info.importSource) {\n        if (!imports.has(info.importSource)) {\n          imports.set(info.importSource, new Set());\n        }\n        imports.get(info.importSource)!.add(info.typeName);\n      }\n    }\n\n    const importStatements = Array.from(imports.entries())\n      .map(([source, types]) => `import type { ${Array.from(types).join(\", \")} } from \"${source}\";`)\n      .join(\"\\n\");\n\n    const configEntries = configTypeInfos\n      .map((info) => `    ${this.toInterfaceKey(info.name)}: ${info.typeName || \"unknown\"};`)\n      .join(\"\\n\");\n\n    const keyEntries = allKeys.map((key) => `    \"${key}\": true;`).join(\"\\n\");\n\n    const content = `// Auto-generated by Warlock.js - DO NOT EDIT\n// Regenerates on dev-server start and when config files change\n\n${importStatements}\nimport \"@warlock.js/core\";\n\ndeclare module \"@warlock.js/core\" {\n  interface ConfigRegistry {\n${configEntries}\n  }\n\n  interface ConfigKeyRegistry {\n${keyEntries}\n  }\n}\n`;\n\n    const outputPath = join(this.outputDir, \"config.d.ts\");\n    await writeFile(outputPath, content, \"utf-8\");\n\n    devLogSuccess(\n      `Generated config types: ${this.configCache.size} configs, ${allKeys.length} keys`,\n    );\n  }\n\n  // ============================================================\n  // Manifest Management\n  // ============================================================\n\n  /**\n   * Load manifest from disk\n   */\n  private async loadManifest(): Promise<boolean> {\n    try {\n      if (await this.exists(this.manifestPath)) {\n        const content = await readFile(this.manifestPath, \"utf-8\");\n        this.manifest = JSON.parse(content);\n        return true;\n      }\n    } catch {\n      // Manifest corrupted or missing\n    }\n    this.manifest = null;\n    return false;\n  }\n\n  /**\n   * Save manifest to disk\n   */\n  private async saveManifest(): Promise<void> {\n    if (!this.manifest) {\n      this.manifest = this.createEmptyManifest();\n    }\n    this.manifest.lastBuildTime = Date.now();\n\n    await writeFile(this.manifestPath, JSON.stringify(this.manifest, null, 2), \"utf-8\");\n  }\n\n  /**\n   * Create empty manifest structure\n   */\n  private createEmptyManifest(): TypingsManifest {\n    return {\n      version: \"1.0.0\",\n      lastBuildTime: Date.now(),\n      storage: null,\n      config: {},\n    };\n  }\n\n  // ============================================================\n  // Type Extraction Methods\n  // ============================================================\n\n  /**\n   * Extract BOTH type info AND keys in a single pass\n   *\n   * One parse serves both extractions. It used to be one whole TypeScript\n   * Program per file — halved from two by an earlier pass, which optimised\n   * inside a premise that did not need to hold. `read-config-ast.ts` has the\n   * numbers.\n   *\n   * @param configPath Absolute path to the config file\n   * @param configName Config name (e.g., \"auth\", \"notifications\")\n   * @returns Combined result with type info and keys\n   */\n  private async extractConfigInfo(\n    configPath: string,\n    configName: string,\n  ): Promise<{\n    typeName: string | null;\n    importSource: string | null;\n    keys: string[];\n  }> {\n    if (!(await this.exists(configPath))) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // Parse, do not resolve — `read-config-ast.ts` explains why, with numbers.\n    const sourceFile = await readConfigAst(configPath);\n\n    if (!sourceFile) {\n      return { typeName: null, importSource: null, keys: [] };\n    }\n\n    // === Type Info Extraction ===\n    const importedTypes = new Map<string, string>();\n    const localExportedTypes = new Set<string>();\n    let foundTypeName: string | null = null;\n\n    // === Keys Extraction ===\n    const keys: string[] = [];\n\n    const visitForTypes = (node: ts.Node): void => {\n      // Collect imported types\n      if (ts.isImportDeclaration(node)) {\n        const moduleSpecifier = node.moduleSpecifier;\n        if (ts.isStringLiteral(moduleSpecifier)) {\n          const source = moduleSpecifier.text;\n          const importClause = node.importClause;\n          if (importClause?.namedBindings && ts.isNamedImports(importClause.namedBindings)) {\n            for (const element of importClause.namedBindings.elements) {\n              importedTypes.set(element.name.text, source);\n            }\n          }\n        }\n      }\n\n      // Collect locally exported types\n      if (ts.isTypeAliasDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Collect locally exported interfaces\n      if (ts.isInterfaceDeclaration(node)) {\n        const modifiers = ts.getModifiers(node);\n        if (modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {\n          localExportedTypes.add(node.name.text);\n        }\n      }\n\n      // Find type used on config variable + extract keys\n      if (ts.isVariableDeclaration(node)) {\n        // Type info\n        if (node.type && ts.isTypeReferenceNode(node.type)) {\n          foundTypeName = node.type.typeName.getText(sourceFile);\n        }\n\n        // Keys extraction\n        if (node.initializer && ts.isObjectLiteralExpression(node.initializer)) {\n          const visitKeys = (objNode: ts.ObjectLiteralExpression, prefix: string): void => {\n            for (const prop of objNode.properties) {\n              if (ts.isPropertyAssignment(prop) && prop.name) {\n                const keyName = prop.name.getText(sourceFile);\n                const fullKey = prefix ? `${prefix}.${keyName}` : keyName;\n                keys.push(fullKey);\n                if (ts.isObjectLiteralExpression(prop.initializer)) {\n                  visitKeys(prop.initializer, fullKey);\n                }\n              }\n            }\n          };\n          visitKeys(node.initializer, configName);\n        }\n      }\n\n      ts.forEachChild(node, visitForTypes);\n    };\n\n    ts.forEachChild(sourceFile, visitForTypes);\n\n    // Resolve type info\n    let typeName: string | null = null;\n    let importSource: string | null = null;\n\n    if (foundTypeName) {\n      if (importedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        importSource = importedTypes.get(foundTypeName)!;\n      } else if (localExportedTypes.has(foundTypeName)) {\n        typeName = foundTypeName;\n        const relativePath = Path.toRelative(configPath).replace(/\\.(ts|tsx)$/, \"\");\n        importSource = `../../${relativePath}`;\n      }\n    }\n\n    return { typeName, importSource, keys };\n  }\n\n  /**\n   * Extract driver keys from storage config\n   */\n  private async extractStorageDriverKeys(configPath: string): Promise<string[]> {\n    const absolutePath = resolve(configPath);\n\n    if (!(await this.exists(absolutePath))) {\n      devServeLog(`⚠️ Storage config not found: ${absolutePath}`);\n      return [];\n    }\n\n    const sourceFile = await readConfigAst(absolutePath);\n\n    if (!sourceFile) {\n      devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);\n      return [];\n    }\n\n    const keys: string[] = [];\n\n    const visit = (node: ts.Node): void => {\n      if (ts.isPropertyAssignment(node)) {\n        const propName = node.name.getText(sourceFile);\n\n        if (propName === \"drivers\" && ts.isObjectLiteralExpression(node.initializer)) {\n          for (const prop of node.initializer.properties) {\n            if (ts.isPropertyAssignment(prop) || ts.isShorthandPropertyAssignment(prop)) {\n              const keyName = prop.name?.getText(sourceFile);\n\n              if (keyName) {\n                keys.push(keyName);\n              }\n            }\n          }\n        }\n      }\n\n      ts.forEachChild(node, visit);\n    };\n\n    ts.forEachChild(sourceFile, visit);\n\n    return keys;\n  }\n\n  /**\n   * Find a config file by name\n   */\n  private async findConfigFile(configName: string): Promise<string | undefined> {\n    const possiblePaths = [`src/config/${configName}.ts`, `config/${configName}.ts`];\n\n    for (const path of possiblePaths) {\n      const fullPath = join(process.cwd(), path);\n\n      if (await this.exists(fullPath)) {\n        return path;\n      }\n    }\n\n    try {\n      const files = filesOrchestrator.getFiles();\n\n      for (const [filePath] of files) {\n        if (filePath.includes(`config/${configName}`)) {\n          return filePath;\n        }\n      }\n    } catch {\n      // Files orchestrator not initialized yet\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Ensure output directory exists\n   */\n  private async ensureOutputDir(): Promise<void> {\n    await ensureDirectoryAsync(this.outputDir);\n  }\n\n  /**\n   * Check if a path exists (async wrapper)\n   */\n  private async exists(path: string): Promise<boolean> {\n    try {\n      await access(path, constants.F_OK);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * The ports `runTypingsGeneration` needs, bound to this instance and this\n   * package's dev logger.\n   */\n  private get typingsGenerationPorts(): TypingsGenerationPorts {\n    return {\n      generate: () => this.generateAll(),\n      info: (message) => devLogInfo(message),\n      success: (message) => devLogSuccess(message),\n      error: (message) => devLogError(message),\n    };\n  }\n\n  /**\n   * Generate every config's typings.\n   *\n   * Runs IN THIS PROCESS. It used to spawn `npx warlock generate.typings`,\n   * which could not resolve in a source checkout — see\n   * `run-typings-generation.ts` for the whole story.\n   */\n  public async executeGenerateAllCommand(): Promise<void> {\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n\n  /**\n   * Regenerate typings after a batch reload — but only when the batch\n   * plausibly touched something the typings depend on: a config file, a file\n   * that registers translation keys, or a registering file that was deleted.\n   *\n   * A deleted file is already gone from `filesOrchestrator` by the time this\n   * runs (deletes are processed before `dev-server:batch-complete` fires), so\n   * its content can't be re-checked here — `translationSourceFiles` is the\n   * set from the last generation, kept for exactly this comparison.\n   */\n  public async executeTypingsGenerator(upcomingFiles: string[]): Promise<void> {\n    const files = filesOrchestrator.getFiles();\n\n    const aKnownTranslationSourceVanished = Array.from(this.translationSourceFiles).some(\n      (path) => !files.has(path),\n    );\n\n    const aKnownModelResourceSourceVanished = Array.from(this.modelResourceSourceFiles).some(\n      (path) => !files.has(path),\n    );\n\n    const touchedAConfig =\n      aKnownTranslationSourceVanished ||\n      aKnownModelResourceSourceVanished ||\n      Array.from(new Set(upcomingFiles)).some((file) => {\n        const normalizedPath = Path.normalize(file);\n        if (normalizedPath.includes(\"src/config/\")) return true;\n        if (isRouteLocalesJsonPath(normalizedPath)) return true;\n        if (isModuleLocaleDictionaryPath(normalizedPath)) return true;\n        if (this.translationSourceFiles.has(normalizedPath)) return true;\n        if (this.modelResourceSourceFiles.has(normalizedPath)) return true;\n        if (files.get(normalizedPath)?.type === \"model\") return true;\n\n        const fileManager = files.get(normalizedPath);\n        return (\n          fileManager !== undefined &&\n          isTranslationRegisteringSource(normalizedPath, fileManager.source)\n        );\n      });\n\n    if (!touchedAConfig) return;\n\n    /*\n      The changed paths are deliberately NOT passed along. The previous version\n      built a `files` array here and then threw it away, spawning the same\n      whole-project command as the branch above — so \"incremental\" was a name,\n      not a behaviour. `generateAll()` reads the orchestrator, which the batch\n      reload has already updated, so the full pass is both correct and the only\n      pass that ever actually ran.\n    */\n    await runTypingsGeneration(this.typingsGenerationPorts);\n  }\n}\n\n/**\n * Singleton instance for use throughout dev-server\n */\nexport const typeGenerator = new TypeGenerator();\n"],"mappings":"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"}

package/esm/http/index.d.mts

@@ -42,4 +42,5 @@ import { HttpServerRebuiltListener, notifyHttpServerRebuilt, onHttpServerRebuilt
 import { deriveTraceId, parseTraceparentTraceId } from "./tracing/trace-id.mjs";
 import { TracingContextSource, buildTracingContext, dispatchPhase, dispatchRequestEnd, dispatchRequestStart, isTracingEnabled, registerTracingHooks, resetTracingConfigForTests, resolveTracingConfig } from "./tracing/tracing-dispatcher.mjs";
 import { RequestContextStore, requestContext, useCurrentUser, useRequest, useRequestStore } from "./context/request-context.mjs";
-import { requestMemo } from "./context/request-memo.mjs";
+import { requestMemo } from "./context/request-memo.mjs";
+import { ModelResourceRegistry, Serialized, SerializedWire } from "./serialized.mjs";

package/esm/http/request.d.mts

@@ -385,14 +385,14 @@ declare class Request<RequestValidation = any> {
    * @internal Framework orchestration — do not call from app code. Wired
    * from the Fastify route handler in `router.scan()`.
    */
-  execute(): Promise<any[] | Record<string, any> | Response>;
+  execute(): Promise<any[] | Response | Record<string, any>>;
   /**
    * Iterate the collected middlewares in order; return the first short-circuit
    * value or `undefined` when every middleware passes through.
    *
    * @internal Framework orchestration — do not call from app code.
    */
-  protected executeMiddleware(): Promise<any[] | Record<string, any> | Response | undefined>;
+  protected executeMiddleware(): Promise<any[] | Response | Record<string, any> | undefined>;
   /**
    * Gather the middleware list for the current route — today just the
    * route-level array; future extraction may merge group + app-wide layers.