@shell-shock/core 0.5.0 → 0.6.0

package/dist/components/options-parser-logic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options-parser-logic.mjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","ReflectionKind","camelCase","constantCase","pascalCase","isSetString","computedOptions","getPositionalCommandOptionName","isPositionalCommandOption","PositionalOptionsParserLogic","props","path","envPrefix","_$createComponent","each","segments","children","segment","index","when","name","type","_$memo","positional","kind","number","variadic","initializer","default","_$createIntrinsic","condition","OptionsMember","option","doc","description","title","Boolean","string","optional","boolean","OptionsMemberParserLogic","isCaseSensitive","equalsRegex","length","toLowerCase","alias","map","a","join","includes","fallback","isNegativeOf","OptionsMemberParserCondition","OptionsInterfaceDeclaration","command","options","Object","values","value","hardline","OptionsParserLogic","entries","env","undefined","JSON","stringify","filter","i"],"sources":["../../src/components/options-parser-logic.tsx"],"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 { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { computedOptions } from \"../contexts/options\";\nimport {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  BooleanCommandOption,\n  CommandOption,\n  CommandTree,\n  CommandTreePath,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\n\nexport interface PositionalOptionsParserLogicProps {\n  /**\n   * The command path to generate the positional options parser logic for.\n   */\n  path: CommandTreePath;\n\n  /**\n   * The environment variable prefix to use for options that have an associated environment variable. This prefix will be used in the generated code to access the environment variables (e.g., `env.${envPrefix}_OPTION_NAME`).\n   */\n  envPrefix: string;\n}\n\nexport function PositionalOptionsParserLogic(\n  props: PositionalOptionsParserLogicProps\n) {\n  const { path, envPrefix } = props;\n\n  return (\n    <For each={path.segments ?? []}>\n      {(segment, index) => (\n        <Show when={isPositionalCommandOption(segment)}>\n          <VarDeclaration\n            let\n            name={camelCase(getPositionalCommandOptionName(segment))}\n            type={\n              path.positional[getPositionalCommandOptionName(segment)]?.kind ===\n              ReflectionKind.number\n                ? path.positional[getPositionalCommandOptionName(segment)]\n                    ?.variadic\n                  ? \"number[]\"\n                  : \"number | undefined\"\n                : path.positional[getPositionalCommandOptionName(segment)]\n                      ?.variadic\n                  ? \"string[]\"\n                  : \"string | undefined\"\n            }\n            initializer={\n              path.positional[getPositionalCommandOptionName(segment)]\n                ?.variadic ? (\n                code`[]`\n              ) : (\n                <>\n                  {code`env.${\n                    envPrefix\n                  }_${constantCase(path.positional[getPositionalCommandOptionName(segment)]?.name)}  ?? `}\n                  <Show\n                    when={isSetString(\n                      path.positional[getPositionalCommandOptionName(segment)]\n                        ?.default\n                    )}>\n                    {code`\"${\n                      path.positional[getPositionalCommandOptionName(segment)]\n                        ?.default\n                    }\"`}\n                  </Show>\n                  {code`undefined;`}\n                </>\n              )\n            }\n          />\n          <hbr />\n          <IfStatement\n            condition={code`args.length > ${2 + index} && args[${2 + index}]`}>\n            {code`${camelCase(getPositionalCommandOptionName(segment))} = args[${2 + index}];`}\n          </IfStatement>\n          <hbr />\n          <hbr />\n        </Show>\n      )}\n    </For>\n  );\n}\n\n/**\n * The command option interface property.\n */\nexport function OptionsMember({ option }: { option: CommandOption }) {\n  const doc = option.description || `The ${option.title} command option.`;\n\n  return (\n    <>\n      <Show when={Boolean(option.name)}>\n        <Show when={option.kind === ReflectionKind.string}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type={\n              (option as StringCommandOption).variadic ? \"string[]\" : \"string\"\n            }\n            optional={option.optional}\n          />\n        </Show>\n        <Show when={option.kind === ReflectionKind.number}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type={\n              (option as NumberCommandOption).variadic ? \"number[]\" : \"number\"\n            }\n            optional={option.optional}\n          />\n        </Show>\n        <Show when={option.kind === ReflectionKind.boolean}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type=\"boolean\"\n            optional={option.optional}\n          />\n        </Show>\n      </Show>\n    </>\n  );\n}\n\nexport interface OptionsMemberParserLogicProps {\n  /**\n   * The option name to generate the parser logic for.\n   */\n  name: string;\n\n  /**\n   * The command option to generate the parser logic for.\n   */\n  option: CommandOption;\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive: boolean;\n}\n\n/**\n * The command option property parser logic.\n */\nexport function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps) {\n  const { name, option, isCaseSensitive } = props;\n\n  const equalsRegex = `/^--?(${\n    isCaseSensitive && name.length > 1 ? name : name.toLowerCase()\n  }${option.alias && option.alias.length > 0 ? \"|\" : \"\"}${option.alias\n    ?.map(a =>\n      (isCaseSensitive && name.length > 1 ? a : a.toLowerCase()) === \"?\"\n        ? \"\\\\?\"\n        : isCaseSensitive && name.length > 1\n          ? a\n          : a.toLowerCase()\n    )\n    .join(\"|\")})=/`;\n\n  return (\n    <>\n      <Show\n        when={\n          option.kind === ReflectionKind.string ||\n          option.kind === ReflectionKind.number\n        }>\n        <Show\n          when={(option as StringCommandOption | NumberCommandOption).variadic}>\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name} ??= []; `}>\n            {code`options[\"${name}\"] ??= []; `}\n          </Show>\n          <hbr />\n          <IfStatement\n            condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n            <Show\n              when={name.includes(\"?\") || name.includes(\"-\")}\n              fallback={code`options.${name}.push(`}>\n              {code`options[\"${name}\"].push(`}\n            </Show>\n            <Show when={option.kind === ReflectionKind.string}>\n              {code`...arg.replace(${equalsRegex}, \"\").split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean) `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              {code`...arg.replace(${equalsRegex}, \"\").split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `}\n            </Show>\n            {code`); `}\n          </IfStatement>\n          <ElseIfClause condition={`args.length > i + 1`}>\n            <Show\n              when={name.includes(\"?\") || name.includes(\"-\")}\n              fallback={code`options.${name}.push(`}>\n              {code`options[\"${name}\"].push(`}\n            </Show>\n            <Show when={option.kind === ReflectionKind.string}>\n              {code`...args[++i].split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean) `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              {code`...args[++i].split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `}\n            </Show>\n            {code`); `}\n          </ElseIfClause>\n        </Show>\n        <Show\n          when={\n            !(option as StringCommandOption | NumberCommandOption).variadic\n          }>\n          <IfStatement\n            condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n            <Show when={option.kind === ReflectionKind.string}>\n              <Show\n                when={name.includes(\"?\") || name.includes(\"-\")}\n                fallback={code`options.${name}`}>\n                {code`options[\"${name}\"]`}\n              </Show>\n              {code` = arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\"); `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <VarDeclaration\n                const\n                name=\"value\"\n                initializer={code` Number(arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")); `}\n              />\n              <hbr />\n              <IfStatement condition={`!Number.isNaN(value)`}>\n                <Show\n                  when={name.includes(\"?\") || name.includes(\"-\")}\n                  fallback={code`options.${name}`}>\n                  {code`options[\"${name}\"]`}\n                </Show>\n                {code` = value; `}\n              </IfStatement>\n            </Show>\n          </IfStatement>\n          <ElseIfClause condition={`args.length > i + 1`}>\n            <Show when={option.kind === ReflectionKind.string}>\n              <Show\n                when={name.includes(\"?\") || name.includes(\"-\")}\n                fallback={code`options.${name}`}>\n                {code`options[\"${name}\"]`}\n              </Show>\n              {code` = args[++i].trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\"); `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <VarDeclaration\n                const\n                name=\"value\"\n                initializer={code` Number(args[++i].trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")); `}\n              />\n              <hbr />\n              <IfStatement condition={`!Number.isNaN(value)`}>\n                <Show\n                  when={name.includes(\"?\") || name.includes(\"-\")}\n                  fallback={code`options.${name}`}>\n                  {code`options[\"${name}\"]`}\n                </Show>\n                {code` = value; `}\n              </IfStatement>\n            </Show>\n          </ElseIfClause>\n          <hbr />\n        </Show>\n      </Show>\n      <Show when={option.kind === ReflectionKind.boolean}>\n        <IfStatement\n          condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n          <VarDeclaration\n            const\n            name=\"value\"\n            initializer={code` arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\").toLowerCase(); `}\n          />\n          <hbr />\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name}`}>\n            {code`options[\"${name}\"]`}\n          </Show>\n          {code` = value !== \"false\" && value !== \"f\" && value !== \"no\" && value !== \"n\" && value !== \"0\" && value !== \"off\" && value !== \"disable\" && value !== \"disabled\"; `}\n        </IfStatement>\n        <ElseClause>\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name} = true; `}>\n            {code`options[\"${name}\"] = true; `}\n          </Show>\n        </ElseClause>\n        <Show when={Boolean((option as BooleanCommandOption).isNegativeOf)}>\n          <hbr />\n          <Show\n            when={\n              (option as BooleanCommandOption).isNegativeOf!.includes(\"?\") ||\n              (option as BooleanCommandOption).isNegativeOf!.includes(\"-\")\n            }\n            fallback={code`options.${(option as BooleanCommandOption).isNegativeOf} = false; `}>\n            {code`options[\"${(option as BooleanCommandOption).isNegativeOf}\"] = false; `}\n          </Show>\n        </Show>\n      </Show>\n    </>\n  );\n}\n\nexport interface OptionsMemberParserConditionProps {\n  /**\n   * The option name to generate the parser logic for.\n   */\n  name: string;\n\n  /**\n   * Aliases for the option, which will also be parsed in the generated code. This will affect how the generated code compares command-line arguments to option names and aliases.\n   */\n  alias?: string[];\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive: boolean;\n}\n\nexport function OptionsMemberParserCondition(\n  props: OptionsMemberParserConditionProps\n) {\n  const { name, alias, isCaseSensitive } = props;\n\n  return (\n    <>\n      {code`arg${isCaseSensitive ? \"\" : \".toLowerCase()\"}.startsWith(\"--${\n        isCaseSensitive ? name : name.toLowerCase()\n      }=\") || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"} === \"--${\n        isCaseSensitive ? name : name.toLowerCase()\n      }\" || arg.startsWith(\"-${name}=\") || arg === \"-${name}\"`}\n      <Show when={alias && alias.length > 0}>\n        <For each={alias ?? []}>\n          {a =>\n            code` || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"}.startsWith(\"--${\n              isCaseSensitive ? a : a.toLowerCase()\n            }=\") || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"} === \"--${\n              isCaseSensitive ? a : a.toLowerCase()\n            }\" || arg.startsWith(\"-${a}=\") || arg === \"-${a}\"`\n          }\n        </For>\n      </Show>\n    </>\n  );\n}\n\nexport function OptionsInterfaceDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const options = computed(() => computedOptions(command));\n\n  return (\n    <InterfaceDeclaration export name={`${pascalCase(command.name)}Options`}>\n      <For each={Object.values(options.value)} hardline>\n        {option => <OptionsMember option={option} />}\n      </For>\n    </InterfaceDeclaration>\n  );\n}\n\nexport interface OptionsParserLogicProps {\n  /**\n   * The command to generate the options parser logic for.\n   */\n  command: CommandTree;\n\n  /**\n   * The environment variable prefix to use for options that have an associated environment variable. This prefix will be used in the generated code to access the environment variables (e.g., `env.${envPrefix}_OPTION_NAME`).\n   */\n  envPrefix: string;\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive?: boolean;\n}\n\n/**\n * The command options parser logic.\n */\nexport function OptionsParserLogic(props: OptionsParserLogicProps) {\n  const { command, envPrefix, isCaseSensitive = false } = props;\n\n  const options = computed(() => computedOptions(command));\n\n  return (\n    <>\n      <VarDeclaration\n        const\n        name=\"options\"\n        initializer={code` {\n          ${Object.entries(options.value)\n            .map(([name, option]) => {\n              if (option.kind === ReflectionKind.string) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env}` : \"\"\n                }${\n                  option.variadic\n                    ? option.default !== undefined\n                      ? `${\n                          option.env ? \" ?? \" : \"\"\n                        }${JSON.stringify(option.default)}`\n                      : option.env\n                        ? \" ?? []\"\n                        : \"\"\n                    : option.default !== undefined\n                      ? `${option.env ? \" ?? \" : \"\"}\"${option.default}\"`\n                      : \"\"\n                }, `;\n              } else if (option.kind === ReflectionKind.number) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env}` : \"\"\n                }${\n                  option.variadic\n                    ? option.default !== undefined\n                      ? `${\n                          option.env ? \" ?? \" : \"\"\n                        }${JSON.stringify(option.default)}`\n                      : option.env\n                        ? \" ?? []\"\n                        : \"\"\n                    : option.default !== undefined\n                      ? `${option.env ? \" ?? \" : \"\"}${option.default}`\n                      : \"\"\n                }, `;\n              } else if (option.kind === ReflectionKind.boolean) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env} ?? ` : \"\"\n                }${option.default ? \"true\" : \"false\"},`;\n              }\n\n              return \"\";\n            })\n            .join(\"\")}\n          } as ${pascalCase(command.name)}Options;`}\n      />\n      <hbr />\n      <hbr />\n      {code`for (let i = 0; i < args.slice(${\n        command.path.segments.filter(segment =>\n          isPositionalCommandOption(segment)\n        ).length\n      }).length; i++) { `}\n      <hbr />\n      <VarDeclaration\n        const\n        name=\"arg\"\n        type=\"string\"\n        initializer={code` args[i].length > 3 && args[i].startsWith(\"--\")\n          ? \\`--\\${args[i].slice(2).replaceAll(\"-\", \"\")${\n            isCaseSensitive ? \"\" : \".toLowerCase()\"\n          }}\\`\n          : args[i].length > 2 && args[i].startsWith(\"-\")\n            ? \\`-\\${args[i].slice(1).replaceAll(\"-\", \"\")}\\`\n          : args[i]; `}\n      />\n      <hbr />\n\n      <For each={Object.entries(options.value)} hardline>\n        {([name, option], i) => (\n          <Show\n            when={i === 0}\n            fallback={\n              <ElseIfClause\n                condition={\n                  <>\n                    <OptionsMemberParserCondition\n                      name={name}\n                      alias={option.alias}\n                      isCaseSensitive={isCaseSensitive}\n                    />\n                  </>\n                }>\n                <OptionsMemberParserLogic\n                  name={name}\n                  option={option}\n                  isCaseSensitive={isCaseSensitive}\n                />\n              </ElseIfClause>\n            }>\n            <IfStatement\n              condition={\n                <OptionsMemberParserCondition\n                  name={name}\n                  alias={option.alias}\n                  isCaseSensitive={isCaseSensitive}\n                />\n              }>\n              <OptionsMemberParserLogic\n                name={name}\n                option={option}\n                isCaseSensitive={isCaseSensitive}\n              />\n            </IfStatement>\n          </Show>\n        )}\n      </For>\n\n      <hbr />\n      {code` } `}\n      <hbr />\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"options-parser-logic.mjs","names":["code","computed","For","Show","ElseClause","ElseIfClause","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","ReflectionKind","camelCase","pascalCase","isSetString","computedOptions","getDynamicPathSegmentName","isDynamicPathSegment","DynamicPathSegmentsParserLogic","props","path","_$createComponent","each","segments","children","segment","index","when","name","type","dynamics","variadic","optional","initializer","_$memo","default","_$createIntrinsic","condition","OptionsMember","option","doc","description","title","Boolean","kind","string","number","boolean","OptionsMemberParserLogic","isCaseSensitive","equalsRegex","length","toLowerCase","alias","map","a","join","includes","fallback","isNegativeOf","OptionsMemberParserCondition","OptionsInterfaceDeclaration","command","options","Object","values","value","hardline","OptionsParserLogic","envPrefix","entries","env","undefined","JSON","stringify","filter","i"],"sources":["../../src/components/options-parser-logic.tsx"],"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 { code, computed, For, Show } from \"@alloy-js/core\";\nimport {\n  ElseClause,\n  ElseIfClause,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { pascalCase } from \"@stryke/string-format/pascal-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { computedOptions } from \"../contexts/options\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  BooleanCommandOption,\n  CommandOption,\n  CommandTree,\n  CommandTreePath,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\n\nexport interface DynamicPathSegmentsParserLogicProps {\n  /**\n   * The command path to generate the dynamic path segments parser logic for.\n   */\n  path: CommandTreePath;\n}\n\nexport function DynamicPathSegmentsParserLogic(\n  props: DynamicPathSegmentsParserLogicProps\n) {\n  const { path } = props;\n\n  return (\n    <For each={path.segments ?? []}>\n      {(segment, index) => (\n        <Show when={isDynamicPathSegment(segment)}>\n          <VarDeclaration\n            let\n            name={camelCase(getDynamicPathSegmentName(segment))}\n            type={`${\n              path.dynamics[getDynamicPathSegmentName(segment)]?.variadic\n                ? \"string[]\"\n                : \"string\"\n            }${\n              path.dynamics[getDynamicPathSegmentName(segment)]?.optional\n                ? \" | undefined\"\n                : \"\"\n            }`}\n            initializer={\n              path.dynamics[getDynamicPathSegmentName(segment)]?.variadic ? (\n                code`[]`\n              ) : (\n                <>\n                  <Show\n                    when={isSetString(\n                      path.dynamics[getDynamicPathSegmentName(segment)]?.default\n                    )}>\n                    {code`\"${\n                      path.dynamics[getDynamicPathSegmentName(segment)]?.default\n                    }\"`}\n                  </Show>\n                  {code`undefined;`}\n                </>\n              )\n            }\n          />\n          <hbr />\n          <IfStatement\n            condition={code`args.length > ${2 + index} && args[${2 + index}]`}>\n            {code`${camelCase(getDynamicPathSegmentName(segment))} = args[${2 + index}];`}\n          </IfStatement>\n          <hbr />\n          <hbr />\n        </Show>\n      )}\n    </For>\n  );\n}\n\n/**\n * The command option interface property.\n */\nexport function OptionsMember({ option }: { option: CommandOption }) {\n  const doc = option.description || `The ${option.title} command option.`;\n\n  return (\n    <>\n      <Show when={Boolean(option.name)}>\n        <Show when={option.kind === ReflectionKind.string}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type={\n              (option as StringCommandOption).variadic ? \"string[]\" : \"string\"\n            }\n            optional={option.optional}\n          />\n        </Show>\n        <Show when={option.kind === ReflectionKind.number}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type={\n              (option as NumberCommandOption).variadic ? \"number[]\" : \"number\"\n            }\n            optional={option.optional}\n          />\n        </Show>\n        <Show when={option.kind === ReflectionKind.boolean}>\n          <InterfaceMember\n            name={option.name}\n            doc={doc}\n            type=\"boolean\"\n            optional={option.optional}\n          />\n        </Show>\n      </Show>\n    </>\n  );\n}\n\nexport interface OptionsMemberParserLogicProps {\n  /**\n   * The option name to generate the parser logic for.\n   */\n  name: string;\n\n  /**\n   * The command option to generate the parser logic for.\n   */\n  option: CommandOption;\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive: boolean;\n}\n\n/**\n * The command option property parser logic.\n */\nexport function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps) {\n  const { name, option, isCaseSensitive } = props;\n\n  const equalsRegex = `/^--?(${\n    isCaseSensitive && name.length > 1 ? name : name.toLowerCase()\n  }${option.alias && option.alias.length > 0 ? \"|\" : \"\"}${option.alias\n    ?.map(a =>\n      (isCaseSensitive && name.length > 1 ? a : a.toLowerCase()) === \"?\"\n        ? \"\\\\?\"\n        : isCaseSensitive && name.length > 1\n          ? a\n          : a.toLowerCase()\n    )\n    .join(\"|\")})=/`;\n\n  return (\n    <>\n      <Show\n        when={\n          option.kind === ReflectionKind.string ||\n          option.kind === ReflectionKind.number\n        }>\n        <Show\n          when={(option as StringCommandOption | NumberCommandOption).variadic}>\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name} ??= []; `}>\n            {code`options[\"${name}\"] ??= []; `}\n          </Show>\n          <hbr />\n          <IfStatement\n            condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n            <Show\n              when={name.includes(\"?\") || name.includes(\"-\")}\n              fallback={code`options.${name}.push(`}>\n              {code`options[\"${name}\"].push(`}\n            </Show>\n            <Show when={option.kind === ReflectionKind.string}>\n              {code`...arg.replace(${equalsRegex}, \"\").split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean) `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              {code`...arg.replace(${equalsRegex}, \"\").split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `}\n            </Show>\n            {code`); `}\n          </IfStatement>\n          <ElseIfClause condition={`args.length > i + 1`}>\n            <Show\n              when={name.includes(\"?\") || name.includes(\"-\")}\n              fallback={code`options.${name}.push(`}>\n              {code`options[\"${name}\"].push(`}\n            </Show>\n            <Show when={option.kind === ReflectionKind.string}>\n              {code`...args[++i].split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean) `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              {code`...args[++i].split(\",\").map(item => item.trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")).filter(Boolean).map(Number).filter(value => !Number.isNaN(value)) `}\n            </Show>\n            {code`); `}\n          </ElseIfClause>\n        </Show>\n        <Show\n          when={\n            !(option as StringCommandOption | NumberCommandOption).variadic\n          }>\n          <IfStatement\n            condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n            <Show when={option.kind === ReflectionKind.string}>\n              <Show\n                when={name.includes(\"?\") || name.includes(\"-\")}\n                fallback={code`options.${name}`}>\n                {code`options[\"${name}\"]`}\n              </Show>\n              {code` = arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\"); `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <VarDeclaration\n                const\n                name=\"value\"\n                initializer={code` Number(arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")); `}\n              />\n              <hbr />\n              <IfStatement condition={`!Number.isNaN(value)`}>\n                <Show\n                  when={name.includes(\"?\") || name.includes(\"-\")}\n                  fallback={code`options.${name}`}>\n                  {code`options[\"${name}\"]`}\n                </Show>\n                {code` = value; `}\n              </IfStatement>\n            </Show>\n          </IfStatement>\n          <ElseIfClause condition={`args.length > i + 1`}>\n            <Show when={option.kind === ReflectionKind.string}>\n              <Show\n                when={name.includes(\"?\") || name.includes(\"-\")}\n                fallback={code`options.${name}`}>\n                {code`options[\"${name}\"]`}\n              </Show>\n              {code` = args[++i].trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\"); `}\n            </Show>\n            <Show when={option.kind === ReflectionKind.number}>\n              <VarDeclaration\n                const\n                name=\"value\"\n                initializer={code` Number(args[++i].trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\")); `}\n              />\n              <hbr />\n              <IfStatement condition={`!Number.isNaN(value)`}>\n                <Show\n                  when={name.includes(\"?\") || name.includes(\"-\")}\n                  fallback={code`options.${name}`}>\n                  {code`options[\"${name}\"]`}\n                </Show>\n                {code` = value; `}\n              </IfStatement>\n            </Show>\n          </ElseIfClause>\n          <hbr />\n        </Show>\n      </Show>\n      <Show when={option.kind === ReflectionKind.boolean}>\n        <IfStatement\n          condition={`${equalsRegex}.test(arg${isCaseSensitive ? \"\" : \".toLowerCase()\"})`}>\n          <VarDeclaration\n            const\n            name=\"value\"\n            initializer={code` arg.replace(${equalsRegex}, \"\").trim().replace(/^(\"|')/, \"\").replace(/(\"|')$/, \"\").toLowerCase(); `}\n          />\n          <hbr />\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name}`}>\n            {code`options[\"${name}\"]`}\n          </Show>\n          {code` = value !== \"false\" && value !== \"f\" && value !== \"no\" && value !== \"n\" && value !== \"0\" && value !== \"off\" && value !== \"disable\" && value !== \"disabled\"; `}\n        </IfStatement>\n        <ElseClause>\n          <Show\n            when={name.includes(\"?\") || name.includes(\"-\")}\n            fallback={code`options.${name} = true; `}>\n            {code`options[\"${name}\"] = true; `}\n          </Show>\n        </ElseClause>\n        <Show when={Boolean((option as BooleanCommandOption).isNegativeOf)}>\n          <hbr />\n          <Show\n            when={\n              (option as BooleanCommandOption).isNegativeOf!.includes(\"?\") ||\n              (option as BooleanCommandOption).isNegativeOf!.includes(\"-\")\n            }\n            fallback={code`options.${(option as BooleanCommandOption).isNegativeOf} = false; `}>\n            {code`options[\"${(option as BooleanCommandOption).isNegativeOf}\"] = false; `}\n          </Show>\n        </Show>\n      </Show>\n    </>\n  );\n}\n\nexport interface OptionsMemberParserConditionProps {\n  /**\n   * The option name to generate the parser logic for.\n   */\n  name: string;\n\n  /**\n   * Aliases for the option, which will also be parsed in the generated code. This will affect how the generated code compares command-line arguments to option names and aliases.\n   */\n  alias?: string[];\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive: boolean;\n}\n\nexport function OptionsMemberParserCondition(\n  props: OptionsMemberParserConditionProps\n) {\n  const { name, alias, isCaseSensitive } = props;\n\n  return (\n    <>\n      {code`arg${isCaseSensitive ? \"\" : \".toLowerCase()\"}.startsWith(\"--${\n        isCaseSensitive ? name : name.toLowerCase()\n      }=\") || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"} === \"--${\n        isCaseSensitive ? name : name.toLowerCase()\n      }\" || arg.startsWith(\"-${name}=\") || arg === \"-${name}\"`}\n      <Show when={alias && alias.length > 0}>\n        <For each={alias ?? []}>\n          {a =>\n            code` || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"}.startsWith(\"--${\n              isCaseSensitive || a.length === 1 ? a : a.toLowerCase()\n            }=\") || arg${isCaseSensitive ? \"\" : \".toLowerCase()\"} === \"--${\n              isCaseSensitive || a.length === 1 ? a : a.toLowerCase()\n            }\" || arg.startsWith(\"-${a}=\") || arg === \"-${a}\"`\n          }\n        </For>\n      </Show>\n    </>\n  );\n}\n\nexport function OptionsInterfaceDeclaration(props: { command: CommandTree }) {\n  const { command } = props;\n\n  const options = computed(() => computedOptions(command));\n\n  return (\n    <InterfaceDeclaration export name={`${pascalCase(command.name)}Options`}>\n      <For each={Object.values(options.value)} hardline>\n        {option => <OptionsMember option={option} />}\n      </For>\n    </InterfaceDeclaration>\n  );\n}\n\nexport interface OptionsParserLogicProps {\n  /**\n   * The command to generate the options parser logic for.\n   */\n  command: CommandTree;\n\n  /**\n   * The environment variable prefix to use for options that have an associated environment variable. This prefix will be used in the generated code to access the environment variables (e.g., `env.${envPrefix}_OPTION_NAME`).\n   */\n  envPrefix: string;\n\n  /**\n   * Whether the command options should be parsed in a case-sensitive manner. This will affect how the generated code compares command-line arguments to option names and aliases.\n   *\n   * @defaultValue false\n   */\n  isCaseSensitive?: boolean;\n}\n\n/**\n * The command options parser logic.\n */\nexport function OptionsParserLogic(props: OptionsParserLogicProps) {\n  const { command, envPrefix, isCaseSensitive = false } = props;\n\n  const options = computed(() => computedOptions(command));\n\n  return (\n    <>\n      <VarDeclaration\n        const\n        name=\"options\"\n        initializer={code` {\n          ${Object.entries(options.value)\n            .map(([name, option]) => {\n              if (option.kind === ReflectionKind.string) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env}` : \"\"\n                }${\n                  option.variadic\n                    ? option.default !== undefined\n                      ? `${\n                          option.env ? \" ?? \" : \"\"\n                        }${JSON.stringify(option.default)}`\n                      : option.env\n                        ? \" ?? []\"\n                        : \"\"\n                    : option.default !== undefined\n                      ? `${option.env ? \" ?? \" : \"\"}\"${option.default}\"`\n                      : \"\"\n                }, `;\n              } else if (option.kind === ReflectionKind.number) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env}` : \"\"\n                }${\n                  option.variadic\n                    ? option.default !== undefined\n                      ? `${\n                          option.env ? \" ?? \" : \"\"\n                        }${JSON.stringify(option.default)}`\n                      : option.env\n                        ? \" ?? []\"\n                        : \"\"\n                    : option.default !== undefined\n                      ? `${option.env ? \" ?? \" : \"\"}${option.default}`\n                      : \"\"\n                }, `;\n              } else if (option.kind === ReflectionKind.boolean) {\n                return ` ${name.includes(\"?\") || name.includes(\"-\") ? `\"${name}\"` : `${name}`}: ${\n                  option.env ? `env.${envPrefix}_${option.env} ?? ` : \"\"\n                }${option.default ? \"true\" : \"false\"},`;\n              }\n\n              return \"\";\n            })\n            .join(\"\")}\n          } as ${pascalCase(command.name)}Options;`}\n      />\n      <hbr />\n      <hbr />\n      {code`for (let i = 0; i < args.slice(${\n        command.path.segments.filter(segment => isDynamicPathSegment(segment))\n          .length\n      }).length; i++) { `}\n      <hbr />\n      <VarDeclaration\n        const\n        name=\"arg\"\n        type=\"string\"\n        initializer={code` args[i].length > 3 && args[i].startsWith(\"--\")\n          ? \\`--\\${args[i].slice(2).replaceAll(\"-\", \"\")${\n            isCaseSensitive ? \"\" : \".toLowerCase()\"\n          }}\\`\n          : args[i].length > 2 && args[i].startsWith(\"-\")\n            ? \\`-\\${args[i].slice(1).replaceAll(\"-\", \"\")}\\`\n          : args[i]; `}\n      />\n      <hbr />\n\n      <For each={Object.entries(options.value)} hardline>\n        {([name, option], i) => (\n          <Show\n            when={i === 0}\n            fallback={\n              <ElseIfClause\n                condition={\n                  <>\n                    <OptionsMemberParserCondition\n                      name={name}\n                      alias={option.alias}\n                      isCaseSensitive={isCaseSensitive}\n                    />\n                  </>\n                }>\n                <OptionsMemberParserLogic\n                  name={name}\n                  option={option}\n                  isCaseSensitive={isCaseSensitive}\n                />\n              </ElseIfClause>\n            }>\n            <IfStatement\n              condition={\n                <OptionsMemberParserCondition\n                  name={name}\n                  alias={option.alias}\n                  isCaseSensitive={isCaseSensitive}\n                />\n              }>\n              <OptionsMemberParserLogic\n                name={name}\n                option={option}\n                isCaseSensitive={isCaseSensitive}\n              />\n            </IfStatement>\n          </Show>\n        )}\n      </For>\n\n      <hbr />\n      {code` } `}\n      <hbr />\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/components/usage.cjs

@@ -32,7 +32,7 @@ function Usage(props) {
 				})
 			];
 		} }),
