[ameerf-wix]

Description

Takes the per-preset schema exports out of #330 so a version of #331 (validating namedEffect params against the registered effect's schema) can merge without the big base-presets refactor. Type: feature with breaking param changes.

What's included

• Schemas from refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330, as defined there: every entrance, scroll and ongoing preset exports refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's schema with the same keys, types, values, min/max/int and defaults. The defaults are written into the schema itself; there is no DEFAULTS object. Implementations read their defaults from schema.<param>.default.
• Param renames, applied to master's implementations: each preset accepts refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's params (from, travel, pivot, scale, stretch, speed, etc.). Each new value is converted to the master implementation's internal value. The keyframes, base presets and utils are master's; none of the refactor came along.
• Mouse presets (new): schemas for their current params and defaults. Since the mouse index registers the create function, the schema is also set on it as create.schema.
• suffix: every preset's getNames appends options.suffix to its keyframe names, so the keyframe slots that generate() added in feat(interact): keyframe slots and view-timeline lists in generate() #338 work with presets.
• Shared types and constants from refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330: param types plus LengthInput/LengthValue in types.ts, and SCROLL_RANGES, SHAPES and CENTER_AND_FOUR_DIRECTIONS in consts.ts.
• Docs: the motion-presets README and rules, the root/interact READMEs and the interactor skill references use the new param names. Statements that only hold for the refactor were left out.

Making every accepted param take effect (second commit)

• Lengths and angles: every length param accepts calc(). GlideIn/ExpandIn from accepts rad/grad/turn/calc() angles and computes those through CSS cos()/sin(). Plain values produce the same output as before.
• Cross: it now moves toward its direction. Its keyframes used to be frozen before the element was measured. The wrap offsets for three of the diagonals are also fixed.
• StretchScroll: the CSS fade now matches WAAPI.
• PanScroll: prepare measures when startFromOffScreen is left at its default.
• SpinIn: the fade lasts at most the animation's duration.
• Keyframe names: two effects share a name only when their keyframes are identical. Before, they could collide:
  • BounceIn, Bounce, Poke: the travel unit was written into the keyframes. It is now a custom property.
  • Fold: angle/perspective were written into the keyframes. They are now custom properties.
  • ParallaxScroll: the center ratio was written into the keyframes. It is now a custom property.
  • Breathe, Swing, Fold: the keyframe shape is now chosen from the same rounded timing factor the name uses.
  • ShuttersScroll: names now include the range, plus -staggered for continuous.
  • GlideIn, ShuttersIn: their step-start fades are now motion-fadeInStep.
  • A new test samples every preset's params and fails if a name maps to different keyframes. var() fallbacks are ignored, since every animation declares its properties.
• suffix: custom properties now carry the suffix too (as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330), so keyframe-slotted effects on one element don't override each other. A contract test checks that every declared property is suffixed and every var() used is declared. The only exceptions are --motion-rotate and the measured --motion-left.
• ShuttersIn/ShuttersScroll: the shutter count is rounded and clamped to a positive integer; non-integer counts used to loop forever. feat(interact-validate): validate namedEffect params against their registered schema #331 doesn't check int yet.
• CurveIn: the vertical curve (from: 'top'/'bottom') is covered by tests. On master, pseudoLeft/pseudoRight were lowercased by the parser and never matched.

Exact amounts, parallax speed and loop delays (third commit)

• Ongoing amounts are the peaks: Pulse scale (its light beat is 4/7 of the depth), Rubber stretch (the first squash is 1 ± stretch), Wiggle angle/travel, Bounce/Poke travel and Jello skew are the values the keyframes actually reach, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.
• iterationDelay: each cycle's motion is unchanged and is followed by a hold at rest (holdAtRest). Breathe, Fold and Swing used to switch to a different keyframe sequence when delayed, and Fold's and Swing's ran into the delay. Presets without a rest keyframe at the end animated back to their base value during the delay (Spin, for example).
• speed and center: one util, getScrollParallax, gives GrowScroll, ShrinkScroll, Spin3dScroll, TiltScroll and ParallaxScroll the visual speed relative to the scroll, using refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's geometry. It translates the element and widens or narrows the scroll range by 1/speed. It's exact for elements smaller than the viewport; taller elements drift on entry, exit and contain ranges, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.
• refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's remaining bug fixes:
  • Cross: CSS support (style + prepare). Without measurement, the wrap is at half the cycle, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.
  • Pulse: keeps the layout rotation.
  • Spin: no longer rotates rotated elements twice.
  • Swing: its CSS keyframe easings are real values instead of var().
  • motion: the animations of multi-layer effects are persisted, so a finished layer isn't removed when the layers above it cover the same property. This affects TiltIn, TiltScroll, BgFake3D and BgZoom.
• Keyframe names include the easing for the ongoing presets whose keyframes use it (Breathe, Fold, Swing, Flash, Flip, Spin). The collision test now also varies the easing.
• transitionDelay is removed: nothing ever read it. It's gone from the motion/interact types, the validate schema, docs, rules, skills and the playground.

Defaults

With no params, every preset produces master's output, with these exceptions:

