@bubo-squared/ui-framework 0.2.21 → 0.2.23

package/dist/index.d.cts

@@ -137,8 +137,8 @@ type BadgeVariant = "primary" | "secondary" | "informal" | "success" | "warning"
 type BadgeSize = "sm" | "md" | "lg" | "xl";
 interface BadgeProps extends VariantProps<typeof badgeVariants> {
     asChild?: boolean;
-    label: string;
-    value?: string;
+    label: React$1.ReactNode;
+    value?: React$1.ReactNode;
     className?: string;
     size?: BadgeSize;
     variant?: BadgeVariant;
@@ -168,7 +168,7 @@ interface BadgeDotProps extends VariantProps<typeof badgeDotVariants> {
 declare const BadgeDot: React$1.FC<BadgeDotProps>;
 
 interface BadgeStatusProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    label: string;
+    label: React$1.ReactNode;
     active?: boolean;
     dotClassName?: string;
 }
@@ -184,7 +184,7 @@ interface BaseDividerProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Size variant for the divider (affects line thickness + center element sizing). */
     size?: DividerSize;
     /** Label shown for text variant (e.g. "OR"). */
-    label?: string;
+    label?: React$1.ReactNode;
 }
 type ButtonVariant = ButtonProps$1["variant"];
 type IconButtonVariant = ButtonProps["variant"];
@@ -211,7 +211,7 @@ interface ButtonLinesDividerProps extends React$1.HTMLAttributes<HTMLDivElement>
     /** Size variant for the divider (affects line thickness + button size). */
     size?: DividerSize;
     /** Text inside the button between the lines. */
-    buttonLabel: string;
+    buttonLabel: React$1.ReactNode;
     /** onClick handler for the button between the lines. */
     onButtonClick: React$1.MouseEventHandler<HTMLButtonElement>;
     /** Variant for the button between the lines. */
@@ -235,9 +235,11 @@ interface ProgressProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "ch
     /** Current value, from 0 to 100. */
     value: number;
     /** Optional label shown above the bar. */
-    label?: string;
+    label?: React$1.ReactNode;
     /** Optional hint text shown below the bar. */
-    hint?: string;
+    hint?: React$1.ReactNode;
+    /** Optional accessible label for the progressbar (string-only). */
+    ariaLabel?: string;
     /** Controls whether the progress percentage label is rendered. */
     showProgressLabel?: boolean;
     /** If true, the hint will not be rendered even if provided. */
