@shell-shock/core 0.17.1 → 0.17.3

package/dist/components/utils-builtin.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils-builtin.cjs","names":[],"sources":["../../src/components/utils-builtin.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, Show, splitProps } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n  TSDoc,\n  TSDocInternal,\n  TSDocLink,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport defu from \"defu\";\nimport type { Context } from \"../types/context\";\n\nexport interface UtilsBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {}\n\n/**\n * Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.\n */\nexport function FindSuggestionsDeclaration() {\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <VarDeclaration\n        const\n        name=\"deburred\"\n        initializer={code` {\n          \"\\\\xc0\": \"A\",  \"\\\\xc1\": \"A\", \"\\\\xc2\": \"A\", \"\\\\xc3\": \"A\", \"\\\\xc4\": \"A\", \"\\\\xc5\": \"A\",\n          \"\\\\xe0\": \"a\",  \"\\\\xe1\": \"a\", \"\\\\xe2\": \"a\", \"\\\\xe3\": \"a\", \"\\\\xe4\": \"a\", \"\\\\xe5\": \"a\",\n          \"\\\\xc7\": \"C\",  \"\\\\xe7\": \"c\",\n          \"\\\\xd0\": \"D\",  \"\\\\xf0\": \"d\",\n          \"\\\\xc8\": \"E\",  \"\\\\xc9\": \"E\", \"\\\\xca\": \"E\", \"\\\\xcb\": \"E\",\n          \"\\\\xe8\": \"e\",  \"\\\\xe9\": \"e\", \"\\\\xea\": \"e\", \"\\\\xeb\": \"e\",\n          \"\\\\xcc\": \"I\",  \"\\\\xcd\": \"I\", \"\\\\xce\": \"I\", \"\\\\xcf\": \"I\",\n          \"\\\\xec\": \"i\",  \"\\\\xed\": \"i\", \"\\\\xee\": \"i\", \"\\\\xef\": \"i\",\n          \"\\\\xd1\": \"N\",  \"\\\\xf1\": \"n\",\n          \"\\\\xd2\": \"O\",  \"\\\\xd3\": \"O\", \"\\\\xd4\": \"O\", \"\\\\xd5\": \"O\", \"\\\\xd6\": \"O\", \"\\\\xd8\": \"O\",\n          \"\\\\xf2\": \"o\",  \"\\\\xf3\": \"o\", \"\\\\xf4\": \"o\", \"\\\\xf5\": \"o\", \"\\\\xf6\": \"o\", \"\\\\xf8\": \"o\",\n          \"\\\\xd9\": \"U\",  \"\\\\xda\": \"U\", \"\\\\xdb\": \"U\", \"\\\\xdc\": \"U\",\n          \"\\\\xf9\": \"u\",  \"\\\\xfa\": \"u\", \"\\\\xfb\": \"u\", \"\\\\xfc\": \"u\",\n          \"\\\\xdd\": \"Y\",  \"\\\\xfd\": \"y\", \"\\\\xff\": \"y\",\n          \"\\\\xc6\": \"Ae\", \"\\\\xe6\": \"ae\",\n          \"\\\\xde\": \"Th\", \"\\\\xfe\": \"th\",\n          \"\\\\xdf\": \"ss\",\n          \"\\\\u0100\": \"A\",  \"\\\\u0102\": \"A\", \"\\\\u0104\": \"A\",\n          \"\\\\u0101\": \"a\",  \"\\\\u0103\": \"a\", \"\\\\u0105\": \"a\",\n          \"\\\\u0106\": \"C\",  \"\\\\u0108\": \"C\", \"\\\\u010a\": \"C\", \"\\\\u010c\": \"C\",\n          \"\\\\u0107\": \"c\",  \"\\\\u0109\": \"c\", \"\\\\u010b\": \"c\", \"\\\\u010d\": \"c\",\n          \"\\\\u010e\": \"D\",  \"\\\\u0110\": \"D\", \"\\\\u010f\": \"d\", \"\\\\u0111\": \"d\",\n          \"\\\\u0112\": \"E\",  \"\\\\u0114\": \"E\", \"\\\\u0116\": \"E\", \"\\\\u0118\": \"E\", \"\\\\u011a\": \"E\",\n          \"\\\\u0113\": \"e\",  \"\\\\u0115\": \"e\", \"\\\\u0117\": \"e\", \"\\\\u0119\": \"e\", \"\\\\u011b\": \"e\",\n          \"\\\\u011c\": \"G\",  \"\\\\u011e\": \"G\", \"\\\\u0120\": \"G\", \"\\\\u0122\": \"G\",\n          \"\\\\u011d\": \"g\",  \"\\\\u011f\": \"g\", \"\\\\u0121\": \"g\", \"\\\\u0123\": \"g\",\n          \"\\\\u0124\": \"H\",  \"\\\\u0126\": \"H\", \"\\\\u0125\": \"h\", \"\\\\u0127\": \"h\",\n          \"\\\\u0128\": \"I\",  \"\\\\u012a\": \"I\", \"\\\\u012c\": \"I\", \"\\\\u012e\": \"I\", \"\\\\u0130\": \"I\",\n          \"\\\\u0129\": \"i\",  \"\\\\u012b\": \"i\", \"\\\\u012d\": \"i\", \"\\\\u012f\": \"i\", \"\\\\u0131\": \"i\",\n          \"\\\\u0134\": \"J\",  \"\\\\u0135\": \"j\",\n          \"\\\\u0136\": \"K\",  \"\\\\u0137\": \"k\", \"\\\\u0138\": \"k\",\n          \"\\\\u0139\": \"L\",  \"\\\\u013b\": \"L\", \"\\\\u013d\": \"L\", \"\\\\u013f\": \"L\", \"\\\\u0141\": \"L\",\n          \"\\\\u013a\": \"l\",  \"\\\\u013c\": \"l\", \"\\\\u013e\": \"l\", \"\\\\u0140\": \"l\", \"\\\\u0142\": \"l\",\n          \"\\\\u0143\": \"N\",  \"\\\\u0145\": \"N\", \"\\\\u0147\": \"N\", \"\\\\u014a\": \"N\",\n          \"\\\\u0144\": \"n\",  \"\\\\u0146\": \"n\", \"\\\\u0148\": \"n\", \"\\\\u014b\": \"n\",\n          \"\\\\u014c\": \"O\",  \"\\\\u014e\": \"O\", \"\\\\u0150\": \"O\",\n          \"\\\\u014d\": \"o\",  \"\\\\u014f\": \"o\", \"\\\\u0151\": \"o\",\n          \"\\\\u0154\": \"R\",  \"\\\\u0156\": \"R\", \"\\\\u0158\": \"R\",\n          \"\\\\u0155\": \"r\",  \"\\\\u0157\": \"r\", \"\\\\u0159\": \"r\",\n          \"\\\\u015a\": \"S\",  \"\\\\u015c\": \"S\", \"\\\\u015e\": \"S\", \"\\\\u0160\": \"S\",\n          \"\\\\u015b\": \"s\",  \"\\\\u015d\": \"s\", \"\\\\u015f\": \"s\", \"\\\\u0161\": \"s\",\n          \"\\\\u0162\": \"T\",  \"\\\\u0164\": \"T\", \"\\\\u0166\": \"T\",\n          \"\\\\u0163\": \"t\",  \"\\\\u0165\": \"t\", \"\\\\u0167\": \"t\",\n          \"\\\\u0168\": \"U\",  \"\\\\u016a\": \"U\", \"\\\\u016c\": \"U\", \"\\\\u016e\": \"U\", \"\\\\u0170\": \"U\", \"\\\\u0172\": \"U\",\n          \"\\\\u0169\": \"u\",  \"\\\\u016b\": \"u\", \"\\\\u016d\": \"u\", \"\\\\u016f\": \"u\", \"\\\\u0171\": \"u\", \"\\\\u0173\": \"u\",\n          \"\\\\u0174\": \"W\",  \"\\\\u0175\": \"w\",\n          \"\\\\u0176\": \"Y\",  \"\\\\u0177\": \"y\", \"\\\\u0178\": \"Y\",\n          \"\\\\u0179\": \"Z\",  \"\\\\u017b\": \"Z\", \"\\\\u017d\": \"Z\",\n          \"\\\\u017a\": \"z\",  \"\\\\u017c\": \"z\", \"\\\\u017e\": \"z\",\n          \"\\\\u0132\": \"IJ\", \"\\\\u0133\": \"ij\",\n          \"\\\\u0152\": \"Oe\", \"\\\\u0153\": \"oe\",\n          \"\\\\u0149\": \"n\", \"\\\\u017f\": \"s\"\n        } as Record<string, string>; `}\n      />\n      <Spacing />\n      <TSDoc heading=\"A utility function that takes an input string and a list of possible matches, and returns a list of suggested matches based on the Levenshtein distance between the input and the possible matches.\">\n        <TSDocRemarks>\n          {\n            \"This function is intended to be used to suggest corrections for potentially misspelled options or commands.\"\n          }\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocInternal />\n        <Spacing />\n        <TSDocParam name=\"input\">\n          {\"The input string to check for potential matches.\"}\n        </TSDocParam>\n        <TSDocParam name=\"options\">\n          {\"A list of possible matches to compare against the input.\"}\n        </TSDocParam>\n        <TSDocReturns>\n          {\"A list of suggested matches based on the Levenshtein distance.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"findSuggestions\"\n        parameters={[\n          {\n            name: \"input\",\n            type: \"string\"\n          },\n          {\n            name: \"options\",\n            type: \"string[]\"\n          }\n        ]}\n        returnType=\"string[]\">\n        <VarDeclaration\n          const\n          name=\"normalizedInput\"\n          initializer={code`String(input ?? \"\")${\n            context.config.isCaseSensitive ? \"\" : \".toLowerCase()\"\n          }.trim().replaceAll(/[\\\\s\\\\-_\\\\.]+/gu, \" \").replace(/[\\\\\\\\xc0-\\\\\\\\xd6\\\\\\\\xd8-\\\\\\\\xf6\\\\\\\\xf8-\\\\\\\\xff\\\\\\\\u0100-\\\\\\\\u017f]/g, key => deburred[key]).replace(/[\\\\\\\\u0300-\\\\\\\\u036f\\\\\\\\ufe20-\\\\\\\\ufe2f\\\\\\\\u20d0-\\\\\\\\u20ff]/g, \"\"); `}\n        />\n        <Spacing />\n        {code`\n        if (!normalizedInput || options.length === 0) {\n          return [];\n        }\n\n        const threshold = Math.ceil(normalizedInput.length * 0.25) || 1;\n        const results: Array<{ option: string; distance: number }> = [];\n\n        for (const option of options) {\n          const normalizedOption = String(option ?? \"\")${\n            context.config.isCaseSensitive ? \"\" : \".toLowerCase()\"\n          }.trim().replaceAll(/[\\\\s\\\\-_\\\\.]+/gu, \" \").replace(/[\\\\\\\\xc0-\\\\\\\\xd6\\\\\\\\xd8-\\\\\\\\xf6\\\\\\\\xf8-\\\\\\\\xff\\\\\\\\u0100-\\\\\\\\u017f]/g, key => deburred[key]).replace(/[\\\\\\\\u0300-\\\\\\\\u036f\\\\\\\\ufe20-\\\\\\\\ufe2f\\\\\\\\u20d0-\\\\\\\\u20ff]/g, \"\");\n\n          if (!normalizedOption) {\n            continue;\n          }\n\n          const lenA = normalizedInput.length;\n          const lenB = normalizedOption.length;\n\n          if (Math.abs(lenA - lenB) > threshold) {\n            continue;\n          }\n\n          let distance: number;\n          if (lenA === 0) {\n            distance = lenB;\n          } else if (lenB === 0) {\n            distance = lenA;\n          } else if (lenA <= 32) {\n            const peq: Record<string, number> = {};\n            for (let i = 0; i < lenA; i++) {\n              const c = normalizedInput[i]!;\n              peq[c] = (peq[c] || 0) | (1 << i);\n            }\n\n            let pv = -1;\n            let mv = 0;\n            let score = lenA;\n\n            for (let j = 0; j < lenB; j++) {\n              const eq = peq[normalizedOption[j]!] || 0;\n              const xv = eq | mv;\n              const xh = ((eq & pv) + pv) ^ pv ^ eq;\n              let ph = mv | ~(xh | pv);\n              let mh = pv & xh;\n\n              if ((ph >>> (lenA - 1)) & 1) {\n                score++;\n              }\n              if ((mh >>> (lenA - 1)) & 1) {\n                score--;\n              }\n\n              ph = (ph << 1) | 1;\n              mh = mh << 1;\n              pv = mh | ~(xv | ph);\n              mv = ph & xv;\n            }\n\n            distance = score;\n          } else {\n            const row = new Array(lenB + 1);\n            for (let j = 0; j <= lenB; j++) {\n              row[j] = j;\n            }\n\n            for (let i = 1; i <= lenA; i++) {\n              let prev = i;\n              for (let j = 1; j <= lenB; j++) {\n                const val = normalizedInput[i - 1] === normalizedOption[j - 1]\n                  ? row[j - 1]\n                  : Math.min(row[j - 1], prev, row[j]) + 1;\n                row[j - 1] = prev;\n                prev = val;\n              }\n              row[lenB] = prev;\n            }\n\n            distance = row[lenB];\n          }\n\n          if (distance <= threshold) {\n            results.push({ option, distance });\n          }\n        }\n\n        return results.sort((a, b) => a.distance - b.distance).map(r => r.option);\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).\n */\nexport function TerminalSizeDeclaration() {\n  return (\n    <>\n      <VarDeclaration\n        export\n        const\n        name=\"DEFAULT_TERMINAL_COLUMNS\"\n        doc=\"Default number of terminal columns\"\n        initializer={code`80`}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"DEFAULT_TERMINAL_ROWS\"\n        doc=\"Default number of terminal rows\"\n        initializer={code`24`}\n      />\n      <Spacing />\n      <FunctionDeclaration name=\"isForegroundProcess\">\n        {code`if (isLinux) {\n          return true;\n        }\n\n        try {\n          const statContents = readFileSync(\"/proc/self/stat\", \"utf8\");\n          const closingParenthesisIndex = statContents.lastIndexOf(') ');\n\n          if (closingParenthesisIndex === -1) {\n            return false;\n          }\n\n          const statFields = statContents.slice(closingParenthesisIndex + 2).trim().split(/\\\\s+/);\n          const processGroupId = Number.parseInt(statFields[2], 10);\n          const foregroundProcessGroupId = Number.parseInt(statFields[5], 10);\n\n          if (Number.isNaN(processGroupId) || Number.isNaN(foregroundProcessGroupId)) {\n            return false;\n          }\n\n          if (foregroundProcessGroupId <= 0) {\n            return false;\n          }\n\n          return processGroupId === foregroundProcessGroupId;\n        } catch {\n          return false;\n        } `}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration name=\"tput\">\n        {code`try {\n            const columns = execSync([\"tput\", \"cols\"], { env: { TERM: 'dumb', ...process.env } });\n            const rows = execSync([\"tput\", \"lines\"], { env: { TERM: 'dumb', ...process.env } });\n\n            if (columns && rows) {\n              return { columns: Number.parseInt(columns.toString().trim(), 10), rows: Number.parseInt(rows.toString().trim(), 10) };\n            }\n          } catch {}  `}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration name=\"devTty\">\n        {code`try {\n          const writeStream = new WriteStream(\n            openSync(\n              \"/dev/tty\",\n              fsConstants.O_NONBLOCK\n            )\n          ).getWindowSize();\n\n          return { columns: writeStream[0], rows: writeStream[1] };\n        } catch {}  `}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"A utility function that attempts to determine the size of the terminal (number of columns and rows) using various methods, and falls back to default values if it cannot be determined. This can be used to adjust output formatting based on the available terminal size.\">\n        <TSDocRemarks>\n          {\n            \"The function first checks if the process is running in a TTY environment and if the stdout or stderr streams provide column and row information. If not, it attempts to use platform-specific methods (like reading from /proc/self/stat on Linux, using tput on Unix-like systems, or checking /dev/tty) to determine the terminal size. If all else fails, it returns default values.\"\n          }\n        </TSDocRemarks>\n        <Spacing />\n        <TSDocReturns>\n          {\n            \"An object containing the number of columns and rows of the terminal.\"\n          }\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"getTerminalSize\"\n        returnType=\"{ columns: number; rows: number; }\">\n        <IfStatement\n          condition={code`process.stdout?.columns && process.stdout?.rows`}>\n          {code`return { columns: process.stdout.columns, rows: process.stdout.rows }; `}\n        </IfStatement>\n        <IfStatement\n          condition={code`process.stderr?.columns && process.stderr?.rows`}>\n          {code`return { columns: process.stderr.columns, rows: process.stderr.rows };`}\n        </IfStatement>\n        <Spacing />\n        <IfStatement condition={code`isWindows`}>\n          {code`return tput() ?? {\n            columns: DEFAULT_TERMINAL_COLUMNS,\n            rows: DEFAULT_TERMINAL_ROWS,\n          }; `}\n        </IfStatement>\n        <IfStatement condition={code`isMacOS`}>\n          {code`return devTty() ?? tput() ?? {\n            columns: DEFAULT_TERMINAL_COLUMNS,\n            rows: DEFAULT_TERMINAL_ROWS,\n          }; `}\n        </IfStatement>\n        <Spacing />\n        <VarDeclaration\n          let\n          name=\"result\"\n          initializer={code`devTty() ?? tput(); `}\n        />\n        <IfStatement condition={code`!result && isForegroundProcess()`}>\n          {code`try {\n          const size = execSync([\"resize\", \"-u\"]).match(/\\\\d+/g);\n          if (size.length === 2) {\n            result = { columns: Number.parseInt(size[0], 10), rows: Number.parseInt(size[1], 10) };\n          }\n        } catch {} `}\n        </IfStatement>\n        <Spacing />\n        {code`return result ?? {\n          columns: DEFAULT_TERMINAL_COLUMNS,\n          rows: DEFAULT_TERMINAL_ROWS,\n        }; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function EnvSupportUtilities() {\n  return (\n    <>\n      <VarDeclaration\n        export\n        const\n        name=\"isTTY\"\n        doc=\"Detect if stdout.TTY is available\"\n        initializer={code`Boolean(process.stdout && process.stdout.isTTY);`}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isMinimal\"\n        doc=\"Detect if the current environment is minimal (CI, non-TTY, etc.)\"\n        initializer={code` env.MINIMAL || isCI || isTest || !isTTY; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isInteractive\"\n        doc=\"Detect if the current environment is interactive\"\n        initializer={code` !isMinimal && process.stdin?.isTTY && env.TERM !== \"dumb\" && !hasFlag([\"no-interactive\", \"non-interactive\", \"no-interact\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function ColorSupportUtilities() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"GetColorSupportLevelOptions\"\n        doc=\"Options for the getColorSupportLevel function\">\n        <InterfaceMember\n          name=\"ignoreFlags\"\n          type=\"boolean\"\n          doc=\"Indicates if the function should skip checking command-line flags for color support\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Checks if a specific flag is present in the command-line arguments.\">\n        <TSDocLink>\n          {\"https://github.com/sindresorhus/has-flag/blob/main/index.js\"}\n        </TSDocLink>\n        <TSDocParam name=\"flag\">\n          {'The flag to check for, e.g., \"color\", \"no-color\".'}\n        </TSDocParam>\n        <TSDocParam name=\"argv\">\n          {\n            \"The command-line arguments to check against. Defaults to global Deno args or process args.\"\n          }\n        </TSDocParam>\n        <TSDocReturns>\n          {\"True if the flag is present, false otherwise.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"getColorSupportLevel\"\n        parameters={[\n          { name: \"stream\", type: \"NodeJS.WriteStream & { fd: 1 | 2; }\" },\n          {\n            name: \"options\",\n            type: \"GetColorSupportLevelOptions\",\n            default: \"{ ignoreFlags: false }\"\n          }\n        ]}>\n        {code`const { ignoreFlags } = options;\n\n        let forceColor: number | undefined;\n        if (env.FORCE_COLOR !== undefined) {\n          forceColor = !env.FORCE_COLOR\n            ? 0\n            : typeof env.FORCE_COLOR === \"boolean\"\n            ? 1\n            : typeof env.FORCE_COLOR === \"number\" &&\n              [0, 1, 2, 3].includes(Math.min(env.FORCE_COLOR as number, 3))\n            ? Math.min(env.FORCE_COLOR as number, 3)\n            : undefined;\n        }\n\n        if (ignoreFlags !== true && forceColor === undefined) {\n          if (\n            hasFlag(\"no-color\") ||\n            hasFlag(\"no-colors\") ||\n            hasFlag(\"color=false\") ||\n            hasFlag(\"color=never\")\n          ) {\n            return 0;\n          }\n\n          if (\n            hasFlag(\"color=16m\") ||\n            hasFlag(\"color=full\") ||\n            hasFlag(\"color=truecolor\")\n          ) {\n            return 3;\n          }\n\n          if (hasFlag(\"color=256\")) {\n            return 2;\n          }\n\n          if (\n            hasFlag(\"color\") ||\n            hasFlag(\"colors\") ||\n            hasFlag(\"color=true\") ||\n            hasFlag(\"color=always\")\n          ) {\n            forceColor = 1;\n          }\n        }\n\n        const level = Boolean(env.TF_BUILD) || Boolean(env.AGENT_NAME)\n          ? 1\n          : stream &&\n              !(isTTY || (stream && stream.isTTY)) &&\n              forceColor === undefined\n            ? 0\n            : env.TERM === \"dumb\"\n              ? forceColor || 0\n              : isWindows\n                ? Number(os.release().split(\".\")[0]) >= 10 &&\n                  Number(os.release().split(\".\")[2]) >= 10_586\n                  ? Number(os.release().split(\".\")[2]) >= 14_931\n                    ? 3\n                    : 2\n                  : 1\n                : isCI\n                  ? Boolean(env.GITHUB_ACTIONS) ||\n                    Boolean(env.GITEA_ACTIONS) ||\n                    Boolean(env.CIRCLECI)\n                    ? 3\n                    : Boolean(env.TRAVIS) ||\n                      Boolean(env.APPVEYOR) ||\n                      Boolean(env.GITLAB_CI) ||\n                      Boolean(env.BUILDKITE) ||\n                      Boolean(env.DRONE) ||\n                      env.CI_NAME === \"codeship\"\n                      ? 1\n                      : forceColor || 0\n                  : Boolean(env.TEAMCITY_VERSION)\n                    ? /^(?:9\\.0*[1-9]\\d*\\.|\\d{2,}\\.)/.test(String(env.TEAMCITY_VERSION) || \"\")\n                      ? 1\n                      : 0\n                    : String(env.COLORTERM) === \"truecolor\" ||\n                        env.TERM === \"xterm-kitty\"\n                      ? 3\n                      : Boolean(env.TERM_PROGRAM)\n                        ? env.TERM_PROGRAM === \"iTerm.app\"\n                          ? Number.parseInt(\n                              (env.TERM_PROGRAM_VERSION || \"\").split(\".\")[0] as string,\n                              10\n                            ) >= 3\n                            ? 3\n                            : 2\n                          : env.TERM_PROGRAM === \"Apple_Terminal\"\n                            ? 2\n                            : 0\n                        : /-256(?:color)?$/i.test(env.TERM || \"\")\n                          ? 2\n                          : /^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(\n                                env.TERM || \"\"\n                              )\n                            ? 1\n                            : Boolean(env.COLORTERM);\n\n        return typeof level === \"boolean\" || level === 0\n          ? false\n          : {\n              level,\n              hasBasic: true,\n              has256: level >= 2,\n              has16m: level >= 3,\n            };\n\n  `}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"colorSupportLevels\"\n        doc=\"Detect the terminal color support level in the current environment\"\n        initializer={code` {\n    stdout: getColorSupportLevel(process.stdout),\n    stderr: getColorSupportLevel(process.stderr),\n  }; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isColorSupported\"\n        doc=\"Detect if terminal color is supported in the current environment\"\n        initializer={code` Boolean(colorSupportLevels.stdout); `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isUnicodeSupported\"\n        doc=\"Detect if Unicode characters are supported in the current environment\"\n        initializer={code` !isWindows\n            ? env.TERM !== \"linux\"\n            : Boolean(env.WT_SESSION) ||\n                Boolean(env.TERMINUS_SUBLIME) ||\n                env.ConEmuTask === \"{cmd::Cmder}\" ||\n                env.TERM_PROGRAM === \"Terminus-Sublime\" ||\n                env.TERM_PROGRAM === \"vscode\" ||\n                env.TERM === \"xterm-256color\" ||\n                env.TERM === \"alacritty\" ||\n                env.TERM === \"rxvt-unicode\" ||\n                env.TERM === \"rxvt-unicode-256color\" ||\n                env.TERMINAL_EMULATOR === \"JetBrains-JediTerm\"; `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\n\nexport function HyperlinkSupportUtilities() {\n  return (\n    <>\n      <FunctionDeclaration\n        name=\"parseVersion\"\n        parameters={[{ name: \"version\", type: \"string\", default: '\"\"' }]}>\n        {code`if (/^\\d{3,4}$/.test(version)) {\n        const match = /(\\d{1,2})(\\d{2})/.exec(version) ?? [];\n\n        return {\n          major: 0,\n          minor: Number.parseInt(match[1]!, 10),\n          patch: Number.parseInt(match[2]!, 10)\n        };\n      }\n\n      const versionParts = (version ?? \"\")\n        .split(\".\")\n        .map(n => Number.parseInt(n, 10));\n\n      return {\n        major: versionParts[0],\n        minor: versionParts[1],\n        patch: versionParts[2]\n      }; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Check if the current environment/terminal supports hyperlinks in the terminal.\">\n        <TSDocReturns>\n          {\"True if the current environment/terminal supports hyperlinks.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"isHyperlinkSupported\"\n        returnType=\"boolean\">\n        {code`if (Boolean(env.FORCE_HYPERLINK)) {\n          return true;\n        }\n\n        if (Boolean(env.NETLIFY)) {\n          return true;\n        } else if (isColorSupported || isTTY) {\n          return false;\n        } else if (Boolean(env.WT_SESSION)) {\n          return true;\n        } else if (isWindows || isMinimal || Boolean(env.TEAMCITY_VERSION)) {\n          return false;\n        } else if (Boolean(env.TERM_PROGRAM)) {\n          const version = parseVersion(env.TERM_PROGRAM_VERSION);\n\n          switch (String(env.TERM_PROGRAM)) {\n            case \"iTerm.app\": {\n              if (version.major === 3) {\n                return version.minor !== undefined && version.minor >= 1;\n              }\n\n              return version.major !== undefined && version.major > 3;\n            }\n            case \"WezTerm\": {\n              return version.major !== undefined && version.major >= 20_200_620;\n            }\n\n            case \"vscode\": {\n              if (Boolean(env.CURSOR_TRACE_ID)) {\n                return true;\n              }\n\n              return (\n                version.minor !== undefined &&\n                version.major !== undefined &&\n                (version.major > 1 || (version.major === 1 && version.minor >= 72))\n              );\n            }\n\n            case \"ghostty\": {\n              return true;\n            }\n          }\n        }\n\n        if (Boolean(env.VTE_VERSION)) {\n          if (env.VTE_VERSION === \"0.50.0\") {\n            return false;\n          }\n\n          const version = parseVersion(env.VTE_VERSION);\n          return (\n            (version.major !== undefined && version.major > 0) ||\n            (version.minor !== undefined && version.minor >= 50)\n          );\n        }\n\n        if (String(env.TERM) === \"alacritty\") {\n          return true;\n        }\n\n        return false; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * Generates the `resolveModule` function declaration, which is a utility for resolving file paths across different platforms.\n */\nexport function ResolveModuleFunctionDeclaration() {\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <Spacing />\n      <InterfaceDeclaration\n        name=\"ResolveModuleOptions\"\n        doc=\"Options for the `resolve` handler function.\">\n        <InterfaceMember\n          name=\"parentURL\"\n          optional\n          type=\"string\"\n          doc=\"The parent URL to use for resolving paths.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"conditions\"\n          optional\n          type=\"string[]\"\n          doc=\"The conditions to use for resolving paths.\"\n        />\n        <hbr />\n      </InterfaceDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        name=\"PackageConfig\"\n        doc=\"Parsed package.json configuration for module resolution.\">\n        <InterfaceMember\n          name=\"pjsonPath\"\n          type=\"string\"\n          doc=\"The path to the package.json file.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"exists\"\n          type=\"boolean\"\n          doc=\"Whether the package.json file exists.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"main\"\n          optional\n          type=\"string\"\n          doc=\"The main entry point of the package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"name\"\n          optional\n          type=\"string\"\n          doc=\"The name of the package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"type\"\n          optional\n          type={`\"commonjs\" | \"module\" | \"none\"`}\n          doc=\"The module type of the package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"exports\"\n          optional\n          type=\"Record<string, unknown>\"\n          doc=\"The exports map of the package.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"imports\"\n          optional\n          type=\"Record<string, unknown>\"\n          doc=\"The imports map of the package.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <VarDeclaration\n        const\n        name=\"DEFAULT_CONDITIONS_SET\"\n        initializer={code`new Set([\"node\", \"import\"]);`}\n      />\n      <Spacing />\n      <VarDeclaration\n        const\n        name=\"DEFAULT_EXTENSIONS\"\n        initializer={code`[\".mjs\", \".cjs\", \".js\", \".json\", \".node\"];`}\n      />\n      <Spacing />\n      <VarDeclaration\n        const\n        name=\"invalidPackageNameRegEx\"\n        initializer={code`/^\\\\.|\\\\/|%/;`}\n      />\n      <Spacing />\n      <FunctionDeclaration\n        name=\"readPackageConfig\"\n        parameters={[{ name: \"jsonPath\", type: \"string\" }]}\n        returnType=\"PackageConfig\">\n        {code`const result: PackageConfig = {\n          pjsonPath: jsonPath,\n          exists: false,\n          main: undefined,\n          name: undefined,\n          type: \"none\",\n          exports: undefined,\n          imports: undefined\n        };\n\n        let content: string;\n        try {\n          content = readFileSync(jsonPath, \"utf8\");\n        } catch (err: any) {\n          if (err?.code === \"ENOENT\") {\n            return result;\n          }\n          throw err;\n        }\n\n        let parsed: Record<string, unknown>;\n        try {\n          parsed = JSON.parse(content);\n        } catch {\n          return result;\n        }\n\n        result.exists = true;\n\n        if (typeof parsed.name === \"string\") {\n          result.name = parsed.name;\n        }\n        if (typeof parsed.main === \"string\") {\n          result.main = parsed.main;\n        }\n        if (parsed.exports !== undefined && parsed.exports !== null) {\n          result.exports = parsed.exports as Record<string, unknown>;\n        }\n        if (parsed.imports !== undefined && parsed.imports !== null) {\n          result.imports = parsed.imports as Record<string, unknown>;\n        }\n        if (parsed.type === \"commonjs\" || parsed.type === \"module\") {\n          result.type = parsed.type;\n        }\n\n        return result;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"getPackageScopeConfig\"\n        parameters={[{ name: \"resolved\", type: \"URL | string\" }]}\n        returnType=\"PackageConfig\">\n        {code`let packageJSONUrl = new URL(\"package.json\", resolved);\n\n        while (true) {\n          const packageJSONPath = packageJSONUrl.pathname;\n          if (packageJSONPath.endsWith(\"node_modules/package.json\")) {\n            break;\n          }\n\n          const packageConfig = readPackageConfig(fileURLToPath(packageJSONUrl));\n          if (packageConfig.exists) {\n            return packageConfig;\n          }\n\n          const lastPackageJSONUrl = packageJSONUrl;\n          packageJSONUrl = new URL(\"../package.json\", packageJSONUrl);\n\n          if (packageJSONUrl.pathname === lastPackageJSONUrl.pathname) {\n            break;\n          }\n        }\n\n        return {\n          pjsonPath: fileURLToPath(packageJSONUrl),\n          exists: false,\n          type: \"none\"\n        };`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"isConditionalExportsMainSugar\"\n        parameters={[{ name: \"exports\", type: \"unknown\" }]}\n        returnType=\"boolean\">\n        {code`if (typeof exports === \"string\" || Array.isArray(exports)) {\n          return true;\n        }\n        if (typeof exports !== \"object\" || exports === null) {\n          return false;\n        }\n\n        const keys = Object.getOwnPropertyNames(exports);\n        let isConditionalSugar = false;\n\n        for (let i = 0; i < keys.length; i++) {\n          const key = keys[i]!;\n          const currentIsConditionalSugar = key === \"\" || key[0] !== \".\";\n          if (i === 0) {\n            isConditionalSugar = currentIsConditionalSugar;\n          } else if (isConditionalSugar !== currentIsConditionalSugar) {\n            throw new Error(\n              '\"exports\" cannot contain some keys starting with \\\\'.\\\\' and some not.'\n            );\n          }\n        }\n\n        return isConditionalSugar;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"resolvePackageTarget\"\n        parameters={[\n          { name: \"packageJsonUrl\", type: \"URL\" },\n          { name: \"target\", type: \"unknown\" },\n          { name: \"subpath\", type: \"string\" },\n          { name: \"packageSubpath\", type: \"string\" },\n          { name: \"base\", type: \"URL\" },\n          { name: \"pattern\", type: \"boolean\" },\n          { name: \"internal\", type: \"boolean\" },\n          { name: \"conditions\", type: \"Set<string>\" }\n        ]}\n        returnType=\"URL | null | undefined\">\n        {code`if (typeof target === \"string\") {\n          if (!target.startsWith(\"./\")) {\n            if (internal && !target.startsWith(\"../\") && !target.startsWith(\"/\")) {\n              let isURL = false;\n              try {\n                new URL(target);\n                isURL = true;\n              } catch {}\n\n              if (!isURL) {\n                const exportTarget = pattern\n                  ? target.replace(/\\\\*/g, () => subpath)\n                  : target + subpath;\n                return packageResolve(exportTarget, packageJsonUrl, conditions);\n              }\n            }\n            return null;\n          }\n\n          const resolved = new URL(target, packageJsonUrl);\n          const resolvedPath = resolved.pathname;\n          const packagePath = new URL(\".\", packageJsonUrl).pathname;\n\n          if (!resolvedPath.startsWith(packagePath)) {\n            return null;\n          }\n\n          if (subpath === \"\") {\n            return resolved;\n          }\n\n          if (pattern) {\n            return new URL(resolved.href.replace(/\\\\*/g, () => subpath));\n          }\n\n          return new URL(subpath, resolved);\n        }\n\n        if (Array.isArray(target)) {\n          if (target.length === 0) {\n            return null;\n          }\n\n          let lastException: Error | null | undefined;\n          for (const targetItem of target) {\n            let resolveResult: URL | null | undefined;\n            try {\n              resolveResult = resolvePackageTarget(\n                packageJsonUrl, targetItem, subpath, packageSubpath,\n                base, pattern, internal, conditions\n              );\n            } catch (error: any) {\n              lastException = error;\n              if (error?.code === \"ERR_INVALID_PACKAGE_TARGET\") {\n                continue;\n              }\n              throw error;\n            }\n\n            if (resolveResult === undefined) {\n              continue;\n            }\n            if (resolveResult === null) {\n              lastException = null;\n              continue;\n            }\n            return resolveResult;\n          }\n\n          if (lastException === undefined || lastException === null) {\n            return null;\n          }\n          throw lastException;\n        }\n\n        if (typeof target === \"object\" && target !== null) {\n          const keys = Object.getOwnPropertyNames(target);\n          for (const key of keys) {\n            if (key === \"default\" || conditions.has(key)) {\n              const conditionalTarget = (target as Record<string, unknown>)[key];\n              const resolveResult = resolvePackageTarget(\n                packageJsonUrl, conditionalTarget, subpath, packageSubpath,\n                base, pattern, internal, conditions\n              );\n              if (resolveResult === undefined) {\n                continue;\n              }\n              return resolveResult;\n            }\n          }\n          return null;\n        }\n\n        if (target === null) {\n          return null;\n        }\n\n        return null;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"packageExportsResolve\"\n        parameters={[\n          { name: \"packageJsonUrl\", type: \"URL\" },\n          { name: \"packageSubpath\", type: \"string\" },\n          { name: \"packageConfig\", type: \"PackageConfig\" },\n          { name: \"base\", type: \"URL\" },\n          { name: \"conditions\", type: \"Set<string>\" }\n        ]}\n        returnType=\"URL | null | undefined\">\n        {code`let exports = packageConfig.exports;\n        if (isConditionalExportsMainSugar(exports)) {\n          exports = { \".\": exports } as Record<string, unknown>;\n        }\n\n        if (\n          exports !== undefined &&\n          exports !== null &&\n          typeof exports === \"object\" &&\n          Object.prototype.hasOwnProperty.call(exports, packageSubpath) &&\n          !packageSubpath.includes(\"*\") &&\n          !packageSubpath.endsWith(\"/\")\n        ) {\n          const target = (exports as Record<string, unknown>)[packageSubpath];\n          const resolveResult = resolvePackageTarget(\n            packageJsonUrl, target, \"\", packageSubpath,\n            base, false, false, conditions\n          );\n          if (resolveResult === null || resolveResult === undefined) {\n            const err = new Error(\n              \\`Package subpath '\\${packageSubpath}' is not defined by \"exports\" in \\${fileURLToPath(packageJsonUrl)}\\`\n            );\n            (err as any).code = \"ERR_PACKAGE_PATH_NOT_EXPORTED\";\n            throw err;\n          }\n          return resolveResult;\n        }\n\n        let bestMatch = \"\";\n        let bestMatchSubpath = \"\";\n        const keys = exports ? Object.getOwnPropertyNames(exports) : [];\n\n        for (const key of keys) {\n          const patternIndex = key.indexOf(\"*\");\n          if (\n            patternIndex !== -1 &&\n            packageSubpath.startsWith(key.slice(0, patternIndex))\n          ) {\n            const patternTrailer = key.slice(patternIndex + 1);\n            if (\n              packageSubpath.length >= key.length &&\n              packageSubpath.endsWith(patternTrailer) &&\n              patternKeyCompare(bestMatch, key) === 1 &&\n              key.lastIndexOf(\"*\") === patternIndex\n            ) {\n              bestMatch = key;\n              bestMatchSubpath = packageSubpath.slice(\n                patternIndex,\n                packageSubpath.length - patternTrailer.length\n              );\n            }\n          }\n        }\n\n        if (bestMatch) {\n          const target = (exports as Record<string, unknown>)[bestMatch];\n          const resolveResult = resolvePackageTarget(\n            packageJsonUrl, target, bestMatchSubpath, bestMatch,\n            base, true, false, conditions\n          );\n          if (resolveResult === null || resolveResult === undefined) {\n            const err = new Error(\n              \\`Package subpath '\\${packageSubpath}' is not defined by \"exports\" in \\${fileURLToPath(packageJsonUrl)}\\`\n            );\n            (err as any).code = \"ERR_PACKAGE_PATH_NOT_EXPORTED\";\n            throw err;\n          }\n          return resolveResult;\n        }\n\n        const err = new Error(\n          \\`Package subpath '\\${packageSubpath}' is not defined by \"exports\" in \\${fileURLToPath(packageJsonUrl)}\\`\n        );\n        (err as any).code = \"ERR_PACKAGE_PATH_NOT_EXPORTED\";\n        throw err;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"patternKeyCompare\"\n        parameters={[\n          { name: \"a\", type: \"string\" },\n          { name: \"b\", type: \"string\" }\n        ]}\n        returnType=\"number\">\n        {code`const aPatternIndex = a.indexOf(\"*\");\n        const bPatternIndex = b.indexOf(\"*\");\n        const baseLengthA = aPatternIndex === -1 ? a.length : aPatternIndex + 1;\n        const baseLengthB = bPatternIndex === -1 ? b.length : bPatternIndex + 1;\n        if (baseLengthA > baseLengthB) return -1;\n        if (baseLengthB > baseLengthA) return 1;\n        if (aPatternIndex === -1) return 1;\n        if (bPatternIndex === -1) return -1;\n        if (a.length > b.length) return -1;\n        if (b.length > a.length) return 1;\n        return 0;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"legacyMainResolve\"\n        parameters={[\n          { name: \"packageJsonUrl\", type: \"URL\" },\n          { name: \"packageConfig\", type: \"PackageConfig\" }\n        ]}\n        returnType=\"URL | undefined\">\n        {code`let guess: URL | undefined;\n        const tries: string[] = [];\n\n        if (packageConfig.main !== undefined) {\n          tries.push(\n            \\`./\\${packageConfig.main}\\`,\n            \\`./\\${packageConfig.main}.js\\`,\n            \\`./\\${packageConfig.main}.json\\`,\n            \\`./\\${packageConfig.main}.node\\`,\n            \\`./\\${packageConfig.main}/index.js\\`,\n            \\`./\\${packageConfig.main}/index.json\\`,\n            \\`./\\${packageConfig.main}/index.node\\`\n          );\n        }\n\n        tries.push(\"./index.js\", \"./index.json\", \"./index.node\");\n\n        for (const entry of tries) {\n          guess = new URL(entry, packageJsonUrl);\n          try {\n            const s = statSync(fileURLToPath(guess));\n            if (s.isFile()) {\n              return guess;\n            }\n          } catch {}\n          guess = undefined;\n        }\n\n        return undefined;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"parsePackageName\"\n        parameters={[\n          { name: \"specifier\", type: \"string\" },\n          { name: \"base\", type: \"URL\" }\n        ]}\n        returnType=\"{ packageName: string; packageSubpath: string; isScoped: boolean }\">\n        {code`let separatorIndex = specifier.indexOf(\"/\");\n        let validPackageName = true;\n        let isScoped = false;\n\n        if (specifier[0] === \"@\") {\n          isScoped = true;\n          if (separatorIndex === -1 || specifier.length === 0) {\n            validPackageName = false;\n          } else {\n            separatorIndex = specifier.indexOf(\"/\", separatorIndex + 1);\n          }\n        }\n\n        const packageName = separatorIndex === -1\n          ? specifier\n          : specifier.slice(0, separatorIndex);\n\n        if (invalidPackageNameRegEx.exec(packageName) !== null) {\n          validPackageName = false;\n        }\n\n        if (!validPackageName) {\n          const err = new Error(\n            \\`Invalid module \\\\\\`\\${specifier}\\\\\\` is not a valid package name imported from \\${fileURLToPath(base)}\\`\n          );\n          (err as any).code = \"ERR_INVALID_MODULE_SPECIFIER\";\n          throw err;\n        }\n\n        const packageSubpath = \".\" + (separatorIndex === -1\n          ? \"\"\n          : specifier.slice(separatorIndex));\n\n        return { packageName, packageSubpath, isScoped };`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"packageResolve\"\n        parameters={[\n          { name: \"specifier\", type: \"string\" },\n          { name: \"base\", type: \"URL\" },\n          { name: \"conditions\", type: \"Set<string>\" }\n        ]}\n        returnType=\"URL\">\n        {code`if (builtinModules.includes(specifier)) {\n          return new URL(\"node:\" + specifier);\n        }\n\n        const { packageName, packageSubpath, isScoped } = parsePackageName(specifier, base);\n\n        // Self-resolution: check if the specifier matches the current package name\n        const selfConfig = getPackageScopeConfig(base);\n        if (\n          selfConfig.exists &&\n          selfConfig.name === packageName &&\n          selfConfig.exports !== undefined &&\n          selfConfig.exports !== null\n        ) {\n          const packageJsonUrl = pathToFileURL(selfConfig.pjsonPath);\n          const result = packageExportsResolve(\n            packageJsonUrl, packageSubpath, selfConfig, base, conditions\n          );\n          if (result) {\n            return result;\n          }\n        }\n\n        let packageJsonUrl = new URL(\n          \"./node_modules/\" + packageName + \"/package.json\",\n          base\n        );\n        let packageJsonPath = fileURLToPath(packageJsonUrl);\n        let lastPath: string;\n\n        do {\n          let stat: ReturnType<typeof statSync> | undefined;\n          try {\n            stat = statSync(packageJsonPath.slice(0, -13));\n          } catch {}\n\n          if (!stat || !stat.isDirectory()) {\n            lastPath = packageJsonPath;\n            packageJsonUrl = new URL(\n              (isScoped ? \"../../../../node_modules/\" : \"../../../node_modules/\") +\n                packageName +\n                \"/package.json\",\n              packageJsonUrl\n            );\n            packageJsonPath = fileURLToPath(packageJsonUrl);\n            continue;\n          }\n\n          const packageConfig = readPackageConfig(packageJsonPath);\n\n          if (packageConfig.exports !== undefined && packageConfig.exports !== null) {\n            const result = packageExportsResolve(\n              packageJsonUrl, packageSubpath, packageConfig, base, conditions\n            );\n            if (result) {\n              return result;\n            }\n          }\n\n          if (packageSubpath === \".\") {\n            const legacyResult = legacyMainResolve(packageJsonUrl, packageConfig);\n            if (legacyResult) {\n              return legacyResult;\n            }\n\n            return new URL(\".\", packageJsonUrl);\n          }\n\n          return new URL(packageSubpath, packageJsonUrl);\n        } while (packageJsonPath.length !== lastPath!.length);\n\n        const err = new Error(\\`Cannot find package \\\\\\`\\${packageName}\\\\\\`\\`);\n        (err as any).code = \"ERR_MODULE_NOT_FOUND\";\n\n        throw err;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"finalizeResolution\"\n        parameters={[\n          { name: \"resolved\", type: \"URL\" },\n          { name: \"base\", type: \"URL\" }\n        ]}\n        returnType=\"URL\">\n        {code`if (/%2f|%5c/i.test(resolved.pathname)) {\n          const err = new Error(\n            \\`Invalid module \\\\\\`\\${resolved.pathname}\\\\\\` must not include encoded \"/\" or \"\\\\\\\\\" characters imported from \\${fileURLToPath(base)}\\`\n          );\n          (err as any).code = \"ERR_INVALID_MODULE_SPECIFIER\";\n\n          throw err;\n        }\n\n        const filePath = fileURLToPath(resolved);\n\n        let stat: ReturnType<typeof statSync> | undefined;\n        try {\n          stat = statSync(filePath.endsWith(\"/\") ? filePath.slice(0, -1) : filePath);\n        } catch {}\n\n        if (stat && stat.isDirectory()) {\n          const err = new Error(\n            \\`Directory import \\\\\\`\\${filePath}\\\\\\` is not supported resolving ES modules imported from \\${fileURLToPath(base)}\\`\n          );\n          (err as any).code = \"ERR_UNSUPPORTED_DIR_IMPORT\";\n          throw err;\n        }\n\n        if (!stat || !stat.isFile()) {\n          const err = new Error(\n            \\`Cannot find module \\\\\\`\\${filePath}\\\\\\` imported from \\${fileURLToPath(base)}\\`\n          );\n          (err as any).code = \"ERR_MODULE_NOT_FOUND\";\n          throw err;\n        }\n\n        const real = realpathSync(filePath);\n        const { search, hash } = resolved;\n        const realUrl = pathToFileURL(real + (filePath.endsWith(sep) ? \"/\" : \"\"));\n        realUrl.search = search;\n        realUrl.hash = hash;\n\n        return realUrl;`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"moduleResolve\"\n        parameters={[\n          { name: \"specifier\", type: \"string\" },\n          { name: \"base\", type: \"URL\" },\n          { name: \"conditions\", type: \"Set<string>\" }\n        ]}\n        returnType=\"URL\">\n        {code`let resolved: URL | undefined;\n\n        if (\n          specifier[0] === \"/\" ||\n          (specifier[0] === \".\" &&\n            (specifier.length === 1 ||\n              specifier[1] === \"/\" ||\n              (specifier[1] === \".\" && (specifier.length === 2 || specifier[2] === \"/\"))))\n        ) {\n          try {\n            resolved = new URL(specifier, base);\n          } catch (error_: any) {\n            const err = new Error(\n              \\`Failed to resolve module specifier \\\\\\`\\${specifier}\\\\\\` from \"\\${base}\": Invalid relative URL or base scheme is not hierarchical.\\`\n            );\n            err.cause = error_;\n            throw err;\n          }\n        } else if (base.protocol === \"file:\" && specifier[0] === \"#\") {\n          const packageConfig = getPackageScopeConfig(base);\n          if (packageConfig.exists && packageConfig.imports) {\n            const packageJsonUrl = pathToFileURL(packageConfig.pjsonPath);\n            const imports = packageConfig.imports;\n            if (Object.prototype.hasOwnProperty.call(imports, specifier) && !specifier.includes(\"*\")) {\n              const resolveResult = resolvePackageTarget(\n                packageJsonUrl, imports[specifier], \"\", specifier,\n                base, false, true, conditions\n              );\n              if (resolveResult !== null && resolveResult !== undefined) {\n                resolved = resolveResult;\n              }\n            }\n\n            if (!resolved) {\n              let bestMatch = \"\";\n              let bestMatchSubpath = \"\";\n              const keys = Object.getOwnPropertyNames(imports);\n\n              for (const key of keys) {\n                const patternIndex = key.indexOf(\"*\");\n                if (patternIndex !== -1 && specifier.startsWith(key.slice(0, -1))) {\n                  const patternTrailer = key.slice(patternIndex + 1);\n                  if (\n                    specifier.length >= key.length &&\n                    specifier.endsWith(patternTrailer) &&\n                    patternKeyCompare(bestMatch, key) === 1 &&\n                    key.lastIndexOf(\"*\") === patternIndex\n                  ) {\n                    bestMatch = key;\n                    bestMatchSubpath = specifier.slice(\n                      patternIndex,\n                      specifier.length - patternTrailer.length\n                    );\n                  }\n                }\n              }\n\n              if (bestMatch) {\n                const target = imports[bestMatch];\n                const resolveResult = resolvePackageTarget(\n                  packageJsonUrl, target, bestMatchSubpath, bestMatch,\n                  base, true, true, conditions\n                );\n                if (resolveResult !== null && resolveResult !== undefined) {\n                  resolved = resolveResult;\n                }\n              }\n            }\n          }\n\n          if (!resolved) {\n            const err = new Error(\n              \\`Package import specifier \\\\\\`\\${specifier}\\\\\\` is not defined in package imported from \\${fileURLToPath(base)}\\`\n            );\n            (err as any).code = \"ERR_PACKAGE_IMPORT_NOT_DEFINED\";\n            throw err;\n          }\n        } else {\n          try {\n            resolved = new URL(specifier);\n          } catch {\n            resolved = packageResolve(specifier, base, conditions);\n          }\n        }\n\n        if (resolved.protocol !== \"file:\") {\n          return resolved;\n        }\n\n        return finalizeResolution(resolved, base);`}\n      </FunctionDeclaration>\n      <Spacing />\n      <FunctionDeclaration\n        name=\"tryModuleResolve\"\n        parameters={[\n          { name: \"id\", type: \"string\" },\n          { name: \"url\", type: \"URL\" },\n          { name: \"conditions\", type: \"Set<string>\" }\n        ]}\n        returnType=\"URL | undefined\">\n        {code`try {\n          return moduleResolve(id, url, conditions);\n        } catch (error: any) {\n          if (\n            !(error as { code: string })?.code &&\n            ![\n              \"ERR_MODULE_NOT_FOUND\",\n              \"ERR_UNSUPPORTED_DIR_IMPORT\",\n              \"MODULE_NOT_FOUND\",\n              \"ERR_PACKAGE_PATH_NOT_EXPORTED\"\n            ].includes(error?.code)\n          ) {\n            throw error;\n          }\n        }`}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"A function to resolve module specifiers to URLs.\">\n        <TSDocParam name=\"specifier\">{`The module specifier to resolve.`}</TSDocParam>\n        <TSDocParam name=\"options\">\n          {`The options for resolving the module. Defaults to an empty object.`}\n        </TSDocParam>\n        <TSDocReturns>{`The result of the resolve operation.`}</TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        async\n        export\n        name=\"resolveModule\"\n        parameters={[\n          { name: \"specifier\", type: \"string\" },\n          {\n            name: \"options\",\n            type: \"ResolveModuleOptions\",\n            default: \"{} as ResolveModuleOptions\"\n          }\n        ]}\n        returnType=\"Promise<string>\">\n        {code`const parentURL = options.parentURL ? new URL(options.parentURL) : undefined;\n        const conditionsSet = options.conditions?.length\n          ? new Set(options.conditions)\n          : DEFAULT_CONDITIONS_SET;\n\n        // Handle protocol-prefixed specifiers (node:, data:, http:, https:, ${context.config.framework}:)\n        if (/^(?:node|data|https?|${context.config.framework}):/.test(specifier)) {\n          return specifier;\n        }\n\n        const bareSpecifier = specifier.replace(/^node:/, \"\");\n        if (builtinModules.includes(bareSpecifier)) {\n          return \"node:\" + bareSpecifier;\n        }\n\n        if (specifier.startsWith(\"file://\")) {\n          return specifier;\n        }\n\n        if (isAbsolute(specifier)) {\n          try {\n            const s = statSync(specifier);\n            if (s.isFile()) {\n              return pathToFileURL(realpathSync(specifier)).href;\n            }\n          } catch (err: any) {\n            if (err?.code !== \"ENOENT\") {\n              throw err;\n            }\n          }\n        }\n\n        const roots = [parentURL ?? pathToFileURL(join(process.cwd(), \"_\"))];\n\n        const projectRootURL = pathToFileURL(\"${context.config.root}\");\n        if (!roots.some(root => root.href === projectRootURL.href)) {\n          roots.push(projectRootURL);\n        }\n\n        const workspaceRootURL = pathToFileURL(\"${\n          context.workspaceConfig.workspaceRoot\n        }\");\n        if (!roots.some(root => root.href === workspaceRootURL.href)) {\n          roots.push(workspaceRootURL);\n        }\n\n        let resolved: URL | undefined;\n        for (const root of roots) {\n          const _urls: URL[] = [];\n          _urls.push(root);\n          if (root.protocol === \"file:\") {\n            _urls.push(\n              new URL(\"./\", root),\n              new URL(join(root.pathname, \"_index.js\"), root),\n              new URL(\"node_modules\", root)\n            );\n          }\n\n          for (const url of _urls) {\n            resolved = tryModuleResolve(specifier, url, conditionsSet);\n            if (resolved) {\n              break;\n            }\n\n            for (const prefix of [\"\", \"/index\"]) {\n              for (const extension of DEFAULT_EXTENSIONS) {\n                resolved = tryModuleResolve(\n                  specifier + prefix + extension,\n                  url,\n                  conditionsSet\n                );\n                if (resolved) {\n                  break;\n                }\n              }\n              if (resolved) {\n                break;\n              }\n            }\n            if (resolved) {\n              break;\n            }\n          }\n\n          if (resolved) {\n            break;\n          }\n        }\n\n        if (!resolved) {\n          const err = new Error(\n            \\`Cannot find module \\\\\\`\\${specifier}\\\\\\`\\`\n          );\n          (err as any).code = \"ERR_MODULE_NOT_FOUND\";\n\n          throw err;\n        }\n\n        return pathToFileURL(fileURLToPath(resolved)).href;\n        `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * A built-in utilities module for Shell Shock.\n */\nexport function UtilsBuiltin(props: UtilsBuiltinProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <BuiltinFile\n      id=\"utils\"\n      description=\"A collection of helper utilities that ease command-line application development.\"\n      {...rest}\n      imports={defu(rest.imports ?? {}, {\n        \"node:os\": \"os\",\n        \"node:process\": \"process\",\n        \"node:path\": [\n          \"resolve\",\n          \"delimiter\",\n          \"normalize\",\n          \"join\",\n          \"posix\",\n          \"sep\",\n          \"dirname\",\n          \"isAbsolute\"\n        ],\n        \"node:fs\": [\n          { name: \"constants\", alias: \"fsConstants\" },\n          \"openSync\",\n          \"closeSync\",\n          \"read\",\n          \"readFileSync\",\n          \"statSync\",\n          \"realpathSync\"\n        ],\n        \"node:fs/promises\": [\"stat\"],\n        \"node:tty\": [\"WriteStream\"],\n        \"node:util\": [\"promisify\"],\n        \"node:url\": [\"fileURLToPath\", \"pathToFileURL\"],\n        \"node:module\": [\"builtinModules\"]\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\n          \"env\",\n          \"isCI\",\n          \"isTest\",\n          \"isWindows\",\n          \"isLinux\",\n          \"isMacOS\",\n          \"isDevelopment\",\n          \"isDebug\"\n        ],\n        exec: [\"execSync\"],\n        state: [\"hasFlag\"]\n      })}>\n      <TSDoc heading=\"A utility function to pause execution for a specified duration, which can be used in prompt interactions to create delays or timeouts. The function returns a promise that resolves after the specified duration in milliseconds, allowing it to be used with async/await syntax for easier handling of asynchronous prompt logic.\">\n        <TSDocParam name=\"durationMs\">\n          {`The duration to sleep in milliseconds.`}\n        </TSDocParam>\n        <TSDocReturns>\n          {`A promise that resolves after the specified duration, allowing for asynchronous delays in prompt interactions.`}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"sleep\"\n        parameters={[{ name: \"durationMs\", type: \"number\" }]}\n        returnType=\"Promise<void>\">{code`return new Promise((resolve) => setTimeout(resolve, durationMs)); `}</FunctionDeclaration>\n      <Spacing />\n      <TerminalSizeDeclaration />\n      <Spacing />\n      <EnvSupportUtilities />\n      <Spacing />\n      <HyperlinkSupportUtilities />\n      <Spacing />\n      <ColorSupportUtilities />\n      <Spacing />\n      <ResolveModuleFunctionDeclaration />\n      <Spacing />\n      <FindSuggestionsDeclaration />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"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"}

