@allxsmith/bestax-bulma 5.35.0 → 5.36.0

package/dist/esm/components/EmptyState.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmptyState.js","sources":["../../../src/components/EmptyState.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { Buttons, ButtonsProps } from '../elements/Buttons';\nimport { Icon } from '../elements/Icon';\nimport { Paragraph, ParagraphProps } from '../elements/Paragraph';\nimport { Title, TitleProps } from '../elements/Title';\n\nconst validEmptyStateColors = [\n  'primary',\n  'link',\n  'info',\n  'success',\n  'warning',\n  'danger',\n] as const;\n/** The Bulma colors the indicator takes. */\nexport type EmptyStateColor = (typeof validEmptyStateColors)[number];\n\nconst validEmptyStateHeadings = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'] as const;\n/** A title's heading level. It's always a heading, so there's no `p`. */\nexport type EmptyStateHeading = (typeof validEmptyStateHeadings)[number];\n\nconst validEmptyStateSizes = ['small', 'medium', 'large'] as const;\n\n/**\n * Props for the EmptyState component. The helper props, the other attributes\n * and the `ref` land on the root `<div>`. The native `title` attribute isn't\n * one of them, since `title` here is the heading.\n *\n * @extraProp {React.Ref<HTMLDivElement>} [ref] - Ref forwarded to the root `<div>`.\n */\nexport interface EmptyStateProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'title'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /**\n   * The picture in the indicator's circle. A string is an `Icon` name, drawn\n   * from the icon library `ConfigProvider` sets. Anything else (an `<Icon>`\n   * with its own `variant` or `library`, an SVG, an `<img>`) renders as it is.\n   * It's decorative and hidden from assistive tech, so the title says what\n   * it means.\n   */\n  icon?: React.ReactNode;\n  /**\n   * The heading, rendered as `EmptyState.Title`. It's always a real heading,\n   * at the level `titleAs` sets.\n   */\n  title?: React.ReactNode;\n  /**\n   * The heading level for `title`: the level under the heading of the list\n   * it stands in for, such as `h3` for a list under an `h2`. Only this sets\n   * the level, and the size comes from `size`.\n   */\n  titleAs?: EmptyStateHeading;\n  /** A sentence or two under the title, rendered as `EmptyState.Description`. */\n  description?: React.ReactNode;\n  /**\n   * Rendered as written, after whatever `icon`, `title` and `description`\n   * render. One button can go straight in, and it sits centered under the\n   * text. Group two or more in `EmptyState.Actions`, or they stack. Without\n   * the props, write the parts here in the order they're shown:\n   * `EmptyState.Indicator`, `.Title`, `.Description`, then the actions.\n   */\n  children?: React.ReactNode;\n  /**\n   * The indicator's color. It colors the circle and its icon, not the text.\n   * Without it the circle is neutral, since an empty list isn't a status.\n   */\n  color?: EmptyStateColor;\n  /**\n   * `light` is a soft tint of `color` behind the icon in the color. `filled`\n   * is the color itself, with the icon in its invert.\n   */\n  variant?: 'light' | 'filled';\n  /** Sizes the indicator, the title, the description and the spacing together. */\n  size?: 'small' | 'normal' | 'medium' | 'large';\n  /**\n   * `center` stacks everything in a centered column. `left` puts the\n   * indicator beside the text, at the start of the line, so on the right in\n   * a right-to-left page, and keeps the block at least as tall as the circle\n   * whatever block padding is in effect. Without an indicator, it only puts\n   * the text at the start of the line. In `left`, the padding at the start\n   * of the line is what makes room for the indicator, so pad it with `py`\n   * rather than `p` or `px`.\n   */\n  align?: 'center' | 'left';\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/** Props for EmptyState.Indicator, the circle the picture sits in. */\nexport interface EmptyStateIndicatorProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /**\n   * The picture: an `Icon`, an SVG or an `<img>`. The indicator is hidden\n   * from assistive tech, an `Icon` with an `ariaLabel` included, so anything\n   * it means goes in the title or the description.\n   */\n  children?: React.ReactNode;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/**\n * Props for EmptyState.Title. It renders `Title` with `as` and never `size`,\n * so the level is `as` alone and the size comes from the EmptyState.\n */\nexport interface EmptyStateTitleProps extends Omit<\n  TitleProps,\n  'as' | 'size' | 'isSpaced'\n> {\n  /**\n   * The heading level: the level under the heading of the list the empty\n   * state stands in for.\n   */\n  as?: EmptyStateHeading;\n}\n\n/** Props for EmptyState.Description, a `<p>` under the title. */\nexport type EmptyStateDescriptionProps = ParagraphProps;\n\n/**\n * Props for EmptyState.Actions, the row of buttons. It renders `Buttons`,\n * and the EmptyState aligns it, so `isCentered` and `isRight` are left out.\n */\nexport type EmptyStateActionsProps = Omit<\n  ButtonsProps,\n  'isCentered' | 'isRight'\n>;\n\n/**\n * The circle the picture sits in, hidden from assistive tech whatever is in it.\n *\n * @function\n * @param {EmptyStateIndicatorProps} props - Props for EmptyState.Indicator.\n * @returns {JSX.Element} The rendered indicator.\n */\nexport const EmptyStateIndicator: React.FC<EmptyStateIndicatorProps> = ({\n  className,\n  textColor,\n  bgColor,\n  children,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor,\n    backgroundColor: bgColor,\n    ...props,\n  });\n  const indicatorClass = usePrefixedClassNames('empty-state-indicator');\n\n  // Hidden after the rest of the props, so nothing passed in can expose the\n  // picture: the title says what it means.\n  return (\n    <div\n      className={classNames(indicatorClass, bulmaHelperClasses, className)}\n      {...rest}\n      aria-hidden=\"true\"\n    >\n      {children}\n    </div>\n  );\n};\n\nEmptyStateIndicator.displayName = 'EmptyState.Indicator';\n\n/**\n * The heading, a Bulma `Title` at the level `as` sets, `h2` by default, and at the EmptyState's size.\n *\n * @function\n * @param {EmptyStateTitleProps} props - Props for EmptyState.Title.\n * @returns {JSX.Element} The rendered heading.\n */\nexport const EmptyStateTitle: React.FC<EmptyStateTitleProps> = ({\n  as = 'h2',\n  className,\n  ...props\n}) => {\n  // `size` isn't in the type, but on `Title` it picks the tag, so it's kept\n  // off even when it's passed anyway. The level is `as` alone.\n  const { size: _size, ...rest } = props as typeof props & { size?: unknown };\n  const titleClass = usePrefixedClassNames('empty-state-title');\n  const level = validEmptyStateHeadings.includes(as) ? as : 'h2';\n\n  return (\n    <Title as={level} className={classNames(titleClass, className)} {...rest} />\n  );\n};\n\nEmptyStateTitle.displayName = 'EmptyState.Title';\n\n/**\n * A sentence or two under the title, in the color of the text around it.\n *\n * @function\n * @param {EmptyStateDescriptionProps} props - Props for EmptyState.Description.\n * @returns {JSX.Element} The rendered description.\n */\nexport const EmptyStateDescription: React.FC<EmptyStateDescriptionProps> = ({\n  className,\n  ...props\n}) => {\n  const descriptionClass = usePrefixedClassNames('empty-state-description');\n  return (\n    <Paragraph className={classNames(descriptionClass, className)} {...props} />\n  );\n};\n\nEmptyStateDescription.displayName = 'EmptyState.Description';\n\n/**\n * A row of buttons, centered under the text or at the start of the line beside the indicator.\n *\n * @function\n * @param {EmptyStateActionsProps} props - Props for EmptyState.Actions.\n * @returns {JSX.Element} The rendered row of buttons.\n */\nexport const EmptyStateActions: React.FC<EmptyStateActionsProps> = ({\n  className,\n  ...props\n}) => {\n  const actionsClass = usePrefixedClassNames('empty-state-actions');\n  return <Buttons className={classNames(actionsClass, className)} {...props} />;\n};\n\nEmptyStateActions.displayName = 'EmptyState.Actions';\n\n/** Whether a shorthand prop was given something to render. */\nconst isGiven = (node: React.ReactNode) =>\n  node !== undefined &&\n  node !== null &&\n  typeof node !== 'boolean' &&\n  node !== '';\n\n/**\n * The `EmptyState` component renders the block an app shows where content would be: an empty list, a search with no results, or a first-run screen.\n *\n * It's a column of a picture in a circle, a heading, a line of text and the\n * actions, with one layout whether it's written with the `icon`, `title` and\n * `description` props or with the parts. The children always render as\n * written, after the parts the props render.\n *\n * It has no role and no live region. It arrives already filled and goes away\n * when results come back, so it can't announce a search that matched\n * nothing: keep a `role=\"status\"` region beside the search field for that,\n * in the page the whole time. While the data loads, show a `Skeleton` or a\n * `Loader` instead, so \"No projects yet\" doesn't flash first, and show a\n * load that failed in a `Message` or a `Notification`.\n *\n * @function\n * @param {EmptyStateProps} props - Props for the EmptyState component.\n * @param {React.Ref<HTMLDivElement>} ref - Forwarded ref to the root `<div>`.\n * @returns {JSX.Element} The rendered empty state.\n *\n * @example\n * <EmptyState\n *   icon=\"folder-open\"\n *   title=\"No projects yet\"\n *   description=\"Projects you create or join show up here.\"\n * >\n *   <Button color=\"primary\">New project</Button>\n * </EmptyState>\n */\nconst EmptyStateRoot = forwardRef<HTMLDivElement, EmptyStateProps>(\n  (\n    {\n      className,\n      icon,\n      title,\n      titleAs = 'h2',\n      description,\n      children,\n      color,\n      variant = 'light',\n      size = 'normal',\n      align = 'center',\n      textColor,\n      bgColor,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses({\n      color: textColor,\n      backgroundColor: bgColor,\n      ...props,\n    });\n    const rootClass = usePrefixedClassNames('empty-state', {\n      [`is-${size}`]: (validEmptyStateSizes as readonly string[]).includes(\n        size\n      ),\n      'is-left': align === 'left',\n      [`is-${color}`]:\n        !!color && (validEmptyStateColors as readonly string[]).includes(color),\n      'is-filled': variant === 'filled',\n    });\n\n    // The props' parts first, each only when it's given, then the children\n    // exactly as they were written: nothing here looks at them.\n    return (\n      <div\n        ref={ref}\n        className={classNames(rootClass, bulmaHelperClasses, className)}\n        {...rest}\n      >\n        {isGiven(icon) && (\n          <EmptyStateIndicator>\n            {typeof icon === 'string' ? <Icon name={icon} /> : icon}\n          </EmptyStateIndicator>\n        )}\n        {isGiven(title) && (\n          <EmptyStateTitle as={titleAs}>{title}</EmptyStateTitle>\n        )}\n        {isGiven(description) && (\n          <EmptyStateDescription>{description}</EmptyStateDescription>\n        )}\n        {children}\n      </div>\n    );\n  }\n);\n\nexport const EmptyState = withSubComponents(\n  EmptyStateRoot,\n  {\n    Indicator: EmptyStateIndicator,\n    Title: EmptyStateTitle,\n    Description: EmptyStateDescription,\n    Actions: EmptyStateActions,\n  },\n  'EmptyState'\n);\n\nexport default EmptyState;\n"],"names":["_jsx","_jsxs"],"mappings":"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"}
+{"version":3,"file":"EmptyState.js","sources":["../../../src/components/EmptyState.tsx"],"sourcesContent":["import React, { forwardRef } from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { Buttons, ButtonsProps } from '../elements/Buttons';\nimport { Icon } from '../elements/Icon';\nimport { Paragraph, ParagraphProps } from '../elements/Paragraph';\nimport { Title, TitleProps } from '../elements/Title';\n\nconst validEmptyStateColors = [\n  'primary',\n  'link',\n  'info',\n  'success',\n  'warning',\n  'danger',\n] as const;\n/** The Bulma colors the indicator takes. */\nexport type EmptyStateColor = (typeof validEmptyStateColors)[number];\n\nconst validEmptyStateHeadings = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'] as const;\n/** A title's heading level. It's always a heading, so there's no `p`. */\nexport type EmptyStateHeading = (typeof validEmptyStateHeadings)[number];\n\nconst validEmptyStateSizes = ['small', 'medium', 'large'] as const;\n\n/**\n * Props for the EmptyState component. The helper props, the other attributes\n * and the `ref` land on the root `<div>`. The native `title` attribute isn't\n * one of them, since `title` here is the heading.\n *\n * @extraProp {React.Ref<HTMLDivElement>} [ref] - Ref forwarded to the root `<div>`.\n */\nexport interface EmptyStateProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'title'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /**\n   * The picture in the indicator's circle. A string is an `Icon` name, drawn\n   * from the icon library `ConfigProvider` sets. Anything else (an `<Icon>`\n   * with its own `variant` or `library`, an SVG, an `<img>`) renders as it is.\n   * It's decorative and hidden from assistive tech, so the title says what\n   * it means.\n   */\n  icon?: React.ReactNode;\n  /**\n   * The heading, rendered as `EmptyState.Title`. It's always a real heading,\n   * at the level `titleAs` sets.\n   */\n  title?: React.ReactNode;\n  /**\n   * The heading level for `title`: the level under the heading of the list\n   * it stands in for, such as `h3` for a list under an `h2`. Only this sets\n   * the level, and the size comes from `size`.\n   */\n  titleAs?: EmptyStateHeading;\n  /** A sentence or two under the title, rendered as `EmptyState.Description`. */\n  description?: React.ReactNode;\n  /**\n   * Rendered as written, after whatever `icon`, `title` and `description`\n   * render. One button can go straight in, and it sits centered under the\n   * text. Group two or more in `EmptyState.Actions`, or they stack. Without\n   * the props, write the parts here in the order they're shown:\n   * `EmptyState.Indicator`, `.Title`, `.Description`, then the actions.\n   */\n  children?: React.ReactNode;\n  /**\n   * The indicator's color. It colors the circle and its icon, not the text.\n   * Without it the circle is neutral, since an empty list isn't a status.\n   */\n  color?: EmptyStateColor;\n  /**\n   * `light` is a soft tint of `color` behind the icon in the color. `filled`\n   * is the color itself, with the icon in its invert.\n   */\n  variant?: 'light' | 'filled';\n  /** Sizes the indicator, the title, the description and the spacing together. */\n  size?: 'small' | 'normal' | 'medium' | 'large';\n  /**\n   * `center` stacks everything in a centered column. `left` puts the\n   * indicator beside the text, at the start of the line, so on the right in\n   * a right-to-left page, and keeps the block at least as tall as the circle\n   * whatever block padding is in effect. Without an indicator, it only puts\n   * the text at the start of the line. In `left`, the padding at the start\n   * of the line is what makes room for the indicator, so pad it with `py`\n   * rather than `p` or `px`.\n   */\n  align?: 'center' | 'left';\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/** Props for EmptyState.Indicator, the circle the picture sits in. */\nexport interface EmptyStateIndicatorProps\n  extends\n    Omit<React.HTMLAttributes<HTMLDivElement>, 'color'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /**\n   * The picture: an `Icon`, an SVG or an `<img>`. The indicator is hidden\n   * from assistive tech, an `Icon` with an `ariaLabel` included, so anything\n   * it means goes in the title or the description.\n   */\n  children?: React.ReactNode;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/**\n * Props for EmptyState.Title. It renders `Title` with `as` and never `size`,\n * so the level is `as` alone and the size comes from the EmptyState.\n */\nexport interface EmptyStateTitleProps extends Omit<\n  TitleProps,\n  'as' | 'size' | 'isSpaced'\n> {\n  /**\n   * The heading level: the level under the heading of the list the empty\n   * state stands in for.\n   */\n  as?: EmptyStateHeading;\n}\n\n/** Props for EmptyState.Description, a `<p>` under the title. */\nexport type EmptyStateDescriptionProps = ParagraphProps;\n\n/**\n * Props for EmptyState.Actions, the row of buttons. It renders `Buttons`,\n * and the EmptyState aligns it, so `isCentered` and `isRight` are left out.\n */\nexport type EmptyStateActionsProps = Omit<\n  ButtonsProps,\n  'isCentered' | 'isRight'\n>;\n\n/**\n * The circle the picture sits in, hidden from assistive tech whatever is in it.\n *\n * @function\n * @param {EmptyStateIndicatorProps} props - Props for EmptyState.Indicator.\n * @returns {JSX.Element} The rendered indicator.\n */\nexport const EmptyStateIndicator: React.FC<EmptyStateIndicatorProps> = ({\n  className,\n  textColor,\n  bgColor,\n  children,\n  ...props\n}) => {\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor,\n    backgroundColor: bgColor,\n    ...props,\n  });\n  const indicatorClass = usePrefixedClassNames('empty-state-indicator');\n\n  // Hidden after the rest of the props, so nothing passed in can expose the\n  // picture: the title says what it means.\n  return (\n    <div\n      className={classNames(indicatorClass, bulmaHelperClasses, className)}\n      {...rest}\n      aria-hidden=\"true\"\n    >\n      {children}\n    </div>\n  );\n};\n\nEmptyStateIndicator.displayName = 'EmptyState.Indicator';\n\n/**\n * The heading, a Bulma `Title` at the level `as` sets, `h2` by default, and at the EmptyState's size.\n *\n * @function\n * @param {EmptyStateTitleProps} props - Props for EmptyState.Title.\n * @returns {JSX.Element} The rendered heading.\n */\nexport const EmptyStateTitle: React.FC<EmptyStateTitleProps> = ({\n  as = 'h2',\n  className,\n  ...props\n}) => {\n  // `size` isn't in the type, but on `Title` it picks the tag, so it's kept\n  // off even when it's passed anyway. The level is `as` alone.\n  const { size: _size, ...rest } = props as typeof props & { size?: unknown };\n  const titleClass = usePrefixedClassNames('empty-state-title');\n  const level = validEmptyStateHeadings.includes(as) ? as : 'h2';\n\n  return (\n    <Title as={level} className={classNames(titleClass, className)} {...rest} />\n  );\n};\n\nEmptyStateTitle.displayName = 'EmptyState.Title';\n\n/**\n * A sentence or two under the title, in the color of the text around it.\n *\n * @function\n * @param {EmptyStateDescriptionProps} props - Props for EmptyState.Description.\n * @returns {JSX.Element} The rendered description.\n */\nexport const EmptyStateDescription: React.FC<EmptyStateDescriptionProps> = ({\n  className,\n  ...props\n}) => {\n  const descriptionClass = usePrefixedClassNames('empty-state-description');\n  return (\n    <Paragraph className={classNames(descriptionClass, className)} {...props} />\n  );\n};\n\nEmptyStateDescription.displayName = 'EmptyState.Description';\n\n/**\n * A row of buttons, centered under the text or at the start of the line beside the indicator.\n *\n * @function\n * @param {EmptyStateActionsProps} props - Props for EmptyState.Actions.\n * @returns {JSX.Element} The rendered row of buttons.\n */\nexport const EmptyStateActions: React.FC<EmptyStateActionsProps> = ({\n  className,\n  ...props\n}) => {\n  const actionsClass = usePrefixedClassNames('empty-state-actions');\n  return <Buttons className={classNames(actionsClass, className)} {...props} />;\n};\n\nEmptyStateActions.displayName = 'EmptyState.Actions';\n\n/** Whether a shorthand prop was given something to render. */\nconst isGiven = (node: React.ReactNode) =>\n  node !== undefined &&\n  node !== null &&\n  typeof node !== 'boolean' &&\n  node !== '';\n\n/**\n * The `EmptyState` component renders the block an app shows where content would be: an empty list, a search with no results, or a first-run screen.\n *\n * It's a column of a picture in a circle, a heading, a line of text and the\n * actions, with one layout whether it's written with the `icon`, `title` and\n * `description` props or with the parts. The children always render as\n * written, after the parts the props render.\n *\n * It has no role and no live region. It arrives already filled and goes away\n * when results come back, so it can't announce a search that matched\n * nothing: keep a `role=\"status\"` region beside the search field for that,\n * in the page the whole time. While the data loads, show a `Skeleton` or a\n * `Loader` instead, so \"No projects yet\" doesn't flash first, and show a\n * load that failed in a `Message` or a `Notification`.\n *\n * @function\n * @param {EmptyStateProps} props - Props for the EmptyState component.\n * @param {React.Ref<HTMLDivElement>} ref - Forwarded ref to the root `<div>`.\n * @returns {JSX.Element} The rendered empty state.\n *\n * @example\n * <EmptyState\n *   icon=\"folder-open\"\n *   title=\"No projects yet\"\n *   description=\"Projects you create or join show up here.\"\n * >\n *   <Button color=\"primary\">New project</Button>\n * </EmptyState>\n */\nconst EmptyStateRoot = forwardRef<HTMLDivElement, EmptyStateProps>(\n  (\n    {\n      className,\n      icon,\n      title,\n      titleAs = 'h2',\n      description,\n      children,\n      color,\n      variant = 'light',\n      size = 'normal',\n      align = 'center',\n      textColor,\n      bgColor,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses({\n      color: textColor,\n      backgroundColor: bgColor,\n      ...props,\n    });\n    const rootClass = usePrefixedClassNames('empty-state', {\n      [`is-${size}`]: (validEmptyStateSizes as readonly string[]).includes(\n        size\n      ),\n      'is-left': align === 'left',\n      [`is-${color}`]:\n        !!color && (validEmptyStateColors as readonly string[]).includes(color),\n      'is-filled': variant === 'filled',\n    });\n\n    // The props' parts first, each only when it's given, then the children\n    // exactly as they were written: nothing here looks at them.\n    return (\n      <div\n        ref={ref}\n        className={classNames(rootClass, bulmaHelperClasses, className)}\n        {...rest}\n      >\n        {isGiven(icon) && (\n          <EmptyStateIndicator>\n            {typeof icon === 'string' ? <Icon name={icon} /> : icon}\n          </EmptyStateIndicator>\n        )}\n        {isGiven(title) && (\n          <EmptyStateTitle as={titleAs}>{title}</EmptyStateTitle>\n        )}\n        {isGiven(description) && (\n          <EmptyStateDescription>{description}</EmptyStateDescription>\n        )}\n        {children}\n      </div>\n    );\n  }\n);\n\nexport const EmptyState = withSubComponents(\n  EmptyStateRoot,\n  {\n    Indicator: EmptyStateIndicator,\n    Title: EmptyStateTitle,\n    Description: EmptyStateDescription,\n    Actions: EmptyStateActions,\n  },\n  'EmptyState'\n);\n\nexport default EmptyState;\n"],"names":["_jsx","isGiven","_jsxs"],"mappings":"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"}

