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

package/lib/esm/markdown/generate-markdown.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["getCliMetadata","escapeHtmlTags","stripAnsi","generateMarkdown","cliDefinition","metadata","md","name","description","descriptionMarkdown","forceLineBreak","example","renderExamples","options","length","renderOptions","arguments","renderArguments","subcommands","renderSubcommands","examples","outString","optionsMetadata","h","index","hidden","aliases","nameAsArg","concat","aliasesAsArgs","join","placeholder","repeat","optional","defaultValue","defaultValueAsString","argumentsMetadata","subcommandsMetadata","string","replace"],"sources":["../../../src/markdown/generate-markdown.ts"],"sourcesContent":["import { getCliMetadata } from \"../metadata/cli-metadata.ts\";\nimport { escapeHtmlTags, stripAnsi } from \"../utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\nimport type { ArgumentMetadata, OptionMetadata, SubcommandMetadata } from \"../types/metadata-types.ts\";\n\nexport function generateMarkdown(cliDefinition: Cli): string {\n  const metadata = getCliMetadata(cliDefinition);\n\n  let md = \"<!-- Auto-generated by zod-args-parser -->\\n\\n\";\n\n  // Title\n  md += `# ${metadata.name}\\n\\n`;\n\n  // Description\n  if (metadata.description && !metadata.descriptionMarkdown) {\n    md += `${forceLineBreak(metadata.description)}\\n`;\n  }\n\n  // Description Markdown\n  if (metadata.descriptionMarkdown) {\n    md += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n  }\n\n  // Examples\n  if (metadata.example) {\n    md += renderExamples(metadata.example);\n  }\n\n  // Options\n  if (metadata.options.length > 0) {\n    md += \"\\n## Options:\\n\\n\";\n    md += renderOptions(metadata.options, 3);\n  }\n\n  // Arguments\n  if (metadata.arguments.length > 0) {\n    md += \"\\n## Arguments:\\n\\n\";\n    md += renderArguments(metadata.arguments, 3);\n  }\n\n  // Subcommands\n  if (metadata.subcommands.length > 0) {\n    md += \"\\n## Subcommands:\\n\\n\";\n    md += renderSubcommands(metadata.subcommands);\n  }\n\n  md = stripAnsi(md);\n  md = escapeHtmlTags(md);\n\n  return md;\n}\n\nfunction renderExamples(examples: string) {\n  let outString = \"\\n**Example:**\\n\";\n\n  const lang = \"bash\";\n\n  outString += \"\\n\";\n  outString += \"```\" + lang + \"\\n\";\n  outString += examples;\n  outString += \"\\n```\\n\";\n\n  return outString;\n}\n\nfunction renderOptions(optionsMetadata: OptionMetadata[] = [], h: number) {\n  let outString = \"\";\n\n  for (let index = 0; index < optionsMetadata.length; index++) {\n    const metadata = optionsMetadata[index];\n    if (metadata.hidden) continue;\n\n    const aliases = [metadata.nameAsArg].concat(metadata.aliasesAsArgs).join(\", \");\n\n    const placeholder = metadata.placeholder && ` ${metadata.placeholder}`;\n\n    outString += `${\"#\".repeat(h)} \\`${aliases + placeholder}\\``;\n\n    if (metadata.optional) {\n      outString += \" _optional_\";\n    }\n\n    outString += \"\\n\\n\";\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.defaultValue !== undefined) {\n      outString += `\\n**default:** \\`${metadata.defaultValueAsString}\\`\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (index < optionsMetadata.length - 1) {\n      outString += \"\\n\";\n    }\n  }\n\n  return outString;\n}\n\nfunction renderArguments(argumentsMetadata: ArgumentMetadata[] = [], h: number) {\n  let outString = \"\";\n\n  for (let index = 0; index < argumentsMetadata.length; index++) {\n    const metadata = argumentsMetadata[index];\n    if (metadata.hidden) continue;\n\n    outString += `${\"#\".repeat(h)} \\`${metadata.name}\\``;\n\n    if (metadata.optional) {\n      outString += \" _optional_\";\n    }\n\n    outString += \"\\n\\n\";\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.defaultValue !== undefined) {\n      outString += `\\n**default:** \\`${metadata.defaultValueAsString}\\`\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (index < argumentsMetadata.length - 1) {\n      outString += \"\\n\";\n    }\n  }\n\n  return outString;\n}\n\nfunction renderSubcommands(subcommandsMetadata: SubcommandMetadata[]) {\n  let outString = \"\";\n\n  for (let index = 0; index < subcommandsMetadata.length; index++) {\n    const metadata = subcommandsMetadata[index];\n    if (metadata.hidden) continue;\n\n    const aliases = [metadata.name].concat(metadata.aliases).join(\", \");\n\n    const placeholder = metadata.placeholder && ` ${metadata.placeholder}`;\n\n    outString += `### ${aliases + placeholder}\\n\\n`;\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (metadata.options.length > 0) {\n      outString += \"\\n#### Options:\\n\\n\";\n      outString += renderOptions(metadata.options, 4);\n    }\n\n    if (metadata.arguments.length > 0) {\n      outString += \"\\n#### Arguments:\\n\\n\";\n      outString += renderArguments(metadata.arguments, 4);\n    }\n\n    if (index < subcommandsMetadata.length - 1) {\n      outString += \"\\n---\\n\\n\";\n    }\n  }\n\n  return outString;\n}\n\n/** Inserts two trailing spaces before newline. In Markdown, a newline that ends with two spaces forces a line break. */\nfunction forceLineBreak(string: string): string {\n  return string.replace(/(\\n+)/g, \"  $1\");\n}\n"],"mappings":"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","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/markdown/generate-markdown.ts"],
+  "sourcesContent": ["import { getCliMetadata } from \"../metadata/cli-metadata.ts\";\nimport { escapeHtmlTags, stripAnsi } from \"../utilities/utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\nimport type { ArgumentMetadata, OptionMetadata, SubcommandMetadata } from \"../types/metadata-types.ts\";\n\nexport function generateMarkdown(cliDefinition: Cli): string {\n  const metadata = getCliMetadata(cliDefinition);\n\n  let md = \"<!-- Auto-generated by zod-args-parser -->\\n\\n\";\n\n  // Title\n  md += `# ${metadata.name}\\n\\n`;\n\n  // Description\n  if (metadata.description && !metadata.descriptionMarkdown) {\n    md += `${forceLineBreak(metadata.description)}\\n`;\n  }\n\n  // Description Markdown\n  if (metadata.descriptionMarkdown) {\n    md += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n  }\n\n  // Examples\n  if (metadata.example) {\n    md += renderExamples(metadata.example);\n  }\n\n  // Options\n  if (metadata.options.length > 0) {\n    md += \"\\n## Options:\\n\\n\";\n    md += renderOptions(metadata.options, 3);\n  }\n\n  // Arguments\n  if (metadata.arguments.length > 0) {\n    md += \"\\n## Arguments:\\n\\n\";\n    md += renderArguments(metadata.arguments, 3);\n  }\n\n  // Subcommands\n  if (metadata.subcommands.length > 0) {\n    md += \"\\n## Subcommands:\\n\\n\";\n    md += renderSubcommands(metadata.subcommands);\n  }\n\n  md = stripAnsi(md);\n  md = escapeHtmlTags(md);\n\n  return md;\n}\n\nfunction renderExamples(examples: string) {\n  let outString = \"\\n**Example:**\\n\";\n\n  const lang = \"bash\";\n\n  outString += \"\\n\";\n  outString += \"```\" + lang + \"\\n\";\n  outString += examples;\n  outString += \"\\n```\\n\";\n\n  return outString;\n}\n\nfunction renderOptions(optionsMetadata: OptionMetadata[] = [], h: number) {\n  let outString = \"\";\n\n  for (let index = 0; index < optionsMetadata.length; index++) {\n    const metadata = optionsMetadata[index];\n    if (metadata.hidden) continue;\n\n    const aliases = [metadata.nameAsArg].concat(metadata.aliasesAsArgs).join(\", \");\n    const placeholder = metadata.placeholder && ` ${metadata.placeholder}`;\n\n    outString += `${\"#\".repeat(h)} \\`${aliases + placeholder}\\``;\n\n    if (metadata.optional) {\n      outString += \" _optional_\";\n    }\n\n    outString += \"\\n\\n\";\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.defaultValue !== undefined) {\n      const nl = outString.endsWith(\"\\n\\n\") ? \"\" : \"\\n\";\n      outString += `${nl}**default:** \\`${metadata.defaultValueAsString}\\`\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (index < optionsMetadata.length - 1) {\n      outString += \"\\n\";\n    }\n  }\n\n  return outString;\n}\n\nfunction renderArguments(argumentsMetadata: ArgumentMetadata[] = [], h: number) {\n  let outString = \"\";\n\n  for (let index = 0; index < argumentsMetadata.length; index++) {\n    const metadata = argumentsMetadata[index];\n    if (metadata.hidden) continue;\n\n    outString += `${\"#\".repeat(h)} \\`${metadata.name}\\``;\n\n    if (metadata.optional) {\n      outString += \" _optional_\";\n    }\n\n    outString += \"\\n\\n\";\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.defaultValue !== undefined) {\n      const nl = outString.endsWith(\"\\n\\n\") ? \"\" : \"\\n\";\n      outString += `${nl}**default:** \\`${metadata.defaultValueAsString}\\`\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (index < argumentsMetadata.length - 1) {\n      outString += \"\\n\";\n    }\n  }\n\n  return outString;\n}\n\nfunction renderSubcommands(subcommandsMetadata: SubcommandMetadata[]) {\n  let outString = \"\";\n\n  for (let index = 0; index < subcommandsMetadata.length; index++) {\n    const metadata = subcommandsMetadata[index];\n    if (metadata.hidden) continue;\n\n    const aliases = [metadata.name].concat(metadata.aliases).join(\", \");\n\n    const placeholder = metadata.placeholder && ` ${metadata.placeholder}`;\n\n    outString += `### ${aliases + placeholder}\\n\\n`;\n\n    if (metadata.description && !metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.description)}\\n`;\n    }\n\n    if (metadata.descriptionMarkdown) {\n      outString += `${forceLineBreak(metadata.descriptionMarkdown)}\\n`;\n    }\n\n    if (metadata.example) {\n      outString += renderExamples(metadata.example);\n    }\n\n    if (metadata.options.length > 0) {\n      outString += \"\\n#### Options:\\n\\n\";\n      outString += renderOptions(metadata.options, 4);\n    }\n\n    if (metadata.arguments.length > 0) {\n      outString += \"\\n#### Arguments:\\n\\n\";\n      outString += renderArguments(metadata.arguments, 4);\n    }\n\n    if (index < subcommandsMetadata.length - 1) {\n      outString += \"\\n---\\n\\n\";\n    }\n  }\n\n  return outString;\n}\n\n/** Inserts two trailing spaces before newline. In Markdown, a newline that ends with two spaces forces a line break. */\nfunction forceLineBreak(string: string): string {\n  return string.replace(/(\\n+)/g, \"  $1\");\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/lib/esm/metadata/arguments-metadata.js

@@ -1,2 +1,26 @@
-import{defaultValueAndIsOptional,stringifyValue}from"../utilities.js";function getArgumentsMetadata(e){const t=[];for(const[a,n]of Object.entries(e)){const e=n.meta??{},{optional:i,defaultValue:o}=n._preparedType??defaultValueAndIsOptional(n.schema);t.push({name:e.name??a,description:e.description??"",descriptionMarkdown:e.descriptionMarkdown??"",defaultValue:o,defaultValueAsString:e.default??stringifyValue(o)??"",optional:e.optional??i,example:e.example??"",schema:n.schema,hidden:e.hidden??!1})}return t}export{getArgumentsMetadata};
-//# sourceMappingURL=arguments-metadata.js.map
+// src/metadata/arguments-metadata.ts
+import { defaultValueAndIsOptional } from "../utilities/schema-utilities.js";
+import { stringifyValue } from "../utilities/utilities.js";
+function getArgumentsMetadata(argumentsDefinition) {
+  const outputMetadata = [];
+  for (const [name, argument] of Object.entries(argumentsDefinition)) {
+    const meta = argument.meta ?? {};
+    const { optional, defaultValue } = argument._preparedType ?? defaultValueAndIsOptional(argument.schema);
+    outputMetadata.push({
+      name: meta.name ?? name,
+      description: meta.description ?? "",
+      descriptionMarkdown: meta.descriptionMarkdown ?? "",
+      defaultValue,
+      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? "",
+      optional: meta.optional ?? optional,
+      example: meta.example ?? "",
+      schema: argument.schema,
+      hidden: meta.hidden ?? false
+    });
+  }
+  return outputMetadata;
+}
+export {
+  getArgumentsMetadata
+};
+//# sourceMappingURL=arguments-metadata.js.map

package/lib/esm/metadata/arguments-metadata.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["defaultValueAndIsOptional","stringifyValue","getArgumentsMetadata","argumentsDefinition","outputMetadata","name","argument","Object","entries","meta","optional","defaultValue","_preparedType","schema","push","description","descriptionMarkdown","defaultValueAsString","default","example","hidden"],"sources":["../../../src/metadata/arguments-metadata.ts"],"sourcesContent":["import { defaultValueAndIsOptional, stringifyValue } from \"../utilities.ts\";\n\nimport type { Argument } from \"../types/definitions-types.ts\";\nimport type { ArgumentMetadata } from \"../types/metadata-types.ts\";\n\nexport function getArgumentsMetadata(argumentsDefinition: Record<string, Argument>): ArgumentMetadata[] {\n  const outputMetadata: ArgumentMetadata[] = [];\n\n  for (const [name, argument] of Object.entries(argumentsDefinition)) {\n    const meta = argument.meta ?? {};\n\n    const { optional, defaultValue } = argument._preparedType ?? defaultValueAndIsOptional(argument.schema);\n\n    outputMetadata.push({\n      name: meta.name ?? name,\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      defaultValue,\n      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? \"\",\n      optional: meta.optional ?? optional,\n      example: meta.example ?? \"\",\n      schema: argument.schema,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],"mappings":"OAASA,0BAA2BC,mBAAsB,kBAKnD,SAASC,qBAAqBC,GACnC,MAAMC,EAAqC,GAE3C,UAAYC,EAAMC,KAAaC,OAAOC,QAAQL,GAAsB,CAClE,MAAMM,EAAOH,EAASG,MAAQ,CAAC,GAEzBC,SAAEA,EAAAC,aAAUA,GAAiBL,EAASM,eAAiBZ,0BAA0BM,EAASO,QAEhGT,EAAeU,KAAK,CAClBT,KAAMI,EAAKJ,MAAQA,EACnBU,YAAaN,EAAKM,aAAe,GACjCC,oBAAqBP,EAAKO,qBAAuB,GACjDL,eACAM,qBAAsBR,EAAKS,SAAWjB,eAAeU,IAAiB,GACtED,SAAUD,EAAKC,UAAYA,EAC3BS,QAASV,EAAKU,SAAW,GACzBN,OAAQP,EAASO,OACjBO,OAAQX,EAAKW,SAAU,GAE3B,CAEA,OAAOhB,CACT,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/metadata/arguments-metadata.ts"],
+  "sourcesContent": ["import { defaultValueAndIsOptional } from \"../utilities/schema-utilities.ts\";\nimport { stringifyValue } from \"../utilities/utilities.ts\";\n\nimport type { Argument } from \"../types/definitions-types.ts\";\nimport type { ArgumentMetadata } from \"../types/metadata-types.ts\";\n\nexport function getArgumentsMetadata(argumentsDefinition: Record<string, Argument>): ArgumentMetadata[] {\n  const outputMetadata: ArgumentMetadata[] = [];\n\n  for (const [name, argument] of Object.entries(argumentsDefinition)) {\n    const meta = argument.meta ?? {};\n\n    const { optional, defaultValue } = argument._preparedType ?? defaultValueAndIsOptional(argument.schema);\n\n    outputMetadata.push({\n      name: meta.name ?? name,\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      defaultValue,\n      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? \"\",\n      optional: meta.optional ?? optional,\n      example: meta.example ?? \"\",\n      schema: argument.schema,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],
+  "mappings": ";AAAA,SAAS,iCAAiC;AAC1C,SAAS,sBAAsB;AAKxB,SAAS,qBAAqB,qBAAmE;AACtG,QAAM,iBAAqC,CAAC;AAE5C,aAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,mBAAmB,GAAG;AAClE,UAAM,OAAO,SAAS,QAAQ,CAAC;AAE/B,UAAM,EAAE,UAAU,aAAa,IAAI,SAAS,iBAAiB,0BAA0B,SAAS,MAAM;AAEtG,mBAAe,KAAK;AAAA,MAClB,MAAM,KAAK,QAAQ;AAAA,MACnB,aAAa,KAAK,eAAe;AAAA,MACjC,qBAAqB,KAAK,uBAAuB;AAAA,MACjD;AAAA,MACA,sBAAsB,KAAK,WAAW,eAAe,YAAY,KAAK;AAAA,MACtE,UAAU,KAAK,YAAY;AAAA,MAC3B,SAAS,KAAK,WAAW;AAAA,MACzB,QAAQ,SAAS;AAAA,MACjB,QAAQ,KAAK,UAAU;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/esm/metadata/cli-metadata.js

@@ -1,2 +1,24 @@
-import{getArgumentsMetadata}from"./arguments-metadata.js";import{getOptionsMetadata}from"./options-metadata.js";import{getSubcommandsMetadata}from"./subcommands-metadata.js";function getCliMetadata(t){const a=t.subcommands??[],e=t.meta??{};return{name:t.cliName,description:e.description??"",descriptionMarkdown:e.descriptionMarkdown??"",usage:e.usage??"",example:e.example??"",allowPositionals:t.allowPositionals??!1,options:t.options?getOptionsMetadata(t.options):[],arguments:t.arguments?getArgumentsMetadata(t.arguments):[],subcommands:a?getSubcommandsMetadata(a):[]}}export{getCliMetadata};
-//# sourceMappingURL=cli-metadata.js.map
+// src/metadata/cli-metadata.ts
+import { getArgumentsMetadata } from "./arguments-metadata.js";
+import { getOptionsMetadata } from "./options-metadata.js";
+import { getSubcommandsMetadata } from "./subcommands-metadata.js";
+function getCliMetadata(cliDefinition) {
+  const subcommands = cliDefinition.subcommands ?? [];
+  const meta = cliDefinition.meta ?? {};
+  const outputMetadata = {
+    name: cliDefinition.cliName,
+    description: meta.description ?? "",
+    descriptionMarkdown: meta.descriptionMarkdown ?? "",
+    usage: meta.usage ?? "",
+    example: meta.example ?? "",
+    allowPositionals: cliDefinition.allowPositionals ?? false,
+    options: cliDefinition.options ? getOptionsMetadata(cliDefinition.options) : [],
+    arguments: cliDefinition.arguments ? getArgumentsMetadata(cliDefinition.arguments) : [],
+    subcommands: subcommands ? getSubcommandsMetadata(subcommands) : []
+  };
+  return outputMetadata;
+}
+export {
+  getCliMetadata
+};
+//# sourceMappingURL=cli-metadata.js.map

package/lib/esm/metadata/cli-metadata.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["getArgumentsMetadata","getOptionsMetadata","getSubcommandsMetadata","getCliMetadata","cliDefinition","subcommands","meta","name","cliName","description","descriptionMarkdown","usage","example","allowPositionals","options","arguments"],"sources":["../../../src/metadata/cli-metadata.ts"],"sourcesContent":["import { getArgumentsMetadata } from \"./arguments-metadata.ts\";\nimport { getOptionsMetadata } from \"./options-metadata.ts\";\nimport { getSubcommandsMetadata } from \"./subcommands-metadata.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\nimport type { CliMetadata } from \"../types/metadata-types.ts\";\n\nexport function getCliMetadata(cliDefinition: Cli): CliMetadata {\n  const subcommands = cliDefinition.subcommands ?? [];\n\n  const meta = cliDefinition.meta ?? {};\n\n  const outputMetadata: CliMetadata = {\n    name: cliDefinition.cliName,\n    description: meta.description ?? \"\",\n    descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n    usage: meta.usage ?? \"\",\n    example: meta.example ?? \"\",\n    allowPositionals: cliDefinition.allowPositionals ?? false,\n    options: cliDefinition.options ? getOptionsMetadata(cliDefinition.options) : [],\n    arguments: cliDefinition.arguments ? getArgumentsMetadata(cliDefinition.arguments) : [],\n    subcommands: subcommands ? getSubcommandsMetadata(subcommands) : [],\n  };\n\n  return outputMetadata;\n}\n"],"mappings":"OAASA,yBAA4B,iCAC5BC,uBAA0B,+BAC1BC,2BAA8B,4BAKhC,SAASC,eAAeC,GAC7B,MAAMC,EAAcD,EAAcC,aAAe,GAE3CC,EAAOF,EAAcE,MAAQ,CAAC,EAcpC,MAZoC,CAClCC,KAAMH,EAAcI,QACpBC,YAAaH,EAAKG,aAAe,GACjCC,oBAAqBJ,EAAKI,qBAAuB,GACjDC,MAAOL,EAAKK,OAAS,GACrBC,QAASN,EAAKM,SAAW,GACzBC,iBAAkBT,EAAcS,mBAAoB,EACpDC,QAASV,EAAcU,QAAUb,mBAAmBG,EAAcU,SAAW,GAC7EC,UAAWX,EAAcW,UAAYf,qBAAqBI,EAAcW,WAAa,GACrFV,YAAaA,EAAcH,uBAAuBG,GAAe,GAIrE,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/metadata/cli-metadata.ts"],
+  "sourcesContent": ["import { getArgumentsMetadata } from \"./arguments-metadata.ts\";\nimport { getOptionsMetadata } from \"./options-metadata.ts\";\nimport { getSubcommandsMetadata } from \"./subcommands-metadata.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\nimport type { CliMetadata } from \"../types/metadata-types.ts\";\n\nexport function getCliMetadata(cliDefinition: Cli): CliMetadata {\n  const subcommands = cliDefinition.subcommands ?? [];\n\n  const meta = cliDefinition.meta ?? {};\n\n  const outputMetadata: CliMetadata = {\n    name: cliDefinition.cliName,\n    description: meta.description ?? \"\",\n    descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n    usage: meta.usage ?? \"\",\n    example: meta.example ?? \"\",\n    allowPositionals: cliDefinition.allowPositionals ?? false,\n    options: cliDefinition.options ? getOptionsMetadata(cliDefinition.options) : [],\n    arguments: cliDefinition.arguments ? getArgumentsMetadata(cliDefinition.arguments) : [],\n    subcommands: subcommands ? getSubcommandsMetadata(subcommands) : [],\n  };\n\n  return outputMetadata;\n}\n"],
+  "mappings": ";AAAA,SAAS,4BAA4B;AACrC,SAAS,0BAA0B;AACnC,SAAS,8BAA8B;AAKhC,SAAS,eAAe,eAAiC;AAC9D,QAAM,cAAc,cAAc,eAAe,CAAC;AAElD,QAAM,OAAO,cAAc,QAAQ,CAAC;AAEpC,QAAM,iBAA8B;AAAA,IAClC,MAAM,cAAc;AAAA,IACpB,aAAa,KAAK,eAAe;AAAA,IACjC,qBAAqB,KAAK,uBAAuB;AAAA,IACjD,OAAO,KAAK,SAAS;AAAA,IACrB,SAAS,KAAK,WAAW;AAAA,IACzB,kBAAkB,cAAc,oBAAoB;AAAA,IACpD,SAAS,cAAc,UAAU,mBAAmB,cAAc,OAAO,IAAI,CAAC;AAAA,IAC9E,WAAW,cAAc,YAAY,qBAAqB,cAAc,SAAS,IAAI,CAAC;AAAA,IACtF,aAAa,cAAc,uBAAuB,WAAW,IAAI,CAAC;AAAA,EACpE;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/esm/metadata/options-metadata.js

@@ -1,2 +1,35 @@
-import{transformOptionToArgument}from"../parse/parser-utilities.js";import{defaultValueAndIsOptional,stringifyValue}from"../utilities.js";function getOptionsMetadata(e){const t=[];if(!e)return t;for(const[a,i]of Object.entries(e)){const e=i.aliases??[],n=i.meta??{},{optional:o,defaultValue:r}=i._preparedType??defaultValueAndIsOptional(i.schema);t.push({name:a,nameAsArg:transformOptionToArgument(a),aliases:e,aliasesAsArgs:e.map(e=>transformOptionToArgument(e)),placeholder:n.placeholder??"",description:n.description??"",descriptionMarkdown:n.descriptionMarkdown??"",optional:n.optional??o,example:n.example??"",defaultValue:r,defaultValueAsString:n.default??stringifyValue(r)??"",schema:i.schema,hidden:n.hidden??!1})}return t}export{getOptionsMetadata};
-//# sourceMappingURL=options-metadata.js.map
+// src/metadata/options-metadata.ts
+import { transformOptionToArgument } from "../parse/parser-utilities.js";
+import { defaultValueAndIsOptional } from "../utilities/schema-utilities.js";
+import { stringifyValue } from "../utilities/utilities.js";
+function getOptionsMetadata(optionsDefinition) {
+  const outputMetadata = [];
+  if (!optionsDefinition) {
+    return outputMetadata;
+  }
+  for (const [optionName, option] of Object.entries(optionsDefinition)) {
+    const aliases = option.aliases ?? [];
+    const meta = option.meta ?? {};
+    const { optional, defaultValue } = option._preparedType ?? defaultValueAndIsOptional(option.schema);
+    outputMetadata.push({
+      name: optionName,
+      nameAsArg: transformOptionToArgument(optionName),
+      aliases,
+      aliasesAsArgs: aliases.map((alias) => transformOptionToArgument(alias)),
+      placeholder: meta.placeholder ?? "",
+      description: meta.description ?? "",
+      descriptionMarkdown: meta.descriptionMarkdown ?? "",
+      optional: meta.optional ?? optional,
+      example: meta.example ?? "",
+      defaultValue,
+      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? "",
+      schema: option.schema,
+      hidden: meta.hidden ?? false
+    });
+  }
+  return outputMetadata;
+}
+export {
+  getOptionsMetadata
+};
+//# sourceMappingURL=options-metadata.js.map

package/lib/esm/metadata/options-metadata.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["transformOptionToArgument","defaultValueAndIsOptional","stringifyValue","getOptionsMetadata","optionsDefinition","outputMetadata","optionName","option","Object","entries","aliases","meta","optional","defaultValue","_preparedType","schema","push","name","nameAsArg","aliasesAsArgs","map","alias","placeholder","description","descriptionMarkdown","example","defaultValueAsString","default","hidden"],"sources":["../../../src/metadata/options-metadata.ts"],"sourcesContent":["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\nimport { defaultValueAndIsOptional, stringifyValue } from \"../utilities.ts\";\n\nimport type { Option } from \"../types/definitions-types.ts\";\nimport type { OptionMetadata } from \"../types/metadata-types.ts\";\n\nexport function getOptionsMetadata(optionsDefinition: Record<string, Option>): OptionMetadata[] {\n  const outputMetadata: OptionMetadata[] = [];\n\n  if (!optionsDefinition) {\n    return outputMetadata;\n  }\n\n  for (const [optionName, option] of Object.entries(optionsDefinition)) {\n    const aliases = option.aliases ?? [];\n    const meta = option.meta ?? {};\n\n    const { optional, defaultValue } = option._preparedType ?? defaultValueAndIsOptional(option.schema);\n\n    outputMetadata.push({\n      name: optionName,\n      nameAsArg: transformOptionToArgument(optionName),\n      aliases,\n      aliasesAsArgs: aliases.map(alias => transformOptionToArgument(alias)),\n      placeholder: meta.placeholder ?? \"\",\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      optional: meta.optional ?? optional,\n      example: meta.example ?? \"\",\n      defaultValue,\n      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? \"\",\n      schema: option.schema,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],"mappings":"OAASA,8BAAiC,sCACjCC,0BAA2BC,mBAAsB,kBAKnD,SAASC,mBAAmBC,GACjC,MAAMC,EAAmC,GAEzC,IAAKD,EACH,OAAOC,EAGT,UAAYC,EAAYC,KAAWC,OAAOC,QAAQL,GAAoB,CACpE,MAAMM,EAAUH,EAAOG,SAAW,GAC5BC,EAAOJ,EAAOI,MAAQ,CAAC,GAEvBC,SAAEA,EAAAC,aAAUA,GAAiBN,EAAOO,eAAiBb,0BAA0BM,EAAOQ,QAE5FV,EAAeW,KAAK,CAClBC,KAAMX,EACNY,UAAWlB,0BAA0BM,GACrCI,UACAS,cAAeT,EAAQU,IAAIC,GAASrB,0BAA0BqB,IAC9DC,YAAaX,EAAKW,aAAe,GACjCC,YAAaZ,EAAKY,aAAe,GACjCC,oBAAqBb,EAAKa,qBAAuB,GACjDZ,SAAUD,EAAKC,UAAYA,EAC3Ba,QAASd,EAAKc,SAAW,GACzBZ,eACAa,qBAAsBf,EAAKgB,SAAWzB,eAAeW,IAAiB,GACtEE,OAAQR,EAAOQ,OACfa,OAAQjB,EAAKiB,SAAU,GAE3B,CAEA,OAAOvB,CACT,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/metadata/options-metadata.ts"],
+  "sourcesContent": ["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\nimport { defaultValueAndIsOptional } from \"../utilities/schema-utilities.ts\";\nimport { stringifyValue } from \"../utilities/utilities.ts\";\n\nimport type { Option } from \"../types/definitions-types.ts\";\nimport type { OptionMetadata } from \"../types/metadata-types.ts\";\n\nexport function getOptionsMetadata(optionsDefinition: Record<string, Option>): OptionMetadata[] {\n  const outputMetadata: OptionMetadata[] = [];\n\n  if (!optionsDefinition) {\n    return outputMetadata;\n  }\n\n  for (const [optionName, option] of Object.entries(optionsDefinition)) {\n    const aliases = option.aliases ?? [];\n    const meta = option.meta ?? {};\n\n    const { optional, defaultValue } = option._preparedType ?? defaultValueAndIsOptional(option.schema);\n\n    outputMetadata.push({\n      name: optionName,\n      nameAsArg: transformOptionToArgument(optionName),\n      aliases,\n      aliasesAsArgs: aliases.map(alias => transformOptionToArgument(alias)),\n      placeholder: meta.placeholder ?? \"\",\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      optional: meta.optional ?? optional,\n      example: meta.example ?? \"\",\n      defaultValue,\n      defaultValueAsString: meta.default ?? stringifyValue(defaultValue) ?? \"\",\n      schema: option.schema,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],
+  "mappings": ";AAAA,SAAS,iCAAiC;AAC1C,SAAS,iCAAiC;AAC1C,SAAS,sBAAsB;AAKxB,SAAS,mBAAmB,mBAA6D;AAC9F,QAAM,iBAAmC,CAAC;AAE1C,MAAI,CAAC,mBAAmB;AACtB,WAAO;AAAA,EACT;AAEA,aAAW,CAAC,YAAY,MAAM,KAAK,OAAO,QAAQ,iBAAiB,GAAG;AACpE,UAAM,UAAU,OAAO,WAAW,CAAC;AACnC,UAAM,OAAO,OAAO,QAAQ,CAAC;AAE7B,UAAM,EAAE,UAAU,aAAa,IAAI,OAAO,iBAAiB,0BAA0B,OAAO,MAAM;AAElG,mBAAe,KAAK;AAAA,MAClB,MAAM;AAAA,MACN,WAAW,0BAA0B,UAAU;AAAA,MAC/C;AAAA,MACA,eAAe,QAAQ,IAAI,WAAS,0BAA0B,KAAK,CAAC;AAAA,MACpE,aAAa,KAAK,eAAe;AAAA,MACjC,aAAa,KAAK,eAAe;AAAA,MACjC,qBAAqB,KAAK,uBAAuB;AAAA,MACjD,UAAU,KAAK,YAAY;AAAA,MAC3B,SAAS,KAAK,WAAW;AAAA,MACzB;AAAA,MACA,sBAAsB,KAAK,WAAW,eAAe,YAAY,KAAK;AAAA,MACtE,QAAQ,OAAO;AAAA,MACf,QAAQ,KAAK,UAAU;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/esm/metadata/subcommands-metadata.js

@@ -1,2 +1,32 @@
-import{getArgumentsMetadata}from"./arguments-metadata.js";import{getOptionsMetadata}from"./options-metadata.js";function getSubcommandsMetadata(t){const a=[];if(!t||0===t.length)return a;for(const e of t){const t=e.options?getOptionsMetadata(e.options):[],o=e.arguments?getArgumentsMetadata(e.arguments):[],n=e.meta??{};a.push({name:e.name,aliases:e.aliases??[],description:n.description??"",descriptionMarkdown:n.descriptionMarkdown??"",placeholder:n.placeholder??"",usage:n.usage??"",example:n.example??"",allowPositionals:e.allowPositionals??!1,options:t,arguments:o,hidden:n.hidden??!1})}return a}export{getSubcommandsMetadata};
-//# sourceMappingURL=subcommands-metadata.js.map
+// src/metadata/subcommands-metadata.ts
+import { getArgumentsMetadata } from "./arguments-metadata.js";
+import { getOptionsMetadata } from "./options-metadata.js";
+function getSubcommandsMetadata(commandDefinition) {
+  const outputMetadata = [];
+  if (!commandDefinition || commandDefinition.length === 0) {
+    return outputMetadata;
+  }
+  for (const subcommand of commandDefinition) {
+    const optionsMetadata = subcommand.options ? getOptionsMetadata(subcommand.options) : [];
+    const argumentsMetadata = subcommand.arguments ? getArgumentsMetadata(subcommand.arguments) : [];
+    const meta = subcommand.meta ?? {};
+    outputMetadata.push({
+      name: subcommand.name,
+      aliases: subcommand.aliases ?? [],
+      description: meta.description ?? "",
+      descriptionMarkdown: meta.descriptionMarkdown ?? "",
+      placeholder: meta.placeholder ?? "",
+      usage: meta.usage ?? "",
+      example: meta.example ?? "",
+      allowPositionals: subcommand.allowPositionals ?? false,
+      options: optionsMetadata,
+      arguments: argumentsMetadata,
+      hidden: meta.hidden ?? false
+    });
+  }
+  return outputMetadata;
+}
+export {
+  getSubcommandsMetadata
+};
+//# sourceMappingURL=subcommands-metadata.js.map

package/lib/esm/metadata/subcommands-metadata.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["getArgumentsMetadata","getOptionsMetadata","getSubcommandsMetadata","commandDefinition","outputMetadata","length","subcommand","optionsMetadata","options","argumentsMetadata","arguments","meta","push","name","aliases","description","descriptionMarkdown","placeholder","usage","example","allowPositionals","hidden"],"sources":["../../../src/metadata/subcommands-metadata.ts"],"sourcesContent":["import { getArgumentsMetadata } from \"./arguments-metadata.ts\";\nimport { getOptionsMetadata } from \"./options-metadata.ts\";\n\nimport type { Subcommand } from \"../types/definitions-types.ts\";\nimport type { SubcommandMetadata } from \"../types/metadata-types.ts\";\n\nexport function getSubcommandsMetadata(commandDefinition: readonly Subcommand[]): SubcommandMetadata[] {\n  const outputMetadata: SubcommandMetadata[] = [];\n\n  if (!commandDefinition || commandDefinition.length === 0) {\n    return outputMetadata;\n  }\n\n  for (const subcommand of commandDefinition) {\n    const optionsMetadata = subcommand.options ? getOptionsMetadata(subcommand.options) : [];\n    const argumentsMetadata = subcommand.arguments ? getArgumentsMetadata(subcommand.arguments) : [];\n    const meta = subcommand.meta ?? {};\n\n    outputMetadata.push({\n      name: subcommand.name,\n      aliases: subcommand.aliases ?? [],\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      placeholder: meta.placeholder ?? \"\",\n      usage: meta.usage ?? \"\",\n      example: meta.example ?? \"\",\n      allowPositionals: subcommand.allowPositionals ?? false,\n      options: optionsMetadata,\n      arguments: argumentsMetadata,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],"mappings":"OAASA,yBAA4B,iCAC5BC,uBAA0B,wBAK5B,SAASC,uBAAuBC,GACrC,MAAMC,EAAuC,GAE7C,IAAKD,GAAkD,IAA7BA,EAAkBE,OAC1C,OAAOD,EAGT,UAAWE,KAAcH,EAAmB,CAC1C,MAAMI,EAAkBD,EAAWE,QAAUP,mBAAmBK,EAAWE,SAAW,GAChFC,EAAoBH,EAAWI,UAAYV,qBAAqBM,EAAWI,WAAa,GACxFC,EAAOL,EAAWK,MAAQ,CAAC,EAEjCP,EAAeQ,KAAK,CAClBC,KAAMP,EAAWO,KACjBC,QAASR,EAAWQ,SAAW,GAC/BC,YAAaJ,EAAKI,aAAe,GACjCC,oBAAqBL,EAAKK,qBAAuB,GACjDC,YAAaN,EAAKM,aAAe,GACjCC,MAAOP,EAAKO,OAAS,GACrBC,QAASR,EAAKQ,SAAW,GACzBC,iBAAkBd,EAAWc,mBAAoB,EACjDZ,QAASD,EACTG,UAAWD,EACXY,OAAQV,EAAKU,SAAU,GAE3B,CAEA,OAAOjB,CACT,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/metadata/subcommands-metadata.ts"],
+  "sourcesContent": ["import { getArgumentsMetadata } from \"./arguments-metadata.ts\";\nimport { getOptionsMetadata } from \"./options-metadata.ts\";\n\nimport type { Subcommand } from \"../types/definitions-types.ts\";\nimport type { SubcommandMetadata } from \"../types/metadata-types.ts\";\n\nexport function getSubcommandsMetadata(commandDefinition: readonly Subcommand[]): SubcommandMetadata[] {\n  const outputMetadata: SubcommandMetadata[] = [];\n\n  if (!commandDefinition || commandDefinition.length === 0) {\n    return outputMetadata;\n  }\n\n  for (const subcommand of commandDefinition) {\n    const optionsMetadata = subcommand.options ? getOptionsMetadata(subcommand.options) : [];\n    const argumentsMetadata = subcommand.arguments ? getArgumentsMetadata(subcommand.arguments) : [];\n    const meta = subcommand.meta ?? {};\n\n    outputMetadata.push({\n      name: subcommand.name,\n      aliases: subcommand.aliases ?? [],\n      description: meta.description ?? \"\",\n      descriptionMarkdown: meta.descriptionMarkdown ?? \"\",\n      placeholder: meta.placeholder ?? \"\",\n      usage: meta.usage ?? \"\",\n      example: meta.example ?? \"\",\n      allowPositionals: subcommand.allowPositionals ?? false,\n      options: optionsMetadata,\n      arguments: argumentsMetadata,\n      hidden: meta.hidden ?? false,\n    });\n  }\n\n  return outputMetadata;\n}\n"],
+  "mappings": ";AAAA,SAAS,4BAA4B;AACrC,SAAS,0BAA0B;AAK5B,SAAS,uBAAuB,mBAAgE;AACrG,QAAM,iBAAuC,CAAC;AAE9C,MAAI,CAAC,qBAAqB,kBAAkB,WAAW,GAAG;AACxD,WAAO;AAAA,EACT;AAEA,aAAW,cAAc,mBAAmB;AAC1C,UAAM,kBAAkB,WAAW,UAAU,mBAAmB,WAAW,OAAO,IAAI,CAAC;AACvF,UAAM,oBAAoB,WAAW,YAAY,qBAAqB,WAAW,SAAS,IAAI,CAAC;AAC/F,UAAM,OAAO,WAAW,QAAQ,CAAC;AAEjC,mBAAe,KAAK;AAAA,MAClB,MAAM,WAAW;AAAA,MACjB,SAAS,WAAW,WAAW,CAAC;AAAA,MAChC,aAAa,KAAK,eAAe;AAAA,MACjC,qBAAqB,KAAK,uBAAuB;AAAA,MACjD,aAAa,KAAK,eAAe;AAAA,MACjC,OAAO,KAAK,SAAS;AAAA,MACrB,SAAS,KAAK,WAAW;AAAA,MACzB,kBAAkB,WAAW,oBAAoB;AAAA,MACjD,SAAS;AAAA,MACT,WAAW;AAAA,MACX,QAAQ,KAAK,UAAU;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;",
+  "names": []
+}

package/lib/esm/parse/context/cli-context-builder.js

@@ -1,2 +1,283 @@
-import{decoupleFlags,findOption,findSubcommandDefinition,isFlagArgument,isOptionArgument,transformOptionToArgument}from"../parser-utilities.js";function buildCliContext(o,e){const n=e.subcommands??[],t=new Set(n.flatMap(o=>[o.name,...o.aliases||[]]));o=decoupleFlags(o);const r={subcommand:void 0},i=()=>findSubcommandDefinition(r.subcommand,e);for(let e=0;e<o.length;e++){const n=o[e];if(0===e&&(r.subcommand=t.has(n)?n:void 0,r.subcommand))continue;const a=n.split("=").filter(Boolean),s=n.includes("="),u=a[0],p=a[1];if(isOptionArgument(u)){if(isFlagArgument(u)&&s)throw new Error(`flag arguments cannot be assigned using "=": "${n}"`);const t=i();if(!t)throw new Error(`unknown subcommand: "${r.subcommand}"`);if(!t.options){if(!r.subcommand)throw new Error(`options are not allowed here: "${u}"`);throw new Error(`subcommand "${r.subcommand}" does not accept options: "${u}"`)}const a=findOption(u,t.options);if(!a)throw new Error(`unknown option: "${u}"`);const[l,m]=a;if(r.options&&l in r.options)throw new Error(`duplicated option: "${u}"`);if(!m._preparedType)throw new Error(`internal error: missing prepared type for option "${l}"`);const{schema:c,optional:d,defaultValue:f,coerceTo:g}=m._preparedType,w=o[e+1];let h=s?p:w;if("boolean"===g){s||(h="true");u.startsWith("--no-")&&["true","false"].includes(h.toLowerCase())&&(h="true"===h?"false":"true")}if(void 0===h)throw new Error(`expected a value for "${u}" but got nothing`);if(!s&&isOptionArgument(h))throw new Error(`expected a value for "${u}" but got an argument "${w}"`);r.options??(r.options={}),r.options[l]={schema:c,optional:d,defaultValue:f,flag:u,stringValue:h,source:"terminal"},s||"boolean"===g||e++;continue}const l=i();if(l?.arguments){r.arguments??(r.arguments={});const o=Object.keys(r.arguments).length,e=Object.entries(l.arguments);if(o<e.length){const[t,i]=e[o];if(!i._preparedType)throw new Error(`internal error: missing prepared type for argument "${o}"`);const{schema:a,optional:s,defaultValue:u}=i._preparedType;r.arguments[t]={schema:a,optional:s,defaultValue:u,stringValue:n,source:"terminal"};continue}}if(!l?.allowPositionals){if(!r.subcommand)throw new Error(`unexpected argument "${n}": positionals arguments are not allowed here`);throw new Error(`unexpected argument "${n}": positionals arguments are not allowed for subcommand "${r.subcommand}"`)}r.positionals??(r.positionals=[]),r.positionals.push(n)}const a=i();if(!a)throw new Error(`unknown subcommand: "${r.subcommand}"`);if(a.options){r.options??(r.options={});for(const[o,e]of Object.entries(a.options)){if(o in r.options)continue;if(!e._preparedType)throw new Error(`internal error: missing prepared type for option "${o}"`);const{schema:n,optional:t,defaultValue:i}=e._preparedType;if(!t)throw new Error(`missing required option: ${transformOptionToArgument(o)}`);void 0!==i&&(r.options[o]={schema:n,optional:t,defaultValue:i,source:"default"})}}if(a.arguments){r.arguments??(r.arguments={});const o=Object.keys(r.arguments).length,e=Object.entries(a.arguments),n=e.length;if(o<n)for(let t=o;t<n;t++){const[o,n]=e[t];if(!n._preparedType)throw new Error(`internal error: missing prepared type for the argument "${o}"`);const{schema:i,optional:a,defaultValue:s}=n._preparedType;if(!a)throw new Error(`The argument "${o}" is required`);void 0!==s&&(r.arguments[o]={schema:i,optional:a,defaultValue:s,source:"default"})}}return a.allowPositionals&&(r.positionals??(r.positionals=[])),r}export{buildCliContext};
-//# sourceMappingURL=cli-context-builder.js.map
+// src/parse/context/cli-context-builder.ts
+import { CliError } from "../../cli-error/cli-error.js";
+import { ErrorCause } from "../../cli-error/error-cause.js";
+import { InternalErrorCode } from "../../cli-error/error-code/internal-error-code.js";
+import { ParseErrorCode } from "../../cli-error/error-code/parse-error-code.js";
+import {
+  decoupleFlags,
+  findOption,
+  findSubcommandDefinition,
+  isFlagArgument,
+  isOptionArgument,
+  splitAndGetKeys
+} from "../parser-utilities.js";
+function buildCliContext(argv, cliDefinition) {
+  const cliName = cliDefinition.cliName;
+  const subcommandArray = cliDefinition.subcommands ?? [];
+  const allSubcommands = new Set(subcommandArray.flatMap((c) => [c.name, ...c.aliases || []]));
+  argv = decoupleFlags(argv);
+  const context = {
+    subcommand: void 0
+  };
+  const getCommandDefinition = () => findSubcommandDefinition(context.subcommand, cliDefinition);
+  for (let index = 0; index < argv.length; index++) {
+    const argvItem = argv[index];
+    if (index === 0) {
+      context.subcommand = allSubcommands.has(argvItem) ? argvItem : void 0;
+      if (context.subcommand) continue;
+    }
+    const argumentAndValue = argvItem.split("=").filter(Boolean);
+    const argumentWithEquals = argvItem.includes("=");
+    const [argument, keys] = splitAndGetKeys(argumentAndValue[0]);
+    const optionWithKeys = keys.length > 0;
+    const argumentValue = argumentAndValue[1];
+    const isNegated = argument.startsWith("--no-");
+    if (isOptionArgument(argument)) {
+      const commandDefinition3 = getCommandDefinition();
+      const commandKind = context.subcommand === void 0 ? "command" : "subcommand";
+      const commandName = context.subcommand ?? cliName;
+      if (isFlagArgument(argument) && argumentWithEquals) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.FlagAssignedValue,
+          context: { commandKind, commandName, flag: argument, value: argumentValue }
+        });
+      }
+      if (!commandDefinition3) {
+        if (context.subcommand === void 0) {
+          throw new CliError({
+            cause: ErrorCause.Internal,
+            code: InternalErrorCode.CannotFindCliDefinition,
+            context: { cliName }
+          });
+        }
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.UnknownSubcommand,
+          context: { commandName }
+        });
+      }
+      if (!commandDefinition3.options) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.CommandWithoutOptions,
+          context: { commandKind, commandName, optionName: argument }
+        });
+      }
+      const nameOptionTuple = findOption(argument, commandDefinition3.options);
+      if (!nameOptionTuple) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.UnknownOption,
+          context: { commandKind, commandName, optionName: argument }
+        });
+      }
+      const [optionName, optionDefinition] = nameOptionTuple;
+      if (!optionWithKeys && context.options && optionName in context.options) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.DuplicateOptionProvided,
+          context: { commandKind, commandName, optionName }
+        });
+      }
+      if (!optionDefinition._preparedType) {
+        throw new CliError({
+          cause: ErrorCause.Internal,
+          code: InternalErrorCode.MissingPreparedTypes,
+          context: { commandKind, commandName, kind: "option", name: optionName }
+        });
+      }
+      const { schema, optional, defaultValue, coerceTo } = optionDefinition._preparedType;
+      const nextArgument = argv[index + 1];
+      let optionValue = argumentWithEquals ? argumentValue : nextArgument;
+      const isBoolean = coerceTo === "boolean";
+      if (isNegated && !isBoolean) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.InvalidNegationForNonBooleanOption,
+          context: { commandKind, commandName, optionName }
+        });
+      }
+      if (isBoolean) {
+        if (!argumentWithEquals) {
+          optionValue = "true";
+        }
+        if (isNegated && ["true", "false"].includes(optionValue.toLowerCase())) {
+          optionValue = optionValue === "true" ? "false" : "true";
+        }
+      }
+      if (optionValue === void 0 || !argumentWithEquals && isOptionArgument(optionValue)) {
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.OptionMissingValue,
+          context: { commandKind, commandName, optionName }
+        });
+      }
+      context.options ??= {};
+      if (optionWithKeys) {
+        const previousObject = JSON.parse(context.options[optionName]?.stringValue || "{}");
+        let current = previousObject;
+        for (let index2 = 0; index2 < keys.length; index2++) {
+          const key = keys[index2];
+          if (current[key] === void 0) {
+            current[key] = {};
+          }
+          if (index2 === keys.length - 1) {
+            current[key] = optionValue;
+            continue;
+          }
+          current = current[key];
+        }
+        optionValue = JSON.stringify(previousObject);
+      }
+      context.options[optionName] = {
+        schema,
+        optional,
+        defaultValue,
+        flag: argument,
+        stringValue: optionValue,
+        source: "terminal"
+      };
+      if (!argumentWithEquals && !isBoolean) {
+        index++;
+      }
+      continue;
+    }
+    const commandDefinition2 = getCommandDefinition();
+    if (commandDefinition2?.arguments) {
+      context.arguments ??= {};
+      const currentArgumentCount = Object.keys(context.arguments).length;
+      const argumentDefinitionEntries = Object.entries(commandDefinition2.arguments);
+      if (currentArgumentCount < argumentDefinitionEntries.length) {
+        const [name, argumentDefinition] = argumentDefinitionEntries[currentArgumentCount];
+        if (!argumentDefinition._preparedType) {
+          throw new CliError({
+            cause: ErrorCause.Internal,
+            code: InternalErrorCode.MissingPreparedTypes,
+            context: {
+              commandKind: context.subcommand ? "subcommand" : "command",
+              commandName: context.subcommand ?? cliName,
+              kind: "argument",
+              name
+            }
+          });
+        }
+        const { schema, optional, defaultValue } = argumentDefinition._preparedType;
+        context.arguments[name] = { schema, optional, defaultValue, stringValue: argvItem, source: "terminal" };
+        continue;
+      }
+    }
+    if (commandDefinition2?.allowPositionals) {
+      context.positionals ??= [];
+      context.positionals.push(argvItem);
+      continue;
+    }
+    throw new CliError({
+      cause: ErrorCause.Parse,
+      code: ParseErrorCode.PositionalArgumentNotAllowed,
+      context: {
+        commandKind: context.subcommand ? "subcommand" : "command",
+        commandName: context.subcommand ?? cliName,
+        argumentName: argvItem
+      }
+    });
+  }
+  const commandDefinition = getCommandDefinition();
+  if (!commandDefinition) {
+    if (context.subcommand === void 0) {
+      throw new CliError({
+        cause: ErrorCause.Internal,
+        code: InternalErrorCode.CannotFindCliDefinition,
+        context: { cliName }
+      });
+    }
+    throw new CliError({
+      cause: ErrorCause.Parse,
+      code: ParseErrorCode.UnknownSubcommand,
+      context: { commandName: context.subcommand ?? cliName }
+    });
+  }
+  if (commandDefinition.options) {
+    context.options ??= {};
+    for (const [name, optionDefinition] of Object.entries(commandDefinition.options)) {
+      if (name in context.options) continue;
+      if (!optionDefinition._preparedType) {
+        throw new CliError({
+          cause: ErrorCause.Internal,
+          code: InternalErrorCode.MissingPreparedTypes,
+          context: {
+            commandKind: context.subcommand ? "subcommand" : "command",
+            commandName: context.subcommand ?? cliName,
+            kind: "option",
+            name
+          }
+        });
+      }
+      const { schema, optional, defaultValue } = optionDefinition._preparedType;
+      if (optional) {
+        if (defaultValue === void 0) {
+          continue;
+        }
+        context.options[name] = { schema, optional, defaultValue, source: "default" };
+        continue;
+      }
+      throw new CliError({
+        cause: ErrorCause.Parse,
+        code: ParseErrorCode.MissingRequiredOption,
+        context: {
+          commandKind: context.subcommand ? "subcommand" : "command",
+          commandName: context.subcommand ?? cliName,
+          optionName: name
+        }
+      });
+    }
+  }
+  if (commandDefinition.arguments) {
+    context.arguments ??= {};
+    const currentArgumentCount = Object.keys(context.arguments).length;
+    const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);
+    const argumentsDefinitionLength = argumentDefinitionEntries.length;
+    if (currentArgumentCount < argumentsDefinitionLength) {
+      for (let index = currentArgumentCount; index < argumentsDefinitionLength; index++) {
+        const [name, argumentDefinition] = argumentDefinitionEntries[index];
+        if (!argumentDefinition._preparedType) {
+          throw new CliError({
+            cause: ErrorCause.Internal,
+            code: InternalErrorCode.MissingPreparedTypes,
+            context: {
+              commandKind: context.subcommand ? "subcommand" : "command",
+              commandName: context.subcommand ?? cliName,
+              kind: "argument",
+              name
+            }
+          });
+        }
+        const { schema, optional, defaultValue } = argumentDefinition._preparedType;
+        if (optional) {
+          if (defaultValue === void 0) {
+            continue;
+          }
+          context.arguments[name] = { schema, optional, defaultValue, source: "default" };
+          continue;
+        }
+        throw new CliError({
+          cause: ErrorCause.Parse,
+          code: ParseErrorCode.MissingRequiredArgument,
+          context: {
+            commandKind: context.subcommand ? "subcommand" : "command",
+            commandName: context.subcommand ?? cliName,
+            argumentName: name
+          }
+        });
+      }
+    }
+  }
+  if (commandDefinition.allowPositionals) {
+    context.positionals ??= [];
+  }
+  return context;
+}
+export {
+  buildCliContext
+};
+//# sourceMappingURL=cli-context-builder.js.map

