@triforge/uv-core 0.1.0

package/dist/unwrappers/AngleBasedABF.js

@@ -0,0 +1,162 @@
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+import { buildMeshGraph, orderBoundaryLoop, applyUVsToGeometry, meanValueWeight, oppositeVertex, applySeamCuts, } from '../utils/meshGraph.js';
+import { cgSolve, sparseAdd, sparseZero } from '../utils/linearSolver.js';
+/**
+ * AngleBasedABF — Blender UV: Unwrap (Angle Based)
+ *
+ * Angle-Based Flattening approximation using mean-value coordinates.
+ * Minimises angle distortion better than LSCM for meshes with obtuse triangles.
+ * Uses mean-value weights instead of cotangent weights — always positive,
+ * so it handles obtuse triangles without negative weights.
+ *
+ * Works best on meshes with a natural boundary (disc topology).
+ * For closed meshes, a seam is automatically inserted between the two
+ * farthest-apart vertices.
+ */
+export class AngleBasedABF extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'AngleBasedABF';
+        this.parameters = {
+            maxIterations: opts.maxIterations ?? 400,
+            tolerance: opts.tolerance ?? 1e-6,
+        };
+    }
+    apply(geometry) {
+        if (!this.enabled)
+            return geometry.clone();
+        const graph = buildMeshGraph(geometry);
+        // Apply seam cuts before solving — treats seam edges as boundary
+        const seams = geometry.userData?.seams;
+        if (seams && seams.length > 0)
+            applySeamCuts(graph, seams);
+        const { positions, triangles, vertexCount, triangleCount, edgeTriangles } = graph;
+        if (vertexCount < 3 || triangleCount < 1)
+            return geometry.clone();
+        const { maxIterations, tolerance } = this.parameters;
+        // Identify pinned vertices
+        let pin0, pin1;
+        const boundaryLoop = orderBoundaryLoop(graph);
+        if (boundaryLoop && boundaryLoop.length >= 2) {
+            pin0 = boundaryLoop[0];
+            pin1 = boundaryLoop[Math.floor(boundaryLoop.length / 2)];
+        }
+        else {
+            pin0 = 0;
+            let maxDist = 0;
+            pin1 = 1;
+            for (let i = 1; i < vertexCount; i++) {
+                const dx = positions[i * 3] - positions[0];
+                const dy = positions[i * 3 + 1] - positions[1];
+                const dz = positions[i * 3 + 2] - positions[2];
+                const d = dx * dx + dy * dy + dz * dz;
+                if (d > maxDist) {
+                    maxDist = d;
+                    pin1 = i;
+                }
+            }
+        }
+        // Build mean-value weight map: always positive, handles obtuse triangles
+        const weights = Array.from({ length: vertexCount }, () => new Map());
+        for (const [key, tris] of edgeTriangles) {
+            const [a, b] = key.split('_').map(Number);
+            let w = 0;
+            for (const t of tris) {
+                const opp = oppositeVertex(triangles, t, a, b);
+                // Mean-value weight at vertex a for edge a→b
+                w += meanValueWeight(positions, a, b, opp);
+            }
+            w = Math.max(1e-6, w);
+            const wa = (weights[a].get(b) ?? 0) + w;
+            weights[a].set(b, wa);
+            // Symmetric: weight at b for edge b→a
+            let wb2 = 0;
+            for (const t of tris) {
+                const opp = oppositeVertex(triangles, t, a, b);
+                wb2 += meanValueWeight(positions, b, a, opp);
+            }
+            wb2 = Math.max(1e-6, wb2);
+            const wb = (weights[b].get(a) ?? 0) + wb2;
+            weights[b].set(a, wb);
+        }
+        // Map free vertex indices
+        const freeIdx = new Int32Array(vertexCount).fill(-1);
+        let numFree = 0;
+        for (let i = 0; i < vertexCount; i++) {
+            if (i !== pin0 && i !== pin1)
+                freeIdx[i] = numFree++;
+        }
+        if (numFree === 0) {
+            const uvs = new Float32Array(vertexCount * 2);
+            uvs[pin0 * 2] = 0;
+            uvs[pin0 * 2 + 1] = 0;
+            uvs[pin1 * 2] = 1;
+            uvs[pin1 * 2 + 1] = 0;
+            return applyUVsToGeometry(geometry, uvs, graph);
+        }
+        const AU = sparseZero(numFree);
+        const AV = sparseZero(numFree);
+        const bU = new Float64Array(numFree);
+        const bV = new Float64Array(numFree);
+        const pinUV = new Map([
+            [pin0, [0, 0]],
+            [pin1, [1, 0]],
+        ]);
+        for (let i = 0; i < vertexCount; i++) {
+            const fi = freeIdx[i];
+            if (fi < 0)
+                continue;
+            let diagSum = 0;
+            for (const [j, w] of weights[i]) {
+                diagSum += w;
+                const fj = freeIdx[j];
+                if (fj >= 0) {
+                    sparseAdd(AU, fi, fj, -w);
+                    sparseAdd(AV, fi, fj, -w);
+                }
+                else {
+                    const [pu, pv] = pinUV.get(j) ?? [0, 0];
+                    bU[fi] += w * pu;
+                    bV[fi] += w * pv;
+                }
+            }
+            sparseAdd(AU, fi, fi, diagSum);
+            sparseAdd(AV, fi, fi, diagSum);
+        }
+        const solU = cgSolve(AU, bU, undefined, maxIterations, tolerance);
+        const solV = cgSolve(AV, bV, undefined, maxIterations, tolerance);
+        const uvs = new Float32Array(vertexCount * 2);
+        for (let i = 0; i < vertexCount; i++) {
+            const fi = freeIdx[i];
+            if (fi >= 0) {
+                uvs[i * 2] = solU[fi];
+                uvs[i * 2 + 1] = solV[fi];
+            }
+            else {
+                const [pu, pv] = pinUV.get(i) ?? [0, 0];
+                uvs[i * 2] = pu;
+                uvs[i * 2 + 1] = pv;
+            }
+        }
+        // Remap to [0,1]
+        let minU = Infinity, maxU = -Infinity, minV = Infinity, maxV = -Infinity;
+        for (let i = 0; i < vertexCount; i++) {
+            const u = uvs[i * 2], v = uvs[i * 2 + 1];
+            if (u < minU)
+                minU = u;
+            if (u > maxU)
+                maxU = u;
+            if (v < minV)
+                minV = v;
+            if (v > maxV)
+                maxV = v;
+        }
+        const rangeU = maxU - minU || 1, rangeV = maxV - minV || 1;
+        for (let i = 0; i < vertexCount; i++) {
+            uvs[i * 2] = (uvs[i * 2] - minU) / rangeU;
+            uvs[i * 2 + 1] = (uvs[i * 2 + 1] - minV) / rangeV;
+        }
+        return applyUVsToGeometry(geometry, uvs, graph);
+    }
+}
+//# sourceMappingURL=AngleBasedABF.js.map

