@power-plant/schema 0.0.3 → 0.0.5

package/dist/index.mjs

@@ -1 +1,2 @@
-import"./types.mjs";import{JSON_SCHEMA_METADATA_KEYS as e,JSON_SCHEMA_PRIMITIVE_TYPES as t,JSON_SCHEMA_TYPES as n,JsonSchemaTypeNames as r,SCHEMA_ARRAY_CONCAT_KEYWORDS as i,SCHEMA_RECORD_KEYWORDS as a,SCHEMA_SINGLE_KEYWORDS as o}from"./constants.mjs";import{isFileReference as s,isJsonSchema as c,isJsonSchemaAllOf as l,isJsonSchemaAny as u,isJsonSchemaAnyOf as d,isJsonSchemaArray as f,isJsonSchemaBigint as p,isJsonSchemaBoolean as m,isJsonSchemaDate as h,isJsonSchemaDecimal as g,isJsonSchemaEnum as _,isJsonSchemaInteger as v,isJsonSchemaKeywords as y,isJsonSchemaLiteral as b,isJsonSchemaMap as x,isJsonSchemaNativeEnum as S,isJsonSchemaNever as C,isJsonSchemaNull as w,isJsonSchemaNullable as T,isJsonSchemaNumber as E,isJsonSchemaObject as D,isJsonSchemaPrimitiveType as O,isJsonSchemaPrimitiveUnion as k,isJsonSchemaRecord as A,isJsonSchemaRef as j,isJsonSchemaSet as M,isJsonSchemaString as N,isJsonSchemaTuple as P,isJsonSchemaType as F,isJsonSchemaUndefined as I,isJsonSchemaUnion as L,isJsonSchemaUnknown as R,isNullOnlyJsonSchema as z,isSchema as B,isSchemaObject as V,isSchemaOf as H,isSchemaWithSource as U,isStandardSchema as W,isUntypedInput as G,isUntypedInputStrict as K,isUntypedSchema as q,isUntypedSchemaStrict as J,isValibotSchema as Y}from"./type-checks.mjs";import{C as X,E as Z,S as Q,T as $,_ as ee,a as te,b as ne,c as re,d as ie,f as ae,g as oe,h as se,i as ce,l as le,m as ue,n as de,o as fe,p as pe,r as me,s as he,t as ge,u as _e,v as ve,w as ye,x as be,y as xe}from"./metadata-DIEpQjbq.mjs";import{bundleReferences as Se,extract as Ce,extractHash as we,extractJsonSchema as Te,extractResolvedVariant as Ee,extractSchema as De,extractSchemaMeta as Oe,extractSchemaWithSource as ke,extractSource as Ae,extractTSType as je,extractVariant as Me}from"./extract.mjs";export{e as JSON_SCHEMA_METADATA_KEYS,t as JSON_SCHEMA_PRIMITIVE_TYPES,n as JSON_SCHEMA_TYPES,r as JsonSchemaTypeNames,i as SCHEMA_ARRAY_CONCAT_KEYWORDS,a as SCHEMA_RECORD_KEYWORDS,o as SCHEMA_SINGLE_KEYWORDS,oe as addProperty,ge as applyJsonSchemaMetadata,Se as bundleReferences,Ce as extract,we as extractHash,Te as extractJsonSchema,Ee as extractResolvedVariant,De as extractSchema,Oe as extractSchemaMeta,ke as extractSchemaWithSource,Ae as extractSource,je as extractTSType,Me as extractVariant,de as formatMetaVersion,ae as generateParserCode,ee as getJsonSchema,ve as getJsonSchemaObject,pe as getJsonSchemaType,me as getPrimarySchemaType,xe as getProperties,ne as getPropertiesList,be as getProperty,s as isFileReference,c as isJsonSchema,l as isJsonSchemaAllOf,u as isJsonSchemaAny,d as isJsonSchemaAnyOf,f as isJsonSchemaArray,p as isJsonSchemaBigint,m as isJsonSchemaBoolean,h as isJsonSchemaDate,g as isJsonSchemaDecimal,_ as isJsonSchemaEnum,v as isJsonSchemaInteger,y as isJsonSchemaKeywords,b as isJsonSchemaLiteral,x as isJsonSchemaMap,S as isJsonSchemaNativeEnum,C as isJsonSchemaNever,w as isJsonSchemaNull,T as isJsonSchemaNullable,E as isJsonSchemaNumber,D as isJsonSchemaObject,O as isJsonSchemaPrimitiveType,k as isJsonSchemaPrimitiveUnion,A as isJsonSchemaRecord,j as isJsonSchemaRef,M as isJsonSchemaSet,N as isJsonSchemaString,P as isJsonSchemaTuple,F as isJsonSchemaType,I as isJsonSchemaUndefined,L as isJsonSchemaUnion,R as isJsonSchemaUnknown,z as isNullOnlyJsonSchema,Q as isPropertyOptional,B as isSchema,X as isSchemaNullable,V as isSchemaObject,H as isSchemaOf,U as isSchemaWithSource,W as isStandardSchema,G as isUntypedInput,K as isUntypedInputStrict,q as isUntypedSchema,J as isUntypedSchemaStrict,Y as isValibotSchema,ye as isValidSchemaInputFile,$ as merge,Z as mergeMetadata,ce as readSchemaTypes,te as resolveMetaDescription,fe as resolveMetaDisplayName,he as resolveMetaExample,re as resolveMetaId,le as resolveMetaLinks,_e as resolveMetaName,ie as resolveMetaVersion,ue as stringifyType,se as stringifyValue};
+import{a as e,i as t,n,o as r,r as i,s as a,t as o}from"./constants-lk1mMbgx.mjs";import{$ as s,A as c,B as ee,C as te,D as ne,E as re,F as l,G as u,H as ie,I as ae,J as d,K as f,L as oe,M as se,N as ce,O as le,P as ue,Q as de,R as fe,S as pe,T as me,U as he,V as ge,W as _e,X as p,Y as ve,Z as m,_ as ye,a as be,b as h,c as xe,d as Se,et as g,f as Ce,g as _,h as v,i as we,j as Te,k as Ee,l as De,m as Oe,n as y,nt as b,o as x,p as S,q as C,r as w,rt as T,s as ke,t as Ae,tt as E,u as je,v as Me,w as Ne,x as Pe,y as Fe,z as Ie}from"./helpers-Bh_V7xwV.mjs";import{extractFileReference as D}from"@stryke/convert/extract-file-reference";import{murmurhash as O}from"@stryke/hash";import{deepClone as Le}from"@stryke/helpers/deep-clone";import{isStandardJsonSchema as k}from"@stryke/json";import{findFileExtensionSafe as Re}from"@stryke/path/find";import{VALID_OBJECT_SOURCE_EXTENSIONS as A}from"@stryke/resolve/constants";import{loadSafe as ze}from"@stryke/resolve/load";import{list as Be}from"@stryke/string-format/list";import{isSetString as j}from"@stryke/type-checks";import{isSetObject as M}from"@stryke/type-checks/is-set-object";import{extractJsonSchema as Ve,isZod3Type as N}from"@stryke/zod";import{toJsonSchema as He}from"@valibot/to-json-schema";import{createGenerator as Ue}from"ts-json-schema-generator/dist/factory/generator.js";const P=`https://power-plant.invalid/`;function We(e){return!(!M(e)||!(`schema`in e)||`hash`in e||`variant`in e||`source`in e)}function F(e){return We(e)?e.schema:e}function I(e){return e.endsWith(`#`)?e.slice(0,-1):e}function L(e){let t=e.indexOf(`#`);return t>=0?e.slice(0,t):e}function Ge(e){return e.replaceAll(`~`,`~0`).replaceAll(`/`,`~1`)}function Ke(e){return e.length===0?``:`/${e.map(e=>Ge(e)).join(`/`)}`}function R(e,t){try{return I(new URL(e,t).toString())}catch{return I(e)}}function z(e,t,n,r,i){if(!M(e))return;let a=e,o=Ke(t),s=j(a.$id)?R(a.$id,n):n,c=L(s);if(r.set(s,o),r.set(c,o),j(a.$anchor)&&r.set(`${c}#${a.$anchor}`,o),j(a.$dynamicAnchor)){let e=`${c}#${a.$dynamicAnchor}`;r.set(e,o),i.set(e,`#${a.$dynamicAnchor}`)}for(let[e,n]of Object.entries(a)){if(Array.isArray(n)){n.forEach((n,a)=>{z(n,[...t,e,String(a)],s,r,i)});continue}z(n,[...t,e],s,r,i)}}function B(e,t,n,r,i){if(!M(e))return;let a=e,o=j(a.$id)?R(a.$id,n):n;if(j(a.$ref)){let e=R(a.$ref,o),t=r.get(e)??r.get(L(e));t!==void 0&&(a.$ref=t.length>0?`#${t}`:`#`)}if(j(a.$dynamicRef)){let e=R(a.$dynamicRef,o),t=i.get(e);if(t)a.$dynamicRef=t;else{let t=r.get(e)??r.get(L(e));t!==void 0&&(a.$dynamicRef=t.length>0?`#${t}`:`#`)}}for(let[e,n]of Object.entries(a)){if(Array.isArray(n)){n.forEach((n,a)=>{B(n,[...t,e,String(a)],o,r,i)});continue}B(n,[...t,e],o,r,i)}}function V(e){if(!M(e))return e;let t=Le(e),n=j(t.$id)?R(t.$id,P):P,r=new Map,i=new Map;return z(t,[],n,r,i),B(t,[],n,r,i),t}function H(e){if(E(e))return W(e);if(M(e)){if(s(e))return G(e);let t=e;if(`$schema`in t&&E(t.$schema))return W(t.$schema)}return e}function qe(e){return Array.isArray(e)?e.map(e=>H(e)):e}function U(e){return He(e,{target:`draft-2020-12`})}function W(e){let t=e,n={};for(let[e,r]of Object.entries(t))if(!(e===`tsType`||e===`markdownType`||e===`tags`||e===`args`||e===`resolve`)){if(e===`id`&&j(r)){n.$id=r;continue}if(e===`properties`||e===`patternProperties`||e===`dependentSchemas`||e===`$defs`||e===`definitions`){if(!M(r)){n[e]=r;continue}n[e]=Object.fromEntries(Object.entries(r).map(([e,t])=>[e,H(t)]));continue}if(e===`items`||e===`contains`||e===`if`||e===`then`||e===`else`||e===`not`||e===`propertyNames`||e===`additionalProperties`||e===`unevaluatedProperties`){n[e]=H(r);continue}if(e===`oneOf`||e===`anyOf`||e===`allOf`){n[e]=qe(r);continue}n[e]=r}return n}function G(e){let t=e,n=E(t.$schema)?W(t.$schema):{},r={};for(let[e,n]of Object.entries(t)){if(e.startsWith(`$`)||!M(n))continue;if(s(n)){r[e]=G(n);continue}let t=n;if(`$schema`in t&&E(t.$schema)){r[e]=W(t.$schema);continue}E(n)&&(r[e]=W(n))}if(!l(n))throw Error(`Failed to convert untyped input to JSON Schema. The base schema must be a valid JSON Schema object.`);let i={...M(n.properties)?n.properties:{},...r};return{...n,type:n.type??`object`,...Object.keys(i).length>0?{properties:i}:{}}}function K(e,t){let n=F(t);if(m(n)||d(n))return O({variant:e,input:n.schema});if(j(n)||typeof n==`boolean`)return O({variant:e,input:n});if(M(n)){if(N(n))return O({variant:e,input:n._def});if(k(n))return O({variant:e,input:n[`~standard`]});if(_(n))return O({variant:e,input:n});if(T(n))return O({variant:e,input:U(n)});if(s(n))return O({variant:e,input:G(n)});if(E(n))return O({variant:e,input:W(n)})}throw 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.`)}function q(e){if(M(e)){if(N(e))return Ve(e,{target:`draft-2020-12`});if(g(e))return G(e);if(b(e))return W(e);if(k(e))return e[`~standard`].jsonSchema.input({target:`draft-2020-12`});if(T(e))return U(e);if(_(e))return e}}function J(e){if(M(e)){if(N(e))return`zod3`;if(g(e)||b(e))return`untyped`;if(k(e))return`standard-schema`;if(_(e))return`json-schema`;if(T(e))return`valibot`}throw 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.`)}function Y(e){let t=F(e);return m(t)||d(t)?t.variant:j(t)||v(t)?`file-reference`:J(t)}async function X(e,t){if(m(e))return e.schema;let n=t??J(e),r;if((n===`zod3`||n===`json-schema`||n===`standard-schema`||n===`untyped`||n===`valibot`)&&(r=q(e)),r)return V(r);throw 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.`)}function Z(e,t){if(e===`zod3`)return{hash:K(e,t),variant:`zod3`,schema:t};if(e===`untyped`)return{hash:K(e,t),variant:`untyped`,schema:t};if(e===`standard-schema`)return{hash:K(e,t),variant:`standard-schema`,schema:t};if(e===`json-schema`)return{hash:K(e,t),variant:`json-schema`,schema:t};if(e===`valibot`)return{hash:K(e,t),variant:`valibot`,schema:t};throw 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.`)}async function Q(e,t={}){let n=D(e);if(!n)throw 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.`);let r=n.export??`*`;try{return Ue({path:n.file,type:r,expose:`export`,jsDoc:`extended`,...t}).createSchema(r)}catch(e){throw Error(`Failed to generate a JSON schema for "${n.file}" using the type "${r}". Error: ${e.message}`)}}async function $(e,t={}){let n=F(e);if(m(n))return n;if(d(n))return{...n,source:{hash:K(`json-schema`,n.schema),variant:`json-schema`,schema:n.schema}};let r,i=Y(n),a=K(i,n);if(i===`file-reference`){let e=D(n);if(!e)throw Error(`Failed to extract a valid file reference from the provided input "${JSON.stringify(n)}". 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.`);let i=Re(e.file);if(i&&!A.includes(i))throw Error(`The provided schema file input "${e.file}" has an invalid file extension (.${i}). Please ensure that the file has one of the following extensions: ${Be(A,{conjunction:`or`})}.`);let a=await ze(n,t);a??=await Q(n,t);let o=F(a);r=m(o)?o.source:d(o)?{hash:K(`json-schema`,o.schema),variant:`json-schema`,schema:o.schema}:Z(J(o),o)}else if([`json-schema`,`standard-schema`,`zod3`,`untyped`,`valibot`,`reflection`].includes(i))r=Z(i,n);else throw Error(`Invalid schema definition input "${i}". The variant must be one of "file-reference", "json-schema", "standard-schema", "zod3", "valibot", "untyped", or "reflection".`);return{variant:i,source:r,schema:await X(r.schema,r.variant),hash:a}}async function Je(e,t={}){let n=F(e);if(m(n)||p(n))return n;let r=await $(e,t);if(!r?.schema)throw 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.`);return r}export{o as JSON_SCHEMA_METADATA_KEYS,n as JSON_SCHEMA_PRIMITIVE_TYPES,i as JSON_SCHEMA_TYPES,t as JsonSchemaTypeNames,e as SCHEMA_ARRAY_CONCAT_KEYWORDS,r as SCHEMA_RECORD_KEYWORDS,a as SCHEMA_SINGLE_KEYWORDS,Ae as addProperty,Ce as applyJsonSchemaMetadata,V as bundleReferences,Je as extract,K as extractHash,q as extractJsonSchema,J as extractResolvedVariant,X as extractSchema,$ as extractSchemaWithSource,Z as extractSource,Q as extractTSType,Y as extractVariant,y as getJsonSchema,w as getJsonSchemaObject,S as getPrimarySchemaType,we as getProperties,be as getPropertiesList,x as getProperty,v as isFileReference,_ as isJsonSchema,ye as isJsonSchemaAllOf,Me as isJsonSchemaAny,Fe as isJsonSchemaAnyOf,h as isJsonSchemaArray,Pe as isJsonSchemaBigint,pe as isJsonSchemaBoolean,te as isJsonSchemaDate,Ne as isJsonSchemaDecimal,me as isJsonSchemaEnum,re as isJsonSchemaInteger,ne as isJsonSchemaKeywords,le as isJsonSchemaLiteral,Ee as isJsonSchemaMap,c as isJsonSchemaNativeEnum,Te as isJsonSchemaNever,se as isJsonSchemaNull,ce as isJsonSchemaNullable,ue as isJsonSchemaNumber,l as isJsonSchemaObject,ae as isJsonSchemaPrimitiveType,oe as isJsonSchemaPrimitiveUnion,fe as isJsonSchemaRecord,Ie as isJsonSchemaRef,ee as isJsonSchemaSet,ge as isJsonSchemaString,ie as isJsonSchemaTuple,he as isJsonSchemaType,_e as isJsonSchemaUndefined,u as isJsonSchemaUnion,f as isJsonSchemaUnknown,C as isNullOnlyJsonSchema,ke as isPropertyOptional,d as isSchema,xe as isSchemaNullable,ve as isSchemaObject,p as isSchemaOf,m as isSchemaWithSource,de as isStandardSchema,s as isUntypedConfig,g as isUntypedConfigStrict,E as isUntypedSchema,b as isUntypedSchemaStrict,T as isValibotSchema,De as isValidSchemaConfigFile,je as merge,Se as mergeMetadata,Oe as readSchemaTypes};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":[],"mappings":""}

