@pajecawav/json2code 0.0.0-stage → 0.1.0

package/dist/core/walker/json-schema.mjs

@@ -0,0 +1,311 @@
+import { DiagnosticCode, createDiagnostic } from "../../diagnostics/errors.mjs";
+import { visitRefs } from "../ir/visit.mjs";
+import { resolveRef } from "./ref-resolver.mjs";
+//#region src/core/walker/json-schema.ts
+var JsonSchemaWalker = class {
+	name = "json-schema";
+	async walk(files, ctx) {
+		const docIdSet = new Set(files.map((f) => f.docId));
+		const diagnostics = ctx.diagnostics;
+		const parsedFiles = [];
+		for (const file of files) {
+			let schema;
+			try {
+				schema = JSON.parse(file.content);
+			} catch (e) {
+				diagnostics.push(createDiagnostic(DiagnosticCode.InvalidJson, "error", `Invalid JSON: ${e.message}`, { docId: file.docId }));
+				continue;
+			}
+			const defNames = /* @__PURE__ */ new Set();
+			if (isSchema(schema)) for (const key of ["$defs", "definitions"]) {
+				const defs = schema[key];
+				if (defs) for (const name of Object.keys(defs)) defNames.add(name);
+			}
+			parsedFiles.push({
+				file,
+				schema,
+				defNames
+			});
+		}
+		const rootNames = /* @__PURE__ */ new Map();
+		for (const pf of parsedFiles) {
+			const base = rootExportNameFor(pf.file.docId);
+			let finalName = base;
+			if (pf.defNames.has(base)) {
+				do
+					finalName = `${finalName}Root`;
+				while (pf.defNames.has(finalName));
+				diagnostics.push(createDiagnostic(DiagnosticCode.NameCollision, "warning", `Root export "${base}" collides with a def; renamed to "${finalName}"`, { docId: pf.file.docId }));
+			}
+			rootNames.set(pf.file.docId, finalName);
+		}
+		const rootExportNameOf = (docId) => rootNames.get(docId) ?? "Schema";
+		const docs = [];
+		for (const pf of parsedFiles) {
+			const wctx = {
+				docId: pf.file.docId,
+				docIdSet,
+				rootExportNameOf,
+				diagnostics,
+				logger: ctx.logger
+			};
+			const exports = /* @__PURE__ */ new Map();
+			const exportOrder = [];
+			if (isSchema(pf.schema)) for (const key of ["$defs", "definitions"]) {
+				const defs = pf.schema[key];
+				if (defs) for (const [name, def] of Object.entries(defs)) {
+					if (exports.has(name)) {
+						diagnostics.push(createDiagnostic(DiagnosticCode.NameCollision, "warning", `Duplicate def name "${name}"`, { docId: pf.file.docId }));
+						continue;
+					}
+					exports.set(name, toIR(def, wctx));
+					exportOrder.push(name);
+				}
+			}
+			const rootName = rootNames.get(pf.file.docId) ?? "Schema";
+			exports.set(rootName, toIR(pf.schema, wctx));
+			exportOrder.push(rootName);
+			docs.push({
+				docId: pf.file.docId,
+				sourcePath: pf.file.path,
+				exports,
+				exportOrder,
+				rootExportName: rootName
+			});
+		}
+		validateRefs(docs, docIdSet, diagnostics);
+		return docs;
+	}
+};
+function warn(ctx, message) {
+	ctx.diagnostics.push(createDiagnostic(DiagnosticCode.UnknownKeyword, "warning", message, { docId: ctx.docId }));
+}
+function err(ctx, code, message, ref) {
+	ctx.diagnostics.push(createDiagnostic(code, "error", message, {
+		docId: ctx.docId,
+		ref
+	}));
+}
+function isSchema(v) {
+	return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function num(v) {
+	return typeof v === "number" ? v : void 0;
+}
+function rootExportNameFor(docId) {
+	const slash = docId.lastIndexOf("/");
+	const base = slash >= 0 ? docId.slice(slash + 1) : docId;
+	const dot = base.lastIndexOf(".");
+	return pascalCase(dot > 0 ? base.slice(0, dot) : base) || "Schema";
+}
+function pascalCase(s) {
+	return s.split(/[-_.\s/]+/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("");
+}
+function extractMeta(s) {
+	const meta = {};
+	if (typeof s.title === "string") meta.title = s.title;
+	if (typeof s.description === "string") meta.description = s.description;
+	if (s.deprecated === true) meta.deprecated = true;
+	if ("default" in s) meta.default = s.default;
+	return Object.keys(meta).length === 0 ? void 0 : meta;
+}
+function toIR(schema, ctx) {
+	if (typeof schema === "boolean") {
+		if (!schema) warn(ctx, "`schema: false` (never) is represented as unknown");
+		return { kind: "unknown" };
+	}
+	if (!isSchema(schema)) {
+		warn(ctx, "non-object schema is represented as unknown");
+		return { kind: "unknown" };
+	}
+	const meta = extractMeta(schema);
+	if (typeof schema.$ref === "string") {
+		const res = resolveRef(schema.$ref, ctx.docId, ctx.docIdSet, ctx.rootExportNameOf);
+		if (res.ok) return {
+			kind: "ref",
+			ref: res.ref,
+			meta
+		};
+		err(ctx, res.code, res.message, schema.$ref);
+		return {
+			kind: "unknown",
+			meta
+		};
+	}
+	if ("const" in schema) {
+		const v = schema.const;
+		if (v === null || typeof v === "string" || typeof v === "number" || typeof v === "boolean") return {
+			kind: "literal",
+			value: v,
+			meta
+		};
+		warn(ctx, "non-primitive const is represented as unknown");
+		return {
+			kind: "unknown",
+			meta
+		};
+	}
+	if (schema.anyOf) return {
+		kind: "union",
+		variants: schema.anyOf.map((x) => toIR(x, ctx)),
+		meta
+	};
+	if (schema.oneOf) return {
+		kind: "union",
+		variants: schema.oneOf.map((x) => toIR(x, ctx)),
+		meta
+	};
+	if (schema.allOf) return {
+		kind: "intersection",
+		variants: schema.allOf.map((x) => toIR(x, ctx)),
+		meta
+	};
+	const t = schema.type;
+	if (typeof t === "string") return typeToIR(t, schema, meta, ctx);
+	if (Array.isArray(t)) return {
+		kind: "union",
+		variants: t.map((x) => typeToIR(x, schema, meta, ctx)),
+		meta
+	};
+	if (schema.enum) return enumToIR(schema.enum, meta, ctx);
+	if (schema.properties || Array.isArray(schema.required) || schema.additionalProperties !== void 0) return objectToIR(schema, meta, ctx);
+	if (schema.items !== void 0 || Array.isArray(schema.prefixItems)) return arrayToIR(schema, meta, ctx);
+	warn(ctx, "schema without type/const/enum/$ref/combinators is represented as unknown");
+	return {
+		kind: "unknown",
+		meta
+	};
+}
+function typeToIR(typeStr, s, meta, ctx) {
+	switch (typeStr) {
+		case "string": {
+			const enumArr = Array.isArray(s.enum) ? s.enum.filter((v) => typeof v === "string") : void 0;
+			return {
+				kind: "string",
+				meta,
+				...enumArr ? { enum: enumArr } : {},
+				...typeof s.const === "string" ? { const: s.const } : {},
+				...typeof s.pattern === "string" ? { pattern: s.pattern } : {},
+				...typeof s.format === "string" ? { format: s.format } : {},
+				...num(s.minLength) !== void 0 ? { minLength: num(s.minLength) } : {},
+				...num(s.maxLength) !== void 0 ? { maxLength: num(s.maxLength) } : {}
+			};
+		}
+		case "integer":
+		case "number": return {
+			kind: typeStr,
+			meta,
+			...Array.isArray(s.enum) ? { enum: s.enum.filter((v) => typeof v === "number") } : {},
+			...typeof s.const === "number" ? { const: s.const } : {},
+			...num(s.minimum) !== void 0 ? { minimum: num(s.minimum) } : {},
+			...num(s.maximum) !== void 0 ? { maximum: num(s.maximum) } : {},
+			...typeof s.exclusiveMinimum === "number" ? { exclusiveMinimum: s.exclusiveMinimum } : {},
+			...typeof s.exclusiveMaximum === "number" ? { exclusiveMaximum: s.exclusiveMaximum } : {},
+			...num(s.multipleOf) !== void 0 ? { multipleOf: num(s.multipleOf) } : {}
+		};
+		case "boolean": return {
+			kind: "boolean",
+			meta,
+			...typeof s.const === "boolean" ? { const: s.const } : {}
+		};
+		case "null": return {
+			kind: "null",
+			meta
+		};
+		case "array": return arrayToIR(s, meta, ctx);
+		case "object": return objectToIR(s, meta, ctx);
+		default:
+			warn(ctx, `unsupported type "${typeStr}" is represented as unknown`);
+			return {
+				kind: "unknown",
+				meta
+			};
+	}
+}
+function enumToIR(values, meta, ctx) {
+	const variants = [];
+	for (const v of values) if (v === null) variants.push({ kind: "null" });
+	else if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") variants.push({
+		kind: "literal",
+		value: v
+	});
+	else {
+		warn(ctx, "non-primitive enum value is represented as unknown");
+		variants.push({ kind: "unknown" });
+	}
+	if (variants.length === 1) {
+		const single = variants[0];
+		if (single) return single;
+	}
+	return {
+		kind: "union",
+		variants,
+		meta
+	};
+}
+function arrayToIR(s, meta, ctx) {
+	if (Array.isArray(s.prefixItems)) return {
+		kind: "tuple",
+		items: s.prefixItems.map((x) => toIR(x, ctx)),
+		additionalItems: isSchema(s.items) ? toIR(s.items, ctx) : void 0,
+		meta
+	};
+	if (Array.isArray(s.items)) return {
+		kind: "tuple",
+		items: s.items.map((x) => toIR(x, ctx)),
+		additionalItems: isSchema(s.additionalItems) ? toIR(s.additionalItems, ctx) : void 0,
+		meta
+	};
+	return {
+		kind: "array",
+		meta,
+		items: isSchema(s.items) ? toIR(s.items, ctx) : void 0,
+		...num(s.minItems) !== void 0 ? { minItems: num(s.minItems) } : {},
+		...num(s.maxItems) !== void 0 ? { maxItems: num(s.maxItems) } : {},
+		...s.uniqueItems === true ? { uniqueItems: true } : {}
+	};
+}
+function objectToIR(s, meta, ctx) {
+	const properties = /* @__PURE__ */ new Map();
+	const requiredList = Array.isArray(s.required) ? [...s.required] : [];
+	const props = s.properties;
+	if (props) for (const [key, sub] of Object.entries(props)) {
+		if (sub.required === true && !requiredList.includes(key)) requiredList.push(key);
+		properties.set(key, toIR(sub, ctx));
+	}
+	let additionalProperties;
+	if (s.additionalProperties === false) additionalProperties = false;
+	else if (isSchema(s.additionalProperties)) additionalProperties = toIR(s.additionalProperties, ctx);
+	if (properties.size === 0 && additionalProperties) return {
+		kind: "record",
+		values: additionalProperties,
+		meta
+	};
+	return {
+		kind: "object",
+		properties,
+		required: requiredList.filter((k) => properties.has(k)),
+		additionalProperties,
+		meta
+	};
+}
+/** Second pass: every {@link Ref} must point to an existing document export. */
+function validateRefs(docs, docIdSet, diagnostics) {
+	const exportsByDoc = /* @__PURE__ */ new Map();
+	for (const d of docs) exportsByDoc.set(d.docId, new Set(d.exports.keys()));
+	for (const doc of docs) for (const [, ir] of doc.exports) visitRefs(ir, (ref) => {
+		const refStr = `${ref.docId}#${ref.exportName}`;
+		if (!docIdSet.has(ref.docId)) diagnostics.push(createDiagnostic(DiagnosticCode.InvalidRef, "error", `Ref target document not found: ${refStr}`, {
+			docId: doc.docId,
+			ref: refStr
+		}));
+		else if (!exportsByDoc.get(ref.docId)?.has(ref.exportName)) diagnostics.push(createDiagnostic(DiagnosticCode.InvalidRef, "error", `Ref target export not found: ${refStr}`, {
+			docId: doc.docId,
+			ref: refStr
+		}));
+	});
+}
+//#endregion
+export { JsonSchemaWalker };
+
+//# sourceMappingURL=json-schema.mjs.map

