distark-render 1.0.5 → 1.0.7

package/README.md

@@ -1,154 +1,158 @@
-# Distark Render
-
-Rendering-agnostic character rig system with TypeScript. Render 2D character rigs to HTML Canvas with automatic image loading and caching.
-
-## Installation
-
-```bash
-npm install distark-render
-```
-
-## Usage
-
-### Browser (ES Modules)
-
-```html
-<canvas id="canvas" width="800" height="800"></canvas>
-
-<script type="module">
-  import { ImageLoader, CharacterRigRenderer } from 'https://unpkg.com/distark-render';
-
-  const imageLoader = new ImageLoader();
-  const renderer = new CharacterRigRenderer(imageLoader);
-  const canvas = document.getElementById('canvas');
-
-  // Load character data
-  const characterData = await fetch('character.json').then(r => r.json());
-
-  // Render to canvas
-  await renderer.render(canvas, characterData);
-</script>
-```
-
-### Node.js
-
-```javascript
-import { ImageLoader, CharacterRigRenderer } from 'distark-render';
-
-const imageLoader = new ImageLoader();
-const renderer = new CharacterRigRenderer(imageLoader);
-const canvas = document.getElementById('canvas');
-const characterData = await fetch('character.json').then(r => r.json());
-await renderer.render(canvas, characterData);
-```
-
-## Features
-
-- 🎨 Rendering-agnostic architecture
-- 🖼️ Automatic image loading and caching
-- 🔄 Support for MD5 hashes and direct URLs
-- 👁️ Eye and mouth animation systems
-- ⚡ TypeScript support with full type definitions
-- 🌐 Works in browser and Node.js
-
-## Testing
-
-### Automated Test Suite
-
-Run all automated tests to verify rendering and joint movement:
-
-```bash
-# Run all tests (visual verification + joint movement)
-npm test
-
-# Or run tests individually
-npm run test-visual    # Eyes and mouth rendering
-npm run test-joints    # Joint movement and limb positioning
-```
-
-### Visual Verification Test
-
-Verify that eyes and mouth are rendering correctly using automated color comparison:
-
-```bash
-# Test a specific character file
-npm run test-visual
-node dist/tests/test-visual-verification.js character.json
-```
-
-**What it tests:**
-- ✅ Left eye region has rendered content
-- ✅ Right eye region has rendered content  
-- ✅ Mouth region has rendered content
-
-The test uses pixel sampling and color comparison to verify that character features are actually being rendered to the canvas. It calculates expected regions based on the rig data and checks that those regions contain pixels different from the background color.
-
-### Joint Movement Test
-
-Verify that character joints move correctly and limbs appear in expected screen sectors:
-
-```bash
-# Test joint movements
-npm run test-joints
-node dist/tests/test-joint-movement.js character.json
-```
-
-**What it tests:**
-- ✅ **Arm Raised**: Left arm rotates upward and appears in top/middle-left sector
-- ✅ **Leg Forward**: Right leg moves forward and appears in middle/bottom-right sector  
-- ✅ **Head Rotation**: Head turns and remains in top/middle-center sector
-- ✅ **Multiple Joints**: Arms spread and legs move simultaneously (T-pose)
-
-The test modifies joint rotation values and verifies that limbs render in the expected screen sectors by sampling pixels and checking for content (non-background pixels). This ensures the rendering pipeline correctly applies transformations to the character rig.
-
-### Manual Testing with Command Line
-
-You can also manually test character rigs and save rendered output:
-
-```bash
-# Build the project first
-npm run build
-
-# Run test-skia with default settings (renders tank.json)
-npm run test-skia
-
-# Or run directly with custom parameters:
-node dist/tests/test-skia.js [input.json] [output.png] [width] [height]
-
-# Examples:
-node dist/tests/test-skia.js tank.json output.png 1000 1000
-node dist/tests/test-skia.js character.json render.png 800 600
-```
-
-**Parameters:**
-- `input.json` - Path to your character rig JSON file (default: `assets/tank.json`)
-- `output.png` - Output image filename (default: `output-tank.png`)
-- `width` - Canvas width in pixels (default: `1000`)
-- `height` - Canvas height in pixels (default: `1000`)
-
-The test script will:
-1. Load your character rig JSON
-2. Automatically fetch and cache all images
-3. Render the character to a PNG file
-4. Show pivot points for debugging
-
-## API
-
-### ImageLoader
-
-Handles loading images from URLs or MD5 hashes with automatic caching.
-
-```typescript
-const imageLoader = new ImageLoader(baseHost?: string);
-```
-
-### CharacterRigRenderer
-
-Renders character rigs to canvas.
-
-```typescript
-const renderer = new CharacterRigRenderer(imageLoader?: ImageLoader);
-await renderer.render(canvas, rigData, loadedImages?, cameraOffset?, showPivotPoints?);
-```
-
-
+# Distark Render
+
+Rendering-agnostic character rig system with TypeScript. Render 2D character rigs to HTML Canvas with automatic image loading and caching.
+
+## Installation
+
+```bash
+npm install distark-render
+```
+
+## Usage
+
+### Browser (ES Modules)
+
+```html
+<canvas id="canvas" width="800" height="800"></canvas>
+
+<script type="module">
+  import { ImageLoader, CharacterRigRenderer } from 'https://unpkg.com/distark-render';
+
+  const imageLoader = new ImageLoader();
+  const renderer = new CharacterRigRenderer(imageLoader);
+  const canvas = document.getElementById('canvas');
+
+  // Load character data
+  const characterData = await fetch('character.json').then(r => r.json());
+
+  // Render to canvas
+  await renderer.render(canvas, characterData);
+</script>
+```
+
+### Node.js
+
+```javascript
+import { ImageLoader, CharacterRigRenderer } from 'distark-render';
+
+const imageLoader = new ImageLoader();
+const renderer = new CharacterRigRenderer(imageLoader);
+const canvas = document.getElementById('canvas');
+const characterData = await fetch('character.json').then(r => r.json());
+await renderer.render(canvas, characterData);
+```
+
+## Features
+
+- 🎨 Rendering-agnostic architecture
+- 🖼️ Automatic image loading and caching
+- 🔄 Support for MD5 hashes and direct URLs
+- 👁️ Eye and mouth animation systems
+- ⚡ TypeScript support with full type definitions
+- 🌐 Works in browser and Node.js
+
+## Testing
+
+### Automated Test Suite
+
+Run all automated tests to verify rendering and joint movement:
+
+```bash
+# Run all tests (visual verification + joint movement)
+npm test
+
+# Or run tests individually
+npm run test-visual    # Eyes and mouth rendering
+npm run test-joints    # Joint movement and limb positioning
+```
+
+### Visual Verification Test
+
+Verify that eyes and mouth are rendering correctly using automated color comparison:
+
+```bash
+# Test a specific character file
+npm run test-visual
+node dist/tests/test-visual-verification.js character.json
+```
+
+**What it tests:**
+- ✅ Left eye region has rendered content
+- ✅ Right eye region has rendered content  
+- ✅ Mouth region has rendered content
+
+The test uses pixel sampling and color comparison to verify that character features are actually being rendered to the canvas. It calculates expected regions based on the rig data and checks that those regions contain pixels different from the background color.
+
+### Joint Movement Test
+
+Verify that character joints move correctly and limbs appear in expected screen sectors:
+
+```bash
+# Test joint movements
+npm run test-joints
+node dist/tests/test-joint-movement.js character.json
+```
+
+**What it tests:**
+- ✅ **Arm Raised**: Left arm rotates upward and appears in top/middle-left sector
+- ✅ **Leg Forward**: Right leg moves forward and appears in middle/bottom-right sector  
+- ✅ **Head Rotation**: Head turns and remains in top/middle-center sector
+- ✅ **Multiple Joints**: Arms spread and legs move simultaneously (T-pose)
+
+The test modifies joint rotation values and verifies that limbs render in the expected screen sectors by sampling pixels and checking for content (non-background pixels). This ensures the rendering pipeline correctly applies transformations to the character rig.
+
+### Manual Testing with Command Line
+
+You can also manually test character rigs and save rendered output:
+
+```bash
+# Build the project first
+npm run build
+
+# Run test-skia with default settings (renders tank.json)
+npm run test-skia
+
+# Or run directly with custom parameters:
+node dist/tests/test-skia.js [input.json] [output.png] [width] [height]
+
+# Examples:
+node dist/tests/test-skia.js tank.json output.png 1000 1000
+node dist/tests/test-skia.js character.json render.png 800 600
+```
+
+**Parameters:**
+- `input.json` - Path to your character rig JSON file (default: `assets/tank.json`)
+- `output.png` - Output image filename (default: `output-tank.png`)
+- `width` - Canvas width in pixels (default: `1000`)
+- `height` - Canvas height in pixels (default: `1000`)
+
+The test script will:
+1. Load your character rig JSON
+2. Automatically fetch and cache all images
+3. Render the character to a PNG file
+4. Show pivot points for debugging
+
+## API
+
+### ImageLoader
+
+Handles loading images from URLs or MD5 hashes with automatic caching.
+
+```typescript
+const imageLoader = new ImageLoader(baseHost?: string);
+```
+
+### CharacterRigRenderer
+
+Renders character rigs to canvas.
+
+```typescript
+const renderer = new CharacterRigRenderer(imageLoader?: ImageLoader);
+await renderer.render(canvas, rigData, loadedImages?, cameraOffset?, showPivotPoints?);
+```
+
+### In action
+https://studyturtle.com
+https://www.youtube.com/@studyturtlehq
+
+

