use-scroll-animate 3.5.0 → 3.7.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.7.0] - 2026-10-07
+
+### Added
+- **Visual playground** — [`showcase/playground.html`](./showcase/playground.html) (no build, dogfoods `dist/components.js` with a CDN fallback):
+  - **Compose**: stack effect layers around a card, button, heading or image — scroll reveal, 3D tilt, magnetic, spring, mask reveal, depth, swipeable, click ripple, shader background, glitch and gradient text — and reorder or remove them.
+  - **Tweak**: every attribute has a live control (selects, sliders, toggles); the preview re-renders instantly, with a Replay button.
+  - **Export**: HTML (CDN, no build), ES module (per-category imports with the right `define*Components()`), React (JSX via `components/jsx` types) and Vue (`isCustomElement` hint) code, copy to clipboard.
+  - **Share**: the composition is encoded in the URL hash (`encodeState()` / `decodeState()`), so a link reproduces it.
+  - English / 中文, keyboard accessible controls, honours `prefers-reduced-motion` (shows a notice; effects render their final state).
+- Pure, tested playground core in `showcase/playground-core.js` (`PLAYGROUND_EFFECTS`, `composeMarkup()`, `playgroundSnippets()`); the component gallery links to the playground.
+
+## [3.6.0] - 2026-10-07
+
+### Added
+- **Layout animation** — new category `use-scroll-animate/components/layout`:
+  - `autoAnimate(parent, { duration, easing, scale })` and `<usa-auto-animate>` — zero-config list / grid reflow: added children fade-scale in, removed children fade out in place (as positioned ghosts), moved or resized ones glide with FLIP (sort, filter, insert, container resize); `enable()` / `disable()` / `stop()`.
+  - `<usa-masonry>` — masonry grid (`columns` or `min` column width, `gap`): shortest-column placement, items glide when the width, the set of items or their sizes change (ResizeObserver); CSS multi-column before JS runs.
+  - `sharedTransition(update, root?, opts)` — shared-element transitions: elements with the same `data-shared="id"` before and after `update()` morph into each other via the View Transitions API (`view-transition-name` assigned per id) with a FLIP fallback.
+  - Pure helpers `flipFrames()`, `masonryLayout()`.
+- Reduced motion: layout changes apply instantly, masonry does not glide, shared transitions just run `update()`.
+- Showcase: new **Layout animation** gallery category (interactive add / shuffle / remove, masonry, shared-element thumbnails → detail).
+
 ## [3.5.0] - 2026-10-07
 
 ### Added

package/README.md

@@ -10,7 +10,7 @@
 
 [English](./README.md) | [简体中文](./README_zh.md) | [日本語](./README_ja.md)
 
-**[✨ Live showcase — every effect, live, with copy-paste code](https://harrisoncn.github.io/use-scroll-animate/)** · **[🧩 Component gallery](https://harrisoncn.github.io/use-scroll-animate/showcase/components.html)**
+**[✨ Live showcase — every effect, live, with copy-paste code](https://harrisoncn.github.io/use-scroll-animate/)** · **[🧩 Component gallery](https://harrisoncn.github.io/use-scroll-animate/showcase/components.html)** · **[🎛 Playground](https://harrisoncn.github.io/use-scroll-animate/showcase/playground.html)**
 
 </div>
 
@@ -60,6 +60,7 @@ defineComponents(); // or per category: import { defineTextComponents } from 'us
 | **SVG** (`/components/svg`) | `<usa-draw>` (line drawing) · `<usa-morph>` (path morph) · `<usa-mask-reveal>` · `<usa-anim-icon>` · `morphTo()` · `interpolatePath()` |
 | **Canvas & WebGL** (`/components/webgl`) | `<usa-shader>` (gradient · plasma · waves · aurora · custom GLSL) · `<usa-distort>` · `<usa-liquid>` · `glQuad()` — graceful fallback |
 | **3D & depth** (`/components/depth`) | `<usa-cube>` · `<usa-depth>` (pointer · gyroscope · scroll depth parallax) · `deviceTilt()` · (+ `<usa-carousel-3d>` in cards) |
+| **Layout animation** (`/components/layout`) | `<usa-auto-animate>` / `autoAnimate()` (list & grid reflow) · `<usa-masonry>` · `sharedTransition()` (shared elements) |
 
 Whole bundle ≈ 22 kB gzip (JS + CSS); one category 3.5–6.4 kB; a single component ≈ 2 kB. The scroll-animation core below is unaffected.
 

package/README_ja.md

@@ -50,6 +50,7 @@ defineComponents(); // カテゴリ単位: import { defineTextComponents } from
 | **SVG** (`/components/svg`) | `<usa-draw>`（線描画）· `<usa-morph>`（パスモーフ）· `<usa-mask-reveal>` · `<usa-anim-icon>` · `morphTo()` |
 | **Canvas / WebGL** (`/components/webgl`) | `<usa-shader>`（gradient · plasma · waves · aurora · カスタム GLSL）· `<usa-distort>` · `<usa-liquid>` · `glQuad()` |
 | **3D / 奥行き** (`/components/depth`) | `<usa-cube>` · `<usa-depth>`（ポインター · ジャイロ · スクロール視差）· `deviceTilt()` |
+| **レイアウト** (`/components/layout`) | `<usa-auto-animate>` / `autoAnimate()` · `<usa-masonry>` · `sharedTransition()`（共有要素） |
 
 ## ドキュメント
 

package/README_zh.md

@@ -59,6 +59,7 @@ defineComponents(); // 或按分类：import { defineTextComponents } from 'use-
 | **SVG 动画** (`/components/svg`) | `<usa-draw>`（线条描绘）· `<usa-morph>`（路径变形）· `<usa-mask-reveal>` · `<usa-anim-icon>` · `morphTo()` · `interpolatePath()` |
 | **Canvas 与 WebGL** (`/components/webgl`) | `<usa-shader>`（gradient · plasma · waves · aurora · 自定义 GLSL）· `<usa-distort>` · `<usa-liquid>` · `glQuad()` —— 优雅降级 |
 | **3D 与景深** (`/components/depth`) | `<usa-cube>` · `<usa-depth>`（指针 · 陀螺仪 · 滚动景深视差）· `deviceTilt()` ·（另见 cards 中的 `<usa-carousel-3d>`） |
+| **布局动画** (`/components/layout`) | `<usa-auto-animate>` / `autoAnimate()`（列表与网格重排）· `<usa-masonry>`（瀑布流）· `sharedTransition()`（共享元素） |
 
 完整包约 22 kB gzip（JS + CSS）；单个分类 3.5–6.4 kB；单个组件约 2 kB。下方的滚动动画核心不受影响。
 

package/dist/chunks/{index-tags-uw1Fospg.js → index-tags-BANJ-e4H.js}

@@ -17,7 +17,8 @@ const COMPONENT_CATEGORIES = {
     svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],
     webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],
     depth: ['usa-cube', 'usa-depth'],
+    layout: ['usa-auto-animate', 'usa-masonry'],
 };
 
 export { COMPONENT_CATEGORIES as C };
