@shell-shock/core 0.8.11 → 0.8.13

package/dist/components/utils-builtin.cjs

@@ -0,0 +1,572 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __alloy_js_core = require("@alloy-js/core");
+let __powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+let __powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let __powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+
+//#region src/components/utils-builtin.tsx
+/**
+* Generates utilities for detecting terminal color support.
+*/
+function EnvSupportUtilities() {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "isTTY",
+			doc: "Detect if stdout.TTY is available",
+			initializer: __alloy_js_core.code`Boolean(process.stdout && process.stdout.isTTY);`
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "isMinimal",
+			doc: "Detect if the current environment is minimal (CI, non-TTY, etc.)",
+			initializer: __alloy_js_core.code` env.MINIMAL || isCI || isTest || !isTTY; `
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "isInteractive",
+			doc: "Detect if the current environment is interactive",
+			initializer: __alloy_js_core.code` !isMinimal && process.stdin?.isTTY && env.TERM !== "dumb" && !hasFlag(["no-interactive", "non-interactive", "no-interact"]); `
+		})
+	];
+}
+/**
+* Generates utilities for detecting terminal color support.
+*/
+function ColorSupportUtilities() {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "GetColorSupportLevelOptions",
+			doc: "Options for the getColorSupportLevel function",
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.InterfaceMember, {
+					name: "ignoreFlags",
+					type: "boolean",
+					doc: "Indicates if the function should skip checking command-line flags for color support"
+				});
+			}
+		}),
+		(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: "Checks if a specific flag is present in the command-line arguments.",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "flag",
+						children: "The flag to check for, e.g., \"color\", \"no-color\"."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "argv",
+						children: "The command-line arguments to check against. Defaults to global Deno args or process args."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the flag is present, false otherwise." })
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "getColorSupportLevel",
+			parameters: [{
+				name: "stream",
+				type: "NodeJS.WriteStream & { fd: 1 | 2; }"
+			}, {
+				name: "options",
+				type: "GetColorSupportLevelOptions",
+				default: "{ ignoreFlags: false }"
+			}],
+			children: __alloy_js_core.code`const { ignoreFlags } = options;
+
+        let forceColor: number | undefined;
+        if (env.FORCE_COLOR !== undefined) {
+          forceColor = !env.FORCE_COLOR
+            ? 0
+            : typeof env.FORCE_COLOR === "boolean"
+            ? 1
+            : typeof env.FORCE_COLOR === "number" &&
+              [0, 1, 2, 3].includes(Math.min(env.FORCE_COLOR as number, 3))
+            ? Math.min(env.FORCE_COLOR as number, 3)
+            : undefined;
+        }
+
+        if (ignoreFlags !== true && forceColor === undefined) {
+          if (
+            hasFlag("no-color") ||
+            hasFlag("no-colors") ||
+            hasFlag("color=false") ||
+            hasFlag("color=never")
+          ) {
+            return 0;
+          }
+
+          if (
+            hasFlag("color=16m") ||
+            hasFlag("color=full") ||
+            hasFlag("color=truecolor")
+          ) {
+            return 3;
+          }
+
+          if (hasFlag("color=256")) {
+            return 2;
+          }
+
+          if (
+            hasFlag("color") ||
+            hasFlag("colors") ||
+            hasFlag("color=true") ||
+            hasFlag("color=always")
+          ) {
+            forceColor = 1;
+          }
+        }
+
+        const level = Boolean(env.TF_BUILD) || Boolean(env.AGENT_NAME)
+          ? 1
+          : stream &&
+              !(isTTY || (stream && stream.isTTY)) &&
+              forceColor === undefined
+            ? 0
+            : env.TERM === "dumb"
+              ? forceColor || 0
+              : isWindows
+                ? Number(os.release().split(".")[0]) >= 10 &&
+                  Number(os.release().split(".")[2]) >= 10_586
+                  ? Number(os.release().split(".")[2]) >= 14_931
+                    ? 3
+                    : 2
+                  : 1
+                : isCI
+                  ? Boolean(env.GITHUB_ACTIONS) ||
+                    Boolean(env.GITEA_ACTIONS) ||
+                    Boolean(env.CIRCLECI)
+                    ? 3
+                    : Boolean(env.TRAVIS) ||
+                      Boolean(env.APPVEYOR) ||
+                      Boolean(env.GITLAB_CI) ||
+                      Boolean(env.BUILDKITE) ||
+                      Boolean(env.DRONE) ||
+                      env.CI_NAME === "codeship"
+                      ? 1
+                      : forceColor || 0
+                  : Boolean(env.TEAMCITY_VERSION)
+                    ? /^(?:9\.0*[1-9]\d*\.|\d{2,}\.)/.test(String(env.TEAMCITY_VERSION) || "")
+                      ? 1
+                      : 0
+                    : String(env.COLORTERM) === "truecolor" ||
+                        env.TERM === "xterm-kitty"
+                      ? 3
+                      : Boolean(env.TERM_PROGRAM)
+                        ? env.TERM_PROGRAM === "iTerm.app"
+                          ? Number.parseInt(
+                              (env.TERM_PROGRAM_VERSION || "").split(".")[0] as string,
+                              10
+                            ) >= 3
+                            ? 3
+                            : 2
+                          : env.TERM_PROGRAM === "Apple_Terminal"
+                            ? 2
+                            : 0
+                        : /-256(?:color)?$/i.test(env.TERM || "")
+                          ? 2
+                          : /^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(
+                                env.TERM || ""
+                              )
+                            ? 1
+                            : Boolean(env.COLORTERM);
+
+        return typeof level === "boolean" || level === 0
+          ? false
+          : {
+              level,
+              hasBasic: true,
+              has256: level >= 2,
+              has16m: level >= 3,
+            };
+
+  `
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "colorSupportLevels",
+			doc: "Detect the terminal color support level in the current environment",
+			initializer: __alloy_js_core.code` {
+    stdout: getColorSupportLevel(process.stdout),
+    stderr: getColorSupportLevel(process.stderr),
+  }; `
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "isColorSupported",
+			doc: "Detect if terminal color is supported in the current environment",
+			initializer: __alloy_js_core.code` Boolean(colorSupportLevels.stdout); `
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "isUnicodeSupported",
+			doc: "Detect if Unicode characters are supported in the current environment",
+			initializer: __alloy_js_core.code` !isWindows
+            ? env.TERM !== "linux"
+            : Boolean(env.WT_SESSION) ||
+                Boolean(env.TERMINUS_SUBLIME) ||
+                env.ConEmuTask === "{cmd::Cmder}" ||
+                env.TERM_PROGRAM === "Terminus-Sublime" ||
+                env.TERM_PROGRAM === "vscode" ||
+                env.TERM === "xterm-256color" ||
+                env.TERM === "alacritty" ||
+                env.TERM === "rxvt-unicode" ||
+                env.TERM === "rxvt-unicode-256color" ||
+                env.TERMINAL_EMULATOR === "JetBrains-JediTerm"; `
+		})
+	];
+}
+/**
+* Generates utilities for detecting terminal color support.
+*/
+function HyperlinkSupportUtilities() {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			name: "parseVersion",
+			parameters: [{
+				name: "version",
+				type: "string",
+				default: "\"\""
+			}],
+			children: __alloy_js_core.code`if (/^\d{3,4}$/.test(version)) {
+        const match = /(\d{1,2})(\d{2})/.exec(version) ?? [];
+
+        return {
+          major: 0,
+          minor: Number.parseInt(match[1]!, 10),
+          patch: Number.parseInt(match[2]!, 10)
+        };
+      }
+
+      const versionParts = (version ?? "")
+        .split(".")
+        .map(n => Number.parseInt(n, 10));
+
+      return {
+        major: versionParts[0],
+        minor: versionParts[1],
+        patch: versionParts[2]
+      }; `
+		}),
+		(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: "Check if the current environment/terminal supports hyperlinks in the terminal.",
+			get children() {
+				return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the current environment/terminal supports hyperlinks." });
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "isHyperlinkSupported",
+			returnType: "boolean",
+			children: __alloy_js_core.code`if (Boolean(env.FORCE_HYPERLINK)) {
+          return true;
+        }
+
+        if (Boolean(env.NETLIFY)) {
+          return true;
+        } else if (isColorSupported || isTTY) {
+          return false;
+        } else if (Boolean(env.WT_SESSION)) {
+          return true;
+        } else if (isWindows || isMinimal || Boolean(env.TEAMCITY_VERSION)) {
+          return false;
+        } else if (Boolean(env.TERM_PROGRAM)) {
+          const version = parseVersion(env.TERM_PROGRAM_VERSION);
+
+          switch (String(env.TERM_PROGRAM)) {
+            case "iTerm.app": {
+              if (version.major === 3) {
+                return version.minor !== undefined && version.minor >= 1;
+              }
+
+              return version.major !== undefined && version.major > 3;
+            }
+            case "WezTerm": {
+              return version.major !== undefined && version.major >= 20_200_620;
+            }
+
+            case "vscode": {
+              if (Boolean(env.CURSOR_TRACE_ID)) {
+                return true;
+              }
+
+              return (
+                version.minor !== undefined &&
+                version.major !== undefined &&
+                (version.major > 1 || (version.major === 1 && version.minor >= 72))
+              );
+            }
+
+            case "ghostty": {
+              return true;
+            }
+          }
+        }
+
+        if (Boolean(env.VTE_VERSION)) {
+          if (env.VTE_VERSION === "0.50.0") {
+            return false;
+          }
+
+          const version = parseVersion(env.VTE_VERSION);
+          return (
+            (version.major !== undefined && version.major > 0) ||
+            (version.minor !== undefined && version.minor >= 50)
+          );
+        }
+
+        if (String(env.TERM) === "alacritty") {
+          return true;
+        }
+
+        return false; `
+		})
+	];
+}
+/**
+* Generates utilities for detecting terminal color support.
+*/
+function ArgsUtilities() {
+	return [
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "Retrieves the command-line arguments from Deno or Node.js environments.",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: "This function is only intended for internal use. Please use `useArgs()` instead." }),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocInternal, {}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An array of command-line arguments from Deno or Node.js environments." })
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "getArgs",
+			returnType: "string[]",
+			children: __alloy_js_core.code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`
+		}),
+		(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: "Checks if a specific flag is present in the command-line arguments.",
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "flag",
+						children: "The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\"."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "argv",
+						children: "The command-line arguments to check against. Defaults to global Deno args or process args."
+					}),
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the flag is present, false otherwise." })
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "hasFlag",
+			parameters: [{
+				name: "flag",
+				type: "string | string[]"
+			}, {
+				name: "argv",
+				type: "string[]",
+				default: "useArgs()"
+			}],
+			get children() {
+				return [
+					(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+						"const": true,
+						name: "position",
+						type: "number",
+						initializer: __alloy_js_core.code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {
+            const pos = argv.findIndex(arg => (f.startsWith("-") ? "" : (f.length === 1 ? "-" : "--") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? "-" : "--") + f + "="));
+            return pos !== -1 ? pos : ret;
+          }, -1);`
+					}),
+					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					__alloy_js_core.code`return position !== -1 && argv.indexOf("--") === -1 || position < argv.indexOf("--");`
+				];
+			}
+		}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			name: "isHelp",
+			type: "boolean",
+			initializer: __alloy_js_core.code` !isCI && hasFlag(["help", "h", "?"]); `
+		})
+	];
+}
+function ContextUtilities() {
+	return __alloy_js_core.code`
+  /**
+   * The global Shell Shock - Application context instance.
+   *
+   * @internal
+   */
+  export let internal_appContext = new AsyncLocalStorage<Map<string, any>>();
+
+  /**
+   * Get the Shell Shock - Application context for the current application.
+   *
+   * @param options - The options to use when getting the context.
+   * @returns The Shell Shock - Application context for the current application or undefined if the context is not available.
+   */
+  export function useApp(): Map<string, any> | undefined {
+    return internal_appContext.getStore();
+  }
+
+  /**
+   * A utility hook function to get the command line arguments from the application context.
+   *
+   * @returns An array of command-line arguments from the application context.
+   * @throws If the application context is not available.
+   */
+  export function useArgs(): string[] {
+    return useApp()?.get("args") ?? getArgs();
+  }
+
+  /**
+   * The context object for the current command execution, containing the command path and segments.
+   */
+  export interface CommandContext {
+    path: string;
+    segments: string[];
+  }
+
+  /**
+   * The global Shell Shock - Command context instance.
+   *
+   * @internal
+   */
+  export let internal_commandContext = new AsyncLocalStorage<CommandContext>();
+
+  /**
+   * Get the Shell Shock - Command context for the current application.
+   *
+   * @param options - The options to use when getting the context.
+   * @returns The Shell Shock - Command context for the current application.
+   * @throws If the Shell Shock - Command context is not available.
+   */
+  export function useCommand(): CommandContext {
+    const result = internal_commandContext.getStore();
+    if (!result) {
+      throw new Error(
+        \`The Shell Shock - Command context is not available. Make sure to call useCommand() within a valid context scope.\`
+      );
+    }
+    return result;
+  }
+
+  /**
+   * A utility hook function to get the individual segments of the current command path.
+   *
+   * @returns An array of command path segments.
+   * @throws If the command context is not available.
+   */
+  export function useSegments(): string[] {
+    return useCommand().segments;
+  }
+
+  /**
+   * A utility hook function to get the full command path as a string.
+   *
+   * @returns The full command path as a string.
+   * @throws If the command context is not available.
+   */
+  export function usePath(): string {
+    return useCommand().path;
+  }
+  `;
+}
+/**
+* A built-in utilities module for Shell Shock.
+*/
+function UtilsBuiltin(props) {
+	const [{ children }, rest] = (0, __alloy_js_core.splitProps)(props, ["children"]);
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, __alloy_js_core_jsx_runtime.mergeProps)({
+		id: "utils",
+		description: "A collection of helper utilities that ease command-line application development."
+	}, rest, {
+		get imports() {
+			return (0, defu.default)(rest.imports ?? {}, {
+				"node:os": "os",
+				"node:process": "process",
+				"node:async_hooks": ["AsyncLocalStorage"]
+			});
+		},
+		get builtinImports() {
+			return (0, defu.default)(rest.builtinImports ?? {}, {
+				console: [
+					"error",
+					"verbose",
+					"writeLine"
+				],
+				env: [
+					"env",
+					"isCI",
+					"isTest",
+					"isWindows",
+					"isDevelopment",
+					"isDebug"
+				]
+			});
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(ContextUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(ArgsUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(EnvSupportUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(HyperlinkSupportUtilities, {}),
+				(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)(__alloy_js_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+
+//#endregion
+exports.ArgsUtilities = ArgsUtilities;
+exports.ColorSupportUtilities = ColorSupportUtilities;
+exports.ContextUtilities = ContextUtilities;
+exports.EnvSupportUtilities = EnvSupportUtilities;
+exports.HyperlinkSupportUtilities = HyperlinkSupportUtilities;
+exports.UtilsBuiltin = UtilsBuiltin;
+//# sourceMappingURL=utils-builtin.cjs.map

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

@@ -0,0 +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":";;;;;;;;;;;;;;AA8CA,SAAgBgB,sBAAsB;AACpC,QAAA;mDAEKV,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;GAAkD,CAAA;mDAEpEO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;GAA4C,CAAA;mDAE9DO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;GAAgI,CAAA;EAAA;;;;;AASzJ,SAAgBqB,wBAAwB;AACtC,QAAA;mDAEKjB,4CAAoB;GAAA,UAAA;GAEnBc,MAAI;GACJC,KAAG;GAAA,IAAAG,WAAA;AAAA,4DACFjB,uCAAe;KACda,MAAI;KACJK,MAAI;KACJJ,KAAG;KAAA,CAAA;;GAAA,CAAA;mDAGNZ,2DAAO,EAAA,CAAA;mDACPE,6DAAK;GAACe,SAAO;GAAA,IAAAF,WAAA;AAAA,WAAA;sDACXX,iEAAS,EAAAW,UACP,+DAA6D,CAAA;sDAE/DV,kEAAU;MAACM,MAAI;MAAAI,UACb;MAAmD,CAAA;sDAErDV,kEAAU;MAACM,MAAI;MAAAI,UAEZ;MAA4F,CAAA;sDAG/FR,oEAAY,EAAAQ,UACV,iDAA+C,CAAA;KAAA;;GAAA,CAAA;mDAGnDnB,2CAAmB;GAAA,UAAA;GAElBe,MAAI;GACJO,YAAY,CACV;IAAEP,MAAM;IAAUK,MAAM;IAAuC,EAC/D;IACEL,MAAM;IACNK,MAAM;IACNG,SAAS;IACV,CACF;GAAAJ,UACAtB,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GV,CAAA;mDAEIO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;;;;GAGnB,CAAA;mDAECO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;GAAuC,CAAA;mDAEzDO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAAA,SAAA;GAGbY,MAAI;GACJC,KAAG;GACHC,aAAapB,oBAAI;;;;;;;;;;;;GAWwC,CAAA;EAAA;;;;;AAUjE,SAAgB2B,4BAA4B;AAC1C,QAAA;mDAEKxB,2CAAmB;GAClBe,MAAI;GACJO,YAAY,CAAC;IAAEP,MAAM;IAAWK,MAAM;IAAUG,SAAS;IAAM,CAAC;GAAAJ,UAC/DtB,oBAAI;;;;;;;;;;;;;;;;;;;GAkBH,CAAA;mDAEHO,2DAAO,EAAA,CAAA;mDACPE,6DAAK;GAACe,SAAO;GAAA,IAAAF,WAAA;AAAA,4DACXR,oEAAY,EAAAQ,UACV,iEAA+D,CAAA;;GAAA,CAAA;mDAGnEnB,2CAAmB;GAAA,UAAA;GAElBe,MAAI;GACJU,YAAU;GAAAN,UACTtB,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DU,CAAA;EAAA;;;;;AASvB,SAAgB6B,gBAAgB;AAC9B,QAAA;mDAEKpB,6DAAK;GAACe,SAAO;GAAA,IAAAF,WAAA;AAAA,WAAA;sDACXT,oEAAY,EAAAS,UAET,oFAAkF,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAKrFZ,qEAAa,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAAA,OAAA,EAAA,CAAA;sDAGbI,oEAAY,EAAAQ,UAET,yEAAuE,CAAA;KAAA;;GAAA,CAAA;mDAI5EnB,2CAAmB;GAAA,UAAA;GAAQe,MAAI;GAAWU,YAAU;GAAAN,UAClDtB,oBAAI;GAAuG,CAAA;mDAE7GO,2DAAO,EAAA,CAAA;mDACPE,6DAAK;GAACe,SAAO;GAAA,IAAAF,WAAA;AAAA,WAAA;sDACXX,iEAAS,EAAAW,UACP,+DAA6D,CAAA;sDAE/DV,kEAAU;MAACM,MAAI;MAAAI,UAEZ;MAAkF,CAAA;sDAGrFV,kEAAU;MAACM,MAAI;MAAAI,UAEZ;MAA4F,CAAA;sDAG/FR,oEAAY,EAAAQ,UACV,iDAA+C,CAAA;KAAA;;GAAA,CAAA;mDAGnDnB,2CAAmB;GAAA,UAAA;GAElBe,MAAI;GACJO,YAAY,CACV;IAAEP,MAAM;IAAQK,MAAM;IAAqB,EAC3C;IACEL,MAAM;IACNK,MAAM;IACNG,SAAS;IACV,CACF;GAAA,IAAAJ,WAAA;AAAA,WAAA;sDACAhB,sCAAc;MAAA,SAAA;MAEbY,MAAI;MACJK,MAAI;MACJH,aAAapB,oBAAI;;;;MAGT,CAAA;sDAAA,OAAA,EAAA,CAAA;KAGTA,oBAAI;KAAuF;;GAAA,CAAA;mDAE7FO,2DAAO,EAAA,CAAA;mDACPD,sCAAc;GAAA,UAAA;GAEbY,MAAI;GACJK,MAAI;GACJH,aAAapB,oBAAI;GAAyC,CAAA;EAAA;;AAMlE,SAAgB+B,mBAAmB;AACjC,QAAO/B,oBAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqFb,SAAgBgC,aAAaC,OAA0B;CACrD,MAAM,CAAC,EAAEX,YAAYY,wCAAmBD,OAAO,CAAC,WAAW,CAAC;AAE5D,yDACGzB,sHAAW;EACV4B,IAAE;EACFC,aAAW;EAAA,EACPH,MAAI;EAAA,IACRI,UAAO;AAAA,4BAAOJ,KAAKI,WAAW,EAAE,EAAE;IAChC,WAAW;IACX,gBAAgB;IAChB,oBAAoB,CAAC,oBAAmB;IACzC,CAAC;;EAAA,IACFC,iBAAc;AAAA,4BAAOL,KAAKK,kBAAkB,EAAE,EAAE;IAC9CC,SAAS;KAAC;KAAS;KAAW;KAAY;IAC1CC,KAAK;KAAC;KAAO;KAAQ;KAAU;KAAa;KAAiB;KAAS;IACvE,CAAC;;EAAA,IAAAnB,WAAA;AAAA,UAAA;qDACDf,2DAAO,EAAA,CAAA;qDACPwB,kBAAgB,EAAA,CAAA;qDAChBxB,2DAAO,EAAA,CAAA;qDACPsB,eAAa,EAAA,CAAA;qDACbtB,2DAAO,EAAA,CAAA;qDACPS,qBAAmB,EAAA,CAAA;qDACnBT,2DAAO,EAAA,CAAA;qDACPoB,2BAAyB,EAAA,CAAA;qDACzBpB,2DAAO,EAAA,CAAA;qDACPc,uBAAqB,EAAA,CAAA;qDACrBd,2DAAO,EAAA,CAAA;qDACPN,sBAAI;KAAA,IAACyC,OAAI;AAAA,aAAEC,QAAQrB,SAAS;;KAAGA;KAAQ,CAAA;IAAA;;EAAA,CAAA,CAAA"}

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

@@ -0,0 +1,29 @@
+import * as _alloy_js_core3 from "@alloy-js/core";
+import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
+
+//#region src/components/utils-builtin.d.ts
+interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description"> {}
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function EnvSupportUtilities(): _alloy_js_core3.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ColorSupportUtilities(): _alloy_js_core3.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function HyperlinkSupportUtilities(): _alloy_js_core3.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ArgsUtilities(): _alloy_js_core3.Children;
+declare function ContextUtilities(): _alloy_js_core3.Children;
+/**
+ * A built-in utilities module for Shell Shock.
+ */
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core3.Children;
+//#endregion
+export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
+//# sourceMappingURL=utils-builtin.d.cts.map

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

@@ -0,0 +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"}