@power-plant/core 0.0.2 → 0.0.4

package/dist/sink/index.d.mts

@@ -1,15 +1,2 @@
-import { a as SinkMeta, i as SinkInputWithMeta, n as SinkFunction, r as SinkInput, t as Sink } from "../types-B2MtSxCp.mjs";
-import { ResolveOptions } from "@power-plant/schema/resolve";
-import { SchemaOf } from "@power-plant/schema/types";
-
-//#region src/sink/constants.d.ts
-declare const VALID_SINK_FILE_EXTENSIONS: string[];
-//#endregion
-//#region src/sink/extract.d.ts
-/**
- * Normalizes any accepted sink input into a concrete sink descriptor.
- */
-declare function extractSink<TSpec, TOptions = never>(schema: SchemaOf<TSpec>, input: SinkInput<TSpec, TOptions>, options?: ResolveOptions): Promise<Sink<TSpec, TOptions>>;
-//#endregion
-export { type Sink, type SinkFunction, type SinkInput, type SinkInputWithMeta, type SinkMeta, VALID_SINK_FILE_EXTENSIONS, extractSink };
-//# sourceMappingURL=index.d.mts.map
+import { n as extractSinkMeta, t as createSink } from "../create-DEe398aQ.mjs";
+export { createSink, extractSinkMeta };

package/dist/sink/index.mjs

@@ -1 +1 @@
-import{n as e,t}from"../extract-ZIpZAKsq.mjs";export{e as VALID_SINK_FILE_EXTENSIONS,t as extractSink};
+import{createSink as e,extractSinkMeta as t}from"./create.mjs";export{e as createSink,t as extractSinkMeta};

package/dist/sink-CHQncb8H.d.mts

@@ -0,0 +1,58 @@
+import { c as Meta, p as MaybePromise, r as SchemaInputObject, s as SchemaOf, u as MetaInput } from "./schema-xFkmOyE6.mjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { SchemaEnvelopeOf, SchemaSourceInput } from "@power-plant/schema/types";
+
+//#region src/types/sink.d.ts
+type SinkFunction<TSpec, TOptions extends object, TReturns = void> = (spec: TSpec, context: TOptions) => MaybePromise<TReturns>;
+interface SinkMetaInput<TSpec, TOptions extends object> extends MetaInput<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted or generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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.
+   */
+  produces?: string;
+}
+interface SinkMeta<TSpec, TOptions extends object> extends Meta<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted or generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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.
+   */
+  produces?: string;
+}
+interface SinkInputObject<TSpec, TOptions extends object, TReturns = void> {
+  /**
+   * 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?: SchemaSourceInput<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaInputObject<TSpec, TOptions>;
+  /**
+   * Optional metadata that provides contextual information for the sink.
+   */
+  meta?: SinkMeta<TSpec, TOptions>;
+  /**
+   * The sink implementation, either as a callable function or a file reference.
+   */
+  sink: SinkFunction<TSpec, TOptions, TReturns> | LoadInput;
+}
+type SinkInput<TSpec, TOptions extends object, TReturns = void> = LoadInput | SinkFunction<TSpec, TOptions, TReturns> | SinkInputObject<TSpec, TOptions, TReturns>;
+type InferCreateSinkOptions<T extends SinkInput<any, any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Sink<TSpec, TOptions extends object, TReturns = void> {
+  /**
+   * 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 sink.
+   */
+  meta?: SinkMeta<TSpec, TOptions>;
+  /**
+   * The sink of the generator, which can be used to specify where the generator sends its output data. This can be defined as a function that takes the specification and returns a value, or it can be a static value.
+   *
+   * @remarks
+   * The `sink` property is defined as a function that takes the specification object and any additional parameters, and returns a value or a promise that resolves to a value. This allows for flexibility in how the generator sends its output data, enabling both synchronous and asynchronous data handling based on the specification.
+   *
+   * @param spec - The specification object that conforms to the defined schema input.
+   * @param params - Additional parameters that may be needed for the sink function to process the output data.
+   * @returns A value or a promise that resolves to a value, which will be used as the output data for the generator.
+   */
+  sink: SinkFunction<TSpec, TOptions, TReturns>;
+}
+//#endregion
+export { SinkInputObject as a, SinkInput as i, Sink as n, SinkMeta as o, SinkFunction as r, SinkMetaInput as s, InferCreateSinkOptions as t };
+//# sourceMappingURL=sink-CHQncb8H.d.mts.map