package/dist/{types.d.cts → types-BawP3FVI.d.mts}

@@ -1,11 +1,38 @@
-import { n as JSON_SCHEMA_PRIMITIVE_TYPES, r as JSON_SCHEMA_TYPES } from "./constants-u7ovYS9e.cjs";
-import { StandardJSONSchemaV1 } from "@standard-schema/spec";
-import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
-import { MaybePromise } from "@stryke/types/base";
-import { InputObject, Schema as Schema$1 } from "untyped";
 import { BaseIssue, BaseSchema } from "valibot";
+import { StandardJSONSchemaV1 } from "@standard-schema/spec";
+import { InferLoadOptions, LoadReference } from "@stryke/resolve/types";
+import { InputObject, Schema } from "untyped";
 import * as z3 from "zod/v3";
 
+//#region src/constants.d.ts
+declare const JsonSchemaTypeNames: {
+  readonly STRING: "string";
+  readonly NUMBER: "number";
+  readonly INTEGER: "integer";
+  readonly BOOLEAN: "boolean";
+  readonly NULL: "null";
+  readonly OBJECT: "object";
+  readonly ARRAY: "array";
+};
+declare const JSON_SCHEMA_PRIMITIVE_TYPES: readonly ["string", "number", "integer", "boolean", "null"];
+declare const JSON_SCHEMA_TYPES: readonly ["string", "number", "integer", "boolean", "null", "array", "object"];
+declare const JSON_SCHEMA_METADATA_KEYS: ("$id" | "$schema" | "$vocabulary" | "$comment" | "$anchor" | "$defs" | "$dynamicRef" | "$dynamicAnchor" | "name" | "version" | "title" | "description" | "docs" | "examples" | "alias" | "tags" | "deprecated" | "hidden" | "ignore" | "internal" | "runtime" | "readOnly" | "writeOnly")[];
+/**
+ * Keywords whose values are a flat record of named JSON Schema fragments.
+ * Each child schema is merged recursively with its counterpart.
+ */
+declare const SCHEMA_RECORD_KEYWORDS: Set<string>;
+/**
+ * Keywords whose value is a single JSON Schema fragment that should be
+ * recursively merged when both sides define it.
+ */
+declare const SCHEMA_SINGLE_KEYWORDS: Set<string>;
+/**
+ * Keywords whose values are arrays of JSON Schema fragments that should be
+ * concatenated (rather than overridden) during a merge.
+ */
+declare const SCHEMA_ARRAY_CONCAT_KEYWORDS: Set<string>;
+//#endregion
 //#region src/types.d.ts
 /**
  * Primitive JSON Schema `type` keyword values.
@@ -110,7 +137,7 @@ interface JsonSchemaMetadataKeywords {
   /**
    * A title for the schema, which can be used by documentation tools or other libraries that support this feature to provide a human-readable name or description for the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the schema when used in conjunction with compatible tools.
    */