package/dist/unwrappers/AngleBasedABF.js.map

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

package/dist/unwrappers/ConformalLSCM.d.ts

@@ -0,0 +1,29 @@
+import { BufferGeometry } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+export interface ConformalLSCMOptions {
+    /** Maximum solver iterations. Default 400. */
+    maxIterations?: number;
+    /** Solver convergence tolerance. Default 1e-6. */
+    tolerance?: number;
+}
+/**
+ * ConformalLSCM — Blender UV: Unwrap (Conformal / LSCM)
+ *
+ * Least Squares Conformal Maps parameterization.
+ * Minimises angular distortion — angles in the UV map match the 3D mesh.
+ * Uses cotangent-weighted Laplacian with boundary conditions.
+ *
+ * Works best on meshes with a natural boundary (disc topology).
+ * For closed meshes, a seam is automatically inserted between the two
+ * farthest-apart vertices.
+ */
+export declare class ConformalLSCM extends BaseUnwrapper {
+    readonly unwrapType = "ConformalLSCM";
+    parameters: {
+        maxIterations: number;
+        tolerance: number;
+    };
+    constructor(opts?: ConformalLSCMOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=ConformalLSCM.d.ts.map

package/dist/unwrappers/ConformalLSCM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformalLSCM.d.ts","sourceRoot":"","sources":["../../src/unwrappers/ConformalLSCM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAOxD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,QAAQ,CAAC,UAAU,mBAAkB;IACrC,UAAU,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE5C,IAAI,GAAE,oBAAyB;IAQ3C,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CA6IhD"}

package/dist/unwrappers/ConformalLSCM.js

@@ -0,0 +1,165 @@
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+import { buildMeshGraph, orderBoundaryLoop, applyUVsToGeometry, cotangentWeight, oppositeVertex, applySeamCuts, } from '../utils/meshGraph.js';
+import { cgSolve, sparseAdd, sparseZero } from '../utils/linearSolver.js';
+/**
+ * ConformalLSCM — Blender UV: Unwrap (Conformal / LSCM)
+ *
+ * Least Squares Conformal Maps parameterization.
+ * Minimises angular distortion — angles in the UV map match the 3D mesh.
+ * Uses cotangent-weighted Laplacian with boundary conditions.
+ *
+ * Works best on meshes with a natural boundary (disc topology).
+ * For closed meshes, a seam is automatically inserted between the two
+ * farthest-apart vertices.
+ */
+export class ConformalLSCM extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'ConformalLSCM';
+        this.parameters = {
+            maxIterations: opts.maxIterations ?? 400,
+            tolerance: opts.tolerance ?? 1e-6,
+        };
+    }
+    apply(geometry) {
+        if (!this.enabled)
+            return geometry.clone();
+        const graph = buildMeshGraph(geometry);
+        // Apply seam cuts before solving — treats seam edges as boundary
+        const seams = geometry.userData?.seams;
+        if (seams && seams.length > 0)
+            applySeamCuts(graph, seams);
+        const { positions, triangles, vertexCount, triangleCount, edgeTriangles, vertexTriangles } = graph;
+        if (vertexCount < 3 || triangleCount < 1)
+            return geometry.clone();
+        // Build cotangent-weighted Laplacian system
+        // For each interior vertex i: sum_j w_ij * (u_j - u_i) = 0
+        // => sum_j w_ij * u_j - (sum_j w_ij) * u_i = 0
+        const { maxIterations, tolerance } = this.parameters;
+        // Identify pinned vertices (2 boundary vertices, or vertex 0 and farthest if no boundary)
+        let pin0, pin1;
+        const boundaryLoop = orderBoundaryLoop(graph);
+        if (boundaryLoop && boundaryLoop.length >= 2) {
+            pin0 = boundaryLoop[0];
+            pin1 = boundaryLoop[Math.floor(boundaryLoop.length / 2)];
+        }
+        else {
+            // Closed mesh: pin vertex 0 and farthest vertex from it
+            pin0 = 0;
+            let maxDist = 0;
+            pin1 = 1;
+            for (let i = 1; i < vertexCount; i++) {
+                const dx = positions[i * 3] - positions[0];
+                const dy = positions[i * 3 + 1] - positions[1];
+                const dz = positions[i * 3 + 2] - positions[2];
+                const d = dx * dx + dy * dy + dz * dz;
+                if (d > maxDist) {
+                    maxDist = d;
+                    pin1 = i;
+                }
+            }
+        }
+        // Build weight map: w[i][j] = cotangent weight for edge (i,j)
+        const weights = Array.from({ length: vertexCount }, () => new Map());
+        for (const [key, tris] of edgeTriangles) {
+            const [a, b] = key.split('_').map(Number);
+            let w = 0;
+            for (const t of tris) {
+                const opp = oppositeVertex(triangles, t, a, b);
+                w += cotangentWeight(positions, opp, a, b);
+            }
+            w = Math.max(0, w); // clamp negative cotangents (obtuse triangles)
+            const wa = (weights[a].get(b) ?? 0) + w;
+            const wb = (weights[b].get(a) ?? 0) + w;
+            weights[a].set(b, wa);
+            weights[b].set(a, wb);
+        }
+        // Map vertex indices to free indices (excluding pinned)
+        const freeIdx = new Int32Array(vertexCount).fill(-1);
+        let numFree = 0;
+        for (let i = 0; i < vertexCount; i++) {
+            if (i !== pin0 && i !== pin1)
+                freeIdx[i] = numFree++;
+        }
+        if (numFree === 0) {
+            // Only 2 vertices — trivial
+            const uvs = new Float32Array(vertexCount * 2);
+            uvs[pin0 * 2] = 0;
+            uvs[pin0 * 2 + 1] = 0;
+            uvs[pin1 * 2] = 1;
+            uvs[pin1 * 2 + 1] = 0;
+            return applyUVsToGeometry(geometry, uvs, graph);
+        }
+        // Build separate U and V systems
+        // A * u_free = b_u (contributions from pinned vertices go to RHS)
+        const AU = sparseZero(numFree);
+        const AV = sparseZero(numFree);
+        const bU = new Float64Array(numFree);
+        const bV = new Float64Array(numFree);
+        // Pin UV values: pin0 → (0, 0), pin1 → (1, 0)
+        const pinUV = new Map([
+            [pin0, [0, 0]],
+            [pin1, [1, 0]],
+        ]);
+        for (let i = 0; i < vertexCount; i++) {
+            const fi = freeIdx[i];
+            if (fi < 0)
+                continue; // pinned
+            let diagSum = 0;
+            for (const [j, w] of weights[i]) {
+                diagSum += w;
+                const fj = freeIdx[j];
+                if (fj >= 0) {
+                    // Free neighbor → add to A
+                    sparseAdd(AU, fi, fj, -w);
+                    sparseAdd(AV, fi, fj, -w);
+                }
+                else {
+                    // Pinned neighbor → add to RHS
+                    const [pu, pv] = pinUV.get(j) ?? [0, 0];
+                    bU[fi] += w * pu;
+                    bV[fi] += w * pv;
+                }
+            }
+            sparseAdd(AU, fi, fi, diagSum);
+            sparseAdd(AV, fi, fi, diagSum);
+        }
+        // Solve
+        const solU = cgSolve(AU, bU, undefined, maxIterations, tolerance);
+        const solV = cgSolve(AV, bV, undefined, maxIterations, tolerance);
+        // Reconstruct full UV array
+        const uvs = new Float32Array(vertexCount * 2);
+        for (let i = 0; i < vertexCount; i++) {
+            const fi = freeIdx[i];
+            if (fi >= 0) {
+                uvs[i * 2] = solU[fi];
+                uvs[i * 2 + 1] = solV[fi];
+            }
+            else {
+                const [pu, pv] = pinUV.get(i) ?? [0, 0];
+                uvs[i * 2] = pu;
+                uvs[i * 2 + 1] = pv;
+            }
+        }
+        // Remap to [0,1]
+        let minU = Infinity, maxU = -Infinity, minV = Infinity, maxV = -Infinity;
+        for (let i = 0; i < vertexCount; i++) {
+            const u = uvs[i * 2], v = uvs[i * 2 + 1];
+            if (u < minU)
+                minU = u;
+            if (u > maxU)
+                maxU = u;
+            if (v < minV)
+                minV = v;
+            if (v > maxV)
+                maxV = v;
+        }
+        const rangeU = maxU - minU || 1, rangeV = maxV - minV || 1;
+        for (let i = 0; i < vertexCount; i++) {
+            uvs[i * 2] = (uvs[i * 2] - minU) / rangeU;
+            uvs[i * 2 + 1] = (uvs[i * 2 + 1] - minV) / rangeV;
+        }
+        return applyUVsToGeometry(geometry, uvs, graph);
+    }
+}
+//# sourceMappingURL=ConformalLSCM.js.map

