@powerlines/schema 0.11.81 → 0.11.82

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,29 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/bundle.cjs

@@ -0,0 +1,49 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let _powerlines_core_lib_unplugin = require("@powerlines/core/lib/unplugin");
+let _powerlines_unplugin_esbuild = require("@powerlines/unplugin/esbuild");
+let _stryke_helpers_omit = require("@stryke/helpers/omit");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu, 1);
+let esbuild = require("esbuild");
+let unplugin = require("unplugin");
+
+//#region src/bundle.ts
+/**
+* Bundle a type definition to a module.
+*
+* @param context - The context object containing the environment paths.
+* @param file - The file path to bundle.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the bundled module.
+*/
+async function bundle(context, file, options = {}) {
+	const path = await context.fs.resolve(file);
+	if (!path || !context.fs.existsSync(path)) throw new Error(`Module not found: "${file}". Please check the path and try again.`);
+	const result = await (0, esbuild.build)((0, defu.default)({
+		platform: "node",
+		...(0, _stryke_helpers_omit.omit)(options, ["name", "resolve"]),
+		logLevel: "silent",
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: false,
+		bundle: true,
+		packages: "bundle",
+		keepNames: true,
+		metafile: false
+	}, (0, _powerlines_unplugin_esbuild.resolveOptions)(context), { plugins: [(0, unplugin.createEsbuildPlugin)((0, _powerlines_core_lib_unplugin.createUnpluginResolver)(context, {
+		name: options.name ?? `${(0, _stryke_path_file_path_fns.findFileName)(file)} Bundler`,
+		prefix: false,
+		overrides: (0, defu.default)(options.resolve ?? {}, { skipNodeModulesBundle: false }),
+		silenceHookLogging: true
+	}))()] }));
+	if (result.errors.length > 0) throw new Error(`Failed to bundle ${file}: ${result.errors.map((error) => error.text).join(", ")}`);
+	if (result.warnings.length > 0) context.warn(`Warnings while bundling ${file}: ${result.warnings.map((warning) => warning.text).join(", ")}`);
+	if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) throw new Error(`No output files generated for ${file}. Please check the configuration and try again.`);
+	return result.outputFiles.filter(Boolean)[0];
+}
+
+//#endregion
+exports.bundle = bundle;

package/dist/bundle.d.cts

@@ -0,0 +1,21 @@
+import { ResolveOptions, UnresolvedContext } from "@powerlines/core";
+import { DeepPartial } from "@stryke/types/base";
+import { BuildOptions, OutputFile } from "esbuild";
+
+//#region src/bundle.d.ts
+type BundleOptions = DeepPartial<BuildOptions> & {
+  name?: string;
+  resolve?: DeepPartial<ResolveOptions>;
+};
+/**
+ * Bundle a type definition to a module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param file - The file path to bundle.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the bundled module.
+ */
+declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputFile>;
+//#endregion
+export { BundleOptions, bundle };
+//# sourceMappingURL=bundle.d.cts.map

package/dist/bundle.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.cts","names":[],"sources":["../src/bundle.ts"],"mappings":";;;;;KA6BY,aAAA,GAAgB,WAAA,CAAY,YAAA;EACtC,IAAA;EACA,OAAA,GAAU,WAAA,CAAY,cAAA;AAAA;;;;;;;;;iBAWF,MAAA,kBAAwB,iBAAA,EAC5C,OAAA,EAAS,QAAA,EACT,IAAA,UACA,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,UAAA"}

package/dist/bundle.d.mts

@@ -0,0 +1,21 @@
+import { BuildOptions, OutputFile } from "esbuild";
+import { ResolveOptions, UnresolvedContext } from "@powerlines/core";
+import { DeepPartial } from "@stryke/types/base";
+
+//#region src/bundle.d.ts
+type BundleOptions = DeepPartial<BuildOptions> & {
+  name?: string;
+  resolve?: DeepPartial<ResolveOptions>;
+};
+/**
+ * Bundle a type definition to a module.
+ *
+ * @param context - The context object containing the environment paths.
+ * @param file - The file path to bundle.
+ * @param options - Optional overrides for the ESBuild configuration.
+ * @returns A promise that resolves to the bundled module.
+ */
+declare function bundle<TContext extends UnresolvedContext>(context: TContext, file: string, options?: BundleOptions): Promise<OutputFile>;
+//#endregion
+export { BundleOptions, bundle };
+//# sourceMappingURL=bundle.d.mts.map

package/dist/bundle.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.mts","names":[],"sources":["../src/bundle.ts"],"mappings":";;;;;KA6BY,aAAA,GAAgB,WAAA,CAAY,YAAA;EACtC,IAAA;EACA,OAAA,GAAU,WAAA,CAAY,cAAA;AAAA;;;;;;;;;iBAWF,MAAA,kBAAwB,iBAAA,EAC5C,OAAA,EAAS,QAAA,EACT,IAAA,UACA,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,UAAA"}

