@fxi/zartigl 0.12.0 → 0.13.0

package/dist/engine.d.ts

@@ -626,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. */
@@ -652,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;
@@ -916,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,4 +1,4 @@
-import { M as o, N as s, G as r, O as d, j as i, P as G, Q as c, R as t, S as l, U as V, m as n, V as S, W as L, X as C, T as u, Y as m, Z as O, _, $ as p, b as R, a0 as A, c as T, a1 as x, a2 as I, n as g, B as k, I as F, a3 as h, J as v, p as D, x as E, u as f, D as B, H as b, o as N, E as P, a4 as y, a5 as M, a6 as W, a7 as U, q as H, a8 as Y, a9 as j, aa as q, F as J, ab as K, ac as Q, L as X, v as Z, ad as $ } from "./engine-DM-lalJq.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,
@@ -16,8 +16,8 @@ export {
   V as GeoVideoFrameSource,
   n as GeoVideoPlayback,
   S as GeoVideoScalarSource,
-  L as GeoVideoVectorSource,
-  C as RANDOM_GLSL,
+  C as GeoVideoVectorSource,
+  L as RANDOM_GLSL,
   u as TrailFade,
   m as VELOCITY_BLEND_GLSL,
   O as VIBRANCE_GLSL,
@@ -29,34 +29,34 @@ export {
   R as createColorRampTexture,
   A as createGeoVideoFrameSource,
   T as createProgram,
-  x as createShader,
-  I as fadeToFrames,
-  g as fadeToOpacity,
-  k as formatUnit,
-  F as geoVideoChunkSources,
-  h as geoVideoGrid,
-  v as geoVideoIndexChunks,
-  D as geoVideoScalarUniforms,
+  g as createShader,
+  k as fadeToFrames,
+  x as fadeToOpacity,
+  F as formatUnit,
+  I as geoVideoChunkSources,
+  f as geoVideoGrid,
+  h as geoVideoIndexChunks,
+  v as geoVideoScalarUniforms,
   E as geoVideoTimelineValues,
-  f as getPalettes,
+  D as getPalettes,
   da as gradeToColorGrade,
   B as isGeoVideoArchiveSource,
   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,
   H as resolveColorRamp,
-  Y as stepTime,
-  j as subtractIsoDuration,
-  q as timeBracket,
-  J as timeRangeBounds,
-  K as timeStep,
+  K as stepTime,
+  Y as subtractIsoDuration,
+  j as timeBracket,
+  q as timeRangeBounds,
+  J as timeStep,
   Q as validateGeoVideoIndex,
   X as validateGeoVideoManifest,
   Z as validateScalarColorDomain,

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

@@ -191,7 +191,7 @@ function _e(e, a, i = {}) {
   }
   return M(s);
 }
-const S = "0.12.0", 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): {
@@ -1580,6 +1585,14 @@ export declare class Zartigl {
     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;
@@ -1612,9 +1625,8 @@ export declare class Zartigl {
     private changeSource;
     /**
      * Source switch after init. An archive moves between its own chunks with
-     * the time or window; no time ever switches to another source. In "auto"
-     * only, until GeoVideo renders depths, a deeper level shows Zarr and the
-     * surface level GeoVideo again.
+     * the time, the window, or the depth (its published levels); no time or
+     * depth ever switches to another source.
      */
     private needsSourceSwitch;
     private applyVisible;
@@ -1710,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;
@@ -1730,8 +1741,6 @@ export declare class Zartigl {
     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
@@ -1752,8 +1761,6 @@ export declare class Zartigl {
     private continueArchivePlayback;
     /** The entry's initialised field Zarr, or null when it has none. */
     private entryFieldZarr;
-    /** Zarr vertical axis; unavailable metadata leaves GeoVideo without one. */
-    private zarrVertical;
     /**
      * 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
@@ -1769,10 +1776,19 @@ export declare class Zartigl {
     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;
@@ -1839,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 {