@skdx/web-components-blocks 0.38.0 → 0.40.0

package/custom-elements.json

@@ -363,183 +363,483 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/comment/Comment.ts",
+      "path": "src/chat-composer/ChatComposer.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "One collaboration comment: author, avatar, timestamp, edited indicator,\narbitrary content, attachments and actions such as reply, edit and react.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-comment` on the host, then `__avatar`, `__main`, `__header`,\n`__author`, `__metadata`, `__time`, `__edited`, `__content`, `__attachments`\nand `__actions`.",
-          "name": "SkdxComment",
+          "description": "Message composer block: an auto-growing Textarea and a send Button inside a\nfield, with consumer-supplied attachment, leading, trailing and footer\nregions and configurable Enter-to-send behaviour.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-chat-composer` on the host, then `__attachments`, `__field`,\n`__leading`, `__textarea`, `__trailing`, `__send` and `__footer`.\n`data-state` on the host reads `pending` while a send is in flight.",
+          "name": "SkdxChatComposer",
           "slots": [
             {
-              "description": "The comment content, the consumer-supplied body text or markup.",
-              "name": ""
+              "description": "Controls rendered inside the field before the textarea, such as an attach button.",
+              "name": "leading"
             },
             {
-              "description": "Decorative avatar rendered beside the author, always `aria-hidden`.",
-              "name": "avatar"
+              "description": "Controls rendered inside the field after the textarea, such as a model picker.",
+              "name": "trailing"
             },
             {
-              "description": "Badges or supplementary text rendered beside the author.",
-              "name": "metadata"
+              "description": "Attached files or chips rendered in a row above the field.",
+              "name": "attachments"
             },
             {
-              "description": "Files or links attached to the comment, below the content.",
-              "name": "attachments"
+              "description": "Usage counters or hints rendered in a row below the field.",
+              "name": "footer"
             },
             {
-              "description": "Controls such as reply, edit and react, below the attachments.",
-              "name": "actions"
+              "description": "Glyph rendered inside the send button in place of its text, making it icon-only.",
+              "name": "send-icon"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "author",
+              "name": "value",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Current message text, for controlled usage paired with `value-change`.",
+              "default": "undefined",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "defaultValue",
               "type": {
                 "text": "string"
               },
-              "description": "Name of the person or system that wrote the comment, rendered as visible text.",
-              "attribute": "author",
-              "required": true
+              "default": "''",
+              "description": "Initial message text for uncontrolled usage, read only on mount.",
+              "attribute": "default-value"
             },
             {
               "kind": "field",
-              "name": "timestamp",
+              "name": "placeholder",
               "type": {
-                "text": "Date | string | undefined | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Instant the comment was posted, rendered through a composed Time.",
+              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
               "default": "undefined",
-              "attribute": "timestamp"
+              "attribute": "placeholder"
             },
             {
               "kind": "field",
-              "name": "now",
+              "name": "label",
               "type": {
-                "text": "Date | number | undefined | undefined"
+                "text": "string"
               },
-              "description": "Reference instant `timestamp` renders relative to, forwarded to Time.",
-              "default": "undefined"
+              "default": "'Message'",
+              "description": "Accessible name of the message textarea, read by assistive technology.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "edited",
+              "name": "sendLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Send'",
+              "description": "Text of the send button, and its accessible name when the `send-icon` slot is filled.",
+              "attribute": "send-label"
+            },
+            {
+              "kind": "field",
+              "name": "submitKey",
+              "type": {
+                "text": "SkdxChatComposerSubmitKey"
+              },
+              "default": "'enter'",
+              "description": "Which key sends from the textarea; the other Enter presses insert a newline.",
+              "attribute": "submit-key"
+            },
+            {
+              "kind": "field",
+              "name": "maxRows",
+              "type": {
+                "text": "number"
+              },
+              "default": "8",
+              "description": "Caps how far the auto-growing textarea grows, in rows, before it scrolls.",
+              "attribute": "max-rows"
+            },
+            {
+              "kind": "field",
+              "name": "maxLength",
+              "type": {
+                "text": "number | undefined | undefined"
+              },
+              "description": "Native `maxlength` of the textarea — the longest message it accepts.",
+              "default": "undefined",
+              "attribute": "max-length"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Marks the comment as edited since it was first posted.",
-              "attribute": "edited"
+              "description": "Disables the textarea and the send button, blocking every send path.",
+              "attribute": "disabled"
             },
             {
               "kind": "field",
-              "name": "editedLabel",
+              "name": "pending",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Edited'",
-              "description": "Text of the edited indicator, shown only when `edited` is set.",
-              "attribute": "edited-label"
+              "default": "false",
+              "description": "Marks a send in flight: the button is busy and inert, the textarea stays editable.",
+              "attribute": "pending"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fires with the new text on every edit, including the clear that follows an uncontrolled send.",
+              "name": "value-change"
+            },
+            {
+              "description": "Fires with the message text when the send button is activated or the configured submit key is pressed.",
+              "name": "send"
             }
           ],
           "attributes": [
             {
-              "name": "author",
+              "name": "value",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Current message text, for controlled usage paired with `value-change`.",
+              "default": "undefined",
+              "fieldName": "value"
+            },
+            {
+              "name": "default-value",
               "type": {
                 "text": "string"
               },
-              "description": "Name of the person or system that wrote the comment, rendered as visible text.",
-              "fieldName": "author",
-              "required": true
+              "default": "''",
+              "description": "Initial message text for uncontrolled usage, read only on mount.",
+              "fieldName": "defaultValue"
             },
             {
-              "name": "timestamp",
+              "name": "placeholder",
               "type": {
-                "text": "Date | string | undefined | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Instant the comment was posted, rendered through a composed Time.",
+              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
               "default": "undefined",
-              "fieldName": "timestamp"
+              "fieldName": "placeholder"
             },
             {
-              "name": "edited",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Message'",
+              "description": "Accessible name of the message textarea, read by assistive technology.",
+              "fieldName": "label"
+            },
+            {
+              "name": "send-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Send'",
+              "description": "Text of the send button, and its accessible name when the `send-icon` slot is filled.",
+              "fieldName": "sendLabel"
+            },
+            {
+              "name": "submit-key",
+              "type": {
+                "text": "SkdxChatComposerSubmitKey"
+              },
+              "default": "'enter'",
+              "description": "Which key sends from the textarea; the other Enter presses insert a newline.",
+              "fieldName": "submitKey"
+            },
+            {
+              "name": "max-rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "8",
+              "description": "Caps how far the auto-growing textarea grows, in rows, before it scrolls.",
+              "fieldName": "maxRows"
+            },
+            {
+              "name": "max-length",
+              "type": {
+                "text": "number | undefined | undefined"
+              },
+              "description": "Native `maxlength` of the textarea — the longest message it accepts.",
+              "default": "undefined",
+              "fieldName": "maxLength"
+            },
+            {
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Marks the comment as edited since it was first posted.",
-              "fieldName": "edited"
+              "description": "Disables the textarea and the send button, blocking every send path.",
+              "fieldName": "disabled"
             },
             {
-              "name": "edited-label",
+              "name": "pending",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Edited'",
-              "description": "Text of the edited indicator, shown only when `edited` is set.",
-              "fieldName": "editedLabel"
+              "default": "false",
+              "description": "Marks a send in flight: the button is busy and inert, the textarea stays editable.",
+              "fieldName": "pending"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-comment",
+          "tagName": "skdx-chat-composer",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxComment",
+          "name": "SkdxChatComposer",
           "declaration": {
-            "name": "SkdxComment",
-            "module": "src/comment/Comment.ts"
+            "name": "SkdxChatComposer",
+            "module": "src/chat-composer/ChatComposer.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-comment",
+          "name": "skdx-chat-composer",
           "declaration": {
-            "name": "SkdxComment",
-            "module": "src/comment/Comment.ts"
+            "name": "SkdxChatComposer",
+            "module": "src/chat-composer/ChatComposer.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/comment/index.ts",
+      "path": "src/chat-composer/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxComment",
+          "name": "SkdxChatComposer",
           "declaration": {
-            "name": "SkdxComment",
-            "module": "./Comment"
+            "name": "SkdxChatComposer",
+            "module": "./ChatComposer"
           }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/chat-message/ChatMessage.ts",
-      "declarations": [
+        },
         {
-          "kind": "class",
-          "description": "One message in a conversation — assistant, support agent, human or system —\nwith an author, avatar, timestamp, delivery status, content, attachments,\nactions and a footer, composing Time; the block parses nothing.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-chat-message` on the host, then `__avatar`, `__main`,\n`__header`, `__author`, `__time`, `__status`, `__content`, `__attachments`,\n`__footer` and `__actions`. `data-sender` and `data-status` sit on the host\nfor the skin to read.",
-          "name": "SkdxChatMessage",
-          "slots": [
-            {
-              "description": "The message content: markdown output, code, citations or tool results.",
-              "name": ""
-            },
-            {
-              "description": "Decorative avatar rendered beside the message, always `aria-hidden`.",
-              "name": "avatar"
-            },
-            {
+          "kind": "js",
+          "name": "SkdxChatComposerSendDetail",
+          "declaration": {
+            "name": "SkdxChatComposerSendDetail",
+            "module": "./ChatComposer"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxChatComposerSubmitKey",
+          "declaration": {
+            "name": "SkdxChatComposerSubmitKey",
+            "module": "./ChatComposer"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxChatComposerValueChangeDetail",
+          "declaration": {
+            "name": "SkdxChatComposerValueChangeDetail",
+            "module": "./ChatComposer"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/comment/Comment.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "One collaboration comment: author, avatar, timestamp, edited indicator,\narbitrary content, attachments and actions such as reply, edit and react.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-comment` on the host, then `__avatar`, `__main`, `__header`,\n`__author`, `__metadata`, `__time`, `__edited`, `__content`, `__attachments`\nand `__actions`.",
+          "name": "SkdxComment",
+          "slots": [
+            {
+              "description": "The comment content, the consumer-supplied body text or markup.",
+              "name": ""
+            },
+            {
+              "description": "Decorative avatar rendered beside the author, always `aria-hidden`.",
+              "name": "avatar"
+            },
+            {
+              "description": "Badges or supplementary text rendered beside the author.",
+              "name": "metadata"
+            },
+            {
+              "description": "Files or links attached to the comment, below the content.",
+              "name": "attachments"
+            },
+            {
+              "description": "Controls such as reply, edit and react, below the attachments.",
+              "name": "actions"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "author",
+              "type": {
+                "text": "string"
+              },
+              "description": "Name of the person or system that wrote the comment, rendered as visible text.",
+              "attribute": "author",
+              "required": true
+            },
+            {
+              "kind": "field",
+              "name": "timestamp",
+              "type": {
+                "text": "Date | string | undefined | undefined"
+              },
+              "description": "Instant the comment was posted, rendered through a composed Time.",
+              "default": "undefined",
+              "attribute": "timestamp"
+            },
+            {
+              "kind": "field",
+              "name": "now",
+              "type": {
+                "text": "Date | number | undefined | undefined"
+              },
+              "description": "Reference instant `timestamp` renders relative to, forwarded to Time.",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "edited",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the comment as edited since it was first posted.",
+              "attribute": "edited"
+            },
+            {
+              "kind": "field",
+              "name": "editedLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Edited'",
+              "description": "Text of the edited indicator, shown only when `edited` is set.",
+              "attribute": "edited-label"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "author",
+              "type": {
+                "text": "string"
+              },
+              "description": "Name of the person or system that wrote the comment, rendered as visible text.",
+              "fieldName": "author",
+              "required": true
+            },
+            {
+              "name": "timestamp",
+              "type": {
+                "text": "Date | string | undefined | undefined"
+              },
+              "description": "Instant the comment was posted, rendered through a composed Time.",
+              "default": "undefined",
+              "fieldName": "timestamp"
+            },
+            {
+              "name": "edited",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the comment as edited since it was first posted.",
+              "fieldName": "edited"
+            },
+            {
+              "name": "edited-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Edited'",
+              "description": "Text of the edited indicator, shown only when `edited` is set.",
+              "fieldName": "editedLabel"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "skdx-comment",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxComment",
+          "declaration": {
+            "name": "SkdxComment",
+            "module": "src/comment/Comment.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "skdx-comment",
+          "declaration": {
+            "name": "SkdxComment",
+            "module": "src/comment/Comment.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/comment/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxComment",
+          "declaration": {
+            "name": "SkdxComment",
+            "module": "./Comment"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/chat-message/ChatMessage.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "One message in a conversation — assistant, support agent, human or system —\nwith an author, avatar, timestamp, delivery status, content, attachments,\nactions and a footer, composing Time; the block parses nothing.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-chat-message` on the host, then `__avatar`, `__main`,\n`__header`, `__author`, `__time`, `__status`, `__content`, `__attachments`,\n`__footer` and `__actions`. `data-sender` and `data-status` sit on the host\nfor the skin to read.",
+          "name": "SkdxChatMessage",
+          "slots": [
+            {
+              "description": "The message content: markdown output, code, citations or tool results.",
+              "name": ""
+            },
+            {
+              "description": "Decorative avatar rendered beside the message, always `aria-hidden`.",
+              "name": "avatar"
+            },
+            {
               "description": "Files, links or previews attached to the message, below the content.",
               "name": "attachments"
             },
@@ -704,199 +1004,45 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/comment-thread/CommentThread.ts",
+      "path": "src/conversation-list/ConversationList.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A root comment with its replies, indented one level, collapsible with the\nconsumer's own labels, plus regions for a load-more control and a composer.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-comment-thread` on the host, then `__comment`, `__toggle`,\n`__replies`, `__load-more` and `__composer`. `data-state` on the host reads\n`expanded` or `collapsed`.",
-          "name": "SkdxCommentThread",
-          "slots": [
-            {
-              "description": "The root comment this thread replies to.",
-              "name": ""
-            },
-            {
-              "description": "The reply comments, indented one level below the root comment.",
-              "name": "replies"
-            },
-            {
-              "description": "Control that requests more replies, below the replies region.",
-              "name": "load-more"
-            },
-            {
-              "description": "Reply composer rendered at the end of the thread.",
-              "name": "composer"
-            }
-          ],
+          "description": "Conversation navigation block: a single-select listbox of threads with a\ntitle, preview, relative timestamp, unread mark and badge, plus grouping and\nits own loading and empty states. It routes nowhere — it reports the chosen\nconversation and the consumer navigates.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-conversation-list` on the host, then `__loading`, `__empty`,\n`__list`, `__group`, `__group-label`, `__item`, `__leading`, `__body`,\n`__title`, `__preview`, `__meta`, `__time` and `__badge`. `data-unread` sits\non a row that has not been read.",
+          "name": "SkdxConversationList",
           "members": [
             {
               "kind": "field",
-              "name": "expanded",
+              "name": "items",
               "type": {
-                "text": "boolean | undefined | undefined"
+                "text": "readonly SkdxConversationListItem[]"
               },
-              "description": "Whether the replies are shown, for controlled usage paired with `expanded-change`.",
-              "default": "undefined",
-              "attribute": "expanded"
+              "description": "The conversations to render, in order, each one a selectable option keyed by its id.",
+              "required": true
             },
             {
               "kind": "field",
-              "name": "defaultExpanded",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined | undefined"
               },
-              "default": "true",
-              "description": "Whether the replies start shown, used only while uncontrolled.",
-              "attribute": "default-expanded"
+              "description": "Selected conversation's id, for controlled usage paired with `value-change`.",
+              "default": "undefined",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "showRepliesLabel",
+              "name": "defaultValue",
               "type": {
                 "text": "string | undefined | undefined"
               },
-              "description": "Text of the toggle button while the replies are hidden; a toggle only renders when this is given.",
+              "description": "Conversation selected on first render, used only while uncontrolled.",
               "default": "undefined",
-              "attribute": "show-replies-label"
+              "attribute": "default-value"
             },
             {
               "kind": "field",
-              "name": "hideRepliesLabel",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Text of the toggle button while the replies are shown.",
-              "default": "undefined",
-              "attribute": "hide-replies-label"
-            }
-          ],
-          "events": [
-            {
-              "description": "Fires with the new expanded state whenever the replies toggle is activated.",
-              "name": "expanded-change"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "expanded",
-              "type": {
-                "text": "boolean | undefined | undefined"
-              },
-              "description": "Whether the replies are shown, for controlled usage paired with `expanded-change`.",
-              "default": "undefined",
-              "fieldName": "expanded"
-            },
-            {
-              "name": "default-expanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Whether the replies start shown, used only while uncontrolled.",
-              "fieldName": "defaultExpanded"
-            },
-            {
-              "name": "show-replies-label",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Text of the toggle button while the replies are hidden; a toggle only renders when this is given.",
-              "default": "undefined",
-              "fieldName": "showRepliesLabel"
-            },
-            {
-              "name": "hide-replies-label",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Text of the toggle button while the replies are shown.",
-              "default": "undefined",
-              "fieldName": "hideRepliesLabel"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "skdx-comment-thread",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxCommentThread",
-          "declaration": {
-            "name": "SkdxCommentThread",
-            "module": "src/comment-thread/CommentThread.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "skdx-comment-thread",
-          "declaration": {
-            "name": "SkdxCommentThread",
-            "module": "src/comment-thread/CommentThread.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/comment-thread/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxCommentThread",
-          "declaration": {
-            "name": "SkdxCommentThread",
-            "module": "./CommentThread"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/conversation-list/ConversationList.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Conversation navigation block: a single-select listbox of threads with a\ntitle, preview, relative timestamp, unread mark and badge, plus grouping and\nits own loading and empty states. It routes nowhere — it reports the chosen\nconversation and the consumer navigates.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-conversation-list` on the host, then `__loading`, `__empty`,\n`__list`, `__group`, `__group-label`, `__item`, `__leading`, `__body`,\n`__title`, `__preview`, `__meta`, `__time` and `__badge`. `data-unread` sits\non a row that has not been read.",
-          "name": "SkdxConversationList",
-          "members": [
-            {
-              "kind": "field",
-              "name": "items",
-              "type": {
-                "text": "readonly SkdxConversationListItem[]"
-              },
-              "description": "The conversations to render, in order, each one a selectable option keyed by its id.",
-              "required": true
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Selected conversation's id, for controlled usage paired with `value-change`.",
-              "default": "undefined",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "defaultValue",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Conversation selected on first render, used only while uncontrolled.",
-              "default": "undefined",
-              "attribute": "default-value"
-            },
-            {
-              "kind": "field",
-              "name": "label",
+              "name": "label",
               "type": {
                 "text": "string"
               },
@@ -1094,210 +1240,174 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/dashboard-layout/DashboardLayout.ts",
+      "path": "src/comment-thread/CommentThread.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Application shell block: an app bar, a collapsible side navigation and the content region.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-dashboard-layout` on the host, then `__app-bar`,\n`__nav-toggle`, `__branding`, `__title`, `__actions`, `__body`, `__nav`,\n`__nav-list`, `__nav-item`, `__nav-header`, `__nav-divider` and `__content`.\n`data-nav-open` sits on the host while the navigation is shown.",
-          "name": "SkdxDashboardLayout",
+          "description": "A root comment with its replies, indented one level, collapsible with the\nconsumer's own labels, plus regions for a load-more control and a composer.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-comment-thread` on the host, then `__comment`, `__toggle`,\n`__replies`, `__load-more` and `__composer`. `data-state` on the host reads\n`expanded` or `collapsed`.",
+          "name": "SkdxCommentThread",
           "slots": [
             {
-              "description": "The page content rendered inside the `<main>` region.",
+              "description": "The root comment this thread replies to.",
               "name": ""
             },
             {
-              "description": "Logo or product mark at the start of the app bar.",
-              "name": "branding"
+              "description": "The reply comments, indented one level below the root comment.",
+              "name": "replies"
             },
             {
-              "description": "Controls at the end of the app bar.",
-              "name": "actions"
+              "description": "Control that requests more replies, below the replies region.",
+              "name": "load-more"
+            },
+            {
+              "description": "Reply composer rendered at the end of the thread.",
+              "name": "composer"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Application title shown in the app bar after the branding, shadowing the native tooltip attribute.",
-              "attribute": "title"
-            },
-            {
-              "kind": "field",
-              "name": "navigation",
-              "type": {
-                "text": "readonly SkdxDashboardNavigationItem[]"
-              },
-              "description": "The side navigation, one entry per row, nested through each entry's `children`.",
-              "required": true
-            },
-            {
-              "kind": "field",
-              "name": "navOpen",
+              "name": "expanded",
               "type": {
-                "text": "boolean | undefined"
+                "text": "boolean | undefined | undefined"
               },
-              "description": "Whether the side navigation is shown, for controlled usage.",
+              "description": "Whether the replies are shown, for controlled usage paired with `expanded-change`.",
               "default": "undefined",
-              "attribute": "nav-open"
+              "attribute": "expanded"
             },
             {
               "kind": "field",
-              "name": "defaultNavOpen",
+              "name": "defaultExpanded",
               "type": {
                 "text": "boolean"
               },
               "default": "true",
-              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
-              "attribute": "default-nav-open"
+              "description": "Whether the replies start shown, used only while uncontrolled.",
+              "attribute": "default-expanded"
             },
             {
               "kind": "field",
-              "name": "navLabel",
+              "name": "showRepliesLabel",
               "type": {
-                "text": "string"
+                "text": "string | undefined | undefined"
               },
-              "default": "'Main navigation'",
-              "description": "Accessible name of the side navigation landmark.",
-              "attribute": "nav-label"
+              "description": "Text of the toggle button while the replies are hidden; a toggle only renders when this is given.",
+              "default": "undefined",
+              "attribute": "show-replies-label"
             },
             {
               "kind": "field",
-              "name": "navToggleLabel",
+              "name": "hideRepliesLabel",
               "type": {
-                "text": "string"
+                "text": "string | undefined | undefined"
               },
-              "default": "'Toggle navigation'",
-              "description": "Accessible name of the icon-only button that shows and hides the navigation.",
-              "attribute": "nav-toggle-label"
+              "description": "Text of the toggle button while the replies are shown.",
+              "default": "undefined",
+              "attribute": "hide-replies-label"
             }
           ],
           "events": [
             {
-              "description": "Fires with the new open state whenever the navigation toggle is activated.",
-              "name": "nav-open-change"
+              "description": "Fires with the new expanded state whenever the replies toggle is activated.",
+              "name": "expanded-change"
             }
           ],
           "attributes": [
             {
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Application title shown in the app bar after the branding, shadowing the native tooltip attribute.",
-              "fieldName": "title"
-            },
-            {
-              "name": "nav-open",
+              "name": "expanded",
               "type": {
-                "text": "boolean | undefined"
+                "text": "boolean | undefined | undefined"
               },
-              "description": "Whether the side navigation is shown, for controlled usage.",
+              "description": "Whether the replies are shown, for controlled usage paired with `expanded-change`.",
               "default": "undefined",
-              "fieldName": "navOpen"
+              "fieldName": "expanded"
             },
             {
-              "name": "default-nav-open",
+              "name": "default-expanded",
               "type": {
                 "text": "boolean"
               },
               "default": "true",
-              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
-              "fieldName": "defaultNavOpen"
+              "description": "Whether the replies start shown, used only while uncontrolled.",
+              "fieldName": "defaultExpanded"
             },
             {
-              "name": "nav-label",
+              "name": "show-replies-label",
               "type": {
-                "text": "string"
+                "text": "string | undefined | undefined"
               },
-              "default": "'Main navigation'",
-              "description": "Accessible name of the side navigation landmark.",
-              "fieldName": "navLabel"
+              "description": "Text of the toggle button while the replies are hidden; a toggle only renders when this is given.",
+              "default": "undefined",
+              "fieldName": "showRepliesLabel"
             },
             {
-              "name": "nav-toggle-label",
+              "name": "hide-replies-label",
               "type": {
-                "text": "string"
+                "text": "string | undefined | undefined"
               },
-              "default": "'Toggle navigation'",
-              "description": "Accessible name of the icon-only button that shows and hides the navigation.",
-              "fieldName": "navToggleLabel"
+              "description": "Text of the toggle button while the replies are shown.",
+              "default": "undefined",
+              "fieldName": "hideRepliesLabel"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-dashboard-layout",
+          "tagName": "skdx-comment-thread",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxDashboardLayout",
+          "name": "SkdxCommentThread",
           "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "src/dashboard-layout/DashboardLayout.ts"
+            "name": "SkdxCommentThread",
+            "module": "src/comment-thread/CommentThread.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-dashboard-layout",
+          "name": "skdx-comment-thread",
           "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "src/dashboard-layout/DashboardLayout.ts"
+            "name": "SkdxCommentThread",
+            "module": "src/comment-thread/CommentThread.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/dashboard-layout/index.ts",
+      "path": "src/comment-thread/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxDashboardLayout",
-          "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "./DashboardLayout"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxDashboardNavigationItem",
+          "name": "SkdxCommentThread",
           "declaration": {
-            "name": "SkdxDashboardNavigationItem",
-            "module": "./DashboardLayout"
+            "name": "SkdxCommentThread",
+            "module": "./CommentThread"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/empty-state/EmptyState.ts",
+      "path": "src/forgot-password-page/ForgotPasswordPage.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Placeholder block for a region with nothing to show — no content yet, no\nresults, first use, or disconnected — composing a Heading, a Text\ndescription and consumer-supplied icon and actions.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-empty-state` on the host, then `__icon`, `__title`,\n`__description`, `__content` and `__actions`. `data-size` and `data-align`\nsit on the host for the skin to read.",
-          "name": "SkdxEmptyState",
+          "description": "Forgot-password block: a description, one email field and a submit button,\nreplaced entirely by a success alert once the request is accepted.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-forgot-password-page` on the host, then `__panel`,\n`__title`, `__description`, `__error`, `__success`, `__form`, `__field`,\n`__submit` and `__footer`.",
+          "name": "SkdxForgotPasswordPage",
           "slots": [
             {
-              "description": "Extra content rendered between the description and the actions region.",
+              "description": "Extra fields rendered inside the form, above the submit button.",
               "name": ""
             },
             {
-              "description": "Decorative illustration or glyph rendered above the title.",
-              "name": "icon"
-            },
-            {
-              "description": "Primary and secondary controls rendered below the content.",
-              "name": "actions"
+              "description": "Navigation below the form, such as a link back to the sign-in page.",
+              "name": "footer"
             }
           ],
           "members": [
@@ -1307,403 +1417,417 @@
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the empty region, rendered into a derived Heading.",
-              "attribute": "title",
-              "required": true
+              "default": "'Reset your password'",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
               "name": "description",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "string | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
+              "description": "Supporting copy rendered below the title, explaining what the reset link does.",
               "default": "undefined",
               "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "headingLevel",
+              "name": "error",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "string | undefined"
               },
-              "default": "3",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
-              "attribute": "heading-level"
+              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
+              "default": "undefined",
+              "attribute": "error"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "success",
               "type": {
-                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
+                "text": "string | undefined"
               },
-              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
+              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
               "default": "undefined",
-              "attribute": "size"
+              "attribute": "success"
             },
             {
               "kind": "field",
-              "name": "align",
+              "name": "pending",
               "type": {
-                "text": "'center' | 'start' | (string & {})"
+                "text": "boolean"
               },
-              "default": "'center'",
-              "description": "Text and content alignment rung, written to `data-align` on the host.",
-              "attribute": "align"
+              "default": "false",
+              "description": "Marks the request in flight, making the submit button busy while the email field stays editable.",
+              "attribute": "pending"
+            },
+            {
+              "kind": "field",
+              "name": "emailLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Email'",
+              "description": "Label of the email field the reset link is requested for.",
+              "attribute": "email-label"
+            },
+            {
+              "kind": "field",
+              "name": "submitLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Send reset link'",
+              "description": "Text of the form's submit button.",
+              "attribute": "submit-label"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fires with `{ email }` when the form submits with an address that passes constraint validation.",
+              "name": "request-reset"
             }
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the empty region, rendered into a derived Heading.",
-              "fieldName": "title",
-              "required": true
+              "default": "'Reset your password'",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "fieldName": "title"
             },
             {
               "name": "description",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "string | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
+              "description": "Supporting copy rendered below the title, explaining what the reset link does.",
               "default": "undefined",
               "fieldName": "description"
             },
             {
-              "name": "heading-level",
+              "name": "error",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "string | undefined"
               },
-              "default": "3",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
-              "fieldName": "headingLevel"
+              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
+              "default": "undefined",
+              "fieldName": "error"
             },
             {
-              "name": "size",
+              "name": "success",
               "type": {
-                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
+                "text": "string | undefined"
               },
-              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
+              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
               "default": "undefined",
-              "fieldName": "size"
+              "fieldName": "success"
             },
             {
-              "name": "align",
+              "name": "pending",
               "type": {
-                "text": "'center' | 'start' | (string & {})"
+                "text": "boolean"
               },
-              "default": "'center'",
-              "description": "Text and content alignment rung, written to `data-align` on the host.",
-              "fieldName": "align"
+              "default": "false",
+              "description": "Marks the request in flight, making the submit button busy while the email field stays editable.",
+              "fieldName": "pending"
+            },
+            {
+              "name": "email-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Email'",
+              "description": "Label of the email field the reset link is requested for.",
+              "fieldName": "emailLabel"
+            },
+            {
+              "name": "submit-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Send reset link'",
+              "description": "Text of the form's submit button.",
+              "fieldName": "submitLabel"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-empty-state",
+          "tagName": "skdx-forgot-password-page",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxEmptyState",
+          "name": "SkdxForgotPasswordPage",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "src/empty-state/EmptyState.ts"
+            "name": "SkdxForgotPasswordPage",
+            "module": "src/forgot-password-page/ForgotPasswordPage.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-empty-state",
+          "name": "skdx-forgot-password-page",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "src/empty-state/EmptyState.ts"
+            "name": "SkdxForgotPasswordPage",
+            "module": "src/forgot-password-page/ForgotPasswordPage.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/empty-state/index.ts",
+      "path": "src/forgot-password-page/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxEmptyState",
+          "name": "SkdxForgotPasswordPage",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "./EmptyState"
+            "name": "SkdxForgotPasswordPage",
+            "module": "./ForgotPasswordPage"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxForgotPasswordDetail",
+          "declaration": {
+            "name": "SkdxForgotPasswordDetail",
+            "module": "./ForgotPasswordPage"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/filter-bar/FilterBar.ts",
+      "path": "src/dashboard-layout/DashboardLayout.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Filtering surface above a table, list, card grid or report: a search field,\nthe consumer's filter controls, the applied filters as removable tags, and a\nclear action. Composes TextField, TagGroup and Button.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-filter-bar` on the host, then `__search`, `__filters`,\n`__actions`, `__active`, `__tags` and `__clear`.",
-          "name": "SkdxFilterBar",
+          "description": "Application shell block: an app bar, a collapsible side navigation and the content region.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-dashboard-layout` on the host, then `__app-bar`,\n`__nav-toggle`, `__branding`, `__title`, `__actions`, `__body`, `__nav`,\n`__nav-list`, `__nav-item`, `__nav-header`, `__nav-divider` and `__content`.\n`data-nav-open` sits on the host while the navigation is shown.",
+          "name": "SkdxDashboardLayout",
           "slots": [
             {
-              "description": "The consumer's filter controls, laid out in the filters region.",
+              "description": "The page content rendered inside the `<main>` region.",
               "name": ""
             },
             {
-              "description": "Controls rendered at the end of the bar, such as a \"Save view\" button.",
+              "description": "Logo or product mark at the start of the app bar.",
+              "name": "branding"
+            },
+            {
+              "description": "Controls at the end of the app bar.",
               "name": "actions"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "label",
+              "name": "title",
               "type": {
                 "text": "string"
               },
-              "default": "'Filters'",
-              "description": "Accessible name of the root region, written to `aria-label`.",
-              "attribute": "label"
+              "default": "''",
+              "description": "Application title shown in the app bar after the branding. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
-              "name": "searchLabel",
+              "name": "navigation",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "readonly SkdxDashboardNavigationItem[]"
               },
-              "description": "Accessible name of the search field; providing it renders the search region.",
-              "default": "undefined",
-              "attribute": "search-label"
+              "description": "The side navigation, one entry per row, nested through each entry's `children`.",
+              "required": true
             },
             {
               "kind": "field",
-              "name": "searchPlaceholder",
+              "name": "contentAs",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "'main' | 'div'"
               },
-              "description": "Placeholder shown in the empty search field.",
-              "default": "undefined",
-              "attribute": "search-placeholder"
+              "default": "'main'",
+              "description": "Content element: use `div` when embedding inside an existing page main landmark.",
+              "attribute": "content-as"
             },
             {
               "kind": "field",
-              "name": "searchValue",
+              "name": "navOpen",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "boolean | undefined"
               },
-              "description": "Current search text, for controlled usage; pair it with `search-value-change`.",
+              "description": "Whether the side navigation is shown, for controlled usage.",
               "default": "undefined",
-              "attribute": "search-value"
+              "attribute": "nav-open"
             },
             {
               "kind": "field",
-              "name": "defaultSearchValue",
+              "name": "defaultNavOpen",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Initial search text, for uncontrolled usage — seeds the internally tracked value.",
-              "attribute": "default-search-value"
+              "default": "true",
+              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
+              "attribute": "default-nav-open"
             },
             {
               "kind": "field",
-              "name": "clearSearchLabel",
+              "name": "navLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Clear search'",
-              "description": "Accessible name of the search field's clear button.",
-              "attribute": "clear-search-label"
+              "default": "'Main navigation'",
+              "description": "Accessible name of the side navigation landmark.",
+              "attribute": "nav-label"
             },
             {
               "kind": "field",
-              "name": "activeFilters",
+              "name": "navToggleLabel",
               "type": {
-                "text": "readonly SkdxFilterBarFilter[] | undefined | undefined"
+                "text": "string"
               },
-              "description": "The applied filters, in display order, rendered as removable tags.",
-              "default": "undefined"
-            },
-            {
-              "kind": "field",
-              "name": "activeFiltersLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Active filters'",
-              "description": "Accessible name of the active-filters tag list.",
-              "attribute": "active-filters-label"
-            },
-            {
-              "kind": "field",
-              "name": "clearLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Clear filters'",
-              "description": "Text rendered on the clear-filters button.",
-              "attribute": "clear-label"
+              "default": "'Toggle navigation'",
+              "description": "Accessible name of the icon-only button that shows and hides the navigation.",
+              "attribute": "nav-toggle-label"
             }
           ],
           "events": [
             {
-              "description": "Fires with the new text whenever the search field changes, controlled or not.",
-              "name": "search-value-change"
-            },
-            {
-              "description": "Fires with the removed filter when its tag's remove control is activated.",
-              "name": "remove-filter"
-            },
-            {
-              "description": "Fires when the clear-filters button is activated while filters are shown.",
-              "name": "clear"
+              "description": "Fires with the new open state whenever the navigation toggle is activated.",
+              "name": "nav-open-change"
             }
           ],
           "attributes": [
             {
-              "name": "label",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "default": "'Filters'",
-              "description": "Accessible name of the root region, written to `aria-label`.",
-              "fieldName": "label"
-            },
-            {
-              "name": "search-label",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Accessible name of the search field; providing it renders the search region.",
-              "default": "undefined",
-              "fieldName": "searchLabel"
+              "default": "''",
+              "description": "Application title shown in the app bar after the branding. The JavaScript property is `title`.",
+              "fieldName": "title"
             },
             {
-              "name": "search-placeholder",
+              "name": "content-as",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "'main' | 'div'"
               },
-              "description": "Placeholder shown in the empty search field.",
-              "default": "undefined",
-              "fieldName": "searchPlaceholder"
+              "default": "'main'",
+              "description": "Content element: use `div` when embedding inside an existing page main landmark.",
+              "fieldName": "contentAs"
             },
             {
-              "name": "search-value",
+              "name": "nav-open",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "boolean | undefined"
               },
-              "description": "Current search text, for controlled usage; pair it with `search-value-change`.",
+              "description": "Whether the side navigation is shown, for controlled usage.",
               "default": "undefined",
-              "fieldName": "searchValue"
-            },
-            {
-              "name": "default-search-value",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Initial search text, for uncontrolled usage — seeds the internally tracked value.",
-              "fieldName": "defaultSearchValue"
+              "fieldName": "navOpen"
             },
             {
-              "name": "clear-search-label",
+              "name": "default-nav-open",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'Clear search'",
-              "description": "Accessible name of the search field's clear button.",
-              "fieldName": "clearSearchLabel"
+              "default": "true",
+              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
+              "fieldName": "defaultNavOpen"
             },
             {
-              "name": "active-filters-label",
+              "name": "nav-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Active filters'",
-              "description": "Accessible name of the active-filters tag list.",
-              "fieldName": "activeFiltersLabel"
+              "default": "'Main navigation'",
+              "description": "Accessible name of the side navigation landmark.",
+              "fieldName": "navLabel"
             },
             {
-              "name": "clear-label",
+              "name": "nav-toggle-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Clear filters'",
-              "description": "Text rendered on the clear-filters button.",
-              "fieldName": "clearLabel"
+              "default": "'Toggle navigation'",
+              "description": "Accessible name of the icon-only button that shows and hides the navigation.",
+              "fieldName": "navToggleLabel"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-filter-bar",
+          "tagName": "skdx-dashboard-layout",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxFilterBar",
+          "name": "SkdxDashboardLayout",
           "declaration": {
-            "name": "SkdxFilterBar",
-            "module": "src/filter-bar/FilterBar.ts"
+            "name": "SkdxDashboardLayout",
+            "module": "src/dashboard-layout/DashboardLayout.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-filter-bar",
+          "name": "skdx-dashboard-layout",
           "declaration": {
-            "name": "SkdxFilterBar",
-            "module": "src/filter-bar/FilterBar.ts"
+            "name": "SkdxDashboardLayout",
+            "module": "src/dashboard-layout/DashboardLayout.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/filter-bar/index.ts",
+      "path": "src/dashboard-layout/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxFilterBar",
+          "name": "SkdxDashboardLayout",
           "declaration": {
-            "name": "SkdxFilterBar",
-            "module": "./FilterBar"
+            "name": "SkdxDashboardLayout",
+            "module": "./DashboardLayout"
           }
         },
         {
           "kind": "js",
-          "name": "SkdxFilterBarFilter",
+          "name": "SkdxDashboardNavigationItem",
           "declaration": {
-            "name": "SkdxFilterBarFilter",
-            "module": "./FilterBar"
+            "name": "SkdxDashboardNavigationItem",
+            "module": "./DashboardLayout"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/forgot-password-page/ForgotPasswordPage.ts",
+      "path": "src/empty-state/EmptyState.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Forgot-password block: a description, one email field and a submit button,\nreplaced entirely by a success alert once the request is accepted.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-forgot-password-page` on the host, then `__panel`,\n`__title`, `__description`, `__error`, `__success`, `__form`, `__field`,\n`__submit` and `__footer`.",
-          "name": "SkdxForgotPasswordPage",
+          "description": "Placeholder block for a region with nothing to show — no content yet, no\nresults, first use, or disconnected — composing a Heading, a Text\ndescription and consumer-supplied icon and actions.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-empty-state` on the host, then `__icon`, `__title`,\n`__description`, `__content` and `__actions`. `data-size` and `data-align`\nsit on the host for the skin to read.",
+          "name": "SkdxEmptyState",
           "slots": [
             {
-              "description": "Extra fields rendered inside the form, above the submit button.",
+              "description": "Extra content rendered between the description and the actions region.",
               "name": ""
             },
             {
-              "description": "Navigation below the form, such as a link back to the sign-in page.",
-              "name": "footer"
+              "description": "Decorative illustration or glyph rendered above the title.",
+              "name": "icon"
+            },
+            {
+              "description": "Primary and secondary controls rendered below the content.",
+              "name": "actions"
             }
           ],
           "members": [
@@ -1713,628 +1837,523 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Reset your password'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "attribute": "title"
+              "description": "Heading text naming the empty region, rendered into a derived Heading. The JavaScript property is `title`.",
+              "attribute": "heading",
+              "required": true
             },
             {
               "kind": "field",
               "name": "description",
               "type": {
-                "text": "string | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining what the reset link does.",
+              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
               "default": "undefined",
               "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "error",
+              "name": "headingLevel",
               "type": {
-                "text": "string | undefined"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
-              "default": "undefined",
-              "attribute": "error"
+              "default": "3",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
+              "attribute": "heading-level"
             },
             {
               "kind": "field",
-              "name": "success",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
               },
-              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
+              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
               "default": "undefined",
-              "attribute": "success"
-            },
-            {
-              "kind": "field",
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the request in flight, making the submit button busy while the email field stays editable.",
-              "attribute": "pending"
-            },
-            {
-              "kind": "field",
-              "name": "emailLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Email'",
-              "description": "Label of the email field the reset link is requested for.",
-              "attribute": "email-label"
+              "attribute": "size"
             },
             {
               "kind": "field",
-              "name": "submitLabel",
+              "name": "align",
               "type": {
-                "text": "string"
+                "text": "'center' | 'start' | (string & {})"
               },
-              "default": "'Send reset link'",
-              "description": "Text of the form's submit button.",
-              "attribute": "submit-label"
-            }
-          ],
-          "events": [
-            {
-              "description": "Fires with `{ email }` when the form submits with an address that passes constraint validation.",
-              "name": "request-reset"
+              "default": "'center'",
+              "description": "Text and content alignment rung, written to `data-align` on the host.",
+              "attribute": "align"
             }
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "default": "'Reset your password'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "fieldName": "title"
+              "description": "Heading text naming the empty region, rendered into a derived Heading. The JavaScript property is `title`.",
+              "fieldName": "title",
+              "required": true
             },
             {
               "name": "description",
               "type": {
-                "text": "string | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining what the reset link does.",
+              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
               "default": "undefined",
               "fieldName": "description"
             },
             {
-              "name": "error",
+              "name": "heading-level",
               "type": {
-                "text": "string | undefined"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
-              "default": "undefined",
-              "fieldName": "error"
+              "default": "3",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
+              "fieldName": "headingLevel"
             },
             {
-              "name": "success",
+              "name": "size",
               "type": {
-                "text": "string | undefined"
+                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
               },
-              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
+              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
               "default": "undefined",
-              "fieldName": "success"
-            },
-            {
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the request in flight, making the submit button busy while the email field stays editable.",
-              "fieldName": "pending"
-            },
-            {
-              "name": "email-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Email'",
-              "description": "Label of the email field the reset link is requested for.",
-              "fieldName": "emailLabel"
+              "fieldName": "size"
             },
             {
-              "name": "submit-label",
+              "name": "align",
               "type": {
-                "text": "string"
+                "text": "'center' | 'start' | (string & {})"
               },
-              "default": "'Send reset link'",
-              "description": "Text of the form's submit button.",
-              "fieldName": "submitLabel"
+              "default": "'center'",
+              "description": "Text and content alignment rung, written to `data-align` on the host.",
+              "fieldName": "align"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-forgot-password-page",
+          "tagName": "skdx-empty-state",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxForgotPasswordPage",
+          "name": "SkdxEmptyState",
           "declaration": {
-            "name": "SkdxForgotPasswordPage",
-            "module": "src/forgot-password-page/ForgotPasswordPage.ts"
+            "name": "SkdxEmptyState",
+            "module": "src/empty-state/EmptyState.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-forgot-password-page",
+          "name": "skdx-empty-state",
           "declaration": {
-            "name": "SkdxForgotPasswordPage",
-            "module": "src/forgot-password-page/ForgotPasswordPage.ts"
+            "name": "SkdxEmptyState",
+            "module": "src/empty-state/EmptyState.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/forgot-password-page/index.ts",
+      "path": "src/empty-state/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxForgotPasswordPage",
-          "declaration": {
-            "name": "SkdxForgotPasswordPage",
-            "module": "./ForgotPasswordPage"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxForgotPasswordDetail",
+          "name": "SkdxEmptyState",
           "declaration": {
-            "name": "SkdxForgotPasswordDetail",
-            "module": "./ForgotPasswordPage"
+            "name": "SkdxEmptyState",
+            "module": "./EmptyState"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/form-section/FormSection.ts",
+      "path": "src/filter-bar/FilterBar.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Titled group inside a larger form: a heading, supporting text, the group's\nfields and a footer for the group's own actions, composing Heading and Text\naround consumer-supplied fields.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-form-section` on the host, then `__header`, `__title`,\n`__description`, `__content` and `__footer`. `data-variant` sits on the host\nfor the skin to read.",
-          "name": "SkdxFormSection",
+          "description": "Filtering surface above a table, list, card grid or report: a search field,\nthe consumer's filter controls, the applied filters as removable tags, and a\nclear action. Composes TextField, TagGroup and Button.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-filter-bar` on the host, then `__search`, `__filters`,\n`__actions`, `__active`, `__tags` and `__clear`.",
+          "name": "SkdxFilterBar",
           "slots": [
             {
-              "description": "The group's fields, rendered into the content region.",
+              "description": "The consumer's filter controls, laid out in the filters region.",
               "name": ""
             },
             {
-              "description": "Save, cancel or other controls rendered in the footer below the fields.",
+              "description": "Controls rendered at the end of the bar, such as a \"Save view\" button.",
               "name": "actions"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "title",
+              "name": "label",
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the group, rendered into a derived Heading that names the section.",
-              "attribute": "title",
-              "required": true
+              "default": "'Filters'",
+              "description": "Accessible name of the root region, written to `aria-label`.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "searchLabel",
               "type": {
                 "text": "string | undefined | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining the group's fields.",
+              "description": "Accessible name of the search field; providing it renders the search region.",
               "default": "undefined",
-              "attribute": "description"
+              "attribute": "search-label"
             },
             {
               "kind": "field",
-              "name": "headingLevel",
+              "name": "searchPlaceholder",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "string | undefined | undefined"
               },
-              "default": "2",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding form outline.",
-              "attribute": "heading-level"
+              "description": "Placeholder shown in the empty search field.",
+              "default": "undefined",
+              "attribute": "search-placeholder"
             },
             {
               "kind": "field",
-              "name": "variant",
+              "name": "searchValue",
               "type": {
-                "text": "'bordered' | 'split' | (string & {}) | undefined | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Layout rung written to `data-variant`; `bordered` draws a bounded panel and `split` places the header beside the content.",
+              "description": "Current search text, for controlled usage; pair it with `search-value-change`.",
               "default": "undefined",
-              "attribute": "variant"
+              "attribute": "search-value"
+            },
+            {
+              "kind": "field",
+              "name": "defaultSearchValue",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Initial search text, for uncontrolled usage — seeds the internally tracked value.",
+              "attribute": "default-search-value"
+            },
+            {
+              "kind": "field",
+              "name": "clearSearchLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Clear search'",
+              "description": "Accessible name of the search field's clear button.",
+              "attribute": "clear-search-label"
+            },
+            {
+              "kind": "field",
+              "name": "activeFilters",
+              "type": {
+                "text": "readonly SkdxFilterBarFilter[] | undefined | undefined"
+              },
+              "description": "The applied filters, in display order, rendered as removable tags.",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "activeFiltersLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Active filters'",
+              "description": "Accessible name of the active-filters tag list.",
+              "attribute": "active-filters-label"
+            },
+            {
+              "kind": "field",
+              "name": "clearLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Clear filters'",
+              "description": "Text rendered on the clear-filters button.",
+              "attribute": "clear-label"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fires with the new text whenever the search field changes, controlled or not.",
+              "name": "search-value-change"
+            },
+            {
+              "description": "Fires with the removed filter when its tag's remove control is activated.",
+              "name": "remove-filter"
+            },
+            {
+              "description": "Fires when the clear-filters button is activated while filters are shown.",
+              "name": "clear"
             }
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "label",
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the group, rendered into a derived Heading that names the section.",
-              "fieldName": "title",
-              "required": true
+              "default": "'Filters'",
+              "description": "Accessible name of the root region, written to `aria-label`.",
+              "fieldName": "label"
             },
             {
-              "name": "description",
+              "name": "search-label",
               "type": {
                 "text": "string | undefined | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining the group's fields.",
+              "description": "Accessible name of the search field; providing it renders the search region.",
               "default": "undefined",
-              "fieldName": "description"
+              "fieldName": "searchLabel"
             },
             {
-              "name": "heading-level",
+              "name": "search-placeholder",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "string | undefined | undefined"
               },
-              "default": "2",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding form outline.",
-              "fieldName": "headingLevel"
+              "description": "Placeholder shown in the empty search field.",
+              "default": "undefined",
+              "fieldName": "searchPlaceholder"
             },
             {
-              "name": "variant",
+              "name": "search-value",
               "type": {
-                "text": "'bordered' | 'split' | (string & {}) | undefined | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Layout rung written to `data-variant`; `bordered` draws a bounded panel and `split` places the header beside the content.",
+              "description": "Current search text, for controlled usage; pair it with `search-value-change`.",
               "default": "undefined",
-              "fieldName": "variant"
+              "fieldName": "searchValue"
+            },
+            {
+              "name": "default-search-value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Initial search text, for uncontrolled usage — seeds the internally tracked value.",
+              "fieldName": "defaultSearchValue"
+            },
+            {
+              "name": "clear-search-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Clear search'",
+              "description": "Accessible name of the search field's clear button.",
+              "fieldName": "clearSearchLabel"
+            },
+            {
+              "name": "active-filters-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Active filters'",
+              "description": "Accessible name of the active-filters tag list.",
+              "fieldName": "activeFiltersLabel"
+            },
+            {
+              "name": "clear-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Clear filters'",
+              "description": "Text rendered on the clear-filters button.",
+              "fieldName": "clearLabel"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-form-section",
+          "tagName": "skdx-filter-bar",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxFormSection",
+          "name": "SkdxFilterBar",
           "declaration": {
-            "name": "SkdxFormSection",
-            "module": "src/form-section/FormSection.ts"
+            "name": "SkdxFilterBar",
+            "module": "src/filter-bar/FilterBar.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-form-section",
+          "name": "skdx-filter-bar",
           "declaration": {
-            "name": "SkdxFormSection",
-            "module": "src/form-section/FormSection.ts"
+            "name": "SkdxFilterBar",
+            "module": "src/filter-bar/FilterBar.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/form-section/index.ts",
+      "path": "src/filter-bar/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxFormSection",
+          "name": "SkdxFilterBar",
           "declaration": {
-            "name": "SkdxFormSection",
-            "module": "./FormSection"
+            "name": "SkdxFilterBar",
+            "module": "./FilterBar"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxFilterBarFilter",
+          "declaration": {
+            "name": "SkdxFilterBarFilter",
+            "module": "./FilterBar"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/chat-composer/ChatComposer.ts",
+      "path": "src/form-section/FormSection.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Message composer block: an auto-growing Textarea and a send Button inside a\nfield, with consumer-supplied attachment, leading, trailing and footer\nregions and configurable Enter-to-send behaviour.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-chat-composer` on the host, then `__attachments`, `__field`,\n`__leading`, `__textarea`, `__trailing`, `__send` and `__footer`.\n`data-state` on the host reads `pending` while a send is in flight.",
-          "name": "SkdxChatComposer",
+          "description": "Titled group inside a larger form: a heading, supporting text, the group's\nfields and a footer for the group's own actions, composing Heading and Text\naround consumer-supplied fields.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-form-section` on the host, then `__header`, `__title`,\n`__description`, `__content` and `__footer`. `data-variant` sits on the host\nfor the skin to read.",
+          "name": "SkdxFormSection",
           "slots": [
             {
-              "description": "Controls rendered inside the field before the textarea, such as an attach button.",
-              "name": "leading"
-            },
-            {
-              "description": "Controls rendered inside the field after the textarea, such as a model picker.",
-              "name": "trailing"
-            },
-            {
-              "description": "Attached files or chips rendered in a row above the field.",
-              "name": "attachments"
-            },
-            {
-              "description": "Usage counters or hints rendered in a row below the field.",
-              "name": "footer"
+              "description": "The group's fields, rendered into the content region.",
+              "name": ""
             },
             {
-              "description": "Glyph rendered inside the send button in place of its text, making it icon-only.",
-              "name": "send-icon"
+              "description": "Save, cancel or other controls rendered in the footer below the fields.",
+              "name": "actions"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Current message text, for controlled usage paired with `value-change`.",
-              "default": "undefined",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "defaultValue",
+              "name": "title",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Initial message text for uncontrolled usage, read only on mount.",
-              "attribute": "default-value"
+              "description": "Heading text naming the group, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
+              "attribute": "heading",
+              "required": true
             },
             {
               "kind": "field",
-              "name": "placeholder",
+              "name": "description",
               "type": {
                 "text": "string | undefined | undefined"
               },
-              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
+              "description": "Supporting copy rendered below the title, explaining the group's fields.",
               "default": "undefined",
-              "attribute": "placeholder"
-            },
-            {
-              "kind": "field",
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Message'",
-              "description": "Accessible name of the message textarea, read by assistive technology.",
-              "attribute": "label"
-            },
-            {
-              "kind": "field",
-              "name": "sendLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Send'",
-              "description": "Text of the send button, and its accessible name when the `send-icon` slot is filled.",
-              "attribute": "send-label"
-            },
-            {
-              "kind": "field",
-              "name": "submitKey",
-              "type": {
-                "text": "SkdxChatComposerSubmitKey"
-              },
-              "default": "'enter'",
-              "description": "Which key sends from the textarea; the other Enter presses insert a newline.",
-              "attribute": "submit-key"
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "maxRows",
+              "name": "headingLevel",
               "type": {
-                "text": "number"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "default": "8",
-              "description": "Caps how far the auto-growing textarea grows, in rows, before it scrolls.",
-              "attribute": "max-rows"
+              "default": "2",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding form outline.",
+              "attribute": "heading-level"
             },
             {
               "kind": "field",
-              "name": "maxLength",
+              "name": "variant",
               "type": {
-                "text": "number | undefined | undefined"
+                "text": "'bordered' | 'split' | (string & {}) | undefined | undefined"
               },
-              "description": "Native `maxlength` of the textarea — the longest message it accepts.",
+              "description": "Layout rung written to `data-variant`; `bordered` draws a bounded panel and `split` places the header beside the content.",
               "default": "undefined",
-              "attribute": "max-length"
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Disables the textarea and the send button, blocking every send path.",
-              "attribute": "disabled"
-            },
-            {
-              "kind": "field",
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks a send in flight: the button is busy and inert, the textarea stays editable.",
-              "attribute": "pending"
-            }
-          ],
-          "events": [
-            {
-              "description": "Fires with the new text on every edit, including the clear that follows an uncontrolled send.",
-              "name": "value-change"
-            },
-            {
-              "description": "Fires with the message text when the send button is activated or the configured submit key is pressed.",
-              "name": "send"
+              "attribute": "variant"
             }
           ],
           "attributes": [
             {
-              "name": "value",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Current message text, for controlled usage paired with `value-change`.",
-              "default": "undefined",
-              "fieldName": "value"
-            },
-            {
-              "name": "default-value",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Initial message text for uncontrolled usage, read only on mount.",
-              "fieldName": "defaultValue"
+              "description": "Heading text naming the group, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
+              "fieldName": "title",
+              "required": true
             },
             {
-              "name": "placeholder",
+              "name": "description",
               "type": {
                 "text": "string | undefined | undefined"
               },
-              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
+              "description": "Supporting copy rendered below the title, explaining the group's fields.",
               "default": "undefined",
-              "fieldName": "placeholder"
-            },
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Message'",
-              "description": "Accessible name of the message textarea, read by assistive technology.",
-              "fieldName": "label"
-            },
-            {
-              "name": "send-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Send'",
-              "description": "Text of the send button, and its accessible name when the `send-icon` slot is filled.",
-              "fieldName": "sendLabel"
-            },
-            {
-              "name": "submit-key",
-              "type": {
-                "text": "SkdxChatComposerSubmitKey"
-              },
-              "default": "'enter'",
-              "description": "Which key sends from the textarea; the other Enter presses insert a newline.",
-              "fieldName": "submitKey"
+              "fieldName": "description"
             },
             {
-              "name": "max-rows",
+              "name": "heading-level",
               "type": {
-                "text": "number"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "default": "8",
-              "description": "Caps how far the auto-growing textarea grows, in rows, before it scrolls.",
-              "fieldName": "maxRows"
+              "default": "2",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding form outline.",
+              "fieldName": "headingLevel"
             },
             {
-              "name": "max-length",
+              "name": "variant",
               "type": {
-                "text": "number | undefined | undefined"
+                "text": "'bordered' | 'split' | (string & {}) | undefined | undefined"
               },
-              "description": "Native `maxlength` of the textarea — the longest message it accepts.",
+              "description": "Layout rung written to `data-variant`; `bordered` draws a bounded panel and `split` places the header beside the content.",
               "default": "undefined",
-              "fieldName": "maxLength"
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Disables the textarea and the send button, blocking every send path.",
-              "fieldName": "disabled"
-            },
-            {
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks a send in flight: the button is busy and inert, the textarea stays editable.",
-              "fieldName": "pending"
+              "fieldName": "variant"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-chat-composer",
+          "tagName": "skdx-form-section",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxChatComposer",
-          "declaration": {
-            "name": "SkdxChatComposer",
-            "module": "src/chat-composer/ChatComposer.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "skdx-chat-composer",
-          "declaration": {
-            "name": "SkdxChatComposer",
-            "module": "src/chat-composer/ChatComposer.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/chat-composer/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxChatComposer",
-          "declaration": {
-            "name": "SkdxChatComposer",
-            "module": "./ChatComposer"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxChatComposerSendDetail",
+          "name": "SkdxFormSection",
           "declaration": {
-            "name": "SkdxChatComposerSendDetail",
-            "module": "./ChatComposer"
+            "name": "SkdxFormSection",
+            "module": "src/form-section/FormSection.ts"
           }
         },
         {
-          "kind": "js",
-          "name": "SkdxChatComposerSubmitKey",
+          "kind": "custom-element-definition",
+          "name": "skdx-form-section",
           "declaration": {
-            "name": "SkdxChatComposerSubmitKey",
-            "module": "./ChatComposer"
+            "name": "SkdxFormSection",
+            "module": "src/form-section/FormSection.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/form-section/index.ts",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
-          "name": "SkdxChatComposerValueChangeDetail",
+          "name": "SkdxFormSection",
           "declaration": {
-            "name": "SkdxChatComposerValueChangeDetail",
-            "module": "./ChatComposer"
+            "name": "SkdxFormSection",
+            "module": "./FormSection"
           }
         }
       ]
@@ -2437,8 +2456,8 @@
                 "text": "string"
               },
               "default": "'Notifications'",
-              "description": "Heading text, rendered into a derived Heading that names the section.",
-              "attribute": "title"
+              "description": "Heading text, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
@@ -2554,12 +2573,12 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
               "default": "'Notifications'",
-              "description": "Heading text, rendered into a derived Heading that names the section.",
+              "description": "Heading text, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
               "fieldName": "title"
             },
             {
@@ -2707,8 +2726,8 @@
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the checklist, rendered into a derived Heading that names the section.",
-              "attribute": "title",
+              "description": "Heading text naming the checklist, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
+              "attribute": "heading",
               "required": true
             },
             {
@@ -2778,11 +2797,11 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the checklist, rendered into a derived Heading that names the section.",
+              "description": "Heading text naming the checklist, rendered into a derived Heading that names the section. The JavaScript property is `title`.",
               "fieldName": "title",
               "required": true
             },
@@ -2895,7 +2914,7 @@
               "name": ""
             },
             {
-              "description": "Controls placed in the toolbar beside the heading.",
+              "description": "Toolbar parts placed in the toolbar beside the heading. Pass toolbar parts — a toolbar button, link, separator or toggle group; anything else stays its own Tab stop and the arrow keys skip it, since only a toolbar part joins the roving tabindex.",
               "name": "actions"
             }
           ],
@@ -2906,8 +2925,8 @@
               "type": {
                 "text": "string"
               },
-              "description": "The page heading text, rendered into a derived Heading that also names the section.",
-              "attribute": "title",
+              "description": "The page heading text, rendered into a derived Heading that also names the section. The JavaScript property is `title`.",
+              "attribute": "heading",
               "required": true
             },
             {
@@ -2952,11 +2971,11 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "description": "The page heading text, rendered into a derived Heading that also names the section.",
+              "description": "The page heading text, rendered into a derived Heading that also names the section. The JavaScript property is `title`.",
               "fieldName": "title",
               "required": true
             },
@@ -3007,33 +3026,267 @@
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-page-container",
+          "name": "skdx-page-container",
+          "declaration": {
+            "name": "SkdxPageContainer",
+            "module": "src/page-container/PageContainer.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/page-container/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxPageContainer",
+          "declaration": {
+            "name": "SkdxPageContainer",
+            "module": "./PageContainer"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxPageContainerBreadcrumb",
+          "declaration": {
+            "name": "SkdxPageContainerBreadcrumb",
+            "module": "./PageContainer"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/reset-password-page/ResetPasswordPage.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Reset-password block: a new-password field with its rules, an optional\nconfirmation matched against it, and a submit button, replaced entirely by a\nsuccess alert once the change is accepted.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-reset-password-page` on the host, then `__panel`, `__title`,\n`__error`, `__success`, `__form`, `__field`, `__requirements`, `__submit`\nand `__footer`.",
+          "name": "SkdxResetPasswordPage",
+          "slots": [
+            {
+              "description": "Extra fields rendered inside the form, above the submit button.",
+              "name": ""
+            },
+            {
+              "description": "Password rules used as the new-password field's description.",
+              "name": "requirements"
+            },
+            {
+              "description": "Navigation below the form, such as a link back to the sign-in page.",
+              "name": "footer"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Choose a new password'",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
+              "default": "undefined",
+              "attribute": "error"
+            },
+            {
+              "kind": "field",
+              "name": "success",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
+              "default": "undefined",
+              "attribute": "success"
+            },
+            {
+              "kind": "field",
+              "name": "pending",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the request in flight, making the submit button busy while both fields stay editable.",
+              "attribute": "pending"
+            },
+            {
+              "kind": "field",
+              "name": "passwordLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'New password'",
+              "description": "Label of the field where the new password is typed.",
+              "attribute": "password-label"
+            },
+            {
+              "kind": "field",
+              "name": "confirmPasswordLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Label of the confirmation field; supplying it is what turns password matching on.",
+              "default": "undefined",
+              "attribute": "confirm-password-label"
+            },
+            {
+              "kind": "field",
+              "name": "passwordMismatchMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Passwords do not match'",
+              "description": "Validation message pushed onto the confirmation field when the two passwords differ.",
+              "attribute": "password-mismatch-message"
+            },
+            {
+              "kind": "field",
+              "name": "submitLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Update password'",
+              "description": "Text of the form's submit button.",
+              "attribute": "submit-label"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fires with `{ password }` when the form submits with a valid password that matches the confirmation.",
+              "name": "reset-password"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "heading",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Choose a new password'",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "fieldName": "title"
+            },
+            {
+              "name": "error",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
+              "default": "undefined",
+              "fieldName": "error"
+            },
+            {
+              "name": "success",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
+              "default": "undefined",
+              "fieldName": "success"
+            },
+            {
+              "name": "pending",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the request in flight, making the submit button busy while both fields stay editable.",
+              "fieldName": "pending"
+            },
+            {
+              "name": "password-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'New password'",
+              "description": "Label of the field where the new password is typed.",
+              "fieldName": "passwordLabel"
+            },
+            {
+              "name": "confirm-password-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Label of the confirmation field; supplying it is what turns password matching on.",
+              "default": "undefined",
+              "fieldName": "confirmPasswordLabel"
+            },
+            {
+              "name": "password-mismatch-message",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Passwords do not match'",
+              "description": "Validation message pushed onto the confirmation field when the two passwords differ.",
+              "fieldName": "passwordMismatchMessage"
+            },
+            {
+              "name": "submit-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Update password'",
+              "description": "Text of the form's submit button.",
+              "fieldName": "submitLabel"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "skdx-reset-password-page",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxResetPasswordPage",
+          "declaration": {
+            "name": "SkdxResetPasswordPage",
+            "module": "src/reset-password-page/ResetPasswordPage.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "skdx-reset-password-page",
           "declaration": {
-            "name": "SkdxPageContainer",
-            "module": "src/page-container/PageContainer.ts"
+            "name": "SkdxResetPasswordPage",
+            "module": "src/reset-password-page/ResetPasswordPage.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/page-container/index.ts",
+      "path": "src/reset-password-page/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxPageContainer",
+          "name": "SkdxResetPasswordPage",
           "declaration": {
-            "name": "SkdxPageContainer",
-            "module": "./PageContainer"
+            "name": "SkdxResetPasswordPage",
+            "module": "./ResetPasswordPage"
           }
         },
         {
           "kind": "js",
-          "name": "SkdxPageContainerBreadcrumb",
+          "name": "SkdxResetPasswordDetail",
           "declaration": {
-            "name": "SkdxPageContainerBreadcrumb",
-            "module": "./PageContainer"
+            "name": "SkdxResetPasswordDetail",
+            "module": "./ResetPasswordPage"
           }
         }
       ]
@@ -3072,8 +3325,8 @@
                 "text": "string"
               },
               "default": "'Sign in'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "attribute": "title"
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
@@ -3152,12 +3405,12 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
               "default": "'Sign in'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
               "fieldName": "title"
             },
             {
@@ -3266,250 +3519,16 @@
           "kind": "js",
           "name": "SkdxSignInDetail",
           "declaration": {
-            "name": "SkdxSignInDetail",
-            "module": "./SignInPage"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxSignInProvider",
-          "declaration": {
-            "name": "SkdxSignInProvider",
-            "module": "./SignInPage"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/reset-password-page/ResetPasswordPage.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Reset-password block: a new-password field with its rules, an optional\nconfirmation matched against it, and a submit button, replaced entirely by a\nsuccess alert once the change is accepted.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-reset-password-page` on the host, then `__panel`, `__title`,\n`__error`, `__success`, `__form`, `__field`, `__requirements`, `__submit`\nand `__footer`.",
-          "name": "SkdxResetPasswordPage",
-          "slots": [
-            {
-              "description": "Extra fields rendered inside the form, above the submit button.",
-              "name": ""
-            },
-            {
-              "description": "Password rules used as the new-password field's description.",
-              "name": "requirements"
-            },
-            {
-              "description": "Navigation below the form, such as a link back to the sign-in page.",
-              "name": "footer"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Choose a new password'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "attribute": "title"
-            },
-            {
-              "kind": "field",
-              "name": "error",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
-              "default": "undefined",
-              "attribute": "error"
-            },
-            {
-              "kind": "field",
-              "name": "success",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
-              "default": "undefined",
-              "attribute": "success"
-            },
-            {
-              "kind": "field",
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the request in flight, making the submit button busy while both fields stay editable.",
-              "attribute": "pending"
-            },
-            {
-              "kind": "field",
-              "name": "passwordLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'New password'",
-              "description": "Label of the field where the new password is typed.",
-              "attribute": "password-label"
-            },
-            {
-              "kind": "field",
-              "name": "confirmPasswordLabel",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Label of the confirmation field; supplying it is what turns password matching on.",
-              "default": "undefined",
-              "attribute": "confirm-password-label"
-            },
-            {
-              "kind": "field",
-              "name": "passwordMismatchMessage",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Passwords do not match'",
-              "description": "Validation message pushed onto the confirmation field when the two passwords differ.",
-              "attribute": "password-mismatch-message"
-            },
-            {
-              "kind": "field",
-              "name": "submitLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Update password'",
-              "description": "Text of the form's submit button.",
-              "attribute": "submit-label"
-            }
-          ],
-          "events": [
-            {
-              "description": "Fires with `{ password }` when the form submits with a valid password that matches the confirmation.",
-              "name": "reset-password"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Choose a new password'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "fieldName": "title"
-            },
-            {
-              "name": "error",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Message rendered into a derived error Alert above the form. The block never clears it.",
-              "default": "undefined",
-              "fieldName": "error"
-            },
-            {
-              "name": "success",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Confirmation rendered into a derived success Alert that replaces the form entirely.",
-              "default": "undefined",
-              "fieldName": "success"
-            },
-            {
-              "name": "pending",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Marks the request in flight, making the submit button busy while both fields stay editable.",
-              "fieldName": "pending"
-            },
-            {
-              "name": "password-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'New password'",
-              "description": "Label of the field where the new password is typed.",
-              "fieldName": "passwordLabel"
-            },
-            {
-              "name": "confirm-password-label",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Label of the confirmation field; supplying it is what turns password matching on.",
-              "default": "undefined",
-              "fieldName": "confirmPasswordLabel"
-            },
-            {
-              "name": "password-mismatch-message",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Passwords do not match'",
-              "description": "Validation message pushed onto the confirmation field when the two passwords differ.",
-              "fieldName": "passwordMismatchMessage"
-            },
-            {
-              "name": "submit-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Update password'",
-              "description": "Text of the form's submit button.",
-              "fieldName": "submitLabel"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "skdx-reset-password-page",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxResetPasswordPage",
-          "declaration": {
-            "name": "SkdxResetPasswordPage",
-            "module": "src/reset-password-page/ResetPasswordPage.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "skdx-reset-password-page",
-          "declaration": {
-            "name": "SkdxResetPasswordPage",
-            "module": "src/reset-password-page/ResetPasswordPage.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/reset-password-page/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxResetPasswordPage",
-          "declaration": {
-            "name": "SkdxResetPasswordPage",
-            "module": "./ResetPasswordPage"
+            "name": "SkdxSignInDetail",
+            "module": "./SignInPage"
           }
         },
         {
           "kind": "js",
-          "name": "SkdxResetPasswordDetail",
+          "name": "SkdxSignInProvider",
           "declaration": {
-            "name": "SkdxResetPasswordDetail",
-            "module": "./ResetPasswordPage"
+            "name": "SkdxSignInProvider",
+            "module": "./SignInPage"
           }
         }
       ]
@@ -3544,8 +3563,8 @@
                 "text": "string"
               },
               "default": "'Create account'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "attribute": "title"
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
@@ -3654,12 +3673,12 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
               "default": "'Create account'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
               "fieldName": "title"
             },
             {
@@ -4233,6 +4252,256 @@
       "declarations": [],
       "exports": []
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/user-menu/UserMenu.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "The signed-in user's menu: a derived trigger showing an avatar, name and\ndescription that opens a panel repeating the identity above the\napplication's own entries.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-user-menu` on the host, then `__avatar`, `__identity`,\n`__name`, `__description`, `__content` and `__header`. `data-variant` sits on\nthe host while the derived trigger renders.",
+          "name": "SkdxUserMenu",
+          "slots": [
+            {
+              "description": "The application's own menu entries, rendered below the repeated identity header.",
+              "name": ""
+            },
+            {
+              "description": "Content that replaces the derived avatar-and-identity trigger entirely.",
+              "name": "trigger"
+            },
+            {
+              "description": "An extra indicator rendered after the identity in the trigger.",
+              "name": "status"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The signed-in user's name, rendered in the trigger and repeated in the menu header.",
+              "attribute": "name",
+              "required": true
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Secondary text such as an email or role, rendered below the name in the trigger and the header.",
+              "default": "undefined",
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "avatarSrc",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Source of the identity image, passed straight through to the derived Avatar.",
+              "default": "undefined",
+              "attribute": "avatar-src"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "'compact' | (string & {}) | undefined | undefined"
+              },
+              "description": "Visual rung written to `data-variant`; `'compact'` visually hides the identity text while keeping it as the accessible name.",
+              "default": "undefined",
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean | undefined | undefined"
+              },
+              "description": "Whether the menu is open, for controlled usage paired with `open-change`.",
+              "default": "undefined",
+              "attribute": "open"
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the menu starts open, for uncontrolled usage.",
+              "attribute": "default-open"
+            },
+            {
+              "kind": "field",
+              "name": "side",
+              "type": {
+                "text": "'top' | 'right' | 'bottom' | 'left'"
+              },
+              "default": "'bottom'",
+              "description": "Which side of the trigger the menu panel opens on.",
+              "attribute": "side"
+            },
+            {
+              "kind": "field",
+              "name": "align",
+              "type": {
+                "text": "'start' | 'center' | 'end'"
+              },
+              "default": "'end'",
+              "description": "Alignment of the menu panel relative to the side it opens on.",
+              "attribute": "align"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fires with the new open state whenever the trigger opens or closes the menu.",
+              "name": "open-change"
+            },
+            {
+              "description": "Fires with the new open state once the panel's enter or exit animation has settled.",
+              "name": "open-change-complete"
+            },
+            {
+              "description": "Fires when Escape is pressed while the menu is open; `preventDefault()` keeps it open.",
+              "name": "escape-key-down"
+            },
+            {
+              "description": "Fires on a pointer-down outside the panel while open; `preventDefault()` keeps it open.",
+              "name": "pointer-down-outside"
+            },
+            {
+              "description": "Fires when focus moves outside the panel while open; `preventDefault()` keeps it open.",
+              "name": "focus-outside"
+            },
+            {
+              "description": "Fires for either kind of outside interaction, just before the specific event.",
+              "name": "interact-outside"
+            },
+            {
+              "description": "Fires before focus returns to the trigger on close; `preventDefault()` suppresses that return.",
+              "name": "close-auto-focus"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The signed-in user's name, rendered in the trigger and repeated in the menu header.",
+              "fieldName": "name",
+              "required": true
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Secondary text such as an email or role, rendered below the name in the trigger and the header.",
+              "default": "undefined",
+              "fieldName": "description"
+            },
+            {
+              "name": "avatar-src",
+              "type": {
+                "text": "string | undefined | undefined"
+              },
+              "description": "Source of the identity image, passed straight through to the derived Avatar.",
+              "default": "undefined",
+              "fieldName": "avatarSrc"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "'compact' | (string & {}) | undefined | undefined"
+              },
+              "description": "Visual rung written to `data-variant`; `'compact'` visually hides the identity text while keeping it as the accessible name.",
+              "default": "undefined",
+              "fieldName": "variant"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean | undefined | undefined"
+              },
+              "description": "Whether the menu is open, for controlled usage paired with `open-change`.",
+              "default": "undefined",
+              "fieldName": "open"
+            },
+            {
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether the menu starts open, for uncontrolled usage.",
+              "fieldName": "defaultOpen"
+            },
+            {
+              "name": "side",
+              "type": {
+                "text": "'top' | 'right' | 'bottom' | 'left'"
+              },
+              "default": "'bottom'",
+              "description": "Which side of the trigger the menu panel opens on.",
+              "fieldName": "side"
+            },
+            {
+              "name": "align",
+              "type": {
+                "text": "'start' | 'center' | 'end'"
+              },
+              "default": "'end'",
+              "description": "Alignment of the menu panel relative to the side it opens on.",
+              "fieldName": "align"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "skdx-user-menu",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxUserMenu",
+          "declaration": {
+            "name": "SkdxUserMenu",
+            "module": "src/user-menu/UserMenu.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "skdx-user-menu",
+          "declaration": {
+            "name": "SkdxUserMenu",
+            "module": "src/user-menu/UserMenu.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/user-menu/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkdxUserMenu",
+          "declaration": {
+            "name": "SkdxUserMenu",
+            "module": "./UserMenu"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/verification-page/VerificationPage.ts",
@@ -4259,8 +4528,8 @@
                 "text": "string"
               },
               "default": "'Enter your verification code'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
-              "attribute": "title"
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
+              "attribute": "heading"
             },
             {
               "kind": "field",
@@ -4389,12 +4658,12 @@
           ],
           "attributes": [
             {
-              "name": "title",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
               "default": "'Enter your verification code'",
-              "description": "Heading text, rendered into a derived `<h1>` that names the section.",
+              "description": "Heading text, rendered into a derived `<h1>` that names the section. The JavaScript property is `title`.",
               "fieldName": "title"
             },
             {
@@ -4555,256 +4824,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/user-menu/UserMenu.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The signed-in user's menu: a derived trigger showing an avatar, name and\ndescription that opens a panel repeating the identity above the\napplication's own entries.\n\nRenders light DOM, so its parts are classes rather than shadow `::part()`\ntargets: `.skdx-user-menu` on the host, then `__avatar`, `__identity`,\n`__name`, `__description`, `__content` and `__header`. `data-variant` sits on\nthe host while the derived trigger renders.",
-          "name": "SkdxUserMenu",
-          "slots": [
-            {
-              "description": "The application's own menu entries, rendered below the repeated identity header.",
-              "name": ""
-            },
-            {
-              "description": "Content that replaces the derived avatar-and-identity trigger entirely.",
-              "name": "trigger"
-            },
-            {
-              "description": "An extra indicator rendered after the identity in the trigger.",
-              "name": "status"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The signed-in user's name, rendered in the trigger and repeated in the menu header.",
-              "attribute": "name",
-              "required": true
-            },
-            {
-              "kind": "field",
-              "name": "description",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Secondary text such as an email or role, rendered below the name in the trigger and the header.",
-              "default": "undefined",
-              "attribute": "description"
-            },
-            {
-              "kind": "field",
-              "name": "avatarSrc",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Source of the identity image, passed straight through to the derived Avatar.",
-              "default": "undefined",
-              "attribute": "avatar-src"
-            },
-            {
-              "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'compact' | (string & {}) | undefined | undefined"
-              },
-              "description": "Visual rung written to `data-variant`; `'compact'` visually hides the identity text while keeping it as the accessible name.",
-              "default": "undefined",
-              "attribute": "variant"
-            },
-            {
-              "kind": "field",
-              "name": "open",
-              "type": {
-                "text": "boolean | undefined | undefined"
-              },
-              "description": "Whether the menu is open, for controlled usage paired with `open-change`.",
-              "default": "undefined",
-              "attribute": "open"
-            },
-            {
-              "kind": "field",
-              "name": "defaultOpen",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the menu starts open, for uncontrolled usage.",
-              "attribute": "default-open"
-            },
-            {
-              "kind": "field",
-              "name": "side",
-              "type": {
-                "text": "'top' | 'right' | 'bottom' | 'left'"
-              },
-              "default": "'bottom'",
-              "description": "Which side of the trigger the menu panel opens on.",
-              "attribute": "side"
-            },
-            {
-              "kind": "field",
-              "name": "align",
-              "type": {
-                "text": "'start' | 'center' | 'end'"
-              },
-              "default": "'end'",
-              "description": "Alignment of the menu panel relative to the side it opens on.",
-              "attribute": "align"
-            }
-          ],
-          "events": [
-            {
-              "description": "Fires with the new open state whenever the trigger opens or closes the menu.",
-              "name": "open-change"
-            },
-            {
-              "description": "Fires with the new open state once the panel's enter or exit animation has settled.",
-              "name": "open-change-complete"
-            },
-            {
-              "description": "Fires when Escape is pressed while the menu is open; `preventDefault()` keeps it open.",
-              "name": "escape-key-down"
-            },
-            {
-              "description": "Fires on a pointer-down outside the panel while open; `preventDefault()` keeps it open.",
-              "name": "pointer-down-outside"
-            },
-            {
-              "description": "Fires when focus moves outside the panel while open; `preventDefault()` keeps it open.",
-              "name": "focus-outside"
-            },
-            {
-              "description": "Fires for either kind of outside interaction, just before the specific event.",
-              "name": "interact-outside"
-            },
-            {
-              "description": "Fires before focus returns to the trigger on close; `preventDefault()` suppresses that return.",
-              "name": "close-auto-focus"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The signed-in user's name, rendered in the trigger and repeated in the menu header.",
-              "fieldName": "name",
-              "required": true
-            },
-            {
-              "name": "description",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Secondary text such as an email or role, rendered below the name in the trigger and the header.",
-              "default": "undefined",
-              "fieldName": "description"
-            },
-            {
-              "name": "avatar-src",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Source of the identity image, passed straight through to the derived Avatar.",
-              "default": "undefined",
-              "fieldName": "avatarSrc"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'compact' | (string & {}) | undefined | undefined"
-              },
-              "description": "Visual rung written to `data-variant`; `'compact'` visually hides the identity text while keeping it as the accessible name.",
-              "default": "undefined",
-              "fieldName": "variant"
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean | undefined | undefined"
-              },
-              "description": "Whether the menu is open, for controlled usage paired with `open-change`.",
-              "default": "undefined",
-              "fieldName": "open"
-            },
-            {
-              "name": "default-open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the menu starts open, for uncontrolled usage.",
-              "fieldName": "defaultOpen"
-            },
-            {
-              "name": "side",
-              "type": {
-                "text": "'top' | 'right' | 'bottom' | 'left'"
-              },
-              "default": "'bottom'",
-              "description": "Which side of the trigger the menu panel opens on.",
-              "fieldName": "side"
-            },
-            {
-              "name": "align",
-              "type": {
-                "text": "'start' | 'center' | 'end'"
-              },
-              "default": "'end'",
-              "description": "Alignment of the menu panel relative to the side it opens on.",
-              "fieldName": "align"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "skdx-user-menu",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxUserMenu",
-          "declaration": {
-            "name": "SkdxUserMenu",
-            "module": "src/user-menu/UserMenu.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "skdx-user-menu",
-          "declaration": {
-            "name": "SkdxUserMenu",
-            "module": "src/user-menu/UserMenu.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/user-menu/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxUserMenu",
-          "declaration": {
-            "name": "SkdxUserMenu",
-            "module": "./UserMenu"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/workspace-switcher/WorkspaceSwitcher.ts",
@@ -4992,10 +5011,6 @@
               "description": "Fires for either kind of outside interaction, just before the specific event.",
               "name": "interact-outside"
             },
-            {
-              "description": "Fires before focus moves into the panel on open; `preventDefault()` leaves focus where it is.",
-              "name": "open-auto-focus"
-            },
             {
               "description": "Fires before focus returns to the trigger on close; `preventDefault()` suppresses that return.",
               "name": "close-auto-focus"