use-scroll-animate 8.9.0 → 9.0.0

package/dist/components/effects.d.cts

@@ -369,12 +369,12 @@ type DeepPartialTokens = {
  * ship with them: `neon-flicker`, `paper-fold`, `glass-shine`,
  * `retro-scanlines`, `brutal-shift`.
  *
- * - `applyTheme(name, root?)` — on `<html>` (default) it also makes the motion
+ * - `applyMotionTheme(name, root?)` — on `<html>` (default) it also makes the motion
  *   tokens active for `motionToken()`; on any other element the tokens are
  *   only written as variables there. Returns an undo.
  * - `themePreset(name, role)`, `playThemeEffect(el, role)` (theme of the
  *   closest `[data-usa-theme]`).
- * - `<usa-theme name="neon">` — scopes a theme to its subtree and binds the
+ * - `<usa-motion-theme name="neon">` — scopes a theme to its subtree and binds the
  *   presets to children with `data-theme-fx="click | hover | enter | attention"`.
  */
 
@@ -392,21 +392,12 @@ interface ThemePack {
         options?: Record<string, unknown>;
     }>;
 }
-declare const THEMES: Record<string, ThemePack>;
-declare const THEME_NAMES: string[];
-/** The 5.8 motion theme packs (8.9 name of `THEMES`). */
 declare const MOTION_THEMES: Record<string, ThemePack>;
-/** Names of the 5.8 motion theme packs (8.9 name of `THEME_NAMES`). */
 declare const MOTION_THEME_NAMES: string[];
 /** The CSS custom properties of a theme (design + motion tokens). */
 declare function themeVars(t: string | ThemePack): Record<string, string>;
 /** A theme as a CSS rule (`selector` default `[data-usa-theme=<name>]`) — for SSR / static CSS. */
 declare function themeCss(t: string | ThemePack, selector?: string): string;
-/**
- * Apply a motion theme to `root` (default `<html>`). Returns an undo.
- * @deprecated 8.9 — removed in 9.0. Use `applyMotionTheme()` (same signature); `npx usa-codemod-9 --write src`.
- */
-declare function applyTheme(t: string | ThemePack, root?: HTMLElement): () => void;
 /** Apply a 5.8 motion theme to `root` (default `<html>`). Returns an undo (8.9). */
 declare function applyMotionTheme(t: string | ThemePack, root?: HTMLElement): () => void;
 /** The effect preset of a theme for a role. */
@@ -421,8 +412,6 @@ interface UsaThemeElement extends UsaElement {
     readonly theme: string;
 }
 /** `<usa-theme name="neon | paper | glass | retro | brutalist">` — a themed subtree. */
