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

package/dist/runtime.d.ts

@@ -1,21 +1,21 @@
-import { b1 as UIContract$1, A as DreamboardUI$1, a$ as TypedGame$1 } from './ui-contract-B4NjRlvC.js';
-export { f as BoardHexGridProps, h as BoardHexViewProps, l as BoardSpaceTargetProps, I as GameMeState, M as GamePlayersState, N as GameRenderState, Q as GameTurnState, b3 as UIRootProps, bd as ZoneCardRenderItem, bh as ZoneListProps } from './ui-contract-B4NjRlvC.js';
-export { C as ClientParamSchemaMap, W as WorkspaceBoardSurface, a as WorkspaceBoardSurfaceDescriptor, b as WorkspaceBoardTargetInputSlot, c as WorkspaceCardCollectionSurface, d as WorkspaceCardCollectionSurfaceDescriptor, e as WorkspaceCardInputSlot, f as WorkspaceFormInputSlot, g as WorkspaceHandSurface, h as WorkspaceHandSurfaceDescriptor, i as WorkspaceInteractionFormDescriptor, j as WorkspaceInteractionFormsDescriptor, k as WorkspaceInteractionSlotComponent, l as WorkspacePileSurface, m as WorkspacePileSurfaceDescriptor, n as WorkspacePilesSurfaceDescriptor, o as WorkspaceSurfaceSpec, p as createWorkspaceUIContract } from './index-gjxQichK.js';
+import { b5 as UIContract$1, G as DreamboardUI$1, b3 as TypedGame$1 } from './ui-contract-Ue6SywvO.js';
+export { c as BoardGridInteractionFilter, g as BoardHexGridProps, i as BoardHexViewProps, m as BoardSpaceTargetProps, o as BoardSquareGridInteractionFilter, p as BoardSquareGridProps, M as GameMeState, Q as GamePlayersState, R as GameRenderState, U as GameTurnState, b7 as UIRootProps, bh as ZoneCardRenderItem, bl as ZoneListProps } from './ui-contract-Ue6SywvO.js';
+export { C as ClientParamSchemaMap, W as WorkspaceBoardSurface, a as WorkspaceBoardSurfaceDescriptor, b as WorkspaceBoardTargetInputSlot, c as WorkspaceCardCollectionSurface, d as WorkspaceCardCollectionSurfaceDescriptor, e as WorkspaceCardInputSlot, f as WorkspaceFormInputSlot, g as WorkspaceHandSurface, h as WorkspaceHandSurfaceDescriptor, i as WorkspaceInteractionFormDescriptor, j as WorkspaceInteractionFormsDescriptor, k as WorkspaceInteractionSlotComponent, l as WorkspacePileSurface, m as WorkspacePileSurfaceDescriptor, n as WorkspacePilesSurfaceDescriptor, o as WorkspaceSurfaceSpec, p as createWorkspaceUIContract } from './index-CFTjJIXd.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import react__default from 'react';
 import { c as RuntimeDiagnosticHandler } from './runtime-api-C6aWo9c0.js';
-import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-CYeN0wLK.js';
-export { R as RuntimeClock, c as RuntimeIdFactory } from './types-CYeN0wLK.js';
-export { a as InteractionDescriptor } from './runtime-api-BJharVaj.js';
+import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-aI4V9CWe.js';
+export { R as RuntimeClock, c as RuntimeIdFactory } from './types-aI4V9CWe.js';
+export { G as GameEvent, a as GameEventDetail, b as InteractionDescriptor, P as ProjectedGameEvent, S as SystemActionEvent } from './plugin-state-BRH3UiUp.js';
 export { b as ResourceCounterComponents } from './ResourceCounter-BFxJknqp.js';
-import './hex-board-view-BFlWDb9k.js';
+import './hex-board-view-aKkblDp6.js';
 import './player-state-Cqpyeql0.js';
 import './types.js';
-import './ThemeProvider-DRalAWzY.js';
+import './ThemeProvider-CElaL2ik.js';
 import './primitive-props-BNHDkgd7.js';
 import './attributes-DbvyMbXw.js';
 import './types-DJj5MJkl.js';
