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

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

@@ -1,296 +0,0 @@
-import { w } from './protocol-dYgafTYY.js';
-
-/** Player identity received through the host protocol. */
-type PlayerId = w["playerId"];
-
-/** Choice option surfaced on a prompt-kind interaction's structured context. */
-interface InteractionContextOption {
-    id: string;
-    label?: string;
-}
-/** Structured context attached to a prompt-kind InteractionDescriptor. */
-interface InteractionContext {
-    /** Addressed player id. */
-    to: string;
-    title?: string;
-    /** Authored prompt payload. Shape is defined by the game's prompt schema. */
-    payload?: Record<string, unknown>;
-    /** Selectable options for choice-kind prompts. */
-    options?: readonly InteractionContextOption[];
-}
-type InteractionCommitPolicy = {
-    mode: "manual";
-} | {
-    mode: "autoWhenReady";
-};
-type InputSelection = {
-    mode: "single";
-} | {
-    mode: "many";
-    min: number;
-    max?: number;
-    distinct?: boolean;
-};
-type InputDomain = CardTargetDomain | BoardTargetDomain | ResourceMapDomain | BoundedNumberDomain | ChoiceDomain | ChoiceListDomain;
-type InputDomainResolver = EagerInputDomainDependencies | LazyInputDomainDependencies;
-interface EagerInputDomainDependencies {
-    mode: "eager";
-    dependentCases: readonly InputDomainDependencyCase[];
-}
-interface LazyInputDomainDependencies {
-    mode: "lazy";
-    dependsOn: readonly string[];
-    resolver: {
-        interactionKey?: string;
-        inputKey: string;
-    };
-}
-interface ResolvedCardTargetDomain {
-    type: "cardTarget";
-    projection: "resolved";
-    zoneId?: string;
-    zoneIds?: readonly string[];
-    eligibleTargets: readonly string[];
-    selection?: InputSelection;
-    dependencies?: InputDomainResolver;
-}
-interface LazyCardTargetDomain {
-    type: "cardTarget";
-    projection: "lazy";
-    zoneId?: string;
-    zoneIds?: readonly string[];
-    selection?: InputSelection;
-    dependencies: LazyInputDomainDependencies;
-}
-type CardTargetDomain = ResolvedCardTargetDomain | LazyCardTargetDomain;
-interface ResolvedBoardTargetDomain {
-    type: "boardTarget";
-    projection: "resolved";
-    targetKind: string;
-    boardId?: string;
-    eligibleTargets: readonly string[];
-    selection?: InputSelection;
-    dependencies?: InputDomainResolver;
-}
-interface LazyBoardTargetDomain {
-    type: "boardTarget";
-    projection: "lazy";
-    targetKind: string;
-    boardId?: string;
-    selection?: InputSelection;
-    dependencies: LazyInputDomainDependencies;
-}
-type BoardTargetDomain = ResolvedBoardTargetDomain | LazyBoardTargetDomain;
-interface ResourceMapDomain {
-    type: "resourceMap";
-    resources?: ReadonlyArray<{
-        resourceId: string;
-        label?: string;
-        icon?: string;
-        min: number;
-        max: number;
-    }>;
-    dependencies?: InputDomainResolver;
-}
-interface BoundedNumberDomain {
-    type: "boundedNumber";
-    min?: number;
-    max?: number;
-    step?: number;
-    dependencies?: InputDomainResolver;
-}
-interface ChoiceDomain {
-    type: "choice";
-    choices?: readonly InteractionChoiceOption[];
-    selection?: InputSelection;
-    dependencies?: InputDomainResolver;
-}
-interface ChoiceListDomain {
-    type: "choiceList";
-    choices?: readonly InteractionChoiceOption[];
-    min?: number;
-    max?: number;
-    selection?: InputSelection;
-    dependencies?: InputDomainResolver;
-}
-interface InputDomainDependencyCase {
-    when: Readonly<Record<string, string>>;
-    domain: InputDomain;
-}
-interface InteractionChoiceOption {
-    value: string | null;
-    label: string;
-    icon?: string;
-    badge?: string;
-    description?: string;
-    disabled?: boolean;
-    disabledReason?: string;
-}
-interface InteractionInputDescriptor {
-    key: string;
-    kind: string;
-    domain: InputDomain;
-    defaultValue?: unknown;
-}
-interface InteractionDiagnosticReason {
-    ruleId: string;
-    errorCode: string;
-}
-type InteractionAvailability = {
-    status: "available";
-} | {
-    status: "notYourTurn";
-    reason: string;
-} | {
-    status: "insufficientResources";
-    reason: string;
-    missingResources: Readonly<Record<string, number>>;
-} | {
-    status: "blocked";
-    reason: string;
-    code?: string;
-};
-interface InteractionDescriptorBase<Key extends string = string> {
-    phaseName: string;
-    interactionKey: Key;
-    interactionId: string;
-    label: string;
-    help?: string;
-    /** Draft commit policy. Always materialized by the trusted reducer bundle. */
-    commit: InteractionCommitPolicy;
-    /** Canonical descriptor digest used by browser replay/protocol tooling when projected by the host. */
-    descriptorDigest?: string;
-    /** Explicit authoring/runtime actor seat used by browser replay draft digests. */
-    actorSeat?: number;
-    /** Canonical draft digest used by browser replay/protocol tooling when projected by the host. */
-    draftDigest?: string;
-    /** Source zone id for zone-scoped interactions (e.g., cardInput). */
-    zoneId?: string;
-    /** Source zone ids for zone-scoped interactions that span multiple zones. */
-    zoneIds?: readonly string[];
-    /** Ordered input descriptors. This is the canonical source for input keys, collector kind, and valid-value domains. */
-    inputs: readonly InteractionInputDescriptor[];
-    /** Resolved cost map keyed by resource id (if interaction declares one). */
-    cost?: Record<string, unknown>;
-    /** Snapshot of seat's currently available resources keyed by resource id. */
-    currentResources?: Record<string, unknown>;
-    /** Authoritative availability state for this descriptor. */
-    availability: InteractionAvailability;
-    /** Optional verbose diagnostics for dev tooling; omitted from production projections. */
-    reasons?: readonly InteractionDiagnosticReason[];
-}
-type ActionInteractionDescriptor<Key extends string = string> = InteractionDescriptorBase<Key> & {
-    kind: "action";
-};
-type PromptInteractionDescriptor<Key extends string = string> = InteractionDescriptorBase<Key> & {
-    kind: "prompt";
-    /** Structured prompt context for prompt-kind interactions. */
-    context: InteractionContext;
-};
-type InteractionDescriptor<Key extends string = string> = ActionInteractionDescriptor<Key> | PromptInteractionDescriptor<Key>;
-/**
- * Per-player view of a single zone. Mirrors the ZoneHandles wire shape from
- * the trusted bundle's resolveZoneHandles; `cardViewsById` is JSON-serialized
- * `ViewCard` and `playableByCardId` lists the interactions that are playable
- * on each card (eligibility already filtered by each interaction's validate).
- */
-interface ZoneHandlesSnapshot<InteractionType extends string = string> {
-    cardIds: readonly string[];
-    cardViewsById: Readonly<Record<string, string>>;
-    playableByCardId: Readonly<Record<string, ReadonlyArray<InteractionDescriptor<InteractionType>>>>;
-}
-interface GameEventDetail {
-    label: string;
-    value: string | number | boolean;
-}
-interface SystemActionEvent {
-    kind: "systemAction";
-    procedureId: string;
-    title: string;
-    summary?: string;
-    details?: readonly GameEventDetail[];
-}
-type GameEvent = SystemActionEvent;
-
-/**
- * Result of validating a player action
- */
-interface ValidationResult {
-    /** Whether the action is valid */
-    valid: boolean;
-    /** Machine-readable error code if validation failed */
-    errorCode?: string;
-    /** Human-readable error message if validation failed */
-    message?: string;
-}
-/**
- * Structured authoritative submission failure returned by runtime submit APIs.
- */
-interface SubmissionError extends Error {
-    /** Machine-readable error code when available */
-    errorCode?: string;
-}
-type RuntimeDiagnosticEvent = {
-    type: "runtimeLog";
-    level: "log" | "warn" | "error";
-    message: string;
-    details?: readonly unknown[];
-} | {
-    type: "internalError";
-    code: string;
-    message: string;
-    stack?: string;
-};
-type RuntimeDiagnosticHandler = (event: RuntimeDiagnosticEvent) => void;
-/**
- * Plugin session state
- */
-interface PluginSessionState {
-    /** Session initialization status */
-    status: "loading" | "ready";
-    /** Current session ID (null if not initialized) */
-    sessionId: string | null;
-    /** The player perspective represented by the current gameplay frame */
-    controllingPlayerId: PlayerId | null;
-}
-/**
- * RuntimeAPI provides the interface between plugin code and the game runtime.
- * This API is exposed to plugin iframes for subscribing to game events and submitting actions.
- */
-interface RuntimeAPI {
-    /**
-     * Submit a player interaction to the game server. `submitInteraction`
-     * is the single submission verb for every interaction kind — authors
-     * do not split between "action" and "prompt response" calls.
-     *
-     * @param interactionId - Identifier of the interaction
-     * @param params - Interaction-specific runtime JSON payload; prompt
-     *   collectors may submit scalars while ordinary collectors submit objects.
-     * @throws SubmissionError if submission is rejected by the authority.
-     */
-    submitInteraction: (interactionId: string, params: unknown) => Promise<void>;
-    emitDiagnostic?: (event: RuntimeDiagnosticEvent) => void;
-    setDiagnosticHandler?: (handler: RuntimeDiagnosticHandler | undefined) => void;
-    /**
-     * Get the current plugin session state.
-     * Returns initialization status and session/player IDs.
-     *
-     * @returns Current plugin session state
-     *
-     * @example
-     * ```typescript
-     * const { status, sessionId, playerId } = runtime.getSessionState();
-     * if (status === "ready") {
-     *   console.log('Connected to session:', sessionId);
-     * }
-     * ```
-     */
-    getSessionState: () => PluginSessionState;
-    /**
-     * Disconnect from the runtime and clean up all listeners.
-     * Should be called when the plugin is unmounting.
-     */
-    disconnect: () => void;
-}
-
-export type { GameEvent as G, InputDomain as I, PlayerId as P, RuntimeAPI as R, SubmissionError as S, ValidationResult as V, ZoneHandlesSnapshot as Z, GameEventDetail as a, InteractionDescriptor as b, InteractionInputDescriptor as c, PluginSessionState as d, RuntimeDiagnosticEvent as e, RuntimeDiagnosticHandler as f, SystemActionEvent as g };

