@dreamboard-games/sdk 0.2.0

package/src/runtime-internal/primitives/index.ts

@@ -0,0 +1,196 @@
+export { UI, UIRoot, type UIRootProps } from "./ui.js";
+export {
+  HandSurfaceView,
+  dropTargetIdFor,
+  descriptorsHaveDestinationInput,
+  type HandSurfaceViewProps,
+  type RuntimeDropTarget,
+} from "./hand-surface.js";
+export {
+  decodeAuthoredCardIntent,
+  useCardIntentAdapter,
+  type AuthoredCardIntent,
+  type RuntimeCardIntentResult,
+  type UseCardIntentAdapterOptions,
+} from "./hand-intent-adapter.js";
+export {
+  Board,
+  BoardEdgeTarget,
+  BoardHexGrid,
+  BoardHexView,
+  BoardRoot,
+  BoardSpaceTarget,
+  BoardState,
+  BoardTarget,
+  BoardVertexTarget,
+  useBoardPrimitiveContext,
+  type BoardEdgeTargetProps,
+  type BoardHexGridInteractionFilter,
+  type BoardHexGridInteractions,
+  type BoardHexGridProps,
+  type BoardHexViewProps,
+  type BoardRootProps,
+  type BoardSpaceTargetProps,
+  type BoardStateProps,
+  type BoardTargetExtraInputs,
+  type BoardTargetProps,
+  type BoardVertexTargetProps,
+} from "./board.js";
+export {
+  Game,
+  GameChrome,
+  GameRoot,
+  useGameActionError,
+  type GameActiveActionState,
+  type GameChromeProps,
+  type GameChromeState,
+  type GameMeState,
+  type GamePendingInputState,
+  type GamePlayer,
+  type GamePlayerEntry,
+  type GamePlayersState,
+  type GameRenderState,
+  type GameRootProps,
+  type GameTurnState,
+} from "./game.js";
+export {
+  Interaction,
+  InteractionCardInput,
+  InteractionDescription,
+  InteractionDialog,
+  InteractionFormPrimitive,
+  InteractionInput,
+  InteractionLabel,
+  InteractionRoot,
+  InteractionRoutes,
+  InteractionState,
+  InteractionSubmit,
+  InteractionSwitch,
+  InteractionTrigger,
+  InteractionUnavailableMessage,
+  InteractionValidationMessage,
+  useInteractionPrimitiveContext,
+  useResolvedCardTargetValue,
+  type InteractionCardInputProps,
+  type InteractionCardInputRenderState,
+  type InteractionDialogProps,
+  type InteractionDialogRenderState,
+  type InteractionDialogState,
+  type InteractionFieldPrimitiveProps,
+  type InteractionFormPrimitiveProps,
+  type InteractionInputProps,
+  type InteractionPartProps,
+  type InteractionRoute,
+  type InteractionRoutesMap,
+  type InteractionRoutesProps,
+  type InteractionRootProps,
+  type InteractionStateProps,
+  type InteractionStateSnapshot,
+  type InteractionSubmitProps,
+  type InteractionSwitchRouteMap,
+  type InteractionSwitchProps,
+  type InteractionSwitchRenderState,
+  type InteractionTriggerProps,
+} from "./interaction.js";
+export {
+  Phase,
+  PhaseSwitch,
+  type PhaseFallback,
+  type PhaseRouteMap,
+  type PhaseSwitchProps,
+} from "./phase.js";
+export {
+  PlayerRoster,
+  PlayerRosterBadges,
+  PlayerRosterEmpty,
+  PlayerRosterList,
+  PlayerRosterName,
+  PlayerRosterRoot,
+  PlayerRosterScore,
+  PlayerRosterSwitchButton,
+  type PlayerRosterBadge,
+  type PlayerRosterComponents,
+  type PlayerRosterEntry,
+  type PlayerRosterListProps,
+  type PlayerRosterPartProps,
+  type PlayerRosterRootProps,
+  type PlayerRosterSwitchButtonProps,
+} from "./player-roster.js";
+export {
+  Prompt,
+  PromptInbox,
+  PromptInboxEmpty,
+  PromptInboxItems,
+  PromptInboxRoot,
+  PromptDialog,
+  PromptMessage,
+  PromptOption,
+  PromptOptions,
+  PromptRoot,
+  PromptTitle,
+  type PromptDialogProps,
+  type PromptDialogRenderState,
+  type PromptDialogState,
+  type PromptInboxItemsProps,
+  type PromptOptionRenderItem,
+  type PromptOptionProps,
+  type PromptOptionsProps,
+  type PromptRootProps,
+} from "./prompt.js";
+export {
+  composeEventHandlers,
+  renderPrimitive,
+  type PrimitiveCommonProps,
+  type PrimitiveDataAttributes,
+} from "./primitive-props.js";
+export {
+  Dice,
+  DiceRoot,
+  DiceValues,
+  normalizeDiceState,
+  useDicePrimitiveContext,
+  type DiceComponents,
+  type DiceRootProps,
+  type DiceState,
+  type DiceValue,
+  type DiceValuesProps,
+} from "./dice.js";
+export {
+  Zone,
+  ZoneCardAt,
+  ZoneCardAction,
+  ZoneItem,
+  ZoneList,
+  ZonePileCards,
+  ZonePileCount,
+  ZonePileDescription,
+  ZonePileLabel,
+  ZonePileRoot,
+  ZonePileTrigger,
+  ZoneRoot,
+  ZoneTopCard,
+  createZoneCardRenderItem,
+  useOptionalZonePrimitiveContext,
+  useZoneCards,
+  useZoneCardContext,
+  useZonePileContext,
+  useZonePrimitiveContext,
+  type UseZoneCardsOptions,
+  type UseZoneCardsResult,
+  type ZoneCardAtProps,
+  type ZoneCardActionExtraInputs,
+  type ZoneCardActionProps,
+  type ZoneCardActionResult,
+  type ZoneCardRenderItem,
+  type ZonePileCardsProps,
+  type ZonePileContextValue,
+  type ZonePileCountProps,
+  type ZonePileDescriptionProps,
+  type ZonePileLabelProps,
+  type ZonePileRootProps,
+  type ZonePileTriggerProps,
+  type ZoneItemProps,
+  type ZoneListProps,
+  type ZoneRootProps,
+  type ZoneTopCardProps,
+} from "./zone.js";