package/dist/unwrappers/ConformalLSCM.js.map

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

package/dist/unwrappers/CubeProjection.d.ts

@@ -0,0 +1,22 @@
+import { BufferGeometry } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+export interface CubeProjectionOptions {
+    /** UV scale. Default 1.0. Blender: Cube Projection → Scale */
+    scale?: number;
+}
+/**
+ * CubeProjection — Blender UV: Cube Projection
+ *
+ * Projects UVs from the dominant face normal direction.
+ * Each vertex is mapped to one of 6 cube faces based on its normal.
+ * Good for blocky/hard-surface geometry with clear face orientations.
+ */
+export declare class CubeProjection extends BaseUnwrapper {
+    readonly unwrapType = "CubeProjection";
+    parameters: {
+        scale: number;
+    };
+    constructor(opts?: CubeProjectionOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=CubeProjection.d.ts.map

package/dist/unwrappers/CubeProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CubeProjection.d.ts","sourceRoot":"","sources":["../../src/unwrappers/CubeProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,UAAU,oBAAmB;IACtC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEjB,IAAI,GAAE,qBAA0B;IAK5C,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CA4ChD"}

package/dist/unwrappers/CubeProjection.js

@@ -0,0 +1,57 @@
+import { BufferAttribute } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+/**
+ * CubeProjection — Blender UV: Cube Projection
+ *
+ * Projects UVs from the dominant face normal direction.
+ * Each vertex is mapped to one of 6 cube faces based on its normal.
+ * Good for blocky/hard-surface geometry with clear face orientations.
+ */
+export class CubeProjection extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'CubeProjection';
+        this.parameters = { scale: opts.scale ?? 1.0 };
+    }
+    apply(geometry) {
+        if (!this.enabled)
+            return geometry.clone();
+        const result = geometry.clone();
+        const posAttr = result.getAttribute('position');
+        const nrmAttr = result.getAttribute('normal');
+        const count = posAttr.count;
+        const scale = this.parameters.scale;
+        const uv = new Float32Array(count * 2);
+        for (let i = 0; i < count; i++) {
+            const x = posAttr.getX(i);
+            const y = posAttr.getY(i);
+            const z = posAttr.getZ(i);
+            // Use normal if available, else use position as approximation
+            const nx = nrmAttr ? nrmAttr.getX(i) : x;
+            const ny = nrmAttr ? nrmAttr.getY(i) : y;
+            const nz = nrmAttr ? nrmAttr.getZ(i) : z;
+            const ax = Math.abs(nx), ay = Math.abs(ny), az = Math.abs(nz);
+            let u, v;
+            if (ax >= ay && ax >= az) {
+                // X-dominant face
+                u = nx > 0 ? -z : z;
+                v = y;
+            }
+            else if (ay >= ax && ay >= az) {
+                // Y-dominant face
+                u = x;
+                v = ny > 0 ? z : -z;
+            }
+            else {
+                // Z-dominant face
+                u = nz > 0 ? x : -x;
+                v = y;
+            }
+            uv[i * 2] = (u / scale) * 0.5 + 0.5;
+            uv[i * 2 + 1] = (v / scale) * 0.5 + 0.5;
+        }
+        result.setAttribute('uv', new BufferAttribute(uv, 2));
+        return result;
+    }
+}
+//# sourceMappingURL=CubeProjection.js.map

