@gamepark/react-game 7.7.4 → 7.7.6

package/dist/hooks/flatHistoryEngine.js

@@ -0,0 +1,101 @@
+export const CHECKPOINT_INTERVAL = 50;
+/**
+ * Replays moves from the nearest checkpoint to produce the game state at a given move index.
+ */
+export const replayFromCheckpoint = (targetMoveIndex, checkpoints, allPlayedMoves, RulesClass, setup, gameOver, player, getAction) => {
+    let nearest;
+    for (let i = checkpoints.length - 1; i >= 0; i--) {
+        if (checkpoints[i].moveIndex <= targetMoveIndex) {
+            nearest = checkpoints[i];
+            break;
+        }
+    }
+    const startState = nearest ? nearest.gameState : setup;
+    const startIndex = nearest ? nearest.moveIndex : 0;
+    const tempRules = new RulesClass(JSON.parse(JSON.stringify(startState)), gameOver ? undefined : { player });
+    for (let i = startIndex; i < targetMoveIndex; i++) {
+        try {
+            const action = getAction(allPlayedMoves[i].actionId);
+            tempRules.play(JSON.parse(JSON.stringify(allPlayedMoves[i].move)), { local: action?.local });
+        }
+        catch (error) {
+            console.error('Error replaying move for lazy game state', error);
+        }
+    }
+    return JSON.parse(JSON.stringify(tempRules.game));
+};
+export const saveCheckpointIfNeeded = (engine, moveIndex) => {
+    if (moveIndex > 0 && moveIndex % CHECKPOINT_INTERVAL === 0) {
+        engine.checkpoints.push({
+            moveIndex,
+            gameState: JSON.parse(JSON.stringify(engine.rules.game))
+        });
+    }
+};
+export const playMoveOnEngine = (engine, move, getAction) => {
+    try {
+        const action = getAction(move.actionId);
+        engine.rules.play(JSON.parse(JSON.stringify(move.move)), { local: action?.local });
+    }
+    catch (error) {
+        console.error('Error while playing a move in useFlatHistory', engine.rules.game, move, error);
+    }
+};
+export const buildActionMap = (actions) => {
+    const map = new Map();
+    if (actions) {
+        for (const action of actions) {
+            if (action.id)
+                map.set(action.id, action);
+        }
+    }
+    return map;
+};
+export const getMoveEntry = (playedMove, moveIndex, engine, allPlayedMoves, ctx) => {
+    const { move, consequenceIndex } = playedMove;
+    const action = ctx.getAction(playedMove.actionId);
+    if (!action)
+        return undefined;
+    let cachedGame = undefined;
+    const moveComponentContext = {
+        move, consequenceIndex, action,
+        get game() {
+            if (cachedGame === undefined) {
+                cachedGame = JSON.parse(JSON.stringify(engine.rules.game));
+            }
+            return cachedGame;
+        }
+    };
+    const description = ctx.logs?.getMovePlayedLogDescription(move, moveComponentContext);
+    if (!description?.Component)
+        return;
+    const capturedMoveIndex = moveIndex;
+    const capturedCheckpoints = [...engine.checkpoints];
+    return {
+        ...description, move, consequenceIndex, action,
+        get game() {
+            if (cachedGame === undefined) {
+                cachedGame = replayFromCheckpoint(capturedMoveIndex, capturedCheckpoints, allPlayedMoves, ctx.RulesClass, ctx.setup, ctx.gameOver, ctx.player, ctx.getAction);
+            }
+            return cachedGame;
+        }
+    };
+};
+/**
+ * Processes a list of moves synchronously, returning history entries.
+ * This is the core logic extracted from the hook for testability.
+ */
+export const processMovesSync = (moves, startIndex, engine, allPlayedMoves, ctx) => {
+    const entries = [];
+    let moveIndex = startIndex;
+    for (const move of moves) {
+        const entry = getMoveEntry(move, moveIndex, engine, allPlayedMoves, ctx);
+        if (entry)
+            entries.push(entry);
+        playMoveOnEngine(engine, move, ctx.getAction);
+        saveCheckpointIfNeeded(engine, moveIndex + 1);
+        moveIndex++;
+    }
+    return entries;
+};
+//# sourceMappingURL=flatHistoryEngine.js.map

