@shell-shock/core 0.17.7 → 0.17.10

package/dist/resolver/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/resolver/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context,\n    true\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;;;;AAsCX,SAAgB,gCAA2B,MAAW,MAAG,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AACrD,QAAM,IAAA,YAAe,CAAG,eAAe,eAAe,GAAA,gBAAc,SAAA,sBAAA,UAAA,SAAA,SAAA,2BAAA,SAAA,sBAAA,UACpE,YACF,WACK,mBACO,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UACN,cACE,GAAG,SAAK,sBAAA,SAAA,YAAA,SAAA,QAAA,WAAA,MAAA,KAAA;;AAElB,gCAAgB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYhB,SAAa,kCAAsB,MAAA,MAAA,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AAC/B,QAAK,KAAA,YAAS,CAAA,eAAA,cAAA,GAAA,oCAAA,SAAA,sBAAA,UACR,YACA,WACD,mBACJ,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UACL;;AAGA,kCAAkC,SAAQ;CAAA;CAAS;CAAuB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAC1E,SAAC,qBAAA,KAAA;AACG,QAAM,OAAO,YAAY,OAAI,QAAQ,IAAQ,OAAA,QAAA,CAAA,IAAA,cAAA,CAAA,KAAA,YAAA;EAC7C,MAAU,OAAO,OAAA,QAAe;EAChC,MAAM,QAAW,OAAQ,SAAI,UAAQ,KAAY;AACjD,SAAM,CACA,KACA;GACM,GAAA;GACd;GACc;GACF,aAAA,OAAA,eACN,gCAAoB,MAAA,OAAA,MAAA,OAAA,UAAA,OAAA,SAAA,sBAAA,WAAA,OAAA,UAAA,OAAA,OAAA,QAAA;GACf,KAAK,OAAA,OAAA,OAAA,QAAA,QACA,OAAA,MACF,IAAA,MAAA,QAAA,OAAA,gBACC,aAAA,KAAA,GACP;GACG,CACT;IACA;EAAA;EAAc;EAAA;EAAW,CAAI,CAAC,CAAA;;AAElC,qBAAgB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAChB,SAAQ,kBAAA,KAAA;AACJ,QAAO,IAAA,OAAQ,KAAM,IAAA,cAAA,KAAA,MAAA;EACjB,MAAG,OAAU,IAAA,QAAM,MAAA,IAAA;EACrB,MAAO,QAAS,IAAC,SAAU,UAAQ,KAAA;AACjC,SAAK;GACJ,GAAA;GACE;GACD;GACD,aAAA,IAAA,eACJ,kCAAA,MAAA,IAAA,MAAA,IAAA,UAAA,IAAA,SAAA,sBAAA,WAAA,IAAA,UAAA,OAAA,IAAA,QAAA;GACL,KAAA,IAAA,sCAEgB,IAAA,MACA,IAAA,MAAW,QAAA,OAAA,gBACJ,aAAgB,KAAK,GAClB,QACR;;IAEZ;EAAA;EAAO;EAAA;EAAA;EAAA,CAAA,CAAA;;AAEb,kBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACR,SAAa,cAAM,KAAA;AACf,KAAI,OAAM,gBAAA,OAAA,IAAA,OAAA,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,CAAA;AACV,KAAI,YAAO,IAAA,MAAA,QAAA,OAAA,WAAA,SAAA,IACP,IAAE,MAAA,QAAW,OAAA,UAAA,SAAA,SAAA,YAAA,CACb,KAAI,OAAO,cAAa,IAAA,MAAA,QAAA,OAAA,UAAA,WACpB,IAAA,MAAA,QAAA,OAAA,UAA+B,SAAA,QAAA,aAAA,IAAA,MAAA,QAAA,SAC7B,OAAI,cAAA,YAAA,CAAA,qBAAA,QAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CACJ,KAAO,IAAI,CAAA,GACX;;AAGd,cAAc,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA;AACrB,SAAa,sBAAA,KAAA;AACT,KAAI,OAAK,UAAA,UAAA,IAAA,MAAA,QAAA,KAAA;AACT,KAAI,OAAI,gBAAc,6BAAe,IAAA,OAAA,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,IACjC,UAAQ,IAAM,MAAC,QAAA,KAAA,CAAA,qCAAA,YAAA,IAAA,MAAA,SAAA,KAAA,CAAA;;AAEvB,sBAAkB,SAAa;CAAA;CAAI;CAAA;CAAA;CAAA;;;;;;;;AAQnC,MAAO,wBAA8B,WAAE,cAAkB,KAAA,KAAe,UAAG;AACzE,KAAM,SAAK,IAAO,KAAK,IAAK,SAAS,MAAE,EAAA;AACrC,MAAM,YAAW,MAAS,CACpB,KAAM,OAAM;AAElB,SAAO;YAED,MAAA,QAAA,IAAA,KAAA,IAAA,MAAA,QAAA,MAAA,EAAA;AACJ,MAAK,MAAA,SAAA,EACL,KAAA,OAAW,YAAA,IAAA,KAAA,OAAA,MAAA,EAAA,cAAA,SAAA,SAAA,KAAA,GAAA,OAAA,KAAA,UAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;AAET,SAAA;;AAEJ,QAAM;GACP;CAAC;CAAM;CAAI;CAAQ;CAAA;CAAA,CAAA,CAAA"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/resolver/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context,\n    true\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE9B,QAAO;;;;;;;;;;;;;AAsCT,SAAgB,gCAA2B,MAAW,MAAG,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AACvD,QAAO,IAAC,YAAe,CAAA,eAAY,eAAa,GAAQ,gBAAc,SAAA,sBAAA,UAAA,SAAA,SAAA,2BAAA,SAAA,sBAAA,UAAA,YAAA,WAAA,mBAAA,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UAAA,cAAA,GAAA,SAAA,sBAAA,SAAA,YAAA,SAAA,QAAA,WAAA,MAAA,KAAA;;AAExE,gCAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;AAYF,SAAa,kCAAsB,MAAA,MAAA,WAAA,OAAA,WAAA,OAAA,OAAA,cAAA;AACjC,QAAO,KAAI,YAAG,CAAA,eAAA,cAAA,GAAA,oCAAA,SAAA,sBAAA,UAAA,YAAA,WAAA,mBAAA,mBAAA,GAAA,OAAA,MAAA,IAAA,UAAA,KAAA,CAAA,GAAA,SAAA,sBAAA,UAAA,cAAA,GAAA,SAAA,sBAAA,SAAA,YAAA,SAAA,QAAA,WAAA,MAAA,KAAA;;AAEhB,kCAAyB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACzB,SAAW,qBAAgB,KAAA;AACzB,QAAI,OAAO,YAAU,OAAU,QAAQ,IAAA,OAAA,QAAA,CAAA,IAAA,cAAA,CAAA,KAAA,YAAA;EACrC,MAAM,OAAG,OAAA,QAAA;EACT,MAAK,QAAS,OAAA,SAAA,UAAA,KAAA;AACd,SAAO,CAAA,KAAM;GACX,GAAG;GACH;GACD;GACL,aAAA,OAAA,eAAA,gCAAA,MAAA,OAAA,MAAA,OAAA,UAAA,OAAA,SAAA,sBAAA,WAAA,OAAA,UAAA,OAAA,OAAA,QAAA;;GAEE,CAAA;IACC;EAAA;EAAa;EAAA;EAAY,CAAG,CAAC,CAAC;;AAEjC,qBAAqB,SAAQ;CAAA;CAAoB;CAAA;CAAA;CAAA;AACjD,SAAgB,kBAAgB,KAAO;AACrC,QAAO,IAAC,OAAU,KAAC,IAAQ,cAAY,KAAA,MAAY;EACjD,MAAM,OAAA,IAAW,QAAQ,MAAI,IAAA;EAC7B,MAAM,QAAQ,IAAI,SAAS,UAAI,KAAQ;AACvC,SAAM;GACN,GAAA;GACF;GACI;GACA,aAAQ,IAAA,eAAA,kCAAA,MAAA,IAAA,MAAA,IAAA,UAAA,IAAA,SAAA,sBAAA,WAAA,IAAA,UAAA,OAAA,IAAA,QAAA;GACR,KAAE,IAAA,OAAA,IAAA,OAAoB,IAAA,QAAA,QAAA,IAAA,MAAA,IAAA,MAAA,QAAA,OAAA,gBAAA,aAAA,KAAA,GAAA,QAAA;GAC1B;IACA;EAAA;EAAW;EAAK;EAAA;EAAA,CAAA,CAAA;;AAElB,kBAAiB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACjB,SAAU,cAAA,KAAA;AACR,KAAA,OAAW,gBAAA,OAAA,IAAA,OAAA,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,CAAA;AACX,KAAE,YAAa,IAAA,MAAA,QAAiB,OAAS,WAAI,SAAA,IAAA,IAAA,MAAA,QAAA,OAAA,UAAA,SAAA,SAAA,YAAA,CAC3C,KAAA,OAAS,cAAgB,IAAI,MAAK,QAAA,OAAA,UAAA,WAAA,IAAA,MAAA,QAAA,OAAA,UAAA,SAAA,QAAA,aAAA,IAAA,MAAA,QAAA,SAAA,OAAA,cAAA,YAAA,CAAA,qBAAA,QAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,KAAA,IAAA,CAAA,GAAA;;AAGtC,cAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACR,SAAW,sBAAc,KAAA;AACvB,KAAI,OAAK,UAAU,UAAM,IAAA,MAAA,QAAA,KAAA;AACzB,KAAI,OAAO,gBAAU,6BAAkB,IAAA,OAAA,MAAA,QAAA,oBAAA,GAAA,CAAA,MAAA,IAAA,UAAA,IAAA,MAAA,QAAA,KAAA,CAAA,qCAAA,YAAA,IAAA,MAAA,SAAA,KAAA,CAAA;;AAEzC,sBAAkB,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQlB,MAAS,wBAAkB,WAAA,cAAA,KAAA,KAAA,UAAA;AACzB,KAAE,SAAO,IAAQ,KAAI,IAAA,SAAc,MAAM,EAAE;AACzC,MAAE,YAAa,MAAO,CACpB,KAAA,OAAW;AAEb,SAAE;YACK,MAAA,QAAA,IAAA,KAAA,IAAA,MAAA,QAAA,MAAA,EAAA;AACP,MAAI,MAAA,SAAA,EACF,KAAI,OAAG,YAAM,IAAA,KAAA,OAAA,MAAA,EAAA,cAAA,SAAA,SAAA,KAAA,GAAA,OAAA,KAAA,UAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;AAEf,SAAM;;AAER,QAAO;GACN;CAAC;CAAO;CAAC;CAAA;CAAA;CAA+B,CAAA,CAAA"}

