@buley/hexgrid-3d 3.0.1 → 3.2.0

package/dist/components/NarrationOverlay.js

@@ -0,0 +1,132 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Narration Overlay Component
+ *
+ * Displays play-by-play narration messages with sparklines in a NOC dashboard style.
+ */
+import { useEffect, useRef } from 'react';
+import { getAccentRgba, getAccentHex } from '@/lib/theme-colors';
+export const NarrationOverlay = ({ messages, statsTracker, isVisible, onClose, }) => {
+    const messagesEndRef = useRef(null);
+    const scrollContainerRef = useRef(null);
+    // Auto-scroll to latest message
+    useEffect(() => {
+        if (messagesEndRef.current && scrollContainerRef.current) {
+            scrollContainerRef.current.scrollTop =
+                scrollContainerRef.current.scrollHeight;
+        }
+    }, [messages]);
+    // Always render the overlay so fade-out can animate smoothly.
+    // Toggle visibility via styles.
+    const currentStats = statsTracker?.getCurrentStats();
+    const allTimeRecords = statsTracker?.getAllTimeRecords();
+    const leaderboard = statsTracker?.getLeaderboard(10);
+    return (_jsxs("div", { style: {
+            position: 'fixed',
+            right: 12,
+            top: 80,
+            width: 400,
+            maxHeight: 'calc(100vh - 100px)',
+            background: 'rgba(0, 0, 0, 0.85)',
+            border: `1px solid ${getAccentRgba(0.3)}`,
+            borderRadius: 8,
+            padding: '12px',
+            zIndex: 10000,
+            display: 'flex',
+            flexDirection: 'column',
+            fontFamily: "'Courier New', monospace",
+            fontSize: 12,
+            color: getAccentHex(),
+            boxShadow: `0 0 20px ${getAccentRgba(0.2)}`,
+            // Fade transition
+            transition: 'opacity 220ms ease, transform 220ms ease',
+            opacity: isVisible ? 1 : 0,
+            transform: isVisible ? 'translateY(0px)' : 'translateY(-6px)',
+            pointerEvents: isVisible ? 'auto' : 'none',
+        }, children: [_jsxs("div", { style: {
+                    display: 'flex',
+                    justifyContent: 'space-between',
+                    alignItems: 'center',
+                    marginBottom: 8,
+                }, children: [_jsx("div", { style: { fontWeight: 'bold', fontSize: 14 }, children: "Play-by-Play Narration" }), _jsx("button", { onClick: onClose, style: {
+                            background: 'transparent',
+                            border: '1px solid rgba(0, 255, 255, 0.3)',
+                            color: '#00ffff',
+                            cursor: 'pointer',
+                            padding: '4px 8px',
+                            borderRadius: 4,
+                            fontSize: 11,
+                        }, children: "\u00D7" })] }), currentStats && (_jsxs("details", { style: { marginBottom: 8, fontSize: 11 }, children: [_jsx("summary", { style: { cursor: 'pointer', color: '#00ffff', marginBottom: 4 }, children: "Stats Dashboard" }), _jsxs("div", { style: {
+                            padding: '8px',
+                            background: 'rgba(0, 255, 255, 0.05)',
+                            borderRadius: 4,
+                        }, children: [_jsxs("div", { style: {
+                                    display: 'flex',
+                                    justifyContent: 'space-between',
+                                    marginBottom: 4,
+                                }, children: [_jsx("span", { children: "Generation:" }), _jsx("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: currentStats.generation })] }), _jsxs("div", { style: {
+                                    display: 'flex',
+                                    justifyContent: 'space-between',
+                                    marginBottom: 4,
+                                }, children: [_jsx("span", { children: "Active Memes:" }), _jsx("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: currentStats.activeMemesCount })] }), _jsxs("div", { style: {
+                                    display: 'flex',
+                                    justifyContent: 'space-between',
+                                    marginBottom: 4,
+                                }, children: [_jsx("span", { children: "Total Hexes:" }), _jsx("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: currentStats.totalHexesInfected })] }), _jsxs("div", { style: {
+                                    display: 'flex',
+                                    justifyContent: 'space-between',
+                                    marginBottom: 4,
+                                }, children: [_jsx("span", { children: "Birth/Death Ratio:" }), _jsx("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: currentStats.populationStability.toFixed(2) })] }), allTimeRecords && (_jsxs("div", { style: {
+                                    marginTop: 8,
+                                    paddingTop: 8,
+                                    borderTop: '1px solid rgba(0, 255, 255, 0.2)',
+                                }, children: [_jsx("div", { style: { fontSize: 10, color: '#00ffff', marginBottom: 4 }, children: "All-Time Records:" }), _jsxs("div", { style: { fontSize: 10, marginBottom: 2 }, children: ["Highest Territory: ", allTimeRecords.highestTerritory.value] }), _jsxs("div", { style: { fontSize: 10, marginBottom: 2 }, children: ["Longest Streak: ", allTimeRecords.longestSurvivalStreak.value] })] }))] })] })), leaderboard && leaderboard.length > 0 && (_jsxs("details", { style: { marginBottom: 8, fontSize: 11 }, children: [_jsx("summary", { style: { cursor: 'pointer', color: '#00ffff', marginBottom: 4 }, children: "Top 10 Leaderboard" }), _jsx("div", { style: {
+                            padding: '8px',
+                            background: 'rgba(0, 255, 255, 0.05)',
+                            borderRadius: 4,
+                        }, children: leaderboard.map((entry, i) => (_jsxs("div", { style: {
+                                display: 'flex',
+                                justifyContent: 'space-between',
+                                marginBottom: 2,
+                                fontSize: 10,
+                                color: i < 3 ? '#00ff00' : '#00ffff',
+                            }, children: [_jsxs("span", { children: [i + 1, ". ", entry.photoId.slice(0, 20), "..."] }), _jsxs("span", { style: { fontVariantNumeric: 'tabular-nums' }, children: [entry.territory, " hexes"] })] }, entry.photoId))) })] })), _jsxs("div", { ref: scrollContainerRef, style: {
+                    flex: 1,
+                    overflowY: 'auto',
+                    maxHeight: '400px',
+                    padding: '8px',
+                    background: 'rgba(0, 0, 0, 0.3)',
+                    borderRadius: 4,
+                }, children: [messages.length === 0 ? (_jsx("div", { style: {
+                            color: 'rgba(0, 255, 255, 0.5)',
+                            fontStyle: 'italic',
+                            textAlign: 'center',
+                            padding: '20px',
+                        }, children: "No narration yet. Evolution in progress..." })) : (messages.map((msg, index) => (_jsxs("div", { style: {
+                            marginBottom: 8,
+                            padding: '6px',
+                            background: msg.priority >= 8
+                                ? 'rgba(255, 165, 0, 0.1)'
+                                : 'rgba(0, 255, 255, 0.05)',
+                            borderRadius: 4,
+                            borderLeft: `2px solid ${msg.priority >= 8 ? '#ffaa00' : '#00ffff'}`,
+                            fontSize: 11,
+                            lineHeight: 1.4,
+                        }, children: [_jsxs("div", { style: {
+                                    display: 'flex',
+                                    justifyContent: 'space-between',
+                                    marginBottom: 2,
+                                }, children: [_jsxs("span", { style: { color: 'rgba(0, 255, 255, 0.7)', fontSize: 10 }, children: ["Gen ", msg.generation] }), _jsx("span", { style: { color: 'rgba(0, 255, 255, 0.5)', fontSize: 9 }, children: new Date(msg.timestamp).toLocaleTimeString() })] }), _jsxs("div", { style: { fontFamily: "'Courier New', monospace" }, children: [msg.text, msg.sparkline && (_jsx("div", { style: {
+                                            marginTop: 4,
+                                            fontFamily: "'Courier New', monospace",
+                                            fontSize: 14,
+                                            color: msg.eventType === 'slam_dunk' ||
+                                                msg.eventType === 'on_fire'
+                                                ? '#00ff00'
+                                                : msg.eventType === 'decline' ||
+                                                    msg.eventType === 'missed_shot'
+                                                    ? '#ff4444'
+                                                    : '#00ffff',
+                                            letterSpacing: '2px',
+                                        }, children: msg.sparkline }))] })] }, `${msg.generation}-${index}`)))), _jsx("div", { ref: messagesEndRef })] })] }));
+};

package/{src/components/index.ts → dist/components/index.d.ts}

@@ -1,3 +1,3 @@
 export { HexGrid } from './HexGrid';
 export type { HexGridProps, Photo } from '../types';
-export type { Photo as PhotoType } from '../types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC"}

package/dist/components/index.js

@@ -0,0 +1 @@
+export { HexGrid } from './HexGrid';

package/dist/features.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Feature flags for HexGrid 3D
+ *
+ * Allows enabling/disabling features at runtime for different client environments
+ */
+export interface HexGridFeatureFlags {
+    /** Enable/disable play-by-play narration overlay */
+    enableNarration?: boolean;
+    /** Enable/disable statistics tracking and display */
+    enableStats?: boolean;
+    /** Enable/disable debug panel */
+    enableDebugPanel?: boolean;
+    /** Enable/disable camera controls UI */
+    enableCameraControls?: boolean;
+    /** Enable/disable worker-based rendering */
+    enableWorker?: boolean;
+    /** Enable/disable texture/image loading */
+    enableTextures?: boolean;
+    /** Enable/disable evolution/animation system */
+    enableEvolution?: boolean;
+    /** Enable/disable autoplay functionality */
+    enableAutoplay?: boolean;
+    /** Enable/disable user interactions (clicks, drags) */
+    enableInteractions?: boolean;
+    /** Enable/disable keyboard shortcuts */
+    enableKeyboardShortcuts?: boolean;
+    /** Enable/disable performance telemetry */
+    enableTelemetry?: boolean;
+    /** Enable/disable sheen/visual effects */
+    enableVisualEffects?: boolean;
+    /** Enable/disable leaderboard system */
+    enableLeaderboard?: boolean;
+}
+/**
+ * Default feature flags - all features enabled
+ */
+export declare const DEFAULT_FEATURE_FLAGS: Required<HexGridFeatureFlags>;
+/**
+ * Minimal feature flags - only core visualization
+ */
+export declare const MINIMAL_FEATURE_FLAGS: Required<HexGridFeatureFlags>;
+/**
+ * Performance-focused feature flags
+ */
+export declare const PERFORMANCE_FEATURE_FLAGS: Required<HexGridFeatureFlags>;
+/**
+ * Merge user-provided flags with defaults
+ */
+export declare function mergeFeatureFlags(userFlags?: Partial<HexGridFeatureFlags>): Required<HexGridFeatureFlags>;
+/**
+ * Check if a feature is enabled
+ */
+export declare function isFeatureEnabled(flags: HexGridFeatureFlags, feature: keyof HexGridFeatureFlags): boolean;
+//# sourceMappingURL=features.d.ts.map

package/dist/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../src/features.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,wCAAwC;IACxC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,wCAAwC;IACxC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0CAA0C;IAC1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,mBAAmB,CAc/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,mBAAmB,CAc/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,mBAAmB,CAcnE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACvC,QAAQ,CAAC,mBAAmB,CAAC,CAK/B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,mBAAmB,GACjC,OAAO,CAET"}

package/dist/features.js

@@ -0,0 +1,74 @@
+/**
+ * Feature flags for HexGrid 3D
+ *
+ * Allows enabling/disabling features at runtime for different client environments
+ */
+/**
+ * Default feature flags - all features enabled
+ */
+export const DEFAULT_FEATURE_FLAGS = {
+    enableNarration: true,
+    enableStats: true,
+    enableDebugPanel: true,
+    enableCameraControls: true,
+    enableWorker: true,
+    enableTextures: true,
+    enableEvolution: true,
+    enableAutoplay: true,
+    enableInteractions: true,
+    enableKeyboardShortcuts: true,
+    enableTelemetry: true,
+    enableVisualEffects: true,
+    enableLeaderboard: true,
+};
+/**
+ * Minimal feature flags - only core visualization
+ */
+export const MINIMAL_FEATURE_FLAGS = {
+    enableNarration: false,
+    enableStats: false,
+    enableDebugPanel: false,
+    enableCameraControls: false,
+    enableWorker: true,
+    enableTextures: true,
+    enableEvolution: false,
+    enableAutoplay: false,
+    enableInteractions: true,
+    enableKeyboardShortcuts: false,
+    enableTelemetry: false,
+    enableVisualEffects: false,
+    enableLeaderboard: false,
+};
+/**
+ * Performance-focused feature flags
+ */
+export const PERFORMANCE_FEATURE_FLAGS = {
+    enableNarration: false,
+    enableStats: true,
+    enableDebugPanel: false,
+    enableCameraControls: true,
+    enableWorker: true,
+    enableTextures: true,
+    enableEvolution: true,
+    enableAutoplay: false,
+    enableInteractions: true,
+    enableKeyboardShortcuts: true,
+    enableTelemetry: false,
+    enableVisualEffects: false,
+    enableLeaderboard: false,
+};
+/**
+ * Merge user-provided flags with defaults
+ */
+export function mergeFeatureFlags(userFlags) {
+    return {
+        ...DEFAULT_FEATURE_FLAGS,
+        ...userFlags,
+    };
+}
+/**
+ * Check if a feature is enabled
+ */
+export function isFeatureEnabled(flags, feature) {
+    return flags[feature] !== false;
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './components';
+export * from './stores';
+export * from './features';
+export * from './workers/hexgrid-math';
+export * from './utils/image-utils';
+export type { WorkerDebug, Photo, GridItem } from './types';
+export * from './math';
+export * from './algorithms';
+export * from './HexGridEnhanced';
+export * from './wasm';
+export * from './Snapshot';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAG3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG5D,cAAc,QAAQ,CAAC;AAGvB,cAAc,cAAc,CAAC;AAG7B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,QAAQ,CAAC;AAGvB,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// Main package exports
+export * from './components';
+export * from './stores';
+export * from './features';
+// Export pure mathematical functions
+export * from './workers/hexgrid-math';
+export * from './utils/image-utils';
+// Math library
+export * from './math';
+// Algorithms (graph, clustering, flow, particles, fluid)
+export * from './algorithms';
+// Enhanced HexGrid
+export * from './HexGridEnhanced';
+// WASM acceleration layer
+export * from './wasm';
+// Unified Snapshot API
+export * from './Snapshot';

package/dist/lib/narration.d.ts

@@ -0,0 +1,12 @@
+export interface NarrationMessage {
+    generation: number;
+    timestamp: string;
+    priority: number;
+    text: string;
+    eventType?: string;
+    sparkline?: string;
+}
+export declare class NarrationManager {
+    static getInstance(): any;
+}
+//# sourceMappingURL=narration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"narration.d.ts","sourceRoot":"","sources":["../../src/lib/narration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,WAAW,IAAI,GAAG;CAM1B"}

package/dist/lib/narration.js

@@ -0,0 +1,8 @@
+export class NarrationManager {
+    static getInstance() {
+        return {
+            subscribe: () => () => { },
+            getState: () => ({})
+        };
+    }
+}

package/dist/lib/stats-tracker.d.ts

@@ -0,0 +1,7 @@
+export declare class StatsTracker {
+    static getInstance(): StatsTracker;
+    getCurrentStats(): any;
+    getAllTimeRecords(): any;
+    getLeaderboard(limit: number): any[];
+}
+//# sourceMappingURL=stats-tracker.d.ts.map

package/dist/lib/stats-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-tracker.d.ts","sourceRoot":"","sources":["../../src/lib/stats-tracker.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IACvB,MAAM,CAAC,WAAW,IAAI,YAAY;IAIlC,eAAe,IAAI,GAAG;IAStB,iBAAiB,IAAI,GAAG;IAOxB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE;CAGrC"}

package/dist/lib/stats-tracker.js

@@ -0,0 +1,22 @@
+export class StatsTracker {
+    static getInstance() {
+        return new StatsTracker();
+    }
+    getCurrentStats() {
+        return {
+            generation: 1,
+            activeMemesCount: 10,
+            totalHexesInfected: 100,
+            populationStability: 0.5
+        };
+    }
+    getAllTimeRecords() {
+        return {
+            highestTerritory: { value: 100 },
+            longestSurvivalStreak: { value: 50 }
+        };
+    }
+    getLeaderboard(limit) {
+        return [];
+    }
+}

package/dist/lib/theme-colors.d.ts

@@ -0,0 +1,7 @@
+export declare const ThemeColors: {
+    primary: string;
+    secondary: string;
+};
+export declare function getAccentRgba(alpha?: number): string;
+export declare function getAccentHex(): string;
+//# sourceMappingURL=theme-colors.d.ts.map

package/dist/lib/theme-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-colors.d.ts","sourceRoot":"","sources":["../../src/lib/theme-colors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAU,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/lib/theme-colors.js

@@ -0,0 +1,10 @@
+export const ThemeColors = {
+    primary: '#000000',
+    secondary: '#ffffff'
+};
+export function getAccentRgba(alpha = 1) {
+    return `rgba(0, 255, 255, ${alpha})`;
+}
+export function getAccentHex() {
+    return '#00ffff';
+}

package/dist/math/HexCoordinates.d.ts

@@ -0,0 +1,140 @@
+import { Vector3 } from './Vector3';
+export declare class Axial {
+    q: number;
+    r: number;
+    constructor(q: number, r: number);
+    get s(): number;
+    static zero(): Axial;
+    static fromCube(cube: Cube): Axial;
+    static fromOffset(offset: {
+        col: number;
+        row: number;
+    }, isOdd?: boolean): Axial;
+    static fromPixel(x: number, y: number, hexSize: number, isFlatTop?: boolean): Axial;
+    static round(q: number, r: number): Axial;
+    static fromKey(key: string): Axial;
+    clone(): Axial;
+    equals(other: Axial): boolean;
+    add(other: Axial): Axial;
+    subtract(other: Axial): Axial;
+    scale(factor: number): Axial;
+    toCube(): Cube;
+    toOffset(isOdd?: boolean): {
+        col: number;
+        row: number;
+    };
+    toPixel(hexSize: number, isFlatTop?: boolean): {
+        x: number;
+        y: number;
+    };
+    toKey(): string;
+    toString(): string;
+    distanceTo(other: Axial): number;
+    neighbors(): Axial[];
+    neighbor(directionIndex: number): Axial;
+    range(radius: number): Axial[];
+    ring(radius: number): Axial[];
+    spiral(radius: number): Axial[];
+    lineTo(other: Axial): Axial[];
+    rotateCW(): Axial;
+    rotateCCW(): Axial;
+    rotateAroundCW(center: Axial): Axial;
+    rotateAroundCCW(center: Axial): Axial;
+    reflectQ(): Axial;
+    reflectR(): Axial;
+    reflectS(): Axial;
+}
+export declare class Cube {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+    static zero(): Cube;
+    static fromAxial(axial: Axial): Cube;
+    static round(x: number, y: number, z: number): Cube;
+    clone(): Cube;
+    equals(other: Cube): boolean;
+    add(other: Cube): Cube;
+    subtract(other: Cube): Cube;
+    scale(factor: number): Cube;
+    distanceTo(other: Cube): number;
+    toAxial(): Axial;
+    neighbors(): Cube[];
+    neighbor(index: number): Cube;
+    lerp(other: Cube, t: number): Cube;
+    lineTo(other: Cube): Cube[];
+    rotateCW(): Cube;
+    rotateCCW(): Cube;
+    rotate(steps: number): Cube;
+    reflect(): Cube;
+    toString(): string;
+    toKey(): string;
+}
+export declare const AXIAL_DIRECTIONS: Axial[];
+export declare const CUBE_DIRECTIONS: Cube[];
+export declare class GeodesicHexGrid {
+    subdivisions: number;
+    vertices: Vector3[];
+    hexCenters: Vector3[];
+    neighbors: number[][];
+    _hexSides: number[];
+    _hexIsPentagon: boolean[];
+    constructor(subdivisions?: number);
+    private generate;
+    findHex(point: Vector3): number;
+    latLngToHex(lat: number, lng: number): number;
+    hexToLatLng(index: number): {
+        lat: number;
+        lng: number;
+    };
+    getHexSides(index: number): number;
+    isPentagon(index: number): boolean;
+    getHexesInRange(index: number, range: number): number[];
+    distanceBetweenHexes(a: number, b: number): number;
+}
+export declare class HEALPixGrid {
+    nside: number;
+    npix: number;
+    pixelArea: number;
+    constructor(nside?: number);
+    pixToAng(pix: number): {
+        theta: number;
+        phi: number;
+    };
+    angToPix(theta: number, phi: number): number;
+    latLngToPix(lat: number, lng: number): number;
+    pixToLatLng(pix: number): {
+        lat: number;
+        lng: number;
+    };
+    getNeighbors(pix: number): number[];
+    pixToVector(pix: number): Vector3;
+    getAllCenters(): Vector3[];
+}
+export declare function generateFlatHexGrid(config: {
+    radius: number;
+    width: number;
+    height: number;
+    flatTop?: boolean;
+}): {
+    positions: {
+        x: number;
+        y: number;
+    }[];
+    axialCoords: Axial[];
+    neighbors: number[][];
+};
+export declare function generateSphericalHexGrid(config: {
+    hexRadius: number;
+    sphereRadius: number;
+    latRange?: [number, number];
+    lngRange?: [number, number];
+}): {
+    positions: Vector3[];
+    geoCoords: {
+        lat: number;
+        lng: number;
+    }[];
+    neighbors: number[][];
+};
+//# sourceMappingURL=HexCoordinates.d.ts.map

package/dist/math/HexCoordinates.d.ts.map

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