@uplynk/lynk-design 1.14.0 → 1.15.0

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@uplynk/lynk-design",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -49,6 +49,115 @@
             "events": []
           }
         },
+        {
+          "name": "lynk-alert",
+          "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **ev-show** - Emitted when the alert opens.\n- **ev-after-show** - Emitted after the alert opens and all animations are complete.\n- **ev-hide** - Emitted when the alert closes.\n- **ev-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's content.\n- **icon** - An icon to show in the alert.\n- **action** - Append custom actions to alert.\n\n### **CSS Properties:**\n - **--box-shadow** - The alert's box shadow. _(default: undefined)_\n- **--padding** - The top and bottom padding of the message. Use any spacing token (--lynk-spacing-large) or a custom value. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal block wrapper.\n- **icon** - The container that wraps the alert icon.\n- **message** - The alert message.\n- **close-button** - The close button.\n- **close-button__base** - The close button's `base` part.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "open",
+              "description": "Indicates whether or not the alert is open. You can use this in lieu of the show/hide methods.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "closable",
+              "description": "Makes the alert closable.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "type",
+              "description": "The alert's type (color).",
+              "value": {
+                "type": "'primary' | 'info' | 'success' | 'neutral' | 'warning' | 'danger'",
+                "default": "'primary'"
+              }
+            },
+            {
+              "name": "duration",
+              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`.",
+              "value": { "type": "string", "default": "Infinity" }
+            },
+            {
+              "name": "countdown",
+              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+              "value": { "type": "'rtl' | 'ltr' | undefined" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The alert's content." },
+            { "name": "icon", "description": "An icon to show in the alert." },
+            {
+              "name": "action",
+              "description": "Append custom actions to alert."
+            }
+          ],
+          "events": [
+            {
+              "name": "ev-show",
+              "description": "Emitted when the alert opens."
+            },
+            {
+              "name": "ev-after-show",
+              "description": "Emitted after the alert opens and all animations are complete."
+            },
+            {
+              "name": "ev-hide",
+              "description": "Emitted when the alert closes."
+            },
+            {
+              "name": "ev-after-hide",
+              "description": "Emitted after the alert closes and all animations are complete."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "base", "type": "HTMLElement" },
+              { "name": "countdownElement", "type": "HTMLElement" },
+              {
+                "name": "open",
+                "description": "Indicates whether or not the alert is open. You can use this in lieu of the show/hide methods.",
+                "type": "boolean"
+              },
+              {
+                "name": "closable",
+                "description": "Makes the alert closable.",
+                "type": "boolean"
+              },
+              {
+                "name": "type",
+                "description": "The alert's type (color).",
+                "type": "'primary' | 'info' | 'success' | 'neutral' | 'warning' | 'danger'"
+              },
+              {
+                "name": "duration",
+                "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`."
+              },
+              {
+                "name": "countdown",
+                "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+                "type": "'rtl' | 'ltr' | undefined"
+              }
+            ],
+            "events": [
+              {
+                "name": "ev-show",
+                "description": "Emitted when the alert opens."
+              },
+              {
+                "name": "ev-after-show",
+                "description": "Emitted after the alert opens and all animations are complete."
+              },
+              {
+                "name": "ev-hide",
+                "description": "Emitted when the alert closes."
+              },
+              {
+                "name": "ev-after-hide",
+                "description": "Emitted after the alert closes and all animations are complete."
+              }
+            ]
+          }
+        },
         {
           "name": "lynk-animation",
           "description": "Animate elements declaratively with nearly 100 baked-in presets, or roll your own with custom keyframes. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).\n---\n\n\n### **Events:**\n - **ev-cancel** - Emitted when the animation is canceled.\n- **ev-finish** - Emitted when the animation finishes.\n- **ev-start** - Emitted when the animation starts or restarts.\n\n### **Methods:**\n - **cancel()** - Clears all KeyframeEffects caused by this animation and aborts its playback.\n- **finish()** - Sets the playback time to the end of the animation corresponding to the current playback direction.\n\n### **Slots:**\n - _default_ - The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `<lynk-animation>` elements.",
@@ -261,115 +370,6 @@
             "events": []
           }
         },