package/dist/config.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * A utility function to define a Shell Shock user configuration.\n *\n * @remarks\n * This function is used to create a user configuration object for Shell Shock projects. It ensures that the configuration adheres to the expected structure.\n *\n * @param config - A partial user configuration object.\n * @returns A complete user configuration object.\n */\nexport function defineConfig(config: Partial<UserConfig>): UserConfig {\n  return config as UserConfig;\n}\n"],"mappings":";;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;;;;AAU/D,SAAgB,aAAW,QAAQ;AAClC,QAAA"}

package/dist/contexts/command.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"command.cjs","names":[],"sources":["../../src/contexts/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport type { CommandTree } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const CommandContext: ComponentContext<CommandTree | undefined> =\n  createNamedContext<CommandTree | undefined>(\"Command\");\n\n/**\n * Hook to access the Command context.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useCommand() {\n  return useContext<CommandTree | undefined>(CommandContext)!;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA4BE,QAAA,0BAAA,IAAA,CAAA,CAAA,eAAA,UAAA,CAAA,iCAAA,eAAA;;AAEF,WAAC,SAAA,CAAA,cAAA,QAAA"}

package/dist/contexts/options.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"options.cjs","names":[],"sources":["../../src/contexts/options.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ComponentContext } from \"@alloy-js/core\";\nimport { createNamedContext, useContext } from \"@alloy-js/core\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport type { BooleanCommandOption, CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * The reflection parameter context used in template rendering.\n */\nexport const ExistingOptionsContext: ComponentContext<string[]> =\n  createNamedContext<string[]>(\"ExistingOptions\", []);\n\n/**\n * Hook to access the ExistingOptions context.\n *\n * @remarks\n * This context provides a list of option names that already exist on the interface definition.\n *\n * @returns A reactive version of the current reflection.\n */\nexport function useExistingOptions() {\n  return useContext<string[]>(ExistingOptionsContext)!;\n}\n\nexport function computedOptions(options: CommandOption[]) {\n  return options.reduce(\n    (ret, option) => {\n      ret[camelCase(option.name)] ??= defu(\n        {\n          name: camelCase(option.name)\n        },\n        ret[option.name] ?? {},\n        option\n      ) as CommandOption;\n\n      if (\n        option.kind === CommandParameterKinds.boolean &&\n        option.isNegativeOf\n      ) {\n        ret[camelCase(option.isNegativeOf)] = defu(\n          {\n            name: camelCase(option.isNegativeOf)\n          },\n          ret[option.isNegativeOf] ?? {},\n          {\n            ...option,\n            env: isSetString(option.env) ? `NO_${option.env}` : false,\n            description: `${option.description.replace(\n              /\\.+$/,\n              \"\"\n            )}. This property is the negative form of ${option.name}.`,\n            isNegativeOf: camelCase(option.name),\n            default: !option.default\n          }\n        ) as BooleanCommandOption;\n      }\n\n      return ret;\n    },\n    {} as Record<string, CommandOption>\n  );\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;AAUX,MAAa,0BAAsB,kCAAkB,IAAA,CAAA,CAAA,KAAA,CAAA,yCAAA,mBAAA,EAAA,CAAA;;;;;;;;;AASrD,SAAS,qBAA4B;AACrC,QAAY,0BAAW,IAAA,CAAA,CAAA,KAAA,CAAA,iCAAA,uBAAA;;AAEvB,mBAAS,SAAA,CAAA,sBAAuC,QAAQ;;AAEtD,QAAA,QAAA,OAAA,cAAA,KAAA,WAAA;AACK,sDAAW,OAAU,KAAA,wBAAgB,EAC1C,sDAAA,OAAA,KAAA,EACK,EAAA,IAAM,OAAA,SAAA,EAAA,EAAsB,OAAE;AACnC,MAAA,OAAA,SAA0B,4CAAsB,+BAEhD,qDAAA,OAAA,aAAA,sBAAA,EACS,sDAAW,OAAgB,aAAO,EAC5C,EAAA,IAAA,OAAA,iBAAA,EAAA,EAAA;GACG,GAAA;GACY,wDAAgB,OAAG,IAAO,GAAK,MAAM,OAAO,QAAO;GAClE,aAAA,GAAA,OAAA,YAAA,QAAA,QAAA,GAAA,CAAA,0CAAA,OAAA,KAAA;GACa,8DAAwB,OAAQ,KAAA;GAC5C,SAAA,CAAA,OAAA;GACK,CAAA;AAEP,SAAA;;;;;;;;AAGA,gBAAgB,SAAO;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/automd.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"automd.cjs","names":[],"sources":["../../src/helpers/automd.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 } from \"@alloy-js/core\";\nimport { For, Show } from \"@alloy-js/core/components\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { renderString } from \"@powerlines/plugin-alloy/render\";\nimport { defineGenerator } from \"automd\";\nimport { CommandDocs } from \"../components/docs\";\nimport { getAppTitle } from \"../plugin-utils\";\nimport type { Context } from \"../types/context\";\n\n/**\n * AutoMD generator to generate CLI command documentation\n *\n * @see https://automd.unjs.io/\n *\n * @param context - The generator context.\n * @returns The generated documentation content.\n */\nexport const commands = (context: Context) =>\n  defineGenerator({\n    name: \"commands\",\n    async generate() {\n      return {\n        contents: renderString(\n          context,\n          <>\n            <Heading level={2}>Commands</Heading>\n            <Spacing />\n            {code`The following commands are available in the ${getAppTitle(\n              context,\n              true\n            )} command-line interface application:`}\n            <Spacing />\n            <For each={Object.values(context.commands)} doubleHardline>\n              {child => (\n                <Show when={!child.isVirtual}>\n                  <CommandDocs command={child} levelOffset={2} />\n                </Show>\n              )}\n            </For>\n            <Spacing />\n          </>\n        )\n      };\n    }\n  });\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqCA,MAAE,YAAgB,wCAAA;CAChB,MAAM;CACN,MAAE,WAAe;AACf,SAAE,EACA,4DAAY,SAAY;mDAAA,4BAAA;IACtB,OAAE;IACF,UAAG;IACJ,CAAC;mDAAoB,0DAAG,EAAQ,CAAC;8CAAQ,mBAAA,+CAAA,oCAAA,SAAA,KAAA,CAAA,sCAAA;mDAAA,0DAAA,EAAA,CAAA;mDAAA,+BAAA;IACxC,IAAI,OAAC;AACH,YAAO,OAAK,OAAS,QAAC,SAAa;;IAErC,gBAAM;IACN,WAAO,0DAAuB,gCAAa;KACzC,IAAG,OAAQ;AACT,aAAK,CAAA,MAAM;;KAEb,IAAI,WAAQ;AACV,6DAAmB,qCAAgB;OACjC,SAAQ;OACR,aAAC;OACF,CAAC;;KAEL,CAAC;IACH,CAAC;mDAAA,0DAAA,EAAA,CAAA;GAAA,CAAA,EACH;;CAEJ,CAAC"}

