shipshots-mcp 0.2.2 → 0.2.5

package/dist/tools/export.js

@@ -1,16 +1,16 @@
 import { z } from "zod";
 export function registerExportTools(server, api) {
-    server.tool("get_screen_preview", `Get a visual preview of a screen as an image. Returns the rendered screenshot at 50% resolution (630×1368 for standard screens). Requires a Pro plan.
+    server.tool("get_screen_preview", `Get a visual preview of a screen as an image. Requires a Pro plan.
 
 WORKFLOW: position layers → get_screen_preview → inspect the image → adjust → preview again.
 This is the recommended feedback loop for iterative layout design.
 Rate limit: 60 previews per hour. Use validate_screen (free, no rate limit) for quick layout checks without rendering.`, {
         project_id: z.string().describe("Project ID"),
         screen_id: z.string().describe("Screen ID to preview"),
-    }, async ({ project_id, screen_id }) => {
-        // Fetch preview image and project data in parallel
+        scale: z.number().min(0.25).max(1.0).optional().describe("Preview scale: 0.5 (default, 630×1368), 0.75 (945×2052), 1.0 (full 1260×2736). Higher = better detail but slower."),
+    }, async ({ project_id, screen_id, scale }) => {
         const [result, project] = await Promise.all([
-            api.getScreenPreview(project_id, screen_id),
+            api.getScreenPreview(project_id, screen_id, scale),
             api.getProject(project_id),
         ]);
         // Build layer position summary from project data
@@ -30,9 +30,55 @@ Rate limit: 60 previews per hour. Use validate_screen (free, no rate limit) for
                     text: JSON.stringify({
                         width: result.width,
                         height: result.height,
-                        scale: 0.5,
+                        scale: scale ?? 0.5,
                         layers,
-                        message: `Preview of screen "${screen_id}" (${result.width}×${result.height})`,
+                        message: `Preview of screen "${screen_id}" (${result.width}×${result.height} at ${scale ?? 0.5}x)`,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    server.tool("get_strip_preview", `Get a panoramic preview of connected screens rendered as a single wide image. Use this after connect_screens to see the cross-screen layout. Requires a Pro plan.
+Rate limit: 60 previews per hour (shared with get_screen_preview).`, {
+        project_id: z.string().describe("Project ID"),
+        screen_ids: z.array(z.string()).min(2).describe("Ordered screen IDs to render as a strip (must be connected)"),
+        scale: z.number().min(0.25).max(1.0).optional().describe("Preview scale (default 0.5). Lower = faster, higher = more detail."),
+    }, async ({ project_id, screen_ids, scale }) => {
+        const [result, project] = await Promise.all([
+            api.getStripPreview(project_id, screen_ids, scale),
+            api.getProject(project_id),
+        ]);
+        const offsets = [];
+        let cumX = 0;
+        for (const sid of screen_ids) {
+            offsets.push(cumX);
+            const s = project.screens.find((s) => s.id === sid);
+            cumX += s?.width ?? 0;
+        }
+        const layers = screen_ids.flatMap((sid, i) => {
+            const screen = project.screens.find((s) => s.id === sid);
+            if (!screen)
+                return [];
+            return screen.layers
+                .filter((l) => l.visible !== false)
+                .map((l) => ({ id: l.id, type: l.type, screen_id: sid, x: l.x + offsets[i], y: l.y, width: l.width, height: l.height }));
+        });
+        return {
+            content: [
+                {
+                    type: "image",
+                    data: result.base64,
+                    mimeType: result.mimeType,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        width: result.width,
+                        height: result.height,
+                        scale: scale ?? 0.5,
+                        screen_ids,
+                        layers,
+                        message: `Strip preview (${result.width}×${result.height} at ${scale ?? 0.5}x)`,
                     }, null, 2),
                 },
             ],
@@ -101,5 +147,31 @@ Rate limit: 60 previews per hour. Use validate_screen (free, no rate limit) for
             ],
         };
     });
+    server.tool("export_screenshot", `Export a screen as a full-resolution image. Returns a base64 JPEG at native canvas size (1260×2736 for standard screens). Requires a Pro plan.
+Rate limit: shares the 60/hour limit with get_screen_preview.
+
+For different export sizes (iPhone 6.5", iPad, etc.), use the web editor's export feature.`, {
+        project_id: z.string().describe("Project ID"),
+        screen_id: z.string().describe("Screen ID to export"),
+    }, async ({ project_id, screen_id }) => {
+        const result = await api.getScreenPreview(project_id, screen_id, 1.0);
+        return {
+            content: [
+                {
+                    type: "image",
+                    data: result.base64,
+                    mimeType: result.mimeType,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        width: result.width,
+                        height: result.height,
+                        message: `Exported screen "${screen_id}" at full resolution (${result.width}×${result.height})`,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
 }
 //# sourceMappingURL=export.js.map

package/dist/tools/export.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/tools/layers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA2BlD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA0qB1E"}
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../src/tools/layers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA6BlD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAk7B1E"}

package/dist/tools/layers.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { createTextLayer, createDeviceLayer, createImageLayer, createShapeLayer, createBadgeLayer, createArrowLayer, autoPosition, } from "../defaults.js";
+import { createTextLayer, createDeviceLayer, createImageLayer, createShapeLayer, createBadgeLayer, createArrowLayer, autoPosition, H_MARGIN, V_MARGIN, } from "../defaults.js";
 import { getProjectAndScreen, unescapeNewlines } from "../helpers.js";
 import { positionEnum, sizeEnum, tiltEnum, resolveSemanticPosition } from "../semantic-position.js";
 /** Extract position/dimension info from a layer for inclusion in tool responses. */
@@ -56,7 +56,11 @@ Use fontWeight contrast (800 vs 400) within the same font family for hierarchy.
         rotation: z.number().optional().describe("2D rotation in degrees (default: 0)"),
         rotateX: z.number().optional().describe("3D tilt on X axis, -90 to 90 (default: 0). Creates perspective depth effect."),
         rotateY: z.number().optional().describe("3D tilt on Y axis, -90 to 90 (default: 0). Creates perspective depth effect."),
-    }, async ({ project_id, screen_id, text, position, size, tilt, x, y, width, height, fontSize, fontFamily, fontWeight, color, textAlign, letterSpacing, lineHeight, fillType, gradientColor2, gradientDirection, strokeEnabled, strokeColor, strokeWidth, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
+    }, async ({ project_id, screen_id, text, position, size, tilt, x, y, width, height, fontSize, fontFamily, fontWeight, color, textAlign, letterSpacing, lineHeight, fillType, gradientColor2, gradientDirection, strokeEnabled, strokeColor, strokeWidth, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -93,6 +97,10 @@ Use fontWeight contrast (800 vs 400) within the same font family for hierarchy.
             ...(rotation !== undefined ? { rotation } : semantic.rotation !== undefined ? { rotation: semantic.rotation } : {}),
             ...(rotateX !== undefined ? { rotateX } : {}),
             ...(rotateY !== undefined ? { rotateY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -136,7 +144,11 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
         shadowBlur: z.number().optional().describe("Shadow blur radius in pixels (default: 20)"),
         shadowOffsetX: z.number().optional().describe("Shadow horizontal offset (default: 0)"),
         shadowOffsetY: z.number().optional().describe("Shadow vertical offset (default: 10)"),
-    }, async ({ project_id, screen_id, deviceType, screenshotUrl, position, size, tilt, x, y, width, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
+    }, async ({ project_id, screen_id, deviceType, screenshotUrl, position, size, tilt, x, y, width, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -160,6 +172,10 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
             ...(shadowBlur !== undefined ? { shadowBlur } : {}),
             ...(shadowOffsetX !== undefined ? { shadowOffsetX } : {}),
             ...(shadowOffsetY !== undefined ? { shadowOffsetY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -191,7 +207,11 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
         shadowBlur: z.number().optional().describe("Shadow blur radius in pixels (default: 20)"),
         shadowOffsetX: z.number().optional().describe("Shadow horizontal offset (default: 0)"),
         shadowOffsetY: z.number().optional().describe("Shadow vertical offset (default: 10)"),
-    }, async ({ project_id, screen_id, imageUrl, position, size, tilt, x, y, width, height, objectFit, borderRadius, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
+    }, async ({ project_id, screen_id, imageUrl, position, size, tilt, x, y, width, height, objectFit, borderRadius, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -217,6 +237,10 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
             ...(shadowBlur !== undefined ? { shadowBlur } : {}),
             ...(shadowOffsetX !== undefined ? { shadowOffsetX } : {}),
             ...(shadowOffsetY !== undefined ? { shadowOffsetY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -228,7 +252,9 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
 
 QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size ("small", "medium", "large", "full-width"), and tilt ("slight-left", "dramatic-right", ...) for semantic positioning. Explicit x/y/width/height/rotation override these.
 
-TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative orbs behind device frames for visual depth.`, {
+TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative orbs behind device frames for visual depth.
+
+DEPTH EFFECTS: Use gradientType "radial" for spotlight/glow orbs. Add blurEnabled + blurAmount for depth-of-field. Use backdropBlurEnabled + backdropBlurAmount on semi-transparent shapes for frosted glass panels.`, {
         project_id: z.string().describe("Project ID"),
         screen_id: z.string().describe("Screen ID"),
         shapeType: z.enum(["rect", "circle", "rounded-rect"]).describe("Shape type"),
@@ -239,6 +265,7 @@ TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative
         fillType: z.enum(["solid", "gradient", "image"]).optional().describe('Fill type (default: "solid")'),
         gradientColor2: z.string().optional().describe('Second gradient color hex (default: "#000000")'),
         gradientDirection: z.number().optional().describe("Gradient angle in degrees 0-360 (default: 135)"),
+        gradientType: z.enum(["linear", "radial"]).optional().describe('Gradient interpolation type. "radial" creates spotlight/glow effects centered in the shape. Default: "linear"'),
         fillImageUrl: z.string().optional().describe("Image URL or local file path for image fill"),
         fillImageSize: z.enum(["cover", "contain", "fill"]).optional().describe('Image fill size mode (default: "cover")'),
         x: z.number().optional().describe("X position"),
@@ -257,7 +284,11 @@ TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative
         shadowBlur: z.number().optional().describe("Shadow blur radius in pixels (default: 20)"),
         shadowOffsetX: z.number().optional().describe("Shadow horizontal offset (default: 0)"),
         shadowOffsetY: z.number().optional().describe("Shadow vertical offset (default: 10)"),
-    }, async ({ project_id, screen_id, shapeType, position, size, tilt, fill, fillType, gradientColor2, gradientDirection, fillImageUrl, fillImageSize, x, y, width, height, borderRadius, stroke, strokeWidth, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50. Blurs content behind this layer — great for frosted glass panels."),
+    }, async ({ project_id, screen_id, shapeType, position, size, tilt, fill, fillType, gradientColor2, gradientDirection, gradientType, fillImageUrl, fillImageSize, x, y, width, height, borderRadius, stroke, strokeWidth, rotation, rotateX, rotateY, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -272,6 +303,7 @@ TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative
             ...(fillType !== undefined ? { fillType } : {}),
             ...(gradientColor2 !== undefined ? { gradientColor2 } : {}),
             ...(gradientDirection !== undefined ? { gradientDirection } : {}),
+            ...(gradientType !== undefined ? { gradientType } : {}),
             ...(resolvedFillImageUrl !== undefined ? { fillImageUrl: resolvedFillImageUrl } : {}),
             ...(fillImageSize !== undefined ? { fillImageSize } : {}),
             ...(x !== undefined ? { x } : semantic.x !== undefined ? { x: semantic.x } : {}),
@@ -290,6 +322,10 @@ TIP: Use large semi-transparent gradient circles (opacity 0.3-0.5) as decorative
             ...(shadowBlur !== undefined ? { shadowBlur } : {}),
             ...(shadowOffsetX !== undefined ? { shadowOffsetX } : {}),
             ...(shadowOffsetY !== undefined ? { shadowOffsetY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -336,7 +372,11 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
         rotation: z.number().optional().describe("2D rotation in degrees (default: 0)"),
         rotateX: z.number().optional().describe("3D tilt on X axis, -90 to 90 (default: 0). Creates perspective depth effect."),
         rotateY: z.number().optional().describe("3D tilt on Y axis, -90 to 90 (default: 0). Creates perspective depth effect."),
-    }, async ({ project_id, screen_id, badgeStyle, text, position, size, tilt, x, y, width, height, fontSize, fontFamily, fontWeight, color, backgroundColor, backgroundOpacity, borderRadius, iconType, iconColor, rating, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
+    }, async ({ project_id, screen_id, badgeStyle, text, position, size, tilt, x, y, width, height, fontSize, fontFamily, fontWeight, color, backgroundColor, backgroundOpacity, borderRadius, iconType, iconColor, rating, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -371,6 +411,10 @@ QUICK PLACEMENT: Use position ("center", "top-left", "bottom-right", ...), size
             ...(rotation !== undefined ? { rotation } : semantic.rotation !== undefined ? { rotation: semantic.rotation } : {}),
             ...(rotateX !== undefined ? { rotateX } : {}),
             ...(rotateY !== undefined ? { rotateY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -408,7 +452,11 @@ POSITIONING TIP:
         rotation: z.number().optional().describe("2D rotation in degrees (default: 0)"),
         rotateX: z.number().optional().describe("3D tilt on X axis, -90 to 90 (default: 0). Creates perspective depth effect."),
         rotateY: z.number().optional().describe("3D tilt on Y axis, -90 to 90 (default: 0). Creates perspective depth effect."),
-    }, async ({ project_id, screen_id, fromX, fromY, toX, toY, strokeColor, strokeWidth, headStyle, curvature, dashed, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY }) => {
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur (default: false)"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur (default: false). Layer needs low opacity to see the effect."),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
+    }, async ({ project_id, screen_id, fromX, fromY, toX, toY, strokeColor, strokeWidth, headStyle, curvature, dashed, opacity, shadowEnabled, shadowColor, shadowBlur, shadowOffsetX, shadowOffsetY, rotation, rotateX, rotateY, blurEnabled, blurAmount, backdropBlurEnabled, backdropBlurAmount }) => {
         const result = await getProjectAndScreen(api, project_id, screen_id);
         if ("error" in result) {
             return { content: [{ type: "text", text: result.error }], isError: true };
@@ -434,6 +482,10 @@ POSITIONING TIP:
             ...(rotation !== undefined ? { rotation } : {}),
             ...(rotateX !== undefined ? { rotateX } : {}),
             ...(rotateY !== undefined ? { rotateY } : {}),
+            ...(blurEnabled !== undefined ? { blurEnabled } : {}),
+            ...(blurAmount !== undefined ? { blurAmount } : {}),
+            ...(backdropBlurEnabled !== undefined ? { backdropBlurEnabled } : {}),
+            ...(backdropBlurAmount !== undefined ? { backdropBlurAmount } : {}),
         });
         screen.layers.push(layer);
         await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
@@ -500,6 +552,11 @@ QUICK PLACEMENT: Use position/size/tilt for quick repositioning. Explicit x/y/wi
         shadowBlur: z.number().optional().describe("Shadow blur radius in pixels"),
         shadowOffsetX: z.number().optional().describe("Shadow horizontal offset"),
         shadowOffsetY: z.number().optional().describe("Shadow vertical offset"),
+        gradientType: z.enum(["linear", "radial"]).optional().describe('Gradient type for shape layers: "linear" or "radial"'),
+        blurEnabled: z.boolean().optional().describe("Enable Gaussian blur"),
+        blurAmount: z.number().min(0).max(50).optional().describe("Blur radius in pixels, 0-50"),
+        backdropBlurEnabled: z.boolean().optional().describe("Enable frosted glass backdrop blur"),
+        backdropBlurAmount: z.number().min(0).max(50).optional().describe("Backdrop blur radius in pixels, 0-50"),
         animation_entrance_type: z.string().optional().describe('Override entrance animation type. Valid: "fade-rise", "slide-right", "zoom-pop", "fade", "bounce", "parallax", "drop-bounce", "flip", "typewriter", "blur-in", "wipe", "elastic". Set to "" to clear.'),
         animation_entrance_duration: z.number().optional().describe("Override entrance duration in frames"),
         animation_entrance_delay: z.number().optional().describe("Override entrance delay in frames"),
@@ -604,5 +661,189 @@ QUICK PLACEMENT: Use position/size/tilt for quick repositioning. Explicit x/y/wi
             content: [{ type: "text", text: JSON.stringify({ message: "Layers reordered.", order: layer_ids }, null, 2) }],
         };
     });
+    // ── move_layer ──
+    server.tool("move_layer", `Move a layer's z-order position. Use "to-front"/"to-back" for extremes, or "in-front-of"/"behind" with a reference_layer_id for relative positioning. Simpler than reorder_layers when you just need to adjust one layer.`, {
+        project_id: z.string().describe("Project ID"),
+        screen_id: z.string().describe("Screen ID"),
+        layer_id: z.string().describe("Layer ID to move"),
+        placement: z.enum(["in-front-of", "behind", "to-front", "to-back"]).describe("Where to place the layer"),
+        reference_layer_id: z.string().optional().describe("Reference layer ID (required for 'in-front-of' and 'behind')"),
+    }, async ({ project_id, screen_id, layer_id, placement, reference_layer_id }) => {
+        const result = await getProjectAndScreen(api, project_id, screen_id);
+        if ("error" in result) {
+            return { content: [{ type: "text", text: result.error }], isError: true };
+        }
+        const { project, screenIndex } = result;
+        const screen = project.screens[screenIndex];
+        const sorted = [...screen.layers].sort((a, b) => a.zIndex - b.zIndex);
+        const targetIndex = sorted.findIndex((l) => l.id === layer_id);
+        if (targetIndex === -1) {
+            const ids = screen.layers.map((l) => l.id).join(", ");
+            return { content: [{ type: "text", text: `Error: Layer "${layer_id}" not found. Available: ${ids}` }], isError: true };
+        }
+        const [target] = sorted.splice(targetIndex, 1);
+        if (placement === "to-front") {
+            sorted.push(target);
+        }
+        else if (placement === "to-back") {
+            sorted.unshift(target);
+        }
+        else {
+            if (!reference_layer_id) {
+                return { content: [{ type: "text", text: `Error: reference_layer_id is required for "${placement}".` }], isError: true };
+            }
+            const refIndex = sorted.findIndex((l) => l.id === reference_layer_id);
+            if (refIndex === -1) {
+                const ids = screen.layers.map((l) => l.id).join(", ");
+                return { content: [{ type: "text", text: `Error: Reference layer "${reference_layer_id}" not found. Available: ${ids}` }], isError: true };
+            }
+            const insertAt = placement === "in-front-of" ? refIndex + 1 : refIndex;
+            sorted.splice(insertAt, 0, target);
+        }
+        // Re-number all zIndex values
+        for (let i = 0; i < sorted.length; i++) {
+            const layer = screen.layers.find((l) => l.id === sorted[i].id);
+            if (layer)
+                layer.zIndex = i + 1;
+        }
+        await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
+        const order = sorted.map((l) => l.id);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ message: "Layer moved.", layer_id, placement, order }, null, 2) }],
+        };
+    });
+    // ── align_layer ──
+    server.tool("align_layer", `Align a layer relative to the canvas boundaries. Uses standard margins (${H_MARGIN}px horizontal, ${V_MARGIN}px vertical) for edge alignments.`, {
+        project_id: z.string().describe("Project ID"),
+        screen_id: z.string().describe("Screen ID"),
+        layer_id: z.string().describe("Layer ID to align"),
+        alignment: z.enum([
+            "center-horizontal", "center-vertical", "center",
+            "left", "right", "top", "bottom",
+        ]).describe("Alignment relative to the canvas"),
+    }, async ({ project_id, screen_id, layer_id, alignment }) => {
+        const result = await getProjectAndScreen(api, project_id, screen_id);
+        if ("error" in result) {
+            return { content: [{ type: "text", text: result.error }], isError: true };
+        }
+        const { project, screenIndex } = result;
+        const screen = project.screens[screenIndex];
+        const layer = screen.layers.find((l) => l.id === layer_id);
+        if (!layer) {
+            const ids = screen.layers.map((l) => l.id).join(", ");
+            return { content: [{ type: "text", text: `Error: Layer "${layer_id}" not found. Available: ${ids}` }], isError: true };
+        }
+        if (alignment === "center-horizontal" || alignment === "center") {
+            layer.x = Math.round((screen.width - layer.width) / 2);
+        }
+        if (alignment === "center-vertical" || alignment === "center") {
+            layer.y = Math.round((screen.height - layer.height) / 2);
+        }
+        if (alignment === "left")
+            layer.x = H_MARGIN;
+        if (alignment === "right")
+            layer.x = screen.width - layer.width - H_MARGIN;
+        if (alignment === "top")
+            layer.y = V_MARGIN;
+        if (alignment === "bottom")
+            layer.y = screen.height - layer.height - V_MARGIN;
+        await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
+        return {
+            content: [{ type: "text", text: JSON.stringify({ message: `Layer aligned (${alignment}).`, ...layerPosition(layer) }, null, 2) }],
+        };
+    });
+    // ── align_layers ──
+    server.tool("align_layers", `Align multiple layers relative to each other, or distribute them evenly.`, {
+        project_id: z.string().describe("Project ID"),
+        screen_id: z.string().describe("Screen ID"),
+        layer_ids: z.array(z.string()).min(2).describe("Layer IDs to align"),
+        alignment: z.enum([
+            "left", "right", "top", "bottom",
+            "center-horizontal", "center-vertical",
+            "distribute-horizontal", "distribute-vertical",
+        ]).describe("How to align the layers relative to each other"),
+    }, async ({ project_id, screen_id, layer_ids, alignment }) => {
+        const result = await getProjectAndScreen(api, project_id, screen_id);
+        if ("error" in result) {
+            return { content: [{ type: "text", text: result.error }], isError: true };
+        }
+        const { project, screenIndex } = result;
+        const screen = project.screens[screenIndex];
+        const layers = layer_ids.map((id) => screen.layers.find((l) => l.id === id)).filter(Boolean);
+        if (layers.length < 2) {
+            return { content: [{ type: "text", text: `Error: Need at least 2 valid layer IDs. Found ${layers.length}.` }], isError: true };
+        }
+        switch (alignment) {
+            case "left": {
+                const minX = Math.min(...layers.map((l) => l.x));
+                for (const l of layers)
+                    l.x = minX;
+                break;
+            }
+            case "right": {
+                const maxRight = Math.max(...layers.map((l) => l.x + l.width));
+                for (const l of layers)
+                    l.x = maxRight - l.width;
+                break;
+            }
+            case "top": {
+                const minY = Math.min(...layers.map((l) => l.y));
+                for (const l of layers)
+                    l.y = minY;
+                break;
+            }
+            case "bottom": {
+                const maxBottom = Math.max(...layers.map((l) => l.y + l.height));
+                for (const l of layers)
+                    l.y = maxBottom - l.height;
+                break;
+            }
+            case "center-horizontal": {
+                const avgCx = layers.reduce((s, l) => s + l.x + l.width / 2, 0) / layers.length;
+                for (const l of layers)
+                    l.x = Math.round(avgCx - l.width / 2);
+                break;
+            }
+            case "center-vertical": {
+                const avgCy = layers.reduce((s, l) => s + l.y + l.height / 2, 0) / layers.length;
+                for (const l of layers)
+                    l.y = Math.round(avgCy - l.height / 2);
+                break;
+            }
+            case "distribute-horizontal": {
+                const sorted = [...layers].sort((a, b) => a.x - b.x);
+                const first = sorted[0];
+                const last = sorted[sorted.length - 1];
+                const totalSpan = (last.x + last.width) - first.x;
+                const totalLayerWidth = sorted.reduce((s, l) => s + l.width, 0);
+                const gap = (totalSpan - totalLayerWidth) / (sorted.length - 1);
+                let cx = first.x + first.width;
+                for (let i = 1; i < sorted.length - 1; i++) {
+                    sorted[i].x = Math.round(cx + gap);
+                    cx = sorted[i].x + sorted[i].width;
+                }
+                break;
+            }
+            case "distribute-vertical": {
+                const sorted = [...layers].sort((a, b) => a.y - b.y);
+                const first = sorted[0];
+                const last = sorted[sorted.length - 1];
+                const totalSpan = (last.y + last.height) - first.y;
+                const totalLayerHeight = sorted.reduce((s, l) => s + l.height, 0);
+                const gap = (totalSpan - totalLayerHeight) / (sorted.length - 1);
+                let cy = first.y + first.height;
+                for (let i = 1; i < sorted.length - 1; i++) {
+                    sorted[i].y = Math.round(cy + gap);
+                    cy = sorted[i].y + sorted[i].height;
+                }
+                break;
+            }
+        }
+        await api.updateProject(project_id, { ...project, screens: project.screens, updatedAt: new Date().toISOString() });
+        const positions = layers.map((l) => ({ id: l.id, ...layerPosition(l) }));
+        return {
+            content: [{ type: "text", text: JSON.stringify({ message: `Layers aligned (${alignment}).`, layers: positions }, null, 2) }],
+        };
+    });
 }
 //# sourceMappingURL=layers.js.map