@dreamboard-games/sdk 0.2.1-alpha.0 → 0.3.0-alpha.1

package/dist/browser-interaction.d.ts

@@ -0,0 +1,708 @@
+import { m as BrowserInteractionEffectPattern, J as BrowserInteractionSurfaceEffect, M as CanonicalBrowserInteractionValue, Y as GameplaySemanticEffect, I as BrowserInteractionSurfaceDefinition, y as BrowserInteractionRegistry, H as BrowserInteractionSurface, s as BrowserInteractionIntent, g as BrowserInteractionActuator, K as BrowserInteractionSurfaceSnapshot, F as BrowserInteractionSemanticSurfaceSnapshot, w as BrowserInteractionRawRecord, G as BrowserInteractionSnapshot, i as BrowserInteractionActuatorKind, l as BrowserInteractionDiagnostic, n as BrowserInteractionEffectRequest, o as BrowserInteractionEffectResolution, t as BrowserInteractionIntentRequest, z as BrowserInteractionResolution } from './attributes-BeRyboMS.js';
+export { B as BROWSER_INTERACTION_ACTUATOR_KINDS, a as BROWSER_INTERACTION_ATTRIBUTES, b as BROWSER_INTERACTION_CANDIDATE_STATES, c as BROWSER_INTERACTION_READINESS_VALUES, d as BROWSER_INTERACTION_RECORD_ROLES, e as BrowserGameplayInteraction, f as BrowserGameplaySurfaceSnapshot, h as BrowserInteractionActuatorAttributesInput, j as BrowserInteractionAttributeMap, k as BrowserInteractionCandidateState, p as BrowserInteractionEffectResolutionFailure, q as BrowserInteractionEffectResolutionSuccess, r as BrowserInteractionEntity, u as BrowserInteractionPreparationTarget, v as BrowserInteractionProtocolIdentity, x as BrowserInteractionReadiness, A as BrowserInteractionResolutionFailure, C as BrowserInteractionResolutionSuccess, D as BrowserInteractionRootAttributesInput, E as BrowserInteractionScalarPattern, L as BrowserInteractionUnknownSurfaceSnapshot, N as DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_NAME, O as DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION, P as GAMEPLAY_BROWSER_INTERACTION_EFFECT_KINDS, Q as GAMEPLAY_BROWSER_INTERACTION_INTENTS, R as GAMEPLAY_BROWSER_INTERACTION_SURFACE, S as GameplayActuatorAttributesInput, T as GameplayBrowserInteractionEffectKind, U as GameplayBrowserInteractionEffectRequest, V as GameplayBrowserInteractionIntent, W as GameplayBrowserInteractionSurface, X as GameplayInteractionRootAttributesInput, Z as GameplaySemanticEffectPattern, _ as compareStableJson, $ as createBrowserInteractionActuatorAttributes, a0 as createBrowserInteractionActuatorKey, a1 as createBrowserInteractionRootAttributes, a2 as createGameplayActuatorAttributes, a3 as createGameplayInteractionRootAttributes, a4 as decodeCanonicalCandidateValue, a5 as encodeCanonicalCandidateValue } from './attributes-BeRyboMS.js';
+import { z } from 'zod';
+
+declare function encodeBrowserInteractionEffect(effect: BrowserInteractionSurfaceEffect): string;
+declare function decodeBrowserInteractionEffect(encoded: string): BrowserInteractionSurfaceEffect;
+declare function encodeBrowserInteractionEffectPattern(pattern: BrowserInteractionEffectPattern): string;
+declare function decodeBrowserInteractionEffectPattern(encoded: string): BrowserInteractionEffectPattern;
+declare function browserInteractionEffectPatternMatches(pattern: BrowserInteractionEffectPattern, effect: BrowserInteractionSurfaceEffect): boolean;
+declare function assertBrowserInteractionEffectPattern(value: unknown): asserts value is BrowserInteractionEffectPattern;
+declare function gameplaySetCandidateEffect(input: {
+    readonly inputKey: string;
+    readonly candidateValue: CanonicalBrowserInteractionValue;
+    readonly beforeSelected: boolean;
+    readonly afterSelected: boolean;
+}): GameplaySemanticEffect;
+declare function gameplayAdjustResourceEffect(input: {
+    readonly inputKey: string;
+    readonly resourceKey: CanonicalBrowserInteractionValue;
+    readonly delta: -1 | 1;
+}): GameplaySemanticEffect;
+declare function gameplaySetScalarEffect(input: {
+    readonly inputKey: string;
+    readonly value: number;
+}): GameplaySemanticEffect;
+declare function gameplayCommitEffect(): GameplaySemanticEffect;
+declare function gameplayInvokeEffect(): GameplaySemanticEffect;
+
+declare function defineBrowserInteractionSurface<Surface extends BrowserInteractionSurface, Intent extends BrowserInteractionIntent>(definition: BrowserInteractionSurfaceDefinition<Surface, Intent>): BrowserInteractionSurfaceDefinition<Surface, Intent>;
+declare const gameplayBrowserInteractionSurface: BrowserInteractionSurfaceDefinition<"gameplay", "arm" | "reveal" | "invoke" | "select" | "toggle" | "increment" | "decrement" | "fill" | "submit", string>;
+declare function createBrowserInteractionRegistry(definitions?: readonly BrowserInteractionSurfaceDefinition[]): BrowserInteractionRegistry;
+declare const defaultBrowserInteractionRegistry: BrowserInteractionRegistry;
+
+interface NormalizeBrowserInteractionRecordsOptions {
+    readonly registry?: BrowserInteractionRegistry;
+}
+declare function normalizeBrowserInteractionRecords(records: readonly BrowserInteractionRawRecord[], options?: NormalizeBrowserInteractionRecordsOptions): BrowserInteractionSnapshot;
+declare function validateBrowserInteractionSnapshot(snapshot: BrowserInteractionSnapshot): readonly BrowserInteractionDiagnostic[];
+declare function actuatorIdentityKey(input: {
+    readonly surface: string;
+    readonly scopeId: string;
+    readonly interactionKey: string;
+    readonly actuator: Pick<BrowserInteractionActuator, "intent" | "inputKey" | "candidateValueKey" | "actuatorKind">;
+}): string;
+declare function isSemanticSurfaceSnapshot(surface: BrowserInteractionSurfaceSnapshot): surface is BrowserInteractionSemanticSurfaceSnapshot;
+declare function targetIdentityKey(input: {
+    readonly surface: string;
+    readonly scopeId: string;
+    readonly interactionKey: string;
+    readonly target: {
+        readonly intent: string;
+        readonly inputKey?: string;
+        readonly candidateValueKey?: string;
+        readonly actuatorKind?: BrowserInteractionActuatorKind;
+    };
+}): string;
+
+declare function resolveBrowserInteractionIntent(snapshot: BrowserInteractionSnapshot, request: BrowserInteractionIntentRequest): BrowserInteractionResolution;
+declare function resolveBrowserInteractionEffect(snapshot: BrowserInteractionSnapshot, request: BrowserInteractionEffectRequest): BrowserInteractionEffectResolution;
+
+declare const browserInteractionEffectSchema: z.ZodObject<{
+    kind: z.ZodString;
+}, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+declare const browserInteractionEffectPatternSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"exact">;
+    effect: z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"match">;
+    effectKind: z.ZodString;
+    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    scalar: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        integer: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+declare const gameplaySemanticEffectSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"setCandidate">;
+    inputKey: z.ZodString;
+    candidateValue: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    beforeSelected: z.ZodBoolean;
+    afterSelected: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"adjustResource">;
+    inputKey: z.ZodString;
+    resourceKey: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    delta: z.ZodUnion<readonly [z.ZodLiteral<-1>, z.ZodLiteral<1>]>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"setScalar">;
+    inputKey: z.ZodString;
+    value: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"commit">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"invoke">;
+}, z.core.$strip>]>;
+declare const browserInteractionDiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+    surface: z.ZodOptional<z.ZodString>;
+    scopeId: z.ZodOptional<z.ZodString>;
+    interactionKey: z.ZodOptional<z.ZodString>;
+    intent: z.ZodOptional<z.ZodString>;
+    actuatorId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const browserInteractionActuatorSchema: z.ZodObject<{
+    actuatorId: z.ZodString;
+    intent: z.ZodString;
+    inputKey: z.ZodOptional<z.ZodString>;
+    candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+    candidateValueKey: z.ZodOptional<z.ZodString>;
+    candidateState: z.ZodOptional<z.ZodEnum<{
+        selected: "selected";
+        unselected: "unselected";
+        mixed: "mixed";
+    }>>;
+    enabled: z.ZodBoolean;
+    actuatorKind: z.ZodEnum<{
+        fill: "fill";
+        click: "click";
+        keyboard: "keyboard";
+        pointer: "pointer";
+    }>;
+    semanticEffects: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+    }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
+    acceptedEffectPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"exact">;
+        effect: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"match">;
+        effectKind: z.ZodString;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+        scalar: z.ZodOptional<z.ZodObject<{
+            field: z.ZodString;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            integer: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    preparationPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"exact">;
+        effect: z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"match">;
+        effectKind: z.ZodString;
+        fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+        scalar: z.ZodOptional<z.ZodObject<{
+            field: z.ZodString;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            integer: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    prepares: z.ZodOptional<z.ZodObject<{
+        intent: z.ZodString;
+        inputKey: z.ZodOptional<z.ZodString>;
+        candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+        candidateValueKey: z.ZodOptional<z.ZodString>;
+        actuatorKind: z.ZodOptional<z.ZodEnum<{
+            fill: "fill";
+            click: "click";
+            keyboard: "keyboard";
+            pointer: "pointer";
+        }>>;
+    }, z.core.$strip>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserGameplayInteractionSchema: z.ZodObject<{
+    interactionKey: z.ZodString;
+    interactionId: z.ZodString;
+    descriptorDigest: z.ZodOptional<z.ZodString>;
+    draftDigest: z.ZodOptional<z.ZodString>;
+    readiness: z.ZodEnum<{
+        ready: "ready";
+        blocked: "blocked";
+        unavailable: "unavailable";
+    }>;
+    actuators: z.ZodArray<z.ZodObject<{
+        actuatorId: z.ZodString;
+        intent: z.ZodString;
+        inputKey: z.ZodOptional<z.ZodString>;
+        candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+        candidateValueKey: z.ZodOptional<z.ZodString>;
+        candidateState: z.ZodOptional<z.ZodEnum<{
+            selected: "selected";
+            unselected: "unselected";
+            mixed: "mixed";
+        }>>;
+        enabled: z.ZodBoolean;
+        actuatorKind: z.ZodEnum<{
+            fill: "fill";
+            click: "click";
+            keyboard: "keyboard";
+            pointer: "pointer";
+        }>;
+        semanticEffects: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+        }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
+        acceptedEffectPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"exact">;
+            effect: z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"match">;
+            effectKind: z.ZodString;
+            fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            scalar: z.ZodOptional<z.ZodObject<{
+                field: z.ZodString;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                integer: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+        preparationPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"exact">;
+            effect: z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"match">;
+            effectKind: z.ZodString;
+            fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            scalar: z.ZodOptional<z.ZodObject<{
+                field: z.ZodString;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                integer: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>;
+        prepares: z.ZodOptional<z.ZodObject<{
+            intent: z.ZodString;
+            inputKey: z.ZodOptional<z.ZodString>;
+            candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+            candidateValueKey: z.ZodOptional<z.ZodString>;
+            actuatorKind: z.ZodOptional<z.ZodEnum<{
+                fill: "fill";
+                click: "click";
+                keyboard: "keyboard";
+                pointer: "pointer";
+            }>>;
+        }, z.core.$strip>>;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            surface: z.ZodOptional<z.ZodString>;
+            scopeId: z.ZodOptional<z.ZodString>;
+            interactionKey: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
+            actuatorId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserGameplaySurfaceSnapshotSchema: z.ZodObject<{
+    surface: z.ZodLiteral<"gameplay">;
+    scopeId: z.ZodString;
+    interactions: z.ZodArray<z.ZodObject<{
+        interactionKey: z.ZodString;
+        interactionId: z.ZodString;
+        descriptorDigest: z.ZodOptional<z.ZodString>;
+        draftDigest: z.ZodOptional<z.ZodString>;
+        readiness: z.ZodEnum<{
+            ready: "ready";
+            blocked: "blocked";
+            unavailable: "unavailable";
+        }>;
+        actuators: z.ZodArray<z.ZodObject<{
+            actuatorId: z.ZodString;
+            intent: z.ZodString;
+            inputKey: z.ZodOptional<z.ZodString>;
+            candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+            candidateValueKey: z.ZodOptional<z.ZodString>;
+            candidateState: z.ZodOptional<z.ZodEnum<{
+                selected: "selected";
+                unselected: "unselected";
+                mixed: "mixed";
+            }>>;
+            enabled: z.ZodBoolean;
+            actuatorKind: z.ZodEnum<{
+                fill: "fill";
+                click: "click";
+                keyboard: "keyboard";
+                pointer: "pointer";
+            }>;
+            semanticEffects: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
+            acceptedEffectPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"exact">;
+                effect: z.ZodObject<{
+                    kind: z.ZodString;
+                }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"match">;
+                effectKind: z.ZodString;
+                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                scalar: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    min: z.ZodOptional<z.ZodNumber>;
+                    max: z.ZodOptional<z.ZodNumber>;
+                    integer: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
+            preparationPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"exact">;
+                effect: z.ZodObject<{
+                    kind: z.ZodString;
+                }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"match">;
+                effectKind: z.ZodString;
+                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                scalar: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    min: z.ZodOptional<z.ZodNumber>;
+                    max: z.ZodOptional<z.ZodNumber>;
+                    integer: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
+            prepares: z.ZodOptional<z.ZodObject<{
+                intent: z.ZodString;
+                inputKey: z.ZodOptional<z.ZodString>;
+                candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+                candidateValueKey: z.ZodOptional<z.ZodString>;
+                actuatorKind: z.ZodOptional<z.ZodEnum<{
+                    fill: "fill";
+                    click: "click";
+                    keyboard: "keyboard";
+                    pointer: "pointer";
+                }>>;
+            }, z.core.$strip>>;
+            diagnostics: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                severity: z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                }>;
+                message: z.ZodString;
+                surface: z.ZodOptional<z.ZodString>;
+                scopeId: z.ZodOptional<z.ZodString>;
+                interactionKey: z.ZodOptional<z.ZodString>;
+                intent: z.ZodOptional<z.ZodString>;
+                actuatorId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            surface: z.ZodOptional<z.ZodString>;
+            scopeId: z.ZodOptional<z.ZodString>;
+            interactionKey: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
+            actuatorId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserSemanticSurfaceSnapshotSchema: z.ZodObject<{
+    surface: z.ZodString;
+    scopeId: z.ZodString;
+    interactions: z.ZodArray<z.ZodObject<{
+        interactionKey: z.ZodString;
+        interactionId: z.ZodString;
+        descriptorDigest: z.ZodOptional<z.ZodString>;
+        draftDigest: z.ZodOptional<z.ZodString>;
+        readiness: z.ZodEnum<{
+            ready: "ready";
+            blocked: "blocked";
+            unavailable: "unavailable";
+        }>;
+        actuators: z.ZodArray<z.ZodObject<{
+            actuatorId: z.ZodString;
+            intent: z.ZodString;
+            inputKey: z.ZodOptional<z.ZodString>;
+            candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+            candidateValueKey: z.ZodOptional<z.ZodString>;
+            candidateState: z.ZodOptional<z.ZodEnum<{
+                selected: "selected";
+                unselected: "unselected";
+                mixed: "mixed";
+            }>>;
+            enabled: z.ZodBoolean;
+            actuatorKind: z.ZodEnum<{
+                fill: "fill";
+                click: "click";
+                keyboard: "keyboard";
+                pointer: "pointer";
+            }>;
+            semanticEffects: z.ZodArray<z.ZodObject<{
+                kind: z.ZodString;
+            }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
+            acceptedEffectPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"exact">;
+                effect: z.ZodObject<{
+                    kind: z.ZodString;
+                }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"match">;
+                effectKind: z.ZodString;
+                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                scalar: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    min: z.ZodOptional<z.ZodNumber>;
+                    max: z.ZodOptional<z.ZodNumber>;
+                    integer: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
+            preparationPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"exact">;
+                effect: z.ZodObject<{
+                    kind: z.ZodString;
+                }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+            }, z.core.$strip>, z.ZodObject<{
+                kind: z.ZodLiteral<"match">;
+                effectKind: z.ZodString;
+                fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                scalar: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    min: z.ZodOptional<z.ZodNumber>;
+                    max: z.ZodOptional<z.ZodNumber>;
+                    integer: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>]>>;
+            prepares: z.ZodOptional<z.ZodObject<{
+                intent: z.ZodString;
+                inputKey: z.ZodOptional<z.ZodString>;
+                candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+                candidateValueKey: z.ZodOptional<z.ZodString>;
+                actuatorKind: z.ZodOptional<z.ZodEnum<{
+                    fill: "fill";
+                    click: "click";
+                    keyboard: "keyboard";
+                    pointer: "pointer";
+                }>>;
+            }, z.core.$strip>>;
+            diagnostics: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                severity: z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                }>;
+                message: z.ZodString;
+                surface: z.ZodOptional<z.ZodString>;
+                scopeId: z.ZodOptional<z.ZodString>;
+                interactionKey: z.ZodOptional<z.ZodString>;
+                intent: z.ZodOptional<z.ZodString>;
+                actuatorId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            surface: z.ZodOptional<z.ZodString>;
+            scopeId: z.ZodOptional<z.ZodString>;
+            interactionKey: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
+            actuatorId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserUnknownSurfaceSnapshotSchema: z.ZodObject<{
+    surface: z.ZodString;
+    scopeId: z.ZodString;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const browserInteractionSnapshotSchema: z.ZodObject<{
+    protocol: z.ZodObject<{
+        name: z.ZodLiteral<"dreamboard-browser-interaction">;
+        version: z.ZodLiteral<"2.0.0">;
+    }, z.core.$strip>;
+    surfaces: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        surface: z.ZodString;
+        scopeId: z.ZodString;
+        interactions: z.ZodArray<z.ZodObject<{
+            interactionKey: z.ZodString;
+            interactionId: z.ZodString;
+            descriptorDigest: z.ZodOptional<z.ZodString>;
+            draftDigest: z.ZodOptional<z.ZodString>;
+            readiness: z.ZodEnum<{
+                ready: "ready";
+                blocked: "blocked";
+                unavailable: "unavailable";
+            }>;
+            actuators: z.ZodArray<z.ZodObject<{
+                actuatorId: z.ZodString;
+                intent: z.ZodString;
+                inputKey: z.ZodOptional<z.ZodString>;
+                candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+                candidateValueKey: z.ZodOptional<z.ZodString>;
+                candidateState: z.ZodOptional<z.ZodEnum<{
+                    selected: "selected";
+                    unselected: "unselected";
+                    mixed: "mixed";
+                }>>;
+                enabled: z.ZodBoolean;
+                actuatorKind: z.ZodEnum<{
+                    fill: "fill";
+                    click: "click";
+                    keyboard: "keyboard";
+                    pointer: "pointer";
+                }>;
+                semanticEffects: z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
+                acceptedEffectPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"exact">;
+                    effect: z.ZodObject<{
+                        kind: z.ZodString;
+                    }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"match">;
+                    effectKind: z.ZodString;
+                    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                    scalar: z.ZodOptional<z.ZodObject<{
+                        field: z.ZodString;
+                        min: z.ZodOptional<z.ZodNumber>;
+                        max: z.ZodOptional<z.ZodNumber>;
+                        integer: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>]>>;
+                preparationPatterns: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"exact">;
+                    effect: z.ZodObject<{
+                        kind: z.ZodString;
+                    }, z.core.$catchall<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    kind: z.ZodLiteral<"match">;
+                    effectKind: z.ZodString;
+                    fields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+                    scalar: z.ZodOptional<z.ZodObject<{
+                        field: z.ZodString;
+                        min: z.ZodOptional<z.ZodNumber>;
+                        max: z.ZodOptional<z.ZodNumber>;
+                        integer: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>]>>;
+                prepares: z.ZodOptional<z.ZodObject<{
+                    intent: z.ZodString;
+                    inputKey: z.ZodOptional<z.ZodString>;
+                    candidateValue: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+                    candidateValueKey: z.ZodOptional<z.ZodString>;
+                    actuatorKind: z.ZodOptional<z.ZodEnum<{
+                        fill: "fill";
+                        click: "click";
+                        keyboard: "keyboard";
+                        pointer: "pointer";
+                    }>>;
+                }, z.core.$strip>>;
+                diagnostics: z.ZodArray<z.ZodObject<{
+                    code: z.ZodString;
+                    severity: z.ZodEnum<{
+                        error: "error";
+                        warning: "warning";
+                    }>;
+                    message: z.ZodString;
+                    surface: z.ZodOptional<z.ZodString>;
+                    scopeId: z.ZodOptional<z.ZodString>;
+                    interactionKey: z.ZodOptional<z.ZodString>;
+                    intent: z.ZodOptional<z.ZodString>;
+                    actuatorId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            diagnostics: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                severity: z.ZodEnum<{
+                    error: "error";
+                    warning: "warning";
+                }>;
+                message: z.ZodString;
+                surface: z.ZodOptional<z.ZodString>;
+                scopeId: z.ZodOptional<z.ZodString>;
+                interactionKey: z.ZodOptional<z.ZodString>;
+                intent: z.ZodOptional<z.ZodString>;
+                actuatorId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            surface: z.ZodOptional<z.ZodString>;
+            scopeId: z.ZodOptional<z.ZodString>;
+            interactionKey: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
+            actuatorId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        surface: z.ZodString;
+        scopeId: z.ZodString;
+        diagnostics: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            severity: z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            surface: z.ZodOptional<z.ZodString>;
+            scopeId: z.ZodOptional<z.ZodString>;
+            interactionKey: z.ZodOptional<z.ZodString>;
+            intent: z.ZodOptional<z.ZodString>;
+            actuatorId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        surface: z.ZodOptional<z.ZodString>;
+        scopeId: z.ZodOptional<z.ZodString>;
+        interactionKey: z.ZodOptional<z.ZodString>;
+        intent: z.ZodOptional<z.ZodString>;
+        actuatorId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+
+export { BrowserInteractionActuator, BrowserInteractionActuatorKind, BrowserInteractionDiagnostic, BrowserInteractionEffectPattern, BrowserInteractionEffectRequest, BrowserInteractionEffectResolution, BrowserInteractionIntent, BrowserInteractionIntentRequest, BrowserInteractionRawRecord, BrowserInteractionRegistry, BrowserInteractionResolution, BrowserInteractionSemanticSurfaceSnapshot, BrowserInteractionSnapshot, BrowserInteractionSurface, BrowserInteractionSurfaceDefinition, BrowserInteractionSurfaceEffect, BrowserInteractionSurfaceSnapshot, CanonicalBrowserInteractionValue, GameplaySemanticEffect, type NormalizeBrowserInteractionRecordsOptions, actuatorIdentityKey, assertBrowserInteractionEffectPattern, browserGameplayInteractionSchema, browserGameplaySurfaceSnapshotSchema, browserInteractionActuatorSchema, browserInteractionDiagnosticSchema, browserInteractionEffectPatternMatches, browserInteractionEffectPatternSchema, browserInteractionEffectSchema, browserInteractionSnapshotSchema, browserSemanticSurfaceSnapshotSchema, browserUnknownSurfaceSnapshotSchema, createBrowserInteractionRegistry, decodeBrowserInteractionEffect, decodeBrowserInteractionEffectPattern, defaultBrowserInteractionRegistry, defineBrowserInteractionSurface, encodeBrowserInteractionEffect, encodeBrowserInteractionEffectPattern, gameplayAdjustResourceEffect, gameplayBrowserInteractionSurface, gameplayCommitEffect, gameplayInvokeEffect, gameplaySemanticEffectSchema, gameplaySetCandidateEffect, gameplaySetScalarEffect, isSemanticSurfaceSnapshot, normalizeBrowserInteractionRecords, resolveBrowserInteractionEffect, resolveBrowserInteractionIntent, targetIdentityKey, validateBrowserInteractionSnapshot };