distark-render 1.1.5 → 1.1.6

package/dist/tests/test-hidden-parts.js

@@ -1,204 +0,0 @@
-/**
- * Visual End-to-End Test: Part Hiding via hiddenValues
- *
- * Scenario
- * --------
- * A character rig has a rightHand limb whose image is solid RED (RGB 255,0,0).
- * Every other part has no image assigned, so only the rightHand can produce red pixels.
- *
- * Test 1 – Baseline (rightHand visible)
- *   hiddenValues: {}
- *   Expected: red pixels ARE present in the rendered canvas.
- *   Purpose:  Proves the test setup is valid (image pipeline works).
- *
- * Test 2 – Hidden (rightHand hidden)
- *   hiddenValues: { rightHand: true }
- *   Expected: ZERO red pixels in the rendered canvas.
- *   This is the RED → GREEN test:
- *     RED:   renderRig.ts ignores hiddenValues → rightHand drawn → red pixels found → FAIL
- *     GREEN: renderRig.ts respects hiddenValues → rightHand excluded → no red pixels → PASS
- *
- * Hand position trace (default rotations = 0, canvas 800×600)
- * ─────────────────────────────────────────────────────────────
- *   character centre      : (400, 400)   [W/2, H/2+100]
- *   shoulder pivot        : (450, 400)   [+50, 0]
- *   rightUpperArm centre  : (450, 360)   [−40 along Y]
- *   elbow pivot           : (450, 320)   [−80 upper arm height]
- *   rightForearm centre   : (450, 285)   [−35 along Y]
- *   wrist pivot           : (450, 250)   [−70 forearm height]
- *   rightHand centre      : (450, 210)   [−40 along Y]
- *   rightHand draw rect   : x∈[410,490], y∈[170,250]  ← well within canvas
- */
-import { CharacterRigRenderer } from '../modules/renderRig.js';
-import { writeFile, mkdir } from 'fs/promises';
-// ─── Constants ────────────────────────────────────────────────────────────────
-const CANVAS_W = 800;
-const CANVAS_H = 600;
-/** Image key used in loadedImages for the red rightHand canvas. */
-const RED_HAND_KEY = 'test://red-right-hand';
-let _createCanvas = null;
-async function getCreateCanvas() {
-    if (_createCanvas)
-        return _createCanvas;
-    try {
-        // @ts-ignore – optional peer dep
-        const m = await import('@napi-rs/canvas'); // eslint-disable-line @typescript-eslint/no-explicit-any
-        _createCanvas = m.createCanvas;
-    }
-    catch {
-        // @ts-ignore – optional peer dep
-        const m = await import('skia-canvas'); // eslint-disable-line @typescript-eslint/no-explicit-any
-        _createCanvas = (m.createCanvas ?? ((w, h) => new m.Canvas(w, h)));
-    }
-    return _createCanvas;
-}
-// ─── Pixel helpers ────────────────────────────────────────────────────────────
-/**
- * Count pixels that are "clearly red": r>200, g<50, b<50, not transparent.
- * The threshold tolerates minor sub-pixel anti-aliasing.
- */
-function countRedPixels(data) {
-    let n = 0;
-    for (let i = 0; i < data.length; i += 4) {
-        if (data[i] > 200 && data[i + 1] < 50 && data[i + 2] < 50 && data[i + 3] > 0)
-            n++;
-    }
-    return n;
-}
-// ─── Rig factory ──────────────────────────────────────────────────────────────
-/**
- * Build a minimal RigData where ONLY rightHand has an image (solid red).
- * All other image slots are empty so only rightHand can produce red pixels.
- *
- * @param hidden - when true, sets hiddenValues: { rightHand: true }
- */
-function makeTestRig(hidden) {
-    return {
-        id: 'hidden-parts-test',
-        imagePaths: {
-            rightHand: RED_HAND_KEY, // only rightHand has an image
-        },
-        rotationValues: {},
-        selfRotationValues: {},
-        dimensionValues: {
-            rightUpperArm: { width: 30, height: 80 },
-            rightForearm: { width: 25, height: 70 },
-            rightHand: { width: 80, height: 80 },
-        },
-        pivotPoints: {
-            'torso_rightUpperArm': { x: 50, y: 0 },
-            'rightUpperArm_rightForearm': { x: 0, y: 0 },
-            'rightForearm_rightHand': { x: 0, y: 0 },
-        },
-        zIndexValues: {},
-        hiddenValues: hidden ? { rightHand: true } : {},
-        jointOffset: {},
-        eyes: {},
-    };
-}
-// ─── Render helper ────────────────────────────────────────────────────────────
-/**
- * Render `rigData` onto a fresh canvas and return the canvas.
- * Saves a debug PNG to test-outputs/.
- */
-async function renderRig(createCanvas, rigData, redHandCanvas, label) {
-    const canvas = createCanvas(CANVAS_W, CANVAS_H);
-    const ctx = canvas.getContext('2d');
-    // Fill background with distark_render's default grey
-    ctx.fillStyle = '#f0f0f0';
-    ctx.fillRect(0, 0, CANVAS_W, CANVAS_H);
-    const loadedImages = {
-        [RED_HAND_KEY]: redHandCanvas,
-    };
-    const renderer = new CharacterRigRenderer();
-    const renderOptions = {
-        canvasWidth: CANVAS_W,
-        canvasHeight: CANVAS_H,
-        loadedImages: loadedImages,
-    };
-    const { objects } = renderer.computeCharacterRigData(rigData, renderOptions);
-    for (const obj of objects) {
-        if (!obj.imageData)
-            continue;
-        ctx.save();
-        ctx.translate(obj.x, obj.y);
-        ctx.rotate(obj.rotation);
-        ctx.scale(obj.scaleX, obj.scaleY);
-        ctx.drawImage(obj.imageData, -obj.width * obj.anchorX, -obj.height * obj.anchorY, obj.width, obj.height);
-        ctx.restore();
-    }
-    // Persist debug PNG
-    await mkdir('test-outputs', { recursive: true });
-    const buf = await canvas.toBuffer('image/png');
-    await writeFile(`test-outputs/hidden-parts-${label}.png`, buf);
-    console.log(`  📷 Saved test-outputs/hidden-parts-${label}.png`);
-    return canvas;
-}
-// ─── Main ─────────────────────────────────────────────────────────────────────
-async function main() {
-    console.log('\n🧪 Hidden Parts — Visual E2E Test');
-    console.log('='.repeat(54));
-    console.log('Character: rightHand limb → solid RED image (255,0,0)');
-    console.log('All other parts: no image assigned');
-    console.log('Test: hiddenValues.rightHand=true must produce ZERO red pixels\n');
-    const createCanvas = await getCreateCanvas();
-    // Build a solid-red 80×80 canvas that represents the rightHand image
-    const redHandCanvas = createCanvas(80, 80);
-    const rctx = redHandCanvas.getContext('2d');
-    rctx.fillStyle = 'rgb(255,0,0)';
-    rctx.fillRect(0, 0, 80, 80);
-    let passed = 0;
-    let failed = 0;
-    // ── Test 1: Baseline — rightHand IS visible ─────────────────────────────
-    console.log('[1/2] Baseline — no hiddenValues (rightHand should be visible)');
-    {
-        const rig = makeTestRig(false);
-        const canvas = await renderRig(createCanvas, rig, redHandCanvas, 'baseline');
-        const ctx = canvas.getContext('2d');
-        const { data } = ctx.getImageData(0, 0, CANVAS_W, CANVAS_H);
-        const redCount = countRedPixels(data);
-        if (redCount > 0) {
-            console.log(`  ✅ PASS — ${redCount} red pixels found; rightHand rendered correctly`);
-            passed++;
-        }
-        else {
-            console.log('  ❌ FAIL — 0 red pixels; rightHand image never drawn (broken test setup)');
-            failed++;
-        }
-    }
-    // ── Test 2: Hidden — rightHand must NOT appear ──────────────────────────
-    console.log('\n[2/2] Hidden — hiddenValues: { rightHand: true }');
-    {
-        const rig = makeTestRig(true);
-        const canvas = await renderRig(createCanvas, rig, redHandCanvas, 'hidden');
-        const ctx = canvas.getContext('2d');
-        const { data } = ctx.getImageData(0, 0, CANVAS_W, CANVAS_H);
-        const redCount = countRedPixels(data);
-        if (redCount === 0) {
-            console.log('  ✅ PASS — 0 red pixels; rightHand correctly excluded from render');
-            passed++;
-        }
-        else {
-            console.log(`  ❌ FAIL — ${redCount} red pixels found; ` +
-                'rightHand rendered despite hiddenValues.rightHand = true\n' +
-                '  └─ Fix: ensure computeCharacterRigData() skips parts where hiddenValues[part] === true');
-            failed++;
-        }
-    }
-    // ── Summary ─────────────────────────────────────────────────────────────
-    console.log('\n' + '='.repeat(54));
-    console.log(`📊 Results: ${passed}/2 passed`);
-    if (failed === 0) {
-        console.log('✅ All hidden-parts tests PASSED\n');
-        process.exit(0);
-    }
-    else {
-        console.log('❌ Hidden-parts test(s) FAILED\n');
-        process.exit(1);
-    }
-}
-main().catch(err => {
-    console.error('Fatal error:', err);
-    process.exit(1);
-});
-//# sourceMappingURL=test-hidden-parts.js.map

package/dist/tests/test-hidden-parts.js.map

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