@blukavantui/community 1.1.0 → 1.2.0

package/src/web-motion/select-ripple.ts

@@ -0,0 +1,23 @@
+import type {MotionController,MotionOptions} from '../motion/controller.js';
+import {createRipple} from '../motion/optional.js';
+
+/** Decorate an actual open/close or selection change, after Select has updated
+ * its label. The component continues to own focus, keyboard and value events. */
+export function enhanceSelectRipple(root:HTMLElement,motion:MotionController,timing:MotionOptions={}) {
+  let dead=false,frame=0,current:ReturnType<typeof createRipple>|undefined;
+  const state=()=>root.querySelector('.blu-select__trigger')?.getAttribute('aria-expanded')+'|'+root.querySelector<HTMLSelectElement>('.blu-select__native')?.value;
+  const activate=(event:Event)=>{
+    if(!(event.target instanceof Element)||!event.target.closest('.blu-select'))return;
+    const trigger=root.querySelector<HTMLButtonElement>('.blu-select__trigger');
+    if(!trigger||trigger.disabled||trigger.getAttribute('aria-readonly')==='true')return;
+    if(event instanceof KeyboardEvent&&!['Enter',' ','ArrowDown','ArrowUp','Home','End'].includes(event.key))return;
+    const before=state();
+    const point=event instanceof MouseEvent&&event.detail>0&&event.target.closest('.blu-select__trigger')?{clientX:event.clientX,clientY:event.clientY}:undefined;
+    cancelAnimationFrame(frame);frame=requestAnimationFrame(()=>{
+      frame=0;if(dead||!root.contains(trigger)||trigger.disabled||motion.mode!=='full'||state()===before)return;
+      current?.destroy();current=createRipple(trigger,motion,{duration:1000,easing:'ease-out',...timing,listen:false});current.play(point);
+    });
+  };
+  root.addEventListener('click',activate,true);root.addEventListener('keydown',activate,true);
+  return {destroy(){if(dead)return;dead=true;cancelAnimationFrame(frame);root.removeEventListener('click',activate,true);root.removeEventListener('keydown',activate,true);current?.destroy();}};
+}

package/src/web-motion/statistic.ts

@@ -0,0 +1,23 @@
+import type {MotionController} from '../motion/controller.js';
+import {createNumberTransition} from '../motion/value.js';
+type Values={Value?:number;Precision?:number;Locale?:string;IsLoading?:boolean};
+/** Exact value remains accessible throughout the decorative number transition. */
+export function enhanceStatistic(root:HTMLElement,motion:MotionController,read:()=>Values) {
+  const previousKind=root.getAttribute('data-blu-component-motion');root.setAttribute('data-blu-component-motion','statistic');
+  let dead=false,target:HTMLElement|null=null,previous=read().Value??0;
+  let number:ReturnType<typeof createNumberTransition>|undefined;
+  const sync=()=>{
+    if(dead)return;
+    const next=root.querySelector<HTMLElement>('.blu-statistic__value > strong');
+    if(next===target)return;
+    number?.destroy();number=undefined;target=next;
+    if(!next)return;
+    const options=read(),value=Number(options.Value??0);
+    if(!Number.isFinite(value))return;
+    const formatter=new Intl.NumberFormat(options.Locale||'en-US',{minimumFractionDigits:options.Precision??0,maximumFractionDigits:options.Precision??0});
+    number=createNumberTransition(next,motion,{value:previous,format:v=>formatter.format(v)});
+    void number.set(value,{duration:750,easing:'ease-in-out'});previous=value;
+  };
+  sync();const observer=new MutationObserver(sync);observer.observe(root,{childList:true,subtree:true});
+  return {capture(){},destroy(){if(dead)return;dead=true;observer.disconnect();number?.destroy();if(previousKind===null)root.removeAttribute('data-blu-component-motion');else root.setAttribute('data-blu-component-motion',previousKind);}};
+}

package/src/web-motion/surfaces.ts

