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 {
DEFAULT_PRESENTATION_PARAMETERS_V1,
PRESENTATION_MAX_TOTAL_PIXELS_V1,
canonicalPresentationDocumentV1Json,
createDefaultPresentationDocumentV1,
createDefaultPresentationParametersV1,
parsePresentationDocumentV1,
parsePresentationParametersV1,
} from './index';
const WORLD_SHA256 = `sha256:${'a'.repeat(64)}` as const;
describe('default PresentationDocumentV1', () => {
test('owns one strict, bounded, ordered neutral inspection presentation', () => {
const parameters = createDefaultPresentationParametersV1();
expect(parameters).toEqual(DEFAULT_PRESENTATION_PARAMETERS_V1);
expect(parameters).not.toBe(DEFAULT_PRESENTATION_PARAMETERS_V1);
expect(parsePresentationParametersV1(parameters)).toEqual(parameters);
expect(parameters).toMatchObject({
schemaVersion: 'kiln.presentation.v1',
grid: { columns: 3, rows: 1, cellWidth: 512, cellHeight: 512 },
lightingPresetId: 'review-neutral-v1',
receiptPolicy: {
requirePerCameraOutputSha256: true,
requireOutputSetSha256: true,
},
});
expect(parameters.cameras.map(({ id, cell }) => ({ id, cell }))).toEqual([
{ id: 'front-right', cell: { column: 0, row: 0 } },
{ id: 'front-left', cell: { column: 1, row: 0 } },
{ id: 'rear-overview', cell: { column: 2, row: 0 } },
]);
expect(parameters.cameras).toHaveLength(3);
expect(parameters.cameras.every((camera) => camera.aspect === 1)).toBe(true);
});
test('returns fresh parameters while the exported default remains deeply frozen', () => {
expect(Object.isFrozen(DEFAULT_PRESENTATION_PARAMETERS_V1)).toBe(true);
expect(Object.isFrozen(DEFAULT_PRESENTATION_PARAMETERS_V1.grid)).toBe(true);
expect(Object.isFrozen(DEFAULT_PRESENTATION_PARAMETERS_V1.cameras)).toBe(true);
expect(Object.isFrozen(DEFAULT_PRESENTATION_PARAMETERS_V1.cameras[0])).toBe(true);
expect(Object.isFrozen(DEFAULT_PRESENTATION_PARAMETERS_V1.cameras[0]?.position)).toBe(true);
const first = createDefaultPresentationParametersV1();
first.cameras[0]!.position[0] = 999;
const second = createDefaultPresentationParametersV1();
expect(second.cameras[0]!.position[0]).not.toBe(999);
expect(second).toEqual(DEFAULT_PRESENTATION_PARAMETERS_V1);
});
test('binds the canonical document to exact world or GLB bytes deterministically', () => {
const worldA = createDefaultPresentationDocumentV1({
kind: 'world',
sha256: WORLD_SHA256,
});
const worldB = createDefaultPresentationDocumentV1({
kind: 'world',
sha256: WORLD_SHA256,
});
const glb = createDefaultPresentationDocumentV1({
kind: 'glb',
sha256: WORLD_SHA256,
});
expect(parsePresentationDocumentV1(worldA)).toEqual(worldA);
expect(worldA).toEqual(worldB);
expect(worldA).not.toBe(worldB);
expect(worldA.artifactBinding).toEqual({ kind: 'world', sha256: WORLD_SHA256 });
expect(glb.artifactBinding.kind).toBe('glb');
expect(canonicalPresentationDocumentV1Json(worldA)).toBe(
canonicalPresentationDocumentV1Json(worldB),
);
});
test('rejects malformed artifact bindings at the factory boundary', () => {
expect(() =>
createDefaultPresentationDocumentV1({ kind: 'world', sha256: 'not-a-hash' }),
).toThrow();
expect(() =>
createDefaultPresentationDocumentV1({
kind: 'world',
sha256: WORLD_SHA256,
path: '../escape.glb',
}),
).toThrow();
});
test('enforces the renderer-aligned aggregate camera pixel ceiling', () => {
const cameras = Array.from({ length: 12 }, (_, index) => ({
id: `camera-${index}`,
cell: { column: index % 4, row: Math.floor(index / 4) },
position: [index + 1, 2, 3] as [number, number, number],
target: [0, 0, 0] as [number, number, number],
up: [0, 1, 0] as [number, number, number],
fovDeg: 50,
aspect: 1,
near: 0.05,
far: 100,
}));
expect(PRESENTATION_MAX_TOTAL_PIXELS_V1).toBe(16_777_216);
expect(() =>
parsePresentationParametersV1({
...createDefaultPresentationParametersV1(),
grid: { columns: 4, rows: 3, cellWidth: 4096, cellHeight: 4096 },
cameras,
}),
).toThrow(/total pixel budget/i);
expect(
parsePresentationParametersV1({
...createDefaultPresentationParametersV1(),
grid: { columns: 4, rows: 1, cellWidth: 2048, cellHeight: 2048 },
cameras: cameras.slice(0, 4).map((camera) => ({
...camera,
cell: { column: camera.cell.column, row: 0 },
})),
}).cameras,
).toHaveLength(4);
});
});