@adobe/data 0.9.54 → 0.9.56

package/dist/functions/serialization/serialize-to-storage.browser.test.js

@@ -0,0 +1,161 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { serializeToStorage, deserializeFromStorage } from "./serialize-to-storage.js";
+import { createBlobStore } from "../../cache/blob-store.js";
+describe("serializeToStorage", () => {
+    let mockStorage;
+    let testBlobStore;
+    beforeEach(async () => {
+        mockStorage = {
+            setItem: vi.fn(),
+            getItem: vi.fn(),
+            removeItem: vi.fn(),
+            clear: vi.fn(),
+            length: 0,
+            key: vi.fn(),
+        };
+        testBlobStore = await createBlobStore();
+        vi.clearAllMocks();
+    });
+    it("should serialize data to storage with blob references", async () => {
+        const data = {
+            message: "hello world",
+            numbers: new Uint8Array([1, 2, 3, 4, 5]),
+            coordinates: new Float32Array([10.5, 20.3])
+        };
+        // Use the real blobStore to get actual references
+        await serializeToStorage(data, "test-id", mockStorage);
+        expect(mockStorage.setItem).toHaveBeenCalledWith("test-id", expect.any(String));
+        const storedData = JSON.parse(mockStorage.setItem.mock.calls[0][1]);
+        expect(storedData).toHaveProperty("json");
+        expect(storedData).toHaveProperty("binary");
+        expect(storedData.json).toHaveProperty("localBlobRef");
+        expect(storedData.binary).toHaveProperty("localBlobRef");
+    });
+    it("should use sessionStorage by default", async () => {
+        const data = { test: "data" };
+        await serializeToStorage(data, "test-id");
+        // This test verifies the function doesn't throw when using default storage
+        // The actual storage interaction would be with the real sessionStorage
+        expect(true).toBe(true); // Placeholder assertion
+    });
+});
+describe("deserializeFromStorage", () => {
+    let mockStorage;
+    let testBlobStore;
+    beforeEach(async () => {
+        mockStorage = {
+            setItem: vi.fn(),
+            getItem: vi.fn(),
+            removeItem: vi.fn(),
+            clear: vi.fn(),
+            length: 0,
+            key: vi.fn(),
+        };
+        testBlobStore = await createBlobStore();
+        vi.clearAllMocks();
+    });
+    it("should deserialize data from storage", async () => {
+        const originalData = {
+            message: "hello world",
+            numbers: new Uint8Array([1, 2, 3, 4, 5]),
+            coordinates: new Float32Array([10.5, 20.3])
+        };
+        // First serialize the data to get real blob references
+        await serializeToStorage(originalData, "test-id", mockStorage);
+        // Get the stored data
+        const storedData = JSON.parse(mockStorage.setItem.mock.calls[0][1]);
+        // Mock the getItem to return our stored data
+        mockStorage.getItem.mockReturnValue(JSON.stringify(storedData));
+        const result = await deserializeFromStorage("test-id", mockStorage);
+        expect(mockStorage.getItem).toHaveBeenCalledWith("test-id");
+        expect(result).not.toBeNull();
+        expect(result).toEqual(originalData);
+    });
+    it("should return null when no data exists", async () => {
+        mockStorage.getItem.mockReturnValue(null);
+        const result = await deserializeFromStorage("test-id", mockStorage);
+        expect(result).toBeNull();
+    });
+    it("should return null when blob retrieval fails", async () => {
+        // Create invalid blob references
+        const invalidRefs = {
+            json: { localBlobRef: "invalid-hash" },
+            binary: { localBlobRef: "invalid-hash" }
+        };
+        mockStorage.getItem.mockReturnValue(JSON.stringify(invalidRefs));
+        const result = await deserializeFromStorage("test-id", mockStorage);
+        expect(result).toBeNull();
+    });
+    it("should use sessionStorage by default", async () => {
+        // For this test, we need to mock the real sessionStorage since the function uses it by default
+        const originalSessionStorage = globalThis.sessionStorage;
+        const mockSessionStorage = {
+            getItem: vi.fn().mockReturnValue(null),
+            setItem: vi.fn(),
+            removeItem: vi.fn(),
+            clear: vi.fn(),
+            length: 0,
+            key: vi.fn(),
+        };
+        Object.defineProperty(globalThis, 'sessionStorage', {
+            value: mockSessionStorage,
+            writable: true,
+        });
+        try {
+            await deserializeFromStorage("test-id");
+            expect(mockSessionStorage.getItem).toHaveBeenCalledWith("test-id");
+        }
+        finally {
+            Object.defineProperty(globalThis, 'sessionStorage', {
+                value: originalSessionStorage,
+                writable: true,
+            });
+        }
+    });
+    it("should handle complex nested data with all typed arrays", async () => {
+        const originalData = {
+            user: {
+                name: "John Doe",
+                scores: new Uint16Array([95, 87, 92, 88]),
+                coordinates: new Float32Array([10.5, 20.3, 30.7])
+            },
+            metadata: {
+                timestamp: 1234567890,
+                flags: new Uint8Array([1, 0, 1, 1, 0]),
+                measurements: new Float64Array([1.23456789, 2.34567890, 3.45678901])
+            }
+        };
+        // First serialize the data to get real blob references
+        await serializeToStorage(originalData, "test-id", mockStorage);
+        // Get the stored data
+        const storedData = JSON.parse(mockStorage.setItem.mock.calls[0][1]);
+        // Mock the getItem to return our stored data
+        mockStorage.getItem.mockReturnValue(JSON.stringify(storedData));
+        const result = await deserializeFromStorage("test-id", mockStorage);
+        expect(result).not.toBeNull();
+        expect(result).toEqual(originalData);
+    });
+    it("should handle all supported typed arrays", async () => {
+        const originalData = {
+            uint8Array: new Uint8Array([1, 2, 3, 4, 5]),
+            uint16Array: new Uint16Array([1000, 2000, 3000]),
+            uint32Array: new Uint32Array([1000000, 2000000]),
+            int8Array: new Int8Array([-1, -2, -3]),
+            int16Array: new Int16Array([-1000, -2000]),
+            int32Array: new Int32Array([-1000000, -2000000]),
+            float32Array: new Float32Array([1.5, 2.5, 3.5]),
+            float64Array: new Float64Array([1.123456789, 2.987654321])
+        };
+        // First serialize the data to get real blob references
+        await serializeToStorage(originalData, "test-id", mockStorage);
+        // Get the stored data
+        const storedData = JSON.parse(mockStorage.setItem.mock.calls[0][1]);
+        // Mock the getItem to return our stored data
+        mockStorage.getItem.mockReturnValue(JSON.stringify(storedData));
+        const result = await deserializeFromStorage("test-id", mockStorage);
+        expect(result).not.toBeNull();
+        expect(result).toEqual(originalData);
+    });
+});
+//# sourceMappingURL=serialize-to-storage.browser.test.js.map

