@bendyline/squisq 1.4.0 → 1.5.0

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-DlAZ7MW4.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,11 @@
-/**
- * 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 "../chunk-ZLQKNOZQ.js";
+import {
+  profileBlockContents,
+  recommendTemplatesForBlock
+} from "../chunk-LRCV7N7F.js";
+import "../chunk-OKJOQXK4.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,208 @@
-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 { ax as Theme, u as DeepPartial, aB as ThemeSeedColors, ay as ThemeColorPalette, J as FontFamilyKind, I as FontFamily } from '../Doc-BsMkmzH8.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AudioBookmark, f as AudioSegment, g as AudioTimingData, h as AudioTrack, B as Block, i as BlockConnection, j as BorderStyle, C as CaptionPhrase, k as CaptionTrack, l as CaptionWord, m as ColorScheme, n as ComparisonBarInput, o as CornerBrandingConfig, p as CustomTemplateDefinition, D as DARK_SURFACE, q as DEFAULT_DOC_FONT, r as DEFAULT_TITLE_FONT, s as DataTableInput, t as DateEventInput, v as DefinitionCardInput, w as DiagramBlockInput, x as Doc, y as DocBlock, z as DocDiagnostic, E as DrawingBlockInput, F as FRONTMATTER_CUSTOM_TEMPLATES_KEY, G as FRONTMATTER_CUSTOM_THEMES_KEY, H as FactCardInput, K as FullBleedQuoteInput, L as GradientBackgroundConfig, M as ImageBackgroundConfig, N as ImageLayer, O as ImageTreatment, P as ImageWithCaptionInput, Q as LIGHT_SURFACE, R as Layer, S as LayoutHints, T as LeftFeatureInput, U as LinearGradient, V as ListBlockInput, W as MapBlockInput, X as MapLayer, Y as MapMarker, Z as MapTileStyle, _ as MarkerStyle, $ as MediaClip, a0 as PathLayer, a1 as PatternBackgroundConfig, a2 as PersistentLayer, a3 as PersistentLayerConfig, a4 as PersistentLayerTemplate, a5 as PersistentLayerTemplateConfig, a6 as PersistentLayerTemplateType, a7 as PhotoGridInput, a8 as Position, a9 as ProgressIndicatorConfig, aa as PullQuoteInput, ab as QuoteBlockInput, ac as RawLayersInput, ad as RenderStyle, ae as RightFeatureInput, af as ScheduledClip, ag as SectionHeaderInput, ah as ShapeFilter, ai as ShapeLayer, aj as ShapePattern, ak as SolidBackgroundConfig, al as StartBlockConfig, am as StatHighlightInput, an as SurfaceScheme, ao as THEME_SCHEMA_VERSION, ap as TableLayer, aq as TableLayerStyle, ar as TemplateBlock, as as TemplateContext, at as TemplateFunction, au as TemplateRegistry, av as TextLayer, aw as TextStyle, az as ThemeColorScheme, aA as ThemeSchemaVersion, aC as ThemeStyle, aD as ThemeTypography, aE as TitleBlockInput, aF as TitleCaptionConfig, aG as TwoColumnInput, aH as VIEWPORT_PRESETS, aI as VideoLayer, aJ as VideoPullQuoteInput, aK as VideoWithCaptionInput, aL as ViewportConfig, aM as ViewportOrientation, aN as ViewportPreset, aO as VignetteConfig, aP as applySurface, aQ as calculateDuration, aR as calculateFontScale, aS as createTemplateContext, aT as createTheme, aU as getAspectRatioString, aV as getBlockAtTime, aW as getCaptionAtTime, aX as getDocPlaybackDuration, aY as getLayoutHints, aZ as getRegisteredThemes, a_ as getSafeTextBounds, a$ as getSegmentAtTime, b0 as getTwoColumnPositions, b1 as getViewport, b2 as getViewportOrientation, b3 as isPersistentLayerTemplate, b4 as isTemplateBlock, b5 as layoutScaledFontSize, b6 as lookupRegisteredTheme, b7 as registerTheme, b8 as resolveMediaSchedule, b9 as scaledFontSize, ba as unregisterTheme, bb as validateDoc } from '../Doc-BsMkmzH8.js';
+export { D as DEFAULT_TRANSITION_DURATION_SECONDS, X as TRANSITION_DIRECTIONS, Y as TRANSITION_TYPES, Z as Transition, _ as TransitionDirection, $ as TransitionType, a0 as isTransitionType, a1 as normalizeTransitionDirection, a2 as normalizeTransitionType, a3 as resolveBlockTransition, a4 as resolveTransitionDuration } from '../types-DlAZ7MW4.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-DQQKuRMx.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-DvoeHMP9.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;
+    /**
+     * Base theme to inherit from. When provided, the partial is deep-merged
+     * over this theme instead of the neutral `STARTER_THEME`, so the compiled
+     * theme inherits the base's render style, color schemes, typography, and
+     * persistent layers — and only the fields the user changed are overridden.
+     * The base's id is recorded on the result as `basedOn`.
+     */
+    base?: Theme;
+}
+/**
+ * Compile a partial Theme into a complete one. Fills missing fields from
+ * the base (`opts.base` when given, else `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;
+/**
+ * Hue of a hex color in HSL degrees (0..360). Returns 0 for pure grays
+ * and on parse failure. Used by the duotone image treatment to aim its
+ * `hue-rotate()` at the theme's tint color.
+ */
+declare function hexHueDegrees(hex: string): number;
+/**
+ * Convert a hex color + alpha (0..1) to an `rgba()` string.
+ * Falls back to the input on parse failure (e.g. a value that is
+ * already an rgba()/gradient string).
+ */
+declare function withAlpha(hex: string, alpha: number): string;
+/**
+ * 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, hexHueDegrees, isHex, oklchDarken, oklchLighten, oklchSetChroma, parseTheme, pickContrastingText, relativeLuminance, resolveFontFamily, serializeTheme, validateTheme, withAlpha };

package/dist/schemas/index.js

@@ -1,12 +1,151 @@
-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,
+  getDocPlaybackDuration,
+  getSegmentAtTime,
+  parseTheme,
+  resolveMediaSchedule,
+  serializeTheme,
+  validateDoc
+} from "../chunk-7MQGNR76.js";
+import {
+  AVAILABLE_FONT_STACKS,
+  DARK_SURFACE,
+  DEFAULT_THEME,
+  DEFAULT_THEME_ID,
+  FONT_FALLBACKS,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
+  LIGHT_SURFACE,
+  THEMES,
+  THEME_SCHEMA_VERSION,
+  applySurface,
+  assertTheme,
+  buildGoogleFontsUrl,
+  contrastRatio,
+  createTheme,
+  deriveScale,
+  fontStack,
+  getAvailableThemes,
+  getFontStack,
+  getRegisteredThemes,
+  getThemeSummaries,
+  hexHueDegrees,
+  isHex,
+  lookupRegisteredTheme,
+  oklchDarken,
+  oklchLighten,
+  oklchSetChroma,
+  pickContrastingText,
+  registerTheme,
+  relativeLuminance,
+  resolveFontFamily,
+  resolveTheme,
+  unregisterTheme,
+  validateTheme,
+  withAlpha
+} from "../chunk-4AKUQPEE.js";
+import {
+  DEFAULT_DOC_FONT,
+  DEFAULT_TITLE_FONT,
+  VIEWPORT_PRESETS,
+  calculateFontScale,
+  createTemplateContext,
+  getAspectRatioString,
+  getLayoutHints,
+  getSafeTextBounds,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
+  scaledFontSize,
+  scaledFontSize2
+} from "../chunk-DLXZMS5K.js";
+import {
+  DEFAULT_TRANSITION_DURATION_SECONDS,
+  TRANSITION_DIRECTIONS,
+  TRANSITION_TYPES,
+  isTransitionType,
+  normalizeTransitionDirection,
+  normalizeTransitionType,
+  resolveBlockTransition,
+  resolveTransitionDuration
+} from "../chunk-QE7TWGVT.js";
+export {
+  AVAILABLE_FONT_STACKS,
+  DARK_SURFACE,
+  DEFAULT_DOC_FONT,
+  DEFAULT_THEME,
+  DEFAULT_THEME_ID,
+  DEFAULT_TITLE_FONT,
+  DEFAULT_TRANSITION_DURATION_SECONDS,
+  FONT_FALLBACKS,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
+  LIGHT_SURFACE,
+  STARTER_THEME,
+  THEMES,
+  THEME_SCHEMA_VERSION,
+  TRANSITION_DIRECTIONS,
+  TRANSITION_TYPES,
+  VIEWPORT_PRESETS,
+  applySurface,
+  assertTheme,
+  buildGoogleFontsUrl,
+  calculateDuration,
+  calculateFontScale,
+  compileTheme,
+  contrastRatio,
+  createTemplateContext,
+  createTheme,
+  deriveColorPalette,
+  deriveScale,
+  fontStack,
+  getAspectRatioString,
+  getAvailableThemes,
+  getBlockAtTime,
+  getCaptionAtTime,
+  getDocPlaybackDuration,
+  getFontStack,
+  getLayoutHints,
+  getRegisteredThemes,
+  getSafeTextBounds,
+  getSegmentAtTime,
+  getThemeSummaries,
+  getTwoColumnPositions,
+  getViewport,
+  getViewportOrientation,
+  hexHueDegrees,
+  isHex,
+  isPersistentLayerTemplate,
+  isTemplateBlock,
+  isTransitionType,
+  scaledFontSize as layoutScaledFontSize,
+  lookupRegisteredTheme,
+  normalizeTransitionDirection,
+  normalizeTransitionType,
+  oklchDarken,
+  oklchLighten,
+  oklchSetChroma,
+  parseTheme,
+  pickContrastingText,
+  registerTheme,
+  relativeLuminance,
+  resolveBlockTransition,
+  resolveFontFamily,
+  resolveMediaSchedule,
+  resolveTheme,
+  resolveTransitionDuration,
+  scaledFontSize2 as scaledFontSize,
+  serializeTheme,
+  unregisterTheme,
+  validateDoc,
+  validateTheme,
+  withAlpha
+};
 //# 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,116 @@
-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 great-circle path between two geohash cells.
+ * Samples points along the spherical arc from `from` to `to`, encoding each to a
+ * geohash at the given precision, and returns the deduplicated list of intermediate
+ * cells (excluding `from` and `to`).
+ *
+ * Uses spherical linear interpolation (SLERP) via 3D unit vectors, which correctly
+ * handles antimeridian crossings and polar paths — both of which flat lat/lng
+ * interpolation gets wrong.
+ */
+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-Q3ROPT5H.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":[]}