@timeax/digital-service-engine 0.0.2 → 0.0.4

package/dist/react/index.d.cts

@@ -2,6 +2,381 @@ import { NodeProps } from 'reactflow';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React, { ReactNode } from 'react';
 
+interface ButtonValue {
+    id: string;
+    value: string | number;
+    service_id?: number;
+    pricing_role?: "base" | "utility";
+    meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
+}
+type Scalar = string | number | boolean | ButtonValue | null;
+type UtilityMode = "flat" | "per_quantity" | "per_value" | "percent";
+type QuantityRule$1 = {
+    valueBy: "value" | "length" | "eval";
+    code?: string;
+};
+type UtilityLineItem = {
+    nodeId: string;
+    mode: UtilityMode;
+    rate: number;
+    inputs: {
+        quantity: number;
+        value?: Scalar | Scalar[];
+        valueBy?: "value" | "length" | "eval";
+        evalCodeUsed?: boolean;
+    };
+};
+type ServiceFallbacks = ServiceFallback;
+type FallbackDiagnostics = {
+    scope: "node" | "global";
+    nodeId?: string;
+    primary: string | number;
+    candidate: string | number;
+    reasons: Array<"rate_violation" | "constraint_mismatch" | "unknown_service" | "ambiguous_context">;
+};
+type SnapshotContext = {
+    /** The single active tag id for this order */
+    tag: string;
+    /** Effective (post-propagation) constraints on that tag */
+    constraints: Partial<Record<"refill" | "cancel" | "dripfeed", boolean>>;
+    /**
+     * Per-node evaluation context:
+     * - For the active tag node itself: the same tag id.
+     * - For an option node: parent's field.bind_id must include this tag to be applicable; otherwise null.
+     * - For a field node (optional to include later): same rule as option, derived from field.bind_id.
+     */
+    nodeContexts: Record<string, string | null>;
+    /** Client pruning policy used (so server can mirror/compare). */
+    policy: {
+        ratePolicy: {
+            kind: "lte_primary" | "none";
+            thresholdPct?: number;
+        };
+        requireConstraintFit: boolean;
+    };
+};
+type OrderSnapshot = {
+    version: "1";
+    mode: "prod" | "dev";
+    builtAt: string;
+    selection: {
+        tag: string;
+        buttons: string[];
+        fields: Array<{
+            id: string;
+            type: string;
+            selectedOptions?: string[];
+        }>;
+    };
+    inputs: {
+        form: Record<string, Scalar | Scalar[]>;
+        selections: Record<string, string[]>;
+    };
+    quantity: number;
+    quantitySource: {
+        kind: "field" | "tag" | "option" | "default";
+        id?: string;
+        rule?: QuantityRule$1;
+        defaultedFromHost?: boolean;
+    };
+    min: number;
+    max: number;
+    services: Array<string | number>;
+    serviceMap: Record<string, Array<string | number>>;
+    fallbacks?: ServiceFallbacks;
+    utilities?: UtilityLineItem[];
+    warnings?: {
+        utility?: Array<{
+            nodeId: string;
+            reason: string;
+        }>;
+        fallbacks?: FallbackDiagnostics[];
+    };
+    meta?: {
+        schema_version?: string;
+        workspaceId?: string;
+        builder?: {
+            commit?: string;
+        };
+        context?: SnapshotContext;
+    };
+};
+
+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[]>;
+};
+/**
+ * Optional service-map shape.
+ * Keep this loose for now so the editor can be reused by host apps.
+ */
+type FallbackEditorServiceRecord = {
+    id: ServiceIdRef;
+    rate?: number;
+    service_id?: ServiceIdRef;
+    [key: string]: unknown;
+};
+type FallbackEditorServiceMap = DgpServiceMap;
+type FallbackRegistrationScope = "global" | "node";
+type FallbackScopeRef = {
+    scope: "global";
+    primary: ServiceIdRef;
+} | {
+    scope: "node";
+    nodeId: NodeIdRef;
+};
+type FallbackRegistration = {
+    scope: FallbackRegistrationScope;
+    /**
+     * For node scope => node id
+     * For global scope => omitted
+     */
+    scopeId?: NodeIdRef;
+    /**
+     * The primary DGP service this registration belongs to.
+     * For global scope, this is the global key.
+     * For node scope, this is resolved from ServiceProps/snapshot context.
+     */
+    primary: ServiceIdRef;
+    /** Registered fallback services */
+    services: ServiceIdRef[];
+};
+type FallbackCheckReason = "duplicate" | "self_reference" | "unknown_primary" | "unknown_candidate" | "missing_snapshot" | "node_scope_not_supported" | "node_primary_unresolved" | "ambiguous_context" | "invalid_candidate" | "unknown_service" | "no_primary" | "rate_violation" | "constraint_mismatch" | "cycle" | "no_tag_context" | "missing_service_props" | "node_not_found";
+type FallbackCandidateCheck = {
+    candidate: ServiceIdRef;
+    ok: boolean;
+    reasons: FallbackCheckReason[];
+};
+type FallbackCheckResult = {
+    context: FallbackScopeRef;
+    /**
+     * Resolved primary when known.
+     * For global scope this should normally equal context.primary.
+     */
+    primary?: ServiceIdRef;
+    allowed: ServiceIdRef[];
+    rejected: FallbackCandidateCheck[];
+    warnings: FallbackCheckReason[];
+};
+type FallbackEditorState = {
+    original: ServiceFallback;
+    current: ServiceFallback;
+    changed: boolean;
+};
+type FallbackEditorOptions = {
+    /**
+     * The editable payload.
+     * The editor clones this and never mutates the caller’s object directly.
+     */
+    fallbacks?: ServiceFallback;
+    /**
+     * Optional read-only source used to resolve node→service ownership
+     * and validate node-scoped registrations.
+     */
+    props?: ServiceProps;
+    /**
+     * Optional runtime context enhancer.
+     * Useful for ambiguous node contexts / diagnostics.
+     */
+    snapshot?: OrderSnapshot;
+    /**
+     * Optional service map used for rate / existence validation.
+     */
+    services?: FallbackEditorServiceMap;
+    /**
+     * Optional fallback policy.
+     */
+    settings?: FallbackSettings;
+};
+type FallbackMutationOptions = {
+    /**
+     * When true, reject candidates failing validation.
+     * When false, keep structurally valid values and return warnings.
+     */
+    strict?: boolean;
+    /**
+     * Optional insert position for add/addMany.
+     * Omit to append.
+     */
+    index?: number;
+};
+interface FallbackEditor {
+    /** Returns original + current editable state */
+    state(): FallbackEditorState;
+    /** Returns the current editable fallback payload */
+    value(): ServiceFallback;
+    /** Restores current back to original */
+    reset(): FallbackEditorState;
+    /**
+     * Returns all registrations belonging to a given primary DGP service.
+     *
+     * With ServiceProps:
+     * - includes global registrations
+     * - includes node registrations whose node resolves to this primary
+     *
+     * Without ServiceProps:
+     * - global registrations only
+     */
+    get(serviceId: ServiceIdRef): FallbackRegistration[];
+    /**
+     * Direct/raw scope lookup.
+     * - global => current.global[primary] ?? []
+     * - node   => current.nodes[nodeId] ?? []
+     */
+    getScope(context: FallbackScopeRef): ServiceIdRef[];
+    /**
+     * Pure validation/preview.
+     * If candidates omitted, validates the currently stored scope value.
+     */
+    check(context: FallbackScopeRef, candidates?: ServiceIdRef[]): FallbackCheckResult;
+    /** Adds one candidate to an exact scope */
+    add(context: FallbackScopeRef, candidate: ServiceIdRef, options?: FallbackMutationOptions): FallbackEditorState;
+    /** Adds many candidates to an exact scope */
+    addMany(context: FallbackScopeRef, candidates: ServiceIdRef[], options?: FallbackMutationOptions): FallbackEditorState;
+    /** Removes one candidate from an exact scope */
+    remove(context: FallbackScopeRef, candidate: ServiceIdRef): FallbackEditorState;
+    /** Replaces the exact scope value */
+    replace(context: FallbackScopeRef, candidates: ServiceIdRef[], options?: FallbackMutationOptions): FallbackEditorState;
+    /** Clears one exact scope value */
+    clear(context: FallbackScopeRef): FallbackEditorState;
+}
+declare function createFallbackEditor(options?: FallbackEditorOptions): FallbackEditor;
+
 type PricingRole = "base" | "utility";
 type FieldType = "custom" | (string & {});
 /** ── Marker types (live inside meta; non-breaking) ───────────────────── */
