@dreamboard-games/ui-sdk 0.0.41

package/dist/primitives/player-roster.js

@@ -0,0 +1,149 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, Fragment, useContext, useMemo, } from "react";
+import { useActivePlayers } from "../hooks/useActivePlayers.js";
+import { usePlayerInfo } from "../hooks/usePlayerInfo.js";
+import { usePlayerTurnOrder } from "../hooks/usePlayerTurnOrder.js";
+import { usePluginActions } from "../context/PluginStateContext.js";
+import { usePluginSession } from "../context/PluginSessionContext.js";
+import { composeEventHandlers, renderPrimitive, } from "./primitive-props.js";
+const PlayerRosterContext = createContext(null);
+function usePlayerRosterContext() {
+    const value = useContext(PlayerRosterContext);
+    if (!value) {
+        throw new Error("PlayerRoster primitives must be rendered inside <PlayerRoster.Root>.");
+    }
+    return value;
+}
+function projectBadges(badges, playerId) {
+    return (badges?.(playerId) ?? []).filter((badge) => Boolean(badge));
+}
+export function PlayerRosterRoot({ children, order = "turn", include = "all", score, scoreLabel, badges, metadata, }) {
+    const playerInfo = usePlayerInfo();
+    const activePlayers = useActivePlayers();
+    const turnOrder = usePlayerTurnOrder();
+    const { controllingPlayerId, controllablePlayerIds } = usePluginSession();
+    const players = useMemo(() => {
+        const orderedPlayerIds = order === "self-first" && controllingPlayerId
+            ? [
+                ...turnOrder.filter((pid) => pid === controllingPlayerId),
+                ...turnOrder.filter((pid) => pid !== controllingPlayerId),
+            ]
+            : turnOrder;
+        return orderedPlayerIds
+            .map((playerId, index) => {
+            const player = playerInfo.get(playerId);
+            const isCurrentPlayer = playerId === controllingPlayerId;
+            const isControllable = controllablePlayerIds.includes(playerId);
+            const resolvedScoreLabel = typeof scoreLabel === "function" ? scoreLabel(playerId) : scoreLabel;
+            return {
+                playerId,
+                name: player?.name ?? playerId,
+                color: player?.color,
+                index,
+                isActive: activePlayers.includes(playerId),
+                isCurrentPlayer,
+                isControllable,
+                canSwitchToPlayer: controllablePlayerIds.length > 1 &&
+                    isControllable &&
+                    !isCurrentPlayer,
+                score: score?.(playerId),
+                scoreLabel: resolvedScoreLabel,
+                badges: projectBadges(badges, playerId),
+                metadata: metadata?.(playerId),
+            };
+        })
+            .filter((player) => {
+            if (include === "self")
+                return player.isCurrentPlayer;
+            if (include === "opponents")
+                return !player.isCurrentPlayer;
+            return true;
+        });
+    }, [
+        activePlayers,
+        badges,
+        controllablePlayerIds,
+        controllingPlayerId,
+        include,
+        metadata,
+        order,
+        playerInfo,
+        score,
+        scoreLabel,
+        turnOrder,
+    ]);
+    const value = useMemo(() => ({ players }), [players]);
+    return (_jsx(PlayerRosterContext.Provider, { value: value, children: children }));
+}
+export function PlayerRosterList({ children, ...props }) {
+    const { players } = usePlayerRosterContext();
+    return renderPrimitive("div", {
+        ...props,
+        "data-dreamboard-player-roster-list": "",
+        children: players.map((player) => (_jsx(Fragment, { children: children ? children(player) : _jsx(PlayerRosterName, { player: player }) }, player.playerId))),
+    });
+}
+export function PlayerRosterEmpty({ children }) {
+    const { players } = usePlayerRosterContext();
+    if (players.length > 0)
+        return null;
+    return _jsx(_Fragment, { children: children });
+}
+export function PlayerRosterSwitchButton({ player, disabled, onClick, ...props }) {
+    const { switchPlayer } = usePluginActions();
+    const isDisabled = disabled === true || !player.canSwitchToPlayer;
+    return renderPrimitive("button", {
+        type: "button",
+        ...props,
+        disabled: isDisabled,
+        "aria-current": player.isCurrentPlayer ? "true" : undefined,
+        "aria-disabled": isDisabled,
+        "data-dreamboard-player-roster-switch": "",
+        "data-player-id": player.playerId,
+        "data-active": player.isActive || undefined,
+        "data-current": player.isCurrentPlayer || undefined,
+        "data-controllable": player.isControllable || undefined,
+        "data-switchable": player.canSwitchToPlayer || undefined,
+        "data-disabled": isDisabled || undefined,
+        onClick: composeEventHandlers(onClick, () => {
+            if (!isDisabled)
+                switchPlayer(player.playerId);
+        }),
+    });
+}
+export function PlayerRosterName({ player, children, ...props }) {
+    return renderPrimitive("span", {
+        ...props,
+        "data-dreamboard-player-roster-name": "",
+        children: children ?? player.name,
+    });
+}
+export function PlayerRosterScore({ player, children, ...props }) {
+    if (player.score === undefined && children === undefined)
+        return null;
+    const label = player.scoreLabel ? ` ${player.scoreLabel}` : "";
+    return renderPrimitive("span", {
+        ...props,
+        "data-dreamboard-player-roster-score": "",
+        children: children ?? `${player.score}${label}`,
+    });
+}
+export function PlayerRosterBadges({ player, children, ...props }) {
+    if (player.badges.length === 0 && children === undefined)
+        return null;
+    return renderPrimitive("span", {
+        ...props,
+        "data-dreamboard-player-roster-badges": "",
+        children: children ??
+            player.badges.map((badge) => (_jsxs("span", { "data-dreamboard-player-roster-badge": "", title: badge.tooltip, "aria-label": badge.tooltip, children: [badge.icon, badge.label] }, badge.key))),
+    });
+}
+export const PlayerRoster = {
+    Root: PlayerRosterRoot,
+    List: PlayerRosterList,
+    Empty: PlayerRosterEmpty,
+    SwitchButton: PlayerRosterSwitchButton,
+    Name: PlayerRosterName,
+    Score: PlayerRosterScore,
+    Badges: PlayerRosterBadges,
+};