package/dist/cli/animate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * animate command - Render animation keyframes to numbered PNGs with a manifest
+ *
+ * Usage:
+ *   distark-check animate <rig.json> <animation.json> [-o frames/] [--width 1000] [--height 1000]
+ */
+export declare function runAnimate(args: string[]): Promise<void>;
+//# sourceMappingURL=animate.d.ts.map

package/dist/cli/animate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate.d.ts","sourceRoot":"","sources":["../../cli/animate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgCH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuH9D"}

package/dist/cli/animate.js

@@ -0,0 +1,121 @@
+/**
+ * animate command - Render animation keyframes to numbered PNGs with a manifest
+ *
+ * Usage:
+ *   distark-check animate <rig.json> <animation.json> [-o frames/] [--width 1000] [--height 1000]
+ */
+import { SkiaRenderer } from '../modules/adapters/skiaRenderer.js';
+import { expandDiffBasedAnimation, isDiffBasedFormat } from '../modules/animationDiff.js';
+import { readFile, writeFile, mkdir } from 'fs/promises';
+function objBounds(obj) {
+    return {
+        x: Math.round(obj.x - obj.width * obj.anchorX),
+        y: Math.round(obj.y - obj.height * obj.anchorY),
+        w: Math.round(obj.width),
+        h: Math.round(obj.height),
+    };
+}
+export async function runAnimate(args) {
+    const positional = args.filter(a => !a.startsWith('-'));
+    const rigFile = positional[0];
+    const animFile = positional[1];
+    if (!rigFile || !animFile) {
+        console.error('Usage: distark-check animate <rig.json> <animation.json> [-o frames/] [--width N] [--height N]');
+        process.exit(1);
+    }
+    const outIdx = args.indexOf('-o');
+    const outputDir = outIdx !== -1 ? args[outIdx + 1] : 'frames';
+    const width = parseInt(args[args.indexOf('--width') + 1]) || 1000;
+    const height = parseInt(args[args.indexOf('--height') + 1]) || 1000;
+    const rigData = JSON.parse(await readFile(rigFile, 'utf-8'));
+    const animRaw = JSON.parse(await readFile(animFile, 'utf-8'));
+    // Expand animation frames (handles both diff and full-state formats)
+    let frames;
+    if (isDiffBasedFormat(animRaw)) {
+        frames = expandDiffBasedAnimation(animRaw);
+    }
+    else if (Array.isArray(animRaw)) {
+        frames = animRaw;
+    }
+    else {
+        console.error('Unrecognized animation format');
+        process.exit(1);
+    }
+    await mkdir(outputDir, { recursive: true });
+    // Redirect console.log to stderr during image loading
+    const origLog = console.log;
+    console.log = (...a) => console.error(...a);
+    const renderer = new SkiaRenderer();
+    await renderer.loadImages(rigData);
+    console.log = origLog;
+    const manifest = {
+        rig_input: rigFile,
+        animation_input: animFile,
+        frame_count: frames.length,
+        output_dir: outputDir,
+        frames: [],
+    };
+    let prevBoundsMap = null;
+    for (let i = 0; i < frames.length; i++) {
+        const frame = frames[i];
+        const mergedRig = {
+            ...rigData,
+            ...frame,
+            rotationValues: { ...rigData.rotationValues, ...frame.rotationValues },
+            selfRotationValues: { ...rigData.selfRotationValues, ...frame.selfRotationValues },
+            dimensionValues: { ...rigData.dimensionValues, ...frame.dimensionValues },
+            pivotPoints: { ...rigData.pivotPoints, ...frame.pivotPoints },
+            zIndexValues: { ...rigData.zIndexValues, ...frame.zIndexValues },
+        };
+        const padded = String(i).padStart(3, '0');
+        const filename = `${outputDir}/${padded}.png`;
+        await renderer.renderToFile(filename, mergedRig, {
+            canvasWidth: width,
+            canvasHeight: height,
+            showPivots: false,
+        });
+        const renderData = renderer.compute(mergedRig, { canvasWidth: width, canvasHeight: height });
+        const boundsMap = {};
+        const currentPosMap = {};
+        for (const obj of renderData.objects) {
+            boundsMap[obj.name] = objBounds(obj);
+            currentPosMap[obj.name] = { x: Math.round(obj.x), y: Math.round(obj.y), rot: obj.rotation };
+        }
+        const entry = {
+            index: i,
+            file: `${padded}.png`,
+            character_bounds: boundsMap,
+        };
+        // Compute deltas from previous frame
+        if (prevBoundsMap) {
+            const deltas = {};
+            for (const [name, pos] of Object.entries(currentPosMap)) {
+                const prev = prevBoundsMap[name];
+                if (prev) {
+                    const dx = pos.x - prev.x;
+                    const dy = pos.y - prev.y;
+                    const dRot = Math.round((pos.rot - prev.rot) * 180 / Math.PI * 100) / 100;
+                    if (dx !== 0 || dy !== 0 || Math.abs(dRot) > 0.01) {
+                        const delta = {};
+                        if (dx !== 0 || dy !== 0)
+                            delta.moved = { dx, dy };
+                        if (Math.abs(dRot) > 0.01)
+                            delta.rotated = dRot;
+                        deltas[name] = delta;
+                    }
+                }
+            }
+            if (Object.keys(deltas).length > 0) {
+                entry.delta_from_prev = deltas;
+            }
+        }
+        prevBoundsMap = currentPosMap;
+        manifest.frames.push(entry);
+        console.error(`Frame ${i}/${frames.length - 1}: ${filename}`);
+    }
+    const manifestFile = `${outputDir}/manifest.json`;
+    await writeFile(manifestFile, JSON.stringify(manifest, null, 2));
+    // Output manifest to stdout for LLM
+    console.log(JSON.stringify(manifest, null, 2));
+}
+//# sourceMappingURL=animate.js.map

