Create a new .genart-workspace file with optional initial sketches

Open an existing .genart-workspace file and load all referenced sketches

Add an existing .genart sketch file to the active workspace

Remove a sketch from the active workspace (optionally delete the file)

List all sketches in the active workspace with metadata

Create a new .genart sketch file from metadata, parameters, and algorithm. Saves to disk, auto-creates an in-memory workspace, and opens an interactive browser preview with sliders/pickers/seed controls. Save sketches to ~/.genart/sketches/.genart (directory auto-created). Do NOT present the .genart file to the user — it has no OS file association. IMPORTANT: Do not embed common utilities (PRNG, noise, easing, color math, vector ops) inline in the algorithm. Instead, declare them as components: { "prng": "^1.0.0", "noise-2d": "^1.0.0" }. Then use the exported functions directly in your algorithm (e.g., mulberry32, fbm2D). Use list_components to see all available components for the current renderer.

Open a sketch by ID to view and edit it (sets selection)

Update metadata, parameters, colors, or canvas of an existing sketch

Replace the algorithm source code of a sketch. If adding/changing components, pass them in the components field alongside the algorithm. After updating, use preview_sketch to open an interactive preview in the browser.

Algorithm data bridge: Algorithms can publish data for design layers by setting window.__genart_data properties:

• Stroke paths: Set window.__genart_data.strokePaths = [{points:[{x,y},...], depth, width, pressure:[...], group}, ...]

• Multiple channels: Publish separate arrays (e.g. strokePaths for all paths, leafPaths for depth-filtered subset)

• Grid data: Set window.__genart_data.flowField/valueMap/mask as Float32Arrays for spatial algorithms Painting layers bind to these channels via pathSource: 'algorithm:'. Declare channels in the sketch's dataChannels field via update_sketch.

Persist the current in-memory state of a sketch to disk

Create a variant of an existing sketch with a new ID and optional modifications

Delete a sketch file from disk and remove it from the workspace

List available reusable components from the registry, filtered by renderer and/or category. Components provide common utilities (PRNG, noise, easing, color math, etc.) that can be declared as dependencies instead of inlining code in the algorithm.

Add a component dependency to an existing sketch. Resolves the component and any transitive dependencies from the registry, validates renderer compatibility, and writes the resolved form to the sketch file.

Remove a component dependency from a sketch. Checks for dependent components and warns if the algorithm references the component's exports.

Return full context for the currently selected sketch(es) on the canvas

Set the canvas selection to one or more sketches by ID

Return a full snapshot of the MCP server's current state

Set the working directory for file operations. All paths are resolved relative to this directory. Supports ~ for home directory. Creates the directory if it doesn't exist.

Update the runtime parameter values of a sketch's current state

Update the runtime color palette values of a sketch's current state

Set the random seed of a sketch, optionally generating a random value

Change the canvas dimensions of a sketch using a preset or explicit width/height

Generate random values for all or specific parameters within their defined ranges

Move specific sketches to explicit positions on the canvas

Automatically lay out all or selected sketches using a configurable layout algorithm

Create or update a named group of sketches in the workspace

Scan the workspace directory for all .genart files with metadata summaries

Search loaded sketches by title, renderer, parameters, canvas size, or skills

Combine parameters, colors, and algorithm from 2+ source sketches into a new sketch

Return a structural summary of the workspace layout for AI spatial reasoning

List all available design knowledge skills (Phase 5)

Load a specific design knowledge skill with full content (Phase 5)

Return design guidelines and best practices for a topic (Phase 5)

Recommend relevant design skills based on sketch context and/or free-text description

Add a new design layer of a given type to the active sketch. Layer types come from registered plugins (e.g. 'typography:text', 'filter:grain', 'shapes:rect', 'guides:thirds').

Painting layers with algorithm stroke paths: Type 'painting:stroke' can render algorithm-published paths when properties include:

• pathSource: 'algorithm:' — binds to a path channel (e.g. 'algorithm:strokePaths')

• pathBrushId: brush preset ('flat', 'round-hard', 'round-soft', 'pencil', 'ink-pen', 'splatter')

• pathColor: hex color for strokes (e.g. '#5a4a2a')

• depthMapping: JSON string mapping path depth to brush params, e.g. '{"maxDepth":5,"width":[60,4],"pressure":[1.0,0.15],"paintLoad":[0.9,0.3],"opacity":[1.0,0.6]}' Values interpolate linearly from depth=0 to maxDepth. Paths beyond maxDepth clamp. Multiple layers can read the same or different channels for multi-pass rendering (shadow, base, highlight, leaves).

Remove a design layer from the active sketch

List all design layers in the active sketch with their types, visibility, and key properties

Get full details of a single design layer including all properties and transform

