@powerlines/plugin-alloy 0.26.75 → 0.26.77

package/dist/markdown/contexts/markdown-table.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"markdown-table.mjs","names":[],"sources":["../../../src/markdown/contexts/markdown-table.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createContext, createNamedContext, useContext } from \"@alloy-js/core\";\n\nexport interface MarkdownTableColumnContextInterface<\n  T extends Record<string, any> = Record<string, any>\n> {\n  index: number;\n  name: keyof T;\n  align: \"left\" | \"right\" | \"center\";\n  width: number;\n}\n\n/**\n * The Powerlines context used in template rendering.\n */\nexport const MarkdownTableColumnContext: ComponentContext<MarkdownTableColumnContextInterface> =\n  createNamedContext<MarkdownTableColumnContextInterface>(\n    \"MarkdownTableColumn\",\n    {} as MarkdownTableColumnContextInterface\n  );\n\n/**\n * Hook to access the Powerlines Context.\n *\n * @returns The Context.\n */\nexport function useMarkdownTableColumn() {\n  return useContext<MarkdownTableColumnContextInterface>(\n    MarkdownTableColumnContext\n  );\n}\n\nexport interface MarkdownTableContextInterface<\n  T extends Record<string, any> = Record<string, any>\n> {\n  columns: MarkdownTableColumnContextInterface<T>[];\n  data: T[];\n}\n\n/**\n * The Powerlines context used in template rendering.\n */\nexport const MarkdownTableContext: ComponentContext<MarkdownTableContextInterface> =\n  createContext<MarkdownTableContextInterface>({\n    columns: [],\n    data: []\n  });\n\n/**\n * Hook to access the Powerlines Context.\n *\n * @returns The Context.\n */\nexport function useMarkdownTable() {\n  return useContext<MarkdownTableContextInterface>(MarkdownTableContext);\n}\n"],"mappings":"uFAsBA,MAAY,EAA6B,EAAW,sBAAA,EAAA,CAAA,cAQlD,OAAA,EAAA,EAAA,CAKF,MAAK,EAAoB,EAAA,CACvB,QAAQ,EAAA,CACR,KAAC,EAAA,GAQH,SAAS,GAAW,CAClB,OAAE,EAAA,EAAA"}
+{"version":3,"file":"markdown-table.mjs","names":[],"sources":["../../../src/markdown/contexts/markdown-table.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createContext, createNamedContext, useContext } from \"@alloy-js/core\";\n\nexport interface MarkdownTableColumnContextInterface<\n  T extends Record<string, any> = Record<string, any>\n> {\n  index: number;\n  name: keyof T;\n  align: \"left\" | \"right\" | \"center\";\n  width: number;\n}\n\n/**\n * The Powerlines context used in template rendering.\n */\nexport const MarkdownTableColumnContext: ComponentContext<MarkdownTableColumnContextInterface> =\n  createNamedContext<MarkdownTableColumnContextInterface>(\n    \"MarkdownTableColumn\",\n    {} as MarkdownTableColumnContextInterface\n  );\n\n/**\n * Hook to access the Powerlines Context.\n *\n * @returns The Context.\n */\nexport function useMarkdownTableColumn() {\n  return useContext<MarkdownTableColumnContextInterface>(\n    MarkdownTableColumnContext\n  );\n}\n\nexport interface MarkdownTableContextInterface<\n  T extends Record<string, any> = Record<string, any>\n> {\n  columns: MarkdownTableColumnContextInterface<T>[];\n  data: T[];\n}\n\n/**\n * The Powerlines context used in template rendering.\n */\nexport const MarkdownTableContext: ComponentContext<MarkdownTableContextInterface> =\n  createContext<MarkdownTableContextInterface>({\n    columns: [],\n    data: []\n  });\n\n/**\n * Hook to access the Powerlines Context.\n *\n * @returns The Context.\n */\nexport function useMarkdownTable() {\n  return useContext<MarkdownTableContextInterface>(MarkdownTableContext);\n}\n"],"mappings":";;;;;;AAsBA,MAAY,6BAA6B,mBAAW,uBAAA,EAAA,CAAA;;;;;;;AAQlD,QAAA,WAAA,2BAAA;;;;;AAKF,MAAK,uBAAoB,cAAA;CACvB,SAAQ,EAAA;CACR,MAAC,EAAA;;;;;;;AAQH,SAAS,mBAAW;AAClB,QAAE,WAAA,qBAAA"}

package/dist/markdown/index.cjs

