@tap-payments/os-micro-frontend-shared 0.3.228-test.7 → 0.3.229

package/build/_chunks/chunk-V2Z6RD2T.js

@@ -1 +0,0 @@
-import {t,p}from'./chunk-TIO3V7XA.js';import {lc}from'./chunk-4XXNGLS6.js';import {forwardRef,memo,useMemo,Fragment,useState,useRef,useCallback,useEffect,useLayoutEffect}from'react';import At from'@mui/material/Box';import {styled}from'@mui/material/styles';import {motion}from'framer-motion';import {jsx,jsxs}from'react/jsx-runtime';var N="os-shared-AvatarStack",l={root:`${N}-root`,track:`${N}-track`,slot:`${N}-slot`,overlapSlot:`${N}-overlapSlot`,overlapItem:`${N}-overlapItem`,overflow:`${N}-overflow`},$="chip-stack-overlap-slot",y=24,W=.22,Ht=["static","fanout-right","fanout-left","fanout-center"],z="static";function tt({items:t,getItemKey:e,renderItem:r}){return t?.length&&e&&r?{items:t,getItemKey:e,renderItem:r}:null}function et(t){return t==="fanout-left"?"left":t==="fanout-center"?"center":"right"}function rt(t,e){return e===void 0||e<1||t.length<e?{visibleItems:t,hiddenItems:[]}:{visibleItems:t.slice(0,e-1),hiddenItems:t.slice(e-1)}}function at(t,e){return rt(t,e).hiddenItems.length>0}function D({source:{items:t,getItemKey:e,renderItem:r},maxItems:a,slotSize:i,renderOverflow:o}){let{visibleItems:n,hiddenItems:c}=rt(t,a),d={slotSize:i},m=n.map((S,p)=>({key:e(S,p),render:()=>r(S,p,d)}));return c.length>0&&m.push({key:`avatar-stack-overflow-${c.length}-${n.length}`,render:()=>o({items:t,overflowItems:c,size:i})}),m}var Kt=3,Q=60;function ot(t){let e=t.size??y,r=a=>Math.round(e*a/y);return {size:e,stackStep:t.stackStep??Math.round(e/2),gap:t.gap??Math.max(1,r(Kt)),minTrackWidth:t.minTrackWidth??Math.max(Q,r(Q))}}function nt(t,e){return t<=0||e==="right"?0:e==="left"?t-1:Math.floor((t-1)/2)}function it(t,e,r){return t<=0?0:(t-1)*e+r}function lt({slotCount:t,anchorIndex:e,slotWidths:r,gap:a,stackStep:i}){if(t===0)return [];let o=new Array(t);o[e]=e*i;for(let n=e-1;n>=0;n-=1)o[n]=o[n+1]-r[n]-a;for(let n=e+1;n<t;n+=1)o[n]=o[n-1]+r[n-1]+a;return o}function st(t,e,r,a){return Array.from({length:t},(i,o)=>t<=1||!e?0:r[o]-o*a)}function ct(t,e,r){if(t.length===0)return 0;let a=Math.min(...t),i=Math.max(...t.map((o,n)=>o+e[n]));return Math.max(r,i-a)}function mt(t,e,r){return Array.from({length:t},(a,i)=>e.current[i]?.offsetWidth??r)}function ut(t,e){return t.length===e.length&&t.every((r,a)=>r===e[a])}var Xt=120;function St(t,e){return Array.from({length:t},()=>e)}function U(t){t.current&&clearTimeout(t.current);}function pt({slotCount:t,anchorIndex:e,size:r,stackStep:a,gap:i,isFanOutEnabled:o,compact:n}){let[c,d]=useState(false),m=useRef(null),S=useCallback(()=>{o&&(U(m),d(true));},[o]),p=useCallback(()=>{o&&(U(m),m.current=setTimeout(()=>d(false),Xt));},[o]);useEffect(()=>()=>U(m),[]),useEffect(()=>{o||d(false);},[o]);let u=useRef([]),s=useRef(null),[A,_]=useState(()=>St(t,r)),f=useCallback(()=>{let v=mt(t,u,r);_(g=>ut(g,v)?g:v);},[t,r]);useLayoutEffect(()=>{_(St(t,r));},[t,r]),useLayoutEffect(()=>{f();},[t,r,f]),useEffect(()=>{let v=()=>{s.current&&cancelAnimationFrame(s.current),s.current=requestAnimationFrame(f);};return v(),window.addEventListener("resize",v),()=>{window.removeEventListener("resize",v),s.current&&cancelAnimationFrame(s.current);}},[f]);let b=o&&c,R=useMemo(()=>Array.from({length:t},(v,g)=>A[g]??r),[t,A,r]),w=useMemo(()=>lt({slotCount:t,anchorIndex:e,slotWidths:R,gap:i,stackStep:a}),[t,e,R,i,a]),M=useMemo(()=>st(t,b,w,a),[t,b,w,a]),k=it(t,a,r),C=useMemo(()=>ct(w,R,k),[w,R,k]),L=b?C:n?r:k,V=useMemo(()=>Array.from({length:t},(v,g)=>!n||c||g===e?1:0),[t,n,c,e]);return {slotRefs:u,handleMouseEnter:S,handleMouseLeave:p,isExpanded:b,collapsedWidth:k,trackWidth:L,translateX:M,slotOpacity:V}}var x=t=>typeof t=="string"&&!t.startsWith("$")&&t!=="sx"&&t!=="theme"&&t!=="ownerState"&&t!=="as";function j(){return `var(--avatar-stack-slot-size, ${y}px)`}function jt(t){return `${Math.max(8,8.5*t/y)}px`}function vt(t){let{base:e,grey:r}=t.v2.palette,a=e.white;return {display:"flex",alignItems:"center",justifyContent:"center",width:j(),height:j(),borderRadius:"50%",border:`1px solid ${r[100]}`,background:a,backgroundColor:a,flexShrink:0,"&.MuiAvatar-colorDefault":{background:a,backgroundColor:a,color:"inherit"}}}var kt=styled(At,{shouldForwardProp:x})(({theme:t,$slotSize:e})=>({"--avatar-stack-slot-size":`${e}px`,display:"flex",alignItems:"center",paddingRight:t.v2.spacing(8),[`& .${l.overlapSlot}`]:{marginRight:`-${t.v2.spacing(8)}`,position:"relative",zIndex:1},[`& .${l.overlapSlot}:hover`]:{zIndex:2}})),ht=styled(t,{shouldForwardProp:x})(({theme:t})=>({...vt(t),overflow:"hidden",lineHeight:0,boxSizing:"border-box",padding:0,fontSize:"inherit","& > *":{width:"100%",height:"100%",minWidth:0,minHeight:0},"& img":{display:"block",width:"100%",height:"100%",objectFit:"contain"}})),yt=styled(t,{shouldForwardProp:x})(({theme:t})=>({...vt(t),fontSize:`max(8px, calc(${j()} * 8.5 / ${y}))`,fontWeight:t.v2.typography.fontWeightMedium,color:"rgba(0, 0, 0, 0.38)","&.MuiAvatar-colorDefault":{background:t.v2.palette.base.white,backgroundColor:t.v2.palette.base.white,color:"rgba(0, 0, 0, 0.38)"}})),gt=styled(At,{shouldForwardProp:x})(({theme:t,$isFullWidth:e})=>({display:"flex",justifyContent:"flex-start",gap:t.v2.spacing(8),overflow:"visible",...e?{width:"100%"}:{}})),bt=styled("div",{shouldForwardProp:x})(({$width:t,$minWidth:e,$height:r,$zIndex:a})=>({position:"relative",overflow:"visible",width:t,minWidth:e,height:r,transition:`width ${W}s ease-out`,...a!==void 0?{zIndex:a}:{}})),Tt=styled(motion.div,{shouldForwardProp:x})(({$index:t,$left:e,$size:r,$isHidden:a})=>({position:"absolute",top:0,left:e,zIndex:t,width:r,height:r,pointerEvents:a?"none":"auto"})),xt=styled(t,{shouldForwardProp:x})(({theme:t,$size:e})=>({width:e,height:e,borderRadius:"50%",border:`1px solid ${t.v2.palette.grey[100]}`,display:"flex",alignItems:"center",justifyContent:"center",fontSize:jt(e),fontWeight:t.v2.typography.fontWeightBold,background:"#F5F5F5",backgroundColor:"#F5F5F5",flexShrink:0,"&.MuiAvatar-colorDefault":{background:"#F5F5F5",backgroundColor:"#F5F5F5",color:"inherit"}}));var Zt=1e3,qt={duration:W,ease:"easeOut"};function wt(t){return t==null?[]:Array.isArray(t)?t:[t]}function Bt({overflowItems:t,size:e}){return jsxs(xt,{className:l.overflow,$size:e,children:["+",t.length]})}function q({source:t,maxItems:e,renderOverflow:r,fanOutDirection:a,compact:i,slotProps:o,rootRef:n,id:c,"data-testid":d,className:m,sx:S}){let{zIndex:p=Zt,size:u,stackStep:s,gap:A,minTrackWidth:_}=o?.layout??{},{size:f,stackStep:b,gap:R,minTrackWidth:w}=useMemo(()=>ot({size:u,stackStep:s,gap:A,minTrackWidth:_}),[u,s,A,_]),M=i||!at(t.items,e),k=useMemo(()=>D({source:t,maxItems:e,slotSize:f,renderOverflow:r??Bt}),[t,e,f,r]),C=nt(k.length,a),{slotRefs:G,handleMouseEnter:L,handleMouseLeave:V,isExpanded:v,collapsedWidth:g,trackWidth:Mt,translateX:Ft,slotOpacity:Y}=pt({slotCount:k.length,anchorIndex:C,size:f,stackStep:b,gap:R,isFanOutEnabled:M,compact:i});if(k.length===0)return null;let{className:Ot,sx:$t,...Wt}=o?.shell??{},{className:Dt,...Ct}=o?.track??{};return jsx(gt,{ref:n,...Wt,className:lc(l.root,m,Ot),sx:[...wt(S),...wt($t)],$isFullWidth:M,children:jsx(bt,{id:c,"data-testid":d,...Ct,className:lc(l.track,Dt),onMouseEnter:L,onMouseLeave:V,$width:Mt,$minWidth:i?f:Math.max(w,g),$height:f,$zIndex:v?p:void 0,children:k.map(({key:Lt,render:Vt},I)=>jsx(Tt,{ref:zt=>{G.current[I]=zt;},className:l.slot,initial:false,animate:{x:Ft[I]??0,opacity:Y[I]??1},transition:qt,$index:I,$left:I*b,$size:f,$isHidden:Y[I]===0,children:Vt()},Lt))})})}var It=lc(l.overlapSlot,$),_t=forwardRef(({title:t,id:e,className:r,...a},i)=>{let o=t!=null&&t!=="",n=jsx(ht,{ref:i,id:e,"data-testid":e??"AvatarStackItem",className:lc(l.overlapItem,!o&&It,r),...a});return o?jsx(p,{title:t,wrapperProps:{className:It},children:n}):n});_t.displayName="AvatarStackItem";var B=memo(_t);function te(t){return jsx(p,{title:`${t} more`,wrapperProps:{className:lc(l.overlapSlot,$)},children:jsx(yt,{className:l.overflow,children:jsxs("span",{children:["+",t]})})})}function J({source:t,maxItems:e,renderOverflow:r,slotProps:a,rootRef:i,id:o,"data-testid":n,className:c,sx:d}){let m=a?.layout?.size??y,{renderItem:S}=t,p=D({source:{...t,renderItem:(u,s,A)=>jsx(B,{children:S(u,s,A)})},maxItems:e,slotSize:m,renderOverflow:u=>r?.(u)??te(u.overflowItems.length)});return jsx(kt,{ref:i,id:o,"data-testid":n,className:lc(l.root,c),sx:d,$slotSize:m,children:p.map(({key:u,render:s})=>jsx(Fragment,{children:s()},u))})}function ne({variant:t=z,items:e,getItemKey:r,renderItem:a,maxItems:i,renderOverflow:o,compact:n=false,id:c,"data-testid":d,slotProps:m,sx:S,className:p},u){let s=useMemo(()=>tt({items:e,getItemKey:r,renderItem:a}),[e,r,a]);if(!s)return null;let A={source:s,maxItems:i,renderOverflow:o,slotProps:m,rootRef:u,id:c,"data-testid":d??c??"AvatarStack",className:p,sx:S};return t==="static"?jsx(J,{...A}):jsx(q,{...A,fanOutDirection:et(t),compact:n})}var Et=forwardRef(ne);Et.displayName="AvatarStack";var ie=memo(Et),le=ie;export{l as a,Ht as b,z as c,B as d,le as e};

