@timeax/digital-service-engine 0.0.2 → 0.0.4

package/dist/workspace/index.d.cts

@@ -2,6 +2,146 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+type TimeRangeEstimate = {
+    min_seconds?: number;
+    max_seconds?: number;
+    label?: string;
+    meta?: Record<string, unknown>;
+};
+type SpeedEstimate = {
+    amount?: number;
+    per?: "minute" | "hour" | "day" | "week" | "month";
+    unit?: string;
+    label?: string;
+    meta?: Record<string, unknown>;
+};
+type ServiceEstimates = {
+    start?: TimeRangeEstimate;
+    speed?: SpeedEstimate;
+    average?: TimeRangeEstimate;
+    meta?: Record<string, unknown>;
+};
+type ServiceFlag = {
+    enabled: boolean;
+    description: string;
+    meta?: Record<string, unknown>;
+};
+type IdType = string | number;
+type ServiceFlags = Record<string, ServiceFlag>;
+type DgpServiceCapability = {
+    id: IdType;
+    name?: string;
+    rate: number;
+    min?: number;
+    max?: number;
+    category?: string;
+    flags?: ServiceFlags;
+    estimates?: ServiceEstimates;
+    meta?: Record<string, unknown>;
+    [x: string]: any;
+};
+type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
+
+type NodeRef$1 = {
+    kind: "tag";
+    id: string;
+    node: Tag;
+} | {
+    kind: "field";
+    id: string;
+    node: Field;
+} | {
+    kind: "option";
+    id: string;
+    node: FieldOption;
+    fieldId: string;
+};
+type NodeMap = Map<string, NodeRef$1>;
+
+type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
+type ValidationError = {
+    code: ValidationCode;
+    message: string;
+    severity: "error" | "warning" | "info";
+    nodeId?: string;
+    details?: Record<string, unknown> & {
+        affectedIds?: string[];
+    };
+};
+type ServiceWhereOp = "eq" | "neq" | "in" | "nin" | "exists" | "truthy" | "falsy" | "sw";
+/**
+ * Host-extensible service filter clause.
+ * `path` should usually be "service.<prop>" or "service.meta.<prop>" etc.
+ */
+type ServiceWhereClause = {
+    path: string;
+    op?: ServiceWhereOp;
+    value?: unknown;
+};
+type DynamicRule = {
+    id: string;
+    label?: string;
+    scope: "global" | "visible_group";
+    subject: "services";
+    /**
+     * Package-level filter surface:
+     * - role/tag/field are core to the builder schema
+     * - where[] allows hosts to filter against extra service properties (handler_id/platform_id/type/key/category_id/etc.)
+     */
+    filter?: {
+        role?: "base" | "utility" | "both";
+        tag_id?: string | string[];
+        field_id?: string | string[];
+        where?: ServiceWhereClause[];
+    };
+    /**
+     * Projection is intentionally open:
+     * hosts may project custom service properties.
+     */
+    projection?: "service.id" | "service.name" | "service.rate" | "service.min" | "service.max" | "service.category" | string;
+    op: "all_equal" | "unique" | "no_mix" | "all_true" | "any_true" | "max_count" | "min_count";
+    value?: number | boolean;
+    severity?: "error" | "warning";
+    message?: string;
+};
+type ValidatorOptions = {
+    serviceMap?: DgpServiceMap;
+    nodeMap?: NodeMap;
+    allowUnsafe?: boolean;
+    selectedOptionKeys?: string[];
+    globalUtilityGuard?: boolean;
+    policies?: DynamicRule[];
+    fallbackSettings?: FallbackSettings;
+};
+type RatePolicy = {
+    kind: "lte_primary";
+} | {
+    kind: "within_pct";
+    pct: number;
+} | {
+    kind: "at_least_pct_lower";
+    pct: number;
+};
+type FallbackSettings = {
+    /** Require fallbacks to satisfy tag constraints (dripfeed/refill/cancel) when a tag context is known. Default: true */
+    requireConstraintFit?: boolean;
+    /** Rate rule policy. Default: { kind: 'lte_primary' } i.e. candidate.rate <= primary.rate */
+    ratePolicy?: RatePolicy;
+    /** When multiple candidates remain, choose first (priority) or cheapest. Default: 'priority' */
+    selectionStrategy?: "priority" | "cheapest";
+    /** Validation mode: 'strict' → node-scoped violations reported as ValidationError; 'dev' → only collect diagnostics. Default: 'strict' */
+    mode?: "strict" | "dev";
+};
+
+type ServiceIdRef = number | string;
+type NodeIdRef = string;
+type ServiceFallback = {
+    /** Node-scoped fallbacks: prefer these when that node’s primary service fails */
+    nodes?: Record<NodeIdRef, ServiceIdRef[]>;
+    /** Primary→fallback list used when no node-scoped entry is present */
+    global?: Record<ServiceIdRef, ServiceIdRef[]>;
+};
+
 type PricingRole = "base" | "utility";
 type FieldType = "custom" | (string & {});
 /** ── Marker types (live inside meta; non-breaking) ───────────────────── */
