@nika-js/onlymap 0.5.2 → 0.5.6

package/dist/geodesy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Geodesy (spec: issue #20 "Measure widget — geodesic distance and area").
+ *
+ * Pure spherical math on a sphere of the WGS84 MEAN radius (2a + b)/3 =
+ * 6 371 008.7714 m. A sphere, not the ellipsoid: documented accuracy vs. the
+ * true WGS84 geodesic is ≤ 0.56% worst case (near-meridional lines), typically
+ * < 0.3%. Deliberately NOT Vincenty (fails to converge near antipodes) and NOT
+ * a Karney/GeographicLib port (overkill for v1) — but every signature takes the
+ * radius, so an ellipsoidal `geodesic="ellipsoidal"` opt-in can slot in later
+ * without touching callers. Haversine uses GL's numerically-guarded form
+ * `2R·asin(min(1, √h))`. Area is the Chamberlain–Duquette line integral (the
+ * JPL formulation Turf's area uses), returning |signed area| so self-
+ * intersecting lobes cancel.
+ */
+/** WGS84 mean radius (2a + b)/3, with a = 6378137 m, 1/f = 298.257223563. */
+export declare const WGS84_MEAN_RADIUS_M = 6371008.7714;
+/** The sphere radius (m) current measurements resolve against. */
+export declare function getMeasureRadiusMeters(): number;
+/** Override the measure radius (e.g. a non-Earth body). Non-positive values reset to WGS84. */
+export declare function setMeasureRadiusMeters(radiusMeters: number): void;
+export type LngLat = [number, number];
+/** Haversine great-circle distance in meters (guarded `2R·asin(min(1, √h))`). */
+export declare function distanceMeters(a: LngLat, b: LngLat, radius?: number): number;
+/** Total haversine length of a polyline in meters (0 for < 2 points). */
+export declare function pathLengthMeters(points: LngLat[], radius?: number): number;
+/**
+ * Spherical polygon area in m² via the Chamberlain–Duquette line integral (the
+ * exact index form Turf's `ringArea` uses, so results match Turf's fixtures).
+ * Returns the ABSOLUTE value; ring winding and self-intersection lobes cancel.
+ * Pass the OPEN ring (a trailing duplicate of the first point is tolerated).
+ */
+export declare function ringAreaMeters2(ring: LngLat[], radius?: number): number;
+/** Perimeter of a ring in meters (closes the ring implicitly). */
+export declare function ringPerimeterMeters(ring: LngLat[], radius?: number): number;
+/**
+ * Does this ring wind around a pole? The Chamberlain–Duquette integral
+ * misreports a pole-enclosing ring, so the widget refuses an area for one.
+ * Test: sum the per-edge longitude steps normalized to (−180, 180]; a ring that
+ * does NOT enclose a pole nets ~0, one that circles a pole nets ~±360.
+ */
+export declare function ringEnclosesPole(ring: LngLat[]): boolean;
+/**
+ * Great-circle midpoint of a segment — antimeridian-safe (converts to Cartesian
+ * so a segment crossing ±180° gets its label on the shorter arc, not the middle
+ * of the wrong way round). Returns [lng (normalized to (−180, 180]), lat].
+ */
+export declare function midpoint(a: LngLat, b: LngLat): LngLat;

package/dist/geoparquet-AL10HAyd.js

@@ -0,0 +1,35 @@
+import { r as p, n as d } from "./index-G3hmIs2P.js";
+function g(t) {
+  if (t == null) return !0;
+  const e = t, n = e.id?.code;
+  return n != null ? n === 84 || n === 4326 || n === "CRS84" || n === "4326" : typeof e.name == "string" && /^\s*(ogc:)?(wgs\s*84|crs\s*84|wgs84)\s*$/i.test(e.name);
+}
+function y(t) {
+  const e = t;
+  return typeof e?.name == "string" && e.name ? `"${e.name}"` : e?.id?.code != null ? `${e.id.authority ?? "?"}:${e.id.code}` : "a non-CRS84 CRS";
+}
+function h(t, e, n) {
+  const o = e.primary_column;
+  if (!o)
+    throw new Error(`data="${n}": GeoParquet "geo" metadata names no primary_column — can't tell which column is geometry.`);
+  const c = e.columns?.[o]?.crs;
+  if (!g(c))
+    throw new Error(
+      `data="${n}": GeoParquet CRS ${y(c)} isn't CRS84/EPSG:4326 — reprojection isn't supported yet (deck.gl renders lng/lat). Reproject first, e.g. ogr2ogr -t_srs EPSG:4326 out.parquet in.parquet.`
+    );
+  if (t.length === 0)
+    return console.warn(`[onlymapjs] data="${n}": GeoParquet has no rows — empty layer.`), [];
+  const u = t.map((r) => r[o]);
+  if (u.every((r) => r != null && r.type === "Point")) {
+    const r = t.map(({ [o]: i, ...m }) => m), a = p(r), s = u.map((i) => i.coordinates ?? void 0);
+    return { length: t.length, columns: { ...a?.columns ?? {}, [o]: s } };
+  }
+  const l = t.map(({ [o]: r, ...a }) => {
+    const s = a.id;
+    return { type: "Feature", ...s != null ? { id: s } : {}, geometry: r ?? null, properties: a };
+  });
+  return d({ type: "FeatureCollection", features: l });
+}
+export {
+  h as geoParquetToLayerData
+};

package/dist/geoparquet.d.ts

@@ -0,0 +1,33 @@
+/**
+ * GeoParquet (spec: issue #14). Decodes with hyparquet — a pure-JS, zero-dep
+ * Parquet reader — plus hyparquet-compressors for snappy/gzip/zstd (its zstd
+ * IS the same `fzstd` the Arrow path already bundles; no second codec ships).
+ * hyparquet reads the GeoParquet `geo` file metadata and decodes the WKB
+ * primary geometry column to GeoJSON geometry itself, so no WKB decoder is
+ * ours to maintain.
+ *
+ * What IS ours: `geo` metadata validation, a CRS84 guard (deck.gl renders in
+ * lng/lat — a projected file would land in the ocean, so a non-CRS84 CRS is a
+ * loud structured error until the reprojection workstream lands, NOT a silent
+ * skip the way GL does it), and the Arrow geometry rule from
+ * `arrowTableToLayerData` — all-Point tables transpose to columnar (zero row
+ * materialization on the render path), while lines/polygons/mixed become
+ * GeoJSON feature rows that every geometry consumer speaks.
+ */
+import type { LayerData } from "./ir";
+/** The parsed GeoParquet `geo` file-metadata value (a JSON string in key_value_metadata). */
+export interface GeoParquetMetadata {
+    primary_column?: string;
+    columns?: Record<string, {
+        encoding?: string;
+        geometry_types?: string[];
+        crs?: unknown;
+    }>;
+}
+/**
+ * hyparquet rows (geometry already decoded to GeoJSON) → LayerData, applying
+ * the CRS guard and the Arrow all-Point-columnar / lines-polys-feature-rows
+ * split. `rows` is consumed after the geo-metadata gate in data-layer's
+ * PARQUET_FORMAT.
+ */
+export declare function geoParquetToLayerData(rows: Record<string, unknown>[], geo: GeoParquetMetadata, url: string): LayerData;

package/dist/html-data.d.ts

@@ -15,9 +15,9 @@ interface TagData {
     }[];
 }
 /** Hand-authored action list — validated against hasAction() in html-data.test.ts. */
-export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save", "set-basemap", "set-lighting", "set-terrain", "set-widgets-visible", "undo", "redo"];
+export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save", "measure-mode", "measure-clear", "measure-units", "set-basemap", "set-lighting", "set-terrain", "set-widgets-visible", "undo", "redo"];
 /** Hand-authored widget types — validated against the widget registry in html-data.test.ts. */
-export declare const BUILTIN_WIDGETS: readonly ["legend", "layer-switcher", "zoom-controls", "scale-bar", "attribution", "filter", "vega-lite", "player", "draw", "basemap-switcher", "lighting", "undo-redo", "widgets-toggle"];
+export declare const BUILTIN_WIDGETS: readonly ["legend", "layer-switcher", "zoom-controls", "scale-bar", "attribution", "filter", "vega-lite", "player", "draw", "measure", "basemap-switcher", "lighting", "undo-redo", "widgets-toggle"];
 export declare function buildHtmlCustomData(): {
     version: number;
     tags: TagData[];

package/dist/{index-DWXl9Ykk.js → index-BQaxwlV3.js}

@@ -1,4 +1,4 @@
-import { ac as _t, ad as Ct } from "./index-ytnYzWRW.js";
+import { ae as _t, af as Ct } from "./index-G3hmIs2P.js";
 function Yt(e, r, t = 2, i, o = "xy") {
   const s = r && r.length, l = s ? r[0] * t : e.length;
   let c = Ut(e, 0, l, t, !0, i && i[0], o);