@allxsmith/bestax-bulma 5.8.0 → 5.8.2

package/dist/types/form/DateTimeInputBase.d.ts

@@ -6,90 +6,92 @@ import { DateFormatOption } from './_pickerInternals/formatters';
  * Props for the raw DateTimeInput base. Use the higher-level `DateTimeInput`
  * for Field/Control composition. Combines the prop set of `DateInputBaseProps`
  * and `TimeInputBaseProps`.
- *
- * @property {Date | null} [value] - Controlled selected date-time.
- * @property {Date | null} [defaultValue] - Initial value for uncontrolled usage.
- * @property {(d: Date | null) => void} [onChange] - Fired when either half changes.
- * @property {() => void} [onOpen] - Fired when the popover opens.
- * @property {() => void} [onClose] - Fired when the popover closes.
- * @property {Date} [min] - Lower bound for the combined date-time.
- * @property {Date} [max] - Upper bound for the combined date-time.
- * @property {boolean} [disabled] - Disable the input.
- * @property {boolean} [readOnly] - Read-only input.
- * @property {string} [placeholder] - Placeholder text.
- * @property {DateFormatOption} [format] - Token format string or `Intl.DateTimeFormat` options. Default `'YYYY-MM-DD HH:mm'`.
- * @property {(s: string) => Date | null} [parse] - Custom parser.
- * @property {string} [locale] - BCP-47 locale tag.
- * @property {boolean} [inline] - Render the panel inline (no popover).
- * @property {boolean | 'auto'} [mobileNative] - Use native `<input type="datetime-local">` on coarse-pointer devices.
- * @property {boolean} [editable] - Allow segmented keyboard typing in the input (type the date-time directly, auto-advancing across segments). Default `true`.
- * @property {boolean} [popover] - Whether the calendar + time popover exists. `false` makes the field input-only (segmented typing with no popover). Default `true`.
- * @property {boolean} [openOnFocus] - Open the popover on focus. Default `true`.
- * @property {boolean} [closeOnSelect] - Close after selection. Default `false`.
- * @property {PickerPosition} [position] - Popover anchor position.
- * @property {boolean} [appendToBody] - Render the popover into `document.body` via portal.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color modifier.
- * @property {'small'|'medium'|'large'} [size] - Size variant.
- * @property {boolean} [isRounded] - Rounded input corners.
- * @property {(d: Date) => boolean} [shouldDisableDate] - Predicate for disabled dates. Blocked dates can't be picked in the calendar and are rejected by manual typing; during entry the predicate receives the full candidate date-time, so prefer day-based checks.
- * @property {Date[]} [unselectableDates] - Convenience array of disabled dates, matched by calendar day; also rejected by manual typing.
- * @property {DayOfWeek} [firstDayOfWeek] - Day the calendar week starts on.
- * @property {string[]} [dayNames] - Override the 7 day-name labels.
- * @property {string[]} [monthNames] - Override the 12 month-name labels.
- * @property {boolean} [nearbyMonthDays] - Show dimmed dates from adjacent months.
- * @property {HourFormat} [hourFormat] - `'12'` or `'24'`. Default `'24'`.
- * @property {boolean} [enableSeconds] - Show a seconds column. Note: iOS Safari's native datetime-local picker has no seconds wheel; combine with `mobileNative={false}` if a seconds wheel is required on iOS.
- * @property {number} [incrementHours] - Hour step.
- * @property {number} [incrementMinutes] - Minute step.
- * @property {number} [incrementSeconds] - Second step.
- * @property {(d: Date) => boolean} [unselectableTimes] - Predicate for blocked times (the wheels skip ahead; manual typing rejects them).
- * @property {string} [iconLeftName] - Decorative left icon glyph for the wrapping Control (shown by default; set to '' to hide).
- * @property {boolean} [triggerIcon] - Show a clickable launcher button on the right that toggles the popover. Default `true`.
- * @property {string} [triggerIconName] - Glyph name for the right launcher button. Default `'chevron-down'`.
- * @property {boolean} [audioTick] - Play a short audible tick on each time-wheel crossing. Default `false`.
- * @property {boolean} [haptics] - Auto-route tactile feedback per wheel tick (vibrate on Android, audio thunk on iOS). Default `false`.
  */
 export interface DateTimeInputBaseProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'value' | 'defaultValue' | 'onChange' | 'size' | 'color' | 'min' | 'max' | 'type' | 'popover'>, Omit<BulmaClassesProps, 'color'> {
+    /** Controlled selected date-time. */
     value?: Date | null;
+    /** Initial value for uncontrolled usage. */
     defaultValue?: Date | null;
+    /** Fired when either the date or time portion changes. */
     onChange?: (d: Date | null) => void;
+    /** Fired when the popover opens. */
     onOpen?: () => void;
+    /** Fired when the popover closes. */
     onClose?: () => void;
+    /** Lower bound for the combined date-time. */
     min?: Date;
+    /** Upper bound for the combined date-time. */
     max?: Date;
+    /** Disable the input. */
     disabled?: boolean;
+    /** Read-only input. */
     readOnly?: boolean;
+    /** Placeholder text. */
     placeholder?: string;
+    /**
+     * Token format string or `Intl.DateTimeFormat` options. Default `'YYYY-MM-DD HH:mm'`.
+     * @defaultValue 'YYYY-MM-DD HH:mm'
+     */
     format?: DateFormatOption;
+    /** Custom parser. */
     parse?: (s: string) => Date | null;
+    /** BCP-47 locale tag. */
     locale?: string;
+    /** Render the panel inline (no popover). */
     inline?: boolean;
+    /** Use `<input type="datetime-local">` on coarse-pointer devices. */
     mobileNative?: boolean | 'auto';
+    /** Allow segmented keyboard typing (type the date-time directly across all segments). `false` makes the field picker-only. */
     editable?: boolean;
+    /** Whether the calendar + time popover exists. `false` makes the field input-only (segmented typing with no popover). Default `true`. */
     popover?: boolean;
+    /** Open the popover on focus. Default `true`. */
     openOnFocus?: boolean;
+    /** Off by default — users typically tweak both halves before committing. */
     closeOnSelect?: boolean;
+    /** Popover anchor position. */
     position?: PickerPosition;
+    /** Render the popover into `document.body` via portal. */
     appendToBody?: boolean;
+    /** Bulma color modifier. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Size variant. */
     size?: 'small' | 'medium' | 'large';
+    /** Rounded input corners. */
     isRounded?: boolean;
+    /** Disable specific dates. Blocked dates are also rejected during manual typing (the predicate receives the full candidate date-time — prefer day-based checks). */
     shouldDisableDate?: (d: Date) => boolean;
+    /** Convenience array of disabled dates, matched by calendar day; also rejected by manual typing. */
     unselectableDates?: Date[];
+    /** Day the calendar week starts on. */
     firstDayOfWeek?: DayOfWeek;
+    /** Override the 7 day-name labels. */
     dayNames?: string[];
+    /** Override the 12 month-name labels. */
     monthNames?: string[];
+    /** Show dimmed dates from adjacent months. */
     nearbyMonthDays?: boolean;
+    /** Time format. */
     hourFormat?: HourFormat;
+    /** Show seconds column. Note: iOS Safari's native datetime-local picker UI does not include a seconds wheel; pass `mobileNative={false}` if you need one on iOS. */
     enableSeconds?: boolean;
+    /** Hour step. */
     incrementHours?: number;
+    /** Step between minute-wheel values (`1` = every minute, iOS-style). */
     incrementMinutes?: number;
+    /** Step between second-wheel values (only with `enableSeconds`). */
     incrementSeconds?: number;
+    /** Block specific times. Blocked times are also rejected during manual typing. */
     unselectableTimes?: (d: Date) => boolean;
+    /** Decorative left icon glyph for the wrapping `Control` (shown by default). Set `''` to hide. */
     iconLeftName?: string;
+    /** Show a clickable launcher button on the right that toggles the popover. Default `true`. */
     triggerIcon?: boolean;
+    /** Glyph for the right launcher button. */
     triggerIconName?: string;
+    /** Play a short audible tick on each time-wheel crossing. Default `false`. */
     audioTick?: boolean;
+    /** Auto-route tactile feedback per wheel tick (vibrate on Android, audio thunk on iOS). Default `false`. */
     haptics?: boolean;
     /** Optional translatable string overrides. */
     labels?: PickerLabels;

package/dist/types/form/Field.d.ts

@@ -2,68 +2,65 @@ import React from 'react';
 import { BulmaClassesProps, validColors } from '../helpers/useBulmaClasses';
 /**
  * Props for the Field component.
- *
- * @property {boolean} [horizontal] - Renders the field as horizontal (label and control side by side).
- * @property {boolean|'centered'|'right'|'multiline'} [grouped] - Group controls in a row (optionally centered, right, or multiline).
- * @property {boolean|'centered'|'right'} [hasAddons] - Group controls as addons (optionally centered or right-aligned).
- * @property {boolean} [narrow] - Constrains the field to its content's width (used inside horizontal field bodies).
- * @property {React.ReactNode} [label] - Field label.
- * @property {'small'|'normal'|'medium'|'large'} [labelSize] - Size for the label.
- * @property {object} [labelProps] - Props for the label element.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the field.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color for the field.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the field.
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Field content.
  */
 export interface FieldProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Renders the field as horizontal (label and control side by side). */
     horizontal?: boolean;
+    /** Group controls in a row (optionally centered, right, or multiline). */
     grouped?: boolean | 'centered' | 'right' | 'multiline';
+    /** Group controls as addons (optionally centered or right-aligned). */
     hasAddons?: boolean | 'centered' | 'right';
+    /** Constrains the field to its content's width (used inside horizontal field bodies). */
     narrow?: boolean;
+    /** Field label, rendered above the widget. `Field` itself does not associate it with any control — pass `labelProps={{ htmlFor }}` and a matching `id` on your control (the single-control convenience inputs do this automatically when they render their own `Field`). */
     label?: React.ReactNode;
+    /** Size for the label. */
     labelSize?: 'small' | 'normal' | 'medium' | 'large';
+    /** Props for the label element — where `htmlFor` goes when composing. */
     labelProps?: React.LabelHTMLAttributes<HTMLLabelElement> & {
         [key: string]: unknown;
     };
+    /** Text color for the field. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color for the field. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color for the field. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Additional CSS classes. */
     className?: string;
+    /** Field content. */
     children?: React.ReactNode;
 }
 /**
  * Props for the FieldLabel component.
- *
- * @property {'small'|'normal'|'medium'|'large'} [size] - Size for the field label.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the label.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color for the label.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the label.
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Field label content.
  */
 export interface FieldLabelProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Size for the field label. */
     size?: 'small' | 'normal' | 'medium' | 'large';
