@visant/extrude3d 0.1.0

package/README.md

@@ -0,0 +1,126 @@
+# @visant/extrude3d
+
+**SVG / text → extruded 3D geometry**, in pure [three.js](https://threejs.org). Parse an SVG (or opentype.js glyphs) into shapes, extrude them with bevel / curve / smoothness controls, smooth crease normals, project triplanar UVs, center + scale — then either hand the `BufferGeometry` to your renderer or serialize it to a binary glTF (`.glb`).
+
+No React, no [@react-three](https://github.com/pmndrs/react-three-fiber). Just functions over three.js objects, so the same code runs in the browser and in plain Node.
+
+It powers the Visant Labs Studio3D engine (the `useExtrudedGeometry` hook and `<ExtrudedSVG>` component are thin wrappers around this) and the server-side GLB export.
+
+## Install
+
+```bash
+npm i @visant/extrude3d three
+# optional — only if you use textToSvg():
+npm i opentype.js
+```
+
+`three` is a peer dependency. `opentype.js` is an **optional** peer — this package never imports it; `textToSvg` takes any font object that structurally matches `OpenTypeFontLike`.
+
+> The browser geometry path uses `three/examples/jsm` (`SVGLoader`, `BufferGeometryUtils`). The `./glb` path is DOM-free except that `SVGLoader` needs a `DOMParser` — in Node, install one (e.g. via `jsdom`) on `globalThis` before calling.
+
+## Quick start
+
+### Browser: SVG → BufferGeometry
+
+```ts
+import { buildExtrudedGeometry } from '@visant/extrude3d';
+import * as THREE from 'three';
+
+const result = buildExtrudedGeometry(svgString, {
+  depth: 2,        // extrusion depth knob
+  smoothness: 0.5, // 0–1 → bevel segments + curve subdivisions
+  bevelEnabled: true,
+});
+
+if (result) {
+  const mesh = new THREE.Mesh(
+    result.geometry,
+    new THREE.MeshStandardMaterial({ color: '#c0c0c0' })
+  );
+  // center + fit to a 4-unit box, matching the Studio3D engine:
+  mesh.position.set(-result.center.x, -result.center.y, -result.center.z);
+  mesh.scale.setScalar(result.baseScale);
+
+  // you own the geometry — dispose when done:
+  // result.geometry.dispose();
+}
+```
+
+### Node: SVG → GLB buffer
+
+```ts
+import { svgToGlb } from '@visant/extrude3d/glb';
+import { JSDOM } from 'jsdom';
+import { writeFile } from 'node:fs/promises';
+
+// SVGLoader needs a DOMParser in Node:
+globalThis.DOMParser = new JSDOM('').window.DOMParser;
+
+const { glb } = svgToGlb(svgString, {
+  depth: 0.9,
+  smoothness: 0.5,
+  color: '#c0c0c0',
+  metalness: 0.6,
+  roughness: 0.3,
+});
+
+await writeFile('logo.glb', glb); // glb is a Uint8Array (glTF magic header)
+```
+
+### Text → SVG → geometry
+
+```ts
+import * as opentype from 'opentype.js';
+import { textToSvg, buildExtrudedGeometry } from '@visant/extrude3d';
+
+const font = opentype.parse(fontArrayBuffer);
+const svg = textToSvg('Visant', font);      // centered 200×200 SVG of glyph paths
+const result = buildExtrudedGeometry(svg, { depth: 2, smoothness: 0.6 });
+```
+
+### Material presets
+
+```ts
+import { getSimpleMaterialProps, materialPresets } from '@visant/extrude3d/materials';
+
+// flat prop bag for a <meshPhysicalMaterial>:
+const props = getSimpleMaterialProps('chrome', '#ff0066');
+// → { color, metalness, roughness, clearcoat, transmission, ior, ... }
+```
+
+## Exports
+
+| Entry | Purpose |
+| --- | --- |
+| `.` | everything below, flat |
+| `./materials` | PBR preset library (`materialPresets`, `MATERIAL_LIB`, `getSimpleMaterialProps`, `resolveMaterial`) |
+| `./fonts` | `textToSvg(text, font)` — opentype glyphs → centered SVG |
+| `./glb` | `svgToGlb(svg, opts)` — dependency-free binary glTF serializer |
+
+### Geometry API
+
+| Export | Signature |
+| --- | --- |
+| `buildExtrudedGeometry` | `(svg \| Shape[], opts) => { geometry, center, baseScale, shapeCount } \| null` |
+| `parseShapesFromSVG` | `(svg) => THREE.Shape[]` — SVGLoader fills + tessellated strokes, drops the viewBox rect |
+| `buildExtrudeSettings` | `(maxFlatDim, shapeCount, opts) => ExtrudeSettings` — the engine's depth/bevel/segment math |
+| `measureFlatMaxDim` | `(shapes) => number` — larger of flat width/height (≥ 1) |
+| `smoothCreaseNormals` | `(geometry, creaseAngleRad) => BufferGeometry` — averages normals below the crease angle |
+| `recomputeTriplanarUVs` | `(geometry, box3) => void` — box-projected UVs, in place |
+
+## Options
+
+`buildExtrudedGeometry(svg, opts)`:
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `depth` | — | extrusion depth knob (scaled by flat bounds) |
+| `smoothness` | — | 0–1 → bevel segments (`4 + s·8`) + curve subdivisions (`32 + s·64`) |
+| `bevelEnabled` | `true` | |
+| `bevelThickness` / `bevelSize` | `0.5` | scaled by `min(maxFlatDim·0.05, 1)`, clamped to half the depth |
+| `vertexBudget` | `600000` | total vertex budget; segment counts shrink to fit |
+| `creaseAngle` | `Math.PI/6` | crease-smoothing threshold; `null` → plain `computeVertexNormals` |
+
+## License
+
+MIT

package/dist/fonts.d.ts

@@ -0,0 +1,14 @@
+import type { OpenTypeFontLike } from './types.js';
+/**
+ * Render `text` with an opentype.js font into a centered, auto-fitted SVG
+ * string whose `<path>` glyphs are ready for {@link buildExtrudedGeometry}.
+ *
+ * The font is fitted into a 200×200 viewBox (10px padding), shrinking the font
+ * size in 4px steps until it fits, then centered. Per-glyph kerning is applied.
+ * Returns `''` for empty/whitespace-only text or on any failure.
+ *
+ * Pure: the caller supplies an already-loaded font object (this package never
+ * imports or depends on `opentype.js`).
+ */
+export declare function textToSvg(text: string, font: OpenTypeFontLike): string;
+//# sourceMappingURL=fonts.d.ts.map

package/dist/fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../src/fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAOtE"}

package/dist/fonts.js

@@ -0,0 +1,62 @@
+/**
+ * Render `text` with an opentype.js font into a centered, auto-fitted SVG
+ * string whose `<path>` glyphs are ready for {@link buildExtrudedGeometry}.
+ *
+ * The font is fitted into a 200×200 viewBox (10px padding), shrinking the font
+ * size in 4px steps until it fits, then centered. Per-glyph kerning is applied.
+ * Returns `''` for empty/whitespace-only text or on any failure.
+ *
+ * Pure: the caller supplies an already-loaded font object (this package never
+ * imports or depends on `opentype.js`).
+ */
+export function textToSvg(text, font) {
+    try {
+        return _textToSvg(text, font);
+    }
+    catch (err) {
+        console.warn('textToSvg failed:', err);
+        return '';
+    }
+}
+function _textToSvg(text, font) {
+    const size = 200;
+    const available = size - 20;
+    let fontSize = 180;
+    let fullPath = font.getPath(text, 0, 0, fontSize);
+    let bb = fullPath.getBoundingBox();
+    let w = bb.x2 - bb.x1;
+    let h = bb.y2 - bb.y1;
+    while ((w > available || h > available) && fontSize > 8) {
+        fontSize -= 4;
+        fullPath = font.getPath(text, 0, 0, fontSize);
+        bb = fullPath.getBoundingBox();
+        w = bb.x2 - bb.x1;
+        h = bb.y2 - bb.y1;
+    }
+    const offsetX = (size - w) / 2 - bb.x1;
+    const offsetY = (size - h) / 2 - bb.y1;
+    const glyphs = font.stringToGlyphs(text);
+    let x = offsetX;
+    const paths = [];
+    const unitsPerEm = font.unitsPerEm || 1000;
+    for (let i = 0; i < glyphs.length; i++) {
+        const glyph = glyphs[i];
+        const glyphPath = glyph.getPath(x, offsetY, fontSize);
+        const d = glyphPath.toPathData(2);
+        if (d) {
+            paths.push(`<path d="${d}" fill="black" fill-rule="evenodd"/>`);
+        }
+        const advance = (glyph.advanceWidth || 0) * (fontSize / unitsPerEm);
+        if (i < glyphs.length - 1) {
+            const kerning = font.getKerningValue(glyphs[i], glyphs[i + 1]);
+            x += advance + kerning * (fontSize / unitsPerEm);
+        }
+        else {
+            x += advance;
+        }
+    }
+    if (paths.length === 0)
+        return '';
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 ${size} ${size}">${paths.join('')}</svg>`;
+}
+//# sourceMappingURL=fonts.js.map

package/dist/fonts.js.map

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

package/dist/geometry.d.ts

@@ -0,0 +1,64 @@
+import * as THREE from 'three';
+import type { BuildExtrudedGeometryOptions, ExtrudedGeometryResult } from './types.js';
+/**
+ * Average face normals within a vertex's coincident group when the angle
+ * between them is below `creaseAngleRad` (sharp edges above it stay crisp).
+ * Falls back to `computeVertexNormals` past {@link SMOOTH_VERTEX_LIMIT} verts.
+ * Returns a new, non-indexed geometry (the input is left untouched).
+ */
+export declare function smoothCreaseNormals(geometry: THREE.BufferGeometry, creaseAngleRad: number): THREE.BufferGeometry;
+/**
+ * Recompute box-projected (triplanar) UVs in place, projecting each vertex onto
+ * the axis plane that best matches its normal and normalizing by the bounding
+ * box's largest dimension.
+ */
+export declare function recomputeTriplanarUVs(geo: THREE.BufferGeometry, bb: THREE.Box3): void;
+/**
+ * True when `shape` is (approximately) the SVG's full viewBox rectangle — used
+ * to drop background rects that SVGLoader emits as a fill shape.
+ */
+export declare function isViewBoxRect(shape: THREE.Shape, vbW: number, vbH: number): boolean;
+/**
+ * Parse an SVG string into three.js `Shape`s ready for extrusion. Fills become
+ * shapes directly (dropping the viewBox-sized background rect); strokes are
+ * tessellated into a ribbon polygon of `strokeWidth`; paths with no explicit
+ * fill/stroke fall back to fill shapes.
+ *
+ * Accepts both whitespace- and comma-separated viewBox values.
+ */
+export declare function parseShapesFromSVG(svgString: string): THREE.Shape[];
+/** Three.js ExtrudeGeometry settings, derived from the engine's knobs. */
+export interface ExtrudeSettings {
+    depth: number;
+    bevelEnabled: boolean;
+    bevelThickness: number;
+    bevelSize: number;
+    bevelSegments: number;
+    curveSegments: number;
+}
+/**
+ * Translate the engine's high-level knobs (`depth`, `smoothness`, bevel
+ * thickness/size) + the SVG's flat bounds + shape complexity into concrete
+ * three.js `ExtrudeGeometry` settings, including the vertex-budget reduction.
+ * This is the exact math used by both the client geometry pipeline and the
+ * server GLB export, so they never drift.
+ */
+export declare function buildExtrudeSettings(maxFlatDim: number, shapeCount: number, opts: BuildExtrudedGeometryOptions): ExtrudeSettings;
+/**
+ * Measure the flat (un-extruded) bounding box of a set of shapes and return the
+ * larger of width/height (clamped to ≥ 1) — the `maxFlatDim` that drives depth
+ * and bevel scaling. Disposes the temporary geometry it builds.
+ */
+export declare function measureFlatMaxDim(shapes: THREE.Shape[]): number;
+/**
+ * SVG (or pre-parsed shapes) → a single extruded, merged, normal-smoothed,
+ * triplanar-UV'd `BufferGeometry`, plus its center and a fit-to-4-units scale.
+ *
+ * This is the pure heart of the Studio3D engine's `useExtrudedGeometry` hook
+ * (which keeps React state, progress, cancellation and disposal). The geometry
+ * math here is identical to the legacy hook — extracting it changes nothing.
+ *
+ * The caller owns the returned `geometry` and must `dispose()` it.
+ */
+export declare function buildExtrudedGeometry(svg: string | THREE.Shape[], opts: BuildExtrudedGeometryOptions): ExtrudedGeometryResult | null;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAIpB;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,cAAc,EAAE,MAAM,GACrB,KAAK,CAAC,cAAc,CA+EtB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CA8BrF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CASnF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CA8DnE;AAED,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,4BAA4B,GACjC,eAAe,CAoCjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,MAAM,CAQ/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,EAC3B,IAAI,EAAE,4BAA4B,GACjC,sBAAsB,GAAG,IAAI,CAsC/B"}

package/dist/geometry.js

@@ -0,0 +1,283 @@
+import * as THREE from 'three';
+import { SVGLoader } from 'three/examples/jsm/loaders/SVGLoader.js';
+import * as BufferGeometryUtils from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+const SMOOTH_VERTEX_LIMIT = 300_000;
+/**
+ * Average face normals within a vertex's coincident group when the angle
+ * between them is below `creaseAngleRad` (sharp edges above it stay crisp).
+ * Falls back to `computeVertexNormals` past {@link SMOOTH_VERTEX_LIMIT} verts.
+ * Returns a new, non-indexed geometry (the input is left untouched).
+ */
+export function smoothCreaseNormals(geometry, creaseAngleRad) {
+    const tempGeo = geometry.index ? geometry.toNonIndexed() : geometry.clone();
+    const posAttr = tempGeo.attributes.position;
+    if (!posAttr)
+        return geometry;
+    const count = posAttr.count;
+    if (count > SMOOTH_VERTEX_LIMIT) {
+        tempGeo.computeVertexNormals();
+        return tempGeo;
+    }
+    const flatNormals = [];
+    for (let i = 0; i < count; i += 3) {
+        const vA = new THREE.Vector3(posAttr.getX(i), posAttr.getY(i), posAttr.getZ(i));
+        const vB = new THREE.Vector3(posAttr.getX(i + 1), posAttr.getY(i + 1), posAttr.getZ(i + 1));
+        const vC = new THREE.Vector3(posAttr.getX(i + 2), posAttr.getY(i + 2), posAttr.getZ(i + 2));
+        const cb = new THREE.Vector3().subVectors(vC, vB);
+        const ab = new THREE.Vector3().subVectors(vA, vB);
+        cb.cross(ab).normalize();
+        flatNormals.push(cb.clone(), cb.clone(), cb.clone());
+    }
+    const posToIndices = new Map();
+    const precision = 100000;
+    for (let i = 0; i < count; i++) {
+        const px = Math.round(posAttr.getX(i) * precision);
+        const py = Math.round(posAttr.getY(i) * precision);
+        const pz = Math.round(posAttr.getZ(i) * precision);
+        const hash = `${px},${py},${pz}`;
+        if (!posToIndices.has(hash)) {
+            posToIndices.set(hash, []);
+        }
+        posToIndices.get(hash).push(i);
+    }
+    const cosThreshold = Math.cos(creaseAngleRad);
+    const newNormals = new Float32Array(count * 3);
+    for (const indices of posToIndices.values()) {
+        const visited = new Set();
+        for (const idx of indices) {
+            if (visited.has(idx))
+                continue;
+            const n1 = flatNormals[idx];
+            const smoothGroup = [idx];
+            visited.add(idx);
+            for (const otherIdx of indices) {
+                if (visited.has(otherIdx))
+                    continue;
+                const n2 = flatNormals[otherIdx];
+                if (n1.dot(n2) >= cosThreshold) {
+                    smoothGroup.push(otherIdx);
+                    visited.add(otherIdx);
+                }
+            }
+            const avgNormal = new THREE.Vector3();
+            for (const i of smoothGroup) {
+                avgNormal.add(flatNormals[i]);
+            }
+            avgNormal.normalize();
+            for (const i of smoothGroup) {
+                newNormals[i * 3] = avgNormal.x;
+                newNormals[i * 3 + 1] = avgNormal.y;
+                newNormals[i * 3 + 2] = avgNormal.z;
+            }
+        }
+    }
+    tempGeo.setAttribute('normal', new THREE.BufferAttribute(newNormals, 3));
+    return tempGeo;
+}
+/**
+ * Recompute box-projected (triplanar) UVs in place, projecting each vertex onto
+ * the axis plane that best matches its normal and normalizing by the bounding
+ * box's largest dimension.
+ */
+export function recomputeTriplanarUVs(geo, bb) {
+    const bbSize = new THREE.Vector3();
+    bb.getSize(bbSize);
+    const uvAttr = geo.attributes.uv;
+    const posAttr = geo.attributes.position;
+    const normalAttr = geo.attributes.normal;
+    const maxDimUv = Math.max(bbSize.x, bbSize.y, bbSize.z) || 1;
+    for (let j = 0; j < uvAttr.count; j++) {
+        const px = posAttr.getX(j);
+        const py = posAttr.getY(j);
+        const pz = posAttr.getZ(j);
+        const nx = Math.abs(normalAttr.getX(j));
+        const ny = Math.abs(normalAttr.getY(j));
+        const nz = Math.abs(normalAttr.getZ(j));
+        let u, v;
+        if (nz >= nx && nz >= ny) {
+            u = (px - bb.min.x) / maxDimUv;
+            v = 1 - (py - bb.min.y) / maxDimUv;
+        }
+        else if (nx >= ny) {
+            u = (pz - bb.min.z) / maxDimUv;
+            v = 1 - (py - bb.min.y) / maxDimUv;
+        }
+        else {
+            u = (px - bb.min.x) / maxDimUv;
+            v = (pz - bb.min.z) / maxDimUv;
+        }
+        uvAttr.setXY(j, u, v);
+    }
+    uvAttr.needsUpdate = true;
+}
+/**
+ * True when `shape` is (approximately) the SVG's full viewBox rectangle — used
+ * to drop background rects that SVGLoader emits as a fill shape.
+ */
+export function isViewBoxRect(shape, vbW, vbH) {
+    const pts = shape.getPoints(4);
+    if (pts.length !== 4 && pts.length !== 5)
+        return false;
+    const bb = new THREE.Box2();
+    for (const p of pts)
+        bb.expandByPoint(p);
+    const size = new THREE.Vector2();
+    bb.getSize(size);
+    const tolerance = 0.01;
+    return Math.abs(size.x - vbW) / vbW < tolerance && Math.abs(size.y - vbH) / vbH < tolerance;
+}
+/**
+ * Parse an SVG string into three.js `Shape`s ready for extrusion. Fills become
+ * shapes directly (dropping the viewBox-sized background rect); strokes are
+ * tessellated into a ribbon polygon of `strokeWidth`; paths with no explicit
+ * fill/stroke fall back to fill shapes.
+ *
+ * Accepts both whitespace- and comma-separated viewBox values.
+ */
+export function parseShapesFromSVG(svgString) {
+    const loader = new SVGLoader();
+    const svgData = loader.parse(svgString);
+    const allShapes = [];
+    const vbMatch = svgString.match(/viewBox\s*=\s*["']\s*([\d.\-]+)[\s,]+([\d.\-]+)[\s,]+([\d.\-]+)[\s,]+([\d.\-]+)/);
+    const vbW = vbMatch ? parseFloat(vbMatch[3]) : null;
+    const vbH = vbMatch ? parseFloat(vbMatch[4]) : null;
+    svgData.paths.forEach((path) => {
+        const style = path.userData?.style;
+        const hasFill = style?.fill && style.fill !== 'none' && style.fill !== 'transparent';
+        const hasStroke = style?.stroke && style.stroke !== 'none' && style.stroke !== 'transparent';
+        if (hasFill) {
+            const shapes = SVGLoader.createShapes(path);
+            for (const shape of shapes) {
+                if (vbW && vbH && isViewBoxRect(shape, vbW, vbH))
+                    continue;
+                allShapes.push(shape);
+            }
+        }
+        if (hasStroke) {
+            const strokeWidth = parseFloat(style?.strokeWidth ?? '2');
+            const divisions = 12;
+            path.subPaths.forEach((subPath) => {
+                const points = subPath.getPoints(divisions);
+                if (points.length < 2)
+                    return;
+                const shape = new THREE.Shape();
+                const halfWidth = strokeWidth / 2;
+                const leftSide = [];
+                const rightSide = [];
+                for (let i = 0; i < points.length; i++) {
+                    const curr = points[i];
+                    const prev = points[Math.max(0, i - 1)];
+                    const next = points[Math.min(points.length - 1, i + 1)];
+                    const dx = next.x - prev.x;
+                    const dy = next.y - prev.y;
+                    const len = Math.sqrt(dx * dx + dy * dy) || 1;
+                    const nx = -dy / len;
+                    const ny = dx / len;
+                    leftSide.push(new THREE.Vector2(curr.x + nx * halfWidth, curr.y + ny * halfWidth));
+                    rightSide.push(new THREE.Vector2(curr.x - nx * halfWidth, curr.y - ny * halfWidth));
+                }
+                shape.moveTo(leftSide[0].x, leftSide[0].y);
+                for (let i = 1; i < leftSide.length; i++)
+                    shape.lineTo(leftSide[i].x, leftSide[i].y);
+                for (let i = rightSide.length - 1; i >= 0; i--)
+                    shape.lineTo(rightSide[i].x, rightSide[i].y);
+                shape.closePath();
+                allShapes.push(shape);
+            });
+        }
+        if (!hasFill && !hasStroke) {
+            allShapes.push(...SVGLoader.createShapes(path));
+        }
+    });
+    return allShapes;
+}
+/**
+ * Translate the engine's high-level knobs (`depth`, `smoothness`, bevel
+ * thickness/size) + the SVG's flat bounds + shape complexity into concrete
+ * three.js `ExtrudeGeometry` settings, including the vertex-budget reduction.
+ * This is the exact math used by both the client geometry pipeline and the
+ * server GLB export, so they never drift.
+ */
+export function buildExtrudeSettings(maxFlatDim, shapeCount, opts) {
+    const { depth, smoothness, bevelEnabled = true, bevelThickness: userThickness = 0.5, bevelSize: userSize = 0.5, vertexBudget = 600_000, } = opts;
+    const complexity = shapeCount;
+    const vertsBudgetPerShape = Math.max(Math.floor(vertexBudget / Math.max(complexity, 1)), 500);
+    const scaledDepth = (depth / 10) * maxFlatDim;
+    const bevelScale = Math.min(maxFlatDim * 0.05, 1);
+    const idealBevel = Math.round(4 + smoothness * 8);
+    const idealCurve = Math.round(32 + smoothness * 64);
+    const estimatedVerts = idealBevel * idealCurve * 6;
+    const reductionFactor = estimatedVerts > vertsBudgetPerShape ? Math.sqrt(vertsBudgetPerShape / estimatedVerts) : 1;
+    const bevelSegments = Math.max(2, Math.min(Math.round(idealBevel * reductionFactor), 64));
+    const curveSegments = Math.max(8, Math.min(Math.round(idealCurve * reductionFactor), 128));
+    const maxBevel = Math.max(0.01, scaledDepth * 0.5);
+    const bevelThickness = Math.min(bevelScale * userThickness, maxBevel);
+    const bevelSize = Math.min(bevelScale * userSize, maxBevel);
+    return {
+        depth: scaledDepth,
+        bevelEnabled,
+        bevelThickness,
+        bevelSize,
+        bevelSegments,
+        curveSegments,
+    };
+}
+/**
+ * Measure the flat (un-extruded) bounding box of a set of shapes and return the
+ * larger of width/height (clamped to ≥ 1) — the `maxFlatDim` that drives depth
+ * and bevel scaling. Disposes the temporary geometry it builds.
+ */
+export function measureFlatMaxDim(shapes) {
+    const tempGeo = new THREE.ShapeGeometry(shapes);
+    tempGeo.computeBoundingBox();
+    const flatSize = new THREE.Vector3();
+    tempGeo.boundingBox.getSize(flatSize);
+    const maxFlatDim = Math.max(flatSize.x, flatSize.y, 1);
+    tempGeo.dispose();
+    return maxFlatDim;
+}
+/**
+ * SVG (or pre-parsed shapes) → a single extruded, merged, normal-smoothed,
+ * triplanar-UV'd `BufferGeometry`, plus its center and a fit-to-4-units scale.
+ *
+ * This is the pure heart of the Studio3D engine's `useExtrudedGeometry` hook
+ * (which keeps React state, progress, cancellation and disposal). The geometry
+ * math here is identical to the legacy hook — extracting it changes nothing.
+ *
+ * The caller owns the returned `geometry` and must `dispose()` it.
+ */
+export function buildExtrudedGeometry(svg, opts) {
+    const allShapes = typeof svg === 'string' ? parseShapesFromSVG(svg) : svg;
+    if (allShapes.length === 0)
+        return null;
+    const maxFlatDim = measureFlatMaxDim(allShapes);
+    const extrudeSettings = buildExtrudeSettings(maxFlatDim, allShapes.length, opts);
+    const individualGeos = [];
+    for (let i = 0; i < allShapes.length; i++) {
+        individualGeos.push(new THREE.ExtrudeGeometry(allShapes[i], extrudeSettings));
+    }
+    let merged = BufferGeometryUtils.mergeGeometries(individualGeos, false);
+    individualGeos.forEach((g) => g.dispose());
+    if (!merged)
+        return null;
+    const creaseAngle = opts.creaseAngle === undefined ? Math.PI / 6 : opts.creaseAngle;
+    if (creaseAngle != null) {
+        const smoothed = smoothCreaseNormals(merged, creaseAngle);
+        merged.dispose();
+        merged = smoothed;
+    }
+    else {
+        merged.computeVertexNormals();
+    }
+    merged.computeBoundingBox();
+    recomputeTriplanarUVs(merged, merged.boundingBox);
+    const bb = merged.boundingBox;
+    const ctr = new THREE.Vector3();
+    bb.getCenter(ctr);
+    const size = new THREE.Vector3();
+    bb.getSize(size);
+    const maxDim = Math.max(size.x, size.y, size.z);
+    const s = maxDim > 0 ? 4 / maxDim : 1;
+    return { geometry: merged, center: ctr, baseScale: s, shapeCount: allShapes.length };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

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

package/dist/glb.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Options for {@link svgToGlb}. All optional; defaults match the Studio3D
+ * server export. `depth`/`smoothness`/bevel drive the same extrude math the
+ * client uses; `color`/`metalness`/`roughness` become the GLB PBR material.
+ */
+export interface SvgToGlbOptions {
+    depth?: number;
+    smoothness?: number;
+    bevelEnabled?: boolean;
+    bevelThickness?: number;
+    bevelSize?: number;
+    color?: string;
+    metalness?: number;
+    roughness?: number;
+}
+/**
+ * Output of {@link svgToGlb}: the raw GLB bytes plus the interleaved geometry
+ * arrays they were built from (handy for tests / further processing).
+ */
+export interface GlbResult {
+    /** Raw `.glb` bytes (`glTF` magic header). */
+    glb: Uint8Array;
+    positions: Float32Array;
+    normals: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * SVG string → extruded, merged, centered geometry serialized as a binary glTF
+ * (`.glb`). This is the pure core of the Studio3D server export
+ * (`studio3dExportService.svgToGlb`); the service keeps only the DOMParser/JSDOM
+ * environment shim and storage. Geometry math (extrude settings, vertex budget)
+ * matches the legacy server path exactly — plain `computeVertexNormals`, no
+ * crease smoothing, no bevel clamp.
+ *
+ * Returns the GLB bytes plus the geometry arrays. Throws if the SVG yields no
+ * shapes or the merge fails. Requires a DOM `DOMParser` to be available (the
+ * server installs one via JSDOM before calling).
+ */
+export declare function svgToGlb(svgString: string, opts?: SvgToGlbOptions): GlbResult;
+//# sourceMappingURL=glb.d.ts.map

package/dist/glb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glb.d.ts","sourceRoot":"","sources":["../src/glb.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;CACtB;AAyGD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,SAAS,CA4DjF"}