IX3 capability reference
Machine-generated from the exported constants in
packages/systems/ix3/schema/src/designerInvariants.ts, which is the
server-side mirror of the Designer's authoring rules. Every value below is
read from code, so it cannot drift from the write path.
This file covers the facts that exist as data. Rules that live inside a guard
body — value shapes, ordering, the reasons behind a rejection — are in the
pack's references/ files and are maintained by hand.
Triggers
Authorable = the write path accepts it today. A no row is rejected for
every caller; the guards take no flag or session parameter. This table
cannot say why a row is unauthorable — some are excluded from the default
capability set and some have no Designer schema at all. See
references/gated-capabilities.md.
The Target column is probed against the write path rather than read from a
single constant, because the policy is spread across several guards.
required, specific key means a target is required but only one key is legal
(the trigger reference names it). see reference means another guard fired
first, so the target rule could not be isolated.
optional to validate, required to fire is the case worth reading twice. The
probe only reports what validation refuses. A continuous trigger binds per
resolved element, so with no target the element list is empty and the handler
is never invoked: the interaction saves, reports success, and does nothing.
Send a target such as wf:viewport.
| Trigger | Authorable | controlType | Standalone | Target | Timeline roles | Allowed control |
|---|---|---|---|---|---|---|
wf:blur |
no | standard |
no | n/a — not authorable | — | n/a — not authorable |
wf:change |
no | standard |
no | n/a — not authorable | — | n/a — not authorable |
wf:click |
yes | standard |
no | required | — | each: pause, play, restart, resume, reverse, reverseFlipEase, stop, togglePlayReverse, togglePlayReverseFlipEase<br>restricted occurrence: pause, play, restart, resume, reverse, reverseFlipEase, stop |
wf:custom |
yes | standard |
no | required, specific key | — | standard set (none, pause, play, restart, resume, reverse, reverseFlipEase, stop, togglePlayReverse, togglePlayReverseFlipEase) |
wf:dropdown |
no | standard |
yes | n/a — not authorable | close, open |
n/a — not authorable |
wf:focus |
no | standard |
no | n/a — not authorable | — | n/a — not authorable |
wf:hover |
yes | standard |
no | required | conditional: mouseEnter, mouseLeave when multiTimeline: true |
standard set (none, pause, play, restart, resume, reverse, reverseFlipEase, stop, togglePlayReverse, togglePlayReverseFlipEase) |
wf:load |
yes | load |
no | must omit | — | none, play |
wf:mouse-move |
yes | continuous |
yes | optional to validate, required to fire | interval, mouseX, mouseY |
n/a — playback fields rejected |
wf:navbar |
no | standard |
yes | n/a — not authorable | close, open |
n/a — not authorable |
wf:scroll |
yes | scroll |
yes | required | — | n/a — playback fields rejected |
Playback fields (control, delay, jump, speed) are rejected on control types continuous, scroll. Navbar and dropdown also hide the playback editor in the panel, but they
still carry control: "play" and are not covered by that rejection —
omitting it fails the grouped-trigger check once the interaction has two or
more action groups.
Conditions capability (trigger-level conditionalLogic): not available. Interaction-level conditionalPlayback is a separate field and is authorable.
Actions
Authorable action keys: wf:animate-rive, wf:class, wf:lottie, wf:mouse-follow, wf:rive, wf:spline, wf:style, wf:transform, wf:variable.
wf:variable, wf:rive, and wf:animate-rive are default-on. Their property shapes are not in the table below; call data_interactions_tool action guide before writing one.
Non-animatable properties are only valid inside a Set action (tt: 3).
Plugin keys absent from the property table skip the property-name check.
| Extension key | Authorable | Properties | Non-animatable (Set only) |
|---|---|---|---|
wf:class |
yes | class |
class |
wf:lottie |
yes | lottie, manualDuration |
— |
wf:mouse-follow |
yes | anchor, axis, followMode, groupId, leaveBehavior, onEnter, syncedActionId |
— |
wf:spline |
yes | animatingState, objectId, spline |
— |
wf:style |
yes | backgroundColor, borderColor, color, overflow, pointerEvents, position, zIndex |
overflow, pointerEvents, position, zIndex |
wf:transform |
yes | autoAlpha, display, height, opacity, rotation, rotationX, rotationY, scale, scaleX, scaleY, skewX, skewY, transformOrigin, transformPerspective, width, x, xPercent, y, yPercent, z |
display |
Value modes
| Extension key | Random array | Random min/max | Additive |
|---|---|---|---|
wf:class |
— | — | — |
wf:lottie |
— | — | — |
wf:mouse-follow |
— | — | — |
wf:spline |
— | — | — |
wf:style |
backgroundColor, borderColor, color |
— | — |
wf:transform |
autoAlpha, height, opacity, rotation, rotationX, rotationY, scale, scaleX, scaleY, skewX, skewY, transformPerspective, width, x, xPercent, y, yPercent, z |
autoAlpha, height, opacity, rotation, rotationX, rotationY, scale, scaleX, scaleY, skewX, skewY, transformPerspective, width, x, xPercent, y, yPercent, z |
autoAlpha, height, opacity, rotation, rotationX, rotationY, scale, scaleX, scaleY, skewX, skewY, transformPerspective, width, x, xPercent, y, yPercent, z |
A random-array set holds between 2 and 12 values.
Targets
| Rule | Target keys |
|---|---|
| Valid only on timeline actions | wf:any-element, wf:trigger-only, wf:trigger-only-parent |
| Valid only on trigger targets | wf:body, wf:viewport |
No Filter — active filterContext rejected |
wf:inst, wf:trigger-only |
| Not offered by the Filter-by picker | wf:any-element, wf:body, wf:viewport |
Default filterContext stamped when a caller omits it: { relationship: "none", filterBy: ["wf:class",[]], firstMatchOnly: false }.
A stamped placeholder is accepted on the no-Filter keys above; only a filter
with a real relationship is refused.
Playback field clearing
The panel clears these fields for the listed controls, so sending them is rejected on any trigger whose playback editor is visible.
| Field | Must be omitted when control is |
|---|---|
jump |
none, restart, resume, togglePlayReverse, togglePlayReverseFlipEase |
speed |
none, pause, stop |
The flip-ease variants are real stored values
The Control dropdown and the Adaptive Easing toggle are two separate controls
writing one field. The dropdown displays reverse for a stored
reverseFlipEase (controlToDropdownValue), and the Easing toggle is what
turns reverse into reverseFlipEase. So the panel does author
reverseFlipEase and togglePlayReverseFlipEase on click, hover, and custom.
Preserve them; do not normalize a stored flip-ease variant back to its base
control on a read-then-write.
STANDARD_TRIGGER_ALLOWED_CONTROLS is the opt-in complete set rather than the
default dropdown contents. That distinction only matters where a surface
narrows the allowed set and omits the flip variants, as the conditional
outcome set below does.
Conditional outcome controls: none, pause, play, restart, resume, reverse, stop, togglePlayReverse.
No flip-ease variants, which is the narrowing referred to above. That surface
is unreachable while the conditions capability is off.
Numeric bounds
| Field | Bound |
|---|---|
timeline.canvasDuration |
at most 12 seconds |
ix3-random-array values |
2 to 12 entries |
wf:mouse-move pluginConfig.smoothness |
0 to 2000 ms |
Per-interaction caps
Enforced by findInteractionCountError, which runs in the Designer Extension
host on create and on update.
| Cap | Limit |
|---|---|
| Triggers per interaction | 20 |
| Timelines per interaction | 5 |
| Actions per timeline | 200 |
| Targets per action | 20 |
The host raises the ceiling for a stored interaction already over a cap, so a Designer Extension update to legacy data is not forced to shrink it.
That exception is host-only. The MCP tools apply these caps as Zod .max()
on the create and update argument schemas, so the request is refused before
the host sees the stored baseline. Reading a timeline with more than
200 actions and resubmitting it unchanged to edit
one action does not work over MCP. See references/limits-and-budgets.md.