bitboss-ui 2.1.113 → 2.1.115

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

@@ -0,0 +1,126 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+/**
+ * Wrapper responsible for aligning labels, inputs, hints, and error messages consistently across form controls.
+ */
+export type BaseInputContainerProps = {
+    /**
+     * Apply the compact density variant to the container.
+     */
+    compact?: boolean;
+    /**
+     * Controls label/input layout.
+     * Accepts `'vertical'`, `'horizontal'`, `'auto'`, or a custom pattern such as `"xx xxxxx"` to size columns by word length.
+     * @defaultValue `'vertical'`
+     */
+    direction?: 'horizontal' | 'vertical' | 'auto' | string;
+    /**
+     * Messages displayed beneath the input. Accepts a string or array; values are rendered one per line.
+     */
+    errors?: string | string[];
+    /**
+     * Forces the error state independently of `errors`, useful to pre-style the container.
+     */
+    hasErrors?: boolean;
+    /**
+     * Hide the visual label while keeping it available to assistive technology.
+     */
+    hideLabel?: boolean;
+    /**
+     * Hint text rendered below the input. When present, its id is exposed to the input slot via `ariaDescribedby`.
+     */
+    hint?: string;
+    /**
+     * Explicit id for the container and associated input. Falls back to an auto-generated id when omitted.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Horizontal alignment of the input column when direction is horizontal or custom.
+     * @defaultValue `'right'`
+     */
+    inputPosition?: 'left' | 'center' | 'right';
+    /**
+     * Visible label text for the field. Also used to derive a fallback name.
+     */
+    label: string;
+    /**
+     * Horizontal alignment for the label column.
+     * @defaultValue `'left'`
+     */
+    labelPosition?: 'left' | 'center' | 'right';
+    /**
+     * Label rendering mode.
+     */
+    labelMode?: 'outside' | 'floating' | 'inside';
+    /**
+     * Tag used for the label element. Defaults to `label`, but can be set to `legend` for grouped inputs.
+     * @defaultValue `'label'`
+     */
+    labelTag?: string;
+    /**
+     * Value forwarded for v-model support. Accepts any serializable value.
+     */
+    modelValue?: any;
+    /**
+     * Explicit name attribute forwarded to the input. When omitted, a slug derived from `label` is used.
+     */
+    name?: InputHTMLAttributes['name'];
+    /**
+     * Swap the label and input columns.
+     * @defaultValue `false`
+     */
+    reverse?: boolean;
+    /**
+     * Keep the hint permanently visible, regardless of focus.
+     */
+    showHint?: boolean;
+    /**
+     * Tag used for the outer wrapper. Defaults to `span` to remain inline.
+     * @defaultValue `'span'`
+     */
+    tag?: string;
+};
+/**
+ * Props exposed by the `input` slot.
+ */
+export type BaseInputContainerInputSlotProps = {
+    /**
+     * The resolved `id` for the input element; matches the `for` attribute on the label.
+     */
+    id: string;
+    /**
+     * The resolved `name` for the input, derived from the `label` prop when not set explicitly.
+     */
+    name: string;
+    /**
+     * Whether the container is in an error state (from `errors` or `hasErrors` props).
+     */
+    hasErrors: boolean;
+    /**
+     * The `id` of the hint element when a `hint` is configured; pass as `aria-describedby` to the inner input.
+     */
+    ariaDescribedby: string | undefined;
+};
+/**
+ * Props exposed by the `label` slot.
+ */
+export type BaseInputContainerLabelSlotProps = {
+    /**
+     * The `label` prop value.
+     */
+    text: string;
+    /**
+     * Whether the container is in an error state.
+     */
+    hasErrors: boolean;
+};
+export type BaseInputContainerSlots = {
+    /**
+     * The form control to render, positioned in the input column. Receives pre-computed
+     * wiring attributes so the inner input can be correctly associated with the label and hint.
+     */
+    input?: (props: BaseInputContainerInputSlotProps) => any;
+    /**
+     * Replaces the default label text. The outer label element and its `for` association are always rendered.
+     */
+    label?: (props: BaseInputContainerLabelSlotProps) => any;
+};

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

