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

package/dist/types-BxXRINRF.d.ts

@@ -0,0 +1,118 @@
+import { Store } from '@tanstack/store';
+import { a1 as InteractionDescriptor$1, aw as ProjectedGameEvent, a$ as SimultaneousPhaseProjection, ay as ProjectedTile, bk as ViewCard, aY as SeatProjectionBundle, aP as RuntimeJson } from './extract-CwJWDrSD.js';
+
+type PlayerId = string;
+interface GameplayBasis {
+    readonly sessionId: string;
+    readonly version: number;
+    readonly actionSetVersion: string;
+    readonly perspectivePlayerId: PlayerId;
+}
+interface PluginPlayerSummary {
+    readonly playerId: PlayerId;
+    readonly displayName: string;
+    readonly color?: string;
+}
+interface PluginSessionDescriptor {
+    readonly sessionId: string;
+    /** Turn order is the order of this array. */
+    readonly players: readonly PluginPlayerSummary[];
+    /**
+     * Game image files by manifest path, such as `assets/cards/front.webp`.
+     * Sources replace card `frontImage` and `backImage` paths with object URLs.
+     */
+    readonly assets?: Readonly<Record<string, Blob>>;
+}
+
+type InteractionDescriptor<Interaction extends string = string> = Omit<InteractionDescriptor$1, "interactionKey"> & {
+    readonly interactionKey: Interaction;
+};
+type ActionInteractionDescriptor<Interaction extends string = string> = InteractionDescriptor<Interaction>;
+interface ZoneHandlesSnapshot<Interaction extends string = string> {
+    readonly tiles: readonly ProjectedTile[];
+    readonly cardIds: readonly string[];
+    /** Complete views of the cards the seat can see, by card id. */
+    readonly cardViewsById: ReadonlyProjection<Record<string, ViewCard>>;
+    /** Back image paths of the cards hidden from the seat, by positional id. */
+    readonly cardBacksById: Readonly<Record<string, string>>;
+    readonly playableByCardId: Readonly<Record<string, readonly InteractionDescriptor<Interaction>[]>>;
+}
+type ReadonlyProjection<Value> = Value extends string | number | boolean | null | undefined ? Value : Value extends readonly (infer Item)[] ? readonly ReadonlyProjection<Item>[] : Value extends object ? {
+    readonly [Key in keyof Value]: ReadonlyProjection<Value[Key]>;
+} : Value;
+type SimultaneousPhaseSnapshot = ReadonlyProjection<SimultaneousPhaseProjection>;
+
+interface PluginGameplayFrame<View = unknown, Phase extends string = string, Interaction extends string = string> {
+    /** Latest committed display-event batch admitted for this seat. Reading a snapshot does not replay notifications. */
+    readonly events: readonly ProjectedGameEvent[];
+    readonly basis: GameplayBasis;
+    readonly view: View | null;
+    readonly flow: {
+        readonly currentPhase: Phase | null;
+        readonly activePlayers: readonly PlayerId[];
+        readonly simultaneousPhase: SimultaneousPhaseSnapshot | null;
+    };
+    readonly availableInteractions: ReadonlyArray<InteractionDescriptor<Interaction>>;
+    readonly zones: Readonly<Record<string, Readonly<Record<string, ZoneHandlesSnapshot<Interaction>>>>>;
+}
+type ReducerSeatProjectionBundle = ReadonlyProjection<SeatProjectionBundle>;
+
+interface SourceSnapshot {
+    readonly me: string;
+    readonly players: readonly PluginPlayerSummary[];
+    readonly frame: Omit<PluginGameplayFrame, "basis">;
+    readonly version: number;
+}
+type SubmitResult = {
+    readonly accepted: true;
+} | {
+    readonly accepted: false;
+    readonly errorCode: string;
+    readonly message?: string;
+};
+interface SourceRequest {
+    readonly interactionId: string;
+    readonly operation: "submit" | "cancel";
+    readonly phase: "awaiting-result" | "awaiting-frame";
+}
+type SourceState = {
+    readonly connection: "connecting";
+    readonly snapshot: null;
+    readonly request: null;
+    readonly failure: null;
+} | {
+    readonly connection: "ready";
+    readonly snapshot: SourceSnapshot;
+    readonly request: SourceRequest | null;
+    readonly failure: null;
+} | {
+    readonly connection: "recovering";
+    readonly snapshot: SourceSnapshot | null;
+    readonly request: SourceRequest | null;
+    readonly failure: null;
+} | {
+    readonly connection: "failed";
+    readonly snapshot: SourceSnapshot | null;
+    readonly request: null;
+    /** Terminal diagnostic, retained locally. */
+    readonly failure: Readonly<Error>;
+} | {
+    readonly connection: "closed";
+    readonly snapshot: SourceSnapshot | null;
+    readonly request: null;
+    readonly failure: null;
+};
+interface GameSource {
+    readonly store: Pick<Store<SourceState>, "get" | "subscribe">;
+    dispose(): void;
+}
+interface CommandSource extends GameSource {
+    submit(interactionId: string, params: RuntimeJson): Promise<SubmitResult>;
+    cancel(interactionId: string): Promise<SubmitResult>;
+}
+/** Testing-owned sources can add local actions without widening hosted sources. */
+interface ApplySource<Action, Result = void> extends GameSource {
+    apply(action: Action): Result;
+}
+
+export type { ActionInteractionDescriptor as A, CommandSource as C, GameSource as G, InteractionDescriptor as I, PlayerId as P, ReducerSeatProjectionBundle as R, SimultaneousPhaseSnapshot as S, ZoneHandlesSnapshot as Z, ApplySource as a, GameplayBasis as b, PluginGameplayFrame as c, PluginPlayerSummary as d, PluginSessionDescriptor as e, SourceRequest as f, SourceSnapshot as g, SourceState as h, SubmitResult as i };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dreamboard-games/sdk",
-  "version": "0.5.0-alpha.2",
-  "description": "Dreamboard SDK package set metadata and public facade",
+  "version": "0.5.0-alpha.21",
+  "description": "Typed headless game instances, reducer authoring, React integration and testing",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,165 +11,54 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./package-set": {
-      "types": "./dist/package-set.d.ts",
-      "import": "./dist/package-set.js",
-      "default": "./dist/package-set.js"
-    },
-    "./plugin-runtime-contract": {
-      "types": "./dist/plugin-runtime-contract.d.ts",
-      "import": "./dist/plugin-runtime-contract.js",
-      "default": "./dist/plugin-runtime-contract.js"
-    },
-    "./reference-games": {
-      "types": "./dist/reference-games/index.d.ts",
-      "import": "./dist/reference-games/index.js",
-      "default": "./dist/reference-games/index.js"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js",
-      "default": "./dist/types.js"
-    },
     "./reducer": {
       "types": "./dist/reducer.d.ts",
       "import": "./dist/reducer.js",
       "default": "./dist/reducer.js"
     },
