@cube-dev/ui-kit 0.114.0 → 0.116.0

package/dist/components/content/Item/Item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Item.js","names":["HotKeys"],"sources":["../../../../src/components/content/Item/Item.tsx"],"sourcesContent":["import {\n  ForwardedRef,\n  forwardRef,\n  HTMLAttributes,\n  isValidElement,\n  KeyboardEvent,\n  MouseEvent,\n  PointerEvent,\n  ReactNode,\n  RefObject,\n  useMemo,\n} from 'react';\nimport { OverlayProps } from 'react-aria';\nimport { useHotkeys } from 'react-hotkeys-hook';\n\nimport { useWarn } from '../../../_internal/hooks/use-warn';\nimport {\n  DANGER_CARD_STYLES,\n  DANGER_CLEAR_STYLES,\n  DANGER_ITEM_STYLES,\n  DANGER_LINK_STYLES,\n  DANGER_NEUTRAL_STYLES,\n  DANGER_OUTLINE_STYLES,\n  DANGER_PRIMARY_STYLES,\n  DANGER_SECONDARY_STYLES,\n  DEFAULT_CARD_STYLES,\n  DEFAULT_CLEAR_STYLES,\n  DEFAULT_ITEM_STYLES,\n  DEFAULT_LINK_STYLES,\n  DEFAULT_NEUTRAL_STYLES,\n  DEFAULT_OUTLINE_STYLES,\n  DEFAULT_PRIMARY_STYLES,\n  DEFAULT_SECONDARY_STYLES,\n  ItemVariant,\n  NOTE_CARD_STYLES,\n  NOTE_CLEAR_STYLES,\n  NOTE_ITEM_STYLES,\n  NOTE_LINK_STYLES,\n  NOTE_NEUTRAL_STYLES,\n  NOTE_OUTLINE_STYLES,\n  NOTE_PRIMARY_STYLES,\n  NOTE_SECONDARY_STYLES,\n  SPECIAL_CLEAR_STYLES,\n  SPECIAL_ITEM_STYLES,\n  SPECIAL_LINK_STYLES,\n  SPECIAL_NEUTRAL_STYLES,\n  SPECIAL_OUTLINE_STYLES,\n  SPECIAL_PRIMARY_STYLES,\n  SPECIAL_SECONDARY_STYLES,\n  SUCCESS_CARD_STYLES,\n  SUCCESS_CLEAR_STYLES,\n  SUCCESS_ITEM_STYLES,\n  SUCCESS_LINK_STYLES,\n  SUCCESS_NEUTRAL_STYLES,\n  SUCCESS_OUTLINE_STYLES,\n  SUCCESS_PRIMARY_STYLES,\n  SUCCESS_SECONDARY_STYLES,\n  WARNING_CARD_STYLES,\n  WARNING_CLEAR_STYLES,\n  WARNING_ITEM_STYLES,\n  WARNING_LINK_STYLES,\n  WARNING_NEUTRAL_STYLES,\n  WARNING_OUTLINE_STYLES,\n  WARNING_PRIMARY_STYLES,\n  WARNING_SECONDARY_STYLES,\n} from '../../../data/item-themes';\nimport { CheckIcon } from '../../../icons/CheckIcon';\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport {\n  BaseProps,\n  CONTAINER_STYLES,\n  ContainerStyleProps,\n  Mods,\n  Props,\n  Styles,\n  tasty,\n} from '../../../tasty';\nimport { DynamicIcon, mergeProps, resolveIcon } from '../../../utils/react';\nimport { ItemAction } from '../../actions/ItemAction';\nimport { ItemActionProvider } from '../../actions/ItemActionContext';\nimport { IconSwitch } from '../../helpers/IconSwitch/IconSwitch';\nimport { CubeTooltipProviderProps } from '../../overlays/Tooltip/TooltipProvider';\nimport { highlightText } from '../highlightText';\nimport { HotKeys } from '../HotKeys';\nimport { ItemBadge } from '../ItemBadge';\nimport { useAutoTooltip } from '../use-auto-tooltip';\n\nconst ITEM_SIZE_VALUES = [\n  'xsmall',\n  'small',\n  'medium',\n  'large',\n  'xlarge',\n  'inline',\n] as const;\n\n/** Known modifiers for Item component */\nexport type ItemMods = Mods<{\n  'has-icon'?: boolean;\n  'has-start-content'?: boolean;\n  'has-end-content'?: boolean;\n  'has-right-icon'?: boolean;\n  'has-label'?: boolean;\n  'has-prefix'?: boolean;\n  'has-suffix'?: boolean;\n  'has-description'?: boolean;\n  'has-actions'?: boolean;\n  'has-actions-content'?: boolean;\n  'auto-hide-actions'?: boolean;\n  'preserve-actions-space'?: boolean;\n  checkbox?: boolean;\n  disabled?: boolean;\n  selected?: boolean;\n  loading?: boolean;\n  size?: string;\n  description?: string;\n  type?: string;\n  theme?: string;\n  shape?: string;\n}>;\n\nexport interface CubeItemProps extends BaseProps, ContainerStyleProps {\n  icon?: DynamicIcon<ItemMods> | 'checkbox';\n  rightIcon?: DynamicIcon<ItemMods>;\n  prefix?: ReactNode;\n  suffix?: ReactNode;\n  description?: ReactNode;\n  descriptionPlacement?: 'inline' | 'block';\n  /**\n   * When true, the item is rendered inside a wrapper element to separate the actions from the item.\n   * @default false\n   */\n  insideWrapper?: boolean;\n  /**\n   * Whether the item is selected.\n   * @default false\n   */\n  isSelected?: boolean;\n  /**\n   * Actions to render inline or placeholder mode for ItemButton wrapper.\n   * - ReactNode: renders actions inline as part of the grid layout\n   * - true: placeholder mode for ItemButton (enables --actions-width calculation)\n   */\n  actions?: ReactNode | true;\n  /**\n   * When true, actions are hidden by default and shown only on hover, focus, or focus-within.\n   * Uses opacity transition for visual hiding while maintaining layout space.\n   */\n  autoHideActions?: boolean;\n  /**\n   * When true and insideWrapper is true, this controls the visibility of the actions.\n   * @default false\n   */\n  showActions?: boolean;\n  /**\n   * When true, preserves the actions width when hidden (only changes opacity).\n   * Only applies when autoHideActions is true.\n   * @default false\n   */\n  preserveActionsSpace?: boolean;\n  /**\n   * When true, disables focus on action buttons by setting tabIndex={-1}.\n   * @default true\n   */\n  disableActionsFocus?: boolean;\n  size?:\n    | 'xsmall'\n    | 'small'\n    | 'medium'\n    | 'large'\n    | 'xlarge'\n    | 'inline'\n    | number\n    | (string & {});\n  type?:\n    | 'item'\n    | 'header'\n    | 'primary'\n    | 'secondary'\n    | 'outline'\n    | 'neutral'\n    | 'clear'\n    | 'link'\n    | 'card'\n    | (string & {});\n  theme?:\n    | 'default'\n    | 'danger'\n    | 'success'\n    | 'special'\n    | 'warning'\n    | 'note'\n    | (string & {});\n  /** Keyboard shortcut that triggers the element when pressed */\n  hotkeys?: string;\n  /**\n   * Tooltip content and configuration:\n   * - string: simple tooltip text\n   * - true: auto tooltip on overflow (shows children as tooltip when truncated)\n   * - object: advanced configuration with optional auto property\n   */\n  tooltip?:\n    | string\n    | boolean\n    | (Omit<CubeTooltipProviderProps, 'children'> & { auto?: boolean });\n  /**\n   * HTML button type to avoid implicit form submission when used as `as=\"button\"`.\n   * Kept separate from visual `type` prop.\n   */\n  htmlType?: 'button' | 'submit' | 'reset';\n  labelProps?: Props;\n  descriptionProps?: Props;\n  keyboardShortcutProps?: Props;\n  /**\n   * The slot which the loading icon should replace in loading state.\n   * - \"auto\": Smart selection - prefers icon if present, then rightIcon, fallback to icon\n   * - Specific slot names: Always use that slot\n   * @default \"auto\"\n   */\n  loadingSlot?: 'auto' | 'icon' | 'rightIcon' | 'prefix' | 'suffix';\n  /**\n   * When true, shows loading state by replacing the specified slot with LoadingIcon\n   * and makes the component disabled.\n   */\n  isLoading?: boolean;\n  /**\n   * Shape of the item's border radius.\n   * - `card` - Card shape with larger border radius (`1cr`)\n   * - `button` - Button shape with default border radius (default)\n   * - `sharp` - Sharp corners with no border radius (`0`)\n   * - `pill` - Pill shape with fully rounded ends (`round`)\n   * @default \"button\"\n   */\n  shape?: 'card' | 'button' | 'sharp' | 'pill';\n  /**\n   * @private\n   * Default tooltip placement for the item.\n   * @default \"top\"\n   */\n  defaultTooltipPlacement?: OverlayProps['placement'];\n  /**\n   * Ref to access the label element directly\n   */\n  labelRef?: RefObject<HTMLElement>;\n  /**\n   * Heading level for the Label element when type=\"header\" or type=\"card\".\n   * Changes the Label's HTML tag to the corresponding heading (h1-h6).\n   * @default 3\n   */\n  level?: 1 | 2 | 3 | 4 | 5 | 6;\n  /**\n   * String to highlight within children.\n   * Only works when children is a plain string.\n   */\n  highlight?: string;\n  /**\n   * Whether highlight matching is case-sensitive.\n   * @default false\n   */\n  highlightCaseSensitive?: boolean;\n  /**\n   * Custom styles for highlighted text.\n   */\n  highlightStyles?: Styles;\n  /**\n   * Variant of the item.\n   */\n  variant?: ItemVariant;\n}\n\nconst DEFAULT_ICON_STYLES: Styles = {\n  $: '>',\n  display: 'grid',\n  placeItems: 'center',\n  placeContent: 'stretch',\n  aspectRatio: '1 / 1',\n  width: '($size - 2bw)',\n  opacity: {\n    '': 1,\n    'checkbox & selected': 1,\n    'checkbox & !selected': 0,\n    'checkbox & !selected & hovered': 0.4,\n  },\n};\n\nconst ADDITION_STYLES: Styles = {\n  $: '>',\n  display: 'grid',\n  flow: 'column',\n  placeItems: 'center',\n  placeContent: 'stretch',\n};\n\nconst ACTIONS_EVENT_HANDLERS = {\n  onClick: (e: MouseEvent) => e.stopPropagation(),\n  onPointerDown: (e: PointerEvent) => e.stopPropagation(),\n  onPointerUp: (e: PointerEvent) => e.stopPropagation(),\n  onMouseDown: (e: MouseEvent) => e.stopPropagation(),\n  onMouseUp: (e: MouseEvent) => e.stopPropagation(),\n  onKeyDown: (e: KeyboardEvent) => {\n    if (e.key === 'Enter' || e.key === ' ') {\n      e.stopPropagation();\n    }\n  },\n};\n\nconst ItemElement = tasty({\n  as: 'div',\n  styles: {\n    '@interacted':\n      'active | :hover | :focus | :focus-within | :has([data-pressed])',\n\n    display: 'inline-grid',\n    flow: 'column dense',\n    gap: 0,\n    outline: 0,\n    placeItems: 'stretch',\n    placeContent: 'stretch',\n    gridTemplate: {\n      '': '\"icon prefix label suffix rightIcon actions\" auto \"icon prefix label suffix rightIcon actions\" auto / max-content max-content 1sf max-content max-content max-content',\n      'description=inline':\n        '\"icon prefix description suffix rightIcon actions\" auto / max-content max-content 1sf max-content max-content max-content',\n      'description=inline & has-label':\n        '\"icon prefix label suffix rightIcon actions\" auto \"icon prefix description suffix rightIcon actions\" auto / max-content max-content 1sf max-content max-content max-content',\n      'description=block':\n        '\"icon prefix label suffix rightIcon actions\" auto \"description description description description description description\" auto / max-content max-content 1sf max-content max-content max-content',\n    },\n    // Prevent items from shrinking inside vertical flex layouts (Menu, ListBox, etc)\n    flexShrink: {\n      '': 'initial',\n      'menuitem | listboxitem': 0,\n    },\n    position: 'relative',\n    padding: {\n      '': 0,\n      'type=card': '.5x',\n    },\n    margin: 0,\n    radius: {\n      '': true,\n      'shape=card': '1cr',\n      'shape=button': true,\n      'shape=sharp': '0',\n      'shape=pill': 'round',\n    },\n    height: {\n      '': 'min $size',\n      'size=inline': '(1lh + 2bw)',\n    },\n    width: {\n      '': 'min $size',\n      'has-icon & has-right-icon': 'min ($size * 2)',\n      'size=inline': 'min (1lh + 2bw)',\n    },\n    border: '#clear',\n    fill: {\n      '': '#dark.0',\n      'hovered | focused': '#dark.03',\n      selected: '#dark.09',\n      'selected & (hovered | focused)': '#dark.12',\n      pressed: '#dark.09',\n      disabled: '#clear',\n    },\n    color: {\n      '': '#dark-02',\n      hovered: '#dark-02',\n      pressed: '#dark',\n      disabled: '#dark-04',\n    },\n    preset: {\n      '': 't3',\n      '!type=item': 't3m',\n      'size=xsmall': 't4',\n      'size=xlarge': 't2',\n      'size=inline': 'inline',\n      '!type=item & (size=medium | size=small | size=large)': 't3m',\n      '!type=item & size=xlarge': 't2m',\n      '(type=header | type=card) & (size=xsmall | size=small | size=medium)':\n        'h6',\n      '(type=header | type=card) & size=large': 'h5',\n      '(type=header | type=card) & size=xlarge': 'h4',\n    },\n    recipe: 'reset button',\n    transition: 'theme',\n    outlineOffset: 1,\n    cursor: {\n      '': 'inherit',\n      ':is(a)': 'pointer',\n      ':is(button) | listboxitem | menuitem': '$pointer',\n      disabled: 'not-allowed',\n    },\n\n    $size: {\n      '': '$size-md',\n      'size=xsmall': '$size-xs',\n      'size=small': '$size-sm',\n      'size=medium': '$size-md',\n      'size=large': '$size-lg',\n      'size=xlarge': '$size-xl',\n      'size=inline': '(1lh + 2bw)',\n    },\n    '$inline-padding':\n      'max($min-inline-padding, (($size - 1lh - 2bw) / 2 + $inline-compensation))',\n    '$block-padding': {\n      '': '.5x',\n      'size=xsmall | size=small': '.25x',\n      'size=inline': 0,\n    },\n    '$inline-compensation': '.5x',\n    '$min-inline-padding': '(1x - 1bw)',\n\n    '$label-padding-left': {\n      '': '$inline-padding',\n      'has-start-content': '0',\n    },\n    '$label-padding-right': {\n      '': '$inline-padding',\n      'has-end-content': '0',\n      // Restore padding when actions are hidden AND no other visible end content\n      '!inside-wrapper & !has-suffix & !has-right-icon & auto-hide-actions & !preserve-actions-space & !@interacted':\n        '$inline-padding',\n      'inside-wrapper & !has-suffix & !has-right-icon & !preserve-actions-space & !actions-shown':\n        '$inline-padding',\n    },\n    '$label-padding-bottom': {\n      '': '$block-padding',\n      'description=inline': '0',\n    },\n    '$description-padding-left': {\n      '': '$inline-padding',\n      'has-start-content': 0,\n      'description=block': '($inline-padding - $inline-compensation + 1bw)',\n      'description=block & !has-start-content': '$inline-padding',\n    },\n    '$description-padding-right': {\n      '': '$inline-padding',\n      'has-end-content': 0,\n      'description=block': '($inline-padding - $inline-compensation + 1bw)',\n      'description=block & !has-end-content': '$inline-padding',\n    },\n    '$description-padding-bottom': {\n      '': 0,\n      'has-label & description=inline': '$block-padding',\n      'has-label & description=block':\n        'max($block-padding, (($size - 4x) / 2) + $block-padding)',\n    },\n\n    Icon: { ...DEFAULT_ICON_STYLES, gridArea: 'icon' },\n\n    RightIcon: { ...DEFAULT_ICON_STYLES, gridArea: 'rightIcon' },\n\n    Label: {\n      $: '>',\n      margin: 0,\n      gridArea: 'label',\n      display: 'block',\n      placeSelf: 'center start',\n      boxSizing: 'border-box',\n      placeContent: 'stretch',\n      whiteSpace: 'nowrap',\n      overflow: 'hidden',\n      textOverflow: 'ellipsis',\n      width: '0 100%',\n      preset: 'inherit',\n      transition: 'padding',\n      padding:\n        '$block-padding $label-padding-right $label-padding-bottom $label-padding-left',\n    },\n\n    Description: {\n      $: '>',\n      gridArea: 'description',\n      preset: {\n        '': 't4',\n        'type=card | type=header': 't3',\n      },\n      placeSelf: 'center start',\n      boxSizing: 'border-box',\n      color: 'inherit',\n      opacity: {\n        '': 0.75,\n        'type=card | type=header': 1,\n      },\n      overflow: 'hidden',\n      whiteSpace: {\n        '': 'nowrap',\n        'type=card | type=header': 'normal',\n      },\n      textOverflow: 'ellipsis',\n      width: 'initial 100% 100%',\n      textAlign: 'left',\n      padding:\n        '0 $description-padding-right $description-padding-bottom $description-padding-left',\n    },\n\n    Prefix: {\n      ...ADDITION_STYLES,\n      gridArea: 'prefix',\n      padding: {\n        '': '$inline-padding left',\n        'has-icon': 0,\n      },\n    },\n\n    Suffix: {\n      ...ADDITION_STYLES,\n      gridArea: 'suffix',\n      padding: {\n        '': '$inline-padding right',\n        'has-right-icon': 0,\n      },\n    },\n\n    Actions: {\n      $: '>',\n      gridArea: 'actions',\n      display: 'flex',\n      gap: '1bw',\n      placeItems: 'center',\n      placeContent: 'end',\n      placeSelf: 'stretch',\n      padding: {\n        '': '0 $side-padding',\n        'inside-wrapper & !actions-shown': 0,\n      },\n      boxSizing: 'border-box',\n      height: 'min ($size - 2bw)',\n      width: {\n        '': 'fixed ($actions-width, 0px)',\n        'has-actions-content & !auto-hide-actions':\n          'max calc-size(max-content, size)',\n        'has-actions-content & auto-hide-actions & !preserve-actions-space':\n          'max 0px',\n        'has-actions-content & auto-hide-actions & (!preserve-actions-space & ((@interacted & !inside-wrapper) | (inside-wrapper & actions-shown)))':\n          'max calc-size(max-content, size)',\n        'has-actions-content & auto-hide-actions & preserve-actions-space':\n          'max calc-size(max-content, size)',\n      },\n      opacity: {\n        '': 1,\n        'auto-hide-actions': 0,\n        'auto-hide-actions & ((@interacted & !inside-wrapper) | (inside-wrapper & actions-shown))': 1,\n      },\n      transition:\n        'width $transition ease-out, opacity $transition ease-out, padding $transition ease-out',\n      interpolateSize: 'allow-keywords',\n\n      // Size for the action buttons\n      '$action-size': 'min(max((2x + 2bw), ($size - 1x - 2bw)), (3x - 2bw))',\n      // Side padding for the button\n      '$side-padding': '(($size - $action-size - 2bw) / 2)',\n    },\n  },\n  variants: {\n    // Default theme\n    'default.primary': DEFAULT_PRIMARY_STYLES,\n    'default.secondary': DEFAULT_SECONDARY_STYLES,\n    'default.outline': DEFAULT_OUTLINE_STYLES,\n    'default.neutral': DEFAULT_NEUTRAL_STYLES,\n    'default.clear': DEFAULT_CLEAR_STYLES,\n    'default.link': DEFAULT_LINK_STYLES,\n    'default.item': DEFAULT_ITEM_STYLES,\n    'default.card': DEFAULT_CARD_STYLES,\n    // Danger theme\n    'danger.primary': DANGER_PRIMARY_STYLES,\n    'danger.secondary': DANGER_SECONDARY_STYLES,\n    'danger.outline': DANGER_OUTLINE_STYLES,\n    'danger.neutral': DANGER_NEUTRAL_STYLES,\n    'danger.clear': DANGER_CLEAR_STYLES,\n    'danger.link': DANGER_LINK_STYLES,\n    'danger.item': DANGER_ITEM_STYLES,\n    'danger.card': DANGER_CARD_STYLES,\n    // Success theme\n    'success.primary': SUCCESS_PRIMARY_STYLES,\n    'success.secondary': SUCCESS_SECONDARY_STYLES,\n    'success.outline': SUCCESS_OUTLINE_STYLES,\n    'success.neutral': SUCCESS_NEUTRAL_STYLES,\n    'success.clear': SUCCESS_CLEAR_STYLES,\n    'success.link': SUCCESS_LINK_STYLES,\n    'success.item': SUCCESS_ITEM_STYLES,\n    'success.card': SUCCESS_CARD_STYLES,\n    // Warning theme\n    'warning.primary': WARNING_PRIMARY_STYLES,\n    'warning.secondary': WARNING_SECONDARY_STYLES,\n    'warning.outline': WARNING_OUTLINE_STYLES,\n    'warning.neutral': WARNING_NEUTRAL_STYLES,\n    'warning.clear': WARNING_CLEAR_STYLES,\n    'warning.link': WARNING_LINK_STYLES,\n    'warning.item': WARNING_ITEM_STYLES,\n    'warning.card': WARNING_CARD_STYLES,\n    // Note theme\n    'note.primary': NOTE_PRIMARY_STYLES,\n    'note.secondary': NOTE_SECONDARY_STYLES,\n    'note.outline': NOTE_OUTLINE_STYLES,\n    'note.neutral': NOTE_NEUTRAL_STYLES,\n    'note.clear': NOTE_CLEAR_STYLES,\n    'note.link': NOTE_LINK_STYLES,\n    'note.item': NOTE_ITEM_STYLES,\n    'note.card': NOTE_CARD_STYLES,\n    // Special theme\n    'special.primary': SPECIAL_PRIMARY_STYLES,\n    'special.secondary': SPECIAL_SECONDARY_STYLES,\n    'special.outline': SPECIAL_OUTLINE_STYLES,\n    'special.neutral': SPECIAL_NEUTRAL_STYLES,\n    'special.clear': SPECIAL_CLEAR_STYLES,\n    'special.link': SPECIAL_LINK_STYLES,\n    'special.item': SPECIAL_ITEM_STYLES,\n  },\n  styleProps: CONTAINER_STYLES,\n});\n\nconst Item = <T extends HTMLElement = HTMLDivElement>(\n  props: CubeItemProps,\n  ref: ForwardedRef<T>,\n) => {\n  let {\n    children,\n    size = 'medium',\n    type = 'item',\n    theme = 'default',\n    mods,\n    icon: iconProp,\n    rightIcon: rightIconProp,\n    prefix,\n    suffix,\n    description,\n    descriptionPlacement,\n    labelProps,\n    descriptionProps,\n    keyboardShortcutProps,\n    styles,\n    htmlType,\n    isSelected,\n    hotkeys,\n    tooltip = true,\n    isDisabled,\n    style,\n    loadingSlot = 'auto',\n    isLoading = false,\n    actions,\n    autoHideActions = false,\n    preserveActionsSpace = false,\n    disableActionsFocus = false,\n    shape,\n    defaultTooltipPlacement = 'top',\n    level = 3,\n    highlight,\n    highlightCaseSensitive = false,\n    highlightStyles,\n    insideWrapper = false,\n    showActions = false,\n    ...rest\n  } = props;\n\n  // Determine if Label will be rendered\n  const hasLabel = !!(children || labelProps);\n\n  // Set default descriptionPlacement based on type\n  // For card/header types, use 'block' only when Label is rendered\n  const finalDescriptionPlacement =\n    descriptionPlacement ??\n    ((type === 'card' || type === 'header') && hasLabel ? 'block' : 'inline');\n\n  // Set default shape based on type\n  const finalShape = shape ?? (type === 'card' ? 'card' : 'button');\n\n  // Loading state makes the component disabled\n  const finalIsDisabled =\n    isDisabled === true || (isLoading && isDisabled !== false);\n\n  // Validate type+theme combinations\n  const STANDARD_THEMES = [\n    'default',\n    'success',\n    'danger',\n    'warning',\n    'note',\n    'special',\n  ];\n  const CARD_THEMES = ['default', 'success', 'danger', 'warning', 'note'];\n  const HEADER_THEMES = ['default'];\n\n  const isInvalidCombination =\n    (type === 'header' && !HEADER_THEMES.includes(theme)) ||\n    (type === 'card' && !CARD_THEMES.includes(theme)) ||\n    (!['header', 'card'].includes(type) && !STANDARD_THEMES.includes(theme));\n\n  useWarn(isInvalidCombination, {\n    key: ['Item', 'invalid-type-theme', type, theme],\n    args: [\n      `Item: Invalid type+theme combination. type=\"${type}\" does not support theme=\"${theme}\".` +\n        (type === 'header'\n          ? ' The \"header\" type only supports theme: default.'\n          : type === 'card'\n            ? ' The \"card\" type only supports themes: default, success, danger, warning, note.'\n            : ' Standard types support themes: default, success, danger, warning, note, special.'),\n    ],\n  });\n\n  // Warn if link type is used with icons or loading state\n  const hasLinkWithIcons = type === 'link' && (iconProp || rightIconProp);\n  const hasLinkWithLoading = type === 'link' && isLoading;\n  const hasLinkRestrictions = hasLinkWithIcons || hasLinkWithLoading;\n\n  const linkRestrictionMessages: string[] = [];\n  if (hasLinkWithIcons) {\n    linkRestrictionMessages.push('icons (`icon` or `rightIcon` props)');\n  }\n  if (hasLinkWithLoading) {\n    linkRestrictionMessages.push('loading state (`isLoading` prop)');\n  }\n\n  useWarn(hasLinkRestrictions, {\n    key: ['Item', 'link-restrictions'],\n    args: [\n      `Item: The \"link\" type does not support ${linkRestrictionMessages.join(' or ')}. Remove these props when using type=\"link\".`,\n    ],\n  });\n\n  // Determine if we should show checkbox instead of icon\n  const hasCheckbox = iconProp === 'checkbox';\n\n  // Determine if size is custom (number or unrecognized string)\n  const isCustomSize =\n    typeof size === 'number' ||\n    !(ITEM_SIZE_VALUES as readonly string[]).includes(size);\n  const sizeTokenValue =\n    typeof size === 'number' ? `${size}px` : isCustomSize ? size : undefined;\n\n  // Base mods for icon resolution (without icon-dependent mods)\n  const baseMods = useMemo<ItemMods>(\n    () => ({\n      disabled: finalIsDisabled,\n      selected: isSelected === true,\n      loading: isLoading,\n      ...(!isCustomSize && { size: size as string }),\n      type,\n      theme,\n      shape: finalShape,\n      ...mods,\n    }),\n    [\n      finalIsDisabled,\n      isSelected,\n      isLoading,\n      size,\n      isCustomSize,\n      type,\n      theme,\n      finalShape,\n      mods,\n    ],\n  );\n\n  // Resolve dynamic icon props (skip resolution for 'checkbox' special value)\n  const resolvedIcon = useMemo(() => {\n    if (hasCheckbox) {\n      return { content: null, hasSlot: true };\n    }\n    return resolveIcon(iconProp as DynamicIcon<ItemMods>, baseMods);\n  }, [iconProp, baseMods, hasCheckbox]);\n\n  const resolvedRightIcon = useMemo(\n    () => resolveIcon(rightIconProp, baseMods),\n    [rightIconProp, baseMods],\n  );\n\n  // Determine which slot to use for loading when \"auto\" is selected\n  // Must be computed before hasIconSlot/hasRightIconSlot since they depend on it\n  const resolvedLoadingSlot = useMemo(() => {\n    if (loadingSlot !== 'auto') return loadingSlot;\n\n    // Auto logic: prefer icon if present, then rightIcon, fallback to icon\n    if (resolvedRightIcon.hasSlot && !resolvedIcon.hasSlot) return 'rightIcon';\n    return 'icon'; // fallback\n  }, [loadingSlot, resolvedIcon.hasSlot, resolvedRightIcon.hasSlot]);\n\n  // Determine if icon slots should render (original slot OR loading state targets this slot)\n  const hasIconSlot =\n    resolvedIcon.hasSlot || (isLoading && resolvedLoadingSlot === 'icon');\n  const hasRightIconSlot =\n    resolvedRightIcon.hasSlot ||\n    (isLoading && resolvedLoadingSlot === 'rightIcon');\n\n  const showDescription = useMemo(() => {\n    const copyProps = { ...descriptionProps };\n    delete copyProps.id;\n    return !!(description || Object.keys(copyProps).length > 0);\n  }, [description, descriptionProps]);\n\n  // Apply loading state to appropriate slots\n  const finalIcon =\n    isLoading && resolvedLoadingSlot === 'icon' ? (\n      <LoadingIcon />\n    ) : (\n      resolvedIcon.content\n    );\n  const finalRightIcon =\n    isLoading && resolvedLoadingSlot === 'rightIcon' ? (\n      <LoadingIcon />\n    ) : (\n      resolvedRightIcon.content\n    );\n\n  // Generate stable keys for icon transitions based on icon type\n  const iconKey = hasCheckbox\n    ? 'checkbox'\n    : isLoading && resolvedLoadingSlot === 'icon'\n      ? 'loading'\n      : isValidElement(finalIcon)\n        ? (finalIcon.type as any)?.displayName ||\n          (finalIcon.type as any)?.name ||\n          'icon'\n        : finalIcon\n          ? 'icon'\n          : 'empty';\n\n  const rightIconKey =\n    isLoading && resolvedLoadingSlot === 'rightIcon'\n      ? 'loading'\n      : isValidElement(finalRightIcon)\n        ? (finalRightIcon.type as any)?.displayName ||\n          (finalRightIcon.type as any)?.name ||\n          'icon'\n        : finalRightIcon\n          ? 'icon'\n          : 'empty';\n  const finalPrefix =\n    isLoading && resolvedLoadingSlot === 'prefix' ? <LoadingIcon /> : prefix;\n\n  // Build final suffix: loading icon, custom suffix, or HotKeys hint\n  const finalSuffix =\n    isLoading && resolvedLoadingSlot === 'suffix' ? (\n      <LoadingIcon />\n    ) : (\n      suffix ??\n      (hotkeys ? (\n        <HotKeys\n          {...(keyboardShortcutProps as any)}\n          type={type === 'primary' ? 'primary' : 'default'}\n          styles={{ padding: '1x left', opacity: finalIsDisabled ? 0.5 : 1 }}\n        >\n          {hotkeys}\n        </HotKeys>\n      ) : undefined)\n    );\n\n  // Register global hotkey if provided\n  useHotkeys(\n    typeof hotkeys === 'string' ? hotkeys.toLowerCase() : '',\n    () => {\n      if (!hotkeys) return;\n      if (finalIsDisabled) return;\n      // Simulate a click on the element so all existing handlers run\n      if (ref && typeof ref === 'object' && ref.current) {\n        (ref.current as HTMLElement).click();\n      }\n    },\n    {\n      enableOnContentEditable: true,\n      enabled: !!hotkeys,\n      preventDefault: true,\n      enableOnFormTags: true,\n    },\n    [hotkeys, finalIsDisabled],\n  );\n\n  const finalMods = useMemo<ItemMods>(() => {\n    return {\n      ...baseMods,\n      'has-icon': hasIconSlot,\n      'has-start-content': !!(hasIconSlot || finalPrefix),\n      'has-end-content': !!(hasRightIconSlot || finalSuffix || actions),\n      'has-right-icon': hasRightIconSlot,\n      'has-label': hasLabel,\n      'has-prefix': !!finalPrefix,\n      'has-suffix': !!finalSuffix,\n      'has-description': showDescription,\n      'has-actions': !!actions,\n      'has-actions-content': !!(actions && actions !== true),\n      'auto-hide-actions': autoHideActions === true,\n      'preserve-actions-space': preserveActionsSpace === true,\n      'inside-wrapper': insideWrapper,\n      'actions-shown': showActions && insideWrapper,\n      checkbox: hasCheckbox,\n      description: showDescription ? finalDescriptionPlacement : 'none',\n    };\n  }, [\n    baseMods,\n    hasIconSlot,\n    hasRightIconSlot,\n    finalPrefix,\n    finalSuffix,\n    showDescription,\n    finalDescriptionPlacement,\n    hasCheckbox,\n    actions,\n    autoHideActions,\n    preserveActionsSpace,\n    hasLabel,\n    showActions,\n    insideWrapper,\n  ]);\n\n  const {\n    labelProps: finalLabelProps,\n    labelRef,\n    renderWithTooltip,\n  } = useAutoTooltip({\n    tooltip,\n    children,\n    labelProps,\n    isDynamicLabel: !!actions,\n  });\n\n  // Process children with highlight if applicable\n  const processedChildren = useMemo(() => {\n    if (typeof children === 'string' && highlight) {\n      return highlightText(\n        children,\n        highlight,\n        highlightCaseSensitive,\n        highlightStyles,\n      );\n    }\n    return children;\n  }, [children, highlight, highlightCaseSensitive, highlightStyles]);\n\n  // Render function that creates the item element\n  const renderItemElement = (\n    tooltipTriggerProps?: HTMLAttributes<HTMLElement>,\n    tooltipRef?: RefObject<HTMLElement>,\n  ) => {\n    // Use callback ref to merge multiple refs without calling hooks\n    const handleRef = (element: HTMLElement | null) => {\n      // Set the component's forwarded ref\n      if (typeof ref === 'function') {\n        ref(element as T | null);\n      } else if (ref) {\n        (ref as any).current = element;\n      }\n      // Set the tooltip ref if provided\n      if (tooltipRef) {\n        (tooltipRef as any).current = element;\n      }\n    };\n\n    return (\n      <ItemElement\n        ref={handleRef}\n        variant={\n          theme && type\n            ? (`${type === 'header' ? 'default' : theme}.${type === 'header' ? 'item' : type}` as ItemVariant)\n            : undefined\n        }\n        disabled={finalIsDisabled}\n        aria-disabled={finalIsDisabled}\n        aria-selected={isSelected}\n        mods={finalMods}\n        styles={styles}\n        tokens={sizeTokenValue ? { $size: sizeTokenValue } : undefined}\n        type={htmlType as any}\n        {...mergeProps(rest, tooltipTriggerProps || {})}\n        style={style}\n      >\n        {hasIconSlot && (\n          <div data-element=\"Icon\">\n            <IconSwitch noWrapper contentKey={iconKey}>\n              {hasCheckbox ? <CheckIcon /> : finalIcon}\n            </IconSwitch>\n          </div>\n        )}\n        {finalPrefix && <div data-element=\"Prefix\">{finalPrefix}</div>}\n        {children || labelProps\n          ? (() => {\n              const LabelTag =\n                type === 'header' || type === 'card'\n                  ? (`h${level}` as const)\n                  : 'div';\n              return (\n                <LabelTag\n                  data-element=\"Label\"\n                  {...finalLabelProps}\n                  ref={labelRef}\n                >\n                  {processedChildren}\n                </LabelTag>\n              );\n            })()\n          : null}\n        {showDescription ? (\n          <div data-element=\"Description\" {...descriptionProps}>\n            {description}\n          </div>\n        ) : null}\n        {finalSuffix && <div data-element=\"Suffix\">{finalSuffix}</div>}\n        {hasRightIconSlot && (\n          <div data-element=\"RightIcon\">\n            <IconSwitch noWrapper contentKey={rightIconKey}>\n              {finalRightIcon}\n            </IconSwitch>\n          </div>\n        )}\n        {actions && (\n          <div data-element=\"Actions\" {...ACTIONS_EVENT_HANDLERS}>\n            {actions !== true ? (\n              <ItemActionProvider\n                type={type}\n                theme={theme}\n                disableActionsFocus={disableActionsFocus}\n                isDisabled={finalIsDisabled}\n              >\n                {actions}\n              </ItemActionProvider>\n            ) : null}\n          </div>\n        )}\n      </ItemElement>\n    );\n  };\n\n  return renderWithTooltip(renderItemElement, defaultTooltipPlacement);\n};\n\nconst _Item = Object.assign(forwardRef(Item), {\n  Action: ItemAction,\n  Badge: ItemBadge,\n});\n\nexport { _Item as Item };\n\n/**\n * @deprecated Use `Item` instead. This export will be removed in a future version.\n */\nexport { _Item as ItemBase };\nexport type { CubeItemProps as CubeItemBaseProps };\n"],"mappings":"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"}

package/dist/components/content/Item/index.d.ts

@@ -0,0 +1,4 @@
+
+import { CubeItemBadgeProps, ItemBadge } from "../ItemBadge/ItemBadge.js";
+import "../ItemBadge/index.js";
+import { CubeItemProps, ItemMods, _Item } from "./Item.js";

package/dist/components/content/ItemBadge/ItemBadge.d.ts

@@ -0,0 +1,23 @@
+
+import { BaseProps } from "../../../tasty/types.js";
+import "../../../tasty/index.js";
+import { TooltipProvider } from "../../overlays/Tooltip/TooltipProvider.js";
+import * as react from "react";
+import { ComponentProps, ReactNode } from "react";
+
+//#region src/components/content/ItemBadge/ItemBadge.d.ts
+interface CubeItemBadgeProps extends BaseProps {
+  icon?: ReactNode | 'checkbox';
+  children?: ReactNode;
+  isLoading?: boolean;
+  isSelected?: boolean;
+  type?: 'primary' | 'secondary' | 'neutral' | 'clear' | (string & {});
+  theme?: 'default' | 'danger' | 'success' | 'special' | (string & {});
+  tooltip?: string | (Omit<ComponentProps<typeof TooltipProvider>, 'children'> & {
+    title?: string;
+  });
+}
+declare const ItemBadge: react.ForwardRefExoticComponent<CubeItemBadgeProps & react.RefAttributes<HTMLDivElement>>;
+//#endregion
+export { CubeItemBadgeProps, ItemBadge };
+//# sourceMappingURL=ItemBadge.d.ts.map

package/dist/components/content/ItemBadge/ItemBadge.js

@@ -0,0 +1,108 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { tasty } from "../../../tasty/tasty.js";
+import { mergeProps } from "../../../utils/react/mergeProps.js";
+import { TooltipProvider } from "../../overlays/Tooltip/TooltipProvider.js";
+import { DANGER_CLEAR_STYLES, DANGER_NEUTRAL_STYLES, DANGER_PRIMARY_STYLES, DANGER_SECONDARY_STYLES, DEFAULT_CLEAR_STYLES, DEFAULT_NEUTRAL_STYLES, DEFAULT_PRIMARY_STYLES, DEFAULT_SECONDARY_STYLES, ITEM_ACTION_BASE_STYLES, SPECIAL_CLEAR_STYLES, SPECIAL_NEUTRAL_STYLES, SPECIAL_PRIMARY_STYLES, SPECIAL_SECONDARY_STYLES, SUCCESS_CLEAR_STYLES, SUCCESS_NEUTRAL_STYLES, SUCCESS_PRIMARY_STYLES, SUCCESS_SECONDARY_STYLES } from "../../../data/item-themes.js";
+import { CheckIcon } from "../../../icons/CheckIcon.js";
+import { LoadingIcon } from "../../../icons/LoadingIcon.js";
+import { useItemActionContext } from "../../actions/ItemActionContext.js";
+import { forwardRef, useMemo } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/content/ItemBadge/ItemBadge.tsx
+const ItemBadgeElement = tasty({
+	qa: "ItemBadge",
+	styles: {
+		...ITEM_ACTION_BASE_STYLES,
+		cursor: "default"
+	},
+	variants: {
+		"default.primary": DEFAULT_PRIMARY_STYLES,
+		"default.secondary": DEFAULT_SECONDARY_STYLES,
+		"default.neutral": DEFAULT_NEUTRAL_STYLES,
+		"default.clear": DEFAULT_CLEAR_STYLES,
+		"danger.primary": DANGER_PRIMARY_STYLES,
+		"danger.secondary": DANGER_SECONDARY_STYLES,
+		"danger.neutral": DANGER_NEUTRAL_STYLES,
+		"danger.clear": DANGER_CLEAR_STYLES,
+		"success.primary": SUCCESS_PRIMARY_STYLES,
+		"success.secondary": SUCCESS_SECONDARY_STYLES,
+		"success.neutral": SUCCESS_NEUTRAL_STYLES,
+		"success.clear": SUCCESS_CLEAR_STYLES,
+		"special.primary": SPECIAL_PRIMARY_STYLES,
+		"special.secondary": SPECIAL_SECONDARY_STYLES,
+		"special.neutral": SPECIAL_NEUTRAL_STYLES,
+		"special.clear": SPECIAL_CLEAR_STYLES
+	}
+});
+const ItemBadge = forwardRef(function ItemBadge(allProps, ref) {
+	const { type: contextType, theme: contextTheme } = useItemActionContext();
+	const { type = contextType ?? "neutral", theme = contextTheme ?? "default", icon, children, isLoading = false, isSelected = false, tooltip, mods, ...rest } = allProps;
+	const hasCheckbox = icon === "checkbox";
+	const finalIcon = isLoading ? /* @__PURE__ */ jsx(LoadingIcon, {}) : hasCheckbox ? /* @__PURE__ */ jsx(CheckIcon, {}) : icon;
+	const finalMods = useMemo(() => ({
+		checkbox: hasCheckbox,
+		selected: isSelected,
+		loading: isLoading,
+		"has-label": !!children,
+		context: !!contextType,
+		...mods
+	}), [
+		hasCheckbox,
+		isSelected,
+		isLoading,
+		children,
+		contextType,
+		mods
+	]);
+	const ariaLabel = useMemo(() => {
+		if (typeof tooltip === "string") return tooltip;
+		if (typeof tooltip === "object" && tooltip.title) return tooltip.title;
+		return rest["aria-label"];
+	}, [tooltip, rest]);
+	const showTooltip = !children && tooltip;
+	const tooltipContent = useMemo(() => {
+		if (typeof tooltip === "string") return tooltip;
+		if (typeof tooltip === "object" && tooltip.title) return tooltip.title;
+	}, [tooltip]);
+	const tooltipProps = useMemo(() => {
+		if (typeof tooltip === "object") {
+			const { title, ...rest } = tooltip;
+			return rest;
+		}
+		return {};
+	}, [tooltip]);
+	const finalType = useMemo(() => {
+		return theme !== "default" && type === "neutral" ? "clear" : type;
+	}, [theme, type]);
+	const renderBadge = (tooltipTriggerProps, tooltipRef) => {
+		const handleRef = (element) => {
+			if (typeof ref === "function") ref(element);
+			else if (ref) ref.current = element;
+			if (tooltipRef) tooltipRef.current = element;
+		};
+		return /* @__PURE__ */ jsxs(ItemBadgeElement, {
+			ref: handleRef,
+			variant: `${theme}.${finalType}`,
+			"data-theme": theme,
+			"data-type": finalType,
+			"aria-label": ariaLabel,
+			mods: finalMods,
+			...mergeProps(rest, tooltipTriggerProps || {}),
+			children: [finalIcon && /* @__PURE__ */ jsx("div", {
+				"data-element": "Icon",
+				children: finalIcon
+			}), children]
+		});
+	};
+	if (showTooltip && tooltipContent) return /* @__PURE__ */ jsx(TooltipProvider, {
+		title: tooltipContent,
+		...tooltipProps,
+		children: (triggerProps, tooltipRef) => renderBadge(triggerProps, tooltipRef)
+	});
+	return renderBadge();
+});
+
+//#endregion
+export { ItemBadge };
+//# sourceMappingURL=ItemBadge.js.map

package/dist/components/content/ItemBadge/ItemBadge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemBadge.js","names":[],"sources":["../../../../src/components/content/ItemBadge/ItemBadge.tsx"],"sourcesContent":["import {\n  ComponentProps,\n  forwardRef,\n  HTMLAttributes,\n  ReactNode,\n  RefObject,\n  useMemo,\n} from 'react';\n\nimport {\n  DANGER_CLEAR_STYLES,\n  DANGER_NEUTRAL_STYLES,\n  DANGER_PRIMARY_STYLES,\n  DANGER_SECONDARY_STYLES,\n  DEFAULT_CLEAR_STYLES,\n  DEFAULT_NEUTRAL_STYLES,\n  DEFAULT_PRIMARY_STYLES,\n  DEFAULT_SECONDARY_STYLES,\n  ITEM_ACTION_BASE_STYLES,\n  SPECIAL_CLEAR_STYLES,\n  SPECIAL_NEUTRAL_STYLES,\n  SPECIAL_PRIMARY_STYLES,\n  SPECIAL_SECONDARY_STYLES,\n  SUCCESS_CLEAR_STYLES,\n  SUCCESS_NEUTRAL_STYLES,\n  SUCCESS_PRIMARY_STYLES,\n  SUCCESS_SECONDARY_STYLES,\n} from '../../../data/item-themes';\nimport { CheckIcon } from '../../../icons/CheckIcon';\nimport { LoadingIcon } from '../../../icons/LoadingIcon';\nimport { BaseProps, tasty } from '../../../tasty';\nimport { mergeProps } from '../../../utils/react';\nimport { useItemActionContext } from '../../actions/ItemActionContext';\nimport { TooltipProvider } from '../../overlays/Tooltip/TooltipProvider';\n\nexport interface CubeItemBadgeProps extends BaseProps {\n  icon?: ReactNode | 'checkbox';\n  children?: ReactNode;\n  isLoading?: boolean;\n  isSelected?: boolean;\n  type?: 'primary' | 'secondary' | 'neutral' | 'clear' | (string & {});\n  theme?: 'default' | 'danger' | 'success' | 'special' | (string & {});\n  tooltip?:\n    | string\n    | (Omit<ComponentProps<typeof TooltipProvider>, 'children'> & {\n        title?: string;\n      });\n}\n\ntype ItemBadgeVariant =\n  | 'default.primary'\n  | 'default.secondary'\n  | 'default.neutral'\n  | 'default.clear'\n  | 'danger.primary'\n  | 'danger.secondary'\n  | 'danger.neutral'\n  | 'danger.clear'\n  | 'success.primary'\n  | 'success.secondary'\n  | 'success.neutral'\n  | 'success.clear'\n  | 'special.primary'\n  | 'special.secondary'\n  | 'special.neutral'\n  | 'special.clear';\n\nconst ItemBadgeElement = tasty({\n  qa: 'ItemBadge',\n  styles: {\n    ...ITEM_ACTION_BASE_STYLES,\n    cursor: 'default',\n  },\n  variants: {\n    // Default theme\n    'default.primary': DEFAULT_PRIMARY_STYLES,\n    'default.secondary': DEFAULT_SECONDARY_STYLES,\n    'default.neutral': DEFAULT_NEUTRAL_STYLES,\n    'default.clear': DEFAULT_CLEAR_STYLES,\n\n    // Danger theme\n    'danger.primary': DANGER_PRIMARY_STYLES,\n    'danger.secondary': DANGER_SECONDARY_STYLES,\n    'danger.neutral': DANGER_NEUTRAL_STYLES,\n    'danger.clear': DANGER_CLEAR_STYLES,\n\n    // Success theme\n    'success.primary': SUCCESS_PRIMARY_STYLES,\n    'success.secondary': SUCCESS_SECONDARY_STYLES,\n    'success.neutral': SUCCESS_NEUTRAL_STYLES,\n    'success.clear': SUCCESS_CLEAR_STYLES,\n\n    // Special theme\n    'special.primary': SPECIAL_PRIMARY_STYLES,\n    'special.secondary': SPECIAL_SECONDARY_STYLES,\n    'special.neutral': SPECIAL_NEUTRAL_STYLES,\n    'special.clear': SPECIAL_CLEAR_STYLES,\n  },\n});\n\nexport const ItemBadge = forwardRef<HTMLDivElement, CubeItemBadgeProps>(\n  function ItemBadge(allProps, ref) {\n    const { type: contextType, theme: contextTheme } = useItemActionContext();\n\n    const {\n      type = contextType ?? 'neutral',\n      theme = contextTheme ?? 'default',\n      icon,\n      children,\n      isLoading = false,\n      isSelected = false,\n      tooltip,\n      mods,\n      ...rest\n    } = allProps;\n\n    // Determine if we should show checkbox\n    const hasCheckbox = icon === 'checkbox';\n\n    // Determine final icon (loading takes precedence)\n    const finalIcon = isLoading ? (\n      <LoadingIcon />\n    ) : hasCheckbox ? (\n      <CheckIcon />\n    ) : (\n      icon\n    );\n\n    // Build modifiers\n    const finalMods = useMemo(\n      () => ({\n        checkbox: hasCheckbox,\n        selected: isSelected,\n        loading: isLoading,\n        'has-label': !!children,\n        context: !!contextType,\n        ...mods,\n      }),\n      [hasCheckbox, isSelected, isLoading, children, contextType, mods],\n    );\n\n    // Extract aria-label from tooltip if needed\n    const ariaLabel = useMemo(() => {\n      if (typeof tooltip === 'string') {\n        return tooltip;\n      }\n      if (typeof tooltip === 'object' && tooltip.title) {\n        return tooltip.title;\n      }\n      return rest['aria-label'];\n    }, [tooltip, rest]);\n\n    // Determine if we should show tooltip (icon-only badges)\n    const showTooltip = !children && tooltip;\n\n    // Extract tooltip content and props\n    const tooltipContent = useMemo(() => {\n      if (typeof tooltip === 'string') {\n        return tooltip;\n      }\n      if (typeof tooltip === 'object' && tooltip.title) {\n        return tooltip.title;\n      }\n      return undefined;\n    }, [tooltip]);\n\n    const tooltipProps = useMemo(() => {\n      if (typeof tooltip === 'object') {\n        const { title, ...rest } = tooltip;\n        return rest;\n      }\n      return {};\n    }, [tooltip]);\n\n    const finalType = useMemo(() => {\n      return theme !== 'default' && type === 'neutral' ? 'clear' : type;\n    }, [theme, type]);\n\n    // Render function that accepts tooltip trigger props and ref\n    const renderBadge = (\n      tooltipTriggerProps?: HTMLAttributes<HTMLElement>,\n      tooltipRef?: RefObject<HTMLElement>,\n    ) => {\n      // Merge tooltip ref with component ref if provided\n      const handleRef = (element: HTMLDivElement | null) => {\n        // Set the component ref\n        if (typeof ref === 'function') {\n          ref(element);\n        } else if (ref) {\n          (ref as any).current = element;\n        }\n        // Set the tooltip ref\n        if (tooltipRef) {\n          (tooltipRef as any).current = element;\n        }\n      };\n\n      return (\n        <ItemBadgeElement\n          ref={handleRef}\n          variant={`${theme}.${finalType}` as ItemBadgeVariant}\n          data-theme={theme}\n          data-type={finalType}\n          aria-label={ariaLabel}\n          mods={finalMods}\n          {...mergeProps(rest, tooltipTriggerProps || {})}\n        >\n          {finalIcon && <div data-element=\"Icon\">{finalIcon}</div>}\n          {children}\n        </ItemBadgeElement>\n      );\n    };\n\n    // Wrap with tooltip if needed\n    if (showTooltip && tooltipContent) {\n      return (\n        <TooltipProvider title={tooltipContent} {...tooltipProps}>\n          {(triggerProps, tooltipRef) => renderBadge(triggerProps, tooltipRef)}\n        </TooltipProvider>\n      );\n    }\n\n    return renderBadge();\n  },\n);\n\nexport type { CubeItemBadgeProps as ItemBadgeProps };\n"],"mappings":";;;;;;;;;;;;AAmEA,MAAM,mBAAmB,MAAM;CAC7B,IAAI;CACJ,QAAQ;EACN,GAAG;EACH,QAAQ;EACT;CACD,UAAU;EAER,mBAAmB;EACnB,qBAAqB;EACrB,mBAAmB;EACnB,iBAAiB;EAGjB,kBAAkB;EAClB,oBAAoB;EACpB,kBAAkB;EAClB,gBAAgB;EAGhB,mBAAmB;EACnB,qBAAqB;EACrB,mBAAmB;EACnB,iBAAiB;EAGjB,mBAAmB;EACnB,qBAAqB;EACrB,mBAAmB;EACnB,iBAAiB;EAClB;CACF,CAAC;AAEF,MAAa,YAAY,WACvB,SAAS,UAAU,UAAU,KAAK;CAChC,MAAM,EAAE,MAAM,aAAa,OAAO,iBAAiB,sBAAsB;CAEzE,MAAM,EACJ,OAAO,eAAe,WACtB,QAAQ,gBAAgB,WACxB,MACA,UACA,YAAY,OACZ,aAAa,OACb,SACA,MACA,GAAG,SACD;CAGJ,MAAM,cAAc,SAAS;CAG7B,MAAM,YAAY,YAChB,oBAAC,gBAAc,GACb,cACF,oBAAC,cAAY,GAEb;CAIF,MAAM,YAAY,eACT;EACL,UAAU;EACV,UAAU;EACV,SAAS;EACT,aAAa,CAAC,CAAC;EACf,SAAS,CAAC,CAAC;EACX,GAAG;EACJ,GACD;EAAC;EAAa;EAAY;EAAW;EAAU;EAAa;EAAK,CAClE;CAGD,MAAM,YAAY,cAAc;AAC9B,MAAI,OAAO,YAAY,SACrB,QAAO;AAET,MAAI,OAAO,YAAY,YAAY,QAAQ,MACzC,QAAO,QAAQ;AAEjB,SAAO,KAAK;IACX,CAAC,SAAS,KAAK,CAAC;CAGnB,MAAM,cAAc,CAAC,YAAY;CAGjC,MAAM,iBAAiB,cAAc;AACnC,MAAI,OAAO,YAAY,SACrB,QAAO;AAET,MAAI,OAAO,YAAY,YAAY,QAAQ,MACzC,QAAO,QAAQ;IAGhB,CAAC,QAAQ,CAAC;CAEb,MAAM,eAAe,cAAc;AACjC,MAAI,OAAO,YAAY,UAAU;GAC/B,MAAM,EAAE,OAAO,GAAG,SAAS;AAC3B,UAAO;;AAET,SAAO,EAAE;IACR,CAAC,QAAQ,CAAC;CAEb,MAAM,YAAY,cAAc;AAC9B,SAAO,UAAU,aAAa,SAAS,YAAY,UAAU;IAC5D,CAAC,OAAO,KAAK,CAAC;CAGjB,MAAM,eACJ,qBACA,eACG;EAEH,MAAM,aAAa,YAAmC;AAEpD,OAAI,OAAO,QAAQ,WACjB,KAAI,QAAQ;YACH,IACT,CAAC,IAAY,UAAU;AAGzB,OAAI,WACF,CAAC,WAAmB,UAAU;;AAIlC,SACE,qBAAC;GACC,KAAK;GACL,SAAS,GAAG,MAAM,GAAG;GACrB,cAAY;GACZ,aAAW;GACX,cAAY;GACZ,MAAM;GACN,GAAI,WAAW,MAAM,uBAAuB,EAAE,CAAC;cAE9C,aAAa,oBAAC;IAAI,gBAAa;cAAQ;KAAgB,EACvD;IACgB;;AAKvB,KAAI,eAAe,eACjB,QACE,oBAAC;EAAgB,OAAO;EAAgB,GAAI;aACxC,cAAc,eAAe,YAAY,cAAc,WAAW;GACpD;AAItB,QAAO,aAAa;EAEvB"}

package/dist/components/content/ItemBadge/index.d.ts

@@ -0,0 +1,2 @@
+
+import { CubeItemBadgeProps, ItemBadge } from "./ItemBadge.js";

package/dist/components/content/Layout/GridLayout.d.ts

@@ -0,0 +1,42 @@
+
+import { Styles } from "../../../tasty/styles/types.js";
+import "../../../tasty/index.js";
+import { CubeLayoutProps } from "./Layout.js";
+import { _LayoutContent } from "./LayoutContent.js";
+import { _LayoutBlock } from "./LayoutBlock.js";
+import { _LayoutFlex } from "./LayoutFlex.js";
+import { _LayoutFooter } from "./LayoutFooter.js";
+import { _LayoutGrid } from "./LayoutGrid.js";
+import { _LayoutHeader } from "./LayoutHeader.js";
+import { _LayoutPane } from "./LayoutPane.js";
+import { _LayoutPanel } from "./LayoutPanel.js";
+import { _LayoutPanelHeader } from "./LayoutPanelHeader.js";
+import { _LayoutToolbar } from "./LayoutToolbar.js";
+import { ForwardRefExoticComponent, ReactNode, RefAttributes } from "react";
+
+//#region src/components/content/Layout/GridLayout.d.ts
+interface CubeGridLayoutProps extends CubeLayoutProps {
+  /** Grid template columns */
+  columns?: Styles['gridColumns'];
+  /** Grid template rows */
+  rows?: Styles['gridRows'];
+  /** Grid template shorthand */
+  template?: Styles['gridTemplate'];
+  children?: ReactNode;
+}
+interface GridLayoutComponent extends ForwardRefExoticComponent<CubeGridLayoutProps & RefAttributes<HTMLDivElement>> {
+  Toolbar: typeof _LayoutToolbar;
+  Header: typeof _LayoutHeader;
+  Footer: typeof _LayoutFooter;
+  Content: typeof _LayoutContent;
+  Block: typeof _LayoutBlock;
+  Flex: typeof _LayoutFlex;
+  Grid: typeof _LayoutGrid;
+  Pane: typeof _LayoutPane;
+  Panel: typeof _LayoutPanel;
+  PanelHeader: typeof _LayoutPanelHeader;
+}
+declare const GridLayout: GridLayoutComponent;
+//#endregion
+export { CubeGridLayoutProps, GridLayout };
+//# sourceMappingURL=GridLayout.d.ts.map

package/dist/components/content/Layout/GridLayout.js

@@ -0,0 +1,50 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { tasty } from "../../../tasty/tasty.js";
+import { _Layout } from "./Layout.js";
+import { _LayoutContent } from "./LayoutContent.js";
+import { _LayoutBlock } from "./LayoutBlock.js";
+import { _LayoutFlex } from "./LayoutFlex.js";
+import { _LayoutFooter } from "./LayoutFooter.js";
+import { _LayoutGrid } from "./LayoutGrid.js";
+import { _LayoutHeader } from "./LayoutHeader.js";
+import { _LayoutPane } from "./LayoutPane.js";
+import { _LayoutPanel } from "./LayoutPanel.js";
+import { _LayoutPanelHeader } from "./LayoutPanelHeader.js";
+import { _LayoutToolbar } from "./LayoutToolbar.js";
+import { forwardRef } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/content/Layout/GridLayout.tsx
+const GridLayoutElement = tasty(_Layout, {
+	qa: "GridLayout",
+	styles: { Inner: { display: "grid" } }
+});
+function GridLayoutBase(props, ref) {
+	const { columns, rows, template, ...otherProps } = props;
+	return /* @__PURE__ */ jsx(GridLayoutElement, {
+		ref,
+		isGrid: true,
+		gridColumns: columns,
+		gridRows: rows,
+		gridTemplate: template,
+		...otherProps
+	});
+}
+const _GridLayout = forwardRef(GridLayoutBase);
+_GridLayout.displayName = "GridLayout";
+const GridLayout = Object.assign(_GridLayout, {
+	Toolbar: _LayoutToolbar,
+	Header: _LayoutHeader,
+	Footer: _LayoutFooter,
+	Content: _LayoutContent,
+	Block: _LayoutBlock,
+	Flex: _LayoutFlex,
+	Grid: _LayoutGrid,
+	Pane: _LayoutPane,
+	Panel: _LayoutPanel,
+	PanelHeader: _LayoutPanelHeader
+});
+
+//#endregion
+export { GridLayout };
+//# sourceMappingURL=GridLayout.js.map

package/dist/components/content/Layout/GridLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridLayout.js","names":["Layout","LayoutToolbar","LayoutHeader","LayoutFooter","LayoutContent","LayoutBlock","LayoutFlex","LayoutGrid","LayoutPane","LayoutPanel","LayoutPanelHeader"],"sources":["../../../../src/components/content/Layout/GridLayout.tsx"],"sourcesContent":["import {\n  ForwardedRef,\n  forwardRef,\n  ForwardRefExoticComponent,\n  ReactNode,\n  RefAttributes,\n} from 'react';\n\nimport { Styles, tasty } from '../../../tasty';\n\nimport { CubeLayoutProps, Layout } from './Layout';\nimport { LayoutBlock } from './LayoutBlock';\nimport { LayoutContent } from './LayoutContent';\nimport { LayoutFlex } from './LayoutFlex';\nimport { LayoutFooter } from './LayoutFooter';\nimport { LayoutGrid } from './LayoutGrid';\nimport { LayoutHeader } from './LayoutHeader';\nimport { LayoutPane } from './LayoutPane';\nimport { LayoutPanel } from './LayoutPanel';\nimport { LayoutPanelHeader } from './LayoutPanelHeader';\nimport { LayoutToolbar } from './LayoutToolbar';\n\nconst GridLayoutElement = tasty(Layout, {\n  qa: 'GridLayout',\n  styles: {\n    Inner: {\n      display: 'grid',\n    },\n  },\n});\n\nexport interface CubeGridLayoutProps extends CubeLayoutProps {\n  /** Grid template columns */\n  columns?: Styles['gridColumns'];\n  /** Grid template rows */\n  rows?: Styles['gridRows'];\n  /** Grid template shorthand */\n  template?: Styles['gridTemplate'];\n  children?: ReactNode;\n}\n\nfunction GridLayoutBase(\n  props: CubeGridLayoutProps,\n  ref: ForwardedRef<HTMLDivElement>,\n) {\n  const { columns, rows, template, ...otherProps } = props;\n\n  return (\n    <GridLayoutElement\n      ref={ref}\n      isGrid\n      gridColumns={columns}\n      gridRows={rows}\n      gridTemplate={template}\n      {...otherProps}\n    />\n  );\n}\n\nconst _GridLayout = forwardRef(GridLayoutBase);\n\n_GridLayout.displayName = 'GridLayout';\n\n// Create the GridLayout with all sub-components aliased\ninterface GridLayoutComponent\n  extends ForwardRefExoticComponent<\n    CubeGridLayoutProps & RefAttributes<HTMLDivElement>\n  > {\n  Toolbar: typeof LayoutToolbar;\n  Header: typeof LayoutHeader;\n  Footer: typeof LayoutFooter;\n  Content: typeof LayoutContent;\n  Block: typeof LayoutBlock;\n  Flex: typeof LayoutFlex;\n  Grid: typeof LayoutGrid;\n  Pane: typeof LayoutPane;\n  Panel: typeof LayoutPanel;\n  PanelHeader: typeof LayoutPanelHeader;\n}\n\nconst GridLayout = Object.assign(_GridLayout, {\n  Toolbar: LayoutToolbar,\n  Header: LayoutHeader,\n  Footer: LayoutFooter,\n  Content: LayoutContent,\n  Block: LayoutBlock,\n  Flex: LayoutFlex,\n  Grid: LayoutGrid,\n  Pane: LayoutPane,\n  Panel: LayoutPanel,\n  PanelHeader: LayoutPanelHeader,\n}) as GridLayoutComponent;\n\nexport { GridLayout };\n"],"mappings":";;;;;;;;;;;;;;;;;AAsBA,MAAM,oBAAoB,MAAMA,SAAQ;CACtC,IAAI;CACJ,QAAQ,EACN,OAAO,EACL,SAAS,QACV,EACF;CACF,CAAC;AAYF,SAAS,eACP,OACA,KACA;CACA,MAAM,EAAE,SAAS,MAAM,UAAU,GAAG,eAAe;AAEnD,QACE,oBAAC;EACM;EACL;EACA,aAAa;EACb,UAAU;EACV,cAAc;EACd,GAAI;GACJ;;AAIN,MAAM,cAAc,WAAW,eAAe;AAE9C,YAAY,cAAc;AAmB1B,MAAM,aAAa,OAAO,OAAO,aAAa;CAC5C,SAASC;CACT,QAAQC;CACR,QAAQC;CACR,SAASC;CACT,OAAOC;CACP,MAAMC;CACN,MAAMC;CACN,MAAMC;CACN,OAAOC;CACP,aAAaC;CACd,CAAC"}

package/dist/components/content/Layout/Layout.d.ts

@@ -0,0 +1,40 @@
+
+import { Styles } from "../../../tasty/styles/types.js";
+import { BaseProps, BlockStyleProps, ColorStyleProps, FlowStyleProps, OuterStyleProps } from "../../../tasty/types.js";
+import "../../../tasty/index.js";
+import { ForwardedRef, HTMLAttributes, ReactNode } from "react";
+
+//#region src/components/content/Layout/Layout.d.ts
+interface CubeLayoutProps extends BaseProps, OuterStyleProps, BlockStyleProps, ColorStyleProps, FlowStyleProps {
+  /** Switch to grid display mode */
+  isGrid?: boolean;
+  /** Grid template columns (when isGrid=true) */
+  columns?: Styles['gridColumns'];
+  /** Grid template rows (when isGrid=true) */
+  rows?: Styles['gridRows'];
+  /** Grid template shorthand */
+  template?: Styles['gridTemplate'];
+  /** Padding for content areas (Layout.Content components). Default: '1x' */
+  contentPadding?: Styles['padding'];
+  /** Enable transition animation for Inner content when panels open/close */
+  hasTransition?: boolean;
+  /** Styles for wrapper and Inner sub-element */
+  styles?: Styles;
+  children?: ReactNode;
+  /** Ref for the inner content element */
+  innerRef?: ForwardedRef<HTMLDivElement>;
+  /** Props to spread on the Inner sub-element */
+  innerProps?: HTMLAttributes<HTMLDivElement>;
+  /**
+   * @internal Force show dev warning even in production (for storybook testing)
+   */
+  _forceShowDevWarning?: boolean;
+  /**
+   * When true, applies overflow: hidden to the root element.
+   * By default, overflow is visible.
+   */
+  doNotOverflow?: boolean;
+}
+//#endregion
+export { CubeLayoutProps };
+//# sourceMappingURL=Layout.d.ts.map

package/dist/components/content/Layout/Layout.js

@@ -0,0 +1,218 @@
+/** @license MIT | @cube-dev/ui-kit v0.116.0 | Cube Dev Team */
+import { extractStyles } from "../../../tasty/utils/styles.js";
+import { isDevEnv } from "../../../tasty/utils/is-dev-env.js";
+import { mergeStyles } from "../../../tasty/utils/merge-styles.js";
+import { INNER_STYLES, OUTER_STYLES } from "../../../tasty/styles/list.js";
+import { tasty } from "../../../tasty/tasty.js";
+import { filterBaseProps } from "../../../tasty/utils/filter-base-props.js";
+import { useCombinedRefs } from "../../../utils/react/useCombinedRefs.js";
+import { Alert } from "../Alert/Alert.js";
+import { LayoutProvider, useLayoutActionsContext, useLayoutRefsContext, useLayoutStateContext } from "./LayoutContext.js";
+import { forwardRef, useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/content/Layout/Layout.tsx
+const LayoutElement = tasty({
+	as: "div",
+	qa: "Layout",
+	styles: {
+		position: "relative",
+		display: "block",
+		overflow: {
+			"": "visible",
+			"do-not-overflow": "hidden"
+		},
+		flexGrow: 1,
+		placeSelf: "stretch",
+		height: {
+			"": "auto",
+			"auto-height": "fixed 100%",
+			collapsed: "6x"
+		},
+		"$content-padding": "1x",
+		"$layout-border-size": {
+			"": "0",
+			vertical: "1bw"
+		},
+		Inner: {
+			$: ">",
+			container: "layout / inline-size",
+			position: "absolute",
+			inset: "$inset-top $inset-right $inset-bottom $inset-left",
+			display: "flex",
+			flow: "column",
+			placeContent: "stretch",
+			placeItems: "stretch",
+			transition: {
+				"": "none",
+				"has-transition": "inset $transition ease-out",
+				"dragging | not-ready": "none"
+			}
+		}
+	}
+});
+function LayoutInner(props) {
+	const layoutActions = useLayoutActionsContext();
+	const layoutState = useLayoutStateContext();
+	const layoutRefs = useLayoutRefsContext();
+	const localRef = useRef(null);
+	const [isAutoHeight, setIsAutoHeight] = useState(false);
+	const [isCollapsed, setIsCollapsed] = useState(false);
+	const { isGrid, columns, rows, template, contentPadding, hasTransition = false, styles, children, style, forwardedRef, innerRef: innerRefProp, innerProps, _forceShowDevWarning, doNotOverflow, ...otherProps } = props;
+	const combinedInnerRef = useCombinedRefs(innerRefProp);
+	const outerStyles = extractStyles(otherProps, OUTER_STYLES);
+	const innerStyles = extractStyles(otherProps, INNER_STYLES);
+	const isVertical = useMemo(() => {
+		const flowFromProp = innerStyles?.flow;
+		const flowFromStyles = (styles?.Inner)?.flow;
+		const flowValue = flowFromProp ?? flowFromStyles;
+		return typeof flowValue !== "string" || !flowValue.startsWith("row");
+	}, [innerStyles?.flow, styles?.Inner]);
+	const finalStyles = useMemo(() => {
+		const gridStyles = {};
+		if (isGrid) gridStyles.display = "grid";
+		if (columns) gridStyles.gridColumns = columns;
+		if (rows) gridStyles.gridRows = rows;
+		if (template) gridStyles.gridTemplate = template;
+		return mergeStyles(outerStyles, contentPadding != null ? { "$content-padding": contentPadding } : null, styles, { Inner: mergeStyles(innerStyles, gridStyles, styles?.Inner) });
+	}, [
+		outerStyles,
+		innerStyles,
+		contentPadding,
+		styles,
+		isGrid,
+		columns,
+		rows,
+		template
+	]);
+	const panelSizes = layoutState?.panelSizes ?? {
+		left: 0,
+		top: 0,
+		right: 0,
+		bottom: 0
+	};
+	const isDragging = layoutState?.isDragging ?? false;
+	const isReady = layoutState?.isReady ?? true;
+	const markReady = layoutActions?.markReady;
+	const dismissOverlayPanels = layoutActions?.dismissOverlayPanels;
+	const hasOverlayPanels = layoutState?.hasOverlayPanels ?? false;
+	useEffect(() => {
+		const frameId = requestAnimationFrame(() => {
+			markReady?.();
+		});
+		return () => cancelAnimationFrame(frameId);
+	}, [markReady]);
+	useEffect(() => {
+		if (isReady && localRef.current && localRef.current.offsetHeight === 0) setIsAutoHeight(true);
+	}, [isReady]);
+	useEffect(() => {
+		if (isAutoHeight && localRef.current) {
+			const frameId = requestAnimationFrame(() => {
+				if (localRef.current && localRef.current.offsetHeight === 0) setIsCollapsed(true);
+			});
+			return () => cancelAnimationFrame(frameId);
+		}
+	}, [isAutoHeight]);
+	const insetStyle = useMemo(() => {
+		const baseStyle = {
+			"--inset-top": `${panelSizes.top}px`,
+			"--inset-right": `${panelSizes.right}px`,
+			"--inset-bottom": `${panelSizes.bottom}px`,
+			"--inset-left": `${panelSizes.left}px`
+		};
+		if (style) return {
+			...baseStyle,
+			...style
+		};
+		return baseStyle;
+	}, [panelSizes, style]);
+	const mods = useMemo(() => ({
+		dragging: isDragging,
+		"not-ready": !isReady,
+		"has-transition": hasTransition,
+		"auto-height": isAutoHeight && !isCollapsed,
+		collapsed: isCollapsed,
+		vertical: isVertical,
+		"do-not-overflow": doNotOverflow
+	}), [
+		isDragging,
+		isReady,
+		hasTransition,
+		isAutoHeight,
+		isCollapsed,
+		isVertical,
+		doNotOverflow
+	]);
+	const setRefs = (element) => {
+		localRef.current = element;
+		if (typeof forwardedRef === "function") forwardedRef(element);
+		else if (forwardedRef) forwardedRef.current = element;
+	};
+	const showDevWarning = isCollapsed && (_forceShowDevWarning || isDevEnv());
+	const handleInnerFocus = useCallback((e) => {
+		if (!hasOverlayPanels) return;
+		const inner = e.currentTarget;
+		const relatedTarget = e.relatedTarget;
+		if (!relatedTarget || !inner.contains(relatedTarget)) dismissOverlayPanels?.();
+	}, [hasOverlayPanels, dismissOverlayPanels]);
+	const handleKeyDown = useCallback((e) => {
+		if (hasOverlayPanels && e.key === "Escape") {
+			e.preventDefault();
+			e.stopPropagation();
+			dismissOverlayPanels?.();
+		}
+	}, [hasOverlayPanels, dismissOverlayPanels]);
+	return /* @__PURE__ */ jsx(LayoutElement, {
+		ref: setRefs,
+		...filterBaseProps(otherProps, { eventProps: true }),
+		mods,
+		styles: finalStyles,
+		style: insetStyle,
+		onKeyDown: hasOverlayPanels ? handleKeyDown : void 0,
+		children: showDevWarning ? /* @__PURE__ */ jsxs(Alert, {
+			theme: "danger",
+			children: [
+				/* @__PURE__ */ jsx("b", { children: "UIKit:" }),
+				" ",
+				/* @__PURE__ */ jsx("b", { children: "<Layout/>" }),
+				" has collapsed to ",
+				/* @__PURE__ */ jsx("b", { children: "0" }),
+				" height. Ensure the parent container has a defined height or use the",
+				" ",
+				/* @__PURE__ */ jsx("b", { children: "height" }),
+				" prop on ",
+				/* @__PURE__ */ jsx("b", { children: "<Layout/>" }),
+				"."
+			]
+		}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("div", {
+			ref: combinedInnerRef,
+			"data-element": "Inner",
+			onFocus: handleInnerFocus,
+			...innerProps,
+			children
+		}), /* @__PURE__ */ jsx("div", {
+			ref: layoutRefs?.setPanelContainer,
+			"data-element": "PanelContainer"
+		})] })
+	});
+}
+/**
+* Layout component provides a vertical flex layout with overflow-safe content.
+* Uses a two-element architecture (wrapper + content) to ensure content never overflows.
+*/
+function Layout(props, ref) {
+	const { hasTransition } = props;
+	return /* @__PURE__ */ jsx(LayoutProvider, {
+		hasTransition,
+		children: /* @__PURE__ */ jsx(LayoutInner, {
+			...props,
+			forwardedRef: ref
+		})
+	});
+}
+const _Layout = forwardRef(Layout);
+_Layout.displayName = "Layout";
+
+//#endregion
+export { _Layout };
+//# sourceMappingURL=Layout.js.map