@cratis/components 4.26.4 → 4.27.0

package/dist/esm/PivotViewer/components/pivot/visibilityHelpers.js

@@ -0,0 +1,306 @@
+import { CARD_GAP } from './constants.js';
+import { destroySprite } from './sprites.js';
+
+function createVisibleRect(source) {
+    return {
+        left: source.panWorldX,
+        right: source.panWorldX + source.worldWidth,
+        top: source.panWorldY,
+        bottom: source.panWorldY + source.worldHeight,
+        epsilon: Math.max(0.5, 0.5 * source.invScale),
+        cardWidth: source.cardWidth,
+        cardHeight: source.cardHeight,
+    };
+}
+function rectIntersects(rect, x, y) {
+    return x + rect.cardWidth >= rect.left - rect.epsilon &&
+        x <= rect.right + rect.epsilon &&
+        y + rect.cardHeight >= rect.top - rect.epsilon &&
+        y <= rect.bottom + rect.epsilon;
+}
+function sweepableHiddenAt(sprite, position, rect) {
+    if (position && rectIntersects(rect, position.x, position.y))
+        return undefined;
+    return sprite.__lastHiddenAt;
+}
+function tryConsumeCreationBudget(budget, isVisible) {
+    if (isVisible)
+        return true;
+    if (budget.created >= budget.max) {
+        budget.pending = true;
+        return false;
+    }
+    budget.created++;
+    return true;
+}
+function createIdCollector() {
+    const ids = [];
+    const set = new Set();
+    return {
+        ids,
+        set,
+        add: (id) => {
+            if (!set.has(id)) {
+                ids.push(id);
+                set.add(id);
+            }
+        },
+    };
+}
+function scrollOrPan(scroll, pan) {
+    return typeof scroll === 'number' ? scroll : (pan || 0);
+}
+function measureViewport(params, container) {
+    const { layout, viewportWidth, viewportHeight, zoomLevel, viewMode, panX, panY } = params;
+    const viewportPxWidth = container.clientWidth || viewportWidth;
+    const viewportPxHeight = container.clientHeight || viewportHeight;
+    const contentHeightPx = (layout.totalHeight || 0) * zoomLevel;
+    let offsetY = 0;
+    if (viewMode === 'grouped' && contentHeightPx < viewportPxHeight) {
+        offsetY = viewportPxHeight - contentHeightPx;
+    }
+    return {
+        viewportPxWidth,
+        viewportPxHeight,
+        offsetY,
+        scrollX: scrollOrPan(container.scrollLeft, panX),
+        scrollY: scrollOrPan(container.scrollTop, panY),
+    };
+}
+function applyContainerTransforms(params, metrics) {
+    const { root, groupsContainer, zoomLevel } = params;
+    const { scrollX, scrollY, offsetY } = metrics;
+    if (root) {
+        root.scale.set(zoomLevel);
+        root.position.set(-scrollX, offsetY - scrollY);
+    }
+    if (groupsContainer) {
+        groupsContainer.scale.set(zoomLevel);
+        groupsContainer.position.set(-scrollX, offsetY - scrollY);
+    }
+}
+function computeWorldViewport(params, metrics) {
+    const { cardWidth, cardHeight, zoomLevel } = params;
+    const baseBufferWorld = Math.max(cardWidth, cardHeight) * 4;
+    const invScale = zoomLevel && zoomLevel !== 0 ? 1 / zoomLevel : 1;
+    const panWorldX = metrics.scrollX * invScale;
+    const panWorldY = (metrics.scrollY - metrics.offsetY) * invScale;
+    const worldWidth = metrics.viewportPxWidth * invScale;
+    const worldHeight = metrics.viewportPxHeight * invScale;
+    const bufferWorld = Math.max(baseBufferWorld * invScale, Math.max(worldWidth, worldHeight) * 2.0, baseBufferWorld);
+    return {
+        invScale,
+        panWorldX,
+        panWorldY,
+        worldWidth,
+        worldHeight,
+        bufferedLeft: panWorldX - bufferWorld,
+        bufferedRight: panWorldX + worldWidth + bufferWorld,
+        bufferedTop: panWorldY - bufferWorld,
+        bufferedBottom: panWorldY + worldHeight + bufferWorld,
+        epsilon: Math.max(0.5, 0.5 * invScale),
+    };
+}
+function overlapsRange(start, size, low, high, epsilon) {
+    return start + size >= low - epsilon && start <= high + epsilon;
+}
+function intersectsBufferedViewport(viewport, card, x, y) {
+    const { bufferedLeft, bufferedRight, bufferedTop, bufferedBottom, epsilon } = viewport;
+    return overlapsRange(x, card.cardWidth, bufferedLeft, bufferedRight, epsilon) &&
+        overlapsRange(y, card.cardHeight, bufferedTop, bufferedBottom, epsilon);
+}
+function addIntersectingTargets(params, intersects, collector) {
+    for (const [id, position] of params.layout.positions) {
+        if (position && intersects(position.x, position.y))
+            collector.add(id);
+    }
+}
+function isUnseenPreviousCard(params, id) {
+    return !params.sprites.has(id) && !params.transitionSeenIds.has(id) && params.layout.positions.has(id);
+}
+function addIntersectingPreviousPositions(params, intersects, collector) {
+    for (const [id, position] of params.prevLayout?.positions ?? []) {
+        if (!isUnseenPreviousCard(params, id))
+            continue;
+        if (position && intersects(position.x, position.y))
+            collector.add(id);
+    }
+}
+function addIntersectingCurrentSprites(params, intersects, collector) {
+    for (const [id, sprite] of params.sprites) {
+        params.transitionSeenIds.add(id);
+        if (params.layout.positions.has(id) && intersects(sprite.currentX, sprite.currentY))
+            collector.add(id);
+    }
+}
+function collectInViewportIds(params, viewport) {
+    const collector = createIdCollector();
+    const intersects = (x, y) => intersectsBufferedViewport(viewport, params, x, y);
+    addIntersectingTargets(params, intersects, collector);
+    if (params.isViewTransition) {
+        addIntersectingPreviousPositions(params, intersects, collector);
+        addIntersectingCurrentSprites(params, intersects, collector);
+    }
+    return collector;
+}
+function addLastRowIds(params, viewport, collector) {
+    const { layout, cardHeight } = params;
+    try {
+        const slotHeight = cardHeight + (CARD_GAP || 8);
+        const totalRows = Math.ceil((layout.totalHeight || 0) / slotHeight) || 0;
+        const rowsVisible = Math.max(1, Math.ceil(viewport.worldHeight / slotHeight));
+        const prefetchMultiplier = 0.75;
+        const prefetchRows = Math.max(2, Math.ceil(rowsVisible * prefetchMultiplier * Math.max(1, viewport.invScale)));
+        const lastRowThresholdY = Math.max(0, (totalRows - prefetchRows) * slotHeight);
+        for (const [id, position] of layout.positions) {
+            if (position.y >= lastRowThresholdY)
+                collector.add(id);
+        }
+    }
+    catch (e) {
+    }
+}
+function showSprite(sprite) {
+    try {
+        if (sprite.container) {
+            sprite.container.visible = true;
+        }
+        if (sprite.__lastHiddenAt)
+            delete sprite.__lastHiddenAt;
+    }
+    catch (e) {
+    }
+}
+function hideSprite(sprite) {
+    try {
+        if (sprite.container) {
+            sprite.container.visible = false;
+        }
+        sprite.__lastHiddenAt ??= Date.now();
+    }
+    catch (e) {
+    }
+}
+function applySpriteVisibility(sprites, visibleSet, aggressiveCull) {
+    for (const [id, sprite] of sprites) {
+        applyVisibilityToSprite(sprite, visibleSet.has(id), aggressiveCull);
+    }
+}
+function applyVisibilityToSprite(sprite, wanted, aggressiveCull) {
+    if (wanted) {
+        showSprite(sprite);
+        return;
+    }
+    if (!aggressiveCull) {
+        hideSprite(sprite);
+        return;
+    }
+    try {
+        if (sprite.container)
+            sprite.container.visible = true;
+    }
+    catch (e) {
+    }
+}
+function removeSprite(sprite) {
+    try {
+        if (sprite.container && sprite.container.parent)
+            sprite.container.parent.removeChild(sprite.container);
+    }
+    catch (e) {
+    }
+    try {
+        destroySprite(sprite);
+    }
+    catch (e) {
+    }
+}
+function isSweepDue(lastHidden, now, thresholdMs, readImmediately) {
+    if (!lastHidden)
+        return false;
+    return !!readImmediately() || now - lastHidden > thresholdMs;
+}
+function sweepHiddenSprites(sprites, layout, visibleRect, readSweepImmediately) {
+    try {
+        const SWEEP_MS = 100;
+        const now = Date.now();
+        for (const [id, sprite] of sprites) {
+            const lastHidden = sweepableHiddenAt(sprite, layout.positions.get(id), visibleRect);
+            if (isSweepDue(lastHidden, now, SWEEP_MS, readSweepImmediately)) {
+                removeSprite(sprite);
+                sprites.delete(id);
+            }
+        }
+    }
+    catch (e) {
+    }
+}
+function resolveSpawnStart(params, viewport, id, position) {
+    const oldPos = findPreviousPositionInViewport(params, viewport, id);
+    if (!oldPos)
+        return { startX: position.x, startY: position.y, shouldAnimate: false };
+    const { deltaX, deltaY } = panDeltaInWorld(params);
+    return { startX: oldPos.x + deltaX, startY: oldPos.y + deltaY, shouldAnimate: true };
+}
+function findPreviousPositionInViewport(params, viewport, id) {
+    const { isViewTransition, prevLayout } = params;
+    if (!isViewTransition || !prevLayout)
+        return undefined;
+    const oldPos = prevLayout.positions.get(id);
+    return oldPos && intersectsBufferedViewport(viewport, params, oldPos.x, oldPos.y) ? oldPos : undefined;
+}
+function panDeltaInWorld(params) {
+    const { panDeltaX, panDeltaY, zoomLevel } = params;
+    if (!panDeltaX && !panDeltaY)
+        return { deltaX: 0, deltaY: 0 };
+    return {
+        deltaX: (panDeltaX || 0) / (zoomLevel || 1),
+        deltaY: (panDeltaY || 0) / (zoomLevel || 1),
+    };
+}
+function spawnSprite(params, viewport, root, id, position, createCardSprite) {
+    const { startX, startY, shouldAnimate } = resolveSpawnStart(params, viewport, id, position);
+    const sprite = createCardSprite(id, startX, startY);
+    params.sprites.set(id, sprite);
+    if (params.isViewTransition)
+        params.transitionSeenIds.add(id);
+    if (sprite.container) {
+        root.addChild(sprite.container);
+        sprite.currentX = startX;
+        sprite.currentY = startY;
+        sprite.container.position.set(startX, startY);
+    }
+    if (shouldAnimate) {
+        sprite.targetX = position.x;
+        sprite.targetY = position.y;
+        sprite.startX = startX;
+        sprite.startY = startY;
+        sprite.animationStartTime = Date.now();
+        sprite.animationDelay = Math.random() * 300;
+    }
+    return sprite;
+}
+function retargetSprite(sprite, position, isViewTransition) {
+    const targetChanged = sprite.targetX !== position.x || sprite.targetY !== position.y;
+    if (!targetChanged)
+        return;
+    if (isViewTransition) {
+        if (sprite.animationStartTime === undefined) {
+            sprite.startX = sprite.currentX;
+            sprite.startY = sprite.currentY;
+            sprite.animationStartTime = Date.now();
+            sprite.animationDelay = Math.random() * 300;
+        }
+        sprite.targetX = position.x;
+        sprite.targetY = position.y;
+    }
+    else {
+        sprite.targetX = position.x;
+        sprite.targetY = position.y;
+        delete sprite.animationStartTime;
+        delete sprite.animationDelay;
+    }
+}
+
+export { addLastRowIds, applyContainerTransforms, applySpriteVisibility, collectInViewportIds, computeWorldViewport, createIdCollector, createVisibleRect, hideSprite, intersectsBufferedViewport, measureViewport, rectIntersects, removeSprite, resolveSpawnStart, retargetSprite, scrollOrPan, showSprite, spawnSprite, sweepHiddenSprites, sweepableHiddenAt, tryConsumeCreationBudget };
+//# sourceMappingURL=visibilityHelpers.js.map