-//# sourceMappingURL=index-tags-uw1Fospg.js.map
+//# sourceMappingURL=index-tags-BANJ-e4H.js.map

package/dist/chunks/{index-tags-uw1Fospg.js.map → index-tags-BANJ-e4H.js.map}

@@ -1 +1 @@
-{"version":3,"file":"index-tags-uw1Fospg.js","sources":["../../src/components/index-tags.ts"],"sourcesContent":["// The component categories and their default tags (no imports: safe for lazy loaders).\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate', 'usa-wave-text', 'usa-glitch', 'usa-gradient-text', 'usa-handwriting', 'usa-scroll-highlight'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic', 'usa-grid-glow', 'usa-blobs', 'usa-water-ripple', 'usa-dot-network'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n  physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],\n  cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],\n  click: ['usa-click', 'usa-button', 'usa-icon-morph', 'usa-like', 'usa-hold', 'usa-double-tap', 'usa-checkbox'],\n  ui: ['usa-tabs', 'usa-drawer', 'usa-bottom-sheet', 'usa-pull-refresh', 'usa-fab', 'usa-navbar', 'usa-slider', 'usa-rating', 'usa-tooltip', 'usa-popover', 'usa-badge', 'usa-avatar-stack'],\n  page: ['usa-cursor', 'usa-fullpage', 'usa-loading-bar', 'usa-back-to-top', 'usa-ambient', 'usa-splash', 'usa-auto-skeleton', 'usa-motion-switch'],\n  timeline: ['usa-timeline'],\n  gesture: ['usa-swipeable', 'usa-pinch-zoom'],\n  svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],\n  webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],\n  depth: ['usa-cube', 'usa-depth'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n"],"names":[],"mappings":"AAAA;AACA;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;IAC3E,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;AAC/M,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;AACrF,IAAA,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;IAC3J,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;AAChF,IAAA,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC1D,KAAK,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAC5E,IAAA,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC9G,EAAE,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC;AAC1L,IAAA,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;IACjJ,QAAQ,EAAE,CAAC,cAAc,CAAC;AAC1B,IAAA,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC;AAClE,IAAA,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;AAClD,IAAA,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;;;;;"}
+{"version":3,"file":"index-tags-BANJ-e4H.js","sources":["../../src/components/index-tags.ts"],"sourcesContent":["// The component categories and their default tags (no imports: safe for lazy loaders).\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate', 'usa-wave-text', 'usa-glitch', 'usa-gradient-text', 'usa-handwriting', 'usa-scroll-highlight'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic', 'usa-grid-glow', 'usa-blobs', 'usa-water-ripple', 'usa-dot-network'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n  physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],\n  cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],\n  click: ['usa-click', 'usa-button', 'usa-icon-morph', 'usa-like', 'usa-hold', 'usa-double-tap', 'usa-checkbox'],\n  ui: ['usa-tabs', 'usa-drawer', 'usa-bottom-sheet', 'usa-pull-refresh', 'usa-fab', 'usa-navbar', 'usa-slider', 'usa-rating', 'usa-tooltip', 'usa-popover', 'usa-badge', 'usa-avatar-stack'],\n  page: ['usa-cursor', 'usa-fullpage', 'usa-loading-bar', 'usa-back-to-top', 'usa-ambient', 'usa-splash', 'usa-auto-skeleton', 'usa-motion-switch'],\n  timeline: ['usa-timeline'],\n  gesture: ['usa-swipeable', 'usa-pinch-zoom'],\n  svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],\n  webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],\n  depth: ['usa-cube', 'usa-depth'],\n  layout: ['usa-auto-animate', 'usa-masonry'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n"],"names":[],"mappings":"AAAA;AACA;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;IAC3E,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;AAC/M,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;AACrF,IAAA,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;IAC3J,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;AAChF,IAAA,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC1D,KAAK,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAC5E,IAAA,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC9G,EAAE,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC;AAC1L,IAAA,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;IACjJ,QAAQ,EAAE,CAAC,cAAc,CAAC;AAC1B,IAAA,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC;AAClE,IAAA,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;AAClD,IAAA,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;AAChC,IAAA,MAAM,EAAE,CAAC,kBAAkB,EAAE,aAAa,CAAC;;;;;"}

package/dist/chunks/{index-tags-CLFrjVR7.cjs → index-tags-wbuPiMR6.cjs}

@@ -19,7 +19,8 @@ const COMPONENT_CATEGORIES = {
     svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],
     webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],
     depth: ['usa-cube', 'usa-depth'],
+    layout: ['usa-auto-animate', 'usa-masonry'],
 };
 
 exports.COMPONENT_CATEGORIES = COMPONENT_CATEGORIES;
-//# sourceMappingURL=index-tags-CLFrjVR7.cjs.map
+//# sourceMappingURL=index-tags-wbuPiMR6.cjs.map