Update properties on a design layer (e.g. text content, filter intensity, shape fill color). For painting:stroke layers, updatable properties include: pathSource, pathBrushId, pathColor, depthMapping (JSON string).

Set the position, size, rotation, and scale of a design layer

Set blend mode and/or opacity on a design layer

Move a design layer to a new position in the z-order stack

Clone a design layer with a new ID, inserted directly above the source

Show or hide a design layer

Lock or unlock a design layer to prevent accidental edits

Get info about the design layer composite for a sketch. For full visual capture use capture_screenshot.

Capture a screenshot of a sketch. Returns an inline JPEG image + metadata as text. In local mode, also writes a full-res PNG to snapshots/--preview.png (path in savedPreviewTo). When a previewUrl is present in the metadata, the full-res image is available at that URL for sharing (30-min TTL). In MCP Apps-capable clients, the captured image renders inline in the conversation.

IMPORTANT TIMING: The capture waits only 500ms after page load. For animated p5 sketches that accumulate particles/lines over many frames, the screenshot may appear mostly empty. This is NORMAL — it does NOT mean the algorithm is broken. To verify animated sketches, use preview_sketch to open in the browser instead. Only use capture_screenshot for single-frame renderers (canvas2d) or after confirming the sketch works in the browser preview.

Capture screenshots of multiple sketches in parallel. Returns inline JPEG images + per-sketch metadata. In local mode, writes full-res PNGs to snapshots/.

Capture a sketch screenshot and return a structured self-critique framework (questions, principles, pitfalls) per aspect. Severity calibrates to compositionLevel.

Side-by-side capture of 2-4 sketches with a structured comparison framework across specified aspects.

Create a new curated series of sketches with narrative, intent, and studio workflow stages

Generate a structured concept development plan with mood, palette, composition, skills, and series structure recommendations

Capture all sketches in a series with narrative context for holistic evaluation

Promote a sketch to the next studio workflow stage — fork, upscale canvas, update compositionLevel, and add to series

Import an image as a reference for inspiration. Copies the image to the workspace references/ directory and attaches it to a series or sketch.

Return a structured analysis framework for a reference image, with the image for visual inspection. The agent fills in the analysis using the framework prompts.

Save a structured analysis (composition, palette, rhythm, mood, technique) back to a reference after studying it with analyze_reference.

Return a reference image for color palette extraction, with guidelines for identifying dominant colors. The agent extracts hex colors visually.

Export a sketch as standalone HTML, PNG, SVG, raw algorithm, or bundled ZIP

Open an interactive HTML preview of a sketch in the browser with parameter sliders, color pickers, and seed controls. Call this after update_algorithm to let the user explore changes interactively. Preview already opens automatically on create_sketch — only call this for re-previewing after updates. In MCP Apps-capable clients (Claude Desktop, claude.ai), the preview renders inline in the conversation.

Get full sketch definition for rendering in the preview app

List all curated external library presets available for use with create_sketch. Each entry shows the library name, version, compatible renderers, license, and description. Pass a library name in the libraries array of create_sketch to include it.

Add a text layer or update the text content of an existing text layer. If layerId is provided, updates that layer; otherwise creates a new text layer.

Apply styling to an existing text layer: font, size, weight (100–900), color, stroke, shadow, letter-spacing, tracking, kerning mode, optical alignment, and render mode.

List all available fonts (built-in system fonts and registered custom fonts) with their weights, categories, and metrics when available.

Enable or configure a drop shadow on a text layer.

Generate a modular type scale and optionally apply sizes to text layers. Given a base size and ratio, computes a harmonious progression of font sizes.

Return detailed metrics for a registered font: ascender, descender, xHeight, capHeight, available weights, and kerning pair count.

Analyze kerning quality of a text layer. Reports per-pair spacing, flags problem pairs, and suggests adjustments.

Convert a text layer to SVG path data for font-independent rendering. Returns the path data without modifying the layer.

Load a custom font from a sketch asset (OTF/TTF/WOFF2). Registers it for use in text layers and MCP tools.

Add a film grain filter layer over the canvas.

Add a vignette filter layer that darkens the edges of the canvas.

Add a duotone color mapping filter layer.

Add a Gaussian blur filter layer.

Add a chromatic aberration (RGB split) filter layer.

Add a halftone filter layer (dot, line, or diamond pattern).

Add a posterize filter layer that reduces the number of color levels.

Add a dither filter layer (Floyd-Steinberg, ordered/Bayer, or random).

Add an unsharp mask sharpening filter layer.

Add a threshold filter layer that converts to binary black/white (or custom colors).

List all available filter types and their configurable properties.

Add a shape layer (rect, ellipse, polygon, star, or arc) to the canvas.

