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 assert from 'node:assert/strict';
import { describe, it } from 'node:test';
import {
DEFAULT_PRESENTATION_PRESET_ID,
PRESENTATION_PRESET_CAPABILITIES,
PRESENTATION_PRESET_IDS,
SHADOW_FILTERS,
getPresentationPreset,
isPresentationPresetId,
} from '../src/presentation-presets.mjs';
import { buildHealthDocument, RENDER_CAPABILITIES } from '../src/health-contract.mjs';
import {
SUPPORTED_LIGHTING_PRESET_ID,
SUPPORTED_LIGHTING_PRESET_IDS,
buildRenderFidelityV1,
sha256,
validateRenderMode,
} from '../src/contract.mjs';
const camera = {
position: [0, 0, 5],
target: [0, 0, 0],
up: [0, 1, 0],
fovDeg: 35,
aspect: 1,
near: 0.1,
far: 100,
};
function recursivelyFrozen(value) {
if (!value || typeof value !== 'object') return true;
return Object.isFrozen(value) && Object.values(value).every(recursivelyFrozen);
}
describe('versioned presentation preset registry', () => {
it('defaults new captures to a calibrated, white review rig and retains both v1 IDs', () => {
assert.equal(DEFAULT_PRESENTATION_PRESET_ID, 'review-neutral-v1');
const review = getPresentationPreset('review-neutral-v1');
assert.equal(review.toneMapping, 'review-neutral');
assert.deepEqual(review.environment, { type: 'room', sigma: 0.04, intensity: 0.4352 });
assert.equal(review.exposure, 0.9);
assert.deepEqual(review.ambient, {
type: 'hemisphere',
sky: 0xffffff,
ground: 0xffffff,
intensity: 1.0879,
});
for (const [role, intensity] of [
['key', 0.136],
['fill', 0.0204],
['rim', 0.0204],
]) {
assert.equal(review[role].color, 0xffffff);
assert.equal(review[role].intensity, intensity);
}
assert.equal(recursivelyFrozen(review), true);
assert.equal(
validateRenderMode({ cameras: [camera], width: 512, height: 512 }).lightingPresetId,
review.id,
);
for (const id of ['neutral-studio-v1', 'gallery-studio-v1']) {
assert.equal(
validateRenderMode({ cameras: [camera], width: 512, height: 512, lighting_preset_id: id })
.lightingPresetId,
id,
);
}
assert.equal(isPresentationPresetId('neutral-studio-v2'), false);
});
it('pins neutral-studio-v1 to the byte/visual-equivalent renderer values', () => {
assert.equal(DEFAULT_PRESENTATION_PRESET_ID, 'review-neutral-v1');
assert.deepEqual(PRESENTATION_PRESET_IDS, [
'neutral-studio-v1',
'gallery-studio-v1',
'review-neutral-v1',
]);
assert.equal(Object.isFrozen(PRESENTATION_PRESET_IDS), true);
assert.equal(Object.isFrozen(PRESENTATION_PRESET_CAPABILITIES), true);
assert.equal(SUPPORTED_LIGHTING_PRESET_ID, DEFAULT_PRESENTATION_PRESET_ID);
assert.equal(SUPPORTED_LIGHTING_PRESET_IDS, PRESENTATION_PRESET_IDS);
assert.deepEqual(getPresentationPreset('neutral-studio-v1'), {
id: 'neutral-studio-v1',
environment: { type: 'room', sigma: 0.04 },
exposure: 1.38,
ambient: { type: 'hemisphere', sky: 0xffffff, ground: 0x6f7888, intensity: 2 },
sun: { enabled: false },
key: {
enabled: true,
color: 0xffffff,
intensity: 3,
position: [4, 7, 5],
castsShadow: false,
},
fill: {
enabled: true,
color: 0xdce8ff,
intensity: 1.8,
position: [-4, 3, 2],
castsShadow: false,
},
rim: {
enabled: true,
color: 0xffead6,
intensity: 1.2,
position: [-2, 5, -5],
castsShadow: false,
},
shadows: {
enabled: false,
type: 'pcf',
mapSize: [1024, 1024],
bias: 0,
normalBias: 0,
radius: 1,
},
});
assert.equal(recursivelyFrozen(getPresentationPreset('neutral-studio-v1')), true);
});
// `shadows.type` described a filter and selected nothing: the validator demanded the
// string `pcf-soft` while the renderer hardcoded a constant and never read the field.
// r186 then deleted the PCFSoft implementation outright, so the one name the schema
// accepted was the one name that no longer exists. These are the filters that do.
it('offers only shadow filters that r186 left, and every preset names one of them', () => {
assert.deepEqual(SHADOW_FILTERS, ['basic', 'pcf', 'vsm']);
assert.equal(Object.isFrozen(SHADOW_FILTERS), true);
assert.equal(SHADOW_FILTERS.includes('pcf-soft'), false);
for (const id of PRESENTATION_PRESET_IDS) {
const { shadows } = getPresentationPreset(id);
assert.ok(
SHADOW_FILTERS.includes(shadows.type),
`${id} names shadow filter ${shadows.type}, which is not one of ${SHADOW_FILTERS.join(', ')}`,
);
}
});
it('resolves by ID only and rejects unknown IDs at the request and receipt boundaries', () => {
assert.equal(isPresentationPresetId('neutral-studio-v1'), true);
assert.equal(isPresentationPresetId('dramatic-night-v1'), false);
assert.equal(getPresentationPreset('dramatic-night-v1'), undefined);
assert.throws(
() =>
validateRenderMode({
cameras: [camera],
width: 512,
height: 512,
lighting_preset_id: 'dramatic-night-v1',
}),
(error) => error?.status === 400 && /neutral-studio-v1/.test(error.message),
);
for (const nonId of [null, { exposure: 2 }, ['neutral-studio-v1']]) {
assert.throws(
() =>
validateRenderMode({
cameras: [camera],
width: 512,
height: 512,
lighting_preset_id: nonId,
}),
(error) => error?.status === 400 && /neutral-studio-v1/.test(error.message),
);
}
const renderMode = validateRenderMode({ cameras: [camera], width: 512, height: 512 });
assert.throws(
() =>
buildRenderFidelityV1({
rendererId: 'dawn-vulkan:test',
inputGlbSha256: sha256(Buffer.from('glb')),
presentationProfile: 'dramatic-night-v1',
renderMode,
resolvedCameras: renderMode.cameras,
timings: { totalMs: 1 },
}),
(error) => error?.status === 400 && /neutral-studio-v1/.test(error.message),
);
});
it('advertises every registry ID through provider-free health contract data', () => {
assert.deepEqual(PRESENTATION_PRESET_CAPABILITIES, [
'render.profile.neutral-studio-v1',
'render.profile.gallery-studio-v1',
'render.profile.review-neutral-v1',
]);
assert.ok(
PRESENTATION_PRESET_CAPABILITIES.every((capability) =>
RENDER_CAPABILITIES.includes(capability),
),
);
const health = buildHealthDocument(
{
rendererId: 'dawn-vulkan:test',
backend: 'vulkan',
summary: { vendor: 'test' },
},
true,
);
assert.equal(health.presentationProfile, 'review-neutral-v1');
assert.deepEqual(health.lightingPresetIds, [
'neutral-studio-v1',
'gallery-studio-v1',
'review-neutral-v1',
]);
assert.notEqual(health.lightingPresetIds, PRESENTATION_PRESET_IDS);
assert.equal(health.authRequired, true);
});
});