bitboss-ui 2.1.113 → 2.1.115

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

@@ -0,0 +1,206 @@
+import { HTMLAttributes, InputHTMLAttributes } from 'vue';
+import { IconType } from '../../types/Icon';
+/**
+ * Props for the low-level date-picker input that couples a segmented text field with a popover calendar.
+ * Accepts ISO strings (or `YYYY-MM-DD` when `floating` is true) and can operate in single or range mode.
+ * In both modes users type directly into segmented day / month / year inputs with auto-advance between them.
+ */
+export type BaseDatePickerInputProps = {
+    /**
+     * Controls whether manual typing is allowed inside the text fields.
+     * Use `'not-mobile'` to disable typing on mobile devices while keeping it on desktop.
+     * Applies to both single and range modes.
+     * @defaultValue `true`
+     */
+    allowWriting?: boolean | 'not-mobile';
+    /**
+     * Name of the icon to render at the right hand side of the input.
+     */
+    'append:icon'?: IconType;
+    /**
+     * Browser autocomplete hint for the input.
+     * @defaultValue `'off'`
+     */
+    autocomplete?: InputHTMLAttributes['autocomplete'];
+    /**
+     * Focus the first text field automatically when the component mounts.
+     */
+    autofocus?: InputHTMLAttributes['autofocus'];
+    /**
+     * Displays a clear button whenever a value is present and the control is interactive.
+     */
+    clearable?: boolean;
+    /**
+     * Applies the compact density styles to the control.
+     */
+    compact?: boolean;
+    /**
+     * Disables the input, calendar trigger, and popover.
+     */
+    disabled?: boolean;
+    /**
+     * Sets the first day of the week for the calendar (0 = Sunday, 6 = Saturday).
+     */
+    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /**
+     * Emit dates formatted as `YYYY-MM-DD` instead of ISO strings.
+     */
+    floating?: boolean;
+    /**
+     * Marks the control as invalid, applying error styles and setting `aria-invalid`.
+     */
+    hasErrors?: boolean;
+    /**
+     * Explicit id for the input element. Falls back to an auto-generated `bdpi-<uid>` value.
+     */
+    id?: HTMLAttributes['id'];
+    /**
+     * Shows loading visuals on the input.
+     */
+    loading?: boolean;
+    /**
+     * Maximum selectable date in `YYYY-MM-DD` format.
+     * Values outside the pattern throw during setup to surface configuration mistakes.
+     */
+    max?: string;
+    /**
+     * Minimum selectable date in `YYYY-MM-DD` format.
+     * Values outside the pattern throw during setup to surface configuration mistakes.
+     */
+    min?: string;
+    /**
+     * v-model value. Use `null` for empty, a single string for single selection,
+     * or a two-element string array (`[start, end]`) when `range` is true.
+     */
+    modelValue: string | string[] | null;
+    /**
+     * Name attribute forwarded to the native inputs. In single mode fields are named
+     * `${name}-day`, `${name}-month`, `${name}-year`; in range mode they are prefixed
+     * with the segment (`${name}-start-day`, `${name}-end-day`, …).
+     */
+    name?: InputHTMLAttributes['name'];
+    /**
+     * Placeholder text displayed when no value is present. Defaults to a format hint
+     * (`DD/MM/YYYY` or `DD/MM/YYYY – DD/MM/YYYY` for range mode).
+     */
+    placeholder?: InputHTMLAttributes['placeholder'];
+    /**
+     * Icon name rendered before the input field.
+     */
+    'prepend:icon'?: IconType;
+    /**
+     * Enables range selection. When active, v-model expects a two-element array `[start, end]`.
+     * Users can still type into the start and end segments as long as `allowWriting` is truthy.
+     */
+    range?: boolean;
+    /**
+     * Makes the text fields read-only and prevents opening the calendar.
+     */
+    readonly?: boolean;
+    /**
+     * Marks the inputs as required to the browser.
+     */
+    required?: boolean;
+    /**
+     * Predicate invoked for each candidate date. Return `false` to disable selection for that value.
+     */
+    selectable?: (date: string) => boolean;
+    /**
+     * Hides the calendar trigger button and prevents the calendar popover from opening.
+     * Use `'not-mobile'` to hide the popover on desktop while keeping it visible on mobile,
+     * complementing `allowWriting: 'not-mobile'` (desktop = keyboard-first, mobile = calendar-first).
+     * An error is thrown if both writing and the popover would be unavailable on the same platform.
+     */
+    hidePopover?: boolean | 'not-mobile';
+    /**
+     * Transition duration, in milliseconds, for the popover appearance.
+     */
+    transitionDuration?: number;
+};
+/**
+ * Structured payload carried by every `error` event.
+ *
+ * | `code`                 | Trigger                            | `original`                   | `normalized`                                          |
+ * |------------------------|------------------------------------|------------------------------|-------------------------------------------------------|
+ * | `disabled_date`        | Typed single date is disabled      | The disabled date            | Snapped to `min`/`max`, or `null` if not normalizable |
+ * | `disabled_range_start` | Typed range start is disabled      | `[start]` or `[start, end]`  | Snapped range, or `null` if start is not normalizable |
+ * | `disabled_range_end`   | Typed range end is disabled        | `[start, end]`               | Snapped range (length 1 or 2), or `null`              |
+ * | `end_before_start`     | Typed end is chronologically first | `[start, end]` (wrong order) | `[end, start]` — always the swapped pair              |
+ */
+export type DatePickerInputError = {
+    code: 'disabled_date';
+    /** The value the user typed before normalization. */
+    original: string;
+    /** Snapped to the nearest `min`/`max` boundary, or `null` if disabled by `selectable`. */
+    normalized: string | null;
+} | {
+    code: 'disabled_range_start';
+    /** The range value before normalization (may be `[start]` or `[start, end]`). */
+    original: string[];
+    /** Snapped range, or `null` if start could not be normalized. */
+    normalized: string[] | null;
+} | {
+    code: 'disabled_range_end';
+    /** The full range before normalization. */
+    original: [string, string];
+    /** Range with end snapped, or `[start]` if end could not be normalized. */
+    normalized: string[] | null;
+} | {
+    code: 'end_before_start';
+    /** `[start, end]` in the order the user typed them. */
+    original: [string, string];
+    /** `[end, start]` — the chronologically corrected pair. */
+    normalized: [string, string];
+};
+export type BaseDatePickerInputEvents = {
+    /**
+     * Emitted when the composite control receives focus (first focusin after being inactive).
+     */
+    (e: 'active'): void;
+    /**
+     * Emitted alongside every value normalization or removal when the typed date is invalid or out of range.
+     * See `DatePickerInputError` for the full code map and payload shapes.
+     */
+    (e: 'error', error: DatePickerInputError): void;
+    /**
+     * Emitted when a native text field inside the control gains focus.
+     * Forwards the original DOM `FocusEvent`.
+     */
+    (e: 'focus', event: FocusEvent): void;
+    /**
+     * Emitted when focus/click moves outside the entire composite control.
+     */
+    (e: 'inactive'): void;
+    /**
+     * Emitted whenever the selected date value changes.
+     * Payload is `null` for cleared values, a single string for single-date mode,
+     * or a two-element array for range mode.
+     */
+    (e: 'update:modelValue', value: BaseDatePickerInputProps['modelValue']): void;
+};
+export type BaseDatePickerInputSlots = {
+    /**
+     * Content rendered before the entire input control, outside the input chrome.
+     */
+    'prepend-outer'?: (props: object) => any;
+    /**
+     * Content rendered before the date fields, at the start of the inner container.
+     */
+    prepend?: (props: object) => any;
+    /**
+     * Inline content rendered at the start of the input field area, before the date fields.
+     */
+    prefix?: (props: object) => any;
+    /**
+     * Content rendered after the date fields, at the end of the inner container (before the calendar toggle button).
+     */
+    append?: (props: object) => any;
+    /**
+     * Content rendered after the entire input control, outside the input chrome.
+     */
+    'append-outer'?: (props: object) => any;
+    /**
+     * Inline content rendered at the end of the input field area, after the date fields.
+     */
+    suffix?: (props: object) => any;
+};

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

