@headless-three/renderer 0.0.0 → 0.1.0

package/dist/math.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPENGL_TO_WGPU_CLIP = exports.IDENTITY_4X4 = void 0;
+exports.multiplyMatrices = multiplyMatrices;
+exports.invertMatrix4 = invertMatrix4;
+exports.blendBoneMatrices = blendBoneMatrices;
+exports.matrixElements = matrixElements;
+exports.clampInteger = clampInteger;
+exports.numberOrUndefined = numberOrUndefined;
+exports.isFinitePositive = isFinitePositive;
+exports.assertFinite = assertFinite;
+exports.areFiniteNumbers = areFiniteNumbers;
+exports.clamp01 = clamp01;
+exports.IDENTITY_4X4 = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+// Three.js projection matrices use WebGL/OpenGL clip-space depth (-1..1).
+// wgpu/WebGPU expects 0..1, so the public adapter converts clip-space here.
+exports.OPENGL_TO_WGPU_CLIP = [
+    1, 0, 0, 0,
+    0, 1, 0, 0,
+    0, 0, 0.5, 0,
+    0, 0, 0.5, 1,
+];
+function multiplyMatrices(a, b) {
+    const out = new Array(16);
+    for (let column = 0; column < 4; column += 1) {
+        for (let row = 0; row < 4; row += 1) {
+            out[column * 4 + row] =
+                a[row] * b[column * 4] +
+                    a[4 + row] * b[column * 4 + 1] +
+                    a[8 + row] * b[column * 4 + 2] +
+                    a[12 + row] * b[column * 4 + 3];
+        }
+    }
+    return out;
+}
+function invertMatrix4(m) {
+    const a00 = m[0], a01 = m[1], a02 = m[2], a03 = m[3];
+    const a10 = m[4], a11 = m[5], a12 = m[6], a13 = m[7];
+    const a20 = m[8], a21 = m[9], a22 = m[10], a23 = m[11];
+    const a30 = m[12], a31 = m[13], a32 = m[14], a33 = m[15];
+    const b00 = a00 * a11 - a01 * a10;
+    const b01 = a00 * a12 - a02 * a10;
+    const b02 = a00 * a13 - a03 * a10;
+    const b03 = a01 * a12 - a02 * a11;
+    const b04 = a01 * a13 - a03 * a11;
+    const b05 = a02 * a13 - a03 * a12;
+    const b06 = a20 * a31 - a21 * a30;
+    const b07 = a20 * a32 - a22 * a30;
+    const b08 = a20 * a33 - a23 * a30;
+    const b09 = a21 * a32 - a22 * a31;
+    const b10 = a21 * a33 - a23 * a31;
+    const b11 = a22 * a33 - a23 * a32;
+    let det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - b04 * b07 + b05 * b06;
+    if (Math.abs(det) < 1e-12)
+        return exports.IDENTITY_4X4.slice();
+    det = 1.0 / det;
+    return [
+        (a11 * b11 - a12 * b10 + a13 * b09) * det,
+        (a02 * b10 - a01 * b11 - a03 * b09) * det,
+        (a31 * b05 - a32 * b04 + a33 * b03) * det,
+        (a22 * b04 - a21 * b05 - a23 * b03) * det,
+        (a12 * b08 - a10 * b11 - a13 * b07) * det,
+        (a00 * b11 - a02 * b08 + a03 * b07) * det,
+        (a32 * b02 - a30 * b05 - a33 * b01) * det,
+        (a20 * b05 - a22 * b02 + a23 * b01) * det,
+        (a10 * b10 - a11 * b08 + a13 * b06) * det,
+        (a01 * b08 - a00 * b10 - a03 * b06) * det,
+        (a30 * b04 - a31 * b02 + a33 * b00) * det,
+        (a21 * b02 - a20 * b04 - a23 * b00) * det,
+        (a11 * b07 - a10 * b09 - a12 * b06) * det,
+        (a00 * b09 - a01 * b07 + a02 * b06) * det,
+        (a31 * b01 - a30 * b03 - a32 * b00) * det,
+        (a20 * b03 - a21 * b01 + a22 * b00) * det,
+    ];
+}
+function blendBoneMatrices(boneMatrices, boneCount, ji0, ji1, ji2, ji3, jw0, jw1, jw2, jw3) {
+    const out = new Array(16);
+    for (let k = 0; k < 16; k++) {
+        out[k] = 0;
+    }
+    if (jw0 > 0 && ji0 >= 0 && ji0 < boneCount) {
+        const m = boneMatrices[ji0];
+        for (let k = 0; k < 16; k++)
+            out[k] += jw0 * m[k];
+    }
+    if (jw1 > 0 && ji1 >= 0 && ji1 < boneCount) {
+        const m = boneMatrices[ji1];
+        for (let k = 0; k < 16; k++)
+            out[k] += jw1 * m[k];
+    }
+    if (jw2 > 0 && ji2 >= 0 && ji2 < boneCount) {
+        const m = boneMatrices[ji2];
+        for (let k = 0; k < 16; k++)
+            out[k] += jw2 * m[k];
+    }
+    if (jw3 > 0 && ji3 >= 0 && ji3 < boneCount) {
+        const m = boneMatrices[ji3];
+        for (let k = 0; k < 16; k++)
+            out[k] += jw3 * m[k];
+    }
+    const sum = jw0 + jw1 + jw2 + jw3;
+    if (sum < 1e-8) {
+        return exports.IDENTITY_4X4;
+    }
+    return out;
+}
+function matrixElements(matrix, label) {
+    const elements = matrix?.elements;
+    if (!elements || elements.length !== 16) {
+        throw new TypeError(`${label} must be a THREE.Matrix4`);
+    }
+    return Array.from(elements, (value) => assertFinite(value, label));
+}
+function clampInteger(value, min, max) {
+    if (!Number.isFinite(value))
+        return max;
+    return Math.max(min, Math.min(max, Math.trunc(value)));
+}
+function numberOrUndefined(value) {
+    return Number.isFinite(value) ? value : undefined;
+}
+function isFinitePositive(value) {
+    return Number.isFinite(value) && value > 0;
+}
+function assertFinite(value, label) {
+    if (!Number.isFinite(value)) {
+        throw new TypeError(`${label} must be finite`);
+    }
+    return value;
+}
+function areFiniteNumbers(...values) {
+    return values.every(Number.isFinite);
+}
+function clamp01(value) {
+    return Math.min(1, Math.max(0, value));
+}
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

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

