@fxi/zartigl 0.10.5 → 0.11.1

package/dist/engine.d.ts

@@ -178,7 +178,10 @@ export declare function createColorRampTexture(gl: WebGL2RenderingContext, ramp?
     alphaFade?: AlphaFade;
 }): WebGLTexture;
 
-/** The frame source decoding `manifest`: scalar or vector by its encoding. */
+/**
+ * The frame source decoding `manifest`: scalar or vector by its encoding.
+ * Scalar frames decode through WebCodecs where the browser supports it.
+ */
 export declare function createGeoVideoFrameSource(manifest: GeoVideoManifest, options?: {
     cacheSize?: number;
 }): GeoVideoScalarSource | GeoVideoVectorSource;
@@ -366,6 +369,8 @@ export declare class GeoVideoClock {
     /** Playhead, epoch ms. Assigning it also resets a terminal step's hold. */
     get ms(): number;
     set ms(value: number);
+    /** Progress through the final sample's held step, 0 elsewhere. */
+    get holdFraction(): number;
     /** Playback held, e.g. while a timeline thumb is held. */
     held: boolean;
     private playingValue;
@@ -381,6 +386,49 @@ export declare class GeoVideoClock {
     advance(dt: number, times: ArrayLike<number>, stepsPerSecond: number, range?: readonly [number, number], loop?: boolean, holdLastStep?: boolean): boolean;
 }
 
+/**
+ * Scalar-luma GeoVideo decoded with WebCodecs, in decode order: playback
+ * feeds the decoder sample after sample instead of seeking a video element,
+ * which redecodes from the previous keyframe at every step. A step behind
+ * the last one taken, or past a later keyframe, restarts at its keyframe.
+ * Frames stay images, decoded on the GPU by GEOVIDEO_SCALAR_GLSL like those
+ * of GeoVideoScalarSource, which serves browsers without WebCodecs for the
+ * codec.
+ */
+export declare class GeoVideoCodecScalarSource extends GeoVideoScalarSource {
+    private track;
+    private data;
+    /** Decode-order sample presenting each video frame. */
+    private sampleOfFrame;
+    private decoder;
+    /** Next sample (decode order) to feed; -1 when the decoder needs a reset. */
+    private fed;
+    /** Last video frame handed out; later frames can still be reached. */
+    private taken;
+    /** Decoded frames not taken yet, by video frame. */
+    private readonly outputs;
+    private progress;
+    private failure;
+    /** Aborts the media download of the current load on release. */
+    private loading;
+    /** True once the media decodes through WebCodecs. */
+    get usesWebCodecs(): boolean;
+    protected loadMedia(): Promise<void>;
+    release(): void;
+    protected decode(index: number, signal: AbortSignal): Promise<GeoVideoScalarFrame>;
+    private config;
+    /** Video frame `frame`, owned by the caller. */
+    private decodeFrame;
+    private dropOutputsBefore;
+    private keySample;
+    private restart;
+    private feed;
+    /** Next output, dequeue or error; a timer for decoders without events. */
+    private waitProgress;
+    private notify;
+    private closeDecoder;
+}
+
 /**
  * GeoVideo frames as textures, decoded ahead of the playhead: vector frames
  * as float (u, v, validity, 0), scalar frames as the browser decodes them,
@@ -416,6 +464,8 @@ export declare class GeoVideoField {
     get maxSpeed(): number;
     /** Resolves once the step at `ms` is uploaded. */
     prime(ms: number): Promise<void>;
+    /** The uploaded texture of the step at `ms`, or null. */
+    texture(ms: number): WebGLTexture | null;
     /** True once the frames interpolated at `ms` are uploaded. */
     ready(ms: number): boolean;
     /**
@@ -530,7 +580,8 @@ export declare abstract class GeoVideoFrameSource<TFrame> {
     private drop;
     private load;
     private loadMask;
-    private loadVideo;
+    /** Open the media; the default reads frames by seeking a video element. */
+    protected loadMedia(): Promise<void>;
     /** Seek to a frame and wait until it is presented. */
     private presentFrame;
     /**
@@ -539,6 +590,8 @@ export declare abstract class GeoVideoFrameSource<TFrame> {
      * playback would otherwise buffer far beyond the requested frame.
      */
     private primeDecoder;
+    /** Media time inside the video frame showing step `index`. */
+    protected stepSeconds(index: number): number;
     /**
      * Seek and capture one step. `signal` aborts it between steps; a seek
      * already started completes first, keeping the queue serial.
@@ -667,6 +720,12 @@ export declare class GeoVideoPlayback {
     constructor(options: GeoVideoPlaybackOptions, repaint: () => void, emit: <K extends keyof GeoVideoPlaybackEvents>(event: K, ...args: Parameters<GeoVideoPlaybackEvents[K]>) => void);
     load(gl: WebGL2RenderingContext, manifest: GeoVideoManifest): Promise<void>;
     sample(now: number): readonly [WebGLTexture, WebGLTexture, number] | null;
+    /**
+     * Through the final step of a chunk followed by a decoded one, the last
+     * frame blends into the next chunk's first, as steps do within a chunk:
+     * the chunk swap then lands on the frame already shown.
+     */
+    private handoff;
     get time(): number;
     get preloadedMediaUrl(): string | undefined;
     setStepsPerSecond(value: number): void;

package/dist/engine.js

@@ -1,63 +1,64 @@
-import { K as o, L as s, G as r, M as i, j as d, N as t, O as G, P as c, Q as l, m as V, R as n, S as L, U as S, T as C, V as u, W as m, X as O, Y as _, b as p, Z as R, c as A, _ as T, $ as x, n as g, B as k, F, a0 as I, a1 as h, p as v, x as D, u as E, C as f, E as B, o as b, D as N, a2 as P, a3 as y, a4 as M, a5 as W, q as U, a6 as H, a7 as K, a8 as Y, H as j, a9 as q, aa as J, J as Q, v as X, ab as Z } from "./engine--787AbnI.js";
-import { B as w, a as z, f as aa, b as ea, e as oa, c as sa, g as ra, i as ia, r as da, d as ta } from "./backdrop-Dceb4d8E.js";
+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";
 export {
-  w as BACKDROP_OFF,
+  z as BACKDROP_OFF,
   o as COLOR_GRADE_GLSL,
-  z as COLOR_GRADE_OFF,
-  aa as COLOR_GRADE_VIBRANT,
+  aa as COLOR_GRADE_OFF,
+  ea as COLOR_GRADE_VIBRANT,
   s as GEOVIDEO_SCALAR_GLSL,
   r as GLOW_GAIN,
   i as GLOW_GLSL,
   d as GLOW_SCALE,
-  t as GeoVideoArchiveSource,
-  G as GeoVideoClock,
-  c as GeoVideoField,
-  l as GeoVideoFrameSource,
-  V as GeoVideoPlayback,
-  n as GeoVideoScalarSource,
-  L as GeoVideoVectorSource,
-  S as RANDOM_GLSL,
-  C as TrailFade,
-  u as VELOCITY_BLEND_GLSL,
-  m as VIBRANCE_GLSL,
-  O as alphaFadeAt,
-  _ as assertGeoVideoIndexIdentity,
-  ea as backdropVec4,
-  oa as colorGradeToGrade,
-  sa as colorGradeVec4,
-  p as createColorRampTexture,
-  R as createGeoVideoFrameSource,
-  A as createProgram,
-  T as createShader,
-  x as fadeToFrames,
-  g as fadeToOpacity,
-  k as formatUnit,
-  F as geoVideoChunkSources,
-  I as geoVideoGrid,
-  h as geoVideoIndexChunks,
-  v as geoVideoScalarUniforms,
-  D as geoVideoTimelineValues,
-  E as getPalettes,
-  ra as gradeToColorGrade,
-  f as isGeoVideoArchiveSource,
-  ia as isHexColor,
-  B as loadGeoVideoIndex,
-  b as loadGeoVideoManifest,
-  N as nextChunk,
-  P as nextChunkSpan,
-  y as pairChunk,
-  M as pairChunkSpan,
-  W as parseTimeRange,
-  da as resolveBackdrop,
-  ta as resolveColorGrade,
-  U as resolveColorRamp,
-  H as stepTime,
-  K as subtractIsoDuration,
-  Y as timeBracket,
-  j as timeRangeBounds,
-  q as timeStep,
-  J as validateGeoVideoIndex,
-  Q as validateGeoVideoManifest,
-  X as validateScalarColorDomain,
-  Z as velocityTexels
+  G as GeoVideoArchiveSource,
+  c as GeoVideoClock,
+  t as GeoVideoCodecScalarSource,
+  l as GeoVideoField,
+  V as GeoVideoFrameSource,
+  n as GeoVideoPlayback,
+  S as GeoVideoScalarSource,
+  C as GeoVideoVectorSource,
+  L as RANDOM_GLSL,
+  u as TrailFade,
+  m as VELOCITY_BLEND_GLSL,
+  O as VIBRANCE_GLSL,
+  _ as alphaFadeAt,
+  p as assertGeoVideoIndexIdentity,
+  oa as backdropVec4,
+  sa as colorGradeToGrade,
+  ra as colorGradeVec4,
+  R as createColorRampTexture,
+  A as createGeoVideoFrameSource,
+  T as createProgram,
+  x as createShader,
+  g as fadeToFrames,
+  k as fadeToOpacity,
+  F as formatUnit,
+  I as geoVideoChunkSources,
+  h as geoVideoGrid,
+  v as geoVideoIndexChunks,
+  D as geoVideoScalarUniforms,
+  E as geoVideoTimelineValues,
+  f as getPalettes,
+  ia as gradeToColorGrade,
+  B as isGeoVideoArchiveSource,
+  da as isHexColor,
+  b as loadGeoVideoIndex,
+  N as loadGeoVideoManifest,
+  P as nextChunk,
+  y as nextChunkSpan,
+  M as pairChunk,
+  W as pairChunkSpan,
+  U as parseTimeRange,
+  Ga as resolveBackdrop,
+  ca as resolveColorGrade,
+  H as resolveColorRamp,
+  K as stepTime,
+  Y as subtractIsoDuration,
+  j as timeBracket,
+  q as timeRangeBounds,
+  J as timeStep,
+  Q as validateGeoVideoIndex,
+  X as validateGeoVideoManifest,
+  Z as validateScalarColorDomain,
+  $ as velocityTexels
 };

package/dist/{index-Bo7du_KN.js → index-DKYFuzyw.js}

@@ -191,7 +191,7 @@ function _e(e, a, o = {}) {
   }
   return A(s);
 }