package/build/components/AvatarStack/AnimatedStack.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="react" />
-import type { AvatarStackAnimatedStackProps } from './type';
-/**
- * `variant="fanout-*"` — items overlap while idle and fan out around the anchor item on hover.
- *
- * Restyling: `className` / `sx` / `slotProps.shell` land on the shell; `id`, `data-testid`,
- * hover handlers, and `slotProps.track` land on the track.
- */
-export default function AnimatedStack<T>({ source, maxItems, renderOverflow, fanOutDirection, compact, slotProps, rootRef, id, 'data-testid': dataTestId, className, sx, }: Readonly<AvatarStackAnimatedStackProps<T>>): import("react").JSX.Element | null;

package/build/components/AvatarStack/AvatarStack.d.ts

@@ -1,5 +0,0 @@
-import type { ReactElement, RefAttributes } from 'react';
-import type { AvatarStackProps } from './type';
-/** `forwardRef` + `memo` erase generics — re-declare the call signature so `T` is inferred from `items`. */
-declare const AvatarStack: <T = unknown>(props: Readonly<AvatarStackProps<T>> & RefAttributes<HTMLDivElement>) => ReactElement | null;
-export default AvatarStack;

package/build/components/AvatarStack/AvatarStackItem.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="react" />
-import type { AvatarStackItemProps } from './type';
-declare const _default: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Omit<AvatarStackItemProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>>;
-export default _default;

