@adobe/data 0.8.4 → 0.8.6

package/dist/math/aabb-face/constants/functions.js

@@ -0,0 +1,148 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+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.*/
+import { Aabb as AabbNamespace } from "../../aabb/index.js";
+/**
+ * AABB face direction constants for cube faces (as bit flags)
+ */
+export const POS_Z = 1 << 0; // 1
+export const POS_X = 1 << 1; // 2
+export const NEG_Z = 1 << 2; // 4
+export const NEG_X = 1 << 3; // 8
+export const POS_Y = 1 << 4; // 16
+export const NEG_Y = 1 << 5; // 32
+export const ALL = POS_Z | POS_X | NEG_Z | NEG_X | POS_Y | NEG_Y;
+export const NONE = 0;
+const FACES = [POS_Z, POS_X, NEG_Z, NEG_X, POS_Y, NEG_Y];
+/**
+ * AABB face direction names for debugging/logging
+ */
+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'],
+]);
+/**
+ * Get the AABB face name for debugging/logging
+ */
+export const getName = (face) => {
+    return FACE_NAMES.get(face) ?? `Unknown(${face})`;
+};
+/**
+ * Get the normal vector for a given AABB face
+ */
+export const getNormal = (face) => {
+    switch (face) {
+        case POS_Z: return [0, 0, 1];
+        case NEG_Z: return [0, 0, -1];
+        case POS_X: return [1, 0, 0];
+        case NEG_X: return [-1, 0, 0];
+        case POS_Y: return [0, 1, 0];
+        case NEG_Y: return [0, -1, 0];
+        default: throw new Error(`Invalid face index: ${face}`);
+    }
+};
+export function* getFaces(face) {
+    for (const f of FACES) {
+        if (face & f) {
+            yield f;
+        }
+    }
+}
+/**
+ * Get the opposite AABB face
+ */
+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}`);
+    }
+};
+/**
+ * Check if two AABB faces are opposite
+ */
+export const isOpposite = (face1, face2) => {
+    return getOpposite(face1) === face2;
+};
+/**
+ * Get all AABB faces adjacent to the given face (faces that share an edge)
+ */
+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}`);
+    }
+};
+/**
+ * Check if two AABB faces are adjacent (share an edge)
+ */
+export const isAdjacent = (face1, face2) => {
+    return getAdjacent(face1).includes(face2);
+};
+/**
+ * Determines which AABB face a position is closest to.
+ * Assumes the position is in normalized coordinate space - a cube with size 1 centered on the origin.
+ * @param position World position of the intersection point
+ * @param aabb Bounding box of the cube
+ * @returns AabbFace flag: 1=POS_Z, 2=POS_X, 4=NEG_Z, 8=NEG_X, 16=POS_Y, 32=NEG_Y
+ */
+export const fromPosition = (position, aabb = AabbNamespace.unit) => {
+    const aabbCenter = AabbNamespace.center(aabb);
+    const localPos = [
+        position[0] - aabbCenter[0],
+        position[1] - aabbCenter[1],
+        position[2] - aabbCenter[2]
+    ];
+    // Find the face with the largest absolute coordinate (closest to cube surface)
+    const absX = Math.abs(localPos[0]);
+    const absY = Math.abs(localPos[1]);
+    const absZ = Math.abs(localPos[2]);
+    if (absX >= absY && absX >= absZ) {
+        // X-axis face (NEG_X or POS_X)
+        return localPos[0] > 0 ? POS_X : NEG_X;
+    }
+    else if (absY >= absZ) {
+        // Y-axis face (NEG_Y or POS_Y)
+        return localPos[1] > 0 ? POS_Y : NEG_Y;
+    }
+    else {
+        // Z-axis face (NEG_Z or POS_Z)
+        return localPos[2] > 0 ? POS_Z : NEG_Z;
+    }
+};
+//# sourceMappingURL=functions.js.map

package/dist/math/aabb-face/constants/functions.js.map

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

