@shell-shock/core 0.17.8 → 0.17.11

package/dist/components/state-builtin.cjs

@@ -1,21 +1,581 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../_virtual/_rolldown/runtime.cjs`),t=require(`../plugin-utils/context-helpers.cjs`),n=require(`../contexts/options.cjs`);require(`../plugin-utils/index.cjs`);const r=require(`./options-parser-logic.cjs`);let i=require(`@alloy-js/core/jsx-runtime`),a=require(`defu`);a=e.__toESM(a);let o=require(`@alloy-js/core`),s=require(`@powerlines/plugin-alloy/core/components/spacing`),c=require(`@powerlines/plugin-alloy/core/contexts/context`),l=require(`@alloy-js/typescript`),u=require(`@powerlines/plugin-alloy/typescript/components/builtin-file`),d=require(`@powerlines/plugin-alloy/typescript/components/tsdoc`);const f=[`T`,`K`,()=>p,()=>m,`Omit`,`b!b"e!!e!!ge!"o$#o##w%y`],p=[`T`,`K`,`Pick`,`l+e#!e"!fRb!b"Pde""N#!w#y`],m=[`T`,`U`,`Exclude`,`l6!Re$!RPe#!e$"qk#%QRb!b"Pde"!p)w#y`];function h(e,t){return e.__type=t,e}function g(){let e=(c.usePowerlines.Ω=[[`Context`,`"w!`]],(0,c.usePowerlines)()),a=(0,o.computed)(()=>n.computedOptions(e.globalOptions));return[(0,i.createComponent)(d.TSDoc,{get heading(){return`An object representing the global options available for every command in the ${t.getAppTitle(e,!0)} command-line application.`}}),(0,i.createComponent)(l.InterfaceDeclaration,{export:!0,name:`GlobalOptions`,get children(){return(0,i.createComponent)(o.For,{get each(){return Object.values(a.value)},hardline:!0,get children(){return h(e=>(0,i.createComponent)(r.OptionsMember,{option:e}),[`option`,``,`P"2!"/"`])}})}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`The context object for the current command execution, containing the command path and segments.`}),(0,i.createComponent)(l.InterfaceDeclaration,{export:!0,name:`CommandContext`,typeParameters:[{name:`THandler`,extends:`(...params: any[]) => any`,default:`any`}],get children(){return[(0,i.createComponent)(d.TSDoc,{get heading(){return`The full command path as a string. For example, if the user runs \`${t.getAppBin(e)} foo bar\`, this would be \`foo bar\`. This is useful for commands that need to know their full invocation path, such as for help text or for commands that have dynamic behavior based on their position in the command hierarchy.`}}),(0,i.createComponent)(l.InterfaceMember,{name:`path`,type:`string`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`An array of command path segments. For example, if the user runs \`${t.getAppBin(e)} foo bar\`, this would be \`["foo", "bar"]\`. This is useful for commands that need to know their individual path segments, such as for dynamic routing or for commands that have behavior based on specific segments in the command hierarchy.`}}),(0,i.createComponent)(l.InterfaceMember,{name:`segments`,type:`string[]`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`The parameters for the current command's handler function.`}),(0,i.createComponent)(l.InterfaceMember,{name:`params`,type:`Parameters<THandler>`})]}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(l.TypeDeclaration,{export:!0,name:`GlobalContextStatus`,children:o.code`"initializing" | "preparing" | "executing" | "completed"`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`The state object for the ${t.getAppTitle(e)} application context.`}}),(0,i.createComponent)(l.InterfaceDeclaration,{export:!0,name:`GlobalContextState`,get children(){return[(0,i.createComponent)(d.TSDoc,{heading:`The unique identifier for the current execution context.`}),(0,i.createComponent)(l.InterfaceMember,{name:`executionId`,type:`string`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`The status of the current execution context.`}),(0,i.createComponent)(l.InterfaceMember,{name:`status`,type:`GlobalContextStatus`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`Indicates whether the current execution context has encountered an error.`}),(0,i.createComponent)(l.InterfaceMember,{name:`isError`,type:`boolean`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`A map containing arbitrary data associated with the current execution context.`}),(0,i.createComponent)(l.InterfaceMember,{name:`meta`,type:`Map<string, unknown>`})]}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`The context object for the ${t.getAppTitle(e)} application.`}}),(0,i.createComponent)(l.InterfaceDeclaration,{export:!0,name:`GlobalContext`,get children(){return[(0,i.createComponent)(d.TSDoc,{heading:`The global options shared across all commands in the application.`}),(0,i.createComponent)(l.InterfaceMember,{name:`options`,type:`GlobalOptions`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`The raw command-line arguments passed to the application.`}),(0,i.createComponent)(l.InterfaceMember,{name:`inputArgs`,type:`string[]`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`The state of the current execution context.`}),(0,i.createComponent)(l.InterfaceMember,{name:`state`,type:`GlobalContextState`})]}})]}g.__type=[`GlobalTypeDefinitions`,`P"/!`];function _(){return[(0,i.createComponent)(d.TSDoc,{heading:`Retrieves the command-line arguments from Deno or Node.js environments.`,get children(){return[(0,i.createComponent)(d.TSDocRemarks,{children:"This function is only intended for internal use. Please use `useArgs()` instead."}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDocInternal,{}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDocReturns,{children:`An array of command-line arguments from Deno or Node.js environments.`})]}}),(0,i.createComponent)(l.FunctionDeclaration,{name:`getInputArgs`,returnType:`string[]`,children:o.code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`})]}_.__type=[`ArgsUtilities`,`Generates utilities for detecting terminal color support.`,`P"/!?"`];function v(){let e=(c.usePowerlines.Ω=[[`Context`,`"w!`]],(0,c.usePowerlines)()),n=(0,o.computed)(()=>Object.fromEntries(e.globalOptions.map(h(e=>[e.name,e],[`option`,``,`P"2!"/"`]))));return[(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`The global ${t.getAppTitle(e)} application context store instance.`},get children(){return(0,i.createComponent)(d.TSDocInternal,{})}}),(0,i.createComponent)(l.VarDeclaration,{export:!0,const:!0,name:`unstable_globalStore`,children:o.code`  new AsyncLocalStorage<GlobalContext>({ name: "globalStore" }); `}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`Get the ${t.getAppTitle(e)} application context for the current application.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{get children(){return`The ${t.getAppTitle(e)} application context for the current application or undefined if the context is not available.`}})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useGlobal`,returnType:`GlobalContext`,children:o.code`return unstable_globalStore.getStore() as GlobalContext;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the command-line arguments from the ${t.getAppTitle(e)} application context.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`An array of command-line arguments from the application context.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useArgs`,returnType:`string[]`,children:o.code`return useGlobal()?.inputArgs ?? getInputArgs();`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the command-line global options from the ${t.getAppTitle(e)} application context.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`An object containing the global options from the application context.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useGlobalOptions`,returnType:`GlobalOptions`,children:o.code`return useGlobal()?.options ?? {};`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the state of the ${t.getAppTitle(e)} application context.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`The state of the application context.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useState`,returnType:`GlobalContextState`,children:o.code`return useGlobal()?.state;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility function to update the state of the ${t.getAppTitle(e)} application context.`},get children(){return[(0,i.createComponent)(d.TSDocRemarks,{children:"This function will throw an error if the global context is not available, so it should only be used within a valid context scope, such as within a command handler or within the `withGlobal()` function."}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDocParam,{name:`update`,children:`The new state or a function that receives the previous state and returns the new state. This allows for both direct state updates and functional updates based on the previous state.`})]}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`setState`,parameters:[{name:`update`,type:`Partial<GlobalContextState> | ((prev: GlobalContextState) => GlobalContextState)`}],get children(){return o.code`const prev = useGlobal()?.state;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_contexts_options = require('../contexts/options.cjs');
+require('../plugin-utils/index.cjs');
+const require_components_options_parser_logic = require('./options-parser-logic.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
+let _powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+
+//#region src/components/state-builtin.tsx
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function GlobalTypeDefinitions() {
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	const options = (0, _alloy_js_core.computed)(() => require_contexts_options.computedOptions(context.globalOptions));
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { get heading() {
+			return `An object representing the global options available for every command in the ${require_context_helpers.getAppTitle(context, true)} command-line application.`;
+		} }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "GlobalOptions",
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+					get each() {
+						return Object.values(options.value);
+					},
+					hardline: true,
+					get children() {
+						return __assignType((option) => (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_options_parser_logic.OptionsMember, { option }), [
+							"option",
+							"",
+							"P\"2!\"/\""
+						]);
+					}
+				});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The context object for the current command execution, containing the command path and segments." }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "CommandContext",
+			typeParameters: [{
+				name: "THandler",
+				extends: "(...params: any[]) => any",
+				default: "any"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { get heading() {
+						return `The full command path as a string. For example, if the user runs \`${require_context_helpers.getAppBin(context)} foo bar\`, this would be \`foo bar\`. This is useful for commands that need to know their full invocation path, such as for help text or for commands that have dynamic behavior based on their position in the command hierarchy.`;
+					} }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "path",
+						type: "string"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { get heading() {
+						return `An array of command path segments. For example, if the user runs \`${require_context_helpers.getAppBin(context)} foo bar\`, this would be \`["foo", "bar"]\`. This is useful for commands that need to know their individual path segments, such as for dynamic routing or for commands that have behavior based on specific segments in the command hierarchy.`;
+					} }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "segments",
+						type: "string[]"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: `The parameters for the current command's handler function.` }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "params",
+						type: "Parameters<THandler>"
+					})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.TypeDeclaration, {
+			"export": true,
+			name: "GlobalContextStatus",
+			children: _alloy_js_core.code`"initializing" | "preparing" | "executing" | "completed"`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { get heading() {
+			return `The state object for the ${require_context_helpers.getAppTitle(context)} application context.`;
+		} }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "GlobalContextState",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The unique identifier for the current execution context." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "executionId",
+						type: "string"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The status of the current execution context." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "status",
+						type: "GlobalContextStatus"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "Indicates whether the current execution context has encountered an error." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "isError",
+						type: "boolean"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "A map containing arbitrary data associated with the current execution context." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "meta",
+						type: "Map<string, unknown>"
+					})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { get heading() {
+			return `The context object for the ${require_context_helpers.getAppTitle(context)} application.`;
+		} }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+			"export": true,
+			name: "GlobalContext",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The global options shared across all commands in the application." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "options",
+						type: "GlobalOptions"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The raw command-line arguments passed to the application." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "inputArgs",
+						type: "string[]"
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, { heading: "The state of the current execution context." }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+						name: "state",
+						type: "GlobalContextState"
+					})
+				];
+			}
+		})
+	];
+}
+GlobalTypeDefinitions.__type = ["GlobalTypeDefinitions", "P\"/!"];
+/**
+* Generates utilities for detecting terminal color support.
+*/
+function ArgsUtilities() {
+	return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+		heading: "Retrieves the command-line arguments from Deno or Node.js environments.",
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This function is only intended for internal use. Please use \`useArgs()\` instead.` }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocInternal, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `An array of command-line arguments from Deno or Node.js environments.` })
+			];
+		}
+	}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+		name: "getInputArgs",
+		returnType: "string[]",
+		children: _alloy_js_core.code`return ((globalThis as { Deno?: { args: string[] } })?.Deno?.args ?? process.argv ?? []) as string[];`
+	})];
+}
+ArgsUtilities.__type = [
+	"ArgsUtilities",
+	"Generates utilities for detecting terminal color support.",
+	"P\"/!?\""
+];
+function ContextUtilities() {
+	const context = (_powerlines_plugin_alloy_core_contexts_context.usePowerlines.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)());
+	const options = (0, _alloy_js_core.computed)(() => Object.fromEntries(context.globalOptions.map(__assignType((option) => [option.name, option], [
+		"option",
+		"",
+		"P\"2!\"/\""
+	]))));
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `The global ${require_context_helpers.getAppTitle(context)} application context store instance.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocInternal, {});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			"const": true,
+			name: "unstable_globalStore",
+			children: _alloy_js_core.code`  new AsyncLocalStorage<GlobalContext>({ name: "globalStore" }); `
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `Get the ${require_context_helpers.getAppTitle(context)} application context for the current application.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { get children() {
+					return `The ${require_context_helpers.getAppTitle(context)} application context for the current application or undefined if the context is not available.`;
+				} });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useGlobal",
+			returnType: "GlobalContext",
+			children: _alloy_js_core.code`return unstable_globalStore.getStore() as GlobalContext;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the command-line arguments from the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An array of command-line arguments from the application context." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useArgs",
+			returnType: "string[]",
+			children: _alloy_js_core.code`return useGlobal()?.inputArgs ?? getInputArgs();`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the command-line global options from the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An object containing the global options from the application context." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useGlobalOptions",
+			returnType: "GlobalOptions",
+			children: _alloy_js_core.code`return useGlobal()?.options ?? {};`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the state of the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "The state of the application context." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useState",
+			returnType: "GlobalContextState",
+			children: _alloy_js_core.code`return useGlobal()?.state;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility function to update the state of the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: `This function will throw an error if the global context is not available, so it should only be used within a valid context scope, such as within a command handler or within the \`withGlobal()\` function.` }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "update",
+						children: `The new state or a function that receives the previous state and returns the new state. This allows for both direct state updates and functional updates based on the previous state.`
+					})
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "setState",
+			parameters: [{
+				name: "update",
+				type: "Partial<GlobalContextState> | ((prev: GlobalContextState) => GlobalContextState)"
+			}],
+			get children() {
+				return _alloy_js_core.code`const prev = useGlobal()?.state;
         if (!prev) {
           throw new Error(
-            \`The ${t.getAppTitle(e)} application context is not available. Make sure to call setState() within a valid context scope.\`
+            \`The ${require_context_helpers.getAppTitle(context)} application context is not available. Make sure to call setState() within a valid context scope.\`
           );
         }
 
-        useGlobal().state = typeof update === "function" ? update(prev) : { ...prev, ...update }; `}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the execution ID of the ${t.getAppTitle(e)} application context.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`The execution ID of the application context.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useExecutionId`,returnType:`string`,children:o.code`return useState().executionId;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the metadata of the ${t.getAppTitle(e)} application context.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`The metadata of the application context.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useMeta`,returnType:`Map<string, unknown>`,children:o.code`return useState().meta;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility hook function to get the current status of the ${t.getAppTitle(e)} application.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`The current status of the application.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useStatus`,returnType:`GlobalContextStatus`,children:o.code`return useState().status;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`The global ${t.getAppTitle(e)} - command context store instance.`},get children(){return(0,i.createComponent)(d.TSDocInternal,{})}}),(0,i.createComponent)(l.VarDeclaration,{export:!0,name:`unstable_commandStore`,children:o.code`new AsyncLocalStorage<CommandContext>({ name: "commandStore" });`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`Get the ${t.getAppTitle(e)} - command context for the current application.`},get children(){return(0,i.createComponent)(d.TSDocReturns,{get children(){return`The ${t.getAppTitle(e)} - command context for the current application.`}})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useCommand`,returnType:`CommandContext`,get children(){return o.code`const result = unstable_commandStore.getStore();
+        useGlobal().state = typeof update === "function" ? update(prev) : { ...prev, ...update }; `;
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the execution ID of the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "The execution ID of the application context." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useExecutionId",
+			returnType: "string",
+			children: _alloy_js_core.code`return useState().executionId;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the metadata of the ${require_context_helpers.getAppTitle(context)} application context.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "The metadata of the application context." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useMeta",
+			returnType: "Map<string, unknown>",
+			children: _alloy_js_core.code`return useState().meta;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility hook function to get the current status of the ${require_context_helpers.getAppTitle(context)} application.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "The current status of the application." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useStatus",
+			returnType: "GlobalContextStatus",
+			children: _alloy_js_core.code`return useState().status;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `The global ${require_context_helpers.getAppTitle(context)} - command context store instance.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocInternal, {});
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+			"export": true,
+			name: "unstable_commandStore",
+			children: _alloy_js_core.code`new AsyncLocalStorage<CommandContext>({ name: "commandStore" });`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `Get the ${require_context_helpers.getAppTitle(context)} - command context for the current application.`;
+			},
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { get children() {
+					return `The ${require_context_helpers.getAppTitle(context)} - command context for the current application.`;
+				} });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useCommand",
+			returnType: "CommandContext",
+			get children() {
+				return _alloy_js_core.code`const result = unstable_commandStore.getStore();
 if (!result) {
   throw new Error(
-    \`The ${t.getAppTitle(e)} - command context is not available. Make sure to call useCommand() within a valid context scope.\`
+    \`The ${require_context_helpers.getAppTitle(context)} - command context is not available. Make sure to call useCommand() within a valid context scope.\`
   );
 }
-return result;`}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`A utility hook function to get the individual segments of the current command path.`,get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`An array of command path segments.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`useSegments`,returnType:`string[]`,children:o.code`return useCommand().segments;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`A utility hook function to get the full command path as a string.`,get children(){return(0,i.createComponent)(d.TSDocReturns,{get children(){return`The full command path as a string. For example, if the user runs \`${t.getAppBin(e)} foo bar\`, this would return \`"foo bar"\`. This is useful for commands that need to know their full invocation path, such as for help text or for commands that have dynamic behavior based on their position in the command hierarchy.`}})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`usePath`,returnType:`string`,children:o.code`return useCommand().path;`}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`Checks if a specific flag is present in the command-line arguments.`,get children(){return[(0,i.createComponent)(d.TSDocLink,{children:`https://github.com/sindresorhus/has-flag/blob/main/index.js`}),(0,i.createComponent)(d.TSDocParam,{name:`flag`,children:`The flag (or an array of flags/aliases) to check for, e.g., "color", "no-color".`}),(0,i.createComponent)(d.TSDocParam,{name:`argv`,children:`The command-line arguments to check against. Defaults to global Deno args or process args.`}),(0,i.createComponent)(d.TSDocReturns,{children:`True if the flag is present, false otherwise.`})]}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`hasFlag`,parameters:[{name:`flag`,type:`string | string[]`},{name:`argv`,type:`string[]`,default:`useArgs()`}],get children(){return[(0,i.createComponent)(l.VarDeclaration,{const:!0,name:`position`,type:`number`,initializer:o.code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {
+return result;`;
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "A utility hook function to get the individual segments of the current command path.",
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "An array of command path segments." });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "useSegments",
+			returnType: "string[]",
+			children: _alloy_js_core.code`return useCommand().segments;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "A utility hook function to get the full command path as a string.",
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { get children() {
+					return `The full command path as a string. For example, if the user runs \`${require_context_helpers.getAppBin(context)} foo bar\`, this would return \`"foo bar"\`. This is useful for commands that need to know their full invocation path, such as for help text or for commands that have dynamic behavior based on their position in the command hierarchy.`;
+				} });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "usePath",
+			returnType: "string",
+			children: _alloy_js_core.code`return useCommand().path;`
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "Checks if a specific flag is present in the command-line arguments.",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocLink, { children: "https://github.com/sindresorhus/has-flag/blob/main/index.js" }),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "flag",
+						children: "The flag (or an array of flags/aliases) to check for, e.g., \"color\", \"no-color\"."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+						name: "argv",
+						children: "The command-line arguments to check against. Defaults to global Deno args or process args."
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: "True if the flag is present, false otherwise." })
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "hasFlag",
+			parameters: [{
+				name: "flag",
+				type: "string | string[]"
+			}, {
+				name: "argv",
+				type: "string[]",
+				default: "useArgs()"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+						"const": true,
+						name: "position",
+						type: "number",
+						initializer: _alloy_js_core.code`(Array.isArray(flag) ? flag : [flag]).reduce((ret, f) => {
             const pos = argv.findIndex(arg => (f.startsWith("-") ? "" : (f.length === 1 ? "-" : "--") + f)?.toLowerCase() === arg?.toLowerCase() || arg?.toLowerCase().startsWith((f.length === 1 ? "-" : "--") + f + "="));
             return pos !== -1 ? pos : ret;
-          }, -1);`}),(0,i.createIntrinsic)(`hbr`,{}),o.code`return position !== -1 && argv.indexOf("--") === -1 || position < argv.indexOf("--");`]}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{heading:`A utility function to determine if the help flag is present or if the command is in an error state during preparation.`,get children(){return(0,i.createComponent)(d.TSDocReturns,{children:`True if the help flag is present or if the command is in an error state during preparation, false otherwise. This can be used to conditionally display help text or to alter command behavior when the user is likely seeking help.`})}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,name:`isHelp`,returnType:`boolean`,children:o.code`return !isCI && (hasFlag(["help", "h", "?"]) || (useStatus() === "preparing" && useState().isError)); `}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility function to wrap the ${t.getAppTitle(e)} application within the global context scope.`},get children(){return[(0,i.createComponent)(d.TSDocParam,{name:`handler`,children:`The callback function to run within the global context scope. This function will receive the global context as its argument, allowing it to access any properties or utilities defined on the context. The callback function can be asynchronous and can return a value or a promise.`}),(0,i.createComponent)(d.TSDocReturns,{children:`The result of the callback function, which can be a value or a promise that resolves to a value.`})]}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,async:!0,name:`withGlobal`,parameters:[{name:`handler`,type:`() => any`}],returnType:`Promise<void>`,get children(){return[(0,i.createComponent)(l.VarDeclaration,{const:!0,name:`args`,initializer:o.code`getInputArgs(); `}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(r.OptionsParserLogic,{get options(){return n.value},get appSpecificEnvPrefix(){return e.config.appSpecificEnvPrefix},get isCaseSensitive(){return e.config.isCaseSensitive}}),(0,i.createComponent)(s.Spacing,{}),o.code`
-        return unstable_globalStore.run({ options, inputArgs: args, state: { executionId: randomUUID(), status: "initializing", isError: false, meta: new Map() } as GlobalContextState }, handler);`]}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.TSDoc,{get heading(){return`A utility function to wrap a ${t.getAppTitle(e)} application command handler within the command context scope.`},get children(){return[(0,i.createComponent)(d.TSDocParam,{name:`handler`,children:`The callback function to run within the command context scope. This function will receive the command context as its argument, allowing it to access any properties or utilities defined on the context. The callback function can be asynchronous and can return a value or a promise.`}),(0,i.createComponent)(d.TSDocReturns,{children:`The result of the callback function, which can be a value or a promise that resolves to a value.`})]}}),(0,i.createComponent)(l.FunctionDeclaration,{export:!0,async:!0,name:`withCommand`,typeParameters:[{name:`THandler`,extends:`(this: CommandContext, ...params: any[]) => any`,default:`(this: CommandContext, ...params: any[]) => any`}],parameters:[{name:`path`,type:`string`},{name:`segments`,type:`string[]`},{name:`params`,type:`Parameters<THandler>`},{name:`handler`,type:`THandler`}],returnType:`Promise<{ error: string | Error | null }>`,children:o.code`setState({ status: "preparing", isError: false });
+          }, -1);`
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					_alloy_js_core.code`return position !== -1 && argv.indexOf("--") === -1 || position < argv.indexOf("--");`
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			heading: "A utility function to determine if the help flag is present or if the command is in an error state during preparation.",
+			get children() {
+				return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `True if the help flag is present or if the command is in an error state during preparation, false otherwise. This can be used to conditionally display help text or to alter command behavior when the user is likely seeking help.` });
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			name: "isHelp",
+			returnType: "boolean",
+			children: _alloy_js_core.code`return !isCI && (hasFlag(["help", "h", "?"]) || (useStatus() === "preparing" && useState().isError)); `
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility function to wrap the ${require_context_helpers.getAppTitle(context)} application within the global context scope.`;
+			},
+			get children() {
+				return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+					name: "handler",
+					children: `The callback function to run within the global context scope. This function will receive the global context as its argument, allowing it to access any properties or utilities defined on the context. The callback function can be asynchronous and can return a value or a promise.`
+				}), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `The result of the callback function, which can be a value or a promise that resolves to a value.` })];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "withGlobal",
+			parameters: [{
+				name: "handler",
+				type: "() => any"
+			}],
+			returnType: "Promise<void>",
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+						"const": true,
+						name: "args",
+						initializer: _alloy_js_core.code`getInputArgs(); `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(require_components_options_parser_logic.OptionsParserLogic, {
+						get options() {
+							return options.value;
+						},
+						get appSpecificEnvPrefix() {
+							return context.config.appSpecificEnvPrefix;
+						},
+						get isCaseSensitive() {
+							return context.config.isCaseSensitive;
+						}
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`
+        return unstable_globalStore.run({ options, inputArgs: args, state: { executionId: randomUUID(), status: "initializing", isError: false, meta: new Map() } as GlobalContextState }, handler);`
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+			get heading() {
+				return `A utility function to wrap a ${require_context_helpers.getAppTitle(context)} application command handler within the command context scope.`;
+			},
+			get children() {
+				return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+					name: "handler",
+					children: `The callback function to run within the command context scope. This function will receive the command context as its argument, allowing it to access any properties or utilities defined on the context. The callback function can be asynchronous and can return a value or a promise.`
+				}), (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `The result of the callback function, which can be a value or a promise that resolves to a value.` })];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			"export": true,
+			async: true,
+			name: "withCommand",
+			typeParameters: [{
+				name: "THandler",
+				extends: "(this: CommandContext, ...params: any[]) => any",
+				default: "(this: CommandContext, ...params: any[]) => any"
+			}],
+			parameters: [
+				{
+					name: "path",
+					type: "string"
+				},
+				{
+					name: "segments",
+					type: "string[]"
+				},
+				{
+					name: "params",
+					type: "Parameters<THandler>"
+				},
+				{
+					name: "handler",
+					type: "THandler"
+				}
+			],
+			returnType: "Promise<{ error: string | Error | null }>",
+			children: _alloy_js_core.code`setState({ status: "preparing", isError: false });
 
         const ctx = { path, segments, params } as CommandContext<THandler>;
         const result = await Promise.resolve(unstable_commandStore.run(ctx, () => Reflect.apply(handler, ctx, params)));
@@ -25,4 +585,66 @@ return result;`}}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(d.T
         }
 
         setState({ status: "completed", isError: false });