package/dist/chunks/{index-tags-CLFrjVR7.cjs.map → index-tags-wbuPiMR6.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"index-tags-CLFrjVR7.cjs","sources":["../../src/components/index-tags.ts"],"sourcesContent":["// The component categories and their default tags (no imports: safe for lazy loaders).\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate', 'usa-wave-text', 'usa-glitch', 'usa-gradient-text', 'usa-handwriting', 'usa-scroll-highlight'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic', 'usa-grid-glow', 'usa-blobs', 'usa-water-ripple', 'usa-dot-network'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n  physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],\n  cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],\n  click: ['usa-click', 'usa-button', 'usa-icon-morph', 'usa-like', 'usa-hold', 'usa-double-tap', 'usa-checkbox'],\n  ui: ['usa-tabs', 'usa-drawer', 'usa-bottom-sheet', 'usa-pull-refresh', 'usa-fab', 'usa-navbar', 'usa-slider', 'usa-rating', 'usa-tooltip', 'usa-popover', 'usa-badge', 'usa-avatar-stack'],\n  page: ['usa-cursor', 'usa-fullpage', 'usa-loading-bar', 'usa-back-to-top', 'usa-ambient', 'usa-splash', 'usa-auto-skeleton', 'usa-motion-switch'],\n  timeline: ['usa-timeline'],\n  gesture: ['usa-swipeable', 'usa-pinch-zoom'],\n  svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],\n  webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],\n  depth: ['usa-cube', 'usa-depth'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n"],"names":[],"mappings":";;AAAA;AACA;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;IAC3E,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;AAC/M,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;AACrF,IAAA,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;IAC3J,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;AAChF,IAAA,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC1D,KAAK,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAC5E,IAAA,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC9G,EAAE,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC;AAC1L,IAAA,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;IACjJ,QAAQ,EAAE,CAAC,cAAc,CAAC;AAC1B,IAAA,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC;AAClE,IAAA,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;AAClD,IAAA,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;;;;;"}
+{"version":3,"file":"index-tags-wbuPiMR6.cjs","sources":["../../src/components/index-tags.ts"],"sourcesContent":["// The component categories and their default tags (no imports: safe for lazy loaders).\n/** The component categories and their default tags. */\nexport const COMPONENT_CATEGORIES = {\n  reveal: ['usa-reveal', 'usa-stagger', 'usa-scroll-progress', 'usa-scrolly'],\n  text: ['usa-typewriter', 'usa-split-text', 'usa-scramble', 'usa-counter', 'usa-shimmer-text', 'usa-text-rotate', 'usa-wave-text', 'usa-glitch', 'usa-gradient-text', 'usa-handwriting', 'usa-scroll-highlight'],\n  interaction: ['usa-ripple', 'usa-magnetic', 'usa-tilt', 'usa-spotlight', 'usa-press', 'usa-toggle'],\n  feedback: ['usa-spinner', 'usa-skeleton', 'usa-progress', 'usa-toaster', 'usa-check'],\n  background: ['usa-aurora', 'usa-particles', 'usa-grain', 'usa-marquee', 'usa-acrylic', 'usa-grid-glow', 'usa-blobs', 'usa-water-ripple', 'usa-dot-network'],\n  transitions: ['usa-dialog', 'usa-accordion', 'usa-flip-list', 'usa-view-switch'],\n  physics: ['usa-spring', 'usa-draggable', 'usa-overscroll'],\n  cards: ['usa-card', 'usa-card-stack', 'usa-sticky-stack', 'usa-carousel-3d'],\n  click: ['usa-click', 'usa-button', 'usa-icon-morph', 'usa-like', 'usa-hold', 'usa-double-tap', 'usa-checkbox'],\n  ui: ['usa-tabs', 'usa-drawer', 'usa-bottom-sheet', 'usa-pull-refresh', 'usa-fab', 'usa-navbar', 'usa-slider', 'usa-rating', 'usa-tooltip', 'usa-popover', 'usa-badge', 'usa-avatar-stack'],\n  page: ['usa-cursor', 'usa-fullpage', 'usa-loading-bar', 'usa-back-to-top', 'usa-ambient', 'usa-splash', 'usa-auto-skeleton', 'usa-motion-switch'],\n  timeline: ['usa-timeline'],\n  gesture: ['usa-swipeable', 'usa-pinch-zoom'],\n  svg: ['usa-draw', 'usa-morph', 'usa-mask-reveal', 'usa-anim-icon'],\n  webgl: ['usa-shader', 'usa-distort', 'usa-liquid'],\n  depth: ['usa-cube', 'usa-depth'],\n  layout: ['usa-auto-animate', 'usa-masonry'],\n} as const;\n\nexport type ComponentCategory = keyof typeof COMPONENT_CATEGORIES;\n"],"names":[],"mappings":";;AAAA;AACA;AACO,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,CAAC;IAC3E,IAAI,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,sBAAsB,CAAC;AAC/M,IAAA,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC;IACnG,QAAQ,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,CAAC;AACrF,IAAA,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;IAC3J,WAAW,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,CAAC;AAChF,IAAA,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAC1D,KAAK,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;AAC5E,IAAA,KAAK,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC9G,EAAE,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC;AAC1L,IAAA,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,CAAC;IACjJ,QAAQ,EAAE,CAAC,cAAc,CAAC;AAC1B,IAAA,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC5C,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC;AAClE,IAAA,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;AAClD,IAAA,KAAK,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;AAChC,IAAA,MAAM,EAAE,CAAC,kBAAkB,EAAE,aAAa,CAAC;;;;;"}

package/dist/components/jsx.d.cts

