@shell-shock/core 0.1.1 → 0.2.1

package/dist/components/utils-builtin.cjs

@@ -0,0 +1,453 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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"; `
+		})
+	];
+}
+/**
+* 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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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: "{}"
+			}],
+			children: __alloy_js_core.code`const { ignoreFlags = false } = 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) {
+          forceColor = hasFlag("no-color") ||
+            hasFlag("no-colors") ||
+            hasFlag("color=false") ||
+            hasFlag("color=never")
+          ? 0
+          : hasFlag("color") ||
+            hasFlag("colors") ||
+            hasFlag("color=true") ||
+            hasFlag("color=always")
+          ? 1
+          : 0;
+        }
+
+        if (forceColor === 0) {
+          return 0;
+        }
+
+        if (ignoreFlags !== true) {
+          if (hasFlag("color=16m") ||
+            hasFlag("color=full") ||
+            hasFlag("color=truecolor")) {
+            return 3;
+          }
+
+          if (hasFlag("color=256")) {
+            return 2;
+          }
+        }
+
+        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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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.createIntrinsic)("hbr", {}),
+		(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+		(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_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: "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[]",
+			optional: true,
+			default: "globalThis.Deno ? globalThis.Deno.args : process.argv"
+		}],
+		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 + "=")?.toLowerCase());
+            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("--");`
+			];
+		}
+	})];
+}
+/**
+* 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"]
+			});
+		},
+		get builtinImports() {
+			return (0, defu.default)(rest.builtinImports ?? {}, { env: [
+				"env",
+				"isCI",
+				"isTest",
+				"isWindows"
+			] });
+		},
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(ArgsUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(EnvSupportUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(HyperlinkSupportUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(ColorSupportUtilities, {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+				(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.EnvSupportUtilities = EnvSupportUtilities;
+exports.HyperlinkSupportUtilities = HyperlinkSupportUtilities;
+exports.UtilsBuiltin = UtilsBuiltin;

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

@@ -0,0 +1,27 @@
+import * as _alloy_js_core0 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_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ColorSupportUtilities(): _alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function HyperlinkSupportUtilities(): _alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ArgsUtilities(): _alloy_js_core0.Children;
+/**
+ * A built-in utilities module for Shell Shock.
+ */
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core0.Children;
+//#endregion
+export { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };

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

@@ -0,0 +1,27 @@
+import * as _alloy_js_core0 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_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ColorSupportUtilities(): _alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function HyperlinkSupportUtilities(): _alloy_js_core0.Children;
+/**
+ * Generates utilities for detecting terminal color support.
+ */
+declare function ArgsUtilities(): _alloy_js_core0.Children;
+/**
+ * A built-in utilities module for Shell Shock.
+ */
+declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core0.Children;
+//#endregion
+export { ArgsUtilities, ColorSupportUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };