@fxi/zartigl 0.1.3 → 0.2.13

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "@fxi/zartigl",
-  "version": "0.1.3",
+  "version": "0.2.13",
   "description": "MapLibre GL JS plugin for animated particle flow from Zarr ocean current data",
   "type": "module",
   "main": "./dist/zartigl.js",
   "module": "./dist/zartigl.js",
-  "types": "./dist/index.d.ts",
+  "types": "./dist/zartigl.d.ts",
   "exports": {
     ".": {
       "import": "./dist/zartigl.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/zartigl.d.ts"
+    },
+    "./catalog": {
+      "import": "./dist/catalog.js",
+      "types": "./dist/catalog.d.ts"
     }
   },
   "files": [
@@ -17,11 +21,22 @@
   ],
   "scripts": {
     "dev": "vite",
-    "dev:mapbox": "vite --config vite.config.demo-mapbox.ts",
+    "dev:minimal": "vite --config vite.config.minimal.ts",
+    "dev:prod": "npm run dev",
+    "test": "vitest run",
+    "test:unit": "vitest run",
     "build": "vite build",
-    "build:mapbox": "vite build --config vite.config.demo-mapbox.ts",
+    "build:minimal": "vite build --config vite.config.minimal.ts",
+    "build:prod": "npm run build",
     "build:lib": "vite build --config vite.config.lib.ts",
     "preview": "vite preview",
+    "catalog": "npm run catalog:validate",
+    "catalog:validate": "uv run scripts/catalog_builder/skills/validate_catalog.py",
+    "geovideo:dry-run": "uv run scripts/geovideo/render.py scripts/geovideo/examples/sst-anomaly.json --dry-run",
+    "geovideo:calibrate": "uv run scripts/geovideo/calibrate.py",
+    "geovideo:calibrate:browser": "uv run scripts/geovideo/browser_calibrate.py",
+    "smoke:sample": "npm run build:lib && node scripts/smoke-sample-point.mjs",
+    "release:check": "npm run test && npm run catalog:validate && npm run build && npm run build:lib && npm run smoke:sample",
     "prepublishOnly": "npm run build:lib"
   },
   "publishConfig": {
@@ -40,17 +55,21 @@
   "peerDependencies": {
     "maplibre-gl": ">=4.0.0"
   },
+  "dependencies": {
+    "numcodecs": "^0.3.2",
+    "pako": "^2.1.0"
+  },
   "devDependencies": {
     "@tweakpane/core": "^2.0.5",
+    "@types/d3": "^7.4.3",
     "@types/pako": "^2.0.4",
-    "mapbox-gl": "^2.15.0",
+    "d3": "^7.9.0",
     "maplibre-gl": "^5.17.0",
-    "numcodecs": "^0.3.2",
-    "pako": "^2.1.0",
     "tweakpane": "^4.0.5",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-glsl": "^1.5.5"
+    "vite-plugin-glsl": "^1.5.5",
+    "vitest": "^4.1.7"
   }
 }

package/dist/data/catalog.json

@@ -1,108 +0,0 @@
-{
-  "generated": "2026-02-11T08:27:15.746557+00:00",
-  "datasets": [
-    {
-      "id": "cmems_mod_glo_phy-cur_anfc_0.083deg_PT6H-i",
-      "product": "GLOBAL_ANALYSISFORECAST_PHY_001_024",
-      "label": "Global Ocean Currents (analysis+forecast)",
-      "zarr_url": "https://s3.waw3-1.cloudferro.com/mdl-arco-time-009/arco/GLOBAL_ANALYSISFORECAST_PHY_001_024/cmems_mod_glo_phy-cur_anfc_0.083deg_PT6H-i_202406/timeChunked.zarr",
-      "variables": {
-        "uo": {
-          "standard_name": "eastward_sea_water_velocity",
-          "units": "m s-1"
-        },
-        "vo": {
-          "standard_name": "northward_sea_water_velocity",
-          "units": "m s-1"
-        }
-      },
-      "dimensions": {
-        "depth": {
-          "axis": "z",
-          "values": [
-            5727.9169921875,
-            5274.7841796875,
-            4833.291015625,
-            4405.22412109375,
-            3992.48388671875,
-            3597.031982421875,
-            3220.820068359375,
-            2865.702880859375,
-            2533.3359375,
-            2225.077880859375,
-            1941.8929443359375,
-            1684.2840576171875,
-            1452.2509765625,
-            1245.291015625,
-            1062.43994140625,
-            902.3392944335938,
-            763.3331298828125,
-            643.5667724609375,
-            541.0889282226562,
-            453.9377136230469,
-            380.2130126953125,
-            318.1274108886719,
-            266.0403137207031,
-            222.47520446777344,
-            186.12559509277344,
-            155.85069274902344,
-            130.66600036621094,
-            109.72930145263672,
-            92.3260726928711,
-            77.85385131835938,
-            65.80726623535156,
-            55.76428985595703,
-            47.37369155883789,
-            40.344051361083984,
-            34.43415069580078,
-            29.444730758666992,
-            25.211410522460938,
-            21.598819732666016,
-            18.495559692382812,
-            15.810070037841797,
-            13.467140197753906,
-            11.404999732971191,
-            9.572997093200684,
-            7.92956018447876,
-            6.440614223480225,
-            5.078224182128906,
-            3.8194949626922607,
-            2.6456689834594727,
-            1.5413750410079956,
-            0.49402499198913574
-          ],
-          "size": 50,
-          "chunk_size": 1,
-          "units": "m"
-        },
-        "latitude": {
-          "axis": "y",
-          "size": 2041,
-          "min": -80.0,
-          "max": 90.0,
-          "step": 0.08333333333333333,
-          "chunk_size": 512,
-          "units": "degrees_north"
-        },
-        "longitude": {
-          "axis": "x",
-          "size": 4320,
-          "min": -180.0,
-          "max": 179.91668701171875,
-          "step": 0.08333333804392655,
-          "chunk_size": 2048,
-          "units": "degrees_east"
-        },
-        "time": {
-          "axis": "t",
-          "size": 5445,
-          "min": 1654041600000.0,
-          "max": 1771632000000.0,
-          "step": 21600000.0,
-          "chunk_size": 1,
-          "units": "milliseconds since 1970-01-01 00:00:00Z (no leap seconds)"
-        }
-      }
-    }
-  ]
-}

