@shell-shock/core 0.13.1 → 0.13.3

package/dist/types/command.mjs

@@ -180,9 +180,10 @@ const __ΩCommandBase = [
 	"description",
 	"alias",
 	"icon",
+	"reference",
 	"isVirtual",
 	"CommandBase",
-	"PP&,J4!&4\"P&,J4#&F4$&4%8&4&8&F4'8&4(8)4)Mw*y"
+	"PP&,J4!&4\"P&,J4#&F4$&4%8&4&8&F4'8&4(8&4)8)4*Mw+y"
 ];
 const __ΩCommandConfig = [
 	() => __ΩCommandBase,
@@ -226,8 +227,9 @@ const __ΩCommandMetadata = [
 	"description",
 	"alias",
 	"icon",
+	"reference",
 	"CommandMetadata",
-	"P&4!8&4\"8P&&FJ4#8&4$8Mw%y"
+	"P&4!8&4\"8P&&FJ4#8&4$8&4%8Mw&y"
 ];
 const __ΩCommandModule = [
 	() => __ΩCommandMetadata,

package/dist/types/command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command.mjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The option description.\n   */\n  description: string;\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n}\n\nexport interface StringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n  /**\n   * The default value.\n   */\n  default?: string;\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface NumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n  /**\n   * The default value.\n   */\n  default?: number;\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface BooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n  /**\n   * The default value.\n   */\n  default?: boolean;\n}\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends BooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The command description.\n   */\n  description: string;\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,UAAU;CAAC;CAAG;OAAM;OAAiB;CAAA;CAAA;CAAA;;;;;;;AAE3C,MAAM,aAAS;CAAA;CAAS;CAAG;CAAY;CAA2B;AAClE,MAAI,0BAA4B,CAAC,wBAAqB,gBAAa;AAEnE,MAAK,wBAA0B;;CAE9B,QAAW;CACX,SAAY;CACZ;AACD,MAAC,0BAA+B;OAAG;OAAkB;CAAA;CAAA;CAAA;AAErD,MAAM,0BAAqB;CAAM;OAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,4BAA4B;OAAO;CAAyB;CAAI;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,4BAA4B;OAAO;CAAwB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEjE,MAAM,6BAA6B;OAAO;CAAW;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,sBAAQ;OAAA;OAA+C;OAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAI7D,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAEJ,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAIJ,MAAE,4BAAgB;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAElB,MAAE,0BAAiB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAInB,MAAG,yBAA4B;OAAO;OAA8B;CAAA;CAAA;CAAA;AAEpE,MAAM,qBAAW;OAAA;OAAqB;OAAA;CAAA;CAAA;CAAA;AAEtC,MAAK,2BAAe;OAAA;OAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEd,MAAK,mBAAe;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAE;OAAoB;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAE5B,MAAK,2BAAiB;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAE,qBAAa;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEf,MAAK,mBAAW;OAAW;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"command.mjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The option description.\n   */\n  description: string;\n\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n}\n\nexport interface StringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n\n  /**\n   * The default value.\n   */\n  default?: string;\n\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface NumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n\n  /**\n   * The default value.\n   */\n  default?: number;\n\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface BooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n\n  /**\n   * The default value.\n   */\n  default?: boolean;\n}\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends BooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   */\n  reference?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n\n  /**\n   * The command description.\n   */\n  description: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n\n  /**\n   * A URL to the command documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the command. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,UAAU;CAAC;CAAG;OAAM;OAAiB;CAAA;CAAA;CAAA;;;;;;;AAE3C,MAAM,aAAS;CAAA;CAAS;CAAG;CAAY;CAA2B;AAClE,MAAI,0BAA4B,CAAC,wBAAqB,gBAAa;AAEnE,MAAK,wBAA0B;;CAE9B,QAAW;CACX,SAAY;CACZ;AACD,MAAC,0BAA+B;OAAG;OAAkB;CAAA;CAAA;CAAA;AAErD,MAAM,0BAAqB;CAAM;OAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,4BAA4B;OAAO;CAAyB;CAAI;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,4BAA4B;OAAO;CAAwB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEjE,MAAM,6BAA6B;OAAO;CAAW;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,sBAAQ;OAAA;OAA+C;OAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAI7D,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAEJ,MAAI,kCAAA;OAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAIJ,MAAE,4BAAgB;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAElB,MAAE,0BAAiB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAInB,MAAG,yBAA4B;OAAO;OAA8B;CAAA;CAAA;CAAA;AAEpE,MAAM,qBAAW;OAAA;OAAqB;OAAA;CAAA;CAAA;CAAA;AAEtC,MAAK,2BAAe;OAAA;OAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEd,MAAI,mBAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEJ,MAAI,iBAAA;OAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;AAIJ,MAAK,qBAAiB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAE,mBAAa;OAAA;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/config.cjs

