@pajecawav/json2code 0.0.0-stage → 0.1.0

package/dist/core/ir/types.d.mts

@@ -0,0 +1,100 @@
+//#region src/core/ir/types.d.ts
+/**
+ * Intermediate representation (IR) — the only "language" between a Walker and a Printer.
+ * Any custom Walker must produce IR; any Printer must consume it.
+ */
+export interface IRMeta {
+  readonly title?: string;
+  readonly description?: string;
+  readonly deprecated?: boolean;
+  readonly default?: unknown;
+  readonly examples?: readonly unknown[];
+}
+/** Abstract reference to a document export. Resolved to a relative import by the Linker/Printer. */
+export interface Ref {
+  readonly docId: string;
+  readonly exportName: string;
+}
+interface IRNodeBase {
+  readonly meta?: IRMeta;
+}
+export type IRType = (IRNodeBase & {
+  readonly kind: "ref";
+  readonly ref: Ref;
+}) | (IRNodeBase & {
+  readonly kind: "string";
+  readonly enum?: readonly string[];
+  readonly const?: string;
+  readonly pattern?: string;
+  readonly format?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+}) | (IRNodeBase & {
+  readonly kind: "number";
+  readonly enum?: readonly number[];
+  readonly const?: number;
+  readonly minimum?: number;
+  readonly maximum?: number;
+  readonly exclusiveMinimum?: number;
+  readonly exclusiveMaximum?: number;
+  readonly multipleOf?: number;
+}) | (IRNodeBase & {
+  readonly kind: "integer";
+  readonly enum?: readonly number[];
+  readonly const?: number;
+  readonly minimum?: number;
+  readonly maximum?: number;
+  readonly exclusiveMinimum?: number;
+  readonly exclusiveMaximum?: number;
+  readonly multipleOf?: number;
+}) | (IRNodeBase & {
+  readonly kind: "boolean";
+  readonly const?: boolean;
+}) | (IRNodeBase & {
+  readonly kind: "null";
+}) | (IRNodeBase & {
+  readonly kind: "literal";
+  readonly value: string | number | boolean | null;
+}) | (IRNodeBase & {
+  readonly kind: "array";
+  readonly items?: IRType;
+  readonly minItems?: number;
+  readonly maxItems?: number;
+  readonly uniqueItems?: boolean;
+}) | (IRNodeBase & {
+  readonly kind: "tuple";
+  readonly items: readonly IRType[];
+  readonly additionalItems?: IRType;
+}) | (IRNodeBase & {
+  readonly kind: "object";
+  readonly properties: ReadonlyMap<string, IRType>;
+  readonly required: readonly string[];
+  readonly additionalProperties?: IRType | false;
+}) | (IRNodeBase & {
+  readonly kind: "record";
+  readonly values: IRType;
+}) | (IRNodeBase & {
+  readonly kind: "union";
+  readonly variants: readonly IRType[];
+}) | (IRNodeBase & {
+  readonly kind: "intersection";
+  readonly variants: readonly IRType[];
+}) | (IRNodeBase & {
+  readonly kind: "unknown";
+});
+export type IRKind = IRType["kind"];
+export interface SourceDoc {
+  /** Normalized document id (posix path relative to the input root). */
+  readonly docId: string;
+  /** Absolute path of the source file (for diagnostics). */
+  readonly sourcePath: string;
+  /** Named exports: $defs/definitions + the schema root. */
+  readonly exports: ReadonlyMap<string, IRType>;
+  /** Deterministic order of export names. */
+  readonly exportOrder: readonly string[];
+  /** Export name for the schema root (PascalCase of the file name). */
+  readonly rootExportName: string;
+}
+//#endregion
+export {};
+//# sourceMappingURL=types.d.mts.map

package/dist/core/ir/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/core/ir/types.ts"],"mappings":";;;;;iBAKiB;WACP;WACA;WACA;WACA;WACA;;;iBAIO;WACP;WACA;;UAGA;WACA,OAAO;;YAGL,UACR;WACQ;WACA,KAAK;MAEb;WACQ;WACA;WACA;WACA;WACA;WACA;WACA;MAER;WACQ;WACA;WACA;WACA;WACA;WACA;WACA;WACA;MAER;WACQ;WACA;WACA;WACA;WACA;WACA;WACA;WACA;MAER;WACQ;WACA;MAER;WACQ;MAER;WACQ;WACA;MAER;WACQ;WACA,QAAQ;WACR;WACA;WACA;MAER;WACQ;WACA,gBAAgB;WAChB,kBAAkB;MAE1B;WACQ;WACA,YAAY,oBAAoB;WAChC;WACA,uBAAuB;MAE/B;WACQ;WACA,QAAQ;MAEhB;WACQ;WACA,mBAAmB;MAE3B;WACQ;WACA,mBAAmB;MAE3B;WACQ;;YAGA,SAAS;iBAEJ;;WAEP;;WAEA;;WAEA,SAAS,oBAAoB;;WAE7B;;WAEA"}

