@powerlines/plugin-alloy 0.25.49 → 0.25.52

package/dist/markdown/contexts/markdown-table.cjs

@@ -0,0 +1,38 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+let _alloy_js_core = require("@alloy-js/core");
+
+//#region src/markdown/contexts/markdown-table.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const MarkdownTableColumnContext = (0, _alloy_js_core.createNamedContext)("MarkdownTableColumn", {});
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function useMarkdownTableColumn() {
+	return (0, _alloy_js_core.useContext)(MarkdownTableColumnContext);
+}
+/**
+* The Powerlines context used in template rendering.
+*/
+const MarkdownTableContext = (0, _alloy_js_core.createContext)({
+	columns: [],
+	data: []
+});
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function useMarkdownTable() {
+	return (0, _alloy_js_core.useContext)(MarkdownTableContext);
+}
+
+//#endregion
+exports.MarkdownTableColumnContext = MarkdownTableColumnContext;
+exports.MarkdownTableContext = MarkdownTableContext;
+exports.useMarkdownTable = useMarkdownTable;
+exports.useMarkdownTableColumn = useMarkdownTableColumn;

package/dist/markdown/contexts/markdown-table.d.cts

@@ -0,0 +1,38 @@
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/markdown/contexts/markdown-table.d.ts
+interface MarkdownTableColumnContextInterface<T extends Record<string, any> = Record<string, any>> {
+  index: number;
+  name: keyof T;
+  align: "left" | "right" | "center";
+  width: number;
+}
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const MarkdownTableColumnContext: ComponentContext<MarkdownTableColumnContextInterface>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function useMarkdownTableColumn(): MarkdownTableColumnContextInterface<Record<string, any>> | undefined;
+interface MarkdownTableContextInterface<T extends Record<string, any> = Record<string, any>> {
+  columns: MarkdownTableColumnContextInterface<T>[];
+  data: T[];
+}
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const MarkdownTableContext: ComponentContext<MarkdownTableContextInterface>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function useMarkdownTable(): MarkdownTableContextInterface<Record<string, any>> | undefined;
+declare type __ΩMarkdownTableColumnContextInterface = any[];
+declare type __ΩMarkdownTableContextInterface = any[];
+//#endregion
+export { MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableContext, MarkdownTableContextInterface, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableContextInterface, useMarkdownTable, useMarkdownTableColumn };
+//# sourceMappingURL=markdown-table.d.cts.map

package/dist/markdown/contexts/markdown-table.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-table.d.cts","names":[],"sources":["../../../src/markdown/contexts/markdown-table.ts"],"mappings":";;;UAqBiB,mCAAA,WACL,MAAA,gBAAsB,MAAA;EAEhC,KAAA;EACA,IAAA,QAAY,CAAA;EACZ,KAAA;EACA,KAAA;AAAA;;;;cAMW,0BAAA,EAA4B,gBAAA,CAAiB,mCAAA;;;;;;iBAW1C,sBAAA,CAAA,GAAsB,mCAAA,CAAA,MAAA;AAAA,UAMrB,6BAAA,WACL,MAAA,gBAAsB,MAAA;EAEhC,OAAA,EAAS,mCAAA,CAAoC,CAAA;EAC7C,IAAA,EAAM,CAAA;AAAA;AArBR;;;AAAA,cA2Ba,oBAAA,EAAsB,gBAAA,CAAiB,6BAAA;;AAhBpD;;;;iBA2BgB,gBAAA,CAAA,GAAgB,6BAAA,CAAA,MAAA;AAAA"}

package/dist/markdown/contexts/markdown-table.d.mts