package/dist/functions/serialization/serialize-to-storage.browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-to-storage.browser.test.js","sourceRoot":"","sources":["../../../src/functions/serialization/serialize-to-storage.browser.test.ts"],"names":[],"mappings":"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"}

package/dist/internal/typed-array/get-byte-size.d.ts

@@ -1,2 +1,2 @@
 import type { TypedArrayConstructor } from "../../types/typed-array-constructer.js";
-export declare const getByteSize: (typedArrayConstructor: TypedArrayConstructor) => 4 | 1 | 2 | 8;
+export declare const getByteSize: (typedArrayConstructor: TypedArrayConstructor) => 1 | 2 | 4 | 8;

package/dist/is-data.d.ts

@@ -6,5 +6,5 @@ export type IsFullyReadonly<T> = EqualReadonly<T, Readonly<T>>;
 export type IsData<T> = [
     T
 ] extends [Primitive] ? true : T extends ReadonlyArray<infer U> ? EqualReadonly<T, ReadonlyArray<U>> extends true ? IsData<U> : false : T extends object ? IsFullyReadonly<T> extends true ? {
-    [K in keyof T]-?: IsData<T[K]>;
+    [K in keyof T]-?: IsData<Exclude<T[K], undefined>>;
 }[keyof T] extends false ? false : true : false : false;

package/dist/math/aabb/face/all.d.ts

@@ -0,0 +1,2 @@
+/** All six single-face bits */
+export declare const ALL: number;

package/dist/math/aabb/face/all.js

@@ -0,0 +1,10 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+/** All six single-face bits */
+export const ALL = POS_Z | POS_X | NEG_Z | NEG_X | POS_Y | NEG_Y;
+//# sourceMappingURL=all.js.map

package/dist/math/aabb/face/all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"all.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/all.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC"}

package/dist/math/aabb/face/face.d.ts

@@ -0,0 +1,4 @@
+import { Schema } from "../../../schema/index.js";
+import { schema } from "./schema.js";
+export type Face = Schema.ToType<typeof schema>;
+export * as Face from "./public.js";

package/dist/math/aabb/face/face.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * as Face from "./public.js";
+//# sourceMappingURL=face.js.map

package/dist/math/aabb/face/face.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"face.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/face.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAOvD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC"}

package/dist/math/aabb/face/from-position.d.ts

@@ -0,0 +1,9 @@
+import type { Vec3 } from "../../vec3/index.js";
+import { Aabb } from "../index.js";
+import type { Face } from "./face.js";
+/**
+ * Single-face bit closest to `position` in normalized box space (unit cube centered on origin by default).
+ * @param position World position of the sample point
+ * @param aabb Bounds used to compute the box center (defaults to unit cube)
+ */
+export declare const fromPosition: (position: Vec3, aabb?: Aabb) => Face;

package/dist/math/aabb/face/from-position.js

@@ -0,0 +1,32 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Aabb } from "../index.js";
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+/**
+ * Single-face bit closest to `position` in normalized box space (unit cube centered on origin by default).
+ * @param position World position of the sample point
+ * @param aabb Bounds used to compute the box center (defaults to unit cube)
+ */
+export const fromPosition = (position, aabb = Aabb.unit) => {
+    const aabbCenter = Aabb.center(aabb);
+    const localPos = [
+        position[0] - aabbCenter[0],
+        position[1] - aabbCenter[1],
+        position[2] - aabbCenter[2],
+    ];
+    const absX = Math.abs(localPos[0]);
+    const absY = Math.abs(localPos[1]);
+    const absZ = Math.abs(localPos[2]);
+    if (absX >= absY && absX >= absZ) {
+        return localPos[0] > 0 ? POS_X : NEG_X;
+    }
+    if (absY >= absZ) {
+        return localPos[1] > 0 ? POS_Y : NEG_Y;
+    }
+    return localPos[2] > 0 ? POS_Z : NEG_Z;
+};
+//# sourceMappingURL=from-position.js.map

package/dist/math/aabb/face/from-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-position.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/from-position.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAc,EAAE,OAAa,IAAI,CAAC,IAAI,EAAQ,EAAE;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG;QACb,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;QAC3B,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;QAC3B,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;KAC9B,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC,CAAC"}

package/dist/math/aabb/face/from-position.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/from-position.test.js

@@ -0,0 +1,21 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { fromPosition } from "./from-position.js";
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+describe("fromPosition", () => {
+    it("selects the dominant-axis face on a unit cube", () => {
+        const aabb = { min: [-1, -1, -1], max: [1, 1, 1] };
+        expect(fromPosition([1, 0, 0], aabb)).toBe(POS_X);
+        expect(fromPosition([-1, 0, 0], aabb)).toBe(NEG_X);
+        expect(fromPosition([0, 1, 0], aabb)).toBe(POS_Y);
+        expect(fromPosition([0, -1, 0], aabb)).toBe(NEG_Y);
+        expect(fromPosition([0, 0, 1], aabb)).toBe(POS_Z);
+        expect(fromPosition([0, 0, -1], aabb)).toBe(NEG_Z);
+    });
+});
+//# sourceMappingURL=from-position.test.js.map

package/dist/math/aabb/face/from-position.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-position.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/from-position.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,EAAE,CAAC;QACrE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/get-adjacent.d.ts

@@ -0,0 +1,3 @@
+import type { Face } from "./face.js";
+/** Single-face bits that share an edge with `face` */
+export declare const getAdjacent: (face: Face) => readonly Face[];

package/dist/math/aabb/face/get-adjacent.js

@@ -0,0 +1,24 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+/** Single-face bits that share an edge with `face` */
+export const getAdjacent = (face) => {
+    switch (face) {
+        case POS_Z:
+        case NEG_Z:
+            return [POS_X, NEG_X, POS_Y, NEG_Y];
+        case POS_X:
+        case NEG_X:
+            return [POS_Z, NEG_Z, POS_Y, NEG_Y];
+        case POS_Y:
+        case NEG_Y:
+            return [POS_Z, NEG_Z, POS_X, NEG_X];
+        default:
+            throw new Error(`Invalid face index: ${face}`);
+    }
+};
+//# sourceMappingURL=get-adjacent.js.map

package/dist/math/aabb/face/get-adjacent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-adjacent.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-adjacent.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAU,EAAmB,EAAE;IACvD,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACN,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACN,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACN,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACxC;YACI,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC,CAAC"}

package/dist/math/aabb/face/get-adjacent.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/get-adjacent.test.js

@@ -0,0 +1,27 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { getAdjacent } from "./get-adjacent.js";
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+describe("getAdjacent", () => {
+    it("returns four edge neighbors for ±Z", () => {
+        expect(getAdjacent(POS_Z)).toEqual([POS_X, NEG_X, POS_Y, NEG_Y]);
+        expect(getAdjacent(NEG_Z)).toEqual([POS_X, NEG_X, POS_Y, NEG_Y]);
+    });
+    it("returns four edge neighbors for ±X", () => {
+        expect(getAdjacent(POS_X)).toEqual([POS_Z, NEG_Z, POS_Y, NEG_Y]);
+        expect(getAdjacent(NEG_X)).toEqual([POS_Z, NEG_Z, POS_Y, NEG_Y]);
+    });
+    it("returns four edge neighbors for ±Y", () => {
+        expect(getAdjacent(POS_Y)).toEqual([POS_Z, NEG_Z, POS_X, NEG_X]);
+        expect(getAdjacent(NEG_Y)).toEqual([POS_Z, NEG_Z, POS_X, NEG_X]);
+    });
+    it("throws for invalid face index", () => {
+        expect(() => getAdjacent(6)).toThrow("Invalid face index: 6");
+    });
+});
+//# sourceMappingURL=get-adjacent.test.js.map

package/dist/math/aabb/face/get-adjacent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-adjacent.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-adjacent.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/get-faces.d.ts

@@ -0,0 +1,3 @@
+import type { Face } from "./face.js";
+/** Yields each single-face bit set in `face` */
+export declare function getFaces(face: Face): IterableIterator<Face>;

package/dist/math/aabb/face/get-faces.js

@@ -0,0 +1,11 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { FACES } from "./internals.js";
+/** Yields each single-face bit set in `face` */
+export function* getFaces(face) {
+    for (const f of FACES) {
+        if (face & f) {
+            yield f;
+        }
+    }
+}
+//# sourceMappingURL=get-faces.js.map

package/dist/math/aabb/face/get-faces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-faces.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-faces.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,gDAAgD;AAChD,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAU;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACpB,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,CAAC;QACZ,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/math/aabb/face/get-faces.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/get-faces.test.js

@@ -0,0 +1,16 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { getFaces } from "./get-faces.js";
+import { NEG_X } from "./neg-x.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Z } from "./pos-z.js";
+describe("getFaces", () => {
+    it("yields each set single-face bit", () => {
+        const mask = POS_Z | POS_X;
+        expect([...getFaces(mask)]).toEqual([POS_Z, POS_X]);
+    });
+    it("yields NEG_X when only that bit is set", () => {
+        expect([...getFaces(NEG_X)]).toEqual([NEG_X]);
+    });
+});
+//# sourceMappingURL=get-faces.test.js.map

package/dist/math/aabb/face/get-faces.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-faces.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-faces.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;QAC3B,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/get-name.d.ts

@@ -0,0 +1,3 @@
+import type { Face } from "./face.js";
+/** AABB face direction name for debugging/logging */
+export declare const getName: (face: Face) => string;

package/dist/math/aabb/face/get-name.js

@@ -0,0 +1,7 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { FACE_NAMES } from "./internals.js";
+/** AABB face direction name for debugging/logging */
+export const getName = (face) => {
+    return FACE_NAMES.get(face) ?? `Unknown(${face})`;
+};
+//# sourceMappingURL=get-name.js.map

package/dist/math/aabb/face/get-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-name.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-name.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,qDAAqD;AACrD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAU,EAAE;IAC1C,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,IAAI,GAAG,CAAC;AACtD,CAAC,CAAC"}

package/dist/math/aabb/face/get-name.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/get-name.test.js

@@ -0,0 +1,13 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { getName } from "./get-name.js";
+import { POS_Z } from "./pos-z.js";
+describe("getName", () => {
+    it("returns label for known face bit", () => {
+        expect(getName(POS_Z)).toBe("POS_Z");
+    });
+    it("returns unknown placeholder for invalid value", () => {
+        expect(getName(99)).toBe("Unknown(99)");
+    });
+});
+//# sourceMappingURL=get-name.test.js.map

package/dist/math/aabb/face/get-name.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-name.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-name.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACrB,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,OAAO,CAAC,EAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/get-normal.d.ts

@@ -0,0 +1,4 @@
+import type { Vec3 } from "../../vec3/index.js";
+import type { Face } from "./face.js";
+/** Outward unit normal for a single-face bit */
+export declare const getNormal: (face: Face) => Vec3;

package/dist/math/aabb/face/get-normal.js

@@ -0,0 +1,11 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { FACE_NORMALS } from "./internals.js";
+/** Outward unit normal for a single-face bit */
+export const getNormal = (face) => {
+    const normal = FACE_NORMALS.get(face);
+    if (normal === undefined) {
+        throw new Error(`Invalid face index: ${face}`);
+    }
+    return normal;
+};
+//# sourceMappingURL=get-normal.js.map

package/dist/math/aabb/face/get-normal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-normal.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-normal.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,gDAAgD;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAQ,EAAE;IAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC"}

package/dist/math/aabb/face/get-normal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/get-normal.test.js

@@ -0,0 +1,13 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { getNormal } from "./get-normal.js";
+import { POS_Z } from "./pos-z.js";
+describe("getNormal", () => {
+    it("returns outward unit normal for a valid face", () => {
+        expect(getNormal(POS_Z)).toEqual([0, 0, 1]);
+    });
+    it("throws for invalid face index", () => {
+        expect(() => getNormal(6)).toThrow("Invalid face index: 6");
+    });
+});
+//# sourceMappingURL=get-normal.test.js.map

package/dist/math/aabb/face/get-normal.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-normal.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-normal.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/get-opposite.d.ts

@@ -0,0 +1,3 @@
+import type { Face } from "./face.js";
+/** Opposite single-face bit */
+export declare const getOpposite: (face: Face) => Face;

package/dist/math/aabb/face/get-opposite.js