package/dist/cli/animate.js.map

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

package/dist/cli/diff.d.ts

@@ -0,0 +1,8 @@
+/**
+ * diff command - Compare two rendered PNGs and output a pixel-diff image + report
+ *
+ * Usage:
+ *   distark-check diff <before.png> <after.png> [-o diff.png] [--threshold 10]
+ */
+export declare function runDiff(args: string[]): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../cli/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqI3D"}

package/dist/cli/diff.js

@@ -0,0 +1,124 @@
+/**
+ * diff command - Compare two rendered PNGs and output a pixel-diff image + report
+ *
+ * Usage:
+ *   distark-check diff <before.png> <after.png> [-o diff.png] [--threshold 10]
+ */
+import { readFile, writeFile } from 'fs/promises';
+export async function runDiff(args) {
+    const positional = args.filter(a => !a.startsWith('-'));
+    const beforeFile = positional[0];
+    const afterFile = positional[1];
+    if (!beforeFile || !afterFile) {
+        console.error('Usage: distark-check diff <before.png> <after.png> [-o diff.png] [--threshold N]');
+        process.exit(1);
+    }
+    const outIdx = args.indexOf('-o');
+    const diffFile = outIdx !== -1 ? args[outIdx + 1] : 'diff.png';
+    const threshIdx = args.indexOf('--threshold');
+    const threshold = threshIdx !== -1 ? parseInt(args[threshIdx + 1]) : 10;
+    // Dynamic import skia-canvas
+    let loadImage;
+    let createCanvas;
+    try {
+        // @ts-ignore - Optional dependency
+        const mod = await import('@napi-rs/canvas');
+        loadImage = mod.loadImage;
+        createCanvas = mod.createCanvas;
+    }
+    catch {
+        const mod = await import('skia-canvas');
+        loadImage = mod.loadImage;
+        createCanvas = mod.Canvas
+            ? (w, h) => new mod.Canvas(w, h)
+            : mod.createCanvas;
+    }
+    // Load both images
+    const beforeBuf = await readFile(beforeFile);
+    const afterBuf = await readFile(afterFile);
+    const beforeImg = await loadImage(beforeBuf);
+    const afterImg = await loadImage(afterBuf);
+    const width = beforeImg.width;
+    const height = beforeImg.height;
+    if (afterImg.width !== width || afterImg.height !== height) {
+        console.error(`Image dimensions mismatch: ${width}x${height} vs ${afterImg.width}x${afterImg.height}`);
+        process.exit(1);
+    }
+    // Draw both to get pixel data
+    const canvasBefore = createCanvas(width, height);
+    const ctxBefore = canvasBefore.getContext('2d');
+    ctxBefore.drawImage(beforeImg, 0, 0);
+    const dataBefore = ctxBefore.getImageData(0, 0, width, height);
+    const canvasAfter = createCanvas(width, height);
+    const ctxAfter = canvasAfter.getContext('2d');
+    ctxAfter.drawImage(afterImg, 0, 0);
+    const dataAfter = ctxAfter.getImageData(0, 0, width, height);
+    // Create diff image
+    const canvasDiff = createCanvas(width, height);
+    const ctxDiff = canvasDiff.getContext('2d');
+    const diffData = ctxDiff.createImageData(width, height);
+    let changedPixels = 0;
+    const totalPixels = width * height;
+    // Track per-sector changes (3x3 grid)
+    const sectorW = width / 3;
+    const sectorH = height / 3;
+    const sectorChanges = new Array(9).fill(0);
+    const sectorTotals = new Array(9).fill(0);
+    const sectorNames = [
+        'Top-Left', 'Top-Center', 'Top-Right',
+        'Middle-Left', 'Middle-Center', 'Middle-Right',
+        'Bottom-Left', 'Bottom-Center', 'Bottom-Right',
+    ];
+    for (let i = 0; i < dataBefore.data.length; i += 4) {
+        const pixelIdx = i / 4;
+        const px = pixelIdx % width;
+        const py = Math.floor(pixelIdx / width);
+        const sectorCol = Math.min(Math.floor(px / sectorW), 2);
+        const sectorRow = Math.min(Math.floor(py / sectorH), 2);
+        const sectorIdx = sectorRow * 3 + sectorCol;
+        sectorTotals[sectorIdx]++;
+        const rDiff = Math.abs(dataBefore.data[i] - dataAfter.data[i]);
+        const gDiff = Math.abs(dataBefore.data[i + 1] - dataAfter.data[i + 1]);
+        const bDiff = Math.abs(dataBefore.data[i + 2] - dataAfter.data[i + 2]);
+        if (rDiff > threshold || gDiff > threshold || bDiff > threshold) {
+            changedPixels++;
+            sectorChanges[sectorIdx]++;
+            // Red highlight for changed pixels
+            diffData.data[i] = 255;
+            diffData.data[i + 1] = 0;
+            diffData.data[i + 2] = 0;
+            diffData.data[i + 3] = 255;
+        }
+        else {
+            // Dimmed version of original for context
+            diffData.data[i] = Math.floor(dataAfter.data[i] * 0.3);
+            diffData.data[i + 1] = Math.floor(dataAfter.data[i + 1] * 0.3);
+            diffData.data[i + 2] = Math.floor(dataAfter.data[i + 2] * 0.3);
+            diffData.data[i + 3] = 255;
+        }
+    }
+    ctxDiff.putImageData(diffData, 0, 0);
+    // Save diff image
+    const buffer = await canvasDiff.toBuffer('image/png');
+    await writeFile(diffFile, buffer);
+    const changedRegions = sectorNames
+        .map((name, idx) => ({
+        sector: name,
+        percent_changed: sectorTotals[idx] > 0
+            ? Math.round(sectorChanges[idx] / sectorTotals[idx] * 10000) / 100
+            : 0,
+    }))
+        .filter(r => r.percent_changed > 0);
+    const report = {
+        before: beforeFile,
+        after: afterFile,
+        diff_image: diffFile,
+        dimensions: { width, height },
+        total_pixels: totalPixels,
+        changed_pixels: changedPixels,
+        percent_changed: Math.round(changedPixels / totalPixels * 10000) / 100,
+        changed_regions: changedRegions,
+    };
+    console.log(JSON.stringify(report, null, 2));
+}
+//# sourceMappingURL=diff.js.map

package/dist/cli/diff.js.map

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

package/dist/cli/distark-check.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * distark-check - CLI tool for LLM-driven rig testing
+ *
+ * Commands:
+ *   render   <rig.json>                    Render rig to PNG + JSON report
+ *   verify   <rig.json>                    Math-based sanity checks (no rendering)
+ *   animate  <rig.json> <animation.json>   Render animation frames + manifest
+ *   diff     <before.png> <after.png>      Pixel-diff two images
+ *   query    <image|rig> --prompt "..."     Send to Gemini for visual analysis
+ */
+export {};
+//# sourceMappingURL=distark-check.d.ts.map

package/dist/cli/distark-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distark-check.d.ts","sourceRoot":"","sources":["../../cli/distark-check.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}