@bendyline/squisq 0.1.1

package/dist/spatial/index.d.ts

@@ -0,0 +1,111 @@
+import { C as Coordinates } from '../Types-sh2VRxfo.js';
+
+/**
+ * Haversine Distance Calculation
+ *
+ * Provides accurate distance calculation between two geographic coordinates
+ * using the Haversine formula, which accounts for Earth's curvature.
+ */
+
+/**
+ * Calculate distance between two coordinates using Haversine formula.
+ *
+ * @param from Start coordinates
+ * @param to End coordinates
+ * @returns Distance in kilometers
+ */
+declare function haversineDistance(from: Coordinates, to: Coordinates): number;
+/**
+ * Calculate bearing from one coordinate to another.
+ *
+ * @param from Start coordinates
+ * @param to End coordinates
+ * @returns Bearing in degrees (0-360, where 0 = north, 90 = east)
+ */
+declare function calculateBearing(from: Coordinates, to: Coordinates): number;
+
+/**
+ * Geohash Utilities
+ *
+ * Provides geohash encoding/decoding and spatial utilities using the standard
+ * ngeohash library for core operations, plus custom utilities for overlap checking
+ * and distance calculation.
+ *
+ * Geohashes are a hierarchical spatial indexing system that divides the world
+ * into a grid of cells. Each additional character narrows the area by ~1/32.
+ *
+ * Precision guide:
+ * - 4 chars: ~39km x 19km (used for tile indexing)
+ * - 5 chars: ~5km x 5km
+ * - 6 chars: ~1.2km x 0.6km
+ */
+/**
+ * Encode latitude/longitude to a geohash string.
+ * Uses the standard ngeohash library.
+ */
+declare function encodeGeohash(lat: number, lng: number, precision?: number): string;
+/**
+ * Decode a geohash to latitude/longitude center with error bounds.
+ * Uses the standard ngeohash library.
+ */
+declare function decodeGeohash(hash: string): {
+    lat: number;
+    lng: number;
+    latErr: number;
+    lngErr: number;
+};
+/**
+ * Get the 8 neighboring geohash cells.
+ * Returns up to 8 neighbors (fewer at poles or antimeridian).
+ * Uses the standard ngeohash library.
+ */
+declare function getNeighbors(hash: string): string[];
+/**
+ * Get a 3x3 grid of geohash4 cells (center + 8 neighbors).
+ * Used for landing bonus expansions in Fly mode.
+ *
+ * @param geohash4 - Center geohash4 cell
+ * @returns Array of 9 geohash4 cells (center first, then neighbors)
+ *
+ * @example
+ * getGeohash4Neighbors('c23n')
+ * // => ['c23n', 'c23p', 'c23q', 'c23j', 'c23m', 'c23k', 'c23h', 'c23e', 'c23s']
+ */
+declare function getGeohash4Neighbors(geohash4: string): string[];
+/**
+ * Get the prefix of a geohash at a given precision.
+ * Simple helper for extracting geohash prefixes for directory organization.
+ */
+declare function getGeohashPrefix(geohash: string, precision: number): string;
+/**
+ * Convert a geohash prefix to a hierarchical path.
+ *
+ * Examples:
+ *   "9mud" -> "9/m/u/d"
+ *   "9q8y" -> "9/q/8/y"
+ *   "c24k" -> "c/2/4/k"
+ *
+ * This is used for organizing files in hierarchical directories to avoid
+ * thousands of folders in a single directory, which causes filesystem
+ * performance issues.
+ */
+declare function geohashToHierarchicalPath(geohash4: string): string;
+/**
+ * Compute all geohash cells along the path between two geohash cells.
+ * Interpolates lat/lng points between the centers of `from` and `to`,
+ * encoding each to a geohash at the given precision, and returns the
+ * deduplicated list of intermediate cells (excluding `from` and `to`).
+ */
+declare function getGeohashPath(from: string, to: string, precision?: number): string[];
+/**
+ * Check if a geohash cell overlaps with a bounding box.
+ * Custom implementation (not available in ngeohash).
+ */
+declare function geohashOverlapsBounds(hash: string, bounds: {
+    north: number;
+    south: number;
+    east: number;
+    west: number;
+}): boolean;
+
+export { calculateBearing, decodeGeohash, encodeGeohash, geohashOverlapsBounds, geohashToHierarchicalPath, getGeohash4Neighbors, getGeohashPath, getGeohashPrefix, getNeighbors, haversineDistance };

