@fideus-labs/fiff 0.1.0

package/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026-present Fideus Labs LLC <info@fideus.io>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/chunk-reader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Chunk reader: reads pixel data from a GeoTIFFImage for a specific chunk,
+ * returning raw bytes suitable for a Zarr store response.
+ */
+import type { GeoTIFFImage } from "geotiff";
+import type { ZarrDataType } from "./dtypes.js";
+import type { PlaneSelection } from "./ifd-indexer.js";
+/**
+ * Read a single chunk of data from a TIFF image.
+ *
+ * @param getImage - Function to resolve (selection, level) to a GeoTIFFImage.
+ * @param sel - The plane selection (c, z, t).
+ * @param level - The resolution level.
+ * @param chunkY - The y chunk index within the image.
+ * @param chunkX - The x chunk index within the image.
+ * @param chunkHeight - Chunk size in pixels (y dimension).
+ * @param chunkWidth - Chunk size in pixels (x dimension).
+ * @param imageWidth - Total image width at this level.
+ * @param imageHeight - Total image height at this level.
+ * @param dtype - The Zarr data type of the output.
+ * @param signal - Optional abort signal.
+ * @returns Raw bytes for this chunk, zero-padded for edge chunks.
+ */
+export declare function readChunk(getImage: (sel: PlaneSelection, level: number) => Promise<GeoTIFFImage>, sel: PlaneSelection, level: number, chunkY: number, chunkX: number, chunkHeight: number, chunkWidth: number, imageWidth: number, imageHeight: number, dtype: ZarrDataType, signal?: AbortSignal): Promise<Uint8Array>;
+//# sourceMappingURL=chunk-reader.d.ts.map

package/dist/chunk-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-reader.d.ts","sourceRoot":"","sources":["../src/chunk-reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,CACR,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,YAAY,CAAC,EAC1B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoDrB"}

package/dist/chunk-reader.js

@@ -0,0 +1,71 @@
+/**
+ * Chunk reader: reads pixel data from a GeoTIFFImage for a specific chunk,
+ * returning raw bytes suitable for a Zarr store response.
+ */
+import { bytesPerElement } from "./dtypes.js";
+import { computePixelWindow, encodeChunkBytes } from "./utils.js";
+/**
+ * Read a single chunk of data from a TIFF image.
+ *
+ * @param getImage - Function to resolve (selection, level) to a GeoTIFFImage.
+ * @param sel - The plane selection (c, z, t).
+ * @param level - The resolution level.
+ * @param chunkY - The y chunk index within the image.
+ * @param chunkX - The x chunk index within the image.
+ * @param chunkHeight - Chunk size in pixels (y dimension).
+ * @param chunkWidth - Chunk size in pixels (x dimension).
+ * @param imageWidth - Total image width at this level.
+ * @param imageHeight - Total image height at this level.
+ * @param dtype - The Zarr data type of the output.
+ * @param signal - Optional abort signal.
+ * @returns Raw bytes for this chunk, zero-padded for edge chunks.
+ */
+export async function readChunk(getImage, sel, level, chunkY, chunkX, chunkHeight, chunkWidth, imageWidth, imageHeight, dtype, signal) {
+    const [left, top, right, bottom] = computePixelWindow(chunkX, chunkY, chunkWidth, chunkHeight, imageWidth, imageHeight);
+    const windowWidth = right - left;
+    const windowHeight = bottom - top;
+    if (windowWidth <= 0 || windowHeight <= 0) {
+        // Chunk is entirely outside the image; return fill value (zeros)
+        const bpe = bytesPerElement(dtype);
+        return new Uint8Array(chunkWidth * chunkHeight * bpe);
+    }
+    const image = await getImage(sel, level);
+    // Read the pixel data for this window
+    // interleave=true gives a single flat TypedArray
+    const rasterData = await image.readRasters({
+        window: [left, top, right, bottom],
+        width: windowWidth,
+        height: windowHeight,
+        interleave: true,
+        samples: [0], // single sample; channel is handled at IFD level
+        signal,
+    });
+    // readRasters with interleave returns a single TypedArray
+    const pixelData = rasterData;
+    const bpe = bytesPerElement(dtype);
+    const expectedElements = chunkWidth * chunkHeight;
+    // For edge chunks, we need to properly pad the data.
+    // The data from readRasters has shape (windowHeight, windowWidth) but
+    // we need it in a buffer of shape (chunkHeight, chunkWidth).
+    if (windowWidth < chunkWidth || windowHeight < chunkHeight) {
+        return padEdgeChunk(pixelData, windowWidth, windowHeight, chunkWidth, chunkHeight, bpe);
+    }
+    return encodeChunkBytes(pixelData, expectedElements, bpe);
+}
+/**
+ * Pad an edge chunk by copying row-by-row into a full-size buffer.
+ * Edge chunks occur at the right and bottom boundaries of the image.
+ */
+function padEdgeChunk(data, srcWidth, srcHeight, dstWidth, dstHeight, bytesPerEl) {
+    const output = new Uint8Array(dstWidth * dstHeight * bytesPerEl);
+    const src = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    const srcRowBytes = srcWidth * bytesPerEl;
+    const dstRowBytes = dstWidth * bytesPerEl;
+    for (let row = 0; row < srcHeight; row++) {
+        const srcOffset = row * srcRowBytes;
+        const dstOffset = row * dstRowBytes;
+        output.set(src.subarray(srcOffset, srcOffset + srcRowBytes), dstOffset);
+    }
+    return output;
+}
+//# sourceMappingURL=chunk-reader.js.map