-        {
-          "name": "lynk-alert",
-          "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **ev-show** - Emitted when the alert opens.\n- **ev-after-show** - Emitted after the alert opens and all animations are complete.\n- **ev-hide** - Emitted when the alert closes.\n- **ev-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's content.\n- **icon** - An icon to show in the alert.\n- **action** - Append custom actions to alert.\n\n### **CSS Properties:**\n - **--box-shadow** - The alert's box shadow. _(default: undefined)_\n- **--padding** - The top and bottom padding of the message. Use any spacing token (--lynk-spacing-large) or a custom value. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal block wrapper.\n- **icon** - The container that wraps the alert icon.\n- **message** - The alert message.\n- **close-button** - The close button.\n- **close-button__base** - The close button's `base` part.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "open",
-              "description": "Indicates whether or not the alert is open. You can use this in lieu of the show/hide methods.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "closable",
-              "description": "Makes the alert closable.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "type",
-              "description": "The alert's type (color).",
-              "value": {
-                "type": "'primary' | 'info' | 'success' | 'neutral' | 'warning' | 'danger'",
-                "default": "'primary'"
-              }
-            },
-            {
-              "name": "duration",
-              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`.",
-              "value": { "type": "string", "default": "Infinity" }
-            },
-            {
-              "name": "countdown",
-              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-              "value": { "type": "'rtl' | 'ltr' | undefined" }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The alert's content." },
-            { "name": "icon", "description": "An icon to show in the alert." },
-            {
-              "name": "action",
-              "description": "Append custom actions to alert."
-            }
-          ],
-          "events": [
-            {
-              "name": "ev-show",
-              "description": "Emitted when the alert opens."
-            },
-            {
-              "name": "ev-after-show",
-              "description": "Emitted after the alert opens and all animations are complete."
-            },
-            {
-              "name": "ev-hide",
-              "description": "Emitted when the alert closes."
-            },
-            {
-              "name": "ev-after-hide",
-              "description": "Emitted after the alert closes and all animations are complete."
-            }
-          ],
-          "js": {
-            "properties": [
-              { "name": "base", "type": "HTMLElement" },
-              { "name": "countdownElement", "type": "HTMLElement" },
-              {
-                "name": "open",
-                "description": "Indicates whether or not the alert is open. You can use this in lieu of the show/hide methods.",
-                "type": "boolean"
-              },
-              {
-                "name": "closable",
-                "description": "Makes the alert closable.",
-                "type": "boolean"
-              },
-              {
-                "name": "type",
-                "description": "The alert's type (color).",
-                "type": "'primary' | 'info' | 'success' | 'neutral' | 'warning' | 'danger'"
-              },
-              {
-                "name": "duration",
-                "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`."
-              },
-              {
-                "name": "countdown",
-                "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-                "type": "'rtl' | 'ltr' | undefined"
-              }
-            ],
-            "events": [
-              {
-                "name": "ev-show",
-                "description": "Emitted when the alert opens."
-              },
-              {
-                "name": "ev-after-show",
-                "description": "Emitted after the alert opens and all animations are complete."
-              },
-              {
-                "name": "ev-hide",
-                "description": "Emitted when the alert closes."
-              },
-              {
-                "name": "ev-after-hide",
-                "description": "Emitted after the alert closes and all animations are complete."
-              }
-            ]
-          }
-        },
         {
           "name": "lynk-avatar",
           "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **ev-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<wa-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
@@ -1465,6 +1465,14 @@
             ]
           }
         },
+        {
+          "name": "lynk-col",
+          "description": "Table `<lynk-col>` components will behave like a native `<col>` HTML element within a `<lynk-table>`.\n---\n",
+          "doc-url": "",
+          "attributes": [],
+          "events": [],
+          "js": { "properties": [], "events": [] }
+        },
         {
           "name": "lynk-clock",
           "description": "A time picker component with hour, minute, second, and AM/PM columns.\n---\n\n\n### **Events:**\n - **ev-change** - Emitted when the time value changes.\n\n### **Methods:**\n - **scrollToCurrentTime(instant)** - Public method to scroll to the current selected time\n\n### **CSS Properties:**\n - **--height** - The default height of the clock columns _(default: undefined)_\n- **--selected-color** - The selected date color _(default: undefined)_\n- **--selected-text-color** - The text color on a selected date _(default: undefined)_\n- **--hover-color** - The background hover color for a date _(default: undefined)_\n- **--border-color** - The color of the dividers between columns _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **time-picker** - The time picker container.\n- **column** - A time column (hours, minutes, or AM/PM).\n- **column-header** - The header of a time column.\n- **time-item** - An individual time item.\n- **time-item--selected** - The selected time item.\n- **ampm-toggle** - The AM/PM toggle buttons.",
@@ -1558,10 +1566,16 @@
           }
         },
         {
-          "name": "lynk-col",
-          "description": "Table `<lynk-col>` components will behave like a native `<col>` HTML element within a `<lynk-table>`.\n---\n",
+          "name": "lynk-colgroup",
+          "description": "Table `<lynk-colgroup>` components will behave like a native `<colgroup>` HTML element within a `<lynk-table>`.\n---\n\n\n### **Slots:**\n - _default_ - Should contain 1 or more `<lynk-col>` components.\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.",
           "doc-url": "",
           "attributes": [],
+          "slots": [
+            {
+              "name": "",
+              "description": "Should contain 1 or more `<lynk-col>` components."
+            }
+          ],
           "events": [],
           "js": { "properties": [], "events": [] }
         },
@@ -1800,20 +1814,6 @@
             ]
           }
         },