package/dist/core/walker/json-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.mjs","names":[],"sources":["../../../src/core/walker/json-schema.ts"],"sourcesContent":["import { createDiagnostic, DiagnosticCode, type Diagnostic } from \"../../diagnostics/errors.js\";\nimport type { Logger } from \"../../diagnostics/logger.js\";\nimport type { IRMeta, IRType, SourceDoc } from \"../ir/types.js\";\nimport { visitRefs } from \"../ir/visit.js\";\nimport type { SchemaFile } from \"../types.js\";\nimport type { AbstractWalker, WalkerContext } from \"./abstract.js\";\nimport { resolveRef } from \"./ref-resolver.js\";\n\n/** Loose shape of a JSON Schema node (we only model what we consume; extras flow through the index signature). */\ninterface JsonSchema {\n\t$ref?: string;\n\t$defs?: Record<string, JsonSchema>;\n\tdefinitions?: Record<string, JsonSchema>;\n\ttype?: string | readonly string[];\n\tenum?: readonly unknown[];\n\tconst?: unknown;\n\ttitle?: string;\n\tdescription?: string;\n\tdeprecated?: boolean;\n\tdefault?: unknown;\n\tpattern?: string;\n\tformat?: string;\n\tminLength?: number;\n\tmaxLength?: number;\n\tminimum?: number;\n\tmaximum?: number;\n\texclusiveMinimum?: number | boolean;\n\texclusiveMaximum?: number | boolean;\n\tmultipleOf?: number;\n\titems?: JsonSchema | readonly JsonSchema[];\n\tprefixItems?: readonly JsonSchema[];\n\tadditionalItems?: JsonSchema | boolean;\n\tminItems?: number;\n\tmaxItems?: number;\n\tuniqueItems?: boolean;\n\tproperties?: Record<string, JsonSchema>;\n\t/** Standard dialect: string[] on the object; some dialects use boolean on property schemas. */\n\trequired?: readonly string[] | boolean;\n\tadditionalProperties?: JsonSchema | boolean;\n\tanyOf?: readonly JsonSchema[];\n\toneOf?: readonly JsonSchema[];\n\tallOf?: readonly JsonSchema[];\n\t[key: string]: unknown;\n}\n\nexport class JsonSchemaWalker implements AbstractWalker {\n\tpublic readonly name = \"json-schema\";\n\n\tpublic async walk(files: readonly SchemaFile[], ctx: WalkerContext): Promise<SourceDoc[]> {\n\t\tconst docIdSet = new Set(files.map(f => f.docId));\n\t\tconst diagnostics = ctx.diagnostics;\n\n\t\t// pass 0: parse every file and precompute final root export names,\n\t\t// so refs to a document root resolve to the real (possibly renamed) export\n\t\tconst parsedFiles: ParsedFile[] = [];\n\t\tfor (const file of files) {\n\t\t\tlet schema: unknown;\n\t\t\ttry {\n\t\t\t\tschema = JSON.parse(file.content);\n\t\t\t} catch (e) {\n\t\t\t\tdiagnostics.push(\n\t\t\t\t\tcreateDiagnostic(\n\t\t\t\t\t\tDiagnosticCode.InvalidJson,\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\t`Invalid JSON: ${(e as Error).message}`,\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tdocId: file.docId,\n\t\t\t\t\t\t},\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst defNames = new Set<string>();\n\t\t\tif (isSchema(schema)) {\n\t\t\t\tfor (const key of [\"$defs\", \"definitions\"] as const) {\n\t\t\t\t\tconst defs = schema[key];\n\t\t\t\t\tif (defs) {\n\t\t\t\t\t\tfor (const name of Object.keys(defs)) {\n\t\t\t\t\t\t\tdefNames.add(name);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tparsedFiles.push({ file, schema, defNames });\n\t\t}\n\n\t\tconst rootNames = new Map<string, string>();\n\t\tfor (const pf of parsedFiles) {\n\t\t\tconst base = rootExportNameFor(pf.file.docId);\n\t\t\tlet finalName = base;\n\t\t\tif (pf.defNames.has(base)) {\n\t\t\t\tdo {\n\t\t\t\t\tfinalName = `${finalName}Root`;\n\t\t\t\t} while (pf.defNames.has(finalName));\n\t\t\t\tdiagnostics.push(\n\t\t\t\t\tcreateDiagnostic(\n\t\t\t\t\t\tDiagnosticCode.NameCollision,\n\t\t\t\t\t\t\"warning\",\n\t\t\t\t\t\t`Root export \"${base}\" collides with a def; renamed to \"${finalName}\"`,\n\t\t\t\t\t\t{ docId: pf.file.docId },\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t\trootNames.set(pf.file.docId, finalName);\n\t\t}\n\n\t\tconst rootExportNameOf = (docId: string): string => rootNames.get(docId) ?? \"Schema\";\n\n\t\t// pass 1: walk each document into IR\n\t\tconst docs: SourceDoc[] = [];\n\t\tfor (const pf of parsedFiles) {\n\t\t\tconst wctx: WalkCtx = {\n\t\t\t\tdocId: pf.file.docId,\n\t\t\t\tdocIdSet,\n\t\t\t\trootExportNameOf,\n\t\t\t\tdiagnostics,\n\t\t\t\tlogger: ctx.logger,\n\t\t\t};\n\t\t\tconst exports = new Map<string, IRType>();\n\t\t\tconst exportOrder: string[] = [];\n\n\t\t\tif (isSchema(pf.schema)) {\n\t\t\t\tfor (const key of [\"$defs\", \"definitions\"] as const) {\n\t\t\t\t\tconst defs = pf.schema[key];\n\t\t\t\t\tif (defs) {\n\t\t\t\t\t\tfor (const [name, def] of Object.entries(defs)) {\n\t\t\t\t\t\t\tif (exports.has(name)) {\n\t\t\t\t\t\t\t\tdiagnostics.push(\n\t\t\t\t\t\t\t\t\tcreateDiagnostic(\n\t\t\t\t\t\t\t\t\t\tDiagnosticCode.NameCollision,\n\t\t\t\t\t\t\t\t\t\t\"warning\",\n\t\t\t\t\t\t\t\t\t\t`Duplicate def name \"${name}\"`,\n\t\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\tdocId: pf.file.docId,\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\texports.set(name, toIR(def, wctx));\n\t\t\t\t\t\t\texportOrder.push(name);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst rootName = rootNames.get(pf.file.docId) ?? \"Schema\";\n\t\t\texports.set(rootName, toIR(pf.schema, wctx));\n\t\t\texportOrder.push(rootName);\n\n\t\t\tdocs.push({\n\t\t\t\tdocId: pf.file.docId,\n\t\t\t\tsourcePath: pf.file.path,\n\t\t\t\texports,\n\t\t\t\texportOrder,\n\t\t\t\trootExportName: rootName,\n\t\t\t});\n\t\t}\n\n\t\tvalidateRefs(docs, docIdSet, diagnostics);\n\t\treturn docs;\n\t}\n}\n\ninterface ParsedFile {\n\treadonly file: SchemaFile;\n\treadonly schema: unknown;\n\treadonly defNames: ReadonlySet<string>;\n}\n\ninterface WalkCtx {\n\treadonly docId: string;\n\treadonly docIdSet: ReadonlySet<string>;\n\treadonly rootExportNameOf: (docId: string) => string;\n\treadonly diagnostics: Diagnostic[];\n\treadonly logger: Logger;\n}\n\nfunction warn(ctx: WalkCtx, message: string): void {\n\tctx.diagnostics.push(\n\t\tcreateDiagnostic(DiagnosticCode.UnknownKeyword, \"warning\", message, { docId: ctx.docId }),\n\t);\n}\n\nfunction err(ctx: WalkCtx, code: DiagnosticCode, message: string, ref?: string): void {\n\tctx.diagnostics.push(createDiagnostic(code, \"error\", message, { docId: ctx.docId, ref }));\n}\n\nfunction isSchema(v: unknown): v is JsonSchema {\n\treturn typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\nfunction num(v: unknown): number | undefined {\n\treturn typeof v === \"number\" ? v : undefined;\n}\n\nfunction rootExportNameFor(docId: string): string {\n\tconst slash = docId.lastIndexOf(\"/\");\n\tconst base = slash >= 0 ? docId.slice(slash + 1) : docId;\n\tconst dot = base.lastIndexOf(\".\");\n\tconst stem = dot > 0 ? base.slice(0, dot) : base;\n\treturn pascalCase(stem) || \"Schema\";\n}\n\nfunction pascalCase(s: string): string {\n\treturn s\n\t\t.split(/[-_.\\s/]+/)\n\t\t.filter(Boolean)\n\t\t.map(w => w.charAt(0).toUpperCase() + w.slice(1))\n\t\t.join(\"\");\n}\n\nfunction extractMeta(s: JsonSchema): IRMeta | undefined {\n\tconst meta: { title?: string; description?: string; deprecated?: boolean; default?: unknown } =\n\t\t{};\n\tif (typeof s.title === \"string\") {\n\t\tmeta.title = s.title;\n\t}\n\tif (typeof s.description === \"string\") {\n\t\tmeta.description = s.description;\n\t}\n\tif (s.deprecated === true) {\n\t\tmeta.deprecated = true;\n\t}\n\tif (\"default\" in s) {\n\t\tmeta.default = s.default;\n\t}\n\treturn Object.keys(meta).length === 0 ? undefined : meta;\n}\n\nfunction toIR(schema: unknown, ctx: WalkCtx): IRType {\n\tif (typeof schema === \"boolean\") {\n\t\tif (!schema) {\n\t\t\twarn(ctx, \"`schema: false` (never) is represented as unknown\");\n\t\t}\n\t\treturn { kind: \"unknown\" };\n\t}\n\tif (!isSchema(schema)) {\n\t\twarn(ctx, \"non-object schema is represented as unknown\");\n\t\treturn { kind: \"unknown\" };\n\t}\n\n\tconst meta = extractMeta(schema);\n\n\tif (typeof schema.$ref === \"string\") {\n\t\tconst res = resolveRef(schema.$ref, ctx.docId, ctx.docIdSet, ctx.rootExportNameOf);\n\t\tif (res.ok) {\n\t\t\treturn { kind: \"ref\", ref: res.ref, meta };\n\t\t}\n\t\terr(ctx, res.code, res.message, schema.$ref);\n\t\treturn { kind: \"unknown\", meta };\n\t}\n\n\tif (\"const\" in schema) {\n\t\tconst v = schema.const;\n\t\tif (\n\t\t\tv === null ||\n\t\t\ttypeof v === \"string\" ||\n\t\t\ttypeof v === \"number\" ||\n\t\t\ttypeof v === \"boolean\"\n\t\t) {\n\t\t\treturn { kind: \"literal\", value: v, meta };\n\t\t}\n\t\twarn(ctx, \"non-primitive const is represented as unknown\");\n\t\treturn { kind: \"unknown\", meta };\n\t}\n\n\tif (schema.anyOf) {\n\t\treturn { kind: \"union\", variants: schema.anyOf.map(x => toIR(x, ctx)), meta };\n\t}\n\tif (schema.oneOf) {\n\t\treturn { kind: \"union\", variants: schema.oneOf.map(x => toIR(x, ctx)), meta };\n\t}\n\tif (schema.allOf) {\n\t\treturn { kind: \"intersection\", variants: schema.allOf.map(x => toIR(x, ctx)), meta };\n\t}\n\n\tconst t = schema.type;\n\tif (typeof t === \"string\") {\n\t\treturn typeToIR(t, schema, meta, ctx);\n\t}\n\tif (Array.isArray(t)) {\n\t\tconst variants = t.map(x => typeToIR(x, schema, meta, ctx));\n\t\treturn { kind: \"union\", variants, meta };\n\t}\n\n\tif (schema.enum) {\n\t\treturn enumToIR(schema.enum, meta, ctx);\n\t}\n\n\t// JSON Schema applicability: `properties`/`required`/`additionalProperties`\n\t// constrain only object instances — infer an object when `type` is omitted.\n\tif (\n\t\tschema.properties ||\n\t\tArray.isArray(schema.required) ||\n\t\tschema.additionalProperties !== undefined\n\t) {\n\t\treturn objectToIR(schema, meta, ctx);\n\t}\n\t// `items`/`prefixItems` constrain only arrays — infer an array likewise.\n\tif (schema.items !== undefined || Array.isArray(schema.prefixItems)) {\n\t\treturn arrayToIR(schema, meta, ctx);\n\t}\n\n\twarn(ctx, \"schema without type/const/enum/$ref/combinators is represented as unknown\");\n\treturn { kind: \"unknown\", meta };\n}\n\nfunction typeToIR(typeStr: string, s: JsonSchema, meta: IRMeta | undefined, ctx: WalkCtx): IRType {\n\tswitch (typeStr) {\n\t\tcase \"string\": {\n\t\t\tconst enumArr = Array.isArray(s.enum)\n\t\t\t\t? s.enum.filter((v): v is string => typeof v === \"string\")\n\t\t\t\t: undefined;\n\t\t\treturn {\n\t\t\t\tkind: \"string\",\n\t\t\t\tmeta,\n\t\t\t\t...(enumArr ? { enum: enumArr } : {}),\n\t\t\t\t...(typeof s.const === \"string\" ? { const: s.const } : {}),\n\t\t\t\t...(typeof s.pattern === \"string\" ? { pattern: s.pattern } : {}),\n\t\t\t\t...(typeof s.format === \"string\" ? { format: s.format } : {}),\n\t\t\t\t...(num(s.minLength) !== undefined ? { minLength: num(s.minLength) } : {}),\n\t\t\t\t...(num(s.maxLength) !== undefined ? { maxLength: num(s.maxLength) } : {}),\n\t\t\t};\n\t\t}\n\t\tcase \"integer\":\n\t\tcase \"number\": {\n\t\t\treturn {\n\t\t\t\tkind: typeStr,\n\t\t\t\tmeta,\n\t\t\t\t...(Array.isArray(s.enum)\n\t\t\t\t\t? { enum: s.enum.filter((v): v is number => typeof v === \"number\") }\n\t\t\t\t\t: {}),\n\t\t\t\t...(typeof s.const === \"number\" ? { const: s.const } : {}),\n\t\t\t\t...(num(s.minimum) !== undefined ? { minimum: num(s.minimum) } : {}),\n\t\t\t\t...(num(s.maximum) !== undefined ? { maximum: num(s.maximum) } : {}),\n\t\t\t\t...(typeof s.exclusiveMinimum === \"number\"\n\t\t\t\t\t? { exclusiveMinimum: s.exclusiveMinimum }\n\t\t\t\t\t: {}),\n\t\t\t\t...(typeof s.exclusiveMaximum === \"number\"\n\t\t\t\t\t? { exclusiveMaximum: s.exclusiveMaximum }\n\t\t\t\t\t: {}),\n\t\t\t\t...(num(s.multipleOf) !== undefined ? { multipleOf: num(s.multipleOf) } : {}),\n\t\t\t};\n\t\t}\n\t\tcase \"boolean\":\n\t\t\treturn {\n\t\t\t\tkind: \"boolean\",\n\t\t\t\tmeta,\n\t\t\t\t...(typeof s.const === \"boolean\" ? { const: s.const } : {}),\n\t\t\t};\n\t\tcase \"null\":\n\t\t\treturn { kind: \"null\", meta };\n\t\tcase \"array\":\n\t\t\treturn arrayToIR(s, meta, ctx);\n\t\tcase \"object\":\n\t\t\treturn objectToIR(s, meta, ctx);\n\t\tdefault:\n\t\t\twarn(ctx, `unsupported type \"${typeStr}\" is represented as unknown`);\n\t\t\treturn { kind: \"unknown\", meta };\n\t}\n}\n\nfunction enumToIR(values: readonly unknown[], meta: IRMeta | undefined, ctx: WalkCtx): IRType {\n\tconst variants: IRType[] = [];\n\tfor (const v of values) {\n\t\tif (v === null) {\n\t\t\tvariants.push({ kind: \"null\" });\n\t\t} else if (typeof v === \"string\" || typeof v === \"number\" || typeof v === \"boolean\") {\n\t\t\tvariants.push({ kind: \"literal\", value: v });\n\t\t} else {\n\t\t\twarn(ctx, \"non-primitive enum value is represented as unknown\");\n\t\t\tvariants.push({ kind: \"unknown\" });\n\t\t}\n\t}\n\tif (variants.length === 1) {\n\t\tconst single = variants[0];\n\t\tif (single) {\n\t\t\treturn single;\n\t\t}\n\t}\n\treturn { kind: \"union\", variants, meta };\n}\n\nfunction arrayToIR(s: JsonSchema, meta: IRMeta | undefined, ctx: WalkCtx): IRType {\n\tif (Array.isArray(s.prefixItems)) {\n\t\tconst items = s.prefixItems.map(x => toIR(x, ctx));\n\t\tconst additionalItems = isSchema(s.items) ? toIR(s.items, ctx) : undefined;\n\t\treturn { kind: \"tuple\", items, additionalItems, meta };\n\t}\n\tif (Array.isArray(s.items)) {\n\t\tconst items = s.items.map(x => toIR(x, ctx));\n\t\tconst additionalItems = isSchema(s.additionalItems)\n\t\t\t? toIR(s.additionalItems, ctx)\n\t\t\t: undefined;\n\t\treturn { kind: \"tuple\", items, additionalItems, meta };\n\t}\n\tconst itemsIR = isSchema(s.items) ? toIR(s.items, ctx) : undefined;\n\treturn {\n\t\tkind: \"array\",\n\t\tmeta,\n\t\titems: itemsIR,\n\t\t...(num(s.minItems) !== undefined ? { minItems: num(s.minItems) } : {}),\n\t\t...(num(s.maxItems) !== undefined ? { maxItems: num(s.maxItems) } : {}),\n\t\t...(s.uniqueItems === true ? { uniqueItems: true } : {}),\n\t};\n}\n\nfunction objectToIR(s: JsonSchema, meta: IRMeta | undefined, ctx: WalkCtx): IRType {\n\tconst properties = new Map<string, IRType>();\n\t// Standard JSON Schema: `required` is a string[] on the object; some dialects use `required: true` on property schemas.\n\tconst requiredList = Array.isArray(s.required) ? [...s.required] : [];\n\n\tconst props = s.properties;\n\tif (props) {\n\t\tfor (const [key, sub] of Object.entries(props)) {\n\t\t\tif (sub.required === true && !requiredList.includes(key)) {\n\t\t\t\trequiredList.push(key);\n\t\t\t}\n\t\t\tproperties.set(key, toIR(sub, ctx));\n\t\t}\n\t}\n\n\tlet additionalProperties: IRType | false | undefined;\n\tif (s.additionalProperties === false) {\n\t\tadditionalProperties = false;\n\t} else if (isSchema(s.additionalProperties)) {\n\t\tadditionalProperties = toIR(s.additionalProperties, ctx);\n\t}\n\n\tif (properties.size === 0 && additionalProperties) {\n\t\treturn { kind: \"record\", values: additionalProperties, meta };\n\t}\n\treturn {\n\t\tkind: \"object\",\n\t\tproperties,\n\t\trequired: requiredList.filter(k => properties.has(k)),\n\t\tadditionalProperties,\n\t\tmeta,\n\t};\n}\n\n/** Second pass: every {@link Ref} must point to an existing document export. */\nfunction validateRefs(\n\tdocs: readonly SourceDoc[],\n\tdocIdSet: ReadonlySet<string>,\n\tdiagnostics: Diagnostic[],\n): void {\n\tconst exportsByDoc = new Map<string, ReadonlySet<string>>();\n\tfor (const d of docs) {\n\t\texportsByDoc.set(d.docId, new Set(d.exports.keys()));\n\t}\n\n\tfor (const doc of docs) {\n\t\tfor (const [, ir] of doc.exports) {\n\t\t\tvisitRefs(ir, ref => {\n\t\t\t\tconst refStr = `${ref.docId}#${ref.exportName}`;\n\t\t\t\tif (!docIdSet.has(ref.docId)) {\n\t\t\t\t\tdiagnostics.push(\n\t\t\t\t\t\tcreateDiagnostic(\n\t\t\t\t\t\t\tDiagnosticCode.InvalidRef,\n\t\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\t\t`Ref target document not found: ${refStr}`,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tdocId: doc.docId,\n\t\t\t\t\t\t\t\tref: refStr,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\t} else {\n\t\t\t\t\tconst names = exportsByDoc.get(ref.docId);\n\t\t\t\t\tif (!names?.has(ref.exportName)) {\n\t\t\t\t\t\tdiagnostics.push(\n\t\t\t\t\t\t\tcreateDiagnostic(\n\t\t\t\t\t\t\t\tDiagnosticCode.InvalidRef,\n\t\t\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\t\t\t`Ref target export not found: ${refStr}`,\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\tdocId: doc.docId,\n\t\t\t\t\t\t\t\t\tref: refStr,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t}\n}\n"],"mappings":"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"}