-    "./reducer/advanced": {
-      "types": "./dist/reducer/advanced.d.ts",
-      "import": "./dist/reducer/advanced.js",
-      "default": "./dist/reducer/advanced.js"
-    },
-    "./ui": {
-      "types": "./dist/ui.d.ts",
-      "import": "./dist/ui.js",
-      "default": "./dist/ui.js"
-    },
-    "./ui/components": {
-      "types": "./dist/ui/components.d.ts",
-      "import": "./dist/ui/components.js",
-      "default": "./dist/ui/components.js"
-    },
-    "./ui/defaults": {
-      "types": "./dist/ui/defaults.d.ts",
-      "import": "./dist/ui/defaults.js",
-      "default": "./dist/ui/defaults.js"
-    },
-    "./ui/player-state": {
-      "types": "./dist/ui/player-state.d.ts",
-      "import": "./dist/ui/player-state.js",
-      "default": "./dist/ui/player-state.js"
-    },
-    "./ui/plugin-styles.css": {
-      "default": "./dist/ui/plugin-styles.css"
-    },
-    "./runtime": {
-      "types": "./dist/runtime.d.ts",
-      "import": "./dist/runtime.js",
-      "default": "./dist/runtime.js"
-    },
-    "./runtime/primitives": {
-      "types": "./dist/runtime/primitives.d.ts",
-      "import": "./dist/runtime/primitives.js",
-      "default": "./dist/runtime/primitives.js"
-    },
-    "./runtime/workspace-contract": {
-      "types": "./dist/runtime/workspace-contract.d.ts",
-      "import": "./dist/runtime/workspace-contract.js",
-      "default": "./dist/runtime/workspace-contract.js"
-    },
-    "./runtime/runtime-api": {
-      "types": "./dist/runtime/runtime-api.d.ts",
-      "import": "./dist/runtime/runtime-api.js",
-      "default": "./dist/runtime/runtime-api.js"
-    },
-    "./reducer-contract": {
-      "types": "./dist/reducer-contract.d.ts",
-      "import": "./dist/reducer-contract.js",
-      "default": "./dist/reducer-contract.js"
-    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js",
       "default": "./dist/testing.js"
     },
