@power-plant/alloy-js 0.0.18 → 0.0.19

package/dist/core/contexts/execution.d.mts

@@ -1,2 +1,2 @@
-import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../../execution-BGY24cO8.mjs";
+import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../../execution-zVRllrpa.mjs";
 export { ExecutionContext, useExecution, useExecutionSafe };

package/dist/core/contexts/index.d.mts

@@ -1,4 +1,4 @@
-import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../../execution-BGY24cO8.mjs";
+import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../../execution-zVRllrpa.mjs";
 import { n as useMeta, r as useMetaSafe, t as MetaContext } from "../../meta-DtIlHZG5.mjs";
 import { a as useSchemaPropertySafe, i as useSchemaProperty, n as SchemaPropertyContext, o as useSchemaSafe, r as useSchema, t as SchemaContext } from "../../schema-CkCXkDzU.mjs";
 import { n as useSession, r as useSessionSafe, t as SessionContext } from "../../session-C2p15ap9.mjs";

package/dist/core/index.d.mts

@@ -3,7 +3,7 @@ import { n as SingleLineCommentProps, r as SingleLineCommentVariant, t as Single
 import { n as SourceFileProps, t as SourceFile } from "../source-file-DEGtBMgH.mjs";
 import { n as SpacingProps, t as Spacing } from "../spacing-HIHoQdxS.mjs";
 import "./components/index.mjs";
-import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../execution-BGY24cO8.mjs";
+import { n as useExecution, r as useExecutionSafe, t as ExecutionContext } from "../execution-zVRllrpa.mjs";
 import { n as useMeta, r as useMetaSafe, t as MetaContext } from "../meta-DtIlHZG5.mjs";
 import { a as useSchemaPropertySafe, i as useSchemaProperty, n as SchemaPropertyContext, o as useSchemaSafe, r as useSchema, t as SchemaContext } from "../schema-CkCXkDzU.mjs";
 import { n as useSession, r as useSessionSafe, t as SessionContext } from "../session-C2p15ap9.mjs";

package/dist/{execution-BGY24cO8.d.mts → execution-zVRllrpa.d.mts}

@@ -11,7 +11,7 @@ declare const ExecutionContext$1: ComponentContext<ExecutionContext<any, any, an
  * @returns The Execution context.
  * @throws An error if the execution context is not set.
  */
-declare function useExecution(): ExecutionContext<any, any, any>;
+declare function useExecution$1(): ExecutionContext<any, any, any>;
 /**
  * Hook to safely access the {@link ExecutionContext | Execution context}.
  *
@@ -19,5 +19,5 @@ declare function useExecution(): ExecutionContext<any, any, any>;
  */
 declare function useExecutionSafe(): ExecutionContext<any, any, any> | undefined;
 //#endregion
-export { useExecution as n, useExecutionSafe as r, ExecutionContext$1 as t };
-//# sourceMappingURL=execution-BGY24cO8.d.mts.map
+export { useExecution$1 as n, useExecutionSafe as r, ExecutionContext$1 as t };
+//# sourceMappingURL=execution-zVRllrpa.d.mts.map

package/dist/execution-zVRllrpa.d.mts.map

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

package/dist/index.cjs

@@ -1 +1 @@
-const e=require("./render.cjs");let t=require("@power-plant/core");var n=(0,t.defineGenerator)({meta:{name:`alloy-js`,description:`A generator that uses Alloy-js to generate source code from a specification.`,version:`1.0`,tags:[`alloy-js`],links:[{description:`Alloy-js Repository`,href:`https://github.com/alloy-framework/alloy`},{description:`Alloy-js Documentation`,href:`https://alloy-framework.github.io/alloy/guides/getting-started/`}]},generator:async(n,r)=>e.render((0,t.useExecutionContext)(),n,r.template)});module.exports=n;
+const e=require("./render.cjs");var t=(0,require("@power-plant/core").defineGenerator)({meta:{name:`alloy-js`,description:`A generator that uses Alloy-js to generate source code from a specification.`,version:`1.0`,tags:[`alloy-js`],links:[{description:`Alloy-js Repository`,href:`https://github.com/alloy-framework/alloy`},{description:`Alloy-js Documentation`,href:`https://alloy-framework.github.io/alloy/guides/getting-started/`}]},generator:async(t,n)=>e.render(n.template)});module.exports=t;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import{render as e}from"./render.mjs";import{defineGenerator as t,useExecutionContext as n}from"@power-plant/core";var r=t({meta:{name:`alloy-js`,description:`A generator that uses Alloy-js to generate source code from a specification.`,version:`1.0`,tags:[`alloy-js`],links:[{description:`Alloy-js Repository`,href:`https://github.com/alloy-framework/alloy`},{description:`Alloy-js Documentation`,href:`https://alloy-framework.github.io/alloy/guides/getting-started/`}]},generator:async(t,r)=>e(n(),t,r.template)});export{r as default};
+import{render as e}from"./render.mjs";import{defineGenerator as t}from"@power-plant/core";var n=t({meta:{name:`alloy-js`,description:`A generator that uses Alloy-js to generate source code from a specification.`,version:`1.0`,tags:[`alloy-js`],links:[{description:`Alloy-js Repository`,href:`https://github.com/alloy-framework/alloy`},{description:`Alloy-js Documentation`,href:`https://alloy-framework.github.io/alloy/guides/getting-started/`}]},generator:async(t,n)=>e(n.template)});export{n as default};
 //# sourceMappingURL=index.mjs.map

package/dist/render.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-CMqjfN_6.cjs"),t=require("./core/components/output.cjs");require("./core/index.cjs");let n=require("@alloy-js/core/jsx-runtime"),r=require("@alloy-js/core"),i=require("@stryke/helpers/noop"),a=require("@stryke/path/replace"),o=require("@stryke/string-format/list"),s=require("defu");s=e.t(s,1);async function c(e,c,l){let u={},{cwd:d,logger:f}=e,p=await(0,r.renderAsync)((0,n.createComponent)(t.Output,{context:e,spec:c,meta:u,children:l})),m=[];if(await(0,r.traverseOutput)(p,{visitDirectory:i.noop,visitFile:e=>m.push(e)}),!m.length)return f.debug(`No output files were rendered by the Alloy-js components.`),{};f.debug(`Rendering ${m.length} output files from Alloy-js components: ${(0,o.list)(m.map(e=>(0,a.replacePath)(e.path,d)))}.`);let h={},g={};await(0,r.traverseOutput)(p,{visitDirectory:i.noop,visitFile:e=>{if(`contents`in e){let t=u[e.path]??{};h[e.path]={path:e.path,chunks:[{content:e.contents,meta:t}]}}else e.sourcePath&&(g[e.sourcePath]=e.path)}});for(let[e,t]of Object.entries(g))if(h[e])h[t]={...h[e],path:t,chunks:h[e].chunks?.map(e=>(0,s.default)(e,{meta:u[t]??{}}))};else throw Error(`Source path ${e} not found in documents.`);return h}exports.render=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-CMqjfN_6.cjs"),t=require("./core/components/output.cjs");require("./core/index.cjs");let n=require("@alloy-js/core/jsx-runtime"),r=require("@alloy-js/core"),i=require("@power-plant/core"),a=require("@stryke/helpers/noop"),o=require("@stryke/path/replace"),s=require("@stryke/string-format/list"),c=require("defu");c=e.t(c,1);async function l(e,i){let l={},{cwd:u,logger:d}=e,f=await(0,r.renderAsync)((0,n.createComponent)(t.Output,{context:e,meta:l,children:i})),p=[];if(await(0,r.traverseOutput)(f,{visitDirectory:a.noop,visitFile:e=>p.push(e)}),!p.length)return d.debug(`No output files were rendered by the Alloy-js components.`),{};d.debug(`Rendering ${p.length} output files from Alloy-js components: ${(0,s.list)(p.map(e=>(0,o.replacePath)(e.path,u)))}.`);let m={},h={};await(0,r.traverseOutput)(f,{visitDirectory:a.noop,visitFile:e=>{if(`contents`in e){let t=l[e.path]??{};m[e.path]={path:e.path,chunks:[{content:e.contents,meta:t}]}}else e.sourcePath&&(h[e.sourcePath]=e.path)}});for(let[e,t]of Object.entries(h))if(m[e])m[t]={...m[e],path:t,chunks:m[e].chunks?.map(e=>(0,c.default)(e,{meta:l[t]??{}}))};else throw Error(`Source path ${e} not found in documents.`);return m}async function u(e){return l((0,i.useExecution)(),e)}exports.render=u,exports.renderBase=l;

