zod-args-parser 2.0.0-beta.0 → 2.0.0-beta.2

package/lib/mjs/parse/validation/validators/explicitly-passed.mjs

@@ -1,2 +1,18 @@
-function isArgumentExplicitlyPassed(i,t){return!!t.arguments&&(i in t.arguments&&"default"!==t.arguments[i].source)}function isOptionExplicitlyPassed(i,t){return!!t.options&&(i in t.options&&"default"!==t.options[i].source)}function isOptionOrArgumentExplicitlyPassed(i,t){return isOptionExplicitlyPassed(i,t)||isArgumentExplicitlyPassed(i,t)}export{isArgumentExplicitlyPassed,isOptionExplicitlyPassed,isOptionOrArgumentExplicitlyPassed};
-//# sourceMappingURL=explicitly-passed.mjs.map
+// src/parse/validation/validators/explicitly-passed.ts
+function isArgumentExplicitlyPassed(name, context) {
+  if (!context.arguments) return false;
+  return name in context.arguments && context.arguments[name].source !== "default";
+}
+function isOptionExplicitlyPassed(name, context) {
+  if (!context.options) return false;
+  return name in context.options && context.options[name].source !== "default";
+}
+function isOptionOrArgumentExplicitlyPassed(name, context) {
+  return isOptionExplicitlyPassed(name, context) || isArgumentExplicitlyPassed(name, context);
+}
+export {
+  isArgumentExplicitlyPassed,
+  isOptionExplicitlyPassed,
+  isOptionOrArgumentExplicitlyPassed
+};
+//# sourceMappingURL=explicitly-passed.mjs.map

package/lib/mjs/parse/validation/validators/explicitly-passed.mjs.map

@@ -1 +1,7 @@
-{"version":3,"names":["isArgumentExplicitlyPassed","name","context","arguments","source","isOptionExplicitlyPassed","options","isOptionOrArgumentExplicitlyPassed"],"sources":["../../../../../src/parse/validation/validators/explicitly-passed.ts"],"sourcesContent":["import type { ContextWide } from \"../../../types/context-types.ts\";\n\nexport function isArgumentExplicitlyPassed(name: string, context: ContextWide) {\n  if (!context.arguments) return false;\n  return name in context.arguments && context.arguments[name].source !== \"default\";\n}\n\nexport function isOptionExplicitlyPassed(name: string, context: ContextWide) {\n  if (!context.options) return false;\n  return name in context.options && context.options[name].source !== \"default\";\n}\n\nexport function isOptionOrArgumentExplicitlyPassed(name: string, context: ContextWide) {\n  return isOptionExplicitlyPassed(name, context) || isArgumentExplicitlyPassed(name, context);\n}\n"],"mappings":"AAEO,SAASA,2BAA2BC,EAAcC,GACvD,QAAKA,EAAQC,YACNF,KAAQC,EAAQC,WAAgD,YAAnCD,EAAQC,UAAUF,GAAMG,OAC9D,CAEO,SAASC,yBAAyBJ,EAAcC,GACrD,QAAKA,EAAQI,UACNL,KAAQC,EAAQI,SAA4C,YAAjCJ,EAAQI,QAAQL,GAAMG,OAC1D,CAEO,SAASG,mCAAmCN,EAAcC,GAC/D,OAAOG,yBAAyBJ,EAAMC,IAAYF,2BAA2BC,EAAMC,EACrF,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../../../src/parse/validation/validators/explicitly-passed.ts"],
+  "sourcesContent": ["import type { ContextWide } from \"../../../types/context-types.ts\";\n\nexport function isArgumentExplicitlyPassed(name: string, context: ContextWide) {\n  if (!context.arguments) return false;\n  return name in context.arguments && context.arguments[name].source !== \"default\";\n}\n\nexport function isOptionExplicitlyPassed(name: string, context: ContextWide) {\n  if (!context.options) return false;\n  return name in context.options && context.options[name].source !== \"default\";\n}\n\nexport function isOptionOrArgumentExplicitlyPassed(name: string, context: ContextWide) {\n  return isOptionExplicitlyPassed(name, context) || isArgumentExplicitlyPassed(name, context);\n}\n"],
+  "mappings": ";AAEO,SAAS,2BAA2B,MAAc,SAAsB;AAC7E,MAAI,CAAC,QAAQ,UAAW,QAAO;AAC/B,SAAO,QAAQ,QAAQ,aAAa,QAAQ,UAAU,IAAI,EAAE,WAAW;AACzE;AAEO,SAAS,yBAAyB,MAAc,SAAsB;AAC3E,MAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,SAAO,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,IAAI,EAAE,WAAW;AACrE;AAEO,SAAS,mCAAmC,MAAc,SAAsB;AACrF,SAAO,yBAAyB,MAAM,OAAO,KAAK,2BAA2B,MAAM,OAAO;AAC5F;",
+  "names": []
+}

package/lib/mjs/parse/validation/validators/options.mjs

@@ -1,2 +1,67 @@
-import{validateSync}from"../../../utilities.mjs";import{validateConflictWith}from"./conflict.mjs";import{validateExclusive}from"./exclusive.mjs";import{validateRequires}from"./requires.mjs";function validateOptions({commandDefinition:o,context:t,output:e}){if(!t.options)return;e.options??(e.options={});const i=o.options;if(!i)throw new Error(`subcommand "${t.subcommand}" does not have options`);for(const[e,n]of Object.entries(i))validateRequires({name:e,commandDefinition:o,optionOrArgument:n,context:t,type:"option"}),validateExclusive({name:e,optionOrArgument:n,context:t,type:"option"}),validateConflictWith({name:e,optionOrArgument:n,context:t,type:"option"});const n=Object.entries(t.options);for(const[o,{passedValue:r,stringValue:a,flag:s,source:p,schema:m}]of n){const n=i[o];if(!n)throw new Error(`subcommand "${t.subcommand}" does not have option "${o}"`);if(!n._preparedType)throw new Error(`internal error: missing prepared type for option "${o}"`);const c="programmatic"===p,l=c?validateSync(m,r):n._preparedType.validate(a);if(l.issues)throw new Error(`invalid value ${c?"":`"${a}"`} for "${c?o:s}": ${l.issues.map(o=>o.message).join(", ")}`);e.options[o]=l.value}}export{validateOptions};
-//# sourceMappingURL=options.mjs.map
+// src/parse/validation/validators/options.ts
+import { CliError } from "../../../cli-error/cli-error.mjs";
+import { ErrorCause } from "../../../cli-error/error-cause.mjs";
+import { InternalErrorCode } from "../../../cli-error/error-code/internal-error-code.mjs";
+import { ValidationErrorCode } from "../../../cli-error/error-code/validation-error-code.mjs";
+import { validateSync } from "../../../utilities/schema-utilities.mjs";
+import { validateConflictWith } from "./conflict.mjs";
+import { validateExclusive } from "./exclusive.mjs";
+import { validateRequires } from "./requires.mjs";
+function validateOptions({ commandDefinition, context, output }) {
+  if (!context.options) return;
+  output.options ??= {};
+  const commandKind = "cliName" in commandDefinition ? "command" : "subcommand";
+  const commandName = "cliName" in commandDefinition ? commandDefinition.cliName : commandDefinition.name;
+  const optionsDefinition = commandDefinition.options;
+  if (!optionsDefinition) {
+    throw new CliError({
+      cause: ErrorCause.Validation,
+      code: ValidationErrorCode.NoOptionsToValidate,
+      context: { commandKind, commandName }
+    });
+  }
+  for (const [optionName, option] of Object.entries(optionsDefinition)) {
+    validateRequires({ name: optionName, commandDefinition, optionOrArgument: option, context, kind: "option" });
+    validateExclusive({ name: optionName, optionOrArgument: option, context, kind: "option" });
+    validateConflictWith({ name: optionName, optionOrArgument: option, context, kind: "option" });
+  }
+  const optionContextEntries = Object.entries(context.options);
+  for (const [optionName, { passedValue, stringValue, source, schema }] of optionContextEntries) {
+    const option = optionsDefinition[optionName];
+    if (!option) {
+      throw new CliError({
+        cause: ErrorCause.Validation,
+        code: ValidationErrorCode.UnknownOptionValidation,
+        context: { commandKind, commandName, optionName }
+      });
+    }
+    if (!option._preparedType) {
+      throw new CliError({
+        cause: ErrorCause.Internal,
+        code: InternalErrorCode.MissingPreparedTypes,
+        context: { commandKind, commandName, kind: "option", name: optionName }
+      });
+    }
+    const isProgrammatic = source === "programmatic";
+    const safeParseResult = isProgrammatic ? validateSync(schema, passedValue) : option._preparedType.validate(stringValue);
+    if (safeParseResult.issues) {
+      throw new CliError({
+        cause: ErrorCause.Validation,
+        code: ValidationErrorCode.SchemaValidationFailed,
+        context: {
+          commandKind,
+          commandName,
+          kind: "option",
+          name: optionName,
+          inputValue: isProgrammatic ? passedValue : stringValue,
+          issues: safeParseResult.issues
+        }
+      });
+    }
+    output.options[optionName] = safeParseResult.value;
+  }
+}
+export {
+  validateOptions
+};
+//# sourceMappingURL=options.mjs.map