package/dist/index.d.ts

@@ -1,282 +0,0 @@
-import { CustomLayerInterface } from 'maplibre-gl';
-import { CustomRenderMethodInput } from 'maplibre-gl';
-import { Map as Map_2 } from 'maplibre-gl';
-
-declare interface CoordArrays {
-    time: Float64Array | Float32Array;
-    vertical: Float32Array;
-    latitude: Float32Array;
-    longitude: Float32Array;
-}
-
-export declare class ParticleLayer implements CustomLayerInterface {
-    readonly id: string;
-    readonly type: "custom";
-    readonly renderingMode: "2d";
-    private map;
-    private gl;
-    private simulation;
-    private velocityField;
-    private zarrSource;
-    private opts;
-    private initialized;
-    private loading;
-    private velocityTexUnit;
-    private moveEndHandler;
-    constructor(options: ParticleLayerOptions);
-    onAdd(map: Map_2, gl: WebGLRenderingContext): Promise<void>;
-    private initAsync;
-    private loadViewportVelocity;
-    render(gl: WebGLRenderingContext, options: CustomRenderMethodInput | number[]): void;
-    onRemove(): void;
-    setTime(time: string | number): void;
-    setDepth(depth: number): void;
-    setSpeedFactor(v: number): void;
-    setFadeOpacity(v: number): void;
-    setDropRate(v: number): void;
-    setDropRateBump(v: number): void;
-    setPointSize(v: number): void;
-    setParticleCount(count: number): void;
-    setColorRamp(ramp: Record<number, string>): void;
-}
-
-export declare interface ParticleLayerOptions {
-    id: string;
-    source: string;
-    variableU?: string;
-    variableV?: string;
-    particleCount?: number;
-    speedFactor?: number;
-    fadeOpacity?: number;
-    dropRate?: number;
-    dropRateBump?: number;
-    pointSize?: number;
-    colorRamp?: Record<number, string>;
-    time?: string | number;
-    depth?: number;
-}
-
-export declare class ParticleSimulation {
-    private gl;
-    private params;
-    private updateProgram;
-    private drawProgram;
-    private fadeProgram;
-    private particleStateTextures;
-    private particleFramebuffers;
-    private particleStateRes;
-    private particleIndexBuffer;
-    private numParticles;
-    private screenTextures;
-    private screenFramebuffers;
-    private screenWidth;
-    private screenHeight;
-    private quadBuffer;
-    private colorRampTexture;
-    private updateLocs;
-    private drawLocs;
-    private fadeLocs;
-    constructor(params?: Partial<SimulationParams>);
-    init(gl: WebGLRenderingContext): void;
-    private getUniforms;
-    private initParticleState;
-    /**
-     * Ensure screen textures match the current canvas size.
-     */
-    resize(width: number, height: number): void;
-    /**
-     * Run one simulation step: update positions, fade trails, draw particles.
-     * Must be called within the MapLibre render callback.
-     */
-    render(velocityTexUnit: number, velocityMin: [number, number], velocityMax: [number, number], matrix: Iterable<number>, bounds: {
-        minX: number;
-        minY: number;
-        maxX: number;
-        maxY: number;
-    }, worldSize: number, geoBounds?: {
-        west: number;
-        south: number;
-        east: number;
-        north: number;
-    }): void;
-    private drawQuad;
-    setSpeedFactor(v: number): void;
-    setFadeOpacity(v: number): void;
-    setDropRate(v: number): void;
-    setDropRateBump(v: number): void;
-    setPointSize(v: number): void;
-    setParticleCount(count: number): void;
-    setColorRamp(ramp: Record<number, string>): void;
-    /**
-     * Reset all particles to random positions. Call after time/depth change.
-     */
-    resetParticles(): void;
-    destroy(): void;
-}
-
-declare interface SimulationParams {
-    particleCount: number;
-    speedFactor: number;
-    fadeOpacity: number;
-    dropRate: number;
-    dropRateBump: number;
-    pointSize: number;
-    colorRamp?: Record<number, string>;
-}
-
-/**
- * Stitch multiple decoded chunks into a single global velocity grid.
- * The result covers [0,360) longitude x [-90,90] latitude.
- * Grid resolution matches the source data.
- */
-export declare function stitchVelocityChunks(uChunks: Array<{
-    data: Float32Array;
-    latStart: number;
-    lonStart: number;
-    latSize: number;
-    lonSize: number;
-}>, vChunks: Array<{
-    data: Float32Array;
-    latStart: number;
-    lonStart: number;
-    latSize: number;
-    lonSize: number;
-}>, totalLat: number, totalLon: number, geoBounds?: {
-    west: number;
-    south: number;
-    east: number;
-    north: number;
-}): VelocityData;
-
-export declare interface VelocityData {
-    u: Float32Array;
-    v: Float32Array;
-    width: number;
-    height: number;
-    uMin: number;
-    uMax: number;
-    vMin: number;
-    vMax: number;
-    bounds: {
-        west: number;
-        south: number;
-        east: number;
-        north: number;
-    };
-}
-
-/**
- * Manages a WebGL texture that holds stitched U/V velocity data
- * in geographic space [0,1]x[0,1], with R=u, G=v normalized to [0,1].
- */
-export declare class VelocityField {
-    private gl;
-    private texture;
-    private width;
-    private height;
-    uMin: number;
-    uMax: number;
-    vMin: number;
-    vMax: number;
-    geoBounds: {
-        west: number;
-        south: number;
-        east: number;
-        north: number;
-    };
-    init(gl: WebGLRenderingContext): void;
-    /**
-     * Upload velocity data as a 2-channel (RG) texture.
-     * Input: u/v Float32Arrays with real physical values.
-     * Stored normalized to [0,1] using uMin/uMax/vMin/vMax.
-     */
-    update(data: VelocityData): void;
-    bind(unit: number): void;
-    hasData(): boolean;
-    destroy(): void;
-}
-
-export declare interface ZarrArrayMeta {
-    zarr_format: number;
-    shape: number[];
-    chunks: number[];
-    dtype: string;
-    compressor: {
-        id: string;
-        level?: number;
-        clevel?: number;
-        cname?: string;
-        shuffle?: number;
-        blocksize?: number;
-    } | null;
-    fill_value: number | string | null;
-    order: string;
-    filters: unknown[] | null;
-    dimension_separator?: string;
-}
-
-declare interface ZarrAttrs {
-    _ARRAY_DIMENSIONS?: string[];
-    units?: string;
-    standard_name?: string;
-    long_name?: string;
-    calendar?: string;
-    [key: string]: unknown;
-}
-
-export declare interface ZarrConsolidatedMeta {
-    zarr_consolidated_format: number;
-    metadata: Record<string, ZarrArrayMeta | ZarrAttrs | {
-        zarr_format: number;
-    }>;
-}
-
-export declare class ZarrSource {
-    private root;
-    private meta;
-    private coords;
-    private verticalName;
-    private cache;
-    private maxCacheSize;
-    private abortControllers;
-    private bloscCodecCache;
-    constructor(root: string, maxCacheSize?: number);
-    init(): Promise<void>;
-    private getArrayMeta;
-    private getAttrs;
-    getDimensionSeparator(variable: string): string;
-    getShape(variable: string): number[];
-    getChunkShape(variable: string): number[];
-    getCoords(): CoordArrays;
-    getDimensions(variable: string): string[];
-    findNearestIndex(array: Float32Array | Float64Array, value: number): number;
-    findTimeIndex(time: string | number): number;
-    findDepthIndex(depth: number): number;
-    /** Return the actual name of the vertical dimension ("depth" or "elevation"). */
-    getVerticalDimName(): string;
-    /**
-     * Get chunk indices that intersect a geographic bounding box.
-     */
-    getChunksForBounds(variable: string, timeIdx: number, depthIdx: number, bounds: {
-        west: number;
-        south: number;
-        east: number;
-        north: number;
-    }): Array<{
-        timeIdx: number;
-        depthIdx: number;
-        latIdx: number;
-        lonIdx: number;
-        latRange: [number, number];
-        lonRange: [number, number];
-        latSize: number;
-        lonSize: number;
-    }>;
-    fetchChunk(variable: string, indices: number[]): Promise<Float32Array>;
-    cancelAll(): void;
-    private getBloscCodec;
-    private decompress;
-    private loadCoordinates;
-}
-
-export { }