@bendyline/squisq 1.4.0 → 1.4.1

package/dist/random/index.d.ts

@@ -1,2 +1,51 @@
-export { SeededRandom, hashString } from './SeededRandom.js';
-//# sourceMappingURL=index.d.ts.map
+/**
+ * Seeded pseudo-random number generator (Mulberry32 algorithm).
+ *
+ * Provides deterministic, reproducible randomness from an integer seed.
+ * Useful for consistent slideshow generation, shuffling, and selection.
+ *
+ * ```ts
+ * const rng = new SeededRandom(42);
+ * rng.next();            // 0.0–1.0
+ * rng.nextInt(10);       // 0–9
+ * rng.pick(['a', 'b']);  // 'a' or 'b'
+ * ```
+ */
+declare class SeededRandom {
+    private state;
+    constructor(seed: number);
+    /** Random float in [0, 1). */
+    next(): number;
+    /** Random integer in [0, max). */
+    nextInt(max: number): number;
+    /** Random integer in [min, max). */
+    nextIntRange(min: number, max: number): number;
+    /** Random boolean with given probability of `true` (default 0.5). */
+    nextBool(probability?: number): boolean;
+    /** Pick a random element, or `undefined` if array is empty. */
+    pick<T>(array: T[]): T | undefined;
+    /** Pick a random element; throws if empty. */
+    pickRequired<T>(array: T[]): T;
+    /** Pick `count` unique random elements (fewer if array is smaller). */
+    pickMultiple<T>(array: T[], count: number): T[];
+    /** Fisher-Yates shuffle **in place**. Returns the same array. */
+    shuffle<T>(array: T[]): T[];
+    /** Return a **new** shuffled copy. */
+    shuffled<T>(array: readonly T[]): T[];
+    /** Weighted random selection. Returns `undefined` if items is empty. */
+    pickWeighted<T>(items: {
+        item: T;
+        weight: number;
+    }[]): T | undefined;
+    /** Current internal state (for debugging / serialization). */
+    getState(): number;
+    /** Create an independent sub-stream keyed by a modifier. */
+    derive(modifier: string | number): SeededRandom;
+}
+/**
+ * Simple string → 32-bit hash (djb2 algorithm).
+ * Useful for turning a document ID into a numeric seed.
+ */
+declare function hashString(str: string): number;
+
+export { SeededRandom, hashString };

package/dist/random/index.js

@@ -1,2 +1,10 @@
-export { SeededRandom, hashString } from './SeededRandom.js';
+import "../chunk-V543AI2F.js";
+import {
+  SeededRandom,
+  hashString
+} from "../chunk-FVTQSNR7.js";
+export {
+  SeededRandom,
+  hashString
+};
 //# sourceMappingURL=index.js.map

package/dist/random/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/random/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recommend/index.d.ts

@@ -1,16 +1,42 @@
+import { M as MarkdownBlockNode } from '../types-BdZkdJ3z.js';
+
 /**
- * Template recommendations for the editor's block template picker.
+ * Block template recommendations.
  *
- * @example
- * ```ts
- * import { parseMarkdown } from '@bendyline/squisq/markdown';
- * import { profileBlockContents, recommendTemplatesForBlock } from '@bendyline/squisq/recommend';
- *
- * const doc = parseMarkdown(blockBodySource);
- * const profile = profileBlockContents(doc.children);
- * const { recommended, rest } = recommendTemplatesForBlock(profile, ALL_TEMPLATE_NAMES);
- * ```
+ * Given a slice of markdown block nodes (the body underneath a heading),
+ * profile the content for image / video / quote / list / table / date /
+ * stat signals, then map that profile to the set of templates that make
+ * sense for the block. Used by the editor's template picker to surface a
+ * "Recommended for this block" section above the full template list.
+ */
+
+interface BlockContentProfile {
+    hasImage: boolean;
+    imageCount: number;
+    hasVideo: boolean;
+    hasBlockquote: boolean;
+    hasList: boolean;
+    hasTable: boolean;
+    hasDate: boolean;
+    hasNumberHighlight: boolean;
+    wordCount: number;
+}
+interface RecommendationResult {
+    recommended: string[];
+    rest: string[];
+}
+/**
+ * Walk a slice of block nodes and summarize what kinds of content it
+ * contains. Cheap to run — no markdown parsing, just AST traversal.
+ */
+declare function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentProfile;
+/**
+ * Split a flat list of template names into a "Recommended" bucket
+ * (matches the active block's content profile) and a "rest" bucket
+ * (everything else). Both buckets preserve the input ordering of
+ * `allNames`, so the visual layout stays predictable as templates are
+ * added.
  */
-export type { BlockContentProfile, RecommendationResult } from './templates.js';
-export { profileBlockContents, recommendTemplatesForBlock } from './templates.js';
-//# sourceMappingURL=index.d.ts.map
+declare function recommendTemplatesForBlock(profile: BlockContentProfile, allNames: readonly string[]): RecommendationResult;
+
+export { type BlockContentProfile, type RecommendationResult, profileBlockContents, recommendTemplatesForBlock };

package/dist/recommend/index.js

@@ -1,15 +1,10 @@
-/**
- * Template recommendations for the editor's block template picker.
- *
- * @example
- * ```ts
- * import { parseMarkdown } from '@bendyline/squisq/markdown';
- * import { profileBlockContents, recommendTemplatesForBlock } from '@bendyline/squisq/recommend';
- *
- * const doc = parseMarkdown(blockBodySource);
- * const profile = profileBlockContents(doc.children);
- * const { recommended, rest } = recommendTemplatesForBlock(profile, ALL_TEMPLATE_NAMES);
- * ```
- */
-export { profileBlockContents, recommendTemplatesForBlock } from './templates.js';
+import {
+  profileBlockContents,
+  recommendTemplatesForBlock
+} from "../chunk-WMOI7FN3.js";
+import "../chunk-H3AXU4MJ.js";
+export {
+  profileBlockContents,
+  recommendTemplatesForBlock
+};
 //# sourceMappingURL=index.js.map

package/dist/recommend/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recommend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/schemas/index.d.ts