package/dist/helpers/docs-helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"docs-helpers.cjs","names":[],"sources":["../../src/helpers/docs-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { joinPaths } from \"@stryke/path/join\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Gets the output path for the generated documentation.\n *\n * @param context - The Shell Shock context.\n * @returns The output path for the generated documentation.\n */\nexport function getDocsOutputPath(context: Context): string {\n  return joinPaths(context.config.root, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAU,kBAAoB,SAAa;AACvC,yCAAY,QAAY,OAAQ,MAAA,QAAU,YAAa;;AAE3D,kBAAgB,SAAA;CAAA;CAAkB;CAAgB;CAAU;CAAA"}

package/dist/helpers/paths.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.cjs","names":[],"sources":["../../src/helpers/paths.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 { listFiles } from \"@stryke/fs/list-files\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { commonPath } from \"@stryke/path/common\";\nimport { findFilePath, findFolderName } from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { existsSync } from \"node:fs\";\nimport { isTypeDefinition } from \"powerlines/utils\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"../plugin-utils/context-helpers\";\nimport type { Context } from \"../types/context\";\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 async function findCommandsRoot(context: Context): Promise<string> {\n  let paths = [] as string[];\n  if (isSetString(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (isTypeDefinition(context.config.input)) {\n    paths = await listFiles(\n      appendPath(\n        appendPath(context.config.input.file, context.config.root),\n        context.workspaceConfig.workspaceRoot\n      )\n    );\n  } else if (\n    Array.isArray(context.config.input) &&\n    context.config.input.length > 0\n  ) {\n    paths = (\n      await Promise.all(\n        context.config.input.map(async input =>\n          listFiles(\n            appendPath(\n              appendPath(\n                isSetString(input) ? input : input.file,\n                context.config.root\n              ),\n              context.workspaceConfig.workspaceRoot\n            )\n          )\n        )\n      )\n    ).flat();\n  } else if (isSetObject(context.config.input)) {\n    paths = (\n      await Promise.all(\n        Object.values(context.config.input).map(async input =>\n          Array.isArray(input)\n            ? (\n                await Promise.all(\n                  input.map(async i =>\n                    listFiles(\n                      appendPath(\n                        appendPath(\n                          isSetString(i) ? i : i.file,\n                          context.config.root\n                        ),\n                        context.workspaceConfig.workspaceRoot\n                      )\n                    )\n                  )\n                )\n              ).flat()\n            : listFiles(\n                appendPath(\n                  appendPath(\n                    isSetString(input) ? input : input.file,\n                    context.config.root\n                  ),\n                  context.workspaceConfig.workspaceRoot\n                )\n              )\n        )\n      )\n    ).flat();\n  }\n\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  let commandsPath = joinPaths(context.config.root, \"src/commands\");\n  if (!existsSync(commandsPath)) {\n    commandsPath = joinPaths(context.config.root, \"commands\");\n    if (!existsSync(commandsPath)) {\n      commandsPath = joinPaths(context.config.root, \"src\");\n      if (!existsSync(commandsPath)) {\n        commandsPath = context.config.root;\n      }\n    }\n  }\n\n  paths = (\n    await Promise.all([\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.ts\"\n        )\n      ),\n      listFiles(\n        joinPaths(\n          appendPath(commandsPath, context.workspaceConfig.workspaceRoot),\n          \"**/command.tsx\"\n        )\n      )\n    ])\n  ).flat();\n  if (paths.length > 0) {\n    return commonPath(paths.map(p => findFilePath(p)));\n  }\n\n  return appendPath(commandsPath, context.workspaceConfig.workspaceRoot);\n}\n"],"mappings":"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"}