@@ -214,14 +589,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";
 /**
@@ -449,137 +816,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;
@@ -628,111 +864,6 @@ interface Builder {
     getNodeMap(): NodeMap;
 }
 
-interface ButtonValue {
-    id: string;
-    value: string | number;
-    service_id?: number;
-    pricing_role?: "base" | "utility";
-    meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
-}
-type Scalar = string | number | boolean | ButtonValue | null;
-type UtilityMode = "flat" | "per_quantity" | "per_value" | "percent";
-type QuantityRule$1 = {
-    valueBy: "value" | "length" | "eval";
-    code?: string;
-};
-type UtilityLineItem = {
-    nodeId: string;
-    mode: UtilityMode;
-    rate: number;
-    inputs: {
-        quantity: number;
-        value?: Scalar | Scalar[];
-        valueBy?: "value" | "length" | "eval";
-        evalCodeUsed?: boolean;
-    };
-};
-type ServiceFallbacks = {
-    nodes?: Record<string, Array<string | number>>;
-    global?: Record<string | number, Array<string | number>>;
-};
-type FallbackDiagnostics = {
-    scope: "node" | "global";
-    nodeId?: string;
-    primary: string | number;
-    candidate: string | number;
-    reasons: Array<"rate_violation" | "constraint_mismatch" | "unknown_service" | "ambiguous_context">;
-};
-type SnapshotContext = {
-    /** The single active tag id for this order */
-    tag: string;
-    /** Effective (post-propagation) constraints on that tag */
-    constraints: Partial<Record<"refill" | "cancel" | "dripfeed", boolean>>;
-    /**
-     * Per-node evaluation context:
-     * - For the active tag node itself: the same tag id.
-     * - For an option node: parent's field.bind_id must include this tag to be applicable; otherwise null.
-     * - For a field node (optional to include later): same rule as option, derived from field.bind_id.
-     */
-    nodeContexts: Record<string, string | null>;
-    /** Client pruning policy used (so server can mirror/compare). */
-    policy: {
-        ratePolicy: {
-            kind: "lte_primary" | "none";
-            thresholdPct?: number;
-        };
-        requireConstraintFit: boolean;
-    };
-};
-type OrderSnapshot = {
-    version: "1";
-    mode: "prod" | "dev";
-    builtAt: string;
-    selection: {
-        tag: string;
-        fields: Array<{
-            id: string;
-            type: string;
-            selectedOptions?: string[];
-        }>;
-    };
-    inputs: {
-        form: Record<string, Scalar | Scalar[]>;
-        selections: Record<string, string[]>;
-    };
-    quantity: number;
-    quantitySource: {
-        kind: "field" | "tag" | "option" | "default";
-        id?: string;
-        rule?: QuantityRule$1;
-        defaultedFromHost?: boolean;
-    };
-    min: number;
-    max: number;
-    services: Array<string | number>;
-    serviceMap: Record<string, Array<string | number>>;
-    fallbacks?: {
-        nodes?: Record<string, Array<string | number>>;
-        global?: Record<string | number, Array<string | number>>;
-    };
-    utilities?: UtilityLineItem[];
-    warnings?: {
-        utility?: Array<{
-            nodeId: string;
-            reason: string;
-        }>;
-        fallbacks?: FallbackDiagnostics[];
-    };
-    meta?: {
-        schema_version?: string;
-        workspaceId?: string;
-        builder?: {
-            commit?: string;
-        };
-        context?: SnapshotContext;
-    };
-};
-
 type Env = "client" | "workspace";
 type VisibleGroup = {
     tagId?: string;
@@ -782,10 +913,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;
@@ -1590,13 +1745,8 @@ type FormProviderProps = {
         values?: Dict;
         selections?: Record<string, string[]>;
     };
-    /**
-     * Called on every palette update (values bag).
-     * Use to persist anywhere (state/localStorage/etc).
-     */
-    onUpdate?: (vals: Dict) => void;
 };