package/lib/esm/parse/context/cli-context-builder.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["decoupleFlags","findOption","findSubcommandDefinition","isFlagArgument","isOptionArgument","transformOptionToArgument","buildCliContext","argv","cliDefinition","subcommandArray","subcommands","allSubcommands","Set","flatMap","c","name","aliases","context","subcommand","getCommandDefinition","index","length","argvItem","has","argumentAndValue","split","filter","Boolean","argumentWithEquals","includes","argument","argumentValue","Error","commandDefinition","options","nameOptionTuple","optionName","optionDefinition","_preparedType","schema","optional","defaultValue","coerceTo","nextArgument","optionValue","startsWith","toLowerCase","flag","stringValue","source","arguments","currentArgumentCount","Object","keys","argumentDefinitionEntries","entries","argumentDefinition","allowPositionals","positionals","push","argumentsDefinitionLength"],"sources":["../../../../src/parse/context/cli-context-builder.ts"],"sourcesContent":["import {\n  decoupleFlags,\n  findOption,\n  findSubcommandDefinition,\n  isFlagArgument,\n  isOptionArgument,\n  transformOptionToArgument,\n} from \"../parser-utilities.ts\";\n\nimport type { ContextWide } from \"../../types/context-types.ts\";\nimport type { Cli } from \"../../types/definitions-types.ts\";\n\n/**\n * Parse argv and create a cli context\n *\n * @throws {Error}\n */\nexport function buildCliContext(argv: string[], cliDefinition: Cli) {\n  const subcommandArray = cliDefinition.subcommands ?? [];\n  const allSubcommands = new Set<string>(subcommandArray.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argv = decoupleFlags(argv);\n\n  const context: ContextWide = {\n    subcommand: undefined,\n  };\n\n  /** Get the current subcommand definition or cli definition if subcommand name is `undefined` object */\n  const getCommandDefinition = () => findSubcommandDefinition(context.subcommand, cliDefinition);\n\n  for (let index = 0; index < argv.length; index++) {\n    const argvItem = argv[index];\n\n    // * Subcommand check\n    if (index === 0) {\n      context.subcommand = allSubcommands.has(argvItem) ? argvItem : undefined;\n\n      // First argument is a subcommand. Skip to the next argument\n      if (context.subcommand) continue;\n    }\n\n    // * Option check\n\n    const argumentAndValue = argvItem.split(\"=\").filter(Boolean); // E.g --option=value -> [\"--option\", \"value\"]\n    const argumentWithEquals = argvItem.includes(\"=\"); // E.g --option=value\n    const argument = argumentAndValue[0];\n    const argumentValue: string | undefined = argumentAndValue[1];\n\n    if (isOptionArgument(argument)) {\n      if (isFlagArgument(argument) && argumentWithEquals) {\n        throw new Error(`flag arguments cannot be assigned using \"=\": \"${argvItem}\"`);\n      }\n\n      const commandDefinition = getCommandDefinition();\n      if (!commandDefinition) {\n        throw new Error(`unknown subcommand: \"${context.subcommand}\"`);\n      }\n\n      if (!commandDefinition.options) {\n        if (!context.subcommand) {\n          throw new Error(`options are not allowed here: \"${argument}\"`);\n        }\n\n        throw new Error(`subcommand \"${context.subcommand}\" does not accept options: \"${argument}\"`);\n      }\n\n      const nameOptionTuple = findOption(argument, commandDefinition.options);\n      if (!nameOptionTuple) {\n        throw new Error(`unknown option: \"${argument}\"`);\n      }\n\n      const [optionName, optionDefinition] = nameOptionTuple;\n\n      if (context.options && optionName in context.options) {\n        throw new Error(`duplicated option: \"${argument}\"`);\n      }\n\n      if (!optionDefinition._preparedType) {\n        throw new Error(`internal error: missing prepared type for option \"${optionName}\"`);\n      }\n\n      const { schema, optional, defaultValue, coerceTo } = optionDefinition._preparedType;\n\n      const nextArgument = argv[index + 1];\n\n      let optionValue: string | boolean = argumentWithEquals ? argumentValue : nextArgument;\n\n      // infer value for boolean options\n      if (coerceTo === \"boolean\") {\n        if (!argumentWithEquals) {\n          optionValue = \"true\";\n        }\n\n        const isNegated = argument.startsWith(\"--no-\");\n\n        if (isNegated && [\"true\", \"false\"].includes(optionValue.toLowerCase())) {\n          optionValue = optionValue === \"true\" ? \"false\" : \"true\";\n        }\n      }\n\n      if (optionValue === undefined) {\n        throw new Error(`expected a value for \"${argument}\" but got nothing`);\n      }\n\n      if (!argumentWithEquals && isOptionArgument(optionValue)) {\n        throw new Error(`expected a value for \"${argument}\" but got an argument \"${nextArgument}\"`);\n      }\n\n      context.options ??= {};\n      context.options[optionName] = {\n        schema,\n        optional,\n        defaultValue,\n        flag: argument,\n        stringValue: optionValue,\n        source: \"terminal\",\n      };\n\n      // Skip to the next argument if it is the current option's value.\n      if (!argumentWithEquals && coerceTo !== \"boolean\") {\n        index++;\n      }\n\n      continue;\n    }\n\n    const commandDefinition = getCommandDefinition();\n\n    // * Arguments check\n    if (commandDefinition?.arguments) {\n      context.arguments ??= {};\n\n      const currentArgumentCount = Object.keys(context.arguments).length;\n      const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n\n      // The current argument is a typed argument and not a positional\n      if (currentArgumentCount < argumentDefinitionEntries.length) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[currentArgumentCount];\n\n        if (!argumentDefinition._preparedType) {\n          throw new Error(`internal error: missing prepared type for argument \"${currentArgumentCount}\"`);\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        context.arguments[name] = { schema, optional, defaultValue, stringValue: argvItem, source: \"terminal\" };\n        continue;\n      }\n    }\n\n    // The current argument is a positional and not a typed argument (when `allowPositionals` is enabled)\n    if (commandDefinition?.allowPositionals) {\n      context.positionals ??= [];\n      context.positionals.push(argvItem);\n      continue;\n    }\n\n    if (!context.subcommand) {\n      throw new Error(`unexpected argument \"${argvItem}\": positionals arguments are not allowed here`);\n    }\n\n    throw new Error(\n      `unexpected argument \"${argvItem}\": positionals arguments are not allowed for subcommand \"${context.subcommand}\"`,\n    );\n  }\n\n  const commandDefinition = getCommandDefinition();\n  if (!commandDefinition) {\n    throw new Error(`unknown subcommand: \"${context.subcommand}\"`);\n  }\n\n  // Options\n  if (commandDefinition.options) {\n    context.options ??= {};\n\n    for (const [name, optionDefinition] of Object.entries(commandDefinition.options)) {\n      // option already added to the context (found during argument parsing)\n      if (name in context.options) continue;\n\n      if (!optionDefinition._preparedType) {\n        throw new Error(`internal error: missing prepared type for option \"${name}\"`);\n      }\n\n      const { schema, optional, defaultValue } = optionDefinition._preparedType;\n\n      if (optional) {\n        // optional without default value\n        if (defaultValue === undefined) {\n          continue;\n        }\n\n        // optional with default value\n        context.options[name] = { schema, optional, defaultValue, source: \"default\" };\n        continue;\n      }\n\n      // required option\n      throw new Error(`missing required option: ${transformOptionToArgument(name)}`);\n    }\n  }\n\n  // Arguments\n  if (commandDefinition.arguments) {\n    context.arguments ??= {};\n\n    const currentArgumentCount = Object.keys(context.arguments).length;\n\n    const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n    const argumentsDefinitionLength = argumentDefinitionEntries.length;\n\n    // missing arguments\n    if (currentArgumentCount < argumentsDefinitionLength) {\n      for (let index = currentArgumentCount; index < argumentsDefinitionLength; index++) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[index];\n\n        if (!argumentDefinition._preparedType) {\n          throw new Error(`internal error: missing prepared type for the argument \"${name}\"`);\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        if (optional) {\n          // optional argument without default value\n          if (defaultValue === undefined) {\n            continue;\n          }\n\n          // optional argument with default value\n          context.arguments[name] = { schema, optional, defaultValue, source: \"default\" };\n          continue;\n        }\n\n        // required argument\n        throw new Error(`The argument \"${name}\" is required`);\n      }\n    }\n  }\n\n  // make sure `positionals` is defined when `allowPositionals` is enabled\n  if (commandDefinition.allowPositionals) {\n    context.positionals ??= [];\n  }\n\n  return context;\n}\n"],"mappings":"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","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../../src/parse/context/cli-context-builder.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 { ParseErrorCode } from \"../../cli-error/error-code/parse-error-code.ts\";\nimport {\n  decoupleFlags,\n  findOption,\n  findSubcommandDefinition,\n  isFlagArgument,\n  isOptionArgument,\n  splitAndGetKeys,\n} from \"../parser-utilities.ts\";\n\nimport type { ContextWide } from \"../../types/context-types.ts\";\nimport type { Cli } from \"../../types/definitions-types.ts\";\n\n/**\n * Parse argv and create a cli context\n *\n * @throws {CliError}\n */\nexport function buildCliContext(argv: string[], cliDefinition: Cli) {\n  const cliName = cliDefinition.cliName;\n  const subcommandArray = cliDefinition.subcommands ?? [];\n  const allSubcommands = new Set<string>(subcommandArray.flatMap(c => [c.name, ...(c.aliases || [])]));\n\n  // decouple flags E.g. `-rf` -> `-r, -f`\n  argv = decoupleFlags(argv);\n\n  const context: ContextWide = {\n    subcommand: undefined,\n  };\n\n  /** Get the current subcommand definition or cli definition if subcommand name is `undefined` object */\n  const getCommandDefinition = () => findSubcommandDefinition(context.subcommand, cliDefinition);\n\n  for (let index = 0; index < argv.length; index++) {\n    const argvItem = argv[index];\n\n    // * Subcommand check\n    if (index === 0) {\n      context.subcommand = allSubcommands.has(argvItem) ? argvItem : undefined;\n\n      // First argument is a subcommand. Skip to the next argument\n      if (context.subcommand) continue;\n    }\n\n    // * Option check\n\n    const argumentAndValue = argvItem.split(\"=\").filter(Boolean); // E.g --option=value -> [\"--option\", \"value\"]\n    const argumentWithEquals = argvItem.includes(\"=\"); // E.g --option=value\n    const [argument, keys] = splitAndGetKeys(argumentAndValue[0]); // E.g --option.foo.bar -> [\"--option\", [\"foo\", \"bar\"]]\n    const optionWithKeys = keys.length > 0; // E.g --option.foo.bar\n    const argumentValue: string | undefined = argumentAndValue[1];\n    const isNegated = argument.startsWith(\"--no-\");\n\n    if (isOptionArgument(argument)) {\n      const commandDefinition = getCommandDefinition();\n      const commandKind = context.subcommand === undefined ? \"command\" : \"subcommand\";\n      const commandName = context.subcommand ?? cliName;\n\n      if (isFlagArgument(argument) && argumentWithEquals) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.FlagAssignedValue,\n          context: { commandKind, commandName, flag: argument, value: argumentValue },\n        });\n      }\n\n      if (!commandDefinition) {\n        if (context.subcommand === undefined) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.CannotFindCliDefinition,\n            context: { cliName },\n          });\n        }\n\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownSubcommand,\n          context: { commandName },\n        });\n      }\n\n      if (!commandDefinition.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.CommandWithoutOptions,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const nameOptionTuple = findOption(argument, commandDefinition.options);\n      if (!nameOptionTuple) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.UnknownOption,\n          context: { commandKind, commandName, optionName: argument },\n        });\n      }\n\n      const [optionName, optionDefinition] = nameOptionTuple;\n\n      if (!optionWithKeys && context.options && optionName in context.options) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.DuplicateOptionProvided,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      if (!optionDefinition._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 { schema, optional, defaultValue, coerceTo } = optionDefinition._preparedType;\n\n      const nextArgument = argv[index + 1];\n\n      let optionValue: string | boolean | undefined = argumentWithEquals ? argumentValue : nextArgument;\n\n      const isBoolean = coerceTo === \"boolean\";\n\n      if (isNegated && !isBoolean) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.InvalidNegationForNonBooleanOption,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      // infer value for boolean options\n      if (isBoolean) {\n        if (!argumentWithEquals) {\n          optionValue = \"true\";\n        }\n\n        if (isNegated && [\"true\", \"false\"].includes(optionValue.toLowerCase())) {\n          optionValue = optionValue === \"true\" ? \"false\" : \"true\";\n        }\n      }\n\n      if (optionValue === undefined || (!argumentWithEquals && isOptionArgument(optionValue))) {\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.OptionMissingValue,\n          context: { commandKind, commandName, optionName },\n        });\n      }\n\n      context.options ??= {};\n\n      // Handle options with keys for type `object`\n      // E.g. `--option.key.nested=value`\n      if (optionWithKeys) {\n        const previousObject = JSON.parse(context.options[optionName]?.stringValue || \"{}\") as Record<string, any>;\n\n        let current = previousObject;\n        for (let index = 0; index < keys.length; index++) {\n          const key = keys[index];\n\n          if (current[key] === undefined) {\n            current[key] = {};\n          }\n\n          if (index === keys.length - 1) {\n            current[key] = optionValue;\n            continue;\n          }\n\n          current = current[key] as Record<string, any>;\n        }\n\n        optionValue = JSON.stringify(previousObject);\n      }\n\n      context.options[optionName] = {\n        schema,\n        optional,\n        defaultValue,\n        flag: argument,\n        stringValue: optionValue,\n        source: \"terminal\",\n      };\n\n      // Skip to the next argument if it is the current option's value.\n      if (!argumentWithEquals && !isBoolean) {\n        index++;\n      }\n\n      continue;\n    }\n\n    const commandDefinition = getCommandDefinition();\n\n    // * Arguments check\n    if (commandDefinition?.arguments) {\n      context.arguments ??= {};\n\n      const currentArgumentCount = Object.keys(context.arguments).length;\n      const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n\n      // The current argument is a typed argument and not a positional\n      if (currentArgumentCount < argumentDefinitionEntries.length) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[currentArgumentCount];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        context.arguments[name] = { schema, optional, defaultValue, stringValue: argvItem, source: \"terminal\" };\n        continue;\n      }\n    }\n\n    // The current argument is a positional and not a typed argument (when `allowPositionals` is enabled)\n    if (commandDefinition?.allowPositionals) {\n      context.positionals ??= [];\n      context.positionals.push(argvItem);\n      continue;\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.PositionalArgumentNotAllowed,\n      context: {\n        commandKind: context.subcommand ? \"subcommand\" : \"command\",\n        commandName: context.subcommand ?? cliName,\n        argumentName: argvItem,\n      },\n    });\n  }\n\n  const commandDefinition = getCommandDefinition();\n  if (!commandDefinition) {\n    if (context.subcommand === undefined) {\n      throw new CliError({\n        cause: ErrorCause.Internal,\n        code: InternalErrorCode.CannotFindCliDefinition,\n        context: { cliName },\n      });\n    }\n\n    throw new CliError({\n      cause: ErrorCause.Parse,\n      code: ParseErrorCode.UnknownSubcommand,\n      context: { commandName: context.subcommand ?? cliName },\n    });\n  }\n\n  // Options\n  if (commandDefinition.options) {\n    context.options ??= {};\n\n    for (const [name, optionDefinition] of Object.entries(commandDefinition.options)) {\n      // option already added to the context (found during argument parsing)\n      if (name in context.options) continue;\n\n      if (!optionDefinition._preparedType) {\n        throw new CliError({\n          cause: ErrorCause.Internal,\n          code: InternalErrorCode.MissingPreparedTypes,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            kind: \"option\",\n            name,\n          },\n        });\n      }\n\n      const { schema, optional, defaultValue } = optionDefinition._preparedType;\n\n      if (optional) {\n        // optional without default value\n        if (defaultValue === undefined) {\n          continue;\n        }\n\n        // optional with default value\n        context.options[name] = { schema, optional, defaultValue, source: \"default\" };\n        continue;\n      }\n\n      throw new CliError({\n        cause: ErrorCause.Parse,\n        code: ParseErrorCode.MissingRequiredOption,\n        context: {\n          commandKind: context.subcommand ? \"subcommand\" : \"command\",\n          commandName: context.subcommand ?? cliName,\n          optionName: name,\n        },\n      });\n    }\n  }\n\n  // Arguments\n  if (commandDefinition.arguments) {\n    context.arguments ??= {};\n\n    const currentArgumentCount = Object.keys(context.arguments).length;\n\n    const argumentDefinitionEntries = Object.entries(commandDefinition.arguments);\n    const argumentsDefinitionLength = argumentDefinitionEntries.length;\n\n    // missing arguments\n    if (currentArgumentCount < argumentsDefinitionLength) {\n      for (let index = currentArgumentCount; index < argumentsDefinitionLength; index++) {\n        const [name, argumentDefinition] = argumentDefinitionEntries[index];\n\n        if (!argumentDefinition._preparedType) {\n          throw new CliError({\n            cause: ErrorCause.Internal,\n            code: InternalErrorCode.MissingPreparedTypes,\n            context: {\n              commandKind: context.subcommand ? \"subcommand\" : \"command\",\n              commandName: context.subcommand ?? cliName,\n              kind: \"argument\",\n              name,\n            },\n          });\n        }\n\n        const { schema, optional, defaultValue } = argumentDefinition._preparedType;\n\n        if (optional) {\n          // optional argument without default value\n          if (defaultValue === undefined) {\n            continue;\n          }\n\n          // optional argument with default value\n          context.arguments[name] = { schema, optional, defaultValue, source: \"default\" };\n          continue;\n        }\n\n        // required argument\n        throw new CliError({\n          cause: ErrorCause.Parse,\n          code: ParseErrorCode.MissingRequiredArgument,\n          context: {\n            commandKind: context.subcommand ? \"subcommand\" : \"command\",\n            commandName: context.subcommand ?? cliName,\n            argumentName: name,\n          },\n        });\n      }\n    }\n  }\n\n  // make sure `positionals` is defined when `allowPositionals` is enabled\n  if (commandDefinition.allowPositionals) {\n    context.positionals ??= [];\n  }\n\n  return context;\n}\n"],
+  "mappings": ";AAAA,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,yBAAyB;AAClC,SAAS,sBAAsB;AAC/B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUA,SAAS,gBAAgB,MAAgB,eAAoB;AAClE,QAAM,UAAU,cAAc;AAC9B,QAAM,kBAAkB,cAAc,eAAe,CAAC;AACtD,QAAM,iBAAiB,IAAI,IAAY,gBAAgB,QAAQ,OAAK,CAAC,EAAE,MAAM,GAAI,EAAE,WAAW,CAAC,CAAE,CAAC,CAAC;AAGnG,SAAO,cAAc,IAAI;AAEzB,QAAM,UAAuB;AAAA,IAC3B,YAAY;AAAA,EACd;AAGA,QAAM,uBAAuB,MAAM,yBAAyB,QAAQ,YAAY,aAAa;AAE7F,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS;AAChD,UAAM,WAAW,KAAK,KAAK;AAG3B,QAAI,UAAU,GAAG;AACf,cAAQ,aAAa,eAAe,IAAI,QAAQ,IAAI,WAAW;AAG/D,UAAI,QAAQ,WAAY;AAAA,IAC1B;AAIA,UAAM,mBAAmB,SAAS,MAAM,GAAG,EAAE,OAAO,OAAO;AAC3D,UAAM,qBAAqB,SAAS,SAAS,GAAG;AAChD,UAAM,CAAC,UAAU,IAAI,IAAI,gBAAgB,iBAAiB,CAAC,CAAC;AAC5D,UAAM,iBAAiB,KAAK,SAAS;AACrC,UAAM,gBAAoC,iBAAiB,CAAC;AAC5D,UAAM,YAAY,SAAS,WAAW,OAAO;AAE7C,QAAI,iBAAiB,QAAQ,GAAG;AAC9B,YAAMA,qBAAoB,qBAAqB;AAC/C,YAAM,cAAc,QAAQ,eAAe,SAAY,YAAY;AACnE,YAAM,cAAc,QAAQ,cAAc;AAE1C,UAAI,eAAe,QAAQ,KAAK,oBAAoB;AAClD,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,MAAM,UAAU,OAAO,cAAc;AAAA,QAC5E,CAAC;AAAA,MACH;AAEA,UAAI,CAACA,oBAAmB;AACtB,YAAI,QAAQ,eAAe,QAAW;AACpC,gBAAM,IAAI,SAAS;AAAA,YACjB,OAAO,WAAW;AAAA,YAClB,MAAM,kBAAkB;AAAA,YACxB,SAAS,EAAE,QAAQ;AAAA,UACrB,CAAC;AAAA,QACH;AAEA,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,YAAY;AAAA,QACzB,CAAC;AAAA,MACH;AAEA,UAAI,CAACA,mBAAkB,SAAS;AAC9B,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,YAAY,SAAS;AAAA,QAC5D,CAAC;AAAA,MACH;AAEA,YAAM,kBAAkB,WAAW,UAAUA,mBAAkB,OAAO;AACtE,UAAI,CAAC,iBAAiB;AACpB,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,YAAY,SAAS;AAAA,QAC5D,CAAC;AAAA,MACH;AAEA,YAAM,CAAC,YAAY,gBAAgB,IAAI;AAEvC,UAAI,CAAC,kBAAkB,QAAQ,WAAW,cAAc,QAAQ,SAAS;AACvE,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,WAAW;AAAA,QAClD,CAAC;AAAA,MACH;AAEA,UAAI,CAAC,iBAAiB,eAAe;AACnC,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,kBAAkB;AAAA,UACxB,SAAS,EAAE,aAAa,aAAa,MAAM,UAAU,MAAM,WAAW;AAAA,QACxE,CAAC;AAAA,MACH;AAEA,YAAM,EAAE,QAAQ,UAAU,cAAc,SAAS,IAAI,iBAAiB;AAEtE,YAAM,eAAe,KAAK,QAAQ,CAAC;AAEnC,UAAI,cAA4C,qBAAqB,gBAAgB;AAErF,YAAM,YAAY,aAAa;AAE/B,UAAI,aAAa,CAAC,WAAW;AAC3B,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,WAAW;AAAA,QAClD,CAAC;AAAA,MACH;AAGA,UAAI,WAAW;AACb,YAAI,CAAC,oBAAoB;AACvB,wBAAc;AAAA,QAChB;AAEA,YAAI,aAAa,CAAC,QAAQ,OAAO,EAAE,SAAS,YAAY,YAAY,CAAC,GAAG;AACtE,wBAAc,gBAAgB,SAAS,UAAU;AAAA,QACnD;AAAA,MACF;AAEA,UAAI,gBAAgB,UAAc,CAAC,sBAAsB,iBAAiB,WAAW,GAAI;AACvF,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS,EAAE,aAAa,aAAa,WAAW;AAAA,QAClD,CAAC;AAAA,MACH;AAEA,cAAQ,YAAY,CAAC;AAIrB,UAAI,gBAAgB;AAClB,cAAM,iBAAiB,KAAK,MAAM,QAAQ,QAAQ,UAAU,GAAG,eAAe,IAAI;AAElF,YAAI,UAAU;AACd,iBAASC,SAAQ,GAAGA,SAAQ,KAAK,QAAQA,UAAS;AAChD,gBAAM,MAAM,KAAKA,MAAK;AAEtB,cAAI,QAAQ,GAAG,MAAM,QAAW;AAC9B,oBAAQ,GAAG,IAAI,CAAC;AAAA,UAClB;AAEA,cAAIA,WAAU,KAAK,SAAS,GAAG;AAC7B,oBAAQ,GAAG,IAAI;AACf;AAAA,UACF;AAEA,oBAAU,QAAQ,GAAG;AAAA,QACvB;AAEA,sBAAc,KAAK,UAAU,cAAc;AAAA,MAC7C;AAEA,cAAQ,QAAQ,UAAU,IAAI;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,QACb,QAAQ;AAAA,MACV;AAGA,UAAI,CAAC,sBAAsB,CAAC,WAAW;AACrC;AAAA,MACF;AAEA;AAAA,IACF;AAEA,UAAMD,qBAAoB,qBAAqB;AAG/C,QAAIA,oBAAmB,WAAW;AAChC,cAAQ,cAAc,CAAC;AAEvB,YAAM,uBAAuB,OAAO,KAAK,QAAQ,SAAS,EAAE;AAC5D,YAAM,4BAA4B,OAAO,QAAQA,mBAAkB,SAAS;AAG5E,UAAI,uBAAuB,0BAA0B,QAAQ;AAC3D,cAAM,CAAC,MAAM,kBAAkB,IAAI,0BAA0B,oBAAoB;AAEjF,YAAI,CAAC,mBAAmB,eAAe;AACrC,gBAAM,IAAI,SAAS;AAAA,YACjB,OAAO,WAAW;AAAA,YAClB,MAAM,kBAAkB;AAAA,YACxB,SAAS;AAAA,cACP,aAAa,QAAQ,aAAa,eAAe;AAAA,cACjD,aAAa,QAAQ,cAAc;AAAA,cACnC,MAAM;AAAA,cACN;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAEA,cAAM,EAAE,QAAQ,UAAU,aAAa,IAAI,mBAAmB;AAE9D,gBAAQ,UAAU,IAAI,IAAI,EAAE,QAAQ,UAAU,cAAc,aAAa,UAAU,QAAQ,WAAW;AACtG;AAAA,MACF;AAAA,IACF;AAGA,QAAIA,oBAAmB,kBAAkB;AACvC,cAAQ,gBAAgB,CAAC;AACzB,cAAQ,YAAY,KAAK,QAAQ;AACjC;AAAA,IACF;AAEA,UAAM,IAAI,SAAS;AAAA,MACjB,OAAO,WAAW;AAAA,MAClB,MAAM,eAAe;AAAA,MACrB,SAAS;AAAA,QACP,aAAa,QAAQ,aAAa,eAAe;AAAA,QACjD,aAAa,QAAQ,cAAc;AAAA,QACnC,cAAc;AAAA,MAChB;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,oBAAoB,qBAAqB;AAC/C,MAAI,CAAC,mBAAmB;AACtB,QAAI,QAAQ,eAAe,QAAW;AACpC,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,kBAAkB;AAAA,QACxB,SAAS,EAAE,QAAQ;AAAA,MACrB,CAAC;AAAA,IACH;AAEA,UAAM,IAAI,SAAS;AAAA,MACjB,OAAO,WAAW;AAAA,MAClB,MAAM,eAAe;AAAA,MACrB,SAAS,EAAE,aAAa,QAAQ,cAAc,QAAQ;AAAA,IACxD,CAAC;AAAA,EACH;AAGA,MAAI,kBAAkB,SAAS;AAC7B,YAAQ,YAAY,CAAC;AAErB,eAAW,CAAC,MAAM,gBAAgB,KAAK,OAAO,QAAQ,kBAAkB,OAAO,GAAG;AAEhF,UAAI,QAAQ,QAAQ,QAAS;AAE7B,UAAI,CAAC,iBAAiB,eAAe;AACnC,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,kBAAkB;AAAA,UACxB,SAAS;AAAA,YACP,aAAa,QAAQ,aAAa,eAAe;AAAA,YACjD,aAAa,QAAQ,cAAc;AAAA,YACnC,MAAM;AAAA,YACN;AAAA,UACF;AAAA,QACF,CAAC;AAAA,MACH;AAEA,YAAM,EAAE,QAAQ,UAAU,aAAa,IAAI,iBAAiB;AAE5D,UAAI,UAAU;AAEZ,YAAI,iBAAiB,QAAW;AAC9B;AAAA,QACF;AAGA,gBAAQ,QAAQ,IAAI,IAAI,EAAE,QAAQ,UAAU,cAAc,QAAQ,UAAU;AAC5E;AAAA,MACF;AAEA,YAAM,IAAI,SAAS;AAAA,QACjB,OAAO,WAAW;AAAA,QAClB,MAAM,eAAe;AAAA,QACrB,SAAS;AAAA,UACP,aAAa,QAAQ,aAAa,eAAe;AAAA,UACjD,aAAa,QAAQ,cAAc;AAAA,UACnC,YAAY;AAAA,QACd;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAGA,MAAI,kBAAkB,WAAW;AAC/B,YAAQ,cAAc,CAAC;AAEvB,UAAM,uBAAuB,OAAO,KAAK,QAAQ,SAAS,EAAE;AAE5D,UAAM,4BAA4B,OAAO,QAAQ,kBAAkB,SAAS;AAC5E,UAAM,4BAA4B,0BAA0B;AAG5D,QAAI,uBAAuB,2BAA2B;AACpD,eAAS,QAAQ,sBAAsB,QAAQ,2BAA2B,SAAS;AACjF,cAAM,CAAC,MAAM,kBAAkB,IAAI,0BAA0B,KAAK;AAElE,YAAI,CAAC,mBAAmB,eAAe;AACrC,gBAAM,IAAI,SAAS;AAAA,YACjB,OAAO,WAAW;AAAA,YAClB,MAAM,kBAAkB;AAAA,YACxB,SAAS;AAAA,cACP,aAAa,QAAQ,aAAa,eAAe;AAAA,cACjD,aAAa,QAAQ,cAAc;AAAA,cACnC,MAAM;AAAA,cACN;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAEA,cAAM,EAAE,QAAQ,UAAU,aAAa,IAAI,mBAAmB;AAE9D,YAAI,UAAU;AAEZ,cAAI,iBAAiB,QAAW;AAC9B;AAAA,UACF;AAGA,kBAAQ,UAAU,IAAI,IAAI,EAAE,QAAQ,UAAU,cAAc,QAAQ,UAAU;AAC9E;AAAA,QACF;AAGA,cAAM,IAAI,SAAS;AAAA,UACjB,OAAO,WAAW;AAAA,UAClB,MAAM,eAAe;AAAA,UACrB,SAAS;AAAA,YACP,aAAa,QAAQ,aAAa,eAAe;AAAA,YACjD,aAAa,QAAQ,cAAc;AAAA,YACnC,cAAc;AAAA,UAChB;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,MAAI,kBAAkB,kBAAkB;AACtC,YAAQ,gBAAgB,CAAC;AAAA,EAC3B;AAEA,SAAO;AACT;",
+  "names": ["commandDefinition", "index"]
+}