@@ -0,0 +1,27 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+/** Opposite single-face bit */
+export const getOpposite = (face) => {
+    switch (face) {
+        case POS_Z:
+            return NEG_Z;
+        case NEG_Z:
+            return POS_Z;
+        case POS_X:
+            return NEG_X;
+        case NEG_X:
+            return POS_X;
+        case POS_Y:
+            return NEG_Y;
+        case NEG_Y:
+            return POS_Y;
+        default:
+            throw new Error(`Invalid face index: ${face}`);
+    }
+};
+//# sourceMappingURL=get-opposite.js.map

package/dist/math/aabb/face/get-opposite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-opposite.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-opposite.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,+BAA+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAU,EAAQ,EAAE;IAC5C,QAAQ,IAAI,EAAE,CAAC;QACX,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB,KAAK,KAAK;YACN,OAAO,KAAK,CAAC;QACjB;YACI,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACL,CAAC,CAAC"}

package/dist/math/aabb/face/get-opposite.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/math/aabb/face/get-opposite.test.js

@@ -0,0 +1,20 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { getOpposite } from "./get-opposite.js";
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+describe("getOpposite", () => {
+    it("maps each axis to its opposite", () => {
+        expect(getOpposite(POS_Z)).toBe(NEG_Z);
+        expect(getOpposite(POS_X)).toBe(NEG_X);
+        expect(getOpposite(POS_Y)).toBe(NEG_Y);
+    });
+    it("throws for invalid face index", () => {
+        expect(() => getOpposite(6)).toThrow("Invalid face index: 6");
+    });
+});
+//# sourceMappingURL=get-opposite.test.js.map

package/dist/math/aabb/face/get-opposite.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-opposite.test.js","sourceRoot":"","sources":["../../../../src/math/aabb/face/get-opposite.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/math/aabb/face/internals.d.ts

@@ -0,0 +1,6 @@
+/** Ordered single-face bits for iteration */
+export declare const FACES: readonly [number, number, number, number, number, number];
+/** Outward unit normal per single-face bit */
+export declare const FACE_NORMALS: Map<number, readonly [number, number, number]>;
+/** Debug labels per single-face bit */
+export declare const FACE_NAMES: Map<number, string>;

package/dist/math/aabb/face/internals.js

@@ -0,0 +1,34 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { NEG_X } from "./neg-x.js";
+import { NEG_Y } from "./neg-y.js";
+import { NEG_Z } from "./neg-z.js";
+import { POS_X } from "./pos-x.js";
+import { POS_Y } from "./pos-y.js";
+import { POS_Z } from "./pos-z.js";
+/** Ordered single-face bits for iteration */
+export const FACES = [POS_Z, POS_X, NEG_Z, NEG_X, POS_Y, NEG_Y];
+const NORMAL_POS_Z = [0, 0, 1];
+const NORMAL_NEG_Z = [0, 0, -1];
+const NORMAL_POS_X = [1, 0, 0];
+const NORMAL_NEG_X = [-1, 0, 0];
+const NORMAL_POS_Y = [0, 1, 0];
+const NORMAL_NEG_Y = [0, -1, 0];
+/** Outward unit normal per single-face bit */
+export const FACE_NORMALS = new Map([
+    [POS_Z, NORMAL_POS_Z],
+    [NEG_Z, NORMAL_NEG_Z],
+    [POS_X, NORMAL_POS_X],
+    [NEG_X, NORMAL_NEG_X],
+    [POS_Y, NORMAL_POS_Y],
+    [NEG_Y, NORMAL_NEG_Y],
+]);
+/** Debug labels per single-face bit */
+export const FACE_NAMES = new Map([
+    [POS_Z, "POS_Z"],
+    [POS_X, "POS_X"],
+    [NEG_Z, "NEG_Z"],
+    [NEG_X, "NEG_X"],
+    [POS_Y, "POS_Y"],
+    [NEG_Y, "NEG_Y"],
+]);
+//# sourceMappingURL=internals.js.map