package/dist/core/walker/ref-resolver.d.mts

@@ -0,0 +1,22 @@
+import { DiagnosticCode } from "../../diagnostics/errors.mjs";
+import { Ref } from "../ir/types.mjs";
+//#region src/core/walker/ref-resolver.d.ts
+export type RefResolution = {
+  readonly ok: true;
+  readonly ref: Ref;
+} | {
+  readonly ok: false;
+  readonly code: DiagnosticCode;
+  readonly message: string;
+};
+/**
+ * Resolve a JSON Schema `$ref` into an abstract {@link Ref}.
+ *
+ * - `#/` and `#` → the root export of the (current or target) document.
+ * - `#/$defs/Name` and `#/definitions/Name` → a named export.
+ * - `./path.json`, `path.json`, `../x.json` → cross-file, resolved against the current doc id.
+ * - `http(s):`, `urn:`, `file:` → unsupported external ref.
+ */
+export declare function resolveRef(ref: string, currentDocId: string, docIdSet: ReadonlySet<string>, rootExportNameOf: (docId: string) => string): RefResolution;
+//#endregion
+//# sourceMappingURL=ref-resolver.d.mts.map

package/dist/core/walker/ref-resolver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.d.mts","names":[],"sources":["../../../src/core/walker/ref-resolver.ts"],"mappings":";;;YAIY;WACE;WAAmB,KAAK;;WACxB;WAAoB,MAAM;WAAyB;;;;;;;;;;wBAUjD,WACf,aACA,sBACA,UAAU,qBACV,mBAAmB,2BACjB"}