+    /** Text color for the label. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color for the label. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color for the label. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Additional CSS classes. */
     className?: string;
+    /** Field label content. */
     children?: React.ReactNode;
 }
 /**
  * Props for the FieldBody component.
- *
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color for the field body.
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'} [color] - Bulma color for the field body.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [bgColor] - Background color for the field body.
- * @property {string} [className] - Additional CSS classes.
- * @property {React.ReactNode} [children] - Field body content.
  */
 export interface FieldBodyProps extends React.HTMLAttributes<HTMLDivElement>, Omit<BulmaClassesProps, 'color' | 'backgroundColor'> {
+    /** Text color for the field body. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Bulma color for the field body. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Background color for the field body. */
     bgColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Additional CSS classes. */
     className?: string;
+    /** Field body content. */
     children?: React.ReactNode;
 }
 /**

package/dist/types/form/File.d.ts

@@ -3,39 +3,43 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { FormFieldProps } from './fieldProps';
 /**
  * Props for the File component.
- *
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'|'black'|'dark'|'light'|'white'} [color] - Bulma color modifier for the file input.
- * @property {'small'|'medium'|'large'} [size] - Size modifier for the file input.
- * @property {boolean} [isBoxed] - Whether the file input is boxed.
- * @property {boolean} [isFullwidth] - Whether the file input expands to full width.
- * @property {boolean} [isRight] - Align file input to the right.
- * @property {boolean} [isCentered] - Center the file input.
- * @property {boolean} [hasName] - Show a file name indicator.
- * @property {React.ReactNode} [buttonLabel] - Custom button label text or node.
- * @property {React.ReactNode} [iconLeft] - Left icon element.
- * @property {React.ReactNode} [iconRight] - Right icon element.
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {string} [inputClassName] - Additional CSS classes for the input.
- * @property {string} [fileName] - File name to display.
  */
 export interface FileProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'color' | 'type'>, Omit<BulmaClassesProps, 'color'>, FormFieldProps {
+    /** Field label. Automatically associated with the file input via `htmlFor` — uses your `id` when provided, otherwise a generated one. The input then has two labels (this one plus the wrapping `file-label`); assistive tech reads both. Dropped inside an outer `Field` (label that `Field` yourself). */
+    label?: React.ReactNode;
+    /** Props for the label element. An explicit `htmlFor` here overrides the automatic association (no id is generated then). */
+    labelProps?: React.LabelHTMLAttributes<HTMLLabelElement> & {
+        [key: string]: unknown;
+    };
+    /** Bulma color modifier for the file input. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
+    /** Size modifier for the file input. */
     size?: 'small' | 'medium' | 'large';
+    /** Boxed file input. */
     isBoxed?: boolean;
+    /** Whether the file input expands to full width. */
     isFullwidth?: boolean;
+    /** Position the CTA on the right (with `hasName`). */
     isRight?: boolean;
+    /** Center the file input within its container. */
     isCentered?: boolean;
+    /** Show a file name indicator. */
     hasName?: boolean;
+    /** Text on the file CTA button (defaults to "Choose a file…"). */
     buttonLabel?: React.ReactNode;
+    /** Left icon element. */
     iconLeft?: React.ReactNode;
+    /** Right icon element. */
     iconRight?: React.ReactNode;
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Additional CSS classes for the `<input>`. */
     inputClassName?: string;
+    /** File name to display. */
     fileName?: string;
 }
 /**
- * Bulma File upload component with full Bulma helper class support.
- * isRight and isCentered are mutually exclusive (Bulma spec).
+ * The `File` component provides a Bulma-styled file input, supporting color, size, boxed/fullwidth/align styles, icons, "has name", and filename display.
  *
  * @function
  * @param {FileProps} props - Props for the File component.

package/dist/types/form/Input.d.ts

@@ -8,53 +8,49 @@ import { InputBaseProps } from './InputBase';
  * Composes Field, Control, and Input into a single convenience component.
  * Supports all Input props, plus Field-level (label, horizontal) and
  * Control-level (icons, loading) props.
- *
- * @property {React.ReactNode} [label] - Field label.
- * @property {FieldProps['labelSize']} [labelSize] - Size for the label.
- * @property {FieldProps['labelProps']} [labelProps] - Props for the label element.
- * @property {boolean} [horizontal] - Horizontal field layout.
- * @property {ControlBaseProps['iconLeft']} [iconLeft] - Icon props for left icon.
- * @property {ControlBaseProps['iconRight']} [iconRight] - Icon props for right icon.
- * @property {string} [iconLeftName] - Shortcut for left icon name.
- * @property {string} [iconRightName] - Shortcut for right icon name.
- * @property {ControlBaseProps['iconLeftSize']} [iconLeftSize] - Shortcut for left icon size.
- * @property {ControlBaseProps['iconRightSize']} [iconRightSize] - Shortcut for right icon size.
- * @property {boolean} [hasIconsLeft] - Force left icon container.
- * @property {boolean} [hasIconsRight] - Force right icon container.
- * @property {boolean} [isLoading] - Show loading indicator on the control.
- * @property {boolean} [isExpanded] - Expand the control.
- * @property {'small'|'medium'|'large'} [controlSize] - Control size.
- * @property {React.ReactNode} [message] - Help/validation message below the input.
- * @property {string} [messageColor] - Bulma color for the message.
- * @property {string} [fieldClassName] - Additional CSS classes for the Field.
- * @property {string} [controlClassName] - Additional CSS classes for the Control.
  */
 export interface InputProps extends InputBaseProps {
+    /** Field label. Automatically associated with the input via `htmlFor` — uses your `id` when provided, otherwise a generated one. Dropped inside an outer `Field` (label that `Field` yourself). */
     label?: React.ReactNode;
+    /** Size for the label. */
     labelSize?: FieldProps['labelSize'];
+    /** Props for the label element. An explicit `htmlFor` here overrides the automatic association (no id is generated then). */
     labelProps?: FieldProps['labelProps'];
+    /** Horizontal field layout. */
     horizontal?: boolean;
+    /** Icon props for left icon. */
     iconLeft?: ControlBaseProps['iconLeft'];
+    /** Icon props for right icon. */
     iconRight?: ControlBaseProps['iconRight'];
+    /** Shortcut for left icon name. */
     iconLeftName?: string;
+    /** Shortcut for right icon name. */
     iconRightName?: string;
+    /** Shortcut for left icon size. */
     iconLeftSize?: ControlBaseProps['iconLeftSize'];
+    /** Shortcut for right icon size. */
     iconRightSize?: ControlBaseProps['iconRightSize'];
+    /** Force left icon container. */
     hasIconsLeft?: boolean;
+    /** Force right icon container. */
     hasIconsRight?: boolean;
+    /** Shows loading indicator. */
     isLoading?: boolean;
+    /** Expand the control. */
     isExpanded?: boolean;
+    /** Control size. */
     controlSize?: ControlBaseProps['size'];
+    /** Help/validation message below the input. */
     message?: React.ReactNode;
+    /** Bulma color for the message. */
     messageColor?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger';
+    /** Additional CSS classes for the Field. */
     fieldClassName?: string;
+    /** Additional CSS classes for the Control. */
     controlClassName?: string;
 }
 /**
- * Input is a convenience component that composes Field, Control, and Input.
- *
- * Use this for typical form fields. For complex layouts (grouped fields,
- * addons, etc.), compose Field, Control, and Input directly.
+ * The `Input` component provides a Bulma-styled text input, supporting colors, sizes, rounded corners, static/read-only state, hover/focus/loading states, and all Bulma helper props.
  *
  * @function
  * @param {InputProps} props - Props for Input.

package/dist/types/form/InputBase.d.ts

@@ -2,28 +2,27 @@ import React from 'react';
 import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 /**
  * Props for the Input component.
- *
- * @property {'primary'|'link'|'info'|'success'|'warning'|'danger'|'black'|'dark'|'light'|'white'} [color] - Bulma color modifier for the input.
- * @property {'small'|'medium'|'large'} [size] - Size modifier for the input.
- * @property {boolean} [isRounded] - Renders the input with rounded corners.
- * @property {boolean} [isStatic] - Renders the input as static text.
- * @property {boolean} [isHovered] - Applies the hovered state.
- * @property {boolean} [isFocused] - Applies the focused state.
- * @property {boolean} [isLoading] - Shows loading indicator.
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {boolean} [disabled] - Whether the input is disabled.
- * @property {boolean} [readOnly] - Whether the input is read-only.
  */
 export interface InputBaseProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, Omit<BulmaClassesProps, 'color'> {
+    /** Bulma color modifier for the input. */
     color?: 'primary' | 'link' | 'info' | 'success' | 'warning' | 'danger' | 'black' | 'dark' | 'light' | 'white';
+    /** Size modifier for the input. */
     size?: 'small' | 'medium' | 'large';
+    /** Rounded input corners. */
     isRounded?: boolean;
+    /** Renders input as static (read only, styled). */
     isStatic?: boolean;
+    /** Applies hovered state. */
     isHovered?: boolean;
+    /** Applies focused state. */
     isFocused?: boolean;
+    /** Shows loading indicator. */
     isLoading?: boolean;
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Disabled input. */
     disabled?: boolean;
+    /** Read-only input. */
     readOnly?: boolean;
 }
 /**

package/dist/types/form/Numberinput.d.ts

@@ -13,52 +13,55 @@ export type NumberinputControlsPosition = 'left' | 'right' | 'both';
 export type NumberinputVariant = 'plusminus' | 'stepper';
 /**
  * Props for the Numberinput component.
- *
- * @property {number} [value] - Controlled numeric value.
- * @property {number} [defaultValue] - Initial value for uncontrolled mode.
- * @property {number} [min] - Minimum allowed value.
- * @property {number} [max] - Maximum allowed value.
- * @property {number} [step] - Step increment (default: 1).
- * @property {NumberinputSize} [size] - Size of the input and buttons.
- * @property {NumberinputColor} [color] - Color for the control buttons.
- * @property {NumberinputInputColor} [inputColor] - Color for the inner input element.
- * @property {NumberinputControlsPosition} [controlsPosition] - Position of increment/decrement buttons (default: 'both').
- * @property {boolean} [controlsRounded] - Whether the control buttons are rounded.
- * @property {boolean} [compact] - Whether to use compact (addons) layout.
- * @property {boolean} [bare] - Bare mode: no outer .field wrapper, for composing inside a parent Field.
- * @property {NumberinputVariant} [variant] - Control variant: 'plusminus' (default) or 'stepper'.
- * @property {boolean} [disabled] - Whether the input is disabled.
- * @property {boolean} [editable] - Whether the user can type directly into the input (default: true).
- * @property {boolean} [isLoading] - Whether to show a loading spinner on the input.
- * @property {boolean} [exponential] - Whether the step grows with the value magnitude.
- * @property {(value: number) => void} [onChange] - Callback when the value changes.
- * @see {@link https://buefy.org/documentation/numberinput | Buefy Numberinput documentation}
+ * @extraProp {string} [className] - Additional CSS classes.
+ * @extraProp {React.Ref<HTMLElement>} [ref] - Ref forwarded to the input element.
  */
 export interface NumberinputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'color' | 'size' | 'onChange' | 'value' | 'defaultValue' | 'type'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor' | 'size'>, FormFieldProps {