package/dist/sink-CHQncb8H.d.mts.map

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

package/dist/sink-DHpx94GM.d.cts

@@ -0,0 +1,58 @@
+import { c as Meta, p as MaybePromise, r as SchemaInputObject, s as SchemaOf, u as MetaInput } from "./schema-xFkmOyE6.cjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { SchemaEnvelopeOf, SchemaSourceInput } from "@power-plant/schema/types";
+
+//#region src/types/sink.d.ts
+type SinkFunction<TSpec, TOptions extends object, TReturns = void> = (spec: TSpec, context: TOptions) => MaybePromise<TReturns>;
+interface SinkMetaInput<TSpec, TOptions extends object> extends MetaInput<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted or generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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.
+   */
+  produces?: string;
+}
+interface SinkMeta<TSpec, TOptions extends object> extends Meta<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted or generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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.
+   */
+  produces?: string;
+}
+interface SinkInputObject<TSpec, TOptions extends object, TReturns = void> {
+  /**
+   * 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?: SchemaSourceInput<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaInputObject<TSpec, TOptions>;
+  /**
+   * Optional metadata that provides contextual information for the sink.
+   */
+  meta?: SinkMeta<TSpec, TOptions>;
+  /**
+   * The sink implementation, either as a callable function or a file reference.
+   */
+  sink: SinkFunction<TSpec, TOptions, TReturns> | LoadInput;
+}
+type SinkInput<TSpec, TOptions extends object, TReturns = void> = LoadInput | SinkFunction<TSpec, TOptions, TReturns> | SinkInputObject<TSpec, TOptions, TReturns>;
+type InferCreateSinkOptions<T extends SinkInput<any, any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Sink<TSpec, TOptions extends object, TReturns = void> {
+  /**
+   * 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 sink.
+   */
+  meta?: SinkMeta<TSpec, TOptions>;
+  /**
+   * The sink of the generator, which can be used to specify where the generator sends its output data. This can be defined as a function that takes the specification and returns a value, or it can be a static value.
+   *
+   * @remarks
+   * The `sink` property is defined as a function that takes the specification object and any additional parameters, and returns a value or a promise that resolves to a value. This allows for flexibility in how the generator sends its output data, enabling both synchronous and asynchronous data handling based on the specification.
+   *
+   * @param spec - The specification object that conforms to the defined schema input.
+   * @param params - Additional parameters that may be needed for the sink function to process the output data.
+   * @returns A value or a promise that resolves to a value, which will be used as the output data for the generator.
+   */
+  sink: SinkFunction<TSpec, TOptions, TReturns>;
+}
+//#endregion
+export { SinkInputObject as a, SinkInput as i, Sink as n, SinkMeta as o, SinkFunction as r, SinkMetaInput as s, InferCreateSinkOptions as t };
+//# sourceMappingURL=sink-DHpx94GM.d.cts.map

package/dist/sink-DHpx94GM.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink-DHpx94GM.d.cts","names":[],"sources":["../src/types/sink.ts"],"mappings":";;;;;KA2BY,YAAA,qDACV,IAAA,EAAM,KAAA,EACN,OAAA,EAAS,QAAA,KACN,YAAA,CAAa,QAAA;AAAA,UAED,aAAA,yCAGP,SAAA,CAAU,KAAA,EAAO,QAAA;EARH;;;EAYtB,QAAA;AAAA;AAAA,UAGe,QAAA,yCAAiD,IAAA,CAChE,KAAA,EACA,QAAA;EAde;;;EAmBf,QAAA;AAAA;AAAA,UAGe,eAAA;EAvBN;;;EA+BT,MAAA,GACI,iBAAA,CAAkB,KAAA,IAClB,gBAAA,CAAiB,KAAA,IACjB,iBAAA,CAAkB,KAAA,EAAO,QAAA;EAjCL;AAAA;AAE1B;EAoCE,IAAA,GAAO,QAAA,CAAS,KAAA,EAAO,QAAA;EApCK;;;EAyC5B,IAAA,EAAM,YAAA,CAAa,KAAA,EAAO,QAAA,EAAU,QAAA,IAAY,SAAA;AAAA;AAAA,KAGtC,SAAA,oDACR,SAAA,GACA,YAAA,CAAa,KAAA,EAAO,QAAA,EAAU,QAAA,IAC9B,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA,KAEzB,sBAAA,WAAiC,SAAA,mBAC3C,CAAA,SAAU,SAAA,GACN,gBAAA,CAAiB,CAAA;AAAA,UAIN,IAAA;EApDP;;;EAwDR,MAAA,EAAQ,QAAA,CAAS,KAAA,EAAO,QAAA;EApDhB;AAAA;AAGV;EAsDE,IAAA,GAAO,QAAA,CAAS,KAAA,EAAO,QAAA;EAtDA;;;;;;;;;;EAkEvB,IAAA,EAAM,YAAA,CAAa,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA"}