package/build/components/AvatarStack/StaticStack.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="react" />
-import type { AvatarStackStaticStackProps } from './type';
-/** `variant="static"` — an overlapping row with no animation. */
-export default function StaticStack<T>({ source, maxItems, renderOverflow, slotProps, rootRef, id, 'data-testid': dataTestId, className, sx, }: Readonly<AvatarStackStaticStackProps<T>>): import("react").JSX.Element;

package/build/components/AvatarStack/constants.d.ts

@@ -1,29 +0,0 @@
-import type { AvatarStackVariant } from './type';
-export declare const avatarStackClassNamePrefix: "os-shared-AvatarStack";
-export declare const avatarStackClassNames: {
-    /** Static row, or the fanout shell. Receives consumer `className` / `sx`. */
-    readonly root: "os-shared-AvatarStack-root";
-    /** Fanout only — positioned track that owns hover. */
-    readonly track: "os-shared-AvatarStack-track";
-    /** Fanout only — one absolutely positioned, animated slot per item. */
-    readonly slot: "os-shared-AvatarStack-slot";
-    /** Static only — one overlapping slot per item (the item, or its tooltip wrapper). */
-    readonly overlapSlot: "os-shared-AvatarStack-overlapSlot";
-    /** `AvatarStackItem` circle. */
-    readonly overlapItem: "os-shared-AvatarStack-overlapItem";
-    /** Default `+N` item (both variants). */
-    readonly overflow: "os-shared-AvatarStack-overflow";
-};
-/**
- * Pre-`os-shared` ChipStack-era slot class, still set next to `avatarStackClassNames.overlapSlot`.
- * MFEs target it (e.g. `& .chip-stack-overlap-slot:last-child`) — do not rename or remove.
- */
-export declare const avatarStackLegacyOverlapSlotClassName = "chip-stack-overlap-slot";
-/** Default item diameter (px). Every other dimension scales from it. */
-export declare const AVATAR_STACK_SIZE_PX = 24;
-/** Fan-out animation duration (s) — per-slot translate and track width. */
-export declare const AVATAR_STACK_ANIMATED_DURATION_S = 0.22;
-/** All variant values — useful for building selects/controls. */
-export declare const AVATAR_STACK_VARIANTS: readonly ["static", "fanout-right", "fanout-left", "fanout-center"];
-/** Variant used when `variant` is omitted. */
-export declare const DEFAULT_AVATAR_STACK_VARIANT: AvatarStackVariant;

