@pajecawav/json2code 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pajecawav
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,181 @@
-# Temporary Holding Version
+# json2code
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Generate TypeScript code from JSON Schema — type aliases for the `typescript` target, [zod v4](https://zod.dev) schemas for the `zod` target, [valibot v1](https://valibot.dev) schemas for the `valibot` target. One pass, multiple targets, deterministic output.
+
+- **Mirror layout** — `schemas/user.json` → `src/generated/typescript/user.ts`, imports between files resolved from `$ref`
+- **Cycles without topological sort** — recursive schemas work in every target (`z.lazy` / `v.lazy` with SCC analysis)
+- **Standard Schema** — the `zod` and `valibot` targets emit schemas that implement the [Standard Schema](https://standardschema.dev) interface
+- **Extensible** — bring your own walker (any source format) and printer (any output layout) via `defineGenerator`
+
+## Install
+
+```sh
+pnpm add -D json2code
+```
+
+## Quickstart
+
+```
+project/
+├── schemas/
+│   ├── common.json
+│   └── user.json      # { "$ref": "common.json#/$defs/Id" } …
+└── json2code.config.ts
+```
+
+```ts
+// json2code.config.ts
+import { defineConfig } from "json2code";
+
+export default defineConfig({
+    input: ["schemas"],
+    output: "src/generated",
+    targets: ["typescript", "zod"],
+});
+```
+
+```sh
+json2code            # uses the config file
+json2code schemas -o src/generated -t typescript,zod,valibot   # or all via flags
+```
+
+```ts
+// src/generated/zod/user.ts (excerpt)
+import { z } from "zod";
+import { Id } from "./common.js";
+
+export const User = z.object({ id: Id, email: z.email().optional() });
+export type User = z.infer<typeof User>;
+```
+
+## CLI
+
+```
+json2code [input...] -o <dir> [flags]
+```
+
+| Flag                           | Description                                                                           |
+| ------------------------------ | ------------------------------------------------------------------------------------- |
+| `[input...]`                   | Globs and/or folders (default: `schemas/**/*.json`)                                   |
+| `-o, --output <dir>`           | Output directory                                                                      |
+| `-t, --target <list>`          | Comma-separated targets: `typescript`, `zod`, `valibot` (default: `typescript`)       |
+| `--config <path>`              | Config file path (default: `json2code.config.*` in cwd)                               |
+| `--import-extension <ext>`     | Extension in relative imports: `js` \| `ts` \| `none` (default: `js`)                 |
+| `--readonly-arrays`            | Emit `readonly T[]` in the typescript target                                          |
+| `--naming <style>`             | Export name style: `origin` \| `camel` \| `pascal` (default: `pascal`)                |
+| `--export-suffix <str>`        | Literal appended to every export name, after the naming style (e.g. `Schema`)         |
+| `--header <template>`          | Header template with `{{version}}` / `{{date}}` placeholders (`\n` escapes a newline) |
+| `--no-header`                  | Don't emit the file header                                                            |
+| `--zod-import-path <spec>`     | Import specifier for zod in the zod target (default: `zod`)                           |
+| `--valibot-import-path <spec>` | Import specifier for valibot in the valibot target (default: `valibot`)               |
+| `--no-defaults`                | Don't apply JSON Schema `default` in validator targets                                |
+| `--dry-run`                    | Print the plan, write nothing                                                         |
+| `--clean`                      | Remove stale `@generated` files from previous runs                                    |
+| `-V, --verbose`                | Verbose logging                                                                       |
+
+CLI flags override values from the config file.
+
+Objects render multi-line with JSDoc comments derived from JSON Schema descriptions:
+
+```ts
+export type User = {
+    /** Unique identifier */
+    id: string;
+    email?: string;
+};
+```
+
+## API
+
+```ts
+import { generate } from "json2code";
+
+await generate({
+    input: ["schemas/**/*.json"],
+    output: "src/generated",
+    targets: ["typescript", "zod"],
+    options: {
+        importExtension: "js",
+        readonlyArrays: false,
+        importPaths: { zod: "zod", valibot: "valibot" },
+        defaults: true,
+        naming: "pascal", // or "origin" / "camel"
+        exportSuffix: "", // e.g. "Schema" → export const UserSchema = ...
+        header: "// generated by json2code v{{version}} on {{date}}", // or false
+    },
+    clean: true,
+});
+```
+
+Returns `{ written, deleted, diagnostics }`. Generation is deterministic: identical input produces byte-identical output, so checking generated code into VCS is diff-friendly. (The built-in `{{date}}` header placeholder is the one exception — it changes per day.)
+
+## Custom generators
+
+A target is a walker (source → IR) plus a printer (IR → code). Both are replaceable:
+
+```ts
+import { defineGenerator, generate } from "json2code";
+
+const bundle = defineGenerator({
+    name: "bundle",
+    // optional; default — JsonSchemaWalker
+    walker: {
+        name: "my-walker",
+        async walk(files, ctx) {
+            return files.map(f => ({
+                docId: f.docId,
+                sourcePath: f.path,
+                exports: new Map([["Stub", { kind: "unknown" }]]),
+                exportOrder: ["Stub"],
+                rootExportName: "Stub",
+            }));
+        },
+    },
+    // required; receives ALL docs at once so cross-file logic is possible
+    printer: {
+        name: "bundle-printer",
+        async print(docs, ctx) {
+            return [
+                {
+                    path: "bundle/all.ts",
+                    content: docs
+                        .flatMap(d => d.exportOrder.map(n => `export type ${n} = unknown;`))
+                        .join("\n"),
+                },
+            ];
+        },
+    },
+    // optional; default — mirror the input structure under `<name>/`
+    mapOutput: docId => `bundle/${docId}`,
+});
+
+await generate({ input: ["schemas"], output: "out", targets: [bundle] });
+```
+
+Contracts (`AbstractWalker`, `AbstractPrinter`, IR types) are exported from the package root. Until v1.0 they may change with a minor bump.
+
+## Diagnostics
+
+Errors are aggregated across files and reported with context: `[file] → [$ref] → reason`.
+
+| Code                  | Meaning                                              |
+| --------------------- | ---------------------------------------------------- |
+| `J2C_FILE_NOT_FOUND`  | No input files matched                               |
+| `J2C_INVALID_JSON`    | Schema is not valid JSON                             |
+| `J2C_INVALID_REF`     | `$ref` target does not exist                         |
+| `J2C_EXTERNAL_REF`    | External/URL refs are not supported                  |
+| `J2C_NAME_COLLISION`  | Two files map to the same export name                |
+| `J2C_UNKNOWN_KEYWORD` | Unsupported keyword → mapped to `unknown` + warning  |
+| `J2C_OUTPUT_DIRTY`    | Output contains non-generated files blocking a write |
+
+## Development
+
+```sh
+pnpm build       # tsdown → dist/
+pnpm test        # vitest
+pnpm lint        # tsc + oxlint + prettier + publint
+```
+
+## License
+
+MIT

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,131 @@
+#!/usr/bin/env node
+import { Json2CodeError } from "./diagnostics/errors.mjs";
+import { NAMING_STYLES } from "./core/types.mjs";
+import { version } from "./package.mjs";
+import { generate } from "./core/generate.mjs";
+import { loadFileConfig } from "./core/config.mjs";
+import { defineCommand, runMain } from "citty";
+//#region src/cli.ts
+const command = defineCommand({
+	meta: {
+		name: "json2code",
+		version,
+		description: "Generate TypeScript code from JSON Schema."
+	},
+	args: {
+		output: {
+			type: "string",
+			alias: "o",
+			description: "Output directory"
+		},
+		target: {
+			type: "string",
+			alias: "t",
+			description: "Target(s), comma-separated (typescript,zod,valibot)"
+		},
+		config: {
+			type: "string",
+			description: "Path to config file (default: json2code.config.* in cwd)"
+		},
+		"import-extension": {
+			type: "string",
+			description: "Import extension: js|ts|none"
+		},
+		"readonly-arrays": {
+			type: "boolean",
+			description: "Emit readonly arrays"
+		},
+		"zod-import-path": {
+			type: "string",
+			description: "Zod import specifier"
+		},
+		"valibot-import-path": {
+			type: "string",
+			description: "Valibot import specifier"
+		},
+		"no-defaults": {
+			type: "boolean",
+			description: "Don't apply JSON Schema `default` in validator targets"
+		},
+		naming: {
+			type: "string",
+			description: `Export name style: ${NAMING_STYLES.join("|")} (default: pascal)`
+		},
+		"export-suffix": {
+			type: "string",
+			description: "Literal appended to every export name (e.g. Schema → UsersUserSchema)"
+		},
+		header: {
+			type: "string",
+			description: "Header template ({{version}}, {{date}} placeholders, \"\\n\" for newlines); empty disables"
+		},
+		"no-header": {
+			type: "boolean",
+			description: "Omit the file header"
+		},
+		"dry-run": {
+			type: "boolean",
+			description: "Don't write, show the plan"
+		},
+		clean: {
+			type: "boolean",
+			description: "Remove stale generated files"
+		},
+		verbose: {
+			type: "boolean",
+			alias: "V",
+			description: "Verbose logging"
+		}
+	},
+	async run({ args }) {
+		const { config: file } = await loadFileConfig(args.config);
+		const input = args._.length > 0 ? [...args._] : file.input ? [...file.input] : ["schemas/**/*.json"];
+		const output = args.output ?? file.output;
+		if (!output) {
+			console.error("error: missing output directory (-o or `output` in the config file)");
+			process.exit(1);
+		}
+		const targets = args.target ? args.target.split(",").map((s) => s.trim()).filter(Boolean) : file.targets ?? ["typescript"];
+		const namingArg = args.naming ?? file.options?.naming;
+		if (namingArg !== void 0 && !NAMING_STYLES.includes(namingArg)) {
+			console.error(`error: invalid naming style "${namingArg}" (expected one of: ${NAMING_STYLES.join(", ")})`);
+			process.exit(1);
+		}
+		const rawHeader = args.header;
+		const headerArg = rawHeader === false || args["no-header"] === true ? false : typeof rawHeader === "string" ? rawHeader.replaceAll("\\n", "\n") : file.options?.header;
+		const config = {
+			input,
+			output,
+			targets,
+			options: {
+				importExtension: args["import-extension"] ?? file.options?.importExtension,
+				readonlyArrays: args["readonly-arrays"] ?? file.options?.readonlyArrays,
+				importPaths: {
+					...file.options?.importPaths,
+					...args["zod-import-path"] ? { zod: args["zod-import-path"] } : {},
+					...args["valibot-import-path"] ? { valibot: args["valibot-import-path"] } : {}
+				},
+				defaults: !(args["no-defaults"] ?? false) && (file.options?.defaults ?? true),
+				naming: namingArg,
+				exportSuffix: args["export-suffix"] ?? file.options?.exportSuffix,
+				header: headerArg
+			},
+			clean: args.clean ?? file.clean,
+			dryRun: args["dry-run"] ?? file.dryRun,
+			verbose: args.verbose ?? file.verbose
+		};
+		try {
+			await generate(config);
+			process.exit(0);
+		} catch (e) {
+			if (e instanceof Json2CodeError) process.exit(1);
+			console.error(e);
+			process.exit(1);
+		}
+	}
+});
+await runMain(command);
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["pkg.version"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { defineCommand, runMain } from \"citty\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport { loadFileConfig } from \"./core/config.js\";\nimport { generate } from \"./core/generate.js\";\nimport type { GenerateConfig, ImportExtension, NamingStyle, TargetName } from \"./core/types.js\";\nimport { NAMING_STYLES } from \"./core/types.js\";\nimport { Json2CodeError } from \"./diagnostics/errors.js\";\n\nconst command = defineCommand({\n\tmeta: {\n\t\tname: \"json2code\",\n\t\tversion: pkg.version,\n\t\tdescription: \"Generate TypeScript code from JSON Schema.\",\n\t},\n\targs: {\n\t\toutput: { type: \"string\", alias: \"o\", description: \"Output directory\" },\n\t\ttarget: {\n\t\t\ttype: \"string\",\n\t\t\talias: \"t\",\n\t\t\tdescription: \"Target(s), comma-separated (typescript,zod,valibot)\",\n\t\t},\n\t\tconfig: {\n\t\t\ttype: \"string\",\n\t\t\tdescription: \"Path to config file (default: json2code.config.* in cwd)\",\n\t\t},\n\t\t\"import-extension\": {\n\t\t\ttype: \"string\",\n\t\t\tdescription: \"Import extension: js|ts|none\",\n\t\t},\n\t\t\"readonly-arrays\": { type: \"boolean\", description: \"Emit readonly arrays\" },\n\t\t\"zod-import-path\": { type: \"string\", description: \"Zod import specifier\" },\n\t\t\"valibot-import-path\": { type: \"string\", description: \"Valibot import specifier\" },\n\t\t\"no-defaults\": {\n\t\t\ttype: \"boolean\",\n\t\t\tdescription: \"Don't apply JSON Schema `default` in validator targets\",\n\t\t},\n\t\tnaming: {\n\t\t\ttype: \"string\",\n\t\t\tdescription: `Export name style: ${NAMING_STYLES.join(\"|\")} (default: pascal)`,\n\t\t},\n\t\t\"export-suffix\": {\n\t\t\ttype: \"string\",\n\t\t\tdescription: \"Literal appended to every export name (e.g. Schema → UsersUserSchema)\",\n\t\t},\n\t\theader: {\n\t\t\ttype: \"string\",\n\t\t\tdescription:\n\t\t\t\t'Header template ({{version}}, {{date}} placeholders, \"\\\\n\" for newlines); empty disables',\n\t\t},\n\t\t\"no-header\": { type: \"boolean\", description: \"Omit the file header\" },\n\t\t\"dry-run\": { type: \"boolean\", description: \"Don't write, show the plan\" },\n\t\tclean: { type: \"boolean\", description: \"Remove stale generated files\" },\n\t\tverbose: { type: \"boolean\", alias: \"V\", description: \"Verbose logging\" },\n\t},\n\tasync run({ args }) {\n\t\tconst { config: file } = await loadFileConfig(args.config);\n\t\tconst input =\n\t\t\targs._.length > 0 ? [...args._] : file.input ? [...file.input] : [\"schemas/**/*.json\"];\n\t\tconst output = args.output ?? file.output;\n\t\tif (!output) {\n\t\t\tconsole.error(\"error: missing output directory (-o or `output` in the config file)\");\n\t\t\tprocess.exit(1);\n\t\t}\n\t\tconst targets = (\n\t\t\targs.target\n\t\t\t\t? args.target\n\t\t\t\t\t\t.split(\",\")\n\t\t\t\t\t\t.map(s => s.trim())\n\t\t\t\t\t\t.filter(Boolean)\n\t\t\t\t: (file.targets ?? [\"typescript\"])\n\t\t) as TargetName[];\n\t\tconst namingArg = (args.naming as NamingStyle | undefined) ?? file.options?.naming;\n\t\tif (namingArg !== undefined && !NAMING_STYLES.includes(namingArg)) {\n\t\t\tconsole.error(\n\t\t\t\t`error: invalid naming style \"${namingArg}\" (expected one of: ${NAMING_STYLES.join(\", \")})`,\n\t\t\t);\n\t\t\tprocess.exit(1);\n\t\t}\n\t\t// citty maps `--no-header` to `header === false`; `--header <text>` gives a string\n\t\tconst rawHeader = args.header as string | boolean | undefined;\n\t\tconst headerArg =\n\t\t\trawHeader === false || args[\"no-header\"] === true\n\t\t\t\t? false\n\t\t\t\t: typeof rawHeader === \"string\"\n\t\t\t\t\t? rawHeader.replaceAll(\"\\\\n\", \"\\n\")\n\t\t\t\t\t: file.options?.header;\n\t\tconst config: GenerateConfig = {\n\t\t\tinput,\n\t\t\toutput,\n\t\t\ttargets,\n\t\t\toptions: {\n\t\t\t\timportExtension:\n\t\t\t\t\t(args[\"import-extension\"] as ImportExtension | undefined) ??\n\t\t\t\t\tfile.options?.importExtension,\n\t\t\t\treadonlyArrays: args[\"readonly-arrays\"] ?? file.options?.readonlyArrays,\n\t\t\t\timportPaths: {\n\t\t\t\t\t...file.options?.importPaths,\n\t\t\t\t\t...(args[\"zod-import-path\"] ? { zod: args[\"zod-import-path\"] } : {}),\n\t\t\t\t\t...(args[\"valibot-import-path\"]\n\t\t\t\t\t\t? { valibot: args[\"valibot-import-path\"] }\n\t\t\t\t\t\t: {}),\n\t\t\t\t},\n\t\t\t\tdefaults: !(args[\"no-defaults\"] ?? false) && (file.options?.defaults ?? true),\n\t\t\t\tnaming: namingArg,\n\t\t\t\texportSuffix: args[\"export-suffix\"] ?? file.options?.exportSuffix,\n\t\t\t\theader: headerArg,\n\t\t\t},\n\t\t\tclean: args.clean ?? file.clean,\n\t\t\tdryRun: args[\"dry-run\"] ?? file.dryRun,\n\t\t\tverbose: args.verbose ?? file.verbose,\n\t\t};\n\t\ttry {\n\t\t\tawait generate(config);\n\t\t\tprocess.exit(0);\n\t\t} catch (e) {\n\t\t\tif (e instanceof Json2CodeError) {\n\t\t\t\tprocess.exit(1);\n\t\t\t}\n\t\t\tconsole.error(e);\n\t\t\tprocess.exit(1);\n\t\t}\n\t},\n});\n\nawait runMain(command);\n"],"mappings":";;;;;;;;AASA,MAAM,UAAU,cAAc;CAC7B,MAAM;EACL,MAAM;EACGA;EACT,aAAa;CACd;CACA,MAAM;EACL,QAAQ;GAAE,MAAM;GAAU,OAAO;GAAK,aAAa;EAAmB;EACtE,QAAQ;GACP,MAAM;GACN,OAAO;GACP,aAAa;EACd;EACA,QAAQ;GACP,MAAM;GACN,aAAa;EACd;EACA,oBAAoB;GACnB,MAAM;GACN,aAAa;EACd;EACA,mBAAmB;GAAE,MAAM;GAAW,aAAa;EAAuB;EAC1E,mBAAmB;GAAE,MAAM;GAAU,aAAa;EAAuB;EACzE,uBAAuB;GAAE,MAAM;GAAU,aAAa;EAA2B;EACjF,eAAe;GACd,MAAM;GACN,aAAa;EACd;EACA,QAAQ;GACP,MAAM;GACN,aAAa,sBAAsB,cAAc,KAAK,GAAG,EAAE;EAC5D;EACA,iBAAiB;GAChB,MAAM;GACN,aAAa;EACd;EACA,QAAQ;GACP,MAAM;GACN,aACC;EACF;EACA,aAAa;GAAE,MAAM;GAAW,aAAa;EAAuB;EACpE,WAAW;GAAE,MAAM;GAAW,aAAa;EAA6B;EACxE,OAAO;GAAE,MAAM;GAAW,aAAa;EAA+B;EACtE,SAAS;GAAE,MAAM;GAAW,OAAO;GAAK,aAAa;EAAkB;CACxE;CACA,MAAM,IAAI,EAAE,QAAQ;EACnB,MAAM,EAAE,QAAQ,SAAS,MAAM,eAAe,KAAK,MAAM;EACzD,MAAM,QACL,KAAK,EAAE,SAAS,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC,mBAAmB;EACtF,MAAM,SAAS,KAAK,UAAU,KAAK;EACnC,IAAI,CAAC,QAAQ;GACZ,QAAQ,MAAM,qEAAqE;GACnF,QAAQ,KAAK,CAAC;EACf;EACA,MAAM,UACL,KAAK,SACF,KAAK,OACJ,MAAM,GAAG,CAAC,CACV,KAAI,MAAK,EAAE,KAAK,CAAC,CAAC,CAClB,OAAO,OAAO,IACd,KAAK,WAAW,CAAC,YAAY;EAElC,MAAM,YAAa,KAAK,UAAsC,KAAK,SAAS;EAC5E,IAAI,cAAc,KAAA,KAAa,CAAC,cAAc,SAAS,SAAS,GAAG;GAClE,QAAQ,MACP,gCAAgC,UAAU,sBAAsB,cAAc,KAAK,IAAI,EAAE,EAC1F;GACA,QAAQ,KAAK,CAAC;EACf;EAEA,MAAM,YAAY,KAAK;EACvB,MAAM,YACL,cAAc,SAAS,KAAK,iBAAiB,OAC1C,QACA,OAAO,cAAc,WACpB,UAAU,WAAW,OAAO,IAAI,IAChC,KAAK,SAAS;EACnB,MAAM,SAAyB;GAC9B;GACA;GACA;GACA,SAAS;IACR,iBACE,KAAK,uBACN,KAAK,SAAS;IACf,gBAAgB,KAAK,sBAAsB,KAAK,SAAS;IACzD,aAAa;KACZ,GAAG,KAAK,SAAS;KACjB,GAAI,KAAK,qBAAqB,EAAE,KAAK,KAAK,mBAAmB,IAAI,CAAC;KAClE,GAAI,KAAK,yBACN,EAAE,SAAS,KAAK,uBAAuB,IACvC,CAAC;IACL;IACA,UAAU,EAAE,KAAK,kBAAkB,WAAW,KAAK,SAAS,YAAY;IACxE,QAAQ;IACR,cAAc,KAAK,oBAAoB,KAAK,SAAS;IACrD,QAAQ;GACT;GACA,OAAO,KAAK,SAAS,KAAK;GAC1B,QAAQ,KAAK,cAAc,KAAK;GAChC,SAAS,KAAK,WAAW,KAAK;EAC/B;EACA,IAAI;GACH,MAAM,SAAS,MAAM;GACrB,QAAQ,KAAK,CAAC;EACf,SAAS,GAAG;GACX,IAAI,aAAa,gBAChB,QAAQ,KAAK,CAAC;GAEf,QAAQ,MAAM,CAAC;GACf,QAAQ,KAAK,CAAC;EACf;CACD;AACD,CAAC;AAED,MAAM,QAAQ,OAAO"}

package/dist/core/config.mjs

@@ -0,0 +1,53 @@
+import path from "node:path";
+import { access, constants } from "node:fs/promises";
+import process from "node:process";
+import { createJiti } from "jiti";
+//#region src/core/config.ts
+const CONFIG_CANDIDATES = [
+	"json2code.config.ts",
+	"json2code.config.mts",
+	"json2code.config.js",
+	"json2code.config.mjs",
+	"json2code.config.json"
+];
+/**
+* Load the config file: `explicitPath` if given, otherwise the first
+* `json2code.config.{ts,mts,js,mjs,json}` found in `cwd`. Returns an empty
+* config when nothing is found.
+*/
+async function loadFileConfig(explicitPath, cwd = process.cwd()) {
+	const jiti = createJiti(import.meta.url);
+	if (explicitPath) {
+		const file = path.resolve(cwd, explicitPath);
+		return {
+			config: await readConfig(jiti, file),
+			path: file
+		};
+	}
+	for (const name of CONFIG_CANDIDATES) {
+		const file = path.resolve(cwd, name);
+		if (await accessible(file)) return {
+			config: await readConfig(jiti, file),
+			path: file
+		};
+	}
+	return { config: {} };
+}
+async function accessible(file) {
+	try {
+		await access(file, constants.R_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function readConfig(jiti, file) {
+	const mod = await jiti.import(file);
+	const raw = typeof mod === "object" && mod !== null && "default" in mod ? mod.default : mod;
+	if (typeof raw !== "object" || raw === null) throw new TypeError(`Config file ${path.basename(file)} must export a config object.`);
+	return raw;
+}
+//#endregion
+export { loadFileConfig };
+
+//# sourceMappingURL=config.mjs.map

package/dist/core/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/core/config.ts"],"sourcesContent":["import { access, constants } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { createJiti } from \"jiti\";\nimport type { GenerateOptions, TargetSpec } from \"./types.js\";\n\n/** Everything a `json2code.config.*` file may set. All fields optional. */\nexport interface FileConfig {\n\treadonly input?: readonly string[];\n\treadonly output?: string;\n\treadonly targets?: readonly TargetSpec[];\n\treadonly options?: Partial<GenerateOptions>;\n\treadonly clean?: boolean;\n\treadonly dryRun?: boolean;\n\treadonly verbose?: boolean;\n}\n\nconst CONFIG_CANDIDATES = [\n\t\"json2code.config.ts\",\n\t\"json2code.config.mts\",\n\t\"json2code.config.js\",\n\t\"json2code.config.mjs\",\n\t\"json2code.config.json\",\n] as const;\n\n/**\n * Load the config file: `explicitPath` if given, otherwise the first\n * `json2code.config.{ts,mts,js,mjs,json}` found in `cwd`. Returns an empty\n * config when nothing is found.\n */\nexport async function loadFileConfig(\n\texplicitPath?: string,\n\tcwd: string = process.cwd(),\n): Promise<{ config: FileConfig; path?: string }> {\n\tconst jiti = createJiti(import.meta.url);\n\tif (explicitPath) {\n\t\tconst file = path.resolve(cwd, explicitPath);\n\t\treturn { config: await readConfig(jiti, file), path: file };\n\t}\n\tfor (const name of CONFIG_CANDIDATES) {\n\t\tconst file = path.resolve(cwd, name);\n\t\tif (await accessible(file)) {\n\t\t\treturn { config: await readConfig(jiti, file), path: file };\n\t\t}\n\t}\n\treturn { config: {} };\n}\n\nasync function accessible(file: string): Promise<boolean> {\n\ttry {\n\t\tawait access(file, constants.R_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function readConfig(jiti: ReturnType<typeof createJiti>, file: string): Promise<FileConfig> {\n\tconst mod: unknown = await jiti.import(file);\n\tconst raw = typeof mod === \"object\" && mod !== null && \"default\" in mod ? mod.default : mod;\n\tif (typeof raw !== \"object\" || raw === null) {\n\t\tthrow new TypeError(`Config file ${path.basename(file)} must export a config object.`);\n\t}\n\treturn raw;\n}\n"],"mappings":";;;;;AAiBA,MAAM,oBAAoB;CACzB;CACA;CACA;CACA;CACA;AACD;;;;;;AAOA,eAAsB,eACrB,cACA,MAAc,QAAQ,IAAI,GACuB;CACjD,MAAM,OAAO,WAAW,YAAY,GAAG;CACvC,IAAI,cAAc;EACjB,MAAM,OAAO,KAAK,QAAQ,KAAK,YAAY;EAC3C,OAAO;GAAE,QAAQ,MAAM,WAAW,MAAM,IAAI;GAAG,MAAM;EAAK;CAC3D;CACA,KAAK,MAAM,QAAQ,mBAAmB;EACrC,MAAM,OAAO,KAAK,QAAQ,KAAK,IAAI;EACnC,IAAI,MAAM,WAAW,IAAI,GACxB,OAAO;GAAE,QAAQ,MAAM,WAAW,MAAM,IAAI;GAAG,MAAM;EAAK;CAE5D;CACA,OAAO,EAAE,QAAQ,CAAC,EAAE;AACrB;AAEA,eAAe,WAAW,MAAgC;CACzD,IAAI;EACH,MAAM,OAAO,MAAM,UAAU,IAAI;EACjC,OAAO;CACR,QAAQ;EACP,OAAO;CACR;AACD;AAEA,eAAe,WAAW,MAAqC,MAAmC;CACjG,MAAM,MAAe,MAAM,KAAK,OAAO,IAAI;CAC3C,MAAM,MAAM,OAAO,QAAQ,YAAY,QAAQ,QAAQ,aAAa,MAAM,IAAI,UAAU;CACxF,IAAI,OAAO,QAAQ,YAAY,QAAQ,MACtC,MAAM,IAAI,UAAU,eAAe,KAAK,SAAS,IAAI,EAAE,8BAA8B;CAEtF,OAAO;AACR"}

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

@@ -0,0 +1,10 @@
+import { Logger } from "../../diagnostics/logger.mjs";
+import { SchemaFile } from "../types.mjs";
+//#region src/core/discovery/index.d.ts
+export interface DiscoveryResult {
+  readonly files: readonly SchemaFile[];
+  readonly rootDir: string;
+}
+export declare function discover(input: string | string[], cwd: string, logger: Logger): Promise<DiscoveryResult>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/discovery/index.ts"],"mappings":";;;iBASiB;WACP,gBAAgB;WAChB;;wBAGY,SACrB,0BACA,aACA,QAAQ,SACN,QAAQ"}

package/dist/core/discovery/index.mjs

@@ -0,0 +1,83 @@
+import { DiagnosticCode, Json2CodeError, createDiagnostic } from "../../diagnostics/errors.mjs";
+import path from "node:path";
+import { readFile, stat } from "node:fs/promises";
+import fg from "fast-glob";
+//#region src/core/discovery/index.ts
+const GLOB_CHARS = /[*?[\]{}]/;
+async function discover(input, cwd, logger) {
+	const entries = Array.isArray(input) ? input : [input];
+	const matched = [];
+	for (const entry of entries) matched.push(...await expandInput(entry, cwd));
+	const unique = [...new Set(matched)].toSorted();
+	if (unique.length === 0) throw new Json2CodeError([createDiagnostic(DiagnosticCode.FileNotFound, "error", `No JSON Schema files matched input: ${entries.join(", ")}`)]);
+	const rootDir = commonDir(unique);
+	logger.debug(`discovery rootDir=${rootDir}, ${unique.length} files`);
+	const files = [];
+	for (const abs of unique) {
+		const docId = toDocId(abs, rootDir);
+		const content = await readFile(abs, "utf8");
+		files.push({
+			path: abs,
+			docId,
+			content
+		});
+	}
+	return {
+		files,
+		rootDir
+	};
+}
+async function expandInput(entry, cwd) {
+	const abs = path.resolve(cwd, entry);
+	if (!GLOB_CHARS.test(entry)) {
+		const kind = await pathKind(abs);
+		if (kind === "dir") return fg("**/*.json", {
+			cwd: abs,
+			absolute: true,
+			onlyFiles: true,
+			ignore: ["**/node_modules/**"]
+		});
+		if (kind === "file") return [abs];
+		return [];
+	}
+	return fg(entry, {
+		cwd,
+		absolute: true,
+		onlyFiles: true,
+		ignore: ["**/node_modules/**"]
+	});
+}
+async function pathKind(p) {
+	try {
+		const s = await stat(p);
+		return s.isFile() ? "file" : s.isDirectory() ? "dir" : "missing";
+	} catch {
+		return "missing";
+	}
+}
+/** Longest common directory of a set of absolute paths. */
+function commonDir(paths) {
+	const dirs = paths.map((p) => path.dirname(p).split(path.sep));
+	const first = dirs[0];
+	let i = 0;
+	while (i < first.length) {
+		const seg = first[i];
+		if (seg === void 0) break;
+		let ok = true;
+		for (let j = 1; j < dirs.length; j++) if (dirs[j][i] !== seg) {
+			ok = false;
+			break;
+		}
+		if (!ok) break;
+		i++;
+	}
+	const common = first.slice(0, i).join(path.sep);
+	return common === "" ? path.sep : common;
+}
+function toDocId(absPath, rootDir) {
+	return path.relative(rootDir, absPath).split(path.sep).join("/");
+}
+//#endregion
+export { discover };
+
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/discovery/index.ts"],"sourcesContent":["import { readFile, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport { createDiagnostic, DiagnosticCode, Json2CodeError } from \"../../diagnostics/errors.js\";\nimport type { Logger } from \"../../diagnostics/logger.js\";\nimport type { SchemaFile } from \"../types.js\";\n\nconst GLOB_CHARS = /[*?[\\]{}]/;\n\nexport interface DiscoveryResult {\n\treadonly files: readonly SchemaFile[];\n\treadonly rootDir: string;\n}\n\nexport async function discover(\n\tinput: string | string[],\n\tcwd: string,\n\tlogger: Logger,\n): Promise<DiscoveryResult> {\n\tconst entries = Array.isArray(input) ? input : [input];\n\tconst matched: string[] = [];\n\n\tfor (const entry of entries) {\n\t\tmatched.push(...(await expandInput(entry, cwd)));\n\t}\n\n\tconst unique = [...new Set(matched)].toSorted();\n\tif (unique.length === 0) {\n\t\tthrow new Json2CodeError([\n\t\t\tcreateDiagnostic(\n\t\t\t\tDiagnosticCode.FileNotFound,\n\t\t\t\t\"error\",\n\t\t\t\t`No JSON Schema files matched input: ${entries.join(\", \")}`,\n\t\t\t),\n\t\t]);\n\t}\n\n\tconst rootDir = commonDir(unique);\n\tlogger.debug(`discovery rootDir=${rootDir}, ${unique.length} files`);\n\n\tconst files: SchemaFile[] = [];\n\tfor (const abs of unique) {\n\t\tconst docId = toDocId(abs, rootDir);\n\t\tconst content = await readFile(abs, \"utf8\");\n\t\tfiles.push({ path: abs, docId, content });\n\t}\n\treturn { files, rootDir };\n}\n\nasync function expandInput(entry: string, cwd: string): Promise<string[]> {\n\tconst abs = path.resolve(cwd, entry);\n\tconst isGlob = GLOB_CHARS.test(entry);\n\tif (!isGlob) {\n\t\tconst kind = await pathKind(abs);\n\t\tif (kind === \"dir\") {\n\t\t\treturn fg(\"**/*.json\", {\n\t\t\t\tcwd: abs,\n\t\t\t\tabsolute: true,\n\t\t\t\tonlyFiles: true,\n\t\t\t\tignore: [\"**/node_modules/**\"],\n\t\t\t});\n\t\t}\n\t\tif (kind === \"file\") {\n\t\t\treturn [abs];\n\t\t}\n\t\treturn [];\n\t}\n\treturn fg(entry, { cwd, absolute: true, onlyFiles: true, ignore: [\"**/node_modules/**\"] });\n}\n\nasync function pathKind(p: string): Promise<\"file\" | \"dir\" | \"missing\"> {\n\ttry {\n\t\tconst s = await stat(p);\n\t\treturn s.isFile() ? \"file\" : s.isDirectory() ? \"dir\" : \"missing\";\n\t} catch {\n\t\treturn \"missing\";\n\t}\n}\n\n/** Longest common directory of a set of absolute paths. */\nfunction commonDir(paths: readonly string[]): string {\n\tconst dirs = paths.map(p => path.dirname(p).split(path.sep));\n\tconst first = dirs[0]!;\n\tlet i = 0;\n\twhile (i < first.length) {\n\t\tconst seg = first[i];\n\t\tif (seg === undefined) {\n\t\t\tbreak;\n\t\t}\n\t\tlet ok = true;\n\t\tfor (let j = 1; j < dirs.length; j++) {\n\t\t\tif (dirs[j]![i] !== seg) {\n\t\t\t\tok = false;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t\tif (!ok) {\n\t\t\tbreak;\n\t\t}\n\t\ti++;\n\t}\n\tconst common = first.slice(0, i).join(path.sep);\n\treturn common === \"\" ? path.sep : common;\n}\n\nfunction toDocId(absPath: string, rootDir: string): string {\n\tconst rel = path.relative(rootDir, absPath);\n\treturn rel.split(path.sep).join(\"/\");\n}\n"],"mappings":";;;;;AAOA,MAAM,aAAa;AAOnB,eAAsB,SACrB,OACA,KACA,QAC2B;CAC3B,MAAM,UAAU,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;CACrD,MAAM,UAAoB,CAAC;CAE3B,KAAK,MAAM,SAAS,SACnB,QAAQ,KAAK,GAAI,MAAM,YAAY,OAAO,GAAG,CAAE;CAGhD,MAAM,SAAS,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS;CAC9C,IAAI,OAAO,WAAW,GACrB,MAAM,IAAI,eAAe,CACxB,iBACC,eAAe,cACf,SACA,uCAAuC,QAAQ,KAAK,IAAI,GACzD,CACD,CAAC;CAGF,MAAM,UAAU,UAAU,MAAM;CAChC,OAAO,MAAM,qBAAqB,QAAQ,IAAI,OAAO,OAAO,OAAO;CAEnE,MAAM,QAAsB,CAAC;CAC7B,KAAK,MAAM,OAAO,QAAQ;EACzB,MAAM,QAAQ,QAAQ,KAAK,OAAO;EAClC,MAAM,UAAU,MAAM,SAAS,KAAK,MAAM;EAC1C,MAAM,KAAK;GAAE,MAAM;GAAK;GAAO;EAAQ,CAAC;CACzC;CACA,OAAO;EAAE;EAAO;CAAQ;AACzB;AAEA,eAAe,YAAY,OAAe,KAAgC;CACzE,MAAM,MAAM,KAAK,QAAQ,KAAK,KAAK;CAEnC,IAAI,CADW,WAAW,KAAK,KACrB,GAAG;EACZ,MAAM,OAAO,MAAM,SAAS,GAAG;EAC/B,IAAI,SAAS,OACZ,OAAO,GAAG,aAAa;GACtB,KAAK;GACL,UAAU;GACV,WAAW;GACX,QAAQ,CAAC,oBAAoB;EAC9B,CAAC;EAEF,IAAI,SAAS,QACZ,OAAO,CAAC,GAAG;EAEZ,OAAO,CAAC;CACT;CACA,OAAO,GAAG,OAAO;EAAE;EAAK,UAAU;EAAM,WAAW;EAAM,QAAQ,CAAC,oBAAoB;CAAE,CAAC;AAC1F;AAEA,eAAe,SAAS,GAAgD;CACvE,IAAI;EACH,MAAM,IAAI,MAAM,KAAK,CAAC;EACtB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,YAAY,IAAI,QAAQ;CACxD,QAAQ;EACP,OAAO;CACR;AACD;;AAGA,SAAS,UAAU,OAAkC;CACpD,MAAM,OAAO,MAAM,KAAI,MAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC;CAC3D,MAAM,QAAQ,KAAK;CACnB,IAAI,IAAI;CACR,OAAO,IAAI,MAAM,QAAQ;EACxB,MAAM,MAAM,MAAM;EAClB,IAAI,QAAQ,KAAA,GACX;EAED,IAAI,KAAK;EACT,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAChC,IAAI,KAAK,EAAE,CAAE,OAAO,KAAK;GACxB,KAAK;GACL;EACD;EAED,IAAI,CAAC,IACJ;EAED;CACD;CACA,MAAM,SAAS,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG;CAC9C,OAAO,WAAW,KAAK,KAAK,MAAM;AACnC;AAEA,SAAS,QAAQ,SAAiB,SAAyB;CAE1D,OADY,KAAK,SAAS,SAAS,OAC1B,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AACpC"}

package/dist/core/generate.d.mts

@@ -0,0 +1,11 @@
+import { Diagnostic } from "../diagnostics/errors.mjs";
+import { GenerateConfig } from "./types.mjs";
+//#region src/core/generate.d.ts
+export interface GenerateResult {
+  readonly written: readonly string[];
+  readonly deleted: readonly string[];
+  readonly diagnostics: readonly Diagnostic[];
+}
+export declare function generate(config: GenerateConfig): Promise<GenerateResult>;
+//#endregion
+//# sourceMappingURL=generate.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.mts","names":[],"sources":["../../src/core/generate.ts"],"mappings":";;;iBA0BiB;WACP;WACA;WACA,sBAAsB;;wBAKV,SAAS,QAAQ,iBAAiB,QAAQ"}

package/dist/core/generate.mjs

@@ -0,0 +1,89 @@
+import { DiagnosticCode, Json2CodeError, createDiagnostic, formatDiagnostic, partitionDiagnostics } from "../diagnostics/errors.mjs";
+import { createLogger } from "../diagnostics/logger.mjs";
+import { resolveTarget } from "../targets/index.mjs";
+import { discover } from "./discovery/index.mjs";
+import { Linker } from "./linker/index.mjs";
+import { DEFAULT_OPTIONS, NAMING_STYLES } from "./types.mjs";
+import { JsonSchemaWalker } from "./walker/json-schema.mjs";
+import { writeFiles } from "./writer/index.mjs";
+import path from "node:path";
+//#region src/core/generate.ts
+const defaultWalker = new JsonSchemaWalker();
+async function generate(config) {
+	const logger = createLogger(config.verbose ?? false);
+	const cwd = process.cwd();
+	const output = path.resolve(cwd, config.output);
+	const options = mergeOptions(config.options);
+	const allDiagnostics = [];
+	const allFiles = [];
+	const { files, rootDir } = await discover(config.input, cwd, logger);
+	if (files.length === 0) throw new Json2CodeError([createDiagnostic(DiagnosticCode.FileNotFound, "error", "No JSON Schema files matched the input.")]);
+	const resolved = {
+		...options,
+		output,
+		rootDir
+	};
+	const walkCache = /* @__PURE__ */ new Map();
+	for (const spec of normalizeTargets(config.targets)) {
+		const def = resolveTarget(spec);
+		const walker = def.walker ?? defaultWalker;
+		let docsPromise = walkCache.get(walker);
+		if (!docsPromise) {
+			const wctx = {
+				logger,
+				options: resolved,
+				diagnostics: allDiagnostics
+			};
+			docsPromise = walker.walk(files, wctx);
+			walkCache.set(walker, docsPromise);
+		}
+		const docs = await docsPromise;
+		const mapOutput = def.mapOutput ?? ((docId) => Linker.defaultMapOutput(def.name, docId));
+		const pctx = new Linker({
+			options: resolved,
+			targetName: def.name,
+			mapOutput,
+			diagnostics: allDiagnostics
+		}).createPrintContext(logger, allDiagnostics);
+		const printed = await def.printer.print(docs, pctx);
+		for (const f of printed) allFiles.push(f);
+	}
+	const { errors, warnings } = partitionDiagnostics(allDiagnostics);
+	for (const w of warnings) logger.warn(formatDiagnostic(w));
+	if (errors.length > 0) {
+		for (const e of errors) logger.error(formatDiagnostic(e));
+		throw new Json2CodeError(errors);
+	}
+	return {
+		...await writeFiles(allFiles, {
+			output,
+			dryRun: config.dryRun ?? false,
+			clean: config.clean ?? false,
+			logger,
+			header: options.header
+		}),
+		diagnostics: allDiagnostics
+	};
+}
+function normalizeTargets(targets) {
+	return targets.length > 0 ? targets : ["typescript"];
+}
+function mergeOptions(opts) {
+	const naming = opts?.naming ?? DEFAULT_OPTIONS.naming;
+	if (!NAMING_STYLES.includes(naming)) throw new TypeError(`Invalid naming style: ${JSON.stringify(naming)} (expected one of ${NAMING_STYLES.join(", ")})`);
+	const defined = Object.fromEntries(Object.entries(opts ?? {}).filter(([, v]) => v !== void 0));
+	const importPaths = {
+		...DEFAULT_OPTIONS.importPaths,
+		...defined.importPaths
+	};
+	return {
+		...DEFAULT_OPTIONS,
+		...defined,
+		importPaths,
+		naming
+	};
+}
+//#endregion
+export { generate };
+
+//# sourceMappingURL=generate.mjs.map

package/dist/core/generate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.mjs","names":[],"sources":["../../src/core/generate.ts"],"sourcesContent":["import path from \"node:path\";\nimport {\n\tcreateDiagnostic,\n\tDiagnosticCode,\n\tformatDiagnostic,\n\tJson2CodeError,\n\tpartitionDiagnostics,\n\ttype Diagnostic,\n} from \"../diagnostics/errors.js\";\nimport { createLogger } from \"../diagnostics/logger.js\";\nimport { resolveTarget } from \"../targets/index.js\";\nimport { discover } from \"./discovery/index.js\";\nimport type { SourceDoc } from \"./ir/types.js\";\nimport { Linker } from \"./linker/index.js\";\nimport type {\n\tGenerateConfig,\n\tGenerateOptions,\n\tPrintedFile,\n\tResolvedOptions,\n\tTargetSpec,\n} from \"./types.js\";\nimport { DEFAULT_OPTIONS, NAMING_STYLES } from \"./types.js\";\nimport type { AbstractWalker, WalkerContext } from \"./walker/abstract.js\";\nimport { JsonSchemaWalker } from \"./walker/json-schema.js\";\nimport { writeFiles } from \"./writer/index.js\";\n\nexport interface GenerateResult {\n\treadonly written: readonly string[];\n\treadonly deleted: readonly string[];\n\treadonly diagnostics: readonly Diagnostic[];\n}\n\nconst defaultWalker = new JsonSchemaWalker();\n\nexport async function generate(config: GenerateConfig): Promise<GenerateResult> {\n\tconst logger = createLogger(config.verbose ?? false);\n\tconst cwd = process.cwd();\n\tconst output = path.resolve(cwd, config.output);\n\tconst options = mergeOptions(config.options);\n\n\tconst allDiagnostics: Diagnostic[] = [];\n\tconst allFiles: PrintedFile[] = [];\n\n\tconst { files, rootDir } = await discover(config.input, cwd, logger);\n\tif (files.length === 0) {\n\t\tthrow new Json2CodeError([\n\t\t\tcreateDiagnostic(\n\t\t\t\tDiagnosticCode.FileNotFound,\n\t\t\t\t\"error\",\n\t\t\t\t\"No JSON Schema files matched the input.\",\n\t\t\t),\n\t\t]);\n\t}\n\tconst resolved: ResolvedOptions = { ...options, output, rootDir };\n\n\tconst walkCache = new Map<AbstractWalker, Promise<SourceDoc[]>>();\n\tfor (const spec of normalizeTargets(config.targets)) {\n\t\tconst def = resolveTarget(spec);\n\t\tconst walker = def.walker ?? defaultWalker;\n\t\t// share one walk per walker instance: multi-target runs don't duplicate diagnostics\n\t\tlet docsPromise = walkCache.get(walker);\n\t\tif (!docsPromise) {\n\t\t\tconst wctx: WalkerContext = { logger, options: resolved, diagnostics: allDiagnostics };\n\t\t\tdocsPromise = walker.walk(files, wctx);\n\t\t\twalkCache.set(walker, docsPromise);\n\t\t}\n\t\tconst docs = await docsPromise;\n\n\t\tconst mapOutput =\n\t\t\tdef.mapOutput ?? ((docId: string) => Linker.defaultMapOutput(def.name, docId));\n\t\tconst linker = new Linker({\n\t\t\toptions: resolved,\n\t\t\ttargetName: def.name,\n\t\t\tmapOutput,\n\t\t\tdiagnostics: allDiagnostics,\n\t\t});\n\t\tconst pctx = linker.createPrintContext(logger, allDiagnostics);\n\t\tconst printed = await def.printer.print(docs, pctx);\n\t\tfor (const f of printed) {\n\t\t\tallFiles.push(f);\n\t\t}\n\t}\n\n\tconst { errors, warnings } = partitionDiagnostics(allDiagnostics);\n\tfor (const w of warnings) {\n\t\tlogger.warn(formatDiagnostic(w));\n\t}\n\tif (errors.length > 0) {\n\t\tfor (const e of errors) {\n\t\t\tlogger.error(formatDiagnostic(e));\n\t\t}\n\t\tthrow new Json2CodeError(errors);\n\t}\n\n\tconst result = await writeFiles(allFiles, {\n\t\toutput,\n\t\tdryRun: config.dryRun ?? false,\n\t\tclean: config.clean ?? false,\n\t\tlogger,\n\t\theader: options.header,\n\t});\n\treturn { ...result, diagnostics: allDiagnostics };\n}\n\nfunction normalizeTargets(targets: TargetSpec[]): TargetSpec[] {\n\treturn targets.length > 0 ? targets : [\"typescript\"];\n}\n\nfunction mergeOptions(opts?: Partial<GenerateOptions>): GenerateOptions {\n\tconst naming = opts?.naming ?? DEFAULT_OPTIONS.naming;\n\tif (!NAMING_STYLES.includes(naming)) {\n\t\tthrow new TypeError(\n\t\t\t`Invalid naming style: ${JSON.stringify(naming)} (expected one of ${NAMING_STYLES.join(\", \")})`,\n\t\t);\n\t}\n\t// drop explicitly-undefined keys so they don't override defaults when spreading\n\tconst defined = Object.fromEntries(\n\t\tObject.entries(opts ?? {}).filter(([, v]) => v !== undefined),\n\t) as Partial<GenerateOptions>;\n\t// importPaths is nested: merge per-target keys so a partial object keeps defaults\n\tconst importPaths = { ...DEFAULT_OPTIONS.importPaths, ...defined.importPaths };\n\treturn {\n\t\t...DEFAULT_OPTIONS,\n\t\t...defined,\n\t\timportPaths,\n\t\tnaming,\n\t};\n}\n"],"mappings":";;;;;;;;;;AAgCA,MAAM,gBAAgB,IAAI,iBAAiB;AAE3C,eAAsB,SAAS,QAAiD;CAC/E,MAAM,SAAS,aAAa,OAAO,WAAW,KAAK;CACnD,MAAM,MAAM,QAAQ,IAAI;CACxB,MAAM,SAAS,KAAK,QAAQ,KAAK,OAAO,MAAM;CAC9C,MAAM,UAAU,aAAa,OAAO,OAAO;CAE3C,MAAM,iBAA+B,CAAC;CACtC,MAAM,WAA0B,CAAC;CAEjC,MAAM,EAAE,OAAO,YAAY,MAAM,SAAS,OAAO,OAAO,KAAK,MAAM;CACnE,IAAI,MAAM,WAAW,GACpB,MAAM,IAAI,eAAe,CACxB,iBACC,eAAe,cACf,SACA,yCACD,CACD,CAAC;CAEF,MAAM,WAA4B;EAAE,GAAG;EAAS;EAAQ;CAAQ;CAEhE,MAAM,4BAAY,IAAI,IAA0C;CAChE,KAAK,MAAM,QAAQ,iBAAiB,OAAO,OAAO,GAAG;EACpD,MAAM,MAAM,cAAc,IAAI;EAC9B,MAAM,SAAS,IAAI,UAAU;EAE7B,IAAI,cAAc,UAAU,IAAI,MAAM;EACtC,IAAI,CAAC,aAAa;GACjB,MAAM,OAAsB;IAAE;IAAQ,SAAS;IAAU,aAAa;GAAe;GACrF,cAAc,OAAO,KAAK,OAAO,IAAI;GACrC,UAAU,IAAI,QAAQ,WAAW;EAClC;EACA,MAAM,OAAO,MAAM;EAEnB,MAAM,YACL,IAAI,eAAe,UAAkB,OAAO,iBAAiB,IAAI,MAAM,KAAK;EAO7E,MAAM,OAAO,IANM,OAAO;GACzB,SAAS;GACT,YAAY,IAAI;GAChB;GACA,aAAa;EACd,CACkB,CAAC,CAAC,mBAAmB,QAAQ,cAAc;EAC7D,MAAM,UAAU,MAAM,IAAI,QAAQ,MAAM,MAAM,IAAI;EAClD,KAAK,MAAM,KAAK,SACf,SAAS,KAAK,CAAC;CAEjB;CAEA,MAAM,EAAE,QAAQ,aAAa,qBAAqB,cAAc;CAChE,KAAK,MAAM,KAAK,UACf,OAAO,KAAK,iBAAiB,CAAC,CAAC;CAEhC,IAAI,OAAO,SAAS,GAAG;EACtB,KAAK,MAAM,KAAK,QACf,OAAO,MAAM,iBAAiB,CAAC,CAAC;EAEjC,MAAM,IAAI,eAAe,MAAM;CAChC;CASA,OAAO;EAAE,GAAG,MAPS,WAAW,UAAU;GACzC;GACA,QAAQ,OAAO,UAAU;GACzB,OAAO,OAAO,SAAS;GACvB;GACA,QAAQ,QAAQ;EACjB,CAAC;EACmB,aAAa;CAAe;AACjD;AAEA,SAAS,iBAAiB,SAAqC;CAC9D,OAAO,QAAQ,SAAS,IAAI,UAAU,CAAC,YAAY;AACpD;AAEA,SAAS,aAAa,MAAkD;CACvE,MAAM,SAAS,MAAM,UAAU,gBAAgB;CAC/C,IAAI,CAAC,cAAc,SAAS,MAAM,GACjC,MAAM,IAAI,UACT,yBAAyB,KAAK,UAAU,MAAM,EAAE,oBAAoB,cAAc,KAAK,IAAI,EAAE,EAC9F;CAGD,MAAM,UAAU,OAAO,YACtB,OAAO,QAAQ,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,MAAM,KAAA,CAAS,CAC7D;CAEA,MAAM,cAAc;EAAE,GAAG,gBAAgB;EAAa,GAAG,QAAQ;CAAY;CAC7E,OAAO;EACN,GAAG;EACH,GAAG;EACH;EACA;CACD;AACD"}