@@ -1,155 +1,5 @@
-import { Classes } from '../../types/Classes';
-import { CommonProps, Size } from '../../types/CommonProps';
-/**
- * Width presets (in pixels) used when the dialog `size` prop is set to one of the named breakpoints.
- */
-export type Sizes = {
-    lg: number;
-    md: number;
-    sm: number;
-};
-/**
- * Props controlling the BaseDialog appearance, accessibility, and closing behaviour.
- */
-export type BaseDialogProps = {
-    /**
-     * Accessible label for the close button. Defaults to the localized "close" string when omitted.
-     */
-    closeLabel?: CommonProps['closeLabel'];
-    /**
-     * Apply compact spacing to the dialog container.
-     */
-    compact?: CommonProps['compact'];
-    /**
-     * Short text describing the dialog contents. Provided text is linked to the dialog for screen readers.
-     */
-    description?: string;
-    /**
-     * Disable user interactions that would close the dialog (buttons remain disabled while true).
-     */
-    disabled?: CommonProps['disabled'];
-    /**
-     * Render dialog content immediately instead of waiting for the first open.
-     */
-    eager?: CommonProps['eager'];
-    /**
-     * CSS selector of the element to focus after opening. Defaults to the first tabbable element.
-     */
-    focusTarget?: string;
-    /**
-     * Display the dialog fullscreen. Use `'mobile'` to restrict fullscreen to small devices.
-     */
-    fullscreen?: boolean | 'mobile';
-    /**
-     * Hide the header of the dialog.
-     * Remember to restore accessibility by passing a new `aria-labelledby` attribute to the dialog.
-     */
-    hideHeader?: boolean;
-    /**
-     * Additional classes applied to the dialog overlay.
-     * @deprecated Pass a regular `class` attribute to the component instead.
-     * @default []
-     */
-    overlayClasses?: Classes;
-    /**
-     * Additional classes applied to the dialog panel.
-     * @deprecated Pass a regular `class` attribute to the component instead.
-     * @default []
-     */
-    panelClasses?: Classes;
-    /**
-     * Prevent closing via outside clicks or Escape key. Programmatic close is still allowed.
-     */
-    persistent?: CommonProps['persistent'];
-    /**
-     * Toggle visibility of the default close button in the header.
-     * @default true
-     */
-    showClose?: CommonProps['showClose'];
-    /**
-     * Controls the maximum width of the dialog. Accepts the named presets `'sm' | 'md' | 'lg'`,
-     * a custom CSS width string, or a numeric pixel value.
-     * @default 'sm'
-     */
-    size?: Size<Sizes>['size'];
-    /**
-     * Title text announced to assistive technologies and rendered by the default header slot.
-     */
-    title?: CommonProps['title'];
-    /**
-     * Duration, in milliseconds, of the open/close transition.
-     * @default 300
-     */
-    transitionDuration?: CommonProps['transitionDuration'];
-};
+import { BaseDialogProps, BaseDialogSlots } from './types';
 type __VLS_Props = BaseDialogProps;