package/lib/mjs/parse/validation/validators/options.mjs.map

@@ -1 +1,7 @@
-{"version":3,"names":["validateSync","validateConflictWith","validateExclusive","validateRequires","validateOptions","commandDefinition","context","output","options","optionsDefinition","Error","subcommand","optionName","option","Object","entries","name","optionOrArgument","type","optionContextEntries","passedValue","stringValue","flag","source","schema","_preparedType","isProgrammatic","safeParseResult","validate","issues","map","issue","message","join","value"],"sources":["../../../../../src/parse/validation/validators/options.ts"],"sourcesContent":["import { validateSync } from \"../../../utilities.ts\";\nimport { validateConflictWith } from \"./conflict.ts\";\nimport { validateExclusive } from \"./exclusive.ts\";\nimport { validateRequires } from \"./requires.ts\";\n\nimport type { ContextWide } from \"../../../types/context-types.ts\";\nimport type { Cli, Subcommand } from \"../../../types/definitions-types.ts\";\nimport type { OutputTypeWide } from \"../../../types/io-types.ts\";\n\ninterface ValidateOptions {\n  commandDefinition: Subcommand | Cli;\n  context: ContextWide;\n  output: OutputTypeWide;\n}\n\n/** @throws {Error} */\nexport function validateOptions({ commandDefinition, context, output }: ValidateOptions) {\n  if (!context.options) return;\n\n  output.options ??= {};\n\n  const optionsDefinition = commandDefinition.options;\n  if (!optionsDefinition) {\n    throw new Error(`subcommand \"${context.subcommand}\" does not have options`);\n  }\n\n  for (const [optionName, option] of Object.entries(optionsDefinition)) {\n    validateRequires({ name: optionName, commandDefinition, optionOrArgument: option, context, type: \"option\" });\n    validateExclusive({ name: optionName, optionOrArgument: option, context, type: \"option\" });\n    validateConflictWith({ name: optionName, optionOrArgument: option, context, type: \"option\" });\n  }\n\n  const optionContextEntries = Object.entries(context.options);\n\n  for (const [optionName, { passedValue, stringValue, flag, source, schema }] of optionContextEntries) {\n    const option = optionsDefinition[optionName];\n    if (!option) {\n      throw new Error(`subcommand \"${context.subcommand}\" does not have option \"${optionName}\"`);\n    }\n\n    if (!option._preparedType) {\n      throw new Error(`internal error: missing prepared type for option \"${optionName}\"`);\n    }\n\n    const isProgrammatic = source === \"programmatic\";\n\n    const safeParseResult = isProgrammatic\n      ? validateSync(schema, passedValue)\n      : option._preparedType.validate(stringValue);\n\n    if (safeParseResult.issues) {\n      throw new Error(\n        `invalid value ${isProgrammatic ? \"\" : `\"${stringValue}\"`} for \"${isProgrammatic ? optionName : flag}\": ${safeParseResult.issues.map(issue => issue.message).join(\", \")}`,\n      );\n    }\n\n    output.options[optionName] = safeParseResult.value;\n  }\n}\n"],"mappings":"OAASA,iBAAoB,gCACpBC,yBAA4B,wBAC5BC,sBAAyB,yBACzBC,qBAAwB,iBAa1B,SAASC,iBAAgBC,kBAAEA,EAAAC,QAAmBA,EAAAC,OAASA,IAC5D,IAAKD,EAAQE,QAAS,OAEtBD,EAAOC,UAAPD,EAAOC,QAAY,CAAC,GAEpB,MAAMC,EAAoBJ,EAAkBG,QAC5C,IAAKC,EACH,MAAM,IAAIC,MAAM,eAAeJ,EAAQK,qCAGzC,UAAYC,EAAYC,KAAWC,OAAOC,QAAQN,GAChDN,iBAAiB,CAAEa,KAAMJ,EAAYP,oBAAmBY,iBAAkBJ,EAAQP,UAASY,KAAM,WACjGhB,kBAAkB,CAAEc,KAAMJ,EAAYK,iBAAkBJ,EAAQP,UAASY,KAAM,WAC/EjB,qBAAqB,CAAEe,KAAMJ,EAAYK,iBAAkBJ,EAAQP,UAASY,KAAM,WAGpF,MAAMC,EAAuBL,OAAOC,QAAQT,EAAQE,SAEpD,UAAYI,GAAYQ,YAAEA,EAAAC,YAAaA,EAAAC,KAAaA,EAAAC,OAAMA,EAAAC,OAAQA,MAAaL,EAAsB,CACnG,MAAMN,EAASJ,EAAkBG,GACjC,IAAKC,EACH,MAAM,IAAIH,MAAM,eAAeJ,EAAQK,qCAAqCC,MAG9E,IAAKC,EAAOY,cACV,MAAM,IAAIf,MAAM,qDAAqDE,MAGvE,MAAMc,EAA4B,iBAAXH,EAEjBI,EAAkBD,EACpB1B,aAAawB,EAAQJ,GACrBP,EAAOY,cAAcG,SAASP,GAElC,GAAIM,EAAgBE,OAClB,MAAM,IAAInB,MACR,iBAAiBgB,EAAiB,GAAK,IAAIL,aAAuBK,EAAiBd,EAAaU,OAAUK,EAAgBE,OAAOC,IAAIC,GAASA,EAAMC,SAASC,KAAK,SAItK1B,EAAOC,QAAQI,GAAce,EAAgBO,KAC/C,CACF,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../../../src/parse/validation/validators/options.ts"],
+  "sourcesContent": ["import { CliError } from \"../../../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../../../cli-error/error-cause.ts\";\nimport { InternalErrorCode } from \"../../../cli-error/error-code/internal-error-code.ts\";\nimport { ValidationErrorCode } from \"../../../cli-error/error-code/validation-error-code.ts\";\nimport { validateSync } from \"../../../utilities/schema-utilities.ts\";\nimport { validateConflictWith } from \"./conflict.ts\";\nimport { validateExclusive } from \"./exclusive.ts\";\nimport { validateRequires } from \"./requires.ts\";\n\nimport type { ContextWide } from \"../../../types/context-types.ts\";\nimport type { Cli, Subcommand } from \"../../../types/definitions-types.ts\";\nimport type { OutputTypeWide } from \"../../../types/io-types.ts\";\n\ninterface ValidateOptions {\n  commandDefinition: Subcommand | Cli;\n  context: ContextWide;\n  output: OutputTypeWide;\n}\n\n/** @throws {CliError} */\nexport function validateOptions({ commandDefinition, context, output }: ValidateOptions) {\n  if (!context.options) return;\n\n  output.options ??= {};\n\n  const commandKind = \"cliName\" in commandDefinition ? \"command\" : \"subcommand\";\n  const commandName = \"cliName\" in commandDefinition ? commandDefinition.cliName : commandDefinition.name;\n\n  const optionsDefinition = commandDefinition.options;\n  if (!optionsDefinition) {\n    throw new CliError({\n      cause: ErrorCause.Validation,\n      code: ValidationErrorCode.NoOptionsToValidate,\n      context: { commandKind, commandName },\n    });\n  }\n\n  for (const [optionName, option] of Object.entries(optionsDefinition)) {\n    validateRequires({ name: optionName, commandDefinition, optionOrArgument: option, context, kind: \"option\" });\n    validateExclusive({ name: optionName, optionOrArgument: option, context, kind: \"option\" });\n    validateConflictWith({ name: optionName, optionOrArgument: option, context, kind: \"option\" });\n  }\n\n  const optionContextEntries = Object.entries(context.options);\n\n  for (const [optionName, { passedValue, stringValue, source, schema }] of optionContextEntries) {\n    const option = optionsDefinition[optionName];\n    if (!option) {\n      throw new CliError({\n        cause: ErrorCause.Validation,\n        code: ValidationErrorCode.UnknownOptionValidation,\n        context: { commandKind, commandName, optionName },\n      });\n    }\n\n    if (!option._preparedType) {\n      throw new CliError({\n        cause: ErrorCause.Internal,\n        code: InternalErrorCode.MissingPreparedTypes,\n        context: { commandKind, commandName, kind: \"option\", name: optionName },\n      });\n    }\n\n    const isProgrammatic = source === \"programmatic\";\n\n    const safeParseResult = isProgrammatic\n      ? validateSync(schema, passedValue)\n      : option._preparedType.validate(stringValue);\n\n    if (safeParseResult.issues) {\n      throw new CliError({\n        cause: ErrorCause.Validation,\n        code: ValidationErrorCode.SchemaValidationFailed,\n        context: {\n          commandKind,\n          commandName,\n          kind: \"option\",\n          name: optionName,\n          inputValue: isProgrammatic ? passedValue : stringValue,\n          issues: safeParseResult.issues,\n        },\n      });\n    }\n\n    output.options[optionName] = safeParseResult.value;\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,oBAAoB;AAC7B,SAAS,4BAA4B;AACrC,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAa1B,SAAS,gBAAgB,EAAE,mBAAmB,SAAS,OAAO,GAAoB;AACvF,MAAI,CAAC,QAAQ,QAAS;AAEtB,SAAO,YAAY,CAAC;AAEpB,QAAM,cAAc,aAAa,oBAAoB,YAAY;AACjE,QAAM,cAAc,aAAa,oBAAoB,kBAAkB,UAAU,kBAAkB;AAEnG,QAAM,oBAAoB,kBAAkB;AAC5C,MAAI,CAAC,mBAAmB;AACtB,UAAM,IAAI,SAAS;AAAA,MACjB,OAAO,WAAW;AAAA,MAClB,MAAM,oBAAoB;AAAA,MAC1B,SAAS,EAAE,aAAa,YAAY;AAAA,IACtC,CAAC;AAAA,EACH;AAEA,aAAW,CAAC,YAAY,MAAM,KAAK,OAAO,QAAQ,iBAAiB,GAAG;AACpE,qBAAiB,EAAE,MAAM,YAAY,mBAAmB,kBAAkB,QAAQ,SAAS,MAAM,SAAS,CAAC;AAC3G,sBAAkB,EAAE,MAAM,YAAY,kBAAkB,QAAQ,SAAS,MAAM,SAAS,CAAC;AACzF,yBAAqB,EAAE,MAAM,YAAY,kBAAkB,QAAQ,SAAS,MAAM,SAAS,CAAC;AAAA,EAC9F;AAEA,QAAM,uBAAuB,OAAO,QAAQ,QAAQ,OAAO;AAE3D,aAAW,CAAC,YAAY,EAAE,aAAa,aAAa,QAAQ,OAAO,CAAC,KAAK,sBAAsB;AAC7F,UAAM,SAAS,kBAAkB,UAAU;AAC3C,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,oBAAoB;AAAA,QAC1B,SAAS,EAAE,aAAa,aAAa,WAAW;AAAA,MAClD,CAAC;AAAA,IACH;AAEA,QAAI,CAAC,OAAO,eAAe;AACzB,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,kBAAkB;AAAA,QACxB,SAAS,EAAE,aAAa,aAAa,MAAM,UAAU,MAAM,WAAW;AAAA,MACxE,CAAC;AAAA,IACH;AAEA,UAAM,iBAAiB,WAAW;AAElC,UAAM,kBAAkB,iBACpB,aAAa,QAAQ,WAAW,IAChC,OAAO,cAAc,SAAS,WAAW;AAE7C,QAAI,gBAAgB,QAAQ;AAC1B,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,oBAAoB;AAAA,QAC1B,SAAS;AAAA,UACP;AAAA,UACA;AAAA,UACA,MAAM;AAAA,UACN,MAAM;AAAA,UACN,YAAY,iBAAiB,cAAc;AAAA,UAC3C,QAAQ,gBAAgB;AAAA,QAC1B;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO,QAAQ,UAAU,IAAI,gBAAgB;AAAA,EAC/C;AACF;",
+  "names": []
+}