• GrowScroll: the in default scale is 0.25 instead of 0, as documented in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.
• ShrinkScroll: the out/continuous default scale is 1/1.2 instead of 0.8. The schema has a single default, so the range-dependent default can't be expressed.
• ParallaxScroll: with the exact visual speed, the default (speed: 0.7159) matches the old look only for elements about 26vh tall. Taller elements travel further and shorter ones less, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.
• Rubber: the default squash is 1.1/0.9 instead of 1.08/0.88, which removes master's slight uniform shrink (as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330).
• ArcIn, CurveIn and TiltIn: depth is now the full depth (refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's meaning). The default output computes to the same value, but the CSS strings differ (e.g. calc(-1 * 100px) instead of calc(-1 * 200px / 2)).

Equivalence was checked by comparing old and new style/web output, at defaults and with converted non-default values.

Remaining differences from #330

• Scroll range meaning: in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330, out is in reversed and continuous is in followed by out; that isn't ported here. Scroll direction now means where the motion goes ("to"). The defaults of PanScroll, SkewPanScroll, SlideScroll and TurnScroll were flipped so they look the same as before. As a result, range: 'out' on its own now goes the other way, and SkewPanScroll's out ends at the opposite skew.
• Breathe, Fold, Swing: they keep master's undelayed keyframe sequence; refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330 uses its damped sequence.
• Fold: the left/bottom pivots now fold towards the viewer first, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.

Breaking changes

#330's param renames, for example direction → from on entrance presets, intensity → explicit amounts on ongoing presets, and parallaxFactor → speed. The full list is in the updated rules/presets/*.

Tests

• src/test/presets.spec.ts: refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330's generic contract test (implicit defaults equal explicit schema defaults, getNames matches the animation names, web and style agree, schema defaults are valid). Presets without style, such as Cross, are rendered with web. Mouse presets get the defaults and validity checks.
• Preset specs: test inputs were converted to the new params, so master's expected outputs still hold, except for the default changes and Fold/SkewPanScroll above. Suffix tests were added.
• motion-presets: 3041 tests pass; motion: 344 (adds persist tests). All package test suites, the build, eslint and prettier pass. The tsc -p tsconfig.json errors in WinkIn.spec.ts already exist on master.

Checklist

• I have read the Contributing Guide
• I have added/updated tests for my changes (if applicable)
• I have updated documentation/rules/skills (if applicable)

Additional Notes

• Not updated: apps/playground, apps/demo and apps/website still use the old param names, as in refactor(motion-presets): consolidate entrance, scroll and ongoing presets on shared base presets with schemas #330.

🤖 Generated with Claude Code

[github-actions]

Generated llms.txt preview

llms.txt

# @wix/interact

> Declarative, configuration-driven interaction library — web-native, AI-ready, and framework-agnostic.

- Install: `npm install @wix/interact @wix/motion-presets`
- Three entry points: vanilla JS (`@wix/interact`), React (`@wix/interact/react`), Web Components (`@wix/interact/web`)
- Five trigger types: hover, click, viewEnter, viewProgress, pointerMove
- Effects via named presets (`@wix/motion-presets`), keyframes, CSS transitions, or custom JS callbacks
- Configs are JSON-serializable -- designed for LLM generation

## Docs

- [Full Reference](https://wix.github.io/interact/rules/full-lean.md): Declarative configuration-driven interaction library. Binds animations to triggers via JSON config. (788 lines)
- [Integration Guide](https://wix.github.io/interact/rules/integration.md): Rules for integrating `@wix/interact` into a webpage — binding animations and effects to user-driven triggers via declarative configuration. (364 lines)
- [Validation Guide](https://wix.github.io/interact/rules/validate.md): Rules for using `@wix/interact-validate` — validate an `InteractConfig` before it reaches the runtime. (315 lines)

## Optional

- [Click Trigger Rules for @wix/interact](https://wix.github.io/interact/rules/click.md): This document contains rules for generating click-triggered interactions in `@wix/interact`. (197 lines)
- [Hover Trigger Rules for @wix/interact](https://wix.github.io/interact/rules/hover.md): This document contains rules for generating hover-triggered interactions in `@wix/interact`. (199 lines)
- [PointerMove Trigger Rules for @wix/interact](https://wix.github.io/interact/rules/pointermove.md): These rules help generate pointer-driven interactions using `@wix/interact`. (271 lines)
- [ViewEnter Trigger Rules for @wix/interact](https://wix.github.io/interact/rules/viewenter.md): This document contains rules for generating interactions that respond to elements entering the viewport using the `@wix/interact`. (232 lines)
- [ViewProgress Trigger Rules for @wix/interact](https://wix.github.io/interact/rules/viewprogress.md): These rules help generate scroll-driven interactions using `@wix/interact`. (233 lines)
- [@wix/interact Plugin Rules](https://wix.github.io/interact/rules/plugins.md): Rules for extending `@wix/interact` with external plugins via `Interact.use()` and `$`-prefixed config fields. (122 lines)
- [All rules in one file](https://wix.github.io/interact/llms-full.txt): Complete concatenation (2721 lines)

llms-full.txt header

# @wix/interact v2.5.19 -- AI Rules Reference
# https://wix.github.io/interact/llms.txt
# 9 files, 2721 lines

Download full files from workflow artifacts, or run node scripts/generate-llms.mjs locally.