-    "./testing-runtime": {
-      "types": "./dist/testing-runtime.d.ts",
-      "import": "./dist/testing-runtime.js",
-      "default": "./dist/testing-runtime.js"
-    },
-    "./testing-compiler": {
-      "types": "./dist/testing-compiler.d.ts",
-      "import": "./dist/testing-compiler.js",
-      "default": "./dist/testing-compiler.js"
-    },
-    "./browser-interaction": {
-      "types": "./dist/browser-interaction.d.ts",
-      "import": "./dist/browser-interaction.js",
-      "default": "./dist/browser-interaction.js"
-    },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    }
   },
   "files": [
     "LICENSE.md",
     "dist",
     "README.md",
-    "!.turbo/**",
     "!tsconfig.tsbuildinfo"
   ],
   "dependencies": {
-    "@radix-ui/react-accordion": "^1.2.14",
-    "@radix-ui/react-dialog": "^1.1.17",
-    "@radix-ui/react-label": "^2.1.10",
-    "@radix-ui/react-select": "^2.3.1",
-    "@radix-ui/react-slot": "^1.3.0",
-    "@radix-ui/react-tooltip": "^1.2.10",
-    "@noble/hashes": "^2.2.0",
-    "@use-gesture/react": "^10.3.1",
-    "clsx": "^2.1.1",
-    "esbuild": "^0.28.1",
-    "lucide-react": "^1.20.0",
-    "vaul": "^1.1.2",
-    "zustand": "^5.0.14"
+    "@noble/hashes": "2.4.0",
+    "@tanstack/store": "0.11.1",
+    "honeycomb-grid": "4.1.5"
   },
   "devDependencies": {
-    "@happy-dom/global-registrator": "^20.9.0",
-    "@playwright/test": "1.60.0",
-    "@storybook/addon-a11y": "^10.4.6",
-    "@storybook/addon-themes": "^10.4.6",
-    "@storybook/react-vite": "^10.4.6",
-    "@storybook/test-runner": "^0.24.4",
-    "@tailwindcss/cli": "^4.3.1",
-    "@tailwindcss/vite": "^4.3.1",
-    "@types/node": "^24.5.2",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "axe-playwright": "2.2.2",
-    "concurrently": "^9.1.0",
-    "eslint": "^9.39.1",
-    "framer-motion": "^12.40.0",
-    "http-server": "^14.1.1",
-    "playwright": "1.60.0",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "storybook": "^10.4.6",
-    "tailwindcss": "^4.3.1",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.3",
-    "vite": "8.0.16",
-    "vitest": "4.1.10",
-    "wait-on": "^8.0.1",
-    "zod": "4.4.3",
-    "@dreamboard-games/plugin-runtime-contract": "0.1.0",
-    "@dreamboard-games/sdk-types": "0.2.0",
-    "@dreamboard-games/reducer-contract": "0.5.0"
+    "@happy-dom/global-registrator": "20.14.5",
+    "@tanstack/react-store": "0.11.1",
+    "@types/node": "24.19.0",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "esbuild": "0.28.2",
+    "eslint": "10.11.0",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "5.0.2",
+    "zod": "4.6.5"
   },
   "peerDependencies": {
-    "framer-motion": "^11.0.0 || ^12.0.0",
+    "@tanstack/react-store": "0.11.1",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "zod": "^4.4.3"
+    "zod": "4.6.5"
   },
   "publishConfig": {
     "access": "public"
@@ -189,15 +78,21 @@
     "package-set"
   ],
   "license": "SEE LICENSE IN LICENSE.md",
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "@tanstack/react-store": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "build": "tsup && node ../../scripts/package.ts copy-declarations && mkdir -p dist/ui && tailwindcss -i src/ui/plugin-styles.css -o dist/ui/plugin-styles.css --minify",
-    "typecheck": "tsc --noEmit && tsc -p tsconfig.testing-contract.json",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.testing-contract.json && tsc -p tsconfig.runtime-contract.json",
     "lint": "eslint 'src/**/*.{ts,tsx}'",