package/dist/helpers/persistence.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"persistence.cjs","names":[],"sources":["../../src/helpers/persistence.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 { joinPaths } from \"@stryke/path/join-paths\";\nimport type { CommandTree, SerializedCommandTree } from \"../types\";\nimport type { Context } from \"../types/context\";\n\nfunction serialize(command: CommandTree): SerializedCommandTree {\n  return {\n    ...command,\n    parent: command.parent?.name ? command.parent.name : null,\n    children: Object.fromEntries(\n      Object.entries(command.children || {}).map(([name, child]) => [\n        name,\n        serialize(child)\n      ])\n    )\n  };\n}\n\nfunction deserialize(\n  command: SerializedCommandTree,\n  parent: CommandTree | null = null\n): CommandTree {\n  const result: CommandTree = {\n    ...command,\n    parent: parent ?? null,\n    children: {}\n  };\n\n  result.children = Object.fromEntries(\n    Object.entries(command.children || {}).map(([name, child]) => [\n      name,\n      deserialize(child, result)\n    ])\n  );\n\n  return result;\n}\n\n/**\n * Gets the file path for persisting CLI command reflections.\n *\n * @param context - The Shell Shock context.\n * @returns The file path for persisting CLI command reflections.\n */\nexport function getCommandsPersistencePath(context: Context): string {\n  return joinPaths(context.dataPath, \"reflections\", \"commands.json\");\n}\n\n/**\n * Reads the persisted CLI command reflections from the file system and populates the context's commands.\n *\n * @param context - The Shell Shock context.\n * @throws Will throw an error if the reflections file is empty or cannot be read.\n */\nexport async function readCommandsPersistence(context: Context) {\n  const reflections = await context.fs.read(\n    getCommandsPersistencePath(context)\n  );\n  if (!reflections || !reflections.length) {\n    throw new Error(\n      `CLI Command reflection file ${getCommandsPersistencePath(context)} is empty`\n    );\n  }\n\n  context.commands = Object.fromEntries(\n    Object.entries(\n      (JSON.parse(reflections) ?? {}) as Record<string, SerializedCommandTree>\n    ).map(([name, command]) => [name, deserialize(command)])\n  );\n}\n\n/**\n * Writes the current CLI command reflections from the context to the file system for persistence.\n *\n * @param context - The Shell Shock context.\n * @returns A promise that resolves when the reflections have been successfully written to the file system.\n * @throws Will throw an error if there is an issue writing the reflections to the file system.\n */\nexport async function writeCommandsPersistence(context: Context) {\n  const filePath = getCommandsPersistencePath(context);\n\n  await context.fs.write(\n    filePath,\n    JSON.stringify(\n      Object.fromEntries(\n        Object.entries(context.commands).map(([name, command]) => [\n          name,\n          serialize(command)\n        ])\n      ),\n      null,\n      context.config.mode === \"production\" ? 0 : 2\n    )\n  );\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AAoBX,SAAS,UAAU,SAAS;AAC1B,QAAO;EACF,GAAA;EACH,QAAQ,QAAQ,QAAY,OAAG,QAAQ,OAAW,OAAO;EACzD,UAAU,OAAO,YAAW,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACpB,MACA,UAAA,MAAA,CACJ,EAAA;GAAA;GAAU;GAAK;GAAA,CAAA,CAAA,CAAA;EAClB;;AAEL,UAAG,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACH,SAAA,YAAA,SAAA,SAAA,MAAA;;EAEQ,GAAC;EACP,QAAS,UAAA;EACH,UAAE,EAAA;EACP;AACD,QAAM,WAAQ,OAAa,YAAC,OAAA,QAAA,QAAA,YAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,WAAA,CACvB,MACH,YAAgB,OAAM,OAAA,CACtB,EAAA;EAAA;EAAW;EAAA;EAAA,CAAA,CAAA,CAAA;AACZ,QAAA;;AAEH,YAAS,SAAW;CAAA;CAAkB;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAOtC,SAAe,2BAAA,SAAA;AACf,+CAAA,QAAA,UAAA,eAAA,gBAAA;;AAEA,2BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,eAAmB,wBAAmB,SAAe;CACrD,MAAA,cAAA,MAAA,QAAA,GAAA,KAAA,2BAAA,QAAA,CAAA;yCAEE,OAAA,IAAA,MAAA,+BAAA,2BAAA,QAAA,CAAA,WAAA;AAED,SAAA,WAAA,OAAA,YAAA,OAAA,QAAA,KAAA,MAAA,YAAA,IAAA,EAAA,CAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,CAAA,MAAA,YAAA,QAAA,CAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAED,wBAAwB,SAAS;CAAC;CAAI;CAAiB;CAA0B;CAAA;;;;;;;;AAQjF,eAAmB,yBAAkB,SAAA;CACjC,MAAC,WAAA,2BAAA,QAAA;AACH,OAAA,QAAA,GAAA,MAAA,UAAA,KAAA,UAAA,OAAA,YAAA,OAAA,QAAA,QAAA,SAAA,CAAA,IAAA,cAAA,CAAA,MAAA,aAAA,OAEA,UAAgB,QAAG,CACjB,EAAA;EAAA;EAAc;EAAA;EAAA,CAAA,CAAA,CAAA,EAAA,MAAA,QAAA,OAAA,SAAA,eAAA,IAAA,EAAA,CAAA;;AAElB,yBAAyB,SAAO;CAAA;CAAM;CAAmB;CAAE;CAAA"}