@@ -1,167 +1,4 @@
-import { HTMLAttributes, InputHTMLAttributes } from 'vue';
-import { IconType } from '../../types/Icon';
-/**
- * Props for the low-level number input with manual parsing, clamping, and increment/decrement helpers.
- */
-export type BaseNumberInputProps = {
-    /**
-     * Name of the icon to render at the right hand side of the input.
-     */
-    'append:icon'?: IconType;
-    /**
-     * Id(s) of descriptive elements announced by screen readers.
-     */
-    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
-    /**
-     * Browser autocomplete hint for the field.
-     * @default 'off'
-     */
-    autocomplete?: InputHTMLAttributes['autocomplete'];
-    /**
-     * Focus the input automatically after mount.
-     */
-    autofocus?: InputHTMLAttributes['autofocus'];
-    /**
-     * Show a clear button whenever a value is present and the control is interactive.
-     */
-    clearable?: boolean;
-    /**
-     * Apply the compact density variant.
-     */
-    compact?: boolean;
-    /**
-     * Disable manual input and the exposed increase/decrease helpers.
-     */
-    disabled?: boolean;
-    /**
-     * Force the error state; also toggles `aria-invalid`.
-     */
-    hasErrors?: boolean;
-    /**
-     * Explicit id forwarded to the native input.
-     */
-    id?: HTMLAttributes['id'];
-    /**
-     * Display the loading state styles.
-     */
-    loading?: boolean;
-    /**
-     * Upper bound for clamping user input and helper increments.
-     * @default Number.MAX_SAFE_INTEGER
-     */
-    max?: number;
-    /**
-     * Maximum number of decimal digits retained after processing.
-     * @default 8
-     */
-    maxPrecision?: number;
-    /**
-     * Lower bound for clamping user input and helper decrements.
-     * @default Number.MIN_SAFE_INTEGER
-     */
-    min?: number;
-    /**
-     * v-model value. Accepts numbers, numeric strings, or null when empty.
-     */
-    modelValue: number | string | null;
-    /**
-     * Name attribute forwarded to the native input.
-     */
-    name?: InputHTMLAttributes['name'];
-    /**
-     * Placeholder text when no value is present.
-     */
-    placeholder?: InputHTMLAttributes['placeholder'];
-    /**
-     * Name of the icon to render at the left hand side of the input.
-     */
-    'prepend:icon'?: IconType;
-    /**
-     * Make the input read-only while keeping its value visible.
-     */
-    readonly?: boolean;
-    /**
-     * Mark the input as required for form validation.
-     */
-    required?: boolean;
-    /**
-     * Increment used by the `increase`/`decrease` helpers. Manual typing is never forced to this step.
-     * @default 1
-     */
-    step?: number;
-};
-/**
- * Events emitted by `BaseNumberInput`.
- * - Native events (`blur`, `focus`, etc.) are forwarded from the input element.
- * - `increase` / `decrease` emit the clamped value produced by helper buttons.
- * - `update:modelValue` emits the parsed number or `null` after any change.
- */
-export type BaseNumberInputEvents = {
-    (e: 'blur', event: FocusEvent): void;
-    (e: 'change', event: Event): void;
-    (e: 'click', event: MouseEvent): void;
-    (e: 'decrease', value: number): void;
-    (e: 'focus', event: FocusEvent): void;
-    (e: 'increase', value: number): void;
-    (e: 'input', event: Event): void;
-    (e: 'keydown', event: KeyboardEvent): void;
-    (e: 'keyup', event: KeyboardEvent): void;
-    (e: 'mousedown', event: MouseEvent): void;
-    (e: 'mouseup', event: MouseEvent): void;
-    (e: 'update:modelValue', value: number | null): void;
-};
-/**
- * Slots for decorating the input. Helpers `{ increase, decrease }` are provided where relevant.
- */
-export type BaseNumberInputSlots = {
-    /**
-     * Inline content rendered at the start of the input field area, before the typed number.
-     */
-    prefix?: (props: object) => any;
-    /**
-     * Content rendered after the number input, at the end of the inner container.
-     * Typically used to place increment/decrement buttons next to the input.
-     * @param increase - Increments the value by one `step`.
-     * @param decrease - Decrements the value by one `step`.
-     */
-    append?: (props: {
-        increase: typeof increase;
-        decrease: typeof decrease;
-    }) => any;
-    /**
-     * Content rendered after the entire input control, outside the input chrome.
-     * @param increase - Increments the value by one `step`.
-     * @param decrease - Decrements the value by one `step`.
-     */
-    'append-outer'?: (props: {
-        increase: typeof increase;
-        decrease: typeof decrease;
-    }) => any;
-    /**
-     * Content rendered before the number input, at the start of the inner container.
-     * @param increase - Increments the value by one `step`.
-     * @param decrease - Decrements the value by one `step`.
-     */
-    prepend?: (props: {
-        increase: typeof increase;
-        decrease: typeof decrease;
-    }) => any;
-    /**
-     * Content rendered before the entire input control, outside the input chrome.
-     * @param increase - Increments the value by one `step`.
-     * @param decrease - Decrements the value by one `step`.
-     */
-    'prepend-outer'?: (props: {
-        increase: typeof increase;
-        decrease: typeof decrease;
-    }) => any;
-    /**
-     * Inline content rendered at the end of the input field area, after the typed number.
-     */
-    suffix?: (props: object) => any;
-};
-declare const decrease: () => void;
-declare const increase: () => void;
+import { BaseNumberInputProps, BaseNumberInputSlots } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<BaseNumberInputSlots> & BaseNumberInputSlots;
@@ -176,28 +13,28 @@ declare const __VLS_component: import('vue').DefineComponent<BaseNumberInputProp
     decrease: () => void;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     input: (event: Event) => any;
