@12-apps/ui 6.44.3 → 6.45.1

package/src/components/navigation/SectionNav/index.ts

@@ -0,0 +1,13 @@
+export { SectionNav } from './SectionNav';
+export { sectionNavBarInset } from './SectionNav.bar';
+export { RaisedActionButton } from './SectionNav.primary';
+export type { RaisedActionButtonProps } from './SectionNav.primary';
+export type {
+  SectionNavBack,
+  SectionNavDestination,
+  SectionNavEntry,
+  SectionNavGroup,
+  SectionNavMenu,
+  SectionNavProps,
+} from './SectionNav.types';
+export type { SectionNavCopy } from '../../../copy';

package/src/components/navigation/index.ts

@@ -5,4 +5,5 @@ export * from './ContextMenu';
 export * from './DropdownMenu';
 export * from './NavigationMenu';
 export * from './Pagination';
+export * from './SectionNav';
 export * from './Tabs';

package/src/copy/navigation.ts

@@ -18,6 +18,17 @@ export interface CommandPaletteCopy {
   tryAnotherTerm: string;
 }
 
+/**
+ * `SectionNav`'s own words — only the chrome it draws around the host's
+ * destinations. Every destination and menu label is the host's, per prop.
+ */
+export interface SectionNavCopy {
+  /** The open primary trigger's accessible name, and the sheet's close button. */
+  close: string;
+  /** A badge's accessible name — "3 pending", for a count of 3. */
+  badge: (count: number) => string;
+}
+
 /** The breadcrumb's overflow control, in its two spellings. */
 export interface BreadcrumbCopy {
   showMore: string;

package/src/en-US.navigation.ts

@@ -5,6 +5,7 @@
 import type {
   BreadcrumbCopy,
   CommandPaletteCopy,
+  SectionNavCopy,
 } from './copy';
 
 export const EN_US_COMMAND_PALETTE_COPY: CommandPaletteCopy = {
@@ -21,3 +22,8 @@ export const EN_US_BREADCRUMB_COPY: BreadcrumbCopy = {
   showMore: "Show more",
   moreItems: "More items",
 };
+
+export const EN_US_SECTION_NAV_COPY: SectionNavCopy = {
+  close: "Close",
+  badge: (count) => (count === 1 ? "1 pending" : `${count} pending`),
+};

package/src/locales.ts

@@ -29,6 +29,7 @@ import type {
   ChromeCopy,
   CodeEditorCopy,
   CommandPaletteCopy,
+  SectionNavCopy,
   ConfirmActionCopy,
   DataGridCopy,
   DataStateCopy,
@@ -133,6 +134,10 @@ export const COMMAND_PALETTE_COPY = pack<CommandPaletteCopy>(
   pt.PT_BR_COMMAND_PALETTE_COPY,
   en.EN_US_COMMAND_PALETTE_COPY,
 );
+export const SECTION_NAV_COPY = pack<SectionNavCopy>(
+  pt.PT_BR_SECTION_NAV_COPY,
+  en.EN_US_SECTION_NAV_COPY,
+);
 export const BREADCRUMB_COPY = pack<BreadcrumbCopy>(
   pt.PT_BR_BREADCRUMB_COPY,
   en.EN_US_BREADCRUMB_COPY,

package/src/pt-BR.navigation.ts

@@ -5,6 +5,7 @@
 import type {
   BreadcrumbCopy,
   CommandPaletteCopy,
+  SectionNavCopy,
 } from './copy';
 
 export const PT_BR_COMMAND_PALETTE_COPY: CommandPaletteCopy = {
@@ -19,3 +20,8 @@ export const PT_BR_BREADCRUMB_COPY: BreadcrumbCopy = {
   showMore: "Mostrar mais",
   moreItems: "Mais itens",
 };
+
+export const PT_BR_SECTION_NAV_COPY: SectionNavCopy = {
+  close: "Fechar",
+  badge: (count) => (count === 1 ? "1 pendente" : `${count} pendentes`),
+};

package/dist/chunk-62OGPVCL.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/pt-BR.navigation.ts"],"sourcesContent":["/**\n * The pt-BR pack for the navigation family. Split out of `pt-BR.ts`, which is a\n * barrel over this folder — see that file for why.\n */\nimport type {\n  BreadcrumbCopy,\n  CommandPaletteCopy,\n} from './copy';\n\nexport const PT_BR_COMMAND_PALETTE_COPY: CommandPaletteCopy = {\n  execute: \"Executar\",\n  navigate: \"↑↓ Navegar\",\n  close: \"ESC Fechar\",\n  recent: \"Recentes\",\n  tryAnotherTerm: \"Tente outro termo\",\n};\n\nexport const PT_BR_BREADCRUMB_COPY: BreadcrumbCopy = {\n  showMore: \"Mostrar mais\",\n  moreItems: \"Mais itens\",\n};\n"],"mappings":";AASO,IAAM,6BAAiD;AAAA,EAC5D,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,gBAAgB;AAClB;AAEO,IAAM,wBAAwC;AAAA,EACnD,UAAU;AAAA,EACV,WAAW;AACb;","names":[]}

package/dist/chunk-AUQRGZE7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/en-US.navigation.ts"],"sourcesContent":["/**\n * The en-US pack for the navigation family. Split the same way\n * `pt-BR.navigation.ts` is — see `en-US.ts` for why.\n */\nimport type {\n  BreadcrumbCopy,\n  CommandPaletteCopy,\n} from './copy';\n\nexport const EN_US_COMMAND_PALETTE_COPY: CommandPaletteCopy = {\n  execute: \"Run\",\n  // The arrow glyphs and the key name are part of the hint a reader looks at\n  // while their hands are on the keyboard, so they survive translation intact.\n  navigate: \"↑↓ Navigate\",\n  close: \"ESC Close\",\n  recent: \"Recent\",\n  tryAnotherTerm: \"Try another term\",\n};\n\nexport const EN_US_BREADCRUMB_COPY: BreadcrumbCopy = {\n  showMore: \"Show more\",\n  moreItems: \"More items\",\n};\n"],"mappings":";AASO,IAAM,6BAAiD;AAAA,EAC5D,SAAS;AAAA;AAAA;AAAA,EAGT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,gBAAgB;AAClB;AAEO,IAAM,wBAAwC;AAAA,EACnD,UAAU;AAAA,EACV,WAAW;AACb;","names":[]}

package/dist/chunk-CMV6BRQ3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/data-display/HoverCard/HoverCard.tsx"],"sourcesContent":["import Box from '@mui/material/Box/index.js';\nimport Card from '@mui/material/Card/index.js';\nimport CardContent from '@mui/material/CardContent/index.js';\nimport Popover from '@mui/material/Popover/index.js';\nimport { styled, type Theme } from '@mui/material/styles/index.js';\nimport React from 'react';\n\nimport { rem } from '../../../tokens/relative';\nimport { withDefaults } from '../../../utils/withDefaults';\n\nimport { HoverCardContent } from './HoverCard.content';\nimport { useHoverCard } from './HoverCard.hooks';\nimport { arrowSx, cardSx, getAnchorOrigin, getTransformOrigin, sideOf } from './HoverCard.styles';\nimport type { CardStyleFlags } from './HoverCard.styles';\nimport type { HoverCardAnimation, HoverCardPlacement, HoverCardProps } from './HoverCard.types';\n\nconst ArrowContainer = styled('div')<{ placement: HoverCardPlacement; offset?: number }>(\n  ({ theme, placement }) => ({ ...arrowSx(theme, placement) }),\n);\n\nconst StyledCard = styled(Card, {\n  shouldForwardProp: (prop) =>\n    !['customVariant', 'glow', 'pulse', 'animation'].includes(prop as string),\n})<CardStyleFlags>(({ theme, ...flags }) => ({ ...cardSx(theme, flags) }));\n\nconst StyledPopover = styled(Popover, {\n  shouldForwardProp: (prop) => prop !== 'customAnimation',\n})<{ customAnimation?: HoverCardAnimation }>(({ customAnimation }) => ({\n  // Only the card takes the pointer (its paper sets `pointer-events: auto`).\n  // MUI's popover root and its invisible backdrop cover the whole viewport, so\n  // while a card was open the pointer was \"on the card\" wherever it went: the\n  // backdrop's mouseover reached the card's onMouseEnter and cancelled the\n  // close the trigger's mouseleave had just scheduled. A card left by moving\n  // the mouse away stayed open, and the page's next click hit the backdrop\n  // instead of its target (FUT-2619). The backdrop was also the only\n  // click-away; `useClickAway` in the hooks replaces it.\n  pointerEvents: 'none',\n  // The popover only positions; StyledCard draws the surface.\n  '& .MuiPopover-paper': {\n    backgroundColor: 'transparent',\n    boxShadow: 'none',\n    overflow: 'visible',\n    ...(customAnimation === 'scale' && { transformOrigin: 'center' }),\n  },\n}));\n\nconst DEFAULTS = {\n  variant: 'default',\n  glow: false,\n  pulse: false,\n  placement: 'bottom',\n  showArrow: false,\n  animation: 'fade',\n  enterDelay: 700,\n  exitDelay: 0,\n  loading: false,\n  touchEnabled: true,\n  disabled: false,\n} satisfies Partial<HoverCardProps>;\n\ntype ResolvedProps = HoverCardProps & Required<Pick<HoverCardProps, keyof typeof DEFAULTS>>;\n\n/** Padding is the variant's own: detailed roomier, minimal tighter. */\nconst CONTENT_PADDING: Record<string, number> = { detailed: 3, minimal: 1.5 };\n\n/**\n * The card is nudged off the anchor on whichever side it sits — `offset` design\n * px (8 unless the caller says otherwise), through the theme's type scale.\n */\nconst offsetMargin = (theme: Theme, placement: HoverCardPlacement, offset: number | undefined) => {\n  const side = sideOf(placement);\n  const key = ({ top: 'mt', bottom: 'mb', left: 'ml', right: 'mr' } as const)[side];\n  return { [key]: rem(theme, offset ?? 8) };\n};\n\n/**\n * The card's cap: 400 design px unless the caller says otherwise. `sx` has always\n * read a number of 1 or less as a fraction of the parent, and that stays so.\n */\nconst capOf = (theme: Theme, maxWidth: number | undefined): string => {\n  const cap = maxWidth ?? 400;\n  return cap <= 1 && cap !== 0 ? `${cap * 100}%` : rem(theme, cap);\n};\n\nexport const HoverCard = React.forwardRef<HTMLDivElement, HoverCardProps>((props, ref) => {\n  const {\n    variant, glow, pulse, title, description, avatar, trigger, placement, showArrow,\n    animation, enterDelay, exitDelay, maxWidth, loading, loadingComponent, loadingText, touchEnabled,\n    offset, disabled, onOpen, onClose, children, dataTestId,\n    ...rest\n  } = withDefaults(props, DEFAULTS) as ResolvedProps;\n\n  const { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef } = useHoverCard({\n    disabled,\n    touchEnabled,\n    enterDelay,\n    exitDelay,\n    onOpen,\n    onClose,\n  });\n\n  const triggerProps = {\n    ...triggerHandlers,\n    style: { cursor: disabled ? 'default' : 'pointer' },\n    'data-testid': dataTestId ? `${dataTestId}-trigger` : 'hover-card-trigger',\n  };\n\n  const triggerElement = trigger ? (\n    React.cloneElement(trigger, triggerProps)\n  ) : (\n    <span {...triggerProps} style={{ display: 'inline-block', ...triggerProps.style }}>\n      {children}\n    </span>\n  );\n\n  const padding = CONTENT_PADDING[variant] ?? 2;\n\n  return (\n    <>\n      {triggerElement}\n      <StyledPopover\n        ref={ref}\n        open={isOpen && !disabled}\n        anchorEl={anchorEl}\n        onClose={handleClose}\n        anchorOrigin={getAnchorOrigin(placement)}\n        transformOrigin={getTransformOrigin(placement)}\n        {...cardHandlers}\n        disableAutoFocus\n        disableEnforceFocus\n        disableRestoreFocus\n        customAnimation={animation}\n        slotProps={{ paper: { style: { pointerEvents: 'auto' } } }}\n        {...rest}\n      >\n        <Box ref={contentRef} sx={{ position: 'relative' }}>\n          {showArrow && <ArrowContainer placement={placement} offset={offset} />}\n          <StyledCard\n            customVariant={variant}\n            glow={glow}\n            pulse={pulse}\n            animation={animation}\n            data-testid={dataTestId || 'hover-card-content'}\n            sx={(theme) => ({ maxWidth: capOf(theme, maxWidth), ...offsetMargin(theme, placement, offset) })}\n          >\n            <CardContent sx={{ p: padding, '&:last-child': { pb: padding } }}>\n              <HoverCardContent\n                loadingText={loadingText} variant={variant} title={title}\n                description={description}\n                avatar={avatar}\n                loading={loading}\n                loadingComponent={loadingComponent}\n                dataTestId={dataTestId}\n              >\n                {children}\n              </HoverCardContent>\n            </CardContent>\n          </StyledCard>\n        </Box>\n      </StyledPopover>\n    </>\n  );\n});\n\nHoverCard.displayName = 'HoverCard';\n"],"mappings":"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","names":[]}

package/dist/chunk-OJSVHBQO.js

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-OJSVHBQO.js.map

package/dist/chunk-VNWZWQF3.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/data-display/HoverCard/HoverCard.hooks.ts"],"sourcesContent":["import React from 'react';\n\ntype TimerRef = React.MutableRefObject<number | undefined>;\n\n/**\n * Cancel the timer a ref holds, and forget it. Every place that schedules\n * or dismisses goes through this, so no timer outlives the ref that could\n * cancel it (FUT-2619: an overwritten enter timer reopened a dismissed card).\n */\nconst clearPending = (ref: TimerRef) => {\n  if (ref.current !== undefined) window.clearTimeout(ref.current);\n  ref.current = undefined;\n};\n\ninterface HandlerInput {\n  isTouchDevice: boolean;\n  touchEnabled: boolean;\n  enterDelay: number;\n  openCard: (trigger: HTMLElement) => void;\n  closeCard: () => void;\n  exitTimeoutRef: TimerRef;\n}\n\n/**\n * The pointer and touch handlers, over the open/close pair. Touch gets a\n * long-press because there is no hover to respond to; the card's own handlers\n * keep it open while the pointer is travelling onto it.\n */\nconst useHoverHandlers = ({\n  isTouchDevice,\n  touchEnabled,\n  enterDelay,\n  openCard,\n  closeCard,\n  exitTimeoutRef,\n}: HandlerInput) => {\n  const [touchTimeout, setTouchTimeout] = React.useState<number>();\n\n  /** A touch device with touch disabled has no hover to respond to. */\n  const hoverIgnored = isTouchDevice && !touchEnabled;\n\n  const cancelTouch = React.useCallback(() => {\n    if (touchTimeout) {\n      window.clearTimeout(touchTimeout);\n      setTouchTimeout(undefined);\n    }\n  }, [touchTimeout]);\n\n  React.useEffect(\n    () => () => {\n      if (touchTimeout) window.clearTimeout(touchTimeout);\n    },\n    [touchTimeout],\n  );\n\n  const triggerHandlers = {\n    onMouseEnter: (event: React.MouseEvent<HTMLElement>) => {\n      if (hoverIgnored) return;\n      openCard(event.currentTarget);\n    },\n    onMouseLeave: () => {\n      if (hoverIgnored) return;\n      closeCard();\n    },\n    onTouchStart: (event: React.TouchEvent<HTMLElement>) => {\n      if (!touchEnabled) return;\n      if (touchTimeout) window.clearTimeout(touchTimeout);\n      // Read NOW: React nulls `currentTarget` once the handler returns, so\n      // the long-press timer used to open the card with no anchor at all.\n      const trigger = event.currentTarget;\n      setTouchTimeout(window.setTimeout(() => openCard(trigger), enterDelay));\n    },\n    // End and cancel do the same thing: the press did not become a long press.\n    onTouchEnd: cancelTouch,\n    onTouchCancel: cancelTouch,\n  };\n\n  /** Moving onto the card keeps it open; leaving it starts the exit delay. */\n  const cardHandlers = {\n    onMouseEnter: () => clearPending(exitTimeoutRef),\n    onMouseLeave: closeCard,\n  };\n\n  return { triggerHandlers, cardHandlers };\n};\n\n/** Escape dismisses the card while it is open. */\nconst useEscapeKey = (active: boolean, onEscape: () => void) => {\n  React.useEffect(() => {\n    if (!active) return;\n\n    const handleEscape = (event: globalThis.KeyboardEvent) => {\n      if (event.key === 'Escape') onEscape();\n    };\n\n    document.addEventListener('keydown', handleEscape);\n    return () => document.removeEventListener('keydown', handleEscape);\n  }, [active, onEscape]);\n};\n\n/**\n * A press anywhere outside the trigger and the card dismisses it.\n *\n * Touch has no mouse-leave, and MUI's own click-away was the popover's\n * backdrop, which `pointer-events: none` on the popover root (so the page\n * under an open card stays usable) takes out of play. So this listens on the\n * document itself, in the CAPTURE phase, where a `stopPropagation` further in\n * cannot swallow it. It only observes: no `preventDefault`, so the tap or\n * click still reaches whatever it landed on. Attached while open, removed on\n * close and on unmount.\n */\nconst useClickAway = (\n  active: boolean,\n  inside: () => ReadonlyArray<Element | null>,\n  onAway: () => void,\n) => {\n  React.useEffect(() => {\n    if (!active) return;\n\n    const handlePointerDown = (event: globalThis.PointerEvent) => {\n      const target = event.target as Node | null;\n      if (target && inside().some((el) => el?.contains(target))) return;\n      onAway();\n    };\n\n    document.addEventListener('pointerdown', handlePointerDown, true);\n    return () => document.removeEventListener('pointerdown', handlePointerDown, true);\n  }, [active, inside, onAway]);\n};\n\n/** Whatever is still pending when the card unmounts is cancelled with it. */\nconst useClearOnUnmount = (...refs: TimerRef[]) => {\n  React.useEffect(\n    () => () => refs.forEach(clearPending),\n    // The refs are stable objects: a mount/unmount pair, as before.\n    [],\n  );\n};\n\ninterface HoverCardTimingInput {\n  disabled: boolean;\n  touchEnabled: boolean;\n  enterDelay: number;\n  exitDelay: number;\n  onOpen?: () => void;\n  onClose?: () => void;\n}\n\n/**\n * When the card is open, and the delays that decide it.\n *\n * Three timers are in play: the enter delay before opening, the exit delay\n * before closing (so the pointer can travel from the trigger onto the card\n * without dismissing it), and the long-press timer on touch. Each cancels the\n * others' pending work, which is why they live together.\n */\nexport const useHoverCard = ({\n  disabled,\n  touchEnabled,\n  enterDelay,\n  exitDelay,\n  onOpen,\n  onClose,\n}: HoverCardTimingInput) => {\n  const [anchorEl, setAnchorEl] = React.useState<HTMLElement | null>(null);\n  const [isOpen, setIsOpen] = React.useState(false);\n  const [isTouchDevice, setIsTouchDevice] = React.useState(false);\n  const enterTimeoutRef = React.useRef<number | undefined>(undefined);\n  const exitTimeoutRef = React.useRef<number | undefined>(undefined);\n  /** The card's own box, inside the popover paper: a press here is not \"away\". */\n  const contentRef = React.useRef<HTMLDivElement | null>(null);\n\n  // Probed in an effect, not during render, so SSR and hydration stay intact.\n  React.useEffect(() => {\n    setIsTouchDevice('ontouchstart' in window);\n  }, []);\n\n  const openCard = React.useCallback(\n    (trigger: HTMLElement) => {\n      if (disabled) return;\n\n      clearPending(exitTimeoutRef);\n      // A second enter before the delay ran out (a click and then a hover, or\n      // the pointer jittering across the edge) must REPLACE the pending open,\n      // not add one: an overwritten timer can no longer be cancelled, and it\n      // reopened the card after Escape had closed it.\n      clearPending(enterTimeoutRef);\n\n      enterTimeoutRef.current = window.setTimeout(() => {\n        setAnchorEl(trigger);\n        setIsOpen(true);\n        onOpen?.();\n      }, enterDelay);\n    },\n    [disabled, enterDelay, onOpen],\n  );\n\n  const closeCard = React.useCallback(() => {\n    clearPending(enterTimeoutRef);\n    clearPending(exitTimeoutRef);\n\n    exitTimeoutRef.current = window.setTimeout(() => {\n      setIsOpen(false);\n      setAnchorEl(null);\n      onClose?.();\n    }, exitDelay);\n  }, [exitDelay, onClose]);\n\n  // Escape and the popover's own close are FINAL: nothing still pending may\n  // reopen the card behind them. It opens again on the next enter.\n  const handleClose = React.useCallback(() => {\n    clearPending(enterTimeoutRef);\n    clearPending(exitTimeoutRef);\n    setIsOpen(false);\n    setAnchorEl(null);\n    onClose?.();\n  }, [onClose]);\n\n  const { triggerHandlers, cardHandlers } = useHoverHandlers({\n    isTouchDevice,\n    touchEnabled,\n    enterDelay,\n    openCard,\n    closeCard,\n    exitTimeoutRef,\n  });\n\n  const insideCard = React.useCallback(() => [anchorEl, contentRef.current], [anchorEl]);\n\n  useEscapeKey(isOpen, handleClose);\n  useClickAway(isOpen, insideCard, handleClose);\n  useClearOnUnmount(enterTimeoutRef, exitTimeoutRef);\n\n  return { anchorEl, isOpen, handleClose, triggerHandlers, cardHandlers, contentRef };\n};\n"],"mappings":"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","names":[]}