package/dist/hooks/flatHistoryEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatHistoryEngine.js","sourceRoot":"","sources":["../../src/hooks/flatHistoryEngine.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useBackgroundTabHandler.d.ts

@@ -0,0 +1 @@
+export declare const useBackgroundTabHandler: () => void;

package/dist/hooks/useBackgroundTabHandler.js

@@ -0,0 +1,38 @@
+import { isActionToAnimate, setAnimationsSpeed, store } from '@gamepark/react-client';
+import { useEffect } from 'react';
+const SKIP_SPEED = 0;
+export const useBackgroundTabHandler = () => {
+    useEffect(() => {
+        let speededUp = false;
+        const onVisibilityChange = () => {
+            if (document.visibilityState !== 'visible')
+                return;
+            const { actions } = store.getState();
+            if (!actions)
+                return;
+            const hasPendingAnimations = actions.some(a => a.animation || isActionToAnimate(a));
+            if (hasPendingAnimations) {
+                speededUp = true;
+                store.dispatch(setAnimationsSpeed(SKIP_SPEED));
+            }
+        };
+        const unsubscribe = store.subscribe(() => {
+            if (!speededUp)
+                return;
+            const { actions } = store.getState();
+            if (!actions)
+                return;
+            const hasPendingAnimations = actions.some(a => a.animation || isActionToAnimate(a));
+            if (!hasPendingAnimations) {
+                speededUp = false;
+                store.dispatch(setAnimationsSpeed(1));
+            }
+        });
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            unsubscribe();
+        };
+    }, []);
+};
+//# sourceMappingURL=useBackgroundTabHandler.js.map

package/dist/hooks/useBackgroundTabHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackgroundTabHandler.js","sourceRoot":"","sources":["../../src/hooks/useBackgroundTabHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,MAAM,UAAU,GAAG,CAAC,CAAA;AAEpB,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAA;QAErB,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;gBAAE,OAAM;YAClD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;YACnF,IAAI,oBAAoB,EAAE,CAAC;gBACzB,SAAS,GAAG,IAAI,CAAA;gBAChB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAA;YAChD,CAAC;QACH,CAAC,CAAA;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,SAAS;gBAAE,OAAM;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;YACnF,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC1B,SAAS,GAAG,KAAK,CAAA;gBACjB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAA;YACvC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAA;QACjE,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAA;YACpE,WAAW,EAAE,CAAA;QACf,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAA"}

package/dist/hooks/useFastAnimationsOnReturn.d.ts

@@ -0,0 +1 @@
+export declare const useFastAnimationsOnReturn: () => void;

package/dist/hooks/useFastAnimationsOnReturn.js

@@ -0,0 +1,38 @@
+import { isActionToAnimate, setAnimationsSpeed, store } from '@gamepark/react-client';
+import { useEffect } from 'react';
+const SKIP_SPEED = 0;
+export const useFastAnimationsOnReturn = () => {
+    useEffect(() => {
+        let speededUp = false;
+        const onVisibilityChange = () => {
+            if (document.visibilityState !== 'visible')
+                return;
+            const { actions } = store.getState();
+            if (!actions)
+                return;
+            const hasPendingAnimations = actions.some(a => a.animation || isActionToAnimate(a));
+            if (hasPendingAnimations) {
+                speededUp = true;
+                store.dispatch(setAnimationsSpeed(SKIP_SPEED));
+            }
+        };
+        const unsubscribe = store.subscribe(() => {
+            if (!speededUp)
+                return;
+            const { actions } = store.getState();
+            if (!actions)
+                return;
+            const hasPendingAnimations = actions.some(a => a.animation || isActionToAnimate(a));
+            if (!hasPendingAnimations) {
+                speededUp = false;
+                store.dispatch(setAnimationsSpeed(1));
+            }
+        });
+        document.addEventListener('visibilitychange', onVisibilityChange);
+        return () => {
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            unsubscribe();
+        };
+    }, []);
+};
+//# sourceMappingURL=useFastAnimationsOnReturn.js.map

