buttery 0.2.0__tar.gz

buttery-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: sudo apt-get update -qq && sudo apt-get install -y -qq libegl1 libgl1 libfontconfig1 ffmpeg   # skia-python + mp4 tests
+      - run: uv sync
+      - run: uv run pytest -q

buttery-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,32 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/buttery/
+    permissions:
+      id-token: write   # OIDC token for PyPI trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

buttery-0.2.0/.gitignore

@@ -0,0 +1,12 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+out/
+*.mp4
+*.mov
+.pytest_cache/
+.env
+.env.*

buttery-0.2.0/.python-version

@@ -0,0 +1 @@
+3.13

buttery-0.2.0/BUILD_LOG.md

@@ -0,0 +1,34 @@
+# How v1 was written
+
+Order of work, bottom up. Each step was smoke-tested before the next.
+
+1. **Read the spec, check the toolchain.** uv, Python 3.13, ffmpeg, and whether skia-python has a macOS arm64 wheel. Spun up a scratch venv and drew one circle with skia to confirm array export and PNG encoding. Discovered the MCP SDK is 2.x (`MCPServer`, not `FastMCP`).
+
+2. **Scaffold.** `pyproject.toml` (hatchling, `src/` layout, `animator` console script), `.python-version`, `.gitignore`, `uv sync`.
+
+3. **Leaf modules, no dependencies.**
+   - `color.py`: hex and CSS-name parsing, lerp, hex output, a pydantic `Color` type.
+   - `easing.py`: the seven easing curves.
+   - `ops.py`: numeric implementations and arity table for the op vocabulary, including the 1D value noise.
+
+4. **Expression AST** (`expr.py`). `Ref`, `Op`, `Tween` as pydantic models with a shared operator-overloading mixin so `0.2 * sin(6 * T)` builds the same tree as the JSON. `Expr` is a discriminated union with a before-validator that parses strings. Sugar functions (`T`, `sin`, `tween`, `keyframes`, ...) and `deps()`.
+
+5. **Shorthand parser** (`parse.py`). Tokenizer plus recursive descent for `+ - * /`, unary minus, calls, `pi`/`tau`, references. Folds constant sub-expressions.
+   *Smoke test here:* Python vs JSON trees equal, parse errors readable. Hit and fixed a forward-ref problem by defining `Expr` after the node classes.
+
+6. **Objects and scene.**
+   - `errors.py`: `SceneError` (path, message, object, property, t) and conversion of pydantic errors into that shape.
+   - `objects.py`: `Circle Rect Line Text Group`, positional `id`, `obj.ref.prop` proxy, `animatable()` introspection via a `Kind` marker in the annotations.
+   - `evaluate.py`: compile each expression to a closure, topological order, `CompiledScene.state(t)`.
+   - `scene.py`: `Scene` model, `check()` for ids / references / cycles / tween kinds, JSON load and save, `state()`.
+   *Smoke test here:* state at t, JSON round trip, every error class.
+
+7. **Renderer** (`render.py`). Skia rasterizer in world units with y up, fill/stroke paints, cap-height-centered text, group transforms, sub-frame motion blur, PNG encode, parallel render with a process pool, ffmpeg for mp4. Looked at a preview and a blurred frame to confirm orientation and blur.
+
+8. **Agent surface.** `tools.py` (four functions, JSON in and out, all exceptions caught into structured errors), `cli.py`, `mcp_server.py`. Ran a full mp4 render from the CLI and listed tools through the MCP server in-process.
+
+9. **Tests** (`tests/`): expressions and parser, scene validation and evaluation, rendering and tools. Fixed the deprecated default typeface with a font fallback chain.
+
+10. **Examples, skill, README.** `examples/bounce.py`, `examples/launch_demo.json`, `skill/SKILL.md` and `reference.md`, this file.
+
+- **Renamed to `buttery`** (2026-09-07). Package dir, pyproject name/script, imports, CLI, skill, README, examples, tests. The `animator` references above are historical.

buttery-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fletcher Graham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