package/dist/math/aabb-face/constants/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./functions.js";
+export * from "./schema.js";

package/dist/math/aabb-face/constants/index.js

@@ -0,0 +1,24 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+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.*/
+export * from "./functions.js";
+export * from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/math/aabb-face/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/math/aabb-face/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/math/aabb-face/constants/schema.d.ts

@@ -0,0 +1,5 @@
+export declare const schema: {
+    readonly type: "number";
+    readonly minimum: 1;
+    readonly maximum: 63;
+};

package/dist/math/aabb-face/constants/schema.js

@@ -0,0 +1,27 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+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.*/
+export const schema = {
+    type: 'number',
+    minimum: 1,
+    maximum: 63,
+};
+//# sourceMappingURL=schema.js.map

package/dist/math/aabb-face/constants/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/math/aabb-face/constants/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAIX,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,EAAE;CACY,CAAC"}

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

@@ -0,0 +1,51 @@
+import { FromSchema } from "../../schema/index.js";
+import { Vec3 } from "../index.js";
+export declare const schema: {
+    readonly type: "number";
+    readonly minimum: 0;
+    readonly maximum: 5;
+};
+export type Type = FromSchema<typeof schema>;
+type Face = Type;
+/**
+ * Face direction constants for cube faces
+ */
+export declare const POS_Z: 0;
+export declare const POS_X: 1;
+export declare const NEG_Z: 2;
+export declare const NEG_X: 3;
+export declare const POS_Y: 4;
+export declare const NEG_Y: 5;
+/**
+ * Array of all face directions
+ */
+export declare const ALL_FACES: readonly [0, 1, 2, 3, 4, 5];
+/**
+ * Face direction names for debugging/logging
+ */
+export declare const FACE_NAMES: readonly ["POS_Z", "POS_X", "NEG_Z", "NEG_X", "POS_Y", "NEG_Y"];
+/**
+ * Get the face name for debugging/logging
+ */
+export declare const getName: (face: Face) => string;
+/**
+ * Get the normal vector for a given face
+ */
+export declare const getNormal: (face: Face) => Vec3;
+/**
+ * Get the opposite face
+ */
+export declare const getOpposite: (face: Face) => Face;
+/**
+ * Check if two faces are opposite
+ */
+export declare const isOpposite: (face1: Face, face2: Face) => boolean;
+/**
+ * Get all faces adjacent to the given face (faces that share an edge)
+ */
+export declare const getAdjacent: (face: Face) => readonly Face[];
+/**
+ * Check if two faces are adjacent (share an edge)
+ */
+export declare const isAdjacent: (face1: Face, face2: Face) => boolean;
+export {};

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

@@ -0,0 +1,110 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+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.*/
+export const schema = {
+    type: 'number',
+    minimum: 0,
+    maximum: 5,
+};
+/**
+ * Face direction constants for cube faces
+ */
+export const POS_Z = 0;
+export const POS_X = 1;
+export const NEG_Z = 2;
+export const NEG_X = 3;
+export const POS_Y = 4;
+export const NEG_Y = 5;
+/**
+ * Array of all face directions
+ */
+export const ALL_FACES = [POS_Z, POS_X, NEG_Z, NEG_X, POS_Y, NEG_Y];
+/**
+ * Face direction names for debugging/logging
+ */
+export const FACE_NAMES = [
+    'POS_Z', 'POS_X', 'NEG_Z', 'NEG_X', 'POS_Y', 'NEG_Y'
+];
+/**
+ * Get the face name for debugging/logging
+ */
+export const getName = (face) => {
+    return FACE_NAMES[face];
+};
+/**
+ * Get the normal vector for a given face
+ */
+export const getNormal = (face) => {
+    switch (face) {
+        case POS_Z: return [0, 0, 1];
+        case NEG_Z: return [0, 0, -1];
+        case POS_X: return [1, 0, 0];
+        case NEG_X: return [-1, 0, 0];
+        case POS_Y: return [0, 1, 0];
+        case NEG_Y: return [0, -1, 0];
+        default: throw new Error(`Invalid face index: ${face}`);
+    }
+};
+/**
+ * Get the opposite face
+ */
+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}`);
+    }
+};
+/**
+ * Check if two faces are opposite
+ */
+export const isOpposite = (face1, face2) => {
+    return getOpposite(face1) === face2;
+};
+/**
+ * Get all faces adjacent to the given face (faces that share an edge)
+ */
+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}`);
+    }
+};
+/**
+ * Check if two faces are adjacent (share an edge)
+ */
+export const isAdjacent = (face1, face2) => {
+    return getAdjacent(face1).includes(face2);
+};
+//# 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":"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"}

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

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

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