package/dist/esm/components/Timeline.js

@@ -0,0 +1,150 @@
+/* @allxsmith/bestax-bulma — AI agents: see AGENTS.md in the package root, or https://bestax.io/llms.txt */
+import { jsx, jsxs } from 'react/jsx-runtime';
+import React, { createContext, forwardRef, useContext } from 'react';
+import { usePrefixedClassNames, classNames } from '../helpers/classNames.js';
+import { useBulmaClasses } from '../helpers/useBulmaClasses.js';
+import { flattenChildren } from '../helpers/flattenChildren.js';
+import { visuallyHidden } from '../helpers/statusRegion.js';
+import { withSubComponents } from '../helpers/withSubComponents.js';
+import { Icon } from '../elements/Icon.js';
+
+const validTimelineColors = [
+    'primary',
+    'link',
+    'info',
+    'success',
+    'warning',
+    'danger',
+];
+const validTimelineTitleElements = ['h2', 'h3', 'h4', 'h5', 'h6', 'p'];
+// An item outside a Timeline is a record item with an h2 title.
+const TimelineItemContext = createContext({
+    titleAs: 'h2',
+});
+/** Whether a prop was given something to render. */
+const isGiven = (node) => node !== undefined &&
+    node !== null &&
+    typeof node !== 'boolean' &&
+    node !== '';
+const isTimelineColor = (color) => !!color && validTimelineColors.includes(color);
+/**
+ * One event: a marker on the rail, then its title, its time and anything else about it.
+ *
+ * Outside a `Timeline` it's a record item with an `h2` title, though the
+ * styles are registered on `.timeline`, so the rail and the marker need one.
+ *
+ * @function
+ * @param {TimelineItemProps} props - Props for Timeline.Item.
+ * @param {React.Ref<HTMLLIElement>} ref - Forwarded ref to the `<li>`.
+ * @returns {JSX.Element} The rendered event.
+ *
+ * @example
+ * <Timeline.Item title="Shipped" time="14 October 2026" dateTime="2026-10-14">
+ *   Left the warehouse in Leeds.
+ * </Timeline.Item>
+ */
+const TimelineItem = forwardRef(({ className, title, time, dateTime, icon, color, textColor, bgColor, children, ...props }, ref) => {
+    const { titleAs: TitleTag, state, label } = useContext(TimelineItemContext);
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        backgroundColor: bgColor,
+        ...props,
+    });
+    const itemClass = usePrefixedClassNames('timeline-item', {
+        [`is-${state}`]: !!state,
+        [`is-${color}`]: isTimelineColor(color),
+    });
+    const markerClass = usePrefixedClassNames('timeline-marker', {
+        'is-icon': isGiven(icon),
+    });
+    const contentClass = usePrefixedClassNames('timeline-content');
+    const titleClass = usePrefixedClassNames('timeline-title');
+    const timeClass = usePrefixedClassNames('timeline-time');
+    // The state in words, read after the title so it's in the heading too:
+    // "Packed completed". The current item has none, since aria-current
+    // says it. The styles are inline, so the words stay hidden in a modular
+    // build that leaves out Bulma's helper classes.
+    const words = label ? (jsx("span", { style: visuallyHidden, children: ` ${label}` })) : null;
+    return (jsxs("li", { ref: ref, className: classNames(itemClass, bulmaHelperClasses, className), ...rest, ...(state && {
+            'aria-current': state === 'active' ? 'step' : undefined,
+        }), children: [jsx("div", { className: markerClass, "aria-hidden": "true", children: isGiven(icon) &&
+                    (typeof icon === 'string' ? jsx(Icon, { name: icon }) : icon) }), jsxs("div", { className: contentClass, children: [isGiven(title) ? (jsxs(TitleTag, { className: titleClass, children: [title, words] })) : (words), isGiven(time) &&
+                        (dateTime ? (jsx("time", { className: timeClass, dateTime: dateTime, children: time })) : (jsx("span", { className: timeClass, children: time }))), children] })] }));
+});
+TimelineItem.displayName = 'Timeline.Item';
+/**
+ * The `Timeline` component renders a list of events in the order they happened, each with a marker on a line down the side.
+ *
+ * By default it's a record, an order's history, a ticket's activity or a
+ * changelog, and it marks nothing. With `active` it marks progress, for
+ * something that moves along on its own and is reported to the user: a
+ * parcel, a deployment, a claim. That reads oldest first, and `pending` ends
+ * it on what's under way. A journey the user moves through themselves, like
+ * a wizard or a checkout, is `Steps`.
+ *
+ * It's an `<ol role="list">`, so it stays a list in Safari with its numbers
+ * hidden, and each title is a heading at the level `titleAs` sets. The
+ * markers are decoration and hidden from assistive tech, so the states are
+ * read as words: `aria-current="step"` on the current item, and "completed",
+ * "upcoming" or "in progress" after the other titles, in the language the
+ * label props set. Nothing here is a control or a live region, so a timeline
+ * that changes on screen keeps a `role="status"` region beside it.
+ *
+ * @function
+ * @param {TimelineProps} props - Props for the Timeline component.
+ * @param {React.Ref<HTMLOListElement>} ref - Forwarded ref to the `<ol>`.
+ * @returns {JSX.Element} The rendered timeline.
+ *
+ * @example
+ * <Timeline titleAs="h3">
+ *   <Timeline.Item title="Delivered" time="16 October 2026" dateTime="2026-10-16" />
+ *   <Timeline.Item title="Order placed" time="12 October 2026" dateTime="2026-10-12" />
+ * </Timeline>
+ *
+ * @example
+ * <Timeline titleAs="h3" active={1} pending="Out for delivery">
+ *   <Timeline.Item title="Order placed" />
+ *   <Timeline.Item title="Shipped" />
+ * </Timeline>
+ */
+const TimelineRoot = forwardRef(({ className, children, active, pending, align = 'start', titleAs = 'h2', color, completedLabel = 'completed', upcomingLabel = 'upcoming', pendingLabel = 'in progress', textColor, bgColor, ...props }, ref) => {
+    const { bulmaHelperClasses, rest } = useBulmaClasses({
+        color: textColor,
+        backgroundColor: bgColor,
+        ...props,
+    });
+    const rootClass = usePrefixedClassNames('timeline', {
+        'is-end': align === 'end',
+        'is-alternate': align === 'alternate',
+        [`is-${color}`]: isTimelineColor(color),
+    });
+    const level = validTimelineTitleElements.includes(titleAs) ? titleAs : 'h2';
+    const labels = {
+        completed: completedLabel,
+        active: undefined,
+        upcoming: upcomingLabel,
+        pending: pendingLabel,
+    };
+    const contextFor = (state) => ({
+        titleAs: level,
+        state,
+        label: state && labels[state],
+    });
+    // A fraction counts as the item it has reached, so one item is current.
+    const reached = typeof active === 'number' ? Math.floor(active) : undefined;
+    const stateAt = (index) => {
+        if (reached === undefined)
+            return undefined;
+        if (index === reached)
+            return 'active';
+        return index < reached ? 'completed' : 'upcoming';
+    };
+    // Each child gets its state through context rather than a clone, so an
+    // app's own component around a Timeline.Item still gets it. Fragments
+    // and arrays are opened up first, so each item inside one counts.
+    return (jsxs("ol", { ref: ref, className: classNames(rootClass, bulmaHelperClasses, className), ...rest, role: "list", children: [flattenChildren(children).map((child, index) => (jsx(TimelineItemContext.Provider, { value: contextFor(stateAt(index)), children: child }, React.isValidElement(child) ? child.key : index))), isGiven(pending) && (jsx(TimelineItemContext.Provider, { value: contextFor('pending'), children: jsx(TimelineItem, { title: pending }) }))] }));
+});
+const Timeline = withSubComponents(TimelineRoot, { Item: TimelineItem }, 'Timeline');
+
+export { Timeline, TimelineItem };
+//# sourceMappingURL=Timeline.js.map