-        {
-          "name": "lynk-colgroup",
-          "description": "Table `<lynk-colgroup>` components will behave like a native `<colgroup>` HTML element within a `<lynk-table>`.\n---\n\n\n### **Slots:**\n - _default_ - Should contain 1 or more `<lynk-col>` components.\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            {
-              "name": "",
-              "description": "Should contain 1 or more `<lynk-col>` components."
-            }
-          ],
-          "events": [],
-          "js": { "properties": [], "events": [] }
-        },
         {
           "name": "lynk-combobox",
           "description": "Comboboxes allow you to choose items from a menu of predefined options.\n---\n\n\n### **Events:**\n - **ev-change** - Emitted when the control's value changes.\n- **ev-clear** - Emitted when the control's value is cleared.\n- **ev-input** - Emitted when the control receives input.\n- **ev-focus** - Emitted when the control gains focus.\n- **ev-blur** - Emitted when the control loses focus.\n- **ev-show** - Emitted when the combobox's menu opens.\n- **ev-after-show** - Emitted after the combobox's menu opens and all animations are complete.\n- **ev-hide** - Emitted when the combobox's menu closes.\n- **ev-after-hide** - Emitted after the combobox's menu closes and all animations are complete.\n- **ev-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n- **ev-error** - Emitted when the combobox menu fails to open.\n- **ev-add-option** - Emitted when a custom option is added via allowCustomValues.\n\n### **Methods:**\n - **show()** - Shows the listbox. If it is not possible to open the listbox, because there are no\nappropriate filtered options, a ev-error is emitted and the listbox stays closed.\n- **hide()** - Hides the listbox.\n- **checkValidity()** - Checks for validity but does not show a validation message.\nReturns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The listbox options. Must be `<lynk-option>` elements. You can use `<lynk-optgroup>`'s to group items visually.\n- **label** - The combobox's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed. Rotates on open and close.\n- **help-text** - Text that describes how to use the combobox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, combobox, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The combobox's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, combobox, clear icon, and expand button.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected option's label, an `<input>` element.\n- **listbox** - The listbox container where the options are slotted and the filtered options list exists.\n- **filtered-listbox** - The container that wraps the filtered options.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",
@@ -2566,13 +2566,144 @@
           }
         },
         {
-          "name": "lynk-date-time-picker",
-          "description": "A date-time picker that combines calendar and clock components with accessible input fields. Accepts ISO 8601 format by default or Unix timestamps.\n---\n\n\n### **Events:**\n - **ev-change** - Emitted when the date-time value changes.\n- **ev-input** - Emitted when the control receives input.\n- **ev-clear** - Emitted when the input is cleared.\n\n### **Methods:**\n - **show()** - Shows the dropdown.\n- **hide()** - Hides the dropdown.\n- **focus(options: _FocusOptions_)** - Sets focus on the date input.\n- **blur()** - Removes focus from the input.\n- **checkValidity()** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the label prop.\n- **help-text** - Help text that describes how to use the input.\n- **help-tip** - Help tooltip next to the label that can be used in place of help-text to give additional information about how to use the input. Alternatively, you can use the help-tip prop.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **input-group** - The input group container.\n- **date-input** - The date input field.\n- **time-input** - The time input field.\n- **hour-input** - The hour number input (24h mode).\n- **minute-input** - The minute number input (24h mode).\n- **second-input** - The second number input (24h mode).\n- **trigger** - The dropdown trigger button.\n- **dropdown** - The dropdown panel.\n- **calendar** - The calendar component.\n- **clock** - The clock component.",
+          "name": "lynk-dialog",
+          "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **ev-show** - Emitted when the dialog opens.\n- **ev-after-show** - Emitted after the dialog opens and all animations are complete.\n- **ev-hide** - Emitted when the dialog closes.\n- **ev-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **ev-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **ev-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the label prop.\n- **header-actions** - Optional actions to add to the header. Works best with `<lynk-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.\n- **overlay** - The overlay.\n- **panel** - The dialog panel (where the dialog and its content is rendered).\n- **header** - The dialog header.\n- **header-actions** - Optional actions to add to the header. Works best with `<lynk-icon-button>`.\n- **title** - The dialog title.\n- **close-button** - The close button.\n- **close-button__base** - The close button's `base` part.\n- **body** - The dialog body.\n- **footer** - The dialog footer.",
           "doc-url": "",
           "attributes": [
             {
-              "name": "name",
-              "description": "The input's name attribute.",
+              "name": "open",
+              "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "label",
+              "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "no-header",
+              "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "size",
+              "description": "The dialog's size.",
+              "value": {
+                "type": "'fitted' | 'full' | 'auto'",
+                "default": "'auto'"
+              }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The dialog's main content." },
+            {
+              "name": "label",
+              "description": "The dialog's label. Alternatively, you can use the label prop."
+            },
+            {
+              "name": "header-actions",
+              "description": "Optional actions to add to the header. Works best with `<lynk-icon-button>`."
+            },
+            {
+              "name": "footer",
+              "description": "The dialog's footer, usually one or more buttons representing various options."
+            }
+          ],
+          "events": [
+            {
+              "name": "ev-show",
+              "description": "Emitted when the dialog opens."
+            },
+            {
+              "name": "ev-after-show",
+              "description": "Emitted after the dialog opens and all animations are complete."
+            },
+            {
+              "name": "ev-hide",
+              "description": "Emitted when the dialog closes."
+            },
+            {
+              "name": "ev-after-hide",
+              "description": "Emitted after the dialog closes and all animations are complete."
+            },
+            {
+              "name": "ev-initial-focus",
+              "description": "Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input."
+            },
+            {
+              "name": "ev-request-close",
+              "type": "{ source: 'close-button' | 'keyboard' | 'overlay' }",
+              "description": "Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "modal",
+                "description": "Exposes the internal modal utility that controls focus trapping. To temporarily disable focus trapping and allow third-party modals spawned from an active Lynk modal, call `modal.activateExternal()` when the third-party modal opens. Upon closing, call `modal.deactivateExternal()` to restore Lynk's focus trapping.",
+                "type": "Modal"
+              },
+              { "name": "dialog", "type": "HTMLElement" },
+              { "name": "panel", "type": "HTMLElement" },
+              { "name": "overlay", "type": "HTMLElement" },
+              {
+                "name": "open",
+                "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
+                "type": "boolean"
+              },
+              {
+                "name": "label",
+                "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
+                "type": "string"
+              },
+              {
+                "name": "noHeader",
+                "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
+                "type": "boolean"
+              },
+              {
+                "name": "size",
+                "description": "The dialog's size.",
+                "type": "'fitted' | 'full' | 'auto'"
+              }
+            ],
+            "events": [
+              {
+                "name": "ev-show",
+                "description": "Emitted when the dialog opens."
+              },
+              {
+                "name": "ev-after-show",
+                "description": "Emitted after the dialog opens and all animations are complete."
+              },
+              {
+                "name": "ev-hide",
+                "description": "Emitted when the dialog closes."
+              },
+              {
+                "name": "ev-after-hide",
+                "description": "Emitted after the dialog closes and all animations are complete."
+              },
+              {
+                "name": "ev-initial-focus",
+                "description": "Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input."
+              },
+              {
+                "name": "ev-request-close",
+                "type": "{ source: 'close-button' | 'keyboard' | 'overlay' }",
+                "description": "Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss."
+              }
+            ]
+          }
+        },
+        {
+          "name": "lynk-date-time-picker",
+          "description": "A date-time picker that combines calendar and clock components with accessible input fields. Accepts ISO 8601 format by default or Unix timestamps.\n---\n\n\n### **Events:**\n - **ev-change** - Emitted when the date-time value changes.\n- **ev-input** - Emitted when the control receives input.\n- **ev-clear** - Emitted when the input is cleared.\n\n### **Methods:**\n - **show()** - Shows the dropdown.\n- **hide()** - Hides the dropdown.\n- **focus(options: _FocusOptions_)** - Sets focus on the date input.\n- **blur()** - Removes focus from the input.\n- **checkValidity()** - Checks for validity but does not show a validation message.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the label prop.\n- **help-text** - Help text that describes how to use the input.\n- **help-tip** - Help tooltip next to the label that can be used in place of help-text to give additional information about how to use the input. Alternatively, you can use the help-tip prop.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **form-control** - The form control wrapper.\n- **form-control-label** - The label wrapper.\n- **form-control-input** - The input wrapper.\n- **form-control-help-text** - The help text wrapper.\n- **input-group** - The input group container.\n- **date-input** - The date input field.\n- **time-input** - The time input field.\n- **hour-input** - The hour number input (24h mode).\n- **minute-input** - The minute number input (24h mode).\n- **second-input** - The second number input (24h mode).\n- **trigger** - The dropdown trigger button.\n- **dropdown** - The dropdown panel.\n- **calendar** - The calendar component.\n- **clock** - The clock component.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "name",
+              "description": "The input's name attribute.",
               "value": { "type": "string", "default": "''" }
             },
             {
@@ -2899,137 +3030,6 @@
             ]
           }
         },
