@dreamboard-games/ui-sdk 0.0.42 → 0.0.45

package/dist/primitives/interaction-submit.d.ts

@@ -0,0 +1,23 @@
+import type { InteractionHandle, InteractionParamsShape } from "../hooks/useInteractionHandle.js";
+type UnhandledInteractionError = "throw" | "log" | "ignore";
+interface RunInteractionActionOptions<Result> {
+    onSuccess?: (result: Result) => void;
+    onError?: (error: unknown) => void;
+    unhandledError?: UnhandledInteractionError;
+}
+export interface InteractionSubmitCallbacks {
+    onSubmitSuccess?: () => void;
+    onSubmitError?: (error: unknown) => void;
+}
+export declare function runInteractionAction<Result>(action: () => Promise<Result>, { onSuccess, onError, unhandledError, }?: RunInteractionActionOptions<Result>): Promise<void>;
+export declare function submitInteractionDraft<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never>(handle: InteractionHandle<Params, DefaultedKeys>, callbacks?: InteractionSubmitCallbacks, options?: {
+    unhandledError?: UnhandledInteractionError;
+}): Promise<void>;
+export declare function submitInteraction<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never>(handle: InteractionHandle<Params, DefaultedKeys>, callbacks?: InteractionSubmitCallbacks, options?: {
+    unhandledError?: UnhandledInteractionError;
+}): Promise<void>;
+export declare function submitInteractionParams<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never>(handle: InteractionHandle<Params, DefaultedKeys>, params: Params, callbacks?: InteractionSubmitCallbacks, options?: {
+    unhandledError?: UnhandledInteractionError;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=interaction-submit.d.ts.map

package/dist/primitives/interaction-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-submit.d.ts","sourceRoot":"","sources":["../../src/primitives/interaction-submit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,KAAK,yBAAyB,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D,UAAU,2BAA2B,CAAC,MAAM;IAC1C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,cAAc,CAAC,EAAE,yBAAyB,CAAC;CAC5C;AAED,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAC/C,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAC7B,EACE,SAAS,EACT,OAAO,EACP,cAAwB,GACzB,GAAE,2BAA2B,CAAC,MAAM,CAAM,GAC1C,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAgB,sBAAsB,CACpC,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,aAAa,SAAS,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,EAEnD,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,EAChD,SAAS,GAAE,0BAA+B,EAC1C,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAAO,GAC3D,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,aAAa,SAAS,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,EAEnD,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,EAChD,SAAS,GAAE,0BAA+B,EAC1C,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAAO,GAC3D,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAgB,uBAAuB,CACrC,MAAM,SAAS,sBAAsB,GAAG,sBAAsB,EAC9D,aAAa,SAAS,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,EAEnD,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC,EAChD,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,0BAA+B,EAC1C,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,yBAAyB,CAAA;CAAO,GAC3D,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/primitives/interaction-submit.js

@@ -0,0 +1,41 @@
+export async function runInteractionAction(action, { onSuccess, onError, unhandledError = "throw", } = {}) {
+    try {
+        const result = await action();
+        onSuccess?.(result);
+    }
+    catch (error) {
+        if (onError) {
+            onError(error);
+            return;
+        }
+        if (unhandledError === "log") {
+            console.error(error);
+            return;
+        }
+        if (unhandledError === "ignore") {
+            return;
+        }
+        throw error;
+    }
+}
+export function submitInteractionDraft(handle, callbacks = {}, options = {}) {
+    return runInteractionAction(() => handle.submitDraft(), {
+        onSuccess: callbacks.onSubmitSuccess,
+        onError: callbacks.onSubmitError,
+        unhandledError: options.unhandledError,
+    });
+}
+export function submitInteraction(handle, callbacks = {}, options = {}) {
+    return runInteractionAction(() => handle.submit(), {
+        onSuccess: callbacks.onSubmitSuccess,
+        onError: callbacks.onSubmitError,
+        unhandledError: options.unhandledError,
+    });
+}
+export function submitInteractionParams(handle, params, callbacks = {}, options = {}) {
+    return runInteractionAction(() => handle.submit(params), {
+        onSuccess: callbacks.onSubmitSuccess,
+        onError: callbacks.onSubmitError,
+        unhandledError: options.unhandledError,
+    });
+}

package/dist/primitives/interaction.d.ts

@@ -1,8 +1,12 @@
 import { type ButtonHTMLAttributes, type HTMLAttributes, type InputHTMLAttributes, type ReactNode } from "react";
-import { useInteractionHandle } from "../hooks/useInteractionHandle.js";
+import { useInteractionHandle, type InteractionHandle, type InteractionParamsShape } from "../hooks/useInteractionHandle.js";
 import type { InteractionInputKey, InteractionKey } from "../ui-contract.js";
 import type { InteractionDescriptor } from "../types/plugin-state.js";
 import { type PrimitiveCommonProps } from "./primitive-props.js";
+import { type BoundInteractionFormProps } from "./interaction-form-binding.js";
+import { type InteractionFieldProps as BaseInteractionFieldProps } from "../components/InteractionForm.js";
+import { type InteractionSubmitCallbacks } from "./interaction-submit.js";
+import { type DialogLifecycleState } from "./dialog-lifecycle.js";
 interface InteractionContextValue {
     interaction: string;
     descriptor: InteractionDescriptor | null;
@@ -15,6 +19,37 @@ export interface InteractionRootProps<Interaction extends string = InteractionKe
     unavailable?: "render" | "hide";
 }
 export declare function InteractionRoot<Interaction extends string = InteractionKey>({ interaction, children, unavailable, }: InteractionRootProps<Interaction>): import("react/jsx-runtime").JSX.Element | null;
+export type InteractionDialogState = DialogLifecycleState;
+export interface InteractionDialogRenderState<Interaction extends string = InteractionKey> {
+    interaction: Interaction;
+    state: InteractionDialogState;
+    open: boolean;
+    minimized: boolean;
+    dismissed: boolean;
+    setOpen: (open: boolean) => void;
+    restore: () => void;
+    minimize: () => void;
+    dismiss: () => void;
+}
+export interface InteractionDialogProps<Interaction extends string = InteractionKey> {
+    defaultOpen?: boolean;
+    onStateChange?: (state: InteractionDialogState) => void;
+    children: (state: InteractionDialogRenderState<Interaction>) => ReactNode;
+}
+export declare function InteractionDialog<Interaction extends string = InteractionKey>({ defaultOpen, onStateChange, children, }: InteractionDialogProps<Interaction>): import("react/jsx-runtime").JSX.Element;
+export interface InteractionSwitchRenderState<Interaction extends string = InteractionKey> {
+    interaction: Interaction;
+    descriptor: InteractionDescriptor<Interaction>;
+}
+export type InteractionRouteMap<Interaction extends string = InteractionKey> = {
+    [Key in Interaction]?: (state: InteractionSwitchRenderState<Key>) => ReactNode;
+};
+export interface InteractionSwitchProps<Interaction extends string = InteractionKey> {
+    interaction?: Interaction;
+    routes: InteractionRouteMap<Interaction>;
+    fallback?: ReactNode;
+}
+export declare function InteractionSwitch<Interaction extends string = InteractionKey>({ interaction, routes, fallback, }: InteractionSwitchProps<Interaction>): import("react/jsx-runtime").JSX.Element;
 export type InteractionPartProps = PrimitiveCommonProps & HTMLAttributes<HTMLElement>;
 export declare function InteractionLabel({ children, ...props }: InteractionPartProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export declare function InteractionDescription({ children, ...props }: InteractionPartProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
@@ -22,8 +57,39 @@ export declare function InteractionUnavailableMessage({ children, ...props }: In
 export declare function InteractionValidationMessage({ children, ...props }: InteractionPartProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
 export type InteractionTriggerProps = PrimitiveCommonProps & ButtonHTMLAttributes<HTMLButtonElement>;
 export declare function InteractionTrigger({ disabled, onClick, ...props }: InteractionTriggerProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
-export type InteractionSubmitProps = PrimitiveCommonProps & ButtonHTMLAttributes<HTMLButtonElement>;
-export declare function InteractionSubmit({ disabled, onClick, ...props }: InteractionSubmitProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export interface InteractionStateSnapshot<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never> {
+    interaction: string;
+    descriptor: InteractionDescriptor;
+    handle: InteractionHandle<Params, DefaultedKeys>;
+    draft: InteractionHandle<Params, DefaultedKeys>["draft"];
+    values: InteractionHandle<Params, DefaultedKeys>["values"];
+    status: InteractionHandle<Params, DefaultedKeys>["status"];
+    available: boolean;
+    isReady: boolean;
+    isArmed: boolean;
+    inputKeys: readonly string[];
+    missingInputs: readonly string[];
+    readyFrontier: readonly string[];
+    blockedInputs: readonly string[];
+    hasInputs: boolean;
+}
+export interface InteractionStateProps<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never> {
+    unavailable: ReactNode;
+    children: (state: InteractionStateSnapshot<Params, DefaultedKeys>) => ReactNode;
+}
+export declare function InteractionState<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never>({ children, unavailable }: InteractionStateProps<Params, DefaultedKeys>): import("react/jsx-runtime").JSX.Element;
+export type InteractionFormPrimitiveProps<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never> = BoundInteractionFormProps<Params, DefaultedKeys>;
+export declare function InteractionFormPrimitive<Params extends InteractionParamsShape = InteractionParamsShape, DefaultedKeys extends keyof Params & string = never>(props: InteractionFormPrimitiveProps<Params, DefaultedKeys>): import("react/jsx-runtime").JSX.Element | null;
+export type InteractionFieldPrimitiveProps<Params extends InteractionParamsShape = InteractionParamsShape, Input extends keyof Params & string = keyof Params & string> = Omit<BaseInteractionFieldProps<Params, Input>, "descriptor" | "handle" | "inputKey"> & {
+    input: Input;
+};
+export declare function InteractionFieldPrimitive<Params extends InteractionParamsShape = InteractionParamsShape, Input extends keyof Params & string = keyof Params & string>({ input, ...props }: InteractionFieldPrimitiveProps<Params, Input>): import("react/jsx-runtime").JSX.Element | null;
+export type InteractionSubmitProps = PrimitiveCommonProps & ButtonHTMLAttributes<HTMLButtonElement> & {
+    params?: InteractionParamsShape | (() => InteractionParamsShape | null | undefined);
+    onSubmitSuccess?: InteractionSubmitCallbacks["onSubmitSuccess"];
+    onSubmitError?: InteractionSubmitCallbacks["onSubmitError"];
+};
+export declare function InteractionSubmit({ disabled, onClick, params, onSubmitSuccess, onSubmitError, ...props }: InteractionSubmitProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export type InteractionInputProps = PrimitiveCommonProps & Omit<InputHTMLAttributes<HTMLInputElement>, "name"> & {
     name: string;
     parse?: (value: string) => unknown;
@@ -31,21 +97,25 @@ export type InteractionInputProps = PrimitiveCommonProps & Omit<InputHTMLAttribu
 export declare function InteractionInput({ name, parse, onChange, disabled, ...props }: InteractionInputProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export type InteractionCardInputProps<Input extends string = InteractionInputKey> = PrimitiveCommonProps & ButtonHTMLAttributes<HTMLButtonElement> & {
     input: Input;
-    value?: string;
-    card?: string;
+    unsafeCardId?: string;
     selected?: boolean;
     onSelectedChange?: (selected: boolean) => void;
 };
-export declare function InteractionCardInput<Input extends string = InteractionInputKey>({ input, value, card, selected, onSelectedChange, onClick, disabled, children, ...props }: InteractionCardInputProps<Input>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export declare function InteractionCardInput<Input extends string = InteractionInputKey>({ input, unsafeCardId, selected, onSelectedChange, onClick, disabled, children, ...props }: InteractionCardInputProps<Input>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
 export declare const Interaction: {
     Root: typeof InteractionRoot;
+    State: typeof InteractionState;
+    Switch: typeof InteractionSwitch;
+    Dialog: typeof InteractionDialog;
     Trigger: typeof InteractionTrigger;
     Label: typeof InteractionLabel;
     Description: typeof InteractionDescription;
     UnavailableMessage: typeof InteractionUnavailableMessage;
     ValidationMessage: typeof InteractionValidationMessage;
     Input: typeof InteractionInput;
+    Field: typeof InteractionFieldPrimitive;
     CardInput: typeof InteractionCardInput;
+    Form: typeof InteractionFormPrimitive;
     Submit: typeof InteractionSubmit;
 };
 export {};

package/dist/primitives/interaction.d.ts.map

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

package/dist/primitives/interaction.js

@@ -1,12 +1,18 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { createContext, useContext, useMemo, } from "react";
-import { useInteractionHandle } from "../hooks/useInteractionHandle.js";
-import { useInteractionUiStore } from "../context/InteractionDraftContext.js";
+import { useInteractionHandle, } from "../hooks/useInteractionHandle.js";
+import { useInteractionUiStore, usePendingInteractionKey, } from "../context/InteractionDraftContext.js";
 import { usePluginState } from "../context/PluginStateContext.js";
-import { inputByKey, isManyTargetSelectable, toggleManyValue, } from "../utils/interaction-inputs.js";
+import { hasInteractionFieldErrors, inputByKey, isManyTargetSelectable, toggleManyValue, } from "../utils/interaction-inputs.js";
+import { applyInteractionDraftMutation, getInteractionDraftReadiness, markInteractionPending, shouldRouteInteractionPending, } from "../utils/interaction-router.js";
 import { interactionLabel } from "../utils/interaction-labels.js";
 import { composeEventHandlers, renderPrimitive, } from "./primitive-props.js";
-import { useZoneCardContext } from "./zone.js";
+import { BoundInteractionForm, castInteractionDraft, castInteractionHandle, } from "./interaction-form-binding.js";
+import { InteractionField as BaseInteractionField, } from "../components/InteractionForm.js";
+import { submitInteractionDraft, submitInteractionParams, } from "./interaction-submit.js";
+import { useDialogLifecycle, } from "./dialog-lifecycle.js";
+import { useGameActionError } from "./game.js";
+import { useOptionalZonePrimitiveContext, useZoneCardContext } from "./zone.js";
 const InteractionContext = createContext(null);
 function humanizeInteraction(value) {
     const parts = value.split(".");
@@ -50,6 +56,33 @@ export function InteractionRoot({ interaction, children, unavailable = "render",
     }
     return (_jsx(ResolvedInteractionRoot, { interaction: interaction, descriptor: descriptor, children: children }));
 }
+export function InteractionDialog({ defaultOpen = true, onStateChange, children, }) {
+    const { interaction } = useInteractionPrimitiveContext();
+    const lifecycle = useDialogLifecycle({ defaultOpen, onStateChange });
+    const renderState = useMemo(() => ({
+        interaction: interaction,
+        ...lifecycle,
+    }), [interaction, lifecycle]);
+    return _jsx(_Fragment, { children: children(renderState) });
+}
+export function InteractionSwitch({ interaction, routes, fallback = null, }) {
+    const pendingInteractionKey = usePendingInteractionKey();
+    const descriptors = usePluginState((state) => state.gameplay.availableInteractions);
+    const routedInteraction = interaction ?? pendingInteractionKey;
+    const descriptor = routedInteraction
+        ? descriptors.find((candidate) => candidate.interactionKey === routedInteraction)
+        : undefined;
+    if (!descriptor)
+        return _jsx(_Fragment, { children: fallback });
+    const route = routes[descriptor.interactionKey] ?? null;
+    if (!route)
+        return _jsx(_Fragment, { children: fallback });
+    const typedInteraction = descriptor.interactionKey;
+    return (_jsx(InteractionRoot, { interaction: typedInteraction, children: route({
+            interaction: typedInteraction,
+            descriptor: descriptor,
+        }) }));
+}
 export function InteractionLabel({ children, ...props }) {
     const { descriptor, interaction } = useInteractionPrimitiveContext();
     return renderPrimitive("span", {
@@ -118,12 +151,53 @@ export function InteractionTrigger({ disabled, onClick, ...props }) {
         }),
     });
 }
-export function InteractionSubmit({ disabled, onClick, ...props }) {
+export function InteractionState({ children, unavailable }) {
+    const { interaction, descriptor, handle } = useInteractionPrimitiveContext();
+    const store = useInteractionUiStore();
+    if (!descriptor || !handle) {
+        return _jsx(_Fragment, { children: unavailable });
+    }
+    const typedHandle = castInteractionHandle(handle);
+    const liveDraft = castInteractionDraft(store.getDraft(descriptor.interactionKey));
+    const inputKeys = descriptor.inputs.map((input) => input.key);
+    const readiness = getInteractionDraftReadiness(descriptor, liveDraft);
+    return (_jsx(_Fragment, { children: children({
+            interaction,
+            descriptor,
+            handle: typedHandle,
+            draft: liveDraft,
+            values: typedHandle.values,
+            status: typedHandle.status,
+            available: typedHandle.available,
+            isReady: readiness.ready,
+            isArmed: typedHandle.isArmed,
+            inputKeys,
+            missingInputs: readiness.missingInputs,
+            readyFrontier: readiness.readyFrontier,
+            blockedInputs: readiness.blockedInputs,
+            hasInputs: inputKeys.length > 0,
+        }) }));
+}
+export function InteractionFormPrimitive(props) {
+    const { descriptor, handle } = useInteractionPrimitiveContext();
+    if (!descriptor || !handle)
+        return null;
+    return (_jsx(BoundInteractionForm, { descriptor: descriptor, handle: handle, ...props }));
+}
+export function InteractionFieldPrimitive({ input, ...props }) {
     const { descriptor, handle } = useInteractionPrimitiveContext();
+    if (!descriptor || !handle)
+        return null;
+    return (_jsx(BaseInteractionField, { descriptor: descriptor, handle: castInteractionHandle(handle), inputKey: input, ...props }));
+}
+export function InteractionSubmit({ disabled, onClick, params, onSubmitSuccess, onSubmitError, ...props }) {
+    const { descriptor, handle } = useInteractionPrimitiveContext();
+    const gameActionError = useGameActionError();
     const isSubmitting = handle?.status === "submitting";
+    const hasExplicitParams = params !== undefined;
     const isDisabled = disabled === true ||
         !descriptor?.available ||
-        !handle?.isReady ||
+        (!hasExplicitParams && !handle?.isReady) ||
         isSubmitting;
     return renderPrimitive("button", {
         type: "button",
@@ -136,10 +210,25 @@ export function InteractionSubmit({ disabled, onClick, ...props }) {
         "data-available": descriptor?.available ?? false,
         "data-disabled": isDisabled || undefined,
         "data-ready": handle?.isReady ?? false,
+        "data-has-inputs": descriptor ? descriptor.inputs.length > 0 : undefined,
+        "data-input-count": descriptor?.inputs.length,
         "data-submitting": isSubmitting || undefined,
         "data-state": handle?.status ?? "unavailable",
         onClick: composeEventHandlers(onClick, () => {
-            void handle?.submitDraft();
+            if (isDisabled || !handle)
+                return;
+            const resolvedParams = typeof params === "function" ? params() : params;
+            if (resolvedParams === null || resolvedParams === undefined) {
+                void submitInteractionDraft(handle, {
+                    onSubmitSuccess,
+                    onSubmitError: onSubmitError ?? gameActionError ?? undefined,
+                });
+                return;
+            }
+            void submitInteractionParams(handle, resolvedParams, {
+                onSubmitSuccess,
+                onSubmitError: onSubmitError ?? gameActionError ?? undefined,
+            });
         }),
     });
 }
@@ -162,20 +251,40 @@ export function InteractionInput({ name, parse, onChange, disabled, ...props })
         }),
     });
 }
-export function InteractionCardInput({ input, value, card, selected, onSelectedChange, onClick, disabled, children, ...props }) {
+export function InteractionCardInput({ input, unsafeCardId, selected, onSelectedChange, onClick, disabled, children, ...props }) {
     const { descriptor, handle } = useInteractionPrimitiveContext();
     const store = useInteractionUiStore();
     const zoneCard = useZoneCardContext();
-    const cardId = value ?? card ?? zoneCard?.cardId;
+    const zoneContext = useOptionalZonePrimitiveContext();
+    const cardId = zoneCard?.cardId ?? unsafeCardId;
+    const validationZone = zoneCard?.zone ?? zoneContext?.zone;
+    const zoneSnapshot = usePluginState((state) => validationZone ? state.gameplay.zones[validationZone] : undefined);
     const cardDescriptor = usePluginState((state) => {
-        if (!cardId || !zoneCard)
+        if (!cardId || !validationZone)
             return undefined;
-        return state.gameplay.zones[zoneCard.zone]?.playableByCardId[cardId]?.find((candidate) => candidate.interactionKey === descriptor?.interactionKey &&
+        return state.gameplay.zones[validationZone]?.playableByCardId[cardId]?.find((candidate) => candidate.interactionKey === descriptor?.interactionKey &&
             candidate.inputs.some((candidateInput) => candidateInput.key === input));
     });
     const inputDescriptor = descriptor
         ? inputByKey(descriptor, input)
         : undefined;
+    const targetInvalidReason = cardTargetInvalidReason({
+        cardDescriptor,
+        cardId,
+        inputDescriptor,
+        unsafeCardId,
+        validationZone,
+        zoneCard,
+        zoneSnapshot,
+    });
+    const isTargetValid = targetInvalidReason === undefined;
+    throwCardInputDevMismatch({
+        cardId,
+        targetInvalidReason,
+        unsafeCardId,
+        validationZone,
+        zoneCard,
+    });
     const liveDraft = descriptor ? store.getDraft(descriptor.interactionKey) : {};
     const currentValue = liveDraft[input] ?? handle?.draft[input] ?? handle?.values[input];
     const selection = inputDescriptor?.domain.selection;
@@ -186,25 +295,24 @@ export function InteractionCardInput({ input, value, card, selected, onSelectedC
             cardId !== undefined &&
             String(currentValue) === String(cardId);
     const isSelected = selected ?? selectedByDraft;
-    const eligibleTargets = inputDescriptor?.domain.type === "target"
-        ? inputDescriptor.domain.eligibleTargets
-        : undefined;
-    const isCardInput = inputDescriptor?.domain.type === "target" &&
-        inputDescriptor.domain.targetKind === "card";
-    const isEligible = cardId !== undefined &&
-        isCardInput &&
-        (eligibleTargets === undefined || eligibleTargets.includes(cardId));
+    const isCardAvailable = cardDescriptor?.available ??
+        (isTargetValid && (descriptor?.available ?? false));
+    const cardUnavailableReason = cardDescriptor?.unavailableReason ??
+        (!descriptor?.available
+            ? (descriptor?.unavailableReason ?? "interaction-unavailable")
+            : undefined);
     const isSelectable = cardId !== undefined &&
         inputDescriptor !== undefined &&
         isManyTargetSelectable(inputDescriptor, currentValue, cardId);
-    const isCandidateAvailable = cardDescriptor?.available ?? true;
     const validation = handle?.validateDraft();
     const fieldErrors = validation?.fieldErrors[input] ?? [];
     const isInvalid = fieldErrors.length > 0;
     const isDisabled = disabled === true ||
         !descriptor?.available ||
         !cardId ||
-        !isEligible ||
+        !isTargetValid ||
+        !isCardAvailable ||
+        !isSelectable ||
         !handle;
     return renderPrimitive("button", {
         type: "button",
@@ -216,11 +324,14 @@ export function InteractionCardInput({ input, value, card, selected, onSelectedC
         "data-dreamboard-interaction-card-input": "",
         "data-input-name": input,
         "data-card-id": cardId,
-        "data-zone": zoneCard?.zone,
+        "data-zone": validationZone,
         "data-selected": isSelected || undefined,
-        "data-eligible": isEligible,
+        "data-eligible": isTargetValid && isCardAvailable,
+        "data-target-valid": isTargetValid,
+        "data-target-invalid-reason": targetInvalidReason,
         "data-selectable": isSelectable,
-        "data-card-available": isCandidateAvailable,
+        "data-card-available": isCardAvailable,
+        "data-card-unavailable-reason": cardUnavailableReason,
         "data-invalid": isInvalid || undefined,
         "data-disabled": isDisabled || undefined,
         "data-missing-resource": cardId ? undefined : true,
@@ -230,21 +341,94 @@ export function InteractionCardInput({ input, value, card, selected, onSelectedC
             const nextValue = selection?.mode === "many"
                 ? toggleManyValue(currentValue, cardId, selection)
                 : cardId;
-            handle.setInput(input, nextValue);
+            const nextDraft = applyInteractionDraftMutation(store, descriptor, [
+                { key: input, value: nextValue },
+            ]);
+            const readiness = getInteractionDraftReadiness(descriptor, nextDraft);
+            const hasMissingSurfaceTarget = readiness.readyFrontier.some((key) => {
+                const candidate = inputByKey(descriptor, key);
+                return (candidate?.domain.type === "target" &&
+                    candidate.domain.targetKind !== "card" &&
+                    candidate.domain.selection?.mode !== "many");
+            });
+            const hasMissingFormInput = readiness.readyFrontier.some((key) => {
+                const candidate = inputByKey(descriptor, key);
+                return (candidate !== undefined &&
+                    (candidate.domain.type !== "target" ||
+                        candidate.domain.selection?.mode === "many"));
+            });
+            const hasFieldErrors = hasInteractionFieldErrors(readiness.fieldErrors);
+            if (shouldRouteInteractionPending(descriptor, readiness)) {
+                markInteractionPending(store, descriptor);
+                store.setPendingInteraction(!hasMissingSurfaceTarget && (hasMissingFormInput || hasFieldErrors)
+                    ? descriptor.interactionKey
+                    : null);
+            }
             onSelectedChange?.(selection?.mode === "many"
                 ? Array.isArray(nextValue) && nextValue.includes(cardId)
                 : true);
         }),
     });
 }
+function cardTargetInvalidReason({ cardDescriptor, cardId, inputDescriptor, unsafeCardId, validationZone, zoneCard, zoneSnapshot, }) {
+    if (!cardId)
+        return "missing-card";
+    if (inputDescriptor?.domain.type !== "target" ||
+        inputDescriptor.domain.targetKind !== "card") {
+        return "not-in-domain";
+    }
+    if (zoneCard && unsafeCardId && unsafeCardId !== zoneCard.cardId) {
+        return "wrong-zone";
+    }
+    if (validationZone &&
+        zoneSnapshot &&
+        !zoneSnapshot.cardIds.includes(cardId)) {
+        return "not-in-zone";
+    }
+    if (validationZone &&
+        inputDescriptor.domain.zoneIds &&
+        !inputDescriptor.domain.zoneIds.includes(validationZone)) {
+        return "wrong-zone";
+    }
+    if (validationZone && !cardDescriptor) {
+        return zoneSnapshot?.cardIds[0] !== cardId
+            ? "not-top-card"
+            : "not-in-domain";
+    }
+    if (!zoneCard &&
+        inputDescriptor.domain.eligibleTargets &&
+        !inputDescriptor.domain.eligibleTargets.includes(cardId)) {
+        return "not-in-domain";
+    }
+    return undefined;
+}
+function throwCardInputDevMismatch({ cardId, targetInvalidReason, unsafeCardId, validationZone, zoneCard, }) {
+    if (!isDevelopmentRuntime() || !validationZone)
+        return;
+    if (zoneCard && unsafeCardId && unsafeCardId !== zoneCard.cardId) {
+        throw new Error(`Interaction.CardInput unsafeCardId '${unsafeCardId}' does not match surrounding Zone.Item card '${zoneCard.cardId}'.`);
+    }
+    if (targetInvalidReason === "not-in-zone" && cardId) {
+        throw new Error(`Interaction.CardInput card '${cardId}' is not present in surrounding zone '${validationZone}'.`);
+    }
+}
+function isDevelopmentRuntime() {
+    const processLike = globalThis.process;
+    return processLike?.env?.NODE_ENV !== "production";
+}
 export const Interaction = {
     Root: InteractionRoot,
+    State: InteractionState,
+    Switch: InteractionSwitch,
+    Dialog: InteractionDialog,
     Trigger: InteractionTrigger,
     Label: InteractionLabel,
     Description: InteractionDescription,
     UnavailableMessage: InteractionUnavailableMessage,
     ValidationMessage: InteractionValidationMessage,
     Input: InteractionInput,
+    Field: InteractionFieldPrimitive,
     CardInput: InteractionCardInput,
+    Form: InteractionFormPrimitive,
     Submit: InteractionSubmit,
 };

package/dist/primitives/player-roster.d.ts

@@ -1,6 +1,7 @@
 import { type ButtonHTMLAttributes, type HTMLAttributes, type ReactElement, type ReactNode } from "react";
 import type { PlayerId } from "@dreamboard/manifest-contract";
 import { type PrimitiveCommonProps } from "./primitive-props.js";
+import type { HexColor } from "../types/hex-color.js";
 export interface PlayerRosterBadge {
     key: string;
     label?: ReactNode;
@@ -10,7 +11,7 @@ export interface PlayerRosterBadge {
 export interface PlayerRosterEntry {
     playerId: PlayerId;
     name: string;
-    color?: string;
+    color?: HexColor;
     index: number;
     isActive: boolean;
     isCurrentPlayer: boolean;

package/dist/primitives/player-roster.d.ts.map

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