package/lib/mjs/parse/validation/validators/requires.mjs

@@ -1,2 +1,43 @@
-import{isArgumentExplicitlyPassed,isOptionExplicitlyPassed,isOptionOrArgumentExplicitlyPassed}from"./explicitly-passed.mjs";function validateRequires({name:t,commandDefinition:i,optionOrArgument:n,context:e,type:s}){const o=n.requires;if(!o||0===o.length)return;if(!isOptionOrArgumentExplicitlyPassed(t,e))return;const r=i.options??{},p=[],l=[];for(const t of o){const i=t in r;(i?isOptionExplicitlyPassed(t,e):isArgumentExplicitlyPassed(t,e))||(i?p.push(t):l.push(t))}if(0===p.length&&0===l.length)return;const u=[];if(p.length>0){const t=p.map(t=>`"${t}"`).join(", "),i=p.length>1?"s":"";u.push(`option${i} ${t}`)}if(l.length>0){const t=l.map(t=>`"${t}"`).join(", "),i=l.length>1?"s":"";u.push(`argument${i} ${t}`)}const c=u.join(" and ");throw new Error(`${s} "${t}" cannot be used without the required ${c}.`)}export{validateRequires};
-//# sourceMappingURL=requires.mjs.map
+// src/parse/validation/validators/requires.ts
+import { CliError } from "../../../cli-error/cli-error.mjs";
+import { ErrorCause } from "../../../cli-error/error-cause.mjs";
+import { ValidationErrorCode } from "../../../cli-error/error-code/validation-error-code.mjs";
+import {
+  isArgumentExplicitlyPassed,
+  isOptionExplicitlyPassed,
+  isOptionOrArgumentExplicitlyPassed
+} from "./explicitly-passed.mjs";
+function validateRequires({
+  name,
+  commandDefinition,
+  optionOrArgument,
+  context,
+  kind
+}) {
+  const requires = optionOrArgument.requires;
+  if (!requires || requires.length === 0) return;
+  if (!isOptionOrArgumentExplicitlyPassed(name, context)) return;
+  const optionsDefinition = commandDefinition.options ?? {};
+  const missingOptions = [];
+  const missingArguments = [];
+  for (const requiredName of requires) {
+    const isOption = requiredName in optionsDefinition;
+    const provided = isOption ? isOptionExplicitlyPassed(requiredName, context) : isArgumentExplicitlyPassed(requiredName, context);
+    if (provided) continue;
+    if (isOption) {
+      missingOptions.push(requiredName);
+      continue;
+    }
+    missingArguments.push(requiredName);
+  }
+  if (missingOptions.length === 0 && missingArguments.length === 0) return;
+  throw new CliError({
+    cause: ErrorCause.Validation,
+    code: ValidationErrorCode.RequiredDependencyMissing,
+    context: { kind, name, missingArguments, missingOptions }
+  });
+}
+export {
+  validateRequires
+};
+//# sourceMappingURL=requires.mjs.map