package/dist/unwrappers/CubeProjection.js.map

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

package/dist/unwrappers/CylinderProjection.d.ts

@@ -0,0 +1,25 @@
+import { BufferGeometry } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+export interface CylinderProjectionOptions {
+    /** UV scale along the circumference. Default 1.0. */
+    scaleU?: number;
+    /** UV scale along the cylinder axis. Default 1.0. */
+    scaleV?: number;
+}
+/**
+ * CylinderProjection — Blender UV: Cylinder Projection
+ *
+ * Wraps UVs around the Y-axis.
+ * U = angle around Y-axis mapped to [0,1].
+ * V = normalised height along Y-axis.
+ */
+export declare class CylinderProjection extends BaseUnwrapper {
+    readonly unwrapType = "CylinderProjection";
+    parameters: {
+        scaleU: number;
+        scaleV: number;
+    };
+    constructor(opts?: CylinderProjectionOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=CylinderProjection.d.ts.map

package/dist/unwrappers/CylinderProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CylinderProjection.d.ts","sourceRoot":"","sources":["../../src/unwrappers/CylinderProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,WAAW,yBAAyB;IACxC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,QAAQ,CAAC,UAAU,wBAAuB;IAC1C,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;gBAElC,IAAI,GAAE,yBAA8B;IAQhD,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CAkChD"}

package/dist/unwrappers/CylinderProjection.js

@@ -0,0 +1,50 @@
+import { BufferAttribute } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+/**
+ * CylinderProjection — Blender UV: Cylinder Projection
+ *
+ * Wraps UVs around the Y-axis.
+ * U = angle around Y-axis mapped to [0,1].
+ * V = normalised height along Y-axis.
+ */
+export class CylinderProjection extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'CylinderProjection';
+        this.parameters = {
+            scaleU: opts.scaleU ?? 1.0,
+            scaleV: opts.scaleV ?? 1.0,
+        };
+    }
+    apply(geometry) {
+        if (!this.enabled)
+            return geometry.clone();
+        const result = geometry.clone();
+        const posAttr = result.getAttribute('position');
+        const count = posAttr.count;
+        // Find Y extents
+        let yMin = Infinity, yMax = -Infinity;
+        for (let i = 0; i < count; i++) {
+            const y = posAttr.getY(i);
+            if (y < yMin)
+                yMin = y;
+            if (y > yMax)
+                yMax = y;
+        }
+        const yRange = yMax - yMin || 1;
+        const { scaleU, scaleV } = this.parameters;
+        const uv = new Float32Array(count * 2);
+        for (let i = 0; i < count; i++) {
+            const x = posAttr.getX(i);
+            const y = posAttr.getY(i);
+            const z = posAttr.getZ(i);
+            const u = (Math.atan2(x, z) / (2 * Math.PI) + 0.5) / scaleU;
+            const v = ((y - yMin) / yRange) / scaleV;
+            uv[i * 2] = u;
+            uv[i * 2 + 1] = v;
+        }
+        result.setAttribute('uv', new BufferAttribute(uv, 2));
+        return result;
+    }
+}
+//# sourceMappingURL=CylinderProjection.js.map