package/dist/helpers/update-package-json.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"update-package-json.cjs","names":[],"sources":["../../src/helpers/update-package-json.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getAppName } from \"../plugin-utils/context-helpers\";\nimport type { UnresolvedContext } from \"../types/context\";\n\nexport function formatBinaryPath(\n  format: string | string[] | undefined\n): string {\n  return `./dist/bin.${\n    format === \"cjs\" || (Array.isArray(format) && format.includes(\"cjs\"))\n      ? \"cjs\"\n      : \"mjs\"\n  }`;\n}\n\nexport async function updatePackageJsonBinary(\n  context: UnresolvedContext\n): Promise<void> {\n  const packageJsonPath = joinPaths(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    \"package.json\"\n  );\n  if (\n    context.config.bin &&\n    Array.isArray(context.config.bin) &&\n    context.config.bin.length > 0\n  ) {\n    context.packageJson.bin = Object.fromEntries(\n      getUnique(toArray(context.config.bin)).map(bin => [\n        bin,\n        formatBinaryPath(context.config.output.format)\n      ])\n    );\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  } else {\n    if (\n      Array.isArray(context.config.output.format) &&\n      context.config.output.format.length > 1\n    ) {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          toArray(context.config.output.format)[0]\n        )\n      };\n      context.packageJson.bin = toArray(context.config.output.format).reduce(\n        (ret, format) => {\n          ret[`${kebabCase(getAppName(context))}-${format}`] =\n            formatBinaryPath(format);\n\n          return ret;\n        },\n        context.packageJson.bin\n      );\n    } else {\n      context.packageJson.bin = {\n        [kebabCase(getAppName(context))]: formatBinaryPath(\n          context.config.output.format\n        )\n      };\n    }\n\n    await context.fs.write(\n      packageJsonPath,\n      StormJSON.stringify(context.packageJson)\n    );\n  }\n\n  if (!isSetObject(context.packageJson.bin)) {\n    throw new Error(\n      \"Unable to determine the CLI binary name. Please specify the `bin` option in your Shell Shock configuration or ensure that the `name` field is set in your package.json.\"\n    );\n  }\n\n  context.config.bin = Object.keys(context.packageJson.bin);\n}\n"],"mappings":";;;;;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;AA0BX,SAAgB,iBAAc,QAAA;AAC3B,QAAO,cAAA,WAAA,SAAA,MAAA,QAAA,OAAA,IAAA,OAAA,SAAA,MAAA,GACA,QACA;;AAEV,iBAAY,SAAA;CAAA;CAAA;CAAA;CAAA;AACZ,eAAI,wBAAA,SAAA;CACJ,MAAA,yDAAA,QAAA,gBAAA,eAAA,QAAA,OAAA,MAAA,eAAA;2BAEO,MAAM,QAAS,QAAA,OAAA,IAAA,IACpB,QAAS,OAAA,IAAA,SAAA,GAAA;AACR,UAAa,YAAC,MAAA,OAAA,4FAAA,QAAA,OAAA,IAAA,CAAA,CAAA,IAAA,cAAA,QAAA,CACT,KACI,iBAAgB,QAAA,OAAa,OAAA,OAAA,CACrC,EAAO;GAAC;GAAO;GAAI;GAAA,CAAA,CAAA,CAAA;AAClB,QAAQ,QAAI,GAAA,MAAA,iBAAA,kCAAA,UAAA,QAAA,YAAA,CAAA;QAEZ;AACD,MAAQ,MAAM,QAAM,QAAA,OAAA,OAAA,OAAA,IACd,QAAQ,OAAQ,OAAO,OAAM,SAAA,GAAA;AAC3B,WAAO,YAAa,MAAA,mDAC5B,mCAAA,QAAA,CAAA,GAAA,uDAAA,QAAA,OAAA,OAAA,OAAA,CAAA,GAAA,EACQ;AACN,WAAU,YAAgB,4CAAa,QAAS,OAAE,OAAA,OAAA,CAAA,OAAA,cAAA,KAAA,WAAA;AAC7C,QAAA,mDAAA,mCAAA,QAAA,CAAA,CAAA,GAAA,YACH,iBAAyB,OAAO;AACjC,WAAA;MACF;IAAA;IAAA;IAAA;IAAA;IAAA,CAAA,EAAA,QAAA,YAAA,IAAA;QAGC,SAAA,YAAe,MAAA,mDACK,mCAAQ,QAAW,CAAA,GAAA,iBAAA,QAAA,OAAA,OAAA,OAAA,EACxC;AAEE,QAAA,QAAA,GAAA,MAAA,iBAAA,kCAAA,UAAA,QAAA,YAAA,CAAA;;AAEH,KAAE,oDAAe,QAAO,YAAa,IAAG,CACtC,OAAA,IAAA,MAAA,0KAAA;AAEF,SAAK,OAAU,MAAA,OAAW,KAAO,QAAK,YAAA,IAAgB;;AAE1D,wBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/utilities.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"utilities.cjs","names":[],"sources":["../../src/helpers/utilities.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { TreeItem } from \"@stryke/cli/utils/tree\";\nimport { formatTree } from \"@stryke/cli/utils/tree\";\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport type { CommandBase, CommandOption, CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\nfunction innerFormatCommandTree(command: CommandTree): TreeItem {\n  return {\n    name: `${command.name}${command.isVirtual ? \" (virtual)\" : \"\"}`,\n    children: Object.values(command.children ?? {}).map(innerFormatCommandTree)\n  };\n}\n\nexport function formatCommandTree(context: Context): string {\n  return formatTree({\n    name: context.config.name,\n    children: Object.values(context.commands ?? {}).map(innerFormatCommandTree)\n  });\n}\n\n/**\n * Retrieves the global command options based on the context configuration.\n *\n * @param context - The build context.\n * @param command - The command for which to retrieve global options.\n * @returns A record of global command options.\n */\nexport function getGlobalOptions(\n  context: Context,\n  command: CommandBase\n): Record<string, CommandOption> {\n  let options!: Record<string, CommandOption>;\n  if (Array.isArray(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions,\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else if (isFunction(context.config.globalOptions)) {\n    options = Object.fromEntries(\n      getUniqueBy(\n        context.config.globalOptions(context, command),\n        (item: CommandOption) => item.name\n      ).map(option => [option.name, option])\n    );\n  } else {\n    options = {};\n  }\n\n  return Object.fromEntries(\n    Object.entries(options).map(([key, value]) => [\n      key,\n      { ...value, env: value.env ?? constantCase(key) }\n    ])\n  );\n}\n"],"mappings":";;;;;;;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;AAE5D,IAAG,SAAS;;;AAOhB,SAAS,uBAAuB,SAAG;AAClC,QAAU;EACV,MAAa,GAAG,QAAQ,OAAO,QAAQ,YAAA,eAA2B;EAC3D,UAAU,OAAO,OAAO,QAAG,YAAiB,EAAC,CAAA,CAAA,IAAA,uBAAA;;;;;;;;;AAIrD,SAAgB,kBAAkB,SAAS;;EAEpC,MAAO,QAAQ,OAAO;EACrB,UAAC,OAAa,OAAO,QAAW,YAAW,EAAA,CAAA,CAAA,IAAA,uBAAA;EACnD,CAAM;;AAEN,kBAAS,SAAkB;CAAC;CAAQ;CAAc;CAAU;CAAA;;;;;;;;AAQ5D,SAAG,iBAAA,SAAA,SAAA;CACH,IAAA;iDAEO,WAAS,OAAA,wDAA2B,QAAU,OAAO,eAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;0DAEpC,QAAK,OAAA,cAAA,CACzB,WAAU,OAAO,wDAA4B,QAAO,OAAA,cAAsB,SAAA,QAAA,EAAA,cAAA,SAAA,KAAA,MAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA,IAAA,cAAA,WAAA,CAAA,OAAA,MAAA,OAAA,EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;AAK3E,QAAA,OAAc,YAAO,OAAQ,QAAa,QAAQ,CAAA,IAAA,cAAQ,CAAA,KAAa,WAAA,CACzE,KACG;EAAM,GAAA;EAAU,KAAI,MAAM,6DAAO,IAAA;EAAA,CACjC,EAAA;EAAA;EAAc;EAAE;EAAY,CAAA,CAAA,CAAG;;AAEnC,iBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/helpers/validations.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"validations.cjs","names":[],"sources":["../../src/helpers/validations.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\n\nexport interface ValidationFailure {\n  code: string;\n  details: string;\n}\n\nexport function validateArguments(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  let sequential = false;\n  for (const argument of command.args ?? []) {\n    if (\n      (argument.kind === CommandParameterKinds.string ||\n        argument.kind === CommandParameterKinds.number) &&\n      argument.variadic\n    ) {\n      if (!sequential) {\n        sequential = true;\n      } else {\n        failures.push({\n          code: \"SEQUENTIAL_VARIADIC_ARGUMENTS\",\n          details: `Sequential variadic arguments are not allowed - since the argument preceding ${argument.name} is variadic, it must not also be variadic.`\n        });\n      }\n    } else {\n      sequential = false;\n    }\n  }\n\n  return failures;\n}\n\nexport function validateOptions(command: CommandTree): ValidationFailure[] {\n  const failures: ValidationFailure[] = [];\n\n  const optionNames = new Set<string>();\n  for (const option of Object.values(command.options ?? {})) {\n    if (optionNames.has(option.name)) {\n      failures.push({\n        code: \"DUPLICATE_OPTION_NAME\",\n        details: `Duplicate option name \"${option.name}\" found in command.`\n      });\n    }\n    optionNames.add(option.name);\n\n    for (const alias of option.alias) {\n      if (optionNames.has(alias)) {\n        failures.push({\n          code: \"DUPLICATE_OPTION_ALIAS\",\n          details: `Duplicate option name \"${alias}\" (an alias of \"${\n            option.name\n          }\") found in command.`\n        });\n      }\n      optionNames.add(alias);\n    }\n  }\n\n  return failures;\n}\n\nexport function validateCommand(command: CommandTree): ValidationFailure[] {\n  const results: ValidationFailure[] = [];\n\n  let failures = validateOptions(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  failures = validateArguments(command);\n  if (failures.length > 0) {\n    results.push(...failures);\n  }\n\n  return results;\n}\n"],"mappings":";;;AAkBA,MAAM,uBAAsB;CAAA;CAAS;CAAM;CAAA;CAAA;;CAG3C,MAAO,WAAU,EAAA;CACf,IAAM,aAAM;AACZ,MAAO,MAAE,YAAM,QAAA,QAAA,EAAA,CACjB,MAAA,SAAA,SAAA,4CAAA,mFAEO,SAAS,SACR,KAAQ,CAAC;KAIV,UAAA,KAAA;EACa,MAAK;EACR,SAAS,gFAA+B,SAAA,KAAA;EAC1C,CAAA;KAIH,cAAC;AAGT,QAAM;;AAEV,kBAAM,SAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;AACN,SAAW,gBAAA,SAAA;CACP,MAAE,WAAa,EAAA;CACf,MAAA,eAAA,IAAA,IAAA,CAAA,CAAA,IAAA,CAAA,kBAAA,IAAA,KAAA;AACF,MAAA,MAAA,UAAA,OAAA,OAAA,QAAA,WAAA,EAAA,CAAA,EAAA;mCAEO,UAAQ,KAAA;GACjB,MAAA;;GAEO,CAAA;;AAGC,OAAA,MAAW,SAAO,OAAI,OAAS;AAC3B,OAAC,YAAU,IAAO,MAAO,CAC7B,UAAgB,KAAM;IACV,MAAA;IACL,SAAA,0BAAsB,MAAA,kBAAA,OAAA,KAAA;IACpB,CAAC;AAEd,eAAA,IAAA,MAAA;;;AAGA,QAAK;;AAET,gBAAgB,SAAM;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;AACtB,SAAgB,gBAAC,SAAuB;CACpC,MAAM,UAAU,EAAA;CAChB,IAAI,WAAW,gBAAA,QAAA;AACf,KAAI,SAAM,SAAS,EACf,SAAE,KAAA,GAAA,SAAA;AAEN,YAAE,kBAAsB,QAAA;AACxB,KAAA,SAAA,SAAA,EACF,SAAA,KAAA,GAAA,SAAA;AAEA,QAAO"}

package/dist/plugin-utils/context-helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-helpers.cjs","names":[],"sources":["../../src/plugin-utils/context-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { kebabCase } from \"@stryke/string-format/kebab-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 type { Context, UnresolvedContext } from \"../types\";\n\n/**\n * Sorts command argument aliases, placing single-character aliases first, followed by multi-character aliases, and then sorting them alphabetically.\n *\n * @param aliases - An array of argument aliases to sort.\n * @returns A new array of sorted aliases.\n */\nexport function sortArgAliases(aliases: string[]): string[] {\n  if (aliases.length === 0) {\n    return [];\n  }\n\n  const result = aliases.filter(alias => alias.length === 1);\n  result.push(...aliases.filter(alias => alias.length > 1));\n\n  return result.sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Retrieves the application name from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application name in kebab-case format.\n * @throws An error if no valid application name is found.\n */\nexport function getAppName(context: UnresolvedContext | Context): string {\n  const result =\n    context.config.name ||\n    (isSetString(context.config.bin) ||\n    (Array.isArray(context.config.bin) &&\n      context.config.bin.length > 0 &&\n      isSetString(context.config.bin[0]))\n      ? isSetString(context.config.bin)\n        ? context.config.bin\n        : context.config.bin[0]\n      : context.packageJson?.name);\n  if (!isSetString(result)) {\n    throw new Error(\n      \"No application name found. Please provide a 'bin' option in the configuration or ensure the package.json has a valid 'name' field.\"\n    );\n  }\n\n  return kebabCase(result);\n}\n\n/**\n * Retrieves the application title from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @param replaceCLI - Whether to replace CLI-related terms in the title with the application name.\n * @returns The application title in title-case format.\n */\nexport function getAppTitle(\n  context: UnresolvedContext | Context,\n  replaceCLI = false\n): string {\n  const title =\n    context.config.title ||\n    titleCase(context.config.name || getAppName(context));\n\n  return (\n    replaceCLI\n      ? title.replace(\n          /(?:cli|command-line|command line)\\s*(?:interface\\s*)?(?:application|app)?$/gi,\n          \"\"\n        )\n      : title\n  ).trim();\n}\n\n/**\n * Retrieves the application description from the context and configuration.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The application description.\n */\nexport function getAppDescription(\n  context: UnresolvedContext | Context\n): string {\n  return (\n    context.config.description ||\n    context.packageJson?.description ||\n    `The ${getAppTitle(context, true)} command-line interface application.`\n  );\n}\n\n/**\n * Retrieves the primary binary name for the application.\n *\n * @param context - The build context containing workspace and package information.\n * @returns The primary binary name as a string.\n */\nexport function getAppBin(context: Context): string {\n  return isSetObject(context.config.bin)\n    ? Object.keys(context.config.bin)[0]!\n    : kebabCase(getAppName(context));\n}\n\n/**\n * Determines if a given command path segment is variable (enclosed in square brackets).\n *\n * @example\n * ```typescript\n * isDynamicPathSegment(\"[user]\"); // true\n * isDynamicPathSegment(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is variable, false otherwise.\n */\nexport function isDynamicPathSegment(path: string): boolean {\n  return path.startsWith(\"[\") && path.endsWith(\"]\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getDynamicPathSegmentName(path: string): string {\n  return path.replaceAll(/^\\[+/g, \"\").replaceAll(/\\]+$/g, \"\");\n}\n\n/**\n * Determines if a given command path segment is a path segment group (enclosed in parentheses).\n *\n * @example\n * ```typescript\n * isPathSegmentGroup(\"(user)\"); // true\n * isPathSegmentGroup(\"[user]\"); // false\n * isPathSegmentGroup(\"user\"); // false\n * ```\n *\n * @param path - The command path segment to check.\n * @returns True if the path is a path segment group, false otherwise.\n */\nexport function isPathSegmentGroup(path: string): boolean {\n  return (path.startsWith(\"(\") && path.endsWith(\")\")) || path.startsWith(\"_\");\n}\n\n/**\n * Extracts the group name from a command path segment by removing enclosing parentheses.\n *\n * @example\n * ```typescript\n * getPathSegmentGroupName(\"(admin)\"); // \"admin\"\n * getPathSegmentGroupName(\"((group))\"); // \"group\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The group name without parentheses.\n */\nexport function getPathSegmentGroupName(path: string): string {\n  return path\n    .replaceAll(/^\\(+/g, \"\")\n    .replaceAll(/\\)+$/g, \"\")\n    .replaceAll(/^_+/g, \"\");\n}\n\n/**\n * Extracts the variable name from a command path segment by removing enclosing square brackets.\n *\n * @example\n * ```typescript\n * getDynamicPathSegmentName(\"[user]\"); // \"user\"\n * ```\n *\n * @param path - The command path segment.\n * @returns The variable name without square brackets.\n */\nexport function getPathSegmentName(path: string): string {\n  return getPathSegmentGroupName(getDynamicPathSegmentName(path));\n}\n"],"mappings":";;;;;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA6BX,SAAc,eAAc,SAAA;AACxB,KAAA,QAAS,WAAA,EACX,QAAA,EAAA;CAEA,MAAM,SAAS,QAAQ,OAAO,cAAe,UAAS,MAAI,WAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;AAC1D,QAAO,KAAO,GAAC,QAAQ,OAAO,cAAe,UAAS,MAAG,SAAA,GAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAAA;;;;;;;;AAG3D,eAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQA,SAAE,WAAA,SAAA;CACF,MAAO,SAAS,QAAW,OAAO,4DACnB,QAAA,OAAA,IAAA,IACH,MAAO,QAAM,QAAA,OAAA,IAAA,IACT,QAAQ,OAAO,IAAI,SAAG,wDACX,QAAO,OAAM,IAAA,GAAA,sDACf,QAAS,OAAG,IAAA,GACnB,QAAQ,OAAO,MACzB,QAAY,OAAQ,IAAO,KACzB,QAAQ,aAAO;AACrB,KAAI,oDAAU,OAAU,CACpB,OAAA,IAAQ,MAAA,qIAAkB;AAE9B,wDAAe,OAAA;;AAEnB,WAAK,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAQL,SAAC,YAAA,SAAA,aAAA,OAAA;CACG,MAAM,QAAQ,QAAM,OAAM,yDACpB,QAAa,OAAU,QAAQ,WAAK,QAAc,CAAA;AACxD,SAAQ,aACV,MAAA,QAAA,gFAAA,GAAA,GACK,OAAS,MAAA;;AAEhB,YAAY,SAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOf,SAAI,kBAAA,SAAA;AACA,QAAI,QAAM,OAAO,eACb,QAAM,aAAY,eAClB,OAAG,YAAA,SAAA,KAAA,CAAA;;AAEX,kBAAQ,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOR,SAAU,UAAc,SAAM;AAC1B,2DAAY,QAAY,OAAA,IAAW,GACrC,OAAA,KAAA,QAAA,OAAA,IAAA,CAAA,qDACc,WAAA,QAAiB,CAAA;;AAEjC,UAAU,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAaV,SAAE,qBAAA,MAAA;AACF,QAAO,KAAS,WAAU,IAAA,IAAS,KAAA,SAAU,IAAO;;AAEpD,qBAAkB,SAAQ;CAAA;CAAa;CAAC;CAAA;;;;;;;;;;;;AAYxC,SAAC,0BAAA,MAAA;AACG,QAAM,KAAM,WAAK,SAAa,GAAA,CAAA,WAAgB,SAAA,GAAA;;AAElD,0BAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAcF,SAAgB,mBAAc,MAAQ;AACpC,QAAA,KAAA,WAAA,IAAA,IAAA,KAAA,SAAA,IAAA,IAAA,KAAA,WAAA,IAAA;;AAEF,mBAAc,SAAc;CAAC;CAAQ;CAAsB;CAAE;;;;;;;;;;;;;AAa7D,SAAgB,wBAAkB,MAAW;AACzC,QAAO,KACT,WAAA,SAAA,GAAA,CACK,WAAS,SAAA,GAAA,CACP,WAAM,QAAa,GAAG;;;;;;;;;;;;;;;;;;AAc/B,SAAE,mBAAA,MAAA;AACF,QAAO,wBAAS,0BAA6C,KAAC,CAAA;;AAE9D,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/deepkit.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/plugin-utils/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { Type } from \"@powerlines/deepkit/vendor/type\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  BaseCommandParameter,\n  CommandParameterKind,\n  StringCommandParameter\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport { isCommandParameterKind } from \"./type-checks\";\n\n/**\n * Extracts a {@link ReflectionKind} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the reflection kind from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link ReflectionKind}.\n */\nexport function extractReflectionKind(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): ReflectionKind {\n  if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.string) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.string)\n  ) {\n    return checkVariadic && (command as StringCommandParameter).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.string;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.number) ||\n    (isSetObject(command as BaseCommandParameter) &&\n      (command as BaseCommandParameter).kind === CommandParameterKinds.number)\n  ) {\n    return checkVariadic && (command as any).variadic\n      ? ReflectionKind.array\n      : ReflectionKind.number;\n  } else if (\n    (isCommandParameterKind(command) &&\n      command === CommandParameterKinds.boolean) ||\n    (isSetObject(command) && command.kind === CommandParameterKinds.boolean)\n  ) {\n    return ReflectionKind.boolean;\n  } else {\n    return ReflectionKind.string;\n  }\n}\n\n/**\n * Extracts a {@link Type} from a {@link BaseCommandParameter} or {@link CommandParameterKind}.\n *\n * @param command - The command parameter or kind to extract the type from.\n * @param checkVariadic - Whether to check for variadic parameters (arrays).\n * @returns The extracted {@link Type}.\n */\nexport function extractType(\n  command: BaseCommandParameter | CommandParameterKind,\n  checkVariadic = true\n): Type {\n  const reflectionKind = extractReflectionKind(command, checkVariadic);\n  if (reflectionKind === ReflectionKind.string) {\n    return { kind: ReflectionKind.string };\n  } else if (reflectionKind === ReflectionKind.number) {\n    return { kind: ReflectionKind.number };\n  } else if (reflectionKind === ReflectionKind.boolean) {\n    return { kind: ReflectionKind.boolean };\n  } else if (reflectionKind === ReflectionKind.array) {\n    if (isCommandParameterKind(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            kind: command\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else if (isSetObject(command)) {\n      return {\n        kind: ReflectionKind.array,\n        type: extractType(\n          {\n            ...command,\n            kind: command.kind\n          } as BaseCommandParameter,\n          false\n        )\n      };\n    } else {\n      return {\n        kind: ReflectionKind.array,\n        type: { kind: ReflectionKind.string }\n      };\n    }\n  } else {\n    return { kind: ReflectionKind.string };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcC,KAAK,2CAAqB,QAAS,yHAEf,QAAQ,wEAEtB,QAAO,iBAAc,QAAW,WAC9B,+CAAiB,QACjB,+CAAoB;UAE3B,2CAAoB,QAAA,IACpB,YAAA,4CAAoB,6DACpB,QAAA,IACS,QAAM,SAAQ,4CAAA,OACjB,QAAC,iBAAuB,QAAQ,WAC/B,+CAAA;UAGK,2CAAuB,QAAQ,IAC5C,YAAA,4CAAA,8DACmB,QAAI,IAAQ,QAAS,SAAS,4CAAe,QAC7D,QAAM,+CAAgB;KAGnB,QAAQ,+CAAC;;AAGhB,sBAAkB,SAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;;AAQlB,SAAQ,YAAe,SAAA,gBAAA,MAAA;CACnB,MAAI,iBAAe,sBAAM,SAAA,cAAA;AACzB,KAAI,mBAAI,+CAAA,OACP,QAAA,EAAA,MAAA,+CAAiC,QAAA;UAEjC,mBAAuB,+CAAA,OACrB,QAAQ,EAAE,MAAC,+CAAoB,QAAQ;UAEnC,mBAAkB,+CAAgB,QACrC,QAAA,EAAA,MAAe,+CAAA,SAAA;UAEX,mBAAA,+CAAA,MACP,KAAA,2CAA8B,QAAG,CAChC,QAAY;EACF,MAAC,+CAAoB;EACjC,MAAA,YAAA,EACO,MAAe,SACjB,EAAA,MAAA;EACE;6DAEX,QAAA;EAEE,MAAA,+CAAA;EACc,MAAK,YAAa;GACjC,GAAA;GACmB,MAAI,QAAQ;GACtB,EAAA,MAAe;EACb;KAGD,QAAA;EACK,MAAE,+CAAA;EACV,MAAA,EAAA,MAAA,+CAAA,QAAA;EACA;KAIJ,QAAS,EAAI,MAAE,+CAAe,QAAQ;;AAG1C,YAAY,SAAC;CAAA;CAAiC;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/description-helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"description-helpers.cjs","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 62\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 62;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length - 3 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length - 3\n      ? formattedDescription\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAE,uBAAa,YAAA,MAAA;AACf,KAAA,QAAA,gBACF,wBAA4B,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAAsB,SAAc;CAAA;OAAiB;CAAgC;QAAqB,EAAE;CAAC;CAAa;CAAA;;;;;;;;;;AAU1H,SAAM,yBAAyB,aAAA;AAC3B,QAAA,YACF,WAAA,KAAA,MAAA,CACI,WAAQ,MAAA,OAAA,CACV,WAAA,KAAqB,MAAE,CACzB,QAAA,SAAA,OAAA;;AAEF,yBAAS,SAAyB;CAAC;CAAC;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAU,aAAkB,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAS,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;AACT,MAAK,mCAAqB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAI,uBAAA,aAAA,UAAA,EAAA,EAAA;CACD,MAAO,SAAQ,QAAI,UAAc;CACnC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CASG,IAAA,WARwB,qBAAuB,QAAA,KAAA,GAAA,SAAA,KAC/C,qBAAsB,OAAA,eAAkB,GAAA,SAAA,IAC1C,qBACK,MAAS,kBAAiB,GAAA,IACnB,MAAC,EACJ,MAAA,GAAA,GAAA,EACD,MAAA,GACD,WACuB,sBAAoB,MAAA;AACjD,KAAA,OAAA,MAAA,CAAA,SAAA,OACH,UAAA,GAAA,OAAA,UAAA,GAAA,KAAA,IAAA,GAAA,SAAA,EAAA,CAAA,CAAA,MAAA,CAAA;AAEA,QAAO,yBAAU,OAAA;;AAEjB,uBAAuB,SAAQ;CAAA;OAAsB;CAAgC;QAAmB,EAAA;CAAA;CAAS;CAAA"}

package/dist/plugin-utils/get-command-tree.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\nimport { traverseCommands } from \"./traverse-command-tree\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n\n/**\n * Retrieves a list of all command trees defined in the context.\n *\n * @param context - The build context containing the command definitions.\n * @returns A promise that resolves to an array of all command trees in the context.\n */\nexport async function getCommandList(context: Context): Promise<CommandTree[]> {\n  const commandList: CommandTree[] = [];\n  await traverseCommands(context, commandTree => {\n    commandList.push(commandTree);\n  });\n\n  return commandList;\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;;AAYV,KAAK,KAAO,WAAW;;AAIxB,KAAO,KAAM,SAAC,GAAW;EAClB,MAAO,WAAU,KACf,MAAA,EAAA,CACA,OAAA,cAAwB,YAAW,CAAC,6CAAa,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAExD,KAAA,aAAA,YACa,OAAQ,UAAS,eAAc,KAAI,YAAa,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAIrB,QAAS;;AAEX,eAAW,SAAa;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOzB,eAAc,eAAA,SAAA;CACV,MAAG,cAAiB,EAAE;AACtB,OAAK,+CAAiB,SAAU,cAAA,gBAAA;AAC5B,cAAC,KAAA,YAAA;IACF;EAAC;EAAa;EAAA;EAAU,CAAA,CAAA;AAC3B,QAAI;;AAER,eAAQ,SAAc;CAAA;CAAY;CAAS;CAAgB;CAAA;CAAA"}

package/dist/plugin-utils/reflect.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflect.cjs","names":[],"sources":["../../src/plugin-utils/reflect.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(\n      arg => arg.kind !== CommandParameterKinds.boolean || !arg.isNegativeOf\n    )\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === CommandParameterKinds.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a =>\n            a.kind === CommandParameterKinds.boolean &&\n            a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AASX,SAAgB,YAAW,SAAQ;AAClC,KAAO,CAAC,WAAW,QAAO,WAAQ;gBAI1B,OAAO,cAAa,QAAO,IAAI,SAAS,4CAAqB,WAAA,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;;;;;KAE/D,OAAO,cAAgB,KAAK,QAAI;AAC/B,MAAC,KAAA,IAAA;;GAGD,MAAQ,cAAQ,QAAe,KAAG,cAAc,MAAO,EAAC,SAAQ,4CAAe,WACtF,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACS,OAAA,YACI,KAAI,KAAM,YAAU;;AAG3B,SAAQ;IACX;EAAA;EAAS;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}

package/dist/plugin-utils/traverse-command-tree.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"traverse-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/traverse-command-tree.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { MaybePromise } from \"@stryke/types/base\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\n\n/**\n * Traverses a command tree and applies a visitor function to each node.\n *\n * @param commandTree - The command tree to traverse.\n * @param visitor - The visitor function to apply to each node.\n */\nexport async function traverseCommandTree(\n  commandTree: CommandTree,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!commandTree.children) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(commandTree.children).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n\n/**\n * Traverses all commands in the context and applies a visitor function to each command tree.\n *\n * @param context - The build context containing the command definitions.\n * @param visitor - The visitor function to apply to each command tree.\n */\nexport async function traverseCommands<TContext extends Context>(\n  context: TContext,\n  visitor: (node: CommandTree) => MaybePromise<void>\n): Promise<void> {\n  if (!context.commands) {\n    return;\n  }\n\n  await Promise.all(\n    Object.values(context.commands).map(async childTree => {\n      await Promise.resolve(visitor(childTree));\n      await traverseCommandTree(childTree, visitor);\n    })\n  );\n}\n"],"mappings":";;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AAQX,eAAsB,oBAAoB,aAAU,SAAS;AAC5D,KAAA,CAAA,YAAoB,SACb;AAEP,OAAK,QAAQ,IAAA,OAAa,OAAS,YAAA,SAAA,CAAA,IAAA,aAAA,OAAA,cAAA;;AAE5B,QAAM,oBAAoB,WAAW,QAAQ;;;;;;;AAGrD,oBAAc,SAAc;CAAA;CAAe;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOnD,eAAoB,iBAAY,SAAY,SAAa;AACvD,KAAA,CAAA,QAAA,SACK;AAEL,OAAQ,QAAQ,IAAA,OAAW,OAAK,QAAA,SAAiB,CAAA,IAAA,aAAA,OAAA,cAAA;AAChD,QAAQ,QAAM,QAAA,QAAA,UAAA,CAAA;AACV,QAAA,oBAAsB,WAAA,QAAA;IACzB;EAAA;EAAM;EAAA;EAAA,CAAA,CAAA,CAAA"}

