@power-plant/core 0.0.3 → 0.0.5

package/dist/input-Osyk3YIo.d.cts

@@ -0,0 +1,58 @@
+import { c as Meta, l as MetaConfig, r as SchemaConfigObject, s as SchemaOf } from "./schema-DvnNqFd4.cjs";
+import { SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+import { InferLoadOptions, LoadReference } from "@stryke/resolve/types";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/types/input.d.ts
+type InputFunction<TSpec, TOptions extends object> = (options: TOptions) => MaybePromise<TSpec>;
+interface InputMetaConfig<TSpec, TOptions extends object> extends MetaConfig<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted/generated. This property can provide context about the input of the specification, such as whether it is derived from a file, a database, an API, or any other input. 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.
+   */
+  input?: string;
+}
+interface InputMeta<TSpec, TOptions extends object> extends Meta<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted/generated. This property can provide context about the input of the specification, such as whether it is derived from a file, a database, an API, or any other input. 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.
+   */
+  input?: string;
+}
+interface InputConfigObject<TSpec, TOptions extends object> {
+  /**
+   * The schema that defines the structure of the specification input for the generator. This schema is used to validate the input specification and ensure that it conforms to the expected format before being processed by the generator.
+   */
+  schema?: SchemaSourceConfig<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaConfigObject<TSpec, TOptions>;
+  /**
+   * The input implementation, either as a callable function, a static value, or a file reference.
+   */
+  input: TSpec | InputFunction<TSpec, TOptions> | LoadReference;
+  /**
+   * Optional metadata that provides contextual information for the input.
+   */
+  meta?: InputMetaConfig<TSpec, TOptions>;
+}
+type InputConfig<TSpec, TOptions extends object> = LoadReference | TSpec | InputFunction<TSpec, TOptions> | InputConfigObject<TSpec, TOptions>;
+type InferCreateInputOptions<T extends InputConfig<any, any>> = T extends LoadReference ? InferLoadOptions<T> : {};
+interface Input<TSpec, TOptions extends object> {
+  /**
+   * The schema that defines the structure of the specification input for the generator. This schema is used to validate the input specification and ensure that it conforms to the expected format before being processed by the generator.
+   */
+  schema: SchemaOf<TSpec, TOptions>;
+  /**
+   * Optional metadata that provides contextual information for the input.
+   */
+  meta?: InputMeta<TSpec, TOptions>;
+  /**
+   * The input of the generator, which can be used to specify where the generator retrieves its input data from. This can be defined as a function that takes the specification and returns a value, or it can be a static value.
+   *
+   * @remarks
+   * The `input` property can be either a static value of type `TSpec` or a function that takes the specification object and returns a value of type `TSpec` or a promise that resolves to `TSpec`. This allows for flexibility in how the generator retrieves its input data, enabling both synchronous and asynchronous data retrieval based on the specification.
+   *
+   * @param options - The options object that can be used to influence the generation process.
+   * @returns A value or a promise that resolves to a value, which will be used as the input data for the generator.
+   */
+  input: TSpec | InputFunction<TSpec, TOptions>;
+}
+//#endregion
+export { InputFunction as a, InputConfigObject as i, Input as n, InputMeta as o, InputConfig as r, InputMetaConfig as s, InferCreateInputOptions as t };
+//# sourceMappingURL=input-Osyk3YIo.d.cts.map

