@vialiq/web-components 0.20.0 → 0.21.0

package/README.md

@@ -728,6 +728,132 @@ The [ViModal](./src/modal/vi-modal.ts) is a focus-trapping dialog that dynamical
 
 ---
 
+### Date Picker ([vi-date-picker](./src/date-picker/vi-date-picker.ts))
+
+The [ViDatePicker](./src/date-picker/vi-date-picker.ts) is a powerful form-associated calendar control built on top of Flatpickr. It fully handles Shadow DOM retargeting, multiple calendar modes, custom locales, and complex date-range selections.
+
+#### Properties & Attributes
+
+| Attribute          | Property          | Type                            | Default     | Description                                      |
+| :----------------- | :---------------- | :------------------------------ | :---------- | :----------------------------------------------- |
+| `mode`             | `mode`            | `'date'\|'range'\|'month'\|'month-year'\|'year'\|'week'` | `'date'` | Determines the calendar view and selection behavior. |
+| `value`            | `value`           | `string`                        | `''`        | Controlled input value (must be an ISO 8601 string). |
+| `flat`             | `flat`            | `boolean`                       | `false`     | Renders the calendar inline instead of within a popup. |
+| `hoist`            | `hoist`           | `boolean`                       | `false`     | Uses a fixed positioning strategy to escape clipping containers. |
+| `min`              | `min`             | `string`                        | `''`        | Minimum selectable date (ISO string).            |
+| `max`              | `max`             | `string`                        | `''`        | Maximum selectable date (ISO string).            |
+| `locale`           | `locale`          | `string`                        | `'en'`      | BCP 47 locale tag (e.g., `'de-DE'`, `'fr-FR'`).  |
+| `week-numbers`     | `weekNumbers`     | `boolean`                       | `false`     | Shows ISO week numbers on the left of the calendar. |
+| `disabled`         | `disabled`        | `boolean`                       | `false`     | Disables interactions.                           |
+| `required`         | `required`        | `boolean`                       | `false`     | Marks field validation as mandatory.             |
+| `status`           | `status`          | `'default'\|'valid'\|'invalid'` | `'default'` | Controls validation visual presentation.         |
+| `validity-message` | `validityMessage` | `string`                        | `''`        | Validation error message to display in UI.       |
+
+#### Child Components (\`<vi-date-picker-input>\`)
+
+The `<vi-date-picker>` acts as a wrapper container. The actual interactive input fields must be provided as children using `<vi-date-picker-input>`:
+- **`kind`**: `'single' | 'from' | 'to'`. Use `'from'` and `'to'` when `mode="range"`.
+- **`label`**: Optional label string displayed above the input.
+- **`placeholder`**: The placeholder text when no date is selected.
+
+#### Events
+
+- `vialiq-change`: Fires when a date is selected or changed. Detail: `{ value: string, isoValue: string, formattedValue: string, rawValue: DateComponents, type: string, ... }`.
+
+#### CSS Custom Properties
+
+Exposes variables for custom theme styling (these cascade down to the hoisted calendar container as well):
+
+```css
+vi-date-picker {
+  /* Controls the size of the individual day cell grid */
+  --vi-date-picker-day-size: 32px;
+  
+  /* Popup calendar base styling */
+  --vi-date-picker-calendar-bg: var(--vi-color-layer-01);
+  --vi-date-picker-calendar-shadow: var(--vi-shadow-lg);
+
+  /* Day states (hover, selected, today) */
+  --vi-date-picker-day-hover-bg: var(--vi-color-layer-hover-01);
+  --vi-date-picker-day-selected-bg: var(--vi-color-primary);
+  --vi-date-picker-day-selected-color: var(--vi-color-text-primary-inverse);
+  --vi-date-picker-day-today-border: var(--vi-color-primary);
+}
+```
+
+#### Snippets
+
+**Basic Date Selection:**
+```html
+<vi-date-picker name="birthday">
+  <vi-date-picker-input label="Birthday" placeholder="YYYY-MM-DD"></vi-date-picker-input>
+</vi-date-picker>
+```
+
+**Range Selection (Start & End Inputs):**
+When using `mode="range"`, provide two input children marked with `kind="from"` and `kind="to"`.
+
+```html
+<vi-date-picker mode="range" name="vacation">
+  <vi-date-picker-input kind="from" label="Start Date" placeholder="Select Start"></vi-date-picker-input>
+  <vi-date-picker-input kind="to" label="End Date" placeholder="Select End"></vi-date-picker-input>
+</vi-date-picker>
+```
+
+**Month, Year, and Week Selection:**
+```html
+<!-- Month and Year -->
+<vi-date-picker mode="month-year" name="expiry">
+  <vi-date-picker-input label="Card Expiry" placeholder="YYYY-MM"></vi-date-picker-input>
+</vi-date-picker>
+
+<!-- ISO Week -->
+<vi-date-picker mode="week" name="sprint">
+  <vi-date-picker-input label="Sprint Week" placeholder="YYYY-Www"></vi-date-picker-input>
+</vi-date-picker>
+```
+
+**Flat Inline Calendar:**
+```html
+<vi-date-picker flat mode="date" value="2025-01-01">
+  <!-- No inputs needed when flat=true, the calendar renders inline -->
+</vi-date-picker>
+```
+
+**Hoisted Calendar (For escaping `overflow: hidden` containers):**
+By setting the `hoist` attribute, the date picker popup will use `position: fixed` to ensure it breaks out of any restrictive parent containers.
+
+```html
+<div style="overflow: hidden; height: 100px; padding: 20px;">
+  <vi-date-picker hoist name="appointment">
+    <vi-date-picker-input label="Book Appointment" placeholder="Select a date..."></vi-date-picker-input>
+  </vi-date-picker>
+</div>
+```
+
+**Programmatic Value Updates:**
+The `value` property can be set directly via JavaScript. The value should always be an **ISO 8601 string**, regardless of the configured locale or display mode.
+
+```html
+<vi-date-picker id="start-date" mode="date"></vi-date-picker>
+
+<script>
+  const picker = document.getElementById('start-date');
+  
+  // Update value programmatically
+  picker.value = '2026-10-12';
+  
+  // Format guide by mode:
+  // - date: 'YYYY-MM-DD'
+  // - month / month-year: 'YYYY-MM'
+  // - year: 'YYYY'
+  // - week: 'YYYY-Www'
+  // - range: 'YYYY-MM-DD to YYYY-MM-DD'
+</script>
+```
+
+---
+
 ## Form Validation & ElementInternals
 
 Custom controls inside this library utilize the native browser [ValidityMixin](./src/base/validity-mixin.ts) to integrate with standard `<form>` features like `.elements`, `.checkValidity()`, and `.reportValidity()`.