package/lib/mjs/parse/validation/validators/requires.mjs.map

@@ -1 +1,7 @@
-{"version":3,"names":["isArgumentExplicitlyPassed","isOptionExplicitlyPassed","isOptionOrArgumentExplicitlyPassed","validateRequires","name","commandDefinition","optionOrArgument","context","type","requires","length","optionsDefinition","options","missingOptions","missingArguments","requiredName","isOption","push","parts","formatted","map","o","join","s","a","joinedParts","Error"],"sources":["../../../../../src/parse/validation/validators/requires.ts"],"sourcesContent":["import {\n  isArgumentExplicitlyPassed,\n  isOptionExplicitlyPassed,\n  isOptionOrArgumentExplicitlyPassed,\n} from \"./explicitly-passed.ts\";\n\nimport type { ContextWide } from \"../../../types/context-types.ts\";\nimport type { Argument, Cli, Option, Subcommand } from \"../../../types/definitions-types.ts\";\n\ninterface ValidateRequiresOptions {\n  /** The option or argument name to check its `requires` */\n  name: string;\n\n  /** The subcommand or cli configuration */\n  commandDefinition: Subcommand | Cli;\n\n  /** The option or argument to check */\n  optionOrArgument: Option | Argument;\n\n  /** The parsed context */\n  context: ContextWide;\n\n  /** What we're checking */\n  type: \"option\" | \"argument\";\n}\n\n/** @throws {Error} */\nexport function validateRequires({\n  name,\n  commandDefinition,\n  optionOrArgument,\n  context,\n  type,\n}: ValidateRequiresOptions) {\n  const requires = optionOrArgument.requires;\n  if (!requires || requires.length === 0) return;\n\n  // Check if the options/argument is passed\n  if (!isOptionOrArgumentExplicitlyPassed(name, context)) return;\n\n  const optionsDefinition = commandDefinition.options ?? {};\n\n  const missingOptions: string[] = [];\n  const missingArguments: string[] = [];\n\n  for (const requiredName of requires) {\n    const isOption = requiredName in optionsDefinition;\n\n    const provided = isOption\n      ? isOptionExplicitlyPassed(requiredName, context)\n      : isArgumentExplicitlyPassed(requiredName, context);\n\n    if (provided) continue;\n\n    if (isOption) {\n      missingOptions.push(requiredName);\n      continue;\n    }\n\n    missingArguments.push(requiredName);\n  }\n\n  if (missingOptions.length === 0 && missingArguments.length === 0) return; // OK\n\n  const parts: string[] = [];\n\n  if (missingOptions.length > 0) {\n    const formatted = missingOptions.map(o => `\"${o}\"`).join(\", \");\n    const s = missingOptions.length > 1 ? \"s\" : \"\";\n    parts.push(`option${s} ${formatted}`);\n  }\n\n  if (missingArguments.length > 0) {\n    const formatted = missingArguments.map(a => `\"${a}\"`).join(\", \");\n    const s = missingArguments.length > 1 ? \"s\" : \"\";\n    parts.push(`argument${s} ${formatted}`);\n  }\n\n  const joinedParts = parts.join(\" and \");\n\n  throw new Error(`${type} \"${name}\" cannot be used without the required ${joinedParts}.`);\n}\n"],"mappings":"OACEA,2BACAC,yBACAC,uCACK,0BAuBA,SAASC,kBAAiBC,KAC/BA,EAAAC,kBACAA,EAAAC,iBACAA,EAAAC,QACAA,EAAAC,KACAA,IAEA,MAAMC,EAAWH,EAAiBG,SAClC,IAAKA,GAAgC,IAApBA,EAASC,OAAc,OAGxC,IAAKR,mCAAmCE,EAAMG,GAAU,OAExD,MAAMI,EAAoBN,EAAkBO,SAAW,CAAC,EAElDC,EAA2B,GAC3BC,EAA6B,GAEnC,UAAWC,KAAgBN,EAAU,CACnC,MAAMO,EAAWD,KAAgBJ,GAEhBK,EACbf,yBAAyBc,EAAcR,GACvCP,2BAA2Be,EAAcR,MAIzCS,EACFH,EAAeI,KAAKF,GAItBD,EAAiBG,KAAKF,GACxB,CAEA,GAA8B,IAA1BF,EAAeH,QAA4C,IAA5BI,EAAiBJ,OAAc,OAElE,MAAMQ,EAAkB,GAExB,GAAIL,EAAeH,OAAS,EAAG,CAC7B,MAAMS,EAAYN,EAAeO,IAAIC,GAAK,IAAIA,MAAMC,KAAK,MACnDC,EAAIV,EAAeH,OAAS,EAAI,IAAM,GAC5CQ,EAAMD,KAAK,SAASM,KAAKJ,IAC3B,CAEA,GAAIL,EAAiBJ,OAAS,EAAG,CAC/B,MAAMS,EAAYL,EAAiBM,IAAII,GAAK,IAAIA,MAAMF,KAAK,MACrDC,EAAIT,EAAiBJ,OAAS,EAAI,IAAM,GAC9CQ,EAAMD,KAAK,WAAWM,KAAKJ,IAC7B,CAEA,MAAMM,EAAcP,EAAMI,KAAK,SAE/B,MAAM,IAAII,MAAM,GAAGlB,MAASJ,0CAA6CqB,KAC3E,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../../../src/parse/validation/validators/requires.ts"],
+  "sourcesContent": ["import { CliError } from \"../../../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../../../cli-error/error-cause.ts\";\nimport { ValidationErrorCode } from \"../../../cli-error/error-code/validation-error-code.ts\";\nimport {\n  isArgumentExplicitlyPassed,\n  isOptionExplicitlyPassed,\n  isOptionOrArgumentExplicitlyPassed,\n} from \"./explicitly-passed.ts\";\n\nimport type { ContextWide } from \"../../../types/context-types.ts\";\nimport type { Argument, Cli, Option, Subcommand } from \"../../../types/definitions-types.ts\";\n\ninterface ValidateRequiresOptions {\n  /** The option or argument name to check its `requires` */\n  name: string;\n\n  /** The subcommand or cli configuration */\n  commandDefinition: Subcommand | Cli;\n\n  /** The option or argument to check */\n  optionOrArgument: Option | Argument;\n\n  /** The parsed context */\n  context: ContextWide;\n\n  /** What we're checking */\n  kind: \"option\" | \"argument\";\n}\n\n/** @throws {CliError} */\nexport function validateRequires({\n  name,\n  commandDefinition,\n  optionOrArgument,\n  context,\n  kind,\n}: ValidateRequiresOptions) {\n  const requires = optionOrArgument.requires;\n  if (!requires || requires.length === 0) return;\n\n  // Check if the options/argument is passed\n  if (!isOptionOrArgumentExplicitlyPassed(name, context)) return;\n\n  const optionsDefinition = commandDefinition.options ?? {};\n\n  const missingOptions: string[] = [];\n  const missingArguments: string[] = [];\n\n  for (const requiredName of requires) {\n    const isOption = requiredName in optionsDefinition;\n\n    const provided = isOption\n      ? isOptionExplicitlyPassed(requiredName, context)\n      : isArgumentExplicitlyPassed(requiredName, context);\n\n    if (provided) continue;\n\n    if (isOption) {\n      missingOptions.push(requiredName);\n      continue;\n    }\n\n    missingArguments.push(requiredName);\n  }\n\n  if (missingOptions.length === 0 && missingArguments.length === 0) return; // OK\n\n  throw new CliError({\n    cause: ErrorCause.Validation,\n    code: ValidationErrorCode.RequiredDependencyMissing,\n    context: { kind, name, missingArguments, missingOptions },\n  });\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,2BAA2B;AACpC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAuBA,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA4B;AAC1B,QAAM,WAAW,iBAAiB;AAClC,MAAI,CAAC,YAAY,SAAS,WAAW,EAAG;AAGxC,MAAI,CAAC,mCAAmC,MAAM,OAAO,EAAG;AAExD,QAAM,oBAAoB,kBAAkB,WAAW,CAAC;AAExD,QAAM,iBAA2B,CAAC;AAClC,QAAM,mBAA6B,CAAC;AAEpC,aAAW,gBAAgB,UAAU;AACnC,UAAM,WAAW,gBAAgB;AAEjC,UAAM,WAAW,WACb,yBAAyB,cAAc,OAAO,IAC9C,2BAA2B,cAAc,OAAO;AAEpD,QAAI,SAAU;AAEd,QAAI,UAAU;AACZ,qBAAe,KAAK,YAAY;AAChC;AAAA,IACF;AAEA,qBAAiB,KAAK,YAAY;AAAA,EACpC;AAEA,MAAI,eAAe,WAAW,KAAK,iBAAiB,WAAW,EAAG;AAElE,QAAM,IAAI,SAAS;AAAA,IACjB,OAAO,WAAW;AAAA,IAClB,MAAM,oBAAoB;AAAA,IAC1B,SAAS,EAAE,MAAM,MAAM,kBAAkB,eAAe;AAAA,EAC1D,CAAC;AACH;",
+  "names": []
+}