package/dist/primitives/primitive-props.d.ts

@@ -0,0 +1,15 @@
+import { type AriaAttributes, type CSSProperties, type HTMLAttributes, type JSX, type ReactElement, type ReactNode } from "react";
+export type PrimitiveDataAttributes = Record<`data-${string}`, string | boolean | number | undefined>;
+export type PrimitiveCommonProps = {
+    asChild?: boolean;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+} & AriaAttributes & PrimitiveDataAttributes;
+type EventHandler<Event> = (event: Event) => void;
+export declare function composeEventHandlers<Event extends {
+    defaultPrevented: boolean;
+}>(authorHandler: EventHandler<Event> | undefined, primitiveHandler: EventHandler<Event> | undefined): EventHandler<Event> | undefined;
+export declare function renderPrimitive<ElementProps extends HTMLAttributes<HTMLElement>>(tagName: keyof JSX.IntrinsicElements, props: ElementProps & PrimitiveCommonProps): ReactElement;
+export {};
+//# sourceMappingURL=primitive-props.d.ts.map

package/dist/primitives/primitive-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-props.d.ts","sourceRoot":"","sources":["../../src/primitives/primitive-props.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,GAAG,EAGR,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAC1C,QAAQ,MAAM,EAAE,EAChB,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,cAAc,GAChB,uBAAuB,CAAC;AAE1B,KAAK,YAAY,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAElD,wBAAgB,oBAAoB,CAClC,KAAK,SAAS;IAAE,gBAAgB,EAAE,OAAO,CAAA;CAAE,EAE3C,aAAa,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,EAC9C,gBAAgB,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,GAChD,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,CASjC;AAED,wBAAgB,eAAe,CAC7B,YAAY,SAAS,cAAc,CAAC,WAAW,CAAC,EAEhD,OAAO,EAAE,MAAM,GAAG,CAAC,iBAAiB,EACpC,KAAK,EAAE,YAAY,GAAG,oBAAoB,GACzC,YAAY,CAgCd"}

