@buley/hexgrid-3d 3.5.1 → 3.6.1

package/dist/territory/HexTerritoryGlobe.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { type HexTerritoryCell } from './globe';
+export interface HexTerritoryGlobeProps {
+    cells: HexTerritoryCell[];
+    selectedCellId?: string | null;
+    hoverCellId?: string | null;
+    claimedCellIds?: Iterable<string>;
+    lockedCellIds?: Iterable<string>;
+    colorsByCellId?: Record<string, string>;
+    tileRadius?: number;
+    onSelectCell?: (cell: HexTerritoryCell) => void;
+    onHoverCell?: (cell: HexTerritoryCell | null) => void;
+}
+export declare function HexTerritoryGlobe({ cells, selectedCellId, hoverCellId, claimedCellIds, lockedCellIds, colorsByCellId, tileRadius, onSelectCell, onHoverCell, }: HexTerritoryGlobeProps): React.JSX.Element;
+//# sourceMappingURL=HexTerritoryGlobe.d.ts.map

package/dist/territory/HexTerritoryGlobe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HexTerritoryGlobe.d.ts","sourceRoot":"","sources":["../../src/territory/HexTerritoryGlobe.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAG1D,OAAO,EAAgC,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CACvD;AAMD,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,cAAqB,EACrB,WAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,EAAE,sBAAsB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6F5C"}

package/dist/territory/HexTerritoryGlobe.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from 'react';
+import { Color, CircleGeometry, Matrix4, Object3D } from 'three';
+import { calculateAutoTileRadiusByRow } from './globe';
+function asSet(values) {
+    return values ? new Set(values) : new Set();
+}
+export function HexTerritoryGlobe({ cells, selectedCellId = null, hoverCellId = null, claimedCellIds, lockedCellIds, colorsByCellId, tileRadius, onSelectCell, onHoverCell, }) {
+    const meshRef = useRef(null);
+    const geometry = useMemo(() => new CircleGeometry(1, 6), []);
+    const workingObject = useMemo(() => new Object3D(), []);
+    const claimed = useMemo(() => asSet(claimedCellIds), [claimedCellIds]);
+    const locked = useMemo(() => asSet(lockedCellIds), [lockedCellIds]);
+    const autoTileRadiusByRow = useMemo(() => tileRadius === undefined ? calculateAutoTileRadiusByRow(cells) : undefined, [cells, tileRadius]);
+    useEffect(() => {
+        const mesh = meshRef.current;
+        if (!mesh) {
+            return;
+        }
+        const matrix = new Matrix4();
+        cells.forEach((cell, index) => {
+            const point = cell.surfacePoint;
+            const effectiveTileRadius = tileRadius ?? autoTileRadiusByRow?.get(cell.rowIndex) ?? 0;
+            workingObject.position.set(point.x, point.y, point.z);
+            workingObject.lookAt(point.x * 2, point.y * 2, point.z * 2);
+            workingObject.scale.setScalar(effectiveTileRadius);
+            workingObject.updateMatrix();
+            matrix.copy(workingObject.matrix);
+            mesh.setMatrixAt(index, matrix);
+            const baseColor = locked.has(cell.cellId)
+                ? '#23345c'
+                : colorsByCellId?.[cell.cellId] ??
+                    (selectedCellId === cell.cellId
+                        ? '#7ee7ff'
+                        : hoverCellId === cell.cellId
+                            ? '#59d0ff'
+                            : claimed.has(cell.cellId)
+                                ? '#63f2c6'
+                                : '#1f2a4a');
+            mesh.setColorAt(index, new Color(baseColor));
+        });
+        mesh.instanceMatrix.needsUpdate = true;
+        if (mesh.instanceColor) {
+            mesh.instanceColor.needsUpdate = true;
+        }
+    }, [
+        cells,
+        claimed,
+        colorsByCellId,
+        hoverCellId,
+        locked,
+        selectedCellId,
+        tileRadius,
+        autoTileRadiusByRow,
+        workingObject,
+    ]);
+    return (_jsx("instancedMesh", { ref: meshRef, args: [geometry, undefined, cells.length], onClick: (event) => {
+            if (typeof event.instanceId !== 'number') {
+                return;
+            }
+            const cell = cells[event.instanceId];
+            if (cell) {
+                onSelectCell?.(cell);
+            }
+        }, onPointerMove: (event) => {
+            if (typeof event.instanceId !== 'number') {
+                onHoverCell?.(null);
+                return;
+            }
+            const cell = cells[event.instanceId];
+            onHoverCell?.(cell ?? null);
+        }, onPointerOut: () => {
+            onHoverCell?.(null);
+        }, children: _jsx("meshStandardMaterial", { transparent: true, opacity: 0.92, metalness: 0.14, roughness: 0.42 }) }));
+}

