bitboss-ui 2.1.113 → 2.1.115

package/dist/components/BaseRadio/types.d.ts

@@ -0,0 +1,173 @@
+import { InputHTMLAttributes, HTMLAttributes } from 'vue';
+/**
+ * Props for the base radio control that exposes a stylable icon slot while keeping native semantics.
+ */
+export type BaseRadioProps = {
+    /**
+     * Id(s) of descriptive elements associated with the radio.
+     */
+    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
+    /**
+     * Focus the control automatically after mount.
+     */
+    autofocus?: InputHTMLAttributes['autofocus'];
+    /**
+     * Force the radio into a checked state regardless of `modelValue`.
+     */
+    checked?: InputHTMLAttributes['checked'];
+    /**
+     * Name of the theme color to apply or any valid CSS color string.
+     */
+    color?: string;
+    /**
+     * Disable the radio. When combined with `readonly`, the control is also disabled to mimic native behaviour.
+     */
+    disabled?: boolean;
+    /**
+     * Apply the error styling class.
+     */
+    hasErrors?: boolean;
+    /**
+     * Explicit id for the underlying input element.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Current v-model value used to determine checked state.
+     */
+    modelValue?: any;
+    /**
+     * Shared group name for the radio input (required to join options).
+     */
+    name: InputHTMLAttributes['name'];
+    /**
+     * Treat the radio as read-only. Implemented by disabling the input while preserving styling hooks.
+     */
+    readonly?: boolean;
+    /**
+     * Mark the radio as required within its group.
+     */
+    required?: boolean;
+    /**
+     * Value emitted when the radio becomes checked. Accepts any serializable value.
+     */
+    value: any;
+};
+export type BaseRadioEvents = {
+    /**
+     * Emitted when the native input loses focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'blur', event: FocusEvent): void;
+    /**
+     * Emitted when the radio selection changes.
+     * Forwards the original DOM `Event`.
+     */
+    (e: 'change', event: Event): void;
+    /**
+     * Emitted when the input receives a click interaction.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'click', event: MouseEvent): void;
+    /**
+     * Emitted when the native input gains focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'focus', event: FocusEvent): void;
+    /**
+     * Emitted on native input events from the radio input.
+     * Forwards the original DOM `Event`.
+     */
+    (e: 'input', event: Event): void;
+    /**
+     * Emitted for keyboard interaction on the input.
+     * Forwards the original DOM `KeyboardEvent`.
+     */
+    (e: 'keydown', event: KeyboardEvent): void;
+    /**
+     * Emitted when a pointing device button is pressed over the input.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'mousedown', event: MouseEvent): void;
+    /**
+     * Emitted when a pointing device button is released over the input.
+     * Forwards the original DOM `MouseEvent`.
+     */
+    (e: 'mouseup', event: MouseEvent): void;
+    /**
+     * Emitted when the radio becomes selected, carrying the radio's `value` prop.
+     */
+    (e: 'update:modelValue', value: any): void;
+};
+/**
+ * Props exposed by the `icon` slot for custom radio visuals.
+ *
+ * These values are normalized at runtime so consumers receive stable types
+ * (not optional/undefined booleans).
+ */
+export type BaseRadioIconSlotProps = {
+    /**
+     * Whether the radio is currently selected.
+     */
+    checked: boolean;
+    /**
+     * Whether the radio is disabled.
+     * Mirrors `props.disabled`.
+     */
+    disabled: Exclude<BaseRadioProps['disabled'], undefined>;
+    /**
+     * Whether the native input currently has focus.
+     */
+    focused: boolean;
+    /**
+     * Whether focus is keyboard-visible (`:focus-visible`).
+     */
+    focusVisible: boolean;
+    /**
+     * Whether the radio is in an error state.
+     * Mirrors `props.hasErrors`.
+     */
+    hasErrors: Exclude<BaseRadioProps['hasErrors'], undefined>;
+    /**
+     * The `id` attribute of the underlying input.
+     * Mirrors `props.id`.
+     */
+    id: BaseRadioProps['id'];
+    /**
+     * The `name` attribute of the underlying input.
+     * Mirrors `props.name`.
+     */
+    name: BaseRadioProps['name'];
+    /**
+     * The radio value serialized to a string for form submission.
+     */
+    parsedValue: string;
+    /**
+     * Whether the radio is read-only.
+     * Mirrors `props.readonly`.
+     */
+    readonly: BaseRadioProps['readonly'];
+    /**
+     * The effective value of this radio option (the `value` prop).
+     */
+    value: any;
+};
+export type BaseRadioSlots = {
+    /**
+     * Replaces the default radio dot visual rendered inside the radio container.
+     * @param checked - Whether the radio is currently selected.
+     * @param disabled - Whether the radio is disabled.
+     * @param focused - Whether the radio input currently has focus.
+     * @param focusVisible - Whether focus is keyboard-visible (`:focus-visible`).
+     * @param hasErrors - Whether the radio is in an error state.
+     * @param id - The `id` attribute of the underlying input.
+     * @param name - The `name` attribute of the underlying input.
+     * @param parsedValue - The radio value serialized to a string for form submission.
+     * @param readonly - Whether the radio is read-only.
+     * @param value - The current effective value of this radio option.
+     */
+    icon?: (props: BaseRadioIconSlotProps) => any;
+};
+/**
+ * @deprecated Use `BaseRadioIconSlotProps`.
+ */
+export type SlotAttributes = BaseRadioIconSlotProps;