package/dist/core/ir/visit.d.mts

@@ -0,0 +1,8 @@
+import { IRType, Ref } from "./types.mjs";
+//#region src/core/ir/visit.d.ts
+/** Depth-first traversal of an IR node, visiting every {@link Ref} leaf. */
+export declare function visitRefs(node: IRType, visit: (ref: Ref) => void): void;
+/** Collect the set of documents referenced (directly) by an IR node. */
+export declare function referencedDocs(node: IRType): Set<string>;
+//#endregion
+//# sourceMappingURL=visit.d.mts.map

package/dist/core/ir/visit.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit.d.mts","names":[],"sources":["../../../src/core/ir/visit.ts"],"mappings":";;;wBAGgB,UAAU,MAAM,QAAQ,QAAQ,KAAK;;wBAyCrC,eAAe,MAAM,SAAS"}

package/dist/core/ir/visit.mjs

@@ -0,0 +1,38 @@
+//#region src/core/ir/visit.ts
+/** Depth-first traversal of an IR node, visiting every {@link Ref} leaf. */
+function visitRefs(node, visit) {
+	switch (node.kind) {
+		case "ref":
+			visit(node.ref);
+			return;
+		case "array":
+			if (node.items) visitRefs(node.items, visit);
+			return;
+		case "tuple":
+			for (const item of node.items) visitRefs(item, visit);
+			if (node.additionalItems) visitRefs(node.additionalItems, visit);
+			return;
+		case "object":
+			for (const [, value] of node.properties) visitRefs(value, visit);
+			if (node.additionalProperties) visitRefs(node.additionalProperties, visit);
+			return;
+		case "record":
+			visitRefs(node.values, visit);
+			return;
+		case "union":
+		case "intersection":
+			for (const variant of node.variants) visitRefs(variant, visit);
+			return;
+		default: return;
+	}
+}
+/** Collect the set of documents referenced (directly) by an IR node. */
+function referencedDocs(node) {
+	const docs = /* @__PURE__ */ new Set();
+	visitRefs(node, (ref) => docs.add(ref.docId));
+	return docs;
+}
+//#endregion
+export { referencedDocs, visitRefs };
+
+//# sourceMappingURL=visit.mjs.map

package/dist/core/ir/visit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"visit.mjs","names":[],"sources":["../../../src/core/ir/visit.ts"],"sourcesContent":["import type { IRType, Ref } from \"./types.js\";\n\n/** Depth-first traversal of an IR node, visiting every {@link Ref} leaf. */\nexport function visitRefs(node: IRType, visit: (ref: Ref) => void): void {\n\tswitch (node.kind) {\n\t\tcase \"ref\":\n\t\t\tvisit(node.ref);\n\t\t\treturn;\n\t\tcase \"array\":\n\t\t\tif (node.items) {\n\t\t\t\tvisitRefs(node.items, visit);\n\t\t\t}\n\t\t\treturn;\n\t\tcase \"tuple\":\n\t\t\tfor (const item of node.items) {\n\t\t\t\tvisitRefs(item, visit);\n\t\t\t}\n\t\t\tif (node.additionalItems) {\n\t\t\t\tvisitRefs(node.additionalItems, visit);\n\t\t\t}\n\t\t\treturn;\n\t\tcase \"object\":\n\t\t\tfor (const [, value] of node.properties) {\n\t\t\t\tvisitRefs(value, visit);\n\t\t\t}\n\t\t\tif (node.additionalProperties) {\n\t\t\t\tvisitRefs(node.additionalProperties, visit);\n\t\t\t}\n\t\t\treturn;\n\t\tcase \"record\":\n\t\t\tvisitRefs(node.values, visit);\n\t\t\treturn;\n\t\tcase \"union\":\n\t\tcase \"intersection\":\n\t\t\tfor (const variant of node.variants) {\n\t\t\t\tvisitRefs(variant, visit);\n\t\t\t}\n\t\t\treturn;\n\t\tdefault:\n\t\t\treturn;\n\t}\n}\n\n/** Collect the set of documents referenced (directly) by an IR node. */\nexport function referencedDocs(node: IRType): Set<string> {\n\tconst docs = new Set<string>();\n\tvisitRefs(node, ref => docs.add(ref.docId));\n\treturn docs;\n}\n"],"mappings":";;AAGA,SAAgB,UAAU,MAAc,OAAiC;CACxE,QAAQ,KAAK,MAAb;EACC,KAAK;GACJ,MAAM,KAAK,GAAG;GACd;EACD,KAAK;GACJ,IAAI,KAAK,OACR,UAAU,KAAK,OAAO,KAAK;GAE5B;EACD,KAAK;GACJ,KAAK,MAAM,QAAQ,KAAK,OACvB,UAAU,MAAM,KAAK;GAEtB,IAAI,KAAK,iBACR,UAAU,KAAK,iBAAiB,KAAK;GAEtC;EACD,KAAK;GACJ,KAAK,MAAM,GAAG,UAAU,KAAK,YAC5B,UAAU,OAAO,KAAK;GAEvB,IAAI,KAAK,sBACR,UAAU,KAAK,sBAAsB,KAAK;GAE3C;EACD,KAAK;GACJ,UAAU,KAAK,QAAQ,KAAK;GAC5B;EACD,KAAK;EACL,KAAK;GACJ,KAAK,MAAM,WAAW,KAAK,UAC1B,UAAU,SAAS,KAAK;GAEzB;EACD,SACC;CACF;AACD;;AAGA,SAAgB,eAAe,MAA2B;CACzD,MAAM,uBAAO,IAAI,IAAY;CAC7B,UAAU,OAAM,QAAO,KAAK,IAAI,IAAI,KAAK,CAAC;CAC1C,OAAO;AACR"}

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

