@shell-shock/core 0.9.1 → 0.9.3

package/dist/components/docs.d.cts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core12 from "@alloy-js/core";
+import * as _alloy_js_core20 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +12,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core12.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core20.Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +31,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core12.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core20.Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +56,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _alloy_js_core12.Children;
+declare function CommandDocs(props: CommandDocsProps): _alloy_js_core20.Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +75,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core12.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core20.Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.cts.map

package/dist/components/helpers.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core7 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +7,29 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core7.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core0.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * 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.
  */
-declare function IsDebug(): _alloy_js_core7.Children;
+declare function IsDebug(): _alloy_js_core0.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core7.Children;
+declare function IsNotDebug(): _alloy_js_core0.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * 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.
  */
-declare function IsVerbose(): _alloy_js_core7.Children;
+declare function IsVerbose(): _alloy_js_core0.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core7.Children;
+declare function IsNotVerbose(): _alloy_js_core0.Children;
 //#endregion
 export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.cts.map

package/dist/components/helpers.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core7 from "@alloy-js/core";
+import * as _alloy_js_core15 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +7,29 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core7.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core15.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * 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.
  */
-declare function IsDebug(): _alloy_js_core7.Children;
+declare function IsDebug(): _alloy_js_core15.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core7.Children;
+declare function IsNotDebug(): _alloy_js_core15.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * 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.
  */
-declare function IsVerbose(): _alloy_js_core7.Children;
+declare function IsVerbose(): _alloy_js_core15.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core7.Children;
+declare function IsNotVerbose(): _alloy_js_core15.Children;
 //#endregion
 export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.mts.map

package/dist/components/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,eAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,eAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,eAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,eAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,eAAA,CAAA"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,gBAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,gBAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA"}

package/dist/components/options-parser-logic.d.cts

