@power-plant/core 0.0.2 → 0.0.3

package/dist/generator/index.d.mts

@@ -1,20 +1,2 @@
-import { n as GeneratorInput, t as Generator } from "../generator-DZI01B4_.mjs";
-import { ExtractOptions } from "@power-plant/schema/extract";
-
-//#region src/generator/generator.d.ts
-/**
- * Creates a generator from raw schema/source/sink inputs and resolves all descriptors.
- *
- * @remarks
- * This function is used to create a generator from raw schema, source, and sink inputs. It resolves all descriptors and returns a fully constructed generator that can be used to generate output based on the provided schema and options.
- *
- * @template TSpec - The type of the specification that the generator will produce.
- * @template TOptions - The type of the options that will be passed to the generator during generation.
- * @param input - The generator input containing schema, source, sink, and optional meta information.
- * @param options - Optional extraction options for schema, source, and sink.
- * @returns A promise that resolves to a fully constructed generator.
- */
-declare function createGenerator<TSpec, TOptions = any>(input: GeneratorInput<TSpec, TOptions>, options?: ExtractOptions): Promise<Generator<TSpec, TOptions>>;
-//#endregion
-export { createGenerator };
-//# sourceMappingURL=index.d.mts.map
+import { t as createGenerator } from "../create-DVpg-3po.mjs";
+export { createGenerator };

package/dist/generator/index.mjs

@@ -1,2 +1 @@
-import{t as e}from"../extract-ZIpZAKsq.mjs";import{t}from"../extract-BzZLelb2.mjs";import{extract as n}from"@power-plant/schema/extract";import{isFunction as r}from"@stryke/type-checks/is-function";async function i(i,a){let o=await n(i.schema,a),[s,c]=await Promise.all([t(o,i.source,a),e(o,i.sink,a)]);return{meta:i.meta,schema:o,source:s,sink:c,generate:async e=>{let t=r(s.source)?await s.source(e):s.source,n=typeof i.meta?.description==`function`?i.meta.description(t):i.meta?.description;n&&console.log(`Generating ${n}...`),await c.sink(t,e)}}}export{i as createGenerator};
-//# sourceMappingURL=index.mjs.map
+import{createGenerator as e}from"./create.mjs";export{e as createGenerator};

package/dist/{generator-C5O_C4RV.d.cts → generator-C1_Q-QAb.d.cts}

@@ -1,19 +1,20 @@
-import { r as SinkInput, t as Sink } from "./types-B2MtSxCp.cjs";
-import { r as SourceInput, t as Source } from "./types-DJo-IRmS.cjs";
+import { i as SinkInput, n as Sink } from "./sink-CTx7UtqU.cjs";
+import { i as SourceInput, n as Source } from "./source-B3tctCZE.cjs";
 import { SchemaInput, SchemaOf } from "@power-plant/schema";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
 
 //#region src/types/generator.d.ts
