@shell-shock/core 0.15.1 → 0.15.2

package/dist/components/utils-builtin.cjs

@@ -1506,7 +1506,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!validPackageName) {
           const err = new Error(
-            \`Invalid module "\${specifier}" is not a valid package name imported from \${fileURLToPath(base)}\`
+            \`Invalid module \\\`\${specifier}\\\` is not a valid package name imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_INVALID_MODULE_SPECIFIER";
           throw err;
@@ -1607,10 +1607,9 @@ function ResolveModuleFunctionDeclaration() {
           return new URL(packageSubpath, packageJsonUrl);
         } while (packageJsonPath.length !== lastPath!.length);
 
-        const err = new Error(
-          \`Cannot find package '\${packageName}' imported from \${fileURLToPath(base)}\`
-        );
+        const err = new Error(\`Cannot find package \\\`\${packageName}\\\`\`);
         (err as any).code = "ERR_MODULE_NOT_FOUND";
+
         throw err;`
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -1626,9 +1625,10 @@ function ResolveModuleFunctionDeclaration() {
 			returnType: "URL",
 			children: _alloy_js_core.code`if (/%2f|%5c/i.test(resolved.pathname)) {
           const err = new Error(
-            \`Invalid module "\${resolved.pathname}" must not include encoded "/" or "\\\\" characters imported from \${fileURLToPath(base)}\`
+            \`Invalid module \\\`\${resolved.pathname}\\\` must not include encoded "/" or "\\\\" characters imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_INVALID_MODULE_SPECIFIER";
+
           throw err;
         }
 
@@ -1641,7 +1641,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (stat && stat.isDirectory()) {
           const err = new Error(
-            \`Directory import '\${filePath}' is not supported resolving ES modules imported from \${fileURLToPath(base)}\`
+            \`Directory import \\\`\${filePath}\\\` is not supported resolving ES modules imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_UNSUPPORTED_DIR_IMPORT";
           throw err;
@@ -1649,7 +1649,7 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!stat || !stat.isFile()) {
           const err = new Error(
-            \`Cannot find module '\${filePath}' imported from \${fileURLToPath(base)}\`
+            \`Cannot find module \\\`\${filePath}\\\` imported from \${fileURLToPath(base)}\`
           );
           (err as any).code = "ERR_MODULE_NOT_FOUND";
           throw err;
@@ -1694,7 +1694,7 @@ function ResolveModuleFunctionDeclaration() {
             resolved = new URL(specifier, base);
           } catch (error_: any) {
             const err = new Error(
-              \`Failed to resolve module specifier "\${specifier}" from "\${base}": Invalid relative URL or base scheme is not hierarchical.\`
+              \`Failed to resolve module specifier \\\`\${specifier}\\\` from "\${base}": Invalid relative URL or base scheme is not hierarchical.\`
             );
             err.cause = error_;
             throw err;
@@ -1753,7 +1753,7 @@ function ResolveModuleFunctionDeclaration() {
 
           if (!resolved) {
             const err = new Error(
-              \`Package import specifier "\${specifier}" is not defined in package imported from \${fileURLToPath(base)}\`
+              \`Package import specifier \\\`\${specifier}\\\` is not defined in package imported from \${fileURLToPath(base)}\`
             );
             (err as any).code = "ERR_PACKAGE_IMPORT_NOT_DEFINED";
             throw err;
@@ -1825,6 +1825,7 @@ function ResolveModuleFunctionDeclaration() {
 		}),
 		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
 			async: true,
+			"export": true,
 			name: "resolveModule",
 			parameters: [{
 				name: "specifier",
@@ -1925,9 +1926,10 @@ function ResolveModuleFunctionDeclaration() {
 
         if (!resolved) {
           const err = new Error(
-            \`Cannot find module \${specifier} imported from \${base.href}\`
+            \`Cannot find module \\\`\${specifier}\\\`\`
           );
           (err as any).code = "ERR_MODULE_NOT_FOUND";
+
           throw err;
         }
 

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

@@ -1 +1 @@
-{"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,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;;;;iBAsMrB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;AAtMzC;;;AAAA,iBAgTgB,aAAA,CAAA,GAAa,iBAAA,CAAA,QAAA;;AA1G7B;;iBAuLgB,wBAAA,CAAA,GAAwB,iBAAA,CAAA,QAAA;;;AA7ExC;iBAkYgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;AAAA,iBAy3BhC,gBAAA,CAAA,GAAgB,iBAAA,CAAA,QAAA;;;AA9qChC;iBAowCgB,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,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;;;;iBAsMrB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;AAtMzC;;;AAAA,iBAgTgB,aAAA,CAAA,GAAa,iBAAA,CAAA,QAAA;;AA1G7B;;iBAuLgB,wBAAA,CAAA,GAAwB,iBAAA,CAAA,QAAA;;;AA7ExC;iBAkYgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;AAAA,iBA23BhC,gBAAA,CAAA,GAAgB,iBAAA,CAAA,QAAA;;;AAhrChC;iBAswCgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}

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":";;;;UAyCiB,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,aAAA,CAAA,GAAa,iBAAA,CAAA,QAAA;;AA1G7B;;iBAuLgB,wBAAA,CAAA,GAAwB,iBAAA,CAAA,QAAA;;;AA7ExC;iBAkYgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;AAAA,iBAy3BhC,gBAAA,CAAA,GAAgB,iBAAA,CAAA,QAAA;;;AA9qChC;iBAowCgB,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,mBAAA,CAAA,GAAmB,iBAAA,CAAA,QAAA;;;;iBAiCnB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA;;;;iBAsMrB,yBAAA,CAAA,GAAyB,iBAAA,CAAA,QAAA;AAtMzC;;;AAAA,iBAgTgB,aAAA,CAAA,GAAa,iBAAA,CAAA,QAAA;;AA1G7B;;iBAuLgB,wBAAA,CAAA,GAAwB,iBAAA,CAAA,QAAA;;;AA7ExC;iBAkYgB,gCAAA,CAAA,GAAgC,iBAAA,CAAA,QAAA;AAAA,iBA23BhC,gBAAA,CAAA,GAAgB,iBAAA,CAAA,QAAA;;;AAhrChC;iBAswCgB,YAAA,CAAa,KAAA,EAAO,iBAAA,GAAiB,iBAAA,CAAA,QAAA"}