@@ -53,6 +53,12 @@ const __ΩBuildOptions = [
 	"BuildOptions",
 	"!P.\".#.$.%.&.'.(.).*.+.,Jo!#w-y"
 ];
+const __ΩReferenceOptions = [
+	"app",
+	"commands",
+	"ReferenceOptions",
+	"P&4!&4\"8Mw#y"
+];
 const __ΩBaseOptions = [
 	() => __ΩPartial,
 	() => __ΩBuildOptions,
@@ -63,14 +69,16 @@ const __ΩBaseOptions = [
 	"input",
 	"",
 	false,
-	"defaultOptions",
+	"globalOptions",
 	"isCaseSensitive",
 	true,
 	"bin",
 	true,
 	"autoAssignEnv",
+	() => __ΩReferenceOptions,
+	"reference",
 	"BaseOptions",
-	"Pn\"o!\"PP\"w#FP\"w$2%\"w&2'\"w#F/(.)J4*8)4+8>,P&&FJ4-8P..&J4/8MKw0y"
+	"Pn\"o!\"PP\"w#FP\"w$2%\"w&2'\"w#F/(.)J4*8)4+8>,P&&FJ4-8P..&J4/8Pn0&J418MKw2y"
 ];
 const __ΩOptions = [
 	() => __ΩBaseOptions,
@@ -80,8 +88,8 @@ const __ΩOptions = [
 ];
 const __ΩOutputConfig = [
 	() => __ΩPick,
-	"outputPath",
-	"assets",
+	"path",
+	"copy",
 	"storage",
 	false,
 	"dts",
@@ -101,18 +109,22 @@ const __ΩResolvedConfig = [
 	() => __ΩOmit,
 	() => __ΩOptions,
 	"bin",
+	"reference",
 	() => __ΩRecord,
 	"bin",
+	() => __ΩReferenceOptions,
+	"reference",
 	"appSpecificEnvPrefix",
 	() => __ΩUserConfig,
 	"userConfig",
 	"ResolvedConfig",
-	"P!!!n#.$o\"#o!\"P&&o%#4&&4'n(4)MKw*y"
+	"P!!!n#P.$.%Jo\"#o!\"P&&o&#4'n(4)&4*n+4,MKw-y"
 ];
 
 //#endregion
 exports.__ΩOptions = __ΩOptions;
 exports.__ΩOutputConfig = __ΩOutputConfig;
+exports.__ΩReferenceOptions = __ΩReferenceOptions;
 exports.__ΩResolvedConfig = __ΩResolvedConfig;
 exports.__ΩUserConfig = __ΩUserConfig;
 //# sourceMappingURL=config.cjs.map

package/dist/types/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?\n   *\n   * @remarks\n   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `\"configPath\"` and the `autoAssignEnv` is `\"MY_APP_\"`, Shell Shock will look for an environment variable named `\"MY_APP_CONFIG_PATH\"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  autoAssignEnv?: true | string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.\n     */\n    appSpecificEnvPrefix: string;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";;;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAA;CAAM;CAAW;CAAM;;;;;;;;;AAE3C,MAAM,YAAS;CAAA;CAAS;CAAG;CAAY;CAAqB;AAC5D,MAAI,aAAc;CAAA;CAAM;CAAA;CAAe;CAA4B;AACnE,MAAM,kBAAkB;OAAC;CAAa;CAAS;CAAA;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACnE,MAAK,iBAAkB;OAAO;OAAkB;CAAU;CAAoB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAG9E,MAAC,kBAAuB;OAAG;CAAQ;CAAiB;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;AAEnE,MAAC,gBAAqB;OAAK;OAAsB;OAAI;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"config.cjs","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\nexport interface ReferenceOptions {\n  /**\n   * A URL to the application documentation or reference.\n   */\n  app: string;\n\n  /**\n   * A URL to the application command specific documentation or reference.\n   *\n   * @remarks\n   * This URL is expected to contain the token `{command}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  commands?: string;\n}\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of global command options to apply to each command.\n   *\n   * @remarks\n   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock typegen` command and added to the generated `shell-shock.d.ts` file.\n   */\n  globalOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?\n   *\n   * @remarks\n   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `\"configPath\"` and the `autoAssignEnv` is `\"MY_APP_\"`, Shell Shock will look for an environment variable named `\"MY_APP_CONFIG_PATH\"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  autoAssignEnv?: true | string;\n\n  /**\n   * A URL to the application documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: ReferenceOptions | string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"path\" | \"copy\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\" | \"reference\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The URL(s) to the application documentation or reference.\n     */\n    reference: ReferenceOptions;\n\n    /**\n     * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.\n     */\n    appSpecificEnvPrefix: string;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";;;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAA;CAAM;CAAW;CAAM;;;;;;;;;AAE3C,MAAM,YAAS;CAAA;CAAS;CAAG;CAAY;CAAqB;AAC5D,MAAI,aAAc;CAAA;CAAM;CAAA;CAAe;CAA4B;AACnE,MAAM,kBAAkB;OAAC;CAAa;CAAS;CAAA;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACnE,MAAK,sBAAuB;CAAC;CAAE;CAAiB;CAAmB;CAAW;AAE9E,MAAC,iBAAsB;OAAI;OAAqB;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACjD,MAAC,aAAkB;OAAO;OAAoB;CAAc;CAAO;CAAA;AAEnE,MAAC,kBAAuB;OAAG;CAAQ;CAAa;CAAK;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,gBAAQ;OAAa;OAAS;OAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,oBAAoB;OAAO;OAAmB;OAAe;CAAG;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/config.d.cts

@@ -7,14 +7,27 @@ import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/
 
 //#region src/types/config.d.ts
 type BuildOptions = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+interface ReferenceOptions {
+  /**
+   * A URL to the application documentation or reference.
+   */
+  app: string;
+  /**
+   * A URL to the application command specific documentation or reference.
+   *
+   * @remarks
+   * This URL is expected to contain the token `{command}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.
+   */
+  commands?: string;
+}
 type BaseOptions = Partial<BuildOptions> & {
   /**
-   * A set of default command options to apply to each command.
+   * A set of global command options to apply to each command.
    *
    * @remarks
-   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock typegen` command and added to the generated `shell-shock.d.ts` file.
    */
-  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  globalOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
    * Determines whether commands and option names are treated as case-sensitive.
    *
@@ -42,6 +55,13 @@ type BaseOptions = Partial<BuildOptions> & {
    * @see https://stringcase.org/cases/constant/
    */
   autoAssignEnv?: true | string;
+  /**
+   * A URL to the application documentation or reference.
+   *
+   * @remarks
+   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.
+   */
+  reference?: ReferenceOptions | string;
 };
 /**
  * The plugin options for Shell Shock.
@@ -50,7 +70,7 @@ type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
-type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> & {
+type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
   /**
    * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
@@ -68,7 +88,7 @@ type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & {
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *
@@ -80,6 +100,10 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
    * @see https://pnpm.io/package_json#bin
    */
   bin: Record<string, string>;
+  /**
+   * The URL(s) to the application documentation or reference.
+   */
+  reference: ReferenceOptions;
   /**
    * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.
    */
@@ -90,5 +114,5 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
   userConfig: UserConfig;
 };
 //#endregion
-export { Options, OutputConfig, ResolvedConfig, UserConfig };
+export { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
 //# sourceMappingURL=config.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,KAcG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAftB;;;;;AACmB;EAqBtB,cAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;;;;;;EAQ/C,eAAA;EAR+C;;;;;;;;;;EAoB/C,GAAA;EApB+C;;;;;;AAqCjD;;;EANE,aAAA;AAAA;;;;KAMU,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;;;KAKhC,YAAA,GAAe,IAAA,CACzB,cAAA;EADU;;;EAOV,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA;EADE;;;EAKR,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EAdS;;;;;;;AAWzB;;;EAcI,GAAA,EAAK,MAAA;EAbP;;;EAkBE,oBAAA;EAhBF;;;EAqBE,UAAA,EAAY,UAAA;AAAA"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBsB;AAcxB;;;;;EAYE,QAAA;AAAA;AAAA,KAGG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAAA;;;;;;EAOzB,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAuCnB;;;;;EA/B5B,eAAA;EARe;;;;;;;;;;EAoBf,GAAA;EAmB4B;AAM9B;;;;;;;;EAdE,aAAA;EAckC;;;;AAKpC;;EAXE,SAAA,GAAY,gBAAA;AAAA;;;;KAMF,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;AAkB5C;;KAbY,YAAA,GAAe,IAAA,CACzB,cAAA;EAYuB;;;EANvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA;EAIN;;;EAAA,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EADd;;;;;;;;;;EAYE,GAAA,EAAK,MAAA;EAZP;;;EAiBE,SAAA,EAAW,gBAAA;EALX;;;EAUA,oBAAA;EAAA;;;EAKA,UAAA,EAAY,UAAA;AAAA"}

package/dist/types/config.d.mts

@@ -7,14 +7,27 @@ import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/
 
 //#region src/types/config.d.ts
 type BuildOptions = Pick<TsdownPluginUserConfig, "root" | "name" | "title" | "description" | "logLevel" | "mode" | "skipCache" | "autoInstall" | "plugins" | "tsconfig" | "tsconfigRaw">;
+interface ReferenceOptions {
+  /**
+   * A URL to the application documentation or reference.
+   */
+  app: string;
+  /**
+   * A URL to the application command specific documentation or reference.
+   *
+   * @remarks
+   * This URL is expected to contain the token `{command}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.
+   */
+  commands?: string;
+}
 type BaseOptions = Partial<BuildOptions> & {
   /**
-   * A set of default command options to apply to each command.
+   * A set of global command options to apply to each command.
    *
    * @remarks
-   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
+   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock typegen` command and added to the generated `shell-shock.d.ts` file.
    */
-  defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
+  globalOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
   /**
    * Determines whether commands and option names are treated as case-sensitive.
    *
@@ -42,6 +55,13 @@ type BaseOptions = Partial<BuildOptions> & {
    * @see https://stringcase.org/cases/constant/
    */
   autoAssignEnv?: true | string;
+  /**
+   * A URL to the application documentation or reference.
+   *
+   * @remarks
+   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.
+   */
+  reference?: ReferenceOptions | string;
 };
 /**
  * The plugin options for Shell Shock.
@@ -50,7 +70,7 @@ type Options = BaseOptions & Partial<NodeJsPluginOptions>;
 /**
  * The output configuration options for Shell Shock.
  */
-type OutputConfig = Pick<OutputConfig$1, "outputPath" | "assets" | "storage"> & {
+type OutputConfig = Pick<OutputConfig$1, "path" | "copy" | "storage"> & {
   /**
    * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.
    */
@@ -68,7 +88,7 @@ type UserConfig = BaseOptions & Partial<NodeJsPluginUserConfig> & {
 /**
  * The resolved configuration options for Shell Shock.
  */
-type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin">> & {
+type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "reference">> & {
   /**
    * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | "bin" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).
    *
@@ -80,6 +100,10 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
    * @see https://pnpm.io/package_json#bin
    */
   bin: Record<string, string>;
+  /**
+   * The URL(s) to the application documentation or reference.
+   */
+  reference: ReferenceOptions;
   /**
    * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.
    */
@@ -90,5 +114,5 @@ type ResolvedConfig = TsdownPluginResolvedConfig & AutoMDPluginResolvedConfig &
   userConfig: UserConfig;
 };
 //#endregion
-export { Options, OutputConfig, ResolvedConfig, UserConfig };
+export { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig };
 //# sourceMappingURL=config.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,KAcG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAftB;;;;;AACmB;EAqBtB,cAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;;;;;;EAQ/C,eAAA;EAR+C;;;;;;;;;;EAoB/C,GAAA;EApB+C;;;;;;AAqCjD;;;EANE,aAAA;AAAA;;;;KAMU,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;;;KAKhC,YAAA,GAAe,IAAA,CACzB,cAAA;EADU;;;EAOV,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA;EADE;;;EAKR,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EAdS;;;;;;;AAWzB;;;EAcI,GAAA,EAAK,MAAA;EAbP;;;EAkBE,oBAAA;EAhBF;;;EAqBE,UAAA,EAAY,UAAA;AAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;;;;KAgCK,YAAA,GAAe,IAAA,CAClB,sBAAA;AAAA,UAce,gBAAA;EAfZ;;;EAmBH,GAAA;EAlBsB;AAcxB;;;;;EAYE,QAAA;AAAA;AAAA,KAGG,WAAA,GAAc,OAAA,CAAQ,YAAA;EAAA;;;;;;EAOzB,aAAA,GACI,aAAA,OACE,OAAA,EAAS,OAAA,EAAS,KAAA,EAAO,WAAA,KAAgB,aAAA;EAuCnB;;;;;EA/B5B,eAAA;EARe;;;;;;;;;;EAoBf,GAAA;EAmB4B;AAM9B;;;;;;;;EAdE,aAAA;EAckC;;;;AAKpC;;EAXE,SAAA,GAAY,gBAAA;AAAA;;;;KAMF,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,mBAAA;;AAkB5C;;KAbY,YAAA,GAAe,IAAA,CACzB,cAAA;EAYuB;;;EANvB,GAAA;AAAA;;;;KAMU,UAAA,GAAa,WAAA,GACvB,OAAA,CAAQ,sBAAA;EAIN;;;EAAA,MAAA,GAAS,YAAA;AAAA;;;;KAMD,cAAA,GAAiB,0BAAA,GAC3B,0BAAA,GACA,0BAAA,GACA,QAAA,CAAS,IAAA,CAAK,OAAA;EADd;;;;;;;;;;EAYE,GAAA,EAAK,MAAA;EAZP;;;EAiBE,SAAA,EAAW,gBAAA;EALX;;;EAUA,oBAAA;EAAA;;;EAKA,UAAA,EAAY,UAAA;AAAA"}

package/dist/types/config.mjs

@@ -51,6 +51,12 @@ const __ΩBuildOptions = [
 	"BuildOptions",
 	"!P.\".#.$.%.&.'.(.).*.+.,Jo!#w-y"
 ];
+const __ΩReferenceOptions = [
+	"app",
+	"commands",
+	"ReferenceOptions",
+	"P&4!&4\"8Mw#y"
+];
 const __ΩBaseOptions = [
 	() => __ΩPartial,
 	() => __ΩBuildOptions,
@@ -61,14 +67,16 @@ const __ΩBaseOptions = [
 	"input",
 	"",
 	false,
-	"defaultOptions",
+	"globalOptions",
 	"isCaseSensitive",
 	true,
 	"bin",
 	true,
 	"autoAssignEnv",
+	() => __ΩReferenceOptions,
+	"reference",
 	"BaseOptions",
-	"Pn\"o!\"PP\"w#FP\"w$2%\"w&2'\"w#F/(.)J4*8)4+8>,P&&FJ4-8P..&J4/8MKw0y"
+	"Pn\"o!\"PP\"w#FP\"w$2%\"w&2'\"w#F/(.)J4*8)4+8>,P&&FJ4-8P..&J4/8Pn0&J418MKw2y"
 ];
 const __ΩOptions = [
 	() => __ΩBaseOptions,
@@ -78,8 +86,8 @@ const __ΩOptions = [
 ];
 const __ΩOutputConfig = [
 	() => __ΩPick,
-	"outputPath",
-	"assets",
+	"path",
+	"copy",
 	"storage",
 	false,
 	"dts",
@@ -99,15 +107,18 @@ const __ΩResolvedConfig = [
 	() => __ΩOmit,
 	() => __ΩOptions,
 	"bin",
+	"reference",
 	() => __ΩRecord,
 	"bin",
+	() => __ΩReferenceOptions,
+	"reference",
 	"appSpecificEnvPrefix",
 	() => __ΩUserConfig,
 	"userConfig",
 	"ResolvedConfig",
-	"P!!!n#.$o\"#o!\"P&&o%#4&&4'n(4)MKw*y"
+	"P!!!n#P.$.%Jo\"#o!\"P&&o&#4'n(4)&4*n+4,MKw-y"
 ];
 
 //#endregion
-export { __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩUserConfig };
+export { __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩUserConfig };
 //# sourceMappingURL=config.mjs.map

package/dist/types/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of default command options to apply to each command.\n   *\n   * @remarks\n   * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.\n   */\n  defaultOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?\n   *\n   * @remarks\n   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `\"configPath\"` and the `autoAssignEnv` is `\"MY_APP_\"`, Shell Shock will look for an environment variable named `\"MY_APP_CONFIG_PATH\"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  autoAssignEnv?: true | string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"outputPath\" | \"assets\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.\n     */\n    appSpecificEnvPrefix: string;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAA;CAAM;CAAW;CAAM;;;;;;;;;AAE3C,MAAM,YAAS;CAAA;CAAS;CAAG;CAAY;CAAqB;AAC5D,MAAI,aAAc;CAAA;CAAM;CAAA;CAAe;CAA4B;AACnE,MAAM,kBAAkB;OAAC;CAAa;CAAS;CAAA;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACnE,MAAK,iBAAkB;OAAO;OAAkB;CAAU;CAAoB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAG9E,MAAC,kBAAuB;OAAG;CAAQ;CAAiB;CAAS;CAAM;CAAA;CAAA;CAAA;CAAA;AAEnE,MAAC,gBAAqB;OAAK;OAAsB;OAAI;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,oBAAoB;OAAO;OAAG;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/types/config.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { AutoMDPluginResolvedConfig } from \"@powerlines/plugin-automd/types/plugin\";\nimport type {\n  NodeJsPluginOptions,\n  NodeJsPluginResolvedConfig,\n  NodeJsPluginUserConfig\n} from \"@powerlines/plugin-nodejs/types/plugin\";\nimport type {\n  TsdownPluginResolvedConfig,\n  TsdownPluginUserConfig\n} from \"@powerlines/plugin-tsdown/types/plugin\";\nimport type { OutputConfig as PowerlinesOutputConfig } from \"powerlines\";\nimport type { CommandBase, CommandOption } from \"./command\";\nimport type { Context } from \"./context\";\n\ntype BuildOptions = Pick<\n  TsdownPluginUserConfig,\n  | \"root\"\n  | \"name\"\n  | \"title\"\n  | \"description\"\n  | \"logLevel\"\n  | \"mode\"\n  | \"skipCache\"\n  | \"autoInstall\"\n  | \"plugins\"\n  | \"tsconfig\"\n  | \"tsconfigRaw\"\n>;\n\nexport interface ReferenceOptions {\n  /**\n   * A URL to the application documentation or reference.\n   */\n  app: string;\n\n  /**\n   * A URL to the application command specific documentation or reference.\n   *\n   * @remarks\n   * This URL is expected to contain the token `{command}`, which will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  commands?: string;\n}\n\ntype BaseOptions = Partial<BuildOptions> & {\n  /**\n   * A set of global command options to apply to each command.\n   *\n   * @remarks\n   * Each command will inherit these global options. To disable the addition of these global options, set this property to `false`, or provide a custom set of options/a function that returns them. A `GlobalOptions` interface will be created by the `shell-shock typegen` command and added to the generated `shell-shock.d.ts` file.\n   */\n  globalOptions?:\n    | CommandOption[]\n    | ((context: Context, input: CommandBase) => CommandOption[])\n    | false;\n\n  /**\n   * Determines whether commands and option names are treated as case-sensitive.\n   *\n   * @defaultValue `false`\n   */\n  isCaseSensitive?: boolean;\n\n  /**\n   * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n   *\n   * @remarks\n   * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n   *\n   * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n   * @see https://yarnpkg.com/cli/bin\n   * @see https://pnpm.io/package_json#bin\n   */\n  bin?: string | string[];\n\n  /**\n   * Should Shell Shock attempt to automatically assign environment variables to manipulate default values for command options based on the option name?\n   *\n   * @remarks\n   * If set to a string, Shell Shock will use the provided string as an application specific environment variable prefix, convert the option name to {@link https://stringcase.org/cases/constant/ | constant case}, and prepend the provided `string` value to determine the corresponding environment variable name. For example, if an option is named `\"configPath\"` and the `autoAssignEnv` is `\"MY_APP_\"`, Shell Shock will look for an environment variable named `\"MY_APP_CONFIG_PATH\"` and assign its value to the option if it exists. If set to `true`, Shell Shock will use a default environment variable prefix derived from the {@link Options.name | application name}.\n   *\n   * @see https://medium.com/chingu/an-introduction-to-environment-variables-and-how-to-use-them-f602f66d15fa\n   * @see https://stringcase.org/cases/constant/\n   */\n  autoAssignEnv?: true | string;\n\n  /**\n   * A URL to the application documentation or reference.\n   *\n   * @remarks\n   * This URL can be used in various displays of the user interface and documentation to provide users with a reference for the application. It can also be used by plugins to link to the documentation in relevant contexts. If the token `{command}` is included in the URL, it will be replaced with the full command path to provide links to command specific documentation. For example, `myapp command subcommand` will be translated to `{referenceLink}/command/subcommand`.\n   */\n  reference?: ReferenceOptions | string;\n};\n\n/**\n * The plugin options for Shell Shock.\n */\nexport type Options = BaseOptions & Partial<NodeJsPluginOptions>;\n\n/**\n * The output configuration options for Shell Shock.\n */\nexport type OutputConfig = Pick<\n  PowerlinesOutputConfig,\n  \"path\" | \"copy\" | \"storage\"\n> & {\n  /**\n   * An indicator specifying whether to generate TypeScript declaration files (.d.ts) during the build process.\n   */\n  dts?: false;\n};\n\n/**\n * The user configuration options for Shell Shock.\n */\nexport type UserConfig = BaseOptions &\n  Partial<NodeJsPluginUserConfig> & {\n    /**\n     * Configuration for the output of the build process\n     */\n    output?: OutputConfig;\n  };\n\n/**\n * The resolved configuration options for Shell Shock.\n */\nexport type ResolvedConfig = TsdownPluginResolvedConfig &\n  AutoMDPluginResolvedConfig &\n  NodeJsPluginResolvedConfig &\n  Required<Omit<Options, \"bin\" | \"reference\">> & {\n    /**\n     * The name of the binary (the {@link https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin | \"bin\" field} in package.json) that will be used to run the application through NodeJs package managers (e.g., npm, yarn, pnpm).\n     *\n     * @remarks\n     * If an array is provided, each binary will be linked to the same compiled output file. If not provided, the {@link Options.name | name} option will be used.\n     *\n     * @see https://docs.npmjs.com/cli/v11/configuring-npm/package-json#bin\n     * @see https://yarnpkg.com/cli/bin\n     * @see https://pnpm.io/package_json#bin\n     */\n    bin: Record<string, string>;\n\n    /**\n     * The URL(s) to the application documentation or reference.\n     */\n    reference: ReferenceOptions;\n\n    /**\n     * The command-line application specific environment variable prefix used for automatically assigning environment variables to command options.\n     */\n    appSpecificEnvPrefix: string;\n\n    /**\n     * The user configuration for the Shell Shock process.\n     */\n    userConfig: UserConfig;\n  };\n"],"mappings":";AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,cAAc;CAAA;CAAM;CAAW;CAAM;;;;;;;;;AAE3C,MAAM,YAAS;CAAA;CAAS;CAAG;CAAY;CAAqB;AAC5D,MAAI,aAAc;CAAA;CAAM;CAAA;CAAe;CAA4B;AACnE,MAAM,kBAAkB;OAAC;CAAa;CAAS;CAAA;CAAa;CAAO;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AACnE,MAAK,sBAAuB;CAAC;CAAE;CAAiB;CAAmB;CAAW;AAE9E,MAAC,iBAAsB;OAAI;OAAqB;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AACjD,MAAC,aAAkB;OAAO;OAAoB;CAAc;CAAO;CAAA;AAEnE,MAAC,kBAAuB;OAAG;CAAQ;CAAa;CAAK;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,gBAAQ;OAAa;OAAS;OAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,oBAAoB;OAAO;OAAmB;OAAe;CAAG;CAAA;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/types/index.cjs

@@ -31,6 +31,7 @@ exports.__ΩNumberCommandParameter = require_types_command.__ΩNumberCommandPara
 exports.__ΩNumberCommandParameterConfig = require_types_command.__ΩNumberCommandParameterConfig;
 exports.__ΩOptions = require_types_config.__ΩOptions;
 exports.__ΩOutputConfig = require_types_config.__ΩOutputConfig;
+exports.__ΩReferenceOptions = require_types_config.__ΩReferenceOptions;
 exports.__ΩResolvedConfig = require_types_config.__ΩResolvedConfig;
 exports.__ΩSerializedCommandTree = require_types_command.__ΩSerializedCommandTree;
 exports.__ΩStringCommandParameter = require_types_command.__ΩStringCommandParameter;

package/dist/types/index.d.cts

@@ -1,6 +1,6 @@
 import { AsCommandParameterConfig, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig } from "./command.cjs";
 import { Context, UnresolvedContext } from "./context.cjs";
-import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./config.cjs";
+import { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig } from "./config.cjs";
 import { BaseCommandOptions } from "./options.cjs";
 import { CommandContext } from "./runtime.cjs";
-export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig };
+export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ReferenceOptions, ResolvedConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig };

package/dist/types/index.d.mts

@@ -1,6 +1,6 @@
 import { AsCommandParameterConfig, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, NumberCommandParameter, NumberCommandParameterConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig } from "./command.mjs";
 import { Context, UnresolvedContext } from "./context.mjs";
-import { Options, OutputConfig, ResolvedConfig, UserConfig } from "./config.mjs";
+import { Options, OutputConfig, ReferenceOptions, ResolvedConfig, UserConfig } from "./config.mjs";
 import { BaseCommandOptions } from "./options.mjs";
 import { CommandContext } from "./runtime.mjs";
-export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ResolvedConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig };
+export { AsCommandParameterConfig, BaseCommandOptions, BaseCommandParameter, BooleanCommandOption, BooleanCommandParameter, BooleanCommandParameterConfig, CommandArgument, CommandArgumentConfig, CommandBase, CommandConfig, CommandContext, CommandMetadata, CommandModule, CommandOption, CommandOptionConfig, CommandParameter, CommandParameterConfig, CommandParameterKind, CommandParameterKinds, CommandParameterType, CommandTree, Context, NumberCommandParameter, NumberCommandParameterConfig, Options, OutputConfig, ReferenceOptions, ResolvedConfig, SerializedCommandTree, StringCommandParameter, StringCommandParameterConfig, UnresolvedContext, UserConfig };

package/dist/types/index.mjs

@@ -1,7 +1,7 @@
 import { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig } from "./command.mjs";
-import { __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩUserConfig } from "./config.mjs";
+import { __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩUserConfig } from "./config.mjs";
 import { __ΩContext, __ΩUnresolvedContext } from "./context.mjs";
 import { __ΩBaseCommandOptions } from "./options.mjs";
 import { __ΩCommandContext } from "./runtime.mjs";
 
-export { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandContext, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig };
+export { CommandParameterKinds, __ΩAsCommandParameterConfig, __ΩBaseCommandOptions, __ΩBaseCommandParameter, __ΩBooleanCommandOption, __ΩBooleanCommandParameter, __ΩBooleanCommandParameterConfig, __ΩCommandArgument, __ΩCommandArgumentConfig, __ΩCommandBase, __ΩCommandConfig, __ΩCommandContext, __ΩCommandMetadata, __ΩCommandModule, __ΩCommandOption, __ΩCommandOptionConfig, __ΩCommandParameter, __ΩCommandParameterConfig, __ΩCommandParameterKind, __ΩCommandParameterType, __ΩCommandTree, __ΩContext, __ΩNumberCommandParameter, __ΩNumberCommandParameterConfig, __ΩOptions, __ΩOutputConfig, __ΩReferenceOptions, __ΩResolvedConfig, __ΩSerializedCommandTree, __ΩStringCommandParameter, __ΩStringCommandParameterConfig, __ΩUnresolvedContext, __ΩUserConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.13.1",
+  "version": "0.13.3",
   "type": "module",
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "repository": {
@@ -352,12 +352,12 @@
     "@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.134",
-    "@powerlines/plugin-alloy": "^0.25.41",
-    "@powerlines/plugin-automd": "^0.1.355",
-    "@powerlines/plugin-deepkit": "^0.11.234",
-    "@powerlines/plugin-nodejs": "^0.1.277",
-    "@powerlines/plugin-tsdown": "^0.1.303",
+    "@powerlines/deepkit": "^0.6.147",
+    "@powerlines/plugin-alloy": "^0.25.54",
+    "@powerlines/plugin-automd": "^0.1.368",
+    "@powerlines/plugin-deepkit": "^0.11.247",
+    "@powerlines/plugin-nodejs": "^0.1.290",
+    "@powerlines/plugin-tsdown": "^0.1.316",
     "@standard-schema/spec": "^1.1.0",
     "@standard-schema/utils": "^0.3.0",
     "@stryke/cli": "^0.13.35",
@@ -373,16 +373,16 @@
     "automd": "^0.4.3",
     "defu": "^6.1.4",
     "json-schema": "^0.4.0",
-    "powerlines": "^0.41.20",
+    "powerlines": "^0.42.9",
     "tsdown": "^0.21.4"
   },
   "devDependencies": {
-    "@powerlines/plugin-plugin": "^0.12.306",
+    "@powerlines/plugin-plugin": "^0.12.319",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.5.0",
     "typescript": "^5.9.3",
     "zod": "^4.3.6"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "86c55189ed02d126fb583cf6d2555266f00d0f3a"
+  "gitHead": "86ac1c51d3258bded9e493024e6631d241f62dd2"
 }