@shell-shock/core 0.16.1 → 0.17.0

package/dist/components/utils-builtin.cjs

@@ -210,6 +210,142 @@ function FindSuggestionsDeclaration() {
 	];
 }
 /**
+* Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).
+*/
+function TerminalSizeDeclaration() {
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "DEFAULT_TERMINAL_COLUMNS",
+			doc: "Default number of terminal columns",
+			initializer: _alloy_js_core.code`80`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "DEFAULT_TERMINAL_ROWS",
+			doc: "Default number of terminal rows",
+			initializer: _alloy_js_core.code`24`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			name: "isForegroundProcess",
+			children: _alloy_js_core.code`if (isLinux) {
+          return true;
+        }
+
+        try {
+          const statContents = readFileSync("/proc/self/stat", "utf8");
+          const closingParenthesisIndex = statContents.lastIndexOf(') ');
+
+          if (closingParenthesisIndex === -1) {
+            return false;
+          }
+
+          const statFields = statContents.slice(closingParenthesisIndex + 2).trim().split(/\\s+/);
+          const processGroupId = Number.parseInt(statFields[2], 10);
+          const foregroundProcessGroupId = Number.parseInt(statFields[5], 10);
+
+          if (Number.isNaN(processGroupId) || Number.isNaN(foregroundProcessGroupId)) {
+            return false;
+          }
+
+          if (foregroundProcessGroupId <= 0) {
+            return false;
+          }
+
+          return processGroupId === foregroundProcessGroupId;
+        } catch {
+          return false;
+        } `
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			name: "tput",
+			children: _alloy_js_core.code`try {
+            const columns = execSync(["tput", "cols"], { env: { TERM: 'dumb', ...process.env } });
+            const rows = execSync(["tput", "lines"], { env: { TERM: 'dumb', ...process.env } });
+
+            if (columns && rows) {
+              return { columns: Number.parseInt(columns.toString().trim(), 10), rows: Number.parseInt(rows.toString().trim(), 10) };
+            }
+          } catch {}  `
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			name: "devTty",
+			children: _alloy_js_core.code`try {
+            return tty.WriteStream(openSync("/dev/tty", isMacOS ? fsConstants.O_NONBLOCK : fsConstants.O_NONBLOCK));
+          } catch {}  `
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "A utility function that attempts to determine the size of the terminal (number of columns and rows) using various methods, and falls back to default values if it cannot be determined. This can be used to adjust output formatting based on the available terminal size.",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: "The function first checks if the process is running in a TTY environment and if the stdout or stderr streams provide column and row information. If not, it attempts to use platform-specific methods (like reading from /proc/self/stat on Linux, using tput on Unix-like systems, or checking /dev/tty) to determine the terminal size. If all else fails, it returns default values." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An object containing the number of columns and rows of the terminal." })
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "getTerminalSize",
+			returnType: "{ columns: number; rows: number; }",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`process.stdout?.columns && process.stdout?.rows`,
+						children: _alloy_js_core.code`return { columns: process.stdout.columns, rows: process.stdout.rows }; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`process.stderr?.columns && process.stderr?.rows`,
+						children: _alloy_js_core.code`return { columns: process.stderr.columns, rows: process.stderr.rows };`
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`isWindows`,
+						children: _alloy_js_core.code`return tput() ?? {
+            columns: DEFAULT_TERMINAL_COLUMNS,
+            rows: DEFAULT_TERMINAL_ROWS,
+          }; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`isMacOS`,
+						children: _alloy_js_core.code`return devTty() ?? tput() ?? {
+            columns: DEFAULT_TERMINAL_COLUMNS,
+            rows: DEFAULT_TERMINAL_ROWS,
+          }; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+						"let": true,
+						name: "result",
+						initializer: _alloy_js_core.code`devTty() ?? tput(); `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+						condition: _alloy_js_core.code`!result && isForegroundProcess()`,
+						children: _alloy_js_core.code`try {
+          const size = execSync(["resize", "-u"]).match(/\\d+/g);
+          if (size.length === 2) {
+            result = { columns: Number.parseInt(size[0], 10), rows: Number.parseInt(size[1], 10) };
+          }
+        } catch {} `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`return result ?? {
+          columns: DEFAULT_TERMINAL_COLUMNS,
+          rows: DEFAULT_TERMINAL_ROWS,
+        }; `
+				];
+			}
+		})
+	];
+}
+/**
 * Generates utilities for detecting terminal color support.
 */
 function EnvSupportUtilities() {
@@ -1562,6 +1698,10 @@ function UtilsBuiltin(props) {
 					"isAbsolute"
 				],
 				"node:fs": [
+					{
+						name: "constants",
+						alias: "fsConstants"
+					},
 					"openSync",
 					"closeSync",
 					"read",
@@ -1570,6 +1710,7 @@ function UtilsBuiltin(props) {
 					"realpathSync"
 				],
 				"node:fs/promises": ["stat"],
+				"node:tty": "tty",
 				"node:util": ["promisify"],
 				"node:url": ["fileURLToPath", "pathToFileURL"],
 				"node:module": ["builtinModules"]
@@ -1587,9 +1728,12 @@ function UtilsBuiltin(props) {
 					"isCI",
 					"isTest",
 					"isWindows",
+					"isLinux",
+					"isMacOS",
 					"isDevelopment",
 					"isDebug"
 				],
+				exec: ["execSync"],
 				state: ["hasFlag"]
 			});
 		},
@@ -1615,6 +1759,8 @@ function UtilsBuiltin(props) {
 					children: _alloy_js_core.code`return new Promise((resolve) => setTimeout(resolve, durationMs)); `
 				}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(TerminalSizeDeclaration, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(EnvSupportUtilities, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(HyperlinkSupportUtilities, {}),
@@ -1642,5 +1788,6 @@ exports.EnvSupportUtilities = EnvSupportUtilities;
 exports.FindSuggestionsDeclaration = FindSuggestionsDeclaration;
 exports.HyperlinkSupportUtilities = HyperlinkSupportUtilities;
 exports.ResolveModuleFunctionDeclaration = ResolveModuleFunctionDeclaration;
+exports.TerminalSizeDeclaration = TerminalSizeDeclaration;
 exports.UtilsBuiltin = UtilsBuiltin;
 //# sourceMappingURL=utils-builtin.cjs.map

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

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

package/dist/components/utils-builtin.d.cts

@@ -7,6 +7,10 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
  * Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.
  */
 declare function FindSuggestionsDeclaration(): _$_alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).
+ */
+declare function TerminalSizeDeclaration(): _$_alloy_js_core0.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
@@ -28,5 +32,5 @@ declare function ResolveModuleFunctionDeclaration(): _$_alloy_js_core0.Children;
  */
 declare function UtilsBuiltin(props: UtilsBuiltinProps): _$_alloy_js_core0.Children;
 //#endregion
-export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps };
+export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.cts.map

package/dist/components/utils-builtin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.d.cts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"mappings":";;;;UAwCiB,iBAAA,SAA0B,IAAA,CACzC,gBAAA;;AADF;;iBAQgB,0BAAA,CAAA,GAA0B,iBAAA,CAAA,QAAA;;;AAA1C;iBA0MgB,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;;;;iBAsMrB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;AAtMzC;;;AAAA,iBAgTgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;;AA1GhD;;iBAw+BgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"utils-builtin.d.cts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"mappings":";;;;UAyCiB,iBAAA,SAA0B,IAAA,CACzC,gBAAA;;AADF;;iBAQgB,0BAAA,CAAA,GAA0B,iBAAA,CAAA,QAAA;;;AAA1C;iBA0MgB,uBAAA,CAAA,GAAuB,iBAAA,CAAA,QAAA;;;;iBAoIvB,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;AAjCrC;;;AAAA,iBAuOgB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;;AAtMzC;;iBAgTgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;;;AA1GhD;iBAw+BgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}

package/dist/components/utils-builtin.d.mts

@@ -7,6 +7,10 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
  * Generates the `findSuggestions` function for suggesting corrections for potentially misspelled options or commands.
  */
 declare function FindSuggestionsDeclaration(): _$_alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal size and whether the process is running in the foreground, which can be used to determine how to render output (e.g., whether to use a progress bar or spinner).
+ */
+declare function TerminalSizeDeclaration(): _$_alloy_js_core0.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
@@ -28,5 +32,5 @@ declare function ResolveModuleFunctionDeclaration(): _$_alloy_js_core0.Children;
  */
 declare function UtilsBuiltin(props: UtilsBuiltinProps): _$_alloy_js_core0.Children;
 //#endregion
-export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps };
+export { ColorSupportUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, ResolveModuleFunctionDeclaration, TerminalSizeDeclaration, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.mts.map

package/dist/components/utils-builtin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.d.mts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"mappings":";;;;UAwCiB,iBAAA,SAA0B,IAAA,CACzC,gBAAA;;AADF;;iBAQgB,0BAAA,CAAA,GAA0B,iBAAA,CAAA,QAAA;;;AAA1C;iBA0MgB,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;;;;iBAsMrB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;AAtMzC;;;AAAA,iBAgTgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;;AA1GhD;;iBAw+BgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}
+{"version":3,"file":"utils-builtin.d.mts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"mappings":";;;;UAyCiB,iBAAA,SAA0B,IAAA,CACzC,gBAAA;;AADF;;iBAQgB,0BAAA,CAAA,GAA0B,iBAAA,CAAA,QAAA;;;AAA1C;iBA0MgB,uBAAA,CAAA,GAAuB,iBAAA,CAAA,QAAA;;;;iBAoIvB,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;AAjCrC;;;AAAA,iBAuOgB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;;AAtMzC;;iBAgTgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;;;AA1GhD;iBAw+BgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}