@acid-cat/spec-ts 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -63,6 +63,20 @@ export declare const cliExitCode: (outcome: Outcome<unknown, unknown>) => number
  * code point order of the names. `input` is the bundled input schema.
  */
 export declare function cliFlags(input: JsonObject): string[];
+/** A property schema, or the type in `definitions` that its `$ref` refers to. */
+export declare function cliResolve(property: JsonObject, definitions: JsonObject): JsonObject;
+/**
+ * The schema of the items of a repeated flag (spec/bindings/cli.md#commands), or `undefined` when the property does
+ * not give a repeated flag. A property gives a repeated flag when its type is `array`, and its `items` schema, or the
+ * type that it refers to, is an `enum` of strings, `integer`, `number` or `string`. `property` is already resolved.
+ */
+export declare function cliRepeatedItems(property: JsonObject, definitions: JsonObject): JsonObject | undefined;
+/**
+ * The array that a repeated flag gives as JSON text (spec/bindings/cli.md#commands), or `undefined` when its values
+ * give one item each. `values` are the values of the flag, in the order of the flags. They give an array as JSON text
+ * when the flag occurs exactly once and its value is JSON text of an array.
+ */
+export declare function cliJsonArray(values: readonly string[]): readonly unknown[] | undefined;
 /**
  * The `usage` of a capability in `list` (spec/bindings/cli.md#commands). `input` is the bundled input schema, or
  * `undefined` when the capability has no input.

package/dist/index.js

@@ -68,16 +68,45 @@ function cliFlags(input) {
 	const byName = (a, b) => a < b ? -1 : a > b ? 1 : 0;
 	const names = Object.keys(properties).sort(byName);
 	return [...names.filter((name) => required.has(name)), ...names.filter((name) => !required.has(name))].map((name) => {
-		const declared = objectOrEmpty(properties[name]);
-		const reference = declared.$ref;
-		const target = typeof reference === "string" ? REFERENCE.exec(reference)?.[1] : void 0;
-		const property = objectOrEmpty((target === void 0 ? void 0 : definitions[target]) ?? declared);
-		const flag = property.type === "boolean" ? `--${name}` : `--${name} <${flagValue(property)}>`;
+		const property = cliResolve(objectOrEmpty(properties[name]), definitions);
+		const items = cliRepeatedItems(property, definitions);
+		const flag = items !== void 0 ? `--${name} <${flagValue(items)}>...` : property.type === "boolean" ? `--${name}` : `--${name} <${flagValue(property)}>`;
 		return required.has(name) ? flag : `[${flag}]`;
 	});
 }
+/** A property schema, or the type in `definitions` that its `$ref` refers to. */
+function cliResolve(property, definitions) {
+	const target = typeof property.$ref === "string" ? REFERENCE.exec(property.$ref)?.[1] : void 0;
+	return target === void 0 ? property : objectOrEmpty(definitions[target] ?? property);
+}
+/**
+* The schema of the items of a repeated flag (spec/bindings/cli.md#commands), or `undefined` when the property does
+* not give a repeated flag. A property gives a repeated flag when its type is `array`, and its `items` schema, or the
+* type that it refers to, is an `enum` of strings, `integer`, `number` or `string`. `property` is already resolved.
+*/
+function cliRepeatedItems(property, definitions) {
+	if (property.type !== "array" || !isJsonObject(property.items)) return void 0;
+	const items = cliResolve(property.items, definitions);
+	return isStringEnum(items.enum) || items.type === "integer" || items.type === "number" || items.type === "string" ? items : void 0;
+}
+/**
+* The array that a repeated flag gives as JSON text (spec/bindings/cli.md#commands), or `undefined` when its values
+* give one item each. `values` are the values of the flag, in the order of the flags. They give an array as JSON text
+* when the flag occurs exactly once and its value is JSON text of an array.
+*/
+function cliJsonArray(values) {
+	const [value] = values;
+	if (values.length !== 1 || value === void 0) return void 0;
+	try {
+		const parsed = JSON.parse(value);
+		return Array.isArray(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+const isStringEnum = (value) => Array.isArray(value) && value.length > 0 && value.every((item) => typeof item === "string");
 function flagValue(property) {
-	if (Array.isArray(property.enum) && property.enum.every((value) => typeof value === "string")) return property.enum.join("|");
+	if (isStringEnum(property.enum)) return property.enum.join("|");
 	if (property.type === "integer" || property.type === "number" || property.type === "string") return property.type;
 	return "json";
 }
@@ -271,4 +300,4 @@ function viewOf(catalog, target) {
 	};
 }
 //#endregion
-export { AVAILABLE, CALL_FAILURE_KINDS, CLI_EXIT_CODES, CallFailureError, HTTP_STATUS, ID_PATTERN, MCP_PROTOCOL_VERSION, MCP_REJECTIONS, MCP_UNKNOWN_TOOL, REFERENCE, bundle, callFailure, cliExitCode, cliFlags, cliUsage, commandPath, fail, httpStatus, isCallFailure, isId, isJsonObject, mcpToolResult, objectInput, ok, readBounded, schemasOf, screenRequest, typesUsedBy, unavailable, viewOf, visitObjects };
+export { AVAILABLE, CALL_FAILURE_KINDS, CLI_EXIT_CODES, CallFailureError, HTTP_STATUS, ID_PATTERN, MCP_PROTOCOL_VERSION, MCP_REJECTIONS, MCP_UNKNOWN_TOOL, REFERENCE, bundle, callFailure, cliExitCode, cliFlags, cliJsonArray, cliRepeatedItems, cliResolve, cliUsage, commandPath, fail, httpStatus, isCallFailure, isId, isJsonObject, mcpToolResult, objectInput, ok, readBounded, schemasOf, screenRequest, typesUsedBy, unavailable, viewOf, visitObjects };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acid-cat/spec-ts",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "The fixed details of the AcidCat specification as TypeScript data and pure functions, with no dependencies. Part of the TypeScript reference implementation.",
   "keywords": [
     "acidcat",