Update fill and stroke styles of an existing shape layer.

Update polygon-specific properties (sides, rotation).

Add a line layer from (x1, y1) to (x2, y2).

Add a custom path shape layer using SVG path data (M, L, C, Q, Z commands).

List all available shape types and their properties.

Create a shape blend layer: two shapes interpolated along a spine (color transitions, shape morphing, contour shading, neon glows).

Modify properties on an existing shapes:blend layer.

Add a layout guide layer. Available types: grid, thirds, golden-ratio, diagonal.

Add a custom horizontal or vertical guide line at a specific position.

Toggle visibility of all guide layers.

Remove all guide layers from the layer stack.

Add a painting layer driven by a 2D vector field. Supports watercolor, oil, gouache, ink, pastel, and charcoal media.

Return the VectorField JSON for a painting layer, for inspection or editing.

Replace the vector field on an existing painting layer. Accepts shorthand strings, VectorField JSON, or "algorithm:channelName" to read from the algorithm data bridge.

Generate a VectorField from agent-specified control points using RBF interpolation. Each control point defines a flow direction and magnitude at a canvas position. Returns the VectorField as a JSON string suitable for use as a painting layer's 'field' property.

Create brush strokes on a painting:stroke layer. If layerId is provided, appends strokes to that layer; otherwise creates a new painting:stroke layer. Supports all 11 built-in brush presets or inline custom brushes.

List all available brush presets and any custom brushes defined on a specific painting:stroke layer.

Add a custom brush definition to a painting:stroke layer's brushes array. The brush can then be referenced by its id in brush_stroke calls.

Remove strokes from a painting:stroke layer by index range. Indices are 0-based. If 'end' is omitted, removes only the stroke at 'start'.

Create a painting:fill layer that procedurally generates marks (hatch, crosshatch, stipple, scumble, or contour) within a bounded region, with optional spatial shading. Use preset names as shorthand: hatch-light, hatch-medium, hatch-dense, crosshatch-light, crosshatch-dense, stipple-light, stipple-dense, scumble, contour.

Modify individual properties on an existing painting:fill layer without replacing everything. Partial strategy updates are merged with the existing strategy.

List all built-in fill presets with their strategy parameters.

Add a mark-field layer — fills regions with short directional marks following a vector field. Creates hatching/cross-hatching effects that follow flow direction.

Add a flow-lines layer — thousands of streamlines traced through a vector field. Creates engraving, topographic, and Schwere See-style effects.

Add a bristle-dab layer — impressionist short dabs grid-placed over a vector field. Creates stippled, hatched, and painterly impasto effects.

Add a bristle-stroke layer — oil-paint long strokes following a vector field. Creates expressive brushed paint and impasto effects.

Add a watercolor paper texture layer (cold-press, rough, smooth, hot-press). Place at the bottom of the stack under painting layers.

Add a woven canvas/linen texture layer.

Add a Japanese washi (rice paper) texture layer with visible fibers.

Add a procedural noise texture layer (value, fractal, or ridged).

Add a fine linen/fabric weave texture layer with regular thread structure.

Add an aged parchment/vellum texture with foxing spots, staining, and edge darkening.

Add a concrete/stone surface texture with coarse aggregate, pitting, and mineral flecks.

Add an animation timeline to the sketch (sets global duration, fps, and loop).

Add or replace a keyframe on a layer property.

Remove a specific keyframe from a layer property.

Remove all keyframes from a layer property (or all properties if property omitted).

List all keyframes on a layer.

Set the current animation time for preview. Returns the time that was set.

Export the animation as a GIF. Returns metadata about the export.

Export individual frames as PNG/JPEG. Returns frame metadata.

Create a motion path guide layer that animates a target layer along a series of points.

Create or update an HSL adjustment layer.

Create or update a levels adjustment layer.

Create or update a curves adjustment layer.

Automatically normalize the tonal range of the current composite by computing and applying histogram-based levels.

Create a color balance adjustment layer with shadow/midtone/highlight tinting.

Create a gradient map layer that remaps luminance to a color gradient.

Add a solid color fill layer to the canvas.

Add a gradient fill layer (linear, radial, angular, or diamond).

Import a base64-encoded image into the sketch and create a composite:image layer.

Create a group layer, optionally moving existing layers into it.

Apply a mask to a design layer. The mask source layer clips the target layer. Modifier-path layers (painting:, adjust:, filter:*) cannot be masked.

Remove the mask from a design layer, restoring full unmasked rendering.

List all image assets embedded in the current sketch.

Add a drop shadow effect layer.

Add an inner glow effect layer.

List all available blend modes with descriptions and usage guidance.

Set the blend mode of an existing layer.