package/dist/esm/components/Timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timeline.js","sources":["../../../src/components/Timeline.tsx"],"sourcesContent":["import React, { createContext, forwardRef, useContext } from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { flattenChildren } from '../helpers/flattenChildren';\nimport { visuallyHidden } from '../helpers/statusRegion';\nimport { withSubComponents } from '../helpers/withSubComponents';\nimport { Icon } from '../elements/Icon';\n\nconst validTimelineColors = [\n  'primary',\n  'link',\n  'info',\n  'success',\n  'warning',\n  'danger',\n] as const;\n/** The Bulma colors a marker takes. */\nexport type TimelineColor = (typeof validTimelineColors)[number];\n\nconst validTimelineTitleElements = ['h2', 'h3', 'h4', 'h5', 'h6', 'p'] as const;\n/** What each item's title renders as: a heading level, or `p` for a plain line. */\nexport type TimelineTitleElement = (typeof validTimelineTitleElements)[number];\n\n/** Where the rail goes. */\nexport type TimelineAlign = 'start' | 'end' | 'alternate';\n\n/** Where an item is in a progress timeline. */\ntype TimelineState = 'completed' | 'active' | 'upcoming' | 'pending';\n\n/**\n * What the root hands each of its items: the title's element, and in a\n * progress timeline, the item's state and the words read after its title.\n */\ninterface TimelineItemContextValue {\n  titleAs: TimelineTitleElement;\n  state?: TimelineState;\n  label?: string;\n}\n\n// An item outside a Timeline is a record item with an h2 title.\nconst TimelineItemContext = createContext<TimelineItemContextValue>({\n  titleAs: 'h2',\n});\n\n/** Whether a prop was given something to render. */\nconst isGiven = (node: React.ReactNode) =>\n  node !== undefined &&\n  node !== null &&\n  typeof node !== 'boolean' &&\n  node !== '';\n\nconst isTimelineColor = (color?: string): color is TimelineColor =>\n  !!color && (validTimelineColors as readonly string[]).includes(color);\n\n/**\n * Props for the Timeline component. The helper props, the other attributes\n * and the `ref` land on the `<ol>`.\n *\n * @extraProp {React.Ref<HTMLOListElement>} [ref] - Ref forwarded to the `<ol>`.\n */\nexport interface TimelineProps\n  extends\n    Omit<React.OlHTMLAttributes<HTMLOListElement>, 'color' | 'role'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /**\n   * `Timeline.Item`s, in the order they're read: newest first or oldest\n   * first for a record, oldest first with `active` or `pending`.\n   */\n  children?: React.ReactNode;\n  /**\n   * Marks progress. The item at this index, counting the children from 0, is\n   * current; the ones before it are completed and the ones after it are\n   * upcoming. Leave it out for a record, where nothing is marked. `-1` marks\n   * every item upcoming, and an index past the last marks them all completed.\n   * A fraction counts as the item it has reached, so `2.5` marks the third\n   * item current. Each child counts as one item, with Fragments and arrays opened up, so\n   * render one item per child. A component of your own around a\n   * `Timeline.Item` still gets its state, but one that renders nothing still\n   * counts.\n   */\n  active?: number;\n  /**\n   * What's under way, as a last item after the children: its title, read\n   * with `pendingLabel`. Write it as words that say so (\"Out for delivery\").\n   */\n  pending?: React.ReactNode;\n  /**\n   * `start`: the rail at the start of the line. `end`: at the end, with the\n   * text against it. `alternate`: down the middle, the items taking turns and\n   * each time across the rail; below Bulma's tablet breakpoint it's `start`.\n   */\n  align?: TimelineAlign;\n  /**\n   * What every item's title renders as: a heading at the level under the\n   * heading the timeline sits beneath, or `p` for a busy feed.\n   */\n  titleAs?: TimelineTitleElement;\n  /**\n   * The markers' color, and the color of progress with `active`. Neutral\n   * without it, and Bulma's `link` for progress. The markers are hidden from\n   * assistive tech, so say what a color means in the words too.\n   */\n  color?: TimelineColor;\n  /** Read after a completed item's title, visually hidden. In your app's language. */\n  completedLabel?: string;\n  /** Read after an upcoming item's title, visually hidden. In your app's language. */\n  upcomingLabel?: string;\n  /** Read after the pending item's title, visually hidden. In your app's language. */\n  pendingLabel?: string;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/**\n * Props for Timeline.Item, one event. The helper props, the other attributes\n * and the `ref` land on its `<li>`. The native `title` attribute isn't one of\n * them, since `title` here is the event's title.\n *\n * @extraProp {React.Ref<HTMLLIElement>} [ref] - Ref forwarded to the `<li>`.\n */\nexport interface TimelineItemProps\n  extends\n    Omit<React.LiHTMLAttributes<HTMLLIElement>, 'color' | 'title'>,\n    Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /** What happened, in a line. It renders as the root's `titleAs`. */\n  title?: React.ReactNode;\n  /**\n   * When it happened, as the reader sees it: \"14 October 2026\", \"2 hours\n   * ago\". Put the whole date in the words, since screen readers mostly read\n   * the text.\n   */\n  time?: React.ReactNode;\n  /**\n   * The same moment for machines, as HTML's `datetime` takes it:\n   * \"2026-10-14\", \"2026-10-14T08:12\", \"2026-10\". With it, `time` renders in\n   * a `<time>`. Keep it the same moment as `time`, since some readers speak it.\n   */\n  dateTime?: string;\n  /**\n   * A picture in the marker. A string is an `Icon` name, drawn from the icon\n   * library `ConfigProvider` sets, and anything else renders as it is.\n   * Without it, the marker is a dot. It's hidden from assistive tech, so\n   * what it means goes in the title.\n   */\n  icon?: React.ReactNode;\n  /** This item's marker color, over the root's. Say what it means in the words too. */\n  color?: TimelineColor;\n  /** Anything else about the event, under the title and the time, as written. */\n  children?: React.ReactNode;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n}\n\n/**\n * One event: a marker on the rail, then its title, its time and anything else about it.\n *\n * Outside a `Timeline` it's a record item with an `h2` title, though the\n * styles are registered on `.timeline`, so the rail and the marker need one.\n *\n * @function\n * @param {TimelineItemProps} props - Props for Timeline.Item.\n * @param {React.Ref<HTMLLIElement>} ref - Forwarded ref to the `<li>`.\n * @returns {JSX.Element} The rendered event.\n *\n * @example\n * <Timeline.Item title=\"Shipped\" time=\"14 October 2026\" dateTime=\"2026-10-14\">\n *   Left the warehouse in Leeds.\n * </Timeline.Item>\n */\nexport const TimelineItem = forwardRef<HTMLLIElement, TimelineItemProps>(\n  (\n    {\n      className,\n      title,\n      time,\n      dateTime,\n      icon,\n      color,\n      textColor,\n      bgColor,\n      children,\n      ...props\n    },\n    ref\n  ) => {\n    const { titleAs: TitleTag, state, label } = useContext(TimelineItemContext);\n    const { bulmaHelperClasses, rest } = useBulmaClasses({\n      color: textColor,\n      backgroundColor: bgColor,\n      ...props,\n    });\n    const itemClass = usePrefixedClassNames('timeline-item', {\n      [`is-${state}`]: !!state,\n      [`is-${color}`]: isTimelineColor(color),\n    });\n    const markerClass = usePrefixedClassNames('timeline-marker', {\n      'is-icon': isGiven(icon),\n    });\n    const contentClass = usePrefixedClassNames('timeline-content');\n    const titleClass = usePrefixedClassNames('timeline-title');\n    const timeClass = usePrefixedClassNames('timeline-time');\n\n    // The state in words, read after the title so it's in the heading too:\n    // \"Packed completed\". The current item has none, since aria-current\n    // says it. The styles are inline, so the words stay hidden in a modular\n    // build that leaves out Bulma's helper classes.\n    const words = label ? (\n      <span style={visuallyHidden}>{` ${label}`}</span>\n    ) : null;\n\n    return (\n      <li\n        ref={ref}\n        className={classNames(itemClass, bulmaHelperClasses, className)}\n        {...rest}\n        // In a progress timeline the state decides, whatever was passed.\n        {...(state && {\n          'aria-current': state === 'active' ? 'step' : undefined,\n        })}\n      >\n        {/* Decoration, hidden with whatever is in it, an Icon's own label\n            included: the words say what a color, an icon or a state means. */}\n        <div className={markerClass} aria-hidden=\"true\">\n          {isGiven(icon) &&\n            (typeof icon === 'string' ? <Icon name={icon} /> : icon)}\n        </div>\n        <div className={contentClass}>\n          {isGiven(title) ? (\n            <TitleTag className={titleClass}>\n              {title}\n              {words}\n            </TitleTag>\n          ) : (\n            words\n          )}\n          {isGiven(time) &&\n            (dateTime ? (\n              <time className={timeClass} dateTime={dateTime}>\n                {time}\n              </time>\n            ) : (\n              <span className={timeClass}>{time}</span>\n            ))}\n          {children}\n        </div>\n      </li>\n    );\n  }\n);\n\nTimelineItem.displayName = 'Timeline.Item';\n\n/**\n * The `Timeline` component renders a list of events in the order they happened, each with a marker on a line down the side.\n *\n * By default it's a record, an order's history, a ticket's activity or a\n * changelog, and it marks nothing. With `active` it marks progress, for\n * something that moves along on its own and is reported to the user: a\n * parcel, a deployment, a claim. That reads oldest first, and `pending` ends\n * it on what's under way. A journey the user moves through themselves, like\n * a wizard or a checkout, is `Steps`.\n *\n * It's an `<ol role=\"list\">`, so it stays a list in Safari with its numbers\n * hidden, and each title is a heading at the level `titleAs` sets. The\n * markers are decoration and hidden from assistive tech, so the states are\n * read as words: `aria-current=\"step\"` on the current item, and \"completed\",\n * \"upcoming\" or \"in progress\" after the other titles, in the language the\n * label props set. Nothing here is a control or a live region, so a timeline\n * that changes on screen keeps a `role=\"status\"` region beside it.\n *\n * @function\n * @param {TimelineProps} props - Props for the Timeline component.\n * @param {React.Ref<HTMLOListElement>} ref - Forwarded ref to the `<ol>`.\n * @returns {JSX.Element} The rendered timeline.\n *\n * @example\n * <Timeline titleAs=\"h3\">\n *   <Timeline.Item title=\"Delivered\" time=\"16 October 2026\" dateTime=\"2026-10-16\" />\n *   <Timeline.Item title=\"Order placed\" time=\"12 October 2026\" dateTime=\"2026-10-12\" />\n * </Timeline>\n *\n * @example\n * <Timeline titleAs=\"h3\" active={1} pending=\"Out for delivery\">\n *   <Timeline.Item title=\"Order placed\" />\n *   <Timeline.Item title=\"Shipped\" />\n * </Timeline>\n */\nconst TimelineRoot = forwardRef<HTMLOListElement, TimelineProps>(\n  (\n    {\n      className,\n      children,\n      active,\n      pending,\n      align = 'start',\n      titleAs = 'h2',\n      color,\n      completedLabel = 'completed',\n      upcomingLabel = 'upcoming',\n      pendingLabel = 'in progress',\n      textColor,\n      bgColor,\n      ...props\n    },\n    ref\n  ) => {\n    const { bulmaHelperClasses, rest } = useBulmaClasses({\n      color: textColor,\n      backgroundColor: bgColor,\n      ...props,\n    });\n    const rootClass = usePrefixedClassNames('timeline', {\n      'is-end': align === 'end',\n      'is-alternate': align === 'alternate',\n      [`is-${color}`]: isTimelineColor(color),\n    });\n    const level = validTimelineTitleElements.includes(titleAs) ? titleAs : 'h2';\n    const labels: Record<TimelineState, string | undefined> = {\n      completed: completedLabel,\n      active: undefined,\n      upcoming: upcomingLabel,\n      pending: pendingLabel,\n    };\n    const contextFor = (state?: TimelineState) => ({\n      titleAs: level,\n      state,\n      label: state && labels[state],\n    });\n    // A fraction counts as the item it has reached, so one item is current.\n    const reached = typeof active === 'number' ? Math.floor(active) : undefined;\n    const stateAt = (index: number): TimelineState | undefined => {\n      if (reached === undefined) return undefined;\n      if (index === reached) return 'active';\n      return index < reached ? 'completed' : 'upcoming';\n    };\n\n    // Each child gets its state through context rather than a clone, so an\n    // app's own component around a Timeline.Item still gets it. Fragments\n    // and arrays are opened up first, so each item inside one counts.\n    return (\n      <ol\n        ref={ref}\n        className={classNames(rootClass, bulmaHelperClasses, className)}\n        {...rest}\n        role=\"list\"\n      >\n        {flattenChildren(children).map((child, index) => (\n          <TimelineItemContext.Provider\n            key={React.isValidElement(child) ? child.key : index}\n            value={contextFor(stateAt(index))}\n          >\n            {child}\n          </TimelineItemContext.Provider>\n        ))}\n        {isGiven(pending) && (\n          <TimelineItemContext.Provider value={contextFor('pending')}>\n            <TimelineItem title={pending} />\n          </TimelineItemContext.Provider>\n        )}\n      </ol>\n    );\n  }\n);\n\nexport const Timeline = withSubComponents(\n  TimelineRoot,\n  { Item: TimelineItem },\n  'Timeline'\n);\n\nexport default Timeline;\n"],"names":["_jsx","_jsxs"],"mappings":"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"}

