@shell-shock/preset-script 0.6.2 → 0.6.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/components/banner-function-declaration.cjs +2 -1
- package/dist/components/banner-function-declaration.cjs.map +1 -1
- package/dist/components/banner-function-declaration.mjs +2 -1
- package/dist/components/banner-function-declaration.mjs.map +1 -1
- package/dist/components/bin-entry.cjs +3 -1
- package/dist/components/bin-entry.cjs.map +1 -1
- package/dist/components/bin-entry.mjs +3 -1
- package/dist/components/bin-entry.mjs.map +1 -1
- package/dist/components/command-entry.cjs +1 -2
- package/dist/components/command-entry.cjs.map +1 -1
- package/dist/components/command-entry.d.cts.map +1 -1
- package/dist/components/command-entry.d.mts.map +1 -1
- package/dist/components/command-entry.mjs +1 -2
- package/dist/components/command-entry.mjs.map +1 -1
- package/dist/components/command-router.cjs +1 -1
- package/dist/components/command-router.cjs.map +1 -1
- package/dist/components/command-router.mjs +1 -1
- package/dist/components/command-router.mjs.map +1 -1
- package/dist/components/help.cjs +0 -3
- package/dist/components/help.cjs.map +1 -1
- package/dist/components/help.d.cts +7 -7
- package/dist/components/help.d.cts.map +1 -1
- package/dist/components/help.d.mts.map +1 -1
- package/dist/components/help.mjs +0 -3
- package/dist/components/help.mjs.map +1 -1
- package/dist/components/helpers.d.cts +5 -5
- package/package.json +7 -7
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"help.mjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","arguments","argument","name","kind","string","number","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"sources":["../../src/components/help.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, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n getAppBin,\n getDynamicPathSegmentName,\n isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n CommandOption,\n CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 2\n */\n indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n const { command, indent = 2 } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n const theme = useTheme();\n\n return (\n <>\n <For each={Object.keys(context.config.bin)} hardline>\n {bin => (\n <>\n {code`\n writeLine(\n colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n command.arguments.length > 0\n ? ` ${command.arguments\n .map(\n argument =>\n `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n (argument.kind === ReflectionKind.string ||\n argument.kind === ReflectionKind.number) &&\n argument.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </>\n )}\n </For>\n <Show when={command.arguments.length > 0}>\n <hbr />\n <For each={Object.keys(context.config.bin)} hardline>\n {bin => (\n <>\n {code`\n writeLine(\n colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n command.arguments.length > 0\n ? ` ${command.arguments\n .map(\n argument =>\n `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n (argument.kind === ReflectionKind.string ||\n argument.kind === ReflectionKind.number) &&\n argument.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n }\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </>\n )}\n </For>\n </Show>\n </>\n );\n}\n\nexport interface HelpOptionsProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n const { options } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={sortOptions(options)} hardline>\n {option => {\n const flags = [] as string[];\n const names = [] as string[];\n if (option.name.length === 1) {\n flags.push(`-${option.name}`);\n } else {\n names.push(`--${kebabCase(option.name)}`);\n }\n\n option.alias.forEach((alias: string) => {\n if (alias.length === 1) {\n flags.push(`-${alias}`);\n } else {\n names.push(`--${kebabCase(alias)}`);\n }\n });\n\n return code`[{ value: colors.text.body.primary(\"${\n flags.length > 0\n ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n : \"\"\n }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n option.kind === ReflectionKind.string\n ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n : option.kind === ReflectionKind.number\n ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n : \"\"\n }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n /\\.+$/,\n \"\"\n )} ${\n option.env || option.default !== undefined\n ? `(${\n option.env\n ? `env: ${context.config.envPrefix}_${option.env}${\n option.default !== undefined ? \", \" : \"\"\n }`\n : \"\"\n }${\n option.default !== undefined\n ? `default: ${JSON.stringify(option.default)}`\n : \"\"\n })`\n : \"\"\n }.\"), align: \"left\", border: \"none\" }], `;\n }}\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface HelpCommandsProps {\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n const { commands } = props;\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={Object.values(commands)} hardline>\n {child =>\n code`[{ value: colors.text.body.primary(\"${\n child.name\n }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n /\\.+$/,\n \"\"\n )}\"), align: \"left\", border: \"none\" }], `\n }\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface BaseHelpProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * Whether to filter out global options from the help display.\n *\n * @remarks\n * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n *\n * @defaultValue false\n */\n filterGlobalOptions?: boolean;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 1\n */\n indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelp(props: BaseHelpProps) {\n const { command, indent = 1, filterGlobalOptions = false } = props;\n\n const theme = useTheme();\n const context = usePowerlines<ScriptPresetContext>();\n\n const options = computed(() =>\n filterGlobalOptions\n ? Object.values(command.options).filter(\n option =>\n !context.options.some(\n globalOption =>\n globalOption.name === option.name ||\n option.alias.includes(globalOption.name) ||\n globalOption.alias?.includes(option.name) ||\n globalOption.alias?.some(alias => option.alias.includes(alias))\n )\n )\n : Object.values(command.options)\n );\n\n return (\n <>\n {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpUsage command={command} indent={indent} />\n <hbr />\n <hbr />\n <Show when={options.value.length > 0}>\n {code`writeLine(\"\");\n writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpOptions options={options.value} />\n <hbr />\n <hbr />\n </Show>\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(\"\");\n writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpCommands commands={command.children} />\n <hbr />\n <hbr />\n </Show>\n </>\n );\n}\n\nexport interface VirtualHelpProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n\n /**\n * The command path to generate help for, used for generating the help invocation instructions.\n *\n * @remarks\n * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n */\n segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n const { options, segments, commands } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n {code`\n writeLine(\"\"); `}\n <hbr />\n <hbr />\n {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n <hbr />\n <HelpOptions options={options} />\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <Show when={Object.keys(commands).length > 0}>\n {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n writeLine(\"\"); `}\n <hbr />\n <hbr />\n <For\n each={Object.values(commands)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n {code`\n writeLine(colors.text.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n writeLine(\"\");\n writeLine(colors.text.body.secondary(\"${child.description}\"));\n writeLine(\"\");\n `}\n <hbr />\n <BaseHelp command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n context\n )}${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } <specific command> --help') will provide additional information that is specific to that command.\");\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n\nexport interface CommandHelpProps {\n /**\n * A mapping of command names to their command definitions.\n */\n command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n const { command } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <BaseHelp command={command} filterGlobalOptions={false} />\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n writeLine(\"\"); `}\n <hbr />\n <hbr />\n <For\n each={Object.values(command.children)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n {code`\n writeLine(colors.text.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n writeLine(\"\");\n writeLine(colors.text.body.secondary(\"${child.description}\"));\n writeLine(\"\");\n `}\n <hbr />\n <BaseHelp command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n context\n )} ${command.segments.join(\n \" \"\n )} <specific command> --help') will provide additional information that is specific to that command.\");\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwDA,SAAgBa,UAAUC,OAAuB;CAC/C,MAAM,EAAEC,SAASC,SAAS,MAAMF;CAEhC,MAAMG,UAAUZ,eAAoC;CACpD,MAAMa,QAAQN,UAAU;AAExB,QAAA,CAAAO,gBAEKjB,KAAG;EAAA,IAACkB,OAAI;AAAA,UAAEC,OAAOC,KAAKL,QAAQM,OAAOC,IAAI;;EAAEC,UAAQ;EAAAC,WACjDF,QAAG,CAAAG,WAEC3B,IAAI;;oEAEmDwB,IAAG,KAC7DT,QAAQa,SAASC,SAAS,IACtB,IAAId,QAAQa,SACTE,KACCC,YACE,wBAAwBvB,qBAAqBuB,QAAQ,GAAG,YAAY,UAAS,IAC3EvB,qBAAqBuB,QAAQ,GACzB,IAAIpB,UAAUJ,0BAA0BwB,QAAQ,CAAC,CAAA,KACjDA,QAAO,KAEhB,CACAC,KAAK,IAAI,KACZ,KACHX,OAAOY,OAAOlB,QAAQW,SAAS,CAACG,SAAS,IAAI,gDAAgD,KAC9Fd,QAAQmB,UAAUL,SAAS,IACvB,IAAId,QAAQmB,UACTJ,KACCK,aACE,oCAAoCxB,UAAUwB,SAASC,KAAK,IACzDD,SAASE,SAASjC,eAAekC,UAChCH,SAASE,SAASjC,eAAemC,WACnCJ,SAASK,WACL,QACA,GAAE,MAEX,CACAR,KAAK,IAAI,KACZ,GAAE,6DACsDd,MAAMuB,QAAQC,MAAM1B,OAAM;UACvF,EAAA2B,gBAAA,OAAA,EAAA,CAAA,CAAA;EAGA,CAAA,EAAAxB,gBAEFhB,MAAI;EAAA,IAACyC,OAAI;AAAA,UAAE7B,QAAQmB,UAAUL,SAAS;;EAAC,IAAAH,WAAA;AAAA,UAAA,CAAAiB,gBAAA,OAAA,EAAA,CAAA,EAAAxB,gBAErCjB,KAAG;IAAA,IAACkB,OAAI;AAAA,YAAEC,OAAOC,KAAKL,QAAQM,OAAOC,IAAI;;IAAEC,UAAQ;IAAAC,WACjDF,QAAG,CAAAG,WAEC3B,IAAI;;oEAEiDwB,IAAG,KAC7DT,QAAQa,SAASC,SAAS,IACtB,IAAId,QAAQa,SACTE,KACCC,YACE,wBAAwBvB,qBAAqBuB,QAAQ,GAAG,YAAY,UAAS,IAC3EvB,qBAAqBuB,QAAQ,GACzB,IAAIpB,UAAUJ,0BAA0BwB,QAAQ,CAAC,CAAA,KACjDA,QAAO,KAEhB,CACAC,KAAK,IAAI,KACZ,KACHX,OAAOY,OAAOlB,QAAQW,SAAS,CAACG,SAAS,IAAI,gDAAgD,GAAE,6CAChGd,QAAQmB,UAAUL,SAAS,IACvB,IAAId,QAAQmB,UACTJ,KACCK,aACE,oCAAoCxB,UAAUwB,SAASC,KAAK,IACzDD,SAASE,SAASjC,eAAekC,UAChCH,SAASE,SAASjC,eAAemC,WACnCJ,SAASK,WACL,QACA,GAAE,MAEX,CACAR,KAAK,IAAI,KACZ,GAAE,kBACWd,MAAMuB,QAAQC,MAAM1B,OAAM;UAC5C,EAAA2B,gBAAA,OAAA,EAAA,CAAA,CAAA;IAGE,CAAA,CAAA;;EAAA,CAAA,CAAA;;;;;AAiBX,SAAgBE,YAAY/B,OAAyB;CACnD,MAAM,EAAEgC,YAAYhC;CAEpB,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAEKL,IAAI;EAAU2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEdjB,KAAG;GAAA,IAACkB,OAAI;AAAA,WAAEX,YAAYqC,QAAQ;;GAAErB,UAAQ;GAAAC,WACtCqB,WAAU;IACT,MAAMC,QAAQ,EAAc;IAC5B,MAAMC,QAAQ,EAAc;AAC5B,QAAIF,OAAOX,KAAKP,WAAW,EACzBmB,OAAME,KAAK,IAAIH,OAAOX,OAAO;QAE7Ba,OAAMC,KAAK,KAAKxC,UAAUqC,OAAOX,KAAK,GAAG;AAG3CW,WAAOI,MAAMC,SAASD,UAAkB;AACtC,SAAIA,MAAMtB,WAAW,EACnBmB,OAAME,KAAK,IAAIC,QAAQ;SAEvBF,OAAMC,KAAK,KAAKxC,UAAUyC,MAAM,GAAG;MAErC;AAEF,WAAOnD,IAAI,uCACTgD,MAAMnB,SAAS,IACX,GAAGmB,MAAMK,MAAM,CAACrB,KAAK,KAAK,GAAGiB,MAAMpB,SAAS,IAAI,OAAO,OACvD,KACHoB,MAAMpB,SAAS,IAAIoB,MAAMI,MAAM,CAACrB,KAAK,KAAK,GAAG,KAC9Ce,OAAOV,SAASjC,eAAekC,SAC3B,KAAK3B,UAAUoC,OAAOX,KAAK,GAAGW,OAAOP,WAAW,QAAQ,GAAE,KAC1DO,OAAOV,SAASjC,eAAemC,SAC7B,KAAK5B,UAAUoC,OAAOX,KAAK,GAAGW,OAAOP,WAAW,QAAQ,GAAE,KAC1D,GAAE,4EACmEO,OAAOO,YAAYC,QAC9F,QACA,GACD,CAAA,GACCR,OAAOS,OAAOT,OAAOU,YAAYC,SAC7B,IACEX,OAAOS,MACH,QAAQvC,QAAQM,OAAOoC,UAAS,GAAIZ,OAAOS,MACzCT,OAAOU,YAAYC,SAAY,OAAO,OAExC,KAEJX,OAAOU,YAAYC,SACf,YAAYE,KAAKC,UAAUd,OAAOU,QAAQ,KAC1C,GAAE,KAER,GAAE;;GAET,CAAA;EAAAd,gBAAA,OAAA,EAAA,CAAA;EAGF3C,IAAI;EAAO;;;;;AAelB,SAAgB8D,aAAahD,OAA0B;CACrD,MAAM,EAAEiD,aAAajD;AAErB,QAAA;EAEKd,IAAI;EAAU2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEdjB,KAAG;GAAA,IAACkB,OAAI;AAAA,WAAEC,OAAOY,OAAO8B,SAAS;;GAAEtC,UAAQ;GAAAC,WACzCsC,UACChE,IAAI,uCACFgE,MAAM5B,KAAI,4EACiE4B,MAAMV,YAAYC,QAC7F,QACA,GACD,CAAA;GAAwC,CAAA;EAAAZ,gBAAA,OAAA,EAAA,CAAA;EAI5C3C,IAAI;EAAO;;;;;AAmClB,SAAgBiE,SAASnD,OAAsB;CAC7C,MAAM,EAAEC,SAASC,SAAS,GAAGkD,sBAAsB,UAAUpD;CAE7D,MAAMI,QAAQN,UAAU;CACxB,MAAMK,UAAUZ,eAAoC;CAEpD,MAAMyC,UAAU7C,eACdiE,sBACI7C,OAAOY,OAAOlB,QAAQ+B,QAAQ,CAACqB,QAC7BpB,WACE,CAAC9B,QAAQ6B,QAAQsB,MACfC,iBACEA,aAAajC,SAASW,OAAOX,QAC7BW,OAAOI,MAAMmB,SAASD,aAAajC,KAAK,IACxCiC,aAAalB,OAAOmB,SAASvB,OAAOX,KAAK,IACzCiC,aAAalB,OAAOiB,MAAKjB,UAASJ,OAAOI,MAAMmB,SAASnB,MAAM,CAClE,CACJ,CAAC,GACD9B,OAAOY,OAAOlB,QAAQ+B,QAC5B,CAAC;AAED,QAAA;EAAAnB,WAEK3B,IAAI,iEACHgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;EAAA2B,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEHN,WAAS;GAAUE;GAAiBC;GAAM,CAAA;EAAA2B,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAG1ChB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEE,QAAQyB,MAAM1C,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KAAAC,WACjC3B,IAAI;wEAELgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;KAAA2B,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAED0B,aAAW,EAAA,IAACC,UAAO;AAAA,aAAEA,QAAQyB;QAAK,CAAA;KAAA5B,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA;EAAAxB,gBAIpChB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKP,QAAQW,SAAS,CAACG,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KAAAC,WACjD3B,IAAI;yEAELgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;KAAA2B,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAED2C,cAAY,EAAA,IAACC,WAAQ;AAAA,aAAEhD,QAAQW;QAAQ,CAAA;KAAAiB,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA;EAAA;;;;;AA+BhD,SAAgB6B,YAAY1D,OAAyB;CACnD,MAAM,EAAEgC,SAASlB,UAAUmC,aAAajD;CAExC,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAEKL,IAAI;;EACW2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAGf3C,IAAI;EAA2E2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAE/E0B,aAAW,EAAUC,SAAO,CAAA;EAC5B9C,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrBhB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKyC,SAAS,CAAClC,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KACzC1B,IAAI;;KACW2C,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAGfjB,KAAG;MAAA,IACFkB,OAAI;AAAA,cAAEC,OAAOY,OAAO8B,SAAS;;MAC7BU,gBAAc;MACdC,QAAQ1E,IAAI;MACZ2E,OAAO3E,IAAI;MAAiB0B,WAC3BsC,UAAK;OAAArC,WAED3B,IAAI;wDAEDgE,MAAMY,OACF,2BAA2BZ,MAAMY,KAAI,gBACrC,GAAE,GACJZ,MAAMa,MAAK,GAAIb,MAAMc,YAAY,KAAK,UAAS;;wDAEXd,MAAMV,YAAW;;kBAExD;OAAAX,gBAAA,OAAA,EAAA,CAAA;OAAAxB,gBAEF8C,UAAQ;QAAClD,SAASiD;QAAOhD,QAAQ;QAAGkD,qBAAmB;QAAA,CAAA;OAAAvB,gBAAA,OAAA,EAAA,CAAA;OAAA;MAG3D,CAAA;KAAAhB,WAEF3B,IAAI,8DAA8DM,UACjEW,QACD,GACCW,YAAYA,SAASC,SAAS,IAAI,IAAID,SAASI,KAAK,IAAI,KAAK,GAAE;wBAElD;KAAA;;GAAA,CAAA;EAAA;;;;;AAgBvB,SAAgB+C,YAAYjE,OAAyB;CACnD,MAAM,EAAEC,YAAYD;CAEpB,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAEKL,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrB8C,UAAQ;GAAUlD;GAASmD,qBAAqB;GAAK,CAAA;EACrDlE,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrBhB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKP,QAAQW,SAAS,CAACG,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KACjD1B,IAAI;;KACW2C,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAGfjB,KAAG;MAAA,IACFkB,OAAI;AAAA,cAAEC,OAAOY,OAAOlB,QAAQW,SAAS;;MACrC+C,gBAAc;MACdC,QAAQ1E,IAAI;MACZ2E,OAAO3E,IAAI;MAAiB0B,WAC3BsC,UAAK;OAAArC,WAED3B,IAAI;wDAEDgE,MAAMY,OACF,2BAA2BZ,MAAMY,KAAI,gBACrC,GAAE,GACJZ,MAAMa,MAAK,GAAIb,MAAMc,YAAY,KAAK,UAAS;;wDAEXd,MAAMV,YAAW;;kBAExD;OAAAX,gBAAA,OAAA,EAAA,CAAA;OAAAxB,gBAEF8C,UAAQ;QAAClD,SAASiD;QAAOhD,QAAQ;QAAGkD,qBAAmB;QAAA,CAAA;OAAAvB,gBAAA,OAAA,EAAA,CAAA;OAAA;MAG3D,CAAA;KAAAhB,WAEF3B,IAAI,8DAA8DM,UACjEW,QACD,CAAA,GAAIF,QAAQa,SAASI,KACpB,IACD,CAAA;wBACc;KAAA;;GAAA,CAAA;EAAA"}
|
|
1
|
+
{"version":3,"file":"help.mjs","names":["code","computed","For","Show","ReflectionKind","usePowerlines","getAppBin","getDynamicPathSegmentName","isDynamicPathSegment","sortOptions","kebabCase","snakeCase","useTheme","HelpUsage","props","command","indent","context","theme","_$createComponent","each","Object","keys","config","bin","hardline","children","_$memo","segments","length","map","segment","join","values","arguments","argument","name","kind","string","number","variadic","padding","app","_$createIntrinsic","when","HelpOptions","options","option","flags","names","push","alias","forEach","sort","description","replace","env","default","undefined","envPrefix","JSON","stringify","HelpCommands","commands","child","BaseHelp","filterGlobalOptions","filter","some","globalOption","includes","value","VirtualHelp","doubleHardline","joiner","ender","icon","title","isVirtual","CommandHelp"],"sources":["../../src/components/help.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, computed, For, Show } from \"@alloy-js/core\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n getAppBin,\n getDynamicPathSegmentName,\n isDynamicPathSegment\n} from \"@shell-shock/core/plugin-utils/context-helpers\";\nimport { sortOptions } from \"@shell-shock/core/plugin-utils/reflect\";\nimport type {\n CommandOption,\n CommandTree\n} from \"@shell-shock/core/types/command\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { useTheme } from \"../contexts\";\nimport type { ScriptPresetContext } from \"../types/plugin\";\n\nexport interface HelpUsageProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 2\n */\n indent?: number;\n}\n\n/**\n * A component that generates the usage display for a command.\n */\nexport function HelpUsage(props: HelpUsageProps) {\n const { command, indent = 2 } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n const theme = useTheme();\n\n return (\n <>\n <For each={Object.keys(context.config.bin)} hardline>\n {bin => (\n <>\n {code`\n writeLine(\n colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"}${\n command.arguments.length > 0\n ? ` ${command.arguments\n .map(\n argument =>\n `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n (argument.kind === ReflectionKind.string ||\n argument.kind === ReflectionKind.number) &&\n argument.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n } \\${colors.text.usage.options(\"[options]\")}\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </>\n )}\n </For>\n <Show when={command.arguments.length > 0}>\n <hbr />\n <For each={Object.keys(context.config.bin)} hardline>\n {bin => (\n <>\n {code`\n writeLine(\n colors.text.body.secondary(\\`\\$ \\${colors.text.usage.bin(\"${bin}\")}${\n command.segments.length > 0\n ? ` ${command.segments\n .map(\n segment =>\n `\\${colors.text.usage.${isDynamicPathSegment(segment) ? \"dynamic\" : \"command\"}(\"${\n isDynamicPathSegment(segment)\n ? `[${snakeCase(getDynamicPathSegmentName(segment))}]`\n : segment\n }\")}`\n )\n .join(\" \")}`\n : \"\"\n }${Object.values(command.children).length > 0 ? ` \\${colors.text.usage.dynamic(\"[command]\")}` : \"\"} \\${colors.text.usage.options(\"[options]\")}${\n command.arguments.length > 0\n ? ` ${command.arguments\n .map(\n argument =>\n `\\${colors.text.usage.arguments(\"<${snakeCase(argument.name)}${\n (argument.kind === ReflectionKind.string ||\n argument.kind === ReflectionKind.number) &&\n argument.variadic\n ? \"...\"\n : \"\"\n }>\")}`\n )\n .join(\" \")}`\n : \"\"\n }\\`), { padding: ${theme.padding.app * indent} }\n );`}\n <hbr />\n </>\n )}\n </For>\n </Show>\n </>\n );\n}\n\nexport interface HelpOptionsProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n}\n\n/**\n * A component that generates the options table display for a command.\n */\nexport function HelpOptions(props: HelpOptionsProps) {\n const { options } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={sortOptions(options)} hardline>\n {option => {\n const flags = [] as string[];\n const names = [] as string[];\n if (option.name.length === 1) {\n flags.push(`-${option.name}`);\n } else {\n names.push(`--${kebabCase(option.name)}`);\n }\n\n option.alias.forEach((alias: string) => {\n if (alias.length === 1) {\n flags.push(`-${alias}`);\n } else {\n names.push(`--${kebabCase(alias)}`);\n }\n });\n\n return code`[{ value: colors.text.body.primary(\"${\n flags.length > 0\n ? `${flags.sort().join(\", \")}${names.length > 0 ? \", \" : \"\"}`\n : \"\"\n }${names.length > 0 ? names.sort().join(\", \") : \"\"}${\n option.kind === ReflectionKind.string\n ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n : option.kind === ReflectionKind.number\n ? ` <${snakeCase(option.name)}${option.variadic ? \"...\" : \"\"}>`\n : \"\"\n }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${option.description.replace(\n /\\.+$/,\n \"\"\n )} ${\n option.env || option.default !== undefined\n ? `(${\n option.env\n ? `env: ${context.config.envPrefix}_${option.env}${\n option.default !== undefined ? \", \" : \"\"\n }`\n : \"\"\n }${\n option.default !== undefined\n ? `default: ${JSON.stringify(option.default)}`\n : \"\"\n })`\n : \"\"\n }.\"), align: \"left\", border: \"none\" }], `;\n }}\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface HelpCommandsProps {\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n}\n\n/**\n * A component that generates the commands table display for a command.\n */\nexport function HelpCommands(props: HelpCommandsProps) {\n const { commands } = props;\n\n return (\n <>\n {code`table([ `}\n <hbr />\n <For each={Object.values(commands)} hardline>\n {child =>\n code`[{ value: colors.text.body.primary(\"${\n child.name\n }\"), align: \"right\", border: \"none\" }, { value: colors.text.body.tertiary(\"${child.description.replace(\n /\\.+$/,\n \"\"\n )}\"), align: \"left\", border: \"none\" }], `\n }\n </For>\n <hbr />\n {code` ]); `}\n </>\n );\n}\n\nexport interface BaseHelpProps {\n /**\n * The command to generate help for.\n */\n command: CommandTree;\n\n /**\n * Whether to filter out global options from the help display.\n *\n * @remarks\n * When enabled, any options that are present in the global options context will be filtered out from the help display. This is useful for sub-commands to avoid displaying global options that are not relevant to the specific command.\n *\n * @defaultValue false\n */\n filterGlobalOptions?: boolean;\n\n /**\n * The padding scale to apply to the help display headings.\n *\n * @remarks\n * This value is multiplied by the theme's app padding to determine the final padding.\n *\n * @defaultValue 1\n */\n indent?: number;\n}\n\n/**\n * A component that generates the `help` function declaration for a command.\n */\nexport function BaseHelp(props: BaseHelpProps) {\n const { command, indent = 1, filterGlobalOptions = false } = props;\n\n const theme = useTheme();\n const context = usePowerlines<ScriptPresetContext>();\n\n const options = computed(() =>\n filterGlobalOptions\n ? Object.values(command.options).filter(\n option =>\n !context.options.some(\n globalOption =>\n globalOption.name === option.name ||\n option.alias.includes(globalOption.name) ||\n globalOption.alias?.includes(option.name) ||\n globalOption.alias?.some(alias => option.alias.includes(alias))\n )\n )\n : Object.values(command.options)\n );\n\n return (\n <>\n {code`writeLine(colors.bold(colors.text.heading.secondary(\"Usage:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpUsage command={command} indent={indent} />\n <hbr />\n <hbr />\n <Show when={options.value.length > 0}>\n {code`writeLine(\"\");\n writeLine(colors.bold(colors.text.heading.secondary(\"Options:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpOptions options={options.value} />\n <hbr />\n <hbr />\n </Show>\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(\"\");\n writeLine(colors.bold(colors.text.heading.secondary(\"Commands:\"))${\n indent > 1 ? `, { padding: ${theme.padding.app * indent} }` : \"\"\n });`}\n <hbr />\n <HelpCommands commands={command.children} />\n <hbr />\n <hbr />\n </Show>\n </>\n );\n}\n\nexport interface VirtualHelpProps {\n /**\n * The options to display help for.\n */\n options: CommandOption[];\n\n /**\n * A mapping of command names to their command definitions.\n */\n commands: Record<string, CommandTree>;\n\n /**\n * The command path to generate help for, used for generating the help invocation instructions.\n *\n * @remarks\n * This is optional since the virtual command entry component can be used for both the global binary executable and virtual commands (there will be no command definition for the binary executable).\n */\n segments?: string[];\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function VirtualHelp(props: VirtualHelpProps) {\n const { options, segments, commands } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n <hbr />\n {code`writeLine(colors.bold(colors.text.heading.secondary(\"Global Options:\")));`}\n <hbr />\n <HelpOptions options={options} />\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <Show when={Object.keys(commands).length > 0}>\n {code`writeLine(colors.text.body.secondary(\"The following commands are available:\"));\n writeLine(\"\"); `}\n <hbr />\n <hbr />\n <For\n each={Object.values(commands)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n {code`\n writeLine(colors.text.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n writeLine(\"\");\n writeLine(colors.text.body.secondary(\"${child.description}\"));\n writeLine(\"\");\n `}\n <hbr />\n <BaseHelp command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n context\n )}${\n segments && segments.length > 0 ? ` ${segments.join(\" \")}` : \"\"\n } <specific command> --help') will provide additional information that is specific to that command.\");\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n\nexport interface CommandHelpProps {\n /**\n * A mapping of command names to their command definitions.\n */\n command: CommandTree;\n}\n\n/**\n * A component that generates the invocation of the `help` function for a command.\n */\nexport function CommandHelp(props: CommandHelpProps) {\n const { command } = props;\n\n const context = usePowerlines<ScriptPresetContext>();\n\n return (\n <>\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <BaseHelp command={command} filterGlobalOptions={false} />\n {code`writeLine(\"\"); `}\n <hbr />\n <hbr />\n <Show when={Object.keys(command.children).length > 0}>\n {code`writeLine(colors.text.body.secondary(\"The following sub-commands are available:\"));\n writeLine(\"\"); `}\n <hbr />\n <hbr />\n <For\n each={Object.values(command.children)}\n doubleHardline\n joiner={code`writeLine(\"\"); `}\n ender={code`writeLine(\"\"); `}>\n {child => (\n <>\n {code`\n writeLine(colors.text.heading.primary(${\n child.icon\n ? `(isUnicodeSupported ? \" ${child.icon} \" : \"\") + `\n : \"\"\n }\"${child.title} ${child.isVirtual ? \"\" : \"Command\"}\"));\n writeLine(\"\");\n writeLine(colors.text.body.secondary(\"${child.description}\"));\n writeLine(\"\");\n `}\n <hbr />\n <BaseHelp command={child} indent={2} filterGlobalOptions />\n <hbr />\n </>\n )}\n </For>\n {code`help(\"Running a specific command with the help flag (via: '${getAppBin(\n context\n )} ${command.segments.join(\n \" \"\n )} <specific command> --help') will provide additional information that is specific to that command.\");\n writeLine(\"\");`}\n </Show>\n </>\n );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAwDA,SAAgBa,UAAUC,OAAuB;CAC/C,MAAM,EAAEC,SAASC,SAAS,MAAMF;CAEhC,MAAMG,UAAUZ,eAAoC;CACpD,MAAMa,QAAQN,UAAU;AAExB,QAAA,CAAAO,gBAEKjB,KAAG;EAAA,IAACkB,OAAI;AAAA,UAAEC,OAAOC,KAAKL,QAAQM,OAAOC,IAAI;;EAAEC,UAAQ;EAAAC,WACjDF,QAAG,CAAAG,WAEC3B,IAAI;;oEAEmDwB,IAAG,KAC7DT,QAAQa,SAASC,SAAS,IACtB,IAAId,QAAQa,SACTE,KACCC,YACE,wBAAwBvB,qBAAqBuB,QAAQ,GAAG,YAAY,UAAS,IAC3EvB,qBAAqBuB,QAAQ,GACzB,IAAIpB,UAAUJ,0BAA0BwB,QAAQ,CAAC,CAAA,KACjDA,QAAO,KAEhB,CACAC,KAAK,IAAI,KACZ,KACHX,OAAOY,OAAOlB,QAAQW,SAAS,CAACG,SAAS,IAAI,gDAAgD,KAC9Fd,QAAQmB,UAAUL,SAAS,IACvB,IAAId,QAAQmB,UACTJ,KACCK,aACE,oCAAoCxB,UAAUwB,SAASC,KAAK,IACzDD,SAASE,SAASjC,eAAekC,UAChCH,SAASE,SAASjC,eAAemC,WACnCJ,SAASK,WACL,QACA,GAAE,MAEX,CACAR,KAAK,IAAI,KACZ,GAAE,6DACsDd,MAAMuB,QAAQC,MAAM1B,OAAM;UACvF,EAAA2B,gBAAA,OAAA,EAAA,CAAA,CAAA;EAGA,CAAA,EAAAxB,gBAEFhB,MAAI;EAAA,IAACyC,OAAI;AAAA,UAAE7B,QAAQmB,UAAUL,SAAS;;EAAC,IAAAH,WAAA;AAAA,UAAA,CAAAiB,gBAAA,OAAA,EAAA,CAAA,EAAAxB,gBAErCjB,KAAG;IAAA,IAACkB,OAAI;AAAA,YAAEC,OAAOC,KAAKL,QAAQM,OAAOC,IAAI;;IAAEC,UAAQ;IAAAC,WACjDF,QAAG,CAAAG,WAEC3B,IAAI;;oEAEiDwB,IAAG,KAC7DT,QAAQa,SAASC,SAAS,IACtB,IAAId,QAAQa,SACTE,KACCC,YACE,wBAAwBvB,qBAAqBuB,QAAQ,GAAG,YAAY,UAAS,IAC3EvB,qBAAqBuB,QAAQ,GACzB,IAAIpB,UAAUJ,0BAA0BwB,QAAQ,CAAC,CAAA,KACjDA,QAAO,KAEhB,CACAC,KAAK,IAAI,KACZ,KACHX,OAAOY,OAAOlB,QAAQW,SAAS,CAACG,SAAS,IAAI,gDAAgD,GAAE,6CAChGd,QAAQmB,UAAUL,SAAS,IACvB,IAAId,QAAQmB,UACTJ,KACCK,aACE,oCAAoCxB,UAAUwB,SAASC,KAAK,IACzDD,SAASE,SAASjC,eAAekC,UAChCH,SAASE,SAASjC,eAAemC,WACnCJ,SAASK,WACL,QACA,GAAE,MAEX,CACAR,KAAK,IAAI,KACZ,GAAE,kBACWd,MAAMuB,QAAQC,MAAM1B,OAAM;UAC5C,EAAA2B,gBAAA,OAAA,EAAA,CAAA,CAAA;IAGE,CAAA,CAAA;;EAAA,CAAA,CAAA;;;;;AAiBX,SAAgBE,YAAY/B,OAAyB;CACnD,MAAM,EAAEgC,YAAYhC;CAEpB,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAEKL,IAAI;EAAU2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEdjB,KAAG;GAAA,IAACkB,OAAI;AAAA,WAAEX,YAAYqC,QAAQ;;GAAErB,UAAQ;GAAAC,WACtCqB,WAAU;IACT,MAAMC,QAAQ,EAAc;IAC5B,MAAMC,QAAQ,EAAc;AAC5B,QAAIF,OAAOX,KAAKP,WAAW,EACzBmB,OAAME,KAAK,IAAIH,OAAOX,OAAO;QAE7Ba,OAAMC,KAAK,KAAKxC,UAAUqC,OAAOX,KAAK,GAAG;AAG3CW,WAAOI,MAAMC,SAASD,UAAkB;AACtC,SAAIA,MAAMtB,WAAW,EACnBmB,OAAME,KAAK,IAAIC,QAAQ;SAEvBF,OAAMC,KAAK,KAAKxC,UAAUyC,MAAM,GAAG;MAErC;AAEF,WAAOnD,IAAI,uCACTgD,MAAMnB,SAAS,IACX,GAAGmB,MAAMK,MAAM,CAACrB,KAAK,KAAK,GAAGiB,MAAMpB,SAAS,IAAI,OAAO,OACvD,KACHoB,MAAMpB,SAAS,IAAIoB,MAAMI,MAAM,CAACrB,KAAK,KAAK,GAAG,KAC9Ce,OAAOV,SAASjC,eAAekC,SAC3B,KAAK3B,UAAUoC,OAAOX,KAAK,GAAGW,OAAOP,WAAW,QAAQ,GAAE,KAC1DO,OAAOV,SAASjC,eAAemC,SAC7B,KAAK5B,UAAUoC,OAAOX,KAAK,GAAGW,OAAOP,WAAW,QAAQ,GAAE,KAC1D,GAAE,4EACmEO,OAAOO,YAAYC,QAC9F,QACA,GACD,CAAA,GACCR,OAAOS,OAAOT,OAAOU,YAAYC,SAC7B,IACEX,OAAOS,MACH,QAAQvC,QAAQM,OAAOoC,UAAS,GAAIZ,OAAOS,MACzCT,OAAOU,YAAYC,SAAY,OAAO,OAExC,KAEJX,OAAOU,YAAYC,SACf,YAAYE,KAAKC,UAAUd,OAAOU,QAAQ,KAC1C,GAAE,KAER,GAAE;;GAET,CAAA;EAAAd,gBAAA,OAAA,EAAA,CAAA;EAGF3C,IAAI;EAAO;;;;;AAelB,SAAgB8D,aAAahD,OAA0B;CACrD,MAAM,EAAEiD,aAAajD;AAErB,QAAA;EAEKd,IAAI;EAAU2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEdjB,KAAG;GAAA,IAACkB,OAAI;AAAA,WAAEC,OAAOY,OAAO8B,SAAS;;GAAEtC,UAAQ;GAAAC,WACzCsC,UACChE,IAAI,uCACFgE,MAAM5B,KAAI,4EACiE4B,MAAMV,YAAYC,QAC7F,QACA,GACD,CAAA;GAAwC,CAAA;EAAAZ,gBAAA,OAAA,EAAA,CAAA;EAI5C3C,IAAI;EAAO;;;;;AAmClB,SAAgBiE,SAASnD,OAAsB;CAC7C,MAAM,EAAEC,SAASC,SAAS,GAAGkD,sBAAsB,UAAUpD;CAE7D,MAAMI,QAAQN,UAAU;CACxB,MAAMK,UAAUZ,eAAoC;CAEpD,MAAMyC,UAAU7C,eACdiE,sBACI7C,OAAOY,OAAOlB,QAAQ+B,QAAQ,CAACqB,QAC7BpB,WACE,CAAC9B,QAAQ6B,QAAQsB,MACfC,iBACEA,aAAajC,SAASW,OAAOX,QAC7BW,OAAOI,MAAMmB,SAASD,aAAajC,KAAK,IACxCiC,aAAalB,OAAOmB,SAASvB,OAAOX,KAAK,IACzCiC,aAAalB,OAAOiB,MAAKjB,UAASJ,OAAOI,MAAMmB,SAASnB,MAAM,CAClE,CACJ,CAAC,GACD9B,OAAOY,OAAOlB,QAAQ+B,QAC5B,CAAC;AAED,QAAA;EAAAnB,WAEK3B,IAAI,iEACHgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;EAAA2B,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAEHN,WAAS;GAAUE;GAAiBC;GAAM,CAAA;EAAA2B,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAG1ChB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEE,QAAQyB,MAAM1C,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KAAAC,WACjC3B,IAAI;wEAELgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;KAAA2B,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAED0B,aAAW,EAAA,IAACC,UAAO;AAAA,aAAEA,QAAQyB;QAAK,CAAA;KAAA5B,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA;EAAAxB,gBAIpChB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKP,QAAQW,SAAS,CAACG,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KAAAC,WACjD3B,IAAI;yEAELgB,SAAS,IAAI,gBAAgBE,MAAMuB,QAAQC,MAAM1B,OAAM,MAAO,GAAE,IAC9D;KAAA2B,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAED2C,cAAY,EAAA,IAACC,WAAQ;AAAA,aAAEhD,QAAQW;QAAQ,CAAA;KAAAiB,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAA;;GAAA,CAAA;EAAA;;;;;AA+BhD,SAAgB6B,YAAY1D,OAAyB;CACnD,MAAM,EAAEgC,SAASlB,UAAUmC,aAAajD;CAExC,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAAAsC,gBAAA,OAAA,EAAA,CAAA;EAGK3C,IAAI;EAA2E2C,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAE/E0B,aAAW,EAAUC,SAAO,CAAA;EAC5B9C,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrBhB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKyC,SAAS,CAAClC,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KACzC1B,IAAI;;KACW2C,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAGfjB,KAAG;MAAA,IACFkB,OAAI;AAAA,cAAEC,OAAOY,OAAO8B,SAAS;;MAC7BU,gBAAc;MACdC,QAAQ1E,IAAI;MACZ2E,OAAO3E,IAAI;MAAiB0B,WAC3BsC,UAAK;OAAArC,WAED3B,IAAI;wDAEDgE,MAAMY,OACF,2BAA2BZ,MAAMY,KAAI,gBACrC,GAAE,GACJZ,MAAMa,MAAK,GAAIb,MAAMc,YAAY,KAAK,UAAS;;wDAEXd,MAAMV,YAAW;;kBAExD;OAAAX,gBAAA,OAAA,EAAA,CAAA;OAAAxB,gBAEF8C,UAAQ;QAAClD,SAASiD;QAAOhD,QAAQ;QAAGkD,qBAAmB;QAAA,CAAA;OAAAvB,gBAAA,OAAA,EAAA,CAAA;OAAA;MAG3D,CAAA;KAAAhB,WAEF3B,IAAI,8DAA8DM,UACjEW,QACD,GACCW,YAAYA,SAASC,SAAS,IAAI,IAAID,SAASI,KAAK,IAAI,KAAK,GAAE;wBAElD;KAAA;;GAAA,CAAA;EAAA;;;;;AAgBvB,SAAgB+C,YAAYjE,OAAyB;CACnD,MAAM,EAAEC,YAAYD;CAEpB,MAAMG,UAAUZ,eAAoC;AAEpD,QAAA;EAEKL,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrB8C,UAAQ;GAAUlD;GAASmD,qBAAqB;GAAK,CAAA;EACrDlE,IAAI;EAAiB2C,gBAAA,OAAA,EAAA,CAAA;EAAAA,gBAAA,OAAA,EAAA,CAAA;EAAAxB,gBAGrBhB,MAAI;GAAA,IAACyC,OAAI;AAAA,WAAEvB,OAAOC,KAAKP,QAAQW,SAAS,CAACG,SAAS;;GAAC,IAAAH,WAAA;AAAA,WAAA;KACjD1B,IAAI;;KACW2C,gBAAA,OAAA,EAAA,CAAA;KAAAA,gBAAA,OAAA,EAAA,CAAA;KAAAxB,gBAGfjB,KAAG;MAAA,IACFkB,OAAI;AAAA,cAAEC,OAAOY,OAAOlB,QAAQW,SAAS;;MACrC+C,gBAAc;MACdC,QAAQ1E,IAAI;MACZ2E,OAAO3E,IAAI;MAAiB0B,WAC3BsC,UAAK;OAAArC,WAED3B,IAAI;wDAEDgE,MAAMY,OACF,2BAA2BZ,MAAMY,KAAI,gBACrC,GAAE,GACJZ,MAAMa,MAAK,GAAIb,MAAMc,YAAY,KAAK,UAAS;;wDAEXd,MAAMV,YAAW;;kBAExD;OAAAX,gBAAA,OAAA,EAAA,CAAA;OAAAxB,gBAEF8C,UAAQ;QAAClD,SAASiD;QAAOhD,QAAQ;QAAGkD,qBAAmB;QAAA,CAAA;OAAAvB,gBAAA,OAAA,EAAA,CAAA;OAAA;MAG3D,CAAA;KAAAhB,WAEF3B,IAAI,8DAA8DM,UACjEW,QACD,CAAA,GAAIF,QAAQa,SAASI,KACpB,IACD,CAAA;wBACc;KAAA;;GAAA,CAAA;EAAA"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import * as
|
|
1
|
+
import * as _alloy_js_core0 from "@alloy-js/core";
|
|
2
2
|
|
|
3
3
|
//#region src/components/helpers.d.ts
|
|
4
4
|
|
|
@@ -8,22 +8,22 @@ import * as _alloy_js_core5 from "@alloy-js/core";
|
|
|
8
8
|
* @remarks
|
|
9
9
|
* This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
|
|
10
10
|
*/
|
|
11
|
-
declare function IsDebug():
|
|
11
|
+
declare function IsDebug(): _alloy_js_core0.Children;
|
|
12
12
|
/**
|
|
13
13
|
* Write the logic to determine if the application is **not** running in debug mode.
|
|
14
14
|
*/
|
|
15
|
-
declare function IsNotDebug():
|
|
15
|
+
declare function IsNotDebug(): _alloy_js_core0.Children;
|
|
16
16
|
/**
|
|
17
17
|
* Write the logic to determine if the application is running in verbose mode.
|
|
18
18
|
*
|
|
19
19
|
* @remarks
|
|
20
20
|
* This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
|
|
21
21
|
*/
|
|
22
|
-
declare function IsVerbose():
|
|
22
|
+
declare function IsVerbose(): _alloy_js_core0.Children;
|
|
23
23
|
/**
|
|
24
24
|
* Write the logic to determine if the application is **not** running in verbose mode.
|
|
25
25
|
*/
|
|
26
|
-
declare function IsNotVerbose():
|
|
26
|
+
declare function IsNotVerbose(): _alloy_js_core0.Children;
|
|
27
27
|
//#endregion
|
|
28
28
|
export { IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
|
|
29
29
|
//# sourceMappingURL=helpers.d.cts.map
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shell-shock/preset-script",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.3",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "A Shell Shock preset that generates a fully-featured script application.",
|
|
6
6
|
"repository": {
|
|
@@ -296,10 +296,10 @@
|
|
|
296
296
|
"@powerlines/deepkit": "^0.6.51",
|
|
297
297
|
"@powerlines/plugin-alloy": "^0.20.15",
|
|
298
298
|
"@powerlines/plugin-plugin": "^0.12.222",
|
|
299
|
-
"@shell-shock/core": "^0.8.
|
|
300
|
-
"@shell-shock/plugin-theme": "^0.0.
|
|
301
|
-
"@stryke/path": "
|
|
302
|
-
"@stryke/string-format": "^0.
|
|
299
|
+
"@shell-shock/core": "^0.8.4",
|
|
300
|
+
"@shell-shock/plugin-theme": "^0.0.21",
|
|
301
|
+
"@stryke/path": "0.26.6",
|
|
302
|
+
"@stryke/string-format": "^0.14.2",
|
|
303
303
|
"defu": "^6.1.4",
|
|
304
304
|
"powerlines": "^0.38.38",
|
|
305
305
|
"@stryke/helpers": "^0.9.42"
|
|
@@ -307,8 +307,8 @@
|
|
|
307
307
|
"devDependencies": {
|
|
308
308
|
"@babel/core": "^7.29.0",
|
|
309
309
|
"@powerlines/plugin-alloy": "^0.20.15",
|
|
310
|
-
"@types/node": "^22.19.
|
|
310
|
+
"@types/node": "^22.19.11"
|
|
311
311
|
},
|
|
312
312
|
"publishConfig": { "access": "public" },
|
|
313
|
-
"gitHead": "
|
|
313
|
+
"gitHead": "b748bcb948ef2c11eca8e4259c76afb65ce963f0"
|
|
314
314
|
}
|