buttery-0.2.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.5
+Name: buttery
+Version: 0.2.0
+Summary: Agent-friendly 2D explainer animations. The scene is a pure function of time.
+Project-URL: Homepage, https://github.com/fletchgraham/buttery
+Project-URL: Repository, https://github.com/fletchgraham/buttery
+Project-URL: Issues, https://github.com/fletchgraham/buttery/issues
+Author: Fletcher Graham
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 2d,agent,animation,explainer,mcp,motion-graphics,skia
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.11
+Requires-Dist: mcp>=2.0
+Requires-Dist: numpy>=1.26
+Requires-Dist: pydantic>=2.10
+Requires-Dist: skia-python>=138
+Description-Content-Type: text/markdown
+
+# buttery
+
+Agent-friendly 2D explainer animations. **The scene is a pure function of time**: `state(t)` resolves every
+property at `t`, nothing accumulates between frames, every frame renders independently and in parallel.
+
+Pydantic models *are* the schema. JSON is the product contract; the Python API is sugar over the same models.
+
+![Merging two sorted lists, one comparison per beat](https://raw.githubusercontent.com/fletchgraham/buttery/main/examples/merge_sorted.gif)
+
+*`examples/merge_sorted.py`: the merge is simulated in Python, then each step becomes keyframes.*
+
+![Red-black tree left rotation, one step at a time](https://raw.githubusercontent.com/fletchgraham/buttery/main/examples/rb_rotation.gif)
+
+*`examples/rb_rotation.py`: nodes are groups, edges are lines whose endpoints reference the nodes, so the
+edges follow the rotation for free. The before/after trees are two tuples; the script diffs them.*
+
+```
+Agent tool surface   validate / state / preview / render     (tools.py, cli.py, mcp_server.py)
+Authoring            Python sugar  <->  JSON                 (objects.py, expr.py, parse.py)
+Core                 Scene, primitives, expression DAG       (scene.py, evaluate.py)
+Renderer             skia-python, motion blur via sub-frames  (render.py)
+```
+
+## Install
+
+```bash
+pip install buttery    # or: uv add buttery
+brew install ffmpeg    # for .mp4 output (PNG sequences work without it)
+```
+
+The renderer is skia-python, which ships large platform wheels; expect a heavier install than the code size suggests.
+
+From a clone:
+
+```bash
+uv sync                # Python 3.11+, pydantic, skia-python, numpy, mcp
+uv run pytest
+```
+
+## Python
+
+```python
+from buttery import *
+
+dot = Circle("dot", r=0.3, fill="coral")
+dot.x = tween(-3, 3, at=0, dur=1.5, ease="out_cubic")
+dot.y = 0.2 * sin(6 * T)
+
+ring = Circle("ring", fill=None, stroke="white")
+ring.x = dot.ref.x
+ring.r = dot.ref.r + 0.5
+
+scene = Scene(duration=3).add(dot, ring, Text("label", content="Hello", y=-1.6))
+scene.state(1.0)                       # plain data
+scene.preview(1.0, path="p.png")       # quick low-res PNG
+scene.render("out.mp4")                # motion blur, all cores, ffmpeg
+scene.save("scene.json")               # the same thing as JSON
+```
+
+`obj.prop` reads the stored expression; `obj.ref.prop` makes a reference to it (the spec's `dot.r + 0.5`
+became `dot.ref.r + 0.5` because a plain attribute read cannot be both a value and a reference).
+
+## JSON
+
+```json
+{
+  "duration": 3,
+  "objects": [
+    {"id": "dot", "type": "circle", "r": 0.3, "fill": "coral",
+     "x": {"op": "tween", "keys": [[0, -3], [1.5, 3]], "ease": "out_cubic"},
+     "y": {"op": "mul", "args": [0.2, {"op": "sin", "args": [{"op": "mul", "args": [6, "t"]}]}]}},
+    {"id": "ring", "type": "circle", "fill": null, "stroke": "white", "x": "dot.x", "r": "dot.r + 0.5"}
+  ]
+}
+```
+
+Shorthand strings like `"dot.r + 0.5"` parse (no `eval`) into the same op tree. `uv run buttery schema`
+prints the JSON schema from `Scene.model_json_schema()`.
+
+**Coordinates**: world units, origin at center, y up. The frame is `view_width` (default 8) units wide.
+**Primitives**: `circle rect line text group`. `text` wraps at `max_width` and honors newlines. **Ops**: `add sub mul div neg sin cos abs min max clamp smoothstep noise`.
+**Eases**: `linear in_quad out_quad in_out_quad out_cubic in_out_cubic spring`. Colors: hex or CSS names;
+`fill`/`stroke` can be tweened between colors.
+
+## Agent surface
+
+```bash
+uv run buttery validate scene.json
+uv run buttery state scene.json --t 1.25
+uv run buttery preview scene.json --t 1.25 --out p.png --scale 0.25
+uv run buttery render scene.json out.mp4 [--no-motion-blur --samples 8 --shutter 0.5 --workers N]
+uv run buttery mcp            # MCP server on stdio: same four tools + scene://schema resource
+```
+
+Every call returns `{"ok": true, ...}` or `{"ok": false, "errors": [{"path", "message", "object", "property", "t"}]}`.
+Never a bare stack trace.
+
+Claude Code skill: `skill/` (symlink or copy it into `~/.claude/skills/buttery`). Register the MCP server with
+`claude mcp add buttery -- uv run --directory /path/to/this/repo buttery mcp`.
+Or from the published packages, no checkout needed: `claude mcp add buttery -- npx -y buttery-mcp`
+(the [`buttery-mcp`](https://www.npmjs.com/package/buttery-mcp) npm shim runs `uvx buttery mcp`; see `npm/`).
+
+## Validation and evaluation rules
+
+- Structural validation is pydantic (unknown fields rejected, arity checked, colors checked).
+- Semantic validation: unique ids (global across groups), references resolve to numeric animatable
+  properties, no dependency cycles, tween key kinds match the property kind.
+- Evaluation compiles each expression to a closure once, walks the DAG in dependency order, and never mutates the scene.
+- Motion blur: `samples` sub-frames spread across `shutter` × frame interval, averaged (0.5 = 180° shutter).
+
+## Layout
+
+```
+src/buttery/
+  expr.py        AST models (Op, Tween, Ref), operator overloading, sugar (T, sin, tween, keyframes, ...)
+  parse.py       shorthand parser -> AST, constant folding
+  objects.py     Circle, Rect, Line, Text, Group
+  scene.py       Scene, semantic checks, state(t)
+  evaluate.py    compile + topological evaluation
+  render.py      skia rasterizer, motion blur, parallel render, ffmpeg
+  tools.py       validate / state / preview / render (JSON in, JSON out)
+  cli.py         `buttery` command
+  mcp_server.py  MCP server
+examples/        bounce.py, squash_bounce.py, merge_sorted.py, rb_rotation.py (Python) and their .json, launch_demo.json
+skill/           Claude Code skill
+tests/
+```
+
+## Not in v1
+
+Equations/LaTeX, 3D or cameras, GUI, audio, plugins, manim parity.

buttery-0.2.0/README.md

@@ -0,0 +1,131 @@
+# buttery
+
+Agent-friendly 2D explainer animations. **The scene is a pure function of time**: `state(t)` resolves every
+property at `t`, nothing accumulates between frames, every frame renders independently and in parallel.
+
+Pydantic models *are* the schema. JSON is the product contract; the Python API is sugar over the same models.
+
+![Merging two sorted lists, one comparison per beat](https://raw.githubusercontent.com/fletchgraham/buttery/main/examples/merge_sorted.gif)
+
+*`examples/merge_sorted.py`: the merge is simulated in Python, then each step becomes keyframes.*
+
+![Red-black tree left rotation, one step at a time](https://raw.githubusercontent.com/fletchgraham/buttery/main/examples/rb_rotation.gif)
+
+*`examples/rb_rotation.py`: nodes are groups, edges are lines whose endpoints reference the nodes, so the
+edges follow the rotation for free. The before/after trees are two tuples; the script diffs them.*
+
+```
+Agent tool surface   validate / state / preview / render     (tools.py, cli.py, mcp_server.py)
+Authoring            Python sugar  <->  JSON                 (objects.py, expr.py, parse.py)
+Core                 Scene, primitives, expression DAG       (scene.py, evaluate.py)
+Renderer             skia-python, motion blur via sub-frames  (render.py)
+```
+
+## Install
+
+```bash
+pip install buttery    # or: uv add buttery
+brew install ffmpeg    # for .mp4 output (PNG sequences work without it)
+```
+
+The renderer is skia-python, which ships large platform wheels; expect a heavier install than the code size suggests.
+
+From a clone:
+
+```bash
+uv sync                # Python 3.11+, pydantic, skia-python, numpy, mcp
+uv run pytest
+```
+
+## Python
+
+```python
+from buttery import *
+
+dot = Circle("dot", r=0.3, fill="coral")
+dot.x = tween(-3, 3, at=0, dur=1.5, ease="out_cubic")
+dot.y = 0.2 * sin(6 * T)
+
+ring = Circle("ring", fill=None, stroke="white")
+ring.x = dot.ref.x
+ring.r = dot.ref.r + 0.5
+
+scene = Scene(duration=3).add(dot, ring, Text("label", content="Hello", y=-1.6))
+scene.state(1.0)                       # plain data
+scene.preview(1.0, path="p.png")       # quick low-res PNG
+scene.render("out.mp4")                # motion blur, all cores, ffmpeg
+scene.save("scene.json")               # the same thing as JSON
+```
+
+`obj.prop` reads the stored expression; `obj.ref.prop` makes a reference to it (the spec's `dot.r + 0.5`
+became `dot.ref.r + 0.5` because a plain attribute read cannot be both a value and a reference).
+
+## JSON
+
+```json
+{
+  "duration": 3,
+  "objects": [
+    {"id": "dot", "type": "circle", "r": 0.3, "fill": "coral",
+     "x": {"op": "tween", "keys": [[0, -3], [1.5, 3]], "ease": "out_cubic"},
+     "y": {"op": "mul", "args": [0.2, {"op": "sin", "args": [{"op": "mul", "args": [6, "t"]}]}]}},
+    {"id": "ring", "type": "circle", "fill": null, "stroke": "white", "x": "dot.x", "r": "dot.r + 0.5"}
+  ]
+}
+```
+
+Shorthand strings like `"dot.r + 0.5"` parse (no `eval`) into the same op tree. `uv run buttery schema`
+prints the JSON schema from `Scene.model_json_schema()`.
+
+**Coordinates**: world units, origin at center, y up. The frame is `view_width` (default 8) units wide.
+**Primitives**: `circle rect line text group`. `text` wraps at `max_width` and honors newlines. **Ops**: `add sub mul div neg sin cos abs min max clamp smoothstep noise`.
+**Eases**: `linear in_quad out_quad in_out_quad out_cubic in_out_cubic spring`. Colors: hex or CSS names;
+`fill`/`stroke` can be tweened between colors.
+
+## Agent surface
+
+```bash
+uv run buttery validate scene.json
+uv run buttery state scene.json --t 1.25
+uv run buttery preview scene.json --t 1.25 --out p.png --scale 0.25
+uv run buttery render scene.json out.mp4 [--no-motion-blur --samples 8 --shutter 0.5 --workers N]
+uv run buttery mcp            # MCP server on stdio: same four tools + scene://schema resource
+```
+
+Every call returns `{"ok": true, ...}` or `{"ok": false, "errors": [{"path", "message", "object", "property", "t"}]}`.
+Never a bare stack trace.
+
+Claude Code skill: `skill/` (symlink or copy it into `~/.claude/skills/buttery`). Register the MCP server with
+`claude mcp add buttery -- uv run --directory /path/to/this/repo buttery mcp`.
+Or from the published packages, no checkout needed: `claude mcp add buttery -- npx -y buttery-mcp`
+(the [`buttery-mcp`](https://www.npmjs.com/package/buttery-mcp) npm shim runs `uvx buttery mcp`; see `npm/`).
+
+## Validation and evaluation rules
+
+- Structural validation is pydantic (unknown fields rejected, arity checked, colors checked).
+- Semantic validation: unique ids (global across groups), references resolve to numeric animatable
+  properties, no dependency cycles, tween key kinds match the property kind.
+- Evaluation compiles each expression to a closure once, walks the DAG in dependency order, and never mutates the scene.
+- Motion blur: `samples` sub-frames spread across `shutter` × frame interval, averaged (0.5 = 180° shutter).
+
+## Layout
+
+```
+src/buttery/
+  expr.py        AST models (Op, Tween, Ref), operator overloading, sugar (T, sin, tween, keyframes, ...)
+  parse.py       shorthand parser -> AST, constant folding
+  objects.py     Circle, Rect, Line, Text, Group
+  scene.py       Scene, semantic checks, state(t)
+  evaluate.py    compile + topological evaluation
+  render.py      skia rasterizer, motion blur, parallel render, ffmpeg
+  tools.py       validate / state / preview / render (JSON in, JSON out)
+  cli.py         `buttery` command
+  mcp_server.py  MCP server
+examples/        bounce.py, squash_bounce.py, merge_sorted.py, rb_rotation.py (Python) and their .json, launch_demo.json
+skill/           Claude Code skill
+tests/
+```
+
+## Not in v1
+
+Equations/LaTeX, 3D or cameras, GUI, audio, plugins, manim parity.

buttery-0.2.0/examples/bounce.json

@@ -0,0 +1,114 @@
+{
+  "size": [
+    1920,
+    1080
+  ],
+  "fps": 60,
+  "duration": 3.0,
+  "background": "#111111",
+  "view_width": 8.0,
+  "objects": [
+    {
+      "id": "dot",
+      "opacity": 1.0,
+      "type": "circle",
+      "x": {
+        "op": "tween",
+        "keys": [
+          [
+            0.0,
+            -3.0
+          ],
+          [
+            1.5,
+            3.0
+          ]
+        ],
+        "ease": "out_cubic"
+      },
+      "y": {
+        "op": "mul",
+        "args": [
+          0.2,
+          {
+            "op": "sin",
+            "args": [
+              {
+                "op": "mul",
+                "args": [
+                  6.0,
+                  "t"
+                ]
+              }
+            ]
+          }
+        ]
+      },
+      "r": 0.3,
+      "fill": "coral",
+      "stroke": null,
+      "stroke_width": 0.05
+    },
+    {
+      "id": "ring",
+      "opacity": {
+        "op": "tween",
+        "keys": [
+          [
+            0.0,
+            0.0
+          ],
+          [
+            0.5,
+            1.0
+          ],
+          [
+            2.5,
+            1.0
+          ],
+          [
+            3.0,
+            0.0
+          ]
+        ],
+        "ease": "linear"
+      },
+      "type": "circle",
+      "x": "dot.x",
+      "y": 0.0,
+      "r": {
+        "op": "add",
+        "args": [
+          "dot.r",
+          0.5
+        ]
+      },
+      "fill": null,
+      "stroke": "white",
+      "stroke_width": 0.04
+    },
+    {
+      "id": "floor",
+      "opacity": 1.0,
+      "type": "line",
+      "x1": -3.5,
+      "y1": -0.6,
+      "x2": 3.5,
+      "y2": -0.6,
+      "stroke": "#444444",
+      "stroke_width": 0.03
+    },
+    {
+      "id": "label",
+      "opacity": 1.0,
+      "type": "text",
+      "content": "state(t) is a pure function",
+      "x": 0.0,
+      "y": -1.6,
+      "size": 0.4,
+      "fill": "#cccccc",
+      "font": null,
+      "align": "center"
+    }
+  ]
+}

buttery-0.2.0/examples/bounce.py

@@ -0,0 +1,23 @@
+"""Python sugar example. Run: uv run python examples/bounce.py"""
+
+from buttery import Circle, Line, Scene, T, Text, keyframes, sin, tween
+
+dot = Circle("dot", r=0.3, fill="coral")
+dot.x = tween(-3, 3, at=0, dur=1.5, ease="out_cubic")
+dot.y = 0.2 * sin(6 * T)
+
+ring = Circle("ring", fill=None, stroke="white", stroke_width=0.04)
+ring.x = dot.ref.x
+ring.r = dot.ref.r + 0.5
+ring.opacity = keyframes({0: 0, 0.5: 1, 2.5: 1, 3: 0})
+
+floor = Line("floor", x1=-3.5, y1=-0.6, x2=3.5, y2=-0.6, stroke="#444444", stroke_width=0.03)
+label = Text("label", content="state(t) is a pure function", y=-1.6, size=0.4, fill="#cccccc")
+
+scene = Scene(duration=3).add(dot, ring, floor, label)
+
+if __name__ == "__main__":
+    scene.save("examples/bounce.json")
+    print(scene.state(1.0))
+    scene.preview(1.0, path="examples/bounce_preview.png")
+    print(scene.render("examples/bounce.mp4"))

buttery-0.2.0/examples/launch_demo.json

@@ -0,0 +1,26 @@
+{
+  "duration": 5,
+  "fps": 60,
+  "size": [1920, 1080],
+  "background": "#0e0e11",
+  "objects": [
+    {"id": "track", "type": "line", "x1": -3.2, "y1": -0.9, "x2": 3.2, "y2": -0.9, "stroke": "#2a2a30", "stroke_width": 0.04},
+    {"id": "ball", "type": "circle", "r": 0.35, "fill": "#ff7f50",
+     "x": {"op": "tween", "keys": [[0.4, -3], [1.8, 2.4], [3.2, -1.0], [4.4, 3]], "ease": "in_out_cubic"},
+     "y": {"op": "add", "args": [-0.55, {"op": "mul", "args": [0.9, {"op": "abs", "args": [{"op": "sin", "args": ["4*t"]}]}]}]}},
+    {"id": "shadow", "type": "rect", "x": "ball.x", "y": -0.92, "h": 0.06, "corner_radius": 0.03, "fill": "#000000",
+     "w": {"op": "sub", "args": [1.2, {"op": "mul", "args": [0.5, {"op": "add", "args": ["ball.y", 0.55]}]}]},
+     "opacity": {"op": "sub", "args": [0.7, {"op": "mul", "args": [0.4, {"op": "add", "args": ["ball.y", 0.55]}]}]}},
+    {"id": "box", "type": "rect", "w": 0.9, "h": 0.9, "corner_radius": 0.12, "x": 2.2, "y": 1.1, "fill": "#4a90d9",
+     "rotation": {"op": "tween", "keys": [[1, 0], [2.5, 180]], "ease": "spring"},
+     "opacity": {"op": "tween", "keys": [[0.8, 0], [1.2, 1]]}},
+    {"id": "orbit", "type": "group", "x": -2.2, "y": 1.1, "rotation": "90*t", "children": [
+      {"id": "o1", "type": "circle", "x": 0.6, "r": 0.12, "fill": "#ffd166"},
+      {"id": "o2", "type": "circle", "x": -0.6, "r": 0.12, "fill": "#06d6a0"},
+      {"id": "o3", "type": "circle", "y": 0.6, "r": 0.12, "fill": "#ef476f"},
+      {"id": "o4", "type": "circle", "y": -0.6, "r": 0.12, "fill": "#118ab2"}
+    ]},
+    {"id": "title", "type": "text", "content": "Eased motion, real motion blur", "y": -1.7, "size": 0.42,
+     "fill": {"op": "tween", "keys": [[0, "#0e0e11"], [1, "#e8e8ec"]], "ease": "out_quad"}}
+  ]
+}