@loaders.gl/scientific 0.0.0-stage → 5.0.0-alpha.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/README.md +21 -2
  2. package/dist/index.cjs +4313 -0
  3. package/dist/index.cjs.map +6 -0
  4. package/dist/index.d.ts +11 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +8 -0
  7. package/dist/index.js.map +1 -0
  8. package/dist/netcdf/bundled.cjs +1394 -0
  9. package/dist/netcdf/bundled.d.ts +2 -0
  10. package/dist/netcdf/bundled.d.ts.map +1 -0
  11. package/dist/netcdf/bundled.js +5 -0
  12. package/dist/netcdf/bundled.js.map +1 -0
  13. package/dist/netcdf/index.cjs +1394 -0
  14. package/dist/netcdf/index.cjs.map +6 -0
  15. package/dist/netcdf/index.d.ts +7 -0
  16. package/dist/netcdf/index.d.ts.map +1 -0
  17. package/dist/netcdf/index.js +8 -0
  18. package/dist/netcdf/index.js.map +1 -0
  19. package/dist/netcdf/iobuffer/iobuffer.d.ts +253 -0
  20. package/dist/netcdf/iobuffer/iobuffer.d.ts.map +1 -0
  21. package/dist/netcdf/iobuffer/iobuffer.js +450 -0
  22. package/dist/netcdf/iobuffer/iobuffer.js.map +1 -0
  23. package/dist/netcdf/netcdf-format.cjs +39 -0
  24. package/dist/netcdf/netcdf-format.d.ts +11 -0
  25. package/dist/netcdf/netcdf-format.d.ts.map +1 -0
  26. package/dist/netcdf/netcdf-format.js +14 -0
  27. package/dist/netcdf/netcdf-format.js.map +1 -0
  28. package/dist/netcdf/netcdf-loader-with-parser.cjs +995 -0
  29. package/dist/netcdf/netcdf-loader-with-parser.d.ts +60 -0
  30. package/dist/netcdf/netcdf-loader-with-parser.d.ts.map +1 -0
  31. package/dist/netcdf/netcdf-loader-with-parser.js +35 -0
  32. package/dist/netcdf/netcdf-loader-with-parser.js.map +1 -0
  33. package/dist/netcdf/netcdf-loader.cjs +84 -0
  34. package/dist/netcdf/netcdf-loader.d.ts +81 -0
  35. package/dist/netcdf/netcdf-loader.d.ts.map +1 -0
  36. package/dist/netcdf/netcdf-loader.js +41 -0
  37. package/dist/netcdf/netcdf-loader.js.map +1 -0
  38. package/dist/netcdf/netcdf-source-loader-types.cjs +78 -0
  39. package/dist/netcdf/netcdf-source-loader-types.d.ts +28 -0
  40. package/dist/netcdf/netcdf-source-loader-types.d.ts.map +1 -0
  41. package/dist/netcdf/netcdf-source-loader-types.js +32 -0
  42. package/dist/netcdf/netcdf-source-loader-types.js.map +1 -0
  43. package/dist/netcdf/netcdf-source-loader.cjs +1319 -0
  44. package/dist/netcdf/netcdf-source-loader.d.ts +59 -0
  45. package/dist/netcdf/netcdf-source-loader.d.ts.map +1 -0
  46. package/dist/netcdf/netcdf-source-loader.js +421 -0
  47. package/dist/netcdf/netcdf-source-loader.js.map +1 -0
  48. package/dist/netcdf/netcdfjs/netcdf-reader.d.ts +68 -0
  49. package/dist/netcdf/netcdfjs/netcdf-reader.d.ts.map +1 -0
  50. package/dist/netcdf/netcdfjs/netcdf-reader.js +172 -0
  51. package/dist/netcdf/netcdfjs/netcdf-reader.js.map +1 -0
  52. package/dist/netcdf/netcdfjs/netcdf-types.d.ts +70 -0
  53. package/dist/netcdf/netcdfjs/netcdf-types.d.ts.map +1 -0
  54. package/dist/netcdf/netcdfjs/netcdf-types.js +3 -0
  55. package/dist/netcdf/netcdfjs/netcdf-types.js.map +1 -0
  56. package/dist/netcdf/netcdfjs/read-data.d.ts +19 -0
  57. package/dist/netcdf/netcdfjs/read-data.d.ts.map +1 -0
  58. package/dist/netcdf/netcdfjs/read-data.js +51 -0
  59. package/dist/netcdf/netcdfjs/read-data.js.map +1 -0
  60. package/dist/netcdf/netcdfjs/read-header.d.ts +16 -0
  61. package/dist/netcdf/netcdfjs/read-header.d.ts.map +1 -0
  62. package/dist/netcdf/netcdfjs/read-header.js +227 -0
  63. package/dist/netcdf/netcdfjs/read-header.js.map +1 -0
  64. package/dist/netcdf/netcdfjs/read-type.d.ts +36 -0
  65. package/dist/netcdf/netcdfjs/read-type.d.ts.map +1 -0
  66. package/dist/netcdf/netcdfjs/read-type.js +135 -0
  67. package/dist/netcdf/netcdfjs/read-type.js.map +1 -0
  68. package/dist/netcdf/unbundled.cjs +1394 -0
  69. package/dist/netcdf/unbundled.d.ts +2 -0
  70. package/dist/netcdf/unbundled.d.ts.map +1 -0
  71. package/dist/netcdf/unbundled.js +5 -0
  72. package/dist/netcdf/unbundled.js.map +1 -0
  73. package/dist/netcdf.dev.js +3153 -0
  74. package/dist/netcdf.min.js +12 -0
  75. package/dist/zarr/bundled.d.ts +2 -0
  76. package/dist/zarr/bundled.d.ts.map +1 -0
  77. package/dist/zarr/bundled.js +5 -0
  78. package/dist/zarr/bundled.js.map +1 -0
  79. package/dist/zarr/geo-zarr-source-loader.d.ts +121 -0
  80. package/dist/zarr/geo-zarr-source-loader.d.ts.map +1 -0
  81. package/dist/zarr/geo-zarr-source-loader.js +692 -0
  82. package/dist/zarr/geo-zarr-source-loader.js.map +1 -0
  83. package/dist/zarr/index.cjs +14747 -0
  84. package/dist/zarr/index.cjs.map +6 -0
  85. package/dist/zarr/index.d.ts +11 -0
  86. package/dist/zarr/index.d.ts.map +1 -0
  87. package/dist/zarr/index.js +10 -0
  88. package/dist/zarr/index.js.map +1 -0
  89. package/dist/zarr/lib/consolidated-zarr.d.ts +31 -0
  90. package/dist/zarr/lib/consolidated-zarr.d.ts.map +1 -0
  91. package/dist/zarr/lib/consolidated-zarr.js +113 -0
  92. package/dist/zarr/lib/consolidated-zarr.js.map +1 -0
  93. package/dist/zarr/lib/load-zarr.d.ts +11 -0
  94. package/dist/zarr/lib/load-zarr.d.ts.map +1 -0
  95. package/dist/zarr/lib/load-zarr.js +22 -0
  96. package/dist/zarr/lib/load-zarr.js.map +1 -0
  97. package/dist/zarr/lib/spatial-multiscales.d.ts +14 -0
  98. package/dist/zarr/lib/spatial-multiscales.d.ts.map +1 -0
  99. package/dist/zarr/lib/spatial-multiscales.js +34 -0
  100. package/dist/zarr/lib/spatial-multiscales.js.map +1 -0
  101. package/dist/zarr/lib/utils.d.ts +28 -0
  102. package/dist/zarr/lib/utils.d.ts.map +1 -0
  103. package/dist/zarr/lib/utils.js +137 -0
  104. package/dist/zarr/lib/utils.js.map +1 -0
  105. package/dist/zarr/lib/zarr-data-cache.d.ts +13 -0
  106. package/dist/zarr/lib/zarr-data-cache.d.ts.map +1 -0
  107. package/dist/zarr/lib/zarr-data-cache.js +70 -0
  108. package/dist/zarr/lib/zarr-data-cache.js.map +1 -0
  109. package/dist/zarr/lib/zarr-pixel-source.d.ts +41 -0
  110. package/dist/zarr/lib/zarr-pixel-source.d.ts.map +1 -0
  111. package/dist/zarr/lib/zarr-pixel-source.js +97 -0
  112. package/dist/zarr/lib/zarr-pixel-source.js.map +1 -0
  113. package/dist/zarr/lib/zarrita-pixel-source.d.ts +40 -0
  114. package/dist/zarr/lib/zarrita-pixel-source.d.ts.map +1 -0
  115. package/dist/zarr/lib/zarrita-pixel-source.js +96 -0
  116. package/dist/zarr/lib/zarrita-pixel-source.js.map +1 -0
  117. package/dist/zarr/ome-zarr-source-loader.d.ts +195 -0
  118. package/dist/zarr/ome-zarr-source-loader.d.ts.map +1 -0
  119. package/dist/zarr/ome-zarr-source-loader.js +523 -0
  120. package/dist/zarr/ome-zarr-source-loader.js.map +1 -0
  121. package/dist/zarr/spatial-data-source.d.ts +95 -0
  122. package/dist/zarr/spatial-data-source.d.ts.map +1 -0
  123. package/dist/zarr/spatial-data-source.js +242 -0
  124. package/dist/zarr/spatial-data-source.js.map +1 -0
  125. package/dist/zarr/types.d.ts +105 -0
  126. package/dist/zarr/types.d.ts.map +1 -0
  127. package/dist/zarr/types.js +5 -0
  128. package/dist/zarr/types.js.map +1 -0
  129. package/dist/zarr/unbundled.d.ts +2 -0
  130. package/dist/zarr/unbundled.d.ts.map +1 -0
  131. package/dist/zarr/unbundled.js +5 -0
  132. package/dist/zarr/unbundled.js.map +1 -0
  133. package/dist/zarr/zarr-array-source.d.ts +102 -0
  134. package/dist/zarr/zarr-array-source.d.ts.map +1 -0
  135. package/dist/zarr/zarr-array-source.js +132 -0
  136. package/dist/zarr/zarr-array-source.js.map +1 -0
  137. package/dist/zarr/zarr-loader-types.d.ts +236 -0
  138. package/dist/zarr/zarr-loader-types.d.ts.map +1 -0
  139. package/dist/zarr/zarr-loader-types.js +128 -0
  140. package/dist/zarr/zarr-loader-types.js.map +1 -0
  141. package/dist/zarr.dev.js +16574 -0
  142. package/dist/zarr.min.js +79 -0
  143. package/package.json +62 -4
  144. package/src/index.ts +52 -0
  145. package/src/netcdf/bundled.ts +5 -0
  146. package/src/netcdf/index.ts +14 -0
  147. package/src/netcdf/iobuffer/iobuffer.ts +510 -0
  148. package/src/netcdf/netcdf-format.ts +16 -0
  149. package/src/netcdf/netcdf-loader-with-parser.ts +54 -0
  150. package/src/netcdf/netcdf-loader.ts +62 -0
  151. package/src/netcdf/netcdf-source-loader-types.ts +45 -0
  152. package/src/netcdf/netcdf-source-loader.ts +526 -0
  153. package/src/netcdf/netcdfjs/LICENSE +24 -0
  154. package/src/netcdf/netcdfjs/netcdf-reader.ts +196 -0
  155. package/src/netcdf/netcdfjs/netcdf-types.ts +75 -0
  156. package/src/netcdf/netcdfjs/read-data.ts +71 -0
  157. package/src/netcdf/netcdfjs/read-header.ts +277 -0
  158. package/src/netcdf/netcdfjs/read-type.ts +147 -0
  159. package/src/netcdf/unbundled.ts +5 -0
  160. package/src/zarr/bundled.ts +5 -0
  161. package/src/zarr/geo-zarr-source-loader.ts +998 -0
  162. package/src/zarr/index.ts +60 -0
  163. package/src/zarr/lib/consolidated-zarr.ts +190 -0
  164. package/src/zarr/lib/load-zarr.ts +31 -0
  165. package/src/zarr/lib/spatial-multiscales.ts +47 -0
  166. package/src/zarr/lib/utils.ts +162 -0
  167. package/src/zarr/lib/zarr-data-cache.ts +91 -0
  168. package/src/zarr/lib/zarr-pixel-source.ts +134 -0
  169. package/src/zarr/lib/zarrita-pixel-source.ts +141 -0
  170. package/src/zarr/ome-zarr-source-loader.ts +837 -0
  171. package/src/zarr/spatial-data-source.ts +370 -0
  172. package/src/zarr/types.ts +129 -0
  173. package/src/zarr/unbundled.ts +5 -0
  174. package/src/zarr/zarr-array-source.ts +225 -0
  175. package/src/zarr/zarr-loader-types.ts +166 -0