-declare function defineTheme(tag?: string): CustomElementConstructor | undefined;
-/** `<usa-motion-theme name="neon">` — the 8.9 name of `<usa-theme>` (removed in 9.0). */
 declare function defineMotionTheme(tag?: string): CustomElementConstructor | undefined;
 
 interface AnimationTrack {
@@ -552,5 +541,5 @@ declare function defineEffectElements(): void;
 /** Register the built-ins and every pack (idempotent). */
 declare function registerAllEffects(): void;
 
-export { ANIMATION_FORMAT, AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, STORY_TEMPLATES, THEMES, THEME_FX, THEME_NAMES, THEME_ROLES, angleDelta, applyMotionTheme, applyTheme, bindBeat, bindGesture, bounceKeyframes, bumpCount, canvasBackground, createBeatDetector, createPlayer, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, defineTheme, disableAudio, enableAudio, flingVelocity, formatCount, fxLayer, getAudio, hexRgb, noise2, normalizeAnimation, onBeat, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, storyProgress, swapLabel, themeCss, themePreset, themeVars, togglePressed };
+export { ANIMATION_FORMAT, AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, STORY_TEMPLATES, THEME_FX, THEME_ROLES, angleDelta, applyMotionTheme, bindBeat, bindGesture, bounceKeyframes, bumpCount, canvasBackground, createBeatDetector, createPlayer, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, disableAudio, enableAudio, flingVelocity, formatCount, fxLayer, getAudio, hexRgb, noise2, normalizeAnimation, onBeat, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, storyProgress, swapLabel, themeCss, themePreset, themeVars, togglePressed };
 export type { AnimationJSON, AnimationTrack, AudioInput, AudioReactive, AudioSample, BeatOptions, GenFrame, GenerativeSpec, GestureDetail, GestureFxOptions, GestureName, Player, SpringOptions, StoryTemplate, ThemePack, ThemeRole, UsaAudioElement, UsaGestureFxElement, UsaPlayerElement, UsaStoryElement, UsaThemeElement };

package/dist/components/effects.d.ts

@@ -369,12 +369,12 @@ type DeepPartialTokens = {
  * ship with them: `neon-flicker`, `paper-fold`, `glass-shine`,
  * `retro-scanlines`, `brutal-shift`.
  *
- * - `applyTheme(name, root?)` — on `<html>` (default) it also makes the motion
+ * - `applyMotionTheme(name, root?)` — on `<html>` (default) it also makes the motion
  *   tokens active for `motionToken()`; on any other element the tokens are
  *   only written as variables there. Returns an undo.
  * - `themePreset(name, role)`, `playThemeEffect(el, role)` (theme of the
  *   closest `[data-usa-theme]`).
- * - `<usa-theme name="neon">` — scopes a theme to its subtree and binds the
+ * - `<usa-motion-theme name="neon">` — scopes a theme to its subtree and binds the
  *   presets to children with `data-theme-fx="click | hover | enter | attention"`.
  */
 
@@ -392,21 +392,12 @@ interface ThemePack {
         options?: Record<string, unknown>;
     }>;
 }
-declare const THEMES: Record<string, ThemePack>;
-declare const THEME_NAMES: string[];
-/** The 5.8 motion theme packs (8.9 name of `THEMES`). */
 declare const MOTION_THEMES: Record<string, ThemePack>;
-/** Names of the 5.8 motion theme packs (8.9 name of `THEME_NAMES`). */
 declare const MOTION_THEME_NAMES: string[];
 /** The CSS custom properties of a theme (design + motion tokens). */
 declare function themeVars(t: string | ThemePack): Record<string, string>;
 /** A theme as a CSS rule (`selector` default `[data-usa-theme=<name>]`) — for SSR / static CSS. */
 declare function themeCss(t: string | ThemePack, selector?: string): string;
-/**
- * Apply a motion theme to `root` (default `<html>`). Returns an undo.
- * @deprecated 8.9 — removed in 9.0. Use `applyMotionTheme()` (same signature); `npx usa-codemod-9 --write src`.
- */
-declare function applyTheme(t: string | ThemePack, root?: HTMLElement): () => void;
 /** Apply a 5.8 motion theme to `root` (default `<html>`). Returns an undo (8.9). */
 declare function applyMotionTheme(t: string | ThemePack, root?: HTMLElement): () => void;
 /** The effect preset of a theme for a role. */
@@ -421,8 +412,6 @@ interface UsaThemeElement extends UsaElement {
     readonly theme: string;
 }
 /** `<usa-theme name="neon | paper | glass | retro | brutalist">` — a themed subtree. */
-declare function defineTheme(tag?: string): CustomElementConstructor | undefined;
-/** `<usa-motion-theme name="neon">` — the 8.9 name of `<usa-theme>` (removed in 9.0). */
 declare function defineMotionTheme(tag?: string): CustomElementConstructor | undefined;
 
 interface AnimationTrack {
@@ -552,5 +541,5 @@ declare function defineEffectElements(): void;
 /** Register the built-ins and every pack (idempotent). */
 declare function registerAllEffects(): void;
 
-export { ANIMATION_FORMAT, AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, STORY_TEMPLATES, THEMES, THEME_FX, THEME_NAMES, THEME_ROLES, angleDelta, applyMotionTheme, applyTheme, bindBeat, bindGesture, bounceKeyframes, bumpCount, canvasBackground, createBeatDetector, createPlayer, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, defineTheme, disableAudio, enableAudio, flingVelocity, formatCount, fxLayer, getAudio, hexRgb, noise2, normalizeAnimation, onBeat, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, storyProgress, swapLabel, themeCss, themePreset, themeVars, togglePressed };
+export { ANIMATION_FORMAT, AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, STORY_TEMPLATES, THEME_FX, THEME_ROLES, angleDelta, applyMotionTheme, bindBeat, bindGesture, bounceKeyframes, bumpCount, canvasBackground, createBeatDetector, createPlayer, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, disableAudio, enableAudio, flingVelocity, formatCount, fxLayer, getAudio, hexRgb, noise2, normalizeAnimation, onBeat, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, storyProgress, swapLabel, themeCss, themePreset, themeVars, togglePressed };
 export type { AnimationJSON, AnimationTrack, AudioInput, AudioReactive, AudioSample, BeatOptions, GenFrame, GenerativeSpec, GestureDetail, GestureFxOptions, GestureName, Player, SpringOptions, StoryTemplate, ThemePack, ThemeRole, UsaAudioElement, UsaGestureFxElement, UsaPlayerElement, UsaStoryElement, UsaThemeElement };

package/dist/components/effects.js

@@ -7,7 +7,7 @@ export { n as noise2 } from '../chunks/generative-2LhxG5BJ.js';
 import { A as AUDIO_FX, d as defineAudio } from '../chunks/audio-CynhhWDi.js';
 export { b as bindBeat, c as createBeatDetector, a as disableAudio, e as enableAudio, g as getAudio, o as onBeat } from '../chunks/audio-CynhhWDi.js';
 import { playEffect, bindEffect, registerEffects } from '../chunks/registry-CnO7ZVPK.js';
-import { u as defineElement, B as adoptStyles, C as deprecate } from '../chunks/base-CLuqlLfG.js';
+import { u as defineElement, B as adoptStyles } from '../chunks/base-CLuqlLfG.js';
 import { applyMotionTokens, motionTokensToVars, mergeMotionTokens } from './tokens.js';
 import '../chunks/builtins-Bs4smevg.js';
 import '../chunks/core-CiN5sqxB.js';
@@ -1125,7 +1125,7 @@ const P = (enter, hover, click, attention, background) => ({
     attention: { effect: attention },
     background: { effect: background },
 });
-const THEMES = {
+const MOTION_THEMES = {
     neon: {
         name: 'neon',
         vars: { bg: '#07070c', fg: '#e8e8ff', accent: '#22d3ee', 'accent-2': '#ff2bd6', surface: '#11111c', border: '1px solid #22d3ee', radius: '10px', shadow: '0 0 18px #22d3ee66, inset 0 0 12px #ff2bd622', font: 'ui-monospace, SFMono-Regular, Menlo, monospace' },
@@ -1157,19 +1157,15 @@ const THEMES = {
         presets: P('drop-bounce', 'jelly', 'brutal-shift', 'shake', 'voronoi'),
     },
 };
-const THEME_NAMES = Object.keys(THEMES);
-/** The 5.8 motion theme packs (8.9 name of `THEMES`). */
-const MOTION_THEMES = THEMES;
-/** Names of the 5.8 motion theme packs (8.9 name of `THEME_NAMES`). */
-const MOTION_THEME_NAMES = THEME_NAMES;
+const MOTION_THEME_NAMES = Object.keys(MOTION_THEMES);
 const BASE_CSS = `[data-usa-theme]{background:var(--usa-theme-bg);color:var(--usa-theme-fg);font-family:var(--usa-theme-font)}
 [data-usa-theme] .usa-surface{background:var(--usa-theme-surface);border:var(--usa-theme-border);border-radius:var(--usa-theme-radius);box-shadow:var(--usa-theme-shadow)}
 [data-usa-theme] .usa-accent{color:var(--usa-theme-accent)}
 [data-usa-theme=glass] .usa-surface{-webkit-backdrop-filter:blur(14px);backdrop-filter:blur(14px)}`;
 const pack = (t) => {
-    const p = typeof t === 'string' ? THEMES[t] : t;
+    const p = typeof t === 'string' ? MOTION_THEMES[t] : t;
     if (!p)
-        throw new Error(`[motionary] unknown theme "${String(t)}" — ${THEME_NAMES.join(', ')}`);
+        throw new Error(`[motionary] unknown theme "${String(t)}" — ${MOTION_THEME_NAMES.join(', ')}`);
     return p;
 };
 /** The CSS custom properties of a theme (design + motion tokens). */
@@ -1185,14 +1181,6 @@ function themeCss(t, selector) {
     const p = pack(t);
     return `${selector || `[data-usa-theme=${p.name}]`}{${Object.entries(themeVars(p)).map(([k, v]) => `${k}:${v}`).join(';')}}`;
 }
-/**
- * Apply a motion theme to `root` (default `<html>`). Returns an undo.
- * @deprecated 8.9 — removed in 9.0. Use `applyMotionTheme()` (same signature); `npx usa-codemod-9 --write src`.
- */
-function applyTheme(t, root) {
-    deprecate('applyTheme', 'applyTheme() is deprecated and removed in 9.0 — use applyMotionTheme() (same signature). Run `npx usa-codemod-9 --write src`.');
-    return applyMotionTheme(t, root);
-}
 /** Apply a 5.8 motion theme to `root` (default `<html>`). Returns an undo (8.9). */
 function applyMotionTheme(t, root) {
     const p = pack(t);
@@ -1283,18 +1271,16 @@ const THEME_FX = [
     },
 ];
 /** `<usa-theme name="neon | paper | glass | retro | brutalist">` — a themed subtree. */
-function defineTheme(tag = 'usa-theme') {
+function defineMotionTheme(tag = 'usa-motion-theme') {
     return defineElement(tag, (Base) => class UsaTheme extends Base {
         static get observedAttributes() {
             return ['name'];
         }
         get theme() {
             const n = this.str('name', 'neon');
-            return THEMES[n] ? n : 'neon';
+            return MOTION_THEMES[n] ? n : 'neon';
         }
         mount() {
-            if (this.localName === 'usa-theme')
-                deprecate('usa-theme', '<usa-theme> is deprecated and removed in 9.0 — use <usa-motion-theme> (same name / data-theme-fx). Run `npx usa-codemod-9 --write src`.');
             this.onCleanup(applyMotionTheme(this.theme, this));
             this.querySelectorAll('[data-theme-fx]').forEach((el) => {
                 const role = (el.dataset.themeFx || 'click');
@@ -1312,10 +1298,6 @@ function defineTheme(tag = 'usa-theme') {
         }
     }, { id: 'usa-theme-el', text: 'usa-theme{display:block}' });
 }
-/** `<usa-motion-theme name="neon">` — the 8.9 name of `<usa-theme>` (removed in 9.0). */
-function defineMotionTheme(tag = 'usa-motion-theme') {
-    return defineTheme(tag);
-}
 
 /**
  * motionary/components/effects — the 5.x effect packs, all
@@ -1374,7 +1356,6 @@ function defineEffectElements() {
     defineStory();
     defineAudio();
     defineGestureFx();
-    defineTheme();
     defineMotionTheme();
     definePlayer();
 }
@@ -1385,5 +1366,5 @@ function registerAllEffects() {
         registerEffects(defs);
 }
 
-export { AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, THEMES, THEME_FX, THEME_NAMES, THEME_ROLES, angleDelta, applyMotionTheme, applyTheme, bindGesture, bounceKeyframes, bumpCount, canvasBackground, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, defineTheme, flingVelocity, fxLayer, hexRgb, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, swapLabel, themeCss, themePreset, themeVars, togglePressed };
+export { AUDIO_FX, CARD_FX, CLICK_FX, CURSOR_FX, EFFECT_PACKS, GENERATIVE_FX, GESTURES, MICRO_FX, MOTION_THEMES, MOTION_THEME_NAMES, PAGE_FX, PHYSICS_FX, THEME_FX, THEME_ROLES, angleDelta, applyMotionTheme, bindGesture, bounceKeyframes, bumpCount, canvasBackground, defineAudio, defineEffectElements, defineGestureFx, defineMotionTheme, definePlayer, defineStory, flingVelocity, fxLayer, hexRgb, playThemeEffect, registerAllEffects, registerAudioEffects, registerCardClickEffects, registerCursorEffects, registerGenerativeEffects, registerMicroEffects, registerPageEffects, registerPhysicsEffects, solveSpring, springKeyframes, swapLabel, themeCss, themePreset, themeVars, togglePressed };
 //# sourceMappingURL=effects.js.map