@fideus-labs/fidnii 0.3.0 → 0.4.0

package/dist/fromTiff.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Load TIFF files (OME-TIFF, pyramidal, plain) and produce a
+ * {@link Multiscales} object ready for {@link OMEZarrNVImage.create}.
+ *
+ * Uses {@link https://github.com/fideus-labs/fiff | @fideus-labs/fiff}
+ * to present TIFFs as zarrita-compatible stores, then delegates to
+ * {@link fromNgffZarr} for OME-Zarr metadata parsing.
+ */
+import type { TiffStoreOptions } from "@fideus-labs/fiff";
+import { TiffStore } from "@fideus-labs/fiff";
+import type { Multiscales } from "@fideus-labs/ngff-zarr";
+import type { FromNgffZarrOptions } from "@fideus-labs/ngff-zarr/browser";
+/** Options for {@link fromTiff}. */
+export interface FromTiffOptions {
+    /** Options forwarded to {@link TiffStore} (e.g. IFD offsets, HTTP headers). */
+    tiff?: TiffStoreOptions;
+    /** Options forwarded to {@link fromNgffZarr} (e.g. validate, cache). */
+    ngffZarr?: Omit<FromNgffZarrOptions, "version">;
+}
+/**
+ * Load a TIFF file and return a {@link Multiscales} object ready for
+ * {@link OMEZarrNVImage.create}.
+ *
+ * Supports OME-TIFF, pyramidal TIFF (SubIFDs / legacy / COG), and
+ * plain single-image TIFFs. Both local (Blob/ArrayBuffer) and
+ * remote (URL with HTTP range requests) sources are supported.
+ *
+ * @param source - A URL string, Blob/File, ArrayBuffer, or
+ *   pre-built {@link TiffStore}.
+ * @param options - Optional {@link FromTiffOptions}.
+ * @returns A {@link Multiscales} object for use with
+ *   {@link OMEZarrNVImage.create}.
+ * @throws If the source cannot be opened as a TIFF or if the
+ *   synthesized OME-Zarr metadata is invalid.
+ *
+ * @example
+ * ```typescript
+ * // From a remote URL
+ * const ms = await fromTiff("https://example.com/image.ome.tif")
+ * const image = await OMEZarrNVImage.create({
+ *   multiscales: ms,
+ *   niivue: nv,
+ * })
+ *
+ * // From a File input
+ * const file = inputElement.files[0]
+ * const ms = await fromTiff(file)
+ * ```
+ */
+export declare function fromTiff(source: string | Blob | ArrayBuffer | TiffStore, options?: FromTiffOptions): Promise<Multiscales>;
+//# sourceMappingURL=fromTiff.d.ts.map

package/dist/fromTiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromTiff.d.ts","sourceRoot":"","sources":["../src/fromTiff.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AAIzE,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAA;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,SAAS,EAC/C,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC,CA2BtB"}

package/dist/fromTiff.js

@@ -0,0 +1,64 @@
+// SPDX-FileCopyrightText: Copyright (c) Fideus Labs LLC
+// SPDX-License-Identifier: MIT
+import { TiffStore } from "@fideus-labs/fiff";
+import { fromNgffZarr } from "@fideus-labs/ngff-zarr/browser";
+/**
+ * Load a TIFF file and return a {@link Multiscales} object ready for
+ * {@link OMEZarrNVImage.create}.
+ *
+ * Supports OME-TIFF, pyramidal TIFF (SubIFDs / legacy / COG), and
+ * plain single-image TIFFs. Both local (Blob/ArrayBuffer) and
+ * remote (URL with HTTP range requests) sources are supported.
+ *
+ * @param source - A URL string, Blob/File, ArrayBuffer, or
+ *   pre-built {@link TiffStore}.
+ * @param options - Optional {@link FromTiffOptions}.
+ * @returns A {@link Multiscales} object for use with
+ *   {@link OMEZarrNVImage.create}.
+ * @throws If the source cannot be opened as a TIFF or if the
+ *   synthesized OME-Zarr metadata is invalid.
+ *
+ * @example
+ * ```typescript
+ * // From a remote URL
+ * const ms = await fromTiff("https://example.com/image.ome.tif")
+ * const image = await OMEZarrNVImage.create({
+ *   multiscales: ms,
+ *   niivue: nv,
+ * })
+ *
+ * // From a File input
+ * const file = inputElement.files[0]
+ * const ms = await fromTiff(file)
+ * ```
+ */
+export async function fromTiff(source, options = {}) {
+    let store;
+    if (source instanceof TiffStore) {
+        store = source;
+    }
+    else if (typeof source === "string") {
+        store = await TiffStore.fromUrl(source, options.tiff);
+    }
+    else if (source instanceof Blob) {
+        store = await TiffStore.fromBlob(source, options.tiff);
+    }
+    else if (source instanceof ArrayBuffer) {
+        store = await TiffStore.fromArrayBuffer(source, options.tiff);
+    }
+    else {
+        throw new Error("[fidnii] fromTiff: source must be a URL string, Blob, " +
+            "ArrayBuffer, or TiffStore");
+    }
+    // TiffStore implements zarrita's Readable interface structurally
+    // (its get() method accepts string keys including the leading "/"
+    // that zarrita uses for AbsolutePath). Since fromNgffZarr (v0.10+)
+    // accepts zarr.Readable directly, we only need a type assertion.
+    //
+    // TiffStore always produces OME-Zarr v0.5 metadata.
+    return fromNgffZarr(store, {
+        version: "0.5",
+        ...options.ngffZarr,
+    });
+}
+//# sourceMappingURL=fromTiff.js.map

package/dist/fromTiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromTiff.js","sourceRoot":"","sources":["../src/fromTiff.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,+BAA+B;AAY/B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAW7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAA+C,EAC/C,UAA2B,EAAE;IAE7B,IAAI,KAAgB,CAAA;IACpB,IAAI,MAAM,YAAY,SAAS,EAAE,CAAC;QAChC,KAAK,GAAG,MAAM,CAAA;IAChB,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,CAAC;SAAM,IAAI,MAAM,YAAY,IAAI,EAAE,CAAC;QAClC,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,CAAC;SAAM,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;QACzC,KAAK,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,2BAA2B,CAC9B,CAAA;IACH,CAAC;IAED,iEAAiE;IACjE,kEAAkE;IAClE,mEAAmE;IACnE,iEAAiE;IACjE,EAAE;IACF,oDAAoD;IACpD,OAAO,YAAY,CAAC,KAA4B,EAAE;QAChD,OAAO,EAAE,KAAK;QACd,GAAG,OAAO,CAAC,QAAQ;KACpB,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -30,12 +30,16 @@
  * // await image.populateVolume();
  * ```
  */
+export type { TiffStoreOptions } from "@fideus-labs/fiff";
+export { TiffStore } from "@fideus-labs/fiff";
 export { Methods } from "@fideus-labs/ngff-zarr";
 export { terminateOmeroWorkerPool, terminateWorkerPool, } from "@fideus-labs/ngff-zarr/browser";
 export { BufferManager } from "./BufferManager.js";
 export { alignToChunks, azimuthElevationToNormal, calculateNiivueDepth, clipPlanesToBoundingBox, clipPlanesToNiivue, clipPlanesToPixelRegion, clipPlaneToNiivue, createAxisAlignedClipPlane, createClipPlane, createDefaultClipPlanes, getVolumeBoundsFromMultiscales, isInsideClipPlanes, MAX_CLIP_PLANES, normalizeVector, normalToAzimuthElevation, pointToPlaneDistance, validateClipPlanes, } from "./ClipPlanes.js";
 export type { OMEZarrNVImageEventListener, OMEZarrNVImageEventListenerOptions, OMEZarrNVImageEventMap, PopulateTrigger, } from "./events.js";
 export { OMEZarrNVImageEvent } from "./events.js";
+export type { FromTiffOptions } from "./fromTiff.js";
+export { fromTiff } from "./fromTiff.js";
 export type { ChannelWindow } from "./normalize.js";
 export { computeChannelMinMax, normalizeToUint8 } from "./normalize.js";
 export { OMEZarrNVImage } from "./OMEZarrNVImage.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,2BAA2B,EAC3B,kCAAkC,EAClC,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,GACV,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -1,37 +1,6 @@
 // SPDX-FileCopyrightText: Copyright (c) Fideus Labs LLC
 // SPDX-License-Identifier: MIT
-/**
- * @fideus-labs/fidnii
- *
- * Render OME-Zarr images in NiiVue with progressive multi-resolution loading.
- *
- * @example
- * ```typescript
- * import { Niivue } from '@niivue/niivue';
- * import { fromNgffZarr } from '@fideus-labs/ngff-zarr';
- * import { OMEZarrNVImage } from '@fideus-labs/fidnii';
- *
- * const nv = new Niivue();
- * await nv.attachToCanvas(document.getElementById('canvas'));
- *
- * const multiscales = await fromNgffZarr('/path/to/data.ome.zarr');
- *
- * // Image is automatically added to NiiVue and loads progressively
- * const image = await OMEZarrNVImage.create({ multiscales, niivue: nv });
- *
- * // Listen for loading complete if needed
- * image.addEventListener('populateComplete', () => console.log('Loaded!'));
- *
- * // For manual control, use autoLoad: false
- * // const image = await OMEZarrNVImage.create({
- * //   multiscales,
- * //   niivue: nv,
- * //   autoLoad: false,
- * // });
- * // nv.addVolume(image);
- * // await image.populateVolume();
- * ```
- */
+export { TiffStore } from "@fideus-labs/fiff";
 // Re-export Methods enum so consumers can check isLabelImage or compare method values
 export { Methods } from "@fideus-labs/ngff-zarr";
 // Worker pool lifecycle (re-exported from ngff-zarr)
@@ -42,6 +11,8 @@ export { BufferManager } from "./BufferManager.js";
 export { alignToChunks, azimuthElevationToNormal, calculateNiivueDepth, clipPlanesToBoundingBox, clipPlanesToNiivue, clipPlanesToPixelRegion, clipPlaneToNiivue, createAxisAlignedClipPlane, createClipPlane, createDefaultClipPlanes, getVolumeBoundsFromMultiscales, isInsideClipPlanes, MAX_CLIP_PLANES, normalizeVector, normalToAzimuthElevation, pointToPlaneDistance, validateClipPlanes, } from "./ClipPlanes.js";
 // Event system (browser-native EventTarget API)
 export { OMEZarrNVImageEvent } from "./events.js";
+// TIFF support (via @fideus-labs/fiff)
+export { fromTiff } from "./fromTiff.js";
 export { computeChannelMinMax, normalizeToUint8 } from "./normalize.js";
 // Main class
 export { OMEZarrNVImage } from "./OMEZarrNVImage.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,+BAA+B;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,sFAAsF;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,qDAAqD;AACrD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AAEvC,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,wBAAwB;AACxB,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AAOxB,gDAAgD;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvE,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtE,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAmBhC,iEAAiE;AACjE,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,uBAAuB;AACvB,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,+BAA+B;AAoC/B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,sFAAsF;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAChD,qDAAqD;AACrD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gCAAgC,CAAA;AAEvC,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,wBAAwB;AACxB,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,uBAAuB,EACvB,8BAA8B,EAC9B,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AAOxB,gDAAgD;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,uCAAuC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACvE,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtE,gCAAgC;AAChC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAmBhC,iEAAiE;AACjE,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAA;AACnB,mBAAmB;AACnB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,uBAAuB;AACvB,OAAO,EACL,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,GACnB,MAAM,wBAAwB,CAAA;AAC/B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fideus-labs/fidnii",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Render OME-Zarr images in NiiVue with progressive multi-resolution loading",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,8 @@
     "src"
   ],
   "dependencies": {
-    "@fideus-labs/ngff-zarr": "^0.9.0",
+    "@fideus-labs/fiff": "^0.3.2",
+    "@fideus-labs/ngff-zarr": "^0.11.0",
     "@itk-wasm/downsample": "^1.8.1",
     "lru-cache": "^11.1.0",
     "@niivue/niivue": "^0.67.0",

package/src/fromTiff.ts

@@ -0,0 +1,88 @@
+// SPDX-FileCopyrightText: Copyright (c) Fideus Labs LLC
+// SPDX-License-Identifier: MIT
+
+/**
+ * Load TIFF files (OME-TIFF, pyramidal, plain) and produce a
+ * {@link Multiscales} object ready for {@link OMEZarrNVImage.create}.
+ *
+ * Uses {@link https://github.com/fideus-labs/fiff | @fideus-labs/fiff}
+ * to present TIFFs as zarrita-compatible stores, then delegates to
+ * {@link fromNgffZarr} for OME-Zarr metadata parsing.
+ */
+
+import type { TiffStoreOptions } from "@fideus-labs/fiff"
+import { TiffStore } from "@fideus-labs/fiff"
+import type { Multiscales } from "@fideus-labs/ngff-zarr"
+import type { FromNgffZarrOptions } from "@fideus-labs/ngff-zarr/browser"
+import { fromNgffZarr } from "@fideus-labs/ngff-zarr/browser"
+import type { Readable } from "zarrita"
+
+/** Options for {@link fromTiff}. */
+export interface FromTiffOptions {
+  /** Options forwarded to {@link TiffStore} (e.g. IFD offsets, HTTP headers). */
+  tiff?: TiffStoreOptions
+  /** Options forwarded to {@link fromNgffZarr} (e.g. validate, cache). */
+  ngffZarr?: Omit<FromNgffZarrOptions, "version">
+}
+
+/**
+ * Load a TIFF file and return a {@link Multiscales} object ready for
+ * {@link OMEZarrNVImage.create}.
+ *
+ * Supports OME-TIFF, pyramidal TIFF (SubIFDs / legacy / COG), and
+ * plain single-image TIFFs. Both local (Blob/ArrayBuffer) and
+ * remote (URL with HTTP range requests) sources are supported.
+ *
+ * @param source - A URL string, Blob/File, ArrayBuffer, or
+ *   pre-built {@link TiffStore}.
+ * @param options - Optional {@link FromTiffOptions}.
+ * @returns A {@link Multiscales} object for use with
+ *   {@link OMEZarrNVImage.create}.
+ * @throws If the source cannot be opened as a TIFF or if the
+ *   synthesized OME-Zarr metadata is invalid.
+ *
+ * @example
+ * ```typescript
+ * // From a remote URL
+ * const ms = await fromTiff("https://example.com/image.ome.tif")
+ * const image = await OMEZarrNVImage.create({
+ *   multiscales: ms,
+ *   niivue: nv,
+ * })
+ *
+ * // From a File input
+ * const file = inputElement.files[0]
+ * const ms = await fromTiff(file)
+ * ```
+ */
+export async function fromTiff(
+  source: string | Blob | ArrayBuffer | TiffStore,
+  options: FromTiffOptions = {},
+): Promise<Multiscales> {
+  let store: TiffStore
+  if (source instanceof TiffStore) {
+    store = source
+  } else if (typeof source === "string") {
+    store = await TiffStore.fromUrl(source, options.tiff)
+  } else if (source instanceof Blob) {
+    store = await TiffStore.fromBlob(source, options.tiff)
+  } else if (source instanceof ArrayBuffer) {
+    store = await TiffStore.fromArrayBuffer(source, options.tiff)
+  } else {
+    throw new Error(
+      "[fidnii] fromTiff: source must be a URL string, Blob, " +
+        "ArrayBuffer, or TiffStore",
+    )
+  }
+
+  // TiffStore implements zarrita's Readable interface structurally
+  // (its get() method accepts string keys including the leading "/"
+  // that zarrita uses for AbsolutePath). Since fromNgffZarr (v0.10+)
+  // accepts zarr.Readable directly, we only need a type assertion.
+  //
+  // TiffStore always produces OME-Zarr v0.5 metadata.
+  return fromNgffZarr(store as unknown as Readable, {
+    version: "0.5",
+    ...options.ngffZarr,
+  })
+}

package/src/index.ts

@@ -34,6 +34,8 @@
  * ```
  */
 
+export type { TiffStoreOptions } from "@fideus-labs/fiff"
+export { TiffStore } from "@fideus-labs/fiff"
 // Re-export Methods enum so consumers can check isLabelImage or compare method values
 export { Methods } from "@fideus-labs/ngff-zarr"
 // Worker pool lifecycle (re-exported from ngff-zarr)
@@ -72,6 +74,9 @@ export type {
 } from "./events.js"
 // Event system (browser-native EventTarget API)
 export { OMEZarrNVImageEvent } from "./events.js"
+export type { FromTiffOptions } from "./fromTiff.js"
+// TIFF support (via @fideus-labs/fiff)
+export { fromTiff } from "./fromTiff.js"
 // RGB normalization utilities
 export type { ChannelWindow } from "./normalize.js"
 export { computeChannelMinMax, normalizeToUint8 } from "./normalize.js"