package/dist/bundle.mjs

@@ -0,0 +1,48 @@
+import { createUnpluginResolver } from "@powerlines/core/lib/unplugin";
+import { resolveOptions } from "@powerlines/unplugin/esbuild";
+import { omit } from "@stryke/helpers/omit";
+import { findFileName } from "@stryke/path/file-path-fns";
+import defu from "defu";
+import { build } from "esbuild";
+import { createEsbuildPlugin } from "unplugin";
+
+//#region src/bundle.ts
+/**
+* Bundle a type definition to a module.
+*
+* @param context - The context object containing the environment paths.
+* @param file - The file path to bundle.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the bundled module.
+*/
+async function bundle(context, file, options = {}) {
+	const path = await context.fs.resolve(file);
+	if (!path || !context.fs.existsSync(path)) throw new Error(`Module not found: "${file}". Please check the path and try again.`);
+	const result = await build(defu({
+		platform: "node",
+		...omit(options, ["name", "resolve"]),
+		logLevel: "silent",
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: false,
+		bundle: true,
+		packages: "bundle",
+		keepNames: true,
+		metafile: false
+	}, resolveOptions(context), { plugins: [createEsbuildPlugin(createUnpluginResolver(context, {
+		name: options.name ?? `${findFileName(file)} Bundler`,
+		prefix: false,
+		overrides: defu(options.resolve ?? {}, { skipNodeModulesBundle: false }),
+		silenceHookLogging: true
+	}))()] }));
+	if (result.errors.length > 0) throw new Error(`Failed to bundle ${file}: ${result.errors.map((error) => error.text).join(", ")}`);
+	if (result.warnings.length > 0) context.warn(`Warnings while bundling ${file}: ${result.warnings.map((warning) => warning.text).join(", ")}`);
+	if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) throw new Error(`No output files generated for ${file}. Please check the configuration and try again.`);
+	return result.outputFiles.filter(Boolean)[0];
+}
+
+//#endregion
+export { bundle };
+//# sourceMappingURL=bundle.mjs.map

package/dist/bundle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.mjs","names":[],"sources":["../src/bundle.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ResolveOptions, UnresolvedContext } from \"@powerlines/core\";\nimport { createUnpluginResolver } from \"@powerlines/core/lib/unplugin\";\nimport { resolveOptions } from \"@powerlines/unplugin/esbuild\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { findFileName } from \"@stryke/path/file-path-fns\";\nimport { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport type { BuildOptions } from \"esbuild\";\nimport { build, OutputFile } from \"esbuild\";\nimport { createEsbuildPlugin } from \"unplugin\";\n\nexport type BundleOptions = DeepPartial<BuildOptions> & {\n  name?: string;\n  resolve?: DeepPartial<ResolveOptions>;\n};\n\n/**\n * Bundle a type definition to a module.\n *\n * @param context - The context object containing the environment paths.\n * @param file - The file path to bundle.\n * @param options - Optional overrides for the ESBuild configuration.\n * @returns A promise that resolves to the bundled module.\n */\nexport async function bundle<TContext extends UnresolvedContext>(\n  context: TContext,\n  file: string,\n  options: BundleOptions = {}\n): Promise<OutputFile> {\n  const path = await context.fs.resolve(file);\n  if (!path || !context.fs.existsSync(path)) {\n    throw new Error(\n      `Module not found: \"${file}\". Please check the path and try again.`\n    );\n  }\n\n  const result = await build(\n    defu(\n      {\n        platform: \"node\",\n        ...omit(options, [\"name\", \"resolve\"]),\n        logLevel: \"silent\",\n        entryPoints: [path],\n        write: false,\n        sourcemap: false,\n        splitting: false,\n        treeShaking: false,\n        bundle: true,\n        packages: \"bundle\",\n        keepNames: true,\n        metafile: false\n      },\n      resolveOptions(context),\n      {\n        plugins: [\n          createEsbuildPlugin(\n            createUnpluginResolver(context, {\n              name: options.name ?? `${findFileName(file)} Bundler`,\n              prefix: false,\n              overrides: defu(options.resolve ?? {}, {\n                skipNodeModulesBundle: false\n              }),\n              silenceHookLogging: true\n            })\n          )()\n        ]\n      }\n    )\n  );\n  if (result.errors.length > 0) {\n    throw new Error(\n      `Failed to bundle ${file}: ${result.errors\n        .map(error => error.text)\n        .join(\", \")}`\n    );\n  }\n  if (result.warnings.length > 0) {\n    context.warn(\n      `Warnings while bundling ${file}: ${result.warnings\n        .map(warning => warning.text)\n        .join(\", \")}`\n    );\n  }\n  if (!result.outputFiles || result.outputFiles.filter(Boolean).length === 0) {\n    throw new Error(\n      `No output files generated for ${\n        file\n      }. Please check the configuration and try again.`\n    );\n  }\n\n  return result.outputFiles.filter(Boolean)[0]!;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA0CA,eAAsB,OACpB,SACA,MACA,UAAyB,CAAC,GACL;CACrB,MAAM,OAAO,MAAM,QAAQ,GAAG,QAAQ,IAAI;CAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,WAAW,IAAI,GACtC,MAAM,IAAI,MACR,sBAAsB,KAAK,wCAC7B;CAGF,MAAM,SAAS,MAAM,MACnB,KACE;EACE,UAAU;EACV,GAAG,KAAK,SAAS,CAAC,QAAQ,SAAS,CAAC;EACpC,UAAU;EACV,aAAa,CAAC,IAAI;EAClB,OAAO;EACP,WAAW;EACX,WAAW;EACX,aAAa;EACb,QAAQ;EACR,UAAU;EACV,WAAW;EACX,UAAU;CACZ,GACA,eAAe,OAAO,GACtB,EACE,SAAS,CACP,oBACE,uBAAuB,SAAS;EAC9B,MAAM,QAAQ,QAAQ,GAAG,aAAa,IAAI,EAAE;EAC5C,QAAQ;EACR,WAAW,KAAK,QAAQ,WAAW,CAAC,GAAG,EACrC,uBAAuB,MACzB,CAAC;EACD,oBAAoB;CACtB,CAAC,CACH,EAAE,CACJ,EACF,CACF,CACF;CACA,IAAI,OAAO,OAAO,SAAS,GACzB,MAAM,IAAI,MACR,oBAAoB,KAAK,IAAI,OAAO,OACjC,KAAI,UAAS,MAAM,IAAI,EACvB,KAAK,IAAI,GACd;CAEF,IAAI,OAAO,SAAS,SAAS,GAC3B,QAAQ,KACN,2BAA2B,KAAK,IAAI,OAAO,SACxC,KAAI,YAAW,QAAQ,IAAI,EAC3B,KAAK,IAAI,GACd;CAEF,IAAI,CAAC,OAAO,eAAe,OAAO,YAAY,OAAO,OAAO,EAAE,WAAW,GACvE,MAAM,IAAI,MACR,iCACE,KACD,gDACH;CAGF,OAAO,OAAO,YAAY,OAAO,OAAO,EAAE;AAC5C"}

