@dreamboard-games/sdk 0.5.0-alpha.23 → 0.5.0-alpha.25

package/README.md

@@ -291,7 +291,9 @@ phase entry and returned transitions.
 
 Mutation callbacks use `tx.roll(dieId)`, `tx.shuffle({ zone: { zoneId, hostId } })`,
 `tx.deal({ from, to, count })` and
-`tx.flipCard({ cardId, faceUp })` directly. Return
+`tx.flipCard({ cardId, faceUp })` directly. Like events, the zones the latest
+accepted operation shuffled are recorded in the runtime state; every seat that
+sees such a zone learns that it was shuffled, never its new order. Return
 `tx.transition(phaseName)` to enter a phase, including reentering the current
 phase. An unreturned outcome schedules no work. Entry chains are bounded to
 1,000 entries per dispatch. `tx.endGame(outcome, { transition })` enters the
@@ -364,7 +366,8 @@ same explicit params as `submit(params)`, retaining pending and connection gates
 `handFan` adds a focused, readable card with configurable presets and timing,
 and
 `originsFeature` adds `card.getOrigin()` so a newly shown card can animate from
-the zone or player it came from.
+the zone or player it came from, and `zone.getShuffle()` so a shuffled pile can
+riffle.
 
 ## Local hand sorting
 
@@ -471,9 +474,11 @@ also be pure. `game.shortcuts.getHints(target, activity)` returns only
 currently usable, unambiguous keys with their labels and `kind`. Interaction
 hints also carry their typed interaction name; local hints do not. Both variants
 share key collision handling. Headless callers supply local focus explicitly as
-`activity: { focusedTarget, pointerActive }`; omitting activity admits only
-interaction bindings. `useShortcutHints(target)` reads those hints reactively
-and returns no hints when the feature is absent. The mounted
+`activity: { focusedTarget, pointerActive, touch }`; omitting activity admits
+only interaction bindings. Hints are empty while `touch` is true. The mounted
+hooks set it when the latest press was a finger and clear it on the next key or
+mouse press; the keys themselves keep working. `useShortcutHints(target)` reads
+those hints reactively and returns no hints when the feature is absent. The mounted
 `useGameShortcuts` hook returns `{ target, hints }` for a reserved help/status
 area. Rejected actions and transport failures use the binding's existing
 `onError` handler; callbacks from an old source, seat, or unmounted child are

package/dist/{board-element-CqtxU5VZ.d.ts → board-element-DXLPBVk-.d.ts}

@@ -1,4 +1,4 @@
-import { f as BoardEdgeId, n as BoardVertexId } from './extract-CwJWDrSD.js';
+import { f as BoardEdgeId, n as BoardVertexId } from './extract-Bi6_tzUr.js';
 
 declare function boardEdgeId<BoardId extends string>(layout: "hex" | "square", boardId: BoardId, latticeId: string): BoardEdgeId<BoardId>;
 declare function boardVertexId<BoardId extends string>(layout: "hex" | "square", boardId: BoardId, latticeId: string): BoardVertexId<BoardId>;

package/dist/{chunk-UUJSLFIJ.js → chunk-63GWNBZX.js}