package/dist/unwrappers/CylinderProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CylinderProjection.js","sourceRoot":"","sources":["../../src/unwrappers/CylinderProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,eAAe,EAAE,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AASxD;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IAInD,YAAY,OAAkC,EAAE;QAC9C,KAAK,EAAE,CAAA;QAJA,eAAU,GAAG,oBAAoB,CAAA;QAKxC,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,GAAG;SAC3B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAwB;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAA;QAE1C,MAAM,MAAM,GAAI,QAAQ,CAAC,KAAK,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAoB,CAAA;QAClE,MAAM,KAAK,GAAK,OAAO,CAAC,KAAK,CAAA;QAE7B,iBAAiB;QACjB,IAAI,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAA;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACzB,IAAI,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAA;YACtB,IAAI,CAAC,GAAG,IAAI;gBAAE,IAAI,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,CAAC,CAAA;QAE/B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAEzB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAA;YAC3D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,GAAsB,MAAM,CAAA;YAE3D,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAO,CAAC,CAAA;YACjB,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QACrD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/unwrappers/SmartUVProject.d.ts

@@ -0,0 +1,30 @@
+import { BufferGeometry } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+export interface SmartUVProjectOptions {
+    /**
+     * Maximum angle (degrees) between face normals for them to be grouped
+     * into the same projection island. Default 66. Blender: Smart UV Project → Angle Limit.
+     */
+    angleLimit?: number;
+    /** Margin between islands in UV space [0–0.1]. Default 0.02. Blender: Island Margin */
+    islandMargin?: number;
+}
+/**
+ * SmartUVProject — Blender UV: Smart UV Project
+ *
+ * Clusters faces by normal direction (within angleLimit degrees),
+ * projects each cluster onto its average normal plane,
+ * then packs all islands into UV [0,1]² space.
+ *
+ * Good for hard-surface models with mixed orientations.
+ */
+export declare class SmartUVProject extends BaseUnwrapper {
+    readonly unwrapType = "SmartUVProject";
+    parameters: {
+        angleLimit: number;
+        islandMargin: number;
+    };
+    constructor(opts?: SmartUVProjectOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=SmartUVProject.d.ts.map

package/dist/unwrappers/SmartUVProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmartUVProject.d.ts","sourceRoot":"","sources":["../../src/unwrappers/SmartUVProject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,QAAQ,CAAC,UAAU,oBAAmB;IACtC,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;gBAE5C,IAAI,GAAE,qBAA0B;IAQ5C,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CA2MhD"}