@@ -0,0 +1,225 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import * as zarrita from 'zarrita';
6
+ import type {Readable} from 'zarrita';
7
+ import type {CoreAPI, SourceLoader, TypedArray} from '@loaders.gl/core/loader-utils';
8
+ import {ZarrSource, type ZarrSourceLoaderOptions} from './ome-zarr-source-loader';
9
+ import {
10
+ cloneZarrSelection,
11
+ getCachedZarrSelection,
12
+ getZarrSelectionKey
13
+ } from './lib/zarr-data-cache';
14
+
15
+ /** Metadata describing one directly addressable Zarr array. */
16
+ export type ZarrArraySourceMetadata = {
17
+ /** Array path relative to the selected Zarr group. */
18
+ path: string;
19
+ /** Dimension lengths in storage order. */
20
+ shape: number[];
21
+ /** Native chunk lengths in storage order. */
22
+ chunks: number[];
23
+ /** Zarrita dtype identifier. */
24
+ dtype: string;
25
+ /** Zarr fill value used for uninitialized chunks. */
26
+ fillValue: unknown;
27
+ /** Array-level Zarr attributes. */
28
+ attributes: Record<string, unknown>;
29
+ /** Stable dimension names, supplied by the caller or generated from rank. */
30
+ dimensions: string[];
31
+ };
32
+
33
+ /** Parameters for reading a Zarr array selection. */
34
+ export type GetZarrArrayParameters = {
35
+ /** Integer or slice selector for each dimension; null retains that dimension. */
36
+ selection?: ZarrArraySelection;
37
+ /** Named selectors resolved against the metadata dimension labels. */
38
+ selectionByDimension?: Readonly<Record<string, number | null | ZarrArraySlice>>;
39
+ /** Abort signal forwarded to metadata and chunk requests. */
40
+ signal?: AbortSignal;
41
+ };
42
+
43
+ /** Slice selector accepted by {@link ZarrArraySource#getArray}. */
44
+ export type ZarrArraySlice = {
45
+ /** Inclusive starting index, defaulting to the dimension boundary. */
46
+ start?: number;
47
+ /** Exclusive stopping index, defaulting to the dimension boundary. */
48
+ stop?: number;
49
+ /** Stride between selected indices, defaulting to one. */
50
+ step?: number;
51
+ };
52
+
53
+ /** Positional selectors for a Zarr array read. */
54
+ export type ZarrArraySelection = Array<number | null | ZarrArraySlice>;
55
+
56
+ /** Result of a Zarr array read. */
57
+ export type ZarrArrayData = {
58
+ /** Decoded array values in row-major selection order. */
59
+ data: TypedArray;
60
+ /** Resulting shape after applying integer selections. */
61
+ shape: number[];
62
+ };
63
+
64
+ /** Options for {@link ZarrArraySourceLoader}. */
65
+ export type ZarrArraySourceLoaderOptions = ZarrSourceLoaderOptions & {
66
+ /** Array path and optional dimension labels. */
67
+ zarrArray?: {
68
+ /** Array path relative to `zarr.path`, defaulting to the selected root array. */
69
+ path?: string;
70
+ /** Dimension labels in storage order. */
71
+ dimensions?: string[];
72
+ };
73
+ };
74
+
75
+ /** Source loader for direct, non-geospatial Zarr array access. */
76
+ export const ZarrArraySourceLoaderWithParser = {
77
+ dataType: null as unknown as ZarrArraySource,
78
+ dataSource: null as unknown as ZarrArraySource,
79
+ batchType: null as never,
80
+ name: 'ZarrArraySourceLoader',
81
+ id: 'zarr-array',
82
+ module: 'scientific',
83
+ version: 'latest',
84
+ extensions: ['zarr'],
85
+ mimeTypes: [],
86
+ type: 'zarr-array',
87
+ fromUrl: true,
88
+ fromBlob: false,
89
+ options: {
90
+ zarr: {
91
+ metadataPath: 'auto',
92
+ path: null,
93
+ labels: undefined!,
94
+ requireConsolidatedMetadata: true
95
+ },
96
+ zarrArray: {path: undefined!, dimensions: undefined!}
97
+ } as ZarrArraySourceLoaderOptions,
98
+ defaultOptions: {
99
+ zarr: {
100
+ metadataPath: 'auto',
101
+ path: null,
102
+ labels: undefined!,
103
+ requireConsolidatedMetadata: true
104
+ },
105
+ zarrArray: {path: undefined!, dimensions: undefined!}
106
+ },
107
+ testURL: (url: string): boolean => /\.zarr(?:$|[/?#])/i.test(url),
108
+ createDataSource: (
109
+ data: string,
110
+ options: ZarrArraySourceLoaderOptions,
111
+ coreApi?: CoreAPI
112
+ ): ZarrArraySource => new ZarrArraySource(data, options, coreApi)
113
+ } as const satisfies SourceLoader<ZarrArraySource>;
114
+
115
+ /** Runtime source for direct access to a single Zarr array. */
116
+ export class ZarrArraySource extends ZarrSource {
117
+ /** Cached array initialization. */
118
+ private initializationPromise: Promise<{
119
+ array: zarrita.Array<zarrita.DataType, Readable>;
120
+ metadata: ZarrArraySourceMetadata;
121
+ }> | null = null;
122
+
123
+ /** Opens a Zarr array source. */
124
+ constructor(data: string, options: ZarrArraySourceLoaderOptions, coreApi?: CoreAPI) {
125
+ super(data, options, coreApi);
126
+ }
127
+
128
+ /** Returns array shape, chunks, dtype, and dimension labels. */
129
+ async getMetadata(signal?: AbortSignal): Promise<ZarrArraySourceMetadata> {
130
+ return (await this.getInitializationPromise(signal)).metadata;
131
+ }
132
+
133
+ /** Reads the selected array values. */
134
+ async getArray(parameters: GetZarrArrayParameters = {}): Promise<ZarrArrayData> {
135
+ const {array, metadata} = await this.getInitializationPromise(parameters.signal);
136
+ if (parameters.selection && parameters.selectionByDimension) {
137
+ throw new Error('Zarr array requests cannot combine positional and named selections.');
138
+ }
139
+ const selection =
140
+ parameters.selection || createNamedSelection(parameters.selectionByDimension, metadata);
141
+ if (selection.length !== metadata.shape.length) {
142
+ throw new Error(`Zarr array selection must have ${metadata.shape.length} dimensions.`);
143
+ }
144
+ const zarritaSelection = selection.map(selector =>
145
+ isZarrArraySlice(selector)
146
+ ? zarrita.slice(selector.start ?? null, selector.stop ?? null, selector.step ?? null)
147
+ : selector
148
+ );
149
+ const chunk = await getCachedZarrSelection(
150
+ array,
151
+ getZarrSelectionKey(selection),
152
+ () => zarrita.get(array, zarritaSelection) as Promise<{data: TypedArray; shape: number[]}>,
153
+ parameters.signal
154
+ );
155
+ if (!chunk || typeof chunk !== 'object' || !('data' in chunk) || !('shape' in chunk)) {
156
+ throw new Error('Failed to read Zarr array selection.');
157
+ }
158
+ return cloneZarrSelection(chunk);
159
+ }
160
+
161
+ /** Opens the configured array and resolves its normalized metadata. */
162
+ private async getInitializationPromise(signal?: AbortSignal) {
163
+ if (!this.initializationPromise) {
164
+ this.initializationPromise = this.initialize(signal);
165
+ }
166
+ const initializationPromise = this.initializationPromise;
167
+ try {
168
+ return await initializationPromise;
169
+ } catch (error) {
170
+ if (this.initializationPromise === initializationPromise) {
171
+ this.initializationPromise = null;
172
+ }
173
+ throw error;
174
+ }
175
+ }
176
+
177
+ /** Opens the array selected by the source options. */
178
+ private async initialize(signal?: AbortSignal) {
179
+ const group = await this.openGroup(signal);
180
+ const options = (this.options as ZarrArraySourceLoaderOptions).zarrArray;
181
+ const path = options?.path || '';
182
+ const location = path ? group.resolve(path) : group;
183
+ const array = await zarrita.open(location, {kind: 'array', signal});
184
+ const dimensions =
185
+ options?.dimensions ||
186
+ this.options.zarr?.labels ||
187
+ array.shape.map((_size, index) => `dim_${index}`);
188
+ if (dimensions.length !== array.shape.length) {
189
+ throw new Error(`Zarr array dimensions must have length ${array.shape.length}.`);
190
+ }
191
+ return {
192
+ array,
193
+ metadata: {
194
+ path,
195
+ shape: [...array.shape],
196
+ chunks: [...array.chunks],
197
+ dtype: String(array.dtype),
198
+ fillValue: array.fillValue,
199
+ attributes: {...array.attrs},
200
+ dimensions: [...dimensions]
201
+ }
202
+ };
203
+ }
204
+ }
205
+
206
+ /** Converts named dimension selectors into the positional form accepted by Zarrita. */
207
+ function createNamedSelection(
208
+ selectionByDimension: GetZarrArrayParameters['selectionByDimension'],
209
+ metadata: ZarrArraySourceMetadata
210
+ ): ZarrArraySelection {
211
+ const selection = metadata.shape.map(() => null) as ZarrArraySelection;
212
+ for (const [dimension, selector] of Object.entries(selectionByDimension || {})) {
213
+ const dimensionIndex = metadata.dimensions.indexOf(dimension);
214
+ if (dimensionIndex < 0) {
215
+ throw new Error(`Unknown Zarr array dimension ${dimension}.`);
216
+ }
217
+ selection[dimensionIndex] = selector;
218
+ }
219
+ return selection;
220
+ }
221
+
222
+ /** Tests whether a selector is a slice descriptor rather than an index. */
223
+ function isZarrArraySlice(selector: number | null | ZarrArraySlice): selector is ZarrArraySlice {
224
+ return typeof selector === 'object' && selector !== null;
225
+ }
@@ -0,0 +1,166 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
6
+ import type {GeoZarrRasterSource, GeoZarrSourceLoaderOptions} from './geo-zarr-source-loader';
7
+ import type {OMEZarrImageSource, ZarrSourceLoaderOptions} from './ome-zarr-source-loader';
8
+ import type {SpatialDataSource, SpatialDataSourceLoaderOptions} from './spatial-data-source';
9
+ import type {ZarrArraySource, ZarrArraySourceLoaderOptions} from './zarr-array-source';
10
+
11
+ // __VERSION__ is injected by babel-plugin-version-inline
12
+ // @ts-ignore TS2304: Cannot find name '__VERSION__'.
13
+ const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
14
+
15
+ /** Metadata-only OME-Zarr loader. */
16
+ export const OMEZarrSourceLoader = {
17
+ dataType: null as unknown as OMEZarrImageSource,
18
+ batchType: null as never,
19
+ name: 'OMEZarrSourceLoader',
20
+ id: 'omezarr',
21
+ module: 'scientific',
22
+ version: VERSION,
23
+ extensions: ['zarr'],
24
+ mimeTypes: [],
25
+ type: 'omezarr',
26
+ fromUrl: true,
27
+ fromBlob: false,
28
+ options: {
29
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
30
+ omezarr: {interleaved: false, defaultChannels: undefined!}
31
+ } as ZarrSourceLoaderOptions,
32
+ defaultOptions: {
33
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
34
+ omezarr: {interleaved: false, defaultChannels: undefined!}
35
+ },
36
+ testURL: (url: string): boolean => /\.zarr(?:$|[/?#])/i.test(url),
37
+ preload: async () =>
38
+ (await import('@loaders.gl/scientific/zarr/ome-zarr-source-loader'))
39
+ .OMEZarrSourceLoaderWithParser,
40
+ createDataSource(
41
+ _data: string,
42
+ _options: ZarrSourceLoaderOptions,
43
+ _coreApi?: CoreAPI
44
+ ): OMEZarrImageSource {
45
+ throw new Error(
46
+ 'OMEZarrSourceLoader requires async load() or an explicit @loaders.gl/scientific/zarr/ome-zarr-source-loader import'
47
+ );
48
+ }
49
+ } as const satisfies SourceLoader<OMEZarrImageSource>;
50
+
51
+ /** Metadata-only GeoZarr loader. */
52
+ export const GeoZarrSourceLoader = {
53
+ dataType: null as unknown as GeoZarrRasterSource,
54
+ batchType: null as never,
55
+ name: 'GeoZarrSourceLoader',
56
+ id: 'geozarr',
57
+ module: 'scientific',
58
+ version: VERSION,
59
+ extensions: ['zarr'],
60
+ mimeTypes: [],
61
+ type: 'geozarr',
62
+ fromUrl: true,
63
+ fromBlob: false,
64
+ options: {
65
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
66
+ geozarr: {
67
+ array: undefined!,
68
+ spatialDimensions: undefined!,
69
+ transform: undefined!,
70
+ coordinateReferenceSystem: undefined!,
71
+ defaultSelection: undefined!
72
+ }
73
+ } as GeoZarrSourceLoaderOptions,
74
+ defaultOptions: {
75
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
76
+ geozarr: {
77
+ array: undefined!,
78
+ spatialDimensions: undefined!,
79
+ transform: undefined!,
80
+ coordinateReferenceSystem: undefined!,
81
+ defaultSelection: undefined!
82
+ }
83
+ },
84
+ testURL: (url: string): boolean => /\.zarr(?:$|[/?#])/i.test(url),
85
+ preload: async () =>
86
+ (await import('@loaders.gl/scientific/zarr/geo-zarr-source-loader'))
87
+ .GeoZarrSourceLoaderWithParser,
88
+ createDataSource(
89
+ _data: string,
90
+ _options: GeoZarrSourceLoaderOptions,
91
+ _coreApi?: CoreAPI
92
+ ): GeoZarrRasterSource {
93
+ throw new Error(
94
+ 'GeoZarrSourceLoader requires async load() or an explicit @loaders.gl/scientific/zarr/geo-zarr-source-loader import'
95
+ );
96
+ }
97
+ } as const satisfies SourceLoader<GeoZarrRasterSource>;
98
+
99
+ /** Metadata-only direct Zarr array loader. */
100
+ export const ZarrArraySourceLoader = {
101
+ dataType: null as unknown as ZarrArraySource,
102
+ batchType: null as never,
103
+ name: 'ZarrArraySourceLoader',
104
+ id: 'zarr-array',
105
+ module: 'scientific',
106
+ version: VERSION,
107
+ extensions: ['zarr'],
108
+ mimeTypes: [],
109
+ type: 'zarr-array',
110
+ fromUrl: true,
111
+ fromBlob: false,
112
+ options: {
113
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
114
+ zarrArray: {path: undefined!, dimensions: undefined!}
115
+ } as ZarrArraySourceLoaderOptions,
116
+ defaultOptions: {
117
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true},
118
+ zarrArray: {path: undefined!, dimensions: undefined!}
119
+ },
120
+ testURL: (url: string): boolean => /\.zarr(?:$|[/?#])/i.test(url),
121
+ preload: async () =>
122
+ (await import('@loaders.gl/scientific/zarr/zarr-array-source')).ZarrArraySourceLoaderWithParser,
123
+ createDataSource(
124
+ _data: string,
125
+ _options: ZarrArraySourceLoaderOptions,
126
+ _coreApi?: CoreAPI
127
+ ): ZarrArraySource {
128
+ throw new Error(
129
+ 'ZarrArraySourceLoader requires async load() or an explicit @loaders.gl/scientific/zarr/zarr-array-source import'
130
+ );
131
+ }
132
+ } as const satisfies SourceLoader<ZarrArraySource>;
133
+
134
+ /** Metadata-only SpatialData loader. */
135
+ export const SpatialDataSourceLoader = {
136
+ dataType: null as unknown as SpatialDataSource,
137
+ batchType: null as never,
138
+ name: 'SpatialDataSourceLoader',
139
+ id: 'spatial-data',
140
+ module: 'scientific',
141
+ version: VERSION,
142
+ extensions: ['zarr'],
143
+ mimeTypes: [],
144
+ type: 'spatial-data',
145
+ fromUrl: true,
146
+ fromBlob: false,
147
+ options: {
148
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true}
149
+ } as SpatialDataSourceLoaderOptions,
150
+ defaultOptions: {
151
+ zarr: {metadataPath: 'auto', path: null, labels: undefined!, requireConsolidatedMetadata: true}
152
+ },
153
+ testURL: (url: string): boolean => /\.zarr(?:$|[/?#])/i.test(url),
154
+ preload: async () =>
155
+ (await import('@loaders.gl/scientific/zarr/spatial-data-source'))
156
+ .SpatialDataSourceLoaderWithParser,
157
+ createDataSource(
158
+ _data: string,
159
+ _options: SpatialDataSourceLoaderOptions,
160
+ _coreApi?: CoreAPI
161
+ ): SpatialDataSource {
162
+ throw new Error(
163
+ 'SpatialDataSourceLoader requires async load() or an explicit @loaders.gl/scientific/zarr/spatial-data-source import'
164
+ );
165
+ }
166
+ } as const satisfies SourceLoader<SpatialDataSource>;