@dreamboard-games/sdk 0.5.0-alpha.2 → 0.5.0-alpha.21

package/dist/runtime/primitives.d.ts

@@ -1,250 +0,0 @@
-import { bh as ZoneCardRenderItem } from '../ui-contract-GTUPkf8z.js';
-export { B as Board, a as BoardEdgeTarget, b as BoardEdgeTargetProps, c as BoardGridInteractionFilter, d as BoardHexGrid, e as BoardHexGridInteractionFilter, f as BoardHexGridInteractions, g as BoardHexGridProps, h as BoardHexView, i as BoardHexViewProps, j as BoardRoot, k as BoardRootProps, l as BoardSpaceTarget, m as BoardSpaceTargetProps, n as BoardSquareGrid, o as BoardSquareGridInteractionFilter, p as BoardSquareGridProps, q as BoardState, r as BoardStateProps, s as BoardTarget, t as BoardTargetExtraInputs, u as BoardTargetProps, v as BoardVertexTarget, w as BoardVertexTargetProps, D as Dice, x as DiceComponents, y as DiceRoot, z as DiceRootProps, A as DiceState, C as DiceValue, E as DiceValues, F as DiceValuesProps, H as Game, I as GameActiveActionState, J as GameChrome, K as GameChromeProps, L as GameChromeState, M as GameMeState, N as GamePendingInputState, O as GamePlayer, P as GamePlayerEntry, Q as GamePlayersState, R as GameRenderState, S as GameRoot, T as GameRootProps, U as GameTurnState, V as GameViewport, W as GameViewportProps, X as Interaction, Y as InteractionCardInput, Z as InteractionCardInputProps, _ as InteractionCardInputRenderState, $ as InteractionDescription, a0 as InteractionDialog, a1 as InteractionDialogProps, a2 as InteractionDialogRenderState, a3 as InteractionDialogState, a4 as InteractionFieldPrimitiveProps, a5 as InteractionFormPrimitive, a6 as InteractionFormPrimitiveProps, a7 as InteractionInput, a8 as InteractionInputProps, a9 as InteractionLabel, aa as InteractionPartProps, ab as InteractionRoot, ac as InteractionRootProps, ad as InteractionRoute, ae as InteractionRoutes, af as InteractionRoutesMap, ag as InteractionRoutesProps, ah as InteractionState, ai as InteractionStateProps, aj as InteractionStateSnapshot, ak as InteractionSubmit, al as InteractionSubmitProps, am as InteractionSwitch, an as InteractionSwitchProps, ao as InteractionSwitchRenderState, ap as InteractionSwitchRouteMap, aq as InteractionTrigger, ar as InteractionTriggerProps, as as InteractionUnavailableMessage, at as InteractionValidationMessage, au as Phase, av as PhaseFallback, aw as PhaseRouteMap, ax as PhaseSwitch, ay as PhaseSwitchProps, az as PlayerRoster, aA as PlayerRosterBadge, aB as PlayerRosterBadges, aC as PlayerRosterComponents, aD as PlayerRosterEmpty, aE as PlayerRosterEntry, aF as PlayerRosterList, aG as PlayerRosterListProps, aH as PlayerRosterName, aI as PlayerRosterPartProps, aJ as PlayerRosterRoot, aK as PlayerRosterRootProps, aL as PlayerRosterScore, aM as Prompt, aN as PromptDialog, aO as PromptDialogProps, aP as PromptDialogRenderState, aQ as PromptDialogState, aR as PromptInbox, aS as PromptInboxEmpty, aT as PromptInboxItems, aU as PromptInboxItemsProps, aV as PromptInboxRoot, aW as PromptMessage, aX as PromptOption, aY as PromptOptionProps, aZ as PromptOptionRenderItem, a_ as PromptOptions, a$ as PromptOptionsProps, b0 as PromptRoot, b1 as PromptRootProps, b2 as PromptTitle, b4 as UI, b6 as UIRoot, b7 as UIRootProps, b8 as UseZoneCardsOptions, b9 as UseZoneCardsResult, ba as Zone, bb as ZoneCardAction, bc as ZoneCardActionExtraInputs, bd as ZoneCardActionProps, be as ZoneCardActionResult, bf as ZoneCardAt, bg as ZoneCardAtProps, bi as ZoneItem, bj as ZoneItemProps, bk as ZoneList, bl as ZoneListProps, bm as ZonePileCards, bn as ZonePileCardsProps, bo as ZonePileContextValue, bp as ZonePileCount, bq as ZonePileCountProps, br as ZonePileDescription, bs as ZonePileDescriptionProps, bt as ZonePileLabel, bu as ZonePileLabelProps, bv as ZonePileRoot, bw as ZonePileRootProps, bx as ZonePileTrigger, by as ZonePileTriggerProps, bz as ZoneRoot, bA as ZoneRootProps, bB as ZoneTopCard, bC as ZoneTopCardProps, bD as createZoneCardRenderItem, bE as normalizeDiceState, bF as useBoardPrimitiveContext, bG as useDicePrimitiveContext, bH as useGameActionError, bI as useInteractionPrimitiveContext, bJ as useOptionalZonePrimitiveContext, bK as useResolvedCardTargetValue, bL as useZoneCardContext, bM as useZoneCards, bN as useZonePileContext, bO as useZonePrimitiveContext } from '../ui-contract-GTUPkf8z.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
-import { f as CardIntent, P as InteractionVisualState, C as CardDropTargetVisualState } from '../hex-board-view-aKkblDp6.js';
-import { a as HandLayoutKind, b as HandLayoutPolicy, H as HandInteractionPolicy } from '../HandView-Bi2lxzQP.js';
-import { b as InteractionDescriptor } from '../runtime-api-Bz5pwNU_.js';
-export { P as PrimitiveCommonProps, a as PrimitiveDataAttributes, c as composeEventHandlers, r as renderPrimitive } from '../primitive-props-BNHDkgd7.js';
-import '../ThemeProvider-CElaL2ik.js';
-import '../types.js';
-import '../attributes-DbvyMbXw.js';
-import '../types-DJj5MJkl.js';
-import '../player-state-Cqpyeql0.js';
-import './protocol-dYgafTYY.js';
-
-interface InteractionDraftReadiness {
-    values: Record<string, unknown>;
-    missingInputs: readonly string[];
-    readyFrontier: readonly string[];
-    blockedInputs: readonly string[];
-    fieldErrors: Partial<Record<string, readonly string[]>>;
-    ready: boolean;
-}
-
-type RuntimeDropTargetKind = "card" | "space" | "edge" | "vertex" | "tile";
-type CardIntentResult = {
-    status: "ignored";
-    reason: CardIntentIgnoredReason;
-} | {
-    status: "pending";
-    descriptor: InteractionDescriptor;
-    readiness: InteractionDraftReadiness;
-    params: Record<string, unknown>;
-} | {
-    status: "submitted";
-    descriptor: InteractionDescriptor;
-    readiness: InteractionDraftReadiness;
-    params: Record<string, unknown>;
-} | {
-    status: "submitting";
-    descriptor: InteractionDescriptor;
-    readiness: InteractionDraftReadiness;
-    params: Record<string, unknown>;
-} | {
-    status: "error";
-    descriptor: InteractionDescriptor;
-    error: unknown;
-};
-type CardIntentIgnoredReason = "no-descriptor" | "interaction-unavailable" | "no-card-input" | "card-not-eligible" | "drop-target-not-decodable" | "drop-target-input-unknown" | "drop-target-not-eligible" | "ambiguous-drop" | "already-submitting";
-
-type RuntimeCardIntentResult = CardIntentResult;
-/**
- * Author-facing card intent. Mirrors the SDK shape, but for `drop` intents
- * `targetId` is the manifest id (e.g. `"hex-a"`) — the runtime adapter
- * decodes the opaque SDK target id before invoking author callbacks. This
- * matches the type the generated `hand.Hand` facade declares.
- */
-type AuthoredCardIntent = {
-    type: "activate";
-    cardId: string;
-    source: "tap" | "keyboard";
-} | {
-    type: "previewStart";
-    cardId: string;
-} | {
-    type: "previewEnd";
-    cardId: string;
-} | {
-    type: "drop";
-    cardId: string;
-    targetId: string;
-    source: "pointer" | "keyboard";
-};
-/**
- * Translate a raw SDK `CardIntent` into the author-facing
- * `AuthoredCardIntent` shape. For drop intents the opaque encoded
- * `targetId` is decoded into its manifest value; non-decodable target
- * ids fall through unchanged so authors can detect and ignore them.
- */
-declare function decodeAuthoredCardIntent(intent: CardIntent): AuthoredCardIntent;
-interface UseCardIntentAdapterOptions {
-    /** Zone the hand is rendering. Used for snapshot lookup. */
-    zone: string;
-    /**
-     * Optional hook for the host to react to the runtime classification of an
-     * intent. Useful for confirmation animations or analytics. The intent is
-     * already routed by the time this fires. Receives the decoded
-     * authored-shape intent so `targetId` is the manifest id, not the SDK
-     * opaque encoding.
-     */
-    onResult?: (intent: AuthoredCardIntent, result: RuntimeCardIntentResult) => void;
-}
-/**
- * Bind SDK card intent emission to the canonical runtime collector pipeline.
- *
- * The returned callback accepts the SDK `CardIntent` shape unchanged. The
- * adapter looks up the descriptor for the originating card, atomically
- * applies the card and any decoded drop-target inputs, and routes
- * pending/submitting/submitted classifications through the runtime API.
- *
- * Preview intents are forwarded to the optional `onResult` callback as
- * `ignored` results so authors can attach analytics without owning the
- * routing logic themselves.
- */
-declare function useCardIntentAdapter({ zone, onResult, }: UseCardIntentAdapterOptions): (intent: CardIntent) => Promise<RuntimeCardIntentResult>;
-
-interface RuntimeDropTarget {
-    /** Stable opaque id; runtime adapter encodes the inputKey + value here. */
-    targetId: string;
-    /** Plain text label used by the SDK live-region announcements. */
-    label: string;
-    /** Optional `CardDropTargetVisualState` overrides. */
-    visualState?: CardDropTargetVisualState;
-    /** Visible content inside the drop target. */
-    render: (state: CardDropTargetVisualState) => ReactNode;
-    /** ARIA role override. Defaults to "button". */
-    role?: string;
-    /** Extra container className. */
-    className?: string;
-    /** Order hint for keyboard traversal. */
-    order?: number;
-}
-/**
- * Per-hand summary projected alongside the card list. Authors can render
- * counts ("3 of 5 selected") without re-deriving selection state.
- */
-interface HandSelectionSummary {
-    /** How many cards in this hand are part of the active many-select draft. */
-    selectedCount: number;
-    /** Card ids currently in the many-select draft, in iteration order. */
-    selectedIds: readonly string[];
-    /**
-     * Whether at least one descriptor in this zone has form-side validation
-     * errors against the current draft. Authors can use this to render an
-     * inline hint without inspecting individual fields.
-     */
-    hasInvalidSelection: boolean;
-}
-interface HandSurfaceViewProps<Card extends ZoneCardRenderItem> {
-    zone: string;
-    cards: readonly Card[];
-    /** Visual surface for a single card. */
-    renderCard: (card: Card, state: InteractionVisualState, index: number) => ReactNode;
-    /**
-     * Render-safe slot for selection summary content. Fires during render with
-     * the latest projected summary so authors can compose count chrome inline.
-     * The returned node is hoisted above the hand region. Use this for visible
-     * UI; use `onSelectionSummary` only for analytics or external state mirrors
-     * that need an effect.
-     */
-    summarySlot?: (summary: HandSelectionSummary) => ReactNode;
-    /**
-     * Optional selection summary observer. Invoked from a layout effect so
-     * consumers may safely call `setState` in response. Use `summarySlot` for
-     * inline rendering instead — that path avoids effect-timing surprises.
-     */
-    onSelectionSummary?: (summary: HandSelectionSummary) => void;
-    /**
-     * Render-safe slot for the hand's commit/action chrome. Receives the same
-     * live summary as `summarySlot`. Rendered below the hand inline on desktop
-     * and pinned as a sticky footer inside the mobile dock, so the action stays
-     * reachable while the hand is docked.
-     */
-    actionsSlot?: (summary: HandSelectionSummary) => ReactNode;
-    /** Layout policy forwarded to the SDK HandView. */
-    layout?: HandLayoutKind | HandLayoutPolicy;
-    /** Mobile interaction policy. Defaults to `direct-activate`. */
-    mobileInteraction?: HandInteractionPolicy;
-    /**
-     * Drop targets to render around the hand. When provided, the hand renders
-     * inside a `CardDragSurface` so SDK `drop` intents arrive with an opaque
-     * target id that the runtime adapter can decode.
-     */
-    dropTargets?: readonly RuntimeDropTarget[];
-    /**
-     * Optional outer chrome around the drop targets, when `dropTargets` is
-     * provided. Defaults to a flex row above the hand.
-     */
-    renderDropTargets?: (children: ReactNode) => ReactNode;
-    /** Card width hint forwarded to the SDK HandView. */
-    cardSize?: "sm" | "md" | "lg";
-    /** Extra empty-state slot. */
-    renderEmpty?: () => ReactNode;
-    /** ARIA label for the hand region. */
-    ariaLabel?: string;
-    /**
-     * Optional analytics hook. Receives the decoded authored intent (so
-     * `targetId` is the manifest value, not the SDK opaque encoding) plus
-     * the runtime classification.
-     */
-    onIntentRouted?: (intent: AuthoredCardIntent, result: RuntimeCardIntentResult) => void;
-    className?: string;
-}
-/**
- * Generated hand presentation entry point.
- *
- * Lives in `ui-runtime` because it owns:
- *
- * - mapping descriptor/draft state into SDK `InteractionVisualState`
- * - hiding selected cards from the visible hand layout while the runtime keeps
- *   the actual zone snapshot intact
- * - forwarding SDK `CardIntent` through the canonical collector adapter
- *
- * The component is intentionally Dreamboard-aware. The presentational
- * pieces (`HandView`, `CardDragSurface`, `CardDropTargetView`) come from
- * `@dreamboard-games/sdk/ui` and stay descriptor/draft unaware.
- */
-declare function HandSurfaceView<Card extends ZoneCardRenderItem>({ zone, cards, renderCard, layout, mobileInteraction, dropTargets, renderDropTargets, cardSize, renderEmpty, ariaLabel, onIntentRouted, onSelectionSummary, summarySlot, actionsSlot, className, }: HandSurfaceViewProps<Card>): react_jsx_runtime.JSX.Element;
-interface HandStagingViewProps {
-    /** Zone whose many-select collection this stages. */
-    zone: string;
-    /** Visual for a staged card. */
-    renderCard: (card: ZoneCardRenderItem) => ReactNode;
-    /** Custom empty-slot content. */
-    renderEmptySlot?: (index: number) => ReactNode;
-    /** Heading above the slots. */
-    label?: ReactNode;
-    cardSize?: "sm" | "md" | "lg";
-    ariaLabel?: string;
-    className?: string;
-}
-/**
- * Dreamboard-aware staging surface for a many-select card collection (e.g. the
- * cards you've chosen to pass). Projects the live draft into a fixed,
- * always-visible row of slots (empty placeholders until something is staged);
- * tapping a staged card routes an `activate` intent, which toggles it back out
- * of the collection so it returns to the hand. Adds no draft logic — the
- * presentational layout/theming lives in the SDK `StagingZone`.
- *
- * Renders nothing when the zone has no active many-select collection and
- * nothing staged, so authors can mount it unconditionally.
- */
-declare function HandStagingView({ zone, renderCard, renderEmptySlot, label, cardSize, ariaLabel, className, }: HandStagingViewProps): react_jsx_runtime.JSX.Element | null;
-/**
- * Convenience helper for builders of generated hand surfaces. Encodes a
- * typed target kind plus value into the opaque `targetId` that the SDK
- * presents to its drop pipeline. The runtime adapter resolves the kind to
- * the matching descriptor input at drop time, so authors never need to
- * know collector input names. Generated typed targets call this internally.
- */
-declare function dropTargetIdFor(kind: RuntimeDropTargetKind, value: string): string;
-/**
- * Determine whether any descriptor in the available list expects a board or
- * card destination input alongside a card target. Used by generated facades
- * to decide whether to mount a drag surface even before the author wires
- * dropTargets.
- */
-declare function descriptorsHaveDestinationInput(availableInteractions: readonly InteractionDescriptor[]): boolean;
-
-export { type AuthoredCardIntent, HandStagingView, type HandStagingViewProps, HandSurfaceView, type HandSurfaceViewProps, type RuntimeCardIntentResult, type RuntimeDropTarget, type UseCardIntentAdapterOptions, ZoneCardRenderItem, decodeAuthoredCardIntent, descriptorsHaveDestinationInput, dropTargetIdFor, useCardIntentAdapter };

