@shell-shock/core 0.17.21 → 0.17.23

package/dist/engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_get_framework = require('./helpers/get-framework.cjs');
+const require_get_framework = require('./get-framework-CxZc2krd.cjs');
 let _powerlines_engine = require("@powerlines/engine");
 
 //#region src/engine.ts
@@ -18,10 +18,11 @@ var Engine = class Engine {
 	* @returns A promise that resolves to a {@link Engine} instance.
 	*/
 	static async from(options) {
-		return new Engine(await (0, _powerlines_engine.createEngine)({
+		const powerlines = await (0, _powerlines_engine.createEngine)({
 			...options,
 			framework: require_get_framework.getFramework()
-		}, "@shell-shock/core/api"));
+		}, "@shell-shock/core/api");
+		return new Engine(powerlines);
 	}
 	/**
 	* Gets the current build context, which includes information about the project, environment, and configuration. This context is used internally by the Shell Shock API to manage the build process and provide relevant data to plugins and other components.
@@ -87,32 +88,6 @@ var Engine = class Engine {
 	async finalize() {
 		return this.#powerlines.finalize();
 	}
-	static __type = [
-		"#powerlines",
-		"EngineOptions",
-		"options",
-		() => Engine,
-		"from",
-		"Creates a new instance of the {@link Engine} class using the provided configuration options. This method initializes the underlying Powerlines API with the appropriate plugins and settings for Shell Shock.",
-		"powerlines",
-		"constructor",
-		"inlineConfig",
-		"clean",
-		"Executes the clean phase of the build process, which typically involves removing generated files and resetting the build environment. The `inlineConfig` parameter allows users to specify additional options or overrides for the clean operation.",
-		"prepare",
-		"Executes the prepare phase of the build process, which typically involves setting up the build environment and installing dependencies. The `inlineConfig` parameter allows users to specify additional options or overrides for the prepare operation.",
-		"lint",
-		"Executes the lint phase of the build process, which typically involves analyzing code for quality and style issues. The `inlineConfig` parameter allows users to specify additional options or overrides for the lint operation.",
-		"build",
-		"Executes the build phase of the build process, which typically involves compiling source code and generating output artifacts. The `inlineConfig` parameter allows users to specify additional options or overrides for the build operation.",
-		"docs",
-		"Executes the documentation generation phase of the build process, which typically involves creating API documentation and other project documentation. The `inlineConfig` parameter allows users to specify additional options or overrides for the documentation operation.",
-		"finalize",
-		"Executes the finalize phase of the build process, which typically involves cleanup tasks and final reporting. This method should be called after all other build phases have completed.",
-		"Engine",
-		"The Shell Shock Engine class.",
-		"!3!P\"w\"2#P7$`0%s?&!P!2'\"0(P!2)$`0*?+P!2)$`0,?-P!2)$`0.?/P!2)$`00?1P!2)$`02?3P$`04?55w6?7"
-	];
 };
 /**
 * Creates a new {@link Engine} instance.
@@ -123,16 +98,7 @@ var Engine = class Engine {
 async function createEngine(options) {
 	return Engine.from(options);
 }
-createEngine.__type = [
-	"EngineOptions",
-	"options",
-	() => Engine,
-	"createEngine",
-	"Creates a new {@link Engine} instance.",
-	"P\"w!2\"P7#`/$?%"
-];
 
 //#endregion
 exports.Engine = Engine;
-exports.createEngine = createEngine;
-//# sourceMappingURL=engine.cjs.map
+exports.createEngine = createEngine;

package/dist/engine.d.cts

@@ -1,7 +1,6 @@
-import { EngineOptions } from "./types/config.cjs";
+import { n as EngineOptions } from "./config-BIF9mEz0.cjs";
 import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines";
 import { EngineContext } from "@powerlines/engine";
-
 //#region src/engine.d.ts
 /**
  * The Shell Shock Engine class.

package/dist/engine.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.cts","names":[],"sources":["../src/engine.ts"],"mappings":";;;;;;;AAoCA;;;;cAAa,MAAA;EAAA;EA0BW;;;;;;EAAA,OAjBF,IAAA,CAAK,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,MAAA;EA6DzB;;;;;EAAA,IA5CtB,OAAA,IAAW,aAAA;EAAA,QAIf,WAAA;;;;;;;EAUM,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAoB,OAAA;EAd/B;;;;;;EAwBT,OAAA,CAAQ,YAAA,EAAc,mBAAA,GAAsB,OAAA;EAAtB;;;;;;EAUtB,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAmB,OAAA;EAUtC;;;;;;EAAA,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAoB,OAAA;EAUF;;;;AASnB;AAWlC;EApBe,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAmB,OAAA;;;;;;EAStC,QAAA,IAAY,OAAA;AAAA;;;;;AAW+C;;iBAApD,YAAA,CAAa,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,MAAA"}
+{"version":3,"file":"engine.d.cts","names":[],"sources":["../src/engine.ts"],"mappings":";;;;;;;;;;cAoCa;;;;;;;;SASS,KAAK,SAAS,gBAAgB,QAAQ;;;;;;MAiB/C,WAAW;UAIf;;;;;;;EAUM,MAAM,cAAc,oBAAoB;;;;;;;EAUxC,QAAQ,cAAc,sBAAsB;;;;;;;EAU5C,KAAK,cAAc,mBAAmB;;;;;;;EAUtC,MAAM,cAAc,oBAAoB;;;;;;;EAUxC,KAAK,cAAc,mBAAmB;;;;;;EAStC,YAAY;;;;;;;;iBAWL,aAAa,SAAS,gBAAgB,QAAQ"}

package/dist/engine.d.mts

@@ -1,7 +1,6 @@
-import { EngineOptions } from "./types/config.mjs";
+import { n as EngineOptions } from "./config-CnNYdfsL.mjs";
 import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines";
 import { EngineContext } from "@powerlines/engine";
-
 //#region src/engine.d.ts
 /**
  * The Shell Shock Engine class.

package/dist/engine.mjs

@@ -1,4 +1,4 @@
-import { getFramework } from "./helpers/get-framework.mjs";
+import { t as getFramework } from "./get-framework-Dlqz2hVZ.mjs";
 import { createEngine as createEngine$1 } from "@powerlines/engine";
 
 //#region src/engine.ts
@@ -17,10 +17,11 @@ var Engine = class Engine {
 	* @returns A promise that resolves to a {@link Engine} instance.
 	*/
 	static async from(options) {
-		return new Engine(await createEngine$1({
+		const powerlines = await createEngine$1({
 			...options,
 			framework: getFramework()
-		}, "@shell-shock/core/api"));
+		}, "@shell-shock/core/api");
+		return new Engine(powerlines);
 	}
 	/**
 	* Gets the current build context, which includes information about the project, environment, and configuration. This context is used internally by the Shell Shock API to manage the build process and provide relevant data to plugins and other components.
@@ -86,32 +87,6 @@ var Engine = class Engine {
 	async finalize() {
 		return this.#powerlines.finalize();
 	}
-	static __type = [
-		"#powerlines",
-		"EngineOptions",
-		"options",
-		() => Engine,
-		"from",
-		"Creates a new instance of the {@link Engine} class using the provided configuration options. This method initializes the underlying Powerlines API with the appropriate plugins and settings for Shell Shock.",
-		"powerlines",
-		"constructor",
-		"inlineConfig",
-		"clean",
-		"Executes the clean phase of the build process, which typically involves removing generated files and resetting the build environment. The `inlineConfig` parameter allows users to specify additional options or overrides for the clean operation.",
-		"prepare",
-		"Executes the prepare phase of the build process, which typically involves setting up the build environment and installing dependencies. The `inlineConfig` parameter allows users to specify additional options or overrides for the prepare operation.",
-		"lint",
-		"Executes the lint phase of the build process, which typically involves analyzing code for quality and style issues. The `inlineConfig` parameter allows users to specify additional options or overrides for the lint operation.",
-		"build",
-		"Executes the build phase of the build process, which typically involves compiling source code and generating output artifacts. The `inlineConfig` parameter allows users to specify additional options or overrides for the build operation.",
-		"docs",
-		"Executes the documentation generation phase of the build process, which typically involves creating API documentation and other project documentation. The `inlineConfig` parameter allows users to specify additional options or overrides for the documentation operation.",
-		"finalize",
-		"Executes the finalize phase of the build process, which typically involves cleanup tasks and final reporting. This method should be called after all other build phases have completed.",
-		"Engine",
-		"The Shell Shock Engine class.",
-		"!3!P\"w\"2#P7$`0%s?&!P!2'\"0(P!2)$`0*?+P!2)$`0,?-P!2)$`0.?/P!2)$`00?1P!2)$`02?3P$`04?55w6?7"
-	];
 };
 /**
 * Creates a new {@link Engine} instance.
@@ -122,14 +97,6 @@ var Engine = class Engine {
 async function createEngine(options) {
 	return Engine.from(options);
 }
-createEngine.__type = [
-	"EngineOptions",
-	"options",
-	() => Engine,
-	"createEngine",
-	"Creates a new {@link Engine} instance.",
-	"P\"w!2\"P7#`/$?%"
-];
 
 //#endregion
 export { Engine, createEngine };

package/dist/generator.cjs

@@ -0,0 +1,68 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_package = require('./package-BLC4qc8t.cjs');
+const require_components_exec_builtin = require('./components/exec-builtin.cjs');
+const require_components_state_builtin = require('./components/state-builtin.cjs');
+const require_components_utils_builtin = require('./components/utils-builtin.cjs');
+const require_helpers_power_plant = require('./helpers/power-plant.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+
+//#region src/generator.tsx
+/**
+* Power Plant generator for Shell Shock core built-in modules.
+*
+* @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+*/
+const coreBuiltinsGenerator = require_helpers_power_plant.defineCommandGenerator({
+	meta: {
+		name: "shell-shock-core-builtins",
+		title: "Shell Shock Core Builtins",
+		description: "Generates the base Shell Shock built-in modules (state, utils, exec) from the command tree specification.",
+		version: require_package.version,
+		tags: [
+			"shell-shock",
+			"core",
+			"alloy-js",
+			"builtins"
+		],
+		links: [{
+			href: "https://github.com/storm-software/shell-shock",
+			description: "Shell Shock Repository"
+		}, {
+			href: "https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js",
+			description: "Power Plant Alloy-js Generator"
+		}]
+	},
+	generator: async (_commands, options) => {
+		await require_helpers_power_plant.renderCommandTemplate(options, [
+			(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_state_builtin.StateBuiltin, {}),
+			(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_utils_builtin.UtilsBuiltin, {}),
+			(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_exec_builtin.ExecBuiltin, {})
+		]);
+	}
+});
+/**
+* Power Plant generator for Shell Shock command reference documentation.
+*/
+const coreDocsGenerator = require_helpers_power_plant.defineCommandGenerator({
+	meta: {
+		name: "shell-shock-core-docs",
+		title: "Shell Shock Command Docs",
+		description: "Generates CLI command reference documentation from the command tree specification.",
+		version: require_package.version,
+		tags: [
+			"shell-shock",
+			"core",
+			"alloy-js",
+			"docs"
+		]
+	},
+	generator: async (_commands, options) => {
+		if (!options.template) return;
+		await require_helpers_power_plant.renderCommandTemplate(options, options.template);
+	}
+});
+
+//#endregion
+exports.coreBuiltinsGenerator = coreBuiltinsGenerator;
+exports.default = coreBuiltinsGenerator;
+exports.coreDocsGenerator = coreDocsGenerator;

package/dist/generator.d.cts

@@ -0,0 +1,15 @@
+import { CommandGeneratorOptions } from "./helpers/power-plant.cjs";
+//#region src/generator.d.ts
+/**
+ * Power Plant generator for Shell Shock core built-in modules.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ */
+declare const coreBuiltinsGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, CommandGeneratorOptions, void>;
+/**
+ * Power Plant generator for Shell Shock command reference documentation.
+ */
+declare const coreDocsGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, CommandGeneratorOptions, void>;
+//#endregion
+export { coreBuiltinsGenerator, coreBuiltinsGenerator as default, coreDocsGenerator };
+//# sourceMappingURL=generator.d.cts.map

package/dist/generator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.cts","names":[],"sources":["../src/generator.tsx"],"mappings":";;;;;;;cAgCa,mDAAqB,sBAAA,6CAAA,wBAAA;;;;cAkCrB,+CAAiB,sBAAA,6CAAA,wBAAA"}

package/dist/generator.d.mts

@@ -0,0 +1,15 @@
+import { CommandGeneratorOptions } from "./helpers/power-plant.mjs";
+//#region src/generator.d.ts
+/**
+ * Power Plant generator for Shell Shock core built-in modules.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ */
+declare const coreBuiltinsGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, CommandGeneratorOptions, void>;
+/**
+ * Power Plant generator for Shell Shock command reference documentation.
+ */
+declare const coreDocsGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, CommandGeneratorOptions, void>;
+//#endregion
+export { coreBuiltinsGenerator, coreBuiltinsGenerator as default, coreDocsGenerator };
+//# sourceMappingURL=generator.d.mts.map

package/dist/generator.d.mts.map

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

package/dist/generator.mjs

@@ -0,0 +1,66 @@
+import { t as version } from "./package-B7Vu265G.mjs";
+import { ExecBuiltin } from "./components/exec-builtin.mjs";
+import { StateBuiltin } from "./components/state-builtin.mjs";
+import { UtilsBuiltin } from "./components/utils-builtin.mjs";
+import { defineCommandGenerator, renderCommandTemplate } from "./helpers/power-plant.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+
+//#region src/generator.tsx
+/**
+* Power Plant generator for Shell Shock core built-in modules.
+*
+* @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+*/
+const coreBuiltinsGenerator = defineCommandGenerator({
+	meta: {
+		name: "shell-shock-core-builtins",
+		title: "Shell Shock Core Builtins",
+		description: "Generates the base Shell Shock built-in modules (state, utils, exec) from the command tree specification.",
+		version,
+		tags: [
+			"shell-shock",
+			"core",
+			"alloy-js",
+			"builtins"
+		],
+		links: [{
+			href: "https://github.com/storm-software/shell-shock",
+			description: "Shell Shock Repository"
+		}, {
+			href: "https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js",
+			description: "Power Plant Alloy-js Generator"
+		}]
+	},
+	generator: async (_commands, options) => {
+		await renderCommandTemplate(options, [
+			createComponent(StateBuiltin, {}),
+			createComponent(UtilsBuiltin, {}),
+			createComponent(ExecBuiltin, {})
+		]);
+	}
+});
+/**
+* Power Plant generator for Shell Shock command reference documentation.
+*/
+const coreDocsGenerator = defineCommandGenerator({
+	meta: {
+		name: "shell-shock-core-docs",
+		title: "Shell Shock Command Docs",
+		description: "Generates CLI command reference documentation from the command tree specification.",
+		version,
+		tags: [
+			"shell-shock",
+			"core",
+			"alloy-js",
+			"docs"
+		]
+	},
+	generator: async (_commands, options) => {
+		if (!options.template) return;
+		await renderCommandTemplate(options, options.template);
+	}
+});
+
+//#endregion
+export { coreBuiltinsGenerator, coreBuiltinsGenerator as default, coreDocsGenerator };
+//# sourceMappingURL=generator.mjs.map

package/dist/generator.mjs.map

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

package/dist/{helpers/get-framework.cjs → get-framework-CxZc2krd.cjs}

@@ -1,4 +1,4 @@
-const require_package = require('../package.cjs');
+const require_package = require('./package-BLC4qc8t.cjs');
 
 //#region src/helpers/get-framework.ts
 /**
@@ -13,12 +13,11 @@ function getFramework() {
 		orgId: "storm-software"
 	};
 }
-getFramework.__type = [
-	"getFramework",
-	"Retrieves the framework information for Shell Shock.",
-	"P!/!?\""
-];
 
 //#endregion
-exports.getFramework = getFramework;
-//# sourceMappingURL=get-framework.cjs.map
+Object.defineProperty(exports, 'getFramework', {
+  enumerable: true,
+  get: function () {
+    return getFramework;
+  }
+});

package/dist/{helpers/get-framework.mjs → get-framework-Dlqz2hVZ.mjs}

@@ -1,4 +1,4 @@
-import { version } from "../package.mjs";
+import { t as version } from "./package-B7Vu265G.mjs";
 
 //#region src/helpers/get-framework.ts
 /**
@@ -13,12 +13,7 @@ function getFramework() {
 		orgId: "storm-software"
 	};
 }
-getFramework.__type = [
-	"getFramework",
-	"Retrieves the framework information for Shell Shock.",
-	"P!/!?\""
-];
 
 //#endregion
-export { getFramework };
-//# sourceMappingURL=get-framework.mjs.map
+export { getFramework as t };
+//# sourceMappingURL=get-framework-Dlqz2hVZ.mjs.map

package/dist/get-framework-Dlqz2hVZ.mjs.map

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

package/dist/helpers/power-plant.cjs

@@ -0,0 +1,102 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _power_plant_core = require("@power-plant/core");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let _shell_shock_schema = require("@shell-shock/schema");
+let zod = require("zod");
+
+//#region src/helpers/power-plant.ts
+/**
+* Options passed to Shell Shock Alloy-js generators.
+*/
+function serializeCommand(command) {
+	return {
+		...command,
+		parent: command.parent?.name ? command.parent.name : null,
+		children: Object.fromEntries(Object.entries(command.children || {}).map(([name, child]) => [name, serializeCommand(child)]))
+	};
+}
+/**
+* Serializes `context.commands` into a JSON-safe Power Plant spec document.
+*/
+function serializeCommands(commands) {
+	return Object.fromEntries(Object.entries(commands ?? {}).map(([name, command]) => [name, serializeCommand(command)]));
+}
+const serializedCommandSchema = (0, _power_plant_core.defineSchema)({
+	meta: {
+		name: "command-schema-serialized",
+		title: "Shell Shock Serialized Command Tree Schema",
+		version: "1.0",
+		description: "JSON-safe Shell Shock command tree specification used as Power Plant generator input.",
+		tags: [
+			"shell-shock",
+			"command-tree",
+			"cli"
+		]
+	},
+	schema: zod.z.toJSONSchema(_shell_shock_schema.serializedCommandsSchema)
+});
+/**
+* Creates a Power Plant generator that renders Alloy-js templates from a
+* Shell Shock command tree specification.
+*
+* @param config - Generator metadata and the Alloy render implementation.
+* @returns A Power Plant generator configuration object.
+*
+* @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+* @see https://github.com/storm-software/powerlines/blob/main/packages/plugins/plugin-alloy/src/render.tsx
+*/
+function defineCommandGenerator(config) {
+	return (0, _power_plant_core.defineGenerator)({
+		...config,
+		schema: serializedCommandSchema,
+		output: (0, _power_plant_core.defineOutput)(() => void 0),
+		generator: async (commands, options) => {
+			return await config.generator(commands, options) ?? {};
+		}
+	});
+}
+/**
+* Executes a command-tree Power Plant generator with `context.commands` as input.
+*
+* @remarks
+* Calls {@link execute} from `@power-plant/core` directly (no Powerlines
+* Power Plant plugin). Alloy templates still emit via `context` / plugin-alloy.
+*
+* @param context - The Shell Shock plugin context.
+* @param generator - The generator configuration to execute.
+* @param options - Extra generator options (merged with `{ context }`).
+*
+* @see https://github.com/storm-software/power-plant/blob/main/packages/base/core/src/execute.ts
+*/
+async function executeCommandGenerator(context, generator, options) {
+	await (0, _power_plant_core.execute)({
+		...generator,
+		input: serializeCommands(context.commands)
+	}, {
+		cwd: context.config.cwd,
+		logger: {
+			debug: (message) => context.debug(message),
+			info: (message) => context.info(message),
+			warn: (message) => context.warn(message),
+			error: (message) => context.error(message)
+		},
+		context,
+		...options
+	});
+}
+/**
+* Renders Alloy-js children through the Powerlines Alloy render bridge.
+*
+* @remarks
+* Prefer this inside Power Plant generators so builtins/entries emit correctly
+* via the Powerlines plugin context (see plugin-alloy `render`).
+*/
+async function renderCommandTemplate(options, template) {
+	await (0, _powerlines_plugin_alloy_render.render)(options.context, options.template ?? template, {});
+}
+
+//#endregion
+exports.defineCommandGenerator = defineCommandGenerator;
+exports.executeCommandGenerator = executeCommandGenerator;
+exports.renderCommandTemplate = renderCommandTemplate;
+exports.serializeCommands = serializeCommands;

package/dist/helpers/power-plant.d.cts

@@ -0,0 +1,61 @@
+import { S as CommandTree } from "../command-CtfR7hKM.cjs";
+import { d as CommandGeneratorOptions$1, f as Context } from "../config-BIF9mEz0.cjs";
+import { Children } from "@alloy-js/core";
+import { GeneratorConfigObject, GeneratorFunctionResult } from "@power-plant/core";
+import { SerializedCommands } from "@shell-shock/schema";
+//#region src/helpers/power-plant.d.ts
+/**
+ * Options passed to Shell Shock Alloy-js generators.
+ */
+interface CommandGeneratorOptions extends CommandGeneratorOptions$1 {
+  /**
+   * The Powerlines / Shell Shock plugin context used for Alloy emission.
+   */
+  context: Context;
+  /**
+   * Optional Alloy-js template override.
+   */
+  template?: Children;
+}
+/**
+ * Serializes `context.commands` into a JSON-safe Power Plant spec document.
+ */
+declare function serializeCommands(commands: Record<string, CommandTree>): SerializedCommands;
+/**
+ * Creates a Power Plant generator that renders Alloy-js templates from a
+ * Shell Shock command tree specification.
+ *
+ * @param config - Generator metadata and the Alloy render implementation.
+ * @returns A Power Plant generator configuration object.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ * @see https://github.com/storm-software/powerlines/blob/main/packages/plugins/plugin-alloy/src/render.tsx
+ */
+declare function defineCommandGenerator<TOptions extends CommandGeneratorOptions = CommandGeneratorOptions>(config: Omit<GeneratorConfigObject<SerializedCommands, TOptions, void>, "schema" | "generator"> & {
+  generator: (commands: SerializedCommands, options: TOptions) => Promise<void | GeneratorFunctionResult<SerializedCommands, TOptions>> | void;
+}): GeneratorConfigObject<SerializedCommands, TOptions, void>;
+/**
+ * Executes a command-tree Power Plant generator with `context.commands` as input.
+ *
+ * @remarks
+ * Calls {@link execute} from `@power-plant/core` directly (no Powerlines
+ * Power Plant plugin). Alloy templates still emit via `context` / plugin-alloy.
+ *
+ * @param context - The Shell Shock plugin context.
+ * @param generator - The generator configuration to execute.
+ * @param options - Extra generator options (merged with `{ context }`).
+ *
+ * @see https://github.com/storm-software/power-plant/blob/main/packages/base/core/src/execute.ts
+ */
+declare function executeCommandGenerator<TOptions extends CommandGeneratorOptions = CommandGeneratorOptions>(context: Context, generator: GeneratorConfigObject<SerializedCommands, TOptions, void>, options?: Omit<TOptions, "context">): Promise<void>;
+/**
+ * Renders Alloy-js children through the Powerlines Alloy render bridge.
+ *
+ * @remarks
+ * Prefer this inside Power Plant generators so builtins/entries emit correctly
+ * via the Powerlines plugin context (see plugin-alloy `render`).
+ */
+declare function renderCommandTemplate(options: CommandGeneratorOptions, template: Children): Promise<void>;
+//#endregion
+export { CommandGeneratorOptions, defineCommandGenerator, executeCommandGenerator, renderCommandTemplate, serializeCommands };
+//# sourceMappingURL=power-plant.d.cts.map

package/dist/helpers/power-plant.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"power-plant.d.cts","names":[],"sources":["../../src/helpers/power-plant.ts"],"mappings":";;;;;;;;;UA2DiB,gCAAgC;;;;EAI/C,SAAS;;;;EAKT,WAAW;;;;;iBAmBG,kBACd,UAAU,eAAe,eACxB;;;;;;;;;;;iBA+Ba,uBACd,iBAAiB,0BAA0B,yBAE3C,QAAQ,KACN,sBAAsB,oBAAoB;EAG1C,YACE,UAAU,oBACV,SAAS,aACN,eAAe,wBAClB,oBACA;IAGH,sBAAsB,oBAAoB;;;;;;;;;;;;;;iBA4BvB,wBACpB,iBAAiB,0BAA0B,yBAE3C,SAAS,SACT,WAAW,sBAAsB,oBAAoB,iBACrD,UAAU,KAAK,uBACd;;;;;;;;iBA8BmB,sBACpB,SAAS,yBACT,UAAU,WACT"}