package/dist/morphs.d.ts

@@ -0,0 +1,22 @@
+import type { ThreeObject3DLike } from './types';
+/**
+ * CPU-side morph target (blend shape / shape key) application.
+ *
+ * Supports:
+ * - Three.js `BufferGeometry.morphAttributes` with `mesh.morphTargetInfluences`
+ * - VRM blend shapes (`@pixiv/three-vrm` sets `morphTargetInfluences` on the mesh)
+ * - Blender shape keys exported via glTF (`GLTFLoader` populates the same attributes)
+ *
+ * Three.js morph target formula per vertex:
+ *   morphedPosition = basePosition + sum(influence[i] * morphPosition[i][vertex])
+ *   morphedNormal   = normalize(baseNormal + sum(influence[i] * morphNormal[i][vertex]))
+ *
+ * When `geometry.morphTargetsRelative` is true (the default for glTF), the morph
+ * attributes store deltas. When false (legacy Three.js), they store absolute
+ * positions and we compute the delta as `morphAttr[i][v] - baseAttr[v]`.
+ */
+export declare function applyMorphTargets(mesh: ThreeObject3DLike, positions: number[], normals: number[] | null): {
+    positions: number[];
+    normals: number[] | null;
+};
+//# sourceMappingURL=morphs.d.ts.map

package/dist/morphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morphs.d.ts","sourceRoot":"","sources":["../api/morphs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA4B,MAAM,SAAS,CAAA;AAG1E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,GACvB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CA6FnD"}