-        return { error: null }; `})]}v.__type=[`ContextUtilities`,`P"/!`];const y=[()=>f,`id`,`description`,`StateBuiltinProps`,`P!P.".#Jo!#Mw$y`];function b(e){let[{children:t},n]=(0,o.splitProps)(e,[`children`]);return(0,i.createComponent)(u.BuiltinFile,(0,i.mergeProps)({id:`state`,description:`A module that provides context hooks and utilities for accessing the application state.`},n,{get imports(){return(0,a.default)(n.imports??{},{"node:async_hooks":[`AsyncLocalStorage`],"node:crypto":[`randomUUID`]})},get builtinImports(){return(0,a.default)(n.builtinImports??{},{env:[`isCI`,`env`]})},get children(){return[(0,i.createComponent)(g,{}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(_,{}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(v,{}),(0,i.createComponent)(s.Spacing,{}),(0,i.createComponent)(o.Show,{get when(){return!!t},children:t})]}}))}b.__type=[()=>y,`props`,`StateBuiltin`,`A built-in module for handling application state utilities in Shell Shock.`,`Pn!2""/#?$`],exports.ArgsUtilities=_,exports.ContextUtilities=v,exports.GlobalTypeDefinitions=g,exports.StateBuiltin=b,exports.__ΩStateBuiltinProps=y;
+        return { error: null }; `
+		})
+	];
+}
+ContextUtilities.__type = ["ContextUtilities", "P\"/!"];
+const __ΩStateBuiltinProps = [
+	() => __ΩOmit,
+	"id",
+	"description",
+	"StateBuiltinProps",
+	"P!P.\".#Jo!#Mw$y"
+];
+/**
+* A built-in module for handling application state utilities in Shell Shock.
+*/
+function StateBuiltin(props) {
+	const [{ children }, rest] = (0, _alloy_js_core.splitProps)(props, ["children"]);
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_builtin_file.BuiltinFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		id: "state",
+		description: "A module that provides context hooks and utilities for accessing the application state."
+	}, rest, {
+		get imports() {
+			return (0, defu.default)(rest.imports ?? {}, {
+				"node:async_hooks": ["AsyncLocalStorage"],
+				"node:crypto": ["randomUUID"]
+			});
+		},
+		get builtinImports() {
+			return (0, defu.default)(rest.builtinImports ?? {}, { env: ["isCI", "env"] });
+		},
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(GlobalTypeDefinitions, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(ArgsUtilities, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(ContextUtilities, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+					get when() {
+						return Boolean(children);
+					},
+					children
+				})
+			];
+		}
+	}));
+}
+StateBuiltin.__type = [
+	() => __ΩStateBuiltinProps,
+	"props",
+	"StateBuiltin",
+	"A built-in module for handling application state utilities in Shell Shock.",
+	"Pn!2\"\"/#?$"
+];
+
+//#endregion
+exports.ArgsUtilities = ArgsUtilities;
+exports.ContextUtilities = ContextUtilities;
+exports.GlobalTypeDefinitions = GlobalTypeDefinitions;
+exports.StateBuiltin = StateBuiltin;
+exports.__ΩStateBuiltinProps = __ΩStateBuiltinProps;
+//# sourceMappingURL=state-builtin.cjs.map