package/dist/helpers/power-plant.d.mts

@@ -0,0 +1,61 @@
+import { S as CommandTree } from "../command-B6KYexlV.mjs";
+import { d as CommandGeneratorOptions$1, f as Context } from "../config-CnNYdfsL.mjs";
+import { Children } from "@alloy-js/core";
+import { GeneratorConfigObject, GeneratorFunctionResult } from "@power-plant/core";
+import { SerializedCommands } from "@shell-shock/schema";
+//#region src/helpers/power-plant.d.ts
+/**
+ * Options passed to Shell Shock Alloy-js generators.
+ */
+interface CommandGeneratorOptions extends CommandGeneratorOptions$1 {
+  /**
+   * The Powerlines / Shell Shock plugin context used for Alloy emission.
+   */
+  context: Context;
+  /**
+   * Optional Alloy-js template override.
+   */
+  template?: Children;
+}
+/**
+ * Serializes `context.commands` into a JSON-safe Power Plant spec document.
+ */
+declare function serializeCommands(commands: Record<string, CommandTree>): SerializedCommands;
+/**
+ * Creates a Power Plant generator that renders Alloy-js templates from a
+ * Shell Shock command tree specification.
+ *
+ * @param config - Generator metadata and the Alloy render implementation.
+ * @returns A Power Plant generator configuration object.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ * @see https://github.com/storm-software/powerlines/blob/main/packages/plugins/plugin-alloy/src/render.tsx
+ */
+declare function defineCommandGenerator<TOptions extends CommandGeneratorOptions = CommandGeneratorOptions>(config: Omit<GeneratorConfigObject<SerializedCommands, TOptions, void>, "schema" | "generator"> & {
+  generator: (commands: SerializedCommands, options: TOptions) => Promise<void | GeneratorFunctionResult<SerializedCommands, TOptions>> | void;
+}): GeneratorConfigObject<SerializedCommands, TOptions, void>;
+/**
+ * Executes a command-tree Power Plant generator with `context.commands` as input.
+ *
+ * @remarks
+ * Calls {@link execute} from `@power-plant/core` directly (no Powerlines
+ * Power Plant plugin). Alloy templates still emit via `context` / plugin-alloy.
+ *
+ * @param context - The Shell Shock plugin context.
+ * @param generator - The generator configuration to execute.
+ * @param options - Extra generator options (merged with `{ context }`).
+ *
+ * @see https://github.com/storm-software/power-plant/blob/main/packages/base/core/src/execute.ts
+ */
+declare function executeCommandGenerator<TOptions extends CommandGeneratorOptions = CommandGeneratorOptions>(context: Context, generator: GeneratorConfigObject<SerializedCommands, TOptions, void>, options?: Omit<TOptions, "context">): Promise<void>;
+/**
+ * Renders Alloy-js children through the Powerlines Alloy render bridge.
+ *
+ * @remarks
+ * Prefer this inside Power Plant generators so builtins/entries emit correctly
+ * via the Powerlines plugin context (see plugin-alloy `render`).
+ */
+declare function renderCommandTemplate(options: CommandGeneratorOptions, template: Children): Promise<void>;
+//#endregion
+export { CommandGeneratorOptions, defineCommandGenerator, executeCommandGenerator, renderCommandTemplate, serializeCommands };
+//# sourceMappingURL=power-plant.d.mts.map

package/dist/helpers/power-plant.d.mts.map

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