package/dist/esm/PivotViewer/components/pivot/visibilityHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibilityHelpers.js","sources":["../../../../../PivotViewer/components/pivot/visibilityHelpers.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport type * as PIXI from 'pixi.js';\nimport type { CardSprite } from './constants';\nimport { CARD_GAP } from './constants';\nimport type { LayoutResult } from '../../engine/types';\nimport { destroySprite } from './sprites';\nimport type { SyncParams } from './visibility';\n\nexport interface VisibleRect {\n    left: number;\n    right: number;\n    top: number;\n    bottom: number;\n    epsilon: number;\n    cardWidth: number;\n    cardHeight: number;\n}\n\nexport interface VisibleRectSource {\n    panWorldX: number;\n    panWorldY: number;\n    worldWidth: number;\n    worldHeight: number;\n    invScale: number;\n    cardWidth: number;\n    cardHeight: number;\n}\n\n/**\n * Builds the unbuffered visible rect in world units, with a zoom-aware rounding tolerance. Cards\n * intersecting it are created first and are never subject to the per-frame budget or the sweep.\n */\nexport function createVisibleRect(source: VisibleRectSource): VisibleRect {\n    return {\n        left: source.panWorldX,\n        right: source.panWorldX + source.worldWidth,\n        top: source.panWorldY,\n        bottom: source.panWorldY + source.worldHeight,\n        epsilon: Math.max(0.5, 0.5 * source.invScale),\n        cardWidth: source.cardWidth,\n        cardHeight: source.cardHeight,\n    };\n}\n\nexport function rectIntersects(rect: VisibleRect, x: number, y: number) {\n    return x + rect.cardWidth >= rect.left - rect.epsilon &&\n        x <= rect.right + rect.epsilon &&\n        y + rect.cardHeight >= rect.top - rect.epsilon &&\n        y <= rect.bottom + rect.epsilon;\n}\n\n/** When the sprite was hidden, or undefined when it is not hidden or its card is on screen (never swept). */\nexport function sweepableHiddenAt(sprite: CardSprite, position: { x: number; y: number } | undefined, rect: VisibleRect) {\n    if (position && rectIntersects(rect, position.x, position.y)) return undefined;\n    return (sprite as unknown as { __lastHiddenAt?: number }).__lastHiddenAt;\n}\n\n/**\n * Decides whether a sprite may be created this frame. Visible cards are always allowed;\n * buffer-only cards are limited by the budget and mark the sync as pending when deferred.\n */\nexport function tryConsumeCreationBudget(budget: { created: number; pending: boolean; max: number }, isVisible: boolean) {\n    if (isVisible) return true;\n    if (budget.created >= budget.max) {\n        budget.pending = true;\n        return false;\n    }\n    budget.created++;\n    return true;\n}\n\nexport type SpriteId = string | number;\nexport type SpriteMap = Map<SpriteId, CardSprite>;\nexport type Point = { x: number; y: number };\nexport type HiddenAwareSprite = { __lastHiddenAt?: number };\n\n/** The measured viewport in pixels, the vertical alignment offset and the live scroll position. */\nexport interface ViewportMetrics {\n    viewportPxWidth: number;\n    viewportPxHeight: number;\n    offsetY: number;\n    scrollX: number;\n    scrollY: number;\n}\n\n/** The viewport in world units, with the pre-creation buffer applied to its edges. */\nexport interface WorldViewport {\n    invScale: number;\n    panWorldX: number;\n    panWorldY: number;\n    worldWidth: number;\n    worldHeight: number;\n    bufferedLeft: number;\n    bufferedRight: number;\n    bufferedTop: number;\n    bufferedBottom: number;\n    epsilon: number;\n}\n\n/** Collects ids to keep, preserving first-seen order. */\nexport interface IdCollector {\n    ids: SpriteId[];\n    set: Set<SpriteId>;\n    add: (id: SpriteId) => void;\n}\n\nexport function createIdCollector(): IdCollector {\n    const ids: SpriteId[] = [];\n    const set = new Set<SpriteId>();\n    return {\n        ids,\n        set,\n        add: (id) => {\n            if (!set.has(id)) {\n                ids.push(id);\n                set.add(id);\n            }\n        },\n    };\n}\n\nexport function scrollOrPan(scroll: number, pan: number | undefined): number {\n    return typeof scroll === 'number' ? scroll : (pan || 0);\n}\n\nexport function measureViewport<TItem>(params: SyncParams<TItem>, container: HTMLDivElement): ViewportMetrics {\n    const { layout, viewportWidth, viewportHeight, zoomLevel, viewMode, panX, panY } = params;\n    // Use the container's measured client size for the viewport dimensions\n    // (in pixels). The passed `viewportWidth`/`viewportHeight` can be stale\n    // when the browser/device zoom changes; `clientWidth/clientHeight` are\n    // authoritative for the actual visible pixel area.\n    const viewportPxWidth = container.clientWidth || viewportWidth;\n    const viewportPxHeight = container.clientHeight || viewportHeight;\n\n    const contentHeightPx = (layout.totalHeight || 0) * zoomLevel;\n    let offsetY = 0;\n\n    // If content fits vertically within the viewport, align relative to bottom.\n    // The spacer ensures container isn't scrollable in this case (scrollTop=0).\n    // The items are at large Y coordinates relative to layout.totalHeight.\n    // We want the bottom of the layout (totalHeight) to align with viewport bottom.\n    if (viewMode === 'grouped' && contentHeightPx < viewportPxHeight) {\n        // Calculate offset in pixels to shift the content down\n        offsetY = viewportPxHeight - contentHeightPx;\n    }\n\n    // Use the container's actual scroll position for positioning, not the passed panX/panY\n    // which may be stale (from React state) compared to live DOM scroll values.\n    return {\n        viewportPxWidth,\n        viewportPxHeight,\n        offsetY,\n        scrollX: scrollOrPan(container.scrollLeft, panX),\n        scrollY: scrollOrPan(container.scrollTop, panY),\n    };\n}\n\n/** Applies scaling and position to the root (and groups) container. */\nexport function applyContainerTransforms<TItem>(params: SyncParams<TItem>, metrics: ViewportMetrics) {\n    const { root, groupsContainer, zoomLevel } = params;\n    const { scrollX, scrollY, offsetY } = metrics;\n    if (root) {\n        root.scale.set(zoomLevel);\n        // Standard position: -scrollX, -scrollY\n        // Plus vertical alignment offset if zoomed out\n        root.position.set(-scrollX, offsetY - scrollY);\n    }\n\n    // Apply synchronization to groups container if present\n    if (groupsContainer) {\n        groupsContainer.scale.set(zoomLevel);\n        groupsContainer.position.set(-scrollX, offsetY - scrollY);\n    }\n}\n\nexport function computeWorldViewport<TItem>(params: SyncParams<TItem>, metrics: ViewportMetrics): WorldViewport {\n    const { cardWidth, cardHeight, zoomLevel } = params;\n    // Increase buffer (in world units) to reduce edge cases where rapid\n    // scrolling skips sprite creation. Keep buffer in world units and convert\n    // DOM pixel measurements into world coordinates below to avoid mixing\n    // coordinate spaces which can cause precision drift at browser zooms.\n    const baseBufferWorld = Math.max(cardWidth, cardHeight) * 4;\n    // Ensure buffer scales with viewport size (in world units) so that when\n    // zoomed out we still pre-create enough sprites ahead of the viewport.\n    const invScale = zoomLevel && zoomLevel !== 0 ? 1 / zoomLevel : 1;\n\n    // Convert pixel-based DOM measurements into world units so we compare like\n    // with like. root.position is set using -pixels, so the mapping\n    // from DOM scroll (pixels) to world units is: world = pixels / zoomLevel.\n    // OffsetY is already in pixels and doesn't need scaling in panWorldY calc\n    // because panWorldY is used for viewport buffering/culling, which is relative\n    // to the \"camera\" position in world space.\n    // The camera world Y = (scrollTop - offsetY) / zoomLevel.\n    const panWorldX = metrics.scrollX * invScale;\n    const panWorldY = (metrics.scrollY - metrics.offsetY) * invScale;\n\n    const worldWidth = metrics.viewportPxWidth * invScale;\n    const worldHeight = metrics.viewportPxHeight * invScale;\n\n    // Ensure bufferWorld is calculated from the actual measured viewport\n    // in world units (after converting client pixel dims using invScale).\n    // Make buffer adaptive to zoom: when zoomed out (invScale > 1) a small\n    // pixel scroll maps to a larger world delta, so increase the buffer.\n    // Use the larger of width/height to ensure we buffer enough in both directions.\n    const bufferWorld = Math.max(baseBufferWorld * invScale, Math.max(worldWidth, worldHeight) * 2.0, baseBufferWorld);\n\n    // Do not clamp viewport edges to 0 — allow negative top/left values so the\n    // visible window correctly follows the scroll even when the buffer is\n    // larger than the current scroll offset.\n    return {\n        invScale,\n        panWorldX,\n        panWorldY,\n        worldWidth,\n        worldHeight,\n        bufferedLeft: panWorldX - bufferWorld,\n        bufferedRight: panWorldX + worldWidth + bufferWorld,\n        bufferedTop: panWorldY - bufferWorld,\n        bufferedBottom: panWorldY + worldHeight + bufferWorld,\n        // Small tolerance in world units to avoid floating-point edge cases when\n        // browser/device zoom or high scroll values produce tiny rounding errors.\n        epsilon: Math.max(0.5, 0.5 * invScale),\n    };\n}\n\nexport interface CardSize {\n    cardWidth: number;\n    cardHeight: number;\n}\n\nfunction overlapsRange(start: number, size: number, low: number, high: number, epsilon: number) {\n    return start + size >= low - epsilon && start <= high + epsilon;\n}\n\nexport function intersectsBufferedViewport(viewport: WorldViewport, card: CardSize, x: number, y: number) {\n    const { bufferedLeft, bufferedRight, bufferedTop, bufferedBottom, epsilon } = viewport;\n    return overlapsRange(x, card.cardWidth, bufferedLeft, bufferedRight, epsilon) &&\n        overlapsRange(y, card.cardHeight, bufferedTop, bufferedBottom, epsilon);\n}\n\ntype PositionTest = (x: number, y: number) => boolean;\n\nfunction addIntersectingTargets<TItem>(params: SyncParams<TItem>, intersects: PositionTest, collector: IdCollector) {\n    for (const [id, position] of params.layout.positions) {\n        if (position && intersects(position.x, position.y)) collector.add(id);\n    }\n}\n\nfunction isUnseenPreviousCard<TItem>(params: SyncParams<TItem>, id: SpriteId) {\n    return !params.sprites.has(id) && !params.transitionSeenIds.has(id) && params.layout.positions.has(id);\n}\n\nfunction addIntersectingPreviousPositions<TItem>(params: SyncParams<TItem>, intersects: PositionTest, collector: IdCollector) {\n    for (const [id, position] of params.prevLayout?.positions ?? []) {\n        if (!isUnseenPreviousCard(params, id)) continue;\n        if (position && intersects(position.x, position.y)) collector.add(id);\n    }\n}\n\nfunction addIntersectingCurrentSprites<TItem>(params: SyncParams<TItem>, intersects: PositionTest, collector: IdCollector) {\n    for (const [id, sprite] of params.sprites) {\n        params.transitionSeenIds.add(id);\n        if (params.layout.positions.has(id) && intersects(sprite.currentX, sprite.currentY)) collector.add(id);\n    }\n}\n\n/** Collects the ids whose target positions, or (during a transition) current positions, are in the buffered viewport. */\nexport function collectInViewportIds<TItem>(\n    params: SyncParams<TItem>,\n    viewport: WorldViewport,\n): IdCollector {\n    const collector = createIdCollector();\n    const intersects: PositionTest = (x, y) => intersectsBufferedViewport(viewport, params, x, y);\n\n    // Target positions are authoritative, but during a transition cards may\n    // still be at their old positions while the camera catches up.\n    addIntersectingTargets(params, intersects, collector);\n    if (params.isViewTransition) {\n        addIntersectingPreviousPositions(params, intersects, collector);\n        addIntersectingCurrentSprites(params, intersects, collector);\n    }\n    return collector;\n}\n\n/**\n * Ensures last rows are present when the user scrolls near the bottom.\n * Computes slot/row information and force-inserts IDs from the last few\n * rows to avoid missing tiles due to rounding/precision at zoom levels.\n */\nexport function addLastRowIds<TItem>(params: SyncParams<TItem>, viewport: WorldViewport, collector: IdCollector) {\n    const { layout, cardHeight } = params;\n    try {\n        const slotHeight = cardHeight + (CARD_GAP || 8);\n        const totalRows = Math.ceil((layout.totalHeight || 0) / slotHeight) || 0;\n        // Determine how many rows are visible in the viewport (world units),\n        // then prefetch a fraction of that adjusted by zoom (invScale).\n        const rowsVisible = Math.max(1, Math.ceil(viewport.worldHeight / slotHeight));\n        const prefetchMultiplier = 0.75; // fraction of viewport to prefetch\n        const prefetchRows = Math.max(2, Math.ceil(rowsVisible * prefetchMultiplier * Math.max(1, viewport.invScale)));\n        const lastRowThresholdY = Math.max(0, (totalRows - prefetchRows) * slotHeight);\n        for (const [id, position] of layout.positions) {\n            if (position.y >= lastRowThresholdY) collector.add(id);\n        }\n    } catch (e) {\n        void e;\n    }\n}\n\nexport function showSprite(sprite: CardSprite) {\n    try {\n        if (sprite.container) {\n            sprite.container.visible = true;\n        }\n        if ((sprite as unknown as HiddenAwareSprite).__lastHiddenAt) delete (sprite as unknown as HiddenAwareSprite).__lastHiddenAt;\n    } catch (e) { void e; }\n}\n\nexport function hideSprite(sprite: CardSprite) {\n    try {\n        if (sprite.container) {\n            sprite.container.visible = false;\n        }\n        (sprite as unknown as HiddenAwareSprite).__lastHiddenAt ??= Date.now();\n    } catch (e) {\n        void e;\n    }\n}\n\n/** Shows sprites that are wanted and hides the rest (unless culling would risk visual holes). */\nexport function applySpriteVisibility(sprites: SpriteMap, visibleSet: Set<SpriteId>, aggressiveCull: boolean) {\n    for (const [id, sprite] of sprites) {\n        applyVisibilityToSprite(sprite, visibleSet.has(id), aggressiveCull);\n    }\n}\n\nfunction applyVisibilityToSprite(sprite: CardSprite, wanted: boolean, aggressiveCull: boolean) {\n    if (wanted) {\n        showSprite(sprite);\n        return;\n    }\n    if (!aggressiveCull) {\n        hideSprite(sprite);\n        return;\n    }\n    // Keep sprite visible this frame to avoid visual holes\n    try { if (sprite.container) sprite.container.visible = true; } catch (e) { void e; }\n}\n\nexport function removeSprite(sprite: CardSprite) {\n    try {\n        // remove from parent if present\n        if (sprite.container && sprite.container.parent) sprite.container.parent.removeChild(sprite.container);\n    } catch (e) {\n        void e;\n    }\n    try {\n        destroySprite(sprite);\n    } catch (e) {\n        void e;\n    }\n}\n\n/** The immediate-sweep flag is read lazily, only for sprites that are hidden and off screen. */\nfunction isSweepDue(lastHidden: number | undefined, now: number, thresholdMs: number, readImmediately: () => boolean | undefined) {\n    if (!lastHidden) return false;\n    return !!readImmediately() || now - lastHidden > thresholdMs;\n}\n\n/** Sweep: actually destroy sprites that have been hidden longer than threshold. */\nexport function sweepHiddenSprites(\n    sprites: SpriteMap,\n    layout: LayoutResult,\n    visibleRect: VisibleRect,\n    readSweepImmediately: () => boolean | undefined,\n) {\n    try {\n        const SWEEP_MS = 100; // keep hidden sprites for 100ms before destruction (reduced from 500ms for faster mode transitions)\n        const now = Date.now();\n        for (const [id, sprite] of sprites) {\n            const lastHidden = sweepableHiddenAt(sprite, layout.positions.get(id), visibleRect);\n            if (isSweepDue(lastHidden, now, SWEEP_MS, readSweepImmediately)) {\n                removeSprite(sprite);\n                sprites.delete(id);\n            }\n        }\n    } catch (e) {\n        void e;\n    }\n}\n\n/** Where a new sprite starts, and whether it flies in from a previous position. */\nexport function resolveSpawnStart<TItem>(\n    params: SyncParams<TItem>,\n    viewport: WorldViewport,\n    id: SpriteId,\n    position: Point,\n): { startX: number; startY: number; shouldAnimate: boolean } {\n    const oldPos = findPreviousPositionInViewport(params, viewport, id);\n    if (!oldPos) return { startX: position.x, startY: position.y, shouldAnimate: false };\n\n    // If we have a pan delta (camera jump), we need to adjust the start position\n    // so that the sprite appears at the same visual location relative to the NEW camera.\n    // StartWorld = OldWorld + PanDelta\n    const { deltaX, deltaY } = panDeltaInWorld(params);\n    return { startX: oldPos.x + deltaX, startY: oldPos.y + deltaY, shouldAnimate: true };\n}\n\n/** During a view transition, the previous position of the card if it was inside the buffered viewport. */\nfunction findPreviousPositionInViewport<TItem>(params: SyncParams<TItem>, viewport: WorldViewport, id: SpriteId) {\n    const { isViewTransition, prevLayout } = params;\n    if (!isViewTransition || !prevLayout) return undefined;\n    const oldPos = prevLayout.positions.get(id);\n    return oldPos && intersectsBufferedViewport(viewport, params, oldPos.x, oldPos.y) ? oldPos : undefined;\n}\n\nfunction panDeltaInWorld<TItem>(params: SyncParams<TItem>) {\n    const { panDeltaX, panDeltaY, zoomLevel } = params;\n    if (!panDeltaX && !panDeltaY) return { deltaX: 0, deltaY: 0 };\n    return {\n        deltaX: (panDeltaX || 0) / (zoomLevel || 1),\n        deltaY: (panDeltaY || 0) / (zoomLevel || 1),\n    };\n}\n\nexport function spawnSprite<TItem>(\n    params: SyncParams<TItem>,\n    viewport: WorldViewport,\n    root: PIXI.Container,\n    id: SpriteId,\n    position: Point,\n    createCardSprite: SyncParams<TItem>['createCardSprite'],\n): CardSprite {\n    const { startX, startY, shouldAnimate } = resolveSpawnStart(params, viewport, id, position);\n\n    const sprite = createCardSprite(id, startX, startY);\n    params.sprites.set(id, sprite);\n    if (params.isViewTransition) params.transitionSeenIds.add(id);\n    if (sprite.container) {\n        root.addChild(sprite.container);\n        sprite.currentX = startX;\n        sprite.currentY = startY;\n        // Keep sprite.container positioned in world units; animation/update\n        // loop will apply root.scale/position to convert to pixels.\n        sprite.container.position.set(startX, startY);\n    }\n\n    if (shouldAnimate) {\n        sprite.targetX = position.x;\n        sprite.targetY = position.y;\n        sprite.startX = startX;\n        sprite.startY = startY;\n        sprite.animationStartTime = Date.now();\n        sprite.animationDelay = Math.random() * 300;\n    }\n    return sprite;\n}\n\n/** Check if target changed to trigger animation. */\nexport function retargetSprite(sprite: CardSprite, position: Point, isViewTransition: boolean | undefined) {\n    const targetChanged = sprite.targetX !== position.x || sprite.targetY !== position.y;\n    if (!targetChanged) return;\n\n    if (isViewTransition) {\n        // Only set up animation if not already animating - don't reset animation\n        // when targets change during layout recalculations\n        if (sprite.animationStartTime === undefined) {\n            sprite.startX = sprite.currentX;\n            sprite.startY = sprite.currentY;\n            sprite.animationStartTime = Date.now();\n            // Add random delay for \"organic\" fly effect\n            sprite.animationDelay = Math.random() * 300;\n        }\n        // Always update target to the new position (animation will smoothly\n        // adjust to the new target)\n        sprite.targetX = position.x;\n        sprite.targetY = position.y;\n    } else {\n        sprite.targetX = position.x;\n        sprite.targetY = position.y;\n        delete sprite.animationStartTime;\n        delete sprite.animationDelay;\n    }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/PivotViewer/hooks/useColorCssVariables.d.ts

@@ -0,0 +1,9 @@
+import type { PivotViewerColors } from '../types.js';
+/**
+ * Maps provided color overrides to CSS variables understood by the component.
+ *
+ * @param colors - Optional color overrides.
+ * @returns CSS variables for the overrides that are set.
+ */
+export declare function useColorCssVariables(colors: Partial<PivotViewerColors> | undefined): Record<string, string>;
+//# sourceMappingURL=useColorCssVariables.d.ts.map

package/dist/esm/PivotViewer/hooks/useColorCssVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColorCssVariables.d.ts","sourceRoot":"","sources":["../../../../PivotViewer/hooks/useColorCssVariables.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAU,CAAC;AAmBlD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS,GAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB"}

package/dist/esm/PivotViewer/hooks/useColorCssVariables.js

@@ -0,0 +1,32 @@
+import { useMemo } from 'react';
+
+const colorVariables = [
+    ['primaryColor', '--cratis-primary-color'],
+    ['primaryColorText', '--cratis-primary-color-text'],
+    ['primary500', '--cratis-primary-500'],
+    ['surfaceGround', '--cratis-surface-ground'],
+    ['surfaceCard', '--cratis-surface-card'],
+    ['surfaceSection', '--cratis-surface-section'],
+    ['surfaceOverlay', '--cratis-surface-overlay'],
+    ['surfaceBorder', '--cratis-surface-border'],
+    ['textColor', '--cratis-text-color'],
+    ['textColorSecondary', '--cratis-text-color-secondary'],
+    ['highlightBg', '--cratis-highlight-bg'],
+    ['maskbg', '--cratis-maskbg'],
+    ['focusRing', '--cratis-focus-ring'],
+];
+function useColorCssVariables(colors) {
+    return useMemo(() => {
+        const vars = {};
+        if (!colors)
+            return vars;
+        for (const [colorKey, variable] of colorVariables) {
+            if (colors[colorKey])
+                vars[variable] = colors[colorKey];
+        }
+        return vars;
+    }, [colors]);
+}
+
+export { useColorCssVariables };
+//# sourceMappingURL=useColorCssVariables.js.map

package/dist/esm/PivotViewer/hooks/useColorCssVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useColorCssVariables.js","sources":["../../../../PivotViewer/hooks/useColorCssVariables.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useMemo } from 'react';\nimport type { PivotViewerColors } from '../types';\n\n/** Maps each color override to the CSS variable understood by the component. */\nconst colorVariables: ReadonlyArray<readonly [keyof PivotViewerColors, string]> = [\n    ['primaryColor', '--cratis-primary-color'],\n    ['primaryColorText', '--cratis-primary-color-text'],\n    ['primary500', '--cratis-primary-500'],\n    ['surfaceGround', '--cratis-surface-ground'],\n    ['surfaceCard', '--cratis-surface-card'],\n    ['surfaceSection', '--cratis-surface-section'],\n    ['surfaceOverlay', '--cratis-surface-overlay'],\n    ['surfaceBorder', '--cratis-surface-border'],\n    ['textColor', '--cratis-text-color'],\n    ['textColorSecondary', '--cratis-text-color-secondary'],\n    ['highlightBg', '--cratis-highlight-bg'],\n    ['maskbg', '--cratis-maskbg'],\n    ['focusRing', '--cratis-focus-ring'],\n];\n\n/**\n * Maps provided color overrides to CSS variables understood by the component.\n *\n * @param colors - Optional color overrides.\n * @returns CSS variables for the overrides that are set.\n */\nexport function useColorCssVariables(\n    colors: Partial<PivotViewerColors> | undefined,\n): Record<string, string> {\n    return useMemo(() => {\n        const vars: Record<string, string> = {};\n        if (!colors) return vars;\n        for (const [colorKey, variable] of colorVariables) {\n            // Read the property twice (condition, then assignment), exactly as the original did.\n            if (colors[colorKey]) vars[variable] = colors[colorKey] as string;\n        }\n        return vars;\n    }, [colors]);\n}\n"],"names":[],"mappings":";;AAOA,MAAM,cAAc,GAA8D;IAC9E,CAAC,cAAc,EAAE,wBAAwB,CAAC;IAC1C,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;IACnD,CAAC,YAAY,EAAE,sBAAsB,CAAC;IACtC,CAAC,eAAe,EAAE,yBAAyB,CAAC;IAC5C,CAAC,aAAa,EAAE,uBAAuB,CAAC;IACxC,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IAC9C,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IAC9C,CAAC,eAAe,EAAE,yBAAyB,CAAC;IAC5C,CAAC,WAAW,EAAE,qBAAqB,CAAC;IACpC,CAAC,oBAAoB,EAAE,+BAA+B,CAAC;IACvD,CAAC,aAAa,EAAE,uBAAuB,CAAC;IACxC,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAC7B,CAAC,WAAW,EAAE,qBAAqB,CAAC;CACvC;AAQK,SAAU,oBAAoB,CAChC,MAA8C,EAAA;IAE9C,OAAO,OAAO,CAAC,MAAK;QAChB,MAAM,IAAI,GAA2B,EAAE;AACvC,QAAA,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,IAAI;QACxB,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,cAAc,EAAE;YAE/C,IAAI,MAAM,CAAC,QAAQ,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAW;QACrE;AACA,QAAA,OAAO,IAAI;AACf,IAAA,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;AAChB;;"}

package/dist/esm/PivotViewer/hooks/usePivotViewerGrouping.d.ts

@@ -0,0 +1,27 @@
+import type { PivotDimension, PivotFilter, PivotViewerProps } from '../types.js';
+import type { ViewMode } from '../components/Toolbar.js';
+export interface UsePivotViewerGroupingOptions<TItem extends object> {
+    data: TItem[];
+    dimensions: PivotDimension<TItem>[];
+    filters: PivotFilter<TItem>[] | undefined;
+    filterState: Record<string, Set<string>>;
+    rangeFilterState: Record<string, [number | null, number | null] | null>;
+    dimensionFilter: string | null;
+    activeDimension: PivotDimension<TItem> | undefined;
+    activeDimensionKey: string;
+    searchFields: PivotViewerProps<TItem>['searchFields'];
+    search: string;
+    viewMode: ViewMode;
+}
+/**
+ * Runs the worker engine pipeline: field extraction, filtering, search, grouping and presentation.
+ *
+ * @param options - The data, filter, dimension, search and view-mode inputs.
+ * @returns Engine readiness, the visible ids and the presented grouping.
+ */
+export declare function usePivotViewerGrouping<TItem extends object>({ data, dimensions, filters, filterState, rangeFilterState, dimensionFilter, activeDimension, activeDimensionKey, searchFields, search, viewMode, }: UsePivotViewerGroupingOptions<TItem>): {
+    ready: boolean;
+    visibleIds: Uint32Array<ArrayBufferLike>;
+    grouping: import("../engine/types.js").GroupingResult;
+};
+//# sourceMappingURL=usePivotViewerGrouping.d.ts.map

package/dist/esm/PivotViewer/hooks/usePivotViewerGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePivotViewerGrouping.d.ts","sourceRoot":"","sources":["../../../../PivotViewer/hooks/usePivotViewerGrouping.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAAuB,CAAC;AAQtD,MAAM,WAAW,6BAA6B,CAAC,KAAK,SAAS,MAAM;IAC/D,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,UAAU,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;IACpC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACnD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,MAAM,EAAE,EACzD,IAAI,EACJ,UAAU,EACV,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,QAAQ,GACX,EAAE,6BAA6B,CAAC,KAAK,CAAC;;;;EAoDtC"}

package/dist/esm/PivotViewer/hooks/usePivotViewerGrouping.js

@@ -0,0 +1,40 @@
+import { useMemo } from 'react';
+import { usePivotEngine } from './usePivotEngine.js';
+import { useFieldExtractors } from './useFieldExtractors.js';
+import { useCurrentFilters, useCurrentGroupBy } from './useCurrentFilters.js';
+import { useVisibleIds } from './useVisibleIds.js';
+import { useRawGrouping } from './useRawGrouping.js';
+import { presentGrouping } from '../utils/presentGrouping.js';
+
+function usePivotViewerGrouping({ data, dimensions, filters, filterState, rangeFilterState, dimensionFilter, activeDimension, activeDimensionKey, searchFields, search, viewMode, }) {
+    const { fieldExtractors, indexFields } = useFieldExtractors(dimensions, filters);
+    const { ready, applyFilters: engineApplyFilters, computeGrouping, sortIds, } = usePivotEngine({
+        data,
+        fieldExtractors,
+        indexFields,
+    });
+    const currentFilters = useCurrentFilters(filters, filterState, rangeFilterState, dimensionFilter, activeDimension);
+    const currentGroupBy = useCurrentGroupBy(activeDimensionKey, dimensions);
+    const visibleIds = useVisibleIds({
+        ready,
+        data,
+        currentFilters,
+        search,
+        searchFields,
+        engineApplyFilters,
+    });
+    const rawGrouping = useRawGrouping({
+        ready,
+        visibleIds,
+        currentGroupBy,
+        viewMode,
+        activeDimensionKey,
+        computeGrouping,
+        sortIds,
+    });
+    const grouping = useMemo(() => viewMode === 'grouped' ? presentGrouping(rawGrouping, activeDimension, data) : rawGrouping, [viewMode, rawGrouping, activeDimension, data]);
+    return { ready, visibleIds, grouping };
+}
+
+export { usePivotViewerGrouping };
+//# sourceMappingURL=usePivotViewerGrouping.js.map

package/dist/esm/PivotViewer/hooks/usePivotViewerGrouping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePivotViewerGrouping.js","sources":["../../../../PivotViewer/hooks/usePivotViewerGrouping.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useMemo } from 'react';\nimport type { PivotDimension, PivotFilter, PivotViewerProps } from '../types';\nimport type { ViewMode } from '../components/Toolbar';\nimport { usePivotEngine } from './usePivotEngine';\nimport { useFieldExtractors } from './useFieldExtractors';\nimport { useCurrentFilters, useCurrentGroupBy } from './useCurrentFilters';\nimport { useVisibleIds } from './useVisibleIds';\nimport { useRawGrouping } from './useRawGrouping';\nimport { presentGrouping } from '../utils/presentGrouping';\n\nexport interface UsePivotViewerGroupingOptions<TItem extends object> {\n    data: TItem[];\n    dimensions: PivotDimension<TItem>[];\n    filters: PivotFilter<TItem>[] | undefined;\n    filterState: Record<string, Set<string>>;\n    rangeFilterState: Record<string, [number | null, number | null] | null>;\n    dimensionFilter: string | null;\n    activeDimension: PivotDimension<TItem> | undefined;\n    activeDimensionKey: string;\n    searchFields: PivotViewerProps<TItem>['searchFields'];\n    search: string;\n    viewMode: ViewMode;\n}\n\n/**\n * Runs the worker engine pipeline: field extraction, filtering, search, grouping and presentation.\n *\n * @param options - The data, filter, dimension, search and view-mode inputs.\n * @returns Engine readiness, the visible ids and the presented grouping.\n */\nexport function usePivotViewerGrouping<TItem extends object>({\n    data,\n    dimensions,\n    filters,\n    filterState,\n    rangeFilterState,\n    dimensionFilter,\n    activeDimension,\n    activeDimensionKey,\n    searchFields,\n    search,\n    viewMode,\n}: UsePivotViewerGroupingOptions<TItem>) {\n    // Build field extractors for the columnar store\n    const { fieldExtractors, indexFields } = useFieldExtractors(dimensions, filters);\n\n    // Initialize the Web Worker engine\n    const {\n        ready,\n        applyFilters: engineApplyFilters,\n        computeGrouping,\n        sortIds,\n    } = usePivotEngine({\n        data,\n        fieldExtractors,\n        indexFields,\n    });\n\n    // Build filter specs from UI state\n    const currentFilters = useCurrentFilters(\n        filters,\n        filterState,\n        rangeFilterState,\n        dimensionFilter,\n        activeDimension,\n    );\n\n    const currentGroupBy = useCurrentGroupBy(activeDimensionKey, dimensions);\n\n    const visibleIds = useVisibleIds({\n        ready,\n        data,\n        currentFilters,\n        search,\n        searchFields,\n        engineApplyFilters,\n    });\n\n    const rawGrouping = useRawGrouping({\n        ready,\n        visibleIds,\n        currentGroupBy,\n        viewMode,\n        activeDimensionKey,\n        computeGrouping,\n        sortIds,\n    });\n\n    const grouping = useMemo(\n        () => viewMode === 'grouped' ? presentGrouping(rawGrouping, activeDimension, data) : rawGrouping,\n        [viewMode, rawGrouping, activeDimension, data],\n    );\n\n    return { ready, visibleIds, grouping };\n}\n"],"names":[],"mappings":";;;;;;;;AAiCM,SAAU,sBAAsB,CAAuB,EACzD,IAAI,EACJ,UAAU,EACV,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,QAAQ,GAC2B,EAAA;AAEnC,IAAA,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAAC;AAGhF,IAAA,MAAM,EACF,KAAK,EACL,YAAY,EAAE,kBAAkB,EAChC,eAAe,EACf,OAAO,GACV,GAAG,cAAc,CAAC;QACf,IAAI;QACJ,eAAe;QACf,WAAW;AACd,KAAA,CAAC;AAGF,IAAA,MAAM,cAAc,GAAG,iBAAiB,CACpC,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,CAClB;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,kBAAkB,EAAE,UAAU,CAAC;IAExE,MAAM,UAAU,GAAG,aAAa,CAAC;QAC7B,KAAK;QACL,IAAI;QACJ,cAAc;QACd,MAAM;QACN,YAAY;QACZ,kBAAkB;AACrB,KAAA,CAAC;IAEF,MAAM,WAAW,GAAG,cAAc,CAAC;QAC/B,KAAK;QACL,UAAU;QACV,cAAc;QACd,QAAQ;QACR,kBAAkB;QAClB,eAAe;QACf,OAAO;AACV,KAAA,CAAC;AAEF,IAAA,MAAM,QAAQ,GAAG,OAAO,CACpB,MAAM,QAAQ,KAAK,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,GAAG,WAAW,EAChG,CAAC,QAAQ,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,CAAC,CACjD;AAED,IAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE;AAC1C;;"}

package/dist/esm/PivotViewer/hooks/usePivotViewerInteractions.d.ts

@@ -0,0 +1,27 @@
+import type { RefObject } from 'react';
+import { useCardSelection } from './useCardSelection.js';
+import { useAnimationModeTracking } from './useAnimationModeTracking.js';
+type CardSelectionParams<TItem extends object> = Parameters<typeof useCardSelection<TItem>>[0];
+type AnimationTrackingParams = Parameters<typeof useAnimationModeTracking>;
+export interface UsePivotViewerInteractionsOptions<TItem extends object> extends Omit<CardSelectionParams<TItem>, 'resolveId' | 'containerRef'> {
+    containerRef: RefObject<HTMLDivElement>;
+    axisLabelsRef: RefObject<HTMLDivElement>;
+    filterState: AnimationTrackingParams[0];
+    rangeFilterState: AnimationTrackingParams[1];
+    search: AnimationTrackingParams[2];
+    activeDimensionKey: AnimationTrackingParams[3];
+    setAnimationMode: AnimationTrackingParams[5];
+}
+/**
+ * Wires scroll syncing, animation tracking, card selection and detail-panel closing.
+ *
+ * @param options - The viewer state and setters the interactions operate on.
+ * @returns The id resolver, card click handler and detail close handler.
+ */
+export declare function usePivotViewerInteractions<TItem extends object>(options: UsePivotViewerInteractionsOptions<TItem>): {
+    resolveId: (item: TItem) => number;
+    handleCardClick: (item: TItem, e: MouseEvent, id?: number | string) => void;
+    closeDetail: () => void;
+};
+export {};
+//# sourceMappingURL=usePivotViewerInteractions.d.ts.map

package/dist/esm/PivotViewer/hooks/usePivotViewerInteractions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePivotViewerInteractions.d.ts","sourceRoot":"","sources":["../../../../PivotViewer/hooks/usePivotViewerInteractions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AAGtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA4B,CAAC;AAGtE,KAAK,mBAAmB,CAAC,KAAK,SAAS,MAAM,IAAI,UAAU,CAAC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,KAAK,uBAAuB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE3E,MAAM,WAAW,iCAAiC,CAAC,KAAK,SAAS,MAAM,CACnE,SAAQ,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;IACtE,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACxC,aAAa,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACxC,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IACnC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAC/C,gBAAgB,EAAE,uBAAuB,CAAC,CAAC,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,MAAM,EAC3D,OAAO,EAAE,iCAAiC,CAAC,KAAK,CAAC;sBA0BtC,KAAK;;;EAoDnB"}

package/dist/esm/PivotViewer/hooks/usePivotViewerInteractions.js

@@ -0,0 +1,46 @@
+import { useCallback } from 'react';
+import { resolveInternalItemIndex } from '../utils/idResolution.js';
+import { useCardSelection } from './useCardSelection.js';
+import { useDetailPanelClose } from './useDetailPanelClose.js';
+import { useScrollSync } from './useScrollSync.js';
+import { useAnimationModeTracking } from './useAnimationModeTracking.js';
+import { useViewModeScrollHandling } from './useViewModeScrollHandling.js';
+
+function usePivotViewerInteractions(options) {
+    const { data, getItemId, containerRef, axisLabelsRef, viewMode, grouping, layout, selectedItem, zoomLevel, containerDimensions, preSelectionState, filterState, rangeFilterState, search, activeDimensionKey, setAnimationMode, setZoomLevel, setIsZooming, setSelectedItem, setPreSelectionState, } = options;
+    const resolveId = useCallback((item) => resolveInternalItemIndex(data, item, getItemId), [data, getItemId]);
+    useAnimationModeTracking(filterState, rangeFilterState, search, activeDimensionKey, viewMode, setAnimationMode);
+    useScrollSync(containerRef, axisLabelsRef, viewMode);
+    useViewModeScrollHandling({
+        containerRef,
+        viewMode,
+        grouping,
+        layout,
+        selectedItem,
+        zoomLevel,
+        resolveId,
+        data,
+        setPreSelectionState,
+    });
+    const handleCardClick = useCardSelection({ ...options, resolveId });
+    const closeDetail = useDetailPanelClose({
+        selectedItem,
+        preSelectionState,
+        zoomLevel,
+        viewMode,
+        layout,
+        containerRef,
+        containerDimensions,
+        grouping,
+        data,
+        resolveId,
+        setZoomLevel,
+        setIsZooming,
+        setSelectedItem,
+        setPreSelectionState,
+    });
+    return { resolveId, handleCardClick, closeDetail };
+}
+
+export { usePivotViewerInteractions };
+//# sourceMappingURL=usePivotViewerInteractions.js.map

package/dist/esm/PivotViewer/hooks/usePivotViewerInteractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePivotViewerInteractions.js","sources":["../../../../PivotViewer/hooks/usePivotViewerInteractions.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { useCallback } from 'react';\nimport type { RefObject } from 'react';\nimport { resolveInternalItemIndex } from '../utils/idResolution';\nimport { useCardSelection } from './useCardSelection';\nimport { useDetailPanelClose } from './useDetailPanelClose';\nimport { useScrollSync } from './useScrollSync';\nimport { useAnimationModeTracking } from './useAnimationModeTracking';\nimport { useViewModeScrollHandling } from './useViewModeScrollHandling';\n\ntype CardSelectionParams<TItem extends object> = Parameters<typeof useCardSelection<TItem>>[0];\ntype AnimationTrackingParams = Parameters<typeof useAnimationModeTracking>;\n\nexport interface UsePivotViewerInteractionsOptions<TItem extends object>\n    extends Omit<CardSelectionParams<TItem>, 'resolveId' | 'containerRef'> {\n    containerRef: RefObject<HTMLDivElement>;\n    axisLabelsRef: RefObject<HTMLDivElement>;\n    filterState: AnimationTrackingParams[0];\n    rangeFilterState: AnimationTrackingParams[1];\n    search: AnimationTrackingParams[2];\n    activeDimensionKey: AnimationTrackingParams[3];\n    setAnimationMode: AnimationTrackingParams[5];\n}\n\n/**\n * Wires scroll syncing, animation tracking, card selection and detail-panel closing.\n *\n * @param options - The viewer state and setters the interactions operate on.\n * @returns The id resolver, card click handler and detail close handler.\n */\nexport function usePivotViewerInteractions<TItem extends object>(\n    options: UsePivotViewerInteractionsOptions<TItem>,\n) {\n    const {\n        data,\n        getItemId,\n        containerRef,\n        axisLabelsRef,\n        viewMode,\n        grouping,\n        layout,\n        selectedItem,\n        zoomLevel,\n        containerDimensions,\n        preSelectionState,\n        filterState,\n        rangeFilterState,\n        search,\n        activeDimensionKey,\n        setAnimationMode,\n        setZoomLevel,\n        setIsZooming,\n        setSelectedItem,\n        setPreSelectionState,\n    } = options;\n\n    const resolveId = useCallback(\n        (item: TItem) => resolveInternalItemIndex(data, item, getItemId),\n        [data, getItemId],\n    );\n\n    // Track animation mode changes\n    useAnimationModeTracking(\n        filterState,\n        rangeFilterState,\n        search,\n        activeDimensionKey,\n        viewMode,\n        setAnimationMode,\n    );\n\n    // Sync axis labels scroll with container scroll\n    useScrollSync(containerRef, axisLabelsRef, viewMode);\n\n    // Handle scroll positioning when switching view modes or grouping changes\n    useViewModeScrollHandling({\n        containerRef,\n        viewMode,\n        grouping,\n        layout,\n        selectedItem,\n        zoomLevel,\n        resolveId,\n        data,\n        setPreSelectionState,\n    });\n\n    // Handle card selection (click)\n    const handleCardClick = useCardSelection({ ...options, resolveId });\n\n    // Handle detail panel close\n    const closeDetail = useDetailPanelClose({\n        selectedItem,\n        preSelectionState,\n        zoomLevel,\n        viewMode,\n        layout,\n        containerRef,\n        containerDimensions,\n        grouping,\n        data,\n        resolveId,\n        setZoomLevel,\n        setIsZooming,\n        setSelectedItem,\n        setPreSelectionState,\n    });\n\n    return { resolveId, handleCardClick, closeDetail };\n}\n"],"names":[],"mappings":";;;;;;;;AAgCM,SAAU,0BAA0B,CACtC,OAAiD,EAAA;AAEjD,IAAA,MAAM,EACF,IAAI,EACJ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,oBAAoB,GACvB,GAAG,OAAO;IAEX,MAAM,SAAS,GAAG,WAAW,CACzB,CAAC,IAAW,KAAK,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,EAChE,CAAC,IAAI,EAAE,SAAS,CAAC,CACpB;AAGD,IAAA,wBAAwB,CACpB,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,gBAAgB,CACnB;AAGD,IAAA,aAAa,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC;AAGpD,IAAA,yBAAyB,CAAC;QACtB,YAAY;QACZ,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,YAAY;QACZ,SAAS;QACT,SAAS;QACT,IAAI;QACJ,oBAAoB;AACvB,KAAA,CAAC;IAGF,MAAM,eAAe,GAAG,gBAAgB,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;IAGnE,MAAM,WAAW,GAAG,mBAAmB,CAAC;QACpC,YAAY;QACZ,iBAAiB;QACjB,SAAS;QACT,QAAQ;QACR,MAAM;QACN,YAAY;QACZ,mBAAmB;QACnB,QAAQ;QACR,IAAI;QACJ,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,eAAe;QACf,oBAAoB;AACvB,KAAA,CAAC;AAEF,IAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE;AACtD;;"}

package/dist/esm/PivotViewer/hooks/useRawGrouping.d.ts

@@ -0,0 +1,22 @@
+import type { GroupSpec, GroupingResult } from '../engine/types.js';
+import type { ViewMode } from '../components/Toolbar.js';
+/** Inputs for {@link useRawGrouping}. */
+export interface UseRawGroupingOptions {
+    ready: boolean;
+    visibleIds: Uint32Array;
+    currentGroupBy: GroupSpec;
+    viewMode: ViewMode;
+    activeDimensionKey: string | null;
+    computeGrouping: (visibleIds: Uint32Array, groupBy: GroupSpec) => Promise<GroupingResult>;
+    sortIds: (visibleIds: Uint32Array, sortBy: string) => Promise<Uint32Array>;
+}
+/**
+ * Computes the (unpresented) grouping of the visible ids. Every async branch ignores a result
+ * after its dependencies change, so an older worker response can never overwrite a newer
+ * filter/search/view selection.
+ *
+ * @param options - Engine, view mode and visible ids.
+ * @returns The raw grouping result.
+ */
+export declare function useRawGrouping({ ready, visibleIds, currentGroupBy, viewMode, activeDimensionKey, computeGrouping, sortIds, }: UseRawGroupingOptions): GroupingResult;
+//# sourceMappingURL=useRawGrouping.d.ts.map

package/dist/esm/PivotViewer/hooks/useRawGrouping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRawGrouping.d.ts","sourceRoot":"","sources":["../../../../PivotViewer/hooks/useRawGrouping.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAAuB,CAAC;AAEtD,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;IACxB,cAAc,EAAE,SAAS,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1F,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9E;AAiBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAC3B,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,OAAO,GACV,EAAE,qBAAqB,GAAG,cAAc,CAsCxC"}