package/dist/morphs.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyMorphTargets = applyMorphTargets;
+const attributes_1 = require("./attributes");
+/**
+ * CPU-side morph target (blend shape / shape key) application.
+ *
+ * Supports:
+ * - Three.js `BufferGeometry.morphAttributes` with `mesh.morphTargetInfluences`
+ * - VRM blend shapes (`@pixiv/three-vrm` sets `morphTargetInfluences` on the mesh)
+ * - Blender shape keys exported via glTF (`GLTFLoader` populates the same attributes)
+ *
+ * Three.js morph target formula per vertex:
+ *   morphedPosition = basePosition + sum(influence[i] * morphPosition[i][vertex])
+ *   morphedNormal   = normalize(baseNormal + sum(influence[i] * morphNormal[i][vertex]))
+ *
+ * When `geometry.morphTargetsRelative` is true (the default for glTF), the morph
+ * attributes store deltas. When false (legacy Three.js), they store absolute
+ * positions and we compute the delta as `morphAttr[i][v] - baseAttr[v]`.
+ */
+function applyMorphTargets(mesh, positions, normals) {
+    const geometry = mesh.geometry;
+    if (!geometry)
+        return { positions, normals };
+    const influences = mesh.morphTargetInfluences;
+    if (!influences || influences.length === 0)
+        return { positions, normals };
+    const morphAttributes = geometry.morphAttributes;
+    if (!morphAttributes)
+        return { positions, normals };
+    const morphPositions = morphAttributes.position;
+    const morphNormals = morphAttributes.normal;
+    if (!morphPositions || morphPositions.length === 0)
+        return { positions, normals };
+    // Check if any influence is actually non-zero before allocating.
+    const targetCount = Math.min(influences.length, morphPositions.length);
+    let hasEffect = false;
+    for (let t = 0; t < targetCount; t++) {
+        if (influences[t] !== 0 && Number.isFinite(influences[t])) {
+            hasEffect = true;
+            break;
+        }
+    }
+    if (!hasEffect)
+        return { positions, normals };
+    const isRelative = geometry.morphTargetsRelative !== false;
+    const vertexCount = positions.length / 3;
+    const morphedPositions = positions.slice();
+    const morphedNormals = normals ? normals.slice() : null;
+    for (let t = 0; t < targetCount; t++) {
+        const weight = influences[t];
+        if (!Number.isFinite(weight) || weight === 0)
+            continue;
+        const morphPosAttr = morphPositions[t];
+        if (!morphPosAttr)
+            continue;
+        const morphNormAttr = morphNormals?.[t];
+        const count = Math.min(vertexCount, morphPosAttr.count ?? 0);
+        for (let vi = 0; vi < count; vi++) {
+            const mx = (0, attributes_1.attributeComponent)(morphPosAttr, vi, 0);
+            const my = (0, attributes_1.attributeComponent)(morphPosAttr, vi, 1);
+            const mz = (0, attributes_1.attributeComponent)(morphPosAttr, vi, 2);
+            if (isRelative) {
+                // Morph attributes store deltas
+                morphedPositions[vi * 3] += weight * mx;
+                morphedPositions[vi * 3 + 1] += weight * my;
+                morphedPositions[vi * 3 + 2] += weight * mz;
+            }
+            else {
+                // Legacy absolute mode: delta = morphPos - basePos
+                morphedPositions[vi * 3] += weight * (mx - positions[vi * 3]);
+                morphedPositions[vi * 3 + 1] += weight * (my - positions[vi * 3 + 1]);
+                morphedPositions[vi * 3 + 2] += weight * (mz - positions[vi * 3 + 2]);
+            }
+            if (morphedNormals && morphNormAttr) {
+                const nx = (0, attributes_1.attributeComponent)(morphNormAttr, vi, 0);
+                const ny = (0, attributes_1.attributeComponent)(morphNormAttr, vi, 1);
+                const nz = (0, attributes_1.attributeComponent)(morphNormAttr, vi, 2);
+                if (isRelative) {
+                    morphedNormals[vi * 3] += weight * nx;
+                    morphedNormals[vi * 3 + 1] += weight * ny;
+                    morphedNormals[vi * 3 + 2] += weight * nz;
+                }
+                else {
+                    morphedNormals[vi * 3] += weight * (nx - normals[vi * 3]);
+                    morphedNormals[vi * 3 + 1] += weight * (ny - normals[vi * 3 + 1]);
+                    morphedNormals[vi * 3 + 2] += weight * (nz - normals[vi * 3 + 2]);
+                }
+            }
+        }
+    }
+    // Re-normalize morphed normals
+    if (morphedNormals) {
+        for (let vi = 0; vi < vertexCount; vi++) {
+            const nx = morphedNormals[vi * 3];
+            const ny = morphedNormals[vi * 3 + 1];
+            const nz = morphedNormals[vi * 3 + 2];
+            const len = Math.sqrt(nx * nx + ny * ny + nz * nz);
+            if (len > 1e-8) {
+                morphedNormals[vi * 3] = nx / len;
+                morphedNormals[vi * 3 + 1] = ny / len;
+                morphedNormals[vi * 3 + 2] = nz / len;
+            }
+        }
+    }
+    return { positions: morphedPositions, normals: morphedNormals };
+}
+//# sourceMappingURL=morphs.js.map