package/build/components/AvatarStack/hooks/useAnimatedStack.d.ts

@@ -1,25 +0,0 @@
-import type { MutableRefObject } from 'react';
-type UseAnimatedStackArgs = {
-    slotCount: number;
-    /** Slot that stays in place while the others fan out around it. */
-    anchorIndex: number;
-    size: number;
-    stackStep: number;
-    gap: number;
-    /** Whether hovering expands the row. */
-    isFanOutEnabled: boolean;
-    /** Hide non-anchor items while idle. */
-    compact: boolean;
-};
-/** Hover state, slot measurement, and fan-out geometry for `AnimatedStack`. */
-export declare function useAnimatedStack({ slotCount, anchorIndex, size, stackStep, gap, isFanOutEnabled, compact }: UseAnimatedStackArgs): {
-    slotRefs: MutableRefObject<(HTMLDivElement | null)[]>;
-    handleMouseEnter: () => void;
-    handleMouseLeave: () => void;
-    isExpanded: boolean;
-    collapsedWidth: number;
-    trackWidth: number;
-    translateX: number[];
-    slotOpacity: (0 | 1)[];
-};
-export {};

package/build/components/AvatarStack/index.d.ts

@@ -1,4 +0,0 @@
-export { default } from './AvatarStack';
-export { default as AvatarStackItem } from './AvatarStackItem';
-export { AVATAR_STACK_VARIANTS, avatarStackClassNames, DEFAULT_AVATAR_STACK_VARIANT } from './constants';
-export type { AvatarStackItemRenderContext, AvatarStackOverflowRenderArgs } from './type';

package/build/components/AvatarStack/index.js

@@ -1 +0,0 @@
-export{b as AVATAR_STACK_VARIANTS,d as AvatarStackItem,c as DEFAULT_AVATAR_STACK_VARIANT,a as avatarStackClassNames,e as default}from'../../_chunks/chunk-V2Z6RD2T.js';import'../../_chunks/chunk-TIO3V7XA.js';import'../../_chunks/chunk-4XXNGLS6.js';import'../../_chunks/chunk-V2RLDP5A.js';import'../../_chunks/chunk-ZDBICST5.js';

package/build/components/AvatarStack/style.d.ts