package/dist/hooks/useFastAnimationsOnReturn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFastAnimationsOnReturn.js","sourceRoot":"","sources":["../../src/hooks/useFastAnimationsOnReturn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,MAAM,UAAU,GAAG,CAAC,CAAA;AAEpB,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,EAAE;IAC5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAA;QAErB,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS;gBAAE,OAAM;YAClD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;YACnF,IAAI,oBAAoB,EAAE,CAAC;gBACzB,SAAS,GAAG,IAAI,CAAA;gBAChB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAA;YAChD,CAAC;QACH,CAAC,CAAA;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,SAAS;gBAAE,OAAM;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;YACpC,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;YACnF,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC1B,SAAS,GAAG,KAAK,CAAA;gBACjB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAA;YACvC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAA;QACjE,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAA;YACpE,WAAW,EAAE,CAAA;QACf,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAA"}

package/dist/hooks/useFlatHistory.js

@@ -1,8 +1,17 @@
 import { useGameSelector } from '@gamepark/react-client';
 import { findLastIndex } from 'es-toolkit/compat';
-import { useContext, useEffect, useRef, useState } from 'react';
+import { useContext, useEffect, useMemo, useRef, useState } from 'react';
 import { gameContext } from '../components';
+import { buildActionMap, getMoveEntry, playMoveOnEngine, processMovesSync, saveCheckpointIfNeeded } from './flatHistoryEngine';
 import { usePlayerId } from './usePlayerId';
