Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.
JavaScript 3d3d-assets3d-modelingagent-skillsagent-toolsai-agentsasset-pipelinecligame-assetsglbgltfmcpmcp-servermodel-context-protocolprocedural-generationprocedural-modelingtext-to-3dthreejstypescript
import { describe, expect, test } from 'bun:test';
import { geometryDiagnostics } from '../geometry';
import { catmullRomPath, smoothOrganic, spiralPath, taperedTube } from '../organic';
import { countTriangles, createPart, createRoot, gameMaterial } from '../primitives';
describe('organic helpers', () => {
test('catmullRomPath returns more points than controls', () => {
const path = catmullRomPath(
[
[0, 0, 0],
[0, 1, 0],
[1, 1, 0],
[1, 0, 0],
],
4,
);
expect(path.length).toBeGreaterThan(4);
expect(path[0]).toEqual([0, 0, 0]);
});
test('taperedTube produces closed tube geometry with smooth shading default', () => {
const path = catmullRomPath(
[
[0, 0, 0],
[0, 0.5, 0],
[0.2, 1, 0],
],
6,
);
const radii = path.map((_, i, arr) => 0.06 * (1 - i / (arr.length - 1)) + 0.02);
const geo = taperedTube(path, radii);
const diag = geometryDiagnostics(geo);
expect(diag.triangles).toBeGreaterThan(100);
expect(diag.degenerateTriangles).toBe(0);
});
test('smoothOrganic increases triangle count', () => {
const base = taperedTube(
[
[0, 0, 0],
[0, 0.4, 0],
],
[0.05, 0.03],
{ radialSegments: 12 },
);
const smooth = smoothOrganic(base, { iterations: 1 });
expect(smooth.getAttribute('position')!.count).toBeGreaterThan(
base.getAttribute('position')!.count,
);
});
test('spiralPath and elliptical taperedTube build closed geometry', () => {
const spiral = spiralPath({
center: [0, 0, 0],
radius: 0.05,
rise: 0.12,
turns: 1.5,
samples: 16,
});
expect(spiral.length).toBeGreaterThan(10);
const path = [
...spiral,
[0, 0.2, 0.05] as [number, number, number],
[0, 0.28, 0.04] as [number, number, number],
];
const radii = path.map((_, i) => 0.02 * (1 - i / (path.length - 1)) + 0.008);
const scale = path.map(() => [0.4, 1.1] as [number, number]);
const geo = taperedTube(path, radii, { radialSegments: 14, sectionScale: scale });
expect(geometryDiagnostics(geo).degenerateTriangles).toBe(0);
});
test('organic creature root builds with QA-friendly triangle budget', async () => {
const root = createRoot('OrganicProbe');
const mat = gameMaterial(0x6a8f5a);
const bodyPath = catmullRomPath(
[
[0, 0.15, 0],
[0.25, 0.22, 0],
[0.45, 0.18, 0],
[0.55, 0.1, 0],
],
5,
);
const radii = bodyPath.map((_, i, a) => 0.12 - (i / (a.length - 1)) * 0.05);
createPart('Body', smoothOrganic(taperedTube(bodyPath, radii)), mat, { parent: root });
expect(countTriangles(root)).toBeGreaterThan(200);
});
});