@stackone/malachite 2.51.2 → 2.53.0

package/dist/components/floatingMenuGeometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"floatingMenuGeometry.js","sources":["../../src/components/floatingMenuGeometry.ts"],"sourcesContent":["// Figma: `Dropdown Component - Item List` fills its trigger, 10px below — 444 (68:2789),\n// 200 (2343:2201), 414 (1437:2986). `Dropdown Component - Options List` (213:4320) is a\n// fixed 280px, 14px below. Figma declares no trigger width and no floor; 160 and 400 are ours.\n\nexport const MENU_VIEWPORT_PADDING_PX = 8;\n\nexport const SIDE_PANEL_MIN_HEIGHT_PX = 160;\n\nexport const MENU_MIN_WIDTH_PX = 160;\n\n// Figma draws the Options menu at a flat 280. Taken as a ceiling rather than a width: a kebab\n// of four short verbs then carries 130px of air, and every kebab in a consuming app is the same\n// width whatever it holds. 180 is the floor those menus sized themselves to before this preset.\nexport const MENU_OPTIONS_MIN_WIDTH_PX = 180;\n\nexport type MenuPreset = 'standard' | 'options';\n\nexport interface MenuSpec {\n    /** `'trigger'` fills the control that opened it; `'content'` sizes to the widest item. */\n    width: 'trigger' | 'content';\n    /** Where this preset stops shrinking. */\n    minWidth: number;\n    /** Where a content-sized one stops growing. A caller's `minWidth` still raises past it. */\n    maxWidth?: number;\n    align: 'left' | 'right';\n    gap: number;\n    radius: number;\n    padding: number;\n    shadow: string;\n    background: string;\n    border: string;\n}\n\nexport const MENU_SPECS: Record<MenuPreset, MenuSpec> = {\n    standard: {\n        width: 'trigger',\n        minWidth: MENU_MIN_WIDTH_PX,\n        align: 'left',\n        gap: 10,\n        radius: 12,\n        padding: 4,\n        shadow: '0px 2px 5px 0px rgba(0, 0, 0, 0.1)',\n        background: 'var(--malachite-card-background, rgb(255, 255, 255))',\n        border: '1px solid var(--malachite-card-border, rgb(232, 232, 232))',\n    },\n    options: {\n        width: 'content',\n        minWidth: MENU_OPTIONS_MIN_WIDTH_PX,\n        maxWidth: 280,\n        align: 'right',\n        gap: 14,\n        radius: 12,\n        padding: 8,\n        shadow: '0px 4px 10px 0px rgba(0, 0, 0, 0.1)',\n        background: 'var(--malachite-card-background, rgb(255, 255, 255))',\n        border: '1px solid var(--malachite-card-border, rgb(232, 232, 232))',\n    },\n};\n\nexport const MENU_MAX_HEIGHT_PX = 400;\n\nexport interface MenuGeometry {\n    top: number;\n    left: number;\n    width: number;\n    maxHeight: number;\n    openUp: boolean;\n}\n\nexport interface MenuGeometryInput {\n    triggerRect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom' | 'width'>;\n    preset: MenuPreset;\n    minWidth?: number;\n    /** Which trigger edge the menu prefers to share; defaults to the preset's. */\n    align?: 'left' | 'right';\n    /** The widest item, for a content-sized preset. Absent until the menu has been laid out. */\n    contentWidth?: number;\n    menuHeight: number;\n    viewportWidth: number;\n    viewportHeight: number;\n}\n\nexport const computeMenuGeometry = ({\n    triggerRect,\n    preset,\n    minWidth,\n    align: alignOverride,\n    contentWidth,\n    menuHeight,\n    viewportWidth,\n    viewportHeight,\n}: MenuGeometryInput): MenuGeometry => {\n    const spec = MENU_SPECS[preset];\n    const available = viewportWidth - MENU_VIEWPORT_PADDING_PX * 2;\n\n    const floor = Math.max(spec.minWidth, minWidth ?? 0);\n    const ceiling = Math.min(available, Math.max(spec.maxWidth ?? available, floor));\n    const natural = spec.width === 'trigger' ? triggerRect.width : (contentWidth ?? ceiling);\n    const width = Math.max(0, Math.min(Math.max(natural, floor), ceiling));\n\n    const align = alignOverride ?? spec.align;\n    const preferredLeft = align === 'right' ? triggerRect.right - width : triggerRect.left;\n    const oppositeLeft = align === 'right' ? triggerRect.left : triggerRect.right - width;\n    const minLeft = MENU_VIEWPORT_PADDING_PX;\n    const maxLeft = viewportWidth - width - MENU_VIEWPORT_PADDING_PX;\n    const fits = (candidate: number) => candidate >= minLeft && candidate <= maxLeft;\n\n    let left: number;\n    if (fits(preferredLeft)) {\n        left = preferredLeft;\n    } else if (fits(oppositeLeft)) {\n        left = oppositeLeft;\n    } else {\n        left = Math.max(minLeft, Math.min(preferredLeft, maxLeft));\n    }\n\n    // Which side, then how much of it. \"More room above\" is not \"enough room above\", so the\n    // height is clamped to whichever side won. Clamping `top` instead keeps the menu on screen\n    // by painting it over its own trigger, which also swallows the click that closes it.\n    const roomBelow = viewportHeight - triggerRect.bottom - spec.gap - MENU_VIEWPORT_PADDING_PX;\n    const roomAbove = triggerRect.top - spec.gap - MENU_VIEWPORT_PADDING_PX;\n    const openUp = menuHeight > 0 && menuHeight > roomBelow && roomAbove > roomBelow;\n\n    const maxHeight = Math.max(0, Math.min(MENU_MAX_HEIGHT_PX, openUp ? roomAbove : roomBelow));\n    const height = menuHeight > 0 ? Math.min(menuHeight, maxHeight) : 0;\n\n    const top = Math.max(\n        MENU_VIEWPORT_PADDING_PX,\n        openUp ? triggerRect.top - spec.gap - height : triggerRect.bottom + spec.gap,\n    );\n\n    return { top, left, width, maxHeight, openUp };\n};\n\n// The height decides whether the menu opens upwards, and it is only meaningful at the width the\n// menu will actually have — so on the pass that first sizes the panel the width is written\n// before the height is read. The guard is what keeps that out of the steady state: every later\n// call finds the width already set and writes nothing, so a `ResizeObserver` callback does not\n// resize what it is observing (Chrome's \"undelivered notifications\" error) and a per-frame\n// reposition does not force a reflow. After the first pass this is a pure read.\n// A content-sized preset needs the width the panel chose for itself, which is only readable\n// while no width has been written to it — i.e. on the pass that opens the menu. The caller keeps\n// it from there, because after the first write `offsetWidth` reports what we wrote, not what the\n// items want.\nexport const measureContentWidth = (panel: HTMLElement | null): number | undefined => {\n    if (!panel || panel.style.width !== '') {\n        return undefined;\n    }\n\n    // The rows, not the panel. Each label carries `min-width: 0` and `overflow: hidden` so it\n    // can ellipsise, which also means it contributes nothing to the panel's intrinsic width —\n    // measuring the panel itself returns a box the size of its own padding. `scrollWidth` on a\n    // clipped row is the width the row wanted.\n    const rows = panel.querySelectorAll<HTMLElement>('button, [role=\"menuitem\"]');\n    let widest = 0;\n    rows.forEach((row) => {\n        widest = Math.max(widest, row.scrollWidth);\n    });\n\n    if (widest === 0) {\n        return undefined;\n    }\n\n    // The panel is border-box, so the width we hand back has to carry its own padding and rule.\n    // Each read is defaulted: a computed style can come back empty — jsdom never expands the\n    // `border` shorthand — and one NaN here would make the whole width NaN, which CSS drops,\n    // leaving the panel unsized with no sign of why.\n    const styles = getComputedStyle(panel);\n    const edge = (value: string) => Number.parseFloat(value) || 0;\n    const chrome =\n        edge(styles.paddingLeft) +\n        edge(styles.paddingRight) +\n        edge(styles.borderLeftWidth) +\n        edge(styles.borderRightWidth);\n\n    return Math.ceil(widest + chrome);\n};\n\nexport const measureMenuGeometry = (\n    panel: HTMLElement | null,\n    input: Omit<MenuGeometryInput, 'menuHeight'>,\n): MenuGeometry => {\n    if (!panel) {\n        return computeMenuGeometry({ ...input, menuHeight: 0 });\n    }\n\n    const cssWidth = `${computeMenuGeometry({ ...input, menuHeight: 0 }).width}px`;\n    if (panel.style.width !== cssWidth) {\n        panel.style.width = cssWidth;\n    }\n\n    return computeMenuGeometry({ ...input, menuHeight: panel.offsetHeight });\n};\n\nexport const isTriggerOffscreen = (\n    rect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom'>,\n    viewportWidth: number,\n    viewportHeight: number,\n): boolean =>\n    rect.bottom < 0 || rect.top > viewportHeight || rect.right < 0 || rect.left > viewportWidth;\n\nexport const rectSignature = (rect: Pick<DOMRect, 'top' | 'left' | 'width' | 'height'>): string =>\n    `${rect.top},${rect.left},${rect.width},${rect.height}`;\n\nexport type FloatingPlacement =\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'top-start'\n    | 'top-center'\n    | 'right-start'\n    | 'right-end'\n    | 'left-start';\n\nconst alignedLeft = (\n    align: 'start' | 'end' | 'center',\n    triggerRect: Pick<DOMRect, 'left' | 'right'>,\n    panelWidth: number,\n): number => {\n    if (align === 'end') {\n        return triggerRect.right - panelWidth;\n    }\n    if (align === 'center') {\n        return (triggerRect.left + triggerRect.right - panelWidth) / 2;\n    }\n    return triggerRect.left;\n};\n\nexport const fullPanelHeight = (panel: HTMLElement): number =>\n    panel.scrollHeight + panel.offsetHeight - panel.clientHeight;\n\nexport const FLOATING_OFFSET_PX = { small: 8, medium: 12, large: 14 } as const;\n\nexport type FloatingOffset = keyof typeof FLOATING_OFFSET_PX;\n\nexport interface FloatingGeometryInput {\n    triggerRect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom'>;\n    placement: FloatingPlacement;\n    panelWidth: number;\n    panelHeight: number;\n    gap: number;\n    viewportWidth: number;\n    viewportHeight: number;\n}\n\nexport interface FloatingGeometry {\n    top: number;\n    left: number;\n    maxHeight: number;\n    side: 'top' | 'bottom' | 'left' | 'right';\n}\n\nconst clampToViewport = (value: number, size: number, viewport: number): number =>\n    Math.max(MENU_VIEWPORT_PADDING_PX, Math.min(value, viewport - size - MENU_VIEWPORT_PADDING_PX));\n\nexport const computeFloatingGeometry = ({\n    triggerRect,\n    placement,\n    panelWidth,\n    panelHeight,\n    gap,\n    viewportWidth,\n    viewportHeight,\n}: FloatingGeometryInput): FloatingGeometry => {\n    const [preferred, align] = placement.split('-') as [\n        FloatingGeometry['side'],\n        'start' | 'end' | 'center',\n    ];\n    const pad = MENU_VIEWPORT_PADDING_PX;\n\n    if (preferred === 'top' || preferred === 'bottom') {\n        const roomBelow = viewportHeight - triggerRect.bottom - gap - pad;\n        const roomAbove = triggerRect.top - gap - pad;\n        const wanted = preferred === 'bottom' ? roomBelow : roomAbove;\n        const opposite = preferred === 'bottom' ? roomAbove : roomBelow;\n        const side: FloatingGeometry['side'] =\n            panelHeight > wanted && opposite > wanted\n                ? preferred === 'bottom'\n                    ? 'top'\n                    : 'bottom'\n                : preferred;\n        const belowTop = Math.max(pad, triggerRect.bottom + gap);\n        const aboveBottom = Math.min(viewportHeight - pad, triggerRect.top - gap);\n        const maxHeight = Math.max(\n            0,\n            side === 'bottom' ? viewportHeight - belowTop - pad : aboveBottom - pad,\n        );\n        const height = Math.min(panelHeight, maxHeight);\n        const top = side === 'bottom' ? belowTop : Math.max(pad, aboveBottom - height);\n        const left = clampToViewport(\n            alignedLeft(align, triggerRect, panelWidth),\n            panelWidth,\n            viewportWidth,\n        );\n        return { top, left, maxHeight, side };\n    }\n\n    const roomRight = viewportWidth - triggerRect.right - gap - pad;\n    const roomLeft = triggerRect.left - gap - pad;\n    const wanted = preferred === 'right' ? roomRight : roomLeft;\n    const opposite = preferred === 'right' ? roomLeft : roomRight;\n    const side: FloatingGeometry['side'] =\n        panelWidth > wanted && opposite > wanted\n            ? preferred === 'right'\n                ? 'left'\n                : 'right'\n            : preferred;\n    const left = side === 'right' ? triggerRect.right + gap : triggerRect.left - gap - panelWidth;\n    const levelTop = Math.max(pad, triggerRect.top);\n    const roomBelow = viewportHeight - levelTop - pad;\n    if (align === 'start' && roomBelow >= Math.min(panelHeight, SIDE_PANEL_MIN_HEIGHT_PX)) {\n        return {\n            top: levelTop,\n            left: clampToViewport(left, panelWidth, viewportWidth),\n            maxHeight: roomBelow,\n            side,\n        };\n    }\n    const maxHeight = Math.max(0, viewportHeight - pad * 2);\n    const height = Math.min(panelHeight, maxHeight);\n    const top = clampToViewport(\n        align === 'end' ? triggerRect.bottom - height : triggerRect.top,\n        height,\n        viewportHeight,\n    );\n    return { top, left: clampToViewport(left, panelWidth, viewportWidth), maxHeight, side };\n};\n"],"names":["MENU_VIEWPORT_PADDING_PX","SIDE_PANEL_MIN_HEIGHT_PX","MENU_MIN_WIDTH_PX","MENU_OPTIONS_MIN_WIDTH_PX","MENU_SPECS","MENU_MAX_HEIGHT_PX","computeMenuGeometry","triggerRect","preset","minWidth","alignOverride","contentWidth","menuHeight","viewportWidth","viewportHeight","spec","available","floor","ceiling","natural","width","align","preferredLeft","oppositeLeft","minLeft","maxLeft","fits","candidate","left","roomBelow","roomAbove","openUp","maxHeight","height","measureContentWidth","panel","rows","widest","row","styles","edge","value","chrome","measureMenuGeometry","input","cssWidth","isTriggerOffscreen","rect","rectSignature","alignedLeft","panelWidth","fullPanelHeight","FLOATING_OFFSET_PX","clampToViewport","size","viewport","computeFloatingGeometry","placement","panelHeight","gap","preferred","pad","wanted","opposite","side","belowTop","aboveBottom","top","roomRight","roomLeft","levelTop"],"mappings":"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"}
+{"version":3,"file":"floatingMenuGeometry.js","sources":["../../src/components/floatingMenuGeometry.ts"],"sourcesContent":["// Figma: `Dropdown Component - Item List` fills its trigger, 10px below — 444 (68:2789),\n// 200 (2343:2201), 414 (1437:2986). `Dropdown Component - Options List` (213:4320) is a\n// fixed 280px, 14px below. Figma declares no trigger width and no floor; 160 and 400 are ours.\n\nexport const MENU_VIEWPORT_PADDING_PX = 8;\n\nexport const SIDE_PANEL_MIN_HEIGHT_PX = 160;\n\nexport const MENU_MIN_WIDTH_PX = 160;\n\n// Figma draws the Options menu at a flat 280. Taken as a ceiling rather than a width: a kebab\n// of four short verbs then carries 130px of air, and every kebab in a consuming app is the same\n// width whatever it holds. 180 is the floor those menus sized themselves to before this preset.\nexport const MENU_OPTIONS_MIN_WIDTH_PX = 180;\n\nexport type MenuPreset = 'standard' | 'options';\n\nexport interface MenuSpec {\n    /** `'trigger'` fills the control that opened it; `'content'` sizes to the widest item. */\n    width: 'trigger' | 'content';\n    /** Where this preset stops shrinking. */\n    minWidth: number;\n    /** Where a content-sized one stops growing. A caller's `minWidth` still raises past it. */\n    maxWidth?: number;\n    align: 'left' | 'right';\n    gap: number;\n    radius: number;\n    padding: number;\n    shadow: string;\n    background: string;\n    border: string;\n}\n\nexport const MENU_SPECS: Record<MenuPreset, MenuSpec> = {\n    standard: {\n        width: 'trigger',\n        minWidth: MENU_MIN_WIDTH_PX,\n        align: 'left',\n        gap: 10,\n        radius: 12,\n        padding: 4,\n        shadow: '0px 2px 5px 0px rgba(0, 0, 0, 0.1)',\n        background: 'var(--malachite-card-background, rgb(255, 255, 255))',\n        border: '1px solid var(--malachite-card-border, rgb(232, 232, 232))',\n    },\n    options: {\n        width: 'content',\n        minWidth: MENU_OPTIONS_MIN_WIDTH_PX,\n        maxWidth: 280,\n        align: 'right',\n        gap: 14,\n        radius: 12,\n        padding: 8,\n        shadow: '0px 4px 10px 0px rgba(0, 0, 0, 0.1)',\n        background: 'var(--malachite-card-background, rgb(255, 255, 255))',\n        border: '1px solid var(--malachite-card-border, rgb(232, 232, 232))',\n    },\n};\n\nexport const MENU_MAX_HEIGHT_PX = 400;\n\nexport interface MenuGeometry {\n    top: number;\n    left: number;\n    width: number;\n    maxHeight: number;\n    openUp: boolean;\n}\n\nexport interface MenuGeometryInput {\n    triggerRect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom' | 'width'>;\n    preset: MenuPreset;\n    minWidth?: number;\n    /** Which trigger edge the menu prefers to share; defaults to the preset's. */\n    align?: 'left' | 'right';\n    /** The widest item, for a content-sized preset. Absent until the menu has been laid out. */\n    contentWidth?: number;\n    menuHeight: number;\n    viewportWidth: number;\n    viewportHeight: number;\n}\n\nexport const computeMenuGeometry = ({\n    triggerRect,\n    preset,\n    minWidth,\n    align: alignOverride,\n    contentWidth,\n    menuHeight,\n    viewportWidth,\n    viewportHeight,\n}: MenuGeometryInput): MenuGeometry => {\n    const spec = MENU_SPECS[preset];\n    const available = viewportWidth - MENU_VIEWPORT_PADDING_PX * 2;\n\n    const floor = Math.max(spec.minWidth, minWidth ?? 0);\n    const ceiling = Math.min(available, Math.max(spec.maxWidth ?? available, floor));\n    const natural = spec.width === 'trigger' ? triggerRect.width : (contentWidth ?? ceiling);\n    const width = Math.max(0, Math.min(Math.max(natural, floor), ceiling));\n\n    const align = alignOverride ?? spec.align;\n    const preferredLeft = align === 'right' ? triggerRect.right - width : triggerRect.left;\n    const oppositeLeft = align === 'right' ? triggerRect.left : triggerRect.right - width;\n    const minLeft = MENU_VIEWPORT_PADDING_PX;\n    const maxLeft = viewportWidth - width - MENU_VIEWPORT_PADDING_PX;\n    const fits = (candidate: number) => candidate >= minLeft && candidate <= maxLeft;\n\n    let left: number;\n    if (fits(preferredLeft)) {\n        left = preferredLeft;\n    } else if (fits(oppositeLeft)) {\n        left = oppositeLeft;\n    } else {\n        left = Math.max(minLeft, Math.min(preferredLeft, maxLeft));\n    }\n\n    // Which side, then how much of it. \"More room above\" is not \"enough room above\", so the\n    // height is clamped to whichever side won. Clamping `top` instead keeps the menu on screen\n    // by painting it over its own trigger, which also swallows the click that closes it.\n    const roomBelow = viewportHeight - triggerRect.bottom - spec.gap - MENU_VIEWPORT_PADDING_PX;\n    const roomAbove = triggerRect.top - spec.gap - MENU_VIEWPORT_PADDING_PX;\n    const openUp = menuHeight > 0 && menuHeight > roomBelow && roomAbove > roomBelow;\n\n    const maxHeight = Math.max(0, Math.min(MENU_MAX_HEIGHT_PX, openUp ? roomAbove : roomBelow));\n    const height = menuHeight > 0 ? Math.min(menuHeight, maxHeight) : 0;\n\n    const top = Math.max(\n        MENU_VIEWPORT_PADDING_PX,\n        openUp ? triggerRect.top - spec.gap - height : triggerRect.bottom + spec.gap,\n    );\n\n    return { top, left, width, maxHeight, openUp };\n};\n\n// The height decides whether the menu opens upwards, and it is only meaningful at the width the\n// menu will actually have — so on the pass that first sizes the panel the width is written\n// before the height is read. The guard is what keeps that out of the steady state: every later\n// call finds the width already set and writes nothing, so a `ResizeObserver` callback does not\n// resize what it is observing (Chrome's \"undelivered notifications\" error) and a per-frame\n// reposition does not force a reflow. After the first pass this is a pure read.\n// A content-sized preset needs the width the panel chose for itself, which is only readable\n// while no width has been written to it — i.e. on the pass that opens the menu. The caller keeps\n// it from there, because after the first write `offsetWidth` reports what we wrote, not what the\n// items want.\nexport const measureContentWidth = (panel: HTMLElement | null): number | undefined => {\n    if (!panel || panel.style.width !== '') {\n        return undefined;\n    }\n\n    // The rows, not the panel. Each label carries `min-width: 0` and `overflow: hidden` so it\n    // can ellipsise, which also means it contributes nothing to the panel's intrinsic width —\n    // measuring the panel itself returns a box the size of its own padding. `scrollWidth` on a\n    // clipped row is the width the row wanted. It is rounded to a whole pixel, so a label\n    // 144.2px wide reports 144 and ellipsises at that width; the extra pixel covers the fraction.\n    const rows = panel.querySelectorAll<HTMLElement>('button, [role=\"menuitem\"]');\n    let widest = 0;\n    rows.forEach((row) => {\n        widest = Math.max(widest, row.scrollWidth);\n    });\n\n    if (widest === 0) {\n        return undefined;\n    }\n\n    // The panel is border-box, so the width we hand back has to carry its own padding and rule.\n    // Each read is defaulted: a computed style can come back empty — jsdom never expands the\n    // `border` shorthand — and one NaN here would make the whole width NaN, which CSS drops,\n    // leaving the panel unsized with no sign of why.\n    const styles = getComputedStyle(panel);\n    const edge = (value: string) => Number.parseFloat(value) || 0;\n    const chrome =\n        edge(styles.paddingLeft) +\n        edge(styles.paddingRight) +\n        edge(styles.borderLeftWidth) +\n        edge(styles.borderRightWidth);\n\n    return Math.ceil(widest + 1 + chrome);\n};\n\nexport const measureMenuGeometry = (\n    panel: HTMLElement | null,\n    input: Omit<MenuGeometryInput, 'menuHeight'>,\n): MenuGeometry => {\n    if (!panel) {\n        return computeMenuGeometry({ ...input, menuHeight: 0 });\n    }\n\n    const cssWidth = `${computeMenuGeometry({ ...input, menuHeight: 0 }).width}px`;\n    if (panel.style.width !== cssWidth) {\n        panel.style.width = cssWidth;\n    }\n\n    return computeMenuGeometry({ ...input, menuHeight: panel.offsetHeight });\n};\n\nexport const isTriggerOffscreen = (\n    rect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom'>,\n    viewportWidth: number,\n    viewportHeight: number,\n): boolean =>\n    rect.bottom < 0 || rect.top > viewportHeight || rect.right < 0 || rect.left > viewportWidth;\n\nexport const rectSignature = (rect: Pick<DOMRect, 'top' | 'left' | 'width' | 'height'>): string =>\n    `${rect.top},${rect.left},${rect.width},${rect.height}`;\n\nexport type FloatingPlacement =\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'top-start'\n    | 'top-center'\n    | 'right-start'\n    | 'right-end'\n    | 'left-start';\n\nconst alignedLeft = (\n    align: 'start' | 'end' | 'center',\n    triggerRect: Pick<DOMRect, 'left' | 'right'>,\n    panelWidth: number,\n): number => {\n    if (align === 'end') {\n        return triggerRect.right - panelWidth;\n    }\n    if (align === 'center') {\n        return (triggerRect.left + triggerRect.right - panelWidth) / 2;\n    }\n    return triggerRect.left;\n};\n\nexport const fullPanelHeight = (panel: HTMLElement): number =>\n    panel.scrollHeight + panel.offsetHeight - panel.clientHeight;\n\nexport const FLOATING_OFFSET_PX = { small: 8, medium: 12, large: 14 } as const;\n\nexport type FloatingOffset = keyof typeof FLOATING_OFFSET_PX;\n\nexport interface FloatingGeometryInput {\n    triggerRect: Pick<DOMRect, 'top' | 'left' | 'right' | 'bottom'>;\n    placement: FloatingPlacement;\n    panelWidth: number;\n    panelHeight: number;\n    gap: number;\n    viewportWidth: number;\n    viewportHeight: number;\n}\n\nexport interface FloatingGeometry {\n    top: number;\n    left: number;\n    maxHeight: number;\n    side: 'top' | 'bottom' | 'left' | 'right';\n}\n\nconst clampToViewport = (value: number, size: number, viewport: number): number =>\n    Math.max(MENU_VIEWPORT_PADDING_PX, Math.min(value, viewport - size - MENU_VIEWPORT_PADDING_PX));\n\nexport const computeFloatingGeometry = ({\n    triggerRect,\n    placement,\n    panelWidth,\n    panelHeight,\n    gap,\n    viewportWidth,\n    viewportHeight,\n}: FloatingGeometryInput): FloatingGeometry => {\n    const [preferred, align] = placement.split('-') as [\n        FloatingGeometry['side'],\n        'start' | 'end' | 'center',\n    ];\n    const pad = MENU_VIEWPORT_PADDING_PX;\n\n    if (preferred === 'top' || preferred === 'bottom') {\n        const roomBelow = viewportHeight - triggerRect.bottom - gap - pad;\n        const roomAbove = triggerRect.top - gap - pad;\n        const wanted = preferred === 'bottom' ? roomBelow : roomAbove;\n        const opposite = preferred === 'bottom' ? roomAbove : roomBelow;\n        const side: FloatingGeometry['side'] =\n            panelHeight > wanted && opposite > wanted\n                ? preferred === 'bottom'\n                    ? 'top'\n                    : 'bottom'\n                : preferred;\n        const belowTop = Math.max(pad, triggerRect.bottom + gap);\n        const aboveBottom = Math.min(viewportHeight - pad, triggerRect.top - gap);\n        const maxHeight = Math.max(\n            0,\n            side === 'bottom' ? viewportHeight - belowTop - pad : aboveBottom - pad,\n        );\n        const height = Math.min(panelHeight, maxHeight);\n        const top = side === 'bottom' ? belowTop : Math.max(pad, aboveBottom - height);\n        const left = clampToViewport(\n            alignedLeft(align, triggerRect, panelWidth),\n            panelWidth,\n            viewportWidth,\n        );\n        return { top, left, maxHeight, side };\n    }\n\n    const roomRight = viewportWidth - triggerRect.right - gap - pad;\n    const roomLeft = triggerRect.left - gap - pad;\n    const wanted = preferred === 'right' ? roomRight : roomLeft;\n    const opposite = preferred === 'right' ? roomLeft : roomRight;\n    const side: FloatingGeometry['side'] =\n        panelWidth > wanted && opposite > wanted\n            ? preferred === 'right'\n                ? 'left'\n                : 'right'\n            : preferred;\n    const left = side === 'right' ? triggerRect.right + gap : triggerRect.left - gap - panelWidth;\n    const levelTop = Math.max(pad, triggerRect.top);\n    const roomBelow = viewportHeight - levelTop - pad;\n    if (align === 'start' && roomBelow >= Math.min(panelHeight, SIDE_PANEL_MIN_HEIGHT_PX)) {\n        return {\n            top: levelTop,\n            left: clampToViewport(left, panelWidth, viewportWidth),\n            maxHeight: roomBelow,\n            side,\n        };\n    }\n    const maxHeight = Math.max(0, viewportHeight - pad * 2);\n    const height = Math.min(panelHeight, maxHeight);\n    const top = clampToViewport(\n        align === 'end' ? triggerRect.bottom - height : triggerRect.top,\n        height,\n        viewportHeight,\n    );\n    return { top, left: clampToViewport(left, panelWidth, viewportWidth), maxHeight, side };\n};\n"],"names":["MENU_VIEWPORT_PADDING_PX","SIDE_PANEL_MIN_HEIGHT_PX","MENU_MIN_WIDTH_PX","MENU_OPTIONS_MIN_WIDTH_PX","MENU_SPECS","MENU_MAX_HEIGHT_PX","computeMenuGeometry","triggerRect","preset","minWidth","alignOverride","contentWidth","menuHeight","viewportWidth","viewportHeight","spec","available","floor","ceiling","natural","width","align","preferredLeft","oppositeLeft","minLeft","maxLeft","fits","candidate","left","roomBelow","roomAbove","openUp","maxHeight","height","measureContentWidth","panel","rows","widest","row","styles","edge","value","chrome","measureMenuGeometry","input","cssWidth","isTriggerOffscreen","rect","rectSignature","alignedLeft","panelWidth","fullPanelHeight","FLOATING_OFFSET_PX","clampToViewport","size","viewport","computeFloatingGeometry","placement","panelHeight","gap","preferred","pad","wanted","opposite","side","belowTop","aboveBottom","top","roomRight","roomLeft","levelTop"],"mappings":"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"}

