@dreamboard-games/sdk 0.4.0-alpha.2 → 0.4.0-alpha.4

package/dist/{ui-contract-CY7cxsCC.d.ts → ui-contract-B4NjRlvC.d.ts}

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, HTMLAttributes, ButtonHTMLAttributes, InputHTMLAttributes, ReactElement } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { $ as Theme, a1 as ThemeOverride, L as InteractiveTargetState$1, A as AnyHexBoardInput, d as BoardSpaceIdOf, u as HexGridBoardProps, r as HexBoardView } from './hex-board-view-Kz9Q_zsv.js';
-import { a as ThemePresetId } from './ThemeProvider-B1sIoBlX.js';
+import { a3 as Theme, a5 as ThemeOverride, O as InteractiveTargetState$1, A as AnyHexBoardInput, d as BoardSpaceIdOf, w as HexGridBoardProps, t as HexBoardView } from './hex-board-view-BFlWDb9k.js';
+import { a as ThemePresetId } from './ThemeProvider-DRalAWzY.js';
 import { a as InteractionDescriptor, Z as ZoneHandlesSnapshot, I as InputDomain, b as InteractionInputDescriptor } from './runtime-api-BJharVaj.js';
 import { ViewCard } from './types.js';
 import { P as PrimitiveCommonProps } from './primitive-props-BNHDkgd7.js';

package/dist/ui.d.ts