package/dist/resolver/module.cjs

@@ -34,7 +34,7 @@ function resolveCommandOption(name, parent, schema) {
 		result.variadic = (0, _stryke_json.isJsonSchema7ArrayType)(schema);
 		if (result.kind === require_types_command.CommandParameterKinds.string) result.format = schema.format;
 		if (((0, _stryke_json.isJsonSchema7StringType)(schema) || (0, _stryke_json.isJsonSchema7NumberType)(schema)) && schema.enum) result.choices = schema.enum;
-	} else if (result.kind === require_types_command.CommandParameterKinds.boolean) {
+	} else if (result.kind === require_types_command.CommandParameterKinds.boolean && !result.variadic) {
 		result.skipAddingNegative = schema.skipAddingNegative;
 		result.isNegativeOf = schema.isNegativeOf;
 	}

package/dist/resolver/module.mjs

@@ -33,7 +33,7 @@ function resolveCommandOption(name, parent, schema) {
 		result.variadic = isJsonSchema7ArrayType(schema);
 		if (result.kind === CommandParameterKinds.string) result.format = schema.format;
 		if ((isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) && schema.enum) result.choices = schema.enum;
-	} else if (result.kind === CommandParameterKinds.boolean) {
+	} else if (result.kind === CommandParameterKinds.boolean && !result.variadic) {
 		result.skipAddingNegative = schema.skipAddingNegative;
 		result.isNegativeOf = schema.isNegativeOf;
 	}