package/dist/core/walker/ref-resolver.mjs

@@ -0,0 +1,66 @@
+import { DiagnosticCode } from "../../diagnostics/errors.mjs";
+//#region src/core/walker/ref-resolver.ts
+/**
+* Resolve a JSON Schema `$ref` into an abstract {@link Ref}.
+*
+* - `#/` and `#` → the root export of the (current or target) document.
+* - `#/$defs/Name` and `#/definitions/Name` → a named export.
+* - `./path.json`, `path.json`, `../x.json` → cross-file, resolved against the current doc id.
+* - `http(s):`, `urn:`, `file:` → unsupported external ref.
+*/
+function resolveRef(ref, currentDocId, docIdSet, rootExportNameOf) {
+	if (/^(https?:|file:|urn:)/i.test(ref)) return {
+		ok: false,
+		code: DiagnosticCode.ExternalRef,
+		message: `External refs are not supported: ${ref}`
+	};
+	const hashIdx = ref.indexOf("#");
+	const pathPart = hashIdx >= 0 ? ref.slice(0, hashIdx) : ref;
+	const fragment = hashIdx >= 0 ? ref.slice(hashIdx) : "";
+	const targetDocId = pathPart === "" ? currentDocId : normalizeDocId(pathPart, currentDocId);
+	if (!docIdSet.has(targetDocId)) return {
+		ok: false,
+		code: DiagnosticCode.InvalidRef,
+		message: `Target schema not found in input: ${ref}`
+	};
+	const exportName = parseFragment(fragment);
+	if (exportName === null) return {
+		ok: false,
+		code: DiagnosticCode.InvalidRef,
+		message: `Unsupported $ref pointer: ${ref}`
+	};
+	return {
+		ok: true,
+		ref: {
+			docId: targetDocId,
+			exportName: exportName === "" ? rootExportNameOf(targetDocId) : exportName
+		}
+	};
+}
+/** Parse a fragment like `#`, `#/`, `#/$defs/Foo`, `#/definitions/Foo`. Returns `""` for root, the def name, or `null` if unsupported. */
+function parseFragment(fragment) {
+	if (fragment === "" || fragment === "#" || fragment === "#/") return "";
+	const match = /^#\/(?:\$defs|definitions)\/([^/]+)$/.exec(fragment);
+	if (match) return match[1] ?? null;
+	return null;
+}
+/** Resolve a relative path part against the current doc id (posix). */
+function normalizeDocId(pathPart, currentDocId) {
+	const slash = currentDocId.lastIndexOf("/");
+	const dir = slash >= 0 ? currentDocId.slice(0, slash) : "";
+	const joined = dir ? `${dir}/${pathPart}` : pathPart;
+	const out = [];
+	for (const seg of joined.split("/")) {
+		if (seg === "." || seg === "") continue;
+		if (seg === "..") {
+			out.pop();
+			continue;
+		}
+		out.push(seg);
+	}
+	return out.join("/");
+}
+//#endregion
+export { resolveRef };
+
+//# sourceMappingURL=ref-resolver.mjs.map