package/dist/input-Osyk3YIo.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-Osyk3YIo.d.cts","names":[],"sources":["../src/types/input.ts"],"mappings":";;;;;;KAwBY,aAAA,oCACV,OAAA,EAAS,QAAA,KACN,YAAA,CAAa,KAAA;AAAA,UAED,eAAA,yCAGP,UAAA,CAAW,KAAA,EAAO,QAAA;EAPH;;;EAWvB,KAAA;AAAA;AAAA,UAGe,SAAA,yCAAkD,IAAA,CACjE,KAAA,EACA,QAAA;EAde;;;EAmBf,KAAA;AAAA;AAAA,UAGe,iBAAA;EAtBC;;AAAK;EA0BrB,MAAA,GACI,kBAAA,CAAmB,KAAA,IACnB,gBAAA,CAAiB,KAAA,IACjB,kBAAA,CAAmB,KAAA,EAAO,QAAA;EA3BA;;;EAgC9B,KAAA,EAAO,KAAA,GAAQ,aAAA,CAAc,KAAA,EAAO,QAAA,IAAY,aAAA;EA7BxC;;;EAkCR,IAAA,GAAO,eAAA,CAAgB,KAAA,EAAO,QAAA;AAAA;AAAA,KAGpB,WAAA,mCACR,aAAA,GACA,KAAA,GACA,aAAA,CAAc,KAAA,EAAO,QAAA,IACrB,iBAAA,CAAkB,KAAA,EAAO,QAAA;AAAA,KAEjB,uBAAA,WAAkC,WAAA,cAC5C,CAAA,SAAU,aAAA,GACN,gBAAA,CAAiB,CAAA;AAAA,UAIN,KAAA;EA7Cf;;AAAK;EAiDL,MAAA,EAAQ,QAAA,CAAS,KAAA,EAAO,QAAA;EA9CA;;;EAmDxB,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,QAAA;EAnDyC;;;;;;;;;EA8DjE,KAAA,EAAO,KAAA,GAAQ,aAAA,CAAc,KAAA,EAAO,QAAA;AAAA"}

package/dist/output/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../helpers-BWqqSR02.cjs"),t=require("../define-C_GLY1-q.cjs"),n=require("../create-MFKW4s0V.cjs");exports.createOutput=n.t,exports.defineOutput=t.t,exports.extractOutputMeta=n.n,exports.isOutputConfigObject=e.t;

package/dist/output/index.d.cts

@@ -0,0 +1,35 @@
+import { c as OutputConfig, d as OutputMeta, f as OutputMetaConfig, l as OutputConfigObject, o as InferCreateOutputOptions, s as Output } from "../generator-D9KikId4.cjs";
+import { s as SchemaOf } from "../schema-DvnNqFd4.cjs";
+import { t as defineOutput } from "../define-OeGEPyv1.cjs";
+import { ExtractedSchemaEnvelope } from "@power-plant/schema";
+
+//#region src/output/create.d.ts
+/**
+ * Extracts and normalizes {@link OutputMeta | output metadata} from a given {@link OutputMetaConfig}. This function ensures that the metadata is in a consistent format, converting version numbers to strings and filtering out any invalid or empty tags.
+ *
+ * @param schema - The schema that the specification is expected to conform to.
+ * @param config - The output metadata config to extract and normalize.
+ * @returns The normalized output metadata.
+ */
+declare function extractOutputMeta<TSpec, TOptions extends object>(schema: ExtractedSchemaEnvelope<TSpec> | SchemaOf<TSpec, TOptions>, config?: OutputMetaConfig<TSpec, TOptions>): OutputMeta<TSpec, TOptions>;
+/**
+ * Normalizes any accepted output config into a concrete output descriptor.
+ *
+ * @param schema - The schema that the output config is expected to conform to.
+ * @param config - The output config to normalize.
+ * @param options - Optional options for resolving the output config.
+ * @returns A promise that resolves to a normalized output descriptor.
+ */
+declare function createOutput<TSpec, TOptions extends object, TReturns = void>(schema: SchemaOf<TSpec, TOptions>, config: OutputConfig<TSpec, TOptions, TReturns>, options?: InferCreateOutputOptions<typeof config>): Promise<Output<TSpec, TOptions, TReturns>>;
+//#endregion
+//#region src/output/helpers.d.ts
+/**
+ * Checks if the provided input is a {@link OutputConfigObject}.
+ *
+ * @param config - The input to check.
+ * @returns True if the input is a {@link OutputConfigObject}, false otherwise.
+ */
+declare function isOutputConfigObject<TSpec, TOptions extends object, TReturns = void>(config: unknown): config is OutputConfigObject<TSpec, TOptions, TReturns>;
+//#endregion
+export { createOutput, defineOutput, extractOutputMeta, isOutputConfigObject };
+//# sourceMappingURL=index.d.cts.map

