@power-plant/alloy-js 0.0.19 → 0.0.20

package/README.md

@@ -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.12-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.19-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/generate.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-CMqjfN_6.cjs"),t=require("./render.cjs");let n=require("@power-plant/core"),r=require("@power-plant/noop-output");r=e.t(r,1);async function i(e,i={},a={}){return(0,n.execute)({output:r.default,...i,generator:async()=>t.render(e)},a)}exports.generate=i;

package/dist/generate.d.cts

@@ -0,0 +1,25 @@
+import { Children } from "@alloy-js/core";
+import { GeneratedDocument, GeneratorConfigObject, OutputConfig, UserConfig } from "@power-plant/core";
+//#region src/generate.d.ts
+/**
+ * Execute Alloy-js template components through a Power Plant execution context.
+ *
+ * @remarks
+ * Creates an execution context via `execute`, then renders the Alloy-js template components with `render`. Use this as the top-level entry point; use `render` when already inside a running generator.
+ *
+ * @example
+ * ```tsx
+ * import { generate } from "@power-plant/alloy-js/generate";
+ *
+ * await generate(<> ... </>);
+ * ```
+ *
+ * @param template - The Alloy-js template components to render.
+ * @param config - A generator configuration object.
+ * @param options - Engine options for the execution context.
+ * @returns A promise that resolves when generation is complete.
+ */
+declare function generate<TSpec = any, TOptions extends object = object, TGeneratorConfig extends Omit<GeneratorConfigObject<TSpec, TOptions, any>, "generator"> = Omit<GeneratorConfigObject<TSpec, TOptions, Record<string, GeneratedDocument>>, "generator">, TReturns = TGeneratorConfig["output"] extends OutputConfig<TSpec, TOptions, infer TOutputReturns> ? TOutputReturns : any>(template: Children, config?: TGeneratorConfig, options?: UserConfig & TOptions): Promise<TReturns>;
+//#endregion
+export { generate };
+//# sourceMappingURL=generate.d.cts.map

package/dist/generate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.cts","names":[],"sources":["../src/generate.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;iBAgDsB,SACpB,aACA,kCACA,yBAAyB,KACvB,sBAAsB,OAAO,+BAE3B,KACF,sBAAsB,OAAO,UAAU,eAAe,mCAGxD,WAAW,mCAAmC,aAC5C,OACA,gBACM,kBAEJ,sBAGJ,UAAU,UACV,SAAQ,kBACR,UAAS,aAAa,WACrB,QAAQ"}

package/dist/generate.d.mts

@@ -0,0 +1,25 @@
+import { Children } from "@alloy-js/core";
+import { GeneratedDocument, GeneratorConfigObject, OutputConfig, UserConfig } from "@power-plant/core";
+//#region src/generate.d.ts
+/**
+ * Execute Alloy-js template components through a Power Plant execution context.
+ *
+ * @remarks
+ * Creates an execution context via `execute`, then renders the Alloy-js template components with `render`. Use this as the top-level entry point; use `render` when already inside a running generator.
+ *
+ * @example
+ * ```tsx
+ * import { generate } from "@power-plant/alloy-js/generate";
+ *
+ * await generate(<> ... </>);
+ * ```
+ *
+ * @param template - The Alloy-js template components to render.
+ * @param config - A generator configuration object.
+ * @param options - Engine options for the execution context.
+ * @returns A promise that resolves when generation is complete.
+ */
+declare function generate<TSpec = any, TOptions extends object = object, TGeneratorConfig extends Omit<GeneratorConfigObject<TSpec, TOptions, any>, "generator"> = Omit<GeneratorConfigObject<TSpec, TOptions, Record<string, GeneratedDocument>>, "generator">, TReturns = TGeneratorConfig["output"] extends OutputConfig<TSpec, TOptions, infer TOutputReturns> ? TOutputReturns : any>(template: Children, config?: TGeneratorConfig, options?: UserConfig & TOptions): Promise<TReturns>;
+//#endregion
+export { generate };
+//# sourceMappingURL=generate.d.mts.map

package/dist/generate.d.mts.map

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

package/dist/generate.mjs