package/lib/mjs/utilities/parse-argv.mjs

@@ -0,0 +1,61 @@
+// src/utilities/parse-argv.ts
+function parseArgv(input) {
+  const argv = [];
+  let currentQuote = void 0;
+  let currentArgument = void 0;
+  for (let index = 0; index < input.length; index++) {
+    const char = input[index];
+    const previousChar = input[index - 1];
+    const nextChar = input[index + 1];
+    const end = index === input.length - 1;
+    if ((char === '"' || char === "'") && previousChar !== "\\") {
+      if (currentQuote === char) {
+        currentQuote = void 0;
+        continue;
+      }
+      if (currentQuote === void 0) {
+        currentQuote = char;
+        continue;
+      }
+      if (currentQuote !== void 0 && char !== currentQuote) {
+        currentArgument ??= "";
+        currentArgument += char;
+        continue;
+      }
+      continue;
+    }
+    if (char === "\\" && nextChar === "\n") {
+      index++;
+      continue;
+    }
+    if (currentArgument !== void 0 && currentQuote === void 0) {
+      if (char === " ") {
+        argv.push(currentArgument);
+        currentArgument = void 0;
+        continue;
+      }
+      if (end) {
+        currentArgument += char;
+        argv.push(currentArgument);
+        currentArgument = void 0;
+        continue;
+      }
+    }
+    if (char === " " && currentQuote === void 0) {
+      continue;
+    }
+    if (char === "\\" && (nextChar === "'" || nextChar === '"')) {
+      continue;
+    }
+    currentArgument ??= "";
+    currentArgument += char;
+  }
+  if (currentArgument !== void 0) {
+    argv.push(currentArgument);
+  }
+  return argv;
+}
+export {
+  parseArgv
+};
+//# sourceMappingURL=parse-argv.mjs.map

package/lib/mjs/utilities/parse-argv.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utilities/parse-argv.ts"],
+  "sourcesContent": ["/** Parse a string into an argv (array of arguments) */\nexport function parseArgv(input: string): string[] {\n  const argv = [];\n\n  let currentQuote: string | undefined = undefined;\n  let currentArgument: string | undefined = undefined;\n\n  for (let index = 0; index < input.length; index++) {\n    const char = input[index];\n    const previousChar = input[index - 1];\n    const nextChar = input[index + 1];\n    const end = index === input.length - 1;\n\n    // entering/leaving quote\n    if ((char === '\"' || char === \"'\") && previousChar !== \"\\\\\") {\n      // leaving quote\n      if (currentQuote === char) {\n        currentQuote = undefined;\n        continue;\n      }\n\n      // entering quote\n      if (currentQuote === undefined) {\n        currentQuote = char;\n        continue;\n      }\n\n      // quote inside quote\n      if (currentQuote !== undefined && char !== currentQuote) {\n        currentArgument ??= \"\";\n        currentArgument += char;\n        continue;\n      }\n      continue;\n    }\n\n    // new line\n    if (char === \"\\\\\" && nextChar === \"\\n\") {\n      index++;\n      continue;\n    }\n\n    // Add to argv\n    if (currentArgument !== undefined && currentQuote === undefined) {\n      if (char === \" \") {\n        argv.push(currentArgument);\n        currentArgument = undefined;\n        continue;\n      }\n\n      if (end) {\n        currentArgument += char;\n        argv.push(currentArgument);\n        currentArgument = undefined;\n        continue;\n      }\n    }\n\n    // Ignore spaces outside of quotes\n    if (char === \" \" && currentQuote === undefined) {\n      continue;\n    }\n\n    // Ignore escaped characters\n    if (char === \"\\\\\" && (nextChar === \"'\" || nextChar === '\"')) {\n      continue;\n    }\n\n    currentArgument ??= \"\";\n    currentArgument += char;\n  }\n\n  // Add last argument\n  if (currentArgument !== undefined) {\n    argv.push(currentArgument);\n  }\n\n  return argv;\n}\n"],
+  "mappings": ";AACO,SAAS,UAAU,OAAyB;AACjD,QAAM,OAAO,CAAC;AAEd,MAAI,eAAmC;AACvC,MAAI,kBAAsC;AAE1C,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;AACjD,UAAM,OAAO,MAAM,KAAK;AACxB,UAAM,eAAe,MAAM,QAAQ,CAAC;AACpC,UAAM,WAAW,MAAM,QAAQ,CAAC;AAChC,UAAM,MAAM,UAAU,MAAM,SAAS;AAGrC,SAAK,SAAS,OAAO,SAAS,QAAQ,iBAAiB,MAAM;AAE3D,UAAI,iBAAiB,MAAM;AACzB,uBAAe;AACf;AAAA,MACF;AAGA,UAAI,iBAAiB,QAAW;AAC9B,uBAAe;AACf;AAAA,MACF;AAGA,UAAI,iBAAiB,UAAa,SAAS,cAAc;AACvD,4BAAoB;AACpB,2BAAmB;AACnB;AAAA,MACF;AACA;AAAA,IACF;AAGA,QAAI,SAAS,QAAQ,aAAa,MAAM;AACtC;AACA;AAAA,IACF;AAGA,QAAI,oBAAoB,UAAa,iBAAiB,QAAW;AAC/D,UAAI,SAAS,KAAK;AAChB,aAAK,KAAK,eAAe;AACzB,0BAAkB;AAClB;AAAA,MACF;AAEA,UAAI,KAAK;AACP,2BAAmB;AACnB,aAAK,KAAK,eAAe;AACzB,0BAAkB;AAClB;AAAA,MACF;AAAA,IACF;AAGA,QAAI,SAAS,OAAO,iBAAiB,QAAW;AAC9C;AAAA,IACF;AAGA,QAAI,SAAS,SAAS,aAAa,OAAO,aAAa,MAAM;AAC3D;AAAA,IACF;AAEA,wBAAoB;AACpB,uBAAmB;AAAA,EACrB;AAGA,MAAI,oBAAoB,QAAW;AACjC,SAAK,KAAK,eAAe;AAAA,EAC3B;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/mjs/utilities/schema-utilities.mjs