@@ -0,0 +1,32 @@
+import { Diagnostic } from "../../diagnostics/errors.mjs";
+import { Logger } from "../../diagnostics/logger.mjs";
+import { SourceDoc } from "../ir/types.mjs";
+import { PrintContext } from "../printer/abstract.mjs";
+import { ResolvedOptions } from "../types.mjs";
+//#region src/core/linker/index.d.ts
+export interface LinkerOptions {
+  readonly options: ResolvedOptions;
+  readonly targetName: string;
+  /** Maps a doc id to its output subpath (relative to output root, without extension). */
+  readonly mapOutput: (docId: string) => string;
+  /** Diagnostics sink for naming warnings. */
+  readonly diagnostics: Diagnostic[];
+}
+/**
+ * Resolves abstract {@link Ref}s into relative import specifiers and output paths.
+ * One Linker per target; builds the {@link PrintContext} handed to printers.
+ */
+export declare class Linker {
+  private readonly opts;
+  private readonly namesByDoc;
+  constructor(opts: LinkerOptions);
+  /** Default output subpath for a doc id: `<targetName>/<stem>` (strips the source extension). */
+  static defaultMapOutput(targetName: string, docId: string): string;
+  outputPath(docId: string): string;
+  resolveImport(fromDocId: string, toDocId: string): string;
+  resolveExportName(doc: SourceDoc, exportName: string): string;
+  createPrintContext(logger: Logger, diagnostics: Diagnostic[]): PrintContext;
+  private extension;
+}
+//#endregion
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/linker/index.ts"],"mappings":";;;;;;iBAOiB;WACP,SAAS;WACT;;WAEA,YAAY;;WAEZ,aAAa;;;;;;qBAOV;mBACK;mBACA;EAEjB,YAAmB,MAAM;;SAKX,iBAAiB,oBAAoB;EAKnD,WAAkB;EAIlB,cAAqB,mBAAmB;EAUxC,kBAAyB,KAAK,WAAW;EAazC,mBAA0B,QAAQ,QAAQ,aAAa,eAAe;UAY9D"}

package/dist/core/linker/index.mjs

