@skdx/web-components-blocks 0.38.0 → 0.39.0

package/custom-elements.json

@@ -363,183 +363,322 @@
     },
     {
       "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/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"
             },
@@ -702,6 +841,167 @@
         }
       ]
     },
+    {
+      "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/comment-thread/CommentThread.ts",
@@ -1094,23 +1394,23 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/dashboard-layout/DashboardLayout.ts",
+      "path": "src/empty-state/EmptyState.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": "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": "The page content rendered inside the `<main>` region.",
+              "description": "Extra content rendered between the description and the actions region.",
               "name": ""
             },
             {
-              "description": "Logo or product mark at the start of the app bar.",
-              "name": "branding"
+              "description": "Decorative illustration or glyph rendered above the title.",
+              "name": "icon"
             },
             {
-              "description": "Controls at the end of the app bar.",
+              "description": "Primary and secondary controls rendered below the content.",
               "name": "actions"
             }
           ],
@@ -1121,64 +1421,49 @@
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Application title shown in the app bar after the branding, shadowing the native tooltip attribute.",
-              "attribute": "title"
+              "description": "Heading text naming the empty region, rendered into a derived Heading.",
+              "attribute": "title",
+              "required": true
             },
             {
               "kind": "field",
-              "name": "navigation",
+              "name": "description",
               "type": {
-                "text": "readonly SkdxDashboardNavigationItem[]"
+                "text": "string | undefined | undefined"
               },
-              "description": "The side navigation, one entry per row, nested through each entry's `children`.",
-              "required": true
+              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
+              "default": "undefined",
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "navOpen",
+              "name": "headingLevel",
               "type": {
-                "text": "boolean | undefined"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "description": "Whether the side navigation is shown, for controlled usage.",
-              "default": "undefined",
-              "attribute": "nav-open"
+              "default": "3",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
+              "attribute": "heading-level"
             },
             {
               "kind": "field",
-              "name": "defaultNavOpen",
+              "name": "size",
               "type": {
-                "text": "boolean"
+                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
               },
-              "default": "true",
-              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
-              "attribute": "default-nav-open"
+              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
+              "default": "undefined",
+              "attribute": "size"
             },
             {
               "kind": "field",
-              "name": "navLabel",
+              "name": "align",
               "type": {
-                "text": "string"
-              },
-              "default": "'Main navigation'",
-              "description": "Accessible name of the side navigation landmark.",
-              "attribute": "nav-label"
-            },
-            {
-              "kind": "field",
-              "name": "navToggleLabel",
-              "type": {
-                "text": "string"
+                "text": "'center' | 'start' | (string & {})"
               },
-              "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 open state whenever the navigation toggle is activated.",
-              "name": "nav-open-change"
+              "default": "'center'",
+              "description": "Text and content alignment rung, written to `data-align` on the host.",
+              "attribute": "align"
             }
           ],
           "attributes": [
@@ -1187,116 +1472,108 @@
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Application title shown in the app bar after the branding, shadowing the native tooltip attribute.",
-              "fieldName": "title"
+              "description": "Heading text naming the empty region, rendered into a derived Heading.",
+              "fieldName": "title",
+              "required": true
             },
             {
-              "name": "nav-open",
+              "name": "description",
               "type": {
-                "text": "boolean | undefined"
+                "text": "string | undefined | undefined"
               },
-              "description": "Whether the side navigation is shown, for controlled usage.",
+              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
               "default": "undefined",
-              "fieldName": "navOpen"
+              "fieldName": "description"
             },
             {
-              "name": "default-nav-open",
+              "name": "heading-level",
               "type": {
-                "text": "boolean"
+                "text": "1 | 2 | 3 | 4 | 5 | 6"
               },
-              "default": "true",
-              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
-              "fieldName": "defaultNavOpen"
+              "default": "3",
+              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
+              "fieldName": "headingLevel"
             },
             {
-              "name": "nav-label",
+              "name": "size",
               "type": {
-                "text": "string"
+                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
               },
-              "default": "'Main navigation'",
-              "description": "Accessible name of the side navigation landmark.",
-              "fieldName": "navLabel"
+              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
+              "default": "undefined",
+              "fieldName": "size"
             },
             {
-              "name": "nav-toggle-label",
+              "name": "align",
               "type": {
-                "text": "string"
+                "text": "'center' | 'start' | (string & {})"
               },
-              "default": "'Toggle navigation'",
-              "description": "Accessible name of the icon-only button that shows and hides the navigation.",
-              "fieldName": "navToggleLabel"
+              "default": "'center'",
+              "description": "Text and content alignment rung, written to `data-align` on the host.",
+              "fieldName": "align"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "skdx-dashboard-layout",
+          "tagName": "skdx-empty-state",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxDashboardLayout",
+          "name": "SkdxEmptyState",
           "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "src/dashboard-layout/DashboardLayout.ts"
+            "name": "SkdxEmptyState",
+            "module": "src/empty-state/EmptyState.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-dashboard-layout",
+          "name": "skdx-empty-state",
           "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "src/dashboard-layout/DashboardLayout.ts"
+            "name": "SkdxEmptyState",
+            "module": "src/empty-state/EmptyState.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/dashboard-layout/index.ts",
+      "path": "src/empty-state/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxDashboardLayout",
-          "declaration": {
-            "name": "SkdxDashboardLayout",
-            "module": "./DashboardLayout"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxDashboardNavigationItem",
+          "name": "SkdxEmptyState",
           "declaration": {
-            "name": "SkdxDashboardNavigationItem",
-            "module": "./DashboardLayout"
+            "name": "SkdxEmptyState",
+            "module": "./EmptyState"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/empty-state/EmptyState.ts",
+      "path": "src/dashboard-layout/DashboardLayout.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": "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": "Extra content rendered between the description and the actions region.",
+              "description": "The page content rendered inside the `<main>` region.",
               "name": ""
             },
             {
-              "description": "Decorative illustration or glyph rendered above the title.",
-              "name": "icon"
+              "description": "Logo or product mark at the start of the app bar.",
+              "name": "branding"
             },
             {
-              "description": "Primary and secondary controls rendered below the content.",
+              "description": "Controls at the end of the app bar.",
               "name": "actions"
             }
           ],
@@ -1307,49 +1584,64 @@
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the empty region, rendered into a derived Heading.",
-              "attribute": "title",
+              "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": "description",
+              "name": "navOpen",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "boolean | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
+              "description": "Whether the side navigation is shown, for controlled usage.",
               "default": "undefined",
-              "attribute": "description"
+              "attribute": "nav-open"
             },
             {
               "kind": "field",
-              "name": "headingLevel",
+              "name": "defaultNavOpen",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "boolean"
               },