-  displayName?: string;
+  title?: string;
   /**
    * A description for the schema, which can be used by documentation tools or other libraries that support this feature to provide a human-readable explanation or summary of the schema's purpose and usage. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the schema when used in conjunction with compatible tools.
    */
@@ -1128,19 +1155,19 @@ type SchemaSourceVariant = "standard-schema" | "json-schema" | "zod3" | "untyped
 /**
  * Accepted schema input variants, including raw type definitions.
  */
-type SchemaInputVariant = SchemaSourceVariant | "file-reference";
+type SchemaConfigVariant = SchemaSourceVariant | "file-reference";
 /**
  * Alias for the Untyped object-input schema shape.
  */
-type UntypedInputObject = InputObject;
+type UntypedConfigObject = InputObject;
 /**
  * Alias for the Untyped schema document shape.
  */
-type UntypedSchema = Schema$1;
+type UntypedSchema = Schema;
 /**
  * A Valibot schema instance.
  *
- * @template TInput - The raw input type accepted by the schema.
+ * @template TConfig - The raw input type accepted by the schema.
  * @template TOutput - The parsed output type produced by the schema.
  * @template TIssue - The issue type emitted for validation errors.
  */
@@ -1148,12 +1175,12 @@ type ValibotSchema<TInput = unknown, TOutput = unknown, TIssue extends BaseIssue
 /**
  * Raw schema source input union before normalization.
  */
