@dreamboard-games/sdk 0.2.0

package/dist/chunk-GKKBPPSW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime-internal/workspace-contract.ts"],"sourcesContent":["import type { ButtonHTMLAttributes, ReactElement, ReactNode } from \"react\";\nimport { Fragment as ReactFragment, createElement, useMemo } from \"react\";\nimport { clsx } from \"clsx\";\nimport {\n  ClientParamSchemaProvider,\n  type ClientParamSchemaMap,\n} from \"./context/ClientParamSchemaContext.js\";\nimport { usePluginState } from \"./context/PluginStateContext.js\";\nimport {\n  createResourceCounter,\n  type ResourceCounterComponents,\n  type ResourceDisplayConfig,\n} from \"../ui.js\";\nimport { CardFace, type ViewCard } from \"../ui.js\";\nimport {\n  MobileHandTrayProvider,\n  useRegisterMobileHand,\n  type HandRole,\n} from \"../ui/components.js\";\nimport { ToastProvider, useIsMobile } from \"../ui.js\";\nimport {\n  createDreamboardUI,\n  type DreamboardUI,\n  type TypedGame,\n  type UIContract,\n} from \"./ui-contract.js\";\nimport {\n  useResolvedCardTargetValue,\n  useZoneCards,\n} from \"./primitives/index.js\";\nimport {\n  HandSurfaceView,\n  HandStagingView,\n  dropTargetIdFor,\n  type HandSelectionSummary,\n  type HandSurfaceViewProps,\n  type RuntimeDropTarget,\n} from \"./primitives/hand-surface.js\";\nimport type { AuthoredCardIntent } from \"./primitives/hand-intent-adapter.js\";\nimport type {\n  CardDropTargetVisualState,\n  HandInteractionPolicy,\n  HandLayoutKind,\n  HandLayoutPolicy,\n  InteractionVisualState,\n} from \"../ui.js\";\nimport type {\n  BoardHexGridProps,\n  BoardHexViewProps,\n  InteractionDialogProps,\n  InteractionFormPrimitiveProps,\n  InteractionCardInputRenderState,\n  InteractionStateProps,\n  InteractionSubmitProps,\n  InteractionTriggerProps,\n  GameMeState,\n  GamePlayersState,\n  GameRenderState,\n  GameTurnState,\n  UIRootProps,\n  ZoneCardRenderItem,\n} from \"./primitives/index.js\";\nimport type { BoardSpaceTargetProps } from \"./primitives/board.js\";\nimport type { ZoneListProps } from \"./primitives/zone.js\";\nimport type { PluginStateSnapshot } from \"./types/plugin-state.js\";\nimport { isInteractionAvailable } from \"./utils/interaction-status.js\";\n\nexport type { BoardSpaceTargetProps } from \"./primitives/board.js\";\nexport type { HandRole } from \"../ui/components.js\";\n\nexport type WorkspaceInteractionSlotComponent<Props = object> = (\n  props: Props extends { children: unknown }\n    ? Props\n    : Props & { children?: ReactNode },\n) => ReactElement | null;\n\nexport interface WorkspaceFormInputSlot<Input extends string = string> {\n  readonly Field: WorkspaceInteractionSlotComponent;\n  readonly Options: WorkspaceInteractionSlotComponent<{\n    children?: (option: { value: unknown; label: string }) => ReactNode;\n  }>;\n  readonly Value: WorkspaceInteractionSlotComponent<{\n    children: (value: unknown | undefined) => ReactNode;\n  }>;\n  readonly Default: WorkspaceInteractionSlotComponent;\n  readonly __input?: Input;\n}\n\nexport interface WorkspaceCardInputSlot<Card extends string = string> {\n  readonly Card: WorkspaceInteractionSlotComponent<\n    { value: Card } & Omit<\n      ButtonHTMLAttributes<HTMLButtonElement>,\n      | \"children\"\n      | \"disabled\"\n      | \"aria-disabled\"\n      | \"aria-pressed\"\n      | \"onClick\"\n      | \"type\"\n      | \"value\"\n    >\n  >;\n  readonly Cards: WorkspaceInteractionSlotComponent<{\n    children: (card: { id: Card }) => ReactNode;\n  }>;\n  readonly Value: WorkspaceInteractionSlotComponent<{\n    children: (value: unknown | undefined) => ReactNode;\n  }>;\n  readonly Default: WorkspaceInteractionSlotComponent;\n}\n\nexport interface WorkspaceBoardTargetInputSlot<\n  Kind extends \"space\" | \"edge\" | \"vertex\" | \"tile\",\n  Target extends string = string,\n> {\n  readonly Target: WorkspaceInteractionSlotComponent<\n    { value: Target } & Omit<\n      ButtonHTMLAttributes<HTMLButtonElement>,\n      | \"children\"\n      | \"disabled\"\n      | \"aria-disabled\"\n      | \"aria-pressed\"\n      | \"onClick\"\n      | \"type\"\n      | \"value\"\n    >\n  >;\n  readonly Value: WorkspaceInteractionSlotComponent<{\n    children: (value: unknown | undefined) => ReactNode;\n  }>;\n  readonly Default: WorkspaceInteractionSlotComponent;\n  readonly __kind?: Kind;\n}\n\nexport interface WorkspaceBoardSurface<\n  Space extends string = string,\n  Edge extends string = string,\n  Vertex extends string = string,\n  Tile extends string = string,\n> {\n  readonly Root: WorkspaceInteractionSlotComponent;\n  readonly Space: <Target extends Space>(\n    props: BoardSpaceTargetProps<Target>,\n  ) => ReactElement | null;\n  readonly slot: {\n    readonly space: WorkspaceBoardTargetInputSlot<\"space\", Space>;\n    readonly playerSpace: WorkspaceBoardTargetInputSlot<\"space\", Space>;\n    readonly edge: WorkspaceBoardTargetInputSlot<\"edge\", Edge>;\n    readonly vertex: WorkspaceBoardTargetInputSlot<\"vertex\", Vertex>;\n    readonly tile: WorkspaceBoardTargetInputSlot<\"tile\", Tile>;\n  };\n}\n\nexport type WorkspaceZoneCardsComponent<Card> =\n  WorkspaceInteractionSlotComponent<\n    Omit<ZoneListProps, \"children\" | \"empty\"> & {\n      empty?: ReactNode;\n      children: (card: Card) => ReactNode;\n    }\n  >;\n\nexport type WorkspaceZoneCardComponent<Card> =\n  WorkspaceInteractionSlotComponent<\n    Omit<ButtonHTMLAttributes<HTMLButtonElement>, \"type\" | \"value\"> & {\n      card: Card;\n    }\n  >;\n\nexport type WorkspaceZoneStagingComponent<Card> =\n  WorkspaceInteractionSlotComponent<{\n    children: (card: Card) => ReactNode;\n    label?: ReactNode;\n    renderEmptySlot?: (index: number) => ReactNode;\n    cardSize?: \"sm\" | \"md\" | \"lg\";\n    ariaLabel?: string;\n    className?: string;\n  }>;\n\nexport interface WorkspaceHandSurface<Zone extends string, Card> {\n  readonly Hand: WorkspaceZoneCardsComponent<Card>;\n  readonly Card: WorkspaceZoneCardComponent<Card>;\n  readonly Staging: WorkspaceZoneStagingComponent<Card>;\n  readonly slot: {\n    readonly card: WorkspaceCardInputSlot<Zone>;\n  };\n}\n\nexport interface WorkspaceHandOptions<Zone extends string = string> {\n  zone: Zone;\n  role: HandRole;\n  label: string;\n  order?: number;\n}\n\ninterface WorkspaceHandComponentOptions {\n  name: string;\n  zone: string;\n  role: HandRole;\n  label: string;\n  order?: number;\n}\n\nexport interface WorkspacePileSurface<Card> {\n  readonly Pile: WorkspaceZoneCardsComponent<Card>;\n  readonly Card: WorkspaceZoneCardComponent<Card>;\n}\n\nexport interface WorkspaceCardCollectionSurface<Zone extends string, Card> {\n  readonly Collection: WorkspaceZoneCardsComponent<Card>;\n  readonly Card: WorkspaceZoneCardComponent<Card>;\n  readonly slot: {\n    readonly card: WorkspaceCardInputSlot<Zone>;\n  };\n}\n\nexport interface WorkspaceBoardSurfaceDescriptor<\n  Board extends string = string,\n> {\n  readonly kind: \"board\";\n  readonly board: Board;\n}\n\nexport interface WorkspaceHandSurfaceDescriptor<Zone extends string = string> {\n  readonly kind: \"hand\";\n  readonly zone: Zone;\n  readonly role: HandRole;\n  readonly label: string;\n  readonly order?: number;\n}\n\nexport interface WorkspacePileSurfaceDescriptor<Zone extends string = string> {\n  readonly kind: \"pile\";\n  readonly zone: Zone;\n}\n\nexport interface WorkspacePilesSurfaceDescriptor<\n  Zones extends readonly string[] = readonly string[],\n> {\n  readonly kind: \"piles\";\n  readonly zones: Zones;\n}\n\nexport interface WorkspaceCardCollectionSurfaceDescriptor<\n  Zones extends readonly string[] = readonly string[],\n> {\n  readonly kind: \"cardCollection\";\n  readonly zones: Zones;\n  readonly mode?: \"all\" | \"top-card\";\n}\n\nexport interface WorkspaceInteractionFormsDescriptor<\n  Interactions extends Readonly<Record<string, string>> = Readonly<\n    Record<string, string>\n  >,\n> {\n  readonly kind: \"forms\";\n  readonly interactions: Interactions;\n}\n\nexport interface WorkspaceInteractionFormDescriptor<\n  Interaction extends string = string,\n> {\n  readonly kind: \"form\";\n  readonly interaction: Interaction;\n}\n\nexport type WorkspaceSurfaceDescriptor =\n  | WorkspaceBoardSurfaceDescriptor\n  | WorkspaceHandSurfaceDescriptor\n  | WorkspacePileSurfaceDescriptor\n  | WorkspacePilesSurfaceDescriptor\n  | WorkspaceCardCollectionSurfaceDescriptor\n  | WorkspaceInteractionFormDescriptor\n  | WorkspaceInteractionFormsDescriptor;\n\nexport interface WorkspaceSurfaceSpec {\n  readonly [key: string]: WorkspaceSurfaceDescriptor | WorkspaceSurfaceSpec;\n}\n\ntype RuntimeInteraction = DreamboardUI[\"Interaction\"] & {\n  Root(props: {\n    interaction: string;\n    children?: ReactNode;\n    unavailable?: \"render\" | \"hide\";\n  }): ReactElement | null;\n  CardInput(\n    props: Omit<\n      ButtonHTMLAttributes<HTMLButtonElement>,\n      \"type\" | \"value\" | \"children\"\n    > & {\n      input: string;\n      unsafeCardId?: string;\n      children?:\n        | ReactNode\n        | ((state: InteractionCardInputRenderState) => ReactNode);\n    },\n  ): ReactElement | null;\n  Routes(props: {\n    routes: Record<string, { collect: Record<string, unknown> }>;\n    fallback?: ReactNode;\n    includeUnavailable?: boolean | null;\n  }): ReactElement;\n};\n\ntype RuntimeBoard = DreamboardUI[\"Board\"] & {\n  SpaceTarget(props: BoardSpaceTargetProps<string>): ReactElement | null;\n  EdgeTarget(\n    props: { value: string; children?: ReactNode } & Omit<\n      ButtonHTMLAttributes<HTMLButtonElement>,\n      | \"type\"\n      | \"value\"\n      | \"children\"\n      | \"disabled\"\n      | \"aria-disabled\"\n      | \"aria-pressed\"\n      | \"onClick\"\n      | \"onSelect\"\n      | \"onSelectError\"\n    >,\n  ): ReactElement | null;\n  VertexTarget(\n    props: { value: string; children?: ReactNode } & Omit<\n      ButtonHTMLAttributes<HTMLButtonElement>,\n      | \"type\"\n      | \"value\"\n      | \"children\"\n      | \"disabled\"\n      | \"aria-disabled\"\n      | \"aria-pressed\"\n      | \"onClick\"\n      | \"onSelect\"\n      | \"onSelectError\"\n    >,\n  ): ReactElement | null;\n};\n\ntype RuntimeZone<Card> = DreamboardUI[\"Zone\"] & {\n  List(\n    props: Omit<ZoneListProps, \"children\" | \"empty\"> & {\n      empty?: ReactNode;\n      children: (card: Card) => ReactNode;\n    },\n  ): ReactElement | null;\n};\n\nconst DEFAULT_ZONE_CARD_CLASS =\n  \"group relative border-0 bg-transparent p-0 transition-transform enabled:cursor-pointer enabled:hover:-translate-y-2 data-[selected=true]:-translate-y-3 disabled:cursor-not-allowed data-[eligible=false]:opacity-45 data-[eligible=false]:grayscale data-[eligible=false]:hover:translate-y-0 data-[card-available=false]:opacity-45 data-[card-available=false]:grayscale\";\n\nfunction cardRenderItemToViewCard(card: unknown, cardId: string): ViewCard {\n  if (\n    card &&\n    typeof card === \"object\" &&\n    \"hidden\" in card &&\n    (card as { hidden?: unknown }).hidden === false\n  ) {\n    return card as unknown as ViewCard;\n  }\n  return {\n    id: cardId,\n    cardType: \"hidden\",\n    name: \"Hidden card\",\n    properties: {},\n  };\n}\n\nexport interface WorkspaceContractOptions<\n  Contract extends UIContract,\n  Resource extends string,\n  Card,\n  HexBoards extends Record<string, unknown>,\n> {\n  readonly uiContract: Contract;\n  readonly clientParamSchemasByPhase?: ClientParamSchemaMap;\n  readonly formInputKeysForInteraction: (\n    interaction: string,\n  ) => ReadonlySet<string>;\n  readonly resourceIds: readonly Resource[];\n  readonly resourcePresentationById?: Partial<\n    Record<string, { label?: string; icon?: string }>\n  >;\n  readonly hexStaticBoards: HexBoards;\n  readonly cardIdFromZoneCard: (card: Card) => string;\n  readonly zoneIdFromZoneCard: (card: Card) => string;\n}\n\n/**\n * Render-prop body for the card surface `slot.card.Value`. Surfaces the live\n * draft value for the active interaction's card-target input — the selected\n * card-id array for `selection: \"many\"` collectors, or the single id for\n * `selection: \"one\"`. Renders nothing meaningful (`undefined`) outside an\n * `<Interaction.Root>`.\n */\nfunction CardSlotValue({\n  children,\n}: {\n  children: (value: unknown | undefined) => ReactNode;\n}): ReactElement {\n  const value = useResolvedCardTargetValue();\n  return createElement(ReactFragment, null, children(value));\n}\n\nexport function createWorkspaceUIContract<\n  WorkspaceUI,\n  Contract extends UIContract,\n  Resource extends string,\n  Card,\n  HexBoards extends Record<string, unknown>,\n>(\n  options: WorkspaceContractOptions<Contract, Resource, Card, HexBoards>,\n): WorkspaceUI {\n  const baseUI = createDreamboardUI(options.uiContract);\n  const runtimeInteraction = baseUI.Interaction as RuntimeInteraction;\n  const runtimeBoard = baseUI.Board as RuntimeBoard;\n  const runtimeZone = baseUI.Zone as RuntimeZone<Card>;\n\n  const resourceDisplayConfig = options.resourceIds.map((resource) => {\n    const presentation = options.resourcePresentationById?.[resource];\n    return {\n      type: resource,\n      label: presentation?.label ?? resource,\n      icon: presentation?.icon ?? resource,\n    };\n  }) satisfies ReadonlyArray<ResourceDisplayConfig<Resource>>;\n  const resourceCounter = createResourceCounter<Resource>(\n    resourceDisplayConfig,\n  );\n\n  function InteractionRoutes({\n    routes,\n    fallback,\n    includeUnavailable,\n  }: {\n    routes: Record<\n      string,\n      {\n        collect: Record<string, unknown>;\n      }\n    >;\n    fallback?: ReactNode;\n    includeUnavailable?: boolean | null;\n  }): ReactElement {\n    return createElement(runtimeInteraction.Routes, {\n      routes,\n      fallback,\n      includeUnavailable,\n    });\n  }\n\n  const withInteractionRoot = (interaction: string, children: ReactNode) =>\n    createElement(runtimeInteraction.Root, {\n      interaction,\n      children,\n    });\n\n  function createFormInputSlot(\n    input: string,\n    interaction?: string,\n  ): WorkspaceFormInputSlot {\n    return {\n      Field: (props: { children?: ReactNode }) => {\n        const field = createElement(baseUI.Interaction.Field, {\n          ...props,\n          input: input as never,\n        });\n        return interaction ? withInteractionRoot(interaction, field) : field;\n      },\n      Options: () => null,\n      Value: ({\n        children,\n      }: {\n        children: (value: unknown | undefined) => ReactNode;\n      }) => createElement(ReactFragment, null, children(undefined)),\n      Default: ({ children }: { children?: ReactNode }) =>\n        createElement(ReactFragment, null, children),\n    };\n  }\n\n  function createCardInputSlot(): WorkspaceCardInputSlot {\n    return {\n      Card: ({ value, ...props }: { value: string; children?: ReactNode }) =>\n        createElement(runtimeInteraction.CardInput, {\n          ...props,\n          input: \"cardId\",\n          unsafeCardId: value,\n        }),\n      Cards: () => null,\n      Value: ({\n        children,\n      }: {\n        children: (value: unknown | undefined) => ReactNode;\n      }) => createElement(CardSlotValue, { children }),\n      Default: ({ children }: { children?: ReactNode }) =>\n        createElement(ReactFragment, null, children),\n    };\n  }\n\n  function createBoardTargetInputSlot(\n    kind: \"space\" | \"edge\" | \"vertex\" | \"tile\",\n  ): WorkspaceBoardTargetInputSlot<typeof kind> {\n    const Target = ({\n      value,\n      ...props\n    }: {\n      value: string;\n      children?: ReactNode;\n    }) => {\n      if (kind === \"edge\") {\n        return createElement(runtimeBoard.EdgeTarget, { ...props, value });\n      }\n      if (kind === \"vertex\") {\n        return createElement(runtimeBoard.VertexTarget, { ...props, value });\n      }\n      return createElement(runtimeBoard.SpaceTarget, { ...props, value });\n    };\n    return {\n      Target,\n      Value: ({\n        children,\n      }: {\n        children: (value: unknown | undefined) => ReactNode;\n      }) => createElement(ReactFragment, null, children(undefined)),\n      Default: ({ children }: { children?: ReactNode }) =>\n        createElement(ReactFragment, null, children),\n    };\n  }\n\n  function useInteractionFormSurface(interaction: string) {\n    const validInputs = options.formInputKeysForInteraction(interaction);\n    const slot = Object.fromEntries(\n      [...validInputs].map((input) => [\n        input,\n        createFormInputSlot(input, interaction),\n      ]),\n    );\n    return {\n      Root: ({ children }: { children?: ReactNode }) =>\n        withInteractionRoot(interaction, children),\n      Form: (props: InteractionFormPrimitiveProps) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.Form, props),\n        ),\n      Dialog: (props: InteractionDialogProps) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.Dialog, props),\n        ),\n      State: (props: InteractionStateProps) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.State, props),\n        ),\n      Arm: (props: InteractionTriggerProps) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.Trigger, props),\n        ),\n      Submit: (props: InteractionSubmitProps) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.Submit, props),\n        ),\n      Field: ({ input, ...props }: { input: string; children?: ReactNode }) =>\n        withInteractionRoot(\n          interaction,\n          createElement(baseUI.Interaction.Field, {\n            ...props,\n            input: input as never,\n          }),\n        ),\n      slot,\n    };\n  }\n\n  function useBoardSurface(_name: string) {\n    return {\n      Root: ({ children }: { children?: ReactNode }) =>\n        createElement(baseUI.Board.Root, { children }),\n      Space: (props: BoardSpaceTargetProps<string>) =>\n        createElement(runtimeBoard.SpaceTarget, props),\n      slot: {\n        space: createBoardTargetInputSlot(\"space\"),\n        playerSpace: createBoardTargetInputSlot(\"space\"),\n        edge: createBoardTargetInputSlot(\"edge\"),\n        vertex: createBoardTargetInputSlot(\"vertex\"),\n        tile: createBoardTargetInputSlot(\"tile\"),\n      },\n    };\n  }\n\n  function createZoneCardsComponent(zones: readonly string[]) {\n    return ({\n      empty,\n      children,\n      ...props\n    }: {\n      empty?: ReactNode;\n      children: (card: Card) => ReactNode;\n    } & Omit<ZoneListProps, \"children\" | \"empty\">) =>\n      createElement(\n        ReactFragment,\n        null,\n        ...zones.map((zone) =>\n          createElement(baseUI.Zone.Root, {\n            key: zone,\n            zone: zone as never,\n            children: createElement(runtimeZone.List, {\n              ...props,\n              empty,\n              children,\n            }),\n          }),\n        ),\n      );\n  }\n\n  function createHandCardsComponent(options: WorkspaceHandComponentOptions) {\n    return ({\n      empty,\n      children,\n      className,\n      layout,\n      mobileInteraction,\n      cardSize,\n      ariaLabel,\n      dropTargets,\n      renderDropTargets,\n      onCardIntent,\n      renderSummary,\n      renderActions,\n      onSelectionSummary,\n      ...props\n    }: {\n      empty?: ReactNode;\n      children: (card: Card, state: InteractionVisualState) => ReactNode;\n      className?: string;\n      layout?: HandLayoutKind | HandLayoutPolicy;\n      mobileInteraction?: HandInteractionPolicy;\n      cardSize?: \"sm\" | \"md\" | \"lg\";\n      ariaLabel?: string;\n      dropTargets?: ReadonlyArray<{\n        target:\n          | { kind: \"card\"; card: string }\n          | { kind: \"space\"; target: string }\n          | { kind: \"edge\"; target: string }\n          | { kind: \"vertex\"; target: string }\n          | { kind: \"tile\"; target: string };\n        label: string;\n        render: (state: CardDropTargetVisualState) => ReactNode;\n        className?: string;\n        role?: string;\n        order?: number;\n      }>;\n      renderDropTargets?: (children: ReactNode) => ReactNode;\n      onCardIntent?: (intent: AuthoredCardIntent) => void;\n      renderSummary?: (summary: HandSelectionSummary) => ReactNode;\n      renderActions?: (summary: HandSelectionSummary) => ReactNode;\n      onSelectionSummary?: (summary: HandSelectionSummary) => void;\n    } & Omit<ZoneListProps, \"children\" | \"empty\">) =>\n      createElement(baseUI.Zone.Root, {\n        zone: options.zone as never,\n        // Fill the author's container instead of shrink-wrapping to the fan's\n        // own measured width. Without a definite width here, a centering parent\n        // sizes to the cards row, the hand measures that, recomputes a new fan\n        // width, and the layout chases itself (a ResizeObserver loop). `w-full`\n        // pins the outermost hand element to the available width and breaks the\n        // cycle for every author layout.\n        className: \"w-full min-w-0\",\n        children: createElement(GeneratedHandCards, {\n          ...props,\n          hand: options,\n          className,\n          empty,\n          children,\n          layout,\n          mobileInteraction,\n          cardSize,\n          ariaLabel,\n          dropTargets,\n          renderDropTargets,\n          onCardIntent,\n          renderSummary,\n          renderActions,\n          onSelectionSummary,\n        }),\n      });\n  }\n\n  function GeneratedHandCards({\n    hand,\n    empty,\n    children,\n    className,\n    sort,\n    layout,\n    mobileInteraction,\n    cardSize,\n    ariaLabel,\n    dropTargets,\n    renderDropTargets,\n    onCardIntent,\n    renderSummary,\n    renderActions,\n    onSelectionSummary,\n  }: {\n    hand: WorkspaceHandComponentOptions;\n    empty?: ReactNode;\n    children: (card: Card, state: InteractionVisualState) => ReactNode;\n    className?: string;\n    layout?: HandLayoutKind | HandLayoutPolicy;\n    mobileInteraction?: HandInteractionPolicy;\n    cardSize?: \"sm\" | \"md\" | \"lg\";\n    ariaLabel?: string;\n    dropTargets?: ReadonlyArray<{\n      target:\n        | { kind: \"card\"; card: string }\n        | { kind: \"space\"; target: string }\n        | { kind: \"edge\"; target: string }\n        | { kind: \"vertex\"; target: string }\n        | { kind: \"tile\"; target: string };\n      label: string;\n      render: (state: CardDropTargetVisualState) => ReactNode;\n      className?: string;\n      role?: string;\n      order?: number;\n    }>;\n    renderDropTargets?: (children: ReactNode) => ReactNode;\n    onCardIntent?: (intent: AuthoredCardIntent) => void;\n    renderSummary?: (summary: HandSelectionSummary) => ReactNode;\n    renderActions?: (summary: HandSelectionSummary) => ReactNode;\n    onSelectionSummary?: (summary: HandSelectionSummary) => void;\n  } & Omit<ZoneListProps, \"children\" | \"empty\">) {\n    const isMobile = useIsMobile();\n    const { items, count } = useZoneCards({ sort });\n    // One predictable presentation for every hand: the projected surface\n    // (fan on desktop, tray on mobile by default). Authors choose other shapes\n    // explicitly with `layout` (e.g. layout=\"strip\"). We no longer fall back to\n    // a bare scroll strip when no interaction props are passed, so the layout —\n    // and the eligible/selected projection — stays consistent across phases.\n    const handClassName = clsx(\"min-h-[112px]\", className);\n    const resolvedDropTargets = useMemo<RuntimeDropTarget[] | undefined>(() => {\n      if (!dropTargets || dropTargets.length === 0) return undefined;\n      return dropTargets.map((dt) => {\n        const value =\n          dt.target.kind === \"card\" ? dt.target.card : dt.target.target;\n        return {\n          targetId: dropTargetIdFor(dt.target.kind, value),\n          label: dt.label,\n          render: dt.render,\n          className: dt.className,\n          role: dt.role,\n          order: dt.order,\n        };\n      });\n    }, [dropTargets]);\n    const content = useMemo(\n      () =>\n        createElement(HandSurfaceView, {\n          zone: hand.zone,\n          cards: items,\n          renderCard: (card, state, _index) => children(card as Card, state),\n          layout,\n          mobileInteraction,\n          dropTargets: resolvedDropTargets,\n          renderDropTargets,\n          cardSize,\n          renderEmpty: empty !== undefined ? () => empty : undefined,\n          ariaLabel,\n          onIntentRouted: onCardIntent\n            ? (intent) => onCardIntent(intent)\n            : undefined,\n          renderSummary,\n          renderActions,\n          onSelectionSummary,\n          className: handClassName,\n        } satisfies HandSurfaceViewProps<(typeof items)[number]>),\n      [\n        ariaLabel,\n        cardSize,\n        children,\n        empty,\n        hand.zone,\n        handClassName,\n        items,\n        layout,\n        mobileInteraction,\n        onCardIntent,\n        onSelectionSummary,\n        renderActions,\n        renderDropTargets,\n        renderSummary,\n        resolvedDropTargets,\n      ],\n    );\n    const active = items.some(\n      (item) =>\n        !item.hidden &&\n        item.interactions.some((descriptor) =>\n          isInteractionAvailable(descriptor),\n        ),\n    );\n    const autoOpen = items.some(\n      (item) =>\n        !item.hidden &&\n        item.interactions.some(\n          (descriptor) =>\n            isInteractionAvailable(descriptor) &&\n            descriptor.inputs.some(\n              (input) =>\n                input.domain.type === \"cardTarget\" &&\n                input.domain.selection?.mode === \"many\",\n            ),\n        ),\n    );\n    const version = items\n      .map((item) =>\n        item.hidden\n          ? `${item.id}:hidden`\n          : `${item.id}:${item.cardType}:${JSON.stringify(item.properties)}`,\n      )\n      .join(\"|\");\n    const registration = useMemo(\n      () => ({\n        id: `${hand.name}:${hand.zone}`,\n        zone: hand.zone,\n        label: hand.label,\n        role: hand.role,\n        order: hand.order,\n        version,\n        count,\n        active,\n        autoOpen,\n        content: createElement(baseUI.Zone.Root, {\n          zone: hand.zone as never,\n          children: content,\n        }),\n      }),\n      [\n        active,\n        autoOpen,\n        content,\n        count,\n        hand.label,\n        hand.name,\n        hand.order,\n        hand.role,\n        hand.zone,\n        version,\n      ],\n    );\n    useRegisterMobileHand(registration);\n\n    return isMobile ? null : content;\n  }\n\n  function createZoneCardComponent() {\n    return ({\n      card,\n      children,\n      className,\n      ...props\n    }: {\n      card: Card;\n      children?: ReactNode;\n    } & Omit<ButtonHTMLAttributes<HTMLButtonElement>, \"type\" | \"value\">) => {\n      const cardId = options.cardIdFromZoneCard(card);\n      const zone = options.zoneIdFromZoneCard(card);\n      const viewCard = cardRenderItemToViewCard(card, cardId);\n      const faceDown =\n        !!card &&\n        typeof card === \"object\" &&\n        \"hidden\" in card &&\n        (card as { hidden?: unknown }).hidden === true;\n      const renderCardFace = (state: InteractionCardInputRenderState) =>\n        createElement(CardFace, {\n          card: viewCard,\n          selected: state.selected,\n          disabled: state.disabled || !state.eligible,\n          faceDown,\n          size: \"sm\",\n          children,\n        });\n      const match = usePluginState((state: PluginStateSnapshot) => {\n        const candidates =\n          state.gameplay.zones[zone]?.playableByCardId[cardId] ?? [];\n        for (const descriptor of candidates) {\n          const input = descriptor.inputs.find(\n            (candidateInput) =>\n              candidateInput.domain.type === \"cardTarget\" &&\n              candidateInput.domain.projection === \"resolved\" &&\n              candidateInput.domain.eligibleTargets.includes(cardId),\n          );\n          if (input) return { descriptor, input };\n        }\n        return null;\n      });\n      if (!match) {\n        return createElement(\n          \"div\",\n          {\n            ...props,\n            className: clsx(\"relative inline-flex\", className),\n            \"data-dreamboard-zone-card\": \"\",\n            \"data-card-id\": cardId,\n            \"data-zone\": zone,\n            \"data-interactive\": false,\n          },\n          createElement(CardFace, {\n            card: viewCard,\n            faceDown,\n            size: \"sm\",\n            children,\n          }),\n        );\n      }\n      return createElement(baseUI.Zone.Root, {\n        zone: zone as never,\n        children: createElement(runtimeInteraction.Root, {\n          interaction: match.descriptor.interactionKey,\n          children: createElement(runtimeInteraction.CardInput, {\n            ...props,\n            className: clsx(DEFAULT_ZONE_CARD_CLASS, className),\n            input: match.input.key,\n            unsafeCardId: cardId,\n            children: renderCardFace,\n          }),\n        }),\n      });\n    };\n  }\n\n  const Board = {\n    surface<Board extends string>(\n      board: Board,\n    ): WorkspaceBoardSurfaceDescriptor<Board> {\n      return { kind: \"board\", board };\n    },\n    useSurface: useBoardSurface,\n    HexView({ board: boardId, ...props }: { board: string }) {\n      return createElement(\n        baseUI.Board.HexView as never,\n        {\n          ...props,\n          board: options.hexStaticBoards[boardId],\n        } as BoardHexViewProps<never, never>,\n      ) as ReactElement;\n    },\n    HexGrid({ board: boardId, ...props }: { board: string }) {\n      return createElement(\n        baseUI.Board.HexGrid as never,\n        {\n          ...props,\n          board: options.hexStaticBoards[boardId],\n        } as BoardHexGridProps<never, never>,\n      ) as ReactElement;\n    },\n  };\n\n  function createStagingComponent(options: WorkspaceHandComponentOptions) {\n    return ({\n      children,\n      label,\n      renderEmptySlot,\n      cardSize,\n      ariaLabel,\n      className,\n    }: {\n      children: (card: Card) => ReactNode;\n      label?: ReactNode;\n      renderEmptySlot?: (index: number) => ReactNode;\n      cardSize?: \"sm\" | \"md\" | \"lg\";\n      ariaLabel?: string;\n      className?: string;\n    }) =>\n      createElement(HandStagingView, {\n        zone: options.zone,\n        renderCard: (card) => children(card as Card),\n        renderEmptySlot,\n        label,\n        cardSize,\n        ariaLabel,\n        className,\n      });\n  }\n\n  const Zone = {\n    hand<Zone extends string>(\n      zone: Zone,\n      options: Omit<WorkspaceHandSurfaceDescriptor<Zone>, \"kind\" | \"zone\">,\n    ): WorkspaceHandSurfaceDescriptor<Zone> {\n      return { kind: \"hand\", zone, ...options };\n    },\n    pile<Zone extends string>(\n      zone: Zone,\n    ): WorkspacePileSurfaceDescriptor<Zone> {\n      return { kind: \"pile\", zone };\n    },\n    piles<const Zones extends readonly string[]>(\n      zones: Zones,\n    ): WorkspacePilesSurfaceDescriptor<Zones> {\n      return { kind: \"piles\", zones };\n    },\n    collection<const Zones extends readonly string[]>(\n      zones: Zones,\n      options: { mode?: \"all\" | \"top-card\" } = {},\n    ): WorkspaceCardCollectionSurfaceDescriptor<Zones> {\n      return { kind: \"cardCollection\", zones, mode: options.mode };\n    },\n    useHand(_name: string, zoneOptions: WorkspaceHandOptions) {\n      const handComponentOptions = {\n        name: _name,\n        zone: zoneOptions.zone,\n        role: zoneOptions.role,\n        label: zoneOptions.label,\n        order: zoneOptions.order,\n      };\n      return {\n        Hand: createHandCardsComponent(handComponentOptions),\n        Card: createZoneCardComponent(),\n        Staging: createStagingComponent(handComponentOptions),\n        slot: { card: createCardInputSlot() },\n      };\n    },\n    usePile(_name: string, zoneOptions: { zone: string }) {\n      return {\n        Pile: createZoneCardsComponent([zoneOptions.zone]),\n        Card: createZoneCardComponent(),\n      };\n    },\n    useCardCollection(\n      _name: string,\n      zoneOptions: { zones: readonly string[]; mode?: \"all\" | \"top-card\" },\n    ) {\n      void zoneOptions.mode;\n      return {\n        Collection: createZoneCardsComponent(zoneOptions.zones),\n        Card: createZoneCardComponent(),\n        slot: { card: createCardInputSlot() },\n      };\n    },\n  };\n\n  const Interaction = {\n    State: baseUI.Interaction.State,\n    Dialog: baseUI.Interaction.Dialog,\n    useForm: useInteractionFormSurface,\n    form<const Interaction extends string>(\n      interaction: Interaction,\n    ): WorkspaceInteractionFormDescriptor<Interaction> {\n      return { kind: \"form\", interaction };\n    },\n    forms<const Interactions extends Readonly<Record<string, string>>>(\n      interactions: Interactions,\n    ): WorkspaceInteractionFormsDescriptor<Interactions> {\n      return { kind: \"forms\", interactions };\n    },\n    Routes: InteractionRoutes,\n  };\n\n  function isPlainObject(value: unknown): value is Record<string, unknown> {\n    return !!value && typeof value === \"object\" && !Array.isArray(value);\n  }\n\n  function isSurfaceDescriptor(\n    value: unknown,\n  ): value is WorkspaceSurfaceDescriptor {\n    return (\n      isPlainObject(value) &&\n      typeof (value as { kind?: unknown }).kind === \"string\"\n    );\n  }\n\n  function resolveSurfaceDescriptor(\n    name: string,\n    descriptor: WorkspaceSurfaceDescriptor,\n  ): unknown {\n    switch (descriptor.kind) {\n      case \"board\":\n        return Board.useSurface(name);\n      case \"hand\":\n        return Zone.useHand(name, {\n          zone: descriptor.zone,\n          role: descriptor.role,\n          label: descriptor.label,\n          order: descriptor.order,\n        });\n      case \"pile\":\n        return Zone.usePile(name, { zone: descriptor.zone });\n      case \"piles\":\n        return Object.fromEntries(\n          descriptor.zones.map((zone) => [\n            zone,\n            Zone.usePile(String(zone), { zone }),\n          ]),\n        );\n      case \"cardCollection\":\n        return Zone.useCardCollection(name, {\n          zones: descriptor.zones,\n          mode: descriptor.mode,\n        });\n      case \"form\":\n        return useInteractionFormSurface(descriptor.interaction);\n      case \"forms\":\n        return Object.fromEntries(\n          Object.entries(descriptor.interactions).map(([key, interaction]) => [\n            key,\n            useInteractionFormSurface(interaction),\n          ]),\n        );\n    }\n  }\n\n  function resolveSurfaceSpec(spec: WorkspaceSurfaceSpec): unknown {\n    return Object.fromEntries(\n      Object.entries(spec).map(([key, value]) => [\n        key,\n        isSurfaceDescriptor(value)\n          ? resolveSurfaceDescriptor(key, value)\n          : resolveSurfaceSpec(value as WorkspaceSurfaceSpec),\n      ]),\n    );\n  }\n\n  function defineSurfaces<const Spec extends WorkspaceSurfaceSpec>(spec: Spec) {\n    return function useDefinedSurfaces() {\n      return resolveSurfaceSpec(spec);\n    };\n  }\n\n  const UI = {\n    ...baseUI,\n    Root: ({ children, ...props }: UIRootProps) =>\n      createElement(ClientParamSchemaProvider, {\n        schemas: options.clientParamSchemasByPhase,\n        children: createElement(ToastProvider, {\n          children: createElement(MobileHandTrayProvider, {\n            children: createElement(baseUI.Root, { ...props, children }),\n          }),\n        }),\n      }),\n    defineSurfaces,\n    Interaction,\n    Board,\n    Zone,\n    ResourceCounter: resourceCounter,\n  };\n\n  return UI as WorkspaceUI;\n}\n\nexport type {\n  BoardHexGridProps,\n  BoardHexViewProps,\n  ClientParamSchemaMap,\n  DreamboardUI,\n  GameMeState,\n  GamePlayersState,\n  GameRenderState,\n  GameTurnState,\n  InteractionDialogProps,\n  InteractionFormPrimitiveProps,\n  InteractionStateProps,\n  InteractionSubmitProps,\n  InteractionTriggerProps,\n  ResourceCounterComponents,\n  TypedGame,\n  UIContract,\n  UIRootProps,\n  ZoneCardRenderItem,\n  ZoneListProps,\n};\n"],"mappings":"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","names":["options"]}