@@ -16,6 +16,7 @@ declare const COMPONENT_CATEGORIES: {
     readonly svg: readonly ["usa-draw", "usa-morph", "usa-mask-reveal", "usa-anim-icon"];
     readonly webgl: readonly ["usa-shader", "usa-distort", "usa-liquid"];
     readonly depth: readonly ["usa-cube", "usa-depth"];
+    readonly layout: readonly ["usa-auto-animate", "usa-masonry"];
 };
 
 /**

package/dist/components/jsx.d.ts

@@ -16,6 +16,7 @@ declare const COMPONENT_CATEGORIES: {
     readonly svg: readonly ["usa-draw", "usa-morph", "usa-mask-reveal", "usa-anim-icon"];
     readonly webgl: readonly ["usa-shader", "usa-distort", "usa-liquid"];
     readonly depth: readonly ["usa-cube", "usa-depth"];
+    readonly layout: readonly ["usa-auto-animate", "usa-masonry"];
 };
 
 /**

package/dist/components/layout.cjs

@@ -0,0 +1,259 @@
+'use strict';
+
+var base = require('../chunks/base-CXx7jZ-o.cjs');
+
+/** FLIP keyframes from a previous box to the current one (pure). */
+function flipFrames(from, to, scale = true) {
+    const dx = from.left - to.left;
+    const dy = from.top - to.top;
+    const sx = scale && to.width ? from.width / to.width : 1;
+    const sy = scale && to.height ? from.height / to.height : 1;
+    return [
+        { transformOrigin: '0 0', transform: `translate(${dx}px, ${dy}px) scale(${sx}, ${sy})` },
+        { transformOrigin: '0 0', transform: 'none' },
+    ];
+}
+/**
+ * Auto-animate a container: children that are added fade / scale in, removed
+ * ones fade out in place, and moved ones (re-sort, filter, reflow, resize)
+ * glide to their new spot — no extra code at the call site. Returns
+ * `{ disable, enable, stop }`. Reduced motion: changes apply instantly.
+ *
+ * @example
+ * const ctl = autoAnimate(document.querySelector('ul'));
+ * list.append(item); // animates
+ */
+function autoAnimate(parent, o = {}) {
+    let on = true;
+    const boxes = new WeakMap();
+    const rel = (el) => {
+        const r = el.getBoundingClientRect();
+        const p = parent.getBoundingClientRect();
+        return { left: r.left - p.left, top: r.top - p.top, width: r.width, height: r.height };
+    };
+    const snap = () => Array.from(parent.children).forEach((c) => boxes.set(c, rel(c)));
+    const dur = () => (o.duration ?? 300) * base.motionScale();
+    const timing = () => ({ duration: dur(), easing: o.easing ?? base.EASE_OUT });
+    const animate = (el, frames, t = timing()) => (typeof el.animate === 'function' ? el.animate(frames, t) : null);
+    const mo = typeof MutationObserver === 'function'
+        ? new MutationObserver((records) => {
+            if (!on || base.prefersReducedMotion() || dur() <= 0)
+                return snap();
+            const added = new Set();
+            for (const r of records) {
+                r.addedNodes.forEach((n) => n instanceof Element && n.parentElement === parent && added.add(n));
+                r.removedNodes.forEach((n) => {
+                    if (!(n instanceof HTMLElement) || n.isConnected)
+                        return;
+                    const b = boxes.get(n);
+                    if (!b)
+                        return;
+                    // put a ghost back at its old place and fade it out
+                    n.style.position = 'absolute';
+                    n.style.left = `${b.left}px`;
+                    n.style.top = `${b.top}px`;
+                    n.style.width = `${b.width}px`;
+                    n.style.height = `${b.height}px`;
+                    n.style.margin = '0';
+                    n.style.pointerEvents = 'none';
+                    if (getComputedStyle(parent).position === 'static')
+                        parent.style.position = 'relative';
+                    parent.appendChild(n);
+                    n.__usaGhost = true;
+                    const a = animate(n, [{ opacity: 1, transform: 'none' }, { opacity: 0, transform: 'scale(0.96)' }]);
+                    const drop = () => {
+                        n.remove();
+                        for (const k of ['position', 'left', 'top', 'width', 'height', 'margin', 'pointerEvents'])
+                            n.style[k] = '';
+                    };
+                    if (a)
+                        a.finished.then(drop, drop);
+                    else
+                        drop();
+                });
+            }
+            Array.from(parent.children).forEach((c) => {
+                if (c.__usaGhost)
+                    return;
+                if (added.has(c))
+                    return void animate(c, [{ opacity: 0, transform: 'scale(0.96)' }, { opacity: 1, transform: 'none' }]);
+                const prev = boxes.get(c);
+                if (!prev)
+                    return;
+                const now = rel(c);
+                if (Math.abs(prev.left - now.left) + Math.abs(prev.top - now.top) + Math.abs(prev.width - now.width) + Math.abs(prev.height - now.height) < 1)
+                    return;
+                animate(c, flipFrames(prev, now, o.scale !== false));
+            });
+            snap();
+        })
+        : null;
+    mo?.observe(parent, { childList: true });
+    const ro = typeof ResizeObserver === 'function' ? new ResizeObserver(() => snap()) : null;
+    ro?.observe(parent);
+    snap();
+    // capture boxes right before any change in the same task (events, timers)
+    const capture = () => snap();
+    parent.addEventListener('pointerdown', capture, true);
+    return {
+        enable: () => ((on = true), snap()),
+        disable: () => (on = false),
+        stop: () => {
+            mo?.disconnect();
+            ro?.disconnect();
+            parent.removeEventListener('pointerdown', capture, true);
+        },
+    };
+}
+/** Masonry placement: shortest-column-first positions for item heights (pure). */
+function masonryLayout(heights, columns, columnWidth, gap) {
+    const cols = Array(Math.max(1, columns)).fill(0);
+    const out = heights.map((h) => {
+        const c = cols.indexOf(Math.min(...cols));
+        const pos = { x: c * (columnWidth + gap), y: cols[c] };
+        cols[c] += h + gap;
+        return pos;
+    });
+    out.height = Math.max(0, Math.max(...cols) - gap);
+    return out;
+}
+/**
+ * Shared-element transition between two states of the page: every element
+ * with `data-shared="id"` before `update()` flies to the element with the
+ * same id afterwards (size and position), the rest cross-fades. Uses the
+ * View Transitions API when present (with `view-transition-name` per id),
+ * otherwise a FLIP fallback. Reduced motion: just runs `update()`.
+ */
+async function sharedTransition(update, root = document, o = {}) {
+    if (base.prefersReducedMotion() || typeof document === 'undefined')
+        return void (await update());
+    const collect = () => new Map(Array.from(root.querySelectorAll('[data-shared]')).map((el) => [el.dataset.shared, el]));
+    const doc = document;
+    if (typeof doc.startViewTransition === 'function') {
+        const named = (m) => m.forEach((el, id) => (el.style.viewTransitionName = `usa-${id.replace(/[^\w-]/g, '_')}`));
+        const clear = (m) => m.forEach((el) => (el.style.viewTransitionName = ''));
+        const before = collect();
+        named(before);
+        let after = new Map();
+        const vt = doc.startViewTransition(async () => {
+            clear(before);
+            await update();
+            after = collect();
+            named(after);
+        });
+        await vt.finished.catch(() => undefined);
+        clear(after);
+        return;
+    }
+    const before = new Map(Array.from(collect()).map(([id, el]) => [id, el.getBoundingClientRect()]));
+    await update();
+    const anims = [];
+    collect().forEach((el, id) => {
+        const a = before.get(id);
+        if (!a || typeof el.animate !== 'function')
+            return;
+        const b = el.getBoundingClientRect();
+        if (!b.width || !b.height)
+            return;
+        anims.push(el.animate(flipFrames(a, b), { duration: (o.duration ?? 450) * base.motionScale(), easing: o.easing ?? base.EASE_OUT }).finished.catch(() => undefined));
+    });
+    await Promise.all(anims);
+}
+
+var css = "usa-auto-animate{display:block}usa-masonry{display:block;column-width:220px;column-gap:16px}usa-masonry>*{break-inside:avoid;margin-bottom:16px}usa-masonry[data-js]{position:relative;columns:auto}usa-masonry[data-js]>*{position:absolute;left:0;top:0;margin:0;box-sizing:border-box;transition:transform 0.45s cubic-bezier(0.22,1,0.36,1)}@media (prefers-reduced-motion:reduce){usa-masonry[data-js]>*{transition:none}}";
+
+function defineAutoAnimate(tag = 'usa-auto-animate') {
+    return base.defineElement(tag, (Base) => class UsaAutoAnimate extends Base {
+        constructor() {
+            super(...arguments);
+            this._c = null;
+        }
+        enable() {
+            this._c?.enable();
+        }
+        disable() {
+            this._c?.disable();
+        }
+        mount() {
+            const c = (this._c = autoAnimate(this, { duration: this.num('duration', 300), scale: !this.flag('no-scale') }));
+            this.onCleanup(() => c.stop());
+        }
+    }, { id: 'layout', text: css });
+}
+function defineMasonry(tag = 'usa-masonry') {
+    return base.defineElement(tag, (Base) => class UsaMasonry extends Base {
+        static get observedAttributes() {
+            return ['columns', 'min', 'gap'];
+        }
+        changed() {
+            this.layout();
+        }
+        layout() {
+            const items = Array.from(this.children).filter((c) => !c.__usaGhost);
+            const w = this.clientWidth;
+            if (!w)
+                return;
+            const gap = this.num('gap', 16);
+            const cols = this.num('columns', 0) || Math.max(1, Math.floor((w + gap) / (this.num('min', 220) + gap)));
+            const cw = (w - gap * (cols - 1)) / cols;
+            items.forEach((el) => (el.style.width = `${cw}px`));
+            const pos = masonryLayout(items.map((el) => el.offsetHeight), cols, cw, gap);
+            items.forEach((el, i) => (el.style.transform = `translate(${pos[i].x}px, ${pos[i].y}px)`));
+            this.style.height = `${pos.height}px`;
+            this.style.setProperty('--usa-masonry-cols', String(cols));
+        }
+        mount() {
+            this.setAttribute('data-js', '');
+            this.onCleanup(() => this.removeAttribute('data-js'));
+            let id = 0;
+            const queue = () => {
+                if (id)
+                    return;
+                id = requestAnimationFrame(() => {
+                    id = 0;
+                    this.layout();
+                });
+            };
+            if (typeof ResizeObserver === 'function') {
+                const ro = new ResizeObserver(queue);
+                ro.observe(this);
+                Array.from(this.children).forEach((c) => ro.observe(c));
+                const mo = new MutationObserver((recs) => {
+                    recs.forEach((r) => r.addedNodes.forEach((n) => n instanceof Element && ro.observe(n)));
+                    queue();
+                });
+                mo.observe(this, { childList: true });
+                this.onCleanup(() => (ro.disconnect(), mo.disconnect()));
+            }
+            this.listen(this, 'load', queue, { capture: true });
+            this.layout();
+        }
+        unmount() {
+            this.style.height = '';
+            Array.from(this.children).forEach((c) => (c.style.transform = '', c.style.width = ''));
+        }
+    }, { id: 'layout', text: css });
+}
+
+/**
+ * use-scroll-animate/components/layout — layout animation (v3.6).
+ * `autoAnimate()` / `<usa-auto-animate>` (list & grid reflow),
+ * `<usa-masonry>`, and `sharedTransition()` for shared-element transitions
+ * (View Transitions API with a FLIP fallback).
+ */
+/** Register every component of this category under its default tag. */
+function defineLayoutComponents() {
+    defineAutoAnimate();
+    defineMasonry();
+}
+
+exports.configureComponents = base.configureComponents;
+exports.prefersReducedMotion = base.prefersReducedMotion;
+exports.autoAnimate = autoAnimate;
+exports.defineAutoAnimate = defineAutoAnimate;
+exports.defineLayoutComponents = defineLayoutComponents;
+exports.defineMasonry = defineMasonry;
+exports.flipFrames = flipFrames;
+exports.masonryLayout = masonryLayout;
+exports.sharedTransition = sharedTransition;
+//# sourceMappingURL=layout.cjs.map