package/dist/runtime-json-CQ9QbLZ5.d.ts

@@ -1,5 +0,0 @@
-type RuntimeJson = null | boolean | number | string | RuntimeJson[] | {
-    [key: string]: RuntimeJson;
-};
-
-export type { RuntimeJson as R };

package/dist/runtime.d.ts

@@ -1,83 +0,0 @@
-import { b5 as UIContract$1, G as DreamboardUI$1, b3 as TypedGame$1 } from './ui-contract-GTUPkf8z.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-GTUPkf8z.js';
-export { a as ClientParamSchemaMap, W as WorkspaceBoardSurface, b as WorkspaceBoardSurfaceDescriptor, c as WorkspaceBoardTargetInputSlot, d as WorkspaceCardCollectionSurface, e as WorkspaceCardCollectionSurfaceDescriptor, f as WorkspaceCardInputSlot, g as WorkspaceFormInputSlot, h as WorkspaceHandSurface, i as WorkspaceHandSurfaceDescriptor, j as WorkspaceInteractionFormDescriptor, k as WorkspaceInteractionFormsDescriptor, l as WorkspaceInteractionSlotComponent, m as WorkspacePileSurface, n as WorkspacePileSurfaceDescriptor, o as WorkspacePilesSurfaceDescriptor, p as WorkspaceSurfaceSpec, q as createWorkspaceUIContract } from './index-CcT9Q7N7.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import react__default from 'react';
-import { f as RuntimeDiagnosticHandler } from './runtime-api-Bz5pwNU_.js';
-export { G as GameEvent, a as GameEventDetail, b as InteractionDescriptor, g as SystemActionEvent } from './runtime-api-Bz5pwNU_.js';
-import { P as PluginRuntimeClient, a as PluginRuntimeClientOptions, b as PluginTransport } from './types-DR7DoB1x.js';
-export { R as RuntimeClock, c as RuntimeIdFactory } from './types-DR7DoB1x.js';
-export { b as ResourceCounterComponents } from './ResourceCounter-BFxJknqp.js';
-import './hex-board-view-aKkblDp6.js';
-import './player-state-Cqpyeql0.js';
-import './types.js';
-import './ThemeProvider-CElaL2ik.js';
-import './primitive-props-BNHDkgd7.js';
-import './attributes-DbvyMbXw.js';
-import './types-DJj5MJkl.js';
-import './protocol-dYgafTYY.js';
-
-interface PluginRuntimeProps {
-    /** Child components to render after gameplay frame has started */
-    children: react__default.ReactNode;
-    /**
-     * Timeout in milliseconds to wait for the first gameplay-frame snapshot.
-     * @default 10000 (10 seconds)
-     */
-    timeout?: number;
-    /** Custom loading component to show while waiting for gameplay frame */
-    loadingComponent?: react__default.ReactNode;
-    /** Custom error component to show when initialization fails */
-    errorComponent?: (error: string) => react__default.ReactNode;
-    onDiagnostic?: RuntimeDiagnosticHandler;
-}
-/**
- * PluginRuntime provides the RuntimeContext for plugin components.
- *
- * This component:
- * - Creates a transport-backed runtime client
- * - Waits for the first projected gameplay frame before rendering children
- * - Provides runtime commands plus session/frame state to all child components
- *
- * @example
- * ```tsx
- * // In your plugin's index.tsx
- * import { PluginRuntime } from "./components/dreamboard";
- * import App from './App';
- *
- * ReactDOM.createRoot(document.getElementById('root')!).render(
- *   <PluginRuntime>
- *     <App />
- *   </PluginRuntime>
- * );
- * ```
- */
-declare function PluginRuntime({ children, timeout, loadingComponent, errorComponent, onDiagnostic, }: PluginRuntimeProps): react_jsx_runtime.JSX.Element;
-
-declare function PluginRuntimeBoundary({ runtime, children, }: {
-    runtime: PluginRuntimeClient;
-    children: react__default.ReactNode;
-}): react_jsx_runtime.JSX.Element;
-
-declare function createPluginRuntimeClient(options: PluginRuntimeClientOptions): PluginRuntimeClient;
-
-interface PostMessagePluginTransportOptions {
-    readonly targetWindow?: Window;
-    readonly parentWindow?: Window;
-    readonly bundledSdkVersion?: string;
-    readonly onInvalidMessage?: (reason: string, value: unknown) => void;
-}
-declare function createPostMessagePluginTransport(options?: PostMessagePluginTransportOptions): PluginTransport;
-
-interface DreamboardUIRegister {
-    readonly __dreamboardUIRegister?: never;
-}
-type UIContract = UIContract$1;
-type RegisteredUIContract = DreamboardUIRegister extends {
-    ui: infer Registered extends UIContract;
-} ? Registered : UIContract;
-type RegisteredUI = RegisteredUIContract;
-type DreamboardUI<Contract extends UIContract = RegisteredUI> = DreamboardUI$1<Contract>;
-type TypedGame<Contract extends UIContract, View = unknown, Player extends string = string, Phase extends string = string> = TypedGame$1<Contract, View, Player, Phase>;
-
-export { type DreamboardUI, type DreamboardUIRegister, PluginRuntime, PluginRuntimeBoundary, PluginRuntimeClient, PluginRuntimeClientOptions, type PluginRuntimeProps, PluginTransport, type PostMessagePluginTransportOptions, type RegisteredUI, type TypedGame, type UIContract, createPluginRuntimeClient, createPostMessagePluginTransport };