package/base/controllers/floating-controller.d.ts

@@ -23,8 +23,8 @@ export interface FloatingControllerOptions {
     hoist?: () => boolean;
     /** Element or selector string to constrain flipping. */
     boundary?: () => HTMLElement | string | null;
-    /** Whether the floating element should be forced to match the reference element's width. */
-    matchWidth?: boolean | (() => boolean);
+    /** Whether the floating element should be forced to match the reference element's width. Pass 'none' to skip width modifications entirely. */
+    matchWidth?: boolean | 'none' | (() => boolean | 'none');
 }
 /**
  * FloatingController

package/base/controllers/floating-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floating-controller.d.ts","sourceRoot":"","sources":["../../../../../libs/web-components/src/base/controllers/floating-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AACjE,OAAO,EAAmD,KAAK,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAGpH;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC;IAC5B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB;IAKzD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,cAAc,CAAuB;gBAGnC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB;IAK5C,gBAAgB;IAIhB;;;;;OAKG;IACH,KAAK;IAyBL;;;;;OAKG;IACH,IAAI;IAgBJ;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA0DtC"}
+{"version":3,"file":"floating-controller.d.ts","sourceRoot":"","sources":["../../../../../libs/web-components/src/base/controllers/floating-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AACjE,OAAO,EAML,KAAK,SAAS,EAEf,MAAM,kBAAkB,CAAC;AAG1B;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,qEAAqE;IACrE,SAAS,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACpC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACnC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,SAAS,CAAC;IAC5B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7C,8IAA8I;IAC9I,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC;CAC1D;AAED;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,YAAW,kBAAkB;IAKzD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,cAAc,CAAuB;gBAGnC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,yBAAyB;IAK5C,gBAAgB;IAIhB;;;;;OAKG;IACH,KAAK;IAsBL;;;;;OAKG;IACH,IAAI;IAgBJ;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CA0EtC"}

package/base/flatpickr-mixin.d.ts

@@ -0,0 +1,38 @@
+import { LitElement } from 'lit';
+import { Instance } from 'flatpickr/dist/types/instance';
+import { Options } from 'flatpickr/dist/types/options';
+import { DatePickerMode, DatePickerPluginInput } from '../date-picker/types.js';
+type Constructor<T = object> = new (...args: any[]) => T;
+/**
+ * Type-only declaration of the members FlatpickrMixin adds to a class.
+ * `declare class` emits no runtime code — it is a TS-only contract.
+ */
+export declare class FlatpickrMixinInterface {
+    /** The live flatpickr instance, or null if not yet initialised. */
+    protected _fp: Instance | null;
+    /** Consumer-provided additional plugins. */
+    plugins: DatePickerPluginInput[];
+    /** Returns the hidden <input> element flatpickr should bind to. Override in subclass. */
+    protected _getHiddenInput(): HTMLInputElement | null;
+    /**
+     * Initialises flatpickr. Loads locale, mode plugin, and the flatpickr module
+     * in parallel, then mounts it on the hidden input.
+     */
+    protected _initFlatpickr(config: Partial<Options>, mode?: DatePickerMode, resolvedLocale?: string): Promise<void>;
+    /** Destroys the current flatpickr instance cleanly. */
+    protected _destroyFlatpickr(): void;
+}
+/**
+ * FlatpickrMixin — abstract base mixin that manages a flatpickr lifecycle.
+ *
+ * Usage:
+ *   class MyPicker extends FlatpickrMixin(ViElement) { ... }
+ *
+ * The subclass must:
+ *  1. Call `_initFlatpickr(config, mode, resolvedLocale)` in `firstUpdated()`.
+ *  2. Override `_getHiddenInput()` to return the `<input type="hidden">` element
+ *     flatpickr should attach to.
+ */
+export declare function FlatpickrMixin<T extends Constructor<LitElement>>(Base: T): Constructor<FlatpickrMixinInterface> & T;
+export {};
+//# sourceMappingURL=flatpickr-mixin.d.ts.map