+    /** Field label. Automatically associated with the number input via `htmlFor` — uses your `id` when provided, otherwise a generated one. Not wired when no Field wrapper is rendered (inside a `Field`, or plusminus `bare`). */
+    label?: React.ReactNode;
+    /** Props for the label element. An explicit `htmlFor` here overrides the automatic association (no id is generated then). */
+    labelProps?: React.LabelHTMLAttributes<HTMLLabelElement> & {
+        [key: string]: unknown;
+    };
+    /** Controlled value. */
     value?: number;
+    /** Default value for uncontrolled usage. */
     defaultValue?: number;
+    /** Minimum allowed value. */
     min?: number;
+    /** Maximum allowed value. */
     max?: number;
+    /** Step increment (default: 1). */
     step?: number;
+    /** Size variant. */
     size?: NumberinputSize;
+    /** Color variant for buttons. */
     color?: NumberinputColor;
+    /** Color of the input field itself. */
     inputColor?: NumberinputInputColor;
+    /** Position of +/- buttons. */
     controlsPosition?: NumberinputControlsPosition;
+    /** Use rounded buttons. */
     controlsRounded?: boolean;
+    /** Uses compact button spacing. */
     compact?: boolean;
+    /** Removes button borders and background. */
     bare?: boolean;
+    /** Style variant for the control buttons. */
     variant?: NumberinputVariant;
