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

package/dist/{chunk-PAPIAMYX.js.map → chunk-XV27IQHA.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/core/create-plugin-runtime-client.ts","../src/runtime/components/PluginRuntimeBoundary.tsx"],"sourcesContent":["import {\n  HostToPluginEnvelopeSchema,\n  RuntimeJsonSchema,\n  type HostToPluginEnvelope,\n  type PluginGameplayFrame,\n  type PluginInteractionBasis,\n  type PluginSessionDescriptor,\n  type SubmissionResult,\n  type ValidationResult,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type {\n  PluginRuntimeClient,\n  PluginRuntimeClientOptions,\n  RuntimeClock,\n  RuntimeIdFactory,\n} from \"./types.js\";\n\nconst defaultClock: RuntimeClock = {\n  now: () => Date.now(),\n};\n\nconst defaultIdFactory: RuntimeIdFactory = {\n  nextId: (prefix) => {\n    const cryptoLike = (\n      globalThis as typeof globalThis & {\n        crypto?: { randomUUID?: () => string };\n      }\n    ).crypto;\n    if (cryptoLike?.randomUUID) {\n      try {\n        return `${prefix}-${cryptoLike.randomUUID()}`;\n      } catch {\n        // Fall through to deterministic-enough fallback for older test DOMs.\n      }\n    }\n    return `${prefix}-${Date.now().toString(16)}-${Math.random()\n      .toString(16)\n      .slice(2)}`;\n  },\n};\n\nfunction createSubmissionError(\n  result: Extract<SubmissionResult, { accepted: false }>,\n): Error & { errorCode?: string } {\n  const error = new Error(result.message ?? \"Submission failed\") as Error & {\n    errorCode?: string;\n  };\n  error.name = \"SubmissionError\";\n  error.errorCode = result.errorCode;\n  return error;\n}\n\nfunction disconnectedValidationResult(): ValidationResult {\n  return {\n    valid: false,\n    errorCode: \"runtime-disconnected\",\n    message: \"Plugin runtime disconnected\",\n  };\n}\n\nexport function createPluginRuntimeClient(\n  options: PluginRuntimeClientOptions,\n): PluginRuntimeClient {\n  const clock = options.clock ?? defaultClock;\n  const idFactory = options.idFactory ?? defaultIdFactory;\n  const requestTimeoutMs = options.requestTimeoutMs ?? 10_000;\n  let session: PluginSessionDescriptor | null = null;\n  let frame: PluginGameplayFrame | null = null;\n  let disconnected = false;\n  let stopTransport: (() => void) | undefined;\n  const sessionListeners = new Set<() => void>();\n  const frameListeners = new Set<() => void>();\n  const pendingValidations = new Map<\n    string,\n    (result: ValidationResult) => void\n  >();\n  const pendingSubmissions = new Map<\n    string,\n    {\n      resolve: () => void;\n      reject: (error: Error & { errorCode?: string }) => void;\n    }\n  >();\n\n  const notifySession = () => {\n    for (const listener of sessionListeners) {\n      listener();\n    }\n  };\n\n  const notifyFrame = () => {\n    for (const listener of frameListeners) {\n      listener();\n    }\n  };\n\n  const currentBasis = (): PluginInteractionBasis => {\n    if (!frame) {\n      throw new Error(\"Plugin runtime has not received a gameplay frame.\");\n    }\n    return {\n      gameVersion: frame.gameVersion,\n      actionSetVersion: frame.actionSetVersion,\n      perspectivePlayerId: frame.perspectivePlayerId,\n    };\n  };\n\n  const sendRuntimeError = (message: string, code?: string) => {\n    if (disconnected) {\n      return;\n    }\n    options.transport.send({\n      type: \"runtime.error\",\n      message,\n      ...(code ? { code } : {}),\n    });\n  };\n\n  const handleHostMessage = (rawMessage: HostToPluginEnvelope) => {\n    if (disconnected) {\n      return;\n    }\n    const parseResult = HostToPluginEnvelopeSchema.safeParse(rawMessage);\n    if (!parseResult.success) {\n      sendRuntimeError(\n        \"Invalid host-to-plugin protocol envelope.\",\n        \"invalid-envelope\",\n      );\n      return;\n    }\n    const message = parseResult.data;\n    const clientReceivedAtMs = clock.now();\n\n    switch (message.payload.type) {\n      case \"runtime.init\": {\n        session = message.payload.session;\n        notifySession();\n        options.transport.send({ type: \"runtime.ready\" });\n        options.transport.send({\n          type: \"runtime.ack\",\n          sequence: message.sequence,\n          clientReceivedAtMs,\n        });\n        break;\n      }\n      case \"gameplay.frame\": {\n        frame = message.payload.frame;\n        notifyFrame();\n        const sendRenderedAck = () => {\n          if (disconnected) {\n            return;\n          }\n          options.transport.send({\n            type: \"runtime.ack\",\n            sequence: message.sequence,\n            clientReceivedAtMs,\n            clientRenderedAtMs: clock.now(),\n          });\n        };\n        if (typeof requestAnimationFrame === \"function\") {\n          requestAnimationFrame(sendRenderedAck);\n        } else {\n          queueMicrotask(sendRenderedAck);\n        }\n        break;\n      }\n      case \"interaction.validation-result\": {\n        const resolve = pendingValidations.get(message.payload.requestId);\n        if (resolve) {\n          pendingValidations.delete(message.payload.requestId);\n          resolve(message.payload.result);\n        }\n        break;\n      }\n      case \"interaction.submit-result\": {\n        const pending = pendingSubmissions.get(message.payload.requestId);\n        if (!pending) {\n          break;\n        }\n        pendingSubmissions.delete(message.payload.requestId);\n        if (message.payload.result.accepted) {\n          pending.resolve();\n        } else {\n          pending.reject(createSubmissionError(message.payload.result));\n        }\n        break;\n      }\n      default: {\n        const _exhaustive: never = message.payload;\n        return _exhaustive;\n      }\n    }\n  };\n\n  stopTransport = options.transport.start(handleHostMessage);\n\n  const rejectPending = () => {\n    for (const resolve of pendingValidations.values()) {\n      resolve(disconnectedValidationResult());\n    }\n    pendingValidations.clear();\n    for (const pending of pendingSubmissions.values()) {\n      const error = new Error(\"Plugin runtime disconnected\") as Error & {\n        errorCode?: string;\n      };\n      error.name = \"SubmissionError\";\n      error.errorCode = \"runtime-disconnected\";\n      pending.reject(error);\n    }\n    pendingSubmissions.clear();\n  };\n\n  return {\n    getSession: () => session,\n    subscribeSession: (listener) => {\n      sessionListeners.add(listener);\n      return () => {\n        sessionListeners.delete(listener);\n      };\n    },\n    getFrame: () => frame,\n    subscribeFrame: (listener) => {\n      frameListeners.add(listener);\n      return () => {\n        frameListeners.delete(listener);\n      };\n    },\n    validateInteraction: async (interactionId, params) =>\n      new Promise((resolve) => {\n        if (disconnected) {\n          resolve(disconnectedValidationResult());\n          return;\n        }\n        let basis: PluginInteractionBasis;\n        try {\n          basis = currentBasis();\n        } catch (error) {\n          resolve({\n            valid: false,\n            errorCode: \"runtime-not-ready\",\n            message:\n              error instanceof Error\n                ? error.message\n                : \"Plugin runtime is not ready.\",\n          });\n          return;\n        }\n        const parsedParams = RuntimeJsonSchema.safeParse(params);\n        if (!parsedParams.success) {\n          resolve({\n            valid: false,\n            errorCode: \"invalid-runtime-json\",\n            message: \"Interaction params must be runtime JSON.\",\n          });\n          return;\n        }\n        const requestId = idFactory.nextId(\"validate\");\n        pendingValidations.set(requestId, resolve);\n        options.transport.send({\n          type: \"interaction.validate\",\n          requestId,\n          basis,\n          interactionId,\n          params: parsedParams.data,\n        });\n        setTimeout(() => {\n          if (!pendingValidations.delete(requestId)) {\n            return;\n          }\n          resolve({\n            valid: false,\n            errorCode: \"validation-timeout\",\n            message: \"Validation request timed out\",\n          });\n        }, requestTimeoutMs);\n      }),\n    submitInteraction: async (interactionId, params) =>\n      new Promise((resolve, reject) => {\n        if (disconnected) {\n          const error = new Error(\"Plugin runtime disconnected\") as Error & {\n            errorCode?: string;\n          };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"runtime-disconnected\";\n          reject(error);\n          return;\n        }\n        const parsedParams = RuntimeJsonSchema.safeParse(params);\n        if (!parsedParams.success) {\n          const error = new Error(\n            \"Interaction params must be runtime JSON.\",\n          ) as Error & { errorCode?: string };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"invalid-runtime-json\";\n          reject(error);\n          return;\n        }\n        let basis: PluginInteractionBasis;\n        try {\n          basis = currentBasis();\n        } catch (error) {\n          const submissionError = new Error(\n            error instanceof Error\n              ? error.message\n              : \"Plugin runtime is not ready.\",\n          ) as Error & { errorCode?: string };\n          submissionError.name = \"SubmissionError\";\n          submissionError.errorCode = \"runtime-not-ready\";\n          reject(submissionError);\n          return;\n        }\n        const requestId = idFactory.nextId(\"submit\");\n        pendingSubmissions.set(requestId, { resolve, reject });\n        options.transport.send({\n          type: \"interaction.submit\",\n          requestId,\n          basis,\n          interactionId,\n          params: parsedParams.data,\n        });\n        setTimeout(() => {\n          const pending = pendingSubmissions.get(requestId);\n          if (!pending) {\n            return;\n          }\n          pendingSubmissions.delete(requestId);\n          const error = new Error(\"Submission request timed out\") as Error & {\n            errorCode?: string;\n          };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"submission-timeout\";\n          pending.reject(error);\n        }, requestTimeoutMs);\n      }),\n    disconnect: () => {\n      disconnected = true;\n      stopTransport?.();\n      stopTransport = undefined;\n      sessionListeners.clear();\n      frameListeners.clear();\n      rejectPending();\n      session = null;\n      frame = null;\n    },\n  };\n}\n","import React, { useMemo } from \"react\";\nimport { InteractionUiProvider } from \"../context/InteractionDraftContext.js\";\nimport {\n  PluginSessionProvider,\n  usePluginSession,\n} from \"../context/PluginSessionContext.js\";\nimport { PluginGameplayFrameProvider } from \"../context/PluginGameplayFrameContext.js\";\nimport { RuntimeContext } from \"../context/RuntimeContext.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeAPI } from \"../types/runtime-api.js\";\n\nfunction runtimeApiFromClient(runtime: PluginRuntimeClient): RuntimeAPI {\n  return {\n    validateInteraction: (interactionId, params) =>\n      runtime.validateInteraction(interactionId, params),\n    submitInteraction: (interactionId, params) =>\n      runtime.submitInteraction(interactionId, params),\n    getSessionState: () => {\n      const session = runtime.getSession();\n      const frame = runtime.getFrame();\n      return {\n        status: session ? \"ready\" : \"loading\",\n        sessionId: session?.sessionId ?? null,\n        controllingPlayerId: frame?.perspectivePlayerId ?? null,\n      };\n    },\n    disconnect: () => runtime.disconnect(),\n  };\n}\n\nexport function PluginRuntimeBoundary({\n  runtime,\n  children,\n}: {\n  runtime: PluginRuntimeClient;\n  children: React.ReactNode;\n}) {\n  const runtimeApi = useMemo(() => runtimeApiFromClient(runtime), [runtime]);\n\n  return (\n    <RuntimeContext.Provider value={runtimeApi}>\n      <PluginSessionProvider runtime={runtime}>\n        <PluginGameplayFrameProvider runtime={runtime}>\n          <SessionScopedInteractionUiProvider>\n            {children}\n          </SessionScopedInteractionUiProvider>\n        </PluginGameplayFrameProvider>\n      </PluginSessionProvider>\n    </RuntimeContext.Provider>\n  );\n}\n\nfunction SessionScopedInteractionUiProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const { controllingPlayerId } = usePluginSession();\n  return (\n    <InteractionUiProvider key={controllingPlayerId ?? \"__no_player__\"}>\n      {children}\n    </InteractionUiProvider>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/core/create-plugin-runtime-client.ts","../src/runtime/components/PluginRuntimeBoundary.tsx"],"sourcesContent":["import {\n  HostToPluginEnvelopeSchema,\n  RuntimeJsonSchema,\n  type HostToPluginEnvelope,\n  type PluginGameplayFrame,\n  type PluginInteractionBasis,\n  type PluginSessionDescriptor,\n  type SubmissionResult,\n  type ValidationResult,\n} from \"@dreamboard-games/plugin-runtime-contract\";\nimport type {\n  PluginRuntimeClient,\n  PluginRuntimeClientOptions,\n  RuntimeClock,\n  RuntimeIdFactory,\n} from \"./types.js\";\n\nconst defaultClock: RuntimeClock = {\n  now: () => Date.now(),\n};\n\nconst defaultIdFactory: RuntimeIdFactory = {\n  nextId: (prefix) => {\n    const cryptoLike = (\n      globalThis as typeof globalThis & {\n        crypto?: { randomUUID?: () => string };\n      }\n    ).crypto;\n    if (cryptoLike?.randomUUID) {\n      try {\n        return `${prefix}-${cryptoLike.randomUUID()}`;\n      } catch {\n        // Fall through to deterministic-enough fallback for older test DOMs.\n      }\n    }\n    return `${prefix}-${Date.now().toString(16)}-${Math.random()\n      .toString(16)\n      .slice(2)}`;\n  },\n};\n\nfunction createSubmissionError(\n  result: Extract<SubmissionResult, { accepted: false }>,\n): Error & { errorCode?: string } {\n  const error = new Error(result.message ?? \"Submission failed\") as Error & {\n    errorCode?: string;\n  };\n  error.name = \"SubmissionError\";\n  error.errorCode = result.errorCode;\n  return error;\n}\n\nfunction disconnectedValidationResult(): ValidationResult {\n  return {\n    valid: false,\n    errorCode: \"runtime-disconnected\",\n    message: \"Plugin runtime disconnected\",\n  };\n}\n\nexport function createPluginRuntimeClient(\n  options: PluginRuntimeClientOptions,\n): PluginRuntimeClient {\n  const clock = options.clock ?? defaultClock;\n  const idFactory = options.idFactory ?? defaultIdFactory;\n  const requestTimeoutMs = options.requestTimeoutMs ?? 10_000;\n  let session: PluginSessionDescriptor | null = null;\n  let frame: PluginGameplayFrame | null = null;\n  let disconnected = false;\n  let stopTransport: (() => void) | undefined;\n  const sessionListeners = new Set<() => void>();\n  const frameListeners = new Set<() => void>();\n  const pendingValidations = new Map<\n    string,\n    (result: ValidationResult) => void\n  >();\n  const pendingSubmissions = new Map<\n    string,\n    {\n      resolve: () => void;\n      reject: (error: Error & { errorCode?: string }) => void;\n    }\n  >();\n\n  const notifySession = () => {\n    for (const listener of sessionListeners) {\n      listener();\n    }\n  };\n\n  const notifyFrame = () => {\n    for (const listener of frameListeners) {\n      listener();\n    }\n  };\n\n  const currentBasis = (): PluginInteractionBasis => {\n    if (!frame) {\n      throw new Error(\"Plugin runtime has not received a gameplay frame.\");\n    }\n    return {\n      gameVersion: frame.gameVersion,\n      actionSetVersion: frame.actionSetVersion,\n      perspectivePlayerId: frame.perspectivePlayerId,\n    };\n  };\n\n  const sendRuntimeError = (message: string, code?: string) => {\n    if (disconnected) {\n      return;\n    }\n    options.transport.send({\n      type: \"runtime.error\",\n      message,\n      ...(code ? { code } : {}),\n    });\n  };\n\n  const handleHostMessage = (rawMessage: HostToPluginEnvelope) => {\n    if (disconnected) {\n      return;\n    }\n    const parseResult = HostToPluginEnvelopeSchema.safeParse(rawMessage);\n    if (!parseResult.success) {\n      sendRuntimeError(\n        \"Invalid host-to-plugin protocol envelope.\",\n        \"invalid-envelope\",\n      );\n      return;\n    }\n    const message = parseResult.data;\n    const clientReceivedAtMs = clock.now();\n\n    switch (message.payload.type) {\n      case \"runtime.init\": {\n        session = message.payload.session;\n        notifySession();\n        options.transport.send({ type: \"runtime.ready\" });\n        options.transport.send({\n          type: \"runtime.ack\",\n          sequence: message.sequence,\n          clientReceivedAtMs,\n        });\n        break;\n      }\n      case \"gameplay.frame\": {\n        frame = message.payload.frame;\n        notifyFrame();\n        const sendRenderedAck = () => {\n          if (disconnected) {\n            return;\n          }\n          options.transport.send({\n            type: \"runtime.ack\",\n            sequence: message.sequence,\n            clientReceivedAtMs,\n            clientRenderedAtMs: clock.now(),\n          });\n        };\n        if (typeof requestAnimationFrame === \"function\") {\n          requestAnimationFrame(sendRenderedAck);\n        } else {\n          queueMicrotask(sendRenderedAck);\n        }\n        break;\n      }\n      case \"interaction.validation-result\": {\n        const resolve = pendingValidations.get(message.payload.requestId);\n        if (resolve) {\n          pendingValidations.delete(message.payload.requestId);\n          resolve(message.payload.result);\n        }\n        break;\n      }\n      case \"interaction.submit-result\": {\n        const pending = pendingSubmissions.get(message.payload.requestId);\n        if (!pending) {\n          break;\n        }\n        pendingSubmissions.delete(message.payload.requestId);\n        if (message.payload.result.accepted) {\n          pending.resolve();\n        } else {\n          pending.reject(createSubmissionError(message.payload.result));\n        }\n        break;\n      }\n      default: {\n        const _exhaustive: never = message.payload;\n        return _exhaustive;\n      }\n    }\n  };\n\n  stopTransport = options.transport.start(handleHostMessage);\n\n  const rejectPending = () => {\n    for (const resolve of pendingValidations.values()) {\n      resolve(disconnectedValidationResult());\n    }\n    pendingValidations.clear();\n    for (const pending of pendingSubmissions.values()) {\n      const error = new Error(\"Plugin runtime disconnected\") as Error & {\n        errorCode?: string;\n      };\n      error.name = \"SubmissionError\";\n      error.errorCode = \"runtime-disconnected\";\n      pending.reject(error);\n    }\n    pendingSubmissions.clear();\n  };\n\n  return {\n    getSession: () => session,\n    subscribeSession: (listener) => {\n      sessionListeners.add(listener);\n      return () => {\n        sessionListeners.delete(listener);\n      };\n    },\n    getFrame: () => frame,\n    subscribeFrame: (listener) => {\n      frameListeners.add(listener);\n      return () => {\n        frameListeners.delete(listener);\n      };\n    },\n    validateInteraction: async (interactionId, params) =>\n      new Promise((resolve) => {\n        if (disconnected) {\n          resolve(disconnectedValidationResult());\n          return;\n        }\n        let basis: PluginInteractionBasis;\n        try {\n          basis = currentBasis();\n        } catch (error) {\n          resolve({\n            valid: false,\n            errorCode: \"runtime-not-ready\",\n            message:\n              error instanceof Error\n                ? error.message\n                : \"Plugin runtime is not ready.\",\n          });\n          return;\n        }\n        const parsedParams = RuntimeJsonSchema.safeParse(params);\n        if (!parsedParams.success) {\n          resolve({\n            valid: false,\n            errorCode: \"invalid-runtime-json\",\n            message: \"Interaction params must be runtime JSON.\",\n          });\n          return;\n        }\n        const requestId = idFactory.nextId(\"validate\");\n        pendingValidations.set(requestId, resolve);\n        options.transport.send({\n          type: \"interaction.validate\",\n          requestId,\n          basis,\n          interactionId,\n          params: parsedParams.data,\n        });\n        setTimeout(() => {\n          if (!pendingValidations.delete(requestId)) {\n            return;\n          }\n          resolve({\n            valid: false,\n            errorCode: \"validation-timeout\",\n            message: \"Validation request timed out\",\n          });\n        }, requestTimeoutMs);\n      }),\n    submitInteraction: async (interactionId, params) =>\n      new Promise((resolve, reject) => {\n        if (disconnected) {\n          const error = new Error(\"Plugin runtime disconnected\") as Error & {\n            errorCode?: string;\n          };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"runtime-disconnected\";\n          reject(error);\n          return;\n        }\n        const parsedParams = RuntimeJsonSchema.safeParse(params);\n        if (!parsedParams.success) {\n          const error = new Error(\n            \"Interaction params must be runtime JSON.\",\n          ) as Error & { errorCode?: string };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"invalid-runtime-json\";\n          reject(error);\n          return;\n        }\n        let basis: PluginInteractionBasis;\n        try {\n          basis = currentBasis();\n        } catch (error) {\n          const submissionError = new Error(\n            error instanceof Error\n              ? error.message\n              : \"Plugin runtime is not ready.\",\n          ) as Error & { errorCode?: string };\n          submissionError.name = \"SubmissionError\";\n          submissionError.errorCode = \"runtime-not-ready\";\n          reject(submissionError);\n          return;\n        }\n        const requestId = idFactory.nextId(\"submit\");\n        pendingSubmissions.set(requestId, { resolve, reject });\n        options.transport.send({\n          type: \"interaction.submit\",\n          requestId,\n          basis,\n          interactionId,\n          params: parsedParams.data,\n        });\n        setTimeout(() => {\n          const pending = pendingSubmissions.get(requestId);\n          if (!pending) {\n            return;\n          }\n          pendingSubmissions.delete(requestId);\n          const error = new Error(\"Submission request timed out\") as Error & {\n            errorCode?: string;\n          };\n          error.name = \"SubmissionError\";\n          error.errorCode = \"submission-timeout\";\n          pending.reject(error);\n        }, requestTimeoutMs);\n      }),\n    disconnect: () => {\n      disconnected = true;\n      stopTransport?.();\n      stopTransport = undefined;\n      sessionListeners.clear();\n      frameListeners.clear();\n      rejectPending();\n      session = null;\n      frame = null;\n    },\n  };\n}\n","import React, { useMemo } from \"react\";\nimport { InteractionUiProvider } from \"../context/InteractionDraftContext.js\";\nimport {\n  PluginSessionProvider,\n  usePluginSession,\n} from \"../context/PluginSessionContext.js\";\nimport { PluginGameplayFrameProvider } from \"../context/PluginGameplayFrameContext.js\";\nimport { RuntimeContext } from \"../context/RuntimeContext.js\";\nimport type { PluginRuntimeClient } from \"../core/types.js\";\nimport type { RuntimeAPI } from \"../types/runtime-api.js\";\n\nfunction runtimeApiFromClient(runtime: PluginRuntimeClient): RuntimeAPI {\n  return {\n    validateInteraction: (interactionId, params) =>\n      runtime.validateInteraction(interactionId, params),\n    submitInteraction: (interactionId, params) =>\n      runtime.submitInteraction(interactionId, params),\n    getSessionState: () => {\n      const session = runtime.getSession();\n      const frame = runtime.getFrame();\n      return {\n        status: session ? \"ready\" : \"loading\",\n        sessionId: session?.sessionId ?? null,\n        controllingPlayerId: frame?.perspectivePlayerId ?? null,\n      };\n    },\n    disconnect: () => runtime.disconnect(),\n  };\n}\n\nexport function PluginRuntimeBoundary({\n  runtime,\n  children,\n}: {\n  runtime: PluginRuntimeClient;\n  children: React.ReactNode;\n}) {\n  const runtimeApi = useMemo(() => runtimeApiFromClient(runtime), [runtime]);\n\n  return (\n    <RuntimeContext.Provider value={runtimeApi}>\n      <PluginSessionProvider runtime={runtime}>\n        <PluginGameplayFrameProvider runtime={runtime}>\n          <SessionScopedInteractionUiProvider>\n            {children}\n          </SessionScopedInteractionUiProvider>\n        </PluginGameplayFrameProvider>\n      </PluginSessionProvider>\n    </RuntimeContext.Provider>\n  );\n}\n\nfunction SessionScopedInteractionUiProvider({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  const { controllingPlayerId } = usePluginSession();\n  return (\n    <InteractionUiProvider key={controllingPlayerId ?? \"__no_player__\"}>\n      {children}\n    </InteractionUiProvider>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-DDST4U2P.js → chunk-YGQTL63W.js}

@@ -1,6 +1,6 @@
 import {
   GENERATED_AUTHORING_METADATA
-} from "./chunk-HK3WN4U7.js";
+} from "./chunk-VTNEWMWJ.js";
 
 // src/package-set.ts
 var DREAMBOARD_SDK_VERSION = GENERATED_AUTHORING_METADATA.sdkVersion;
@@ -18,4 +18,4 @@ export {
   DREAMBOARD_SDK_PACKAGES,
   DREAMBOARD_SDK_PACKAGE_SET
 };
-//# sourceMappingURL=chunk-DDST4U2P.js.map
+//# sourceMappingURL=chunk-YGQTL63W.js.map

package/dist/chunk-ZYONCTZ2.js

@@ -0,0 +1,564 @@
+import {
+  BROWSER_INTERACTION_ATTRIBUTES,
+  DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION,
+  GAMEPLAY_BROWSER_INTERACTION_SURFACE
+} from "./chunk-WHR5UW3F.js";
+import {
+  digestPluginGameplayFrame
+} from "./chunk-IYX5OO2K.js";
+
+// src/runtime/context/PluginGameplayFrameContext.tsx
+import {
+  createContext,
+  useContext,
+  useMemo as useMemo2,
+  useSyncExternalStore as useSyncExternalStore2
+} from "react";
+
+// src/runtime/hooks/useRuntimeSnapshotSelector.ts
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+function defaultRuntimeSnapshotEquality(left, right) {
+  return Object.is(left, right);
+}
+function useRuntimeSnapshotSelector(subscribe, getSnapshot, getServerSnapshot, selector, equalityFn = defaultRuntimeSnapshotEquality) {
+  const cache = useMemo(
+    () => ({ current: null, selector, equalityFn }),
+    [equalityFn, selector]
+  );
+  const getSelectedFromSnapshot = useCallback(
+    (snapshot) => {
+      const cached = cache.current;
+      if (cached && cached.snapshot === snapshot) {
+        return cached.selection;
+      }
+      const nextSelection = selector(snapshot);
+      if (cached && equalityFn(cached.selection, nextSelection)) {
+        cache.current = {
+          snapshot,
+          selection: cached.selection
+        };
+        return cached.selection;
+      }
+      cache.current = {
+        snapshot,
+        selection: nextSelection
+      };
+      return nextSelection;
+    },
+    [cache, equalityFn, selector]
+  );
+  const getSelectedSnapshot = useCallback(
+    () => getSelectedFromSnapshot(getSnapshot()),
+    [getSelectedFromSnapshot, getSnapshot]
+  );
+  const getSelectedServerSnapshot = useCallback(
+    () => selector(getServerSnapshot()),
+    [getServerSnapshot, selector]
+  );
+  const subscribeSelected = useCallback(
+    (onStoreChange) => subscribe(() => {
+      const previous = cache.current;
+      const nextSelection = getSelectedSnapshot();
+      if (!previous || !equalityFn(previous.selection, nextSelection)) {
+        onStoreChange();
+      }
+    }),
+    [cache, equalityFn, getSelectedSnapshot, subscribe]
+  );
+  return useSyncExternalStore(
+    subscribeSelected,
+    getSelectedSnapshot,
+    getSelectedServerSnapshot
+  );
+}
+
+// src/runtime/context/PluginGameplayFrameContext.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var contextRegistryKey = "__dreamboardPluginGameplayFrameContext";
+var contextRegistryGlobal = globalThis;
+var contextRegistry = contextRegistryGlobal[contextRegistryKey] ?? (contextRegistryGlobal[contextRegistryKey] = {
+  store: createContext(null),
+  frame: createContext(null)
+});
+var PluginGameplayFrameStoreContext = contextRegistry.store;
+var PluginGameplayFrameContext = contextRegistry.frame;
+function DefaultLoadingScreen() {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        height: "100%",
+        width: "100%",
+        color: "#666"
+      },
+      children: /* @__PURE__ */ jsxs("div", { style: { textAlign: "center" }, children: [
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              width: "40px",
+              height: "40px",
+              border: "3px solid #e0e0e0",
+              borderTopColor: "#666",
+              borderRadius: "50%",
+              animation: "spin 1s linear infinite",
+              margin: "0 auto 12px"
+            }
+          }
+        ),
+        /* @__PURE__ */ jsx("style", { children: `@keyframes spin { to { transform: rotate(360deg); } }` }),
+        /* @__PURE__ */ jsx("p", { children: "Loading game view..." })
+      ] })
+    }
+  );
+}
+function PluginGameplayFrameProvider({
+  runtime,
+  children,
+  loadingComponent = /* @__PURE__ */ jsx(DefaultLoadingScreen, {})
+}) {
+  const storeApi = useMemo2(() => {
+    let current = runtime.getFrame();
+    return {
+      subscribe: (onStoreChange) => runtime.subscribeFrame(() => {
+        current = runtime.getFrame();
+        onStoreChange();
+      }),
+      getSnapshot: () => current,
+      getServerSnapshot: () => current
+    };
+  }, [runtime]);
+  return /* @__PURE__ */ jsx(
+    PluginGameplayFrameStoreProvider,
+    {
+      store: storeApi,
+      loadingComponent,
+      children
+    }
+  );
+}
+function PluginGameplayFrameStoreProvider({
+  store,
+  children,
+  loadingComponent
+}) {
+  const frame = useSyncExternalStore2(
+    store.subscribe,
+    store.getSnapshot,
+    store.getServerSnapshot
+  );
+  if (!frame) {
+    return /* @__PURE__ */ jsx(Fragment, { children: loadingComponent });
+  }
+  return /* @__PURE__ */ jsx(PluginGameplayFrameStoreContext.Provider, { value: store, children: /* @__PURE__ */ jsxs(PluginGameplayFrameContext.Provider, { value: frame, children: [
+    /* @__PURE__ */ jsx(SemanticGameplayFrameMarker, { frame }),
+    children
+  ] }) });
+}
+function usePluginGameplayFrameSelector(selector, equalityFn = defaultRuntimeSnapshotEquality) {
+  const store = useContext(PluginGameplayFrameStoreContext);
+  if (!store) {
+    throw new Error(
+      "usePluginGameplayFrameSelector must be used within PluginGameplayFrameProvider."
+    );
+  }
+  return useRuntimeSnapshotSelector(
+    store.subscribe,
+    store.getSnapshot,
+    store.getServerSnapshot,
+    (frame) => selector(requirePluginGameplayFrame(frame)),
+    equalityFn
+  );
+}
+function useAuthoredPluginGameplayFrameSelector(selector, equalityFn = defaultRuntimeSnapshotEquality) {
+  return usePluginGameplayFrameSelector(
+    (frame) => selector(frame),
+    equalityFn
+  );
+}
+function requirePluginGameplayFrame(frame) {
+  if (!frame) {
+    throw new Error("Plugin gameplay frame is not available.");
+  }
+  return frame;
+}
+var GAMEPLAY_BROWSER_SCOPE_ID = "runtime";
+var BROWSER_PROJECTION_DIGEST_ATTRIBUTE = "data-dreamboard-projection-digest";
+function SemanticGameplayFrameMarker({
+  frame
+}) {
+  const digest = digestPluginGameplayFrame(frame);
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-hidden": "true",
+      style: { display: "none" },
+      ...{
+        [BROWSER_INTERACTION_ATTRIBUTES.protocol]: DREAMBOARD_BROWSER_INTERACTION_PROTOCOL_VERSION,
+        [BROWSER_INTERACTION_ATTRIBUTES.surface]: GAMEPLAY_BROWSER_INTERACTION_SURFACE,
+        [BROWSER_INTERACTION_ATTRIBUTES.scope]: GAMEPLAY_BROWSER_SCOPE_ID,
+        [BROWSER_INTERACTION_ATTRIBUTES.role]: "projection",
+        [BROWSER_PROJECTION_DIGEST_ATTRIBUTE]: digest
+      }
+    }
+  );
+}
+
+// src/runtime/context/InteractionDraftContext.tsx
+import {
+  createContext as createContext2,
+  useContext as useContext2,
+  useMemo as useMemo3
+} from "react";
+import { useStore } from "zustand";
+import { createStore } from "zustand/vanilla";
+import { useShallow } from "zustand/shallow";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var EMPTY_DRAFT = Object.freeze({});
+function omitRecordKey(record, key) {
+  const next = { ...record };
+  delete next[key];
+  return next;
+}
+function createInteractionUiStore() {
+  const store = createStore()(() => ({
+    drafts: {},
+    arms: {},
+    submitting: {},
+    pendingInteractionKey: null,
+    pendingInteractionRevision: 0
+  }));
+  const api = {
+    getDraft(interactionId) {
+      return store.getState().drafts[interactionId] ?? EMPTY_DRAFT;
+    },
+    setInput(interactionId, key, value) {
+      store.setState((prev) => {
+        const current = prev.drafts[interactionId];
+        if (current && current[key] === value) return prev;
+        return {
+          ...prev,
+          drafts: {
+            ...prev.drafts,
+            [interactionId]: { ...current ?? {}, [key]: value }
+          }
+        };
+      });
+    },
+    clearInput(interactionId, key) {
+      store.setState((prev) => {
+        const current = prev.drafts[interactionId];
+        if (!current) return prev;
+        if (key === void 0) {
+          return { ...prev, drafts: omitRecordKey(prev.drafts, interactionId) };
+        }
+        if (!(key in current)) return prev;
+        const remainingKeys = omitRecordKey(current, key);
+        if (Object.keys(remainingKeys).length === 0) {
+          return { ...prev, drafts: omitRecordKey(prev.drafts, interactionId) };
+        }
+        return {
+          ...prev,
+          drafts: { ...prev.drafts, [interactionId]: remainingKeys }
+        };
+      });
+    },
+    clearAll() {
+      store.setState((prev) => {
+        if (Object.keys(prev.drafts).length === 0 && Object.keys(prev.arms).length === 0 && Object.keys(prev.submitting).length === 0 && prev.pendingInteractionKey === null) {
+          return prev;
+        }
+        return {
+          drafts: {},
+          arms: {},
+          submitting: {},
+          pendingInteractionKey: null,
+          pendingInteractionRevision: prev.pendingInteractionRevision + 1
+        };
+      });
+    },
+    getArmed(surface) {
+      return store.getState().arms[surface] ?? null;
+    },
+    arm(surface, interactionId) {
+      store.setState((prev) => {
+        const current = prev.arms[surface] ?? null;
+        if (current === interactionId) return prev;
+        if (interactionId === null) {
+          return { ...prev, arms: omitRecordKey(prev.arms, surface) };
+        }
+        return { ...prev, arms: { ...prev.arms, [surface]: interactionId } };
+      });
+    },
+    getPendingInteraction() {
+      return store.getState().pendingInteractionKey;
+    },
+    setPendingInteraction(interactionId) {
+      store.setState((prev) => {
+        if (prev.pendingInteractionKey === interactionId) {
+          return interactionId === null ? prev : {
+            ...prev,
+            pendingInteractionRevision: prev.pendingInteractionRevision + 1
+          };
+        }
+        return {
+          ...prev,
+          pendingInteractionKey: interactionId,
+          pendingInteractionRevision: prev.pendingInteractionRevision + 1
+        };
+      });
+    },
+    getPendingInteractionRevision() {
+      return store.getState().pendingInteractionRevision;
+    },
+    isSubmitting(interactionId) {
+      return store.getState().submitting[interactionId] === true;
+    },
+    claimSubmitting(interactionId) {
+      let claimed = false;
+      store.setState((prev) => {
+        if (prev.submitting[interactionId] === true) return prev;
+        claimed = true;
+        return {
+          ...prev,
+          submitting: { ...prev.submitting, [interactionId]: true }
+        };
+      });
+      return claimed;
+    },
+    setSubmitting(interactionId, submitting) {
+      store.setState((prev) => {
+        const current = prev.submitting[interactionId] === true;
+        if (current === submitting) return prev;
+        if (!submitting) {
+          return {
+            ...prev,
+            submitting: omitRecordKey(prev.submitting, interactionId)
+          };
+        }
+        return {
+          ...prev,
+          submitting: { ...prev.submitting, [interactionId]: true }
+        };
+      });
+    }
+  };
+  return Object.assign(store, api);
+}
+var contextRegistryKey2 = "__dreamboardInteractionUiContext";
+var contextRegistryGlobal2 = globalThis;
+var InteractionUiCtx = contextRegistryGlobal2[contextRegistryKey2] ?? (contextRegistryGlobal2[contextRegistryKey2] = createContext2(null));
+function InteractionUiProvider({
+  children,
+  store
+}) {
+  const ownedStore = useMemo3(() => createInteractionUiStore(), []);
+  return /* @__PURE__ */ jsx2(InteractionUiCtx.Provider, { value: store ?? ownedStore, children });
+}
+function useInteractionUiStore() {
+  const ctx = useContext2(InteractionUiCtx);
+  const fallback = useMemo3(() => createInteractionUiStore(), []);
+  return ctx ?? fallback;
+}
+function useInteractionDraft(interactionId) {
+  const store = useInteractionUiStore();
+  useStore(
+    store,
+    useShallow(
+      (state) => state.drafts[interactionId] ?? EMPTY_DRAFT
+    )
+  );
+  return store.getDraft(interactionId);
+}
+function useArmedInteraction(surface) {
+  const store = useInteractionUiStore();
+  return useStore(store, (state) => state.arms[surface] ?? null);
+}
+function usePendingInteractionKey() {
+  const store = useInteractionUiStore();
+  const subscribed = useStore(
+    store,
+    (state) => state.pendingInteractionKey ?? null
+  );
+  return store.getPendingInteraction() ?? subscribed;
+}
+function usePendingInteractionRevision() {
+  const store = useInteractionUiStore();
+  const subscribed = useStore(
+    store,
+    (state) => state.pendingInteractionRevision
+  );
+  return Math.max(store.getPendingInteractionRevision(), subscribed);
+}
+function useInteractionSubmitting(interactionId) {
+  const store = useInteractionUiStore();
+  return useStore(
+    store,
+    (state) => state.submitting[interactionId] === true
+  );
+}
+
+// src/runtime/context/PluginSessionContext.tsx
+import {
+  createContext as createContext3,
+  useContext as useContext3,
+  useMemo as useMemo4,
+  useSyncExternalStore as useSyncExternalStore3
+} from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var contextRegistryKey3 = "__dreamboardPluginSessionContext";
+var contextRegistryGlobal3 = globalThis;
+var contextRegistry2 = contextRegistryGlobal3[contextRegistryKey3] ?? (contextRegistryGlobal3[contextRegistryKey3] = {
+  session: createContext3(null),
+  descriptor: createContext3(null)
+});
+var PluginSessionContext = contextRegistry2.session;
+var PluginSessionDescriptorContext = contextRegistry2.descriptor;
+function sessionStateFromClient(runtime) {
+  const session = runtime.getSession();
+  const frame = runtime.getFrame();
+  return {
+    status: session ? "ready" : "loading",
+    sessionId: session?.sessionId ?? null,
+    controllingPlayerId: frame?.perspectivePlayerId ?? null
+  };
+}
+function pluginSessionStatesEqual(left, right) {
+  if (left.status !== right.status || left.sessionId !== right.sessionId || left.controllingPlayerId !== right.controllingPlayerId) {
+    return false;
+  }
+  return true;
+}
+function pluginSessionDescriptorsEqual(left, right) {
+  if (left === right) return true;
+  if (!left || !right) return false;
+  if (left.sessionId !== right.sessionId || left.players.length !== right.players.length) {
+    return false;
+  }
+  return left.players.every((player, index) => {
+    const next = right.players[index];
+    return player.playerId === next?.playerId && player.displayName === next.displayName && player.color === next.color;
+  });
+}
+function PluginSessionProvider({
+  runtime,
+  children
+}) {
+  const sessionStore = useMemo4(() => {
+    let current = sessionStateFromClient(runtime);
+    return {
+      subscribe: (onStoreChange) => {
+        const refresh = () => {
+          const next = sessionStateFromClient(runtime);
+          if (pluginSessionStatesEqual(current, next)) {
+            return;
+          }
+          current = next;
+          onStoreChange();
+        };
+        const unsubscribeSession = runtime.subscribeSession(refresh);
+        const unsubscribeFrame = runtime.subscribeFrame(refresh);
+        return () => {
+          unsubscribeFrame();
+          unsubscribeSession();
+        };
+      },
+      getSnapshot: () => current,
+      getServerSnapshot: () => current
+    };
+  }, [runtime]);
+  const descriptorStore = useMemo4(() => {
+    let current = runtime.getSession();
+    return {
+      subscribe: (onStoreChange) => {
+        const refresh = () => {
+          const next = runtime.getSession();
+          if (pluginSessionDescriptorsEqual(current, next)) {
+            return;
+          }
+          current = next;
+          onStoreChange();
+        };
+        const unsubscribeSession = runtime.subscribeSession(refresh);
+        return () => {
+          unsubscribeSession();
+        };
+      },
+      getSnapshot: () => current,
+      getServerSnapshot: () => current
+    };
+  }, [runtime]);
+  const sessionState = useSyncExternalStore3(
+    sessionStore.subscribe,
+    sessionStore.getSnapshot,
+    sessionStore.getServerSnapshot
+  );
+  const sessionDescriptor = useSyncExternalStore3(
+    descriptorStore.subscribe,
+    descriptorStore.getSnapshot,
+    descriptorStore.getServerSnapshot
+  );
+  return /* @__PURE__ */ jsx3(PluginSessionContext.Provider, { value: sessionState, children: /* @__PURE__ */ jsx3(PluginSessionDescriptorContext.Provider, { value: sessionDescriptor, children }) });
+}
+function usePluginSession() {
+  const context = useContext3(PluginSessionContext);
+  if (context === null) {
+    throw new Error(
+      "usePluginSession must be used within a PluginSessionContext.Provider (provided by RuntimeContext)"
+    );
+  }
+  return context;
+}
+function useOptionalPluginSessionDescriptor() {
+  return useContext3(PluginSessionDescriptorContext);
+}
+function usePluginSessionDescriptor() {
+  const descriptor = useOptionalPluginSessionDescriptor();
+  if (!descriptor) {
+    throw new Error(
+      "usePluginSessionDescriptor must be used within PluginSessionProvider."
+    );
+  }
+  return descriptor;
+}
+
+// src/runtime/context/RuntimeContext.tsx
+import { createContext as createContext4, useContext as useContext4, useState, useEffect } from "react";
+import { jsx as jsx4 } from "react/jsx-runtime";
+var contextRegistryKey4 = "__dreamboardRuntimeContext";
+var contextRegistryGlobal4 = globalThis;
+var RuntimeContext = contextRegistryGlobal4[contextRegistryKey4] ?? (contextRegistryGlobal4[contextRegistryKey4] = createContext4(
+  null
+));
+function useRuntimeContext() {
+  const context = useContext4(RuntimeContext);
+  if (!context) {
+    throw new Error(
+      "useRuntimeContext must be used within a RuntimeContext.Provider"
+    );
+  }
+  return context;
+}
+
+export {
+  defaultRuntimeSnapshotEquality,
+  PluginGameplayFrameProvider,
+  usePluginGameplayFrameSelector,
+  useAuthoredPluginGameplayFrameSelector,
+  InteractionUiProvider,
+  useInteractionUiStore,
+  useInteractionDraft,
+  useArmedInteraction,
+  usePendingInteractionKey,
+  usePendingInteractionRevision,
+  useInteractionSubmitting,
+  PluginSessionProvider,
+  usePluginSession,
+  usePluginSessionDescriptor,
+  RuntimeContext,
+  useRuntimeContext
+};
+//# sourceMappingURL=chunk-ZYONCTZ2.js.map