package/dist/primitives/primitive-props.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cloneElement, isValidElement, } from "react";
+export function composeEventHandlers(authorHandler, primitiveHandler) {
+    if (!authorHandler)
+        return primitiveHandler;
+    if (!primitiveHandler)
+        return authorHandler;
+    return (event) => {
+        authorHandler(event);
+        if (!event.defaultPrevented) {
+            primitiveHandler(event);
+        }
+    };
+}
+export function renderPrimitive(tagName, props) {
+    const { asChild, children, ...primitiveProps } = props;
+    if (asChild) {
+        if (!isValidElement(children)) {
+            throw new Error("asChild requires exactly one valid React element child.");
+        }
+        const element = children;
+        const childProps = element.props;
+        return cloneElement(element, {
+            ...primitiveProps,
+            ...childProps,
+            className: [primitiveProps.className, childProps.className]
+                .filter(Boolean)
+                .join(" "),
+            style: {
+                ...(primitiveProps.style ?? {}),
+                ...(childProps.style ?? {}),
+            },
+            onClick: composeEventHandlers(childProps.onClick, primitiveProps.onClick),
+            onChange: composeEventHandlers(childProps.onChange, primitiveProps.onChange),
+        });
+    }
+    const Tag = tagName;
+    return _jsx(Tag, { ...primitiveProps, children: children });
+}

package/dist/primitives/prompt.d.ts

