@fxi/zartigl 0.11.3 → 0.13.0

package/dist/engine.d.ts

@@ -238,6 +238,8 @@ export declare interface GeoVideoArchiveChunk extends GeoVideoChunkSpan {
     manifestUrl: string;
     /** Encoded samples, when the index lists them. */
     samples?: number;
+    /** Time of each encoded sample, UTC milliseconds, when the index lists them. */
+    times?: number[];
     provisional?: boolean;
 }
 
@@ -624,6 +626,12 @@ export declare interface GeoVideoIndex {
     sourceId: string;
     updatedAt: string | null;
     chunks: GeoVideoIndexChunk[];
+    /** On a surface index: the levels below it with playable chunks, shallow to deep. */
+    depths?: GeoVideoIndexDepth[];
+    /** On a surface index with depths: the surface level. */
+    surface?: GeoVideoVerticalLevel;
+    /** On a depth index: its level. */
+    vertical?: GeoVideoVerticalLevel;
 }
 
 /** One immutable, calendar-aligned artifact of a GeoVideo archive. */
@@ -636,6 +644,8 @@ export declare interface GeoVideoIndexChunk {
     start: string;
     end: string;
     samples: number;
+    /** Every encoded sample; absent from chunks indexed before it existed. */
+    times?: string[];
     key: string;
     /** Relative to the index URL. */
     manifestUrl: string;
@@ -648,6 +658,12 @@ export declare interface GeoVideoIndexChunk {
  */
 export declare function geoVideoIndexChunks(index: GeoVideoIndex, indexUrl: string): GeoVideoArchiveChunk[];
 
+/** A level besides the surface, with the index of its own chunks. */
+declare interface GeoVideoIndexDepth extends GeoVideoVerticalLevel {
+    /** Relative to the surface index URL. */
+    indexUrl: string;
+}
+
 export declare interface GeoVideoManifest {
     schemaVersion: 3;
     id: string;
@@ -912,6 +928,15 @@ export declare class GeoVideoVectorSource extends GeoVideoFrameSource<GeoVideoVe
     protected capture(video: HTMLVideoElement, rows: number, mask: Uint8Array): Promise<GeoVideoVectorFrame | null>;
 }
 
+/** A native vertical level: the store coordinate's identity and exact value. */
+declare interface GeoVideoVerticalLevel {
+    name: string;
+    units: string;
+    /** CF `positive`: "up" for elevation, "down" for depth. */
+    positive: string;
+    value: number;
+}
+
 /**
  * Palettes to offer, without deprecated ones (still resolvable for old
  * configs) unless `includeDeprecated`.

package/dist/engine.js

@@ -1,5 +1,5 @@
-import { K as o, L as s, G as r, M as i, j as d, N as G, O as c, P as t, Q as l, R as V, m as n, S, U as C, V as L, T as u, W as m, X as O, Y as _, Z as p, b as R, _ as A, c as T, $ as x, a0 as g, n as k, B as F, F as I, a1 as h, a2 as v, p as D, x as E, u as f, C as B, E as b, o as N, D as P, a3 as y, a4 as M, a5 as W, a6 as U, q as H, a7 as K, a8 as Y, a9 as j, H as q, aa as J, ab as Q, J as X, v as Z, ac as $ } from "./engine-BBxJ6x3s.js";
-import { B as z, a as aa, f as ea, b as oa, e as sa, c as ra, g as ia, i as da, r as Ga, d as ca } from "./backdrop-Dceb4d8E.js";
+import { O as o, P as s, G as r, Q as d, j as i, R as G, S as c, U as t, V as l, W as V, m as n, X as S, Y as C, Z as L, T as u, _ as m, $ as O, a0 as _, a1 as p, b as R, a2 as A, c as T, a3 as g, a4 as k, n as x, C as F, K as I, a5 as f, L as h, p as v, y as E, u as D, E as B, J as b, o as N, F as y, a6 as P, a7 as W, a8 as M, a9 as U, q as H, aa as K, ab as Y, ac as j, H as q, ad as J, ae as Q, N as X, v as Z, af as $ } from "./engine-Bhb-WayM.js";
+import { B as z, a as aa, f as ea, b as oa, e as sa, c as ra, g as da, i as ia, r as Ga, d as ca } from "./backdrop-Dceb4d8E.js";
 export {
   z as BACKDROP_OFF,
   o as COLOR_GRADE_GLSL,
@@ -7,8 +7,8 @@ export {
   ea as COLOR_GRADE_VIBRANT,
   s as GEOVIDEO_SCALAR_GLSL,
   r as GLOW_GAIN,
-  i as GLOW_GLSL,
-  d as GLOW_SCALE,
+  d as GLOW_GLSL,
+  i as GLOW_SCALE,
   G as GeoVideoArchiveSource,
   c as GeoVideoClock,
   t as GeoVideoCodecScalarSource,
@@ -29,25 +29,25 @@ export {
   R as createColorRampTexture,
   A as createGeoVideoFrameSource,
   T as createProgram,
-  x as createShader,
-  g as fadeToFrames,
-  k as fadeToOpacity,
+  g as createShader,
+  k as fadeToFrames,
+  x as fadeToOpacity,
   F as formatUnit,
   I as geoVideoChunkSources,
-  h as geoVideoGrid,
-  v as geoVideoIndexChunks,
-  D as geoVideoScalarUniforms,
+  f as geoVideoGrid,
+  h as geoVideoIndexChunks,
+  v as geoVideoScalarUniforms,
   E as geoVideoTimelineValues,
-  f as getPalettes,
-  ia as gradeToColorGrade,
+  D as getPalettes,
+  da as gradeToColorGrade,
   B as isGeoVideoArchiveSource,
-  da as isHexColor,
+  ia as isHexColor,
   b as loadGeoVideoIndex,
   N as loadGeoVideoManifest,
-  P as nextChunk,
-  y as nextChunkSpan,
-  M as pairChunk,
-  W as pairChunkSpan,
+  y as nextChunk,
+  P as nextChunkSpan,
+  W as pairChunk,
+  M as pairChunkSpan,
   U as parseTimeRange,
   Ga as resolveBackdrop,
   ca as resolveColorGrade,

package/dist/{index-DVXVRI3C.js → index-C-RZ2d8q.js}

@@ -191,7 +191,7 @@ function _e(e, a, i = {}) {
   }
   return M(s);
 }
-const S = "0.11.3", N = { "maplibre-gl": "^5.17.0" }, le = {
+const S = "0.13.0", N = { "maplibre-gl": "^5.17.0" }, le = {
   version: S,
   devDependencies: N
 }, F = "https://sos-ch-gva-2.exo.io/mapx-zartigl/catalog/v2/catalog.json";

package/dist/zartigl.d.ts

@@ -212,6 +212,11 @@ export declare interface DepthMeta {
     label: "depth" | "pressure" | string;
     units?: string;
     current?: number;
+    /**
+     * The field has depths the source cannot show yet: a GeoVideo archive
+     * that publishes none, shown at its surface. A depth control stays fixed.
+     */
+    locked?: boolean;
 }
 
 export declare function deriveDirectionMagnitudeComponents(directionDegrees: number, magnitude: number, derivation: VectorDerivation): {
@@ -1578,6 +1583,16 @@ export declare class Zartigl {
     private wmtsMetadata;
     private fieldSources;
     private archiveChunks;
+    /** Samples of each archive chunk the index lists them for, by manifest URL. */
+    private chunkTimes;
+    /** Published levels of each archive, by surface index URL. */
+    private archiveRoots;
+    /** Level of the archive chunk shown: null for the surface. */
+    private archiveLevel;
+    /** A field with depths shown at its surface only, until GeoVideo publishes them. */
+    private depthLocked;
+    /** Level of each archive chunk, by manifest URL: null for the surface. */
+    private chunkLevels;
     /** Manifest of the archive chunk expected next, requested ahead of it. */
     private nextChunkManifest;
     private activeFieldSource;
@@ -1609,11 +1624,9 @@ export declare class Zartigl {
     private loadSource;
     private changeSource;
     /**
-     * Source switch after init: leave the current GeoVideo when it cannot show
-     * the requested time, window, or depth and another source can. A time
-     * change alone never switches back, so scrubbing a Zarr timeline does not
-     * flip sources; in "auto", selecting the surface depth, alone or with a
-     * date GeoVideo covers, returns to GeoVideo.
+     * Source switch after init. An archive moves between its own chunks with
+     * the time, the window, or the depth (its published levels); no time or
+     * depth ever switches to another source.
      */
     private needsSourceSwitch;
     private applyVisible;
@@ -1709,7 +1722,6 @@ export declare class Zartigl {
      * In "auto", a GeoVideo that fails while it renders (media, mask) yields
      * to another source, paused, keeping the date and depth.
      */
-    private fallBackFromGeoVideo;
     private applyMutableSettings;
     private getQuerySource;
     private getFieldSource;
@@ -1719,15 +1731,16 @@ export declare class Zartigl {
      */
     private sourceTimeRequest;
     /**
-     * Source for a preference and target. In "auto", a GeoVideo that cannot show
-     * the requested depth (it renders the surface level) yields to Zarr.
+     * Source for a preference and target. An archive (pinned, or the
+     * GeoVideo of "geovideo" and "auto") shows its chunk for the time; an
+     * archive that cannot load fails a pinned or "geovideo" preference, and
+     * "auto" moves on to Zarr. Regional artifacts show only when pinned. In
+     * "auto", a level deeper than the surface GeoVideo renders shows Zarr.
      */
     private selectSource;
     private isFailedGeoVideo;
     /** The entry without GeoVideo artifacts that failed to load. */
     private withoutFailedGeoVideo;
-    /** Whether `depth` resolves to the surface level that GeoVideo renders. */
-    private geoVideoServesDepth;
     private isArchiveChunk;
     /**
      * The archive chunk that follows the current one inside the active time
@@ -1748,14 +1761,34 @@ export declare class Zartigl {
     private continueArchivePlayback;
     /** The entry's initialised field Zarr, or null when it has none. */
     private entryFieldZarr;
-    /** Zarr time and vertical axes; unavailable metadata leaves the artifact's own timeline. */
-    private zarrAxes;
+    /**
+     * Every sample of an archive's chunks, sorted, from its index. Chunks
+     * indexed before the index listed them read their manifest once, a few at
+     * a time; one that cannot be read only leaves its samples out.
+     */
+    private archiveTimes;
+    /**
+     * The archive sample a request shows: the one nearest its time inside its
+     * window (a trailing window counts back from the archive's last sample),
+     * the latest without a time. Snapping once, here, keeps the chunk loaded
+     * and the time shown in agreement.
+     */
+    private archiveSample;
     /**
      * Entry whose archive sources are replaced by one fixed-period source per
-     * published chunk. An unreachable index drops the archive, so selection
+     * published chunk at `level` (null: the surface). An unreachable index, or
+     * a level the archive does not publish, drops the archive, so selection
      * falls back to the entry's other sources.
      */
     private resolveArchives;
+    /** The published levels of an archive, read from its surface index. */
+    private archiveLevels;
+    /**
+     * Chunks of one index of an archive: its surface index (`level` null),
+     * which also lists the levels below, or a depth's, which must record that
+     * level. Revalidated like any archive index.
+     */
+    private archiveChunksAt;
     private resolveSource;
     private querySource;
     private isMapReady;
@@ -1822,6 +1855,11 @@ declare type ZartiglEventMap = {
     }) => void;
     /** The render layer was added to the map, e.g. for the host to order it. */
     layerAttach: (id: string) => void;
+    /**
+     * The time or vertical axis changed without a source change, e.g. on
+     * another depth of a GeoVideo archive: read getTimeMeta and getDepthMeta.
+     */
+    axesChange: () => void;
 };
 
 export declare class ZartiglFrameUnavailableError extends Error {