@nika-js/onlymap 0.6.17 → 0.6.19

package/dist/basemap.d.ts

@@ -48,7 +48,15 @@ export declare class MapLibreBasemapAdapter {
         zoom: number;
         pitch?: number;
         bearing?: number;
-    }, deckProps: DeckProps, showAttribution?: boolean, attributionHost?: HTMLElement);
+    }, deckProps: DeckProps, showAttribution?: boolean, attributionHost?: HTMLElement, deterministic?: boolean);
+    /** whenSettled's basemap gate (issue #37 follow-up): style + all raster/vector tiles for the current view fully loaded. */
+    isIdle(): boolean;
+    /** The overlay deck's live layers — whenSettled's readiness gate (issue #37). */
+    getDeckLayers(): {
+        isLoaded: boolean;
+    }[] | undefined;
+    /** One forced draw of both canvases (no capture) — whenSettled's "at least one completed render" guarantee (issue #37). */
+    forceRepaint(): void;
     /** Snapshot capture queue for the overlay's deck canvas — see captureComposite. */
     private deckCaptures;
     /** In-flight captureComposite rejects — destroy() settles them so a caller never hangs on a torn-down renderer. */

package/dist/declarative-filter.d.ts

@@ -19,3 +19,4 @@ export declare function declarativeFilterPredicate(shape: Shape, filter: LayerFi
 export declare function applyDeclarativeCategoryFilter(rows: readonly unknown[], shape: Shape, categoryFilter: LayerCategoryFilter): unknown[];
 /** Categorical twin of `declarativeFilterPredicate` — set membership instead of a range test. */
 export declare function declarativeCategoryFilterPredicate(shape: Shape, categoryFilter: LayerCategoryFilter): (row: unknown) => boolean;
+export declare function warnCategoryCardinality(categoryFilter: LayerCategoryFilter | undefined, rows: readonly unknown[], shape: Shape, warnLabel: string): void;

package/dist/effects.d.ts

@@ -10,6 +10,11 @@
  */
 import type { RuntimeCore } from "./runtime-core";
 /** Pure easing/oscillation math — unit-testable without a clock. */
+/**
+ * Named easing curves for effect verbs (`<om-step action="trace" easing="ease-in-out">`).
+ * Applied to the effect clock BEFORE the frame callback — one place, every verb.
+ */
+export declare const EASINGS: Record<string, (t: number) => number>;
 export declare function traceProgress(t01: number, t0: number, t1: number): number;
 /** Oscillates 1 → low → 1 per cycle (cosine), ending exactly at 1 for whole cycles. */
 export declare function pulseOpacity(t01: number, cycles: number, low?: number): number;
@@ -19,6 +24,8 @@ export interface LayerEffect {
     frame(t01: number): Record<string, unknown>;
     /** What to do at the end: hold the final frame's patch, or clear it. */
     end: "hold" | "clear";
+    /** Optional clock easing (see EASINGS) — applied before `frame`. */
+    easing?: (t: number) => number;
     /** Runs after the end state is applied — phase chaining (trace: draw → reveal → dissolve). */
     onDone?(): void;
 }
@@ -27,12 +34,17 @@ export interface LayerEffect {
  * pure: a GeoJSON-ish feature (or bare geometry / flat row) → the outline
  * path with CUMULATIVE-DISTANCE timestamps, so the draw speed is uniform
  * around the perimeter regardless of vertex spacing. Polygon → outer ring;
- * MultiPolygon → first polygon's outer ring; LineString → the line itself.
+ * MultiPolygon → EVERY part's outer ring, drawn in sequence longest-first
+ * (one currentTime sweep, ring timestamps offset by the running total);
+ * LineString → the line itself.
  * Returns null for untraceable geometry (points, missing geometry).
  */
-export declare function buildTraceOutline(feature: unknown): {
+export interface TraceSegment {
     path: [number, number][];
     timestamps: number[];
+}
+export declare function buildTraceOutline(feature: unknown): {
+    segments: TraceSegment[];
     total: number;
 } | null;
 export declare function cancelLayerEffect(core: RuntimeCore, layerId: string): void;

package/dist/elements/om-map.d.ts

@@ -54,6 +54,7 @@ export declare class OmMapElement extends HTMLElementBase {
     /** Dedup guard for the no-terrain-for-elevation error — same shape as `warnedApproximatePlacement`. */
     private erroredNoTerrainForElevation;
     private readyFired;
+    private firstSettleDrawDone;
     /** Custom-state holder for the `om-collapsed` height-floor marker — see applyHeightFloor. */
     private internals;
     private resolveReady;
@@ -258,6 +259,20 @@ export declare class OmMapElement extends HTMLElementBase {
     /** Harness map-point injection (spec: "Consumer Testing Surface") — the
      *  same path a real deck click/hover coordinate takes, so the om-map-point
      *  event and custom capture tools are testable without a GPU. */
+    /**
+     * The map's "done drawing" promise (issue #37): resolves once every live
+     * 3D tileset has refined for the CURRENT view and one further animation
+     * frame has been painted — the await a pull-model frame renderer (or a
+     * consumer Playwright test) needs before screenshotting. Resolves
+     * `{settled:false}` with a console warning on timeout rather than
+     * rejecting (a late frame is ordinary pop-in, not an error). v1 gates 3D
+     * tilesets only — basemap raster tiles are not yet awaited.
+     */
+    whenSettled(opts?: {
+        timeout?: number;
+    }): Promise<{
+        settled: boolean;
+    }>;
     injectMapPointInternal(coordinate: [number, number] | null, kind?: "click" | "hover", pointerType?: string): void;
     /** Harness setView (spec: "Consumer Testing Surface") — the one path that reaches pitch/bearing. */
     setViewInternal(partial: {

package/dist/elements/om-story.d.ts

@@ -28,7 +28,9 @@ export declare class OmStoryElement extends HTMLElementBase {
     get duration(): number;
     play(): void;
     pause(): void;
-    seek(ms: number): void;
+    seek(ms: number, opts?: {
+        interpolateCamera?: boolean;
+    }): void;
     /**
      * Per-frame capture hook for paced runs (the recorder seam, issue #16):
      * called after each paced frame is fully refined and BEFORE the frame's

package/dist/{geoparquet-DG3VtNgs.js → geoparquet-DWQCUg6N.js}

@@ -1,4 +1,4 @@
-import { r as p, n as d } from "./index-CX4qxgVT.js";
+import { r as p, n as d } from "./index-CagRqDDL.js";
 function g(t) {
   if (t == null) return !0;
   const e = t, n = e.id?.code;

package/dist/ifc-Dc-TdSJr.js

@@ -82,12 +82,11 @@ async function le() {
     const t = `${Tt}web-ifc-api.js`, e = await (await Lt(t)).text(), o = URL.createObjectURL(new Blob([e], { type: "text/javascript" }));
     let n;
     try {
-      n = await import(
-        /* @vite-ignore */
+      n = await import(/* webpackIgnore: true */ /* @vite-ignore */
         o
       );
     } catch {
-      n = await import(`data:text/javascript;base64,${oe(new TextEncoder().encode(e))}`);
+      n = await import(/* webpackIgnore: true */ `data:text/javascript;base64,${oe(new TextEncoder().encode(e))}`);
     } finally {
       URL.revokeObjectURL(o);
     }

package/dist/{index-DceORL-v.js → index-4St6BumW.js}

@@ -1,5 +1,5 @@
-import { i as E, j as S, k as R, o as N, p as h, q as w, s as O, t as W, v as x, w as I, x as B, y as _, A as P, B as k, E as $, F as z, H as v, I as F, J as C, K as U, N as p, O as M } from "./index-CX4qxgVT.js";
-import { P as $e, R as ze, _ as ve, Q as Ce, S as Ue, T as Me, U as je, X as De, Y as Je, Z as qe, $ as He, a0 as Ve, a1 as Ge, a2 as Ke, a3 as Qe, a4 as Xe, a5 as Ye, a6 as Ze, a7 as et, a8 as tt, a9 as nt, aa as rt, ab as at, ac as st, ad as ot } from "./index-CX4qxgVT.js";
+import { i as E, j as S, k as R, o as N, p as h, q as w, s as O, t as W, v as x, w as I, x as B, y as _, A as P, B as k, E as $, F as z, H as v, I as F, J as C, K as U, N as p, O as M } from "./index-CagRqDDL.js";
+import { P as $e, R as ze, _ as ve, Q as Ce, S as Ue, T as Me, U as je, X as De, Y as Je, Z as qe, $ as He, a0 as Ve, a1 as Ge, a2 as Ke, a3 as Qe, a4 as Xe, a5 as Ye, a6 as Ze, a7 as et, a8 as tt, a9 as nt, aa as rt, ab as at, ac as st, ad as ot } from "./index-CagRqDDL.js";
 import { g as j, i as D } from "./table-accessors-CYWTzpQI.js";
 async function J(t, e, n = {}, r = {}) {
   const a = E(t), s = S.getWorkerFarm(n), { source: o } = n, c = { name: a, source: o };

package/dist/{index-Yl9rVUWh.js → index-BTM6Mblt.js}

@@ -1,4 +1,4 @@
-import { ag as Be, ah as le, ai as ce, aj as De, ak as Oe, al as ke } from "./index-CX4qxgVT.js";
+import { ag as Be, ah as le, ai as ce, aj as De, ak as Oe, al as ke } from "./index-CagRqDDL.js";
 import { y as ve, a as he, z as G, R as J, A as ue, C as Fe, F as je, n as xe, S as Ie, E as Ne } from "./recordbatch-Bpc0uxFn.js";
 import { g as V, a as fe, b as Le, c as Ue, d as Me, e as qe, m as Ve } from "./table-accessors-CYWTzpQI.js";
 import { c as $e } from "./convert-arrow-schema-DrAihRf9.js";

package/dist/{index-DlXIfdhF.js → index-CNlULiHm.js}

@@ -1,4 +1,4 @@
-import { ak as Bt, ax as Xt, ay as Yt, az as Us } from "./index-CX4qxgVT.js";
+import { ak as Bt, ax as Xt, ay as Yt, az as Us } from "./index-CagRqDDL.js";
 import { w as gs, t as Hs, f as Ws, m as Qs } from "./mgrs-BY9bIvp4.js";
 import { c as Xs } from "./convert-arrow-schema-DrAihRf9.js";
 import { y as Ys, A as bt, a as Ks, z as Vs, R as Zs } from "./recordbatch-Bpc0uxFn.js";