-const S = "0.10.5", N = { "maplibre-gl": "^5.17.0" }, le = {
+const S = "0.11.1", 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.js

@@ -1,6 +1,6 @@
-import { m as WA, p as yB, s as rB, a as rg, b as ng, r as OI, c as RC, d as UA, e as dC, f as nB, g as UC } from "./index-Bo7du_KN.js";
-import { T as lC, g as LC, r as kC, d as JC, c as wA, a as MC, b as iI, e as KC, f as mA, h as SI, i as aA, G as qC, j as Fg, v as YA, k as fA, s as zI, l as jI, m as FB, n as wg, o as uI, p as YC, q as pI, t as fC, u as wB, w as EA, x as cg, y as HC, z as mC, A as uC, B as Sg, C as QI, D as pC, E as xC, F as TC, H as WC } from "./engine--787AbnI.js";
-import { I as qi, J as Yi } from "./engine--787AbnI.js";
+import { m as WA, p as yB, s as rB, a as rg, b as ng, r as OI, c as RC, d as UA, e as dC, f as nB, g as UC } from "./index-DKYFuzyw.js";
+import { T as lC, g as LC, r as kC, d as JC, c as wA, a as MC, b as iI, e as KC, f as mA, h as SI, i as aA, G as qC, j as Fg, v as YA, k as fA, s as zI, l as jI, m as FB, n as wg, o as uI, p as YC, q as pI, t as fC, u as wB, w as EA, x as cg, y as HC, z as mC, A as uC, B as Sg, C as QI, D as pC, E as xC, F as TC, H as WC } from "./engine-BBxJ6x3s.js";
+import { I as qi, J as Yi } from "./engine-BBxJ6x3s.js";
 import { B as bC, a as vC, b as PC, c as ZC, d as cB, r as SB, e as VC, g as OC } from "./backdrop-Dceb4d8E.js";
 import { f as Hi, i as mi } from "./backdrop-Dceb4d8E.js";
 const xI = 85, zC = 89.9;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fxi/zartigl",
-  "version": "0.10.5",
+  "version": "0.11.1",
   "description": "MapLibre GL JS visualization for catalog-backed Zarr, WMTS, and GeoVideo data",
   "repository": {
     "type": "git",