Add a 3D construction form guide layer. Form types: box, cylinder, sphere, cone, wedge, egg.

Add multiple 3D construction forms arranged as a scene.

Add cross-contour lines over an outline + axis path, revealing surface direction on any organic shape.

Add a light/shadow value study overlay with terminator, cast shadow, and value zones.

Add a straight-line envelope block-in with angle and measurement annotations.

Add intersection lines between two or more overlapping 3D forms.

Generate a random construction exercise with forms at varying difficulty.

Remove all construction:* layers from the layer stack.

Generate a spatial distribution of points using a named algorithm (poisson-disk, phyllotaxis, hex-grid, jittered-grid, and more). Returns the point array and count.

Pack non-overlapping circles within a region using trial-and-reject sampling. Returns (x, y, radius) tuples and coverage percentage.

Pack rectangles into a bin using the guillotine algorithm. Returns placements with x, y, width, height, and rotated flag.

Generate a distribution and add a distribution:preview guide layer to visualize it non-destructively.

Remove distribution:preview or distribution:voronoi guide layers from the document.

Run a growth algorithm (DLA, differential-growth, substrate) and return the resulting point set and/or paths.

Tile a region using Wave Function Collapse. Returns a 2D grid of tile IDs.

Distribute points along a polyline using arc-length parameterization.

Add a figure mannequin layer. Methods: stick, bean, blocks, loomis, anatomy. Optional preset pose: standing, seated, t-pose, walking.

Update joint positions and tilt/twist on an existing mannequin layer.

Add a proportion grid with head-height divisions and anatomical landmark labels.

Add a gesture line (line of action + optional Reilly rhythm curves). Points are normalized 0–1.

Add a head construction overlay (Loomis ball+plane method with tilt/rotation controls).

Add anatomical landmark annotations. Provide keypoints directly or reference a mannequin layer.

Generate mannequin keypoints from a text description (e.g., 'standing with arms raised', 'seated cross-legged'). Uses template matching with pose presets.

Remove all figure:* layers from the layer stack.

Add a composition guide layer. Types: golden-spiral, golden-triangle, armature, rabatment, safe-margins, flow-path, musical-ratios, dynamic-symmetry, phi-grid, diagonal-grid.

Return focal point coordinates for the current canvas based on a composition system.

Return flow path waypoints and suggested element placement for the current canvas.

Remove all composition guide layers from the layer stack.

Add a perspective grid guide layer. Types: one-point, two-point, three-point, isometric.

Add a perspective floor plane (shape layer, included in exports).

Update a vanishing point on an existing perspective layer. Coordinates are normalized (0-1 is canvas bounds, values outside are allowed).

Remove all perspective:* layers from the layer stack.

Add an atmospheric perspective post-process layer. Applies depth-aware value compression, saturation reduction, and color temperature shift. Place near the top of the layer stack. Presets: hazy, clear, golden-hour, overcast.

Set the scene camera position, target, and field of view. Creates a perspective:camera layer if none exists. Position and target are in world units (1 unit = 1 meter). +X = right, +Y = up, +Z = into the scene.

Apply a named camera preset. Creates a camera layer if none exists. Presets: landscape (standing eye-height, 60° FOV), aerial (200m altitude, 45° down, 50° FOV), street (eye-height, natural 55° FOV), worm-eye (low position, 75° dramatic FOV), isometric (orthographic, 30° angle).

Orbit the camera around a center point by a horizontal and/or vertical angle. Requires an existing camera layer.

Move the camera forward or backward along its look direction. Positive = toward target, negative = away. Requires an existing camera layer.

Shift the camera left/right and up/down without changing the look direction. Requires an existing camera layer.

Add a pose skeleton overlay. Use a preset ID, category name for a random pose from that category, or custom keypoints.

Update keypoints on an existing pose skeleton layer.

Create a timed pose practice session. Creates both a timer layer and a skeleton layer.

Move to the next pose in a practice session.

Add study annotations to a pose skeleton (landmarks, angles, distances, action lines).

Analyze a pose skeleton — returns joint angles, proportions, center of gravity, symmetry score.

Generate a random anatomically-plausible pose or pick a random preset.

Remove all poses:* layers from the layer stack.

Search art movements, artist profiles, and media types by keyword, era, region, or tags.

Get full details for a specific art movement, artist, or media type by ID.

List available style recipes, optionally filtered by movement/artist/media or tags.

Get full details for a specific style recipe including layers, palette, and agent guidance.

Given a natural language description of desired aesthetic, suggest matching art styles and recipes.

Get the color palette(s) for a style movement or specific recipe.

Get a chronological timeline of art movements, optionally filtered by year range.

Apply a style recipe by adding a styles:reference guide layer to the current sketch with palette and guidance.