package/dist/spatial/index.js

@@ -0,0 +1,25 @@
+import {
+  calculateBearing,
+  decodeGeohash,
+  encodeGeohash,
+  geohashOverlapsBounds,
+  geohashToHierarchicalPath,
+  getGeohash4Neighbors,
+  getGeohashPath,
+  getGeohashPrefix,
+  getNeighbors,
+  haversineDistance
+} from "../chunk-7UDSRZKG.js";
+export {
+  calculateBearing,
+  decodeGeohash,
+  encodeGeohash,
+  geohashOverlapsBounds,
+  geohashToHierarchicalPath,
+  getGeohash4Neighbors,
+  getGeohashPath,
+  getGeohashPrefix,
+  getNeighbors,
+  haversineDistance
+};
+//# sourceMappingURL=index.js.map

package/dist/spatial/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/storage/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Storage - Abstract persistence interface
+ *
+ * Defines the contract for persistent storage across different environments.
+ * All values are JSON-serialized, so any serializable value can be stored.
+ * Keys can be automatically namespaced with a configurable prefix.
+ */
+/** Storage adapter interface - implemented by environment-specific adapters */
+interface StorageAdapter {
+    /** Get a value by key, returns null if not found */
+    get<T>(key: string): Promise<T | null>;
+    /** Set a value for a key */
+    set<T>(key: string, value: T): Promise<void>;
+    /** Remove a value by key */
+    remove(key: string): Promise<void>;
+    /** Clear all stored values (within our namespace) */
+    clear(): Promise<void>;
+    /** Get all keys (within our namespace) */
+    keys(): Promise<string[]>;
+    /** Check if this adapter supports enumeration */
+    readonly supportsEnumeration: boolean;
+}
+
+/**
+ * In-memory storage adapter for testing and SSR environments.
+ * Data does not persist across page reloads.
+ */
+
+declare class MemoryStorageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private store;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+/**
+ * localStorage adapter for web browsers.
+ * Supports a configurable key prefix to namespace stored data.
+ */
+
+declare class LocalStorageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private prefix;
+    constructor(prefix?: string);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+/**
+ * LocalForage adapter - IndexedDB storage with automatic fallbacks.
+ *
+ * Uses localforage which provides IndexedDB storage with automatic
+ * fallbacks to WebSQL and localStorage. This allows storing much more
+ * data than raw localStorage (which is limited to ~5MB).
+ *
+ * Unlike LocalStorageAdapter, this adapter can store binary data
+ * (ArrayBuffer, Blob, Uint8Array) natively without JSON serialization.
+ *
+ * Ported from qualla-internal/shared/services/StorageAdapters.ts with
+ * configurable store name and key prefix.
+ */
+
+interface LocalForageAdapterOptions {
+    /** IndexedDB database name (default: 'squisq') */
+    name?: string;
+    /** IndexedDB object store name (default: 'data') */
+    storeName?: string;
+    /** Key prefix for namespacing (default: '') */
+    prefix?: string;
+    /** Human-readable description (default: 'Squisq storage') */
+    description?: string;
+}
+declare class LocalForageAdapter implements StorageAdapter {
+    readonly supportsEnumeration = true;
+    private store;
+    private prefix;
+    constructor(options?: LocalForageAdapterOptions);
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    remove(key: string): Promise<void>;
+    clear(): Promise<void>;
+    keys(): Promise<string[]>;
+}
+
+export { LocalForageAdapter, type LocalForageAdapterOptions, LocalStorageAdapter, MemoryStorageAdapter, type StorageAdapter };

package/dist/storage/index.js

@@ -0,0 +1,11 @@
+import {
+  LocalForageAdapter,
+  LocalStorageAdapter,
+  MemoryStorageAdapter
+} from "../chunk-VJN7UB2Z.js";
+export {
+  LocalForageAdapter,
+  LocalStorageAdapter,
+  MemoryStorageAdapter
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}