package/dist/morphs.js.map

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

package/dist/scene.d.ts

@@ -0,0 +1,3 @@
+import type { ThreeObject3DLike, NativeSceneMesh } from './types';
+export declare function flattenScene(scene: ThreeObject3DLike): NativeSceneMesh[];
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../api/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA2B,eAAe,EAAiB,MAAM,SAAS,CAAA;AAOzG,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAIxE"}

package/dist/scene.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flattenScene = flattenScene;
+const math_1 = require("./math");
+const attributes_1 = require("./attributes");
+const materials_1 = require("./materials");
+const skinning_1 = require("./skinning");
+const morphs_1 = require("./morphs");
+function flattenScene(scene) {
+    const meshes = [];
+    visitObject(scene, true, meshes);
+    return meshes;
+}
+function visitObject(object, parentVisible, meshes) {
+    if (!object || !parentVisible || object.visible === false)
+        return;
+    if (object.isMesh === true && object.geometry) {
+        appendMesh(object, meshes);
+    }
+    else if ((object.isLineSegments === true || object.isLineLoop === true || object.isLine === true) && object.geometry) {
+        appendLineOrPoints(object, meshes, 'lines');
+    }
+    else if (object.isPoints === true && object.geometry) {
+        appendLineOrPoints(object, meshes, 'points');
+    }
+    const children = Array.isArray(object.children) ? object.children : [];
+    for (const child of children) {
+        visitObject(child, true, meshes);
+    }
+}
+function appendMesh(object, meshes) {
+    const geometry = object.geometry;
+    const position = (0, attributes_1.getAttribute)(geometry, 'position');
+    if (!position)
+        return;
+    let positions = (0, attributes_1.readVec3Attribute)(position);
+    const uvAttribute = (0, attributes_1.getAttribute)(geometry, 'uv');
+    const uvs = uvAttribute ? (0, attributes_1.readVec2Attribute)(uvAttribute) : null;
+    const normalAttribute = (0, attributes_1.getAttribute)(geometry, 'normal');
+    let normals = normalAttribute ? (0, attributes_1.readVec3Attribute)(normalAttribute) : null;
+    const vertexColors = (0, attributes_1.getAttribute)(geometry, 'color');
+    const index = geometry.index ? (0, attributes_1.readIndexAttribute)(geometry.index) : null;
+    const groups = effectiveGroups(geometry, index, position.count);
+    // CPU-side morph targets (blend shapes / shape keys / VRM blendshapes)
+    if (object.morphTargetInfluences && object.morphTargetInfluences.length > 0) {
+        const morphed = (0, morphs_1.applyMorphTargets)(object, positions, normals);
+        positions = morphed.positions;
+        normals = morphed.normals;
+    }
+    // CPU-side skinning for SkinnedMesh (Three.js, VRM, VRMA)
+    if (object.isSkinnedMesh === true && object.skeleton) {
+        const skinned = (0, skinning_1.applyCpuSkinning)(object, positions, normals);
+        positions = skinned.positions;
+        normals = skinned.normals;
+    }
+    // For skinned meshes, positions are already in world space after CPU skinning.
+    const isSkinned = object.isSkinnedMesh === true && object.skeleton;
+    const meshTransform = isSkinned
+        ? math_1.IDENTITY_4X4.slice()
+        : (0, math_1.matrixElements)(object.matrixWorld, 'mesh.matrixWorld');
+    for (const group of groups) {
+        const material = (0, materials_1.materialForGroup)(object.material, group.materialIndex);
+        if (material?.visible === false)
+            continue;
+        const color = (0, materials_1.materialColor)(material);
+        const useVertexColors = vertexColors && material?.vertexColors !== false;
+        const pbrProps = (0, materials_1.extractPbrProperties)(material);
+        const textureInfo = (0, materials_1.extractTextureData)(material);
+        const castShadow = object.castShadow === true ? true : undefined;
+        const receiveShadow = object.receiveShadow === true ? true : undefined;
+        if (index) {
+            const indices = index.slice(group.start, group.start + group.count);
+            if (indices.length % 3 !== 0) {
+                throw new Error(`THREE.Mesh "${object.name || object.uuid || '<unnamed>'}" has a non-triangle index range`);
+            }
+            meshes.push({
+                positions,
+                indices,
+                normals: normals ?? undefined,
+                color,
+                colors: useVertexColors ? (0, attributes_1.readColorAttribute)(vertexColors, color) : undefined,
+                uvs: uvs ?? undefined,
+                texture: textureInfo?.data,
+                textureWidth: textureInfo?.width ?? undefined,
+                textureHeight: textureInfo?.height ?? undefined,
+                textureWrapS: textureInfo?.wrapS,
+                textureWrapT: textureInfo?.wrapT,
+                transform: meshTransform,
+                castShadow,
+                receiveShadow,
+                ...pbrProps,
+            });
+        }
+        else {
+            if (group.count % 3 !== 0) {
+                throw new Error(`THREE.Mesh "${object.name || object.uuid || '<unnamed>'}" has a non-triangle vertex range`);
+            }
+            meshes.push({
+                positions: positions.slice(group.start * 3, (group.start + group.count) * 3),
+                normals: normals ? normals.slice(group.start * 3, (group.start + group.count) * 3) : undefined,
+                color,
+                colors: useVertexColors
+                    ? (0, attributes_1.readColorAttribute)(vertexColors, color).slice(group.start * 4, (group.start + group.count) * 4)
+                    : undefined,
+                uvs: uvs ? uvs.slice(group.start * 2, (group.start + group.count) * 2) : undefined,
+                texture: textureInfo?.data,
+                textureWidth: textureInfo?.width ?? undefined,
+                textureHeight: textureInfo?.height ?? undefined,
+                textureWrapS: textureInfo?.wrapS,
+                textureWrapT: textureInfo?.wrapT,
+                transform: meshTransform,
+                castShadow,
+                receiveShadow,
+                ...pbrProps,
+            });
+        }
+    }
+}
+function effectiveGroups(geometry, index, vertexCount) {
+    const range = geometry.drawRange ?? {};
+    const maxCount = index ? index.length : vertexCount;
+    const drawStart = (0, math_1.clampInteger)(range.start ?? 0, 0, maxCount);
+    const requestedCount = range.count == null || range.count === Infinity ? maxCount : range.count;
+    const drawEnd = (0, math_1.clampInteger)(drawStart + requestedCount, drawStart, maxCount);
+    const sourceGroups = Array.isArray(geometry.groups) && geometry.groups.length
+        ? geometry.groups
+        : [{ start: drawStart, count: drawEnd - drawStart, materialIndex: 0 }];
+    const groups = [];
+    for (const group of sourceGroups) {
+        const start = Math.max(drawStart, (0, math_1.clampInteger)(group.start ?? 0, 0, maxCount));
+        const end = Math.min(drawEnd, (0, math_1.clampInteger)((group.start ?? 0) + (group.count ?? 0), 0, maxCount));
+        if (end > start) {
+            groups.push({
+                start,
+                count: end - start,
+                materialIndex: group.materialIndex ?? 0,
+            });
+        }
+    }
+    return groups;
+}
+/**
+ * Emit a `NativeSceneMesh` with `topology: 'lines'` or `'points'` for
+ * `THREE.Line` / `THREE.LineSegments` / `THREE.LineLoop` / `THREE.Points`.
+ * Lines are always expanded to a LineList (pairs of vertex indices) so the
+ * Rust side only has to deal with one line topology.
+ */
+function appendLineOrPoints(object, meshes, topology) {
+    const geometry = object.geometry;
+    const position = (0, attributes_1.getAttribute)(geometry, 'position');
+    if (!position)
+        return;
+    const material = (0, materials_1.materialForGroup)(object.material, 0);
+    if (material?.visible === false)
+        return;
+    const positions = (0, attributes_1.readVec3Attribute)(position);
+    const vertexColors = (0, attributes_1.getAttribute)(geometry, 'color');
+    const indexAttr = geometry.index ? (0, attributes_1.readIndexAttribute)(geometry.index) : null;
+    const vertexCount = position.count;
+    const range = geometry.drawRange ?? {};
+    const sourceCount = indexAttr ? indexAttr.length : vertexCount;
+    const drawStart = (0, math_1.clampInteger)(range.start ?? 0, 0, sourceCount);
+    const requestedCount = range.count == null || range.count === Infinity ? sourceCount : range.count;
+    const drawEnd = (0, math_1.clampInteger)(drawStart + requestedCount, drawStart, sourceCount);
+    let indices = null;
+    if (topology === 'lines') {
+        const source = indexAttr ?? rangeIndices(vertexCount);
+        indices = expandLineIndices(source, drawStart, drawEnd, object);
+        if (indices.length < 2)
+            return;
+    }
+    else if (indexAttr) {
+        indices = indexAttr.slice(drawStart, drawEnd);
+        if (indices.length === 0)
+            return;
+    }
+    const color = (0, materials_1.materialColor)(material);
+    const useVertexColors = vertexColors && material?.vertexColors !== false;
+    const colors = useVertexColors ? (0, attributes_1.readColorAttribute)(vertexColors, color) : undefined;
+    meshes.push({
+        positions,
+        indices: indices ?? undefined,
+        color,
+        colors,
+        transform: (0, math_1.matrixElements)(object.matrixWorld, 'object.matrixWorld'),
+        transparent: material?.transparent === true || (material?.opacity != null && material.opacity < 1),
+        alphaTest: material && Number.isFinite(material.alphaTest) && material.alphaTest > 0 ? material.alphaTest : undefined,
+        shadingModel: 'basic',
+        topology,
+    });
+}
+function rangeIndices(count) {
+    const out = new Array(count);
+    for (let i = 0; i < count; i++)
+        out[i] = i;
+    return out;
+}
+/**
+ * Convert a LineStrip / LineSegments / LineLoop index stream into a flat
+ * LineList `[a, b, b, c, ...]` array.
+ */
+function expandLineIndices(source, start, end, object) {
+    const count = end - start;
+    if (count < 2)
+        return [];
+    if (object.isLineSegments === true) {
+        // already pairs; just validate alignment
+        const aligned = count - (count % 2);
+        return source.slice(start, start + aligned);
+    }
+    const out = [];
+    for (let i = 0; i < count - 1; i++) {
+        out.push(source[start + i], source[start + i + 1]);
+    }
+    if (object.isLineLoop === true && count >= 2) {
+        out.push(source[start + count - 1], source[start]);
+    }
+    return out;
+}
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

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