-interface GeneratorMeta<TSpec> {
+interface GeneratorMeta<TSpec, TOptions extends object> {
   /**
    * A string description (or a function that returns a string) outlining the purpose or behavior of the generator.
    */
   description?: string | ((spec: TSpec) => string);
 }
-interface GeneratorInput<TSpec, TOptions = never> {
+interface GeneratorInputObject<TSpec, TOptions extends object, TReturns = void> {
   /**
    * Optional metadata about the generator, such as a description of the output it produces.
    */
-  meta?: GeneratorMeta<TSpec>;
+  meta?: GeneratorMeta<TSpec, TOptions>;
   /**
    * The schema input that defines the structure of the specification object for this generator.
    */
@@ -25,13 +26,15 @@ interface GeneratorInput<TSpec, TOptions = never> {
   /**
    * The sink input that consumes generated output.
    */
-  sink: SinkInput<TSpec, TOptions>;
+  sink: SinkInput<TSpec, TOptions, TReturns>;
 }
-interface Generator<TSpec, TOptions = never> {
+type GeneratorInput<TSpec, TOptions extends object, TReturns = void> = LoadInput | GeneratorInputObject<TSpec, TOptions, TReturns>;
+type InferCreateGeneratorOptions<T extends GeneratorInput<any, any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Generator<TSpec, TOptions extends object, TReturns = void> {
   /**
    * Optional metadata about the generator, such as a description of the output it produces.
    */
-  meta?: GeneratorMeta<TSpec>;
+  meta?: GeneratorMeta<TSpec, TOptions>;
   /**
    * The schema input that defines the structure of the specification object for this generator.
    */
@@ -43,15 +46,15 @@ interface Generator<TSpec, TOptions = never> {
   /**
    * 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.
    */
-  sink: Sink<TSpec, TOptions>;
+  sink: Sink<TSpec, TOptions, TReturns>;
   /**
    * The generate function that executes the generator logic, taking in options and producing output based on the source and sink definitions.
    *
    * @param options - The options to be passed to the generator, which can be used to influence the generation process.
    * @returns A promise that resolves when the generation process is complete.
    */
-  generate: (options: TOptions) => Promise<void>;
+  generate: (options: TOptions) => Promise<TReturns>;
 }
 //#endregion
-export { GeneratorInput as n, GeneratorMeta as r, Generator as t };
-//# sourceMappingURL=generator-C5O_C4RV.d.cts.map
+export { InferCreateGeneratorOptions as a, GeneratorMeta as i, GeneratorInput as n, GeneratorInputObject as r, Generator as t };
+//# sourceMappingURL=generator-C1_Q-QAb.d.cts.map

package/dist/generator-C1_Q-QAb.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-C1_Q-QAb.d.cts","names":[],"sources":["../src/types/generator.ts"],"mappings":";;;;;;UAwBiB,aAAA;;AAAjB;;EAIE,WAAA,cAAyB,IAAA,EAAM,KAAK;AAAA;AAAA,UAGrB,oBAAA;EAPqB;;;EAepC,IAAA,GAAO,aAAA,CAAc,KAAA,EAAO,QAAA;EAXQ;AAAA;AAGtC;EAaE,MAAA,EAAQ,WAAA,CAAY,KAAA;EAbe;;;EAkBnC,MAAA,EAAQ,WAAA,CAAY,KAAA,EAAO,QAAA;EALP;;;EAUpB,IAAA,EAAM,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA;AAAA,KAGvB,cAAA,oDACR,SAAA,GACA,oBAAA,CAAqB,KAAA,EAAO,QAAA,EAAU,QAAA;AAAA,KAE9B,2BAAA,WACA,cAAA,mBACR,CAAA,SAAU,SAAA,GACV,gBAAA,CAAiB,CAAA;AAAA,UAIJ,SAAA;EAdT;;;EAkBN,IAAA,GAAO,aAAA,CAAc,KAAA,EAAO,QAAA;EAvC5B;;;EA4CA,MAAA,EAAQ,QAAA,CAAS,KAAA;EAtCI;;;EA2CrB,MAAA,EAAQ,MAAA,CAAO,KAAA,EAAO,QAAA;EAtCF;;;EA2CpB,IAAA,EAAM,IAAA,CAAK,KAAA,EAAO,QAAA,EAAU,QAAA;EAtCD;;;;;;EA8C3B,QAAA,GAAW,OAAA,EAAS,QAAA,KAAa,OAAA,CAAQ,QAAA;AAAA"}

package/dist/{generator-DZI01B4_.d.mts → generator-MC25UERM.d.mts}

@@ -1,19 +1,20 @@
-import { r as SinkInput, t as Sink } from "./types-B2MtSxCp.mjs";
-import { r as SourceInput, t as Source } from "./types-DJo-IRmS.mjs";
+import { i as SinkInput, n as Sink } from "./sink-CAWlC7am.mjs";
+import { i as SourceInput, n as Source } from "./source-DjKhYXZ6.mjs";
 import { SchemaInput, SchemaOf } from "@power-plant/schema";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
 
 //#region src/types/generator.d.ts
-interface GeneratorMeta<TSpec> {
+interface GeneratorMeta<TSpec, TOptions extends object> {
   /**
    * A string description (or a function that returns a string) outlining the purpose or behavior of the generator.
    */
   description?: string | ((spec: TSpec) => string);
 }
-interface GeneratorInput<TSpec, TOptions = never> {
+interface GeneratorInputObject<TSpec, TOptions extends object, TReturns = void> {
   /**
    * Optional metadata about the generator, such as a description of the output it produces.
    */
-  meta?: GeneratorMeta<TSpec>;
+  meta?: GeneratorMeta<TSpec, TOptions>;
   /**
    * The schema input that defines the structure of the specification object for this generator.
    */
@@ -25,13 +26,15 @@ interface GeneratorInput<TSpec, TOptions = never> {
   /**
    * The sink input that consumes generated output.
    */
-  sink: SinkInput<TSpec, TOptions>;
+  sink: SinkInput<TSpec, TOptions, TReturns>;
 }
-interface Generator<TSpec, TOptions = never> {
+type GeneratorInput<TSpec, TOptions extends object, TReturns = void> = LoadInput | GeneratorInputObject<TSpec, TOptions, TReturns>;
+type InferCreateGeneratorOptions<T extends GeneratorInput<any, any, any>> = T extends LoadInput ? InferLoadOptions<T> : {};
+interface Generator<TSpec, TOptions extends object, TReturns = void> {
   /**
    * Optional metadata about the generator, such as a description of the output it produces.
    */
-  meta?: GeneratorMeta<TSpec>;
+  meta?: GeneratorMeta<TSpec, TOptions>;
   /**
    * The schema input that defines the structure of the specification object for this generator.
    */
@@ -43,15 +46,15 @@ interface Generator<TSpec, TOptions = never> {
   /**
    * 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.
    */
-  sink: Sink<TSpec, TOptions>;
+  sink: Sink<TSpec, TOptions, TReturns>;
   /**
    * The generate function that executes the generator logic, taking in options and producing output based on the source and sink definitions.
    *
    * @param options - The options to be passed to the generator, which can be used to influence the generation process.
    * @returns A promise that resolves when the generation process is complete.
    */
-  generate: (options: TOptions) => Promise<void>;
+  generate: (options: TOptions) => Promise<TReturns>;
 }
 //#endregion
-export { GeneratorInput as n, GeneratorMeta as r, Generator as t };
-//# sourceMappingURL=generator-DZI01B4_.d.mts.map
+export { InferCreateGeneratorOptions as a, GeneratorMeta as i, GeneratorInput as n, GeneratorInputObject as r, Generator as t };
+//# sourceMappingURL=generator-MC25UERM.d.mts.map

package/dist/generator-MC25UERM.d.mts.map

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

package/dist/index-BVVgDSdq.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/index-BVVgDSdq.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require("./config.cjs");const e=require("./extract-DUwG1ZUO.cjs"),t=require("./extract-FkKA9g1K.cjs"),n=require("./generator/index.cjs");require("./sink/index.cjs"),require("./source/index.cjs"),exports.VALID_SINK_FILE_EXTENSIONS=e.n,exports.VALID_SOURCE_FILE_EXTENSIONS=t.n,exports.createGenerator=n.createGenerator,exports.extractSink=e.t,exports.extractSource=t.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./sink/create.cjs"),t=require("./source/create.cjs"),n=require("./generator/create.cjs");require("./generator/index.cjs"),require("./sink/index.cjs");const r=require("./source/define.cjs");require("./source/index.cjs"),exports.createGenerator=n.createGenerator,exports.createSink=e.createSink,exports.createSource=t.createSource,exports.defineSource=r.defineSource,exports.extractSinkMeta=e.extractSinkMeta,exports.extractSourceMeta=t.extractSourceMeta;

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { a as SinkMeta, i as SinkInputWithMeta, n as SinkFunction, r as SinkInput, t as Sink } from "./types-B2MtSxCp.cjs";
-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 { n as GeneratorInput, r as GeneratorMeta, t as Generator } from "./generator-C5O_C4RV.cjs";
-import { UserConfig } from "./config.cjs";
-import { createGenerator } from "./generator/index.cjs";
-import { VALID_SINK_FILE_EXTENSIONS, extractSink } from "./sink/index.cjs";
-import { SourceResolvedInput, VALID_SOURCE_FILE_EXTENSIONS, extractSource } from "./source/index.cjs";
-export { type Generator, type GeneratorInput, type GeneratorMeta, type Sink, type SinkFunction, type SinkInput, type SinkInputWithMeta, type SinkMeta, type Source, type SourceFunction, type SourceInput, type SourceInputWithMeta, type SourceMeta, SourceResolvedInput, type SourceValue, type UserConfig, VALID_SINK_FILE_EXTENSIONS, VALID_SOURCE_FILE_EXTENSIONS, createGenerator, extractSink, extractSource };
+import { a as SinkInputObject, i as SinkInput, n as Sink, o as SinkMeta, r as SinkFunction, s as SinkMetaInput, t as InferCreateSinkOptions } from "./sink-CTx7UtqU.cjs";
+import { a as SourceInputObject, i as SourceInput, n as Source, o as SourceMeta, r as SourceFunction, s as SourceMetaInput, t as InferCreateSourceOptions } from "./source-B3tctCZE.cjs";
+import { a as InferCreateGeneratorOptions, i as GeneratorMeta, n as GeneratorInput, r as GeneratorInputObject, t as Generator } from "./generator-C1_Q-QAb.cjs";
+import { t as createGenerator } from "./create-Cfgth9sz.cjs";
+import { n as extractSinkMeta, t as createSink } from "./create-D32Jusq_.cjs";
+import { n as extractSourceMeta, t as createSource } from "./create-DoyLue8r.cjs";
+import { t as defineSource } from "./define-DEe-HPar.cjs";
+export { type Generator, type GeneratorInput, type GeneratorInputObject, type GeneratorMeta, type InferCreateGeneratorOptions, type InferCreateSinkOptions, type InferCreateSourceOptions, type Sink, type SinkFunction, type SinkInput, type SinkInputObject, type SinkMeta, type SinkMetaInput, type Source, type SourceFunction, type SourceInput, type SourceInputObject, type SourceMeta, type SourceMetaInput, createGenerator, createSink, createSource, defineSource, extractSinkMeta, extractSourceMeta };

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { a as SinkMeta, i as SinkInputWithMeta, n as SinkFunction, r as SinkInput, t as Sink } from "./types-B2MtSxCp.mjs";
-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 { n as GeneratorInput, r as GeneratorMeta, t as Generator } from "./generator-DZI01B4_.mjs";
-import { UserConfig } from "./config.mjs";
-import { createGenerator } from "./generator/index.mjs";
-import { VALID_SINK_FILE_EXTENSIONS, extractSink } from "./sink/index.mjs";
-import { SourceResolvedInput, VALID_SOURCE_FILE_EXTENSIONS, extractSource } from "./source/index.mjs";
-export { type Generator, type GeneratorInput, type GeneratorMeta, type Sink, type SinkFunction, type SinkInput, type SinkInputWithMeta, type SinkMeta, type Source, type SourceFunction, type SourceInput, type SourceInputWithMeta, type SourceMeta, SourceResolvedInput, type SourceValue, type UserConfig, VALID_SINK_FILE_EXTENSIONS, VALID_SOURCE_FILE_EXTENSIONS, createGenerator, extractSink, extractSource };
+import { a as SinkInputObject, i as SinkInput, n as Sink, o as SinkMeta, r as SinkFunction, s as SinkMetaInput, t as InferCreateSinkOptions } from "./sink-CAWlC7am.mjs";
+import { a as SourceInputObject, i as SourceInput, n as Source, o as SourceMeta, r as SourceFunction, s as SourceMetaInput, t as InferCreateSourceOptions } from "./source-DjKhYXZ6.mjs";
+import { a as InferCreateGeneratorOptions, i as GeneratorMeta, n as GeneratorInput, r as GeneratorInputObject, t as Generator } from "./generator-MC25UERM.mjs";
+import { t as createGenerator } from "./create-DVpg-3po.mjs";
+import { n as extractSinkMeta, t as createSink } from "./create-B14Jt6Iu.mjs";
+import { n as extractSourceMeta, t as createSource } from "./create-vgEDsShD.mjs";
+import { t as defineSource } from "./define-RneysDu1.mjs";
+export { type Generator, type GeneratorInput, type GeneratorInputObject, type GeneratorMeta, type InferCreateGeneratorOptions, type InferCreateSinkOptions, type InferCreateSourceOptions, type Sink, type SinkFunction, type SinkInput, type SinkInputObject, type SinkMeta, type SinkMetaInput, type Source, type SourceFunction, type SourceInput, type SourceInputObject, type SourceMeta, type SourceMetaInput, createGenerator, createSink, createSource, defineSource, extractSinkMeta, extractSourceMeta };

package/dist/index.mjs

@@ -1 +1 @@
-import"./config.mjs";import{n as e,t}from"./extract-ZIpZAKsq.mjs";import{n,t as r}from"./extract-BzZLelb2.mjs";import{createGenerator as i}from"./generator/index.mjs";import"./sink/index.mjs";import"./source/index.mjs";export{e as VALID_SINK_FILE_EXTENSIONS,n as VALID_SOURCE_FILE_EXTENSIONS,i as createGenerator,t as extractSink,r as extractSource};
+import{createSink as e,extractSinkMeta as t}from"./sink/create.mjs";import{createSource as n,extractSourceMeta as r}from"./source/create.mjs";import{createGenerator as i}from"./generator/create.mjs";import"./generator/index.mjs";import"./sink/index.mjs";import{defineSource as a}from"./source/define.mjs";import"./source/index.mjs";export{i as createGenerator,e as createSink,n as createSource,a as defineSource,t as extractSinkMeta,r as extractSourceMeta};

package/dist/metadata-Cb6iMZqW.cjs

@@ -0,0 +1 @@
+let e=require("@power-plant/schema/metadata");function t(t,n){let r=t??{schema:{}},i=r?.meta??{};return i.name=(0,e.resolveMetaName)(r?.schema,i,n?.name),i.version=(0,e.resolveMetaVersion)(r?.schema,i,n?.version),i.id=(0,e.resolveMetaId)(r?.schema,i),i.displayName=(0,e.resolveMetaDisplayName)(r?.schema,i,n?.displayName),i.links=(0,e.resolveMetaLinks)(r?.schema,i,n?.links),n?.deprecated&&(i.deprecated=n?.deprecated),n?.usage&&(i.usage=n?.usage),n?.tags&&(i.tags=n?.tags),i}Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/dist/metadata-Dmhrb3Kv.mjs

@@ -0,0 +1,2 @@
+import{resolveMetaDisplayName as e,resolveMetaId as t,resolveMetaLinks as n,resolveMetaName as r,resolveMetaVersion as i}from"@power-plant/schema/metadata";function a(a,o){let s=a??{schema:{}},c=s?.meta??{};return c.name=r(s?.schema,c,o?.name),c.version=i(s?.schema,c,o?.version),c.id=t(s?.schema,c),c.displayName=e(s?.schema,c,o?.displayName),c.links=n(s?.schema,c,o?.links),o?.deprecated&&(c.deprecated=o?.deprecated),o?.usage&&(c.usage=o?.usage),o?.tags&&(c.tags=o?.tags),c}export{a as t};
+//# sourceMappingURL=metadata-Dmhrb3Kv.mjs.map

package/dist/metadata-Dmhrb3Kv.mjs.map

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

package/dist/sink/create.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../metadata-Cb6iMZqW.cjs"),t=require("./helpers.cjs");let n=require("@power-plant/schema/extract"),r=require("@stryke/resolve/load"),i=require("@power-plant/schema/helpers"),a=require("@power-plant/schema/metadata"),o=require("@stryke/resolve/type-checks");function s(t,n){let r=e.t(t,n);return r.description=(0,a.resolveMetaDescription)(`Accepts a ${t?.meta?.displayName?`${t?.meta?.displayName} `:``}specification and processes it with a {displayName} sink.`,t?.schema??{},r,n?.description),r}async function c(e,a,l={}){let{sink:u,meta:d,schema:f}=t.isSinkInputObject(a)?a:{sink:a,meta:{}},p=e;f&&(p=await(0,n.extract)(f,l),p.schema=(0,i.mergeMetadata)(p.schema,e.schema));let m;if((0,o.isLoadInput)(u))try{let e=await(0,r.load)(u,l);m=t.isSinkInputObject(e)?await c(p,e.sink,l).then(e=>e.sink):e}catch{}return m||=u,{schema:p,sink:m,meta:s(p,d)}}exports.createSink=c,exports.extractSinkMeta=s;

package/dist/sink/create.d.cts

@@ -0,0 +1,2 @@
+import { n as extractSinkMeta, t as createSink } from "../create-D32Jusq_.cjs";
+export { createSink, extractSinkMeta };

package/dist/sink/create.d.mts

@@ -0,0 +1,2 @@
+import { n as extractSinkMeta, t as createSink } from "../create-B14Jt6Iu.mjs";
+export { createSink, extractSinkMeta };

package/dist/sink/create.mjs

@@ -0,0 +1,2 @@
+import{t as e}from"../metadata-Dmhrb3Kv.mjs";import{isSinkInputObject as t}from"./helpers.mjs";import{extract as n}from"@power-plant/schema/extract";import{load as r}from"@stryke/resolve/load";import{mergeMetadata as i}from"@power-plant/schema/helpers";import{resolveMetaDescription as a}from"@power-plant/schema/metadata";import{isLoadInput as o}from"@stryke/resolve/type-checks";function s(t,n){let r=e(t,n);return r.description=a(`Accepts a ${t?.meta?.displayName?`${t?.meta?.displayName} `:``}specification and processes it with a {displayName} sink.`,t?.schema??{},r,n?.description),r}async function c(e,a,l={}){let{sink:u,meta:d,schema:f}=t(a)?a:{sink:a,meta:{}},p=e;f&&(p=await n(f,l),p.schema=i(p.schema,e.schema));let m;if(o(u))try{let e=await r(u,l);m=t(e)?await c(p,e.sink,l).then(e=>e.sink):e}catch{}return m||=u,{schema:p,sink:m,meta:s(p,d)}}export{c as createSink,s as extractSinkMeta};
+//# sourceMappingURL=create.mjs.map

package/dist/sink/create.mjs.map

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

package/dist/sink/define.cjs

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

package/dist/sink/define.d.cts

@@ -0,0 +1,37 @@
+import { a as SinkInputObject, i as SinkInput } from "../sink-CTx7UtqU.cjs";
+//#region src/sink/define.d.ts
+/**
+ * Defines a sink input object. If the provided sink is already a sink input object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `sink` property.
+ *
+ * @example
+ * ```ts
+ * import { defineSink } from "@power-plant/core";
+ *
+ * // Define a sink from a sink function
+ * export default defineSink((spec, options) => {
+ *   // Your sink logic here
+ * });
+ *
+ * // Define a sink from an existing sink input object
+ * export default defineSink({
+ *  meta: {
+ *     name: "My Sink",
+ *     version: "1.0.0",
+ *     description: "A sink that does something.",
+ *   },
+ *   schema: z.object({
+ *     // Your schema definition here
+ *   }),
+ *   sink: (spec, options) => {
+ *     // Your sink logic here
+ *   },
+ * });
+ * ```
+ *
+ * @param sink - The sink input to define. This can be either a sink input object or a sink function.
+ * @returns A sink input object that contains the provided sink. If the input was already a sink input object, it will be returned unchanged.
+ */
+declare function defineSink<TSpec, TOptions extends object, TReturns = void>(sink: SinkInput<TSpec, TOptions, TReturns>): SinkInputObject<TSpec, TOptions, TReturns>;
+//#endregion
+export { defineSink };
+//# sourceMappingURL=define.d.cts.map

package/dist/sink/define.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.cts","names":[],"sources":["../../src/sink/define.ts"],"mappings":";;;;;AAoDA;;;;;;;;;;;;;;;;;;;;;;;;;;AAE4C;;iBAF5B,UAAA,kDACd,IAAA,EAAM,SAAA,CAAU,KAAA,EAAO,QAAA,EAAU,QAAA,IAChC,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,QAAA"}

package/dist/sink/define.d.mts

@@ -0,0 +1,37 @@
+import { a as SinkInputObject, i as SinkInput } from "../sink-CAWlC7am.mjs";
+//#region src/sink/define.d.ts
+/**
+ * Defines a sink input object. If the provided sink is already a sink input object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `sink` property.
+ *
+ * @example
+ * ```ts
+ * import { defineSink } from "@power-plant/core";
+ *
+ * // Define a sink from a sink function
+ * export default defineSink((spec, options) => {
+ *   // Your sink logic here
+ * });
+ *
+ * // Define a sink from an existing sink input object
+ * export default defineSink({
+ *  meta: {
+ *     name: "My Sink",
+ *     version: "1.0.0",
+ *     description: "A sink that does something.",
+ *   },
+ *   schema: z.object({
+ *     // Your schema definition here
+ *   }),
+ *   sink: (spec, options) => {
+ *     // Your sink logic here
+ *   },
+ * });
+ * ```
+ *
+ * @param sink - The sink input to define. This can be either a sink input object or a sink function.
+ * @returns A sink input object that contains the provided sink. If the input was already a sink input object, it will be returned unchanged.
+ */
+declare function defineSink<TSpec, TOptions extends object, TReturns = void>(sink: SinkInput<TSpec, TOptions, TReturns>): SinkInputObject<TSpec, TOptions, TReturns>;
+//#endregion
+export { defineSink };
+//# sourceMappingURL=define.d.mts.map

package/dist/sink/define.d.mts.map

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

package/dist/sink/define.mjs

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

package/dist/sink/define.mjs.map

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

package/dist/sink/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)&&`sink`in t&&t.sink!==void 0}exports.isSinkInputObject=t;

package/dist/sink/helpers.d.cts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/sink/helpers.ts"],"mappings":";;;;;AA2BA;;;;iBAAgB,iBAAA,kDAId,KAAA,YAAiB,KAAA,IAAS,eAAA,CAAgB,KAAA,EAAO,QAAA,EAAU,QAAA"}

package/dist/sink/helpers.d.mts

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

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

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

package/dist/sink/helpers.mjs

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

package/dist/sink/helpers.mjs.map

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

package/dist/sink/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../extract-DUwG1ZUO.cjs");exports.VALID_SINK_FILE_EXTENSIONS=e.n,exports.extractSink=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./create.cjs");exports.createSink=e.createSink,exports.extractSinkMeta=e.extractSinkMeta;

package/dist/sink/index.d.cts

@@ -1,15 +1,2 @@
-import { a as SinkMeta, i as SinkInputWithMeta, n as SinkFunction, r as SinkInput, t as Sink } from "../types-B2MtSxCp.cjs";
-import { SchemaOf } from "@power-plant/schema/types";
-import { ResolveOptions } from "@power-plant/schema/resolve";
-
-//#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.cts.map
+import { n as extractSinkMeta, t as createSink } from "../create-D32Jusq_.cjs";
+export { createSink, extractSinkMeta };

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-B14Jt6Iu.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-CAWlC7am.d.mts

@@ -0,0 +1,58 @@
+import { t as MaybePromise } from "./base-BKbfgxno.mjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { Meta, MetaInput, SchemaInput, SchemaOf } 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> {
+  /**
+   * 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> {
+  /**
+   * 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?: SchemaInput<TSpec>;
+  /**
+   * 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>;
+  /**
+   * 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-CAWlC7am.d.mts.map

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

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

package/dist/sink-CTx7UtqU.d.cts

@@ -0,0 +1,58 @@
+import { t as MaybePromise } from "./base-BKbfgxno.cjs";
+import { InferLoadOptions, LoadInput } from "@stryke/resolve/types";
+import { Meta, MetaInput, SchemaInput, SchemaOf } 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> {
+  /**
+   * 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> {
+  /**
+   * 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?: SchemaInput<TSpec>;
+  /**
+   * 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>;
+  /**
+   * 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-CTx7UtqU.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sink-CTx7UtqU.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,yCAIP,SAAS,CAAC,KAAA;EATR;;;EAaV,QAAA;AAAA;AAAA,UAIe,QAAA,yCAAiD,IAAI,CAAC,KAAA;EAdlE;;;EAkBH,QAAA;AAAA;AAAA,UAGe,eAAA;EAvBT;;;EA+BN,MAAA,GAAS,WAAA,CAAY,KAAA;EA7BlB;;;EAkCH,IAAA,GAAO,QAAA,CAAS,KAAA,EAAO,QAAA;EAhCR;;;EAqCf,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;EA3Cf;;AAAQ;EA+CR,MAAA,EAAQ,QAAA,CAAS,KAAA;EA3CM;;;EAgDvB,IAAA,GAAO,QAAA,CAAS,KAAA,EAAO,QAAA;EAhDQ;;;;;AAIvB;AAGV;;;;EAqDE,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("../metadata-Cb6iMZqW.cjs"),t=require("./helpers.cjs");let n=require("@power-plant/schema/extract"),r=require("@stryke/resolve/load"),i=require("@power-plant/schema/helpers"),a=require("@power-plant/schema/metadata"),o=require("@stryke/resolve/type-checks");function s(t,n){let r=e.t(t,n);return r.description=(0,a.resolveMetaDescription)(`Determines the ${t?.meta?.displayName?`${t?.meta?.displayName} `:``}specification from a {displayName} source.`,t?.schema??{},r,n?.description),r}async function c(e,a,l={}){let{source:u,meta:d,schema:f}=t.isSourceInputObject(a)?a:{source:a,meta:{}},p=e;f&&(p=await(0,n.extract)(f,l),p.schema=(0,i.mergeMetadata)(p.schema,e.schema));let m;if((0,o.isLoadInput)(u))try{let e=await(0,r.load)(u,l);m=t.isSourceInputObject(e)?await c(p,e.source,l).then(e=>e.source):e}catch{}return m||=u,{schema:p,source:m,meta:s(p,d)}}exports.createSource=c,exports.extractSourceMeta=s;

package/dist/source/create.d.cts

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

package/dist/source/create.d.mts

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

package/dist/source/create.mjs

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

package/dist/source/create.mjs.map

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