package/dist/chunk-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-reader.js","sourceRoot":"","sources":["../src/chunk-reader.ts"],"names":[],"mappings":"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"}

package/dist/dtypes.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TIFF sample format and bit depth to Zarr v3 data_type mapping.
+ *
+ * TIFF SampleFormat values:
+ *   1 = unsigned integer
+ *   2 = signed integer (two's complement)
+ *   3 = IEEE floating point
+ *
+ * Zarr v3 data_type strings: int8, int16, int32, uint8, uint16, uint32,
+ * float32, float64, etc.
+ */
+/** Zarr v3 numeric data type strings. */
+export type ZarrDataType = "int8" | "int16" | "int32" | "uint8" | "uint16" | "uint32" | "float32" | "float64";
+/** TIFF SampleFormat tag values. */
+export declare const SAMPLE_FORMAT_UINT = 1;
+export declare const SAMPLE_FORMAT_INT = 2;
+export declare const SAMPLE_FORMAT_FLOAT = 3;
+/**
+ * Map TIFF SampleFormat + BitsPerSample to a Zarr v3 data_type string.
+ *
+ * @param sampleFormat - TIFF SampleFormat tag value (1=uint, 2=int, 3=float).
+ *   Defaults to 1 (unsigned integer) if not specified.
+ * @param bitsPerSample - Bits per sample (8, 16, 32, 64).
+ * @returns The corresponding Zarr v3 data_type string.
+ * @throws If the combination is unsupported.
+ */
+export declare function tiffDtypeToZarr(sampleFormat: number, bitsPerSample: number): ZarrDataType;
+/**
+ * Map an OME-XML pixel Type string to a Zarr v3 data_type string.
+ *
+ * OME pixel types: int8, int16, int32, uint8, uint16, uint32, float, double
+ */
+export declare function omePixelTypeToZarr(omeType: string): ZarrDataType;
+/** Number of bytes per element for a given Zarr data_type. */
+export declare function bytesPerElement(dtype: ZarrDataType): number;
+/**
+ * Get the appropriate TypedArray constructor for a Zarr data_type.
+ */
+export declare function getTypedArrayConstructor(dtype: ZarrDataType): {
+    new (buffer: ArrayBuffer, byteOffset?: number, length?: number): Uint8Array | Int8Array | Uint16Array | Int16Array | Uint32Array | Int32Array | Float32Array | Float64Array;
+};
+//# sourceMappingURL=dtypes.d.ts.map

package/dist/dtypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtypes.d.ts","sourceRoot":"","sources":["../src/dtypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yCAAyC;AACzC,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB,YAAY,CAyCd;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAiBhE;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAY3D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,GAClB;IACD,KAAK,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAC1D,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,YAAY,GACZ,YAAY,CAAC;CAClB,CAmBA"}

package/dist/dtypes.js

@@ -0,0 +1,122 @@
+/**
+ * TIFF sample format and bit depth to Zarr v3 data_type mapping.
+ *
+ * TIFF SampleFormat values:
+ *   1 = unsigned integer
+ *   2 = signed integer (two's complement)
+ *   3 = IEEE floating point
+ *
+ * Zarr v3 data_type strings: int8, int16, int32, uint8, uint16, uint32,
+ * float32, float64, etc.
+ */
+/** TIFF SampleFormat tag values. */
+export const SAMPLE_FORMAT_UINT = 1;
+export const SAMPLE_FORMAT_INT = 2;
+export const SAMPLE_FORMAT_FLOAT = 3;
+/**
+ * Map TIFF SampleFormat + BitsPerSample to a Zarr v3 data_type string.
+ *
+ * @param sampleFormat - TIFF SampleFormat tag value (1=uint, 2=int, 3=float).
+ *   Defaults to 1 (unsigned integer) if not specified.
+ * @param bitsPerSample - Bits per sample (8, 16, 32, 64).
+ * @returns The corresponding Zarr v3 data_type string.
+ * @throws If the combination is unsupported.
+ */
+export function tiffDtypeToZarr(sampleFormat, bitsPerSample) {
+    if (sampleFormat === SAMPLE_FORMAT_UINT) {
+        switch (bitsPerSample) {
+            case 8:
+                return "uint8";
+            case 16:
+                return "uint16";
+            case 32:
+                return "uint32";
+            default:
+                throw new Error(`Unsupported unsigned integer bit depth: ${bitsPerSample}`);
+        }
+    }
+    else if (sampleFormat === SAMPLE_FORMAT_INT) {
+        switch (bitsPerSample) {
+            case 8:
+                return "int8";
+            case 16:
+                return "int16";
+            case 32:
+                return "int32";
+            default:
+                throw new Error(`Unsupported signed integer bit depth: ${bitsPerSample}`);
+        }
+    }
+    else if (sampleFormat === SAMPLE_FORMAT_FLOAT) {
+        switch (bitsPerSample) {
+            case 32:
+                return "float32";
+            case 64:
+                return "float64";
+            default:
+                throw new Error(`Unsupported floating point bit depth: ${bitsPerSample}`);
+        }
+    }
+    throw new Error(`Unsupported TIFF SampleFormat: ${sampleFormat}`);
+}
+/**
+ * Map an OME-XML pixel Type string to a Zarr v3 data_type string.
+ *
+ * OME pixel types: int8, int16, int32, uint8, uint16, uint32, float, double
+ */
+export function omePixelTypeToZarr(omeType) {
+    const map = {
+        int8: "int8",
+        int16: "int16",
+        int32: "int32",
+        uint8: "uint8",
+        uint16: "uint16",
+        uint32: "uint32",
+        float: "float32",
+        double: "float64",
+    };
+    const lower = omeType.toLowerCase();
+    const result = map[lower];
+    if (!result) {
+        throw new Error(`Unsupported OME pixel type: ${omeType}`);
+    }
+    return result;
+}
+/** Number of bytes per element for a given Zarr data_type. */
+export function bytesPerElement(dtype) {
+    const map = {
+        int8: 1,
+        uint8: 1,
+        int16: 2,
+        uint16: 2,
+        int32: 4,
+        uint32: 4,
+        float32: 4,
+        float64: 8,
+    };
+    return map[dtype];
+}
+/**
+ * Get the appropriate TypedArray constructor for a Zarr data_type.
+ */
+export function getTypedArrayConstructor(dtype) {
+    switch (dtype) {
+        case "uint8":
+            return Uint8Array;
+        case "int8":
+            return Int8Array;
+        case "uint16":
+            return Uint16Array;
+        case "int16":
+            return Int16Array;
+        case "uint32":
+            return Uint32Array;
+        case "int32":
+            return Int32Array;
+        case "float32":
+            return Float32Array;
+        case "float64":
+            return Float64Array;
+    }
+}
+//# sourceMappingURL=dtypes.js.map

package/dist/dtypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtypes.js","sourceRoot":"","sources":["../src/dtypes.ts"],"names":[],"mappings":"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"}

package/dist/ifd-indexer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * IFD indexer: maps (c, z, t, resolution level) to a GeoTIFFImage.
+ *
+ * Handles both modern (SubIFD-based) and legacy (flat IFD chain) pyramid
+ * storage strategies, as well as optional pre-computed IFD byte offsets
+ * for fast random access.
+ */
+import type GeoTIFF from "geotiff";
+import type { GeoTIFFImage } from "geotiff";
+import { type OmePixels } from "./ome-xml.js";
+/** A selection identifying a single 2D plane in a multi-dimensional image. */
+export interface PlaneSelection {
+    c: number;
+    z: number;
+    t: number;
+}
+/** Information about the pyramid structure of a TIFF. */
+export interface PyramidInfo {
+    /** Number of resolution levels (1 means no pyramid). */
+    levels: number;
+    /** Whether the pyramid uses SubIFDs (modern) or flat IFDs (legacy). */
+    usesSubIfds: boolean;
+    /** Width at each level. */
+    widths: number[];
+    /** Height at each level. */
+    heights: number[];
+}
+/**
+ * Determine the pyramid structure of a TIFF by inspecting the first image.
+ *
+ * @param tiff - The opened GeoTIFF object.
+ * @param omeImages - Number of OME-XML Image entries (for legacy detection).
+ * @param planesPerImage - Number of planes (C*Z*T) per OME Image entry.
+ * @returns Pyramid info describing all resolution levels.
+ */
+export declare function detectPyramid(tiff: GeoTIFF, omeImages: number, planesPerImage: number): Promise<PyramidInfo>;
+/**
+ * Create an indexer function for OME-TIFF images.
+ *
+ * The returned function maps a (selection, level) pair to a GeoTIFFImage.
+ *
+ * @param tiff - The opened GeoTIFF object.
+ * @param pixels - OME-XML Pixels metadata.
+ * @param pyramid - Pyramid info from detectPyramid.
+ * @param ifdOffset - Offset into the IFD chain for this OME Image entry.
+ * @param offsets - Optional pre-computed IFD byte offsets.
+ */
+export declare function createOmeIndexer(tiff: GeoTIFF, pixels: OmePixels, pyramid: PyramidInfo, ifdOffset?: number, offsets?: number[]): (sel: PlaneSelection, level: number) => Promise<GeoTIFFImage>;
+/**
+ * Create an indexer function for plain (non-OME) TIFF images.
+ *
+ * For plain TIFFs: single channel, each IFD is a different resolution level
+ * (COG pattern) or a single image.
+ */
+export declare function createPlainIndexer(tiff: GeoTIFF, offsets?: number[]): (sel: PlaneSelection, level: number) => Promise<GeoTIFFImage>;
+//# sourceMappingURL=ifd-indexer.d.ts.map

package/dist/ifd-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifd-indexer.d.ts","sourceRoot":"","sources":["../src/ifd-indexer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,WAAW,CAAC,CA0GtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,WAAW,EACpB,SAAS,GAAE,MAAU,EACrB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CA6C/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAO/D"}

package/dist/ifd-indexer.js

@@ -0,0 +1,197 @@
+/**
+ * IFD indexer: maps (c, z, t, resolution level) to a GeoTIFFImage.
+ *
+ * Handles both modern (SubIFD-based) and legacy (flat IFD chain) pyramid
+ * storage strategies, as well as optional pre-computed IFD byte offsets
+ * for fast random access.
+ */
+import { getIfdIndex } from "./ome-xml.js";
+/**
+ * Determine the pyramid structure of a TIFF by inspecting the first image.
+ *
+ * @param tiff - The opened GeoTIFF object.
+ * @param omeImages - Number of OME-XML Image entries (for legacy detection).
+ * @param planesPerImage - Number of planes (C*Z*T) per OME Image entry.
+ * @returns Pyramid info describing all resolution levels.
+ */
+export async function detectPyramid(tiff, omeImages, planesPerImage) {
+    const firstImage = await tiff.getImage(0);
+    const baseWidth = firstImage.getWidth();
+    const baseHeight = firstImage.getHeight();
+    // Check for SubIFDs (modern bioformats2raw + raw2ometiff format)
+    let subIfds;
+    try {
+        if (firstImage.fileDirectory.hasTag("SubIFDs")) {
+            const raw = await firstImage.fileDirectory.loadValue("SubIFDs");
+            subIfds = Array.isArray(raw) ? raw : Array.from(raw);
+        }
+    }
+    catch {
+        // SubIFDs not available
+    }
+    if (subIfds && subIfds.length > 0) {
+        // Modern format: base + N sub-resolutions
+        const levels = subIfds.length + 1;
+        const widths = [baseWidth];
+        const heights = [baseHeight];
+        // Parse each SubIFD to get its dimensions
+        for (const offset of subIfds) {
+            try {
+                const ifd = await tiff.parseFileDirectoryAt(offset);
+                const subWidth = ifd.fileDirectory?.getValue?.("ImageWidth") ??
+                    ifd.getValue?.("ImageWidth") ??
+                    Math.ceil(widths[widths.length - 1] / 2);
+                const subHeight = ifd.fileDirectory?.getValue?.("ImageLength") ??
+                    ifd.getValue?.("ImageLength") ??
+                    Math.ceil(heights[heights.length - 1] / 2);
+                widths.push(subWidth);
+                heights.push(subHeight);
+            }
+            catch {
+                // Fallback: assume 2x downsampling
+                widths.push(Math.ceil(widths[widths.length - 1] / 2));
+                heights.push(Math.ceil(heights[heights.length - 1] / 2));
+            }
+        }
+        return { levels, usesSubIfds: true, widths, heights };
+    }
+    // Legacy: multiple OME Image entries = multiple resolution levels
+    if (omeImages > 1) {
+        const levels = omeImages;
+        const widths = [baseWidth];
+        const heights = [baseHeight];
+        for (let lvl = 1; lvl < levels; lvl++) {
+            const ifdIdx = lvl * planesPerImage;
+            try {
+                const img = await tiff.getImage(ifdIdx);
+                widths.push(img.getWidth());
+                heights.push(img.getHeight());
+            }
+            catch {
+                widths.push(Math.ceil(widths[widths.length - 1] / 2));
+                heights.push(Math.ceil(heights[heights.length - 1] / 2));
+            }
+        }
+        return { levels, usesSubIfds: false, widths, heights };
+    }
+    // Check for COG-style: multiple IFDs with decreasing resolution
+    // (non-OME TIFFs with overview images)
+    try {
+        const imageCount = await tiff.getImageCount();
+        if (imageCount > 1) {
+            const widths = [baseWidth];
+            const heights = [baseHeight];
+            for (let i = 1; i < imageCount; i++) {
+                const img = await tiff.getImage(i);
+                const w = img.getWidth();
+                const h = img.getHeight();
+                // Only count as pyramid level if it's smaller
+                if (w < widths[widths.length - 1] && h < heights[heights.length - 1]) {
+                    widths.push(w);
+                    heights.push(h);
+                }
+                else {
+                    break;
+                }
+            }
+            if (widths.length > 1) {
+                return {
+                    levels: widths.length,
+                    usesSubIfds: false,
+                    widths,
+                    heights,
+                };
+            }
+        }
+    }
+    catch {
+        // Cannot determine image count
+    }
+    // Single level (no pyramid)
+    return {
+        levels: 1,
+        usesSubIfds: false,
+        widths: [baseWidth],
+        heights: [baseHeight],
+    };
+}
+/**
+ * Create an indexer function for OME-TIFF images.
+ *
+ * The returned function maps a (selection, level) pair to a GeoTIFFImage.
+ *
+ * @param tiff - The opened GeoTIFF object.
+ * @param pixels - OME-XML Pixels metadata.
+ * @param pyramid - Pyramid info from detectPyramid.
+ * @param ifdOffset - Offset into the IFD chain for this OME Image entry.
+ * @param offsets - Optional pre-computed IFD byte offsets.
+ */
+export function createOmeIndexer(tiff, pixels, pyramid, ifdOffset = 0, offsets) {
+    const ifdCache = new Map();
+    const planesPerImage = pixels.sizeC * pixels.sizeZ * pixels.sizeT;
+    return async (sel, level) => {
+        const relativeIfd = getIfdIndex(sel.c, sel.z, sel.t, pixels);
+        const absoluteIfd = relativeIfd + ifdOffset;
+        if (level === 0) {
+            // Base resolution: fetch the IFD directly
+            return getImage(tiff, absoluteIfd, offsets);
+        }
+        if (pyramid.usesSubIfds) {
+            // Modern: get base image, then look up SubIFD for the pyramid level
+            const cacheKey = `sub_${absoluteIfd}_${level}`;
+            if (!ifdCache.has(cacheKey)) {
+                ifdCache.set(cacheKey, (async () => {
+                    const baseImage = await getImage(tiff, absoluteIfd, offsets);
+                    const rawSubIfds = await baseImage.fileDirectory.loadValue("SubIFDs");
+                    const subIfds = Array.isArray(rawSubIfds)
+                        ? rawSubIfds
+                        : Array.from(rawSubIfds);
+                    const subIfdOffset = subIfds[level - 1];
+                    if (subIfdOffset === undefined) {
+                        throw new Error(`SubIFD index ${level - 1} out of range (${subIfds.length} available)`);
+                    }
+                    return getImageAtOffset(tiff, subIfdOffset);
+                })());
+            }
+            return ifdCache.get(cacheKey);
+        }
+        // Legacy: flat IFD chain, each level's IFDs are offset by
+        // level * planesPerImage from the base
+        const levelIfd = absoluteIfd + level * planesPerImage;
+        return getImage(tiff, levelIfd, offsets);
+    };
+}
+/**
+ * Create an indexer function for plain (non-OME) TIFF images.
+ *
+ * For plain TIFFs: single channel, each IFD is a different resolution level
+ * (COG pattern) or a single image.
+ */
+export function createPlainIndexer(tiff, offsets) {
+    return async (_sel, level) => {
+        return getImage(tiff, level, offsets);
+    };
+}
+// ---------- internal helpers ----------
+/**
+ * Get a GeoTIFFImage by IFD index, using pre-computed offsets if available.
+ */
+async function getImage(tiff, index, offsets) {
+    if (offsets && index < offsets.length) {
+        // Use pre-computed offset for direct access
+        return getImageAtOffset(tiff, offsets[index]);
+    }
+    return tiff.getImage(index);
+}
+/**
+ * Parse an IFD at a specific byte offset and return a GeoTIFFImage.
+ */
+async function getImageAtOffset(tiff, byteOffset) {
+    // GeoTIFF.parseFileDirectoryAt is semi-internal but widely used by Viv etc.
+    const ifd = await tiff.parseFileDirectoryAt(byteOffset);
+    // Construct a GeoTIFFImage from the parsed IFD
+    // The exact constructor signature depends on geotiff.js version
+    const GeoTIFFImageClass = (await tiff.getImage(0)).constructor;
+    return new GeoTIFFImageClass(ifd.fileDirectory ?? ifd, tiff.littleEndian, tiff.cache, tiff.source);
+}
+//# sourceMappingURL=ifd-indexer.js.map

package/dist/ifd-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifd-indexer.js","sourceRoot":"","sources":["../src/ifd-indexer.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fideus-labs/fiff
+ *
+ * Present TIFF files as a zarrita.js Zarr store following the OME-Zarr
+ * (NGFF v0.5) data model.
+ *
+ * @example
+ * ```ts
+ * import { TiffStore } from "@fideus-labs/fiff";
+ * import * as zarr from "zarrita";
+ *
+ * const store = await TiffStore.fromUrl("https://example.com/image.ome.tif");
+ * const group = await zarr.open(store, { kind: "group" });
+ * const arr = await zarr.open(group.resolve("0"), { kind: "array" });
+ * const chunk = await arr.getChunk([0, 0, 0]);
+ * ```
+ */
+export { TiffStore, type TiffStoreOptions } from "./tiff-store.js";
+export type { ZarrDataType } from "./dtypes.js";
+export type { OmeImage, OmePixels, OmeChannel, DimensionOrder } from "./ome-xml.js";
+export type { PyramidInfo, PlaneSelection } from "./ifd-indexer.js";
+export type { OmeAxis, OmeMultiscale, OmeDataset, OmeCoordinateTransformation, OmeroMetadata, OmeroChannel, ZarrGroupMetadata, ZarrArrayMetadata, } from "./metadata.js";
+export { parseOmeXml, isOmeXml, getIfdIndex } from "./ome-xml.js";
+export { tiffDtypeToZarr, omePixelTypeToZarr, bytesPerElement } from "./dtypes.js";
+export { parseStoreKey, computePixelWindow } from "./utils.js";
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EACV,OAAO,EACP,aAAa,EACb,UAAU,EACV,2BAA2B,EAC3B,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @fideus-labs/fiff
+ *
+ * Present TIFF files as a zarrita.js Zarr store following the OME-Zarr
+ * (NGFF v0.5) data model.
+ *
+ * @example
+ * ```ts
+ * import { TiffStore } from "@fideus-labs/fiff";
+ * import * as zarr from "zarrita";
+ *
+ * const store = await TiffStore.fromUrl("https://example.com/image.ome.tif");
+ * const group = await zarr.open(store, { kind: "group" });
+ * const arr = await zarr.open(group.resolve("0"), { kind: "array" });
+ * const chunk = await arr.getChunk([0, 0, 0]);
+ * ```
+ */
+export { TiffStore } from "./tiff-store.js";
+// Export utilities that may be useful
+export { parseOmeXml, isOmeXml, getIfdIndex } from "./ome-xml.js";
+export { tiffDtypeToZarr, omePixelTypeToZarr, bytesPerElement } from "./dtypes.js";
+export { parseStoreKey, computePixelWindow } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AAiBnE,sCAAsC;AACtC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}