@@ -0,0 +1,103 @@
+import { DiagnosticCode, createDiagnostic } from "../../diagnostics/errors.mjs";
+import { posix } from "node:path";
+//#region src/core/linker/index.ts
+/**
+* Resolves abstract {@link Ref}s into relative import specifiers and output paths.
+* One Linker per target; builds the {@link PrintContext} handed to printers.
+*/
+var Linker = class {
+	opts;
+	namesByDoc = /* @__PURE__ */ new Map();
+	constructor(opts) {
+		this.opts = opts;
+	}
+	/** Default output subpath for a doc id: `<targetName>/<stem>` (strips the source extension). */
+	static defaultMapOutput(targetName, docId) {
+		return `${targetName}/${stripExt(docId)}`;
+	}
+	outputPath(docId) {
+		return `${this.opts.mapOutput(docId)}.ts`;
+	}
+	resolveImport(fromDocId, toDocId) {
+		const fromDir = posix.dirname(this.opts.mapOutput(fromDocId));
+		const toPath = this.opts.mapOutput(toDocId);
+		let rel = posix.relative(fromDir, toPath);
+		if (!rel.startsWith(".")) rel = `./${rel}`;
+		return `${rel}${this.extension()}`;
+	}
+	resolveExportName(doc, exportName) {
+		const style = this.opts.options.naming;
+		if (style === "origin") return exportName;
+		let names = this.namesByDoc.get(doc.docId);
+		if (!names) {
+			names = buildNames(doc, style, this.opts.diagnostics ?? []);
+			this.namesByDoc.set(doc.docId, names);
+		}
+		return names.get(exportName) ?? exportName;
+	}
+	createPrintContext(logger, diagnostics) {
+		return {
+			logger,
+			options: this.opts.options,
+			diagnostics,
+			targetName: this.opts.targetName,
+			outputPath: (docId) => this.outputPath(docId),
+			resolveImport: (from, to) => this.resolveImport(from, to),
+			resolveExportName: (doc, name) => this.resolveExportName(doc, name)
+		};
+	}
+	extension() {
+		switch (this.opts.options.importExtension) {
+			case "js": return ".js";
+			case "ts": return ".ts";
+			case "none": return "";
+		}
+	}
+};
+/**
+* Assign final export names for a document in the given style.
+* Deterministic: follows `exportOrder`; collisions get numeric suffixes + a warning.
+*/
+function buildNames(doc, style, diagnostics) {
+	const names = /* @__PURE__ */ new Map();
+	const used = /* @__PURE__ */ new Set();
+	for (const name of doc.exportOrder) {
+		let candidate = styleName(name, style);
+		if (used.has(candidate)) {
+			const base = candidate;
+			let i = 2;
+			while (used.has(candidate)) {
+				candidate = `${base}${i}`;
+				i++;
+			}
+			diagnostics.push(createDiagnostic(DiagnosticCode.NameCollision, "warning", `Export "${name}" maps to an existing "${base}" name; using "${candidate}"`, { docId: doc.docId }));
+		}
+		names.set(name, candidate);
+		used.add(candidate);
+	}
+	return names;
+}
+/** Split a name into words: by separators (non-alphanumerics) and camelCase boundaries. */
+function words(name) {
+	return name.split(/[^$A-Za-z0-9]+/).filter(Boolean).flatMap((w) => w.split(/(?<=[a-z0-9])(?=[A-Z])/)).filter(Boolean);
+}
+function styleName(name, style) {
+	const ws = words(name);
+	if (ws.length === 0) return name;
+	const [first, ...rest] = ws;
+	const joined = [style === "camel" ? (first ?? "").toLowerCase() : first, ...rest.map((w) => w.charAt(0).toUpperCase() + w.slice(1))].join("");
+	switch (style) {
+		case "camel": return `${joined.charAt(0).toLowerCase()}${joined.slice(1)}`;
+		case "pascal": return `${joined.charAt(0).toUpperCase()}${joined.slice(1)}`;
+		case "origin": return name;
+	}
+}
+function stripExt(p) {
+	const dot = p.lastIndexOf(".");
+	if (dot > p.lastIndexOf("/")) return p.slice(0, dot);
+	return p;
+}
+//#endregion
+export { Linker, styleName };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/linker/index.ts"],"sourcesContent":["import { posix } from \"node:path\";\nimport { createDiagnostic, DiagnosticCode, type Diagnostic } from \"../../diagnostics/errors.js\";\nimport type { Logger } from \"../../diagnostics/logger.js\";\nimport type { SourceDoc } from \"../ir/types.js\";\nimport type { PrintContext } from \"../printer/abstract.js\";\nimport type { NamingStyle, PrintedFile, ResolvedOptions } from \"../types.js\";\n\nexport interface LinkerOptions {\n\treadonly options: ResolvedOptions;\n\treadonly targetName: string;\n\t/** Maps a doc id to its output subpath (relative to output root, without extension). */\n\treadonly mapOutput: (docId: string) => string;\n\t/** Diagnostics sink for naming warnings. */\n\treadonly diagnostics: Diagnostic[];\n}\n\n/**\n * Resolves abstract {@link Ref}s into relative import specifiers and output paths.\n * One Linker per target; builds the {@link PrintContext} handed to printers.\n */\nexport class Linker {\n\tprivate readonly opts: LinkerOptions;\n\tprivate readonly namesByDoc = new Map<string, ReadonlyMap<string, string>>();\n\n\tpublic constructor(opts: LinkerOptions) {\n\t\tthis.opts = opts;\n\t}\n\n\t/** Default output subpath for a doc id: `<targetName>/<stem>` (strips the source extension). */\n\tpublic static defaultMapOutput(targetName: string, docId: string): string {\n\t\tconst stem = stripExt(docId);\n\t\treturn `${targetName}/${stem}`;\n\t}\n\n\tpublic outputPath(docId: string): string {\n\t\treturn `${this.opts.mapOutput(docId)}.ts`;\n\t}\n\n\tpublic resolveImport(fromDocId: string, toDocId: string): string {\n\t\tconst fromDir = posix.dirname(this.opts.mapOutput(fromDocId));\n\t\tconst toPath = this.opts.mapOutput(toDocId);\n\t\tlet rel = posix.relative(fromDir, toPath);\n\t\tif (!rel.startsWith(\".\")) {\n\t\t\trel = `./${rel}`;\n\t\t}\n\t\treturn `${rel}${this.extension()}`;\n\t}\n\n\tpublic resolveExportName(doc: SourceDoc, exportName: string): string {\n\t\tconst style = this.opts.options.naming;\n\t\tif (style === \"origin\") {\n\t\t\treturn exportName;\n\t\t}\n\t\tlet names = this.namesByDoc.get(doc.docId);\n\t\tif (!names) {\n\t\t\tnames = buildNames(doc, style, this.opts.diagnostics ?? []);\n\t\t\tthis.namesByDoc.set(doc.docId, names);\n\t\t}\n\t\treturn names.get(exportName) ?? exportName;\n\t}\n\n\tpublic createPrintContext(logger: Logger, diagnostics: Diagnostic[]): PrintContext {\n\t\treturn {\n\t\t\tlogger,\n\t\t\toptions: this.opts.options,\n\t\t\tdiagnostics,\n\t\t\ttargetName: this.opts.targetName,\n\t\t\toutputPath: docId => this.outputPath(docId),\n\t\t\tresolveImport: (from, to) => this.resolveImport(from, to),\n\t\t\tresolveExportName: (doc, name) => this.resolveExportName(doc, name),\n\t\t};\n\t}\n\n\tprivate extension(): string {\n\t\tswitch (this.opts.options.importExtension) {\n\t\t\tcase \"js\":\n\t\t\t\treturn \".js\";\n\t\t\tcase \"ts\":\n\t\t\t\treturn \".ts\";\n\t\t\tcase \"none\":\n\t\t\t\treturn \"\";\n\t\t}\n\t}\n}\n\nexport interface PrintPlan {\n\treadonly targetName: string;\n\treadonly files: readonly PrintedFile[];\n}\n\n/**\n * Assign final export names for a document in the given style.\n * Deterministic: follows `exportOrder`; collisions get numeric suffixes + a warning.\n */\nfunction buildNames(\n\tdoc: SourceDoc,\n\tstyle: NamingStyle,\n\tdiagnostics: Diagnostic[],\n): ReadonlyMap<string, string> {\n\tconst names = new Map<string, string>();\n\tconst used = new Set<string>();\n\tfor (const name of doc.exportOrder) {\n\t\tlet candidate = styleName(name, style);\n\t\tif (used.has(candidate)) {\n\t\t\tconst base = candidate;\n\t\t\tlet i = 2;\n\t\t\twhile (used.has(candidate)) {\n\t\t\t\tcandidate = `${base}${i}`;\n\t\t\t\ti++;\n\t\t\t}\n\t\t\tdiagnostics.push(\n\t\t\t\tcreateDiagnostic(\n\t\t\t\t\tDiagnosticCode.NameCollision,\n\t\t\t\t\t\"warning\",\n\t\t\t\t\t`Export \"${name}\" maps to an existing \"${base}\" name; using \"${candidate}\"`,\n\t\t\t\t\t{ docId: doc.docId },\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tnames.set(name, candidate);\n\t\tused.add(candidate);\n\t}\n\treturn names;\n}\n\n/** Split a name into words: by separators (non-alphanumerics) and camelCase boundaries. */\nfunction words(name: string): readonly string[] {\n\treturn name\n\t\t.split(/[^$A-Za-z0-9]+/)\n\t\t.filter(Boolean)\n\t\t.flatMap(w => w.split(/(?<=[a-z0-9])(?=[A-Z])/))\n\t\t.filter(Boolean);\n}\n\nexport function styleName(name: string, style: NamingStyle): string {\n\tconst ws = words(name);\n\tif (ws.length === 0) {\n\t\treturn name;\n\t}\n\tconst [first, ...rest] = ws;\n\tconst joined = [\n\t\tstyle === \"camel\" ? (first ?? \"\").toLowerCase() : first,\n\t\t...rest.map(w => w.charAt(0).toUpperCase() + w.slice(1)),\n\t].join(\"\");\n\tswitch (style) {\n\t\tcase \"camel\":\n\t\t\treturn `${joined.charAt(0).toLowerCase()}${joined.slice(1)}`;\n\t\tcase \"pascal\":\n\t\t\treturn `${joined.charAt(0).toUpperCase()}${joined.slice(1)}`;\n\t\tcase \"origin\":\n\t\t\treturn name;\n\t}\n}\n\nfunction stripExt(p: string): string {\n\tconst dot = p.lastIndexOf(\".\");\n\tconst slash = p.lastIndexOf(\"/\");\n\tif (dot > slash) {\n\t\treturn p.slice(0, dot);\n\t}\n\treturn p;\n}\n"],"mappings":"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"}

