← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Nov 7, 2026 · 00:09 UTC · version 2.4.0

Collection source: downloaded plugin package.

WHAT CHANGED

Instructions updated for linked-element-motion

Skill instructions — Now says: ported-from: layout-choreography 1.7 at 55.75.0 - Text boxes are metric envelopes, not glyph bounds.

Observed in instructions or declared skills. Runtime behavior has not been tested.

Save Picsart and check future changes in Following.

Up to 3 plugins free · no card required.

All fields and original values.

Skill instructions

Before

Nov 3, 2026 · 18:14 UTC

- **Engines.** `native` (default) resolves the authored scene directly. With `v3`, text boxes are font-metric envelopes; with `jet`, text has no measured box, center, rotation or `onCanvas` and is noted. Geometry can differ between e...

After

Nov 7, 2026 · 00:09 UTC

ported-from: layout-choreography 1.7 at 55.75.0 - Text boxes are metric envelopes, not glyph bounds.

Compare saved observations

Download comparison JSON

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -4,6 +4,7 @@
 metadata:
   category: authoring
   version: '1.7'
+  ported-from: layout-choreography 1.7 at 55.75.0
 ---
 
 # Layout relationships through motion
@@ -184,9 +185,6 @@
   envelope, the projected center and `depth`, and no `rotationDeg`; `onCanvas` reads the envelope.
   A layer reaching the camera's eye has no geometry and is noted. A composition in depth paints
   far to near, so `zIndex` follows depth there.
-- **Engines.** `native` (default) resolves the authored scene directly. With `v3`, text boxes are
-  font-metric envelopes; with `jet`, text has no measured box, center, rotation or `onCanvas`
-  and is noted. Geometry can differ between engines.
 - The query may fetch referenced scenes, fonts and caption transcripts through guarded
   public-URL reads; it saves no report file. It certifies no effects, assets or codecs: look at
   rendered frames before export.
@@ -323,7 +321,7 @@
 - **`allow`** moves the named pairs to `allowed`, keeping their class, and clears a covered layer
   whose every cover is allowed. An entry that never overlaps is reported as stale.
 - **`mostlyOffCanvas`** lists root layers whose best visible share stayed below half.
-- Text boxes are metric envelopes, not glyph bounds; with `engine:"jet"` text is unmeasured.
+- Text boxes are metric envelopes, not glyph bounds.
 - Findings never fail the call. Bad options, a bad window and query errors do.
 
 Sampling is bounded to 600 samples per call: a window that needs more, at the default 0.25 s step
Full technical diff · 1 changed fields

changed /skill_md_contents

