@bitrise/bitkit-v2 0.3.427 → 0.3.429

package/dist/components/BitkitTabs/BitkitTabs.js

@@ -165,7 +165,7 @@ var AddButton = forwardRef((props, ref) => {
 });
 AddButton.displayName = "BitkitTabs.AddButton";
 var List = forwardRef((props, ref) => {
-	const { children, id, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, ...rest } = props;
+	const { children, css, id, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, ...rest } = props;
 	const { variant = "line" } = useRootPropsContext();
 	const api = useTabsContext();
 	const styles = useTabsStyles();
@@ -247,7 +247,7 @@ var List = forwardRef((props, ref) => {
 	const hiddenItems = visible ? items.filter((_, i) => !visible.has(i)) : [];
 	return /* @__PURE__ */ jsxs(Box, {
 		ref: setListRef,
-		css: styles.list,
+		css: [styles.list, css],
 		...rest,
 		children: [
 			/* @__PURE__ */ jsx(Tabs.List, {

package/dist/components/BitkitTabs/BitkitTabs.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitTabs.js","names":[],"sources":["../../../lib/components/BitkitTabs/BitkitTabs.tsx"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { createContext, mergeRefs, useSafeLayoutEffect } from '@chakra-ui/react';\nimport { Box } from '@chakra-ui/react/box';\nimport { Menu } from '@chakra-ui/react/menu';\nimport { Portal } from '@chakra-ui/react/portal';\nimport { chakra, useRecipe } from '@chakra-ui/react/styled-system';\nimport { Tabs, useTabsContext, useTabsStyles } from '@chakra-ui/react/tabs';\nimport { Text } from '@chakra-ui/react/text';\nimport {\n  cloneElement,\n  forwardRef,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport { type BitkitIconComponent, IconCross, IconPlus } from '../../icons';\nimport { flattenChildren } from '../../utilities/flattenChildren';\nimport BitkitControlButton, { type BitkitControlButtonProps } from '../BitkitControlButton/BitkitControlButton';\n\n/**\n * Root props. `onValueChange` is re-declared with a concrete `{ value }` arg so the callback\n * parameter is inferred at the call site: the base `Tabs.RootProps` intersection breaks\n * contextual typing, which otherwise leaves consumers' `({ value }) => …` flagged as an\n * implicit `any` under `noImplicitAny`.\n */\nexport type BitkitTabsRootProps = Omit<Tabs.RootProps, 'onValueChange'> & {\n  onValueChange?: (details: { value: string }) => void;\n};\n\nexport const [RootPropsProvider, useRootPropsContext] = createContext<BitkitTabsRootProps>({\n  name: 'RootPropsContext',\n  hookName: 'useRootPropsContext',\n  providerName: '<RootProps />',\n});\n\nconst Root = forwardRef<HTMLDivElement, BitkitTabsRootProps>((props, ref) => {\n  return (\n    <RootPropsProvider value={props}>\n      <Tabs.Root ref={ref} {...props} />\n    </RootPropsProvider>\n  );\n});\n\n/** Status-dot colors for the `canvas` variant. */\nexport type BitkitTabsStatusColor = 'neutral' | 'purple' | 'red' | 'yellow';\n\nconst STATUS_COLOR_TOKEN: Record<BitkitTabsStatusColor, string> = {\n  neutral: 'color/neutral/muted',\n  purple: 'interactive/bold',\n  red: 'color/red/base',\n  yellow: 'color/yellow/bold',\n};\n\ntype TriggerProps = Tabs.TriggerProps & {\n  badge?: ReactNode;\n  children?: string;\n  icon?: BitkitIconComponent;\n  /** `canvas` variant only — when provided, a close button reveals on hover and calls this handler when clicked. */\n  onClose?: () => void;\n  secondaryText?: ReactNode;\n  /** `canvas` variant only — shows a status indicator dot. When hovered (and `onClose` is set), the close button replaces it. */\n  statusColor?: BitkitTabsStatusColor;\n};\n\nRoot.displayName = 'BitkitTabs.Root';\n\nconst Trigger = forwardRef<HTMLButtonElement, TriggerProps>((props, ref) => {\n  const { badge, children, className, icon: Icon, onClose, onKeyDown, secondaryText, statusColor, ...rest } = props;\n  // Mirror the recipe's defaultVariant so an unset `variant` renders the line layout (not the\n  // contained one) — otherwise an undefined variant would fall through to the contained branch.\n  const { variant = 'line' } = useRootPropsContext();\n  const closeButtonRecipe = useRecipe({ key: 'closeButton' });\n\n  // Close button and status dot are exclusive to the canvas variant.\n  const isCanvas = variant === 'canvas';\n  const closable = isCanvas && !!onClose && !rest.disabled;\n  const hasStatus = isCanvas && !!statusColor && !rest.disabled;\n  const showTrailing = closable || hasStatus;\n  const mergedClassName = showTrailing ? (className ? `group ${className}` : 'group') : className;\n  // The close button is always visible when there is no status dot; when the dot is shown it is\n  // revealed on hover/focus instead (replacing the dot).\n  const revealCloseOnInteraction = closable && hasStatus;\n  const revealOnInteraction = { opacity: 1, pointerEvents: 'auto' } as const;\n\n  const handleCloseClick = (event: MouseEvent<HTMLSpanElement>) => {\n    event.stopPropagation();\n    event.preventDefault();\n    onClose?.();\n  };\n\n  // The close control is not in the tab order; keyboard users close the focused tab with Delete/Backspace.\n  const handleTriggerKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (closable && (event.key === 'Delete' || event.key === 'Backspace')) {\n      event.preventDefault();\n      // Move focus to a sibling tab before removal so keyboard navigation can continue.\n      const trigger = event.currentTarget;\n      // Skip overflowed (`hidden`) tabs — they aren't focusable.\n      const triggers = [\n        ...(trigger.closest('[role=\"tablist\"]')?.querySelectorAll<HTMLElement>('[role=\"tab\"]:not([hidden])') ?? []),\n      ];\n      const index = triggers.indexOf(trigger);\n      (triggers[index + 1] ?? triggers[index - 1])?.focus();\n      onClose?.();\n    }\n    onKeyDown?.(event);\n  };\n\n  const trailing = showTrailing ? (\n    <chakra.span\n      position=\"relative\"\n      display=\"flex\"\n      alignItems=\"center\"\n      justifyContent=\"center\"\n      boxSize=\"24\"\n      flexShrink={0}\n    >\n      {hasStatus && statusColor && (\n        <chakra.span\n          position=\"absolute\"\n          inset={0}\n          display=\"flex\"\n          alignItems=\"center\"\n          justifyContent=\"center\"\n          pointerEvents=\"none\"\n          transition=\"opacity 0.1s\"\n          _groupHover={closable ? { opacity: 0 } : undefined}\n          _groupFocusWithin={closable ? { opacity: 0 } : undefined}\n        >\n          <chakra.span boxSize=\"8\" borderRadius=\"full\" backgroundColor={STATUS_COLOR_TOKEN[statusColor]} />\n        </chakra.span>\n      )}\n      {closable && (\n        <chakra.span\n          aria-hidden\n          tabIndex={-1}\n          onClick={handleCloseClick}\n          css={closeButtonRecipe({ size: 'xs' })}\n          position=\"absolute\"\n          inset={0}\n          color=\"icon/primary\"\n          opacity={revealCloseOnInteraction ? 0 : 1}\n          pointerEvents={revealCloseOnInteraction ? 'none' : 'auto'}\n          transition=\"opacity 0.1s\"\n          _groupHover={revealCloseOnInteraction ? revealOnInteraction : undefined}\n          _groupFocusWithin={revealCloseOnInteraction ? revealOnInteraction : undefined}\n        >\n          <IconCross size=\"16\" />\n        </chakra.span>\n      )}\n    </chakra.span>\n  ) : null;\n\n  return (\n    <Tabs.Trigger\n      ref={ref}\n      {...rest}\n      className={mergedClassName}\n      gap={isCanvas ? '4' : showTrailing ? '12' : undefined}\n      onKeyDown={handleTriggerKeyDown}\n      paddingInlineEnd={isCanvas ? (showTrailing ? '8' : undefined) : showTrailing ? '12' : undefined}\n      paddingInlineStart={isCanvas && Icon ? '8' : undefined}\n    >\n      {isCanvas ? (\n        <>\n          <Box display=\"flex\" alignItems=\"center\" gap=\"8\">\n            {Icon && <Icon size=\"16\" />}\n            {children}\n          </Box>\n          {trailing}\n        </>\n      ) : variant === 'line' ? (\n        <>\n          <Box display=\"flex\" alignItems=\"center\" gap=\"8\">\n            {Icon && <Icon size=\"24\" />}\n            {children}\n            {badge}\n          </Box>\n          {trailing}\n        </>\n      ) : (\n        <>\n          <Box display=\"flex\" gap=\"16\">\n            {children}\n            {badge}\n            {Icon && <Icon size=\"24\" />}\n          </Box>\n          {!!secondaryText && (\n            <Text as=\"span\" textStyle=\"body/md/regular\" color={rest.disabled ? 'text/on-disabled' : 'text/secondary'}>\n              {secondaryText}\n            </Text>\n          )}\n          {trailing}\n        </>\n      )}\n    </Tabs.Trigger>\n  );\n});\n\nTrigger.displayName = 'BitkitTabs.Trigger';\n\ntype TabItem = ReactElement<TriggerProps>;\n\n// Returns the set of visible tab indices for the overflow, always keeping the selected tab\n// visible: if it would overflow, it takes the last visible slot.\nconst getVisibleIndices = (total: number, count: number, selectedIndex: number) => {\n  const visible = new Set<number>();\n  for (let i = 0; i < count; i += 1) visible.add(i);\n  if (selectedIndex >= 0 && selectedIndex < total && !visible.has(selectedIndex)) {\n    visible.delete(count - 1);\n    visible.add(selectedIndex);\n  }\n  return visible;\n};\n\nexport type BitkitTabsAddButtonProps = Omit<\n  Extract<BitkitControlButtonProps, { href?: undefined }>,\n  'icon' | 'label' | 'size'\n> & {\n  /** Accessible label / tooltip for the add button. */\n  label?: string;\n};\n\n// \"+\" button to add a tab. Place it as a child of `List`; it always renders at the end of the row\n// (after the overflow menu). A compact `xxs` control button (16px icon, 4px padding) per the design.\nconst AddButton = forwardRef<HTMLButtonElement, BitkitTabsAddButtonProps>((props, ref) => {\n  const { label = 'Add tab', ...rest } = props;\n  return <BitkitControlButton ref={ref} icon={IconPlus} label={label} size=\"xxs\" {...rest} />;\n});\n\nAddButton.displayName = 'BitkitTabs.AddButton';\n\n// Overflow-aware List (all variants): measures the tabs and collapses the overflowing ones into a\n// \"N more…\" menu. The more-button look comes from the variant's `moreTrigger` recipe slot.\nconst List = forwardRef<HTMLDivElement, Tabs.ListProps>((props, ref) => {\n  // Semantic/labelling attributes belong on the actual tablist, not the visual wrapper.\n  const { children, id, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ...rest } = props;\n  const { variant = 'line' } = useRootPropsContext();\n  const api = useTabsContext();\n  const styles = useTabsStyles();\n\n  // Split children: tab triggers participate in overflow; the optional add button always renders last.\n  const allChildren = flattenChildren(children);\n  const addButton = allChildren.find((child) => child.type === AddButton) ?? null;\n  // Only Trigger elements are measured/overflowed; anything else (fragments, stray nodes) is ignored.\n  const items = allChildren.filter((child) => child.type === Trigger) as TabItem[];\n  // Re-measure whenever the tab set OR any width-affecting input changes — the variant, each tab's\n  // value/label, icon/status/close/disabled state, and badge/secondaryText content (best-effort\n  // string form, so width-changing text like \"3 errors\" → \"12 errors\" invalidates the cache).\n  const measureKey =\n    variant +\n    items\n      .map((item) => {\n        const p = item.props;\n        return [\n          p.value,\n          String(p.children),\n          p.icon ? 'i' : '',\n          p.badge ? String(p.badge) : '',\n          p.secondaryText ? String(p.secondaryText) : '',\n          p.statusColor ?? '',\n          p.onClose ? 'c' : '',\n          p.disabled ? 'd' : '',\n        ].join(':');\n      })\n      .join('|');\n  const selectedIndex = items.findIndex((item) => item.props.value === api.value);\n  // Conservative width reservations: the more button (wider for the lg/semibold variants) and the\n  // always-visible add button.\n  const moreReserve = variant === 'canvas' ? 100 : 140;\n  const addReserve = addButton ? 48 : 0;\n\n  const listRef = useRef<HTMLDivElement | null>(null);\n  const widthsRef = useRef<number[]>([]);\n  // Horizontal padding of the list, cached during the measure pass so the resize hot path doesn't\n  // call getComputedStyle on every tick.\n  const paddingRef = useRef(0);\n  // `measuredKey` is state (not a ref) so finishing the measure pass always re-renders and flips\n  // `measuring` off — even when recompute keeps the same visibleCount (which would skip a re-render).\n  const [measuredKey, setMeasuredKey] = useState<string | null>(null);\n  const [visibleCount, setVisibleCount] = useState(items.length);\n\n  const setListRef = useMemo(() => mergeRefs(listRef, ref), [ref]);\n\n  const recompute = useCallback(() => {\n    const el = listRef.current;\n    const widths = widthsRef.current;\n    if (!el || !widths.length) return;\n    const available = el.clientWidth - paddingRef.current - addReserve;\n    const totalWidth = widths.reduce((sum, w) => sum + w, 0);\n    if (totalWidth <= available) {\n      setVisibleCount(widths.length);\n      return;\n    }\n    let used = moreReserve;\n    let count = 0;\n    for (let i = 0; i < widths.length; i += 1) {\n      if (used + widths[i] > available) break;\n      used += widths[i];\n      count += 1;\n    }\n    setVisibleCount(Math.max(count, 1));\n  }, [addReserve, moreReserve]);\n\n  // Measure once per width-affecting change (all tabs are rendered visible during this pass).\n  // Isomorphic layout effect: avoids the SSR \"useLayoutEffect does nothing on the server\" warning.\n  const measuring = measuredKey !== measureKey;\n  useSafeLayoutEffect(() => {\n    const el = listRef.current;\n    if (!el) return;\n    if (measuredKey !== measureKey) {\n      const tabEls = el.querySelectorAll<HTMLElement>('[data-tab-trigger]');\n      widthsRef.current = Array.from(tabEls, (node) => node.offsetWidth);\n      const cs = getComputedStyle(el);\n      paddingRef.current = parseFloat(cs.paddingLeft) + parseFloat(cs.paddingRight);\n      setMeasuredKey(measureKey);\n    }\n    recompute();\n  }, [measureKey, measuredKey, recompute]);\n\n  useEffect(() => {\n    const el = listRef.current;\n    if (!el || typeof ResizeObserver === 'undefined') return;\n    // Coalesce resize bursts into one recompute per frame to avoid a read/write layout storm.\n    let raf = 0;\n    const observer = new ResizeObserver(() => {\n      cancelAnimationFrame(raf);\n      raf = requestAnimationFrame(recompute);\n    });\n    observer.observe(el);\n    return () => {\n      cancelAnimationFrame(raf);\n      observer.disconnect();\n    };\n  }, [recompute]);\n\n  const showAll = measuring || visibleCount >= items.length;\n  const visible = showAll ? null : getVisibleIndices(items.length, visibleCount, selectedIndex);\n  const hiddenItems = visible ? items.filter((_, i) => !visible.has(i)) : [];\n\n  return (\n    // The visual row carries the list styling (background, baseline border, leading padding) and is\n    // measured for overflow. The tablist itself only wraps the tabs (`display: contents` keeps the\n    // flex layout intact), so the more/add controls stay outside `role=\"tablist\"` per the ARIA spec.\n    <Box ref={setListRef} css={styles.list} {...rest}>\n      <Tabs.List display=\"contents\" id={id} aria-label={ariaLabel} aria-labelledby={ariaLabelledby}>\n        {items.map((item, i) =>\n          cloneElement(item, {\n            key: item.props.value,\n            'data-tab-trigger': '',\n            hidden: visible ? !visible.has(i) : undefined,\n          } as Partial<TriggerProps>),\n        )}\n      </Tabs.List>\n      {hiddenItems.length > 0 && (\n        <Menu.Root size=\"md\" positioning={{ gutter: 0, shift: -4 }}>\n          <Menu.Trigger asChild>\n            <chakra.button type=\"button\" css={styles.moreTrigger}>\n              {hiddenItems.length} more…\n            </chakra.button>\n          </Menu.Trigger>\n          <Portal>\n            <Menu.Positioner>\n              <Menu.Content>\n                {hiddenItems.map((item) => (\n                  <Menu.Item\n                    key={item.props.value}\n                    value={item.props.value}\n                    disabled={item.props.disabled}\n                    onSelect={() => api.setValue(item.props.value)}\n                    alignItems=\"center\"\n                  >\n                    <Text flex=\"1\" color={item.props.disabled ? 'text/on-disabled' : 'inherit'}>\n                      {item.props.children}\n                    </Text>\n                    {variant === 'canvas' && item.props.statusColor && (\n                      <chakra.span\n                        boxSize=\"8\"\n                        borderRadius=\"full\"\n                        flexShrink={0}\n                        backgroundColor={STATUS_COLOR_TOKEN[item.props.statusColor]}\n                      />\n                    )}\n                  </Menu.Item>\n                ))}\n              </Menu.Content>\n            </Menu.Positioner>\n          </Portal>\n        </Menu.Root>\n      )}\n      {addButton && (\n        <Box display=\"flex\" alignItems=\"center\" flexShrink={0} paddingInline=\"8\">\n          {addButton}\n        </Box>\n      )}\n    </Box>\n  );\n});\n\nList.displayName = 'BitkitTabs.List';\n\nconst BitkitTabs: Omit<typeof Tabs, 'Root' | 'Trigger' | 'List'> & {\n  AddButton: typeof AddButton;\n  List: typeof List;\n  Root: typeof Root;\n  Trigger: typeof Trigger;\n} = {\n  ...Tabs,\n  AddButton,\n  List,\n  Root,\n  Trigger,\n};\n\nBitkitTabs.Content.displayName = 'BitkitTabs.Content';\nBitkitTabs.ContentGroup.displayName = 'BitkitTabs.ContentGroup';\nBitkitTabs.Root.displayName = 'BitkitTabs.Root';\n\nexport default BitkitTabs;\n"],"mappings":"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"}
+{"version":3,"file":"BitkitTabs.js","names":[],"sources":["../../../lib/components/BitkitTabs/BitkitTabs.tsx"],"sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { createContext, mergeRefs, useSafeLayoutEffect } from '@chakra-ui/react';\nimport { Box } from '@chakra-ui/react/box';\nimport { Menu } from '@chakra-ui/react/menu';\nimport { Portal } from '@chakra-ui/react/portal';\nimport { chakra, useRecipe } from '@chakra-ui/react/styled-system';\nimport { Tabs, useTabsContext, useTabsStyles } from '@chakra-ui/react/tabs';\nimport { Text } from '@chakra-ui/react/text';\nimport {\n  cloneElement,\n  forwardRef,\n  type KeyboardEvent,\n  type MouseEvent,\n  type ReactElement,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\n\nimport { type BitkitIconComponent, IconCross, IconPlus } from '../../icons';\nimport { flattenChildren } from '../../utilities/flattenChildren';\nimport BitkitControlButton, { type BitkitControlButtonProps } from '../BitkitControlButton/BitkitControlButton';\n\n/**\n * Root props. `onValueChange` is re-declared with a concrete `{ value }` arg so the callback\n * parameter is inferred at the call site: the base `Tabs.RootProps` intersection breaks\n * contextual typing, which otherwise leaves consumers' `({ value }) => …` flagged as an\n * implicit `any` under `noImplicitAny`.\n */\nexport type BitkitTabsRootProps = Omit<Tabs.RootProps, 'onValueChange'> & {\n  onValueChange?: (details: { value: string }) => void;\n};\n\nexport const [RootPropsProvider, useRootPropsContext] = createContext<BitkitTabsRootProps>({\n  name: 'RootPropsContext',\n  hookName: 'useRootPropsContext',\n  providerName: '<RootProps />',\n});\n\nconst Root = forwardRef<HTMLDivElement, BitkitTabsRootProps>((props, ref) => {\n  return (\n    <RootPropsProvider value={props}>\n      <Tabs.Root ref={ref} {...props} />\n    </RootPropsProvider>\n  );\n});\n\n/** Status-dot colors for the `canvas` variant. */\nexport type BitkitTabsStatusColor = 'neutral' | 'purple' | 'red' | 'yellow';\n\nconst STATUS_COLOR_TOKEN: Record<BitkitTabsStatusColor, string> = {\n  neutral: 'color/neutral/muted',\n  purple: 'interactive/bold',\n  red: 'color/red/base',\n  yellow: 'color/yellow/bold',\n};\n\ntype TriggerProps = Tabs.TriggerProps & {\n  badge?: ReactNode;\n  children?: string;\n  icon?: BitkitIconComponent;\n  /** `canvas` variant only — when provided, a close button reveals on hover and calls this handler when clicked. */\n  onClose?: () => void;\n  secondaryText?: ReactNode;\n  /** `canvas` variant only — shows a status indicator dot. When hovered (and `onClose` is set), the close button replaces it. */\n  statusColor?: BitkitTabsStatusColor;\n};\n\nRoot.displayName = 'BitkitTabs.Root';\n\nconst Trigger = forwardRef<HTMLButtonElement, TriggerProps>((props, ref) => {\n  const { badge, children, className, icon: Icon, onClose, onKeyDown, secondaryText, statusColor, ...rest } = props;\n  // Mirror the recipe's defaultVariant so an unset `variant` renders the line layout (not the\n  // contained one) — otherwise an undefined variant would fall through to the contained branch.\n  const { variant = 'line' } = useRootPropsContext();\n  const closeButtonRecipe = useRecipe({ key: 'closeButton' });\n\n  // Close button and status dot are exclusive to the canvas variant.\n  const isCanvas = variant === 'canvas';\n  const closable = isCanvas && !!onClose && !rest.disabled;\n  const hasStatus = isCanvas && !!statusColor && !rest.disabled;\n  const showTrailing = closable || hasStatus;\n  const mergedClassName = showTrailing ? (className ? `group ${className}` : 'group') : className;\n  // The close button is always visible when there is no status dot; when the dot is shown it is\n  // revealed on hover/focus instead (replacing the dot).\n  const revealCloseOnInteraction = closable && hasStatus;\n  const revealOnInteraction = { opacity: 1, pointerEvents: 'auto' } as const;\n\n  const handleCloseClick = (event: MouseEvent<HTMLSpanElement>) => {\n    event.stopPropagation();\n    event.preventDefault();\n    onClose?.();\n  };\n\n  // The close control is not in the tab order; keyboard users close the focused tab with Delete/Backspace.\n  const handleTriggerKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (closable && (event.key === 'Delete' || event.key === 'Backspace')) {\n      event.preventDefault();\n      // Move focus to a sibling tab before removal so keyboard navigation can continue.\n      const trigger = event.currentTarget;\n      // Skip overflowed (`hidden`) tabs — they aren't focusable.\n      const triggers = [\n        ...(trigger.closest('[role=\"tablist\"]')?.querySelectorAll<HTMLElement>('[role=\"tab\"]:not([hidden])') ?? []),\n      ];\n      const index = triggers.indexOf(trigger);\n      (triggers[index + 1] ?? triggers[index - 1])?.focus();\n      onClose?.();\n    }\n    onKeyDown?.(event);\n  };\n\n  const trailing = showTrailing ? (\n    <chakra.span\n      position=\"relative\"\n      display=\"flex\"\n      alignItems=\"center\"\n      justifyContent=\"center\"\n      boxSize=\"24\"\n      flexShrink={0}\n    >\n      {hasStatus && statusColor && (\n        <chakra.span\n          position=\"absolute\"\n          inset={0}\n          display=\"flex\"\n          alignItems=\"center\"\n          justifyContent=\"center\"\n          pointerEvents=\"none\"\n          transition=\"opacity 0.1s\"\n          _groupHover={closable ? { opacity: 0 } : undefined}\n          _groupFocusWithin={closable ? { opacity: 0 } : undefined}\n        >\n          <chakra.span boxSize=\"8\" borderRadius=\"full\" backgroundColor={STATUS_COLOR_TOKEN[statusColor]} />\n        </chakra.span>\n      )}\n      {closable && (\n        <chakra.span\n          aria-hidden\n          tabIndex={-1}\n          onClick={handleCloseClick}\n          css={closeButtonRecipe({ size: 'xs' })}\n          position=\"absolute\"\n          inset={0}\n          color=\"icon/primary\"\n          opacity={revealCloseOnInteraction ? 0 : 1}\n          pointerEvents={revealCloseOnInteraction ? 'none' : 'auto'}\n          transition=\"opacity 0.1s\"\n          _groupHover={revealCloseOnInteraction ? revealOnInteraction : undefined}\n          _groupFocusWithin={revealCloseOnInteraction ? revealOnInteraction : undefined}\n        >\n          <IconCross size=\"16\" />\n        </chakra.span>\n      )}\n    </chakra.span>\n  ) : null;\n\n  return (\n    <Tabs.Trigger\n      ref={ref}\n      {...rest}\n      className={mergedClassName}\n      gap={isCanvas ? '4' : showTrailing ? '12' : undefined}\n      onKeyDown={handleTriggerKeyDown}\n      paddingInlineEnd={isCanvas ? (showTrailing ? '8' : undefined) : showTrailing ? '12' : undefined}\n      paddingInlineStart={isCanvas && Icon ? '8' : undefined}\n    >\n      {isCanvas ? (\n        <>\n          <Box display=\"flex\" alignItems=\"center\" gap=\"8\">\n            {Icon && <Icon size=\"16\" />}\n            {children}\n          </Box>\n          {trailing}\n        </>\n      ) : variant === 'line' ? (\n        <>\n          <Box display=\"flex\" alignItems=\"center\" gap=\"8\">\n            {Icon && <Icon size=\"24\" />}\n            {children}\n            {badge}\n          </Box>\n          {trailing}\n        </>\n      ) : (\n        <>\n          <Box display=\"flex\" gap=\"16\">\n            {children}\n            {badge}\n            {Icon && <Icon size=\"24\" />}\n          </Box>\n          {!!secondaryText && (\n            <Text as=\"span\" textStyle=\"body/md/regular\" color={rest.disabled ? 'text/on-disabled' : 'text/secondary'}>\n              {secondaryText}\n            </Text>\n          )}\n          {trailing}\n        </>\n      )}\n    </Tabs.Trigger>\n  );\n});\n\nTrigger.displayName = 'BitkitTabs.Trigger';\n\ntype TabItem = ReactElement<TriggerProps>;\n\n// Returns the set of visible tab indices for the overflow, always keeping the selected tab\n// visible: if it would overflow, it takes the last visible slot.\nconst getVisibleIndices = (total: number, count: number, selectedIndex: number) => {\n  const visible = new Set<number>();\n  for (let i = 0; i < count; i += 1) visible.add(i);\n  if (selectedIndex >= 0 && selectedIndex < total && !visible.has(selectedIndex)) {\n    visible.delete(count - 1);\n    visible.add(selectedIndex);\n  }\n  return visible;\n};\n\nexport type BitkitTabsAddButtonProps = Omit<\n  Extract<BitkitControlButtonProps, { href?: undefined }>,\n  'icon' | 'label' | 'size'\n> & {\n  /** Accessible label / tooltip for the add button. */\n  label?: string;\n};\n\n// \"+\" button to add a tab. Place it as a child of `List`; it always renders at the end of the row\n// (after the overflow menu). A compact `xxs` control button (16px icon, 4px padding) per the design.\nconst AddButton = forwardRef<HTMLButtonElement, BitkitTabsAddButtonProps>((props, ref) => {\n  const { label = 'Add tab', ...rest } = props;\n  return <BitkitControlButton ref={ref} icon={IconPlus} label={label} size=\"xxs\" {...rest} />;\n});\n\nAddButton.displayName = 'BitkitTabs.AddButton';\n\n// Overflow-aware List (all variants): measures the tabs and collapses the overflowing ones into a\n// \"N more…\" menu. The more-button look comes from the variant's `moreTrigger` recipe slot.\nconst List = forwardRef<HTMLDivElement, Tabs.ListProps>((props, ref) => {\n  // Semantic/labelling attributes belong on the actual tablist, not the visual wrapper.\n  const { children, css, id, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ...rest } = props;\n  const { variant = 'line' } = useRootPropsContext();\n  const api = useTabsContext();\n  const styles = useTabsStyles();\n\n  // Split children: tab triggers participate in overflow; the optional add button always renders last.\n  const allChildren = flattenChildren(children);\n  const addButton = allChildren.find((child) => child.type === AddButton) ?? null;\n  // Only Trigger elements are measured/overflowed; anything else (fragments, stray nodes) is ignored.\n  const items = allChildren.filter((child) => child.type === Trigger) as TabItem[];\n  // Re-measure whenever the tab set OR any width-affecting input changes — the variant, each tab's\n  // value/label, icon/status/close/disabled state, and badge/secondaryText content (best-effort\n  // string form, so width-changing text like \"3 errors\" → \"12 errors\" invalidates the cache).\n  const measureKey =\n    variant +\n    items\n      .map((item) => {\n        const p = item.props;\n        return [\n          p.value,\n          String(p.children),\n          p.icon ? 'i' : '',\n          p.badge ? String(p.badge) : '',\n          p.secondaryText ? String(p.secondaryText) : '',\n          p.statusColor ?? '',\n          p.onClose ? 'c' : '',\n          p.disabled ? 'd' : '',\n        ].join(':');\n      })\n      .join('|');\n  const selectedIndex = items.findIndex((item) => item.props.value === api.value);\n  // Conservative width reservations: the more button (wider for the lg/semibold variants) and the\n  // always-visible add button.\n  const moreReserve = variant === 'canvas' ? 100 : 140;\n  const addReserve = addButton ? 48 : 0;\n\n  const listRef = useRef<HTMLDivElement | null>(null);\n  const widthsRef = useRef<number[]>([]);\n  // Horizontal padding of the list, cached during the measure pass so the resize hot path doesn't\n  // call getComputedStyle on every tick.\n  const paddingRef = useRef(0);\n  // `measuredKey` is state (not a ref) so finishing the measure pass always re-renders and flips\n  // `measuring` off — even when recompute keeps the same visibleCount (which would skip a re-render).\n  const [measuredKey, setMeasuredKey] = useState<string | null>(null);\n  const [visibleCount, setVisibleCount] = useState(items.length);\n\n  const setListRef = useMemo(() => mergeRefs(listRef, ref), [ref]);\n\n  const recompute = useCallback(() => {\n    const el = listRef.current;\n    const widths = widthsRef.current;\n    if (!el || !widths.length) return;\n    const available = el.clientWidth - paddingRef.current - addReserve;\n    const totalWidth = widths.reduce((sum, w) => sum + w, 0);\n    if (totalWidth <= available) {\n      setVisibleCount(widths.length);\n      return;\n    }\n    let used = moreReserve;\n    let count = 0;\n    for (let i = 0; i < widths.length; i += 1) {\n      if (used + widths[i] > available) break;\n      used += widths[i];\n      count += 1;\n    }\n    setVisibleCount(Math.max(count, 1));\n  }, [addReserve, moreReserve]);\n\n  // Measure once per width-affecting change (all tabs are rendered visible during this pass).\n  // Isomorphic layout effect: avoids the SSR \"useLayoutEffect does nothing on the server\" warning.\n  const measuring = measuredKey !== measureKey;\n  useSafeLayoutEffect(() => {\n    const el = listRef.current;\n    if (!el) return;\n    if (measuredKey !== measureKey) {\n      const tabEls = el.querySelectorAll<HTMLElement>('[data-tab-trigger]');\n      widthsRef.current = Array.from(tabEls, (node) => node.offsetWidth);\n      const cs = getComputedStyle(el);\n      paddingRef.current = parseFloat(cs.paddingLeft) + parseFloat(cs.paddingRight);\n      setMeasuredKey(measureKey);\n    }\n    recompute();\n  }, [measureKey, measuredKey, recompute]);\n\n  useEffect(() => {\n    const el = listRef.current;\n    if (!el || typeof ResizeObserver === 'undefined') return;\n    // Coalesce resize bursts into one recompute per frame to avoid a read/write layout storm.\n    let raf = 0;\n    const observer = new ResizeObserver(() => {\n      cancelAnimationFrame(raf);\n      raf = requestAnimationFrame(recompute);\n    });\n    observer.observe(el);\n    return () => {\n      cancelAnimationFrame(raf);\n      observer.disconnect();\n    };\n  }, [recompute]);\n\n  const showAll = measuring || visibleCount >= items.length;\n  const visible = showAll ? null : getVisibleIndices(items.length, visibleCount, selectedIndex);\n  const hiddenItems = visible ? items.filter((_, i) => !visible.has(i)) : [];\n\n  return (\n    // The visual row carries the list styling (background, baseline border, leading padding) and is\n    // measured for overflow. The tablist itself only wraps the tabs (`display: contents` keeps the\n    // flex layout intact), so the more/add controls stay outside `role=\"tablist\"` per the ARIA spec.\n    <Box ref={setListRef} css={[styles.list, css]} {...rest}>\n      <Tabs.List display=\"contents\" id={id} aria-label={ariaLabel} aria-labelledby={ariaLabelledby}>\n        {items.map((item, i) =>\n          cloneElement(item, {\n            key: item.props.value,\n            'data-tab-trigger': '',\n            hidden: visible ? !visible.has(i) : undefined,\n          } as Partial<TriggerProps>),\n        )}\n      </Tabs.List>\n      {hiddenItems.length > 0 && (\n        <Menu.Root size=\"md\" positioning={{ gutter: 0, shift: -4 }}>\n          <Menu.Trigger asChild>\n            <chakra.button type=\"button\" css={styles.moreTrigger}>\n              {hiddenItems.length} more…\n            </chakra.button>\n          </Menu.Trigger>\n          <Portal>\n            <Menu.Positioner>\n              <Menu.Content>\n                {hiddenItems.map((item) => (\n                  <Menu.Item\n                    key={item.props.value}\n                    value={item.props.value}\n                    disabled={item.props.disabled}\n                    onSelect={() => api.setValue(item.props.value)}\n                    alignItems=\"center\"\n                  >\n                    <Text flex=\"1\" color={item.props.disabled ? 'text/on-disabled' : 'inherit'}>\n                      {item.props.children}\n                    </Text>\n                    {variant === 'canvas' && item.props.statusColor && (\n                      <chakra.span\n                        boxSize=\"8\"\n                        borderRadius=\"full\"\n                        flexShrink={0}\n                        backgroundColor={STATUS_COLOR_TOKEN[item.props.statusColor]}\n                      />\n                    )}\n                  </Menu.Item>\n                ))}\n              </Menu.Content>\n            </Menu.Positioner>\n          </Portal>\n        </Menu.Root>\n      )}\n      {addButton && (\n        <Box display=\"flex\" alignItems=\"center\" flexShrink={0} paddingInline=\"8\">\n          {addButton}\n        </Box>\n      )}\n    </Box>\n  );\n});\n\nList.displayName = 'BitkitTabs.List';\n\nconst BitkitTabs: Omit<typeof Tabs, 'Root' | 'Trigger' | 'List'> & {\n  AddButton: typeof AddButton;\n  List: typeof List;\n  Root: typeof Root;\n  Trigger: typeof Trigger;\n} = {\n  ...Tabs,\n  AddButton,\n  List,\n  Root,\n  Trigger,\n};\n\nBitkitTabs.Content.displayName = 'BitkitTabs.Content';\nBitkitTabs.ContentGroup.displayName = 'BitkitTabs.ContentGroup';\nBitkitTabs.Root.displayName = 'BitkitTabs.Root';\n\nexport default BitkitTabs;\n"],"mappings":"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"}

package/dist/components/BitkitTextInput/BitkitTextInput.js

@@ -28,7 +28,7 @@ var BitkitTextInput = forwardRef((props, ref) => {
 		size: iconSize
 	});
 	else if (hasWarning) statusIcon = /* @__PURE__ */ jsx(IconWarningYellow, { size: iconSize });
-	const { onChange: inputOnChange, value: inputValue, ...restInputProps } = inputProps ?? {};
+	const { css: inputCss, onChange: inputOnChange, value: inputValue, ...restInputProps } = inputProps ?? {};
 	const resolvedValue = inputValue ?? value;
 	const nativeOnChange = inputOnChange ?? onChange;
 	const handleChange = onValueChange || nativeOnChange ? (event) => {
@@ -69,7 +69,7 @@ var BitkitTextInput = forwardRef((props, ref) => {
 							children: startElement
 						}),
 						/* @__PURE__ */ jsx(Input, {
-							css: styles.input,
+							css: [styles.input, inputCss],
 							maxLength,
 							onChange: handleChange,
 							placeholder,

package/dist/components/BitkitTextInput/BitkitTextInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"BitkitTextInput.js","names":[],"sources":["../../../lib/components/BitkitTextInput/BitkitTextInput.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport { Group } from '@chakra-ui/react/group';\nimport { Input, type InputProps } from '@chakra-ui/react/input';\nimport { InputAddon, type InputAddonProps } from '@chakra-ui/react/input-addon';\nimport { useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { type ChangeEventHandler, forwardRef, type ReactNode } from 'react';\n\nimport { IconErrorCircleFilled, IconWarningYellow } from '../../icons';\nimport BitkitField, { type BitkitFieldProps } from '../BitkitField/BitkitField';\n\nexport interface BitkitTextInputProps extends Omit<BitkitFieldProps, 'children' | 'onChange' | 'state' | 'value'> {\n  /**\n   * Show a live character counter (`length/maxLength`) next to the label. Requires `maxLength` and a\n   * known `value`.\n   */\n  counter?: boolean;\n  /** Content attached to the trailing edge, outside the input border (e.g. a unit label or button). */\n  endAddon?: ReactNode;\n  /** Props forwarded to the trailing `InputAddon` wrapper. */\n  endAddonProps?: InputAddonProps;\n  /** Inline content rendered inside the input, at the trailing edge (e.g. an icon or reveal button). */\n  endElement?: ReactNode;\n  /**\n   * Escape hatch for the underlying Chakra `Input` — extra native attributes or a spread\n   * `{...register()}`. On conflict, values here win over the top-level `value`/`onChange`.\n   */\n  inputProps?: InputProps;\n  /** Maximum number of characters accepted; also feeds the optional `counter`. */\n  maxLength?: HTMLInputElement['maxLength'];\n  /**\n   * Native change event — the same handler you could put on `inputProps`, promoted to the top level.\n   * Reach for `onValueChange` when you only need the value. If both this and `inputProps.onChange` are\n   * set, `inputProps.onChange` wins (it's the same event, so they shouldn't both be set).\n   */\n  onChange?: ChangeEventHandler<HTMLInputElement>;\n  /** Convenience change handler that receives the value directly, without `event.target.value`. */\n  onValueChange?: (value: string) => void;\n  /** Placeholder text shown while the field is empty. */\n  placeholder?: string;\n  /** Field size — controls height and typography. */\n  size?: 'md' | 'lg';\n  /** Content attached to the leading edge, outside the input border (e.g. a unit label or button). */\n  startAddon?: ReactNode;\n  /** Props forwarded to the leading `InputAddon` wrapper. */\n  startAddonProps?: InputAddonProps;\n  /** Inline content rendered inside the input, at the leading edge (e.g. an icon). */\n  startElement?: ReactNode;\n  /**\n   * Field state. `error`/`warning` are also implied by `errorText`/`warningText`; `disabled` and\n   * `readOnly` gate interaction.\n   */\n  state?: 'disabled' | 'error' | 'readOnly' | 'warning';\n  /**\n   * Controlled value. Pair with `onValueChange` or `onChange`. Can also be supplied via `inputProps`,\n   * which wins on conflict.\n   */\n  value?: string;\n}\n\n/**\n * A single-line text field wrapping the native `<input>`, with a label and helper/error/warning\n * text. Reflect the value with `value` + `onValueChange` (or the native `onChange`); `inputProps` is\n * the escape hatch for any other native attribute. `startAddon`/`endAddon` sit outside the border,\n * `startElement`/`endElement` inline inside it, and `counter` pairs with `maxLength`.\n */\nconst BitkitTextInput = forwardRef<HTMLDivElement, BitkitTextInputProps>((props, ref) => {\n  const {\n    counter,\n    endAddon,\n    endAddonProps,\n    endElement,\n    inputProps,\n    maxLength,\n    onChange,\n    onValueChange,\n    placeholder,\n    size = 'lg',\n    startAddon,\n    startAddonProps,\n    startElement,\n    state,\n    value,\n    ...rest\n  } = props;\n\n  const recipe = useSlotRecipe({ key: 'textInput' });\n  const styles = recipe({ size });\n\n  const iconSize = size === 'md' ? '16' : '24';\n  const addonSize = size === 'md' ? 'md' : 'lg';\n\n  const hasWarning = state === 'warning' || !!rest.warningText;\n  const isInvalid = state === 'error' || !!rest.errorText;\n\n  let statusIcon: ReactNode = null;\n  if (isInvalid) {\n    statusIcon = <IconErrorCircleFilled color=\"icon/negative\" size={iconSize} />;\n  } else if (hasWarning) {\n    statusIcon = <IconWarningYellow size={iconSize} />;\n  }\n\n  // `value` / `onChange` may come in at the top level or via `inputProps` — the object wins on\n  // conflict (natural for a spread `{...register()}`). `onValueChange` always fires with the value.\n  const { onChange: inputOnChange, value: inputValue, ...restInputProps } = inputProps ?? {};\n  const resolvedValue = inputValue ?? value;\n  const nativeOnChange = inputOnChange ?? onChange;\n  const handleChange: ChangeEventHandler<HTMLInputElement> | undefined =\n    onValueChange || nativeOnChange\n      ? (event) => {\n          onValueChange?.(event.target.value);\n          nativeOnChange?.(event);\n        }\n      : undefined;\n\n  const counterText =\n    counter && maxLength && resolvedValue !== undefined ? `${resolvedValue.toString().length}/${maxLength}` : undefined;\n\n  const stateAttrs = {\n    'data-disabled': state === 'disabled' ? '' : undefined,\n    'data-invalid': isInvalid ? '' : undefined,\n    'data-readonly': state === 'readOnly' ? '' : undefined,\n  };\n\n  return (\n    <BitkitField counterText={counterText} ref={ref} state={state} {...rest}>\n      <Group attached width=\"100%\">\n        {startAddon != null && (\n          <InputAddon position=\"start\" size={addonSize} {...stateAttrs} {...startAddonProps}>\n            {startAddon}\n          </InputAddon>\n        )}\n        <Box css={styles.field} data-has-end-element={endElement != null ? '' : undefined} flex=\"1\" {...stateAttrs}>\n          {startElement != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {startElement}\n            </Box>\n          )}\n          <Input\n            css={styles.input}\n            maxLength={maxLength}\n            onChange={handleChange}\n            placeholder={placeholder}\n            value={resolvedValue}\n            {...restInputProps}\n            unstyled\n          />\n          {statusIcon != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {statusIcon}\n            </Box>\n          )}\n          {endElement != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {endElement}\n            </Box>\n          )}\n        </Box>\n        {endAddon != null && (\n          <InputAddon position=\"end\" size={addonSize} {...stateAttrs} {...endAddonProps}>\n            {endAddon}\n          </InputAddon>\n        )}\n      </Group>\n    </BitkitField>\n  );\n});\n\nBitkitTextInput.displayName = 'BitkitTextInput';\n\nexport default BitkitTextInput;\n"],"mappings":";;;;;;;;;;;;;;;;;AAiEA,IAAM,kBAAkB,YAAkD,OAAO,QAAQ;CACvF,MAAM,EACJ,SACA,UACA,eACA,YACA,YACA,WACA,UACA,eACA,aACA,OAAO,MACP,YACA,iBACA,cACA,OACA,OACA,GAAG,SACD;CAGJ,MAAM,SADS,cAAc,EAAE,KAAK,YAAY,CACjC,CAAA,CAAO,EAAE,KAAK,CAAC;CAE9B,MAAM,WAAW,SAAS,OAAO,OAAO;CACxC,MAAM,YAAY,SAAS,OAAO,OAAO;CAEzC,MAAM,aAAa,UAAU,aAAa,CAAC,CAAC,KAAK;CACjD,MAAM,YAAY,UAAU,WAAW,CAAC,CAAC,KAAK;CAE9C,IAAI,aAAwB;CAC5B,IAAI,WACF,aAAa,oBAAC,uBAAD;EAAuB,OAAM;EAAgB,MAAM;CAAW,CAAA;MACtE,IAAI,YACT,aAAa,oBAAC,mBAAD,EAAmB,MAAM,SAAW,CAAA;CAKnD,MAAM,EAAE,UAAU,eAAe,OAAO,YAAY,GAAG,mBAAmB,cAAc,CAAC;CACzF,MAAM,gBAAgB,cAAc;CACpC,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,eACJ,iBAAiB,kBACZ,UAAU;EACT,gBAAgB,MAAM,OAAO,KAAK;EAClC,iBAAiB,KAAK;CACxB,IACA,KAAA;CAEN,MAAM,cACJ,WAAW,aAAa,kBAAkB,KAAA,IAAY,GAAG,cAAc,SAAS,CAAC,CAAC,OAAO,GAAG,cAAc,KAAA;CAE5G,MAAM,aAAa;EACjB,iBAAiB,UAAU,aAAa,KAAK,KAAA;EAC7C,gBAAgB,YAAY,KAAK,KAAA;EACjC,iBAAiB,UAAU,aAAa,KAAK,KAAA;CAC/C;CAEA,OACE,oBAAC,aAAD;EAA0B;EAAkB;EAAY;EAAO,GAAI;EACjE,UAAA,qBAAC,OAAD;GAAO,UAAA;GAAS,OAAM;GAAtB,UAAA;IACG,cAAc,QACb,oBAAC,YAAD;KAAY,UAAS;KAAQ,MAAM;KAAW,GAAI;KAAY,GAAI;KAC/D,UAAA;IACS,CAAA;IAEd,qBAAC,KAAD;KAAK,KAAK,OAAO;KAAO,wBAAsB,cAAc,OAAO,KAAK,KAAA;KAAW,MAAK;KAAI,GAAI;KAAhG,UAAA;MACG,gBAAgB,QACf,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;MAEP,oBAAC,OAAD;OACE,KAAK,OAAO;OACD;OACX,UAAU;OACG;OACb,OAAO;OACP,GAAI;OACJ,UAAA;MACD,CAAA;MACA,cAAc,QACb,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;MAEN,cAAc,QACb,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;KAEJ;;IACJ,YAAY,QACX,oBAAC,YAAD;KAAY,UAAS;KAAM,MAAM;KAAW,GAAI;KAAY,GAAI;KAC7D,UAAA;IACS,CAAA;GAET;;CACI,CAAA;AAEjB,CAAC;AAED,gBAAgB,cAAc"}
+{"version":3,"file":"BitkitTextInput.js","names":[],"sources":["../../../lib/components/BitkitTextInput/BitkitTextInput.tsx"],"sourcesContent":["import { Box } from '@chakra-ui/react/box';\nimport { Group } from '@chakra-ui/react/group';\nimport { Input, type InputProps } from '@chakra-ui/react/input';\nimport { InputAddon, type InputAddonProps } from '@chakra-ui/react/input-addon';\nimport { useSlotRecipe } from '@chakra-ui/react/styled-system';\nimport { type ChangeEventHandler, forwardRef, type ReactNode } from 'react';\n\nimport { IconErrorCircleFilled, IconWarningYellow } from '../../icons';\nimport BitkitField, { type BitkitFieldProps } from '../BitkitField/BitkitField';\n\nexport interface BitkitTextInputProps extends Omit<BitkitFieldProps, 'children' | 'onChange' | 'state' | 'value'> {\n  /**\n   * Show a live character counter (`length/maxLength`) next to the label. Requires `maxLength` and a\n   * known `value`.\n   */\n  counter?: boolean;\n  /** Content attached to the trailing edge, outside the input border (e.g. a unit label or button). */\n  endAddon?: ReactNode;\n  /** Props forwarded to the trailing `InputAddon` wrapper. */\n  endAddonProps?: InputAddonProps;\n  /** Inline content rendered inside the input, at the trailing edge (e.g. an icon or reveal button). */\n  endElement?: ReactNode;\n  /**\n   * Escape hatch for the underlying Chakra `Input` — extra native attributes or a spread\n   * `{...register()}`. On conflict, values here win over the top-level `value`/`onChange`.\n   */\n  inputProps?: InputProps;\n  /** Maximum number of characters accepted; also feeds the optional `counter`. */\n  maxLength?: HTMLInputElement['maxLength'];\n  /**\n   * Native change event — the same handler you could put on `inputProps`, promoted to the top level.\n   * Reach for `onValueChange` when you only need the value. If both this and `inputProps.onChange` are\n   * set, `inputProps.onChange` wins (it's the same event, so they shouldn't both be set).\n   */\n  onChange?: ChangeEventHandler<HTMLInputElement>;\n  /** Convenience change handler that receives the value directly, without `event.target.value`. */\n  onValueChange?: (value: string) => void;\n  /** Placeholder text shown while the field is empty. */\n  placeholder?: string;\n  /** Field size — controls height and typography. */\n  size?: 'md' | 'lg';\n  /** Content attached to the leading edge, outside the input border (e.g. a unit label or button). */\n  startAddon?: ReactNode;\n  /** Props forwarded to the leading `InputAddon` wrapper. */\n  startAddonProps?: InputAddonProps;\n  /** Inline content rendered inside the input, at the leading edge (e.g. an icon). */\n  startElement?: ReactNode;\n  /**\n   * Field state. `error`/`warning` are also implied by `errorText`/`warningText`; `disabled` and\n   * `readOnly` gate interaction.\n   */\n  state?: 'disabled' | 'error' | 'readOnly' | 'warning';\n  /**\n   * Controlled value. Pair with `onValueChange` or `onChange`. Can also be supplied via `inputProps`,\n   * which wins on conflict.\n   */\n  value?: string;\n}\n\n/**\n * A single-line text field wrapping the native `<input>`, with a label and helper/error/warning\n * text. Reflect the value with `value` + `onValueChange` (or the native `onChange`); `inputProps` is\n * the escape hatch for any other native attribute. `startAddon`/`endAddon` sit outside the border,\n * `startElement`/`endElement` inline inside it, and `counter` pairs with `maxLength`.\n */\nconst BitkitTextInput = forwardRef<HTMLDivElement, BitkitTextInputProps>((props, ref) => {\n  const {\n    counter,\n    endAddon,\n    endAddonProps,\n    endElement,\n    inputProps,\n    maxLength,\n    onChange,\n    onValueChange,\n    placeholder,\n    size = 'lg',\n    startAddon,\n    startAddonProps,\n    startElement,\n    state,\n    value,\n    ...rest\n  } = props;\n\n  const recipe = useSlotRecipe({ key: 'textInput' });\n  const styles = recipe({ size });\n\n  const iconSize = size === 'md' ? '16' : '24';\n  const addonSize = size === 'md' ? 'md' : 'lg';\n\n  const hasWarning = state === 'warning' || !!rest.warningText;\n  const isInvalid = state === 'error' || !!rest.errorText;\n\n  let statusIcon: ReactNode = null;\n  if (isInvalid) {\n    statusIcon = <IconErrorCircleFilled color=\"icon/negative\" size={iconSize} />;\n  } else if (hasWarning) {\n    statusIcon = <IconWarningYellow size={iconSize} />;\n  }\n\n  // `value` / `onChange` may come in at the top level or via `inputProps` — the object wins on\n  // conflict (natural for a spread `{...register()}`). `onValueChange` always fires with the value.\n  const { css: inputCss, onChange: inputOnChange, value: inputValue, ...restInputProps } = inputProps ?? {};\n  const resolvedValue = inputValue ?? value;\n  const nativeOnChange = inputOnChange ?? onChange;\n  const handleChange: ChangeEventHandler<HTMLInputElement> | undefined =\n    onValueChange || nativeOnChange\n      ? (event) => {\n          onValueChange?.(event.target.value);\n          nativeOnChange?.(event);\n        }\n      : undefined;\n\n  const counterText =\n    counter && maxLength && resolvedValue !== undefined ? `${resolvedValue.toString().length}/${maxLength}` : undefined;\n\n  const stateAttrs = {\n    'data-disabled': state === 'disabled' ? '' : undefined,\n    'data-invalid': isInvalid ? '' : undefined,\n    'data-readonly': state === 'readOnly' ? '' : undefined,\n  };\n\n  return (\n    <BitkitField counterText={counterText} ref={ref} state={state} {...rest}>\n      <Group attached width=\"100%\">\n        {startAddon != null && (\n          <InputAddon position=\"start\" size={addonSize} {...stateAttrs} {...startAddonProps}>\n            {startAddon}\n          </InputAddon>\n        )}\n        <Box css={styles.field} data-has-end-element={endElement != null ? '' : undefined} flex=\"1\" {...stateAttrs}>\n          {startElement != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {startElement}\n            </Box>\n          )}\n          <Input\n            css={[styles.input, inputCss]}\n            maxLength={maxLength}\n            onChange={handleChange}\n            placeholder={placeholder}\n            value={resolvedValue}\n            {...restInputProps}\n            unstyled\n          />\n          {statusIcon != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {statusIcon}\n            </Box>\n          )}\n          {endElement != null && (\n            <Box css={styles.element} {...stateAttrs}>\n              {endElement}\n            </Box>\n          )}\n        </Box>\n        {endAddon != null && (\n          <InputAddon position=\"end\" size={addonSize} {...stateAttrs} {...endAddonProps}>\n            {endAddon}\n          </InputAddon>\n        )}\n      </Group>\n    </BitkitField>\n  );\n});\n\nBitkitTextInput.displayName = 'BitkitTextInput';\n\nexport default BitkitTextInput;\n"],"mappings":";;;;;;;;;;;;;;;;;AAiEA,IAAM,kBAAkB,YAAkD,OAAO,QAAQ;CACvF,MAAM,EACJ,SACA,UACA,eACA,YACA,YACA,WACA,UACA,eACA,aACA,OAAO,MACP,YACA,iBACA,cACA,OACA,OACA,GAAG,SACD;CAGJ,MAAM,SADS,cAAc,EAAE,KAAK,YAAY,CACjC,CAAA,CAAO,EAAE,KAAK,CAAC;CAE9B,MAAM,WAAW,SAAS,OAAO,OAAO;CACxC,MAAM,YAAY,SAAS,OAAO,OAAO;CAEzC,MAAM,aAAa,UAAU,aAAa,CAAC,CAAC,KAAK;CACjD,MAAM,YAAY,UAAU,WAAW,CAAC,CAAC,KAAK;CAE9C,IAAI,aAAwB;CAC5B,IAAI,WACF,aAAa,oBAAC,uBAAD;EAAuB,OAAM;EAAgB,MAAM;CAAW,CAAA;MACtE,IAAI,YACT,aAAa,oBAAC,mBAAD,EAAmB,MAAM,SAAW,CAAA;CAKnD,MAAM,EAAE,KAAK,UAAU,UAAU,eAAe,OAAO,YAAY,GAAG,mBAAmB,cAAc,CAAC;CACxG,MAAM,gBAAgB,cAAc;CACpC,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,eACJ,iBAAiB,kBACZ,UAAU;EACT,gBAAgB,MAAM,OAAO,KAAK;EAClC,iBAAiB,KAAK;CACxB,IACA,KAAA;CAEN,MAAM,cACJ,WAAW,aAAa,kBAAkB,KAAA,IAAY,GAAG,cAAc,SAAS,CAAC,CAAC,OAAO,GAAG,cAAc,KAAA;CAE5G,MAAM,aAAa;EACjB,iBAAiB,UAAU,aAAa,KAAK,KAAA;EAC7C,gBAAgB,YAAY,KAAK,KAAA;EACjC,iBAAiB,UAAU,aAAa,KAAK,KAAA;CAC/C;CAEA,OACE,oBAAC,aAAD;EAA0B;EAAkB;EAAY;EAAO,GAAI;EACjE,UAAA,qBAAC,OAAD;GAAO,UAAA;GAAS,OAAM;GAAtB,UAAA;IACG,cAAc,QACb,oBAAC,YAAD;KAAY,UAAS;KAAQ,MAAM;KAAW,GAAI;KAAY,GAAI;KAC/D,UAAA;IACS,CAAA;IAEd,qBAAC,KAAD;KAAK,KAAK,OAAO;KAAO,wBAAsB,cAAc,OAAO,KAAK,KAAA;KAAW,MAAK;KAAI,GAAI;KAAhG,UAAA;MACG,gBAAgB,QACf,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;MAEP,oBAAC,OAAD;OACE,KAAK,CAAC,OAAO,OAAO,QAAQ;OACjB;OACX,UAAU;OACG;OACb,OAAO;OACP,GAAI;OACJ,UAAA;MACD,CAAA;MACA,cAAc,QACb,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;MAEN,cAAc,QACb,oBAAC,KAAD;OAAK,KAAK,OAAO;OAAS,GAAI;OAC3B,UAAA;MACE,CAAA;KAEJ;;IACJ,YAAY,QACX,oBAAC,YAAD;KAAY,UAAS;KAAM,MAAM;KAAW,GAAI;KAAY,GAAI;KAC7D,UAAA;IACS,CAAA;GAET;;CACI,CAAA;AAEjB,CAAC;AAED,gBAAgB,cAAc"}

package/dist/components/index.d.ts

@@ -50,7 +50,7 @@ export { default as BitkitOverflowContent, type BitkitOverflowContentProps, } fr
 export { default as BitkitOverflowTooltip, type BitkitOverflowTooltipProps, } from './BitkitOverflowTooltip/BitkitOverflowTooltip';
 export { default as BitkitPageFooter, type BitkitPageFooterItemProps, type BitkitPageFooterProps, } from './BitkitPageFooter/BitkitPageFooter';
 export { default as BitkitPageHeader, type BitkitPageHeaderProps } from './BitkitPageHeader/BitkitPageHeader';
-export { default as BitkitPageSidebar, type BitkitPageSidebarBodyProps, type BitkitPageSidebarDividerProps, type BitkitPageSidebarFooterProps, type BitkitPageSidebarGroupHeadingProps, type BitkitPageSidebarItemProps, type BitkitPageSidebarProjectProps, type BitkitPageSidebarProps, type BitkitPageSidebarTitleProps, } from './BitkitPageSidebar/BitkitPageSidebar';
+export { default as BitkitPageSidebar, type BitkitPageSidebarBodyProps, type BitkitPageSidebarDividerProps, type BitkitPageSidebarFooterProps, type BitkitPageSidebarGroupHeadingProps, type BitkitPageSidebarItemProps, type BitkitPageSidebarProgressItemProps, type BitkitPageSidebarProjectProps, type BitkitPageSidebarProps, type BitkitPageSidebarTitleProps, } from './BitkitPageSidebar/BitkitPageSidebar';
 export { default as BitkitPagination, type BitkitPaginationLabels, type BitkitPaginationProps, } from './BitkitPagination/BitkitPagination';
 export { default as BitkitPaginationLoadMore, type BitkitPaginationLoadMoreProps, } from './BitkitPaginationLoadMore/BitkitPaginationLoadMore';
 export { default as BitkitPopover, type BitkitPopoverProps } from './BitkitPopover/BitkitPopover';

package/dist/theme/slot-recipes/PageSidebar.recipe.d.ts

@@ -1,4 +1,4 @@
-declare const pageSidebarSlotRecipe: import('@chakra-ui/react').SlotRecipeDefinition<"body" | "footer" | "title" | "root" | "item" | "titleText" | "suffixIcon" | "titleBlock" | "itemLabel" | "itemIcon" | "contentBlock" | "divider" | "project" | "projectLabel" | "projectValue" | "projectValueWrapper" | "selectionMarker", {
+declare const pageSidebarSlotRecipe: import('@chakra-ui/react').SlotRecipeDefinition<"body" | "footer" | "title" | "root" | "item" | "titleText" | "suffixIcon" | "titleBlock" | "itemLabel" | "itemIcon" | "contentBlock" | "divider" | "progressBlocker" | "progressConnector" | "progressContentBlock" | "progressIcon" | "progressLabel" | "progressRow" | "progressSecondaryText" | "progressTextBlock" | "project" | "projectLabel" | "projectValue" | "projectValueWrapper" | "selectionMarker", {
     hasBack: {
         true: {
             title: {
@@ -43,6 +43,18 @@ declare const pageSidebarSlotRecipe: import('@chakra-ui/react').SlotRecipeDefini
             itemLabel: {
                 color: "text/disabled";
             };
+            progressIcon: {
+                color: "icon/disabled";
+                _groupHover: {
+                    color: "icon/disabled";
+                };
+            };
+            progressLabel: {
+                color: "text/disabled";
+            };
+            progressSecondaryText: {
+                color: "text/disabled";
+            };
         };
         false: {};
     };
@@ -78,6 +90,44 @@ declare const pageSidebarSlotRecipe: import('@chakra-ui/react').SlotRecipeDefini
                     tablet: "body/md/semibold";
                 };
             };
+            progressIcon: {
+                color: "icon/interactive";
+                _groupHover: {
+                    color: "icon/interactive-hover";
+                };
+            };
+            progressLabel: {
+                textStyle: {
+                    base: "body/lg/semibold";
+                    tablet: "body/md/semibold";
+                };
+            };
+        };
+        false: {};
+    };
+    /**
+     * A stage the release does not have to clear. Everything steps down one level -- the icon to
+     * tertiary, the label to secondary -- so the row reads as present but not awaited. Hover and
+     * active take both back to the row's ordinary colours, as they do for a required stage.
+     *
+     * `selected` wins over it, resolved in the component rather than here. The design draws the
+     * pair (`selected=yes, notRequired=true`) and gives it the selected row's icon and label with
+     * the `not required` secondary text kept, which is what dropping this variant produces.
+     */
+    notRequired: {
+        true: {
+            progressIcon: {
+                color: "icon/tertiary";
+                _groupHover: {
+                    color: "icon/primary";
+                };
+            };
+            progressLabel: {
+                color: "text/secondary";
+                _groupHover: {
+                    color: "text/primary";
+                };
+            };
         };
         false: {};
     };

package/dist/theme/slot-recipes/PageSidebar.recipe.js

@@ -11,6 +11,14 @@ var pageSidebarSlotRecipe = defineSlotRecipe({
 		"item",
 		"itemIcon",
 		"itemLabel",
+		"progressBlocker",
+		"progressConnector",
+		"progressContentBlock",
+		"progressIcon",
+		"progressLabel",
+		"progressRow",
+		"progressSecondaryText",
+		"progressTextBlock",
 		"project",
 		"projectLabel",
 		"projectValue",
@@ -46,7 +54,7 @@ var pageSidebarSlotRecipe = defineSlotRecipe({
 			display: "flex",
 			flex: 1,
 			flexDirection: "column",
-			marginBlockEnd: "16",
+			marginBlockEnd: "8",
 			width: "full"
 		},
 		title: {
@@ -154,8 +162,86 @@ var pageSidebarSlotRecipe = defineSlotRecipe({
 			display: "flex",
 			flexDirection: "column",
 			flexShrink: 0,
+			marginBlockStart: "8",
 			paddingBlock: "8"
 		},
+		/**
+		* The progress item's own text, rather than `itemLabel`: that slot grows to fill the row, which
+		* here belongs to the blocker so the connector can run to the trailing edge.
+		*/
+		progressLabel: {
+			color: "text/primary",
+			minWidth: 0,
+			overflow: "hidden",
+			textOverflow: "ellipsis",
+			textStyle: {
+				base: "body/lg/regular",
+				tablet: "body/md/regular"
+			},
+			whiteSpace: "nowrap"
+		},
+		/** Follows the label after a middle dot, which the component renders. */
+		progressSecondaryText: {
+			color: "text/tertiary",
+			flexShrink: 0,
+			textStyle: {
+				base: "body/lg/regular",
+				tablet: "body/md/regular"
+			},
+			whiteSpace: "nowrap"
+		},
+		/**
+		* Badge and connector as one unit, taking the width the text leaves.
+		*
+		* `fit-content` rather than 0: the flex basis is 0, so with a shrinking text block beside it
+		* there is no free space to grow into and the block would be handed the whole row -- leaving
+		* the badge, which does not shrink, hanging off the trailing edge. The floor is the badge; the
+		* connector inside is basis 0 and contributes nothing to it.
+		*/
+		progressBlocker: {
+			alignItems: "center",
+			display: "flex",
+			flex: 1,
+			gap: "12",
+			minWidth: "fit-content"
+		},
+		/**
+		* The status icon's own slot rather than `itemIcon`: that one brightens to `icon/primary` with
+		* the row, which is right for navigation and wrong here -- hovering a stage would drop the
+		* colour that says where it stands.
+		*/
+		progressIcon: {
+			color: "icon/secondary",
+			flexShrink: 0,
+			_groupHover: { color: "icon/primary" }
+		},
+		/**
+		* Label and secondary text read as one line, so they sit closer than the row's own 12 gap.
+		*
+		* It shrinks before the blocker does: `item` clips its overflow, so without this a long stage
+		* name is cut mid-word and pushes the secondary text and the connector off the row. The
+		* blocker keeps `flex: 1`, so it still takes the slack whenever the text is short enough.
+		*/
+		progressTextBlock: {
+			alignItems: "center",
+			display: "flex",
+			flexShrink: 1,
+			gap: "4",
+			minWidth: 0
+		},
+		/**
+		* The progress row's block padding, which does not follow the navigation row's to 12 on mobile:
+		* the design keeps this row on 8 at both widths, so it is 44 tall on mobile against a nav row's
+		* 48. Layered over `item` rather than replacing it -- everything else about the row is shared.
+		*/
+		progressRow: { paddingBlock: "8" },
+		/** With the row above: 2 either side of the line box at both widths, so the block is 28. */
+		progressContentBlock: { paddingBlock: "2" },
+		progressConnector: {
+			borderColor: "border/minimal",
+			borderStyle: "dashed",
+			flex: 1
+		},
 		project: {
 			display: "flex",
 			flexDirection: "column",
@@ -232,7 +318,13 @@ var pageSidebarSlotRecipe = defineSlotRecipe({
 					color: "icon/disabled",
 					_groupHover: { color: "icon/disabled" }
 				},
-				itemLabel: { color: "text/disabled" }
+				itemLabel: { color: "text/disabled" },
+				progressIcon: {
+					color: "icon/disabled",
+					_groupHover: { color: "icon/disabled" }
+				},
+				progressLabel: { color: "text/disabled" },
+				progressSecondaryText: { color: "text/disabled" }
 			},
 			false: {}
 		},
@@ -259,14 +351,45 @@ var pageSidebarSlotRecipe = defineSlotRecipe({
 				itemLabel: { textStyle: {
 					base: "body/lg/semibold",
 					tablet: "body/md/semibold"
+				} },
+				progressIcon: {
+					color: "icon/interactive",
+					_groupHover: { color: "icon/interactive-hover" }
+				},
+				progressLabel: { textStyle: {
+					base: "body/lg/semibold",
+					tablet: "body/md/semibold"
 				} }
 			},
 			false: {}
+		},
+		/**
+		* A stage the release does not have to clear. Everything steps down one level -- the icon to
+		* tertiary, the label to secondary -- so the row reads as present but not awaited. Hover and
+		* active take both back to the row's ordinary colours, as they do for a required stage.
+		*
+		* `selected` wins over it, resolved in the component rather than here. The design draws the
+		* pair (`selected=yes, notRequired=true`) and gives it the selected row's icon and label with
+		* the `not required` secondary text kept, which is what dropping this variant produces.
+		*/
+		notRequired: {
+			true: {
+				progressIcon: {
+					color: "icon/tertiary",
+					_groupHover: { color: "icon/primary" }
+				},
+				progressLabel: {
+					color: "text/secondary",
+					_groupHover: { color: "text/primary" }
+				}
+			},
+			false: {}
 		}
 	},
 	defaultVariants: {
 		hasBack: false,
 		isDisabled: false,
+		notRequired: false,
 		selected: false
 	}
 });

package/dist/theme/slot-recipes/PageSidebar.recipe.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageSidebar.recipe.js","names":[],"sources":["../../../lib/theme/slot-recipes/PageSidebar.recipe.ts"],"sourcesContent":["import { defineSlotRecipe } from '@chakra-ui/react/styled-system';\n\nimport { rem } from '../themeUtils';\n\nconst pageSidebarSlotRecipe = defineSlotRecipe({\n  className: 'page-sidebar',\n  slots: [\n    'body',\n    'contentBlock',\n    'divider',\n    'footer',\n    'item',\n    'itemIcon',\n    'itemLabel',\n    'project',\n    'projectLabel',\n    'projectValue',\n    'projectValueWrapper',\n    'root',\n    'selectionMarker',\n    'suffixIcon',\n    'title',\n    'titleBlock',\n    'titleText',\n  ],\n  base: {\n    root: {\n      background: 'background/primary',\n      // Longhands, not the `borderInlineEnd: '1px solid'` shorthand: that shorthand carries no\n      // colour, so it resets it to `currentColor` if it lands after `borderColor` — which is what\n      // sorting these keys alphabetically did, turning the rule dark.\n      borderInlineEndColor: 'border/regular',\n      borderInlineEndStyle: 'solid',\n      borderInlineEndWidth: '1',\n      display: 'flex',\n      flexDirection: 'column',\n      // `minHeight` rather than `height`: on a short navigation the sidebar still reaches the\n      // bottom of the viewport, but a long one grows past it and scrolls with the page as one\n      // block — the footer is part of that scroll, not pinned to the bottom.\n      minHeight: '100dvh',\n      // Below `tablet` the sidebar is the whole view — Figma's mobile frame (`23056:50745`) is the\n      // full 375 of the phone, not a 240 column beside a page.\n      maxWidth: { base: 'none', tablet: rem(320) },\n      minWidth: rem(240),\n      paddingBlockStart: '16',\n      width: { base: 'full', tablet: rem(240) },\n    },\n    body: {\n      display: 'flex',\n      // Absorbs the slack so the footer sits at the bottom when the navigation is short, and\n      // simply grows when it is long.\n      flex: 1,\n      flexDirection: 'column',\n      // The minimum gap between the navigation and the footer block. It is a margin so it stays\n      // outside the items' own box, and `flex: 1` above means any extra space lands in the body\n      // rather than widening this gap.\n      marginBlockEnd: '16',\n      width: 'full',\n    },\n    title: {\n      alignItems: 'center',\n      color: 'text/primary',\n      display: 'flex',\n      flexShrink: 0,\n      overflow: 'clip',\n      paddingInlineEnd: '32',\n    },\n    titleBlock: {\n      alignItems: 'center',\n      display: 'flex',\n      minWidth: 0,\n    },\n    titleText: {\n      textStyle: 'heading/h3',\n      whiteSpace: 'nowrap',\n    },\n    item: {\n      alignItems: 'center',\n      cursor: 'pointer',\n      display: 'flex',\n      focusVisibleRing: 'inside',\n      gap: '12',\n      overflow: 'clip',\n      // 48 tall on mobile against 40 on desktop — the row is a touch target there.\n      paddingBlock: { base: '12', tablet: '8' },\n      paddingInline: '24',\n      position: 'relative',\n      width: 'full',\n      // Mobile reaches for `background/hover` / `background/active` where desktop uses the\n      // `secondary` / `tertiary` surfaces. The two happen to resolve close, but they are separate\n      // tokens in the design and the mobile item (`9221:4406`) binds these.\n      _hover: {\n        background: { base: 'background/hover', tablet: 'background/secondary' },\n        _active: {\n          background: { base: 'background/active', tablet: 'background/tertiary' },\n        },\n      },\n      _active: {\n        background: { base: 'background/active', tablet: 'background/tertiary' },\n      },\n      // `focusVisibleRing: 'inside'` still resolves to `outline-offset: 0`, which draws the ring\n      // just outside the border box. The item spans the sidebar's full width, so that would bleed\n      // past the sidebar's edges — pull the whole ring inside the item instead.\n      _focusVisible: {\n        outlineOffset: 'calc(var(--focus-ring-width) * -1)',\n      },\n    },\n    contentBlock: {\n      alignItems: 'center',\n      display: 'flex',\n      flex: 1,\n      gap: '12',\n      minWidth: 0,\n      // Pads the 16px icon out to the 24px line box on desktop. The mobile icon is already 24, so\n      // there is nothing to make up — the row would just grow past 48.\n      paddingBlock: { base: '0', tablet: '2' },\n    },\n    itemIcon: {\n      color: 'icon/secondary',\n      flexShrink: 0,\n      _groupHover: {\n        color: 'icon/primary',\n      },\n    },\n    itemLabel: {\n      color: 'text/primary',\n      flex: 1,\n      minWidth: 0,\n      overflow: 'hidden',\n      textAlign: 'start',\n      textOverflow: 'ellipsis',\n      textStyle: { base: 'body/lg/regular', tablet: 'body/md/regular' },\n      whiteSpace: 'nowrap',\n    },\n    suffixIcon: {\n      color: 'icon/tertiary',\n      flexShrink: 0,\n    },\n    selectionMarker: {\n      background: 'border/selected',\n      // Mobile draws the marker as a plain 4px edge (`9221:4417`); desktop as a 2px rounded rule.\n      borderEndStartRadius: { base: '0', tablet: '2' },\n      borderStartStartRadius: { base: '0', tablet: '2' },\n      height: 'full',\n      insetBlockStart: 0,\n      insetInlineEnd: 0,\n      position: 'absolute',\n      width: { base: '4', tablet: '2' },\n    },\n    footer: {\n      borderBlockStart: '1px solid',\n      borderColor: 'border/minimal',\n      display: 'flex',\n      flexDirection: 'column',\n      // The body above absorbs the free space, so the footer needs no positioning of its own —\n      // it just must not be squashed by a long list.\n      flexShrink: 0,\n      paddingBlock: '8',\n    },\n    project: {\n      display: 'flex',\n      flexDirection: 'column',\n      gap: '4',\n      justifyContent: 'center',\n      overflow: 'clip',\n      paddingBlockEnd: { base: '12', tablet: '8' },\n      paddingBlockStart: '8',\n      paddingInlineEnd: { base: '24', tablet: '32' },\n      paddingInlineStart: '24',\n      whiteSpace: 'nowrap',\n    },\n    projectLabel: {\n      color: 'text/tertiary',\n      textStyle: 'heading/h6',\n    },\n    projectValue: {\n      color: 'text/body',\n      overflow: 'hidden',\n      textOverflow: 'ellipsis',\n      textStyle: 'body/lg/semibold',\n    },\n    projectValueWrapper: {\n      display: 'flex',\n      minWidth: 0,\n    },\n    divider: {\n      // Both of the sidebar's separator roles are `border/minimal` — the group header\n      // (`20014:6508`) and this plain rule (`20014:6511`) — against `border/regular` for the general\n      // Separator component. The override is per-slot for that reason, not to limit blast radius.\n      borderColor: 'border/minimal',\n      // Mobile's separator row is 40 tall, which centres the rule at 19.5 a side; 20 is the token\n      // next to it and the resulting 1px lands nowhere the eye can find it.\n      marginBlock: { base: '20', tablet: '16' },\n      marginInline: '24',\n      width: 'auto',\n    },\n  },\n  variants: {\n    hasBack: {\n      // Redlines on the sub view (Figma `- page sidebar - interactions`): the title block sits at\n      // x/y 16, is 40 tall, and the 32px back button sits at y 20 — i.e. the 4px padding belongs to\n      // the block wrapping button + text, not to the text. Header totals 16 + 40 + 8 = 64.\n      true: {\n        title: {\n          paddingBlockEnd: '8',\n          paddingInlineStart: '16',\n        },\n        titleBlock: {\n          gap: '4',\n          paddingBlock: '4',\n        },\n      },\n      // Main view: no button, so the text alone is the block — 6 + 28 + 6 = 40, header 16+40+16 = 72.\n      false: {\n        title: {\n          paddingBlockEnd: '16',\n          paddingInlineStart: '24',\n        },\n        titleBlock: {\n          paddingBlock: '6',\n        },\n      },\n    },\n    isDisabled: {\n      true: {\n        item: {\n          cursor: 'not-allowed',\n          _hover: {\n            background: 'transparent',\n            _active: {\n              background: 'transparent',\n            },\n          },\n          _active: {\n            background: 'transparent',\n          },\n        },\n        itemIcon: {\n          color: 'icon/disabled',\n          _groupHover: {\n            color: 'icon/disabled',\n          },\n        },\n        itemLabel: {\n          color: 'text/disabled',\n        },\n      },\n      false: {},\n    },\n    selected: {\n      true: {\n        item: {\n          background: 'background/selected',\n          _hover: {\n            background: 'background/selected-hover',\n            _active: {\n              background: { base: 'background/selected-hover', tablet: 'background/selected-active' },\n            },\n          },\n          _active: {\n            background: { base: 'background/selected-hover', tablet: 'background/selected-active' },\n          },\n        },\n        itemIcon: {\n          color: 'icon/interactive',\n          _groupHover: {\n            color: 'icon/interactive-hover',\n          },\n        },\n        itemLabel: {\n          textStyle: { base: 'body/lg/semibold', tablet: 'body/md/semibold' },\n        },\n      },\n      false: {},\n    },\n  },\n  defaultVariants: {\n    hasBack: false,\n    isDisabled: false,\n    selected: false,\n  },\n});\n\nexport default pageSidebarSlotRecipe;\n"],"mappings":"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"}
+{"version":3,"file":"PageSidebar.recipe.js","names":[],"sources":["../../../lib/theme/slot-recipes/PageSidebar.recipe.ts"],"sourcesContent":["import { defineSlotRecipe } from '@chakra-ui/react/styled-system';\n\nimport { rem } from '../themeUtils';\n\nconst pageSidebarSlotRecipe = defineSlotRecipe({\n  className: 'page-sidebar',\n  slots: [\n    'body',\n    'contentBlock',\n    'divider',\n    'footer',\n    'item',\n    'itemIcon',\n    'itemLabel',\n    'progressBlocker',\n    'progressConnector',\n    'progressContentBlock',\n    'progressIcon',\n    'progressLabel',\n    'progressRow',\n    'progressSecondaryText',\n    'progressTextBlock',\n    'project',\n    'projectLabel',\n    'projectValue',\n    'projectValueWrapper',\n    'root',\n    'selectionMarker',\n    'suffixIcon',\n    'title',\n    'titleBlock',\n    'titleText',\n  ],\n  base: {\n    root: {\n      background: 'background/primary',\n      // Longhands, not the `borderInlineEnd: '1px solid'` shorthand: that shorthand carries no\n      // colour, so it resets it to `currentColor` if it lands after `borderColor` — which is what\n      // sorting these keys alphabetically did, turning the rule dark.\n      borderInlineEndColor: 'border/regular',\n      borderInlineEndStyle: 'solid',\n      borderInlineEndWidth: '1',\n      display: 'flex',\n      flexDirection: 'column',\n      // `minHeight` rather than `height`: on a short navigation the sidebar still reaches the\n      // bottom of the viewport, but a long one grows past it and scrolls with the page as one\n      // block — the footer is part of that scroll, not pinned to the bottom.\n      minHeight: '100dvh',\n      // Below `tablet` the sidebar is the whole view — Figma's mobile frame (`23056:50745`) is the\n      // full 375 of the phone, not a 240 column beside a page.\n      maxWidth: { base: 'none', tablet: rem(320) },\n      minWidth: rem(240),\n      paddingBlockStart: '16',\n      width: { base: 'full', tablet: rem(240) },\n    },\n    body: {\n      display: 'flex',\n      // Absorbs the slack so the footer sits at the bottom when the navigation is short, and\n      // simply grows when it is long.\n      flex: 1,\n      flexDirection: 'column',\n      // Half of the gap to the footer block; the footer carries the other half. Split that way so\n      // this one is also the sidebar's bottom padding when there is no footer -- 8 either way,\n      // rather than the body's whole 16 becoming the bottom edge. It is a margin so it stays\n      // outside the items' own box, and `flex: 1` above means any extra space lands in the body\n      // rather than widening the gap. Margins do not collapse in a flex column, so the two add up.\n      marginBlockEnd: '8',\n      width: 'full',\n    },\n    title: {\n      alignItems: 'center',\n      color: 'text/primary',\n      display: 'flex',\n      flexShrink: 0,\n      overflow: 'clip',\n      paddingInlineEnd: '32',\n    },\n    titleBlock: {\n      alignItems: 'center',\n      display: 'flex',\n      minWidth: 0,\n    },\n    titleText: {\n      textStyle: 'heading/h3',\n      whiteSpace: 'nowrap',\n    },\n    item: {\n      alignItems: 'center',\n      cursor: 'pointer',\n      display: 'flex',\n      focusVisibleRing: 'inside',\n      gap: '12',\n      overflow: 'clip',\n      // 48 tall on mobile against 40 on desktop — the row is a touch target there.\n      paddingBlock: { base: '12', tablet: '8' },\n      paddingInline: '24',\n      position: 'relative',\n      width: 'full',\n      // Mobile reaches for `background/hover` / `background/active` where desktop uses the\n      // `secondary` / `tertiary` surfaces. The two happen to resolve close, but they are separate\n      // tokens in the design and the mobile item (`9221:4406`) binds these.\n      _hover: {\n        background: { base: 'background/hover', tablet: 'background/secondary' },\n        _active: {\n          background: { base: 'background/active', tablet: 'background/tertiary' },\n        },\n      },\n      _active: {\n        background: { base: 'background/active', tablet: 'background/tertiary' },\n      },\n      // `focusVisibleRing: 'inside'` still resolves to `outline-offset: 0`, which draws the ring\n      // just outside the border box. The item spans the sidebar's full width, so that would bleed\n      // past the sidebar's edges — pull the whole ring inside the item instead.\n      _focusVisible: {\n        outlineOffset: 'calc(var(--focus-ring-width) * -1)',\n      },\n    },\n    contentBlock: {\n      alignItems: 'center',\n      display: 'flex',\n      flex: 1,\n      gap: '12',\n      minWidth: 0,\n      // Pads the 16px icon out to the 24px line box on desktop. The mobile icon is already 24, so\n      // there is nothing to make up — the row would just grow past 48.\n      paddingBlock: { base: '0', tablet: '2' },\n    },\n    itemIcon: {\n      color: 'icon/secondary',\n      flexShrink: 0,\n      _groupHover: {\n        color: 'icon/primary',\n      },\n    },\n    itemLabel: {\n      color: 'text/primary',\n      flex: 1,\n      minWidth: 0,\n      overflow: 'hidden',\n      textAlign: 'start',\n      textOverflow: 'ellipsis',\n      textStyle: { base: 'body/lg/regular', tablet: 'body/md/regular' },\n      whiteSpace: 'nowrap',\n    },\n    suffixIcon: {\n      color: 'icon/tertiary',\n      flexShrink: 0,\n    },\n    selectionMarker: {\n      background: 'border/selected',\n      // Mobile draws the marker as a plain 4px edge (`9221:4417`); desktop as a 2px rounded rule.\n      borderEndStartRadius: { base: '0', tablet: '2' },\n      borderStartStartRadius: { base: '0', tablet: '2' },\n      height: 'full',\n      insetBlockStart: 0,\n      insetInlineEnd: 0,\n      position: 'absolute',\n      width: { base: '4', tablet: '2' },\n    },\n    footer: {\n      borderBlockStart: '1px solid',\n      borderColor: 'border/minimal',\n      display: 'flex',\n      flexDirection: 'column',\n      // The body above absorbs the free space, so the footer needs no positioning of its own —\n      // it just must not be squashed by a long list.\n      flexShrink: 0,\n      // The other half of the gap to the body — see its `marginBlockEnd`.\n      marginBlockStart: '8',\n      paddingBlock: '8',\n    },\n    /**\n     * The progress item's own text, rather than `itemLabel`: that slot grows to fill the row, which\n     * here belongs to the blocker so the connector can run to the trailing edge.\n     */\n    progressLabel: {\n      color: 'text/primary',\n      minWidth: 0,\n      overflow: 'hidden',\n      textOverflow: 'ellipsis',\n      textStyle: { base: 'body/lg/regular', tablet: 'body/md/regular' },\n      whiteSpace: 'nowrap',\n    },\n    /** Follows the label after a middle dot, which the component renders. */\n    progressSecondaryText: {\n      color: 'text/tertiary',\n      flexShrink: 0,\n      textStyle: { base: 'body/lg/regular', tablet: 'body/md/regular' },\n      whiteSpace: 'nowrap',\n    },\n    /**\n     * Badge and connector as one unit, taking the width the text leaves.\n     *\n     * `fit-content` rather than 0: the flex basis is 0, so with a shrinking text block beside it\n     * there is no free space to grow into and the block would be handed the whole row -- leaving\n     * the badge, which does not shrink, hanging off the trailing edge. The floor is the badge; the\n     * connector inside is basis 0 and contributes nothing to it.\n     */\n    progressBlocker: {\n      alignItems: 'center',\n      display: 'flex',\n      flex: 1,\n      gap: '12',\n      minWidth: 'fit-content',\n    },\n    /**\n     * The status icon's own slot rather than `itemIcon`: that one brightens to `icon/primary` with\n     * the row, which is right for navigation and wrong here -- hovering a stage would drop the\n     * colour that says where it stands.\n     */\n    progressIcon: {\n      // The colour a status-less icon takes -- the approvals step's, which the design draws in the\n      // same `icon/secondary` as the navigation icons. `iconColor` overrides it per stage.\n      color: 'icon/secondary',\n      flexShrink: 0,\n      // Its own slot rather than `itemIcon`, but it does brighten with the row: the design moves the\n      // icon to `icon/primary` on hover and active. That only ever reaches a colour this recipe\n      // supplied -- a consumer's `iconColor` is an inline, unlayered `color` and beats it -- so a\n      // stage's status survives the hover while a status-less icon follows the row.\n      _groupHover: {\n        color: 'icon/primary',\n      },\n    },\n    /**\n     * Label and secondary text read as one line, so they sit closer than the row's own 12 gap.\n     *\n     * It shrinks before the blocker does: `item` clips its overflow, so without this a long stage\n     * name is cut mid-word and pushes the secondary text and the connector off the row. The\n     * blocker keeps `flex: 1`, so it still takes the slack whenever the text is short enough.\n     */\n    progressTextBlock: {\n      alignItems: 'center',\n      display: 'flex',\n      flexShrink: 1,\n      gap: '4',\n      minWidth: 0,\n    },\n    /**\n     * The progress row's block padding, which does not follow the navigation row's to 12 on mobile:\n     * the design keeps this row on 8 at both widths, so it is 44 tall on mobile against a nav row's\n     * 48. Layered over `item` rather than replacing it -- everything else about the row is shared.\n     */\n    progressRow: {\n      paddingBlock: '8',\n    },\n    /** With the row above: 2 either side of the line box at both widths, so the block is 28. */\n    progressContentBlock: {\n      paddingBlock: '2',\n    },\n    progressConnector: {\n      borderColor: 'border/minimal',\n      borderStyle: 'dashed',\n      flex: 1,\n    },\n    project: {\n      display: 'flex',\n      flexDirection: 'column',\n      gap: '4',\n      justifyContent: 'center',\n      overflow: 'clip',\n      paddingBlockEnd: { base: '12', tablet: '8' },\n      paddingBlockStart: '8',\n      paddingInlineEnd: { base: '24', tablet: '32' },\n      paddingInlineStart: '24',\n      whiteSpace: 'nowrap',\n    },\n    projectLabel: {\n      color: 'text/tertiary',\n      textStyle: 'heading/h6',\n    },\n    projectValue: {\n      color: 'text/body',\n      overflow: 'hidden',\n      textOverflow: 'ellipsis',\n      textStyle: 'body/lg/semibold',\n    },\n    projectValueWrapper: {\n      display: 'flex',\n      minWidth: 0,\n    },\n    divider: {\n      // Both of the sidebar's separator roles are `border/minimal` — the group header\n      // (`20014:6508`) and this plain rule (`20014:6511`) — against `border/regular` for the general\n      // Separator component. The override is per-slot for that reason, not to limit blast radius.\n      borderColor: 'border/minimal',\n      // Mobile's separator row is 40 tall, which centres the rule at 19.5 a side; 20 is the token\n      // next to it and the resulting 1px lands nowhere the eye can find it.\n      marginBlock: { base: '20', tablet: '16' },\n      marginInline: '24',\n      width: 'auto',\n    },\n  },\n  variants: {\n    hasBack: {\n      // Redlines on the sub view (Figma `- page sidebar - interactions`): the title block sits at\n      // x/y 16, is 40 tall, and the 32px back button sits at y 20 — i.e. the 4px padding belongs to\n      // the block wrapping button + text, not to the text. Header totals 16 + 40 + 8 = 64.\n      true: {\n        title: {\n          paddingBlockEnd: '8',\n          paddingInlineStart: '16',\n        },\n        titleBlock: {\n          gap: '4',\n          paddingBlock: '4',\n        },\n      },\n      // Main view: no button, so the text alone is the block — 6 + 28 + 6 = 40, header 16+40+16 = 72.\n      false: {\n        title: {\n          paddingBlockEnd: '16',\n          paddingInlineStart: '24',\n        },\n        titleBlock: {\n          paddingBlock: '6',\n        },\n      },\n    },\n    isDisabled: {\n      true: {\n        item: {\n          cursor: 'not-allowed',\n          _hover: {\n            background: 'transparent',\n            _active: {\n              background: 'transparent',\n            },\n          },\n          _active: {\n            background: 'transparent',\n          },\n        },\n        itemIcon: {\n          color: 'icon/disabled',\n          _groupHover: {\n            color: 'icon/disabled',\n          },\n        },\n        itemLabel: {\n          color: 'text/disabled',\n        },\n        progressIcon: {\n          color: 'icon/disabled',\n          _groupHover: {\n            color: 'icon/disabled',\n          },\n        },\n        progressLabel: {\n          color: 'text/disabled',\n        },\n        progressSecondaryText: {\n          color: 'text/disabled',\n        },\n      },\n      false: {},\n    },\n    selected: {\n      true: {\n        item: {\n          background: 'background/selected',\n          _hover: {\n            background: 'background/selected-hover',\n            _active: {\n              background: { base: 'background/selected-hover', tablet: 'background/selected-active' },\n            },\n          },\n          _active: {\n            background: { base: 'background/selected-hover', tablet: 'background/selected-active' },\n          },\n        },\n        itemIcon: {\n          color: 'icon/interactive',\n          _groupHover: {\n            color: 'icon/interactive-hover',\n          },\n        },\n        itemLabel: {\n          textStyle: { base: 'body/lg/semibold', tablet: 'body/md/semibold' },\n        },\n        progressIcon: {\n          color: 'icon/interactive',\n          _groupHover: {\n            color: 'icon/interactive-hover',\n          },\n        },\n        progressLabel: {\n          textStyle: { base: 'body/lg/semibold', tablet: 'body/md/semibold' },\n        },\n      },\n      false: {},\n    },\n    /**\n     * A stage the release does not have to clear. Everything steps down one level -- the icon to\n     * tertiary, the label to secondary -- so the row reads as present but not awaited. Hover and\n     * active take both back to the row's ordinary colours, as they do for a required stage.\n     *\n     * `selected` wins over it, resolved in the component rather than here. The design draws the\n     * pair (`selected=yes, notRequired=true`) and gives it the selected row's icon and label with\n     * the `not required` secondary text kept, which is what dropping this variant produces.\n     */\n    notRequired: {\n      true: {\n        progressIcon: {\n          color: 'icon/tertiary',\n          _groupHover: { color: 'icon/primary' },\n        },\n        progressLabel: {\n          color: 'text/secondary',\n          _groupHover: { color: 'text/primary' },\n        },\n      },\n      false: {},\n    },\n  },\n  defaultVariants: {\n    hasBack: false,\n    isDisabled: false,\n    notRequired: false,\n    selected: false,\n  },\n});\n\nexport default pageSidebarSlotRecipe;\n"],"mappings":"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"}

package/dist/theme/slot-recipes/index.d.ts

@@ -1631,7 +1631,7 @@ declare const slotRecipes: {
             false: {};
         };
     }>;
-    pageSidebar: import('@chakra-ui/react').SlotRecipeDefinition<"body" | "footer" | "title" | "root" | "item" | "titleText" | "suffixIcon" | "titleBlock" | "itemLabel" | "itemIcon" | "contentBlock" | "divider" | "project" | "projectLabel" | "projectValue" | "projectValueWrapper" | "selectionMarker", {
+    pageSidebar: import('@chakra-ui/react').SlotRecipeDefinition<"body" | "footer" | "title" | "root" | "item" | "titleText" | "suffixIcon" | "titleBlock" | "itemLabel" | "itemIcon" | "contentBlock" | "divider" | "progressBlocker" | "progressConnector" | "progressContentBlock" | "progressIcon" | "progressLabel" | "progressRow" | "progressSecondaryText" | "progressTextBlock" | "project" | "projectLabel" | "projectValue" | "projectValueWrapper" | "selectionMarker", {
         hasBack: {
             true: {
                 title: {
@@ -1676,6 +1676,18 @@ declare const slotRecipes: {
                 itemLabel: {
                     color: "text/disabled";
                 };
+                progressIcon: {
+                    color: "icon/disabled";
+                    _groupHover: {
+                        color: "icon/disabled";
+                    };
+                };
+                progressLabel: {
+                    color: "text/disabled";
+                };
+                progressSecondaryText: {
+                    color: "text/disabled";
+                };
             };
             false: {};
         };
@@ -1711,6 +1723,35 @@ declare const slotRecipes: {
                         tablet: "body/md/semibold";
                     };
                 };
+                progressIcon: {
+                    color: "icon/interactive";
+                    _groupHover: {
+                        color: "icon/interactive-hover";
+                    };
+                };
+                progressLabel: {
+                    textStyle: {
+                        base: "body/lg/semibold";
+                        tablet: "body/md/semibold";
+                    };
+                };
+            };
+            false: {};
+        };
+        notRequired: {
+            true: {
+                progressIcon: {
+                    color: "icon/tertiary";
+                    _groupHover: {
+                        color: "icon/primary";
+                    };
+                };
+                progressLabel: {
+                    color: "text/secondary";
+                    _groupHover: {
+                        color: "text/primary";
+                    };
+                };
             };
             false: {};
         };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bitrise/bitkit-v2",
   "private": false,
-  "version": "0.3.427",
+  "version": "0.3.429",
   "description": "Bitrise Design System Components built with Chakra UI V3",
   "keywords": [
     "react",