@efectoapp/mcp-server 0.1.4 → 0.1.6

package/dist/tools/state.d.ts

@@ -14,7 +14,7 @@
 import type { Tool } from '@modelcontextprotocol/sdk/types.js';
 type AspectRatio = '16:9' | '9:16' | '1:1' | '4:3' | 'full';
 type EffectId = 'none' | 'ascii-standard' | 'ascii-blocks' | 'ascii-braille' | 'ascii-hatching' | 'ascii-matrix' | 'ascii-technical' | 'ascii-dense' | 'ascii-minimal' | 'dither-floyd-steinberg' | 'dither-atkinson' | 'dither-jarvis-judice-ninke' | 'dither-stucki' | 'dither-burkes' | 'dither-sierra' | 'dither-two-row-sierra' | 'dither-sierra-lite' | 'color-separation' | 'halftone-mono' | 'halftone-cmyk' | 'glitch-chromatic' | 'glitch-digital' | 'glitch-vhs' | 'glitch-weird' | 'art-kuwahara' | 'art-crosshatch' | 'art-lineart' | 'art-engraving' | 'art-stipple' | 'special-warp';
-type PostProcessType = 'scanlines' | 'vignette' | 'chromatic-aberration' | 'curvature' | 'grain' | 'noise' | 'pixelate' | 'wave' | 'rgb-glitch' | 'brightness-contrast' | 'color-tint' | 'palette' | 'jitter' | 'bloom' | 'dot-screen' | 'sepia' | 'grid' | 'light-beams' | 'warp' | 'motion-blur';
+type PostProcessType = 'scanlines' | 'vignette' | 'chromatic-aberration' | 'curvature' | 'grain' | 'noise' | 'pixelate' | 'wave' | 'rgb-glitch' | 'brightness-contrast' | 'color-tint' | 'palette' | 'jitter' | 'bloom' | 'dot-screen' | 'sepia' | 'grid' | 'light-beams' | 'motion-blur';
 interface LayerTransform {
     x: number;
     y: number;
@@ -31,13 +31,12 @@ interface BaseLayer {
     locked: boolean;
     transform: LayerTransform;
 }
-type FontWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 interface TextLayer extends BaseLayer {
     type: 'text';
     content: string;
     fontFamily: string;
     fontSize: number;
-    fontWeight: FontWeight;
+    fontWeight: string;
     color: string;
     textAlign: 'left' | 'center' | 'right';
     letterSpacing: number;

package/dist/tools/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/tools/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/tools/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAG9D,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAG3D,KAAK,QAAQ,GACT,MAAM,GAEN,gBAAgB,GAAG,cAAc,GAAG,eAAe,GAAG,gBAAgB,GACtE,cAAc,GAAG,iBAAiB,GAAG,aAAa,GAAG,eAAe,GAEpE,wBAAwB,GAAG,iBAAiB,GAAG,4BAA4B,GAC3E,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,uBAAuB,GAC7E,oBAAoB,GAAG,kBAAkB,GAEzC,eAAe,GAAG,eAAe,GAEjC,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,cAAc,GAErE,cAAc,GAAG,gBAAgB,GAAG,aAAa,GAAG,eAAe,GAAG,aAAa,GAEnF,cAAc,CAAA;AAGlB,KAAK,eAAe,GAChB,WAAW,GAAG,UAAU,GAAG,sBAAsB,GAAG,WAAW,GAC/D,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,qBAAqB,GAC9E,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,GACtE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAA;AAU1C,UAAU,cAAc;IACtB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAGD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,cAAc,CAAA;CAC1B;AAGD,UAAU,SAAU,SAAQ,SAAS;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACtC,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAGD,UAAU,UAAW,SAAQ,SAAS;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAGD,UAAU,UAAW,SAAQ,SAAS;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,OAAO,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;CACtB;AAGD,KAAK,qBAAqB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAA;AAG1E,UAAU,eAAgB,SAAQ,SAAS;IACzC,IAAI,EAAE,YAAY,CAAA;IAClB,WAAW,EAAE,qBAAqB,CAAA;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,OAAO,GAAG,OAAO,CAAA;QAC5B,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAA;KAC/B,CAAA;CACF;AAGD,KAAK,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,CAAA;AAG9E,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,eAAe,CAAA;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAGD,UAAU,WAAW;IACnB,MAAM,EAAE;QACN,WAAW,EAAE,WAAW,CAAA;QACxB,eAAe,EAAE,MAAM,CAAA;KACxB,CAAA;IACD,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,QAAQ,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;QAEhB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,CAAA;IACD,aAAa,EAAE,mBAAmB,EAAE,CAAA;CACrC;AAMD,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAGD,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD;AAgFD,eAAO,MAAM,UAAU,EAAE,IAAI,EAwR5B,CAAA;AAsBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAiuB7D"}

package/dist/tools/state.js

@@ -17,27 +17,12 @@ exports.stateTools = void 0;
 exports.resetState = resetState;
 exports.getCurrentState = getCurrentState;
 exports.handleStateTool = handleStateTool;
-const VALID_FONT_WEIGHTS = ['normal', 'medium', 'semibold', 'bold'];
-// Helper to validate and normalize fontWeight
-function validateFontWeight(weight) {
-    if (!weight)
-        return 'bold';
-    const normalized = weight.toLowerCase().trim();
-    if (VALID_FONT_WEIGHTS.includes(normalized)) {
-        return normalized;
-    }
-    // Map numeric weights to closest valid weight
-    const numWeight = parseInt(normalized);
-    if (!isNaN(numWeight)) {
-        if (numWeight <= 400)
-            return 'normal';
-        if (numWeight <= 500)
-            return 'medium';
-        if (numWeight <= 600)
-            return 'semibold';
-        return 'bold';
-    }
-    return 'bold'; // fallback
+// Helper to clamp values to valid ranges
+function clamp(value, min, max, fallback) {
+    const v = value ?? fallback;
+    if (isNaN(v))
+        return fallback;
+    return Math.min(max, Math.max(min, v));
 }
 // Current poster state (single poster for now)
 let currentPoster = null;
@@ -53,6 +38,51 @@ function getCurrentState() {
 function generateId() {
     return `layer_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
 }
+/**
+ * Normalize font weight from various formats to our supported weights.
+ * Handles numeric weights (100-900) and common name variations.
+ * Our supported weights: normal (400), medium (500), semibold (600), bold (700)
+ */
+function normalizeFontWeight(input) {
+    if (input === undefined || input === null || input === '') {
+        return 'bold'; // default for new text layers
+    }
+    const str = String(input).toLowerCase().trim();
+    // Check if it's already a valid weight name
+    const validWeights = ['normal', 'medium', 'semibold', 'bold'];
+    if (validWeights.includes(str)) {
+        return str;
+    }
+    // Map numeric weights to our supported weights
+    const numericWeight = parseInt(str, 10);
+    if (!isNaN(numericWeight)) {
+        if (numericWeight <= 450)
+            return 'normal'; // 100-450 → normal (400)
+        if (numericWeight <= 550)
+            return 'medium'; // 451-550 → medium (500)
+        if (numericWeight <= 650)
+            return 'semibold'; // 551-650 → semibold (600)
+        return 'bold'; // 651+ → bold (700)
+    }
+    // Map common font weight name variations
+    const weightNameMap = {
+        // Thin/Light → normal
+        'thin': 'normal', 'hairline': 'normal', 'ultrathin': 'normal',
+        'extralight': 'normal', 'ultralight': 'normal', 'light': 'normal',
+        'regular': 'normal', 'book': 'normal', 'roman': 'normal',
+        // Medium
+        'med': 'medium',
+        // Semibold variations
+        'semibold': 'semibold', 'semi-bold': 'semibold', 'demibold': 'semibold',
+        'demi-bold': 'semibold', 'demi': 'semibold',
+        // Bold and heavier → bold
+        'extrabold': 'bold', 'ultrabold': 'bold', 'black': 'bold',
+        'heavy': 'bold', 'extrablack': 'bold', 'fat': 'bold',
+    };
+    // Try lookup with normalized string (remove spaces/hyphens)
+    const normalized = str.replace(/[\s-]/g, '');
+    return weightNameMap[normalized] || weightNameMap[str] || 'bold';
+}
 // Create default background layer
 function createDefaultBackgroundLayer(backgroundColor) {
     return {
@@ -143,9 +173,8 @@ exports.stateTools = [
                 },
                 name: { type: 'string', description: 'Layer name' },
                 // Transform properties (normalized coordinates relative to canvas)
-                // NOTE: Y axis is INVERTED from screen coordinates! Use NEGATIVE y for BOTTOM, POSITIVE y for TOP
-                x: { type: 'number', description: 'X position (-1 to 1, 0 is center). -1 = left edge, +1 = right edge', default: 0 },
-                y: { type: 'number', description: 'Y position (-1 to 1, 0 is center). IMPORTANT: +1 = TOP, -1 = BOTTOM (opposite of screen coords!)', default: 0 },
+                x: { type: 'number', description: 'X position (-1 to 1, 0 is center, positive is right)', default: 0 },
+                y: { type: 'number', description: 'Y position (-1 to 1, 0 is center, POSITIVE is UP/TOP, negative is down/bottom)', default: 0 },
                 width: { type: 'number', description: 'Width (0-1 relative to canvas)', default: 1 },
                 height: { type: 'number', description: 'Height (0-1 relative to canvas)', default: 1 },
                 rotation: { type: 'number', description: 'Rotation in degrees', default: 0 },
@@ -154,7 +183,7 @@ exports.stateTools = [
                 content: { type: 'string', description: 'Text content (required for text layers)' },
                 fontFamily: { type: 'string', description: 'Font family name', default: 'DM Sans' },
                 fontSize: { type: 'number', description: 'Font size in pixels', default: 48 },
-                fontWeight: { type: 'string', enum: ['normal', 'medium', 'semibold', 'bold'], description: 'Font weight (only these 4 values are supported)', default: 'bold' },
+                fontWeight: { type: 'string', enum: ['normal', 'bold', '100', '200', '300', '400', '500', '600', '700', '800', '900'], description: 'Font weight', default: 'bold' },
                 color: { type: 'string', description: 'Text color in hex', default: '#ffffff' },
                 textAlign: { type: 'string', enum: ['left', 'center', 'right'], description: 'Text alignment', default: 'center' },
                 letterSpacing: { type: 'number', description: 'Letter spacing in pixels', default: 0 },
@@ -173,9 +202,9 @@ exports.stateTools = [
             type: 'object',
             properties: {
                 layerId: { type: 'string', description: 'ID of the layer to modify' },
-                // Transform properties - Y axis is INVERTED from screen coordinates!
-                x: { type: 'number', description: 'X position (-1 to 1). -1 = left, +1 = right' },
-                y: { type: 'number', description: 'Y position (-1 to 1). +1 = TOP, -1 = BOTTOM (inverted from screen coords!)' },
+                // Transform properties (positive Y is UP/TOP, negative Y is down/bottom)
+                x: { type: 'number', description: 'X position (-1 to 1, 0 is center)' },
+                y: { type: 'number', description: 'Y position (-1 to 1, POSITIVE is UP/TOP, negative is down/bottom)' },
                 width: { type: 'number', description: 'Width' },
                 height: { type: 'number', description: 'Height' },
                 rotation: { type: 'number', description: 'Rotation in degrees' },
@@ -201,7 +230,11 @@ exports.stateTools = [
     },
     {
         name: 'apply_effect',
-        description: 'Apply or update the main effect (ASCII, dither, halftone, glitch, or art effect). Only one main effect can be active at a time.',
+        description: `Apply or update the main effect. Only one effect can be active at a time.
+
+IMPORTANT - Two effect pipelines:
+1. DITHER effects (WebGL): Have BUILT-IN palette and bloom. Use paletteId/colors/bloomEnabled params here. Post-processes do NOT work with dither.
+2. OTHER effects (WebGPU - ASCII, Glitch, Halftone, Art): Support stackable post-processes. Use add_postprocess for palette/bloom.`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -209,18 +242,18 @@ exports.stateTools = [
                     type: 'string',
                     enum: [
                         'none',
-                        // ASCII
+                        // ASCII (WebGPU - supports post-processes)
                         'ascii-standard', 'ascii-blocks', 'ascii-braille', 'ascii-hatching',
                         'ascii-matrix', 'ascii-technical', 'ascii-dense', 'ascii-minimal',
-                        // Dither
+                        // Dither (WebGL - has built-in palette/bloom, NO post-process support)
                         'dither-floyd-steinberg', 'dither-atkinson', 'dither-jarvis-judice-ninke',
                         'dither-stucki', 'dither-burkes', 'dither-sierra', 'dither-two-row-sierra',
                         'dither-sierra-lite', 'color-separation',
-                        // Halftone
+                        // Halftone (WebGPU - supports post-processes)
                         'halftone-mono', 'halftone-cmyk',
-                        // Glitch
+                        // Glitch (WebGPU - supports post-processes)
                         'glitch-chromatic', 'glitch-digital', 'glitch-vhs', 'glitch-weird',
-                        // Art
+                        // Art (WebGPU - supports post-processes)
                         'art-kuwahara', 'art-crosshatch', 'art-lineart', 'art-engraving', 'art-stipple',
                         // Special
                         'special-warp',
@@ -232,21 +265,34 @@ exports.stateTools = [
                 cellSize: { type: 'number', description: 'Cell size for ASCII effects (4-32)', default: 8 },
                 color: { type: 'boolean', description: 'Enable color mode for ASCII', default: true },
                 invert: { type: 'boolean', description: 'Invert ASCII effect', default: false },
-                // Dither effect settings
-                pixelation: { type: 'number', description: 'Pixelation level for dither (1-10)', default: 3 },
-                colors: { type: 'array', items: { type: 'string' }, description: 'Color palette for dither' },
+                // Dither effect settings (WebGL - has built-in palette/bloom)
+                pixelation: { type: 'number', description: 'Pixelation level for dither (1-20)', default: 3 },
+                paletteId: { type: 'string', description: 'DITHER ONLY: Palette ID (e.g., "gameboy", "synthwave", "cyberpunk", "noir"). Use list_palettes to see all 37 options.' },
+                colors: { type: 'array', items: { type: 'string' }, description: 'DITHER ONLY: Custom color palette as hex array (used when paletteId is null)' },
+                bloomEnabled: { type: 'boolean', description: 'DITHER ONLY: Enable built-in bloom glow effect', default: false },
+                bloomIntensity: { type: 'number', description: 'DITHER ONLY: Bloom intensity (0-3)', default: 0.5 },
+                bloomRadius: { type: 'number', description: 'DITHER ONLY: Bloom blur radius (1-100)', default: 20 },
                 // Halftone effect settings
-                dotSize: { type: 'number', description: 'Dot size for halftone effects' },
+                dotSize: { type: 'number', description: 'Dot size for halftone effects (0-1, default 0.3)', default: 0.3 },
                 // Glitch effect settings
-                intensity: { type: 'number', description: 'Glitch intensity (0-1)' },
-                speed: { type: 'number', description: 'Glitch animation speed' },
+                intensity: { type: 'number', description: 'Glitch intensity (0-1)', default: 0.5 },
+                speed: { type: 'number', description: 'Glitch animation speed (0-2)', default: 1 },
             },
             required: ['effectId'],
         },
     },
     {
         name: 'add_postprocess',
-        description: 'Add a post-processing effect that stacks on top of the main effect',
+        description: `Add a stackable post-processing effect. Can add multiple post-processes that apply in order.
+
+IMPORTANT: Post-processes only work with WebGPU effects (ASCII, Glitch, Halftone, Art).
+They do NOT work with Dither effects (WebGL) - use apply_effect params for dither palette/bloom instead.
+
+Common combinations:
+- CRT look: scanlines + curvature + vignette + chromatic-aberration
+- Film look: grain + vignette + brightness-contrast
+- Cyberpunk: bloom + chromatic-aberration + scanlines
+- Vaporwave: palette + bloom + chromatic-aberration`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -256,28 +302,64 @@ exports.stateTools = [
                         'scanlines', 'vignette', 'chromatic-aberration', 'curvature',
                         'grain', 'noise', 'pixelate', 'wave', 'rgb-glitch', 'brightness-contrast',
                         'color-tint', 'palette', 'jitter', 'bloom', 'dot-screen', 'sepia',
-                        'grid', 'light-beams', 'warp', 'motion-blur',
+                        'grid', 'light-beams', 'motion-blur',
                     ],
                     description: 'Post-process type',
                 },
                 enabled: { type: 'boolean', description: 'Whether effect is enabled', default: true },
-                // Common settings (type-specific settings vary)
-                intensity: { type: 'number', description: 'Effect intensity' },
+                // Shared parameters (used by multiple post-processes)
+                intensity: { type: 'number', description: 'Effect intensity - Scanlines: 0-1; Bloom: 0-3 (glow strength); Sepia: 0-1', default: 0.5 },
+                radius: { type: 'number', description: 'Effect radius - Vignette: 0.5-1.5; Bloom: 0-1 (blur radius)', default: 0.4 },
                 // Scanlines
-                count: { type: 'number', description: 'Number of scanlines' },
-                // Vignette
-                radius: { type: 'number', description: 'Vignette radius' },
+                count: { type: 'number', description: 'Scanlines: number of lines (100-1000)', default: 400 },
                 // Chromatic aberration
-                strength: { type: 'number', description: 'Aberration strength' },
-                angle: { type: 'number', description: 'Aberration angle' },
+                strength: { type: 'number', description: 'Chromatic aberration: separation strength (0-0.1)', default: 0.01 },
+                angle: { type: 'number', description: 'Chromatic aberration: separation direction (0-360)', default: 0 },
                 // Grain
-                size: { type: 'number', description: 'Grain size' },
-                speed: { type: 'number', description: 'Animation speed' },
+                size: { type: 'number', description: 'Grain: particle size (1-3)', default: 1.5 },
+                speed: { type: 'number', description: 'Animation speed for grain/noise/wave/jitter', default: 1 },
+                colorAmount: { type: 'number', description: 'Grain: color vs monochrome (0-1)', default: 0 },
                 // Brightness/Contrast
-                brightness: { type: 'number', description: 'Brightness adjustment' },
-                contrast: { type: 'number', description: 'Contrast adjustment' },
-                saturation: { type: 'number', description: 'Saturation adjustment' },
-                hue: { type: 'number', description: 'Hue rotation' },
+                brightness: { type: 'number', description: 'Brightness: adjustment (-1 to 1)', default: 0 },
+                contrast: { type: 'number', description: 'Contrast: adjustment (0-2, 1=normal)', default: 1 },
+                saturation: { type: 'number', description: 'Saturation: adjustment (0-2, 1=normal)', default: 1 },
+                hue: { type: 'number', description: 'Hue: rotation (-0.5 to 0.5)', default: 0 },
+                // Bloom (WebGPU post-process version)
+                threshold: { type: 'number', description: 'Bloom: luminance threshold (0-1)', default: 0.2 },
+                // Palette (WebGPU post-process version)
+                paletteId: { type: 'string', description: 'Palette: built-in palette ID (use list_palettes)' },
+                colors: { type: 'array', items: { type: 'string' }, description: 'Palette: custom gradient colors as hex array' },
+                // Curvature
+                curvature: { type: 'number', description: 'Curvature: CRT curve intensity (0-1)', default: 0.3 },
+                // Pixelate
+                pixelSize: { type: 'number', description: 'Pixelate: block size (1-50)', default: 4 },
+                // Wave
+                amplitude: { type: 'number', description: 'Wave: height (0-1)', default: 0.1 },
+                frequency: { type: 'number', description: 'Wave: frequency (1-20)', default: 5 },
+                // Sepia
+                // intensity already defined above
+                // Grid
+                scale: { type: 'number', description: 'Grid: cell size (1-50)', default: 20 },
+                lineWidth: { type: 'number', description: 'Grid: line thickness (1-10)', default: 1 },
+                color: { type: 'string', description: 'Grid: line color (hex)', default: '#ffffff' },
+                rotation: { type: 'number', description: 'Grid: rotation in degrees (0-360)', default: 0 },
+                // Noise
+                colored: { type: 'boolean', description: 'Noise: color vs monochrome', default: false },
+                // Color Tint
+                palette: { type: 'string', enum: ['original', 'green', 'amber', 'cyan', 'blue'], description: 'Color-tint: terminal color preset', default: 'green' },
+                // Motion Blur
+                blurType: { type: 'string', enum: ['linear', 'radial', 'rotational'], description: 'Motion-blur: blur type', default: 'linear' },
+                samples: { type: 'number', description: 'Motion-blur: quality (4-48)', default: 16 },
+                centerX: { type: 'number', description: 'Motion-blur: center X for radial/rotational (0-1)', default: 0.5 },
+                centerY: { type: 'number', description: 'Motion-blur: center Y for radial/rotational (0-1)', default: 0.5 },
+                // Light Beams
+                lightX: { type: 'number', description: 'Light-beams: source X position (0-1)', default: 0.5 },
+                lightY: { type: 'number', description: 'Light-beams: source Y position (0-1)', default: 0.3 },
+                exposure: { type: 'number', description: 'Light-beams: ray brightness (0-1)', default: 0.3 },
+                decay: { type: 'number', description: 'Light-beams: ray fade (0.9-1.0)', default: 0.96 },
+                density: { type: 'number', description: 'Light-beams: ray spread (0.5-2)', default: 1 },
+                animated: { type: 'boolean', description: 'Light-beams/Grid: enable animation', default: false },
+                particleAmount: { type: 'number', description: 'Light-beams: particle density (0-1)', default: 0.5 },
             },
             required: ['type'],
         },
@@ -459,7 +541,7 @@ async function handleStateTool(name, args) {
                     content: params.content || 'Text',
                     fontFamily: params.fontFamily || 'DM Sans',
                     fontSize: params.fontSize || 48,
-                    fontWeight: validateFontWeight(params.fontWeight),
+                    fontWeight: normalizeFontWeight(params.fontWeight),
                     color: params.color || '#ffffff',
                     textAlign: params.textAlign || 'center',
                     letterSpacing: params.letterSpacing ?? 0,
@@ -561,7 +643,7 @@ async function handleStateTool(name, args) {
                 if (params.fontSize !== undefined)
                     textLayer.fontSize = params.fontSize;
                 if (params.fontWeight !== undefined)
-                    textLayer.fontWeight = validateFontWeight(params.fontWeight);
+                    textLayer.fontWeight = normalizeFontWeight(params.fontWeight);
                 if (params.color !== undefined)
                     textLayer.color = params.color;
                 if (params.textAlign !== undefined)
@@ -626,7 +708,7 @@ async function handleStateTool(name, args) {
                 const style = effectId.replace('ascii-', '');
                 effect.ascii = {
                     style,
-                    cellSize: params.cellSize ?? 9,
+                    cellSize: clamp(params.cellSize, 4, 32, 9),
                     invert: params.invert ?? false,
                     color: params.color ?? true,
                     charRotation: false,
@@ -671,17 +753,21 @@ async function handleStateTool(name, args) {
                     'dither-sierra-lite': 'sierraLite',
                     'color-separation': 'floydSteinberg',
                 };
+                // Dither has BUILT-IN palette and bloom (WebGL pipeline)
+                // These don't use post-processes - settings are on the effect itself
                 effect.dither = {
                     pattern: patternMap[effectId] || 'floydSteinberg',
-                    pixelation: params.pixelation ?? 3,
-                    paletteId: 'noir',
+                    pixelation: clamp(params.pixelation, 1, 20, 3),
+                    // Palette: use paletteId for built-in palette, or custom colors array
+                    paletteId: params.paletteId ?? null,
                     colors: params.colors ?? ['#000000', '#ffffff'],
-                    brightness: params.brightness ?? 1,
-                    contrast: params.contrast ?? 1.2,
+                    brightness: clamp(params.brightness, 0, 2, 1),
+                    contrast: clamp(params.contrast, 0.5, 2, 1.2),
                     threshold: 1.0,
-                    bloomEnabled: false,
-                    bloomIntensity: 0.5,
-                    bloomRadius: 8,
+                    // Built-in bloom for dither (not a post-process)
+                    bloomEnabled: params.bloomEnabled ?? false,
+                    bloomIntensity: clamp(params.bloomIntensity, 0, 3, 0.5),
+                    bloomRadius: clamp(params.bloomRadius, 1, 100, 20),
                 };
             }
             else if (settingsKey === 'monoHalftone') {
@@ -692,7 +778,7 @@ async function handleStateTool(name, args) {
                     gridType: 'square',
                     dotType: 'circle',
                     inverted: false,
-                    size: params.dotSize ?? 0.3,
+                    size: clamp(params.dotSize, 0, 1, 0.3),
                     radius: 0.5,
                     contrast: 1.2,
                     spread: 0.3,
@@ -707,7 +793,7 @@ async function handleStateTool(name, args) {
                     colorM: '#ec008c',
                     colorY: '#fff200',
                     colorK: '#231f20',
-                    size: params.dotSize ?? 0.3,
+                    size: clamp(params.dotSize, 0, 1, 0.3),
                     gridNoise: 0.0,
                     type: 'ink',
                     softness: 0.0,
@@ -771,7 +857,7 @@ async function handleStateTool(name, args) {
                     localWarpStrength: 0.14,
                     flipChance: 0.15,
                     // Shared
-                    speed: params.speed ?? 1,
+                    speed: clamp(params.speed, 0, 2, 1),
                     animated: true,
                 };
             }
@@ -872,18 +958,58 @@ async function handleStateTool(name, args) {
                     content: [{ type: 'text', text: 'Error: Post-process type is required' }],
                 };
             }
+            // Check if dither effect is active - post-processes don't work with WebGL dither
+            const isDitherActive = currentPoster.effect?.effectId?.startsWith('dither-') ||
+                currentPoster.effect?.effectId === 'color-separation';
             const ppId = `pp_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`;
             const settings = {};
-            // Extract relevant settings based on type
-            const settingKeys = [
+            // Extract ALL relevant settings based on type
+            // Common settings
+            const commonKeys = [
                 'intensity', 'count', 'radius', 'strength', 'angle', 'size', 'speed',
                 'brightness', 'contrast', 'saturation', 'hue',
             ];
-            for (const key of settingKeys) {
+            // Additional settings for specific post-process types
+            const additionalKeys = [
+                'colorAmount', // grain
+                'colored', // noise
+                'threshold', // bloom
+                'paletteId', // palette
+                'colors', // palette
+                'palette', // color-tint
+                'curvature', // curvature
+                'pixelSize', // pixelate
+                'amplitude', // wave
+                'frequency', // wave, rgb-glitch
+                'scale', // grid
+                'lineWidth', // grid
+                'color', // grid
+                'rotation', // grid
+                'animated', // grid, light-beams
+                // Motion blur
+                'blurType', // motion-blur (maps to 'type')
+                'samples', // motion-blur
+                'centerX', // motion-blur
+                'centerY', // motion-blur
+                // Light beams
+                'lightX', // light-beams
+                'lightY', // light-beams
+                'exposure', // light-beams
+                'decay', // light-beams
+                'density', // light-beams
+                'particleAmount', // light-beams
+            ];
+            const allSettingKeys = [...commonKeys, ...additionalKeys];
+            for (const key of allSettingKeys) {
                 if (params[key] !== undefined) {
                     settings[key] = params[key];
                 }
             }
+            // Special handling: motion-blur uses 'type' internally but we use 'blurType' to avoid schema conflict
+            if (ppType === 'motion-blur' && settings.blurType) {
+                settings.type = settings.blurType;
+                delete settings.blurType;
+            }
             const postProcess = {
                 id: ppId,
                 type: ppType,
@@ -891,16 +1017,23 @@ async function handleStateTool(name, args) {
                 settings,
             };
             currentPoster.postProcesses.push(postProcess);
+            // Build response with warning if dither is active
+            const response = {
+                success: true,
+                message: 'Post-process added',
+                postProcess,
+                totalPostProcesses: currentPoster.postProcesses.length,
+            };
+            if (isDitherActive) {
+                response.warning = 'WARNING: Dither effects use WebGL and do NOT support post-processes. ' +
+                    'This post-process will NOT be visible. For dither, use apply_effect params (paletteId, bloomEnabled) instead. ' +
+                    'Post-processes only work with WebGPU effects (ASCII, Glitch, Halftone, Art).';
+            }
             return {
                 content: [
                     {
                         type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: 'Post-process added',
-                            postProcess,
-                            totalPostProcesses: currentPoster.postProcesses.length,
-                        }, null, 2),
+                        text: JSON.stringify(response, null, 2),
                     },
                 ],
             };