Search the symbol registry by keyword, category, and/or style. Returns symbols with their IDs, tags, and available styles.

List all symbol categories with symbol counts. Use this to browse the symbol library before searching.

Add a symbol from the registry to a sketch. Resolves the symbol's SVG path data and caches it in the sketch file. Automatically adds the symbol-draw component if not already present.

Remove a symbol from a sketch. Warns if the algorithm references the symbol ID.

Create a custom AI-generated symbol with SVG path data. Validates path syntax and enforces a 10KB size limit. Caches it in the sketch file for use with drawSymbol().

Search Iconify for professional icons (275k+ from Phosphor, Lucide, Tabler, MDI, etc.) or embed one into a sketch. Two modes: (1) Search — provide query to get a list of iconifyIds; (2) Embed — provide iconifyId (e.g. 'ph:cat') to fetch SVG, parse paths, and embed as a SketchSymbolDef. Approved prefixes: ph, lucide, tabler, heroicons, bi, mdi, ri, carbon, fluent.

Place a symbol as a design layer on the canvas. Creates a symbols:symbol layer with embedded SVG path data for visual composition.

Detect edges in the current canvas or a reference image using Canny edge detection. Returns edge map statistics and optionally creates a trace:reference layer.

Detect straight line segments using Hough transform. Runs edge detection first, then finds lines.

Extract simplified contour paths from edges using Ramer-Douglas-Peucker simplification.

Segment the image into color regions using k-means clustering. Returns dominant colors and region masks.

Generate a value (lightness) map from the image. Useful for tonal studies.

Detect geometric shapes (circles, rectangles, triangles, polygons) from contours.

Run full image analysis and create multiple trace layers (edges, contours, regions, values). Combines multiple trace types into a layered reference structure.

Fit smooth cubic Bezier splines to traced contours. Produces vector-quality curves from edge data. Supports threshold presets (sketch, photograph, line-art, watercolor, detail) and vectorization quality controls.

Convert image to stipple dots or hatching lines based on value (darkness). Stipple mode places dots of varying size/density; hatching draws parallel lines of varying weight.

List available threshold presets for image tracing. Each preset configures edge detection, contour extraction, and spline fitting for a specific source material type.

Create an identity lockup layer composing a mark (SVG icon) and wordmark (text). Generates a horizontal lockup by default.

Switch a lockup layer between horizontal, stacked, icon-only, or wordmark-only variants.

Generate full, reversed, grayscale, and mono color variants of a lockup layer. Creates 4 separate layers arranged on the canvas.

Create a color swatch layer showing a palette of colors with labels.

Create a scale test layer showing an SVG at multiple sizes. Returns observations about legibility at each size.

Add a construction grid overlay to the canvas for identity mark design.

Check WCAG contrast ratio between two colors. Returns ratio, AA/AAA pass status, and suggestions if failing.

Check all pairwise contrasts in a color palette. Flags pairs below threshold.

Run quality scoring on the current identity work. Checks contrast, variants, color count, scalability, simplicity, fonts, vector-only, and color independence. Returns structured score report.

Suggest a foreground color that meets WCAG contrast against a given background, preserving target hue.

Add a plant layer to the sketch. Choose from 110 botanical presets across 9 categories. Use list_plant_presets or search_plants to discover available presets. Each preset encodes species-accurate branching angles, contraction ratios, and growth patterns from botanical references.

List all 110 plant presets, optionally filtered by category, tags, complexity, or engine type.

Full-text search across plant preset names, scientific names, descriptions, and tags.

Edit L-system grammar on a plant layer. Change axiom, productions, or iterations to create custom growth patterns.

Configure tropism forces on a plant layer. Positive gravity = upward growth (phototropism), negative = drooping (gravitropism). Wind adds lateral bias.

Switch a plant layer's color palette to a seasonal variant. Affects leaf, branch, and flower colors.

Step the growth of an L-system plant by changing its iteration count. Use to simulate growth from sapling to mature tree.

Compose a garden by adding multiple plant layers at once. Each plant gets a random position, seed, and optional scale.

Add a random plant layer. Optionally constrain by category or engine type.

Analyze phyllotaxis patterns: compute parastichy numbers (Fibonacci spiral families), divergence angle, and packing efficiency for a preset or custom config.

Get a human-readable explanation of a plant preset's L-system grammar: axiom, productions, turtle interpretation, and growth behavior.

Create a flower cluster composition by combining multiple flower presets in arrangements like bouquets, wreaths, or scattered meadows.

Set drawing style and detail level on a plant layer. Styles: precise (clean vectors), ink-sketch (gestural), silhouette (filled outline). Detail levels: minimal, sketch, standard, detailed, botanical-plate.

