@shell-shock/core 0.17.22 → 0.17.24

package/dist/helpers/power-plant.mjs

@@ -0,0 +1,99 @@
+import { defineGenerator, defineOutput, defineSchema, execute } from "@power-plant/core";
+import { render } from "@powerlines/plugin-alloy/render";
+import { serializedCommandsSchema } from "@shell-shock/schema";
+import { z } from "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 = 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: z.toJSONSchema(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 defineGenerator({
+		...config,
+		schema: serializedCommandSchema,
+		output: 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 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 render(options.context, options.template ?? template, {});
+}
+
+//#endregion
+export { defineCommandGenerator, executeCommandGenerator, renderCommandTemplate, serializeCommands };
+//# sourceMappingURL=power-plant.mjs.map

package/dist/helpers/power-plant.mjs.map

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

package/dist/index-D4klH_pj.d.mts

@@ -0,0 +1,2 @@
+import "./command-B6KYexlV.mjs";
+import "./config-CnNYdfsL.mjs";

package/dist/index-DYOBadKY.d.cts

@@ -0,0 +1,2 @@
+import "./command-CtfR7hKM.cjs";
+import "./config-BIF9mEz0.cjs";

package/dist/index.cjs

@@ -2,17 +2,6 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_config = require('./config.cjs');
 
 //#region src/index.ts
-const __ΩPartial = [
-	"T",
-	"Partial",
-	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
-];
-const __ΩRecord = [
-	"K",
-	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
-];
 /**
 * A utility function to define a Shell Shock command's metadata.
 *
@@ -39,14 +28,6 @@ const __ΩRecord = [
 function defineMetadata(metadata) {
 	return metadata;
 }
-defineMetadata.__type = [
-	() => __ΩPartial,
-	"CommandMetadata",
-	"metadata",
-	"defineMetadata",
-	"A utility function to define a Shell Shock command's metadata.",
-	"P\"w\"o!\"2#\"w\"/$?%"
-];
 /**
 * A utility function to define a Shell Shock command's options.
 *
@@ -72,15 +53,6 @@ defineMetadata.__type = [
 function defineOptions(options) {
 	return options;
 }
-defineOptions.__type = [
-	() => __ΩRecord,
-	"CommandOptionConfig",
-	"options",
-	() => __ΩRecord,
-	"defineOptions",
-	"A utility function to define a Shell Shock command's options.",
-	"P&\"w\"o!#2#&\"w\"o$#/%?&"
-];
 /**
 * A utility function to define a Shell Shock command's arguments.
 *
@@ -107,17 +79,9 @@ defineOptions.__type = [
 function defineArguments(args) {
 	return args;
 }
-defineArguments.__type = [
-	"CommandArgumentConfig",
-	"args",
-	"defineArguments",
-	"A utility function to define a Shell Shock command's arguments.",
-	"P\"w!F2\"\"w!F/#?$"
-];
 
 //#endregion
 exports.defineArguments = defineArguments;
 exports.defineConfig = require_config.defineConfig;
 exports.defineMetadata = defineMetadata;
-exports.defineOptions = defineOptions;
-//# sourceMappingURL=index.cjs.map
+exports.defineOptions = defineOptions;

package/dist/index.d.cts

@@ -1,9 +1,7 @@
-import { AsCommandParameterConfig, BaseBooleanCommandParameter, BaseCommandParameter, BaseNumberCommandParameter, BaseSingleCommandParameter, BaseStringCommandParameter, BaseVariadicCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, SingleBooleanCommandParameter, SingleNumberCommandParameter, SingleStringCommandParameter, StringCommandParameter, StringCommandParameterConfig, VariadicBooleanCommandParameter, VariadicNumberCommandParameter, VariadicStringCommandParameter } from "./types/command.cjs";
-import { Context, ExecutionContext, UnresolvedContext } from "./types/context.cjs";
-import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.cjs";
-import { ShellShockEnv } from "./types/env.cjs";
+import { A as StringCommandParameterConfig, C as NumberCommandParameter, D as SingleNumberCommandParameter, E as SingleBooleanCommandParameter, M as VariadicNumberCommandParameter, N as VariadicStringCommandParameter, O as SingleStringCommandParameter, S as CommandTree, T as SerializedCommandTree, _ as CommandOption, a as BaseSingleCommandParameter, b as CommandParameterConfig, c as BooleanCommandOption, d as CommandArgument, f as CommandArgumentConfig, g as CommandModule, h as CommandMetadata, i as BaseNumberCommandParameter, j as VariadicBooleanCommandParameter, k as StringCommandParameter, l as BooleanCommandParameter, m as CommandConfig, n as BaseBooleanCommandParameter, o as BaseStringCommandParameter, p as CommandBase, r as BaseCommandParameter, s as BaseVariadicCommandParameter, t as AsCommandParameterConfig, u as BooleanCommandParameterConfig, v as CommandOptionConfig, w as NumberCommandParameterConfig, x as CommandParameterType, y as CommandParameter } from "./command-CtfR7hKM.cjs";
+import { a as ResolvedConfig, c as UserConfigFn, d as CommandGeneratorOptions, f as Context, i as OutputConfig, l as UserConfigFnObject, m as UnresolvedContext, n as EngineOptions, o as UserConfig, p as ExecutionContext, r as Options, s as UserConfigExport, t as DocsOptions, u as UserConfigFnPromise } from "./config-BIF9mEz0.cjs";
+import "./index-DYOBadKY.cjs";
 import { defineConfig } from "./config.cjs";
-
 //#region src/index.d.ts
 /**
  * A utility function to define a Shell Shock command's metadata.
@@ -77,5 +75,5 @@ declare function defineOptions(options: Record<string, CommandOptionConfig>): Re
  */
 declare function defineArguments(args: CommandArgumentConfig[]): CommandArgumentConfig[];
 //#endregion