package/dist/source/create.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../create-23iLtMb_.cjs"),t=require("./helpers.cjs");let n=require("@stryke/resolve/load"),r=require("@stryke/type-checks/is-function"),i=require("@power-plant/schema/helpers"),a=require("@stryke/resolve/type-checks");function o(t,n){let i=t?.schema??{},a=e.r(t,n);return a.description=e.i((0,r.isFunction)(a.title)?async(e,t)=>`Determines the ${await Promise.resolve(a.title(e,t))??``} specification from a {title} source.`:`Determines the ${a.title??``} specification from a {title} source.`,i,a,n?.description),a}async function s(r,c,l={}){let{source:u,meta:d,schema:f}=t.isSourceInputObject(c)?c:{source:c,meta:{}},p=r;f&&(p=await e.t(f,l),p.schema=(0,i.mergeMetadata)(p.schema,r.schema));let m;if((0,a.isLoadInput)(u))try{let e=await(0,n.load)(u,l);m=t.isSourceInputObject(e)?await s(p,e.source,l).then(e=>e.source):e}catch{}return m||=u,{schema:p,source:m,meta:o(p,d)}}exports.createSource=s,exports.extractSourceMeta=o;

package/dist/source/create.d.cts

@@ -0,0 +1,2 @@
+import { n as extractSourceMeta, t as createSource } from "../create-DUt-efk7.cjs";
+export { createSource, extractSourceMeta };

package/dist/source/create.d.mts

@@ -0,0 +1,2 @@
+import { n as extractSourceMeta, t as createSource } from "../create-Qxy2mq7r.mjs";
+export { createSource, extractSourceMeta };

package/dist/source/create.mjs

@@ -0,0 +1,2 @@
+import{i as e,r as t,t as n}from"../create-BR4IeVl4.mjs";import{isSourceInputObject as r}from"./helpers.mjs";import{load as i}from"@stryke/resolve/load";import{isFunction as a}from"@stryke/type-checks/is-function";import{mergeMetadata as o}from"@power-plant/schema/helpers";import{isLoadInput as s}from"@stryke/resolve/type-checks";function c(n,r){let i=n?.schema??{},o=t(n,r);return o.description=e(a(o.title)?async(e,t)=>`Determines the ${await Promise.resolve(o.title(e,t))??``} specification from a {title} source.`:`Determines the ${o.title??``} specification from a {title} source.`,i,o,r?.description),o}async function l(e,t,a={}){let{source:u,meta:d,schema:f}=r(t)?t:{source:t,meta:{}},p=e;f&&(p=await n(f,a),p.schema=o(p.schema,e.schema));let m;if(s(u))try{let e=await i(u,a);m=r(e)?await l(p,e.source,a).then(e=>e.source):e}catch{}return m||=u,{schema:p,source:m,meta:c(p,d)}}export{l as createSource,c as extractSourceMeta};
+//# sourceMappingURL=create.mjs.map

package/dist/source/create.mjs.map

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

package/dist/source/define.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./helpers.cjs");function t(t){return e.isSourceInputObject(t)?t:{source:t}}exports.defineSource=t;

package/dist/source/define.d.cts