-/**
- * Events emitted by `BaseDialog`.
- * - `show`: fired as soon as the user triggers the open action (model becomes true).
- * - `hide`: fired as soon as the user triggers the close action (model becomes false).
- * - `shown`: fired after the dialog is opened using `showModal`.
- * - `hidden`: fired after the close transition completes and the dialog is dismissed.
- */
-export type BaseDialogEvents = {
-    (e: 'show' | 'hide' | 'shown' | 'hidden'): void;
-};
-/**
- * Slots for customising the dialog chrome and layout.
- * - `header` receives `{ titleId, close, title }` to build a bespoke header while keeping accessibility wiring.
- * - `title` overrides only the rendered title text and remains linked through `aria-labelledby`.
- * - `close` replaces the default close button content.
- * - `description` renders custom descriptive content referenced by `aria-describedby`.
- * - Default slot renders the body content; `footer` renders controls below the body.
- */
-export type BaseDialogSlots = {
-    /**
-     * Replaces the default close icon rendered inside the header's close button.
-     */
-    close?: (props: object) => any;
-    /**
-     * Primary body content of the dialog, rendered in the scrollable body area.
-     * @param close - Programmatically closes the dialog.
-     * @param titleId - The `id` of the title element; useful for custom `aria-labelledby` wiring.
-     */
-    default?: (props: {
-        close: typeof close;
-        titleId: typeof titleId;
-    }) => any;
-    /**
-     * Replaces the default accessible description block. The provided content is linked to the dialog via `aria-describedby`.
-     * @param descriptionId - The `id` to assign to your custom description element for `aria-describedby` wiring.
-     * @param text - The `description` prop value.
-     */
-    description?: (props: {
-        descriptionId: typeof descriptionId;
-        text: BaseDialogProps['description'];
-    }) => any;
-    /**
-     * Content rendered in the dialog footer, below the body area. Typically used for action buttons.
-     */
-    footer?: (props: object) => any;
-    /**
-     * Replaces the entire dialog header section (title + close button). Maintains accessibility wiring via the provided props.
-     * @param titleId - The `id` to assign to your custom title element, wired to the dialog's `aria-labelledby`.
-     * @param close - Programmatically closes the dialog.
-     * @param title - The `title` prop value.
-     */
-    header?: (props: {
-        titleId: typeof titleId;
-        close: typeof close;
-        title: BaseDialogProps['title'];
-    }) => any;
-    /**
-     * Replaces the default title text inside the header. Remains linked to the dialog through `aria-labelledby`.
-     * @param text - The `title` prop value.
-     */
-    title?: (props: {
-        text: BaseDialogProps['title'];
-    }) => any;
-};
-declare const titleId: string;
-declare const descriptionId: string;
-declare const close: () => void;
 type __VLS_PublicProps = {
     modelValue?: boolean;
 } & __VLS_Props;