@@ -0,0 +1,94 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+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.*/
+import { describe, it, expect } from 'vitest';
+import * as Face from './face.js';
+describe('Face', () => {
+    it('should have correct constants', () => {
+        expect(Face.POS_Z).toBe(0);
+        expect(Face.POS_X).toBe(1);
+        expect(Face.NEG_Z).toBe(2);
+        expect(Face.NEG_X).toBe(3);
+        expect(Face.POS_Y).toBe(4);
+        expect(Face.NEG_Y).toBe(5);
+    });
+    it('should get correct face names', () => {
+        expect(Face.getName(Face.POS_Z)).toBe('POS_Z');
+        expect(Face.getName(Face.POS_X)).toBe('POS_X');
+        expect(Face.getName(Face.NEG_Z)).toBe('NEG_Z');
+        expect(Face.getName(Face.NEG_X)).toBe('NEG_X');
+        expect(Face.getName(Face.POS_Y)).toBe('POS_Y');
+        expect(Face.getName(Face.NEG_Y)).toBe('NEG_Y');
+    });
+    it('should get correct normal vectors', () => {
+        expect(Face.getNormal(Face.POS_Z)).toEqual([0, 0, 1]);
+        expect(Face.getNormal(Face.NEG_Z)).toEqual([0, 0, -1]);
+        expect(Face.getNormal(Face.POS_X)).toEqual([1, 0, 0]);
+        expect(Face.getNormal(Face.NEG_X)).toEqual([-1, 0, 0]);
+        expect(Face.getNormal(Face.POS_Y)).toEqual([0, 1, 0]);
+        expect(Face.getNormal(Face.NEG_Y)).toEqual([0, -1, 0]);
+    });
+    it('should get correct opposite faces', () => {
+        expect(Face.getOpposite(Face.POS_Z)).toBe(Face.NEG_Z);
+        expect(Face.getOpposite(Face.NEG_Z)).toBe(Face.POS_Z);
+        expect(Face.getOpposite(Face.POS_X)).toBe(Face.NEG_X);
+        expect(Face.getOpposite(Face.NEG_X)).toBe(Face.POS_X);
+        expect(Face.getOpposite(Face.POS_Y)).toBe(Face.NEG_Y);
+        expect(Face.getOpposite(Face.NEG_Y)).toBe(Face.POS_Y);
+    });
+    it('should correctly identify opposite faces', () => {
+        expect(Face.isOpposite(Face.POS_Z, Face.NEG_Z)).toBe(true);
+        expect(Face.isOpposite(Face.POS_X, Face.NEG_X)).toBe(true);
+        expect(Face.isOpposite(Face.POS_Y, Face.NEG_Y)).toBe(true);
+        expect(Face.isOpposite(Face.POS_Z, Face.POS_X)).toBe(false);
+        expect(Face.isOpposite(Face.POS_Z, Face.POS_Z)).toBe(false);
+    });
+    it('should get correct adjacent faces', () => {
+        const posZAdjacent = Face.getAdjacent(Face.POS_Z);
+        expect(posZAdjacent).toContain(Face.POS_X);
+        expect(posZAdjacent).toContain(Face.NEG_X);
+        expect(posZAdjacent).toContain(Face.POS_Y);
+        expect(posZAdjacent).toContain(Face.NEG_Y);
+        expect(posZAdjacent).not.toContain(Face.NEG_Z);
+        expect(posZAdjacent).not.toContain(Face.POS_Z);
+        const posXAdjacent = Face.getAdjacent(Face.POS_X);
+        expect(posXAdjacent).toContain(Face.POS_Z);
+        expect(posXAdjacent).toContain(Face.NEG_Z);
+        expect(posXAdjacent).toContain(Face.POS_Y);
+        expect(posXAdjacent).toContain(Face.NEG_Y);
+        expect(posXAdjacent).not.toContain(Face.NEG_X);
+        expect(posXAdjacent).not.toContain(Face.POS_X);
+    });
+    it('should correctly identify adjacent faces', () => {
+        expect(Face.isAdjacent(Face.POS_Z, Face.POS_X)).toBe(true);
+        expect(Face.isAdjacent(Face.POS_Z, Face.NEG_X)).toBe(true);
+        expect(Face.isAdjacent(Face.POS_Z, Face.POS_Y)).toBe(true);
+        expect(Face.isAdjacent(Face.POS_Z, Face.NEG_Y)).toBe(true);
+        expect(Face.isAdjacent(Face.POS_Z, Face.NEG_Z)).toBe(false);
+        expect(Face.isAdjacent(Face.POS_Z, Face.POS_Z)).toBe(false);
+    });
+    it('should throw error for invalid face indices', () => {
+        expect(() => Face.getNormal(6)).toThrow('Invalid face index: 6');
+        expect(() => Face.getOpposite(6)).toThrow('Invalid face index: 6');
+        expect(() => Face.getAdjacent(6)).toThrow('Invalid face index: 6');
+    });
+});
+//# sourceMappingURL=face.test.js.map

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

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

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

