@blukavantui/community 1.0.1 → 1.2.0

package/dist/motion/scroll-reveal.d.ts

@@ -0,0 +1,13 @@
+import type { MotionController, MotionEffect, MotionOptions } from './controller.js';
+export interface ScrollRevealOptions extends Omit<MotionOptions, 'phase'> {
+    effect?: MotionEffect;
+    once?: boolean;
+    threshold?: number;
+    root?: Element | Document | null;
+    rootMargin?: string;
+    onReveal?: (element: HTMLElement) => void;
+}
+/** Progressive enhancement: nothing is hidden before the observer runs or when JS is unavailable. */
+export declare function createScrollReveal(targets: Iterable<HTMLElement>, motion: MotionController, options?: ScrollRevealOptions): {
+    destroy(): void;
+};

package/dist/motion/settings-group.d.ts

@@ -0,0 +1,14 @@
+import { type ComponentMotionSettings } from './component-settings.js';
+/** Settings only: factories keep ownership of their components and business state. */
+export declare function createMotionSettingsGroup(initial?: ComponentMotionSettings): {
+    readonly settings: {
+        mode?: "inherit" | "reduced" | "off";
+        duration?: number;
+        easing?: import("./effects.js").MotionEasing;
+    };
+    configure(next?: ComponentMotionSettings): void;
+    bind(update: (settings: ComponentMotionSettings) => void): {
+        setMotion(next?: ComponentMotionSettings): void;
+        destroy(): void;
+    };
+};

package/dist/motion/stagger.d.ts

@@ -0,0 +1,12 @@
+import type { MotionController, MotionEffect, MotionOptions, MotionResult } from './controller.js';
+export type StaggerOrder = 'forward' | 'reverse' | 'center' | 'rows' | 'columns';
+export interface StaggerOptions extends MotionOptions {
+    gap?: number;
+    order?: StaggerOrder;
+    /** Used for row/column sequences. Supply the current rendered column count. */
+    columns?: number;
+}
+/** Logical ranks only: never reorder the DOM or change reading/tab order. */
+export declare function staggerRanks(count: number, order?: StaggerOrder, columns?: number): number[];
+/** A bounded entrance/exit sequence. Reduced/Off modes suppress delays in the controller. */
+export declare function playStagger(motion: MotionController, elements: Iterable<HTMLElement>, effect?: MotionEffect, options?: StaggerOptions): Promise<MotionResult[]>;

package/dist/motion/structure.d.ts

@@ -0,0 +1,18 @@
+import type { MotionController, MotionOptions, MotionResult } from './controller.js';
+export type TransitionOptions = Omit<MotionOptions, 'phase'>;
+/** Save only owned declarations, preserving unrelated inline styles and priorities. */
+export declare function preserveStyles(element: HTMLElement | SVGElement, properties: string[]): () => void;
+export declare function moveFocusOut(element: HTMLElement, fallback?: HTMLElement): void;
+/** Animate an unpadded outer wrapper; put padding/borders in its child. Handles auto dimensions. */
+export declare function createSizeTransition(element: HTMLElement, motion: MotionController, axis?: 'height' | 'width'): {
+    setOpen(open: boolean, options?: TransitionOptions & {
+        focusFallback?: HTMLElement;
+    }): Promise<MotionResult>;
+    resize(change: () => void, options?: TransitionOptions): Promise<MotionResult>;
+    destroy(): void;
+};
+/** FLIP movement for retained DOM nodes. The caller owns data changes and removed nodes. */
+export declare function createLayoutTransition(container: HTMLElement, motion: MotionController): {
+    update(elements: HTMLElement[], change: () => void, options?: TransitionOptions): Promise<MotionResult>;
+    destroy(): void;
+};

package/dist/motion/tabs.d.ts

