bitboss-ui 2.1.105 → 2.1.106

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

@@ -1,13 +1,15 @@
 import { HTMLAttributes, InputHTMLAttributes } from 'vue';
 import { IconType } from '../../types/Icon';
 /**
- * Props for the low-level date-picker input that couples a masked text field with a popover calendar.
+ * 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 field.
+     * 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.
      * @default true
      */
     allowWriting?: boolean | 'not-mobile';
@@ -21,7 +23,7 @@ export type BaseDatePickerInputProps = {
      */
     autocomplete?: InputHTMLAttributes['autocomplete'];
     /**
-     * Focus the text field automatically when the component mounts.
+     * Focus the first text field automatically when the component mounts.
      */
     autofocus?: InputHTMLAttributes['autofocus'];
     /**
@@ -72,11 +74,14 @@ export type BaseDatePickerInputProps = {
      */
     modelValue: string | string[] | null;
     /**
-     * Name attribute forwarded to the native input.
+     * 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.
+     * 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'];
     /**
@@ -84,36 +89,79 @@ export type BaseDatePickerInputProps = {
      */
     'prepend:icon'?: IconType;
     /**
-     * Enables range selection. When active, v-model expects a two-element array and typing is disabled.
+     * 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 field read-only and prevents opening the calendar.
+     * Makes the text fields read-only and prevents opening the calendar.
      */
     readonly?: boolean;
     /**
-     * Marks the input as required to the browser.
+     * 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];
+};
 /**
  * Events emitted by `BaseDatePickerInput`.
  * - `active` / `inactive`: fired when focus enters or leaves the composite control.
- * - `error`: emitted with an error code (e.g. `invalid_date_typed`) when manual input is rejected.
+ * - `error`: emitted alongside every normalization or removal — see `DatePickerInputError` for the full code map.
  * - `focus`: forwarded from the native input focus event.
  * - `update:modelValue`: emitted whenever the selected value changes.
  */
 export type BaseDatePickerInputEvents = {
     (e: 'active'): void;
-    (e: 'error', message: string): void;
+    (e: 'error', error: DatePickerInputError): void;
     (e: 'focus', event: FocusEvent): void;
     (e: 'inactive'): void;
     (e: 'update:modelValue', value: BaseDatePickerInputProps['modelValue']): void;
@@ -242,7 +290,6 @@ declare function __VLS_template(): {
                 suffix?(_: {}): any;
             };
         }) | null;
-        input: HTMLInputElement;
         calendar: HTMLDivElement;
         baseDatePicker: ({
             $: import('vue').ComponentInternalInstance;
@@ -319,13 +366,13 @@ declare function __VLS_template(): {
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInputProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:modelValue": (value: string | string[] | null) => any;
-    error: (message: string) => any;
+    error: (error: DatePickerInputError) => any;
     focus: (event: FocusEvent) => any;
     inactive: () => any;
     active: () => any;
 }, string, import('vue').PublicProps, Readonly<BaseDatePickerInputProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | string[] | null) => any) | undefined;
-    onError?: ((message: string) => any) | undefined;
+    onError?: ((error: DatePickerInputError) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
     onInactive?: (() => any) | undefined;
     onActive?: (() => any) | undefined;
@@ -439,7 +486,6 @@ declare const __VLS_component: import('vue').DefineComponent<BaseDatePickerInput
             suffix?(_: {}): any;
         };
     }) | null;
-    input: HTMLInputElement;
     calendar: HTMLDivElement;
     baseDatePicker: ({
         $: import('vue').ComponentInternalInstance;

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

@@ -1,6 +1,7 @@
-import { BaseDatePickerInputEvents } from '../BaseDatePickerInput/BaseDatePickerInput.vue';
+import { BaseDatePickerInputEvents, DatePickerInputError } from '../BaseDatePickerInput/BaseDatePickerInput.vue';
 import { HTMLAttributes, InputHTMLAttributes } from 'vue';
 import { IconType } from '../../types/Icon';
+export type { DatePickerInputError };
 export type BbDatePickerInputProps = {
     /**
      * Allows typing into the input.
@@ -51,6 +52,12 @@ export type BbDatePickerInputProps = {
      * It usually attaches a CSS class for styling purposes.
      */
     hasErrors?: boolean;
+    /**
+     * Hides the calendar trigger button and prevents the popover from opening.
+     * Use `'not-mobile'` to hide on desktop and keep visible on mobile,
+     * complementing `allowWriting: 'not-mobile'` for platform-specific interaction modes.
+     */
+    hidePopover?: boolean | 'not-mobile';
     /**
      * Visually hides the label of the input while maintaining accessibility.
      */
@@ -163,13 +170,13 @@ declare function __VLS_template(): {
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<BbDatePickerInputProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:modelValue": (value: string | string[] | null) => any;
-    error: (message: string) => any;
+    error: (error: DatePickerInputError) => any;
     focus: (event: FocusEvent) => any;
     inactive: () => any;
     active: () => any;
 }, string, import('vue').PublicProps, Readonly<BbDatePickerInputProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | string[] | null) => any) | undefined;
-    onError?: ((message: string) => any) | undefined;
+    onError?: ((error: DatePickerInputError) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
     onInactive?: (() => any) | undefined;
     onActive?: (() => any) | undefined;