-		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`${bin} ${command.path.segments.map((segment) => require_plugin_utils_context_helpers.isPositionalCommandOption(segment) ? `<${(0, __stryke_string_format_snake_case.snakeCase)(command.path.positional[segment]?.name || require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment))}${command.path.positional[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
+		(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`${bin} ${command.path.segments.map((segment) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment) ? `<${(0, __stryke_string_format_snake_case.snakeCase)(command.path.dynamics[segment]?.name || require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment))}${command.path.dynamics[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
 	];
 }
 

package/dist/components/usage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"usage.cjs","names":["code","Match","Switch","snakeCase","getPositionalCommandOptionName","isPositionalCommandOption","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","positional","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"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 { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isPositionalCommandOption(segment)\n            ? `<${snakeCase(\n                command.path.positional[segment]?.name ||\n                  getPositionalCommandOptionName(segment)\n              )}${command.path.positional[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,oBAAI;mDACJE,wBAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;qDACJX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;qDAC/CX,uBAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;8CAEpBZ,oBAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,+DAA0Ba,QAAQ,GAC9B,qDACEV,QAAQO,KAAKI,WAAWD,UAAUE,QAChChB,oEAA+Bc,QACnC,CAAC,GAAGV,QAAQO,KAAKI,WAAWD,UAAUG,WAAW,QAAQ,GAAE,KAC3DH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}
+{"version":3,"file":"usage.cjs","names":["code","Match","Switch","snakeCase","getDynamicPathSegmentName","isDynamicPathSegment","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","dynamics","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"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 { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? `<${snakeCase(\n                command.path.dynamics[segment]?.name ||\n                  getDynamicPathSegmentName(segment)\n              )}${command.path.dynamics[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,oBAAI;mDACJE,wBAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;qDACJX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;qDACpDX,uBAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;qDAC/CX,uBAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;8CAEpBZ,oBAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,0DAAqBa,QAAQ,GACzB,qDACEV,QAAQO,KAAKI,SAASD,UAAUE,QAC9BhB,+DAA0Bc,QAC9B,CAAC,GAAGV,QAAQO,KAAKI,SAASD,UAAUG,WAAW,QAAQ,GAAE,KACzDH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}

package/dist/components/usage.d.cts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core5 from "@alloy-js/core";
+import * as _alloy_js_core9 from "@alloy-js/core";
 
 //#region src/components/usage.d.ts
 interface UsageProps {
@@ -24,7 +24,7 @@ interface UsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function Usage(props: UsageProps): _alloy_js_core5.Children;
+declare function Usage(props: UsageProps): _alloy_js_core9.Children;
 //#endregion
 export { Usage, UsageProps };
 //# sourceMappingURL=usage.d.cts.map

package/dist/components/usage.d.mts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core5 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/components/usage.d.ts
 interface UsageProps {
@@ -24,7 +24,7 @@ interface UsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function Usage(props: UsageProps): _alloy_js_core5.Children;
+declare function Usage(props: UsageProps): _alloy_js_core0.Children;
 //#endregion
 export { Usage, UsageProps };
 //# sourceMappingURL=usage.d.mts.map

package/dist/components/usage.mjs

@@ -1,4 +1,4 @@
-import { getPositionalCommandOptionName, isPositionalCommandOption } from "../plugin-utils/context-helpers.mjs";
+import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
 import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
 import { Match, Switch, code } from "@alloy-js/core";
 import { snakeCase } from "@stryke/string-format/snake-case";
@@ -31,7 +31,7 @@ function Usage(props) {
 				})
 			];
 		} }),
-		memo(() => code`${bin} ${command.path.segments.map((segment) => isPositionalCommandOption(segment) ? `<${snakeCase(command.path.positional[segment]?.name || getPositionalCommandOptionName(segment))}${command.path.positional[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
+		memo(() => code`${bin} ${command.path.segments.map((segment) => isDynamicPathSegment(segment) ? `<${snakeCase(command.path.dynamics[segment]?.name || getDynamicPathSegmentName(segment))}${command.path.dynamics[segment]?.variadic ? "..." : ""}>` : segment).join(" ")}${Object.values(command.children).length > 0 ? " [commands]" : ""} [options]`)
 	];
 }
 

package/dist/components/usage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"usage.mjs","names":["code","Match","Switch","snakeCase","getPositionalCommandOptionName","isPositionalCommandOption","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","positional","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"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 { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isPositionalCommandOption(segment)\n            ? `<${snakeCase(\n                command.path.positional[segment]?.name ||\n                  getPositionalCommandOptionName(segment)\n              )}${command.path.positional[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,IAAI;EAAIW,gBACRT,QAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;IAAAD,gBACJV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;IAAAD,gBAC/CV,OAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;EAAAE,WAEpBd,IAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,0BAA0Ba,QAAQ,GAC9B,IAAIf,UACFK,QAAQO,KAAKI,WAAWD,UAAUE,QAChChB,+BAA+Bc,QACnC,CAAC,GAAGV,QAAQO,KAAKI,WAAWD,UAAUG,WAAW,QAAQ,GAAE,KAC3DH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}
+{"version":3,"file":"usage.mjs","names":["code","Match","Switch","snakeCase","getDynamicPathSegmentName","isDynamicPathSegment","Usage","props","command","bin","packageManager","_$createComponent","children","when","_$memo","path","segments","map","segment","dynamics","name","variadic","join","Object","values","length"],"sources":["../../src/components/usage.tsx"],"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 { code, Match, Switch } from \"@alloy-js/core\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandTree } from \"../types/command\";\n\nexport interface UsageProps {\n  /**\n   * The command to generate help for.\n   */\n  command: CommandTree;\n\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The bin name to use in the usage display.\n   */\n  bin: string;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function Usage(props: UsageProps) {\n  const { command, bin, packageManager } = props;\n\n  return (\n    <>\n      {code`$ `}\n      <Switch>\n        <Match when={packageManager === \"yarn\"}>{`yarn exec `}</Match>\n        <Match when={packageManager === \"pnpm\"}>{`pnpm exec `}</Match>\n        <Match when={packageManager === \"bun\"}>{`bun x `}</Match>\n        <Match else>{`npx `}</Match>\n      </Switch>\n      {code`${bin} ${command.path.segments\n        .map(segment =>\n          isDynamicPathSegment(segment)\n            ? `<${snakeCase(\n                command.path.dynamics[segment]?.name ||\n                  getDynamicPathSegmentName(segment)\n              )}${command.path.dynamics[segment]?.variadic ? \"...\" : \"\"}>`\n            : segment\n        )\n        .join(\" \")}${\n        Object.values(command.children).length > 0 ? \" [commands]\" : \"\"\n      } [options]`}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;AAmDA,SAAgBM,MAAMC,OAAmB;CACvC,MAAM,EAAEC,SAASC,KAAKC,mBAAmBH;AAEzC,QAAA;EAEKP,IAAI;EAAIW,gBACRT,QAAM,EAAA,IAAAU,WAAA;AAAA,UAAA;IAAAD,gBACJV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAME,UAAG;KAAY,CAAA;IAAAD,gBACpDV,OAAK;KAACY,MAAMH,mBAAmB;KAAKE,UAAG;KAAQ,CAAA;IAAAD,gBAC/CV,OAAK;KAAA,QAAA;KAAAW,UAAO;KAAM,CAAA;IAAA;KAAA,CAAA;EAAAE,WAEpBd,IAAI,GAAGS,IAAG,GAAID,QAAQO,KAAKC,SACzBC,KAAIC,YACHb,qBAAqBa,QAAQ,GACzB,IAAIf,UACFK,QAAQO,KAAKI,SAASD,UAAUE,QAC9BhB,0BAA0Bc,QAC9B,CAAC,GAAGV,QAAQO,KAAKI,SAASD,UAAUG,WAAW,QAAQ,GAAE,KACzDH,QACL,CACAI,KAAK,IAAI,GACVC,OAAOC,OAAOhB,QAAQI,SAAS,CAACa,SAAS,IAAI,gBAAgB,GAAE,YACrD;EAAA"}

package/dist/helpers/resolve-command.cjs

@@ -31,7 +31,7 @@ function resolveCommandOptionDescription(kind, optional, name, title, defaultVal
 	return `A${optional && !defaultValue ? "n optional" : ""} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "flag provided via the command-line" : "command-line option"} that allows the user to ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "set the" : kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "specify custom" : "specify a custom"} ${title?.trim() || (0, __stryke_string_format_title_case.titleCase)(name)} ${kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean ? "indicator" : `${kind === __powerlines_deepkit_vendor_type.ReflectionKind.number ? "numeric" : "string"} value${kind === __powerlines_deepkit_vendor_type.ReflectionKind.array ? "s" : ""}`} that will be used in the application.`;
 }
 function resolveCommandId(context, file) {
-	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !require_plugin_utils_context_helpers.isPositionalCommandOption(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
+	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).split("/").filter((p) => Boolean(p) && !require_plugin_utils_context_helpers.isDynamicPathSegment(p)).join("/").replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").replaceAll("/", "-");
 }
 /**
 * Finds the command name from the given file path.
@@ -42,14 +42,14 @@ function resolveCommandId(context, file) {
 function resolveCommandName(file) {
 	let path = (0, __stryke_path_file_path_fns.findFilePath)(file);
 	let name = (0, __stryke_path_file_path_fns.findFolderName)(file, { requireExtension: true });
-	while (require_plugin_utils_context_helpers.isPositionalCommandOption(name)) {
+	while (require_plugin_utils_context_helpers.isDynamicPathSegment(name)) {
 		path = (0, __stryke_path_resolve_parent_path.resolveParentPath)(path);
 		name = (0, __stryke_path_file_path_fns.findFolderName)(path, { requireExtension: true });
 	}
 	return name;
 }
 function resolveCommandPath(context, file) {
-	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "");
+	return (0, __stryke_path_replace.replacePath)((0, __stryke_path_file_path_fns.findFilePath)(file), context.commandsPath).replaceAll(/^\/+/g, "").replaceAll(/\/+$/g, "").split("/").filter((path) => path && !require_plugin_utils_context_helpers.isPathSegmentGroup(path)).join("/");
 }
 function findCommandsRoot(context) {
 	if ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.entry)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
@@ -92,23 +92,24 @@ function extractCommandOption(command, reflection) {
 * @param reflection - The type parameter reflection to extract information from.
 * @returns The extracted command option information.
 */
-function extractCommandPositionalOption(command, segment, reflection) {
-	if (reflection.type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && reflection.type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.number && !(reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && (reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number))) throw new Error(`Unsupported type for positional option "${segment}" in command "${command.name}". Only string and number types (or string[] and number[]) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(reflection.type).trim().replaceAll(" | ", ", or ")}.`);
+function extractCommandDynamicSegment(command, segment, reflection) {
+	if (reflection.type.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.string && !(reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array && reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string)) throw new Error(`Unsupported type for dynamic path segment "${segment}" in command "${command.name}". Only string types (or an array of strings) are supported, received ${(0, __powerlines_deepkit_vendor_type.stringifyType)(reflection.type).trim().replaceAll(" | ", ", or ")}.`);
 	const option = {
 		name: segment,
-		alias: [],
 		title: (0, __stryke_string_format_title_case.titleCase)(segment),
-		description: reflection.description || resolveCommandOptionDescription(reflection.type.kind, !!reflection.optional, segment, (0, __stryke_string_format_title_case.titleCase)(segment), reflection.default),
-		env: (0, __stryke_string_format_constant_case.constantCase)(segment),
-		kind: reflection.type.kind,
+		description: reflection.description || resolveCommandOptionDescription(__powerlines_deepkit_vendor_type.ReflectionKind.string, !!reflection.optional, segment, (0, __stryke_string_format_title_case.titleCase)(segment), reflection.default),
 		optional: reflection.optional,
 		default: reflection.default,
-		variadic: false
+		catchAll: command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isCatchAllPathSegment(seg))
 	};
-	if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) if (reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.string || reflection.type.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.number) {
+	if (reflection.type.kind === __powerlines_deepkit_vendor_type.ReflectionKind.array) {
+		if (!option.catchAll) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is an array type but is not defined as a catch-all segment. To use an array type for a dynamic path segment, it must be defined as a catch-all segment using the "[...segment]" syntax.`);
 		option.variadic = true;
-		option.kind = reflection.type.type.kind;
-	} else throw new Error(`Unsupported array type for option "${segment}" in command "${command.name}". Only string[] and number[] are supported.`);
+	}
+	if (option.catchAll) {
+		if (!option.optional && command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as a catch-all segment but is not optional. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
+		else if (option.optional && !command.path.segments.some((seg) => require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment) === seg && require_plugin_utils_context_helpers.isOptionalCatchAllPathSegment(seg))) throw new Error(`Dynamic path segment "${segment}" in command "${command.name}" is defined as an optional segment but is not defined as an optional catch-all segment. To define an optional catch-all segment, use the "[[...segment]]" syntax.`);
+	}
 	return option;
 }
 /**
@@ -127,7 +128,7 @@ async function reflectCommandTree(context, command, parent) {
 		title,
 		path: {
 			...command.path,
-			positional: {}
+			dynamics: {}
 		},
 		options: require_utilities.getDefaultOptions(context, command),
 		parent: parent ?? null,
@@ -153,11 +154,11 @@ async function reflectCommandTree(context, command, parent) {
 				const optionsReflection = __powerlines_deepkit_vendor_type.ReflectionClass.from(firstParam.type);
 				for (const propertyReflection of optionsReflection.getProperties()) tree.options[propertyReflection.getNameAsString()] = extractCommandOption(command, propertyReflection);
 			}
-			tree.path.positional = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).reduce((obj, segment, index) => {
+			tree.path.dynamics = tree.path.segments.filter((segment) => require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).reduce((obj, segment, index) => {
 				if (type.parameters.length < index + 2 || !type.parameters[index + 1]) return obj;
-				const paramName = require_plugin_utils_context_helpers.getPositionalCommandOptionName(segment);
-				obj[paramName] = extractCommandPositionalOption(command, paramName, type.parameters[index + 1]);
-				obj[paramName].description = obj[paramName].description || `The ${paramName} positional option for the ${command.name} command.`;
+				const paramName = require_plugin_utils_context_helpers.getDynamicPathSegmentName(segment);
+				obj[paramName] = extractCommandDynamicSegment(command, paramName, type.parameters[index + 1]);
+				obj[paramName].description = obj[paramName].description || `The ${paramName} ${obj[paramName].catchAll ? `${obj[paramName].optional ? "optional " : ""}catch-all` : "dynamic "} segment for the ${command.name} command.`;
 				return obj;
 			}, {});
 		}
@@ -181,20 +182,8 @@ async function reflectCommandTree(context, command, parent) {
 				}
 			});
 		});
-		if (Object.values(tree.path.positional).filter((option) => option.env !== false).length > 0) Object.values(tree.path.positional).filter((option) => option.env !== false).forEach((option) => context.env.types.env.addProperty({
-			name: (0, __stryke_string_format_constant_case.constantCase)(option.name),
-			optional: option.optional ? true : void 0,
-			description: option.description,
-			visibility: __powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-			type: option.variadic ? {
-				kind: __powerlines_deepkit_vendor_type.ReflectionKind.array,
-				type: { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string }
-			} : { kind: __powerlines_deepkit_vendor_type.ReflectionKind.string },
-			default: option.default,
-			tags: { domain: "cli" }
-		}));
 	}
-	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isPositionalCommandOption(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
+	for (const input of context.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length === command.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment)).length + 1 && input$1.path.segments.slice(0, command.path.segments.length).every((value, index) => value === command.path.segments[index]))) tree.children[input.name] = await reflectCommandTree(context, input, tree);
 	return tree;
 }
 

package/dist/helpers/resolve-command.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-command.cjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getPositionalCommandOptionName","isPositionalCommandOption","getDefaultOptions","resolveCommandOptionDescription","kind","optional","name","title","defaultValue","boolean","array","trim","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandParams","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","propertyType","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","variadic","type","string","Error","extractCommandPositionalOption","segment","reflectCommandTree","parent","isVirtual","replace","tree","positional","options","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","segments","reduce","obj","index","paramName","Object","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","slice","every","value"],"sources":["../../src/helpers/resolve-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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { resolveModule } from \"powerlines/lib/utilities/resolve\";\nimport {\n  getAppTitle,\n  getPositionalCommandOptionName,\n  isPositionalCommandOption\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandPositionalOption,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param name - The name of the command option.\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  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} ${\n    kind === ReflectionKind.boolean\n      ? \"flag provided via the command-line\"\n      : \"command-line option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isPositionalCommandOption(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isPositionalCommandOption(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\");\n}\n\nexport function resolveCommandParams(context: Context, file: string): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && isPositionalCommandOption(p))\n    .map(p => p.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\"));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandOption(\n  command: CommandInput,\n  reflection: ReflectionProperty\n): CommandOption {\n  const propertyType = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.getNameAsString(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: propertyType.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: false\n  } as CommandOption;\n  if (propertyType.kind === ReflectionKind.array) {\n    if (\n      propertyType.type.kind === ReflectionKind.string ||\n      propertyType.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        propertyType.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported.`\n      );\n    }\n  } else if (\n    propertyType.kind !== ReflectionKind.boolean &&\n    propertyType.kind !== ReflectionKind.string &&\n    propertyType.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        propertyType\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param segment - The command path segment corresponding to the parameter.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandPositionalOption(\n  command: CommandInput,\n  segment: string,\n  reflection: TypeParameter\n): CommandPositionalOption {\n  if (\n    reflection.type.kind !== ReflectionKind.string &&\n    reflection.type.kind !== ReflectionKind.number &&\n    !(\n      reflection.type.kind === ReflectionKind.array &&\n      (reflection.type.type.kind === ReflectionKind.string ||\n        reflection.type.type.kind === ReflectionKind.number)\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for positional option \"${segment}\" in command \"${\n        command.name\n      }\". Only string and number types (or string[] and number[]) are supported, received ${stringifyType(\n        reflection.type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: segment,\n    alias: [],\n    title: titleCase(segment),\n    description:\n      reflection.description ||\n      resolveCommandOptionDescription(\n        reflection.type.kind,\n        !!reflection.optional,\n        segment,\n        titleCase(segment),\n        reflection.default\n      ),\n    env: constantCase(segment),\n    kind: reflection.type.kind,\n    optional: reflection.optional,\n    default: reflection.default,\n    variadic: false\n  } as CommandPositionalOption;\n\n  if (reflection.type.kind === ReflectionKind.array) {\n    if (\n      reflection.type.type.kind === ReflectionKind.string ||\n      reflection.type.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        reflection.type.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${segment}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported.`\n      );\n    }\n  }\n\n  return option;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    alias: [],\n    ...command,\n    title,\n    path: {\n      ...command.path,\n      positional: {}\n    },\n    options: getDefaultOptions(context, command),\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\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 user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const resolved = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n\n    const metadata = resolved.metadata ?? {};\n    if (isSetString(metadata.title)) {\n      tree.title = metadata.title;\n    }\n    if (isSetString(metadata.description)) {\n      tree.description = metadata.description;\n    }\n    if (\n      isSetString(metadata.alias) ||\n      (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n    ) {\n      tree.alias = toArray(metadata.alias);\n    }\n\n    const type = reflect(resolved);\n\n    // const type = await reflectType<TContext>(context, command.entry.input);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    tree.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title} executable command-line interface.`;\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      }\n\n      tree.path.positional = tree.path.segments\n        .filter(segment => isPositionalCommandOption(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getPositionalCommandOptionName(segment);\n            obj[paramName] = extractCommandPositionalOption(\n              command,\n              paramName,\n              type.parameters[index + 1]!\n            );\n\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} positional option for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandPositionalOption>\n        );\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command-line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          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:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    if (\n      Object.values(tree.path.positional).filter(option => option.env !== false)\n        .length > 0\n    ) {\n      Object.values(tree.path.positional)\n        .filter(option => option.env !== false)\n        .forEach(option =>\n          context.env.types.env.addProperty({\n            name: constantCase(option.name),\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: option.variadic\n              ? {\n                  kind: ReflectionKind.array,\n                  type: { kind: ReflectionKind.string }\n                }\n              : { kind: ReflectionKind.string },\n            default: option.default,\n            tags: {\n              domain: \"cli\"\n            }\n          })\n        );\n    }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isPositionalCommandOption(segment))\n        .length ===\n        command.path.segments.filter(\n          segment => !isPositionalCommandOption(segment)\n        ).length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve-command.cjs","names":["esbuildPlugin","reflect","ReflectionClass","ReflectionKind","ReflectionVisibility","stringifyType","toArray","appendPath","commonPath","findFilePath","findFolderName","stripStars","replacePath","resolveParentPath","constantCase","titleCase","isSetObject","isSetString","resolveModule","getAppTitle","getDynamicPathSegmentName","isCatchAllPathSegment","isDynamicPathSegment","isOptionalCatchAllPathSegment","isPathSegmentGroup","getDefaultOptions","resolveCommandOptionDescription","kind","optional","name","title","defaultValue","boolean","array","trim","number","resolveCommandId","context","file","commandsPath","split","filter","p","Boolean","join","replaceAll","resolveCommandName","path","requireExtension","resolveCommandPath","resolveCommandDynamicPathSegments","map","findCommandsRoot","config","entry","projectRoot","workspaceConfig","workspaceRoot","Array","isArray","length","sourceRoot","extractCommandOption","command","reflection","propertyType","getType","option","getNameAsString","alias","getTags","description","getDescription","getKind","isOptional","getDefaultValue","env","default","variadic","type","string","Error","extractCommandDynamicSegment","segment","catchAll","segments","some","seg","reflectCommandTree","parent","isVirtual","replace","tree","dynamics","options","children","input","fs","existsSync","debug","id","resolved","plugins","reflectionLevel","metadata","function","parameters","firstParam","objectLiteral","class","optionsReflection","from","propertyReflection","getProperties","reduce","obj","index","paramName","Object","values","forEach","types","addProperty","undefined","visibility","public","tags","domain","inputs","slice","every","value"],"sources":["../../src/helpers/resolve-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 { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport type {\n  ReflectionProperty,\n  TypeParameter\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionKind,\n  ReflectionVisibility,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { stripStars } from \"@stryke/path/normalize\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { resolveModule } from \"powerlines/lib/utilities/resolve\";\nimport {\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isCatchAllPathSegment,\n  isDynamicPathSegment,\n  isOptionalCatchAllPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type {\n  CommandDynamicSegment,\n  CommandInput,\n  CommandModule,\n  CommandOption,\n  CommandTree,\n  NumberCommandOption,\n  StringCommandOption\n} from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { getDefaultOptions } from \"./utilities\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param name - The name of the command option.\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  kind: ReflectionKind,\n  optional: boolean,\n  name: string,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} ${\n    kind === ReflectionKind.boolean\n      ? \"flag provided via the command-line\"\n      : \"command-line option\"\n  } that allows the user to ${\n    kind === ReflectionKind.boolean\n      ? \"set the\"\n      : kind === ReflectionKind.array\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === ReflectionKind.boolean\n      ? \"indicator\"\n      : `${kind === ReflectionKind.number ? \"numeric\" : \"string\"} value${\n          kind === ReflectionKind.array ? \"s\" : \"\"\n        }`\n  } that will be used in the application.`;\n}\n\nexport function resolveCommandId(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(p => Boolean(p) && !isDynamicPathSegment(p))\n    .join(\"/\")\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .replaceAll(\"/\", \"-\");\n}\n\n/**\n * Finds the command name from the given file path.\n *\n * @param file - The file path to extract the command name from.\n * @returns The command name.\n */\nexport function resolveCommandName(file: string) {\n  let path = findFilePath(file);\n  let name = findFolderName(file, {\n    requireExtension: true\n  });\n\n  while (isDynamicPathSegment(name)) {\n    path = resolveParentPath(path);\n    name = findFolderName(path, {\n      requireExtension: true\n    });\n  }\n\n  return name;\n}\n\nexport function resolveCommandPath(context: Context, file: string): string {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .replaceAll(/^\\/+/g, \"\")\n    .replaceAll(/\\/+$/g, \"\")\n    .split(\"/\")\n    .filter(path => path && !isPathSegmentGroup(path))\n    .join(\"/\");\n}\n\nexport function resolveCommandDynamicPathSegments(\n  context: Context,\n  file: string\n): string[] {\n  return replacePath(findFilePath(file), context.commandsPath)\n    .split(\"/\")\n    .filter(path => Boolean(path) && isDynamicPathSegment(path))\n    .map(path => getDynamicPathSegmentName(path));\n}\n\nexport function findCommandsRoot(context: Context): string {\n  if (isSetString(context.config.entry)) {\n    return appendPath(\n      appendPath(stripStars(context.config.entry), context.config.projectRoot),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    isSetObject(context.config.entry) &&\n    \"file\" in context.config.entry\n  ) {\n    return appendPath(\n      appendPath(\n        stripStars(context.config.entry.file),\n        context.config.projectRoot\n      ),\n      context.workspaceConfig.workspaceRoot\n    );\n  } else if (\n    Array.isArray(context.config.entry) &&\n    context.config.entry.length > 0\n  ) {\n    return commonPath(\n      context.config.entry.map(entry =>\n        appendPath(\n          appendPath(\n            stripStars(isSetString(entry) ? entry : entry.file),\n            context.config.projectRoot\n          ),\n          context.workspaceConfig.workspaceRoot\n        )\n      )\n    );\n  }\n\n  return appendPath(\n    context.config.sourceRoot || context.config.projectRoot,\n    context.workspaceConfig.workspaceRoot\n  );\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandOption(\n  command: CommandInput,\n  reflection: ReflectionProperty\n): CommandOption {\n  const propertyType = reflection.getType();\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title:\n      reflection.getTags().title?.trim() ||\n      titleCase(reflection.getNameAsString()),\n    description:\n      reflection.getDescription() ||\n      resolveCommandOptionDescription(\n        reflection.getKind(),\n        reflection.isOptional(),\n        reflection.getNameAsString(),\n        reflection.getTags().title,\n        reflection.getDefaultValue()\n      ),\n    env: constantCase(reflection.getNameAsString()),\n    kind: propertyType.kind as\n      | ReflectionKind.string\n      | ReflectionKind.number\n      | ReflectionKind.boolean,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: false\n  } as CommandOption;\n  if (propertyType.kind === ReflectionKind.array) {\n    if (\n      propertyType.type.kind === ReflectionKind.string ||\n      propertyType.type.kind === ReflectionKind.number\n    ) {\n      (option as StringCommandOption | NumberCommandOption).variadic = true;\n      (option as StringCommandOption | NumberCommandOption).kind =\n        propertyType.type.kind;\n    } else {\n      throw new Error(\n        `Unsupported array type for option \"${reflection.getNameAsString()}\" in command \"${\n          command.name\n        }\". Only string[] and number[] are supported.`\n      );\n    }\n  } else if (\n    propertyType.kind !== ReflectionKind.boolean &&\n    propertyType.kind !== ReflectionKind.string &&\n    propertyType.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        command.name\n      }\". Only string, number, boolean, string[] and number[] are supported, received ${stringifyType(\n        propertyType\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return option;\n}\n\n/**\n * Extracts command parameter information from a type parameter reflection.\n *\n * @param command - The command tree to which the parameter belongs.\n * @param segment - The command path segment corresponding to the parameter.\n * @param reflection - The type parameter reflection to extract information from.\n * @returns The extracted command option information.\n */\nexport function extractCommandDynamicSegment(\n  command: CommandInput,\n  segment: string,\n  reflection: TypeParameter\n): CommandDynamicSegment {\n  if (\n    reflection.type.kind !== ReflectionKind.string &&\n    !(\n      reflection.type.kind === ReflectionKind.array &&\n      reflection.type.type.kind === ReflectionKind.string\n    )\n  ) {\n    throw new Error(\n      `Unsupported type for dynamic path segment \"${segment}\" in command \"${\n        command.name\n      }\". Only string types (or an array of strings) are supported, received ${stringifyType(\n        reflection.type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  const option = {\n    name: segment,\n    title: titleCase(segment),\n    description:\n      reflection.description ||\n      resolveCommandOptionDescription(\n        ReflectionKind.string,\n        !!reflection.optional,\n        segment,\n        titleCase(segment),\n        reflection.default\n      ),\n    optional: reflection.optional,\n    default: reflection.default,\n    catchAll: command.path.segments.some(\n      seg =>\n        getDynamicPathSegmentName(segment) === seg && isCatchAllPathSegment(seg)\n    )\n  } as CommandDynamicSegment;\n\n  if (reflection.type.kind === ReflectionKind.array) {\n    if (!option.catchAll) {\n      throw new Error(\n        `Dynamic path segment \"${segment}\" in command \"${\n          command.name\n        }\" is an array type but is not defined as a catch-all segment. To use an array type for a dynamic path segment, it must be defined as a catch-all segment using the \"[...segment]\" syntax.`\n      );\n    }\n\n    option.variadic = true;\n  }\n\n  if (option.catchAll) {\n    if (\n      !option.optional &&\n      command.path.segments.some(\n        seg =>\n          getDynamicPathSegmentName(segment) === seg &&\n          isOptionalCatchAllPathSegment(seg)\n      )\n    ) {\n      throw new Error(\n        `Dynamic path segment \"${segment}\" in command \"${\n          command.name\n        }\" is defined as a catch-all segment but is not optional. To define an optional catch-all segment, use the \"[[...segment]]\" syntax.`\n      );\n    } else if (\n      option.optional &&\n      !command.path.segments.some(\n        seg =>\n          getDynamicPathSegmentName(segment) === seg &&\n          isOptionalCatchAllPathSegment(seg)\n      )\n    ) {\n      throw new Error(\n        `Dynamic path segment \"${segment}\" in command \"${\n          command.name\n        }\" is defined as an optional segment but is not defined as an optional catch-all segment. To define an optional catch-all segment, use the \"[[...segment]]\" syntax.`\n      );\n    }\n  }\n\n  return option;\n}\n\n/**\n * Reflects the command tree for a given command input.\n *\n * @param context - The context in which the command is being reflected.\n * @param command - The command input to reflect.\n * @param parent - The parent command tree, if any.\n * @returns The reflected command tree.\n */\nexport async function reflectCommandTree<TContext extends Context = Context>(\n  context: TContext,\n  command: CommandInput,\n  parent?: CommandTree\n): Promise<CommandTree> {\n  const title =\n    command.title ||\n    `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/ Commands$/, \"\") : parent.title} - ` : \"\"}${titleCase(command.name)}${\n      command.isVirtual ? \" Commands\" : \"\"\n    }`;\n\n  const tree = {\n    alias: [],\n    ...command,\n    title,\n    path: {\n      ...command.path,\n      dynamics: {}\n    },\n    options: getDefaultOptions(context, command),\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\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 user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    const resolved = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n\n    const metadata = resolved.metadata ?? {};\n    if (isSetString(metadata.title)) {\n      tree.title = metadata.title;\n    }\n    if (isSetString(metadata.description)) {\n      tree.description = metadata.description;\n    }\n    if (\n      isSetString(metadata.alias) ||\n      (Array.isArray(metadata.alias) && metadata.alias.length > 0)\n    ) {\n      tree.alias = toArray(metadata.alias);\n    }\n\n    const type = reflect(resolved);\n\n    // const type = await reflectType<TContext>(context, command.entry.input);\n    if (type.kind !== ReflectionKind.function) {\n      throw new Error(\n        `The command entry file \"${command.entry.input.file}\" does not export a valid function.`\n      );\n    }\n\n    tree.description ??=\n      command.description ||\n      type.description ||\n      `The ${tree.title} executable command-line interface.`;\n\n    if (type.parameters.length > 0 && type.parameters[0]) {\n      const firstParam = type.parameters[0];\n      if (\n        firstParam.type.kind === ReflectionKind.objectLiteral ||\n        firstParam.type.kind === ReflectionKind.class\n      ) {\n        const optionsReflection = ReflectionClass.from(firstParam.type);\n        for (const propertyReflection of optionsReflection.getProperties()) {\n          tree.options[propertyReflection.getNameAsString()] =\n            extractCommandOption(command, propertyReflection);\n        }\n      }\n\n      tree.path.dynamics = tree.path.segments\n        .filter(segment => isDynamicPathSegment(segment))\n        .reduce(\n          (obj, segment, index) => {\n            if (\n              type.parameters.length < index + 2 ||\n              !type.parameters[index + 1]\n            ) {\n              return obj;\n            }\n\n            const paramName = getDynamicPathSegmentName(segment);\n            obj[paramName] = extractCommandDynamicSegment(\n              command,\n              paramName,\n              type.parameters[index + 1]!\n            );\n\n            obj[paramName].description =\n              obj[paramName].description ||\n              `The ${paramName} ${\n                obj[paramName].catchAll\n                  ? `${obj[paramName].optional ? \"optional \" : \"\"}catch-all`\n                  : \"dynamic \"\n              } segment for the ${command.name} command.`;\n\n            return obj;\n          },\n          {} as Record<string, CommandDynamicSegment>\n        );\n    }\n  } else {\n    tree.description ??= `A collection of available ${\n      tree.title || titleCase(tree.name)\n    } commands that are included in the ${getAppTitle(\n      context\n    )} command-line application.`;\n  }\n\n  if (context.env) {\n    if (isSetObject(tree.options)) {\n      Object.values(tree.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          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:\n              option.kind === ReflectionKind.string ||\n              option.kind === ReflectionKind.number\n                ? option.variadic\n                  ? { kind: ReflectionKind.array, type: { kind: option.kind } }\n                  : { kind: option.kind }\n                : { kind: ReflectionKind.boolean },\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 0)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    // if (\n    //   Object.values(tree.path.dynamics).filter(option => option.env !== false)\n    //     .length > 0\n    // ) {\n    //   Object.values(tree.path.dynamics)\n    //     .filter(option => option.env !== false)\n    //     .forEach(option =>\n    //       context.env.types.env.addProperty({\n    //         name: constantCase(option.name),\n    //         optional: option.optional ? true : undefined,\n    //         description: option.description,\n    //         visibility: ReflectionVisibility.public,\n    //         type: option.variadic\n    //           ? {\n    //               kind: ReflectionKind.array,\n    //               type: { kind: ReflectionKind.string }\n    //             }\n    //           : { kind: ReflectionKind.string },\n    //         default: option.default,\n    //         tags: {\n    //           domain: \"cli\"\n    //         }\n    //       })\n    //     );\n    // }\n  }\n\n  for (const input of context.inputs.filter(\n    input =>\n      input.path.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        command.path.segments.filter(segment => !isDynamicPathSegment(segment))\n          .length +\n          1 &&\n      input.path.segments\n        .slice(0, command.path.segments.length)\n        .every((value, index) => value === command.path.segments[index])\n  )) {\n    tree.children[input.name] = await reflectCommandTree(context, input, tree);\n  }\n\n  return tree;\n}\n"],"mappings":"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"}