@@ -1 +1,20 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./components/front-matter.cjs`),t=require(`./components/heading.cjs`),n=require(`./components/markdown-file.cjs`),r=require(`./contexts/markdown-table.cjs`),i=require(`./components/markdown-table.cjs`);require(`./components/index.cjs`),require(`./contexts/index.cjs`),exports.FrontMatter=e.FrontMatter,exports.Heading=t.Heading,exports.MarkdownFile=n.MarkdownFile,exports.MarkdownFileHeader=n.MarkdownFileHeader,exports.MarkdownTable=i.MarkdownTable,exports.MarkdownTableColumn=i.MarkdownTableColumn,exports.MarkdownTableColumnContext=r.MarkdownTableColumnContext,exports.MarkdownTableColumnHeader=i.MarkdownTableColumnHeader,exports.MarkdownTableContext=r.MarkdownTableContext,exports.useMarkdownTable=r.useMarkdownTable,exports.useMarkdownTableColumn=r.useMarkdownTableColumn;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_markdown_components_front_matter = require('./components/front-matter.cjs');
+const require_markdown_components_heading = require('./components/heading.cjs');
+const require_markdown_components_markdown_file = require('./components/markdown-file.cjs');
+const require_markdown_contexts_markdown_table = require('./contexts/markdown-table.cjs');
+const require_markdown_components_markdown_table = require('./components/markdown-table.cjs');
+require('./components/index.cjs');
+require('./contexts/index.cjs');
+
+exports.FrontMatter = require_markdown_components_front_matter.FrontMatter;
+exports.Heading = require_markdown_components_heading.Heading;
+exports.MarkdownFile = require_markdown_components_markdown_file.MarkdownFile;
+exports.MarkdownFileHeader = require_markdown_components_markdown_file.MarkdownFileHeader;
+exports.MarkdownTable = require_markdown_components_markdown_table.MarkdownTable;
+exports.MarkdownTableColumn = require_markdown_components_markdown_table.MarkdownTableColumn;
+exports.MarkdownTableColumnContext = require_markdown_contexts_markdown_table.MarkdownTableColumnContext;
+exports.MarkdownTableColumnHeader = require_markdown_components_markdown_table.MarkdownTableColumnHeader;
+exports.MarkdownTableContext = require_markdown_contexts_markdown_table.MarkdownTableContext;
+exports.useMarkdownTable = require_markdown_contexts_markdown_table.useMarkdownTable;
+exports.useMarkdownTableColumn = require_markdown_contexts_markdown_table.useMarkdownTableColumn;

package/dist/markdown/index.mjs

@@ -1 +1,9 @@
-import{FrontMatter as e}from"./components/front-matter.mjs";import{Heading as t}from"./components/heading.mjs";import{MarkdownFile as n,MarkdownFileHeader as r}from"./components/markdown-file.mjs";import{MarkdownTableColumnContext as i,MarkdownTableContext as a,useMarkdownTable as o,useMarkdownTableColumn as s}from"./contexts/markdown-table.mjs";import{MarkdownTable as c,MarkdownTableColumn as l,MarkdownTableColumnHeader as u}from"./components/markdown-table.mjs";import"./components/index.mjs";import"./contexts/index.mjs";export{e as FrontMatter,t as Heading,n as MarkdownFile,r as MarkdownFileHeader,c as MarkdownTable,l as MarkdownTableColumn,i as MarkdownTableColumnContext,u as MarkdownTableColumnHeader,a as MarkdownTableContext,o as useMarkdownTable,s as useMarkdownTableColumn};
+import { FrontMatter } from "./components/front-matter.mjs";
+import { Heading } from "./components/heading.mjs";
+import { MarkdownFile, MarkdownFileHeader } from "./components/markdown-file.mjs";
+import { MarkdownTableColumnContext, MarkdownTableContext, useMarkdownTable, useMarkdownTableColumn } from "./contexts/markdown-table.mjs";
+import { MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader } from "./components/markdown-table.mjs";
+import "./components/index.mjs";
+import "./contexts/index.mjs";
+
+export { FrontMatter, Heading, MarkdownFile, MarkdownFileHeader, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnContext, MarkdownTableColumnHeader, MarkdownTableContext, useMarkdownTable, useMarkdownTableColumn };

package/dist/render.cjs

@@ -1 +1,91 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./_virtual/_rolldown/runtime.cjs`);const e=require(`./core/components/output.cjs`);require(`./core/index.cjs`);let t=require(`@stryke/path/file-path-fns`),n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`);async function i(i,a){let o={},s=await(0,r.renderAsync)((0,n.createComponent)(e.Output,{context:i,meta:o,children:a}));Object.keys(s).length?(i.debug(`Processing ${Object.keys(s).length} rendered output files from Alloy-js component templates.`),await(0,r.traverseOutput)(s,{visitDirectory:e=>{i.fs.existsSync(e.path)||i.fs.mkdirSync(e.path)},visitFile:e=>{if(`contents`in e){let n=o[e.path]??{};if(n.kind===`builtin`){if(!n.id)throw Error(`Built-in file "${e.path}" is missing its ID in the render metadata.`);i.emitBuiltinSync(e.contents,n.id,{skipFormat:n.skipFormat,storage:n.storage,extension:(0,t.findFileExtension)(e.path)})}else if(n.kind===`entry`)i.emitEntrySync(e.contents,e.path,{skipFormat:n.skipFormat,storage:n.storage,...n.typeDefinition??{}});else if(n.kind===`infrastructure`){if(!n.id)throw Error(`Infrastructure file "${e.path}" is missing its ID in the render metadata.`);i.emitInfrastructureSync(e.contents,n.id,{skipFormat:n.skipFormat,storage:n.storage,extension:(0,t.findFileExtension)(e.path)})}else i.emitSync(e.contents,e.path,n)}else i.fs.copySync(e.sourcePath,e.path)}})):i.debug(`No output files were rendered by Alloy-js component templates.`)}function a(t,i,a){return(0,r.printTree)((0,r.renderTree)((0,n.createComponent)(e.Output,{context:t,children:i})),a)}exports.render=i,exports.renderString=a;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_core_components_output = require('./core/components/output.cjs');
+require('./core/index.cjs');
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+
+//#region src/render.tsx
+/**
+* A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and write any saved content to the file system.
+*
+* @example
+* ```tsx
+* import { render } from "@powerlines/plugin-alloy/render";
+*
+* await render(context, <> ... </>);
+* ```
+*
+* @param context - The Powerlines plugin context.
+* @param children - The children components to render.
+* @returns A promise that resolves when rendering is complete.
+*/
+async function render(context, children) {
+	const meta = {};
+	const output = await (0, _alloy_js_core.renderAsync)((0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_output.Output, {
+		context,
+		meta,
+		children
+	}));
+	if (!Object.keys(output).length) context.debug("No output files were rendered by Alloy-js component templates.");
+	else {
+		context.debug(`Processing ${Object.keys(output).length} rendered output files from Alloy-js component templates.`);
+		await (0, _alloy_js_core.traverseOutput)(output, {
+			visitDirectory: (directory) => {
+				if (context.fs.existsSync(directory.path)) return;
+				context.fs.mkdirSync(directory.path);
+			},
+			visitFile: (file) => {
+				if ("contents" in file) {
+					const metadata = meta[file.path] ?? {};
+					if (metadata.kind === "builtin") {
+						if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+						context.emitBuiltinSync(file.contents, metadata.id, {
+							skipFormat: metadata.skipFormat,
+							storage: metadata.storage,
+							extension: (0, _stryke_path_file_path_fns.findFileExtension)(file.path)
+						});
+					} else if (metadata.kind === "entry") context.emitEntrySync(file.contents, file.path, {
+						skipFormat: metadata.skipFormat,
+						storage: metadata.storage,
+						...metadata.typeDefinition ?? {}
+					});
+					else if (metadata.kind === "infrastructure") {
+						if (!metadata.id) throw new Error(`Infrastructure file "${file.path}" is missing its ID in the render metadata.`);
+						context.emitInfrastructureSync(file.contents, metadata.id, {
+							skipFormat: metadata.skipFormat,
+							storage: metadata.storage,
+							extension: (0, _stryke_path_file_path_fns.findFileExtension)(file.path)
+						});
+					} else context.emitSync(file.contents, file.path, metadata);
+				} else context.fs.copySync(file.sourcePath, file.path);
+			}
+		});
+	}
+}
+/**
+* A function to render children components within the [Alloy](https://alloy-framework.github.io) context and return the rendered output as a string.
+*
+* @example
+* ```tsx
+* import { renderString } from "@powerlines/plugin-alloy/render";
+*
+* const output = await renderString(context, <> ... </>);
+* ```
+*
+* @param context - The Powerlines plugin context.
+* @param children - The children components to render.
+* @param options - Optional print tree options.
+* @returns The rendered output as a string.
+*/
+function renderString(context, children, options) {
+	return (0, _alloy_js_core.printTree)((0, _alloy_js_core.renderTree)((0, _alloy_js_core_jsx_runtime.createComponent)(require_core_components_output.Output, {
+		context,
+		children
+	})), options);
+}
+
+//#endregion
+exports.render = render;
+exports.renderString = renderString;

package/dist/render.mjs

@@ -1,2 +1,89 @@
-import{Output as e}from"./core/components/output.mjs";import"./core/index.mjs";import{findFileExtension as t}from"@stryke/path/file-path-fns";import{createComponent as n}from"@alloy-js/core/jsx-runtime";import{printTree as r,renderAsync as i,renderTree as a,traverseOutput as o}from"@alloy-js/core";async function s(r,a){let s={},c=await i(n(e,{context:r,meta:s,children:a}));Object.keys(c).length?(r.debug(`Processing ${Object.keys(c).length} rendered output files from Alloy-js component templates.`),await o(c,{visitDirectory:e=>{r.fs.existsSync(e.path)||r.fs.mkdirSync(e.path)},visitFile:e=>{if(`contents`in e){let n=s[e.path]??{};if(n.kind===`builtin`){if(!n.id)throw Error(`Built-in file "${e.path}" is missing its ID in the render metadata.`);r.emitBuiltinSync(e.contents,n.id,{skipFormat:n.skipFormat,storage:n.storage,extension:t(e.path)})}else if(n.kind===`entry`)r.emitEntrySync(e.contents,e.path,{skipFormat:n.skipFormat,storage:n.storage,...n.typeDefinition??{}});else if(n.kind===`infrastructure`){if(!n.id)throw Error(`Infrastructure file "${e.path}" is missing its ID in the render metadata.`);r.emitInfrastructureSync(e.contents,n.id,{skipFormat:n.skipFormat,storage:n.storage,extension:t(e.path)})}else r.emitSync(e.contents,e.path,n)}else r.fs.copySync(e.sourcePath,e.path)}})):r.debug(`No output files were rendered by Alloy-js component templates.`)}function c(t,i,o){return r(a(n(e,{context:t,children:i})),o)}export{s as render,c as renderString};
+import { Output as Output$1 } from "./core/components/output.mjs";
+import "./core/index.mjs";
+import { findFileExtension } from "@stryke/path/file-path-fns";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { printTree, renderAsync, renderTree, traverseOutput } from "@alloy-js/core";
+
+//#region src/render.tsx
+/**
+* A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and write any saved content to the file system.
+*
+* @example
+* ```tsx
+* import { render } from "@powerlines/plugin-alloy/render";
+*
+* await render(context, <> ... </>);
+* ```
+*
+* @param context - The Powerlines plugin context.
+* @param children - The children components to render.
+* @returns A promise that resolves when rendering is complete.
+*/
+async function render(context, children) {
+	const meta = {};
+	const output = await renderAsync(createComponent(Output$1, {
+		context,
+		meta,
+		children
+	}));
+	if (!Object.keys(output).length) context.debug("No output files were rendered by Alloy-js component templates.");
+	else {
+		context.debug(`Processing ${Object.keys(output).length} rendered output files from Alloy-js component templates.`);
+		await traverseOutput(output, {
+			visitDirectory: (directory) => {
+				if (context.fs.existsSync(directory.path)) return;
+				context.fs.mkdirSync(directory.path);
+			},
+			visitFile: (file) => {
+				if ("contents" in file) {
+					const metadata = meta[file.path] ?? {};
+					if (metadata.kind === "builtin") {
+						if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+						context.emitBuiltinSync(file.contents, metadata.id, {
+							skipFormat: metadata.skipFormat,
+							storage: metadata.storage,
+							extension: findFileExtension(file.path)
+						});
+					} else if (metadata.kind === "entry") context.emitEntrySync(file.contents, file.path, {
+						skipFormat: metadata.skipFormat,
+						storage: metadata.storage,
+						...metadata.typeDefinition ?? {}
+					});
+					else if (metadata.kind === "infrastructure") {
+						if (!metadata.id) throw new Error(`Infrastructure file "${file.path}" is missing its ID in the render metadata.`);
+						context.emitInfrastructureSync(file.contents, metadata.id, {
+							skipFormat: metadata.skipFormat,
+							storage: metadata.storage,
+							extension: findFileExtension(file.path)
+						});
+					} else context.emitSync(file.contents, file.path, metadata);
+				} else context.fs.copySync(file.sourcePath, file.path);
+			}
+		});
+	}
+}
+/**
+* A function to render children components within the [Alloy](https://alloy-framework.github.io) context and return the rendered output as a string.
+*
+* @example
+* ```tsx
+* import { renderString } from "@powerlines/plugin-alloy/render";
+*
+* const output = await renderString(context, <> ... </>);
+* ```
+*
+* @param context - The Powerlines plugin context.
+* @param children - The children components to render.
+* @param options - Optional print tree options.
+* @returns The rendered output as a string.
+*/
+function renderString(context, children, options) {
+	return printTree(renderTree(createComponent(Output$1, {
+		context,
+		children
+	})), options);
+}
+
+//#endregion
+export { render, renderString };
 //# sourceMappingURL=render.mjs.map

package/dist/render.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"render.mjs","names":[],"sources":["../src/render.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  printTree,\n  PrintTreeOptions,\n  renderAsync,\n  renderTree,\n  traverseOutput\n} from \"@alloy-js/core\";\nimport { findFileExtension } from \"@stryke/path/file-path-fns\";\nimport { PluginContext } from \"powerlines\";\nimport { MetaItem, Output } from \"./core\";\n\n/**\n * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and write any saved content to the file system.\n *\n * @example\n * ```tsx\n * import { render } from \"@powerlines/plugin-alloy/render\";\n *\n * await render(context, <> ... </>);\n * ```\n *\n * @param context - The Powerlines plugin context.\n * @param children - The children components to render.\n * @returns A promise that resolves when rendering is complete.\n */\nexport async function render<TContext extends PluginContext>(\n  context: TContext,\n  children: Children\n) {\n  const meta = {} as Record<string, MetaItem>;\n  const output = await renderAsync(\n    <Output<TContext> context={context} meta={meta}>\n      {children}\n    </Output>\n  );\n\n  if (!Object.keys(output).length) {\n    context.debug(\n      \"No output files were rendered by Alloy-js component templates.\"\n    );\n  } else {\n    context.debug(\n      `Processing ${\n        Object.keys(output).length\n      } rendered output files from Alloy-js component templates.`\n    );\n\n    await traverseOutput(output, {\n      visitDirectory: directory => {\n        if (context.fs.existsSync(directory.path)) {\n          return;\n        }\n\n        context.fs.mkdirSync(directory.path);\n      },\n      visitFile: file => {\n        if (\"contents\" in file) {\n          const metadata = meta[file.path] ?? {};\n          if (metadata.kind === \"builtin\") {\n            if (!metadata.id) {\n              throw new Error(\n                `Built-in file \"${\n                  file.path\n                }\" is missing its ID in the render metadata.`\n              );\n            }\n\n            context.emitBuiltinSync(file.contents, metadata.id, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              extension: findFileExtension(file.path)\n            });\n          } else if (metadata.kind === \"entry\") {\n            context.emitEntrySync(file.contents, file.path, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              ...(metadata.typeDefinition ?? {})\n            });\n          } else if (metadata.kind === \"infrastructure\") {\n            if (!metadata.id) {\n              throw new Error(\n                `Infrastructure file \"${\n                  file.path\n                }\" is missing its ID in the render metadata.`\n              );\n            }\n\n            context.emitInfrastructureSync(file.contents, metadata.id, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              extension: findFileExtension(file.path)\n            });\n          } else {\n            context.emitSync(file.contents, file.path, metadata);\n          }\n        } else {\n          context.fs.copySync(file.sourcePath, file.path);\n        }\n      }\n    });\n  }\n}\n\n/**\n * A function to render children components within the [Alloy](https://alloy-framework.github.io) context and return the rendered output as a string.\n *\n * @example\n * ```tsx\n * import { renderString } from \"@powerlines/plugin-alloy/render\";\n *\n * const output = await renderString(context, <> ... </>);\n * ```\n *\n * @param context - The Powerlines plugin context.\n * @param children - The children components to render.\n * @param options - Optional print tree options.\n * @returns The rendered output as a string.\n */\nexport function renderString<TContext extends PluginContext>(\n  context: TContext,\n  children: Children,\n  options?: PrintTreeOptions\n) {\n  const tree = renderTree(\n    <Output<TContext> context={context}>{children}</Output>\n  );\n\n  return printTree(tree, options);\n}\n"],"mappings":"2SAsCA,eAAK,EAAA,EAAA,EAAA,CACJ,IAAA,EAAA,EAAA,CACG,EAAa,MAAM,EAAY,EAAc,EAAA,CACvC,UACN,OACF,WACF,CAAA,CAAA,CACE,OAAS,KAAQ,EAAA,CAAA,QAGjB,EAAU,MAAM,cAAU,OAAQ,KAAQ,EAAC,CAAA,OAAA,2DAAA,CAC3C,MAAM,EAAe,EAAA,CAClB,eAAiB,GAAS,CACxB,EAAQ,GAAA,WAAA,EAAA,KAAA,0BAKX,UAAa,GAAA,CACV,GAAG,aAAa,EAAK,CACvB,IAAA,EAAA,EAAA,EAAA,OAAA,EAAA,CACI,GAAA,EAAA,OAAA,UAAA,CACG,GAAA,CAAK,EAAA,GACV,MAAY,MAAA,kBAAA,EAAA,KAAA,6CAAA,CAEX,EAAS,gBAAkB,EAAM,SAAG,EAAU,GAAU,CAC3D,WAAA,EAAA,6BAEK,UAAe,EAAQ,EAAA,KAAA,CAC3B,CAAA,SACc,EAAG,OAAW,QACxB,EAAM,cAAA,EAAA,SAAA,EAAA,KAAA,CACR,WAAA,EAAA,6BAEA,GAAU,EAAC,gBAAyB,EAAA,CACrC,CAAA,SACc,EAAI,OAAA,iBAAA,CACb,GAAC,CAAA,EAAa,GAChB,MAAc,MAAG,wBAAqB,EAAA,KAAA,6CAAA,CAEpC,EAAK,uBAAa,EAAA,SAAA,EAAA,GAAA,CAChB,WAAU,EAAK,WACf,QAAS,EAAS,QAClB,UAAS,EAAA,EAAA,KAAA,CACV,CAAC,MAEF,EAAA,SAAA,EAAA,SAAA,EAAA,KAAA,EAAA,MAGF,EAAI,GAAA,SAAY,EAAS,WAAU,EAAA,KAAA,EAGxC,CAAC,EA5CJ,EAAU,MAAA,iEAAA,CA+DZ,SAAc,EAAW,EAAA,EAAuB,EAAI,CAKlD,OAAO,EAJK,EAAA,EAAA,EAAA,CACF,UACA,WACT,CAAC,CACW,CAAA,EAAA"}
+{"version":3,"file":"render.mjs","names":[],"sources":["../src/render.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  Children,\n  printTree,\n  PrintTreeOptions,\n  renderAsync,\n  renderTree,\n  traverseOutput\n} from \"@alloy-js/core\";\nimport { findFileExtension } from \"@stryke/path/file-path-fns\";\nimport { PluginContext } from \"powerlines\";\nimport { MetaItem, Output } from \"./core\";\n\n/**\n * A function to render children components within the [Alloy](https://alloy-framework.github.io) context, and write any saved content to the file system.\n *\n * @example\n * ```tsx\n * import { render } from \"@powerlines/plugin-alloy/render\";\n *\n * await render(context, <> ... </>);\n * ```\n *\n * @param context - The Powerlines plugin context.\n * @param children - The children components to render.\n * @returns A promise that resolves when rendering is complete.\n */\nexport async function render<TContext extends PluginContext>(\n  context: TContext,\n  children: Children\n) {\n  const meta = {} as Record<string, MetaItem>;\n  const output = await renderAsync(\n    <Output<TContext> context={context} meta={meta}>\n      {children}\n    </Output>\n  );\n\n  if (!Object.keys(output).length) {\n    context.debug(\n      \"No output files were rendered by Alloy-js component templates.\"\n    );\n  } else {\n    context.debug(\n      `Processing ${\n        Object.keys(output).length\n      } rendered output files from Alloy-js component templates.`\n    );\n\n    await traverseOutput(output, {\n      visitDirectory: directory => {\n        if (context.fs.existsSync(directory.path)) {\n          return;\n        }\n\n        context.fs.mkdirSync(directory.path);\n      },\n      visitFile: file => {\n        if (\"contents\" in file) {\n          const metadata = meta[file.path] ?? {};\n          if (metadata.kind === \"builtin\") {\n            if (!metadata.id) {\n              throw new Error(\n                `Built-in file \"${\n                  file.path\n                }\" is missing its ID in the render metadata.`\n              );\n            }\n\n            context.emitBuiltinSync(file.contents, metadata.id, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              extension: findFileExtension(file.path)\n            });\n          } else if (metadata.kind === \"entry\") {\n            context.emitEntrySync(file.contents, file.path, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              ...(metadata.typeDefinition ?? {})\n            });\n          } else if (metadata.kind === \"infrastructure\") {\n            if (!metadata.id) {\n              throw new Error(\n                `Infrastructure file \"${\n                  file.path\n                }\" is missing its ID in the render metadata.`\n              );\n            }\n\n            context.emitInfrastructureSync(file.contents, metadata.id, {\n              skipFormat: metadata.skipFormat,\n              storage: metadata.storage,\n              extension: findFileExtension(file.path)\n            });\n          } else {\n            context.emitSync(file.contents, file.path, metadata);\n          }\n        } else {\n          context.fs.copySync(file.sourcePath, file.path);\n        }\n      }\n    });\n  }\n}\n\n/**\n * A function to render children components within the [Alloy](https://alloy-framework.github.io) context and return the rendered output as a string.\n *\n * @example\n * ```tsx\n * import { renderString } from \"@powerlines/plugin-alloy/render\";\n *\n * const output = await renderString(context, <> ... </>);\n * ```\n *\n * @param context - The Powerlines plugin context.\n * @param children - The children components to render.\n * @param options - Optional print tree options.\n * @returns The rendered output as a string.\n */\nexport function renderString<TContext extends PluginContext>(\n  context: TContext,\n  children: Children,\n  options?: PrintTreeOptions\n) {\n  const tree = renderTree(\n    <Output<TContext> context={context}>{children}</Output>\n  );\n\n  return printTree(tree, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsCA,eAAK,OAAA,SAAA,UAAA;CACJ,MAAA,OAAA,EAAA;CACC,MAAE,SAAa,MAAM,YAAY,gBAAc,UAAA;EACvC;EACN;EACF;EACF,CAAA,CAAA;AACE,KAAA,CAAA,OAAS,KAAQ,OAAA,CAAA,OACjB,SAAU,MAAA,iEAAA;MACV;AACA,UAAU,MAAM,cAAU,OAAQ,KAAQ,OAAC,CAAA,OAAA,2DAAA;AAC3C,QAAM,eAAe,QAAA;GAClB,iBAAiB,cAAS;AACxB,QAAA,QAAQ,GAAA,WAAA,UAAA,KAAA,CACT;;;GAIF,YAAa,SAAA;AACV,QAAG,cAAa,MAAK;KACvB,MAAA,WAAA,KAAA,KAAA,SAAA,EAAA;AACI,SAAA,SAAA,SAAA,WAAA;AACG,UAAA,CAAK,SAAA,GACV,OAAY,IAAA,MAAA,kBAAA,KAAA,KAAA,6CAAA;AAEX,cAAS,gBAAkB,KAAM,UAAG,SAAU,IAAU;OAC3D,YAAA,SAAA;;OAEK,WAAe,kBAAQ,KAAA,KAAA;OAC3B,CAAA;gBACc,SAAG,SAAW,QACxB,SAAM,cAAA,KAAA,UAAA,KAAA,MAAA;MACR,YAAA,SAAA;;MAEA,GAAU,SAAC,kBAAyB,EAAA;MACrC,CAAA;cACc,SAAI,SAAA,kBAAA;AACb,UAAC,CAAA,SAAa,GAChB,OAAM,IAAQ,MAAG,wBAAqB,KAAA,KAAA,6CAAA;AAEpC,cAAK,uBAAa,KAAA,UAAA,SAAA,IAAA;OAChB,YAAU,SAAK;OACf,SAAS,SAAS;OAClB,WAAS,kBAAA,KAAA,KAAA;OACV,CAAC;WAEF,SAAA,SAAA,KAAA,UAAA,KAAA,MAAA,SAAA;UAGF,SAAI,GAAA,SAAY,KAAS,YAAU,KAAA,KAAA;;GAGxC,CAAC;;;;;;;;;;;;;;;;;;AAmBN,SAAc,aAAW,SAAA,UAAuB,SAAI;AAKlD,QAAO,UAJK,WAAA,gBAAA,UAAA;EACF;EACA;EACT,CAAC,CACW,EAAA,QAAA"}

package/dist/types/components.cjs

@@ -0,0 +1,9 @@
+
+//#region src/types/components.ts
+/**
+* A type that represents the props of a component that can have children.
+*/
+/**
+* A type that requires the `children` prop in a component.
+*/
+//#endregion

package/dist/types/components.mjs

@@ -1,2 +1,10 @@
-export{};
+//#region src/types/components.ts
+/**
+* A type that represents the props of a component that can have children.
+*/
+/**
+* A type that requires the `children` prop in a component.
+*/
+//#endregion
+export {  };
 //# sourceMappingURL=components.mjs.map

package/dist/types/index.mjs

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

package/dist/types/plugin.mjs

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

package/dist/typescript/components/builtin-file.cjs

@@ -1 +1,63 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../../core/contexts/context.cjs`),t=require(`./tsdoc.cjs`),n=require(`./typescript-file.cjs`);let r=require(`@stryke/path/file-path-fns`),i=require(`@alloy-js/core/jsx-runtime`),a=require(`@alloy-js/core`),o=require(`@stryke/path/replace`),s=require(`@stryke/type-checks/is-set`);function c(c){let[{children:l,imports:u,builtinImports:d,id:f,description:p,tsx:m},h]=(0,a.splitProps)(c,[`children`,`imports`,`builtinImports`,`id`,`description`,`tsx`]),g=e.usePowerlinesSafe(),_=(0,a.computed)(()=>(0,o.replacePath)(`${(0,s.isSet)(m)?(0,o.replaceExtension)(f):f}${(0,r.hasFileExtension)(f)&&!(0,s.isSet)(m)?``:m?`.tsx`:`.ts`}`,g?.builtinsPath));return(0,i.createComponent)(n.TypescriptFile,(0,i.mergeProps)({get header(){return(0,i.createComponent)(n.TypescriptFileHeader,{get header(){return(0,i.createComponent)(t.TSDocModule,{name:f,children:p})},get children(){return(0,i.createComponent)(n.TypescriptFileHeaderImports,{imports:u,builtinImports:d})}})},get meta(){return{kind:`builtin`,extension:m?`tsx`:`ts`,id:(0,o.replaceExtension)(f)}}},h,{get path(){return _.value},children:l}))}exports.BuiltinFile=c;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_core_contexts_context = require('../../core/contexts/context.cjs');
+const require_typescript_components_tsdoc = require('./tsdoc.cjs');
+const require_typescript_components_typescript_file = require('./typescript-file.cjs');
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+
+//#region src/typescript/components/builtin-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function BuiltinFile(props) {
+	const [{ children, imports, builtinImports, id, description, tsx }, rest] = (0, _alloy_js_core.splitProps)(props, [
+		"children",
+		"imports",
+		"builtinImports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = require_core_contexts_context.usePowerlinesSafe();
+	const path = (0, _alloy_js_core.computed)(() => (0, _stryke_path_replace.replacePath)(`${!(0, _stryke_type_checks_is_set.isSet)(tsx) ? id : (0, _stryke_path_replace.replaceExtension)(id)}${(0, _stryke_path_file_path_fns.hasFileExtension)(id) && !(0, _stryke_type_checks_is_set.isSet)(tsx) ? "" : tsx ? ".tsx" : ".ts"}`, context?.builtinsPath));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		get header() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFileHeader, {
+				get header() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocModule, {
+						name: id,
+						children: description
+					});
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFileHeaderImports, {
+						imports,
+						builtinImports
+					});
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				extension: tsx ? "tsx" : "ts",
+				id: (0, _stryke_path_replace.replaceExtension)(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+exports.BuiltinFile = BuiltinFile;

package/dist/typescript/components/builtin-file.mjs

@@ -1,2 +1,62 @@
-import{usePowerlinesSafe as e}from"../../core/contexts/context.mjs";import{TSDocModule as t}from"./tsdoc.mjs";import{TypescriptFile as n,TypescriptFileHeader as r,TypescriptFileHeaderImports as i}from"./typescript-file.mjs";import{hasFileExtension as a}from"@stryke/path/file-path-fns";import{createComponent as o,mergeProps as s}from"@alloy-js/core/jsx-runtime";import{computed as c,splitProps as l}from"@alloy-js/core";import{replaceExtension as u,replacePath as d}from"@stryke/path/replace";import{isSet as f}from"@stryke/type-checks/is-set";function p(p){let[{children:m,imports:h,builtinImports:g,id:_,description:v,tsx:y},b]=l(p,[`children`,`imports`,`builtinImports`,`id`,`description`,`tsx`]),x=e(),S=c(()=>d(`${f(y)?u(_):_}${a(_)&&!f(y)?``:y?`.tsx`:`.ts`}`,x?.builtinsPath));return o(n,s({get header(){return o(r,{get header(){return o(t,{name:_,children:v})},get children(){return o(i,{imports:h,builtinImports:g})}})},get meta(){return{kind:`builtin`,extension:y?`tsx`:`ts`,id:u(_)}}},b,{get path(){return S.value},children:m}))}export{p as BuiltinFile};
+import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
+import { TSDocModule } from "./tsdoc.mjs";
+import { TypescriptFile, TypescriptFileHeader, TypescriptFileHeaderImports } from "./typescript-file.mjs";
+import { hasFileExtension } from "@stryke/path/file-path-fns";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { computed, splitProps } from "@alloy-js/core";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { isSet } from "@stryke/type-checks/is-set";
+
+//#region src/typescript/components/builtin-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function BuiltinFile(props) {
+	const [{ children, imports, builtinImports, id, description, tsx }, rest] = splitProps(props, [
+		"children",
+		"imports",
+		"builtinImports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = usePowerlinesSafe();
+	const path = computed(() => replacePath(`${!isSet(tsx) ? id : replaceExtension(id)}${hasFileExtension(id) && !isSet(tsx) ? "" : tsx ? ".tsx" : ".ts"}`, context?.builtinsPath));
+	return createComponent(TypescriptFile, mergeProps({
+		get header() {
+			return createComponent(TypescriptFileHeader, {
+				get header() {
+					return createComponent(TSDocModule, {
+						name: id,
+						children: description
+					});
+				},
+				get children() {
+					return createComponent(TypescriptFileHeaderImports, {
+						imports,
+						builtinImports
+					});
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				extension: tsx ? "tsx" : "ts",
+				id: replaceExtension(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+export { BuiltinFile };
 //# sourceMappingURL=builtin-file.mjs.map

package/dist/typescript/components/builtin-file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-file.mjs","names":[],"sources":["../../../src/typescript/components/builtin-file.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { computed, splitProps } from \"@alloy-js/core\";\nimport { hasFileExtension } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension, replacePath } from \"@stryke/path/replace\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport type { TSDocModuleProps } from \"./tsdoc\";\nimport { TSDocModule } from \"./tsdoc\";\nimport {\n  TypescriptFile,\n  TypescriptFileHeader,\n  TypescriptFileHeaderImports,\n  TypescriptFileProps\n} from \"./typescript-file\";\n\nexport type BuiltinFileProps = Omit<TypescriptFileProps, \"path\"> &\n  Omit<TSDocModuleProps, \"name\"> & {\n    /**\n     * The runtime module identifier.\n     *\n     * @remarks\n     * This value will be included after the \\`storm:\\` prefix in the import statement.\n     */\n    id: string;\n\n    /**\n     * The description for the builtin module.\n     */\n    description?: string;\n\n    /**\n     * Whether the file is a TSX file.\n     *\n     * @defaultValue false\n     */\n    tsx?: boolean;\n  };\n\n/**\n * A base component representing a Powerlines generated Typescript source file.\n *\n * @param props - The properties for the source file.\n * @returns The rendered source file component.\n */\nexport function BuiltinFile(props: BuiltinFileProps) {\n  const [{ children, imports, builtinImports, id, description, tsx }, rest] =\n    splitProps(props, [\n      \"children\",\n      \"imports\",\n      \"builtinImports\",\n      \"id\",\n      \"description\",\n      \"tsx\"\n    ]);\n\n  const context = usePowerlinesSafe();\n  const path = computed(() =>\n    replacePath(\n      `${!isSet(tsx) ? id : replaceExtension(id)}${\n        hasFileExtension(id) && !isSet(tsx) ? \"\" : tsx ? \".tsx\" : \".ts\"\n      }`,\n      context?.builtinsPath\n    )\n  );\n\n  return (\n    <TypescriptFile\n      header={\n        <TypescriptFileHeader\n          header={<TSDocModule name={id}>{description}</TSDocModule>}>\n          <TypescriptFileHeaderImports\n            imports={imports}\n            builtinImports={builtinImports}\n          />\n        </TypescriptFileHeader>\n      }\n      meta={{\n        kind: \"builtin\",\n        extension: tsx ? \"tsx\" : \"ts\",\n        id: replaceExtension(id)\n      }}\n      {...rest}\n      path={path.value}>\n      {children}\n    </TypescriptFile>\n  );\n}\n"],"mappings":"iiBAgCA,SAAY,EAAgB,EAAO,CACjC,GAAK,CAAA,CACH,WACA,UACA,iBACA,KACA,cACA,OACA,GAAI,EAAM,EAAA,CAAA,WAAA,UAAA,iBAAA,KAAA,cAAA,MAAA,CAAA,OAER,EAAA,MAAA,EAAA,GAAA,EAAA,EAAA,CAAA,EAAA,EAAA,CAAA,IAAA,EAAA,EAAA,EAAA,CAAA,EAAA,EAAA,CAAA,GAAA,EAAA,OAAA,QAAA,GAAA,aAAA,CAAA,CACJ,OAAK,EAAoB,EAAY,EAAM,CACzC,IAAE,QAAA,CACF,OAAA,EAAoB,EAAA,cAElB,OAAA,EAAA,EAAA,CACC,KAAW,EACb,SAAA,EACG,CAAA,EAEA,IAAE,UAAO,CACd,OAAA,EAAA,EAAA,WAED,iBACQ,CAAA,EAEN,CAAA,EAEF,IAAA,MAAA,CACI,MAAC,CACC,KAAG,UACP,UAAW,EAAO,MAAA,KACf,GAAA,EAAS,EAAA,CACT,EAEJ,CAAE,EAAK,CACN,IAAG,MAAA,CACD,OAAI,EAAA,kBAGR,CAAA,CAAA"}
+{"version":3,"file":"builtin-file.mjs","names":[],"sources":["../../../src/typescript/components/builtin-file.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { computed, splitProps } from \"@alloy-js/core\";\nimport { hasFileExtension } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension, replacePath } from \"@stryke/path/replace\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport type { TSDocModuleProps } from \"./tsdoc\";\nimport { TSDocModule } from \"./tsdoc\";\nimport {\n  TypescriptFile,\n  TypescriptFileHeader,\n  TypescriptFileHeaderImports,\n  TypescriptFileProps\n} from \"./typescript-file\";\n\nexport type BuiltinFileProps = Omit<TypescriptFileProps, \"path\"> &\n  Omit<TSDocModuleProps, \"name\"> & {\n    /**\n     * The runtime module identifier.\n     *\n     * @remarks\n     * This value will be included after the \\`storm:\\` prefix in the import statement.\n     */\n    id: string;\n\n    /**\n     * The description for the builtin module.\n     */\n    description?: string;\n\n    /**\n     * Whether the file is a TSX file.\n     *\n     * @defaultValue false\n     */\n    tsx?: boolean;\n  };\n\n/**\n * A base component representing a Powerlines generated Typescript source file.\n *\n * @param props - The properties for the source file.\n * @returns The rendered source file component.\n */\nexport function BuiltinFile(props: BuiltinFileProps) {\n  const [{ children, imports, builtinImports, id, description, tsx }, rest] =\n    splitProps(props, [\n      \"children\",\n      \"imports\",\n      \"builtinImports\",\n      \"id\",\n      \"description\",\n      \"tsx\"\n    ]);\n\n  const context = usePowerlinesSafe();\n  const path = computed(() =>\n    replacePath(\n      `${!isSet(tsx) ? id : replaceExtension(id)}${\n        hasFileExtension(id) && !isSet(tsx) ? \"\" : tsx ? \".tsx\" : \".ts\"\n      }`,\n      context?.builtinsPath\n    )\n  );\n\n  return (\n    <TypescriptFile\n      header={\n        <TypescriptFileHeader\n          header={<TSDocModule name={id}>{description}</TSDocModule>}>\n          <TypescriptFileHeaderImports\n            imports={imports}\n            builtinImports={builtinImports}\n          />\n        </TypescriptFileHeader>\n      }\n      meta={{\n        kind: \"builtin\",\n        extension: tsx ? \"tsx\" : \"ts\",\n        id: replaceExtension(id)\n      }}\n      {...rest}\n      path={path.value}>\n      {children}\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgCA,SAAY,YAAgB,OAAO;CACjC,MAAK,CAAA,EACH,UACA,SACA,gBACA,IACA,aACA,OACA,QAAI,WAAM,OAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA;;CAEZ,MAAI,OAAA,eAAA,YAAA,GAAA,CAAA,MAAA,IAAA,GAAA,KAAA,iBAAA,GAAA,GAAA,iBAAA,GAAA,IAAA,CAAA,MAAA,IAAA,GAAA,KAAA,MAAA,SAAA,SAAA,SAAA,aAAA,CAAA;AACJ,QAAK,gBAAoB,gBAAY,WAAM;EACzC,IAAE,SAAA;AACF,UAAA,gBAAoB,sBAAA;;AAElB,YAAA,gBAAA,aAAA;MACC,MAAW;MACb,UAAA;MACG,CAAA;;IAEA,IAAE,WAAO;AACd,YAAA,gBAAA,6BAAA;;MAED;MACQ,CAAA;;IAEN,CAAA;;EAEF,IAAA,OAAA;AACI,UAAC;IACC,MAAG;IACP,WAAW,MAAO,QAAA;IACf,IAAA,iBAAS,GAAA;IACT;;EAEJ,EAAE,MAAK;EACN,IAAG,OAAA;AACD,UAAI,KAAA;;;EAGR,CAAA,CAAA"}