@powerlines/schema 0.11.71 → 0.11.73

package/dist/index.mjs

@@ -1,20 +1,2004 @@
+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, { defu as defu$1 } from "defu";
+import { build } from "esbuild";
+import { createEsbuildPlugin } from "unplugin";
+import { toBool } from "@stryke/convert/to-bool";
+import { isBigInt, isBoolean, isFunction, isInteger, isNull, isNumber, isObject, isRegExp, isSetArray, isSetObject, isSetString, isString, isUndefined } from "@stryke/type-checks";
+import { isBoolean as isBoolean$1 } from "@stryke/type-checks/is-boolean";
+import { isNull as isNull$1 } from "@stryke/type-checks/is-null";
+import { isNumber as isNumber$1 } from "@stryke/type-checks/is-number";
+import { isSetString as isSetString$1 } from "@stryke/type-checks/is-set-string";
+import { isUndefined as isUndefined$1 } from "@stryke/type-checks/is-undefined";
+import standaloneCode from "ajv/dist/standalone/index.js";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { findFileDotExtension, findFileExtensionSafe } from "@stryke/path/find";
+import { isSetObject as isSetObject$1 } from "@stryke/type-checks/is-set-object";
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { isFileReference } from "@powerlines/core";
+import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
+import { ReflectionClass, ReflectionKind, TypeNumberBrand, deserializeType, isType, reflect, stringifyType as stringifyType$1 } from "@powerlines/deepkit/vendor/type";
+import { extractFileReference } from "@stryke/convert/extract-file-reference";
+import { murmurhash } from "@stryke/hash";
+import { deepClone } from "@stryke/helpers/deep-clone";
+import { isStandardJsonSchema } from "@stryke/json";
+import { joinPaths } from "@stryke/path/join";
+import { list } from "@stryke/string-format/list";
+import { extractJsonSchema as extractJsonSchema$1, isZod3Type } from "@stryke/zod";
+import { toJsonSchema } from "@valibot/to-json-schema";
+import { parse } from "smol-toml";
+import { parse as parse$1 } from "yaml";
 
