@shell-shock/preset-script 0.6.7 → 0.6.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/components/banner-function-declaration.cjs +3 -3
- package/dist/components/banner-function-declaration.cjs.map +1 -1
- package/dist/components/banner-function-declaration.d.cts.map +1 -1
- package/dist/components/banner-function-declaration.d.mts.map +1 -1
- package/dist/components/banner-function-declaration.mjs +3 -3
- package/dist/components/banner-function-declaration.mjs.map +1 -1
- package/dist/components/command-entry.cjs +1 -1
- package/dist/components/command-entry.cjs.map +1 -1
- package/dist/components/command-entry.mjs +1 -1
- package/dist/components/command-entry.mjs.map +1 -1
- package/dist/components/console-builtin.cjs +21 -5
- package/dist/components/console-builtin.cjs.map +1 -1
- package/dist/components/console-builtin.d.cts.map +1 -1
- package/dist/components/console-builtin.d.mts.map +1 -1
- package/dist/components/console-builtin.mjs +21 -5
- package/dist/components/console-builtin.mjs.map +1 -1
- package/dist/components/helpers.d.cts +5 -5
- package/dist/components/helpers.d.cts.map +1 -1
- package/dist/components/utils-builtin.cjs +10 -10
- package/dist/components/utils-builtin.cjs.map +1 -1
- package/dist/components/utils-builtin.d.cts +8 -8
- package/dist/components/utils-builtin.mjs +10 -10
- package/dist/components/utils-builtin.mjs.map +1 -1
- package/dist/helpers/ansi-utils.cjs +4 -0
- package/dist/helpers/ansi-utils.cjs.map +1 -1
- package/dist/helpers/ansi-utils.d.cts.map +1 -1
- package/dist/helpers/ansi-utils.d.mts.map +1 -1
- package/dist/helpers/ansi-utils.mjs +4 -0
- package/dist/helpers/ansi-utils.mjs.map +1 -1
- package/dist/types/plugin.d.mts.map +1 -1
- package/package.json +10 -10
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as _alloy_js_core12 from "@alloy-js/core";
|
|
2
2
|
|
|
3
3
|
//#region src/components/helpers.d.ts
|
|
4
4
|
|
|
@@ -8,22 +8,22 @@ import * as _alloy_js_core5 from "@alloy-js/core";
|
|
|
8
8
|
* @remarks
|
|
9
9
|
* This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
|
|
10
10
|
*/
|
|
11
|
-
declare function IsDebug():
|
|
11
|
+
declare function IsDebug(): _alloy_js_core12.Children;
|
|
12
12
|
/**
|
|
13
13
|
* Write the logic to determine if the application is **not** running in debug mode.
|
|
14
14
|
*/
|
|
15
|
-
declare function IsNotDebug():
|
|
15
|
+
declare function IsNotDebug(): _alloy_js_core12.Children;
|
|
16
16
|
/**
|
|
17
17
|
* Write the logic to determine if the application is running in verbose mode.
|
|
18
18
|
*
|
|
19
19
|
* @remarks
|
|
20
20
|
* This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
|
|
21
21
|
*/
|
|
22
|
-
declare function IsVerbose():
|
|
22
|
+
declare function IsVerbose(): _alloy_js_core12.Children;
|
|
23
23
|
/**
|
|
24
24
|
* Write the logic to determine if the application is **not** running in verbose mode.
|
|
25
25
|
*/
|
|
26
|
-
declare function IsNotVerbose():
|
|
26
|
+
declare function IsNotVerbose(): _alloy_js_core12.Children;
|
|
27
27
|
//#endregion
|
|
28
28
|
export { IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
|
|
29
29
|
//# sourceMappingURL=helpers.d.cts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;AAOA;AAgBA;AAagB,iBApCA,OAAA,CAAA,CAoCY,EApCL,
|
|
1
|
+
{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;AAOA;AAgBA;AAagB,iBApCA,OAAA,CAAA,CAoCY,EApCL,gBAAA,CAAA,QAoCK;;;;iBA7BZ,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA"}
|
|
@@ -61,7 +61,7 @@ function ColorSupportUtilities() {
|
|
|
61
61
|
}),
|
|
62
62
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
|
|
63
63
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
|
|
64
|
-
heading: "Checks if a specific flag is present in the command
|
|
64
|
+
heading: "Checks if a specific flag is present in the command-line arguments.",
|
|
65
65
|
get children() {
|
|
66
66
|
return [
|
|
67
67
|
(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" }),
|
|
@@ -71,7 +71,7 @@ function ColorSupportUtilities() {
|
|
|
71
71
|
}),
|
|
72
72
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
|
|
73
73
|
name: "argv",
|
|
74
|
-
children: "The command
|
|
74
|
+
children: "The command-line arguments to check against. Defaults to global Deno args or process args."
|
|
75
75
|
}),
|
|
76
76
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the flag is present, false otherwise." })
|
|
77
77
|
];
|
|
@@ -353,7 +353,7 @@ function HyperlinkSupportUtilities() {
|
|
|
353
353
|
function ArgsUtilities() {
|
|
354
354
|
return [
|
|
355
355
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
|
|
356
|
-
heading: "Retrieves the command
|
|
356
|
+
heading: "Retrieves the command-line arguments from Deno or Node.js environments.",
|
|
357
357
|
get children() {
|
|
358
358
|
return [
|
|
359
359
|
(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." }),
|
|
@@ -362,7 +362,7 @@ function ArgsUtilities() {
|
|
|
362
362
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocInternal, {}),
|
|
363
363
|
(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
|
|
364
364
|
(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
|
|
365
|
-
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An array of command
|
|
365
|
+
(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." })
|
|
366
366
|
];
|
|
367
367
|
}
|
|
368
368
|
}),
|
|
@@ -374,7 +374,7 @@ function ArgsUtilities() {
|
|
|
374
374
|
}),
|
|
375
375
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
|
|
376
376
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
|
|
377
|
-
heading: "Checks if a specific flag is present in the command
|
|
377
|
+
heading: "Checks if a specific flag is present in the command-line arguments.",
|
|
378
378
|
get children() {
|
|
379
379
|
return [
|
|
380
380
|
(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" }),
|
|
@@ -384,7 +384,7 @@ function ArgsUtilities() {
|
|
|
384
384
|
}),
|
|
385
385
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
|
|
386
386
|
name: "argv",
|
|
387
|
-
children: "The command
|
|
387
|
+
children: "The command-line arguments to check against. Defaults to global Deno args or process args."
|
|
388
388
|
}),
|
|
389
389
|
(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the flag is present, false otherwise." })
|
|
390
390
|
];
|
|
@@ -522,7 +522,7 @@ function ExitFunctionDeclaration() {
|
|
|
522
522
|
}
|
|
523
523
|
|
|
524
524
|
if (options.exception) {
|
|
525
|
-
error(\`A fatal error occured while running the application - please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team
|
|
525
|
+
error(\`A fatal error occured while running the application - please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`);
|
|
526
526
|
}
|
|
527
527
|
|
|
528
528
|
const terminate = (force = false) => { `),
|
|
@@ -536,7 +536,7 @@ function ExitFunctionDeclaration() {
|
|
|
536
536
|
(0, __alloy_js_core_jsx_runtime.memo)(() => __alloy_js_core.code`
|
|
537
537
|
verbose(\`The ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
|
|
538
538
|
if (!options.skipProcessExit) {
|
|
539
|
-
process.exit(exitCode);
|
|
539
|
+
process.nextTick(() => process.exit(exitCode));
|
|
540
540
|
}
|
|
541
541
|
};
|
|
542
542
|
|
|
@@ -564,7 +564,7 @@ function ExitFunctionDeclaration() {
|
|
|
564
564
|
error(\`The exit process failed to complete\${(err as Error).message ? \` - (err as Error).message\` : ""}. Please contact the ${(0, __shell_shock_core_plugin_utils_context_helpers.getAppTitle)(context)} support team.\`);
|
|
565
565
|
|
|
566
566
|
if (!options.skipProcessExit) {
|
|
567
|
-
process.exit(1);
|
|
567
|
+
process.nextTick(() => process.exit(1));
|
|
568
568
|
}
|
|
569
569
|
}
|
|
570
570
|
`)
|
|
@@ -595,7 +595,7 @@ function ContextUtilities() {
|
|
|
595
595
|
/**
|
|
596
596
|
* A utility hook function to get the command line arguments from the application context.
|
|
597
597
|
*
|
|
598
|
-
* @returns An array of command
|
|
598
|
+
* @returns An array of command-line arguments from the application context.
|
|
599
599
|
* @throws If the application context is not available.
|
|
600
600
|
*/
|
|
601
601
|
export function useArgs(): string[] {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils-builtin.cjs","names":["code","Show","splitProps","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","getAppTitle","defu","IsVerbose","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","ExitFunctionDeclaration","context","optional","async","_$memo","condition","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 IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n TSDoc,\n TSDocInternal,\n TSDocLink,\n TSDocParam,\n TSDocRemarks,\n TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\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 * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.exit(exitCode);\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n context\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.exit(1);\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: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 <ExitFunctionDeclaration />\n <Spacing />\n <Show when={Boolean(children)}>{children}</Show>\n </BuiltinFile>\n );\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"utils-builtin.cjs","names":["code","Show","splitProps","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","getAppTitle","defu","IsVerbose","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","ExitFunctionDeclaration","context","optional","async","_$memo","condition","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 IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n TSDoc,\n TSDocInternal,\n TSDocLink,\n TSDocParam,\n TSDocRemarks,\n TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\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 * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n context\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\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: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 <ExitFunctionDeclaration />\n <Spacing />\n <Show when={Boolean(children)}>{children}</Show>\n </BuiltinFile>\n );\n}\n"],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as _alloy_js_core5 from "@alloy-js/core";
|
|
2
2
|
import { BuiltinFileProps } from "@powerlines/plugin-alloy/typescript/components/builtin-file";
|
|
3
3
|
|
|
4
4
|
//#region src/components/utils-builtin.d.ts
|
|
@@ -6,28 +6,28 @@ interface UtilsBuiltinProps extends Omit<BuiltinFileProps, "id" | "description">
|
|
|
6
6
|
/**
|
|
7
7
|
* Generates utilities for detecting terminal color support.
|
|
8
8
|
*/
|
|
9
|
-
declare function EnvSupportUtilities():
|
|
9
|
+
declare function EnvSupportUtilities(): _alloy_js_core5.Children;
|
|
10
10
|
/**
|
|
11
11
|
* Generates utilities for detecting terminal color support.
|
|
12
12
|
*/
|
|
13
|
-
declare function ColorSupportUtilities():
|
|
13
|
+
declare function ColorSupportUtilities(): _alloy_js_core5.Children;
|
|
14
14
|
/**
|
|
15
15
|
* Generates utilities for detecting terminal color support.
|
|
16
16
|
*/
|
|
17
|
-
declare function HyperlinkSupportUtilities():
|
|
17
|
+
declare function HyperlinkSupportUtilities(): _alloy_js_core5.Children;
|
|
18
18
|
/**
|
|
19
19
|
* Generates utilities for detecting terminal color support.
|
|
20
20
|
*/
|
|
21
|
-
declare function ArgsUtilities():
|
|
21
|
+
declare function ArgsUtilities(): _alloy_js_core5.Children;
|
|
22
22
|
/**
|
|
23
23
|
* The `exit` handler function declaration code for the Shell Shock project.
|
|
24
24
|
*/
|
|
25
|
-
declare function ExitFunctionDeclaration():
|
|
26
|
-
declare function ContextUtilities():
|
|
25
|
+
declare function ExitFunctionDeclaration(): _alloy_js_core5.Children;
|
|
26
|
+
declare function ContextUtilities(): _alloy_js_core5.Children;
|
|
27
27
|
/**
|
|
28
28
|
* A built-in utilities module for Shell Shock.
|
|
29
29
|
*/
|
|
30
|
-
declare function UtilsBuiltin(props: UtilsBuiltinProps):
|
|
30
|
+
declare function UtilsBuiltin(props: UtilsBuiltinProps): _alloy_js_core5.Children;
|
|
31
31
|
//#endregion
|
|
32
32
|
export { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, ExitFunctionDeclaration, HyperlinkSupportUtilities, UtilsBuiltin, UtilsBuiltinProps };
|
|
33
33
|
//# sourceMappingURL=utils-builtin.d.cts.map
|
|
@@ -59,7 +59,7 @@ function ColorSupportUtilities() {
|
|
|
59
59
|
}),
|
|
60
60
|
createComponent(Spacing, {}),
|
|
61
61
|
createComponent(TSDoc, {
|
|
62
|
-
heading: "Checks if a specific flag is present in the command
|
|
62
|
+
heading: "Checks if a specific flag is present in the command-line arguments.",
|
|
63
63
|
get children() {
|
|
64
64
|
return [
|
|
65
65
|
createComponent(TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
|
|
@@ -69,7 +69,7 @@ function ColorSupportUtilities() {
|
|
|
69
69
|
}),
|
|
70
70
|
createComponent(TSDocParam, {
|
|
71
71
|
name: "argv",
|
|
72
|
-
children: "The command
|
|
72
|
+
children: "The command-line arguments to check against. Defaults to global Deno args or process args."
|
|
73
73
|
}),
|
|
74
74
|
createComponent(TSDocReturns, { children: "True if the flag is present, false otherwise." })
|
|
75
75
|
];
|
|
@@ -351,7 +351,7 @@ function HyperlinkSupportUtilities() {
|
|
|
351
351
|
function ArgsUtilities() {
|
|
352
352
|
return [
|
|
353
353
|
createComponent(TSDoc, {
|
|
354
|
-
heading: "Retrieves the command
|
|
354
|
+
heading: "Retrieves the command-line arguments from Deno or Node.js environments.",
|
|
355
355
|
get children() {
|
|
356
356
|
return [
|
|
357
357
|
createComponent(TSDocRemarks, { children: "This function is only intended for internal use. Please use `useArgs()` instead." }),
|
|
@@ -360,7 +360,7 @@ function ArgsUtilities() {
|
|
|
360
360
|
createComponent(TSDocInternal, {}),
|
|
361
361
|
createIntrinsic("hbr", {}),
|
|
362
362
|
createIntrinsic("hbr", {}),
|
|
363
|
-
createComponent(TSDocReturns, { children: "An array of command
|
|
363
|
+
createComponent(TSDocReturns, { children: "An array of command-line arguments from Deno or Node.js environments." })
|
|
364
364
|
];
|
|
365
365
|
}
|
|
366
366
|
}),
|
|
@@ -372,7 +372,7 @@ function ArgsUtilities() {
|
|
|
372
372
|
}),
|
|
373
373
|
createComponent(Spacing, {}),
|
|
374
374
|
createComponent(TSDoc, {
|
|
375
|
-
heading: "Checks if a specific flag is present in the command
|
|
375
|
+
heading: "Checks if a specific flag is present in the command-line arguments.",
|
|
376
376
|
get children() {
|
|
377
377
|
return [
|
|
378
378
|
createComponent(TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
|
|
@@ -382,7 +382,7 @@ function ArgsUtilities() {
|
|
|
382
382
|
}),
|
|
383
383
|
createComponent(TSDocParam, {
|
|
384
384
|
name: "argv",
|
|
385
|
-
children: "The command
|
|
385
|
+
children: "The command-line arguments to check against. Defaults to global Deno args or process args."
|
|
386
386
|
}),
|
|
387
387
|
createComponent(TSDocReturns, { children: "True if the flag is present, false otherwise." })
|
|
388
388
|
];
|
|
@@ -520,7 +520,7 @@ function ExitFunctionDeclaration() {
|
|
|
520
520
|
}
|
|
521
521
|
|
|
522
522
|
if (options.exception) {
|
|
523
|
-
error(\`A fatal error occured while running the application - please contact the ${getAppTitle(context)} support team
|
|
523
|
+
error(\`A fatal error occured while running the application - please contact the ${getAppTitle(context)} support team\${options.exception && typeof options.exception !== "symbol" ? \`: \\n\\n\${typeof options.exception === "string" ? options.exception : options.exception.message}\` : "."}\`);
|
|
524
524
|
}
|
|
525
525
|
|
|
526
526
|
const terminate = (force = false) => { `),
|
|
@@ -534,7 +534,7 @@ function ExitFunctionDeclaration() {
|
|
|
534
534
|
memo(() => code`
|
|
535
535
|
verbose(\`The ${getAppTitle(context)} application exited \${options.exception ? \`early due to an exception\` : "successfully"}\${options.startDate ? \`. Total processing time is \${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \${Date.now() - options.startDate.getTime() > 5000 ? "seconds" : "milliseconds"}\` : ""}...\`);
|
|
536
536
|
if (!options.skipProcessExit) {
|
|
537
|
-
process.exit(exitCode);
|
|
537
|
+
process.nextTick(() => process.exit(exitCode));
|
|
538
538
|
}
|
|
539
539
|
};
|
|
540
540
|
|
|
@@ -562,7 +562,7 @@ function ExitFunctionDeclaration() {
|
|
|
562
562
|
error(\`The exit process failed to complete\${(err as Error).message ? \` - (err as Error).message\` : ""}. Please contact the ${getAppTitle(context)} support team.\`);
|
|
563
563
|
|
|
564
564
|
if (!options.skipProcessExit) {
|
|
565
|
-
process.exit(1);
|
|
565
|
+
process.nextTick(() => process.exit(1));
|
|
566
566
|
}
|
|
567
567
|
}
|
|
568
568
|
`)
|
|
@@ -593,7 +593,7 @@ function ContextUtilities() {
|
|
|
593
593
|
/**
|
|
594
594
|
* A utility hook function to get the command line arguments from the application context.
|
|
595
595
|
*
|
|
596
|
-
* @returns An array of command
|
|
596
|
+
* @returns An array of command-line arguments from the application context.
|
|
597
597
|
* @throws If the application context is not available.
|
|
598
598
|
*/
|
|
599
599
|
export function useArgs(): string[] {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utils-builtin.mjs","names":["code","Show","splitProps","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","getAppTitle","defu","IsVerbose","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","ExitFunctionDeclaration","context","optional","async","_$memo","condition","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 IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n TSDoc,\n TSDocInternal,\n TSDocLink,\n TSDocParam,\n TSDocRemarks,\n TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\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 * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.exit(exitCode);\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n context\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.exit(1);\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: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 <ExitFunctionDeclaration />\n <Spacing />\n <Show when={Boolean(children)}>{children}</Show>\n </BuiltinFile>\n );\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"utils-builtin.mjs","names":["code","Show","splitProps","FunctionDeclaration","IfStatement","InterfaceDeclaration","InterfaceMember","VarDeclaration","Spacing","usePowerlines","BuiltinFile","TSDoc","TSDocInternal","TSDocLink","TSDocParam","TSDocRemarks","TSDocReturns","getAppTitle","defu","IsVerbose","EnvSupportUtilities","_$createComponent","name","doc","initializer","ColorSupportUtilities","children","type","heading","parameters","default","HyperlinkSupportUtilities","returnType","ArgsUtilities","_$createIntrinsic","ExitFunctionDeclaration","context","optional","async","_$memo","condition","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 IfStatement,\n InterfaceDeclaration,\n InterfaceMember,\n VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { BuiltinFileProps } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport { BuiltinFile } from \"@powerlines/plugin-alloy/typescript/components/builtin-file\";\nimport {\n TSDoc,\n TSDocInternal,\n TSDocLink,\n TSDocParam,\n TSDocRemarks,\n TSDocReturns\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport defu from \"defu\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\nimport { IsVerbose } from \"./helpers\";\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 * The `exit` handler function declaration code for the Shell Shock project.\n */\nexport function ExitFunctionDeclaration() {\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <InterfaceDeclaration\n export\n name=\"ExitOptions\"\n doc=\"Options for the exit handler function.\">\n <InterfaceMember\n name=\"exception\"\n optional\n type=\"string | Error\"\n doc=\"An optional exception that caused the exit. This can be a string message or an Error object.\"\n />\n <hbr />\n <InterfaceMember\n name=\"skipProcessExit\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should manually exit the process or not. If set to true, the exit function will not call process.exit() and will allow the application to continue running. If set to false or not specified, the exit function will call process.exit() to terminate the application.\"\n />\n <hbr />\n <InterfaceMember\n name=\"isSynchronous\"\n optional\n type=\"boolean\"\n doc=\"Indicates whether the exit function should perform synchronous operations only. If set to true, the exit function will avoid any asynchronous operations during exit. If set to false or not specified, the exit function may perform asynchronous operations as needed.\"\n />\n <hbr />\n <InterfaceMember\n name=\"signal\"\n optional\n type=\"number\"\n doc=\"The signal number that triggered the exit. This is typically used when the shutdown is initiated by a system signal (e.g., SIGINT, SIGTERM).\"\n />\n <hbr />\n <InterfaceMember\n name=\"startDate\"\n optional\n type=\"Date\"\n doc=\"A Date object representing the timestamp when the process started. This can be used to measure the duration of the shutdown process.\"\n />\n </InterfaceDeclaration>\n <Spacing />\n <VarDeclaration\n let\n name=\"isExiting\"\n type=\"boolean\"\n initializer={code`false;`}\n />\n <VarDeclaration\n const\n name=\"callbackAsyncQueue\"\n type=\"Array<[(code: number | string) => Promise<void> | void, number]>\"\n initializer={code`[];`}\n />\n <VarDeclaration\n const\n name=\"callbackSyncQueue\"\n type=\"Array<(code: number | string) => void>\"\n initializer={code`[];`}\n />\n <Spacing />\n <FunctionDeclaration\n export\n async\n name=\"exit\"\n parameters={[\n {\n name: \"options\",\n type: \"ExitOptions\",\n default: \"{}\"\n }\n ]}>\n {code`\n try {\n if (isExiting) {\n return;\n }\n\n isExiting = true;\n\n let exitCode: number | string = 0;\n if ((options.signal !== undefined && options.signal > 0) || options.exception) {\n exitCode = 128 + (options.signal ?? 1);\n } else if (typeof process.exitCode === \"number\" || typeof process.exitCode === \"string\") {\n exitCode = process.exitCode;\n }\n\n if (options.exception) {\n error(\\`A fatal error occured while running the application - please contact the ${getAppTitle(\n context\n )} support team\\${options.exception && typeof options.exception !== \"symbol\" ? \\`: \\\\n\\\\n\\${typeof options.exception === \"string\" ? options.exception : options.exception.message}\\` : \".\"}\\`);\n }\n\n const terminate = (force = false) => { `}\n <IfStatement\n condition={<IsVerbose />}>{code`writeLine(\"\");`}</IfStatement>\n <hbr />\n {code`\n verbose(\\`The ${getAppTitle(\n context\n )} application exited \\${options.exception ? \\`early due to an exception\\` : \"successfully\"}\\${options.startDate ? \\`. Total processing time is \\${Date.now() - options.startDate.getTime() > 5000 ? Math.floor((Date.now() - options.startDate.getTime()) / 1000) : Date.now() - options.startDate.getTime()} \\${Date.now() - options.startDate.getTime() > 5000 ? \"seconds\" : \"milliseconds\"}\\` : \"\"}...\\`);\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(exitCode));\n }\n };\n\n for (const callbackSync of callbackSyncQueue) {\n callbackSync(exitCode);\n }\n\n if (!options.isSynchronous) {\n const promises = [];\n let forceAfter = 0;\n for (const [callbackAsync, wait] of callbackAsyncQueue) {\n forceAfter = Math.max(forceAfter, wait);\n promises.push(Promise.resolve(callbackAsync(exitCode)));\n }\n\n const asyncTimer = setTimeout(() => {\n terminate(true);\n }, forceAfter);\n await Promise.all(promises);\n clearTimeout(asyncTimer);\n }\n\n terminate();\n } catch (err) {\n error(\\`The exit process failed to complete\\${(err as Error).message ? \\` - (err as Error).message\\` : \"\"}. Please contact the ${getAppTitle(\n context\n )} support team.\\`);\n\n if (!options.skipProcessExit) {\n process.nextTick(() => process.exit(1));\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: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 <ExitFunctionDeclaration />\n <Spacing />\n <Show when={Boolean(children)}>{children}</Show>\n </BuiltinFile>\n );\n}\n"],"mappings":"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"}
|
|
@@ -461,6 +461,10 @@ function buildThemeAnsiStyles(theme, wrapFn, convertFn) {
|
|
|
461
461
|
disabled: {
|
|
462
462
|
open: wrapFn()(convertFn(theme.text.prompt.input.disabled)),
|
|
463
463
|
close: wrapAnsi16()(39)
|
|
464
|
+
},
|
|
465
|
+
placeholder: {
|
|
466
|
+
open: wrapFn()(convertFn(theme.text.prompt.input.placeholder)),
|
|
467
|
+
close: wrapAnsi16()(39)
|
|
464
468
|
}
|
|
465
469
|
},
|
|
466
470
|
description: {
|