@redvars/peacock 3.6.0 → 3.6.1

package/dist/custom-elements-jsdocs.json

@@ -8211,11 +8211,11 @@
     "label": "HTML Editor",
     "tag": "wc-html-editor",
     "rawTag": "html-editor",
-    "summary": "A WYSIWYG HTML editor component with a Material 3 styled toolbar.",
-    "overview": "<p>The HTML Editor provides a rich-text editing experience using the browser's built-in\n<code>contenteditable</code> API. It wraps the editable area in a Material 3 styled\n<code>wc-field</code> and exposes a toolbar with common formatting actions.</p>\n\n<p>Get and set the HTML content via the <code>value</code> property. The component\ndispatches a <code>change</code> event whenever the content is modified.</p>",
+    "summary": "A Tiptap-powered HTML editor with visual and source editing modes.",
+    "overview": "<p>The HTML Editor provides a rich-text editing experience built on Tiptap.\nIt wraps the editable area in a Material 3 styled <code>wc-field</code>,\nexposes common formatting actions, and includes a segmented switch between\n<strong>Visual</strong> and <strong>HTML</strong> source modes.</p>\n\n<p>Get and set the HTML content via the <code>value</code> property. The component\ndispatches a <code>change</code> event whenever the content is modified.\nMention suggestions are supported through the <code>mentions</code> property,\nwith optional externally managed lookup via the <code>search</code> event.</p>",
     "cssprop": "--html-editor-toolbar-border-color - Border color between toolbar and editing area.",
