@dreamboard-games/ui-sdk 0.0.43 → 0.0.45

package/dist/utils/interaction-inputs.d.ts

@@ -2,6 +2,9 @@ import type { InteractionDescriptor, InteractionInputDescriptor, InputSelection
 export type BoardTargetKind = "edge" | "vertex" | "space" | "tile";
 export declare function interactionInputKeys(descriptor: Pick<InteractionDescriptor, "inputs">): string[];
 export declare function applyInteractionInputDefaults<Params extends Record<string, unknown>>(descriptor: Pick<InteractionDescriptor, "inputs">, params: Readonly<Partial<Params>>): Partial<Params>;
+export declare function resolveInputDomain(input: InteractionInputDescriptor, params: Readonly<Record<string, unknown>>): InteractionInputDescriptor;
+export declare function resolveInteractionInputs(descriptor: Pick<InteractionDescriptor, "inputs">, params: Readonly<Record<string, unknown>>): InteractionInputDescriptor[];
+export declare function dependentInputKeys(descriptor: Pick<InteractionDescriptor, "inputs">, changedKey: string): string[];
 export declare function validateInteractionInputDomains(descriptor: Pick<InteractionDescriptor, "inputs">, params: Readonly<Record<string, unknown>>): Partial<Record<string, readonly string[]>>;
 export declare function isInputValueReady(input: InteractionInputDescriptor, value: unknown): boolean;
 export declare function isManyInput(input: InteractionInputDescriptor): boolean;
@@ -11,12 +14,12 @@ export declare function isManyTargetSelectable(input: InteractionInputDescriptor
 export declare function mergeInteractionFieldErrors(...sources: Array<Partial<Record<string, readonly string[]>>>): Partial<Record<string, readonly string[]>>;
 export declare function hasInteractionFieldErrors(fieldErrors: Partial<Record<string, readonly string[]>>): boolean;
 export declare function inputByKey(descriptor: Pick<InteractionDescriptor, "inputs">, key: string): InteractionInputDescriptor | undefined;
-export declare function inputByTarget(descriptor: Pick<InteractionDescriptor, "inputs">, targetKind: BoardTargetKind | "card", targetId: string): InteractionInputDescriptor | null;
-export declare function eligibleTargetsForInput(descriptor: Pick<InteractionDescriptor, "inputs">, key: string): readonly string[] | undefined;
-export declare function eligibleTargetsByInput(descriptor: Pick<InteractionDescriptor, "inputs">): Record<string, readonly string[]>;
-export declare function eligibleTargetsByBoardKind(descriptor: Pick<InteractionDescriptor, "inputs">): Partial<Record<BoardTargetKind, readonly string[]>>;
+export declare function inputByTarget(descriptor: Pick<InteractionDescriptor, "inputs">, targetKind: BoardTargetKind | "card", targetId: string, params?: Readonly<Record<string, unknown>>): InteractionInputDescriptor | null;
+export declare function eligibleTargetsForInput(descriptor: Pick<InteractionDescriptor, "inputs">, key: string, params?: Readonly<Record<string, unknown>>): readonly string[] | undefined;
+export declare function eligibleTargetsByInput(descriptor: Pick<InteractionDescriptor, "inputs">, params?: Readonly<Record<string, unknown>>): Record<string, readonly string[]>;
+export declare function eligibleTargetsByBoardKind(descriptor: Pick<InteractionDescriptor, "inputs">, params?: Readonly<Record<string, unknown>>): Partial<Record<BoardTargetKind, readonly string[]>>;
 export declare function hasBoardTargetInput(descriptor: Pick<InteractionDescriptor, "inputs">): boolean;
 export declare function hasCardTargetInput(descriptor: Pick<InteractionDescriptor, "inputs">): boolean;
 export declare function interactionArmScope(descriptor: Pick<InteractionDescriptor, "inputs" | "interactionKey" | "zoneId">): string;
-export declare function inputKeyForTarget(descriptor: Pick<InteractionDescriptor, "inputs">, targetKind: BoardTargetKind | "card", targetId: string): string | null;
+export declare function inputKeyForTarget(descriptor: Pick<InteractionDescriptor, "inputs">, targetKind: BoardTargetKind | "card", targetId: string, params?: Readonly<Record<string, unknown>>): string | null;
 //# sourceMappingURL=interaction-inputs.d.ts.map

package/dist/utils/interaction-inputs.d.ts.map

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

package/dist/utils/interaction-inputs.js

@@ -12,9 +12,52 @@ export function applyInteractionInputDefaults(descriptor, params) {
     }
     return next;
 }
+export function resolveInputDomain(input, params) {
+    const dependencies = input.domain.dependsOn ?? [];
+    if (dependencies.length === 0)
+        return input;
+    const caseMatch = input.domain.dependentCases?.find((candidate) => dependencies.every((key) => params[key] !== undefined &&
+        params[key] !== null &&
+        String(params[key]) === candidate.when[key]));
+    if (!caseMatch)
+        return input;
+    return {
+        ...input,
+        domain: {
+            ...caseMatch.domain,
+            dependsOn: dependencies,
+            dependentCases: input.domain.dependentCases,
+        },
+    };
+}
+export function resolveInteractionInputs(descriptor, params) {
+    return descriptor.inputs.map((input) => resolveInputDomain(input, params));
+}
+export function dependentInputKeys(descriptor, changedKey) {
+    const dependentsByKey = new Map();
+    for (const input of descriptor.inputs) {
+        for (const dependency of input.domain.dependsOn ?? []) {
+            dependentsByKey.set(dependency, [
+                ...(dependentsByKey.get(dependency) ?? []),
+                input.key,
+            ]);
+        }
+    }
+    const result = [];
+    const queue = [...(dependentsByKey.get(changedKey) ?? [])];
+    while (queue.length > 0) {
+        const key = queue.shift();
+        if (!key || result.includes(key))
+            continue;
+        result.push(key);
+        queue.push(...(dependentsByKey.get(key) ?? []));
+    }
+    return result;
+}
 export function validateInteractionInputDomains(descriptor, params) {
     const fieldErrors = {};
-    for (const input of descriptor.inputs) {
+    for (const rawInput of descriptor.inputs) {
+        const input = resolveInputDomain(rawInput, params);
         const value = params[input.key];
         if (value === undefined || value === null)
             continue;
@@ -37,6 +80,17 @@ export function validateInteractionInputDomains(descriptor, params) {
             if (value.length > max) {
                 pushFieldError(fieldErrors, input.key, `Choose at most ${max} ${pluralize("option", max)}.`);
             }
+            const allowed = new Set(input.domain.choices?.map((choice) => choice.value));
+            if (allowed.size > 0 &&
+                value.some((item) => !allowed.has(String(item)))) {
+                pushFieldError(fieldErrors, input.key, "Selected choice is not eligible.");
+            }
+        }
+        if (input.domain.type === "choice") {
+            const allowed = new Set(input.domain.choices?.map((choice) => choice.value));
+            if (allowed.size > 0 && !allowed.has(value)) {
+                pushFieldError(fieldErrors, input.key, "Selected choice is not eligible.");
+            }
         }
         if (input.domain.type === "target") {
             const values = valuesForSelection(input.domain.selection, value);
@@ -111,8 +165,9 @@ export function hasInteractionFieldErrors(fieldErrors) {
 export function inputByKey(descriptor, key) {
     return descriptor.inputs.find((input) => input.key === key);
 }
-export function inputByTarget(descriptor, targetKind, targetId) {
-    for (const input of descriptor.inputs) {
+export function inputByTarget(descriptor, targetKind, targetId, params = {}) {
+    for (const rawInput of descriptor.inputs) {
+        const input = resolveInputDomain(rawInput, params);
         if (input.domain.type !== "target")
             continue;
         if (input.domain.targetKind !== targetKind)
@@ -122,26 +177,29 @@ export function inputByTarget(descriptor, targetKind, targetId) {
     }
     return null;
 }
-export function eligibleTargetsForInput(descriptor, key) {
-    const domain = inputByKey(descriptor, key)?.domain;
+export function eligibleTargetsForInput(descriptor, key, params = {}) {
+    const rawInput = inputByKey(descriptor, key);
+    const domain = rawInput ? resolveInputDomain(rawInput, params).domain : null;
     return domain?.type === "target" ? domain.eligibleTargets : undefined;
 }
-export function eligibleTargetsByInput(descriptor) {
-    return Object.fromEntries(descriptor.inputs.flatMap((input) => {
+export function eligibleTargetsByInput(descriptor, params = {}) {
+    return Object.fromEntries(descriptor.inputs.flatMap((rawInput) => {
+        const input = resolveInputDomain(rawInput, params);
         const targets = input.domain.type === "target"
             ? input.domain.eligibleTargets
             : undefined;
         return targets ? [[input.key, targets]] : [];
     }));
 }
-export function eligibleTargetsByBoardKind(descriptor) {
+export function eligibleTargetsByBoardKind(descriptor, params = {}) {
     const result = {
         edge: new Set(),
         vertex: new Set(),
         space: new Set(),
         tile: new Set(),
     };
-    for (const input of descriptor.inputs) {
+    for (const rawInput of descriptor.inputs) {
+        const input = resolveInputDomain(rawInput, params);
         if (input.domain.type !== "target")
             continue;
         const targetKind = input.domain.targetKind;
@@ -154,14 +212,13 @@ export function eligibleTargetsByBoardKind(descriptor) {
     return Object.fromEntries(Object.entries(result).flatMap(([kind, ids]) => ids.size > 0 ? [[kind, [...ids]]] : []));
 }
 export function hasBoardTargetInput(descriptor) {
-    return Object.keys(eligibleTargetsByBoardKind(descriptor)).length > 0;
+    return boardTargetKindsOf(descriptor).length > 0;
 }
 export function hasCardTargetInput(descriptor) {
     return descriptor.inputs.some((input) => input.domain.type === "target" && input.domain.targetKind === "card");
 }
 export function interactionArmScope(descriptor) {
-    const byKind = eligibleTargetsByBoardKind(descriptor);
-    const boardKinds = Object.keys(byKind).filter((kind) => byKind[kind] !== undefined);
+    const boardKinds = boardTargetKindsOf(descriptor);
     if (boardKinds.length === 1)
         return `board:${boardKinds[0]}`;
     if (boardKinds.length > 1)
@@ -170,8 +227,19 @@ export function interactionArmScope(descriptor) {
         return `zone:${descriptor.zoneId}`;
     return `interaction:${descriptor.interactionKey}`;
 }
-export function inputKeyForTarget(descriptor, targetKind, targetId) {
-    return inputByTarget(descriptor, targetKind, targetId)?.key ?? null;
+export function inputKeyForTarget(descriptor, targetKind, targetId, params = {}) {
+    return inputByTarget(descriptor, targetKind, targetId, params)?.key ?? null;
+}
+function boardTargetKindsOf(descriptor) {
+    const kinds = new Set();
+    for (const input of descriptor.inputs) {
+        if (input.domain.type !== "target")
+            continue;
+        if (isBoardTargetKind(input.domain.targetKind)) {
+            kinds.add(input.domain.targetKind);
+        }
+    }
+    return [...kinds];
 }
 function validateInputSelection(input, value) {
     const selection = input.domain.selection;

package/dist/utils/interaction-router.d.ts

@@ -0,0 +1,31 @@
+import type { InteractionUiStore } from "../context/InteractionDraftContext.js";
+import type { InteractionDescriptor } from "../types/plugin-state.js";
+export interface InteractionDraftMutation {
+    key: string;
+    value: unknown;
+}
+export interface InteractionDraftReadiness {
+    values: Record<string, unknown>;
+    missingInputs: readonly string[];
+    readyFrontier: readonly string[];
+    blockedInputs: readonly string[];
+    fieldErrors: Partial<Record<string, readonly string[]>>;
+    ready: boolean;
+}
+export interface RoutedInteractionTarget {
+    inputKey: string;
+    value: string;
+    extraInputs?: Record<string, unknown>;
+}
+export interface RoutedInteractionTargetResult {
+    params: Record<string, unknown>;
+    readiness: InteractionDraftReadiness;
+}
+export declare function applyInteractionDraftMutation(store: Pick<InteractionUiStore, "getDraft" | "setInput" | "clearInput">, descriptor: InteractionDescriptor, mutations: readonly InteractionDraftMutation[]): Record<string, unknown>;
+export declare function getInteractionDraftReadiness(descriptor: InteractionDescriptor, draft: Readonly<Record<string, unknown>>): InteractionDraftReadiness;
+export declare function routeInteractionTarget(store: Pick<InteractionUiStore, "getDraft" | "setInput" | "clearInput">, descriptor: InteractionDescriptor, target: RoutedInteractionTarget): RoutedInteractionTargetResult;
+export declare function shouldRouteInteractionPending(descriptor: InteractionDescriptor, readiness: Pick<InteractionDraftReadiness, "ready">): boolean;
+export declare function markInteractionPending(store: Pick<InteractionUiStore, "arm" | "setPendingInteraction">, descriptor: InteractionDescriptor): void;
+export declare function clearInteractionRoute(store: Pick<InteractionUiStore, "clearInput" | "getArmed" | "arm" | "getPendingInteraction" | "setPendingInteraction">, descriptor: InteractionDescriptor): void;
+export declare function claimInteractionSubmit(store: Pick<InteractionUiStore, "claimSubmitting">, descriptor: InteractionDescriptor): boolean;
+//# sourceMappingURL=interaction-router.d.ts.map

package/dist/utils/interaction-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-router.d.ts","sourceRoot":"","sources":["../../src/utils/interaction-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AActE,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACxD,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC,EACvE,UAAU,EAAE,qBAAqB,EACjC,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB;AAeD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,yBAAyB,CAoC3B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC,EACvE,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE,uBAAuB,GAC9B,6BAA6B,CAoB/B;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,qBAAqB,EACjC,SAAS,EAAE,IAAI,CAAC,yBAAyB,EAAE,OAAO,CAAC,GAClD,OAAO,CAET;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,uBAAuB,CAAC,EAChE,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAGN;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CACT,kBAAkB,EAChB,YAAY,GACZ,UAAU,GACV,KAAK,GACL,uBAAuB,GACvB,uBAAuB,CAC1B,EACD,UAAU,EAAE,qBAAqB,GAChC,IAAI,CASN;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,EAClD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAET"}

package/dist/utils/interaction-router.js

@@ -0,0 +1,114 @@
+import { applyInteractionInputDefaults, dependentInputKeys, hasInteractionFieldErrors, inputByKey, interactionArmScope, interactionInputKeys, isInputValueReady, resolveInputDomain, toggleManyValue, validateInteractionInputDomains, } from "./interaction-inputs.js";
+export function applyInteractionDraftMutation(store, descriptor, mutations) {
+    const nextDraft = {
+        ...store.getDraft(descriptor.interactionKey),
+    };
+    const mutatedKeys = new Set(mutations.map((mutation) => mutation.key));
+    for (const { key, value } of mutations) {
+        nextDraft[key] = value;
+    }
+    for (const { key } of mutations) {
+        for (const dependentKey of dependentInputKeys(descriptor, key)) {
+            if (mutatedKeys.has(dependentKey))
+                continue;
+            if (shouldClearDependentInput(descriptor, nextDraft, dependentKey)) {
+                delete nextDraft[dependentKey];
+            }
+        }
+    }
+    for (const { key, value } of mutations) {
+        store.setInput(descriptor.interactionKey, key, value);
+    }
+    for (const { key } of mutations) {
+        for (const dependentKey of dependentInputKeys(descriptor, key)) {
+            if (mutatedKeys.has(dependentKey))
+                continue;
+            if (shouldClearDependentInput(descriptor, nextDraft, dependentKey)) {
+                store.clearInput(descriptor.interactionKey, dependentKey);
+            }
+        }
+    }
+    return nextDraft;
+}
+function shouldClearDependentInput(descriptor, draft, dependentKey) {
+    const input = inputByKey(descriptor, dependentKey);
+    if (!input)
+        return true;
+    const value = draft[dependentKey];
+    if (!isInputValueReady(resolveInputDomain(input, draft), value))
+        return true;
+    const errors = validateInteractionInputDomains(descriptor, draft);
+    return (errors[dependentKey]?.length ?? 0) > 0;
+}
+export function getInteractionDraftReadiness(descriptor, draft) {
+    const values = applyInteractionInputDefaults(descriptor, draft);
+    const missingInputs = interactionInputKeys(descriptor).filter((key) => {
+        const input = inputByKey(descriptor, key);
+        const value = values[key];
+        return input
+            ? !isInputValueReady(resolveInputDomain(input, values), value)
+            : value === null || value === undefined;
+    });
+    const missingInputSet = new Set(missingInputs);
+    const readyFrontier = missingInputs.filter((key) => {
+        const input = inputByKey(descriptor, key);
+        if (!input)
+            return true;
+        return (input.domain.dependsOn ?? []).every((dependencyKey) => {
+            if (missingInputSet.has(dependencyKey))
+                return false;
+            const dependency = inputByKey(descriptor, dependencyKey);
+            if (!dependency)
+                return values[dependencyKey] !== undefined;
+            return isInputValueReady(resolveInputDomain(dependency, values), values[dependencyKey]);
+        });
+    });
+    const fieldErrors = validateInteractionInputDomains(descriptor, values);
+    return {
+        values,
+        missingInputs,
+        readyFrontier,
+        blockedInputs: missingInputs.filter((key) => !readyFrontier.includes(key)),
+        fieldErrors,
+        ready: missingInputs.length === 0 && !hasInteractionFieldErrors(fieldErrors),
+    };
+}
+export function routeInteractionTarget(store, descriptor, target) {
+    const input = inputByKey(descriptor, target.inputKey);
+    const currentDraft = store.getDraft(descriptor.interactionKey);
+    const selection = input?.domain.type === "target" ? input.domain.selection : undefined;
+    const targetValue = selection?.mode === "many"
+        ? toggleManyValue(currentDraft[target.inputKey], target.value, selection)
+        : target.value;
+    const params = applyInteractionDraftMutation(store, descriptor, [
+        ...Object.entries(target.extraInputs ?? {}).map(([key, value]) => ({
+            key,
+            value,
+        })),
+        { key: target.inputKey, value: targetValue },
+    ]);
+    return {
+        params,
+        readiness: getInteractionDraftReadiness(descriptor, params),
+    };
+}
+export function shouldRouteInteractionPending(descriptor, readiness) {
+    return descriptor.commit.mode !== "autoWhenReady" || !readiness.ready;
+}
+export function markInteractionPending(store, descriptor) {
+    store.arm(interactionArmScope(descriptor), descriptor.interactionKey);
+    store.setPendingInteraction(descriptor.interactionKey);
+}
+export function clearInteractionRoute(store, descriptor) {
+    const armScope = interactionArmScope(descriptor);
+    store.clearInput(descriptor.interactionKey);
+    if (store.getArmed(armScope) === descriptor.interactionKey) {
+        store.arm(armScope, null);
+    }
+    if (store.getPendingInteraction() === descriptor.interactionKey) {
+        store.setPendingInteraction(null);
+    }
+}
+export function claimInteractionSubmit(store, descriptor) {
+    return store.claimSubmitting(descriptor.interactionKey);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamboard-games/ui-sdk",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "description": "UI SDK for dreamboard plugin development",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/ActionButton.tsx

@@ -6,6 +6,7 @@
 
 import type { ButtonHTMLAttributes, ReactNode } from "react";
 import type { InteractionHandle } from "../hooks/useInteractionHandle.js";
+import { submitInteraction } from "../primitives/interaction-submit.js";
 import { interactionLabel } from "../utils/interaction-labels.js";
 import { ThemedButton } from "./ThemedButton.js";
 
@@ -29,7 +30,7 @@ export function ActionButton({
       disabled={disabled || !handle.available}
       title={title ?? formatUnavailableReason(handle.unavailableReason)}
       onClick={() => {
-        void handle.submit();
+        void submitInteraction(handle);
       }}
       {...rest}
     >

package/src/components/Card.tsx

@@ -21,7 +21,7 @@ export interface CardProps<CardData extends ViewCard = ViewCard>
   size?: "sm" | "md" | "lg";
   faceDown?: boolean;
   renderContent?: (card: CardData) => React.ReactNode;
-  onCardClick?: (cardId: string) => void;
+  onCardClick?: (cardId: CardData["id"]) => void;
   "aria-label"?: string;
 }
 

package/src/components/DiceRoller.tsx

@@ -21,11 +21,12 @@ import type {
   InteractionHandle,
   InteractionParamsShape,
 } from "../hooks/useInteractionHandle.js";
+import { normalizeDiceState, type DiceValue } from "../primitives/index.js";
 import { interactionLabel } from "../utils/interaction-labels.js";
 import { ThemedButton } from "./ThemedButton.js";
 
 export interface DiceRollerRenderProps {
-  values: Array<number | undefined> | undefined;
+  values: ReadonlyArray<number | undefined> | undefined;
   /** Undefined if any die hasn't been rolled */
   sum: number | undefined;
   diceCount: number;
@@ -48,7 +49,7 @@ export interface DiceRollerRollAction<
 export interface DiceRollerProps<
   Params extends InteractionParamsShape = InteractionParamsShape,
 > {
-  values?: Array<number | undefined>;
+  values?: readonly DiceValue[] | null;
   /** Used when values not provided */
   diceCount?: number;
   render?: (props: DiceRollerRenderProps) => ReactNode;
@@ -72,19 +73,7 @@ export function DiceRoller<
   rollAction,
   className,
 }: DiceRollerProps<Params>) {
-  const allRolled =
-    values?.every((v) => v !== null && v !== undefined) ?? false;
-  const sum = allRolled
-    ? values?.reduce((a, b) => (a ?? 0) + (b ?? 0), 0)
-    : undefined;
-  const displayCount = values?.length ?? diceCount;
-
-  const renderProps: DiceRollerRenderProps = {
-    values,
-    sum,
-    diceCount: displayCount,
-    allRolled,
-  };
+  const renderProps = normalizeDiceState({ values, count: diceCount });
 
   return (
     <div
@@ -97,15 +86,15 @@ export function DiceRoller<
       {rollAction ? (
         <DiceRollDialog
           action={rollAction}
-          values={values}
-          diceCount={displayCount}
+          values={renderProps.values}
+          diceCount={renderProps.diceCount}
         />
       ) : null}
 
       {/* Screen reader only: dice info */}
       <div className="sr-only" aria-live="polite">
-        {allRolled && values
-          ? `Rolled ${values.join(", ")}. Total: ${sum}`
+        {renderProps.allRolled && renderProps.values
+          ? `Rolled ${renderProps.values.join(", ")}. Total: ${renderProps.sum}`
           : "Dice not rolled yet"}
       </div>
     </div>
@@ -152,7 +141,7 @@ function DiceRollDialog<Params extends InteractionParamsShape>({
   diceCount,
 }: {
   action: DiceRollerRollAction<Params>;
-  values: Array<number | undefined> | undefined;
+  values: ReadonlyArray<number | undefined> | undefined;
   diceCount: number;
 }) {
   const theme = useTheme();
@@ -409,7 +398,7 @@ function DiceRow({
   size,
   rolling,
 }: {
-  values: Array<number | undefined>;
+  values: ReadonlyArray<number | undefined>;
   size: number;
   rolling: boolean;
 }) {
@@ -595,7 +584,9 @@ function nextAnimatedValues(count: number): number[] {
   });
 }
 
-function sumValues(values: Array<number | undefined>): number | undefined {
+function sumValues(
+  values: ReadonlyArray<number | undefined>,
+): number | undefined {
   if (!values.every((value) => typeof value === "number")) return undefined;
   return values.reduce((total, value) => total + (value ?? 0), 0);
 }

package/src/components/ErrorBoundary.test.tsx

@@ -0,0 +1,19 @@
+import { expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+test("ErrorBoundary fallback is styled without relying on consumer Tailwind output", () => {
+  const source = readFileSync(
+    join(import.meta.dir, "ErrorBoundary.tsx"),
+    "utf8",
+  );
+
+  expect(source).toContain("satisfies Record<string, CSSProperties>");
+  expect(source).toContain('background: "#fff"');
+  expect(source).toContain('border: "2px solid #0f172a"');
+  expect(source).toContain('boxShadow: "6px 6px 0 #111827"');
+  expect(source).toContain(
+    "<h1 style={styles.title}>Game failed to start</h1>",
+  );
+  expect(source).not.toContain("bg-gradient-to-br");
+});