package/dist/runtime/primitives.js

@@ -1,189 +0,0 @@
-import {
-  Board,
-  BoardEdgeTarget,
-  BoardHexGrid,
-  BoardHexView,
-  BoardRoot,
-  BoardSpaceTarget,
-  BoardSquareGrid,
-  BoardState,
-  BoardTarget,
-  BoardVertexTarget,
-  Dice,
-  DiceRoot,
-  DiceValues,
-  Game,
-  GameChrome,
-  GameRoot,
-  GameViewport,
-  HandStagingView,
-  HandSurfaceView,
-  Interaction,
-  InteractionCardInput,
-  InteractionDescription,
-  InteractionDialog,
-  InteractionFormPrimitive,
-  InteractionInput,
-  InteractionLabel,
-  InteractionRoot,
-  InteractionRoutes,
-  InteractionState,
-  InteractionSubmit,
-  InteractionSwitch,
-  InteractionTrigger,
-  InteractionUnavailableMessage,
-  InteractionValidationMessage,
-  Phase,
-  PhaseSwitch,
-  PlayerRoster,
-  PlayerRosterBadges,
-  PlayerRosterEmpty,
-  PlayerRosterList,
-  PlayerRosterName,
-  PlayerRosterRoot,
-  PlayerRosterScore,
-  Prompt,
-  PromptDialog,
-  PromptInbox,
-  PromptInboxEmpty,
-  PromptInboxItems,
-  PromptInboxRoot,
-  PromptMessage,
-  PromptOption,
-  PromptOptions,
-  PromptRoot,
-  PromptTitle,
-  UI,
-  UIRoot,
-  Zone,
-  ZoneCardAction,
-  ZoneCardAt,
-  ZoneItem,
-  ZoneList,
-  ZonePileCards,
-  ZonePileCount,
-  ZonePileDescription,
-  ZonePileLabel,
-  ZonePileRoot,
-  ZonePileTrigger,
-  ZoneRoot,
-  ZoneTopCard,
-  createZoneCardRenderItem,
-  decodeAuthoredCardIntent,
-  descriptorsHaveDestinationInput,
-  dropTargetIdFor,
-  normalizeDiceState,
-  useBoardPrimitiveContext,
-  useCardIntentAdapter,
-  useDicePrimitiveContext,
-  useGameActionError,
-  useInteractionPrimitiveContext,
-  useOptionalZonePrimitiveContext,
-  useResolvedCardTargetValue,
-  useZoneCardContext,
-  useZoneCards,
-  useZonePileContext,
-  useZonePrimitiveContext
-} from "../chunk-LR3ZTWQF.js";
-import "../chunk-T3ZKNUZ7.js";
-import "../chunk-GDPKTBUR.js";
-import "../chunk-3SKDNDPG.js";
-import "../chunk-32PFKDV7.js";
-import {
-  composeEventHandlers,
-  renderPrimitive
-} from "../chunk-VDXOF4FW.js";
-import "../chunk-WHR5UW3F.js";
-import "../chunk-VCDWP5VL.js";
-import "../chunk-PF7L4BMG.js";
-import "../chunk-PZ5AY32C.js";
-export {
-  Board,
-  BoardEdgeTarget,
-  BoardHexGrid,
-  BoardHexView,
-  BoardRoot,
-  BoardSpaceTarget,
-  BoardSquareGrid,
-  BoardState,
-  BoardTarget,
-  BoardVertexTarget,
-  Dice,
-  DiceRoot,
-  DiceValues,
-  Game,
-  GameChrome,
-  GameRoot,
-  GameViewport,
-  HandStagingView,
-  HandSurfaceView,
-  Interaction,
-  InteractionCardInput,
-  InteractionDescription,
-  InteractionDialog,
-  InteractionFormPrimitive,
-  InteractionInput,
-  InteractionLabel,
-  InteractionRoot,
-  InteractionRoutes,
-  InteractionState,
-  InteractionSubmit,
-  InteractionSwitch,
-  InteractionTrigger,
-  InteractionUnavailableMessage,
-  InteractionValidationMessage,
-  Phase,
-  PhaseSwitch,
-  PlayerRoster,
-  PlayerRosterBadges,
-  PlayerRosterEmpty,
-  PlayerRosterList,
-  PlayerRosterName,
-  PlayerRosterRoot,
-  PlayerRosterScore,
-  Prompt,
-  PromptDialog,
-  PromptInbox,
-  PromptInboxEmpty,
-  PromptInboxItems,
-  PromptInboxRoot,
-  PromptMessage,
-  PromptOption,
-  PromptOptions,
-  PromptRoot,
-  PromptTitle,
-  UI,
-  UIRoot,
-  Zone,
-  ZoneCardAction,
-  ZoneCardAt,
-  ZoneItem,
-  ZoneList,
-  ZonePileCards,
-  ZonePileCount,
-  ZonePileDescription,
-  ZonePileLabel,
-  ZonePileRoot,
-  ZonePileTrigger,
-  ZoneRoot,
-  ZoneTopCard,
-  composeEventHandlers,
-  createZoneCardRenderItem,
-  decodeAuthoredCardIntent,
-  descriptorsHaveDestinationInput,
-  dropTargetIdFor,
-  normalizeDiceState,
-  renderPrimitive,
-  useBoardPrimitiveContext,
-  useCardIntentAdapter,
-  useDicePrimitiveContext,
-  useGameActionError,
-  useInteractionPrimitiveContext,
-  useOptionalZonePrimitiveContext,
-  useResolvedCardTargetValue,
-  useZoneCardContext,
-  useZoneCards,
-  useZonePileContext,
-  useZonePrimitiveContext
-};
-//# sourceMappingURL=primitives.js.map

package/dist/runtime/primitives.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/runtime-api.d.ts

@@ -1,2 +0,0 @@
-export { d as PluginSessionState, R as RuntimeAPI, e as RuntimeDiagnosticEvent, f as RuntimeDiagnosticHandler, S as SubmissionError, V as ValidationResult, Z as ZoneHandlesSnapshot } from '../runtime-api-Bz5pwNU_.js';
-import './protocol-dYgafTYY.js';

package/dist/runtime/runtime-api.js

@@ -1 +0,0 @@
-//# sourceMappingURL=runtime-api.js.map

package/dist/runtime/runtime-api.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}