@@ -0,0 +1,38 @@
+import { ComponentContext } from "@alloy-js/core";
+
+//#region src/markdown/contexts/markdown-table.d.ts
+interface MarkdownTableColumnContextInterface<T extends Record<string, any> = Record<string, any>> {
+  index: number;
+  name: keyof T;
+  align: "left" | "right" | "center";
+  width: number;
+}
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const MarkdownTableColumnContext: ComponentContext<MarkdownTableColumnContextInterface>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function useMarkdownTableColumn(): MarkdownTableColumnContextInterface<Record<string, any>> | undefined;
+interface MarkdownTableContextInterface<T extends Record<string, any> = Record<string, any>> {
+  columns: MarkdownTableColumnContextInterface<T>[];
+  data: T[];
+}
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const MarkdownTableContext: ComponentContext<MarkdownTableContextInterface>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function useMarkdownTable(): MarkdownTableContextInterface<Record<string, any>> | undefined;
+declare type __ΩMarkdownTableColumnContextInterface = any[];
+declare type __ΩMarkdownTableContextInterface = any[];
+//#endregion
+export { MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableContext, MarkdownTableContextInterface, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableContextInterface, useMarkdownTable, useMarkdownTableColumn };
+//# sourceMappingURL=markdown-table.d.mts.map

package/dist/markdown/contexts/markdown-table.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-table.d.mts","names":[],"sources":["../../../src/markdown/contexts/markdown-table.ts"],"mappings":";;;UAqBiB,mCAAA,WACL,MAAA,gBAAsB,MAAA;EAEhC,KAAA;EACA,IAAA,QAAY,CAAA;EACZ,KAAA;EACA,KAAA;AAAA;;;;cAMW,0BAAA,EAA4B,gBAAA,CAAiB,mCAAA;;;;;;iBAW1C,sBAAA,CAAA,GAAsB,mCAAA,CAAA,MAAA;AAAA,UAMrB,6BAAA,WACL,MAAA,gBAAsB,MAAA;EAEhC,OAAA,EAAS,mCAAA,CAAoC,CAAA;EAC7C,IAAA,EAAM,CAAA;AAAA;AArBR;;;AAAA,cA2Ba,oBAAA,EAAsB,gBAAA,CAAiB,6BAAA;;AAhBpD;;;;iBA2BgB,gBAAA,CAAA,GAAgB,6BAAA,CAAA,MAAA;AAAA"}

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

@@ -0,0 +1,34 @@
+import { createContext, createNamedContext, useContext } from "@alloy-js/core";
+
+//#region src/markdown/contexts/markdown-table.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const MarkdownTableColumnContext = createNamedContext("MarkdownTableColumn", {});
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function useMarkdownTableColumn() {
+	return useContext(MarkdownTableColumnContext);
+}
+/**
+* The Powerlines context used in template rendering.
+*/
+const MarkdownTableContext = createContext({
+	columns: [],
+	data: []
+});
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function useMarkdownTable() {
+	return useContext(MarkdownTableContext);
+}
+
+//#endregion
+export { MarkdownTableColumnContext, MarkdownTableContext, useMarkdownTable, useMarkdownTableColumn };
+//# sourceMappingURL=markdown-table.mjs.map

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

@@ -0,0 +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  } as MarkdownTableContextInterface);\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":";;;;;;AAiCA,MAAa,6BACX,mBACE,uBACA,EAAE,CACH;;;;;;AAOH,SAAgB,yBAAyB;AACvC,QAAO,WACL,2BACD;;;;;AAaH,MAAa,uBACX,cAA6C;CAC3C,SAAS,EAAE;CACX,MAAM,EAAE;CACT,CAAkC;;;;;;AAOrC,SAAgB,mBAAmB;AACjC,QAAO,WAA0C,qBAAqB"}