package/dist/chunk-I46YJSOD.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-I46YJSOD.js.map

package/dist/chunk-I46YJSOD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-KAELH4KC.js

@@ -0,0 +1,104 @@
+import {
+  useTheme
+} from "./chunk-WYPQ3GG5.js";
+
+// src/ui/helpers/track-board.ts
+function positionForLayout(layout, index, count) {
+  if (layout.type === "linear") {
+    const spacing = layout.spacing ?? 72;
+    const origin = layout.origin ?? { x: 0, y: 0 };
+    return layout.axis === "y" ? { x: origin.x, y: origin.y + index * spacing } : { x: origin.x + index * spacing, y: origin.y };
+  }
+  const startAngleDeg = layout.startAngleDeg ?? -90;
+  const clockwise = layout.clockwise ?? true;
+  const angleStep = count === 0 ? 0 : 360 / count;
+  const angleDeg = startAngleDeg + (clockwise ? 1 : -1) * angleStep * index;
+  const angle = angleDeg * Math.PI / 180;
+  return {
+    x: layout.center.x + Math.cos(angle) * layout.radius,
+    y: layout.center.y + Math.sin(angle) * layout.radius
+  };
+}
+function defaultNextSpaces(board, spaceId) {
+  const relations = board.relations ?? [];
+  return relations.flatMap((relation) => {
+    if (relation.fromSpaceId === spaceId) {
+      return [relation.toSpaceId];
+    }
+    if (!relation.directed && relation.toSpaceId === spaceId) {
+      return [relation.fromSpaceId];
+    }
+    return [];
+  });
+}
+function toTrackBoardData(board, options) {
+  const spaces = Object.values(board.spaces);
+  const orderedSpaces = [...spaces].sort(
+    (left, right) => left.id.localeCompare(right.id)
+  );
+  return {
+    spaces: orderedSpaces.map((space, index, allSpaces) => ({
+      id: space.id,
+      index,
+      name: space.name ?? void 0,
+      type: space.typeId ?? void 0,
+      nextSpaces: options.getNextSpaces?.(space, board) ?? defaultNextSpaces(board, space.id),
+      jumpTo: options.getJumpTo?.(space, board),
+      position: "getPosition" in options && options.getPosition ? options.getPosition(space, index, allSpaces) : positionForLayout(options.layout, index, allSpaces.length),
+      data: space.fields
+    })),
+    pieces: (options.pieces ?? []).map((piece) => ({
+      id: piece.id,
+      spaceId: piece.spaceId,
+      owner: piece.owner,
+      type: piece.typeId ?? void 0,
+      data: piece.fields
+    }))
+  };
+}
+
+// src/ui/theme/board.ts
+import { useMemo } from "react";
+function useBoardTheme() {
+  const theme = useTheme();
+  return useMemo(() => deriveBoardTheme(theme), [theme]);
+}
+function deriveBoardTheme(theme) {
+  return {
+    frameBorder: theme.component.board.frameBorder,
+    frameBackground: theme.component.board.frameBackground,
+    hoverRing: theme.component.board.hoverRing,
+    eligibleHint: theme.component.board.eligibleHint,
+    tileBorder: theme.semantic.border.default,
+    tileBorderSubtle: theme.semantic.border.subtle,
+    tileText: theme.semantic.text.primary,
+    ringWidth: 3
+  };
+}
+
+// src/ui/types/hex-color.ts
+var HEX_COLOR_PATTERN = /^#[0-9A-Fa-f]{6}$/;
+function isHexColor(value) {
+  return typeof value === "string" && HEX_COLOR_PATTERN.test(value);
+}
+function parseHexColor(value) {
+  return isHexColor(value) ? value : void 0;
+}
+function hexColor(value) {
+  if (!isHexColor(value)) {
+    throw new Error(
+      `Expected a 6-digit hex color such as #E53935, received '${value}'.`
+    );
+  }
+  return value;
+}
+
+export {
+  toTrackBoardData,
+  useBoardTheme,
+  deriveBoardTheme,
+  isHexColor,
+  parseHexColor,
+  hexColor
+};
+//# sourceMappingURL=chunk-KAELH4KC.js.map