package/dist/plugin-utils/type-checks.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-checks.cjs","names":[],"sources":["../../src/plugin-utils/type-checks.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 { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,2DAAS,IAAA;EAEP,4CAAA;EACM,4CAA0B;EACjC,4CAAA;EACQ,CAAC,SAAS,IAAC;;AAEpB,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAM,yBAAsB,KAAA;AACxB,2DAAkB,IAAA,IAAA,UAAA,OAAoB,uBAAA,IAAA,KAAA;;AAE1C,yBAAA,SAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOA,SAAE,mBAAA,KAAA;AACF,QAAO,yBAAS,IAAwB,IACjC,UAAA,0DACG,IAAA,KAAA,IACF,WAAC,0DACT,IAAA,MAAA,+EAEE,IAAA,YAAA,IACM,WAAS,OAChB,MAAA,QAAA,IAAA,MAAA,IACG,SAAY,2DACI,IAAI,IAAK,IAAI,IAAE,QAAQ,UACzC,cAAA,qDACc,IAAA,SAAA,IACR,cAAC,qDACL,IAAA,SAAyB;;AAE7B,mBAAmB,SAAQ;CAAA;CAAA;CAAA;CAAA;;;;;;;AAO3B,SAAgB,gBAAE,KAAA;AACd,QAAC,yBAAgC,IAAI,IAAA,mBAAQ,IAAA,IAAA,aAAA;;AAEjD,gBAAc,SAAI;CAAQ;CAAG;CAAA;CAAA;;;;;;;AAO7B,SAAgB,kBAAkB,KAAK;AACtC,QAAA,yBAAA,IAAA,IAAA,mBAAA,IAAA;;AAED,kBAAiB,SAAO;CAAA;CAAW;CAAa;CAAe"}

package/dist/plugin.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.cjs","names":[],"sources":["../src/plugin.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 { For, Show } from \"@alloy-js/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath, relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { ExecBuiltin } from \"./components/exec-builtin\";\nimport { StateBuiltin } from \"./components/state-builtin\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  findCommandsRoot,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/paths\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getGlobalOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandOption, CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n): Plugin<TContext>[] => {\n  return [\n    tsdown<TContext>(),\n    automd<TContext>(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              path: joinPaths(this.config.root, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            platform: \"node\",\n            projectType: \"application\",\n            framework: \"shell-shock\",\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: false\n            },\n            input:\n              !this.config.input ||\n              (Array.isArray(this.config.input) &&\n                this.config.input.length === 0) ||\n              (isObject(this.config.input) &&\n                Object.keys(this.config.input).length === 0)\n                ? [\n                    joinPaths(this.config.root, \"src/**/command.ts\"),\n                    joinPaths(this.config.root, \"src/**/command.tsx\")\n                  ]\n                : undefined,\n            resolve: {\n              external: [\"@powerlines/deepkit\"],\n              skipNodeModulesBundle: true\n            },\n            tsdown: {\n              dts: false,\n              nodeProtocol: true,\n              unbundle: false\n            }\n          }\n        );\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.options = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n\n          this.options = this.options.map(\n            option =>\n              ({\n                ...option,\n                name: camelCase(option.name),\n                alias: option.alias ?? [],\n                optional: option.optional ?? false\n              }) as CommandOption\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <StateBuiltin />\n            <UtilsBuiltin />\n            <ExecBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : relativePath(command.entry.file, this.commandsPath)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${\n                          command.name\n                        } \\n\\nPlease ensure ${\n                          command.entry.file\n                        } is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          }\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${\n                      isParentPath(command.entry.file, this.commandsPath)\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : replacePath(command.entry.file, this.config.root)\n                    }${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  } as CommandOption\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.hooks ??= {} as TsdownHooks;\n        (this.config.tsdown.hooks as TsdownHooks)[\"build:done\"] = async (\n          _: BuildContext & {\n            chunks: RolldownChunk[];\n          }\n        ) => {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(this.workspaceConfig.workspaceRoot, this.config.root)\n              );\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding hashbang to binary executable output file: ${path}`\n                );\n\n                const content = await this.fs.read(path);\n                if (content && !content.startsWith(\"#!\")) {\n                  await this.fs.write(\n                    path,\n                    `#!/usr/bin/env ${\n                      this.config.mode === \"development\"\n                        ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                        : \"\"\n                    } node\\n\\n${content}`\n                  );\n                }\n\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${\n                    path\n                  }`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Expected binary output file not found at path: ${\n                    path\n                  }. Skipping adding hashbang and executable permissions (chmod+x).`\n                );\n              }\n            })\n          );\n        };\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/dist/resolver/deepkit.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"deepkit.cjs","names":[],"sources":["../../src/resolver/deepkit.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  ReflectionParameter,\n  ReflectionProperty,\n  Type,\n  TypeArray\n} from \"@powerlines/deepkit/vendor/type\";\nimport {\n  reflect,\n  ReflectionClass,\n  ReflectionFunction,\n  ReflectionKind,\n  stringifyType\n} from \"@powerlines/deepkit/vendor/type\";\nimport { isBigInt } from \"@stryke/type-checks/is-bigint\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameterKind,\n  Context,\n  NumberCommandParameter,\n  StringCommandParameter\n} from \"../types\";\nimport { CommandParameterKinds } from \"../types\";\nimport { mergeCommandParameter } from \"./helpers\";\nimport type { ResolverContext } from \"./types\";\n\nfunction extractCommandParameterKind(\n  type: Type | ReflectionKind\n): CommandParameterKind {\n  const isKind = !(isSetObject(type) && \"kind\" in type);\n  const kind = !isKind ? type.kind : type;\n  if (kind === ReflectionKind.string) {\n    return CommandParameterKinds.string;\n  } else if (\n    kind === ReflectionKind.number ||\n    kind === ReflectionKind.bigint ||\n    (!isKind &&\n      type.kind === ReflectionKind.literal &&\n      (isNumber(type.literal) || isBigInt(type.literal)))\n  ) {\n    return CommandParameterKinds.number;\n  } else if (kind === ReflectionKind.boolean) {\n    return CommandParameterKinds.boolean;\n  } else {\n    return CommandParameterKinds.string;\n  }\n}\n\nfunction resolveCommandOption(\n  ctx: ResolverContext,\n  reflection: ReflectionProperty\n): CommandOption {\n  const type = reflection.getType();\n  const existing = (ctx.output.options[reflection.getNameAsString()] ??\n    {}) as Partial<CommandOption>;\n\n  const option = {\n    name: reflection.getNameAsString(),\n    alias: reflection.getTags().alias ?? [],\n    title: reflection.getTags().title?.trim(),\n    description: reflection.getDescription(),\n    kind: extractCommandParameterKind(type),\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue(),\n    variadic: reflection.isArray()\n  };\n\n  if (option.variadic) {\n    option.kind = extractCommandParameterKind((type as TypeArray).type.kind);\n  } else if (type.kind === ReflectionKind.union) {\n    option.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (option as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (option as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !existing.kind &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for option \"${reflection.getNameAsString()}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, option) as CommandOption;\n}\n\nfunction resolveCommandArgument(\n  ctx: ResolverContext,\n  index: number,\n  reflection: ReflectionParameter\n): CommandArgument {\n  const type = reflection.getType();\n  const existing = (\n    ctx.output.args.length > index ? ctx.output.args[index] : {}\n  ) as Partial<CommandArgument>;\n\n  const argument = {\n    name: reflection.getName() || reflection.parameter.name,\n    alias: reflection.getAlias(),\n    kind: extractCommandParameterKind(type.kind),\n    title: reflection.getTitle() || reflection.parameter.tags?.title,\n    description: reflection.parameter.description,\n    optional: reflection.isOptional(),\n    default: reflection.getDefaultValue()\n  };\n\n  if (type.kind === ReflectionKind.array) {\n    if (\n      type.type.kind === ReflectionKind.string ||\n      type.type.kind === ReflectionKind.number\n    ) {\n      (argument as StringCommandParameter | NumberCommandParameter).variadic =\n        true;\n      (argument as StringCommandParameter | NumberCommandParameter).kind =\n        extractCommandParameterKind(type.type.kind) as \"string\" | \"number\";\n    } else {\n      throw new Error(\n        `Unsupported array type for positional argument \"${argument.name}\" in command \"${\n          ctx.input.command.name\n        }\". Only string[], number[], or literal[] are supported, received ${stringifyType(\n          type\n        )\n          .trim()\n          .replaceAll(\" | \", \", or \")}.`\n      );\n    }\n  } else if (type.kind === ReflectionKind.union) {\n    argument.kind = type.types.every(\n      t =>\n        t.kind === ReflectionKind.number ||\n        (t.kind === ReflectionKind.literal &&\n          (isNumber(t.literal) || isBigInt(t.literal)))\n    )\n      ? CommandParameterKinds.number\n      : CommandParameterKinds.string;\n\n    (argument as StringCommandParameter | NumberCommandParameter).choices =\n      type.types\n        .map(t =>\n          t.kind === ReflectionKind.literal\n            ? isNumber(t.literal)\n              ? t.literal\n              : isBigInt(t.literal)\n                ? Number(t.literal)\n                : isRegExp(t.literal)\n                  ? t.literal.source\n                  : String(t.literal)\n            : null\n        )\n        .filter(Boolean) as string[] | number[];\n  } else if (type.kind === ReflectionKind.literal) {\n    (argument as StringCommandParameter | NumberCommandParameter).choices = [\n      isNumber(type.literal)\n        ? type.literal\n        : isBigInt(type.literal)\n          ? Number(type.literal)\n          : isRegExp(type.literal)\n            ? type.literal.source\n            : String(type.literal)\n    ].filter(Boolean) as string[] | number[];\n  } else if (\n    !ctx.output.args?.length &&\n    type.kind !== ReflectionKind.boolean &&\n    type.kind !== ReflectionKind.string &&\n    type.kind !== ReflectionKind.number\n  ) {\n    throw new Error(\n      `Unsupported type for positional argument \"${argument.name}\" in command \"${\n        ctx.input.command.name\n      }\". Only string, number, boolean, string[], number[], or literal[] are supported, received ${stringifyType(\n        type\n      )\n        .trim()\n        .replaceAll(\" | \", \", or \")}.`\n    );\n  }\n\n  return mergeCommandParameter(existing, argument, {\n    name: `arg${index}`\n  }) as CommandArgument;\n}\n\nexport function resolveFromBytecode<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  const { input, module } = ctx;\n\n  const type = reflect(module);\n  if (type.kind !== ReflectionKind.function) {\n    throw new Error(\n      `The command entry file \"${\n        input.command.entry.input?.file || input.command.path\n      }\" does not export a valid function.`\n    );\n  }\n\n  const reflection = new ReflectionFunction(type);\n\n  ctx.output.description ??= (ctx.input.command.description ||\n    reflection.getDescription() ||\n    type.description)!;\n\n  const parameters = reflection.getParameters();\n  if (parameters.length > 0) {\n    const hasOptions =\n      parameters[0] &&\n      (parameters[0].type.kind === ReflectionKind.objectLiteral ||\n        parameters[0].type.kind === ReflectionKind.class);\n    if (hasOptions) {\n      const optionsReflection = ReflectionClass.from(parameters[0]?.type);\n      for (const propertyReflection of optionsReflection.getProperties()) {\n        ctx.output.options[propertyReflection.getNameAsString()] =\n          resolveCommandOption(ctx, propertyReflection);\n      }\n    }\n\n    ctx.output.args = (hasOptions ? parameters.slice(1) : parameters).map(\n      (arg, index) => resolveCommandArgument(ctx, index, arg)\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;AAEA,SAAS,aAAW,IAAM,MAAA;;AAEzB,QAAU;;;CAUV,MAAK,SAAQ,qDAAmB,KAAG,IAAA,UAAA;;AAEhC,KAAI,SAAS,+CAAe;UAG9B,SAAmB,+CAAA,UACnB,SAAA,+CAAkB,UACd,CAAA,UACJ,KAAA,SAAA,+CAAA,wDACkB,KAAO,QAAQ,gDAAK,KAAA,QAAA,EACjC,QAAA,4CAAA;UAEL,SAAe,+CAAA,QACf,QAAA,4CAAkB;KAGZ,QAAC,4CAA0B;;AAGnC,4BAA2B,SAAO;CAAI;OAAW;CAAO;CAAA;CAAA;CAAA;CAAA;AACxD,SAAS,qBAAqB,KAAA,YAAY;CAC1C,MAAO,OAAK,WAAA,SAAA;CACV,MAAA,WAAe,IAAA,OAAA,QAAA,WAAA,iBAAA,KACf,EAAA;CACA,MAAA,SAAA;EACA,MAAO,WAAA,iBAAA;EACP,OAAA,WAAsB,SAAA,CAAA,SAAA,EAAA;EACtB,OAAA,WAAA,SAAA,CAAA,OAAA,MAAA;EACM,aAAS,WAAA,gBAAA;EACT,MAAC,4BAAiC,KAAK;EACvC,UAAC,WAAA,YAAgC;EAClC,SAAO,WAAA,iBAA+B;;EAE7C;AACE,KAAM,OAAO,SACZ,QAAA,OAAA,4BAAqB,KAAA,KAAA,KAAA;UAEX,KAAG,SAAS,+CAAgB,OAAA;AACnC,SAAS,OAAA,KAAA,MAAe,MAAQ,cAAA,MAAA,EAAA,SAAA,+CAAA,UAC3B,EAAA,SAAA,+CAA4B,wDAC3B,EAAA,QAAA,gDAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACC,4CAAuB,SACvB,4CAAuB;AAC9B,SAAQ,UACH,KAAM,MACD,IAAK,cAAY,MAAA,EAAQ,SAAM,+CAAS,sDACpD,EAAA,QAAA,GACO,EAAA,sDACW,EAAA,QAAe,GAC1B,OAAsB,EAAA,QAAO,+CAC/B,EAAA,QAAA,GACE,EAAqB,QAAO,SACrC,OAAA,EAAA,QAAA,GACF,MAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;YAGO,KAAA,SAAe,+CAAA,QACpB,QAAY,UAAA,6CACG,KAAA,QAAA,GACF,KAAA,sDACS,KAAO,QAAQ,GACpB,OAAA,KAAc,QAAA,+DAEhB,KAAA,QAAA,SACI,OAAA,KAAiB,QAAA,CAC7B,CAAC,OAAC,QAAW;UAElB,CAAA,SAAa,QACT,KAAE,SAAA,+CAA2B,WACjC,KAAS,SAAC,+CAAuB,UACjC,KAAS,SAAA,+CAAW,OACpB,OAAU,IAAA,MAAU,gCAAS,WAAA,iBAAA,CAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,+IAAA,KAAA,CAC9B,MAAA;AAGC,QAAO,sCAAO,UAAA,OAA6B;;AAE/C,qBAAkB,SAAW;CAAA;CAAK;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAClC,SAAS,uBAAA,KAAA,OAAA,YAAA;CACL,MAAM,OAAO,WAAE,SAAe;CAC9B,MAAM,WAAU,IAAA,OAAA,KAAe,SAAS,QAAA,IAAA,OAAA,KAAA,SAAA,EAAA;CACxC,MAAM,WAAW;EACjB,MAAA,WAAA,SAAA,IAAA,WAAA,UAAA;EACI,OAAA,WAAA,UAAsB;EACtB,MAAA,4BAA4B,KAAA,KAAA;;EAE/B,aAAU,WAAA,UAAyB;EAClC,UAAK,WAAA,YAAA;EACH,SAAQ,WAAA,iBAAA;EACX;AACD,KAAI,KAAK,SAAS,+CAAU,MACxB,KAAI,KAAK,KAAC,SAAA,+CAAA,UACN,KAAI,KAAA,SAAW,+CAAO,QAAA;AACtB,WAAM,WACF;AACJ,WAAS,OACL,4BAAoB,KAAA,KAAA,KAAA;OAG3B,OAAO,IAAA,MAAY,mDAAmB,SAAA,KAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,sHAAA,KAAA,CAC9B,MAAM,CACR,WAAA,OAAA,QAAyB,CAAA,GAAA;UAG9B,KAAQ,SAAM,+CAAO,OAAA;AACvB,WAAI,OAAY,KAAA,MAAO,MAAA,cAAA,MAAA,EAAA,SAAA,+CAAA,UACnB,EAAA,SAAS,+CAAY,wDACP,EAAC,QAAA,gDAAA,EAAA,QAAA,GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,GACb,4CAAmB,SACpB,4CAAuB;AAC5B,WAAI,UACP,KAAS,MACG,IAAC,cAAe,MAAA,EAAQ,SAAC,+CAAA,sDACxB,EAAA,QAAe,GACf,EAAA,sDACd,EAAA,QAAA,GACe,OAAA,EAAA,QAAA,+CACgB,EAAE,QAAC,GACZ,EAAA,QAAA,SACI,OAAC,EAAQ,QAAQ,GACvC,MAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA,CACF,OAAA,QAAA;YAEG,KAAA,SAAkB,+CAAU,QAChC,UAAA,UAAA,6CACH,KAAA,QAAA,8DAEO,KAAsB,QAAS,GACxC,OAAA,KAAA,QAAA,+DAES,KAAsB,QAAA,SACT,OAAA,KAAA,QAAA,CACb,CAAA,OAAM,QAAA;UAEZ,CAAA,IAAe,OAAC,MAAA,UACX,KAAK,SAAE,+CAAoB,WAC3B,KAAA,SAAW,+CAAA,UACX,KAAA,SAAY,+CAAiB,OAC9B,OAAO,IAAC,MAAA,6CAAgB,SAAA,KAAA,gBAAA,IAAA,MAAA,QAAA,KAAA,+IAAA,KAAA,QAEvB,WAAW,OAAA,QAAA,CAAA,GAAA;AAEf,QAAO,sCAAqB,UAAA,UAAA,EACxB,MAAE,MAAA,SACN,CAAA;;AAEJ,uBAAc,SAAW;CAAA;CAAY;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACrC,SAAa,oBAAW,KAAgB;CACrC,MAAA,EAAA,OAAA,WAAA;;AAEC,KAAE,KAAK,SAAS,+CAAe,SAC5B,OAAA,IAAA,MAAA,2BAAA,MAAA,QAAA,MAAA,OAAA,QAAA,MAAA,QAAA,KAAA,qCAAA;CAEH,MAAM,aAAa,IAAE,mDAAe,KAAA;AACpC,KAAE,OAAA,gBAAA,IAAA,MAAA,QAAA,eACC,WAAY,gBAAA,IACX,KAAI;CACR,MAAG,aAAY,WAAA,eAAyB;AACxC,KAAI,WAAA,SAAA,GAAA;EACF,MAAK,aAAA,WAAA,OACC,WAAS,GAAA,KAAA,SAAA,+CAAA,iBACZ,WAAkB,GAAA,KAAQ,SAAC,+CAAuB;AACnD,MAAE,YAAU;GACR,MAAK,oBAAoB,gDAAiB,KAAA,WAAW,IAAS,KAAE;AAClE,QAAA,MAAA,sBAAA,kBAAA,eAAA,CACF,KAAA,OAAA,QAAA,mBAAA,iBAAA,IACQ,qBAAA,KAAA,mBAAA;;AAGZ,MAAA,OAAA,QAAA,aAAA,WAAA,MAAA,EAAA,GAAA,YAAA,IAAA,cAAA,KAAA,UAAA,uBAAA,KAAA,OAAA,IAAA,EAAA;GAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;;;AAGJ,oBAAS,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/resolver/helpers.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.cjs","names":[],"sources":["../../src/resolver/helpers.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getUniqueBy } from \"@stryke/helpers/get-unique\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { createDefu } from \"defu\";\nimport {\n  getAppTitle,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport type { CommandArgument, CommandParameterKind } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport type { ResolverContext } from \"./types\";\n\n/**\n * Resolves the description for a command option based on its reflection.\n *\n * @param name - The name of the command option.\n * @param kind - The reflection kind of the command option.\n * @param optional - Whether the command option is optional.\n * @param variadic - Whether the command option is variadic (i.e., an array).\n * @param title - The title of the command option, if any.\n * @param defaultValue - The default value of the command option, if any.\n * @returns The resolved description for the command option.\n */\nexport function resolveCommandOptionDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `A${optional && !defaultValue ? \"n optional\" : \"\"} command-line ${\n    kind === CommandParameterKinds.boolean ? \"flag\" : \"option\"\n  } that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\n/**\n * Resolves the description for a command argument based on its reflection.\n *\n * @param name - The name of the command argument.\n * @param kind - The reflection kind of the command argument.\n * @param optional - Whether the command argument is optional.\n * @param variadic - Whether the command argument is variadic (i.e., an array).\n * @param title - The title of the command argument, if any.\n * @param defaultValue - The default value of the command argument, if any.\n * @returns The resolved description for the command argument.\n */\nexport function resolveCommandArgumentDescription(\n  name: string,\n  kind: CommandParameterKind,\n  optional = false,\n  variadic = false,\n  title?: string,\n  defaultValue?: any\n): string {\n  return `An${\n    optional && !defaultValue ? \" optional\" : \"\"\n  } argument that allows the user to ${\n    kind === CommandParameterKinds.boolean\n      ? \"set the\"\n      : variadic\n        ? \"specify custom\"\n        : \"specify a custom\"\n  } ${title?.trim() || titleCase(name)} ${\n    kind === CommandParameterKinds.boolean\n      ? \"indicator\"\n      : `${kind === CommandParameterKinds.number ? \"numeric\" : \"string\"} value${\n          variadic ? \"s\" : \"\"\n        }`\n  }.`;\n}\n\nexport function applyOptionsDefaults(ctx: ResolverContext) {\n  return Object.fromEntries(\n    Object.entries(ctx.output.options).map(([key, option]) => {\n      const name = option.name || key;\n      const title = option.title || titleCase(name);\n\n      return [\n        key,\n        {\n          ...option,\n          name,\n          title,\n          description:\n            option.description ||\n            resolveCommandOptionDescription(\n              name,\n              option.kind,\n              option.optional,\n              option.kind !== CommandParameterKinds.boolean && option.variadic,\n              title,\n              option.default\n            ),\n          env:\n            option.env || option.env === false\n              ? option.env\n              : ctx.input.context.config.autoAssignEnv\n                ? constantCase(name)\n                : false\n        }\n      ];\n    })\n  );\n}\n\nexport function applyArgsDefaults(ctx: ResolverContext): CommandArgument[] {\n  return ctx.output.args.map((arg, i) => {\n    const name = arg.name || `arg${i + 1}`;\n    const title = arg.title || titleCase(name);\n\n    return {\n      ...arg,\n      name,\n      title,\n      description:\n        arg.description ||\n        resolveCommandArgumentDescription(\n          name,\n          arg.kind,\n          arg.optional,\n          arg.kind !== CommandParameterKinds.boolean && arg.variadic,\n          title,\n          arg.default\n        ),\n      env: arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(name)\n            : false\n        : false\n    };\n  });\n}\n\nexport function applyDefaults(ctx: ResolverContext) {\n  ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim()} executable command-line interface.`;\n  if (\n    isSetString(ctx.input.context.config.reference?.commands) &&\n    ctx.input.context.config.reference.commands.includes(\"{command}\")\n  ) {\n    ctx.output.reference ??= ctx.input.context.config.reference.commands\n      ? ctx.input.context.config.reference.commands.replace(\n          \"{command}\",\n          ctx.input.command.segments\n            .filter(segment => !isDynamicPathSegment(segment))\n            .join(\"/\")\n        )\n      : undefined;\n  }\n}\n\nexport function resolveVirtualCommand<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n) {\n  ctx.output.title ??= titleCase(ctx.input.command.name);\n  ctx.output.description ??= `A collection of available ${\n    ctx.output.title.replace(/(?:c|C)ommands?$/, \"\").trim() ||\n    titleCase(ctx.input.command.name)\n  } commands that are included in the ${getAppTitle(\n    ctx.input.context,\n    true\n  )} command-line application.`;\n}\n\n/**\n * Merges two command parameters, giving precedence to string values in the second configuration.\n *\n * @param objA - The first command parameter object.\n * @param objB - The second command parameter object.\n * @returns The merged command parameter object.\n */\nexport const mergeCommandParameter = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  } else if (Array.isArray(obj[key]) && Array.isArray(value)) {\n    if (value.length > 0) {\n      obj[key] = getUniqueBy((obj[key] as unknown[]).concat(value), item =>\n        isString(item) ? item : JSON.stringify(item)\n      ) as (typeof obj)[typeof key];\n    }\n\n    return true;\n  }\n\n  return false;\n});\n"],"mappings":"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"}