package/dist/territory/globe.d.ts

@@ -0,0 +1,54 @@
+export interface CanonicalHexGlobeConfig {
+    boardId: string;
+    curveUDeg: number;
+    curveVDeg: number;
+    rowCount: number;
+    equatorColumns: number;
+    minimumColumnsPerRow: number;
+    poleMinScale: number;
+    sphereRadius?: number;
+}
+export type HexSubdivisionSegment = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export type HexNodePath = HexSubdivisionSegment[];
+export type HexwarEmbedProvider = 'youtube' | 'x' | 'instagram' | 'threads' | 'tiktok';
+export interface HexwarEmbedRef {
+    provider: HexwarEmbedProvider;
+    submittedUrl: string;
+    canonicalUrl: string;
+    kind: 'video' | 'post' | 'thread' | 'short' | 'reel';
+    title?: string;
+    authorName?: string;
+    thumbnailUrl?: string;
+    embedAllowed: boolean;
+}
+export interface HexTerritoryTickState {
+    stage: 'dormant' | 'active' | 'surging' | 'entrenched' | 'fading';
+    energy: number;
+    pressure: number;
+    cohesion: number;
+    lastResolvedAt: number;
+}
+export interface HexTerritoryCellPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface HexTerritoryCell {
+    cellId: string;
+    rowIndex: number;
+    columnIndex: number;
+    columnCount: number;
+    lat: number;
+    lon: number;
+    surfacePoint: HexTerritoryCellPoint;
+    neighborCellIds: string[];
+}
+export interface HexTerritoryBoard {
+    boardId: string;
+    config: CanonicalHexGlobeConfig;
+    configHash: string;
+    cells: HexTerritoryCell[];
+}
+export declare function generateCanonicalHexGlobe(config: CanonicalHexGlobeConfig): HexTerritoryBoard;
+export declare function calculateAutoTileRadiusByRow(cells: readonly HexTerritoryCell[]): Map<number, number>;
+//# sourceMappingURL=globe.d.ts.map

package/dist/territory/globe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globe.d.ts","sourceRoot":"","sources":["../../src/territory/globe.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,GAAG,GACH,WAAW,GACX,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,qBAAqB,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AA2HD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAoDnB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiErB"}

package/dist/territory/globe.js