+//#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({
+		entryPoints: [path],
+		write: false,
+		sourcemap: false,
+		splitting: false,
+		treeShaking: true,
+		bundle: true,
+		packages: "bundle",
+		platform: "node",
+		logLevel: "silent",
+		...omit(options, ["name", "resolve"])
+	}, resolveOptions(context), { plugins: [createEsbuildPlugin(createUnpluginResolver(context, {
+		name: options.name ?? `${findFileName(file)} Bundler`,
+		prefix: false,
+		overrides: defu(options.resolve ?? {}, { skipNodeModulesBundle: false }, context.config.resolve),
+		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];
+}
 
-import __tsdown_shims_path from 'node:path'
-import __tsdown_shims_url from 'node:url'
+//#endregion
+//#region src/constants.ts
+const VALID_SOURCE_FILE_EXTENSIONS = [
+	"ts",
+	"cts",
+	"mts",
+	"tsx",
+	"js",
+	"cjs",
+	"mjs",
+	"jsx",
+	"json",
+	"jsonc",
+	"json5",
+	"yaml",
+	"yml",
+	"toml"
+];
+const JsonSchemaTypeNames = {
+	STRING: "string",
+	NUMBER: "number",
+	INTEGER: "integer",
+	BOOLEAN: "boolean",
+	NULL: "null",
+	OBJECT: "object",
+	ARRAY: "array"
+};
+const JSON_SCHEMA_PRIMITIVE_TYPES = [
+	JsonSchemaTypeNames.STRING,
+	JsonSchemaTypeNames.NUMBER,
+	JsonSchemaTypeNames.INTEGER,
+	JsonSchemaTypeNames.BOOLEAN,
+	JsonSchemaTypeNames.NULL
+];
+const JSON_SCHEMA_TYPES = [
+	...JSON_SCHEMA_PRIMITIVE_TYPES,
+	JsonSchemaTypeNames.ARRAY,
+	JsonSchemaTypeNames.OBJECT
+];
+const JSON_SCHEMA_METADATA_KEYS = [
+	"docs",
+	"deprecated",
+	"title",
+	"description",
+	"examples",
+	"hidden",
+	"ignore",
+	"internal",
+	"runtime",
+	"readOnly",
+	"writeOnly",
+	"alias",
+	"tags"
+];
 
-const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPath(import.meta.url)
-const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
+//#endregion
+//#region src/metadata.ts
+/**
+* Applies Powerlines schema metadata onto a JSON Schema fragment.
+*
+* @param schema - The JSON Schema fragment to apply metadata to.
+* @param metadata - The Powerlines schema metadata to apply.
+* @returns A new JSON Schema fragment with the metadata applied.
+*/
+function applyJsonSchemaMetadata(schema, metadata) {
+	if (!metadata || !isSetObject$1(schema)) return schema;
+	const result = { ...schema };
+	const mutableResult = result;
+	for (const key of JSON_SCHEMA_METADATA_KEYS) {
+		const value = metadata[key];
+		if (value !== void 0 && value !== null) mutableResult[key] = value;
+	}
+	return result;
+}
+/**
+* Normalizes the JSON Schema `type` keyword to a string array.
+*
+* @remarks
+* This function ensures that the `type` keyword of a JSON Schema fragment is always represented as an array of strings, even if it was originally defined as a single string. This normalization simplifies type checking and processing of JSON Schemas by providing a consistent format for the `type` information.
+*
+* @param schema - The JSON Schema fragment to read types from.
+* @returns An array of JSON Schema primitive type names defined in the `type` keyword, or an empty array if no valid types are found.
+*/
+function readSchemaTypes(schema) {
+	if (!isSetObject$1(schema)) return [];
+	const objectSchema = schema;
+	if (Array.isArray(objectSchema.type)) return objectSchema.type.filter((type) => isSetString(type));
+	if (isSetString(objectSchema.type) && objectSchema.type !== "object" && objectSchema.type !== "array") return [objectSchema.type];
+	return [];
+}
+/**
+* Returns the primary non-null JSON Schema type name for a fragment.
+*
+* @param schema - The JSON Schema fragment to check.
+* @returns The primary non-null JSON Schema type name, or `undefined` if none is found.
+*/
+function getPrimarySchemaType(schema) {
+	if (!isSetObject$1(schema)) return;
+	return readSchemaTypes(schema).find((type) => type !== "null");
+}
 
-import { bundle } from "./bundle.mjs";
-import { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames, VALID_SOURCE_FILE_EXTENSIONS } from "./constants.mjs";
-import { applyJsonSchemaMetadata, getPrimarySchemaType, readSchemaTypes } from "./metadata.mjs";
-import { isJsonSchema, isJsonSchemaAllOf, isJsonSchemaAny, isJsonSchemaAnyOf, isJsonSchemaArray, isJsonSchemaBigint, isJsonSchemaBoolean, isJsonSchemaDate, isJsonSchemaDecimal, isJsonSchemaEnum, isJsonSchemaInteger, isJsonSchemaKeywords, isJsonSchemaLiteral, isJsonSchemaMap, isJsonSchemaNativeEnum, isJsonSchemaNever, isJsonSchemaNull, isJsonSchemaNullable, isJsonSchemaNumber, isJsonSchemaObject, isJsonSchemaPrimitiveType, isJsonSchemaPrimitiveUnion, isJsonSchemaRecord, isJsonSchemaRef, isJsonSchemaSet, isJsonSchemaString, isJsonSchemaTuple, isJsonSchemaType, isJsonSchemaUndefined, isJsonSchemaUnion, isJsonSchemaUnknown, isNullOnlyJsonSchema, isSchema, isSchemaObject, isSchemaWithSource, isStandardSchema, isUntypedInput, isUntypedInputStrict, isUntypedSchema, isUntypedSchemaStrict, isValibotSchema } from "./type-checks.mjs";
-import { addProperty, getJsonSchema, getJsonSchemaObject, getProperties, getPropertiesList, isPropertyOptional, isSchemaNullable, isValidSchemaInputFile, merge } from "./helpers.mjs";
-import { generateCode, getJsonSchemaType, stringifyType, stringifyValue } from "./codegen.mjs";
-import { getCacheDirectory, getCacheFilePath, readSchema, readSchemaSafe, writeSchema } from "./persistence.mjs";
-import { reflectionToJsonSchema } from "./reflection.mjs";
-import { resolve, resolveModule, resolveReflection } from "./resolve.mjs";
-import { bundleReferences, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaWithSource, extractSource, extractVariant } from "./extract.mjs";
+//#endregion
+//#region src/type-checks.ts
+const isSetNumber = (value) => typeof value === "number" && Number.isFinite(value);
+const isSetBoolean = (value) => typeof value === "boolean";
+const isSchemaLikeValue = (value) => isSetObject(value) || isSetBoolean(value);
+const isRecordOfSchemaLike = (value) => isSetObject(value) && Object.values(value).every((item) => isSchemaLikeValue(item));
+const isVocabularyMap = (value) => isSetObject(value) && Object.values(value).every((item) => isSetBoolean(item));
+const isStringArray = (value) => Array.isArray(value) && value.every((item) => isSetString(item));
+const isRecordOfStringArrays = (value) => isSetObject(value) && Object.values(value).every((item) => isStringArray(item));
+const JSON_SCHEMA_PRIMITIVE_TYPE_SET = new Set(JSON_SCHEMA_PRIMITIVE_TYPES);
+const JSON_SCHEMA_TYPE_SET = new Set(JSON_SCHEMA_TYPES);
+/**
+* A helper type guard to check if a value is a JSON Schema primitive type.
+*
+* @param value - The value to check.
+* @returns True if the value is a JSON Schema primitive type, false otherwise.
+*/
+function isJsonSchemaPrimitiveType(value) {
+	return isSetString(value) && JSON_SCHEMA_PRIMITIVE_TYPE_SET.has(value);
+}
+/**
+* A helper type guard to check if a value is a JSON Schema type.
+*
+* @param value - The value to check.
+* @returns True if the value is a JSON Schema type, false otherwise.
+*/
+function isJsonSchemaType(value) {
+	return isSetString(value) && JSON_SCHEMA_TYPE_SET.has(value);
+}
+const DATE_FORMAT_SET = new Set([
+	"date",
+	"time",
+	"date-time",
+	"iso-time",
+	"iso-date-time",
+	"unix-time"
+]);
+const isSetBigint = (value) => typeof value === "bigint";
+const UNTYPED_TYPE_NAME_SET = new Set([
+	"string",
+	"number",
+	"bigint",
+	"boolean",
+	"symbol",
+	"function",
+	"object",
+	"any",
+	"array"
+]);
+const isUntypedJSType = (value) => isSetString(value) && UNTYPED_TYPE_NAME_SET.has(value);
+const isUntypedTypeDescriptor = (value) => {
+	if (!isSetObject(value)) return false;
+	const descriptor = value;
+	if (descriptor.type !== void 0 && !(isSetString(descriptor.type) && isUntypedJSType(descriptor.type) || Array.isArray(descriptor.type) && descriptor.type.every((item) => isUntypedJSType(item)))) return false;
+	if (descriptor.tsType !== void 0 && !isSetString(descriptor.tsType)) return false;
+	if (descriptor.markdownType !== void 0 && !isSetString(descriptor.markdownType)) return false;
+	if (descriptor.items !== void 0 && !(isUntypedTypeDescriptor(descriptor.items) || Array.isArray(descriptor.items) && descriptor.items.every((item) => isUntypedTypeDescriptor(item)))) return false;
+	return true;
+};
+const isUntypedFunctionArg = (value) => {
+	if (!isUntypedTypeDescriptor(value)) return false;
+	const arg = value;
+	if (arg.name !== void 0 && !isSetString(arg.name)) return false;
+	return arg.optional === void 0 || typeof arg.optional === "boolean";
+};
+const isRecordOfUntypedSchema = (value) => isSetObject(value) && Object.values(value).every((item) => isUntypedSchema(item));
+const isArrayOf = (value, predicate) => Array.isArray(value) && value.every((item) => predicate(item));
+const isTupleOfTwo = (value, aPredicate, bPredicate) => Array.isArray(value) && value.length === 2 && aPredicate(value[0]) && bPredicate(value[1]);
+const isOptionalString = (value) => value === void 0 || isSetString(value);
+const isOptionalBoolean = (value) => value === void 0 || isSetBoolean(value);
+const isOptionalNumber = (value) => value === void 0 || isSetNumber(value);
+const isOptionalBigint = (value) => value === void 0 || isSetBigint(value);
+const isOptionalJsonSchema = (value) => value === void 0 || isJsonSchema(value);
+const isOptionalJsonSchemaArray = (value) => value === void 0 || isArrayOf(value, isJsonSchema);
+const isOptionalPrimitiveTypeArray = (value) => value === void 0 || Array.isArray(value) && value.every((item) => isSetString(item) && JSON_SCHEMA_PRIMITIVE_TYPE_SET.has(item));
+const isOptionalJsonSchemaTypeArray = (value) => value === void 0 || Array.isArray(value) && value.every((item) => isSetString(item) && JSON_SCHEMA_TYPE_SET.has(item));
+const hasValidJsonSchemaKeywords = (schema) => {
+	if (!isOptionalString(schema.$id)) return false;
+	if (!isOptionalString(schema.$schema)) return false;
+	if (schema.$vocabulary !== void 0 && !isVocabularyMap(schema.$vocabulary)) return false;
+	if (!isOptionalString(schema.$comment)) return false;
+	if (!isOptionalString(schema.$anchor)) return false;
+	if (schema.$defs !== void 0 && !isRecordOfSchemaLike(schema.$defs)) return false;
+	if (!isOptionalString(schema.$dynamicRef)) return false;
+	if (!isOptionalString(schema.$dynamicAnchor)) return false;
+	if (!isOptionalString(schema.name)) return false;
+	if (!isOptionalString(schema.title)) return false;
+	if (!isOptionalString(schema.description)) return false;
+	if (!isOptionalString(schema.docs)) return false;
+	if (schema.examples !== void 0 && !Array.isArray(schema.examples)) return false;
+	if (schema.alias !== void 0 && !isStringArray(schema.alias)) return false;
+	if (schema.tags !== void 0 && !isStringArray(schema.tags)) return false;
+	if (!isOptionalBoolean(schema.deprecated)) return false;
+	if (!isOptionalBoolean(schema.hidden)) return false;
+	if (!isOptionalBoolean(schema.ignore)) return false;
+	if (!isOptionalBoolean(schema.internal)) return false;
+	if (!isOptionalBoolean(schema.runtime)) return false;
+	if (!isOptionalBoolean(schema.readOnly)) return false;
+	if (!isOptionalBoolean(schema.writeOnly)) return false;
+	if (!isOptionalJsonSchemaArray(schema.allOf)) return false;
+	if (!isOptionalJsonSchemaArray(schema.anyOf)) return false;
+	if (!isOptionalJsonSchemaArray(schema.oneOf)) return false;
+	if (!isOptionalJsonSchema(schema.not)) return false;
+	if (!isOptionalJsonSchema(schema.if)) return false;
+	if (!isOptionalJsonSchema(schema.then)) return false;
+	if (!isOptionalJsonSchema(schema.else)) return false;
+	return true;
+};
+/**
+* Type guard for shared JSON Schema keyword groups.
+*
+* @param input - The value to check.
+* @returns True if the input is a JSON Schema keyword group, false otherwise.
+*/
+function isJsonSchemaKeywords(input) {
+	if (!isSetObject(input)) return false;
+	return hasValidJsonSchemaKeywords(input);
+}
+/**
+* Type guard for generic JSON Schema objects with optional `$ref`.
+*
+* @param input - The value to check.
+* @returns True if the input is a generic JSON Schema object, false otherwise.
+*/
+function isJsonSchemaAny(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && isOptionalString(schema.$ref);
+}
+/**
+* Type guard for JSON Schema array types.
+*
+* @param input - The value to check.
+* @returns True if the input is a JSON Schema array schema, false otherwise.
+*/
+function isJsonSchemaArray(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || schema.type !== "array") return false;
+	return isOptionalJsonSchemaArray(schema.prefixItems) && isOptionalJsonSchema(schema.items) && isOptionalJsonSchema(schema.contains) && isOptionalNumber(schema.minItems) && isOptionalNumber(schema.maxItems) && isOptionalBoolean(schema.uniqueItems) && isOptionalNumber(schema.minContains) && isOptionalNumber(schema.maxContains) && (schema.unevaluatedItems === void 0 || isSetBoolean(schema.unevaluatedItems) || isJsonSchema(schema.unevaluatedItems));
+}
+/**
+* Type guard for bigint-backed integer schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a bigint-backed integer schema, false otherwise.
+*/
+function isJsonSchemaBigint(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || schema.type !== "integer" || schema.format !== "int64") return false;
+	return isOptionalBigint(schema.minimum) && isOptionalBigint(schema.exclusiveMinimum) && isOptionalBigint(schema.maximum) && isOptionalBigint(schema.exclusiveMaximum) && isOptionalBigint(schema.multipleOf) && isOptionalBigint(schema.default) && (schema.enum === void 0 || isArrayOf(schema.enum, isSetBigint));
+}
+/**
+* Type guard for boolean schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a boolean schema, false otherwise.
+*/
+function isJsonSchemaBoolean(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "boolean" && isOptionalBoolean(schema.default);
+}
+/**
+* Type guard for date/time schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a date or time schema, false otherwise.
+*/
+function isJsonSchemaDate(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema)) return false;
+	if (schema.anyOf !== void 0) return isArrayOf(schema.anyOf, isJsonSchemaDate);
+	if (schema.type !== "integer" && schema.type !== "string") return false;
+	if (!isSetString(schema.format) || !DATE_FORMAT_SET.has(schema.format)) return false;
+	return isOptionalNumber(schema.minimum) && isOptionalNumber(schema.maximum) && (schema.default === void 0 || isSetString(schema.default) || isSetNumber(schema.default));
+}
+/**
+* Type guard for enum-constrained schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an enum-constrained schema, false otherwise.
+*/
+function isJsonSchemaEnum(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || !isSetString(schema.type) || !JSON_SCHEMA_PRIMITIVE_TYPE_SET.has(schema.type) || !Array.isArray(schema.enum)) return false;
+	const typeName = schema.type;
+	const enumValues = schema.enum;
+	const defaultValue = schema.default;
+	if (typeName === "string") return enumValues.every((value) => isSetString(value)) && (defaultValue === void 0 || isSetString(defaultValue));
+	if (typeName === "number" || typeName === "integer") return enumValues.every((value) => isSetNumber(value)) && (defaultValue === void 0 || isSetNumber(defaultValue));
+	if (typeName === "boolean") return enumValues.every((value) => isSetBoolean(value)) && (defaultValue === void 0 || isSetBoolean(defaultValue));
+	return typeName === "null" && enumValues.every((value) => value === null) && (defaultValue === void 0 || defaultValue === null);
+}
+/**
+* Type guard for `allOf` composition schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an `allOf` schema, false otherwise.
+*/
+function isJsonSchemaAllOf(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || !isArrayOf(schema.allOf, isJsonSchema)) return false;
+	return schema.unevaluatedProperties === void 0 || isSetBoolean(schema.unevaluatedProperties) || isJsonSchema(schema.unevaluatedProperties);
+}
+/**
+* Type guard for literal-value schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a literal-value schema, false otherwise.
+*/
+function isJsonSchemaLiteral(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || !("const" in schema)) return false;
+	return schema.type === void 0 || isSetString(schema.type) && isJsonSchemaType(schema.type) || isOptionalJsonSchemaTypeArray(schema.type);
+}
+/**
+* Type guard for map tuple-array schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a map tuple-array schema, false otherwise.
+*/
+function isJsonSchemaMap(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || schema.type !== "array" || schema.maxItems !== 125 || !isSetObject(schema.items)) return false;
+	const items = schema.items;
+	return items.type === "array" && isTupleOfTwo(items.prefixItems, isJsonSchema, isJsonSchema) && (items.items === void 0 || items.items === false) && items.minItems === 2 && items.maxItems === 2;
+}
+/**
+* Type guard for native enum schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a native enum schema, false otherwise.
+*/
+function isJsonSchemaNativeEnum(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	const isValidType = schema.type === "string" || schema.type === "number" || Array.isArray(schema.type) && schema.type.length === 2 && schema.type[0] === "string" && schema.type[1] === "number";
+	return hasValidJsonSchemaKeywords(schema) && isValidType && Array.isArray(schema.enum) && schema.enum.every((value) => isSetString(value) || isSetNumber(value));
+}
+/**
+* Type guard for impossible/never schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a never schema, false otherwise.
+*/
+function isJsonSchemaNever(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && isJsonSchemaAny(schema.not);
+}
+/**
+* Type guard for `null` schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a null schema, false otherwise.
+*/
+function isJsonSchemaNull(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "null" && (schema.const === void 0 || schema.const === null) && (schema.enum === void 0 || Array.isArray(schema.enum) && schema.enum.every((v) => v === null)) && (schema.default === void 0 || schema.default === null);
+}
+/**
+* Type guard for nullable schema unions.
+*
+* @param input - The value to check.
+* @returns True if the input is a nullable schema union, false otherwise.
+*/
+function isJsonSchemaNullable(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema)) return false;
+	const anyOfBranch = schema.anyOf !== void 0 && Array.isArray(schema.anyOf) && schema.anyOf.length === 2 && isJsonSchema(schema.anyOf[0]) && isJsonSchemaNull(schema.anyOf[1]);
+	const typeBranch = Array.isArray(schema.type) && schema.type.length === 2 && (schema.type[0] === "null" && isSetString(schema.type[1]) && schema.type[1] !== "null" && JSON_SCHEMA_TYPE_SET.has(schema.type[1]) || schema.type[1] === "null" && isSetString(schema.type[0]) && schema.type[0] !== "null" && JSON_SCHEMA_TYPE_SET.has(schema.type[0]));
+	return anyOfBranch || typeBranch;
+}
+/**
+* Type guard for numeric schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a numeric schema, false otherwise.
+*/
+function isJsonSchemaNumber(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema) || schema.type !== "number" && schema.type !== "integer") return false;
+	return isOptionalString(schema.format) && isOptionalNumber(schema.minimum) && isOptionalNumber(schema.exclusiveMinimum) && isOptionalNumber(schema.maximum) && isOptionalNumber(schema.exclusiveMaximum) && isOptionalNumber(schema.multipleOf) && isOptionalNumber(schema.default) && (schema.enum === void 0 || isArrayOf(schema.enum, isSetNumber));
+}
+/**
+* Type guard for integer schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an integer schema, false otherwise.
+*/
+function isJsonSchemaInteger(input) {
+	return isJsonSchemaNumber(input) && input.type === "integer";
+}
+/**
+* Type guard for decimal schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a decimal schema, false otherwise.
+*/
+function isJsonSchemaDecimal(input) {
+	return isJsonSchemaNumber(input) && input.type === "number";
+}
+/**
+* Type guard for object schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an object schema, false otherwise.
+*/
+function isJsonSchemaObject(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "object" && (schema.properties === void 0 || isRecordOfSchemaLike(schema.properties)) && (schema.patternProperties === void 0 || isRecordOfSchemaLike(schema.patternProperties)) && (schema.additionalProperties === void 0 || isSetBoolean(schema.additionalProperties) || isJsonSchema(schema.additionalProperties)) && (schema.required === void 0 || isStringArray(schema.required)) && (schema.unevaluatedProperties === void 0 || isSetBoolean(schema.unevaluatedProperties) || isJsonSchema(schema.unevaluatedProperties)) && (schema.dependencies === void 0 || isSetObject(schema.dependencies) && Object.values(schema.dependencies).every((item) => isStringArray(item) || isJsonSchema(item))) && (schema.dependentRequired === void 0 || isRecordOfStringArrays(schema.dependentRequired)) && (schema.dependentSchemas === void 0 || isRecordOfSchemaLike(schema.dependentSchemas)) && isOptionalNumber(schema.minProperties) && isOptionalNumber(schema.maxProperties) && (schema.primaryKey === void 0 || isStringArray(schema.primaryKey)) && isOptionalString(schema.databaseSchema);
+}
+/**
+* Type guard for string schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a string schema, false otherwise.
+*/
+function isJsonSchemaString(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "string" && isOptionalNumber(schema.minLength) && isOptionalNumber(schema.maxLength) && isOptionalString(schema.pattern) && isOptionalString(schema.format) && isOptionalString(schema.default) && (schema.enum === void 0 || isArrayOf(schema.enum, isSetString)) && isOptionalString(schema.contentMediaType) && isOptionalString(schema.contentEncoding) && isOptionalString(schema.contentSchema);
+}
+/**
+* Type guard for set-like array schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a set-like array schema, false otherwise.
+*/
+function isJsonSchemaSet(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "array" && schema.uniqueItems === true && isOptionalJsonSchemaArray(schema.prefixItems) && isOptionalJsonSchema(schema.items) && isOptionalJsonSchema(schema.contains) && isOptionalNumber(schema.minItems) && isOptionalNumber(schema.maxItems) && isOptionalNumber(schema.minContains) && isOptionalNumber(schema.maxContains) && (schema.unevaluatedItems === void 0 || isSetBoolean(schema.unevaluatedItems) || isJsonSchema(schema.unevaluatedItems));
+}
+/**
+* Type guard for record schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a record schema, false otherwise.
+*/
+function isJsonSchemaRecord(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "object" && (schema.patternProperties === void 0 || isRecordOfSchemaLike(schema.patternProperties)) && (schema.additionalProperties === void 0 || isSetBoolean(schema.additionalProperties) || isJsonSchema(schema.additionalProperties)) && isOptionalJsonSchema(schema.propertyNames);
+}
+/**
+* Type guard for tuple schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a tuple schema, false otherwise.
+*/
+function isJsonSchemaTuple(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && schema.type === "array" && isArrayOf(schema.prefixItems, isJsonSchema) && isOptionalNumber(schema.minItems) && isOptionalNumber(schema.maxItems) && isOptionalJsonSchema(schema.items) && isOptionalJsonSchema(schema.contains) && isOptionalBoolean(schema.uniqueItems) && isOptionalNumber(schema.minContains) && isOptionalNumber(schema.maxContains) && (schema.unevaluatedItems === void 0 || isSetBoolean(schema.unevaluatedItems) || isJsonSchema(schema.unevaluatedItems));
+}
+/**
+* Type guard for undefined-representing schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an undefined-representing schema, false otherwise.
+*/
+function isJsonSchemaUndefined(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && isJsonSchemaAny(schema.not) && (schema.default === void 0 || schema.default === void 0);
+}
+/**
+* Type guard for primitive-union schema variants.
+*
+* @param input - The value to check.
+* @returns True if the input is a primitive-union schema variant, false otherwise.
+*/
+function isJsonSchemaPrimitiveUnion(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!hasValidJsonSchemaKeywords(schema)) return false;
+	if (isSetString(schema.type) && JSON_SCHEMA_PRIMITIVE_TYPE_SET.has(schema.type)) {
+		if (schema.enum === void 0) return true;
+		if (!Array.isArray(schema.enum)) return false;
+		if (schema.type === "string") return schema.enum.every((value) => isSetString(value)) && (schema.default === void 0 || isSetString(schema.default));
+		if (schema.type === "number") return schema.enum.every((value) => isSetNumber(value)) && (schema.default === void 0 || isSetNumber(schema.default));
+		if (schema.type === "boolean") return schema.enum.every((value) => isSetBoolean(value)) && (schema.default === void 0 || isSetBoolean(schema.default));
+		if (schema.type === "integer") {
+			if (schema.format !== "int64") return false;
+			return schema.enum.every((value) => isSetBigint(value)) && (schema.default === void 0 || isSetBigint(schema.default));
+		}
+		return schema.type === "null" && schema.enum.every((value) => value === null) && (schema.default === void 0 || schema.default === null);
+	}
+	return isOptionalPrimitiveTypeArray(schema.type) && schema.type !== void 0;
+}
+/**
+* Type guard for union schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a union schema, false otherwise.
+*/
+function isJsonSchemaUnion(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && (isJsonSchemaPrimitiveUnion(schema) || isJsonSchemaAnyOf(schema));
+}
+/**
+* Type guard for permissive unknown schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a permissive unknown schema, false otherwise.
+*/
+function isJsonSchemaUnknown(input) {
+	return isJsonSchemaAny(input);
+}
+/**
+* Type guard for `anyOf` composition schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is an `anyOf` schema, false otherwise.
+*/
+function isJsonSchemaAnyOf(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && isArrayOf(schema.anyOf, isJsonSchema);
+}
+/**
+* Type guard for reference schemas.
+*
+* @param input - The value to check.
+* @returns True if the input is a reference schema, false otherwise.
+*/
+function isJsonSchemaRef(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	return hasValidJsonSchemaKeywords(schema) && isSetString(schema.$ref);
+}
+/**
+* Type guard for Standard Schema V1 objects.
+*
+* @param input - The value to check.
+* @returns True if the input is a Standard Schema V1 object, false otherwise.
+*/
+function isStandardSchema(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!isSetObject(schema["~standard"])) return false;
+	const standard = schema["~standard"];
+	return standard.version === 1 && isFunction(standard.validate);
+}
+/**
+* Type guard for Valibot BaseSchema objects.
+*
+* @param input - The value to check.
+* @returns True if the input is a Valibot BaseSchema, false otherwise.
+*/
+function isValibotSchema(input) {
+	if (!isSetObject(input) || !isStandardSchema(input)) return false;
+	const schema = input;
+	return schema.kind === "schema" && isSetString(schema.type) && isSetBoolean(schema.async) && isFunction(schema.reference) && isSetString(schema.expects) && isFunction(schema["~run"]);
+}
+/**
+* Type guard for JSON Schema types.
+*
+* @remarks
+* This function checks if the input is a JSON Schema type, which is defined as having a `type` property or a `$ref` property. This is used to determine if a given input conforms to the structure of a JSON Schema definition that includes type information.
+*
+* @param input - The value to check.
+* @returns True if the input is a JSON Schema type, false otherwise.
+*/
+function isJsonSchema(input) {
+	return isJsonSchemaString(input) || isJsonSchemaInteger(input) || isJsonSchemaDecimal(input) || isJsonSchemaBigint(input) || isJsonSchemaBoolean(input) || isJsonSchemaDate(input) || isJsonSchemaEnum(input) || isJsonSchemaLiteral(input) || isJsonSchemaNativeEnum(input) || isJsonSchemaNull(input) || isJsonSchemaArray(input) || isJsonSchemaObject(input) || isJsonSchemaRecord(input) || isJsonSchemaTuple(input) || isJsonSchemaUnion(input) || isJsonSchemaUndefined(input) || isJsonSchemaRef(input) || isJsonSchemaNever(input) || isJsonSchemaMap(input) || isJsonSchemaAny(input) || isJsonSchemaNullable(input) || isJsonSchemaAllOf(input) || isJsonSchemaUnknown(input) || isJsonSchemaSet(input);
+}
+/**
+* Type guard for JSON Schemas that only accept `null`.
+*
+* @remarks
+* This function checks if the input is a JSON Schema that exclusively accepts the `null` type. It verifies that the input is a valid JSON Schema and that its `type` property is set to "null". This is useful for identifying schemas that are specifically designed to allow only `null` values.
+*
+* @param input - The value to check.
+* @returns True if the input is a JSON Schema that only accepts `null`, false otherwise.
+*/
+function isNullOnlyJsonSchema(input) {
+	return isJsonSchemaNull(input);
+}
+/**
+* Type guard for untyped schema objects.
+*
+* @remarks
+* This function checks if the input is an untyped schema object, which is defined as having certain properties that are commonly found in untyped schema definitions. This includes properties such as `id`, `title`, `description`, `$schema`, `tsType`, `markdownType`, `type`, `required`, `tags`, `args`, `properties`, and `resolve`. The function verifies that these properties, if present, conform to the expected types (e.g., strings for certain properties, arrays for others). This type guard is used to determine if a given input can be treated as an untyped schema object within the context of the Powerlines schema system.
+*
+* @param input - The value to check.
+* @returns True if the input is an untyped schema object, false otherwise.
+*/
+function isUntypedSchema(input) {
+	if (!isSetObject(input)) return false;
+	const schema = input;
+	if (!isUntypedTypeDescriptor(schema)) return false;
+	if ("id" in schema && !isSetString(schema.id)) return false;
+	if ("resolve" in schema && !isFunction(schema.resolve)) return false;
+	if ("properties" in schema && !isRecordOfUntypedSchema(schema.properties)) return false;
+	if ("required" in schema && !isStringArray(schema.required)) return false;
+	if ("title" in schema && !isSetString(schema.title)) return false;
+	if ("description" in schema && !isSetString(schema.description)) return false;
+	if ("$schema" in schema && !isSetString(schema.$schema)) return false;
+	if ("tags" in schema && !isStringArray(schema.tags)) return false;
+	if ("args" in schema && (!Array.isArray(schema.args) || !schema.args.every((item) => isUntypedFunctionArg(item)))) return false;
+	if ("returns" in schema && !isUntypedTypeDescriptor(schema.returns)) return false;
+	return true;
+}
+/**
+* Strict type guard for untyped schema objects.
+*
+* @remarks
+* This guard narrows values to the Untyped schema model while explicitly
+* rejecting values that are also valid JSON Schema instances.
+*
+* @param input - The value to check.
+* @returns True if the input is an untyped schema and not a JSON Schema.
+*/
+function isUntypedSchemaStrict(input) {
+	return isUntypedSchema(input) && !isJsonSchema(input);
+}
+/**
+* Type guard for untyped input objects.
+*
+* @remarks
+* This function checks if the input is an untyped input object, which is defined as having certain properties that are commonly found in untyped input definitions. This includes properties such as `$schema` and `$resolve`. The function verifies that these properties, if present, conform to the expected types (e.g., objects for `$schema`, functions for `$resolve`). This type guard is used to determine if a given input can be treated as an untyped input object within the context of the Powerlines schema system.
+*
+* @param input - The value to check.
+* @returns True if the input is an untyped input object, false otherwise.
+*/
+function isUntypedInput(input) {
+	if (!isSetObject(input)) return false;
+	const inputObject = input;
+	if ("$schema" in inputObject && !isUntypedSchema(inputObject.$schema)) return false;
+	if ("$resolve" in inputObject && !isFunction(inputObject.$resolve)) return false;
+	return true;
+}
+/**
+* Strict type guard for untyped input objects.
+*
+* @remarks
+* This guard narrows values to the Untyped input-object model while
+* explicitly rejecting values that are valid JSON Schema objects.
+*
+* @param input - The value to check.
+* @returns True if the input is an untyped input object and not JSON Schema.
+*/
+function isUntypedInputStrict(input) {
+	if (!isUntypedInput(input) || isJsonSchema(input)) return false;
+	const inputObject = input;
+	if ("$schema" in inputObject && inputObject.$schema !== void 0 && !isUntypedSchemaStrict(inputObject.$schema)) return false;
+	return true;
+}
+/**
+* Type guard for Powerlines Schema objects.
+*
+* @param input - The value to check.
+* @returns True if the input is a Powerlines Schema object, false otherwise.
+*/
+function isSchema(input) {
+	return isSetObject(input) && "schema" in input && isJsonSchema(input.schema) && "variant" in input && isSetString(input.variant) && "hash" in input && isSetString(input.hash);
+}
+/**
+* Type guard for extracted schema objects that include source information.
+*
+* @param input - The value to check.
+* @returns True if the input is a SchemaWithSource object, false otherwise.
+*/
+function isSchemaWithSource(input) {
+	return isSchema(input) && "source" in input && isSetObject(input.source) && "schema" in input.source && "variant" in input.source && isSetString(input.source.variant);
+}
+/**
+* Type guard for Powerlines Schemas that are in Object form.
+*
+* @param input - The value to check.
+* @returns True if the input is a Powerlines Schema object in Object form, false otherwise.
+*/
+function isSchemaObject(input) {
+	return isSchema(input) && isJsonSchemaObject(input.schema);
+}
 