-type SchemaSourceInput<TSpec = any> = StandardJSONSchemaV1<TSpec> | JsonSchemaOf<TSpec> | z3.ZodType<TSpec, any, any> | UntypedInputObject | UntypedSchema | ValibotSchema<TSpec>;
+type SchemaSourceConfig<TSpec = any> = StandardJSONSchemaV1<TSpec> | JsonSchemaOf<TSpec> | z3.ZodType<TSpec, any, any> | UntypedConfigObject | UntypedSchema | ValibotSchema<TSpec>;
 /**
  * Any accepted schema input, including normalized schemas and references.
  *
  * @remarks
- * The `SchemaInput` type can be one of the following variants:
+ * The `SchemaConfig` type can be one of the following variants:
  * - A file path string (for example: `"./src/types.ts"`).
  * - A URL string (for example: `"https://example.com/config.json"`).
  * - A {@link GitHubReference | GitHub repository reference string}, starting with either `"github:"` or `"gh:"`, an optional branch or tag, and optionally including a specific file path within the repository (for example: `"github:main:storm-software/stryke/packages/resolve/src/types.ts"`). It is also valid to provide the branch or tag after the file path (for example: `"github:storm-software/stryke/packages/resolve/src/types.ts@main"`).
@@ -1162,168 +1189,20 @@ type SchemaSourceInput<TSpec = any> = StandardJSONSchemaV1<TSpec> | JsonSchemaOf
  * - A file reference string (this value can include both a path to the TypeScript module and the name of the module export separated by a ":", "#", or ";" character - for example: `"./src/types.ts#ExampleExport"`).
  * - A {@link FileReference} object, which contains information about a file reference.
  * - A {@link URL} object, which represents a URL to fetch the file from.
- * - A {@link SchemaSourceInput} object, which represents a raw schema input in one of the supported formats (Standard Schema, JSON Schema, Zod v3, Untyped, or Valibot).
+ * - A {@link SchemaSourceConfig} object, which represents a raw schema input in one of the supported formats (Standard Schema, JSON Schema, Zod v3, Untyped, or Valibot).
  *
  * @template TSpec - The original TypeScript type for which the schema is being extracted. This type parameter is used to derive the appropriate JSON Schema representation based on the structure and constraints of `T`.
  *
- * @see {@link SchemaSourceInput}
- * @see {@link Schema}
- * @see {@link SchemaInputWithMeta}
+ * @see {@link SchemaSourceConfig}
+ * @see {@link SchemaEnvelope}
+ * @see {@link SchemaConfigWithMeta}
  */