@@ -1,11 +1,11 @@
-import { by as TrackSpace, bx as TrackPiece } from './components-BbWPnZCF.js';
-export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, B as ButtonSize, f as ButtonVariant, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, n as CardPositionProps, o as CardSize, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, az as HandLayout, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as Panel, aN as PanelActions, aO as PanelBody, aP as PanelDescription, aQ as PanelDescriptionProps, aR as PanelHeader, aS as PanelPartProps, aT as PanelRoot, aU as PanelRootProps, aV as PanelTitle, aW as PanelTitleProps, aX as PanelTone, aY as PhaseIndicator, aZ as PhaseIndicatorProps, a_ as PlayArea, a$ as PlayAreaProps, b0 as PlayerScore, b1 as PrimaryActionAttention, b2 as PrimaryActionButton, b3 as PrimaryActionButtonProps, b4 as PrimaryButton, b5 as PrimaryButtonProps, b6 as ResourceDefinition, b7 as Select, b8 as SelectContent, b9 as SelectItem, ba as SelectTrigger, bb as SlotDefinition, bc as SlotOccupant, bd as SlotSystem, be as SlotSystemProps, bf as SquareEdgePosition, bg as SquareGrid, bh as SquareGridBoardProps, bi as SquareGridProps, bj as SquareVertexPosition, bk as StagingZone, bl as StagingZoneProps, bm as ThemedButton, bn as ThemedButtonProps, bo as Toast, bp as ToastActions, bq as ToastActionsProps, br as ToastActionsValue, bs as ToastNotification, bt as ToastProvider, bu as ToastType, bv as TrackBoard, bw as TrackBoardProps, bz as UseHandLayoutOptions, bA as UseHandLayoutReturn, bB as ZoneDefinition, bC as ZoneHighlightType, bD as ZoneMap, bE as ZoneMapProps, bF as ZonePiece, bG as ZoneShape, bH as buttonStyle, bI as chipStyle, bJ as intentForVariant, bK as motionDuration, bL as playerColor, bM as surfaceStyle, bN as toAlgebraic, bO as toNumeric, bP as useCardDragSurface, bQ as useChromeSuppression } from './components-BbWPnZCF.js';
-import { $ as Theme } from './hex-board-view-Kz9Q_zsv.js';
-export { A as AnyHexBoardInput, a as AnySquareBoardInput, b as AuthoredHexBoardInput, c as AuthoredSquareBoardInput, B as BoardEdgeIdOf, d as BoardSpaceIdOf, e as BoardVertexIdOf, C as ColorRamp, f as ComponentTokens, D as DefaultHexEdge, g as DefaultHexEdgeProps, h as DefaultHexTile, i as DefaultHexTileProps, j as DefaultHexVertex, k as DefaultHexVertexProps, E as EdgePosition, l as Elevation, F as FoundationColor, G as GeneratedHexBoardInput, m as GeneratedHexSpaceStateLike, n as GeneratedSquareBoardInput, o as GeneratedSquareSpaceStateLike, p as GeneratedTiledEdgeStateLike, q as GeneratedTiledVertexStateLike, H as HexBoardInput, r as HexBoardView, s as HexBoardViewTile, t as HexGrid, u as HexGridBoardProps, v as HexGridProps, w as HexOrientation, x as HexTileGeometry, I as IntentColor, y as InteractiveHexEdge, z as InteractiveHexVertex, J as InteractiveTargetLayer, K as InteractiveTargetRenderState, M as Motion, N as NormalizedHexBoard, O as NormalizedHexEdgeOf, P as NormalizedHexTileOf, Q as NormalizedHexVertexOf, R as NormalizedSquareBoard, S as NormalizedSquareCellOf, T as NormalizedSquareEdgeOf, U as NormalizedSquarePieceOf, V as NormalizedSquareVertexOf, W as PlayerColor, X as Radius, Y as SemanticColor, Z as Space, _ as SquareBoardInput, a0 as ThemeMeta, a1 as ThemeOverride, a2 as Typography, a3 as createHexBoardView, a4 as hexUtils, a5 as mergeTheme, a6 as normalizeHexBoardInput, a7 as normalizeSquareBoardInput } from './hex-board-view-Kz9Q_zsv.js';
-export { T as ThemeContextValue, a as ThemePresetId, b as ThemeProvider, c as ThemeProviderProps, g as getThemePreset, r as resolveTheme, u as useTheme, d as useThemeCssVars } from './ThemeProvider-B1sIoBlX.js';
+import { by as TrackSpace, bx as TrackPiece } from './components-B7hFaEn_.js';
+export { A as ActionButton, a as ActionButtonProps, b as ActionGroup, c as ActionGroupProps, d as ActionPanel, e as ActionPanelProps, B as ButtonSize, f as ButtonVariant, C as CardDragSurface, g as CardDragSurfaceContextValue, h as CardDragSurfaceController, i as CardDragSurfaceProps, j as CardDropTargetView, k as CardDropTargetViewProps, l as CardFace, m as CardFaceProps, n as CardPositionProps, o as CardSize, p as ChromeSuppressionProvider, q as CostDisplay, r as CostDisplayProps, D as DefaultChessPiece, s as DefaultChessPieceProps, t as DefaultEmptySlot, u as DefaultEmptySlotProps, v as DefaultGridCell, w as DefaultGridCellProps, x as DefaultGridPiece, y as DefaultGridPieceProps, z as DefaultNetworkEdge, E as DefaultNetworkEdgeProps, F as DefaultNetworkNode, G as DefaultNetworkNodeProps, H as DefaultNetworkPiece, I as DefaultNetworkPieceProps, J as DefaultSlotItem, K as DefaultSlotItemProps, L as DefaultSlotOccupant, M as DefaultSlotOccupantProps, N as DefaultTrackConnection, O as DefaultTrackConnectionProps, P as DefaultTrackJump, Q as DefaultTrackJumpProps, R as DefaultTrackPiece, S as DefaultTrackPieceProps, T as DefaultTrackSpace, U as DefaultTrackSpaceProps, V as DefaultZone, W as DefaultZonePiece, X as DefaultZonePieceProps, Y as DefaultZonePieces, Z as DefaultZonePiecesProps, _ as DefaultZoneProps, $ as Dialog, a0 as DialogClose, a1 as DialogContent, a2 as DialogDescription, a3 as DialogFooter, a4 as DialogHeader, a5 as DialogOverlay, a6 as DialogPortal, a7 as DialogTitle, a8 as DialogTrigger, a9 as DiceRoller, aa as DiceRollerProps, ab as DragPhase, ac as Drawer, ad as DrawerClose, ae as DrawerContent, af as DrawerDescription, ag as DrawerFooter, ah as DrawerHeader, ai as DrawerOverlay, aj as DrawerPortal, ak as DrawerTitle, al as DrawerTrigger, am as ErrorBoundary, an as ErrorBoundaryProps, ao as GameEndDisplay, ap as GameEndDisplayProps, aq as GameSkeleton, ar as GameSkeletonProps, as as Hand, at as HandDock, au as HandDockMode, av as HandDockPlacement, aw as HandDockPresentation, ax as HandDockProps, ay as HandDockToggleContext, az as HandLayout, aA as HandProps, aB as Input, aC as InteractiveSquareEdge, aD as InteractiveSquareVertex, aE as Label, aF as MoreActions, aG as MoreActionsProps, aH as NetworkEdge, aI as NetworkGraph, aJ as NetworkGraphProps, aK as NetworkNode, aL as NetworkPiece, aM as Panel, aN as PanelActions, aO as PanelBody, aP as PanelDescription, aQ as PanelDescriptionProps, aR as PanelHeader, aS as PanelPartProps, aT as PanelRoot, aU as PanelRootProps, aV as PanelTitle, aW as PanelTitleProps, aX as PanelTone, aY as PhaseIndicator, aZ as PhaseIndicatorProps, a_ as PlayArea, a$ as PlayAreaProps, b0 as PlayerScore, b1 as PrimaryActionAttention, b2 as PrimaryActionButton, b3 as PrimaryActionButtonProps, b4 as PrimaryButton, b5 as PrimaryButtonProps, b6 as ResourceDefinition, b7 as Select, b8 as SelectContent, b9 as SelectItem, ba as SelectTrigger, bb as SlotDefinition, bc as SlotOccupant, bd as SlotSystem, be as SlotSystemProps, bf as SquareEdgePosition, bg as SquareGrid, bh as SquareGridBoardProps, bi as SquareGridProps, bj as SquareVertexPosition, bk as StagingZone, bl as StagingZoneProps, bm as ThemedButton, bn as ThemedButtonProps, bo as Toast, bp as ToastActions, bq as ToastActionsProps, br as ToastActionsValue, bs as ToastNotification, bt as ToastProvider, bu as ToastType, bv as TrackBoard, bw as TrackBoardProps, bz as UseHandLayoutOptions, bA as UseHandLayoutReturn, bB as ZoneDefinition, bC as ZoneHighlightType, bD as ZoneMap, bE as ZoneMapProps, bF as ZonePiece, bG as ZoneShape, bH as buttonStyle, bI as chipStyle, bJ as intentForVariant, bK as motionDuration, bL as playerColor, bM as surfaceStyle, bN as toAlgebraic, bO as toNumeric, bP as useCardDragSurface, bQ as useChromeSuppression } from './components-B7hFaEn_.js';
+import { a3 as Theme } from './hex-board-view-BFlWDb9k.js';
+export { A as AnyHexBoardInput, a as AnySquareBoardInput, b as AuthoredHexBoardInput, c as AuthoredSquareBoardInput, B as BoardEdgeIdOf, d as BoardSpaceIdOf, e as BoardVertexIdOf, C as CardDropTargetVisualState, f as CardIntent, g as ColorRamp, h as ComponentTokens, D as DefaultHexEdge, i as DefaultHexEdgeProps, j as DefaultHexTile, k as DefaultHexTileProps, l as DefaultHexVertex, m as DefaultHexVertexProps, E as EdgePosition, n as Elevation, F as FoundationColor, G as GeneratedHexBoardInput, o as GeneratedHexSpaceStateLike, p as GeneratedSquareBoardInput, q as GeneratedSquareSpaceStateLike, r as GeneratedTiledEdgeStateLike, s as GeneratedTiledVertexStateLike, H as HexBoardInput, t as HexBoardView, u as HexBoardViewTile, v as HexGrid, w as HexGridBoardProps, x as HexGridProps, y as HexOrientation, z as HexTileGeometry, I as IntentColor, J as InteractionVisualState, K as InteractiveHexEdge, L as InteractiveHexVertex, M as InteractiveTargetLayer, N as InteractiveTargetRenderState, P as Motion, Q as NormalizedHexBoard, R as NormalizedHexEdgeOf, S as NormalizedHexTileOf, T as NormalizedHexVertexOf, U as NormalizedSquareBoard, V as NormalizedSquareCellOf, W as NormalizedSquareEdgeOf, X as NormalizedSquarePieceOf, Y as NormalizedSquareVertexOf, Z as PlayerColor, _ as Radius, $ as SemanticColor, a0 as Space, a1 as SquareBoardInput, a2 as TargetIntent, a4 as ThemeMeta, a5 as ThemeOverride, a6 as Typography, a7 as createHexBoardView, a8 as dropTargetVisualStateDataAttributes, a9 as hexUtils, aa as mergeTheme, ab as normalizeHexBoardInput, ac as normalizeSquareBoardInput, ad as visualStateDataAttributes } from './hex-board-view-BFlWDb9k.js';
+export { T as ThemeContextValue, a as ThemePresetId, b as ThemeProvider, c as ThemeProviderProps, g as getThemePreset, r as resolveTheme, u as useTheme, d as useThemeCssVars } from './ThemeProvider-DRalAWzY.js';
 import { CSSProperties } from 'react';
