@power-plant/core 0.0.92 → 0.0.94

package/README.md

@@ -5,9 +5,9 @@
 
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/power-plant/media/banner-1280x640-dark.gif">
-  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/power-plant/media/banner-1280x640-light.gif">
-<img src="https://public.storm-cdn.com/power-plant/media/banner-1280x640-dark.gif" width="100%" alt="Power Plant" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/power-plant/media/banner-1280x427-dark.gif">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/power-plant/media/banner-1280x427-light.gif">
+<img src="https://public.storm-cdn.com/power-plant/media/banner-1280x427-dark.gif" width="100%" alt="Power Plant" />
 </picture>
 </div>
 <br />
@@ -33,7 +33,7 @@ The Power Plant monorepo is a collection of packages that are designed to work t
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.0.23-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://docs.stormsoftware.com/projects/power-plant)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/power-plant/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.0.93-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://docs.stormsoftware.com/projects/power-plant)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/power-plant/release.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/{config-DS1cj7j6.d.cts → config-CvXMgTtG.d.mts}

@@ -1,8 +1,8 @@
-import { DeepPartial, MaybePromise } from "@stryke/types/base";
+import { EnvPaths } from "@stryke/env/get-env-paths";
 import { Storage } from "unstorage";
 import { BaseExtractOptions, InferExtractOptions, SchemaConfig, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
 import { InferLoadOptions, LoadReference } from "@stryke/resolve/types";
-import { EnvPaths } from "@stryke/env/get-env-paths";
 //#region src/types/meta.d.ts
 type MetaDeprecated = true | string | {
   message?: string;
@@ -164,6 +164,36 @@ interface Input<TSpec, TOptions extends object> {
   input: TSpec | InputFunction<TSpec, TOptions>;
 }
 //#endregion
+//#region src/types/formatter.d.ts
+type FormatterFunction<TSpec, TOptions extends object> = (spec: TSpec, options: TOptions, documents: Record<string, GeneratedDocument>) => MaybePromise<Record<string, GeneratedDocument>>;
+interface FormatterConfigObject<TSpec, TOptions extends object> {
+  /**
+   * Optional metadata that provides contextual information for the formatter.
+   */
+  meta?: MetaConfig;
+  /**
+   * The formatter implementation, either as a callable function or a file reference.
+   */
+  format: FormatterFunction<TSpec, TOptions> | LoadReference;
+}
+type FormatterConfig<TSpec, TOptions extends object> = LoadReference | FormatterFunction<TSpec, TOptions> | FormatterConfigObject<TSpec, TOptions>;
+type InferCreateFormatterOptions<T extends FormatterConfig<any, any>> = (T extends LoadReference ? InferLoadOptions<T> : {}) & BaseExtractOptions;
+interface Formatter<TSpec, TOptions extends object> {
+  /**
+   * Optional metadata that provides contextual information for the formatter.
+   */
+  meta?: MetaConfig;
+  /**
+   * The formatter function, which receives the documents produced by the generator and returns the formatted documents that will be passed to the output.
+   *
+   * @param spec - The specification object used to generate the documents.
+   * @param options - The options used to generate the documents.
+   * @param documents - The generated documents to format.
+   * @returns The formatted documents.
+   */
+  format: FormatterFunction<TSpec, TOptions>;
+}
+//#endregion
 //#region src/types/generator.d.ts
 interface GeneratedDocumentChunk {
   content?: string;
@@ -212,6 +242,10 @@ interface GeneratorConfigObject<TSpec, TOptions extends object, TReturns = void>
    * The output config that consumes generated output.
    */
   output?: OutputConfig<TSpec, TOptions, TReturns>;
+  /**
+   * The formatter config(s) applied, in order, to the generated documents before they are passed to the output.
+   */
+  format?: FormatterConfig<TSpec, TOptions> | FormatterConfig<TSpec, TOptions>[];
   /**
    * The generate implementation, either as a callable function or a file reference.
    */
@@ -236,6 +270,10 @@ interface Generator<TSpec, TOptions extends object, TReturns = void> {
    * The output 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.
    */
   output: Output<TSpec, TOptions, TReturns>;
+  /**
+   * The formatters applied, in order, to the generated documents before they are passed to the output.
+   */
+  formatters: Formatter<TSpec, TOptions>[];
   /**
    * The generator function that executes the generator logic, taking in options and producing output based on the input and output definitions.
    *
@@ -386,5 +424,5 @@ type UserConfigFnPromise<TSpec = any, TOptions extends object = any, TReturns =
 type UserConfigFn<TSpec = any, TOptions extends object = any, TReturns = any> = (params: UserConfigParams) => UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[] | Promise<UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[]>;
 type UserConfigExport<TSpec = any, TOptions extends object = any, TReturns = any> = UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[] | Promise<UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[]> | UserConfigFnObject<TSpec, TOptions, TReturns> | UserConfigFnPromise<TSpec, TOptions, TReturns> | UserConfigFn<TSpec, TOptions, TReturns>;
 //#endregion
-export { InferCreateInputOptions as A, SchemaMetaExample as B, InferGenerator as C, InferMeta as D, InferInputConfig as E, InputMetaConfig as F, MetaLink as G, BaseMetaConfig as H, InferCreateSchemaOptions as I, Schema as L, InputConfig as M, InputConfigObject as N, InferOutputConfig as O, InputFunction as P, SchemaConfigObject as R, InferCreateGeneratorOptions as S, InferGeneratorResult as T, MetaConfig as U, SchemaOf as V, MetaDeprecated as W, GeneratorConfig as _, UserConfigFnPromise as a, GeneratorFunctionResult as b, Settings as c, OutputConfig as d, OutputConfigObject as f, Generator as g, GeneratedDocumentChunk as h, UserConfigFnObject as i, Input as j, InferSchemaConfig as k, InferCreateOutputOptions as l, GeneratedDocument as m, UserConfigExport as n, UserConfigParams as o, OutputFunction as p, UserConfigFn as r, Logger as s, UserConfig as t, Output as u, GeneratorConfigObject as v, InferGeneratorFunction as w, GeneratorResult as x, GeneratorFunction as y, SchemaMetaConfig as z };
-//# sourceMappingURL=config-DS1cj7j6.d.cts.map
+export { Formatter as A, InputMetaConfig as B, InferGenerator as C, InferMeta as D, InferInputConfig as E, InferCreateInputOptions as F, SchemaMetaExample as G, Schema as H, Input as I, MetaConfig as J, SchemaOf as K, InputConfig as L, FormatterConfigObject as M, FormatterFunction as N, InferOutputConfig as O, InferCreateFormatterOptions as P, InputConfigObject as R, InferCreateGeneratorOptions as S, InferGeneratorResult as T, SchemaConfigObject as U, InferCreateSchemaOptions as V, SchemaMetaConfig as W, MetaLink as X, MetaDeprecated as Y, GeneratorConfig as _, UserConfigFnPromise as a, GeneratorFunctionResult as b, Settings as c, OutputConfig as d, OutputConfigObject as f, Generator as g, GeneratedDocumentChunk as h, UserConfigFnObject as i, FormatterConfig as j, InferSchemaConfig as k, InferCreateOutputOptions as l, GeneratedDocument as m, UserConfigExport as n, UserConfigParams as o, OutputFunction as p, BaseMetaConfig as q, UserConfigFn as r, Logger as s, UserConfig as t, Output as u, GeneratorConfigObject as v, InferGeneratorFunction as w, GeneratorResult as x, GeneratorFunction as y, InputFunction as z };
+//# sourceMappingURL=config-CvXMgTtG.d.mts.map

package/dist/config-CvXMgTtG.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CvXMgTtG.d.mts","names":[],"sources":["../src/types/meta.ts","../src/types/schema.ts","../src/types/input.ts","../src/types/formatter.ts","../src/types/generator.ts","../src/types/output.ts","../src/types/settings.ts","../src/types/config.ts"],"mappings":""}

package/dist/{config-ZvnnxGt9.d.mts → config-D9w8UWb1.d.cts}

@@ -1,8 +1,8 @@
-import { EnvPaths } from "@stryke/env/get-env-paths";
+import { DeepPartial, MaybePromise } from "@stryke/types/base";
 import { Storage } from "unstorage";
 import { BaseExtractOptions, InferExtractOptions, SchemaConfig, SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
-import { DeepPartial, MaybePromise } from "@stryke/types/base";
 import { InferLoadOptions, LoadReference } from "@stryke/resolve/types";
+import { EnvPaths } from "@stryke/env/get-env-paths";
 //#region src/types/meta.d.ts
 type MetaDeprecated = true | string | {
   message?: string;
@@ -164,6 +164,36 @@ interface Input<TSpec, TOptions extends object> {
   input: TSpec | InputFunction<TSpec, TOptions>;
 }
 //#endregion
+//#region src/types/formatter.d.ts
+type FormatterFunction<TSpec, TOptions extends object> = (spec: TSpec, options: TOptions, documents: Record<string, GeneratedDocument>) => MaybePromise<Record<string, GeneratedDocument>>;
+interface FormatterConfigObject<TSpec, TOptions extends object> {
+  /**
+   * Optional metadata that provides contextual information for the formatter.
+   */
+  meta?: MetaConfig;
+  /**
+   * The formatter implementation, either as a callable function or a file reference.
+   */
+  format: FormatterFunction<TSpec, TOptions> | LoadReference;
+}
+type FormatterConfig<TSpec, TOptions extends object> = LoadReference | FormatterFunction<TSpec, TOptions> | FormatterConfigObject<TSpec, TOptions>;
+type InferCreateFormatterOptions<T extends FormatterConfig<any, any>> = (T extends LoadReference ? InferLoadOptions<T> : {}) & BaseExtractOptions;
+interface Formatter<TSpec, TOptions extends object> {
+  /**
+   * Optional metadata that provides contextual information for the formatter.
+   */
+  meta?: MetaConfig;
+  /**
+   * The formatter function, which receives the documents produced by the generator and returns the formatted documents that will be passed to the output.
+   *
+   * @param spec - The specification object used to generate the documents.
+   * @param options - The options used to generate the documents.
+   * @param documents - The generated documents to format.
+   * @returns The formatted documents.
+   */
+  format: FormatterFunction<TSpec, TOptions>;
+}
+//#endregion
 //#region src/types/generator.d.ts
 interface GeneratedDocumentChunk {
   content?: string;
@@ -212,6 +242,10 @@ interface GeneratorConfigObject<TSpec, TOptions extends object, TReturns = void>
    * The output config that consumes generated output.
    */
   output?: OutputConfig<TSpec, TOptions, TReturns>;
+  /**
+   * The formatter config(s) applied, in order, to the generated documents before they are passed to the output.
+   */
+  format?: FormatterConfig<TSpec, TOptions> | FormatterConfig<TSpec, TOptions>[];
   /**
    * The generate implementation, either as a callable function or a file reference.
    */
@@ -236,6 +270,10 @@ interface Generator<TSpec, TOptions extends object, TReturns = void> {
    * The output 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.
    */
   output: Output<TSpec, TOptions, TReturns>;
+  /**
+   * The formatters applied, in order, to the generated documents before they are passed to the output.
+   */
+  formatters: Formatter<TSpec, TOptions>[];
   /**
    * The generator function that executes the generator logic, taking in options and producing output based on the input and output definitions.
    *
@@ -386,5 +424,5 @@ type UserConfigFnPromise<TSpec = any, TOptions extends object = any, TReturns =
 type UserConfigFn<TSpec = any, TOptions extends object = any, TReturns = any> = (params: UserConfigParams) => UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[] | Promise<UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[]>;
 type UserConfigExport<TSpec = any, TOptions extends object = any, TReturns = any> = UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[] | Promise<UserConfig<TSpec, TOptions, TReturns> | UserConfig<TSpec, TOptions, TReturns>[]> | UserConfigFnObject<TSpec, TOptions, TReturns> | UserConfigFnPromise<TSpec, TOptions, TReturns> | UserConfigFn<TSpec, TOptions, TReturns>;
 //#endregion
-export { InferCreateInputOptions as A, SchemaMetaExample as B, InferGenerator as C, InferMeta as D, InferInputConfig as E, InputMetaConfig as F, MetaLink as G, BaseMetaConfig as H, InferCreateSchemaOptions as I, Schema as L, InputConfig as M, InputConfigObject as N, InferOutputConfig as O, InputFunction as P, SchemaConfigObject as R, InferCreateGeneratorOptions as S, InferGeneratorResult as T, MetaConfig as U, SchemaOf as V, MetaDeprecated as W, GeneratorConfig as _, UserConfigFnPromise as a, GeneratorFunctionResult as b, Settings as c, OutputConfig as d, OutputConfigObject as f, Generator as g, GeneratedDocumentChunk as h, UserConfigFnObject as i, Input as j, InferSchemaConfig as k, InferCreateOutputOptions as l, GeneratedDocument as m, UserConfigExport as n, UserConfigParams as o, OutputFunction as p, UserConfigFn as r, Logger as s, UserConfig as t, Output as u, GeneratorConfigObject as v, InferGeneratorFunction as w, GeneratorResult as x, GeneratorFunction as y, SchemaMetaConfig as z };
-//# sourceMappingURL=config-ZvnnxGt9.d.mts.map
+export { Formatter as A, InputMetaConfig as B, InferGenerator as C, InferMeta as D, InferInputConfig as E, InferCreateInputOptions as F, SchemaMetaExample as G, Schema as H, Input as I, MetaConfig as J, SchemaOf as K, InputConfig as L, FormatterConfigObject as M, FormatterFunction as N, InferOutputConfig as O, InferCreateFormatterOptions as P, InputConfigObject as R, InferCreateGeneratorOptions as S, InferGeneratorResult as T, SchemaConfigObject as U, InferCreateSchemaOptions as V, SchemaMetaConfig as W, MetaLink as X, MetaDeprecated as Y, GeneratorConfig as _, UserConfigFnPromise as a, GeneratorFunctionResult as b, Settings as c, OutputConfig as d, OutputConfigObject as f, Generator as g, GeneratedDocumentChunk as h, UserConfigFnObject as i, FormatterConfig as j, InferSchemaConfig as k, InferCreateOutputOptions as l, GeneratedDocument as m, UserConfigExport as n, UserConfigParams as o, OutputFunction as p, BaseMetaConfig as q, UserConfigFn as r, Logger as s, UserConfig as t, Output as u, GeneratorConfigObject as v, InferGeneratorFunction as w, GeneratorResult as x, GeneratorFunction as y, InputFunction as z };
+//# sourceMappingURL=config-D9w8UWb1.d.cts.map

package/dist/config-D9w8UWb1.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-D9w8UWb1.d.cts","names":[],"sources":["../src/types/meta.ts","../src/types/schema.ts","../src/types/input.ts","../src/types/formatter.ts","../src/types/generator.ts","../src/types/output.ts","../src/types/settings.ts","../src/types/config.ts"],"mappings":"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"}

package/dist/config.d.cts

@@ -1,4 +1,4 @@
-import { a as UserConfigFnPromise, i as UserConfigFnObject, n as UserConfigExport, o as UserConfigParams, r as UserConfigFn, t as UserConfig } from "./config-DS1cj7j6.cjs";
+import { a as UserConfigFnPromise, i as UserConfigFnObject, n as UserConfigExport, o as UserConfigParams, r as UserConfigFn, t as UserConfig } from "./config-D9w8UWb1.cjs";
 //#region src/config.d.ts
 /**
  * Type helper to make it easier to use `power-plant.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { a as UserConfigFnPromise, i as UserConfigFnObject, n as UserConfigExport, o as UserConfigParams, r as UserConfigFn, t as UserConfig } from "./config-ZvnnxGt9.mjs";
+import { a as UserConfigFnPromise, i as UserConfigFnObject, n as UserConfigExport, o as UserConfigParams, r as UserConfigFn, t as UserConfig } from "./config-CvXMgTtG.mjs";
 //#region src/config.d.ts
 /**
  * Type helper to make it easier to use `power-plant.config.ts` files. Accepts a direct {@link UserConfig} object, or a function that returns it. The function receives a {@link ConfigParams} object.

package/dist/{context-C3M0YsM_.d.cts → context-Dky8WN7n.d.mts}

@@ -1,5 +1,5 @@
-import { V as SchemaOf, c as Settings, j as Input, m as GeneratedDocument, s as Logger, u as Output } from "./config-DS1cj7j6.cjs";
-import { n as Execution } from "./execution-vXX_IEkO.cjs";
+import { I as Input, K as SchemaOf, c as Settings, m as GeneratedDocument, s as Logger, u as Output } from "./config-CvXMgTtG.mjs";
+import { n as Execution } from "./execution-54smWTBe.mjs";
 import { Storage } from "unstorage";
 //#region src/types/base.d.ts
 interface Base {
@@ -104,4 +104,4 @@ interface LocalStore {
 }
 //#endregion
 export { Session as a, SessionContext as i, ExecutionContext as n, Base as o, LocalStore as r, Context as t };
-//# sourceMappingURL=context-C3M0YsM_.d.cts.map
+//# sourceMappingURL=context-Dky8WN7n.d.mts.map

package/dist/context-Dky8WN7n.d.mts.map

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

package/dist/{context-FIedZFci.d.mts → context-TUsikpbp.d.cts}

@@ -1,5 +1,5 @@
-import { V as SchemaOf, c as Settings, j as Input, m as GeneratedDocument, s as Logger, u as Output } from "./config-ZvnnxGt9.mjs";
-import { n as Execution } from "./execution-BaOcMIgV.mjs";
+import { I as Input, K as SchemaOf, c as Settings, m as GeneratedDocument, s as Logger, u as Output } from "./config-D9w8UWb1.cjs";
+import { n as Execution } from "./execution-C8ndihYL.cjs";
 import { Storage } from "unstorage";
 //#region src/types/base.d.ts
 interface Base {
@@ -104,4 +104,4 @@ interface LocalStore {
 }
 //#endregion
 export { Session as a, SessionContext as i, ExecutionContext as n, Base as o, LocalStore as r, Context as t };
-//# sourceMappingURL=context-FIedZFci.d.mts.map
+//# sourceMappingURL=context-TUsikpbp.d.cts.map

package/dist/{context-C3M0YsM_.d.cts.map → context-TUsikpbp.d.cts.map}

@@ -1 +1 @@
-{"version":3,"file":"context-C3M0YsM_.d.cts","names":[],"sources":["../src/types/base.ts","../src/types/session.ts","../src/types/context.ts"],"mappings":";;;;UAkBiB;;;;EAIf;;;;EAKA,WAAW;;;;EAKX,WAAW;;;;EAKX;;;;UChBe,gBAAgB;;;;EAI/B;;;;EAKA;;;;EAKA,YAAY;;;;UCRG;;;;EAIf;;UAGe,uBAAuB;;;;EAItC,UAAU;;;;;;;EAQV,SAAS;;;;EAKT,QAAQ;;;;EAKR,SAAS;;UAGM,iBACf,OACA,yBACA,yBAEQ,gBAAgB,UAAU;;;;EAIlC,SAAS;;;;MAKL,QAAQ;;;;MAKR,UAAU,SAAS;;;;MAKnB,SAAS,MAAM,OAAO;;;;MAKtB,UAAU,OAAO,OAAO,UAAU;;;;MAKlC,aAAa,eAAe;;;;;;;EAQhC,cACE,yBAAyB,mBACzB,WAAW,KAAK;;UAIH;EACf;EACA"}
+{"version":3,"file":"context-TUsikpbp.d.cts","names":[],"sources":["../src/types/base.ts","../src/types/session.ts","../src/types/context.ts"],"mappings":";;;;UAkBiB;;;;EAIf;;;;EAKA,WAAW;;;;EAKX,WAAW;;;;EAKX;;;;UChBe,gBAAgB;;;;EAI/B;;;;EAKA;;;;EAKA,YAAY;;;;UCRG;;;;EAIf;;UAGe,uBAAuB;;;;EAItC,UAAU;;;;;;;EAQV,SAAS;;;;EAKT,QAAQ;;;;EAKR,SAAS;;UAGM,iBACf,OACA,yBACA,yBAEQ,gBAAgB,UAAU;;;;EAIlC,SAAS;;;;MAKL,QAAQ;;;;MAKR,UAAU,SAAS;;;;MAKnB,SAAS,MAAM,OAAO;;;;MAKtB,UAAU,OAAO,OAAO,UAAU;;;;MAKlC,aAAa,eAAe;;;;;;;EAQhC,cACE,yBAAyB,mBACzB,WAAW,KAAK;;UAIH;EACf;EACA"}

package/dist/context.d.cts

@@ -1,4 +1,4 @@
-import { i as SessionContext, n as ExecutionContext } from "./context-C3M0YsM_.cjs";
+import { i as SessionContext, n as ExecutionContext } from "./context-TUsikpbp.cjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/context.d.ts
 /**

package/dist/context.d.mts

@@ -1,4 +1,4 @@
-import { i as SessionContext, n as ExecutionContext } from "./context-FIedZFci.mjs";
+import { i as SessionContext, n as ExecutionContext } from "./context-Dky8WN7n.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/context.d.ts
 /**

package/dist/define.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_helpers_type_checks = require('./helpers/type-checks.cjs');
+const require_helpers_type_checks = require("./helpers/type-checks.cjs");
 
 //#region src/define.ts
 /**
@@ -70,6 +70,40 @@ function defineOutput(output) {
 	return { output };
 }
 /**
+* Defines a formatter configuration object. If the provided format is already a formatter configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `format` property.
+*
+* @example
+* ```ts
+* import { defineFormatter } from "@power-plant/core";
+*
+* // Define a formatter from a formatter function
+* export default defineFormatter((spec, options, documents) => {
+*   // Your formatting logic here
+*   return documents;
+* });
+*
+* // Define a formatter from an existing formatter configuration object
+* export default defineFormatter({
+*  meta: {
+*     name: "My Formatter",
+*     version: "1.0.0",
+*     description: "A formatter that does something.",
+*   },
+*   format: (spec, options, documents) => {
+*     // Your formatting logic here
+*     return documents;
+*   },
+* });
+* ```
+*
+* @param format - The formatter configuration to define. This can be either a formatter configuration object or a formatter function.
+* @returns A formatter configuration object that contains the provided formatter. If the input was already a formatter configuration object, it will be returned unchanged.
+*/
+function defineFormatter(format) {
+	if (require_helpers_type_checks.isFormatterConfigObject(format)) return format;
+	return { format };
+}
+/**
 * Defines a schema configuration object. If the provided schema is already a schema configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `schema` property.
 *
 * @param schema - The schema configuration to define. This can be either a schema source configuration, a schema envelope, or a schema configuration object.
@@ -91,6 +125,7 @@ function defineGenerator(generator) {
 }
 
 //#endregion
+exports.defineFormatter = defineFormatter;
 exports.defineGenerator = defineGenerator;
 exports.defineInput = defineInput;
 exports.defineOutput = defineOutput;

package/dist/define.d.cts

@@ -1,4 +1,4 @@
-import { M as InputConfig, N as InputConfigObject, R as SchemaConfigObject, d as OutputConfig, f as OutputConfigObject, v as GeneratorConfigObject } from "./config-DS1cj7j6.cjs";
+import { L as InputConfig, M as FormatterConfigObject, R as InputConfigObject, U as SchemaConfigObject, d as OutputConfig, f as OutputConfigObject, j as FormatterConfig, v as GeneratorConfigObject } from "./config-D9w8UWb1.cjs";
 import { SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
 //#region src/define.d.ts
 /**
@@ -62,6 +62,37 @@ declare function defineInput<TSpec, TOptions extends object>(input: InputConfig<
  * @returns A output configuration object that contains the provided output. If the input was already a output configuration object, it will be returned unchanged.
  */
 declare function defineOutput<TSpec, TOptions extends object, TReturns = void>(output: OutputConfig<TSpec, TOptions, TReturns>): OutputConfigObject<TSpec, TOptions, TReturns>;
+/**
+ * Defines a formatter configuration object. If the provided format is already a formatter configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `format` property.
+ *
+ * @example
+ * ```ts
+ * import { defineFormatter } from "@power-plant/core";
+ *
+ * // Define a formatter from a formatter function
+ * export default defineFormatter((spec, options, documents) => {
+ *   // Your formatting logic here
+ *   return documents;
+ * });
+ *
+ * // Define a formatter from an existing formatter configuration object
+ * export default defineFormatter({
+ *  meta: {
+ *     name: "My Formatter",
+ *     version: "1.0.0",
+ *     description: "A formatter that does something.",
+ *   },
+ *   format: (spec, options, documents) => {
+ *     // Your formatting logic here
+ *     return documents;
+ *   },
+ * });
+ * ```
+ *
+ * @param format - The formatter configuration to define. This can be either a formatter configuration object or a formatter function.
+ * @returns A formatter configuration object that contains the provided formatter. If the input was already a formatter configuration object, it will be returned unchanged.
+ */
+declare function defineFormatter<TSpec, TOptions extends object>(format: FormatterConfig<TSpec, TOptions>): FormatterConfigObject<TSpec, TOptions>;
 /**
  * Defines a schema configuration object. If the provided schema is already a schema configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `schema` property.
  *
@@ -77,5 +108,5 @@ declare function defineSchema<TSpec>(schema: SchemaSourceConfig<TSpec> | SchemaE
  */
 declare function defineGenerator<TSpec, TOptions extends object, TReturns = void>(generator: GeneratorConfigObject<TSpec, TOptions, TReturns>): GeneratorConfigObject<TSpec, TOptions, TReturns>;
 //#endregion
-export { defineGenerator, defineInput, defineOutput, defineSchema };
+export { defineFormatter, defineGenerator, defineInput, defineOutput, defineSchema };
 //# sourceMappingURL=define.d.cts.map

package/dist/define.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.cts","names":[],"sources":["../src/define.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DgB,YAAY,OAAO,yBACjC,OAAO,YAAY,OAAO,YACzB,kBAAkB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCZ,aAAa,OAAO,yBAAyB,iBAC3D,QAAQ,aAAa,OAAO,UAAU,YACrC,mBAAmB,OAAO,UAAU;;;;;;;iBAcvB,aAAa,OAC3B,QACI,mBAAmB,SACnB,iBAAiB,SACjB,mBAAmB,SACtB,mBAAmB;;;;;;;iBAcN,gBACd,OACA,yBACA,iBAEA,WAAW,sBAAsB,OAAO,UAAU,YACjD,sBAAsB,OAAO,UAAU"}
+{"version":3,"file":"define.d.cts","names":[],"sources":["../src/define.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+DgB,YAAY,OAAO,yBACjC,OAAO,YAAY,OAAO,YACzB,kBAAkB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCZ,aAAa,OAAO,yBAAyB,iBAC3D,QAAQ,aAAa,OAAO,UAAU,YACrC,mBAAmB,OAAO,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCvB,gBAAgB,OAAO,yBACrC,QAAQ,gBAAgB,OAAO,YAC9B,sBAAsB,OAAO;;;;;;;iBAchB,aAAa,OAC3B,QACI,mBAAmB,SACnB,iBAAiB,SACjB,mBAAmB,SACtB,mBAAmB;;;;;;;iBAcN,gBACd,OACA,yBACA,iBAEA,WAAW,sBAAsB,OAAO,UAAU,YACjD,sBAAsB,OAAO,UAAU"}

package/dist/define.d.mts

@@ -1,4 +1,4 @@
-import { M as InputConfig, N as InputConfigObject, R as SchemaConfigObject, d as OutputConfig, f as OutputConfigObject, v as GeneratorConfigObject } from "./config-ZvnnxGt9.mjs";
+import { L as InputConfig, M as FormatterConfigObject, R as InputConfigObject, U as SchemaConfigObject, d as OutputConfig, f as OutputConfigObject, j as FormatterConfig, v as GeneratorConfigObject } from "./config-CvXMgTtG.mjs";
 import { SchemaEnvelopeOf, SchemaSourceConfig } from "@power-plant/schema";
 //#region src/define.d.ts
 /**
@@ -62,6 +62,37 @@ declare function defineInput<TSpec, TOptions extends object>(input: InputConfig<
  * @returns A output configuration object that contains the provided output. If the input was already a output configuration object, it will be returned unchanged.
  */
 declare function defineOutput<TSpec, TOptions extends object, TReturns = void>(output: OutputConfig<TSpec, TOptions, TReturns>): OutputConfigObject<TSpec, TOptions, TReturns>;
+/**
+ * Defines a formatter configuration object. If the provided format is already a formatter configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `format` property.
+ *
+ * @example
+ * ```ts
+ * import { defineFormatter } from "@power-plant/core";
+ *
+ * // Define a formatter from a formatter function
+ * export default defineFormatter((spec, options, documents) => {
+ *   // Your formatting logic here
+ *   return documents;
+ * });
+ *
+ * // Define a formatter from an existing formatter configuration object
+ * export default defineFormatter({
+ *  meta: {
+ *     name: "My Formatter",
+ *     version: "1.0.0",
+ *     description: "A formatter that does something.",
+ *   },
+ *   format: (spec, options, documents) => {
+ *     // Your formatting logic here
+ *     return documents;
+ *   },
+ * });
+ * ```
+ *
+ * @param format - The formatter configuration to define. This can be either a formatter configuration object or a formatter function.
+ * @returns A formatter configuration object that contains the provided formatter. If the input was already a formatter configuration object, it will be returned unchanged.
+ */
+declare function defineFormatter<TSpec, TOptions extends object>(format: FormatterConfig<TSpec, TOptions>): FormatterConfigObject<TSpec, TOptions>;
 /**
  * Defines a schema configuration object. If the provided schema is already a schema configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `schema` property.
  *
@@ -77,5 +108,5 @@ declare function defineSchema<TSpec>(schema: SchemaSourceConfig<TSpec> | SchemaE
  */
 declare function defineGenerator<TSpec, TOptions extends object, TReturns = void>(generator: GeneratorConfigObject<TSpec, TOptions, TReturns>): GeneratorConfigObject<TSpec, TOptions, TReturns>;
 //#endregion
-export { defineGenerator, defineInput, defineOutput, defineSchema };
+export { defineFormatter, defineGenerator, defineInput, defineOutput, defineSchema };
 //# sourceMappingURL=define.d.mts.map

package/dist/define.mjs

@@ -1,4 +1,4 @@
-import { isGeneratorConfigObject, isInputConfigObject, isOutputConfigObject, isSchemaConfigObject } from "./helpers/type-checks.mjs";
+import { isFormatterConfigObject, isGeneratorConfigObject, isInputConfigObject, isOutputConfigObject, isSchemaConfigObject } from "./helpers/type-checks.mjs";
 
 //#region src/define.ts
 /**
@@ -69,6 +69,40 @@ function defineOutput(output) {
 	return { output };
 }
 /**
+* Defines a formatter configuration object. If the provided format is already a formatter configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `format` property.
+*
+* @example
+* ```ts
+* import { defineFormatter } from "@power-plant/core";
+*
+* // Define a formatter from a formatter function
+* export default defineFormatter((spec, options, documents) => {
+*   // Your formatting logic here
+*   return documents;
+* });
+*
+* // Define a formatter from an existing formatter configuration object
+* export default defineFormatter({
+*  meta: {
+*     name: "My Formatter",
+*     version: "1.0.0",
+*     description: "A formatter that does something.",
+*   },
+*   format: (spec, options, documents) => {
+*     // Your formatting logic here
+*     return documents;
+*   },
+* });
+* ```
+*
+* @param format - The formatter configuration to define. This can be either a formatter configuration object or a formatter function.
+* @returns A formatter configuration object that contains the provided formatter. If the input was already a formatter configuration object, it will be returned unchanged.
+*/
+function defineFormatter(format) {
+	if (isFormatterConfigObject(format)) return format;
+	return { format };
+}
+/**
 * Defines a schema configuration object. If the provided schema is already a schema configuration object, it will be returned as-is. Otherwise, it will be wrapped in an object with a `schema` property.
 *
 * @param schema - The schema configuration to define. This can be either a schema source configuration, a schema envelope, or a schema configuration object.
@@ -90,5 +124,5 @@ function defineGenerator(generator) {
 }
 
 //#endregion
-export { defineGenerator, defineInput, defineOutput, defineSchema };
+export { defineFormatter, defineGenerator, defineInput, defineOutput, defineSchema };
 //# sourceMappingURL=define.mjs.map

package/dist/{execute-C7wgqV2z.cjs → execute-Dg9Z7kc_.cjs}

@@ -25,9 +25,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const require_context = require('./context.cjs');
-const require_helpers_type_checks = require('./helpers/type-checks.cjs');
-const require_helpers_meta = require('./helpers/meta.cjs');
+const require_context = require("./context.cjs");
+const require_helpers_type_checks = require("./helpers/type-checks.cjs");
+const require_helpers_meta = require("./helpers/meta.cjs");
 let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
 let _stryke_env_get_env_paths = require("@stryke/env/get-env-paths");
 let _stryke_fs_read_file = require("@stryke/fs/read-file");
@@ -44,10 +44,11 @@ unstorage_drivers_fs_lite = __toESM(unstorage_drivers_fs_lite, 1);
 let unstorage_drivers_memory = require("unstorage/drivers/memory");
 unstorage_drivers_memory = __toESM(unstorage_drivers_memory, 1);
 let _power_plant_schema_storage = require("@power-plant/schema/storage");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_resolve_load = require("@stryke/resolve/load");
 let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
-let _power_plant_schema = require("@power-plant/schema");
 let _stryke_resolve_type_checks = require("@stryke/resolve/type-checks");
+let _power_plant_schema = require("@power-plant/schema");
 
 //#region src/lib/context.ts
 const logger = {
@@ -163,6 +164,37 @@ async function extractExecution(execution, _spec, _options) {
 	return execution;
 }
 
+//#endregion
+//#region src/lib/formatter.ts
+/**
+* Normalizes any accepted formatter config into a concrete formatter descriptor.
+*
+* @param config - The formatter config to normalize.
+* @param options - Optional options for resolving the formatter config.
+* @returns A promise that resolves to a normalized formatter descriptor.
+*/
+async function createFormatter(config, options = {}) {
+	const { format, meta } = require_helpers_type_checks.isFormatterConfigObject(config) ? config : {
+		format: config,
+		meta: void 0
+	};
+	let resolvedFormatter;
+	let resolvedMeta = meta;
+	if ((0, _stryke_resolve_type_checks.isLoadReference)(format)) try {
+		const loaded = await (0, _stryke_resolve_load.load)(format, options);
+		if (require_helpers_type_checks.isFormatterConfigObject(loaded)) {
+			const created = await createFormatter(loaded, options);
+			resolvedFormatter = created.format;
+			resolvedMeta ??= created.meta;
+		} else resolvedFormatter = loaded;
+	} catch {}
+	if (!resolvedFormatter) resolvedFormatter = format;
+	return {
+		format: resolvedFormatter,
+		meta: resolvedMeta
+	};
+}
+
 //#endregion
 //#region src/lib/schema.ts
 /**
@@ -353,13 +385,20 @@ async function createGenerator(executionId, sessionContext, config, options = {}
 	}
 	let outputConfig = configObject.output;
 	if (!outputConfig) outputConfig = "@power-plant/unstorage-output";
-	const [input, output] = await Promise.all([createInput(schema, inputConfig, {
-		storage: sessionContext.storage,
-		...options
-	}), createOutput(schema, outputConfig, {
-		storage: sessionContext.storage,
-		...options
-	})]);
+	const [input, output, ...formatters] = await Promise.all([
+		createInput(schema, inputConfig, {
+			storage: sessionContext.storage,
+			...options
+		}),
+		createOutput(schema, outputConfig, {
+			storage: sessionContext.storage,
+			...options
+		}),
+		...(0, _stryke_convert_to_array.toArray)(configObject.format ?? []).map(async (formatterConfig) => createFormatter(formatterConfig, {
+			storage: sessionContext.storage,
+			...options
+		}))
+	]);
 	assertGeneratorConfigSchemasDoNotContradict(schema, input, output);
 	const generator = async (options) => {
 		const context = await createExecutionContext(executionId, sessionContext, options, schema, input, output);
@@ -375,12 +414,14 @@ async function createGenerator(executionId, sessionContext, config, options = {}
 				storage: context.storage,
 				...options
 			});
-			const documents = await generatorFn(spec, options);
+			let documents = await generatorFn(spec, options);
+			for (const formatter of formatters) documents = await formatter.format(spec, options, documents);
+			const returns = await output.output(spec, options, documents);
 			return {
 				spec,
 				options,
 				documents,
-				returns: await output.output(spec, options, documents)
+				returns
 			};
 		});
 	};
@@ -389,6 +430,7 @@ async function createGenerator(executionId, sessionContext, config, options = {}
 		schema,
 		input,
 		output,
+		formatters,
 		generator
 	};
 }
@@ -502,13 +544,13 @@ async function execute(config, options = {}) {
 }
 
 //#endregion
-Object.defineProperty(exports, 'createExecute', {
+Object.defineProperty(exports, "createExecute", {
   enumerable: true,
   get: function () {
     return createExecute;
   }
 });
-Object.defineProperty(exports, 'execute', {
+Object.defineProperty(exports, "execute", {
   enumerable: true,
   get: function () {
     return execute;