@@ -5,10 +5,11 @@ import {
   ReducerSessionStateSchema,
   ReferenceBasisSchema,
   RngDrawSchema,
+  ShuffledZoneSchema,
   boardSpaceHostId,
   isCardReferenceNamespace,
   parseBoardSpaceHostId
-} from "./chunk-U6R7FAH4.js";
+} from "./chunk-IEMZ26FI.js";
 import {
   AuthoredTileDisclosureSchema,
   BoardProjectionSchema,
@@ -2191,7 +2192,8 @@ function createIngressRuntimeCodec(definition) {
     lastTransition: z7.object({
       from: phaseNameSchema,
       to: phaseNameSchema
-    }).nullable()
+    }).nullable(),
+    shuffledZones: z7.array(ShuffledZoneSchema).min(1).optional()
   });
   const parseRuntimeInput = createRuntimeInputParser(playerIdSchema);
   return {
@@ -2657,7 +2659,8 @@ function finishReducerTransaction(tx) {
   return context.disposition.type === "reject" ? context.disposition : {
     ...context.disposition,
     state: context.currentState,
-    events: [...context.events]
+    events: [...context.events],
+    shuffledZones: [...context.shuffledZones]
   };
 }
 function getTransactionContext(host) {
@@ -2744,7 +2747,7 @@ function createReducerTransactionSurface() {
       const context = getTransactionContext(this);
       return context.shuffleMethod ??= (args) => {
         const table = context.currentState.table;
-        const { ids, definition } = resolveZone(
+        const { ref, ids, definition } = resolveZone(
           table,
           context.definitions,
           args.zone
@@ -2756,6 +2759,7 @@ function createReducerTransactionSurface() {
         if (shuffled.length !== ids.length || new Set(shuffled).size !== ids.length || shuffled.some((id2) => !ids.includes(id2)))
           throw new Error("Shuffle must preserve zone membership.");
         ids.splice(0, ids.length, ...shuffled);
+        context.shuffledZones.push(ref);
         invalidate(context);
       };
     }
@@ -2774,6 +2778,7 @@ function createReducerTransactionFromSurface(initialState, surface, random, defi
       currentQueries: null,
       methodCache: {},
       events: [],
+      shuffledZones: [],
       disposition: { type: "accept" },
       random,
       definitions
@@ -5262,6 +5267,7 @@ function createLifecycleRunner(scope) {
     const consumptions = [];
     let terminal;
     const events = [];
+    let shuffledZones = [];
     if (phase.enter) {
       const random = createMutableRandomHelpers(workingState.runtime.rng);
       const enterArgs = scope.buildRuntimeArgs(
@@ -5285,6 +5291,7 @@ function createLifecycleRunner(scope) {
       };
       terminal ??= entered.terminal;
       events.push(...entered.events ?? []);
+      shuffledZones = entered.shuffledZones ?? [];
       consumptions.push(...random.consumptions());
       transition = entered.transition;
     }
@@ -5293,7 +5300,8 @@ function createLifecycleRunner(scope) {
       transition,
       consumptions,
       ...terminal ? { terminal } : {},
-      events
+      events,
+      shuffledZones
     };
   }
   function initializePhaseResult(state, phaseName) {
@@ -6262,6 +6270,7 @@ function createReducerExecutor(scope, interactions, lifecycle) {
       ...resolved.transition ? { transition: resolved.transition } : {},
       ...resolved.terminal ? { terminal: resolved.terminal } : {},
       events: resolved.events ?? [],
+      shuffledZones: resolved.shuffledZones ?? [],
       trace: rngTrace(random.consumptions())
     };
   }
@@ -6298,6 +6307,7 @@ function createReducerExecutor(scope, interactions, lifecycle) {
       ...result.transition ? { transition: result.transition } : {},
       ...result.terminal ? { terminal: result.terminal } : {},
       events: result.events ?? [],
+      shuffledZones: result.shuffledZones ?? [],
       trace: rngTrace([
         ...sampled.consumptions,
         ...result.rngConsumptions ?? []
@@ -6314,6 +6324,7 @@ function createReducerExecutor(scope, interactions, lifecycle) {
     let transition = initial.transition;
     let terminal = initial.terminal;
     const events = [...initial.events ?? []];
+    const shuffledZones = [...initial.shuffledZones ?? []];
     const trace = [...initial.trace ?? []];
     while (transition !== void 0) {
       if (entries >= MAX_PHASE_ENTRIES) {
@@ -6333,6 +6344,7 @@ function createReducerExecutor(scope, interactions, lifecycle) {
       trace.push(...rngTrace(entered.consumptions));
       state = entered.state;
       events.push(...entered.events);
+      shuffledZones.push(...entered.shuffledZones);
       terminal ??= entered.terminal;
       if (finalEntry && entered.transition !== void 0) {
         throw new Error(
@@ -6343,15 +6355,20 @@ function createReducerExecutor(scope, interactions, lifecycle) {
     }
     const committedEvents = normalizeGameEvents(events);
     assertGameEventReferences(committedEvents, state.table);
+    const runtime = { ...state.runtime, events: committedEvents };
+    delete runtime.shuffledZones;
+    const committedShuffles = [
+      ...new Map(
+        shuffledZones.map((zone) => [
+          JSON.stringify([zone.zoneId, zone.hostId]),
+          zone
+        ])
+      ).values()
+    ];
+    if (committedShuffles.length) runtime.shuffledZones = committedShuffles;
     return {
       type: "accept",
-      state: reconcilePending(
-        {
-          ...state,
-          runtime: { ...state.runtime, events: committedEvents }
-        },
-        referenceBasis
-      ),
+      state: reconcilePending({ ...state, runtime }, referenceBasis),
       events: committedEvents,
       trace,
       ...terminal ? { terminal } : {}
@@ -6549,8 +6566,10 @@ function createProjectionBuilder(scope, interactions) {
       scope.manifest
     );
     const result = {};
+    const shuffledZones = combinedState.runtime.shuffledZones ?? [];
     for (const {
       zoneId,
+      hostId,
       seatHostId,
       componentIds,
       tiles
@@ -6619,7 +6638,10 @@ function createProjectionBuilder(scope, interactions) {
         cardIds,
         cardViewsById,
         cardBacksById,
-        playableByCardId
+        playableByCardId,
+        ...shuffledZones.some(
+          (zone) => zone.zoneId === zoneId && zone.hostId === hostId
+        ) ? { shuffled: true } : {}
       };
     }
     return result;
@@ -7200,4 +7222,4 @@ export {
   createProjectionBuilder,
   createReducerBundle
 };
-//# sourceMappingURL=chunk-UUJSLFIJ.js.map
+//# sourceMappingURL=chunk-63GWNBZX.js.map