-        {
-          "name": "lynk-dialog",
-          "description": "Dialogs, sometimes called \"modals\", appear above the page and require the user's immediate attention.\n---\n\n\n### **Events:**\n - **ev-show** - Emitted when the dialog opens.\n- **ev-after-show** - Emitted after the dialog opens and all animations are complete.\n- **ev-hide** - Emitted when the dialog closes.\n- **ev-after-hide** - Emitted after the dialog closes and all animations are complete.\n- **ev-initial-focus** - Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input.\n- **ev-request-close** - Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss.\n\n### **Methods:**\n - **show()** - Shows the dialog.\n- **hide()** - Hides the dialog\n\n### **Slots:**\n - _default_ - The dialog's main content.\n- **label** - The dialog's label. Alternatively, you can use the label prop.\n- **header-actions** - Optional actions to add to the header. Works best with `<lynk-icon-button>`.\n- **footer** - The dialog's footer, usually one or more buttons representing various options.\n\n### **CSS Properties:**\n - **--width** - The preferred width of the dialog. Note that the dialog will shrink to accommodate smaller screens. _(default: undefined)_\n- **--header-spacing** - The amount of padding to use for the header. _(default: undefined)_\n- **--body-spacing** - The amount of padding to use for the body. _(default: undefined)_\n- **--footer-spacing** - The amount of padding to use for the footer. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.\n- **overlay** - The overlay.\n- **panel** - The dialog panel (where the dialog and its content is rendered).\n- **header** - The dialog header.\n- **header-actions** - Optional actions to add to the header. Works best with `<lynk-icon-button>`.\n- **title** - The dialog title.\n- **close-button** - The close button.\n- **close-button__base** - The close button's `base` part.\n- **body** - The dialog body.\n- **footer** - The dialog footer.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "open",
-              "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "label",
-              "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "no-header",
-              "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "size",
-              "description": "The dialog's size.",
-              "value": {
-                "type": "'fitted' | 'full' | 'auto'",
-                "default": "'auto'"
-              }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The dialog's main content." },
-            {
-              "name": "label",
-              "description": "The dialog's label. Alternatively, you can use the label prop."
-            },
-            {
-              "name": "header-actions",
-              "description": "Optional actions to add to the header. Works best with `<lynk-icon-button>`."
-            },
-            {
-              "name": "footer",
-              "description": "The dialog's footer, usually one or more buttons representing various options."
-            }
-          ],
-          "events": [
-            {
-              "name": "ev-show",
-              "description": "Emitted when the dialog opens."
-            },
-            {
-              "name": "ev-after-show",
-              "description": "Emitted after the dialog opens and all animations are complete."
-            },
-            {
-              "name": "ev-hide",
-              "description": "Emitted when the dialog closes."
-            },
-            {
-              "name": "ev-after-hide",
-              "description": "Emitted after the dialog closes and all animations are complete."
-            },
-            {
-              "name": "ev-initial-focus",
-              "description": "Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input."
-            },
-            {
-              "name": "ev-request-close",
-              "type": "{ source: 'close-button' | 'keyboard' | 'overlay' }",
-              "description": "Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss."
-            }
-          ],
-          "js": {
-            "properties": [
-              {
-                "name": "modal",
-                "description": "Exposes the internal modal utility that controls focus trapping. To temporarily disable focus trapping and allow third-party modals spawned from an active Lynk modal, call `modal.activateExternal()` when the third-party modal opens. Upon closing, call `modal.deactivateExternal()` to restore Lynk's focus trapping.",
-                "type": "Modal"
-              },
-              { "name": "dialog", "type": "HTMLElement" },
-              { "name": "panel", "type": "HTMLElement" },
-              { "name": "overlay", "type": "HTMLElement" },
-              {
-                "name": "open",
-                "description": "Indicates whether or not the dialog is open. You can toggle this attribute to show and hide the dialog, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the dialog's open state.",
-                "type": "boolean"
-              },
-              {
-                "name": "label",
-                "description": "The dialog's label as displayed in the header. You should always include a relevant label even when using\n`no-header`, as it is required for proper accessibility. If you need to display HTML, use the `label` slot instead.",
-                "type": "string"
-              },
-              {
-                "name": "noHeader",
-                "description": "Disables the header. This will also remove the default close button, so please ensure you provide an easy,\naccessible way for users to dismiss the dialog.",
-                "type": "boolean"
-              },
-              {
-                "name": "size",
-                "description": "The dialog's size.",
-                "type": "'fitted' | 'full' | 'auto'"
-              }
-            ],
-            "events": [
-              {
-                "name": "ev-show",
-                "description": "Emitted when the dialog opens."
-              },
-              {
-                "name": "ev-after-show",
-                "description": "Emitted after the dialog opens and all animations are complete."
-              },
-              {
-                "name": "ev-hide",
-                "description": "Emitted when the dialog closes."
-              },
-              {
-                "name": "ev-after-hide",
-                "description": "Emitted after the dialog closes and all animations are complete."
-              },
-              {
-                "name": "ev-initial-focus",
-                "description": "Emitted when the dialog opens and is ready to receive focus. Calling `event.preventDefault()` will prevent focusing and allow you to set it on a different element, such as an input."
-              },
-              {
-                "name": "ev-request-close",
-                "type": "{ source: 'close-button' | 'keyboard' | 'overlay' }",
-                "description": "Emitted when the user attempts to close the dialog by clicking the close button, clicking the overlay, or pressing escape. Calling `event.preventDefault()` will keep the dialog open. Avoid using this unless closing the dialog will result in destructive behavior such as data loss."
-              }
-            ]
-          }
-        },
         {
           "name": "lynk-divider",
           "description": "Dividers are used to visually separate or group elements.\n---\n\n\n### **CSS Properties:**\n - **--color** - The color of the divider. _(default: undefined)_\n- **--width** - The width of the divider. _(default: undefined)_\n- **--spacing** - The spacing of the divider. _(default: undefined)_",
@@ -3349,203 +3349,62 @@
         },
         {
           "name": "lynk-flank",
-          "description": "Position two items side-by-side, with one item positioned alongside, or _flanking_, content that stretches to fill the available space..\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Properties:**\n - **--gap** - Customize the gap of the flank group. _(default: var(--lynk-spacing-small))_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "start",
-              "description": "Flank from first item",
-              "value": { "type": "boolean", "default": "true" }
-            },
-            {
-              "name": "end",
-              "description": "Flank from the last item",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "align",
-              "description": "How to align flanked items to each-other",
-              "value": {
-                "type": "'start' | 'center' | 'end' | 'stretch' | 'baseline'",
-                "default": "'center'"
-              }
-            },
-            {
-              "name": "gap",
-              "description": "The space between flanked items. Use spacing tokens or any custom size.",
-              "value": {
-                "type": "string",
-                "default": "'var(--lynk-spacing-small)'"
-              }
-            }
-          ],
-          "slots": [{ "name": "", "description": "The default slot." }],
-          "events": [],
-          "js": {
-            "properties": [
-              {
-                "name": "start",
-                "description": "Flank from first item",
-                "type": "boolean"
-              },
-              {
-                "name": "end",
-                "description": "Flank from the last item",
-                "type": "boolean"
-              },
-              {
-                "name": "align",
-                "description": "How to align flanked items to each-other",
-                "type": "'start' | 'center' | 'end' | 'stretch' | 'baseline'"
-              },
-              {
-                "name": "gap",
-                "description": "The space between flanked items. Use spacing tokens or any custom size.",
-                "type": "string"
-              }
-            ],
-            "events": []
-          }
-        },
-        {
-          "name": "lynk-form-field",
-          "description": "A standalone or wrapper component for all lynk form components. Handles basic label, help-tip, and help-text styles.\n---\n\n\n### **Events:**\n - **ev-focus** - Emitted when field or slotted element gains focus.\n- **ev-blur** - Emitted when field or slotted element loses focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The default slot.\n- **help-tip** - Custom help-tip content.\n- **help-text** - Custom help-text content.\n- **label** - Custom label content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The component's label wrapper.\n- **control** - The component's slotted control wrapper.\n- **help-text** - The component's help-text wrapper.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "state",
-              "description": "The fields's styled validity state",
-              "value": {
-                "type": "'error' | 'warning' | 'success' | 'default'",
-                "default": "'default'"
-              }
-            },
-            {
-              "name": "size",
-              "description": "The input's size.",
-              "value": {
-                "type": "'small' | 'medium' | 'large'",
-                "default": "'medium'"
-              }
-            },
-            {
-              "name": "label",
-              "description": "The input's label. Alternatively, you can use the label slot.",
-              "value": { "type": "string", "default": "''" }
-            },
-            { "name": "id", "value": { "type": "string", "default": "''" } },
-            {
-              "name": "help-text",
-              "description": "The help text below the input. Alternatively, you can use the help-text slot.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "help-tip",
-              "description": "The help tooltip appended to the label. Alternatively, you can use the help-tip slot.",
-              "value": { "type": "string", "default": "''" }
-            },
-            {
-              "name": "required",
-              "description": "Adds the required mark.",
-              "value": { "type": "boolean", "default": "false" }
-            },
+          "description": "Position two items side-by-side, with one item positioned alongside, or _flanking_, content that stretches to fill the available space..\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Properties:**\n - **--gap** - Customize the gap of the flank group. _(default: var(--lynk-spacing-small))_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
             {
-              "name": "dirty",
-              "description": "Adds the dirty indicator mark.",
-              "value": { "type": "boolean", "default": "false" }
+              "name": "start",
+              "description": "Flank from first item",
+              "value": { "type": "boolean", "default": "true" }
             },
             {
-              "name": "focused",
-              "description": "Controls the focused state styling.",
+              "name": "end",
+              "description": "Flank from the last item",
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "inline",
-              "description": "Arranges the label inline next to the control instead of above it.",
-              "value": { "type": "boolean", "default": "false" }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "help-tip", "description": "Custom help-tip content." },
-            { "name": "help-text", "description": "Custom help-text content." },
-            { "name": "label", "description": "Custom label content." }
-          ],
-          "events": [
-            {
-              "name": "ev-focus",
-              "description": "Emitted when field or slotted element gains focus."
+              "name": "align",
+              "description": "How to align flanked items to each-other",
+              "value": {
+                "type": "'start' | 'center' | 'end' | 'stretch' | 'baseline'",
+                "default": "'center'"
+              }
             },
             {
-              "name": "ev-blur",
-              "description": "Emitted when field or slotted element loses focus."
+              "name": "gap",
+              "description": "The space between flanked items. Use spacing tokens or any custom size.",
+              "value": {
+                "type": "string",
+                "default": "'var(--lynk-spacing-small)'"
+              }
             }
           ],