@@ -0,0 +1,47 @@
+import type { AabbFace } from "./index.js";
+import type { Vec3 } from "../vec3/index.js";
+import type { Aabb } from "../aabb/index.js";
+/**
+ * AABB face direction constants for cube faces (as bit flags)
+ */
+export declare const POS_Z: number;
+export declare const POS_X: number;
+export declare const NEG_Z: number;
+export declare const NEG_X: number;
+export declare const POS_Y: number;
+export declare const NEG_Y: number;
+export declare const ALL: number;
+export declare const NONE = 0;
+/**
+ * Get the AABB face name for debugging/logging
+ */
+export declare const getName: (face: AabbFace) => string;
+/**
+ * Get the normal vector for a given AABB face
+ */
+export declare const getNormal: (face: AabbFace) => Vec3;
+export declare function getFaces(face: AabbFace): IterableIterator<AabbFace>;
+/**
+ * Get the opposite AABB face
+ */
+export declare const getOpposite: (face: AabbFace) => AabbFace;
+/**
+ * Check if two AABB faces are opposite
+ */
+export declare const isOpposite: (face1: AabbFace, face2: AabbFace) => boolean;
+/**
+ * Get all AABB faces adjacent to the given face (faces that share an edge)
+ */
+export declare const getAdjacent: (face: AabbFace) => readonly AabbFace[];
+/**
+ * Check if two AABB faces are adjacent (share an edge)
+ */
+export declare const isAdjacent: (face1: AabbFace, face2: AabbFace) => boolean;
+/**
+ * Determines which AABB face a position is closest to.
+ * Assumes the position is in normalized coordinate space - a cube with size 1 centered on the origin.
+ * @param position World position of the intersection point
+ * @param aabb Bounding box of the cube
+ * @returns AabbFace flag: 1=POS_Z, 2=POS_X, 4=NEG_Z, 8=NEG_X, 16=POS_Y, 32=NEG_Y
+ */
+export declare const fromPosition: (position: Vec3, aabb?: Aabb) => AabbFace;