-    "update:modelValue": (value: number | null) => any;
-    keydown: (event: KeyboardEvent) => any;
     blur: (event: FocusEvent) => any;
     change: (event: Event) => any;
     click: (event: MouseEvent) => any;
     focus: (event: FocusEvent) => any;
-    keyup: (event: KeyboardEvent) => any;
+    keydown: (event: KeyboardEvent) => any;
     mousedown: (event: MouseEvent) => any;
     mouseup: (event: MouseEvent) => any;
+    "update:modelValue": (value: number | null) => any;
+    keyup: (event: KeyboardEvent) => any;
     decrease: (value: number) => any;
     increase: (value: number) => any;
 }, string, import('vue').PublicProps, Readonly<BaseNumberInputProps> & Readonly<{
     onInput?: ((event: Event) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
-    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onChange?: ((event: Event) => any) | undefined;
     onClick?: ((event: MouseEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
-    onKeyup?: ((event: KeyboardEvent) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onMousedown?: ((event: MouseEvent) => any) | undefined;
     onMouseup?: ((event: MouseEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
+    onKeyup?: ((event: KeyboardEvent) => any) | undefined;
     onDecrease?: ((value: number) => any) | undefined;
     onIncrease?: ((value: number) => any) | undefined;
 }>, {

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

@@ -0,0 +1,191 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+import { IconType } from '../../types/Icon';
+/**
+ * Props for the low-level number input with manual parsing, clamping, and increment/decrement helpers.
+ */
+export type BaseNumberInputProps = {
+    /**
+     * Name of the icon to render at the right hand side of the input.
+     */
+    'append:icon'?: IconType;
+    /**
+     * Id(s) of descriptive elements announced by screen readers.
+     */
+    ariaDescribedby?: InputHTMLAttributes['aria-describedby'];
+    /**
+     * Browser autocomplete hint for the field.
+     * @defaultValue `'off'`
+     */
+    autocomplete?: InputHTMLAttributes['autocomplete'];
+    /**
+     * Focus the input automatically after mount.
+     */
+    autofocus?: InputHTMLAttributes['autofocus'];
+    /**
+     * Show a clear button whenever a value is present and the control is interactive.
+     */
+    clearable?: boolean;
+    /**
+     * Apply the compact density variant.
+     */
+    compact?: boolean;
+    /**
+     * Disable manual input and the exposed increase/decrease helpers.
+     */
+    disabled?: boolean;
+    /**
+     * Force the error state; also toggles `aria-invalid`.
+     */
+    hasErrors?: boolean;
+    /**
+     * Explicit id forwarded to the native input.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Display the loading state styles.
+     */
+    loading?: boolean;
+    /**
+     * Upper bound for clamping user input and helper increments.
+     * @defaultValue `Number.MAX_SAFE_INTEGER`
+     */
+    max?: number;
+    /**
+     * Maximum number of decimal digits retained after processing.
+     * @defaultValue `8`
+     */
+    maxPrecision?: number;
+    /**
+     * Lower bound for clamping user input and helper decrements.
+     * @defaultValue `Number.MIN_SAFE_INTEGER`
+     */
+    min?: number;
+    /**
+     * v-model value. Accepts numbers, numeric strings, or null when empty.
+     */
+    modelValue: number | string | null;
+    /**
+     * Name attribute forwarded to the native input.
+     */
+    name?: InputHTMLAttributes['name'];
+    /**
+     * Placeholder text when no value is present.
+     */
+    placeholder?: InputHTMLAttributes['placeholder'];
+    /**
+     * Name of the icon to render at the left hand side of the input.
+     */
+    'prepend:icon'?: IconType;
+    /**
+     * Make the input read-only while keeping its value visible.
+     */
+    readonly?: boolean;
+    /**
+     * Mark the input as required for form validation.
+     */
+    required?: boolean;
+    /**
+     * Increment used by the `increase`/`decrease` helpers. Manual typing is never forced to this step.
+     * @defaultValue `1`
+     */
+    step?: number;
+};
+export type BaseNumberInputEvents = {
+    /**
+     * Emitted when the native input loses focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'blur', event: FocusEvent): void;
+    /**
+     * Emitted when the native input fires a change event.
+     * 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 by the `decrease` helper with the clamped value after decrementing by one `step`.
+     */
+    (e: 'decrease', value: number): void;
+    /**
+     * Emitted when the native input gains focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'focus', event: FocusEvent): void;
+    /**
+     * Emitted by the `increase` helper with the clamped value after incrementing by one `step`.
+     */
+    (e: 'increase', value: number): void;
+    /**
+     * Emitted on native input events from the number 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 key is released over the input.
+     * Forwards the original DOM `KeyboardEvent`.
+     */
+    (e: 'keyup', 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 on any value change with the parsed number or `null` when the field is empty.
+     */
+    (e: 'update:modelValue', value: number | null): void;
+};
+/**
+ * Props exposed by the step control slots (`append`, `append-outer`, `prepend`, `prepend-outer`).
+ */
+export type BaseNumberInputStepSlotProps = {
+    /**
+     * Increments the value by one `step`.
+     */
+    increase: () => void;
+    /**
+     * Decrements the value by one `step`.
+     */
+    decrease: () => void;
+};
+export type BaseNumberInputSlots = {
+    /**
+     * Inline content rendered at the start of the input field area, before the typed number.
+     */
+    prefix?: (props: object) => any;
+    /**
+     * Content rendered after the number input, at the end of the inner container.
+     * Typically used to place increment/decrement buttons next to the input.
+     */
+    append?: (props: BaseNumberInputStepSlotProps) => any;
+    /**
+     * Content rendered after the entire input control, outside the input chrome.
+     */
+    'append-outer'?: (props: BaseNumberInputStepSlotProps) => any;
+    /**
+     * Content rendered before the number input, at the start of the inner container.
+     */
+    prepend?: (props: BaseNumberInputStepSlotProps) => any;
+    /**
+     * Content rendered before the entire input control, outside the input chrome.
+     */
+    'prepend-outer'?: (props: BaseNumberInputStepSlotProps) => any;
+    /**
+     * Inline content rendered at the end of the input field area, after the typed number.
+     */
+    suffix?: (props: object) => any;
+};

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

@@ -1,144 +1,31 @@
-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;
-};
-/**
- * Events emitted by `BaseRadio`.
- * Forwards native interaction events and emits `update:modelValue` with the radio value when selected.
- */
-export type BaseRadioEvents = {
-    (e: 'blur', event: FocusEvent): void;
-    (e: 'change', event: Event): void;
-    (e: 'click', event: MouseEvent): void;
-    (e: 'focus', event: FocusEvent): 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;
-};
-/**
- * Parameters exposed to the `icon` slot for custom visualisations.
- */
-export type SlotAttributes = {
-    checked: boolean;
-    disabled: Exclude<BaseRadioProps['disabled'], undefined>;
-    focused: boolean;
-    focusVisible: boolean;
-    hasErrors: Exclude<BaseRadioProps['hasErrors'], undefined>;
-    id: BaseRadioProps['id'];
-    name: BaseRadioProps['name'];
-    parsedValue: string;
-    readonly: BaseRadioProps['readonly'];
-    value: any;
-};
+import { BaseRadioProps, BaseRadioSlots } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
-    slots: Readonly<{
-        /**
-         * 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: SlotAttributes) => any;
-    }> & {
-        /**
-         * 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: SlotAttributes) => any;
-    };
+    slots: Readonly<BaseRadioSlots> & BaseRadioSlots;
     refs: {};
     rootEl: HTMLSpanElement;
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<BaseRadioProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     input: (event: Event) => any;
-    "update:modelValue": (value: any) => any;
-    keydown: (event: KeyboardEvent) => any;
     blur: (event: FocusEvent) => any;
     change: (event: Event) => any;
     click: (event: MouseEvent) => any;
     focus: (event: FocusEvent) => any;
+    keydown: (event: KeyboardEvent) => any;
     mousedown: (event: MouseEvent) => any;
     mouseup: (event: MouseEvent) => any;
+    "update:modelValue": (value: any) => any;
 }, string, import('vue').PublicProps, Readonly<BaseRadioProps> & Readonly<{
     onInput?: ((event: Event) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
-    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onChange?: ((event: Event) => any) | undefined;
     onClick?: ((event: MouseEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onMousedown?: ((event: MouseEvent) => any) | undefined;
     onMouseup?: ((event: MouseEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;