@@ -0,0 +1,57 @@
+// src/utilities/schema-utilities.ts
+import { CliError } from "../cli-error/cli-error.mjs";
+import { ErrorCause } from "../cli-error/error-cause.mjs";
+import { ValidationErrorCode } from "../cli-error/error-code/validation-error-code.mjs";
+function validateSync(schema, value) {
+  const results = schema["~standard"].validate(value);
+  if (results instanceof Promise) {
+    throw new CliError({
+      cause: ErrorCause.Validation,
+      code: ValidationErrorCode.AsyncSchemaNotSupported,
+      context: { schema, value }
+    });
+  }
+  return results;
+}
+function defaultValueAndIsOptional(schema) {
+  const results = validateSync(schema);
+  if (results.issues) {
+    return { defaultValue: void 0, optional: false };
+  }
+  return { defaultValue: results.value, optional: true };
+}
+function PrepareType(schema, coerceHandler) {
+  const { optional, defaultValue } = defaultValueAndIsOptional(schema);
+  return {
+    schema,
+    optional,
+    defaultValue,
+    coerceTo: coerceHandler.type,
+    validate: (value) => validateSync(schema, value && coerceHandler(value))
+  };
+}
+function prepareDefinitionTypes(definition) {
+  if (!definition) return;
+  for (const object of Object.values(definition)) {
+    if (!object.coerce) {
+      object.coerce = (value) => value;
+    }
+    if (!object._preparedType) {
+      object._preparedType = PrepareType(object.schema, object.coerce);
+    }
+  }
+}
+function prettifyError(issues) {
+  return issues.map((issue) => {
+    const path = issue.path?.map((seg) => typeof seg === "object" && "key" in seg ? seg.key : seg);
+    const pathString = path && path.length > 0 ? ` at "${path.join(".")}"` : "";
+    return `${issue.message}${pathString}`;
+  }).join(" : ");
+}
+export {
+  defaultValueAndIsOptional,
+  prepareDefinitionTypes,
+  prettifyError,
+  validateSync
+};
+//# sourceMappingURL=schema-utilities.mjs.map

package/lib/mjs/utilities/schema-utilities.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utilities/schema-utilities.ts"],
+  "sourcesContent": ["import { CliError } from \"../cli-error/cli-error.ts\";\nimport { ErrorCause } from \"../cli-error/error-cause.ts\";\nimport { ValidationErrorCode } from \"../cli-error/error-code/validation-error-code.ts\";\n\nimport type { Argument, Option, PreparedType } from \"../types/definitions-types.ts\";\nimport type { SchemaResult, SchemaType } from \"../types/schema-types.ts\";\nimport type { CoerceMethod } from \"../types/types.ts\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/** @throws {CliError} When schema is async */\nexport function validateSync(schema: SchemaType, value?: unknown): SchemaResult {\n  const results = schema[\"~standard\"].validate(value);\n  if (results instanceof Promise) {\n    throw new CliError({\n      cause: ErrorCause.Validation,\n      code: ValidationErrorCode.AsyncSchemaNotSupported,\n      context: { schema, value },\n    });\n  }\n\n  return results;\n}\n\n/** @throws {CliError} When schema is async */\nexport function defaultValueAndIsOptional(schema: SchemaType): { defaultValue: unknown; optional: boolean } {\n  const results = validateSync(schema);\n\n  if (results.issues) {\n    return { defaultValue: undefined, optional: false };\n  }\n\n  return { defaultValue: results.value, optional: true };\n}\n\n/** @throws {CliError} When schema is async */\nfunction PrepareType(schema: SchemaType, coerceHandler: CoerceMethod<unknown>): PreparedType {\n  const { optional, defaultValue } = defaultValueAndIsOptional(schema);\n\n  return {\n    schema,\n    optional,\n    defaultValue,\n    coerceTo: coerceHandler.type,\n    validate: (value?: string) => validateSync(schema, value && coerceHandler(value)),\n  };\n}\n\n/** @throws {CliError} When schema is async */\nexport function prepareDefinitionTypes(definition: Record<string, Argument> | Record<string, Option> | undefined) {\n  if (!definition) return;\n\n  for (const object of Object.values<Argument | Option>(definition)) {\n    if (!object.coerce) {\n      (object.coerce as CoerceMethod<string> | undefined) = (value: string) => value;\n    }\n\n    if (!object._preparedType) {\n      object._preparedType = PrepareType(object.schema, object.coerce!);\n    }\n  }\n}\n\n/** Prettify Standard Schema V1 issues */\nexport function prettifyError(issues: ReadonlyArray<StandardSchemaV1.Issue>): string {\n  return issues\n    .map(issue => {\n      const path = issue.path?.map(seg => (typeof seg === \"object\" && \"key\" in seg ? seg.key : seg));\n      const pathString = path && path.length > 0 ? ` at \"${path.join(\".\")}\"` : \"\";\n      return `${issue.message}${pathString}`;\n    })\n    .join(\" : \");\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,2BAA2B;AAQ7B,SAAS,aAAa,QAAoB,OAA+B;AAC9E,QAAM,UAAU,OAAO,WAAW,EAAE,SAAS,KAAK;AAClD,MAAI,mBAAmB,SAAS;AAC9B,UAAM,IAAI,SAAS;AAAA,MACjB,OAAO,WAAW;AAAA,MAClB,MAAM,oBAAoB;AAAA,MAC1B,SAAS,EAAE,QAAQ,MAAM;AAAA,IAC3B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAGO,SAAS,0BAA0B,QAAkE;AAC1G,QAAM,UAAU,aAAa,MAAM;AAEnC,MAAI,QAAQ,QAAQ;AAClB,WAAO,EAAE,cAAc,QAAW,UAAU,MAAM;AAAA,EACpD;AAEA,SAAO,EAAE,cAAc,QAAQ,OAAO,UAAU,KAAK;AACvD;AAGA,SAAS,YAAY,QAAoB,eAAoD;AAC3F,QAAM,EAAE,UAAU,aAAa,IAAI,0BAA0B,MAAM;AAEnE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,cAAc;AAAA,IACxB,UAAU,CAAC,UAAmB,aAAa,QAAQ,SAAS,cAAc,KAAK,CAAC;AAAA,EAClF;AACF;AAGO,SAAS,uBAAuB,YAA2E;AAChH,MAAI,CAAC,WAAY;AAEjB,aAAW,UAAU,OAAO,OAA0B,UAAU,GAAG;AACjE,QAAI,CAAC,OAAO,QAAQ;AAClB,MAAC,OAAO,SAA8C,CAAC,UAAkB;AAAA,IAC3E;AAEA,QAAI,CAAC,OAAO,eAAe;AACzB,aAAO,gBAAgB,YAAY,OAAO,QAAQ,OAAO,MAAO;AAAA,IAClE;AAAA,EACF;AACF;AAGO,SAAS,cAAc,QAAuD;AACnF,SAAO,OACJ,IAAI,WAAS;AACZ,UAAM,OAAO,MAAM,MAAM,IAAI,SAAQ,OAAO,QAAQ,YAAY,SAAS,MAAM,IAAI,MAAM,GAAI;AAC7F,UAAM,aAAa,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK,GAAG,CAAC,MAAM;AACzE,WAAO,GAAG,MAAM,OAAO,GAAG,UAAU;AAAA,EACtC,CAAC,EACA,KAAK,KAAK;AACf;",
+  "names": []
+}

