@triforge/uv-core 0.1.0

package/dist/unwrappers/SmartUVProject.js

@@ -0,0 +1,212 @@
+import { BufferAttribute } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+/**
+ * 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 class SmartUVProject extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'SmartUVProject';
+        this.parameters = {
+            angleLimit: opts.angleLimit ?? 66,
+            islandMargin: opts.islandMargin ?? 0.02,
+        };
+    }
+    apply(geometry) {
+        if (!this.enabled)
+            return geometry.clone();
+        // De-index so every triangle vertex gets its own UV slot.
+        // Shared vertices in indexed geometry would get conflicting UVs
+        // when they sit on a boundary between two different projection islands.
+        const result = geometry.index ? geometry.toNonIndexed() : geometry.clone();
+        const posAttr = result.getAttribute('position');
+        const count = posAttr.count;
+        if (count % 3 !== 0)
+            return geometry.clone();
+        const angleRad = (this.parameters.angleLimit * Math.PI) / 180;
+        const cosLimit = Math.cos(angleRad);
+        const faceNormals = [];
+        // After toNonIndexed() there is no index buffer — always use flat layout
+        const getTriIndices = (t) => {
+            if (result.index) {
+                const idx = result.index.array;
+                return [idx[t * 3], idx[t * 3 + 1], idx[t * 3 + 2]];
+            }
+            return [t * 3, t * 3 + 1, t * 3 + 2];
+        };
+        const numTriangles = Math.floor(count / 3);
+        for (let t = 0; t < numTriangles; t++) {
+            const [i, j, k] = getTriIndices(t);
+            const ax = posAttr.getX(i), ay = posAttr.getY(i), az = posAttr.getZ(i);
+            const bx = posAttr.getX(j), by = posAttr.getY(j), bz = posAttr.getZ(j);
+            const cx = posAttr.getX(k), cy = posAttr.getY(k), cz = posAttr.getZ(k);
+            const ex = bx - ax, ey = by - ay, ez = bz - az;
+            const fx = cx - ax, fy = cy - ay, fz = cz - az;
+            let nx = ey * fz - ez * fy;
+            let ny = ez * fx - ex * fz;
+            let nz = ex * fy - ey * fx;
+            const len = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
+            nx /= len;
+            ny /= len;
+            nz /= len;
+            faceNormals.push({ nx, ny, nz });
+        }
+        // Step 2: greedy cluster faces into islands by normal similarity
+        const faceIsland = new Int32Array(numTriangles).fill(-1);
+        const islandNormals = [];
+        const islands = [];
+        for (let t = 0; t < numTriangles; t++) {
+            if (faceIsland[t] !== -1)
+                continue;
+            const fn = faceNormals[t];
+            // Find nearest existing island within angle limit
+            let bestIsland = -1;
+            let bestDot = cosLimit;
+            for (let g = 0; g < islandNormals.length; g++) {
+                const gn = islandNormals[g];
+                const dot = fn.nx * gn.nx + fn.ny * gn.ny + fn.nz * gn.nz;
+                if (dot > bestDot) {
+                    bestDot = dot;
+                    bestIsland = g;
+                }
+            }
+            if (bestIsland === -1) {
+                bestIsland = islands.length;
+                islands.push([]);
+                islandNormals.push({ ...fn });
+            }
+            faceIsland[t] = bestIsland;
+            islands[bestIsland].push(t);
+            // Update island average normal (running mean)
+            const gn = islandNormals[bestIsland];
+            const n = islands[bestIsland].length;
+            gn.nx = (gn.nx * (n - 1) + fn.nx) / n;
+            gn.ny = (gn.ny * (n - 1) + fn.ny) / n;
+            gn.nz = (gn.nz * (n - 1) + fn.nz) / n;
+            const len2 = Math.sqrt(gn.nx * gn.nx + gn.ny * gn.ny + gn.nz * gn.nz) || 1;
+            gn.nx /= len2;
+            gn.ny /= len2;
+            gn.nz /= len2;
+        }
+        const patches = islands.map((facesInIsland, g) => {
+            const gn = islandNormals[g];
+            // Build tangent frame for this island's normal
+            let tx = 1, ty = 0, tz = 0;
+            if (Math.abs(gn.nx) > 0.9) {
+                tx = 0;
+                ty = 1;
+                tz = 0;
+            }
+            // bitangent = normal × tangent
+            let bx = gn.ny * tz - gn.nz * ty;
+            let by = gn.nz * tx - gn.nx * tz;
+            let bz = gn.nx * ty - gn.ny * tx;
+            // re-orthogonalize tangent
+            tx = by * gn.nz - bz * gn.ny;
+            ty = bz * gn.nx - bx * gn.nz;
+            tz = bx * gn.ny - by * gn.nx;
+            const tLen = Math.sqrt(tx * tx + ty * ty + tz * tz) || 1;
+            const bLen = Math.sqrt(bx * bx + by * by + bz * bz) || 1;
+            tx /= tLen;
+            ty /= tLen;
+            tz /= tLen;
+            bx /= bLen;
+            by /= bLen;
+            bz /= bLen;
+            let minU = Infinity, maxU = -Infinity;
+            let minV = Infinity, maxV = -Infinity;
+            const faceUVs = facesInIsland.map(t => {
+                const [i, j, k] = getTriIndices(t);
+                return [i, j, k].map(vi => {
+                    const px = posAttr.getX(vi), py = posAttr.getY(vi), pz = posAttr.getZ(vi);
+                    const u = px * tx + py * ty + pz * tz;
+                    const v = px * bx + py * by + pz * bz;
+                    if (u < minU)
+                        minU = u;
+                    if (u > maxU)
+                        maxU = u;
+                    if (v < minV)
+                        minV = v;
+                    if (v > maxV)
+                        maxV = v;
+                    return [u, v];
+                });
+            });
+            return { faceUVs, minU, maxU, minV, maxV };
+        });
+        // Step 4: shelf-pack islands, then rescale to fill [0,1]²
+        const margin = this.parameters.islandMargin;
+        const totalArea = patches.reduce((s, p) => s + (p.maxU - p.minU) * (p.maxV - p.minV), 0);
+        const sqrtArea = Math.sqrt(totalArea) || 1;
+        const rects = patches.map((p, idx) => ({
+            x: 0, y: 0,
+            w: (p.maxU - p.minU) / sqrtArea,
+            h: (p.maxV - p.minV) / sqrtArea,
+            patchIdx: idx,
+        }));
+        // Sort by height descending for better shelf utilisation
+        rects.sort((a, b) => b.h - a.h);
+        let curX = 0, curY = 0, rowH = 0;
+        for (const rect of rects) {
+            if (curX + rect.w + margin > 1.0) {
+                curX = 0;
+                curY += rowH + margin;
+                rowH = 0;
+            }
+            rect.x = curX;
+            rect.y = curY;
+            if (rect.h > rowH)
+                rowH = rect.h;
+            curX += rect.w + margin;
+        }
+        // Rescale the packed layout so it fills exactly [0, 1-margin]²
+        // without this step islands can overflow [0,1] when sqrtArea < total packed extent
+        let packMaxX = 0, packMaxY = 0;
+        for (const r of rects) {
+            if (r.x + r.w > packMaxX)
+                packMaxX = r.x + r.w;
+            if (r.y + r.h > packMaxY)
+                packMaxY = r.y + r.h;
+        }
+        const scaleX = packMaxX > 0 ? (1 - margin) / packMaxX : 1;
+        const scaleY = packMaxY > 0 ? (1 - margin) / packMaxY : 1;
+        const packScale = Math.min(scaleX, scaleY); // uniform scale keeps aspect ratios
+        for (const r of rects) {
+            r.x *= packScale;
+            r.y *= packScale;
+            r.w *= packScale;
+            r.h *= packScale;
+        }
+        // Step 5: write UVs
+        const uv = new Float32Array(count * 2);
+        for (const rect of rects) {
+            const p = patches[rect.patchIdx];
+            const pW = p.maxU - p.minU || 1;
+            const pH = p.maxV - p.minV || 1;
+            const facesInIsland = islands[rect.patchIdx];
+            facesInIsland.forEach((t, fi) => {
+                const [i, j, k] = getTriIndices(t);
+                [i, j, k].forEach((vi, vl) => {
+                    const [pu, pv] = p.faceUVs[fi][vl];
+                    const u = rect.x + ((pu - p.minU) / pW) * rect.w;
+                    const v = rect.y + ((pv - p.minV) / pH) * rect.h;
+                    uv[vi * 2] = u;
+                    uv[vi * 2 + 1] = v;
+                });
+            });
+        }
+        result.setAttribute('uv', new BufferAttribute(uv, 2));
+        // Recompute smooth normals — toNonIndexed() duplicates vertices so
+        // the original smooth normals are preserved, but calling this ensures
+        // correct per-face-vertex normals if the source had none.
+        result.computeVertexNormals();
+        return result;
+    }
+}
+//# sourceMappingURL=SmartUVProject.js.map

package/dist/unwrappers/SmartUVProject.js.map

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

package/dist/unwrappers/SphereProjection.d.ts

@@ -0,0 +1,24 @@
+import { BufferGeometry } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+export interface SphereProjectionOptions {
+    /** UV scale. Default 1.0. Blender: Sphere Projection → Scale */
+    scale?: number;
+}
+/**
+ * SphereProjection — Blender UV: Sphere Projection
+ *
+ * Latitude/longitude spherical mapping.
+ * U = longitude (angle around Y-axis) → [0, 1].
+ * V = latitude  (angle from top)      → [0, 1].
+ *
+ * Best for spherical or organic shapes centered near the origin.
+ */
+export declare class SphereProjection extends BaseUnwrapper {
+    readonly unwrapType = "SphereProjection";
+    parameters: {
+        scale: number;
+    };
+    constructor(opts?: SphereProjectionOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=SphereProjection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SphereProjection.d.ts","sourceRoot":"","sources":["../../src/unwrappers/SphereProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,QAAQ,CAAC,UAAU,sBAAqB;IACxC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;gBAEjB,IAAI,GAAE,uBAA4B;IAK9C,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CAyBhD"}

package/dist/unwrappers/SphereProjection.js

@@ -0,0 +1,40 @@
+import { BufferAttribute } from 'three';
+import { BaseUnwrapper } from '../core/BaseUnwrapper.js';
+/**
+ * SphereProjection — Blender UV: Sphere Projection
+ *
+ * Latitude/longitude spherical mapping.
+ * U = longitude (angle around Y-axis) → [0, 1].
+ * V = latitude  (angle from top)      → [0, 1].
+ *
+ * Best for spherical or organic shapes centered near the origin.
+ */
+export class SphereProjection extends BaseUnwrapper {
+    constructor(opts = {}) {
+        super();
+        this.unwrapType = 'SphereProjection';
+        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 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);
+            const r = Math.sqrt(x * x + y * y + z * z) || 1;
+            const u = (Math.atan2(x, z) / (2 * Math.PI) + 0.5) / scale;
+            const v = (Math.acos(Math.max(-1, Math.min(1, y / r))) / Math.PI) / scale;
+            uv[i * 2] = u;
+            uv[i * 2 + 1] = v;
+        }
+        result.setAttribute('uv', new BufferAttribute(uv, 2));
+        return result;
+    }
+}
+//# sourceMappingURL=SphereProjection.js.map