-              "default": "3",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
-              "attribute": "heading-level"
+              "default": "true",
+              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
+              "attribute": "default-nav-open"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "navLabel",
               "type": {
-                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
+                "text": "string"
               },
-              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
-              "default": "undefined",
-              "attribute": "size"
+              "default": "'Main navigation'",
+              "description": "Accessible name of the side navigation landmark.",
+              "attribute": "nav-label"
             },
             {
               "kind": "field",
-              "name": "align",
+              "name": "navToggleLabel",
               "type": {
-                "text": "'center' | 'start' | (string & {})"
+                "text": "string"
               },
-              "default": "'center'",
-              "description": "Text and content alignment rung, written to `data-align` on the host.",
-              "attribute": "align"
+              "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 open state whenever the navigation toggle is activated.",
+              "name": "nav-open-change"
             }
           ],
           "attributes": [
@@ -1358,85 +1650,93 @@
               "type": {
                 "text": "string"
               },
-              "description": "Heading text naming the empty region, rendered into a derived Heading.",
-              "fieldName": "title",
-              "required": true
+              "default": "''",
+              "description": "Application title shown in the app bar after the branding, shadowing the native tooltip attribute.",
+              "fieldName": "title"
             },
             {
-              "name": "description",
+              "name": "nav-open",
               "type": {
-                "text": "string | undefined | undefined"
+                "text": "boolean | undefined"
               },
-              "description": "Supporting copy rendered below the title, explaining why the region is empty.",
+              "description": "Whether the side navigation is shown, for controlled usage.",
               "default": "undefined",
-              "fieldName": "description"
+              "fieldName": "navOpen"
             },
             {
-              "name": "heading-level",
+              "name": "default-nav-open",
               "type": {
-                "text": "1 | 2 | 3 | 4 | 5 | 6"
+                "text": "boolean"
               },
-              "default": "3",
-              "description": "Outline level of the derived title heading, lowered or raised to fit the surrounding outline.",
-              "fieldName": "headingLevel"
+              "default": "true",
+              "description": "Whether the side navigation starts shown, for uncontrolled usage.",
+              "fieldName": "defaultNavOpen"
             },
             {
-              "name": "size",
+              "name": "nav-label",
               "type": {
-                "text": "'sm' | 'md' | 'lg' | (string & {}) | undefined | undefined"
+                "text": "string"
               },
-              "description": "Visual size rung, written to `data-size` on the host; the skin scales the icon, spacing and title by it.",
-              "default": "undefined",
-              "fieldName": "size"
+              "default": "'Main navigation'",
+              "description": "Accessible name of the side navigation landmark.",
+              "fieldName": "navLabel"
             },
             {
-              "name": "align",
+              "name": "nav-toggle-label",
               "type": {
-                "text": "'center' | 'start' | (string & {})"
+                "text": "string"
               },
-              "default": "'center'",
-              "description": "Text and content alignment rung, written to `data-align` on the host.",
-              "fieldName": "align"
+              "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-empty-state",
+          "tagName": "skdx-dashboard-layout",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxEmptyState",
+          "name": "SkdxDashboardLayout",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "src/empty-state/EmptyState.ts"
+            "name": "SkdxDashboardLayout",
+            "module": "src/dashboard-layout/DashboardLayout.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "skdx-empty-state",
+          "name": "skdx-dashboard-layout",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "src/empty-state/EmptyState.ts"
+            "name": "SkdxDashboardLayout",
+            "module": "src/dashboard-layout/DashboardLayout.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/empty-state/index.ts",
+      "path": "src/dashboard-layout/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "SkdxEmptyState",
+          "name": "SkdxDashboardLayout",
           "declaration": {
-            "name": "SkdxEmptyState",
-            "module": "./EmptyState"
+            "name": "SkdxDashboardLayout",
+            "module": "./DashboardLayout"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SkdxDashboardNavigationItem",
+          "declaration": {
+            "name": "SkdxDashboardNavigationItem",
+            "module": "./DashboardLayout"
           }
         }
       ]