package/dist/components/BaseRadioGroup/BaseRadioGroup.vue.d.ts

@@ -1,290 +1,20 @@
-import { InputHTMLAttributes, HTMLAttributes } from 'vue';
-import { NestedKeyOf } from '../../types/NestedKeyOf';
-import { SlotAttributes } from '../BaseRadio/BaseRadio.vue';
-/**
- * Props for the radio group component that renders a list of radio options from items.
- */
-export type BaseRadioGroupProps<T> = {
-    /**
-     * Id(s) of elements describing this group for assistive technologies.
-     */
-    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
-    /**
-     * Focus the first radio on mount.
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Define a color for the component.
-     *
-     * Either a custom color or a coded color in common HEX, RGB, etc... format.
-     */
-    color?: string;
-    /**
-     * Additional dependencies that trigger item reloading when changed.
-     */
-    dependencies?: any[];
-    /**
-     * Debounce delay (ms) for dependency-triggered reloads.
-     * @default 0
-     */
-    depsDebounceTime?: number;
-    /**
-     * Direction of the layout of the inputs inside the fieldset. It can be either `horizontal` or `vertical`
-     */
-    direction?: 'horizontal' | 'vertical';
-    /**
-     * Disable all radios in the group.
-     */
-    disabled?: boolean;
-    /**
-     * Reset modelValue to `null` if it no longer matches available items (enforces coherence).
-     */
-    enforceCoherence?: boolean;
-    /**
-     * Apply error styling to the group.
-     */
-    hasErrors?: boolean;
-    /**
-     * Hide the visual label while keeping it accessible.
-     */
-    hideLabel?: boolean;
-    /**
-     * Explicit id for the fieldset. Used to generate ids for individual radios.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Array of items or function to load them asynchronously.
-     * @default []
-     */
-    items: T[] | ((prefill: boolean, modelValue?: any[]) => Promise<T[]>) | ((prefill: boolean, modelValue?: any[]) => T[]);
-    /**
-     * Path to item property for display text or function to extract it.
-     */
-    itemText?: T extends object ? NestedKeyOf<T> | ((item: T) => string) : ((item: T) => string) | undefined;
-    /**
-     * Path to item property for value or function to extract it.
-     */
-    itemValue?: T extends object ? NestedKeyOf<T> | ((item: T) => string) : ((item: T) => any) | undefined;
-    /**
-     * Message shown while items are loading.
-     */
-    loadingText?: string;
-    /**
-     * Used by v-model. Can be any serializable type.
-     */
-    modelValue: any;
-    /**
-     * Debounce delay (ms) for modelValue change handling.
-     * @default 0
-     */
-    modelValueDebounceTime?: number;
-    /**
-     * Shared name for all radios in the group (required for grouping).
-     */
-    name: InputHTMLAttributes['name'];
-    /**
-     * Message displayed when no items are available.
-     */
-    noDataText?: string;
-    /**
-     * Make all radios read-only.
-     */
-    readonly?: boolean;
-    /**
-     * Mark at least one radio as required.
-     */
-    required?: boolean;
-};
-/**
- * Events emitted by `BaseRadioGroup`.
- * - Native events (`blur`, `change`, etc.) are forwarded from radios.
- * - `inactive`: fired when focus leaves the group.
- * - `update:modelValue`: emitted with the selected value when it changes.
- */
-export type BaseRadioGroupEvents = {
-    (e: 'blur', event: FocusEvent): void;
-    (e: 'change', event: Event): void;
-    (e: 'click', event: MouseEvent): void;
-    (e: 'focus', event: FocusEvent): void;
-    (e: 'inactive'): void;
-    (e: 'input', event: Event): void;
-    (e: 'keydown', event: KeyboardEvent): void;
-    (e: 'mousedown', event: MouseEvent): void;
-    (e: 'mouseup', event: MouseEvent): void;
-    (e: 'update:modelValue', value: any): void;
-};
+import { BaseRadioGroupProps, BaseRadioGroupEvents, BaseRadioGroupSlots } from './types';
 declare const _default: <T = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
         readonly onInput?: ((event: Event) => any) | undefined;
-        readonly "onUpdate:modelValue"?: ((value: any) => any) | undefined;
-        readonly onKeydown?: ((event: KeyboardEvent) => any) | undefined;
         readonly onBlur?: ((event: FocusEvent) => any) | undefined;
         readonly onChange?: ((event: Event) => any) | undefined;
         readonly onClick?: ((event: MouseEvent) => any) | undefined;
         readonly onFocus?: ((event: FocusEvent) => any) | undefined;