-    "storybook": "storybook dev -p 6006 --host 127.0.0.1 --no-open",
-    "storybook:build": "storybook build -o storybook-static",
-    "storybook:test": "concurrently -k -s first -n storybook,test \"http-server storybook-static -p 6006 -s --silent\" \"wait-on tcp:6006 && test-storybook --url http://127.0.0.1:6006\"",
-    "storybook:test:visual": "playwright test --config .storybook/visual-runner.config.ts",
-    "storybook:test:visual:update": "playwright test --config .storybook/visual-runner.config.ts --update-snapshots",
     "test": "vitest run src"
   }
 }

package/dist/HandView-Bi2lxzQP.d.ts

@@ -1,79 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, CSSProperties } from 'react';
-import { ViewCard } from './types.js';
-import { P as InteractionVisualState, f as CardIntent } from './hex-board-view-aKkblDp6.js';
-
-/**
- * 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/reference/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/reference/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 HandInteractionPolicy as H, type HandLayoutKind as a, type HandLayoutPolicy as b, HandView as c, type HandViewProps as d };

package/dist/ResourceCounter-BFxJknqp.d.ts

@@ -1,98 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode, HTMLAttributes, ComponentType, ReactElement } from 'react';
-import { P as PrimitiveCommonProps } from './primitive-props-BNHDkgd7.js';
-
-type HandRole = "primary" | "auxiliary" | "task";
-interface MobileHandRegistration {
-    id: string;
-    zone: string;
-    label: string;
-    role: HandRole;
-    order?: number;
-    version: string;
-    count: number;
-    active: boolean;
-    autoOpen: boolean;
-    content: ReactNode;
-}
-declare function MobileHandTrayProvider({ children }: {
-    children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
-declare function useRegisterMobileHand(hand: MobileHandRegistration): void;
-declare function useOverlayInsets(): {
-    bottom: number;
-};
-declare function useRegisterBottomOverlayInset(id: string, height: number): void;
-
-type ResourceId = string;
-interface ResourceDisplayConfig<Resource extends string = ResourceId> {
-    type: Resource;
-    label: string;
-    icon: ReactNode | ComponentType<{
-        className?: string;
-        strokeWidth?: number;
-        "aria-hidden"?: boolean | "true" | "false";
-    }>;
-    iconColor?: string;
-    bgColor?: string;
-    textColor?: string;
-}
-interface ResourceCounterItemState<Resource extends string = ResourceId> {
-    type: Resource;
-    label: string;
-    icon: ResourceDisplayConfig<Resource>["icon"];
-    iconColor?: string;
-    bgColor?: string;
-    textColor?: string;
-    count: number;
-    isZero: boolean;
-    interactive: boolean;
-    select: () => void;
-    renderIcon: (props?: ResourceIconProps) => ReactNode;
-    dataAttributes: {
-        "data-resource-id": Resource;
-        "data-resource-count": number;
-        "data-resource-zero": boolean | undefined;
-        "data-interactive": boolean | undefined;
-    };
-}
-interface ResourceIconProps {
-    className?: string;
-    strokeWidth?: number;
-    "aria-hidden"?: boolean | "true" | "false";
-}
-type ResourceCounterRootProps<Resource extends string = ResourceId> = Omit<PrimitiveCommonProps, "children"> & Omit<HTMLAttributes<HTMLElement>, "children"> & {
-    resources: ReadonlyArray<ResourceDisplayConfig<Resource>>;
-    counts: Partial<Record<Resource, number>>;
-    zero?: "show" | "hide";
-    onResourceClick?: (resourceType: Resource) => void;
-    children: ReactNode;
-};
-type BoundResourceCounterRootProps<Resource extends string = ResourceId> = Omit<ResourceCounterRootProps<Resource>, "resources">;
-type ResourceCounterProps<Resource extends string = ResourceId> = ResourceCounterRootProps<Resource>;
-type ResourceCounterPartProps<Resource extends string = ResourceId> = Omit<PrimitiveCommonProps, "children"> & Omit<HTMLAttributes<HTMLElement>, "children"> & {
-    children?: ReactNode | ((resource: ResourceCounterItemState<Resource>) => ReactNode);
-};
-declare function ResourceCounterRoot<Resource extends string = ResourceId>({ resources, counts, zero, onResourceClick, children, "aria-label": ariaLabel, ...props }: ResourceCounterRootProps<Resource>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
-declare function ResourceCounterItem<Resource extends string = ResourceId>({ children, onClick, "aria-label": ariaLabel, ...props }: ResourceCounterPartProps<Resource>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
-declare function ResourceCounterIcon<Resource extends string = ResourceId>({ className, strokeWidth, "aria-hidden": ariaHidden, }: ResourceIconProps): ReactNode;
-declare function ResourceCounterCount<Resource extends string = ResourceId>({ children, ...props }: ResourceCounterPartProps<Resource>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
-declare function ResourceCounterLabel<Resource extends string = ResourceId>({ children, ...props }: ResourceCounterPartProps<Resource>): ReactElement<unknown, string | react.JSXElementConstructor<any>>;
-interface ResourceCounterComponents<Resource extends string = ResourceId> {
-    Root(props: BoundResourceCounterRootProps<Resource>): ReactElement;
-    Item(props: ResourceCounterPartProps<Resource>): ReactElement;
-    Icon(props: ResourceIconProps): ReactNode;
-    Count(props: ResourceCounterPartProps<Resource>): ReactElement;
-    Label(props: ResourceCounterPartProps<Resource>): ReactElement;
-}
-declare function createResourceCounter<Resource extends string>(resources: ReadonlyArray<ResourceDisplayConfig<Resource>>): ResourceCounterComponents<Resource>;
-declare const ResourceCounter: {
-    Root: typeof ResourceCounterRoot;
-    Item: typeof ResourceCounterItem;
-    Icon: typeof ResourceCounterIcon;
-    Count: typeof ResourceCounterCount;
-    Label: typeof ResourceCounterLabel;
-};
-
-export { type BoundResourceCounterRootProps as B, type HandRole as H, type MobileHandRegistration as M, ResourceCounter as R, MobileHandTrayProvider as a, type ResourceCounterComponents as b, ResourceCounterCount as c, ResourceCounterIcon as d, ResourceCounterItem as e, type ResourceCounterItemState as f, ResourceCounterLabel as g, type ResourceCounterPartProps as h, type ResourceCounterProps as i, ResourceCounterRoot as j, type ResourceCounterRootProps as k, type ResourceDisplayConfig as l, type ResourceIconProps as m, createResourceCounter as n, useRegisterBottomOverlayInset as o, useRegisterMobileHand as p, useOverlayInsets as u };

package/dist/ThemeProvider-CElaL2ik.d.ts

@@ -1,99 +0,0 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { CSSProperties, ReactNode } from 'react';
-import { ag as Theme, ai as ThemeOverride } from './hex-board-view-aKkblDp6.js';
-
-/**
- * The set of preset theme ids ships in `@dreamboard-games/sdk/ui`. Authors
- * may register additional ones by passing a fully-resolved {@link Theme}
- * instead of an id.
- */
-type ThemePresetId = "tabletop" | "arcade" | "studio";
-/**
- * Resolve a preset id (or a full theme) into a {@link Theme}.
- *
- * Used internally by {@link ThemeProvider}; exported so authors who
- * compose at the call site (e.g. for a side-by-side preview) can do
- * the same resolution without mounting a provider.
- */
-declare function resolveTheme(input: ThemePresetId | Theme | undefined): Theme;
-/** Look up a registered preset by id. Returns `undefined` if missing. */
-declare function getThemePreset(id: ThemePresetId): Theme | undefined;
-/**
- * Subset returned by {@link useTheme} — the resolved theme plus a
- * stable copy of its CSS-variable map so consumers can reuse it (for
- * example, to apply tokens to a portal that escapes the provider).
- */
-interface ThemeContextValue {
-    /** Fully resolved theme. */
-    readonly theme: Theme;
-    /** CSS-var map consumable as `style` on a wrapper. */
-    readonly cssVars: CSSProperties;
-}
-interface ThemeProviderProps {
-    /**
-     * Preset id, a full {@link Theme}, or omitted to use the `tabletop`
-     * default.
-     */
-    theme?: ThemePresetId | Theme;
-    /**
-     * Deep-partial overrides merged onto the resolved base theme. Use
-     * for one-off tweaks (e.g. swapping the player palette per game)
-     * without writing a full theme.
-     */
-    override?: ThemeOverride;
-    /**
-     * Render mode for reduced-motion enforcement.
-     *
-     * - `auto` (default): respect the user's OS-level preference via
-     *   `prefers-reduced-motion: reduce`.
-     * - `force`: force `motion.reducedMotion = "true"` regardless of the
-     *   OS preference (useful for screenshot CI).
-     * - `ignore`: never override motion (use only when the embedding
-     *   shell already decides motion behaviour).
-     */
-    reducedMotion?: "auto" | "force" | "ignore";
-    /**
-     * Where to mount the wrapper. `block` (default) renders a `div` and
-     * applies the CSS variables to it. `none` skips the wrapper entirely
-     * — only useful when the parent is already a Dreamboard provider and
-     * just needs to publish a different sub-tree (rare).
-     */
-    as?: "block" | "none";
-    /** Extra style merged after the CSS-var map. */
-    style?: CSSProperties;
-    /** Extra className for the wrapper. */
-    className?: string;
-    children: ReactNode;
-}
-/**
- * Mounts a Dreamboard theme. The provider:
- *
- * 1. Resolves the preset (or accepts a full theme).
- * 2. Applies any deep-partial `override`.
- * 3. Optionally clamps `motion.reducedMotion` to `"true"` based on the
- *    OS-level preference (or a forced override).
- * 4. Serialises the resolved theme into CSS variables on a wrapper
- *    element so descendants can read tokens via `useTheme()` *or* via
- *    `var(--db-...)` references in their own CSS / Tailwind.
- *
- * Defaults such as `<GameLayout>` mount this for you with the configured
- * theme; mount it manually only when you need a sub-tree to use a different
- * theme (e.g. a dark sheet over a light layout).
- */
-declare function ThemeProvider({ theme: themeInput, override, reducedMotion, as, style, className, children, }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * Read the active {@link Theme} from a {@link ThemeProvider} ancestor.
- *
- * Falls back to the `tabletop` preset (with no overrides) when called
- * outside a provider — components remain renderable in isolated tests
- * and Storybook/Cosmos fixtures without a wrapping shell.
- */
-declare function useTheme(): Theme;
-/**
- * Read the {@link CSSProperties} that publish the active theme as CSS
- * variables. Useful when porting a theme into a portal or drawer that
- * is rendered outside the provider's DOM subtree.
- */
-declare function useThemeCssVars(): CSSProperties;
-
-export { type ThemeContextValue as T, type ThemePresetId as a, ThemeProvider as b, type ThemeProviderProps as c, useThemeCssVars as d, getThemePreset as g, resolveTheme as r, useTheme as u };