package/dist/chunk-KAELH4KC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ui/helpers/track-board.ts","../src/ui/theme/board.ts","../src/ui/types/hex-color.ts"],"sourcesContent":["import type { TrackPiece, TrackSpace } from \"../components/board/TrackBoard.js\";\n\ninterface GenericBoardSpaceLike<\n  SpaceIdValue extends string = string,\n  Fields = Record<string, unknown>,\n> {\n  id: SpaceIdValue;\n  name?: string | null;\n  typeId?: string | null;\n  fields: Fields;\n}\n\ninterface GenericBoardRelationLike<SpaceIdValue extends string = string> {\n  fromSpaceId: SpaceIdValue;\n  toSpaceId: SpaceIdValue;\n  directed: boolean;\n}\n\nexport interface GenericBoardLike<\n  BoardIdValue extends string = string,\n  SpaceIdValue extends string = string,\n  SpaceFields = Record<string, unknown>,\n> {\n  id: BoardIdValue;\n  spaces: Readonly<\n    Record<SpaceIdValue, GenericBoardSpaceLike<SpaceIdValue, SpaceFields>>\n  >;\n  relations?: ReadonlyArray<GenericBoardRelationLike<SpaceIdValue>>;\n}\n\nexport interface TrackBoardPieceLike<\n  PieceIdValue extends string = string,\n  SpaceIdValue extends string = string,\n  OwnerIdValue extends string = string,\n  Fields = unknown,\n> {\n  id: PieceIdValue;\n  spaceId: SpaceIdValue;\n  owner: OwnerIdValue;\n  typeId?: string | null;\n  fields?: Fields;\n}\n\ntype BoardSpaceOf<TBoard extends GenericBoardLike> =\n  TBoard[\"spaces\"][keyof TBoard[\"spaces\"]];\ntype SpaceIdOf<TBoard extends GenericBoardLike> =\n  BoardSpaceOf<TBoard> extends {\n    id: infer Id extends string;\n  }\n    ? Id\n    : never;\ntype SpaceFieldsOf<TBoard extends GenericBoardLike> =\n  BoardSpaceOf<TBoard> extends { fields: infer Fields } ? Fields : never;\ntype PieceIdOf<TPiece extends TrackBoardPieceLike> = TPiece extends {\n  id: infer Id extends string;\n}\n  ? Id\n  : never;\ntype PieceOwnerOf<TPiece extends TrackBoardPieceLike> = TPiece extends {\n  owner: infer Owner extends string;\n}\n  ? Owner\n  : never;\ntype PieceFieldsOf<TPiece extends TrackBoardPieceLike> = TPiece extends {\n  fields?: infer Fields;\n}\n  ? Fields\n  : never;\n\ntype TrackLayout =\n  | {\n      type: \"linear\";\n      axis?: \"x\" | \"y\";\n      spacing?: number;\n      origin?: { x: number; y: number };\n    }\n  | {\n      type: \"circular\";\n      center: { x: number; y: number };\n      radius: number;\n      startAngleDeg?: number;\n      clockwise?: boolean;\n    };\n\ntype PositionOptions<TBoard extends GenericBoardLike> =\n  | {\n      getPosition: (\n        space: BoardSpaceOf<TBoard>,\n        index: number,\n        spaces: ReadonlyArray<BoardSpaceOf<TBoard>>,\n      ) => { x: number; y: number };\n      layout?: never;\n    }\n  | {\n      getPosition?: never;\n      layout: TrackLayout;\n    };\n\nexport type ToTrackBoardDataOptions<\n  TBoard extends GenericBoardLike,\n  TPiece extends TrackBoardPieceLike<\n    string,\n    SpaceIdOf<TBoard>,\n    string,\n    unknown\n  >,\n> = PositionOptions<TBoard> & {\n  pieces?: readonly TPiece[];\n  getNextSpaces?: (\n    space: BoardSpaceOf<TBoard>,\n    board: TBoard,\n  ) => ReadonlyArray<SpaceIdOf<TBoard>> | undefined;\n  getJumpTo?: (\n    space: BoardSpaceOf<TBoard>,\n    board: TBoard,\n  ) => SpaceIdOf<TBoard> | undefined;\n};\n\nfunction positionForLayout(\n  layout: TrackLayout,\n  index: number,\n  count: number,\n): { x: number; y: number } {\n  if (layout.type === \"linear\") {\n    const spacing = layout.spacing ?? 72;\n    const origin = layout.origin ?? { x: 0, y: 0 };\n    return layout.axis === \"y\"\n      ? { x: origin.x, y: origin.y + index * spacing }\n      : { x: origin.x + index * spacing, y: origin.y };\n  }\n\n  const startAngleDeg = layout.startAngleDeg ?? -90;\n  const clockwise = layout.clockwise ?? true;\n  const angleStep = count === 0 ? 0 : 360 / count;\n  const angleDeg = startAngleDeg + (clockwise ? 1 : -1) * angleStep * index;\n  const angle = (angleDeg * Math.PI) / 180;\n  return {\n    x: layout.center.x + Math.cos(angle) * layout.radius,\n    y: layout.center.y + Math.sin(angle) * layout.radius,\n  };\n}\n\nfunction defaultNextSpaces<TBoard extends GenericBoardLike>(\n  board: TBoard,\n  spaceId: SpaceIdOf<TBoard>,\n): Array<SpaceIdOf<TBoard>> {\n  const relations = board.relations ?? [];\n  return relations.flatMap((relation) => {\n    if (relation.fromSpaceId === spaceId) {\n      return [relation.toSpaceId];\n    }\n    if (!relation.directed && relation.toSpaceId === spaceId) {\n      return [relation.fromSpaceId];\n    }\n    return [];\n  }) as Array<SpaceIdOf<TBoard>>;\n}\n\nexport function toTrackBoardData<\n  TBoard extends GenericBoardLike,\n  TPiece extends TrackBoardPieceLike<\n    string,\n    SpaceIdOf<TBoard>,\n    string,\n    unknown\n  >,\n>(\n  board: TBoard,\n  options: ToTrackBoardDataOptions<TBoard, TPiece>,\n): {\n  spaces: Array<TrackSpace<SpaceIdOf<TBoard>, SpaceFieldsOf<TBoard>>>;\n  pieces: Array<\n    TrackPiece<\n      PieceIdOf<TPiece>,\n      SpaceIdOf<TBoard>,\n      PieceOwnerOf<TPiece>,\n      PieceFieldsOf<TPiece>\n    >\n  >;\n} {\n  const spaces = Object.values(board.spaces) as Array<BoardSpaceOf<TBoard>>;\n  const orderedSpaces = [...spaces].sort((left, right) =>\n    left.id.localeCompare(right.id),\n  );\n\n  return {\n    spaces: orderedSpaces.map((space, index, allSpaces) => ({\n      id: space.id as SpaceIdOf<TBoard>,\n      index,\n      name: space.name ?? undefined,\n      type: space.typeId ?? undefined,\n      nextSpaces: (options.getNextSpaces?.(space, board) ??\n        defaultNextSpaces(board, space.id as SpaceIdOf<TBoard>)) as Array<\n        SpaceIdOf<TBoard>\n      >,\n      jumpTo: options.getJumpTo?.(space, board),\n      position:\n        \"getPosition\" in options && options.getPosition\n          ? options.getPosition(space, index, allSpaces)\n          : positionForLayout(options.layout, index, allSpaces.length),\n      data: space.fields as SpaceFieldsOf<TBoard>,\n    })),\n    pieces: (options.pieces ?? []).map((piece) => ({\n      id: piece.id as PieceIdOf<TPiece>,\n      spaceId: piece.spaceId,\n      owner: piece.owner as PieceOwnerOf<TPiece>,\n      type: piece.typeId ?? undefined,\n      data: piece.fields as PieceFieldsOf<TPiece>,\n    })),\n  };\n}\n","/**\n * Board theming helpers.\n *\n * The SDK's board renderers (`<HexGrid>`, `<SquareGrid>`,\n * `<NetworkGraph>`, `<ZoneMap>`, `<TrackBoard>`, `<SlotSystem>`) need a\n * tiny but consistent set of visual tokens — frame border, frame fill,\n * eligible-target hint, and active hover ring — so authors don't have\n * to re-pick colours per board. {@link useBoardTheme} exposes those\n * tokens, derived from the active {@link Theme}.\n */\n\nimport { useMemo } from \"react\";\nimport { useTheme } from \"./ThemeProvider.js\";\nimport type { Theme } from \"./tokens.js\";\n\n/**\n * Resolved board tokens consumed by board renderers and per-tile\n * default renderers. All values are CSS-ready strings.\n */\nexport interface BoardTheme {\n  /** Border drawn around the board's outer frame. */\n  readonly frameBorder: string;\n  /** Background painted under the tile renderer (visible at tile gaps). */\n  readonly frameBackground: string;\n  /** Hover-state ring drawn over an interactive target. */\n  readonly hoverRing: string;\n  /** Idle hint colour for an eligible-but-unhovered target. */\n  readonly eligibleHint: string;\n  /** Border drawn on inactive tiles (matches semantic.border.default). */\n  readonly tileBorder: string;\n  /** Subtle dotted border for non-interactive scaffolding (e.g. ports). */\n  readonly tileBorderSubtle: string;\n  /** Foreground used for board labels (numbers, port ratios). */\n  readonly tileText: string;\n  /** Recommended ring stroke width in px for hover/eligible markers. */\n  readonly ringWidth: number;\n}\n\n/**\n * Derive a {@link BoardTheme} from the active theme. Memoised on the\n * theme reference so consumers can pass it straight to a board's\n * `defaultTileProps` / `defaultEdgeProps` slots.\n */\nexport function useBoardTheme(): BoardTheme {\n  const theme = useTheme();\n  return useMemo(() => deriveBoardTheme(theme), [theme]);\n}\n\n/** Standalone derivation for renderers that already hold a {@link Theme}. */\nexport function deriveBoardTheme(theme: Theme): BoardTheme {\n  return {\n    frameBorder: theme.component.board.frameBorder,\n    frameBackground: theme.component.board.frameBackground,\n    hoverRing: theme.component.board.hoverRing,\n    eligibleHint: theme.component.board.eligibleHint,\n    tileBorder: theme.semantic.border.default,\n    tileBorderSubtle: theme.semantic.border.subtle,\n    tileText: theme.semantic.text.primary,\n    ringWidth: 3,\n  };\n}\n","export type HexColor = string & { readonly __brand: \"HexColor\" };\n\nconst HEX_COLOR_PATTERN = /^#[0-9A-Fa-f]{6}$/;\n\nexport function isHexColor(value: unknown): value is HexColor {\n  return typeof value === \"string\" && HEX_COLOR_PATTERN.test(value);\n}\n\nexport function parseHexColor(value: unknown): HexColor | undefined {\n  return isHexColor(value) ? value : undefined;\n}\n\nexport function hexColor(value: string): HexColor {\n  if (!isHexColor(value)) {\n    throw new Error(\n      `Expected a 6-digit hex color such as #E53935, received '${value}'.`,\n    );\n  }\n  return value;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-PZ5AY32C.js

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-PZ5AY32C.js.map

package/dist/chunk-PZ5AY32C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-T3ZKNUZ7.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-T3ZKNUZ7.js.map

package/dist/chunk-T3ZKNUZ7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-T52J5RMF.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-T52J5RMF.js.map

package/dist/chunk-T52J5RMF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}