package/dist/esm/elements/Icon.js

@@ -105,8 +105,7 @@ function getIconClasses(library, name, variant, features) {
  */
 const Icon = ({ className, textColor, bgColor, name, library, variant, features, libraryFeatures, // Deprecated but maintained for backward compatibility
 size, ariaLabel, style, icon, // Capture and exclude the deprecated 'icon' prop from DOM
-color: _color, // Exclude 'color' prop if passed directly
-containerClassName, children, ...restProps }) => {
+color, containerClassName, children, ...restProps }) => {
     // Get the default icon library from context, fallback to 'fa' if not set
     const defaultLibrary = useIconLibrary();
     /**
@@ -114,7 +113,7 @@ containerClassName, children, ...restProps }) => {
      * Note: variant, features, and libraryFeatures are excluded from props spread
      */
     const { bulmaHelperClasses, rest } = useBulmaClasses({
-        color: textColor,
+        color: textColor ?? color,
         backgroundColor: bgColor,
         ...restProps,
     });

package/dist/esm/elements/Icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"Icon.js","sources":["../../../src/elements/Icon.tsx"],"sourcesContent":["import React from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { useIconLibrary } from '../helpers/Config';\n\n// TypeScript declaration for Ionicons web component\ninterface IonIconProps extends React.HTMLAttributes<HTMLElement> {\n  name?: string;\n  src?: string;\n  icon?: unknown;\n  size?: string;\n  lazy?: boolean;\n  sanitize?: boolean;\n  color?: string;\n  flipRtl?: boolean;\n  ariaLabel?: string;\n  ariaHidden?: string;\n}\n\n// React 19 moved the global `JSX` namespace under the `react` module, so the\n// `<ion-icon>` web-component augmentation must target `React.JSX` to take effect.\ndeclare module 'react' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace JSX {\n    interface IntrinsicElements {\n      'ion-icon': IonIconProps;\n    }\n  }\n}\n\ntype IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols'; // 'fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols\n\n/**\n * Shared props for the Icon component, independent of whether a class-based `name` or a\n * custom `children` node supplies the glyph.\n */\ninterface IconBaseProps\n  extends React.HTMLAttributes<HTMLSpanElement>, BulmaClassesProps {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /** Bulma color modifier for the icon. */\n  color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /**\n   * Legacy icon class string (e.g. `'fas fa-star'`). Only its last segment is read, as the\n   * glyph name; the library still comes from `library` or `ConfigProvider`, so\n   * `'mdi mdi-rocket'` renders an `fa` class unless the effective library is already `mdi` —\n   * set it here or on the provider.\n   *\n   * @deprecated Use `name` instead.\n   */\n  icon?: string;\n  /**\n   * The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured. Ignored when `children` supplies the glyph instead of `name`.\n   * @defaultValue 'fa'\n   */\n  library?: IconLibrary; // defaults to ConfigProvider iconLibrary or 'fa'\n  /** Icon style variant (e.g. `'solid'`, `'outlined'`, `'rounded'`). Ignored when `children` supplies the glyph instead of `name`. */\n  variant?: string; // e.g., 'solid', 'outlined', 'rounded', 'sharp'\n  /** Additional modifiers (e.g. `'fa-lg'`, `'fa-spin'`, `'is-size-1'`). Ignored when `children` supplies the glyph instead of `name`. */\n  features?: string | string[]; // e.g., 'fa-lg', 'fa-spin', 'is-size-1'\n  /**\n   * Additional modifiers in the older combined form, parsed into `variant` and `features`.\n   *\n   * @deprecated Use `variant` and `features` instead.\n   */\n  libraryFeatures?: string | string[];\n  /** Size modifier for the icon container. */\n  size?: 'small' | 'medium' | 'large';\n  /**\n   * Accessible name for an icon that means something on its own. Set it and the container\n   * span gets `role=\"img\"` with this `aria-label`, so the name is exactly this text: a\n   * Material ligature such as `rocket_launch` inside stays out of it. Leave it unset (or\n   * empty) and the icon is decorative: the span renders `aria-hidden=\"true\"` and no name,\n   * so it adds nothing to the accessible name of a `Button` or text around it. For an\n   * icon-only control, put the name on the control (e.g. `Button`'s `aria-label`) and leave\n   * this unset. A non-empty native `aria-label` or `aria-labelledby` passed instead also\n   * counts as a name, and an explicit `role` or `aria-hidden` wins over both defaults. An\n   * unnamed icon given a `role` or a `tabIndex` of its own isn't hidden, since hiding\n   * something focusable is a failure of its own.\n   */\n  ariaLabel?: string;\n  /** Inline style object. */\n  style?: React.CSSProperties;\n  /** Override the default `'icon'` container class (e.g., `'panel-icon'`). */\n  containerClassName?: string; // Override the default 'icon' container class (e.g., 'panel-icon')\n}\n\n/**\n * Props for `Icon` rendering a class-based glyph from an icon library.\n */\nexport interface IconNameProps extends IconBaseProps {\n  /** The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). Mutually exclusive with `children`. */\n  name: string; // e.g., 'star', 'account', 'home-outline'\n  /** A custom node (an inline SVG, a `react-icons` component, …) rendered inside the icon container in place of a class-based glyph. Mutually exclusive with `name`. */\n  children?: never;\n}\n\n/**\n * Props for `Icon` rendering a custom node (an inline SVG, a `react-icons` component, a Font\n * Awesome React `<FontAwesomeIcon>`, …) in place of a class-based glyph.\n */\nexport interface IconChildrenProps extends IconBaseProps {\n  /** The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). Mutually exclusive with `children`. */\n  name?: undefined;\n  /** A custom node (an inline SVG, a `react-icons` component, …) rendered inside the icon container in place of a class-based glyph. Mutually exclusive with `name`. */\n  // `undefined` is excluded deliberately: the renderer discriminates on `children !== undefined`,\n  // so `children={undefined}` would satisfy the type but fall through to the `name` path with no\n  // name and render an `fa-undefined` glyph. Excluding it keeps the advertised\n  // exactly-one-of-`name`-or-`children` constraint matching what actually renders.\n  children: Exclude<React.ReactNode, undefined>;\n}\n\n/**\n * Props for `Icon` naming its glyph through the deprecated `icon` prop instead of `name`.\n *\n * The runtime has always accepted `icon` on its own — it strips a leading library prefix off\n * the class string and falls through to the `name` path — but the type offered no member without\n * a `name` or `children`, so every caller still on the deprecated prop got an error the\n * package could not see — until #663 nothing here type-checked a test or a story, so the\n * three `Icon.test.tsx` cases exercising this path proved the runtime and said nothing about\n * the type. Declaring the path is the honest resolution: it is deprecated, not removed, and a\n * deprecation that does not type-check is a removal announced only to whoever tries it.\n *\n * @deprecated Pass `name` instead. This member goes when `icon` does.\n */\nexport interface IconDeprecatedProps extends IconBaseProps {\n  /**\n   * Legacy icon class string (e.g. `'fas fa-star'`). Only its last segment is read, as the\n   * glyph name; the library still comes from `library` or `ConfigProvider`, so\n   * `'mdi mdi-rocket'` renders an `fa` class unless the effective library is already `mdi` —\n   * set it here or on the provider.\n   *\n   * @deprecated Use `name` instead.\n   */\n  // Required here, optional on `IconBaseProps`: the other two members allow it\n  // alongside `name`, and this one is the member where it IS the glyph. Same\n  // prose in both places on purpose — the API-docs extractor reads whichever it\n  // reaches first, and the two must not drift apart.\n  icon: string;\n  /** The icon name. Absent on this path — `icon` supplies the glyph. */\n  name?: undefined;\n  /** A custom node. Mutually exclusive with `icon`. */\n  children?: never;\n}\n\n/**\n * Props for the Icon component — a discriminated union of a class-based `name`, a custom\n * `children` node, and the deprecated `icon` class string.\n */\nexport type IconProps = IconNameProps | IconChildrenProps | IconDeprecatedProps;\n\n/**\n * Strips a redundant leading library prefix from an icon name (e.g. `fa-check` -> `check`\n * for the `fa` library, `mdi-account` -> `account` for `mdi`), so `name` behaves the same\n * whether or not the caller includes the prefix. Font Awesome and Material Design Icons docs\n * conventionally refer to icons with their class prefix (`fa-check`), which otherwise gets\n * doubled by `getIconClasses` (producing `fa-fa-check`, matching no glyph).\n *\n * @param {string} name - The icon name, possibly including a redundant library prefix.\n * @param {IconLibrary} library - The icon library the name will be rendered with.\n * @returns {string} The icon name with any redundant leading library prefix removed.\n */\nfunction stripRedundantLibraryPrefix(\n  name: string,\n  library: IconLibrary\n): string {\n  if (!name) {\n    return name;\n  }\n  if (library === 'fa' && name.startsWith('fa-')) {\n    return name.substring(3);\n  }\n  if (library === 'mdi' && name.startsWith('mdi-')) {\n    return name.substring(4);\n  }\n  return name;\n}\n\n/**\n * Gets the correct classes for the icon element based on the library and features.\n *\n * @param {IconLibrary} library - The icon library.\n * @param {string} name - The icon name.\n * @param {string} [variant] - Icon style variant (e.g., 'solid', 'outlined', 'rounded').\n * @param {string | string[]} [features] - Additional library-specific modifiers.\n * @returns {string} The combined class string for the icon.\n */\nfunction getIconClasses(\n  library: IconLibrary,\n  name: string,\n  variant?: string,\n  features?: string | string[]\n): string {\n  let baseClass: string;\n  let iconClass: string;\n  const featureList = Array.isArray(features)\n    ? features\n    : features\n      ? [features]\n      : [];\n\n  switch (library) {\n    case 'fa': {\n      // Font Awesome: use variant as style ('solid' -> 'fas', 'regular' -> 'far', etc.)\n      const styleMap: Record<string, string> = {\n        solid: 'fas',\n        regular: 'far',\n        brands: 'fab',\n        light: 'fal',\n        duotone: 'fad',\n        thin: 'fat',\n      };\n      const faStyle = variant ? styleMap[variant] || variant : 'fas';\n      baseClass = faStyle;\n      iconClass = `fa-${name}`;\n      return [baseClass, iconClass, ...featureList].join(' ');\n    }\n    case 'mdi':\n      // Material Design Icons: no variants, just features\n      baseClass = 'mdi';\n      iconClass = `mdi-${name}`;\n      return [baseClass, iconClass, ...featureList].join(' ');\n    case 'material-icons': {\n      // Google Material Icons: map variants to full class names\n      const styleVariants: Record<string, string> = {\n        filled: 'material-icons',\n        outlined: 'material-icons-outlined',\n        round: 'material-icons-round',\n        sharp: 'material-icons-sharp',\n      };\n      baseClass = variant\n        ? styleVariants[variant] || `material-icons-${variant}`\n        : 'material-icons';\n      return [baseClass, ...featureList].join(' ');\n    }\n    case 'material-symbols': {\n      // Google Material Symbols: map variants to full class names\n      const styleVariants: Record<string, string> = {\n        outlined: 'material-symbols-outlined',\n        rounded: 'material-symbols-rounded',\n        sharp: 'material-symbols-sharp',\n      };\n      baseClass = variant\n        ? styleVariants[variant] || `material-symbols-${variant}`\n        : 'material-symbols-outlined';\n      return [baseClass, ...featureList].join(' ');\n    }\n    default:\n      // fallback: just icon name and features\n      return [name, ...featureList].join(' ');\n  }\n}\n\n/**\n * The `Icon` component is a Bulma-styled wrapper for displaying icons from various libraries (Font Awesome, Material Design Icons, Ionicons, Google Material Icons, Material Symbols, etc.).\n *\n * @function\n * @param {IconProps} props - Props for the Icon component.\n * @returns {JSX.Element} The rendered icon element.\n * @see {@link https://bulma.io/documentation/elements/icon/ | Bulma Icon documentation}\n */\nexport const Icon: React.FC<IconProps> = ({\n  className,\n  textColor,\n  bgColor,\n  name,\n  library,\n  variant,\n  features,\n  libraryFeatures, // Deprecated but maintained for backward compatibility\n  size,\n  ariaLabel,\n  style,\n  icon, // Capture and exclude the deprecated 'icon' prop from DOM\n  color: _color, // Exclude 'color' prop if passed directly\n  containerClassName,\n  children,\n  ...restProps\n}) => {\n  // Get the default icon library from context, fallback to 'fa' if not set\n  const defaultLibrary = useIconLibrary();\n\n  /**\n   * Generates Bulma helper classes and separates out remaining props.\n   * Note: variant, features, and libraryFeatures are excluded from props spread\n   */\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor,\n    backgroundColor: bgColor,\n    ...restProps,\n  });\n\n  // Hoisted unconditionally to respect rules-of-hooks; the branches below\n  // pick which result to consume.\n  const defaultIconClasses = usePrefixedClassNames('icon', {\n    [`is-${size}`]: size,\n  });\n  const sizeModifierClass = usePrefixedClassNames(\n    size ? `is-${size}` : undefined\n  );\n\n  const bulmaClasses = containerClassName\n    ? containerClassName\n    : defaultIconClasses;\n\n  const iconContainerClasses = classNames(\n    bulmaClasses,\n    containerClassName && size ? sizeModifierClass : undefined,\n    bulmaHelperClasses,\n    className\n  );\n\n  // A named icon is an image, whose name is its label alone, so a ligature inside\n  // never leaks into it. An unnamed one is decorative and hidden outright. Spread\n  // before `rest`, so a caller's own `role` or `aria-hidden` still wins.\n  const named =\n    !!ariaLabel || !!restProps['aria-label'] || !!restProps['aria-labelledby'];\n  // A caller's own `role` or `tabIndex` on an unnamed icon means it isn't decoration (an\n  // icon made a button, say), so it isn't hidden either: `aria-hidden` on something\n  // focusable is a failure of its own.\n  const a11yProps = named\n    ? { role: 'img', 'aria-label': ariaLabel || undefined }\n    : restProps.role !== undefined || restProps.tabIndex !== undefined\n      ? {}\n      : { 'aria-hidden': true };\n\n  if (children !== undefined) {\n    // `IconChildrenProps`: render the caller's node (an inline SVG, a `react-icons`\n    // component, …) in place of a class-based glyph. Library/variant/features don't apply.\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        {children}\n      </span>\n    );\n  }\n\n  // `name` is guaranteed once `children` is absent UNLESS the caller is on the deprecated\n  // `icon` path, which `IconDeprecatedProps` declares with `name?: undefined`.\n  // (`IconChildrenProps['children']` excludes `undefined`, so `children={undefined}` can't\n  // slip past into this branch.) The cast covers that third member, and the `!name && icon`\n  // fallback below is what fills it in.\n  let finalName = name as string;\n  if (!name && icon) {\n    // If icon prop is provided instead of name, try to parse it\n    // e.g., \"mdi mdi-rocket-launch\" -> \"rocket-launch\"\n    if (typeof icon === 'string') {\n      const parts = icon.split(' ');\n      const lastPart = parts[parts.length - 1];\n      if (lastPart.startsWith('mdi-')) {\n        finalName = lastPart.substring(4); // Remove \"mdi-\" prefix\n      } else if (lastPart.startsWith('fa-')) {\n        finalName = lastPart.substring(3); // Remove \"fa-\" prefix\n      } else {\n        finalName = lastPart;\n      }\n    }\n  }\n\n  const finalLibrary = library || defaultLibrary || 'fa';\n\n  // Normalize a redundant leading library prefix (e.g. \"fa-check\" -> \"check\" when the\n  // library is 'fa'), so `name` behaves identically with or without the prefix.\n  finalName = stripRedundantLibraryPrefix(finalName, finalLibrary);\n\n  if (!finalName) {\n    // No glyph to name. Reachable through the public type only as `icon=\"\"`, and otherwise\n    // by a plain-JS caller (or one that casts). Building a class off an absent name produced\n    // a bogus `fa-undefined` glyph; render the bare container instead, matching the\n    // `children` branch.\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      />\n    );\n  }\n\n  // Backward compatibility: if libraryFeatures is provided, parse it for variant and features\n  let finalVariant = variant;\n  let finalFeatures = features;\n\n  if (libraryFeatures && !variant && !features) {\n    const legacyFeatures = Array.isArray(libraryFeatures)\n      ? libraryFeatures\n      : [libraryFeatures];\n\n    // For Font Awesome, extract style from features\n    if (finalLibrary === 'fa') {\n      const faStyle = legacyFeatures.find(f =>\n        [\n          'fas',\n          'far',\n          'fab',\n          'fal',\n          'fad',\n          'fat',\n          'solid',\n          'regular',\n          'brands',\n          'light',\n          'duotone',\n          'thin',\n        ].includes(f)\n      );\n      if (faStyle) {\n        finalVariant = faStyle;\n        finalFeatures = legacyFeatures.filter(f => f !== faStyle);\n      } else {\n        finalFeatures = legacyFeatures;\n      }\n    }\n    // For Material Icons/Symbols, extract style variant\n    else if (\n      finalLibrary === 'material-icons' ||\n      finalLibrary === 'material-symbols'\n    ) {\n      const styleVariants =\n        finalLibrary === 'material-icons'\n          ? ['filled', 'outlined', 'round', 'sharp']\n          : ['outlined', 'rounded', 'sharp'];\n\n      const styleVariant = legacyFeatures.find(f => styleVariants.includes(f));\n      if (styleVariant) {\n        finalVariant = styleVariant;\n        finalFeatures = legacyFeatures.filter(f => f !== styleVariant);\n      } else {\n        finalFeatures = legacyFeatures;\n      }\n    }\n    // For others, all features go to finalFeatures\n    else {\n      finalFeatures = legacyFeatures;\n    }\n  }\n\n  // Handle web components vs CSS-based icons\n  if (finalLibrary === 'ion') {\n    // For Ionicons, handle variant in the name\n    let ionName = finalName;\n    if (finalVariant === 'outline') {\n      ionName = `${finalName}-outline`;\n    } else if (finalVariant === 'sharp') {\n      ionName = `${finalName}-sharp`;\n    }\n\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        <ion-icon name={ionName} />\n      </span>\n    );\n  }\n\n  // Legacy CSS-based icons\n  const iClasses = getIconClasses(\n    finalLibrary,\n    finalName,\n    finalVariant,\n    finalFeatures\n  );\n\n  // Material Icons and Material Symbols use text content, not CSS classes for the icon name\n  if (\n    finalLibrary === 'material-icons' ||\n    finalLibrary === 'material-symbols'\n  ) {\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        <i className={iClasses}>{finalName}</i>\n      </span>\n    );\n  }\n\n  return (\n    <span\n      className={iconContainerClasses}\n      {...a11yProps}\n      style={style}\n      {...rest}\n    >\n      <i className={iClasses} />\n    </span>\n  );\n};\n"],"names":["_jsx"],"mappings":"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"}
+{"version":3,"file":"Icon.js","sources":["../../../src/elements/Icon.tsx"],"sourcesContent":["import React from 'react';\nimport { classNames, usePrefixedClassNames } from '../helpers/classNames';\nimport {\n  useBulmaClasses,\n  BulmaClassesProps,\n  validColors,\n} from '../helpers/useBulmaClasses';\nimport { useIconLibrary } from '../helpers/Config';\n\n// TypeScript declaration for Ionicons web component\ninterface IonIconProps extends React.HTMLAttributes<HTMLElement> {\n  name?: string;\n  src?: string;\n  icon?: unknown;\n  size?: string;\n  lazy?: boolean;\n  sanitize?: boolean;\n  color?: string;\n  flipRtl?: boolean;\n  ariaLabel?: string;\n  ariaHidden?: string;\n}\n\n// React 19 moved the global `JSX` namespace under the `react` module, so the\n// `<ion-icon>` web-component augmentation must target `React.JSX` to take effect.\ndeclare module 'react' {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace JSX {\n    interface IntrinsicElements {\n      'ion-icon': IonIconProps;\n    }\n  }\n}\n\ntype IconLibrary = 'fa' | 'mdi' | 'ion' | 'material-icons' | 'material-symbols'; // 'fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols\n\n/**\n * Shared props for the Icon component, independent of whether a class-based `name` or a\n * custom `children` node supplies the glyph.\n */\ninterface IconBaseProps\n  extends React.HTMLAttributes<HTMLSpanElement>, BulmaClassesProps {\n  /** Additional CSS classes to apply. */\n  className?: string;\n  /** Text color helper. */\n  textColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /**\n   * Text color alias: renders `has-text-<color>`, exactly like `textColor`.\n   * Not a filled variant (no `.icon.is-<color>` CSS exists). Prefer\n   * `textColor`, which takes precedence when both are set; use `bgColor` for\n   * a colored surface.\n   */\n  color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';\n  /** Background color helper. */\n  bgColor?: (typeof validColors)[number] | 'inherit' | 'current';\n  /**\n   * Legacy icon class string (e.g. `'fas fa-star'`). Only its last segment is read, as the\n   * glyph name; the library still comes from `library` or `ConfigProvider`, so\n   * `'mdi mdi-rocket'` renders an `fa` class unless the effective library is already `mdi` —\n   * set it here or on the provider.\n   *\n   * @deprecated Use `name` instead.\n   */\n  icon?: string;\n  /**\n   * The icon library to use ('fa' = Font Awesome, 'mdi' = Material Design Icons, 'ion' = Ionicons Web Components, 'material-icons' = Google Material Icons, 'material-symbols' = Google Material Symbols). Defaults to the value set in ConfigProvider or 'fa' if not configured. Ignored when `children` supplies the glyph instead of `name`.\n   * @defaultValue 'fa'\n   */\n  library?: IconLibrary; // defaults to ConfigProvider iconLibrary or 'fa'\n  /** Icon style variant (e.g. `'solid'`, `'outlined'`, `'rounded'`). Ignored when `children` supplies the glyph instead of `name`. */\n  variant?: string; // e.g., 'solid', 'outlined', 'rounded', 'sharp'\n  /** Additional modifiers (e.g. `'fa-lg'`, `'fa-spin'`, `'is-size-1'`). Ignored when `children` supplies the glyph instead of `name`. */\n  features?: string | string[]; // e.g., 'fa-lg', 'fa-spin', 'is-size-1'\n  /**\n   * Additional modifiers in the older combined form, parsed into `variant` and `features`.\n   *\n   * @deprecated Use `variant` and `features` instead.\n   */\n  libraryFeatures?: string | string[];\n  /** Size modifier for the icon container. */\n  size?: 'small' | 'medium' | 'large';\n  /**\n   * Accessible name for an icon that means something on its own. Set it and the container\n   * span gets `role=\"img\"` with this `aria-label`, so the name is exactly this text: a\n   * Material ligature such as `rocket_launch` inside stays out of it. Leave it unset (or\n   * empty) and the icon is decorative: the span renders `aria-hidden=\"true\"` and no name,\n   * so it adds nothing to the accessible name of a `Button` or text around it. For an\n   * icon-only control, put the name on the control (e.g. `Button`'s `aria-label`) and leave\n   * this unset. A non-empty native `aria-label` or `aria-labelledby` passed instead also\n   * counts as a name, and an explicit `role` or `aria-hidden` wins over both defaults. An\n   * unnamed icon given a `role` or a `tabIndex` of its own isn't hidden, since hiding\n   * something focusable is a failure of its own.\n   */\n  ariaLabel?: string;\n  /** Inline style object. */\n  style?: React.CSSProperties;\n  /** Override the default `'icon'` container class (e.g., `'panel-icon'`). */\n  containerClassName?: string; // Override the default 'icon' container class (e.g., 'panel-icon')\n}\n\n/**\n * Props for `Icon` rendering a class-based glyph from an icon library.\n */\nexport interface IconNameProps extends IconBaseProps {\n  /** The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). Mutually exclusive with `children`. */\n  name: string; // e.g., 'star', 'account', 'home-outline'\n  /** A custom node (an inline SVG, a `react-icons` component, …) rendered inside the icon container in place of a class-based glyph. Mutually exclusive with `name`. */\n  children?: never;\n}\n\n/**\n * Props for `Icon` rendering a custom node (an inline SVG, a `react-icons` component, a Font\n * Awesome React `<FontAwesomeIcon>`, …) in place of a class-based glyph.\n */\nexport interface IconChildrenProps extends IconBaseProps {\n  /** The icon name, with or without its library prefix (e.g. `'star'` or `'fa-star'`). Mutually exclusive with `children`. */\n  name?: undefined;\n  /** A custom node (an inline SVG, a `react-icons` component, …) rendered inside the icon container in place of a class-based glyph. Mutually exclusive with `name`. */\n  // `undefined` is excluded deliberately: the renderer discriminates on `children !== undefined`,\n  // so `children={undefined}` would satisfy the type but fall through to the `name` path with no\n  // name and render an `fa-undefined` glyph. Excluding it keeps the advertised\n  // exactly-one-of-`name`-or-`children` constraint matching what actually renders.\n  children: Exclude<React.ReactNode, undefined>;\n}\n\n/**\n * Props for `Icon` naming its glyph through the deprecated `icon` prop instead of `name`.\n *\n * The runtime has always accepted `icon` on its own — it strips a leading library prefix off\n * the class string and falls through to the `name` path — but the type offered no member without\n * a `name` or `children`, so every caller still on the deprecated prop got an error the\n * package could not see — until #663 nothing here type-checked a test or a story, so the\n * three `Icon.test.tsx` cases exercising this path proved the runtime and said nothing about\n * the type. Declaring the path is the honest resolution: it is deprecated, not removed, and a\n * deprecation that does not type-check is a removal announced only to whoever tries it.\n *\n * @deprecated Pass `name` instead. This member goes when `icon` does.\n */\nexport interface IconDeprecatedProps extends IconBaseProps {\n  /**\n   * Legacy icon class string (e.g. `'fas fa-star'`). Only its last segment is read, as the\n   * glyph name; the library still comes from `library` or `ConfigProvider`, so\n   * `'mdi mdi-rocket'` renders an `fa` class unless the effective library is already `mdi` —\n   * set it here or on the provider.\n   *\n   * @deprecated Use `name` instead.\n   */\n  // Required here, optional on `IconBaseProps`: the other two members allow it\n  // alongside `name`, and this one is the member where it IS the glyph. Same\n  // prose in both places on purpose — the API-docs extractor reads whichever it\n  // reaches first, and the two must not drift apart.\n  icon: string;\n  /** The icon name. Absent on this path — `icon` supplies the glyph. */\n  name?: undefined;\n  /** A custom node. Mutually exclusive with `icon`. */\n  children?: never;\n}\n\n/**\n * Props for the Icon component — a discriminated union of a class-based `name`, a custom\n * `children` node, and the deprecated `icon` class string.\n */\nexport type IconProps = IconNameProps | IconChildrenProps | IconDeprecatedProps;\n\n/**\n * Strips a redundant leading library prefix from an icon name (e.g. `fa-check` -> `check`\n * for the `fa` library, `mdi-account` -> `account` for `mdi`), so `name` behaves the same\n * whether or not the caller includes the prefix. Font Awesome and Material Design Icons docs\n * conventionally refer to icons with their class prefix (`fa-check`), which otherwise gets\n * doubled by `getIconClasses` (producing `fa-fa-check`, matching no glyph).\n *\n * @param {string} name - The icon name, possibly including a redundant library prefix.\n * @param {IconLibrary} library - The icon library the name will be rendered with.\n * @returns {string} The icon name with any redundant leading library prefix removed.\n */\nfunction stripRedundantLibraryPrefix(\n  name: string,\n  library: IconLibrary\n): string {\n  if (!name) {\n    return name;\n  }\n  if (library === 'fa' && name.startsWith('fa-')) {\n    return name.substring(3);\n  }\n  if (library === 'mdi' && name.startsWith('mdi-')) {\n    return name.substring(4);\n  }\n  return name;\n}\n\n/**\n * Gets the correct classes for the icon element based on the library and features.\n *\n * @param {IconLibrary} library - The icon library.\n * @param {string} name - The icon name.\n * @param {string} [variant] - Icon style variant (e.g., 'solid', 'outlined', 'rounded').\n * @param {string | string[]} [features] - Additional library-specific modifiers.\n * @returns {string} The combined class string for the icon.\n */\nfunction getIconClasses(\n  library: IconLibrary,\n  name: string,\n  variant?: string,\n  features?: string | string[]\n): string {\n  let baseClass: string;\n  let iconClass: string;\n  const featureList = Array.isArray(features)\n    ? features\n    : features\n      ? [features]\n      : [];\n\n  switch (library) {\n    case 'fa': {\n      // Font Awesome: use variant as style ('solid' -> 'fas', 'regular' -> 'far', etc.)\n      const styleMap: Record<string, string> = {\n        solid: 'fas',\n        regular: 'far',\n        brands: 'fab',\n        light: 'fal',\n        duotone: 'fad',\n        thin: 'fat',\n      };\n      const faStyle = variant ? styleMap[variant] || variant : 'fas';\n      baseClass = faStyle;\n      iconClass = `fa-${name}`;\n      return [baseClass, iconClass, ...featureList].join(' ');\n    }\n    case 'mdi':\n      // Material Design Icons: no variants, just features\n      baseClass = 'mdi';\n      iconClass = `mdi-${name}`;\n      return [baseClass, iconClass, ...featureList].join(' ');\n    case 'material-icons': {\n      // Google Material Icons: map variants to full class names\n      const styleVariants: Record<string, string> = {\n        filled: 'material-icons',\n        outlined: 'material-icons-outlined',\n        round: 'material-icons-round',\n        sharp: 'material-icons-sharp',\n      };\n      baseClass = variant\n        ? styleVariants[variant] || `material-icons-${variant}`\n        : 'material-icons';\n      return [baseClass, ...featureList].join(' ');\n    }\n    case 'material-symbols': {\n      // Google Material Symbols: map variants to full class names\n      const styleVariants: Record<string, string> = {\n        outlined: 'material-symbols-outlined',\n        rounded: 'material-symbols-rounded',\n        sharp: 'material-symbols-sharp',\n      };\n      baseClass = variant\n        ? styleVariants[variant] || `material-symbols-${variant}`\n        : 'material-symbols-outlined';\n      return [baseClass, ...featureList].join(' ');\n    }\n    default:\n      // fallback: just icon name and features\n      return [name, ...featureList].join(' ');\n  }\n}\n\n/**\n * The `Icon` component is a Bulma-styled wrapper for displaying icons from various libraries (Font Awesome, Material Design Icons, Ionicons, Google Material Icons, Material Symbols, etc.).\n *\n * @function\n * @param {IconProps} props - Props for the Icon component.\n * @returns {JSX.Element} The rendered icon element.\n * @see {@link https://bulma.io/documentation/elements/icon/ | Bulma Icon documentation}\n */\nexport const Icon: React.FC<IconProps> = ({\n  className,\n  textColor,\n  bgColor,\n  name,\n  library,\n  variant,\n  features,\n  libraryFeatures, // Deprecated but maintained for backward compatibility\n  size,\n  ariaLabel,\n  style,\n  icon, // Capture and exclude the deprecated 'icon' prop from DOM\n  color,\n  containerClassName,\n  children,\n  ...restProps\n}) => {\n  // Get the default icon library from context, fallback to 'fa' if not set\n  const defaultLibrary = useIconLibrary();\n\n  /**\n   * Generates Bulma helper classes and separates out remaining props.\n   * Note: variant, features, and libraryFeatures are excluded from props spread\n   */\n  const { bulmaHelperClasses, rest } = useBulmaClasses({\n    color: textColor ?? color,\n    backgroundColor: bgColor,\n    ...restProps,\n  });\n\n  // Hoisted unconditionally to respect rules-of-hooks; the branches below\n  // pick which result to consume.\n  const defaultIconClasses = usePrefixedClassNames('icon', {\n    [`is-${size}`]: size,\n  });\n  const sizeModifierClass = usePrefixedClassNames(\n    size ? `is-${size}` : undefined\n  );\n\n  const bulmaClasses = containerClassName\n    ? containerClassName\n    : defaultIconClasses;\n\n  const iconContainerClasses = classNames(\n    bulmaClasses,\n    containerClassName && size ? sizeModifierClass : undefined,\n    bulmaHelperClasses,\n    className\n  );\n\n  // A named icon is an image, whose name is its label alone, so a ligature inside\n  // never leaks into it. An unnamed one is decorative and hidden outright. Spread\n  // before `rest`, so a caller's own `role` or `aria-hidden` still wins.\n  const named =\n    !!ariaLabel || !!restProps['aria-label'] || !!restProps['aria-labelledby'];\n  // A caller's own `role` or `tabIndex` on an unnamed icon means it isn't decoration (an\n  // icon made a button, say), so it isn't hidden either: `aria-hidden` on something\n  // focusable is a failure of its own.\n  const a11yProps = named\n    ? { role: 'img', 'aria-label': ariaLabel || undefined }\n    : restProps.role !== undefined || restProps.tabIndex !== undefined\n      ? {}\n      : { 'aria-hidden': true };\n\n  if (children !== undefined) {\n    // `IconChildrenProps`: render the caller's node (an inline SVG, a `react-icons`\n    // component, …) in place of a class-based glyph. Library/variant/features don't apply.\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        {children}\n      </span>\n    );\n  }\n\n  // `name` is guaranteed once `children` is absent UNLESS the caller is on the deprecated\n  // `icon` path, which `IconDeprecatedProps` declares with `name?: undefined`.\n  // (`IconChildrenProps['children']` excludes `undefined`, so `children={undefined}` can't\n  // slip past into this branch.) The cast covers that third member, and the `!name && icon`\n  // fallback below is what fills it in.\n  let finalName = name as string;\n  if (!name && icon) {\n    // If icon prop is provided instead of name, try to parse it\n    // e.g., \"mdi mdi-rocket-launch\" -> \"rocket-launch\"\n    if (typeof icon === 'string') {\n      const parts = icon.split(' ');\n      const lastPart = parts[parts.length - 1];\n      if (lastPart.startsWith('mdi-')) {\n        finalName = lastPart.substring(4); // Remove \"mdi-\" prefix\n      } else if (lastPart.startsWith('fa-')) {\n        finalName = lastPart.substring(3); // Remove \"fa-\" prefix\n      } else {\n        finalName = lastPart;\n      }\n    }\n  }\n\n  const finalLibrary = library || defaultLibrary || 'fa';\n\n  // Normalize a redundant leading library prefix (e.g. \"fa-check\" -> \"check\" when the\n  // library is 'fa'), so `name` behaves identically with or without the prefix.\n  finalName = stripRedundantLibraryPrefix(finalName, finalLibrary);\n\n  if (!finalName) {\n    // No glyph to name. Reachable through the public type only as `icon=\"\"`, and otherwise\n    // by a plain-JS caller (or one that casts). Building a class off an absent name produced\n    // a bogus `fa-undefined` glyph; render the bare container instead, matching the\n    // `children` branch.\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      />\n    );\n  }\n\n  // Backward compatibility: if libraryFeatures is provided, parse it for variant and features\n  let finalVariant = variant;\n  let finalFeatures = features;\n\n  if (libraryFeatures && !variant && !features) {\n    const legacyFeatures = Array.isArray(libraryFeatures)\n      ? libraryFeatures\n      : [libraryFeatures];\n\n    // For Font Awesome, extract style from features\n    if (finalLibrary === 'fa') {\n      const faStyle = legacyFeatures.find(f =>\n        [\n          'fas',\n          'far',\n          'fab',\n          'fal',\n          'fad',\n          'fat',\n          'solid',\n          'regular',\n          'brands',\n          'light',\n          'duotone',\n          'thin',\n        ].includes(f)\n      );\n      if (faStyle) {\n        finalVariant = faStyle;\n        finalFeatures = legacyFeatures.filter(f => f !== faStyle);\n      } else {\n        finalFeatures = legacyFeatures;\n      }\n    }\n    // For Material Icons/Symbols, extract style variant\n    else if (\n      finalLibrary === 'material-icons' ||\n      finalLibrary === 'material-symbols'\n    ) {\n      const styleVariants =\n        finalLibrary === 'material-icons'\n          ? ['filled', 'outlined', 'round', 'sharp']\n          : ['outlined', 'rounded', 'sharp'];\n\n      const styleVariant = legacyFeatures.find(f => styleVariants.includes(f));\n      if (styleVariant) {\n        finalVariant = styleVariant;\n        finalFeatures = legacyFeatures.filter(f => f !== styleVariant);\n      } else {\n        finalFeatures = legacyFeatures;\n      }\n    }\n    // For others, all features go to finalFeatures\n    else {\n      finalFeatures = legacyFeatures;\n    }\n  }\n\n  // Handle web components vs CSS-based icons\n  if (finalLibrary === 'ion') {\n    // For Ionicons, handle variant in the name\n    let ionName = finalName;\n    if (finalVariant === 'outline') {\n      ionName = `${finalName}-outline`;\n    } else if (finalVariant === 'sharp') {\n      ionName = `${finalName}-sharp`;\n    }\n\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        <ion-icon name={ionName} />\n      </span>\n    );\n  }\n\n  // Legacy CSS-based icons\n  const iClasses = getIconClasses(\n    finalLibrary,\n    finalName,\n    finalVariant,\n    finalFeatures\n  );\n\n  // Material Icons and Material Symbols use text content, not CSS classes for the icon name\n  if (\n    finalLibrary === 'material-icons' ||\n    finalLibrary === 'material-symbols'\n  ) {\n    return (\n      <span\n        className={iconContainerClasses}\n        {...a11yProps}\n        style={style}\n        {...rest}\n      >\n        <i className={iClasses}>{finalName}</i>\n      </span>\n    );\n  }\n\n  return (\n    <span\n      className={iconContainerClasses}\n      {...a11yProps}\n      style={style}\n      {...rest}\n    >\n      <i className={iClasses} />\n    </span>\n  );\n};\n"],"names":["_jsx"],"mappings":"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"}

package/dist/esm/form/Autocomplete.js

@@ -22,7 +22,7 @@ const keepFocus = (e) => e.preventDefault();
 // An IME that's composing owns every key: Enter confirms what it composed,
 // and the arrows move through its candidates. Safari can say so with
 // `keyCode` 229 rather than `isComposing`.
-const isComposing = (e) => e.nativeEvent.isComposing || e.nativeEvent.keyCode === 229;
+const isComposing$1 = (e) => e.nativeEvent.isComposing || e.nativeEvent.keyCode === 229;
 // Whether an option can be picked. The arrows still reach a disabled one, so
 // a screen reader user finds it.
 const isEnabled = (item) => typeof item === 'string' || !item.disabled;
@@ -185,7 +185,7 @@ label, labelSize, labelProps, horizontal, message, messageColor, fieldClassName,
     }, [keepFirst, isActive, filteredData.length, inputValue]);
     // Handle keyboard navigation
     const handleKeyDown = useCallback((e) => {
-        if (disabled || isComposing(e))
+        if (disabled || isComposing$1(e))
             return;
         switch (e.key) {
             case 'ArrowDown':