-export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames, VALID_SOURCE_FILE_EXTENSIONS, addProperty, applyJsonSchemaMetadata, bundle, bundleReferences, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaWithSource, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getJsonSchema, getJsonSchemaObject, getJsonSchemaType, getPrimarySchemaType, getProperties, getPropertiesList, isJsonSchema, isJsonSchemaAllOf, isJsonSchemaAny, isJsonSchemaAnyOf, isJsonSchemaArray, isJsonSchemaBigint, isJsonSchemaBoolean, isJsonSchemaDate, isJsonSchemaDecimal, isJsonSchemaEnum, isJsonSchemaInteger, isJsonSchemaKeywords, isJsonSchemaLiteral, isJsonSchemaMap, isJsonSchemaNativeEnum, isJsonSchemaNever, isJsonSchemaNull, isJsonSchemaNullable, isJsonSchemaNumber, isJsonSchemaObject, isJsonSchemaPrimitiveType, isJsonSchemaPrimitiveUnion, isJsonSchemaRecord, isJsonSchemaRef, isJsonSchemaSet, isJsonSchemaString, isJsonSchemaTuple, isJsonSchemaType, isJsonSchemaUndefined, isJsonSchemaUnion, isJsonSchemaUnknown, isNullOnlyJsonSchema, isPropertyOptional, isSchema, isSchemaNullable, isSchemaObject, isSchemaWithSource, isStandardSchema, isUntypedInput, isUntypedInputStrict, isUntypedSchema, isUntypedSchemaStrict, isValibotSchema, isValidSchemaInputFile, merge, readSchema, readSchemaSafe, readSchemaTypes, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };
+//#endregion
+//#region src/helpers.ts
+/**
+* Retrieves the JSON Schema from a Schema wrapper or returns the input if it's already a JSON Schema.
+*
+* @remarks
+* This function checks if the input is a Schema wrapper (an object with a `schema` property) and returns the `schema` if it is. If the input is already a JSON Schema, it returns it directly. This allows for flexibility in handling both raw JSON Schema objects and wrapped schemas without needing to check the type at every usage point.
+*
+* @param input - The input which can be either a Schema wrapper or a JSON Schema object.
+* @returns The JSON Schema object.
+* @throws Will throw a TypeError if the input is neither a valid Schema wrapper nor a valid JSON Schema object.
+*/
+function getJsonSchema(input) {
+	const schema = isSchema(input) ? input.schema : input;
+	if (!isJsonSchema(schema)) throw new TypeError(`The provided input is not a valid JSON Schema: ${JSON.stringify(schema, null, 2)}`);
+	return schema;
+}
+/**
+* Retrieves the JSON Schema in Object form from a Schema wrapper or returns the input if it's already a JSON Schema.
+*
+* @remarks
+* This function checks if the input is a Schema wrapper (an object with a `schema` property) and returns the `schema` if it is. If the input is already a JSON Schema object, it returns it directly. This allows for flexibility in handling both raw JSON Schema objects and wrapped schemas without needing to check the type at every usage point.
+*
+* @param input - The input which can be either a Schema wrapper or a JSON Schema object.
+* @returns The JSON Schema object.
+* @throws Will throw a TypeError if the input is neither a valid Schema wrapper nor a valid JSON Schema object.
+*/
+function getJsonSchemaObject(input) {
+	const schema = getJsonSchema(input);
+	if (!isJsonSchemaObject(schema)) throw new TypeError(`The provided input is not a valid JSON Schema object: ${JSON.stringify(schema, null, 2)}`);
+	return schema;
+}
+/**
+* Extracts object properties from a JSON Schema object form.
+*
+* @remarks
+* This function returns an empty object if the schema is not an object form or if it has no properties.
+*
+* @param obj - The JSON Schema object form or a Schema wrapper to extract properties from.
+* @returns An object mapping property names to their corresponding JSON Schema fragments, including metadata.
+*/
+function getProperties(obj) {
+	const properties = {};
+	const schema = getJsonSchemaObject(obj);
+	if (!isSetObject(schema.properties)) return properties;
+	for (const [key, value] of Object.entries(schema.properties)) {
+		const propertySchema = {};
+		if (typeof value !== "boolean") Object.assign(propertySchema, value);
+		properties[key] = {
+			...propertySchema,
+			name: key,
+			required: !isPropertyOptional(schema, key),
+			default: schema.default?.[key] ?? propertySchema.default
+		};
+	}
+	return properties;
+}
+/**
+* Returns object properties as an array.
+*
+* @remarks
+* This is a convenience function that extracts properties using `getProperties` and returns them as an array.
+*
+* @param obj - The JSON Schema object form or a Schema wrapper to extract properties from.
+* @returns An array of JSON Schema fragments representing the properties, each including metadata.
+*/
+function getPropertiesList(obj) {
+	return Object.values(getProperties(obj));
+}
+/**
+* Adds a property to a JSON Schema object form.
+*
+* @remarks
+* This function modifies the provided schema in place by adding a new property with the specified name and schema. It also updates the `required` array based on the `optional` flag of the property. If the property is marked as optional, it will be removed from the `required` array; otherwise, it will be added to it.
+*
+* @param obj - The JSON Schema object form or a Schema wrapper to which the property should be added.
+* @param name - The name of the property to add.
+* @param property - The JSON Schema fragment representing the property's schema, including metadata.
+* @throws Will throw an error if the provided schema is not an object form.
+*/
+function addProperty(obj, name, property) {
+	const schema = getJsonSchemaObject(obj);
+	schema.properties ??= {};
+	schema.required ??= [];
+	schema.properties[name] = {
+		...property,
+		name
+	};
+	if (!schema.required.includes(name)) schema.required.push(name);
+	if (schema.required.length === 0) delete schema.required;
+}
+/**
+* Merges multiple JSON Schemas into one.
+*
+* @remarks
+* This function takes multiple JSON Schemas or Schema wrappers and merges them into a single JSON Schema object. The merging process combines properties and metadata from all provided schemas, with later schemas in the arguments list taking precedence over earlier ones in case of conflicts. The resulting schema will include all unique properties and metadata from the input schemas.
+*
+* @param schemas - An array of JSON Schemas or Schema wrappers to merge.
+* @returns A new JSON Schema that is the result of merging all input schemas.
+*/
+function merge(...schemas) {
+	let result = {};
+	for (const schema of schemas.reverse()) if (!result.type || result.type === schema.type) {
+		result = defu$1(result, getJsonSchema(schema));
+		if (isJsonSchemaObject(result)) result.required = getUnique(result.required ?? []);
+	}
+	return result;
+}
+/**
+* Returns whether a JSON Schema fragment accepts `null`.
+*
+* @remarks
+* This is true if the schema has `nullable: true` or if its `type` includes `"null"`.
+*
+* @param schema - The JSON Schema fragment to check.
+* @returns `true` if the schema accepts `null`, otherwise `false`.
+*/
+function isSchemaNullable(schema) {
+	if (!isSetObject(schema)) return false;
+	if (schema.nullable === true) return true;
+	return readSchemaTypes(schema).includes("null");
+}
+/**
+* Returns whether an object property is optional (not listed in `required`).
+*
+* @remarks
+* In JSON Schema, object properties are optional by default unless they are listed in the `required` array of the parent schema. This function checks whether a given property name is not included in the `required` array of its parent schema, indicating that it is optional.
+*
+* @param parent - The parent JSON Schema object containing the property.
+* @param propertyName - The name of the property to check for optionality.
+* @returns `true` if the property is optional, otherwise `false`.
+*/
+function isPropertyOptional(parent, propertyName) {
+	if (!parent.properties?.[propertyName]) throw new Error(`The property "${propertyName}" does not exist in the parent schema.`);
+	return !(parent.required ?? []).includes(propertyName);
+}
+/**
+* Checks if a given file name has a valid schema input file extension.
+*
+* @param fileName - The file name to check for a valid schema input extension.
+* @returns `true` if the file name has a valid schema input extension, otherwise `false`.
+*/
+function isValidSchemaInputFile(fileName) {
+	return VALID_SOURCE_FILE_EXTENSIONS.includes(findFileExtensionSafe(fileName));
+}
+
+//#endregion
+//#region src/validate.ts
+/**
+* Gets an Ajv validator instance for a given JSON Schema.
+*
+* @param schema - The JSON Schema to create a validator for.
+* @returns An Ajv instance with the schema added.
+*/
+function getValidator(schema) {
+	const ajv = new Ajv({
+		schemas: [schema],
+		code: {
+			source: true,
+			esm: true
+		}
+	});
+	addFormats(ajv);
+	return ajv;
+}
+
+//#endregion
+//#region src/codegen.ts
+/**
+* Stringifies a value for generated TypeScript code.
+*/
+function stringifyValue(value, type) {
+	return isUndefined$1(value) ? "undefined" : isNull$1(value) ? "null" : type === "boolean" || isBoolean$1(value) ? String(toBool(value)) : type === "number" || isNumber$1(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";
+	const objectSchema = schema;
+	if (isSetString$1(objectSchema.$ref)) return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(objectSchema.$ref)?.[1] ?? objectSchema.$ref;
+	const primaryType = 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(objectSchema.items)}[]`;
+	if (objectSchema.type === "object" || objectSchema.properties || objectSchema.additionalProperties) {
+		if (isJsonSchema(objectSchema.additionalProperties)) return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;
+		if (isJsonSchemaObject(objectSchema)) {
+			const required = objectSchema.required ?? [];
+			return `{ ${getPropertiesList(objectSchema).map((property) => {
+				const suffix = !required.includes(property.name) || isSchemaNullable(property) ? `${!required.includes(property.name) ? "?" : ""}${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 isNull$1(value) ? "null" : isBoolean$1(value) ? "boolean" : isInteger(value) ? "integer" : isNumber$1(value) ? "number" : isString(value) ? "string" : isObject(value) ? "object" : Array.isArray(value) ? "array" : void 0;
+}
+/**
+* Generates standalone JSON Schema validation code using Ajv.
+*/
+async function generateCode(schemas, refsOrFuncts) {
+	return standaloneCode(getValidator(schemas), refsOrFuncts);
+}
+
+//#endregion
+//#region src/persistence.ts
+/**
+* A helper function to get the cache directory path for storing schemas. This function takes a context object as input and returns the path to the cache directory where schemas are stored. The cache directory is constructed by joining the `cachePath` property from the context with a subdirectory named "schemas". This function is useful for centralizing the logic for determining where schema files should be cached, ensuring that all schema-related file operations use a consistent location for storing and retrieving cached schemas.
+*
+* @param context - The context object providing access to the cache path.
+* @returns The path to the cache directory for storing schemas, constructed by joining the context's `cachePath` with the "schemas" subdirectory.
+*/
+function getCacheDirectory(context) {
+	return joinPaths(context.cachePath, "schemas");
+}
+/**
+* A helper function to get the file path for a cached schema based on the provided context and schema input. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file by joining the cache directory path (obtained from the `getCacheDirectory` function) with a filename derived from the extracted hash. The resulting file path points to where the cached schema should be stored or retrieved from in the file system. This function is essential for ensuring that all operations related to caching schemas use a consistent method for determining the correct file path based on the schema's unique identifier (hash).
+*
+* @param context - The context object providing access to the cache path.
+* @param input - The input schema from which to extract the variant and hash for constructing the cache file path.
+* @returns The file path to the cached schema JSON file, constructed by joining the cache directory path with a filename derived from the extracted hash of the schema input.
+*/
+function getCacheFilePath(context, input) {
+	const hash = extractHash(extractVariant(input), input);
+	return joinPaths(getCacheDirectory(context), `${hash}.json`);
+}
+/**
+* Writes a given schema to the file system using the provided context. This function first checks if the input is a valid schema using the `isSchema` type guard. If the input is not a valid schema, it throws an error indicating that the provided input is invalid. If the input is valid, it proceeds to write the schema to a JSON file in the cache directory specified by the context. The file is named using the hash of the schema to ensure uniqueness and easy retrieval in future operations. The schema is serialized to JSON format before being written to the file system. This function is asynchronous and returns a promise that resolves once the writing operation is complete.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param schema - The schema to be written to the file system, which must be a valid schema object containing a `variant`, `schema`, and `hash` property.
+* @throws Will throw an error if the provided input is not a valid schema.
+*/
+async function writeSchema(context, schema) {
+	if (!isSchema(schema)) throw new Error(`The provided input is not a valid schema. A valid schema must have a "variant" property indicating the type of the input and a "schema" property containing the parsed JSON Schema object.`);
+	await context.fs.write(getCacheFilePath(context, schema), JSON.stringify(schema.schema));
+}
+/**
+* A helper function to read a schema from the file system using the provided context. This function first extracts the variant and hash from the input schema using the `extractVariant` and `extractHash` functions, respectively. It then constructs the file path to the cached schema JSON file based on the cache path provided in the context and the extracted hash. The function checks if the file exists in the cache; if it does not exist, it returns `undefined`. If the file exists, it reads the contents of the file, parses it as JSON, and returns the resulting object. This function is asynchronous and returns a promise that resolves to either the parsed schema object or `undefined` if the schema is not found in the cache.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+* @returns A promise that resolves to the parsed schema object if found in the cache, or `undefined` if the schema does not exist in the cache.
+*/
+async function readSchemaSafe(context, input) {
+	const cacheFilePath = getCacheFilePath(context, input);
+	if (!await context.fs.exists(cacheFilePath)) return;
+	const data = await context.fs.read(cacheFilePath);
+	if (!data) return;
+	return JSON.parse(data);
+}
+/**
+* Reads a schema from the file system using the provided context and input. This function first attempts to read the schema using the `readSchemaSafe` helper function, which returns `undefined` if the schema is not found in the cache. If the schema is not found, this function throws an error indicating that the schema with the specified variant and hash does not exist in the cache. The error message suggests that this may be due to a missing or corrupted cache file, or because the schema has not been written to the cache yet. It advises ensuring that the schema is properly written to the cache before attempting to read it. If the schema is successfully read from the cache, it is returned as a parsed object. This function is asynchronous and returns a promise that resolves to the parsed schema object if found, or throws an error if the schema is not found in the cache.
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The input schema from which to extract the variant and hash for locating the cached schema file.
+* @returns A promise that resolves to the parsed schema object if found in the cache, or throws an error if the schema does not exist in the cache.
+* @throws Will throw an error if the schema with the specified variant and hash does not exist in the cache.
+*/
+async function readSchema(context, input) {
+	const schema = await readSchemaSafe(context, input);
+	if (!schema) {
+		const variant = extractVariant(input);
+		const hash = extractHash(variant, input);
+		throw new Error(`The ${variant} schema with hash "${hash}" does not exist in the cache. This may be due to a missing or corrupted cache file, or because the schema has not been written to the cache yet. Please ensure that the schema is properly written to the cache before attempting to read it.`);
+	}
+	return schema;
+}
+
+//#endregion
+//#region src/reflection.ts
+/**
+* Maps a Deepkit numeric `brand` to JSON Schema `type` and `format`.
+*
+* @remarks
+* This function takes a `TypeNumberBrand` (which represents specific numeric types in Deepkit, such as `integer`, `float`, `int8`, etc.) and returns a corresponding JSON Schema fragment that includes the appropriate `type`, `format`, and any relevant keywords (like `multipleOf` for integers). If the brand is not recognized, it defaults to a generic JSON Schema for numbers.
+*
+* @param brand - The Deepkit numeric brand to convert.
+* @return A JSON Schema fragment representing the numeric type corresponding to the provided brand.
+*/
+function numberBrandToJsonSchema(brand) {
+	switch (brand) {
+		case TypeNumberBrand.integer: return {
+			type: "integer",
+			format: "int32",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.int8: return {
+			type: "integer",
+			format: "int8",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.uint8: return {
+			type: "integer",
+			format: "uint8",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.int16: return {
+			type: "integer",
+			format: "int16",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.uint16: return {
+			type: "integer",
+			format: "uint16",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.int32: return {
+			type: "integer",
+			format: "int32",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.uint32: return {
+			type: "integer",
+			format: "uint32",
+			multipleOf: 1
+		};
+		case TypeNumberBrand.float:
+		case TypeNumberBrand.float32: return {
+			type: "number",
+			format: "float"
+		};
+		case TypeNumberBrand.float64: return {
+			type: "number",
+			format: "double"
+		};
+		case void 0:
+		default: return { type: "number" };
+	}
+}
+function withReflectionTags(reflection, schema) {
+	if (!isSetObject(schema) || !isSetObject(reflection?.tags)) return schema;
+	const updatedSchema = { ...schema };
+	const tags = reflection.tags;
+	if (isSetString(tags.title)) updatedSchema.title = tags.title;
+	if (isSetArray(tags.alias)) updatedSchema.alias = tags.alias;
+	if (!isUndefined(tags.hidden)) updatedSchema.hidden = tags.hidden;
+	if (!isUndefined(tags.ignore)) updatedSchema.ignore = tags.ignore;
+	if (!isUndefined(tags.internal)) updatedSchema.internal = tags.internal;
+	if (!isUndefined(tags.runtime)) updatedSchema.runtime = tags.runtime;
+	if (!isUndefined(tags.readonly)) updatedSchema.readOnly = tags.readonly;
+	return updatedSchema;
+}
+function withNullable(schema) {
+	if (!isSetObject(schema)) return { anyOf: [schema, {
+		type: "null",
+		default: null
+	}] };
+	const rawType = schema.type;
+	const types = Array.isArray(rawType) ? [...rawType] : rawType ? [rawType] : [];
+	if (!types.includes("null")) types.push("null");
+	return {
+		...schema,
+		type: types.length === 1 ? types[0] : types
+	};
+}
+/**
+* Converts a Deepkit type reflection into a JSON Schema (draft-07) fragment.
+*/
+function reflectionToJsonSchema(reflection) {
+	return reflectionToJsonSchemaInner(reflection);
+}
+function reflectionToJsonSchemaInner(reflection) {
+	switch (reflection.kind) {
+		case ReflectionKind.any:
+		case ReflectionKind.unknown:
+		case ReflectionKind.void:
+		case ReflectionKind.object: return withReflectionTags(reflection, { name: reflection.typeName });
+		case ReflectionKind.never: return;
+		case ReflectionKind.undefined:
+		case ReflectionKind.null: return withReflectionTags(reflection, {
+			type: "null",
+			name: reflection.typeName,
+			default: null
+		});
+		case ReflectionKind.string: return withReflectionTags(reflection, {
+			type: "string",
+			name: reflection.typeName
+		});
+		case ReflectionKind.boolean: return withReflectionTags(reflection, {
+			type: "boolean",
+			name: reflection.typeName
+		});
+		case ReflectionKind.number: return withReflectionTags(reflection, numberBrandToJsonSchema(reflection.brand));
+		case ReflectionKind.bigint: return withReflectionTags(reflection, {
+			type: "integer",
+			name: reflection.typeName,
+			format: "int64"
+		});
+		case ReflectionKind.regexp: return withReflectionTags(reflection, {
+			type: "string",
+			name: reflection.typeName,
+			format: "regex",
+			contentMediaType: "text/regex"
+		});
+		case ReflectionKind.literal: {
+			const { literal } = reflection;
+			if (isBigInt(literal)) return withReflectionTags(reflection, {
+				type: "integer",
+				name: reflection.typeName,
+				format: "int64",
+				const: literal
+			});
+			if (isRegExp(literal)) return withReflectionTags(reflection, {
+				type: "string",
+				name: reflection.typeName,
+				format: "regex",
+				const: literal.source
+			});
+			return withReflectionTags(reflection, {
+				type: getJsonSchemaType(literal),
+				name: reflection.typeName,
+				const: literal
+			});
+		}
+		case ReflectionKind.templateLiteral: return withReflectionTags(reflection, { type: "string" });
+		case ReflectionKind.enum: {
+			const values = reflection.values.filter((value) => isString(value) || isInteger(value) || isBigInt(value) || isNumber(value) || isBoolean(value) || isNull(value));
+			if (values.length === 0) return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				description: reflection.description,
+				enum: []
+			});
+			return withReflectionTags(reflection, {
+				type: values.every((value) => isString(value)) ? "string" : values.every((value) => isInteger(value) || isBigInt(value)) ? "integer" : values.every((value) => isNumber(value)) ? "number" : values.every((value) => isBoolean(value)) ? "boolean" : values.every((value) => isNull(value)) ? "null" : values.reduce((ret, value) => {
+					const type = getJsonSchemaType(value);
+					if (isJsonSchemaPrimitiveType(type) && !ret.includes(type)) ret.push(type);
+					return ret;
+				}, []),
+				name: reflection.typeName,
+				description: reflection.description,
+				enum: values,
+				default: values.length === 1 ? values[0] : void 0
+			});
+		}
+		case ReflectionKind.array: {
+			const items = reflectionToJsonSchemaInner(reflection.type);
+			return withReflectionTags(reflection, {
+				type: "array",
+				name: reflection.typeName,
+				items: items ?? {}
+			});
+		}
+		case ReflectionKind.tuple: {
+			const items = reflection.types.map((member) => reflectionToJsonSchemaInner(member.type)).filter((item) => item !== void 0);
+			if (items.length <= 1) return withReflectionTags(reflection, {
+				type: "array",
+				name: reflection.typeName,
+				items: items.length === 1 ? items[0] : {}
+			});
+			return withReflectionTags(reflection, {
+				type: "array",
+				name: reflection.typeName,
+				prefixItems: items,
+				minItems: items.length,
+				maxItems: items.length
+			});
+		}
+		case ReflectionKind.union: {
+			const branches = reflection.types.map((inner) => reflectionToJsonSchemaInner(inner)).filter((branch) => branch !== void 0);
+			if (!reflection.types.some((inner) => inner.kind === ReflectionKind.null || inner.kind === ReflectionKind.undefined)) return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				anyOf: branches
+			});
+			const nonNull = branches.filter((branch) => !isNullOnlyJsonSchema(branch));
+			if (nonNull.length === 0) return withReflectionTags(reflection, {
+				type: "null",
+				default: null
+			});
+			if (nonNull.length === 1) {
+				const first = nonNull[0];
+				if (!isSetObject(first)) return withNullable(withReflectionTags(reflection, {
+					name: reflection.typeName,
+					anyOf: [first]
+				}));
+				return withNullable(withReflectionTags(reflection, {
+					name: reflection.typeName,
+					...first
+				}));
+			}
+			const enumValues = nonNull.map((branch) => isSetObject(branch) ? branch.const : void 0).filter((value) => value === null || typeof value === "string" || typeof value === "number" || typeof value === "bigint" || typeof value === "boolean");
+			if (enumValues.length === nonNull.length) return withNullable(withReflectionTags(reflection, {
+				name: reflection.typeName,
+				enum: enumValues
+			}));
+			const discriminator = tryReflectionDiscriminator(reflection.types);
+			if (discriminator && isSetObject(discriminator)) return withNullable(withReflectionTags(reflection, {
+				name: reflection.typeName,
+				...discriminator
+			}));
+			return withNullable(withReflectionTags(reflection, {
+				name: reflection.typeName,
+				anyOf: nonNull
+			}));
+		}
+		case ReflectionKind.intersection: {
+			const members = reflection.types.map((inner) => reflectionToJsonSchemaInner(inner)).filter((item) => item !== void 0);
+			if (members.length === 0) return;
+			if (members.length === 1) {
+				if (!isSetObject(members[0])) return members[0];
+				return withReflectionTags(reflection, {
+					name: reflection.typeName,
+					...members[0]
+				});
+			}
+			if (members.every(isJsonSchemaObject)) return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				...mergeObjectSchemas(members)
+			});
+			return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				allOf: members
+			});
+		}
+		case ReflectionKind.promise: return reflectionToJsonSchemaInner(reflection.type);
+		case ReflectionKind.objectLiteral: return objectReflectionToJsonSchema(reflection);
+		case ReflectionKind.class: switch (reflection.classType?.name) {
+			case "Date": return withReflectionTags(reflection, {
+				type: "string",
+				format: "date-time"
+			});
+			case "RegExp": return withReflectionTags(reflection, {
+				type: "string",
+				format: "regex"
+			});
+			case "URL": return withReflectionTags(reflection, {
+				type: "string",
+				format: "uri"
+			});
+			case "Set": {
+				const itemType = reflection.arguments?.[0];
+				return withReflectionTags(reflection, {
+					type: "array",
+					items: (itemType ? reflectionToJsonSchemaInner(itemType) : void 0) ?? {},
+					uniqueItems: true
+				});
+			}
+			case "Map": {
+				const valueType = reflection.arguments?.[1];
+				return withReflectionTags(reflection, {
+					type: "object",
+					additionalProperties: (valueType ? reflectionToJsonSchemaInner(valueType) : void 0) ?? true
+				});
+			}
+			case "Uint8Array":
+			case "Uint8ClampedArray":
+			case "Uint16Array":
+			case "Uint32Array":
+			case "Int8Array":
+			case "Int16Array":
+			case "Int32Array":
+			case "Float32Array":
+			case "Float64Array":
+			case "BigInt64Array":
+			case "BigUint64Array": return withReflectionTags(reflection, {
+				type: "string",
+				format: "byte",
+				contentEncoding: "base64"
+			});
+			case void 0:
+			default: return withReflectionTags(reflection, {
+				name: reflection.typeName,
+				description: reflection.description,
+				...objectReflectionToJsonSchema(reflection)
+			});
+		}
+		case ReflectionKind.symbol:
+		case ReflectionKind.property:
+		case ReflectionKind.method:
+		case ReflectionKind.function:
+		case ReflectionKind.parameter:
+		case ReflectionKind.typeParameter:
+		case ReflectionKind.tupleMember:
+		case ReflectionKind.enumMember:
+		case ReflectionKind.rest:
+		case ReflectionKind.indexSignature:
+		case ReflectionKind.propertySignature:
+		case ReflectionKind.methodSignature:
+		case ReflectionKind.infer:
+		case ReflectionKind.callSignature:
+		default: return;
+	}
+}
+function mergeObjectSchemas(schemas) {
+	const merged = {
+		type: "object",
+		properties: {},
+		required: []
+	};
+	for (const schema of schemas) {
+		if (schema.properties) merged.properties = defu(merged.properties, schema.properties);
+		if (schema.required) merged.required = Array.from(new Set([...merged.required ?? [], ...schema.required]));
+		if (schema.additionalProperties !== void 0) merged.additionalProperties = schema.additionalProperties;
+	}
+	if ((merged.required?.length ?? 0) === 0) delete merged.required;
+	return merged;
+}
+function tryReflectionDiscriminator(types) {
+	const nonNullTypes = types.filter((t) => t.kind !== ReflectionKind.null && t.kind !== ReflectionKind.undefined);
+	const objectBranches = nonNullTypes.filter((t) => t.kind === ReflectionKind.objectLiteral || t.kind === ReflectionKind.class);
+	if (objectBranches.length < 2 || objectBranches.length !== nonNullTypes.length) return;
+	let tagKey;
+	const branches = [];
+	for (const branch of objectBranches) {
+		const literalProps = [];
+		for (const member of branch.types) if ((member.kind === ReflectionKind.property || member.kind === ReflectionKind.propertySignature) && typeof member.name === "string" && member.type.kind === ReflectionKind.literal && typeof member.type.literal === "string") literalProps.push({
+			name: member.name,
+			literal: member.type.literal
+		});
+		if (literalProps.length === 0) return;
+		const first = literalProps[0];
+		if (!tagKey) tagKey = first.name;
+		else if (tagKey !== first.name) return;
+		const body = objectReflectionToJsonSchema({
+			...branch,
+			types: branch.types.filter((member) => !((member.kind === ReflectionKind.property || member.kind === ReflectionKind.propertySignature) && member.name === tagKey))
+		});
+		if (!body || !isJsonSchemaObject(body)) return;
+		branches.push({
+			type: "object",
+			properties: {
+				[tagKey]: { const: first.literal },
+				...body.properties ?? {}
+			},
+			required: [tagKey, ...body.required ?? []],
+			additionalProperties: body.additionalProperties ?? false
+		});
+	}
+	if (!tagKey) return;
+	return {
+		oneOf: branches,
+		discriminator: { propertyName: tagKey }
+	};
+}
+function objectReflectionToJsonSchema(type) {
+	const reflection = ReflectionClass.from(type);
+	const schema = {
+		type: "object",
+		name: reflection.getName(),
+		description: reflection.getDescription(),
+		properties: {},
+		required: [],
+		readOnly: reflection.isReadonly(),
+		ignore: reflection.isIgnored(),
+		internal: reflection.isInternal(),
+		runtime: reflection.isRuntime(),
+		hidden: reflection.isHidden(),
+		primaryKey: reflection.getPrimaries().map((primary) => primary.getNameAsString()),
+		...isSetString(reflection.databaseSchemaName) ? { databaseSchemaName: reflection.databaseSchemaName } : {},
+		...isSetString(reflection.getName()) ? { name: reflection.getName() } : {},
+		...isSetString(reflection.getDescription()) ? { description: reflection.getDescription() } : {},
+		...isSetArray(reflection.getAlias()) ? { alias: reflection.getAlias() } : {},
+		...isSetString(reflection.getTitle()) ? { title: reflection.getTitle() } : {}
+	};
+	for (const propertyReflection of reflection.getProperties()) {
+		if (propertyReflection.getKind() === ReflectionKind.indexSignature) {
+			schema.additionalProperties = reflectionToJsonSchemaInner(propertyReflection.type) ?? true;
+			continue;
+		}
+		let property = reflectionToJsonSchemaInner(propertyReflection.type);
+		if (!property) continue;
+		property = {
+			...isSetObject(property) ? property : {},
+			name: propertyReflection.getNameAsString(),
+			description: propertyReflection.getDescription(),
+			readOnly: propertyReflection.isReadonly(),
+			ignore: propertyReflection.isIgnored(),
+			internal: propertyReflection.isInternal(),
+			runtime: propertyReflection.isRuntime(),
+			hidden: propertyReflection.isHidden(),
+			...propertyReflection.hasDefault() ? { default: propertyReflection.getDefaultValue() } : {},
+			...isSetArray(propertyReflection.getGroups()) ? { tags: propertyReflection.getGroups() } : {},
+			...isSetArray(propertyReflection.getAlias()) ? { alias: propertyReflection.getAlias() } : {},
+			...isSetString(propertyReflection.getTitle()) ? { title: propertyReflection.getTitle() } : {}
+		};
+		if (propertyReflection.isNullable()) property = withNullable(property);
+		schema.properties ??= {};
+		schema.properties[propertyReflection.name] = property;
+		if (!propertyReflection.isOptional()) {
+			schema.required ??= [];
+			schema.required.push(propertyReflection.name);
+		}
+	}
+	return schema;
+}
+
+//#endregion
+//#region src/resolve.ts
+/**
+* Compiles a type definition to a module and returns the module.
+*
+* @param context - The context object containing the environment paths.
+* @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param overrides - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolveModule(context, input, overrides) {
+	const fileReference = extractFileReference(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input ${JSON.stringify(input)}. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const result = await bundle(context, fileReference.file, overrides);
+	let resolved;
+	try {
+		resolved = await context.resolver.evalModule(result.text, {
+			filename: result.path,
+			ext: findFileDotExtension(result.path)
+		});
+	} catch (error) {
+		if (isSetString$1(error.message) && new RegExp(`Cannot find module '${context.config.framework?.name || "powerlines"}:.*'`).test(error.message)) {
+			const moduleName = error.message.match(new RegExp(`Cannot find module '(${context.config.framework?.name || "powerlines"}:.*)'`))?.[1];
+			throw new Error(`The module "${moduleName}" could not be resolved while evaluating "${fileReference.file}". It is possible the required built-in modules have not yet been generated. Please check the order of your plugins. ${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text}` : ""}`);
+		}
+		throw new Error(`Failed to evaluate the bundled module for "${fileReference.file}". Error: ${error.message}${context.config.logLevel.general === "debug" || context.config.logLevel.general === "trace" ? `
+
+Bundle output for module:
+${result.text}` : ""}`);
+	}
+	return resolved;
+}
+/**
+* Compiles a type definition to a module and returns the specified export from the module.
+*
+* @param context - The context object containing the environment paths.
+* @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the compiled module.
+*/
+async function resolve(context, input, options) {
+	const fileReference = extractFileReference(input);
+	if (!fileReference) throw new Error(`Failed to extract a file reference from the provided input. The input must be a string or an object with a "file" property that specifies the file path and optional export name.`);
+	const extension = findFileExtensionSafe(fileReference.file);
+	if (extension.startsWith("json")) try {
+		const json = await context.fs.read(fileReference.file);
+		if (!isSetString$1(json)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid JSON.`);
+		return JSON.parse(json);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the JSON file at "${fileReference.file}". Please ensure the file exists and contains valid JSON. Error: ${error.message}`);
+	}
+	else if (extension === "yaml" || extension === "yml") try {
+		const yaml = await context.fs.read(fileReference.file);
+		if (!isSetString$1(yaml)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid YAML.`);
+		return parse$1(yaml);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the YAML file at "${fileReference.file}". Please ensure the file exists and contains valid YAML. Error: ${error.message}`);
+	}
+	else if (extension === "toml") try {
+		const toml = await context.fs.read(fileReference.file);
+		if (!isSetString$1(toml)) throw new Error(`The file at "${fileReference.file}" could not be read as a string. Please ensure the file exists and contains valid TOML.`);
+		return parse(toml);
+	} catch (error) {
+		throw new Error(`Failed to read or parse the TOML file at "${fileReference.file}". Please ensure the file exists and contains valid TOML. Error: ${error.message}`);
+	}
+	const resolved = await resolveModule(context, fileReference, options);
+	let exportName = fileReference.export;
+	if (!exportName) exportName = "default";
+	const resolvedExport = resolved[exportName] ?? resolved[`__Ω${exportName}`];
+	if (resolvedExport === void 0) throw new Error(`The export "${exportName}" could not be resolved in the "${fileReference.file}" module. ${Object.keys(resolved).length === 0 ? `After bundling, no exports were found in the module. Please ensure that the "${fileReference.file}" module has a "${exportName}" export with the desired value.` : `After bundling, the available exports were: ${Object.keys(resolved).join(", ")}. Please ensure that the export exists and is correctly named.`}`);
+	return resolvedExport;
+}
+/**
+* Resolves a type definition to a Deepkit Type reflection. This function compiles the provided type definition to a module, evaluates the module to get the specified export, and then reflects the export to get its Deepkit Type reflection.
+*
+* @param context - The context object containing the environment paths.
+* @param input - The type definition to compile. This can be either a string or a {@link FileReference} object.
+* @param options - Optional overrides for the ESBuild configuration.
+* @returns A promise that resolves to the Deepkit Type reflection.
+*/
+async function resolveReflection(context, input, options) {
+	return reflect(await resolve(context, input, defu(options, { plugins: [esbuildPlugin(context, {
+		reflection: "default",
+		level: "all"
+	})] })));
+}
+
+//#endregion
+//#region src/extract.ts
+const SCHEMA_BUNDLE_BASE_URI = "https://powerlines.invalid/";
+function normalizeUri(uri) {
+	return uri.endsWith("#") ? uri.slice(0, -1) : uri;
+}
+function stripUriFragment(uri) {
+	const hashIndex = uri.indexOf("#");
+	return hashIndex >= 0 ? uri.slice(0, hashIndex) : uri;
+}
+function escapeJsonPointerToken(token) {
+	return token.replaceAll("~", "~0").replaceAll("/", "~1");
+}
+function toJsonPointer(path) {
+	if (path.length === 0) return "";
+	return `/${path.map((segment) => escapeJsonPointerToken(segment)).join("/")}`;
+}
+function resolveUri(reference, baseUri) {
+	try {
+		return normalizeUri(new URL(reference, baseUri).toString());
+	} catch {
+		return normalizeUri(reference);
+	}
+}
+function collectReferenceTargets(value, path, baseUri, uriToPointer, dynamicUriToFragment) {
+	if (!isSetObject$1(value)) return;
+	const schema = value;
+	const pointer = toJsonPointer(path);
+	const currentBaseUri = isSetString(schema.$id) ? resolveUri(schema.$id, baseUri) : baseUri;
+	const currentDocumentUri = stripUriFragment(currentBaseUri);
+	uriToPointer.set(currentBaseUri, pointer);
+	uriToPointer.set(currentDocumentUri, pointer);
+	if (isSetString(schema.$anchor)) uriToPointer.set(`${currentDocumentUri}#${schema.$anchor}`, pointer);
+	if (isSetString(schema.$dynamicAnchor)) {
+		const dynamicTarget = `${currentDocumentUri}#${schema.$dynamicAnchor}`;
+		uriToPointer.set(dynamicTarget, pointer);
+		dynamicUriToFragment.set(dynamicTarget, `#${schema.$dynamicAnchor}`);
+	}
+	for (const [key, child] of Object.entries(schema)) {
+		if (Array.isArray(child)) {
+			child.forEach((entry, index) => {
+				collectReferenceTargets(entry, [
+					...path,
+					key,
+					String(index)
+				], currentBaseUri, uriToPointer, dynamicUriToFragment);
+			});
+			continue;
+		}
+		collectReferenceTargets(child, [...path, key], currentBaseUri, uriToPointer, dynamicUriToFragment);
+	}
+}
+function rewriteReferenceTargets(value, path, baseUri, uriToPointer, dynamicUriToFragment) {
+	if (!isSetObject$1(value)) return;
+	const schema = value;
+	const currentBaseUri = isSetString(schema.$id) ? resolveUri(schema.$id, baseUri) : baseUri;
+	if (isSetString(schema.$ref)) {
+		const resolvedRefUri = resolveUri(schema.$ref, currentBaseUri);
+		const pointer = uriToPointer.get(resolvedRefUri) ?? uriToPointer.get(stripUriFragment(resolvedRefUri));
+		if (pointer !== void 0) schema.$ref = pointer.length > 0 ? `#${pointer}` : "#";
+	}
+	if (isSetString(schema.$dynamicRef)) {
+		const resolvedDynamicRefUri = resolveUri(schema.$dynamicRef, currentBaseUri);
+		const dynamicFragment = dynamicUriToFragment.get(resolvedDynamicRefUri);
+		if (dynamicFragment) schema.$dynamicRef = dynamicFragment;
+		else {
+			const pointer = uriToPointer.get(resolvedDynamicRefUri) ?? uriToPointer.get(stripUriFragment(resolvedDynamicRefUri));
+			if (pointer !== void 0) schema.$dynamicRef = pointer.length > 0 ? `#${pointer}` : "#";
+		}
+	}
+	for (const [key, child] of Object.entries(schema)) {
+		if (Array.isArray(child)) {
+			child.forEach((entry, index) => {
+				rewriteReferenceTargets(entry, [
+					...path,
+					key,
+					String(index)
+				], currentBaseUri, uriToPointer, dynamicUriToFragment);
+			});
+			continue;
+		}
+		rewriteReferenceTargets(child, [...path, key], currentBaseUri, uriToPointer, dynamicUriToFragment);
+	}
+}
+/**
+* Bundles all external references in a JSON Schema into a single schema document by collecting all reference targets and rewriting the references to point to the bundled definitions. This ensures that the resulting schema is self-contained and can be used independently without relying on external documents.
+*
+* @param schema - The JSON Schema to bundle references for.
+* @returns A new JSON Schema with all references bundled and rewritten to point to the bundled definitions.
+*/
+function bundleReferences(schema) {
+	if (!isSetObject$1(schema)) return schema;
+	const bundledSchema = deepClone(schema);
+	const baseUri = isSetString(bundledSchema.$id) ? resolveUri(bundledSchema.$id, SCHEMA_BUNDLE_BASE_URI) : SCHEMA_BUNDLE_BASE_URI;
+	const uriToPointer = /* @__PURE__ */ new Map();
+	const dynamicUriToFragment = /* @__PURE__ */ new Map();
+	collectReferenceTargets(bundledSchema, [], baseUri, uriToPointer, dynamicUriToFragment);
+	rewriteReferenceTargets(bundledSchema, [], baseUri, uriToPointer, dynamicUriToFragment);
+	return bundledSchema;
+}
+function convertNestedUntypedSchema(value) {
+	if (isUntypedSchema(value)) return convertUntypedSchemaToJsonSchema(value);
+	if (isSetObject$1(value)) {
+		if (isUntypedInput(value)) return convertUntypedInputToJsonSchema(value);
+		const nested = value;
+		if ("$schema" in nested && isUntypedSchema(nested.$schema)) return convertUntypedSchemaToJsonSchema(nested.$schema);
+	}
+	return value;
+}
+function convertNestedUntypedSchemaArray(value) {
+	if (!Array.isArray(value)) return value;
+	return value.map((item) => convertNestedUntypedSchema(item));
+}
+function convertValibotSchemaToJsonSchema(schema) {
+	return toJsonSchema(schema, { target: "draft-2020-12" });
+}
+function convertUntypedSchemaToJsonSchema(schema) {
+	const source = schema;
+	const jsonSchema = {};
+	for (const [key, value] of Object.entries(source)) {
+		if (key === "tsType" || key === "markdownType" || key === "tags" || key === "args" || key === "resolve") continue;
+		if (key === "id" && isSetString(value)) {
+			jsonSchema.$id = value;
+			continue;
+		}
+		if (key === "properties" || key === "patternProperties" || key === "dependentSchemas" || key === "$defs" || key === "definitions") {
+			if (!isSetObject$1(value)) {
+				jsonSchema[key] = value;
+				continue;
+			}
+			jsonSchema[key] = Object.fromEntries(Object.entries(value).map(([propertyKey, propertyValue]) => [propertyKey, convertNestedUntypedSchema(propertyValue)]));
+			continue;
+		}
+		if (key === "items" || key === "contains" || key === "if" || key === "then" || key === "else" || key === "not" || key === "propertyNames" || key === "additionalProperties" || key === "unevaluatedProperties") {
+			jsonSchema[key] = convertNestedUntypedSchema(value);
+			continue;
+		}
+		if (key === "oneOf" || key === "anyOf" || key === "allOf") {
+			jsonSchema[key] = convertNestedUntypedSchemaArray(value);
+			continue;
+		}
+		jsonSchema[key] = value;
+	}
+	return jsonSchema;
+}
+function convertUntypedInputToJsonSchema(input) {
+	const inputObject = input;
+	const base = isUntypedSchema(inputObject.$schema) ? convertUntypedSchemaToJsonSchema(inputObject.$schema) : {};
+	const properties = {};
+	for (const [key, value] of Object.entries(inputObject)) {
+		if (key.startsWith("$")) continue;
+		if (!isSetObject$1(value)) continue;
+		if (isUntypedInput(value)) {
+			properties[key] = convertUntypedInputToJsonSchema(value);
+			continue;
+		}
+		const nested = value;
+		if ("$schema" in nested && isUntypedSchema(nested.$schema)) {
+			properties[key] = convertUntypedSchemaToJsonSchema(nested.$schema);
+			continue;
+		}
+		if (isUntypedSchema(value)) properties[key] = convertUntypedSchemaToJsonSchema(value);
+	}
+	if (!isJsonSchemaObject(base)) throw new Error(`Failed to convert untyped input to JSON Schema. The base schema must be a valid JSON Schema object.`);
+	const mergedProperties = {
+		...isSetObject$1(base.properties) ? base.properties : {},
+		...properties
+	};
+	return {
+		...base,
+		type: base.type ?? "object",
+		...Object.keys(mergedProperties).length > 0 ? { properties: mergedProperties } : {}
+	};
+}
+/**
+* Creates a hash string for a given schema definition input.
+*/
+function extractHash(variant, input) {
+	if (isSetString(input)) return murmurhash({
+		variant,
+		input
+	});
+	else if (typeof input === "boolean") return murmurhash({
+		variant,
+		input
+	});
+	else if (isSetObject$1(input)) {
+		if (isZod3Type(input)) return murmurhash({
+			variant,
+			input: input._def
+		});
+		else if (isType(input)) return murmurhash({
+			variant,
+			input: stringifyType$1(input)
+		});
+		else if (isStandardJsonSchema(input)) return murmurhash({
+			variant,
+			input: input["~standard"]
+		});
+		else if (isJsonSchema(input)) return murmurhash({
+			variant,
+			input
+		});
+		else if (isValibotSchema(input)) return murmurhash({
+			variant,
+			input: convertValibotSchemaToJsonSchema(input)
+		});
+		else if (isUntypedInput(input)) return murmurhash({
+			variant,
+			input: convertUntypedInputToJsonSchema(input)
+		});
+		else if (isUntypedSchema(input)) return murmurhash({
+			variant,
+			input: convertUntypedSchemaToJsonSchema(input)
+		});
+	}
+	throw new Error(`Failed to create an input hash for the provided schema definition input. The input must be a Zod schema, a Standard JSON Schema, a JSON Schema object, a Valibot BaseSchema, or a reflected Deepkit Type object.`);
+}
+/**
+* Converts a reflected Deepkit {@link Type} into a JSON Schema (draft-2020-12) representation.
+*/
+function extractReflection(reflection) {
+	if (!isType(reflection)) return;
+	return reflectionToJsonSchema(reflection);
+}
+/**
+* Extracts a JSON Schema from Zod, Standard Schema, Valibot, untyped, or JSON Schema inputs.
+*
+* @param schema - The schema input to extract a JSON Schema from.
+* @returns The extracted JSON Schema, or `undefined` if the input is not a supported schema type.
+*/
+function extractJsonSchema(schema) {
+	if (isSetObject$1(schema)) {
+		if (isZod3Type(schema)) return extractJsonSchema$1(schema, { target: "draft-2020-12" });
+		if (isUntypedInputStrict(schema)) return convertUntypedInputToJsonSchema(schema);
+		if (isUntypedSchemaStrict(schema)) return convertUntypedSchemaToJsonSchema(schema);
+		if (isStandardJsonSchema(schema)) return schema["~standard"].jsonSchema.input({ target: "draft-2020-12" });
+		if (isValibotSchema(schema)) return convertValibotSchemaToJsonSchema(schema);
+		if (isJsonSchema(schema)) return schema;
+	}
+}
+/**
+* Resolves the concrete source variant for a schema source input.
+*
+* @param input - The schema source input to inspect.
+* @returns The resolved schema source variant.
+* @throws Will throw an error when the input cannot be mapped to a supported source variant.
+*/
+function extractResolvedVariant(input) {
+	if (isSetObject$1(input)) {
+		if (isZod3Type(input)) return "zod3";
+		else if (isType(input)) return "reflection";
+		else if (isUntypedInputStrict(input) || isUntypedSchemaStrict(input)) return "untyped";
+		else if (isStandardJsonSchema(input)) return "standard-schema";
+		else if (isJsonSchema(input)) return "json-schema";
+		else if (isValibotSchema(input)) return "valibot";
+	}
+	throw new Error(`Failed to determine the variant of the provided schema definition input. The input must be a Zod schema, a Standard JSON Schema, a JSON Schema object, a Valibot BaseSchema, a reflected Deepkit Type object, or an Untyped schema.`);
+}
+/**
+* Determines the top-level input variant for schema extraction.
+*
+* @param input - The schema input to classify.
+* @returns The resolved schema input variant.
+*/
+function extractVariant(input) {
+	if (isSetString(input) || isFileReference(input)) return "file-reference";
+	return extractResolvedVariant(input);
+}
+/**
+* Extracts and normalizes a JSON Schema from a concrete schema source input.
+*
+* @param input - The schema source input to extract from.
+* @param variant - Optional source variant override. When omitted, the variant is inferred from the input.
+* @returns A promise that resolves to a bundled JSON Schema.
+* @throws Will throw an error if no valid JSON Schema can be extracted from the input.
+*/
+async function extractSchema(input, variant) {
+	if (isSchemaWithSource(input)) return input.schema;
+	const resolvedVariant = variant ?? extractResolvedVariant(input);
+	let schema;
+	if (resolvedVariant === "zod3" || resolvedVariant === "json-schema" || resolvedVariant === "standard-schema" || resolvedVariant === "untyped" || resolvedVariant === "valibot") schema = extractJsonSchema(input);
+	else if (resolvedVariant === "reflection") schema = extractReflection(input);
+	if (schema) return bundleReferences(schema);
+	throw new Error(`Failed to extract a valid schema from the provided input. The input must be a Zod schema, a Standard JSON Schema, a JSON Schema object, a Valibot BaseSchema, an untyped schema, or a reflected Deepkit Type object.`);
+}
+/**
+* Builds source metadata for a schema input using a known source variant.
+*
+* @param variant - The schema source variant associated with the input.
+* @param input - The schema source input to wrap.
+* @returns The normalized schema source payload, including the source hash and variant.
+* @throws Will throw an error if the provided variant is unsupported.
+*/
+function extractSource(variant, input) {
+	if (variant === "zod3") return {
+		hash: extractHash(variant, input),
+		variant: "zod3",
+		schema: input
+	};
+	else if (variant === "untyped") return {
+		hash: extractHash(variant, input),
+		variant: "untyped",
+		schema: input
+	};
+	else if (variant === "standard-schema") return {
+		hash: extractHash(variant, input),
+		variant: "standard-schema",
+		schema: input
+	};
+	else if (variant === "json-schema") return {
+		hash: extractHash(variant, input),
+		variant: "json-schema",
+		schema: input
+	};
+	else if (variant === "valibot") return {
+		hash: extractHash(variant, input),
+		variant: "valibot",
+		schema: input
+	};
+	else if (variant === "reflection") return {
+		hash: extractHash(variant, input),
+		variant: "reflection",
+		schema: input
+	};
+	throw new Error(`Failed to extract source information from the provided input. The input must be a Zod schema, a Standard JSON Schema, a JSON Schema object, an untyped schema, or a reflected Deepkit Type object.`);
+}
+/**
+* Extracts a JSON Schema from a given schema definition input, which can be a Zod schema, a Valibot schema, any Standard JSON Schema type, a plain JSON Schema object, an untyped schema, or a Deepkit Type object. If the input is a type definition reference (e.g. a file path with an export), it will be resolved and bundled using Rolldown to obtain the actual schema definition before extraction.
+*
+* @example
+* ```ts
+* // Resolve a schema definition from a file path
+* const schema1 = await extract(context, "./schemas.ts#MySchema");
+* // Resolve a schema definition from a JSON Schema object
+* const schema2 = await extract(context, schemaObject);
+* // Resolve a schema definition from a Zod schema
+* const schema3 = await extract(context, zodSchema);
+* // Resolve a schema definition from a reflected Deepkit Type object
+* const schema4 = await extract(context, reflectionType);
+* ```
+*
+* @see https://zod.dev/
+* @see https://valibot.dev/
+* @see https://standardschema.dev/json-schema#what-schema-libraries-support-this-spec
+* @see https://json-schema.org/
+* @see https://ajv.js.org/json-type-definition.html
+* @see https://deepkit.io/en/documentation/runtime-types/reflection
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The schema definition input to extract, which can be a Zod schema, a Valibot schema, any Standard JSON Schema type, a plain JSON Schema object, an untyped schema, or a reflected Deepkit Type object. If the input is a string or a type definition reference, it will be resolved and bundled to obtain the actual schema definition before extraction.
+* @param options - Optional overrides for the Rolldown configuration used during extraction. This can include custom plugins, loaders, or other build options to control how the schema definition is resolved and bundled when the input is a type definition reference.
+* @returns A promise that resolves to the extracted and normalized schema as a JSON Schema object. The function will attempt to extract a valid JSON Schema from the provided input, and if successful, it will return the schema. If the extraction process fails or if the input is not a valid schema definition, it will throw an error indicating the failure.
+*/
+async function extractSchemaWithSource(context, input, options = {}) {
+	if (isSchemaWithSource(input)) return input;
+	if (isSchema(input)) return {
+		...input,
+		source: {
+			hash: extractHash("json-schema", input.schema),
+			variant: "json-schema",
+			schema: input.schema
+		}
+	};
+	let source;
+	const variant = extractVariant(input);
+	const hash = extractHash(variant, input);
+	if (variant === "file-reference") {
+		const fileReference = extractFileReference(input);
+		if (!fileReference) throw new Error(`Failed to extract a valid file reference from the provided input "${JSON.stringify(input)}". Please ensure that the input is correctly formatted as a file reference (e.g. "./schema.ts#MySchema") and that the file exists at the specified path.`);
+		const extension = findFileExtensionSafe(fileReference.file);
+		if (extension && !VALID_SOURCE_FILE_EXTENSIONS.includes(extension)) throw new Error(`The provided schema file input "${fileReference.file}" has an invalid file extension (.${extension}). Please ensure that the file has one of the following extensions: ${list(VALID_SOURCE_FILE_EXTENSIONS, { conjunction: "or" })}.`);
+		let resolved = await resolve(context, input, defu(options, { plugins: [esbuildPlugin(context, {
+			reflection: "default",
+			level: "all"
+		})] }));
+		try {
+			const type = deserializeType(resolved);
+			if (isType(type)) resolved = type;
+		} catch {}
+		source = extractSource(extractResolvedVariant(resolved), resolved);
+	} else if ([
+		"json-schema",
+		"standard-schema",
+		"zod3",
+		"untyped",
+		"valibot",
+		"reflection"
+	].includes(variant)) source = extractSource(variant, input);
+	else throw new Error(`Invalid schema definition input "${variant}". The variant must be one of "file-reference", "json-schema", "standard-schema", "zod3", "valibot", "untyped", or "reflection".`);
+	return {
+		variant,
+		source,
+		schema: await extractSchema(source.schema, source.variant),
+		hash
+	};
+}
+/**
+* Extracts a JSON Schema from a given schema definition input, which can be a Zod schema, a Valibot schema, any Standard JSON Schema type, a plain JSON Schema object, an untyped schema, or a Deepkit Type object. If the input is a type definition reference (e.g. a file path with an export), it will be resolved and bundled using Rolldown to obtain the actual schema definition before extraction.
+*
+* @example
+* ```ts
+* // Resolve a schema definition from a file path
+* const schema1 = await extract(context, "./schemas.ts#MySchema");
+* // Resolve a schema definition from a JSON Schema object
+* const schema2 = await extract(context, schemaObject);
+* // Resolve a schema definition from a Zod schema
+* const schema3 = await extract(context, zodSchema);
+* // Resolve a schema definition from a Valibot schema
+* const schema4 = await extract(context, valibotSchema);
+* // Resolve a schema definition from a reflected Deepkit Type object
+* const schema5 = await extract(context, reflectionType);
+* ```
+*
+* @see https://zod.dev/
+* @see https://valibot.dev/
+* @see https://standardschema.dev/json-schema#what-schema-libraries-support-this-spec
+* @see https://json-schema.org/
+* @see https://ajv.js.org/json-type-definition.html
+* @see https://deepkit.io/en/documentation/runtime-types/reflection
+* @see https://github.com/unjs/untyped
+* @see https://www.typescriptlang.org/docs/handbook/2/types-from-types.html
+*
+* @param context - The context object providing access to the file system and cache path.
+* @param input - The schema definition input to extract, which can be a Zod schema, a Valibot schema, any Standard JSON Schema type, a plain JSON Schema object, an untyped schema, or a reflected Deepkit Type object.
+* @param options - Optional overrides for the Rolldown configuration used during extraction.
+* @returns A promise that resolves to the extracted and normalized schema as a JSON Schema object.
+* @throws Will throw an error if the input is not a valid schema definition or if the extraction process fails to produce a valid schema.
+*/
+async function extract(context, input, options = {}) {
+	if (isSchemaWithSource(input) || isSchema(input)) return input;
+	let result;
+	const variant = extractVariant(input);
+	const hash = extractHash(variant, input);
+	const cacheFilePath = joinPaths(getCacheDirectory(context), `${hash}.json`);
+	if (context.config.skipCache !== true && context.fs.existsSync(cacheFilePath)) {
+		const schema = await context.fs.read(cacheFilePath);
+		if (schema) result = {
+			variant,
+			hash,
+			schema: JSON.parse(schema)
+		};
+	}
+	result ??= await extractSchemaWithSource(context, input, options);
+	if (!result?.schema) throw new Error(`Failed to extract a valid schema from the provided input. The input must be a Zod schema, a Valibot schema, any Standard JSON Schema type, a plain JSON Schema object, an untyped schema, or a reflected Deepkit Type object.`);
+	if (context.config.skipCache !== true) await writeSchema(context, result);
+	return result;
+}
+
+//#endregion
+export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames, VALID_SOURCE_FILE_EXTENSIONS, addProperty, applyJsonSchemaMetadata, bundle, bundleReferences, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaWithSource, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getJsonSchema, getJsonSchemaObject, getJsonSchemaType, getPrimarySchemaType, getProperties, getPropertiesList, isJsonSchema, isJsonSchemaAllOf, isJsonSchemaAny, isJsonSchemaAnyOf, isJsonSchemaArray, isJsonSchemaBigint, isJsonSchemaBoolean, isJsonSchemaDate, isJsonSchemaDecimal, isJsonSchemaEnum, isJsonSchemaInteger, isJsonSchemaKeywords, isJsonSchemaLiteral, isJsonSchemaMap, isJsonSchemaNativeEnum, isJsonSchemaNever, isJsonSchemaNull, isJsonSchemaNullable, isJsonSchemaNumber, isJsonSchemaObject, isJsonSchemaPrimitiveType, isJsonSchemaPrimitiveUnion, isJsonSchemaRecord, isJsonSchemaRef, isJsonSchemaSet, isJsonSchemaString, isJsonSchemaTuple, isJsonSchemaType, isJsonSchemaUndefined, isJsonSchemaUnion, isJsonSchemaUnknown, isNullOnlyJsonSchema, isPropertyOptional, isSchema, isSchemaNullable, isSchemaObject, isSchemaWithSource, isStandardSchema, isUntypedInput, isUntypedInputStrict, isUntypedSchema, isUntypedSchemaStrict, isValibotSchema, isValidSchemaInputFile, merge, readSchema, readSchemaSafe, readSchemaTypes, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };
+//# sourceMappingURL=index.mjs.map