-export { C as CardDropTargetVisualState, a as CardIntent, H as HandInteractionPolicy, b as HandLayoutKind, c as HandLayoutPolicy, d as HandView, e as HandViewProps, I as InteractionVisualState, T as TargetIntent, f as dropTargetVisualStateDataAttributes, v as visualStateDataAttributes } from './HandView-PYDmehVD.js';
-export { B as BoundResourceCounterRootProps, H as HandRole, M as MobileHandRegistration, a as MobileHandTrayProvider, R as ResourceCounter, b as ResourceCounterComponents, c as ResourceCounterCount, d as ResourceCounterIcon, e as ResourceCounterItem, f as ResourceCounterItemState, g as ResourceCounterLabel, h as ResourceCounterPartProps, i as ResourceCounterProps, j as ResourceCounterRoot, k as ResourceCounterRootProps, l as ResourceDisplayConfig, m as ResourceIconProps, n as createResourceCounter, u as useMobileHandTrayActive, o as useOverlayInsets, p as useRegisterBottomOverlayInset, q as useRegisterMobileHand } from './ResourceCounter-BuiNstXs.js';
+export { H as HandInteractionPolicy, a as HandLayoutKind, b as HandLayoutPolicy, c as HandView, d as HandViewProps } from './HandView-x8MhbhFl.js';
+export { B as BoundResourceCounterRootProps, H as HandRole, M as MobileHandRegistration, a as MobileHandTrayProvider, R as ResourceCounter, b as ResourceCounterComponents, c as ResourceCounterCount, d as ResourceCounterIcon, e as ResourceCounterItem, f as ResourceCounterItemState, g as ResourceCounterLabel, h as ResourceCounterPartProps, i as ResourceCounterProps, j as ResourceCounterRoot, k as ResourceCounterRootProps, l as ResourceDisplayConfig, m as ResourceIconProps, n as createResourceCounter, u as useOverlayInsets, o as useRegisterBottomOverlayInset, p as useRegisterMobileHand } from './ResourceCounter-BFxJknqp.js';
 export { B as BoardBaseId, a as BoardId, b as BoardKindStates, c as BoardRef, d as BoardStates, C as CardId, e as CardIdsByDeckId, f as CardProperties, D as DeckId, g as DiceStates, h as DieId, i as DieState, E as EdgeTypeId, G as GameState, H as HexBoardState, j as HexColor, k as HexEdgeState, l as HexTileState, m as HexVertexState, N as NetworkBoardState, n as NetworkEdgeState, o as NetworkNodeState, p as NetworkPieceState, P as PerPlayer, q as PerPlayerBoardRef, r as PieceId, s as PieceTypeId, t as Player, u as PlayerId, S as SharedBoardRef, v as SpaceId, w as SpaceTypeId, x as SquareBoardState, y as SquareCellState, z as SquareEdgeState, A as SquarePieceState, F as SquareVertexState, T as TrackBoardState, I as TrackPieceState, J as TrackSpaceState, V as VertexTypeId, K as hexColor, L as isHexColor, M as parseHexColor } from './player-state-Cqpyeql0.js';
 export { CardCollection, ViewCard, ViewSlotOccupant } from './types.js';
 import 'react/jsx-runtime';