@@ -0,0 +1,2 @@
+import { t as defineSource } from "../define-aWeW6VVo.cjs";
+export { defineSource };

package/dist/source/define.d.mts

@@ -0,0 +1,2 @@
+import { t as defineSource } from "../define-Dw8JgVQ1.mjs";
+export { defineSource };

package/dist/source/define.mjs

@@ -0,0 +1,2 @@
+import{isSourceInputObject as e}from"./helpers.mjs";function t(t){return e(t)?t:{source:t}}export{t as defineSource};
+//# sourceMappingURL=define.mjs.map

package/dist/source/define.mjs.map

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

package/dist/source/helpers.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@stryke/type-checks/is-set-object");function t(t){return(0,e.isSetObject)(t)&&`source`in t&&t.source!==void 0}exports.isSourceInputObject=t;

package/dist/source/helpers.d.cts

@@ -0,0 +1,13 @@
+import { a as SourceInputObject } from "../source-txi0ZuzR.cjs";
+
+//#region src/source/helpers.d.ts
+/**
+ * Checks if the provided input is a {@link SourceInputObject}.
+ *
+ * @param input - The input to check.
+ * @returns True if the input is a {@link SourceInputObject}, false otherwise.
+ */
+declare function isSourceInputObject<TSpec, TOptions extends object>(input: unknown): input is SourceInputObject<TSpec, TOptions>;
+//#endregion
+export { isSourceInputObject };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/source/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/source/helpers.ts"],"mappings":";;;;;AA2BA;;;;iBAAgB,mBAAA,iCACd,KAAA,YACC,KAAA,IAAS,iBAAA,CAAkB,KAAA,EAAO,QAAA"}

package/dist/source/helpers.d.mts

@@ -0,0 +1,13 @@
+import { a as SourceInputObject } from "../source-BiOs3_-8.mjs";
+
+//#region src/source/helpers.d.ts
+/**
+ * Checks if the provided input is a {@link SourceInputObject}.
+ *
+ * @param input - The input to check.
+ * @returns True if the input is a {@link SourceInputObject}, false otherwise.
+ */
+declare function isSourceInputObject<TSpec, TOptions extends object>(input: unknown): input is SourceInputObject<TSpec, TOptions>;
+//#endregion
+export { isSourceInputObject };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/source/helpers.d.mts.map

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

package/dist/source/helpers.mjs

@@ -0,0 +1,2 @@
+import{isSetObject as e}from"@stryke/type-checks/is-set-object";function t(t){return e(t)&&`source`in t&&t.source!==void 0}export{t as isSourceInputObject};
+//# sourceMappingURL=helpers.mjs.map

package/dist/source/helpers.mjs.map

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

package/dist/source/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../extract-FkKA9g1K.cjs");exports.VALID_SOURCE_FILE_EXTENSIONS=e.n,exports.extractSource=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./create.cjs"),t=require("./define.cjs");exports.createSource=e.createSource,exports.defineSource=t.defineSource,exports.extractSourceMeta=e.extractSourceMeta;

package/dist/source/index.d.cts

@@ -1,16 +1,3 @@
-import { a as SourceMeta, i as SourceInputWithMeta, n as SourceFunction, o as SourceValue, r as SourceInput, t as Source } from "../types-DJo-IRmS.cjs";
-import { SchemaOf } from "@power-plant/schema/types";
-import { ResolveOptions } from "@power-plant/schema/resolve";
-
-//#region src/source/constants.d.ts
-declare const VALID_SOURCE_FILE_EXTENSIONS: string[];
-//#endregion
-//#region src/source/extract.d.ts
-type SourceResolvedInput<TSpec, TOptions = never> = TSpec | Promise<TSpec> | SourceFunction<TSpec, TOptions>;
-/**
- * Normalizes any accepted source input into a concrete source descriptor.
- */
-declare function extractSource<TSpec, TOptions = never>(schema: SchemaOf<TSpec>, input: SourceInput<TSpec, TOptions>, options?: ResolveOptions): Promise<Source<TSpec, TOptions>>;
-//#endregion
-export { type Source, type SourceFunction, type SourceInput, type SourceInputWithMeta, type SourceMeta, SourceResolvedInput, type SourceValue, VALID_SOURCE_FILE_EXTENSIONS, extractSource };
-//# sourceMappingURL=index.d.cts.map
+import { n as extractSourceMeta, t as createSource } from "../create-DUt-efk7.cjs";
+import { t as defineSource } from "../define-aWeW6VVo.cjs";
+export { createSource, defineSource, extractSourceMeta };