+const BATCH_TIME_BUDGET_MS = 8; // stay under 1 frame (16ms), leave room for rendering
+// Polyfill for Safari
+const scheduleIdle = typeof requestIdleCallback === 'function'
+    ? requestIdleCallback
+    : (cb) => setTimeout(() => cb({ timeRemaining: () => BATCH_TIME_BUDGET_MS }), 1);
+const cancelIdle = typeof cancelIdleCallback === 'function'
+    ? cancelIdleCallback
+    : (id) => clearTimeout(id);
 export const useFlatHistory = () => {
     const context = useContext(gameContext);
     const player = usePlayerId();
@@ -12,32 +21,67 @@ export const useFlatHistory = () => {
     const playedMoves = useGameSelector((state) => state.playedMoves);
     const gameOver = useGameSelector((state) => state.gameOver);
     const actions = useGameSelector((state) => state.actions);
+    const actionMap = useMemo(() => buildActionMap(actions), [actions]);
+    const getAction = (actionId) => actionMap.get(actionId);
     const moves = useRef([]);
-    const rules = useRef(null);
+    const engine = useRef(null);
+    const playedMovesRef = useRef([]);
+    const idleCallbackId = useRef(null);
+    const processingIndex = useRef(0);
+    const pendingEntries = useRef([]);
+    const pendingMoves = useRef([]);
     useEffect(() => {
-        if (!rules.current && setup) {
-            rules.current = new context.Rules(JSON.parse(JSON.stringify(setup)), gameOver ? undefined : { player });
+        if (!engine.current && setup) {
+            engine.current = {
+                rules: new context.Rules(JSON.parse(JSON.stringify(setup)), gameOver ? undefined : { player }),
+                checkpoints: [],
+                movesProcessed: 0
+            };
         }
     }, [setup]);
-    const getAction = (actionId) => actions?.find((action) => action.id === actionId);
-    const getMoveEntry = (playedMove) => {
-        const { move, consequenceIndex } = playedMove;
-        const action = getAction(playedMove.actionId);
-        if (!action)
-            return undefined;
-        const moveComponentContext = { move, consequenceIndex, action, game: JSON.parse(JSON.stringify(rules.current.game)) };
-        const description = context.logs?.getMovePlayedLogDescription(move, moveComponentContext);
-        if (!description?.Component)
+    const makeLogContext = () => ({
+        logs: context.logs,
+        RulesClass: context.Rules,
+        setup,
+        gameOver,
+        player,
+        getAction
+    });
+    const processBatch = (deadline) => {
+        if (!engine.current)
             return;
-        return { ...moveComponentContext, ...description };
-    };
-    const playMove = (move) => {
-        try {
-            const action = getAction(move.actionId);
-            rules.current?.play(JSON.parse(JSON.stringify(move.move)), { local: action?.local });
+        const movesToProcess = pendingMoves.current;
+        const ctx = makeLogContext();
+        let i = processingIndex.current;
+        while (i < movesToProcess.length && deadline.timeRemaining() > 1) {
+            const move = movesToProcess[i];
+            const entry = getMoveEntry(move, moves.current.length + i, engine.current, playedMovesRef.current, ctx);
+            if (entry)
+                pendingEntries.current.push(entry);
+            playMoveOnEngine(engine.current, move, getAction);
+            saveCheckpointIfNeeded(engine.current, moves.current.length + i + 1);
+            i++;
         }
-        catch (error) {
-            console.error('Error while playing a move in useFlatHistory', rules.current?.game, move, error);
+        processingIndex.current = i;
+        if (i < movesToProcess.length) {
+            if (pendingEntries.current.length > 0) {
+                const entriesToFlush = pendingEntries.current;
+                pendingEntries.current = [];
+                setHistory((h) => h.concat(entriesToFlush));
+            }
+            idleCallbackId.current = scheduleIdle(processBatch);
+        }
+        else {
+            if (pendingEntries.current.length > 0) {
+                const entriesToFlush = pendingEntries.current;
+                pendingEntries.current = [];
+                setHistory((h) => h.concat(entriesToFlush));
+            }
+            const processedCount = movesToProcess.length;
+            moves.current = playedMovesRef.current.slice(0, moves.current.length + processedCount);
+            idleCallbackId.current = null;
+            pendingMoves.current = [];
+            processingIndex.current = 0;
         }
     };
     useEffect(() => {
@@ -45,45 +89,77 @@ export const useFlatHistory = () => {
             setLoaded(true);
     }, [playedMoves]);
     useEffect(() => {
-        if (!playedMoves)
+        if (!playedMoves || !engine.current)
             return;
+        playedMovesRef.current = playedMoves;
         const actualSize = moves.current.length;
+        const ctx = makeLogContext();
         if (actualSize < playedMoves.length) {
+            if (idleCallbackId.current !== null) {
+                cancelIdle(idleCallbackId.current);
+                idleCallbackId.current = null;
+            }
             const newMoves = playedMoves.slice(actualSize - playedMoves.length);
-            const entries = [];
-            for (const move of newMoves) {
-                const entry = getMoveEntry(move);
-                if (entry)
-                    entries.push(entry);
-                playMove(move);
+            if (newMoves.length <= 20) {
+                const entries = processMovesSync(newMoves, actualSize, engine.current, playedMovesRef.current, ctx);
+                setHistory((h) => h.concat(entries));
+                moves.current = playedMoves;
+            }
+            else {
+                pendingMoves.current = newMoves;
+                pendingEntries.current = [];
+                processingIndex.current = 0;
+                idleCallbackId.current = scheduleIdle(processBatch);
             }
-            setHistory((h) => h.concat(entries));
         }
         else if (actualSize > playedMoves.length) {
+            if (idleCallbackId.current !== null) {
+                cancelIdle(idleCallbackId.current);
+                idleCallbackId.current = null;
+            }
             const firstIndexChange = moves.current.findIndex((currentMove, index) => currentMove.actionId !== playedMoves[index]?.actionId);
             const invalidatedMoves = moves.current.slice(firstIndexChange);
             const lastValidHistoryIndex = findLastIndex(history, (moveHistory) => !invalidatedMoves.some((move) => move.actionId === moveHistory.action.id));
+            // Use the nearest checkpoint at or before the invalidation point instead of replaying from a history entry's game state
+            const validCheckpoints = engine.current.checkpoints.filter((cp) => cp.moveIndex <= firstIndexChange);
+            const nearestCheckpoint = validCheckpoints.length > 0 ? validCheckpoints[validCheckpoints.length - 1] : undefined;
+            const restartState = nearestCheckpoint ? nearestCheckpoint.gameState : setup;
+            const restartIndex = nearestCheckpoint ? nearestCheckpoint.moveIndex : 0;
+            engine.current.checkpoints = validCheckpoints;
+            engine.current.rules = new context.Rules(JSON.parse(JSON.stringify(restartState)), gameOver ? undefined : { player });
+            // Replay from checkpoint to the start of remaining moves
+            for (let i = restartIndex; i < firstIndexChange; i++) {
+                playMoveOnEngine(engine.current, playedMoves[i], getAction);
+            }
+            // Find the last valid history entry that's still in the new playedMoves
             const lastValidHistory = lastValidHistoryIndex !== -1 ? history[lastValidHistoryIndex] : undefined;
-            const previousGameState = lastValidHistory ? lastValidHistory.game : setup;
-            rules.current = new context.Rules(JSON.parse(JSON.stringify(previousGameState)), gameOver ? undefined : { player });
-            const movesToReplay = lastValidHistory ?
-                playedMoves.slice(findLastIndex(playedMoves, move => move.actionId === lastValidHistory.action.id && move.consequenceIndex === lastValidHistory.consequenceIndex))
-                : playedMoves;
-            if (lastValidHistory) {
-                const move = movesToReplay.shift();
-                playMove(move);
+            const replayStartIndex = lastValidHistory
+                ? findLastIndex(playedMoves, move => move.actionId === lastValidHistory.action.id && move.consequenceIndex === lastValidHistory.consequenceIndex)
+                : firstIndexChange;
+            // Replay moves between firstIndexChange and replayStartIndex (these have valid history entries already)
+            for (let i = firstIndexChange; i < replayStartIndex; i++) {
+                playMoveOnEngine(engine.current, playedMoves[i], getAction);
             }
-            const entries = [];
-            for (const move of movesToReplay) {
-                const entry = getMoveEntry(move);
-                if (entry)
-                    entries.push(entry);
-                playMove(move);
+            // Skip the last valid history move itself
+            if (lastValidHistory && replayStartIndex >= 0) {
+                playMoveOnEngine(engine.current, playedMoves[replayStartIndex], getAction);
             }
+            // Process remaining moves for new entries
+            const newMovesStart = lastValidHistory ? replayStartIndex + 1 : firstIndexChange;
+            const movesToProcess = playedMoves.slice(newMovesStart);
+            const entries = processMovesSync(movesToProcess, newMovesStart, engine.current, playedMovesRef.current, ctx);
             setHistory((h) => h.slice(0, lastValidHistoryIndex + 1).concat(entries));
+            moves.current = playedMoves;
         }
-        moves.current = playedMoves;
     }, [playedMoves]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            if (idleCallbackId.current !== null) {
+                cancelIdle(idleCallbackId.current);
+            }
+        };
+    }, []);
     return {
         history,
         isLoaded

package/dist/hooks/useFlatHistory.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFlatHistory.js","sourceRoot":"","sources":["../../src/hooks/useFlatHistory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useFlatHistory.js","sourceRoot":"","sources":["../../src/hooks/useFlatHistory.ts"],"names":[],"mappings":"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"}

package/dist/locators/PileLocator.d.ts

@@ -34,6 +34,11 @@ export declare class PileLocator<P extends number = number, M extends number = n
      * @returns the maximum angle of rotation of the items
      */
     getMaxAngle(_location: Location<P, L>, _context: MaterialContext<P, M, L, R, V>): number;
+    /**
+     * When true, the z-index is derived from the item's Y offset instead of the item index.
+     * Items with a higher Y appear on top, simulating depth perspective.
+     */
+    zFromY: boolean;
     minimumDistance: number;
     /**
      * Identifier of the pile. By default, distinct location areas (different player, id or parent) forms distinct piles.

package/dist/locators/PileLocator.js

@@ -40,6 +40,11 @@ export class PileLocator extends Locator {
     getMaxAngle(_location, _context) {
         return this.maxAngle;
     }
+    /**
+     * When true, the z-index is derived from the item's Y offset instead of the item index.
+     * Items with a higher Y appear on top, simulating depth perspective.
+     */
+    zFromY = false;
     minimumDistance = 0;
     /**
      * Identifier of the pile. By default, distinct location areas (different player, id or parent) forms distinct piles.
@@ -72,7 +77,10 @@ export class PileLocator extends Locator {
             }
         }
         const itemPosition = pilePositions.get(itemUniqueId);
-        return { x: x + itemPosition.x, y: y + itemPosition.y, z: z + index * 0.05 };
+        const radius = this.getRadius(location, context);
+        const maxRadius = typeof radius === 'number' ? radius : radius.y;
+        const itemZ = this.zFromY ? (maxRadius > 0 ? (itemPosition.y + maxRadius) / (2 * maxRadius) : 0) : index * 0.05;
+        return { x: x + itemPosition.x, y: y + itemPosition.y, z: z + itemZ };
     }
     generateItemPosition(item, context) {
         const distance = Math.random();

package/dist/locators/PileLocator.js.map

@@ -1 +1 @@
-{"version":3,"file":"PileLocator.js","sourceRoot":"","sources":["../../src/locators/PileLocator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PileLocator.js","sourceRoot":"","sources":["../../src/locators/PileLocator.ts"],"names":[],"mappings":"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"}