package/dist/resolver/module.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"module.mjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (result.kind === CommandParameterKinds.boolean) {\n    result.skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    result.isNegativeOf = (schema as { isNegativeOf?: string }).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n  if (isSetString(metadata.tags)) {\n    ctx.output.tags = getUnique(ctx.output.tags.concat(toArray(metadata.tags)));\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options as JsonSchema7ObjectType;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries((jsonSchema as JsonSchema7ObjectType).properties)\n          .map(([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        )\n          .map(([name, option]) => [\n            name,\n            { name, ...option, alias: toArray(option.alias) }\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;AAE3D,IAAG,SAAS;;;AA4BhB,SAAE,qBAAuB,MAAA,QAAA,QAAA;CACvB,MAAA,SAAA;EACA;EACM,MAAC,uBAAY,OAAA,IAAA,OAAA,QACZ,wBAA4B,OAAK,MAAS,GAC1C,sBAA4B,SAC5B,sBAA+B,SAC/B,yBAA2B,OAAS,GACjC,sBAAA,UACK,wBAAA,OAAA,GACF,sBAAA,SACb,sBAAsB;EACtB,OAAO,OAAA;EACP,aAAA,OAAA;EACM,OAAG,QAAM,OAAA,SAAA,EAAA,CAAA;EACT,KAAC,OAAA;EACF,UAAO,CAAA,OAAA,UAAsB,SAAS,KAAC;;EAE9C;AACE,KAAM,OAAM,SAAA,sBAAA,UACN,OAAE,SAAA,sBAAqB,QAAA;AACvB,SAAE,WAAA,uBAAA,OAAA;AACP,MAAQ,OAAA,SAAe,sBAAA,OAClB,QAAS,SAAA,OAAA;AAET,OAAA,wBAAA,OAAA,IAAA,wBAAA,OAAA,KACF,OAAA,KACI,QAAA,UAAA,OAAwB;YAGxB,OAAA,SAAA,sBAA+B,SAAA;AACjC,SAAI,qBAAsB,OAAA;AAC1B,SAAI,eAAA,OAAwB;;AAEhC,QAAO;;AAEX,qBAAiB,SAAO;CAAA;CAAW;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACnC,SAAS,uBAAuB,QAAQ;CACpC,MAAM,SAAS;EACf,MAAU,OAAO;EACjB,MAAS,uBAAO,OAAA,IAAA,OAAA,QACN,wBAAe,OAAA,MAAA,GACxB,sBAAA,SACa,sBAAE,SACT,yBAAS,OAAsB,GACtC,sBAAA,UACO,wBAAW,OAAuB,GACvB,sBAAE,SACF,sBAAA;EACd,OAAO,OAAK;EACZ,aAAM,OAAA;EACV,OAAA,QAAA,OAAA,SAAA,EAAA,CAAA;;EAEG,SAAA,OAAA;EACF;AACD,KAAG,OAAO,SAAG,sBAAqB,UAChC,OAAA,SAAA,sBAAA,QAAA;AACA,SAAO,WAAW,uBAAU,OAAqB;AACnD,MAAA,OAAA,SAAA,sBAAA,OACQ,QAAO,SAAS,OAAC;AAEvB,OAAO,wBAAwB,OAAE,IAAQ,wBAAA,OAAA,KACzC,OAAA,KACK,QAAA,UAAgB,OAAS;;AAGlC,QAAO;;;;;;;;;AAGT,eAAS,mBAAsB,KAAA;AAC7B,iBAAQ,IAAA;CACP,MAAO,WAAC,IAAA,QAAiB,YAAA,EAAA;AAC1B,KAAM,YAAS,SAAA,MAAA,CACT,KAAG,OAAO,QAAS,SAAS;AAEhC,KAAE,YAAA,SAAuB,YAAW,CAChC,KAAE,OAAA,cAAuB,SAAQ;AAErC,KAAI,YAAI,SAAA,MAAsB,IACzB,MAAC,QAAA,SAAA,MAAyB,IAAM,SAAA,MAAA,SAAA,EACjC,KAAI,OAAA,QAAA,QAAsB,SAAA,MAAA;AAE9B,KAAI,YAAM,SAAA,KAAA,CACN,KAAI,OAAE,OAAA,SAAqB;AAE/B,KAAA,YAAa,SAAO,KAAA,CACpB,KAAO,OAAQ,OAAO,UAAM,IAAQ,OAAO,KAAE,OAAU,QAAQ,SAAM,KAAA,CAAA,CAAA;AAErE,KAAA,YAAgB,IAAA,QAAA,QAAA,CACb,KAAA,WAAQ,IAAA,OAAgB,QAAA,IAC1B,qBAAA,IAAA,OAAA,QAAA,IACM,wBAAS,IAAA,OAAsB,QAAQ,EAAA;EACvC,IAAK;AACZ,MAAA,WAAA,IAAA,OAAA,QAAA,CACO,cAAW,mBAAuB,IAAO,OAAA,QAAA;WAE/B,qBAAC,IAAA,OAAA,QAAA,CACP,cAAc,IAAA,OAAA,QAAA,aAAgC,WAAC,MAAA,EAChD,QAAA,YACV,CAAA;MAGG,cAAA,IAAwB,OAAS;AAElC,MAAA,CAAA,wBAAA,WAAA,CACO,OAAS,IAAE,UAAU,wCAAyB,IAAA,MAAA,QAAA,KAAA,mGAAA;AAEzD,MAAA,OAAA,UAAA,OAAA,YAAA,OAAA,QAAA,WAAA,WAAA,yCAEa,MACf,qBAAA,MAAA,YAAA,SAAA;;;;MAEa,OAAS,OAAA,QAAA,IAAmB,OAAS,QAAQ,CAAA,CAAA;YAExD,OAAA,OAAA,IAAA,OAAA,QAAA,CAAA,MAAA,yBAAA,CACA,KAAA,OAAoB,UAAA,OAAA,YAAA,OAAA,QAAA,IAAA,OAAA,QAAA,uCAEN,MACV;EAAY;EAAA,GAAS;EAAQ,OAAA,QAAA,OAAA,MAAA;EAAA,CAC3B,EAAO;EAAA;EAAQ;EAAA;EAAc,CAAA,CAAA,CACnC,OAAA,OAAA,QAAA,IAAA,OAAA,QAAA,CAAA,CAAA;KAGA,OAAA,IAAA,UAAA,wCAAA,IAAA,MAAA,QAAA,KAAA,sHAAA;AAGE,KAAC,YAAc,IAAA,QAAS,KAAS,CACjC,KAAA,WAAA,IAAA,OAAA,KAAA,IACI,qBAAuB,IAAA,OAAS,KAAM,IAC5C,uBAAA,IAAA,OAAA,KAAA,EAAA;EACI,IAAA;AACE,MAAO,WAAO,IAAS,OAAI,KAAA,CACjC,cAAA,mBAAA,IAAA,OAAA,KAAA;WAEmB,qBAAqB,IAAC,OAAK,KAAO,CACrD,cAAA,IAAA,OAAA,KAAA,aAAA,WAAA,MAAA,sBAEe,CAAC;MAGZ,cAAqB,IAAI,OAAO;AAEhC,MAAA,CAAA,uBAAA,WAAA,CACI,OAAY,IAAA,UAAA,0CAAe,IAAA,MAAA,QAAA,KAAA,8GAAA;AAE7B,MAAA,OAAa,OAAA,WAAmB,MAAI,IAAO,cAAQ,SAAA,uBAAA,KAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;YAEnD,OAAgB,OAAO,IAAC,OAAU,KAAA,CAAA,MAAW,yBAAiB,CAC5D,KAAM,OAAG,OAAQ,IAAA,OAAA,KAAA,IAAA,cAAA,SAAA;EACjB,GAAA;EACG,OAAA,QAAA,IAAA,MAAA;EACL,GAAA;EAAA;EAAgB;EAAC;EAAO,CAAO,CAAC;KAG7B,OAAA,IAAA,UAAA,0CAAqC,IAAA,MAAA,QAAA,KAAA,6HAAA;;AAIhD,mBAAkB,SAAU;CAAC;CAAgB;CAAU;CAAqB;CAAa;AACzF,SAAS,gBAAA,KAAA;AACL,KAAE,CAAA,IAAA;UAGE,CAAM,YAAU,IAAA,OAAa,CAC7B,OAAM,IAAG,UAAM,2BAAc,IAAA,MAAA,QAAA,KAAA,uEAAA;UAEzB,EAAA,aAAA,IAAoB,QACxB,OAAG,IAAA,MAAA,2BAAA,IAAA,MAAA,QAAA,KAAA,+GAAA;;AAGX,gBAAc,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"module.mjs","names":[],"sources":["../../src/resolver/module.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport type {\n  JsonSchema7EnumType,\n  JsonSchema7ObjectType,\n  JsonSchema7Type\n} from \"@stryke/json\";\nimport {\n  isJsonSchema7ArrayType,\n  isJsonSchema7BooleanType,\n  isJsonSchema7NumberType,\n  isJsonSchema7ObjectType,\n  isJsonSchema7StringType,\n  isJsonSchema7TupleType,\n  isStandardJsonSchema\n} from \"@stryke/json\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { extractJsonSchema7, isZod3Type } from \"@stryke/zod\";\nimport { isCommandParameterConfig } from \"../plugin-utils\";\nimport type {\n  BooleanCommandOption,\n  CommandArgument,\n  CommandOption,\n  CommandParameterConfig,\n  Context,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport type { ResolverContext } from \"./types\";\n\nfunction resolveCommandOption(\n  name: string,\n  parent: JsonSchema7ObjectType,\n  schema: JsonSchema7Type\n): Partial<CommandOption> {\n  const result = {\n    name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    optional: !parent.required?.includes(name),\n    default: schema.default\n  } as Partial<CommandOption>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  } else if (\n    result.kind === CommandParameterKinds.boolean &&\n    !result.variadic\n  ) {\n    (result as BooleanCommandOption).skipAddingNegative = (\n      schema as { skipAddingNegative?: boolean }\n    ).skipAddingNegative;\n    (result as BooleanCommandOption).isNegativeOf = (\n      schema as { isNegativeOf?: string }\n    ).isNegativeOf;\n  }\n\n  return result;\n}\n\nfunction resolveCommandArgument(\n  schema: JsonSchema7Type\n): Partial<CommandArgument> {\n  const result = {\n    name: (schema as { name?: string }).name,\n    kind:\n      isJsonSchema7ArrayType(schema) && schema.items\n        ? isJsonSchema7NumberType(schema.items)\n          ? CommandParameterKinds.number\n          : CommandParameterKinds.string\n        : isJsonSchema7BooleanType(schema)\n          ? CommandParameterKinds.boolean\n          : isJsonSchema7NumberType(schema)\n            ? CommandParameterKinds.number\n            : CommandParameterKinds.string,\n    title: schema.title,\n    description: schema.description,\n    alias: toArray((schema as { alias?: string | string[] }).alias || []),\n    env: (schema as { env?: string }).env,\n    default: schema.default\n  } as Partial<CommandArgument>;\n  if (\n    result.kind === CommandParameterKinds.string ||\n    result.kind === CommandParameterKinds.number\n  ) {\n    result.variadic = isJsonSchema7ArrayType(schema);\n    if (result.kind === CommandParameterKinds.string) {\n      result.format = (\n        schema as { format?: StringCommandParameter[\"format\"] }\n      ).format;\n    }\n\n    if (\n      (isJsonSchema7StringType(schema) || isJsonSchema7NumberType(schema)) &&\n      (schema as JsonSchema7EnumType).enum\n    ) {\n      result.choices = (schema as JsonSchema7EnumType).enum;\n    }\n  }\n\n  return result;\n}\n\nexport async function resolveFromExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  validateExports(ctx);\n\n  const metadata = ctx.module?.metadata ?? {};\n  if (isSetString(metadata.title)) {\n    ctx.output.title = metadata.title;\n  }\n  if (isSetString(metadata.description)) {\n    ctx.output.description = metadata.description;\n  }\n  if (\n    isSetString(metadata.alias) ||\n    (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n  ) {\n    ctx.output.alias = toArray(metadata.alias);\n  }\n  if (isSetString(metadata.icon)) {\n    ctx.output.icon = metadata.icon;\n  }\n  if (isSetString(metadata.tags)) {\n    ctx.output.tags = getUnique(ctx.output.tags.concat(toArray(metadata.tags)));\n  }\n\n  if (isSetObject(ctx.module?.options)) {\n    if (\n      isZod3Type(ctx.module.options) ||\n      isStandardJsonSchema(ctx.module.options) ||\n      isJsonSchema7ObjectType(ctx.module.options)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.options)) {\n        jsonSchema = extractJsonSchema7(ctx.module.options);\n      } else if (isStandardJsonSchema(ctx.module.options)) {\n        jsonSchema = ctx.module.options[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.options;\n      }\n\n      if (!isJsonSchema7ObjectType(jsonSchema)) {\n        throw new TypeError(\n          `Command options for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod object schema, a standard JSON Schema object, or a JSON Schema object.`\n        );\n      }\n\n      ctx.output.options = Object.fromEntries(\n        Object.entries(jsonSchema.properties)\n          .map(([name, property]) => [\n            name,\n            resolveCommandOption(name, jsonSchema, property)\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else if (\n      Object.values(ctx.module.options).every(isCommandParameterConfig)\n    ) {\n      ctx.output.options = Object.fromEntries(\n        Object.entries(\n          ctx.module.options as Record<string, CommandParameterConfig>\n        )\n          .map(([name, option]) => [\n            name,\n            { name, ...option, alias: toArray(option.alias) }\n          ])\n          .concat(Object.entries(ctx.output.options))\n      ) as Record<string, CommandOption>;\n    } else {\n      throw new TypeError(\n        `Command options for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandOption objects, a Zod object schema, or a standard JSON Schema object.`\n      );\n    }\n  }\n\n  if (isSetObject(ctx.module?.args)) {\n    if (\n      isZod3Type(ctx.module.args) ||\n      isStandardJsonSchema(ctx.module.args) ||\n      isJsonSchema7TupleType(ctx.module.args)\n    ) {\n      let jsonSchema: JsonSchema7Type;\n      if (isZod3Type(ctx.module.args)) {\n        jsonSchema = extractJsonSchema7(ctx.module.args);\n      } else if (isStandardJsonSchema(ctx.module.args)) {\n        jsonSchema = ctx.module.args[\"~standard\"].jsonSchema.input({\n          target: \"draft-07\"\n        });\n      } else {\n        jsonSchema = ctx.module.args;\n      }\n\n      if (!isJsonSchema7TupleType(jsonSchema)) {\n        throw new TypeError(\n          `Command arguments for command at path \"${\n            ctx.input.command.path\n          }\" must be defined as a Zod tuple schema, a standard JSON Schema tuple object, or a JSON Schema tuple object.`\n        );\n      }\n\n      ctx.output.args = jsonSchema.items.map(item =>\n        resolveCommandArgument(item)\n      ) as CommandArgument[];\n    } else if (Object.values(ctx.module.args).every(isCommandParameterConfig)) {\n      ctx.output.args = ctx.module.args.map(arg => ({\n        ...arg,\n        alias: toArray(arg.alias)\n      })) as CommandArgument[];\n    } else {\n      throw new TypeError(\n        `Command arguments for command at path \"${\n          ctx.input.command.path\n        }\" must be defined as a record of valid CommandArgument objects, a Zod tuple schema, or a standard JSON Schema tuple object.`\n      );\n    }\n  }\n}\n\nfunction validateExports<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  if (!ctx.module) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is undefined or null. Please ensure the module exports a valid command.`\n    );\n  } else if (!isSetObject(ctx.module)) {\n    throw new TypeError(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" is not an object. Please ensure the module exports a valid command.`\n    );\n  } else if (!(\"default\" in ctx.module)) {\n    throw new Error(\n      `Command module at path \"${\n        ctx.input.command.path\n      }\" does not appear to be valid. Please ensure the module's default export is a valid command handler function.`\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/resolver/resolve.cjs