@@ -263,8 +265,8 @@ declare const tagVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface TagProps extends VariantProps<typeof tagVariants> {
     asChild?: boolean;
-    label: string;
-    value?: string;
+    label: React$1.ReactNode;
+    value?: React$1.ReactNode;
     className?: string;
     leadingIcon?: React$1.ReactElement<{
         disabled?: boolean;
@@ -272,7 +274,7 @@ interface TagProps extends VariantProps<typeof tagVariants> {
     trailingIcon?: React$1.ReactElement<{
         disabled?: boolean;
     }>;
-    size: "sm" | "md";
+    size?: "sm" | "md";
     disabled?: boolean;
 }
 declare const Tag: React$1.ForwardRefExoticComponent<TagProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -327,15 +329,15 @@ declare const MenuSubTrigger: typeof DropdownMenuSubTrigger;
 interface CheckboxProps extends React$1.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> {
     /** Only needed when the component is a part of a native form. */
     name?: string;
-    label?: string;
+    label?: React$1.ReactNode;
 }
 declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLButtonElement>>;
 
 type TextInputSize = "sm" | "md" | "lg" | "xl";
 type TextInputStatus = "default" | "success" | "error";
 interface TextInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "size" | "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -355,8 +357,8 @@ interface TextInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEleme
 declare const TextInput: React$1.ForwardRefExoticComponent<TextInputProps & React$1.RefAttributes<HTMLInputElement>>;
 
 interface AutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "size" | "disabled" | "value" | "defaultValue" | "onChange"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /** If true, the hint will not be rendered even if provided. */
     hideHint?: boolean;
     status?: TextInputStatus;
@@ -377,6 +379,11 @@ interface AutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEl
     inputValue?: string;
     defaultInputValue?: string;
     onInputChange?: (value: string) => void;
+    /**
+     * If true, free-typed input is also treated as the committed value.
+     * Selecting an option from the dropdown still overrides the value.
+     */
+    freeSolo?: boolean;
     /** Optional className for the dropdown (options container). */
     dropdownClassName?: string;
     /** Optional className for the listbox (<ul>). */
@@ -386,7 +393,7 @@ declare const Autocomplete: React$1.ForwardRefExoticComponent<AutocompleteProps
 
 type SelectStatus = "default" | "success" | "error";
 interface SelectOption {
-    label: string;
+    label: React$1.ReactNode;
     value: string;
 }
 declare const selectTriggerVariants: (props?: ({
@@ -394,8 +401,8 @@ declare const selectTriggerVariants: (props?: ({
     status?: "error" | "success" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SelectProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onChange">, VariantProps<typeof selectTriggerVariants> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -419,9 +426,9 @@ declare const Select: React$1.ForwardRefExoticComponent<SelectProps & React$1.Re
 
 type FieldStatus = "default" | "success" | "error";
 interface FieldProps {
-    label?: string;
+    label?: React$1.ReactNode;
     labelRight?: React$1.ReactNode;
-    hint?: string;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -437,8 +444,8 @@ type PasswordInputSize = "sm" | "md" | "lg" | "xl";
 type PasswordInputStatus = "default" | "success" | "error";
 type PasswordInputVariant = "icon" | "text";
 interface PasswordInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -461,8 +468,8 @@ type PhoneInputProps = Omit<React$1.ComponentProps<"input">, "onChange" | "value
     onChange?: (value: RPNInput.Value) => void;
 } & {
     className?: string;
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -482,12 +489,12 @@ declare const PhoneInput: React$1.ForwardRefExoticComponent<PhoneInputProps>;
 type RadioGroupOrientation = "vertical" | "horizontal";
 interface RadioGroupOption {
     value: string;
-    label: string;
+    label: React$1.ReactNode;
     disabled?: boolean;
 }
 interface RadioGroupProps extends Omit<RadioGroupPrimitive.RadioGroupProps, "children" | "orientation" | "onValueChange"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /** Only needed when the component is a part of a native form. */
     name?: string;
     /** Only needed when the component is a part of a native form. */
@@ -564,8 +571,8 @@ declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.Re
 
 type TextAreaType = "responsive" | "character-limit" | "plain";
 interface TextAreaProps extends Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -601,7 +608,7 @@ interface ToggleProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>
      * Provide this to include the checked value in native form submission / FormData.
      */
     name?: string;
-    label?: string;
+    label?: React$1.ReactNode;
 }
 declare const Toggle: React$1.ForwardRefExoticComponent<ToggleProps & React$1.RefAttributes<HTMLInputElement>>;
 
@@ -627,9 +634,9 @@ declare const WebsiteInput: React$1.ForwardRefExoticComponent<WebsiteInputProps
 type PopoverPlacement = "top" | "topLeft" | "topRight" | "bottom" | "bottomLeft" | "bottomRight" | "left" | "leftTop" | "leftBottom" | "right" | "rightTop" | "rightBottom";
 interface PopoverProps {
     children: React$1.ReactNode;
-    strapline?: string;
-    title: string;
-    description?: string;
+    strapline?: React$1.ReactNode;
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
     onOk?: () => void;
     okText?: string;
     onCancel?: () => void;
@@ -653,9 +660,9 @@ declare const Popover: React$1.FC<PopoverProps>;
 type TooltipPlacement = "top" | "topLeft" | "topRight" | "bottom" | "bottomLeft" | "bottomRight" | "left" | "leftTop" | "leftBottom" | "right" | "rightTop" | "rightBottom";
 interface TooltipProps {
     children: React$1.ReactNode;
-    strapline?: string;
-    title: string;
-    description?: string;
+    strapline?: React$1.ReactNode;
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
     showArrow?: boolean;
     className?: string;
     placement?: TooltipPlacement;

package/dist/index.d.ts

@@ -137,8 +137,8 @@ type BadgeVariant = "primary" | "secondary" | "informal" | "success" | "warning"
 type BadgeSize = "sm" | "md" | "lg" | "xl";
 interface BadgeProps extends VariantProps<typeof badgeVariants> {
     asChild?: boolean;
-    label: string;
-    value?: string;
+    label: React$1.ReactNode;
+    value?: React$1.ReactNode;
     className?: string;
     size?: BadgeSize;
     variant?: BadgeVariant;
@@ -168,7 +168,7 @@ interface BadgeDotProps extends VariantProps<typeof badgeDotVariants> {
 declare const BadgeDot: React$1.FC<BadgeDotProps>;
 
 interface BadgeStatusProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    label: string;
+    label: React$1.ReactNode;
     active?: boolean;
     dotClassName?: string;
 }
@@ -184,7 +184,7 @@ interface BaseDividerProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Size variant for the divider (affects line thickness + center element sizing). */
     size?: DividerSize;
     /** Label shown for text variant (e.g. "OR"). */
-    label?: string;
+    label?: React$1.ReactNode;
 }
 type ButtonVariant = ButtonProps$1["variant"];
 type IconButtonVariant = ButtonProps["variant"];
@@ -211,7 +211,7 @@ interface ButtonLinesDividerProps extends React$1.HTMLAttributes<HTMLDivElement>
     /** Size variant for the divider (affects line thickness + button size). */
     size?: DividerSize;
     /** Text inside the button between the lines. */
-    buttonLabel: string;
+    buttonLabel: React$1.ReactNode;
     /** onClick handler for the button between the lines. */
     onButtonClick: React$1.MouseEventHandler<HTMLButtonElement>;
     /** Variant for the button between the lines. */
@@ -235,9 +235,11 @@ interface ProgressProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "ch
     /** Current value, from 0 to 100. */
     value: number;
     /** Optional label shown above the bar. */
-    label?: string;
+    label?: React$1.ReactNode;
     /** Optional hint text shown below the bar. */
-    hint?: string;
+    hint?: React$1.ReactNode;
+    /** Optional accessible label for the progressbar (string-only). */
+    ariaLabel?: string;
     /** Controls whether the progress percentage label is rendered. */
     showProgressLabel?: boolean;
     /** If true, the hint will not be rendered even if provided. */
@@ -263,8 +265,8 @@ declare const tagVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface TagProps extends VariantProps<typeof tagVariants> {
     asChild?: boolean;
-    label: string;
-    value?: string;
+    label: React$1.ReactNode;
+    value?: React$1.ReactNode;
     className?: string;
     leadingIcon?: React$1.ReactElement<{
         disabled?: boolean;
@@ -272,7 +274,7 @@ interface TagProps extends VariantProps<typeof tagVariants> {
     trailingIcon?: React$1.ReactElement<{
         disabled?: boolean;
     }>;
-    size: "sm" | "md";
+    size?: "sm" | "md";
     disabled?: boolean;
 }
 declare const Tag: React$1.ForwardRefExoticComponent<TagProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -327,15 +329,15 @@ declare const MenuSubTrigger: typeof DropdownMenuSubTrigger;
 interface CheckboxProps extends React$1.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> {
     /** Only needed when the component is a part of a native form. */
     name?: string;
-    label?: string;
+    label?: React$1.ReactNode;
 }
 declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLButtonElement>>;
 
 type TextInputSize = "sm" | "md" | "lg" | "xl";
 type TextInputStatus = "default" | "success" | "error";
 interface TextInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "size" | "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -355,8 +357,8 @@ interface TextInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEleme
 declare const TextInput: React$1.ForwardRefExoticComponent<TextInputProps & React$1.RefAttributes<HTMLInputElement>>;
 
 interface AutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "size" | "disabled" | "value" | "defaultValue" | "onChange"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /** If true, the hint will not be rendered even if provided. */
     hideHint?: boolean;
     status?: TextInputStatus;
@@ -377,6 +379,11 @@ interface AutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEl
     inputValue?: string;
     defaultInputValue?: string;
     onInputChange?: (value: string) => void;
+    /**
+     * If true, free-typed input is also treated as the committed value.
+     * Selecting an option from the dropdown still overrides the value.
+     */
+    freeSolo?: boolean;
     /** Optional className for the dropdown (options container). */
     dropdownClassName?: string;
     /** Optional className for the listbox (<ul>). */
@@ -386,7 +393,7 @@ declare const Autocomplete: React$1.ForwardRefExoticComponent<AutocompleteProps
 
 type SelectStatus = "default" | "success" | "error";
 interface SelectOption {
-    label: string;
+    label: React$1.ReactNode;
     value: string;
 }
 declare const selectTriggerVariants: (props?: ({
@@ -394,8 +401,8 @@ declare const selectTriggerVariants: (props?: ({
     status?: "error" | "success" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SelectProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onChange">, VariantProps<typeof selectTriggerVariants> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -419,9 +426,9 @@ declare const Select: React$1.ForwardRefExoticComponent<SelectProps & React$1.Re
 
 type FieldStatus = "default" | "success" | "error";
 interface FieldProps {
-    label?: string;
+    label?: React$1.ReactNode;
     labelRight?: React$1.ReactNode;
-    hint?: string;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -437,8 +444,8 @@ type PasswordInputSize = "sm" | "md" | "lg" | "xl";
 type PasswordInputStatus = "default" | "success" | "error";
 type PasswordInputVariant = "icon" | "text";
 interface PasswordInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -461,8 +468,8 @@ type PhoneInputProps = Omit<React$1.ComponentProps<"input">, "onChange" | "value
     onChange?: (value: RPNInput.Value) => void;
 } & {
     className?: string;
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -482,12 +489,12 @@ declare const PhoneInput: React$1.ForwardRefExoticComponent<PhoneInputProps>;
 type RadioGroupOrientation = "vertical" | "horizontal";
 interface RadioGroupOption {
     value: string;
-    label: string;
+    label: React$1.ReactNode;
     disabled?: boolean;
 }
 interface RadioGroupProps extends Omit<RadioGroupPrimitive.RadioGroupProps, "children" | "orientation" | "onValueChange"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /** Only needed when the component is a part of a native form. */
     name?: string;
     /** Only needed when the component is a part of a native form. */
@@ -564,8 +571,8 @@ declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.Re
 
 type TextAreaType = "responsive" | "character-limit" | "plain";
 interface TextAreaProps extends Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, "disabled"> {
-    label?: string;
-    hint?: string;
+    label?: React$1.ReactNode;
+    hint?: React$1.ReactNode;
     /**
      * If true, the hint will not be rendered even if provided.
      */
@@ -601,7 +608,7 @@ interface ToggleProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>
      * Provide this to include the checked value in native form submission / FormData.
      */
     name?: string;
-    label?: string;
+    label?: React$1.ReactNode;
 }
 declare const Toggle: React$1.ForwardRefExoticComponent<ToggleProps & React$1.RefAttributes<HTMLInputElement>>;
 
@@ -627,9 +634,9 @@ declare const WebsiteInput: React$1.ForwardRefExoticComponent<WebsiteInputProps
 type PopoverPlacement = "top" | "topLeft" | "topRight" | "bottom" | "bottomLeft" | "bottomRight" | "left" | "leftTop" | "leftBottom" | "right" | "rightTop" | "rightBottom";
 interface PopoverProps {
     children: React$1.ReactNode;
-    strapline?: string;
-    title: string;
-    description?: string;
+    strapline?: React$1.ReactNode;
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
     onOk?: () => void;
     okText?: string;
     onCancel?: () => void;
@@ -653,9 +660,9 @@ declare const Popover: React$1.FC<PopoverProps>;
 type TooltipPlacement = "top" | "topLeft" | "topRight" | "bottom" | "bottomLeft" | "bottomRight" | "left" | "leftTop" | "leftBottom" | "right" | "rightTop" | "rightBottom";
 interface TooltipProps {
     children: React$1.ReactNode;
-    strapline?: string;
-    title: string;
-    description?: string;
+    strapline?: React$1.ReactNode;
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
     showArrow?: boolean;
     className?: string;
     placement?: TooltipPlacement;