{
  "openapi": "3.1.1",
  "info": {
    "title": "Particle Effect Frame Generator API",
    "version": "1.0.0",
    "summary": "Simulate sparks, snow, smoke or confetti as PNG frames and an editable flipbook layer.",
    "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp."
  },
  "servers": [
    {
      "url": "https://fliplineparticleframes.usefulweb.app"
    }
  ],
  "paths": {
    "/api/v1/calculate": {
      "post": {
        "operationId": "calculate",
        "summary": "Simulate sparks, snow, smoke or confetti as PNG frames and an editable flipbook layer.",
        "description": "Set up a seeded particle emitter — shape, rate, burst, lifetime, direction, speed, gravity, wind and drag — and choose how size, color and opacity change over each particle’s life with CSS easing curves. Get a transparent PNG sequence, a contact strip, per-frame particle counts and, for up to 24 drawings, an editable Flipline drawing whose particle layer you can open and draw over.\n\nMethodology:\n- Spawning: a start burst at time 0, then one particle every 1/rate seconds. Each particle draws its position on the emitter shape, direction (direction ± spread/2, or away from the shape centre), speed, lifetime and size factor from a seeded mulberry32 stream keyed by seed and particle number, so changing one setting never reshuffles unrelated particles. At most 20000 particles are emitted.\n- Motion is evaluated in closed form at every frame time t = frame/FPS (plus the pre-roll): without drag p = p0 + v0·a + ½·g·a²; with linear drag k, p = p0 + (g/k)·a + (v0 − g/k)(1 − e^(−k·a))/k, where a is the particle’s age. Gravity points down and wind right, in pixels per second squared. Seamless loops spawn over one loop length and wrap ages by it, so frame N+1 would equal frame 1.\n- Over life q = age/lifetime, size, opacity and color follow CSS easing curves (the same engine as the Easing Curve tool and Motion Desk): value = start + (end − start)·ease(q); colors mix in linear light. Sizes are clamped to 1–100 px and opacity to 0–1; particles whose centre leaves the canvas are not drawn.\n- Each particle is one Flipline brush mark: Dot = a single Studio-ink dab, Glow = the four concentric Soft-airbrush dabs. The PNG frames are rasterized from exactly these dabs with deterministic arithmetic (one-pixel anti-aliased edges, normal alpha compositing), so app and tool produce identical files. Editable drawings hold at most 24 drawings, 500 particles per drawing and 2000 marks in total; PNG sequences allow 240 frames, 4000 visible particles per frame and 40 megapixels in total.",
        "tags": [
          "apps"
        ],
        "x-mcp-tool": "flipline_particle_frames",
        "x-owner-app": "flipline",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FliplineParticleFramesInput"
              },
              "examples": {
                "example1": {
                  "summary": "Rising embers that loop over 24 drawings",
                  "value": {}
                },
                "example2": {
                  "summary": "A confetti burst at 24 FPS, 36 frames on white",
                  "value": {
                    "preset": "burst",
                    "fps": 24,
                    "frames": 36,
                    "background": "#FFFFFF"
                  }
                },
                "example3": {
                  "summary": "Custom ring of sparks thrown outward",
                  "value": {
                    "preset": "custom",
                    "shape": "ring",
                    "x": 50,
                    "y": 50,
                    "emitterWidth": 120,
                    "emitterHeight": 120,
                    "rate": 0,
                    "burst": 48,
                    "loop": false,
                    "outward": true,
                    "spread": 0,
                    "speed": 300,
                    "gravity": 200,
                    "wind": 0,
                    "drag": 1,
                    "life": 1.2,
                    "lifeVar": 20,
                    "sizeStart": 8,
                    "sizeEnd": 2,
                    "colorStart": "#FFF3B0",
                    "colorEnd": "#E36414",
                    "opacityStart": 100,
                    "opacityEnd": 0,
                    "opacityEase": "ease-in",
                    "style": "glow",
                    "frames": 16
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Calculation result envelope.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FliplineParticleFramesResult"
                }
              }
            }
          },
          "400": {
            "description": "Malformed JSON body.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "422": {
            "description": "Invalid input (see errors[]).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded (see Retry-After).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/tool": {
      "get": {
        "operationId": "getToolDefinition",
        "summary": "Inputs, output schema and examples for this tool",
        "responses": {
          "200": {
            "description": "Tool definition.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Problem": {
        "type": "object",
        "description": "RFC 9457 problem details. 422 responses include per-field `errors`.",
        "required": [
          "type",
          "title",
          "status",
          "detail"
        ],
        "properties": {
          "type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "detail": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "field",
                "message"
              ],
              "properties": {
                "field": {
                  "type": "string"
                },
                "message": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "FliplineParticleFramesInput": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "preset": {
            "title": "Particle preset",
            "type": "string",
            "enum": [
              "custom",
              "embers",
              "snow",
              "burst",
              "smoke",
              "fountain"
            ],
            "default": "embers"
          },
          "width": {
            "title": "Canvas width (px)",
            "type": "integer",
            "minimum": 32,
            "maximum": 1600,
            "default": 960
          },
          "height": {
            "title": "Canvas height (px)",
            "type": "integer",
            "minimum": 32,
            "maximum": 1600,
            "default": 540
          },
          "fps": {
            "title": "Frame rate (FPS)",
            "type": "integer",
            "minimum": 1,
            "maximum": 30,
            "default": 12
          },
          "frames": {
            "title": "Frames",
            "type": "integer",
            "minimum": 1,
            "maximum": 240,
            "default": 24
          },
          "background": {
            "title": "PNG background HEX (empty = transparent)",
            "type": "string",
            "maxLength": 7,
            "default": ""
          },
          "shape": {
            "title": "Emitter shape",
            "type": "string",
            "enum": [
              "point",
              "line",
              "rect",
              "ellipse",
              "ring"
            ],
            "default": "line"
          },
          "x": {
            "title": "Emitter centre X (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 50
          },
          "y": {
            "title": "Emitter centre Y (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 92
          },
          "emitterWidth": {
            "title": "Emitter width (px)",
            "type": "number",
            "minimum": 0,
            "maximum": 1600,
            "default": 420
          },
          "emitterHeight": {
            "title": "Emitter height (px)",
            "type": "number",
            "minimum": 0,
            "maximum": 1600,
            "default": 0
          },
          "angle": {
            "title": "Emitter rotation (degrees)",
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "default": 0
          },
          "rate": {
            "title": "Emission rate (particles per second)",
            "type": "number",
            "minimum": 0,
            "maximum": 2000,
            "default": 30
          },
          "burst": {
            "title": "Start burst (particles)",
            "type": "integer",
            "minimum": 0,
            "maximum": 2000,
            "default": 0
          },
          "life": {
            "title": "Lifetime (seconds)",
            "type": "number",
            "minimum": 0.05,
            "maximum": 20,
            "default": 1.6
          },
          "lifeVar": {
            "title": "Lifetime variation (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 30
          },
          "direction": {
            "title": "Direction (degrees, 0 = right, 90 = up)",
            "type": "number",
            "minimum": -360,
            "maximum": 360,
            "default": 90
          },
          "spread": {
            "title": "Spread (degrees)",
            "type": "number",
            "minimum": 0,
            "maximum": 360,
            "default": 24
          },
          "outward": {
            "title": "Throw particles away from the shape centre",
            "type": "boolean",
            "default": false
          },
          "speed": {
            "title": "Speed (px per second)",
            "type": "number",
            "minimum": 0,
            "maximum": 5000,
            "default": 260
          },
          "speedVar": {
            "title": "Speed variation (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 35
          },
          "gravity": {
            "title": "Gravity (px/s², positive = down)",
            "type": "number",
            "minimum": -5000,
            "maximum": 5000,
            "default": -60
          },
          "wind": {
            "title": "Wind (px/s², positive = right)",
            "type": "number",
            "minimum": -5000,
            "maximum": 5000,
            "default": 20
          },
          "drag": {
            "title": "Drag (per second)",
            "type": "number",
            "minimum": 0,
            "maximum": 20,
            "default": 0.6
          },
          "sizeStart": {
            "title": "Start size (px)",
            "type": "number",
            "minimum": 1,
            "maximum": 100,
            "default": 20
          },
          "sizeEnd": {
            "title": "End size (px)",
            "type": "number",
            "minimum": 1,
            "maximum": 100,
            "default": 4
          },
          "sizeVar": {
            "title": "Size variation (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 30
          },
          "sizeEase": {
            "title": "Size easing over life",
            "type": "string",
            "maxLength": 200,
            "default": "ease-out"
          },
          "colorStart": {
            "title": "Start color HEX",
            "type": "string",
            "maxLength": 7,
            "default": "#FFD27A"
          },
          "colorEnd": {
            "title": "End color HEX",
            "type": "string",
            "maxLength": 7,
            "default": "#C6452B"
          },
          "colorEase": {
            "title": "Color easing over life",
            "type": "string",
            "maxLength": 200,
            "default": "ease-in"
          },
          "opacityStart": {
            "title": "Start opacity (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 95
          },
          "opacityEnd": {
            "title": "End opacity (%)",
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "default": 0
          },
          "opacityEase": {
            "title": "Opacity easing over life",
            "type": "string",
            "maxLength": 200,
            "default": "ease-in"
          },
          "style": {
            "title": "Particle look",
            "type": "string",
            "enum": [
              "dot",
              "glow"
            ],
            "default": "glow"
          },
          "seed": {
            "title": "Random seed",
            "type": "integer",
            "minimum": 0,
            "maximum": 4294967295,
            "default": 7
          },
          "loop": {
            "title": "Seamless loop",
            "type": "boolean",
            "default": true
          },
          "prewarm": {
            "title": "Pre-roll before frame 1 (seconds, no loop)",
            "type": "number",
            "minimum": 0,
            "maximum": 20,
            "default": 0
          }
        },
        "required": []
      },
      "FliplineParticleFramesResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "schemaVersion",
          "tool",
          "computedAt",
          "inputs",
          "summary",
          "result",
          "units",
          "assumptions",
          "sources",
          "warnings",
          "presentation",
          "links"
        ],
        "properties": {
          "schemaVersion": {
            "type": "string",
            "const": "1.0"
          },
          "tool": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "name",
              "version"
            ],
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "version": {
                "type": "string"
              }
            }
          },
          "computedAt": {
            "type": "string",
            "format": "date-time"
          },
          "inputs": {
            "type": "object",
            "description": "Normalised inputs actually used, including applied defaults."
          },
          "summary": {
            "type": "string"
          },
          "result": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "frames",
              "fps",
              "width",
              "height",
              "spawned",
              "peakParticles",
              "counts",
              "recipe",
              "sequence",
              "project",
              "projectError",
              "openInApp"
            ],
            "properties": {
              "frames": {
                "type": "integer"
              },
              "fps": {
                "type": "integer"
              },
              "width": {
                "type": "integer"
              },
              "height": {
                "type": "integer"
              },
              "spawned": {
                "type": "integer"
              },
              "peakParticles": {
                "type": "integer"
              },
              "counts": {
                "type": "array",
                "items": {
                  "type": "integer"
                }
              },
              "recipe": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "format",
                  "version",
                  "frames",
                  "fps",
                  "emitter"
                ],
                "properties": {
                  "format": {
                    "const": "flipline-particles"
                  },
                  "version": {
                    "const": 1
                  },
                  "frames": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 240
                  },
                  "fps": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 60
                  },
                  "emitter": {
                    "type": "object",
                    "additionalProperties": false,
                    "description": "Seeded particle emitter. Positions x/y are normalized to the canvas; width/height/size in pixels; speed in px/s; gravity (down) and wind (right) in px/s²; drag per second; easings are CSS timing functions applied over each particle’s life.",
                    "required": [
                      "shape",
                      "x",
                      "y",
                      "width",
                      "height",
                      "angle",
                      "rate",
                      "burst",
                      "life",
                      "lifeVar",
                      "direction",
                      "spread",
                      "outward",
                      "speed",
                      "speedVar",
                      "gravity",
                      "wind",
                      "drag",
                      "sizeStart",
                      "sizeEnd",
                      "sizeVar",
                      "sizeEase",
                      "colorStart",
                      "colorEnd",
                      "colorEase",
                      "opacityStart",
                      "opacityEnd",
                      "opacityEase",
                      "style",
                      "seed",
                      "loop",
                      "prewarm"
                    ],
                    "properties": {
                      "shape": {
                        "enum": [
                          "point",
                          "line",
                          "rect",
                          "ellipse",
                          "ring"
                        ]
                      },
                      "x": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "y": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "width": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1600
                      },
                      "height": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1600
                      },
                      "angle": {
                        "type": "number",
                        "minimum": -180,
                        "maximum": 180,
                        "description": "Emitter rotation in degrees (line and rectangle)."
                      },
                      "rate": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 2000,
                        "description": "Particles per second."
                      },
                      "burst": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 2000,
                        "description": "Particles emitted at time 0 (ignored when looping)."
                      },
                      "life": {
                        "type": "number",
                        "minimum": 0.05,
                        "maximum": 20,
                        "description": "Seconds."
                      },
                      "lifeVar": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "direction": {
                        "type": "number",
                        "minimum": -360,
                        "maximum": 360,
                        "description": "Degrees; 0 = right, 90 = up."
                      },
                      "spread": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 360
                      },
                      "outward": {
                        "type": "boolean",
                        "description": "Shapes with an area or outline throw particles away from their centre."
                      },
                      "speed": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 5000
                      },
                      "speedVar": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "gravity": {
                        "type": "number",
                        "minimum": -5000,
                        "maximum": 5000
                      },
                      "wind": {
                        "type": "number",
                        "minimum": -5000,
                        "maximum": 5000
                      },
                      "drag": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 20
                      },
                      "sizeStart": {
                        "type": "number",
                        "minimum": 1,
                        "maximum": 100
                      },
                      "sizeEnd": {
                        "type": "number",
                        "minimum": 1,
                        "maximum": 100
                      },
                      "sizeVar": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "sizeEase": {
                        "type": "string",
                        "maxLength": 200
                      },
                      "colorStart": {
                        "type": "string",
                        "pattern": "^#[0-9a-fA-F]{6}$"
                      },
                      "colorEnd": {
                        "type": "string",
                        "pattern": "^#[0-9a-fA-F]{6}$"
                      },
                      "colorEase": {
                        "type": "string",
                        "maxLength": 200
                      },
                      "opacityStart": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "opacityEnd": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                      },
                      "opacityEase": {
                        "type": "string",
                        "maxLength": 200
                      },
                      "style": {
                        "enum": [
                          "dot",
                          "glow"
                        ]
                      },
                      "seed": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 4294967295
                      },
                      "loop": {
                        "type": "boolean"
                      },
                      "prewarm": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 20,
                        "description": "Seconds simulated before the first frame (non-looping emitters)."
                      }
                    }
                  }
                }
              },
              "sequence": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "artifactId",
                  "filename",
                  "mime",
                  "bytes",
                  "sha256",
                  "path"
                ],
                "properties": {
                  "artifactId": {
                    "type": "string"
                  },
                  "filename": {
                    "type": "string"
                  },
                  "mime": {
                    "type": "string"
                  },
                  "bytes": {
                    "type": "integer"
                  },
                  "sha256": {
                    "type": "string"
                  },
                  "path": {
                    "type": "string",
                    "description": "Download path on the same site (valid for about 2 hours)."
                  }
                }
              },
              "project": {
                "anyOf": [
                  {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "format",
                      "version",
                      "name",
                      "width",
                      "height",
                      "fps",
                      "background",
                      "transparent",
                      "frames",
                      "layers"
                    ],
                    "properties": {
                      "format": {
                        "const": "flipline"
                      },
                      "version": {
                        "enum": [
                          1,
                          2
                        ],
                        "description": "1 = drawings only; 2 = with camera, guides and/or particle emitters (required when any is present)."
                      },
                      "particles": {
                        "type": "array",
                        "maxItems": 4,
                        "description": "Emitter settings behind generated particle layers (version 2).",
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "layer",
                            "frames",
                            "emitter"
                          ],
                          "properties": {
                            "layer": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "frames": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 24
                            },
                            "emitter": {
                              "type": "object",
                              "additionalProperties": false,
                              "description": "Seeded particle emitter. Positions x/y are normalized to the canvas; width/height/size in pixels; speed in px/s; gravity (down) and wind (right) in px/s²; drag per second; easings are CSS timing functions applied over each particle’s life.",
                              "required": [
                                "shape",
                                "x",
                                "y",
                                "width",
                                "height",
                                "angle",
                                "rate",
                                "burst",
                                "life",
                                "lifeVar",
                                "direction",
                                "spread",
                                "outward",
                                "speed",
                                "speedVar",
                                "gravity",
                                "wind",
                                "drag",
                                "sizeStart",
                                "sizeEnd",
                                "sizeVar",
                                "sizeEase",
                                "colorStart",
                                "colorEnd",
                                "colorEase",
                                "opacityStart",
                                "opacityEnd",
                                "opacityEase",
                                "style",
                                "seed",
                                "loop",
                                "prewarm"
                              ],
                              "properties": {
                                "shape": {
                                  "enum": [
                                    "point",
                                    "line",
                                    "rect",
                                    "ellipse",
                                    "ring"
                                  ]
                                },
                                "x": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "y": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "width": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1600
                                },
                                "height": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1600
                                },
                                "angle": {
                                  "type": "number",
                                  "minimum": -180,
                                  "maximum": 180,
                                  "description": "Emitter rotation in degrees (line and rectangle)."
                                },
                                "rate": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 2000,
                                  "description": "Particles per second."
                                },
                                "burst": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 2000,
                                  "description": "Particles emitted at time 0 (ignored when looping)."
                                },
                                "life": {
                                  "type": "number",
                                  "minimum": 0.05,
                                  "maximum": 20,
                                  "description": "Seconds."
                                },
                                "lifeVar": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "direction": {
                                  "type": "number",
                                  "minimum": -360,
                                  "maximum": 360,
                                  "description": "Degrees; 0 = right, 90 = up."
                                },
                                "spread": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 360
                                },
                                "outward": {
                                  "type": "boolean",
                                  "description": "Shapes with an area or outline throw particles away from their centre."
                                },
                                "speed": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 5000
                                },
                                "speedVar": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "gravity": {
                                  "type": "number",
                                  "minimum": -5000,
                                  "maximum": 5000
                                },
                                "wind": {
                                  "type": "number",
                                  "minimum": -5000,
                                  "maximum": 5000
                                },
                                "drag": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 20
                                },
                                "sizeStart": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 100
                                },
                                "sizeEnd": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 100
                                },
                                "sizeVar": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "sizeEase": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "colorStart": {
                                  "type": "string",
                                  "pattern": "^#[0-9a-fA-F]{6}$"
                                },
                                "colorEnd": {
                                  "type": "string",
                                  "pattern": "^#[0-9a-fA-F]{6}$"
                                },
                                "colorEase": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "opacityStart": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "opacityEnd": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "opacityEase": {
                                  "type": "string",
                                  "maxLength": 200
                                },
                                "style": {
                                  "enum": [
                                    "dot",
                                    "glow"
                                  ]
                                },
                                "seed": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 4294967295
                                },
                                "loop": {
                                  "type": "boolean"
                                },
                                "prewarm": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 20,
                                  "description": "Seconds simulated before the first frame (non-looping emitters)."
                                }
                              }
                            }
                          }
                        }
                      },
                      "camera": {
                        "type": "object",
                        "additionalProperties": false,
                        "required": [
                          "keys"
                        ],
                        "description": "Camera column: keyed poses on timeline ticks (x/y view centre as a fraction of the canvas, zoom 1 = whole canvas, roll in degrees). The camera holds the first pose before the first key and the last pose after the last key.",
                        "properties": {
                          "keys": {
                            "type": "array",
                            "minItems": 1,
                            "maxItems": 48,
                            "items": {
                              "type": "object",
                              "additionalProperties": false,
                              "required": [
                                "tick",
                                "x",
                                "y",
                                "zoom",
                                "rotation",
                                "ease"
                              ],
                              "properties": {
                                "tick": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 239,
                                  "description": "0-based timeline tick."
                                },
                                "x": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "y": {
                                  "type": "number",
                                  "minimum": 0,
                                  "maximum": 1
                                },
                                "zoom": {
                                  "type": "number",
                                  "minimum": 1,
                                  "maximum": 8
                                },
                                "rotation": {
                                  "type": "number",
                                  "minimum": -180,
                                  "maximum": 180
                                },
                                "ease": {
                                  "oneOf": [
                                    {
                                      "enum": [
                                        "linear",
                                        "ease",
                                        "ease-in",
                                        "ease-out",
                                        "ease-in-out",
                                        "hold"
                                      ]
                                    },
                                    {
                                      "type": "array",
                                      "minItems": 4,
                                      "maxItems": 4,
                                      "items": {
                                        "type": "number"
                                      }
                                    }
                                  ],
                                  "description": "Easing from this key to the next key."
                                }
                              }
                            }
                          }
                        }
                      },
                      "guides": {
                        "type": "object",
                        "additionalProperties": false,
                        "description": "Drawing guides saved with the project (version 2).",
                        "properties": {
                          "perspective": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                              "visible",
                              "snap",
                              "points",
                              "horizon",
                              "first",
                              "second"
                            ],
                            "properties": {
                              "visible": {
                                "type": "boolean"
                              },
                              "snap": {
                                "type": "boolean"
                              },
                              "points": {
                                "enum": [
                                  1,
                                  2
                                ]
                              },
                              "horizon": {
                                "type": "number",
                                "minimum": -2,
                                "maximum": 3,
                                "description": "Horizon height as a fraction of the canvas height (0 = top)."
                              },
                              "first": {
                                "type": "number",
                                "minimum": -2,
                                "maximum": 3,
                                "description": "First vanishing point as a fraction of the canvas width."
                              },
                              "second": {
                                "type": "number",
                                "minimum": -2,
                                "maximum": 3,
                                "description": "Second vanishing point (used when points = 2)."
                              }
                            }
                          },
                          "grid": {
                            "type": "object",
                            "additionalProperties": false,
                            "required": [
                              "visible",
                              "snap"
                            ],
                            "properties": {
                              "visible": {
                                "type": "boolean"
                              },
                              "snap": {
                                "type": "boolean"
                              }
                            }
                          }
                        }
                      },
                      "name": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "width": {
                        "type": "integer",
                        "minimum": 32,
                        "maximum": 1600
                      },
                      "height": {
                        "type": "integer",
                        "minimum": 32,
                        "maximum": 1600
                      },
                      "fps": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 30
                      },
                      "background": {
                        "type": "string",
                        "pattern": "^#[a-fA-F0-9]{6}$"
                      },
                      "transparent": {
                        "type": "boolean"
                      },
                      "paper": {
                        "enum": [
                          "plain",
                          "grain",
                          "linen"
                        ]
                      },
                      "frames": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 24,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "id",
                            "hold",
                            "label"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "hold": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 10
                            },
                            "label": {
                              "type": "string",
                              "maxLength": 80
                            }
                          }
                        }
                      },
                      "layers": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 4,
                        "items": {
                          "type": "object",
                          "additionalProperties": false,
                          "required": [
                            "id",
                            "name",
                            "visible",
                            "locked",
                            "opacity",
                            "cels"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 80
                            },
                            "visible": {
                              "type": "boolean"
                            },
                            "locked": {
                              "type": "boolean"
                            },
                            "opacity": {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            "cels": {
                              "type": "array",
                              "minItems": 1,
                              "maxItems": 24,
                              "items": {
                                "type": "array",
                                "maxItems": 500,
                                "items": {
                                  "type": "object",
                                  "additionalProperties": false,
                                  "required": [
                                    "id",
                                    "kind",
                                    "points",
                                    "color",
                                    "size",
                                    "fill"
                                  ],
                                  "properties": {
                                    "brush": {
                                      "type": "object",
                                      "additionalProperties": false,
                                      "required": [
                                        "kind",
                                        "opacity",
                                        "flow",
                                        "spacing",
                                        "texture",
                                        "pressure",
                                        "seed"
                                      ],
                                      "properties": {
                                        "kind": {
                                          "enum": [
                                            "ink",
                                            "pencil",
                                            "marker",
                                            "wash",
                                            "airbrush",
                                            "watercolor"
                                          ]
                                        },
                                        "opacity": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "flow": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "spacing": {
                                          "type": "number",
                                          "minimum": 0.08,
                                          "maximum": 1
                                        },
                                        "texture": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        },
                                        "pressure": {
                                          "type": "boolean"
                                        },
                                        "seed": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 4294967295
                                        },
                                        "wet": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1,
                                          "description": "Watercolor only: edge darkening."
                                        },
                                        "granulation": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1,
                                          "description": "Watercolor only: pigment settling into the paper grain."
                                        },
                                        "pooling": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1,
                                          "description": "Watercolor only: pigment pooling where the stroke ends."
                                        }
                                      }
                                    },
                                    "pressures": {
                                      "type": "array",
                                      "minItems": 1,
                                      "maxItems": 4096,
                                      "items": {
                                        "type": "number",
                                        "minimum": 0,
                                        "maximum": 1
                                      }
                                    },
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 80
                                    },
                                    "kind": {
                                      "enum": [
                                        "pen",
                                        "eraser",
                                        "line",
                                        "rect",
                                        "ellipse",
                                        "image"
                                      ]
                                    },
                                    "points": {
                                      "type": "array",
                                      "minItems": 1,
                                      "maxItems": 4096,
                                      "items": {
                                        "type": "array",
                                        "minItems": 2,
                                        "maxItems": 2,
                                        "items": {
                                          "type": "number",
                                          "minimum": 0,
                                          "maximum": 1
                                        }
                                      }
                                    },
                                    "color": {
                                      "type": "string",
                                      "pattern": "^#[a-fA-F0-9]{6}$"
                                    },
                                    "size": {
                                      "type": "number",
                                      "minimum": 1,
                                      "maximum": 100
                                    },
                                    "fill": {
                                      "type": "boolean"
                                    },
                                    "source": {
                                      "type": "string",
                                      "pattern": "^data:image/(png|jpeg|webp);base64,[A-Za-z0-9+/=]+$"
                                    },
                                    "angle": {
                                      "type": "number",
                                      "minimum": -360,
                                      "maximum": 360,
                                      "description": "Clockwise rotation in degrees around the center of the mark bounds (normalized to -180…180)."
                                    },
                                    "flipX": {
                                      "type": "boolean",
                                      "description": "Mirror horizontally around the mark center."
                                    },
                                    "flipY": {
                                      "type": "boolean",
                                      "description": "Mirror vertically around the mark center."
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "description": "Normalized drawing coordinates. Each layer has one cel per frame. At most 2 MP canvas, 50000 points, 2000 marks and 8 million embedded source characters in total. Image/shape marks require two points; IDs are unique within their collection. Optional angle/flipX/flipY transform a mark around the center of its point bounds."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "projectError": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "openInApp": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "units": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "assumptions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string"
                },
                "url": {
                  "type": "string"
                },
                "publisher": {
                  "type": "string"
                },
                "retrievedAt": {
                  "type": "string"
                },
                "note": {
                  "type": "string"
                }
              }
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "presentation": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Display blocks used by the human page (same data)."
          },
          "links": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "human",
              "api",
              "openapi",
              "methodology"
            ],
            "properties": {
              "human": {
                "type": "string",
                "format": "uri"
              },
              "api": {
                "type": "string",
                "format": "uri"
              },
              "openapi": {
                "type": "string",
                "format": "uri"
              },
              "methodology": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      }
    }
  }
}