package/dist/core/printer/abstract.d.mts

@@ -0,0 +1,26 @@
+import { Diagnostic } from "../../diagnostics/errors.mjs";
+import { Logger } from "../../diagnostics/logger.mjs";
+import { SourceDoc } from "../ir/types.mjs";
+import { PrintedFile, ResolvedOptions } from "../types.mjs";
+//#region src/core/printer/abstract.d.ts
+export interface PrintContext {
+  readonly logger: Logger;
+  readonly options: ResolvedOptions;
+  /** Sink for structured diagnostics produced during printing. */
+  readonly diagnostics: Diagnostic[];
+  /** Name of the target being printed. */
+  readonly targetName: string;
+  /** Output path (relative to the output root, with extension) for a document. */
+  outputPath(docId: string): string;
+  /** Relative import specifier between two documents (with extension per settings). */
+  resolveImport(fromDocId: string, toDocId: string): string;
+  /** Final export name for a Ref, taking custom naming into account. */
+  resolveExportName(doc: SourceDoc, exportName: string): string;
+}
+/** Prints IR documents into target code. Receives ALL docs at once so a single-file output is just another printer. */
+export interface AbstractPrinter {
+  readonly name: string;
+  print(docs: readonly SourceDoc[], ctx: PrintContext): Promise<PrintedFile[]>;
+}
+//#endregion
+//# sourceMappingURL=abstract.d.mts.map