package/dist/unwrappers/SphereProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SphereProjection.js","sourceRoot":"","sources":["../../src/unwrappers/SphereProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,eAAe,EAAE,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAOxD;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAIjD,YAAY,OAAgC,EAAE;QAC5C,KAAK,EAAE,CAAA;QAJA,eAAU,GAAG,kBAAkB,CAAA;QAKtC,IAAI,CAAC,UAAU,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAA;IAChD,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;QAC7B,MAAM,KAAK,GAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAA;QACrC,MAAM,EAAE,GAAQ,IAAI,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAE3C,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;YACzB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;YAE/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAA;YAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAA;YAEzE,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/utils/linearSolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sparse conjugate gradient solver.
+ * Solves A*x = b where A is symmetric positive semi-definite.
+ * Used by LSCM and ABF for UV parameterization.
+ *
+ * Matrix stored as adjacency list: rows[i] = Map<column, value>
+ */
+export type SparseMatrix = Map<number, number>[];
+/**
+ * Solve A*x = b using conjugate gradient.
+ * maxIter: maximum iterations (default 400)
+ * tol:     convergence tolerance (default 1e-6)
+ */
+export declare function cgSolve(A: SparseMatrix, b: Float64Array, x0?: Float64Array, maxIter?: number, tol?: number): Float64Array;
+/** Add value to sparse matrix entry (i, j). */
+export declare function sparseAdd(A: SparseMatrix, i: number, j: number, val: number): void;
+/** Create an n×n zero sparse matrix. */
+export declare function sparseZero(n: number): SparseMatrix;
+//# sourceMappingURL=linearSolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linearSolver.d.ts","sourceRoot":"","sources":["../../src/utils/linearSolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;AAmBhD;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,CAAC,EAAQ,YAAY,EACrB,CAAC,EAAQ,YAAY,EACrB,EAAE,CAAC,EAAM,YAAY,EACrB,OAAO,SAAM,EACb,GAAG,SAAW,GACb,YAAY,CAmCd;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAGlF;AAED,wCAAwC;AACxC,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAElD"}