-declare function FormProvider({ children, schema, initial, onUpdate, }: FormProviderProps): react_jsx_runtime.JSX.Element;
+declare function FormProvider({ children, schema, initial }: FormProviderProps): react_jsx_runtime.JSX.Element;
 
 /** Matches your InputWrapper’s expectations */
 type InputKind = string;
@@ -1608,6 +1758,7 @@ type AdapterCtx = {
 type Adapter = {
     valueProp?: string;
     changeProp?: string;
+    errorProp?: string;
     /** normalize what the host emitted into what we store in form-palette */
     getValue?: (next: unknown, current: unknown, ctx: AdapterCtx) => unknown;
     /** REQUIRED if field.options exists */
@@ -1664,8 +1815,9 @@ type InputWrapperProps = {
     extraProps?: Record<string, unknown>;
     templateStrings?: boolean;
     ctxOverrides?: Record<string, unknown>;
+    className?: string;
 };
-declare function Wrapper({ field, disabled, extraProps, templateStrings, ctxOverrides, }: InputWrapperProps): react_jsx_runtime.JSX.Element | null;
+declare function Wrapper({ field, disabled, extraProps, templateStrings, ctxOverrides, className, }: InputWrapperProps): react_jsx_runtime.JSX.Element | null;
 
 type OrderFlowInit = {
     mode?: "prod" | "dev";
@@ -1685,6 +1837,7 @@ type OrderFlowInit = {
      * Host props provided to further enhance the nodes data
      */
     ctx?: Record<string, unknown>;
+    normalizeRate?(svc: DgpServiceCapability): number;
 };
 type ProviderFlow = {
     builder: Builder;
@@ -1817,7 +1970,7 @@ type UseOrderFlowReturn = {
         clearFirst?: boolean;
     }) => void;
     /** VALIDATES via form.submit() */
-    buildSnapshot: () => OrderSnapshot;
+    buildSnapshot: () => OrderSnapshot | undefined;
     fallbackPolicy: FallbackSettings;
     setFallbackPolicy: (next: FallbackSettings) => void;
 };
@@ -1829,4 +1982,4 @@ declare function useOrderFlow(): UseOrderFlowReturn;
  */
 declare function registerEntries(registry: Registry): void;
 
-export { type Adapter, type AdapterCtx, type AdminPolicies, type BaseFieldUI, type ButtonValue, CanvasAPI, type CanvasEvents, type CanvasOptions, type CanvasState, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, EventBus, type EventMap, type FallbackDiagnostics, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type InputDescriptor, type InputKind, type InputVariant, type InputWrapperProps, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, OrderFlowProvider, type OrderSnapshot, type PricingRole, Provider, type QuantityMark, type QuantityRule$1 as QuantityRule, type RatePolicy, type Registry, type Scalar, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, Wrapper, createInputRegistry, registerEntries, resolveInputDescriptor, useFormApi, useInputs, useOptionalFormApi, useOrderFlow, useOrderFlowContext };
+export { type Adapter, type AdapterCtx, type AdminPolicies, type BaseFieldUI, type ButtonValue, CanvasAPI, type CanvasEvents, type CanvasOptions, type CanvasState, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, EventBus, type EventMap, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type FormApi, FormProvider, type FormProviderProps, type FormSnapshot, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type InputDescriptor, type InputKind, type InputVariant, type InputWrapperProps, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, OrderFlowProvider, type OrderSnapshot, type PricingRole, Provider, type QuantityMark, type QuantityRule$1 as QuantityRule, type RatePolicy, type Registry, type Scalar, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, Wrapper, createFallbackEditor, createInputRegistry, registerEntries, resolveInputDescriptor, useFormApi, useInputs, useOptionalFormApi, useOrderFlow, useOrderFlowContext };