package/dist/index.d.ts

@@ -179,9 +179,9 @@ export declare const ApiKeysIcon: React.FC<IconProps_5>;
 export declare const AppLogo: default_2.FC<AppLogoProps>;
 
 export declare interface AppLogoProps {
-    /** Connector logo URL. Falls back to a coloured initial tile when missing or broken. */
+    /** Connector logo URL. Falls back to a "no logo available" placeholder when missing or broken. */
     src?: string;
-    /** Connector name — the accessible label, the fallback initial, and the visible text. */
+    /** Connector name — the accessible label and the visible text. */
     name: string;
     /** Renders the name beside the mark. Omit for a bare logo (e.g. inside a dense row). */
     showName?: boolean;
@@ -245,14 +245,19 @@ export declare const AuthenticationIcon: React.FC<IconProps_10>;
  */
 export declare const Avatar: default_2.FC<AvatarProps>;
 
+/** `initial` suits a named entity (a person, a model); `placeholder` says "no logo available". */
+export declare type AvatarFallback = 'initial' | 'placeholder';
+
 export declare interface AvatarProps {
-    /** Image URL (logo/photo). Falls back to the initial of `name` when missing or it fails to load. */
+    /** Image URL (logo/photo). Falls back to `fallback` when missing or it fails to load. */
     src?: string;
     /** Used for the initial fallback and as the image alt / accessible label. */
     name?: string;
     /** Pixel size of the (square) avatar. */
     size?: number;
     shape?: AvatarShape;
+    /** What shows when `src` is missing or fails to load. Defaults to `initial`. */
+    fallback?: AvatarFallback;
     className?: string;
 }
 
@@ -4061,6 +4066,9 @@ export declare interface SelectableCardStatus {
     label: string;
     /** Maps to Tag's palette — `default` (grey) for "Disabled", `warning` (amber) for "Draft". */
     type?: TagType;
+    /** Explains what the status means, shown on hovering the tag and read as part of the card's
+     *  description, since the tag sits inside the control and is never focused on its own. */
+    tooltip?: string;
 }
 
 /** The card's palette: `profile` is green, `library` neutral, `editing` amber for a
@@ -4785,6 +4793,12 @@ export declare interface TagProps {
     pointerType?: 'pointer' | 'default';
     onClick?: () => void;
     onRemove?: (e: default_2.MouseEvent) => void;
+    /** Explains the tag on hover. Takes the place of the truncation tooltip, which only repeats
+     *  the label. */
+    tooltip?: string;
+    /** False when something else already reads `tooltip` to assistive tech, such as a card's
+     *  description, so it is not announced twice. */
+    tooltipDescribesTag?: boolean;
     className?: string;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackone/malachite",
-  "version": "2.51.2",
+  "version": "2.53.0",
   "description": "StackOne's themeable React component library — Shadow DOM isolated, scoped Tailwind, theme-token driven.",
   "license": "MIT",
   "author": "StackOne",