package/dist/output/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/output/create.ts","../../src/output/helpers.ts"],"mappings":";;;;;;;;;AA2CA;;;;iBAAgB,iBAAA,iCACd,MAAA,EAAQ,uBAAA,CAAwB,KAAA,IAAS,QAAA,CAAS,KAAA,EAAO,QAAA,GACzD,MAAA,GAAS,gBAAA,CAAiB,KAAA,EAAO,QAAA,IAChC,UAAA,CAAW,KAAA,EAAO,QAAA;;;;;;;;;iBAoCC,YAAA,kDAKpB,MAAA,EAAQ,QAAA,CAAS,KAAA,EAAO,QAAA,GACxB,MAAA,EAAQ,YAAA,CAAa,KAAA,EAAO,QAAA,EAAU,QAAA,GACtC,OAAA,GAAS,wBAAA,QAAgC,MAAA,IACxC,OAAA,CAAQ,MAAA,CAAO,KAAA,EAAO,QAAA,EAAU,QAAA;;;;;;;;AA/CnC;iBChBgB,oBAAA,kDAId,MAAA,YAAkB,MAAA,IAAU,kBAAA,CAAmB,KAAA,EAAO,QAAA,EAAU,QAAA"}

package/dist/output/index.d.mts

@@ -0,0 +1,35 @@
+import { c as OutputConfig, d as OutputMeta, f as OutputMetaConfig, l as OutputConfigObject, o as InferCreateOutputOptions, s as Output } from "../generator-9GSAWmOj.mjs";
+import { s as SchemaOf } from "../schema-DvnNqFd4.mjs";
+import { t as defineOutput } from "../define-hhs2D0Hq.mjs";
+import { ExtractedSchemaEnvelope } from "@power-plant/schema";
+
+//#region src/output/create.d.ts
+/**
+ * Extracts and normalizes {@link OutputMeta | output metadata} from a given {@link OutputMetaConfig}. This function ensures that the metadata is in a consistent format, converting version numbers to strings and filtering out any invalid or empty tags.
+ *
+ * @param schema - The schema that the specification is expected to conform to.
+ * @param config - The output metadata config to extract and normalize.
+ * @returns The normalized output metadata.
+ */
+declare function extractOutputMeta<TSpec, TOptions extends object>(schema: ExtractedSchemaEnvelope<TSpec> | SchemaOf<TSpec, TOptions>, config?: OutputMetaConfig<TSpec, TOptions>): OutputMeta<TSpec, TOptions>;
+/**
+ * Normalizes any accepted output config into a concrete output descriptor.
+ *
+ * @param schema - The schema that the output config is expected to conform to.
+ * @param config - The output config to normalize.
+ * @param options - Optional options for resolving the output config.
+ * @returns A promise that resolves to a normalized output descriptor.
+ */
+declare function createOutput<TSpec, TOptions extends object, TReturns = void>(schema: SchemaOf<TSpec, TOptions>, config: OutputConfig<TSpec, TOptions, TReturns>, options?: InferCreateOutputOptions<typeof config>): Promise<Output<TSpec, TOptions, TReturns>>;
+//#endregion
+//#region src/output/helpers.d.ts
+/**
+ * Checks if the provided input is a {@link OutputConfigObject}.
+ *
+ * @param config - The input to check.
+ * @returns True if the input is a {@link OutputConfigObject}, false otherwise.
+ */
+declare function isOutputConfigObject<TSpec, TOptions extends object, TReturns = void>(config: unknown): config is OutputConfigObject<TSpec, TOptions, TReturns>;
+//#endregion
+export { createOutput, defineOutput, extractOutputMeta, isOutputConfigObject };
+//# sourceMappingURL=index.d.mts.map

package/dist/output/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/output/create.ts","../../src/output/helpers.ts"],"mappings":""}