@@ -2011,330 +2311,30 @@
           "name": "SkdxFormSection",
           "declaration": {
             "name": "SkdxFormSection",
-            "module": "src/form-section/FormSection.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "skdx-form-section",
-          "declaration": {
-            "name": "SkdxFormSection",
-            "module": "src/form-section/FormSection.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/form-section/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkdxFormSection",
-          "declaration": {
-            "name": "SkdxFormSection",
-            "module": "./FormSection"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/chat-composer/ChatComposer.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",
-          "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": "Glyph rendered inside the send button in place of its text, making it icon-only.",
-              "name": "send-icon"
-            }
-          ],
-          "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",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Initial message text for uncontrolled usage, read only on mount.",
-              "attribute": "default-value"
-            },
-            {
-              "kind": "field",
-              "name": "placeholder",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
-              "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"
-            },
-            {
-              "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": "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"
-            }
-          ],
-          "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",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Initial message text for uncontrolled usage, read only on mount.",
-              "fieldName": "defaultValue"
-            },
-            {
-              "name": "placeholder",
-              "type": {
-                "text": "string | undefined | undefined"
-              },
-              "description": "Hint text shown in the empty textarea, rendered as the native placeholder.",
-              "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"
-            },
-            {
-              "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": "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"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "skdx-chat-composer",
-          "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",
-          "declaration": {
-            "name": "SkdxChatComposerSendDetail",
-            "module": "./ChatComposer"
+            "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"
           }
         }
       ]
@@ -2895,7 +2895,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"
             }
           ],
@@ -3007,33 +3007,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.",
+              "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": "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"
           }
         }
       ]
@@ -3280,240 +3514,6 @@
         }
       ]
     },
-    {
-      "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"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SkdxResetPasswordDetail",
-          "declaration": {
-            "name": "SkdxResetPasswordDetail",
-            "module": "./ResetPasswordPage"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/sign-up-page/SignUpPage.ts",
@@ -4227,12 +4227,262 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/usage-card/usage.ts",
-      "declarations": [],
-      "exports": []
-    },
+    {
+      "kind": "javascript-module",
+      "path": "src/usage-card/usage.ts",
+      "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",
@@ -4555,256 +4805,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",