+    /** Whether the input is disabled. */
     disabled?: boolean;
+    /** Whether the input can be typed in. */
     editable?: boolean;
+    /** Shows a loading state. */
     isLoading?: boolean;
+    /** Enables exponential step increments when holding buttons. */
     exponential?: boolean;
+    /** Callback when value changes. */
     onChange?: (value: number) => void;
 }
 /**
- * Bulma-styled numeric input with increment/decrement controls.
- *
- * Supports plus/minus buttons or a compact stepper variant,
- * with configurable min/max, step, and exponential stepping.
+ * The `Numberinput` component provides a number input with increment/decrement buttons.
  *
  * @function
  * @param {NumberinputProps} props - Props for the Numberinput component.

package/dist/types/form/Radio.d.ts

@@ -10,34 +10,23 @@ export declare const radioColors: readonly ["primary", "link", "info", "success"
 export declare const radioSizes: readonly ["small", "normal", "medium", "large"];
 /**
  * Props for the Radio component.
- *
- * @property {(typeof radioColors)[number]} [color] - Color variant for the radio.
- * @property {(typeof radioSizes)[number]} [size] - Size of the radio.
- * @property {boolean} [disabled] - Whether the radio is disabled.
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {(typeof validColors)[number] | 'inherit' | 'current'} [textColor] - Text color.
- * @property {React.ReactNode} [children] - The label/content for the radio.
- * @see Bulma Radio documentation: https://bulma.io/documentation/form/radio/
  */
 export interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'color'>, Omit<BulmaClassesProps, 'color' | 'backgroundColor' | 'size'> {
+    /** Color of the radio button. */
     color?: (typeof radioColors)[number];
+    /** Size of the radio button. */
     size?: (typeof radioSizes)[number];
+    /** Text color helper. */
     textColor?: (typeof validColors)[number] | 'inherit' | 'current';
+    /** Whether the radio is disabled. */
     disabled?: boolean;
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** The label/content for the radio. */
     children?: React.ReactNode;
 }
 /**
- * Bulma Radio component with themed styling support.
- *
- * Renders a custom-styled radio button with a visual indicator,
- * supporting colors, sizes, and various states. Inside a `<Radios>` group,
- * Radio inherits `name` and (when the group is in controlled or uncontrolled
- * mode) derives its `checked` state from the group's `value` and dispatches
- * the group's `onChange` when clicked.
- *
- * Local props always win over group context (`name`, `checked`, `onChange`
- * on Radio override the group). Required for opt-out scenarios.
+ * The `Radio` component provides a Bulma-styled radio button input with flexible labels and helper classes.
  *
  * @function
  * @param {RadioProps} props - Props for the Radio component.

package/dist/types/form/Radios.d.ts

@@ -3,20 +3,19 @@ import { BulmaClassesProps } from '../helpers/useBulmaClasses';
 import { FormFieldProps } from './fieldProps';
 /**
  * Props for the Radios component.
- *
- * @property {string} [className] - Additional CSS classes to apply.
- * @property {string} [name] - Form field name shared by every Radio in the group.
- * @property {string} [value] - Currently-selected value (controlled mode).
- * @property {string} [defaultValue] - Initial selected value (uncontrolled mode).
- * @property {(value: string) => void} [onChange] - Fired when the selection changes. Receives the new value.
- * @property {React.ReactNode} children - Radio elements to render in the group.
  */
 export interface RadiosProps extends Omit<BulmaClassesProps, 'color'>, FormFieldProps {
+    /** Additional CSS classes to apply. */
     className?: string;
+    /** Form field name shared by every Radio in the group (via context). */
     name?: string;
+    /** Currently-selected value (controlled mode). */
     value?: string;
+    /** Initial selected value (uncontrolled mode). */
     defaultValue?: string;
+    /** Fires when the selection changes. */
     onChange?: (value: string) => void;
+    /** Radio elements to render in the group. */
     children: React.ReactNode;
 }
 export declare const Radios: React.FC<RadiosProps> & {