@@ -1,303 +0,0 @@
-/// <reference types="react" />
-import type { Theme } from '@mui/material/styles';
-/** Static root — an overlapping flex row. */
-export declare const AvatarStackRowStyled: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-}, keyof import("@mui/system").BoxOwnProps<Theme>> & import("@mui/system").MUIStyledCommonProps<Theme> & {
-    $slotSize: number;
-}, {}, {}>;
-/** `AvatarStackItem` circle — stretches its child to fill the slot. */
-export declare const AvatarStackItemStyled: import("@emotion/styled").StyledComponent<Omit<Omit<import("../primitives").AvatarProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-} & import("@mui/system").MUIStyledCommonProps<Theme>, {}, {}>;
-/** Default static `+N` item. */
-export declare const AvatarStackStaticOverflowStyled: import("@emotion/styled").StyledComponent<Omit<Omit<import("../primitives").AvatarProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-} & import("@mui/system").MUIStyledCommonProps<Theme>, {}, {}>;
-/** Fanout root — flex shell around the track. */
-export declare const AvatarStackShellStyled: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-}, keyof import("@mui/system").BoxOwnProps<Theme>> & import("@mui/system").MUIStyledCommonProps<Theme> & {
-    $isFullWidth: boolean;
-}, {}, {}>;
-/** Positioned track — width animates between collapsed and fanned. */
-export declare const AvatarStackTrackStyled: import("@emotion/styled").StyledComponent<import("@mui/system").MUIStyledCommonProps<Theme> & {
-    $width: number;
-    $minWidth: number;
-    $height: number;
-    $zIndex?: number | undefined;
-}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
-/** One item slot at its collapsed position; framer-motion animates `x` / `opacity` on top. */
-export declare const AvatarStackSlotStyled: import("@emotion/styled").StyledComponent<{
-    color?: string | undefined;
-    content?: string | undefined;
-    translate?: "yes" | "no" | undefined;
-    id?: string | undefined;
-    defaultChecked?: boolean | undefined;
-    defaultValue?: string | number | readonly string[] | undefined;
-    suppressContentEditableWarning?: boolean | undefined;
-    suppressHydrationWarning?: boolean | undefined;
-    accessKey?: string | undefined;
-    autoCapitalize?: (string & {}) | "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined;
-    autoFocus?: boolean | undefined;
-    className?: string | undefined;
-    contentEditable?: (boolean | "false" | "true") | "inherit" | "plaintext-only" | undefined;
-    contextMenu?: string | undefined;
-    dir?: string | undefined;
-    draggable?: (boolean | "false" | "true") | undefined;
-    enterKeyHint?: "search" | "done" | "enter" | "go" | "next" | "previous" | "send" | undefined;
-    hidden?: boolean | undefined;
-    lang?: string | undefined;
-    nonce?: string | undefined;
-    slot?: string | undefined;
-    spellCheck?: (boolean | "false" | "true") | undefined;
-    tabIndex?: number | undefined;
-    title?: string | undefined;
-    radioGroup?: string | undefined;
-    role?: import("react").AriaRole | undefined;
-    about?: string | undefined;
-    datatype?: string | undefined;
-    inlist?: any;
-    prefix?: string | undefined;
-    property?: string | undefined;
-    rel?: string | undefined;
-    resource?: string | undefined;
-    rev?: string | undefined;
-    typeof?: string | undefined;
-    vocab?: string | undefined;
-    autoCorrect?: string | undefined;
-    autoSave?: string | undefined;
-    itemProp?: string | undefined;
-    itemScope?: boolean | undefined;
-    itemType?: string | undefined;
-    itemID?: string | undefined;
-    itemRef?: string | undefined;
-    results?: number | undefined;
-    security?: string | undefined;
-    unselectable?: "off" | "on" | undefined;
-    inputMode?: "text" | "url" | "email" | "search" | "none" | "tel" | "numeric" | "decimal" | undefined;
-    is?: string | undefined;
-    exportparts?: string | undefined;
-    part?: string | undefined;
-    "aria-activedescendant"?: string | undefined;
-    "aria-atomic"?: (boolean | "false" | "true") | undefined;
-    "aria-autocomplete"?: "list" | "none" | "inline" | "both" | undefined;
-    "aria-braillelabel"?: string | undefined;
-    "aria-brailleroledescription"?: string | undefined;
-    "aria-busy"?: (boolean | "false" | "true") | undefined;
-    "aria-checked"?: boolean | "false" | "true" | "mixed" | undefined;
-    "aria-colcount"?: number | undefined;
-    "aria-colindex"?: number | undefined;
-    "aria-colindextext"?: string | undefined;
-    "aria-colspan"?: number | undefined;
-    "aria-controls"?: string | undefined;
-    "aria-current"?: boolean | "page" | "false" | "true" | "date" | "time" | "step" | "location" | undefined;
-    "aria-describedby"?: string | undefined;
-    "aria-description"?: string | undefined;
-    "aria-details"?: string | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
-    "aria-dropeffect"?: "link" | "copy" | "none" | "move" | "execute" | "popup" | undefined;
-    "aria-errormessage"?: string | undefined;
-    "aria-expanded"?: (boolean | "false" | "true") | undefined;
-    "aria-flowto"?: string | undefined;
-    "aria-grabbed"?: (boolean | "false" | "true") | undefined;
-    "aria-haspopup"?: boolean | "grid" | "false" | "true" | "dialog" | "listbox" | "menu" | "tree" | undefined;
-    "aria-hidden"?: (boolean | "false" | "true") | undefined;
-    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
-    "aria-keyshortcuts"?: string | undefined;
-    "aria-label"?: string | undefined;
-    "aria-labelledby"?: string | undefined;
-    "aria-level"?: number | undefined;
-    "aria-live"?: "off" | "assertive" | "polite" | undefined;
-    "aria-modal"?: (boolean | "false" | "true") | undefined;
-    "aria-multiline"?: (boolean | "false" | "true") | undefined;
-    "aria-multiselectable"?: (boolean | "false" | "true") | undefined;
-    "aria-orientation"?: "horizontal" | "vertical" | undefined;
-    "aria-owns"?: string | undefined;
-    "aria-placeholder"?: string | undefined;
-    "aria-posinset"?: number | undefined;
-    "aria-pressed"?: boolean | "false" | "true" | "mixed" | undefined;
-    "aria-readonly"?: (boolean | "false" | "true") | undefined;
-    "aria-relevant"?: "all" | "text" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
-    "aria-required"?: (boolean | "false" | "true") | undefined;
-    "aria-roledescription"?: string | undefined;
-    "aria-rowcount"?: number | undefined;
-    "aria-rowindex"?: number | undefined;
-    "aria-rowindextext"?: string | undefined;
-    "aria-rowspan"?: number | undefined;
-    "aria-selected"?: (boolean | "false" | "true") | undefined;
-    "aria-setsize"?: number | undefined;
-    "aria-sort"?: "ascending" | "descending" | "none" | "other" | undefined;
-    "aria-valuemax"?: number | undefined;
-    "aria-valuemin"?: number | undefined;
-    "aria-valuenow"?: number | undefined;
-    "aria-valuetext"?: string | undefined;
-    dangerouslySetInnerHTML?: {
-        __html: string | TrustedHTML;
-    } | undefined;
-    onCopy?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCopyCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCut?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCutCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onPaste?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onPasteCapture?: import("react").ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCompositionEnd?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionStart?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLDivElement> | undefined;
-    onFocus?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
-    onFocusCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
-    onBlur?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
-    onBlurCapture?: import("react").FocusEventHandler<HTMLDivElement> | undefined;
-    onChange?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onChangeCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onBeforeInput?: import("react").InputEventHandler<HTMLDivElement> | undefined;
-    onBeforeInputCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onInput?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onInputCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onReset?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onResetCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onSubmit?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onSubmitCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onInvalid?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onInvalidCapture?: import("react").FormEventHandler<HTMLDivElement> | undefined;
-    onLoad?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onError?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onErrorCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onKeyDown?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyPress?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyUp?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLDivElement> | undefined;
-    onAbort?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onAbortCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayThrough?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onDurationChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEmptied?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEmptiedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEncrypted?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEncryptedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEnded?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onEndedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedData?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedMetadata?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadStart?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadStartCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPause?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPauseCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPlay?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPlayCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPlaying?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onPlayingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onProgress?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onProgressCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onRateChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onRateChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSeeked?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSeekedCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSeeking?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSeekingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onStalled?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onStalledCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSuspend?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSuspendCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onTimeUpdate?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onVolumeChange?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onWaiting?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onWaitingCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onAuxClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onAuxClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onContextMenu?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onContextMenuCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onDoubleClick?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onDragCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragEndCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragEnter?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragEnterCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragExit?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragExitCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragLeave?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragLeaveCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragOver?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragOverCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDragStartCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDrop?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onDropCapture?: import("react").DragEventHandler<HTMLDivElement> | undefined;
-    onMouseDown?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseDownCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseEnter?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseLeave?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseMove?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOut?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOutCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOver?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOverCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseUp?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseUpCapture?: import("react").MouseEventHandler<HTMLDivElement> | undefined;
-    onSelect?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onSelectCapture?: import("react").ReactEventHandler<HTMLDivElement> | undefined;
-    onTouchCancel?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchEnd?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchEndCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchMove?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchStart?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchStartCapture?: import("react").TouchEventHandler<HTMLDivElement> | undefined;
-    onPointerDown?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerDownCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerMove?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerUp?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerUpCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerCancel?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerEnter?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerLeave?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOver?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOverCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOut?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOutCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onGotPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onLostPointerCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLDivElement> | undefined;
-    onScroll?: import("react").UIEventHandler<HTMLDivElement> | undefined;
-    onScrollCapture?: import("react").UIEventHandler<HTMLDivElement> | undefined;
-    onWheel?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
-    onWheelCapture?: import("react").WheelEventHandler<HTMLDivElement> | undefined;
-    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationEnd?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationIteration?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLDivElement> | undefined;
-    onTransitionEnd?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
-    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLDivElement> | undefined;
-} & import("framer-motion").MotionProps & import("react").RefAttributes<HTMLDivElement> & import("@mui/system").MUIStyledCommonProps<Theme> & {
-    $index: number;
-    $left: number;
-    $size: number;
-    $isHidden: boolean;
-}, {}, {}>;
-/** Default fanout `+N` item. */
-export declare const AvatarStackOverflowStyled: import("@emotion/styled").StyledComponent<Omit<Omit<import("../primitives").AvatarProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
-} & import("@mui/system").MUIStyledCommonProps<Theme> & {
-    $size: number;
-}, {}, {}>;

