@shell-shock/core 0.9.7 → 0.10.0

package/dist/components/utils-builtin.mjs

@@ -1,13 +1,214 @@
-import { createComponent, createIntrinsic, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
 import defu$1 from "defu";
 import { Show, code, splitProps } from "@alloy-js/core";
 import { Spacing } from "@powerlines/plugin-alloy/core/components/spacing";
 import { FunctionDeclaration, InterfaceDeclaration, InterfaceMember, TypeDeclaration, VarDeclaration } from "@alloy-js/typescript";
+import { usePowerlines } from "@powerlines/plugin-alloy/dist/core/contexts/context.mjs";
 import { BuiltinFile } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 import { TSDoc, TSDocInternal, TSDocLink, TSDocParam, TSDocRemarks, TSDocReturns } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
 
 //#region src/components/utils-builtin.tsx
 /**
+* Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.
+*/
+function FindSuggestionsDeclaration() {
+	const context = usePowerlines();
+	return [
+		createComponent(VarDeclaration, {
+			"const": true,
+			name: "deburred",
+			initializer: code` {
+          "\\xc0": "A",  "\\xc1": "A", "\\xc2": "A", "\\xc3": "A", "\\xc4": "A", "\\xc5": "A",
+          "\\xe0": "a",  "\\xe1": "a", "\\xe2": "a", "\\xe3": "a", "\\xe4": "a", "\\xe5": "a",
+          "\\xc7": "C",  "\\xe7": "c",
+          "\\xd0": "D",  "\\xf0": "d",
+          "\\xc8": "E",  "\\xc9": "E", "\\xca": "E", "\\xcb": "E",
+          "\\xe8": "e",  "\\xe9": "e", "\\xea": "e", "\\xeb": "e",
+          "\\xcc": "I",  "\\xcd": "I", "\\xce": "I", "\\xcf": "I",
+          "\\xec": "i",  "\\xed": "i", "\\xee": "i", "\\xef": "i",
+          "\\xd1": "N",  "\\xf1": "n",
+          "\\xd2": "O",  "\\xd3": "O", "\\xd4": "O", "\\xd5": "O", "\\xd6": "O", "\\xd8": "O",
+          "\\xf2": "o",  "\\xf3": "o", "\\xf4": "o", "\\xf5": "o", "\\xf6": "o", "\\xf8": "o",
+          "\\xd9": "U",  "\\xda": "U", "\\xdb": "U", "\\xdc": "U",
+          "\\xf9": "u",  "\\xfa": "u", "\\xfb": "u", "\\xfc": "u",
+          "\\xdd": "Y",  "\\xfd": "y", "\\xff": "y",
+          "\\xc6": "Ae", "\\xe6": "ae",
+          "\\xde": "Th", "\\xfe": "th",
+          "\\xdf": "ss",
+          "\\u0100": "A",  "\\u0102": "A", "\\u0104": "A",
+          "\\u0101": "a",  "\\u0103": "a", "\\u0105": "a",
+          "\\u0106": "C",  "\\u0108": "C", "\\u010a": "C", "\\u010c": "C",
+          "\\u0107": "c",  "\\u0109": "c", "\\u010b": "c", "\\u010d": "c",
+          "\\u010e": "D",  "\\u0110": "D", "\\u010f": "d", "\\u0111": "d",
+          "\\u0112": "E",  "\\u0114": "E", "\\u0116": "E", "\\u0118": "E", "\\u011a": "E",
+          "\\u0113": "e",  "\\u0115": "e", "\\u0117": "e", "\\u0119": "e", "\\u011b": "e",
+          "\\u011c": "G",  "\\u011e": "G", "\\u0120": "G", "\\u0122": "G",
+          "\\u011d": "g",  "\\u011f": "g", "\\u0121": "g", "\\u0123": "g",
+          "\\u0124": "H",  "\\u0126": "H", "\\u0125": "h", "\\u0127": "h",
+          "\\u0128": "I",  "\\u012a": "I", "\\u012c": "I", "\\u012e": "I", "\\u0130": "I",
+          "\\u0129": "i",  "\\u012b": "i", "\\u012d": "i", "\\u012f": "i", "\\u0131": "i",
+          "\\u0134": "J",  "\\u0135": "j",
+          "\\u0136": "K",  "\\u0137": "k", "\\u0138": "k",
+          "\\u0139": "L",  "\\u013b": "L", "\\u013d": "L", "\\u013f": "L", "\\u0141": "L",
+          "\\u013a": "l",  "\\u013c": "l", "\\u013e": "l", "\\u0140": "l", "\\u0142": "l",
+          "\\u0143": "N",  "\\u0145": "N", "\\u0147": "N", "\\u014a": "N",
+          "\\u0144": "n",  "\\u0146": "n", "\\u0148": "n", "\\u014b": "n",
+          "\\u014c": "O",  "\\u014e": "O", "\\u0150": "O",
+          "\\u014d": "o",  "\\u014f": "o", "\\u0151": "o",
+          "\\u0154": "R",  "\\u0156": "R", "\\u0158": "R",
+          "\\u0155": "r",  "\\u0157": "r", "\\u0159": "r",
+          "\\u015a": "S",  "\\u015c": "S", "\\u015e": "S", "\\u0160": "S",
+          "\\u015b": "s",  "\\u015d": "s", "\\u015f": "s", "\\u0161": "s",
+          "\\u0162": "T",  "\\u0164": "T", "\\u0166": "T",
+          "\\u0163": "t",  "\\u0165": "t", "\\u0167": "t",
+          "\\u0168": "U",  "\\u016a": "U", "\\u016c": "U", "\\u016e": "U", "\\u0170": "U", "\\u0172": "U",
+          "\\u0169": "u",  "\\u016b": "u", "\\u016d": "u", "\\u016f": "u", "\\u0171": "u", "\\u0173": "u",
+          "\\u0174": "W",  "\\u0175": "w",
+          "\\u0176": "Y",  "\\u0177": "y", "\\u0178": "Y",
+          "\\u0179": "Z",  "\\u017b": "Z", "\\u017d": "Z",
+          "\\u017a": "z",  "\\u017c": "z", "\\u017e": "z",
+          "\\u0132": "IJ", "\\u0133": "ij",
+          "\\u0152": "Oe", "\\u0153": "oe",
+          "\\u0149": "n", "\\u017f": "s"
+        } as Record<string, string>; `
+		}),
+		createComponent(Spacing, {}),
+		createComponent(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.",
+			get children() {
+				return [
+					createComponent(TSDocRemarks, { children: "This function is intended to be used to suggest corrections for potentially misspelled options or commands." }),
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocInternal, {}),
+					createIntrinsic("hbr", {}),
+					createIntrinsic("hbr", {}),
+					createComponent(TSDocParam, {
+						name: "input",
+						children: "The input string to check for potential matches."
+					}),
+					createComponent(TSDocParam, {
+						name: "options",
+						children: "A list of possible matches to compare against the input."
+					}),
+					createComponent(TSDocReturns, { children: "A list of suggested matches based on the Levenshtein distance." })
+				];
+			}
+		}),
+		createComponent(FunctionDeclaration, {
+			"export": true,
+			name: "findSuggestions",
+			parameters: [{
+				name: "input",
+				type: "string"
+			}, {
+				name: "options",
+				type: "string[]"
+			}],
+			returnType: "string[]",
+			get children() {
+				return [
+					createComponent(VarDeclaration, {
+						"const": true,
+						name: "normalizedInput",
+						get initializer() {
+							return code`String(input ?? "")${context.config.isCaseSensitive ? "" : ".toLowerCase()"}.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, ""); `;
+						}
+					}),
+					createComponent(Spacing, {}),
+					memo(() => code`
+        if (!normalizedInput || options.length === 0) {
+          return [];
+        }
+
+        const threshold = Math.ceil(normalizedInput.length * 0.25) || 1;
+        const results: Array<{ option: string; distance: number }> = [];
+
+        for (const option of options) {
+          const normalizedOption = String(option ?? "")${context.config.isCaseSensitive ? "" : ".toLowerCase()"}.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, "");
+
+          if (!normalizedOption) {
+            continue;
+          }
+
+          const lenA = normalizedInput.length;
+          const lenB = normalizedOption.length;
+
+          if (Math.abs(lenA - lenB) > threshold) {
+            continue;
+          }
+
+          let distance: number;
+          if (lenA === 0) {
+            distance = lenB;
+          } else if (lenB === 0) {
+            distance = lenA;
+          } else if (lenA <= 32) {
+            const peq: Record<string, number> = {};
+            for (let i = 0; i < lenA; i++) {
+              const c = normalizedInput[i]!;
+              peq[c] = (peq[c] || 0) | (1 << i);
+            }
+
+            let pv = -1;
+            let mv = 0;
+            let score = lenA;
+
+            for (let j = 0; j < lenB; j++) {
+              const eq = peq[normalizedOption[j]!] || 0;
+              const xv = eq | mv;
+              const xh = ((eq & pv) + pv) ^ pv ^ eq;
+              let ph = mv | ~(xh | pv);
+              let mh = pv & xh;
+
+              if ((ph >>> (lenA - 1)) & 1) {
+                score++;
+              }
+              if ((mh >>> (lenA - 1)) & 1) {
+                score--;
+              }
+
+              ph = (ph << 1) | 1;
+              mh = mh << 1;
+              pv = mh | ~(xv | ph);
+              mv = ph & xv;
+            }
+
+            distance = score;
+          } else {
+            const row = new Array(lenB + 1);
+            for (let j = 0; j <= lenB; j++) {
+              row[j] = j;
+            }
+
+            for (let i = 1; i <= lenA; i++) {
+              let prev = i;
+              for (let j = 1; j <= lenB; j++) {
+                const val = normalizedInput[i - 1] === normalizedOption[j - 1]
+                  ? row[j - 1]
+                  : Math.min(row[j - 1], prev, row[j]) + 1;
+                row[j - 1] = prev;
+                prev = val;
+              }
+              row[lenB] = prev;
+            }
+
+            distance = row[lenB];
+          }
+
+          if (distance <= threshold) {
+            results.push({ option, distance });
+          }
+        }
+
+        return results.sort((a, b) => a.distance - b.distance).map(r => r.option);
+        `)
+				];
+			}
+		})
+	];
+}
+/**
 * Generates utilities for detecting terminal color support.
 */
 function EnvSupportUtilities() {
@@ -894,6 +1095,8 @@ function UtilsBuiltin(props) {
 				createComponent(Spacing, {}),
 				createComponent(SpawnFunctionDeclaration, {}),
 				createComponent(Spacing, {}),
+				createComponent(FindSuggestionsDeclaration, {}),
+				createComponent(Spacing, {}),
 				createComponent(Show, {
 					get when() {
 						return Boolean(children);
@@ -906,5 +1109,5 @@ function UtilsBuiltin(props) {
 }
 
 //#endregion
-export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin };
+export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin };
 //# sourceMappingURL=utils-builtin.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.mjs","names":["code","Show","splitProps","FunctionDeclaration","InterfaceDeclaration","InterfaceMember","TypeDeclaration","VarDeclaration","Spacing","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","defu","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","SpawnFunctionDeclaration","async","optional","ContextUtilities","UtilsBuiltin","props","rest","_$mergeProps","id","description","imports","alias","builtinImports","console","env","when","Boolean"],"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  InterfaceDeclaration,\n  InterfaceMember,\n  TypeDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\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\";\n\nexport interface UtilsBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\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 utilities for detecting terminal color support.\n */\nexport function ArgsUtilities() {\n  return (\n    <>\n      <TSDoc heading=\"Retrieves the command-line arguments from Deno or Node.js environments.\">\n        <TSDocRemarks>\n          {\n            \"This function is only intended for internal use. Please use `useArgs()` instead.\"\n          }\n        </TSDocRemarks>\n        <hbr />\n        <hbr />\n        <TSDocInternal />\n        <hbr />\n        <hbr />\n        <TSDocReturns>\n          {\n            \"An array of command-line arguments from Deno or Node.js environments.\"\n          }\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration export name=\"getArgs\" returnType=\"string[]\">\n        {code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`}\n      </FunctionDeclaration>\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          {\n            'The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\".'\n          }\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=\"hasFlag\"\n        parameters={[\n          { name: \"flag\", type: \"string | string[]\" },\n          {\n            name: \"argv\",\n            type: \"string[]\",\n            default: \"useArgs()\"\n          }\n        ]}>\n        <VarDeclaration\n          const\n          name=\"position\"\n          type=\"number\"\n          initializer={code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {\n            const pos = argv.findIndex(arg => (f.startsWith(\"-\") ? \"\" : (f.length === 1 ? \"-\" : \"--\") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? \"-\" : \"--\") + f + \"=\"));\n            return pos !== -1 ? pos : ret;\n          }, -1);`}\n        />\n        <hbr />\n        {code`return position !== -1 && argv.indexOf(\"--\") === -1 || position < argv.indexOf(\"--\");`}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        name=\"isHelp\"\n        type=\"boolean\"\n        initializer={code` !isCI && hasFlag([\"help\", \"h\", \"?\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.\n */\nexport function SpawnFunctionDeclaration() {\n  return (\n    <>\n      <FunctionDeclaration\n        async\n        name=\"resolveCommand\"\n        parameters={[\n          {\n            name: \"command\",\n            type: \"string\"\n          },\n          {\n            name: \"options\",\n            type: \"Record<string, any>\",\n            default: \"{}\"\n          },\n          {\n            name: \"pathExt\",\n            type: \"string\",\n            default:\n              'process.env.PATHEXT || [\".EXE\", \".CMD\", \".BAT\", \".COM\"].join(delimiter)'\n          }\n        ]}>\n        {code`const env = options.env || process.env;\n        const cwd = process.cwd();\n        if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n          try {\n            process.chdir(options.cwd);\n          } catch (err) {\n            // Do nothing\n          }\n        }\n\n        let resolved;\n        try {\n          let extensions = [\"\"];\n          if (isWindows) {\n            extensions = pathExt.split(delimiter).flatMap((item) => [item, item.toLowerCase()]);\n            if (command.includes(\".\") && extensions[0] !== \"\") {\n              extensions.unshift(\"\");\n            }\n          }\n\n          for (const envPart of (command.match(new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\"))))\n            ? [...(isWindows ? [process.cwd()] : []), ...(process.env.PATH || \"\").split(delimiter)]\n            : [\"\"]\n          ) {\n            const part =  \\`\\${!(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart) && new RegExp(\\`^\\\\.\\${new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\")).source}\\`).test(command) ? command.slice(0, 2) : \"\"}\\${join(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart, command)}\\`;\n            for (const extension of extensions) {\n              if (isWindows) {\n                const filePath = part + extension;\n                if ((await stat(filePath)).isFile() && extensions.some((ext) => filePath.substring(filePath.length - ext.length).toLowerCase() === ext.toLowerCase())) {\n                  resolved = filePath;\n                  break;\n                }\n              } else {\n                const file = await stat(part + extension);\n                if (file.isFile() && (file.mode & 0o111) !== 0) {\n                  resolved = part + extension;\n                  break;\n                }\n              }\n            }\n          }\n        } catch (err) {\n          // Do nothing\n        } finally {\n          if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n            process.chdir(cwd);\n          }\n        }\n\n\n        if (resolved) {\n          resolved = resolve(\n            options.cwd ? options.cwd : \"\",\n            resolved\n          );\n        }\n\n        return resolved; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        name=\"SpawnBaseOptions\"\n        doc=\"Options for the `spawn` handler function.\">\n        <InterfaceMember\n          name=\"stdout\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt output, defaults to process.stdout\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"stderr\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt error output, defaults to process.stderr\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"rejectOnError\"\n          optional\n          type=\"boolean\"\n          doc=\"Whether to reject the promise on error. Defaults to false.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"file\"\n          optional\n          type=\"string\"\n          doc=\"The file to execute.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"shell\"\n          optional\n          type=\"boolean | string\"\n          doc=\"If true, runs command inside of a shell. Uses '/bin/sh' on UNIX, and process.env.ComSpec on Windows. If a string is provided, it specifies the shell to use.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"forceShell\"\n          optional\n          type=\"boolean\"\n          doc=\"If true, forces the command to run inside of a shell, even if the command is a file.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TypeDeclaration export name=\"SpawnOptions\">\n        {code`SpawnBaseOptions & Parameters<typeof _spawn>[1]`}\n      </TypeDeclaration>\n      <Spacing />\n      <TSDoc heading=\"A function to spawn child processes with proper color support and environment variable handling.\">\n        <TSDocParam name=\"command\">{`The command to execute.`}</TSDocParam>\n        <TSDocParam name=\"args\">\n          {`The command-line arguments to pass to the command. Defaults to an empty array.`}\n        </TSDocParam>\n        <TSDocParam name=\"options\">\n          {`Additional options for spawning the process, such as the current working directory (\\`cwd\\`).`}\n        </TSDocParam>\n        <TSDocReturns>{`The result of the spawned process.`}</TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"spawn\"\n        parameters={[\n          { name: \"command\", type: \"string\" },\n          {\n            name: \"args\",\n            type: \"string[] | SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          },\n          {\n            name: \"options\",\n            type: \"SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          }\n        ]}>\n        {code`const normalized = {\n          command,\n          args: [] as string[],\n          options: options as SpawnOptions | any,\n          file: undefined as string | undefined,\n          original: {\n            command,\n            args,\n          },\n        };\n\n        if (args) {\n          if (Array.isArray(args)) {\n            if (args.length > 0) {\n              normalized.args = args.slice(0);\n            }\n          } else {\n            normalized.options = { ...args } as SpawnOptions | any;\n            normalized.args = [];\n          }\n        }\n\n        if (!normalized.options.shell && isWindows) {\n          normalized.file = (await resolveCommand(normalized.command, normalized.options)) || (await resolveCommand(normalized.command, normalized.options, delimiter));\n\n          let commandFile = normalized.file;\n          if (normalized.file) {\n            let shebang: string | undefined;\n            const buffer = Buffer.alloc(150);\n\n            try {\n              const fd = openSync(normalized.file, \"r\");\n              await promisify(read)(fd, buffer, 0, 150, 0);\n              closeSync(fd);\n            } catch (err) {\n              // Do nothing\n            }\n\n            const matched = buffer.toString().match(/^#!(.*)/);\n            if (matched) {\n              const [path, argument] = matched[0].replace(/#! ?/, \"\").split(\" \");\n\t            const binary = path.split(\"/\").pop();\n              if (binary === \"env\") {\n                shebang = argument;\n              } else {\n                shebang = argument ? \\`\\${binary} \\${argument}\\` : binary;\n              }\n            }\n\n            if (shebang) {\n              normalized.args.unshift(normalized.file);\n              normalized.command = shebang;\n\n              commandFile = await resolveCommand(normalized.command, normalized.options);\n            }\n          }\n\n          if (commandFile && (normalized.options.forceShell || /\\\\.(?:com|exe)$/i.test(commandFile))) {\n            normalized.command = normalize(normalized.command).replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\");\n\n            normalized.args = [\"/d\", \"/s\", \"/c\", \\`\"\\${normalized.command} \\${normalized.args.map(arg =>\n              \\`\\${arg}\\`.replace(/(?=(\\\\\\\\+?)?)\\\\1\"/g, \"$1$1\\\\\"\").replace(/(?=(\\\\\\\\+?)?)\\\\1$/, \"$1$1\")\n            ).map(arg =>\n              \\`\"\\${arg}\"\\`.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\")\n            ).map(arg =>\n              /node_modules[\\\\\\\\/].bin[\\\\\\\\/][^\\\\\\\\/]+\\\\.cmd$/i.test(commandFile) ? arg.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\") : arg\n            ).join(\" \")}\"\\`];\n            normalized.command = process.env.comspec || \"cmd.exe\";\n            normalized.options.windowsVerbatimArguments = true;\n          }\n        }\n\n        let stdout = \"\";\n        let stderr = \"\";\n\n        const child = _spawn(normalized.command, normalized.args, {\n          cwd: process.cwd(),\n          env: {\n            ...process.env,\n            FORCE_COLOR: isColorSupported ? \"1\" : \"0\",\n          },\n          ...normalized.options,\n        }) as ReturnType<typeof _spawn>;\n\n        if (isWindows) {\n          const emit = child.emit;\n          child.emit = (eventName: string | symbol, ...eventArgs: any[]) => {\n            if (eventName === \"exit\") {\n              let err: Error | null = null;\n              if (eventArgs[0] === 1 && !normalized.file) {\n                err = Object.assign(new Error(\\`spawn \\${normalized.original.command} ENOENT\\`), {\n                  code: \"ENOENT\",\n                  errno: \"ENOENT\",\n                  syscall: \\`spawn \\${normalized.original.command}\\`,\n                  path: normalized.original.command,\n                  spawnargs: normalized.original.args,\n                });\n              }\n\n              if (err) {\n                return emit.call(child, \"error\", err);\n              }\n            }\n\n            return emit.apply(child, [eventName, ...eventArgs]);\n          };\n        }\n\n        return new Promise((resolve, reject) => {\n          if (normalized.options.stdin !== undefined) {\n            child.stdin?.write(normalized.options.stdin);\n          }\n\n          child.stdin?.end();\n\n          child.stdout?.on(\"data\", data => {\n            stdout += data;\n            if (normalized.options.stdout) {\n              normalized.options.stdout(data);\n            }\n          });\n\n          child.stderr?.on(\"data\", data => {\n            stderr += data;\n            if (normalized.options.stderr) {\n              normalized.options.stderr(data);\n            }\n          });\n\n          if (normalized.options.rejectOnError) {\n            child.addListener(\"error\", reject);\n          }\n\n          child.on(\"close\", code => {\n            if (code !== 0 && normalized.options.rejectOnError) {\n              reject(stderr);\n            } else {\n              resolve({ stdout, stderr });\n            }\n          });\n        }); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport function ContextUtilities() {\n  return code`\n  /**\n   * The global Shell Shock - Application context instance.\n   *\n   * @internal\n   */\n  export let internal_appContext = new AsyncLocalStorage<Map<string, any>>();\n\n  /**\n   * Get the Shell Shock - Application context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Application context for the current application or undefined if the context is not available.\n   */\n  export function useApp(): Map<string, any> | undefined {\n    return internal_appContext.getStore();\n  }\n\n  /**\n   * A utility hook function to get the command line arguments from the application context.\n   *\n   * @returns An array of command-line arguments from the application context.\n   * @throws If the application context is not available.\n   */\n  export function useArgs(): string[] {\n    return useApp()?.get(\"args\") ?? getArgs();\n  }\n\n  /**\n   * The context object for the current command execution, containing the command path and segments.\n   */\n  export interface CommandContext {\n    path: string;\n    segments: string[];\n  }\n\n  /**\n   * The global Shell Shock - Command context instance.\n   *\n   * @internal\n   */\n  export let internal_commandContext = new AsyncLocalStorage<CommandContext>();\n\n  /**\n   * Get the Shell Shock - Command context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Command context for the current application.\n   * @throws If the Shell Shock - Command context is not available.\n   */\n  export function useCommand(): CommandContext {\n    const result = internal_commandContext.getStore();\n    if (!result) {\n      throw new Error(\n        \\`The Shell Shock - Command context is not available. Make sure to call useCommand() within a valid context scope.\\`\n      );\n    }\n    return result;\n  }\n\n  /**\n   * A utility hook function to get the individual segments of the current command path.\n   *\n   * @returns An array of command path segments.\n   * @throws If the command context is not available.\n   */\n  export function useSegments(): string[] {\n    return useCommand().segments;\n  }\n\n  /**\n   * A utility hook function to get the full command path as a string.\n   *\n   * @returns The full command path as a string.\n   * @throws If the command context is not available.\n   */\n  export function usePath(): string {\n    return useCommand().path;\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        ],\n        \"node:fs\": [\"openSync\", \"closeSync\", \"read\"],\n        \"node:fs/promises\": [\"stat\"],\n        \"node:util\": [\"promisify\"],\n        \"node:child_process\": [{ name: \"spawn\", alias: \"_spawn\" }],\n        \"node:async_hooks\": [\"AsyncLocalStorage\"]\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\"env\", \"isCI\", \"isTest\", \"isWindows\", \"isDevelopment\", \"isDebug\"]\n      })}>\n      <Spacing />\n      <ContextUtilities />\n      <Spacing />\n      <ArgsUtilities />\n      <Spacing />\n      <EnvSupportUtilities />\n      <Spacing />\n      <HyperlinkSupportUtilities />\n      <Spacing />\n      <ColorSupportUtilities />\n      <Spacing />\n      <SpawnFunctionDeclaration />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils-builtin.mjs","names":["code","Show","splitProps","FunctionDeclaration","InterfaceDeclaration","InterfaceMember","TypeDeclaration","VarDeclaration","Spacing","usePowerlines","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","defu","FindSuggestionsDeclaration","context","_$createComponent","name","initializer","heading","children","_$createIntrinsic","parameters","type","returnType","config","isCaseSensitive","_$memo","EnvSupportUtilities","doc","ColorSupportUtilities","default","HyperlinkSupportUtilities","ArgsUtilities","SpawnFunctionDeclaration","async","optional","ContextUtilities","UtilsBuiltin","props","rest","_$mergeProps","id","description","imports","alias","builtinImports","console","env","when","Boolean"],"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  InterfaceDeclaration,\n  InterfaceMember,\n  TypeDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/dist/core/contexts/context.mjs\";\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        <hbr />\n        <hbr />\n        <TSDocInternal />\n        <hbr />\n        <hbr />\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 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 utilities for detecting terminal color support.\n */\nexport function ArgsUtilities() {\n  return (\n    <>\n      <TSDoc heading=\"Retrieves the command-line arguments from Deno or Node.js environments.\">\n        <TSDocRemarks>\n          {\n            \"This function is only intended for internal use. Please use `useArgs()` instead.\"\n          }\n        </TSDocRemarks>\n        <hbr />\n        <hbr />\n        <TSDocInternal />\n        <hbr />\n        <hbr />\n        <TSDocReturns>\n          {\n            \"An array of command-line arguments from Deno or Node.js environments.\"\n          }\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration export name=\"getArgs\" returnType=\"string[]\">\n        {code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`}\n      </FunctionDeclaration>\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          {\n            'The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\".'\n          }\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=\"hasFlag\"\n        parameters={[\n          { name: \"flag\", type: \"string | string[]\" },\n          {\n            name: \"argv\",\n            type: \"string[]\",\n            default: \"useArgs()\"\n          }\n        ]}>\n        <VarDeclaration\n          const\n          name=\"position\"\n          type=\"number\"\n          initializer={code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {\n            const pos = argv.findIndex(arg => (f.startsWith(\"-\") ? \"\" : (f.length === 1 ? \"-\" : \"--\") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? \"-\" : \"--\") + f + \"=\"));\n            return pos !== -1 ? pos : ret;\n          }, -1);`}\n        />\n        <hbr />\n        {code`return position !== -1 && argv.indexOf(\"--\") === -1 || position < argv.indexOf(\"--\");`}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        name=\"isHelp\"\n        type=\"boolean\"\n        initializer={code` !isCI && hasFlag([\"help\", \"h\", \"?\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.\n */\nexport function SpawnFunctionDeclaration() {\n  return (\n    <>\n      <FunctionDeclaration\n        async\n        name=\"resolveCommand\"\n        parameters={[\n          {\n            name: \"command\",\n            type: \"string\"\n          },\n          {\n            name: \"options\",\n            type: \"Record<string, any>\",\n            default: \"{}\"\n          },\n          {\n            name: \"pathExt\",\n            type: \"string\",\n            default:\n              'process.env.PATHEXT || [\".EXE\", \".CMD\", \".BAT\", \".COM\"].join(delimiter)'\n          }\n        ]}>\n        {code`const env = options.env || process.env;\n        const cwd = process.cwd();\n        if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n          try {\n            process.chdir(options.cwd);\n          } catch (err) {\n            // Do nothing\n          }\n        }\n\n        let resolved;\n        try {\n          let extensions = [\"\"];\n          if (isWindows) {\n            extensions = pathExt.split(delimiter).flatMap((item) => [item, item.toLowerCase()]);\n            if (command.includes(\".\") && extensions[0] !== \"\") {\n              extensions.unshift(\"\");\n            }\n          }\n\n          for (const envPart of (command.match(new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\"))))\n            ? [...(isWindows ? [process.cwd()] : []), ...(process.env.PATH || \"\").split(delimiter)]\n            : [\"\"]\n          ) {\n            const part =  \\`\\${!(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart) && new RegExp(\\`^\\\\.\\${new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\")).source}\\`).test(command) ? command.slice(0, 2) : \"\"}\\${join(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart, command)}\\`;\n            for (const extension of extensions) {\n              if (isWindows) {\n                const filePath = part + extension;\n                if ((await stat(filePath)).isFile() && extensions.some((ext) => filePath.substring(filePath.length - ext.length).toLowerCase() === ext.toLowerCase())) {\n                  resolved = filePath;\n                  break;\n                }\n              } else {\n                const file = await stat(part + extension);\n                if (file.isFile() && (file.mode & 0o111) !== 0) {\n                  resolved = part + extension;\n                  break;\n                }\n              }\n            }\n          }\n        } catch (err) {\n          // Do nothing\n        } finally {\n          if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n            process.chdir(cwd);\n          }\n        }\n\n\n        if (resolved) {\n          resolved = resolve(\n            options.cwd ? options.cwd : \"\",\n            resolved\n          );\n        }\n\n        return resolved; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        name=\"SpawnBaseOptions\"\n        doc=\"Options for the `spawn` handler function.\">\n        <InterfaceMember\n          name=\"stdout\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt output, defaults to process.stdout\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"stderr\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt error output, defaults to process.stderr\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"rejectOnError\"\n          optional\n          type=\"boolean\"\n          doc=\"Whether to reject the promise on error. Defaults to false.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"file\"\n          optional\n          type=\"string\"\n          doc=\"The file to execute.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"shell\"\n          optional\n          type=\"boolean | string\"\n          doc=\"If true, runs command inside of a shell. Uses '/bin/sh' on UNIX, and process.env.ComSpec on Windows. If a string is provided, it specifies the shell to use.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"forceShell\"\n          optional\n          type=\"boolean\"\n          doc=\"If true, forces the command to run inside of a shell, even if the command is a file.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TypeDeclaration export name=\"SpawnOptions\">\n        {code`SpawnBaseOptions & Parameters<typeof _spawn>[1]`}\n      </TypeDeclaration>\n      <Spacing />\n      <TSDoc heading=\"A function to spawn child processes with proper color support and environment variable handling.\">\n        <TSDocParam name=\"command\">{`The command to execute.`}</TSDocParam>\n        <TSDocParam name=\"args\">\n          {`The command-line arguments to pass to the command. Defaults to an empty array.`}\n        </TSDocParam>\n        <TSDocParam name=\"options\">\n          {`Additional options for spawning the process, such as the current working directory (\\`cwd\\`).`}\n        </TSDocParam>\n        <TSDocReturns>{`The result of the spawned process.`}</TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"spawn\"\n        parameters={[\n          { name: \"command\", type: \"string\" },\n          {\n            name: \"args\",\n            type: \"string[] | SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          },\n          {\n            name: \"options\",\n            type: \"SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          }\n        ]}>\n        {code`const normalized = {\n          command,\n          args: [] as string[],\n          options: options as SpawnOptions | any,\n          file: undefined as string | undefined,\n          original: {\n            command,\n            args,\n          },\n        };\n\n        if (args) {\n          if (Array.isArray(args)) {\n            if (args.length > 0) {\n              normalized.args = args.slice(0);\n            }\n          } else {\n            normalized.options = { ...args } as SpawnOptions | any;\n            normalized.args = [];\n          }\n        }\n\n        if (!normalized.options.shell && isWindows) {\n          normalized.file = (await resolveCommand(normalized.command, normalized.options)) || (await resolveCommand(normalized.command, normalized.options, delimiter));\n\n          let commandFile = normalized.file;\n          if (normalized.file) {\n            let shebang: string | undefined;\n            const buffer = Buffer.alloc(150);\n\n            try {\n              const fd = openSync(normalized.file, \"r\");\n              await promisify(read)(fd, buffer, 0, 150, 0);\n              closeSync(fd);\n            } catch (err) {\n              // Do nothing\n            }\n\n            const matched = buffer.toString().match(/^#!(.*)/);\n            if (matched) {\n              const [path, argument] = matched[0].replace(/#! ?/, \"\").split(\" \");\n\t            const binary = path.split(\"/\").pop();\n              if (binary === \"env\") {\n                shebang = argument;\n              } else {\n                shebang = argument ? \\`\\${binary} \\${argument}\\` : binary;\n              }\n            }\n\n            if (shebang) {\n              normalized.args.unshift(normalized.file);\n              normalized.command = shebang;\n\n              commandFile = await resolveCommand(normalized.command, normalized.options);\n            }\n          }\n\n          if (commandFile && (normalized.options.forceShell || /\\\\.(?:com|exe)$/i.test(commandFile))) {\n            normalized.command = normalize(normalized.command).replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\");\n\n            normalized.args = [\"/d\", \"/s\", \"/c\", \\`\"\\${normalized.command} \\${normalized.args.map(arg =>\n              \\`\\${arg}\\`.replace(/(?=(\\\\\\\\+?)?)\\\\1\"/g, \"$1$1\\\\\"\").replace(/(?=(\\\\\\\\+?)?)\\\\1$/, \"$1$1\")\n            ).map(arg =>\n              \\`\"\\${arg}\"\\`.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\")\n            ).map(arg =>\n              /node_modules[\\\\\\\\/].bin[\\\\\\\\/][^\\\\\\\\/]+\\\\.cmd$/i.test(commandFile) ? arg.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\") : arg\n            ).join(\" \")}\"\\`];\n            normalized.command = process.env.comspec || \"cmd.exe\";\n            normalized.options.windowsVerbatimArguments = true;\n          }\n        }\n\n        let stdout = \"\";\n        let stderr = \"\";\n\n        const child = _spawn(normalized.command, normalized.args, {\n          cwd: process.cwd(),\n          env: {\n            ...process.env,\n            FORCE_COLOR: isColorSupported ? \"1\" : \"0\",\n          },\n          ...normalized.options,\n        }) as ReturnType<typeof _spawn>;\n\n        if (isWindows) {\n          const emit = child.emit;\n          child.emit = (eventName: string | symbol, ...eventArgs: any[]) => {\n            if (eventName === \"exit\") {\n              let err: Error | null = null;\n              if (eventArgs[0] === 1 && !normalized.file) {\n                err = Object.assign(new Error(\\`spawn \\${normalized.original.command} ENOENT\\`), {\n                  code: \"ENOENT\",\n                  errno: \"ENOENT\",\n                  syscall: \\`spawn \\${normalized.original.command}\\`,\n                  path: normalized.original.command,\n                  spawnargs: normalized.original.args,\n                });\n              }\n\n              if (err) {\n                return emit.call(child, \"error\", err);\n              }\n            }\n\n            return emit.apply(child, [eventName, ...eventArgs]);\n          };\n        }\n\n        return new Promise((resolve, reject) => {\n          if (normalized.options.stdin !== undefined) {\n            child.stdin?.write(normalized.options.stdin);\n          }\n\n          child.stdin?.end();\n\n          child.stdout?.on(\"data\", data => {\n            stdout += data;\n            if (normalized.options.stdout) {\n              normalized.options.stdout(data);\n            }\n          });\n\n          child.stderr?.on(\"data\", data => {\n            stderr += data;\n            if (normalized.options.stderr) {\n              normalized.options.stderr(data);\n            }\n          });\n\n          if (normalized.options.rejectOnError) {\n            child.addListener(\"error\", reject);\n          }\n\n          child.on(\"close\", code => {\n            if (code !== 0 && normalized.options.rejectOnError) {\n              reject(stderr);\n            } else {\n              resolve({ stdout, stderr });\n            }\n          });\n        }); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport function ContextUtilities() {\n  return code`\n  /**\n   * The global Shell Shock - Application context instance.\n   *\n   * @internal\n   */\n  export let internal_appContext = new AsyncLocalStorage<Map<string, any>>();\n\n  /**\n   * Get the Shell Shock - Application context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Application context for the current application or undefined if the context is not available.\n   */\n  export function useApp(): Map<string, any> | undefined {\n    return internal_appContext.getStore();\n  }\n\n  /**\n   * A utility hook function to get the command line arguments from the application context.\n   *\n   * @returns An array of command-line arguments from the application context.\n   * @throws If the application context is not available.\n   */\n  export function useArgs(): string[] {\n    return useApp()?.get(\"args\") ?? getArgs();\n  }\n\n  /**\n   * The context object for the current command execution, containing the command path and segments.\n   */\n  export interface CommandContext {\n    path: string;\n    segments: string[];\n  }\n\n  /**\n   * The global Shell Shock - Command context instance.\n   *\n   * @internal\n   */\n  export let internal_commandContext = new AsyncLocalStorage<CommandContext>();\n\n  /**\n   * Get the Shell Shock - Command context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Command context for the current application.\n   * @throws If the Shell Shock - Command context is not available.\n   */\n  export function useCommand(): CommandContext {\n    const result = internal_commandContext.getStore();\n    if (!result) {\n      throw new Error(\n        \\`The Shell Shock - Command context is not available. Make sure to call useCommand() within a valid context scope.\\`\n      );\n    }\n    return result;\n  }\n\n  /**\n   * A utility hook function to get the individual segments of the current command path.\n   *\n   * @returns An array of command path segments.\n   * @throws If the command context is not available.\n   */\n  export function useSegments(): string[] {\n    return useCommand().segments;\n  }\n\n  /**\n   * A utility hook function to get the full command path as a string.\n   *\n   * @returns The full command path as a string.\n   * @throws If the command context is not available.\n   */\n  export function usePath(): string {\n    return useCommand().path;\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        ],\n        \"node:fs\": [\"openSync\", \"closeSync\", \"read\"],\n        \"node:fs/promises\": [\"stat\"],\n        \"node:util\": [\"promisify\"],\n        \"node:child_process\": [{ name: \"spawn\", alias: \"_spawn\" }],\n        \"node:async_hooks\": [\"AsyncLocalStorage\"]\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\"env\", \"isCI\", \"isTest\", \"isWindows\", \"isDevelopment\", \"isDebug\"]\n      })}>\n      <Spacing />\n      <ContextUtilities />\n      <Spacing />\n      <ArgsUtilities />\n      <Spacing />\n      <EnvSupportUtilities />\n      <Spacing />\n      <HyperlinkSupportUtilities />\n      <Spacing />\n      <ColorSupportUtilities />\n      <Spacing />\n      <SpawnFunctionDeclaration />\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/helpers/docs-helpers.cjs

@@ -9,7 +9,7 @@ let __stryke_path_join = require("@stryke/path/join");
 * @returns The output path for the generated documentation.
 */
 function getDocsOutputPath(context) {
-	return (0, __stryke_path_join.joinPaths)(context.config.projectRoot, "docs", "generated");
+	return (0, __stryke_path_join.joinPaths)(context.config.root, "docs", "generated");
 }
 getDocsOutputPath.__type = [
 	"Context",

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

@@ -1 +1 @@
-{"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.projectRoot, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,kBAAkB,SAAS;AACvC,0CAAiB,QAAQ,OAAO,aAAa,QAAQ,YAAE;;AAE3D,kBAAkB,SAAS;CAAC;CAAW;CAAW;CAAU;CAAA"}
+{"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,SAAgB,kBAAkB,SAAS;AACvC,0CAAiB,QAAQ,OAAO,MAAM,QAAQ,YAAS;;AAE3D,kBAAkB,SAAS;CAAC;CAAW;CAAW;CAAU;CAAA"}

package/dist/helpers/docs-helpers.mjs

@@ -8,7 +8,7 @@ import { joinPaths } from "@stryke/path/join";
 * @returns The output path for the generated documentation.
 */
 function getDocsOutputPath(context) {
-	return joinPaths(context.config.projectRoot, "docs", "generated");
+	return joinPaths(context.config.root, "docs", "generated");
 }
 getDocsOutputPath.__type = [
 	"Context",

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

@@ -1 +1 @@
-{"version":3,"file":"docs-helpers.mjs","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.projectRoot, \"docs\", \"generated\");\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,kBAAkB,SAAS;AACvC,QAAO,UAAU,QAAQ,OAAO,aAAa,QAAQ,YAAE;;AAE3D,kBAAkB,SAAS;CAAC;CAAW;CAAW;CAAU;CAAA"}
+{"version":3,"file":"docs-helpers.mjs","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,SAAgB,kBAAkB,SAAS;AACvC,QAAO,UAAU,QAAQ,OAAO,MAAM,QAAQ,YAAS;;AAE3D,kBAAkB,SAAS;CAAC;CAAW;CAAW;CAAU;CAAA"}

package/dist/helpers/resolve-command.cjs

@@ -4,17 +4,20 @@ const require_utilities = require('./utilities.cjs');
 let __stryke_convert_to_array = require("@stryke/convert/to-array");
 let __stryke_path_append = require("@stryke/path/append");
 let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
 let __stryke_path_replace = require("@stryke/path/replace");
 let __stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
 let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let powerlines_utils = require("powerlines/utils");
 let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let __powerlines_deepkit_esbuild_plugin = require("@powerlines/deepkit/esbuild-plugin");
+let __powerlines_plugin_esbuild_helpers_resolve = require("@powerlines/plugin-esbuild/helpers/resolve");
 let __stryke_path_common = require("@stryke/path/common");
 let __stryke_path_normalize = require("@stryke/path/normalize");
-let powerlines_lib_utilities_resolve = require("powerlines/lib/utilities/resolve");
+let node_fs = require("node:fs");
 
 //#region src/helpers/resolve-command.ts
 function __assignType(fn, args) {
@@ -138,14 +141,31 @@ resolveCommandDynamicPathSegments.__type = [
 	"P\"w!2\"&2#&F/$"
 ];
 function findCommandsRoot(context) {
-	if ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.entry)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
-	else if ((0, __stryke_type_checks_is_set_object.isSetObject)(context.config.entry) && "file" in context.config.entry) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot);
-	else if (Array.isArray(context.config.entry) && context.config.entry.length > 0) return (0, __stryke_path_common.commonPath)(context.config.entry.map(__assignType((entry) => (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)((0, __stryke_type_checks_is_set_string.isSetString)(entry) ? entry : entry.file), context.config.projectRoot), context.workspaceConfig.workspaceRoot), [
-		"entry",
+	if ((0, __stryke_type_checks_is_set_string.isSetString)(context.config.input)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.input), context.config.root), context.workspaceConfig.workspaceRoot);
+	else if ((0, powerlines_utils.isTypeDefinition)(context.config.input)) return (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)(context.config.input.file), context.config.root), context.workspaceConfig.workspaceRoot);
+	else if (Array.isArray(context.config.input) && context.config.input.length > 0) return (0, __stryke_path_common.commonPath)(context.config.input.map(__assignType((input) => (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)((0, __stryke_type_checks_is_set_string.isSetString)(input) ? input : input.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"input",
 		"",
 		"P\"2!\"/\""
 	])));
-	return (0, __stryke_path_append.appendPath)(context.config.sourceRoot || context.config.projectRoot, context.workspaceConfig.workspaceRoot);
+	else if ((0, __stryke_type_checks_is_set_object.isSetObject)(context.config.input)) return (0, __stryke_path_common.commonPath)(Object.values(context.config.input).map(__assignType((input) => Array.isArray(input) ? (0, __stryke_path_common.commonPath)(input.map(__assignType((i) => (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)((0, __stryke_type_checks_is_set_string.isSetString)(i) ? i : i.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"i",
+		"",
+		"P\"2!\"/\""
+	]))) : (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)((0, __stryke_path_normalize.stripStars)((0, __stryke_type_checks_is_set_string.isSetString)(input) ? input : input.file), context.config.root), context.workspaceConfig.workspaceRoot), [
+		"input",
+		"",
+		"P\"2!\"/\""
+	])));
+	let commandsPath = (0, __stryke_path_join_paths.joinPaths)(context.config.root, "src/commands");
+	if (!(0, node_fs.existsSync)(commandsPath)) {
+		commandsPath = (0, __stryke_path_join_paths.joinPaths)(context.config.root, "commands");
+		if (!(0, node_fs.existsSync)(commandsPath)) {
+			commandsPath = (0, __stryke_path_join_paths.joinPaths)(context.config.root, "src");
+			if (!(0, node_fs.existsSync)(commandsPath)) commandsPath = context.config.root;
+		}
+	}
+	return (0, __stryke_path_append.appendPath)(commandsPath, context.workspaceConfig.workspaceRoot);
 }
 findCommandsRoot.__type = [
 	"Context",
@@ -251,7 +271,7 @@ async function reflectCommandTree(context, command, parent) {
 	if (!command.isVirtual) {
 		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
 		context.debug(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
-		const resolved = await (powerlines_lib_utilities_resolve.resolveModule.Ω = [["CommandModule", "\"w!"]], (0, powerlines_lib_utilities_resolve.resolveModule)(context, command.entry.input, { plugins: [(0, __powerlines_deepkit_esbuild_plugin.esbuildPlugin)(context, {
+		const resolved = await (__powerlines_plugin_esbuild_helpers_resolve.resolveModule.Ω = [["CommandModule", "\"w!"]], (0, __powerlines_plugin_esbuild_helpers_resolve.resolveModule)(context, command.entry.input, { plugins: [(0, __powerlines_deepkit_esbuild_plugin.esbuildPlugin)(context, {
 			reflection: "default",
 			reflectionLevel: "verbose"
 		})] }));