-    "fires": "change - Fired whenever the editable content changes.",
-    "example": "```html\n<wc-html-editor label=\"Description\" value=\"<p>Hello <strong>world</strong></p>\"></wc-html-editor>\n```",
+    "fires": "search - Fired in managed mention mode with { query, callback } detail.",
+    "example": "```html\n<wc-html-editor\n  label=\"Description\"\n  value=\"<p>Hello <strong>world</strong></p>\"\n  .mentions=\"[{ label: 'Alex', value: 'alex' }]\"\n></wc-html-editor>\n```",
     "tags": "input editor",
     "customElement": {
       "kind": "class",
@@ -8236,6 +8236,22 @@
         }
       ],
       "members": [
+        {
+          "kind": "field",
+          "name": "_editor",
+          "type": {
+            "text": "Editor | undefined"
+          },
+          "privacy": "private"
+        },
+        {
+          "kind": "field",
+          "name": "_changeTimeout",
+          "type": {
+            "text": "number | undefined"
+          },
+          "privacy": "private"
+        },
         {
           "kind": "field",
           "name": "value",
@@ -8310,6 +8326,66 @@
           "description": "Error message text.",
           "attribute": "error-text"
         },
+        {
+          "kind": "field",
+          "name": "showToolbar",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "true",
+          "description": "Whether toolbar controls should be displayed in visual mode.",
+          "attribute": "show-toolbar"
+        },
+        {
+          "kind": "field",
+          "name": "mentions",
+          "type": {
+            "text": "Array<{ label: string; value: string }>"
+          },
+          "default": "[]",
+          "description": "Mention suggestions used by the mention extension.",
+          "attribute": "mentions"
+        },
+        {
+          "kind": "field",
+          "name": "mentionsSearch",
+          "type": {
+            "text": "'contains' | 'managed'"
+          },
+          "default": "'contains'",
+          "description": "Mention filtering mode.",
+          "attribute": "mentions-search"
+        },
+        {
+          "kind": "field",
+          "name": "suggestionCharacter",
+          "type": {
+            "text": "string"
+          },
+          "default": "'@'",
+          "description": "Character that triggers mention suggestions.",
+          "attribute": "suggestion-character"
+        },
+        {
+          "kind": "field",
+          "name": "showSuggestionCharacter",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "true",
+          "description": "Whether to include the suggestion character in rendered mention text.",
+          "attribute": "show-suggestion-character"
+        },
+        {
+          "kind": "field",
+          "name": "debounce",
+          "type": {
+            "text": "number"
+          },
+          "default": "250",
+          "description": "Debounce in milliseconds for dispatching `change`.",
+          "attribute": "debounce"
+        },
         {
           "kind": "field",
           "name": "_focused",
@@ -8319,6 +8395,15 @@
           "privacy": "private",
           "default": "false"
         },
+        {
+          "kind": "field",
+          "name": "_mode",
+          "type": {
+            "text": "'visual' | 'html'"
+          },
+          "privacy": "private",
+          "default": "'visual'"
+        },
         {
           "kind": "field",
           "name": "_editorEl",
@@ -8329,18 +8414,12 @@
         },
         {
           "kind": "method",
-          "name": "_execCmd",
+          "name": "_normalizeHtml",
           "privacy": "private",
+          "static": true,
           "parameters": [
-            {
-              "name": "command",
-              "type": {
-                "text": "string"
-              }
-            },
             {
               "name": "value",
-              "optional": true,
               "type": {
                 "text": "string"
               }
@@ -8349,53 +8428,120 @@
         },
         {
           "kind": "method",
-          "name": "_handleInput",
+          "name": "_destroyEditor",
           "privacy": "private"
         },
         {
           "kind": "method",
-          "name": "_handleFocus",
+          "name": "_initializeEditor",
           "privacy": "private"
         },
         {
-          "kind": "method",
-          "name": "_handleBlur",
+          "kind": "field",
+          "name": "_focusEditorOnContainerClick",
           "privacy": "private"
         },
         {
           "kind": "method",
-          "name": "_insertLink",
+          "name": "_dispatchDebouncedChange",
           "privacy": "private"
         },
         {
           "kind": "method",
-          "name": "_toolbarButton",
+          "name": "_requestManagedMentions",
           "privacy": "private",
+          "return": {
+            "type": {
+              "text": "Promise<string[]>"
+            }
+          },
           "parameters": [
             {
-              "name": "icon",
+              "name": "mentionQuery",
               "type": {
                 "text": "string"
               }
-            },
+            }
+          ]
+        },
+        {
+          "kind": "method",
+          "name": "_getMentionItem",
+          "privacy": "private",
+          "parameters": [
             {
-              "name": "title",
+              "name": "value",
               "type": {
                 "text": "string"
               }
-            },
+            }
+          ]
+        },
+        {
+          "kind": "method",
+          "name": "_execCommand",
+          "privacy": "private",
+          "parameters": [
             {
               "name": "command",
+              "type": {
+                "text": "() => void"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "method",
+          "name": "_switchMode",
+          "privacy": "private",
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "CustomEvent<{ value: string }>"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "method",
+          "name": "_handleSourceChange",
+          "privacy": "private",
+          "parameters": [
+            {
+              "name": "event",
+              "type": {
+                "text": "Event"
+              }
+            }
+          ]
+        },
+        {
+          "kind": "method",
+          "name": "_toolbarButton",
+          "privacy": "private",
+          "parameters": [
+            {
+              "name": "icon",
               "type": {
                 "text": "string"
               }
             },
             {
-              "name": "value",
-              "optional": true,
+              "name": "title",
               "type": {
                 "text": "string"
               }
+            },
+            {
+              "name": "action",
+              "type": {
+                "text": "() => void"
+              }
+            },
+            {
+              "name": "active",
+              "default": "false"
             }
           ]
         },
@@ -8404,6 +8550,11 @@
           "name": "_renderToolbar",
           "privacy": "private"
         },
+        {
+          "kind": "method",
+          "name": "_renderReadonlyTag",
+          "privacy": "private"
+        },
         {
           "kind": "field",
           "name": "disabled",
@@ -8462,6 +8613,13 @@
         }
       ],
       "events": [
+        {
+          "name": "search",
+          "type": {
+            "text": "CustomEvent"
+          },
+          "description": "Fired in managed mention mode with { query, callback } detail."
+        },
         {
           "type": {
             "text": "Event"
@@ -8534,6 +8692,60 @@
           "description": "Error message text.",
           "fieldName": "errorText"
         },
+        {
+          "name": "show-toolbar",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "true",
+          "description": "Whether toolbar controls should be displayed in visual mode.",
+          "fieldName": "showToolbar"
+        },
+        {
+          "name": "mentions",
+          "type": {
+            "text": "Array<{ label: string; value: string }>"
+          },
+          "default": "[]",
+          "description": "Mention suggestions used by the mention extension.",
+          "fieldName": "mentions"
+        },
+        {
+          "name": "mentions-search",
+          "type": {
+            "text": "'contains' | 'managed'"
+          },
+          "default": "'contains'",
+          "description": "Mention filtering mode.",
+          "fieldName": "mentionsSearch"
+        },
+        {
+          "name": "suggestion-character",
+          "type": {
+            "text": "string"
+          },
+          "default": "'@'",
+          "description": "Character that triggers mention suggestions.",
+          "fieldName": "suggestionCharacter"
+        },
+        {
+          "name": "show-suggestion-character",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "true",
+          "description": "Whether to include the suggestion character in rendered mention text.",
+          "fieldName": "showSuggestionCharacter"
+        },
+        {
+          "name": "debounce",
+          "type": {
+            "text": "number"
+          },
+          "default": "250",
+          "description": "Debounce in milliseconds for dispatching `change`.",
+          "fieldName": "debounce"
+        },
         {
           "name": "disabled",
           "type": {
@@ -8589,7 +8801,7 @@
       },
       "tagName": "wc-html-editor",
       "customElement": true,
-      "summary": "A WYSIWYG HTML editor component with a Material 3 styled toolbar.",
+      "summary": "A Tiptap-powered HTML editor with visual and source editing modes.",
       "rawTag": {
         "name": "html-editor",
         "description": ""
@@ -10367,69 +10579,505 @@
           "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
           "attribute": "target",
           "inheritedFrom": {
-            "name": "BaseHyperlinkMixin",
-            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "rel",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
+          "attribute": "rel",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "download",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
+          "attribute": "download",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "method",
+          "name": "__isLink",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "description": "Returns `true` when `href` is set, indicating the component should render as a link.",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        }
+      ],
+      "mixins": [
+        {
+          "name": "BaseHyperlinkMixin",
+          "module": "/src/__mixins/BaseHyperlinkMixin.js"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-link",
+      "customElement": true,
+      "summary": "The link component is used to navigate to a new page or section within the current page.",
+      "rawTag": {
+        "name": "link",
+        "description": ""
+      },
+      "attributes": [
+        {
+          "name": "href",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
+          "fieldName": "href",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "name": "target",
+          "type": {
+            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
+          },
+          "default": "'_self'",
+          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
+          "fieldName": "target",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "name": "rel",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
+          "fieldName": "rel",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "name": "download",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
+          "fieldName": "download",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        }
+      ]
+    }
+  },
+  {
+    "label": "List",
+    "tag": "wc-list",
+    "rawTag": "list",
+    "summary": "A Material 3 list container for one or more list items.",
+    "example": "```html\n<wc-list>\n  <wc-list-item>\n    <wc-icon slot=\"leading\" name=\"inbox\"></wc-icon>\n    Inbox\n    <span slot=\"trailing\">24</span>\n  </wc-list-item>\n</wc-list>\n```",
+    "tags": "display",
+    "customElement": {
+      "kind": "class",
+      "description": "",
+      "name": "List",
+      "members": [
+        {
+          "kind": "field",
+          "name": "Item",
+          "static": true,
+          "default": "ListItem"
+        },
+        {
+          "kind": "field",
+          "name": "variant",
+          "type": {
+            "text": "'standard' | 'vibrant'"
+          },
+          "default": "'standard'",
+          "attribute": "variant",
+          "reflects": true
+        }
+      ],
+      "attributes": [
+        {
+          "name": "variant",
+          "type": {
+            "text": "'standard' | 'vibrant'"
+          },
+          "default": "'standard'",
+          "fieldName": "variant"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-list",
+      "customElement": true,
+      "summary": "A Material 3 list container for one or more list items.",
+      "rawTag": {
+        "name": "list",
+        "description": ""
+      }
+    }
+  },
+  {
+    "label": "List Item",
+    "tag": "wc-list-item",
+    "rawTag": "list-item",
+    "parentRawTag": "list",
+    "summary": "A Material 3 list item with leading, trailing and content slots.",
+    "example": "```html\n<wc-list-item selected>\n  <wc-icon slot=\"leading\" name=\"person\"></wc-icon>\n  Profile\n  <wc-icon slot=\"trailing\" name=\"chevron_right\"></wc-icon>\n</wc-list-item>\n```",
+    "tags": "display",
+    "customElement": {
+      "kind": "class",
+      "description": "",
+      "name": "ListItem",
+      "members": [
+        {
+          "kind": "field",
+          "name": "selected",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "attribute": "selected",
+          "reflects": true
+        },
+        {
+          "kind": "field",
+          "name": "itemElement",
+          "type": {
+            "text": "HTMLElement | null"
+          },
+          "readonly": true
+        },
+        {
+          "kind": "field",
+          "name": "isPressed",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false"
+        },
+        {
+          "kind": "method",
+          "name": "focus"
+        },
+        {
+          "kind": "method",
+          "name": "blur"
+        },
+        {
+          "kind": "field",
+          "name": "__dispatchClick"
+        },
+        {
+          "kind": "field",
+          "name": "__handleKeyDown"
+        },
+        {
+          "kind": "field",
+          "name": "__handlePress"
+        },
+        {
+          "kind": "method",
+          "name": "renderContent"
+        },
+        {
+          "kind": "field",
+          "name": "htmlType",
+          "type": {
+            "text": "'button' | 'submit' | 'reset'"
+          },
+          "default": "'button'",
+          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
+          "attribute": "htmlType",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "disabled",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
+          "attribute": "disabled",
+          "reflects": true,
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "softDisabled",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
+          "attribute": "soft-disabled",
+          "reflects": true,
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "disabledReason",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
+          "attribute": "disabled-reason",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "form",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
+          "attribute": "form",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "name",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
+          "attribute": "name",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "value",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
+          "attribute": "value",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "href",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "The URL that the hyperlink points to. When set, the component renders as an `<a>` element.\nMaps to the native `href` attribute.",
+          "attribute": "href",
+          "reflects": true,
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "target",
+          "type": {
+            "text": "'_self' | '_parent' | '_blank' | '_top' | string"
+          },
+          "default": "'_self'",
+          "description": "Where to display the linked URL. Maps to the native `target` attribute.\nPossible values are `\"_self\"`, `\"_blank\"`, `\"_parent\"`, `\"_top\"`, or a custom frame name.\nWhen using `\"_blank\"`, consider setting `rel=\"noopener noreferrer\"` for security. Defaults to `\"_self\"`.",
+          "attribute": "target",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "rel",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
+          "attribute": "rel",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "field",
+          "name": "download",
+          "type": {
+            "text": "string | undefined"
+          },
+          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
+          "attribute": "download",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        },
+        {
+          "kind": "method",
+          "name": "__isLink",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "description": "Returns `true` when `href` is set, indicating the component should render as a link.",
+          "inheritedFrom": {
+            "name": "BaseHyperlinkMixin",
+            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+          }
+        }
+      ],
+      "attributes": [
+        {
+          "name": "selected",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "fieldName": "selected"
+        },
+        {
+          "name": "htmlType",
+          "type": {
+            "text": "'button' | 'submit' | 'reset'"
+          },
+          "default": "'button'",
+          "description": "The type of the underlying `<button>` element. Maps to the native `type` attribute.\nPossible values are `\"button\"`, `\"submit\"`, `\"reset\"`. Defaults to `\"button\"`.",
+          "fieldName": "htmlType",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "name": "disabled",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "When `true`, the button is disabled and cannot be interacted with. Reflects to the `disabled` attribute. Defaults to `false`.",
+          "fieldName": "disabled",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "name": "soft-disabled",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "When `true`, the button is visually styled as disabled and cannot be interacted with, but remains focusable.\nUse this in combination with `disabledReason` to communicate why the button is unavailable.\nReflects to the `soft-disabled` attribute. Defaults to `false`.",
+          "fieldName": "softDisabled",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
+          }
+        },
+        {
+          "name": "disabled-reason",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "A human-readable explanation of why the button is disabled or soft-disabled.\nRendered as a visually hidden tooltip and linked via `aria-describedby` for accessibility.\nMaps to the `disabled-reason` attribute.",
+          "fieldName": "disabledReason",
+          "inheritedFrom": {
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
           }
         },
         {
-          "kind": "field",
-          "name": "rel",
+          "name": "form",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "The relationship between the current document and the linked URL.\nMaps to the native `rel` attribute on the rendered `<a>` element.\nWhen `target=\"_blank\"`, use `\"noopener noreferrer\"` to prevent tab-napping attacks.",
-          "attribute": "rel",
+          "default": "''",
+          "description": "The `id` of the `<form>` element to associate the button with.\nIf omitted, the button is associated with its nearest ancestor form.\nMaps to the native `form` attribute.",
+          "fieldName": "form",
           "inheritedFrom": {
-            "name": "BaseHyperlinkMixin",
-            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
           }
         },
         {
-          "kind": "field",
-          "name": "download",
+          "name": "name",
           "type": {
-            "text": "string | undefined"
+            "text": "string"
           },
-          "description": "Causes the browser to download the linked URL instead of navigating to it.\nIf a string value is provided, it is used as the suggested filename.\nOmit or leave undefined to preserve normal navigation behaviour.\nMaps to the native `download` attribute. Only applies when `href` is set.",
-          "attribute": "download",
+          "default": "''",
+          "description": "The name of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `name` attribute.",
+          "fieldName": "name",
           "inheritedFrom": {
-            "name": "BaseHyperlinkMixin",
-            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
           }
         },
         {
-          "kind": "method",
-          "name": "__isLink",
-          "return": {
-            "type": {
-              "text": "boolean"
-            }
+          "name": "value",
+          "type": {
+            "text": "string"
           },
-          "description": "Returns `true` when `href` is set, indicating the component should render as a link.",
+          "default": "''",
+          "description": "The value of the button, submitted as part of a name/value pair when the associated form is submitted.\nMaps to the native `value` attribute.",
+          "fieldName": "value",
           "inheritedFrom": {
-            "name": "BaseHyperlinkMixin",
-            "module": "src/__mixins/BaseHyperlinkMixin.ts"
+            "name": "BaseButtonMixin",
+            "module": "src/__mixins/BaseButtonMixin.ts"
           }
-        }
-      ],
-      "mixins": [
-        {
-          "name": "BaseHyperlinkMixin",
-          "module": "/src/__mixins/BaseHyperlinkMixin.js"
-        }
-      ],
-      "superclass": {
-        "name": "LitElement",
-        "package": "lit"
-      },
-      "tagName": "wc-link",
-      "customElement": true,
-      "summary": "The link component is used to navigate to a new page or section within the current page.",
-      "rawTag": {
-        "name": "link",
-        "description": ""
-      },
-      "attributes": [
+        },
         {
           "name": "href",
           "type": {
@@ -10479,7 +11127,28 @@
             "module": "src/__mixins/BaseHyperlinkMixin.ts"
           }
         }
-      ]
+      ],
+      "mixins": [
+        {
+          "name": "BaseButtonMixin",
+          "package": "@/__mixins/BaseButtonMixin.js"
+        },
+        {
+          "name": "BaseHyperlinkMixin",
+          "package": "@/__mixins/BaseHyperlinkMixin.js"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-list-item",
+      "customElement": true,
+      "summary": "A Material 3 list item with leading, trailing and content slots.",
+      "rawTag": {
+        "name": "list-item",
+        "description": ""
+      }
     }
   },
   {
@@ -11375,7 +12044,7 @@
     "rawTag": "modal-wc",
     "summary": "A Material Design 3 dialog/modal for displaying content in a layer above the page, with optional header, body, and footer slots.",
     "cssprop": "--modal-max-height - Maximum height of the dialog.",
-    "example": "```html\n<wc-modal open heading=\"Confirm Action\">\n  <p>Are you sure you want to continue?</p>\n  <div slot=\"footer\">\n    <wc-button variant=\"text\">Cancel</wc-button>\n    <wc-button>Confirm</wc-button>\n  </div>\n</wc-modal>\n```",
+    "example": "```html\nMODAL\n```",
     "tags": "overlay, dialog, feedback",
     "customElement": {
       "kind": "class",
@@ -11636,6 +12305,7 @@
     "rawTag": "navigation-rail",
     "summary": "A vertical side navigation for medium-sized screens, following Material Design 3 specs.",
     "overview": "<p>Navigation rail provides access to primary destinations in an app using icons—with or without labels—on a vertical rail.</p>\n<p>Use navigation rail on medium-sized screens (tablets) with 3–7 destinations.</p>",
+    "slot": "footer - Content pinned to the bottom of the rail.",
     "cssprop": "--nav-rail-active-label-color - Color of active labels. Defaults to on-surface.",
     "example": "```html\n<wc-navigation-rail>\n  <wc-navigation-rail-item active>\n    <wc-icon slot=\"icon\">home</wc-icon>\n    Home\n  </wc-navigation-rail-item>\n  <wc-navigation-rail-item>\n    <wc-icon slot=\"icon\">search</wc-icon>\n    Search\n  </wc-navigation-rail-item>\n  <wc-navigation-rail-item>\n    <wc-icon slot=\"icon\">settings</wc-icon>\n    Settings\n  </wc-navigation-rail-item>\n</wc-navigation-rail>\n```",
     "tags": "navigation",
@@ -11685,6 +12355,16 @@
           "name": "--nav-rail-active-label-color"
         }
       ],
+      "slots": [
+        {
+          "description": "Content displayed above the rail items.",
+          "name": "header"
+        },
+        {
+          "description": "Content pinned to the bottom of the rail.",
+          "name": "footer"
+        }
+      ],
       "members": [
         {
           "kind": "field",
@@ -11692,17 +12372,6 @@
           "static": true,
           "default": "NavigationRailItem"
         },
-        {
-          "kind": "field",
-          "name": "alignment",
-          "type": {
-            "text": "'top' | 'center' | 'bottom'"
-          },
-          "default": "'center'",
-          "description": "Vertical alignment of items within the rail.\n- `\"top\"`: Items align to the top.\n- `\"center\"`: Items are centered (default).\n- `\"bottom\"`: Items align to the bottom.",
-          "attribute": "alignment",
-          "reflects": true
-        },
         {
           "kind": "field",
           "name": "mode",
@@ -11746,15 +12415,6 @@
         }
       ],
       "attributes": [
-        {
-          "name": "alignment",
-          "type": {
-            "text": "'top' | 'center' | 'bottom'"
-          },
-          "default": "'center'",
-          "description": "Vertical alignment of items within the rail.\n- `\"top\"`: Items align to the top.\n- `\"center\"`: Items are centered (default).\n- `\"bottom\"`: Items align to the bottom.",
-          "fieldName": "alignment"
-        },
         {
           "name": "mode",
           "type": {
@@ -12547,8 +13207,8 @@
   },
   {
     "label": "Number Field",
-    "tag": "number-field",
-    "rawTag": "number",
+    "tag": "wc-number-field",
+    "rawTag": "number-field",
     "summary": "The Number Field component is used to capture numeric user input.",
     "example": "```html\n<wc-number-field label=\"Age\" placeholder=\"Enter your age\"></wc-number-field>\n```",
     "customElement": {
@@ -13053,11 +13713,11 @@
         "name": "BaseInput",
         "module": "/src/input/BaseInput.js"
       },
-      "tagName": "number-field",
+      "tagName": "wc-number-field",
       "customElement": true,
       "summary": "The Number Field component is used to capture numeric user input.",
       "rawTag": {
-        "name": "number",
+        "name": "number-field",
         "description": ""
       }
     }
@@ -17003,6 +17663,178 @@
       }
     }
   },
+  {
+    "label": "SVG",
+    "tag": "wc-svg",
+    "rawTag": "svg",
+    "summary": "An SVG component with lazy loading and optional preview support.",
+    "overview": "Renders an inline SVG fetched from a URL, with lazy loading via IntersectionObserver and an optional click-to-preview lightbox.",
+    "cssprop": "[--svg-size=1rem] - Controls the size of the SVG. Defaults to \"1rem\"",
+    "example": "```html\n<wc-svg src=\"/icons/my-icon.svg\" image-title=\"My icon\"></wc-svg>\n```",
+    "customElement": {
+      "kind": "class",
+      "description": "",
+      "name": "Svg",
+      "cssProperties": [
+        {
+          "description": "Controls the fill color of the SVG.",
+          "name": "--svg-color"
+        },
+        {
+          "description": "Controls the size of the SVG. Defaults to \"1rem\"",
+          "name": "--svg-size",
+          "default": "1rem"
+        }
+      ],
+      "members": [
+        {
+          "kind": "field",
+          "name": "src",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "URL of the SVG asset to fetch and render inline.",
+          "attribute": "src",
+          "reflects": true
+        },
+        {
+          "kind": "field",
+          "name": "imageTitle",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "Accessible title / alt text for the SVG.",
+          "attribute": "image-title"
+        },
+        {
+          "kind": "field",
+          "name": "preview",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "Enable click-to-preview lightbox.",
+          "attribute": "preview",
+          "reflects": true
+        },
+        {
+          "kind": "field",
+          "name": "_loaded",
+          "type": {
+            "text": "boolean"
+          },
+          "privacy": "private",
+          "default": "false"
+        },
+        {
+          "kind": "field",
+          "name": "_previewOpen",
+          "type": {
+            "text": "boolean"
+          },
+          "privacy": "private",
+          "default": "false"
+        },
+        {
+          "kind": "field",
+          "name": "_svgContent",
+          "type": {
+            "text": "string"
+          },
+          "privacy": "private",
+          "default": "''"
+        },
+        {
+          "kind": "field",
+          "name": "_fetchId",
+          "type": {
+            "text": "number"
+          },
+          "privacy": "private",
+          "default": "0"
+        },
+        {
+          "kind": "field",
+          "name": "_intersectionObserver",
+          "type": {
+            "text": "IntersectionObserver | null"
+          },
+          "privacy": "private",
+          "default": "null"
+        },
+        {
+          "kind": "method",
+          "name": "_setupIntersectionObserver",
+          "privacy": "private"
+        },
+        {
+          "kind": "method",
+          "name": "_fetchSvg",
+          "privacy": "private"
+        },
+        {
+          "kind": "method",
+          "name": "_handleClick",
+          "privacy": "private"
+        },
+        {
+          "kind": "method",
+          "name": "_closePreview",
+          "privacy": "private",
+          "parameters": [
+            {
+              "name": "e",
+              "type": {
+                "text": "Event"
+              }
+            }
+          ]
+        }
+      ],
+      "attributes": [
+        {
+          "name": "src",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "URL of the SVG asset to fetch and render inline.",
+          "fieldName": "src"
+        },
+        {
+          "name": "image-title",
+          "type": {
+            "text": "string"
+          },
+          "default": "''",
+          "description": "Accessible title / alt text for the SVG.",
+          "fieldName": "imageTitle"
+        },
+        {
+          "name": "preview",
+          "type": {
+            "text": "boolean"
+          },
+          "default": "false",
+          "description": "Enable click-to-preview lightbox.",
+          "fieldName": "preview"
+        }
+      ],
+      "superclass": {
+        "name": "LitElement",
+        "package": "lit"
+      },
+      "tagName": "wc-svg",
+      "customElement": true,
+      "summary": "An SVG component with lazy loading and optional preview support.",
+      "rawTag": {
+        "name": "svg",
+        "description": ""
+      }
+    }
+  },
   {
     "label": "Switch",
     "tag": "wc-switch",