@dreamboard-games/ui-sdk 0.0.43 → 0.0.46

package/dist/hooks/useBoardInteractions.js

@@ -5,7 +5,8 @@ import { usePluginSession } from "../context/PluginSessionContext.js";
 import { usePluginState } from "../context/PluginStateContext.js";
 import { useRuntimeContext } from "../context/RuntimeContext.js";
 import { validationErrorFromUnknown } from "../errors/ValidationError.js";
-import { eligibleTargetsByBoardKind, eligibleTargetsForInput, hasBoardTargetInput, hasCardTargetInput, hasInteractionFieldErrors, inputByTarget, inputKeyForTarget, isInputValueReady, interactionArmScope, interactionInputKeys, toggleManyValue, validateInteractionInputDomains, } from "../utils/interaction-inputs.js";
+import { applyInteractionInputDefaults, eligibleTargetsByBoardKind, eligibleTargetsForInput, hasBoardTargetInput, hasCardTargetInput, inputByTarget, inputKeyForTarget, } from "../utils/interaction-inputs.js";
+import { claimInteractionSubmit, clearInteractionRoute, getInteractionDraftReadiness, markInteractionPending, routeInteractionTarget, shouldRouteInteractionPending, } from "../utils/interaction-router.js";
 export class BoardInteractionConflictError extends Error {
     constructor({ targetKind, targetId, interactionKeys, }) {
         super(`Ambiguous ${targetKind} target '${targetId}' matched interactions: ${interactionKeys.join(", ")}. Arm one interaction explicitly or route with a narrower board primitive.`);
@@ -20,9 +21,9 @@ export class BoardInteractionConflictError extends Error {
  * wiring many `useInteractionById(...)` calls, merging their
  * eligibility sets, and dispatching clicks to the right handle.
  *
- * Use this alongside (or instead of) `<BoardSurface>` when a game
- * keeps multiple board interactions live simultaneously and dispatch
- * is target-driven rather than armed-then-clicked. The typical
+ * Internal board primitive controller for games that keep multiple board
+ * interactions live simultaneously and dispatch by target geometry. The
+ * typical
  * Catan-class shape:
  *
  * ```tsx
@@ -32,15 +33,16 @@ export class BoardInteractionConflictError extends Error {
  *   <HexGrid
  *     interactiveVertices={board.targetLayers.vertex()}
  *     interactiveEdges={board.targetLayers.edge()}
- *     onTileClick={(id) =>
- *       board.select.space(id, { stealFromPlayerId: null })
- *     }
+ *     onTileClick={(id) => board.select.space(id)}
  *   />
  * );
  * ```
  *
+ * Mount generated interaction routes with `<Interaction.Switch routes={...}>`
+ * for interactions that need more input after a board target is selected.
+ *
  * Eligibility and availability remain authoritative on reducer-projected
- * descriptors. Armed follow-up descriptors beat ambient board descriptors.
+ * descriptors. Armed routed descriptors beat ambient board descriptors.
  * Multiple unarmed matches are ambiguous and throw
  * {@link BoardInteractionConflictError}.
  */
@@ -50,22 +52,30 @@ export function useBoardInteractions(options = {}) {
     const { controllingPlayerId } = usePluginSession();
     const store = useInteractionUiStore();
     const subscribedArmedBySurface = useStore(store, (state) => state.arms);
+    const subscribedDrafts = useStore(store, (state) => state.drafts);
+    const pendingInteractionKey = useStore(store, (state) => state.pendingInteractionKey);
     const armedBySurface = store.getState().arms ?? subscribedArmedBySurface;
+    const drafts = store.getState().drafts ?? subscribedDrafts;
     const descriptors = usePluginState((state) => state.gameplay.availableInteractions ?? []);
     const targetKindSet = useMemo(() => new Set(targetKinds), [targetKinds]);
     const armedIds = useMemo(() => new Set(Object.values(armedBySurface)), [armedBySurface]);
     const interactions = useMemo(() => {
-        return descriptors.filter((descriptor) => {
-            if (armedIds.has(descriptor.interactionKey))
-                return true;
+        return descriptors.flatMap((descriptor) => {
+            if (armedIds.has(descriptor.interactionKey)) {
+                return [
+                    { ...descriptor, interactionKey: descriptor.interactionKey },
+                ];
+            }
             if (hasCardTargetInput(descriptor))
-                return false;
+                return [];
             if (!hasBoardTargetInput(descriptor))
-                return false;
-            if (!targetKinds || targetKinds.length === 0)
-                return true;
-            const byKind = eligibleTargetsByBoardKind(descriptor);
-            return Object.keys(byKind).some((kind) => targetKindSet.has(kind));
+                return [];
+            const include = !targetKinds || targetKinds.length === 0
+                ? true
+                : Object.keys(eligibleTargetsByBoardKind(descriptor)).some((kind) => targetKindSet.has(kind));
+            return include
+                ? [{ ...descriptor, interactionKey: descriptor.interactionKey }]
+                : [];
         });
     }, [armedIds, descriptors, targetKindSet, targetKinds]);
     const eligible = useMemo(() => {
@@ -78,7 +88,7 @@ export function useBoardInteractions(options = {}) {
         for (const descriptor of interactions) {
             if (!descriptor.available)
                 continue;
-            const targetsByKind = eligibleTargetsByBoardKind(descriptor);
+            const targetsByKind = eligibleTargetsByBoardKind(descriptor, drafts[descriptor.interactionKey] ?? {});
             for (const [targetKind, ids] of Object.entries(targetsByKind)) {
                 if (!ids)
                     continue;
@@ -88,7 +98,7 @@ export function useBoardInteractions(options = {}) {
             }
         }
         return acc;
-    }, [interactions]);
+    }, [drafts, interactions]);
     const isEligible = useCallback((targetId, targetKind) => {
         if (targetKind !== undefined) {
             return eligible[targetKind].has(targetId);
@@ -99,21 +109,71 @@ export function useBoardInteractions(options = {}) {
         }
         return false;
     }, [eligible]);
-    const selectByKind = useCallback(async (targetKind, targetId, extraInputs) => {
+    const clearPendingInteraction = useCallback((descriptor) => {
+        clearInteractionRoute(store, descriptor);
+    }, [store]);
+    const resolveSelection = useCallback(async (descriptor, inputKey, targetId, extraInputs) => {
         if (!controllingPlayerId)
-            return null;
+            return { status: "none" };
+        const { params, readiness } = routeInteractionTarget(store, descriptor, {
+            inputKey,
+            value: targetId,
+            extraInputs,
+        });
+        if (shouldRouteInteractionPending(descriptor, readiness)) {
+            markInteractionPending(store, descriptor);
+            return {
+                status: "pending",
+                interactionKey: descriptor.interactionKey,
+                descriptor,
+                missingInputs: readiness.missingInputs,
+            };
+        }
+        const submitParams = applyInteractionInputDefaults(descriptor, params);
+        if (!claimInteractionSubmit(store, descriptor)) {
+            return {
+                status: "submitted",
+                interactionKey: descriptor.interactionKey,
+                descriptor,
+            };
+        }
+        try {
+            await runtime.submitInteraction(controllingPlayerId, descriptor.interactionId, submitParams);
+            clearPendingInteraction(descriptor);
+            return {
+                status: "submitted",
+                interactionKey: descriptor.interactionKey,
+                descriptor,
+            };
+        }
+        catch (error) {
+            throw validationErrorFromUnknown(error);
+        }
+        finally {
+            store.setSubmitting(descriptor.interactionKey, false);
+        }
+    }, [clearPendingInteraction, controllingPlayerId, runtime, store]);
+    const resolveTargetMatches = useCallback((targetKind, targetId, interactionKeys) => {
+        const allowedInteractionKeys = interactionKeys
+            ? new Set(interactionKeys)
+            : null;
         const matches = interactions.flatMap((descriptor) => {
+            if (allowedInteractionKeys &&
+                !allowedInteractionKeys.has(descriptor.interactionKey)) {
+                return [];
+            }
             if (!descriptor.available)
                 return [];
-            const inputKey = inputKeyForTarget(descriptor, targetKind, targetId);
+            const draft = store.getDraft(descriptor.interactionKey);
+            const inputKey = inputKeyForTarget(descriptor, targetKind, targetId, draft);
             if (!inputKey)
                 return [];
-            const input = inputByTarget(descriptor, targetKind, targetId);
+            const input = inputByTarget(descriptor, targetKind, targetId, draft);
             if (input?.domain.type === "target" &&
                 !isTargetSelectable(input, store.getDraft(descriptor.interactionKey), targetId)) {
                 return [];
             }
-            const targets = eligibleTargetsForInput(descriptor, inputKey);
+            const targets = eligibleTargetsForInput(descriptor, inputKey, draft);
             if (!targets || !targets.includes(targetId))
                 return [];
             return [
@@ -124,79 +184,90 @@ export function useBoardInteractions(options = {}) {
                 },
             ];
         });
+        return matches;
+    }, [armedIds, interactions, store]);
+    const selectByKind = useCallback(async (targetKind, targetId, extraInputs, interactionKeys) => {
+        if (!controllingPlayerId)
+            return { status: "none" };
+        const matches = resolveTargetMatches(targetKind, targetId, interactionKeys);
         const selected = selectDispatchCandidate(matches, targetKind, targetId);
         if (selected) {
             const { descriptor, inputKey } = selected;
-            const input = inputByTarget(descriptor, targetKind, targetId);
-            const currentDraft = store.getDraft(descriptor.interactionKey);
-            const selection = input?.domain.type === "target" ? input.domain.selection : undefined;
-            const nextTargetValue = selection?.mode === "many"
-                ? toggleManyValue(currentDraft[inputKey], targetId, selection)
-                : targetId;
-            const params = {
-                ...currentDraft,
-                ...(extraInputs ?? {}),
-                [inputKey]: nextTargetValue,
-            };
-            for (const [key, value] of Object.entries(extraInputs ?? {})) {
-                store.setInput(descriptor.interactionKey, key, value);
-            }
-            store.setInput(descriptor.interactionKey, inputKey, nextTargetValue);
-            if (descriptor.commit.mode !== "autoWhenReady" ||
-                (selection?.mode === "many" && !isDraftReady(descriptor, params))) {
-                store.arm(interactionArmScope(descriptor), descriptor.interactionKey);
-                return descriptor.interactionKey;
-            }
-            // Fill any remaining required inputs with `null` so the reducer
-            // bundle can decide whether to reject (missing) or accept
-            // (optional). This matches the Catan "spaceId + null stealee"
-            // pattern without forcing callers to memorise each interaction's
-            // full input shape.
-            for (const required of interactionInputKeys(descriptor)) {
-                if (!(required in params))
-                    params[required] = null;
-            }
-            try {
-                await runtime.submitInteraction(controllingPlayerId, descriptor.interactionId, params);
-                store.clearInput(descriptor.interactionKey);
-                if (store.getArmed(interactionArmScope(descriptor)) ===
-                    descriptor.interactionKey) {
-                    store.arm(interactionArmScope(descriptor), null);
-                }
-                return descriptor.interactionKey;
-            }
-            catch (error) {
-                throw validationErrorFromUnknown(error);
-            }
+            return resolveSelection(descriptor, inputKey, targetId, extraInputs);
         }
-        return null;
-    }, [armedIds, controllingPlayerId, interactions, runtime, store]);
+        return { status: "none" };
+    }, [controllingPlayerId, resolveSelection, resolveTargetMatches]);
     const select = useMemo(() => ({
         edge: (targetId, extraInputs) => selectByKind("edge", targetId, extraInputs),
         vertex: (targetId, extraInputs) => selectByKind("vertex", targetId, extraInputs),
         space: (targetId, extraInputs) => selectByKind("space", targetId, extraInputs),
         tile: (targetId, extraInputs) => selectByKind("tile", targetId, extraInputs),
     }), [selectByKind]);
+    const targetState = useCallback((targetKind, targetId, options = {}) => {
+        const enabled = options.enabled !== false;
+        const matches = enabled
+            ? resolveTargetMatches(targetKind, targetId, options.interactionKeys)
+            : [];
+        const armed = matches.filter((match) => match.armed);
+        const candidates = armed.length > 0 ? armed : matches;
+        const selected = candidates[0] ?? null;
+        const conflict = candidates.length > 1;
+        const pending = selected
+            ? pendingInteractionKey === selected.descriptor.interactionKey
+            : false;
+        const eligible = enabled && !!selected && !conflict;
+        return {
+            kind: targetKind,
+            id: targetId,
+            eligible,
+            selectable: eligible && !!controllingPlayerId,
+            hovered: false,
+            interactionKey: selected?.descriptor.interactionKey,
+            interactionId: selected?.descriptor.interactionId,
+            inputKey: selected?.inputKey,
+            pending,
+            conflict,
+            unavailableReason: candidateUnavailableReason(selected, conflict),
+        };
+    }, [controllingPlayerId, pendingInteractionKey, resolveTargetMatches]);
     const targetLayers = useMemo(() => {
         const createLayer = (targetKind) => (layerOptions = {}) => {
-            const { enabled, extraInputs, onBeforeSelect, onError } = layerOptions;
+            const { enabled, interactionKeys, extraInputs, onBeforeSelect, onError, } = layerOptions;
             const resolveExtraInputs = (targetId) => typeof extraInputs === "function"
                 ? extraInputs(targetId)
                 : extraInputs;
             return {
                 enabled,
                 eligible: eligible[targetKind],
+                targetState: (targetId) => ({
+                    ...targetState(targetKind, targetId, { enabled, interactionKeys }),
+                    select: async () => {
+                        if (enabled === false)
+                            return { status: "none" };
+                        onBeforeSelect?.();
+                        try {
+                            return await selectByKind(targetKind, targetId, resolveExtraInputs(targetId), interactionKeys);
+                        }
+                        catch (error) {
+                            onError?.(error);
+                            if (!onError)
+                                throw error;
+                            return { status: "none" };
+                        }
+                    },
+                }),
                 selectTargetId: async (targetId) => {
                     if (enabled === false)
-                        return;
+                        return { status: "none" };
                     onBeforeSelect?.();
                     try {
-                        await select[targetKind](targetId, resolveExtraInputs(targetId));
+                        return await selectByKind(targetKind, targetId, resolveExtraInputs(targetId), interactionKeys);
                     }
                     catch (error) {
                         onError?.(error);
                         if (!onError)
                             throw error;
+                        return { status: "none" };
                     }
                 },
             };
@@ -207,8 +278,40 @@ export function useBoardInteractions(options = {}) {
             space: createLayer("space"),
             tile: createLayer("tile"),
         };
-    }, [eligible, select]);
-    return useMemo(() => ({ interactions, eligible, isEligible, select, targetLayers }), [interactions, eligible, isEligible, select, targetLayers]);
+    }, [eligible, selectByKind, targetState]);
+    const pendingInteraction = useMemo(() => {
+        if (!pendingInteractionKey)
+            return null;
+        const descriptor = interactions.find((candidate) => candidate.interactionKey === pendingInteractionKey);
+        if (!descriptor)
+            return null;
+        return {
+            interactionKey: descriptor.interactionKey,
+            descriptor,
+            missingInputs: missingInputsForDraft(descriptor, drafts[descriptor.interactionKey] ?? {}),
+            clear: () => clearPendingInteraction(descriptor),
+        };
+    }, [clearPendingInteraction, drafts, interactions, pendingInteractionKey]);
+    const selectTarget = useCallback((descriptor, _targetKind, targetId, inputKey, extraInputs) => resolveSelection(descriptor, inputKey, targetId, extraInputs), [resolveSelection]);
+    return useMemo(() => ({
+        interactions,
+        eligible,
+        isEligible,
+        pendingInteraction,
+        select,
+        targetLayers,
+        targetState,
+        selectTarget,
+    }), [
+        interactions,
+        eligible,
+        isEligible,
+        pendingInteraction,
+        select,
+        targetLayers,
+        targetState,
+        selectTarget,
+    ]);
 }
 function isTargetSelectable(input, draft, targetId) {
     const selection = input.domain.type === "target" ? input.domain.selection : undefined;
@@ -221,16 +324,8 @@ function isTargetSelectable(input, draft, targetId) {
         return true;
     return selection.max === undefined || current.length < selection.max;
 }
-function isDraftReady(descriptor, draft) {
-    const fieldErrors = validateInteractionInputDomains(descriptor, draft);
-    if (hasInteractionFieldErrors(fieldErrors))
-        return false;
-    return interactionInputKeys(descriptor).every((key) => {
-        const input = descriptor.inputs.find((candidate) => candidate.key === key);
-        const value = draft[key] ??
-            (input && "defaultValue" in input ? input.defaultValue : undefined);
-        return input ? isInputValueReady(input, value) : value !== undefined;
-    });
+function missingInputsForDraft(descriptor, draft) {
+    return [...getInteractionDraftReadiness(descriptor, draft).missingInputs];
 }
 function selectDispatchCandidate(matches, targetKind, targetId) {
     if (matches.length === 0)
@@ -246,3 +341,12 @@ function selectDispatchCandidate(matches, targetKind, targetId) {
     }
     return candidates[0] ?? null;
 }
+function candidateUnavailableReason(match, conflict) {
+    if (conflict)
+        return "conflict";
+    if (!match)
+        return "unavailable";
+    if (!match.descriptor.available)
+        return "unavailable";
+    return undefined;
+}

package/dist/hooks/useInteractionHandle.d.ts

@@ -76,7 +76,7 @@ export interface InteractionHandle<Params extends InteractionParamsShape = Inter
     isReady: boolean;
     /**
      * True when this interaction is the currently armed one on its surface.
-     * Armed interactions are the ones that surfaces like `BoardSurface` use
+     * Armed interactions are the ones that board primitives use
      * to highlight eligible targets and route clicks.
      */
     isArmed: boolean;

package/dist/hooks/useInteractionHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useInteractionHandle.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteractionHandle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useInteractionHandle.d.ts","sourceRoot":"","sources":["../../src/hooks/useInteractionHandle.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useInteractionHandle.js

@@ -5,7 +5,8 @@ import { usePluginState } from "../context/PluginStateContext.js";
 import { usePluginSession } from "../context/PluginSessionContext.js";
 import { useRuntimeContext } from "../context/RuntimeContext.js";
 import { ValidationError, validationErrorFromUnknown, } from "../errors/ValidationError.js";
-import { applyInteractionInputDefaults, hasInteractionFieldErrors, inputByKey, isInputValueReady, interactionArmScope, interactionInputKeys, mergeInteractionFieldErrors, validateInteractionInputDomains, } from "../utils/interaction-inputs.js";
+import { applyInteractionInputDefaults, hasInteractionFieldErrors, interactionArmScope, interactionInputKeys, mergeInteractionFieldErrors, validateInteractionInputDomains, } from "../utils/interaction-inputs.js";
+import { applyInteractionDraftMutation, claimInteractionSubmit, clearInteractionRoute, getInteractionDraftReadiness, } from "../utils/interaction-router.js";
 /**
  * Bind an {@link InteractionDescriptor} to submit/validate helpers plus
  * draft + arming state. Use this from any surface; draft state is shared
@@ -46,17 +47,8 @@ export function useInteractionHandle(descriptor) {
             ? "submitting"
             : "open";
     const isReady = useMemo(() => {
-        const required = inputKeys;
-        if (required.length === 0)
-            return true;
-        return required.every((key) => {
-            const input = inputByKey(descriptor, key);
-            const value = values[key];
-            return input
-                ? isInputValueReady(input, value)
-                : value !== null && value !== undefined;
-        });
-    }, [descriptor, values, inputKeys]);
+        return getInteractionDraftReadiness(descriptor, values).ready;
+    }, [descriptor, values]);
     const requirePlayer = useCallback(() => {
         if (!controllingPlayerId) {
             throw new Error("useInteractionHandle: no controlling player available");
@@ -69,15 +61,14 @@ export function useInteractionHandle(descriptor) {
                 ? "Interaction has already been submitted."
                 : "Interaction submission is already in progress.");
         }
+        if (!claimInteractionSubmit(store, descriptor)) {
+            throw new ValidationError("SUBMITTING", "Interaction submission is already in progress.");
+        }
         submittingRef.current = true;
-        store.setSubmitting(interactionKey, true);
         const finalParams = applyInteractionInputDefaults(descriptor, params ?? values);
         try {
             await runtime.submitInteraction(requirePlayer(), interactionId, finalParams);
-            store.clearInput(interactionKey);
-            if (store.getArmed(armScope) === interactionKey) {
-                store.arm(armScope, null);
-            }
+            clearInteractionRoute(store, descriptor);
         }
         catch (error) {
             throw validationErrorFromUnknown(error);
@@ -93,7 +84,6 @@ export function useInteractionHandle(descriptor) {
         requirePlayer,
         interactionId,
         interactionKey,
-        armScope,
         store,
         status,
     ]);
@@ -107,13 +97,8 @@ export function useInteractionHandle(descriptor) {
     const validateDraft = useCallback(() => {
         const rawDraft = { ...values };
         const required = inputKeys;
-        const missing = required.filter((key) => {
-            const input = inputByKey(descriptor, key);
-            const value = rawDraft[key];
-            return input
-                ? !isInputValueReady(input, value)
-                : value === null || value === undefined;
-        });
+        const missing = getInteractionDraftReadiness(descriptor, rawDraft)
+            .missingInputs;
         const domainFieldErrors = validateInteractionInputDomains(descriptor, rawDraft);
         if (!paramsSchema) {
             if (missing.length > 0 || hasInteractionFieldErrors(domainFieldErrors)) {
@@ -218,8 +203,8 @@ export function useInteractionHandle(descriptor) {
         validateDraft,
     ]);
     const setInput = useCallback((key, value) => {
-        store.setInput(interactionKey, key, value);
-    }, [store, interactionKey]);
+        applyInteractionDraftMutation(store, descriptor, [{ key, value }]);
+    }, [store, descriptor]);
     const clearInput = useCallback((key) => {
         store.clearInput(interactionKey, key);
     }, [store, interactionKey]);

package/dist/index.d.ts

@@ -1,30 +1,24 @@
-export * from "./reducer.js";
-export { createDreamboardUI, type BoardTargetKey, type CardKey, type DreamboardUI, type DreamboardUIRegister, type InteractionInputKey, type InteractionKey, type PhaseKey, type PromptOptionKey, type PromptKey, type RegisteredUI, type TypedBoard, type TypedInteraction, type TypedPhase, type TypedPlayerRoster, type TypedPrompt, type TypedPromptInbox, type TypedZone, type UIContract, type UIContractBucket, type ZoneKey, } from "./ui-contract.js";
+export { createDreamboardUI, type BoardTargetKey, type CardKey, type DreamboardUI, type DreamboardUIRegister, type InteractionInputKey, type InteractionKey, type PhaseKey, type PromptOptionKey, type PromptKey, type RegisteredUI, type TypedBoard, type TypedGame, type TypedInteraction, type TypedPhase, type TypedPlayerRoster, type TypedPrompt, type TypedPromptInbox, type TypedZone, type UIContract, type UIContractBucket, type ZoneKey, } from "./ui-contract.js";
 export * from "./primitives/index.js";
-export { BoardInteractionConflictError, useBoardInteractions, type BoardInteractionsContext, type BoardInteractionsOptions, type BoardTargetLayerFactory, type BoardTargetLayerOptions, } from "./hooks/useBoardInteractions.js";
-export { useBoardTopology } from "./hooks/useBoardTopology.js";
-export { useCards } from "./hooks/useCards.js";
-export { useHexBoard } from "./hooks/useHexBoard.js";
-export { useSquareBoard } from "./hooks/useSquareBoard.js";
-export { useHandLayout } from "./hooks/useHandLayout.js";
-export { useInteractionByKey } from "./hooks/useInteractionByKey.js";
-export { useIsMobile } from "./hooks/useIsMobile.js";
-export { usePanZoom, calculateViewBox } from "./hooks/usePanZoom.js";
-export { usePluginRuntime } from "./hooks/usePluginRuntime.js";
+export type { BoardSelectionResult } from "./hooks/useBoardInteractions.js";
+export { calculateViewBox } from "./hooks/usePanZoom.js";
 export { toTrackBoardData } from "./helpers/track-board.js";
-export { PluginStateProvider, usePluginActions, usePluginState, } from "./context/PluginStateContext.js";
-export { RuntimeContext, RuntimeProvider, useRuntimeContext, } from "./context/RuntimeContext.js";
+export { PluginStateProvider } from "./context/PluginStateContext.js";
+export { RuntimeContext, RuntimeProvider } from "./context/RuntimeContext.js";
 export { type ClientParamSchema, type ClientParamSchemaMap, } from "./context/ClientParamSchemaContext.js";
 export { ThemeProvider, arcadeTheme, buttonStyle, chipStyle, cssVar, cssVarOr, deriveBoardTheme, getThemePreset, intentForVariant, mergeTheme, motionDuration, playerColor, resolveTheme, studioTheme, surfaceStyle, tabletopTheme, themeToCssVars, useBoardTheme, useTheme, useThemeCssVars, type BoardTheme, type ButtonSize, type ButtonVariant, type ColorRamp, type ComponentTokens, type Elevation, type FoundationColor, type IntentColor, type Motion, type PlayerColor, type Radius, type SemanticColor, type Space, type Theme, type ThemeContextValue, type ThemeMeta, type ThemeOverride, type ThemePresetId, type ThemeProviderProps, type Typography, } from "./theme/index.js";
 export { normalizeHexBoardInput, normalizeSquareBoardInput, } from "./types/tiled-board.js";
-export { InteractionField, InteractionForm, defaultFormInputs, hasDefaultInteractionFormFields, } from "./components/InteractionForm.js";
-export type { InteractionFieldProps, InteractionFieldRenderMap, InteractionFieldRenderProps, InteractionFormProps, } from "./components/InteractionForm.js";
+export { InteractionForm, defaultFormInputs, hasDefaultInteractionFormFields, } from "./components/InteractionForm.js";
+export type { InteractionFormProps } from "./components/InteractionForm.js";
 export * from "./components/index.js";
 export type * from "./hooks/useHandLayout.js";
 export type * from "./hooks/usePanZoom.js";
 export type * from "./hooks/usePluginRuntime.js";
-export type { PluginStateSnapshot } from "./types/plugin-state.js";
+export type { InteractionContext, InteractionContextOption, InteractionDescriptor, InputDomainDependencyCase, PluginStateSnapshot, } from "./types/plugin-state.js";
+export { hexColor, isHexColor, parseHexColor, type HexColor, } from "./types/hex-color.js";
 export type * from "./types/player-state.js";
 export type * from "./types/runtime-api.js";
+export type { DraftValidation, InteractionHandle, InteractionHandleStatus, InteractionParamsShape, } from "./hooks/useInteractionHandle.js";
+export type { CardCollection, ViewCard, ViewSlotOccupant, } from "@dreamboard/sdk-types";
 export type { AnyHexBoardInput, AnySquareBoardInput, BoardEdgeIdOf, BoardSpaceIdOf, BoardVertexIdOf, AuthoredHexBoardInput, AuthoredSquareBoardInput, GeneratedHexBoardInput, GeneratedHexSpaceStateLike, GeneratedSquareBoardInput, GeneratedSquareSpaceStateLike, GeneratedTiledEdgeStateLike, GeneratedTiledVertexStateLike, HexBoardInput, NormalizedHexBoard, NormalizedHexEdgeOf, NormalizedHexTileOf, NormalizedHexVertexOf, NormalizedSquareBoard, NormalizedSquareCellOf, NormalizedSquareEdgeOf, NormalizedSquarePieceOf, NormalizedSquareVertexOf, SquareBoardInput, } from "./types/tiled-board.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,20 +1,11 @@
-export * from "./reducer.js";
 export { createDreamboardUI, } from "./ui-contract.js";
 export * from "./primitives/index.js";
-export { BoardInteractionConflictError, useBoardInteractions, } from "./hooks/useBoardInteractions.js";
-export { useBoardTopology } from "./hooks/useBoardTopology.js";
-export { useCards } from "./hooks/useCards.js";
-export { useHexBoard } from "./hooks/useHexBoard.js";
-export { useSquareBoard } from "./hooks/useSquareBoard.js";
-export { useHandLayout } from "./hooks/useHandLayout.js";
-export { useInteractionByKey } from "./hooks/useInteractionByKey.js";
-export { useIsMobile } from "./hooks/useIsMobile.js";
-export { usePanZoom, calculateViewBox } from "./hooks/usePanZoom.js";
-export { usePluginRuntime } from "./hooks/usePluginRuntime.js";
+export { calculateViewBox } from "./hooks/usePanZoom.js";
 export { toTrackBoardData } from "./helpers/track-board.js";
-export { PluginStateProvider, usePluginActions, usePluginState, } from "./context/PluginStateContext.js";
-export { RuntimeContext, RuntimeProvider, useRuntimeContext, } from "./context/RuntimeContext.js";
+export { PluginStateProvider } from "./context/PluginStateContext.js";
+export { RuntimeContext, RuntimeProvider } from "./context/RuntimeContext.js";
 export { ThemeProvider, arcadeTheme, buttonStyle, chipStyle, cssVar, cssVarOr, deriveBoardTheme, getThemePreset, intentForVariant, mergeTheme, motionDuration, playerColor, resolveTheme, studioTheme, surfaceStyle, tabletopTheme, themeToCssVars, useBoardTheme, useTheme, useThemeCssVars, } from "./theme/index.js";
 export { normalizeHexBoardInput, normalizeSquareBoardInput, } from "./types/tiled-board.js";
-export { InteractionField, InteractionForm, defaultFormInputs, hasDefaultInteractionFormFields, } from "./components/InteractionForm.js";
+export { InteractionForm, defaultFormInputs, hasDefaultInteractionFormFields, } from "./components/InteractionForm.js";
 export * from "./components/index.js";
+export { hexColor, isHexColor, parseHexColor, } from "./types/hex-color.js";