@@ -100,14 +240,6 @@ type ServiceProps = {
     name?: string;
     notices?: ServicePropsNotice[];
 };
-type ServiceIdRef = number | string;
-type NodeIdRef = string;
-type ServiceFallback = {
-    /** Node-scoped fallbacks: prefer these when that node’s primary service fails */
-    nodes?: Record<NodeIdRef, ServiceIdRef[]>;
-    /** Primary→fallback list used when no node-scoped entry is present */
-    global?: Record<ServiceIdRef, ServiceIdRef[]>;
-};
 type NoticeType = "public" | "private";
 type NoticeSeverity = "info" | "warning" | "error";
 /**
@@ -327,137 +459,6 @@ type EditorSnapshot = {
     meta?: Record<string, unknown>;
 };
 
-type TimeRangeEstimate = {
-    min_seconds?: number;
-    max_seconds?: number;
-    label?: string;
-    meta?: Record<string, unknown>;
-};
-type SpeedEstimate = {
-    amount?: number;
-    per?: "minute" | "hour" | "day" | "week" | "month";
-    unit?: string;
-    label?: string;
-    meta?: Record<string, unknown>;
-};
-type ServiceEstimates = {
-    start?: TimeRangeEstimate;
-    speed?: SpeedEstimate;
-    average?: TimeRangeEstimate;
-    meta?: Record<string, unknown>;
-};
-type ServiceFlag = {
-    enabled: boolean;
-    description: string;
-    meta?: Record<string, unknown>;
-};
-type IdType = string | number;
-type ServiceFlags = Record<string, ServiceFlag>;
-type DgpServiceCapability = {
-    id: IdType;
-    name?: string;
-    rate: number;
-    min?: number;
-    max?: number;
-    category?: string;
-    flags?: ServiceFlags;
-    estimates?: ServiceEstimates;
-    meta?: Record<string, unknown>;
-    [x: string]: any;
-};
-type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
-
-type NodeRef$1 = {
-    kind: "tag";
-    id: string;
-    node: Tag;
-} | {
-    kind: "field";
-    id: string;
-    node: Field;
-} | {
-    kind: "option";
-    id: string;
-    node: FieldOption;
-    fieldId: string;
-};
-type NodeMap = Map<string, NodeRef$1>;
-
-type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
-type ValidationError = {
-    code: ValidationCode;
-    message: string;
-    severity: "error" | "warning" | "info";
-    nodeId?: string;
-    details?: Record<string, unknown> & {
-        affectedIds?: string[];
-    };
-};
-type ServiceWhereOp = "eq" | "neq" | "in" | "nin" | "exists" | "truthy" | "falsy" | "sw";
-/**
- * Host-extensible service filter clause.
- * `path` should usually be "service.<prop>" or "service.meta.<prop>" etc.
- */
-type ServiceWhereClause = {
-    path: string;
-    op?: ServiceWhereOp;
-    value?: unknown;
-};
-type DynamicRule = {
-    id: string;
-    label?: string;
-    scope: "global" | "visible_group";
-    subject: "services";
-    /**
-     * Package-level filter surface:
-     * - role/tag/field are core to the builder schema
-     * - where[] allows hosts to filter against extra service properties (handler_id/platform_id/type/key/category_id/etc.)
-     */
-    filter?: {
-        role?: "base" | "utility" | "both";
-        tag_id?: string | string[];
-        field_id?: string | string[];
-        where?: ServiceWhereClause[];
-    };
-    /**
-     * Projection is intentionally open:
-     * hosts may project custom service properties.
-     */
-    projection?: "service.id" | "service.name" | "service.rate" | "service.min" | "service.max" | "service.category" | string;
-    op: "all_equal" | "unique" | "no_mix" | "all_true" | "any_true" | "max_count" | "min_count";
-    value?: number | boolean;
-    severity?: "error" | "warning";
-    message?: string;
-};
-type ValidatorOptions = {
-    serviceMap?: DgpServiceMap;
-    nodeMap?: NodeMap;
-    allowUnsafe?: boolean;
-    selectedOptionKeys?: string[];
-    globalUtilityGuard?: boolean;
-    policies?: DynamicRule[];
-    fallbackSettings?: FallbackSettings;
-};
-type RatePolicy = {
-    kind: "lte_primary";
-} | {
-    kind: "within_pct";
-    pct: number;
-} | {
-    kind: "at_least_pct_lower";
-    pct: number;
-};
-type FallbackSettings = {
-    /** Require fallbacks to satisfy tag constraints (dripfeed/refill/cancel) when a tag context is known. Default: true */
-    requireConstraintFit?: boolean;
-    /** Rate rule policy. Default: { kind: 'lte_primary' } i.e. candidate.rate <= primary.rate */
-    ratePolicy?: RatePolicy;
-    /** When multiple candidates remain, choose first (priority) or cheapest. Default: 'priority' */
-    selectionStrategy?: "priority" | "cheapest";
-    /** Validation mode: 'strict' → node-scoped violations reported as ValidationError; 'dev' → only collect diagnostics. Default: 'strict' */
-    mode?: "strict" | "dev";
-};
-
 /** Options you can set on the builder (used for validation/visibility) */
 type BuilderOptions = Omit<ValidatorOptions, "serviceMap"> & {
     serviceMap?: DgpServiceMap;
@@ -630,10 +631,34 @@ declare class Selection {
     currentTag(): string | undefined;
     onChange(fn: Listener): () => void;
     visibleGroup(): VisibleGroupResult;
+    /**
+     * Build a fieldId -> triggerKeys[] map from the current selection set.
+     *
+     * What counts as a "button selection" (trigger key):
+     * - field key where the field has button === true (e.g. "f:dripfeed")
+     * - option key (e.g. "o:fast")
+     * - composite key "fieldId::optionId" (e.g. "f:speed::o:fast")
+     *
+     * Grouping:
+     * - button-field trigger groups under its own fieldId
+     * - option/composite groups under the option's owning fieldId (from nodeMap)
+     *
+     * Deterministic:
+     * - preserves selection insertion order
+     * - de-dupes per field
+     */
+    buttonSelectionsByFieldId(): Record<string, string[]>;
+    /**
+     * Returns only selection keys that are valid "trigger buttons":
+     * - field keys where field.button === true
+     * - option keys
+     * - composite keys "fieldId::optionId" (validated by optionId)
+     * Excludes tags and non-button fields.
+     */
+    selectedButtons(): string[];
     private emit;
     private updateCurrentTagFrom;
     private resolveTagContextId;
-    private selectedButtonTriggerIds;
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;

package/dist/workspace/index.d.ts

@@ -2,6 +2,146 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+type TimeRangeEstimate = {
+    min_seconds?: number;
+    max_seconds?: number;
+    label?: string;
+    meta?: Record<string, unknown>;
+};
+type SpeedEstimate = {
+    amount?: number;
+    per?: "minute" | "hour" | "day" | "week" | "month";
+    unit?: string;
+    label?: string;
+    meta?: Record<string, unknown>;
+};
+type ServiceEstimates = {
+    start?: TimeRangeEstimate;
+    speed?: SpeedEstimate;
+    average?: TimeRangeEstimate;
+    meta?: Record<string, unknown>;
+};
+type ServiceFlag = {
+    enabled: boolean;
+    description: string;
+    meta?: Record<string, unknown>;
+};
+type IdType = string | number;
+type ServiceFlags = Record<string, ServiceFlag>;
+type DgpServiceCapability = {
+    id: IdType;
+    name?: string;
+    rate: number;
+    min?: number;
+    max?: number;
+    category?: string;
+    flags?: ServiceFlags;
+    estimates?: ServiceEstimates;
+    meta?: Record<string, unknown>;
+    [x: string]: any;
+};
+type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
+
+type NodeRef$1 = {
+    kind: "tag";
+    id: string;
+    node: Tag;
+} | {
+    kind: "field";
+    id: string;
+    node: Field;
+} | {
+    kind: "option";
+    id: string;
+    node: FieldOption;
+    fieldId: string;
+};
+type NodeMap = Map<string, NodeRef$1>;
+
+type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
+type ValidationError = {
+    code: ValidationCode;
+    message: string;
+    severity: "error" | "warning" | "info";
+    nodeId?: string;
+    details?: Record<string, unknown> & {
+        affectedIds?: string[];
+    };
+};
+type ServiceWhereOp = "eq" | "neq" | "in" | "nin" | "exists" | "truthy" | "falsy" | "sw";
+/**
+ * Host-extensible service filter clause.
+ * `path` should usually be "service.<prop>" or "service.meta.<prop>" etc.
+ */
+type ServiceWhereClause = {
+    path: string;
+    op?: ServiceWhereOp;
+    value?: unknown;
+};
+type DynamicRule = {
+    id: string;
+    label?: string;
+    scope: "global" | "visible_group";
+    subject: "services";
+    /**
+     * Package-level filter surface:
+     * - role/tag/field are core to the builder schema
+     * - where[] allows hosts to filter against extra service properties (handler_id/platform_id/type/key/category_id/etc.)
+     */
+    filter?: {
+        role?: "base" | "utility" | "both";
+        tag_id?: string | string[];
+        field_id?: string | string[];
+        where?: ServiceWhereClause[];
+    };
+    /**
+     * Projection is intentionally open:
+     * hosts may project custom service properties.
+     */
+    projection?: "service.id" | "service.name" | "service.rate" | "service.min" | "service.max" | "service.category" | string;
+    op: "all_equal" | "unique" | "no_mix" | "all_true" | "any_true" | "max_count" | "min_count";
+    value?: number | boolean;
+    severity?: "error" | "warning";
+    message?: string;
+};
+type ValidatorOptions = {
+    serviceMap?: DgpServiceMap;
+    nodeMap?: NodeMap;
+    allowUnsafe?: boolean;
+    selectedOptionKeys?: string[];
+    globalUtilityGuard?: boolean;
+    policies?: DynamicRule[];
+    fallbackSettings?: FallbackSettings;
+};
+type RatePolicy = {
+    kind: "lte_primary";
+} | {
+    kind: "within_pct";
+    pct: number;
+} | {
+    kind: "at_least_pct_lower";
+    pct: number;
+};
+type FallbackSettings = {
+    /** Require fallbacks to satisfy tag constraints (dripfeed/refill/cancel) when a tag context is known. Default: true */
+    requireConstraintFit?: boolean;
+    /** Rate rule policy. Default: { kind: 'lte_primary' } i.e. candidate.rate <= primary.rate */
+    ratePolicy?: RatePolicy;
+    /** When multiple candidates remain, choose first (priority) or cheapest. Default: 'priority' */
+    selectionStrategy?: "priority" | "cheapest";
+    /** Validation mode: 'strict' → node-scoped violations reported as ValidationError; 'dev' → only collect diagnostics. Default: 'strict' */
+    mode?: "strict" | "dev";
+};
+
+type ServiceIdRef = number | string;
+type NodeIdRef = string;
+type ServiceFallback = {
+    /** Node-scoped fallbacks: prefer these when that node’s primary service fails */
+    nodes?: Record<NodeIdRef, ServiceIdRef[]>;
+    /** Primary→fallback list used when no node-scoped entry is present */
+    global?: Record<ServiceIdRef, ServiceIdRef[]>;
+};
+
 type PricingRole = "base" | "utility";
 type FieldType = "custom" | (string & {});
 /** ── Marker types (live inside meta; non-breaking) ───────────────────── */
@@ -100,14 +240,6 @@ type ServiceProps = {
     name?: string;
     notices?: ServicePropsNotice[];
 };
-type ServiceIdRef = number | string;
-type NodeIdRef = string;
-type ServiceFallback = {
-    /** Node-scoped fallbacks: prefer these when that node’s primary service fails */
-    nodes?: Record<NodeIdRef, ServiceIdRef[]>;
-    /** Primary→fallback list used when no node-scoped entry is present */
-    global?: Record<ServiceIdRef, ServiceIdRef[]>;
-};
 type NoticeType = "public" | "private";
 type NoticeSeverity = "info" | "warning" | "error";
 /**
@@ -327,137 +459,6 @@ type EditorSnapshot = {
     meta?: Record<string, unknown>;
 };
 
-type TimeRangeEstimate = {
-    min_seconds?: number;
-    max_seconds?: number;
-    label?: string;
-    meta?: Record<string, unknown>;
-};
-type SpeedEstimate = {
-    amount?: number;
-    per?: "minute" | "hour" | "day" | "week" | "month";
-    unit?: string;
-    label?: string;
-    meta?: Record<string, unknown>;
-};
-type ServiceEstimates = {
-    start?: TimeRangeEstimate;
-    speed?: SpeedEstimate;
-    average?: TimeRangeEstimate;
-    meta?: Record<string, unknown>;
-};
-type ServiceFlag = {
-    enabled: boolean;
-    description: string;
-    meta?: Record<string, unknown>;
-};
-type IdType = string | number;
-type ServiceFlags = Record<string, ServiceFlag>;
-type DgpServiceCapability = {
-    id: IdType;
-    name?: string;
-    rate: number;
-    min?: number;
-    max?: number;
-    category?: string;
-    flags?: ServiceFlags;
-    estimates?: ServiceEstimates;
-    meta?: Record<string, unknown>;
-    [x: string]: any;
-};
-type DgpServiceMap = Record<string, DgpServiceCapability> & Record<number, DgpServiceCapability>;
-
-type NodeRef$1 = {
-    kind: "tag";
-    id: string;
-    node: Tag;
-} | {
-    kind: "field";
-    id: string;
-    node: Field;
-} | {
-    kind: "option";
-    id: string;
-    node: FieldOption;
-    fieldId: string;
-};
-type NodeMap = Map<string, NodeRef$1>;
-
-type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context";
-type ValidationError = {
-    code: ValidationCode;
-    message: string;
-    severity: "error" | "warning" | "info";
-    nodeId?: string;
-    details?: Record<string, unknown> & {
-        affectedIds?: string[];
-    };
-};
-type ServiceWhereOp = "eq" | "neq" | "in" | "nin" | "exists" | "truthy" | "falsy" | "sw";
-/**
- * Host-extensible service filter clause.
- * `path` should usually be "service.<prop>" or "service.meta.<prop>" etc.
- */
-type ServiceWhereClause = {
-    path: string;
-    op?: ServiceWhereOp;
-    value?: unknown;
-};
-type DynamicRule = {
-    id: string;
-    label?: string;
-    scope: "global" | "visible_group";
-    subject: "services";
-    /**
-     * Package-level filter surface:
-     * - role/tag/field are core to the builder schema
-     * - where[] allows hosts to filter against extra service properties (handler_id/platform_id/type/key/category_id/etc.)
-     */
-    filter?: {
-        role?: "base" | "utility" | "both";
-        tag_id?: string | string[];
-        field_id?: string | string[];
-        where?: ServiceWhereClause[];
-    };
-    /**
-     * Projection is intentionally open:
-     * hosts may project custom service properties.
-     */
-    projection?: "service.id" | "service.name" | "service.rate" | "service.min" | "service.max" | "service.category" | string;
-    op: "all_equal" | "unique" | "no_mix" | "all_true" | "any_true" | "max_count" | "min_count";
-    value?: number | boolean;
-    severity?: "error" | "warning";
-    message?: string;
-};
-type ValidatorOptions = {
-    serviceMap?: DgpServiceMap;
-    nodeMap?: NodeMap;
-    allowUnsafe?: boolean;
-    selectedOptionKeys?: string[];
-    globalUtilityGuard?: boolean;
-    policies?: DynamicRule[];
-    fallbackSettings?: FallbackSettings;
-};
-type RatePolicy = {
-    kind: "lte_primary";
-} | {
-    kind: "within_pct";
-    pct: number;
-} | {
-    kind: "at_least_pct_lower";
-    pct: number;
-};
-type FallbackSettings = {
-    /** Require fallbacks to satisfy tag constraints (dripfeed/refill/cancel) when a tag context is known. Default: true */
-    requireConstraintFit?: boolean;
-    /** Rate rule policy. Default: { kind: 'lte_primary' } i.e. candidate.rate <= primary.rate */
-    ratePolicy?: RatePolicy;
-    /** When multiple candidates remain, choose first (priority) or cheapest. Default: 'priority' */
-    selectionStrategy?: "priority" | "cheapest";
-    /** Validation mode: 'strict' → node-scoped violations reported as ValidationError; 'dev' → only collect diagnostics. Default: 'strict' */
-    mode?: "strict" | "dev";
-};
-
 /** Options you can set on the builder (used for validation/visibility) */
 type BuilderOptions = Omit<ValidatorOptions, "serviceMap"> & {
     serviceMap?: DgpServiceMap;
@@ -630,10 +631,34 @@ declare class Selection {
     currentTag(): string | undefined;
     onChange(fn: Listener): () => void;
     visibleGroup(): VisibleGroupResult;
+    /**
+     * Build a fieldId -> triggerKeys[] map from the current selection set.
+     *
+     * What counts as a "button selection" (trigger key):
+     * - field key where the field has button === true (e.g. "f:dripfeed")
+     * - option key (e.g. "o:fast")
+     * - composite key "fieldId::optionId" (e.g. "f:speed::o:fast")
+     *
+     * Grouping:
+     * - button-field trigger groups under its own fieldId
+     * - option/composite groups under the option's owning fieldId (from nodeMap)
+     *
+     * Deterministic:
+     * - preserves selection insertion order
+     * - de-dupes per field
+     */
+    buttonSelectionsByFieldId(): Record<string, string[]>;
+    /**
+     * Returns only selection keys that are valid "trigger buttons":
+     * - field keys where field.button === true
+     * - option keys
+     * - composite keys "fieldId::optionId" (validated by optionId)
+     * Excludes tags and non-button fields.
+     */
+    selectedButtons(): string[];
     private emit;
     private updateCurrentTagFrom;
     private resolveTagContextId;
-    private selectedButtonTriggerIds;
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;