package/dist/runtime.js

@@ -1,242 +0,0 @@
-import {
-  PluginRuntimeBoundary,
-  createPluginRuntimeClient
-} from "./chunk-3BAD4VC2.js";
-import {
-  createWorkspaceUIContract
-} from "./chunk-EVCLTY4Q.js";
-import "./chunk-ANRB4XKA.js";
-import "./chunk-PN5O6GG2.js";
-import "./chunk-LR3ZTWQF.js";
-import "./chunk-T3ZKNUZ7.js";
-import "./chunk-GDPKTBUR.js";
-import "./chunk-3SKDNDPG.js";
-import {
-  GameSkeleton
-} from "./chunk-32PFKDV7.js";
-import "./chunk-VDXOF4FW.js";
-import "./chunk-WHR5UW3F.js";
-import {
-  DREAMBOARD_SDK_VERSION
-} from "./chunk-Y75CFE77.js";
-import {
-  DREAMBOARD_PLUGIN_PROTOCOL,
-  DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
-  HostToPluginEnvelopeSchema
-} from "./chunk-VCDWP5VL.js";
-import "./chunk-ZZGN2ATS.js";
-import "./chunk-H6VDGFL5.js";
-import "./chunk-5YV2WHJ4.js";
-import "./chunk-PF7L4BMG.js";
-import "./chunk-Z7QCREWI.js";
-import "./chunk-UGH54WZ2.js";
-import "./chunk-PZ5AY32C.js";
-
-// src/runtime/hooks/usePluginRuntime.ts
-import { useState, useEffect, useRef } from "react";
-
-// 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) => {
-        if (event.source !== parentWindow) {
-          return;
-        }
-        const parseResult = HostToPluginEnvelopeSchema.safeParse(event.data);
-        if (!parseResult.success) {
-          reportInvalidEnvelope("invalid-envelope", event.data);
-          return;
-        }
-        const envelope = parseResult.data;
-        if (!channel) {
-          if (envelope.payload.type !== "runtime.init") {
-            return;
-          }
-          channel = {
-            channelId: envelope.channelId,
-            hostOrigin: event.origin,
-            hostWindow: event.source
-          };
-        }
-        if (envelope.channelId !== channel.channelId || event.origin !== channel.hostOrigin || event.source !== channel.hostWindow) {
-          reportInvalidEnvelope("channel-mismatch", event.data);
-          return;
-        }
-        onMessage(envelope);
-      };
-      targetWindow.addEventListener("message", handleMessage);
-      return () => {
-        targetWindow.removeEventListener("message", handleMessage);
-        channel = null;
-      };
-    },
-    send(payload) {
-      if (!channel) {
-        throw new Error("Plugin transport is not initialized.");
-      }
-      channel.hostWindow.postMessage(
-        {
-          protocol: DREAMBOARD_PLUGIN_PROTOCOL,
-          version: DREAMBOARD_PLUGIN_PROTOCOL_VERSION,
-          channelId: channel.channelId,
-          sequence: ++outboundSequence,
-          payload
-        },
-        channel.hostOrigin
-      );
-    }
-  };
-}
-
-// src/runtime/hooks/usePluginRuntime.ts
-var BUNDLED_SDK_VERSION = DREAMBOARD_SDK_VERSION;
-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({
-        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 hasBeenReadyRef = useRef(false);
-  if (isReady) hasBeenReadyRef.current = true;
-  useEffect(() => {
-    void onDiagnostic;
-  }, [onDiagnostic]);
-  useEffect(() => {
-    const markReadyFromFrame = () => {
-      if (!hasProjectedView(runtime)) {
-        return false;
-      }
-      setError(null);
-      setIsReady(true);
-      return true;
-    };
-    if (markReadyFromFrame()) {
-      return;
-    }
-    const timeoutId = setTimeout(() => {
-      if (!markReadyFromFrame()) {
-        setError(
-          `Timed out waiting for the initial projected view after ${timeout}ms. Ensure the host sends a gameplay frame with a seat view.`
-        );
-      }
-    }, timeout);
-    const pollId = setInterval(() => {
-      if (markReadyFromFrame()) {
-        clearInterval(pollId);
-        clearTimeout(timeoutId);
-      }
-    }, 100);
-    const unsubscribe = runtime.subscribeFrame(() => {
-      if (!hasProjectedView(runtime)) {
-        setIsReady(false);
-        return;
-      }
-      clearInterval(pollId);
-      clearTimeout(timeoutId);
-      setError(null);
-      setIsReady(true);
-    });
-    return () => {
-      clearInterval(pollId);
-      clearTimeout(timeoutId);
-      unsubscribe?.();
-    };
-  }, [runtime, timeout]);
-  return {
-    runtime,
-    isReady,
-    waiting: hasBeenReadyRef.current && !isReady,
-    error
-  };
-}
-
-// src/runtime/components/PluginRuntime.tsx
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-function PluginRuntime({
-  children,
-  timeout = 1e4,
-  loadingComponent,
-  errorComponent,
-  onDiagnostic
-}) {
-  const { runtime, isReady, waiting, error } = usePluginRuntime({
-    timeout,
-    onDiagnostic
-  });
-  if (error) {
-    if (errorComponent) {
-      return /* @__PURE__ */ jsx(Fragment, { children: errorComponent(error) });
-    }
-    return /* @__PURE__ */ jsx("div", { className: "flex h-full w-full items-center justify-center bg-gray-50", children: /* @__PURE__ */ jsxs("div", { className: "text-center p-6", children: [
-      /* @__PURE__ */ jsx("p", { className: "text-red-600 font-medium mb-2", children: "Failed to load game" }),
-      /* @__PURE__ */ jsx("p", { className: "text-gray-600 text-sm", children: error })
-    ] }) });
-  }
-  if (!isReady) {
-    if (loadingComponent) {
-      return /* @__PURE__ */ jsx(Fragment, { children: loadingComponent });
-    }
-    return /* @__PURE__ */ jsx(
-      GameSkeleton,
-      {
-        message: waiting ? "Waiting for the other players\u2026" : "Waiting for game state..."
-      }
-    );
-  }
-  return /* @__PURE__ */ jsx(PluginRuntimeBoundary, { runtime, children });
-}
-export {
-  PluginRuntime,
-  PluginRuntimeBoundary,
-  createPluginRuntimeClient,
-  createPostMessagePluginTransport,
-  createWorkspaceUIContract
-};
-//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +0,0 @@
-{"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 { DREAMBOARD_SDK_VERSION } from \"../../package-set.js\";\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 = DREAMBOARD_SDK_VERSION;\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","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":[]}