-type SchemaInput<TSpec = any> = LoadInput | SchemaSourceInput<TSpec> | Schema<JsonSchemaOf<TSpec>> | SchemaInputWithMeta<TSpec>;
-type InferExtractOptions<T extends SchemaInput> = T extends LoadInput ? InferLoadOptions<T> : {};
-type MetaValue<TSpec, TValue = any> = TValue | ((spec: TSpec) => MaybePromise<TValue>);
-type MetaDeprecated = true | string | {
-  message?: string;
-  since?: string;
-  alternative?: string;
-};
-type MetaLink = string | {
-  href: string;
-  description?: string;
-};
-interface MetaInput<TSpec> {
-  /**
-   * A name for the schema, which can be used to identify or reference the schema in documentation, tooling, or other contexts. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `name` property is a string that can be used to give the schema a human-readable identifier. It can be used in documentation, error messages, or other contexts where it is helpful to have a name associated with the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  name?: MetaValue<TSpec, string>;
-  /**
-   * A version string that indicates the version of the schema. This property can be used to track changes or updates to the schema over time, allowing consumers of the schema to determine which version they are working with. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `version` property is a string that can follow any versioning scheme, such as semantic versioning (e.g., "1.0.0", "2.1.3"), date-based versioning (e.g., "2023-06-15"), or any other format that conveys the version of the schema. It is recommended to use a consistent versioning scheme across all schemas to facilitate easier tracking and management of schema versions.
-   *
-   * @defaultValue "1.0"
-   */
-  version?: MetaValue<TSpec, string | Date | number>;
-  /**
-   * A string that describes the schema in some way.
-   */
-  description?: MetaValue<TSpec, string>;
-  /**
-   * A string that provides a human-readable name for the schema, which can be used in documentation, tooling, or other contexts to identify or reference the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `displayName` property is a string that can be used to give the schema a more user-friendly or descriptive name. It can be used in documentation, error messages, or other contexts where it is helpful to have a display name associated with the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  displayName?: MetaValue<TSpec, string>;
-  /**
-   * A string that describes when the schema is used.
-   */
-  usage?: MetaValue<TSpec, string>;
-  /**
-   * Indicates whether the schema is deprecated, and optionally provides additional information about the deprecation, such as a message, the version since which it is deprecated, and an alternative schema to use instead.
-   *
-   * @remarks
-   * The `deprecated` property can be a boolean value, where `true` indicates that the schema is deprecated and `false` indicates that it is not. It can also be a string that provides a message explaining the deprecation, or an object that includes additional details such as a message, the version since which it is deprecated, and an alternative schema to use instead. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  deprecated?: MetaValue<TSpec, MetaDeprecated>;
-  /**
-   * An array of tags associated with the schema. Tags can be used to categorize or label schemas for organizational purposes, making it easier to search, filter, or group related schemas together. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * Each tag in the array should be a string that represents a meaningful label or category for the schema. It is recommended to use consistent and descriptive tags across schemas to facilitate easier management and discovery of related schemas.
-   */
-  tags?: MetaValue<TSpec, string[]>;
-  /**
-   * An array of links associated with the schema. Each link can be a string representing a URL or an object containing a `href` property and an optional `description` property.
-   */
-  links?: MetaValue<TSpec, MetaLink[]>;
-}
-interface Meta<TSpec> {
-  /**
-   * A unique identifier for the schema, which can be used to reference or identify the schema in documentation, tooling, or other contexts. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `id` property is a string that can be used to give the schema a unique identifier. It can be used in documentation, error messages, or other contexts where it is helpful to have an identifier associated with the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  id: MetaValue<TSpec, string>;
-  /**
-   * A name for the schema, which can be used to identify or reference the schema in documentation, tooling, or other contexts. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `name` property is a string that can be used to give the schema a human-readable identifier. It can be used in documentation, error messages, or other contexts where it is helpful to have a name associated with the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  name: MetaValue<TSpec, string>;
-  /**
-   * A version string that indicates the version of the schema. This property can be used to track changes or updates to the schema over time, allowing consumers of the schema to determine which version they are working with. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `version` property is a string that can follow any versioning scheme, such as semantic versioning (e.g., "1.0.0", "2.1.3"), date-based versioning (e.g., "2023-06-15"), or any other format that conveys the version of the schema. It is recommended to use a consistent versioning scheme across all schemas to facilitate easier tracking and management of schema versions.
-   *
-   * @defaultValue "1.0"
-   */
-  version: MetaValue<TSpec, string | Date | number>;
-  /**
-   * A string that describes the schema in some way.
-   */
-  description: MetaValue<TSpec, string>;
-  /**
-   * A string that provides a human-readable name for the schema, which can be used in documentation, tooling, or other contexts to identify or reference the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * The `displayName` property is a string that can be used to give the schema a more user-friendly or descriptive name. It can be used in documentation, error messages, or other contexts where it is helpful to have a display name associated with the schema. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  displayName: MetaValue<TSpec, string>;
-  /**
-   * A string that describes when the schema is used.
-   */
-  usage?: MetaValue<TSpec, string>;
-  /**
-   * Indicates whether the schema is deprecated, and optionally provides additional information about the deprecation, such as a message, the version since which it is deprecated, and an alternative schema to use instead.
-   *
-   * @remarks
-   * The `deprecated` property can be a boolean value, where `true` indicates that the schema is deprecated and `false` indicates that it is not. It can also be a string that provides a message explaining the deprecation, or an object that includes additional details such as a message, the version since which it is deprecated, and an alternative schema to use instead. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   */
-  deprecated?: MetaValue<TSpec, MetaDeprecated>;
-  /**
-   * An array of tags associated with the schema. Tags can be used to categorize or label schemas for organizational purposes, making it easier to search, filter, or group related schemas together. The presence of this property does not affect the validation behavior of the schema itself, but it can provide additional context or information about the expected data when used in conjunction with compatible tools.
-   *
-   * @remarks
-   * Each tag in the array should be a string that represents a meaningful label or category for the schema. It is recommended to use consistent and descriptive tags across schemas to facilitate easier management and discovery of related schemas.
-   */
-  tags?: MetaValue<TSpec, string[]>;
-  /**
-   * An array of links associated with the schema. Each link can be a string representing a URL or an object containing a `href` property and an optional `description` property.
-   */
-  links: MetaValue<TSpec, MetaLink[]>;
-}
-type SchemaMetaExample<TSpec> = TSpec | {
-  description?: string;
-  value: TSpec;
-};
-interface SchemaMetaInput<TSpec> extends MetaInput<TSpec> {
-  /**
-   * Examples of valid data for the schema. This can be a single example or an array of examples.
-   */
-  examples?: SchemaMetaExample<TSpec> | MetaValue<TSpec, SchemaMetaExample<TSpec>[]>;
-}
-interface SchemaMeta<TSpec> extends Meta<TSpec> {
-  /**
-   * Examples of valid data for the schema.
-   */
-  examples: MetaValue<TSpec, SchemaMetaExample<TSpec>[]>;
-}
+type SchemaConfig<TSpec = any> = LoadReference | SchemaSourceConfig<TSpec> | SchemaEnvelope<JsonSchemaOf<TSpec>>;
+type InferExtractOptions<T extends SchemaConfig> = T extends LoadReference ? InferLoadOptions<T> : {};
 /**
- * Schema input wrapper that attaches optional contextual metadata.
+ * A schema envelope that contains the normalized schema and its source variant.
  */