-export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type ShellShockEnv, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
+export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandGeneratorOptions, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;AAkDA;;;;;;;;;;;;;AAEkB;AA0BlB;;;;iBA5BgB,cAAA,CACd,QAAA,EAAU,OAAA,CAAQ,eAAA,IACjB,eAAA;;;;;;;;;;;AA4BkC;AA2BrC;;;;;;;;AAEwB;;;iBA/BR,aAAA,CACd,OAAA,EAAS,MAAA,SAAe,mBAAA,IACvB,MAAA,SAAe,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;iBA2BF,eAAA,CACd,IAAA,EAAM,qBAAA,KACL,qBAAqB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkDgB,eACd,UAAU,QAAQ,mBACjB;;;;;;;;;;;;;;;;;;;;;;;iBA0Ba,cACd,SAAS,eAAe,uBACvB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;iBA2BF,gBACd,MAAM,0BACL"}

package/dist/index.d.mts

@@ -1,9 +1,7 @@
-import { AsCommandParameterConfig, BaseBooleanCommandParameter, BaseCommandParameter, BaseNumberCommandParameter, BaseSingleCommandParameter, BaseStringCommandParameter, BaseVariadicCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, SingleBooleanCommandParameter, SingleNumberCommandParameter, SingleStringCommandParameter, StringCommandParameter, StringCommandParameterConfig, VariadicBooleanCommandParameter, VariadicNumberCommandParameter, VariadicStringCommandParameter } from "./types/command.mjs";
-import { Context, ExecutionContext, UnresolvedContext } from "./types/context.mjs";
-import { DocsOptions, EngineOptions, Options, OutputConfig, ResolvedConfig, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnObject, UserConfigFnPromise } from "./types/config.mjs";
-import { ShellShockEnv } from "./types/env.mjs";
+import { A as StringCommandParameterConfig, C as NumberCommandParameter, D as SingleNumberCommandParameter, E as SingleBooleanCommandParameter, M as VariadicNumberCommandParameter, N as VariadicStringCommandParameter, O as SingleStringCommandParameter, S as CommandTree, T as SerializedCommandTree, _ as CommandOption, a as BaseSingleCommandParameter, b as CommandParameterConfig, c as BooleanCommandOption, d as CommandArgument, f as CommandArgumentConfig, g as CommandModule, h as CommandMetadata, i as BaseNumberCommandParameter, j as VariadicBooleanCommandParameter, k as StringCommandParameter, l as BooleanCommandParameter, m as CommandConfig, n as BaseBooleanCommandParameter, o as BaseStringCommandParameter, p as CommandBase, r as BaseCommandParameter, s as BaseVariadicCommandParameter, t as AsCommandParameterConfig, u as BooleanCommandParameterConfig, v as CommandOptionConfig, w as NumberCommandParameterConfig, x as CommandParameterType, y as CommandParameter } from "./command-B6KYexlV.mjs";
+import { a as ResolvedConfig, c as UserConfigFn, d as CommandGeneratorOptions, f as Context, i as OutputConfig, l as UserConfigFnObject, m as UnresolvedContext, n as EngineOptions, o as UserConfig, p as ExecutionContext, r as Options, s as UserConfigExport, t as DocsOptions, u as UserConfigFnPromise } from "./config-CnNYdfsL.mjs";
+import "./index-D4klH_pj.mjs";
 import { defineConfig } from "./config.mjs";
