@fideus-labs/fidnii 0.3.0 → 0.5.0

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";
@@ -56,6 +27,7 @@ export { getBytesPerPixel, getChannelInfo, getNiftiDataType, getRGBNiftiDataType
 export { affineToNiftiSrows, calculateWorldBounds, createAffineFromNgffImage, createAffineFromOMEZarr, getPixelDimensions, updateAffineForRegion, } from "./utils/affine.js";
 // Coordinate utilities
 export { ceilPixelCoord, clampPixelCoord, floorPixelCoord, normalizedToWorld, pixelToWorld, pixelToWorldAffine, roundPixelCoord, worldToNormalized, worldToPixel, worldToPixelAffine, } from "./utils/coordinates.js";
+export { applyOrientationToAffine, getOrientationInfo, getOrientationMapping, getOrientationSigns, } from "./utils/orientation.js";
 // Viewport bounds utilities
 export { boundsApproxEqual, computeViewportBounds2D, computeViewportBounds3D, intersectBounds, } from "./ViewportBounds.js";
 //# sourceMappingURL=index.js.map

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;AAM/B,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,4BAA4B;AAC5B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA"}

package/dist/utils/affine.d.ts

@@ -23,8 +23,18 @@ export declare function createAffineFromOMEZarr(scale: Record<string, number>, t
 /**
  * Create an affine matrix from an NgffImage.
  *
- * @param ngffImage - The NgffImage containing scale and translation
- * @returns 4x4 affine matrix
+ * If the image has RFC-4 anatomical orientation metadata
+ * (`axesOrientations`), the affine column vectors and translations
+ * are sign-flipped so the matrix encodes direction relative to
+ * the NIfTI RAS+ convention. This allows NiiVue's `calculateRAS()`
+ * to correctly determine the anatomical layout.
+ *
+ * When no orientation metadata is present, the matrix is identical
+ * to a plain scale + translation affine (backward-compatible).
+ *
+ * @param ngffImage - The NgffImage containing scale, translation,
+ *   and optional `axesOrientations`
+ * @returns 4x4 affine matrix with orientation signs applied
  */
 export declare function createAffineFromNgffImage(ngffImage: NgffImage): mat4;
 /**

package/dist/utils/affine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"affine.d.ts","sourceRoot":"","sources":["../../src/utils/affine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,IAAI,CA6CN;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG;IAChD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAOzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,IAAI,EACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CA4BN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EACZ,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACnC;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAuClE"}
+{"version":3,"file":"affine.d.ts","sourceRoot":"","sources":["../../src/utils/affine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAIhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,IAAI,CA6CN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAGpE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG;IAChD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACzC,CAUA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAOzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,IAAI,EACpB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACpC,IAAI,CA4BN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EACZ,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACnC;IAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAuClE"}

package/dist/utils/affine.js

@@ -1,6 +1,7 @@
 // SPDX-FileCopyrightText: Copyright (c) Fideus Labs LLC
 // SPDX-License-Identifier: MIT
 import { mat4 } from "gl-matrix";
+import { applyOrientationToAffine } from "./orientation.js";
 /**
  * Create a 4x4 affine transformation matrix from OME-Zarr scale and translation.
  *
@@ -60,11 +61,22 @@ export function createAffineFromOMEZarr(scale, translation) {
 /**
  * Create an affine matrix from an NgffImage.
  *
- * @param ngffImage - The NgffImage containing scale and translation
- * @returns 4x4 affine matrix
+ * If the image has RFC-4 anatomical orientation metadata
+ * (`axesOrientations`), the affine column vectors and translations
+ * are sign-flipped so the matrix encodes direction relative to
+ * the NIfTI RAS+ convention. This allows NiiVue's `calculateRAS()`
+ * to correctly determine the anatomical layout.
+ *
+ * When no orientation metadata is present, the matrix is identical
+ * to a plain scale + translation affine (backward-compatible).
+ *
+ * @param ngffImage - The NgffImage containing scale, translation,
+ *   and optional `axesOrientations`
+ * @returns 4x4 affine matrix with orientation signs applied
  */
 export function createAffineFromNgffImage(ngffImage) {
-    return createAffineFromOMEZarr(ngffImage.scale, ngffImage.translation);
+    const affine = createAffineFromOMEZarr(ngffImage.scale, ngffImage.translation);
+    return applyOrientationToAffine(affine, ngffImage.axesOrientations);
 }
 /**
  * Convert an affine matrix to a flat array for NIfTI header.

package/dist/utils/affine.js.map

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

package/dist/utils/orientation.d.ts

@@ -0,0 +1,157 @@
+import type { AnatomicalOrientation } from "@fideus-labs/ngff-zarr";
+import type { mat4 } from "gl-matrix";
+/**
+ * Mapping from an array axis orientation to the physical (RAS) row
+ * and sign it should occupy in the NIfTI affine.
+ *
+ * - `physicalRow`: which row of the 4x4 affine the scale/translation
+ *   should be placed in (0 = R/L, 1 = A/P, 2 = S/I)
+ * - `sign`: `1` if the orientation is in the RAS+ direction,
+ *   `-1` if opposite
+ */
+export interface OrientationMapping {
+    readonly physicalRow: 0 | 1 | 2;
+    readonly sign: 1 | -1;
+}
+/**
+ * Sign multipliers for each spatial axis, used to encode anatomical
+ * orientation into the NIfTI affine matrix.
+ *
+ * A value of `1` means the axis increases in the RAS+ direction
+ * (Right, Anterior, Superior). A value of `-1` means it increases
+ * in the opposite direction (Left, Posterior, Inferior).
+ *
+ * @deprecated Use {@link getOrientationMapping} for full permutation
+ *   support. This interface only captures sign, not axis permutations.
+ */
+export interface OrientationSigns {
+    readonly x: 1 | -1;
+    readonly y: 1 | -1;
+    readonly z: 1 | -1;
+}
+/**
+ * Get the orientation mapping (physical row + RAS sign) for a single
+ * axis orientation.
+ *
+ * For unknown/exotic orientations, returns `undefined`.
+ *
+ * @param orientation - The anatomical orientation for one axis
+ * @returns The physical row and sign, or `undefined` if not a standard
+ *   L/R, A/P, or S/I orientation
+ */
+export declare function getOrientationInfo(orientation: AnatomicalOrientation): OrientationMapping | undefined;
+/**
+ * Get orientation mappings for all three spatial axes.
+ *
+ * Each mapping tells you which physical (RAS) row the array axis
+ * maps to and what sign to apply. This supports both sign flips
+ * (e.g. LPS) and axis permutations (e.g. when the OME-Zarr y axis
+ * encodes S/I instead of A/P).
+ *
+ * When no orientation metadata is present, returns the identity
+ * mapping: x→row 0 sign +1, y→row 1 sign +1, z→row 2 sign +1.
+ *
+ * @param axesOrientations - Orientation metadata from
+ *   `NgffImage.axesOrientations`, or `undefined`
+ * @returns Mappings for x, y, and z axes
+ *
+ * @example
+ * ```typescript
+ * // LPS data: x→row0 sign-1, y→row1 sign-1, z→row2 sign+1
+ * getOrientationMapping(LPS)
+ *
+ * // Permuted (mri.nii.gz): x→row0 sign-1, y→row2 sign-1, z→row1 sign+1
+ * getOrientationMapping(permutedOrientations)
+ * ```
+ */
+export declare function getOrientationMapping(axesOrientations: Record<string, AnatomicalOrientation> | undefined): {
+    x: OrientationMapping;
+    y: OrientationMapping;
+    z: OrientationMapping;
+};
+/**
+ * Compute RAS+ sign multipliers from RFC-4 anatomical orientation metadata.
+ *
+ * For each spatial axis, determines whether the axis direction is aligned
+ * with (+1) or opposite to (-1) the NIfTI RAS+ convention:
+ * - x: positive = left-to-right (R), negative = right-to-left (L)
+ * - y: positive = posterior-to-anterior (A), negative = anterior-to-posterior (P)
+ * - z: positive = inferior-to-superior (S), negative = superior-to-inferior (I)
+ *
+ * Only the 6 standard L/R, A/P, I/S orientations are handled. Exotic
+ * orientations (dorsal/ventral, rostral/caudal, etc.) are treated as
+ * unknown and default to +1.
+ *
+ * **Note**: This function only returns sign information, not axis
+ * permutation. For full permutation support, use
+ * {@link getOrientationMapping} and {@link applyOrientationToAffine}.
+ *
+ * @param axesOrientations - Orientation metadata from `NgffImage.axesOrientations`,
+ *   or `undefined` if no orientation metadata is present
+ * @returns Sign multipliers for x, y, and z axes
+ *
+ * @example
+ * ```typescript
+ * import { LPS, RAS } from "@fideus-labs/ngff-zarr"
+ *
+ * // LPS data: x and y are anti-RAS+
+ * getOrientationSigns(LPS)
+ * // => { x: -1, y: -1, z: 1 }
+ *
+ * // RAS data: all axes are RAS+
+ * getOrientationSigns(RAS)
+ * // => { x: 1, y: 1, z: 1 }
+ *
+ * // No orientation: defaults to all positive
+ * getOrientationSigns(undefined)
+ * // => { x: 1, y: 1, z: 1 }
+ * ```
+ */
+export declare function getOrientationSigns(axesOrientations: Record<string, AnatomicalOrientation> | undefined): OrientationSigns;
+/**
+ * Apply anatomical orientation to an affine matrix in place.
+ *
+ * Builds a rotation/permutation matrix from the orientation metadata
+ * and applies it to the affine's 3x3 rotation/scale submatrix. This
+ * supports both simple sign flips (e.g. LPS where axes align with
+ * physical axes but directions differ) and full axis permutations
+ * (e.g. when OME-Zarr y axis encodes S/I instead of A/P).
+ *
+ * The input affine is expected to be a diagonal scale+translation
+ * matrix in gl-matrix column-major format, as produced by
+ * `createAffineFromOMEZarr()`:
+ *
+ * ```
+ * | sx  0   0  tx |
+ * | 0   sy  0  ty |
+ * | 0   0   sz tz |
+ * | 0   0   0  1  |
+ * ```
+ *
+ * **3x3 submatrix**: Each column's scale is placed in the row
+ * corresponding to the physical RAS axis the array axis maps to,
+ * with the appropriate sign:
+ *
+ * ```
+ * Column j (array axis j):
+ *   row = physicalRow for axis j
+ *   affine[j*4 + row] = sign * scale_j
+ * ```
+ *
+ * **Translation column**: Sign-flipped for LPS→RAS conversion but
+ * NOT row-permuted. This is because `itkImageToNgffImage` stores
+ * the ITK LPS origin values in array-axis-label order without
+ * transforming them through the direction matrix. The label
+ * assignment (x/y/z) follows the reversed ITK axis indices, so the
+ * physical meaning of each translation value matches its original
+ * LPS axis, regardless of axis permutation.
+ *
+ * When `axesOrientations` is `undefined`, the affine is left
+ * unchanged (backward-compatible identity mapping).
+ *
+ * @param affine - 4x4 affine matrix (column-major, modified in place)
+ * @param axesOrientations - Orientation metadata from `NgffImage.axesOrientations`
+ * @returns The same affine matrix (for chaining)
+ */
+export declare function applyOrientationToAffine(affine: mat4, axesOrientations: Record<string, AnatomicalOrientation> | undefined): mat4;
+//# sourceMappingURL=orientation.d.ts.map

package/dist/utils/orientation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../../src/utils/orientation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;CACnB;AAuBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,qBAAqB,GACjC,kBAAkB,GAAG,SAAS,CAEhC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,GAClE;IAAE,CAAC,EAAE,kBAAkB,CAAC;IAAC,CAAC,EAAE,kBAAkB,CAAC;IAAC,CAAC,EAAE,kBAAkB,CAAA;CAAE,CA2CzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,GAClE,gBAAgB,CAOlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,EACZ,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,GAClE,IAAI,CAiDN"}

package/dist/utils/orientation.js

@@ -0,0 +1,225 @@
+// SPDX-FileCopyrightText: Copyright (c) Fideus Labs LLC
+// SPDX-License-Identifier: MIT
+/**
+ * Lookup table mapping each RFC-4 anatomical orientation string to
+ * its NIfTI RAS+ physical row and sign.
+ *
+ * RAS+ convention:
+ * - Row 0 (X): left-to-right (R+)
+ * - Row 1 (Y): posterior-to-anterior (A+)
+ * - Row 2 (Z): inferior-to-superior (S+)
+ */
+const ORIENTATION_INFO = {
+    // L/R pair → physical row 0
+    "left-to-right": { physicalRow: 0, sign: 1 },
+    "right-to-left": { physicalRow: 0, sign: -1 },
+    // A/P pair → physical row 1
+    "posterior-to-anterior": { physicalRow: 1, sign: 1 },
+    "anterior-to-posterior": { physicalRow: 1, sign: -1 },
+    // S/I pair → physical row 2
+    "inferior-to-superior": { physicalRow: 2, sign: 1 },
+    "superior-to-inferior": { physicalRow: 2, sign: -1 },
+};
+/**
+ * Get the orientation mapping (physical row + RAS sign) for a single
+ * axis orientation.
+ *
+ * For unknown/exotic orientations, returns `undefined`.
+ *
+ * @param orientation - The anatomical orientation for one axis
+ * @returns The physical row and sign, or `undefined` if not a standard
+ *   L/R, A/P, or S/I orientation
+ */
+export function getOrientationInfo(orientation) {
+    return ORIENTATION_INFO[orientation.value];
+}
+/**
+ * Get orientation mappings for all three spatial axes.
+ *
+ * Each mapping tells you which physical (RAS) row the array axis
+ * maps to and what sign to apply. This supports both sign flips
+ * (e.g. LPS) and axis permutations (e.g. when the OME-Zarr y axis
+ * encodes S/I instead of A/P).
+ *
+ * When no orientation metadata is present, returns the identity
+ * mapping: x→row 0 sign +1, y→row 1 sign +1, z→row 2 sign +1.
+ *
+ * @param axesOrientations - Orientation metadata from
+ *   `NgffImage.axesOrientations`, or `undefined`
+ * @returns Mappings for x, y, and z axes
+ *
+ * @example
+ * ```typescript
+ * // LPS data: x→row0 sign-1, y→row1 sign-1, z→row2 sign+1
+ * getOrientationMapping(LPS)
+ *
+ * // Permuted (mri.nii.gz): x→row0 sign-1, y→row2 sign-1, z→row1 sign+1
+ * getOrientationMapping(permutedOrientations)
+ * ```
+ */
+export function getOrientationMapping(axesOrientations) {
+    const defaultMapping = {
+        x: { physicalRow: 0, sign: 1 },
+        y: { physicalRow: 1, sign: 1 },
+        z: { physicalRow: 2, sign: 1 },
+    };
+    if (!axesOrientations) {
+        return defaultMapping;
+    }
+    const xOrientation = axesOrientations.x ?? axesOrientations.X;
+    const yOrientation = axesOrientations.y ?? axesOrientations.Y;
+    const zOrientation = axesOrientations.z ?? axesOrientations.Z;
+    const mapping = {
+        x: (xOrientation ? getOrientationInfo(xOrientation) : undefined) ??
+            defaultMapping.x,
+        y: (yOrientation ? getOrientationInfo(yOrientation) : undefined) ??
+            defaultMapping.y,
+        z: (zOrientation ? getOrientationInfo(zOrientation) : undefined) ??
+            defaultMapping.z,
+    };
+    // Validate that each physicalRow is used exactly once to prevent
+    // degenerate affine matrices where columns overwrite each other
+    const rowsUsed = new Set([
+        mapping.x.physicalRow,
+        mapping.y.physicalRow,
+        mapping.z.physicalRow,
+    ]);
+    if (rowsUsed.size !== 3) {
+        console.warn("[fidnii] Invalid orientation metadata: multiple axes map to the same physical row. Falling back to identity mapping.");
+        return defaultMapping;
+    }
+    return mapping;
+}
+/**
+ * Compute RAS+ sign multipliers from RFC-4 anatomical orientation metadata.
+ *
+ * For each spatial axis, determines whether the axis direction is aligned
+ * with (+1) or opposite to (-1) the NIfTI RAS+ convention:
+ * - x: positive = left-to-right (R), negative = right-to-left (L)
+ * - y: positive = posterior-to-anterior (A), negative = anterior-to-posterior (P)
+ * - z: positive = inferior-to-superior (S), negative = superior-to-inferior (I)
+ *
+ * Only the 6 standard L/R, A/P, I/S orientations are handled. Exotic
+ * orientations (dorsal/ventral, rostral/caudal, etc.) are treated as
+ * unknown and default to +1.
+ *
+ * **Note**: This function only returns sign information, not axis
+ * permutation. For full permutation support, use
+ * {@link getOrientationMapping} and {@link applyOrientationToAffine}.
+ *
+ * @param axesOrientations - Orientation metadata from `NgffImage.axesOrientations`,
+ *   or `undefined` if no orientation metadata is present
+ * @returns Sign multipliers for x, y, and z axes
+ *
+ * @example
+ * ```typescript
+ * import { LPS, RAS } from "@fideus-labs/ngff-zarr"
+ *
+ * // LPS data: x and y are anti-RAS+
+ * getOrientationSigns(LPS)
+ * // => { x: -1, y: -1, z: 1 }
+ *
+ * // RAS data: all axes are RAS+
+ * getOrientationSigns(RAS)
+ * // => { x: 1, y: 1, z: 1 }
+ *
+ * // No orientation: defaults to all positive
+ * getOrientationSigns(undefined)
+ * // => { x: 1, y: 1, z: 1 }
+ * ```
+ */
+export function getOrientationSigns(axesOrientations) {
+    const mapping = getOrientationMapping(axesOrientations);
+    return {
+        x: mapping.x.sign,
+        y: mapping.y.sign,
+        z: mapping.z.sign,
+    };
+}
+/**
+ * Apply anatomical orientation to an affine matrix in place.
+ *
+ * Builds a rotation/permutation matrix from the orientation metadata
+ * and applies it to the affine's 3x3 rotation/scale submatrix. This
+ * supports both simple sign flips (e.g. LPS where axes align with
+ * physical axes but directions differ) and full axis permutations
+ * (e.g. when OME-Zarr y axis encodes S/I instead of A/P).
+ *
+ * The input affine is expected to be a diagonal scale+translation
+ * matrix in gl-matrix column-major format, as produced by
+ * `createAffineFromOMEZarr()`:
+ *
+ * ```
+ * | sx  0   0  tx |
+ * | 0   sy  0  ty |
+ * | 0   0   sz tz |
+ * | 0   0   0  1  |
+ * ```
+ *
+ * **3x3 submatrix**: Each column's scale is placed in the row
+ * corresponding to the physical RAS axis the array axis maps to,
+ * with the appropriate sign:
+ *
+ * ```
+ * Column j (array axis j):
+ *   row = physicalRow for axis j
+ *   affine[j*4 + row] = sign * scale_j
+ * ```
+ *
+ * **Translation column**: Sign-flipped for LPS→RAS conversion but
+ * NOT row-permuted. This is because `itkImageToNgffImage` stores
+ * the ITK LPS origin values in array-axis-label order without
+ * transforming them through the direction matrix. The label
+ * assignment (x/y/z) follows the reversed ITK axis indices, so the
+ * physical meaning of each translation value matches its original
+ * LPS axis, regardless of axis permutation.
+ *
+ * When `axesOrientations` is `undefined`, the affine is left
+ * unchanged (backward-compatible identity mapping).
+ *
+ * @param affine - 4x4 affine matrix (column-major, modified in place)
+ * @param axesOrientations - Orientation metadata from `NgffImage.axesOrientations`
+ * @returns The same affine matrix (for chaining)
+ */
+export function applyOrientationToAffine(affine, axesOrientations) {
+    if (!axesOrientations) {
+        return affine;
+    }
+    const mapping = getOrientationMapping(axesOrientations);
+    // Extract the current diagonal scale and translation values
+    // (the input affine is expected to be diagonal from createAffineFromOMEZarr)
+    const sx = affine[0];
+    const sy = affine[5];
+    const sz = affine[10];
+    const tx = affine[12];
+    const ty = affine[13];
+    const tz = affine[14];
+    // Clear the 3x3 submatrix (translation will be overwritten below)
+    // Column 0
+    affine[0] = 0;
+    affine[1] = 0;
+    affine[2] = 0;
+    // Column 1
+    affine[4] = 0;
+    affine[5] = 0;
+    affine[6] = 0;
+    // Column 2
+    affine[8] = 0;
+    affine[9] = 0;
+    affine[10] = 0;
+    // Place each axis' scale into the correct physical row.
+    // gl-matrix is column-major: index = col * 4 + row
+    // Column 0 (array x axis): place sx at physicalRow for x
+    affine[0 + mapping.x.physicalRow] = mapping.x.sign * sx;
+    // Column 1 (array y axis): place sy at physicalRow for y
+    affine[4 + mapping.y.physicalRow] = mapping.y.sign * sy;
+    // Column 2 (array z axis): place sz at physicalRow for z
+    affine[8 + mapping.z.physicalRow] = mapping.z.sign * sz;
+    // Translation: sign-flip for LPS→RAS but keep at original row
+    // positions (x→row 0, y→row 1, z→row 2). See JSDoc for why.
+    affine[12] = mapping.x.sign * tx;
+    affine[13] = mapping.y.sign * ty;
+    affine[14] = mapping.z.sign * tz;
+    return affine;
+}
+//# sourceMappingURL=orientation.js.map

package/dist/utils/orientation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fideus-labs/fidnii",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Render OME-Zarr images in NiiVue with progressive multi-resolution loading",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,17 +16,18 @@
     "src"
   ],
   "dependencies": {
-    "@fideus-labs/ngff-zarr": "^0.9.0",
+    "@fideus-labs/fiff": "^0.5.2",
+    "@fideus-labs/ngff-zarr": "^0.12.0",
     "@itk-wasm/downsample": "^1.8.1",
-    "lru-cache": "^11.1.0",
     "@niivue/niivue": "^0.67.0",
     "gl-matrix": "^3.4.4",
+    "lru-cache": "^11.1.0",
     "nifti-reader-js": "^0.8.0",
     "zarrita": "^0.6.1",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@fideus-labs/fizarrita": "^1.3.0",
+    "@fideus-labs/fizarrita": "^1.4.0",
     "@fideus-labs/worker-pool": "^1.0.0",
     "@playwright/test": "^1.58.1",
     "@types/node": "^20.19.30",