package/build/components/AvatarStack/type.d.ts

@@ -1,122 +0,0 @@
-import type { BoxProps } from '@mui/material/Box';
-import type { HTMLAttributes, ReactNode, Ref } from 'react';
-import type { AvatarProps } from '../primitives';
-/**
- * Controls both the render mode and (for fanout variants) the fan-out direction.
- *
- * - `"static"` — overlapping row, no hover animation **(default)**
- * - `"fanout-right"` — fans right on hover (anchor: leftmost item)
- * - `"fanout-left"` — fans left on hover (anchor: rightmost item)
- * - `"fanout-center"` — fans both ways on hover (anchor: middle item)
- */
-export type AvatarStackVariant = 'static' | 'fanout-right' | 'fanout-left' | 'fanout-center';
-/** Resolved internally from `variant` — not exposed as a prop. */
-export type AvatarStackFanOutDirection = 'right' | 'left' | 'center';
-/** Passed to `renderItem` so the callback knows how large to render each item. */
-export type AvatarStackItemRenderContext = {
-    slotSize: number;
-};
-/**
- * Passed to `renderOverflow` when items exceed `maxItems`.
- *
- * @template T — matches the `items` array type on `AvatarStackProps<T>`.
- */
-export type AvatarStackOverflowRenderArgs<T = unknown> = {
-    /** The full `items` array passed to `AvatarStack`. */
-    items: readonly T[];
-    /** The hidden items that overflowed past `maxItems`. */
-    overflowItems: readonly T[];
-    /** Item diameter in px — size your overflow item to this value. */
-    size: number;
-};
-/** Fine-grained style/prop overrides for internal slots. */
-export type AvatarStackSlotProps = {
-    /** Outer flex shell wrapping the item track (`Box`). Fanout variants only. */
-    shell?: BoxProps;
-    /** Positioned `<div>` holding all item slots — use for `aria-label` and other HTML attributes. Fanout variants only. */
-    track?: HTMLAttributes<HTMLDivElement>;
-    /** Layout dimensions. Only `size` applies to the static variant. */
-    layout?: {
-        /** Z-index of the track while hovered. @default 1000 */
-        zIndex?: number;
-        /** Item diameter in px. @default 24 */
-        size?: number;
-        /** Horizontal distance between stacked items in px. @default size / 2 */
-        stackStep?: number;
-        /** Space between items when fully expanded in px. */
-        gap?: number;
-        /** Minimum width of the item track container in px. */
-        minTrackWidth?: number;
-    };
-};
-/**
- * Props for `AvatarStack`.
- *
- * `items` is the only source of truth: pass `items` + `getItemKey` + `renderItem`.
- */
-export type AvatarStackProps<T = unknown> = {
-    /** Render mode and fan-out direction. @default 'static' */
-    variant?: AvatarStackVariant;
-    /** Data array. Requires `getItemKey` and `renderItem`. */
-    items?: readonly T[];
-    getItemKey?: (item: T, index: number) => string;
-    renderItem?: (item: T, index: number, ctx: AvatarStackItemRenderContext) => ReactNode;
-    /**
-     * Total slot count **including** the `+N` item. Once the source reaches this
-     * count, the first `maxItems - 1` items stay visible and the rest collapse into `+N`.
-     */
-    maxItems?: number;
-    /**
-     * **Fanout variants only.** Show only the anchor item while idle; hovering
-     * reveals all items with the fan-out animation defined by `variant`.
-     * @default false
-     */
-    compact?: boolean;
-    /**
-     * Replace the `+N` overflow slot. Receives the full `items` array and the hidden `overflowItems` slice.
-     * Static variant: returning `null`/`undefined` falls back to the default `+N` item.
-     */
-    renderOverflow?: (args: AvatarStackOverflowRenderArgs<T>) => ReactNode;
-    /** Set on the same node as `data-testid` (static row / fanout track). Never auto-generated. */
-    id?: string;
-    sx?: BoxProps['sx'];
-    className?: string;
-    /** Style/prop overrides for internal slots and layout dimensions. */
-    slotProps?: AvatarStackSlotProps;
-    /** @default id ?? 'AvatarStack' */
-    'data-testid'?: string;
-};
-/** Single circular item for the static variant, built on the `Avatar` primitive. `title` adds a hover tooltip. */
-export type AvatarStackItemProps = Omit<AvatarProps, 'title'> & {
-    title?: ReactNode;
-};
-/** One rendered position in the row — a visible item or the `+N` item. */
-export type AvatarStackSlotModel = {
-    key: string;
-    render: () => ReactNode;
-};
-/** Resolved data-driven source — the `items` list with its key/render pair. */
-export type AvatarStackSource<T> = {
-    items: readonly T[];
-    getItemKey: (item: T, index: number) => string;
-    renderItem: (item: T, index: number, ctx: AvatarStackItemRenderContext) => ReactNode;
-};
-/** Resolved dimensions for the fanout track. */
-export type AvatarStackLayout = {
-    size: number;
-    stackStep: number;
-    gap: number;
-    minTrackWidth: number;
-};
-/** Props shared by `StaticStack` and `AnimatedStack`, already resolved by `AvatarStack`. */
-type AvatarStackRendererProps<T> = Pick<AvatarStackProps<T>, 'id' | 'data-testid' | 'className' | 'sx' | 'slotProps' | 'maxItems' | 'renderOverflow'> & {
-    source: AvatarStackSource<T>;
-    rootRef?: Ref<HTMLDivElement>;
-};
-export type AvatarStackStaticStackProps<T> = AvatarStackRendererProps<T>;
-export type AvatarStackAnimatedStackProps<T> = AvatarStackRendererProps<T> & {
-    fanOutDirection: AvatarStackFanOutDirection;
-    /** See `AvatarStackProps.compact`. */
-    compact: boolean;
-};
-export {};