package/dist/components/layout.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.cjs","sources":["../../src/components/layout/core.ts","../../src/components/layout/elements.ts","../../src/components/layout/index.ts"],"sourcesContent":["import { prefersReducedMotion, motionScale, EASE_OUT } from '../base';\n\ntype Box = { left: number; top: number; width: number; height: number };\n\n/** FLIP keyframes from a previous box to the current one (pure). */\nexport function flipFrames(from: Box, to: Box, scale = true): Keyframe[] {\n  const dx = from.left - to.left;\n  const dy = from.top - to.top;\n  const sx = scale && to.width ? from.width / to.width : 1;\n  const sy = scale && to.height ? from.height / to.height : 1;\n  return [\n    { transformOrigin: '0 0', transform: `translate(${dx}px, ${dy}px) scale(${sx}, ${sy})` },\n    { transformOrigin: '0 0', transform: 'none' },\n  ];\n}\n\nexport interface AutoAnimateOptions {\n  duration?: number;\n  easing?: string;\n  /** Also animate size changes (default true). */\n  scale?: boolean;\n}\n\n/**\n * Auto-animate a container: children that are added fade / scale in, removed\n * ones fade out in place, and moved ones (re-sort, filter, reflow, resize)\n * glide to their new spot — no extra code at the call site. Returns\n * `{ disable, enable, stop }`. Reduced motion: changes apply instantly.\n *\n * @example\n * const ctl = autoAnimate(document.querySelector('ul'));\n * list.append(item); // animates\n */\nexport function autoAnimate(parent: HTMLElement, o: AutoAnimateOptions = {}): { enable(): void; disable(): void; stop(): void } {\n  let on = true;\n  const boxes = new WeakMap<Element, Box>();\n  const rel = (el: Element): Box => {\n    const r = el.getBoundingClientRect();\n    const p = parent.getBoundingClientRect();\n    return { left: r.left - p.left, top: r.top - p.top, width: r.width, height: r.height };\n  };\n  const snap = () => Array.from(parent.children).forEach((c) => boxes.set(c, rel(c)));\n  const dur = () => (o.duration ?? 300) * motionScale();\n  const timing = (): KeyframeAnimationOptions => ({ duration: dur(), easing: o.easing ?? EASE_OUT });\n  const animate = (el: Element, frames: Keyframe[], t = timing()) => (typeof (el as HTMLElement).animate === 'function' ? (el as HTMLElement).animate(frames, t) : null);\n\n  const mo =\n    typeof MutationObserver === 'function'\n      ? new MutationObserver((records) => {\n          if (!on || prefersReducedMotion() || dur() <= 0) return snap();\n          const added = new Set<Element>();\n          for (const r of records) {\n            r.addedNodes.forEach((n) => n instanceof Element && n.parentElement === parent && added.add(n));\n            r.removedNodes.forEach((n) => {\n              if (!(n instanceof HTMLElement) || n.isConnected) return;\n              const b = boxes.get(n);\n              if (!b) return;\n              // put a ghost back at its old place and fade it out\n              n.style.position = 'absolute';\n              n.style.left = `${b.left}px`;\n              n.style.top = `${b.top}px`;\n              n.style.width = `${b.width}px`;\n              n.style.height = `${b.height}px`;\n              n.style.margin = '0';\n              n.style.pointerEvents = 'none';\n              if (getComputedStyle(parent).position === 'static') parent.style.position = 'relative';\n              parent.appendChild(n);\n              (n as any).__usaGhost = true;\n              const a = animate(n, [{ opacity: 1, transform: 'none' }, { opacity: 0, transform: 'scale(0.96)' }]);\n              const drop = () => {\n                n.remove();\n                for (const k of ['position', 'left', 'top', 'width', 'height', 'margin', 'pointerEvents'] as const) n.style[k] = '';\n              };\n              if (a) a.finished.then(drop, drop);\n              else drop();\n            });\n          }\n          Array.from(parent.children).forEach((c) => {\n            if ((c as any).__usaGhost) return;\n            if (added.has(c)) return void animate(c, [{ opacity: 0, transform: 'scale(0.96)' }, { opacity: 1, transform: 'none' }]);\n            const prev = boxes.get(c);\n            if (!prev) return;\n            const now = rel(c);\n            if (Math.abs(prev.left - now.left) + Math.abs(prev.top - now.top) + Math.abs(prev.width - now.width) + Math.abs(prev.height - now.height) < 1) return;\n            animate(c, flipFrames(prev, now, o.scale !== false));\n          });\n          snap();\n        })\n      : null;\n  mo?.observe(parent, { childList: true });\n  const ro = typeof ResizeObserver === 'function' ? new ResizeObserver(() => snap()) : null;\n  ro?.observe(parent);\n  snap();\n  // capture boxes right before any change in the same task (events, timers)\n  const capture = () => snap();\n  parent.addEventListener('pointerdown', capture, true);\n  return {\n    enable: () => ((on = true), snap()),\n    disable: () => (on = false),\n    stop: () => {\n      mo?.disconnect();\n      ro?.disconnect();\n      parent.removeEventListener('pointerdown', capture, true);\n    },\n  };\n}\n\n/** Masonry placement: shortest-column-first positions for item heights (pure). */\nexport function masonryLayout(heights: number[], columns: number, columnWidth: number, gap: number): { x: number; y: number }[] & { height?: number } {\n  const cols = Array(Math.max(1, columns)).fill(0);\n  const out = heights.map((h) => {\n    const c = cols.indexOf(Math.min(...cols));\n    const pos = { x: c * (columnWidth + gap), y: cols[c] };\n    cols[c] += h + gap;\n    return pos;\n  }) as { x: number; y: number }[] & { height?: number };\n  out.height = Math.max(0, Math.max(...cols) - gap);\n  return out;\n}\n\nexport interface SharedOptions {\n  duration?: number;\n  easing?: string;\n}\n\n/**\n * Shared-element transition between two states of the page: every element\n * with `data-shared=\"id\"` before `update()` flies to the element with the\n * same id afterwards (size and position), the rest cross-fades. Uses the\n * View Transitions API when present (with `view-transition-name` per id),\n * otherwise a FLIP fallback. Reduced motion: just runs `update()`.\n */\nexport async function sharedTransition(update: () => void | Promise<void>, root: ParentNode = document, o: SharedOptions = {}): Promise<void> {\n  if (prefersReducedMotion() || typeof document === 'undefined') return void (await update());\n  const collect = () => new Map(Array.from(root.querySelectorAll<HTMLElement>('[data-shared]')).map((el) => [el.dataset.shared!, el]));\n  const doc = document as any;\n  if (typeof doc.startViewTransition === 'function') {\n    const named = (m: Map<string, HTMLElement>) => m.forEach((el, id) => (el.style.viewTransitionName = `usa-${id.replace(/[^\\w-]/g, '_')}`));\n    const clear = (m: Map<string, HTMLElement>) => m.forEach((el) => (el.style.viewTransitionName = ''));\n    const before = collect();\n    named(before);\n    let after = new Map<string, HTMLElement>();\n    const vt = doc.startViewTransition(async () => {\n      clear(before);\n      await update();\n      after = collect();\n      named(after);\n    });\n    await vt.finished.catch(() => undefined);\n    clear(after);\n    return;\n  }\n  const before = new Map(Array.from(collect()).map(([id, el]) => [id, el.getBoundingClientRect()]));\n  await update();\n  const anims: Promise<unknown>[] = [];\n  collect().forEach((el, id) => {\n    const a = before.get(id);\n    if (!a || typeof el.animate !== 'function') return;\n    const b = el.getBoundingClientRect();\n    if (!b.width || !b.height) return;\n    anims.push(el.animate(flipFrames(a, b), { duration: (o.duration ?? 450) * motionScale(), easing: o.easing ?? EASE_OUT }).finished.catch(() => undefined));\n  });\n  await Promise.all(anims);\n}\n","import { defineElement, type UsaElement } from '../base';\nimport { autoAnimate, masonryLayout } from './core';\nimport css from './layout.css?raw';\n\n/**\n * `<usa-auto-animate>` — wraps `autoAnimate()`: any change to its children\n * (add, remove, re-order, filter, size) animates. Attributes `duration`\n * (300), `no-scale`. Works for lists and CSS grids alike.\n */\nexport interface UsaAutoAnimateElement extends UsaElement {\n  enable(): void;\n  disable(): void;\n}\n\nexport function defineAutoAnimate(tag = 'usa-auto-animate'): CustomElementConstructor | undefined {\n  return defineElement(\n    tag,\n    (Base) =>\n      class UsaAutoAnimate extends Base {\n        private _c: ReturnType<typeof autoAnimate> | null = null;\n        enable(): void {\n          this._c?.enable();\n        }\n        disable(): void {\n          this._c?.disable();\n        }\n        mount(): void {\n          const c = (this._c = autoAnimate(this, { duration: this.num('duration', 300), scale: !this.flag('no-scale') }));\n          this.onCleanup(() => c.stop());\n        }\n      },\n    { id: 'layout', text: css }\n  );\n}\n\n/**\n * `<usa-masonry>` — a masonry (Pinterest-style) grid: children are placed in\n * the shortest column and glide to new spots when the width, the items or\n * their sizes change. Attributes `columns` (fixed count) or `min` (min\n * column width px, 220), `gap` (16). Without JS layout support it is a\n * plain CSS multi-column flow. Reduced motion: no glide.\n */\nexport interface UsaMasonryElement extends UsaElement {\n  layout(): void;\n}\n\nexport function defineMasonry(tag = 'usa-masonry'): CustomElementConstructor | undefined {\n  return defineElement(\n    tag,\n    (Base) =>\n      class UsaMasonry extends Base {\n        static get observedAttributes(): string[] {\n          return ['columns', 'min', 'gap'];\n        }\n        changed(): void {\n          this.layout();\n        }\n        layout(): void {\n          const items = Array.from(this.children).filter((c) => !(c as any).__usaGhost) as HTMLElement[];\n          const w = this.clientWidth;\n          if (!w) return;\n          const gap = this.num('gap', 16);\n          const cols = this.num('columns', 0) || Math.max(1, Math.floor((w + gap) / (this.num('min', 220) + gap)));\n          const cw = (w - gap * (cols - 1)) / cols;\n          items.forEach((el) => (el.style.width = `${cw}px`));\n          const pos = masonryLayout(items.map((el) => el.offsetHeight), cols, cw, gap);\n          items.forEach((el, i) => (el.style.transform = `translate(${pos[i].x}px, ${pos[i].y}px)`));\n          this.style.height = `${pos.height}px`;\n          this.style.setProperty('--usa-masonry-cols', String(cols));\n        }\n        mount(): void {\n          this.setAttribute('data-js', '');\n          this.onCleanup(() => this.removeAttribute('data-js'));\n          let id = 0;\n          const queue = () => {\n            if (id) return;\n            id = requestAnimationFrame(() => {\n              id = 0;\n              this.layout();\n            });\n          };\n          if (typeof ResizeObserver === 'function') {\n            const ro = new ResizeObserver(queue);\n            ro.observe(this);\n            Array.from(this.children).forEach((c) => ro.observe(c));\n            const mo = new MutationObserver((recs) => {\n              recs.forEach((r) => r.addedNodes.forEach((n) => n instanceof Element && ro.observe(n)));\n              queue();\n            });\n            mo.observe(this, { childList: true });\n            this.onCleanup(() => (ro.disconnect(), mo.disconnect()));\n          }\n          this.listen(this, 'load', queue, { capture: true });\n          this.layout();\n        }\n        unmount(): void {\n          this.style.height = '';\n          Array.from(this.children).forEach((c) => ((c as HTMLElement).style.transform = '', (c as HTMLElement).style.width = ''));\n        }\n      },\n    { id: 'layout', text: css }\n  );\n}\n","/**\n * use-scroll-animate/components/layout — layout animation (v3.6).\n * `autoAnimate()` / `<usa-auto-animate>` (list & grid reflow),\n * `<usa-masonry>`, and `sharedTransition()` for shared-element transitions\n * (View Transitions API with a FLIP fallback).\n */\nimport { defineAutoAnimate, defineMasonry, type UsaAutoAnimateElement, type UsaMasonryElement } from './elements';\n\nexport { defineAutoAnimate, defineMasonry };\nexport { autoAnimate, masonryLayout, sharedTransition, flipFrames } from './core';\nexport type { AutoAnimateOptions, SharedOptions } from './core';\nexport type { UsaAutoAnimateElement, UsaMasonryElement };\nexport { configureComponents, prefersReducedMotion } from '../base';\nexport type { ComponentsConfig, UsaElement } from '../base';\n\n/** Register every component of this category under its default tag. */\nexport function defineLayoutComponents(): void {\n  defineAutoAnimate();\n  defineMasonry();\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'usa-auto-animate': UsaAutoAnimateElement;\n    'usa-masonry': UsaMasonryElement;\n  }\n}\n"],"names":["motionScale","EASE_OUT","prefersReducedMotion","defineElement"],"mappings":"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"}

package/dist/components/layout.css

@@ -0,0 +1,3 @@
+/* use-scroll-animate/components/layout */
+.usa-sr{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;border:0}
+usa-auto-animate{display:block}usa-masonry{display:block;column-width:220px;column-gap:16px}usa-masonry>*{break-inside:avoid;margin-bottom:16px}usa-masonry[data-js]{position:relative;columns:auto}usa-masonry[data-js]>*{position:absolute;left:0;top:0;margin:0;box-sizing:border-box;transition:transform 0.45s cubic-bezier(0.22,1,0.36,1)}@media (prefers-reduced-motion:reduce){usa-masonry[data-js]>*{transition:none}}

package/dist/components/layout.d.cts

@@ -0,0 +1,134 @@
+/**
+ * use-scroll-animate/components — shared base for the `<usa-*>` custom elements.
+ *
+ * Everything here is lazy: nothing touches `window`, `document`,
+ * `HTMLElement` or `matchMedia` at import time, so the components can be
+ * imported during SSR (Next, Nuxt, Astro…) and in Electron/Tauri preload
+ * scripts. Classes are created the first time a `define*()` function runs.
+ */
+interface ComponentsConfig {
+    /**
+     * Inject each component's CSS when it is defined (default `true`). Uses a
+     * constructable stylesheet (`document.adoptedStyleSheets`, which a strict
+     * `style-src` CSP does not block) and falls back to a `<style>` tag. Set
+     * to `false` when you load `use-scroll-animate/components.css` yourself.
+     */
+    injectStyles?: boolean;
+    /**
+     * `'user'` (default) follows `prefers-reduced-motion`; `'reduce'` always
+     * uses the reduced variants (e.g. a kiosk / battery-saver mode);
+     * `'no-preference'` ignores the OS setting (only for demos — respect your users).
+     */
+    reducedMotion?: 'user' | 'reduce' | 'no-preference';
+    /**
+     * Global motion intensity (v2.7): `'off'` (same as reduced motion),
+     * `'low'` (shorter, calmer), `'normal'` (default) or `'high'`. Scales every
+     * component animation's duration and sets `--usa-motion` (0 / 0.6 / 1 /
+     * 1.25) on `<html>` for your own CSS. See `setMotionIntensity()`.
+     */
+    motionIntensity?: MotionIntensity;
+}
+type MotionIntensity = 'off' | 'low' | 'normal' | 'high';
+/** Change global component settings (call before `define*()` for `injectStyles`). */
+declare function configureComponents(options: ComponentsConfig): void;
+/** `true` when animations should be reduced (OS setting or `configureComponents`). */
+declare function prefersReducedMotion(): boolean;
+/**
+ * Members shared by every `<usa-*>` element. Attribute helpers, a cleanup
+ * bag that is emptied on disconnect, and motion helpers that degrade to the
+ * final state without WAAPI or under reduced motion.
+ */
+interface UsaElement extends HTMLElement {
+    /** `true` while reduced motion applies to this element. */
+    readonly reduced: boolean;
+}
+
+/**
+ * `<usa-auto-animate>` — wraps `autoAnimate()`: any change to its children
+ * (add, remove, re-order, filter, size) animates. Attributes `duration`
+ * (300), `no-scale`. Works for lists and CSS grids alike.
+ */
+interface UsaAutoAnimateElement extends UsaElement {
+    enable(): void;
+    disable(): void;
+}
+declare function defineAutoAnimate(tag?: string): CustomElementConstructor | undefined;
+/**
+ * `<usa-masonry>` — a masonry (Pinterest-style) grid: children are placed in
+ * the shortest column and glide to new spots when the width, the items or
+ * their sizes change. Attributes `columns` (fixed count) or `min` (min
+ * column width px, 220), `gap` (16). Without JS layout support it is a
+ * plain CSS multi-column flow. Reduced motion: no glide.
+ */
+interface UsaMasonryElement extends UsaElement {
+    layout(): void;
+}
+declare function defineMasonry(tag?: string): CustomElementConstructor | undefined;
+
+type Box = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** FLIP keyframes from a previous box to the current one (pure). */
+declare function flipFrames(from: Box, to: Box, scale?: boolean): Keyframe[];
+interface AutoAnimateOptions {
+    duration?: number;
+    easing?: string;
+    /** Also animate size changes (default true). */
+    scale?: boolean;
+}
+/**
+ * Auto-animate a container: children that are added fade / scale in, removed
+ * ones fade out in place, and moved ones (re-sort, filter, reflow, resize)
+ * glide to their new spot — no extra code at the call site. Returns
+ * `{ disable, enable, stop }`. Reduced motion: changes apply instantly.
+ *
+ * @example
+ * const ctl = autoAnimate(document.querySelector('ul'));
+ * list.append(item); // animates
+ */
+declare function autoAnimate(parent: HTMLElement, o?: AutoAnimateOptions): {
+    enable(): void;
+    disable(): void;
+    stop(): void;
+};
+/** Masonry placement: shortest-column-first positions for item heights (pure). */
+declare function masonryLayout(heights: number[], columns: number, columnWidth: number, gap: number): {
+    x: number;
+    y: number;
+}[] & {
+    height?: number;
+};
+interface SharedOptions {
+    duration?: number;
+    easing?: string;
+}
+/**
+ * Shared-element transition between two states of the page: every element
+ * with `data-shared="id"` before `update()` flies to the element with the
+ * same id afterwards (size and position), the rest cross-fades. Uses the
+ * View Transitions API when present (with `view-transition-name` per id),
+ * otherwise a FLIP fallback. Reduced motion: just runs `update()`.
+ */
+declare function sharedTransition(update: () => void | Promise<void>, root?: ParentNode, o?: SharedOptions): Promise<void>;
+
+/**
+ * use-scroll-animate/components/layout — layout animation (v3.6).
+ * `autoAnimate()` / `<usa-auto-animate>` (list & grid reflow),
+ * `<usa-masonry>`, and `sharedTransition()` for shared-element transitions
+ * (View Transitions API with a FLIP fallback).
+ */
+
+/** Register every component of this category under its default tag. */
+declare function defineLayoutComponents(): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        'usa-auto-animate': UsaAutoAnimateElement;
+        'usa-masonry': UsaMasonryElement;
+    }
+}
+
+export { autoAnimate, configureComponents, defineAutoAnimate, defineLayoutComponents, defineMasonry, flipFrames, masonryLayout, prefersReducedMotion, sharedTransition };
+export type { AutoAnimateOptions, ComponentsConfig, SharedOptions, UsaAutoAnimateElement, UsaElement, UsaMasonryElement };