@@ -0,0 +1,180 @@
+const boardCache = new Map();
+const HEX_HORIZONTAL_RADIUS_RATIO = Math.sqrt(3);
+const HEX_VERTICAL_RADIUS_RATIO = 1.5;
+const TERRITORY_TILE_RADIUS_SAFETY_MARGIN = 0.96;
+function toRadians(value) {
+    return (value * Math.PI) / 180;
+}
+function normalizeLongitude(value) {
+    let next = value;
+    while (next < -180) {
+        next += 360;
+    }
+    while (next >= 180) {
+        next -= 360;
+    }
+    return next;
+}
+function buildConfigHash(config) {
+    return [
+        config.boardId,
+        config.curveUDeg,
+        config.curveVDeg,
+        config.rowCount,
+        config.equatorColumns,
+        config.minimumColumnsPerRow,
+        config.poleMinScale,
+        config.sphereRadius ?? 1,
+    ].join(':');
+}
+function toSurfacePoint(lat, lon, sphereRadius) {
+    const latRadians = toRadians(lat);
+    const lonRadians = toRadians(lon);
+    const cosLat = Math.cos(latRadians);
+    return {
+        x: sphereRadius * cosLat * Math.cos(lonRadians),
+        y: sphereRadius * Math.sin(latRadians),
+        z: sphereRadius * cosLat * Math.sin(lonRadians),
+    };
+}
+function shortestWrappedDistance(a, b) {
+    const delta = Math.abs(a - b);
+    return Math.min(delta, 360 - delta);
+}
+function pointDistance(left, right) {
+    const dx = left.x - right.x;
+    const dy = left.y - right.y;
+    const dz = left.z - right.z;
+    return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+function columnCountForLatitude(latitude, config) {
+    const cosScale = Math.abs(Math.cos(toRadians(latitude)));
+    const scaled = Math.max(config.poleMinScale, cosScale);
+    return Math.max(config.minimumColumnsPerRow, Math.round(config.equatorColumns * scaled));
+}
+function findClosestColumns(rowCells, lon) {
+    const ranked = rowCells
+        .map((cell) => ({
+        cell,
+        distance: shortestWrappedDistance(cell.lon, lon),
+    }))
+        .sort((left, right) => left.distance - right.distance);
+    return ranked.slice(0, Math.min(3, ranked.length)).map((item) => item.cell);
+}
+function buildNeighbors(cell, rows) {
+    const currentRow = rows[cell.rowIndex] ?? [];
+    const neighborIds = new Set();
+    const sameRowCount = currentRow.length;
+    if (sameRowCount > 1) {
+        const left = currentRow[(cell.columnIndex - 1 + sameRowCount) % sameRowCount] ?? null;
+        const right = currentRow[(cell.columnIndex + 1) % sameRowCount] ?? null;
+        if (left) {
+            neighborIds.add(left.cellId);
+        }
+        if (right) {
+            neighborIds.add(right.cellId);
+        }
+    }
+    const adjacentRows = [cell.rowIndex - 1, cell.rowIndex + 1];
+    for (const rowIndex of adjacentRows) {
+        const row = rows[rowIndex] ?? [];
+        for (const adjacent of findClosestColumns(row, cell.lon)) {
+            neighborIds.add(adjacent.cellId);
+        }
+    }
+    return Array.from(neighborIds);
+}
+export function generateCanonicalHexGlobe(config) {
+    const configHash = buildConfigHash(config);
+    const cached = boardCache.get(configHash);
+    if (cached) {
+        return cached;
+    }
+    const sphereRadius = config.sphereRadius ?? 1;
+    const rows = [];
+    for (let rowIndex = 0; rowIndex < config.rowCount; rowIndex += 1) {
+        const latitudeProgress = config.rowCount <= 1 ? 0 : rowIndex / (config.rowCount - 1);
+        const lat = -90 + latitudeProgress * 180;
+        const columnCount = columnCountForLatitude(lat, config);
+        const lonStep = 360 / columnCount;
+        const lonOffset = rowIndex % 2 === 0 ? 0 : lonStep / 2;
+        const rowCells = [];
+        for (let columnIndex = 0; columnIndex < columnCount; columnIndex += 1) {
+            const lon = normalizeLongitude(-180 + lonOffset + columnIndex * lonStep + lonStep / 2);
+            rowCells.push({
+                cellId: `${config.boardId}:r${rowIndex}:c${columnIndex}`,
+                rowIndex,
+                columnIndex,
+                columnCount,
+                lat,
+                lon,
+                surfacePoint: toSurfacePoint(lat, lon, sphereRadius),
+                neighborCellIds: [],
+            });
+        }
+        rows.push(rowCells);
+    }
+    for (const row of rows) {
+        for (const cell of row) {
+            cell.neighborCellIds = buildNeighbors(cell, rows);
+        }
+    }
+    const board = {
+        boardId: config.boardId,
+        config,
+        configHash,
+        cells: rows.flat(),
+    };
+    boardCache.set(configHash, board);
+    return board;
+}
+export function calculateAutoTileRadiusByRow(cells) {
+    const rowMap = new Map();
+    const cellById = new Map();
+    for (const cell of cells) {
+        const row = rowMap.get(cell.rowIndex);
+        if (row) {
+            row.push(cell);
+        }
+        else {
+            rowMap.set(cell.rowIndex, [cell]);
+        }
+        cellById.set(cell.cellId, cell);
+    }
+    const radiusByRow = new Map();
+    for (const [rowIndex, unsortedRow] of rowMap.entries()) {
+        const row = [...unsortedRow].sort((left, right) => left.columnIndex - right.columnIndex);
+        let minimumSameRowDistance = Number.POSITIVE_INFINITY;
+        let minimumAdjacentRowDistance = Number.POSITIVE_INFINITY;
+        if (row.length > 1) {
+            for (let columnIndex = 0; columnIndex < row.length; columnIndex += 1) {
+                const current = row[columnIndex];
+                const next = row[(columnIndex + 1) % row.length];
+                if (current && next) {
+                    minimumSameRowDistance = Math.min(minimumSameRowDistance, pointDistance(current.surfacePoint, next.surfacePoint));
+                }
+            }
+        }
+        for (const cell of row) {
+            for (const neighborId of cell.neighborCellIds) {
+                const neighbor = cellById.get(neighborId);
+                if (!neighbor || Math.abs(neighbor.rowIndex - rowIndex) !== 1) {
+                    continue;
+                }
+                minimumAdjacentRowDistance = Math.min(minimumAdjacentRowDistance, pointDistance(cell.surfacePoint, neighbor.surfacePoint));
+            }
+        }
+        const horizontalRadius = Number.isFinite(minimumSameRowDistance)
+            ? minimumSameRowDistance / HEX_HORIZONTAL_RADIUS_RATIO
+            : Number.POSITIVE_INFINITY;
+        const verticalRadius = Number.isFinite(minimumAdjacentRowDistance)
+            ? minimumAdjacentRowDistance / HEX_VERTICAL_RADIUS_RATIO
+            : Number.POSITIVE_INFINITY;
+        const unconstrainedRadius = Math.min(horizontalRadius, verticalRadius);
+        const safeRadius = Number.isFinite(unconstrainedRadius) && unconstrainedRadius > 0
+            ? unconstrainedRadius * TERRITORY_TILE_RADIUS_SAFETY_MARGIN
+            : 0;
+        radiusByRow.set(rowIndex, safeRadius);
+    }
+    return radiusByRow;
+}

package/dist/territory/index.d.ts

@@ -0,0 +1,4 @@
+export * from './globe';
+export * from './narration';
+export * from './HexTerritoryGlobe';
+//# sourceMappingURL=index.d.ts.map

package/dist/territory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/territory/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC"}

package/dist/territory/index.js

@@ -0,0 +1,3 @@
+export * from './globe';
+export * from './narration';
+export * from './HexTerritoryGlobe';

package/dist/territory/narration.d.ts

@@ -0,0 +1,12 @@
+import type { NarrationMessage } from '../lib/narration';
+export type HexwarNarrationEventType = 'claim' | 'embed_set' | 'delegation_issued' | 'delegation_revoked' | 'unlock' | 'tick_surged' | 'tick_entrenched' | 'leaderboard_flip';
+export interface HexwarNarrationEvent {
+    id: string;
+    eventType: HexwarNarrationEventType;
+    occurredAtMs: number;
+    actorName?: string;
+    cellId?: string;
+    details?: Record<string, string | number | boolean | null | undefined>;
+}
+export declare function createHexwarNarrationAdapter(events: HexwarNarrationEvent[]): NarrationMessage[];
+//# sourceMappingURL=narration.d.ts.map

package/dist/territory/narration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration.d.ts","sourceRoot":"","sources":["../../src/territory/narration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,wBAAwB,GAChC,OAAO,GACP,WAAW,GACX,mBAAmB,GACnB,oBAAoB,GACpB,QAAQ,GACR,aAAa,GACb,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,wBAAwB,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACxE;AAgDD,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,EAAE,GAC7B,gBAAgB,EAAE,CAmDpB"}

package/dist/territory/narration.js

@@ -0,0 +1,84 @@
+function priorityForEvent(eventType) {
+    switch (eventType) {
+        case 'leaderboard_flip':
+        case 'unlock':
+            return 9;
+        case 'tick_surged':
+        case 'tick_entrenched':
+            return 8;
+        case 'claim':
+            return 7;
+        case 'delegation_issued':
+        case 'delegation_revoked':
+            return 6;
+        case 'embed_set':
+            return 5;
+        default:
+            return 4;
+    }
+}
+function formatSingleEvent(event) {
+    const actor = event.actorName ? `${event.actorName} ` : '';
+    const cell = event.cellId ? ` ${event.cellId}` : '';
+    switch (event.eventType) {
+        case 'claim':
+            return `${actor}claimed root${cell}.`.trim();
+        case 'embed_set':
+            return `${actor}repointed the frontier payload${cell}.`.trim();
+        case 'delegation_issued':
+            return `${actor}delegated subhex control${cell}.`.trim();
+        case 'delegation_revoked':
+            return `${actor}revoked delegated control${cell}.`.trim();
+        case 'unlock':
+            return `A new latitude band unlocked${cell}.`.trim();
+        case 'tick_surged':
+            return `Hourly pressure pushed${cell} into surge state.`.trim();
+        case 'tick_entrenched':
+            return `${cell.trim()} entrenched after the latest tick.`.trim();
+        case 'leaderboard_flip':
+            return `The leaderboard flipped after the latest tick.`.trim();
+        default:
+            return 'Frontier activity updated.';
+    }
+}
+export function createHexwarNarrationAdapter(events) {
+    if (events.length === 0) {
+        return [];
+    }
+    const sorted = [...events].sort((left, right) => left.occurredAtMs - right.occurredAtMs);
+    const messages = [];
+    let currentBurst = [];
+    for (const event of sorted) {
+        const previous = currentBurst[currentBurst.length - 1];
+        const isBurstContinuation = previous &&
+            previous.eventType === event.eventType &&
+            event.occurredAtMs - previous.occurredAtMs <= 30000;
+        if (!isBurstContinuation && currentBurst.length > 0) {
+            const first = currentBurst[0];
+            messages.push({
+                generation: 0,
+                timestamp: new Date(first.occurredAtMs).toISOString(),
+                priority: priorityForEvent(first.eventType),
+                text: currentBurst.length === 1
+                    ? formatSingleEvent(first)
+                    : `${currentBurst.length} ${first.eventType.replace(/_/g, ' ')} events rippled across the frontier.`,
+                eventType: first.eventType,
+            });
+            currentBurst = [];
+        }
+        currentBurst.push(event);
+    }
+    if (currentBurst.length > 0) {
+        const first = currentBurst[0];
+        messages.push({
+            generation: 0,
+            timestamp: new Date(first.occurredAtMs).toISOString(),
+            priority: priorityForEvent(first.eventType),
+            text: currentBurst.length === 1
+                ? formatSingleEvent(first)
+                : `${currentBurst.length} ${first.eventType.replace(/_/g, ' ')} events rippled across the frontier.`,
+            eventType: first.eventType,
+        });
+    }
+    return messages;
+}

package/dist/types.d.ts

@@ -123,4 +123,169 @@ export interface WorkerDebug {
     batchPerFrame: number;
     [key: string]: any;
 }
+/** Built-in 3D primitive shapes for game pieces */
+export type PieceShape = 'sphere' | 'cube' | 'cone' | 'cylinder' | 'pyramid' | 'torus' | 'ring' | 'flag' | 'star' | 'diamond' | 'capsule' | 'octahedron' | 'dodecahedron' | 'icosahedron';
+/** Animation presets that can be applied to game pieces */
+export type PieceAnimation = 'none' | 'spin' | 'bob' | 'pulse' | 'wobble' | 'orbit' | 'glow';
+/** Animation configuration */
+export interface PieceAnimationConfig {
+    type: PieceAnimation;
+    speed?: number;
+    amplitude?: number;
+    axis?: [number, number, number];
+    phase?: number;
+}
+/**
+ * A game piece placed on a hex cell.
+ *
+ * Supports three rendering modes:
+ * 1. **Primitive shape** — set `shape` to a PieceShape string.
+ * 2. **Custom Three.js Object3D** — set `object3D` to any Object3D instance.
+ *    The renderer will clone it and place it on the hex surface.
+ * 3. **GLTF/GLB model URL** — set `modelUrl` to a URL pointing to a .glb/.gltf.
+ *    The renderer loads it asynchronously and caches the geometry.
+ */
+export interface GamePiece {
+    id: string;
+    shape?: PieceShape;
+    /** Arbitrary Three.js Object3D (mesh, group, sprite, etc.) */
+    object3D?: unknown;
+    /** URL to a .glb / .gltf model */
+    modelUrl?: string;
+    color?: string;
+    emissive?: string;
+    emissiveIntensity?: number;
+    opacity?: number;
+    metalness?: number;
+    roughness?: number;
+    wireframe?: boolean;
+    scale?: number | [number, number, number];
+    offsetY?: number;
+    rotationY?: number;
+    animation?: PieceAnimation | PieceAnimationConfig;
+    label?: string;
+    labelColor?: string;
+    tooltip?: string;
+    count?: number;
+    stackStyle?: 'badge' | 'stack' | 'ring';
+    interactive?: boolean;
+    draggable?: boolean;
+    layer?: number;
+    group?: string;
+}
+/** Fog of war visibility levels */
+export type FogLevel = 'visible' | 'explored' | 'dim' | 'hidden';
+/** Cell highlight modes */
+export type CellHighlight = 'none' | 'selected' | 'hover' | 'attack-target' | 'move-target' | 'great-circle' | 'path' | 'danger' | 'friendly' | 'contested' | string;
+/** Border style for cell outlines */
+export interface CellBorder {
+    color: string;
+    width?: number;
+    style?: 'solid' | 'dashed' | 'glow' | 'pulse';
+    emissive?: boolean;
+}
+/**
+ * Complete game state for a single cell on the sphere.
+ * Pass a `Map<number, CellGameState>` to GameSphere to overlay game state on the geodesic grid.
+ */
+export interface CellGameState {
+    ownerId?: string;
+    ownerColor?: string;
+    ownerColorIntensity?: number;
+    pieces?: GamePiece[];
+    fogLevel?: FogLevel;
+    highlight?: CellHighlight;
+    highlightColor?: string;
+    highlightIntensity?: number;
+    border?: CellBorder;
+    terrainType?: string;
+    terrainColor?: string;
+    cellLabel?: string;
+    cellLabelColor?: string;
+    cellLabelSize?: number;
+    elevation?: number;
+    isPentagon?: boolean;
+    data?: Record<string, unknown>;
+}
+/**
+ * Configuration for the GameSphere's visual appearance.
+ */
+export interface GameSphereConfig {
+    subdivisions?: number;
+    sphereRadius?: number;
+    cameraDistance?: number;
+    cameraFov?: number;
+    enableOrbitControls?: boolean;
+    autoRotate?: boolean;
+    autoRotateSpeed?: number;
+    ambientLightIntensity?: number;
+    directionalLightIntensity?: number;
+    directionalLightPosition?: [number, number, number];
+    hexBaseColor?: string;
+    hexBorderColor?: string;
+    hexBorderWidth?: number;
+    pentagonBaseColor?: string;
+    pentagonBorderColor?: string;
+    fogDimColor?: string;
+    fogHiddenColor?: string;
+    fogExploredColor?: string;
+    defaultPieceScale?: number;
+    defaultPieceColor?: string;
+    enableRaycasting?: boolean;
+    enableDragDrop?: boolean;
+    hoverHighlightColor?: string;
+    enableBloom?: boolean;
+    enableShadows?: boolean;
+    enableAntialias?: boolean;
+    enableInstancing?: boolean;
+    maxVisiblePieces?: number;
+    pixelRatio?: number;
+}
+/**
+ * Events emitted by the GameSphere component.
+ */
+export interface GameSphereEvents {
+    /** Cell was clicked */
+    onCellClick?: (cellIndex: number, event: {
+        shiftKey: boolean;
+        ctrlKey: boolean;
+    }) => void;
+    /** Cell hover entered */
+    onCellHover?: (cellIndex: number | null) => void;
+    /** A piece was clicked */
+    onPieceClick?: (cellIndex: number, piece: GamePiece) => void;
+    /** A piece was dragged from one cell to another */
+    onPieceDrop?: (fromCell: number, toCell: number, piece: GamePiece) => void;
+    /** Camera moved (for syncing external UI) */
+    onCameraChange?: (position: [number, number, number], target: [number, number, number]) => void;
+    /** Render frame callback (for custom overlays) */
+    onFrame?: (deltaTime: number) => void;
+}
+/**
+ * Props for the GameSphere component — the 3D board game renderer.
+ */
+export interface GameSphereProps {
+    /** Game state per cell. Key = cell index from GeodesicHexGrid. */
+    cellGameState?: Map<number, CellGameState>;
+    /** Visual and behavior configuration */
+    config?: GameSphereConfig;
+    /** Event callbacks */
+    events?: GameSphereEvents;
+    /** Width of the canvas (default '100%') */
+    width?: number | string;
+    /** Height of the canvas (default '100%') */
+    height?: number | string;
+    /** CSS class for the container */
+    className?: string;
+    /** Inline styles for the container */
+    style?: React.CSSProperties;
+    /** Optional ref to the Three.js renderer for external access */
+    rendererRef?: RefObject<unknown>;
+    /** Optional ref to the Three.js scene for injecting custom objects */
+    sceneRef?: RefObject<unknown>;
+    /** Pauses rendering when true (e.g. modal open) */
+    paused?: boolean;
+    /** Children rendered as React overlay on top of the canvas */
+    children?: React.ReactNode;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IAGd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IAEnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,IAAI,CAAC,EAAE,CAAC,CAAC;IAGT,gBAAgB,CAAC,EAAE;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,UAAU,CAAC,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IAGF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,KAAK,IAAI,CAAC;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buley/hexgrid-3d",
-  "version": "3.5.1",
+  "version": "3.6.1",
   "description": "3D hexagonal grid visualization component for React",
   "type": "module",
   "main": "./dist/index.js",
@@ -65,6 +65,7 @@
     "three"
   ],
   "peerDependencies": {
+    "@react-three/fiber": "^9.4.2",
     "next": "^14.0.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
@@ -80,6 +81,7 @@
     "@types/react": "^18.3.27",
     "@types/three": "^0.183.1",
     "@types/react-dom": "^18.3.7",
+    "@react-three/fiber": "^9.4.2",
     "happy-dom": "^20.3.3",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",