package/dist/core/walker/ref-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-resolver.mjs","names":["DC"],"sources":["../../../src/core/walker/ref-resolver.ts"],"sourcesContent":["import type { DiagnosticCode } from \"../../diagnostics/errors.js\";\nimport { DiagnosticCode as DC } from \"../../diagnostics/errors.js\";\nimport type { Ref } from \"../ir/types.js\";\n\nexport type RefResolution =\n\t| { readonly ok: true; readonly ref: Ref }\n\t| { readonly ok: false; readonly code: DiagnosticCode; readonly message: string };\n\n/**\n * Resolve a JSON Schema `$ref` into an abstract {@link Ref}.\n *\n * - `#/` and `#` → the root export of the (current or target) document.\n * - `#/$defs/Name` and `#/definitions/Name` → a named export.\n * - `./path.json`, `path.json`, `../x.json` → cross-file, resolved against the current doc id.\n * - `http(s):`, `urn:`, `file:` → unsupported external ref.\n */\nexport function resolveRef(\n\tref: string,\n\tcurrentDocId: string,\n\tdocIdSet: ReadonlySet<string>,\n\trootExportNameOf: (docId: string) => string,\n): RefResolution {\n\tif (/^(https?:|file:|urn:)/i.test(ref)) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tcode: DC.ExternalRef,\n\t\t\tmessage: `External refs are not supported: ${ref}`,\n\t\t};\n\t}\n\n\tconst hashIdx = ref.indexOf(\"#\");\n\tconst pathPart = hashIdx >= 0 ? ref.slice(0, hashIdx) : ref;\n\tconst fragment = hashIdx >= 0 ? ref.slice(hashIdx) : \"\";\n\n\tconst targetDocId = pathPart === \"\" ? currentDocId : normalizeDocId(pathPart, currentDocId);\n\tif (!docIdSet.has(targetDocId)) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tcode: DC.InvalidRef,\n\t\t\tmessage: `Target schema not found in input: ${ref}`,\n\t\t};\n\t}\n\n\tconst exportName = parseFragment(fragment);\n\tif (exportName === null) {\n\t\treturn { ok: false, code: DC.InvalidRef, message: `Unsupported $ref pointer: ${ref}` };\n\t}\n\tconst name = exportName === \"\" ? rootExportNameOf(targetDocId) : exportName;\n\treturn { ok: true, ref: { docId: targetDocId, exportName: name } };\n}\n\n/** Parse a fragment like `#`, `#/`, `#/$defs/Foo`, `#/definitions/Foo`. Returns `\"\"` for root, the def name, or `null` if unsupported. */\nfunction parseFragment(fragment: string): string | null {\n\tif (fragment === \"\" || fragment === \"#\" || fragment === \"#/\") {\n\t\treturn \"\";\n\t}\n\tconst match = /^#\\/(?:\\$defs|definitions)\\/([^/]+)$/.exec(fragment);\n\tif (match) {\n\t\tconst name = match[1];\n\t\treturn name ?? null;\n\t}\n\treturn null;\n}\n\n/** Resolve a relative path part against the current doc id (posix). */\nfunction normalizeDocId(pathPart: string, currentDocId: string): string {\n\tconst slash = currentDocId.lastIndexOf(\"/\");\n\tconst dir = slash >= 0 ? currentDocId.slice(0, slash) : \"\";\n\tconst joined = dir ? `${dir}/${pathPart}` : pathPart;\n\tconst out: string[] = [];\n\tfor (const seg of joined.split(\"/\")) {\n\t\tif (seg === \".\" || seg === \"\") {\n\t\t\tcontinue;\n\t\t}\n\t\tif (seg === \"..\") {\n\t\t\tout.pop();\n\t\t\tcontinue;\n\t\t}\n\t\tout.push(seg);\n\t}\n\treturn out.join(\"/\");\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,WACf,KACA,cACA,UACA,kBACgB;CAChB,IAAI,yBAAyB,KAAK,GAAG,GACpC,OAAO;EACN,IAAI;EACJ,MAAMA,eAAG;EACT,SAAS,oCAAoC;CAC9C;CAGD,MAAM,UAAU,IAAI,QAAQ,GAAG;CAC/B,MAAM,WAAW,WAAW,IAAI,IAAI,MAAM,GAAG,OAAO,IAAI;CACxD,MAAM,WAAW,WAAW,IAAI,IAAI,MAAM,OAAO,IAAI;CAErD,MAAM,cAAc,aAAa,KAAK,eAAe,eAAe,UAAU,YAAY;CAC1F,IAAI,CAAC,SAAS,IAAI,WAAW,GAC5B,OAAO;EACN,IAAI;EACJ,MAAMA,eAAG;EACT,SAAS,qCAAqC;CAC/C;CAGD,MAAM,aAAa,cAAc,QAAQ;CACzC,IAAI,eAAe,MAClB,OAAO;EAAE,IAAI;EAAO,MAAMA,eAAG;EAAY,SAAS,6BAA6B;CAAM;CAGtF,OAAO;EAAE,IAAI;EAAM,KAAK;GAAE,OAAO;GAAa,YADjC,eAAe,KAAK,iBAAiB,WAAW,IAAI;EACF;CAAE;AAClE;;AAGA,SAAS,cAAc,UAAiC;CACvD,IAAI,aAAa,MAAM,aAAa,OAAO,aAAa,MACvD,OAAO;CAER,MAAM,QAAQ,uCAAuC,KAAK,QAAQ;CAClE,IAAI,OAEH,OADa,MAAM,MACJ;CAEhB,OAAO;AACR;;AAGA,SAAS,eAAe,UAAkB,cAA8B;CACvE,MAAM,QAAQ,aAAa,YAAY,GAAG;CAC1C,MAAM,MAAM,SAAS,IAAI,aAAa,MAAM,GAAG,KAAK,IAAI;CACxD,MAAM,SAAS,MAAM,GAAG,IAAI,GAAG,aAAa;CAC5C,MAAM,MAAgB,CAAC;CACvB,KAAK,MAAM,OAAO,OAAO,MAAM,GAAG,GAAG;EACpC,IAAI,QAAQ,OAAO,QAAQ,IAC1B;EAED,IAAI,QAAQ,MAAM;GACjB,IAAI,IAAI;GACR;EACD;EACA,IAAI,KAAK,GAAG;CACb;CACA,OAAO,IAAI,KAAK,GAAG;AACpB"}

