@tap-payments/os-micro-frontend-shared 0.3.228-test.4 → 0.3.228-test.6

package/build/components/AppServicesBar/index.js

@@ -1 +1 @@
-export{hc as default}from'../../_chunks/chunk-A5TVBLMW.js';import'../../_chunks/chunk-XB7FBOZY.js';import'../../_chunks/chunk-WBSLKERM.js';import'../../_chunks/chunk-TBVDKU6Z.js';import'../../_chunks/chunk-SHPLL25Y.js';import'../../_chunks/chunk-RYUEVQJU.js';import'../../_chunks/chunk-TKJY4RKT.js';import'../../_chunks/chunk-MJMESYES.js';import'../../_chunks/chunk-SQQQO7OV.js';import'../../_chunks/chunk-L3QTQGRX.js';import'../../_chunks/chunk-IPDUNXKW.js';import'../../_chunks/chunk-PVFADDJD.js';import'../../_chunks/chunk-DFKVDI3S.js';import'../../_chunks/chunk-X57YOWP2.js';import'../../_chunks/chunk-K7IIZSSP.js';import'../../_chunks/chunk-QDUVPDG5.js';import'../../_chunks/chunk-UW7IPQHO.js';import'../../_chunks/chunk-FBZFU4SR.js';import'../../_chunks/chunk-XNEEY5CO.js';import'../../_chunks/chunk-NSTK57XR.js';import'../../_chunks/chunk-RICZPR7Q.js';import'../../_chunks/chunk-5SDOLBWD.js';import'../../_chunks/chunk-ZRSUSRXM.js';import'../../_chunks/chunk-VC74URMO.js';import'../../_chunks/chunk-LMIQA4BQ.js';import'../../_chunks/chunk-PWK2Q4XY.js';import'../../_chunks/chunk-FG5BQBHL.js';import'../../_chunks/chunk-AYC5LJR4.js';import'../../_chunks/chunk-B4PTS6YE.js';import'../../_chunks/chunk-UCMEXZPX.js';import'../../_chunks/chunk-OIPJEXSN.js';import'../../_chunks/chunk-XUGHTNTE.js';import'../../_chunks/chunk-JATMZKQB.js';import'../../_chunks/chunk-W3S7OIS3.js';import'../../_chunks/chunk-MAZVGT6F.js';import'../../_chunks/chunk-57BVC26N.js';import'../../_chunks/chunk-GOOCA5DE.js';import'../../_chunks/chunk-T4EQN7S3.js';import'../../_chunks/chunk-WJI2VGZO.js';import'../../_chunks/chunk-ZONDSLTR.js';import'../../_chunks/chunk-WSUQM76Y.js';import'../../_chunks/chunk-SK7L4FPZ.js';import'../../_chunks/chunk-36UPNYZ2.js';import'../../_chunks/chunk-VX4M7RWB.js';import'../../_chunks/chunk-AC5FVKRE.js';import'../../_chunks/chunk-HDCNWBW5.js';import'../../_chunks/chunk-C5KT4W73.js';import'../../_chunks/chunk-FRUIFUX5.js';import'../../_chunks/chunk-6WRCJ3JV.js';import'../../_chunks/chunk-MIR5LWOK.js';import'../../_chunks/chunk-E54H2MD4.js';import'../../_chunks/chunk-CVVU7LQU.js';import'../../_chunks/chunk-XBF2WYZ5.js';import'../../_chunks/chunk-POBETEXT.js';import'../../_chunks/chunk-NBJVERMO.js';import'../../_chunks/chunk-XJCQHAUH.js';import'../../_chunks/chunk-Z4JJP2AI.js';import'../../_chunks/chunk-RJMMGFXQ.js';import'../../_chunks/chunk-WLJRMDL2.js';import'../../_chunks/chunk-JEMYLMGO.js';import'../../_chunks/chunk-Y53JKURM.js';import'../../_chunks/chunk-WUAPKJJD.js';import'../../_chunks/chunk-LACJOZAQ.js';import'../../_chunks/chunk-A7XZTRW7.js';import'../../_chunks/chunk-IBXQUIGS.js';import'../../_chunks/chunk-7RGDRE5N.js';import'../../_chunks/chunk-AOQLIWPT.js';import'../../_chunks/chunk-Z5YTSBNX.js';import'../../_chunks/chunk-6JHWQUVB.js';import'../../_chunks/chunk-NRXZJ3SP.js';import'../../_chunks/chunk-X7DIX5Y2.js';import'../../_chunks/chunk-FQ2VMVUY.js';import'../../_chunks/chunk-QI64N63S.js';import'../../_chunks/chunk-MUR4ILTY.js';import'../../_chunks/chunk-FTJ66PQ7.js';import'../../_chunks/chunk-KW63NI5X.js';import'../../_chunks/chunk-TOYCZFK4.js';import'../../_chunks/chunk-EDB7FWU3.js';import'../../_chunks/chunk-F6CKS6UM.js';import'../../_chunks/chunk-VLG2MR3G.js';import'../../_chunks/chunk-7EDX7L2Q.js';import'../../_chunks/chunk-I5N5IAEF.js';import'../../_chunks/chunk-ZQNQIXT7.js';import'../../_chunks/chunk-ZDBICST5.js';
+export{Cc as default}from'../../_chunks/chunk-M572YUHC.js';import'../../_chunks/chunk-FKG3SYY6.js';import'../../_chunks/chunk-33C463YL.js';import'../../_chunks/chunk-XB7FBOZY.js';import'../../_chunks/chunk-JEYLI22W.js';import'../../_chunks/chunk-AIUSMEM5.js';import'../../_chunks/chunk-TH5E43JD.js';import'../../_chunks/chunk-QGQRTANO.js';import'../../_chunks/chunk-KV7KQ6MZ.js';import'../../_chunks/chunk-MBTSXCJW.js';import'../../_chunks/chunk-XSRIBZ5H.js';import'../../_chunks/chunk-MMFW3YZV.js';import'../../_chunks/chunk-ZGZK4AZ3.js';import'../../_chunks/chunk-XBUO2UHM.js';import'../../_chunks/chunk-4SWNFKMX.js';import'../../_chunks/chunk-DPOBKAVX.js';import'../../_chunks/chunk-W4PURLBP.js';import'../../_chunks/chunk-DEQ2OTPX.js';import'../../_chunks/chunk-PHVELRMX.js';import'../../_chunks/chunk-WAY7BWQL.js';import'../../_chunks/chunk-FNWPZLRV.js';import'../../_chunks/chunk-GIUONT72.js';import'../../_chunks/chunk-EI4VQCCM.js';import'../../_chunks/chunk-GNNMQUBT.js';import'../../_chunks/chunk-545BCGVE.js';import'../../_chunks/chunk-MAZVGT6F.js';import'../../_chunks/chunk-DKMFQFZU.js';import'../../_chunks/chunk-KS7YB4UX.js';import'../../_chunks/chunk-KD4RSWN6.js';import'../../_chunks/chunk-OAEOQ7AZ.js';import'../../_chunks/chunk-P57UJVYY.js';import'../../_chunks/chunk-RZJSME6H.js';import'../../_chunks/chunk-O4UZRDVR.js';import'../../_chunks/chunk-MQOX7MKN.js';import'../../_chunks/chunk-YPVFVBG3.js';import'../../_chunks/chunk-F2LUAXXO.js';import'../../_chunks/chunk-AFDB2YM6.js';import'../../_chunks/chunk-LOGPCQ24.js';import'../../_chunks/chunk-VTJJFPK5.js';import'../../_chunks/chunk-AIT2A7YM.js';import'../../_chunks/chunk-ACYZKBPV.js';import'../../_chunks/chunk-SWXXEAIZ.js';import'../../_chunks/chunk-7GVPGH6A.js';import'../../_chunks/chunk-R5PUIGMB.js';import'../../_chunks/chunk-ZONDSLTR.js';import'../../_chunks/chunk-TY3LDUTP.js';import'../../_chunks/chunk-KSTOW7O3.js';import'../../_chunks/chunk-HDCNWBW5.js';import'../../_chunks/chunk-HKQY74IJ.js';import'../../_chunks/chunk-5DLQTR4L.js';import'../../_chunks/chunk-U62XSJM5.js';import'../../_chunks/chunk-OYJYQKLK.js';import'../../_chunks/chunk-J4V7VRJY.js';import'../../_chunks/chunk-32CPM4J3.js';import'../../_chunks/chunk-LQOS3MF6.js';import'../../_chunks/chunk-VQ4INPUZ.js';import'../../_chunks/chunk-MFFVCCTZ.js';import'../../_chunks/chunk-6VQVT7U4.js';import'../../_chunks/chunk-FAKPBQH3.js';import'../../_chunks/chunk-64ILCI3S.js';import'../../_chunks/chunk-CAKSLKXG.js';import'../../_chunks/chunk-5EP3LEOE.js';import'../../_chunks/chunk-4AFJCOBN.js';import'../../_chunks/chunk-W3D5YN4V.js';import'../../_chunks/chunk-JORNMG4I.js';import'../../_chunks/chunk-T5WRDF6Z.js';import'../../_chunks/chunk-S3YBXSFG.js';import'../../_chunks/chunk-TKU4GMEV.js';import'../../_chunks/chunk-QZAVOGKZ.js';import'../../_chunks/chunk-UD33MPJX.js';import'../../_chunks/chunk-MHZSYMQP.js';import'../../_chunks/chunk-GAL3X7PR.js';import'../../_chunks/chunk-FTG5LY7I.js';import'../../_chunks/chunk-JQTHWXQR.js';import'../../_chunks/chunk-FQ2VMVUY.js';import'../../_chunks/chunk-44UNMXKS.js';import'../../_chunks/chunk-MUR4ILTY.js';import'../../_chunks/chunk-LROBJEJT.js';import'../../_chunks/chunk-TIO3V7XA.js';import'../../_chunks/chunk-OBHJVUFA.js';import'../../_chunks/chunk-BIJMWICZ.js';import'../../_chunks/chunk-LIHS4ZYZ.js';import'../../_chunks/chunk-4XXNGLS6.js';import'../../_chunks/chunk-V2RLDP5A.js';import'../../_chunks/chunk-ZDBICST5.js';