@@ -1,5 +1,5 @@
 import { CommandOption, CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core12 from "@alloy-js/core";
 
 //#region src/components/options-parser-logic.d.ts
 interface DynamicSegmentsParserLogicProps {
@@ -12,7 +12,7 @@ interface DynamicSegmentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core0.Children;
+declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core12.Children;
 interface ArgumentsParserLogicProps {
   /**
    * The command to generate the positional parameters parser logic for.
@@ -27,7 +27,7 @@ interface ArgumentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core0.Children;
+declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core12.Children;
 /**
  * The command option interface property.
  */
@@ -35,7 +35,7 @@ declare function OptionsMember({
   option
 }: {
   option: CommandOption;
-}): _alloy_js_core0.Children;
+}): _alloy_js_core12.Children;
 interface OptionsMemberParserLogicProps {
   /**
    * The option name to generate the parser logic for.
@@ -55,7 +55,7 @@ interface OptionsMemberParserLogicProps {
 /**
  * The command option property parser logic.
  */
-declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core0.Children;
+declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core12.Children;
 interface OptionsMemberParserConditionProps {
   /**
    * The option name to generate the parser logic for.
@@ -72,10 +72,10 @@ interface OptionsMemberParserConditionProps {
    */
   isCaseSensitive: boolean;
 }
-declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core0.Children;
+declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core12.Children;
 declare function OptionsInterfaceDeclaration(props: {
   command: CommandTree;
-}): _alloy_js_core0.Children;
+}): _alloy_js_core12.Children;
 interface OptionsParserLogicProps {
   /**
    * The command to generate the options parser logic for.
@@ -95,7 +95,7 @@ interface OptionsParserLogicProps {
 /**
  * The command options parser logic.
  */
-declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core0.Children;
+declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core12.Children;
 interface CommandParserLogicProps {
   /**
    * The command to generate the parser logic for.
@@ -115,7 +115,7 @@ interface CommandParserLogicProps {
 /**
  * The command parser logic, which includes parsing dynamic path segments, positional parameters, and options.
  */
-declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core0.Children;
+declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core12.Children;
 //#endregion
 export { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps };
 //# sourceMappingURL=options-parser-logic.d.cts.map

package/dist/components/options-parser-logic.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"options-parser-logic.d.cts","names":[],"sources":["../../src/components/options-parser-logic.tsx"],"sourcesContent":[],"mappings":";;;;UA+CiB,+BAAA;;;AAAjB;EAYgB,OAAA,EARL,WAQK;EA6BC;AAiBjB;AAyKA;EAAgC,eAAA,EAAA,OAAA;;AAAiC,iBAvNjD,0BAAA,CAuNmD,KAAA,EAtN1D,+BAsN0D,CAAA,EAtN3B,eAAA,CAAA,QAsN2B;AAAA,UA1LlD,yBAAA,CA0LkD;EAuClD;AAsBjB;AAuKA;EAmBgB,OAAA,EA7aL,WA6aK;EAmEA;AAchB;AAsBA;EA4HiB,SAAA,EAAA,MAAA;EAsBD;;;;;iBAzpBA,oBAAA,QAA4B,4BAAyB,eAAA,CAAA;;;;iBAyKrD,aAAA;;;UAAoC;IAAa,eAAA,CAAE;UAuClD,6BAAA;;;;;;;;UASP;;;;;;;;;;;iBAaM,wBAAA,QAAgC,gCAA6B,eAAA,CAAA;UAuK5D,iCAAA;;;;;;;;;;;;;;;;iBAmBD,4BAAA,QACP,oCAAiC,eAAA,CAAA;iBAkE1B,2BAAA;WAA8C;IAAW,eAAA,CAAE;UAc1D,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,eAAA,CAAA;UA4HhD,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,eAAA,CAAA"}
+{"version":3,"file":"options-parser-logic.d.cts","names":[],"sources":["../../src/components/options-parser-logic.tsx"],"sourcesContent":[],"mappings":";;;;UA+CiB,+BAAA;;;AAAjB;EAYgB,OAAA,EARL,WAQK;EA6BC;AAiBjB;AAyKA;EAAgC,eAAA,EAAA,OAAA;;AAAiC,iBAvNjD,0BAAA,CAuNmD,KAAA,EAtN1D,+BAsN0D,CAAA,EAtN3B,gBAAA,CAAA,QAsN2B;AAAA,UA1LlD,yBAAA,CA0LkD;EAuClD;AAsBjB;AAuKA;EAmBgB,OAAA,EA7aL,WA6aK;EAmEA;AAchB;AAsBA;EA4HiB,SAAA,EAAA,MAAA;EAsBD;;;;;iBAzpBA,oBAAA,QAA4B,4BAAyB,gBAAA,CAAA;;;;iBAyKrD,aAAA;;;UAAoC;IAAa,gBAAA,CAAE;UAuClD,6BAAA;;;;;;;;UASP;;;;;;;;;;;iBAaM,wBAAA,QAAgC,gCAA6B,gBAAA,CAAA;UAuK5D,iCAAA;;;;;;;;;;;;;;;;iBAmBD,4BAAA,QACP,oCAAiC,gBAAA,CAAA;iBAkE1B,2BAAA;WAA8C;IAAW,gBAAA,CAAE;UAc1D,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,gBAAA,CAAA;UA4HhD,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,gBAAA,CAAA"}

package/dist/components/options-parser-logic.d.mts

@@ -1,5 +1,5 @@
 import { CommandOption, CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core12 from "@alloy-js/core";
+import * as _alloy_js_core7 from "@alloy-js/core";
 
 //#region src/components/options-parser-logic.d.ts
 interface DynamicSegmentsParserLogicProps {
@@ -12,7 +12,7 @@ interface DynamicSegmentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core12.Children;
+declare function DynamicSegmentsParserLogic(props: DynamicSegmentsParserLogicProps): _alloy_js_core7.Children;
 interface ArgumentsParserLogicProps {
   /**
    * The command to generate the positional parameters parser logic for.
@@ -27,7 +27,7 @@ interface ArgumentsParserLogicProps {
    */
   isCaseSensitive: boolean;
 }
-declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core12.Children;
+declare function ArgumentsParserLogic(props: ArgumentsParserLogicProps): _alloy_js_core7.Children;
 /**
  * The command option interface property.
  */
@@ -35,7 +35,7 @@ declare function OptionsMember({
   option
 }: {
   option: CommandOption;
-}): _alloy_js_core12.Children;
+}): _alloy_js_core7.Children;
 interface OptionsMemberParserLogicProps {
   /**
    * The option name to generate the parser logic for.
@@ -55,7 +55,7 @@ interface OptionsMemberParserLogicProps {
 /**
  * The command option property parser logic.
  */
-declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core12.Children;
+declare function OptionsMemberParserLogic(props: OptionsMemberParserLogicProps): _alloy_js_core7.Children;
 interface OptionsMemberParserConditionProps {
   /**
    * The option name to generate the parser logic for.
@@ -72,10 +72,10 @@ interface OptionsMemberParserConditionProps {
    */
   isCaseSensitive: boolean;
 }
-declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core12.Children;
+declare function OptionsMemberParserCondition(props: OptionsMemberParserConditionProps): _alloy_js_core7.Children;
 declare function OptionsInterfaceDeclaration(props: {
   command: CommandTree;
-}): _alloy_js_core12.Children;
+}): _alloy_js_core7.Children;
 interface OptionsParserLogicProps {
   /**
    * The command to generate the options parser logic for.
@@ -95,7 +95,7 @@ interface OptionsParserLogicProps {
 /**
  * The command options parser logic.
  */
-declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core12.Children;
+declare function OptionsParserLogic(props: OptionsParserLogicProps): _alloy_js_core7.Children;
 interface CommandParserLogicProps {
   /**
    * The command to generate the parser logic for.
@@ -115,7 +115,7 @@ interface CommandParserLogicProps {
 /**
  * The command parser logic, which includes parsing dynamic path segments, positional parameters, and options.
  */
-declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core12.Children;
+declare function CommandParserLogic(props: CommandParserLogicProps): _alloy_js_core7.Children;
 //#endregion
 export { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps };
 //# sourceMappingURL=options-parser-logic.d.mts.map

package/dist/components/options-parser-logic.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"options-parser-logic.d.mts","names":[],"sources":["../../src/components/options-parser-logic.tsx"],"sourcesContent":[],"mappings":";;;;UA+CiB,+BAAA;;;AAAjB;EAYgB,OAAA,EARL,WAQK;EA6BC;AAiBjB;AAyKA;EAAgC,eAAA,EAAA,OAAA;;AAAiC,iBAvNjD,0BAAA,CAuNmD,KAAA,EAtN1D,+BAsN0D,CAAA,EAtN3B,gBAAA,CAAA,QAsN2B;AAAA,UA1LlD,yBAAA,CA0LkD;EAuClD;AAsBjB;AAuKA;EAmBgB,OAAA,EA7aL,WA6aK;EAmEA;AAchB;AAsBA;EA4HiB,SAAA,EAAA,MAAA;EAsBD;;;;;iBAzpBA,oBAAA,QAA4B,4BAAyB,gBAAA,CAAA;;;;iBAyKrD,aAAA;;;UAAoC;IAAa,gBAAA,CAAE;UAuClD,6BAAA;;;;;;;;UASP;;;;;;;;;;;iBAaM,wBAAA,QAAgC,gCAA6B,gBAAA,CAAA;UAuK5D,iCAAA;;;;;;;;;;;;;;;;iBAmBD,4BAAA,QACP,oCAAiC,gBAAA,CAAA;iBAkE1B,2BAAA;WAA8C;IAAW,gBAAA,CAAE;UAc1D,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,gBAAA,CAAA;UA4HhD,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,gBAAA,CAAA"}
+{"version":3,"file":"options-parser-logic.d.mts","names":[],"sources":["../../src/components/options-parser-logic.tsx"],"sourcesContent":[],"mappings":";;;;UA+CiB,+BAAA;;;AAAjB;EAYgB,OAAA,EARL,WAQK;EA6BC;AAiBjB;AAyKA;EAAgC,eAAA,EAAA,OAAA;;AAAiC,iBAvNjD,0BAAA,CAuNmD,KAAA,EAtN1D,+BAsN0D,CAAA,EAtN3B,eAAA,CAAA,QAsN2B;AAAA,UA1LlD,yBAAA,CA0LkD;EAuClD;AAsBjB;AAuKA;EAmBgB,OAAA,EA7aL,WA6aK;EAmEA;AAchB;AAsBA;EA4HiB,SAAA,EAAA,MAAA;EAsBD;;;;;iBAzpBA,oBAAA,QAA4B,4BAAyB,eAAA,CAAA;;;;iBAyKrD,aAAA;;;UAAoC;IAAa,eAAA,CAAE;UAuClD,6BAAA;;;;;;;;UASP;;;;;;;;;;;iBAaM,wBAAA,QAAgC,gCAA6B,eAAA,CAAA;UAuK5D,iCAAA;;;;;;;;;;;;;;;;iBAmBD,4BAAA,QACP,oCAAiC,eAAA,CAAA;iBAkE1B,2BAAA;WAA8C;IAAW,eAAA,CAAE;UAc1D,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,eAAA,CAAA;UA4HhD,uBAAA;;;;WAIN;;;;;;;;;;;;;;;iBAkBK,kBAAA,QAA0B,0BAAuB,eAAA,CAAA"}

package/dist/components/usage.d.cts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core23 from "@alloy-js/core";
+import * as _alloy_js_core11 from "@alloy-js/core";
 
 //#region src/components/usage.d.ts
 interface UsageProps {
@@ -22,7 +22,7 @@ interface UsageProps {
 /**
  * A component that generates the usage display for a command.
  */
-declare function Usage(props: UsageProps): _alloy_js_core23.Children;
+declare function Usage(props: UsageProps): _alloy_js_core11.Children;
 //#endregion
 export { Usage, UsageProps };
 //# sourceMappingURL=usage.d.cts.map

package/dist/components/utils-builtin.cjs

@@ -635,7 +635,7 @@ function SpawnFunctionDeclaration() {
 
             try {
               const fd = openSync(normalized.file, "r");
-              await read(fd, buffer, 0, 150, 0);
+              await promisify(read)(fd, buffer, 0, 150, 0);
               closeSync(fd);
             } catch (err) {
               // Do nothing
@@ -850,8 +850,13 @@ function UtilsBuiltin(props) {
 					"posix",
 					"sep"
 				],
-				"node:fs": ["openSync", "closeSync"],
-				"node:fs/promises": ["stat", "read"],
+				"node:fs": [
+					"openSync",
+					"closeSync",
+					"read"
+				],
+				"node:fs/promises": ["stat"],
+				"node:util": ["promisify"],
 				"node:child_process": [{
 					name: "spawn",
 					alias: "_spawn"

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

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

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

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

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

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

package/dist/components/utils-builtin.mjs

@@ -633,7 +633,7 @@ function SpawnFunctionDeclaration() {
 
             try {
               const fd = openSync(normalized.file, "r");
-              await read(fd, buffer, 0, 150, 0);
+              await promisify(read)(fd, buffer, 0, 150, 0);
               closeSync(fd);
             } catch (err) {
               // Do nothing
@@ -848,8 +848,13 @@ function UtilsBuiltin(props) {
 					"posix",
 					"sep"
 				],
-				"node:fs": ["openSync", "closeSync"],
-				"node:fs/promises": ["stat", "read"],
+				"node:fs": [
+					"openSync",
+					"closeSync",
+					"read"
+				],
+				"node:fs/promises": ["stat"],
+				"node:util": ["promisify"],
 				"node:child_process": [{
 					name: "spawn",
 					alias: "_spawn"

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

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

package/dist/types/config.cjs

@@ -73,8 +73,9 @@ const __ΩBaseOptions = [
 ];
 const __ΩOptions = [
 	() => __ΩBaseOptions,
+	() => __ΩPartial,
 	"Options",
-	"Pn!!Kw\"y"
+	"Pn!!o\"\"Kw#y"
 ];
 const __ΩOutputConfig = [
 	() => __ΩPick,
@@ -88,10 +89,11 @@ const __ΩOutputConfig = [
 ];
 const __ΩUserConfig = [
 	() => __ΩBaseOptions,
+	() => __ΩPartial,
 	() => __ΩOutputConfig,
 	"output",
 	"UserConfig",
-	"Pn!!Pn\"4#8MKw$y"
+	"Pn!!o\"\"Pn#4$8MKw%y"
 ];
 const __ΩResolvedConfig = [
 	() => __ΩRequired,

package/dist/types/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/types/config.ts"],"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 type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines/types/config\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"entry\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * An application specific prefix to check for environment variables.\n   *\n   * @remarks\n   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `\"my-app\"`, environment variables starting with `\"MY_APP_\"` will be used - for example: `\"MY_APP_CONFIG_NAME\"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `\"MY_APP__CONFIG_NAME\"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  envPrefix?: string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & NodeJsPluginOptions;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  NodeJsPluginUserConfig & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAC;CAAK;CAAY;CAAS;;;;;;;;;AAE/C,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;AAChE,MAAM,aAAa;CAAC;CAAK;CAAK;CAAW;CAA2B;AACpE,MAAM,kBAAkB;OAAO;CAAS;CAAQ;CAAQ;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACvE,MAAM,iBAAiB;OAAO;OAAkB;CAAiB;CAAa;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;AAG9E,MAAM,kBAAkB;OAAO;CAAS;CAAc;CAAU;CAAO;CAAA;CAAA;CAAA;CAAA;AAEvE,MAAM,gBAAgB;OAAO;OAAsB;CAAQ;CAAA;CAAA;CAAA;AAE3D,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../../src/types/config.ts"],"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 type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines/types/config\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"entry\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * An application specific prefix to check for environment variables.\n   *\n   * @remarks\n   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `\"my-app\"`, environment variables starting with `\"MY_APP_\"` will be used - for example: `\"MY_APP_CONFIG_NAME\"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `\"MY_APP__CONFIG_NAME\"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  envPrefix?: string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAC;CAAK;CAAY;CAAS;;;;;;;;;AAE/C,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;AAChE,MAAM,aAAa;CAAC;CAAK;CAAK;CAAW;CAA2B;AACpE,MAAM,kBAAkB;OAAO;CAAS;CAAQ;CAAQ;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACvE,MAAM,iBAAiB;OAAO;OAAkB;CAAiB;CAAa;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAG9E,MAAM,kBAAkB;OAAO;CAAS;CAAc;CAAU;CAAO;CAAA;CAAA;CAAA;CAAA;AAEvE,MAAM,gBAAgB;OAAO;OAAsB;OAAQ;CAAA;CAAA;CAAA;CAAA;AAE3D,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/config.d.cts

@@ -46,7 +46,7 @@ type BaseOptions = Partial<BuildOptions> & {
 /**
  * The plugin options for Shell Shock.
  */
-type Options = BaseOptions & NodeJsPluginOptions;
+type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
@@ -59,7 +59,7 @@ type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> &
 /**
  * The user configuration options for Shell Shock.
  */
-type UserConfig = BaseOptions & NodeJsPluginUserConfig & {
+type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & {
   /**
    * Configuration for the output of the build process
    */

package/dist/types/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,KAClB;KAeG,WAAA,GAAc,QAAQ;EAhBtB;AAAmB;;;;;EAyBS,cAAA,CAAA,EAD3B,aAC2B,EAAA,GAAA,CAAA,CAAA,OAAA,EAAhB,OAAgB,EAAA,KAAA,EAAA,WAAA,EAAA,GAAgB,aAAhB,EAAA,CAAA,GAAA,KAAA;EAAgB;;AAqCjD;AAKA;AAaA;EAAyB,eAAA,CAAA,EAAA,OAAA;EACvB;;;AAUF;;;;;;;EAcS,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAKO;;;;;;;;;;;;;;KAhDJ,OAAA,GAAU,cAAc;;;;KAKxB,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa,cACvB;;;;WAIW;;;;;KAMD,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,KAClB;KAeG,WAAA,GAAc,QAAQ;EAhBtB;AAAmB;;;;;EAyBS,cAAA,CAAA,EAD3B,aAC2B,EAAA,GAAA,CAAA,CAAA,OAAA,EAAhB,OAAgB,EAAA,KAAA,EAAA,WAAA,EAAA,GAAgB,aAAhB,EAAA,CAAA,GAAA,KAAA;EAAgB;;AAqCjD;;;EAAoC,eAAA,CAAA,EAAA,OAAA;EAAO;AAK3C;AAaA;;;;;;AAWA;;EACE,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EACA;;;;;;;;;;;;;;KA/BU,OAAA,GAAU,cAAc,QAAQ;;;;KAKhC,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa,cACvB,QAAQ;;;;WAIG;;;;;KAMD,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO"}

package/dist/types/config.d.mts

@@ -46,7 +46,7 @@ type BaseOptions = Partial<BuildOptions> & {
 /**
  * The plugin options for Shell Shock.
  */
-type Options = BaseOptions & NodeJsPluginOptions;
+type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
@@ -59,7 +59,7 @@ type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> &
 /**
  * The user configuration options for Shell Shock.
  */
-type UserConfig = BaseOptions & NodeJsPluginUserConfig & {
+type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & {
   /**
    * Configuration for the output of the build process
    */

package/dist/types/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,KAClB;KAeG,WAAA,GAAc,QAAQ;EAhBtB;AAAmB;;;;;EAyBS,cAAA,CAAA,EAD3B,aAC2B,EAAA,GAAA,CAAA,CAAA,OAAA,EAAhB,OAAgB,EAAA,KAAA,EAAA,WAAA,EAAA,GAAgB,aAAhB,EAAA,CAAA,GAAA,KAAA;EAAgB;;AAqCjD;AAKA;AAaA;EAAyB,eAAA,CAAA,EAAA,OAAA;EACvB;;;AAUF;;;;;;;EAcS,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EAKO;;;;;;;;;;;;;;KAhDJ,OAAA,GAAU,cAAc;;;;KAKxB,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa,cACvB;;;;WAIW;;;;;KAMD,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,KAClB;KAeG,WAAA,GAAc,QAAQ;EAhBtB;AAAmB;;;;;EAyBS,cAAA,CAAA,EAD3B,aAC2B,EAAA,GAAA,CAAA,CAAA,OAAA,EAAhB,OAAgB,EAAA,KAAA,EAAA,WAAA,EAAA,GAAgB,aAAhB,EAAA,CAAA,GAAA,KAAA;EAAgB;;AAqCjD;;;EAAoC,eAAA,CAAA,EAAA,OAAA;EAAO;AAK3C;AAaA;;;;;;AAWA;;EACE,GAAA,CAAA,EAAA,MAAA,GAAA,MAAA,EAAA;EACA;;;;;;;;;;;;;;KA/BU,OAAA,GAAU,cAAc,QAAQ;;;;KAKhC,YAAA,GAAe,KACzB;;;;;;;;;KAYU,UAAA,GAAa,cACvB,QAAQ;;;;WAIG;;;;;KAMD,cAAA,GAAiB,6BAC3B,6BACA,6BACA,SAAS,KAAK;;;;;;;;;;;OAWP;;;;cAKO"}

package/dist/types/config.mjs

@@ -72,8 +72,9 @@ const __ΩBaseOptions = [
 ];
 const __ΩOptions = [
 	() => __ΩBaseOptions,
+	() => __ΩPartial,
 	"Options",
-	"Pn!!Kw\"y"
+	"Pn!!o\"\"Kw#y"
 ];
 const __ΩOutputConfig = [
 	() => __ΩPick,
@@ -87,10 +88,11 @@ const __ΩOutputConfig = [
 ];
 const __ΩUserConfig = [
 	() => __ΩBaseOptions,
+	() => __ΩPartial,
 	() => __ΩOutputConfig,
 	"output",
 	"UserConfig",
-	"Pn!!Pn\"4#8MKw$y"
+	"Pn!!o\"\"Pn#4$8MKw%y"
 ];
 const __ΩResolvedConfig = [
 	() => __ΩRequired,

package/dist/types/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/types/config.ts"],"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 type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines/types/config\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"entry\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * An application specific prefix to check for environment variables.\n   *\n   * @remarks\n   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `\"my-app\"`, environment variables starting with `\"MY_APP_\"` will be used - for example: `\"MY_APP_CONFIG_NAME\"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `\"MY_APP__CONFIG_NAME\"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  envPrefix?: string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & NodeJsPluginOptions;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  NodeJsPluginUserConfig & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAC;CAAK;CAAY;CAAS;;;;;;;;;AAE/C,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;AAChE,MAAM,aAAa;CAAC;CAAK;CAAK;CAAW;CAA2B;AACpE,MAAM,kBAAkB;OAAO;CAAS;CAAQ;CAAQ;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACvE,MAAM,iBAAiB;OAAO;OAAkB;CAAiB;CAAa;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;AAG9E,MAAM,kBAAkB;OAAO;CAAS;CAAc;CAAU;CAAO;CAAA;CAAA;CAAA;CAAA;AAEvE,MAAM,gBAAgB;OAAO;OAAsB;CAAQ;CAAA;CAAA;CAAA;AAE3D,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/types/config.ts"],"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 type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines/types/config\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"entry\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * An application specific prefix to check for environment variables.\n   *\n   * @remarks\n   * If not provided, Shell Shock will convert {@link Options.name | name} to {@link https://stringcase.org/cases/constant/ | constant case} format and append an underscore (`_`). If the provided {@link Options.name | name} is `\"my-app\"`, environment variables starting with `\"MY_APP_\"` will be used - for example: `\"MY_APP_CONFIG_NAME\"`. If a trailing underscore already exists in the user provided value, it will result in two consecutive underscores - for example: `\"MY_APP__CONFIG_NAME\"` (this was done intentionally so that users who specifically want multiple underscores have a way to do so).\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  envPrefix?: string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAC;CAAK;CAAY;CAAS;;;;;;;;;AAE/C,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;AAChE,MAAM,aAAa;CAAC;CAAK;CAAK;CAAW;CAA2B;AACpE,MAAM,kBAAkB;OAAO;CAAS;CAAQ;CAAQ;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACvE,MAAM,iBAAiB;OAAO;OAAkB;CAAiB;CAAa;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAG9E,MAAM,kBAAkB;OAAO;CAAS;CAAc;CAAU;CAAO;CAAA;CAAA;CAAA;CAAA;AAEvE,MAAM,gBAAgB;OAAO;OAAsB;OAAQ;CAAA;CAAA;CAAA;CAAA;AAE3D,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "type": "module",
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "repository": {
@@ -392,13 +392,13 @@
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/markdown": "0.23.0-dev.1",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.67",
-    "@powerlines/plugin-alloy": "^0.23.17",
-    "@powerlines/plugin-automd": "^0.1.287",
-    "@powerlines/plugin-deepkit": "^0.11.166",
-    "@powerlines/plugin-nodejs": "^0.1.205",
-    "@powerlines/plugin-plugin": "^0.12.238",
-    "@powerlines/plugin-tsdown": "^0.1.240",
+    "@powerlines/deepkit": "^0.6.69",
+    "@powerlines/plugin-alloy": "^0.23.19",
+    "@powerlines/plugin-automd": "^0.1.289",
+    "@powerlines/plugin-deepkit": "^0.11.168",
+    "@powerlines/plugin-nodejs": "^0.1.207",
+    "@powerlines/plugin-plugin": "^0.12.240",
+    "@powerlines/plugin-tsdown": "^0.1.242",
     "@stryke/cli": "^0.13.15",
     "@stryke/convert": "^0.6.40",
     "@stryke/fs": "^0.33.43",
@@ -410,10 +410,10 @@
     "@stryke/types": "^0.10.39",
     "automd": "^0.4.3",
     "defu": "6.1.4",
-    "powerlines": "^0.38.54",
+    "powerlines": "^0.38.56",
     "rolldown": "1.0.0-beta.52"
   },
   "devDependencies": { "@types/node": "^25.3.0", "typescript": "^5.9.3" },
   "publishConfig": { "access": "public" },
-  "gitHead": "b94dfbfbfd27471351cac0596afe1f550d8dca57"
+  "gitHead": "4cf65f37aca1c43ffac57a86bf21e184134437f1"
 }