@@ -0,0 +1,137 @@
+import type { MotionController, MotionEffect } from '../motion/controller.js';
+
+/** Existing components own focus trapping, dismissal and events; the first dialog
+ * presentation receives named context after paint. A closing surface is an inert,
+ * short-lived visual copy; its bounds are frozen so focus restoration cannot reflow it.
+ */
+export function observeSurface(root: HTMLElement, motion: MotionController, kind: 'modal' | 'drawer' | 'palette' | 'select' | 'picker' | 'cascader' | 'tree-select') {
+  const previous = root.getAttribute('data-blu-surface-motion'); root.setAttribute('data-blu-surface-motion', kind);
+  const selector = kind === 'cascader' ? '.blu-cascader__popup' : kind === 'tree-select' ? '.blu-tree-select__popup' : kind === 'picker' ? '.blu-picker__popup' : kind === 'select' ? '.blu-select__popup' : kind === 'palette' ? '.blu-command__dialog' : '.blu-overlay';
+  let target: HTMLElement | null = null, wasOpen = false, destroyed = false, revision = 0, trackingFrame = 0, exitDeadline = 0;
+  let dialogFocusFrame = 0, dialogPresented = false;
+  let ghost: HTMLElement | null = null, ghostTargets: HTMLElement[] = [], rect: DOMRect | undefined, panelRect: DOMRect | undefined;
+  let font = '', background = '', color = '', backdrop = '#18223066', blur = 'none', opacity = '1', panelOpacity = '1', scrollPositions: number[] = [];
+  const win = root.ownerDocument.defaultView!;
+  function isOpen(node: HTMLElement) { return kind === 'palette' ? (node as HTMLDialogElement).open : !node.hidden; }
+  function entrance(): MotionEffect {
+    if (kind !== 'drawer') return kind === 'modal' ? 'scale' : 'slide-down';
+    return target?.dataset.placement === 'left' ? 'slide-right' : target?.dataset.placement === 'bottom' ? 'slide-up' : 'slide-left';
+  }
+  function remember() {
+    if (!target || !isOpen(target)) return;
+    const panel = target.querySelector<HTMLElement>('.blu-overlay__panel') || target;
+    rect = target.getBoundingClientRect(); panelRect = panel.getBoundingClientRect();
+    const css = win.getComputedStyle(target); font = css.font; background = css.backgroundColor; color = css.color;
+    opacity = panel === target ? '1' : css.opacity; panelOpacity = win.getComputedStyle(panel).opacity;
+    if (kind === 'palette') { const scrim = win.getComputedStyle(target, '::backdrop'); backdrop = scrim.backgroundColor; blur = scrim.backdropFilter; }
+    scrollPositions = [target, ...Array.from(target.querySelectorAll<HTMLElement>('*'))].map(el => el.scrollTop);
+  }
+  function stopTracking() { win.cancelAnimationFrame(trackingFrame); trackingFrame = 0; }
+  function cancelDialogFocus() { win.cancelAnimationFrame(dialogFocusFrame); dialogFocusFrame = 0; }
+  function clearGhost() {
+    ++revision;
+    win.clearTimeout(exitDeadline); exitDeadline = 0;
+    for (const element of ghostTargets) motion.cancel(element); ghostTargets = [];
+    ghost?.remove(); ghost = null;
+  }
+  function frozenBounds(element: HTMLElement, box: DOMRect) {
+    Object.assign(element.style, { position: 'fixed', boxSizing: 'border-box', inset: 'auto', left: box.left + 'px', top: box.top + 'px', width: box.width + 'px', height: box.height + 'px', maxWidth: 'none', maxHeight: 'none', margin: '0', transform: 'none' });
+  }
+  function closingCopy(node: HTMLElement) {
+    if (node.ownerDocument.querySelector('.blu-overlay:not([hidden]):not([data-blu-exit-visual]), dialog[open]')) return;
+    if (!rect?.width || !rect.height || !node.isConnected || node.querySelector('video,canvas,iframe')) return;
+    const copy = node.cloneNode(true) as HTMLElement;
+    const sourceNodes = [node, ...Array.from(node.querySelectorAll<HTMLElement>('*'))], copyNodes = [copy, ...Array.from(copy.querySelectorAll<HTMLElement>('*'))];
+    copyNodes.forEach((el, index) => {
+      if (index && el.hasAttribute('popover')) el.hidden = true;
+      for (const name of ['id','name','autofocus','popover','aria-live','aria-labelledby','aria-describedby','aria-controls']) el.removeAttribute(name);
+      // Inert + no names prevent interaction/submission. Preserve enabled styles to avoid a flash.
+      if (el instanceof HTMLInputElement) { const source = sourceNodes[index] as HTMLInputElement; el.value = source.type === 'password' ? '' : source.value; el.checked = source.checked; }
+      else if (el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) el.value = (sourceNodes[index] as HTMLTextAreaElement).value;
+      el.style.pointerEvents = 'none';
+    });
+    copy.hidden = false; copy.inert = true; copy.setAttribute('aria-hidden', 'true');
+    const parent = node.parentElement!;
+    if (kind === 'modal' || kind === 'drawer') { ghost = copy; parent.append(copy); }
+    else {
+      const portal = node.ownerDocument.createElement('div');
+      portal.className = kind === 'palette' ? 'blu-command blu-motion-exit-surface' : 'blu-motion-exit-surface';
+      portal.style.cssText = `position:fixed;inset:0;width:100vw;height:100dvh;margin:0;padding:0;border:0;max-width:none;max-height:none;background:${kind === 'palette' ? backdrop : 'transparent'};backdrop-filter:${kind === 'palette' ? blur : 'none'};overflow:visible;pointer-events:none;`;
+      if (kind === 'palette') {
+        const surface = node.ownerDocument.createElement('div'); surface.className = copy.className; surface.append(...Array.from(copy.childNodes));
+        frozenBounds(surface, rect); Object.assign(surface.style, { background, color, font }); portal.append(surface);
+      } else { frozenBounds(copy, rect); copy.style.font = font; portal.append(copy); }
+      ghost = portal; parent.append(portal);
+    }
+    ghost.dataset.bluExitVisual = kind; ghost.inert = true; ghost.setAttribute('aria-hidden', 'true'); ghost.style.pointerEvents = 'none';
+    ghost.setAttribute('popover', 'manual');
+    if (ghost.showPopover) { try { ghost.showPopover(); } catch { ghost.removeAttribute('popover'); } }
+    const visual = ghost.querySelector<HTMLElement>('.blu-overlay__panel, .blu-command__dialog, .blu-select__popup, .blu-picker__popup') || ghost;
+    if (panelRect && (kind === 'modal' || kind === 'drawer')) frozenBounds(visual, panelRect);
+    visual.style.opacity = panelOpacity;
+    copyNodes.forEach((el, index) => { el.scrollTop = scrollPositions[index] || 0; });
+    // Fade exactly one layer. Fading both the parent and child multiplies opacity and
+    // makes the content disappear ahead of its backdrop. Popup exits do not rescale.
+    const own = revision, tasks = [motion.animate(ghost, [{ opacity }, { opacity: 0 }], { phase: 'exit', duration: 450, easing: 'ease-in-out' }, 'fade')];
+    ghostTargets = [ghost];
+    if (kind === 'drawer') {
+      const direction = node.dataset.placement === 'left' ? 'translateX(-18px)' : node.dataset.placement === 'bottom' ? 'translateY(18px)' : 'translateX(18px)';
+      ghostTargets.push(visual);
+      tasks.push(motion.animate(visual, [{ transform: 'none' }, { transform: direction }], { duration: 450, easing: 'ease-in-out' }));
+    }
+    // Some browsers suspend WAAPI for off-screen/inert top-layer visuals. The
+    // real popup has already closed; never let a paused cosmetic copy linger.
+    exitDeadline = win.setTimeout(() => { if (!destroyed && own === revision) clearGhost(); }, (motion.resolveOptions?.({ duration: 450 }).duration ?? (motion.mode === 'full' ? 450 : 200)) + 250);
+    void Promise.all(tasks).finally(() => { if (!destroyed && own === revision) clearGhost(); });
+  }
+  const resize = new ResizeObserver(() => { if (wasOpen) remember(); });
+  function sync() {
+    if (destroyed) return;
+    const next = root.matches(selector) ? root : root.querySelector<HTMLElement>(selector);
+    if (target !== next) { if (target) resize.unobserve(target); target = next; wasOpen = false; if (target) resize.observe(target); }
+    if (!target) return;
+    const open = isOpen(target);
+    if (open === wasOpen) return;
+    wasOpen = open; stopTracking(); cancelDialogFocus(); clearGhost();
+    const panel = target.querySelector<HTMLElement>('.blu-overlay__panel') || target;
+    motion.cancel(panel); motion.cancel(target);
+    if (open) {
+      remember(); const own = revision;
+      // Safari can announce only "button" when focus enters a newly exposed
+      // popover before its dialog subtree has reached the accessibility tree.
+      // On the first presentation, focus the named dialog after paint. Never
+      // override navigation the user has already made inside that dialog.
+      if ((kind === 'modal' || kind === 'drawer') && !dialogPresented) {
+        const initialFocus = root.ownerDocument.activeElement;
+        dialogFocusFrame = win.requestAnimationFrame(() => {
+          dialogFocusFrame = win.requestAnimationFrame(() => {
+            dialogFocusFrame = 0;
+            if (destroyed || !wasOpen || own !== revision) return;
+            dialogPresented = true;
+            if (panel.contains(initialFocus) && root.ownerDocument.activeElement === initialFocus) panel.focus({ preventScroll: true });
+          });
+        });
+      }
+      const tasks = [motion.play(panel, entrance(), { duration: kind === 'drawer' ? 450 : 350, easing: 'ease-out' })];
+      if (panel !== target) tasks.push(motion.play(target, 'fade', { duration: 280 }));
+      // ResizeObserver does not observe transforms. Track opening frames and record
+      // the final resting bounds, rather than reusing a partly translated/scaled box.
+      const trackOpening = () => { if (destroyed || !wasOpen || own !== revision) return; remember(); trackingFrame = win.requestAnimationFrame(trackOpening); };
+      trackingFrame = win.requestAnimationFrame(trackOpening);
+      void Promise.all(tasks).then(() => { if (!destroyed && wasOpen && own === revision) { stopTracking(); remember(); } });
+    } else if (motion.mode !== 'off' && !root.closest('.blu-motion-off, [data-blu-motion="off"]')) closingCopy(target);
+  }
+  const observer = new MutationObserver(sync);
+  observer.observe(root, { subtree: true, childList: true, attributes: true, attributeFilter: ['hidden', 'open'] });
+  const track = () => { if (wasOpen) remember(); };
+  win.addEventListener('resize', track); win.addEventListener('scroll', track, true);
+  root.ownerDocument.addEventListener('pointerdown', track, true); root.ownerDocument.addEventListener('keydown', track, true);
+  sync();
+  return { sync, capture: remember, destroy() {
+    if (destroyed) return; destroyed = true; stopTracking(); cancelDialogFocus(); observer.disconnect(); resize.disconnect(); clearGhost();
+    if (previous === null) root.removeAttribute('data-blu-surface-motion'); else root.setAttribute('data-blu-surface-motion', previous);
+    win.removeEventListener('resize', track); win.removeEventListener('scroll', track, true);
+    root.ownerDocument.removeEventListener('pointerdown', track, true); root.ownerDocument.removeEventListener('keydown', track, true);
+    if (target) { motion.cancel(target); const panel = target.querySelector<HTMLElement>('.blu-overlay__panel'); if (panel) motion.cancel(panel); }
+  } };
+}