+          "slots": [{ "name": "", "description": "The default slot." }],
+          "events": [],
           "js": {
             "properties": [
-              { "name": "defaultSlot", "type": "HTMLSlotElement" },
-              {
-                "name": "containingElement",
-                "description": "The field will lose focus when the user interacts outside of this element (e.g. clicking).",
-                "type": "HTMLElement | undefined"
-              },
-              {
-                "name": "state",
-                "description": "The fields's styled validity state",
-                "type": "'error' | 'warning' | 'success' | 'default'"
-              },
-              {
-                "name": "size",
-                "description": "The input's size.",
-                "type": "'small' | 'medium' | 'large'"
-              },
-              {
-                "name": "label",
-                "description": "The input's label. Alternatively, you can use the label slot.",
-                "type": "string"
-              },
-              { "name": "id", "type": "string" },
-              {
-                "name": "helpText",
-                "description": "The help text below the input. Alternatively, you can use the help-text slot.",
-                "type": "string"
-              },
-              {
-                "name": "helpTip",
-                "description": "The help tooltip appended to the label. Alternatively, you can use the help-tip slot.",
-                "type": "string"
-              },
               {
-                "name": "required",
-                "description": "Adds the required mark.",
+                "name": "start",
+                "description": "Flank from first item",
                 "type": "boolean"
               },
               {
-                "name": "dirty",
-                "description": "Adds the dirty indicator mark.",
+                "name": "end",
+                "description": "Flank from the last item",
                 "type": "boolean"
               },
               {
-                "name": "focused",
-                "description": "Controls the focused state styling.",
-                "type": "boolean"
+                "name": "align",
+                "description": "How to align flanked items to each-other",
+                "type": "'start' | 'center' | 'end' | 'stretch' | 'baseline'"
               },
               {
-                "name": "inline",
-                "description": "Arranges the label inline next to the control instead of above it.",
-                "type": "boolean"
+                "name": "gap",
+                "description": "The space between flanked items. Use spacing tokens or any custom size.",
+                "type": "string"
               }
             ],
-            "events": [
-              {
-                "name": "ev-focus",
-                "description": "Emitted when field or slotted element gains focus."
-              },
-              {
-                "name": "ev-blur",
-                "description": "Emitted when field or slotted element loses focus."
-              }
-            ]
+            "events": []
           }
         },
         {
@@ -3729,6 +3588,147 @@
             "events": []
           }
         },
