@alpacakit/channels 0.1.0-beta.37 → 0.1.0-beta.39

package/dist/binding-compiler.d.ts

@@ -1,10 +1,12 @@
 import type { ErasedEntryDefinition, ErasedParameterDefinition } from "./model.js";
 export declare const PARAMETER_BINDING_ISSUE_KIND: {
     readonly duplicate: "duplicate";
+    readonly duplicateExclusion: "duplicate_exclusion";
+    readonly nonexistentExclusion: "nonexistent_exclusion";
     readonly nonexistent: "nonexistent";
     readonly requiredUnreachable: "required_unreachable";
 };
-export type ParameterBindingRow = {
+type ParameterBindingRow = {
     readonly parameterName: string;
 };
 export type CompiledParameterBinding<Row extends ParameterBindingRow = ParameterBindingRow> = {
@@ -12,6 +14,12 @@ export type CompiledParameterBinding<Row extends ParameterBindingRow = Parameter
     readonly parameter: ErasedParameterDefinition;
 };
 export type ParameterBindingIssue = {
+    readonly kind: typeof PARAMETER_BINDING_ISSUE_KIND.duplicateExclusion;
+    readonly parameterName: string;
+} | {
+    readonly kind: typeof PARAMETER_BINDING_ISSUE_KIND.nonexistentExclusion;
+    readonly parameterName: string;
+} | {
     readonly kind: typeof PARAMETER_BINDING_ISSUE_KIND.duplicate;
     readonly parameterName: string;
 } | {
@@ -21,9 +29,11 @@ export type ParameterBindingIssue = {
     readonly kind: typeof PARAMETER_BINDING_ISSUE_KIND.requiredUnreachable;
     readonly parameterName: string;
 };
-export type ParameterBindingCompilation<Row extends ParameterBindingRow> = {
+type ParameterBindingCompilation<Row extends ParameterBindingRow> = {
     readonly bindings: readonly CompiledParameterBinding<Row>[];
     readonly issues: readonly ParameterBindingIssue[];
 };
 export declare function compileParameterBindings<Row extends ParameterBindingRow>(entry: ErasedEntryDefinition, rows: readonly Row[]): ParameterBindingCompilation<Row>;
+export declare function compileParameterExclusions(entry: ErasedEntryDefinition, exclusions: readonly string[]): ParameterBindingCompilation<ParameterBindingRow>;
+export {};
 //# sourceMappingURL=binding-compiler.d.ts.map

package/dist/binding-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding-compiler.d.ts","sourceRoot":"","sources":["../src/binding-compiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAClC,GAAG,SAAS,mBAAmB,GAAG,mBAAmB,IACnD;IACF,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,SAAS,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,WAAW,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,mBAAmB,CAAC;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,MAAM,MAAM,2BAA2B,CAAC,GAAG,SAAS,mBAAmB,IAAI;IACzE,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,GAAG,SAAS,mBAAmB,EACtE,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,2BAA2B,CAAC,GAAG,CAAC,CAkClC"}
+{"version":3,"file":"binding-compiler.d.ts","sourceRoot":"","sources":["../src/binding-compiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC;AAEX,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAClC,GAAG,SAAS,mBAAmB,GAAG,mBAAmB,IACnD;IACF,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,kBAAkB,CAAC;IACtE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,oBAAoB,CAAC;IACxE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,SAAS,CAAC;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,WAAW,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,4BAA4B,CAAC,mBAAmB,CAAC;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,KAAK,2BAA2B,CAAC,GAAG,SAAS,mBAAmB,IAAI;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACnD,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,GAAG,SAAS,mBAAmB,EACtE,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,SAAS,GAAG,EAAE,GACnB,2BAA2B,CAAC,GAAG,CAAC,CAkClC;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,qBAAqB,EAC5B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,2BAA2B,CAAC,mBAAmB,CAAC,CAyBlD"}

package/dist/binding-compiler.js

@@ -2,6 +2,8 @@ import { findParameter } from "./internal.js";
 import { PARAMETER_REQUIREMENT_KIND } from "./values.js";
 export const PARAMETER_BINDING_ISSUE_KIND = {
     duplicate: "duplicate",
+    duplicateExclusion: "duplicate_exclusion",
+    nonexistentExclusion: "nonexistent_exclusion",
     nonexistent: "nonexistent",
     requiredUnreachable: "required_unreachable",
 };
@@ -38,3 +40,26 @@ export function compileParameterBindings(entry, rows) {
     }
     return { bindings, issues };
 }
+export function compileParameterExclusions(entry, exclusions) {
+    const excluded = new Set();
+    const issues = [];
+    for (const parameterName of exclusions) {
+        if (excluded.has(parameterName)) {
+            issues.push({
+                kind: PARAMETER_BINDING_ISSUE_KIND.duplicateExclusion,
+                parameterName,
+            });
+        }
+        excluded.add(parameterName);
+        if (findParameter(entry.parameters, parameterName) === null) {
+            issues.push({
+                kind: PARAMETER_BINDING_ISSUE_KIND.nonexistentExclusion,
+                parameterName,
+            });
+        }
+    }
+    const exposed = compileParameterBindings(entry, entry.parameters
+        .filter((parameter) => !excluded.has(parameter.name))
+        .map((parameter) => ({ parameterName: parameter.name })));
+    return { bindings: exposed.bindings, issues: [...issues, ...exposed.issues] };
+}

package/dist/cli-coercion.d.ts

@@ -1,5 +1,5 @@
 import type { JsonValue } from "@alpacakit/core";
 import { type CliValueCoercion } from "./cli-model.js";
 import type { ValueShape } from "./model.js";
-export declare function coerceCliArgvValue(shape: ValueShape, rawValue: unknown, coercion: CliValueCoercion | null): JsonValue | undefined;
+export declare function coerceCliArgvValue(parameterName: string, shape: ValueShape, rawValue: unknown, coercion: CliValueCoercion | null): JsonValue | undefined;
 //# sourceMappingURL=cli-coercion.d.ts.map

package/dist/cli-coercion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-coercion.d.ts","sourceRoot":"","sources":["../src/cli-coercion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAChC,SAAS,GAAG,SAAS,CAWvB"}
+{"version":3,"file":"cli-coercion.d.ts","sourceRoot":"","sources":["../src/cli-coercion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAChC,SAAS,GAAG,SAAS,CAKvB"}

package/dist/cli-coercion.js

@@ -1,38 +1,20 @@
 import { CLI_VALUE_COERCION } from "./cli-model.js";
-import { VALUE_SHAPE_KIND } from "./values.js";
-export function coerceCliArgvValue(shape, rawValue, coercion) {
+import { EntryInputError } from "./runtime.js";
+import { coerceStringValue } from "./string-coercion.js";
+import { ENTRY_INPUT_TARGET_KIND } from "./values.js";
+export function coerceCliArgvValue(parameterName, shape, rawValue, coercion) {
     if (coercion !== null) {
-        return coerceExplicitCliValue(rawValue, coercion);
+        return coerceExplicitCliValue(parameterName, rawValue, coercion);
     }
-    if (shape.kind === VALUE_SHAPE_KIND.array) {
-        const values = Array.isArray(rawValue) ? rawValue : [rawValue];
-        return values.map((value) => coerceCliArgvScalarValue(shape.element, value));
-    }
-    return coerceCliArgvScalarValue(shape, rawValue);
-}
-function coerceCliArgvScalarValue(shape, value) {
-    if (shape.kind === VALUE_SHAPE_KIND.boolean) {
-        if (value === "true") {
-            return true;
-        }
-        if (value === "false") {
-            return false;
-        }
-    }
-    if (shape.kind === VALUE_SHAPE_KIND.positiveInteger &&
-        typeof value === "string" &&
-        /^[+-]?\d+$/.test(value)) {
-        return Number(value);
-    }
-    return value;
+    return coerceStringValue(shape, rawValue);
 }
-function coerceExplicitCliValue(rawValue, coercion) {
+function coerceExplicitCliValue(parameterName, rawValue, coercion) {
     if (Array.isArray(rawValue)) {
-        return rawValue.map((value) => coerceExplicitCliScalar(value, coercion));
+        return rawValue.map((value) => coerceExplicitCliScalar(parameterName, value, coercion));
     }
-    return coerceExplicitCliScalar(rawValue, coercion);
+    return coerceExplicitCliScalar(parameterName, rawValue, coercion);
 }
-function coerceExplicitCliScalar(value, coercion) {
+function coerceExplicitCliScalar(parameterName, value, coercion) {
     if (typeof value !== "string") {
         return value;
     }
@@ -43,7 +25,10 @@ function coerceExplicitCliScalar(value, coercion) {
         if (coercion === CLI_VALUE_COERCION.jsonOrString) {
             return value;
         }
-        throw new Error(`Invalid JSON value: ${errorMessage(error)}`);
+        throw new EntryInputError([`Invalid JSON value: ${errorMessage(error)}`], {
+            kind: ENTRY_INPUT_TARGET_KIND.parameter,
+            parameterName,
+        });
     }
 }
 function errorMessage(error) {

package/dist/cli-compiler.d.ts

@@ -1,10 +1,7 @@
-import { type CliEntryBinding, type CliLongOptionFlag, type CliOptionFlag, type CliOptionValueMode, type CliValueCoercion } from "./cli-model.js";
+import { type CompiledParameterBinding } from "./binding-compiler.js";
+import { type CliArgBinding, type CliEntryBinding, type CliLongOptionFlag, type CliOptionFlag, type CliOptionValueMode, type CliParameterView, type CliValueCoercion } from "./cli-model.js";
 import { CLI_OPTION_KIND, CLI_POSITIONAL_PLAN_KIND } from "./cli-values.js";
 import type { EntryTreeEndpoint, ErasedParameterDefinition } from "./model.js";
-export declare const CLI_OPTION_ACTION_KIND: {
-    readonly setBoolean: "set_boolean";
-    readonly readValue: "read_value";
-};
 type CompiledCliOptionBase = {
     readonly parameter: ErasedParameterDefinition;
     readonly flags: readonly CliOptionFlag[];
@@ -24,24 +21,14 @@ export type CompiledCliPositional = {
     readonly valueName: string;
     readonly coercion: CliValueCoercion | null;
 };
-export type CliOptionAction = {
-    readonly kind: typeof CLI_OPTION_ACTION_KIND.setBoolean;
-    readonly parameterName: string;
-    readonly value: boolean;
-} | {
-    readonly kind: typeof CLI_OPTION_ACTION_KIND.readValue;
-    readonly option: Extract<CompiledCliOption, {
-        readonly kind: typeof CLI_OPTION_KIND.value;
-    }>;
-};
 export type CompiledCliEndpoint = {
     readonly endpoint: EntryTreeEndpoint;
     readonly binding: CliEntryBinding;
-    readonly help: CliEntryBinding["help"];
+    readonly parameterBindings: readonly CompiledParameterBinding<CliArgBinding>[];
     readonly options: readonly CompiledCliOption[];
     readonly positionals: readonly CompiledCliPositional[];
-    readonly optionByToken: ReadonlyMap<string, CliOptionAction>;
 };
 export declare function compileCliBinding(endpoint: EntryTreeEndpoint, binding: CliEntryBinding, location: string, issues: string[]): CompiledCliEndpoint;
+export declare function projectCliParameters(endpoint: CompiledCliEndpoint): readonly CliParameterView[];
 export {};
 //# sourceMappingURL=cli-compiler.d.ts.map

package/dist/cli-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-compiler.d.ts","sourceRoot":"","sources":["../src/cli-compiler.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,eAAe,EAEf,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAG/E,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAUX,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,CAAC,qBAAqB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,WAAW,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtD,CAAC,GACF,CAAC,qBAAqB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,KAAK,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEP,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EACT,OAAO,wBAAwB,CAAC,MAAM,GACtC,OAAO,wBAAwB,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,sBAAsB,CAAC,UAAU,CAAC;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,sBAAsB,CAAC,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,OAAO,CACtB,iBAAiB,EACjB;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,KAAK,CAAA;KAAE,CAChD,CAAC;CACH,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9D,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,mBAAmB,CAiDrB"}
+{"version":3,"file":"cli-compiler.d.ts","sourceRoot":"","sources":["../src/cli-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAI9B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,eAAe,EAEf,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAY/E,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,CAAC,qBAAqB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,WAAW,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtD,CAAC,GACF,CAAC,qBAAqB,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,eAAe,CAAC,KAAK,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC,CAAC;AAEP,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EACT,OAAO,wBAAwB,CAAC,MAAM,GACtC,OAAO,wBAAwB,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,wBAAwB,CAAC,aAAa,CAAC,EAAE,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACxD,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,mBAAmB,CAiDrB;AAsBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,GAC5B,SAAS,gBAAgB,EAAE,CAmC7B"}

package/dist/cli-compiler.js

@@ -1,11 +1,9 @@
 import { compileParameterBindings, PARAMETER_BINDING_ISSUE_KIND, } from "./binding-compiler.js";
 import { CLI_ARG_KIND, } from "./cli-model.js";
 import { CLI_BOOLEAN_MODE, CLI_OPTION_KIND, CLI_OPTION_VALUE_MODE, CLI_POSITIONAL_PLAN_KIND, } from "./cli-values.js";
+import { describeParameterRequirement } from "./introspection.js";
+import { ownedArray, ownedRecord } from "./owned.js";
 import { PARAMETER_REQUIREMENT_KIND, VALUE_SHAPE_KIND } from "./values.js";
-export const CLI_OPTION_ACTION_KIND = {
-    setBoolean: "set_boolean",
-    readValue: "read_value",
-};
 const CLI_COMPILER_SYNTAX = {
     assignmentSeparator: "=",
     invalidLongOptionPrefix: "---",
@@ -32,15 +30,85 @@ export function compileCliBinding(endpoint, binding, location, issues) {
             issues.push(`${location}: variadic positional ${positional.parameter.name} must be last`);
         }
     }
+    validateUniqueOptionFlags(options, location, issues);
     return {
         endpoint,
         binding,
-        help: binding.help,
+        parameterBindings: compiledParameters.bindings,
         options,
         positionals,
-        optionByToken: createCliOptionActionIndex(options, location, issues),
     };
 }
+function validateUniqueOptionFlags(options, location, issues) {
+    const flags = new Set();
+    for (const option of options) {
+        const optionFlags = option.kind === CLI_OPTION_KIND.booleanFlag
+            ? [...option.flags, ...option.negativeFlags]
+            : option.flags;
+        for (const flag of optionFlags) {
+            if (flags.has(flag)) {
+                issues.push(`${location}: duplicate CLI option flag ${flag}`);
+            }
+            flags.add(flag);
+        }
+    }
+}
+export function projectCliParameters(endpoint) {
+    const options = new Map(endpoint.options.map((option) => [option.parameter.name, option]));
+    const positionals = new Map(endpoint.positionals.map((positional) => [
+        positional.parameter.name,
+        positional,
+    ]));
+    return ownedArray(endpoint.binding.parameters.flatMap((row) => {
+        if (row.kind === CLI_ARG_KIND.option) {
+            const option = options.get(row.parameterName);
+            return option === undefined ? [] : [projectCliOption(option)];
+        }
+        const positional = positionals.get(row.parameterName);
+        return positional === undefined
+            ? []
+            : [
+                ownedRecord({
+                    kind: CLI_ARG_KIND.positional,
+                    parameterName: positional.parameter.name,
+                    description: positional.parameter.description,
+                    requirement: describeParameterRequirement(positional.parameter.requirement),
+                    shape: positional.parameter.codec.shape,
+                    coercion: positional.coercion,
+                    valueName: positional.valueName,
+                    variadic: positional.kind === CLI_POSITIONAL_PLAN_KIND.rest,
+                }),
+            ];
+    }));
+}
+function projectCliOption(option) {
+    const base = {
+        parameterName: option.parameter.name,
+        description: option.parameter.description,
+        requirement: describeParameterRequirement(option.parameter.requirement),
+        shape: option.parameter.codec.shape,
+        coercion: option.coercion,
+    };
+    return option.kind === CLI_OPTION_KIND.booleanFlag
+        ? ownedRecord({
+            ...base,
+            kind: CLI_ARG_KIND.option,
+            optionKind: option.kind,
+            flags: option.flags,
+            negativeFlags: option.negativeFlags,
+            valueName: null,
+            valueMode: null,
+        })
+        : ownedRecord({
+            ...base,
+            kind: CLI_ARG_KIND.option,
+            optionKind: option.kind,
+            flags: option.flags,
+            negativeFlags: ownedArray([]),
+            valueName: option.valueName,
+            valueMode: option.valueMode,
+        });
+}
 function compileCliOption(compiled, location, issues) {
     const { row, parameter } = compiled;
     const flags = row.flags;
@@ -169,43 +237,14 @@ function compileCliPositional(compiled, location, issues) {
         coercion: row.coercion,
     };
 }
-function createCliOptionActionIndex(options, location, issues) {
-    const actions = new Map();
-    for (const option of options) {
-        if (option.kind === CLI_OPTION_KIND.booleanFlag) {
-            for (const token of option.flags) {
-                registerCliOptionAction(actions, token, {
-                    kind: CLI_OPTION_ACTION_KIND.setBoolean,
-                    parameterName: option.parameter.name,
-                    value: true,
-                }, location, issues);
-            }
-            for (const token of option.negativeFlags) {
-                registerCliOptionAction(actions, token, {
-                    kind: CLI_OPTION_ACTION_KIND.setBoolean,
-                    parameterName: option.parameter.name,
-                    value: false,
-                }, location, issues);
-            }
-            continue;
-        }
-        for (const token of option.flags) {
-            registerCliOptionAction(actions, token, { kind: CLI_OPTION_ACTION_KIND.readValue, option }, location, issues);
-        }
-    }
-    return actions;
-}
-function registerCliOptionAction(actions, token, action, location, issues) {
-    if (actions.has(token)) {
-        issues.push(`${location}: duplicate CLI option flag ${token}`);
-        return;
-    }
-    actions.set(token, action);
-}
 function formatCliParameterBindingIssue(location, issue) {
     switch (issue.kind) {
         case PARAMETER_BINDING_ISSUE_KIND.duplicate:
             return `${location}: duplicate binding for parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.duplicateExclusion:
+            return `${location}: duplicate exclusion for parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.nonexistentExclusion:
+            return `${location}: exclusion names nonexistent parameter ${issue.parameterName}`;
         case PARAMETER_BINDING_ISSUE_KIND.nonexistent:
             return `${location}: binding names nonexistent parameter ${issue.parameterName}`;
         case PARAMETER_BINDING_ISSUE_KIND.requiredUnreachable:

package/dist/cli-help-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-help-projection.d.ts","sourceRoot":"","sources":["../src/cli-help-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,cAAc,EAKd,cAAc,EAGd,UAAU,EACX,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA4ChD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,GAAG,cAAc,CAmBjB;AAkCD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CA2BN;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAaN"}
+{"version":3,"file":"cli-help-projection.d.ts","sourceRoot":"","sources":["../src/cli-help-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,cAAc,EAKd,cAAc,EAGd,UAAU,EACX,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA6ChD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,GAAG,cAAc,CAsBjB;AAwCD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CA4BN;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAaN"}

package/dist/cli-help-projection.js

@@ -1,5 +1,6 @@
 import { CLI_HELP_USAGE_KIND, CLI_OPTION_KIND, CLI_POSITIONAL_PLAN_KIND, } from "./cli-values.js";
 import { describeParameterRequirement } from "./introspection.js";
+import { ownedArray, ownedRecord } from "./owned.js";
 import { PARAMETER_REQUIREMENT_KIND } from "./values.js";
 const CLI_HELP_USAGE_SYNTAX = {
     commandArgument: "<command>",
@@ -18,51 +19,55 @@ const CLI_HELP_VALIDATION_ISSUE = {
     emptyExampleTitle: "CLI help example title must not be empty",
     nonOptionSectionParameter: (location, heading, parameterName) => `${location}: help option section ${JSON.stringify(heading)} names non-option parameter ${parameterName}`,
 };
-const GROUP_HELP_PROJECTION = {
-    examples: [],
-    options: [],
-    optionSections: [],
-    positionals: [],
-    usage: { kind: CLI_HELP_USAGE_KIND.derived },
-};
+const GROUP_HELP_PROJECTION = ownedRecord({
+    examples: ownedArray([]),
+    options: ownedArray([]),
+    optionSections: ownedArray([]),
+    positionals: ownedArray([]),
+    usage: ownedRecord({ kind: CLI_HELP_USAGE_KIND.derived }),
+});
 export function createCliHelpSurface(input) {
     const endpoint = projectCliEndpointHelp(input.endpoint);
     const hasChildren = input.childHelp.length > 0;
-    return {
+    return ownedRecord({
         name: input.node.name,
         token: input.root ? null : input.segment.token,
         description: input.node.description,
-        remarks: input.node.documentation.remarks,
-        relatedDocs: input.node.documentation.relatedDocs,
+        remarks: ownedArray(input.node.documentation.remarks),
+        relatedDocs: ownedArray(input.node.documentation.relatedDocs),
         optionGroups: projectCliHelpOptionGroups(endpoint.options, endpoint.optionSections),
-        positionals: endpoint.positionals,
+        positionals: ownedArray(endpoint.positionals),
         usages: resolveCliUsages(endpoint, hasChildren),
-        examples: [...input.segment.help.examples, ...endpoint.examples],
+        examples: ownedArray([
+            ...input.segment.help.examples,
+            ...endpoint.examples,
+        ]),
         subcommandHint: input.segment.help.subcommandHint,
-        children: input.childHelp,
-    };
+        children: ownedArray(input.childHelp),
+    });
 }
 function projectCliHelpOptionGroups(options, sections) {
     const optionByParameterName = new Map(options.map((option) => [option.parameterName, option]));
     const sectionedParameterNames = new Set(sections.flatMap((section) => section.parameterNames));
-    const groups = sections.map((section) => ({
+    const groups = sections.map((section) => ownedRecord({
         heading: section.heading,
         description: section.description,
         // Section references are validated before the completed router is exposed.
-        options: section.parameterNames.map((parameterName) => optionByParameterName.get(parameterName)),
+        options: ownedArray(section.parameterNames.map((parameterName) => optionByParameterName.get(parameterName))),
     }));
     const unsectionedOptions = options.filter((option) => !sectionedParameterNames.has(option.parameterName));
     if (unsectionedOptions.length > 0) {
-        groups.push({
+        groups.push(ownedRecord({
             heading: null,
             description: null,
-            options: unsectionedOptions,
-        });
+            options: ownedArray(unsectionedOptions),
+        }));
     }
-    return groups;
+    return ownedArray(groups);
 }
 export function validateCliCommandHelp(endpoint, location, issues) {
-    const { help, options } = endpoint;
+    const { help } = endpoint.binding;
+    const { options } = endpoint;
     validateCliHelpExamples(help.examples, location, issues);
     const optionNames = new Set(options.map((option) => option.parameter.name));
     const sectionedNames = new Set();
@@ -92,20 +97,20 @@ function projectCliEndpointHelp(endpoint) {
     if (endpoint === null) {
         return GROUP_HELP_PROJECTION;
     }
-    return {
-        examples: endpoint.help.examples,
-        options: endpoint.options.map(cliHelpOptionFor),
-        optionSections: endpoint.help.optionSections,
-        positionals: endpoint.positionals.map(cliHelpPositionalFor),
-        usage: endpoint.help.usage,
-    };
+    return ownedRecord({
+        examples: endpoint.binding.help.examples,
+        options: ownedArray(endpoint.options.map(cliHelpOptionFor)),
+        optionSections: endpoint.binding.help.optionSections,
+        positionals: ownedArray(endpoint.positionals.map(cliHelpPositionalFor)),
+        usage: endpoint.binding.help.usage,
+    });
 }
 function resolveCliUsages(endpoint, hasChildren) {
     switch (endpoint.usage.kind) {
         case CLI_HELP_USAGE_KIND.authored:
             return endpoint.usage.values;
         case CLI_HELP_USAGE_KIND.derived:
-            return [deriveCliUsage(endpoint, hasChildren)];
+            return ownedArray([deriveCliUsage(endpoint, hasChildren)]);
     }
 }
 function deriveCliUsage(endpoint, hasChildren) {
@@ -135,24 +140,24 @@ function cliHelpOptionFor(option) {
         requirement: describeParameterRequirement(option.parameter.requirement),
     };
     return option.kind === CLI_OPTION_KIND.booleanFlag
-        ? {
+        ? ownedRecord({
             ...base,
             kind: CLI_OPTION_KIND.booleanFlag,
-            negativeFlags: option.negativeFlags,
-        }
-        : {
+            negativeFlags: ownedArray(option.negativeFlags),
+        })
+        : ownedRecord({
             ...base,
             kind: CLI_OPTION_KIND.value,
             valueName: option.valueName,
             valueMode: option.valueMode,
-        };
+        });
 }
 function cliHelpPositionalFor(positional) {
-    return {
+    return ownedRecord({
         parameterName: positional.parameter.name,
         valueName: positional.valueName,
         description: positional.parameter.description,
         requirement: describeParameterRequirement(positional.parameter.requirement),
         variadic: positional.kind === CLI_POSITIONAL_PLAN_KIND.rest,
-    };
+    });
 }