@fxi/zartigl 0.9.2 → 0.9.3

package/dist/engine.d.ts

@@ -705,6 +705,12 @@ export declare interface PaletteMeta {
     colors: string[];
 }
 
+/**
+ * Validate a time range from a JSON config: `{ start?, end? }` as ISO dates
+ * with start before end, or `{ trailing }` as a positive ISO 8601 duration.
+ */
+export declare function parseTimeRange(value: unknown, path: string): TimeRange;
+
 /** Particle trail color grade: a preset, or the vibrant one tuned. */
 declare type ParticleGrade = "off" | "vibrant" | GradeTuning;
 
@@ -765,6 +771,30 @@ export declare type ScalarColorDomain = [number, number];
  */
 declare type StyleRenderMode = "particles" | "raster" | "raster+particles";
 
+/** `anchor` minus an ISO 8601 duration, calendar months and years in UTC. */
+export declare function subtractIsoDuration(anchor: number, duration: string): number;
+
+/**
+ * Time windows shared by zartigl and the renderers built on its engine: a
+ * fixed `start`/`end`, either side open, or the `trailing` ISO 8601 duration
+ * before the latest available time.
+ */
+export declare type TimeRange = {
+    start?: Date | string | number;
+    end?: Date | string | number;
+    trailing?: never;
+} | {
+    trailing: string;
+    start?: never;
+    end?: never;
+};
+
+/**
+ * Bounds of `range` inside the available `[min, max]`, epoch ms: open sides
+ * take the available ones, `trailing` counts back from `max`.
+ */
+export declare function timeRangeBounds(range: TimeRange, [sourceMin, sourceMax]: readonly [number, number]): [number, number];
+
 /**
  * Camera-aware per-frame fade opacity: eases toward a short retention while
  * the camera moves, then back to the configured one. Smoothstep avoids

package/dist/engine.js

@@ -1,5 +1,5 @@
-import { F as i, H as u, I as m, G as v, T as g, J as x, b as f, K as _, c as p, L as V, M as G, l as C, y as S, D as b, N as O, O as R, n as L, t as A, z as h, A as y, C as F, m as I, B as T, P as k, Q as D, R as E, p as B, S as w, E as M, v as N } from "./geovideo-index-CzQo6UIG.js";
-import { B as z, C as H, e as K, b as U, d as J, c as Q, g as j, i as q, a as W, r as X } from "./backdrop-DctkJ45Q.js";
+import { I as i, J as u, K as m, G as v, T as g, L as x, b as f, M as _, c as p, N as V, O as G, l as C, z as S, E as b, P as R, Q as O, n as L, t as A, A as h, B as I, D as T, m as y, C as D, R as F, S as k, U as B, V as E, p as w, W as M, F as N, X as P, H as z, v as U } from "./geovideo-index-BYdh3auq.js";
+import { B as K, C as J, e as Q, b as W, d as X, c as j, g as q, i as Y, a as Z, r as $ } from "./backdrop-DctkJ45Q.js";
 var e = `vec3 applyVibrance(vec3 c, float v) {
     float mx = max(c.r, max(c.g, c.b));
     float mn = min(c.r, min(c.g, c.b));
@@ -44,10 +44,10 @@ float random(uvec3 v) {
 }`;
 const n = r, c = e, t = o, s = a;
 export {
-  z as BACKDROP_OFF,
+  K as BACKDROP_OFF,
   c as COLOR_GRADE_GLSL,
-  H as COLOR_GRADE_OFF,
-  K as COLOR_GRADE_VIBRANT,
+  J as COLOR_GRADE_OFF,
+  Q as COLOR_GRADE_VIBRANT,
   s as GEOVIDEO_SCALAR_GLSL,
   i as GeoVideoArchiveSource,
   u as GeoVideoFrameSource,
@@ -57,9 +57,9 @@ export {
   g as TrailFade,
   n as VIBRANCE_GLSL,
   x as assertGeoVideoIndexIdentity,
-  U as backdropVec4,
-  J as colorGradeToGrade,
-  Q as colorGradeVec4,
+  W as backdropVec4,
+  X as colorGradeToGrade,
+  j as colorGradeVec4,
   f as createColorRampTexture,
   _ as createGeoVideoFrameSource,
   p as createProgram,
@@ -68,24 +68,27 @@ export {
   C as fadeToOpacity,
   S as formatUnit,
   b as geoVideoChunkSources,
-  O as geoVideoGrid,
-  R as geoVideoIndexChunks,
+  R as geoVideoGrid,
+  O as geoVideoIndexChunks,
   L as geoVideoScalarUniforms,
   A as geoVideoTimelineValues,
   h as getPalettes,
-  j as gradeToColorGrade,
-  y as isGeoVideoArchiveSource,
-  q as isHexColor,
-  F as loadGeoVideoIndex,
-  I as loadGeoVideoManifest,
-  T as nextChunk,
-  k as nextChunkSpan,
-  D as pairChunk,
-  E as pairChunkSpan,
-  W as resolveBackdrop,
-  X as resolveColorGrade,
-  B as resolveColorRamp,
-  w as validateGeoVideoIndex,
-  M as validateGeoVideoManifest,
-  N as validateScalarColorDomain
+  q as gradeToColorGrade,
+  I as isGeoVideoArchiveSource,
+  Y as isHexColor,
+  T as loadGeoVideoIndex,
+  y as loadGeoVideoManifest,
+  D as nextChunk,
+  F as nextChunkSpan,
+  k as pairChunk,
+  B as pairChunkSpan,
+  E as parseTimeRange,
+  Z as resolveBackdrop,
+  $ as resolveColorGrade,
+  w as resolveColorRamp,
+  M as subtractIsoDuration,
+  N as timeRangeBounds,
+  P as validateGeoVideoIndex,
+  z as validateGeoVideoManifest,
+  U as validateScalarColorDomain
 };