@@ -0,0 +1,19 @@
+import type { MotionController, MotionResult } from './controller.js';
+export interface MotionTab {
+    key: string;
+    tab: HTMLButtonElement;
+    panel: HTMLElement;
+}
+export interface MotionTabsOptions {
+    /** Automatic selects with arrows. Manual selects with Enter/Space. */
+    activation?: 'automatic' | 'manual';
+    orientation?: 'horizontal' | 'vertical';
+    onChange?: (key: string) => void;
+}
+/** Local web helper for app-owned tabs. Panels remain mounted, preserving input state.
+ * Supply unique tab/panel IDs, a labelled tablist and one shared panel container. */
+export declare function createMotionTabs(tablist: HTMLElement, items: MotionTab[], motion: MotionController, options?: MotionTabsOptions): {
+    readonly activeKey: string;
+    select: (key: string) => Promise<MotionResult>;
+    destroy(): void;
+};

package/dist/motion/tokens.d.ts

@@ -0,0 +1,11 @@
+/** Shared opt-in defaults in milliseconds. Explicit zero remains instant. */
+export declare const motionTiming: Readonly<{
+    fast: 280;
+    normal: 450;
+    slow: 750;
+    layout: 650;
+    highlight: 1400;
+    reduced: 200;
+    maxDuration: 2000;
+    maxDelay: 500;
+}>;

package/dist/motion/value.d.ts

@@ -0,0 +1,21 @@
+import type { MotionController, MotionResult } from './controller.js';
+import { type TransitionOptions } from './structure.js';
+export declare function finiteValue(value: number): number;
+/** Visual fill only. Owner supplies the real value and progress semantics. */
+export declare function createProgressTransition(fill: HTMLElement, motion: MotionController, initial?: number): {
+    set(next: number, options?: TransitionOptions): Promise<MotionResult>;
+    destroy(): void;
+};
+/** SVG drawing or measured progress, normalized to 0–100 without guessing path length. */
+export declare function createStrokeTransition(path: SVGGeometryElement, motion: MotionController, initial?: number): {
+    set(next: number, options?: TransitionOptions): Promise<MotionResult>;
+    destroy(): void;
+};
+/** One stable accessible value. Intermediate visual numbers are never live announcements. */
+export declare function createNumberTransition(element: HTMLElement, motion: MotionController, options: {
+    value: number;
+    format?: (value: number) => string;
+}): {
+    set(next: number, timing?: TransitionOptions): Promise<MotionResult>;
+    destroy(): void;
+};

package/dist/motion/view-transition.d.ts

@@ -0,0 +1,14 @@
+import type { MotionController, MotionEffect, MotionResult } from './controller.js';
+export interface ViewTransitionOptions {
+    effect?: MotionEffect | 'instant';
+    /** Container scroll only. Routing, browser history and document scroll stay app-owned. */
+    scroll?: 'preserve' | 'top';
+    /** Entrance duration; exit uses 280 ms. */
+    duration?: number;
+}
+/** Replace one workspace/page outlet. Latest request wins; no document/router interception. */
+export declare function createViewTransition(host: HTMLElement, motion: MotionController): {
+    show(next: HTMLElement, options?: ViewTransitionOptions): Promise<MotionResult>;
+    cancel(): void;
+    destroy(): void;
+};

package/dist/motion-enhancers.d.ts

@@ -0,0 +1,12 @@
+/** DOM-only adapters. Attach after the component mounts; dispose before its root. */
+export * from './web-motion/data-rows.js';
+export * from './web-motion/content.js';
+export * from './web-motion/statistic.js';
+export * from './web-motion/tree.js';
+export * from './web-motion/navigation.js';
+export * from './web-motion/notifications.js';
+export * from './web-motion/fields.js';
+export * from './web-motion/surfaces.js';
+export * from './web-motion/chip-ripple.js';
+export * from './web-motion/choice-ripple.js';
+export * from './web-motion/select-ripple.js';

package/dist/motion-enhancers.js