+        readonly onKeydown?: ((event: KeyboardEvent) => any) | undefined;
         readonly onMousedown?: ((event: MouseEvent) => any) | undefined;
         readonly onMouseup?: ((event: MouseEvent) => any) | undefined;
+        readonly "onUpdate:modelValue"?: ((value: any) => any) | undefined;
         readonly onInactive?: (() => any) | undefined;
     } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onFocus" | "onBlur" | "onChange" | "onInput" | "onKeydown" | "onClick" | "onMousedown" | "onMouseup" | "onUpdate:modelValue" | "onInactive"> & BaseRadioGroupProps<T> & Partial<{}>> & import('vue').PublicProps;
     expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
     attrs: any;
-    slots: Readonly<{
-        /**
-         * Content rendered before the first option, inside the options container.
-         */
-        prepend?: (props: object) => any;
-        /**
-         * Content shown while options are loading (replaces the default loading text).
-         */
-        loading?: (props: object) => any;
-        /**
-         * Content shown when no options are available (replaces the default "no data" text).
-         */
-        'no-data'?: (props: object) => any;
-        /**
-         * Content rendered before each option's radio button.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param id - The `id` of this option's input, if set.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text for this option.
-         */
-        'option:prepend'?: (props: {
-            checked: boolean;
-            disabled: boolean;
-            id?: string;
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Replaces the default radio dot icon for each option. Receives all `BaseRadio`
-         * slot attributes plus the source item and its display text.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param focused - Whether this option's input currently has focus.
-         * @param focusVisible - Whether focus is keyboard-visible (`:focus-visible`).
-         * @param hasErrors - Whether the group is in an error state.
-         * @param id - The `id` of this option's input.
-         * @param name - The `name` of this option's input.
-         * @param parsedValue - The option value serialized for form submission.
-         * @param readonly - Whether this option is read-only.
-         * @param value - The current effective value for this option.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text resolved for this option.
-         */
-        icon?: (props: SlotAttributes & {
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Replaces the default label text for each option.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The resolved display text for this option.
-         * @param checked - Whether this option is currently selected.
-         */
-        label?: (props: {
-            item: T;
-            text: string;
-            checked: boolean;
-        }) => any;
-        /**
-         * Content rendered after each option's radio button and label.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param id - The `id` of this option's input, if set.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text for this option.
-         */
-        'option:append'?: (props: {
-            checked: boolean;
-            disabled: boolean;
-            id?: string;
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Content rendered after the last option, inside the options container.
-         */
-        append?: (props: object) => any;
-    }> & {
-        /**
-         * Content rendered before the first option, inside the options container.
-         */
-        prepend?: (props: object) => any;
-        /**
-         * Content shown while options are loading (replaces the default loading text).
-         */
-        loading?: (props: object) => any;
-        /**
-         * Content shown when no options are available (replaces the default "no data" text).
-         */
-        'no-data'?: (props: object) => any;
-        /**
-         * Content rendered before each option's radio button.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param id - The `id` of this option's input, if set.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text for this option.
-         */
-        'option:prepend'?: (props: {
-            checked: boolean;
-            disabled: boolean;
-            id?: string;
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Replaces the default radio dot icon for each option. Receives all `BaseRadio`
-         * slot attributes plus the source item and its display text.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param focused - Whether this option's input currently has focus.
-         * @param focusVisible - Whether focus is keyboard-visible (`:focus-visible`).
-         * @param hasErrors - Whether the group is in an error state.
-         * @param id - The `id` of this option's input.
-         * @param name - The `name` of this option's input.
-         * @param parsedValue - The option value serialized for form submission.
-         * @param readonly - Whether this option is read-only.
-         * @param value - The current effective value for this option.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text resolved for this option.
-         */
-        icon?: (props: SlotAttributes & {
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Replaces the default label text for each option.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The resolved display text for this option.
-         * @param checked - Whether this option is currently selected.
-         */
-        label?: (props: {
-            item: T;
-            text: string;
-            checked: boolean;
-        }) => any;
-        /**
-         * Content rendered after each option's radio button and label.
-         * @param checked - Whether this option is currently selected.
-         * @param disabled - Whether this option is disabled.
-         * @param id - The `id` of this option's input, if set.
-         * @param item - The raw item from the `items` prop.
-         * @param text - The display text for this option.
-         */
-        'option:append'?: (props: {
-            checked: boolean;
-            disabled: boolean;
-            id?: string;
-            item: T;
-            text: string;
-        }) => any;
-        /**
-         * Content rendered after the last option, inside the options container.
-         */
-        append?: (props: object) => any;
-    };
+    slots: Readonly<BaseRadioGroupSlots<T>> & BaseRadioGroupSlots<T>;
     emit: BaseRadioGroupEvents;
 }>) => import('vue').VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;