-import './protocol-BP193lva.js';
+import './protocol-835hEGne.js';
 
 interface PluginRuntimeProps {
     /** Child components to render after gameplay frame has started */
@@ -64,6 +64,7 @@ declare function createPluginRuntimeClient(options: PluginRuntimeClientOptions):
 interface PostMessagePluginTransportOptions {
     readonly targetWindow?: Window;
     readonly parentWindow?: Window;
+    readonly bundledSdkVersion?: string;
     readonly onInvalidMessage?: (reason: string, value: unknown) => void;
 }
 declare function createPostMessagePluginTransport(options?: PostMessagePluginTransportOptions): PluginTransport;

package/dist/runtime.js

@@ -1,35 +1,253 @@
 import {
   createWorkspaceUIContract
-} from "./chunk-TTISZQNI.js";
-import "./chunk-QOFFRHZR.js";
-import "./chunk-XZ667T4K.js";
+} from "./chunk-SOBNI363.js";
+import "./chunk-OV6JC2BM.js";
+import "./chunk-UC2UXAC6.js";
 import "./chunk-T3ZKNUZ7.js";
 import {
   GameSkeleton
-} from "./chunk-E3X552YM.js";
+} from "./chunk-2TRZSZGD.js";
 import "./chunk-VDXOF4FW.js";
 import {
   PluginRuntimeBoundary,
   createPluginRuntimeClient
-} from "./chunk-K5ZRJTZZ.js";
+} from "./chunk-PAPIAMYX.js";
 import {
   DREAMBOARD_PLUGIN_PROTOCOL,
   DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
   HostToPluginEnvelopeSchema
-} from "./chunk-O6M6PN4E.js";
-import "./chunk-WUIVY2KE.js";
+} from "./chunk-UUQNOGZV.js";
+import "./chunk-WHR5UW3F.js";
 import "./chunk-PF7L4BMG.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/runtime/hooks/usePluginRuntime.ts
 import { useState, useEffect, useRef } from "react";
 