package/dist/utils/linearSolver.js

@@ -0,0 +1,73 @@
+/**
+ * Sparse conjugate gradient solver.
+ * Solves A*x = b where A is symmetric positive semi-definite.
+ * Used by LSCM and ABF for UV parameterization.
+ *
+ * Matrix stored as adjacency list: rows[i] = Map<column, value>
+ */
+/** Multiply sparse matrix A by dense vector x, result into out. */
+function spMv(A, x, out) {
+    const n = A.length;
+    for (let i = 0; i < n; i++) {
+        let sum = 0;
+        for (const [j, val] of A[i])
+            sum += val * x[j];
+        out[i] = sum;
+    }
+}
+/** Dot product of two dense vectors. */
+function dot(a, b) {
+    let s = 0;
+    for (let i = 0; i < a.length; i++)
+        s += a[i] * b[i];
+    return s;
+}
+/**
+ * Solve A*x = b using conjugate gradient.
+ * maxIter: maximum iterations (default 400)
+ * tol:     convergence tolerance (default 1e-6)
+ */
+export function cgSolve(A, b, x0, maxIter = 400, tol = 1e-6) {
+    const n = b.length;
+    const x = x0 ? new Float64Array(x0) : new Float64Array(n);
+    const r = new Float64Array(n);
+    const p = new Float64Array(n);
+    const Ap = new Float64Array(n);
+    // r = b - A*x
+    spMv(A, x, Ap);
+    for (let i = 0; i < n; i++)
+        r[i] = b[i] - Ap[i];
+    p.set(r);
+    let rsOld = dot(r, r);
+    if (Math.sqrt(rsOld) < tol)
+        return x;
+    for (let iter = 0; iter < maxIter; iter++) {
+        spMv(A, p, Ap);
+        const pAp = dot(p, Ap);
+        if (Math.abs(pAp) < 1e-14)
+            break;
+        const alpha = rsOld / pAp;
+        for (let i = 0; i < n; i++) {
+            x[i] += alpha * p[i];
+            r[i] -= alpha * Ap[i];
+        }
+        const rsNew = dot(r, r);
+        if (Math.sqrt(rsNew) < tol)
+            break;
+        const beta = rsNew / rsOld;
+        for (let i = 0; i < n; i++)
+            p[i] = r[i] + beta * p[i];
+        rsOld = rsNew;
+    }
+    return x;
+}
+/** Add value to sparse matrix entry (i, j). */
+export function sparseAdd(A, i, j, val) {
+    const existing = A[i].get(j) ?? 0;
+    A[i].set(j, existing + val);
+}
+/** Create an n×n zero sparse matrix. */
+export function sparseZero(n) {
+    return Array.from({ length: n }, () => new Map());
+}
+//# sourceMappingURL=linearSolver.js.map