package/dist/core/printer/abstract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.mts","names":[],"sources":["../../../src/core/printer/abstract.ts"],"mappings":";;;;;iBAKiB;WACP,QAAQ;WACR,SAAS;;WAET,aAAa;;WAEb;;EAET,WAAW;;EAEX,cAAc,mBAAmB;;EAEjC,kBAAkB,KAAK,WAAW;;;iBAIlB;WACP;EACT,MAAM,eAAe,aAAa,KAAK,eAAe,QAAQ"}

package/dist/core/types.d.mts

@@ -0,0 +1,74 @@
+import { AbstractPrinter } from "./printer/abstract.mjs";
+import { AbstractWalker } from "./walker/abstract.mjs";
+//#region src/core/types.d.ts
+/** A discovered input schema file. */
+export interface SchemaFile {
+  /** Absolute path on disk. */
+  readonly path: string;
+  /** Normalized document id (posix, relative to the input root). */
+  readonly docId: string;
+  /** Raw JSON text. */
+  readonly content: string;
+}
+/** A file produced by a Printer. */
+export interface PrintedFile {
+  /** Path relative to the target's output root. */
+  readonly path: string;
+  readonly content: string;
+}
+export type ImportExtension = "js" | "ts" | "none";
+/** Import specifiers per validator target. */
+export interface ImportPaths {
+  readonly zod?: string;
+  readonly valibot?: string;
+}
+/** Style applied to exported type/schema names. */
+export type NamingStyle = "origin" | "camel" | "pascal";
+/** User-tunable codegen options (with defaults). */
+export interface GenerateOptions {
+  readonly importExtension: ImportExtension;
+  readonly readonlyArrays: boolean;
+  /** Import specifiers per validator target (default: the package name). */
+  readonly importPaths: ImportPaths;
+  /** Apply JSON Schema `default` in validator targets. */
+  readonly defaults: boolean;
+  /** Export name style (default: `pascal`). */
+  readonly naming: NamingStyle;
+  /** File header template; `false` disables it. */
+  readonly header: string | false;
+}
+export declare const DEFAULT_OPTIONS: GenerateOptions;
+/** Resolved options (paths made absolute). Passed through contexts. */
+export interface ResolvedOptions extends GenerateOptions {
+  /** Absolute output directory. */
+  readonly output: string;
+  /** Absolute common input root (used to compute doc ids). */
+  readonly rootDir: string;
+}
+export type TargetName = "typescript" | "zod" | "valibot";
+/** Either a built-in preset name or a fully custom generator definition. */
+export type TargetSpec = TargetName | GeneratorDefinition;
+/**
+ * Defines a target generator. Built-in targets are preset instances of this;
+ * users supply their own to build custom generators.
+ */
+export interface GeneratorDefinition {
+  readonly name: string;
+  readonly printer: AbstractPrinter;
+  /** Custom walker. Defaults to the built-in JsonSchemaWalker. */
+  readonly walker?: AbstractWalker;
+  /** Custom input doc-id → output subpath mapping. Default mirrors input structure. */
+  readonly mapOutput?: (docId: string) => string;
+}
+/** User-facing top-level config for the API and the config file. */
+export interface GenerateConfig {
+  readonly input: string | string[];
+  readonly output: string;
+  readonly targets: TargetSpec[];
+  readonly options?: Partial<GenerateOptions>;
+  readonly clean?: boolean;
+  readonly dryRun?: boolean;
+  readonly verbose?: boolean;
+}
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/dist/core/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/core/types.ts"],"mappings":";;;;iBAIiB;;WAEP;;WAEA;;WAEA;;;iBAIO;;WAEP;WACA;;YAGE;;iBAGK;WACP;WACA;;;YAIE;;iBAYK;WACP,iBAAiB;WACjB;;WAEA,aAAa;;WAEb;;WAEA,QAAQ;;WAER;;qBAGG,iBAAiB;;iBAUb,wBAAwB;;WAE/B;;WAEA;;YAGE;;YAGA,aAAa,aAAa;;;;;iBAMrB;WACP;WACA,SAAS;;WAET,SAAS;;WAET,aAAa;;;iBAIN;WACP;WACA;WACA,SAAS;WACT,UAAU,QAAQ;WAClB;WACA;WACA"}