package/dist/ui.js

@@ -5,7 +5,7 @@ import {
   parseHexColor,
   toTrackBoardData,
   useBoardTheme
-} from "./chunk-FWVV2X74.js";
+} from "./chunk-XZ667T4K.js";
 import {
   ActionButton,
   ActionGroup,
@@ -125,14 +125,13 @@ import {
   useCardDragSurface,
   useChromeSuppression,
   useIsMobile,
-  useMobileHandTrayActive,
   useOverlayInsets,
   useRegisterBottomOverlayInset,
   useRegisterMobileHand,
   useTheme,
   useThemeCssVars,
   visualStateDataAttributes
-} from "./chunk-45FI6XII.js";
+} from "./chunk-E3X552YM.js";
 import "./chunk-VDXOF4FW.js";
 import "./chunk-PZ5AY32C.js";
 export {
@@ -260,7 +259,6 @@ export {
   useCardDragSurface,
   useChromeSuppression,
   useIsMobile,
-  useMobileHandTrayActive,
   useOverlayInsets,
   useRegisterBottomOverlayInset,
   useRegisterMobileHand,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamboard-games/sdk",
-  "version": "0.4.0-alpha.2",
+  "version": "0.4.0-alpha.4",
   "description": "Dreamboard SDK package set metadata and public facade",
   "type": "module",
   "main": "./dist/index.js",

package/dist/HandView-PYDmehVD.d.ts

@@ -1,193 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, CSSProperties } from 'react';
-import { ViewCard } from './types.js';
-
-/**
- * Controlled visual state contract for `@dreamboard-games/sdk/ui` components.
- *
- * The SDK is Dreamboard-interaction unaware: components consume `display data`
- * and `controlled semantic states`. Runtime adapters compute these states from
- * descriptors/drafts and pass them in as plain props.
- */
-/**
- * Generic semantic state attached to a presentational component.
- *
- * Every flag is optional and renders as a stable `data-*` attribute on the
- * underlying element so that selectors, snapshot diffs and accessibility
- * announcements can react to state without inspecting class strings.
- */
-interface InteractionVisualState {
-    /** Caller may activate this surface right now. */
-    eligible?: boolean;
-    /**
-     * Eligible *and* a meaningful subset — i.e. at least one peer surface is not
-     * eligible. Use this (rather than `eligible`) to drive a "highlight the
-     * playable cards" affordance: when every card in a hand is a legal target
-     * (e.g. a pass where any card may be chosen, or a turn where you may play
-     * anything) the highlight carries no information, so `distinctlyEligible` is
-     * `false` for all of them and the ring naturally disappears. `eligible`
-     * keeps its literal meaning ("is a legal target") for dimming/logic.
-     */
-    distinctlyEligible?: boolean;
-    /** Currently chosen as part of a draft selection or focus state. */
-    selected?: boolean;
-    /** Surface is non-interactive and visually muted. */
-    disabled?: boolean;
-    /** Caller's draft is invalid — render an error tint without removing the surface. */
-    invalid?: boolean;
-    /** Action has been submitted; render a settled/locked feedback state. */
-    submitted?: boolean;
-    /** Surface is being previewed (long-press, hover hold) without commitment. */
-    previewing?: boolean;
-    /**
-     * Optional 0..1 progress reading for an in-flight UI intent (swipe, hold,
-     * etc.). Components may render this as a fill, scale or halo without owning
-     * the gesture pipeline themselves.
-     */
-    intentProgress?: number;
-}
-/**
- * Generic UI intent emitted by SDK components.
- *
- * Components do not know what `activate`/`drop` mean in Dreamboard terms —
- * that mapping belongs to a runtime adapter. They only emit when a generic
- * pointer/keyboard gesture completes.
- *
- * - `activate` is a single-target commit produced by a desktop click or a
- *   keyboard activation in `direct-activate` mode.
- * - `drop` is a card→target commit produced by mobile drag or keyboard drop
- *   in `drag-to-target` mode. The opaque `targetId` is registered by a
- *   `CardDropTargetView` and resolved against pointer geometry inside the
- *   `CardDragSurface`.
- * - `previewStart`/`previewEnd` bracket a long-press inspection that does
- *   not commit.
- */
-type CardIntent<CardId extends string = string, TargetId extends string = string> = {
-    type: "activate";
-    cardId: CardId;
-    source: "tap" | "keyboard";
-} | {
-    type: "previewStart";
-    cardId: CardId;
-} | {
-    type: "previewEnd";
-    cardId: CardId;
-} | {
-    type: "drop";
-    cardId: CardId;
-    targetId: TargetId;
-    source: "pointer" | "keyboard";
-};
-/**
- * Generic UI intent emitted for a board target (space/edge/vertex).
- */
-type TargetIntent<TargetId extends string = string> = {
-    type: "activate";
-    targetId: TargetId;
-    source: "tap" | "keyboard";
-} | {
-    type: "previewStart";
-    targetId: TargetId;
-} | {
-    type: "previewEnd";
-    targetId: TargetId;
-};
-/**
- * Controlled visual state for a card drop target rendered through
- * `CardDropTargetView`.
- *
- * `active` is `true` when any card is currently being dragged anywhere on
- * the surface (eligible target should advertise itself). `over` is `true`
- * only for the target that the lifted pointer would currently drop on.
- */
-interface CardDropTargetVisualState extends InteractionVisualState {
-    active?: boolean;
-    over?: boolean;
-}
-/**
- * Build the `data-*` attribute bag for an {@link InteractionVisualState} so
- * that components apply a single consistent attribute surface.
- *
- * `undefined` values are emitted (rather than `false`) so that CSS
- * `[data-…="true"]` selectors do not match by mistake.
- */
-declare function visualStateDataAttributes(state: InteractionVisualState | undefined): Readonly<Record<string, string | undefined>>;
-/**
- * Build the `data-*` attribute bag for a {@link CardDropTargetVisualState}.
- */
-declare function dropTargetVisualStateDataAttributes(state: CardDropTargetVisualState | undefined): Readonly<Record<string, string | undefined>>;
-
-/**
- * Pure layout math for the controlled `HandView`.
- *
- * The functions here are independent of React and DOM measurement so they can
- * be unit-tested directly. {@link computeFanLayout} matches the algorithm
- * documented in `docs/references/ui-sdk-mobile-hand-and-card-interactions.md`,
- * and {@link chooseHandLayoutMode} translates a measured container width and a
- * caller policy into the actual presentation mode the hand should render.
- */
-type HandPresentationMode = "fan" | "compressed-fan" | "strip" | "tray";
-
-/**
- * Deterministic pointer recognizer for the controlled hand view.
- *
- * The engine is independent from React: it consumes pointer events and a
- * caller-supplied callbacks bag, and produces semantic gesture events. It
- * owns no DOM, emits no `CardIntent`, and does not track the drag-lifecycle
- * `phase` — that responsibility lives in `CardDragSurface`. The engine only
- * recognizes `tap`, `previewStart`/`previewEnd`, `liftStart`/`liftMove`/
- * `liftEnd`/`liftCancel`, and a `horizontalBrowse` informational signal.
- *
- * The thresholds match
- * `docs/references/ui-sdk-mobile-hand-and-card-interactions.md`:
- *
- * | Threshold                 | Default     |
- * | ------------------------- | ----------- |
- * | Press preview delay       | `220ms`     |
- * | Movement slop             | `8px`       |
- * | Axis bias                 | `1.25`      |
- * | Drag lift distance        | `28px`      |
- *
- * Callers wire the engine's `handlePointerDown` / `handlePointerMove` /
- * `handlePointerUp` / `handlePointerCancel` to the matching DOM events on
- * each interactive card.
- */
-type HandInteractionPolicy = "direct-activate" | "drag-to-target";
-
-type HandLayoutKind = HandPresentationMode | "stack";
-interface HandLayoutPolicy {
-    desktop?: HandLayoutKind;
-    mobile?: HandLayoutKind;
-}
-interface HandViewProps<CardData extends ViewCard = ViewCard> {
-    cards: readonly CardData[];
-    /**
-     * Layout policy. Pass a single layout kind to use the same layout in every
-     * viewport, or pass `{ desktop, mobile }` for a measured-width decision.
-     * Defaults to `{ desktop: "fan", mobile: "tray" }`.
-     */
-    layout?: HandLayoutKind | HandLayoutPolicy;
-    /**
-     * Mobile interaction policy. Defaults to `direct-activate`. Use
-     * `drag-to-target` together with a surrounding `CardDragSurface` and one
-     * or more `CardDropTargetView` children.
-     */
-    mobileInteraction?: HandInteractionPolicy;
-    /** Returns the controlled visual state for a card. */
-    stateForCard?: (card: CardData, index: number) => InteractionVisualState | undefined;
-    /** Visual surface renderer. */
-    renderCard: (card: CardData, state: InteractionVisualState, index: number) => ReactNode;
-    /** Generic UI intent callback. */
-    onCardIntent?: (intent: CardIntent<CardData["id"] & string>) => void;
-    /** Card width hint for fan geometry. */
-    cardSize?: "sm" | "md" | "lg";
-    /** Slot for the empty state. Defaults to nothing rendered. */
-    renderEmpty?: () => ReactNode;
-    /** ARIA label for the hand region. */
-    "aria-label"?: string;
-    className?: string;
-    style?: CSSProperties;
-}
-declare function HandView<CardData extends ViewCard = ViewCard>({ cards, layout, mobileInteraction, stateForCard, renderCard, onCardIntent, cardSize, renderEmpty, "aria-label": ariaLabel, className, style, }: HandViewProps<CardData>): react_jsx_runtime.JSX.Element;
-
-export { type CardDropTargetVisualState as C, type HandInteractionPolicy as H, type InteractionVisualState as I, type TargetIntent as T, type CardIntent as a, type HandLayoutKind as b, type HandLayoutPolicy as c, HandView as d, type HandViewProps as e, dropTargetVisualStateDataAttributes as f, visualStateDataAttributes as v };