package/src/runtime-internal/primitives/interaction-form-binding.tsx

@@ -0,0 +1,56 @@
+import {
+  InteractionForm,
+  type InteractionFormProps,
+} from "../components/InteractionForm.js";
+import type {
+  InteractionHandle,
+  InteractionParamsShape,
+} from "../hooks/useInteractionHandle.js";
+import type { InteractionDescriptor } from "../types/plugin-state.js";
+
+export type BoundInteractionFormProps<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+> = Omit<InteractionFormProps<Params, DefaultedKeys>, "descriptor" | "handle">;
+
+export function castInteractionHandle<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>(handle: InteractionHandle): InteractionHandle<Params, DefaultedKeys> {
+  return handle as InteractionHandle<Params, DefaultedKeys>;
+}
+
+export function castInteractionDraft<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>(
+  draft: Record<string, unknown>,
+): InteractionHandle<Params, DefaultedKeys>["draft"] {
+  return draft as InteractionHandle<Params, DefaultedKeys>["draft"];
+}
+
+export function castInteractionFields<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+>(fields: readonly string[]): ReadonlyArray<keyof Params & string> {
+  return fields as ReadonlyArray<keyof Params & string>;
+}
+
+export function BoundInteractionForm<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>({
+  descriptor,
+  handle,
+  ...props
+}: BoundInteractionFormProps<Params, DefaultedKeys> & {
+  descriptor: InteractionDescriptor;
+  handle: InteractionHandle;
+}) {
+  return (
+    <InteractionForm<Params, DefaultedKeys>
+      descriptor={descriptor}
+      handle={castInteractionHandle<Params, DefaultedKeys>(handle)}
+      {...props}
+    />
+  );
+}

package/src/runtime-internal/primitives/interaction-submit.ts

@@ -0,0 +1,90 @@
+import type {
+  InteractionHandle,
+  InteractionParamsShape,
+} from "../hooks/useInteractionHandle.js";
+
+type UnhandledInteractionError = "throw" | "log" | "ignore";
+
+interface RunInteractionActionOptions<Result> {
+  onSuccess?: (result: Result) => void;
+  onError?: (error: unknown) => void;
+  unhandledError?: UnhandledInteractionError;
+}
+
+export interface InteractionSubmitCallbacks {
+  onSubmitSuccess?: () => void;
+  onSubmitError?: (error: unknown) => void;
+}
+
+export async function runInteractionAction<Result>(
+  action: () => Promise<Result>,
+  {
+    onSuccess,
+    onError,
+    unhandledError = "throw",
+  }: RunInteractionActionOptions<Result> = {},
+): Promise<void> {
+  try {
+    const result = await action();
+    onSuccess?.(result);
+  } catch (error) {
+    if (onError) {
+      onError(error);
+      return;
+    }
+    if (unhandledError === "log") {
+      console.error(error);
+      return;
+    }
+    if (unhandledError === "ignore") {
+      return;
+    }
+    throw error;
+  }
+}
+
+export function submitInteractionDraft<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>(
+  handle: InteractionHandle<Params, DefaultedKeys>,
+  callbacks: InteractionSubmitCallbacks = {},
+  options: { unhandledError?: UnhandledInteractionError } = {},
+): Promise<void> {
+  return runInteractionAction(() => handle.submitDraft(), {
+    onSuccess: callbacks.onSubmitSuccess,
+    onError: callbacks.onSubmitError,
+    unhandledError: options.unhandledError,
+  });
+}
+
+export function submitInteraction<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>(
+  handle: InteractionHandle<Params, DefaultedKeys>,
+  callbacks: InteractionSubmitCallbacks = {},
+  options: { unhandledError?: UnhandledInteractionError } = {},
+): Promise<void> {
+  return runInteractionAction(() => handle.submit(), {
+    onSuccess: callbacks.onSubmitSuccess,
+    onError: callbacks.onSubmitError,
+    unhandledError: options.unhandledError,
+  });
+}
+
+export function submitInteractionParams<
+  Params extends InteractionParamsShape = InteractionParamsShape,
+  DefaultedKeys extends keyof Params & string = never,
+>(
+  handle: InteractionHandle<Params, DefaultedKeys>,
+  params: Params,
+  callbacks: InteractionSubmitCallbacks = {},
+  options: { unhandledError?: UnhandledInteractionError } = {},
+): Promise<void> {
+  return runInteractionAction(() => handle.submit(params), {
+    onSuccess: callbacks.onSubmitSuccess,
+    onError: callbacks.onSubmitError,
+    unhandledError: options.unhandledError,
+  });
+}