@shell-shock/core 0.13.7 → 0.13.9

package/dist/resolver/resolve.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getGlobalOptions(context, command),\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of ctx.input.context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        ctx.input.command.segments.filter(\n          segment => !isDynamicPathSegment(segment)\n        ).length +\n          1 &&\n      input.segments\n        .slice(0, ctx.input.command.segments.length)\n        .every((value, index) => value === ctx.input.command.segments[index])\n  )) {\n    ctx.output.children[input.name] = await resolve<TContext>({\n      context: ctx.input.context,\n      command: input,\n      parent: ctx.output\n    });\n  }\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}
+{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getGlobalOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getGlobalOptions(context, command),\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx);\n  ctx.output.args = applyArgsDefaults(ctx);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((arg, index) => {\n    const found = ctx.output.args.findIndex(a => a.name === arg.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === arg.name\n      )\n    ) {\n      arg.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") === arg.name\n        ).length +\n        ctx.output.args.filter(a => a.name.replace(/_\\d+$/, \"\") === arg.name)\n          .length\n      }`;\n      arg.env = arg.name\n        ? arg.env || arg.env === false\n          ? arg.env\n          : ctx.input.context.config.autoAssignEnv\n            ? constantCase(arg.name)\n            : false\n        : false;\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => Boolean(option.env))\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => Boolean(arg.env))\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  await Promise.all(\n    ctx.input.context.inputs\n      .filter(\n        input =>\n          input.segments.filter(segment => !isDynamicPathSegment(segment))\n            .length ===\n            ctx.input.command.segments.filter(\n              segment => !isDynamicPathSegment(segment)\n            ).length +\n              1 &&\n          input.segments\n            .slice(0, ctx.input.command.segments.length)\n            .every(\n              (value, index) => value === ctx.input.command.segments[index]\n            )\n      )\n      .map(async input => {\n        ctx.output.children[input.name] = await resolve<TContext>({\n          context: ctx.input.context,\n          command: input,\n          parent: ctx.output\n        });\n      })\n  );\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}

package/dist/types/env.cjs

@@ -4,8 +4,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const __ΩShellShockEnv = [
 	"PATHEXT",
 	"PATH",
+	"npm_config_user_agent",
+	"npm_execpath",
+	"comspec",
 	"ShellShockEnv",
-	"P&4!8&4\"8Mw#y"
+	"P&4!8&4\"8&4#8&4$8&4%8Mw&y"
 ];
 
 //#endregion

package/dist/types/env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.cjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface ShellShockEnv {\n  /**\n   * The system PATHEXT variable, used to determine which file extensions are considered executable on Windows.\n   *\n   * @remarks\n   * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   */\n  PATH?: string;\n}\n"],"mappings":""}
+{"version":3,"file":"env.cjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface ShellShockEnv {\n  /**\n   * The system PATHEXT variable, used to determine which file extensions are considered executable on Windows.\n   *\n   * @remarks\n   * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.\n   *\n   * @internal\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   *\n   * @internal\n   */\n  PATH?: string;\n\n  /**\n   * The npm user agent string, which can be used to detect if the environment is running within an npm script.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It can be used to conditionally adjust behavior when running within an npm script context, such as modifying logging output or adjusting command execution. If this variable is not set, it can be assumed that the environment is not running within an npm script.\n   *\n   * @internal\n   */\n  npm_config_user_agent?: string;\n\n  /**\n   * The npm execution path, which can be used to determine the location of the npm executable.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It provides the absolute path to the npm executable being used to run the script. This can be useful for resolving the location of npm or for debugging purposes. If this variable is not set, it may indicate that the environment is not running within an npm script context, or that npm is not available in the PATH.\n   *\n   * @internal\n   */\n  npm_execpath?: string;\n\n  /**\n   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.\n   *\n   * @remarks\n   * This variable is used on Windows platforms to determine which command-line interpreter to use when executing commands. It typically points to cmd.exe, but can be customized by the user. If this variable is not set on Windows, it will default to 'cmd.exe'. On non-Windows platforms, this variable is ignored and has no effect on command execution.\n   *\n   * @internal\n   */\n  comspec?: string;\n}\n"],"mappings":""}

package/dist/types/env.d.cts

@@ -5,12 +5,43 @@ interface ShellShockEnv {
    *
    * @remarks
    * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.
+   *
+   * @internal
    */
   PATHEXT?: string;
   /**
    * The system PATH variable, used to locate executable files.
+   *
+   * @internal
    */
   PATH?: string;
+  /**
+   * The npm user agent string, which can be used to detect if the environment is running within an npm script.
+   *
+   * @remarks
+   * This variable is set by npm when running scripts defined in package.json. It can be used to conditionally adjust behavior when running within an npm script context, such as modifying logging output or adjusting command execution. If this variable is not set, it can be assumed that the environment is not running within an npm script.
+   *
+   * @internal
+   */
+  npm_config_user_agent?: string;
+  /**
+   * The npm execution path, which can be used to determine the location of the npm executable.
+   *
+   * @remarks
+   * This variable is set by npm when running scripts defined in package.json. It provides the absolute path to the npm executable being used to run the script. This can be useful for resolving the location of npm or for debugging purposes. If this variable is not set, it may indicate that the environment is not running within an npm script context, or that npm is not available in the PATH.
+   *
+   * @internal
+   */
+  npm_execpath?: string;
+  /**
+   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.
+   *
+   * @remarks
+   * This variable is used on Windows platforms to determine which command-line interpreter to use when executing commands. It typically points to cmd.exe, but can be customized by the user. If this variable is not set on Windows, it will default to 'cmd.exe'. On non-Windows platforms, this variable is ignored and has no effect on command execution.
+   *
+   * @internal
+   */
+  comspec?: string;
 }
 //#endregion
 export { ShellShockEnv };

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.cts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;EAOf,OAAA;;;;EAKA,IAAA;AAAA"}
+{"version":3,"file":"env.d.cts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;;;EASf,OAAA;EAqCO;;;;;EA9BP,IAAA;;;;;;;;;EAUA,qBAAA;;;;;;;;;EAUA,YAAA;;;;;;;;;EAUA,OAAA;AAAA"}

package/dist/types/env.d.mts

@@ -5,12 +5,43 @@ interface ShellShockEnv {
    *
    * @remarks
    * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.
+   *
+   * @internal
    */
   PATHEXT?: string;
   /**
    * The system PATH variable, used to locate executable files.
+   *
+   * @internal
    */
   PATH?: string;
+  /**
+   * The npm user agent string, which can be used to detect if the environment is running within an npm script.
+   *
+   * @remarks
+   * This variable is set by npm when running scripts defined in package.json. It can be used to conditionally adjust behavior when running within an npm script context, such as modifying logging output or adjusting command execution. If this variable is not set, it can be assumed that the environment is not running within an npm script.
+   *
+   * @internal
+   */
+  npm_config_user_agent?: string;
+  /**
+   * The npm execution path, which can be used to determine the location of the npm executable.
+   *
+   * @remarks
+   * This variable is set by npm when running scripts defined in package.json. It provides the absolute path to the npm executable being used to run the script. This can be useful for resolving the location of npm or for debugging purposes. If this variable is not set, it may indicate that the environment is not running within an npm script context, or that npm is not available in the PATH.
+   *
+   * @internal
+   */
+  npm_execpath?: string;
+  /**
+   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.
+   *
+   * @remarks
+   * This variable is used on Windows platforms to determine which command-line interpreter to use when executing commands. It typically points to cmd.exe, but can be customized by the user. If this variable is not set on Windows, it will default to 'cmd.exe'. On non-Windows platforms, this variable is ignored and has no effect on command execution.
+   *
+   * @internal
+   */
+  comspec?: string;
 }
 //#endregion
 export { ShellShockEnv };

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;EAOf,OAAA;;;;EAKA,IAAA;AAAA"}
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/types/env.ts"],"mappings":";UAkBiB,aAAA;EAAA;;;;;;;;EASf,OAAA;EAqCO;;;;;EA9BP,IAAA;;;;;;;;;EAUA,qBAAA;;;;;;;;;EAUA,YAAA;;;;;;;;;EAUA,OAAA;AAAA"}

package/dist/types/env.mjs

@@ -2,8 +2,11 @@
 const __ΩShellShockEnv = [
 	"PATHEXT",
 	"PATH",
+	"npm_config_user_agent",
+	"npm_execpath",
+	"comspec",
 	"ShellShockEnv",
-	"P&4!8&4\"8Mw#y"
+	"P&4!8&4\"8&4#8&4$8&4%8Mw&y"
 ];
 
 //#endregion

package/dist/types/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface ShellShockEnv {\n  /**\n   * The system PATHEXT variable, used to determine which file extensions are considered executable on Windows.\n   *\n   * @remarks\n   * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   */\n  PATH?: string;\n}\n"],"mappings":""}
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/types/env.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nexport interface ShellShockEnv {\n  /**\n   * The system PATHEXT variable, used to determine which file extensions are considered executable on Windows.\n   *\n   * @remarks\n   * If not provided, it will default to '.EXE;.CMD;.BAT;.COM' on Windows, and will be ignored on other platforms. This variable is used to locate executable files when running commands, and is only relevant on Windows platforms. On non-Windows platforms, the system's executable file resolution will be used, and this variable will have no effect.\n   *\n   * @internal\n   */\n  PATHEXT?: string;\n\n  /**\n   * The system PATH variable, used to locate executable files.\n   *\n   * @internal\n   */\n  PATH?: string;\n\n  /**\n   * The npm user agent string, which can be used to detect if the environment is running within an npm script.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It can be used to conditionally adjust behavior when running within an npm script context, such as modifying logging output or adjusting command execution. If this variable is not set, it can be assumed that the environment is not running within an npm script.\n   *\n   * @internal\n   */\n  npm_config_user_agent?: string;\n\n  /**\n   * The npm execution path, which can be used to determine the location of the npm executable.\n   *\n   * @remarks\n   * This variable is set by npm when running scripts defined in package.json. It provides the absolute path to the npm executable being used to run the script. This can be useful for resolving the location of npm or for debugging purposes. If this variable is not set, it may indicate that the environment is not running within an npm script context, or that npm is not available in the PATH.\n   *\n   * @internal\n   */\n  npm_execpath?: string;\n\n  /**\n   * The COMSPEC environment variable, which specifies the command-line interpreter to use on Windows.\n   *\n   * @remarks\n   * This variable is used on Windows platforms to determine which command-line interpreter to use when executing commands. It typically points to cmd.exe, but can be customized by the user. If this variable is not set on Windows, it will default to 'cmd.exe'. On non-Windows platforms, this variable is ignored and has no effect on command execution.\n   *\n   * @internal\n   */\n  comspec?: string;\n}\n"],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.13.7",
+  "version": "0.13.9",
   "private": false,
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "keywords": ["shell-shock", "powerlines", "storm-software"],
@@ -350,39 +350,39 @@
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/markdown": "0.23.0-dev.1",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.148",
-    "@powerlines/plugin-alloy": "^0.25.56",
-    "@powerlines/plugin-automd": "^0.1.369",
-    "@powerlines/plugin-deepkit": "^0.11.248",
-    "@powerlines/plugin-nodejs": "^0.1.292",
-    "@powerlines/plugin-tsdown": "^0.1.317",
+    "@powerlines/deepkit": "^0.6.160",
+    "@powerlines/plugin-alloy": "^0.25.68",
+    "@powerlines/plugin-automd": "^0.1.381",
+    "@powerlines/plugin-deepkit": "^0.11.260",
+    "@powerlines/plugin-nodejs": "^0.1.304",
+    "@powerlines/plugin-tsdown": "^0.1.323",
     "@standard-schema/spec": "^1.1.0",
     "@standard-schema/utils": "^0.3.0",
-    "@stryke/cli": "^0.13.35",
-    "@stryke/convert": "^0.6.56",
-    "@stryke/fs": "^0.33.63",
-    "@stryke/helpers": "^0.10.6",
-    "@stryke/json": "^0.14.10",
-    "@stryke/path": "^0.27.2",
-    "@stryke/string-format": "^0.17.6",
-    "@stryke/type-checks": "^0.5.41",
-    "@stryke/types": "^0.11.1",
-    "@stryke/zod": "^0.3.11",
+    "@stryke/cli": "^0.13.36",
+    "@stryke/convert": "^0.6.57",
+    "@stryke/fs": "^0.33.64",
+    "@stryke/helpers": "^0.10.7",
+    "@stryke/json": "^0.14.11",
+    "@stryke/path": "^0.27.3",
+    "@stryke/string-format": "^0.17.7",
+    "@stryke/type-checks": "^0.6.0",
+    "@stryke/types": "^0.11.2",
+    "@stryke/zod": "^0.3.12",
     "automd": "^0.4.3",
     "defu": "^6.1.4",
     "json-schema": "^0.4.0",
-    "tsdown": "^0.21.4"
+    "tsdown": "^0.21.5"
   },
   "devDependencies": {
-    "@powerlines/plugin-plugin": "^0.12.320",
+    "@powerlines/plugin-plugin": "^0.12.332",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.5.0",
-    "powerlines": "^0.42.10",
+    "powerlines": "^0.42.22",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
   "peerDependencies": { "powerlines": ">=0.42.10", "zod": "^3.25.0 || ^4.0.0" },
   "peerDependenciesMeta": { "zod": { "optional": true } },
   "publishConfig": { "access": "public" },
-  "gitHead": "bcec2ffe57f7284d7726461908827541dc907a23"
+  "gitHead": "036578a29fdeedf3a93c53a1ea4cf0a180b8f5bb"
 }

package/dist/_virtual/_rolldown/runtime.mjs

@@ -1,3 +0,0 @@
-import "node:module";
-
-export {  };