package/dist/core/writer/index.d.mts

@@ -0,0 +1,19 @@
+import { Logger } from "../../diagnostics/logger.mjs";
+import { PrintedFile } from "../types.mjs";
+//#region src/core/writer/index.d.ts
+export interface WriteOptions {
+  /** Absolute output root directory. */
+  readonly output: string;
+  readonly dryRun: boolean;
+  readonly clean: boolean;
+  readonly logger: Logger;
+  /** Header template (`string`, possibly with `{{version}}`/`{{date}}`) or `false` to disable. */
+  readonly header: string | false;
+}
+export interface WriteResult {
+  readonly written: readonly string[];
+  readonly deleted: readonly string[];
+}
+export declare function writeFiles(files: readonly PrintedFile[], opts: WriteOptions): Promise<WriteResult>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/core/writer/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/writer/index.ts"],"mappings":";;;iBAuBiB;;WAEP;WACA;WACA;WACA,QAAQ;;WAER;;iBAGO;WACP;WACA;;wBAGY,WACrB,gBAAgB,eAChB,MAAM,eACJ,QAAQ"}

package/dist/core/writer/index.mjs

@@ -0,0 +1,84 @@
+import { version } from "../../package.mjs";
+import path from "node:path";
+import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+//#region src/core/writer/index.ts
+const VERSION = version;
+/** Marker of the built-in default header; also matches outputs of previous runs. */
+const DEFAULT_MARKER = "// @generated by json2code";
+/**
+* Render the effective header text for a template (or no header at all).
+* Placeholders: `{{version}}` → generator version, `{{date}}` → YYYY-MM-DD.
+*/
+function renderHeader(header) {
+	if (header === false || header.trim() === "") return "";
+	const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+	return `${header.replaceAll("{{version}}", VERSION).replaceAll("{{date}}", date).replace(/\n+$/, "")}\n\n`;
+}
+async function writeFiles(files, opts) {
+	const newPaths = new Set(files.map((f) => f.path));
+	const written = [];
+	const deleted = [];
+	const headerText = renderHeader(opts.header);
+	const markers = opts.header === false || opts.header.trim() === "" ? [DEFAULT_MARKER] : [DEFAULT_MARKER, headerText.split("\n", 1)[0] ?? DEFAULT_MARKER];
+	if (opts.clean) for (const rel of await findStale(opts.output, newPaths, markers)) {
+		if (opts.dryRun) opts.logger.info(`[dry-run] delete ${rel}`);
+		else {
+			await rm(path.join(opts.output, rel));
+			opts.logger.info(`deleted ${rel}`);
+		}
+		deleted.push(rel);
+	}
+	for (const file of files) {
+		const abs = path.join(opts.output, file.path);
+		const content = `${headerText}${file.content}`;
+		if (opts.dryRun) opts.logger.info(`[dry-run] write ${file.path}`);
+		else {
+			await writeIfChanged(abs, content);
+			opts.logger.info(`wrote ${file.path}`);
+		}
+		written.push(file.path);
+	}
+	return {
+		written,
+		deleted
+	};
+}
+async function writeIfChanged(abs, content) {
+	await mkdir(path.dirname(abs), { recursive: true });
+	try {
+		if (await readFile(abs, "utf8") === content) return;
+	} catch {}
+	await writeFile(abs, content);
+}
+async function findStale(output, keep, markers) {
+	let isDir;
+	try {
+		isDir = (await stat(output)).isDirectory();
+	} catch {
+		return [];
+	}
+	if (!isDir) return [];
+	const entries = await readdir(output, {
+		recursive: true,
+		withFileTypes: true
+	});
+	const stale = [];
+	for (const entry of entries) {
+		if (!entry.isFile() || !entry.name.endsWith(".ts")) continue;
+		const full = path.join(entry.parentPath, entry.name);
+		const rel = path.relative(output, full).split(path.sep).join("/");
+		if (keep.has(rel)) continue;
+		let head = "";
+		try {
+			head = await readFile(full, "utf8");
+		} catch {
+			continue;
+		}
+		if (markers.some((m) => head.startsWith(m))) stale.push(rel);
+	}
+	return stale.toSorted();
+}
+//#endregion
+export { renderHeader, writeFiles };
+
+//# sourceMappingURL=index.mjs.map