@@ -5,10 +5,10 @@ const require_utilities = require('../helpers/utilities.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_deepkit$1 = require('./deepkit.cjs');
 const require_module = require('./module.cjs');
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
-let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
 let _powerlines_plugin_esbuild_helpers_resolve = require("@powerlines/plugin-esbuild/helpers/resolve");
 

package/dist/resolver/resolve.mjs

@@ -4,10 +4,10 @@ import { getGlobalOptions } from "../helpers/utilities.mjs";
 import { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand } from "./helpers.mjs";
 import { resolveFromBytecode } from "./deepkit.mjs";
 import { resolveFromExports } from "./module.mjs";
+import { ReflectionVisibility } from "@powerlines/deepkit/vendor/type";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
-import { ReflectionVisibility } from "@powerlines/deepkit/vendor/type";
 import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
 import { resolveModule } from "@powerlines/plugin-esbuild/helpers/resolve";
 

package/dist/resolver/resolve.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    source: \"file\",\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for CLI command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        treeShaking: true,\n        resolve: {\n          skipNodeModulesBundle: true\n        },\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            level: \"all\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    tags: parent?.tags ?? [],\n    source: \"file\",\n    ...command,\n    title,\n    options: parent === null ? getGlobalOptions(context, command) : {},\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for CLI command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        name: command.title || titleCase(command.name),\n        treeShaking: true,\n        resolve: {\n          skipNodeModulesBundle: true\n        },\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            level: \"all\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}

package/dist/types/command.d.cts

@@ -1,7 +1,7 @@
 import { ResolvedEntryTypeDefinition } from "powerlines";
+import { AnyFunction } from "@stryke/types/base";
 import { StandardJSONSchemaV1 } from "@standard-schema/spec";
 import { JsonSchema7TupleType } from "@stryke/json";
-import { AnyFunction } from "@stryke/types/base";
 import { JSONSchema7Object } from "json-schema";
 import * as z3 from "zod/v3";
 

package/dist/types/command.d.mts

@@ -1,7 +1,7 @@
-import { ResolvedEntryTypeDefinition } from "powerlines";
 import { JsonSchema7TupleType } from "@stryke/json";
-import { StandardJSONSchemaV1 } from "@standard-schema/spec";
+import { ResolvedEntryTypeDefinition } from "powerlines";
 import { AnyFunction } from "@stryke/types/base";
+import { StandardJSONSchemaV1 } from "@standard-schema/spec";
 import { JSONSchema7Object } from "json-schema";
 import * as z3 from "zod/v3";
 

package/dist/types/command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command.mjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The option description.\n   */\n  description: string;\n\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n\n  /**\n   * The default value.\n   */\n  default?: string | number | boolean | string[] | number[] | boolean[];\n\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n}\n\nexport interface BaseSingleCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string | number | boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface BaseVariadicCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string[] | number[] | boolean[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport interface BaseStringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n\n  /**\n   * The default value.\n   */\n  default?: string | string[];\n\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface SingleStringCommandParameter extends BaseStringCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicStringCommandParameter extends BaseStringCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type StringCommandParameter =\n  | SingleStringCommandParameter\n  | VariadicStringCommandParameter;\n\nexport interface BaseNumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n\n  /**\n   * The default value.\n   */\n  default?: number | number[];\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface SingleNumberCommandParameter extends BaseNumberCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: number;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicNumberCommandParameter extends BaseNumberCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: number[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type NumberCommandParameter =\n  | SingleNumberCommandParameter\n  | VariadicNumberCommandParameter;\n\nexport interface BaseBooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n\n  /**\n   * The default value.\n   */\n  default?: boolean | boolean[];\n}\n\nexport interface SingleBooleanCommandParameter extends BaseBooleanCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicBooleanCommandParameter extends BaseBooleanCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: boolean[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type BooleanCommandParameter =\n  | SingleBooleanCommandParameter\n  | VariadicBooleanCommandParameter;\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends SingleBooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption\n  | VariadicBooleanCommandParameter;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   */\n  reference?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n\n  /**\n   * A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.\n   */\n  source?: \"file\" | string;\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The command description.\n   */\n  description: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n\n  /**\n   * A set of tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags: string[];\n\n  /**\n   * A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.\n   */\n  source: \"file\" | string;\n\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the command. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":"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"}
+{"version":3,"file":"command.mjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\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/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The option description.\n   */\n  description: string;\n\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n\n  /**\n   * The default value.\n   */\n  default?: string | number | boolean | string[] | number[] | boolean[];\n\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n}\n\nexport interface BaseSingleCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string | number | boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface BaseVariadicCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string[] | number[] | boolean[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport interface BaseStringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n\n  /**\n   * The default value.\n   */\n  default?: string | string[];\n\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface SingleStringCommandParameter extends BaseStringCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicStringCommandParameter extends BaseStringCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: string[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type StringCommandParameter =\n  | SingleStringCommandParameter\n  | VariadicStringCommandParameter;\n\nexport interface BaseNumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n\n  /**\n   * The default value.\n   */\n  default?: number | number[];\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface SingleNumberCommandParameter extends BaseNumberCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: number;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicNumberCommandParameter extends BaseNumberCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: number[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type NumberCommandParameter =\n  | SingleNumberCommandParameter\n  | VariadicNumberCommandParameter;\n\nexport interface BaseBooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n\n  /**\n   * The default value.\n   */\n  default?: boolean | boolean[];\n}\n\nexport interface SingleBooleanCommandParameter extends BaseBooleanCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: boolean;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: false;\n}\n\nexport interface VariadicBooleanCommandParameter extends BaseBooleanCommandParameter {\n  /**\n   * The default value.\n   */\n  default?: boolean[];\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: true;\n}\n\nexport type BooleanCommandParameter =\n  | SingleBooleanCommandParameter\n  | VariadicBooleanCommandParameter;\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends SingleBooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption\n  | VariadicBooleanCommandParameter;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   */\n  reference?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n\n  /**\n   * A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.\n   */\n  source?: \"file\" | string;\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The command description.\n   */\n  description: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n\n  /**\n   * A set of tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags: string[];\n\n  /**\n   * A string representing the source of the command, which can be \"file\", a specific plugin name, or any other string value that describes the source that added the command.\n   */\n  source: \"file\" | string;\n\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * Optional tags for the command.\n   *\n   * @remarks\n   * Tags can be used to categorize and organize commands, and can also be utilized by plugins to provide additional functionality or filtering based on tags.\n   */\n  tags?: string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the command. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":"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"}

package/dist/types/config.cjs

@@ -12,11 +12,6 @@ const __ΩPartial = [
 	"Partial",
 	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
 ];
-const __ΩRequired = [
-	"T",
-	"Required",
-	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
-];
 const __ΩOmit = [
 	"T",
 	"K",
@@ -25,6 +20,11 @@ const __ΩOmit = [
 	"Omit",
 	"b!b\"e!!e!!ge!\"o$#o##w%y"
 ];
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
 const __ΩRecord = [
 	"K",
 	"T",
@@ -37,22 +37,6 @@ const __ΩExclude = [
 	"Exclude",
 	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
 ];
-const __ΩBuildOptions = [
-	() => __ΩPick,
-	"root",
-	"name",
-	"title",
-	"description",
-	"logLevel",
-	"mode",
-	"skipCache",
-	"autoInstall",
-	"plugins",
-	"tsconfig",
-	"tsconfigRaw",
-	"BuildOptions",
-	"!P.\".#.$.%.&.'.(.).*.+.,Jo!#w-y"
-];
 const __ΩReferenceOptions = [
 	"app",
 	"A URL to the application documentation or reference.",
@@ -62,8 +46,6 @@ const __ΩReferenceOptions = [
 	"P&4!?\"&4#8?$Mw%y"
 ];
 const __ΩBaseOptions = [
-	() => __ΩPartial,
-	() => __ΩBuildOptions,
 	"CommandOption",
 	"Context",
 	"context",
@@ -85,7 +67,7 @@ const __ΩBaseOptions = [
 	"reference",
 	"A URL to the application documentation or reference.",
 	"BaseOptions",
-	"Pn\"o!\"PP\"w#FP\"w$2%\"w&2'\"w#F/(.)J4*8?+)4,8>-?.P&&FJ4/8?0P.1&J428?3Pn4&J458?6MKw7y"
+	"PP\"w!FP\"w\"2#\"w$2%\"w!F/&.'J4(8?))4*8>+?,P&&FJ4-8?.P./&J408?1Pn2&J438?4Mw5y"
 ];
 const __ΩOptions = [
 	() => __ΩBaseOptions,
@@ -98,22 +80,29 @@ const __ΩOutputConfig = [
 	"path",
 	"copy",
 	"storage",
+	"sourceMap",
 	false,
 	"dts",
 	"An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.",
 	"OutputConfig",
-	"P!P.\".#.$Jo!#P.%4&8?'MKw(y"
+	"P!P.\".#.$.%Jo!#P.&4'8?(MKw)y"
 ];
 const __ΩUserConfig = [
 	() => __ΩBaseOptions,
-	() => __ΩPartial,
-	() => __ΩPick,
-	"root",
 	() => __ΩOutputConfig,
 	"output",
 	"Configuration for the output of the build process",
 	"UserConfig",
-	"Pn!!o\"\"!.$o##Pn%4&8?'MKw(y"
+	"Pn!!Pn\"4#8?$MKw%y"
+];
+const __ΩEngineOptions = [
+	() => __ΩOmit,
+	"root",
+	"name",
+	"framework",
+	() => __ΩUserConfig,
+	"EngineOptions",
+	"P!P.\".#.$Jo!#n%Kw&y"
 ];
 const __ΩResolvedConfig = [
 	() => __ΩRequired,
@@ -133,10 +122,11 @@ const __ΩResolvedConfig = [
 	"userConfig",
 	"The user configuration for the Shell Shock process.",
 	"ResolvedConfig",
-	"P!!!n#P.$.%Jo\"#o!\"P&&o&#4'?(n)4*?+&4,?-n.4/?0MKw1y"
+	"P!!!!n#P.$.%Jo\"#o!\"P&&o&#4'?(n)4*?+&4,?-n.4/?0MKw1y"
 ];
 
 //#endregion
+exports.__ΩEngineOptions = __ΩEngineOptions;
 exports.__ΩOptions = __ΩOptions;
 exports.__ΩOutputConfig = __ΩOutputConfig;
 exports.__ΩReferenceOptions = __ΩReferenceOptions;

package/dist/types/config.d.cts

@@ -1,12 +1,14 @@
 import { CommandBase, CommandOption } from "./command.cjs";
 import { Context } from "./context.cjs";
-import { OutputConfig as OutputConfig$1 } from "powerlines";
+import { EngineOptions as EngineOptions$1, OutputConfig as OutputConfig$1, UserConfig as UserConfig$1 } from "powerlines";
+import { AlloyPluginResolvedConfig } from "@powerlines/plugin-alloy/types/plugin";
 import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd";
-import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
-import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { RequiredKeys } from "@stryke/types/base";
 
 //#region src/types/config.d.ts
-type BuildOptions = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+type BuildOptions = Pick<UserConfig$1, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
 interface ReferenceOptions {
   /**
    * A URL to the application documentation or reference.
@@ -20,7 +22,7 @@ interface ReferenceOptions {
    */
   commands?: string;
 }
-type BaseOptions = Partial<BuildOptions> & {
+interface BaseOptions {
   /**
    * A set of global command options to apply to each command.
    *
@@ -62,7 +64,7 @@ type BaseOptions = Partial<BuildOptions> & {
    * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{reference}/command/subcommand`.
    */
   reference?: ReferenceOptions | string;
-};
+}
 /**
  * The plugin options for Shell Shock.
  */
@@ -70,7 +72,7 @@ type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
-type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
+type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage" | "sourceMap"> & {
   /**
    * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
@@ -79,16 +81,17 @@ type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
 /**
  * The user configuration options for Shell Shock.
  */
-type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & Pick<NodeJsPluginUserConfig, "root"> & {
+type UserConfig = BaseOptions & RequiredKeys<BuildOptions, "root" | "name"> & {
   /**
    * Configuration for the output of the build process
    */
   output?: OutputConfig;
 };
+type EngineOptions = Omit<EngineOptions$1, "root" | "name" | "framework"> & UserConfig;
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & AlloyPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *
@@ -114,5 +117,5 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
   userConfig: UserConfig;
 };
 //#endregion
-export { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
+export { EngineOptions, Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
 //# sourceMappingURL=config.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBsB;AAcxB;;;;;EAYE,QAAA;AAAA;AAAA,KAGG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAAA;;;;;;EAOzB,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAuCnB;;;;;EA/B5B,eAAA;EARe;;;;;;;;;;EAoBf,GAAA;EAmB4B;AAM9B;;;;;;;;EAdE,aAAA;EAckC;;;;AAKpC;;EAXE,SAAA,GAAY,gBAAA;AAAA;;;;KAMF,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;AAkB5C;;KAbY,YAAA,GAAe,IAAA,CACzB,cAAA;EAYuB;;;EANvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA,IACR,IAAA,CAAK,sBAAA;EADL;;;EAKE,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EAHU;;;;;;;;;;EActB,GAAA,EAAK,MAAA;EAeiB;;;EAVtB,SAAA,EAAW,gBAAA;EAjBb;;;EAsBE,oBAAA;EAVA;;;EAeA,UAAA,EAAY,UAAA;AAAA"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;;;KAkCK,YAAA,GAAe,IAAA,CAClB,YAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBoB;AActB;;;;;EAYE,QAAA;AAAA;AAAA,UAGQ,WAAA;EAQJ;;;;;;EADJ,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAF/C;;;;;EAUA,eAAA;EAR+C;;;;;;;;AA6CjD;;EAzBE,GAAA;EAyBoB;;;;;;;;;EAdpB,aAAA;EAmBU;;;;;;EAXV,SAAA,GAAY,gBAAA;AAAA;;AAwBd;;KAlBY,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;;;KAKhC,YAAA,GAAe,IAAA,CACzB,cAAA;EAiBuB;;;EAXvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,YAAA,CAAa,YAAA;EAOH;;;EAHR,MAAA,GAAS,YAAA;AAAA;AAAA,KAGD,aAAA,GAAgB,IAAA,CAC1B,eAAA,mCAGA,UAAA;;;;KAKU,cAAA,GAAiB,0BAAA,GAC3B,yBAAA,GACA,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EATd;;;AAKF;;;;;;;EAeI,GAAA,EAAK,MAAA;EAXE;;;EAgBP,SAAA,EAAW,gBAAA;EAUC;;;EALZ,oBAAA;EAxBF;;;EA6BE,UAAA,EAAY,UAAA;AAAA"}

package/dist/types/config.d.mts

@@ -1,12 +1,14 @@
 import { CommandBase, CommandOption } from "./command.mjs";
 import { Context } from "./context.mjs";
-import { OutputConfig as OutputConfig$1 } from "powerlines";
 import { AutoMDPluginResolvedConfig } from "@powerlines/plugin-automd";
-import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
-import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { EngineOptions as EngineOptions$1, OutputConfig as OutputConfig$1, UserConfig as UserConfig$1 } from "powerlines";
+import { AlloyPluginResolvedConfig } from "@powerlines/plugin-alloy/types/plugin";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig } from "@powerlines/plugin-nodejs/types/plugin";
+import { TsdownPluginResolvedConfig } from "@powerlines/plugin-tsdown/types/plugin";
+import { RequiredKeys } from "@stryke/types/base";
 
 //#region src/types/config.d.ts
-type BuildOptions = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+type BuildOptions = Pick<UserConfig$1, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
 interface ReferenceOptions {
   /**
    * A URL to the application documentation or reference.
@@ -20,7 +22,7 @@ interface ReferenceOptions {
    */
   commands?: string;
 }
-type BaseOptions = Partial<BuildOptions> & {
+interface BaseOptions {
   /**
    * A set of global command options to apply to each command.
    *
@@ -62,7 +64,7 @@ type BaseOptions = Partial<BuildOptions> & {
    * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{reference}/command/subcommand`.
    */
   reference?: ReferenceOptions | string;
-};
+}
 /**
  * The plugin options for Shell Shock.
  */
@@ -70,7 +72,7 @@ type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
-type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
+type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage" | "sourceMap"> & {
   /**
    * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
@@ -79,16 +81,17 @@ type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
 /**
  * The user configuration options for Shell Shock.
  */
-type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & Pick<NodeJsPluginUserConfig, "root"> & {
+type UserConfig = BaseOptions & RequiredKeys<BuildOptions, "root" | "name"> & {
   /**
    * Configuration for the output of the build process
    */
   output?: OutputConfig;
 };
+type EngineOptions = Omit<EngineOptions$1, "root" | "name" | "framework"> & UserConfig;
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & AlloyPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *
@@ -114,5 +117,5 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
   userConfig: UserConfig;
 };
 //#endregion
-export { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
+export { EngineOptions, Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
 //# sourceMappingURL=config.d.mts.map

package/dist/types/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBsB;AAcxB;;;;;EAYE,QAAA;AAAA;AAAA,KAGG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAAA;;;;;;EAOzB,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAuCnB;;;;;EA/B5B,eAAA;EARe;;;;;;;;;;EAoBf,GAAA;EAmB4B;AAM9B;;;;;;;;EAdE,aAAA;EAckC;;;;AAKpC;;EAXE,SAAA,GAAY,gBAAA;AAAA;;;;KAMF,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;AAkB5C;;KAbY,YAAA,GAAe,IAAA,CACzB,cAAA;EAYuB;;;EANvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA,IACR,IAAA,CAAK,sBAAA;EADL;;;EAKE,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EAHU;;;;;;;;;;EActB,GAAA,EAAK,MAAA;EAeiB;;;EAVtB,SAAA,EAAW,gBAAA;EAjBb;;;EAsBE,oBAAA;EAVA;;;EAeA,UAAA,EAAY,UAAA;AAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;;;KAkCK,YAAA,GAAe,IAAA,CAClB,YAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBoB;AActB;;;;;EAYE,QAAA;AAAA;AAAA,UAGQ,WAAA;EAQJ;;;;;;EADJ,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAF/C;;;;;EAUA,eAAA;EAR+C;;;;;;;;AA6CjD;;EAzBE,GAAA;EAyBoB;;;;;;;;;EAdpB,aAAA;EAmBU;;;;;;EAXV,SAAA,GAAY,gBAAA;AAAA;;AAwBd;;KAlBY,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;;;KAKhC,YAAA,GAAe,IAAA,CACzB,cAAA;EAiBuB;;;EAXvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,YAAA,CAAa,YAAA;EAOH;;;EAHR,MAAA,GAAS,YAAA;AAAA;AAAA,KAGD,aAAA,GAAgB,IAAA,CAC1B,eAAA,mCAGA,UAAA;;;;KAKU,cAAA,GAAiB,0BAAA,GAC3B,yBAAA,GACA,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EATd;;;AAKF;;;;;;;EAeI,GAAA,EAAK,MAAA;EAXE;;;EAgBP,SAAA,EAAW,gBAAA;EAUC;;;EALZ,oBAAA;EAxBF;;;EA6BE,UAAA,EAAY,UAAA;AAAA"}