@@ -179,13 +29,13 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_PublicProps,
     onHidden?: (() => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
-    size: number | keyof Sizes | ({
-        size?: any;
-    } & string);
     showClose: boolean;
+    size: number | ({
+        size?: any;
+    } & string) | keyof import('./types').Sizes;
     transitionDuration: number;
-    overlayClasses: Classes;
-    panelClasses: Classes;
+    overlayClasses: import('../../types/Classes').Classes;
+    panelClasses: import('../../types/Classes').Classes;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dialog: HTMLDialogElement;
     header: HTMLDivElement;

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

@@ -0,0 +1,180 @@
+import { CommonProps, Size } from '../../types/CommonProps';
+import { Classes } from '../../types/Classes';
+/**
+ * Width presets (in pixels) used when the dialog `size` prop is set to one of the named breakpoints.
+ */
+export type Sizes = {
+    lg: number;
+    md: number;
+    sm: number;
+};
+/**
+ * Props controlling the BaseDialog appearance, accessibility, and closing behaviour.
+ */
+export type BaseDialogProps = {
+    /**
+     * Accessible label for the close button. Defaults to the localized "close" string when omitted.
+     */
+    closeLabel?: CommonProps['closeLabel'];
+    /**
+     * Apply compact spacing to the dialog container.
+     */
+    compact?: CommonProps['compact'];
+    /**
+     * Short text describing the dialog contents. Provided text is linked to the dialog for screen readers.
+     */
+    description?: string;
+    /**
+     * Disable user interactions that would close the dialog (buttons remain disabled while true).
+     */
+    disabled?: CommonProps['disabled'];
+    /**
+     * Render dialog content immediately instead of waiting for the first open.
+     */
+    eager?: CommonProps['eager'];
+    /**
+     * CSS selector of the element to focus after opening. Defaults to the first tabbable element.
+     */
+    focusTarget?: string;
+    /**
+     * Display the dialog fullscreen. Use `'mobile'` to restrict fullscreen to small devices.
+     */
+    fullscreen?: boolean | 'mobile';
+    /**
+     * Hide the header of the dialog.
+     * Remember to restore accessibility by passing a new `aria-labelledby` attribute to the dialog.
+     */
+    hideHeader?: boolean;
+    /**
+     * Additional classes applied to the dialog overlay.
+     * @deprecated Pass a regular `class` attribute to the component instead.
+     * @defaultValue `[]`
+     */
+    overlayClasses?: Classes;
+    /**
+     * Additional classes applied to the dialog panel.
+     * @deprecated Pass a regular `class` attribute to the component instead.
+     * @defaultValue `[]`
+     */
+    panelClasses?: Classes;
+    /**
+     * Prevent closing via outside clicks or Escape key. Programmatic close is still allowed.
+     */
+    persistent?: CommonProps['persistent'];
+    /**
+     * Toggle visibility of the default close button in the header.
+     * @defaultValue `true`
+     */
+    showClose?: CommonProps['showClose'];
+    /**
+     * Controls the maximum width of the dialog. Accepts the named presets `'sm' | 'md' | 'lg'`,
+     * a custom CSS width string, or a numeric pixel value.
+     * @defaultValue `'sm'`
+     */
+    size?: Size<Sizes>['size'];
+    /**
+     * Title text announced to assistive technologies and rendered by the default header slot.
+     */
+    title?: CommonProps['title'];
+    /**
+     * Duration, in milliseconds, of the open/close transition.
+     * @defaultValue `300`
+     */
+    transitionDuration?: CommonProps['transitionDuration'];
+};
+export type BaseDialogEvents = {
+    /**
+     * Emitted as soon as the dialog starts to open (model becomes true).
+     */
+    (e: 'show'): void;
+    /**
+     * Emitted as soon as the dialog starts to close (model becomes false).
+     */
+    (e: 'hide'): void;
+    /**
+     * Emitted after the dialog is fully opened via `showModal()`.
+     */
+    (e: 'shown'): void;
+    /**
+     * Emitted after the close transition completes and the dialog is fully dismissed.
+     */
+    (e: 'hidden'): void;
+};
+/**
+ * Props exposed by the `default` slot.
+ */
+export type BaseDialogDefaultSlotProps = {
+    /**
+     * Programmatically closes the dialog.
+     */
+    close: () => void;
+    /**
+     * The `id` of the title element; useful for custom `aria-labelledby` wiring.
+     */
+    titleId: string;
+};
+/**
+ * Props exposed by the `description` slot.
+ */
+export type BaseDialogDescriptionSlotProps = {
+    /**
+     * The `id` to assign to your custom description element for `aria-describedby` wiring.
+     */
+    descriptionId: string;
+    /**
+     * The `description` prop value.
+     */
+    text: BaseDialogProps['description'];
+};
+/**
+ * Props exposed by the `header` slot.
+ */
+export type BaseDialogHeaderSlotProps = {
+    /**
+     * The `id` to assign to your custom title element, wired to the dialog's `aria-labelledby`.
+     */
+    titleId: string;
+    /**
+     * Programmatically closes the dialog.
+     */
+    close: () => void;
+    /**
+     * The `title` prop value.
+     */
+    title: BaseDialogProps['title'];
+};
+/**
+ * Props exposed by the `title` slot.
+ */
+export type BaseDialogTitleSlotProps = {
+    /**
+     * The `title` prop value.
+     */
+    text: BaseDialogProps['title'];
+};
+export type BaseDialogSlots = {
+    /**
+     * Replaces the default close icon rendered inside the header's close button.
+     */
+    close?: (props: object) => any;
+    /**
+     * Primary body content of the dialog, rendered in the scrollable body area.
+     */
+    default?: (props: BaseDialogDefaultSlotProps) => any;
+    /**
+     * Replaces the default accessible description block. The provided content is linked to the dialog via `aria-describedby`.
+     */
+    description?: (props: BaseDialogDescriptionSlotProps) => any;
+    /**
+     * Content rendered in the dialog footer, below the body area. Typically used for action buttons.
+     */
+    footer?: (props: object) => any;
+    /**
+     * Replaces the entire dialog header section (title + close button). Maintains accessibility wiring via the provided props.
+     */
+    header?: (props: BaseDialogHeaderSlotProps) => any;
+    /**
+     * Replaces the default title text inside the header. Remains linked to the dialog through `aria-labelledby`.
+     */
+    title?: (props: BaseDialogTitleSlotProps) => any;
+};

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

@@ -1,110 +1,4 @@
-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.
-     * @default '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.
-     * @default '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.
-     * @default 'left'
-     */
-    labelPosition?: 'left' | 'center' | 'right';
-    /**
-     * Tag used for the label element. Defaults to `label`, but can be set to `legend` for grouped inputs.
-     * @default '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.
-     * @default 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.
-     * @default 'span'
-     */
-    tag?: string;
-};
-/**
- * Slots exposed by the input container.
- * - `input` provides `{ id, name, hasErrors, ariaDescribedby }` wiring information for the inner control.
- * - `label` allows custom label content while receiving the computed text and error state.
- */
-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.
-     * @param id - The resolved `id` for the input element; matches the `for` attribute on the label.
-     * @param name - The resolved `name` for the input, derived from the `label` prop when not set explicitly.
-     * @param hasErrors - Whether the container is in an error state (from `errors` or `hasErrors` props).
-     * @param ariaDescribedby - The `id` of the hint element when a `hint` is configured; pass as `aria-describedby` to the inner input.
-     */
-    input?: (props: {
-        id: string;
-        name: string;
-        hasErrors: boolean;
-        ariaDescribedby: string | undefined;
-    }) => any;
-    /**
-     * Replaces the default label text. The outer label element and its `for` association are always rendered.
-     * @param text - The `label` prop value.
-     * @param hasErrors - Whether the container is in an error state.
-     */
-    label?: (props: {
-        text: string;
-        hasErrors: boolean;
-    }) => any;
-};
+import { BaseInputContainerProps, BaseInputContainerSlots } from './types';
 declare function __VLS_template(): {
     attrs: Partial<{}>;
     slots: Readonly<BaseInputContainerSlots> & BaseInputContainerSlots;