package/dist/markdown/index.cjs

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_markdown_components_front_matter = require('./components/front-matter.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.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.d.cts

@@ -0,0 +1,5 @@
+import { FrontMatter, FrontMatterProps, __ΩFrontMatterProps } from "./components/front-matter.cjs";
+import { MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps } from "./components/markdown-file.cjs";
+import { MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableContext, MarkdownTableContextInterface, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableContextInterface, useMarkdownTable, useMarkdownTableColumn } from "./contexts/markdown-table.cjs";
+import { MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableProps, __ΩMarkdownTableColumnProps, __ΩMarkdownTableProps } from "./components/markdown-table.cjs";
+export { FrontMatter, FrontMatterProps, MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableContext, MarkdownTableContextInterface, MarkdownTableProps, __ΩFrontMatterProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableColumnProps, __ΩMarkdownTableContextInterface, __ΩMarkdownTableProps, useMarkdownTable, useMarkdownTableColumn };

package/dist/markdown/index.d.mts

@@ -0,0 +1,5 @@
+import { FrontMatter, FrontMatterProps, __ΩFrontMatterProps } from "./components/front-matter.mjs";
+import { MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps } from "./components/markdown-file.mjs";
+import { MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableContext, MarkdownTableContextInterface, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableContextInterface, useMarkdownTable, useMarkdownTableColumn } from "./contexts/markdown-table.mjs";
+import { MarkdownTable, MarkdownTableColumn, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableProps, __ΩMarkdownTableColumnProps, __ΩMarkdownTableProps } from "./components/markdown-table.mjs";
+export { FrontMatter, FrontMatterProps, MarkdownFile, MarkdownFileHeader, MarkdownFileHeaderProps, MarkdownFileProps, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnContext, MarkdownTableColumnContextInterface, MarkdownTableColumnHeader, MarkdownTableColumnProps, MarkdownTableContext, MarkdownTableContextInterface, MarkdownTableProps, __ΩFrontMatterProps, __ΩMarkdownFileHeaderProps, __ΩMarkdownFileProps, __ΩMarkdownTableColumnContextInterface, __ΩMarkdownTableColumnProps, __ΩMarkdownTableContextInterface, __ΩMarkdownTableProps, useMarkdownTable, useMarkdownTableColumn };

package/dist/markdown/index.mjs

@@ -0,0 +1,8 @@
+import { FrontMatter } from "./components/front-matter.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, MarkdownFile, MarkdownFileHeader, MarkdownTable, MarkdownTableColumn, MarkdownTableColumnContext, MarkdownTableColumnHeader, MarkdownTableContext, useMarkdownTable, useMarkdownTableColumn };

package/dist/render.cjs

@@ -0,0 +1,91 @@
+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.d.cts

@@ -0,0 +1,38 @@
+import { Children, PrintTreeOptions } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+
+//#region src/render.d.ts
+/**
+ * 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.
+ */
+declare function render<TContext extends PluginContext>(context: TContext, children: Children): Promise<void>;
+/**
+ * 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.
+ */
+declare function renderString<TContext extends PluginContext>(context: TContext, children: Children, options?: PrintTreeOptions): string;
+//#endregion
+export { render, renderString };
+//# sourceMappingURL=render.d.cts.map

package/dist/render.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.cts","names":[],"sources":["../src/render.tsx"],"mappings":";;;;;;AA4CA;;;;;;;;;;;;iBAAsB,MAAA,kBAAwB,aAAA,CAAA,CAC5C,OAAA,EAAS,QAAA,EACT,QAAA,EAAU,QAAA,GAAQ,OAAA;;;;;;AA2FpB;;;;;;;;;;iBAAgB,YAAA,kBAA8B,aAAA,CAAA,CAC5C,OAAA,EAAS,QAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,GAAU,gBAAA"}

package/dist/render.d.mts

@@ -0,0 +1,38 @@
+import { Children, PrintTreeOptions } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+
+//#region src/render.d.ts
+/**
+ * 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.
+ */
+declare function render<TContext extends PluginContext>(context: TContext, children: Children): Promise<void>;
+/**
+ * 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.
+ */
+declare function renderString<TContext extends PluginContext>(context: TContext, children: Children, options?: PrintTreeOptions): string;
+//#endregion
+export { render, renderString };
+//# sourceMappingURL=render.d.mts.map

package/dist/render.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.mts","names":[],"sources":["../src/render.tsx"],"mappings":";;;;;;AA4CA;;;;;;;;;;;;iBAAsB,MAAA,kBAAwB,aAAA,CAAA,CAC5C,OAAA,EAAS,QAAA,EACT,QAAA,EAAU,QAAA,GAAQ,OAAA;;;;;;AA2FpB;;;;;;;;;;iBAAgB,YAAA,kBAA8B,aAAA,CAAA,CAC5C,OAAA,EAAS,QAAA,EACT,QAAA,EAAU,QAAA,EACV,OAAA,GAAU,gBAAA"}

package/dist/render.mjs

@@ -0,0 +1,89 @@
+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

@@ -0,0 +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":";;;;;;;;;;;;;;;;;;;;;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,aAAsC,SAAA,UAAA,SAAA;AAKlD,QAAO,UAJK,WAAA,gBAAA,UAAA;EACF;EACA;EACT,CAAC,CAAC,EACU,QAAA"}

package/dist/types/components.d.cts

@@ -0,0 +1,142 @@
+import { Children, Context } from "@alloy-js/core";
+import { ResolvedEntryTypeDefinition, StoragePreset } from "powerlines";
+import { SourceFileContext } from "@alloy-js/typescript";
+
+//#region src/types/components.d.ts
+interface CopyOutputFile {
+  kind: "file";
+  path: string;
+  sourcePath: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+interface WriteOutputFile {
+  kind: "file" | "entry" | "builtin";
+  path: string;
+  contents: string;
+  filetype: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+type OutputFile = (WriteOutputFile & {
+  kind: "file";
+}) | (WriteOutputFile & {
+  kind: "entry";
+  typeDefinition?: ResolvedEntryTypeDefinition;
+}) | (WriteOutputFile & {
+  kind: "builtin";
+  id: string;
+}) | CopyOutputFile;
+interface OutputDirectory {
+  kind: "directory";
+  path: string;
+  contents: (OutputDirectory | OutputFile)[];
+}
+interface RenderEntryContext {
+  typeDefinition: ResolvedEntryTypeDefinition;
+}
+interface RenderBuiltinContext {
+  id: string;
+}
+interface RenderOutputContext {
+  mode?: StoragePreset;
+}
+interface CopyFileOutputContext {
+  path?: string;
+  sourcePath?: string;
+}
+interface RenderContext extends Context {
+  meta?: {
+    copyFile?: CopyFileOutputContext;
+    /**
+     * The current context for the built-in module.
+     */
+    builtin?: RenderBuiltinContext;
+    /**
+     * The current context for the application entrypoint file being rendered.
+     */
+    entry?: RenderEntryContext;
+    /**
+     * The current context for output rendering.
+     */
+    output?: RenderOutputContext;
+  } & Record<string, any>;
+}
+/**
+ * A type that represents the props of a component that can have children.
+ */
+interface ComponentProps {
+  children?: Children;
+}
+/**
+ * A type that requires the `children` prop in a component.
+ */
+type ComponentPropsWithChildren = Omit<ComponentProps, "children"> & Required<Pick<ComponentProps, "children">>;
+interface BuiltinSourceFileContext extends SourceFileContext {
+  /**
+   * The runtime module identifier.
+   */
+  id: string;
+}
+interface ReflectionOverrideInterface<T> {
+  name?: string | Children;
+  type?: string | Children;
+  extends?: string | false;
+  defaultValue?: Partial<T>;
+}
+interface TypescriptFileImportItem {
+  name: string;
+  default?: boolean;
+  alias?: string;
+  type?: boolean;
+}
+type TypescriptFileImports = Record<string, null | string | Array<TypescriptFileImportItem | string>>;
+interface SourceFileHeaderProps extends ComponentProps {
+  /**
+   * If true, disables the ESLint directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableEslint?: boolean;
+  /**
+   * If true, disables the Biome directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableBiome?: boolean;
+  /**
+   * If true, disables the Prettier directive at the top of the file.
+   *
+   * @defaultValue false
+   */
+  disablePrettier?: boolean;
+}
+declare type __ΩCopyOutputFile = any[];
+declare type __ΩWriteOutputFile = any[];
+declare type __ΩOutputFile = any[];
+declare type __ΩOutputDirectory = any[];
+declare type __ΩRenderEntryContext = any[];
+declare type __ΩRenderBuiltinContext = any[];
+declare type __ΩRenderOutputContext = any[];
+declare type __ΩCopyFileOutputContext = any[];
+declare type __ΩRenderContext = any[];
+declare type __ΩComponentProps = any[];
+declare type __ΩComponentPropsWithChildren = any[];
+declare type __ΩBuiltinSourceFileContext = any[];
+declare type __ΩReflectionOverrideInterface = any[];
+declare type __ΩTypescriptFileImportItem = any[];
+declare type __ΩTypescriptFileImports = any[];
+declare type __ΩSourceFileHeaderProps = any[];
+//#endregion
+export { BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile };
+//# sourceMappingURL=components.d.cts.map

package/dist/types/components.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.cts","names":[],"sources":["../../src/types/components.ts"],"mappings":";;;;;UAsBiB,cAAA;EACf,IAAA;EACA,IAAA;EACA,UAAA;;;;;;;EAQA,MAAA,GAAS,aAAA;AAAA;AAAA,UAGM,eAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,QAAA;EAHA;;;;;;EAWA,MAAA,GAAS,aAAA;AAAA;AAAA,KAGC,UAAA,IACP,eAAA;EAAoB,IAAA;AAAA,MACpB,eAAA;EACC,IAAA;EACA,cAAA,GAAiB,2BAAA;AAAA,MAElB,eAAA;EAAoB,IAAA;EAAiB,EAAA;AAAA,KACtC,cAAA;AAAA,UAEa,eAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA,GAAW,eAAA,GAAkB,UAAA;AAAA;AAAA,UAGd,kBAAA;EACf,cAAA,EAAgB,2BAAA;AAAA;AAAA,UAGD,oBAAA;EACf,EAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA,GAAO,aAAA;AAAA;AAAA,UAGQ,qBAAA;EACf,IAAA;EACA,UAAA;AAAA;AAAA,UAGe,aAAA,SAAsB,OAAA;EACrC,IAAA;IACE,QAAA,GAAW,qBAAA;IAtBgB;;;IA2B3B,OAAA,GAAU,oBAAA;IAxBqB;;;IA6B/B,KAAA,GAAQ,kBAAA;IAzBK;;;IA8Bb,MAAA,GAAS,mBAAA;EAAA,IACP,MAAA;AAAA;;;;UAMW,cAAA;EACf,QAAA,GAAW,QAAA;AAAA;;;;KAMD,0BAAA,GAA6B,IAAA,CAAK,cAAA,gBAC5C,QAAA,CAAS,IAAA,CAAK,cAAA;AAAA,UAEC,wBAAA,SAAiC,iBAAA;;;;EAIhD,EAAA;AAAA;AAAA,UAGe,2BAAA;EACf,IAAA,YAAgB,QAAA;EAChB,IAAA,YAAgB,QAAA;EAChB,OAAA;EACA,YAAA,GAAe,OAAA,CAAQ,CAAA;AAAA;AAAA,UAGR,wBAAA;EACf,IAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,MAAA,yBAElB,KAAA,CAAM,wBAAA;AAAA,UAGP,qBAAA,SAA8B,cAAA;EA1CzC;;;AAMN;;EA0CE,aAAA;EAzCA;;AAMF;;;EA0CE,YAAA;EA1CuC;;;;;EAiDvC,eAAA;AAAA;AAAA"}