@@ -0,0 +1,2 @@
+import{render as e}from"./render.mjs";import{execute as t}from"@power-plant/core";import n from"@power-plant/noop-output";async function r(r,i={},a={}){return t({output:n,...i,generator:async()=>e(r)},a)}export{r as generate};
+//# sourceMappingURL=generate.mjs.map

package/dist/generate.mjs.map

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

package/dist/render.d.cts

@@ -2,7 +2,7 @@ import { Children } from "@alloy-js/core";
 import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
 //#region src/render.d.ts
 /**
- * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
+ * A function to render template components within the [Alloy-js](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
  *
  * @example
  * ```tsx
@@ -12,10 +12,10 @@ import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
  * ```
  *
  * @param context - The Power Plant execution context.
- * @param children - The children components to render.
+ * @param template - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, template: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
 /**
  * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
  *
@@ -26,10 +26,10 @@ declare function renderBase<TSpec, TOptions extends object, TReturns = void>(con
  * await render(<> ... </>);
  * ```
  *
- * @param children - The children components to render.
+ * @param template - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function render<TSpec, TOptions extends object, TReturns = void>(children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function render<TSpec, TOptions extends object, TReturns = void>(template: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
 //#endregion
 export { render, renderBase };
 //# sourceMappingURL=render.d.cts.map

package/dist/render.d.mts

@@ -2,7 +2,7 @@ import { Children } from "@alloy-js/core";
 import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
 //#region src/render.d.ts
 /**
- * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
+ * A function to render template components within the [Alloy-js](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
  *
  * @example
  * ```tsx
@@ -12,10 +12,10 @@ import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
  * ```
  *
  * @param context - The Power Plant execution context.
- * @param children - The children components to render.
+ * @param template - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, template: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
 /**
  * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and register any generated documents on the execution context.
  *
@@ -26,10 +26,10 @@ declare function renderBase<TSpec, TOptions extends object, TReturns = void>(con
  * await render(<> ... </>);
  * ```
  *
- * @param children - The children components to render.
+ * @param template - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function render<TSpec, TOptions extends object, TReturns = void>(children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function render<TSpec, TOptions extends object, TReturns = void>(template: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
 //#endregion
 export { render, renderBase };
 //# sourceMappingURL=render.d.mts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@power-plant/alloy-js",
-  "version": "0.0.19",
+  "version": "0.0.20",
   "private": false,
   "description": "A Power Plant generator for using Alloy JS to generate source code.",
   "keywords": [
@@ -297,6 +297,20 @@
         "default": "./dist/core/types/components.mjs"
       }
     },
+    "./generate": {
+      "require": {
+        "types": "./dist/generate.d.cts",
+        "default": "./dist/generate.cjs"
+      },
+      "import": {
+        "types": "./dist/generate.d.mts",
+        "default": "./dist/generate.mjs"
+      },
+      "default": {
+        "types": "./dist/generate.d.mts",
+        "default": "./dist/generate.mjs"
+      }
+    },
     "./hcl": {
       "require": {
         "types": "./dist/hcl/index.d.cts",
@@ -869,8 +883,9 @@
     "@alloy-js/json": "^0.24.0",
     "@alloy-js/markdown": "^0.24.0",
     "@alloy-js/typescript": "^0.24.0",
-    "@power-plant/core": "^0.0.22",
-    "@power-plant/schema": "^0.0.21",
+    "@power-plant/core": "^0.0.23",
+    "@power-plant/schema": "^0.0.22",
+    "@power-plant/noop-output": "^0.0.2",
     "@stryke/convert": "^0.7.27",
     "@stryke/helpers": "^0.10.36",
     "@stryke/path": "^0.29.23",
@@ -892,5 +907,5 @@
   "peerDependencies": { "@alloy-js/babel-preset": ">=0.3.0" },
   "peerDependenciesMeta": { "@alloy-js/babel-preset": { "optional": false } },
   "publishConfig": { "access": "public" },
-  "gitHead": "79c19a661afc8b7f551988af50af27b372996e28"
+  "gitHead": "684f2460a2bb943d952d3e608e8c124f0a5b6301"
 }