@oceanum/layers 0.1.1

package/README.md

@@ -0,0 +1,206 @@
+# @oceanum/layers
+
+deck.gl layers for visualising gridded data from [Oceanum Datamesh](https://oceanum.io/datamesh-environmental-data-platform/) zarr datasets.
+
+This library wraps [@oceanum/deck-gl-grid](https://github.com/oceanum/deck-gl-grid) layers with automatic data fetching from pre-cached zarr archives on the Datamesh. It handles time/level dimension selection, viewport-based spatial chunk loading, and debounced fetching — all through a simple props-based API.
+
+## Installation
+
+```bash
+npm install @oceanum/layers
+```
+
+### Peer dependencies
+
+```bash
+npm install @deck.gl/core @deck.gl/layers @luma.gl/core
+```
+
+## Quick Start
+
+```jsx
+import { OceanumPcolorLayer } from '@oceanum/layers';
+import DeckGL from '@deck.gl/react';
+
+const SERVICE_URL = 'https://zarr.datamesh.oceanum.io';
+
+function App() {
+  const [time, setTime] = useState('2024-01-15T00:00:00Z');
+
+  const layers = [
+    new OceanumPcolorLayer({
+      id: 'wave-height',
+      serviceUrl: SERVICE_URL,
+      authHeaders: { Authorization: `Bearer ${token}` },
+      datasource: 'oceanum_wave_glob05',
+      variable: 'hs',
+      time,
+      colormap: {
+        scale: ['#313695', '#4575b4', '#74add1', '#abd9e9',
+                '#fee090', '#fdae61', '#f46d43', '#d73027'],
+        domain: [0, 1, 2, 3, 4, 5, 6, 8],
+      },
+      opacity: 0.8,
+    }),
+  ];
+
+  return <DeckGL layers={layers} />;
+}
+```
+
+## Layers
+
+### OceanumPcolorLayer
+
+Renders a scalar variable as coloured grid cells.
+
+```javascript
+new OceanumPcolorLayer({
+  id: 'sst',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'my_dataset',
+  variable: 'temperature',
+  time: '2024-01-15T00:00:00Z',
+  colormap: { scale: [...], domain: [...] },
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variable` | `string` | *required* | Scalar variable name in the zarr dataset |
+| `color` | `[r,g,b]` | `[200,200,200]` | Fallback colour when no colormap |
+| `material` | `boolean\|object` | `false` | Phong material for lighting |
+
+### OceanumParticleLayer
+
+Renders animated particles flowing through a vector field.
+
+```javascript
+new OceanumParticleLayer({
+  id: 'wind',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'era5_wind',
+  uVariable: 'u10',
+  vVariable: 'v10',
+  time: '2024-01-15T00:00:00Z',
+  npart: 5000,
+  speed: 2.0,
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `uVariable` | `string` | — | U (eastward) component variable |
+| `vVariable` | `string` | — | V (northward) component variable |
+| `magnitudeVariable` | `string` | — | Magnitude variable (alternative to u/v) |
+| `directionVariable` | `string` | — | Direction variable (alternative to u/v) |
+| `speed` | `number` | `1.0` | Animation speed multiplier |
+| `npart` | `number` | `1000` | Number of particles |
+| `size` | `number` | `3` | Particle size in pixels |
+| `length` | `number` | `12` | Particle trail length |
+| `directionConvention` | `string` | `'NAUTICAL_FROM'` | `'NAUTICAL_FROM'`, `'NAUTICAL_TO'`, or `'CARTESIAN_RADIANS'` |
+
+Provide either (`uVariable` + `vVariable`) **or** (`magnitudeVariable` + `directionVariable`).
+
+### OceanumPartmeshLayer
+
+Renders mesh-based arrows for a vector field. Same variable props as ParticleLayer.
+
+```javascript
+new OceanumPartmeshLayer({
+  id: 'currents',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'ocean_currents',
+  uVariable: 'uo',
+  vVariable: 'vo',
+  time: '2024-01-15T00:00:00Z',
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `uVariable` / `vVariable` | `string` | — | Vector component pair |
+| `magnitudeVariable` / `directionVariable` | `string` | — | Alternative vector pair |
+| `speed` | `number` | `1.0` | Animation speed multiplier |
+| `size` | `number` | `3` | Arrow size in pixels |
+| `directionConvention` | `string` | `'NAUTICAL_FROM'` | Direction convention |
+
+### OceanumContourLayer
+
+Renders contour lines with labels for a scalar variable.
+
+```javascript
+new OceanumContourLayer({
+  id: 'pressure',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'era5_surface',
+  variable: 'msl',
+  time: '2024-01-15T00:00:00Z',
+  levels: [990, 995, 1000, 1005, 1010, 1015, 1020, 1025],
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variable` | `string` | *required* | Scalar variable name |
+| `levels` | `number[]` | `[]` | Contour level values |
+| `labelSize` | `number` | `12` | Label font size |
+| `labelColor` | `[r,g,b,a]` | `[255,255,255,255]` | Label colour |
+| `smoothing` | `boolean` | `false` | Smooth contour lines |
+| `numLabels` | `number` | `1` | Labels per contour line |
+
+## Common Props
+
+All layers share these props:
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `serviceUrl` | `string` | *required* | Root URL of the zarr service |
+| `authHeaders` | `object` | `{}` | HTTP headers for authentication |
+| `datasource` | `string` | *required* | Dataset name (subpath of the service URL) |
+| `instance` | `string` | latest | Zarr group name. Defaults to the latest (last lexicographically) |
+| `time` | `string\|Date` | first | ISO 8601 string or `Date`. Resolved to nearest available time step |
+| `level` | `number` | `0` | 0-based index into the level dimension |
+| `colormap` | `object` | `null` | `{ scale: string[], domain: number[] }` |
+| `opacity` | `number` | `1.0` | Layer opacity (0-1) |
+| `altitude` | `number` | `0.0` | Altitude offset |
+| `globalWrap` | `boolean` | `false` | Wrap across the antimeridian |
+| `scale` | `number` | `1.0` | Value multiplier before colormapping |
+| `offset` | `number` | `0.0` | Value offset before colormapping |
+| `pickable` | `boolean` | `false` | Enable picking |
+| `visible` | `boolean` | `true` | Layer visibility |
+| `viewportPadding` | `number` | `0.1` | Spatial padding fraction beyond viewport edges |
+| `debounceWait` | `number` | `100` | Debounce delay (ms) for slice requests |
+| `onDataLoad` | `function` | — | Called when metadata loads. Receives `{ dataset, times, nlevels, instance }` |
+| `onError` | `object` | — | Error hooks object (see below) |
+
+## Zarr Dataset Structure
+
+The zarr archives are expected to have:
+
+- A `_coordinates` attribute in the root `.zattrs` mapping dimension roles:
+  ```json
+  { "x": "longitude", "y": "latitude", "t": "time", "z": "level" }
+  ```
+- Dimensions: `(time, [level], latitude, longitude)`
+- One or more instance groups at the root level (optional)
+
+## Error Hooks
+
+The `onError` prop accepts per-state callbacks:
+
+```javascript
+onError: {
+  onMetadataError:   (err) => { /* dataset open failed */ },
+  onChunkError:      (err) => { /* chunk fetch failed */ },
+  onVariableError:   (err) => { /* variable not found */ },
+  onValidationError: (err) => { /* invalid props */ },
+}
+```
+
+| Hook | When | Layer Behaviour |
+|------|------|-----------------|
+| `onMetadataError` | Dataset open fails | Renders nothing |
+| `onChunkError` | Chunk fetch fails | Keeps last valid slice |
+| `onVariableError` | Variable not found in dataset | Renders nothing |
+| `onValidationError` | Invalid prop combination | Renders nothing |

package/dist/README.md

@@ -0,0 +1,206 @@
+# @oceanum/layers
+
+deck.gl layers for visualising gridded data from [Oceanum Datamesh](https://oceanum.io/datamesh-environmental-data-platform/) zarr datasets.
+
+This library wraps [@oceanum/deck-gl-grid](https://github.com/oceanum/deck-gl-grid) layers with automatic data fetching from pre-cached zarr archives on the Datamesh. It handles time/level dimension selection, viewport-based spatial chunk loading, and debounced fetching — all through a simple props-based API.
+
+## Installation
+
+```bash
+npm install @oceanum/layers
+```
+
+### Peer dependencies
+
+```bash
+npm install @deck.gl/core @deck.gl/layers @luma.gl/core
+```
+
+## Quick Start
+
+```jsx
+import { OceanumPcolorLayer } from '@oceanum/layers';
+import DeckGL from '@deck.gl/react';
+
+const SERVICE_URL = 'https://zarr.datamesh.oceanum.io';
+
+function App() {
+  const [time, setTime] = useState('2024-01-15T00:00:00Z');
+
+  const layers = [
+    new OceanumPcolorLayer({
+      id: 'wave-height',
+      serviceUrl: SERVICE_URL,
+      authHeaders: { Authorization: `Bearer ${token}` },
+      datasource: 'oceanum_wave_glob05',
+      variable: 'hs',
+      time,
+      colormap: {
+        scale: ['#313695', '#4575b4', '#74add1', '#abd9e9',
+                '#fee090', '#fdae61', '#f46d43', '#d73027'],
+        domain: [0, 1, 2, 3, 4, 5, 6, 8],
+      },
+      opacity: 0.8,
+    }),
+  ];
+
+  return <DeckGL layers={layers} />;
+}
+```
+
+## Layers
+
+### OceanumPcolorLayer
+
+Renders a scalar variable as coloured grid cells.
+
+```javascript
+new OceanumPcolorLayer({
+  id: 'sst',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'my_dataset',
+  variable: 'temperature',
+  time: '2024-01-15T00:00:00Z',
+  colormap: { scale: [...], domain: [...] },
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variable` | `string` | *required* | Scalar variable name in the zarr dataset |
+| `color` | `[r,g,b]` | `[200,200,200]` | Fallback colour when no colormap |
+| `material` | `boolean\|object` | `false` | Phong material for lighting |
+
+### OceanumParticleLayer
+
+Renders animated particles flowing through a vector field.
+
+```javascript
+new OceanumParticleLayer({
+  id: 'wind',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'era5_wind',
+  uVariable: 'u10',
+  vVariable: 'v10',
+  time: '2024-01-15T00:00:00Z',
+  npart: 5000,
+  speed: 2.0,
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `uVariable` | `string` | — | U (eastward) component variable |
+| `vVariable` | `string` | — | V (northward) component variable |
+| `magnitudeVariable` | `string` | — | Magnitude variable (alternative to u/v) |
+| `directionVariable` | `string` | — | Direction variable (alternative to u/v) |
+| `speed` | `number` | `1.0` | Animation speed multiplier |
+| `npart` | `number` | `1000` | Number of particles |
+| `size` | `number` | `3` | Particle size in pixels |
+| `length` | `number` | `12` | Particle trail length |
+| `directionConvention` | `string` | `'NAUTICAL_FROM'` | `'NAUTICAL_FROM'`, `'NAUTICAL_TO'`, or `'CARTESIAN_RADIANS'` |
+
+Provide either (`uVariable` + `vVariable`) **or** (`magnitudeVariable` + `directionVariable`).
+
+### OceanumPartmeshLayer
+
+Renders mesh-based arrows for a vector field. Same variable props as ParticleLayer.
+
+```javascript
+new OceanumPartmeshLayer({
+  id: 'currents',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'ocean_currents',
+  uVariable: 'uo',
+  vVariable: 'vo',
+  time: '2024-01-15T00:00:00Z',
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `uVariable` / `vVariable` | `string` | — | Vector component pair |
+| `magnitudeVariable` / `directionVariable` | `string` | — | Alternative vector pair |
+| `speed` | `number` | `1.0` | Animation speed multiplier |
+| `size` | `number` | `3` | Arrow size in pixels |
+| `directionConvention` | `string` | `'NAUTICAL_FROM'` | Direction convention |
+
+### OceanumContourLayer
+
+Renders contour lines with labels for a scalar variable.
+
+```javascript
+new OceanumContourLayer({
+  id: 'pressure',
+  serviceUrl: 'https://zarr.datamesh.oceanum.io',
+  datasource: 'era5_surface',
+  variable: 'msl',
+  time: '2024-01-15T00:00:00Z',
+  levels: [990, 995, 1000, 1005, 1010, 1015, 1020, 1025],
+});
+```
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `variable` | `string` | *required* | Scalar variable name |
+| `levels` | `number[]` | `[]` | Contour level values |
+| `labelSize` | `number` | `12` | Label font size |
+| `labelColor` | `[r,g,b,a]` | `[255,255,255,255]` | Label colour |
+| `smoothing` | `boolean` | `false` | Smooth contour lines |
+| `numLabels` | `number` | `1` | Labels per contour line |
+
+## Common Props
+
+All layers share these props:
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `serviceUrl` | `string` | *required* | Root URL of the zarr service |
+| `authHeaders` | `object` | `{}` | HTTP headers for authentication |
+| `datasource` | `string` | *required* | Dataset name (subpath of the service URL) |
+| `instance` | `string` | latest | Zarr group name. Defaults to the latest (last lexicographically) |
+| `time` | `string\|Date` | first | ISO 8601 string or `Date`. Resolved to nearest available time step |
+| `level` | `number` | `0` | 0-based index into the level dimension |
+| `colormap` | `object` | `null` | `{ scale: string[], domain: number[] }` |
+| `opacity` | `number` | `1.0` | Layer opacity (0-1) |
+| `altitude` | `number` | `0.0` | Altitude offset |
+| `globalWrap` | `boolean` | `false` | Wrap across the antimeridian |
+| `scale` | `number` | `1.0` | Value multiplier before colormapping |
+| `offset` | `number` | `0.0` | Value offset before colormapping |
+| `pickable` | `boolean` | `false` | Enable picking |
+| `visible` | `boolean` | `true` | Layer visibility |
+| `viewportPadding` | `number` | `0.1` | Spatial padding fraction beyond viewport edges |
+| `debounceWait` | `number` | `100` | Debounce delay (ms) for slice requests |
+| `onDataLoad` | `function` | — | Called when metadata loads. Receives `{ dataset, times, nlevels, instance }` |
+| `onError` | `object` | — | Error hooks object (see below) |
+
+## Zarr Dataset Structure
+
+The zarr archives are expected to have:
+
+- A `_coordinates` attribute in the root `.zattrs` mapping dimension roles:
+  ```json
+  { "x": "longitude", "y": "latitude", "t": "time", "z": "level" }
+  ```
+- Dimensions: `(time, [level], latitude, longitude)`
+- One or more instance groups at the root level (optional)
+
+## Error Hooks
+
+The `onError` prop accepts per-state callbacks:
+
+```javascript
+onError: {
+  onMetadataError:   (err) => { /* dataset open failed */ },
+  onChunkError:      (err) => { /* chunk fetch failed */ },
+  onVariableError:   (err) => { /* variable not found */ },
+  onValidationError: (err) => { /* invalid props */ },
+}
+```
+
+| Hook | When | Layer Behaviour |
+|------|------|-----------------|
+| `onMetadataError` | Dataset open fails | Renders nothing |
+| `onChunkError` | Chunk fetch fails | Keeps last valid slice |
+| `onVariableError` | Variable not found in dataset | Renders nothing |
+| `onValidationError` | Invalid prop combination | Renders nothing |

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("@oceanum/deck-gl-grid"),R=require("@deck.gl/core"),B=require("@oceanum/datamesh");function E(a,e){const n={x:a.x,y:a.y};return e.xvector&&e.yvector?(n.u=e.xvector,n.v=e.yvector):n.c=e.magnitude,n}function q(a,e){const n={x:a.x,y:a.y};return e.xvector&&e.yvector?(n.u=e.xvector,n.v=e.yvector):(n.m=e.magnitude,n.d=e.direction),n}function $(a){const e=[];return a.magnitude&&e.push(a.magnitude),a.xvector&&e.push(a.xvector),a.yvector&&e.push(a.yvector),a.direction&&e.push(a.direction),e}function C(a,e){if(!a||a.length===0)return 0;const n=e instanceof Date?e.getTime()/1e3:new Date(e).getTime()/1e3;let t=0,l=a.length-1;for(;t<l;){const o=t+l>>1;a[o]<n?t=o+1:l=o}return t>0&&Math.abs(a[t-1]-n)<Math.abs(a[t]-n)?t-1:t}function M(a,e){return e<=0?0:Math.max(0,Math.min(a,e-1))}function S(a,e,n){if(!a||a.length===0)return[0,0];const t=a.length<2||a[1]>=a[0];let l=0,o=a.length-1;if(t){let r=0,s=a.length-1;for(;r<s;){const i=r+s>>1;a[i]<e?r=i+1:s=i}for(l=Math.max(0,r-1),r=l,s=a.length-1;r<s;){const i=r+s+1>>1;a[i]>n?s=i-1:r=i}o=Math.min(a.length-1,r+1)}else{let r=0,s=a.length-1;for(;r<s;){const i=r+s>>1;a[i]>n?r=i+1:s=i}for(l=Math.max(0,r-1),r=l,s=a.length-1;r<s;){const i=r+s+1>>1;a[i]<e?s=i-1:r=i}o=Math.min(a.length-1,r+1)}return[l,o]}function P(a,e){return{start:a,stop:e,step:null}}async function T(a,e,n,t,l,o,r){const s={},i={},c=a.variables[e.x],y=a.variables[e.y],[h,m]=await Promise.all([c.get([P(r[0],r[1]+1)]),y.get([P(o[0],o[1]+1)])]);s[e.x]={data:h},s[e.y]={data:m};const v=n.map(async b=>{const p=a.variables[b];if(!p)return;const x=p.dimensions.map(f=>e.t&&f===e.t?t:e.z&&f===e.z?l:f===e.y?P(o[0],o[1]+1):f===e.x?P(r[0],r[1]+1):null),D=await p.get(x);i[b]={data:D}});return await Promise.all(v),{coords:s,data_vars:i}}function V(a,e=.1){const n=a.getBounds(),t=n[0][0],l=n[0][1],o=n[1][0],r=n[1][1],s=o-t,i=r-l,c=s*e,y=i*e;return{west:t-c,south:Math.max(-90,l-y),east:o+c,north:Math.min(90,r+y)}}function j(a,e){return e?a.west>=e.west&&a.south>=e.south&&a.east<=e.east&&a.north<=e.north:!1}function W(a,e){let n=null;const t=((...l)=>{n&&clearTimeout(n),n=setTimeout(()=>{n=null,a(...l)},e)});return t.cancel=()=>{n&&(clearTimeout(n),n=null)},t}const A={onMetadataError:a=>console.warn(`[OceanumLayer] ${a.message}`),onChunkError:a=>console.warn(`[OceanumLayer] ${a.message}`),onVariableError:a=>console.warn(`[OceanumLayer] ${a.message}`),onValidationError:a=>console.error(`[OceanumLayer] ${a.message}`)},U={serviceUrl:{type:"string",value:"https://layers.app.oceanum.io"},authHeaders:{type:"object",value:{}},layerId:{type:"string",value:null},instance:{type:"string",value:null},time:{type:"string",value:null},level:{type:"number",value:0},colormap:{type:"object",value:null},opacity:{type:"number",value:1},altitude:{type:"number",value:0},globalWrap:{type:"boolean",value:!1},scale:{type:"number",value:1},offset:{type:"number",value:0},pickable:{type:"boolean",value:!1},visible:{type:"boolean",value:!0},viewportPadding:{type:"number",value:.1},debounceWait:{type:"number",value:100},onDataLoad:{type:"function",value:null},errorHandlers:{type:"object",value:null},xvector:{type:"string",value:null},yvector:{type:"string",value:null},magnitude:{type:"string",value:null},direction:{type:"string",value:null},directionConvention:{type:"string",value:"NAUTICAL_FROM"}};function g(a){return a.props}function w(a){return a.state}function _(a){return a.context}class d extends R.CompositeLayer{static layerName="OceanumBaseLayer";static defaultProps=U;initializeState(){this.setState({dataset:null,loading:!1,slicing:!1,error:null,instance:null,coordNames:null,times:null,nlevels:0,lats:null,lons:null,timeIndex:0,levelIndex:0,latRange:[0,0],lonRange:[0,0],fetchedBbox:null,slicedData:null,datakeys:null,debouncedSlice:W(()=>this._requestSlice(),g(this).debounceWait)}),this._openDataset()}shouldUpdateState({changeFlags:e}){return e.somethingChanged}updateState({props:e,oldProps:n,changeFlags:t}){const l=e,o=n,r=w(this);if(l.debounceWait!==o.debounceWait&&(r.debouncedSlice&&r.debouncedSlice.cancel(),this.setState({debouncedSlice:W(()=>this._requestSlice(),l.debounceWait)})),l.layerId!==o.layerId||l.instance!==o.instance||l.serviceUrl!==o.serviceUrl||this._variablePropsChanged(l,o)){this._openDataset();return}if(!r.dataset)return;let s=!1;if(l.time!==o.time&&r.times){const i=l.time?C(r.times,l.time):0;i!==r.timeIndex&&(this.setState({timeIndex:i}),s=!0)}if(l.level!==o.level){const i=M(l.level||0,r.nlevels);i!==r.levelIndex&&(this.setState({levelIndex:i}),s=!0)}if(s){this._requestSlice();return}if(t.viewportChanged&&_(this).viewport){const i=V(_(this).viewport,l.viewportPadding);if(!j(i,r.fetchedBbox)){const c=S(r.lons,i.west,i.east),y=S(r.lats,i.south,i.north);this.setState({latRange:y,lonRange:c,fetchedBbox:i}),r.debouncedSlice&&r.debouncedSlice()}}}finalizeState(){const e=w(this);e.debouncedSlice&&e.debouncedSlice.cancel()}_variablePropsChanged(e,n){return e.magnitude!==n.magnitude||e.direction!==n.direction||e.xvector!==n.xvector||e.yvector!==n.yvector||e.directionConvention!==n.directionConvention}_validateVariableProps(e){return null}_buildDatakeys(e){return{x:e.x,y:e.y}}_createInnerLayer(e,n){return null}_fireError(e,n){const t={type:e,...n};this.setState({error:t});const l=g(this).errorHandlers||{},o=`on${e.charAt(0).toUpperCase()+e.slice(1)}Error`,r=l[o]||A[o];r&&r(t)}async _openDataset(){const e=g(this),{serviceUrl:n,layerId:t,authHeaders:l}=e;if(!n||!t)return;const o=this._validateVariableProps(e);if(o){this._fireError("validation",{message:o});return}this.setState({loading:!0,error:null});try{let r=`${n}/zarr/${t}`,s=e.instance;if(!s){const u=await this._discoverInstances(r,l||{});u.length>0&&(u.sort(),s=u[u.length-1])}s&&(r=`${r}/${s}`);const i=await B.Dataset.zarr(r,l||{}),c=i.coordkeys;if(!c||!c.x||!c.y)throw new Error("Dataset is missing required coordinate mappings (x, y) in _coordinates");const y=$(e);for(const u of y)if(!i.variables[u]){const L=Object.keys(i.variables);this._fireError("variable",{layerId:t,variable:u,availableVariables:L,message:`Variable "${u}" not found in dataset. Available: ${L.join(", ")}`}),this.setState({loading:!1});return}const[h,m,v]=await Promise.all([i.variables[c.x]?.get(),i.variables[c.y]?.get(),c.t&&i.variables[c.t]?i.variables[c.t].get():null]),b=c.z&&i.dimensions[c.z]?i.dimensions[c.z]:0,p=e.time&&v?C(v,e.time):0,O=M(e.level||0,b),x={x:c.x,y:c.y,t:c.t,z:c.z},D=this._buildDatakeys(x);let f=[0,m?m.length-1:0],I=[0,h?h.length-1:0],z=null;if(_(this).viewport){const u=V(_(this).viewport,e.viewportPadding);h&&(I=S(h,u.west,u.east)),m&&(f=S(m,u.south,u.north)),z=u}if(this.setState({dataset:i,loading:!1,instance:s,coordNames:x,times:v,nlevels:b,lats:m,lons:h,timeIndex:p,levelIndex:O,latRange:f,lonRange:I,fetchedBbox:z,datakeys:D}),e.onDataLoad){const u=v?Array.from(v,L=>new Date(L*1e3)):[];e.onDataLoad({dataset:i,times:u,nlevels:b,instance:s})}this._requestSlice()}catch(r){this._fireError("metadata",{layerId:t,message:`Failed to open dataset: ${r.message}`,cause:r}),this.setState({loading:!1})}}async _discoverInstances(e,n){try{const t=await fetch(`${e}/.zmetadata`,{headers:n});if(!t.ok)return[];const l=await t.json();if(!l.metadata)return[];const o=new Set;for(const r of Object.keys(l.metadata)){const s=r.split("/");s.length===2&&s[1]===".zgroup"&&o.add(s[0])}return Array.from(o)}catch{return[]}}async _requestSlice(){const e=w(this),{dataset:n,coordNames:t,timeIndex:l,levelIndex:o,latRange:r,lonRange:s}=e;if(!n||!t)return;const i=$(g(this));if(i.length!==0){this.setState({slicing:!0});try{const c=await T(n,t,i,l,o,r,s);this.setState({slicedData:c,slicing:!1,error:null})}catch(c){this._fireError("chunk",{layerId:g(this).layerId,time:e.times?new Date(e.times[l]*1e3):null,level:o,message:`Chunk fetch failed: ${c.message}`,cause:c}),this.setState({slicing:!1})}}}renderLayers(){const e=w(this);return!e.slicedData||!e.datakeys?[]:this._createInnerLayer(e.slicedData,e.datakeys)}}const H={...d.defaultProps,color:{type:"array",value:[200,200,200]},material:!1};class X extends d{static layerName="OceanumPcolorLayer";static defaultProps=H;_validateVariableProps(e){const n=!!e.magnitude,t=e.xvector&&e.yvector;return!n&&!t?'OceanumPcolorLayer requires "magnitude" or "xvector" + "yvector"':null}_buildDatakeys(e){return E(e,this.props)}_createInnerLayer(e,n){const t=this.props;return new k.PcolorLayer({id:`${t.id}-inner`,data:e,datakeys:n,opacity:t.opacity,altitude:t.altitude,globalWrap:t.globalWrap,colormap:t.colormap,scale:t.scale,offset:t.offset,color:t.color,material:t.material,pickable:t.pickable,visible:t.visible})}}const Y={...d.defaultProps,speed:{type:"number",value:1},npart:{type:"number",value:1e3},size:{type:"number",value:3},length:{type:"number",value:12},color:{type:"array",value:[200,200,200]}};class F extends d{static layerName="OceanumParticleLayer";static defaultProps=Y;_validateVariableProps(e){const n=e.xvector&&e.yvector,t=e.magnitude&&e.direction;return!n&&!t?'OceanumParticleLayer requires "xvector" + "yvector" or "magnitude" + "direction"':n&&t?'OceanumParticleLayer: provide "xvector" + "yvector" or "magnitude" + "direction", not both':null}_buildDatakeys(e){return q(e,this.props)}_createInnerLayer(e,n){const t=this.props;return new k.ParticleLayer({id:`${t.id}-inner`,data:e,datakeys:n,opacity:t.opacity,altitude:t.altitude,globalWrap:t.globalWrap,colormap:t.colormap,scale:t.scale,offset:t.offset,color:t.color,direction:t.directionConvention,speed:t.speed,npart:t.npart,size:t.size,length:t.length,pickable:t.pickable,visible:t.visible})}}const N={...d.defaultProps,speed:{type:"number",value:1},size:{type:"number",value:3},color:{type:"array",value:[200,200,200]},meshShape:{type:"string",value:"cone"},meshLength:{type:"number",value:4},meshWidth:{type:"number",value:1},meshSize:{type:"number",value:1}};class G extends d{static layerName="OceanumPartmeshLayer";static defaultProps=N;_validateVariableProps(e){const n=e.xvector&&e.yvector,t=e.magnitude&&e.direction;return!n&&!t?'OceanumPartmeshLayer requires "xvector" + "yvector" or "magnitude" + "direction"':n&&t?'OceanumPartmeshLayer: provide "xvector" + "yvector" or "magnitude" + "direction", not both':null}_buildDatakeys(e){return q(e,this.props)}_createInnerLayer(e,n){const t=this.props;return new k.PartmeshLayer({id:`${t.id}-inner`,data:e,datakeys:n,opacity:t.opacity,altitude:t.altitude,globalWrap:t.globalWrap,colormap:t.colormap,scale:t.scale,offset:t.offset,color:t.color,direction:t.directionConvention,speed:t.speed,size:t.size,mesh:{shape:t.meshShape,length:t.meshLength,width:t.meshWidth,size:t.meshSize},pickable:t.pickable,visible:t.visible})}}const J={...d.defaultProps,levels:{type:"array",value:[]},labelSize:{type:"number",value:12},labelColor:{type:"array",value:[255,255,255,255]},smoothing:{type:"boolean",value:!1},numLabels:{type:"number",value:1},color:{type:"array",value:[200,200,200]}};class K extends d{static layerName="OceanumContourLayer";static defaultProps=J;_validateVariableProps(e){const n=!!e.magnitude,t=e.xvector&&e.yvector;return!n&&!t?'OceanumContourLayer requires "magnitude" or "xvector" + "yvector"':null}_buildDatakeys(e){return E(e,this.props)}_createInnerLayer(e,n){const t=this.props;return new k.ContourLayer({id:`${t.id}-inner`,data:e,datakeys:n,opacity:t.opacity,altitude:t.altitude,globalWrap:t.globalWrap,colormap:t.colormap,scale:t.scale,offset:t.offset,color:t.color,levels:t.levels,labelSize:t.labelSize,labelColor:t.labelColor,smoothing:t.smoothing,numLabels:t.numLabels,pickable:t.pickable,visible:t.visible})}}exports.OceanumBaseLayer=d;exports.OceanumContourLayer=K;exports.OceanumParticleLayer=F;exports.OceanumPartmeshLayer=G;exports.OceanumPcolorLayer=X;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { default as OceanumPcolorLayer } from './oceanum-pcolor-layer';
+export { default as OceanumParticleLayer } from './oceanum-particle-layer';
+export { default as OceanumPartmeshLayer } from './oceanum-partmesh-layer';
+export { default as OceanumContourLayer } from './oceanum-contour-layer';
+export { default as OceanumBaseLayer } from './oceanum-base-layer';
+export type { Colormap, LayerError, ErrorHandlers, OnDataLoadInfo, OceanumLayerProps, } from './oceanum-base-layer';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnE,YAAY,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}