package/dist/utils/linearSolver.js.map

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

package/dist/utils/meshGraph.d.ts

@@ -0,0 +1,71 @@
+import { BufferGeometry } from 'three';
+export interface MeshGraph {
+    positions: Float32Array;
+    triangles: Uint32Array;
+    vertexCount: number;
+    triangleCount: number;
+    /** For each vertex: list of incident triangle indices */
+    vertexTriangles: number[][];
+    /** Edge "minV_maxV" -> triangle indices (1 or 2) */
+    edgeTriangles: Map<string, number[]>;
+    /** Vertex indices on the mesh boundary (edges with only 1 incident triangle) */
+    boundary: number[];
+    /** Set for fast boundary lookup */
+    boundarySet: Set<number>;
+    /**
+     * Set to true by applySeamCuts when vertices are duplicated along seams.
+     * Tells applyUVsToGeometry to de-index the output so each triangle corner
+     * gets its own UV slot (required for different UVs on each side of a seam).
+     */
+    hasSeamSplits?: boolean;
+}
+/**
+ * Build a MeshGraph from a BufferGeometry.
+ * Handles both indexed and non-indexed geometry.
+ * For non-indexed geometry, merges vertices at identical positions.
+ */
+export declare function buildMeshGraph(geometry: BufferGeometry): MeshGraph;
+/** Get the index of the vertex opposite to edge (a,b) in triangle t. */
+export declare function oppositeVertex(triangles: Uint32Array, t: number, a: number, b: number): number;
+/** Cotangent of angle at vertex opp in the triangle opp-a-b. */
+export declare function cotangentWeight(positions: Float32Array, opp: number, a: number, b: number): number;
+/** Mean-value weight for edge (i,j) at vertex i — used by ABF. */
+export declare function meanValueWeight(positions: Float32Array, i: number, j: number, opp: number): number;
+/**
+ * Apply seam cuts to a MeshGraph in-place.
+ *
+ * For each seam edge (a,b) that has two incident triangles [t0, t1]:
+ *   - Duplicates vertices a and b as new vertices a' and b'
+ *   - Rewires triangle t1 to use a' and b' instead of a and b
+ *   - Removes the shared edge and adds two free boundary edges instead
+ *   - Updates all adjacency structures (vertexTriangles, edgeTriangles, positions)
+ *
+ * After all cuts, recomputes boundary / boundarySet so the solver treats the
+ * seam edges as open boundaries and assigns independent UV coordinates on each side.
+ *
+ * Called by ConformalLSCM and AngleBasedABF when geometry.userData.seams is set.
+ */
+export declare function applySeamCuts(graph: MeshGraph, seams: Array<{
+    a: number;
+    b: number;
+}>): void;
+/**
+ * Order boundary vertices into a closed loop.
+ * Returns undefined if boundary is empty or has complex topology.
+ */
+export declare function orderBoundaryLoop(graph: MeshGraph): number[] | undefined;
+/**
+ * Copy the UV attribute from uvArray back into a clone of the source geometry.
+ * uvArray: Float32Array of length graph.vertexCount * 2
+ *
+ * Normal case (no seam splits):
+ *   - Indexed geometry: write UVs per unique vertex index.
+ *   - Non-indexed geometry: expand UVs back to per-face-vertex layout.
+ *
+ * Seam-split case (graph.hasSeamSplits === true):
+ *   The graph has duplicated vertices; graph.triangles maps each triangle corner
+ *   to a graph vertex index. We de-index the output so that each face-vertex
+ *   gets its own UV slot, enabling different UVs on each side of the seam.
+ */
+export declare function applyUVsToGeometry(source: BufferGeometry, uvArray: Float32Array, graph: MeshGraph): BufferGeometry;
+//# sourceMappingURL=meshGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meshGraph.d.ts","sourceRoot":"","sources":["../../src/utils/meshGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AAEvD,MAAM,WAAW,SAAS;IACxB,SAAS,EAAQ,YAAY,CAAA;IAC7B,SAAS,EAAQ,WAAW,CAAA;IAC5B,WAAW,EAAM,MAAM,CAAA;IACvB,aAAa,EAAI,MAAM,CAAA;IACvB,yDAAyD;IACzD,eAAe,EAAE,MAAM,EAAE,EAAE,CAAA;IAC3B,oDAAoD;IACpD,aAAa,EAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACtC,gFAAgF;IAChF,QAAQ,EAAS,MAAM,EAAE,CAAA;IACzB,mCAAmC;IACnC,WAAW,EAAM,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAG,OAAO,CAAA;CACzB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,CA0ElE;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9F;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBlG;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAelG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACrC,IAAI,CAsFN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CA+BxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,SAAS,GACf,cAAc,CAwDhB"}