package/dist/core/types.mjs

@@ -0,0 +1,27 @@
+//#region src/core/types.ts
+const NAMING_STYLES = [
+	"origin",
+	"camel",
+	"pascal"
+];
+/**
+* Template of the `@generated` header prepended to every written file.
+* Supported placeholders: `{{version}}` (generator version), `{{date}}` (generation date, YYYY-MM-DD).
+* `false` disables the header entirely.
+*/
+const DEFAULT_HEADER_TEMPLATE = "// @generated by json2code v{{version}} — DO NOT EDIT";
+const DEFAULT_OPTIONS = {
+	importExtension: "js",
+	readonlyArrays: false,
+	importPaths: {
+		zod: "zod",
+		valibot: "valibot"
+	},
+	defaults: true,
+	naming: "pascal",
+	header: DEFAULT_HEADER_TEMPLATE
+};
+//#endregion
+export { DEFAULT_HEADER_TEMPLATE, DEFAULT_OPTIONS, NAMING_STYLES };
+
+//# sourceMappingURL=types.mjs.map

package/dist/core/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/core/types.ts"],"sourcesContent":["import type { AbstractPrinter } from \"./printer/abstract.js\";\nimport type { AbstractWalker } from \"./walker/abstract.js\";\n\n/** A discovered input schema file. */\nexport interface SchemaFile {\n\t/** Absolute path on disk. */\n\treadonly path: string;\n\t/** Normalized document id (posix, relative to the input root). */\n\treadonly docId: string;\n\t/** Raw JSON text. */\n\treadonly content: string;\n}\n\n/** A file produced by a Printer. */\nexport interface PrintedFile {\n\t/** Path relative to the target's output root. */\n\treadonly path: string;\n\treadonly content: string;\n}\n\nexport type ImportExtension = \"js\" | \"ts\" | \"none\";\n\n/** Import specifiers per validator target. */\nexport interface ImportPaths {\n\treadonly zod?: string;\n\treadonly valibot?: string;\n}\n\n/** Style applied to exported type/schema names. */\nexport type NamingStyle = \"origin\" | \"camel\" | \"pascal\";\n\nexport const NAMING_STYLES: readonly NamingStyle[] = [\"origin\", \"camel\", \"pascal\"];\n\n/**\n * Template of the `@generated` header prepended to every written file.\n * Supported placeholders: `{{version}}` (generator version), `{{date}}` (generation date, YYYY-MM-DD).\n * `false` disables the header entirely.\n */\nexport const DEFAULT_HEADER_TEMPLATE = \"// @generated by json2code v{{version}} — DO NOT EDIT\";\n\n/** User-tunable codegen options (with defaults). */\nexport interface GenerateOptions {\n\treadonly importExtension: ImportExtension;\n\treadonly readonlyArrays: boolean;\n\t/** Import specifiers per validator target (default: the package name). */\n\treadonly importPaths: ImportPaths;\n\t/** Apply JSON Schema `default` in validator targets. */\n\treadonly defaults: boolean;\n\t/** Export name style (default: `pascal`). */\n\treadonly naming: NamingStyle;\n\t/** File header template; `false` disables it. */\n\treadonly header: string | false;\n}\n\nexport const DEFAULT_OPTIONS: GenerateOptions = {\n\timportExtension: \"js\",\n\treadonlyArrays: false,\n\timportPaths: { zod: \"zod\", valibot: \"valibot\" },\n\tdefaults: true,\n\tnaming: \"pascal\",\n\theader: DEFAULT_HEADER_TEMPLATE,\n};\n\n/** Resolved options (paths made absolute). Passed through contexts. */\nexport interface ResolvedOptions extends GenerateOptions {\n\t/** Absolute output directory. */\n\treadonly output: string;\n\t/** Absolute common input root (used to compute doc ids). */\n\treadonly rootDir: string;\n}\n\nexport type TargetName = \"typescript\" | \"zod\" | \"valibot\";\n\n/** Either a built-in preset name or a fully custom generator definition. */\nexport type TargetSpec = TargetName | GeneratorDefinition;\n\n/**\n * Defines a target generator. Built-in targets are preset instances of this;\n * users supply their own to build custom generators.\n */\nexport interface GeneratorDefinition {\n\treadonly name: string;\n\treadonly printer: AbstractPrinter;\n\t/** Custom walker. Defaults to the built-in JsonSchemaWalker. */\n\treadonly walker?: AbstractWalker;\n\t/** Custom input doc-id → output subpath mapping. Default mirrors input structure. */\n\treadonly mapOutput?: (docId: string) => string;\n}\n\n/** User-facing top-level config for the API and the config file. */\nexport interface GenerateConfig {\n\treadonly input: string | string[];\n\treadonly output: string;\n\treadonly targets: TargetSpec[];\n\treadonly options?: Partial<GenerateOptions>;\n\treadonly clean?: boolean;\n\treadonly dryRun?: boolean;\n\treadonly verbose?: boolean;\n}\n"],"mappings":";AA+BA,MAAa,gBAAwC;CAAC;CAAU;CAAS;AAAQ;;;;;;AAOjF,MAAa,0BAA0B;AAgBvC,MAAa,kBAAmC;CAC/C,iBAAiB;CACjB,gBAAgB;CAChB,aAAa;EAAE,KAAK;EAAO,SAAS;CAAU;CAC9C,UAAU;CACV,QAAQ;CACR,QAAQ;AACT"}