package/dist/source/index.d.mts

@@ -1,16 +1,3 @@
-import { a as SourceMeta, i as SourceInputWithMeta, n as SourceFunction, o as SourceValue, r as SourceInput, t as Source } from "../types-DJo-IRmS.mjs";
-import { ResolveOptions } from "@power-plant/schema/resolve";
-import { SchemaOf } from "@power-plant/schema/types";
-
-//#region src/source/constants.d.ts
-declare const VALID_SOURCE_FILE_EXTENSIONS: string[];
-//#endregion
-//#region src/source/extract.d.ts
-type SourceResolvedInput<TSpec, TOptions = never> = TSpec | Promise<TSpec> | SourceFunction<TSpec, TOptions>;
-/**
- * Normalizes any accepted source input into a concrete source descriptor.
- */
-declare function extractSource<TSpec, TOptions = never>(schema: SchemaOf<TSpec>, input: SourceInput<TSpec, TOptions>, options?: ResolveOptions): Promise<Source<TSpec, TOptions>>;
-//#endregion
-export { type Source, type SourceFunction, type SourceInput, type SourceInputWithMeta, type SourceMeta, SourceResolvedInput, type SourceValue, VALID_SOURCE_FILE_EXTENSIONS, extractSource };
-//# sourceMappingURL=index.d.mts.map
+import { n as extractSourceMeta, t as createSource } from "../create-Qxy2mq7r.mjs";
+import { t as defineSource } from "../define-Dw8JgVQ1.mjs";
+export { createSource, defineSource, extractSourceMeta };

package/dist/source/index.mjs

@@ -1 +1 @@
-import{n as e,t}from"../extract-BzZLelb2.mjs";export{e as VALID_SOURCE_FILE_EXTENSIONS,t as extractSource};
+import{createSource as e,extractSourceMeta as t}from"./create.mjs";import{defineSource as n}from"./define.mjs";export{e as createSource,n as defineSource,t as extractSourceMeta};

package/dist/source-BiOs3_-8.d.mts

@@ -0,0 +1,57 @@
+import { c as Meta, p as MaybePromise, r as SchemaInputObject, s as SchemaOf, u as MetaInput } from "./schema-xFkmOyE6.mjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { SchemaEnvelopeOf, SchemaSourceInput } from "@power-plant/schema/types";
+
+//#region src/types/source.d.ts
+type SourceFunction<TSpec, TOptions extends object> = (options: TOptions) => MaybePromise<TSpec>;
+interface SourceMetaInput<TSpec, TOptions extends object> extends MetaInput<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted/generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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 SourceMeta<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 source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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 SourceInputObject<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?: SchemaSourceInput<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaInputObject<TSpec, TOptions>;
+  /**
+   * The source implementation, either as a callable function, a static value, or a file reference.
+   */
+  source: TSpec | SourceFunction<TSpec, TOptions> | LoadInput;
+  /**
+   * Optional metadata that provides contextual information for the source.
+   */
+  meta?: SourceMetaInput<TSpec, TOptions>;
+}
+type SourceInput<TSpec, TOptions extends object> = LoadInput | TSpec | SourceFunction<TSpec, TOptions> | SourceInputObject<TSpec, TOptions>;
+type InferCreateSourceOptions<T extends SourceInput<any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Source<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 source.
+   */
+  meta?: SourceMeta<TSpec, TOptions>;
+  /**
+   * The source 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 `source` 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.
+   */
+  source: TSpec | SourceFunction<TSpec, TOptions>;
+}
+//#endregion
+export { SourceInputObject as a, SourceInput as i, Source as n, SourceMeta as o, SourceFunction as r, SourceMetaInput as s, InferCreateSourceOptions as t };
+//# sourceMappingURL=source-BiOs3_-8.d.mts.map

package/dist/source-BiOs3_-8.d.mts.map

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

package/dist/source-txi0ZuzR.d.cts