package/build/components/AppWindowWrapper/index.js

@@ -1 +1 @@
-export{i as AccountHeaderTitle,o as AppWindow,a as AppWindowContext,b as AppWindowContextProvider,q as AppWindowHeader,p as AppWindowHeaderBase,h as FOOTER_HEIGHT,d as LEFT_SIDEBAR,e as RIGHT_SIDEBAR,m as StyledFooter,n as StyledHideButton,j as StyledMenuLink,k as StyledSubmitButton,l as SubmitButtonWrapper,g as VIEWER_HEIGHT,f as VIEWER_WIDTH,c as animationDuration,r as default}from'../../_chunks/chunk-KW63NI5X.js';import'../../_chunks/chunk-TOYCZFK4.js';import'../../_chunks/chunk-EDB7FWU3.js';import'../../_chunks/chunk-VLG2MR3G.js';import'../../_chunks/chunk-7EDX7L2Q.js';import'../../_chunks/chunk-I5N5IAEF.js';import'../../_chunks/chunk-ZQNQIXT7.js';import'../../_chunks/chunk-ZDBICST5.js';
+export{i as AccountHeaderTitle,o as AppWindow,a as AppWindowContext,b as AppWindowContextProvider,q as AppWindowHeader,p as AppWindowHeaderBase,h as FOOTER_HEIGHT,d as LEFT_SIDEBAR,e as RIGHT_SIDEBAR,m as StyledFooter,n as StyledHideButton,j as StyledMenuLink,k as StyledSubmitButton,l as SubmitButtonWrapper,g as VIEWER_HEIGHT,f as VIEWER_WIDTH,c as animationDuration,r as default}from'../../_chunks/chunk-GAL3X7PR.js';import'../../_chunks/chunk-FTG5LY7I.js';import'../../_chunks/chunk-JQTHWXQR.js';import'../../_chunks/chunk-TIO3V7XA.js';import'../../_chunks/chunk-OBHJVUFA.js';import'../../_chunks/chunk-4XXNGLS6.js';import'../../_chunks/chunk-V2RLDP5A.js';import'../../_chunks/chunk-ZDBICST5.js';