package/build/components/AvatarStack/utils.d.ts

@@ -1,55 +0,0 @@
-import type { MutableRefObject, ReactNode } from 'react';
-import type { AvatarStackFanOutDirection, AvatarStackLayout, AvatarStackOverflowRenderArgs, AvatarStackProps, AvatarStackSlotModel, AvatarStackSource, AvatarStackVariant } from './type';
-/**
- * Resolves the `items` source. Returns `null` when `items`, `getItemKey`, or
- * `renderItem` is missing, or when there is nothing to render.
- */
-export declare function resolveAvatarStackSource<T>({ items, getItemKey, renderItem, }: Pick<AvatarStackProps<T>, 'items' | 'getItemKey' | 'renderItem'>): AvatarStackSource<T> | null;
-export declare function getFanOutDirection(variant: AvatarStackVariant): AvatarStackFanOutDirection;
-/**
- * Splits `items` into visible and hidden slices.
- *
- * Overflow triggers when `maxItems >= 1` and `items.length >= maxItems`: the first
- * `maxItems - 1` items stay visible so the `+N` item fills the last slot.
- */
-export declare function splitAvatarStackOverflow<T>(items: readonly T[], maxItems: number | undefined): {
-    visibleItems: readonly T[];
-    hiddenItems: readonly T[];
-};
-/**
- * Fanout guard — `true` when the row overflows into a `+N` item, so fan-out is disabled
- * (the `+N` item would jump mid-animation). Derived from `splitAvatarStackOverflow` so the
- * cap threshold cannot drift from what `buildAvatarStackSlots` renders.
- */
-export declare function hasAvatarStackOverflow<T>(items: readonly T[], maxItems: number | undefined): boolean;
-/** Builds one slot per visible item, plus a trailing `+N` slot when items overflow. */
-export declare function buildAvatarStackSlots<T>({ source: { items, getItemKey, renderItem }, maxItems, slotSize, renderOverflow, }: {
-    source: Pick<AvatarStackSource<T>, 'items' | 'getItemKey' | 'renderItem'>;
-    maxItems: number | undefined;
-    slotSize: number;
-    renderOverflow: (args: AvatarStackOverflowRenderArgs<T>) => ReactNode;
-}): AvatarStackSlotModel[];
-/** Fills unset layout values, scaling them from `size`. */
-export declare function getAvatarStackLayout(overrides: Partial<AvatarStackLayout>): AvatarStackLayout;
-/** The slot that stays in place while the others fan out around it. */
-export declare function getFanOutAnchorIndex(slotCount: number, direction: AvatarStackFanOutDirection): number;
-/** Width of the collapsed (overlapping) row. */
-export declare function getCollapsedWidthPx(slotCount: number, stackStep: number, size: number): number;
-/**
- * Left offset of every slot once fanned out, laid side by side outward from the anchor.
- * `slotWidths` must hold one entry per slot.
- */
-export declare function getFannedLeftPositionsPx({ slotCount, anchorIndex, slotWidths, gap, stackStep, }: {
-    slotCount: number;
-    anchorIndex: number;
-    slotWidths: number[];
-    gap: number;
-    stackStep: number;
-}): number[];
-/** Per-slot `x` translation from its collapsed position (`index * stackStep`) to its fanned position. */
-export declare function getFanOutTranslateXPx(slotCount: number, isExpanded: boolean, fannedLeftPositions: number[], stackStep: number): number[];
-/** Width of the fanned-out row — never narrower than the collapsed row. */
-export declare function getFannedWidthPx(fannedLeftPositions: number[], slotWidths: number[], collapsedWidth: number): number;
-/** Reads each slot's rendered width; unmounted slots fall back to `fallbackWidth`. */
-export declare function readSlotWidthsPx(slotCount: number, slotRefs: MutableRefObject<Array<HTMLDivElement | null>>, fallbackWidth: number): number[];
-export declare function areNumberArraysEqual(a: number[], b: number[]): boolean;