package/dist/render.d.cts

@@ -8,14 +8,28 @@ import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
  * ```tsx
  * import { render } from "@power-plant/alloy-js/render";
  *
- * await render(context, spec, <> ... </>);
+ * await renderBase(context, <> ... </>);
  * ```
  *
  * @param context - The Power Plant execution context.
  * @param children - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function render<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, spec: TSpec, children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, children: 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.
+ *
+ * @example
+ * ```tsx
+ * import { render } from "@power-plant/alloy-js/render";
+ *
+ * await render(<> ... </>);
+ * ```
+ *
+ * @param children - 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>>;
 //#endregion
-export { render };
+export { render, renderBase };
 //# sourceMappingURL=render.d.cts.map

package/dist/render.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.cts","names":[],"sources":["../src/render.tsx"],"mappings":";;;;;;;;;;;;;;;;;iBA6CsB,OAAO,OAAO,yBAAyB,iBAC3D,SAAS,iBAAiB,OAAO,UAAU,WAC3C,MAAM,OACN,UAAU,WACT,QAAQ,wBAAwB,OAAO"}
+{"version":3,"file":"render.d.cts","names":[],"sources":["../src/render.tsx"],"mappings":";;;;;;;;;;;;;;;;;iBA8CsB,WACpB,OACA,yBACA,iBAEA,SAAS,iBAAiB,OAAO,UAAU,WAC3C,UAAU,WACT,QAAQ,wBAAwB,OAAO;;;;;;;;;;;;;;iBAkFpB,OAAO,OAAO,yBAAyB,iBAC3D,UAAU,WACT,QAAQ,wBAAwB,OAAO"}