package/build/components/AreaChart/index.js

@@ -1 +1 @@
-export{a as areaChartClassNames,b as default}from'../../_chunks/chunk-FTJ66PQ7.js';import'../../_chunks/chunk-I5N5IAEF.js';import'../../_chunks/chunk-ZQNQIXT7.js';import'../../_chunks/chunk-ZDBICST5.js';
+export{a as areaChartClassNames,b as default}from'../../_chunks/chunk-W3D5YN4V.js';import'../../_chunks/chunk-4XXNGLS6.js';import'../../_chunks/chunk-V2RLDP5A.js';import'../../_chunks/chunk-ZDBICST5.js';

package/build/components/Autocomplete/index.js

@@ -1 +1 @@
-import'../../_chunks/chunk-FQ2VMVUY.js';export{a as Autocomplete}from'../../_chunks/chunk-QI64N63S.js';import'../../_chunks/chunk-MUR4ILTY.js';import'../../_chunks/chunk-I5N5IAEF.js';import'../../_chunks/chunk-ZQNQIXT7.js';import'../../_chunks/chunk-ZDBICST5.js';
+import'../../_chunks/chunk-FQ2VMVUY.js';export{a as Autocomplete}from'../../_chunks/chunk-44UNMXKS.js';import'../../_chunks/chunk-MUR4ILTY.js';import'../../_chunks/chunk-4XXNGLS6.js';import'../../_chunks/chunk-V2RLDP5A.js';import'../../_chunks/chunk-ZDBICST5.js';

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

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { AvatarStackAnimatedStackProps } from './type';
+/**
+ * `variant="fanout-*"` — chips overlap while idle and fan out around the anchor chip 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

@@ -0,0 +1,5 @@
+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/AvatarStackChip.d.ts

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

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

@@ -0,0 +1,4 @@
+/// <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

@@ -0,0 +1,29 @@
+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 chip. */
+    readonly slot: "os-shared-AvatarStack-slot";
+    /** Static only — one overlapping slot per chip (the chip, or its tooltip wrapper). */
+    readonly overlapSlot: "os-shared-AvatarStack-overlapSlot";
+    /** `AvatarStackChip` circle. */
+    readonly overlapChip: "os-shared-AvatarStack-overlapChip";
+    /** Default `+N` chip (both variants). */
+    readonly overflow: "os-shared-AvatarStack-overflow";
+};
+/**
+ * Pre-`os-shared` 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 chip 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

@@ -0,0 +1,25 @@
+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 chips 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

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

package/build/components/AvatarStack/index.js

@@ -0,0 +1 @@
+export{b as AVATAR_STACK_VARIANTS,d as AvatarStackChip,c as DEFAULT_AVATAR_STACK_VARIANT,a as avatarStackClassNames,e as default}from'../../_chunks/chunk-LROBJEJT.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

@@ -0,0 +1,303 @@
+/// <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;
+}, {}, {}>;
+/** `AvatarStackChip` circle — stretches its child to fill the slot. */
+export declare const AvatarStackChipStyled: 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` chip. */
+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 chip 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` chip. */
+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