package/src/web-motion/tree.ts

@@ -0,0 +1,44 @@
+import type { MotionController } from '../motion/controller.js';
+import { preserveStyles } from '../motion/structure.js';
+
+/** The tree runtime owns hidden/expanded state and keyboard navigation. During a
+ * full-motion collapse only, keep the inert visual in layout until it reaches zero. */
+export function enhanceTree(root: HTMLElement, motion: MotionController) {
+  const previous = root.getAttribute('data-blu-component-motion'); root.setAttribute('data-blu-component-motion', 'tree');
+  type State = { open: boolean; height: number; revision: number; release(): void };
+  const groups = new Map<HTMLElement, State>(); let dead = false;
+  const resize = new ResizeObserver(entries => {
+    for (const entry of entries) { const el = entry.target as HTMLElement, state = groups.get(el); if (state && (!el.hidden || el.style.display === 'block')) state.height = el.getBoundingClientRect().height; }
+  });
+  function sync() {
+    if (dead) return;
+    for (const [group, state] of groups) if (!root.contains(group)) { ++state.revision; motion.cancel(group); state.release(); resize.unobserve(group); groups.delete(group); }
+    for (const group of root.querySelectorAll<HTMLElement>('.blu-tree__group')) {
+      let state = groups.get(group);
+      if (!state) { state = { open: !group.hidden, height: group.getBoundingClientRect().height, revision: 0, release() {} }; groups.set(group, state); resize.observe(group); continue; }
+      const open = !group.hidden;
+      if (state.open === open) continue;
+      const from = state.height, own = ++state.revision;
+      state.open = open; motion.cancel(group); state.release(); state.release = () => {};
+      if (group.parentElement?.closest('[hidden]')) continue;
+      const full = motion.mode === 'full' && !group.closest('.blu-motion-off,[data-blu-motion=off],[data-blu-motion=reduced]');
+      if (!full) { if (open) void motion.play(group, 'fade', { duration: 350 }); continue; }
+      const restore = preserveStyles(group, ['display', 'overflow', 'height']);
+      const inert = group.inert, ariaHidden = group.getAttribute('aria-hidden');
+      state.release = () => { restore(); group.inert = inert; if (ariaHidden === null) group.removeAttribute('aria-hidden'); else group.setAttribute('aria-hidden', ariaHidden); };
+      if (!open) { group.inert = true; group.setAttribute('aria-hidden', 'true'); group.style.setProperty('display', 'block', 'important'); }
+      const to = open ? group.scrollHeight : 0;
+      group.style.overflow = 'hidden'; group.style.height = to + 'px';
+      void motion.animate(group, [{ height: from + 'px' }, { height: to + 'px' }], { duration: 650, easing: 'ease-in-out' }).then(() => {
+        if (!dead && state!.revision === own) { state!.release(); state!.release = () => {}; state!.height = group.getBoundingClientRect().height; }
+      });
+    }
+  }
+  const observer = new MutationObserver(sync); sync();
+  observer.observe(root, { subtree: true, childList: true, attributes: true, attributeFilter: ['hidden'] });
+  return { destroy() {
+    if (dead) return; dead = true; observer.disconnect(); resize.disconnect();
+    for (const [group, state] of groups) { ++state.revision; motion.cancel(group); state.release(); } groups.clear();
+    if (previous === null) root.removeAttribute('data-blu-component-motion'); else root.setAttribute('data-blu-component-motion', previous);
+  } };
+}

package/styles/component-motion.css