@@ -0,0 +1 @@
+import{a as I,b as D,c as P,d as j}from"./chunk-WJHCVECU.js";import{a as B}from"./chunk-WG4US4JH.js";import{d as O,e as A}from"./chunk-IKYBFMHI.js";import{a as R,g as V}from"./chunk-6T677NSC.js";function U(e,u,a,p={}){let c=!1,s=0,y=0,o=new Map,r=new WeakMap,d=t=>{let i=r.get(t);return i||(i="node-"+ ++y,r.set(t,i)),i},b=(t,i,l=650,m=!1)=>{let v=++y;o.set(t,v),u.animate(t,i,{duration:l,easing:"ease-in-out"},m?"fade":"instant").finally(()=>{o.get(t)===v&&o.delete(t)})};function g(){let t=e.getBoundingClientRect(),i=[],l=(n,E,T=()=>"")=>{[...e.querySelectorAll(n)].slice(0,40).forEach((M,N)=>{let C=M.getBoundingClientRect(),F=o.has(M)?getComputedStyle(M).translate.split(/\s+/).map(Number.parseFloat):[],w=new DOMRect(C.left-t.left-(F[0]||0),C.top-t.top-(F[1]||0),C.width,C.height);w.width&&w.height&&!M.closest("[hidden]")&&i.push([E(M,N),{el:M,rect:w,signature:T(M)}])})};a==="collection-layout"&&l(".blu-collection-layout__item",d),a==="timeline"&&l(".blu-timeline__item",(n,E)=>p.timelineKeys?.()[E]||n.querySelector("h3")?.textContent||d(n)),a==="transfer"&&l(".blu-transfer__row",n=>n.dataset.key||n.querySelector(".blu-transfer__label")?.textContent||d(n)),a==="chip"&&l(".blu-chip",n=>n.querySelector(".blu-chip__select,.blu-chip__label")?.textContent||d(n),n=>String(n.classList.contains("blu-chip--selected"))),a==="tree-select"&&l(".blu-tree-select__item[data-key] > .blu-tree-select__row",n=>n.parentElement.dataset.key),a==="cascader"&&l(".blu-cascader__column",(n,E)=>"column-"+E,n=>n.textContent||""),a==="tour"&&l(".blu-tour__panel",()=>"tour-step",n=>n.textContent||""),a==="notification-center"&&(l(".blu-notification-center__list",()=>"inbox",n=>n.textContent||""),l(".blu-notification-center__item",n=>n.querySelector("[data-focus]")?.getAttribute("data-focus")||d(n),n=>n.className)),a==="skeleton"&&l("[aria-busy]",()=>"loading-content",n=>n.getAttribute("aria-busy")||"");let m=new Map,v=new Set;for(let[n,E]of i)m.has(n)&&v.add(n),m.set(n,E);for(let n of v)m.delete(n);return m}let h=g(),_=()=>{s||(h=g())};function L(){if(s=0,c)return;let t=g();for(let[i,l]of t){let m=h.get(i);if(!m){b(l.el,[{opacity:0},{opacity:1}],450,!0);continue}let v=m.rect.left-l.rect.left,n=m.rect.top-l.rect.top;a!=="tour"&&(Math.abs(v)>1||Math.abs(n)>1)?b(l.el,[{translate:`${v}px ${n}px`},{translate:"0px 0px"}]):m.signature!==l.signature&&b(l.el,[{opacity:.55},{opacity:1}],450,!0)}for(let i of o.keys())e.contains(i)||(u.cancel(i),o.delete(i));h=t}let f=new MutationObserver(()=>{s||(s=requestAnimationFrame(L))});f.observe(e,{childList:!0,subtree:!0,attributes:!0,attributeFilter:["hidden","class","aria-selected","aria-checked","style"]});for(let t of["click","change","input","keydown","pointerdown"])e.addEventListener(t,_,!0);let x=e.getAttribute("data-blu-content-motion");e.setAttribute("data-blu-content-motion",a);let K=a==="cascader"||a==="tree-select"?I(e,u,a):void 0,H=new Map;function S(){for(let t of e.querySelectorAll(".blu-overlay,.blu-tour")){if(t.closest("[data-blu-content-motion]")!==e)continue;let i=H.get(t);i||(i={open:!1,revision:0,restore:()=>{}},H.set(t,i));let l=!t.hidden;if(l===i.open)continue;i.open=l;let m=++i.revision;if(i.restore(),u.cancel(t),l){u.play(t,"fade",{duration:450});continue}if(u.mode==="off")continue;let v=R(t,["display","pointer-events"]),n=t.inert,E=t.getAttribute("aria-hidden"),T;i.restore=()=>{clearTimeout(T),v(),t.inert=n,E===null?t.removeAttribute("aria-hidden"):t.setAttribute("aria-hidden",E)},t.inert=!0,t.setAttribute("aria-hidden","true"),t.style.setProperty("display","flex","important"),t.style.pointerEvents="none";let M=()=>{!c&&i.revision===m&&(i.restore(),i.restore=()=>{})};T=setTimeout(M,(u.resolveOptions?.({duration:450}).duration??450)+100),u.animate(t,[{opacity:1},{opacity:0}],{duration:450,easing:"ease-in-out"},"fade").finally(M)}}let k=new MutationObserver(S);["profile-card","video-lightbox","collection-layout","media-image","tour"].includes(a)&&(k.observe(e,{subtree:!0,childList:!0,attributes:!0,attributeFilter:["hidden"]}),S());let q=t=>{let i=t.target;i.tagName==="VIDEO"&&queueMicrotask(()=>{if(c||!e.contains(i))return;let l=i.closest(".blu-video-player"),m=l?.querySelector(".blu-video-player__pause-glass"),v=i.paused&&m&&!m.hidden&&getComputedStyle(m).display!=="none"?m:l?.querySelector(".blu-video-player__primary");v&&b(v,[{opacity:.4},{opacity:1}],450,!0)})};for(let t of["play","pause","waiting","loadeddata"])e.addEventListener(t,q,!0);return{capture:_,destroy(){if(!c){c=!0,f.disconnect(),k.disconnect(),cancelAnimationFrame(s),K?.destroy();for(let[t,i]of H)i.revision++,i.restore(),u.cancel(t);for(let t of o.keys())u.cancel(t);o.clear();for(let t of["click","change","input","keydown","pointerdown"])e.removeEventListener(t,_,!0);x===null?e.removeAttribute("data-blu-content-motion"):e.setAttribute("data-blu-content-motion",x);for(let t of["play","pause","waiting","loadeddata"])e.removeEventListener(t,q,!0)}}}}function z(e,u,a){let p=e.getAttribute("data-blu-component-motion");e.setAttribute("data-blu-component-motion","statistic");let c=!1,s=null,y=a().Value??0,o,r=()=>{if(c)return;let b=e.querySelector(".blu-statistic__value > strong");if(b===s||(o?.destroy(),o=void 0,s=b,!b))return;let g=a(),h=Number(g.Value??0);if(!Number.isFinite(h))return;let _=new Intl.NumberFormat(g.Locale||"en-US",{minimumFractionDigits:g.Precision??0,maximumFractionDigits:g.Precision??0});o=O(b,u,{value:y,format:L=>_.format(L)}),o.set(h,{duration:750,easing:"ease-in-out"}),y=h};r();let d=new MutationObserver(r);return d.observe(e,{childList:!0,subtree:!0}),{capture(){},destroy(){c||(c=!0,d.disconnect(),o?.destroy(),p===null?e.removeAttribute("data-blu-component-motion"):e.setAttribute("data-blu-component-motion",p))}}}function Q(e,u){let a=!1,p=0,c=0,s,y=o=>{let r=o.target instanceof Element?o.target.closest(".blu-chip__select"):null;if(!r||!e.contains(r)||r.disabled)return;let d=[...e.querySelectorAll(".blu-chip__select")],b=r.textContent,g=d.filter(f=>f.textContent===b).indexOf(r),h=r.getAttribute("aria-pressed"),_=o.detail?{clientX:o.clientX,clientY:o.clientY}:void 0,L=++p;cancelAnimationFrame(c),c=requestAnimationFrame(()=>{if(c=0,a||L!==p)return;s?.destroy(),s=void 0;let f=r.isConnected?r:[...e.querySelectorAll(".blu-chip__select")].filter(x=>x.textContent===b)[g];!f||f.disabled||u.mode!=="full"||o.defaultPrevented&&f.getAttribute("aria-pressed")===h||(s=A(f,u,{duration:1e3,easing:"ease-out",listen:!1}),s.play(_))})};return e.addEventListener("click",y,!0),{destroy(){a||(a=!0,++p,cancelAnimationFrame(c),e.removeEventListener("click",y,!0),s?.destroy())}}}function te(e,u,a={}){let p=!1,c=0,s,y=o=>{let r=o.target;if(!(r instanceof HTMLInputElement)||!r.matches(".blu-choice__input")||r.disabled||r.getAttribute("aria-readonly")==="true")return;let d=r.name,b=r.value,g=r.type,h=()=>[...e.querySelectorAll(".blu-choice__input")].filter(f=>f.name===d&&f.value===b&&f.type===g),_=h().indexOf(r),L=r.checked;cancelAnimationFrame(c),c=requestAnimationFrame(()=>{if(c=0,p||o.defaultPrevented||u.mode!=="full")return;let f=e.contains(r)?r:h()[_];if(!f||f.disabled||f.getAttribute("aria-readonly")==="true"||f.checked!==L)return;let x=f.nextElementSibling;x?.classList.contains("blu-choice__mark")&&(s?.destroy(),s=A(x,u,{duration:1e3,easing:"ease-out",...a,listen:!1}),s.element.classList.add("blu-motion-choice-ripple"),s.play())})};return e.addEventListener("click",y,!0),e.addEventListener("change",y,!0),{destroy(){p||(p=!0,cancelAnimationFrame(c),e.removeEventListener("click",y,!0),e.removeEventListener("change",y,!0),s?.destroy())}}}function ie(e,u,a={}){let p=!1,c=0,s,y=()=>e.querySelector(".blu-select__trigger")?.getAttribute("aria-expanded")+"|"+e.querySelector(".blu-select__native")?.value,o=r=>{if(!(r.target instanceof Element)||!r.target.closest(".blu-select"))return;let d=e.querySelector(".blu-select__trigger");if(!d||d.disabled||d.getAttribute("aria-readonly")==="true"||r instanceof KeyboardEvent&&!["Enter"," ","ArrowDown","ArrowUp","Home","End"].includes(r.key))return;let b=y(),g=r instanceof MouseEvent&&r.detail>0&&r.target.closest(".blu-select__trigger")?{clientX:r.clientX,clientY:r.clientY}:void 0;cancelAnimationFrame(c),c=requestAnimationFrame(()=>{c=0,!(p||!e.contains(d)||d.disabled||u.mode!=="full"||y()===b)&&(s?.destroy(),s=A(d,u,{duration:1e3,easing:"ease-out",...a,listen:!1}),s.play(g))})};return e.addEventListener("click",o,!0),e.addEventListener("keydown",o,!0),{destroy(){p||(p=!0,cancelAnimationFrame(c),e.removeEventListener("click",o,!0),e.removeEventListener("keydown",o,!0),s?.destroy())}}}export{Q as enhanceChipRipple,te as enhanceChoiceRipple,U as enhanceContentMotion,B as enhanceDataRows,j as enhanceField,V as enhanceNavigation,P as enhanceNotifications,ie as enhanceSelectRipple,z as enhanceStatistic,D as enhanceTree,I as observeSurface};

package/dist/motion-settings.d.ts

@@ -0,0 +1,3 @@
+/** Shared settings contract for optional component, data, chart and workflow adapters. */
+export * from './motion/component-settings.js';
+export * from './motion/settings-group.js';

package/dist/motion-settings.js

@@ -0,0 +1 @@
+import{a as m}from"./chunk-GS67ZBLI.js";import{a as o,b as r,c as e,d as f}from"./chunk-EPPSBHZR.js";import"./chunk-CSTCEBEK.js";export{f as createComponentMotionScope,r as createComponentMotionState,m as createMotionSettingsGroup,e as createTransitionMotionScope,o as validateComponentMotion};