@stackone/malachite 2.124.0 → 2.126.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/COMPONENTS.md +9 -8
- package/dist/components/Card.js +17 -17
- package/dist/components/Card.js.map +1 -1
- package/dist/components/HexagonScale.js +25 -10
- package/dist/components/HexagonScale.js.map +1 -1
- package/dist/components/Input/Input.js +176 -195
- package/dist/components/Input/Input.js.map +1 -1
- package/dist/components/KeyValueStrip.js +57 -41
- package/dist/components/KeyValueStrip.js.map +1 -1
- package/dist/components/PillButton.js +68 -45
- package/dist/components/PillButton.js.map +1 -1
- package/dist/components/ScoreMeter.js +79 -0
- package/dist/components/ScoreMeter.js.map +1 -0
- package/dist/components/Table/Table.js +3 -2
- package/dist/components/Table/Table.js.map +1 -1
- package/dist/components/Timeline.js +88 -77
- package/dist/components/Timeline.js.map +1 -1
- package/dist/components/Typography/Text.js +27 -24
- package/dist/components/Typography/Text.js.map +1 -1
- package/dist/components/overlayBehaviour.js +8 -9
- package/dist/components/overlayBehaviour.js.map +1 -1
- package/dist/index.d.ts +41 -2
- package/dist/index.js +293 -291
- package/dist/index.js.map +1 -1
- package/dist/tailwind.css.js +1 -1
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"overlayBehaviour.js","sources":["../../src/components/overlayBehaviour.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\nimport { containsComposed, getDeepActiveElement } from './activeElement';\nimport { ensureDroppedFocusTracking, focusReturnTarget } from './droppedFocus';\nimport { pushEscapeLayer } from './escapeLayers';\nimport { FOCUS_RING } from './focusRing';\nimport { nextLayerTicket, popupLayerHolding } from './overlayLayers';\nimport { useOwnedByPopover } from './popoverTree';\nimport { OVERLAY_Z_BASE, ensureElevatedOverlayStyles } from './portalOverlay';\nimport { lockBodyScroll } from './scrollLock';\nimport { leaveTopLayer, raiseToTopLayer } from './topLayer';\n\n/** Back/close button chrome, shared so the two overlays cannot drift apart. */\nexport const OVERLAY_ICON_BUTTON_CLASSES = `flex shrink-0 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-[4px] text-[var(--malachite-text-secondary)] hover:text-[var(--malachite-text-primary)] transition-colors ${FOCUS_RING}`;\n\n// `summary`: a disclosure's first one is a native tab stop and its only keyboard control. A loose\n// one reports `tabIndex === -1`, which `isTabStop` drops.\nexport const FOCUSABLE_SELECTOR =\n 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), summary, [tabindex]:not([tabindex=\"-1\"])';\n\n// The flat-tree parent: a slotted element renders under its slot, a shadow root under its host.\nconst flatParent = (element: Element): Element | null =>\n element.assignedSlot ??\n element.parentElement ??\n (element.parentNode instanceof ShadowRoot ? element.parentNode.host : null);\n\n// `children`, not `:scope > summary`: inside a shadow root jsdom's selector engine matches\n// nothing for `:scope`, which silently hid the summary along with the rest.\nconst firstSummaryOf = (details: HTMLDetailsElement): Element | undefined =>\n Array.from(details.children).find((child) => child.tagName === 'SUMMARY');\n\ntype RenderState = { hidden: boolean; invisible: boolean; hidesContent: boolean };\n\n// Reads computed style: call at interaction time only, never from a mount path. Under jsdom,\n// `offsetParent`, `getClientRects()` and `checkVisibility()` report every element invisible.\n// One per Tab press, so an ancestor shared by many controls has its style read once.\nconst createRenderStates = (): ((element: Element) => RenderState) => {\n const states = new Map<Element, RenderState>();\n const stateOf = (element: Element): RenderState => {\n const cached = states.get(element);\n if (cached) {\n return cached;\n }\n const { display, visibility, contentVisibility } = getComputedStyle(element);\n const parent = flatParent(element);\n const parentState = parent ? stateOf(parent) : null;\n // A closed `<details>` hides all but its summary in the UA shadow slot, so the hidden\n // descendants keep `tabIndex === 0` and a normal computed display.\n const closedDisclosure =\n parent instanceof HTMLDetailsElement &&\n !parent.open &&\n firstSummaryOf(parent) !== element;\n const state = {\n hidden:\n element.hasAttribute('inert') ||\n display === 'none' ||\n closedDisclosure ||\n Boolean(parentState && (parentState.hidden || parentState.hidesContent)),\n invisible: visibility === 'hidden' || visibility === 'collapse',\n hidesContent: contentVisibility === 'hidden',\n };\n states.set(element, state);\n return state;\n };\n return stateOf;\n};\n\nconst isTabStop = (element: HTMLElement, stateOf: (element: Element) => RenderState): boolean => {\n if (element.tabIndex < 0 || element.matches(':disabled')) {\n return false;\n }\n const { hidden, invisible } = stateOf(element);\n\n return !hidden && !invisible;\n};\n\nconst isGroupedRadio = (element: Element): element is HTMLInputElement =>\n element instanceof HTMLInputElement && element.type === 'radio' && element.name !== '';\n\n// Only a group's checked radio, or its first with none checked, is a tab stop, yet every member\n// reports `tabIndex === 0`.\nconst skipsWithinRadioGroup = (element: HTMLElement, reachable: HTMLElement[]): boolean => {\n if (!isGroupedRadio(element)) {\n return false;\n }\n const group = reachable.filter(\n (candidate): candidate is HTMLInputElement =>\n isGroupedRadio(candidate) &&\n candidate.name === element.name &&\n candidate.form === element.form,\n );\n\n return (group.find((radio) => radio.checked) ?? group[0]) !== element;\n};\n\nconst inTabOrder = (entries: Element[], tabIndexOf: (element: Element) => number): Element[] =>\n entries\n .map((element, index) => ({ element, index, tabIndex: tabIndexOf(element) }))\n .sort((left, right) => {\n if (left.tabIndex !== right.tabIndex) {\n if (left.tabIndex === 0) {\n return 1;\n }\n if (right.tabIndex === 0) {\n return -1;\n }\n\n return left.tabIndex - right.tabIndex;\n }\n\n return left.index - right.index;\n })\n .map(({ element }) => element);\n\n// Only a slot inside a shadow root projects assigned content; elsewhere it renders its children.\nconst isShadowSlot = (element: Element): element is HTMLSlotElement =>\n element instanceof HTMLSlotElement && element.getRootNode() instanceof ShadowRoot;\n\n// One focus navigation scope in tree order. A host's light children render only through its\n// slots, and hosts and slots each own a scope, so the walk descends into neither.\nconst scopeMembers = (elements: Iterable<Element>, into: Element[] = []): Element[] => {\n for (const element of elements) {\n into.push(element);\n if (!element.shadowRoot && !isShadowSlot(element)) {\n scopeMembers(element.children, into);\n }\n }\n return into;\n};\n\n// Ordered per scope, as browsers do: positive tabindex orders within its own scope, and a nested\n// scope takes its owner's place, an owner that is no stop itself ordering as tabindex 0.\nconst stopsInScope = (\n members: Element[],\n stateOf: (element: Element) => RenderState,\n): HTMLElement[] => {\n const reachable = members.filter(\n (element): element is HTMLElement =>\n element instanceof HTMLElement &&\n element.matches(FOCUSABLE_SELECTOR) &&\n isTabStop(element, stateOf),\n );\n const stops = new Set<Element>(\n reachable.filter((element) => !skipsWithinRadioGroup(element, reachable)),\n );\n const entries = members.filter(\n (element) => stops.has(element) || element.shadowRoot || isShadowSlot(element),\n );\n\n return inTabOrder(entries, (element) =>\n stops.has(element) ? (element as HTMLElement).tabIndex : 0,\n ).flatMap((element) => {\n if (isShadowSlot(element)) {\n return stopsInScope(scopeMembers(element.assignedElements({ flatten: true })), stateOf);\n }\n const root = element.shadowRoot;\n // A host given a negative tabindex keeps its whole shadow tree out of the order; an\n // unparsable value counts as absent, as it does for any element.\n if (root && Number.parseInt(element.getAttribute('tabindex') ?? '', 10) < 0) {\n return [];\n }\n const own = stops.has(element) && !root?.delegatesFocus ? [element as HTMLElement] : [];\n\n return root ? [...own, ...stopsInScope(scopeMembers(root.children), stateOf)] : own;\n });\n};\n\nconst tabStopsIn = (root: ParentNode): HTMLElement[] =>\n stopsInScope(scopeMembers(root.children), createRenderStates());\n\n// `compareDocumentPosition` calls nodes in different shadow trees disconnected, so lift both\n// into their deepest shared tree first; a host precedes its own shadow content.\nconst composedPosition = (from: Node, to: Node): number => {\n const ancestry = (node: Node): Node[] => {\n const chain = [node];\n for (\n let root = node.getRootNode();\n root instanceof ShadowRoot;\n root = root.host.getRootNode()\n ) {\n chain.push(root.host);\n }\n return chain;\n };\n const fromChain = ancestry(from);\n const toChain = ancestry(to);\n for (const fromStep of fromChain) {\n const toStep = toChain.find((step) => step.getRootNode() === fromStep.getRootNode());\n if (!toStep) {\n continue;\n }\n if (fromStep !== toStep) {\n return fromStep.compareDocumentPosition(toStep);\n }\n\n return fromStep === from\n ? Node.DOCUMENT_POSITION_FOLLOWING\n : Node.DOCUMENT_POSITION_PRECEDING;\n }\n\n return Node.DOCUMENT_POSITION_DISCONNECTED;\n};\n\n/** Where Tab would land first, for initial focus: the raw selector also matches hidden controls. */\nexport const firstTabStopIn = (root: ParentNode): HTMLElement | null => tabStopsIn(root)[0] ?? null;\n\ntype PanelSource = () => HTMLElement | null;\n\n// LIFO like escapeLayers: with a listener per overlay the first-registered one wins, which\n// sent Tab from a dialog into the panel behind it.\nconst trapLayers: PanelSource[] = [];\n// Elevation belongs to the stack: a Modal left in the base band opens behind the panel that\n// elevated it.\nconst elevatedLayers = new Set<PanelSource>();\n// The shadow host per layer, so promotion can replay in stack order.\nconst hostSources = new Map<PanelSource, () => HTMLElement | null>();\nconst trapTickets = new Map<PanelSource, number>();\nconst stackListeners = new Set<() => void>();\nconst NO_SUBSCRIPTION = () => {\n // Nothing to tear down: a closed overlay never subscribed.\n};\n\n// Top-layer paint order is entry order, so replay the whole stack bottom-up rather than letting\n// each overlay promote itself: those effects run in React tree order, which need not match.\nlet promoted: HTMLElement[] = [];\nconst aboveStack = new Set<HTMLElement>();\n\nconst syncTopLayer = (): void => {\n const wanted = elevatedLayers.size\n ? trapLayers\n .map((layer) => hostSources.get(layer)?.())\n .filter((host): host is HTMLElement => Boolean(host))\n : [];\n // Compared, not reapplied: this runs on every commit, because a host can appear a commit\n // after the layer that owns it, and re-entering the top layer unprompted costs a recalc.\n if (\n wanted.length === promoted.length &&\n wanted.every((host, index) => host === promoted[index])\n ) {\n return;\n }\n const stillWanted = new Set(wanted);\n for (const host of promoted) {\n if (!stillWanted.has(host)) {\n leaveTopLayer(host);\n }\n }\n for (const host of wanted) {\n raiseToTopLayer(host);\n }\n promoted = wanted;\n for (const host of aboveStack) {\n raiseToTopLayer(host);\n }\n};\n\n/** Keeps a promoted host above the elevated stack each time the stack is replayed. */\nexport const keepAboveOverlayStack = (host: HTMLElement): (() => void) => {\n aboveStack.add(host);\n return () => {\n aboveStack.delete(host);\n };\n};\n\nconst notifyStackChanged = (): void => {\n for (const listener of stackListeners) {\n listener();\n }\n};\n\nconst subscribeToStack = (listener: () => void): (() => void) => {\n stackListeners.add(listener);\n return () => {\n stackListeners.delete(listener);\n };\n};\n\nconst wrapTab = (\n event: KeyboardEvent,\n active: HTMLElement | null,\n within: Node,\n stops: HTMLElement[],\n): void => {\n const first = stops[0];\n const last = stops[stops.length - 1];\n const inside = containsComposed(within, active);\n // A mouse-only control, such as a search Dropdown's caret, is no edge: Tab resumes from its\n // place in the DOM and would leave the overlay where no real stop follows it.\n if (active && inside && active !== within && !stops.includes(active)) {\n const wanted = event.shiftKey\n ? Node.DOCUMENT_POSITION_PRECEDING\n : Node.DOCUMENT_POSITION_FOLLOWING;\n if (!stops.some((stop) => composedPosition(active, stop) & wanted)) {\n event.preventDefault();\n (event.shiftKey ? last : first).focus();\n }\n\n return;\n }\n if (event.shiftKey) {\n if (!inside || active === first || active === within) {\n event.preventDefault();\n last.focus();\n }\n } else if (!inside || active === last || active === within) {\n event.preventDefault();\n first.focus();\n }\n};\n\nconst handleTabKeyDown = (event: KeyboardEvent): void => {\n if (event.key !== 'Tab' || event.defaultPrevented) {\n return;\n }\n // Walk down rather than bail: React detaches refs before flushing the cleanup that pops\n // the layer, so the topmost can be registered-but-null and Tab would escape entirely.\n let panel: HTMLElement | null = null;\n let trapTicket = 0;\n for (let index = trapLayers.length - 1; index >= 0 && !panel; index -= 1) {\n panel = trapLayers[index]();\n if (panel) {\n trapTicket = trapTickets.get(trapLayers[index]) ?? 0;\n }\n }\n if (!panel) {\n return;\n }\n const active = getDeepActiveElement();\n const layer = active ? popupLayerHolding(active) : null;\n if (active && layer && layer.ticket > trapTicket) {\n const root = layer.popup.shadowRoot ?? layer.popup;\n const popupStops = tabStopsIn(root);\n if (popupStops.length === 0) {\n event.preventDefault();\n return;\n }\n wrapTab(event, active, root, popupStops);\n return;\n }\n const focusables = tabStopsIn(panel);\n if (focusables.length === 0) {\n event.preventDefault();\n panel.focus();\n return;\n }\n wrapTab(event, active, panel, focusables);\n};\n\n// On `document` so it also catches focus that escaped behind the overlay.\nconst pushFocusTrapLayer = (getPanel: PanelSource, getHost: () => HTMLElement | null) => {\n if (trapLayers.length === 0) {\n document.addEventListener('keydown', handleTabKeyDown);\n }\n trapLayers.push(getPanel);\n hostSources.set(getPanel, getHost);\n trapTickets.set(getPanel, nextLayerTicket());\n notifyStackChanged();\n return () => {\n const index = trapLayers.lastIndexOf(getPanel);\n if (index !== -1) {\n trapLayers.splice(index, 1);\n }\n elevatedLayers.delete(getPanel);\n hostSources.delete(getPanel);\n trapTickets.delete(getPanel);\n const host = getHost();\n if (host) {\n leaveTopLayer(host);\n }\n if (trapLayers.length === 0) {\n document.removeEventListener('keydown', handleTabKeyDown);\n }\n notifyStackChanged();\n };\n};\n\n// A layer unmounting in the same commit has already left the DOM when passive cleanups run.\nconst coveringLayer = (source: PanelSource): PanelSource | undefined => {\n const index = trapLayers.lastIndexOf(source);\n return index === -1\n ? undefined\n : trapLayers.slice(index + 1).find((layer) => layer()?.isConnected === true);\n};\n\nconst inheritedRestoreTargets = new Map<PanelSource, HTMLElement>();\n\n/**\n * Whether a SidePanel, Modal or CommandPalette is open anywhere, for host chrome that has to move out of the way.\n * Overlays portal, so the only other signal is this module's markers, which a host cannot read\n * without coupling to an internal. Dropdowns and tooltips do not count: they trap no focus.\n */\nexport const useHasOpenOverlay = (): boolean =>\n useSyncExternalStore(\n subscribeToStack,\n () => trapLayers.length > 0,\n () => false,\n );\n\nconst takeInitialFocus = (panel: HTMLElement, initialFocus: 'panel' | 'content'): void => {\n if (initialFocus === 'content') {\n const active = getDeepActiveElement();\n if (containsComposed(panel, active)) {\n return;\n }\n (firstTabStopIn(panel) ?? panel).focus();\n return;\n }\n panel.focus();\n};\n\n/**\n * The modal-overlay behaviour shared by SidePanel, Modal and CommandPalette: ESC and the Tab focus trap\n * (topmost overlay only, so these may be stacked), background scroll lock, and focus moved\n * into the overlay on open then restored to the trigger on close.\n *\n * Returns the ref callback the dialog element must take, whether this overlay is the topmost\n * one — only that one may claim `aria-modal`, or a screen reader can still browse the overlay\n * underneath — the z-index its host must carry, which keeps paint order with the focus stack,\n * and whether it is elevated. Presentation otherwise stays with the calling component.\n */\nexport const useOverlayBehaviour = ({\n open,\n onClose,\n elevated = false,\n hostRef,\n initialFocus = 'panel',\n onYield,\n}: {\n open: boolean;\n onClose: () => void;\n elevated?: boolean;\n /** The shadow host, which the stack promotes into the top layer while elevated. */\n hostRef?: { current: HTMLElement | null };\n /** Where focus lands on open: the panel itself, or the content's own first control. */\n initialFocus?: 'panel' | 'content';\n /** Called instead of opening while another overlay is open; the caller must then render closed. */\n onYield?: () => void;\n}): {\n ref: (node: HTMLElement | null) => void;\n isTopmost: boolean;\n zIndex: number | undefined;\n elevated: boolean;\n} => {\n const panelRef = useRef<HTMLElement | null>(null);\n // One identity for the life of the instance: elevation registers it in the layout phase,\n // before the effect below pushes it onto the stack.\n const source = useRef<PanelSource>(() => panelRef.current).current;\n useOwnedByPopover(\n useCallback(() => hostRef?.current ?? panelRef.current, [hostRef]),\n open,\n );\n const previousFocusRef = useRef<HTMLElement | null>(null);\n const layerRef = useRef<PanelSource | null>(null);\n const initialFocusRef = useRef(initialFocus);\n\n // Ref so the ESC layer registers once per open, not on every inline-onClose change.\n const onCloseRef = useRef(onClose);\n const onYieldRef = useRef(onYield);\n useEffect(() => {\n onCloseRef.current = onClose;\n onYieldRef.current = onYield;\n }, [onClose, onYield]);\n\n // Before the trap effect, so the trigger is recorded before focus moves in.\n useEffect(() => {\n ensureDroppedFocusTracking();\n if (!open) {\n return;\n }\n previousFocusRef.current = focusReturnTarget();\n return () => {\n const recorded = previousFocusRef.current;\n previousFocusRef.current = null;\n const inherited = inheritedRestoreTargets.get(source);\n inheritedRestoreTargets.delete(source);\n if (layerRef.current === null) {\n return;\n }\n const target = recorded?.isConnected ? recorded : inherited;\n // Runs before the trap cleanup below, so a registered layer is still on the stack.\n const above = coveringLayer(source);\n if (above && target) {\n inheritedRestoreTargets.set(above, target);\n }\n if (!above && target?.isConnected) {\n target.focus();\n }\n };\n }, [open, source]);\n\n useEffect(() => {\n if (!open) {\n return;\n }\n // Checked here, not at render: a dialog opening in the same commit registers only in its effects.\n if (onYieldRef.current && trapLayers.length > 0) {\n onYieldRef.current();\n return;\n }\n layerRef.current = source;\n const popEscapeLayer = pushEscapeLayer(() => onCloseRef.current());\n const releaseScrollLock = lockBodyScroll();\n const popFocusTrapLayer = pushFocusTrapLayer(source, () => hostRef?.current ?? null);\n // Reopening inside the exit transition reuses the same node, so the ref callback\n // never fires again and nothing would take focus.\n if (panelRef.current) {\n takeInitialFocus(panelRef.current, initialFocusRef.current);\n }\n return () => {\n layerRef.current = null;\n popFocusTrapLayer();\n popEscapeLayer();\n releaseScrollLock();\n };\n }, [open, hostRef, source]);\n\n // Its own effect: re-pushing the trap layer to change elevation would move this overlay to\n // the top of the stack, handing it the Escape and Tab that belong to a dialog above it.\n // Layout, and declared above the sync below, so that sync sees it in the same commit.\n useLayoutEffect(() => {\n if (!open || !elevated) {\n return;\n }\n elevatedLayers.add(source);\n notifyStackChanged();\n return () => {\n elevatedLayers.delete(source);\n notifyStackChanged();\n };\n }, [open, elevated, source]);\n\n // Only an open overlay subscribes: a mounted-but-idle one must carry no at-rest cost,\n // and its snapshot is a constant `false` regardless of what the stack does.\n const subscribe = useCallback(\n (onStackChange: () => void) => (open ? subscribeToStack(onStackChange) : NO_SUBSCRIPTION),\n [open],\n );\n\n const isTopmost = useSyncExternalStore(\n subscribe,\n // Gated on `open` so an overlay fading out stops claiming modal. Before it registers\n // it is the one about to go on top, or aria-modal would drop for a frame on open.\n () =>\n open &&\n (layerRef.current === null || trapLayers[trapLayers.length - 1] === layerRef.current),\n () => true,\n );\n\n // Its own request counts before the stack has it: the layer is not pushed until effects run.\n const stackElevated = useSyncExternalStore(\n subscribe,\n () => open && (elevated || elevatedLayers.size > 0),\n () => false,\n );\n\n // Overlay hosts share one z-index band, so paint order would otherwise fall out of body\n // order: an overlay reopened over a newer one takes the keyboard while painting under it.\n const zIndex = useSyncExternalStore(\n subscribe,\n () => {\n const layer = layerRef.current;\n return OVERLAY_Z_BASE + (open && layer ? Math.max(0, trapLayers.indexOf(layer)) : 0);\n },\n () => OVERLAY_Z_BASE,\n );\n\n // Layout, not passive: the rule has to exist before the first paint the attribute applies to.\n useLayoutEffect(() => {\n if (stackElevated) {\n ensureElevatedOverlayStyles();\n }\n }, [stackElevated]);\n\n // No deps: the host mounts a commit after the layer that owns it, so there is no stack\n // change left to key this on. `syncTopLayer` compares before it touches anything.\n useLayoutEffect(() => {\n syncTopLayer();\n });\n\n const ref = useCallback((node: HTMLElement | null) => {\n panelRef.current = node;\n // A panel portaled in after its layer registered takes focus here; any other, from the effect.\n if (node && layerRef.current !== null) {\n takeInitialFocus(node, initialFocusRef.current);\n }\n }, []);\n\n return { ref, isTopmost, zIndex: stackElevated ? undefined : zIndex, elevated: stackElevated };\n};\n\nexport default useOverlayBehaviour;\n"],"names":["OVERLAY_ICON_BUTTON_CLASSES","FOCUS_RING","FOCUSABLE_SELECTOR","flatParent","element","firstSummaryOf","details","child","createRenderStates","states","stateOf","cached","display","visibility","contentVisibility","parent","parentState","closedDisclosure","state","isTabStop","hidden","invisible","isGroupedRadio","skipsWithinRadioGroup","reachable","group","candidate","radio","inTabOrder","entries","tabIndexOf","index","left","right","isShadowSlot","scopeMembers","elements","into","stopsInScope","members","stops","root","own","tabStopsIn","composedPosition","from","to","ancestry","node","chain","fromChain","toChain","fromStep","toStep","step","firstTabStopIn","trapLayers","elevatedLayers","hostSources","trapTickets","stackListeners","NO_SUBSCRIPTION","promoted","aboveStack","syncTopLayer","wanted","layer","_a","host","stillWanted","leaveTopLayer","raiseToTopLayer","keepAboveOverlayStack","notifyStackChanged","listener","subscribeToStack","wrapTab","event","active","within","first","last","inside","containsComposed","stop","handleTabKeyDown","panel","trapTicket","getDeepActiveElement","popupLayerHolding","popupStops","focusables","pushFocusTrapLayer","getPanel","getHost","nextLayerTicket","coveringLayer","source","inheritedRestoreTargets","useHasOpenOverlay","useSyncExternalStore","takeInitialFocus","initialFocus","useOverlayBehaviour","open","onClose","elevated","hostRef","onYield","panelRef","useRef","useOwnedByPopover","useCallback","previousFocusRef","layerRef","initialFocusRef","onCloseRef","onYieldRef","useEffect","ensureDroppedFocusTracking","focusReturnTarget","recorded","inherited","target","above","popEscapeLayer","pushEscapeLayer","releaseScrollLock","lockBodyScroll","popFocusTrapLayer","useLayoutEffect","subscribe","onStackChange","isTopmost","stackElevated","zIndex","OVERLAY_Z_BASE","ensureElevatedOverlayStyles"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"overlayBehaviour.js","sources":["../../src/components/overlayBehaviour.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';\nimport { containsComposed, getDeepActiveElement } from './activeElement';\nimport { ensureDroppedFocusTracking, focusReturnTarget } from './droppedFocus';\nimport { pushEscapeLayer } from './escapeLayers';\nimport { FOCUS_RING } from './focusRing';\nimport { nextLayerTicket, popupLayerHolding } from './overlayLayers';\nimport { useOwnedByPopover } from './popoverTree';\nimport { OVERLAY_Z_BASE, ensureElevatedOverlayStyles } from './portalOverlay';\nimport { lockBodyScroll } from './scrollLock';\nimport { leaveTopLayer, raiseToTopLayer } from './topLayer';\n\n/** Back/close button chrome, shared so the two overlays cannot drift apart. */\nexport const OVERLAY_ICON_BUTTON_CLASSES = `flex shrink-0 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-[4px] text-[var(--malachite-text-secondary)] hover:text-[var(--malachite-text-primary)] transition-colors ${FOCUS_RING}`;\n\n// `summary`: a disclosure's first one is a native tab stop and its only keyboard control. A loose\n// one reports `tabIndex === -1`, which `isTabStop` drops.\nexport const FOCUSABLE_SELECTOR =\n 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), summary, [tabindex]:not([tabindex=\"-1\"])';\n\n// The flat-tree parent: a slotted element renders under its slot, a shadow root under its host.\nconst flatParent = (element: Element): Element | null =>\n element.assignedSlot ??\n element.parentElement ??\n (element.parentNode instanceof ShadowRoot ? element.parentNode.host : null);\n\n// `children`, not `:scope > summary`: inside a shadow root jsdom's selector engine matches\n// nothing for `:scope`, which silently hid the summary along with the rest.\nconst firstSummaryOf = (details: HTMLDetailsElement): Element | undefined =>\n Array.from(details.children).find((child) => child.tagName === 'SUMMARY');\n\ntype RenderState = { hidden: boolean; invisible: boolean; hidesContent: boolean };\n\n// Reads computed style: call at interaction time only, never from a mount path. Under jsdom,\n// `offsetParent`, `getClientRects()` and `checkVisibility()` report every element invisible.\n// One per Tab press, so an ancestor shared by many controls has its style read once.\nconst createRenderStates = (): ((element: Element) => RenderState) => {\n const states = new Map<Element, RenderState>();\n const stateOf = (element: Element): RenderState => {\n const cached = states.get(element);\n if (cached) {\n return cached;\n }\n const { display, visibility, contentVisibility } = getComputedStyle(element);\n const parent = flatParent(element);\n const parentState = parent ? stateOf(parent) : null;\n // A closed `<details>` hides all but its summary in the UA shadow slot, so the hidden\n // descendants keep `tabIndex === 0` and a normal computed display.\n const closedDisclosure =\n parent instanceof HTMLDetailsElement &&\n !parent.open &&\n firstSummaryOf(parent) !== element;\n const state = {\n hidden:\n element.hasAttribute('inert') ||\n display === 'none' ||\n closedDisclosure ||\n Boolean(parentState && (parentState.hidden || parentState.hidesContent)),\n invisible: visibility === 'hidden' || visibility === 'collapse',\n hidesContent: contentVisibility === 'hidden',\n };\n states.set(element, state);\n return state;\n };\n return stateOf;\n};\n\nconst isTabStop = (element: HTMLElement, stateOf: (element: Element) => RenderState): boolean => {\n if (element.tabIndex < 0 || element.matches(':disabled')) {\n return false;\n }\n const { hidden, invisible } = stateOf(element);\n\n return !hidden && !invisible;\n};\n\nconst isGroupedRadio = (element: Element): element is HTMLInputElement =>\n element instanceof HTMLInputElement && element.type === 'radio' && element.name !== '';\n\n// Only a group's checked radio, or its first with none checked, is a tab stop, yet every member\n// reports `tabIndex === 0`.\nconst skipsWithinRadioGroup = (element: HTMLElement, reachable: HTMLElement[]): boolean => {\n if (!isGroupedRadio(element)) {\n return false;\n }\n const group = reachable.filter(\n (candidate): candidate is HTMLInputElement =>\n isGroupedRadio(candidate) &&\n candidate.name === element.name &&\n candidate.form === element.form,\n );\n\n return (group.find((radio) => radio.checked) ?? group[0]) !== element;\n};\n\nconst inTabOrder = (entries: Element[], tabIndexOf: (element: Element) => number): Element[] =>\n entries\n .map((element, index) => ({ element, index, tabIndex: tabIndexOf(element) }))\n .sort((left, right) => {\n if (left.tabIndex !== right.tabIndex) {\n if (left.tabIndex === 0) {\n return 1;\n }\n if (right.tabIndex === 0) {\n return -1;\n }\n\n return left.tabIndex - right.tabIndex;\n }\n\n return left.index - right.index;\n })\n .map(({ element }) => element);\n\n// Only a slot inside a shadow root projects assigned content; elsewhere it renders its children.\nconst isShadowSlot = (element: Element): element is HTMLSlotElement =>\n element instanceof HTMLSlotElement && element.getRootNode() instanceof ShadowRoot;\n\n// One focus navigation scope in tree order. A host's light children render only through its\n// slots, and hosts and slots each own a scope, so the walk descends into neither.\nconst scopeMembers = (elements: Iterable<Element>, into: Element[] = []): Element[] => {\n for (const element of elements) {\n into.push(element);\n if (!element.shadowRoot && !isShadowSlot(element)) {\n scopeMembers(element.children, into);\n }\n }\n return into;\n};\n\n// Ordered per scope, as browsers do: positive tabindex orders within its own scope, and a nested\n// scope takes its owner's place, an owner that is no stop itself ordering as tabindex 0.\nconst stopsInScope = (\n members: Element[],\n stateOf: (element: Element) => RenderState,\n): HTMLElement[] => {\n const reachable = members.filter(\n (element): element is HTMLElement =>\n element instanceof HTMLElement &&\n element.matches(FOCUSABLE_SELECTOR) &&\n isTabStop(element, stateOf),\n );\n const stops = new Set<Element>(\n reachable.filter((element) => !skipsWithinRadioGroup(element, reachable)),\n );\n const entries = members.filter(\n (element) => stops.has(element) || element.shadowRoot || isShadowSlot(element),\n );\n\n return inTabOrder(entries, (element) =>\n stops.has(element) ? (element as HTMLElement).tabIndex : 0,\n ).flatMap((element) => {\n if (isShadowSlot(element)) {\n return stopsInScope(scopeMembers(element.assignedElements({ flatten: true })), stateOf);\n }\n const root = element.shadowRoot;\n // A host given a negative tabindex keeps its whole shadow tree out of the order; an\n // unparsable value counts as absent, as it does for any element.\n if (root && Number.parseInt(element.getAttribute('tabindex') ?? '', 10) < 0) {\n return [];\n }\n const own = stops.has(element) && !root?.delegatesFocus ? [element as HTMLElement] : [];\n\n return root ? [...own, ...stopsInScope(scopeMembers(root.children), stateOf)] : own;\n });\n};\n\nconst tabStopsIn = (root: ParentNode): HTMLElement[] =>\n stopsInScope(scopeMembers(root.children), createRenderStates());\n\n// `compareDocumentPosition` calls nodes in different shadow trees disconnected, so lift both\n// into their deepest shared tree first; a host precedes its own shadow content.\nconst composedPosition = (from: Node, to: Node): number => {\n const ancestry = (node: Node): Node[] => {\n const chain = [node];\n for (\n let root = node.getRootNode();\n root instanceof ShadowRoot;\n root = root.host.getRootNode()\n ) {\n chain.push(root.host);\n }\n return chain;\n };\n const fromChain = ancestry(from);\n const toChain = ancestry(to);\n for (const fromStep of fromChain) {\n const toStep = toChain.find((step) => step.getRootNode() === fromStep.getRootNode());\n if (!toStep) {\n continue;\n }\n if (fromStep !== toStep) {\n return fromStep.compareDocumentPosition(toStep);\n }\n\n return fromStep === from\n ? Node.DOCUMENT_POSITION_FOLLOWING\n : Node.DOCUMENT_POSITION_PRECEDING;\n }\n\n return Node.DOCUMENT_POSITION_DISCONNECTED;\n};\n\n/** Where Tab would land first, for initial focus: the raw selector also matches hidden controls. */\nexport const firstTabStopIn = (root: ParentNode): HTMLElement | null => tabStopsIn(root)[0] ?? null;\n\ntype PanelSource = () => HTMLElement | null;\n\n// LIFO like escapeLayers: with a listener per overlay the first-registered one wins, which\n// sent Tab from a dialog into the panel behind it.\nconst trapLayers: PanelSource[] = [];\n// Elevation belongs to the stack: a Modal left in the base band opens behind the panel that\n// elevated it.\nconst elevatedLayers = new Set<PanelSource>();\n// The shadow host per layer, so promotion can replay in stack order.\nconst hostSources = new Map<PanelSource, () => HTMLElement | null>();\nconst trapTickets = new Map<PanelSource, number>();\nconst stackListeners = new Set<() => void>();\nconst NO_SUBSCRIPTION = () => {\n // Nothing to tear down: a closed overlay never subscribed.\n};\n\n// Top-layer paint order is entry order, so replay the whole stack bottom-up rather than letting\n// each overlay promote itself: those effects run in React tree order, which need not match.\nlet promoted: HTMLElement[] = [];\nconst aboveStack = new Set<HTMLElement>();\n\nconst syncTopLayer = (): void => {\n const wanted = elevatedLayers.size\n ? trapLayers\n .map((layer) => hostSources.get(layer)?.())\n .filter((host): host is HTMLElement => Boolean(host))\n : [];\n // Compared, not reapplied: this runs on every commit, because a host can appear a commit\n // after the layer that owns it, and re-entering the top layer unprompted costs a recalc.\n if (\n wanted.length === promoted.length &&\n wanted.every((host, index) => host === promoted[index])\n ) {\n return;\n }\n const stillWanted = new Set(wanted);\n for (const host of promoted) {\n if (!stillWanted.has(host)) {\n leaveTopLayer(host);\n }\n }\n for (const host of wanted) {\n raiseToTopLayer(host);\n }\n promoted = wanted;\n for (const host of aboveStack) {\n raiseToTopLayer(host);\n }\n};\n\n/** Keeps a promoted host above the elevated stack each time the stack is replayed. */\nexport const keepAboveOverlayStack = (host: HTMLElement): (() => void) => {\n aboveStack.add(host);\n return () => {\n aboveStack.delete(host);\n };\n};\n\nconst notifyStackChanged = (): void => {\n for (const listener of stackListeners) {\n listener();\n }\n};\n\nconst subscribeToStack = (listener: () => void): (() => void) => {\n stackListeners.add(listener);\n return () => {\n stackListeners.delete(listener);\n };\n};\n\nconst wrapTab = (\n event: KeyboardEvent,\n active: HTMLElement | null,\n within: Node,\n stops: HTMLElement[],\n): void => {\n const first = stops[0];\n const last = stops[stops.length - 1];\n const inside = containsComposed(within, active);\n // A mouse-only control, such as a search Dropdown's caret, is no edge: Tab resumes from its\n // place in the DOM and would leave the overlay where no real stop follows it.\n if (active && inside && active !== within && !stops.includes(active)) {\n const wanted = event.shiftKey\n ? Node.DOCUMENT_POSITION_PRECEDING\n : Node.DOCUMENT_POSITION_FOLLOWING;\n if (!stops.some((stop) => composedPosition(active, stop) & wanted)) {\n event.preventDefault();\n (event.shiftKey ? last : first).focus();\n }\n\n return;\n }\n if (event.shiftKey) {\n if (!inside || active === first || active === within) {\n event.preventDefault();\n last.focus();\n }\n } else if (!inside || active === last || active === within) {\n event.preventDefault();\n first.focus();\n }\n};\n\nconst handleTabKeyDown = (event: KeyboardEvent): void => {\n if (event.key !== 'Tab' || event.defaultPrevented) {\n return;\n }\n // Walk down rather than bail: React detaches refs before flushing the cleanup that pops\n // the layer, so the topmost can be registered-but-null and Tab would escape entirely.\n let panel: HTMLElement | null = null;\n let trapTicket = 0;\n for (let index = trapLayers.length - 1; index >= 0 && !panel; index -= 1) {\n panel = trapLayers[index]();\n if (panel) {\n trapTicket = trapTickets.get(trapLayers[index]) ?? 0;\n }\n }\n if (!panel) {\n return;\n }\n const active = getDeepActiveElement();\n const layer = active ? popupLayerHolding(active) : null;\n if (active && layer && layer.ticket > trapTicket) {\n const root = layer.popup.shadowRoot ?? layer.popup;\n const popupStops = tabStopsIn(root);\n if (popupStops.length === 0) {\n event.preventDefault();\n return;\n }\n wrapTab(event, active, root, popupStops);\n return;\n }\n const focusables = tabStopsIn(panel);\n if (focusables.length === 0) {\n event.preventDefault();\n panel.focus();\n return;\n }\n wrapTab(event, active, panel, focusables);\n};\n\n// On `document` so it also catches focus that escaped behind the overlay.\nconst pushFocusTrapLayer = (getPanel: PanelSource, getHost: () => HTMLElement | null) => {\n if (trapLayers.length === 0) {\n document.addEventListener('keydown', handleTabKeyDown);\n }\n trapLayers.push(getPanel);\n hostSources.set(getPanel, getHost);\n trapTickets.set(getPanel, nextLayerTicket());\n notifyStackChanged();\n return () => {\n const index = trapLayers.lastIndexOf(getPanel);\n if (index !== -1) {\n trapLayers.splice(index, 1);\n }\n elevatedLayers.delete(getPanel);\n hostSources.delete(getPanel);\n trapTickets.delete(getPanel);\n const host = getHost();\n if (host) {\n leaveTopLayer(host);\n }\n if (trapLayers.length === 0) {\n document.removeEventListener('keydown', handleTabKeyDown);\n }\n notifyStackChanged();\n };\n};\n\n// A layer unmounting in the same commit has already left the DOM when passive cleanups run.\nconst coveringLayer = (source: PanelSource): PanelSource | undefined => {\n const index = trapLayers.lastIndexOf(source);\n return index === -1\n ? undefined\n : trapLayers.slice(index + 1).find((layer) => layer()?.isConnected === true);\n};\n\nconst inheritedRestoreTargets = new Map<PanelSource, HTMLElement>();\n\n/**\n * Whether a SidePanel, Modal or CommandPalette is open anywhere, for host chrome that has to move out of the way.\n * Overlays portal, so the only other signal is this module's markers, which a host cannot read\n * without coupling to an internal. Dropdowns and tooltips do not count: they trap no focus.\n */\nexport const useHasOpenOverlay = (): boolean =>\n useSyncExternalStore(\n subscribeToStack,\n () => trapLayers.length > 0,\n () => false,\n );\n\nconst takeInitialFocus = (panel: HTMLElement, initialFocus: 'panel' | 'content'): void => {\n if (containsComposed(panel, getDeepActiveElement())) {\n return;\n }\n if (initialFocus === 'content') {\n (firstTabStopIn(panel) ?? panel).focus();\n return;\n }\n panel.focus();\n};\n\n/**\n * The modal-overlay behaviour shared by SidePanel, Modal and CommandPalette: ESC and the Tab focus trap\n * (topmost overlay only, so these may be stacked), background scroll lock, and focus moved\n * into the overlay on open then restored to the trigger on close.\n *\n * Returns the ref callback the dialog element must take, whether this overlay is the topmost\n * one — only that one may claim `aria-modal`, or a screen reader can still browse the overlay\n * underneath — the z-index its host must carry, which keeps paint order with the focus stack,\n * and whether it is elevated. Presentation otherwise stays with the calling component.\n */\nexport const useOverlayBehaviour = ({\n open,\n onClose,\n elevated = false,\n hostRef,\n initialFocus = 'panel',\n onYield,\n}: {\n open: boolean;\n onClose: () => void;\n elevated?: boolean;\n /** The shadow host, which the stack promotes into the top layer while elevated. */\n hostRef?: { current: HTMLElement | null };\n /** Where focus lands on open: the panel itself, or the content's own first control. */\n initialFocus?: 'panel' | 'content';\n /** Called instead of opening while another overlay is open; the caller must then render closed. */\n onYield?: () => void;\n}): {\n ref: (node: HTMLElement | null) => void;\n isTopmost: boolean;\n zIndex: number | undefined;\n elevated: boolean;\n} => {\n const panelRef = useRef<HTMLElement | null>(null);\n // One identity for the life of the instance: elevation registers it in the layout phase,\n // before the effect below pushes it onto the stack.\n const source = useRef<PanelSource>(() => panelRef.current).current;\n useOwnedByPopover(\n useCallback(() => hostRef?.current ?? panelRef.current, [hostRef]),\n open,\n );\n const previousFocusRef = useRef<HTMLElement | null>(null);\n const layerRef = useRef<PanelSource | null>(null);\n const initialFocusRef = useRef(initialFocus);\n\n // Ref so the ESC layer registers once per open, not on every inline-onClose change.\n const onCloseRef = useRef(onClose);\n const onYieldRef = useRef(onYield);\n useEffect(() => {\n onCloseRef.current = onClose;\n onYieldRef.current = onYield;\n }, [onClose, onYield]);\n\n // Before the trap effect, so the trigger is recorded before focus moves in.\n useEffect(() => {\n ensureDroppedFocusTracking();\n if (!open) {\n return;\n }\n previousFocusRef.current = focusReturnTarget();\n return () => {\n const recorded = previousFocusRef.current;\n previousFocusRef.current = null;\n const inherited = inheritedRestoreTargets.get(source);\n inheritedRestoreTargets.delete(source);\n if (layerRef.current === null) {\n return;\n }\n const target = recorded?.isConnected ? recorded : inherited;\n // Runs before the trap cleanup below, so a registered layer is still on the stack.\n const above = coveringLayer(source);\n if (above && target) {\n inheritedRestoreTargets.set(above, target);\n }\n if (!above && target?.isConnected) {\n target.focus();\n }\n };\n }, [open, source]);\n\n useEffect(() => {\n if (!open) {\n return;\n }\n // Checked here, not at render: a dialog opening in the same commit registers only in its effects.\n if (onYieldRef.current && trapLayers.length > 0) {\n onYieldRef.current();\n return;\n }\n layerRef.current = source;\n const popEscapeLayer = pushEscapeLayer(() => onCloseRef.current());\n const releaseScrollLock = lockBodyScroll();\n const popFocusTrapLayer = pushFocusTrapLayer(source, () => hostRef?.current ?? null);\n // Reopening inside the exit transition reuses the same node, so the ref callback\n // never fires again and nothing would take focus.\n if (panelRef.current) {\n takeInitialFocus(panelRef.current, initialFocusRef.current);\n }\n return () => {\n layerRef.current = null;\n popFocusTrapLayer();\n popEscapeLayer();\n releaseScrollLock();\n };\n }, [open, hostRef, source]);\n\n // Its own effect: re-pushing the trap layer to change elevation would move this overlay to\n // the top of the stack, handing it the Escape and Tab that belong to a dialog above it.\n // Layout, and declared above the sync below, so that sync sees it in the same commit.\n useLayoutEffect(() => {\n if (!open || !elevated) {\n return;\n }\n elevatedLayers.add(source);\n notifyStackChanged();\n return () => {\n elevatedLayers.delete(source);\n notifyStackChanged();\n };\n }, [open, elevated, source]);\n\n // Only an open overlay subscribes: a mounted-but-idle one must carry no at-rest cost,\n // and its snapshot is a constant `false` regardless of what the stack does.\n const subscribe = useCallback(\n (onStackChange: () => void) => (open ? subscribeToStack(onStackChange) : NO_SUBSCRIPTION),\n [open],\n );\n\n const isTopmost = useSyncExternalStore(\n subscribe,\n // Gated on `open` so an overlay fading out stops claiming modal. Before it registers\n // it is the one about to go on top, or aria-modal would drop for a frame on open.\n () =>\n open &&\n (layerRef.current === null || trapLayers[trapLayers.length - 1] === layerRef.current),\n () => true,\n );\n\n // Its own request counts before the stack has it: the layer is not pushed until effects run.\n const stackElevated = useSyncExternalStore(\n subscribe,\n () => open && (elevated || elevatedLayers.size > 0),\n () => false,\n );\n\n // Overlay hosts share one z-index band, so paint order would otherwise fall out of body\n // order: an overlay reopened over a newer one takes the keyboard while painting under it.\n const zIndex = useSyncExternalStore(\n subscribe,\n () => {\n const layer = layerRef.current;\n return OVERLAY_Z_BASE + (open && layer ? Math.max(0, trapLayers.indexOf(layer)) : 0);\n },\n () => OVERLAY_Z_BASE,\n );\n\n // Layout, not passive: the rule has to exist before the first paint the attribute applies to.\n useLayoutEffect(() => {\n if (stackElevated) {\n ensureElevatedOverlayStyles();\n }\n }, [stackElevated]);\n\n // No deps: the host mounts a commit after the layer that owns it, so there is no stack\n // change left to key this on. `syncTopLayer` compares before it touches anything.\n useLayoutEffect(() => {\n syncTopLayer();\n });\n\n const ref = useCallback((node: HTMLElement | null) => {\n panelRef.current = node;\n // A panel portaled in after its layer registered takes focus here; any other, from the effect.\n if (node && layerRef.current !== null) {\n takeInitialFocus(node, initialFocusRef.current);\n }\n }, []);\n\n return { ref, isTopmost, zIndex: stackElevated ? undefined : zIndex, elevated: stackElevated };\n};\n\nexport default useOverlayBehaviour;\n"],"names":["OVERLAY_ICON_BUTTON_CLASSES","FOCUS_RING","FOCUSABLE_SELECTOR","flatParent","element","firstSummaryOf","details","child","createRenderStates","states","stateOf","cached","display","visibility","contentVisibility","parent","parentState","closedDisclosure","state","isTabStop","hidden","invisible","isGroupedRadio","skipsWithinRadioGroup","reachable","group","candidate","radio","inTabOrder","entries","tabIndexOf","index","left","right","isShadowSlot","scopeMembers","elements","into","stopsInScope","members","stops","root","own","tabStopsIn","composedPosition","from","to","ancestry","node","chain","fromChain","toChain","fromStep","toStep","step","firstTabStopIn","trapLayers","elevatedLayers","hostSources","trapTickets","stackListeners","NO_SUBSCRIPTION","promoted","aboveStack","syncTopLayer","wanted","layer","_a","host","stillWanted","leaveTopLayer","raiseToTopLayer","keepAboveOverlayStack","notifyStackChanged","listener","subscribeToStack","wrapTab","event","active","within","first","last","inside","containsComposed","stop","handleTabKeyDown","panel","trapTicket","getDeepActiveElement","popupLayerHolding","popupStops","focusables","pushFocusTrapLayer","getPanel","getHost","nextLayerTicket","coveringLayer","source","inheritedRestoreTargets","useHasOpenOverlay","useSyncExternalStore","takeInitialFocus","initialFocus","useOverlayBehaviour","open","onClose","elevated","hostRef","onYield","panelRef","useRef","useOwnedByPopover","useCallback","previousFocusRef","layerRef","initialFocusRef","onCloseRef","onYieldRef","useEffect","ensureDroppedFocusTracking","focusReturnTarget","recorded","inherited","target","above","popEscapeLayer","pushEscapeLayer","releaseScrollLock","lockBodyScroll","popFocusTrapLayer","useLayoutEffect","subscribe","onStackChange","isTopmost","stackElevated","zIndex","OVERLAY_Z_BASE","ensureElevatedOverlayStyles"],"mappings":";;;;;;;;;;AAYO,MAAMA,KAA8B,2MAA2MC,CAAU,IAInPC,KACT,sJAGEC,KAAa,CAACC,MAChBA,EAAQ,gBACRA,EAAQ,kBACPA,EAAQ,sBAAsB,aAAaA,EAAQ,WAAW,OAAO,OAIpEC,KAAiB,CAACC,MACpB,MAAM,KAAKA,EAAQ,QAAQ,EAAE,KAAK,CAACC,MAAUA,EAAM,YAAY,SAAS,GAOtEC,KAAqB,MAA2C;AAClE,QAAMC,wBAAa,IAAA,GACbC,IAAU,CAACN,MAAkC;AAC/C,UAAMO,IAASF,EAAO,IAAIL,CAAO;AACjC,QAAIO;AACA,aAAOA;AAEX,UAAM,EAAE,SAAAC,GAAS,YAAAC,GAAY,mBAAAC,EAAA,IAAsB,iBAAiBV,CAAO,GACrEW,IAASZ,GAAWC,CAAO,GAC3BY,IAAcD,IAASL,EAAQK,CAAM,IAAI,MAGzCE,IACFF,aAAkB,sBAClB,CAACA,EAAO,QACRV,GAAeU,CAAM,MAAMX,GACzBc,IAAQ;AAAA,MACV,QACId,EAAQ,aAAa,OAAO,KAC5BQ,MAAY,UACZK,KACA,GAAQD,MAAgBA,EAAY,UAAUA,EAAY;AAAA,MAC9D,WAAWH,MAAe,YAAYA,MAAe;AAAA,MACrD,cAAcC,MAAsB;AAAA,IAAA;AAExC,WAAAL,EAAO,IAAIL,GAASc,CAAK,GAClBA;AAAA,EACX;AACA,SAAOR;AACX,GAEMS,KAAY,CAACf,GAAsBM,MAAwD;AAC7F,MAAIN,EAAQ,WAAW,KAAKA,EAAQ,QAAQ,WAAW;AACnD,WAAO;AAEX,QAAM,EAAE,QAAAgB,GAAQ,WAAAC,MAAcX,EAAQN,CAAO;AAE7C,SAAO,CAACgB,KAAU,CAACC;AACvB,GAEMC,IAAiB,CAAClB,MACpBA,aAAmB,oBAAoBA,EAAQ,SAAS,WAAWA,EAAQ,SAAS,IAIlFmB,KAAwB,CAACnB,GAAsBoB,MAAsC;AACvF,MAAI,CAACF,EAAelB,CAAO;AACvB,WAAO;AAEX,QAAMqB,IAAQD,EAAU;AAAA,IACpB,CAACE,MACGJ,EAAeI,CAAS,KACxBA,EAAU,SAAStB,EAAQ,QAC3BsB,EAAU,SAAStB,EAAQ;AAAA,EAAA;AAGnC,UAAQqB,EAAM,KAAK,CAACE,MAAUA,EAAM,OAAO,KAAKF,EAAM,CAAC,OAAOrB;AAClE,GAEMwB,KAAa,CAACC,GAAoBC,MACpCD,EACK,IAAI,CAACzB,GAAS2B,OAAW,EAAE,SAAA3B,GAAS,OAAA2B,GAAO,UAAUD,EAAW1B,CAAO,EAAA,EAAI,EAC3E,KAAK,CAAC4B,GAAMC,MACLD,EAAK,aAAaC,EAAM,WACpBD,EAAK,aAAa,IACX,IAEPC,EAAM,aAAa,IACZ,KAGJD,EAAK,WAAWC,EAAM,WAG1BD,EAAK,QAAQC,EAAM,KAC7B,EACA,IAAI,CAAC,EAAE,SAAA7B,EAAA,MAAcA,CAAO,GAG/B8B,IAAe,CAAC9B,MAClBA,aAAmB,mBAAmBA,EAAQ,yBAAyB,YAIrE+B,IAAe,CAACC,GAA6BC,IAAkB,OAAkB;AACnF,aAAWjC,KAAWgC;AAClB,IAAAC,EAAK,KAAKjC,CAAO,GACb,CAACA,EAAQ,cAAc,CAAC8B,EAAa9B,CAAO,KAC5C+B,EAAa/B,EAAQ,UAAUiC,CAAI;AAG3C,SAAOA;AACX,GAIMC,IAAe,CACjBC,GACA7B,MACgB;AAChB,QAAMc,IAAYe,EAAQ;AAAA,IACtB,CAACnC,MACGA,aAAmB,eACnBA,EAAQ,QAAQF,EAAkB,KAClCiB,GAAUf,GAASM,CAAO;AAAA,EAAA,GAE5B8B,IAAQ,IAAI;AAAA,IACdhB,EAAU,OAAO,CAACpB,MAAY,CAACmB,GAAsBnB,GAASoB,CAAS,CAAC;AAAA,EAAA,GAEtEK,IAAUU,EAAQ;AAAA,IACpB,CAACnC,MAAYoC,EAAM,IAAIpC,CAAO,KAAKA,EAAQ,cAAc8B,EAAa9B,CAAO;AAAA,EAAA;AAGjF,SAAOwB;AAAA,IAAWC;AAAA,IAAS,CAACzB,MACxBoC,EAAM,IAAIpC,CAAO,IAAKA,EAAwB,WAAW;AAAA,EAAA,EAC3D,QAAQ,CAACA,MAAY;AACnB,QAAI8B,EAAa9B,CAAO;AACpB,aAAOkC,EAAaH,EAAa/B,EAAQ,iBAAiB,EAAE,SAAS,GAAA,CAAM,CAAC,GAAGM,CAAO;AAE1F,UAAM+B,IAAOrC,EAAQ;AAGrB,QAAIqC,KAAQ,OAAO,SAASrC,EAAQ,aAAa,UAAU,KAAK,IAAI,EAAE,IAAI;AACtE,aAAO,CAAA;AAEX,UAAMsC,IAAMF,EAAM,IAAIpC,CAAO,KAAK,EAACqC,KAAA,QAAAA,EAAM,kBAAiB,CAACrC,CAAsB,IAAI,CAAA;AAErF,WAAOqC,IAAO,CAAC,GAAGC,GAAK,GAAGJ,EAAaH,EAAaM,EAAK,QAAQ,GAAG/B,CAAO,CAAC,IAAIgC;AAAA,EACpF,CAAC;AACL,GAEMC,IAAa,CAACF,MAChBH,EAAaH,EAAaM,EAAK,QAAQ,GAAGjC,IAAoB,GAI5DoC,KAAmB,CAACC,GAAYC,MAAqB;AACvD,QAAMC,IAAW,CAACC,MAAuB;AACrC,UAAMC,IAAQ,CAACD,CAAI;AACnB,aACQP,IAAOO,EAAK,eAChBP,aAAgB,YAChBA,IAAOA,EAAK,KAAK,YAAA;AAEjB,MAAAQ,EAAM,KAAKR,EAAK,IAAI;AAExB,WAAOQ;AAAA,EACX,GACMC,IAAYH,EAASF,CAAI,GACzBM,IAAUJ,EAASD,CAAE;AAC3B,aAAWM,KAAYF,GAAW;AAC9B,UAAMG,IAASF,EAAQ,KAAK,CAACG,MAASA,EAAK,YAAA,MAAkBF,EAAS,aAAa;AACnF,QAAKC;AAGL,aAAID,MAAaC,IACND,EAAS,wBAAwBC,CAAM,IAG3CD,MAAaP,IACd,KAAK,8BACL,KAAK;AAAA,EACf;AAEA,SAAO,KAAK;AAChB,GAGaU,KAAiB,CAACd,MAAyCE,EAAWF,CAAI,EAAE,CAAC,KAAK,MAMzFe,IAA4B,CAAA,GAG5BC,wBAAqB,IAAA,GAErBC,wBAAkB,IAAA,GAClBC,wBAAkB,IAAA,GAClBC,wBAAqB,IAAA,GACrBC,KAAkB,MAAM;AAE9B;AAIA,IAAIC,IAA0B,CAAA;AAC9B,MAAMC,wBAAiB,IAAA,GAEjBC,KAAe,MAAY;AAC7B,QAAMC,IAASR,EAAe,OACxBD,EACK,IAAI,CAACU,MAAA;;AAAU,YAAAC,IAAAT,EAAY,IAAIQ,CAAK,MAArB,gBAAAC;AAAA,GAA0B,EACzC,OAAO,CAACC,MAA8B,EAAQA,CAAK,IACxD,CAAA;AAGN,MACIH,EAAO,WAAWH,EAAS,UAC3BG,EAAO,MAAM,CAACG,GAAMrC,MAAUqC,MAASN,EAAS/B,CAAK,CAAC;AAEtD;AAEJ,QAAMsC,IAAc,IAAI,IAAIJ,CAAM;AAClC,aAAWG,KAAQN;AACf,IAAKO,EAAY,IAAID,CAAI,KACrBE,EAAcF,CAAI;AAG1B,aAAWA,KAAQH;AACf,IAAAM,EAAgBH,CAAI;AAExB,EAAAN,IAAWG;AACX,aAAWG,KAAQL;AACf,IAAAQ,EAAgBH,CAAI;AAE5B,GAGaI,KAAwB,CAACJ,OAClCL,EAAW,IAAIK,CAAI,GACZ,MAAM;AACT,EAAAL,EAAW,OAAOK,CAAI;AAC1B,IAGEK,IAAqB,MAAY;AACnC,aAAWC,KAAYd;AACnB,IAAAc,EAAA;AAER,GAEMC,IAAmB,CAACD,OACtBd,EAAe,IAAIc,CAAQ,GACpB,MAAM;AACT,EAAAd,EAAe,OAAOc,CAAQ;AAClC,IAGEE,IAAU,CACZC,GACAC,GACAC,GACAvC,MACO;AACP,QAAMwC,IAAQxC,EAAM,CAAC,GACfyC,IAAOzC,EAAMA,EAAM,SAAS,CAAC,GAC7B0C,IAASC,EAAiBJ,GAAQD,CAAM;AAG9C,MAAIA,KAAUI,KAAUJ,MAAWC,KAAU,CAACvC,EAAM,SAASsC,CAAM,GAAG;AAClE,UAAMb,IAASY,EAAM,WACf,KAAK,8BACL,KAAK;AACX,IAAKrC,EAAM,KAAK,CAAC4C,MAASxC,GAAiBkC,GAAQM,CAAI,IAAInB,CAAM,MAC7DY,EAAM,eAAA,IACLA,EAAM,WAAWI,IAAOD,GAAO,MAAA;AAGpC;AAAA,EACJ;AACA,EAAIH,EAAM,YACF,CAACK,KAAUJ,MAAWE,KAASF,MAAWC,OAC1CF,EAAM,eAAA,GACNI,EAAK,MAAA,MAEF,CAACC,KAAUJ,MAAWG,KAAQH,MAAWC,OAChDF,EAAM,eAAA,GACNG,EAAM,MAAA;AAEd,GAEMK,IAAmB,CAACR,MAA+B;AACrD,MAAIA,EAAM,QAAQ,SAASA,EAAM;AAC7B;AAIJ,MAAIS,IAA4B,MAC5BC,IAAa;AACjB,WAASxD,IAAQyB,EAAW,SAAS,GAAGzB,KAAS,KAAK,CAACuD,GAAOvD,KAAS;AACnE,IAAAuD,IAAQ9B,EAAWzB,CAAK,EAAA,GACpBuD,MACAC,IAAa5B,EAAY,IAAIH,EAAWzB,CAAK,CAAC,KAAK;AAG3D,MAAI,CAACuD;AACD;AAEJ,QAAMR,IAASU,EAAA,GACTtB,IAAQY,IAASW,GAAkBX,CAAM,IAAI;AACnD,MAAIA,KAAUZ,KAASA,EAAM,SAASqB,GAAY;AAC9C,UAAM9C,IAAOyB,EAAM,MAAM,cAAcA,EAAM,OACvCwB,IAAa/C,EAAWF,CAAI;AAClC,QAAIiD,EAAW,WAAW,GAAG;AACzB,MAAAb,EAAM,eAAA;AACN;AAAA,IACJ;AACA,IAAAD,EAAQC,GAAOC,GAAQrC,GAAMiD,CAAU;AACvC;AAAA,EACJ;AACA,QAAMC,IAAahD,EAAW2C,CAAK;AACnC,MAAIK,EAAW,WAAW,GAAG;AACzB,IAAAd,EAAM,eAAA,GACNS,EAAM,MAAA;AACN;AAAA,EACJ;AACA,EAAAV,EAAQC,GAAOC,GAAQQ,GAAOK,CAAU;AAC5C,GAGMC,KAAqB,CAACC,GAAuBC,OAC3CtC,EAAW,WAAW,KACtB,SAAS,iBAAiB,WAAW6B,CAAgB,GAEzD7B,EAAW,KAAKqC,CAAQ,GACxBnC,EAAY,IAAImC,GAAUC,CAAO,GACjCnC,EAAY,IAAIkC,GAAUE,GAAiB,GAC3CtB,EAAA,GACO,MAAM;AACT,QAAM1C,IAAQyB,EAAW,YAAYqC,CAAQ;AAC7C,EAAI9D,MAAU,MACVyB,EAAW,OAAOzB,GAAO,CAAC,GAE9B0B,EAAe,OAAOoC,CAAQ,GAC9BnC,EAAY,OAAOmC,CAAQ,GAC3BlC,EAAY,OAAOkC,CAAQ;AAC3B,QAAMzB,IAAO0B,EAAA;AACb,EAAI1B,KACAE,EAAcF,CAAI,GAElBZ,EAAW,WAAW,KACtB,SAAS,oBAAoB,WAAW6B,CAAgB,GAE5DZ,EAAA;AACJ,IAIEuB,KAAgB,CAACC,MAAiD;AACpE,QAAMlE,IAAQyB,EAAW,YAAYyC,CAAM;AAC3C,SAAOlE,MAAU,KACX,SACAyB,EAAW,MAAMzB,IAAQ,CAAC,EAAE,KAAK,CAACmC,MAAA;;AAAU,aAAAC,IAAAD,EAAA,MAAA,gBAAAC,EAAS,iBAAgB;AAAA,GAAI;AACnF,GAEM+B,wBAA8B,IAAA,GAOvBC,KAAoB,MAC7BC;AAAA,EACIzB;AAAA,EACA,MAAMnB,EAAW,SAAS;AAAA,EAC1B,MAAM;AACV,GAEE6C,IAAmB,CAACf,GAAoBgB,MAA4C;AACtF,MAAI,CAAAnB,EAAiBG,GAAOE,EAAA,CAAsB,GAGlD;AAAA,QAAIc,MAAiB,WAAW;AAC5B,OAAC/C,GAAe+B,CAAK,KAAKA,GAAO,MAAA;AACjC;AAAA,IACJ;AACA,IAAAA,EAAM,MAAA;AAAA;AACV,GAYaiB,KAAsB,CAAC;AAAA,EAChC,MAAAC;AAAA,EACA,SAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,SAAAC;AAAA,EACA,cAAAL,IAAe;AAAA,EACf,SAAAM;AACJ,MAeK;AACD,QAAMC,IAAWC,EAA2B,IAAI,GAG1Cb,IAASa,EAAoB,MAAMD,EAAS,OAAO,EAAE;AAC3D,EAAAE;AAAA,IACIC,EAAY,OAAML,KAAA,gBAAAA,EAAS,YAAWE,EAAS,SAAS,CAACF,CAAO,CAAC;AAAA,IACjEH;AAAA,EAAA;AAEJ,QAAMS,IAAmBH,EAA2B,IAAI,GAClDI,IAAWJ,EAA2B,IAAI,GAC1CK,IAAkBL,EAAOR,CAAY,GAGrCc,IAAaN,EAAOL,CAAO,GAC3BY,IAAaP,EAAOF,CAAO;AACjC,EAAAU,EAAU,MAAM;AACZ,IAAAF,EAAW,UAAUX,GACrBY,EAAW,UAAUT;AAAA,EACzB,GAAG,CAACH,GAASG,CAAO,CAAC,GAGrBU,EAAU,MAAM;AAEZ,QADAC,EAAA,GACI,EAACf;AAGL,aAAAS,EAAiB,UAAUO,EAAA,GACpB,MAAM;AACT,cAAMC,IAAWR,EAAiB;AAClC,QAAAA,EAAiB,UAAU;AAC3B,cAAMS,IAAYxB,EAAwB,IAAID,CAAM;AAEpD,YADAC,EAAwB,OAAOD,CAAM,GACjCiB,EAAS,YAAY;AACrB;AAEJ,cAAMS,IAASF,KAAA,QAAAA,EAAU,cAAcA,IAAWC,GAE5CE,IAAQ5B,GAAcC,CAAM;AAClC,QAAI2B,KAASD,KACTzB,EAAwB,IAAI0B,GAAOD,CAAM,GAEzC,CAACC,MAASD,KAAA,QAAAA,EAAQ,gBAClBA,EAAO,MAAA;AAAA,MAEf;AAAA,EACJ,GAAG,CAACnB,GAAMP,CAAM,CAAC,GAEjBqB,EAAU,MAAM;AACZ,QAAI,CAACd;AACD;AAGJ,QAAIa,EAAW,WAAW7D,EAAW,SAAS,GAAG;AAC7C,MAAA6D,EAAW,QAAA;AACX;AAAA,IACJ;AACA,IAAAH,EAAS,UAAUjB;AACnB,UAAM4B,IAAiBC,EAAgB,MAAMV,EAAW,SAAS,GAC3DW,IAAoBC,GAAA,GACpBC,IAAoBrC,GAAmBK,GAAQ,OAAMU,KAAA,gBAAAA,EAAS,YAAW,IAAI;AAGnF,WAAIE,EAAS,WACTR,EAAiBQ,EAAS,SAASM,EAAgB,OAAO,GAEvD,MAAM;AACT,MAAAD,EAAS,UAAU,MACnBe,EAAA,GACAJ,EAAA,GACAE,EAAA;AAAA,IACJ;AAAA,EACJ,GAAG,CAACvB,GAAMG,GAASV,CAAM,CAAC,GAK1BiC,EAAgB,MAAM;AAClB,QAAI,GAAC1B,KAAQ,CAACE;AAGd,aAAAjD,EAAe,IAAIwC,CAAM,GACzBxB,EAAA,GACO,MAAM;AACT,QAAAhB,EAAe,OAAOwC,CAAM,GAC5BxB,EAAA;AAAA,MACJ;AAAA,EACJ,GAAG,CAAC+B,GAAME,GAAUT,CAAM,CAAC;AAI3B,QAAMkC,IAAYnB;AAAA,IACd,CAACoB,MAA+B5B,IAAO7B,EAAiByD,CAAa,IAAIvE;AAAA,IACzE,CAAC2C,CAAI;AAAA,EAAA,GAGH6B,IAAYjC;AAAA,IACd+B;AAAA;AAAA;AAAA,IAGA,MACI3B,MACCU,EAAS,YAAY,QAAQ1D,EAAWA,EAAW,SAAS,CAAC,MAAM0D,EAAS;AAAA,IACjF,MAAM;AAAA,EAAA,GAIJoB,IAAgBlC;AAAA,IAClB+B;AAAA,IACA,MAAM3B,MAASE,KAAYjD,EAAe,OAAO;AAAA,IACjD,MAAM;AAAA,EAAA,GAKJ8E,IAASnC;AAAA,IACX+B;AAAA,IACA,MAAM;AACF,YAAMjE,IAAQgD,EAAS;AACvB,aAAOsB,KAAkBhC,KAAQtC,IAAQ,KAAK,IAAI,GAAGV,EAAW,QAAQU,CAAK,CAAC,IAAI;AAAA,IACtF;AAAA,IACA,MAAMsE;AAAA,EAAA;AAIV,SAAAN,EAAgB,MAAM;AAClB,IAAII,KACAG,GAAA;AAAA,EAER,GAAG,CAACH,CAAa,CAAC,GAIlBJ,EAAgB,MAAM;AAClB,IAAAlE,GAAA;AAAA,EACJ,CAAC,GAUM,EAAE,KARGgD,EAAY,CAAChE,MAA6B;AAClD,IAAA6D,EAAS,UAAU7D,GAEfA,KAAQkE,EAAS,YAAY,QAC7Bb,EAAiBrD,GAAMmE,EAAgB,OAAO;AAAA,EAEtD,GAAG,CAAA,CAAE,GAES,WAAAkB,GAAW,QAAQC,IAAgB,SAAYC,GAAQ,UAAUD,EAAA;AACnF;"}
|
package/dist/index.d.ts
CHANGED
|
@@ -2583,6 +2583,8 @@ export declare interface HexagonScaleProps {
|
|
|
2583
2583
|
current?: number;
|
|
2584
2584
|
/** Only when it stands alone; beside text naming the step it is decorative. */
|
|
2585
2585
|
label?: string;
|
|
2586
|
+
stepLabels?: readonly string[];
|
|
2587
|
+
currentNote?: string;
|
|
2586
2588
|
className?: string;
|
|
2587
2589
|
}
|
|
2588
2590
|
|
|
@@ -3585,6 +3587,10 @@ declare interface InputProps {
|
|
|
3585
3587
|
helperText?: default_2.ReactNode;
|
|
3586
3588
|
showPasswordToggle?: boolean;
|
|
3587
3589
|
id?: string;
|
|
3590
|
+
/** Moves focus into the field when it mounts, such as the first field of a form that just opened. */
|
|
3591
|
+
autoFocus?: boolean;
|
|
3592
|
+
/** The browser's autofill hint, such as `current-password` or `new-password`. Defaults to `off`. */
|
|
3593
|
+
autoComplete?: string;
|
|
3588
3594
|
'aria-label'?: string;
|
|
3589
3595
|
'aria-labelledby'?: string;
|
|
3590
3596
|
'aria-describedby'?: string;
|
|
@@ -3664,6 +3670,7 @@ export declare const KeyValueStrip: default_2.FC<KeyValueStripProps> & {
|
|
|
3664
3670
|
|
|
3665
3671
|
export declare interface KeyValueStripItemProps {
|
|
3666
3672
|
label: default_2.ReactNode;
|
|
3673
|
+
tone?: KeyValueStripTone;
|
|
3667
3674
|
className?: string;
|
|
3668
3675
|
children: default_2.ReactNode;
|
|
3669
3676
|
/** One line with an ellipsis. Block/flex children clip without one, so use their own truncate. */
|
|
@@ -3686,6 +3693,8 @@ export declare interface KeyValueStripProps {
|
|
|
3686
3693
|
'aria-labelledby'?: string;
|
|
3687
3694
|
}
|
|
3688
3695
|
|
|
3696
|
+
export declare type KeyValueStripTone = 'neutral' | 'success' | 'warning' | 'error';
|
|
3697
|
+
|
|
3689
3698
|
export declare const LayoutIcon: React.FC<IconProps_71>;
|
|
3690
3699
|
|
|
3691
3700
|
export declare const LevelMeter: default_2.FC<LevelMeterProps>;
|
|
@@ -4779,7 +4788,7 @@ declare type PhraseLabel = string | {
|
|
|
4779
4788
|
|
|
4780
4789
|
export declare const PillButton: default_2.FC<PillButtonProps>;
|
|
4781
4790
|
|
|
4782
|
-
declare interface
|
|
4791
|
+
declare interface PillButtonBaseProps {
|
|
4783
4792
|
label: string;
|
|
4784
4793
|
icon?: default_2.ReactNode;
|
|
4785
4794
|
className?: string;
|
|
@@ -4789,7 +4798,6 @@ declare interface PillButtonProps {
|
|
|
4789
4798
|
size?: PillButtonSize;
|
|
4790
4799
|
variant?: PillButtonVariant;
|
|
4791
4800
|
shape?: PillButtonShape;
|
|
4792
|
-
tone?: PillButtonTone;
|
|
4793
4801
|
/** Sits after the label — a caret on a pill that opens a menu. */
|
|
4794
4802
|
trailingIcon?: default_2.ReactNode;
|
|
4795
4803
|
onClick?: (event: default_2.MouseEvent<HTMLElement>) => void;
|
|
@@ -4799,6 +4807,14 @@ declare interface PillButtonProps {
|
|
|
4799
4807
|
rel?: string;
|
|
4800
4808
|
}
|
|
4801
4809
|
|
|
4810
|
+
declare type PillButtonProps = PillButtonBaseProps & ({
|
|
4811
|
+
tone?: Extract<PillButtonTone, 'default'>;
|
|
4812
|
+
pressed?: boolean;
|
|
4813
|
+
} | {
|
|
4814
|
+
tone: Extract<PillButtonTone, 'assistant'>;
|
|
4815
|
+
pressed?: never;
|
|
4816
|
+
});
|
|
4817
|
+
|
|
4802
4818
|
/**
|
|
4803
4819
|
* `tab` squares the top corners so the pill reads as attached to whatever sits above it —
|
|
4804
4820
|
* a row of controls hanging under an input, rather than free-floating pills.
|
|
@@ -5204,6 +5220,22 @@ declare const Row: default_2.FC<KeyValueListRowProps>;
|
|
|
5204
5220
|
|
|
5205
5221
|
export declare type RowVariant = 'success' | 'warning' | 'error' | 'info';
|
|
5206
5222
|
|
|
5223
|
+
export declare const ScoreMeter: default_2.FC<ScoreMeterProps>;
|
|
5224
|
+
|
|
5225
|
+
export declare interface ScoreMeterProps {
|
|
5226
|
+
value: number;
|
|
5227
|
+
label: string;
|
|
5228
|
+
valueText?: string;
|
|
5229
|
+
threshold?: number;
|
|
5230
|
+
thresholdLabel?: string;
|
|
5231
|
+
lowLabel?: string;
|
|
5232
|
+
highLabel?: string;
|
|
5233
|
+
tone?: ScoreMeterTone;
|
|
5234
|
+
className?: string;
|
|
5235
|
+
}
|
|
5236
|
+
|
|
5237
|
+
export declare type ScoreMeterTone = 'neutral' | 'success' | 'warning' | 'error';
|
|
5238
|
+
|
|
5207
5239
|
/** Forwards a ref to the input, so a consumer can focus the field. */
|
|
5208
5240
|
export declare const Search: default_2.ForwardRefExoticComponent<SearchProps & default_2.RefAttributes<HTMLInputElement>>;
|
|
5209
5241
|
|
|
@@ -6201,6 +6233,8 @@ export declare type TableColumnDefinition<T = Record<string, unknown>> = {
|
|
|
6201
6233
|
title: string | default_2.ReactNode;
|
|
6202
6234
|
/** Explanatory text shown in a tooltip behind an info icon next to the title. */
|
|
6203
6235
|
info?: string;
|
|
6236
|
+
/** Lets a self-truncating title, like `EllipsisText`, narrow to its column. Inline only. */
|
|
6237
|
+
titleShrinks?: boolean;
|
|
6204
6238
|
dataIndex: keyof T | (string & {});
|
|
6205
6239
|
key: string;
|
|
6206
6240
|
width?: string | number;
|
|
@@ -6520,6 +6554,10 @@ export declare interface TextProps {
|
|
|
6520
6554
|
tooltip?: string;
|
|
6521
6555
|
textAlign?: 'left' | 'center' | 'right' | 'justify';
|
|
6522
6556
|
wrap?: boolean;
|
|
6557
|
+
/** Breaks a long id or URL instead of widening its container, while the text wraps. */
|
|
6558
|
+
breakAnywhere?: boolean;
|
|
6559
|
+
/** Keeps newlines while the text wraps. Runs of spaces still collapse. */
|
|
6560
|
+
preserveLineBreaks?: boolean;
|
|
6523
6561
|
/** The element it renders, for a heading or paragraph that keeps Text's look. */
|
|
6524
6562
|
as?: TextElement;
|
|
6525
6563
|
className?: string;
|
|
@@ -6637,6 +6675,7 @@ export declare const Timeline: default_2.FC<TimelineProps> & {
|
|
|
6637
6675
|
|
|
6638
6676
|
export declare interface TimelineItemProps {
|
|
6639
6677
|
title: default_2.ReactNode;
|
|
6678
|
+
eyebrow?: default_2.ReactNode;
|
|
6640
6679
|
/**
|
|
6641
6680
|
* Code set after the title in the mono face, as one phrase with it, e.g. `title="n8n called"`
|
|
6642
6681
|
* with `titleCode="Salesforce | Delete contact"`.
|