Get ranked drawing style recommendations for a plant preset. Returns the top styles with reasons based on what works well visually for each species/category.

Set continuous growth time and 3D camera angle on a plant layer. growthTime 0 = seed, 1 = full maturity (smooth interpolation, not discrete steps). elevation/azimuth enable 3D turtle projection for volumetric canopy rendering.

Advance a plant layer's growth time by a step amount. Useful for creating growth animation frames — call repeatedly with capture_screenshot between each step to produce a time-lapse.

Configure wind dynamics on a plant layer. Wind bends branches in a direction with optional gusts and spatial turbulence. Works with all plant layer types. Use windTime with capture_screenshot for animation frames.

Create an ecosystem scene with multiple plants arranged in depth, atmospheric perspective, and optional ground plane. Plants render back-to-front with depth-based scaling and color shifting. Use arrangement presets (scatter/row/grove/border/terraced) for auto-layout or specify explicit positions.

Export a plant preset as ADR 072 AlgorithmStrokePath[] for consumption by plugin-painting brush layers. Segments become stroke paths with width/depth/pressure, leaves/flowers/polygons become closed filled-region paths with group tags. Returns JSON array of path objects.

List all available pattern presets grouped by category, with descriptions. Use this to discover presets before adding a pattern layer.

Add a pattern layer to the sketch. Specify a layer type and either a preset name or manual properties. Layer types: patterns:fill, patterns:stripe, patterns:dot, patterns:checker, patterns:wave, patterns:crosshatch-geo, patterns:herringbone, patterns:tile, patterns:custom.

Update properties of an existing pattern layer by layer ID.

Set the clip region for a pattern layer. Supports bounds (full layer), rect, ellipse, and polygon regions.

Set value-based shading on a patterns:fill layer. Shading varies opacity/density/weight spatially using uniform, linear, radial, noise, or algorithm-driven functions.

Configure seamless tiling for a patterns:tile layer — set tile shape, size, gap, rotation, and colors.

Create a custom repeating pattern from drawing commands. The pattern is stored in the sketch and can be used by a patterns:custom layer via its patternId. Commands: line, circle, rect, arc, path, polygon. Max 200 commands, 10KB limit. Coordinates are in unit-cell space (0 to width/height).

Add a sky gradient layer to the sketch. Choose a time-of-day preset (dawn, noon, golden-hour, dusk, night) or set custom zenith/horizon/haze colors. Sky layers should be at the bottom of the layer stack.

Add terrain ridgeline silhouettes to the sketch. Choose from presets: alpine-range, rolling-hills, mesa-plateau, coastal-cliffs, sand-dunes, foothills. Renders back-to-front layered noise ridges with depth-aware coloring.

Add a cloud layer to the sketch. Choose from presets: fair-weather, overcast, wispy-high, storm-clouds, scattered. Renders noise-driven cloud formations via ImageData buffer.

Add a water surface layer to the sketch. Choose from presets: still-lake, choppy-sea, mountain-stream, river, pond. Renders gradient fill with wave lines and shimmer highlights.

Add a perspective river/stream layer. The river flows from background toward foreground with width narrowing toward the horizon. Choose a preset or customize path shape, bank style, and ripple intensity. Presets: gentle-stream, wide-river, mountain-creek, lazy-oxbow, forest-brook, delta-channels, waterfall-stream, tidal-estuary.

Add a shore/coastline transition layer between water and land. Renders the strip where water meets ground with foam lines, debris, and wet/dry gradients. Position it at the same waterline as your water layer. Presets: sandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base.

Add a vegetation field layer with depth-receding marks. Renders grass, wheat, or wildflower marks that diminish in size toward the horizon. Supports wind direction and seasonal tinting. Presets: meadow-grass, wheat-field, wildflower-meadow, lavender-rows, dry-savanna, rice-paddy, autumn-stubble, snow-covered.

Add a natural rock form layer. Renders a depth-aware rock with silhouette, shadow, and texture. Supports 4 rock types (boulder, outcrop, pinnacle, shelf) and 4 texture modes (speckled, striated, cun-fa for Chinese ink style, cracked). Presets: granite-boulder, sandstone-outcrop, shan-shui-rock, mossy-rock, slate-shelf, volcanic-basalt.

Add a treeline silhouette band layer. Renders a dense canopy mass (not individual trees) with an irregular top edge profile. Treelines are visual impressions of forest edges, distinct from plugin-plants which renders individual specimens. Supports deciduous, conifer, palm, and bare winter styles. Presets: deciduous-canopy, conifer-ridge, autumn-treeline, misty-forest, palm-fringe, winter-bare.

Add a celestial body layer (sun, moon, or star) with glow and optional light path on water. Renders a radial gradient glow, a body disk, and an optional vertical shimmer band below. Presets: noon-sun, golden-hour-sun, harvest-moon, crescent-moon, blood-moon, polar-star.