BEFORE
"---\nname: linked-element-motion\ndescription: Keep related scene elements aligned and moving together, including container resizing, shared fades, content reveals and sibling reflow. Use when labels detach, companions fade separately, panels fail to grow, content overflows, or an outside object must join a template at a particular time and remain attached.\nmetadata:\n  category: authoring\n  version: '1.7'\n---\n\n# Layout relationships through motion\n\nServed checks: `picsart_scene_check_contracts` runs contract records and reusable templates, `picsart_scene_check_motion` runs frame-complete motion records, and `picsart_scene_inspect` pages large sources; the one remaining limit is that pixel records have no automated checker, so inspect full-resolution rendered frames for them.\n\nEditable layers are not necessarily independent motion units. Before animating, state which things\nbelong together, which may change internally, and what must make room when new content appears.\n\n## Construct the relationship before checking it\n\nChoose the construction from how long the relationship must hold:\n\n- **Always one motion unit:** put the plate, label and icon in one composition/scene reference;\n  animate that owner once. Leave children in local coordinates. Use `parentId` for transform-only\n  ownership when appropriate; it does not inherit opacity or lifetime. A shared fade belongs on\n  the enclosing composition owner. Do not copy the same travel/press/exit tracks onto every child.\n- **Always one layout rule:** declare shared width, height, padding and offsets, then derive the\n  backing size and child placement from them. In a parameterized scene, use `$eval` expressions\n  such as `height / 2` for the label center as well as the backing center. Resizing an instance\n  then changes one binding instead of several unrelated coordinates. `$eval` resolves parameters;\n  it is not a per-frame read of another layer's animated geometry.\n- **A property follows another each frame:** use the supported Lua property-read API when the\n  dependency is needed and a common owner is insufficient. Fetch `scene-animation-reference` for syntax,\n  scope, coordinate and clock limits. Keep the dependency one-way; do not invent reactive fields\n  or use another layer's local placement as if it were a root-space painted center.\n- **Related only during a phase:** keep intentional independent motion, derive the attached phase\n  from one path/progress source, and declare when it releases. Use time-windowed contracts for\n  those phases and inspect the handoff. Static parenting is not an animated reparenting switch.\n\nContracts verify the construction; they do not create the relationship. For a simple rigid widget,\nprefer one owner and a shared sizing formula over independent tracks plus many corrective checks.\nStill verify initial layout, realistic parameter edits and the final painted result: parenting can\npreserve an incorrect offset, and a shared formula can encode the wrong design.\n\n## Assign motion and layout ownership\n\n| Relationship | Authoring choice | Evidence |\n|---|---|---|\n| Panel + label + icon travel together | One inline composition or supported parent rig; common transform on the owner | Constant relative offsets during translation; inspect scale/rotation separately |\n| Badge enters inside a moving card | Common card placement plus deliberate badge-local entrance | Card trajectory plus badge's local event window |\n| Panel grows for another row | Animate panel geometry independently from text; move following rows/siblings explicitly | Fixed edge, attached gaps and padded containment throughout resize |\n| Whole unit changes scale | Scale the semantic group intentionally | Text, stroke and corner appearance in rendered frames |\n| Same object crosses a scene boundary | Keep the owner alive across the seam | Presence window and continuous video |\n| Label on a plane in depth | Label is a child of the plane by `parentId`, no `z` of its own; titles over the scene are `cameraExempt: true` roots | `picsart_scene_lint_layout`: the label absent from `covered`, `order` on `depth`/`y` for the planes; rendered frame at the held camera: label on its plane, in front of it |\n\nRecord a component's common owner, members, entry/exit window and deliberate local exceptions\nbefore animating. A local badge reveal can differ; a whole-card exit belongs to the owner. Derive\nchecks from this intent, not only from the final tracks: copied mistakes should not define success.\n\nGrouping is a transform/ownership mechanism, **not an automatic content-sized layout solver**.\nscene does not infer “this label belongs to that box” from spatial proximity. A validator accepting\nindependent layers does not mean they obey the designer's relationship. Do not invent a CSS auto-layout\nfield or duplicate identical keyframes on every child as the default substitute for a common owner.\n\nRead the current `composition`, `parentId` and transform schema before building a rig. Child coordinates\nmust be authored in the chosen owner's space; use a query to confirm the first child before copying\nthe pattern. Use stable ids and query-returned composition scopes for repeated instances.\nFor a sized inline composition, its width/height define its own raster, not necessarily its drawn\nsize in the host. Use explicit bounds or `fit: \"none\"` when it should draw at its own size; otherwise\ndefault fitting can enlarge the whole card. Validate and query this before adding motion.\n\nFor a join between an outside object and a template, query the assembled host at the intended\nroot-time event before writing the approach. The existing destination can be measured before the\nsource exists. Use root geometry to derive the missing object's placement in its own parent space,\nthen re-query both; one snapshot does not create persistent following. Fetch `scene-template-remix`\nand its **content replacement and template handoffs** reference for content replacement, clock/space conversion,\npost-arrival ownership and same-time versus cross-time checks.\n\n## Plan resize and reveal as one event\n\n1. Name the event and its time: “the details row appears and the panel makes room.” Record old and new\n   content extents, padding, minimum readable area, and which edge stays fixed.\n2. Choose behavior: reserve space from the start, resize before/during reveal, or deliberately clip/scroll.\n   These are different designs. Never make accidental clipping masquerade as a reveal.\n3. Measure final text using the actual font and wrap width; use `picsart_scene_query_layout`, not character count.\n   Calculate required container extent from visible child bounds + padding in a consistent space.\n4. Author a shared progress/timing schedule for background size, sibling reflow and reveal. With a fixed\n   top edge, a height increase of Δh needs a center shift of Δh/2. With centered growth, no shift is needed.\n   Animate the supported shape geometry or the background's own scale/position, not the text-bearing\n   group, unless scaling the text is intended. Background scaling can distort corners/strokes—inspect it.\n5. Reveal only when there is room at **every relevant intermediate time**. Matching end states is not\n   enough: different easing curves can make content overtake the growing panel. Keep readable holds.\n6. Recompute after text, font, padding, duration or component-size edits. Do not promise automatic reflow\n   from one hard-coded demonstration.\n\n## Declare what the tooling should check\n\n### Translate design intent into assertions\n\nFor each intended relationship, record **targets, expected relation, phase/root times, tolerance,\nassertion and uncovered visual evidence**. Choose these from the design before using the measured\nresult as evidence. An unasserted relationship remains unchecked even when every existing contract\npasses. A centered label needs alignment checks as well as containment; constant relative motion\ncan preserve an initially wrong offset.\n\nFor buttons, chips, labels and icons, read [UI alignment contracts](references/ui-alignment.md).\nThrough MCP, fetch `picsart_scene_recipe` with `name:\"linked-element-motion\"` and\n`reference:\"references/ui-alignment.md\"`. It contains a runnable example and a deliberately\nmisaligned negative control, plus guidance for moving, resized and nested controls. Use one\nrepresentative negative control when introducing a new relationship check; do not change the\nexpected values to make the broken variant pass.\n\n### Relationships that change over time\n\nHierarchy expresses ownership; a contract expresses intent during a chosen interval. A badge can\nstay in one card, travel freely, then belong visually to another card without dynamic reparenting.\nWrite the intended phases and exceptions before keyframes. Map those semantic roles to actual query\nids/scopes after assembly. Do not derive the expected result from the tracks being tested.\n\nFor repeatable validation, keep a separate JSON sidecar as a record of independent design intent, not an extra scene field. The following record for `source`, `destination` and `badge` runs with `picsart_scene_check_contracts`; read pass, fail or inconclusive per contract and report any unexecuted assertions as unchecked.\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"before-transfer\",\n      \"description\": \"Badge stays in source until departure; 2–3s is independent travel.\",\n      \"window\": { \"start\": 0, \"end\": 2, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"source\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"after-transfer\",\n      \"window\": { \"start\": 3, \"end\": 5, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"destination\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"arrival-carrier\",\n      \"boundary\": { \"at\": 3, \"delta\": 0.03333333333333333 },\n      \"assert\": { \"kind\": \"present\", \"members\": [{ \"id\": \"badge\" }] }\n    }\n  ]\n}\n```\n\nEach contract has a stable id, one assertion and an explicit root-time schedule. Window ends are exclusive; boundary observations include before, exactly at, and after the event. A cross-time handoff compares separately chosen moments; see `motion-scene-continuity` for the intended geometry and limits. Retiming requires rebasing all relevant windows. For reusable expected values and affine clock mapping, read [reusable contracts](references/reusable-contracts.md). `picsart_scene_check_contracts` runs these documents directly, or resolves a reusable `template` with `targets`, `numbers` and optional `clock` and returns the `resolved` document beside the verdicts. Query comparisons outside its vocabulary explicitly without presenting them as checker verdicts.\n\nUse `present` if a member must exist, not only `contains`: containment can legitimately skip a member\noutside its lifetime. `co_presence` checks intended joint geometric lifetime, not visual opacity.\n`translation` requires fixed sizes/rotations; `contains` can check explicitly resizing unrotated boxes.\nDuring a free-travel phase, omitting containment is deliberate **unchecked coverage**, not proof the\npath is safe. Add a presence contract if disappearance must be caught during that travel.\n\nRead each named verdict, requested `sampleTimes`, `issues` and failure `evidence` (expected assertion\nplus observed member/anchor geometry). The top-level `sampleTimes` lists actually queried times.\nOutside-scene requested samples produce `inconclusive`, not a clipped pass; a measured violation\nstill produces `fail`. `maxErrorPx:0` does not mean a presence assertion passed. Missing/ambiguous\ngeometry is not evidence of correctness. Hashes identify supplied JSON, not remote media contents.\n\nRead `coverage` as a scope inventory. Its target `checks` say which assertion kinds/channels were\nrequested; `resolvedSamples` only means a unique target was found, not that it passed all geometry\nor motion checks. `observedUntargetedLayers` names returned non-internal layers never explicitly\ntargeted, including children whose owner alone was checked. Review these against the intended\nrelationships; decorative layers need not all acquire contracts. Missing/ambiguous/unavailable\ncounts, omission counts and unchecked intervals belong in the handoff. There is no whole-scene\ncoverage percentage, and no proof between sampled times.\n\nKeep all intended relationships in the handoff, split by meaningful beats. A successful tool call is not proof that its checks passed: read each available result and distinguish pass, fail and inconclusive evidence. Do not invent a contract report; report the verdicts `picsart_scene_check_contracts` returned.\n\n### Reading a `picsart_scene_query_layout` report\n\nOne moment, one report. What its fields do and do not say:\n\n- **Opacity.** `opacity` is the layer's evaluated opacity; `effectiveOpacity` multiplies it\n  through enclosing compositions, not transform-only `parentId` links. Neither is painted alpha.\n  An absent value means the build could not evaluate it, not that the layer is opaque.\n- **Ids.** Every id is a `picsart_scene_patch` layer address, except layers inside a referenced\n  scene (edit them through `scope`) and `internal: true` implementation layers. Named track and\n  mask clips keep their own id; other nested children are `host__child`.\n- **Activity.** An inactive layer has `active: false` and no box, but held content can keep its\n  geometry while inactive. Audio `volume` is in percent.\n- **Bounds** are conservative layer geometry, not painted pixels: transparent shape branches\n  still count. Degenerate boxes come with a note.\n- **Perspective.** A layer drawn through its composition's perspective camera reports `quad`\n  (its four projected corners, top-left first in its own corner order), `box`/`aabb` as their\n  envelope, the projected center and `depth`, and no `rotationDeg`; `onCanvas` reads the envelope.\n  A layer reaching the camera's eye has no geometry and is noted. A composition in depth paints\n  far to near, so `zIndex` follows depth there.\n- **Engines.** `native` (default) resolves the authored scene directly. With `v3`, text boxes are\n  font-metric envelopes; with `jet`, text has no measured box, center, rotation or `onCanvas`\n  and is noted. Geometry can differ between engines.\n- The query may fetch referenced scenes, fonts and caption transcripts through guarded\n  public-URL reads; it saves no report file. It certifies no effects, assets or codecs: look at\n  rendered frames before export.\n\n### One-off checks and collision scanning\n\nAfter `picsart_scene_validate`, get actual ids/scopes with `picsart_scene_query_layout`. Then call `picsart_scene_lint_layout`\nwith the scene, a narrow `t0`/`t1` window, a useful `step`, and explicit relationships, for example:\n\n```json\n{\n  \"t0\": 0.8,\n  \"t1\": 1.8,\n  \"step\": 0.03333333333333333,\n  \"relationships\": [\n    { \"kind\": \"present\", \"members\": [{ \"id\": \"card\" }] },\n    { \"kind\": \"co_presence\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }] },\n    { \"kind\": \"translation\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }], \"tolerancePx\": 1 },\n    { \"kind\": \"contains\", \"anchor\": { \"id\": \"panel-bg\" }, \"members\": [{ \"id\": \"new-row\" }], \"paddingPx\": 16 }\n  ]\n}\n```\n\nThese are alternatives for appropriate targets/windows, not a requirement that a growing panel also\npasses the translation check. `translation` only measures constant relative center offsets with\nunchanged sizes/rotations; resizing or rotating rigs are **inconclusive**, not broken by definition.\n`contains` uses unclipped unrotated boxes so a clip cannot hide overflow. `present` requires geometric\npresence at each sample; `co_presence` compares member/anchor geometric presence, catching different\nlifetimes or departures. Use the latter only in a window where simultaneous presence is intended;\nexclude deliberate local entrances. At least one jointly present sample is required per member.\nNeither check measures opacity: a fully faded layer may still have geometry and `visible:true`.\nFor a shared fade, put opacity on the common composition owner and inspect child-local exceptions.\nTransform-only `parentId` links do not propagate opacity. Add `composition` for ambiguous ids.\nMissing geometry is inconclusive; a never-measured member cannot pass.\n\n### Matching fades, separately from presence\n\nWhen companions should have the **same evaluated layer opacity** during a shared event, add this\nassertion to a named contract's window (or to a one-off lint call):\n\n```json\n{ \"kind\": \"opacity_match\", \"anchor\": { \"id\": \"card__background\" }, \"members\": [{ \"id\": \"card__label\" }], \"toleranceOpacity\": 0.01 }\n```\n\nIt compares `effectiveOpacity`: evaluated layer opacity multiplied through enclosing compositions,\nnot transform-only parents. Query reports also expose local `opacity`, so a mismatch can be traced\nto an owner or a child-local fade. Use equal-opacity companions; a deliberately translucent label\nor independent reveal should not be constrained to match its opaque background. Scope the check to\nthe shared event rather than suppressing an intentional earlier difference with a large tolerance.\n\nRead `maxErrorOpacity` and timestamped evidence, not `maxErrorPx`. Tolerance is an absolute opacity\ndifference (default 0.01), not pixels or a timing tolerance. Missing evaluated opacity—older query\nbuilds or an unavailable layer state—makes the check inconclusive, never implicitly opaque or zero.\nTwo zeros match: this check alone does not require visible content or prove a desired fade happened.\nPair it with the declared geometric lifetime checks and inspect the fade window in a preview.\nMasks, source alpha, effects, occlusion and missing decoded media can still change painted visibility.\n\n### Fixed edges and attached content during resize\n\nContainment alone can pass while a panel's fixed edge drifts or an internal gap grows incorrectly.\nDo not use `translation` on a growing panel: it requires unchanged sizes. Instead declare expected\nedges/gaps from the design, not from the first measured frame. This complete sidecar assumes a\npanel whose top must stay at root y=40 and a footer whose top follows 12 px below its bottom:\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"panel-fixed-top\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"fixed_edge\", \"members\": [{ \"id\": \"panel\" }], \"edge\": \"top\", \"valuePx\": 40, \"tolerancePx\": 1 }\n    },\n    {\n      \"id\": \"footer-follows-growth\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"edge_attachment\", \"anchor\": { \"id\": \"panel\" }, \"members\": [{ \"id\": \"footer\" }], \"edge\": \"top\", \"anchorEdge\": \"bottom\", \"gapPx\": 12, \"tolerancePx\": 1 }\n    }\n  ]\n}\n```\n\nBoth assertions also work in `picsart_scene_lint_layout.relationships`. Edges are `left`, `right`, `top`,\n`bottom` of **unclipped, unrotated root-space boxes**, not a local parent frame. Attachment edges\nmust share an axis. Its signed gap is **member edge minus anchor edge**: a row bottom 20 px above\nthe panel bottom uses `edge:\"bottom\", anchorEdge:\"bottom\", gapPx:-20`. An inset header top 20 px\nbelow the panel top uses both `top` edges and `gapPx:20`. `fixed_edge.valuePx` is an explicit root\ncoordinate, including negative values; neither check learns a passing baseline from the scene.\n\nSizes may change. Each sampled member (and attachment anchor) must have measured on-canvas geometry;\nknown absence fails, while missing/ambiguous/unmeasured/rotated geometry is inconclusive. A held\nframe with `active:false` can still have usable geometry. Any measured violation keeps the verdict\n`fail` even when another observation is unavailable. Scope checks to the phase where the relationship\nis intended; a later independent departure needs a separate window, not a relaxed tolerance.\n\nRead timestamped `issues`/`evidence` and `measurement:{actualPx,expectedPx}` for a mismatch. For fixed\nedges these are root coordinates; for attachments they are signed gaps. `maxErrorPx` is their absolute\ndifference and `tolerancePx` defaults to 1. Matching endpoints can hide intermediate easing errors:\nsample through the growth/reveal, not only before and after it.\n\nA vertical attachment says nothing about horizontal alignment, containment or paint. Add the other\naxis or padded `contains` assertion when intended. These checks validate authored reflow; they do\nnot compute layout, scale text, or prove a reveal is readable. Still inspect intermediate frames.\n\nSampling includes `t0` and excludes `t1` (and the composition end); to inspect a seam,\nplace it on the sample grid and extend `t1` beyond it. Query the exact seam separately if needed.\n\nRead `relationships` independently of collision `findings`. `allow` only acknowledges deliberate\noverlap; it does not waive a relationship. A violation reports the input index, worst measured time,\npixel error and bounded issues. Missing measurements report `inconclusive`. Lint never fixes the scene.\n\n### Reading the overlap report\n\nOverlap candidates are visible on-canvas layers with geometry (held frames too) in the same\ncomposition scope; nested wrappers use their painted child bounds. Each overlapping pair is\nclassified:\n\n| Class | When | Where it lands |\n|---|---|---|\n| backdrop | the lower layer covers 85%+ of the canvas | `intentional` |\n| containment | 90%+ coverage for 80% of the shared time | `intentional` |\n| transient | overlapping for under 0.4 s | `info` |\n| collision | sustained overlap at or above `iou` (default 0.05) | `findings` |\n| graze | sustained overlap below `iou` | `info` |\n\n- **Layers in depth** overlap on their projected quads, in each sample's paint order. A collision\n  between two planes of a perspective camera stays a finding, annotated `depthStacked {near, far}`:\n  judge it yourself, with `covered` as the hidden-text check.\n- **`covered`** lists layers left under half visible at some sample by layers drawn after them, in\n  any composition, that the document states opaque (alpha and `effectiveOpacity` 0.98+): a color, a\n  JPEG or MP4 picture, a filled rectangle. A text layer under half visible for 0.4 s or more is a\n  finding; anything else is info. A cover the document does not state opaque is noted unmeasured.\n- **`allow`** moves the named pairs to `allowed`, keeping their class, and clears a covered layer\n  whose every cover is allowed. An entry that never overlaps is reported as stale.\n- **`mostlyOffCanvas`** lists root layers whose best visible share stayed below half.\n- Text boxes are metric envelopes, not glyph bounds; with `engine:\"jet\"` text is unmeasured.\n- Findings never fail the call. Bad options, a bad window and query errors do.\n\nSampling is bounded to 600 samples per call: a window that needs more, at the default 0.25 s step\nor an explicit one, is refused with the smallest step that fits. It can miss a brief violation. Use windows around event/seam\ntimes and frame-spaced samples; include before, during and settled states. Then inspect\n`picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions and continuous scene video. Geometry alone cannot judge smoothness, painted\nocclusion, typography or whether the story is understandable.\n\nFor timing syntax use scene-animation-reference (fetch with `picsart_scene_recipe`, name `scene-animation-reference`); for interactive causality\nuse app-ui-animation (fetch with `picsart_scene_recipe`, name `app-ui-animation`); for big compositions use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`).\n\n**Research note:** independently authored for scene from the observed authoring failure modes and\ngeneral motion/layout principles. This is not an imported Hyperframes implementation.\n"
AFTER
"---\nname: linked-element-motion\ndescription: Keep related scene elements aligned and moving together, including container resizing, shared fades, content reveals and sibling reflow. Use when labels detach, companions fade separately, panels fail to grow, content overflows, or an outside object must join a template at a particular time and remain attached.\nmetadata:\n  category: authoring\n  version: '1.7'\n  ported-from: layout-choreography 1.7 at 55.75.0\n---\n\n# Layout relationships through motion\n\nServed checks: `picsart_scene_check_contracts` runs contract records and reusable templates, `picsart_scene_check_motion` runs frame-complete motion records, and `picsart_scene_inspect` pages large sources; the one remaining limit is that pixel records have no automated checker, so inspect full-resolution rendered frames for them.\n\nEditable layers are not necessarily independent motion units. Before animating, state which things\nbelong together, which may change internally, and what must make room when new content appears.\n\n## Construct the relationship before checking it\n\nChoose the construction from how long the relationship must hold:\n\n- **Always one motion unit:** put the plate, label and icon in one composition/scene reference;\n  animate that owner once. Leave children in local coordinates. Use `parentId` for transform-only\n  ownership when appropriate; it does not inherit opacity or lifetime. A shared fade belongs on\n  the enclosing composition owner. Do not copy the same travel/press/exit tracks onto every child.\n- **Always one layout rule:** declare shared width, height, padding and offsets, then derive the\n  backing size and child placement from them. In a parameterized scene, use `$eval` expressions\n  such as `height / 2` for the label center as well as the backing center. Resizing an instance\n  then changes one binding instead of several unrelated coordinates. `$eval` resolves parameters;\n  it is not a per-frame read of another layer's animated geometry.\n- **A property follows another each frame:** use the supported Lua property-read API when the\n  dependency is needed and a common owner is insufficient. Fetch `scene-animation-reference` for syntax,\n  scope, coordinate and clock limits. Keep the dependency one-way; do not invent reactive fields\n  or use another layer's local placement as if it were a root-space painted center.\n- **Related only during a phase:** keep intentional independent motion, derive the attached phase\n  from one path/progress source, and declare when it releases. Use time-windowed contracts for\n  those phases and inspect the handoff. Static parenting is not an animated reparenting switch.\n\nContracts verify the construction; they do not create the relationship. For a simple rigid widget,\nprefer one owner and a shared sizing formula over independent tracks plus many corrective checks.\nStill verify initial layout, realistic parameter edits and the final painted result: parenting can\npreserve an incorrect offset, and a shared formula can encode the wrong design.\n\n## Assign motion and layout ownership\n\n| Relationship | Authoring choice | Evidence |\n|---|---|---|\n| Panel + label + icon travel together | One inline composition or supported parent rig; common transform on the owner | Constant relative offsets during translation; inspect scale/rotation separately |\n| Badge enters inside a moving card | Common card placement plus deliberate badge-local entrance | Card trajectory plus badge's local event window |\n| Panel grows for another row | Animate panel geometry independently from text; move following rows/siblings explicitly | Fixed edge, attached gaps and padded containment throughout resize |\n| Whole unit changes scale | Scale the semantic group intentionally | Text, stroke and corner appearance in rendered frames |\n| Same object crosses a scene boundary | Keep the owner alive across the seam | Presence window and continuous video |\n| Label on a plane in depth | Label is a child of the plane by `parentId`, no `z` of its own; titles over the scene are `cameraExempt: true` roots | `picsart_scene_lint_layout`: the label absent from `covered`, `order` on `depth`/`y` for the planes; rendered frame at the held camera: label on its plane, in front of it |\n\nRecord a component's common owner, members, entry/exit window and deliberate local exceptions\nbefore animating. A local badge reveal can differ; a whole-card exit belongs to the owner. Derive\nchecks from this intent, not only from the final tracks: copied mistakes should not define success.\n\nGrouping is a transform/ownership mechanism, **not an automatic content-sized layout solver**.\nscene does not infer “this label belongs to that box” from spatial proximity. A validator accepting\nindependent layers does not mean they obey the designer's relationship. Do not invent a CSS auto-layout\nfield or duplicate identical keyframes on every child as the default substitute for a common owner.\n\nRead the current `composition`, `parentId` and transform schema before building a rig. Child coordinates\nmust be authored in the chosen owner's space; use a query to confirm the first child before copying\nthe pattern. Use stable ids and query-returned composition scopes for repeated instances.\nFor a sized inline composition, its width/height define its own raster, not necessarily its drawn\nsize in the host. Use explicit bounds or `fit: \"none\"` when it should draw at its own size; otherwise\ndefault fitting can enlarge the whole card. Validate and query this before adding motion.\n\nFor a join between an outside object and a template, query the assembled host at the intended\nroot-time event before writing the approach. The existing destination can be measured before the\nsource exists. Use root geometry to derive the missing object's placement in its own parent space,\nthen re-query both; one snapshot does not create persistent following. Fetch `scene-template-remix`\nand its **content replacement and template handoffs** reference for content replacement, clock/space conversion,\npost-arrival ownership and same-time versus cross-time checks.\n\n## Plan resize and reveal as one event\n\n1. Name the event and its time: “the details row appears and the panel makes room.” Record old and new\n   content extents, padding, minimum readable area, and which edge stays fixed.\n2. Choose behavior: reserve space from the start, resize before/during reveal, or deliberately clip/scroll.\n   These are different designs. Never make accidental clipping masquerade as a reveal.\n3. Measure final text using the actual font and wrap width; use `picsart_scene_query_layout`, not character count.\n   Calculate required container extent from visible child bounds + padding in a consistent space.\n4. Author a shared progress/timing schedule for background size, sibling reflow and reveal. With a fixed\n   top edge, a height increase of Δh needs a center shift of Δh/2. With centered growth, no shift is needed.\n   Animate the supported shape geometry or the background's own scale/position, not the text-bearing\n   group, unless scaling the text is intended. Background scaling can distort corners/strokes—inspect it.\n5. Reveal only when there is room at **every relevant intermediate time**. Matching end states is not\n   enough: different easing curves can make content overtake the growing panel. Keep readable holds.\n6. Recompute after text, font, padding, duration or component-size edits. Do not promise automatic reflow\n   from one hard-coded demonstration.\n\n## Declare what the tooling should check\n\n### Translate design intent into assertions\n\nFor each intended relationship, record **targets, expected relation, phase/root times, tolerance,\nassertion and uncovered visual evidence**. Choose these from the design before using the measured\nresult as evidence. An unasserted relationship remains unchecked even when every existing contract\npasses. A centered label needs alignment checks as well as containment; constant relative motion\ncan preserve an initially wrong offset.\n\nFor buttons, chips, labels and icons, read [UI alignment contracts](references/ui-alignment.md).\nThrough MCP, fetch `picsart_scene_recipe` with `name:\"linked-element-motion\"` and\n`reference:\"references/ui-alignment.md\"`. It contains a runnable example and a deliberately\nmisaligned negative control, plus guidance for moving, resized and nested controls. Use one\nrepresentative negative control when introducing a new relationship check; do not change the\nexpected values to make the broken variant pass.\n\n### Relationships that change over time\n\nHierarchy expresses ownership; a contract expresses intent during a chosen interval. A badge can\nstay in one card, travel freely, then belong visually to another card without dynamic reparenting.\nWrite the intended phases and exceptions before keyframes. Map those semantic roles to actual query\nids/scopes after assembly. Do not derive the expected result from the tracks being tested.\n\nFor repeatable validation, keep a separate JSON sidecar as a record of independent design intent, not an extra scene field. The following record for `source`, `destination` and `badge` runs with `picsart_scene_check_contracts`; read pass, fail or inconclusive per contract and report any unexecuted assertions as unchecked.\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"before-transfer\",\n      \"description\": \"Badge stays in source until departure; 2–3s is independent travel.\",\n      \"window\": { \"start\": 0, \"end\": 2, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"source\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"after-transfer\",\n      \"window\": { \"start\": 3, \"end\": 5, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"destination\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"arrival-carrier\",\n      \"boundary\": { \"at\": 3, \"delta\": 0.03333333333333333 },\n      \"assert\": { \"kind\": \"present\", \"members\": [{ \"id\": \"badge\" }] }\n    }\n  ]\n}\n```\n\nEach contract has a stable id, one assertion and an explicit root-time schedule. Window ends are exclusive; boundary observations include before, exactly at, and after the event. A cross-time handoff compares separately chosen moments; see `motion-scene-continuity` for the intended geometry and limits. Retiming requires rebasing all relevant windows. For reusable expected values and affine clock mapping, read [reusable contracts](references/reusable-contracts.md). `picsart_scene_check_contracts` runs these documents directly, or resolves a reusable `template` with `targets`, `numbers` and optional `clock` and returns the `resolved` document beside the verdicts. Query comparisons outside its vocabulary explicitly without presenting them as checker verdicts.\n\nUse `present` if a member must exist, not only `contains`: containment can legitimately skip a member\noutside its lifetime. `co_presence` checks intended joint geometric lifetime, not visual opacity.\n`translation` requires fixed sizes/rotations; `contains` can check explicitly resizing unrotated boxes.\nDuring a free-travel phase, omitting containment is deliberate **unchecked coverage**, not proof the\npath is safe. Add a presence contract if disappearance must be caught during that travel.\n\nRead each named verdict, requested `sampleTimes`, `issues` and failure `evidence` (expected assertion\nplus observed member/anchor geometry). The top-level `sampleTimes` lists actually queried times.\nOutside-scene requested samples produce `inconclusive`, not a clipped pass; a measured violation\nstill produces `fail`. `maxErrorPx:0` does not mean a presence assertion passed. Missing/ambiguous\ngeometry is not evidence of correctness. Hashes identify supplied JSON, not remote media contents.\n\nRead `coverage` as a scope inventory. Its target `checks` say which assertion kinds/channels were\nrequested; `resolvedSamples` only means a unique target was found, not that it passed all geometry\nor motion checks. `observedUntargetedLayers` names returned non-internal layers never explicitly\ntargeted, including children whose owner alone was checked. Review these against the intended\nrelationships; decorative layers need not all acquire contracts. Missing/ambiguous/unavailable\ncounts, omission counts and unchecked intervals belong in the handoff. There is no whole-scene\ncoverage percentage, and no proof between sampled times.\n\nKeep all intended relationships in the handoff, split by meaningful beats. A successful tool call is not proof that its checks passed: read each available result and distinguish pass, fail and inconclusive evidence. Do not invent a contract report; report the verdicts `picsart_scene_check_contracts` returned.\n\n### Reading a `picsart_scene_query_layout` report\n\nOne moment, one report. What its fields do and do not say:\n\n- **Opacity.** `opacity` is the layer's evaluated opacity; `effectiveOpacity` multiplies it\n  through enclosing compositions, not transform-only `parentId` links. Neither is painted alpha.\n  An absent value means the build could not evaluate it, not that the layer is opaque.\n- **Ids.** Every id is a `picsart_scene_patch` layer address, except layers inside a referenced\n  scene (edit them through `scope`) and `internal: true` implementation layers. Named track and\n  mask clips keep their own id; other nested children are `host__child`.\n- **Activity.** An inactive layer has `active: false` and no box, but held content can keep its\n  geometry while inactive. Audio `volume` is in percent.\n- **Bounds** are conservative layer geometry, not painted pixels: transparent shape branches\n  still count. Degenerate boxes come with a note.\n- **Perspective.** A layer drawn through its composition's perspective camera reports `quad`\n  (its four projected corners, top-left first in its own corner order), `box`/`aabb` as their\n  envelope, the projected center and `depth`, and no `rotationDeg`; `onCanvas` reads the envelope.\n  A layer reaching the camera's eye has no geometry and is noted. A composition in depth paints\n  far to near, so `zIndex` follows depth there.\n- The query may fetch referenced scenes, fonts and caption transcripts through guarded\n  public-URL reads; it saves no report file. It certifies no effects, assets or codecs: look at\n  rendered frames before export.\n\n### One-off checks and collision scanning\n\nAfter `picsart_scene_validate`, get actual ids/scopes with `picsart_scene_query_layout`. Then call `picsart_scene_lint_layout`\nwith the scene, a narrow `t0`/`t1` window, a useful `step`, and explicit relationships, for example:\n\n```json\n{\n  \"t0\": 0.8,\n  \"t1\": 1.8,\n  \"step\": 0.03333333333333333,\n  \"relationships\": [\n    { \"kind\": \"present\", \"members\": [{ \"id\": \"card\" }] },\n    { \"kind\": \"co_presence\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }] },\n    { \"kind\": \"translation\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }], \"tolerancePx\": 1 },\n    { \"kind\": \"contains\", \"anchor\": { \"id\": \"panel-bg\" }, \"members\": [{ \"id\": \"new-row\" }], \"paddingPx\": 16 }\n  ]\n}\n```\n\nThese are alternatives for appropriate targets/windows, not a requirement that a growing panel also\npasses the translation check. `translation` only measures constant relative center offsets with\nunchanged sizes/rotations; resizing or rotating rigs are **inconclusive**, not broken by definition.\n`contains` uses unclipped unrotated boxes so a clip cannot hide overflow. `present` requires geometric\npresence at each sample; `co_presence` compares member/anchor geometric presence, catching different\nlifetimes or departures. Use the latter only in a window where simultaneous presence is intended;\nexclude deliberate local entrances. At least one jointly present sample is required per member.\nNeither check measures opacity: a fully faded layer may still have geometry and `visible:true`.\nFor a shared fade, put opacity on the common composition owner and inspect child-local exceptions.\nTransform-only `parentId` links do not propagate opacity. Add `composition` for ambiguous ids.\nMissing geometry is inconclusive; a never-measured member cannot pass.\n\n### Matching fades, separately from presence\n\nWhen companions should have the **same evaluated layer opacity** during a shared event, add this\nassertion to a named contract's window (or to a one-off lint call):\n\n```json\n{ \"kind\": \"opacity_match\", \"anchor\": { \"id\": \"card__background\" }, \"members\": [{ \"id\": \"card__label\" }], \"toleranceOpacity\": 0.01 }\n```\n\nIt compares `effectiveOpacity`: evaluated layer opacity multiplied through enclosing compositions,\nnot transform-only parents. Query reports also expose local `opacity`, so a mismatch can be traced\nto an owner or a child-local fade. Use equal-opacity companions; a deliberately translucent label\nor independent reveal should not be constrained to match its opaque background. Scope the check to\nthe shared event rather than suppressing an intentional earlier difference with a large tolerance.\n\nRead `maxErrorOpacity` and timestamped evidence, not `maxErrorPx`. Tolerance is an absolute opacity\ndifference (default 0.01), not pixels or a timing tolerance. Missing evaluated opacity—older query\nbuilds or an unavailable layer state—makes the check inconclusive, never implicitly opaque or zero.\nTwo zeros match: this check alone does not require visible content or prove a desired fade happened.\nPair it with the declared geometric lifetime checks and inspect the fade window in a preview.\nMasks, source alpha, effects, occlusion and missing decoded media can still change painted visibility.\n\n### Fixed edges and attached content during resize\n\nContainment alone can pass while a panel's fixed edge drifts or an internal gap grows incorrectly.\nDo not use `translation` on a growing panel: it requires unchanged sizes. Instead declare expected\nedges/gaps from the design, not from the first measured frame. This complete sidecar assumes a\npanel whose top must stay at root y=40 and a footer whose top follows 12 px below its bottom:\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"panel-fixed-top\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"fixed_edge\", \"members\": [{ \"id\": \"panel\" }], \"edge\": \"top\", \"valuePx\": 40, \"tolerancePx\": 1 }\n    },\n    {\n      \"id\": \"footer-follows-growth\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"edge_attachment\", \"anchor\": { \"id\": \"panel\" }, \"members\": [{ \"id\": \"footer\" }], \"edge\": \"top\", \"anchorEdge\": \"bottom\", \"gapPx\": 12, \"tolerancePx\": 1 }\n    }\n  ]\n}\n```\n\nBoth assertions also work in `picsart_scene_lint_layout.relationships`. Edges are `left`, `right`, `top`,\n`bottom` of **unclipped, unrotated root-space boxes**, not a local parent frame. Attachment edges\nmust share an axis. Its signed gap is **member edge minus anchor edge**: a row bottom 20 px above\nthe panel bottom uses `edge:\"bottom\", anchorEdge:\"bottom\", gapPx:-20`. An inset header top 20 px\nbelow the panel top uses both `top` edges and `gapPx:20`. `fixed_edge.valuePx` is an explicit root\ncoordinate, including negative values; neither check learns a passing baseline from the scene.\n\nSizes may change. Each sampled member (and attachment anchor) must have measured on-canvas geometry;\nknown absence fails, while missing/ambiguous/unmeasured/rotated geometry is inconclusive. A held\nframe with `active:false` can still have usable geometry. Any measured violation keeps the verdict\n`fail` even when another observation is unavailable. Scope checks to the phase where the relationship\nis intended; a later independent departure needs a separate window, not a relaxed tolerance.\n\nRead timestamped `issues`/`evidence` and `measurement:{actualPx,expectedPx}` for a mismatch. For fixed\nedges these are root coordinates; for attachments they are signed gaps. `maxErrorPx` is their absolute\ndifference and `tolerancePx` defaults to 1. Matching endpoints can hide intermediate easing errors:\nsample through the growth/reveal, not only before and after it.\n\nA vertical attachment says nothing about horizontal alignment, containment or paint. Add the other\naxis or padded `contains` assertion when intended. These checks validate authored reflow; they do\nnot compute layout, scale text, or prove a reveal is readable. Still inspect intermediate frames.\n\nSampling includes `t0` and excludes `t1` (and the composition end); to inspect a seam,\nplace it on the sample grid and extend `t1` beyond it. Query the exact seam separately if needed.\n\nRead `relationships` independently of collision `findings`. `allow` only acknowledges deliberate\noverlap; it does not waive a relationship. A violation reports the input index, worst measured time,\npixel error and bounded issues. Missing measurements report `inconclusive`. Lint never fixes the scene.\n\n### Reading the overlap report\n\nOverlap candidates are visible on-canvas layers with geometry (held frames too) in the same\ncomposition scope; nested wrappers use their painted child bounds. Each overlapping pair is\nclassified:\n\n| Class | When | Where it lands |\n|---|---|---|\n| backdrop | the lower layer covers 85%+ of the canvas | `intentional` |\n| containment | 90%+ coverage for 80% of the shared time | `intentional` |\n| transient | overlapping for under 0.4 s | `info` |\n| collision | sustained overlap at or above `iou` (default 0.05) | `findings` |\n| graze | sustained overlap below `iou` | `info` |\n\n- **Layers in depth** overlap on their projected quads, in each sample's paint order. A collision\n  between two planes of a perspective camera stays a finding, annotated `depthStacked {near, far}`:\n  judge it yourself, with `covered` as the hidden-text check.\n- **`covered`** lists layers left under half visible at some sample by layers drawn after them, in\n  any composition, that the document states opaque (alpha and `effectiveOpacity` 0.98+): a color, a\n  JPEG or MP4 picture, a filled rectangle. A text layer under half visible for 0.4 s or more is a\n  finding; anything else is info. A cover the document does not state opaque is noted unmeasured.\n- **`allow`** moves the named pairs to `allowed`, keeping their class, and clears a covered layer\n  whose every cover is allowed. An entry that never overlaps is reported as stale.\n- **`mostlyOffCanvas`** lists root layers whose best visible share stayed below half.\n- Text boxes are metric envelopes, not glyph bounds.\n- Findings never fail the call. Bad options, a bad window and query errors do.\n\nSampling is bounded to 600 samples per call: a window that needs more, at the default 0.25 s step\nor an explicit one, is refused with the smallest step that fits. It can miss a brief violation. Use windows around event/seam\ntimes and frame-spaced samples; include before, during and settled states. Then inspect\n`picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions and continuous scene video. Geometry alone cannot judge smoothness, painted\nocclusion, typography or whether the story is understandable.\n\nFor timing syntax use scene-animation-reference (fetch with `picsart_scene_recipe`, name `scene-animation-reference`); for interactive causality\nuse app-ui-animation (fetch with `picsart_scene_recipe`, name `app-ui-animation`); for big compositions use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`).\n\n**Research note:** independently authored for scene from the observed authoring failure modes and\ngeneral motion/layout principles. This is not an imported Hyperframes implementation.\n"
Full snapshot data
{
  "description": "Keep related scene elements aligned and moving together, including container resizing, shared fades, content reveals and sibling reflow. Use when labels detach, companions fade separately, panels fail to grow, content overflows, or an outside object must join a template at a particular time and remain attached.",
  "included_files": [
    {
      "relative_path": "references/reusable-contracts.md",
      "size_in_bytes": 4972
    },
    {
      "relative_path": "references/ui-alignment.md",
      "size_in_bytes": 6561
    }
  ],
  "name": "linked-element-motion",
  "skill_md_contents": "---\nname: linked-element-motion\ndescription: Keep related scene elements aligned and moving together, including container resizing, shared fades, content reveals and sibling reflow. Use when labels detach, companions fade separately, panels fail to grow, content overflows, or an outside object must join a template at a particular time and remain attached.\nmetadata:\n  category: authoring\n  version: '1.7'\n  ported-from: layout-choreography 1.7 at 55.75.0\n---\n\n# Layout relationships through motion\n\nServed checks: `picsart_scene_check_contracts` runs contract records and reusable templates, `picsart_scene_check_motion` runs frame-complete motion records, and `picsart_scene_inspect` pages large sources; the one remaining limit is that pixel records have no automated checker, so inspect full-resolution rendered frames for them.\n\nEditable layers are not necessarily independent motion units. Before animating, state which things\nbelong together, which may change internally, and what must make room when new content appears.\n\n## Construct the relationship before checking it\n\nChoose the construction from how long the relationship must hold:\n\n- **Always one motion unit:** put the plate, label and icon in one composition/scene reference;\n  animate that owner once. Leave children in local coordinates. Use `parentId` for transform-only\n  ownership when appropriate; it does not inherit opacity or lifetime. A shared fade belongs on\n  the enclosing composition owner. Do not copy the same travel/press/exit tracks onto every child.\n- **Always one layout rule:** declare shared width, height, padding and offsets, then derive the\n  backing size and child placement from them. In a parameterized scene, use `$eval` expressions\n  such as `height / 2` for the label center as well as the backing center. Resizing an instance\n  then changes one binding instead of several unrelated coordinates. `$eval` resolves parameters;\n  it is not a per-frame read of another layer's animated geometry.\n- **A property follows another each frame:** use the supported Lua property-read API when the\n  dependency is needed and a common owner is insufficient. Fetch `scene-animation-reference` for syntax,\n  scope, coordinate and clock limits. Keep the dependency one-way; do not invent reactive fields\n  or use another layer's local placement as if it were a root-space painted center.\n- **Related only during a phase:** keep intentional independent motion, derive the attached phase\n  from one path/progress source, and declare when it releases. Use time-windowed contracts for\n  those phases and inspect the handoff. Static parenting is not an animated reparenting switch.\n\nContracts verify the construction; they do not create the relationship. For a simple rigid widget,\nprefer one owner and a shared sizing formula over independent tracks plus many corrective checks.\nStill verify initial layout, realistic parameter edits and the final painted result: parenting can\npreserve an incorrect offset, and a shared formula can encode the wrong design.\n\n## Assign motion and layout ownership\n\n| Relationship | Authoring choice | Evidence |\n|---|---|---|\n| Panel + label + icon travel together | One inline composition or supported parent rig; common transform on the owner | Constant relative offsets during translation; inspect scale/rotation separately |\n| Badge enters inside a moving card | Common card placement plus deliberate badge-local entrance | Card trajectory plus badge's local event window |\n| Panel grows for another row | Animate panel geometry independently from text; move following rows/siblings explicitly | Fixed edge, attached gaps and padded containment throughout resize |\n| Whole unit changes scale | Scale the semantic group intentionally | Text, stroke and corner appearance in rendered frames |\n| Same object crosses a scene boundary | Keep the owner alive across the seam | Presence window and continuous video |\n| Label on a plane in depth | Label is a child of the plane by `parentId`, no `z` of its own; titles over the scene are `cameraExempt: true` roots | `picsart_scene_lint_layout`: the label absent from `covered`, `order` on `depth`/`y` for the planes; rendered frame at the held camera: label on its plane, in front of it |\n\nRecord a component's common owner, members, entry/exit window and deliberate local exceptions\nbefore animating. A local badge reveal can differ; a whole-card exit belongs to the owner. Derive\nchecks from this intent, not only from the final tracks: copied mistakes should not define success.\n\nGrouping is a transform/ownership mechanism, **not an automatic content-sized layout solver**.\nscene does not infer “this label belongs to that box” from spatial proximity. A validator accepting\nindependent layers does not mean they obey the designer's relationship. Do not invent a CSS auto-layout\nfield or duplicate identical keyframes on every child as the default substitute for a common owner.\n\nRead the current `composition`, `parentId` and transform schema before building a rig. Child coordinates\nmust be authored in the chosen owner's space; use a query to confirm the first child before copying\nthe pattern. Use stable ids and query-returned composition scopes for repeated instances.\nFor a sized inline composition, its width/height define its own raster, not necessarily its drawn\nsize in the host. Use explicit bounds or `fit: \"none\"` when it should draw at its own size; otherwise\ndefault fitting can enlarge the whole card. Validate and query this before adding motion.\n\nFor a join between an outside object and a template, query the assembled host at the intended\nroot-time event before writing the approach. The existing destination can be measured before the\nsource exists. Use root geometry to derive the missing object's placement in its own parent space,\nthen re-query both; one snapshot does not create persistent following. Fetch `scene-template-remix`\nand its **content replacement and template handoffs** reference for content replacement, clock/space conversion,\npost-arrival ownership and same-time versus cross-time checks.\n\n## Plan resize and reveal as one event\n\n1. Name the event and its time: “the details row appears and the panel makes room.” Record old and new\n   content extents, padding, minimum readable area, and which edge stays fixed.\n2. Choose behavior: reserve space from the start, resize before/during reveal, or deliberately clip/scroll.\n   These are different designs. Never make accidental clipping masquerade as a reveal.\n3. Measure final text using the actual font and wrap width; use `picsart_scene_query_layout`, not character count.\n   Calculate required container extent from visible child bounds + padding in a consistent space.\n4. Author a shared progress/timing schedule for background size, sibling reflow and reveal. With a fixed\n   top edge, a height increase of Δh needs a center shift of Δh/2. With centered growth, no shift is needed.\n   Animate the supported shape geometry or the background's own scale/position, not the text-bearing\n   group, unless scaling the text is intended. Background scaling can distort corners/strokes—inspect it.\n5. Reveal only when there is room at **every relevant intermediate time**. Matching end states is not\n   enough: different easing curves can make content overtake the growing panel. Keep readable holds.\n6. Recompute after text, font, padding, duration or component-size edits. Do not promise automatic reflow\n   from one hard-coded demonstration.\n\n## Declare what the tooling should check\n\n### Translate design intent into assertions\n\nFor each intended relationship, record **targets, expected relation, phase/root times, tolerance,\nassertion and uncovered visual evidence**. Choose these from the design before using the measured\nresult as evidence. An unasserted relationship remains unchecked even when every existing contract\npasses. A centered label needs alignment checks as well as containment; constant relative motion\ncan preserve an initially wrong offset.\n\nFor buttons, chips, labels and icons, read [UI alignment contracts](references/ui-alignment.md).\nThrough MCP, fetch `picsart_scene_recipe` with `name:\"linked-element-motion\"` and\n`reference:\"references/ui-alignment.md\"`. It contains a runnable example and a deliberately\nmisaligned negative control, plus guidance for moving, resized and nested controls. Use one\nrepresentative negative control when introducing a new relationship check; do not change the\nexpected values to make the broken variant pass.\n\n### Relationships that change over time\n\nHierarchy expresses ownership; a contract expresses intent during a chosen interval. A badge can\nstay in one card, travel freely, then belong visually to another card without dynamic reparenting.\nWrite the intended phases and exceptions before keyframes. Map those semantic roles to actual query\nids/scopes after assembly. Do not derive the expected result from the tracks being tested.\n\nFor repeatable validation, keep a separate JSON sidecar as a record of independent design intent, not an extra scene field. The following record for `source`, `destination` and `badge` runs with `picsart_scene_check_contracts`; read pass, fail or inconclusive per contract and report any unexecuted assertions as unchecked.\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"before-transfer\",\n      \"description\": \"Badge stays in source until departure; 2–3s is independent travel.\",\n      \"window\": { \"start\": 0, \"end\": 2, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"source\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"after-transfer\",\n      \"window\": { \"start\": 3, \"end\": 5, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"contains\", \"anchor\": { \"id\": \"destination\" }, \"members\": [{ \"id\": \"badge\" }], \"paddingPx\": 12 }\n    },\n    {\n      \"id\": \"arrival-carrier\",\n      \"boundary\": { \"at\": 3, \"delta\": 0.03333333333333333 },\n      \"assert\": { \"kind\": \"present\", \"members\": [{ \"id\": \"badge\" }] }\n    }\n  ]\n}\n```\n\nEach contract has a stable id, one assertion and an explicit root-time schedule. Window ends are exclusive; boundary observations include before, exactly at, and after the event. A cross-time handoff compares separately chosen moments; see `motion-scene-continuity` for the intended geometry and limits. Retiming requires rebasing all relevant windows. For reusable expected values and affine clock mapping, read [reusable contracts](references/reusable-contracts.md). `picsart_scene_check_contracts` runs these documents directly, or resolves a reusable `template` with `targets`, `numbers` and optional `clock` and returns the `resolved` document beside the verdicts. Query comparisons outside its vocabulary explicitly without presenting them as checker verdicts.\n\nUse `present` if a member must exist, not only `contains`: containment can legitimately skip a member\noutside its lifetime. `co_presence` checks intended joint geometric lifetime, not visual opacity.\n`translation` requires fixed sizes/rotations; `contains` can check explicitly resizing unrotated boxes.\nDuring a free-travel phase, omitting containment is deliberate **unchecked coverage**, not proof the\npath is safe. Add a presence contract if disappearance must be caught during that travel.\n\nRead each named verdict, requested `sampleTimes`, `issues` and failure `evidence` (expected assertion\nplus observed member/anchor geometry). The top-level `sampleTimes` lists actually queried times.\nOutside-scene requested samples produce `inconclusive`, not a clipped pass; a measured violation\nstill produces `fail`. `maxErrorPx:0` does not mean a presence assertion passed. Missing/ambiguous\ngeometry is not evidence of correctness. Hashes identify supplied JSON, not remote media contents.\n\nRead `coverage` as a scope inventory. Its target `checks` say which assertion kinds/channels were\nrequested; `resolvedSamples` only means a unique target was found, not that it passed all geometry\nor motion checks. `observedUntargetedLayers` names returned non-internal layers never explicitly\ntargeted, including children whose owner alone was checked. Review these against the intended\nrelationships; decorative layers need not all acquire contracts. Missing/ambiguous/unavailable\ncounts, omission counts and unchecked intervals belong in the handoff. There is no whole-scene\ncoverage percentage, and no proof between sampled times.\n\nKeep all intended relationships in the handoff, split by meaningful beats. A successful tool call is not proof that its checks passed: read each available result and distinguish pass, fail and inconclusive evidence. Do not invent a contract report; report the verdicts `picsart_scene_check_contracts` returned.\n\n### Reading a `picsart_scene_query_layout` report\n\nOne moment, one report. What its fields do and do not say:\n\n- **Opacity.** `opacity` is the layer's evaluated opacity; `effectiveOpacity` multiplies it\n  through enclosing compositions, not transform-only `parentId` links. Neither is painted alpha.\n  An absent value means the build could not evaluate it, not that the layer is opaque.\n- **Ids.** Every id is a `picsart_scene_patch` layer address, except layers inside a referenced\n  scene (edit them through `scope`) and `internal: true` implementation layers. Named track and\n  mask clips keep their own id; other nested children are `host__child`.\n- **Activity.** An inactive layer has `active: false` and no box, but held content can keep its\n  geometry while inactive. Audio `volume` is in percent.\n- **Bounds** are conservative layer geometry, not painted pixels: transparent shape branches\n  still count. Degenerate boxes come with a note.\n- **Perspective.** A layer drawn through its composition's perspective camera reports `quad`\n  (its four projected corners, top-left first in its own corner order), `box`/`aabb` as their\n  envelope, the projected center and `depth`, and no `rotationDeg`; `onCanvas` reads the envelope.\n  A layer reaching the camera's eye has no geometry and is noted. A composition in depth paints\n  far to near, so `zIndex` follows depth there.\n- The query may fetch referenced scenes, fonts and caption transcripts through guarded\n  public-URL reads; it saves no report file. It certifies no effects, assets or codecs: look at\n  rendered frames before export.\n\n### One-off checks and collision scanning\n\nAfter `picsart_scene_validate`, get actual ids/scopes with `picsart_scene_query_layout`. Then call `picsart_scene_lint_layout`\nwith the scene, a narrow `t0`/`t1` window, a useful `step`, and explicit relationships, for example:\n\n```json\n{\n  \"t0\": 0.8,\n  \"t1\": 1.8,\n  \"step\": 0.03333333333333333,\n  \"relationships\": [\n    { \"kind\": \"present\", \"members\": [{ \"id\": \"card\" }] },\n    { \"kind\": \"co_presence\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }] },\n    { \"kind\": \"translation\", \"anchor\": { \"id\": \"card\" }, \"members\": [{ \"id\": \"label\" }], \"tolerancePx\": 1 },\n    { \"kind\": \"contains\", \"anchor\": { \"id\": \"panel-bg\" }, \"members\": [{ \"id\": \"new-row\" }], \"paddingPx\": 16 }\n  ]\n}\n```\n\nThese are alternatives for appropriate targets/windows, not a requirement that a growing panel also\npasses the translation check. `translation` only measures constant relative center offsets with\nunchanged sizes/rotations; resizing or rotating rigs are **inconclusive**, not broken by definition.\n`contains` uses unclipped unrotated boxes so a clip cannot hide overflow. `present` requires geometric\npresence at each sample; `co_presence` compares member/anchor geometric presence, catching different\nlifetimes or departures. Use the latter only in a window where simultaneous presence is intended;\nexclude deliberate local entrances. At least one jointly present sample is required per member.\nNeither check measures opacity: a fully faded layer may still have geometry and `visible:true`.\nFor a shared fade, put opacity on the common composition owner and inspect child-local exceptions.\nTransform-only `parentId` links do not propagate opacity. Add `composition` for ambiguous ids.\nMissing geometry is inconclusive; a never-measured member cannot pass.\n\n### Matching fades, separately from presence\n\nWhen companions should have the **same evaluated layer opacity** during a shared event, add this\nassertion to a named contract's window (or to a one-off lint call):\n\n```json\n{ \"kind\": \"opacity_match\", \"anchor\": { \"id\": \"card__background\" }, \"members\": [{ \"id\": \"card__label\" }], \"toleranceOpacity\": 0.01 }\n```\n\nIt compares `effectiveOpacity`: evaluated layer opacity multiplied through enclosing compositions,\nnot transform-only parents. Query reports also expose local `opacity`, so a mismatch can be traced\nto an owner or a child-local fade. Use equal-opacity companions; a deliberately translucent label\nor independent reveal should not be constrained to match its opaque background. Scope the check to\nthe shared event rather than suppressing an intentional earlier difference with a large tolerance.\n\nRead `maxErrorOpacity` and timestamped evidence, not `maxErrorPx`. Tolerance is an absolute opacity\ndifference (default 0.01), not pixels or a timing tolerance. Missing evaluated opacity—older query\nbuilds or an unavailable layer state—makes the check inconclusive, never implicitly opaque or zero.\nTwo zeros match: this check alone does not require visible content or prove a desired fade happened.\nPair it with the declared geometric lifetime checks and inspect the fade window in a preview.\nMasks, source alpha, effects, occlusion and missing decoded media can still change painted visibility.\n\n### Fixed edges and attached content during resize\n\nContainment alone can pass while a panel's fixed edge drifts or an internal gap grows incorrectly.\nDo not use `translation` on a growing panel: it requires unchanged sizes. Instead declare expected\nedges/gaps from the design, not from the first measured frame. This complete sidecar assumes a\npanel whose top must stay at root y=40 and a footer whose top follows 12 px below its bottom:\n\n```json\n{\n  \"version\": 1,\n  \"timeSpace\": \"root\",\n  \"contracts\": [\n    {\n      \"id\": \"panel-fixed-top\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"fixed_edge\", \"members\": [{ \"id\": \"panel\" }], \"edge\": \"top\", \"valuePx\": 40, \"tolerancePx\": 1 }\n    },\n    {\n      \"id\": \"footer-follows-growth\",\n      \"window\": { \"start\": 0, \"end\": 2.1, \"step\": 0.1 },\n      \"assert\": { \"kind\": \"edge_attachment\", \"anchor\": { \"id\": \"panel\" }, \"members\": [{ \"id\": \"footer\" }], \"edge\": \"top\", \"anchorEdge\": \"bottom\", \"gapPx\": 12, \"tolerancePx\": 1 }\n    }\n  ]\n}\n```\n\nBoth assertions also work in `picsart_scene_lint_layout.relationships`. Edges are `left`, `right`, `top`,\n`bottom` of **unclipped, unrotated root-space boxes**, not a local parent frame. Attachment edges\nmust share an axis. Its signed gap is **member edge minus anchor edge**: a row bottom 20 px above\nthe panel bottom uses `edge:\"bottom\", anchorEdge:\"bottom\", gapPx:-20`. An inset header top 20 px\nbelow the panel top uses both `top` edges and `gapPx:20`. `fixed_edge.valuePx` is an explicit root\ncoordinate, including negative values; neither check learns a passing baseline from the scene.\n\nSizes may change. Each sampled member (and attachment anchor) must have measured on-canvas geometry;\nknown absence fails, while missing/ambiguous/unmeasured/rotated geometry is inconclusive. A held\nframe with `active:false` can still have usable geometry. Any measured violation keeps the verdict\n`fail` even when another observation is unavailable. Scope checks to the phase where the relationship\nis intended; a later independent departure needs a separate window, not a relaxed tolerance.\n\nRead timestamped `issues`/`evidence` and `measurement:{actualPx,expectedPx}` for a mismatch. For fixed\nedges these are root coordinates; for attachments they are signed gaps. `maxErrorPx` is their absolute\ndifference and `tolerancePx` defaults to 1. Matching endpoints can hide intermediate easing errors:\nsample through the growth/reveal, not only before and after it.\n\nA vertical attachment says nothing about horizontal alignment, containment or paint. Add the other\naxis or padded `contains` assertion when intended. These checks validate authored reflow; they do\nnot compute layout, scale text, or prove a reveal is readable. Still inspect intermediate frames.\n\nSampling includes `t0` and excludes `t1` (and the composition end); to inspect a seam,\nplace it on the sample grid and extend `t1` beyond it. Query the exact seam separately if needed.\n\nRead `relationships` independently of collision `findings`. `allow` only acknowledges deliberate\noverlap; it does not waive a relationship. A violation reports the input index, worst measured time,\npixel error and bounded issues. Missing measurements report `inconclusive`. Lint never fixes the scene.\n\n### Reading the overlap report\n\nOverlap candidates are visible on-canvas layers with geometry (held frames too) in the same\ncomposition scope; nested wrappers use their painted child bounds. Each overlapping pair is\nclassified:\n\n| Class | When | Where it lands |\n|---|---|---|\n| backdrop | the lower layer covers 85%+ of the canvas | `intentional` |\n| containment | 90%+ coverage for 80% of the shared time | `intentional` |\n| transient | overlapping for under 0.4 s | `info` |\n| collision | sustained overlap at or above `iou` (default 0.05) | `findings` |\n| graze | sustained overlap below `iou` | `info` |\n\n- **Layers in depth** overlap on their projected quads, in each sample's paint order. A collision\n  between two planes of a perspective camera stays a finding, annotated `depthStacked {near, far}`:\n  judge it yourself, with `covered` as the hidden-text check.\n- **`covered`** lists layers left under half visible at some sample by layers drawn after them, in\n  any composition, that the document states opaque (alpha and `effectiveOpacity` 0.98+): a color, a\n  JPEG or MP4 picture, a filled rectangle. A text layer under half visible for 0.4 s or more is a\n  finding; anything else is info. A cover the document does not state opaque is noted unmeasured.\n- **`allow`** moves the named pairs to `allowed`, keeping their class, and clears a covered layer\n  whose every cover is allowed. An entry that never overlaps is reported as stale.\n- **`mostlyOffCanvas`** lists root layers whose best visible share stayed below half.\n- Text boxes are metric envelopes, not glyph bounds.\n- Findings never fail the call. Bad options, a bad window and query errors do.\n\nSampling is bounded to 600 samples per call: a window that needs more, at the default 0.25 s step\nor an explicit one, is refused with the smallest step that fits. It can miss a brief violation. Use windows around event/seam\ntimes and frame-spaced samples; include before, during and settled states. Then inspect\n`picsart_scene_contact_sheet` with explicit `times` and `resolution` equal to the composition dimensions and continuous scene video. Geometry alone cannot judge smoothness, painted\nocclusion, typography or whether the story is understandable.\n\nFor timing syntax use scene-animation-reference (fetch with `picsart_scene_recipe`, name `scene-animation-reference`); for interactive causality\nuse app-ui-animation (fetch with `picsart_scene_recipe`, name `app-ui-animation`); for big compositions use\nlarge-scene-assembly (fetch with `picsart_scene_recipe`, name `large-scene-assembly`).\n\n**Research note:** independently authored for scene from the observed authoring failure modes and\ngeneral motion/layout principles. This is not an imported Hyperframes implementation.\n"
}

SHA-256 of public snapshot: c3c95a5ddd3d82012f10129f6aeb5bb08df75aec6260882f3c599fd1df7327eb