+// package.json
+var package_default = {
+  name: "@dreamboard-games/sdk",
+  version: "0.4.0-alpha.6",
+  description: "Dreamboard SDK package set metadata and public facade",
+  type: "module",
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      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"
+    },
+    "./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"
+    },
+    "./codegen": {
+      types: "./dist/codegen.d.ts",
+      import: "./dist/codegen.js",
+      default: "./dist/codegen.js"
+    },
+    "./authoring": {
+      types: "./dist/authoring/index.d.ts",
+      import: "./dist/authoring/index.js",
+      default: "./dist/authoring/index.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"
+    },
+    "./browser-interaction": {
+      bun: "./src/browser-interaction.ts",
+      types: "./dist/browser-interaction.d.ts",
+      import: "./dist/browser-interaction.js",
+      default: "./dist/browser-interaction.js"
+    },
+    "./package.json": "./package.json"
+  },
+  files: [
+    "LICENSE.md",
+    "dist",
+    "README.md",
+    "REFERENCE.md",
+    "!.turbo/**",
+    "!tsconfig.tsbuildinfo"
+  ],
+  scripts: {
+    build: "pnpm --dir ../.. --filter @dreamboard-games/plugin-runtime-contract build && pnpm --dir ../.. authoring-metadata:generate && tsup && node ../../scripts/copy-sdk-private-dts.mjs && mkdir -p dist/ui && tailwindcss -i src/ui/plugin-styles.css -o dist/ui/plugin-styles.css --minify",
+    typecheck: "tsc --noEmit",
+    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: "bun test src"
+  },
+  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",
+    "@use-gesture/react": "^10.3.1",
+    clsx: "^2.1.1",
+    "lucide-react": "^1.20.0",
+    vaul: "^1.1.2",
+    zustand: "^5.0.14"
+  },
+  devDependencies: {
+    "@dreamboard-games/plugin-runtime-contract": "workspace:*",
+    "@dreamboard-games/reducer-contract": "workspace:*",
+    "@dreamboard-games/sdk-types": "workspace:*",
+    "@dreamboard-games/workspace-codegen": "workspace:*",
+    "@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.0",
+    "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.2",
+    vite: "8.0.16",
+    "wait-on": "^8.0.1",
+    zod: "4.4.3"
+  },
+  peerDependencies: {
+    "framer-motion": "^11.0.0 || ^12.0.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+    zod: "^4.4.3"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/dreamboard-games/dreamboard-sdk.git",
+    directory: "packages/sdk"
+  },
+  bugs: {
+    url: "https://github.com/dreamboard-games/dreamboard-sdk/issues"
+  },
+  homepage: "https://github.com/dreamboard-games/dreamboard-sdk#readme",
+  keywords: [
+    "dreamboard",
+    "sdk",
+    "package-set"
+  ],
+  license: "SEE LICENSE IN LICENSE.md"
+};
+
 // src/runtime/browser/post-message-transport.ts
 function createPostMessagePluginTransport(options = {}) {
   const targetWindow = options.targetWindow ?? window;
   const parentWindow = options.parentWindow ?? targetWindow.parent;
+  const bundledSdkVersion = options.bundledSdkVersion?.trim() || "unknown";
   let channel = null;
   let outboundSequence = 0;
+  let invalidEnvelopeReported = false;
+  const reportInvalidEnvelope = (reason, value) => {
+    options.onInvalidMessage?.(reason, value);
+    if (!channel || invalidEnvelopeReported) {
+      return;
+    }
+    invalidEnvelopeReported = true;
+    channel.hostWindow.postMessage(
+      {
+        protocol: DREAMBOARD_PLUGIN_PROTOCOL,
+        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
+        channelId: channel.channelId,
+        sequence: ++outboundSequence,
+        payload: {
+          type: "runtime.error",
+          code: "host-runtime-protocol-mismatch",
+          message: `Plugin runtime rejected a host message (${reason}). Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. The host and plugin bundle may have incompatible SDK/runtime contract versions.`
+        }
+      },
+      channel.hostOrigin
+    );
+  };
   return {
     start(onMessage) {
       const handleMessage = (event) => {
@@ -38,7 +256,7 @@ function createPostMessagePluginTransport(options = {}) {
         }
         const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);
         if (!parseResult.success) {
-          options.onInvalidMessage?.("invalid-envelope", event.data);
+          reportInvalidEnvelope("invalid-envelope", event.data);
           return;
         }
         const envelope = parseResult.data;
@@ -53,7 +271,7 @@ function createPostMessagePluginTransport(options = {}) {
           };
         }
         if (envelope.channelId !== channel.channelId || event.origin !== channel.hostOrigin || event.source !== channel.hostWindow) {
-          options.onInvalidMessage?.("channel-mismatch", event.data);
+          reportInvalidEnvelope("channel-mismatch", event.data);
           return;
         }
         onMessage(envelope);
@@ -83,26 +301,32 @@ function createPostMessagePluginTransport(options = {}) {
 }
 
 // src/runtime/hooks/usePluginRuntime.ts
+var BUNDLED_SDK_VERSION = typeof package_default.version === "string" ? package_default.version : "unknown";
 function hasProjectedView(runtime) {
   const frame = runtime.getFrame();
   return frame !== null && frame.view !== null && typeof frame.view !== "undefined";
 }
 function usePluginRuntime(options = {}) {
   const { timeout = 1e4, onDiagnostic } = options;
+  const [error, setError] = useState(null);
   const [runtime] = useState(
     () => createPluginRuntimeClient({
       transport: createPostMessagePluginTransport({
-        onInvalidMessage: (reason, value) => onDiagnostic?.({
-          type: "runtimeLog",
-          level: "warn",
-          message: `[PluginRuntime] Ignored invalid host message: ${reason}`,
-          details: [value]
-        })
+        bundledSdkVersion: BUNDLED_SDK_VERSION,
+        onInvalidMessage: (reason, value) => {
+          const message = `Plugin runtime rejected a host message (${reason}). Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. The host and plugin bundle may have incompatible SDK/runtime contract versions.`;
+          setError(message);
+          onDiagnostic?.({
+            type: "runtimeLog",
+            level: "warn",
+            message,
+            details: [value]
+          });
+        }
       })
     })
   );
   const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));
-  const [error, setError] = useState(null);
   const hasBeenReadyRef = useRef(false);
   if (isReady) hasBeenReadyRef.current = true;
   useEffect(() => {

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000, onDiagnostic } = options;\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        onInvalidMessage: (reason, value) =>\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message: `[PluginRuntime] Ignored invalid host message: ${reason}`,\n            details: [value],\n          }),\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\n  const [error, setError] = useState<string | null>(null);\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","import {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  let channel:\n    | {\n        readonly channelId: string;\n        readonly hostOrigin: string;\n        readonly hostWindow: Window;\n      }\n    | null = null;\n  let outboundSequence = 0;\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          options.onInvalidMessage?.(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          options.onInvalidMessage?.(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/hooks/usePluginRuntime.ts","../package.json","../src/runtime/browser/post-message-transport.ts","../src/runtime/components/PluginRuntime.tsx"],"sourcesContent":["import { useState, useEffect, useRef } from \"react\";\nimport packageJson from \"../../../package.json\";\nimport { createPostMessagePluginTransport } from \"../browser/post-message-transport.js\";\nimport { createPluginRuntimeClient } from \"../core/create-plugin-runtime-client.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\n\nconst BUNDLED_SDK_VERSION =\n  typeof packageJson.version === \"string\" ? packageJson.version : \"unknown\";\n\nexport interface UsePluginRuntimeOptions {\n  /**\n   * Timeout in milliseconds to wait for the first gameplay frame.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\nexport interface UsePluginRuntimeResult {\n  /** The transport-agnostic plugin runtime client. */\n  runtime: PluginRuntimeClient;\n  /** Whether the initial reducer-native snapshot is available and ready */\n  isReady: boolean;\n  /**\n   * True when the plugin was ready before but the current snapshot has no\n   * projected view — e.g. you've acted and are waiting on the rest of the\n   * table in a simultaneous phase. Lets the loading affordance read as a\n   * mid-game wait rather than a cold \"still loading\" stall.\n   */\n  waiting: boolean;\n  /** Error message if initialization failed */\n  error: string | null;\n}\n\nfunction hasProjectedView(runtime: PluginRuntimeClient): boolean {\n  const frame = runtime.getFrame();\n  return (\n    frame !== null && frame.view !== null && typeof frame.view !== \"undefined\"\n  );\n}\n\n/**\n * Hook that creates and manages a PluginRuntimeClient instance.\n *\n * This hook handles:\n * 1. Creating the runtime client\n * 2. Waiting for the first gameplay frame before setting isReady\n *\n * In the new architecture, the host only renders the plugin when a reducer-native\n * snapshot is available, so isReady should become true quickly after init.\n *\n * @example\n * ```tsx\n * function PluginRuntime({ children }: { children: React.ReactNode }) {\n *   const { runtime, isReady, error } = usePluginRuntime();\n *\n *   if (error) {\n *     return <div>Error: {error}</div>;\n *   }\n *\n *   if (!isReady) {\n *     return <GameSkeleton message=\"Waiting for game state...\" />;\n *   }\n *\n *   return <RuntimeProvider runtime={runtime}>{children}</RuntimeProvider>;\n * }\n * ```\n */\nexport function usePluginRuntime(\n  options: UsePluginRuntimeOptions = {},\n): UsePluginRuntimeResult {\n  const { timeout = 10000, onDiagnostic } = options;\n  const [error, setError] = useState<string | null>(null);\n\n  // Create runtime once and keep stable reference\n  const [runtime] = useState<PluginRuntimeClient>(() =>\n    createPluginRuntimeClient({\n      transport: createPostMessagePluginTransport({\n        bundledSdkVersion: BUNDLED_SDK_VERSION,\n        onInvalidMessage: (reason, value) => {\n          const message =\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${BUNDLED_SDK_VERSION}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\";\n          setError(message);\n          onDiagnostic?.({\n            type: \"runtimeLog\",\n            level: \"warn\",\n            message,\n            details: [value],\n          });\n        },\n      }),\n    }),\n  );\n  const [isReady, setIsReady] = useState(() => hasProjectedView(runtime));\n  // Latches once we've shown a view, so a later view-less snapshot reads as a\n  // mid-game wait rather than a fresh load. (A ref, so it never re-triggers a\n  // render on its own.)\n  const hasBeenReadyRef = useRef(false);\n  if (isReady) hasBeenReadyRef.current = true;\n\n  useEffect(() => {\n    void onDiagnostic;\n  }, [onDiagnostic]);\n\n  // Subscribe to gameplay frames and set isReady when the first projected view arrives.\n  useEffect(() => {\n    const markReadyFromFrame = () => {\n      if (!hasProjectedView(runtime)) {\n        return false;\n      }\n      setError(null);\n      setIsReady(true);\n      return true;\n    };\n\n    if (markReadyFromFrame()) {\n      return;\n    }\n\n    // Set up timeout\n    const timeoutId = setTimeout(() => {\n      if (!markReadyFromFrame()) {\n        setError(\n          `Timed out waiting for the initial projected view after ${timeout}ms. ` +\n            \"Ensure the host sends a gameplay frame with a seat view.\",\n        );\n      }\n    }, timeout);\n\n    // Fallback poll for dev/HMR flows where the runtime frame may already\n    // exist but the first subscribe callback is missed.\n    const pollId = setInterval(() => {\n      if (markReadyFromFrame()) {\n        clearInterval(pollId);\n        clearTimeout(timeoutId);\n      }\n    }, 100);\n\n    const unsubscribe = runtime.subscribeFrame(() => {\n      if (!hasProjectedView(runtime)) {\n        setIsReady(false);\n        return;\n      }\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      setError(null);\n      setIsReady(true);\n    });\n\n    return () => {\n      clearInterval(pollId);\n      clearTimeout(timeoutId);\n      unsubscribe?.();\n    };\n  }, [runtime, timeout]);\n\n  return {\n    runtime,\n    isReady,\n    waiting: hasBeenReadyRef.current && !isReady,\n    error,\n  };\n}\n","{\n  \"name\": \"@dreamboard-games/sdk\",\n  \"version\": \"0.4.0-alpha.6\",\n  \"description\": \"Dreamboard SDK package set metadata and public facade\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"default\": \"./dist/index.js\"\n    },\n    \"./package-set\": {\n      \"types\": \"./dist/package-set.d.ts\",\n      \"import\": \"./dist/package-set.js\",\n      \"default\": \"./dist/package-set.js\"\n    },\n    \"./types\": {\n      \"types\": \"./dist/types.d.ts\",\n      \"import\": \"./dist/types.js\",\n      \"default\": \"./dist/types.js\"\n    },\n    \"./reducer\": {\n      \"types\": \"./dist/reducer.d.ts\",\n      \"import\": \"./dist/reducer.js\",\n      \"default\": \"./dist/reducer.js\"\n    },\n    \"./reducer/advanced\": {\n      \"types\": \"./dist/reducer/advanced.d.ts\",\n      \"import\": \"./dist/reducer/advanced.js\",\n      \"default\": \"./dist/reducer/advanced.js\"\n    },\n    \"./ui\": {\n      \"types\": \"./dist/ui.d.ts\",\n      \"import\": \"./dist/ui.js\",\n      \"default\": \"./dist/ui.js\"\n    },\n    \"./ui/components\": {\n      \"types\": \"./dist/ui/components.d.ts\",\n      \"import\": \"./dist/ui/components.js\",\n      \"default\": \"./dist/ui/components.js\"\n    },\n    \"./ui/defaults\": {\n      \"types\": \"./dist/ui/defaults.d.ts\",\n      \"import\": \"./dist/ui/defaults.js\",\n      \"default\": \"./dist/ui/defaults.js\"\n    },\n    \"./ui/player-state\": {\n      \"types\": \"./dist/ui/player-state.d.ts\",\n      \"import\": \"./dist/ui/player-state.js\",\n      \"default\": \"./dist/ui/player-state.js\"\n    },\n    \"./ui/plugin-styles.css\": {\n      \"default\": \"./dist/ui/plugin-styles.css\"\n    },\n    \"./runtime\": {\n      \"types\": \"./dist/runtime.d.ts\",\n      \"import\": \"./dist/runtime.js\",\n      \"default\": \"./dist/runtime.js\"\n    },\n    \"./runtime/primitives\": {\n      \"types\": \"./dist/runtime/primitives.d.ts\",\n      \"import\": \"./dist/runtime/primitives.js\",\n      \"default\": \"./dist/runtime/primitives.js\"\n    },\n    \"./runtime/workspace-contract\": {\n      \"types\": \"./dist/runtime/workspace-contract.d.ts\",\n      \"import\": \"./dist/runtime/workspace-contract.js\",\n      \"default\": \"./dist/runtime/workspace-contract.js\"\n    },\n    \"./runtime/runtime-api\": {\n      \"types\": \"./dist/runtime/runtime-api.d.ts\",\n      \"import\": \"./dist/runtime/runtime-api.js\",\n      \"default\": \"./dist/runtime/runtime-api.js\"\n    },\n    \"./codegen\": {\n      \"types\": \"./dist/codegen.d.ts\",\n      \"import\": \"./dist/codegen.js\",\n      \"default\": \"./dist/codegen.js\"\n    },\n    \"./authoring\": {\n      \"types\": \"./dist/authoring/index.d.ts\",\n      \"import\": \"./dist/authoring/index.js\",\n      \"default\": \"./dist/authoring/index.js\"\n    },\n    \"./reducer-contract\": {\n      \"types\": \"./dist/reducer-contract.d.ts\",\n      \"import\": \"./dist/reducer-contract.js\",\n      \"default\": \"./dist/reducer-contract.js\"\n    },\n    \"./testing\": {\n      \"types\": \"./dist/testing.d.ts\",\n      \"import\": \"./dist/testing.js\",\n      \"default\": \"./dist/testing.js\"\n    },\n    \"./browser-interaction\": {\n      \"bun\": \"./src/browser-interaction.ts\",\n      \"types\": \"./dist/browser-interaction.d.ts\",\n      \"import\": \"./dist/browser-interaction.js\",\n      \"default\": \"./dist/browser-interaction.js\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"LICENSE.md\",\n    \"dist\",\n    \"README.md\",\n    \"REFERENCE.md\",\n    \"!.turbo/**\",\n    \"!tsconfig.tsbuildinfo\"\n  ],\n  \"scripts\": {\n    \"build\": \"pnpm --dir ../.. --filter @dreamboard-games/plugin-runtime-contract build && pnpm --dir ../.. authoring-metadata:generate && tsup && node ../../scripts/copy-sdk-private-dts.mjs && mkdir -p dist/ui && tailwindcss -i src/ui/plugin-styles.css -o dist/ui/plugin-styles.css --minify\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"eslint 'src/**/*.{ts,tsx}'\",\n    \"storybook\": \"storybook dev -p 6006 --host 127.0.0.1 --no-open\",\n    \"storybook:build\": \"storybook build -o storybook-static\",\n    \"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\\\"\",\n    \"storybook:test:visual\": \"playwright test --config .storybook/visual-runner.config.ts\",\n    \"storybook:test:visual:update\": \"playwright test --config .storybook/visual-runner.config.ts --update-snapshots\",\n    \"test\": \"bun test src\"\n  },\n  \"dependencies\": {\n    \"@radix-ui/react-accordion\": \"^1.2.14\",\n    \"@radix-ui/react-dialog\": \"^1.1.17\",\n    \"@radix-ui/react-label\": \"^2.1.10\",\n    \"@radix-ui/react-select\": \"^2.3.1\",\n    \"@radix-ui/react-slot\": \"^1.3.0\",\n    \"@radix-ui/react-tooltip\": \"^1.2.10\",\n    \"@use-gesture/react\": \"^10.3.1\",\n    \"clsx\": \"^2.1.1\",\n    \"lucide-react\": \"^1.20.0\",\n    \"vaul\": \"^1.1.2\",\n    \"zustand\": \"^5.0.14\"\n  },\n  \"devDependencies\": {\n    \"@dreamboard-games/plugin-runtime-contract\": \"workspace:*\",\n    \"@dreamboard-games/reducer-contract\": \"workspace:*\",\n    \"@dreamboard-games/sdk-types\": \"workspace:*\",\n    \"@dreamboard-games/workspace-codegen\": \"workspace:*\",\n    \"@happy-dom/global-registrator\": \"^20.9.0\",\n    \"@playwright/test\": \"1.60.0\",\n    \"@storybook/addon-a11y\": \"^10.4.6\",\n    \"@storybook/addon-themes\": \"^10.4.6\",\n    \"@storybook/react-vite\": \"^10.4.6\",\n    \"@storybook/test-runner\": \"^0.24.4\",\n    \"@tailwindcss/cli\": \"^4.3.1\",\n    \"@tailwindcss/vite\": \"^4.3.1\",\n    \"@types/node\": \"^24.5.2\",\n    \"@types/react\": \"^19.0.0\",\n    \"@types/react-dom\": \"^19.0.0\",\n    \"axe-playwright\": \"2.2.2\",\n    \"concurrently\": \"^9.1.0\",\n    \"eslint\": \"^9.39.0\",\n    \"framer-motion\": \"^12.40.0\",\n    \"http-server\": \"^14.1.1\",\n    \"playwright\": \"1.60.0\",\n    \"react\": \"^19.2.0\",\n    \"react-dom\": \"^19.2.0\",\n    \"storybook\": \"^10.4.6\",\n    \"tailwindcss\": \"^4.3.1\",\n    \"tsup\": \"^8.5.0\",\n    \"typescript\": \"^5.9.2\",\n    \"vite\": \"8.0.16\",\n    \"wait-on\": \"^8.0.1\",\n    \"zod\": \"4.4.3\"\n  },\n  \"peerDependencies\": {\n    \"framer-motion\": \"^11.0.0 || ^12.0.0\",\n    \"react\": \"^19.0.0\",\n    \"react-dom\": \"^19.0.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/dreamboard-games/dreamboard-sdk.git\",\n    \"directory\": \"packages/sdk\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/dreamboard-games/dreamboard-sdk/issues\"\n  },\n  \"homepage\": \"https://github.com/dreamboard-games/dreamboard-sdk#readme\",\n  \"keywords\": [\n    \"dreamboard\",\n    \"sdk\",\n    \"package-set\"\n  ],\n  \"license\": \"SEE LICENSE IN LICENSE.md\"\n}\n","import {\n  DREAMBOARD_PLUGIN_PROTOCOL,\n  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n  HostToPluginEnvelopeSchema,\n  type HostToPluginEnvelope,\n  type PluginToHostPayload,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type { PluginTransport } from \"../core/types.js\";\n\nexport interface PostMessagePluginTransportOptions {\n  readonly targetWindow?: Window;\n  readonly parentWindow?: Window;\n  readonly bundledSdkVersion?: string;\n  readonly onInvalidMessage?: (reason: string, value: unknown) => void;\n}\n\nexport function createPostMessagePluginTransport(\n  options: PostMessagePluginTransportOptions = {},\n): PluginTransport {\n  const targetWindow = options.targetWindow ?? window;\n  const parentWindow = options.parentWindow ?? targetWindow.parent;\n  const bundledSdkVersion = options.bundledSdkVersion?.trim() || \"unknown\";\n  let channel: {\n    readonly channelId: string;\n    readonly hostOrigin: string;\n    readonly hostWindow: Window;\n  } | null = null;\n  let outboundSequence = 0;\n  let invalidEnvelopeReported = false;\n\n  const reportInvalidEnvelope = (reason: string, value: unknown) => {\n    options.onInvalidMessage?.(reason, value);\n\n    if (!channel || invalidEnvelopeReported) {\n      return;\n    }\n\n    invalidEnvelopeReported = true;\n    channel.hostWindow.postMessage(\n      {\n        protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n        version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n        channelId: channel.channelId,\n        sequence: ++outboundSequence,\n        payload: {\n          type: \"runtime.error\",\n          code: \"host-runtime-protocol-mismatch\",\n          message:\n            `Plugin runtime rejected a host message (${reason}). ` +\n            `Bundled @dreamboard-games/sdk version: ${bundledSdkVersion}. ` +\n            \"The host and plugin bundle may have incompatible SDK/runtime contract versions.\",\n        },\n      },\n      channel.hostOrigin,\n    );\n  };\n\n  return {\n    start(onMessage) {\n      const handleMessage = (event: MessageEvent) => {\n        if (event.source !== parentWindow) {\n          return;\n        }\n        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);\n        if (!parseResult.success) {\n          reportInvalidEnvelope(\"invalid-envelope\", event.data);\n          return;\n        }\n        const envelope = parseResult.data;\n        if (!channel) {\n          if (envelope.payload.type !== \"runtime.init\") {\n            return;\n          }\n          channel = {\n            channelId: envelope.channelId,\n            hostOrigin: event.origin,\n            hostWindow: event.source as Window,\n          };\n        }\n        if (\n          envelope.channelId !== channel.channelId ||\n          event.origin !== channel.hostOrigin ||\n          event.source !== channel.hostWindow\n        ) {\n          reportInvalidEnvelope(\"channel-mismatch\", event.data);\n          return;\n        }\n        onMessage(envelope as HostToPluginEnvelope);\n      };\n\n      targetWindow.addEventListener(\"message\", handleMessage);\n      return () => {\n        targetWindow.removeEventListener(\"message\", handleMessage);\n        channel = null;\n      };\n    },\n    send(payload: PluginToHostPayload) {\n      if (!channel) {\n        throw new Error(\"Plugin transport is not initialized.\");\n      }\n      channel.hostWindow.postMessage(\n        {\n          protocol: DREAMBOARD_PLUGIN_PROTOCOL,\n          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,\n          channelId: channel.channelId,\n          sequence: ++outboundSequence,\n          payload,\n        },\n        channel.hostOrigin,\n      );\n    },\n  };\n}\n","import React from \"react\";\nimport { usePluginRuntime } from \"../hooks/usePluginRuntime.js\";\nimport { GameSkeleton } from \"../../ui.js\";\nimport type { RuntimeDiagnosticHandler } from \"../types/runtime-api.js\";\nimport { PluginRuntimeBoundary } from \"./PluginRuntimeBoundary.js\";\n\nexport interface PluginRuntimeProps {\n  /** Child components to render after gameplay frame has started */\n  children: React.ReactNode;\n  /**\n   * Timeout in milliseconds to wait for the first gameplay-frame snapshot.\n   * @default 10000 (10 seconds)\n   */\n  timeout?: number;\n  /** Custom loading component to show while waiting for gameplay frame */\n  loadingComponent?: React.ReactNode;\n  /** Custom error component to show when initialization fails */\n  errorComponent?: (error: string) => React.ReactNode;\n  onDiagnostic?: RuntimeDiagnosticHandler;\n}\n\n/**\n * PluginRuntime provides the RuntimeContext for plugin components.\n *\n * This component:\n * - Creates a transport-backed runtime client\n * - Waits for the first projected gameplay frame before rendering children\n * - Provides runtime commands plus session/frame state to all child components\n *\n * @example\n * ```tsx\n * // In your plugin's index.tsx\n * import { PluginRuntime } from \"./components/dreamboard\";\n * import App from './App';\n *\n * ReactDOM.createRoot(document.getElementById('root')!).render(\n *   <PluginRuntime>\n *     <App />\n *   </PluginRuntime>\n * );\n * ```\n */\nexport function PluginRuntime({\n  children,\n  timeout = 10000,\n  loadingComponent,\n  errorComponent,\n  onDiagnostic,\n}: PluginRuntimeProps) {\n  const { runtime, isReady, waiting, error } = usePluginRuntime({\n    timeout,\n    onDiagnostic,\n  });\n\n  if (error) {\n    if (errorComponent) {\n      return <>{errorComponent(error)}</>;\n    }\n    return (\n      <div className=\"flex h-full w-full items-center justify-center bg-gray-50\">\n        <div className=\"text-center p-6\">\n          <p className=\"text-red-600 font-medium mb-2\">Failed to load game</p>\n          <p className=\"text-gray-600 text-sm\">{error}</p>\n        </div>\n      </div>\n    );\n  }\n\n  if (!isReady) {\n    if (loadingComponent) {\n      return <>{loadingComponent}</>;\n    }\n    // Once the game has rendered, a view-less snapshot is a mid-game wait (you\n    // acted and are waiting on the table), not a cold load — say so rather than\n    // reading as a stalled \"Waiting for game state\".\n    return (\n      <GameSkeleton\n        message={\n          waiting\n            ? \"Waiting for the other players…\"\n            : \"Waiting for game state...\"\n        }\n      />\n    );\n  }\n\n  return (\n    <PluginRuntimeBoundary runtime={runtime}>{children}</PluginRuntimeBoundary>\n  );\n}\n"],"mappings":"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","names":[]}