@lmvz-ds/components 0.35.2 → 0.36.0

package/manifest.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-07-07T12:07:13",
+  "timestamp": "2026-07-08T09:00:08",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.43.5",
@@ -568,12 +568,16 @@
       ],
       "states": [],
       "dependents": [
+        "lmvz-datepicker",
         "lmvz-message",
         "lmvz-modal",
         "lmvz-snackbar"
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "lmvz-datepicker": [
+          "lmvz-button"
+        ],
         "lmvz-message": [
           "lmvz-button"
         ],
@@ -1185,29 +1189,775 @@
           },
           "signature": "checkValidity() => Promise<boolean>",
           "parameters": [],
-          "docs": "Returns whether the checkbox satisfies its validation constraints.",
-          "docsTags": []
-        },
-        {
-          "name": "focusInput",
-          "returns": {
-            "type": "Promise<void>",
-            "docs": ""
-          },
-          "complexType": {
-            "signature": "() => Promise<void>",
-            "parameters": [],
-            "references": {
-              "Promise": {
-                "location": "global",
-                "id": "global::Promise"
-              }
-            },
-            "return": "Promise<void>"
-          },
-          "signature": "focusInput() => Promise<void>",
-          "parameters": [],
-          "docs": "Sets focus on the native checkbox input.",
+          "docs": "Returns whether the checkbox satisfies its validation constraints.",
+          "docsTags": []
+        },
+        {
+          "name": "focusInput",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<void>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<void>"
+          },
+          "signature": "focusInput() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the native checkbox input.",
+          "docsTags": []
+        },
+        {
+          "name": "reportValidity",
+          "returns": {
+            "type": "Promise<boolean>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<boolean>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<boolean>"
+          },
+          "signature": "reportValidity() => Promise<boolean>",
+          "parameters": [],
+          "docs": "Reports validation errors to the user.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "lmvzChange",
+          "detail": "boolean",
+          "bubbles": true,
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted whenever the checkbox checked state changes.\nEvent detail contains the new checked boolean value.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/lmvz-chip/lmvz-chip.tsx",
+      "encapsulation": "shadow",
+      "tag": "lmvz-chip",
+      "readme": "# lmvz-chip\n\n\n",
+      "docs": "The chip displays a compact semantic status as a non-interactive UI element.",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "default - Arbitrary inline content used as the chip label. Icons passed here may not be aligned or spaced with the text content properly."
+        },
+        {
+          "name": "slot",
+          "text": "before-text - Optional slot for content to be placed before the text content. Common use case is an icon."
+        },
+        {
+          "name": "slot",
+          "text": "after-text - Optional slot for content to be placed after the text content. Common use case is an icon.\n\nSlotted `lmvz-icon`s are controlled by the chip's internal sizing."
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "size",
+          "type": "\"default\" | \"small\"",
+          "complexType": {
+            "original": "Chip.Size",
+            "resolved": "\"default\" | \"small\"",
+            "references": {
+              "Chip": {
+                "location": "import",
+                "path": "../../api/ds.types.js",
+                "id": "src/api/ds.types.d.ts::Chip",
+                "referenceLocation": "Chip"
+              }
+            }
+          },
+          "mutable": true,
+          "attr": "size",
+          "reflectToAttr": true,
+          "docs": "Size variant of the chip.\nInvalid values are normalized to `default` at runtime.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'default'"
+            }
+          ],
+          "default": "'default'",
+          "values": [
+            {
+              "value": "default",
+              "type": "string"
+            },
+            {
+              "value": "small",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "type",
+          "type": "\"active\" | \"error\" | \"neutral\" | \"success\" | \"warning\"",
+          "complexType": {
+            "original": "Chip.Type",
+            "resolved": "\"active\" | \"error\" | \"neutral\" | \"success\" | \"warning\"",
+            "references": {
+              "Chip": {
+                "location": "import",
+                "path": "../../api/ds.types.js",
+                "id": "src/api/ds.types.d.ts::Chip",
+                "referenceLocation": "Chip"
+              }
+            }
+          },
+          "mutable": true,
+          "attr": "type",
+          "reflectToAttr": true,
+          "docs": "Semantic variant of the chip.\nInvalid values are normalized to `active` at runtime.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'active'"
+            }
+          ],
+          "default": "'active'",
+          "values": [
+            {
+              "value": "active",
+              "type": "string"
+            },
+            {
+              "value": "error",
+              "type": "string"
+            },
+            {
+              "value": "neutral",
+              "type": "string"
+            },
+            {
+              "value": "success",
+              "type": "string"
+            },
+            {
+              "value": "warning",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "after-text",
+          "docs": "Optional slot for content to be placed after the text content. Common use case is an icon.\n\nSlotted `lmvz-icon`s are controlled by the chip's internal sizing."
+        },
+        {
+          "name": "before-text",
+          "docs": "Optional slot for content to be placed before the text content. Common use case is an icon."
+        },
+        {
+          "name": "default",
+          "docs": "Arbitrary inline content used as the chip label. Icons passed here may not be aligned or spaced with the text content properly."
+        }
+      ],
+      "parts": [],
+      "states": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/lmvz-datepicker/lmvz-datepicker.tsx",
+      "encapsulation": "shadow",
+      "tag": "lmvz-datepicker",
+      "readme": "# lmvz-datepicker\n\n`lmvz-datepicker` composes an `lmvz-input` text field with a decorative calendar icon and an `lmvz-popover` calendar panel into a single, form-associated date-picker control.\n\n## Breaking Change: Event Payload Migration\n\n**If you are upgrading from an earlier version, your integration code must change.**\n\nThe `lmvzChange` event payload changed from `Temporal.PlainDate` to a plain `IsoDateString` (`YYYY-MM-DD`):\n\n| Before | After |\n|--------|-------|\n| `event.detail.value` is a `Temporal.PlainDate` object | `event.detail.value` is a string like `\"2024-06-15\"` |\n| Consumers called `.toString()` or used Temporal APIs on the payload | Consumers now read `event.detail.value` directly as a plain string |\n| Angular: the value accessor invoked `.value.toString()` on the temporal object | Angular: the value accessor reads the string directly (no extraction needed) |\n\nIf your code uses `.value.toString()` or calls Temporal methods on the payload, update it to treat `value` as a plain ISO date string instead. The `temporal-polyfill` used internally is bundled into the component's build output — consumers do not need to import or provide it.\n\n## Form Association\n\nThe component is form-associated (`formAssociated: true`, `ElementInternals`). It participates in native `<form>` submission under the `name` attribute (submitted value is an `IsoDateString`), honors `required`/`min`/`max` constraints via `ElementInternals.setValidity` (`valueMissing`, `badInput`, `rangeUnderflow`/`rangeOverflow`), and supports `formResetCallback`/`formStateRestoreCallback` for form reset and browser autofill/bfcache restoration. \n\nUse `checkValidity()` and `reportValidity()` to validate or show validation UI (the component delegates `ElementInternals` validation to these methods explicitly — native form submission does not call them automatically).\n\n## Localization\n\nThe popover's accessible dialog label and the default fallback validation message are localized per the `locale` prop for de/en/fr/it, with regional variant fallback (e.g., `de-AT` falls back to `de`).\n\n## Accessibility Note\n\nThe composed `lmvz-input` text field correctly exposes and toggles `aria-expanded`, `aria-haspopup`, and `aria-controls` as the calendar opens and closes, ensuring assistive technology receives proper combobox-pattern semantics.\n",
+      "docs": "`lmvz-datepicker` composes an `lmvz-input` text field with a decorative calendar icon and an `lmvz-popover` calendar panel into a single, form-associated date-picker control.",
+      "docsTags": [
+        {
+          "name": "part",
+          "text": "panel - The outer container panel of the datepicker"
+        },
+        {
+          "name": "part",
+          "text": "header - The header row containing navigation buttons and month/year label"
+        },
+        {
+          "name": "part",
+          "text": "nav-prev - The previous-month navigation button"
+        },
+        {
+          "name": "part",
+          "text": "nav-next - The next-month navigation button"
+        },
+        {
+          "name": "part",
+          "text": "month-label - The month and year label in the header"
+        },
+        {
+          "name": "part",
+          "text": "weekday-row - The row of weekday column headers"
+        },
+        {
+          "name": "part",
+          "text": "weekday - An individual weekday column header cell"
+        },
+        {
+          "name": "part",
+          "text": "grid - The calendar day grid"
+        },
+        {
+          "name": "part",
+          "text": "week-row - A week row within the calendar grid"
+        },
+        {
+          "name": "part",
+          "text": "day - A day cell within the calendar grid"
+        },
+        {
+          "name": "part",
+          "text": "day--today - A day cell representing today"
+        },
+        {
+          "name": "part",
+          "text": "day--selected - The currently selected day cell"
+        },
+        {
+          "name": "part",
+          "text": "day--out-of-month - A day cell that belongs to an adjacent month"
+        },
+        {
+          "name": "part",
+          "text": "day--disabled - A day cell that is disabled (out of min/max bounds)"
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": true,
+          "docs": "Whether the entire datepicker (input + panel) is disabled.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "displayFormat",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "Datepicker.DisplayFormat",
+            "resolved": "string | undefined",
+            "references": {
+              "Datepicker": {
+                "location": "import",
+                "path": "../../api",
+                "id": "src/api/index.d.ts::Datepicker",
+                "referenceLocation": "Datepicker"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "display-format",
+          "reflectToAttr": false,
+          "docs": "Custom display-format pattern for the text field, using the tokens `yyyy`, `MM`, `dd`\n(e.g. `'dd.MM.yyyy'`). Defaults to a pattern derived from `locale`.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "errorMessage",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "error-message",
+          "reflectToAttr": false,
+          "docs": "Error message displayed below the text field when the value is invalid.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "firstDayOfWeek",
+          "type": "0 | 1",
+          "complexType": {
+            "original": "0 | 1",
+            "resolved": "0 | 1",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "first-day-of-week",
+          "reflectToAttr": false,
+          "docs": "First day of the week: `0` = Sunday, `1` = Monday.\nMonday-first is hardcoded for v1; this prop is reserved for future runtime support.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "1"
+            }
+          ],
+          "default": "1",
+          "values": [
+            {
+              "value": "0",
+              "type": "number"
+            },
+            {
+              "value": "1",
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "helperText",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "helper-text",
+          "reflectToAttr": false,
+          "docs": "Helper text displayed below the text field.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "label",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Label for the composed text field.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "locale",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "locale",
+          "reflectToAttr": false,
+          "docs": "BCP 47 locale tag used for weekday/month names, ARIA labels, and the default display format.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'de-CH'"
+            }
+          ],
+          "default": "'de-CH'",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "max",
+          "type": "`${number}-${number}-${number}` | undefined",
+          "complexType": {
+            "original": "IsoDateString | undefined",
+            "resolved": "`${number}-${number}-${number}` | undefined",
+            "references": {
+              "IsoDateString": {
+                "location": "import",
+                "path": "@lmvz-ds/lib-ts/date/IsoDateString.js",
+                "id": "../../lib/ts/src/date/IsoDateString.d.ts::IsoDateString",
+                "referenceLocation": "IsoDateString"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "max",
+          "reflectToAttr": false,
+          "docs": "Maximum selectable date in ISO `YYYY-MM-DD` format.\nDays after this date are disabled.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "`${number}-${number}-${number}`"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "min",
+          "type": "`${number}-${number}-${number}` | undefined",
+          "complexType": {
+            "original": "IsoDateString | undefined",
+            "resolved": "`${number}-${number}-${number}` | undefined",
+            "references": {
+              "IsoDateString": {
+                "location": "import",
+                "path": "@lmvz-ds/lib-ts/date/IsoDateString.js",
+                "id": "../../lib/ts/src/date/IsoDateString.d.ts::IsoDateString",
+                "referenceLocation": "IsoDateString"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "min",
+          "reflectToAttr": false,
+          "docs": "Minimum selectable date in ISO `YYYY-MM-DD` format.\nDays before this date are disabled.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "`${number}-${number}-${number}`"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "name",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "name",
+          "reflectToAttr": true,
+          "docs": "Name submitted with the form.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "Whether the calendar popover is open. Reflects the actual open state — it is kept\nin sync with focus/keyboard interactions and with light-dismiss/Escape closing.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string | undefined",
+          "complexType": {
+            "original": "string",
+            "resolved": "string | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "placeholder",
+          "reflectToAttr": false,
+          "docs": "Placeholder for the composed text field. Defaults to the locale-derived display pattern (e.g. `dd.MM.yyyy`).",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "readonly",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "readonly",
+          "reflectToAttr": true,
+          "docs": "Whether the datepicker is readonly. The text field cannot be typed into and the calendar cannot change the value,\nbut the value is still submitted with the form.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "required",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "required",
+          "reflectToAttr": true,
+          "docs": "Whether a value is required for the form to be valid.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "value",
+          "type": "`${number}-${number}-${number}` | undefined",
+          "complexType": {
+            "original": "`${number}-${number}-${number}` | undefined",
+            "resolved": "`${number}-${number}-${number}` | undefined",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The selected date in ISO `YYYY-MM-DD` format.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "`${number}-${number}-${number}`"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": true,
+          "setter": true
+        },
+        {
+          "name": "visibleMonth",
+          "type": "`${number}-${number}` | undefined",
+          "complexType": {
+            "original": "IsoYearMonthString | undefined",
+            "resolved": "`${number}-${number}` | undefined",
+            "references": {
+              "IsoYearMonthString": {
+                "location": "import",
+                "path": "@lmvz-ds/lib-ts/date/IsoDateString.js",
+                "id": "../../lib/ts/src/date/IsoDateString.d.ts::IsoYearMonthString",
+                "referenceLocation": "IsoYearMonthString"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "visible-month",
+          "reflectToAttr": false,
+          "docs": "ISO year-month string (`YYYY-MM`) whose month is currently displayed.\nDefaults to the current month when unset.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "`${number}-${number}`"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": true,
+          "setter": true
+        }
+      ],
+      "methods": [
+        {
+          "name": "checkValidity",
+          "returns": {
+            "type": "Promise<boolean>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<boolean>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<boolean>"
+          },
+          "signature": "checkValidity() => Promise<boolean>",
+          "parameters": [],
+          "docs": "Returns whether the current value satisfies `required`/`min`/`max` and is a parseable date.\nUnlike a native `<input>`, form-associated custom elements do not forward `ElementInternals`'\nconstraint-validation API to the element automatically — this delegates to it explicitly.",
           "docsTags": []
         },
         {
@@ -1229,175 +1979,175 @@
           },
           "signature": "reportValidity() => Promise<boolean>",
           "parameters": [],
-          "docs": "Reports validation errors to the user.",
+          "docs": "Reports validation errors to the user (e.g. shows the browser's native validation bubble)\nand returns whether the current value is valid.",
           "docsTags": []
         }
       ],
       "events": [
         {
           "event": "lmvzChange",
-          "detail": "boolean",
+          "detail": "{ value: `${number}-${number}-${number}` | undefined; }",
           "bubbles": true,
           "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
+            "original": "{ value: IsoDateString | undefined }",
+            "resolved": "{ value: `${number}-${number}-${number}` | undefined; }",
+            "references": {
+              "IsoDateString": {
+                "location": "import",
+                "path": "@lmvz-ds/lib-ts/date/IsoDateString.js",
+                "id": "../../lib/ts/src/date/IsoDateString.d.ts::IsoDateString",
+                "referenceLocation": "IsoDateString"
+              }
+            }
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the checkbox checked state changes.\nEvent detail contains the new checked boolean value.",
+          "docs": "Emitted when the user selects a date (via the calendar grid or by typing a complete valid date).\nThe `value` field carries an IsoDateString representing the selected date.",
           "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "states": [],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
-    },
-    {
-      "filePath": "src/components/lmvz-chip/lmvz-chip.tsx",
-      "encapsulation": "shadow",
-      "tag": "lmvz-chip",
-      "readme": "# lmvz-chip\n\n\n",
-      "docs": "The chip displays a compact semantic status as a non-interactive UI element.",
-      "docsTags": [
-        {
-          "name": "slot",
-          "text": "default - Arbitrary inline content used as the chip label. Icons passed here may not be aligned or spaced with the text content properly."
         },
         {
-          "name": "slot",
-          "text": "before-text - Optional slot for content to be placed before the text content. Common use case is an icon."
+          "event": "lmvzClose",
+          "detail": "void",
+          "bubbles": true,
+          "complexType": {
+            "original": "void",
+            "resolved": "void",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Forwarded from the internal popover: fired after the calendar panel closes.",
+          "docsTags": []
         },
         {
-          "name": "slot",
-          "text": "after-text - Optional slot for content to be placed after the text content. Common use case is an icon.\n\nSlotted `lmvz-icon`s are controlled by the chip's internal sizing."
-        }
-      ],
-      "usage": {},
-      "props": [
-        {
-          "name": "size",
-          "type": "\"default\" | \"small\"",
+          "event": "lmvzMonthChange",
+          "detail": "{ visibleMonth: `${number}-${number}`; }",
+          "bubbles": true,
           "complexType": {
-            "original": "Chip.Size",
-            "resolved": "\"default\" | \"small\"",
+            "original": "{ visibleMonth: IsoYearMonthString }",
+            "resolved": "{ visibleMonth: `${number}-${number}`; }",
             "references": {
-              "Chip": {
+              "IsoYearMonthString": {
                 "location": "import",
-                "path": "../../api/ds.types.js",
-                "id": "src/api/ds.types.d.ts::Chip",
-                "referenceLocation": "Chip"
+                "path": "@lmvz-ds/lib-ts/date/IsoDateString.js",
+                "id": "../../lib/ts/src/date/IsoDateString.d.ts::IsoYearMonthString",
+                "referenceLocation": "IsoYearMonthString"
               }
             }
           },
-          "mutable": true,
-          "attr": "size",
-          "reflectToAttr": true,
-          "docs": "Size variant of the chip.\nInvalid values are normalized to `default` at runtime.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'default'"
-            }
-          ],
-          "default": "'default'",
-          "values": [
-            {
-              "value": "default",
-              "type": "string"
-            },
-            {
-              "value": "small",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the displayed month changes via prev/next navigation.\nThe `visibleMonth` field carries an IsoYearMonthString representing the new month.",
+          "docsTags": []
         },
         {
-          "name": "type",
-          "type": "\"active\" | \"error\" | \"neutral\" | \"success\" | \"warning\"",
+          "event": "lmvzOpen",
+          "detail": "void",
+          "bubbles": true,
           "complexType": {
-            "original": "Chip.Type",
-            "resolved": "\"active\" | \"error\" | \"neutral\" | \"success\" | \"warning\"",
-            "references": {
-              "Chip": {
-                "location": "import",
-                "path": "../../api/ds.types.js",
-                "id": "src/api/ds.types.d.ts::Chip",
-                "referenceLocation": "Chip"
-              }
-            }
+            "original": "void",
+            "resolved": "void",
+            "references": {}
           },
-          "mutable": true,
-          "attr": "type",
-          "reflectToAttr": true,
-          "docs": "Semantic variant of the chip.\nInvalid values are normalized to `active` at runtime.",
-          "docsTags": [
-            {
-              "name": "default",
-              "text": "'active'"
-            }
-          ],
-          "default": "'active'",
-          "values": [
-            {
-              "value": "active",
-              "type": "string"
-            },
-            {
-              "value": "error",
-              "type": "string"
-            },
-            {
-              "value": "neutral",
-              "type": "string"
-            },
-            {
-              "value": "success",
-              "type": "string"
-            },
-            {
-              "value": "warning",
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false,
-          "getter": false,
-          "setter": false
+          "cancelable": true,
+          "composed": true,
+          "docs": "Forwarded from the internal popover: fired after the calendar panel opens.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "keydown",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "focusin",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "click",
+          "capture": false,
+          "passive": false
         }
       ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
       "styles": [],
-      "slots": [
+      "slots": [],
+      "parts": [
         {
-          "name": "after-text",
-          "docs": "Optional slot for content to be placed after the text content. Common use case is an icon.\n\nSlotted `lmvz-icon`s are controlled by the chip's internal sizing."
+          "name": "day",
+          "docs": "A day cell within the calendar grid"
         },
         {
-          "name": "before-text",
-          "docs": "Optional slot for content to be placed before the text content. Common use case is an icon."
+          "name": "day--disabled",
+          "docs": "A day cell that is disabled (out of min/max bounds)"
         },
         {
-          "name": "default",
-          "docs": "Arbitrary inline content used as the chip label. Icons passed here may not be aligned or spaced with the text content properly."
+          "name": "day--out-of-month",
+          "docs": "A day cell that belongs to an adjacent month"
+        },
+        {
+          "name": "day--selected",
+          "docs": "The currently selected day cell"
+        },
+        {
+          "name": "day--today",
+          "docs": "A day cell representing today"
+        },
+        {
+          "name": "grid",
+          "docs": "The calendar day grid"
+        },
+        {
+          "name": "header",
+          "docs": "The header row containing navigation buttons and month/year label"
+        },
+        {
+          "name": "month-label",
+          "docs": "The month and year label in the header"
+        },
+        {
+          "name": "nav-next",
+          "docs": "The next-month navigation button"
+        },
+        {
+          "name": "nav-prev",
+          "docs": "The previous-month navigation button"
+        },
+        {
+          "name": "panel",
+          "docs": "The outer container panel of the datepicker"
+        },
+        {
+          "name": "week-row",
+          "docs": "A week row within the calendar grid"
+        },
+        {
+          "name": "weekday",
+          "docs": "An individual weekday column header cell"
+        },
+        {
+          "name": "weekday-row",
+          "docs": "The row of weekday column headers"
         }
       ],
-      "parts": [],
       "states": [],
       "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
+      "dependencies": [
+        "lmvz-button",
+        "lmvz-icon",
+        "lmvz-input",
+        "lmvz-popover"
+      ],
+      "dependencyGraph": {
+        "lmvz-datepicker": [
+          "lmvz-button",
+          "lmvz-icon",
+          "lmvz-input",
+          "lmvz-popover"
+        ]
+      }
     },
     {
       "filePath": "src/components/lmvz-header/lmvz-header.tsx",
@@ -1754,6 +2504,7 @@
       "parts": [],
       "states": [],
       "dependents": [
+        "lmvz-datepicker",
         "lmvz-link",
         "lmvz-message",
         "lmvz-modal",
@@ -1761,6 +2512,9 @@
       ],
       "dependencies": [],
       "dependencyGraph": {
+        "lmvz-datepicker": [
+          "lmvz-icon"
+        ],
         "lmvz-link": [
           "lmvz-icon"
         ],
@@ -5851,9 +6605,15 @@
       ],
       "parts": [],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "lmvz-datepicker"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "lmvz-datepicker": [
+          "lmvz-input"
+        ]
+      }
     },
     {
       "filePath": "src/components/lmvz-link/lmvz-link.tsx",
@@ -6928,9 +7688,15 @@
         }
       ],
       "states": [],
-      "dependents": [],
+      "dependents": [
+        "lmvz-datepicker"
+      ],
       "dependencies": [],
-      "dependencyGraph": {}
+      "dependencyGraph": {
+        "lmvz-datepicker": [
+          "lmvz-popover"
+        ]
+      }
     },
     {
       "filePath": "src/components/lmvz-radio/lmvz-radio.tsx",
@@ -8762,6 +9528,21 @@
       "docstring": "",
       "path": "src/api/ds.types.d.ts"
     },
+    "../../lib/ts/src/date/IsoDateString.d.ts::IsoYearMonthString": {
+      "declaration": "`${number}-${number}`",
+      "docstring": "",
+      "path": "../../lib/ts/src/date/IsoDateString.d.ts"
+    },
+    "../../lib/ts/src/date/IsoDateString.d.ts::IsoDateString": {
+      "declaration": "`${number}-${number}-${number}`",
+      "docstring": "",
+      "path": "../../lib/ts/src/date/IsoDateString.d.ts"
+    },
+    "src/api/index.d.ts::Datepicker": {
+      "declaration": "any",
+      "docstring": "",
+      "path": "src/api/index.d.ts"
+    },
     "../../lib/ts/dist/validation/SVGString.d.ts::SVGString": {
       "declaration": "export type SVGString = string & Brand.Brand<'SVG'>;",
       "docstring": "",