Add an occluding fog layer for depth separation (shan-shui 'three distances' effect). Fog layers cover elements behind them, unlike mist particles which are additive. Renders a noise-modulated horizontal band with soft edges and wisps. Presets: morning-mist, mountain-veil, valley-fog, shan-shui-cloud-band, coastal-haar.

Add a star field layer for night sky scenes. Renders magnitude-based stars with optional Milky Way band and constellation hint lines. Stars vary in size, brightness, and color temperature. Presets: clear-night, dense-starfield, milky-way, sparse-stars, twilight-stars.

Add a vertical cliff face/rock wall layer. Renders a textured cliff silhouette with ledge shadows. Supports 4 texture modes (sandstone, granite, basalt, limestone). Presets: granite-cliff, sandstone-wall, basalt-columns, limestone-face, shale-cliff.

Add a snow-covered ground layer with drift patterns, shadow tinting, and sparkle highlights. Presets: fresh-powder, wind-swept, sun-crust, deep-snow.

Add a simple architectural silhouette layer. Renders farmhouses, churches, towers, or village clusters as filled shapes. Buildings are intentionally simple — silhouette impressions, not detailed architecture. Presets: farmhouse, church-steeple, tower-ruin, village-cluster, temple, lighthouse.

Add a bridge silhouette layer spanning between terrain elements. Supports arch, suspension, footbridge, and flat crossing styles. Presets: stone-arch, wooden-footbridge, suspension-bridge, flat-crossing.

Add a water surface reflection layer. Renders a simplified mirror of sky/terrain colors below the waterline with darkening and ripple distortion. Not an actual scene mirror — uses solid color bands that simulate reflected sky and terrain tones. Presets: calm-lake, rippled-reflection, dark-water, golden-reflection.

Add a subtle atmospheric haze layer. Lighter and more additive than fog-layer — haze softens distant elements without fully obscuring them. Supports directional gradients and noise modulation. Presets: light-haze, golden-haze, cool-mist, heat-haze.

Add a fence or wall silhouette layer. Renders picket fences, stone walls, ranch rails, or wire fences as foreground elements. Presets: white-picket, stone-wall, ranch-rail, wire-fence.

Add a boat or ship silhouette layer on water. Renders sailboats, rowboats, fishing boats, or cargo ships. Presets: sailboat, rowboat, fishing-boat, cargo-ship.

Create a complete landscape scene by adding sky + terrain profile + optional clouds + optional water in correct layer order. Each layer is auto-assigned an appropriate depth lane. Set atmosphericMode to 'western' or 'ink-wash' for automatic atmospheric perspective on terrain ridges. Returns all created layer IDs.

Create a mountain valley scene: sky + alpine ridges + valley fog + treeline + meadow field + haze.

Create a river scene: sky + rolling hills + river + shore + treeline + reflection.

Create a moonlit coastal scene: night sky + starfield + moon + water + rocky shore + dark reflection.

Create a park riverside scene: overcast sky + gentle hills + river + path + treeline + meadow + building.

Create a Chinese shan-shui (mountain-water) landscape: misty sky + sharp peaks + mountain mist + rock + calm water + haze.

Create a pastoral countryside scene: golden-hour sky + rolling hills + wheat field + country lane + picket fence + farmhouse + golden haze.

Create a forest clearing scene: overcast sky + treeline + overhanging branches + fern carpet + ground fog + woodland trail.

Create an alpine lake scene: noon sky + alpine range + snow field + calm water + lake reflection + granite cliff + cool mist.

Create a Japanese garden scene: misty sky + calm water + stone bridge + decorative rock + treeline + lake reflection + light haze.

Create a desert expanse scene: noon sky + mesa plateau + sandstone cliff + dry scrub field + heat haze + wind erosion.

Create a winter woodland scene: overcast sky + gentle hills + deep snow + conifer treeline + pine canopy vignette + morning mist.

Create a tropical coast scene: golden-hour sky + calm sea + sandy beach + sailboat + golden reflection + leaf frame vignette + golden haze.

Update an existing sky layer to a time-of-day preset, changing zenith, horizon, and haze colors.

List all 114 terrain presets, optionally filtered by category (sky, profile, clouds, water, river, path, shore, field, rock, treeline, celestial, fog, starfield, cliff-face, snowfield, building, bridge, reflection, haze, fence, boat).

Adjust depth properties on a terrain profile layer: ridge count, depth easing, elevation range, and color shift.