@@ -0,0 +1,39 @@
+/* Opt-in web motion. Existing components remain unchanged without the integration. */
+[data-blu-component-motion=field] :is(.blu-text,.blu-textarea,.blu-select__trigger,.blu-choice__mark,.blu-text__action){transition:background-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),border-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),box-shadow var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease)}
+[data-blu-component-motion=field] .blu-choice--switch .blu-choice__mark::after{transition:transform var(--blu-component-motion-duration,320ms) var(--blu-component-motion-ease,cubic-bezier(.2,.8,.2,1))}
+[data-blu-component-motion=field] .blu-choice--radio .blu-choice__mark::after{content:'';width:7px;height:7px;border-radius:50%;background:currentColor;transform:scale(0);transition:transform var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease-out)}
+[data-blu-component-motion=field] .blu-choice--radio input:checked+.blu-choice__mark::after{transform:scale(1)}
+[data-blu-component-motion=field] .blu-select__trigger::after{transition:transform var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease-out)}
+[data-blu-component-motion=field] .blu-select__trigger[aria-expanded=true]::after{transform:translateY(2px) rotate(225deg)}
+[data-blu-exit-visual] :disabled{opacity:1!important}
+/* Focus rings and validation semantics stay immediate; only decorative feedback moves. */
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-component-motion=field] *,
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-component-motion=field] *::after{transition:none!important;animation:none!important}
+@media(prefers-reduced-motion:reduce){[data-blu-component-motion=field] *,[data-blu-component-motion=field] *::after{transition:none!important;animation:none!important}}
+[data-blu-surface-motion] :is(.blu-select__option,.blu-command__option,.blu-control){transition:background-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),border-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-surface-motion] *{transition:none!important}
+@media(prefers-reduced-motion:reduce){[data-blu-surface-motion] *{transition:none!important}}
+/* Side drawers meet both viewport edges; the content scrolls between fixed header/footer. */
+[data-blu-surface-motion=drawer].blu-overlay:is([data-placement=left],[data-placement=right]){padding:0;align-items:stretch}
+[data-blu-surface-motion=drawer].blu-overlay:is([data-placement=left],[data-placement=right])>.blu-overlay__panel{margin:0;height:100dvh;max-height:100dvh;min-height:0;border-radius:0}
+[data-blu-surface-motion=drawer] :is(.blu-overlay__header,.blu-overlay__footer){flex-shrink:0}
+/* Existing notification keyframes are replaced by the scoped controller. */
+[data-blu-component-motion=notifications] .blu-notification{animation:none}
+[data-blu-component-motion=tree] .blu-tree__row{transition:background-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease)}
+[data-blu-surface-motion=picker] :is(.blu-picker__button,.blu-picker__input,.blu-picker__day){transition:background-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),border-color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease),color var(--blu-component-motion-duration,280ms) var(--blu-component-motion-ease,ease)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-component-motion=tree] *{transition:none!important}
+@media(prefers-reduced-motion:reduce){[data-blu-component-motion=tree] *{transition:none!important}}
+/* Web-only active-location markers: existing links retain focus and behavior. */
+.blu-motion-navigation-marker{position:absolute;display:block;border-radius:3px;background:var(--bluui-primary,#5144ed);pointer-events:none;transform-origin:top left;z-index:1}
+.blu-motion-navigation-marker[hidden]{display:none}
+.blu-motion-navigation-marker[data-kind=pagination]{box-sizing:border-box;border:2px solid var(--bluui-primary,#5144ed);border-radius:8px;background:transparent}
+[data-blu-navigation-motion] .blu-navigation-menu .blu-navigation-menu__link--active{color:var(--bluui-primary,#5144ed);background:var(--bluui-color-primary-soft,#efedff)}
+@media(forced-colors:active){.blu-motion-navigation-marker{background:Highlight}}
+@media(forced-colors:active){.blu-motion-navigation-marker[data-kind=pagination]{background:transparent;border-color:Highlight}}
+
+/* Shared finite transition settings; continuous loading keeps its own cadence. */
+.blu-motion-button.blu-button{transition-duration:var(--blu-component-motion-duration,var(--blu-motion-duration));transition-timing-function:var(--blu-component-motion-ease,var(--blu-motion-ease))}
+/* A preference may sit on the component root itself, not only its parent. */
+:is([data-blu-component-motion],[data-blu-surface-motion],[data-blu-navigation-motion]):is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *,
+:is([data-blu-component-motion],[data-blu-surface-motion],[data-blu-navigation-motion]):is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *::before,
+:is([data-blu-component-motion],[data-blu-surface-motion],[data-blu-navigation-motion]):is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *::after{transition:none!important;animation:none!important}

package/styles/data-motion.css

@@ -0,0 +1,4 @@
+.blu-data-motion-exits { position: absolute; inset: 0; overflow: hidden; pointer-events: none; z-index: 3; border-radius: inherit; }
+.blu-data-motion-exit { position: absolute; display: grid; background: var(--bluui-surface, #fff); color: var(--bluui-text-muted, #68758b); font-size: 13px; align-items: center; border-bottom: 1px solid var(--bluui-border, #dce3ed); pointer-events: none; }
+.blu-data-motion-exit > span { padding: 10px 12px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+@media (forced-colors: active) { .blu-data-motion-exits { display: none; } }

package/styles/motion-optional.css

@@ -0,0 +1,15 @@
+/* Opt-in decoration. Layers never consume pointer events or enter the accessibility tree. */
+.blu-motion-ripple,.blu-motion-shimmer{position:absolute;inset:0;overflow:hidden;border-radius:inherit;pointer-events:none!important}
+.blu-motion-ripple__wave{position:absolute;border-radius:50%;background:var(--blu-ripple-color,currentColor);pointer-events:none!important;opacity:0}
+.blu-motion-choice-ripple{inset:-10px;border-radius:999px;--blu-ripple-color:var(--bluui-primary,#4f46e5)}
+.blu-motion-shimmer__beam{position:absolute;inset:0;background:linear-gradient(100deg,transparent 20%,var(--blu-shimmer-color,#ffffffb8) 50%,transparent 80%);animation:blu-motion-shimmer var(--blu-shimmer-duration,1800ms) ease-in-out infinite}
+@keyframes blu-motion-shimmer{from{transform:translateX(-100%)}to{transform:translateX(100%)}}
+.blu-motion-shimmer[data-paused=true] .blu-motion-shimmer__beam{animation-play-state:paused}
+.blu-motion-icon{display:block;width:24px;height:24px;overflow:visible;fill:none;stroke:currentColor;stroke-width:1.8;stroke-linecap:round;stroke-linejoin:round;pointer-events:none}
+.blu-motion-emphasis{position:absolute;pointer-events:none!important;color:var(--blu-emphasis-color,currentColor)}
+.blu-motion-emphasis--underline{inset:auto 0 0;height:2px;background:currentColor;transform-origin:left center;border-radius:2px}
+.blu-motion-emphasis--border{inset:0;border-radius:inherit}
+.blu-motion-emphasis--border svg{display:block;width:100%;height:100%;fill:none;stroke:currentColor;stroke-width:2px}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) :is(.blu-motion-shimmer__beam,.blu-motion-ripple__wave){display:none;animation:none!important}
+@media(prefers-reduced-motion:reduce){.blu-motion-shimmer__beam,.blu-motion-ripple__wave{display:none;animation:none!important}}
+@media(forced-colors:active){.blu-motion-shimmer__beam,.blu-motion-ripple__wave{display:none}.blu-motion-emphasis{color:Highlight}}

package/styles/motion-presets.css

@@ -0,0 +1,92 @@
+/* Generated by scripts/build-motion-css.mjs. Edit src/motion/effects.ts, then regenerate. */
+.blu-motion-enter-fade, .blu-motion-fade-in { animation: blu-motion-enter-fade var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-fade { 0% { opacity: 0; } 100% { opacity: 1; } }
+.blu-motion-exit-fade, .blu-motion-fade-out { animation: blu-motion-exit-fade var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-fade { 0% { opacity: 1; } 100% { opacity: 0; } }
+.blu-motion-enter-slide-up, .blu-motion-slide-up { animation: blu-motion-enter-slide-up var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-slide-up { 0% { opacity: 0; transform: translateY(var(--blu-motion-distance)); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-slide-up { animation: blu-motion-exit-slide-up var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-slide-up { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: translateY(calc(-1 * var(--blu-motion-distance))); } }
+.blu-motion-enter-slide-down { animation: blu-motion-enter-slide-down var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-slide-down { 0% { opacity: 0; transform: translateY(calc(-1 * var(--blu-motion-distance))); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-slide-down { animation: blu-motion-exit-slide-down var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-slide-down { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: translateY(var(--blu-motion-distance)); } }
+.blu-motion-enter-slide-left { animation: blu-motion-enter-slide-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-slide-left { 0% { opacity: 0; transform: translateX(var(--blu-motion-distance)); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-slide-left { animation: blu-motion-exit-slide-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-slide-left { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: translateX(calc(-1 * var(--blu-motion-distance))); } }
+.blu-motion-enter-slide-right { animation: blu-motion-enter-slide-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-slide-right { 0% { opacity: 0; transform: translateX(calc(-1 * var(--blu-motion-distance))); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-slide-right { animation: blu-motion-exit-slide-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-slide-right { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: translateX(var(--blu-motion-distance)); } }
+.blu-motion-enter-zoom-in, .blu-motion-scale-in { animation: blu-motion-enter-zoom-in var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-zoom-in { 0% { opacity: 0; transform: scale(.92); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-zoom-in { animation: blu-motion-exit-zoom-in var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-zoom-in { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: scale(1.08); } }
+.blu-motion-enter-zoom-out { animation: blu-motion-enter-zoom-out var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-zoom-out { 0% { opacity: 0; transform: scale(1.08); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-zoom-out { animation: blu-motion-exit-zoom-out var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-zoom-out { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: scale(.92); } }
+.blu-motion-enter-rotate-left { animation: blu-motion-enter-rotate-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-rotate-left { 0% { opacity: 0; transform: rotate(8deg) scale(.97); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-rotate-left { animation: blu-motion-exit-rotate-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-rotate-left { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: rotate(-8deg) scale(.97); } }
+.blu-motion-enter-rotate-right { animation: blu-motion-enter-rotate-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-rotate-right { 0% { opacity: 0; transform: rotate(-8deg) scale(.97); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-rotate-right { animation: blu-motion-exit-rotate-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-rotate-right { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: rotate(8deg) scale(.97); } }
+.blu-motion-enter-flip-x { animation: blu-motion-enter-flip-x var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-flip-x { 0% { opacity: 0; transform: perspective(600px) rotateX(30deg); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-flip-x { animation: blu-motion-exit-flip-x var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-flip-x { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: perspective(600px) rotateX(-30deg); } }
+.blu-motion-enter-flip-y { animation: blu-motion-enter-flip-y var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-flip-y { 0% { opacity: 0; transform: perspective(600px) rotateY(30deg); } 100% { opacity: 1; transform: none; } }
+.blu-motion-exit-flip-y { animation: blu-motion-exit-flip-y var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-flip-y { 0% { opacity: 1; transform: none; } 100% { opacity: 0; transform: perspective(600px) rotateY(-30deg); } }
+.blu-motion-enter-pop { animation: blu-motion-enter-pop var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-pop { 0% { opacity: 0; transform: scale(.9); } 72% { opacity: 1; transform: scale(1.025); } 100% { opacity: 1; transform: scale(1); } }
+.blu-motion-exit-pop { animation: blu-motion-exit-pop var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-pop { 0% { opacity: 1; transform: scale(1); } 25% { opacity: 1; transform: scale(1.025); } 100% { opacity: 0; transform: scale(.9); } }
+.blu-motion-enter-bounce { animation: blu-motion-enter-bounce var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-bounce { 0% { opacity: 0; transform: translateY(var(--blu-motion-distance)); } 72% { opacity: 1; transform: translateY(-3px); } 100% { opacity: 1; transform: translateY(0); } }
+.blu-motion-exit-bounce { animation: blu-motion-exit-bounce var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-bounce { 0% { opacity: 1; transform: translateY(0); } 25% { opacity: 1; transform: translateY(-3px); } 100% { opacity: 0; transform: translateY(var(--blu-motion-distance)); } }
+.blu-motion-enter-wipe-up { animation: blu-motion-enter-wipe-up var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-wipe-up { 0% { opacity: 0; clip-path: inset(100% 0 0 0); } 100% { opacity: 1; clip-path: inset(0 0 0 0); } }
+.blu-motion-exit-wipe-up { animation: blu-motion-exit-wipe-up var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-wipe-up { 0% { opacity: 1; clip-path: inset(0 0 0 0); } 100% { opacity: 0; clip-path: inset(0 0 100% 0); } }
+.blu-motion-enter-wipe-down { animation: blu-motion-enter-wipe-down var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-wipe-down { 0% { opacity: 0; clip-path: inset(0 0 100% 0); } 100% { opacity: 1; clip-path: inset(0 0 0 0); } }
+.blu-motion-exit-wipe-down { animation: blu-motion-exit-wipe-down var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-wipe-down { 0% { opacity: 1; clip-path: inset(0 0 0 0); } 100% { opacity: 0; clip-path: inset(100% 0 0 0); } }
+.blu-motion-enter-wipe-left { animation: blu-motion-enter-wipe-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-wipe-left { 0% { opacity: 0; clip-path: inset(0 0 0 100%); } 100% { opacity: 1; clip-path: inset(0 0 0 0); } }
+.blu-motion-exit-wipe-left { animation: blu-motion-exit-wipe-left var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-wipe-left { 0% { opacity: 1; clip-path: inset(0 0 0 0); } 100% { opacity: 0; clip-path: inset(0 100% 0 0); } }
+.blu-motion-enter-wipe-right { animation: blu-motion-enter-wipe-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-wipe-right { 0% { opacity: 0; clip-path: inset(0 100% 0 0); } 100% { opacity: 1; clip-path: inset(0 0 0 0); } }
+.blu-motion-exit-wipe-right { animation: blu-motion-exit-wipe-right var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-wipe-right { 0% { opacity: 1; clip-path: inset(0 0 0 0); } 100% { opacity: 0; clip-path: inset(0 0 0 100%); } }
+.blu-motion-enter-circle-reveal { animation: blu-motion-enter-circle-reveal var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-circle-reveal { 0% { opacity: 0; clip-path: circle(0% at 50% 50%); } 100% { opacity: 1; clip-path: circle(72% at 50% 50%); } }
+.blu-motion-exit-circle-reveal { animation: blu-motion-exit-circle-reveal var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-circle-reveal { 0% { opacity: 1; clip-path: circle(72% at 50% 50%); } 100% { opacity: 0; clip-path: circle(0% at 50% 50%); } }
+.blu-motion-enter-blur-clear { animation: blu-motion-enter-blur-clear var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-enter-blur-clear { 0% { opacity: 0; filter: blur(6px); } 100% { opacity: 1; filter: blur(0px); } }
+.blu-motion-exit-blur-clear { animation: blu-motion-exit-blur-clear var(--blu-motion-duration) var(--blu-motion-ease) var(--blu-motion-delay) both; }
+@keyframes blu-motion-exit-blur-clear { 0% { opacity: 1; filter: blur(0px); } 100% { opacity: 0; filter: blur(6px); } }
+.blu-motion-ease-standard { --blu-motion-ease: cubic-bezier(.2,.8,.2,1); }
+.blu-motion-ease-in { --blu-motion-ease: cubic-bezier(.42,0,1,1); }
+.blu-motion-ease-out { --blu-motion-ease: cubic-bezier(0,0,.58,1); }
+.blu-motion-ease-in-out { --blu-motion-ease: cubic-bezier(.42,0,.58,1); }
+.blu-motion-ease-linear { --blu-motion-ease: linear; }
+.blu-motion-ease-spring { --blu-motion-ease: cubic-bezier(.34,1.25,.64,1); }
+.blu-motion-origin-center { transform-origin: 50% 50%; }
+.blu-motion-origin-top { transform-origin: 50% 0%; }
+.blu-motion-origin-bottom { transform-origin: 50% 100%; }
+.blu-motion-origin-left { transform-origin: 0% 50%; }
+.blu-motion-origin-right { transform-origin: 100% 50%; }
+.blu-motion-origin-top-left { transform-origin: 0% 0%; }
+.blu-motion-origin-top-right { transform-origin: 100% 0%; }
+.blu-motion-origin-bottom-left { transform-origin: 0% 100%; }
+.blu-motion-origin-bottom-right { transform-origin: 100% 100%; }

package/styles/motion-tokens.css

@@ -0,0 +1,6 @@
+/* Generated from src/motion/tokens.ts. */
+:root {
+  --blu-motion-fast: 280ms;
+  --blu-motion-normal: 450ms;
+  --blu-motion-slow: 750ms;
+}

package/styles/motion.css

@@ -0,0 +1,125 @@
+/* Optional web-only 1.2 draft. Import after the existing theme/button styles. */
+@import './motion-presets.css';
+@import './motion-tokens.css';
+@import './motion-optional.css';
+:root {
+  --blu-motion-duration: var(--blu-motion-normal);
+  --blu-motion-delay: 0ms;
+  --blu-motion-distance: 12px;
+  --blu-motion-ease: cubic-bezier(.2, .8, .2, 1);
+}
+.blu-motion-fast { --blu-motion-duration: var(--blu-motion-fast); }
+.blu-motion-slow { --blu-motion-duration: var(--blu-motion-slow); }
+.blu-motion-delay-1 { --blu-motion-delay: 60ms; }
+.blu-motion-delay-2 { --blu-motion-delay: 120ms; }
+.blu-motion-delay-3 { --blu-motion-delay: 180ms; }
+.blu-motion-spin { animation: blu-motion-spin 800ms linear infinite; }
+.blu-motion-pulse { animation: blu-motion-pulse 900ms ease-in-out 3; }
+.blu-motion-hover-lift { transition: transform var(--blu-motion-duration) var(--blu-motion-ease), box-shadow var(--blu-motion-duration) var(--blu-motion-ease); }
+@media (hover: hover) { .blu-motion-hover-lift:hover { transform: translateY(calc(-1 * var(--blu-motion-lift-distance, 4px))); box-shadow: 0 8px 20px #28334b12; } }
+.blu-motion-hover-lift:is(:focus-visible, [data-blu-lifted="true"]) { transform: translateY(calc(-1 * var(--blu-motion-lift-distance, 4px))); box-shadow: 0 8px 20px #28334b12; }
+/* Requires one inner wrapper. Content remains in the DOM; the owner manages inert/hidden and focus. */
+.blu-motion-expand { display: grid; grid-template-rows: 0fr; transition: grid-template-rows var(--blu-motion-duration) var(--blu-motion-ease); }
+.blu-motion-expand[data-open="true"] { grid-template-rows: 1fr; }
+.blu-motion-expand > * { min-height: 0; overflow: hidden; }
+@keyframes blu-motion-spin { to { transform: rotate(360deg); } }
+@keyframes blu-motion-pulse { 50% { opacity: .45; } }
+
+.blu-motion-button.blu-button { display: inline-grid; gap: 0; transition-duration: var(--blu-motion-duration); }
+.blu-motion-button__face, .blu-motion-button__reserve { grid-area: 1 / 1; padding-inline: 24px; }
+.blu-motion-button__face { position: relative; display: inline-flex; align-items: center; justify-content: center; }
+.blu-motion-button__reserve { visibility: hidden; pointer-events: none; }
+.blu-motion-button .blu-button__spinner { position: absolute; inset-inline-start: 0; }
+.blu-motion-button[data-spinner-position="Trailing"] .blu-button__spinner { inset-inline-start: auto; inset-inline-end: 0; }
+.blu-motion-button .blu-button__spinner[hidden] { display: none; }
+.blu-motion-button.blu-button--loading { pointer-events: auto; }
+.blu-motion-sr-only { position: absolute; width: 1px; height: 1px; padding: 0; overflow: hidden; clip-path: inset(50%); white-space: nowrap; border: 0; }
+
+.blu-loading { display: flex; align-items: center; gap: 10px; font: inherit; color: inherit; }
+.blu-loading [hidden] { display: none !important; }
+.blu-loading__visual { width: 20px; height: 20px; flex-shrink: 0; }
+.blu-loading[data-variant="Spinner"] .blu-loading__visual { border: 2px solid currentColor; border-right-color: transparent; border-radius: 50%; animation: blu-motion-spin 800ms linear infinite; }
+.blu-loading[data-variant="Spinner"] i { display: none; }
+.blu-loading[data-variant="Dots"] .blu-loading__visual { display: flex; align-items: center; width: 32px; gap: 3px; }
+.blu-loading[data-variant="Dots"] i { width: 7px; height: 7px; background: currentColor; border-radius: 50%; animation: blu-motion-pulse 900ms ease-in-out infinite; }
+.blu-loading[data-variant="Dots"] i:nth-child(2) { animation-delay: 150ms; }
+.blu-loading[data-variant="Dots"] i:nth-child(3) { animation-delay: 300ms; }
+.blu-loading progress { width: 100%; height: 8px; accent-color: var(--bluui-primary, #5145e5); border: 0; border-radius: 8px; background: #e7e8f1; overflow: hidden; }
+.blu-loading progress::-webkit-progress-bar { background: #e7e8f1; border-radius: 8px; }
+.blu-loading progress::-webkit-progress-value { background: var(--bluui-primary, #5145e5); border-radius: 8px; }
+.blu-loading progress::-moz-progress-bar { background: var(--bluui-primary, #5145e5); }
+.blu-loading[data-variant="Bar"] { flex-direction: column; align-items: stretch; }
+.blu-loading__bar { height: 8px; overflow: hidden; border-radius: 8px; background: #e7e8f1; }
+.blu-loading__bar::after { content: ''; display: block; width: 35%; height: 100%; background: var(--bluui-primary, #5145e5); border-radius: inherit; animation: blu-motion-progress 1.2s ease-in-out infinite alternate; }
+@keyframes blu-motion-progress { to { transform: translateX(185%); } }
+
+/* Explicit off/reduced scopes and per-element opt-out; never hide useful content. */
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off),
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off) * {
+  --blu-motion-duration: 0ms;
+  --blu-motion-delay: 0ms;
+}
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off) :is([class*="blu-motion-"], .blu-button__spinner, .blu-loading__visual, .blu-loading i),
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off)[class*="blu-motion-"],
+.blu-motion-off { animation: none !important; transition: none !important; }
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off) .blu-loading__bar::after { animation: none !important; }
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off) .blu-motion-hover-lift:is(:hover, :focus-visible, [data-blu-lifted="true"]) { transform: none; }
+@media (prefers-reduced-motion: reduce) {
+  [class*="blu-motion-"], .blu-button__spinner, .blu-loading__visual, .blu-loading i, .blu-loading__bar::after { animation: none !important; transition: none !important; }
+  .blu-motion-hover-lift:is(:hover, :focus-visible, [data-blu-lifted="true"]) { transform: none; }
+}
+
+/* Press state is finite and never changes a control's activation semantics. */
+.blu-motion-press[data-blu-pressed="true"] { transform: scale(.97); }
+.blu-motion-highlight { animation: blu-motion-highlight 1400ms ease-in-out 1; }
+.blu-motion-nudge { animation: blu-motion-nudge 280ms var(--blu-motion-ease) 1; }
+@keyframes blu-motion-highlight { 45% { box-shadow: 0 0 0 4px var(--blu-motion-highlight, #7770ed40); } }
+@keyframes blu-motion-nudge { 25% { transform: translateX(-3px); } 60% { transform: translateX(3px); } }
+:is([data-blu-motion="off"], [data-blu-motion="reduced"], .blu-motion-off) .blu-motion-press[data-blu-pressed="true"],
+.blu-motion-press.blu-motion-off[data-blu-pressed="true"] { transform: none; }
+@media (prefers-reduced-motion: reduce) { .blu-motion-press[data-blu-pressed="true"] { transform: none; } }
+
+.blu-motion-photo-frame { position:relative;overflow:hidden;isolation:isolate; }
+.blu-motion-photo-frame > img { display:block;width:100%;height:100%;object-fit:cover; }
+
+/* A masked border, not an overlay on the content. The inner square rotates;
+   the outer mask and soft halo stay aligned to the original rounded box. */
+.blu-motion-border-glow{position:absolute;inset:-1px;border-radius:inherit;pointer-events:none!important;z-index:1;filter:drop-shadow(0 0 4px var(--blu-glow-halo,#9b85ee80))}
+.blu-motion-border-glow__rim{position:absolute;inset:0;padding:var(--blu-glow-width,2px);border-radius:inherit;overflow:hidden;pointer-events:none!important;-webkit-mask:linear-gradient(#000 0 0) content-box,linear-gradient(#000 0 0);-webkit-mask-composite:xor;mask:linear-gradient(#000 0 0) content-box,linear-gradient(#000 0 0);mask-composite:exclude}
+.blu-motion-border-glow__beam{position:absolute;left:50%;top:50%;width:var(--blu-glow-size,1800px);height:var(--blu-glow-size,1800px);background:conic-gradient(transparent 0deg,transparent 240deg,var(--blu-glow-tail,#b5a4ef60) 265deg,var(--blu-glow-color,#8060dd) 295deg,var(--blu-glow-tip,#d7c6ff) 315deg,transparent 340deg);transform:translate(-50%,-50%) rotate(0turn);animation:blu-border-orbit var(--blu-glow-duration,12s) linear infinite}
+.blu-motion-border-glow[data-paused=true] .blu-motion-border-glow__beam{animation-play-state:paused}
+@keyframes blu-border-orbit{from{transform:translate(-50%,-50%) rotate(0turn)}to{transform:translate(-50%,-50%) rotate(1turn)}}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) .blu-motion-border-glow{filter:none}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) .blu-motion-border-glow__rim{background:var(--blu-glow-static,#b5a4ef80)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) .blu-motion-border-glow__beam{animation:none!important;display:none}
+@media(prefers-reduced-motion:reduce){.blu-motion-border-glow{filter:none}.blu-motion-border-glow__rim{background:var(--blu-glow-static,#b5a4ef80)}.blu-motion-border-glow__beam{animation:none!important;display:none}}
+@media(forced-colors:active){.blu-motion-border-glow{display:none}}
+
+/* Opt-in content adapters. Hover/focus lift composes with collection positioning. */
+[data-blu-content-motion] .blu-profile-card{transition:translate var(--blu-component-motion-duration,450ms) var(--blu-component-motion-ease,ease-in-out)}
+[data-blu-content-motion] .blu-profile-card:is(:hover,:focus-within){translate:0 -4px}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion] .blu-profile-card,
+[data-blu-content-motion]:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) .blu-profile-card{translate:none;transition:none}
+[data-blu-content-motion] :is(.blu-tree-select__check,.blu-video-player__heatmap){transition-duration:var(--blu-component-motion-duration,450ms);transition-timing-function:var(--blu-component-motion-ease,ease-in-out)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion] :is(.blu-tree-select__check,.blu-video-player__heatmap){transition:none}
+@media(prefers-reduced-motion:reduce){[data-blu-content-motion] .blu-profile-card{translate:none;transition:none}}
+
+/* Optional ripple stays clipped to the selectable part of a chip. */
+[data-blu-content-motion=chip] .blu-chip__select{border-radius:inherit}
+[data-blu-content-motion=skeleton] .blu-skeleton--animated::after{animation-duration:1800ms;animation-iteration-count:2}
+[data-blu-component-motion=statistic] .blu-statistic__loading{animation-duration:1800ms;animation-iteration-count:2}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion=skeleton] .blu-skeleton--animated::after{animation:none!important;display:none}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-component-motion=statistic] .blu-statistic__loading{animation:none!important}
+@media(prefers-reduced-motion:reduce){[data-blu-content-motion=skeleton] .blu-skeleton--animated::after{animation:none!important;display:none}[data-blu-component-motion=statistic] .blu-statistic__loading{animation:none!important}}
+
+/* Rich media hover must obey the same scope as its lightbox. */
+[data-blu-content-motion=media-image] img{transition-duration:var(--blu-component-motion-duration,650ms);transition-timing-function:var(--blu-component-motion-ease,ease-in-out)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion=media-image] img{transition:none!important;transform:none!important}
+/* Legacy content CSS follows the opt-in controller as well as system preference. */
+[data-blu-content-motion] .blu-button{transition-duration:var(--blu-component-motion-duration,280ms)}
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion] *,
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion] *::before,
+:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) [data-blu-content-motion] *::after,
+[data-blu-content-motion]:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *,
+[data-blu-content-motion]:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *::before,
+[data-blu-content-motion]:is([data-blu-motion=reduced],[data-blu-motion=off],.blu-motion-off) *::after{transition:none!important;animation:none!important}

package/styles/skeleton.css

@@ -67,3 +67,11 @@ The base shape remains visible when the animated overlay is removed. */
   -servicestudio-width: 180px;
   -servicestudio-height: 20px;
 }
+
+/* The opt-in native motion adapter owns the shimmer. Avoid a second legacy
+wave, including when the adapter is Reduced or Off. Removing the adapter
+restores the existing IsAnimated behavior without changing its contract. */
+.blu-skeleton[data-blu-native-motion="loading-skeleton"]::after {
+  animation: none !important;
+  display: none !important;
+}

package/test/component-motion-settings.test.mjs

@@ -0,0 +1,35 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {build} from 'esbuild';
+const built=await build({entryPoints:['src/motion/component-settings.ts'],bundle:true,format:'esm',platform:'node',write:false});
+const {validateComponentMotion}=await import('data:text/javascript;base64,'+Buffer.from(built.outputFiles[0].text).toString('base64'));
+test('component settings preserve explicit zero and omit undefined inheritance values',()=>{
+  assert.deepEqual(validateComponentMotion({duration:0,easing:undefined}),{duration:0});
+  assert.deepEqual(validateComponentMotion({mode:'inherit',duration:2000,easing:'ease-in-out'}),{mode:'inherit',duration:2000,easing:'ease-in-out'});
+});
+test('invalid settings cannot silently disable or produce unbounded component motion',()=>{
+  for(const invalid of [null,[],{duration:NaN},{duration:Infinity},{duration:-1},{duration:2001},{duration:'750'},{mode:'full'},{easing:'constructor'}])assert.throws(()=>validateComponentMotion(invalid));
+});
+test('validated settings are detached from later caller changes',()=>{
+  const source={duration:750,easing:'linear'}, settings=validateComponentMotion(source);source.duration=1000;
+  assert.equal(settings.duration,750);assert.equal(source.duration,1000);
+});
+const grouped=await build({entryPoints:['src/motion/settings-group.ts'],bundle:true,format:'esm',platform:'node',write:false});
+const {createMotionSettingsGroup}=await import('data:text/javascript;base64,'+Buffer.from(grouped.outputFiles[0].text).toString('base64'));
+test('collection configuration preserves instance overrides, resets inheritance and detaches disposed instances',()=>{
+  const group=createMotionSettingsGroup({duration:750,mode:'reduced'});let a,b;
+  const first=group.bind(value=>{a=value;}),second=group.bind(value=>{b=value;});
+  first.setMotion({duration:1200,mode:'off'});second.setMotion();
+  group.configure({duration:450,easing:'linear'});
+  assert.deepEqual(a,{duration:1200,easing:'linear',mode:'off'});assert.deepEqual(b,{duration:450,easing:'linear'});
+  first.setMotion({mode:'inherit'});assert.deepEqual(a,b);
+  second.destroy();group.configure({duration:1000});assert.equal(b.duration,450);assert.equal(a.duration,1000);
+  assert.throws(()=>second.setMotion());
+});
+test('invalid collection defaults and overrides are rejected before changing any member',()=>{
+  const group=createMotionSettingsGroup({duration:750});let current;
+  const member=group.bind(value=>{current=value;});member.setMotion();
+  assert.throws(()=>group.configure({duration:NaN}));assert.throws(()=>member.setMotion({mode:'full'}));
+  assert.deepEqual(current,{duration:750});assert.deepEqual(group.settings,{duration:750});
+  const detached=group.settings;detached.duration=1000;assert.equal(group.settings.duration,750);
+});