package/dist/core/writer/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["pkg.version"],"sources":["../../../src/core/writer/index.ts"],"sourcesContent":["import { mkdir, readFile, readdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport pkg from \"../../../package.json\" with { type: \"json\" };\nimport type { Logger } from \"../../diagnostics/logger.js\";\nimport type { PrintedFile } from \"../types.js\";\n\nconst VERSION: string = pkg.version;\n/** Marker of the built-in default header; also matches outputs of previous runs. */\nconst DEFAULT_MARKER = \"// @generated by json2code\";\n\n/**\n * Render the effective header text for a template (or no header at all).\n * Placeholders: `{{version}}` → generator version, `{{date}}` → YYYY-MM-DD.\n */\nexport function renderHeader(header: string | false): string {\n\tif (header === false || header.trim() === \"\") {\n\t\treturn \"\";\n\t}\n\tconst date = new Date().toISOString().slice(0, 10);\n\tconst text = header.replaceAll(\"{{version}}\", VERSION).replaceAll(\"{{date}}\", date);\n\treturn `${text.replace(/\\n+$/, \"\")}\\n\\n`;\n}\n\nexport interface WriteOptions {\n\t/** Absolute output root directory. */\n\treadonly output: string;\n\treadonly dryRun: boolean;\n\treadonly clean: boolean;\n\treadonly logger: Logger;\n\t/** Header template (`string`, possibly with `{{version}}`/`{{date}}`) or `false` to disable. */\n\treadonly header: string | false;\n}\n\nexport interface WriteResult {\n\treadonly written: readonly string[];\n\treadonly deleted: readonly string[];\n}\n\nexport async function writeFiles(\n\tfiles: readonly PrintedFile[],\n\topts: WriteOptions,\n): Promise<WriteResult> {\n\tconst newPaths = new Set(files.map(f => f.path));\n\tconst written: string[] = [];\n\tconst deleted: string[] = [];\n\tconst headerText = renderHeader(opts.header);\n\t// stale detection matches the current header and the default marker (covers older outputs)\n\tconst markers =\n\t\topts.header === false || opts.header.trim() === \"\"\n\t\t\t? [DEFAULT_MARKER]\n\t\t\t: [DEFAULT_MARKER, headerText.split(\"\\n\", 1)[0] ?? DEFAULT_MARKER];\n\n\tif (opts.clean) {\n\t\tfor (const rel of await findStale(opts.output, newPaths, markers)) {\n\t\t\tif (opts.dryRun) {\n\t\t\t\topts.logger.info(`[dry-run] delete ${rel}`);\n\t\t\t} else {\n\t\t\t\tawait rm(path.join(opts.output, rel));\n\t\t\t\topts.logger.info(`deleted ${rel}`);\n\t\t\t}\n\t\t\tdeleted.push(rel);\n\t\t}\n\t}\n\n\tfor (const file of files) {\n\t\tconst abs = path.join(opts.output, file.path);\n\t\tconst content = `${headerText}${file.content}`;\n\t\tif (opts.dryRun) {\n\t\t\topts.logger.info(`[dry-run] write ${file.path}`);\n\t\t} else {\n\t\t\tawait writeIfChanged(abs, content);\n\t\t\topts.logger.info(`wrote ${file.path}`);\n\t\t}\n\t\twritten.push(file.path);\n\t}\n\n\treturn { written, deleted };\n}\n\nasync function writeIfChanged(abs: string, content: string): Promise<void> {\n\tawait mkdir(path.dirname(abs), { recursive: true });\n\ttry {\n\t\tconst existing = await readFile(abs, \"utf8\");\n\t\tif (existing === content) {\n\t\t\treturn;\n\t\t}\n\t} catch {\n\t\t// file doesn't exist yet — fall through to write\n\t}\n\tawait writeFile(abs, content);\n}\n\nasync function findStale(\n\toutput: string,\n\tkeep: ReadonlySet<string>,\n\tmarkers: readonly string[],\n): Promise<string[]> {\n\tlet isDir: boolean;\n\ttry {\n\t\tisDir = (await stat(output)).isDirectory();\n\t} catch {\n\t\treturn [];\n\t}\n\tif (!isDir) {\n\t\treturn [];\n\t}\n\n\tconst entries = await readdir(output, { recursive: true, withFileTypes: true });\n\tconst stale: string[] = [];\n\tfor (const entry of entries) {\n\t\tif (!entry.isFile() || !entry.name.endsWith(\".ts\")) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst full = path.join(entry.parentPath, entry.name);\n\t\tconst rel = path.relative(output, full).split(path.sep).join(\"/\");\n\t\tif (keep.has(rel)) {\n\t\t\tcontinue;\n\t\t}\n\t\tlet head = \"\";\n\t\ttry {\n\t\t\thead = await readFile(full, \"utf8\");\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tif (markers.some(m => head.startsWith(m))) {\n\t\t\tstale.push(rel);\n\t\t}\n\t}\n\treturn stale.toSorted();\n}\n"],"mappings":";;;;AAMA,MAAM,UAAkBA;;AAExB,MAAM,iBAAiB;;;;;AAMvB,SAAgB,aAAa,QAAgC;CAC5D,IAAI,WAAW,SAAS,OAAO,KAAK,MAAM,IACzC,OAAO;CAER,MAAM,wBAAO,IAAI,KAAK,EAAA,CAAE,YAAY,CAAC,CAAC,MAAM,GAAG,EAAE;CAEjD,OAAO,GADM,OAAO,WAAW,eAAe,OAAO,CAAC,CAAC,WAAW,YAAY,IACjE,CAAC,CAAC,QAAQ,QAAQ,EAAE,EAAE;AACpC;AAiBA,eAAsB,WACrB,OACA,MACuB;CACvB,MAAM,WAAW,IAAI,IAAI,MAAM,KAAI,MAAK,EAAE,IAAI,CAAC;CAC/C,MAAM,UAAoB,CAAC;CAC3B,MAAM,UAAoB,CAAC;CAC3B,MAAM,aAAa,aAAa,KAAK,MAAM;CAE3C,MAAM,UACL,KAAK,WAAW,SAAS,KAAK,OAAO,KAAK,MAAM,KAC7C,CAAC,cAAc,IACf,CAAC,gBAAgB,WAAW,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,cAAc;CAEnE,IAAI,KAAK,OACR,KAAK,MAAM,OAAO,MAAM,UAAU,KAAK,QAAQ,UAAU,OAAO,GAAG;EAClE,IAAI,KAAK,QACR,KAAK,OAAO,KAAK,oBAAoB,KAAK;OACpC;GACN,MAAM,GAAG,KAAK,KAAK,KAAK,QAAQ,GAAG,CAAC;GACpC,KAAK,OAAO,KAAK,WAAW,KAAK;EAClC;EACA,QAAQ,KAAK,GAAG;CACjB;CAGD,KAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,MAAM,KAAK,KAAK,KAAK,QAAQ,KAAK,IAAI;EAC5C,MAAM,UAAU,GAAG,aAAa,KAAK;EACrC,IAAI,KAAK,QACR,KAAK,OAAO,KAAK,mBAAmB,KAAK,MAAM;OACzC;GACN,MAAM,eAAe,KAAK,OAAO;GACjC,KAAK,OAAO,KAAK,SAAS,KAAK,MAAM;EACtC;EACA,QAAQ,KAAK,KAAK,IAAI;CACvB;CAEA,OAAO;EAAE;EAAS;CAAQ;AAC3B;AAEA,eAAe,eAAe,KAAa,SAAgC;CAC1E,MAAM,MAAM,KAAK,QAAQ,GAAG,GAAG,EAAE,WAAW,KAAK,CAAC;CAClD,IAAI;EAEH,IAAI,MADmB,SAAS,KAAK,MAAM,MAC1B,SAChB;CAEF,QAAQ,CAER;CACA,MAAM,UAAU,KAAK,OAAO;AAC7B;AAEA,eAAe,UACd,QACA,MACA,SACoB;CACpB,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,KAAK,MAAM,EAAA,CAAG,YAAY;CAC1C,QAAQ;EACP,OAAO,CAAC;CACT;CACA,IAAI,CAAC,OACJ,OAAO,CAAC;CAGT,MAAM,UAAU,MAAM,QAAQ,QAAQ;EAAE,WAAW;EAAM,eAAe;CAAK,CAAC;CAC9E,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,SAAS,SAAS;EAC5B,IAAI,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,KAAK,GAChD;EAED,MAAM,OAAO,KAAK,KAAK,MAAM,YAAY,MAAM,IAAI;EACnD,MAAM,MAAM,KAAK,SAAS,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;EAChE,IAAI,KAAK,IAAI,GAAG,GACf;EAED,IAAI,OAAO;EACX,IAAI;GACH,OAAO,MAAM,SAAS,MAAM,MAAM;EACnC,QAAQ;GACP;EACD;EACA,IAAI,QAAQ,MAAK,MAAK,KAAK,WAAW,CAAC,CAAC,GACvC,MAAM,KAAK,GAAG;CAEhB;CACA,OAAO,MAAM,SAAS;AACvB"}