-interface SchemaInputWithMeta<TSpec = any> {
-  /**
-   *  The underlying schema input payload.
-   */
-  schema: SchemaSourceInput<TSpec> | Schema<JsonSchemaOf<TSpec>> | LoadInput;
-  /**
-   * Optional contextual metadata associated with this schema input.
-   */
-  meta?: SchemaMetaInput<TSpec> | string;
-}
-/**
- * A schema extracted from a source input, normalized to JSON Schema.
- */
-interface Schema<TJsonSchema extends JsonSchema = JsonSchema> {
+interface SchemaEnvelope<TJsonSchema extends JsonSchema = JsonSchema> {
   /**
    * A stable content hash for the normalized schema.
    */
@@ -1331,24 +1210,20 @@ interface Schema<TJsonSchema extends JsonSchema = JsonSchema> {
   /**
    * The source variant used to derive the normalized {@link JsonSchema}.
    */
-  variant: SchemaInputVariant;
+  variant: SchemaConfigVariant;
   /**
    * The normalized schema definition.
    */
   schema: TJsonSchema;
-  /**
-   * Optional contextual metadata associated with the schema.
-   */
-  meta: SchemaMeta<SpecOf<TJsonSchema>>;
 }
 /**
  * A normalized JSON Schema extracted from a source input of type `T`. This type represents the result of the schema extraction process, where a raw schema input (which could be in various formats such as Zod, Untyped, Valibot, or as a type definition in TypeScript source code) is transformed into a standardized JSON Schema format. The `SchemaOf<T>` type captures the normalized JSON Schema along with metadata about the source variant and a content hash for caching or identification purposes.
  *
  * @template TSpec - The original TypeScript type for which the schema is being extracted. This type parameter is used to derive the appropriate JSON Schema representation based on the structure and constraints of `T`.
  *
- * @see {@link Schema}
+ * @see {@link SchemaEnvelope}
  */
-type SchemaOf<TSpec> = Schema<JsonSchemaOf<TSpec>>;
+type SchemaEnvelopeOf<TSpec> = SchemaEnvelope<JsonSchemaOf<TSpec>>;
 /**
  * Base metadata captured for schema source inputs.
  */
@@ -1358,7 +1233,7 @@ interface BaseSchemaSource<TSpec = any> {
   /** The specific source format used for the schema input. */
   variant: SchemaSourceVariant;
   /** The original schema input captured before normalization. */
-  schema: SchemaSourceInput<TSpec>;
+  schema: SchemaSourceConfig<TSpec>;
 }
 /**
  * Source descriptor for schemas that already use JSON Schema.
@@ -1394,7 +1269,7 @@ interface UntypedSchemaSource<TSpec = any> extends BaseSchemaSource<TSpec> {
   /** Indicates the source input comes from the Untyped schema model. */
   variant: "untyped";
   /** The original Untyped schema input. */
-  schema: UntypedInputObject | UntypedSchema;
+  schema: UntypedConfigObject | UntypedSchema;
 }
 /**
  * Source descriptor for Valibot schema inputs.
@@ -1412,12 +1287,38 @@ type SchemaSource<TSpec = any> = JsonSchemaSchemaSource<TSpec> | StandardSchemaS
 /**
  * A normalized schema plus metadata about the source that produced it.
  */
-interface ExtractedSchema<TSpec = any> extends SchemaOf<TSpec> {
+interface ExtractedSchemaEnvelope<TSpec = any> extends SchemaEnvelopeOf<TSpec> {
   /**
    * The schema source that produced this normalized schema.
    */
   source: SchemaSource<TSpec>;
 }
+declare module "zod" {
+  interface GlobalMeta {
+    id?: string;
+    title?: string;
+    description?: string;
+    docs?: string;
+    alias?: string[];
+    tags?: string[];
+    deprecated?: boolean;
+    hidden?: boolean;
+    ignore?: boolean;
+    internal?: boolean;
+    runtime?: boolean;
+    examples?: unknown | {
+      name?: string;
+      description?: string;
+      value: unknown;
+    }[];
+    readOnly?: boolean;
+    writeOnly?: boolean;
+    contentEncoding?: string;
+    contentMediaType?: string;
+    contentSchema?: string;
+    [keyword: string]: unknown;
+  }
+}
 //#endregion
-export { BaseSchemaSource, ExtractedSchema, InferExtractOptions, JsonSchema, JsonSchemaAllOf, JsonSchemaAny, JsonSchemaAnyOf, JsonSchemaArray, JsonSchemaBigint, JsonSchemaBoolean, JsonSchemaConditionalKeywords, JsonSchemaDate, JsonSchemaDecimal, JsonSchemaDecimalFormat, JsonSchemaEnum, JsonSchemaInteger, JsonSchemaIntegerFormat, JsonSchemaKeywords, JsonSchemaLike, JsonSchemaLiteral, JsonSchemaLogicKeywords, JsonSchemaMap, JsonSchemaMetadataKeywords, JsonSchemaNativeEnum, JsonSchemaNever, JsonSchemaNull, JsonSchemaNullable, JsonSchemaNumber, JsonSchemaNumberFormat, JsonSchemaObject, JsonSchemaOf, JsonSchemaPrimitiveType, JsonSchemaPrimitiveUnion, JsonSchemaRecord, JsonSchemaRecordPropertyNames, JsonSchemaRef, JsonSchemaSchemaSource, JsonSchemaSet, JsonSchemaString, JsonSchemaStringFormat, JsonSchemaTuple, JsonSchemaType, JsonSchemaUndefined, JsonSchemaUnion, JsonSchemaUnknown, Meta, MetaDeprecated, MetaInput, MetaLink, MetaValue, Schema, SchemaInput, SchemaInputVariant, SchemaInputWithMeta, SchemaMeta, SchemaMetaExample, SchemaMetaInput, SchemaOf, SchemaSource, SchemaSourceInput, SchemaSourceVariant, SpecOf, StandardSchemaSchemaSource, UntypedInputObject, UntypedSchema, UntypedSchemaSource, ValibotSchema, ValibotSchemaSource, Zod3SchemaSource };
-//# sourceMappingURL=types.d.cts.map
+export { SpecOf as $, JsonSchemaObject as A, JsonSchemaStringFormat as B, JsonSchemaMetadataKeywords as C, JsonSchemaNullable as D, JsonSchemaNull as E, JsonSchemaRecordPropertyNames as F, JsonSchemaUnknown as G, JsonSchemaType as H, JsonSchemaRef as I, SchemaEnvelope as J, SchemaConfig as K, JsonSchemaSchemaSource as L, JsonSchemaPrimitiveType as M, JsonSchemaPrimitiveUnion as N, JsonSchemaNumber as O, JsonSchemaRecord as P, SchemaSourceVariant as Q, JsonSchemaSet as R, JsonSchemaMap as S, JsonSchemaNever as T, JsonSchemaUndefined as U, JsonSchemaTuple as V, JsonSchemaUnion as W, SchemaSource as X, SchemaEnvelopeOf as Y, SchemaSourceConfig as Z, JsonSchemaIntegerFormat as _, JsonSchemaAllOf as a, ValibotSchemaSource as at, JsonSchemaLiteral as b, JsonSchemaArray as c, JSON_SCHEMA_PRIMITIVE_TYPES as ct, JsonSchemaConditionalKeywords as d, SCHEMA_ARRAY_CONCAT_KEYWORDS as dt, StandardSchemaSchemaSource as et, JsonSchemaDate as f, SCHEMA_RECORD_KEYWORDS as ft, JsonSchemaInteger as g, JsonSchemaEnum as h, JsonSchema as i, ValibotSchema as it, JsonSchemaOf as j, JsonSchemaNumberFormat as k, JsonSchemaBigint as l, JSON_SCHEMA_TYPES as lt, JsonSchemaDecimalFormat as m, ExtractedSchemaEnvelope as n, UntypedSchema as nt, JsonSchemaAny as o, Zod3SchemaSource as ot, JsonSchemaDecimal as p, SCHEMA_SINGLE_KEYWORDS as pt, SchemaConfigVariant as q, InferExtractOptions as r, UntypedSchemaSource as rt, JsonSchemaAnyOf as s, JSON_SCHEMA_METADATA_KEYS as st, BaseSchemaSource as t, UntypedConfigObject as tt, JsonSchemaBoolean as u, JsonSchemaTypeNames as ut, JsonSchemaKeywords as v, JsonSchemaNativeEnum as w, JsonSchemaLogicKeywords as x, JsonSchemaLike as y, JsonSchemaString as z };
+//# sourceMappingURL=types-BawP3FVI.d.mts.map

package/dist/types-BawP3FVI.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BawP3FVI.d.mts","names":[],"sources":["../src/constants.ts","../src/types.ts"],"mappings":""}