@@ -1,15 +1,188 @@
-export * from './Types.js';
-export * from './Doc.js';
-export * from './BlockTemplates.js';
-export * from './Theme.js';
-export * from './themeLibrary.js';
-export * from './themeValidator.js';
-export * from './themeCompile.js';
-export * from './fontStacks.js';
-export * from './colorUtils.js';
-export * from './Viewport.js';
-export { getLayoutHints, getTwoColumnPositions, getSafeTextBounds, scaledFontSize as layoutScaledFontSize, } from './LayoutStrategy.js';
-export type { LayoutHints } from './LayoutStrategy.js';
-export type { MediaProvider, MediaEntry } from './MediaProvider.js';
-export type { ImageEditDoc, ImageEditLayer, ImageEditLayerKind, ImageEditCanvas, ImageEditMeta, EditorLayerMeta, } from './ImageEditDoc.js';
-//# sourceMappingURL=index.d.ts.map
+export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
+import { af as Theme, q as DeepPartial, aj as ThemeSeedColors, ag as ThemeColorPalette, v as FontFamilyKind, u as FontFamily } from '../Doc-BeSeH2iX.js';
+export { A as AccentImage, a as AccentPosition, b as Animation, c as AnimationType, d as AudioBookmark, e as AudioSegment, f as AudioTimingData, g as AudioTrack, B as Block, C as CaptionPhrase, h as CaptionTrack, i as CaptionWord, j as ColorScheme, k as ComparisonBarInput, l as CornerBrandingConfig, D as DARK_SURFACE, m as DEFAULT_DOC_FONT, n as DEFAULT_TITLE_FONT, o as DataTableInput, p as DateEventInput, r as DefinitionCardInput, s as Doc, t as DocBlock, F as FactCardInput, w as FullBleedQuoteInput, G as GradientBackgroundConfig, I as ImageBackgroundConfig, x as ImageLayer, y as ImageWithCaptionInput, L as LIGHT_SURFACE, z as Layer, E as LayoutHints, H as LeftFeatureInput, J as ListBlockInput, M as MapBlockInput, K as MapLayer, N as MapMarker, O as MapTileStyle, P as PatternBackgroundConfig, Q as PersistentLayer, R as PersistentLayerConfig, S as PersistentLayerTemplate, T as PersistentLayerTemplateConfig, U as PersistentLayerTemplateType, V as PhotoGridInput, W as Position, X as ProgressIndicatorConfig, Y as PullQuoteInput, Z as QuoteBlockInput, _ as RenderStyle, $ as RightFeatureInput, a0 as SectionHeaderInput, a1 as ShapeLayer, a2 as SolidBackgroundConfig, a3 as StartBlockConfig, a4 as StatHighlightInput, a5 as SurfaceScheme, a6 as THEME_SCHEMA_VERSION, a7 as TableLayer, a8 as TableLayerStyle, a9 as TemplateBlock, aa as TemplateContext, ab as TemplateFunction, ac as TemplateRegistry, ad as TextLayer, ae as TextStyle, ah as ThemeColorScheme, ai as ThemeSchemaVersion, ak as ThemeStyle, al as ThemeTypography, am as TitleBlockInput, an as TitleCaptionConfig, ao as Transition, ap as TransitionType, aq as TwoColumnInput, ar as VIEWPORT_PRESETS, as as VideoLayer, at as VideoPullQuoteInput, au as VideoWithCaptionInput, av as ViewportConfig, aw as ViewportOrientation, ax as ViewportPreset, ay as applySurface, az as calculateDuration, aA as calculateFontScale, aB as createTemplateContext, aC as createTheme, aD as getAspectRatioString, aE as getBlockAtTime, aF as getCaptionAtTime, aG as getLayoutHints, aH as getRegisteredThemes, aI as getSafeTextBounds, aJ as getSegmentAtTime, aK as getTwoColumnPositions, aL as getViewport, aM as getViewportOrientation, aN as isPersistentLayerTemplate, aO as isTemplateBlock, aP as layoutScaledFontSize, aQ as lookupRegisteredTheme, aR as registerTheme, aS as scaledFontSize, aT as unregisterTheme, aU as validateDoc } from '../Doc-BeSeH2iX.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BHjJ0Qx6.js';
+export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-BTIvw0oq.js';
+import '../types-BdZkdJ3z.js';
+
+/**
+ * Theme Validator
+ *
+ * Hand-rolled validator for `Theme` JSON. No dependencies. Produces a
+ * flat list of typed errors with JSON paths, suitable for surfacing in
+ * the customizer UI or throwing at module init for built-in themes.
+ *
+ * Design: walk the candidate object, push errors for each violation.
+ * Coverage is exhaustive for required fields and shapes; permissive on
+ * forward-compatible fields (unknown keys are ignored, not rejected).
+ */
+
+interface ValidationError {
+    path: string;
+    message: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    /** Present only when `valid === true`. The same input typed as `Theme`. */
+    theme?: Theme;
+}
+declare function validateTheme(input: unknown): ValidationResult;
+/** Throws on invalid input. Useful at module init for built-in themes. */
+declare function assertTheme(input: unknown, source?: string): Theme;
+
+/**
+ * Theme Compilation
+ *
+ * Turns a partial Theme (typically authored by the customizer panel from
+ * a few seed colors and preset choices) into a complete, validated Theme
+ * by:
+ *
+ *   1. Filling unspecified fields from a hardcoded `STARTER_THEME`.
+ *   2. Deriving missing color slots from `seedColors` via OKLCh math.
+ *   3. Validating the result.
+ *
+ * Built-in themes ship as fully-specified Theme JSON and skip this step.
+ */
+
+declare const STARTER_THEME: Theme;
+/**
+ * Derive a full `ThemeColorPalette` from `seedColors`, with any explicit
+ * `partialColors` taking precedence over derived values. Background and
+ * text are guessed from luminance when the user gave only a primary.
+ */
+declare function deriveColorPalette(seeds: ThemeSeedColors, partialColors?: Partial<ThemeColorPalette>, opts?: {
+    contrast?: 'subtle' | 'balanced' | 'high';
+}): ThemeColorPalette;
+/** Map a contrast preset to numeric spread used by `deriveColorPalette`. */
+type ContrastPreset = 'subtle' | 'balanced' | 'high';
+interface CompileOptions {
+    /** Contrast level for OKLCh derivation (default 'balanced'). */
+    contrast?: ContrastPreset;
+}
+/**
+ * Compile a partial Theme into a complete one. Fills missing fields from
+ * `STARTER_THEME`, derives missing color slots from `seedColors` (when
+ * present), and validates the result.
+ */
+declare function compileTheme(partial: DeepPartial<Theme>, opts?: CompileOptions): Theme;
+/**
+ * Parse a JSON string into a validated Theme. Throws on invalid input.
+ */
+declare function parseTheme(json: string): Theme;
+/**
+ * Serialize a Theme to a stable, pretty-printed JSON string. Round-trips
+ * cleanly through `parseTheme`.
+ */
+declare function serializeTheme(theme: Theme): string;
+
+/**
+ * Font Stacks
+ *
+ * Curated registry of font families used by built-in themes and offered in
+ * the theme customizer. Each stack has a stable `id` (referenced by JSON
+ * theme files via `{ stackId }`) and a CSS `family` string that resolves
+ * to the actual font when rendered.
+ *
+ * Themes never carry raw CSS font strings — they reference a `stackId` or
+ * specify a `{ custom: { name, fallback } }` form, both of which resolve
+ * here at render time.
+ */
+
+interface FontStack {
+    /** Stable identifier referenced by Theme JSON. */
+    id: string;
+    /** Display label for pickers. */
+    label: string;
+    /** Full CSS font-family string with safe fallbacks. */
+    family: string;
+    /** Categorical bucket for the picker UI. */
+    kind: FontFamilyKind;
+    /**
+     * Google Fonts family name, when this stack is served by Google Fonts.
+     * Used by exports that bundle a `<link>` to fonts.googleapis.com so the
+     * face renders correctly even when the host page doesn't preload it.
+     * Omit (or set to undefined) for purely system stacks.
+     */
+    googleFontFamily?: string;
+}
+/** All curated stacks, in the order they should appear in pickers. */
+declare const AVAILABLE_FONT_STACKS: FontStack[];
+/** Look up a stack by id. Returns undefined if not registered. */
+declare function getFontStack(id: string): FontStack | undefined;
+/**
+ * Resolve a `FontFamily` reference (or legacy raw string) to a CSS family string.
+ * Used by `getThemeFont` at render time. Never returns an empty string —
+ * unrecognized stackIds fall back to the requested role's default.
+ */
+declare function resolveFontFamily(family: FontFamily | string | undefined, roleFallback: string): string;
+/** Convenience: quick `{ stackId }` factory for code that constructs themes. */
+declare function fontStack(id: string): FontFamily;
+/**
+ * Build a `https://fonts.googleapis.com/css2?...` URL that loads the
+ * subset of supplied `FontFamily` references that are served by Google
+ * Fonts. Returns `null` when nothing in the list needs Google hosting
+ * (system stacks, custom fonts, or unknown stack ids) — callers can use
+ * that to skip emitting a `<link>` entirely.
+ *
+ * The URL requests regular + bold (400/700) for each family, which is
+ * what the templates use. `display=swap` keeps the fallback visible
+ * while the web font streams in.
+ */
+declare function buildGoogleFontsUrl(families: Array<FontFamily | undefined>): string | null;
+/** Default fallback families exposed for tools that need them. */
+declare const FONT_FALLBACKS: Record<FontFamilyKind, string>;
+
+/**
+ * Color Utilities
+ *
+ * Pure-JS color math used by theme compilation and contrast checks.
+ * No dependencies. Operates on `#rrggbb` hex strings.
+ *
+ * Internally uses OKLCh — perceptually uniform, so lightening by 0.1
+ * looks like the same change at any starting point. Out-of-gamut
+ * results are clamped to sRGB.
+ */
+/** Test whether a string is a valid `#rgb` or `#rrggbb` hex color. */
+declare function isHex(value: string): boolean;
+/**
+ * Lighten a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+declare function oklchLighten(hex: string, amount: number): string;
+/**
+ * Darken a color by `amount` (0..1) in OKLCh L space.
+ * Falls back to the input on parse failure.
+ */
+declare function oklchDarken(hex: string, amount: number): string;
+/**
+ * Adjust the OKLCh chroma of a color by a multiplier (e.g. 0.7 to mute).
+ */
+declare function oklchSetChroma(hex: string, multiplier: number): string;
+/**
+ * WCAG relative luminance of a hex color, returned as 0..1.
+ */
+declare function relativeLuminance(hex: string): number;
+/**
+ * WCAG contrast ratio between two hex colors. Returns 1..21.
+ */
+declare function contrastRatio(a: string, b: string): number;
+/**
+ * Pick a near-white or near-black text color that contrasts well against `bg`.
+ */
+declare function pickContrastingText(bg: string, light?: string, dark?: string): string;
+/**
+ * Derive a 5-step lighter→darker scale from a seed color.
+ * Stops are evenly spaced in OKLCh L space around the seed.
+ * `spread` controls amplitude (0.05 = subtle, 0.15 = balanced, 0.22 = high).
+ */
+declare function deriveScale(seedHex: string, spread?: number): {
+    lighter2: string;
+    lighter1: string;
+    base: string;
+    darker1: string;
+    darker2: string;
+};
+
+export { AVAILABLE_FONT_STACKS, type CompileOptions, type ContrastPreset, DeepPartial, FONT_FALLBACKS, FontFamily, FontFamilyKind, type FontStack, STARTER_THEME, Theme, ThemeColorPalette, ThemeSeedColors, type ValidationError, type ValidationResult, assertTheme, buildGoogleFontsUrl, compileTheme, contrastRatio, deriveColorPalette, deriveScale, fontStack, getFontStack, isHex, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme };

package/dist/schemas/index.js

@@ -1,12 +1,121 @@
-export * from './Types.js';
-export * from './Doc.js';
-export * from './BlockTemplates.js';
-export * from './Theme.js';
-export * from './themeLibrary.js';
-export * from './themeValidator.js';
-export * from './themeCompile.js';
-export * from './fontStacks.js';
-export * from './colorUtils.js';
-export * from './Viewport.js';
-export { getLayoutHints, getTwoColumnPositions, getSafeTextBounds, scaledFontSize as layoutScaledFontSize, } from './LayoutStrategy.js';
+import {
+  STARTER_THEME,
+  calculateDuration,
+  compileTheme,
+  deriveColorPalette,
+  getBlockAtTime,
+  getCaptionAtTime,
+  getSegmentAtTime,
+  parseTheme,
+  serializeTheme,
+  validateDoc
+} from "../chunk-57CVQCFX.js";
+import {
+  AVAILABLE_FONT_STACKS,
+  DARK_SURFACE,
+  DEFAULT_THEME,
+  DEFAULT_THEME_ID,
+  FONT_FALLBACKS,
+  LIGHT_SURFACE,
+  THEMES,
+  THEME_SCHEMA_VERSION,
+  applySurface,
+  assertTheme,
+  buildGoogleFontsUrl,
+  contrastRatio,
+  createTheme,
+  deriveScale,
+  fontStack,
+  getAvailableThemes,
+  getFontStack,
+  getRegisteredThemes,
+  getThemeSummaries,
+  isHex,
+  lookupRegisteredTheme,
+  oklchDarken,
+  oklchLighten,
+  oklchSetChroma,
+  pickContrastingText,
+  registerTheme,
+  relativeLuminance,
+  resolveFontFamily,
+  resolveTheme,
+  unregisterTheme,
+  validateTheme
+} from "../chunk-B4EEON3N.js";
+import {
+  DEFAULT_DOC_FONT,
+  DEFAULT_TITLE_FONT,
+  VIEWPORT_PRESETS,
+  calculateFontScale,
+  createTemplateContext,
+  getAspectRatioString,
+  getLayoutHints,
+  getSafeTextBounds,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
+  scaledFontSize,
+  scaledFontSize2
+} from "../chunk-5WFRKURX.js";
+export {
+  AVAILABLE_FONT_STACKS,
+  DARK_SURFACE,
+  DEFAULT_DOC_FONT,
+  DEFAULT_THEME,
+  DEFAULT_THEME_ID,
+  DEFAULT_TITLE_FONT,
+  FONT_FALLBACKS,
+  LIGHT_SURFACE,
+  STARTER_THEME,
+  THEMES,
+  THEME_SCHEMA_VERSION,
+  VIEWPORT_PRESETS,
+  applySurface,
+  assertTheme,
+  buildGoogleFontsUrl,
+  calculateDuration,
+  calculateFontScale,
+  compileTheme,
+  contrastRatio,
+  createTemplateContext,
+  createTheme,
+  deriveColorPalette,
+  deriveScale,
+  fontStack,
+  getAspectRatioString,
+  getAvailableThemes,
+  getBlockAtTime,
+  getCaptionAtTime,
+  getFontStack,
+  getLayoutHints,
+  getRegisteredThemes,
+  getSafeTextBounds,
+  getSegmentAtTime,
+  getThemeSummaries,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  isHex,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
+  scaledFontSize as layoutScaledFontSize,
+  lookupRegisteredTheme,
+  oklchDarken,
+  oklchLighten,
+  oklchSetChroma,
+  parseTheme,
+  pickContrastingText,
+  registerTheme,
+  relativeLuminance,
+  resolveFontFamily,
+  resolveTheme,
+  scaledFontSize2 as scaledFontSize,
+  serializeTheme,
+  unregisterTheme,
+  validateDoc,
+  validateTheme
+};
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,qBAAqB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/spatial/index.d.ts

@@ -1,3 +1,111 @@
-export * from './Haversine.js';
-export * from './Geohash.js';
-//# sourceMappingURL=index.d.ts.map
+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

@@ -1,3 +1,25 @@
-export * from './Haversine.js';
-export * from './Geohash.js';
+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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spatial/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}