+        {
+          "name": "lynk-form-field",
+          "description": "A standalone or wrapper component for all lynk form components. Handles basic label, help-tip, and help-text styles.\n---\n\n\n### **Events:**\n - **ev-focus** - Emitted when field or slotted element gains focus.\n- **ev-blur** - Emitted when field or slotted element loses focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - _default_ - The default slot.\n- **help-tip** - Custom help-tip content.\n- **help-text** - Custom help-text content.\n- **label** - Custom label content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The component's label wrapper.\n- **control** - The component's slotted control wrapper.\n- **help-text** - The component's help-text wrapper.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "state",
+              "description": "The fields's styled validity state",
+              "value": {
+                "type": "'error' | 'warning' | 'success' | 'default'",
+                "default": "'default'"
+              }
+            },
+            {
+              "name": "size",
+              "description": "The input's size.",
+              "value": {
+                "type": "'small' | 'medium' | 'large'",
+                "default": "'medium'"
+              }
+            },
+            {
+              "name": "label",
+              "description": "The input's label. Alternatively, you can use the label slot.",
+              "value": { "type": "string", "default": "''" }
+            },
+            { "name": "id", "value": { "type": "string", "default": "''" } },
+            {
+              "name": "help-text",
+              "description": "The help text below the input. Alternatively, you can use the help-text slot.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "help-tip",
+              "description": "The help tooltip appended to the label. Alternatively, you can use the help-tip slot.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "required",
+              "description": "Adds the required mark.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "dirty",
+              "description": "Adds the dirty indicator mark.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "focused",
+              "description": "Controls the focused state styling.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "inline",
+              "description": "Arranges the label inline next to the control instead of above it.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "help-tip", "description": "Custom help-tip content." },
+            { "name": "help-text", "description": "Custom help-text content." },
+            { "name": "label", "description": "Custom label content." }
+          ],
+          "events": [
+            {
+              "name": "ev-focus",
+              "description": "Emitted when field or slotted element gains focus."
+            },
+            {
+              "name": "ev-blur",
+              "description": "Emitted when field or slotted element loses focus."
+            }
+          ],
+          "js": {
+            "properties": [
+              { "name": "defaultSlot", "type": "HTMLSlotElement" },
+              {
+                "name": "containingElement",
+                "description": "The field will lose focus when the user interacts outside of this element (e.g. clicking).",
+                "type": "HTMLElement | undefined"
+              },
+              {
+                "name": "state",
+                "description": "The fields's styled validity state",
+                "type": "'error' | 'warning' | 'success' | 'default'"
+              },
+              {
+                "name": "size",
+                "description": "The input's size.",
+                "type": "'small' | 'medium' | 'large'"
+              },
+              {
+                "name": "label",
+                "description": "The input's label. Alternatively, you can use the label slot.",
+                "type": "string"
+              },
+              { "name": "id", "type": "string" },
+              {
+                "name": "helpText",
+                "description": "The help text below the input. Alternatively, you can use the help-text slot.",
+                "type": "string"
+              },
+              {
+                "name": "helpTip",
+                "description": "The help tooltip appended to the label. Alternatively, you can use the help-tip slot.",
+                "type": "string"
+              },
+              {
+                "name": "required",
+                "description": "Adds the required mark.",
+                "type": "boolean"
+              },
+              {
+                "name": "dirty",
+                "description": "Adds the dirty indicator mark.",
+                "type": "boolean"
+              },
+              {
+                "name": "focused",
+                "description": "Controls the focused state styling.",
+                "type": "boolean"
+              },
+              {
+                "name": "inline",
+                "description": "Arranges the label inline next to the control instead of above it.",
+                "type": "boolean"
+              }
+            ],
+            "events": [
+              {
+                "name": "ev-focus",
+                "description": "Emitted when field or slotted element gains focus."
+              },
+              {
+                "name": "ev-blur",
+                "description": "Emitted when field or slotted element loses focus."
+              }
+            ]
+          }
+        },
         {
           "name": "lynk-format-number",
           "description": "Formats a number using the specified locale and options.\n---\n",
@@ -5630,7 +5630,7 @@
         },
         {
           "name": "lynk-panel",
-          "description": "Panels are lightweight content containers that function like a native `detail` HTML element with a collapsable body. They can either stand alone or be grouped together to form an [Accordion](/components/accordion).\n---\n\n\n### **Events:**\n - **ev-expand** - Emitted when the panel expands.\n- **ev-after-expand** - Emitted after the panel expands and all animations are complete.\n- **ev-collapse** - Emitted when the panel closes.\n- **ev-after-collapse** - Emitted after the panel closes and all animations are complete.\n\n### **Methods:**\n - **expand()** - Shows the panel.\n- **collapse()** - Hides the panel\n\n### **Slots:**\n - _default_ - The panels' main content.\n- **heading** - The panels' heading. Alternatively, you can use the `heading` attribute.\n- **prefix** - The panels' summary prefix `<slot>`.\n- **suffix** - The panels' summary suffix `<slot>`.\n- **expand-icon** - The expand icon's `<slot>`.\n- **collapse-icon** - The collapse icon's `<slot>`.\n- **footer** - The panels' footer `<slot>`.\n\n### **CSS Properties:**\n - **--background-color** - The panels background color _(default: undefined)_\n- **--spacing** - The amount of padding to use for the header, body, and footer. _(default: undefined)_\n- **--border-color** - Apply a panel border of your choosing. _(default: undefined)_\n- **--border-radius** - The panels border radius. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.\n- **header** - The panel header area.\n- **heading** - The panel heading.\n- **prefix** - The panel header prefix area.\n- **suffix** - The panel header suffix area.\n- **toggle-icon** - The expand/collapse toggle icon in the header.\n- **content** - The panel content.\n- **footer** - The panel footer.",
+          "description": "Panels are lightweight content containers that function like a native `detail` HTML element with a collapsable body. They can either stand alone or be grouped together to form an [Accordion](/components/accordion).\n---\n\n\n### **Events:**\n - **ev-expand** - Emitted when the panel expands.\n- **ev-after-expand** - Emitted after the panel expands and all animations are complete.\n- **ev-collapse** - Emitted when the panel closes.\n- **ev-after-collapse** - Emitted after the panel closes and all animations are complete.\n\n### **Methods:**\n - **expand()** - Shows the panel.\n- **collapse()** - Hides the panel\n\n### **Slots:**\n - _default_ - The panels' main content.\n- **heading** - The panels' heading. Alternatively, you can use the `heading` attribute.\n- **prefix** - The panels' summary prefix `<slot>`.\n- **suffix** - The panels' summary suffix `<slot>`.\n- **expand-icon** - The expand icon's `<slot>`.\n- **collapse-icon** - The collapse icon's `<slot>`.\n- **subheader** - Optional content displayed below the header, only visible when the panel is expanded.\n- **footer** - The panels' footer `<slot>`.\n\n### **CSS Properties:**\n - **--background-color** - The panels background color _(default: undefined)_\n- **--spacing** - The amount of padding to use for the header, body, and footer. _(default: undefined)_\n- **--border-color** - Apply a panel border of your choosing. _(default: undefined)_\n- **--border-radius** - The panels border radius. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's internal wrapper.\n- **header** - The panel header area.\n- **heading** - The panel heading.\n- **prefix** - The panel header prefix area.\n- **suffix** - The panel header suffix area.\n- **toggle-icon** - The expand/collapse toggle icon in the header.\n- **subheader** - The panel subheader area, visible only when expanded.\n- **content** - The panel content.\n- **footer** - The panel footer.",
           "doc-url": "",
           "attributes": [
             {
@@ -5710,6 +5710,10 @@
               "name": "collapse-icon",
               "description": "The collapse icon's `<slot>`."
             },
+            {
+              "name": "subheader",
+              "description": "Optional content displayed below the header, only visible when the panel is expanded."
+            },
             { "name": "footer", "description": "The panels' footer `<slot>`." }
           ],
           "events": [
@@ -6704,7 +6708,7 @@
         },
         {
           "name": "lynk-range",
-          "description": "Ranges allow the user to select a single value within a given range using a slider.\n---\n\n\n### **Events:**\n - **ev-blur** - Emitted when the control loses focus.\n- **ev-change** - Emitted when an alteration to the control's value is committed by the user.\n- **ev-focus** - Emitted when the control gains focus.\n- **ev-input** - Emitted when the control receives input.\n- **ev-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the range.\n- **blur()** - Removes focus from the range.\n- **stepUp()** - Increments the value of the range by the value of the step attribute.\n- **stepDown()** - Decrements the value of the range by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The range's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **help-tip** - Help tooltip next to the label. Alternatively, you can use the `help-tip` attribute.\n- **ticks** - Custom tick markers. Use this to override the default tick rendering.\n- **reference** - Reference labels displayed below the range (e.g., min/max labels).\n\n### **CSS Properties:**\n - **--thumb-size** - The size of the thumb. _(default: undefined)_\n- **--thumb-color** - The color of the thumb. _(default: undefined)_\n- **--thumb-border** - The box-shadow used for the thumb border. _(default: undefined)_\n- **--track-color-active** - The color of the active portion of the track. _(default: undefined)_\n- **--track-color-inactive** - The color of the inactive portion of the track. _(default: undefined)_\n- **--track-height** - The height of the track. _(default: undefined)_\n- **--track-active-offset** - The starting point of the active track (useful for ranges that don't start at 0). _(default: undefined)_\n- **--tick-color** - The color of tick markers. _(default: undefined)_\n- **--tick-label-color** - The color of tick labels. _(default: undefined)_\n- **--tick-width** - The width of tick markers. _(default: undefined)_\n- **--tick-height** - The height of tick markers. _(default: undefined)_\n- **--tick-selected-color** - The color of selected tick markers. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **wrapper** - The range track wrapper.\n- **track** - The range track (inactive portion).\n- **track-active** - The active portion of the track.\n- **thumb** - The draggable thumb.\n- **ticks** - The container for custom tick markers.\n- **markers** - The container that holds all the markers when `with-markers` is used.\n- **marker** - The individual markers that are shown when `with-markers` is used.\n- **references** - The container for reference labels.",
+          "description": "Ranges allow the user to select a single value within a given range using a slider.\n---\n\n\n### **Events:**\n - **ev-blur** - Emitted when the control loses focus.\n- **ev-change** - Emitted when an alteration to the control's value is committed by the user.\n- **ev-focus** - Emitted when the control gains focus.\n- **ev-input** - Emitted when the control receives input.\n- **ev-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the range.\n- **blur()** - Removes focus from the range.\n- **stepUp()** - Increments the value of the range by the value of the step attribute.\n- **stepDown()** - Decrements the value of the range by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The range's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend an icon or similar element to the range.\n- **suffix** - Used to append an icon or similar element to the range.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n- **help-tip** - Help tooltip next to the label. Alternatively, you can use the `help-tip` attribute.\n- **ticks** - Custom tick markers. Use this to override the default tick rendering.\n- **reference** - Reference labels displayed below the range (e.g., min/max labels).\n\n### **CSS Properties:**\n - **--thumb-size** - The size of the thumb. _(default: undefined)_\n- **--thumb-color** - The color of the thumb. _(default: undefined)_\n- **--thumb-border** - The box-shadow used for the thumb border. _(default: undefined)_\n- **--track-color-active** - The color of the active portion of the track. _(default: undefined)_\n- **--track-color-inactive** - The color of the inactive portion of the track. _(default: undefined)_\n- **--track-height** - The height of the track. _(default: undefined)_\n- **--track-active-offset** - The starting point of the active track (useful for ranges that don't start at 0). _(default: undefined)_\n- **--tick-color** - The color of tick markers. _(default: undefined)_\n- **--tick-label-color** - The color of tick labels. _(default: undefined)_\n- **--tick-width** - The width of tick markers. _(default: undefined)_\n- **--tick-height** - The height of tick markers. _(default: undefined)_\n- **--tick-selected-color** - The color of selected tick markers. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **wrapper** - The range track wrapper.\n- **track** - The range track (inactive portion).\n- **track-active** - The active portion of the track.\n- **thumb** - The draggable thumb.\n- **ticks** - The container for custom tick markers.\n- **markers** - The container that holds all the markers when `with-markers` is used.\n- **marker** - The individual markers that are shown when `with-markers` is used.\n- **references** - The container for reference labels.",
           "doc-url": "",
           "attributes": [
             {
@@ -6830,6 +6834,14 @@
               "name": "label",
               "description": "The range's label. Alternatively, you can use the `label` attribute."
             },
+            {
+              "name": "prefix",
+              "description": "Used to prepend an icon or similar element to the range."
+            },
+            {
+              "name": "suffix",
+              "description": "Used to append an icon or similar element to the range."
+            },
             {
               "name": "help-text",
               "description": "Text that describes how to use the input. Alternatively, you can use the `help-text` attribute."