@@ -0,0 +1,122 @@
+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 chip)
+ * - `"fanout-left"` — fans left on hover (anchor: rightmost chip)
+ * - `"fanout-center"` — fans both ways on hover (anchor: middle chip)
+ */
+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 chip. */
+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[];
+    /** Chip diameter in px — size your overflow chip to this value. */
+    size: number;
+};
+/** Fine-grained style/prop overrides for internal slots. */
+export type AvatarStackSlotProps = {
+    /** Outer flex shell wrapping the chip track (`Box`). Fanout variants only. */
+    shell?: BoxProps;
+    /** Positioned `<div>` holding all chip 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;
+        /** Chip diameter in px. @default 24 */
+        size?: number;
+        /** Horizontal distance between stacked chips in px. @default size / 2 */
+        stackStep?: number;
+        /** Space between chips when fully expanded in px. */
+        gap?: number;
+        /** Minimum width of the chip 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` chip. Once the source reaches this
+     * count, the first `maxItems - 1` chips stay visible and the rest collapse into `+N`.
+     */
+    maxItems?: number;
+    /**
+     * **Fanout variants only.** Show only the anchor chip while idle; hovering
+     * reveals all chips 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 chip.
+     */
+    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 chip for the static variant, built on the `Avatar` primitive. `title` adds a hover tooltip. */
+export type AvatarStackChipProps = Omit<AvatarProps, 'title'> & {
+    title?: ReactNode;
+};
+/** One rendered position in the row — a visible chip or the `+N` chip. */
+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

@@ -0,0 +1,51 @@
+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` chip fills the last slot.
+ */
+export declare function splitAvatarStackOverflow<T>(items: readonly T[], maxItems: number | undefined): {
+    visibleItems: readonly T[];
+    hiddenItems: readonly T[];
+};
+/** Fanout only — `true` when `maxItems` caps the row, which disables the fan-out animation. */
+export declare function isAvatarStackCapped(itemCount: number, 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;