@excalimate/mcp-server 0.3.0 → 0.4.0

package/dist/server/compositeTools.js

@@ -0,0 +1,209 @@
+import { z } from 'zod';
+import { addKeyframesBatchToState } from '../state.js';
+import { ANIMATABLE_PROPERTIES, EASING_TYPES } from '../types.js';
+import { ORIGIN_MAP } from './geometry.js';
+/**
+ * Registers the `create_animated_scene` composite tool.
+ *
+ * This is a high-level tool that replaces the typical multi-call pattern:
+ *   create_scene → add_keyframes_batch → create_sequence → set_clip_range → set_camera_frame
+ *
+ * All operations happen in a single tool call with one SSE broadcast at the end,
+ * reducing AI round-trips from 5-18 to 1 and minimizing network traffic.
+ */
+export function registerCompositeTools(server, ctx, normalizeElements, getElementBounds) {
+    ctx.mutatingTool('create_animated_scene', 'Create a complete animated scene in one call: elements + keyframes + sequences + camera + clip range. ' +
+        'Preferred over calling create_scene, add_keyframes_batch, create_sequence separately. ' +
+        'Only elements is required — all other fields are optional.', {
+        elements: z.string().describe('JSON string of Excalidraw elements array'),
+        keyframes: z.string().optional().describe('JSON array of {targetId, property, time, value, easing?, scaleOrigin?}. ' +
+            'Properties: opacity, translateX, translateY, scaleX, scaleY, rotation, drawProgress.'),
+        sequences: z.string().optional().describe('JSON array of {elementIds: string[], property?: "opacity"|"drawProgress", ' +
+            'startTime?: number, delay?: number, duration?: number}. Creates reveal sequences.'),
+        duration: z.number().optional().describe('Timeline duration in ms (default: 30000)'),
+        clipStart: z.number().optional().describe('Clip start time in ms (default: 0)'),
+        clipEnd: z.number().optional().describe('Clip end time in ms'),
+        cameraFrame: z.object({
+            x: z.number().optional(),
+            y: z.number().optional(),
+            width: z.number().optional(),
+            aspectRatio: z.enum(['16:9', '4:3', '1:1', '3:2']).optional(),
+        }).optional().describe('Camera frame position and size'),
+    }, async ({ elements, keyframes, sequences, duration, clipStart, clipEnd, cameraFrame }) => {
+        const errors = [];
+        const stats = { elements: 0, keyframes: 0, sequences: 0 };
+        // ── 1. Parse and create scene elements ───────────────
+        let parsedElements;
+        try {
+            parsedElements = JSON.parse(elements);
+            if (!Array.isArray(parsedElements)) {
+                return { content: [{ type: 'text', text: 'Error: elements must be a JSON array' }] };
+            }
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error parsing elements: ${e}` }] };
+        }
+        const state = ctx.getState();
+        state.scene.elements = normalizeElements(parsedElements);
+        stats.elements = parsedElements.length;
+        // ── 2. Set timeline duration ─────────────────────────
+        if (duration !== undefined) {
+            state.timeline.duration = Math.max(1000, duration);
+        }
+        // ── 3. Camera frame ──────────────────────────────────
+        if (cameraFrame) {
+            if (cameraFrame.x !== undefined)
+                state.cameraFrame.x = cameraFrame.x;
+            if (cameraFrame.y !== undefined)
+                state.cameraFrame.y = cameraFrame.y;
+            if (cameraFrame.width !== undefined)
+                state.cameraFrame.width = cameraFrame.width;
+            if (cameraFrame.aspectRatio !== undefined)
+                state.cameraFrame.aspectRatio = cameraFrame.aspectRatio;
+        }
+        // ── 4. Collect all keyframes into a single batch ─────
+        const allKeyframes = [];
+        const validProperties = new Set(ANIMATABLE_PROPERTIES);
+        const validEasings = new Set(EASING_TYPES);
+        // 4a. Camera initial keyframes (always create at t=0 so camera starts correctly)
+        if (cameraFrame) {
+            const CAMERA_ID = '__camera_frame__';
+            allKeyframes.push({ targetId: CAMERA_ID, property: 'translateX', time: 0, value: 0 }, { targetId: CAMERA_ID, property: 'translateY', time: 0, value: 0 }, { targetId: CAMERA_ID, property: 'scaleX', time: 0, value: 1 }, { targetId: CAMERA_ID, property: 'scaleY', time: 0, value: 1 });
+        }
+        // 4b. User-supplied keyframes
+        if (keyframes) {
+            try {
+                const parsedKfs = JSON.parse(keyframes);
+                if (!Array.isArray(parsedKfs)) {
+                    errors.push('keyframes must be a JSON array — skipped');
+                }
+                else {
+                    // Pre-process scale compensation (same logic as add_keyframes_batch)
+                    const scaleCompensation = new Map();
+                    for (const kf of parsedKfs) {
+                        if (!kf.targetId || !kf.property || kf.time === undefined || kf.value === undefined)
+                            continue;
+                        if (!validProperties.has(kf.property))
+                            continue;
+                        // Collect scale origin compensation data
+                        if ((kf.property === 'scaleX' || kf.property === 'scaleY') && kf.scaleOrigin && kf.scaleOrigin !== 'top-left') {
+                            const key = `${kf.targetId}@${kf.time}`;
+                            const existing = scaleCompensation.get(key) ?? {
+                                targetId: kf.targetId, time: kf.time, sx: 1, sy: 1,
+                                origin: kf.scaleOrigin, easing: kf.easing ?? 'linear',
+                            };
+                            if (kf.property === 'scaleX')
+                                existing.sx = kf.value;
+                            if (kf.property === 'scaleY')
+                                existing.sy = kf.value;
+                            existing.origin = kf.scaleOrigin;
+                            scaleCompensation.set(key, existing);
+                        }
+                        const easing = (kf.easing && validEasings.has(kf.easing)) ? kf.easing : 'linear';
+                        allKeyframes.push({
+                            targetId: kf.targetId,
+                            property: kf.property,
+                            time: kf.time,
+                            value: kf.value,
+                            easing: easing,
+                        });
+                        stats.keyframes++;
+                    }
+                    // Compute scale origin translation compensation
+                    for (const skf of scaleCompensation.values()) {
+                        const [ox, oy] = ORIGIN_MAP[skf.origin] ?? [0.5, 0.5];
+                        const el = state.scene.elements.find((e) => e.id === skf.targetId);
+                        if (!el)
+                            continue;
+                        const bounds = getElementBounds(el);
+                        const w = bounds.maxX - bounds.minX;
+                        const h = bounds.maxY - bounds.minY;
+                        const tx = -w * (skf.sx - 1) * ox;
+                        const ty = -h * (skf.sy - 1) * oy;
+                        const easing = (validEasings.has(skf.easing) ? skf.easing : 'linear');
+                        allKeyframes.push({ targetId: skf.targetId, property: 'translateX', time: skf.time, value: tx, easing }, { targetId: skf.targetId, property: 'translateY', time: skf.time, value: ty, easing });
+                        stats.keyframes += 2;
+                    }
+                }
+            }
+            catch (e) {
+                errors.push(`Error parsing keyframes: ${e}`);
+            }
+        }
+        // 4c. Sequence reveals → expand into keyframes
+        if (sequences) {
+            try {
+                const parsedSeqs = JSON.parse(sequences);
+                if (!Array.isArray(parsedSeqs)) {
+                    errors.push('sequences must be a JSON array — skipped');
+                }
+                else {
+                    for (const seq of parsedSeqs) {
+                        const ids = seq.elementIds;
+                        if (!Array.isArray(ids) || ids.length === 0)
+                            continue;
+                        const prop = (seq.property === 'drawProgress') ? 'drawProgress' : 'opacity';
+                        const startTime = seq.startTime ?? 0;
+                        const delay = seq.delay ?? 300;
+                        const dur = seq.duration ?? 500;
+                        for (let i = 0; i < ids.length; i++) {
+                            const revealStart = startTime + i * delay;
+                            const revealEnd = revealStart + dur;
+                            const targetId = ids[i];
+                            if (revealStart > 0) {
+                                allKeyframes.push({ targetId, property: prop, time: 0, value: 0 });
+                            }
+                            if (revealStart > 10) {
+                                allKeyframes.push({ targetId, property: prop, time: revealStart, value: 0 });
+                            }
+                            allKeyframes.push({ targetId, property: prop, time: revealEnd, value: 1, easing: 'easeOut' });
+                            stats.keyframes += (revealStart > 0 ? 1 : 0) + (revealStart > 10 ? 1 : 0) + 1;
+                        }
+                        stats.sequences++;
+                    }
+                }
+            }
+            catch (e) {
+                errors.push(`Error parsing sequences: ${e}`);
+            }
+        }
+        // ── 5. Apply all keyframes in one batched pass ───────
+        if (allKeyframes.length > 0) {
+            const newState = addKeyframesBatchToState(state, allKeyframes);
+            ctx.updateState(newState);
+        }
+        // ── 6. Clip range ────────────────────────────────────
+        const finalState = ctx.getState();
+        if (clipStart !== undefined)
+            finalState.clipStart = clipStart;
+        if (clipEnd !== undefined) {
+            finalState.clipEnd = Math.max((clipStart ?? finalState.clipStart) + 100, clipEnd);
+        }
+        else if (clipStart === undefined && stats.sequences > 0) {
+            // Auto-set clip end to match the last sequence keyframe
+            let maxTime = 0;
+            for (const kf of allKeyframes) {
+                if (kf.time > maxTime)
+                    maxTime = kf.time;
+            }
+            if (maxTime > 0) {
+                finalState.clipEnd = Math.max(finalState.clipEnd, maxTime + 500);
+            }
+        }
+        // ── 7. Build response ────────────────────────────────
+        const parts = [
+            `Scene: ${stats.elements} elements`,
+            stats.keyframes > 0 ? `${stats.keyframes} keyframes` : null,
+            stats.sequences > 0 ? `${stats.sequences} sequences` : null,
+            cameraFrame ? `camera: ${finalState.cameraFrame.aspectRatio} at (${finalState.cameraFrame.x}, ${finalState.cameraFrame.y})` : null,
+            `clip: ${finalState.clipStart}ms–${finalState.clipEnd}ms`,
+        ].filter(Boolean).join(', ');
+        const msg = errors.length > 0
+            ? `${parts}\nWarnings: ${errors.join('; ')}`
+            : parts;
+        return { content: [{ type: 'text', text: msg }] };
+    }, 
+    // Mark all areas dirty — this tool touches everything
+    ['scene', 'timeline', 'clip', 'cameraFrame']);
+}
+//# sourceMappingURL=compositeTools.js.map

package/dist/server/compositeTools.js.map

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

package/dist/server/referenceText.d.ts

@@ -1,3 +1,3 @@
-export declare const REFERENCE_TEXT = "# Excalimate MCP Reference\n\n## Excalidraw Element Format\n\nEvery element has these base properties:\n```json\n{\n  \"id\": \"unique-id\",\n  \"type\": \"rectangle|ellipse|diamond|arrow|line|text|freedraw|image\",\n  \"x\": 100, \"y\": 200,\n  \"width\": 300, \"height\": 150,\n  \"angle\": 0,\n  \"strokeColor\": \"#1e1e1e\",\n  \"backgroundColor\": \"transparent\",\n  \"fillStyle\": \"solid\",\n  \"strokeWidth\": 2,\n  \"roughness\": 1,\n  \"opacity\": 100,\n  \"groupIds\": [],\n  \"isDeleted\": false\n}\n```\n\n### Text Elements\n```json\n{\n  \"type\": \"text\",\n  \"text\": \"Hello World\",\n  \"fontSize\": 20,\n  \"fontFamily\": 5,\n  \"textAlign\": \"center\",\n  \"verticalAlign\": \"middle\"\n}\n```\n\n### Arrow/Line Elements\n```json\n{\n  \"type\": \"arrow\",\n  \"points\": [[0, 0], [200, 100]],\n  \"startArrowhead\": null,\n  \"endArrowhead\": \"arrow\",\n  \"startBinding\": null,\n  \"endBinding\": null\n}\n```\n\n### Bound Text (Label on Shape)\nCreate a text element with `containerId` pointing to the shape:\n```json\n{ \"type\": \"text\", \"containerId\": \"shape-id\", ... }\n```\nAnd add to the shape: `\"boundElements\": [{\"id\": \"text-id\", \"type\": \"text\"}]`\n\n## Color Palettes\n\n**Stroke**: #1e1e1e, #e03131, #2f9e44, #1971c2, #f08c00, #6741d9, #0c8599, #e8590c\n**Background**: transparent, #ffc9c9, #b2f2bb, #a5d8ff, #ffec99, #d0bfff, #99e9f2, #ffd8a8\n\n## Animatable Properties\n\n| Property | Range | Description |\n|----------|-------|-------------|\n| opacity | 0\u20131 | Element visibility (0=hidden, 1=visible) |\n| translateX | px | Horizontal position offset |\n| translateY | px | Vertical position offset |\n| scaleX | 0.1+ | Horizontal scale (1=normal) |\n| scaleY | 0.1+ | Vertical scale (1=normal) |\n| rotation | degrees | Rotation angle |\n| drawProgress | 0\u20131 | Stroke draw-on progress (for lines/arrows) |\n\n## Easing Types\n\nlinear, easeIn, easeOut, easeInOut, easeInQuad, easeOutQuad, easeInOutQuad,\neaseInCubic, easeOutCubic, easeInOutCubic, easeInBack, easeOutBack, easeInOutBack,\neaseInElastic, easeOutElastic, easeInBounce, easeOutBounce, step\n\n## Workflow\n\n1. Call `read_me` (this tool) to get the reference\n2. Call `create_scene` with Excalidraw elements JSON (or `clear_scene` to start fresh)\n3. Call `add_keyframe` or `add_keyframes_batch` to animate elements\n4. Use `create_sequence` for reveal animations\n5. Call `set_clip_range` to set export bounds\n6. Call `save_checkpoint` to persist\n7. User opens the checkpoint in the Excalimate web app for preview/export\n\nUse `clear_scene` to reset everything (elements + animations) or `clear_animation` to keep elements but remove all keyframes.\n\n## Example: Fade-in Rectangle\n\n```\n1. create_scene: [{\"id\":\"rect1\",\"type\":\"rectangle\",\"x\":100,\"y\":100,\"width\":200,\"height\":100,...}]\n2. add_keyframe: {targetId:\"rect1\", property:\"opacity\", time:0, value:0}\n3. add_keyframe: {targetId:\"rect1\", property:\"opacity\", time:1000, value:1, easing:\"easeOut\"}\n```\n";
-export declare const EXAMPLES_TEXT = "# Excalimate \u2014 Few-Shot Examples\n\n## Example 1: Single Rectangle\n```\ncreate_scene({ elements: '[{\"id\":\"box1\",\"type\":\"rectangle\",\"x\":200,\"y\":150,\"width\":250,\"height\":120,\"strokeColor\":\"#1971c2\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\"}]' })\n```\n\n## Example 2: Rectangle with Bound Text Label\n```\ncreate_scene({ elements: '[{\"id\":\"server\",\"type\":\"rectangle\",\"x\":100,\"y\":100,\"width\":200,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\",\"boundElements\":[{\"id\":\"server-label\",\"type\":\"text\"}]},{\"id\":\"server-label\",\"type\":\"text\",\"x\":140,\"y\":125,\"width\":120,\"height\":30,\"text\":\"API Server\",\"fontSize\":20,\"fontFamily\":5,\"textAlign\":\"center\",\"verticalAlign\":\"middle\",\"containerId\":\"server\"}]' })\n```\n\n## Example 3: Two Shapes Connected by Arrow\n```\ncreate_scene({ elements: '[{\"id\":\"A\",\"type\":\"rectangle\",\"x\":100,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#b2f2bb\",\"fillStyle\":\"solid\"},{\"id\":\"B\",\"type\":\"rectangle\",\"x\":500,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\"},{\"id\":\"arrow1\",\"type\":\"arrow\",\"x\":250,\"y\":240,\"width\":250,\"height\":0,\"points\":[[0,0],[250,0]],\"endArrowhead\":\"arrow\",\"startBinding\":{\"elementId\":\"A\",\"focus\":0,\"gap\":1},\"endBinding\":{\"elementId\":\"B\",\"focus\":0,\"gap\":1}}]' })\n```\n\n## Example 4: Ellipse and Diamond\n```\nadd_elements({ elements: '[{\"id\":\"circle1\",\"type\":\"ellipse\",\"x\":300,\"y\":100,\"width\":120,\"height\":120,\"strokeColor\":\"#e03131\",\"backgroundColor\":\"#ffc9c9\",\"fillStyle\":\"solid\"},{\"id\":\"diamond1\",\"type\":\"diamond\",\"x\":500,\"y\":90,\"width\":140,\"height\":140,\"strokeColor\":\"#6741d9\",\"backgroundColor\":\"#d0bfff\",\"fillStyle\":\"solid\"}]' })\n```\n\n## Example 5: Multi-Point Line\n```\nadd_elements({ elements: '[{\"id\":\"line1\",\"type\":\"line\",\"x\":100,\"y\":300,\"width\":400,\"height\":80,\"points\":[[0,0],[200,-80],[400,0]],\"strokeColor\":\"#e03131\",\"strokeWidth\":3}]' })\n```\n\n## Example 6: Standalone Text\n```\nadd_elements({ elements: '[{\"id\":\"title\",\"type\":\"text\",\"x\":200,\"y\":50,\"width\":300,\"height\":50,\"text\":\"Architecture Overview\",\"fontSize\":36,\"fontFamily\":5,\"textAlign\":\"center\",\"strokeColor\":\"#1e1e1e\"}]' })\n```\n\n---\n\n# Animation Examples\n\n## Example 7: Fade In\n```\nadd_keyframe({ targetId: \"box1\", property: \"opacity\", time: 0, value: 0 })\nadd_keyframe({ targetId: \"box1\", property: \"opacity\", time: 800, value: 1, easing: \"easeOut\" })\n```\n\n## Example 8: Slide In from Left\n```\nadd_keyframes_batch({ keyframes: '[{\"targetId\":\"box1\",\"property\":\"translateX\",\"time\":0,\"value\":-300},{\"targetId\":\"box1\",\"property\":\"translateX\",\"time\":1000,\"value\":0,\"easing\":\"easeOutCubic\"},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":0,\"value\":0},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":500,\"value\":1,\"easing\":\"easeOut\"}]' })\n```\n\n## Example 9: Pop In from Center (Scale Up with Bounce)\n```\nadd_keyframes_batch({ keyframes: '[{\"targetId\":\"box1\",\"property\":\"scaleX\",\"time\":0,\"value\":0.3,\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleY\",\"time\":0,\"value\":0.3,\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleX\",\"time\":600,\"value\":1,\"easing\":\"easeOutBack\",\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleY\",\"time\":600,\"value\":1,\"easing\":\"easeOutBack\",\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":0,\"value\":0},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":300,\"value\":1}]' })\n```\n\n## Example 9b: Scale from Bottom Edge\n```\nadd_scale_animation({ targetId: \"box1\", origin: \"bottom\", keyframes: '[{\"time\":0,\"scaleX\":1,\"scaleY\":0},{\"time\":800,\"scaleX\":1,\"scaleY\":1,\"easing\":\"easeOutCubic\"}]' })\n```\nScale origins: center, top-left, top-right, bottom-left, bottom-right, top, bottom, left, right.\nAdd \"scaleOrigin\" per scaleX/scaleY keyframe in add_keyframes_batch, or use add_scale_animation for a single element.\n\n## Example 10: Draw In an Arrow (Stroke Animation)\n```\nadd_keyframe({ targetId: \"arrow1\", property: \"drawProgress\", time: 0, value: 0 })\nadd_keyframe({ targetId: \"arrow1\", property: \"drawProgress\", time: 1200, value: 1, easing: \"easeInOut\" })\n```\n\n## Example 11: Sequential Reveal \u2014 A \u2192 Arrow \u2192 B (Most Common Pattern)\n```\nadd_keyframes_batch({ keyframes: '[\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":600,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":600,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":700,\"value\":1},\n  {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":600,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":1800,\"value\":1,\"easing\":\"easeInOut\"},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":1800,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":2400,\"value\":1,\"easing\":\"easeOut\"}\n]' })\n```\n\n## Example 12: Bidirectional Flow \u2014 A \u2194 B\n```\nadd_keyframes_batch({ keyframes: '[\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":500,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrowAB\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrowAB\",\"property\":\"opacity\",\"time\":500,\"value\":1},\n  {\"targetId\":\"arrowAB\",\"property\":\"drawProgress\",\"time\":500,\"value\":0},\n  {\"targetId\":\"arrowAB\",\"property\":\"drawProgress\",\"time\":1500,\"value\":1,\"easing\":\"easeInOut\"},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":1500,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":2000,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrowBA\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrowBA\",\"property\":\"opacity\",\"time\":2000,\"value\":1},\n  {\"targetId\":\"arrowBA\",\"property\":\"drawProgress\",\"time\":2000,\"value\":0},\n  {\"targetId\":\"arrowBA\",\"property\":\"drawProgress\",\"time\":3000,\"value\":1,\"easing\":\"easeInOut\"}\n]' })\n```\n\n## Example 13: Staggered Reveal via create_sequence\n```\ncreate_sequence({ elementIds: [\"title\",\"box1\",\"arrow1\",\"box2\",\"arrow2\",\"box3\"], property: \"opacity\", startTime: 0, delay: 400, duration: 600 })\n```\nResult: title at 0ms, box1 at 400ms, arrow1 at 800ms, box2 at 1200ms, arrow2 at 1600ms, box3 at 2000ms.\n\n## Example 14: Camera Pan\n```\nset_camera_frame({ x: 300, y: 200, width: 800, aspectRatio: \"16:9\" })\nadd_camera_keyframe({ property: \"translateX\", time: 0, value: -200 })\nadd_camera_keyframe({ property: \"translateX\", time: 3000, value: 200, easing: \"easeInOut\" })\n```\n\n## Example 15: Camera Zoom In\n```\nadd_camera_keyframe({ property: \"scaleX\", time: 0, value: 2 })\nadd_camera_keyframe({ property: \"scaleY\", time: 0, value: 2 })\nadd_camera_keyframe({ property: \"scaleX\", time: 2000, value: 1, easing: \"easeInOutCubic\" })\nadd_camera_keyframe({ property: \"scaleY\", time: 2000, value: 1, easing: \"easeInOutCubic\" })\n```\n\n## Example 16: Clip Range + Save\n```\nset_clip_range({ start: 0, end: 5000 })\nsave_checkpoint({ id: \"my-animation\" })\n```\n\n---\n\n# Tips\n\n1. Always call create_scene first (or clear_scene to start fresh), then animate.\n2. Use add_keyframes_batch for efficiency \u2014 one call for many keyframes.\n3. Use create_sequence for simple staggered reveals.\n4. Bound text inherits container animation \u2014 animating arrow opacity also hides its label.\n5. drawProgress only works on arrows and lines.\n6. easeOutBack gives a nice bounce for pop-in effects.\n7. easeInOutCubic is the best general-purpose easing.\n8. Set elements to opacity 0 at time 0 if they should appear later.\n9. Set clip range before saving \u2014 it defines what gets exported.\n10. Camera scale > 1 = zoomed out, < 1 = zoomed in.\n11. Use delete_items to remove elements AND their animation tracks in one call.\n12. Verify your work with animations_of_item, items_visible_in_camera, are_items_in_line, is_camera_centered.\n\n## Example 17: Verify Animation\n```\nanimations_of_item({ targetId: \"box1\" })\n// Returns:\n//   opacity:\n//     0ms 0% \u2191 100% 600ms (easeOut)\n\nitems_visible_in_camera({ time: 1000 })\n// Returns: 5/8 items visible (62%) at 1000ms\n\nare_items_in_line({ ids: [\"box1\",\"box2\",\"box3\"], axis: \"horizontal\" })\n// Returns: \u2705 Aligned (max deviation: 3px)\n\nis_camera_centered({ axis: \"both\", time: 0 })\n// Returns: \u2705 Centered (offsets: dx=5 dy=2)\n```\n\n## Example 18: Delete and Rebuild\n```\ndelete_items({ ids: [\"old_box\", \"old_arrow\"] })\n// Removes elements + all their animation tracks\n\nclear_scene()\n// Nuclear option: removes everything\n```\n";
+export declare const REFERENCE_TEXT = "# Excalimate Reference\n\n## Element Format (base properties)\n{ id, type, x, y, width, height, strokeColor, backgroundColor, fillStyle, strokeWidth, opacity, groupIds, angle }\n\nTypes: rectangle, ellipse, diamond, arrow, line, text, freedraw, image\n\nText extra: { text, fontSize, fontFamily: 5, textAlign, verticalAlign }\nArrow/Line extra: { points: [[0,0],[dx,dy]], endArrowhead: \"arrow\"|null }\nBound text: text with containerId \u2192 shape with boundElements:[{id,type:\"text\"}]\n\n## Colors\nStroke: #1e1e1e #e03131 #2f9e44 #1971c2 #f08c00 #6741d9 #0c8599 #e8590c\nFill: transparent #ffc9c9 #b2f2bb #a5d8ff #ffec99 #d0bfff #99e9f2 #ffd8a8\n\n## Animation Properties\nopacity (0\u20131), translateX/Y (px), scaleX/Y (0.1+), rotation (deg), drawProgress (0\u20131, lines/arrows only)\n\n## Easings\nlinear, easeIn, easeOut, easeInOut, easeInQuad, easeOutQuad, easeInOutQuad,\neaseInCubic, easeOutCubic, easeInOutCubic, easeInBack, easeOutBack, easeInOutBack,\neaseInElastic, easeOutElastic, easeInBounce, easeOutBounce, step\n\n## Preferred Workflow\n1. Use **create_animated_scene** \u2014 one call for elements + keyframes + sequences + camera + clip range\n2. Use add_keyframes_batch or create_sequence for incremental changes\n3. Use save_checkpoint to persist\n4. Verify with animations_of_item, items_visible_in_camera, is_camera_centered\n\n## Key Tips\n- Set opacity 0 at time 0 for elements that appear later\n- Bound text inherits container animation\n- drawProgress only works on arrows/lines\n- easeOutBack = nice bounce; easeInOutCubic = best general-purpose\n- Camera: scale > 1 = zoomed out, < 1 = zoomed in\n- Set clip range before saving\n";
+export declare const EXAMPLES_TEXT = "# Excalimate Examples\n\n## Complete Scene (preferred \u2014 one call)\n```\ncreate_animated_scene({\n  elements: '[\n    {\"id\":\"A\",\"type\":\"rectangle\",\"x\":100,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#b2f2bb\",\"fillStyle\":\"solid\",\"boundElements\":[{\"id\":\"A-label\",\"type\":\"text\"}]},\n    {\"id\":\"A-label\",\"type\":\"text\",\"x\":120,\"y\":225,\"width\":110,\"height\":30,\"text\":\"Service A\",\"fontSize\":20,\"fontFamily\":5,\"textAlign\":\"center\",\"verticalAlign\":\"middle\",\"containerId\":\"A\"},\n    {\"id\":\"B\",\"type\":\"rectangle\",\"x\":500,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\",\"boundElements\":[{\"id\":\"B-label\",\"type\":\"text\"}]},\n    {\"id\":\"B-label\",\"type\":\"text\",\"x\":520,\"y\":225,\"width\":110,\"height\":30,\"text\":\"Service B\",\"fontSize\":20,\"fontFamily\":5,\"textAlign\":\"center\",\"verticalAlign\":\"middle\",\"containerId\":\"B\"},\n    {\"id\":\"arrow1\",\"type\":\"arrow\",\"x\":250,\"y\":240,\"width\":250,\"height\":0,\"points\":[[0,0],[250,0]],\"endArrowhead\":\"arrow\"}\n  ]',\n  keyframes: '[\n    {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n    {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":600,\"value\":1,\"easing\":\"easeOut\"},\n    {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n    {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":600,\"value\":0},\n    {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":700,\"value\":1},\n    {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":600,\"value\":0},\n    {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":1800,\"value\":1,\"easing\":\"easeInOut\"},\n    {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n    {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":1800,\"value\":0},\n    {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":2400,\"value\":1,\"easing\":\"easeOut\"}\n  ]',\n  clipEnd: 3000,\n  cameraFrame: { x: 375, y: 240, width: 800 }\n})\n```\n\n## Staggered Reveal (simpler alternative)\n```\ncreate_animated_scene({\n  elements: '[...elements...]',\n  sequences: '[{\"elementIds\":[\"title\",\"box1\",\"arrow1\",\"box2\"],\"delay\":400,\"duration\":600}]',\n  clipEnd: 3500\n})\n```\n\n## Scale Animation (pop-in from center)\n```\nadd_scale_animation({ targetId: \"box1\", origin: \"center\", keyframes: '[{\"time\":0,\"scaleX\":0.3,\"scaleY\":0.3},{\"time\":600,\"scaleX\":1,\"scaleY\":1,\"easing\":\"easeOutBack\"}]' })\n```\nOrigins: center, top-left, top-right, bottom-left, bottom-right, top, bottom, left, right\n\n## Camera Pan + Zoom\n```\nset_camera_frame({ x: 300, y: 200, width: 800 })\nadd_camera_keyframes_batch({ keyframes: '[\n  {\"property\":\"translateX\",\"time\":0,\"value\":-200},\n  {\"property\":\"translateX\",\"time\":3000,\"value\":200,\"easing\":\"easeInOut\"},\n  {\"property\":\"scaleX\",\"time\":0,\"value\":1.5},\n  {\"property\":\"scaleY\",\"time\":0,\"value\":1.5},\n  {\"property\":\"scaleX\",\"time\":3000,\"value\":1,\"easing\":\"easeInOutCubic\"},\n  {\"property\":\"scaleY\",\"time\":3000,\"value\":1,\"easing\":\"easeInOutCubic\"}\n]' })\n```\n";
 //# sourceMappingURL=referenceText.d.ts.map

package/dist/server/referenceText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referenceText.d.ts","sourceRoot":"","sources":["../../src/server/referenceText.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,w9FAgG1B,CAAC;AAEF,eAAO,MAAM,aAAa,m0SAyKzB,CAAC"}
+{"version":3,"file":"referenceText.d.ts","sourceRoot":"","sources":["../../src/server/referenceText.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,woDAoC1B,CAAC;AAIF,eAAO,MAAM,aAAa,0uGAwDzB,CAAC"}