package/dist/diagnostics/errors.d.mts

@@ -0,0 +1,39 @@
+//#region src/diagnostics/errors.d.ts
+export declare const DiagnosticCode: {
+  readonly FileNotFound: "J2C_FILE_NOT_FOUND";
+  readonly InvalidJson: "J2C_INVALID_JSON";
+  readonly InvalidRef: "J2C_INVALID_REF";
+  readonly ExternalRef: "J2C_EXTERNAL_REF";
+  readonly NameCollision: "J2C_NAME_COLLISION";
+  readonly UnknownKeyword: "J2C_UNKNOWN_KEYWORD";
+  readonly OutputDirty: "J2C_OUTPUT_DIRTY";
+};
+export type DiagnosticCode = (typeof DiagnosticCode)[keyof typeof DiagnosticCode];
+export type DiagnosticSeverity = "error" | "warning";
+export interface Diagnostic {
+  readonly code: DiagnosticCode;
+  readonly severity: DiagnosticSeverity;
+  readonly message: string;
+  /** doc id (path relative to input root) for display. */
+  readonly docId?: string;
+  /** the $ref string that caused the diagnostic. */
+  readonly ref?: string;
+}
+export declare function createDiagnostic(code: DiagnosticCode, severity: DiagnosticSeverity, message: string, location?: {
+  docId?: string;
+  ref?: string;
+}): Diagnostic;
+/** Format a single diagnostic as `[docId] → [$ref] → message`. */
+export declare function formatDiagnostic(diag: Diagnostic): string;
+/** Aggregated error carrying all collected diagnostics. Thrown once at the end of a run. */
+export declare class Json2CodeError extends Error {
+  readonly diagnostics: Diagnostic[];
+  constructor(diagnostics: Diagnostic[]);
+}
+/** Separate error-level from warning-level diagnostics. */
+export declare function partitionDiagnostics(diagnostics: readonly Diagnostic[]): {
+  errors: Diagnostic[];
+  warnings: Diagnostic[];
+};
+//#endregion
+//# sourceMappingURL=errors.d.mts.map

package/dist/diagnostics/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../src/diagnostics/errors.ts"],"mappings":";qBAAa;WACZ;WACA;WACA;WACA;WACA;WACA;WACA;;YAGW,yBAAyB,6BAA6B;YAEtD;iBAEK;WACP,MAAM;WACN,UAAU;WACV;;WAEA;;WAEA;;wBAGM,iBACf,MAAM,gBACN,UAAU,oBACV,iBACA;EAAa;EAAgB;IAC3B;;wBAKa,iBAAiB,MAAM;;qBAa1B,uBAAuB;WACnB,aAAa;EAE7B,YAAmB,aAAa;;;wBAQjB,qBAAqB,sBAAsB;EAC1D,QAAQ;EACR,UAAU"}