@optique/core 0.5.0 → 0.6.0-dev.102

package/dist/valueparser.d.cts

@@ -1,4 +1,5 @@
 import { Message } from "./message.cjs";
+import { Suggestion } from "./parser.cjs";
 
 //#region src/valueparser.d.ts
 
@@ -35,6 +36,15 @@ interface ValueParser<T> {
    * @returns A string representation of the value.
    */
   format(value: T): string;
+  /**
+   * Provides completion suggestions for values of this type.
+   * This is optional and used for shell completion functionality.
+   *
+   * @param prefix The current input prefix to complete.
+   * @returns An iterable of suggestion objects.
+   * @since 0.6.0
+   */
+  suggest?(prefix: string): Iterable<Suggestion>;
 }
 /**
  * Result type returned by {@link ValueParser#parse}.

package/dist/valueparser.d.ts

@@ -1,4 +1,5 @@
 import { Message } from "./message.js";
+import { Suggestion } from "./parser.js";
 
 //#region src/valueparser.d.ts
 
@@ -35,6 +36,15 @@ interface ValueParser<T> {
    * @returns A string representation of the value.
    */
   format(value: T): string;
+  /**
+   * Provides completion suggestions for values of this type.
+   * This is optional and used for shell completion functionality.
+   *
+   * @param prefix The current input prefix to complete.
+   * @returns An iterable of suggestion objects.
+   * @since 0.6.0
+   */
+  suggest?(prefix: string): Iterable<Suggestion>;
 }
 /**
  * Result type returned by {@link ValueParser#parse}.

package/dist/valueparser.js

@@ -39,6 +39,16 @@ function choice(values, options = {}) {
 		},
 		format(value) {
 			return value;
+		},
+		suggest(prefix) {
+			const normalizedPrefix = options.caseInsensitive ? prefix.toLowerCase() : prefix;
+			return values.filter((value) => {
+				const normalizedValue = options.caseInsensitive ? value.toLowerCase() : value;
+				return normalizedValue.startsWith(normalizedPrefix);
+			}).map((value) => ({
+				kind: "literal",
+				text: value
+			}));
 		}
 	};
 }
@@ -236,6 +246,15 @@ function url(options = {}) {
 		},
 		format(value) {
 			return value.href;
+		},
+		*suggest(prefix) {
+			if (allowedProtocols && prefix.length > 0 && !prefix.includes("://")) for (const protocol of allowedProtocols) {
+				const cleanProtocol = protocol.replace(/:+$/, "");
+				if (cleanProtocol.startsWith(prefix.toLowerCase())) yield {
+					kind: "literal",
+					text: `${cleanProtocol}://`
+				};
+			}
 		}
 	};
 }
@@ -270,6 +289,236 @@ function locale(options = {}) {
 		},
 		format(value) {
 			return value.baseName;
+		},
+		*suggest(prefix) {
+			const commonLocales = [
+				"en",
+				"en-US",
+				"en-GB",
+				"en-CA",
+				"en-AU",
+				"en-NZ",
+				"en-IE",
+				"en-ZA",
+				"en-IN",
+				"es",
+				"es-ES",
+				"es-MX",
+				"es-AR",
+				"es-CL",
+				"es-CO",
+				"es-PE",
+				"es-VE",
+				"es-EC",
+				"es-GT",
+				"es-CU",
+				"es-BO",
+				"es-DO",
+				"es-HN",
+				"es-PY",
+				"es-SV",
+				"es-NI",
+				"es-CR",
+				"es-PA",
+				"es-UY",
+				"es-PR",
+				"fr",
+				"fr-FR",
+				"fr-CA",
+				"fr-BE",
+				"fr-CH",
+				"fr-LU",
+				"fr-MC",
+				"de",
+				"de-DE",
+				"de-AT",
+				"de-CH",
+				"de-BE",
+				"de-LU",
+				"de-LI",
+				"it",
+				"it-IT",
+				"it-CH",
+				"it-SM",
+				"it-VA",
+				"pt",
+				"pt-BR",
+				"pt-PT",
+				"pt-AO",
+				"pt-MZ",
+				"pt-CV",
+				"pt-GW",
+				"pt-ST",
+				"pt-TL",
+				"ru",
+				"ru-RU",
+				"ru-BY",
+				"ru-KZ",
+				"ru-KG",
+				"ru-MD",
+				"uk",
+				"uk-UA",
+				"be",
+				"be-BY",
+				"bg",
+				"bg-BG",
+				"cs",
+				"cs-CZ",
+				"sk",
+				"sk-SK",
+				"sl",
+				"sl-SI",
+				"hr",
+				"hr-HR",
+				"sr",
+				"sr-RS",
+				"mk",
+				"mk-MK",
+				"ja",
+				"ja-JP",
+				"ko",
+				"ko-KR",
+				"zh",
+				"zh-CN",
+				"zh-TW",
+				"zh-HK",
+				"zh-SG",
+				"zh-MO",
+				"ar",
+				"ar-SA",
+				"ar-AE",
+				"ar-BH",
+				"ar-DZ",
+				"ar-EG",
+				"ar-IQ",
+				"ar-JO",
+				"ar-KW",
+				"ar-LB",
+				"ar-LY",
+				"ar-MA",
+				"ar-OM",
+				"ar-QA",
+				"ar-SY",
+				"ar-TN",
+				"ar-YE",
+				"hi",
+				"hi-IN",
+				"bn",
+				"bn-BD",
+				"bn-IN",
+				"ur",
+				"ur-PK",
+				"ta",
+				"ta-IN",
+				"te",
+				"te-IN",
+				"mr",
+				"mr-IN",
+				"gu",
+				"gu-IN",
+				"kn",
+				"kn-IN",
+				"ml",
+				"ml-IN",
+				"pa",
+				"pa-IN",
+				"tr",
+				"tr-TR",
+				"tr-CY",
+				"pl",
+				"pl-PL",
+				"nl",
+				"nl-NL",
+				"nl-BE",
+				"nl-SR",
+				"sv",
+				"sv-SE",
+				"sv-FI",
+				"da",
+				"da-DK",
+				"no",
+				"no-NO",
+				"nb",
+				"nb-NO",
+				"nn",
+				"nn-NO",
+				"fi",
+				"fi-FI",
+				"is",
+				"is-IS",
+				"el",
+				"el-GR",
+				"el-CY",
+				"hu",
+				"hu-HU",
+				"ro",
+				"ro-RO",
+				"et",
+				"et-EE",
+				"lv",
+				"lv-LV",
+				"lt",
+				"lt-LT",
+				"mt",
+				"mt-MT",
+				"ga",
+				"ga-IE",
+				"cy",
+				"cy-GB",
+				"eu",
+				"eu-ES",
+				"ca",
+				"ca-ES",
+				"ca-AD",
+				"th",
+				"th-TH",
+				"vi",
+				"vi-VN",
+				"id",
+				"id-ID",
+				"ms",
+				"ms-MY",
+				"ms-BN",
+				"ms-SG",
+				"tl",
+				"tl-PH",
+				"km",
+				"km-KH",
+				"my",
+				"my-MM",
+				"lo",
+				"lo-LA",
+				"si",
+				"si-LK",
+				"ne",
+				"ne-NP",
+				"sw",
+				"sw-TZ",
+				"sw-KE",
+				"am",
+				"am-ET",
+				"ha",
+				"ha-NG",
+				"yo",
+				"yo-NG",
+				"ig",
+				"ig-NG",
+				"zu",
+				"zu-ZA",
+				"xh",
+				"xh-ZA",
+				"af",
+				"af-ZA",
+				"he",
+				"he-IL",
+				"fa",
+				"fa-IR",
+				"fa-AF"
+			];
+			for (const locale$1 of commonLocales) if (locale$1.toLowerCase().startsWith(prefix.toLowerCase())) yield {
+				kind: "literal",
+				text: locale$1
+			};
 		}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.5.0",
+  "version": "0.6.0-dev.102+50615c18",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -51,6 +51,14 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./completion": {
+      "types": {
+        "import": "./dist/completion.d.ts",
+        "require": "./dist/completion.cts"
+      },
+      "import": "./dist/completion.js",
+      "require": "./dist/completion.cjs"
+    },
     "./constructs": {
       "types": {
         "import": "./dist/constructs.d.ts",