-
 //#region src/index.d.ts
 /**
  * A utility function to define a Shell Shock command's metadata.
@@ -77,5 +75,5 @@ declare function defineOptions(options: Record<string, CommandOptionConfig>): Re
  */
 declare function defineArguments(args: CommandArgumentConfig[]): CommandArgumentConfig[];
 //#endregion
-export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type ShellShockEnv, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
+export { type AsCommandParameterConfig, type BaseBooleanCommandParameter, type BaseCommandParameter, type BaseNumberCommandParameter, type BaseSingleCommandParameter, type BaseStringCommandParameter, type BaseVariadicCommandParameter, type BooleanCommandOption, type BooleanCommandParameter, type BooleanCommandParameterConfig, type CommandArgument, type CommandArgumentConfig, type CommandBase, type CommandConfig, type CommandGeneratorOptions, type CommandMetadata, type CommandModule, type CommandOption, type CommandOptionConfig, type CommandParameter, type CommandParameterConfig, type CommandParameterType, type CommandTree, type Context, type DocsOptions, type EngineOptions, type ExecutionContext, type NumberCommandParameter, type NumberCommandParameterConfig, type Options, type OutputConfig, type ResolvedConfig, type SerializedCommandTree, type SingleBooleanCommandParameter, type SingleNumberCommandParameter, type SingleStringCommandParameter, type StringCommandParameter, type StringCommandParameterConfig, type UnresolvedContext, type UserConfig, type UserConfigExport, type UserConfigFn, type UserConfigFnObject, type UserConfigFnPromise, type VariadicBooleanCommandParameter, type VariadicNumberCommandParameter, type VariadicStringCommandParameter, defineArguments, defineConfig, defineMetadata, defineOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,17 +1,6 @@
 import { defineConfig } from "./config.mjs";
 
 //#region src/index.ts
-const __ΩPartial = [
-	"T",
-	"Partial",
-	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
-];
-const __ΩRecord = [
-	"K",
-	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
-];
 /**
 * A utility function to define a Shell Shock command's metadata.
 *
@@ -38,14 +27,6 @@ const __ΩRecord = [
 function defineMetadata(metadata) {
 	return metadata;
 }
-defineMetadata.__type = [
-	() => __ΩPartial,
-	"CommandMetadata",
-	"metadata",
-	"defineMetadata",
-	"A utility function to define a Shell Shock command's metadata.",
-	"P\"w\"o!\"2#\"w\"/$?%"
-];
 /**
 * A utility function to define a Shell Shock command's options.
 *
@@ -71,15 +52,6 @@ defineMetadata.__type = [
 function defineOptions(options) {
 	return options;
 }
-defineOptions.__type = [
-	() => __ΩRecord,
-	"CommandOptionConfig",
-	"options",
-	() => __ΩRecord,
-	"defineOptions",
-	"A utility function to define a Shell Shock command's options.",
-	"P&\"w\"o!#2#&\"w\"o$#/%?&"
-];
 /**
 * A utility function to define a Shell Shock command's arguments.
 *
@@ -106,13 +78,6 @@ defineOptions.__type = [
 function defineArguments(args) {
 	return args;
 }
-defineArguments.__type = [
-	"CommandArgumentConfig",
-	"args",
-	"defineArguments",
-	"A utility function to define a Shell Shock command's arguments.",
-	"P\"w!F2\"\"w!F/#?$"
-];
 
 //#endregion
 export { defineArguments, defineConfig, defineMetadata, defineOptions };

package/dist/package-BEuyOlNO.mjs

@@ -0,0 +1,6 @@
+//#region package.json
+var version = "0.17.23";
+
+//#endregion
+export { version as t };
+//# sourceMappingURL=package-BEuyOlNO.mjs.map

package/dist/package-BEuyOlNO.mjs.map

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

package/dist/{package.cjs → package-Bzt7_95T.cjs}

@@ -1,6 +1,5 @@
-
 //#region package.json
-var version = "0.17.21";
+var version = "0.17.23";
 
 //#endregion
 Object.defineProperty(exports, 'version', {
@@ -8,5 +7,4 @@ Object.defineProperty(exports, 'version', {
   get: function () {
     return version;
   }
-});
-//# sourceMappingURL=package.cjs.map
+});