@optique/core 0.9.0-dev.217 → 0.9.0-dev.225

package/dist/index.cjs

@@ -74,6 +74,7 @@ exports.tuple = require_constructs.tuple;
 exports.url = require_valueparser.url;
 exports.uuid = require_valueparser.uuid;
 exports.value = require_message.value;
+exports.valueSet = require_message.valueSet;
 exports.values = require_message.values;
 exports.withDefault = require_modifiers.withDefault;
 exports.zsh = require_completion.zsh;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonempty.cjs";
-import { Message, MessageFormatOptions, MessageTerm, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values } from "./message.cjs";
+import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.cjs";
 import { OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, normalizeUsage } from "./usage.cjs";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowDefaultOptions, formatDocPage } from "./doc.cjs";
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.cjs";
@@ -9,4 +9,4 @@ import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, Mode
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.cjs";
 import { RunError, RunOptions, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.cjs";
-export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };
+export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { NonEmptyString, ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
-import { Message, MessageFormatOptions, MessageTerm, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values } from "./message.js";
+import { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.js";
 import { OptionName, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, normalizeUsage } from "./usage.js";
 import { DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, ShowDefaultOptions, formatDocPage } from "./doc.js";
 import { ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, FloatOptions, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, StringOptions, UrlOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, choice, float, integer, isValueParser, locale, string, url, uuid } from "./valueparser.js";
@@ -9,4 +9,4 @@ import { CombineModes, DocState, InferMode, InferValue, Mode, ModeIterable, Mode
 import { ConditionalErrorOptions, ConditionalOptions, DuplicateOptionError, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, NoMatchContext, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, TupleOptions, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { ShellCompletion, bash, fish, nu, pwsh, zsh } from "./completion.js";
 import { RunError, RunOptions, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.js";
-export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };
+export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, ChoiceOptionsBase, ChoiceOptionsNumber, ChoiceOptionsString, CombineModes, CommandErrorOptions, CommandOptions, ConditionalErrorOptions, ConditionalOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, DuplicateOptionError, FlagErrorOptions, FlagOptions, FloatOptions, InferMode, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, MergeOptions, Message, MessageFormatOptions, MessageTerm, Mode, ModeIterable, ModeValue, MultipleErrorOptions, MultipleOptions, NoMatchContext, NonEmptyString, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, PassThroughFormat, PassThroughOptions, Result, RunError, RunOptions, RunParserError, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, TupleOptions, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, ValueSetOptions, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values } from "./message.js";
+import { commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values } from "./message.js";
 import { extractArgumentMetavars, extractCommandNames, extractOptionNames, formatUsage, formatUsageTerm, normalizeUsage } from "./usage.js";
 import { DuplicateOptionError, concat, conditional, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
 import { formatDocPage } from "./doc.js";
@@ -10,4 +10,4 @@ import { argument, command, constant, flag, option, passThrough } from "./primit
 import { getDocPage, getDocPageAsync, getDocPageSync, parse, parseAsync, parseSync, suggest, suggestAsync, suggestSync } from "./parser.js";
 import { RunError, RunParserError, run, runParser, runParserAsync, runParserSync } from "./facade.js";
 
-export { DuplicateOptionError, RunError, RunParserError, WithDefaultError, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, values, withDefault, zsh };
+export { DuplicateOptionError, RunError, RunParserError, WithDefaultError, argument, bash, choice, command, commandLine, concat, conditional, constant, ensureNonEmptyString, envVar, extractArgumentMetavars, extractCommandNames, extractOptionNames, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, getDocPageAsync, getDocPageSync, group, integer, isNonEmptyString, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, nu, object, option, optionName, optionNames, optional, or, parse, parseAsync, parseSync, passThrough, pwsh, run, runParser, runParserAsync, runParserSync, string, suggest, suggestAsync, suggestSync, text, tuple, url, uuid, value, valueSet, values, withDefault, zsh };

package/dist/message.cjs

@@ -140,6 +140,55 @@ function commandLine(commandLine$1) {
 	};
 }
 /**
+* Creates a {@link Message} for a formatted list of values using the
+* `Intl.ListFormat` API.  This is useful for displaying choice lists
+* in error messages with proper locale-aware formatting.
+*
+* Each value in the list becomes a separate value term, and the separators
+* (commas, "and", "or", etc.) become text terms.  This allows each value
+* to be styled independently while respecting the locale's list formatting
+* conventions.
+*
+* @example
+* ```typescript
+* // English conjunction (default): "error", "warn", and "info"
+* const msg1 = message`Expected one of ${valueSet(["error", "warn", "info"])}.`;
+*
+* // English disjunction: "error", "warn", or "info"
+* const msg2 = message`Expected ${
+*   valueSet(["error", "warn", "info"], { type: "disjunction" })
+* }.`;
+*
+* // Korean disjunction: "error", "warn" 또는 "info"
+* const msg3 = message`${
+*   valueSet(["error", "warn", "info"], { locale: "ko", type: "disjunction" })
+* } 중 하나여야 합니다.`;
+* ```
+*
+* @param values The list of values to format.
+* @param options Optional formatting options including locale and list type.
+* @returns A {@link Message} with alternating value and text terms.
+* @since 0.9.0
+*/
+function valueSet(values$1, options) {
+	if (values$1.length === 0) return [];
+	const formatter = new Intl.ListFormat(options?.locale, {
+		type: options?.type,
+		style: options?.style
+	});
+	const parts = formatter.formatToParts(values$1);
+	const result = [];
+	for (const part of parts) if (part.type === "element") result.push({
+		type: "value",
+		value: part.value
+	});
+	else result.push({
+		type: "text",
+		text: part.value
+	});
+	return result;
+}
+/**
 * Formats a {@link Message} into a human-readable string for
 * the terminal.
 * @param msg The message to format, which is an array of
@@ -276,4 +325,5 @@ exports.optionName = optionName;
 exports.optionNames = optionNames;
 exports.text = text;
 exports.value = value;
+exports.valueSet = valueSet;
 exports.values = values;

package/dist/message.d.cts

@@ -210,6 +210,71 @@ declare function envVar(envVar: string): MessageTerm;
  * @since 0.6.0
  */
 declare function commandLine(commandLine: string): MessageTerm;
+/**
+ * Options for the {@link valueSet} function.
+ * @since 0.9.0
+ */
+interface ValueSetOptions {
+  /**
+   * The locale(s) to use for list formatting.  Can be a BCP 47 language tag
+   * string, an array of language tags, an `Intl.Locale` object, or an array
+   * of `Intl.Locale` objects.  If not specified, the system default locale
+   * is used.
+   */
+  readonly locale?: string | readonly string[] | Intl.Locale | readonly Intl.Locale[];
+  /**
+   * The type of list to format:
+   *
+   * - `"conjunction"`: "A, B, and C" (default)
+   * - `"disjunction"`: "A, B, or C"
+   * - `"unit"`: "A, B, C"
+   *
+   * @default `"conjunction"`
+   */
+  readonly type?: "conjunction" | "disjunction" | "unit";
+  /**
+   * The style of the list formatting:
+   *
+   * - `"long"`: "A, B, and C" (default)
+   * - `"short"`: "A, B, & C"
+   * - `"narrow"`: "A, B, C"
+   *
+   * @default `"long"`
+   */
+  readonly style?: "long" | "short" | "narrow";
+}
+/**
+ * Creates a {@link Message} for a formatted list of values using the
+ * `Intl.ListFormat` API.  This is useful for displaying choice lists
+ * in error messages with proper locale-aware formatting.
+ *
+ * Each value in the list becomes a separate value term, and the separators
+ * (commas, "and", "or", etc.) become text terms.  This allows each value
+ * to be styled independently while respecting the locale's list formatting
+ * conventions.
+ *
+ * @example
+ * ```typescript
+ * // English conjunction (default): "error", "warn", and "info"
+ * const msg1 = message`Expected one of ${valueSet(["error", "warn", "info"])}.`;
+ *
+ * // English disjunction: "error", "warn", or "info"
+ * const msg2 = message`Expected ${
+ *   valueSet(["error", "warn", "info"], { type: "disjunction" })
+ * }.`;
+ *
+ * // Korean disjunction: "error", "warn" 또는 "info"
+ * const msg3 = message`${
+ *   valueSet(["error", "warn", "info"], { locale: "ko", type: "disjunction" })
+ * } 중 하나여야 합니다.`;
+ * ```
+ *
+ * @param values The list of values to format.
+ * @param options Optional formatting options including locale and list type.
+ * @returns A {@link Message} with alternating value and text terms.
+ * @since 0.9.0
+ */
+declare function valueSet(values: readonly string[], options?: ValueSetOptions): Message;
 /**
  * Options for the {@link formatMessage} function.
  */
@@ -258,4 +323,4 @@ interface MessageFormatOptions {
  */
 declare function formatMessage(msg: Message, options?: MessageFormatOptions): string;
 //#endregion
-export { Message, MessageFormatOptions, MessageTerm, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values };
+export { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values };

package/dist/message.d.ts

@@ -210,6 +210,71 @@ declare function envVar(envVar: string): MessageTerm;
  * @since 0.6.0
  */
 declare function commandLine(commandLine: string): MessageTerm;
+/**
+ * Options for the {@link valueSet} function.
+ * @since 0.9.0
+ */
+interface ValueSetOptions {
+  /**
+   * The locale(s) to use for list formatting.  Can be a BCP 47 language tag
+   * string, an array of language tags, an `Intl.Locale` object, or an array
+   * of `Intl.Locale` objects.  If not specified, the system default locale
+   * is used.
+   */
+  readonly locale?: string | readonly string[] | Intl.Locale | readonly Intl.Locale[];
+  /**
+   * The type of list to format:
+   *
+   * - `"conjunction"`: "A, B, and C" (default)
+   * - `"disjunction"`: "A, B, or C"
+   * - `"unit"`: "A, B, C"
+   *
+   * @default `"conjunction"`
+   */
+  readonly type?: "conjunction" | "disjunction" | "unit";
+  /**
+   * The style of the list formatting:
+   *
+   * - `"long"`: "A, B, and C" (default)
+   * - `"short"`: "A, B, & C"
+   * - `"narrow"`: "A, B, C"
+   *
+   * @default `"long"`
+   */
+  readonly style?: "long" | "short" | "narrow";
+}
+/**
+ * Creates a {@link Message} for a formatted list of values using the
+ * `Intl.ListFormat` API.  This is useful for displaying choice lists
+ * in error messages with proper locale-aware formatting.
+ *
+ * Each value in the list becomes a separate value term, and the separators
+ * (commas, "and", "or", etc.) become text terms.  This allows each value
+ * to be styled independently while respecting the locale's list formatting
+ * conventions.
+ *
+ * @example
+ * ```typescript
+ * // English conjunction (default): "error", "warn", and "info"
+ * const msg1 = message`Expected one of ${valueSet(["error", "warn", "info"])}.`;
+ *
+ * // English disjunction: "error", "warn", or "info"
+ * const msg2 = message`Expected ${
+ *   valueSet(["error", "warn", "info"], { type: "disjunction" })
+ * }.`;
+ *
+ * // Korean disjunction: "error", "warn" 또는 "info"
+ * const msg3 = message`${
+ *   valueSet(["error", "warn", "info"], { locale: "ko", type: "disjunction" })
+ * } 중 하나여야 합니다.`;
+ * ```
+ *
+ * @param values The list of values to format.
+ * @param options Optional formatting options including locale and list type.
+ * @returns A {@link Message} with alternating value and text terms.
+ * @since 0.9.0
+ */
+declare function valueSet(values: readonly string[], options?: ValueSetOptions): Message;
 /**
  * Options for the {@link formatMessage} function.
  */
@@ -258,4 +323,4 @@ interface MessageFormatOptions {
  */
 declare function formatMessage(msg: Message, options?: MessageFormatOptions): string;
 //#endregion
-export { Message, MessageFormatOptions, MessageTerm, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values };
+export { Message, MessageFormatOptions, MessageTerm, ValueSetOptions, commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values };

package/dist/message.js

@@ -139,6 +139,55 @@ function commandLine(commandLine$1) {
 	};
 }
 /**
+* Creates a {@link Message} for a formatted list of values using the
+* `Intl.ListFormat` API.  This is useful for displaying choice lists
+* in error messages with proper locale-aware formatting.
+*
+* Each value in the list becomes a separate value term, and the separators
+* (commas, "and", "or", etc.) become text terms.  This allows each value
+* to be styled independently while respecting the locale's list formatting
+* conventions.
+*
+* @example
+* ```typescript
+* // English conjunction (default): "error", "warn", and "info"
+* const msg1 = message`Expected one of ${valueSet(["error", "warn", "info"])}.`;
+*
+* // English disjunction: "error", "warn", or "info"
+* const msg2 = message`Expected ${
+*   valueSet(["error", "warn", "info"], { type: "disjunction" })
+* }.`;
+*
+* // Korean disjunction: "error", "warn" 또는 "info"
+* const msg3 = message`${
+*   valueSet(["error", "warn", "info"], { locale: "ko", type: "disjunction" })
+* } 중 하나여야 합니다.`;
+* ```
+*
+* @param values The list of values to format.
+* @param options Optional formatting options including locale and list type.
+* @returns A {@link Message} with alternating value and text terms.
+* @since 0.9.0
+*/
+function valueSet(values$1, options) {
+	if (values$1.length === 0) return [];
+	const formatter = new Intl.ListFormat(options?.locale, {
+		type: options?.type,
+		style: options?.style
+	});
+	const parts = formatter.formatToParts(values$1);
+	const result = [];
+	for (const part of parts) if (part.type === "element") result.push({
+		type: "value",
+		value: part.value
+	});
+	else result.push({
+		type: "text",
+		text: part.value
+	});
+	return result;
+}
+/**
 * Formats a {@link Message} into a human-readable string for
 * the terminal.
 * @param msg The message to format, which is an array of
@@ -266,4 +315,4 @@ function formatMessage(msg, options = {}) {
 }
 
 //#endregion
-export { commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, values };
+export { commandLine, envVar, formatMessage, message, metavar, optionName, optionNames, text, value, valueSet, values };

package/dist/valueparser.cjs

@@ -101,12 +101,8 @@ function formatNumberChoiceError(input, choices, options) {
 * Formats default error message for choice parser.
 */
 function formatDefaultChoiceError(input, choices) {
-	let choicesList = [];
-	for (let i = 0; i < choices.length; i++) {
-		if (i > 0) choicesList = [...choicesList, ...require_message.message`, `];
-		choicesList = [...choicesList, ...require_message.message`${String(choices[i])}`];
-	}
-	return require_message.message`Expected one of ${choicesList}, but got ${input}.`;
+	const choiceStrings = choices.map((c) => String(c));
+	return require_message.message`Expected one of ${require_message.valueSet(choiceStrings, { locale: "en-US" })}, but got ${input}.`;
 }
 /**
 * Creates a {@link ValueParser} for strings.

package/dist/valueparser.js

@@ -1,4 +1,4 @@
-import { message, text } from "./message.js";
+import { message, text, valueSet } from "./message.js";
 import { ensureNonEmptyString, isNonEmptyString } from "./nonempty.js";
 
 //#region src/valueparser.ts
@@ -101,12 +101,8 @@ function formatNumberChoiceError(input, choices, options) {
 * Formats default error message for choice parser.
 */
 function formatDefaultChoiceError(input, choices) {
-	let choicesList = [];
-	for (let i = 0; i < choices.length; i++) {
-		if (i > 0) choicesList = [...choicesList, ...message`, `];
-		choicesList = [...choicesList, ...message`${String(choices[i])}`];
-	}
-	return message`Expected one of ${choicesList}, but got ${input}.`;
+	const choiceStrings = choices.map((c) => String(c));
+	return message`Expected one of ${valueSet(choiceStrings, { locale: "en-US" })}, but got ${input}.`;
 }
 /**
 * Creates a {@link ValueParser} for strings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.9.0-dev.217+7fc9df46",
+  "version": "0.9.0-dev.225+82a6f132",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",