poe-code 3.0.194 → 3.0.195

package/dist/index.js

@@ -45482,7 +45482,7 @@ function getRequiredBranchFingerprint(branch, casing) {
   const requiredKeys = Object.entries(branch.shape).filter(([, schema]) => schema.kind !== "optional").map(([key2]) => formatSegment2(key2, casing)).sort();
   return requiredKeys.join("+");
 }
-function collectFields(schema, casing, path94 = [], inheritedOptional = false, variantContext) {
+function collectFields(schema, casing, globalLongOptionFlags, path94 = [], inheritedOptional = false, variantContext) {
   const collected = {
     dynamicFields: [],
     fields: [],
@@ -45494,7 +45494,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
     const childSchema = unwrapOptional3(rawChildSchema);
     const requiredWhenActive = rawChildSchema.kind !== "optional" && childSchema.default === void 0;
     if (childSchema.kind === "object") {
-      const nested = collectFields(childSchema, casing, nextPath, runtimeOptional, variantContext);
+      const nested = collectFields(childSchema, casing, globalLongOptionFlags, nextPath, runtimeOptional, variantContext);
       collected.dynamicFields.push(...nested.dynamicFields);
       collected.fields.push(...nested.fields);
       collected.variants.push(...nested.variants);
@@ -45508,7 +45508,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
         path: [...nextPath, childSchema.discriminator],
         displayPath: toDisplayPath3([...nextPath, childSchema.discriminator]),
         optionAttribute: toOptionAttribute([...nextPath, childSchema.discriminator], casing),
-        commanderOptionAttribute: toCommanderOptionAttribute([...nextPath, childSchema.discriminator], casing),
+        commanderOptionAttribute: toCommanderOptionAttribute([...nextPath, childSchema.discriminator], casing, globalLongOptionFlags),
         optionFlag: toOptionFlag([...nextPath, childSchema.discriminator], casing),
         shortFlag: void 0,
         schema: createSyntheticEnumSchema(branchIds),
@@ -45521,7 +45521,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
       collected.fields.push(controlField);
       const branches = [];
       for (const [branchId, branchSchema] of Object.entries(childSchema.branches)) {
-        const branch = collectFields(branchSchema, casing, nextPath, true, {
+        const branch = collectFields(branchSchema, casing, globalLongOptionFlags, nextPath, true, {
           id: variantId,
           branchId
         });
@@ -45555,7 +45555,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
         path: controlPath,
         displayPath: controlDisplayPath,
         optionAttribute: toOptionAttribute(controlPath, casing),
-        commanderOptionAttribute: toCommanderOptionAttribute(controlPath, casing),
+        commanderOptionAttribute: toCommanderOptionAttribute(controlPath, casing, globalLongOptionFlags),
         optionFlag: toOptionFlag(controlPath, casing),
         shortFlag: void 0,
         schema: createSyntheticEnumSchema(branchIds),
@@ -45570,7 +45570,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
       const branches = [];
       childSchema.branches.forEach((branchSchema, index) => {
         const branchId = branchIds[index] ?? "";
-        const branch = collectFields(branchSchema, casing, nextPath, true, {
+        const branch = collectFields(branchSchema, casing, globalLongOptionFlags, nextPath, true, {
           id: variantId,
           branchId
         });
@@ -45637,7 +45637,7 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
       path: nextPath,
       displayPath: toDisplayPath3(nextPath),
       optionAttribute: toOptionAttribute(nextPath, casing),
-      commanderOptionAttribute: toCommanderOptionAttribute(nextPath, casing),
+      commanderOptionAttribute: toCommanderOptionAttribute(nextPath, casing, globalLongOptionFlags),
       optionFlag: toOptionFlag(nextPath, casing),
       shortFlag: childSchema.short,
       schema: childSchema,
@@ -45652,10 +45652,10 @@ function collectFields(schema, casing, path94 = [], inheritedOptional = false, v
   }
   return collected;
 }
-function toCommanderOptionAttribute(path94, casing) {
+function toCommanderOptionAttribute(path94, casing, globalLongOptionFlags) {
   const optionAttribute = toOptionAttribute(path94, casing);
   const optionFlag = toOptionFlag(path94, casing);
-  if (!GLOBAL_LONG_OPTION_FLAGS.has(optionFlag)) {
+  if (!globalLongOptionFlags.has(optionFlag)) {
     return optionAttribute;
   }
   return `param_${optionAttribute}`;
@@ -45685,8 +45685,8 @@ function assignPositionals(fields, positional) {
   });
   return fields;
 }
-function formatOptionFlags(field) {
-  const collidesWithGlobalFlag = GLOBAL_LONG_OPTION_FLAGS.has(field.optionFlag);
+function formatOptionFlags(field, globalLongOptionFlags) {
+  const collidesWithGlobalFlag = globalLongOptionFlags.has(field.optionFlag);
   if (collidesWithGlobalFlag) {
     if (field.shortFlag === void 0) {
       throw new UserError(
@@ -45804,9 +45804,9 @@ function parseArrayValue(value, schema, label) {
   }
   return splitArrayInput(value).map((item) => parseScalarValue(item, itemSchema, label));
 }
-function createOption(field) {
-  const flags = formatOptionFlags(field);
-  const collidesWithGlobalFlag = GLOBAL_LONG_OPTION_FLAGS.has(field.optionFlag);
+function createOption(field, globalLongOptionFlags) {
+  const flags = formatOptionFlags(field, globalLongOptionFlags);
+  const collidesWithGlobalFlag = globalLongOptionFlags.has(field.optionFlag);
   const commanderValue = (value) => value === null ? NULL_OPTION_VALUE : value;
   if (field.schema.kind === "boolean") {
     if (collidesWithGlobalFlag) {
@@ -45851,6 +45851,9 @@ function createOption(field) {
   );
   return [option];
 }
+function getGlobalLongOptionFlags(presetsEnabled) {
+  return new Set(presetsEnabled ? ["--preset", ...ALWAYS_GLOBAL_LONG_OPTION_FLAGS] : ALWAYS_GLOBAL_LONG_OPTION_FLAGS);
+}
 function createCommanderOption(flags, description, field) {
   const option = new Option(flags, description);
   if (field.commanderOptionAttribute !== field.optionAttribute) {
@@ -45944,14 +45947,14 @@ function describeSchemaType(schema) {
       throw new UserError("Unsupported CLI schema kind.");
   }
 }
-function formatHelpFieldFlags(field) {
+function formatHelpFieldFlags(field, globalLongOptionFlags) {
   if (field.positionalIndex !== void 0) {
     return formatPositionalToken(field);
   }
   if (field.schema.kind === "boolean") {
-    return `${formatOptionFlags(field)} [value]`;
+    return `${formatOptionFlags(field, globalLongOptionFlags)} [value]`;
   }
-  return `${formatOptionFlags(field)} <${describeSchemaType(field.schema)}>`;
+  return `${formatOptionFlags(field, globalLongOptionFlags)} <${describeSchemaType(field.schema)}>`;
 }
 function appendHelpMetadata(description, metadata) {
   if (metadata.length === 0) {
@@ -46093,18 +46096,31 @@ function formatSecretDescription(secret) {
   }
   return secret.optional === true ? "Optional secret" : "Required secret";
 }
-function formatCommandRows(group, scope) {
-  return getVisibleChildren(group, scope).map((child) => ({
-    name: child.aliases.length === 0 ? child.name : `${child.name} (${child.aliases.join(", ")})`,
-    description: child.description ?? ""
-  }));
+function formatCommandRowName(node, depth) {
+  const name = node.aliases.length === 0 ? node.name : `${node.name} (${node.aliases.join(", ")})`;
+  return `${"  ".repeat(depth)}${name}`;
 }
-function formatGlobalOptionRows(showVersion) {
-  const rows = [
-    {
+function formatCommandRows(group, scope, depth = 0) {
+  return getVisibleChildren(group, scope).flatMap((child) => {
+    const row = {
+      name: formatCommandRowName(child, depth),
+      description: child.description ?? ""
+    };
+    if (child.kind === "command") {
+      return [row];
+    }
+    return [row, ...formatCommandRows(child, scope, depth + 1)];
+  });
+}
+function formatGlobalOptionRows(showVersion, presetsEnabled) {
+  const rows = [];
+  if (presetsEnabled) {
+    rows.push({
       flags: "--preset <path>",
       description: "Load parameter defaults from a JSON file"
-    },
+    });
+  }
+  rows.push(
     {
       flags: "--yes",
       description: "Accept defaults, skip prompts"
@@ -46117,7 +46133,7 @@ function formatGlobalOptionRows(showVersion) {
       flags: "-h, --help",
       description: "Show help"
     }
-  ];
+  );
   if (showVersion) {
     rows.push({
       flags: "--version",
@@ -46136,7 +46152,7 @@ function buildUsageLine(breadcrumb, rootUsageName, suffix) {
   const subPath = breadcrumb.slice(1).join(" ");
   return subPath ? `${rootUsageName} ${subPath} ${suffix}` : `${rootUsageName} ${suffix}`;
 }
-function renderGroupHelp(group, breadcrumb, scope, showVersion, rootUsageName) {
+function renderGroupHelp(group, breadcrumb, scope, showVersion, presetsEnabled, rootUsageName) {
   const sections = [];
   const commandRows = formatCommandRows(group, scope);
   if (commandRows.length > 0) {
@@ -46144,7 +46160,7 @@ function renderGroupHelp(group, breadcrumb, scope, showVersion, rootUsageName) {
 ${formatCommandList(commandRows)}`);
   }
   sections.push(`${text.section("Global options:")}
-${formatOptionList(formatGlobalOptionRows(showVersion))}`);
+${formatOptionList(formatGlobalOptionRows(showVersion, presetsEnabled))}`);
   return renderHelpDocument({
     breadcrumb,
     usageLine: buildUsageLine(breadcrumb, rootUsageName, "[options] [command]"),
@@ -46153,12 +46169,13 @@ ${formatOptionList(formatGlobalOptionRows(showVersion))}`);
     sections
   });
 }
-function renderLeafHelp(command, breadcrumb, casing, rootUsageName) {
+function renderLeafHelp(command, breadcrumb, casing, presetsEnabled, rootUsageName) {
   const sections = [];
-  const collected = collectFields(command.params, casing);
+  const globalLongOptionFlags = getGlobalLongOptionFlags(presetsEnabled);
+  const collected = collectFields(command.params, casing, globalLongOptionFlags);
   const fields = assignPositionals(collected.fields, command.positional);
   const optionRows = fields.map((field) => ({
-    flags: formatHelpFieldFlags(field),
+    flags: formatHelpFieldFlags(field, globalLongOptionFlags),
     description: formatHelpFieldDescription(field)
   })).concat(collected.dynamicFields.flatMap((field) => formatDynamicHelpFields(field, casing)));
   if (optionRows.length > 0) {
@@ -46166,7 +46183,7 @@ function renderLeafHelp(command, breadcrumb, casing, rootUsageName) {
 ${formatOptionList(optionRows)}`);
   }
   sections.push(`${text.section("Global options:")}
-${formatOptionList(formatGlobalOptionRows(false))}`);
+${formatOptionList(formatGlobalOptionRows(false, presetsEnabled))}`);
   const secretRows = formatSecretRows(command.secrets);
   if (secretRows.length > 0) {
     sections.push(`${text.section("Secrets (via environment):")}
@@ -46205,25 +46222,32 @@ async function renderGeneratedHelp(root, argv, options) {
   const output = resolveHelpOutput(argv);
   const casing = options.casing ?? "kebab";
   await withOutputFormat2(output, async () => {
-    const rendered = target.node.kind === "group" ? renderGroupHelp(target.node, target.breadcrumb, "cli", options.version !== void 0, options.rootUsageName) : renderLeafHelp(target.node, target.breadcrumb, casing, options.rootUsageName);
+    const rendered = target.node.kind === "group" ? renderGroupHelp(
+      target.node,
+      target.breadcrumb,
+      "cli",
+      options.version !== void 0,
+      options.presets === true,
+      options.rootUsageName
+    ) : renderLeafHelp(target.node, target.breadcrumb, casing, options.presets === true, options.rootUsageName);
     process.stdout.write(rendered);
   });
 }
-function createNodeCommand(node, casing, execute2, pathSegments = []) {
+function createNodeCommand(node, casing, globalLongOptionFlags, execute2, presetsEnabled, pathSegments = []) {
   const nextPathSegments = [...pathSegments, node.name];
   if (node.kind === "command") {
     if (!node.scope.includes("cli")) {
       return null;
     }
     const command = new CommanderCommand(node.name);
-    const collected = collectFields(node.params, casing);
+    const collected = collectFields(node.params, casing, globalLongOptionFlags);
     const fields = assignPositionals(collected.fields, node.positional);
     if (node.description !== void 0) {
       command.description(node.description);
     }
     node.aliases.forEach((alias) => command.alias(alias));
     command.addHelpCommand(false);
-    addGlobalOptions(command);
+    addGlobalOptions(command, presetsEnabled);
     command.allowExcessArguments(true);
     if (collected.dynamicFields.length > 0) {
       command.allowUnknownOption(true);
@@ -46233,7 +46257,7 @@ function createNodeCommand(node, casing, execute2, pathSegments = []) {
         command.argument(formatPositionalToken(field));
         continue;
       }
-      for (const option of createOption(field)) {
+      for (const option of createOption(field, globalLongOptionFlags)) {
         command.addOption(option);
       }
     }
@@ -46247,6 +46271,7 @@ function createNodeCommand(node, casing, execute2, pathSegments = []) {
         dynamicFields: collected.dynamicFields,
         fields,
         positionalValues,
+        presetsEnabled,
         rawArgv: actionCommand.args,
         actionCommand,
         variants: collected.variants
@@ -46257,22 +46282,25 @@ function createNodeCommand(node, casing, execute2, pathSegments = []) {
   if (!isNodeVisibleInScope(node, "cli")) {
     return null;
   }
-  const visibleChildren = node.children.map((child) => createNodeCommand(child, casing, execute2, nextPathSegments)).filter((child) => child !== null);
+  const visibleChildren = node.children.map((child) => createNodeCommand(child, casing, globalLongOptionFlags, execute2, presetsEnabled, nextPathSegments)).filter((child) => child !== null);
   const group = new CommanderCommand(node.name);
   if (node.description !== void 0) {
     group.description(node.description);
   }
   node.aliases.forEach((alias) => group.alias(alias));
   group.addHelpCommand(false);
-  addGlobalOptions(group);
+  addGlobalOptions(group, presetsEnabled);
   for (const child of visibleChildren) {
     const isDefaultChild = node.default !== void 0 && node.default.scope.includes("cli") && (child.name() === node.default.name || child.aliases().includes(node.default.name));
     group.addCommand(child, isDefaultChild ? { isDefault: true } : void 0);
   }
   return group;
 }
-function addGlobalOptions(command) {
-  command.option("--preset <path>", "Load parameter defaults from a JSON file.").option("--yes", "Accept defaults and skip prompts.").option("--output <format>", "Output format.", (value) => {
+function addGlobalOptions(command, presetsEnabled) {
+  if (presetsEnabled) {
+    command.option("--preset <path>", "Load parameter defaults from a JSON file.");
+  }
+  command.option("--yes", "Accept defaults and skip prompts.").option("--output <format>", "Output format.", (value) => {
     if (value === "rich" || value === "md" || value === "json") {
       return value;
     }
@@ -47308,7 +47336,7 @@ async function executeCommand(state, services, requirementOptions, runtimeOption
       optionValues,
       state.rawArgv,
       state.casing,
-      resolvedFlags.preset,
+      state.presetsEnabled ? resolvedFlags.preset : void 0,
       shouldPrompt
     );
     const context = {
@@ -47395,7 +47423,9 @@ async function runCLI(roots, options = {}) {
   program.exitOverride();
   program.showHelpAfterError();
   program.addHelpCommand(false);
-  addGlobalOptions(program);
+  const presetsEnabled = options.presets === true;
+  const globalLongOptionFlags = getGlobalLongOptionFlags(presetsEnabled);
+  addGlobalOptions(program, presetsEnabled);
   if (version !== void 0) {
     program.version(version, "--version");
   }
@@ -47405,7 +47435,7 @@ async function runCLI(roots, options = {}) {
     await executeCommand(state, servicesWithBuiltIns, requirementOptions, runtimeOptions);
   };
   for (const child of root.children) {
-    const command = createNodeCommand(child, casing, execute2);
+    const command = createNodeCommand(child, casing, globalLongOptionFlags, execute2, presetsEnabled);
     if (command === null) {
       continue;
     }
@@ -47425,7 +47455,7 @@ async function runCLI(roots, options = {}) {
     );
   }
 }
-var RESERVED_SERVICE_NAMES2, NULL_OPTION_VALUE, HELP_FLAGS, GLOBAL_LONG_OPTION_FLAGS, DESIGN_SYSTEM_OUTPUT_BY_MODE;
+var RESERVED_SERVICE_NAMES2, NULL_OPTION_VALUE, HELP_FLAGS, ALWAYS_GLOBAL_LONG_OPTION_FLAGS, DESIGN_SYSTEM_OUTPUT_BY_MODE;
 var init_cli = __esm({
   "packages/toolcraft/src/cli.ts"() {
     "use strict";
@@ -47440,7 +47470,7 @@ var init_cli = __esm({
     RESERVED_SERVICE_NAMES2 = /* @__PURE__ */ new Set(["params", "secrets", "fetch", "fs", "env", "progress"]);
     NULL_OPTION_VALUE = /* @__PURE__ */ Symbol("toolcraft.cli.null");
     HELP_FLAGS = /* @__PURE__ */ new Set(["--help", "-h"]);
-    GLOBAL_LONG_OPTION_FLAGS = /* @__PURE__ */ new Set(["--preset", "--yes", "--output", "--verbose"]);
+    ALWAYS_GLOBAL_LONG_OPTION_FLAGS = ["--yes", "--output", "--verbose"];
     DESIGN_SYSTEM_OUTPUT_BY_MODE = {
       rich: "terminal",
       md: "markdown",
@@ -56808,7 +56838,7 @@ var init_package2 = __esm({
   "package.json"() {
     package_default2 = {
       name: "poe-code",
-      version: "3.0.194",
+      version: "3.0.195",
       description: "CLI tool to configure Poe API for developer workflows.",
       type: "module",
       main: "./dist/index.js",