package/lib/mjs/utilities/utilities.mjs

@@ -0,0 +1,122 @@
+// src/utilities/utilities.ts
+function toKebabCase(input) {
+  return input.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function generateOrdinalSuffix(index) {
+  if (index < 0) return "";
+  const number = index + 1;
+  const lastDigit = number % 10;
+  const lastTwoDigits = number % 100;
+  let suffix = "th";
+  if (lastTwoDigits < 11 || lastTwoDigits > 13) {
+    switch (lastDigit) {
+      case 1: {
+        suffix = "st";
+        break;
+      }
+      case 2: {
+        suffix = "nd";
+        break;
+      }
+      case 3: {
+        suffix = "rd";
+        break;
+      }
+    }
+  }
+  return `${number}${suffix}`;
+}
+function ln(count) {
+  return "\n".repeat(count);
+}
+function indent(count) {
+  if (count <= 0) return "";
+  return " ".repeat(count);
+}
+function indentLines(text, spaces) {
+  return text.replace(/\n/g, "\n" + indent(spaces));
+}
+function stringifyValue(value) {
+  if (value instanceof Set) {
+    return "new Set([" + Array.from(value).map((element) => stringifyValue(element)).join(", ") + "])";
+  }
+  return JSON.stringify(value);
+}
+function insertAtEndOfFirstLine(string, insert) {
+  const lines = string.split("\n");
+  lines[0] += (lines[0] ? " " : "") + insert;
+  return lines.join("\n");
+}
+function subcommandPlaceholder(metadata) {
+  let placeholder = metadata.placeholder;
+  if (placeholder) {
+    return placeholder;
+  }
+  if (metadata.options.length > 0) {
+    placeholder += (placeholder ? " " : "") + "[options]";
+  }
+  if (metadata.arguments.length > 0) {
+    placeholder += (placeholder ? " " : "") + "<arguments>";
+  }
+  if (metadata.allowPositionals) {
+    placeholder += (placeholder ? " " : "") + "<positionals>";
+  }
+  if (!placeholder) {
+    placeholder = " ";
+  }
+  return placeholder;
+}
+function escapeHtmlTags(markdown) {
+  const escapeMap = { "&": "&amp;", "<": "&lt;", ">": "&gt;" };
+  const re = /(```[\s\S]*?```|`[^`]*`)|(<!--[\s\S]*?-->)|(<[^>]+>)/g;
+  return markdown.replace(re, (fullMatch, code, comment, tag) => {
+    if (code) return code;
+    if (comment) return comment;
+    if (!tag) return fullMatch;
+    return tag.replace(/[&<>]/g, (ch) => escapeMap[ch]);
+  });
+}
+function ansiRegex({ onlyFirst = false } = {}) {
+  const ST = String.raw`(?:\u0007|\u001B\u005C|\u009C)`;
+  const osc = String.raw`(?:\u001B\][\s\S]*?${ST})`;
+  const csi = String.raw`[\u001B\u009B][[\]()#;?]*(?:\d{1,4}(?:[;:]\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]`;
+  const pattern = `${osc}|${csi}`;
+  return new RegExp(pattern, onlyFirst ? void 0 : "g");
+}
+var regex = ansiRegex();
+function stripAnsi(string) {
+  return string.replace(regex, "");
+}
+function walkObject(object_, onVisit, basePath = "") {
+  for (const [key, value] of Object.entries(object_)) {
+    const path = basePath ? `${basePath}.${key}` : key;
+    const newValue = onVisit(key, value, path);
+    if (newValue !== void 0) {
+      object_[key] = newValue;
+    }
+    const target = object_[key];
+    if (target && typeof target === "object" && !Array.isArray(target)) {
+      walkObject(target, onVisit, path);
+    }
+  }
+}
+function Enum(value) {
+  const casted = value;
+  for (const [key] of Object.entries(casted)) casted[key] = key;
+  return Object.freeze(casted);
+}
+export {
+  Enum,
+  escapeHtmlTags,
+  generateOrdinalSuffix,
+  indent,
+  indentLines,
+  insertAtEndOfFirstLine,
+  ln,
+  stringifyValue,
+  stripAnsi,
+  subcommandPlaceholder,
+  toKebabCase,
+  walkObject
+};
+//# sourceMappingURL=utilities.mjs.map

package/lib/mjs/utilities/utilities.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utilities/utilities.ts"],
+  "sourcesContent": ["import type { SubcommandMetadata } from \"../types/metadata-types.ts\";\n\nexport function toKebabCase(input: string): string {\n  return input.replace(/([a-z])([A-Z])/g, \"$1-$2\").toLowerCase();\n}\n\n/**\n * Converts a zero-based index into its human-readable ordinal form.\n *\n * Examples: 0 \u2192 \"1st\" 1 \u2192 \"2nd\" 2 \u2192 \"3rd\" 3 \u2192 \"4th\" 10 \u2192 \"11th\"\n *\n * Handles special cases for 11, 12, and 13.\n *\n * @param index - The zero-based index to convert.\n * @returns The ordinal string (e.g., \"1st\", \"2nd\", \"3rd\", \"4th\", ...).\n */\nexport function generateOrdinalSuffix(index: number): string {\n  if (index < 0) return \"\";\n\n  const number = index + 1;\n  const lastDigit = number % 10;\n  const lastTwoDigits = number % 100;\n\n  let suffix = \"th\";\n\n  if (lastTwoDigits < 11 || lastTwoDigits > 13) {\n    switch (lastDigit) {\n      case 1: {\n        suffix = \"st\";\n        break;\n      }\n      case 2: {\n        suffix = \"nd\";\n        break;\n      }\n      case 3: {\n        suffix = \"rd\";\n        break;\n      }\n    }\n  }\n\n  return `${number}${suffix}`;\n}\n\n/** New line */\nexport function ln(count: number) {\n  return \"\\n\".repeat(count);\n}\n\n/** Space */\nexport function indent(count: number) {\n  if (count <= 0) return \"\";\n  return \" \".repeat(count);\n}\n\n/** Indents every line in the given text by the provided number of spaces. Empty lines are preserved. */\nexport function indentLines(text: string, spaces: number): string {\n  return text.replace(/\\n/g, \"\\n\" + indent(spaces));\n}\n\nexport function stringifyValue(value: unknown): string {\n  // Set\n  if (value instanceof Set) {\n    return (\n      \"new Set([\" +\n      Array.from(value)\n        .map(element => stringifyValue(element))\n        .join(\", \") +\n      \"])\"\n    );\n  }\n\n  // unknown\n  return JSON.stringify(value);\n}\n\n/** Insert text at the end of the first line */\nexport function insertAtEndOfFirstLine(string: string, insert: string) {\n  const lines = string.split(\"\\n\");\n  lines[0] += (lines[0] ? \" \" : \"\") + insert;\n  return lines.join(\"\\n\");\n}\n\n/** Get the placeholder for a subcommand */\nexport function subcommandPlaceholder(metadata: SubcommandMetadata): string {\n  let placeholder = metadata.placeholder;\n\n  if (placeholder) {\n    return placeholder;\n  }\n\n  if (metadata.options.length > 0) {\n    placeholder += (placeholder ? \" \" : \"\") + \"[options]\";\n  }\n\n  if (metadata.arguments.length > 0) {\n    placeholder += (placeholder ? \" \" : \"\") + \"<arguments>\";\n  }\n\n  if (metadata.allowPositionals) {\n    placeholder += (placeholder ? \" \" : \"\") + \"<positionals>\";\n  }\n\n  if (!placeholder) {\n    placeholder = \" \";\n  }\n\n  return placeholder;\n}\n\n/**\n * Escape HTML characters inside HTML tags in a Markdown string, but leave code blocks, inline code, and HTML comments\n * unchanged.\n */\nexport function escapeHtmlTags(markdown: string): string {\n  const escapeMap: Record<string, string> = { \"&\": \"&amp;\", \"<\": \"&lt;\", \">\": \"&gt;\" };\n\n  // Captures:\n  // 1) fenced code blocks or inline code\n  // 2) HTML comments <!-- ... -->\n  // 3) other HTML tags like <b>, <div attr=\"x\">, etc.\n  const re = /(```[\\s\\S]*?```|`[^`]*`)|(<!--[\\s\\S]*?-->)|(<[^>]+>)/g;\n\n  return markdown.replace(re, (fullMatch: string, code?: string, comment?: string, tag?: string) => {\n    if (code) return code;\n    if (comment) return comment;\n    if (!tag) return fullMatch;\n\n    return tag.replace(/[&<>]/g, ch => escapeMap[ch]);\n  });\n}\n\n/** Credits: https://github.com/chalk/ansi-regex */\nfunction ansiRegex({ onlyFirst = false } = {}) {\n  // Valid string terminator sequences are BEL, ESC\\, and 0x9c\n  const ST = String.raw`(?:\\u0007|\\u001B\\u005C|\\u009C)`;\n\n  // OSC sequences only: ESC ] ... ST (non-greedy until the first ST)\n  const osc = String.raw`(?:\\u001B\\][\\s\\S]*?${ST})`;\n\n  // CSI and related: ESC/C1, optional intermediates, optional params (supports ; and :) then final byte\n  const csi = String.raw`[\\u001B\\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]`;\n\n  const pattern = `${osc}|${csi}`;\n\n  return new RegExp(pattern, onlyFirst ? undefined : \"g\");\n}\n\nconst regex = ansiRegex();\n\nexport function stripAnsi(string: string): string {\n  return string.replace(regex, \"\");\n}\n\ntype WalkCallback = (key: string, value: unknown, path: string) => unknown;\n\n/**\n * Recursively walks through an object and calls a function for each key-value pair.\n *\n * @param object_ - The object to walk.\n * @param onVisit - Function called on every visited property (key, value, path).\n * @param basePath - (Internal) Used for recursion to build nested paths.\n */\nexport function walkObject(object_: Record<string, unknown>, onVisit: WalkCallback, basePath = \"\"): void {\n  for (const [key, value] of Object.entries(object_)) {\n    const path = basePath ? `${basePath}.${key}` : key;\n    const newValue = onVisit(key, value, path);\n\n    if (newValue !== undefined) {\n      object_[key] = newValue;\n    }\n\n    const target = object_[key];\n    if (target && typeof target === \"object\" && !Array.isArray(target)) {\n      walkObject(target as Record<string, unknown>, onVisit, path);\n    }\n  }\n}\n\nexport function Enum<const T extends Record<string, undefined>>(value: T) {\n  const casted = value as Record<string, unknown>;\n  for (const [key] of Object.entries(casted)) casted[key] = key;\n  return Object.freeze(casted) as { [K in keyof T]: K };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/lib/{typescript → types}/autocomplete-scripts/bash-autocomplete-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/bash-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CAwEzE"}
+{"version":3,"file":"bash-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/bash-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CA0EzE"}

package/lib/types/autocomplete-scripts/powershell-autocomplete-script.d.ts

@@ -0,0 +1,15 @@
+import type { Cli } from "../types/definitions-types.ts";
+/**
+ * Generates a PowerShell autocomplete script for a CLI.
+ *
+ * Instructions:
+ *
+ * - Ensure your CLI is available as a `.ps1` file in your environment. e.g., `cliName.ps1`.
+ * - Add the generated script to your `profile.ps1` file:
+ *
+ *   1. Run: `notepad $profile`
+ *   2. Add: `. "<generated script path>"`
+ *   3. Save and reopen PowerShell
+ */
+export declare function generatePowerShellAutocompleteScript(cliDefinition: Cli): string;
+//# sourceMappingURL=powershell-autocomplete-script.d.ts.map

package/lib/{typescript → types}/autocomplete-scripts/powershell-autocomplete-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"powershell-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/powershell-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,oCAAoC,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CAwE/E"}
+{"version":3,"file":"powershell-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/powershell-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,oCAAoC,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CAyG/E"}

package/lib/types/autocomplete-scripts/zsh-autocomplete-script.d.ts

@@ -0,0 +1,4 @@
+import type { Cli } from "../types/definitions-types.ts";
+/** Generates a Zsh autocomplete script for a CLI, including global options when no subcommand is provided. */
+export declare function generateZshAutocompleteScript(cliDefinition: Cli): string;
+//# sourceMappingURL=zsh-autocomplete-script.d.ts.map

package/lib/{typescript → types}/autocomplete-scripts/zsh-autocomplete-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zsh-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/zsh-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAc,MAAM,+BAA+B,CAAC;AAErE;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CA+DxE"}
+{"version":3,"file":"zsh-autocomplete-script.d.ts","sourceRoot":"","sources":["../../../src/autocomplete-scripts/zsh-autocomplete-script.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAc,MAAM,+BAA+B,CAAC;AAErE,8GAA8G;AAC9G,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,GAAG,GAAG,MAAM,CA8ExE"}