package/dist/core/walker/abstract.d.mts

@@ -0,0 +1,18 @@
+import { Diagnostic } from "../../diagnostics/errors.mjs";
+import { Logger } from "../../diagnostics/logger.mjs";
+import { SourceDoc } from "../ir/types.mjs";
+import { ResolvedOptions, SchemaFile } from "../types.mjs";
+//#region src/core/walker/abstract.d.ts
+export interface WalkerContext {
+  readonly logger: Logger;
+  readonly options: ResolvedOptions;
+  /** Sink for structured diagnostics produced during the walk. */
+  readonly diagnostics: Diagnostic[];
+}
+/** Traverses input schema files and produces normalized IR documents. */
+export interface AbstractWalker {
+  readonly name: string;
+  walk(files: readonly SchemaFile[], ctx: WalkerContext): Promise<SourceDoc[]>;
+}
+//#endregion
+//# sourceMappingURL=abstract.d.mts.map

package/dist/core/walker/abstract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.mts","names":[],"sources":["../../../src/core/walker/abstract.ts"],"mappings":";;;;;iBAKiB;WACP,QAAQ;WACR,SAAS;;WAET,aAAa;;;iBAIN;WACP;EACT,KAAK,gBAAgB,cAAc,KAAK,gBAAgB,QAAQ"}

package/dist/core/walker/json-schema.d.mts

@@ -0,0 +1,10 @@
+import { SourceDoc } from "../ir/types.mjs";
+import { AbstractWalker, WalkerContext } from "./abstract.mjs";
+import { SchemaFile } from "../types.mjs";
+//#region src/core/walker/json-schema.d.ts
+export declare class JsonSchemaWalker implements AbstractWalker {
+  readonly name = "json-schema";
+  walk(files: readonly SchemaFile[], ctx: WalkerContext): Promise<SourceDoc[]>;
+}
+//#endregion
+//# sourceMappingURL=json-schema.d.mts.map

package/dist/core/walker/json-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.mts","names":[],"sources":["../../../src/core/walker/json-schema.ts"],"mappings":";;;;qBA6Ca,4BAA4B;WACxB;EAEhB,KAAkB,gBAAgB,cAAc,KAAK,gBAAgB,QAAQ"}