@@ -0,0 +1,57 @@
+import { c as Meta, p as MaybePromise, r as SchemaInputObject, s as SchemaOf, u as MetaInput } from "./schema-xFkmOyE6.cjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { SchemaEnvelopeOf, SchemaSourceInput } from "@power-plant/schema/types";
+
+//#region src/types/source.d.ts
+type SourceFunction<TSpec, TOptions extends object> = (options: TOptions) => MaybePromise<TSpec>;
+interface SourceMetaInput<TSpec, TOptions extends object> extends MetaInput<TSpec, TOptions> {
+  /**
+   * A string that describes how the specification will be extracted/generated. This property can provide context about the source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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 SourceMeta<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 source of the specification, such as whether it is derived from a file, a database, an API, or any other source. 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 SourceInputObject<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?: SchemaSourceInput<TSpec> | SchemaEnvelopeOf<TSpec> | SchemaInputObject<TSpec, TOptions>;
+  /**
+   * The source implementation, either as a callable function, a static value, or a file reference.
+   */
+  source: TSpec | SourceFunction<TSpec, TOptions> | LoadInput;
+  /**
+   * Optional metadata that provides contextual information for the source.
+   */
+  meta?: SourceMetaInput<TSpec, TOptions>;
+}
+type SourceInput<TSpec, TOptions extends object> = LoadInput | TSpec | SourceFunction<TSpec, TOptions> | SourceInputObject<TSpec, TOptions>;
+type InferCreateSourceOptions<T extends SourceInput<any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Source<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 source.
+   */
+  meta?: SourceMeta<TSpec, TOptions>;
+  /**
+   * The source 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 `source` 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.
+   */
+  source: TSpec | SourceFunction<TSpec, TOptions>;
+}
+//#endregion
+export { SourceInputObject as a, SourceInput as i, Source as n, SourceMeta as o, SourceFunction as r, SourceMetaInput as s, InferCreateSourceOptions as t };
+//# sourceMappingURL=source-txi0ZuzR.d.cts.map

package/dist/source-txi0ZuzR.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-txi0ZuzR.d.cts","names":[],"sources":["../src/types/source.ts"],"mappings":";;;;;KA2BY,cAAA,oCACV,OAAA,EAAS,QAAA,KACN,YAAA,CAAa,KAAA;AAAA,UAED,eAAA,yCAGP,SAAA,CAAU,KAAA,EAAO,QAAA;EAPD;;;EAWxB,KAAA;AAAA;AAAA,UAGe,UAAA,yCAAmD,IAAA,CAClE,KAAA,EACA,QAAA;EAhByB;;;EAqBzB,KAAA;AAAA;AAAA,UAGe,iBAAA;EAtBM;AAAA;AAEvB;EAwBE,MAAA,GACI,iBAAA,CAAkB,KAAA,IAClB,gBAAA,CAAiB,KAAA,IACjB,iBAAA,CAAkB,KAAA,EAAO,QAAA;EA3BC;;;EAgC9B,MAAA,EAAQ,KAAA,GAAQ,cAAA,CAAe,KAAA,EAAO,QAAA,IAAY,SAAA;EA7BjC;;;EAkCjB,IAAA,GAAO,eAAA,CAAgB,KAAA,EAAO,QAAA;AAAA;AAAA,KAGpB,WAAA,mCACR,SAAA,GACA,KAAA,GACA,cAAA,CAAe,KAAA,EAAO,QAAA,IACtB,iBAAA,CAAkB,KAAA,EAAO,QAAA;AAAA,KAEjB,wBAAA,WAAmC,WAAA,cAC7C,CAAA,SAAU,SAAA,GACN,gBAAA,CAAiB,CAAA;AAAA,UAIN,MAAA;EA7CV;AAAA;AAGP;EA8CE,MAAA,EAAQ,QAAA,CAAS,KAAA,EAAO,QAAA;EA9CC;;;EAmDzB,IAAA,GAAO,UAAA,CAAW,KAAA,EAAO,QAAA;EAnD6C;;;;;;;;;EA8DtE,MAAA,EAAQ,KAAA,GAAQ,cAAA,CAAe,KAAA,EAAO,QAAA;AAAA"}