package/dist/codegen.cjs

@@ -0,0 +1,312 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_metadata = require('./metadata.cjs');
+const require_type_checks = require('./type-checks.cjs');
+const require_helpers = require('./helpers.cjs');
+const require_validate = require('./validate.cjs');
+let _stryke_convert_to_bool = require("@stryke/convert/to-bool");
+let _stryke_type_checks = require("@stryke/type-checks");
+let _stryke_type_checks_is_boolean = require("@stryke/type-checks/is-boolean");
+let _stryke_type_checks_is_null = require("@stryke/type-checks/is-null");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+let ajv_dist_standalone_index_js = require("ajv/dist/standalone/index.js");
+ajv_dist_standalone_index_js = require_runtime.__toESM(ajv_dist_standalone_index_js, 1);
+
+//#region src/codegen.ts
+/**
+* Stringifies a value for generated TypeScript code.
+*/
+function stringifyValue(value, type) {
+	return (0, _stryke_type_checks_is_undefined.isUndefined)(value) ? "undefined" : (0, _stryke_type_checks_is_null.isNull)(value) ? "null" : type === "boolean" || (0, _stryke_type_checks_is_boolean.isBoolean)(value) ? String((0, _stryke_convert_to_bool.toBool)(value)) : type === "number" || (0, _stryke_type_checks_is_number.isNumber)(value) ? Number.parseFloat(String(value)).toLocaleString(void 0, { maximumFractionDigits: 20 }) : type === "integer" ? Number.parseInt(String(value)).toLocaleString() : type === "string" || type === "object" || type === "array" ? JSON.stringify(value) : String(value);
+}
+/**
+* Stringifies a JSON Schema fragment into a TypeScript-like type string.
+*/
+function stringifyType(schema) {
+	if (!schema) return "unknown";
+	if (typeof schema === "boolean") return schema ? "unknown" : "never";
+	if (require_type_checks.isJsonSchemaObject(schema) && (0, _stryke_type_checks_is_set_string.isSetString)(schema.name)) return schema.name;
+	const objectSchema = schema;
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(objectSchema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(objectSchema.$ref)?.[1] ?? objectSchema.$ref;
+	const primaryType = require_metadata.getPrimarySchemaType(schema);
+	if (primaryType) {
+		if (primaryType === "integer" || primaryType === "number") return "number";
+		return primaryType;
+	}
+	if (objectSchema.type === "array" && Array.isArray(objectSchema.enum)) return objectSchema.enum.map((value) => JSON.stringify(value)).join(" | ");
+	if (objectSchema.const !== void 0) return JSON.stringify(objectSchema.const);
+	if (objectSchema.type === "array" || objectSchema.items) return `${stringifyType(Array.isArray(objectSchema.items) ? objectSchema.items[0] : objectSchema.items)}[]`;
+	if (objectSchema.type === "object" || objectSchema.properties || objectSchema.additionalProperties) {
+		if (require_type_checks.isJsonSchema(objectSchema.additionalProperties)) return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;
+		if (require_type_checks.isJsonSchemaObject(objectSchema)) {
+			const required = objectSchema.required ?? [];
+			return `{ ${require_helpers.getPropertiesList(objectSchema).map((property) => {
+				const suffix = !required.includes(property.name) || require_helpers.isSchemaNullable(property) ? `${!required.includes(property.name) ? "?" : ""}${require_helpers.isSchemaNullable(property) ? " | null" : ""}` : "";
+				return `${property.name}${suffix}: ${stringifyType(property)}`;
+			}).join(";\n")} }`;
+		}
+	}
+	if (objectSchema.oneOf || objectSchema.anyOf) return (objectSchema.oneOf ?? objectSchema.anyOf ?? []).map((branch) => stringifyType(branch)).join(" | ");
+	if (objectSchema.allOf) return "object";
+	return "unknown";
+}
+/**
+* Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+*
+* @param value - The value whose type is to be represented as a string.
+* @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
+*/
+function getJsonSchemaType(value) {
+	return (0, _stryke_type_checks_is_null.isNull)(value) ? "null" : (0, _stryke_type_checks_is_boolean.isBoolean)(value) ? "boolean" : (0, _stryke_type_checks.isInteger)(value) ? "integer" : (0, _stryke_type_checks_is_number.isNumber)(value) ? "number" : (0, _stryke_type_checks.isString)(value) ? "string" : (0, _stryke_type_checks.isObject)(value) ? "object" : Array.isArray(value) ? "array" : void 0;
+}
+/**
+* Resolves a local JSON Schema `$ref` (e.g. `#/$defs/Name`) to the referenced definition name.
+*/
+function resolveLocalRefName(ref) {
+	return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(ref)?.[1];
+}
+/**
+* Converts an arbitrary definition name into a safe JavaScript identifier suffix.
+*/
+function toParserIdentifier(name) {
+	const cleaned = name.replace(/[^\w$]/gu, "_");
+	return `parse_${/^\d/u.test(cleaned) ? `_${cleaned}` : cleaned}`;
+}
+/**
+* Returns the list of JSON Schema `type` keyword values declared on a fragment,
+* preserving `object` and `array` (which {@link readSchemaTypes} intentionally drops).
+*/
+function readDeclaredTypes(schema) {
+	const type = schema.type;
+	if (Array.isArray(type)) return [...type];
+	return type ? [type] : [];
+}
+/**
+* Generates a JavaScript expression that builds a path string for a child element.
+*/
+function childPath(pathExpr, segment) {
+	return `${pathExpr} + ${JSON.stringify(segment)}`;
+}
+/**
+* Generates standalone parser code for a JSON Schema.
+*
+* @remarks
+* The generated `parse` function reads an arbitrary input value and converts it
+* into the shape described by the schema. It walks the schema recursively to:
+*
+* - resolve local `$ref` pointers (`#/$defs/*` and `#/definitions/*`) into
+*   dedicated parser functions so recursive schemas are supported,
+* - apply `default` values for object properties (and root/array values) that
+*   are missing from the input,
+* - coerce primitive values to the declared type (for example `"42"` to `42`
+*   for an `integer` schema, or `1` to `true` for a `boolean` schema),
+* - validate `const`, `enum`, `oneOf`/`anyOf` and `allOf` constraints, and
+* - collect detailed, path-aware errors and throw a `ParserError` when the
+*   input cannot be converted into a valid value.
+*
+* @param schema - The JSON Schema to generate parser code for.
+* @returns The generated standalone parser code as a string.
+*/
+function generateParserCode(schema) {
+	const rootSchema = typeof schema === "boolean" ? schema : schema;
+	const definitions = typeof rootSchema === "boolean" ? {} : {
+		...rootSchema.definitions,
+		...rootSchema.$defs
+	};
+	/**
+	* Generates a JavaScript expression that parses `valueExpr` against `fragment`.
+	* The expression has access to an in-scope mutable `errors` array.
+	*/
+	function generateExpression(fragment, valueExpr, pathExpr) {
+		if (typeof fragment === "boolean") return fragment ? valueExpr : `((value, path) => { errors.push({ path, message: "No value is allowed at this location" }); return value; })(${valueExpr}, ${pathExpr})`;
+		const view = fragment;
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(view.$ref)) {
+			const refName = resolveLocalRefName(view.$ref);
+			if (refName && refName in definitions) return `${toParserIdentifier(refName)}(${valueExpr}, ${pathExpr}, errors)`;
+			return valueExpr;
+		}
+		return `((value, path) => {\n${generateBody(view)}\n})(${valueExpr}, ${pathExpr})`;
+	}
+	/**
+	* Generates the body statements (including a terminating `return`) for the
+	* arrow function produced by {@link generateExpression}.
+	*/
+	function generateBody(view) {
+		const lines = [];
+		const nullable = require_helpers.isSchemaNullable(view);
+		if (view.default !== void 0) lines.push(`if (value === undefined) { return ${JSON.stringify(view.default)}; }`);
+		else lines.push(`if (value === undefined) { errors.push({ path, message: "A value is required" }); return value; }`);
+		if (nullable) lines.push(`if (value === null) { return null; }`);
+		if (view.const !== void 0) {
+			const constValue = JSON.stringify(view.const);
+			lines.push(`if (JSON.stringify(value) !== ${JSON.stringify(constValue)}) { errors.push({ path, message: "Expected the constant value " + ${JSON.stringify(constValue)} }); }`, `return ${constValue};`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.enum)) {
+			const enumValues = JSON.stringify(view.enum);
+			lines.push(`if (!${enumValues}.some(allowed => JSON.stringify(allowed) === JSON.stringify(value))) { errors.push({ path, message: "Expected one of " + ${JSON.stringify(enumValues)} }); }`, `return value;`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.oneOf) || Array.isArray(view.anyOf)) {
+			const branchFns = (view.oneOf ?? view.anyOf ?? []).map((branch) => `(value, path, errors) => (${generateExpression(branch, "value", "path")})`).join(",\n");
+			lines.push(`const branches = [\n${branchFns}\n];`, `for (const branch of branches) {`, `  const branchErrors = [];`, `  const branchResult = branch(value, path, branchErrors);`, `  if (branchErrors.length === 0) { return branchResult; }`, `}`, `errors.push({ path, message: "Value does not match any of the allowed schemas" });`, `return value;`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.allOf)) {
+			const { allOf, ...rest } = view;
+			const merged = require_helpers.merge(rest, ...allOf);
+			lines.push(`return ${generateExpression(merged, "value", "path")};`);
+			return lines.join("\n");
+		}
+		const declaredTypes = readDeclaredTypes(view);
+		switch (require_metadata.getPrimarySchemaType(view) ?? declaredTypes.find((type) => type !== "null") ?? (view.properties ? "object" : view.items ? "array" : void 0)) {
+			case "object":
+				lines.push(generateObjectBody(view));
+				break;
+			case "array":
+				lines.push(generateArrayBody(view));
+				break;
+			case "string":
+				lines.push(`if (typeof value === "string") { return value; }`, `if (typeof value === "number" || typeof value === "boolean") { return String(value); }`, `errors.push({ path, message: "Expected a string value" });`, `return value;`);
+				break;
+			case "integer":
+				lines.push(`if (typeof value === "number" && Number.isInteger(value)) { return value; }`, `if (typeof value === "string" && value.trim() !== "" && Number.isInteger(Number(value))) { return Number(value); }`, `if (typeof value === "boolean") { return value ? 1 : 0; }`, `errors.push({ path, message: "Expected an integer value" });`, `return value;`);
+				break;
+			case "number":
+				lines.push(`if (typeof value === "number") { return value; }`, `if (typeof value === "string" && value.trim() !== "" && !Number.isNaN(Number(value))) { return Number(value); }`, `if (typeof value === "boolean") { return value ? 1 : 0; }`, `errors.push({ path, message: "Expected a number value" });`, `return value;`);
+				break;
+			case "boolean":
+				lines.push(`if (typeof value === "boolean") { return value; }`, `if (value === "true" || value === 1) { return true; }`, `if (value === "false" || value === 0) { return false; }`, `errors.push({ path, message: "Expected a boolean value" });`, `return value;`);
+				break;
+			case "null":
+				lines.push(`if (value === null) { return null; }`, `errors.push({ path, message: "Expected a null value" });`, `return value;`);
+				break;
+			case void 0:
+			default:
+				lines.push(`return value;`);
+				break;
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Generates the parsing statements for an `object` schema, applying property
+	* defaults and recursing into each declared property.
+	*/
+	function generateObjectBody(view) {
+		const type = stringifyType(view);
+		const lines = [`if (typeof value !== "object" || value === null || Array.isArray(value)) { errors.push({ path, message: "Expected an object value" }); return value; }`, `const result = {}${type ? ` as ${type}` : ""};`];
+		const properties = require_type_checks.isJsonSchemaObject(view) ? require_helpers.getPropertiesList(view) : [];
+		const propertyNames = /* @__PURE__ */ new Set();
+		for (const property of properties) {
+			const name = property.name;
+			propertyNames.add(name);
+			const accessor = `value[${JSON.stringify(name)}]`;
+			const propertyPath = childPath("path", `.${name}`);
+			const propertyExpression = generateExpression(property, accessor, propertyPath);
+			const missingBranch = property.default !== void 0 ? `result[${JSON.stringify(name)}] = ${JSON.stringify(property.default)};` : property.required ? `errors.push({ path: ${propertyPath}, message: "Required property is missing" });` : ``;
+			lines.push(`if (${accessor} !== undefined) {`, `  result[${JSON.stringify(name)}] = ${propertyExpression};`, `}${missingBranch ? ` else { ${missingBranch} }` : ``}`);
+		}
+		const additional = view.additionalProperties;
+		if (require_type_checks.isJsonSchema(additional)) {
+			const additionalExpression = generateExpression(additional, `value[key]`, `path + "." + key`);
+			lines.push(`for (const key of Object.keys(value)) {`, `  if (${JSON.stringify([...propertyNames])}.includes(key)) { continue; }`, `  result[key] = ${additionalExpression};`, `}`);
+		} else if (additional !== false) lines.push(`for (const key of Object.keys(value)) {`, `  if (${JSON.stringify([...propertyNames])}.includes(key)) { continue; }`, `  result[key] = value[key];`, `}`);
+		lines.push(`return result;`);
+		return lines.join("\n");
+	}
+	/**
+	* Generates the parsing statements for an `array` schema, recursing into each
+	* item (supporting both list and tuple `items`/`prefixItems` forms).
+	*/
+	function generateArrayBody(view) {
+		const lines = [`if (!Array.isArray(value)) { errors.push({ path, message: "Expected an array value" }); return value; }`];
+		const tupleItems = view.prefixItems ?? (Array.isArray(view.items) ? view.items : void 0);
+		if (tupleItems) {
+			const listItems = !Array.isArray(view.items) ? view.items : void 0;
+			const itemExpressions = tupleItems.map((item, index) => `index === ${index} ? (${generateExpression(item, "item", childPath("path", `[${index}]`))})`);
+			const fallbackExpression = listItems ? generateExpression(listItems, "item", `path + "[" + index + "]"`) : "item";
+			lines.push(`return value.map((item, index) => ${itemExpressions.join(" : ")}${itemExpressions.length > 0 ? " : " : ""}${fallbackExpression});`);
+			return lines.join("\n");
+		}
+		const itemExpression = generateExpression(view.items ?? true, "item", `path + "[" + index + "]"`);
+		lines.push(`return value.map((item, index) => ${itemExpression});`);
+		return lines.join("\n");
+	}
+	return `/**
+ * Error thrown when an input value cannot be parsed into the type described by the JSON Schema.
+ */
+export class ParserError extends Error {
+  public override name = "ParserError";
+
+  public errors: { path: string; message: string }[];
+
+  public constructor(errors: { path: string; message: string }[]) {
+    super(
+      "Failed to parse the provided value against the JSON Schema:\\n" +
+        errors.map(error => "  - " + error.path + ": " + error.message).join("\\n")
+    );
+
+    this.errors = errors;
+  }
+}
+
+${Object.entries(definitions).map(([name, definition]) => `function ${toParserIdentifier(name)}(value, path, errors) {\n  return ${generateExpression(definition, "value", "path")};\n}`).join("\n\n")}
+
+/**
+ * Parses an input value into the type described by the JSON Schema.
+ *
+ * @remarks
+ * The parser applies default values for missing properties, coerces primitive values to the declared type, and throws a {@link ParserError} (containing a detailed list of validation errors) when the value cannot be converted into a valid result.
+ *
+ * @param value - The input value to parse.
+ * @returns The parsed value conforming to the schema.
+ */
+export function parse(value: unknown)${schema.name ? `: ${stringifyType(schema)}` : ""} {
+  const errors: { path: string; message: string }[] = [];
+
+  const result = ${generateExpression(schema, "value", "\"$\"")};
+
+  if (errors.length > 0) {
+    throw new ParserError(errors);
+  }
+
+  return result;
+}`;
+}
+/**
+* Generates standalone JSON Schema validation code using Ajv.
+*
+* @remarks
+* The generated code includes a validation function that can be used to validate data against the provided JSON Schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+*
+* @param schema - The JSON Schema to generate validation code for.
+* @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+* @returns The generated standalone validation code as a string.
+*/
+function generateValidationCode(schema, refsOrFuncts) {
+	return (0, ajv_dist_standalone_index_js.default)(require_validate.getValidator(schema), refsOrFuncts);
+}
+/**
+* Generates standalone JavaScript code for validating and parsing data according to a JSON Schema.
+*
+* @remarks
+* The generated code includes:
+* - Validation code generated by Ajv for the provided JSON Schema, which can be used to validate data against the schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+* - Parsing code generated for the provided JSON Schema, which can be used to parse and validate data against the schema at runtime. The parsing function will apply default values specified in the schema if they are not present in the input data, throw an error if the input data does not conform to the schema (providing detailed information about the validation errors), and return the parsed data if it is valid according to the schema.
+*
+* @param schema - The JSON Schema to generate code for.
+* @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+* @returns The generated standalone validation and parsing code as a string.
+*/
+function generateCode(schema, refsOrFuncts) {
+	return `${generateValidationCode(schema, refsOrFuncts)}\n\n${generateParserCode(schema)}`;
+}
+
+//#endregion
+exports.generateCode = generateCode;
+exports.generateParserCode = generateParserCode;
+exports.generateValidationCode = generateValidationCode;
+exports.getJsonSchemaType = getJsonSchemaType;
+exports.stringifyType = stringifyType;
+exports.stringifyValue = stringifyValue;

package/dist/codegen.d.cts

@@ -0,0 +1,67 @@
+import { JsonSchema, JsonSchemaType } from "./types.cjs";
+import standaloneCode from "ajv/dist/standalone/index.js";
+
+//#region src/codegen.d.ts
+/**
+ * Stringifies a value for generated TypeScript code.
+ */
+declare function stringifyValue(value?: unknown, type?: JsonSchemaType | string): string;
+/**
+ * Stringifies a JSON Schema fragment into a TypeScript-like type string.
+ */
+declare function stringifyType(schema?: JsonSchema): string;
+/**
+ * Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+ *
+ * @param value - The value whose type is to be represented as a string.
+ * @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
+ */
+declare function getJsonSchemaType(value?: unknown): JsonSchemaType | undefined;
+/**
+ * Generates standalone parser code for a JSON Schema.
+ *
+ * @remarks
+ * The generated `parse` function reads an arbitrary input value and converts it
+ * into the shape described by the schema. It walks the schema recursively to:
+ *
+ * - resolve local `$ref` pointers (`#/$defs/*` and `#/definitions/*`) into
+ *   dedicated parser functions so recursive schemas are supported,
+ * - apply `default` values for object properties (and root/array values) that
+ *   are missing from the input,
+ * - coerce primitive values to the declared type (for example `"42"` to `42`
+ *   for an `integer` schema, or `1` to `true` for a `boolean` schema),
+ * - validate `const`, `enum`, `oneOf`/`anyOf` and `allOf` constraints, and
+ * - collect detailed, path-aware errors and throw a `ParserError` when the
+ *   input cannot be converted into a valid value.
+ *
+ * @param schema - The JSON Schema to generate parser code for.
+ * @returns The generated standalone parser code as a string.
+ */
+declare function generateParserCode(schema: JsonSchema): string;
+/**
+ * Generates standalone JSON Schema validation code using Ajv.
+ *
+ * @remarks
+ * The generated code includes a validation function that can be used to validate data against the provided JSON Schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+ *
+ * @param schema - The JSON Schema to generate validation code for.
+ * @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+ * @returns The generated standalone validation code as a string.
+ */
+declare function generateValidationCode(schema: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): string;
+/**
+ * Generates standalone JavaScript code for validating and parsing data according to a JSON Schema.
+ *
+ * @remarks
+ * The generated code includes:
+ * - Validation code generated by Ajv for the provided JSON Schema, which can be used to validate data against the schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+ * - Parsing code generated for the provided JSON Schema, which can be used to parse and validate data against the schema at runtime. The parsing function will apply default values specified in the schema if they are not present in the input data, throw an error if the input data does not conform to the schema (providing detailed information about the validation errors), and return the parsed data if it is valid according to the schema.
+ *
+ * @param schema - The JSON Schema to generate code for.
+ * @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+ * @returns The generated standalone validation and parsing code as a string.
+ */
+declare function generateCode(schema: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): string;
+//#endregion
+export { generateCode, generateParserCode, generateValidationCode, getJsonSchemaType, stringifyType, stringifyValue };
+//# sourceMappingURL=codegen.d.cts.map

package/dist/codegen.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.cts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAqDA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,cAAc;;;;iBAsBP,aAAA,CAAc,MAAmB,GAAV,UAAU;;;AAtBjB;AAsBhC;;;iBA8FgB,iBAAA,CAAkB,KAAA,aAAkB,cAAc;AA9FjB;AA8FjD;;;;AAAkE;AA0ElE;;;;AAAqD;AA+VrD;;;;;;;;;AAvgBiD,iBAwKjC,kBAAA,CAAmB,MAAkB,EAAV,UAAU;;;;;AAiWA;AAiBrD;;;;;iBAnBgB,sBAAA,CACd,MAAA,EAAQ,UAAA,EACR,YAAA,GAAe,UAAA,QAAkB,cAAA;;;;;;;;;AAmBkB;;;;iBAFrC,YAAA,CACd,MAAA,EAAQ,UAAA,EACR,YAAA,GAAe,UAAA,QAAkB,cAAA"}

package/dist/codegen.d.mts

@@ -0,0 +1,67 @@
+import { JsonSchema, JsonSchemaType } from "./types.mjs";
+import standaloneCode from "ajv/dist/standalone/index.js";
+
+//#region src/codegen.d.ts
+/**
+ * Stringifies a value for generated TypeScript code.
+ */
+declare function stringifyValue(value?: unknown, type?: JsonSchemaType | string): string;
+/**
+ * Stringifies a JSON Schema fragment into a TypeScript-like type string.
+ */
+declare function stringifyType(schema?: JsonSchema): string;
+/**
+ * Returns a string type representation of a value based on its type and an optional JSON Schema primitive type hint.
+ *
+ * @param value - The value whose type is to be represented as a string.
+ * @returns A string representation of the value's type, which may be influenced by the provided JSON Schema primitive type hint. The function handles various JavaScript types and formats them accordingly, including special handling for `undefined`, `null`, booleans, numbers (with formatting), strings, objects, and arrays. If a specific type hint is provided, it will take precedence in determining the string representation of the value.
+ */
+declare function getJsonSchemaType(value?: unknown): JsonSchemaType | undefined;
+/**
+ * Generates standalone parser code for a JSON Schema.
+ *
+ * @remarks
+ * The generated `parse` function reads an arbitrary input value and converts it
+ * into the shape described by the schema. It walks the schema recursively to:
+ *
+ * - resolve local `$ref` pointers (`#/$defs/*` and `#/definitions/*`) into
+ *   dedicated parser functions so recursive schemas are supported,
+ * - apply `default` values for object properties (and root/array values) that
+ *   are missing from the input,
+ * - coerce primitive values to the declared type (for example `"42"` to `42`
+ *   for an `integer` schema, or `1` to `true` for a `boolean` schema),
+ * - validate `const`, `enum`, `oneOf`/`anyOf` and `allOf` constraints, and
+ * - collect detailed, path-aware errors and throw a `ParserError` when the
+ *   input cannot be converted into a valid value.
+ *
+ * @param schema - The JSON Schema to generate parser code for.
+ * @returns The generated standalone parser code as a string.
+ */
+declare function generateParserCode(schema: JsonSchema): string;
+/**
+ * Generates standalone JSON Schema validation code using Ajv.
+ *
+ * @remarks
+ * The generated code includes a validation function that can be used to validate data against the provided JSON Schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+ *
+ * @param schema - The JSON Schema to generate validation code for.
+ * @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+ * @returns The generated standalone validation code as a string.
+ */
+declare function generateValidationCode(schema: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): string;
+/**
+ * Generates standalone JavaScript code for validating and parsing data according to a JSON Schema.
+ *
+ * @remarks
+ * The generated code includes:
+ * - Validation code generated by Ajv for the provided JSON Schema, which can be used to validate data against the schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+ * - Parsing code generated for the provided JSON Schema, which can be used to parse and validate data against the schema at runtime. The parsing function will apply default values specified in the schema if they are not present in the input data, throw an error if the input data does not conform to the schema (providing detailed information about the validation errors), and return the parsed data if it is valid according to the schema.
+ *
+ * @param schema - The JSON Schema to generate code for.
+ * @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+ * @returns The generated standalone validation and parsing code as a string.
+ */
+declare function generateCode(schema: JsonSchema, refsOrFuncts?: Parameters<typeof standaloneCode>[1]): string;
+//#endregion
+export { generateCode, generateParserCode, generateValidationCode, getJsonSchemaType, stringifyType, stringifyValue };
+//# sourceMappingURL=codegen.d.mts.map

package/dist/codegen.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.mts","names":[],"sources":["../src/codegen.ts"],"mappings":";;;;;;AAqDA;iBAAgB,cAAA,CACd,KAAA,YACA,IAAA,GAAO,cAAc;;;;iBAsBP,aAAA,CAAc,MAAmB,GAAV,UAAU;;;AAtBjB;AAsBhC;;;iBA8FgB,iBAAA,CAAkB,KAAA,aAAkB,cAAc;AA9FjB;AA8FjD;;;;AAAkE;AA0ElE;;;;AAAqD;AA+VrD;;;;;;;;;AAvgBiD,iBAwKjC,kBAAA,CAAmB,MAAkB,EAAV,UAAU;;;;;AAiWA;AAiBrD;;;;;iBAnBgB,sBAAA,CACd,MAAA,EAAQ,UAAA,EACR,YAAA,GAAe,UAAA,QAAkB,cAAA;;;;;;;;;AAmBkB;;;;iBAFrC,YAAA,CACd,MAAA,EAAQ,UAAA,EACR,YAAA,GAAe,UAAA,QAAkB,cAAA"}