@@ -0,0 +1,44 @@
+import { type ButtonHTMLAttributes, type ReactNode } from "react";
+import type { PromptKey, PromptOptionKey } from "../ui-contract.js";
+import type { InteractionDescriptor } from "../types/plugin-state.js";
+import { type InteractionPartProps, type InteractionRootProps } from "./interaction.js";
+import { type PrimitiveCommonProps } from "./primitive-props.js";
+export type PromptRootProps<Prompt extends string = PromptKey> = InteractionRootProps<Prompt>;
+export declare function PromptRoot<Prompt extends string = PromptKey>(props: PromptRootProps<Prompt>): import("react/jsx-runtime").JSX.Element;
+export declare function PromptTitle(props: InteractionPartProps): import("react/jsx-runtime").JSX.Element;
+export declare function PromptMessage(props: InteractionPartProps): import("react/jsx-runtime").JSX.Element | null;
+export type PromptOptionProps<Option extends string = PromptOptionKey> = PrimitiveCommonProps & ButtonHTMLAttributes<HTMLButtonElement> & {
+    value: Option;
+    disableWhenUnavailable?: boolean;
+    onSubmitError?: (error: unknown) => void;
+    onSubmitSuccess?: () => void;
+};
+export declare function PromptOption<Option extends string = PromptOptionKey>({ value, disabled, disableWhenUnavailable, onClick, onSubmitError, onSubmitSuccess, children, ...props }: PromptOptionProps<Option>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export declare function PromptOptions({ children, }: {
+    children?: (option: {
+        id: string;
+        label?: string;
+    }) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PromptInboxRoot({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PromptInboxEmpty({ children }: {
+    children?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function PromptInboxItems({ children, }: {
+    children?: (prompt: InteractionDescriptor) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare const Prompt: {
+    Root: typeof PromptRoot;
+    Title: typeof PromptTitle;
+    Message: typeof PromptMessage;
+    Option: typeof PromptOption;
+    Options: typeof PromptOptions;
+};
+export declare const PromptInbox: {
+    Root: typeof PromptInboxRoot;
+    Empty: typeof PromptInboxEmpty;
+    Items: typeof PromptInboxItems;
+};
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/primitives/prompt.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,MAAM,GAAG,SAAS,IAC3D,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAE/B,wBAAgB,UAAU,CAAC,MAAM,SAAS,MAAM,GAAG,SAAS,EAC1D,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,2CAG/B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,2CAStD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,kDASxD;AAED,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,eAAe,IACnE,oBAAoB,GAClB,oBAAoB,CAAC,iBAAiB,CAAC,GAAG;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEN,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,GAAG,eAAe,EAAE,EACpE,KAAK,EACL,QAAQ,EACR,sBAA8B,EAC9B,OAAO,EACP,aAAa,EACb,eAAe,EACf,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,MAAM,CAAC,8FAqC3B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;CAClE,2CAcA;AAkBD,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAOpE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,kDAItE;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,SAAS,CAAC;CACzD,2CAoBA;AAED,eAAO,MAAM,MAAM;;;;;;CAMlB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;CAIvB,CAAC"}

package/dist/primitives/prompt.js

@@ -0,0 +1,101 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useContext, } from "react";
+import { useSeatInbox } from "../hooks/useSeatInbox.js";
+import { interactionInputKeys } from "../utils/interaction-inputs.js";
+import { interactionLabel } from "../utils/interaction-labels.js";
+import { InteractionDescription, InteractionLabel, InteractionRoot, useInteractionPrimitiveContext, } from "./interaction.js";
+import { composeEventHandlers, renderPrimitive, } from "./primitive-props.js";
+export function PromptRoot(props) {
+    return _jsx(InteractionRoot, { ...props });
+}
+export function PromptTitle(props) {
+    const { descriptor } = useInteractionPrimitiveContext();
+    return (_jsx(InteractionLabel, { ...props, children: props.children ??
+            descriptor?.context?.title ??
+            (descriptor ? interactionLabel(descriptor) : undefined) }));
+}
+export function PromptMessage(props) {
+    const { descriptor } = useInteractionPrimitiveContext();
+    const message = props.children ??
+        (typeof descriptor?.context?.payload?.message === "string"
+            ? descriptor.context.payload.message
+            : undefined);
+    if (!message)
+        return null;
+    return _jsx(InteractionDescription, { ...props, children: message });
+}
+export function PromptOption({ value, disabled, disableWhenUnavailable = false, onClick, onSubmitError, onSubmitSuccess, children, ...props }) {
+    const { descriptor, handle } = useInteractionPrimitiveContext();
+    const option = descriptor?.context?.options?.find((candidate) => candidate.id === value);
+    const inputKey = descriptor ? interactionInputKeys(descriptor)[0] : undefined;
+    const isDisabled = disabled ??
+        (!handle ||
+            !inputKey ||
+            handle.status !== "open" ||
+            option?.data === false ||
+            (disableWhenUnavailable && !descriptor?.available));
+    return renderPrimitive("button", {
+        type: "button",
+        ...props,
+        disabled: isDisabled,
+        "aria-disabled": isDisabled,
+        "data-dreamboard-prompt-option": "",
+        "data-option-value": value,
+        "data-disabled": isDisabled || undefined,
+        "data-available": descriptor?.available ?? false,
+        onClick: composeEventHandlers(onClick, () => {
+            if (!handle || !inputKey || isDisabled)
+                return;
+            void handle
+                .submit({ [inputKey]: value })
+                .then(() => onSubmitSuccess?.())
+                .catch((error) => {
+                if (onSubmitError) {
+                    onSubmitError(error);
+                    return;
+                }
+                console.error(error);
+            });
+        }),
+        children: children ?? option?.label ?? value,
+    });
+}
+export function PromptOptions({ children, }) {
+    const { descriptor } = useInteractionPrimitiveContext();
+    const options = descriptor?.context?.options ?? [];
+    return (_jsx(_Fragment, { children: options.map((option) => children ? (children(option)) : (_jsx(PromptOption, { value: option.id }, option.id))) }));
+}
+const PromptInboxContext = createContext(null);
+function usePromptInboxContext() {
+    const value = useContext(PromptInboxContext);
+    if (!value) {
+        throw new Error("PromptInbox primitives must be rendered inside <PromptInbox.Root>.");
+    }
+    return value;
+}
+export function PromptInboxRoot({ children }) {
+    const inbox = useSeatInbox();
+    return (_jsx(PromptInboxContext.Provider, { value: { prompts: inbox.prompts }, children: children }));
+}
+export function PromptInboxEmpty({ children }) {
+    const { prompts } = usePromptInboxContext();
+    if (prompts.length > 0)
+        return null;
+    return _jsx(_Fragment, { children: children });
+}
+export function PromptInboxItems({ children, }) {
+    const { prompts } = usePromptInboxContext();
+    return (_jsx(_Fragment, { children: prompts.map((prompt) => children ? (children(prompt)) : (_jsxs(PromptRoot, { interaction: prompt.interactionKey, children: [_jsx(PromptTitle, {}), _jsx(PromptMessage, {}), _jsx(PromptOptions, {})] }, prompt.interactionKey))) }));
+}
+export const Prompt = {
+    Root: PromptRoot,
+    Title: PromptTitle,
+    Message: PromptMessage,
+    Option: PromptOption,
+    Options: PromptOptions,
+};
+export const PromptInbox = {
+    Root: PromptInboxRoot,
+    Empty: PromptInboxEmpty,
+    Items: PromptInboxItems,
+};

package/dist/primitives/zone.d.ts

@@ -0,0 +1,31 @@
+import { type HTMLAttributes } from "react";
+import type { ZoneHandlesSnapshot } from "../types/plugin-state.js";
+import type { ZoneKey } from "../ui-contract.js";
+import { type PrimitiveCommonProps } from "./primitive-props.js";
+interface ZoneContextValue {
+    zone: string;
+    snapshot: ZoneHandlesSnapshot | null;
+}
+interface ZoneCardContextValue {
+    zone: string;
+    cardId: string;
+}
+export declare function useZonePrimitiveContext(): ZoneContextValue;
+export declare function useZoneCardContext(): ZoneCardContextValue | null;
+export interface ZoneRootProps<Zone extends string = ZoneKey> extends PrimitiveCommonProps, HTMLAttributes<HTMLElement> {
+    zone: Zone;
+}
+export declare function ZoneRoot<Zone extends string = ZoneKey>({ zone, children, ...props }: ZoneRootProps<Zone>): import("react/jsx-runtime").JSX.Element;
+export type ZoneListProps = PrimitiveCommonProps & HTMLAttributes<HTMLElement>;
+export declare function ZoneList({ children, ...props }: ZoneListProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export interface ZoneItemProps extends PrimitiveCommonProps, HTMLAttributes<HTMLElement> {
+    card: string;
+}
+export declare function ZoneItem({ card, children, ...props }: ZoneItemProps): import("react/jsx-runtime").JSX.Element;
+export declare const Zone: {
+    Root: typeof ZoneRoot;
+    List: typeof ZoneList;
+    Item: typeof ZoneItem;
+};
+export {};
+//# sourceMappingURL=zone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../src/primitives/zone.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACtC;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD,wBAAgB,uBAAuB,IAAI,gBAAgB,CAM1D;AAED,wBAAgB,kBAAkB,IAAI,oBAAoB,GAAG,IAAI,CAEhE;AAED,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,MAAM,GAAG,OAAO,CAC1D,SAAQ,oBAAoB,EAC1B,cAAc,CAAC,WAAW,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,QAAQ,CAAC,IAAI,SAAS,MAAM,GAAG,OAAO,EAAE,EACtD,IAAI,EACJ,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,aAAa,CAAC,IAAI,CAAC,2CAkBrB;AAED,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE/E,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,8FAW7D;AAED,MAAM,WAAW,aACf,SAAQ,oBAAoB,EAC1B,cAAc,CAAC,WAAW,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,2CAqBnE;AAED,eAAO,MAAM,IAAI;;;;CAIhB,CAAC"}

package/dist/primitives/zone.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { usePluginState } from "../context/PluginStateContext.js";
+import { renderPrimitive, } from "./primitive-props.js";
+const ZoneContext = createContext(null);
+const ZoneCardContext = createContext(null);
+export function useZonePrimitiveContext() {
+    const value = useContext(ZoneContext);
+    if (!value) {
+        throw new Error("Zone primitives must be rendered inside <Zone.Root>.");
+    }
+    return value;
+}
+export function useZoneCardContext() {
+    return useContext(ZoneCardContext);
+}
+export function ZoneRoot({ zone, children, ...props }) {
+    const snapshot = usePluginState((state) => state.gameplay.zones[zone]) ?? null;
+    const value = useMemo(() => ({ zone, snapshot }), [snapshot, zone]);
+    return (_jsx(ZoneContext.Provider, { value: value, children: renderPrimitive("div", {
+            ...props,
+            "data-dreamboard-zone-root": "",
+            "data-zone": zone,
+            "data-card-count": snapshot?.cardIds.length ?? 0,
+            children,
+        }) }));
+}
+export function ZoneList({ children, ...props }) {
+    const { zone, snapshot } = useZonePrimitiveContext();
+    const isEmpty = (snapshot?.cardIds.length ?? 0) === 0;
+    return renderPrimitive("div", {
+        ...props,
+        role: props.role ?? "list",
+        "data-dreamboard-zone-list": "",
+        "data-zone": zone,
+        "data-empty": isEmpty || undefined,
+        children,
+    });
+}
+export function ZoneItem({ card, children, ...props }) {
+    const { zone, snapshot } = useZonePrimitiveContext();
+    const playable = snapshot?.playableByCardId[card] ?? [];
+    const cardContext = useMemo(() => ({ zone, cardId: card }), [card, zone]);
+    return (_jsx(ZoneCardContext.Provider, { value: cardContext, children: renderPrimitive("div", {
+            ...props,
+            role: props.role ?? "listitem",
+            "data-dreamboard-zone-item": "",
+            "data-zone": zone,
+            "data-card-id": card,
+            "data-playable": playable.some((descriptor) => descriptor.available) || undefined,
+            children,
+        }) }));
+}
+export const Zone = {
+    Root: ZoneRoot,
+    List: ZoneList,
+    Item: ZoneItem,
+};

package/dist/reducer.d.ts

@@ -0,0 +1,21 @@
+export { useActivePlayers } from "./hooks/useActivePlayers.js";
+export { useSimultaneousPhase } from "./hooks/useSimultaneousPhase.js";
+export { usePlayerTurnOrder } from "./hooks/usePlayerTurnOrder.js";
+export { useGameSelector } from "./hooks/useGameSelector.js";
+export { useIsMyTurn } from "./hooks/useIsMyTurn.js";
+export { useCards } from "./hooks/useCards.js";
+export { useGameView } from "./hooks/useGameView.js";
+export { useLobby } from "./hooks/useLobby.js";
+export { useMe } from "./hooks/useMe.js";
+export { usePlayerInfo } from "./hooks/usePlayerInfo.js";
+export { useSeatInbox, type SeatInbox } from "./hooks/useSeatInbox.js";
+export { useInteractionHandle, type InteractionHandle, type InteractionHandleStatus, type DraftValidation, type InteractionParamsShape, } from "./hooks/useInteractionHandle.js";
+export { useInteractionByKey } from "./hooks/useInteractionByKey.js";
+export { usePluginSession } from "./context/PluginSessionContext.js";
+export { type ClientParamSchema, type ClientParamSchemaMap, } from "./context/ClientParamSchemaContext.js";
+export type { GameplayPromptOption, GameplaySnapshot, PluginStateSnapshot, } from "./types/reducer-state.js";
+export type { InteractionDescriptor, InteractionContext, InteractionContextOption, } from "./types/plugin-state.js";
+export type { LobbyState } from "./hooks/useLobby.js";
+export type { Player } from "./hooks/useMe.js";
+export type { CardCollection, ViewCard, ViewSlotOccupant, } from "@dreamboard/sdk-types";
+//# sourceMappingURL=reducer.d.ts.map

package/dist/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../src/reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,uCAAuC,CAAC;AAE/C,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,cAAc,EACd,QAAQ,EACR,gBAAgB,GACjB,MAAM,uBAAuB,CAAC"}

package/dist/reducer.js

@@ -0,0 +1,14 @@
+export { useActivePlayers } from "./hooks/useActivePlayers.js";
+export { useSimultaneousPhase } from "./hooks/useSimultaneousPhase.js";
+export { usePlayerTurnOrder } from "./hooks/usePlayerTurnOrder.js";
+export { useGameSelector } from "./hooks/useGameSelector.js";
+export { useIsMyTurn } from "./hooks/useIsMyTurn.js";
+export { useCards } from "./hooks/useCards.js";
+export { useGameView } from "./hooks/useGameView.js";
+export { useLobby } from "./hooks/useLobby.js";
+export { useMe } from "./hooks/useMe.js";
+export { usePlayerInfo } from "./hooks/usePlayerInfo.js";
+export { useSeatInbox } from "./hooks/useSeatInbox.js";
+export { useInteractionHandle, } from "./hooks/useInteractionHandle.js";
+export { useInteractionByKey } from "./hooks/useInteractionByKey.js";
+export { usePluginSession } from "./context/PluginSessionContext.js";

package/dist/runtime/createPluginRuntimeAPI.d.ts

@@ -0,0 +1,67 @@
+import type { RuntimeAPI, PluginSessionState } from "../types/runtime-api.js";
+import type { PluginStateSnapshot } from "../types/plugin-state.js";
+/**
+ * Extended RuntimeAPI with plugin-specific methods for state-sync architecture.
+ */
+export interface PluginRuntimeAPI extends RuntimeAPI {
+    /**
+     * Get the current state snapshot.
+     * Returns null if no state-sync has been received yet.
+     *
+     * @example
+     * ```typescript
+     * const snapshot = runtime.getSnapshot();
+     * if (snapshot?.view) {
+     *   console.log('Current view:', snapshot.view);
+     * }
+     * ```
+     */
+    getSnapshot: () => PluginStateSnapshot | null;
+    /**
+     * Subscribe to state changes from state-sync messages.
+     * Called whenever the host sends a new state-sync.
+     *
+     * @param listener - Callback invoked with new state snapshot
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = runtime.subscribeToState((state) => {
+     *   console.log('New phase:', state.gameplay.currentPhase);
+     * });
+     * ```
+     */
+    subscribeToState: (listener: (state: PluginStateSnapshot) => void) => () => void;
+    /** Internal API for RuntimeContext to subscribe to session state changes */
+    _subscribeToSessionState: (listener: (state: PluginSessionState) => void) => () => void;
+    /**
+     * Request to restore game state to a previous history entry.
+     * Only works if the user is the host.
+     *
+     * @param entryId - ID of the history entry to restore to
+     *
+     * @example
+     * ```typescript
+     * // Restore to a previous state
+     * runtime.restoreHistory?.('entry-abc-123');
+     * ```
+     */
+    restoreHistory?: (entryId: string) => void;
+}
+/**
+ * Creates a RuntimeAPI implementation for plugin iframes.
+ *
+ * Architecture (state-sync):
+ * - Host maintains all state in GameSessionStore
+ * - Host sends complete state snapshots via state-sync messages
+ * - Plugin stores received state and notifies subscribers
+ * - No buffering needed - plugin only renders when state exists
+ *
+ * Security:
+ * - Plugin runs in sandboxed iframe (no network access, no same-origin)
+ * - All backend communication goes through main app
+ *
+ * @returns PluginRuntimeAPI instance
+ */
+export declare function createPluginRuntimeAPI(): PluginRuntimeAPI;
+//# sourceMappingURL=createPluginRuntimeAPI.d.ts.map

package/dist/runtime/createPluginRuntimeAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPluginRuntimeAPI.d.ts","sourceRoot":"","sources":["../../src/runtime/createPluginRuntimeAPI.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AA+DpE;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD;;;;;;;;;;;OAWG;IACH,WAAW,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;IAE9C;;;;;;;;;;;;;OAaG;IACH,gBAAgB,EAAE,CAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,KAC3C,MAAM,IAAI,CAAC;IAEhB,4EAA4E;IAC5E,wBAAwB,EAAE,CACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,KAC1C,MAAM,IAAI,CAAC;IAEhB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAkCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CA+azD"}