package/dist/skinning.d.ts

@@ -0,0 +1,15 @@
+import type { ThreeObject3DLike } from './types';
+/**
+ * CPU-side skeletal skinning for SkinnedMesh.
+ * Supports Three.js SkinnedMesh, @pixiv/three-vrm, and VRMA animations.
+ *
+ * Three.js bone transform formula per vertex:
+ *   boneMatrix[i] = skeleton.bones[i].matrixWorld * skeleton.boneInverses[i]
+ *   skinMatrix = sum(weight[i] * boneMatrix[skinIndex[i]])
+ *   worldPos = mesh.bindMatrixInverse * skinMatrix * mesh.bindMatrix * localPos
+ */
+export declare function applyCpuSkinning(mesh: ThreeObject3DLike, positions: number[], normals: number[] | null): {
+    positions: number[];
+    normals: number[] | null;
+};
+//# sourceMappingURL=skinning.d.ts.map

package/dist/skinning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skinning.d.ts","sourceRoot":"","sources":["../api/skinning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAQ,MAAM,SAAS,CAAA;AAItD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,GACvB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAyFnD"}

package/dist/skinning.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyCpuSkinning = applyCpuSkinning;
+const math_1 = require("./math");
+const attributes_1 = require("./attributes");
+/**
+ * CPU-side skeletal skinning for SkinnedMesh.
+ * Supports Three.js SkinnedMesh, @pixiv/three-vrm, and VRMA animations.
+ *
+ * Three.js bone transform formula per vertex:
+ *   boneMatrix[i] = skeleton.bones[i].matrixWorld * skeleton.boneInverses[i]
+ *   skinMatrix = sum(weight[i] * boneMatrix[skinIndex[i]])
+ *   worldPos = mesh.bindMatrixInverse * skinMatrix * mesh.bindMatrix * localPos
+ */
+function applyCpuSkinning(mesh, positions, normals) {
+    const geometry = mesh.geometry;
+    const skeleton = mesh.skeleton;
+    const skinIndexAttr = (0, attributes_1.getAttribute)(geometry, 'skinIndex');
+    const skinWeightAttr = (0, attributes_1.getAttribute)(geometry, 'skinWeight');
+    if (!skinIndexAttr || !skinWeightAttr || !skeleton) {
+        return { positions, normals };
+    }
+    if (typeof skeleton.update === 'function') {
+        skeleton.update();
+    }
+    const bones = skeleton.bones;
+    const boneInverses = skeleton.boneInverses;
+    if (!bones || !boneInverses || bones.length === 0) {
+        return { positions, normals };
+    }
+    const boneCount = bones.length;
+    const boneMatrices = new Array(boneCount);
+    for (let i = 0; i < boneCount; i++) {
+        const boneWorld = bones[i]?.matrixWorld?.elements;
+        const boneInv = boneInverses[i]?.elements;
+        if (!boneWorld || !boneInv) {
+            boneMatrices[i] = math_1.IDENTITY_4X4;
+            continue;
+        }
+        boneMatrices[i] = (0, math_1.multiplyMatrices)(Array.from(boneWorld), Array.from(boneInv));
+    }
+    const bindMatrix = mesh.bindMatrix?.elements
+        ? Array.from(mesh.bindMatrix.elements)
+        : math_1.IDENTITY_4X4;
+    const bindMatrixInverse = mesh.bindMatrixInverse?.elements
+        ? Array.from(mesh.bindMatrixInverse.elements)
+        : (0, math_1.invertMatrix4)(bindMatrix);
+    const vertexCount = positions.length / 3;
+    const skinnedPositions = new Array(positions.length);
+    const skinnedNormals = normals ? new Array(normals.length) : null;
+    for (let vi = 0; vi < vertexCount; vi++) {
+        const ji0 = Math.floor((0, attributes_1.attributeComponent)(skinIndexAttr, vi, 0));
+        const ji1 = Math.floor((0, attributes_1.attributeComponent)(skinIndexAttr, vi, 1));
+        const ji2 = Math.floor((0, attributes_1.attributeComponent)(skinIndexAttr, vi, 2));
+        const ji3 = Math.floor((0, attributes_1.attributeComponent)(skinIndexAttr, vi, 3));
+        const jw0 = (0, attributes_1.attributeComponent)(skinWeightAttr, vi, 0);
+        const jw1 = (0, attributes_1.attributeComponent)(skinWeightAttr, vi, 1);
+        const jw2 = (0, attributes_1.attributeComponent)(skinWeightAttr, vi, 2);
+        const jw3 = (0, attributes_1.attributeComponent)(skinWeightAttr, vi, 3);
+        const skinMatrix = (0, math_1.blendBoneMatrices)(boneMatrices, boneCount, ji0, ji1, ji2, ji3, jw0, jw1, jw2, jw3);
+        const finalMatrix = (0, math_1.multiplyMatrices)(bindMatrixInverse, (0, math_1.multiplyMatrices)(skinMatrix, bindMatrix));
+        const px = positions[vi * 3];
+        const py = positions[vi * 3 + 1];
+        const pz = positions[vi * 3 + 2];
+        skinnedPositions[vi * 3] = finalMatrix[0] * px + finalMatrix[4] * py + finalMatrix[8] * pz + finalMatrix[12];
+        skinnedPositions[vi * 3 + 1] = finalMatrix[1] * px + finalMatrix[5] * py + finalMatrix[9] * pz + finalMatrix[13];
+        skinnedPositions[vi * 3 + 2] = finalMatrix[2] * px + finalMatrix[6] * py + finalMatrix[10] * pz + finalMatrix[14];
+        if (normals && skinnedNormals) {
+            const nx = normals[vi * 3];
+            const ny = normals[vi * 3 + 1];
+            const nz = normals[vi * 3 + 2];
+            let snx = finalMatrix[0] * nx + finalMatrix[4] * ny + finalMatrix[8] * nz;
+            let sny = finalMatrix[1] * nx + finalMatrix[5] * ny + finalMatrix[9] * nz;
+            let snz = finalMatrix[2] * nx + finalMatrix[6] * ny + finalMatrix[10] * nz;
+            const len = Math.sqrt(snx * snx + sny * sny + snz * snz);
+            if (len > 1e-8) {
+                snx /= len;
+                sny /= len;
+                snz /= len;
+            }
+            skinnedNormals[vi * 3] = snx;
+            skinnedNormals[vi * 3 + 1] = sny;
+            skinnedNormals[vi * 3 + 2] = snz;
+        }
+    }
+    return { positions: skinnedPositions, normals: skinnedNormals };
+}
+//# sourceMappingURL=skinning.js.map