Render and push pixel art, styled text, scenes, and animations to Divoom Pixoo LED displays on your local network via MCP, plus read and control device state.
pixoo_display_text — render styled text (themes, gradients, shadows, outlines, scale, auto-fit, scrolling/float/pulse effects) and push it, with an image preview.
pixoo_compose_scene — layer up to 50 elements (text, icons, rects, circles, lines, progress bars, sparklines, bitmaps, pixels, images, sprites) with per-element blending, opacity, effects, and keyframe animations.
pixoo_push_image — resize a local or https image (GIF/WebP as animation) to the LED grid and push it, with fit/kernel/finish palette options.
pixoo_overlay_text — set or clear device-rendered scrolling text overlays on 20 slots with device font IDs, colors, speed, and direction.
pixoo_control_device — read or change brightness, screen on/off, channel, and clock face.
pixoo_discover_devices — find Pixoo devices and their LAN IPs via Divoom's cloud discovery.
pixoo_design_brief — get craft guidance for a topic with live device state and pre-filled next-tool suggestions.
Resources — live device status (pixoo://device/status) plus reference registries for themes, icons, and the long-form design guide.
Runs over STDIO or Streamable HTTP, with previews on every render, layout transparency, and push pacing to protect the device.
Allows using Cloudflare R2, KV, or D1 as swappable storage backends for managing server data and display assets.
Enables loading, resizing, and pushing JPEG images directly to Divoom Pixoo LED matrices.
Includes support for OpenTelemetry instrumentation to provide observability and monitoring of server operations.
Provides support for using Supabase as a storage backend provider for server data and configurations.
Supports loading and pushing SVG vector graphics to Divoom Pixoo devices with automatic resizing to the display grid.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@pixoo-mcp-server display 'Meeting in Progress' in red scrolling text and set brightness to 50"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Divoom Pixoo LED matrix displays on the local network, with the Pixoo-64 as the primary target and the 16 and 32 also supported. Render and push styled text, layered scenes, dashboards, and animations, or read and change device state. Runs as a stdio process or a local Streamable HTTP server.
Tool | Description |
| Render styled text with themes, gradients, shadows, and auto-fit, static or animated, and push it |
| Compose layered scenes of text, icons, widgets, shapes, bitmaps, images, and sprites, static or animated |
| Resize a local or https image to the LED grid and push it, an animated GIF or WebP as an animation |
| Set or clear a device-rendered scrolling text overlay |
| Read or change brightness, screen state, channel, or clock face |
| Find Pixoo devices and their LAN IPs through Divoom's cloud discovery |
| Craft guidance for a design topic, with live device state and pre-filled next calls |
Resource | Description |
| Live device snapshot: reachability, channel, brightness, screen state, display size |
| Theme and palette registry |
| Built-in icon names by category |
| Long-form craft guide for the 64px display |
Tools cover the same ground for tool-only clients: pixoo_control_device reads the live device state, and pixoo_design_brief returns craft guidance, theme names, and icon names.
Related MCP server: mcp-divoom-lan
pixoo_display_text tooltext as a string or an array of lines; theme (midnight, ember, claude, ice, neon, forest, mono) sets the background and default palette. style takes a palette ramp (ember, ice, neon, fire, lavender, claude, mono) or a custom { from, to }, plus shadow, outline, and scale 1–8; position is semantic or in pixels, and align lines up multi-line text
font: standard (5×7) and compact (3×5) draw printable ASCII plus ° ← ↑ → ↓ ▲ ▼ ♥ · …, and any other character (€, ’, a newline inside one string) as ?, named with its code point and line index in the response notice; numerals is an 11×18 digit face for clocks and readouts that draws 0–9, space, and : . - + / % ° ?, and text holding any other character fails validation, naming those characters
layout[] reports every fit decision as an action (shrunk-to-compact when the text fits only in the compact font, scrolling when the returned frames scroll, none otherwise), the font used, and whether each line's box fits on the panel; a single line too wide for the panel starts at x 0, cut at the right edge when it does not scroll. Single-line text falls back from the standard to the compact font unless font is set — never to numerals — and text still too wide only scrolls under effect: "auto" or "scroll"
effect: scroll makes one pass in up to 40 frames, auto scrolls only on overflow, and float and pulse loop over 20 frames; frames reports the count, and the animation pushes as one device animation
pixoo_compose_scene toolUp to 50 elements drawn back-to-front: text (in the same three fonts as pixoo_display_text), icon, rect, circle, line, progress, sparkline, bitmap, pixels, image (absolute path or https URL, with the same finish as pixoo_push_image), sprite (absolute path). The background is a solid color, a v / h / r gradient, or a theme
Every element takes opacity (each pixel lands at its own alpha × opacity, so soft edges fade evenly) and blend: normal, add (glows and light beams), screen, or multiply. line and outline circle take strokeWidth and antialias, and a rect border takes strokeWidth, growing inward; either field on a shape that draws no stroke fails validation, naming it
Returns layout[]: each element's placed box — for a wide or anti-aliased stroke, every pixel it draws — and whether it fits on the panel. Elements are placed as given and never refit, so action is always none. An absolute output path saves the first frame as a PNG in place of the PIXOO_OUTPUT_DIR auto-save. Typed failures: asset_not_found, invalid_image (an image or sprite that was read but does not decode), invalid_color, unknown_icon, invalid_output_path
Animation through per-element effect presets (float, scroll-left, scroll-right, pulse, blink, twinkle, drift, fade-in, fade-out) or raw animate keyframes over dx, dy, opacity (numbers or numeric strings), visible (true/false), and color (interpolated through RGB on any element with a color), each track holding at least one keyframe; frames 1–40, speed 10–2000 ms per frame (default 150). An element takes effect or animate, not both. An effect's amplitude sets the movement of float, scroll-*, and drift, and the 0–1 depth of the pulse and twinkle opacity dip
pixoo_push_image toolsource is an absolute local path or an https URL, with downloads capped at 10 MB; fit is contain (default), cover, or fill, and kernel is nearest (default, for pixel art), lanczos3 (photos), or mitchell
A source that decodes as an animated GIF or WebP, whatever its file name, pushes as an animation of up to 40 frames, sampled evenly from a longer source. It plays at the source's total duration over the pushed frame count (150 ms when the source records no delays), or at speed (10–2000 ms per frame); frames, sourceFrames, and speed report what was pushed
finish reduces the image to a palette before the push: exactly one of colors (2–256, built from the image) or palette (1–256 hex or named colors), plus dither (none, bayer4, floyd-steinberg). Transparent pixels stay unlit, and an animation's colors palette is shared by every frame
An unreadable path or URL fails as asset_not_found, a source that is read but does not decode (a text file, an HTML page, a truncated download) fails as invalid_image, and an unresolvable finish palette entry fails as invalid_color; the preview is the exact frame the device receives, or a grid of every frame for an animation
pixoo_overlay_text toolmode: "set" or "clear" on one of 20 slots (id 0–19). set requires text and takes a device font ID (0–114), x / y within PIXOO_SIZE, color, speed (0–100), direction, align, and width
Returns acknowledged, mode, and id. The device renders the overlay, so there is no preview, and it persists across channel switches until cleared
pixoo_control_device toolNo params reads state; any of brightness (0–100), screen (on / off), channel (faces / cloud / visualizer / custom), or clockFaceId is applied before the read-back
Returns reachable, channel, brightness, screenOn, and clockId (absent when unreachable) plus applied; a failed setting is left out of applied and named in the notice instead of failing the call
pixoo_discover_devices toolQueries Divoom's cloud endpoint (app.divoom-gz.com), so it needs internet access; timeoutMs 1000–30000 (default 5000)
Returns each device's name, id, and ip; with PIXOO_IP set, configuredIpFound says whether it matched. An unreachable endpoint fails as discovery_failed
pixoo_design_brief tooltopic: text, scene, dashboard, animation, pixel-art, or troubleshooting; works without a reachable device
Returns markdown craftGuidance, a live deviceContext, nextToolSuggestions as { toolName, reason, args } with arguments pre-filled for the topic and device state, plus availableThemes and iconCategories
pixoo://device/status resourceUncached live read: reachable, channel, brightness, screenOn, clockId, displaySize, configuredIp
Returns reachable: false rather than an error when the device can't be reached or PIXOO_IP is unset
pixoo://reference/themes resourceEvery theme (background, textPalette, accent, shadow) and palette (from / to stops), plus themeNames and paletteNames for the theme and palette parameters
Static registry, cached for 24h
pixoo://reference/icons resourceEach icon's name, category, and viewBox, plus a byCategory grouping (weather, arrows, status, media); a name goes in a pixoo_compose_scene icon element
Static registry, cached for 24h
pixoo://reference/design-guide resourcetext/markdown: legibility floors, palette discipline, layout zones, animation budget, effect presets, pixel art rules, push pacing, and known device behaviors
The whole guide in one document, where pixoo_design_brief returns guidance per topic; cached for 24h
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
Pixoo-specific:
All composition happens on the host in an RGBA canvas pipeline (@cyanheads/pixoo-toolkit); the device receives finished RGB frames
Pushes switch the device to the custom channel and run one at a time, spaced by PIXOO_PUSH_MIN_INTERVAL_MS (default 1000) so rapid pushes don't freeze the device
Animations cap at 40 frames, past which the device becomes unstable; pixoo_push_image samples a longer GIF or WebP down to 40
Agent-friendly output:
Preview on every render: pixoo_display_text, pixoo_compose_scene, and pixoo_push_image return the frame as an 8× upscaled PNG image block, pushed or not, so push: false checks a design with no device attached. Animations preview as a grid of every frame, since GIF display varies across MCP clients; the GIF itself is saved to PIXOO_OUTPUT_DIR when set
Layout transparency: layout[] reports every renderer decision (font fallback, scrolling, and whether each box fits on the panel) so agents can refine a design
Device truth: pushed reflects the device ACK, and the deviceState read back after a push comes with a notice naming the fix when the render won't be visible (screen off, brightness ≤ 10, off the custom channel)
Renders survive failed pushes: the typed error (device_unreachable, device_http_error, device_rejected, no_device_configured) carries outputFiles pointing at the saved preview (the PIXOO_OUTPUT_DIR copy, or a temp file when that is unset)
Add the following to your MCP client configuration file, with PIXOO_IP set to your Pixoo's LAN address. pixoo_discover_devices finds it if you don't know it.
{
"mcpServers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/pixoo-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"PIXOO_IP": "192.168.1.50"
}
}
}
}Or with npx (no Bun required):
{
"mcpServers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cyanheads/pixoo-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"PIXOO_IP": "192.168.1.50"
}
}
}
}Or with Docker:
{
"mcpServers": {
"pixoo-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_TRANSPORT_TYPE=stdio",
"-e", "PIXOO_IP=192.168.1.50",
"ghcr.io/cyanheads/pixoo-mcp-server:latest"
]
}
}
}For Streamable HTTP, set the transport and start the server:
MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 PIXOO_IP=192.168.1.50 bun run start:http
# Server listens at http://localhost:3010/mcpBun v1.4.0 or higher (or Node.js v24+).
A Divoom Pixoo on the local network (Pixoo-64, Pixoo-32, or Pixoo-16).
Clone the repository:
git clone https://github.com/cyanheads/pixoo-mcp-server.gitNavigate into the directory:
cd pixoo-mcp-serverInstall dependencies:
bun installConfigure environment:
cp .env.example .env
# edit .env and set PIXOO_IPVariable | Description | Default |
| Device IP on the local network. Required for pushes, overlays, and device control; discovery, design briefs, and | — |
| Display size in pixels: |
|
| Directory where render tools save preview PNG and GIF files. A relative path resolves against the directory the server was launched from, so the saved paths it reports are absolute. Unset, previews are returned only in the response. | — |
| Minimum gap between device pushes, in ms. |
|
| Transport: |
|
| HTTP server port. |
|
| HTTP session mode: |
|
| Authentication: |
|
| Log level ( |
|
| Directory for log files (Node.js only). |
|
| Log each failed tool call's arguments and result, redacted by key name and capped at |
|
| Enable OpenTelemetry. |
|
See .env.example for the full list of optional overrides.
Build and run:
# One-time build
bun run rebuild
# Run the built server
bun run start:stdio
# or
bun run start:httpRun checks and tests:
bun run devcheck # Lint, format, typecheck, security
bun run test # Vitest test suite
bun run lint:mcp # Validate MCP definitions against specdocker build -t pixoo-mcp-server .
docker run --rm -e PIXOO_IP=192.168.1.50 -p 3010:3010 pixoo-mcp-serverThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/pixoo-mcp-server. OpenTelemetry peer dependencies are installed by default; build with --build-arg OTEL_ENABLED=false to omit them.
Directory | Purpose |
|
|
| Server-specific environment variable parsing and validation with Zod. |
| Tool definitions ( |
| Resource definitions ( |
|
|
| Pure rendering pipeline with no device dependency: element renderers, styled-text engine, themes, icons, effect compiler, palette finishing, preview encoding, remote image fetch. |
| Unit and integration tests mirroring |
See CLAUDE.md/AGENTS.md for development guidelines and architectural rules. The short version:
Handlers throw, framework catches — no try/catch in tool logic
Use ctx.log for request-scoped logging, ctx.state for tenant-scoped storage
The renderer (src/renderer/) is pure — no device dependency, testable without hardware
All device calls go through PixooService; every PixooResult is checked — never assume a push succeeded
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run testApache-2.0 — see LICENSE for details.
Compose a full scene: layered elements (text, icons, widgets, shapes, bitmaps, images, sprites) with per-element effects and keyframes, static or animated. Returns the rendered scene as an image content block for immediate inspection. Elements render back-to-front in array order. For text-only display use pixoo_display_text; run pixoo_design_brief with topic "scene" or "dashboard" for layout and palette guidance.
| Name | Required | Description | Default |
|---|---|---|---|
| push | No | Push to device (default: true). | |
| speed | No | Milliseconds per frame for animations (default: 150ms). | |
| frames | No | Number of animation frames (1–40, default: 1). 20 frames at 150ms ≈ 3s loop. | |
| output | No | Absolute, already-normalized path to save the first frame to as a PNG. Replaces the PIXOO_OUTPUT_DIR auto-save for this call, so outputFiles holds only this path. | |
| elements | Yes | Scene elements rendered back-to-front. Up to 50 elements. Each element takes either effect or animate, not both. An element's animate keyframes can drive dx, dy, and opacity (numbers or numeric strings, interpolated), visible (true or false, switching at the midpoint between keyframes), and color on any element with a color field (interpolated through RGB). | |
| background | Yes | Scene background: a solid color string, or an object holding exactly one of gradient or theme. |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| frames | No | Number of frames in the rendered output (1 for static, 2–40 for animations). |
| layout | No | Layout report for each element. |
| notice | No | Warning or informational notice about the render or push. |
| pushed | No | True when the device acknowledged the push. False when push: false or push failed. |
| deviceState | No | Device state after the push. Absent when push: false. |
| outputFiles | No | Absolute paths to saved output files: the output path when set, otherwise the PIXOO_OUTPUT_DIR auto-save (PNG for static, GIF for animations). Absent when neither applies. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare idempotentHint=true and destructiveHint=false. The description adds the back-to-front render order and the image-content-block return, but it omits the most consequential behavioral fact: the schema's push parameter defaults to true, meaning this writes to the physical device. With annotations covering the safety profile, the remaining disclosure is partial, so a 3 fits.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four sentences, front-loaded with purpose before return format and routing. Every sentence carries information, though the ordering note slightly duplicates the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema and annotations present, the description needs to cover routing and side effects. Routing is excellent; the notable gap is not flagging that the default push=true sends the scene to the device, which matters for a tool that also writes output files.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents every parameter, including the elements array's back-to-front ordering. The description's ordering sentence duplicates the schema rather than adding new syntax or constraint detail, so the baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (Compose) and resource (full scene) and enumerates the layered element kinds it accepts (text, icons, widgets, shapes, bitmaps, images, sprites). It explicitly routes text-only work to pixoo_display_text, so an agent can distinguish it from siblings without opening schemas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives explicit alternatives and the conditions that select them: use pixoo_display_text for text-only display, and run pixoo_design_brief with topic "scene" or "dashboard" for layout/palette guidance. Nothing is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Read or change device state: brightness (0–100), screen on/off, channel, or clock face. Call with no params to read current state only. Supply any params to apply changes before reading back state. Use pixoo_discover_devices first if PIXOO_IP is not yet configured.
| Name | Required | Description | Default |
|---|---|---|---|
| screen | No | Turn the display screen on or off. | |
| channel | No | Switch to a channel: faces, cloud, visualizer, or custom. | |
| brightness | No | Set display brightness (0–100). | |
| clockFaceId | No | Select a clock face by ID (channel must be faces). |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| notice | No | Requested settings that failed, each with its failure kind and message (e.g. "brightness:80 failed (network): …"), joined by "; ". Absent when every requested setting applied. |
| applied | No | Settings successfully applied in this call (e.g. "brightness:80", "screen:on"). Empty when called with no params or all changes failed. A requested setting that failed is absent here and reported in a notice instead. |
| channel | No | Current channel name (faces, cloud, visualizer, or custom). Absent when device is unreachable. |
| clockId | No | Current clock face ID (faces channel only). Absent on other channels or when device is unreachable. |
| screenOn | No | True if the screen is on. Absent when device is unreachable. |
| reachable | No | True if device responded to the status read. |
| brightness | No | Current brightness level (0–100). Absent when device is unreachable. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish idempotent and non-destructive behavior, so the description only needs to add extra context. It does so by explaining the read-only vs. apply-then-read behavior, which is not visible in the schema or annotations. It stops short of describing edge cases like invalid parameter combinations, but the output schema and annotations cover the core safety profile.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, each earning its place: the first states scope, the second defines read vs. change behavior, the third gives the prerequisite. Information is front-loaded and there is no filler or repetition of schema content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema, annotations, and full schema parameter descriptions, the description covers everything an agent needs to invoke this tool correctly: what it operates on, how to read vs. change, and when to call the discovery tool first. No critical operational gap remains.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3. The description adds value beyond the schema by defining the no-params read mode and the supply-params-to-apply mode, which is essential for using the parameters correctly. It also reinforces the brightness range and channel/clock face relationship without merely repeating schema text.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states a specific verb ('Read or change') and resource ('device state') and enumerates the exact aspects affected: brightness, screen on/off, channel, clock face. This clearly differentiates it from sibling tools like pixoo_display_text or pixoo_push_image, which handle content rather than device state.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides explicit usage modes: call with no params to read state, supply params to apply changes and read back. It also names the prerequisite alternative, pixoo_discover_devices, for when PIXOO_IP is not configured, giving clear routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Return craft guidance and live device context for a design topic. Covers legibility rules, palette discipline, layout zones, animation budget, and pre-filled next-tool suggestions based on current device state. The orientation tool to run before authoring a scene, dashboard, or animation — or when troubleshooting display issues.
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | Design topic: text (styled text guidance), scene (composition + layout zones), dashboard (widgets + metrics), animation (motion budget + effects), pixel-art (bitmap + sprite guidance), troubleshooting (device + display issues). |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| topic | No | The topic that was requested. |
| craftGuidance | No | Markdown-formatted craft rules: legibility floors, palette discipline, layout zones, and technique guidance specific to the topic. |
| deviceContext | No | Live device state snapshot at the time of the request. |
| iconCategories | No | Built-in icon names grouped by category (weather, arrows, status, media). Use names in pixoo_compose_scene icon elements. |
| availableThemes | No | Available named scene themes (e.g. "midnight", "ember"). Use in background.theme or pixoo_display_text theme param. |
| nextToolSuggestions | No | Suggested next steps based on topic and device state. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only declare readOnlyHint=true, so the description carries the burden of explaining behavior. It adds useful context by mentioning 'live device context' and 'pre-filled next-tool suggestions based on current device state,' clarifying that this is a read-only advisory tool rather than a device-mutating operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences with no filler. The first sentence states the core value and content scope; the second explains the operational context. All information is front-loaded and directly useful to an agent.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter advisory tool with a fully documented schema, an output schema, and a readOnly annotation, the description fully covers what the tool does, what it covers, and when to use it. No critical gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema fully documents the single 'topic' parameter, including an enum of all allowed values and descriptions for each. The description adds little beyond the schema, so baseline 3 is appropriate since the schema already does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a specific verb and resource: 'Return craft guidance and live device context for a design topic.' It also enumerates the covered areas (legibility rules, palette discipline, layout zones, animation budget) and positions itself as an orientation tool versus the sibling action tools, making its role distinct.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states when to run the tool: 'before authoring a scene, dashboard, or animation — or when troubleshooting display issues.' This gives clear context for selection, though it does not explicitly name sibling alternatives or state when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Find Pixoo devices on the local network via Divoom's cloud discovery endpoint (requires internet — queries app.divoom-gz.com). Run once during initial setup to find device IPs; set PIXOO_IP in server configuration to enable all other tools. For ongoing device control use pixoo_control_device.
| Name | Required | Description | Default |
|---|---|---|---|
| timeoutMs | No | Discovery timeout in milliseconds (default: 5000ms). |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| notice | No | Recovery hint when no devices found or IP mismatch. |
| devices | No | Discovered Pixoo devices on the local network. |
| configuredIp | No | Currently configured PIXOO_IP value (absent if not set). |
| configuredIpFound | No | True if PIXOO_IP matches a discovered device; false signals an IP mismatch. Absent when PIXOO_IP is not set. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already establish readOnly and openWorld hints. The description adds value by disclosing the network dependency (requires internet) and the specific external endpoint (app.divoom-gz.com), which are important behavioral traits not captured by annotations. Does not contradict annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three concise sentences, front-loaded with the primary purpose, then the setup context and routing to an alternative. Every sentence earns its place; no filler or redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Moderate-low complexity tool with an output schema, so return values need not be described. The description covers purpose, network prerequisites, and post-condition (set PIXOO_IP). Slightly more could be said about what discovery returns, but the output schema already handles that.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100% with clear description, default, minimum, and maximum for timeoutMs. The narrative description adds nothing about the parameter, but with full schema coverage the baseline of 3 is appropriate since no extra meaning is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb and resource ('Find Pixoo devices on the local network') and identifies the method via Divoom's cloud discovery endpoint. It distinguishes itself from all sibling tools, which are for display, control, or composition, by being the discovery step.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
States explicitly when to use this tool ('Run once during initial setup'), what to do with the result (set PIXOO_IP in server configuration), and names the alternative for ongoing control (pixoo_control_device). This gives an agent complete routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Render styled text (theme, gradient, shadow, outline, auto-fit) onto the Pixoo display and push it, static or animated with a scroll, float, or pulse effect. Returns the render as an image content block for immediate inspection. The primary tool for text-only display — for layers, icons, widgets, or per-element motion use pixoo_compose_scene. Run pixoo_design_brief with topic "text" first for palette and legibility guidance.
| Name | Required | Description | Default |
|---|---|---|---|
| font | No | Font variant, used as given — text too wide for it overflows rather than switching font: standard (5×7) or compact (3×5), each printable ASCII plus ° ← ↑ → ↓ ▲ ▼ ♥ · …; or numerals (11×18 digits for clocks and readouts), which draws only 0–9, space, and : . - + / % ° ?, so text holding any other character is rejected. Omitted, single-line text tries standard and falls back to compact when standard overflows; multi-line text uses standard. | |
| push | No | Push the rendered frame to the device (default: true). | |
| text | Yes | Text to display. String or array of lines. | |
| align | No | Multi-line text: align every line within the widest line, then place that block with position.x. Omit to place each line by position.x on its own. | |
| style | No | Text style: palette, shadow, outline, scale. | |
| theme | No | Named scene theme — sets background gradient and default text palette. | |
| effect | No | Animation effect. scroll runs the text across the display once, in up to 40 frames; auto scrolls only when the text is too wide to fit; float (gentle bob) and pulse (breathing brightness) loop over 20 frames. An animated result is pushed as an animation and previewed as a grid of its frames. none or omitted renders one static frame. | |
| position | No | Text position on the display. | |
| background | No | Background color or gradient. Overrides theme background when set. | |
| brightness | No | Set device brightness before push (0–100). Failure is a warning, not an error. |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| frames | No | Number of frames rendered: 1 for static text, 2–40 when an effect animates it. |
| layout | No | Layout report: every fit decision the renderer made. |
| notice | No | Warning or informational message about the render or push. |
| pushed | No | True when the device acknowledged the push. |
| deviceState | No | Device state after the push. Absent when push: false. |
| outputFiles | No | Absolute paths to saved preview files (PNG, or GIF when an effect animates the text). Present only when PIXOO_OUTPUT_DIR is configured. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare idempotentHint and destructiveHint=false, so safety is covered. The description adds genuinely useful behavior beyond that: the return is an image content block for inspection, and an animated result is pushed as an animation and previewed as a grid of frames. It does not discuss failure modes or device-auth requirements, keeping it short of a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three tightly packed sentences, each earning its place: capability, return/push behavior, sibling routing plus prerequisite. Front-loaded with the core action and no filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With an output schema present, the description needn't explain return values, yet it still notes the image-block preview. Annotations, a 100%-covered schema, and sibling routing together leave nothing an agent needs to call this correctly missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the parameters are richly documented in the schema (font fallback rules, effect frame counts, palette stops, position semantics). The description only gestures at the feature set ('theme, gradient, shadow, outline, auto-fit') without adding syntax or defaults beyond the schema, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb+resource ('Render styled text ... onto the Pixoo display and push it') and enumerates the styling and motion capabilities, so an agent immediately knows this is the text-rendering tool rather than a scene composer or overlay tool.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly routes away from siblings ('for layers, icons, widgets, or per-element motion use pixoo_compose_scene') and gives a prerequisite ('Run pixoo_design_brief with topic "text" first for palette and legibility guidance'). The only minor omission is distinguishing from pixoo_overlay_text, but the primary routing is explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Set or clear a device-native scrolling text overlay. Use mode "set" to add or update an overlay on a slot (0–19); use mode "clear" to remove it. Overlays use device-rendered fonts (115 font IDs, 0–114) and persist across channel switches until explicitly cleared with mode "clear". Not previewable — rendering happens on-device. Best for persistent tickers over pushed scenes; for styled, previewable text use pixoo_display_text instead.
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | X start position, 0 to display size − 1 (63 on a 64px display; default: 0). | |
| y | No | Y start position, 0 to display size − 1 (63 on a 64px display; default: 0). | |
| id | Yes | Overlay slot ID (0–19). Each ID is an independent overlay layer. | |
| font | No | Device font ID (0–114). 0 = default, 18 = arrows, 20 = °C/°F. Device-rendered; no preview. | |
| mode | Yes | set = add/update overlay; clear = remove it. | |
| text | No | Text to display (required for mode=set). | |
| align | No | Text alignment (default: left). | left |
| color | No | Text color: hex (#RRGGBB or #RGB) or a named color such as orange (default: white). | #ffffff |
| speed | No | Scroll speed (0–100, device units; default: 50). | |
| width | No | Text region width in pixels, 0 to display size (64 on a 64px display; defaults to display width). | |
| direction | No | Scroll direction (default: left). | left |
| Name | Required | Description |
|---|---|---|
| id | No | The overlay slot ID (0–19) that was operated on. |
| mode | No | Operation performed: "set" (overlay added/updated) or "clear" (overlay removed). |
| error | No | Present when the call failed. Absent on success. |
| acknowledged | No | True when the device confirmed the overlay command (error_code: 0). |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Adds valuable behavioral context beyond the annotations: overlays persist across channel switches, are device-rendered, and are not previewable. The description also makes clear that removal happens via mode 'clear'. No contradiction with the idempotentHint or destructiveHint annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three focused sentences front-load the core operation, then add persistence and preview constraints, and close with a routing pointer. Every sentence earns its place without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a complex 11-parameter tool with a full output schema and complete property descriptions, the description covers the essential behavioral and routing information. The combination of description, schema, and annotations leaves no critical gap for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds meaning by explaining the mode enum ('set' = add/update, 'clear' = remove) and the slot persistence semantics. It doesn't elaborate on x/y/speed/etc., but the schema already covers those with defaults and ranges.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Set or clear') and a specific resource ('device-native scrolling text overlay'), plus the slot range. It clearly distinguishes itself from pixoo_display_text, so an agent can tell them apart without opening the schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says this is 'best for persistent tickers over pushed scenes' and names the alternative for styled/previewable text ('use pixoo_display_text instead'). It also explains when to use mode 'set' vs 'clear', giving the agent clear routing guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Load an image (absolute local path or https URL), resize it to fit the LED grid, and optionally push it to the display. An animated GIF or WebP pushes as an animation of up to 40 frames, sampled evenly from a longer source and played at the speed that keeps its loop length. Returns the downsampled result as an image content block so you see exactly what the display received — a grid of every frame for an animation. Nearest-neighbor kernel preserves pixel art; use lanczos3 or mitchell for photos. finish reduces the result to a small or fixed palette, optionally dithered.
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | Resize fit mode: contain (letterbox), cover (crop to fill), fill (stretch). | contain |
| push | No | Push the resized image to the device (default: true). | |
| speed | No | Milliseconds per frame for an animated source (10–2000). Default: the source's total duration over the pushed frame count, or 150 when it records no delays. A still ignores it. | |
| finish | No | Reduce the image to a palette before it reaches the panel: exactly one of colors (2–256, built from the image) or palette (1–256 hex or named colors), plus dither. Transparent pixels stay unlit and are not counted. The preview shows the finished frame. | |
| kernel | No | Resize kernel: nearest for pixel art, lanczos3 for photos, mitchell for a balance. | nearest |
| source | Yes | Absolute local file path or https (not http) URL of the image to display; a relative path is rejected. An animated GIF or WebP, whatever its file name, pushes as an animation. |
| Name | Required | Description |
|---|---|---|
| error | No | Present when the call failed. Absent on success. |
| speed | No | Milliseconds per frame the animation plays at. Absent for a still. |
| frames | No | Frames rendered and pushed: 1 for a still, 2–40 for an animation. |
| notice | No | Warning or informational message. |
| pushed | No | True when the device acknowledged the push. |
| deviceState | No | Device state after the push. Absent when push: false. |
| outputFiles | No | Absolute paths to saved preview files: a PNG for a still, a GIF at the pushed speed for an animation. Present only when PIXOO_OUTPUT_DIR is configured. |
| sourceFrames | No | Frames in the source before sampling down to 40: 1 for a still. |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations only cover openWorldHint/idempotentHint/destructiveHint=false; the description adds substantial behavior: GIF/WebP animation handling up to 40 frames with even sampling, loop-length-preserving speed, the returned downsampled preview content block (grid of frames for animations), and palette/dither effects. That is rich context beyond structured fields.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Four sentences, front-loaded with the core action and source forms, then progressively adding animation, return, kernel and finish details. Dense and mostly waste-free, though somewhat long for a definition whose schema already carries much of the detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 6 parameters, full schema coverage, nested anyOf finish, and an output schema, the description still covers the hard-to-infer parts: animation frame sampling and speed defaults, preview return shape, and palette-dither tradeoffs. Nothing an agent needs to invoke it correctly appears missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so every parameter (fit, push, speed, finish, kernel, source) is already documented with enums, ranges and defaults. The description mostly restates the same facts (kernel choice, finish semantics) rather than adding syntax or format detail the schema lacks, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States specific verbs and resource: load an image, resize to the LED grid, optionally push, with the accepted source forms (absolute path or https URL). It is clearly distinguishable from siblings like pixoo_display_text or pixoo_compose_scene, which do not take image sources.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives implied usage guidance embedded in behavioral notes ('nearest-neighbor kernel preserves pixel art; use lanczos3 or mitchell for photos'), which helps pick the kernel. However it never states when to use this tool versus alternatives like pixoo_compose_scene or pixoo_overlay_text, nor any prerequisites beyond the push default.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v1.3.0pixoo_compose_scene12 fields changedInput schema / properties / background / anyOfPrevious value: -[
- {
- "description": "Solid CSS hex color.",
- "type": "string"
- },
- {
- "description": "Gradient background: specify type and two colors.",
- "properties": {
- "gradient": {
- "description": "Gradient background.",
- "properties": {
- "from": {
- "description": "Gradient start color.",
- "type": "string"
- },
- "to": {
- "description": "Gradient end color.",
- "type": "string"
- },
- "type": {
- "description": "v = vertical, h = horizontal, r = radial.",
- "enum": [
- "v",
- "h",
- "r"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "from",
- "to"
- ],
- "type": "object"
- }
- },
- "required": [
- "gradient"
- ],
- "type": "object"
- },
- {
- "description": "Named theme background: uses the theme's preset gradient.",
- "properties": {
- "theme": {
- "description": "Named theme.",
- "enum": [
- "midnight",
- "ember",
- "claude",
- "ice",
- "neon",
- "forest",
- "mono"
- ],
- "type": "string"
- }
- },
- "required": [
- "theme"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "description": "Solid CSS hex color.",
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Gradient or named-theme background: set exactly one of gradient or theme.",
+ "properties": {
+ "gradient": {
+ "additionalProperties": false,
+ "description": "Gradient background: type and two colors.",
+ "properties": {
+ "from": {
+ "description": "Gradient start color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "Gradient end color.",
+ "type": "string"
+ },
+ "type": {
+ "description": "v = vertical, h = horizontal, r = radial.",
+ "enum": [
+ "v",
+ "h",
+ "r"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "from",
+ "to"
+ ],
+ "type": "object"
+ },
+ "theme": {
+ "description": "Named theme: uses the theme's preset background.",
+ "enum": [
+ "midnight",
+ "ember",
+ "claude",
+ "ice",
+ "neon",
+ "forest",
+ "mono"
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+]Input schema / properties / background / descriptionPrevious value: -"Scene background: solid color, gradient, or named theme."New value: +"Scene background: a solid color string, or an object holding exactly one of gradient or theme."Input schema / properties / elements / descriptionPrevious value: -"Scene elements rendered back-to-front. Up to 50 elements."New value: +"Scene elements rendered back-to-front. Up to 50 elements. Each element takes either effect or animate, not both. An element's animate keyframes can drive dx, dy, and opacity (numbers or numeric strings, interpolated), visible (true or false, switching at the midpoint between keyframes), and color on any element with a color field (interpolated through RGB)."Input schema / properties / elements / items / oneOfPrevious value: -[
- {
- "description": "Styled text element rendered at a position.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Flat text color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "font": {
- "description": "Font variant.",
- "enum": [
- "standard",
- "compact"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "style": {
- "description": "Text style options.",
- "properties": {
- "color": {
- "description": "Flat color override.",
- "type": "string"
- },
- "outline": {
- "description": "1px outline.",
- "type": "boolean"
- },
- "palette": {
- "anyOf": [
- {
- "description": "Named built-in color palette for the vertical ramp.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- {
- "description": "Custom gradient stop: specify top and bottom colors directly.",
- "properties": {
- "from": {
- "description": "Top color.",
- "type": "string"
- },
- "to": {
- "description": "Bottom color.",
- "type": "string"
- }
- },
- "required": [
- "from",
- "to"
- ],
- "type": "object"
- }
- ],
- "description": "Palette name or custom gradient stop for vertical color ramp."
- },
- "scale": {
- "description": "Integer pixel scale multiplier.",
- "maximum": 8,
- "minimum": 1,
- "type": "integer"
- },
- "shadow": {
- "description": "Drop shadow.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "text": {
- "description": "Text content to render.",
- "type": "string"
- },
- "type": {
- "const": "text",
- "description": "Text element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: 0)."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position (default: 0)."
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "description": "Built-in or custom SVG icon element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Icon fill color.",
- "type": "string"
- },
- "d": {
- "description": "Custom SVG path d attribute.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Render height in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "name": {
- "description": "Built-in icon name (see pixoo://reference/icons).",
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for colored icon.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "type": {
- "const": "icon",
- "description": "Icon element type.",
- "type": "string"
- },
- "viewBox": {
- "description": "SVG viewBox string (default: \"0 0 16 16\").",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Render width in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position."
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "description": "Filled or gradient rectangle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "borderColor": {
- "description": "1px border color.",
- "type": "string"
- },
- "color": {
- "description": "Fill color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "gradient": {
- "description": "Gradient fill.",
- "properties": {
- "from": {
- "description": "Start color.",
- "type": "string"
- },
- "to": {
- "description": "End color.",
- "type": "string"
- },
- "type": {
- "description": "v = vertical, h = horizontal.",
- "enum": [
- "v",
- "h"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "from",
- "to"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "rect",
- "description": "Rectangle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h"
- ],
- "type": "object"
- },
- {
- "description": "Filled or outline circle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Circle color.",
- "type": "string"
- },
- "cx": {
- "description": "Center X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "cy": {
- "description": "Center Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fill": {
- "description": "Filled or outline only (default: true).",
- "type": "boolean"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "radius": {
- "description": "Radius in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "circle",
- "description": "Circle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "cx",
- "cy",
- "radius"
- ],
- "type": "object"
- },
- {
- "description": "Single-pixel line element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "line",
- "description": "Line element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x0": {
- "description": "Start X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x1": {
- "description": "End X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y0": {
- "description": "Start Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y1": {
- "description": "End Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x0",
- "y0",
- "x1",
- "y1"
- ],
- "type": "object"
- },
- {
- "description": "Horizontal progress bar widget.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "label": {
- "description": "Optional label rendered on the bar.",
- "type": "string"
- },
- "max": {
- "description": "Maximum value.",
- "type": "number"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for gradient fill.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "trackColor": {
- "description": "Background track color.",
- "type": "string"
- },
- "type": {
- "const": "progress",
- "description": "Progress bar widget type.",
- "type": "string"
- },
- "value": {
- "description": "Current value.",
- "type": "number"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "value",
- "max"
- ],
- "type": "object"
- },
- {
- "description": "Sparkline chart widget (line or bar).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line or bar color.",
- "type": "string"
- },
- "data": {
- "description": "Data points for the chart.",
- "items": {
- "type": "number"
- },
- "minItems": 2,
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "kind": {
- "description": "Chart style (default: line).",
- "enum": [
- "line",
- "bar"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "sparkline",
- "description": "Sparkline chart widget type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "Bitmap element using explicit palette indices.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Color palette: array of hex colors indexed 0-F.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "rows": {
- "description": "Row strings of hex palette indices (0-F, space = transparent).",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "type": {
- "const": "bitmap",
- "description": "Bitmap element using palette indices.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "rows",
- "palette"
- ],
- "type": "object"
- },
- {
- "description": "Sparse scatter of individually colored pixels.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "data": {
- "description": "Array of pixel positions and colors.",
- "items": {
- "description": "A single pixel: position and color.",
- "properties": {
- "color": {
- "description": "Pixel color.",
- "type": "string"
- },
- "x": {
- "description": "Pixel X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Pixel Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "x",
- "y",
- "color"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "pixels",
- "description": "Sparse pixel dots element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "External image element (local path or https URL).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fit": {
- "description": "Resize fit mode (default: contain).",
- "enum": [
- "contain",
- "cover",
- "fill"
- ],
- "type": "string"
- },
- "h": {
- "description": "Target height (default: canvas height).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "kernel": {
- "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
- "enum": [
- "nearest",
- "lanczos3",
- "mitchell"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "source": {
- "description": "Absolute local file path or https (not http) URL.",
- "type": "string"
- },
- "type": {
- "const": "image",
- "description": "Image element (local path or https URL).",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Target width (default: canvas width).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "description": "X offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "source"
- ],
- "type": "object"
- },
- {
- "description": "Sprite sheet element for character or tile art.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": false,
- "maxItems": 2,
- "minItems": 2,
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "description": "Value at this frame.",
- "type": [
- "number",
- "string",
- "boolean"
- ]
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "bodyColor": {
- "description": "Override body color.",
- "type": "string"
- },
- "cols": {
- "description": "Number of columns in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "darkColor": {
- "description": "Override dark/eye color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Absolute local path to the sprite sheet image.",
- "type": "string"
- },
- "rows": {
- "description": "Number of rows in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "scale": {
- "description": "Pixel scale factor.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "sprite",
- "description": "Sprite sheet element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: center)."
- },
- "y": {
- "description": "Y position (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "path",
- "cols",
- "rows"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "description": "Styled text element rendered at a position.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "color": {
+ "description": "Flat text color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "font": {
+ "description": "Font variant (default: standard): standard (5×7) or compact (3×5), each printable ASCII plus ° ← ↑ → ↓ ▲ ▼ ♥ · …; or numerals (11×18 digits for clocks and readouts), which draws only 0–9, space, and : . - + / % ° ?, so text holding any other character is rejected — put units and labels in a separate standard or compact text element.",
+ "enum": [
+ "standard",
+ "compact",
+ "numerals"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "style": {
+ "additionalProperties": false,
+ "description": "Text style options.",
+ "properties": {
+ "color": {
+ "description": "Flat color override.",
+ "type": "string"
+ },
+ "outline": {
+ "description": "1px outline.",
+ "type": "boolean"
+ },
+ "palette": {
+ "anyOf": [
+ {
+ "description": "Named built-in color palette for the vertical ramp.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Custom gradient stop: specify top and bottom colors directly.",
+ "properties": {
+ "from": {
+ "description": "Top color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "Bottom color.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "from",
+ "to"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "Palette name or custom gradient stop for vertical color ramp."
+ },
+ "scale": {
+ "description": "Integer pixel scale multiplier.",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "shadow": {
+ "description": "Drop shadow.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "text": {
+ "description": "Text content to render.",
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "description": "Text element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: 0)."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position (default: 0)."
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Built-in or custom SVG icon element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "color": {
+ "description": "Icon color (default: white).",
+ "type": "string"
+ },
+ "d": {
+ "description": "Custom SVG path d attribute.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Render height in pixels (default: 12).",
+ "maximum": 256,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "name": {
+ "description": "Built-in icon name (see pixoo://reference/icons).",
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette painted as a top-to-bottom color ramp from the icon's top row to its bottom row. Takes precedence over color.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "icon",
+ "description": "Icon element type.",
+ "type": "string"
+ },
+ "viewBox": {
+ "description": "SVG viewBox string (default: \"0 0 16 16\").",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Render width in pixels (default: 12).",
+ "maximum": 256,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Filled, gradient, or bordered rectangle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "borderColor": {
+ "description": "Border color. The border is drawn inside the rect, strokeWidth pixels thick.",
+ "type": "string"
+ },
+ "color": {
+ "description": "Fill color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "gradient": {
+ "additionalProperties": false,
+ "description": "Gradient fill.",
+ "properties": {
+ "from": {
+ "description": "Start color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "End color.",
+ "type": "string"
+ },
+ "type": {
+ "description": "v = vertical, h = horizontal.",
+ "enum": [
+ "v",
+ "h"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "from",
+ "to"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "strokeWidth": {
+ "description": "Border thickness in whole pixels, growing inward from the rect edge (default: 1). Requires borderColor.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "rect",
+ "description": "Rectangle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Filled or outline circle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "antialias": {
+ "description": "Shade each outline pixel by how much of it the ring covers, for a smooth curve (default: false, hard pixel edges). Outline circles only (fill: false).",
+ "type": "boolean"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "color": {
+ "description": "Circle color.",
+ "type": "string"
+ },
+ "cx": {
+ "description": "Center X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "cy": {
+ "description": "Center Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "fill": {
+ "description": "Filled or outline only (default: true).",
+ "type": "boolean"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "radius": {
+ "description": "Radius in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "strokeWidth": {
+ "description": "Outline thickness in whole pixels, centered on the circle (default: 1). Outline circles only (fill: false).",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "circle",
+ "description": "Circle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "cx",
+ "cy",
+ "radius"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Straight line element, 1px wide unless strokeWidth is set.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "antialias": {
+ "description": "Shade each pixel by how much of it the line covers, for smooth diagonals (default: false, hard pixel edges).",
+ "type": "boolean"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "color": {
+ "description": "Line color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "strokeWidth": {
+ "description": "Line thickness in whole pixels, centered on the line (default: 1).",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "line",
+ "description": "Line element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x0": {
+ "description": "Start X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x1": {
+ "description": "End X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y0": {
+ "description": "Start Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y1": {
+ "description": "End Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x0",
+ "y0",
+ "x1",
+ "y1"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Horizontal progress bar widget.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element (no color track). Set either effect or animate, not both.",
+ "properties": {
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "label": {
+ "description": "Optional label rendered on the bar.",
+ "type": "string"
+ },
+ "max": {
+ "description": "Maximum value.",
+ "type": "number"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette for gradient fill.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "trackColor": {
+ "description": "Background track color.",
+ "type": "string"
+ },
+ "type": {
+ "const": "progress",
+ "description": "Progress bar widget type.",
+ "type": "string"
+ },
+ "value": {
+ "description": "Current value.",
+ "type": "number"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "value",
+ "max"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Sparkline chart widget (line or bar).",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "color": {
+ "description": "Line or bar color.",
+ "type": "string"
+ },
+ "data": {
+ "description": "Data points for the chart.",
+ "items": {
+ "type": "number"
+ },
+ "minItems": 2,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "kind": {
+ "description": "Chart style (default: line).",
+ "enum": [
+ "line",
+ "bar"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sparkline",
+ "description": "Sparkline chart widget type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Bitmap element using explicit palette indices.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element (no color track). Set either effect or animate, not both.",
+ "properties": {
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Color palette: array of hex colors indexed 0-F.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "description": "Row strings of hex palette indices (0-F, space = transparent).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "const": "bitmap",
+ "description": "Bitmap element using palette indices.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "rows",
+ "palette"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Sparse scatter of individually colored pixels.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element. Set either effect or animate, not both.",
+ "properties": {
+ "color": {
+ "description": "Color keyframes (hex or named), interpolated through RGB; each frame's value stands in for the element's color (on pixels, every point's color).",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Color at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "data": {
+ "description": "Array of pixel positions and colors.",
+ "items": {
+ "additionalProperties": false,
+ "description": "A single pixel: position and color.",
+ "properties": {
+ "color": {
+ "description": "Pixel color.",
+ "type": "string"
+ },
+ "x": {
+ "description": "Pixel X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Pixel Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "x",
+ "y",
+ "color"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "pixels",
+ "description": "Sparse pixel dots element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "External image element (absolute local path or https URL).",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element (no color track). Set either effect or animate, not both.",
+ "properties": {
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "finish": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "description": "Reduce to a palette built from the image.",
+ "properties": {
+ "colors": {
+ "description": "Build a palette of at most this many colors (2–256) from the image itself.",
+ "maximum": 256,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "dither": {
+ "default": "none",
+ "description": "How palette colors are placed: none maps each pixel to its nearest color; bayer4 mixes the two nearest in an ordered 4×4 pattern; floyd-steinberg diffuses the difference to neighboring pixels, smoothest on photos.",
+ "enum": [
+ "none",
+ "bayer4",
+ "floyd-steinberg"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "colors"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reduce to a fixed palette.",
+ "properties": {
+ "dither": {
+ "default": "none",
+ "description": "How palette colors are placed: none maps each pixel to its nearest color; bayer4 mixes the two nearest in an ordered 4×4 pattern; floyd-steinberg diffuses the difference to neighboring pixels, smoothest on photos.",
+ "enum": [
+ "none",
+ "bayer4",
+ "floyd-steinberg"
+ ],
+ "type": "string"
+ },
+ "palette": {
+ "description": "Map every pixel to these colors (1–256 entries).",
+ "items": {
+ "description": "Hex color (#RRGGBB or #RGB) or a named color.",
+ "type": "string"
+ },
+ "maxItems": 256,
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "palette"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "Reduce the image to a palette before it reaches the panel: exactly one of colors (2–256, built from the image) or palette (1–256 hex or named colors), plus dither. Transparent pixels stay unlit and are not counted. The preview shows the finished frame."
+ },
+ "fit": {
+ "description": "Resize fit mode (default: contain).",
+ "enum": [
+ "contain",
+ "cover",
+ "fill"
+ ],
+ "type": "string"
+ },
+ "h": {
+ "description": "Target height (default: canvas height).",
+ "maximum": 256,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "kernel": {
+ "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
+ "enum": [
+ "nearest",
+ "lanczos3",
+ "mitchell"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "source": {
+ "description": "Absolute local file path or https (not http) URL; a relative path is rejected.",
+ "type": "string"
+ },
+ "type": {
+ "const": "image",
+ "description": "Image element (absolute local path or https URL).",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Target width (default: canvas width).",
+ "maximum": 256,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Sprite sheet element for character or tile art.",
+ "properties": {
+ "animate": {
+ "additionalProperties": false,
+ "description": "Raw keyframe animation map for this element (no color track). Set either effect or animate, not both.",
+ "properties": {
+ "dx": {
+ "description": "X offset keyframes in pixels, added to dx and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "dy": {
+ "description": "Y offset keyframes in pixels, added to dy and interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "opacity": {
+ "description": "Opacity keyframes 0–100, interpolated between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame: a number, or a numeric string such as \"40\" read as that number.",
+ "type": [
+ "number",
+ "string"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ },
+ "visible": {
+ "description": "Visibility keyframes: true or false, switching at the midpoint between keyframes.",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Whether the element shows at this frame.",
+ "type": "boolean"
+ }
+ ],
+ "type": "array"
+ },
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "blend": {
+ "description": "How the element combines with what lies beneath it (default: normal, drawn over it). add sums the light of both, clamped at full brightness — for glows and light beams; screen brightens more gently; multiply darkens.",
+ "enum": [
+ "normal",
+ "add",
+ "screen",
+ "multiply"
+ ],
+ "type": "string"
+ },
+ "bodyColor": {
+ "description": "Override body color.",
+ "type": "string"
+ },
+ "cols": {
+ "description": "Number of columns in the sprite grid.",
+ "maximum": 64,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "darkColor": {
+ "description": "Override dark/eye color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "additionalProperties": false,
+ "description": "Named animation preset for this element. Set either effect or animate, not both.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity. float, scroll-left, scroll-right, drift: movement in pixels (default 2). pulse, twinkle: 0–1 depth of the opacity dip below 100 (default 0.5 and 0.6). Other effects ignore it.",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "path": {
+ "description": "Absolute local path to the sprite sheet image; a relative path is rejected.",
+ "type": "string"
+ },
+ "rows": {
+ "description": "Number of rows in the sprite grid.",
+ "maximum": 64,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "scale": {
+ "description": "Pixel scale factor: each sprite cell renders as a scale × scale block.",
+ "maximum": 64,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sprite",
+ "description": "Sprite sheet element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: center)."
+ },
+ "y": {
+ "description": "Y position (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "path",
+ "cols",
+ "rows"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set and push was requested. `asset_not_found`: An image or sprite path could not be read. `invalid_color`: A color value could not be resolved. `unknown_icon`: Icon name not found in the registry. `invalid_output_path`: The output path is relative or contains traversal segments. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set and push was requested. `asset_not_found`: An image source or sprite path could not be read, a sprite path was a URL, or an image URL could not be fetched. `invalid_image`: An image source or sprite path was read but did not decode as an image. `invalid_color`: A color value could not be resolved. `unknown_icon`: Icon name not found in the registry. `invalid_output_path`: The output path is relative or contains traversal segments. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_http_error",
- "device_rejected",
- "no_device_configured",
- "asset_not_found",
- "invalid_color",
- "unknown_icon",
- "invalid_output_path"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found",
+ "invalid_image",
+ "invalid_color",
+ "unknown_icon",
+ "invalid_output_path"
+]Output schema / properties / layout / items / properties / action / descriptionPrevious value: -"Overflow action taken by the renderer."New value: +"Always none: scene elements are placed as given and never refit, shrunk, or scrolled. Read fits to learn whether an element runs off the panel."Output schema / properties / layout / items / properties / action / enumPrevious value: -[
- "none",
- "shrunk-to-compact",
- "scrolling",
- "wrapped",
- "truncated",
- "clipped"
-]New value: +[
+ "none"
+]Output schema / properties / layout / items / properties / element / anyOfRemoved value: -[
- {
- "description": "Zero-based index of the element in the input array.",
- "type": "number"
- },
- {
- "const": "background",
- "type": "string"
- }
-]Output schema / properties / layout / items / properties / element / descriptionPrevious value: -"Element index or \"background\" for the background layer."New value: +"Zero-based index of the element in the input array."Output schema / properties / layout / items / properties / element / typeAdded value: +"number"Output schema / properties / layout / items / properties / font / enumPrevious value: -[
- "standard",
- "compact"
-]New value: +[
+ "standard",
+ "compact",
+ "numerals"
+]pixoo_display_text12 fields changedInput schema / properties / background / anyOfPrevious value: -[
- {
- "description": "Solid CSS hex color.",
- "type": "string"
- },
- {
- "description": "Gradient background object.",
- "properties": {
- "gradient": {
- "description": "Gradient background specification.",
- "properties": {
- "from": {
- "description": "Gradient start color.",
- "type": "string"
- },
- "to": {
- "description": "Gradient end color.",
- "type": "string"
- },
- "type": {
- "description": "v = vertical, h = horizontal.",
- "enum": [
- "v",
- "h"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "from",
- "to"
- ],
- "type": "object"
- }
- },
- "required": [
- "gradient"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "description": "Solid CSS hex color.",
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Gradient background object.",
+ "properties": {
+ "gradient": {
+ "additionalProperties": false,
+ "description": "Gradient background specification.",
+ "properties": {
+ "from": {
+ "description": "Gradient start color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "Gradient end color.",
+ "type": "string"
+ },
+ "type": {
+ "description": "v = vertical, h = horizontal.",
+ "enum": [
+ "v",
+ "h"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "from",
+ "to"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "gradient"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / font / descriptionPrevious value: -"Font variant: standard (5×7) or compact (3×5), used as given — text too wide for it overflows rather than switching font. Omitted, single-line text tries standard and falls back to compact when standard overflows; multi-line text uses standard."New value: +"Font variant, used as given — text too wide for it overflows rather than switching font: standard (5×7) or compact (3×5), each printable ASCII plus ° ← ↑ → ↓ ▲ ▼ ♥ · …; or numerals (11×18 digits for clocks and readouts), which draws only 0–9, space, and : . - + / % ° ?, so text holding any other character is rejected. Omitted, single-line text tries standard and falls back to compact when standard overflows; multi-line text uses standard."Input schema / properties / font / enumPrevious value: -[
- "standard",
- "compact"
-]New value: +[
+ "standard",
+ "compact",
+ "numerals"
+]Input schema / properties / position / additionalPropertiesAdded value: +falseInput schema / properties / style / additionalPropertiesAdded value: +falseInput schema / properties / style / properties / palette / anyOfPrevious value: -[
- {
- "description": "Named built-in color palette for the vertical ramp.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- {
- "description": "Custom gradient stop: specify top and bottom colors directly.",
- "properties": {
- "from": {
- "description": "Gradient start color (top).",
- "type": "string"
- },
- "to": {
- "description": "Gradient end color (bottom).",
- "type": "string"
- }
- },
- "required": [
- "from",
- "to"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "description": "Named built-in color palette for the vertical ramp.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Custom gradient stop: specify top and bottom colors directly.",
+ "properties": {
+ "from": {
+ "description": "Gradient start color (top).",
+ "type": "string"
+ },
+ "to": {
+ "description": "Gradient end color (bottom).",
+ "type": "string"
+ }
+ },
+ "required": [
+ "from",
+ "to"
+ ],
+ "type": "object"
+ }
+]Output schema / properties / layout / items / properties / action / descriptionPrevious value: -"Overflow action taken by the renderer."New value: +"What the renderer did about the width: shrunk-to-compact when single-line text fits only in the compact font; scrolling when the returned frames scroll (effect scroll, or auto on text too wide to fit); none otherwise. A line too wide for the panel that does not scroll reports none with fits false, drawn from x 0 and cut at the right edge."Output schema / properties / layout / items / properties / action / enumPrevious value: -[
- "none",
- "shrunk-to-compact",
- "scrolling",
- "wrapped",
- "truncated",
- "clipped"
-]New value: +[
+ "none",
+ "shrunk-to-compact",
+ "scrolling"
+]Output schema / properties / layout / items / properties / element / anyOfRemoved value: -[
- {
- "description": "Zero-based index of the element in the input array.",
- "type": "number"
- },
- {
- "const": "background",
- "type": "string"
- }
-]Output schema / properties / layout / items / properties / element / descriptionPrevious value: -"Element index or \"background\" for the background layer."New value: +"Zero-based line index: 0 for single-line text, the line position for an array."Output schema / properties / layout / items / properties / element / typeAdded value: +"number"Output schema / properties / layout / items / properties / font / enumPrevious value: -[
- "standard",
- "compact"
-]New value: +[
+ "standard",
+ "compact",
+ "numerals"
+]pixoo_push_image10 fields changedInput schema / properties / finishAdded value: +{
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "description": "Reduce to a palette built from the image.",
+ "properties": {
+ "colors": {
+ "description": "Build a palette of at most this many colors (2–256) from the image itself.",
+ "maximum": 256,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "dither": {
+ "default": "none",
+ "description": "How palette colors are placed: none maps each pixel to its nearest color; bayer4 mixes the two nearest in an ordered 4×4 pattern; floyd-steinberg diffuses the difference to neighboring pixels, smoothest on photos.",
+ "enum": [
+ "none",
+ "bayer4",
+ "floyd-steinberg"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "colors"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reduce to a fixed palette.",
+ "properties": {
+ "dither": {
+ "default": "none",
+ "description": "How palette colors are placed: none maps each pixel to its nearest color; bayer4 mixes the two nearest in an ordered 4×4 pattern; floyd-steinberg diffuses the difference to neighboring pixels, smoothest on photos.",
+ "enum": [
+ "none",
+ "bayer4",
+ "floyd-steinberg"
+ ],
+ "type": "string"
+ },
+ "palette": {
+ "description": "Map every pixel to these colors (1–256 entries).",
+ "items": {
+ "description": "Hex color (#RRGGBB or #RGB) or a named color.",
+ "type": "string"
+ },
+ "maxItems": 256,
+ "minItems": 1,
+ "type": "array"
+ }
+ },
+ "required": [
+ "palette"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "Reduce the image to a palette before it reaches the panel: exactly one of colors (2–256, built from the image) or palette (1–256 hex or named colors), plus dither. Transparent pixels stay unlit and are not counted. The preview shows the finished frame."
+}Input schema / properties / source / descriptionPrevious value: -"Absolute local file path or https (not http) URL of the image to display."New value: +"Absolute local file path or https (not http) URL of the image to display; a relative path is rejected. An animated GIF or WebP, whatever its file name, pushes as an animation."Input schema / properties / speedAdded value: +{
+ "description": "Milliseconds per frame for an animated source (10–2000). Default: the source's total duration over the pushed frame count, or 150 when it records no delays. A still ignores it.",
+ "maximum": 2000,
+ "minimum": 10,
+ "type": "integer"
+}Output schema / anyOfPrevious value: -[
- {
- "not": {
- "required": [
- "error"
- ]
- },
- "required": [
- "pushed"
- ]
- },
- {
- "required": [
- "error"
- ]
- }
-]New value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "pushed",
+ "frames",
+ "sourceFrames"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `asset_not_found`: Image path or URL could not be read. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `asset_not_found`: Image path or URL could not be read. `invalid_image`: The source was read but did not decode as an image. `invalid_color`: A finish palette entry could not be resolved to a color. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_http_error",
- "device_rejected",
- "no_device_configured",
- "asset_not_found"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found",
+ "invalid_image",
+ "invalid_color"
+]Output schema / properties / framesAdded value: +{
+ "description": "Frames rendered and pushed: 1 for a still, 2–40 for an animation.",
+ "type": "number"
+}Output schema / properties / outputFiles / descriptionPrevious value: -"Absolute paths to saved PNG preview files. Present only when PIXOO_OUTPUT_DIR is configured."New value: +"Absolute paths to saved preview files: a PNG for a still, a GIF at the pushed speed for an animation. Present only when PIXOO_OUTPUT_DIR is configured."Output schema / properties / sourceFramesAdded value: +{
+ "description": "Frames in the source before sampling down to 40: 1 for a still.",
+ "type": "number"
+}Output schema / properties / speedAdded value: +{
+ "description": "Milliseconds per frame the animation plays at. Absent for a still.",
+ "type": "number"
+}v1.2.0pixoo_compose_scene4 fields changedInput schema / properties / output / descriptionPrevious value: -"Absolute, already-normalized path to save the first frame to, in addition to the PIXOO_OUTPUT_DIR auto-save when that is configured. Both paths are reported in outputFiles."New value: +"Absolute, already-normalized path to save the first frame to as a PNG. Replaces the PIXOO_OUTPUT_DIR auto-save for this call, so outputFiles holds only this path."Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set and push was requested. `asset_not_found`: An image or sprite path could not be read. `invalid_color`: A color value could not be resolved. `unknown_icon`: Icon name not found in the registry. `invalid_output_path`: The output path is relative or contains traversal segments. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set and push was requested. `asset_not_found`: An image or sprite path could not be read. `invalid_color`: A color value could not be resolved. `unknown_icon`: Icon name not found in the registry. `invalid_output_path`: The output path is relative or contains traversal segments. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_rejected",
- "no_device_configured",
- "asset_not_found",
- "invalid_color",
- "unknown_icon",
- "invalid_output_path"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found",
+ "invalid_color",
+ "unknown_icon",
+ "invalid_output_path"
+]Output schema / properties / outputFiles / descriptionPrevious value: -"Absolute paths to saved output files (PNG for static, GIF for animations). Present only when PIXOO_OUTPUT_DIR is configured or output is set."New value: +"Absolute paths to saved output files: the output path when set, otherwise the PIXOO_OUTPUT_DIR auto-save (PNG for static, GIF for animations). Absent when neither applies."pixoo_control_device1 field changedOutput schema / properties / noticeAdded value: +{
+ "description": "Requested settings that failed, each with its failure kind and message (e.g. \"brightness:80 failed (network): …\"), joined by \"; \". Absent when every requested setting applied.",
+ "type": "string"
+}pixoo_design_brief8 fields changedOutput schema / properties / nextToolSuggestions / items / descriptionPrevious value: -"A suggested next-step tool with rationale and optional pre-filled args."New value: +"A recommended follow-up call with its arguments pre-filled."Output schema / properties / nextToolSuggestions / items / properties / argsAdded value: +{
+ "additionalProperties": {},
+ "description": "Pre-filled arguments for the call; {} when the tool needs none.",
+ "properties": {},
+ "type": "object"
+}Output schema / properties / nextToolSuggestions / items / properties / rationaleRemoved value: -{
- "description": "Why this tool is relevant given current state.",
- "type": "string"
-}Output schema / properties / nextToolSuggestions / items / properties / reasonAdded value: +{
+ "description": "Why this step is recommended given the current device state.",
+ "type": "string"
+}Output schema / properties / nextToolSuggestions / items / properties / suggestedArgsRemoved value: -{
- "additionalProperties": {},
- "description": "Pre-filled argument suggestions as a key-value object.",
- "properties": {},
- "type": "object"
-}Output schema / properties / nextToolSuggestions / items / properties / toolRemoved value: -{
- "description": "Tool name to try next.",
- "type": "string"
-}Output schema / properties / nextToolSuggestions / items / properties / toolNameAdded value: +{
+ "description": "Tool to call next.",
+ "type": "string"
+}Output schema / properties / nextToolSuggestions / items / requiredPrevious value: -[
- "tool",
- "rationale"
-]New value: +[
+ "toolName",
+ "reason",
+ "args"
+]pixoo_display_text8 fields changedInput schema / properties / align / descriptionPrevious value: -"Multi-line text alignment (default: center)."New value: +"Multi-line text: align every line within the widest line, then place that block with position.x. Omit to place each line by position.x on its own."Input schema / properties / effect / descriptionPrevious value: -"Animation effect. auto = scroll only when text overflows. Produces a multi-frame result."New value: +"Animation effect. scroll runs the text across the display once, in up to 40 frames; auto scrolls only when the text is too wide to fit; float (gentle bob) and pulse (breathing brightness) loop over 20 frames. An animated result is pushed as an animation and previewed as a grid of its frames. none or omitted renders one static frame."Input schema / properties / font / descriptionPrevious value: -"Font variant: standard (5×7) or compact (3×5). Auto-fit will choose if omitted."New value: +"Font variant: standard (5×7) or compact (3×5), used as given — text too wide for it overflows rather than switching font. Omitted, single-line text tries standard and falls back to compact when standard overflows; multi-line text uses standard."Output schema / anyOfPrevious value: -[
- {
- "not": {
- "required": [
- "error"
- ]
- },
- "required": [
- "pushed",
- "layout"
- ]
- },
- {
- "required": [
- "error"
- ]
- }
-]New value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "pushed",
+ "frames",
+ "layout"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: A color value could not be resolved. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: A color value could not be resolved. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_rejected",
- "no_device_configured",
- "invalid_color"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "invalid_color"
+]Output schema / properties / framesAdded value: +{
+ "description": "Number of frames rendered: 1 for static text, 2–40 when an effect animates it.",
+ "type": "number"
+}Output schema / properties / outputFiles / descriptionPrevious value: -"Absolute paths to saved PNG preview files. Present only when PIXOO_OUTPUT_DIR is configured."New value: +"Absolute paths to saved preview files (PNG, or GIF when an effect animates the text). Present only when PIXOO_OUTPUT_DIR is configured."pixoo_overlay_text6 fields changedInput schema / properties / color / descriptionPrevious value: -"Text color as CSS hex color (default: white)."New value: +"Text color: hex (#RRGGBB or #RGB) or a named color such as orange (default: white)."Input schema / properties / width / descriptionPrevious value: -"Text region width in pixels (optional; defaults to display width)."New value: +"Text region width in pixels, 0 to display size (64 on a 64px display; defaults to display width)."Input schema / properties / x / descriptionPrevious value: -"X start position on display (default: 0)."New value: +"X start position, 0 to display size − 1 (63 on a 64px display; default: 0)."Input schema / properties / y / descriptionPrevious value: -"Y start position on display (default: 0)."New value: +"Y start position, 0 to display size − 1 (63 on a 64px display; default: 0)."Output schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device firmware rejected the command. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: The color value could not be resolved. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware rejected the command. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: The color value could not be resolved. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_rejected",
- "no_device_configured",
- "invalid_color"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "invalid_color"
+]pixoo_push_image2 fields changedOutput schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `asset_not_found`: Image path or URL could not be read. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_http_error`: The device answered with a non-2xx HTTP status (retryable for 408, 429, 500, and 502–504). `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `asset_not_found`: Image path or URL could not be read. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_rejected",
- "no_device_configured",
- "asset_not_found"
-]New value: +[
+ "device_unreachable",
+ "device_http_error",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found"
+]v1.1.3pixoo_control_device2 fields changedOutput schema / properties / error / properties / data / properties / reason / descriptionPrevious value: -"Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device rejected the command. `no_device_configured`: PIXOO_IP is not set. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_device_configured`: PIXOO_IP is not set. Other values are possible when a failure originates below the handler."Output schema / properties / error / properties / data / properties / reason / examplesPrevious value: -[
- "device_unreachable",
- "device_rejected",
- "no_device_configured"
-]New value: +[
+ "no_device_configured"
+]v1.1.2pixoo_compose_scene1 field changedInput schema / properties / elements / items / oneOfPrevious value: -[
- {
- "description": "Styled text element rendered at a position.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Flat text color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "font": {
- "description": "Font variant.",
- "enum": [
- "standard",
- "compact"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "style": {
- "description": "Text style options.",
- "properties": {
- "color": {
- "description": "Flat color override.",
- "type": "string"
- },
- "outline": {
- "description": "1px outline.",
- "type": "boolean"
- },
- "palette": {
- "anyOf": [
- {
- "description": "Named built-in color palette for the vertical ramp.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- {
- "description": "Custom gradient stop: specify top and bottom colors directly.",
- "properties": {
- "from": {
- "description": "Top color.",
- "type": "string"
- },
- "to": {
- "description": "Bottom color.",
- "type": "string"
- }
- },
- "required": [
- "from",
- "to"
- ],
- "type": "object"
- }
- ],
- "description": "Palette name or custom gradient stop for vertical color ramp."
- },
- "scale": {
- "description": "Integer pixel scale multiplier.",
- "maximum": 8,
- "minimum": 1,
- "type": "integer"
- },
- "shadow": {
- "description": "Drop shadow.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "text": {
- "description": "Text content to render.",
- "type": "string"
- },
- "type": {
- "const": "text",
- "description": "Text element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: 0)."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position (default: 0)."
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "description": "Built-in or custom SVG icon element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Icon fill color.",
- "type": "string"
- },
- "d": {
- "description": "Custom SVG path d attribute.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Render height in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "name": {
- "description": "Built-in icon name (see pixoo://reference/icons).",
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for colored icon.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "type": {
- "const": "icon",
- "description": "Icon element type.",
- "type": "string"
- },
- "viewBox": {
- "description": "SVG viewBox string (default: \"0 0 16 16\").",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Render width in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position."
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "description": "Filled or gradient rectangle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "borderColor": {
- "description": "1px border color.",
- "type": "string"
- },
- "color": {
- "description": "Fill color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "gradient": {
- "description": "Gradient fill.",
- "properties": {
- "from": {
- "description": "Start color.",
- "type": "string"
- },
- "to": {
- "description": "End color.",
- "type": "string"
- },
- "type": {
- "description": "v = vertical, h = horizontal.",
- "enum": [
- "v",
- "h"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "from",
- "to"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "rect",
- "description": "Rectangle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h"
- ],
- "type": "object"
- },
- {
- "description": "Filled or outline circle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Circle color.",
- "type": "string"
- },
- "cx": {
- "description": "Center X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "cy": {
- "description": "Center Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fill": {
- "description": "Filled or outline only (default: true).",
- "type": "boolean"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "radius": {
- "description": "Radius in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "circle",
- "description": "Circle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "cx",
- "cy",
- "radius"
- ],
- "type": "object"
- },
- {
- "description": "Single-pixel line element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "line",
- "description": "Line element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x0": {
- "description": "Start X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x1": {
- "description": "End X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y0": {
- "description": "Start Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y1": {
- "description": "End Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x0",
- "y0",
- "x1",
- "y1"
- ],
- "type": "object"
- },
- {
- "description": "Horizontal progress bar widget.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "label": {
- "description": "Optional label rendered on the bar.",
- "type": "string"
- },
- "max": {
- "description": "Maximum value.",
- "type": "number"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for gradient fill.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "trackColor": {
- "description": "Background track color.",
- "type": "string"
- },
- "type": {
- "const": "progress",
- "description": "Progress bar widget type.",
- "type": "string"
- },
- "value": {
- "description": "Current value.",
- "type": "number"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "value",
- "max"
- ],
- "type": "object"
- },
- {
- "description": "Sparkline chart widget (line or bar).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line or bar color.",
- "type": "string"
- },
- "data": {
- "description": "Data points for the chart.",
- "items": {
- "type": "number"
- },
- "minItems": 2,
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "kind": {
- "description": "Chart style (default: line).",
- "enum": [
- "line",
- "bar"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "sparkline",
- "description": "Sparkline chart widget type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "Bitmap element using explicit palette indices.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Color palette: array of hex colors indexed 0-F.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "rows": {
- "description": "Row strings of hex palette indices (0-F, space = transparent).",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "type": {
- "const": "bitmap",
- "description": "Bitmap element using palette indices.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "rows",
- "palette"
- ],
- "type": "object"
- },
- {
- "description": "Sparse scatter of individually colored pixels.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "data": {
- "description": "Array of pixel positions and colors.",
- "items": {
- "description": "A single pixel: position and color.",
- "properties": {
- "color": {
- "description": "Pixel color.",
- "type": "string"
- },
- "x": {
- "description": "Pixel X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Pixel Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "x",
- "y",
- "color"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "pixels",
- "description": "Sparse pixel dots element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "External image element (local path or https URL).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fit": {
- "description": "Resize fit mode (default: contain).",
- "enum": [
- "contain",
- "cover",
- "fill"
- ],
- "type": "string"
- },
- "h": {
- "description": "Target height (default: canvas height).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "kernel": {
- "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
- "enum": [
- "nearest",
- "lanczos3",
- "mitchell"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "source": {
- "description": "Absolute local file path or https (not http) URL.",
- "type": "string"
- },
- "type": {
- "const": "image",
- "description": "Image element (local path or https URL).",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Target width (default: canvas width).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "description": "X offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "source"
- ],
- "type": "object"
- },
- {
- "description": "Sprite sheet element for character or tile art.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "prefixItems": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "bodyColor": {
- "description": "Override body color.",
- "type": "string"
- },
- "cols": {
- "description": "Number of columns in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "darkColor": {
- "description": "Override dark/eye color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Absolute local path to the sprite sheet image.",
- "type": "string"
- },
- "rows": {
- "description": "Number of rows in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "scale": {
- "description": "Pixel scale factor.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "sprite",
- "description": "Sprite sheet element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: center)."
- },
- "y": {
- "description": "Y position (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "path",
- "cols",
- "rows"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "description": "Styled text element rendered at a position.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Flat text color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "font": {
+ "description": "Font variant.",
+ "enum": [
+ "standard",
+ "compact"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "style": {
+ "description": "Text style options.",
+ "properties": {
+ "color": {
+ "description": "Flat color override.",
+ "type": "string"
+ },
+ "outline": {
+ "description": "1px outline.",
+ "type": "boolean"
+ },
+ "palette": {
+ "anyOf": [
+ {
+ "description": "Named built-in color palette for the vertical ramp.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Custom gradient stop: specify top and bottom colors directly.",
+ "properties": {
+ "from": {
+ "description": "Top color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "Bottom color.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "from",
+ "to"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "Palette name or custom gradient stop for vertical color ramp."
+ },
+ "scale": {
+ "description": "Integer pixel scale multiplier.",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "shadow": {
+ "description": "Drop shadow.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "text": {
+ "description": "Text content to render.",
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "description": "Text element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: 0)."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position (default: 0)."
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Built-in or custom SVG icon element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Icon fill color.",
+ "type": "string"
+ },
+ "d": {
+ "description": "Custom SVG path d attribute.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Render height in pixels (default: 12).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "name": {
+ "description": "Built-in icon name (see pixoo://reference/icons).",
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette for colored icon.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "icon",
+ "description": "Icon element type.",
+ "type": "string"
+ },
+ "viewBox": {
+ "description": "SVG viewBox string (default: \"0 0 16 16\").",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Render width in pixels (default: 12).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Filled or gradient rectangle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "borderColor": {
+ "description": "1px border color.",
+ "type": "string"
+ },
+ "color": {
+ "description": "Fill color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "gradient": {
+ "description": "Gradient fill.",
+ "properties": {
+ "from": {
+ "description": "Start color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "End color.",
+ "type": "string"
+ },
+ "type": {
+ "description": "v = vertical, h = horizontal.",
+ "enum": [
+ "v",
+ "h"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "from",
+ "to"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "rect",
+ "description": "Rectangle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Filled or outline circle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Circle color.",
+ "type": "string"
+ },
+ "cx": {
+ "description": "Center X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "cy": {
+ "description": "Center Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "fill": {
+ "description": "Filled or outline only (default: true).",
+ "type": "boolean"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "radius": {
+ "description": "Radius in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "circle",
+ "description": "Circle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "cx",
+ "cy",
+ "radius"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Single-pixel line element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Line color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "line",
+ "description": "Line element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x0": {
+ "description": "Start X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x1": {
+ "description": "End X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y0": {
+ "description": "Start Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y1": {
+ "description": "End Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x0",
+ "y0",
+ "x1",
+ "y1"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Horizontal progress bar widget.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "label": {
+ "description": "Optional label rendered on the bar.",
+ "type": "string"
+ },
+ "max": {
+ "description": "Maximum value.",
+ "type": "number"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette for gradient fill.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "trackColor": {
+ "description": "Background track color.",
+ "type": "string"
+ },
+ "type": {
+ "const": "progress",
+ "description": "Progress bar widget type.",
+ "type": "string"
+ },
+ "value": {
+ "description": "Current value.",
+ "type": "number"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "value",
+ "max"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sparkline chart widget (line or bar).",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Line or bar color.",
+ "type": "string"
+ },
+ "data": {
+ "description": "Data points for the chart.",
+ "items": {
+ "type": "number"
+ },
+ "minItems": 2,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "kind": {
+ "description": "Chart style (default: line).",
+ "enum": [
+ "line",
+ "bar"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sparkline",
+ "description": "Sparkline chart widget type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Bitmap element using explicit palette indices.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Color palette: array of hex colors indexed 0-F.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "description": "Row strings of hex palette indices (0-F, space = transparent).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "const": "bitmap",
+ "description": "Bitmap element using palette indices.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "rows",
+ "palette"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sparse scatter of individually colored pixels.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "data": {
+ "description": "Array of pixel positions and colors.",
+ "items": {
+ "description": "A single pixel: position and color.",
+ "properties": {
+ "color": {
+ "description": "Pixel color.",
+ "type": "string"
+ },
+ "x": {
+ "description": "Pixel X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Pixel Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "x",
+ "y",
+ "color"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "pixels",
+ "description": "Sparse pixel dots element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "External image element (local path or https URL).",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "fit": {
+ "description": "Resize fit mode (default: contain).",
+ "enum": [
+ "contain",
+ "cover",
+ "fill"
+ ],
+ "type": "string"
+ },
+ "h": {
+ "description": "Target height (default: canvas height).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "kernel": {
+ "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
+ "enum": [
+ "nearest",
+ "lanczos3",
+ "mitchell"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "source": {
+ "description": "Absolute local file path or https (not http) URL.",
+ "type": "string"
+ },
+ "type": {
+ "const": "image",
+ "description": "Image element (local path or https URL).",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Target width (default: canvas width).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sprite sheet element for character or tile art.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "items": false,
+ "maxItems": 2,
+ "minItems": 2,
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "description": "Value at this frame.",
+ "type": [
+ "number",
+ "string",
+ "boolean"
+ ]
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "bodyColor": {
+ "description": "Override body color.",
+ "type": "string"
+ },
+ "cols": {
+ "description": "Number of columns in the sprite grid.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "darkColor": {
+ "description": "Override dark/eye color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "path": {
+ "description": "Absolute local path to the sprite sheet image.",
+ "type": "string"
+ },
+ "rows": {
+ "description": "Number of rows in the sprite grid.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "scale": {
+ "description": "Pixel scale factor.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sprite",
+ "description": "Sprite sheet element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: center)."
+ },
+ "y": {
+ "description": "Y position (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "path",
+ "cols",
+ "rows"
+ ],
+ "type": "object"
+ }
+]v1.1.1pixoo_compose_scene10 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseInput schema / properties / elements / items / oneOfPrevious value: -[
- {
- "description": "Styled text element rendered at a position.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Flat text color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "font": {
- "description": "Font variant.",
- "enum": [
- "standard",
- "compact"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "style": {
- "description": "Text style options.",
- "properties": {
- "color": {
- "description": "Flat color override.",
- "type": "string"
- },
- "outline": {
- "description": "1px outline.",
- "type": "boolean"
- },
- "palette": {
- "anyOf": [
- {
- "description": "Named built-in color palette for the vertical ramp.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- {
- "description": "Custom gradient stop: specify top and bottom colors directly.",
- "properties": {
- "from": {
- "description": "Top color.",
- "type": "string"
- },
- "to": {
- "description": "Bottom color.",
- "type": "string"
- }
- },
- "required": [
- "from",
- "to"
- ],
- "type": "object"
- }
- ],
- "description": "Palette name or custom gradient stop for vertical color ramp."
- },
- "scale": {
- "description": "Integer pixel scale multiplier.",
- "maximum": 8,
- "minimum": 1,
- "type": "integer"
- },
- "shadow": {
- "description": "Drop shadow.",
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "text": {
- "description": "Text content to render.",
- "type": "string"
- },
- "type": {
- "const": "text",
- "description": "Text element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: 0)."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position (default: 0)."
- }
- },
- "required": [
- "type",
- "text"
- ],
- "type": "object"
- },
- {
- "description": "Built-in or custom SVG icon element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Icon fill color.",
- "type": "string"
- },
- "d": {
- "description": "Custom SVG path d attribute.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Render height in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "name": {
- "description": "Built-in icon name (see pixoo://reference/icons).",
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for colored icon.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "type": {
- "const": "icon",
- "description": "Icon element type.",
- "type": "string"
- },
- "viewBox": {
- "description": "SVG viewBox string (default: \"0 0 16 16\").",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Render width in pixels (default: 12).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position."
- },
- "y": {
- "anyOf": [
- {
- "description": "Absolute pixel Y coordinate (0 = top edge).",
- "type": "number"
- },
- {
- "description": "Semantic vertical alignment.",
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- }
- ],
- "description": "Y position."
- }
- },
- "required": [
- "type"
- ],
- "type": "object"
- },
- {
- "description": "Filled or gradient rectangle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "borderColor": {
- "description": "1px border color.",
- "type": "string"
- },
- "color": {
- "description": "Fill color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "gradient": {
- "description": "Gradient fill.",
- "properties": {
- "from": {
- "description": "Start color.",
- "type": "string"
- },
- "to": {
- "description": "End color.",
- "type": "string"
- },
- "type": {
- "description": "v = vertical, h = horizontal.",
- "enum": [
- "v",
- "h"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "from",
- "to"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "rect",
- "description": "Rectangle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h"
- ],
- "type": "object"
- },
- {
- "description": "Filled or outline circle element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Circle color.",
- "type": "string"
- },
- "cx": {
- "description": "Center X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "cy": {
- "description": "Center Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fill": {
- "description": "Filled or outline only (default: true).",
- "type": "boolean"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "radius": {
- "description": "Radius in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "circle",
- "description": "Circle element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "cx",
- "cy",
- "radius"
- ],
- "type": "object"
- },
- {
- "description": "Single-pixel line element.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "line",
- "description": "Line element type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x0": {
- "description": "Start X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x1": {
- "description": "End X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y0": {
- "description": "Start Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y1": {
- "description": "End Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x0",
- "y0",
- "x1",
- "y1"
- ],
- "type": "object"
- },
- {
- "description": "Horizontal progress bar widget.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "label": {
- "description": "Optional label rendered on the bar.",
- "type": "string"
- },
- "max": {
- "description": "Maximum value.",
- "type": "number"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Named palette for gradient fill.",
- "enum": [
- "ember",
- "ice",
- "neon",
- "fire",
- "lavender",
- "claude",
- "mono"
- ],
- "type": "string"
- },
- "trackColor": {
- "description": "Background track color.",
- "type": "string"
- },
- "type": {
- "const": "progress",
- "description": "Progress bar widget type.",
- "type": "string"
- },
- "value": {
- "description": "Current value.",
- "type": "number"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "value",
- "max"
- ],
- "type": "object"
- },
- {
- "description": "Sparkline chart widget (line or bar).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "color": {
- "description": "Line or bar color.",
- "type": "string"
- },
- "data": {
- "description": "Data points for the chart.",
- "items": {
- "type": "number"
- },
- "minItems": 2,
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "h": {
- "description": "Height in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "kind": {
- "description": "Chart style (default: line).",
- "enum": [
- "line",
- "bar"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "sparkline",
- "description": "Sparkline chart widget type.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Width in pixels.",
- "maximum": 9007199254740991,
- "minimum": 2,
- "type": "integer"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "w",
- "h",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "Bitmap element using explicit palette indices.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "palette": {
- "description": "Color palette: array of hex colors indexed 0-F.",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "rows": {
- "description": "Row strings of hex palette indices (0-F, space = transparent).",
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "type": {
- "const": "bitmap",
- "description": "Bitmap element using palette indices.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "description": "X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "x",
- "y",
- "rows",
- "palette"
- ],
- "type": "object"
- },
- {
- "description": "Sparse scatter of individually colored pixels.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "data": {
- "description": "Array of pixel positions and colors.",
- "items": {
- "description": "A single pixel: position and color.",
- "properties": {
- "color": {
- "description": "Pixel color.",
- "type": "string"
- },
- "x": {
- "description": "Pixel X coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Pixel Y coordinate.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "x",
- "y",
- "color"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "type": {
- "const": "pixels",
- "description": "Sparse pixel dots element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- }
- },
- "required": [
- "type",
- "data"
- ],
- "type": "object"
- },
- {
- "description": "External image element (local path or https URL).",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "fit": {
- "description": "Resize fit mode (default: contain).",
- "enum": [
- "contain",
- "cover",
- "fill"
- ],
- "type": "string"
- },
- "h": {
- "description": "Target height (default: canvas height).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "kernel": {
- "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
- "enum": [
- "nearest",
- "lanczos3",
- "mitchell"
- ],
- "type": "string"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "source": {
- "description": "Absolute local file path or https (not http) URL.",
- "type": "string"
- },
- "type": {
- "const": "image",
- "description": "Image element (local path or https URL).",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "w": {
- "description": "Target width (default: canvas width).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "x": {
- "description": "X offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "y": {
- "description": "Y offset on canvas (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "source"
- ],
- "type": "object"
- },
- {
- "description": "Sprite sheet element for character or tile art.",
- "properties": {
- "animate": {
- "additionalProperties": {
- "description": "Keyframe entries: [[frame, value], ...].",
- "items": {
- "items": [
- {
- "description": "Frame index.",
- "type": "number"
- },
- {
- "anyOf": [
- {
- "type": "number"
- },
- {
- "type": "string"
- },
- {
- "type": "boolean"
- }
- ],
- "description": "Value at this frame."
- }
- ],
- "type": "array"
- },
- "type": "array"
- },
- "description": "Raw keyframe animation map for this element.",
- "propertyNames": {
- "type": "string"
- },
- "type": "object"
- },
- "bodyColor": {
- "description": "Override body color.",
- "type": "string"
- },
- "cols": {
- "description": "Number of columns in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "darkColor": {
- "description": "Override dark/eye color.",
- "type": "string"
- },
- "dx": {
- "description": "X offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "dy": {
- "description": "Y offset nudge in pixels.",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- },
- "effect": {
- "description": "Named animation preset for this element.",
- "properties": {
- "amplitude": {
- "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
- "type": "number"
- },
- "name": {
- "description": "Named animation preset.",
- "enum": [
- "float",
- "scroll-left",
- "scroll-right",
- "pulse",
- "blink",
- "twinkle",
- "drift",
- "fade-in",
- "fade-out"
- ],
- "type": "string"
- },
- "period": {
- "description": "Effect period in frames. Defaults to total scene frame count.",
- "type": "number"
- },
- "phase": {
- "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
- "type": "number"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "opacity": {
- "description": "Opacity 0–100 (default: 100).",
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "path": {
- "description": "Absolute local path to the sprite sheet image.",
- "type": "string"
- },
- "rows": {
- "description": "Number of rows in the sprite grid.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "scale": {
- "description": "Pixel scale factor.",
- "maximum": 9007199254740991,
- "minimum": 1,
- "type": "integer"
- },
- "type": {
- "const": "sprite",
- "description": "Sprite sheet element.",
- "type": "string"
- },
- "visible": {
- "description": "Whether the element is visible (default: true).",
- "type": "boolean"
- },
- "x": {
- "anyOf": [
- {
- "description": "Absolute pixel X coordinate (0 = left edge).",
- "type": "number"
- },
- {
- "description": "Semantic horizontal alignment.",
- "enum": [
- "left",
- "center",
- "right"
- ],
- "type": "string"
- }
- ],
- "description": "X position (default: center)."
- },
- "y": {
- "description": "Y position (default: 0).",
- "maximum": 9007199254740991,
- "minimum": -9007199254740991,
- "type": "integer"
- }
- },
- "required": [
- "type",
- "path",
- "cols",
- "rows"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "description": "Styled text element rendered at a position.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Flat text color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "font": {
+ "description": "Font variant.",
+ "enum": [
+ "standard",
+ "compact"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "style": {
+ "description": "Text style options.",
+ "properties": {
+ "color": {
+ "description": "Flat color override.",
+ "type": "string"
+ },
+ "outline": {
+ "description": "1px outline.",
+ "type": "boolean"
+ },
+ "palette": {
+ "anyOf": [
+ {
+ "description": "Named built-in color palette for the vertical ramp.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Custom gradient stop: specify top and bottom colors directly.",
+ "properties": {
+ "from": {
+ "description": "Top color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "Bottom color.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "from",
+ "to"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "Palette name or custom gradient stop for vertical color ramp."
+ },
+ "scale": {
+ "description": "Integer pixel scale multiplier.",
+ "maximum": 8,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "shadow": {
+ "description": "Drop shadow.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "text": {
+ "description": "Text content to render.",
+ "type": "string"
+ },
+ "type": {
+ "const": "text",
+ "description": "Text element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: 0)."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position (default: 0)."
+ }
+ },
+ "required": [
+ "type",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Built-in or custom SVG icon element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Icon fill color.",
+ "type": "string"
+ },
+ "d": {
+ "description": "Custom SVG path d attribute.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Render height in pixels (default: 12).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "name": {
+ "description": "Built-in icon name (see pixoo://reference/icons).",
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette for colored icon.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "type": {
+ "const": "icon",
+ "description": "Icon element type.",
+ "type": "string"
+ },
+ "viewBox": {
+ "description": "SVG viewBox string (default: \"0 0 16 16\").",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Render width in pixels (default: 12).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position."
+ },
+ "y": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel Y coordinate (0 = top edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic vertical alignment.",
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "Y position."
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Filled or gradient rectangle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "borderColor": {
+ "description": "1px border color.",
+ "type": "string"
+ },
+ "color": {
+ "description": "Fill color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "gradient": {
+ "description": "Gradient fill.",
+ "properties": {
+ "from": {
+ "description": "Start color.",
+ "type": "string"
+ },
+ "to": {
+ "description": "End color.",
+ "type": "string"
+ },
+ "type": {
+ "description": "v = vertical, h = horizontal.",
+ "enum": [
+ "v",
+ "h"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "from",
+ "to"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "rect",
+ "description": "Rectangle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Filled or outline circle element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Circle color.",
+ "type": "string"
+ },
+ "cx": {
+ "description": "Center X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "cy": {
+ "description": "Center Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "fill": {
+ "description": "Filled or outline only (default: true).",
+ "type": "boolean"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "radius": {
+ "description": "Radius in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "circle",
+ "description": "Circle element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "cx",
+ "cy",
+ "radius"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Single-pixel line element.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Line color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "line",
+ "description": "Line element type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x0": {
+ "description": "Start X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x1": {
+ "description": "End X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y0": {
+ "description": "Start Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y1": {
+ "description": "End Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x0",
+ "y0",
+ "x1",
+ "y1"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Horizontal progress bar widget.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "label": {
+ "description": "Optional label rendered on the bar.",
+ "type": "string"
+ },
+ "max": {
+ "description": "Maximum value.",
+ "type": "number"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Named palette for gradient fill.",
+ "enum": [
+ "ember",
+ "ice",
+ "neon",
+ "fire",
+ "lavender",
+ "claude",
+ "mono"
+ ],
+ "type": "string"
+ },
+ "trackColor": {
+ "description": "Background track color.",
+ "type": "string"
+ },
+ "type": {
+ "const": "progress",
+ "description": "Progress bar widget type.",
+ "type": "string"
+ },
+ "value": {
+ "description": "Current value.",
+ "type": "number"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "value",
+ "max"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sparkline chart widget (line or bar).",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "color": {
+ "description": "Line or bar color.",
+ "type": "string"
+ },
+ "data": {
+ "description": "Data points for the chart.",
+ "items": {
+ "type": "number"
+ },
+ "minItems": 2,
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "h": {
+ "description": "Height in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "kind": {
+ "description": "Chart style (default: line).",
+ "enum": [
+ "line",
+ "bar"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sparkline",
+ "description": "Sparkline chart widget type.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Width in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": 2,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "w",
+ "h",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Bitmap element using explicit palette indices.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "palette": {
+ "description": "Color palette: array of hex colors indexed 0-F.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "description": "Row strings of hex palette indices (0-F, space = transparent).",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "const": "bitmap",
+ "description": "Bitmap element using palette indices.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "description": "X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "x",
+ "y",
+ "rows",
+ "palette"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sparse scatter of individually colored pixels.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "data": {
+ "description": "Array of pixel positions and colors.",
+ "items": {
+ "description": "A single pixel: position and color.",
+ "properties": {
+ "color": {
+ "description": "Pixel color.",
+ "type": "string"
+ },
+ "x": {
+ "description": "Pixel X coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Pixel Y coordinate.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "x",
+ "y",
+ "color"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "const": "pixels",
+ "description": "Sparse pixel dots element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "type",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "External image element (local path or https URL).",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "fit": {
+ "description": "Resize fit mode (default: contain).",
+ "enum": [
+ "contain",
+ "cover",
+ "fill"
+ ],
+ "type": "string"
+ },
+ "h": {
+ "description": "Target height (default: canvas height).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "kernel": {
+ "description": "Resize kernel: nearest for pixel art, lanczos3 for photos (default: nearest).",
+ "enum": [
+ "nearest",
+ "lanczos3",
+ "mitchell"
+ ],
+ "type": "string"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "source": {
+ "description": "Absolute local file path or https (not http) URL.",
+ "type": "string"
+ },
+ "type": {
+ "const": "image",
+ "description": "Image element (local path or https URL).",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "w": {
+ "description": "Target width (default: canvas width).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "x": {
+ "description": "X offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "y": {
+ "description": "Y offset on canvas (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "source"
+ ],
+ "type": "object"
+ },
+ {
+ "description": "Sprite sheet element for character or tile art.",
+ "properties": {
+ "animate": {
+ "additionalProperties": {
+ "description": "Keyframe entries: [[frame, value], ...].",
+ "items": {
+ "prefixItems": [
+ {
+ "description": "Frame index.",
+ "type": "number"
+ },
+ {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ],
+ "description": "Value at this frame."
+ }
+ ],
+ "type": "array"
+ },
+ "type": "array"
+ },
+ "description": "Raw keyframe animation map for this element.",
+ "propertyNames": {
+ "type": "string"
+ },
+ "type": "object"
+ },
+ "bodyColor": {
+ "description": "Override body color.",
+ "type": "string"
+ },
+ "cols": {
+ "description": "Number of columns in the sprite grid.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "darkColor": {
+ "description": "Override dark/eye color.",
+ "type": "string"
+ },
+ "dx": {
+ "description": "X offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "dy": {
+ "description": "Y offset nudge in pixels.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "effect": {
+ "description": "Named animation preset for this element.",
+ "properties": {
+ "amplitude": {
+ "description": "Effect intensity: pixels of movement for float/scroll/drift, 0–1 scale for fade/pulse. Default varies by effect (float: 2px).",
+ "type": "number"
+ },
+ "name": {
+ "description": "Named animation preset.",
+ "enum": [
+ "float",
+ "scroll-left",
+ "scroll-right",
+ "pulse",
+ "blink",
+ "twinkle",
+ "drift",
+ "fade-in",
+ "fade-out"
+ ],
+ "type": "string"
+ },
+ "period": {
+ "description": "Effect period in frames. Defaults to total scene frame count.",
+ "type": "number"
+ },
+ "phase": {
+ "description": "Phase offset 0–1 to stagger this element relative to others (0.5 = half-cycle offset).",
+ "type": "number"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "opacity": {
+ "description": "Opacity 0–100 (default: 100).",
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "path": {
+ "description": "Absolute local path to the sprite sheet image.",
+ "type": "string"
+ },
+ "rows": {
+ "description": "Number of rows in the sprite grid.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "scale": {
+ "description": "Pixel scale factor.",
+ "maximum": 9007199254740991,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "type": {
+ "const": "sprite",
+ "description": "Sprite sheet element.",
+ "type": "string"
+ },
+ "visible": {
+ "description": "Whether the element is visible (default: true).",
+ "type": "boolean"
+ },
+ "x": {
+ "anyOf": [
+ {
+ "description": "Absolute pixel X coordinate (0 = left edge).",
+ "type": "number"
+ },
+ {
+ "description": "Semantic horizontal alignment.",
+ "enum": [
+ "left",
+ "center",
+ "right"
+ ],
+ "type": "string"
+ }
+ ],
+ "description": "X position (default: center)."
+ },
+ "y": {
+ "description": "Y position (default: 0).",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "type",
+ "path",
+ "cols",
+ "rows"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / output / descriptionPrevious value: -"Explicit output file path for saving (overrides PIXOO_OUTPUT_DIR)."New value: +"Absolute, already-normalized path to save the first frame to, in addition to the PIXOO_OUTPUT_DIR auto-save when that is configured. Both paths are reported in outputFiles."Output schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "pushed",
+ "frames",
+ "layout"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set and push was requested. `asset_not_found`: An image or sprite path could not be read. `invalid_color`: A color value could not be resolved. `unknown_icon`: Icon name not found in the registry. `invalid_output_path`: The output path is relative or contains traversal segments. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "device_unreachable",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found",
+ "invalid_color",
+ "unknown_icon",
+ "invalid_output_path"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / properties / previewDataRemoved value: -{
- "description": "Base64-encoded PNG preview of the rendered scene (8× upscaled, 512px). For animations: the middle frame.",
- "type": "string"
-}Output schema / properties / previewMimeTypeRemoved value: -{
- "description": "MIME type of the preview image.",
- "enum": [
- "image/png"
- ],
- "type": "string"
-}Output schema / requiredRemoved value: -[
- "pushed",
- "frames",
- "layout"
-]pixoo_control_device6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "reachable",
+ "applied"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device rejected the command. `no_device_configured`: PIXOO_IP is not set. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "device_unreachable",
+ "device_rejected",
+ "no_device_configured"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / requiredRemoved value: -[
- "reachable",
- "applied"
-]pixoo_design_brief6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "topic",
+ "craftGuidance",
+ "deviceContext",
+ "nextToolSuggestions",
+ "availableThemes",
+ "iconCategories"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode.",
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / requiredRemoved value: -[
- "topic",
- "craftGuidance",
- "deviceContext",
- "nextToolSuggestions",
- "availableThemes",
- "iconCategories"
-]pixoo_discover_devices6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "devices"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `discovery_failed`: Divoom cloud discovery endpoint is unreachable. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "discovery_failed"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / requiredRemoved value: -[
- "devices"
-]pixoo_display_text8 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "pushed",
+ "layout"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable over the network. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: A color value could not be resolved. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "device_unreachable",
+ "device_rejected",
+ "no_device_configured",
+ "invalid_color"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / properties / previewDataRemoved value: -{
- "description": "Base64-encoded PNG preview of the rendered frame (8× upscaled, 512px).",
- "type": "string"
-}Output schema / properties / previewMimeTypeRemoved value: -{
- "description": "MIME type of the preview image.",
- "enum": [
- "image/png"
- ],
- "type": "string"
-}Output schema / requiredRemoved value: -[
- "pushed",
- "layout"
-]pixoo_overlay_text6 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "acknowledged",
+ "mode",
+ "id"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device firmware rejected the command. `no_device_configured`: PIXOO_IP is not set. `invalid_color`: The color value could not be resolved. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "device_unreachable",
+ "device_rejected",
+ "no_device_configured",
+ "invalid_color"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / requiredRemoved value: -[
- "acknowledged",
- "mode",
- "id"
-]pixoo_push_image8 fields changedInput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Input schema / additionalPropertiesAdded value: +falseOutput schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"Output schema / anyOfAdded value: +[
+ {
+ "not": {
+ "required": [
+ "error"
+ ]
+ },
+ "required": [
+ "pushed"
+ ]
+ },
+ {
+ "required": [
+ "error"
+ ]
+ }
+]Output schema / properties / errorAdded value: +{
+ "additionalProperties": {},
+ "description": "Present when the call failed. Absent on success.",
+ "properties": {
+ "code": {
+ "description": "JSON-RPC error code for this failure.",
+ "maximum": 9007199254740991,
+ "minimum": -9007199254740991,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": {},
+ "properties": {
+ "reason": {
+ "description": "Machine-readable failure mode. Declared by this tool: `device_unreachable`: Device is not reachable. `device_rejected`: Device firmware returned a non-zero error code. `no_device_configured`: PIXOO_IP is not set. `asset_not_found`: Image path or URL could not be read. Other values are possible when a failure originates below the handler.",
+ "examples": [
+ "device_unreachable",
+ "device_rejected",
+ "no_device_configured",
+ "asset_not_found"
+ ],
+ "type": "string"
+ },
+ "recovery": {
+ "additionalProperties": {},
+ "description": "Actionable next step for the caller.",
+ "properties": {
+ "hint": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "hint"
+ ],
+ "type": "object"
+ },
+ "retryable": {
+ "description": "Whether retrying may succeed.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "message": {
+ "description": "Human-readable description of what went wrong.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+}Output schema / properties / previewDataRemoved value: -{
- "description": "Base64-encoded PNG preview of the downsampled 64×64 result (8× upscaled, 512px).",
- "type": "string"
-}Output schema / properties / previewMimeTypeRemoved value: -{
- "description": "MIME type of the preview image.",
- "enum": [
- "image/png"
- ],
- "type": "string"
-}Output schema / requiredRemoved value: -[
- "pushed"
-]v1.0.0pixoo_compose_scenepixoo_control_devicepixoo_design_briefpixoo_discover_devicespixoo_display_textpixoo_overlay_textpixoo_push_imageScored across 7 tools
Each tool targets a distinct action and resource: discovery, device state control, styled text, layered scenes, image push, overlay text, and design guidance. The two text-related tools (display_text vs overlay_text) and display_text vs compose_scene are explicitly differentiated in their descriptions, which cross-reference each other and clarify when to use which.
All tools share the pixoo_ prefix with a consistent snake_case verb_noun pattern (discover_devices, display_text, compose_scene, push_image, control_device, overlay_text). design_brief is the only slight deviation but remains readable and follows the same casing convention.
Seven tools is well-scoped for a device-control server, with each tool earning its place across discovery, control, rendering, and guidance. No obvious redundancy or bloat.
The surface covers the full lifecycle: discover device, read/change state, render text/scenes/images, set overlays, and get design guidance before authoring. Minor gaps like a dedicated clear/reset display or saved-scene management exist but can be worked around via control_device and overlay clear modes.
Manage digital signage screens, playlists and media from your AI assistant.
Generate pixel art sprites, animations, 8-direction rotations and palettes for games.
Display delivery platform for AI agents. Push HTML, dashboards and live data to screens.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