package/dist/output/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../helpers-8tc33xyp.mjs";import{t}from"../define-C5_Sx-Eg.mjs";import{n,t as r}from"../create-cqJljXdZ.mjs";export{r as createOutput,t as defineOutput,n as extractOutputMeta,e as isOutputConfigObject};

package/dist/schema/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../helpers-Botqc1jf.cjs"),t=require("../define-B__DotaM.cjs"),n=require("../create-D_u2Zj81.cjs");exports.createSchema=n.t,exports.defineSchema=t.t,exports.extractSchemaMeta=n.n,exports.isSchemaConfigObject=e.t;

package/dist/schema/index.d.cts

@@ -0,0 +1,33 @@
+import { a as SchemaMetaConfig, i as SchemaMeta, r as SchemaConfigObject, s as SchemaOf, t as InferCreateSchemaOptions } from "../schema-DvnNqFd4.cjs";
+import { t as defineSchema } from "../define-B5baoppv.cjs";
+import { ExtractedSchemaEnvelope, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+
+//#region src/schema/create.d.ts
+/**
+ * Extracts and normalizes {@link SchemaMeta | schema metadata} from a given {@link SchemaMetaConfig}. This function ensures that the metadata is in a consistent format, converting version numbers to strings and filtering out any invalid or empty tags.
+ *
+ * @param schema - The schema from which to extract metadata.
+ * @param input - The schema metadata input to extract and normalize.
+ * @returns The normalized schema metadata.
+ */
+declare function extractSchemaMeta<TSpec, TOptions extends object>(schema: ExtractedSchemaEnvelope<TSpec>, input?: SchemaMetaConfig<TSpec, TOptions>): SchemaMeta<TSpec, TOptions>;
+/**
+ * Normalizes any accepted schema input into a concrete schema descriptor.
+ *
+ * @param input - The schema input to normalize.
+ * @param options - Optional options for resolving the schema input.
+ * @returns A promise that resolves to a normalized schema descriptor.
+ */
+declare function createSchema<TSpec, TOptions extends object>(input: SchemaSourceConfig<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaConfigObject<TSpec, TOptions>, options?: InferCreateSchemaOptions<typeof input>): Promise<SchemaOf<TSpec, TOptions>>;
+//#endregion
+//#region src/schema/helpers.d.ts
+/**
+ * Checks if the provided configuration is a {@link SchemaConfigObject}.
+ *
+ * @param config - The configuration to check.
+ * @returns True if the configuration is a {@link SchemaConfigObject}, false otherwise.
+ */
+declare function isSchemaConfigObject<TSpec, TOptions extends object>(config: unknown): config is SchemaConfigObject<TSpec, TOptions>;
+//#endregion
+export { createSchema, defineSchema, extractSchemaMeta, isSchemaConfigObject };
+//# sourceMappingURL=index.d.cts.map

package/dist/schema/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/schema/create.ts","../../src/schema/helpers.ts"],"mappings":";;;;;;;;AA8CA;;;;iBAAgB,iBAAA,iCACd,MAAA,EAAQ,uBAAA,CAAwB,KAAA,GAChC,KAAA,GAAQ,gBAAA,CAAiB,KAAA,EAAO,QAAA,IAC/B,UAAA,CAAW,KAAA,EAAO,QAAA;;;;;;;;iBAoCC,YAAA,iCACpB,KAAA,EACI,kBAAA,CAAmB,KAAA,IACnB,gBAAA,CAAiB,KAAA,IACjB,kBAAA,CAAmB,KAAA,EAAO,QAAA,GAC9B,OAAA,GAAS,wBAAA,QAAgC,KAAA,IACxC,OAAA,CAAQ,QAAA,CAAS,KAAA,EAAO,QAAA;;;;;;;AA7C3B;;iBCnBgB,oBAAA,iCACd,MAAA,YACC,MAAA,IAAU,kBAAA,CAAmB,KAAA,EAAO,QAAA"}

package/dist/schema/index.d.mts

@@ -0,0 +1,33 @@
+import { a as SchemaMetaConfig, i as SchemaMeta, r as SchemaConfigObject, s as SchemaOf, t as InferCreateSchemaOptions } from "../schema-DvnNqFd4.mjs";
+import { t as defineSchema } from "../define-DQQxZK9L.mjs";
+import { ExtractedSchemaEnvelope, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+
+//#region src/schema/create.d.ts
+/**
+ * Extracts and normalizes {@link SchemaMeta | schema metadata} from a given {@link SchemaMetaConfig}. This function ensures that the metadata is in a consistent format, converting version numbers to strings and filtering out any invalid or empty tags.
+ *
+ * @param schema - The schema from which to extract metadata.
+ * @param input - The schema metadata input to extract and normalize.
+ * @returns The normalized schema metadata.
+ */
+declare function extractSchemaMeta<TSpec, TOptions extends object>(schema: ExtractedSchemaEnvelope<TSpec>, input?: SchemaMetaConfig<TSpec, TOptions>): SchemaMeta<TSpec, TOptions>;
+/**
+ * Normalizes any accepted schema input into a concrete schema descriptor.
+ *
+ * @param input - The schema input to normalize.
+ * @param options - Optional options for resolving the schema input.
+ * @returns A promise that resolves to a normalized schema descriptor.
+ */
+declare function createSchema<TSpec, TOptions extends object>(input: SchemaSourceConfig<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaConfigObject<TSpec, TOptions>, options?: InferCreateSchemaOptions<typeof input>): Promise<SchemaOf<TSpec, TOptions>>;
+//#endregion
+//#region src/schema/helpers.d.ts
+/**
+ * Checks if the provided configuration is a {@link SchemaConfigObject}.
+ *
+ * @param config - The configuration to check.
+ * @returns True if the configuration is a {@link SchemaConfigObject}, false otherwise.
+ */
+declare function isSchemaConfigObject<TSpec, TOptions extends object>(config: unknown): config is SchemaConfigObject<TSpec, TOptions>;
+//#endregion
+export { createSchema, defineSchema, extractSchemaMeta, isSchemaConfigObject };
+//# sourceMappingURL=index.d.mts.map

package/dist/schema/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/schema/create.ts","../../src/schema/helpers.ts"],"mappings":""}

package/dist/schema/index.mjs

@@ -0,0 +1 @@
+import{t as e}from"../helpers-DwNCh4F3.mjs";import{t}from"../define-DE0RBdIR.mjs";import{n,t as r}from"../create-DcfhZUHw.mjs";export{r as createSchema,t as defineSchema,n as extractSchemaMeta,e as isSchemaConfigObject};

package/dist/schema-DvnNqFd4.d.cts

@@ -0,0 +1,180 @@
+import { InferExtractOptions, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/types/meta.d.ts
+type MetaValue<TSpec, TOptions extends object, TValue = any> = TValue | ((spec: TSpec, options: TOptions) => MaybePromise<TValue>);
+type MetaDeprecated = true | string | {
+  message?: string;
+  since?: string;
+  alternative?: string;
+};
+type MetaLink = string | {
+  href: string;
+  description?: string;
+};
+interface MetaConfig<TSpec, TOptions extends object> {
+  /**
+   * 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, TOptions, 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, TOptions, string | Date | number>;
+  /**
+   * A string that describes the schema in some way.
+   */
+  description?: MetaValue<TSpec, TOptions, 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 `title` 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.
+   */
+  title?: MetaValue<TSpec, TOptions, string>;
+  /**
+   * A string that describes when the schema is used.
+   */
+  usage?: MetaValue<TSpec, TOptions, 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, TOptions, 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, TOptions, 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, TOptions, MetaLink[]>;
+}
+interface Meta<TSpec, TOptions extends object> {
+  /**
+   * 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, TOptions, 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, TOptions, 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, TOptions, string | Date | number>;
+  /**
+   * A string that describes the schema in some way.
+   */
+  description: MetaValue<TSpec, TOptions, 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 `title` 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.
+   */
+  title: MetaValue<TSpec, TOptions, string>;
+  /**
+   * A string that describes when the schema is used.
+   */
+  usage?: MetaValue<TSpec, TOptions, 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, TOptions, 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, TOptions, 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, TOptions, MetaLink[]>;
+}
+//#endregion
+//#region src/types/schema.d.ts
+type SchemaMetaExample<TSpec> = TSpec | {
+  name?: string;
+  description?: string;
+  value: TSpec;
+};
+interface SchemaMetaConfig<TSpec, TOptions extends object = any> extends MetaConfig<TSpec, TOptions> {
+  /**
+   * Examples of valid data for the schema. This can be a single example or an array of examples.
+   */
+  examples?: SchemaMetaExample<TSpec> | MetaValue<TSpec, TOptions, SchemaMetaExample<TSpec>[]>;
+  /**
+   * A description of the specification that is described by this schema.
+   */
+  spec?: MetaValue<TSpec, TOptions, string>;
+}
+interface SchemaMeta<TSpec, TOptions extends object = any> extends Meta<TSpec, TOptions> {
+  /**
+   * Examples of valid data for the schema.
+   */
+  examples: MetaValue<TSpec, TOptions, SchemaMetaExample<TSpec>[]>;
+}
+/**
+ * Schema input wrapper that attaches optional contextual metadata.
+ */
+interface SchemaConfigObject<TSpec, TOptions extends object = any> {
+  /**
+   * The schema that defines the structure of the specification input for the generator. This schema is used to validate the input specification and ensure that it conforms to the expected format before being processed by the generator.
+   */
+  schema: SchemaSourceConfig<TSpec> | SchemaEnvelopeOf<TSpec>;
+  /**
+   * Optional metadata that provides contextual information for the schema.
+   */
+  meta?: SchemaMetaConfig<TSpec, TOptions>;
+}
+type InferCreateSchemaOptions<T extends SchemaSourceConfig<any> | SchemaEnvelopeOf<any> | SchemaConfigObject<any, any>> = T extends SchemaSourceConfig<any> | SchemaEnvelopeOf<any> ? InferExtractOptions<T> : {};
+/**
+ * A schema extracted from a source input, normalized to JSON Schema.
+ */
+interface Schema<TSpec, TOptions extends object = any> extends SchemaEnvelopeOf<TSpec> {
+  /**
+   * Optional contextual metadata associated with the schema.
+   */
+  meta: SchemaMeta<TSpec, TOptions>;
+}
+/**
+ * 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}
+ */
+type SchemaOf<TSpec, TOptions extends object = any> = Schema<TSpec, TOptions>;
+//#endregion
+export { SchemaMetaConfig as a, Meta as c, MetaLink as d, MetaValue as f, SchemaMeta as i, MetaConfig as l, Schema as n, SchemaMetaExample as o, SchemaConfigObject as r, SchemaOf as s, InferCreateSchemaOptions as t, MetaDeprecated as u };
+//# sourceMappingURL=schema-DvnNqFd4.d.cts.map

package/dist/schema-DvnNqFd4.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-DvnNqFd4.d.cts","names":[],"sources":["../src/types/meta.ts","../src/types/schema.ts"],"mappings":";;;;KAoBY,SAAA,iDACV,MAAA,KAAW,IAAA,EAAM,KAAA,EAAO,OAAA,EAAS,QAAA,KAAa,YAAA,CAAa,MAAA;AAAA,KAEjD,cAAA;EACQ,OAAA;EAAkB,KAAA;EAAgB,WAAA;AAAA;AAAA,KAE1C,QAAA;EAAsB,IAAA;EAAc,WAAW;AAAA;AAAA,UAE1C,UAAA;EAP2C;;;;;;EAc1D,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,QAAA;EAdb;;;;;;AAAsD;AAEnE;EAsBE,OAAA,GAAU,SAAA,CAAU,KAAA,EAAO,QAAA,WAAmB,IAAA;;;;EAK9C,WAAA,GAAc,SAAA,CAAU,KAAA,EAAO,QAAA;EA1BqB;;AAAW;AAEjE;;;EAgCE,KAAA,GAAQ,SAAA,CAAU,KAAA,EAAO,QAAA;EAhCgC;AAE3D;;EAmCE,KAAA,GAAQ,SAAA,CAAU,KAAA,EAAO,QAAA;EA5BR;;;;;;EAoCjB,UAAA,GAAa,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,cAAA;EArBhB;;;;;;EA6BxB,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,QAAA;EAhBC;;;EAqBzB,KAAA,GAAQ,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA;AAAA,UAGpB,IAAA;EARE;;;;;;EAejB,EAAA,EAAI,SAAA,CAAU,KAAA,EAAO,QAAA;EAVJ;;;;;;EAkBjB,IAAA,EAAM,SAAA,CAAU,KAAA,EAAO,QAAA;EAnEC;;;;;;;;EA6ExB,OAAA,EAAS,SAAA,CAAU,KAAA,EAAO,QAAA,WAAmB,IAAA;EA9Dd;;;EAmE/B,WAAA,EAAa,SAAA,CAAU,KAAA,EAAO,QAAA;EA3DL;;;;;;EAmEzB,KAAA,EAAO,SAAA,CAAU,KAAA,EAAO,QAAA;EAtDD;;;EA2DvB,KAAA,GAAQ,SAAA,CAAU,KAAA,EAAO,QAAA;EAnDlB;;;;;;EA2DP,UAAA,GAAa,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,cAAA;EAtDL;;AAAQ;AAG7C;;;EA2DE,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,QAAA;EApDH;;;EAyDrB,KAAA,EAAO,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA;;;KC9HxB,iBAAA,UACV,KAAA;EAAU,IAAA;EAAe,WAAA;EAAsB,KAAA,EAAO,KAAK;AAAA;AAAA,UAE5C,gBAAA,+CAGP,UAAA,CAAW,KAAA,EAAO,QAAA;EDVT;;;ECcjB,QAAA,GACI,iBAAA,CAAkB,KAAA,IAClB,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,iBAAA,CAAkB,KAAA;EDhBS;;;ECqB1D,IAAA,GAAO,SAAA,CAAU,KAAA,EAAO,QAAA;AAAA;AAAA,UAGT,UAAA,+CAAyD,IAAA,CACxE,KAAA,EACA,QAAA;ED1BiB;;;EC+BjB,QAAA,EAAU,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,iBAAA,CAAkB,KAAA;AAAA;;;AD/BU;UCqClD,kBAAA;EDnCS;;;ECuCxB,MAAA,EAAQ,kBAAA,CAAmB,KAAA,IAAS,gBAAA,CAAiB,KAAA;EDtCjB;;;EC2CpC,IAAA,GAAO,gBAAA,CAAiB,KAAA,EAAO,QAAA;AAAA;AAAA,KAGrB,wBAAA,WAEN,kBAAA,QACA,gBAAA,QACA,kBAAA,cACF,CAAA,SAAU,kBAAA,QAA0B,gBAAA,QACpC,mBAAA,CAAoB,CAAA;;;ADlDmC;UCyD1C,MAAA,+CAGP,gBAAA,CAAiB,KAAA;ED1DA;;;EC8DzB,IAAA,EAAM,UAAA,CAAW,KAAA,EAAO,QAAA;AAAA;;;;;;;;KAUd,QAAA,yCAAiD,MAAA,CAC3D,KAAA,EACA,QAAA"}

package/dist/schema-DvnNqFd4.d.mts

@@ -0,0 +1,180 @@
+import { InferExtractOptions, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/types/meta.d.ts
+type MetaValue<TSpec, TOptions extends object, TValue = any> = TValue | ((spec: TSpec, options: TOptions) => MaybePromise<TValue>);
+type MetaDeprecated = true | string | {
+  message?: string;
+  since?: string;
+  alternative?: string;
+};
+type MetaLink = string | {
+  href: string;
+  description?: string;
+};
+interface MetaConfig<TSpec, TOptions extends object> {
+  /**
+   * 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, TOptions, 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, TOptions, string | Date | number>;
+  /**
+   * A string that describes the schema in some way.
+   */
+  description?: MetaValue<TSpec, TOptions, 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 `title` 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.
+   */
+  title?: MetaValue<TSpec, TOptions, string>;
+  /**
+   * A string that describes when the schema is used.
+   */
+  usage?: MetaValue<TSpec, TOptions, 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, TOptions, 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, TOptions, 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, TOptions, MetaLink[]>;
+}
+interface Meta<TSpec, TOptions extends object> {
+  /**
+   * 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, TOptions, 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, TOptions, 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, TOptions, string | Date | number>;
+  /**
+   * A string that describes the schema in some way.
+   */
+  description: MetaValue<TSpec, TOptions, 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 `title` 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.
+   */
+  title: MetaValue<TSpec, TOptions, string>;
+  /**
+   * A string that describes when the schema is used.
+   */
+  usage?: MetaValue<TSpec, TOptions, 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, TOptions, 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, TOptions, 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, TOptions, MetaLink[]>;
+}
+//#endregion
+//#region src/types/schema.d.ts
+type SchemaMetaExample<TSpec> = TSpec | {
+  name?: string;
+  description?: string;
+  value: TSpec;
+};
+interface SchemaMetaConfig<TSpec, TOptions extends object = any> extends MetaConfig<TSpec, TOptions> {
+  /**
+   * Examples of valid data for the schema. This can be a single example or an array of examples.
+   */
+  examples?: SchemaMetaExample<TSpec> | MetaValue<TSpec, TOptions, SchemaMetaExample<TSpec>[]>;
+  /**
+   * A description of the specification that is described by this schema.
+   */
+  spec?: MetaValue<TSpec, TOptions, string>;
+}
+interface SchemaMeta<TSpec, TOptions extends object = any> extends Meta<TSpec, TOptions> {
+  /**
+   * Examples of valid data for the schema.
+   */
+  examples: MetaValue<TSpec, TOptions, SchemaMetaExample<TSpec>[]>;
+}
+/**
+ * Schema input wrapper that attaches optional contextual metadata.
+ */
+interface SchemaConfigObject<TSpec, TOptions extends object = any> {
+  /**
+   * The schema that defines the structure of the specification input for the generator. This schema is used to validate the input specification and ensure that it conforms to the expected format before being processed by the generator.
+   */
+  schema: SchemaSourceConfig<TSpec> | SchemaEnvelopeOf<TSpec>;
+  /**
+   * Optional metadata that provides contextual information for the schema.
+   */
+  meta?: SchemaMetaConfig<TSpec, TOptions>;
+}
+type InferCreateSchemaOptions<T extends SchemaSourceConfig<any> | SchemaEnvelopeOf<any> | SchemaConfigObject<any, any>> = T extends SchemaSourceConfig<any> | SchemaEnvelopeOf<any> ? InferExtractOptions<T> : {};
+/**
+ * A schema extracted from a source input, normalized to JSON Schema.
+ */
+interface Schema<TSpec, TOptions extends object = any> extends SchemaEnvelopeOf<TSpec> {
+  /**
+   * Optional contextual metadata associated with the schema.
+   */
+  meta: SchemaMeta<TSpec, TOptions>;
+}
+/**
+ * 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}
+ */
+type SchemaOf<TSpec, TOptions extends object = any> = Schema<TSpec, TOptions>;
+//#endregion
+export { SchemaMetaConfig as a, Meta as c, MetaLink as d, MetaValue as f, SchemaMeta as i, MetaConfig as l, Schema as n, SchemaMetaExample as o, SchemaConfigObject as r, SchemaOf as s, InferCreateSchemaOptions as t, MetaDeprecated as u };
+//# sourceMappingURL=schema-DvnNqFd4.d.mts.map

package/dist/schema-DvnNqFd4.d.mts.map

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