Set the depth lane on any terrain layer. Depth lanes define named depth slots that all plugins understand: sky, far-background, background, midground, foreground, ground-plane, overlay. Append -1 (back), -2 (mid), or -3 (front) for sub-level control within a lane (e.g. 'background-1'). Optionally set the atmospheric depth mode on terrain:profile layers.

Add a particle layer by preset name. Auto-resolves to the correct layer type (falling, floating, scatter, mist, trailing, flow, mark-field) from the preset category. 46 presets available across all categories.

List all 46 particle presets, optionally filtered by category (falling, floating, scatter, mist, trailing, flow, mark-field).

Configure depth properties on a particle layer: horizonY, depthEasing, depthDistribution, depthBandMin/Max.

Configure motion properties on a particle layer: windAngle, windStrength, fallProgress, driftRange, driftPhase, driftX.

Configure visual style on a particle layer: color, colorVariation, opacity, glow, glowColor, sizeMin, sizeMax.

Create a multi-layer atmospheric scene from a named recipe. Recipes: winter-storm (snow + fog + haze), autumn-forest (leaves falling + ground + mist), misty-morning (mist + dust), firefly-night (fireflies + fog), spring-meadow (petals + pollen + wildflowers), dusty-ruins (dust + pebbles + steam).

Add a random particle layer, optionally constrained by category (falling, floating, scatter, mist, trailing, flow, mark-field).

Configure mist band properties: bandTop, bandBottom, edgeSoftness, density, noiseScale, layerCount.

Add a fog layer to the design. Ground-level fog with terrain masking support. Types: radiation (calm morning), advection (sea fog), upslope (mountain), valley. Presets: morning-valley-fog, sea-fog, mountain-fog, dense-fog, patchy-fog. v0.2.0: fogLayers (1-5) for depth stacking, wispDensity (0-1) for edge tendrils.

Add a mist layer to the design. Mid-level haze bands with parallax stacking. Multiple semi-transparent noise layers create depth separation between terrain ridges. Presets: morning-mist, mountain-haze, thick-mist, layered-mist. v0.2.0: skyColor + colorShift for atmospheric color tint on back layers.

List available atmosphere presets. Filter by category (fog, mist, clouds, haze) or search by keyword.

Set sun angle and elevation across all atmosphere:clouds layers in the design for consistent lighting.

Add a water surface layer. Supports 3 algorithms: calm (stripe compositing for lakes/ponds), ocean (Gerstner waves for seas), flow (flow-field ripples for rivers/streams). 11 presets: still-lake, pond, misty-lake, moonlit-water, choppy-sea, ocean-swell, stormy-ocean, tropical-shallows, coastal-surf, mountain-stream, river.

Add a water reflection layer that mirrors terrain and sky below the waterline. Features Fresnel-based strength (stronger at glancing angles). 4 presets: calm-lake-reflection, rippled-reflection, dark-water-reflection, golden-reflection.

Add a foam and whitecaps layer. Renders whitecap patches on wave crests, foam trails, Langmuir circulation streaks, and bubble rafts. 4 presets: ocean-whitecaps, surf-foam, gentle-foam, storm-foam.

Add a shoreline interaction layer. Renders the water-land transition with foam lines, wave break styles (spilling/plunging/surging), and debris. 7 presets: sandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base, marsh-edge.

Add underwater caustic light patterns. Visible only in clear water (clarity > 0.3). 3 presets: shallow-caustics, deep-pool-caustics, tropical-caustics.

Add a frozen water surface layer with ice texture, cracks, frost patterns, and optional snow cover. 4 presets: frozen-lake, thin-ice, pack-ice, frost-glass.

List available water presets, optionally filtered by category (surface, reflection, foam, shoreline, caustics, ice).

Set coordinated water conditions across multiple water layers. Creates a complete water scene with surface + reflection + optional foam/shoreline. Conditions: calm (still-lake + calm-lake-reflection), choppy (choppy-sea + rippled-reflection + ocean-whitecaps), stormy (stormy-ocean + dark-water-reflection + storm-foam), frozen (frozen-lake ice).

Change the architectural style of an existing building layer. Available styles: classical, roman, romanesque, gothic, islamic, chinese, japanese, tudor, renaissance, baroque, georgian, art-nouveau, art-deco, vernacular, modernist, brutalist, high-tech, deconstructivist, parametric, futuristic, sculptural, metabolist, organic, fantasy.

List all available architectural styles with their character descriptions.

List all registered construction element types (columns, arches, windows, roofs, etc.).

Set the construction state of a building: 0 = foundation only, 0.25 = structure, 0.5 = complete, 0.75 = aged, 1.0 = ruin. Intermediate values produce partial states.

Set the illustration render mode of a building layer. Modes: filled (classic solid), pencil (graphite sketch), ink (confident lines), technical (precise architectural), engraving (crosshatch), woodcut (bold gouged).