package/dist/render.d.mts

@@ -8,14 +8,28 @@ import { ExecutionContext, GeneratorFunctionResult } from "@power-plant/core";
  * ```tsx
  * import { render } from "@power-plant/alloy-js/render";
  *
- * await render(context, spec, <> ... </>);
+ * await renderBase(context, <> ... </>);
  * ```
  *
  * @param context - The Power Plant execution context.
  * @param children - The children components to render.
  * @returns A promise that resolves when rendering is complete.
  */
-declare function render<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, spec: TSpec, children: Children): Promise<GeneratorFunctionResult<TSpec, TOptions>>;
+declare function renderBase<TSpec, TOptions extends object, TReturns = void>(context: ExecutionContext<TSpec, TOptions, TReturns>, children: 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.
+ *
+ * @example
+ * ```tsx
+ * import { render } from "@power-plant/alloy-js/render";
+ *
+ * await render(<> ... </>);
+ * ```
+ *
+ * @param children - 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>>;
 //#endregion
-export { render };
+export { render, renderBase };
 //# sourceMappingURL=render.d.mts.map

package/dist/render.mjs

@@ -1,2 +1,2 @@
-import{Output as e}from"./core/components/output.mjs";import"./core/index.mjs";import{createComponent as t}from"@alloy-js/core/jsx-runtime";import{renderAsync as n,traverseOutput as r}from"@alloy-js/core";import{noop as i}from"@stryke/helpers/noop";import{replacePath as a}from"@stryke/path/replace";import{list as o}from"@stryke/string-format/list";import s from"defu";async function c(c,l,u){let d={},{cwd:f,logger:p}=c,m=await n(t(e,{context:c,spec:l,meta:d,children:u})),h=[];if(await r(m,{visitDirectory:i,visitFile:e=>h.push(e)}),!h.length)return p.debug(`No output files were rendered by the Alloy-js components.`),{};p.debug(`Rendering ${h.length} output files from Alloy-js components: ${o(h.map(e=>a(e.path,f)))}.`);let g={},_={};await r(m,{visitDirectory:i,visitFile:e=>{if(`contents`in e){let t=d[e.path]??{};g[e.path]={path:e.path,chunks:[{content:e.contents,meta:t}]}}else e.sourcePath&&(_[e.sourcePath]=e.path)}});for(let[e,t]of Object.entries(_))if(g[e])g[t]={...g[e],path:t,chunks:g[e].chunks?.map(e=>s(e,{meta:d[t]??{}}))};else throw Error(`Source path ${e} not found in documents.`);return g}export{c as render};
+import{Output as e}from"./core/components/output.mjs";import"./core/index.mjs";import{createComponent as t}from"@alloy-js/core/jsx-runtime";import{renderAsync as n,traverseOutput as r}from"@alloy-js/core";import{useExecution as i}from"@power-plant/core";import{noop as a}from"@stryke/helpers/noop";import{replacePath as o}from"@stryke/path/replace";import{list as s}from"@stryke/string-format/list";import c from"defu";async function l(i,l){let u={},{cwd:d,logger:f}=i,p=await n(t(e,{context:i,meta:u,children:l})),m=[];if(await r(p,{visitDirectory:a,visitFile:e=>m.push(e)}),!m.length)return f.debug(`No output files were rendered by the Alloy-js components.`),{};f.debug(`Rendering ${m.length} output files from Alloy-js components: ${s(m.map(e=>o(e.path,d)))}.`);let h={},g={};await r(p,{visitDirectory:a,visitFile:e=>{if(`contents`in e){let t=u[e.path]??{};h[e.path]={path:e.path,chunks:[{content:e.contents,meta:t}]}}else e.sourcePath&&(g[e.sourcePath]=e.path)}});for(let[e,t]of Object.entries(g))if(h[e])h[t]={...h[e],path:t,chunks:h[e].chunks?.map(e=>c(e,{meta:u[t]??{}}))};else throw Error(`Source path ${e} not found in documents.`);return h}async function u(e){return l(i(),e)}export{u as render,l as renderBase};
 //# sourceMappingURL=render.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@power-plant/alloy-js",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "private": false,
   "description": "A Power Plant generator for using Alloy JS to generate source code.",
   "keywords": [
@@ -892,5 +892,5 @@
   "peerDependencies": { "@alloy-js/babel-preset": ">=0.3.0" },
   "peerDependenciesMeta": { "@alloy-js/babel-preset": { "optional": false } },
   "publishConfig": { "access": "public" },
-  "gitHead": "36bc90dee1e209badc95dcf08e563b403ad55886"
+  "gitHead": "79c19a661afc8b7f551988af50af27b372996e28"
 }

package/dist/execution-BGY24cO8.d.mts.map

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