@pinepaper.studio/mcp-server 1.5.0 → 1.5.3

package/dist/types/code-generator.js

@@ -14,8 +14,6 @@ AgentStartJobInputSchema, AgentEndJobInputSchema, AgentResetInputSchema, AgentBa
 AddTriggerInputSchema, RemoveTriggerInputSchema, QueryTriggersInputSchema, 
 // Quiz types
 CreateQuizInputSchema, GetQuizStateInputSchema, ResetQuizInputSchema, 
-// Widget export types
-ExportWidgetInputSchema, 
 // Letter collage types
 CreateLetterCollageInputSchema, AnimateLetterCollageInputSchema, 
 // Map types
@@ -353,6 +351,12 @@ function generatePlayTimelineCode(action, duration, loop, time) {
 // Play keyframe timeline
 app.playKeyframeTimeline(${duration || 5}, ${loop ?? false});
 ({ success: true, action: 'play', duration: ${duration || 5}, loop: ${loop ?? false} });
+`.trim();
+        case 'pause':
+            return `
+// Pause keyframe timeline
+app.pauseKeyframeTimeline();
+({ success: true, action: 'pause' });
 `.trim();
         case 'stop':
             return `
@@ -1798,11 +1802,11 @@ return { success: true, action: 'seek', time: ${op.time || 0} };
         const validated = AgentExportInputSchema.parse(input);
         const { platform, format, quality } = validated;
         const qualityLevel = quality || 'standard';
-        // Quality settings
+        // Quality settings (bitrate in bps for VideoEncoder)
         const qualitySettings = {
-            draft: { compression: 0.6, fps: 15, dpi: 72 },
-            standard: { compression: 0.85, fps: 30, dpi: 150 },
-            high: { compression: 0.95, fps: 60, dpi: 300 },
+            draft: { compression: 0.6, fps: 15, dpi: 72, bitrate: 2_000_000 },
+            standard: { compression: 0.85, fps: 30, dpi: 150, bitrate: 5_000_000 },
+            high: { compression: 0.95, fps: 60, dpi: 300, bitrate: 8_000_000 },
         }[qualityLevel];
         // Platform presets
         const platformPresets = {
@@ -1874,35 +1878,36 @@ return { success: true, action: 'seek', time: ${op.time || 0} };
         break;
 
       case 'gif':
-        if (app.exportEngine && app.exportEngine.exportGIF) {
-          const blob = await app.exportEngine.exportGIF({ fps: settings.fps, quality: settings.compression, duration: 5 });
-          const reader = new FileReader();
-          const dataUrl = await new Promise(resolve => {
-            reader.onloadend = () => resolve(reader.result);
-            reader.readAsDataURL(blob);
-          });
-          result = { success: true, platform, format: 'gif', data: dataUrl, mimeType: 'image/gif', size: blob.size };
-        } else {
-          result = { success: false, error: 'GIF export not available' };
-        }
-        break;
-
       case 'mp4':
-      case 'webm':
-        const exportMethod = format === 'mp4' ? 'exportMP4' : 'exportWebM';
-        const mimeType = format === 'mp4' ? 'video/mp4' : 'video/webm';
-        if (app.exportEngine && app.exportEngine[exportMethod]) {
-          const blob = await app.exportEngine[exportMethod]({ fps: settings.fps, duration: 5, ...dimensions });
+      case 'webm': {
+        const videoMimeType = { mp4: 'video/mp4', webm: 'video/webm', gif: 'image/gif' }[format];
+        // Use _quickExportVideo (delegates to VideoExporter.export internally)
+        if (app.exportEngine && app.exportEngine._quickExportVideo) {
+          const videoResult = await app.exportEngine._quickExportVideo(format, { fps: settings.fps, bitrate: settings.bitrate, duration: 5 }, false);
+          if (videoResult && videoResult.blob) {
+            const reader = new FileReader();
+            const dataUrl = await new Promise(resolve => {
+              reader.onloadend = () => resolve(reader.result);
+              reader.readAsDataURL(videoResult.blob);
+            });
+            result = { success: true, platform, format, data: dataUrl, mimeType: videoMimeType, size: videoResult.blob.size };
+          } else {
+            result = { success: false, error: format.toUpperCase() + ' export returned no data' };
+          }
+        } else if (app.exportEngine && app.exportEngine.videoExporter) {
+          // Fallback: call VideoExporter.export directly
+          const blob = await app.exportEngine.videoExporter.export({ format, fps: settings.fps, bitrate: settings.bitrate, duration: 5 });
           const reader = new FileReader();
           const dataUrl = await new Promise(resolve => {
             reader.onloadend = () => resolve(reader.result);
             reader.readAsDataURL(blob);
           });
-          result = { success: true, platform, format, data: dataUrl, mimeType, size: blob.size };
+          result = { success: true, platform, format, data: dataUrl, mimeType: videoMimeType, size: blob.size };
         } else {
           result = { success: false, error: format.toUpperCase() + ' export not available' };
         }
         break;
+      }
 
       case 'pdf':
         if (app.exportEngine && app.exportEngine.exportPDF) {
@@ -1914,7 +1919,7 @@ return { success: true, action: 'seek', time: ${op.time || 0} };
           });
           result = { success: true, platform, format: 'pdf', data: dataUrl, mimeType: 'application/pdf', size: blob.size, dpi: settings.dpi };
         } else {
-          result = { success: false, error: 'PDF export not available' };
+          result = { success: false, error: 'PDF export failed' };
         }
         break;
 
@@ -2311,176 +2316,6 @@ quiz.state = {
 app.historyManager.saveState();
 
 ({ success: true, quizId: quiz.id, reset: true });
-`.trim();
-    }
-    // ===========================================================================
-    // WIDGET EXPORT CODE GENERATORS
-    // ===========================================================================
-    /**
-     * Generate code for exporting widget
-     */
-    generateExportWidget(input) {
-        const validated = ExportWidgetInputSchema.parse(input);
-        const { format, sizing, interactivity, autoplay, loop, lmsEnabled, width, height } = validated;
-        const sizingMode = sizing || 'responsive';
-        const interactivityLevel = interactivity || 'view';
-        const shouldAutoplay = autoplay !== false;
-        const shouldLoop = loop !== false;
-        const hasLms = lmsEnabled || false;
-        return `
-// Export widget as ${format}
-(async function() {
-  const format = '${format}';
-  const sizing = '${sizingMode}';
-  const interactivity = '${interactivityLevel}';
-  const autoplay = ${shouldAutoplay};
-  const loop = ${shouldLoop};
-  const lmsEnabled = ${hasLms};
-  const fixedWidth = ${width || 'null'};
-  const fixedHeight = ${height || 'null'};
-
-  // Capture scene data
-  const sceneData = app.exportSceneData ? JSON.stringify(app.exportSceneData()) : '{}';
-
-  // Get canvas dimensions
-  let canvasWidth = fixedWidth || (app.canvasEl ? app.canvasEl.width : 800);
-  let canvasHeight = fixedHeight || (app.canvasEl ? app.canvasEl.height : 600);
-
-  // Check for animations
-  const items = app.itemRegistry ? app.itemRegistry.getAll() : [];
-  const hasAnimations = items.some(e => e.item.data?.animationType);
-  const hasRelations = app.relationRegistry && app.relationRegistry.getAll().length > 0;
-  const hasQuiz = app.quizManager && app.quizManager.quizzes.length > 0;
-  const hasTriggers = items.some(e => e.item.data?.triggers?.length > 0);
-
-  const metadata = {
-    hasInteractivity: hasTriggers || interactivity === 'full',
-    hasAnimations: hasAnimations || hasRelations,
-    hasQuiz,
-    width: canvasWidth,
-    height: canvasHeight,
-    sizing,
-    interactivity
-  };
-
-  let code = '';
-  let embedCode = '';
-
-  switch (format) {
-    case 'web-component':
-      code = \`<script src="https://cdn.pinepaper.io/widget.js"></script>
-<pinepaper-widget
-  data-scene='\${sceneData}'
-  data-sizing="\${sizing}"
-  data-interactivity="\${interactivity}"
-  data-autoplay="\${autoplay}"
-  data-loop="\${loop}"
-  \${fixedWidth ? 'width="' + canvasWidth + '"' : ''}
-  \${fixedHeight ? 'height="' + canvasHeight + '"' : ''}
-></pinepaper-widget>\`;
-      embedCode = code;
-      break;
-
-    case 'standalone-html':
-      code = \`<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>PinePaper Widget</title>
-  <script src="https://cdn.pinepaper.io/runtime.js"></script>
-  <style>
-    body { margin: 0; padding: 0; display: flex; justify-content: center; align-items: center; min-height: 100vh; background: #f5f5f5; }
-    .pinepaper-container { \${sizing === 'responsive' ? 'width: 100%; max-width: ' + canvasWidth + 'px;' : sizing === 'fluid' ? 'width: 100%; height: 100%;' : 'width: ' + canvasWidth + 'px; height: ' + canvasHeight + 'px;'} }
-  </style>
-</head>
-<body>
-  <div class="pinepaper-container" id="pinepaper-widget"></div>
-  <script>
-    PinePaper.init('#pinepaper-widget', {
-      scene: \${sceneData},
-      autoplay: \${autoplay},
-      loop: \${loop},
-      interactivity: '\${interactivity}'\${hasLms ? ',\\n      lms: true' : ''}
-    });
-  </script>
-</body>
-</html>\`;
-      embedCode = \`<iframe src="[URL_TO_HOSTED_FILE]" width="\${canvasWidth}" height="\${canvasHeight}" frameborder="0"></iframe>\`;
-      break;
-
-    case 'iframe-embed':
-      const dataUri = 'data:text/html;base64,' + btoa(\`<!DOCTYPE html><html><head><script src="https://cdn.pinepaper.io/runtime.js"></script></head><body><div id="w"></div><script>PinePaper.init('#w',{scene:\${sceneData},autoplay:\${autoplay},loop:\${loop}});</script></body></html>\`);
-      code = dataUri;
-      embedCode = \`<iframe src="\${dataUri}" width="\${canvasWidth}" height="\${canvasHeight}" frameborder="0" allowfullscreen></iframe>\`;
-      break;
-
-    case 'react-component':
-      code = \`import { useEffect, useRef } from 'react';
-
-export function PinepaperWidget({ className }) {
-  const containerRef = useRef(null);
-
-  useEffect(() => {
-    if (containerRef.current && window.PinePaper) {
-      window.PinePaper.init(containerRef.current, {
-        scene: \${sceneData},
-        autoplay: \${autoplay},
-        loop: \${loop},
-        interactivity: '\${interactivity}'
-      });
-    }
-  }, []);
-
-  return <div ref={containerRef} className={className} style={{ width: '\${sizing === 'fixed' ? canvasWidth + 'px' : '100%'}', height: '\${sizing === 'fixed' ? canvasHeight + 'px' : 'auto'}' }} />;
-}
-
-// Usage: <PinepaperWidget className="my-widget" />\`;
-      embedCode = '<PinepaperWidget />';
-      break;
-
-    case 'vue-component':
-      code = \`<template>
-  <div ref="container" :class="className" :style="containerStyle"></div>
-</template>
-
-<script setup>
-import { ref, onMounted, computed } from 'vue';
-
-const props = defineProps({ className: String });
-const container = ref(null);
-
-const containerStyle = computed(() => ({
-  width: '\${sizing === 'fixed' ? canvasWidth + 'px' : '100%'}',
-  height: '\${sizing === 'fixed' ? canvasHeight + 'px' : 'auto'}'
-}));
-
-onMounted(() => {
-  if (container.value && window.PinePaper) {
-    window.PinePaper.init(container.value, {
-      scene: \${sceneData},
-      autoplay: \${autoplay},
-      loop: \${loop},
-      interactivity: '\${interactivity}'
-    });
-  }
-});
-</script>
-
-<!-- Usage: <PinepaperWidget class="my-widget" /> -->\`;
-      embedCode = '<PinepaperWidget />';
-      break;
-  }
-
-  return {
-    success: true,
-    format,
-    code,
-    embedCode,
-    sceneData,
-    metadata
-  };
-})();
 `.trim();
     }
     // ===========================================================================
@@ -3636,6 +3471,629 @@ ${mask ? `    app.imageTools.applyMask(raster, '${mask}');\n` : ''}    const ite
 })();
 `.trim();
     }
+    generateManageScenes(input) {
+        const guard = `if (!app.sceneManager) return { error: 'SceneManager not available' };`;
+        switch (input.action) {
+            case 'save':
+                return `
+// Save current canvas as scene
+(async function() {
+  ${guard}
+  try {
+    const result = await app.sceneManager.saveCurrentAsScene(${JSON.stringify(input.name || 'Untitled Scene')});
+    return { success: true, action: 'save', sceneId: result?.id || result, name: ${JSON.stringify(input.name || 'Untitled Scene')} };
+  } catch (e) {
+    return { error: 'Failed to save scene: ' + e.message };
+  }
+})();
+`.trim();
+            case 'load':
+                return `
+// Load scene
+(async function() {
+  ${guard}
+  try {
+    await app.sceneManager.loadScene(${JSON.stringify(input.sceneId)}${input.transition ? `, { transition: ${JSON.stringify(input.transition)} }` : ''});
+    return { success: true, action: 'load', sceneId: ${JSON.stringify(input.sceneId)}${input.transition ? `, transition: ${JSON.stringify(input.transition)}` : ''} };
+  } catch (e) {
+    return { error: 'Failed to load scene: ' + e.message };
+  }
+})();
+`.trim();
+            case 'list':
+                return `
+// List all scenes
+(function() {
+  ${guard}
+  const scenes = app.sceneManager.listScenes();
+  return { success: true, action: 'list', scenes: scenes, count: scenes.length };
+})();
+`.trim();
+            case 'delete':
+                return `
+// Delete scene
+(function() {
+  ${guard}
+  app.sceneManager.deleteScene(${JSON.stringify(input.sceneId)});
+  return { success: true, action: 'delete', sceneId: ${JSON.stringify(input.sceneId)} };
+})();
+`.trim();
+            case 'rename':
+                return `
+// Rename scene
+(function() {
+  ${guard}
+  app.sceneManager.renameScene(${JSON.stringify(input.sceneId)}, ${JSON.stringify(input.name)});
+  return { success: true, action: 'rename', sceneId: ${JSON.stringify(input.sceneId)}, name: ${JSON.stringify(input.name)} };
+})();
+`.trim();
+            case 'duplicate':
+                return `
+// Duplicate scene
+(function() {
+  ${guard}
+  const result = app.sceneManager.duplicateScene(${JSON.stringify(input.sceneId)});
+  return { success: true, action: 'duplicate', originalId: ${JSON.stringify(input.sceneId)}, newScene: result };
+})();
+`.trim();
+            case 'reorder':
+                return `
+// Reorder scenes
+(function() {
+  ${guard}
+  app.sceneManager.reorderScenes(${JSON.stringify(input.sceneIds)});
+  return { success: true, action: 'reorder', order: ${JSON.stringify(input.sceneIds)} };
+})();
+`.trim();
+            case 'info':
+                return `
+// Get scene info
+(function() {
+  ${guard}
+  const scene = app.sceneManager.getScene(${JSON.stringify(input.sceneId)});
+  if (!scene) return { error: 'Scene not found: ${input.sceneId}' };
+  return { success: true, action: 'info', scene: scene };
+})();
+`.trim();
+            case 'export':
+                return `
+// Export all scenes
+(function() {
+  ${guard}
+  const data = app.sceneManager.exportScenes();
+  return { success: true, action: 'export', data: data };
+})();
+`.trim();
+            case 'import':
+                return `
+// Import scenes
+(function() {
+  ${guard}
+  try {
+    const json = ${JSON.stringify(input.scenesJson)};
+    app.sceneManager.importScenes(json${input.merge !== undefined ? `, { merge: ${input.merge} }` : ''});
+    return { success: true, action: 'import'${input.merge !== undefined ? `, merge: ${input.merge}` : ''} };
+  } catch (e) {
+    return { error: 'Failed to import scenes: ' + e.message };
+  }
+})();
+`.trim();
+            default:
+                return `(function() { return { error: 'Unknown manage_scenes action: ${input.action}' }; })();`;
+        }
+    }
+    generateScenePlayback(input) {
+        const guard = `if (!app.sceneManager) return { error: 'SceneManager not available' };`;
+        switch (input.action) {
+            case 'create_chain': {
+                const opts = [];
+                if (input.loop !== undefined)
+                    opts.push(`loop: ${input.loop}`);
+                if (input.autoPlay !== undefined)
+                    opts.push(`autoPlay: ${input.autoPlay}`);
+                if (input.defaultDuration !== undefined)
+                    opts.push(`defaultDuration: ${input.defaultDuration * 1000}`);
+                if (input.defaultTransition !== undefined)
+                    opts.push(`defaultTransition: ${JSON.stringify(input.defaultTransition)}`);
+                if (input.transitionDuration !== undefined)
+                    opts.push(`transitionDuration: ${input.transitionDuration * 1000}`);
+                const optsStr = opts.length > 0 ? `, { ${opts.join(', ')} }` : '';
+                return `
+// Create scene chain for sequential playback
+(function() {
+  ${guard}
+  app.sceneManager.createChain(${JSON.stringify(input.sceneIds)}${optsStr});
+  return { success: true, action: 'create_chain', sceneIds: ${JSON.stringify(input.sceneIds)}${input.loop !== undefined ? `, loop: ${input.loop}` : ''}${input.defaultDuration !== undefined ? `, defaultDuration: ${input.defaultDuration}` : ''} };
+})();
+`.trim();
+            }
+            case 'play':
+                return `
+// Play scene chain
+(async function() {
+  ${guard}
+  try {
+    await app.sceneManager.playChain();
+    return { success: true, action: 'play' };
+  } catch (e) {
+    return { error: 'Failed to play chain: ' + e.message };
+  }
+})();
+`.trim();
+            case 'pause':
+                return `
+// Pause scene chain
+(function() {
+  ${guard}
+  app.sceneManager.pauseChain();
+  return { success: true, action: 'pause' };
+})();
+`.trim();
+            case 'resume':
+                return `
+// Resume scene chain
+(function() {
+  ${guard}
+  app.sceneManager.resumeChain();
+  return { success: true, action: 'resume' };
+})();
+`.trim();
+            case 'stop':
+                return `
+// Stop scene chain
+(function() {
+  ${guard}
+  app.sceneManager.stopChain();
+  return { success: true, action: 'stop' };
+})();
+`.trim();
+            case 'toggle_loop':
+                return `
+// Toggle loop mode
+(function() {
+  ${guard}
+  app.sceneManager.setLoop(${input.enabled ?? true});
+  return { success: true, action: 'toggle_loop', enabled: ${input.enabled ?? true} };
+})();
+`.trim();
+            case 'jump':
+                return `
+// Jump to scene index
+(async function() {
+  ${guard}
+  try {
+    await app.sceneManager.jumpToChainIndex(${input.index ?? 0});
+    return { success: true, action: 'jump', index: ${input.index ?? 0} };
+  } catch (e) {
+    return { error: 'Failed to jump to index: ' + e.message };
+  }
+})();
+`.trim();
+            default:
+                return `(function() { return { error: 'Unknown scene_playback action: ${input.action}' }; })();`;
+        }
+    }
+    // ===========================================================================
+    // SELECTION, TRANSFORM & HISTORY
+    // ===========================================================================
+    generateSelection(input) {
+        switch (input.action) {
+            case 'select': {
+                const ids = JSON.stringify(input.itemIds || []);
+                const mode = input.mode || 'replace';
+                return `
+// Select items
+(function() {
+  const ids = ${ids};
+  if (ids.length === 0) return { error: 'No itemIds provided' };
+  ${mode === 'replace' ? 'app.deselectAll();' : ''}
+  const selected = [];
+  for (const id of ids) {
+    const entry = app.itemRegistry.get(id);
+    if (entry && entry.item) {
+      ${mode === 'remove' ? 'entry.item.selected = false;' : 'app.select(entry.item);'}
+      selected.push(id);
+    }
+  }
+  return { success: true, action: 'select', mode: '${mode}', selected };
+})();`.trim();
+            }
+            case 'select_all':
+                return `
+// Select all items
+(function() {
+  app.selectAll();
+  const items = app.getSelection().map(i => i.data?.itemId || i.name || i.id);
+  return { success: true, action: 'select_all', count: items.length, items };
+})();`.trim();
+            case 'deselect_all':
+                return `
+// Deselect all items
+(function() {
+  app.deselectAll();
+  return { success: true, action: 'deselect_all' };
+})();`.trim();
+            case 'get':
+                return `
+// Get current selection
+(function() {
+  const items = app.getSelection().map(i => ({
+    itemId: i.data?.itemId || i.name || i.id,
+    type: i.data?.itemType || i.className,
+    bounds: i.bounds ? { x: i.bounds.x, y: i.bounds.y, width: i.bounds.width, height: i.bounds.height } : null
+  }));
+  return { success: true, action: 'get', count: items.length, items };
+})();`.trim();
+            case 'delete_selected':
+                return `
+// Delete selected items
+(function() {
+  const selection = app.getSelection();
+  const deleted = selection.map(i => i.data?.itemId || i.name || i.id);
+  app.deleteSelected();
+  return { success: true, action: 'delete_selected', deleted, count: deleted.length };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown selection action: ${input.action}' }; })();`;
+        }
+    }
+    generateTransform(input) {
+        switch (input.action) {
+            case 'nudge': {
+                const dx = input.dx ?? 0;
+                const dy = input.dy ?? 0;
+                return `
+// Nudge item position
+(function() {
+  const entry = app.itemRegistry.get(${JSON.stringify(input.itemId || '')});
+  if (!entry || !entry.item) return { error: 'Item not found: ${input.itemId}' };
+  entry.item.position.x += ${dx};
+  entry.item.position.y += ${dy};
+  return { success: true, action: 'nudge', itemId: '${input.itemId}', dx: ${dx}, dy: ${dy}, position: { x: entry.item.position.x, y: entry.item.position.y } };
+})();`.trim();
+            }
+            case 'flip': {
+                const dir = input.direction || 'horizontal';
+                return `
+// Flip item ${dir}ly
+(function() {
+  const entry = app.itemRegistry.get(${JSON.stringify(input.itemId || '')});
+  if (!entry || !entry.item) return { error: 'Item not found: ${input.itemId}' };
+  ${dir === 'horizontal' ? 'entry.item.scale(-1, 1);' : 'entry.item.scale(1, -1);'}
+  return { success: true, action: 'flip', itemId: '${input.itemId}', direction: '${dir}' };
+})();`.trim();
+            }
+            case 'reorder': {
+                const order = input.order || 'bringToFront';
+                const methodMap = {
+                    bringToFront: 'bringToFront',
+                    sendToBack: 'sendToBack',
+                    moveUp: 'moveAbove',
+                    moveDown: 'moveBelow',
+                };
+                const method = methodMap[order] || 'bringToFront';
+                const needsSibling = order === 'moveUp' || order === 'moveDown';
+                if (needsSibling) {
+                    const siblingExpr = order === 'moveUp' ? 'entry.item.nextSibling' : 'entry.item.previousSibling';
+                    return `
+// Reorder item: ${order}
+(function() {
+  const entry = app.itemRegistry.get(${JSON.stringify(input.itemId || '')});
+  if (!entry || !entry.item) return { error: 'Item not found: ${input.itemId}' };
+  const sibling = ${siblingExpr};
+  if (sibling) entry.item.${method}(sibling);
+  return { success: true, action: 'reorder', itemId: '${input.itemId}', order: '${order}' };
+})();`.trim();
+                }
+                return `
+// Reorder item: ${order}
+(function() {
+  const entry = app.itemRegistry.get(${JSON.stringify(input.itemId || '')});
+  if (!entry || !entry.item) return { error: 'Item not found: ${input.itemId}' };
+  entry.item.${method}();
+  return { success: true, action: 'reorder', itemId: '${input.itemId}', order: '${order}' };
+})();`.trim();
+            }
+            default:
+                return `(function() { return { error: 'Unknown transform action: ${input.action}' }; })();`;
+        }
+    }
+    generateHistory(input) {
+        const guard = `if (!app.historyManager) return { error: 'HistoryManager not available' };`;
+        switch (input.action) {
+            case 'undo':
+                return `
+// Undo last action
+(function() {
+  ${guard}
+  app.historyManager.undo();
+  return { success: true, action: 'undo' };
+})();`.trim();
+            case 'redo':
+                return `
+// Redo last undone action
+(function() {
+  ${guard}
+  app.historyManager.redo();
+  return { success: true, action: 'redo' };
+})();`.trim();
+            case 'get_state':
+                return `
+// Get history state
+(function() {
+  ${guard}
+  const state = app.historyManager.getState();
+  return { success: true, action: 'get_state', ...state };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown history action: ${input.action}' }; })();`;
+        }
+    }
+    // ===========================================================================
+    // IMAGE PROCESSING
+    // ===========================================================================
+    generateImageFilter(input) {
+        const guard = `if (!app.imageTools) return { error: 'ImageTools not available' };`;
+        switch (input.action) {
+            case 'apply':
+                return `
+// Apply image filter
+(async function() {
+  ${guard}
+  try {
+    const result = await app.imageTools.applyFilter(${JSON.stringify(input.itemId)}, ${JSON.stringify(input.filterName || '')}, ${JSON.stringify(input.params || {})});
+    return { success: true, action: 'apply', itemId: ${JSON.stringify(input.itemId)}, filter: ${JSON.stringify(input.filterName || '')} };
+  } catch (e) {
+    return { error: 'Failed to apply filter: ' + e.message };
+  }
+})();`.trim();
+            case 'chain':
+                return `
+// Apply filter chain
+(async function() {
+  ${guard}
+  try {
+    const filters = ${JSON.stringify(input.filters || [])};
+    const result = await app.imageTools.applyFilterChain(${JSON.stringify(input.itemId)}, filters);
+    return { success: true, action: 'chain', itemId: ${JSON.stringify(input.itemId)}, filterCount: filters.length };
+  } catch (e) {
+    return { error: 'Failed to apply filter chain: ' + e.message };
+  }
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown image_filter action: ${input.action}' }; })();`;
+        }
+    }
+    generateLasso(input) {
+        const guard = `if (!app.imageTools) return { error: 'ImageTools not available' };`;
+        switch (input.action) {
+            case 'activate':
+                return `
+// Activate lasso selection
+(async function() {
+  ${guard}
+  try {
+    await app.imageTools.activateLasso(${JSON.stringify(input.itemId || '')});
+    return { success: true, action: 'activate', itemId: ${JSON.stringify(input.itemId || '')} };
+  } catch (e) {
+    return { error: 'Failed to activate lasso: ' + e.message };
+  }
+})();`.trim();
+            case 'apply':
+                return `
+// Apply lasso selection
+(async function() {
+  ${guard}
+  try {
+    const result = await app.imageTools.applyLasso();
+    return { success: true, action: 'apply' };
+  } catch (e) {
+    return { error: 'Failed to apply lasso: ' + e.message };
+  }
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown lasso action: ${input.action}' }; })();`;
+        }
+    }
+    generateCutoutStyle(input) {
+        const guard = `if (!app.imageTools) return { error: 'ImageTools not available' };`;
+        switch (input.action) {
+            case 'apply':
+                return `
+// Apply cutout style
+(async function() {
+  ${guard}
+  try {
+    const result = await app.imageTools.applyCutoutStyle(${JSON.stringify(input.itemId || '')}, ${JSON.stringify(input.preset || '')}, ${JSON.stringify(input.options || {})});
+    return { success: true, action: 'apply', itemId: ${JSON.stringify(input.itemId || '')}, preset: ${JSON.stringify(input.preset || '')} };
+  } catch (e) {
+    return { error: 'Failed to apply cutout style: ' + e.message };
+  }
+})();`.trim();
+            case 'list':
+                return `
+// List available cutout styles
+(function() {
+  ${guard}
+  const styles = app.imageTools.getCutoutStyles();
+  return { success: true, action: 'list', styles };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown cutout_style action: ${input.action}' }; })();`;
+        }
+    }
+    // ===========================================================================
+    // COMPOSITION & VIEW
+    // ===========================================================================
+    generatePrecomp(input) {
+        switch (input.action) {
+            case 'create': {
+                const opts = {};
+                if (input.name)
+                    opts.name = input.name;
+                if (input.loop !== undefined)
+                    opts.loop = input.loop;
+                if (input.duration !== undefined)
+                    opts.duration = input.duration;
+                return `
+// Create precomp from items
+(function() {
+  const itemIds = ${JSON.stringify(input.itemIds || [])};
+  const opts = ${JSON.stringify(opts)};
+  const precomp = app.createPrecomp(itemIds, opts);
+  return { success: true, action: 'create', precompId: precomp?.id || precomp, name: ${JSON.stringify(input.name || '')} };
+})();`.trim();
+            }
+            case 'add':
+                return `
+// Add item to precomp
+(function() {
+  app.addToPrecomp(${JSON.stringify(input.precompId || '')}, ${JSON.stringify(input.itemId || '')});
+  return { success: true, action: 'add', precompId: ${JSON.stringify(input.precompId || '')}, itemId: ${JSON.stringify(input.itemId || '')} };
+})();`.trim();
+            case 'remove':
+                return `
+// Remove item from precomp
+(function() {
+  app.removeFromPrecomp(${JSON.stringify(input.precompId || '')}, ${JSON.stringify(input.itemId || '')});
+  return { success: true, action: 'remove', precompId: ${JSON.stringify(input.precompId || '')}, itemId: ${JSON.stringify(input.itemId || '')} };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown precomp action: ${input.action}' }; })();`;
+        }
+    }
+    generateView(input) {
+        switch (input.action) {
+            case 'fit': {
+                const mode = input.mode || 'content';
+                const padding = input.padding ?? 20;
+                return `
+// Fit view to ${mode}
+(function() {
+  app.fitView('${mode}', ${padding});
+  return { success: true, action: 'fit', mode: '${mode}', padding: ${padding} };
+})();`.trim();
+            }
+            case 'get_state':
+                return `
+// Get current view state
+(function() {
+  const state = app.getViewState();
+  return { success: true, action: 'get_state', ...state };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown view action: ${input.action}' }; })();`;
+        }
+    }
+    generateBackground(input) {
+        switch (input.action) {
+            case 'set': {
+                const mode = input.mode || 'color';
+                if (mode === 'generator') {
+                    return `
+// Set background via generator
+(async function() {
+  try {
+    await app.executeGenerator(${JSON.stringify(input.generator || '')}, ${JSON.stringify(input.generatorParams || {})});
+    return { success: true, action: 'set', mode: 'generator', generator: ${JSON.stringify(input.generator || '')} };
+  } catch (e) {
+    return { error: 'Failed to set generator background: ' + e.message };
+  }
+})();`.trim();
+                }
+                if (mode === 'pattern') {
+                    return `
+// Set background pattern
+(function() {
+  app.setBackgroundPattern(${JSON.stringify(input.pattern || '')});
+  return { success: true, action: 'set', mode: 'pattern', pattern: ${JSON.stringify(input.pattern || '')} };
+})();`.trim();
+                }
+                // default: color
+                return `
+// Set background color
+(function() {
+  app.setBackgroundColor(${JSON.stringify(input.color || '#ffffff')});
+  return { success: true, action: 'set', mode: 'color', color: ${JSON.stringify(input.color || '#ffffff')} };
+})();`.trim();
+            }
+            case 'clear':
+                return `
+// Clear background
+(function() {
+  app.clearBackground();
+  return { success: true, action: 'clear' };
+})();`.trim();
+            case 'get':
+                return `
+// Get background info
+(function() {
+  const bg = app.getBackground();
+  return { success: true, action: 'get', ...bg };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown background action: ${input.action}' }; })();`;
+        }
+    }
+    // ===========================================================================
+    // CANVAS QUERIES
+    // ===========================================================================
+    generateQuery(input) {
+        switch (input.action) {
+            case 'get_by_id':
+                return `
+// Get item details by ID
+(function() {
+  const entry = app.itemRegistry.get(${JSON.stringify(input.itemId || '')});
+  if (!entry || !entry.item) return { error: 'Item not found: ${input.itemId}' };
+  const item = entry.item;
+  return {
+    success: true, action: 'get_by_id',
+    itemId: ${JSON.stringify(input.itemId || '')},
+    type: item.data?.itemType || item.className,
+    position: { x: item.position.x, y: item.position.y },
+    bounds: item.bounds ? { x: item.bounds.x, y: item.bounds.y, width: item.bounds.width, height: item.bounds.height } : null,
+    visible: item.visible,
+    opacity: item.opacity,
+    rotation: item.rotation,
+    selected: item.selected,
+  };
+})();`.trim();
+            case 'hit_test': {
+                const tolerance = input.tolerance ?? 5;
+                const all = input.all ?? false;
+                return `
+// Hit test at point
+(function() {
+  const point = new paper.Point(${input.x ?? 0}, ${input.y ?? 0});
+  ${all
+                    ? `const results = app.hitTestAll(point, { tolerance: ${tolerance} });
+  const hits = results.map(r => ({
+    itemId: r.item?.data?.itemId || r.item?.name || r.item?.id,
+    type: r.item?.data?.itemType || r.item?.className,
+    point: { x: r.point?.x, y: r.point?.y }
+  }));
+  return { success: true, action: 'hit_test', x: ${input.x ?? 0}, y: ${input.y ?? 0}, hits, count: hits.length };`
+                    : `const result = app.hitTest(point, { tolerance: ${tolerance} });
+  if (!result) return { success: true, action: 'hit_test', x: ${input.x ?? 0}, y: ${input.y ?? 0}, hit: null };
+  return {
+    success: true, action: 'hit_test',
+    x: ${input.x ?? 0}, y: ${input.y ?? 0},
+    hit: { itemId: result.item?.data?.itemId || result.item?.name || result.item?.id, type: result.item?.data?.itemType || result.item?.className }
+  };`}
+})();`.trim();
+            }
+            case 'is_empty':
+                return `
+// Check if canvas is empty
+(function() {
+  const items = app.itemRegistry.getAll();
+  return { success: true, action: 'is_empty', empty: items.length === 0, count: items.length };
+})();`.trim();
+            default:
+                return `(function() { return { error: 'Unknown query action: ${input.action}' }; })();`;
+        }
+    }
 }
 // Export singleton instance
 export const codeGenerator = new PinePaperCodeGenerator();