@shell-shock/core 0.8.13 → 0.9.0

package/dist/components/utils-builtin.cjs

@@ -423,6 +423,330 @@ function ArgsUtilities() {
 		})
 	];
 }
+/**
+* Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.
+*/
+function SpawnFunctionDeclaration() {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			async: true,
+			name: "resolveCommand",
+			parameters: [
+				{
+					name: "command",
+					type: "string"
+				},
+				{
+					name: "options",
+					type: "Record<string, any>",
+					default: "{}"
+				},
+				{
+					name: "pathExt",
+					type: "string",
+					default: "process.env.PATHEXT || [\".EXE\", \".CMD\", \".BAT\", \".COM\"].join(delimiter)"
+				}
+			],
+			children: __alloy_js_core.code`const env = options.env || process.env;
+        const cwd = process.cwd();
+        if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {
+          try {
+            process.chdir(options.cwd);
+          } catch (err) {
+            // Do nothing
+          }
+        }
+
+        let resolved;
+        try {
+          let extensions = [""];
+          if (isWindows) {
+            extensions = pathExt.split(delimiter).flatMap((item) => [item, item.toLowerCase()]);
+            if (command.includes(".") && extensions[0] !== "") {
+              extensions.unshift("");
+            }
+          }
+
+          for (const envPart of (command.match(new RegExp(\`[\${posix.sep}\${sep === posix.sep ? "" : sep}]\`.replace(/(\\\\)/g, "\\\\$1"))))
+            ? [...(isWindows ? [process.cwd()] : []), ...(process.env.PATH || "").split(delimiter)]
+            : [""]
+          ) {
+            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)}\`;
+            for (const extension of extensions) {
+              if (isWindows) {
+                const filePath = part + extension;
+                if ((await stat(filePath)).isFile() && extensions.some((ext) => filePath.substring(filePath.length - ext.length).toLowerCase() === ext.toLowerCase())) {
+                  resolved = filePath;
+                  break;
+                }
+              } else {
+                const file = await stat(part + extension);
+                if (file.isFile() && (file.mode & 0o111) !== 0) {
+                  resolved = part + extension;
+                  break;
+                }
+              }
+            }
+          }
+        } catch (err) {
+          // Do nothing
+        } finally {
+          if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {
+            process.chdir(cwd);
+          }
+        }
+
+
+        if (resolved) {
+          resolved = resolve(
+            options.cwd ? options.cwd : "",
+            resolved
+          );
+        }
+
+        return resolved; `
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
+			name: "SpawnBaseOptions",
+			doc: "Options for the `spawn` handler function.",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "stdout",
+						optional: true,
+						type: "(data: string) => void",
+						doc: "The writable stream to use for prompt output, defaults to process.stdout"
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "stderr",
+						optional: true,
+						type: "(data: string) => void",
+						doc: "The writable stream to use for prompt error output, defaults to process.stderr"
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "rejectOnError",
+						optional: true,
+						type: "boolean",
+						doc: "Whether to reject the promise on error. Defaults to false."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "file",
+						optional: true,
+						type: "string",
+						doc: "The file to execute."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "shell",
+						optional: true,
+						type: "boolean | string",
+						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."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+						name: "forceShell",
+						optional: true,
+						type: "boolean",
+						doc: "If true, forces the command to run inside of a shell, even if the command is a file."
+					})
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.TypeDeclaration, {
+			"export": true,
+			name: "SpawnOptions",
+			children: __alloy_js_core.code`SpawnBaseOptions & Parameters<typeof _spawn>[1]`
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "A function to spawn child processes with proper color support and environment variable handling.",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "command",
+						children: `The command to execute.`
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "args",
+						children: `The command-line arguments to pass to the command. Defaults to an empty array.`
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "options",
+						children: `Additional options for spawning the process, such as the current working directory (\`cwd\`).`
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `The result of the spawned process.` })
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "spawn",
+			parameters: [
+				{
+					name: "command",
+					type: "string"
+				},
+				{
+					name: "args",
+					type: "string[] | SpawnOptions",
+					default: "{} as SpawnOptions"
+				},
+				{
+					name: "options",
+					type: "SpawnOptions",
+					default: "{} as SpawnOptions"
+				}
+			],
+			children: __alloy_js_core.code`const normalized = {
+          command,
+          args: [] as string[],
+          options: options as SpawnOptions | any,
+          file: undefined as string | undefined,
+          original: {
+            command,
+            args,
+          },
+        };
+
+        if (args) {
+          if (Array.isArray(args)) {
+            if (args.length > 0) {
+              normalized.args = args.slice(0);
+            }
+          } else {
+            normalized.options = { ...args } as SpawnOptions | any;
+            normalized.args = [];
+          }
+        }
+
+        if (!normalized.options.shell && isWindows) {
+          normalized.file = (await resolveCommand(normalized.command, normalized.options)) || (await resolveCommand(normalized.command, normalized.options, delimiter));
+
+          let commandFile = normalized.file;
+          if (normalized.file) {
+            let shebang: string | undefined;
+            const buffer = Buffer.alloc(150);
+
+            try {
+              const fd = openSync(normalized.file, "r");
+              await read(fd, buffer, 0, 150, 0);
+              closeSync(fd);
+            } catch (err) {
+              // Do nothing
+            }
+
+            const matched = buffer.toString().match(/^#!(.*)/);
+            if (matched) {
+              const [path, argument] = matched[0].replace(/#! ?/, "").split(" ");
+	            const binary = path.split("/").pop();
+              if (binary === "env") {
+                shebang = argument;
+              } else {
+                shebang = argument ? \`\${binary} \${argument}\` : binary;
+              }
+            }
+
+            if (shebang) {
+              normalized.args.unshift(normalized.file);
+              normalized.command = shebang;
+
+              commandFile = await resolveCommand(normalized.command, normalized.options);
+            }
+          }
+
+          if (commandFile && (normalized.options.forceShell || /\\.(?:com|exe)$/i.test(commandFile))) {
+            normalized.command = normalize(normalized.command).replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1");
+
+            normalized.args = ["/d", "/s", "/c", \`"\${normalized.command} \${normalized.args.map(arg =>
+              \`\${arg}\`.replace(/(?=(\\\\+?)?)\\1"/g, "$1$1\\"").replace(/(?=(\\\\+?)?)\\1$/, "$1$1")
+            ).map(arg =>
+              \`"\${arg}"\`.replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1")
+            ).map(arg =>
+              /node_modules[\\\\/].bin[\\\\/][^\\\\/]+\\.cmd$/i.test(commandFile) ? arg.replace(/([()\\][%!^"\`<>&|;, *?])/g, "^$1") : arg
+            ).join(" ")}"\`];
+            normalized.command = process.env.comspec || "cmd.exe";
+            normalized.options.windowsVerbatimArguments = true;
+          }
+        }
+
+        let stdout = "";
+        let stderr = "";
+
+        const child = _spawn(normalized.command, normalized.args, {
+          cwd: process.cwd(),
+          env: {
+            ...process.env,
+            FORCE_COLOR: isColorSupported ? "1" : "0",
+          },
+          ...normalized.options,
+        }) as ReturnType<typeof _spawn>;
+
+        if (isWindows) {
+          const emit = child.emit;
+          child.emit = (eventName: string | symbol, ...eventArgs: any[]) => {
+            if (eventName === "exit") {
+              let err: Error | null = null;
+              if (eventArgs[0] === 1 && !normalized.file) {
+                err = Object.assign(new Error(\`spawn \${normalized.original.command} ENOENT\`), {
+                  code: "ENOENT",
+                  errno: "ENOENT",
+                  syscall: \`spawn \${normalized.original.command}\`,
+                  path: normalized.original.command,
+                  spawnargs: normalized.original.args,
+                });
+              }
+
+              if (err) {
+                return emit.call(child, "error", err);
+              }
+            }
+
+            return emit.apply(child, [eventName, ...eventArgs]);
+          };
+        }
+
+        return new Promise((resolve, reject) => {
+          if (normalized.options.stdin !== undefined) {
+            child.stdin?.write(normalized.options.stdin);
+          }
+
+          child.stdin?.end();
+
+          child.stdout?.on("data", data => {
+            stdout += data;
+            if (normalized.options.stdout) {
+              normalized.options.stdout(data);
+            }
+          });
+
+          child.stderr?.on("data", data => {
+            stderr += data;
+            if (normalized.options.stderr) {
+              normalized.options.stderr(data);
+            }
+          });
+
+          if (normalized.options.rejectOnError) {
+            child.addListener("error", reject);
+          }
+
+          child.on("close", code => {
+            if (code !== 0 && normalized.options.rejectOnError) {
+              reject(stderr);
+            } else {
+              resolve({ stdout, stderr });
+            }
+          });
+        }); `
+		})
+	];
+}
 function ContextUtilities() {
 	return __alloy_js_core.code`
   /**
@@ -518,6 +842,20 @@ function UtilsBuiltin(props) {
 			return (0, defu.default)(rest.imports ?? {}, {
 				"node:os": "os",
 				"node:process": "process",
+				"node:path": [
+					"resolve",
+					"delimiter",
+					"normalize",
+					"join",
+					"posix",
+					"sep"
+				],
+				"node:fs": ["openSync", "closeSync"],
+				"node:fs/promises": ["stat", "read"],
+				"node:child_process": [{
+					name: "spawn",
+					alias: "_spawn"
+				}],
 				"node:async_hooks": ["AsyncLocalStorage"]
 			});
 		},
@@ -551,6 +889,8 @@ function UtilsBuiltin(props) {
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(ColorSupportUtilities, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(SpawnFunctionDeclaration, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 					get when() {
 						return Boolean(children);
@@ -568,5 +908,6 @@ exports.ColorSupportUtilities = ColorSupportUtilities;
 exports.ContextUtilities = ContextUtilities;
 exports.EnvSupportUtilities = EnvSupportUtilities;
 exports.HyperlinkSupportUtilities = HyperlinkSupportUtilities;
+exports.SpawnFunctionDeclaration = SpawnFunctionDeclaration;
 exports.UtilsBuiltin = UtilsBuiltin;
 //# sourceMappingURL=utils-builtin.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.cjs","names":["code","Show","splitProps","FunctionDeclaration","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","defu","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","ContextUtilities","UtilsBuiltin","props","rest","_$mergeProps","id","description","imports","builtinImports","console","env","when","Boolean"],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Show, splitProps } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  InterfaceDeclaration,\n  InterfaceMember,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n  TSDoc,\n  TSDocInternal,\n  TSDocLink,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport defu from \"defu\";\n\nexport interface UtilsBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function EnvSupportUtilities() {\n  return (\n    <>\n      <VarDeclaration\n        export\n        const\n        name=\"isTTY\"\n        doc=\"Detect if stdout.TTY is available\"\n        initializer={code`Boolean(process.stdout && process.stdout.isTTY);`}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isMinimal\"\n        doc=\"Detect if the current environment is minimal (CI, non-TTY, etc.)\"\n        initializer={code` env.MINIMAL || isCI || isTest || !isTTY; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isInteractive\"\n        doc=\"Detect if the current environment is interactive\"\n        initializer={code` !isMinimal && process.stdin?.isTTY && env.TERM !== \"dumb\" && !hasFlag([\"no-interactive\", \"non-interactive\", \"no-interact\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function ColorSupportUtilities() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"GetColorSupportLevelOptions\"\n        doc=\"Options for the getColorSupportLevel function\">\n        <InterfaceMember\n          name=\"ignoreFlags\"\n          type=\"boolean\"\n          doc=\"Indicates if the function should skip checking command-line flags for color support\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Checks if a specific flag is present in the command-line arguments.\">\n        <TSDocLink>\n          {\"https://github.com/sindresorhus/has-flag/blob/main/index.js\"}\n        </TSDocLink>\n        <TSDocParam name=\"flag\">\n          {'The flag to check for, e.g., \"color\", \"no-color\".'}\n        </TSDocParam>\n        <TSDocParam name=\"argv\">\n          {\n            \"The command-line arguments to check against. Defaults to global Deno args or process args.\"\n          }\n        </TSDocParam>\n        <TSDocReturns>\n          {\"True if the flag is present, false otherwise.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"getColorSupportLevel\"\n        parameters={[\n          { name: \"stream\", type: \"NodeJS.WriteStream & { fd: 1 | 2; }\" },\n          {\n            name: \"options\",\n            type: \"GetColorSupportLevelOptions\",\n            default: \"{ ignoreFlags: false }\"\n          }\n        ]}>\n        {code`const { ignoreFlags } = options;\n\n        let forceColor: number | undefined;\n        if (env.FORCE_COLOR !== undefined) {\n          forceColor = !env.FORCE_COLOR\n            ? 0\n            : typeof env.FORCE_COLOR === \"boolean\"\n            ? 1\n            : typeof env.FORCE_COLOR === \"number\" &&\n              [0, 1, 2, 3].includes(Math.min(env.FORCE_COLOR as number, 3))\n            ? Math.min(env.FORCE_COLOR as number, 3)\n            : undefined;\n        }\n\n        if (ignoreFlags !== true && forceColor === undefined) {\n          if (\n            hasFlag(\"no-color\") ||\n            hasFlag(\"no-colors\") ||\n            hasFlag(\"color=false\") ||\n            hasFlag(\"color=never\")\n          ) {\n            return 0;\n          }\n\n          if (\n            hasFlag(\"color=16m\") ||\n            hasFlag(\"color=full\") ||\n            hasFlag(\"color=truecolor\")\n          ) {\n            return 3;\n          }\n\n          if (hasFlag(\"color=256\")) {\n            return 2;\n          }\n\n          if (\n            hasFlag(\"color\") ||\n            hasFlag(\"colors\") ||\n            hasFlag(\"color=true\") ||\n            hasFlag(\"color=always\")\n          ) {\n            forceColor = 1;\n          }\n        }\n\n        const level = Boolean(env.TF_BUILD) || Boolean(env.AGENT_NAME)\n          ? 1\n          : stream &&\n              !(isTTY || (stream && stream.isTTY)) &&\n              forceColor === undefined\n            ? 0\n            : env.TERM === \"dumb\"\n              ? forceColor || 0\n              : isWindows\n                ? Number(os.release().split(\".\")[0]) >= 10 &&\n                  Number(os.release().split(\".\")[2]) >= 10_586\n                  ? Number(os.release().split(\".\")[2]) >= 14_931\n                    ? 3\n                    : 2\n                  : 1\n                : isCI\n                  ? Boolean(env.GITHUB_ACTIONS) ||\n                    Boolean(env.GITEA_ACTIONS) ||\n                    Boolean(env.CIRCLECI)\n                    ? 3\n                    : Boolean(env.TRAVIS) ||\n                      Boolean(env.APPVEYOR) ||\n                      Boolean(env.GITLAB_CI) ||\n                      Boolean(env.BUILDKITE) ||\n                      Boolean(env.DRONE) ||\n                      env.CI_NAME === \"codeship\"\n                      ? 1\n                      : forceColor || 0\n                  : Boolean(env.TEAMCITY_VERSION)\n                    ? /^(?:9\\.0*[1-9]\\d*\\.|\\d{2,}\\.)/.test(String(env.TEAMCITY_VERSION) || \"\")\n                      ? 1\n                      : 0\n                    : String(env.COLORTERM) === \"truecolor\" ||\n                        env.TERM === \"xterm-kitty\"\n                      ? 3\n                      : Boolean(env.TERM_PROGRAM)\n                        ? env.TERM_PROGRAM === \"iTerm.app\"\n                          ? Number.parseInt(\n                              (env.TERM_PROGRAM_VERSION || \"\").split(\".\")[0] as string,\n                              10\n                            ) >= 3\n                            ? 3\n                            : 2\n                          : env.TERM_PROGRAM === \"Apple_Terminal\"\n                            ? 2\n                            : 0\n                        : /-256(?:color)?$/i.test(env.TERM || \"\")\n                          ? 2\n                          : /^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(\n                                env.TERM || \"\"\n                              )\n                            ? 1\n                            : Boolean(env.COLORTERM);\n\n        return typeof level === \"boolean\" || level === 0\n          ? false\n          : {\n              level,\n              hasBasic: true,\n              has256: level >= 2,\n              has16m: level >= 3,\n            };\n\n  `}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"colorSupportLevels\"\n        doc=\"Detect the terminal color support level in the current environment\"\n        initializer={code` {\n    stdout: getColorSupportLevel(process.stdout),\n    stderr: getColorSupportLevel(process.stderr),\n  }; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isColorSupported\"\n        doc=\"Detect if terminal color is supported in the current environment\"\n        initializer={code` Boolean(colorSupportLevels.stdout); `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isUnicodeSupported\"\n        doc=\"Detect if Unicode characters are supported in the current environment\"\n        initializer={code` !isWindows\n            ? env.TERM !== \"linux\"\n            : Boolean(env.WT_SESSION) ||\n                Boolean(env.TERMINUS_SUBLIME) ||\n                env.ConEmuTask === \"{cmd::Cmder}\" ||\n                env.TERM_PROGRAM === \"Terminus-Sublime\" ||\n                env.TERM_PROGRAM === \"vscode\" ||\n                env.TERM === \"xterm-256color\" ||\n                env.TERM === \"alacritty\" ||\n                env.TERM === \"rxvt-unicode\" ||\n                env.TERM === \"rxvt-unicode-256color\" ||\n                env.TERMINAL_EMULATOR === \"JetBrains-JediTerm\"; `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\n\nexport function HyperlinkSupportUtilities() {\n  return (\n    <>\n      <FunctionDeclaration\n        name=\"parseVersion\"\n        parameters={[{ name: \"version\", type: \"string\", default: '\"\"' }]}>\n        {code`if (/^\\d{3,4}$/.test(version)) {\n        const match = /(\\d{1,2})(\\d{2})/.exec(version) ?? [];\n\n        return {\n          major: 0,\n          minor: Number.parseInt(match[1]!, 10),\n          patch: Number.parseInt(match[2]!, 10)\n        };\n      }\n\n      const versionParts = (version ?? \"\")\n        .split(\".\")\n        .map(n => Number.parseInt(n, 10));\n\n      return {\n        major: versionParts[0],\n        minor: versionParts[1],\n        patch: versionParts[2]\n      }; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Check if the current environment/terminal supports hyperlinks in the terminal.\">\n        <TSDocReturns>\n          {\"True if the current environment/terminal supports hyperlinks.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"isHyperlinkSupported\"\n        returnType=\"boolean\">\n        {code`if (Boolean(env.FORCE_HYPERLINK)) {\n          return true;\n        }\n\n        if (Boolean(env.NETLIFY)) {\n          return true;\n        } else if (isColorSupported || isTTY) {\n          return false;\n        } else if (Boolean(env.WT_SESSION)) {\n          return true;\n        } else if (isWindows || isMinimal || Boolean(env.TEAMCITY_VERSION)) {\n          return false;\n        } else if (Boolean(env.TERM_PROGRAM)) {\n          const version = parseVersion(env.TERM_PROGRAM_VERSION);\n\n          switch (String(env.TERM_PROGRAM)) {\n            case \"iTerm.app\": {\n              if (version.major === 3) {\n                return version.minor !== undefined && version.minor >= 1;\n              }\n\n              return version.major !== undefined && version.major > 3;\n            }\n            case \"WezTerm\": {\n              return version.major !== undefined && version.major >= 20_200_620;\n            }\n\n            case \"vscode\": {\n              if (Boolean(env.CURSOR_TRACE_ID)) {\n                return true;\n              }\n\n              return (\n                version.minor !== undefined &&\n                version.major !== undefined &&\n                (version.major > 1 || (version.major === 1 && version.minor >= 72))\n              );\n            }\n\n            case \"ghostty\": {\n              return true;\n            }\n          }\n        }\n\n        if (Boolean(env.VTE_VERSION)) {\n          if (env.VTE_VERSION === \"0.50.0\") {\n            return false;\n          }\n\n          const version = parseVersion(env.VTE_VERSION);\n          return (\n            (version.major !== undefined && version.major > 0) ||\n            (version.minor !== undefined && version.minor >= 50)\n          );\n        }\n\n        if (String(env.TERM) === \"alacritty\") {\n          return true;\n        }\n\n        return false; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function ArgsUtilities() {\n  return (\n    <>\n      <TSDoc heading=\"Retrieves the command-line arguments from Deno or Node.js environments.\">\n        <TSDocRemarks>\n          {\n            \"This function is only intended for internal use. Please use `useArgs()` instead.\"\n          }\n        </TSDocRemarks>\n        <hbr />\n        <hbr />\n        <TSDocInternal />\n        <hbr />\n        <hbr />\n        <TSDocReturns>\n          {\n            \"An array of command-line arguments from Deno or Node.js environments.\"\n          }\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration export name=\"getArgs\" returnType=\"string[]\">\n        {code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Checks if a specific flag is present in the command-line arguments.\">\n        <TSDocLink>\n          {\"https://github.com/sindresorhus/has-flag/blob/main/index.js\"}\n        </TSDocLink>\n        <TSDocParam name=\"flag\">\n          {\n            'The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\".'\n          }\n        </TSDocParam>\n        <TSDocParam name=\"argv\">\n          {\n            \"The command-line arguments to check against. Defaults to global Deno args or process args.\"\n          }\n        </TSDocParam>\n        <TSDocReturns>\n          {\"True if the flag is present, false otherwise.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"hasFlag\"\n        parameters={[\n          { name: \"flag\", type: \"string | string[]\" },\n          {\n            name: \"argv\",\n            type: \"string[]\",\n            default: \"useArgs()\"\n          }\n        ]}>\n        <VarDeclaration\n          const\n          name=\"position\"\n          type=\"number\"\n          initializer={code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {\n            const pos = argv.findIndex(arg => (f.startsWith(\"-\") ? \"\" : (f.length === 1 ? \"-\" : \"--\") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? \"-\" : \"--\") + f + \"=\"));\n            return pos !== -1 ? pos : ret;\n          }, -1);`}\n        />\n        <hbr />\n        {code`return position !== -1 && argv.indexOf(\"--\") === -1 || position < argv.indexOf(\"--\");`}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        name=\"isHelp\"\n        type=\"boolean\"\n        initializer={code` !isCI && hasFlag([\"help\", \"h\", \"?\"]); `}\n      />\n    </>\n  );\n}\n\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:async_hooks\": [\"AsyncLocalStorage\"]\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\"env\", \"isCI\", \"isTest\", \"isWindows\", \"isDevelopment\", \"isDebug\"]\n      })}>\n      <Spacing />\n      <ContextUtilities />\n      <Spacing />\n      <ArgsUtilities />\n      <Spacing />\n      <EnvSupportUtilities />\n      <Spacing />\n      <HyperlinkSupportUtilities />\n      <Spacing />\n      <ColorSupportUtilities />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"utils-builtin.cjs","names":["code","Show","splitProps","FunctionDeclaration","InterfaceDeclaration","InterfaceMember","TypeDeclaration","VarDeclaration","Spacing","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","defu","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","SpawnFunctionDeclaration","async","optional","ContextUtilities","UtilsBuiltin","props","rest","_$mergeProps","id","description","imports","alias","builtinImports","console","env","when","Boolean"],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, Show, splitProps } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  InterfaceDeclaration,\n  InterfaceMember,\n  TypeDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n  TSDoc,\n  TSDocInternal,\n  TSDocLink,\n  TSDocParam,\n  TSDocRemarks,\n  TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport defu from \"defu\";\n\nexport interface UtilsBuiltinProps extends Omit<\n  BuiltinFileProps,\n  \"id\" | \"description\"\n> {}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function EnvSupportUtilities() {\n  return (\n    <>\n      <VarDeclaration\n        export\n        const\n        name=\"isTTY\"\n        doc=\"Detect if stdout.TTY is available\"\n        initializer={code`Boolean(process.stdout && process.stdout.isTTY);`}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isMinimal\"\n        doc=\"Detect if the current environment is minimal (CI, non-TTY, etc.)\"\n        initializer={code` env.MINIMAL || isCI || isTest || !isTTY; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isInteractive\"\n        doc=\"Detect if the current environment is interactive\"\n        initializer={code` !isMinimal && process.stdin?.isTTY && env.TERM !== \"dumb\" && !hasFlag([\"no-interactive\", \"non-interactive\", \"no-interact\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function ColorSupportUtilities() {\n  return (\n    <>\n      <InterfaceDeclaration\n        export\n        name=\"GetColorSupportLevelOptions\"\n        doc=\"Options for the getColorSupportLevel function\">\n        <InterfaceMember\n          name=\"ignoreFlags\"\n          type=\"boolean\"\n          doc=\"Indicates if the function should skip checking command-line flags for color support\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Checks if a specific flag is present in the command-line arguments.\">\n        <TSDocLink>\n          {\"https://github.com/sindresorhus/has-flag/blob/main/index.js\"}\n        </TSDocLink>\n        <TSDocParam name=\"flag\">\n          {'The flag to check for, e.g., \"color\", \"no-color\".'}\n        </TSDocParam>\n        <TSDocParam name=\"argv\">\n          {\n            \"The command-line arguments to check against. Defaults to global Deno args or process args.\"\n          }\n        </TSDocParam>\n        <TSDocReturns>\n          {\"True if the flag is present, false otherwise.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"getColorSupportLevel\"\n        parameters={[\n          { name: \"stream\", type: \"NodeJS.WriteStream & { fd: 1 | 2; }\" },\n          {\n            name: \"options\",\n            type: \"GetColorSupportLevelOptions\",\n            default: \"{ ignoreFlags: false }\"\n          }\n        ]}>\n        {code`const { ignoreFlags } = options;\n\n        let forceColor: number | undefined;\n        if (env.FORCE_COLOR !== undefined) {\n          forceColor = !env.FORCE_COLOR\n            ? 0\n            : typeof env.FORCE_COLOR === \"boolean\"\n            ? 1\n            : typeof env.FORCE_COLOR === \"number\" &&\n              [0, 1, 2, 3].includes(Math.min(env.FORCE_COLOR as number, 3))\n            ? Math.min(env.FORCE_COLOR as number, 3)\n            : undefined;\n        }\n\n        if (ignoreFlags !== true && forceColor === undefined) {\n          if (\n            hasFlag(\"no-color\") ||\n            hasFlag(\"no-colors\") ||\n            hasFlag(\"color=false\") ||\n            hasFlag(\"color=never\")\n          ) {\n            return 0;\n          }\n\n          if (\n            hasFlag(\"color=16m\") ||\n            hasFlag(\"color=full\") ||\n            hasFlag(\"color=truecolor\")\n          ) {\n            return 3;\n          }\n\n          if (hasFlag(\"color=256\")) {\n            return 2;\n          }\n\n          if (\n            hasFlag(\"color\") ||\n            hasFlag(\"colors\") ||\n            hasFlag(\"color=true\") ||\n            hasFlag(\"color=always\")\n          ) {\n            forceColor = 1;\n          }\n        }\n\n        const level = Boolean(env.TF_BUILD) || Boolean(env.AGENT_NAME)\n          ? 1\n          : stream &&\n              !(isTTY || (stream && stream.isTTY)) &&\n              forceColor === undefined\n            ? 0\n            : env.TERM === \"dumb\"\n              ? forceColor || 0\n              : isWindows\n                ? Number(os.release().split(\".\")[0]) >= 10 &&\n                  Number(os.release().split(\".\")[2]) >= 10_586\n                  ? Number(os.release().split(\".\")[2]) >= 14_931\n                    ? 3\n                    : 2\n                  : 1\n                : isCI\n                  ? Boolean(env.GITHUB_ACTIONS) ||\n                    Boolean(env.GITEA_ACTIONS) ||\n                    Boolean(env.CIRCLECI)\n                    ? 3\n                    : Boolean(env.TRAVIS) ||\n                      Boolean(env.APPVEYOR) ||\n                      Boolean(env.GITLAB_CI) ||\n                      Boolean(env.BUILDKITE) ||\n                      Boolean(env.DRONE) ||\n                      env.CI_NAME === \"codeship\"\n                      ? 1\n                      : forceColor || 0\n                  : Boolean(env.TEAMCITY_VERSION)\n                    ? /^(?:9\\.0*[1-9]\\d*\\.|\\d{2,}\\.)/.test(String(env.TEAMCITY_VERSION) || \"\")\n                      ? 1\n                      : 0\n                    : String(env.COLORTERM) === \"truecolor\" ||\n                        env.TERM === \"xterm-kitty\"\n                      ? 3\n                      : Boolean(env.TERM_PROGRAM)\n                        ? env.TERM_PROGRAM === \"iTerm.app\"\n                          ? Number.parseInt(\n                              (env.TERM_PROGRAM_VERSION || \"\").split(\".\")[0] as string,\n                              10\n                            ) >= 3\n                            ? 3\n                            : 2\n                          : env.TERM_PROGRAM === \"Apple_Terminal\"\n                            ? 2\n                            : 0\n                        : /-256(?:color)?$/i.test(env.TERM || \"\")\n                          ? 2\n                          : /^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(\n                                env.TERM || \"\"\n                              )\n                            ? 1\n                            : Boolean(env.COLORTERM);\n\n        return typeof level === \"boolean\" || level === 0\n          ? false\n          : {\n              level,\n              hasBasic: true,\n              has256: level >= 2,\n              has16m: level >= 3,\n            };\n\n  `}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"colorSupportLevels\"\n        doc=\"Detect the terminal color support level in the current environment\"\n        initializer={code` {\n    stdout: getColorSupportLevel(process.stdout),\n    stderr: getColorSupportLevel(process.stderr),\n  }; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isColorSupported\"\n        doc=\"Detect if terminal color is supported in the current environment\"\n        initializer={code` Boolean(colorSupportLevels.stdout); `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"isUnicodeSupported\"\n        doc=\"Detect if Unicode characters are supported in the current environment\"\n        initializer={code` !isWindows\n            ? env.TERM !== \"linux\"\n            : Boolean(env.WT_SESSION) ||\n                Boolean(env.TERMINUS_SUBLIME) ||\n                env.ConEmuTask === \"{cmd::Cmder}\" ||\n                env.TERM_PROGRAM === \"Terminus-Sublime\" ||\n                env.TERM_PROGRAM === \"vscode\" ||\n                env.TERM === \"xterm-256color\" ||\n                env.TERM === \"alacritty\" ||\n                env.TERM === \"rxvt-unicode\" ||\n                env.TERM === \"rxvt-unicode-256color\" ||\n                env.TERMINAL_EMULATOR === \"JetBrains-JediTerm\"; `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\n\nexport function HyperlinkSupportUtilities() {\n  return (\n    <>\n      <FunctionDeclaration\n        name=\"parseVersion\"\n        parameters={[{ name: \"version\", type: \"string\", default: '\"\"' }]}>\n        {code`if (/^\\d{3,4}$/.test(version)) {\n        const match = /(\\d{1,2})(\\d{2})/.exec(version) ?? [];\n\n        return {\n          major: 0,\n          minor: Number.parseInt(match[1]!, 10),\n          patch: Number.parseInt(match[2]!, 10)\n        };\n      }\n\n      const versionParts = (version ?? \"\")\n        .split(\".\")\n        .map(n => Number.parseInt(n, 10));\n\n      return {\n        major: versionParts[0],\n        minor: versionParts[1],\n        patch: versionParts[2]\n      }; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Check if the current environment/terminal supports hyperlinks in the terminal.\">\n        <TSDocReturns>\n          {\"True if the current environment/terminal supports hyperlinks.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"isHyperlinkSupported\"\n        returnType=\"boolean\">\n        {code`if (Boolean(env.FORCE_HYPERLINK)) {\n          return true;\n        }\n\n        if (Boolean(env.NETLIFY)) {\n          return true;\n        } else if (isColorSupported || isTTY) {\n          return false;\n        } else if (Boolean(env.WT_SESSION)) {\n          return true;\n        } else if (isWindows || isMinimal || Boolean(env.TEAMCITY_VERSION)) {\n          return false;\n        } else if (Boolean(env.TERM_PROGRAM)) {\n          const version = parseVersion(env.TERM_PROGRAM_VERSION);\n\n          switch (String(env.TERM_PROGRAM)) {\n            case \"iTerm.app\": {\n              if (version.major === 3) {\n                return version.minor !== undefined && version.minor >= 1;\n              }\n\n              return version.major !== undefined && version.major > 3;\n            }\n            case \"WezTerm\": {\n              return version.major !== undefined && version.major >= 20_200_620;\n            }\n\n            case \"vscode\": {\n              if (Boolean(env.CURSOR_TRACE_ID)) {\n                return true;\n              }\n\n              return (\n                version.minor !== undefined &&\n                version.major !== undefined &&\n                (version.major > 1 || (version.major === 1 && version.minor >= 72))\n              );\n            }\n\n            case \"ghostty\": {\n              return true;\n            }\n          }\n        }\n\n        if (Boolean(env.VTE_VERSION)) {\n          if (env.VTE_VERSION === \"0.50.0\") {\n            return false;\n          }\n\n          const version = parseVersion(env.VTE_VERSION);\n          return (\n            (version.major !== undefined && version.major > 0) ||\n            (version.minor !== undefined && version.minor >= 50)\n          );\n        }\n\n        if (String(env.TERM) === \"alacritty\") {\n          return true;\n        }\n\n        return false; `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\n/**\n * Generates utilities for detecting terminal color support.\n */\nexport function ArgsUtilities() {\n  return (\n    <>\n      <TSDoc heading=\"Retrieves the command-line arguments from Deno or Node.js environments.\">\n        <TSDocRemarks>\n          {\n            \"This function is only intended for internal use. Please use `useArgs()` instead.\"\n          }\n        </TSDocRemarks>\n        <hbr />\n        <hbr />\n        <TSDocInternal />\n        <hbr />\n        <hbr />\n        <TSDocReturns>\n          {\n            \"An array of command-line arguments from Deno or Node.js environments.\"\n          }\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration export name=\"getArgs\" returnType=\"string[]\">\n        {code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`}\n      </FunctionDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Checks if a specific flag is present in the command-line arguments.\">\n        <TSDocLink>\n          {\"https://github.com/sindresorhus/has-flag/blob/main/index.js\"}\n        </TSDocLink>\n        <TSDocParam name=\"flag\">\n          {\n            'The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\".'\n          }\n        </TSDocParam>\n        <TSDocParam name=\"argv\">\n          {\n            \"The command-line arguments to check against. Defaults to global Deno args or process args.\"\n          }\n        </TSDocParam>\n        <TSDocReturns>\n          {\"True if the flag is present, false otherwise.\"}\n        </TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        name=\"hasFlag\"\n        parameters={[\n          { name: \"flag\", type: \"string | string[]\" },\n          {\n            name: \"argv\",\n            type: \"string[]\",\n            default: \"useArgs()\"\n          }\n        ]}>\n        <VarDeclaration\n          const\n          name=\"position\"\n          type=\"number\"\n          initializer={code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {\n            const pos = argv.findIndex(arg => (f.startsWith(\"-\") ? \"\" : (f.length === 1 ? \"-\" : \"--\") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? \"-\" : \"--\") + f + \"=\"));\n            return pos !== -1 ? pos : ret;\n          }, -1);`}\n        />\n        <hbr />\n        {code`return position !== -1 && argv.indexOf(\"--\") === -1 || position < argv.indexOf(\"--\");`}\n      </FunctionDeclaration>\n      <Spacing />\n      <VarDeclaration\n        export\n        name=\"isHelp\"\n        type=\"boolean\"\n        initializer={code` !isCI && hasFlag([\"help\", \"h\", \"?\"]); `}\n      />\n    </>\n  );\n}\n\n/**\n * Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.\n */\nexport function SpawnFunctionDeclaration() {\n  return (\n    <>\n      <FunctionDeclaration\n        async\n        name=\"resolveCommand\"\n        parameters={[\n          {\n            name: \"command\",\n            type: \"string\"\n          },\n          {\n            name: \"options\",\n            type: \"Record<string, any>\",\n            default: \"{}\"\n          },\n          {\n            name: \"pathExt\",\n            type: \"string\",\n            default:\n              'process.env.PATHEXT || [\".EXE\", \".CMD\", \".BAT\", \".COM\"].join(delimiter)'\n          }\n        ]}>\n        {code`const env = options.env || process.env;\n        const cwd = process.cwd();\n        if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n          try {\n            process.chdir(options.cwd);\n          } catch (err) {\n            // Do nothing\n          }\n        }\n\n        let resolved;\n        try {\n          let extensions = [\"\"];\n          if (isWindows) {\n            extensions = pathExt.split(delimiter).flatMap((item) => [item, item.toLowerCase()]);\n            if (command.includes(\".\") && extensions[0] !== \"\") {\n              extensions.unshift(\"\");\n            }\n          }\n\n          for (const envPart of (command.match(new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\"))))\n            ? [...(isWindows ? [process.cwd()] : []), ...(process.env.PATH || \"\").split(delimiter)]\n            : [\"\"]\n          ) {\n            const part =  \\`\\${!(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart) && new RegExp(\\`^\\\\.\\${new RegExp(\\`[\\${posix.sep}\\${sep === posix.sep ? \"\" : sep}]\\`.replace(/(\\\\\\\\)/g, \"\\\\\\\\$1\")).source}\\`).test(command) ? command.slice(0, 2) : \"\"}\\${join(/^\".*\"$/.test(envPart) ? envPart.slice(1, -1) : envPart, command)}\\`;\n            for (const extension of extensions) {\n              if (isWindows) {\n                const filePath = part + extension;\n                if ((await stat(filePath)).isFile() && extensions.some((ext) => filePath.substring(filePath.length - ext.length).toLowerCase() === ext.toLowerCase())) {\n                  resolved = filePath;\n                  break;\n                }\n              } else {\n                const file = await stat(part + extension);\n                if (file.isFile() && (file.mode & 0o111) !== 0) {\n                  resolved = part + extension;\n                  break;\n                }\n              }\n            }\n          }\n        } catch (err) {\n          // Do nothing\n        } finally {\n          if (!!options.cwd && process.chdir !== undefined && !(process.chdir as any).disabled) {\n            process.chdir(cwd);\n          }\n        }\n\n\n        if (resolved) {\n          resolved = resolve(\n            options.cwd ? options.cwd : \"\",\n            resolved\n          );\n        }\n\n        return resolved; `}\n      </FunctionDeclaration>\n      <Spacing />\n      <InterfaceDeclaration\n        name=\"SpawnBaseOptions\"\n        doc=\"Options for the `spawn` handler function.\">\n        <InterfaceMember\n          name=\"stdout\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt output, defaults to process.stdout\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"stderr\"\n          optional\n          type=\"(data: string) => void\"\n          doc=\"The writable stream to use for prompt error output, defaults to process.stderr\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"rejectOnError\"\n          optional\n          type=\"boolean\"\n          doc=\"Whether to reject the promise on error. Defaults to false.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"file\"\n          optional\n          type=\"string\"\n          doc=\"The file to execute.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"shell\"\n          optional\n          type=\"boolean | string\"\n          doc=\"If true, runs command inside of a shell. Uses '/bin/sh' on UNIX, and process.env.ComSpec on Windows. If a string is provided, it specifies the shell to use.\"\n        />\n        <hbr />\n        <InterfaceMember\n          name=\"forceShell\"\n          optional\n          type=\"boolean\"\n          doc=\"If true, forces the command to run inside of a shell, even if the command is a file.\"\n        />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TypeDeclaration export name=\"SpawnOptions\">\n        {code`SpawnBaseOptions & Parameters<typeof _spawn>[1]`}\n      </TypeDeclaration>\n      <Spacing />\n      <TSDoc heading=\"A function to spawn child processes with proper color support and environment variable handling.\">\n        <TSDocParam name=\"command\">{`The command to execute.`}</TSDocParam>\n        <TSDocParam name=\"args\">\n          {`The command-line arguments to pass to the command. Defaults to an empty array.`}\n        </TSDocParam>\n        <TSDocParam name=\"options\">\n          {`Additional options for spawning the process, such as the current working directory (\\`cwd\\`).`}\n        </TSDocParam>\n        <TSDocReturns>{`The result of the spawned process.`}</TSDocReturns>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        async\n        name=\"spawn\"\n        parameters={[\n          { name: \"command\", type: \"string\" },\n          {\n            name: \"args\",\n            type: \"string[] | SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          },\n          {\n            name: \"options\",\n            type: \"SpawnOptions\",\n            default: \"{} as SpawnOptions\"\n          }\n        ]}>\n        {code`const normalized = {\n          command,\n          args: [] as string[],\n          options: options as SpawnOptions | any,\n          file: undefined as string | undefined,\n          original: {\n            command,\n            args,\n          },\n        };\n\n        if (args) {\n          if (Array.isArray(args)) {\n            if (args.length > 0) {\n              normalized.args = args.slice(0);\n            }\n          } else {\n            normalized.options = { ...args } as SpawnOptions | any;\n            normalized.args = [];\n          }\n        }\n\n        if (!normalized.options.shell && isWindows) {\n          normalized.file = (await resolveCommand(normalized.command, normalized.options)) || (await resolveCommand(normalized.command, normalized.options, delimiter));\n\n          let commandFile = normalized.file;\n          if (normalized.file) {\n            let shebang: string | undefined;\n            const buffer = Buffer.alloc(150);\n\n            try {\n              const fd = openSync(normalized.file, \"r\");\n              await read(fd, buffer, 0, 150, 0);\n              closeSync(fd);\n            } catch (err) {\n              // Do nothing\n            }\n\n            const matched = buffer.toString().match(/^#!(.*)/);\n            if (matched) {\n              const [path, argument] = matched[0].replace(/#! ?/, \"\").split(\" \");\n\t            const binary = path.split(\"/\").pop();\n              if (binary === \"env\") {\n                shebang = argument;\n              } else {\n                shebang = argument ? \\`\\${binary} \\${argument}\\` : binary;\n              }\n            }\n\n            if (shebang) {\n              normalized.args.unshift(normalized.file);\n              normalized.command = shebang;\n\n              commandFile = await resolveCommand(normalized.command, normalized.options);\n            }\n          }\n\n          if (commandFile && (normalized.options.forceShell || /\\\\.(?:com|exe)$/i.test(commandFile))) {\n            normalized.command = normalize(normalized.command).replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\");\n\n            normalized.args = [\"/d\", \"/s\", \"/c\", \\`\"\\${normalized.command} \\${normalized.args.map(arg =>\n              \\`\\${arg}\\`.replace(/(?=(\\\\\\\\+?)?)\\\\1\"/g, \"$1$1\\\\\"\").replace(/(?=(\\\\\\\\+?)?)\\\\1$/, \"$1$1\")\n            ).map(arg =>\n              \\`\"\\${arg}\"\\`.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\")\n            ).map(arg =>\n              /node_modules[\\\\\\\\/].bin[\\\\\\\\/][^\\\\\\\\/]+\\\\.cmd$/i.test(commandFile) ? arg.replace(/([()\\\\][%!^\"\\`<>&|;, *?])/g, \"^$1\") : arg\n            ).join(\" \")}\"\\`];\n            normalized.command = process.env.comspec || \"cmd.exe\";\n            normalized.options.windowsVerbatimArguments = true;\n          }\n        }\n\n        let stdout = \"\";\n        let stderr = \"\";\n\n        const child = _spawn(normalized.command, normalized.args, {\n          cwd: process.cwd(),\n          env: {\n            ...process.env,\n            FORCE_COLOR: isColorSupported ? \"1\" : \"0\",\n          },\n          ...normalized.options,\n        }) as ReturnType<typeof _spawn>;\n\n        if (isWindows) {\n          const emit = child.emit;\n          child.emit = (eventName: string | symbol, ...eventArgs: any[]) => {\n            if (eventName === \"exit\") {\n              let err: Error | null = null;\n              if (eventArgs[0] === 1 && !normalized.file) {\n                err = Object.assign(new Error(\\`spawn \\${normalized.original.command} ENOENT\\`), {\n                  code: \"ENOENT\",\n                  errno: \"ENOENT\",\n                  syscall: \\`spawn \\${normalized.original.command}\\`,\n                  path: normalized.original.command,\n                  spawnargs: normalized.original.args,\n                });\n              }\n\n              if (err) {\n                return emit.call(child, \"error\", err);\n              }\n            }\n\n            return emit.apply(child, [eventName, ...eventArgs]);\n          };\n        }\n\n        return new Promise((resolve, reject) => {\n          if (normalized.options.stdin !== undefined) {\n            child.stdin?.write(normalized.options.stdin);\n          }\n\n          child.stdin?.end();\n\n          child.stdout?.on(\"data\", data => {\n            stdout += data;\n            if (normalized.options.stdout) {\n              normalized.options.stdout(data);\n            }\n          });\n\n          child.stderr?.on(\"data\", data => {\n            stderr += data;\n            if (normalized.options.stderr) {\n              normalized.options.stderr(data);\n            }\n          });\n\n          if (normalized.options.rejectOnError) {\n            child.addListener(\"error\", reject);\n          }\n\n          child.on(\"close\", code => {\n            if (code !== 0 && normalized.options.rejectOnError) {\n              reject(stderr);\n            } else {\n              resolve({ stdout, stderr });\n            }\n          });\n        }); `}\n      </FunctionDeclaration>\n    </>\n  );\n}\n\nexport function ContextUtilities() {\n  return code`\n  /**\n   * The global Shell Shock - Application context instance.\n   *\n   * @internal\n   */\n  export let internal_appContext = new AsyncLocalStorage<Map<string, any>>();\n\n  /**\n   * Get the Shell Shock - Application context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Application context for the current application or undefined if the context is not available.\n   */\n  export function useApp(): Map<string, any> | undefined {\n    return internal_appContext.getStore();\n  }\n\n  /**\n   * A utility hook function to get the command line arguments from the application context.\n   *\n   * @returns An array of command-line arguments from the application context.\n   * @throws If the application context is not available.\n   */\n  export function useArgs(): string[] {\n    return useApp()?.get(\"args\") ?? getArgs();\n  }\n\n  /**\n   * The context object for the current command execution, containing the command path and segments.\n   */\n  export interface CommandContext {\n    path: string;\n    segments: string[];\n  }\n\n  /**\n   * The global Shell Shock - Command context instance.\n   *\n   * @internal\n   */\n  export let internal_commandContext = new AsyncLocalStorage<CommandContext>();\n\n  /**\n   * Get the Shell Shock - Command context for the current application.\n   *\n   * @param options - The options to use when getting the context.\n   * @returns The Shell Shock - Command context for the current application.\n   * @throws If the Shell Shock - Command context is not available.\n   */\n  export function useCommand(): CommandContext {\n    const result = internal_commandContext.getStore();\n    if (!result) {\n      throw new Error(\n        \\`The Shell Shock - Command context is not available. Make sure to call useCommand() within a valid context scope.\\`\n      );\n    }\n    return result;\n  }\n\n  /**\n   * A utility hook function to get the individual segments of the current command path.\n   *\n   * @returns An array of command path segments.\n   * @throws If the command context is not available.\n   */\n  export function useSegments(): string[] {\n    return useCommand().segments;\n  }\n\n  /**\n   * A utility hook function to get the full command path as a string.\n   *\n   * @returns The full command path as a string.\n   * @throws If the command context is not available.\n   */\n  export function usePath(): string {\n    return useCommand().path;\n  }\n  `;\n}\n\n/**\n * A built-in utilities module for Shell Shock.\n */\nexport function UtilsBuiltin(props: UtilsBuiltinProps) {\n  const [{ children }, rest] = splitProps(props, [\"children\"]);\n\n  return (\n    <BuiltinFile\n      id=\"utils\"\n      description=\"A collection of helper utilities that ease command-line application development.\"\n      {...rest}\n      imports={defu(rest.imports ?? {}, {\n        \"node:os\": \"os\",\n        \"node:process\": \"process\",\n        \"node:path\": [\n          \"resolve\",\n          \"delimiter\",\n          \"normalize\",\n          \"join\",\n          \"posix\",\n          \"sep\"\n        ],\n        \"node:fs\": [\"openSync\", \"closeSync\"],\n        \"node:fs/promises\": [\"stat\", \"read\"],\n        \"node:child_process\": [{ name: \"spawn\", alias: \"_spawn\" }],\n        \"node:async_hooks\": [\"AsyncLocalStorage\"]\n      })}\n      builtinImports={defu(rest.builtinImports ?? {}, {\n        console: [\"error\", \"verbose\", \"writeLine\"],\n        env: [\"env\", \"isCI\", \"isTest\", \"isWindows\", \"isDevelopment\", \"isDebug\"]\n      })}>\n      <Spacing />\n      <ContextUtilities />\n      <Spacing />\n      <ArgsUtilities />\n      <Spacing />\n      <EnvSupportUtilities />\n      <Spacing />\n      <HyperlinkSupportUtilities />\n      <Spacing />\n      <ColorSupportUtilities />\n      <Spacing />\n      <SpawnFunctionDeclaration />\n      <Spacing />\n      <Show when={Boolean(children)}>{children}</Show>\n    </BuiltinFile>\n  );\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import * as _alloy_js_core3 from "@alloy-js/core";
+import * as _alloy_js_core8 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/utils-builtin.d.ts
@@ -6,24 +6,28 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function EnvSupportUtilities(): _alloy_js_core3.Children;
+declare function EnvSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ColorSupportUtilities(): _alloy_js_core3.Children;
+declare function ColorSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function HyperlinkSupportUtilities(): _alloy_js_core3.Children;
+declare function HyperlinkSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ArgsUtilities(): _alloy_js_core3.Children;
-declare function ContextUtilities(): _alloy_js_core3.Children;
+declare function ArgsUtilities(): _alloy_js_core8.Children;
+/**
+ * Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.
+ */
+declare function SpawnFunctionDeclaration(): _alloy_js_core8.Children;
+declare function ContextUtilities(): _alloy_js_core8.Children;
 /**
  * A built-in utilities module for Shell Shock.
  */
-declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core3.Children;
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core8.Children;
 //#endregion
-export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.d.cts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UAsCiB,iBAAA,SAA0B,KACzC;;AADF;AAQA;AAiCgB,iBAjCA,mBAAA,CAAA,CAiCqB,EAjCF,eAAA,CAAA,QAiCE;AAsMrC;AA0GA;AA4EA;AAsFgB,iBAldA,qBAAA,CAAA,CAkdoB,EAldC,eAAA,CAAA,QAkdgB;;;;iBA5QrC,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA0GzB,aAAA,CAAA,GAAa,eAAA,CAAA;iBA4Eb,gBAAA,CAAA,GAAgB,eAAA,CAAA;;;;iBAsFhB,YAAA,QAAoB,oBAAiB,eAAA,CAAA"}
+{"version":3,"file":"utils-builtin.d.cts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UAuCiB,iBAAA,SAA0B,KACzC;;AADF;AAQA;AAiCgB,iBAjCA,mBAAA,CAAA,CAiCqB,EAjCF,eAAA,CAAA,QAiCE;AAsMrC;AA0GA;AA+EA;AAkTgB,iBAjrBA,qBAAA,CAAA,CAirBgB,EAjrBK,eAAA,CAAA,QAirBL;AAsFhC;;;iBAjkBgB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA0GzB,aAAA,CAAA,GAAa,eAAA,CAAA;;;;iBA+Eb,wBAAA,CAAA,GAAwB,eAAA,CAAA;iBAkTxB,gBAAA,CAAA,GAAgB,eAAA,CAAA;;;;iBAsFhB,YAAA,QAAoB,oBAAiB,eAAA,CAAA"}

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

@@ -1,4 +1,4 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core8 from "@alloy-js/core";
 import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
 
 //#region src/components/utils-builtin.d.ts
@@ -6,24 +6,28 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function EnvSupportUtilities(): _alloy_js_core0.Children;
+declare function EnvSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ColorSupportUtilities(): _alloy_js_core0.Children;
+declare function ColorSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function HyperlinkSupportUtilities(): _alloy_js_core0.Children;
+declare function HyperlinkSupportUtilities(): _alloy_js_core8.Children;
 /**
  * Generates utilities for detecting terminal color support.
  */
-declare function ArgsUtilities(): _alloy_js_core0.Children;
-declare function ContextUtilities(): _alloy_js_core0.Children;
+declare function ArgsUtilities(): _alloy_js_core8.Children;
+/**
+ * Generates the `spawn` function declaration, which is a cross-platform utility for spawning child processes with proper color support and environment variable handling.
+ */
+declare function SpawnFunctionDeclaration(): _alloy_js_core8.Children;
+declare function ContextUtilities(): _alloy_js_core8.Children;
 /**
  * A built-in utilities module for Shell Shock.
  */
-declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core0.Children;
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core8.Children;
 //#endregion
-export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
+export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps };
 //# sourceMappingURL=utils-builtin.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils-builtin.d.mts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UAsCiB,iBAAA,SAA0B,KACzC;;AADF;AAQA;AAiCgB,iBAjCA,mBAAA,CAAA,CAiCqB,EAjCF,eAAA,CAAA,QAiCE;AAsMrC;AA0GA;AA4EA;AAsFgB,iBAldA,qBAAA,CAAA,CAkdoB,EAldC,eAAA,CAAA,QAkdgB;;;;iBA5QrC,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA0GzB,aAAA,CAAA,GAAa,eAAA,CAAA;iBA4Eb,gBAAA,CAAA,GAAgB,eAAA,CAAA;;;;iBAsFhB,YAAA,QAAoB,oBAAiB,eAAA,CAAA"}
+{"version":3,"file":"utils-builtin.d.mts","names":[],"sources":["../../src/components/utils-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UAuCiB,iBAAA,SAA0B,KACzC;;AADF;AAQA;AAiCgB,iBAjCA,mBAAA,CAAA,CAiCqB,EAjCF,eAAA,CAAA,QAiCE;AAsMrC;AA0GA;AA+EA;AAkTgB,iBAjrBA,qBAAA,CAAA,CAirBgB,EAjrBK,eAAA,CAAA,QAirBL;AAsFhC;;;iBAjkBgB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA0GzB,aAAA,CAAA,GAAa,eAAA,CAAA;;;;iBA+Eb,wBAAA,CAAA,GAAwB,eAAA,CAAA;iBAkTxB,gBAAA,CAAA,GAAgB,eAAA,CAAA;;;;iBAsFhB,YAAA,QAAoB,oBAAiB,eAAA,CAAA"}