package/base/flatpickr-mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatpickr-mixin.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/base/flatpickr-mixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEjC,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAOjC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAC1C,mEAAmE;IACnE,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE/B,4CAA4C;IAC5C,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAEjC,yFAAyF;IACzF,SAAS,CAAC,eAAe,IAAI,gBAAgB,GAAG,IAAI;IAEpD;;;OAGG;IACH,SAAS,CAAC,cAAc,CACtB,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,IAAI,CAAC,EAAE,cAAc,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAEhB,uDAAuD;IACvD,SAAS,CAAC,iBAAiB,IAAI,IAAI;CACpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,GAyF9B,WAAW,CAAC,uBAAuB,CAAC,GAC3E,CAAC,CACJ"}

package/base/validity-mixin.d.ts

@@ -52,6 +52,8 @@ export declare class ValidityInterface<V = DefaultValueType> {
      * Subclasses MUST override this to provide component-specific validation logic.
      */
     protected _testValidity(): Partial<ValidityStateFlags>;
+    /** Internal validity sync — updates `_internals.setValidity()` without changing visual `status` or dispatching events. */
+    _syncValidity(): void;
     /**
      * Returns the element that the browser validation popup should point at.
      * Override in subclasses that wrap a native control (input, textarea, etc.).

package/base/validity-mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validity-mixin.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/base/validity-mixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,KAAK,CAAC;AAItD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB,CAAC,CAAC,GAAG,gBAAgB;IACzD,oFAAoF;IACpF,IAAI,MAAM,IAAI,aAAa,CAAC;IAC5B,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE;IAEjC,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,OAAO,CAAC;IACxB,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE;IAE7B,2EAA2E;IAC3E,IAAI,eAAe,IAAI,MAAM,CAAC;IAC9B,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE;IAEnC,6EAA6E;IAC7E,IAAI,KAAK,IAAI,CAAC,CAAC;IACf,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE;IAEhB,sDAAsD;IACtD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEhD,4FAA4F;IAC5F,aAAa,IAAI,OAAO;IAExB,iGAAiG;IACjG,cAAc,IAAI,OAAO;IAEzB,mDAAmD;IACnD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAExC,8DAA8D;IAC9D,IAAI,QAAQ,IAAI,aAAa,CAAC;IAE9B,oEAAoE;IACpE,IAAI,iBAAiB,IAAI,MAAM,CAAC;IAEhC;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAEtD;;;OAGG;IACH,SAAS,CAAC,oBAAoB,IAAI,WAAW,GAAG,SAAS;IAEzD,mFAAmF;IACnF,iBAAiB,IAAI,IAAI;IAEzB,sEAAsE;IACtE,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAE7C,uEAAuE;IACvE,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CACvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,CAAC,GAAG,gBAAgB,EACpB,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,EAE3D,IAAI,EAAE,CAAC,GACN,CAAC,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAqPvC"}
+{"version":3,"file":"validity-mixin.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/base/validity-mixin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,KAAK,CAAC;AAItD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,EAAE,GACR,MAAM,GACN,OAAO,GACP,IAAI,GACJ,QAAQ,GACR,OAAO,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB,CAAC,CAAC,GAAG,gBAAgB;IACzD,oFAAoF;IACpF,IAAI,MAAM,IAAI,aAAa,CAAC;IAC5B,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE;IAEjC,0EAA0E;IAC1E,IAAI,QAAQ,IAAI,OAAO,CAAC;IACxB,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE;IAE7B,2EAA2E;IAC3E,IAAI,eAAe,IAAI,MAAM,CAAC;IAC9B,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE;IAEnC,6EAA6E;IAC7E,IAAI,KAAK,IAAI,CAAC,CAAC;IACf,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE;IAEhB,sDAAsD;IACtD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEhD,4FAA4F;IAC5F,aAAa,IAAI,OAAO;IAExB,iGAAiG;IACjG,cAAc,IAAI,OAAO;IAEzB,mDAAmD;IACnD,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAExC,8DAA8D;IAC9D,IAAI,QAAQ,IAAI,aAAa,CAAC;IAE9B,oEAAoE;IACpE,IAAI,iBAAiB,IAAI,MAAM,CAAC;IAEhC;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAEtD,0HAA0H;IACnH,aAAa,IAAI,IAAI;IAE5B;;;OAGG;IACH,SAAS,CAAC,oBAAoB,IAAI,WAAW,GAAG,SAAS;IAEzD,mFAAmF;IACnF,iBAAiB,IAAI,IAAI;IAEzB,sEAAsE;IACtE,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAE7C,uEAAuE;IACvE,wBAAwB,CACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtC,MAAM,EAAE,MAAM,GACb,IAAI;CACR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,CAAC,GAAG,gBAAgB,EACpB,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,EAC3D,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CA+PhD"}

package/date-picker/i18n.d.ts

@@ -0,0 +1,19 @@
+import { SegmentOrder, DatePickerMode } from './types.js';
+/** Resolves the effective BCP 47 locale tag. */
+export declare function resolveLocale(localeAttr: string | null): string;
+/** Reads the browser's IANA time zone from Intl. */
+export declare function resolveTimeZone(): string;
+/**
+ * Returns the localized word for "Today" (e.g. "today", "hoy", "aujourd'hui")
+ * capitalized properly using native Intl formatting.
+ */
+export declare function getTodayLabel(locale: string): string;
+/**
+ * Derives the segment order from the locale using the browser's Intl API,
+ * or from an explicit format string.
+ * Formats a known reference date and reads back the field order from the parts.
+ * Reference: 2001-01-02 — day=2, month=1, year=2001
+ */
+export declare function resolveSegmentOrder(locale: string, format?: string): SegmentOrder;
+export declare function formatDisplay(date: Date, locale: string, mode: DatePickerMode, formatStr?: string): string;
+//# sourceMappingURL=i18n.d.ts.map

package/date-picker/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI/D;AAED,oDAAoD;AACpD,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,CA8BjF;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA0B1G"}

package/date-picker/index.d.ts

@@ -0,0 +1,4 @@
+export { ViDatePicker, VIALIQ_CHANGE } from './vi-date-picker.js';
+export { ViDatePickerInput } from './vi-date-picker-input.js';
+export type { DatePickerMode, DatePickerChangeDetail, ViDatePickerPlugin, DatePickerPluginInput, ControlStatus } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/date-picker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/date-picker/index.js

@@ -0,0 +1,2 @@
+export { VIALIQ_CHANGE, ViDatePicker } from './vi-date-picker.js';
+export { ViDatePickerInput } from './vi-date-picker-input.js';

package/date-picker/iso-week.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Calculates the ISO 8601 week number of a given date.
+ * ISO week starts on Monday, and the first week of the year is the one
+ * that contains the first Thursday of the year (or Jan 4).
+ *
+ * @param date The Date object to calculate the ISO week for.
+ * @returns The ISO 8601 week number (1-53).
+ */
+export declare function getISOWeek(date: Date): number;
+/**
+ * Parses an ISO 8601 week string (YYYY-Www) into a Date object.
+ * Returns the Monday of that week.
+ *
+ * @param isoWeekString The string in format YYYY-Www
+ * @returns A Date object representing the Monday of the given week, or null if invalid.
+ */
+export declare function parseISOWeek(isoWeekString: string): Date | null;
+//# sourceMappingURL=iso-week.d.ts.map

package/date-picker/iso-week.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-week.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/iso-week.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAqB7C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAuB/D"}

package/date-picker/locale-registry.d.ts

@@ -0,0 +1,8 @@
+import { CustomLocale } from 'flatpickr/dist/types/locale';
+/**
+ * Lazily loads a flatpickr locale definition for a given BCP 47 tag.
+ * Returns null for English (flatpickr's built-in default) or unsupported locales.
+ */
+export declare function loadLocale(bcp47: string): Promise<CustomLocale | null>;
+export declare function __clearLocaleCacheForTest(): void;
+//# sourceMappingURL=locale-registry.d.ts.map

package/date-picker/locale-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-registry.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/locale-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAiEhE;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA2B5E;AAED,wBAAgB,yBAAyB,SAExC"}

package/date-picker/plugin-registry.d.ts

@@ -0,0 +1,7 @@
+import { DatePickerMode, ViDatePickerPlugin } from './types.js';
+/**
+ * Lazily loads the required flatpickr plugin for a given picker mode.
+ * Returns null if the mode does not require a plugin (e.g. 'date', 'range').
+ */
+export declare function loadModePlugin(mode: DatePickerMode, options?: Record<string, unknown>): Promise<ViDatePickerPlugin | null>;
+//# sourceMappingURL=plugin-registry.d.ts.map

package/date-picker/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/plugin-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA2BrE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAMhI"}

package/date-picker/plugin-utils.d.ts

@@ -0,0 +1,10 @@
+import { Plugin } from 'flatpickr/dist/types/options';
+import { DatePickerPluginInput, ViDatePickerPlugin } from './types.js';
+export declare function isViPlugin(p: DatePickerPluginInput): p is ViDatePickerPlugin;
+export declare function resolvePlugin(p: DatePickerPluginInput): Plugin;
+/**
+ * Merges the built-in mode plugin with any consumer-provided plugins.
+ * Ensures the mode plugin is always first, and deduplicates by ViDatePickerPlugin.id.
+ */
+export declare function mergePlugins(modePlugin: DatePickerPluginInput | null, consumerPlugins?: DatePickerPluginInput[]): Plugin[];
+//# sourceMappingURL=plugin-utils.d.ts.map

package/date-picker/plugin-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-utils.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/plugin-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,qBAAqB,GAAG,CAAC,IAAI,kBAAkB,CAE5E;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,GAAG,IAAI,EACxC,eAAe,GAAE,qBAAqB,EAAO,GAC5C,MAAM,EAAE,CAwBV"}

package/date-picker/plugins/vi-month-year-plugin.d.ts

@@ -0,0 +1,17 @@
+import { Instance } from 'flatpickr/dist/types/instance';
+export interface ViMonthYearPluginConfig {
+    hideDays?: boolean;
+    ariaLabels?: {
+        prevMonth?: string;
+        nextMonth?: string;
+        selectMonth?: string;
+        selectYear?: string;
+    };
+}
+export declare function ViMonthYearPlugin(config?: ViMonthYearPluginConfig): (fp: Instance) => {
+    onReady: () => void;
+    onMonthChange: () => void;
+    onYearChange: () => void;
+    onDestroy: () => void;
+};
+//# sourceMappingURL=vi-month-year-plugin.d.ts.map

package/date-picker/plugins/vi-month-year-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi-month-year-plugin.d.ts","sourceRoot":"","sources":["../../../../../libs/web-components/src/date-picker/plugins/vi-month-year-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,2BAA2B,CAAC;AAEnC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,uBAA4B,IACnD,IAAI,QAAQ;;;;;EA6M9B"}

package/date-picker/plugins/vi-range-plugin.d.ts

@@ -0,0 +1,12 @@
+import { Plugin } from 'flatpickr/dist/types/options';
+interface Config {
+    input?: string | HTMLInputElement;
+    position?: 'left' | 'center' | 'right';
+}
+/**
+ * A wrapper around Flatpickr's rangePlugin that correctly formats dates back to the
+ * Shadow DOM input elements and handles Shadow DOM focus events correctly.
+ */
+export declare function ViRangePlugin(config: Config): Plugin;
+export {};
+//# sourceMappingURL=vi-range-plugin.d.ts.map

package/date-picker/plugins/vi-range-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi-range-plugin.d.ts","sourceRoot":"","sources":["../../../../../libs/web-components/src/date-picker/plugins/vi-range-plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,UAAU,MAAM;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmDpD"}

package/date-picker/plugins/vi-shadow-dom-plugin.d.ts

@@ -0,0 +1,18 @@
+import { Instance } from 'flatpickr/dist/types/instance';
+/**
+ * A Carbon Web Components inspired plugin that fixes Flatpickr's native
+ * event targeting issues when used within a Web Component (Shadow DOM).
+ *
+ * Flatpickr relies on native `Node.contains()` for its `documentClick` listener
+ * to determine if a click occurred outside the calendar. Because Shadow DOM
+ * boundaries are not pierced by `Node.contains()`, clicks on custom elements
+ * (like `<vi-select>`) inside the calendar are falsely identified as outside
+ * clicks, causing the calendar to close unexpectedly.
+ *
+ * This plugin overrides `fp.calendarContainer.contains` to properly traverse
+ * up through Shadow Roots.
+ */
+export declare function ViShadowDomPlugin(): (fp: Instance) => {
+    onReady: () => void;
+};
+//# sourceMappingURL=vi-shadow-dom-plugin.d.ts.map

package/date-picker/plugins/vi-shadow-dom-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi-shadow-dom-plugin.d.ts","sourceRoot":"","sources":["../../../../../libs/web-components/src/date-picker/plugins/vi-shadow-dom-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,KACd,IAAI,QAAQ;;EAyB9B"}

package/date-picker/types.d.ts

@@ -0,0 +1,34 @@
+import { Plugin } from 'flatpickr/dist/types/options';
+import { CustomLocale, key as LocaleKey, Locale } from 'flatpickr/dist/types/locale';
+export type DatePickerMode = 'date' | 'month' | 'month-year' | 'range' | 'week';
+export interface DateComponents {
+    day: number;
+    month: number;
+    year: number;
+}
+export type SegmentOrder = 'DMY' | 'MDY' | 'YMD';
+export interface DatePickerChangeDetail {
+    value: string | null;
+    type: DatePickerMode;
+    isoValue: string | null;
+    utcIso: string | null;
+    formattedValue: string;
+    rawValue: DateComponents | null;
+    rawEndValue?: DateComponents | null;
+    weekNumber: number | null;
+    locale: string;
+    timeZone: string;
+}
+export interface ViDatePickerPlugin {
+    id: string;
+    label: string;
+    factory: Plugin;
+    defaultConfig?: Record<string, unknown>;
+}
+/** Shape of a flatpickr dist/l10n/*.js module's default export */
+export type L10nModule = Partial<Record<LocaleKey, CustomLocale>> & {
+    default: Locale;
+};
+export type DatePickerPluginInput = Plugin | ViDatePickerPlugin;
+export type ControlStatus = 'default' | 'valid' | 'invalid';
+//# sourceMappingURL=types.d.ts.map

package/date-picker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1F,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC"}

package/date-picker/vi-date-picker-input.d.ts

@@ -0,0 +1,34 @@
+import { ViElement } from '../base/vi-element.js';
+export declare class ViDatePickerInput extends ViElement {
+    accessor kind: 'from' | 'to' | 'single';
+    accessor label: string;
+    accessor placeholder: string;
+    accessor disabled: boolean;
+    accessor required: boolean;
+    accessor invalid: boolean;
+    accessor validityMessage: string;
+    accessor expanded: boolean;
+    accessor value: string;
+    private accessor _triggerBtn;
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    /**
+     * Returns the interactable element for Flatpickr to bind to.
+     */
+    get inputElement(): HTMLElement;
+    focus(options?: FocusOptions): void;
+    render(): import('lit-html').TemplateResult<1>;
+    static styles: import('lit').CSSResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vi-date-picker-input': ViDatePickerInput;
+    }
+}
+//# sourceMappingURL=vi-date-picker-input.d.ts.map

package/date-picker/vi-date-picker-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vi-date-picker-input.d.ts","sourceRoot":"","sources":["../../../../libs/web-components/src/date-picker/vi-date-picker-input.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,qBACa,iBAAkB,SAAQ,SAAS;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAY;IAClE,QAAQ,CAAC,KAAK,SAAM;IACpB,QAAQ,CAAC,WAAW,EAAG,MAAM,CAAC;IACd,QAAQ,CAAC,QAAQ,UAAS;IAC1B,QAAQ,CAAC,QAAQ,UAAS;IAC1B,QAAQ,CAAC,OAAO,UAAS;IACzC,QAAQ,CAAC,eAAe,SAAM;IAC7B,QAAQ,CAAC,QAAQ,UAAS;IAG3B,QAAQ,CAAC,KAAK,SAAM;IAE7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAEpE,OAAgB,iBAAiB;;;;;;;MAG/B;IAEF;;OAEG;IACH,IAAI,YAAY,IAAI,WAAW,CAE9B;IAEQ,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY;IAQ5B,MAAM;IAuCf,OAAgB,MAAM,0BAEpB;CACH;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,iBAAiB,CAAC;KAC3C;CACF"}