@f-ewald/components 0.7.0 → 1.0.0

package/custom-elements.json

@@ -1166,1351 +1166,2353 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/chat-message.ts",
+      "path": "src/calendar-entry.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "One conversation entry in a chat-style activity feed. Tool calls and\n\"thinking\" traces are variants of this component rather than separate\nones — they share the same header, collapse behavior, and body card as a\nnormal message, just dimmed and collapsible with an always-visible summary.",
-          "name": "ChatMessage",
+          "description": "Declarative metadata for one calendar event, consumed by a parent\n`calendar-month` or `calendar-year`. Read-only/non-interactive; renders\nnothing itself.",
+          "name": "CalendarEntry",
           "slots": [
             {
-              "description": "Message body (consumers slot in already-rendered content, e.g. sanitized markdown HTML).",
-              "name": ""
+              "description": "Plain-text title shown instead of the `label` fallback.",
+              "name": "title"
+            },
+            {
+              "description": "Repeatable plain-text details rendered inside the shared body spanning all remaining days.",
+              "name": "detail"
+            },
+            {
+              "description": "Plain-text ending note pinned to the bottom of the shared body.",
+              "name": "footer"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "role",
-              "type": {
-                "text": "ChatMessageRole"
-              },
-              "default": "\"agent\"",
-              "description": "Whose message this is; drives the card background/border.",
-              "attribute": "role",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "variant",
+              "name": "start",
               "type": {
-                "text": "ChatMessageVariant"
+                "text": "string"
               },
-              "default": "\"normal\"",
-              "description": "`tool`/`thinking` render dimmed and smaller, with `tool` using monospace for its body.",
-              "attribute": "variant",
+              "default": "\"\"",
+              "description": "Inclusive start date, `\"YYYY-MM-DD\"`.",
+              "attribute": "start",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "author",
+              "name": "end",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Header label, e.g. \"Freddy\" or \"Architect\".",
-              "attribute": "author"
-            },
-            {
-              "kind": "field",
-              "name": "timestamp",
-              "type": {
-                "text": "string | null"
-              },
-              "default": "null",
-              "description": "ISO-8601 timestamp, rendered via `relative-time` in the header.",
-              "attribute": "timestamp"
+              "description": "Inclusive end date, `\"YYYY-MM-DD\"`. Falls back to `start` when unset (single-day entry).",
+              "attribute": "end",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "summary",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Always-visible one-liner for `tool`/`thinking` variants (e.g. a truncated args preview).",
-              "attribute": "summary"
+              "description": "Fallback title used when no `title` slot is provided.",
+              "attribute": "label",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "collapsible",
+              "name": "color",
               "type": {
-                "text": "boolean"
+                "text": "StatusPillColor"
               },
-              "default": "false",
-              "description": "Whether clicking the header/summary toggles the body slot.",
-              "attribute": "collapsible"
+              "default": "\"neutral\"",
+              "description": "Color variant, reusing `status-pill`'s palette.",
+              "attribute": "color",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "collapsed",
+              "name": "href",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Current collapse state (reflected as an attribute).",
-              "attribute": "collapsed",
+              "description": "Optional link target; the parent renders the entry as an `<a>` when set.",
+              "attribute": "href",
               "reflects": true
-            },
-            {
-              "kind": "method",
-              "name": "_toggle",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "name": "toggle",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired with `{ collapsed: boolean }` when the header/summary is clicked in collapsible mode."
             }
           ],
           "attributes": [
             {
-              "name": "role",
-              "type": {
-                "text": "ChatMessageRole"
-              },
-              "default": "\"agent\"",
-              "description": "Whose message this is; drives the card background/border.",
-              "fieldName": "role"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "ChatMessageVariant"
-              },
-              "default": "\"normal\"",
-              "description": "`tool`/`thinking` render dimmed and smaller, with `tool` using monospace for its body.",
-              "fieldName": "variant"
-            },
-            {
-              "name": "author",
+              "name": "start",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Header label, e.g. \"Freddy\" or \"Architect\".",
-              "fieldName": "author"
+              "description": "Inclusive start date, `\"YYYY-MM-DD\"`.",
+              "fieldName": "start"
             },
             {
-              "name": "timestamp",
+              "name": "end",
               "type": {
-                "text": "string | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "ISO-8601 timestamp, rendered via `relative-time` in the header.",
-              "fieldName": "timestamp"
+              "default": "\"\"",
+              "description": "Inclusive end date, `\"YYYY-MM-DD\"`. Falls back to `start` when unset (single-day entry).",
+              "fieldName": "end"
             },
             {
-              "name": "summary",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Always-visible one-liner for `tool`/`thinking` variants (e.g. a truncated args preview).",
-              "fieldName": "summary"
+              "description": "Fallback title used when no `title` slot is provided.",
+              "fieldName": "label"
             },
             {
-              "name": "collapsible",
+              "name": "color",
               "type": {
-                "text": "boolean"
+                "text": "StatusPillColor"
               },
-              "default": "false",
-              "description": "Whether clicking the header/summary toggles the body slot.",
-              "fieldName": "collapsible"
+              "default": "\"neutral\"",
+              "description": "Color variant, reusing `status-pill`'s palette.",
+              "fieldName": "color"
             },
             {
-              "name": "collapsed",
+              "name": "href",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "default": "false",
-              "description": "Current collapse state (reflected as an attribute).",
-              "fieldName": "collapsed"
+              "description": "Optional link target; the parent renders the entry as an `<a>` when set.",
+              "fieldName": "href"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "chat-message",
+          "tagName": "calendar-entry",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ChatMessage",
+          "name": "CalendarEntry",
           "declaration": {
-            "name": "ChatMessage",
-            "module": "src/chat-message.ts"
+            "name": "CalendarEntry",
+            "module": "src/calendar-entry.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "chat-message",
+          "name": "calendar-entry",
           "declaration": {
-            "name": "ChatMessage",
-            "module": "src/chat-message.ts"
+            "name": "CalendarEntry",
+            "module": "src/calendar-entry.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/confirm-dialog.ts",
+      "path": "src/calendar-month.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Reusable confirmation dialog: overlay + centered card with a slotted body,\nan optional error line, and Cancel/Confirm actions. Instant `display:none`\n→ `display:flex` toggle (no transitions). Fires `confirm`/`cancel`\n(bubbling, composed) instead of owning any deletion logic itself —\ncallers stay in charge of the request.",
-          "name": "ConfirmDialog",
+          "description": "One month rendered as a top-to-bottom list of days — weekends and today\nhighlighted, with declarative `calendar-entry` children shown as colored\nbars spanning the days they cover. An entry's title uses its first visible\nday; every remaining visible day becomes one shared body for wrapped\ndetails and an optional ending footer. Overlapping entries stack into\nside-by-side lanes rather than being layered/hidden. Read-only.\n\nLanes are computed independently per instance, from only the entries\noverlapping this month — an entry spanning a month boundary may therefore\nland in a different lane index in the adjacent month's `calendar-month`.\nThis is an accepted v1 limitation: cross-month lane continuity would\nrequire a shared parent (`calendar-year`) to assign lanes globally.\n\nEntry attributes and slotted title/detail text are observed, so a\nstandalone month re-renders when consumers update declarative metadata.",
+          "name": "CalendarMonth",
+          "slots": [
+            {
+              "description": "Declarative `calendar-entry` elements to render for this month.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "open",
+              "name": "year",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Whether the dialog is visible.",
-              "attribute": "open"
+              "description": "Calendar year, e.g. `2026`.",
+              "attribute": "year",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "confirmLabel",
+              "name": "month",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "\"Delete\"",
-              "description": "Label for the confirm button.",
-              "attribute": "confirm-label"
+              "default": "1",
+              "description": "Calendar month, 1-12 (January = 1).",
+              "attribute": "month",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "cancelLabel",
+              "name": "_entryElements",
               "type": {
-                "text": "string"
+                "text": "CalendarEntry[]"
               },
-              "default": "\"Cancel\"",
-              "description": "Label for the cancel button.",
-              "attribute": "cancel-label"
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "danger",
+              "name": "_entriesVersion",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "true",
-              "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
-              "attribute": "danger"
+              "privacy": "private",
+              "default": "0",
+              "description": "Bumped when entry elements, attributes, or slotted text change to force a re-render."
             },
             {
               "kind": "field",
-              "name": "busy",
+              "name": "_entriesObserver",
               "type": {
-                "text": "boolean"
+                "text": "MutationObserver | undefined"
               },
-              "default": "false",
-              "description": "Shows a spinner and disables both buttons while a request is in flight.",
-              "attribute": "busy"
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "error",
-              "type": {
-                "text": "string | null"
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "null",
-              "description": "Inline error line shown below the body, or null for none.",
-              "attribute": "error"
+              "description": "Re-renders when declarative `calendar-entry` children are added or removed."
             },
             {
               "kind": "method",
-              "name": "_confirm",
-              "privacy": "private"
+              "name": "_entryFor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "LanedEntry | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "laned",
+                  "type": {
+                    "text": "LanedEntry[]"
+                  }
+                },
+                {
+                  "name": "lane",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "Date"
+                  }
+                }
+              ],
+              "description": "Finds the laned entry (if any) covering `date` in a given lane."
             },
             {
               "kind": "method",
-              "name": "_cancel",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "name": "confirm",
-              "type": {
-                "text": "CustomEvent"
+              "name": "_segmentClass",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
               },
-              "description": "User clicked the confirm button."
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                },
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "Date"
+                  }
+                }
+              ],
+              "description": "Classifies one day of an entry so only the outer endpoints are rounded."
             },
             {
-              "name": "cancel",
-              "type": {
-                "text": "CustomEvent"
+              "kind": "method",
+              "name": "_entryKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
               },
-              "description": "User clicked the cancel button."
-            }
-          ],
-          "attributes": [
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the dialog is visible.",
-              "fieldName": "open"
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                }
+              ],
+              "description": "Current render key shared by an entry's title and body cells."
             },
             {
-              "name": "confirm-label",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "_setEntryInteraction",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "\"Delete\"",
-              "description": "Label for the confirm button.",
-              "fieldName": "confirmLabel"
+              "parameters": [
+                {
+                  "name": "entryKey",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "className",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "active",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Toggles one interaction class on every rendered cell belonging to an entry."
             },
             {
-              "name": "cancel-label",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "_syncEntryInteractions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "\"Cancel\"",
-              "description": "Label for the cancel button.",
-              "fieldName": "cancelLabel"
+              "description": "Reconciles classes against the links actually hovered or focused after a render."
             },
             {
-              "name": "danger",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "_renderEntryLink",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                },
+                {
+                  "name": "accessibleText",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Renders a transparent full-cell link without wrapping the visible text."
+            },
+            {
+              "kind": "method",
+              "name": "_entryBodyText",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
               },
-              "default": "true",
-              "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
-              "fieldName": "danger"
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                },
+                {
+                  "name": "showFooter",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ],
+              "description": "Joins the event title, details, and visible footer for tooltips and accessible link names."
             },
             {
-              "name": "busy",
+              "kind": "method",
+              "name": "_renderEntryBody",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                },
+                {
+                  "name": "showFooter",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "detailLineClamp",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "showTitleFallback",
+                  "default": "false"
+                }
+              ],
+              "description": "Renders the shared details body, with the footer reserved at its bottom edge."
+            },
+            {
+              "kind": "method",
+              "name": "_renderEntryBodyCell",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "entry",
+                  "type": {
+                    "text": "LanedEntry"
+                  }
+                },
+                {
+                  "name": "bodyRows",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "reachesEventEnd",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "showTitleFallback",
+                  "default": "false"
+                }
+              ],
+              "description": "Renders a row-spanning body cell with whole-line detail and footer budgets."
+            },
+            {
+              "kind": "method",
+              "name": "_renderLaneCell",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "laned",
+                  "type": {
+                    "text": "LanedEntry[]"
+                  }
+                },
+                {
+                  "name": "lane",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "date",
+                  "type": {
+                    "text": "Date"
+                  }
+                },
+                {
+                  "name": "monthStart",
+                  "type": {
+                    "text": "Date"
+                  }
+                },
+                {
+                  "name": "monthEnd",
+                  "type": {
+                    "text": "Date"
+                  }
+                }
+              ],
+              "description": "Renders a lane's title/body cell, skips rows covered by a body rowspan, or emits an empty spacer."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "year",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Shows a spinner and disables both buttons while a request is in flight.",
-              "fieldName": "busy"
+              "description": "Calendar year, e.g. `2026`.",
+              "fieldName": "year"
             },
             {
-              "name": "error",
+              "name": "month",
               "type": {
-                "text": "string | null"
+                "text": "number"
               },
-              "default": "null",
-              "description": "Inline error line shown below the body, or null for none.",
-              "fieldName": "error"
+              "default": "1",
+              "description": "Calendar month, 1-12 (January = 1).",
+              "fieldName": "month"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "confirm-dialog",
+          "tagName": "calendar-month",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ConfirmDialog",
+          "name": "CalendarMonth",
           "declaration": {
-            "name": "ConfirmDialog",
-            "module": "src/confirm-dialog.ts"
+            "name": "CalendarMonth",
+            "module": "src/calendar-month.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "confirm-dialog",
+          "name": "calendar-month",
           "declaration": {
-            "name": "ConfirmDialog",
-            "module": "src/confirm-dialog.ts"
+            "name": "CalendarMonth",
+            "module": "src/calendar-month.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/copy-link-button.ts",
+      "path": "src/calendar-year.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Small icon button that copies `value` to the clipboard and shows a toast\non success/failure (if a `<toast-notification>` element is present), and\nalways dispatches a `copy-success`/`copy-error` CustomEvent so consumers\nwithout a toast element can react. Defaults to the current page URL if\n`value` is unset.",
-          "name": "CopyLinkButton",
+          "description": "A full year of `calendar-month` blocks, generated from declarative\n`calendar-entry` children. Each entry is re-projected into the\n`calendar-month` blocks it overlaps as a freshly-created `calendar-entry`\nelement — the original elements stay slotted here and are never moved,\nsince a DOM node can only have one parent. Read-only.",
+          "name": "CalendarYear",
+          "slots": [
+            {
+              "description": "Declarative `calendar-entry` elements spanning the displayed year.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "year",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "\"\"",
-              "description": "Text to copy. Defaults to `window.location.href` at click time.",
-              "attribute": "value"
+              "description": "Calendar year to render all 12 months for, e.g. `2026`.",
+              "attribute": "year",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "_entryElements",
               "type": {
-                "text": "string"
+                "text": "CalendarEntry[]"
               },
-              "default": "\"Copy link\"",
-              "description": "Accessible label / tooltip text.",
-              "attribute": "label"
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "kind": "method",
-              "name": "_onClick",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "name": "copy-success",
+              "kind": "field",
+              "name": "_entriesVersion",
               "type": {
-                "text": "CustomEvent"
+                "text": "number"
               },
-              "description": "The value was copied to the clipboard."
+              "privacy": "private",
+              "default": "0",
+              "description": "Bumped whenever entry elements, attributes, or slotted text change to force a re-render."
             },
             {
-              "name": "copy-error",
+              "kind": "field",
+              "name": "_entriesObserver",
               "type": {
-                "text": "CustomEvent"
+                "text": "MutationObserver | undefined"
               },
-              "description": "Copying to the clipboard failed."
-            }
-          ],
-          "attributes": [
+              "privacy": "private"
+            },
             {
-              "name": "value",
+              "kind": "field",
+              "name": "_entryKeys",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new WeakMap<CalendarEntry, string>()"
+            },
+            {
+              "kind": "field",
+              "name": "_nextEntryKey",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "\"\"",
-              "description": "Text to copy. Defaults to `window.location.href` at click time.",
-              "fieldName": "value"
+              "privacy": "private",
+              "default": "0"
             },
             {
-              "name": "label",
-              "type": {
-                "text": "string"
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "\"Copy link\"",
-              "description": "Accessible label / tooltip text.",
-              "fieldName": "label"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "copy-link-button",
+              "description": "Re-renders when declarative `calendar-entry` children are added or removed."
+            },
+            {
+              "kind": "method",
+              "name": "_entryKey",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "element",
+                  "type": {
+                    "text": "CalendarEntry"
+                  }
+                }
+              ],
+              "description": "Returns an immutable identity for each original slotted entry."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "year",
+              "type": {
+                "text": "number"
+              },
+              "description": "Calendar year to render all 12 months for, e.g. `2026`.",
+              "fieldName": "year"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "calendar-year",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "CopyLinkButton",
+          "name": "CalendarYear",
           "declaration": {
-            "name": "CopyLinkButton",
-            "module": "src/copy-link-button.ts"
+            "name": "CalendarYear",
+            "module": "src/calendar-year.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "copy-link-button",
+          "name": "calendar-year",
           "declaration": {
-            "name": "CopyLinkButton",
-            "module": "src/copy-link-button.ts"
+            "name": "CalendarYear",
+            "module": "src/calendar-year.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/data-table.ts",
+      "path": "src/chat-message.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
-          "name": "DataTable",
+          "description": "One conversation entry in a chat-style activity feed. Tool calls and\n\"thinking\" traces are variants of this component rather than separate\nones — they share the same header, collapse behavior, and body card as a\nnormal message, just dimmed and collapsible with an always-visible summary.",
+          "name": "ChatMessage",
+          "slots": [
+            {
+              "description": "Message body (consumers slot in already-rendered content, e.g. sanitized markdown HTML).",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "columns",
+              "name": "role",
               "type": {
-                "text": "DataTableColumn[]"
+                "text": "ChatMessageRole"
               },
-              "default": "[]",
-              "description": "Column headers, in display order."
+              "default": "\"agent\"",
+              "description": "Whose message this is; drives the card background/border.",
+              "attribute": "role",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "rows",
+              "name": "variant",
               "type": {
-                "text": "unknown[]"
+                "text": "ChatMessageVariant"
               },
-              "default": "[]",
-              "description": "Row data; opaque to this component beyond what `renderCell` does with it."
+              "default": "\"normal\"",
+              "description": "`tool`/`thinking` render dimmed and smaller, with `tool` using monospace for its body.",
+              "attribute": "variant",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "rowKey",
+              "name": "author",
               "type": {
-                "text": "(row: unknown, index: number) => string | number"
+                "text": "string"
               },
-              "description": "Stable identity for `rows[i]`, used as the repeat-directive key. Defaults to the row's index."
+              "default": "\"\"",
+              "description": "Header label, e.g. \"Freddy\" or \"Architect\".",
+              "attribute": "author"
             },
             {
               "kind": "field",
-              "name": "renderCell",
+              "name": "timestamp",
               "type": {
-                "text": "(row: unknown, key: string) => unknown"
+                "text": "string | null"
               },
-              "description": "Produces a cell's rendered content for `row`/`column.key`. Default: `row[key]`."
+              "default": "null",
+              "description": "ISO-8601 timestamp, rendered via `relative-time` in the header.",
+              "attribute": "timestamp"
             },
             {
               "kind": "field",
-              "name": "rowHref",
+              "name": "summary",
               "type": {
-                "text": "((row: unknown) => string | null) | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "When set, clicking a row (outside any nested link/button) navigates to this hash."
+              "default": "\"\"",
+              "description": "Always-visible one-liner for `tool`/`thinking` variants (e.g. a truncated args preview).",
+              "attribute": "summary"
+            },
+            {
+              "kind": "field",
+              "name": "collapsible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether clicking the header/summary toggles the body slot.",
+              "attribute": "collapsible"
+            },
+            {
+              "kind": "field",
+              "name": "collapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Current collapse state (reflected as an attribute).",
+              "attribute": "collapsed",
+              "reflects": true
             },
             {
               "kind": "method",
-              "name": "#onRowClick",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "name": "_toggle",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "toggle",
+              "type": {
+                "text": "CustomEvent"
               },
-              "parameters": [
-                {
-                  "name": "row",
-                  "type": {
-                    "text": "unknown"
-                  }
-                },
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                }
-              ]
+              "description": "Fired with `{ collapsed: boolean }` when the header/summary is clicked in collapsible mode."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "role",
+              "type": {
+                "text": "ChatMessageRole"
+              },
+              "default": "\"agent\"",
+              "description": "Whose message this is; drives the card background/border.",
+              "fieldName": "role"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "ChatMessageVariant"
+              },
+              "default": "\"normal\"",
+              "description": "`tool`/`thinking` render dimmed and smaller, with `tool` using monospace for its body.",
+              "fieldName": "variant"
+            },
+            {
+              "name": "author",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Header label, e.g. \"Freddy\" or \"Architect\".",
+              "fieldName": "author"
+            },
+            {
+              "name": "timestamp",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "ISO-8601 timestamp, rendered via `relative-time` in the header.",
+              "fieldName": "timestamp"
+            },
+            {
+              "name": "summary",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Always-visible one-liner for `tool`/`thinking` variants (e.g. a truncated args preview).",
+              "fieldName": "summary"
+            },
+            {
+              "name": "collapsible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether clicking the header/summary toggles the body slot.",
+              "fieldName": "collapsible"
+            },
+            {
+              "name": "collapsed",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Current collapse state (reflected as an attribute).",
+              "fieldName": "collapsed"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "data-table",
+          "tagName": "chat-message",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "DataTable",
+          "name": "ChatMessage",
           "declaration": {
-            "name": "DataTable",
-            "module": "src/data-table.ts"
+            "name": "ChatMessage",
+            "module": "src/chat-message.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "data-table",
+          "name": "chat-message",
           "declaration": {
-            "name": "DataTable",
-            "module": "src/data-table.ts"
+            "name": "ChatMessage",
+            "module": "src/chat-message.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/distance-value.ts",
+      "path": "src/confirm-dialog.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Inline distance display. Renders miles/feet or km/m, switching units at\nsensible thresholds (< 0.25 mi → ft; < 0.5 km → m).\n\nSupply exactly one of `miles` or `km`; the other stays null.\nkm support is present but reserved for future use.",
-          "name": "DistanceValue",
+          "description": "Reusable confirmation dialog: overlay + centered card with a slotted body,\nan optional error line, and Cancel/Confirm actions. Instant `display:none`\n→ `display:flex` toggle (no transitions). Fires `confirm`/`cancel`\n(bubbling, composed) instead of owning any deletion logic itself —\ncallers stay in charge of the request.",
+          "name": "ConfirmDialog",
           "members": [
             {
               "kind": "field",
-              "name": "miles",
+              "name": "open",
               "type": {
-                "text": "number | null"
+                "text": "boolean"
               },
-              "default": "null",
-              "description": "Distance in miles (imperial). Switches to feet below 0.25 mi.",
-              "attribute": "miles"
+              "default": "false",
+              "description": "Whether the dialog is visible.",
+              "attribute": "open"
             },
             {
               "kind": "field",
-              "name": "km",
+              "name": "confirmLabel",
               "type": {
-                "text": "number | null"
+                "text": "string"
               },
-              "default": "null",
-              "description": "Distance in kilometers (metric, future). Switches to meters below 0.5 km.",
-              "attribute": "km"
-            }
-          ],
-          "attributes": [
+              "default": "\"Delete\"",
+              "description": "Label for the confirm button.",
+              "attribute": "confirm-label"
+            },
             {
-              "name": "miles",
-              "type": {
-                "text": "number | null"
-              },
-              "default": "null",
-              "description": "Distance in miles (imperial). Switches to feet below 0.25 mi.",
-              "fieldName": "miles"
-            },
-            {
-              "name": "km",
-              "type": {
-                "text": "number | null"
-              },
-              "default": "null",
-              "description": "Distance in kilometers (metric, future). Switches to meters below 0.5 km.",
-              "fieldName": "km"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "distance-value",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "DistanceValue",
-          "declaration": {
-            "name": "DistanceValue",
-            "module": "src/distance-value.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "distance-value",
-          "declaration": {
-            "name": "DistanceValue",
-            "module": "src/distance-value.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/distribution-chart.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Renders a KDE distribution curve for a named metric with one or more value\nmarkers. The SVG viewBox is kept in sync with the element's pixel width via\nResizeObserver so that font sizes and stroke widths are always in real pixels\nregardless of container width.\n\nPass `fontSize` to control all text size (default 11). Pass a single\n`{label:'', value}` for a single-value display or multiple\n`{label:'A'|'B'|...}` entries to compare several values.",
-          "name": "DistributionChart",
-          "members": [
-            {
-              "kind": "field",
-              "name": "metric",
+              "kind": "field",
+              "name": "cancelLabel",
               "type": {
                 "text": "string"
               },
-              "default": "\"\"",
-              "description": "Metric name, fetched from `/api/distribution/<metric>` on change.",
-              "attribute": "metric"
+              "default": "\"Cancel\"",
+              "description": "Label for the cancel button.",
+              "attribute": "cancel-label"
             },
             {
               "kind": "field",
-              "name": "values",
+              "name": "danger",
               "type": {
-                "text": "DistributionValue[]"
+                "text": "boolean"
               },
-              "default": "[]",
-              "description": "One or more values to mark on the distribution curve."
+              "default": "true",
+              "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
+              "attribute": "danger"
             },
             {
               "kind": "field",
-              "name": "markerColors",
+              "name": "busy",
               "type": {
-                "text": "string[]"
+                "text": "boolean"
               },
-              "default": "[\"#4f46e5\", \"#d97706\", \"#0d9488\", \"#e11d48\"]",
-              "description": "Colors assigned to markers in order. Defaults to indigo/amber/teal/rose 600s."
+              "default": "false",
+              "description": "Shows a spinner and disables both buttons while a request is in flight.",
+              "attribute": "busy"
             },
             {
               "kind": "field",
-              "name": "fontSize",
+              "name": "error",
               "type": {
-                "text": "number"
+                "text": "string | null"
               },
-              "default": "11",
-              "description": "Target font size in CSS pixels (default 11). Always renders at this size regardless of container width.",
-              "attribute": "font-size"
+              "default": "null",
+              "description": "Inline error line shown below the body, or null for none.",
+              "attribute": "error"
             },
             {
-              "kind": "field",
-              "name": "_data",
-              "type": {
-                "text": "DistributionData | null"
-              },
-              "privacy": "private",
-              "default": "null"
+              "kind": "method",
+              "name": "_confirm",
+              "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "_loading",
+              "kind": "method",
+              "name": "_cancel",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "confirm",
               "type": {
-                "text": "boolean"
+                "text": "CustomEvent"
               },
-              "privacy": "private",
-              "default": "false"
+              "description": "User clicked the confirm button."
             },
             {
-              "kind": "field",
-              "name": "_error",
+              "name": "cancel",
               "type": {
-                "text": "string | null"
+                "text": "CustomEvent"
               },
-              "privacy": "private",
-              "default": "null"
-            },
+              "description": "User clicked the cancel button."
+            }
+          ],
+          "attributes": [
             {
-              "kind": "field",
-              "name": "_width",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "0",
-              "description": "Measured element width in CSS pixels. 0 until ResizeObserver fires."
+              "default": "false",
+              "description": "Whether the dialog is visible.",
+              "fieldName": "open"
             },
             {
-              "kind": "field",
-              "name": "_hoverX",
+              "name": "confirm-label",
               "type": {
-                "text": "number | null"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "null",
-              "description": "Inner x coordinate (px) of the current hover position, or null when not hovering."
+              "default": "\"Delete\"",
+              "description": "Label for the confirm button.",
+              "fieldName": "confirmLabel"
             },
             {
-              "kind": "field",
-              "name": "_fetchedFor",
+              "name": "cancel-label",
               "type": {
                 "text": "string"
               },
-              "privacy": "private",
-              "default": "\"\""
+              "default": "\"Cancel\"",
+              "description": "Label for the cancel button.",
+              "fieldName": "cancelLabel"
             },
             {
-              "kind": "field",
-              "name": "_ro",
+              "name": "danger",
               "type": {
-                "text": "ResizeObserver | null"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "default": "null"
-            },
-            {
-              "kind": "method",
-              "name": "_maybeFetch",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_renderSvg",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "data",
-                  "type": {
-                    "text": "DistributionData"
-                  }
-                }
-              ]
+              "default": "true",
+              "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
+              "fieldName": "danger"
             },
             {
-              "kind": "method",
-              "name": "_renderLegend",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "data",
-                  "type": {
-                    "text": "DistributionData"
-                  }
-                }
-              ]
-            }
-          ],
-          "attributes": [
-            {
-              "name": "metric",
+              "name": "busy",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"\"",
-              "description": "Metric name, fetched from `/api/distribution/<metric>` on change.",
-              "fieldName": "metric"
+              "default": "false",
+              "description": "Shows a spinner and disables both buttons while a request is in flight.",
+              "fieldName": "busy"
             },
             {
-              "name": "font-size",
+              "name": "error",
               "type": {
-                "text": "number"
+                "text": "string | null"
               },
-              "default": "11",
-              "description": "Target font size in CSS pixels (default 11). Always renders at this size regardless of container width.",
-              "fieldName": "fontSize"
+              "default": "null",
+              "description": "Inline error line shown below the body, or null for none.",
+              "fieldName": "error"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "distribution-chart",
+          "tagName": "confirm-dialog",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "DistributionChart",
+          "name": "ConfirmDialog",
           "declaration": {
-            "name": "DistributionChart",
-            "module": "src/distribution-chart.ts"
+            "name": "ConfirmDialog",
+            "module": "src/confirm-dialog.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "distribution-chart",
+          "name": "confirm-dialog",
           "declaration": {
-            "name": "DistributionChart",
-            "module": "src/distribution-chart.ts"
+            "name": "ConfirmDialog",
+            "module": "src/confirm-dialog.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/dropdown-button.ts",
+      "path": "src/copy-link-button.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A primary-styled button with a label and chevron that opens an anchored\nmenu of actions — essentially `form-select` minus \"current value\"\nsemantics: a menu, not a select. Use for a set of mutually exclusive\nnext-step actions (e.g. a failed task's Retry / Close / Backlog).",
-          "name": "DropdownButton",
+          "description": "Small icon button that copies `value` to the clipboard and shows a toast\non success/failure (if a `<toast-notification>` element is present), and\nalways dispatches a `copy-success`/`copy-error` CustomEvent so consumers\nwithout a toast element can react. Defaults to the current page URL if\n`value` is unset.",
+          "name": "CopyLinkButton",
           "members": [
             {
               "kind": "field",
-              "name": "label",
+              "name": "value",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "The trigger button's label.",
-              "attribute": "label"
+              "description": "Text to copy. Defaults to `window.location.href` at click time.",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "options",
+              "name": "label",
               "type": {
-                "text": "DropdownOption[]"
+                "text": "string"
               },
-              "default": "[]",
-              "description": "The menu's actions."
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Disables the trigger, preventing the menu from opening.",
-              "attribute": "disabled"
-            },
-            {
-              "kind": "field",
-              "name": "_open",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
-            {
-              "kind": "field",
-              "name": "_activeIndex",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private",
-              "default": "-1"
-            },
-            {
-              "kind": "field",
-              "name": "#onWindowMousedown",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "#toggle",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "#select",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "option",
-                  "type": {
-                    "text": "DropdownOption"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "#onTriggerKeydown",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "#moveActive",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "delta",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "#confirmActive",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
+              "default": "\"Copy link\"",
+              "description": "Accessible label / tooltip text.",
+              "attribute": "label"
             },
             {
               "kind": "method",
-              "name": "renderMenu",
+              "name": "_onClick",
               "privacy": "private"
             }
           ],
           "events": [
             {
-              "name": "select",
+              "name": "copy-success",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired with `{ value: string }` when a menu item is picked."
+              "description": "The value was copied to the clipboard."
+            },
+            {
+              "name": "copy-error",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Copying to the clipboard failed."
             }
           ],
           "attributes": [
             {
-              "name": "label",
+              "name": "value",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "The trigger button's label.",
-              "fieldName": "label"
+              "description": "Text to copy. Defaults to `window.location.href` at click time.",
+              "fieldName": "value"
             },
             {
-              "name": "disabled",
+              "name": "label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Disables the trigger, preventing the menu from opening.",
-              "fieldName": "disabled"
+              "default": "\"Copy link\"",
+              "description": "Accessible label / tooltip text.",
+              "fieldName": "label"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "dropdown-button",
+          "tagName": "copy-link-button",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "DropdownButton",
+          "name": "CopyLinkButton",
           "declaration": {
-            "name": "DropdownButton",
-            "module": "src/dropdown-button.ts"
+            "name": "CopyLinkButton",
+            "module": "src/copy-link-button.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "dropdown-button",
+          "name": "copy-link-button",
           "declaration": {
-            "name": "DropdownButton",
-            "module": "src/dropdown-button.ts"
+            "name": "CopyLinkButton",
+            "module": "src/copy-link-button.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/editable-text.ts",
+      "path": "src/data-table.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Jira/GitHub-style click-to-edit text: a display span that turns into an\n`<input>` (or auto-growing `<textarea>` when `multiline`) on click. The\ninput/textarea inherits the host's font, so a title wrapped in an `<h1>`\nedits at title size.",
-          "name": "EditableText",
+          "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
+          "name": "DataTable",
           "members": [
             {
               "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Current text.",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "multiline",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "`false` renders an `<input>`, `true` an auto-growing `<textarea>`.",
-              "attribute": "multiline"
-            },
-            {
-              "kind": "field",
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Muted placeholder text shown when `value` is empty, and as the input's placeholder.",
-              "attribute": "placeholder"
-            },
-            {
-              "kind": "field",
-              "name": "readonly",
+              "name": "columns",
               "type": {
-                "text": "boolean"
+                "text": "DataTableColumn[]"
               },
-              "default": "false",
-              "description": "Disables entering edit mode.",
-              "attribute": "readonly"
+              "default": "[]",
+              "description": "Column headers, in display order."
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "rows",
               "type": {
-                "text": "string"
+                "text": "unknown[]"
               },
-              "default": "\"\"",
-              "description": "`aria-label` applied to the input/textarea.",
-              "attribute": "label"
+              "default": "[]",
+              "description": "Row data; opaque to this component beyond what `renderCell` does with it."
             },
             {
               "kind": "field",
-              "name": "_editing",
+              "name": "rowKey",
               "type": {
-                "text": "boolean"
+                "text": "(row: unknown, index: number) => string | number"
               },
-              "privacy": "private",
-              "default": "false"
+              "description": "Stable identity for `rows[i]`, used as the repeat-directive key. Defaults to the row's index."
             },
             {
               "kind": "field",
-              "name": "_draft",
+              "name": "renderCell",
               "type": {
-                "text": "string"
+                "text": "(row: unknown, key: string) => unknown"
               },
-              "privacy": "private",
-              "default": "\"\""
+              "description": "Produces a cell's rendered content for `row`/`column.key`. Default: `row[key]`."
             },
             {
               "kind": "field",
-              "name": "_field",
+              "name": "rowHref",
               "type": {
-                "text": "HTMLInputElement | HTMLTextAreaElement | undefined"
+                "text": "((row: unknown) => string | null) | null"
               },
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_startEdit",
-              "privacy": "private",
-              "description": "Enters edit mode, seeding the draft from the current value."
-            },
-            {
-              "kind": "method",
-              "name": "_commit",
-              "privacy": "private",
-              "description": "Commits the draft (reverting an empty single-line commit) and exits edit mode.\n\nGuarded on `_editing`: removing the focused input/textarea from the DOM\n(which happens as soon as `_editing` flips to false) makes the browser\nfire a native `blur` on it, re-invoking this handler a second time after\na cancel already ran — the guard makes that second call a no-op instead\nof re-committing the stale draft."
-            },
-            {
-              "kind": "method",
-              "name": "_cancel",
-              "privacy": "private",
-              "description": "Discards the draft and exits edit mode without committing."
+              "default": "null",
+              "description": "When set, clicking a row (outside any nested link/button) navigates to this hash."
             },
             {
               "kind": "method",
-              "name": "_onInput",
+              "name": "#onRowClick",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
               "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "unknown"
+                  }
+                },
                 {
                   "name": "e",
                   "type": {
-                    "text": "Event"
+                    "text": "MouseEvent"
                   }
                 }
               ]
-            },
-            {
-              "kind": "method",
-              "name": "_onSingleLineKeydown",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "_onMultilineKeydown",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ]
-            },
-            {
-              "kind": "method",
-              "name": "_resize",
-              "privacy": "private",
-              "description": "Grows the textarea's height to fit its content."
             }
           ],
-          "events": [
-            {
-              "name": "change",
-              "type": {
-                "text": "CustomEvent"
-              },
-              "description": "Fired with `{ value: string }` when the committed value differs from the previous one."
-            }
-          ],
-          "attributes": [
-            {
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Current text.",
-              "fieldName": "value"
-            },
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "data-table",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DataTable",
+          "declaration": {
+            "name": "DataTable",
+            "module": "src/data-table.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "data-table",
+          "declaration": {
+            "name": "DataTable",
+            "module": "src/data-table.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/distance-value.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Inline distance display. Renders miles/feet or km/m, switching units at\nsensible thresholds (< 0.25 mi → ft; < 0.5 km → m).\n\nSupply exactly one of `miles` or `km`; the other stays null.\nkm support is present but reserved for future use.",
+          "name": "DistanceValue",
+          "members": [
             {
-              "name": "multiline",
+              "kind": "field",
+              "name": "miles",
               "type": {
-                "text": "boolean"
+                "text": "number | null"
               },
-              "default": "false",
-              "description": "`false` renders an `<input>`, `true` an auto-growing `<textarea>`.",
-              "fieldName": "multiline"
+              "default": "null",
+              "description": "Distance in miles (imperial). Switches to feet below 0.25 mi.",
+              "attribute": "miles"
             },
             {
-              "name": "placeholder",
+              "kind": "field",
+              "name": "km",
               "type": {
-                "text": "string"
+                "text": "number | null"
               },
-              "default": "\"\"",
-              "description": "Muted placeholder text shown when `value` is empty, and as the input's placeholder.",
-              "fieldName": "placeholder"
-            },
+              "default": "null",
+              "description": "Distance in kilometers (metric, future). Switches to meters below 0.5 km.",
+              "attribute": "km"
+            }
+          ],
+          "attributes": [
             {
-              "name": "readonly",
+              "name": "miles",
               "type": {
-                "text": "boolean"
+                "text": "number | null"
               },
-              "default": "false",
-              "description": "Disables entering edit mode.",
-              "fieldName": "readonly"
+              "default": "null",
+              "description": "Distance in miles (imperial). Switches to feet below 0.25 mi.",
+              "fieldName": "miles"
             },
             {
-              "name": "label",
+              "name": "km",
               "type": {
-                "text": "string"
+                "text": "number | null"
               },
-              "default": "\"\"",
-              "description": "`aria-label` applied to the input/textarea.",
-              "fieldName": "label"
+              "default": "null",
+              "description": "Distance in kilometers (metric, future). Switches to meters below 0.5 km.",
+              "fieldName": "km"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "editable-text",
+          "tagName": "distance-value",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "EditableText",
+          "name": "DistanceValue",
           "declaration": {
-            "name": "EditableText",
-            "module": "src/editable-text.ts"
+            "name": "DistanceValue",
+            "module": "src/distance-value.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "editable-text",
+          "name": "distance-value",
           "declaration": {
-            "name": "EditableText",
-            "module": "src/editable-text.ts"
+            "name": "DistanceValue",
+            "module": "src/distance-value.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/form-select.ts",
+      "path": "src/distribution-chart.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A styled dropdown select: a trigger button showing the current option's\nlabel, opening a listbox popover on click. Drop-in generic replacement for\na native `<select>` wherever consistent cross-browser styling and a\n`change` event carrying `{ value }` are wanted (e.g. a task's status\npicker).\n\nThe trigger fills its host's width (`justify-content: space-between`\npushes the chevron to the far edge), but the host itself stays\n`display: inline-block` — so usages that never size the host (a filter\nbar, a status picker) keep shrink-to-fit auto-width unchanged. To make an\ninstance full-width, size the host itself: `form-select { width: 100%; }`.",
-          "name": "FormSelect",
+          "description": "Renders a KDE distribution curve for a named metric with one or more value\nmarkers. The SVG viewBox is kept in sync with the element's pixel width via\nResizeObserver so that font sizes and stroke widths are always in real pixels\nregardless of container width.\n\nPass `fontSize` to control all text size (default 11). Pass a single\n`{label:'', value}` for a single-value display or multiple\n`{label:'A'|'B'|...}` entries to compare several values.",
+          "name": "DistributionChart",
           "members": [
             {
               "kind": "field",
-              "name": "options",
+              "name": "metric",
               "type": {
-                "text": "SelectOption[]"
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Metric name, fetched from `/api/distribution/<metric>` on change.",
+              "attribute": "metric"
+            },
+            {
+              "kind": "field",
+              "name": "values",
+              "type": {
+                "text": "DistributionValue[]"
               },
               "default": "[]",
-              "description": "The full list of selectable options."
+              "description": "One or more values to mark on the distribution curve."
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "markerColors",
               "type": {
-                "text": "string"
+                "text": "string[]"
               },
-              "default": "\"\"",
-              "description": "Currently selected value; must match one of `options[].value`.",
-              "attribute": "value"
+              "default": "[\"#4f46e5\", \"#d97706\", \"#0d9488\", \"#e11d48\"]",
+              "description": "Colors assigned to markers in order. Defaults to indigo/amber/teal/rose 600s."
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "fontSize",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "\"\"",
-              "description": "`aria-label` applied to the trigger button.",
-              "attribute": "label"
+              "default": "11",
+              "description": "Target font size in CSS pixels (default 11). Always renders at this size regardless of container width.",
+              "attribute": "font-size"
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "_data",
+              "type": {
+                "text": "DistributionData | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_loading",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Disables the trigger, preventing the popover from opening.",
-              "attribute": "disabled"
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_error",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_width",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Measured element width in CSS pixels. 0 until ResizeObserver fires."
+            },
+            {
+              "kind": "field",
+              "name": "_hoverX",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Inner x coordinate (px) of the current hover position, or null when not hovering."
+            },
+            {
+              "kind": "field",
+              "name": "_fetchedFor",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
+            },
+            {
+              "kind": "field",
+              "name": "_ro",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "method",
+              "name": "_maybeFetch",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderSvg",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "DistributionData"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderLegend",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "data",
+                  "type": {
+                    "text": "DistributionData"
+                  }
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "metric",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Metric name, fetched from `/api/distribution/<metric>` on change.",
+              "fieldName": "metric"
+            },
+            {
+              "name": "font-size",
+              "type": {
+                "text": "number"
+              },
+              "default": "11",
+              "description": "Target font size in CSS pixels (default 11). Always renders at this size regardless of container width.",
+              "fieldName": "fontSize"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "distribution-chart",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DistributionChart",
+          "declaration": {
+            "name": "DistributionChart",
+            "module": "src/distribution-chart.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "distribution-chart",
+          "declaration": {
+            "name": "DistributionChart",
+            "module": "src/distribution-chart.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/dropdown-button.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A primary-styled button with a label and chevron that opens an anchored\nmenu of actions — essentially `form-select` minus \"current value\"\nsemantics: a menu, not a select. Use for a set of mutually exclusive\nnext-step actions (e.g. a failed task's Retry / Close / Backlog).",
+          "name": "DropdownButton",
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The trigger button's label.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "DropdownOption[]"
+              },
+              "default": "[]",
+              "description": "The menu's actions."
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the trigger, preventing the menu from opening.",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_activeIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "-1"
+            },
+            {
+              "kind": "field",
+              "name": "#onWindowMousedown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#toggle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#select",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "DropdownOption"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onTriggerKeydown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#moveActive",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "delta",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#confirmActive",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderMenu",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "select",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired with `{ value: string }` when a menu item is picked."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The trigger button's label.",
+              "fieldName": "label"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the trigger, preventing the menu from opening.",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "dropdown-button",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "DropdownButton",
+          "declaration": {
+            "name": "DropdownButton",
+            "module": "src/dropdown-button.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "dropdown-button",
+          "declaration": {
+            "name": "DropdownButton",
+            "module": "src/dropdown-button.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/editable-text.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Jira/GitHub-style click-to-edit text: a display span that turns into an\n`<input>` (or auto-growing `<textarea>` when `multiline`) on click. The\ninput/textarea inherits the host's font, so a title wrapped in an `<h1>`\nedits at title size.",
+          "name": "EditableText",
+          "members": [
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Current text.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "multiline",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "`false` renders an `<input>`, `true` an auto-growing `<textarea>`.",
+              "attribute": "multiline"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Muted placeholder text shown when `value` is empty, and as the input's placeholder.",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables entering edit mode.",
+              "attribute": "readonly"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "`aria-label` applied to the input/textarea.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "_editing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_draft",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
+            },
+            {
+              "kind": "field",
+              "name": "_field",
+              "type": {
+                "text": "HTMLInputElement | HTMLTextAreaElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_startEdit",
+              "privacy": "private",
+              "description": "Enters edit mode, seeding the draft from the current value."
+            },
+            {
+              "kind": "method",
+              "name": "_commit",
+              "privacy": "private",
+              "description": "Commits the draft (reverting an empty single-line commit) and exits edit mode.\n\nGuarded on `_editing`: removing the focused input/textarea from the DOM\n(which happens as soon as `_editing` flips to false) makes the browser\nfire a native `blur` on it, re-invoking this handler a second time after\na cancel already ran — the guard makes that second call a no-op instead\nof re-committing the stale draft."
+            },
+            {
+              "kind": "method",
+              "name": "_cancel",
+              "privacy": "private",
+              "description": "Discards the draft and exits edit mode without committing."
+            },
+            {
+              "kind": "method",
+              "name": "_onInput",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onSingleLineKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onMultilineKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_resize",
+              "privacy": "private",
+              "description": "Grows the textarea's height to fit its content."
+            }
+          ],
+          "events": [
+            {
+              "name": "change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired with `{ value: string }` when the committed value differs from the previous one."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Current text.",
+              "fieldName": "value"
+            },
+            {
+              "name": "multiline",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "`false` renders an `<input>`, `true` an auto-growing `<textarea>`.",
+              "fieldName": "multiline"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Muted placeholder text shown when `value` is empty, and as the input's placeholder.",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables entering edit mode.",
+              "fieldName": "readonly"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "`aria-label` applied to the input/textarea.",
+              "fieldName": "label"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "editable-text",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "EditableText",
+          "declaration": {
+            "name": "EditableText",
+            "module": "src/editable-text.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "editable-text",
+          "declaration": {
+            "name": "EditableText",
+            "module": "src/editable-text.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/form-select.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A styled dropdown select: a trigger button showing the current option's\nlabel, opening a listbox popover on click. Drop-in generic replacement for\na native `<select>` wherever consistent cross-browser styling and a\n`change` event carrying `{ value }` are wanted (e.g. a task's status\npicker).\n\nThe trigger fills its host's width (`justify-content: space-between`\npushes the chevron to the far edge), but the host itself stays\n`display: inline-block` — so usages that never size the host (a filter\nbar, a status picker) keep shrink-to-fit auto-width unchanged. To make an\ninstance full-width, size the host itself: `form-select { width: 100%; }`.\n\nSet `searchable` to replace the button trigger with an editable combobox\nthat filters the predefined options by case-insensitive label infix. Typed\ntext is only a query: `value` changes exclusively when an actual option is\nselected, and an uncommitted query is discarded when the list closes.\nEach option may also provide a pre-rendered `icon` and square `iconSize`;\niconless options reserve no leading space.",
+          "name": "FormSelect",
+          "members": [
+            {
+              "kind": "field",
+              "name": "options",
+              "type": {
+                "text": "SelectOption[]"
+              },
+              "default": "[]",
+              "description": "The full list of selectable options."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Currently selected value; must match one of `options[].value`.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "`aria-label` applied to the trigger button.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the trigger, preventing the popover from opening.",
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "searchable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables editable, case-insensitive infix filtering by option label.\nTyped text never becomes the selected `value`.",
+              "attribute": "searchable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_activeIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "-1"
+            },
+            {
+              "kind": "field",
+              "name": "_query",
+              "type": {
+                "text": "string | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#listboxPointerDown",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#suppressNextBlur",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#restoringSearchFocus",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#searchSelection",
+              "privacy": "private",
+              "type": {
+                "text": "[number | null, number | null] | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#isComposing",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#compositionJustEnded",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "#compositionEndTimer",
+              "privacy": "private",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#blurTimer",
+              "privacy": "private",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | null"
+              },
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "#onWindowMousedown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "#toggle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#open",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#close",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#initialActiveIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#visibleOptions",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SelectOption[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#select",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "SelectOption"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onTriggerKeydown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#moveActive",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "delta",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#confirmActive",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "#onSearchFocus",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onSearchClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onSearchMousedown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onSearchInput",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "InputEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#onSearchKeydown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "_open",
-              "type": {
-                "text": "boolean"
-              },
+              "kind": "method",
+              "name": "#onSearchBlur",
               "privacy": "private",
-              "default": "false"
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "_activeIndex",
-              "type": {
-                "text": "number"
-              },
+              "kind": "method",
+              "name": "#focusSearchInput",
               "privacy": "private",
-              "default": "-1"
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "#onWindowMousedown",
-              "privacy": "private"
+              "kind": "method",
+              "name": "#onCompositionStart",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
             },
             {
               "kind": "method",
-              "name": "#toggle",
+              "name": "#onCompositionEnd",
               "privacy": "private",
               "return": {
                 "type": {
@@ -2520,7 +3522,7 @@
             },
             {
               "kind": "method",
-              "name": "#select",
+              "name": "#onListboxMousedown",
               "privacy": "private",
               "return": {
                 "type": {
@@ -2529,16 +3531,16 @@
               },
               "parameters": [
                 {
-                  "name": "option",
+                  "name": "e",
                   "type": {
-                    "text": "SelectOption"
+                    "text": "MouseEvent"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "#onTriggerKeydown",
+              "name": "#onOptionMousedown",
               "privacy": "private",
               "return": {
                 "type": {
@@ -2549,43 +3551,95 @@
                 {
                   "name": "e",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "MouseEvent"
+                  }
+                },
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "SelectOption"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "#moveActive",
+              "name": "#optionIconSize",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "number"
                 }
               },
               "parameters": [
                 {
-                  "name": "delta",
+                  "name": "option",
                   "type": {
-                    "text": "number"
+                    "text": "SelectOption"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "#confirmActive",
+              "name": "#renderOptionIcon",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "SelectOption"
+                  }
+                },
+                {
+                  "name": "className",
+                  "default": "\"option-icon\""
                 }
-              }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "#renderOptionContent",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "SelectOption"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
               "name": "renderListbox",
               "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderSearchTrigger",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "current",
+                  "type": {
+                    "text": "SelectOption | undefined"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderButtonTrigger",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "current",
+                  "type": {
+                    "text": "SelectOption | undefined"
+                  }
+                }
+              ]
             }
           ],
           "events": [
@@ -2624,6 +3678,15 @@
               "default": "false",
               "description": "Disables the trigger, preventing the popover from opening.",
               "fieldName": "disabled"
+            },
+            {
+              "name": "searchable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables editable, case-insensitive infix filtering by option label.\nTyped text never becomes the selected `value`.",
+              "fieldName": "searchable"
             }
           ],
           "superclass": {
@@ -3985,14 +5048,6 @@
             "module": "./map-circle.js"
           }
         },
-        {
-          "kind": "js",
-          "name": "MapPoint",
-          "declaration": {
-            "name": "MapPoint",
-            "module": "./map-point.js"
-          }
-        },
         {
           "kind": "js",
           "name": "RadioCards",
@@ -4185,6 +5240,30 @@
             "module": "./frame-box.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "CalendarEntry",
+          "declaration": {
+            "name": "CalendarEntry",
+            "module": "./calendar-entry.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CalendarMonth",
+          "declaration": {
+            "name": "CalendarMonth",
+            "module": "./calendar-month.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CalendarYear",
+          "declaration": {
+            "name": "CalendarYear",
+            "module": "./calendar-year.js"
+          }
+        },
         {
           "kind": "js",
           "name": "formatDuration",
@@ -4370,7 +5449,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A plain circular map marker: a light-to-dark gradient fill with a white\nouter ring, no point/tail (unlike `<map-pin>`) — for markers that don't\nneed to visually \"point\" at their exact coordinate. Purely a visual\nprimitive — it has no `mapbox-gl` (or any mapping library) dependency;\nthe consumer positions it, e.g. via `new mapboxgl.Marker({ element: el })`.",
+          "description": "A plain circular map marker: a light-to-dark gradient fill with a white\nouter ring, no point/tail (unlike `<map-pin>`) — for markers that don't\nneed to visually \"point\" at their exact coordinate. Purely a visual\nprimitive — it has no `mapbox-gl` (or any mapping library) dependency;\nthe consumer positions it, e.g. via `new mapboxgl.Marker({ element: el })`.\nIt can also replace the former `<map-point>` dense-layer primitive: use\n`size=\"14\" ring-width=\"3\"`, leave the slot empty, and rasterize one marker\nper color for use as a map `icon-image`.",
           "name": "MapCircle",
           "slots": [
             {
@@ -4499,118 +5578,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A circular \"Apple Maps\"-style map pin: a light-to-dark gradient fill with\na slight point at the bottom. Purely a visual primitive — it has no\n`mapbox-gl` (or any mapping library) dependency; the consumer positions\nit, e.g. via `new mapboxgl.Marker({ element: pinEl })`.",
-          "name": "MapPin",
-          "slots": [
-            {
-              "description": "Badge content shown centered on the pin's circular head — a rank number, an emoji, a small icon.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"#4f46e5\"",
-              "description": "Fill color; the gradient's light (top) and dark (bottom) stops are derived from this.",
-              "attribute": "color"
-            },
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "number"
-              },
-              "default": "32",
-              "description": "Diameter of the circular head, in CSS pixels.",
-              "attribute": "size"
-            },
-            {
-              "kind": "field",
-              "name": "highlighted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Scales and glows the pin — a generic emphasis state (e.g. hover, selection).",
-              "attribute": "highlighted",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "_gradId",
-              "privacy": "private",
-              "readonly": true,
-              "default": "`map-pin-grad-${gradientIdCounter++}`"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"#4f46e5\"",
-              "description": "Fill color; the gradient's light (top) and dark (bottom) stops are derived from this.",
-              "fieldName": "color"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "number"
-              },
-              "default": "32",
-              "description": "Diameter of the circular head, in CSS pixels.",
-              "fieldName": "size"
-            },
-            {
-              "name": "highlighted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Scales and glows the pin — a generic emphasis state (e.g. hover, selection).",
-              "fieldName": "highlighted"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "map-pin",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "MapPin",
-          "declaration": {
-            "name": "MapPin",
-            "module": "src/map-pin.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "map-pin",
-          "declaration": {
-            "name": "MapPin",
-            "module": "src/map-pin.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/map-point.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "A small plain-colored map marker for dense point layers (transit stops,\namenities, hazard points, etc.): a light-to-dark gradient fill with a thin\nwhite ring, no badge/content slot — every instance on a given layer shares\nthe same look, so there's nothing to render per-feature (unlike\n`<map-pin>`/`<map-circle>`, which carry per-marker slotted content).\nPurely a visual primitive — it has no `mapbox-gl` (or any mapping library)\ndependency; typically rasterized once per color and used as a Mapbox\n`icon-image` on a `symbol` layer rather than mounted as individual DOM\nmarkers, so a whole layer's worth of points shares one icon image.",
-          "name": "MapPoint",
+          "description": "A circular \"Apple Maps\"-style map pin: a light-to-dark gradient fill with\na slight point at the bottom. Purely a visual primitive — it has no\n`mapbox-gl` (or any mapping library) dependency; the consumer positions\nit, e.g. via `new mapboxgl.Marker({ element: pinEl })`.",
+          "name": "MapPin",
+          "slots": [
+            {
+              "description": "Badge content shown centered on the pin's circular head — a rank number, an emoji, a small icon.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -4628,26 +5603,27 @@
               "type": {
                 "text": "number"
               },
-              "default": "14",
-              "description": "Diameter, in CSS pixels.",
+              "default": "32",
+              "description": "Diameter of the circular head, in CSS pixels.",
               "attribute": "size"
             },
             {
               "kind": "field",
-              "name": "ringWidth",
+              "name": "highlighted",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "3",
-              "description": "White outer ring thickness, in the same viewBox units as `size` (scales with it).",
-              "attribute": "ring-width"
+              "default": "false",
+              "description": "Scales and glows the pin — a generic emphasis state (e.g. hover, selection).",
+              "attribute": "highlighted",
+              "reflects": true
             },
             {
               "kind": "field",
               "name": "_gradId",
               "privacy": "private",
               "readonly": true,
-              "default": "`map-point-grad-${gradientIdCounter++}`"
+              "default": "`map-pin-grad-${gradientIdCounter++}`"
             }
           ],
           "attributes": [
@@ -4665,43 +5641,43 @@
               "type": {
                 "text": "number"
               },
-              "default": "14",
-              "description": "Diameter, in CSS pixels.",
+              "default": "32",
+              "description": "Diameter of the circular head, in CSS pixels.",
               "fieldName": "size"
             },
             {
-              "name": "ring-width",
+              "name": "highlighted",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "3",
-              "description": "White outer ring thickness, in the same viewBox units as `size` (scales with it).",
-              "fieldName": "ringWidth"
+              "default": "false",
+              "description": "Scales and glows the pin — a generic emphasis state (e.g. hover, selection).",
+              "fieldName": "highlighted"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "map-point",
+          "tagName": "map-pin",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "MapPoint",
+          "name": "MapPin",
           "declaration": {
-            "name": "MapPoint",
-            "module": "src/map-point.ts"
+            "name": "MapPin",
+            "module": "src/map-pin.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "map-point",
+          "name": "map-pin",
           "declaration": {
-            "name": "MapPoint",
-            "module": "src/map-point.ts"
+            "name": "MapPin",
+            "module": "src/map-pin.ts"
           }
         }
       ]
@@ -6709,7 +7685,7 @@
           "type": {
             "text": "Record<string, string>"
           },
-          "default": "{ // Colors \"--ui-primary\": \"#4f46e5\", // indigo-600 \"--ui-primary-hover\": \"#4338ca\", // indigo-700 \"--ui-danger\": \"#dc2626\", // red-600 \"--ui-danger-hover\": \"#b91c1c\", // red-700 \"--ui-success\": \"#16a34a\", // green-600 \"--ui-text\": \"#0f172a\", // slate-900 \"--ui-text-muted\": \"#64748b\", // slate-500 \"--ui-border\": \"#e2e8f0\", // slate-200 \"--ui-surface\": \"#ffffff\", // white \"--ui-surface-muted\": \"#f8fafc\", // slate-50 \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded \"--ui-shadow\": \"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)\", // shadow-md \"--ui-shadow-lg\": \"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)\", // shadow-xl \"--ui-focus-ring\": \"0 0 0 3px rgb(79 70 229 / 0.35)\", // Type \"--ui-font\": 'ui-sans-serif, system-ui, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"', \"--ui-font-size\": \"0.875rem\", \"--ui-font-size-sm\": \"0.75rem\", }",
+          "default": "{ // Colors \"--ui-primary\": \"#4f46e5\", // indigo-600 \"--ui-primary-hover\": \"#4338ca\", // indigo-700 \"--ui-danger\": \"#dc2626\", // red-600 \"--ui-danger-hover\": \"#b91c1c\", // red-700 \"--ui-success\": \"#16a34a\", // green-600 \"--ui-text\": \"#0f172a\", // slate-900 \"--ui-text-muted\": \"#64748b\", // slate-500 \"--ui-border\": \"#e2e8f0\", // slate-200 \"--ui-surface\": \"#ffffff\", // white \"--ui-surface-muted\": \"#f8fafc\", // slate-50 \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.32)\", \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded \"--ui-shadow\": \"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)\", // shadow-md \"--ui-shadow-lg\": \"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)\", // shadow-xl \"--ui-focus-ring\": \"0 0 0 3px rgb(79 70 229 / 0.35)\", // Type \"--ui-font\": 'ui-sans-serif, system-ui, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"', \"--ui-font-size\": \"0.875rem\", \"--ui-font-size-sm\": \"0.75rem\", \"--ui-font-size-xs\": \"0.6875rem\", }",
           "description": "Design token values, sourced from Tailwind v4's default theme palette.\nEach entry maps a `--ui-*` custom property name to its default value.\nThese are the same values baked in as `var(--ui-*, <fallback>)` fallbacks\nthroughout component styles, so components render correctly with zero\nexternal CSS. Consumers may override any of these by setting the custom\nproperty on `:root` or an ancestor element (see `tokens.css`)."
         },
         {
@@ -6718,7 +7694,7 @@
           "type": {
             "text": "Record<string, string>"
           },
-          "default": "{ \"--ui-primary\": \"#6366f1\", // indigo-500 \"--ui-primary-hover\": \"#818cf8\", // indigo-400 \"--ui-danger\": \"#ef4444\", // red-500 \"--ui-danger-hover\": \"#f87171\", // red-400 \"--ui-success\": \"#22c55e\", // green-500 \"--ui-text\": \"#f1f5f9\", // slate-100 \"--ui-text-muted\": \"#94a3b8\", // slate-400 \"--ui-border\": \"#334155\", // slate-700 \"--ui-surface\": \"#0f172a\", // slate-900 \"--ui-surface-muted\": \"#1e293b\", // slate-800 \"--ui-overlay\": \"rgb(2 6 23 / 0.6)\", // slate-950 / 60% \"--ui-focus-ring\": \"0 0 0 3px rgb(99 102 241 / 0.45)\", }",
+          "default": "{ \"--ui-primary\": \"#6366f1\", // indigo-500 \"--ui-primary-hover\": \"#818cf8\", // indigo-400 \"--ui-danger\": \"#ef4444\", // red-500 \"--ui-danger-hover\": \"#f87171\", // red-400 \"--ui-success\": \"#22c55e\", // green-500 \"--ui-text\": \"#f1f5f9\", // slate-100 \"--ui-text-muted\": \"#94a3b8\", // slate-400 \"--ui-border\": \"#334155\", // slate-700 \"--ui-surface\": \"#0f172a\", // slate-900 \"--ui-surface-muted\": \"#1e293b\", // slate-800 \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.12)\", \"--ui-overlay\": \"rgb(2 6 23 / 0.6)\", // slate-950 / 60% \"--ui-focus-ring\": \"0 0 0 3px rgb(99 102 241 / 0.45)\", }",
           "description": "Dark-mode overrides for the same `--ui-*` custom properties, applied by\n`tokens.css` via `@media (prefers-color-scheme: dark)` and `[data-theme]`\n(see generate-tokens-css.mjs). Same Tailwind slate scale as the light\npalette, inverted, with primary/danger/success lightened one step (500\ninstead of 600) for sufficient contrast against dark surfaces. Shape/type\ntokens are theme-independent and not repeated here."
         },
         {
@@ -7092,6 +8068,300 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/calendar.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "CALENDAR_ENTRY_ATTRIBUTES",
+          "type": {
+            "text": "array"
+          },
+          "default": "[\"start\", \"end\", \"label\", \"color\", \"href\", \"slot\"]",
+          "description": "Attributes whose mutations can change a rendered calendar entry."
+        },
+        {
+          "kind": "function",
+          "name": "daysInMonth",
+          "return": {
+            "type": {
+              "text": "number"
+            }
+          },
+          "parameters": [
+            {
+              "name": "year",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "month",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Number of days in `month` (1-12) of `year`, leap years included."
+        },
+        {
+          "kind": "function",
+          "name": "parseIsoDate",
+          "return": {
+            "type": {
+              "text": "Date | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "iso",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Parses `\"YYYY-MM-DD\"` as a local-midnight `Date`. Returns `null` for\nanything that doesn't match or doesn't round-trip (e.g. \"2026-02-30\") —\ndeliberately never uses `new Date(iso)`/`.toISOString()`, both of which\nare UTC-based and would silently shift the date in negative-UTC-offset\ntimezones."
+        },
+        {
+          "kind": "function",
+          "name": "toIsoDate",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "date",
+              "type": {
+                "text": "Date"
+              }
+            }
+          ],
+          "description": "Formats a `Date`'s local year/month/day as `\"YYYY-MM-DD\"`."
+        },
+        {
+          "kind": "function",
+          "name": "monthName",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "month",
+              "type": {
+                "text": "number"
+              }
+            }
+          ],
+          "description": "Locale-aware full month name for `month` (1-12)."
+        },
+        {
+          "kind": "variable",
+          "name": "WEEKDAY_ABBR",
+          "type": {
+            "text": "readonly string[]"
+          },
+          "default": "[\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"]",
+          "description": "Sunday-first weekday abbreviations, indexed by `Date.getDay()` (0 = Sunday)."
+        },
+        {
+          "kind": "function",
+          "name": "isWeekend",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "date",
+              "type": {
+                "text": "Date"
+              }
+            }
+          ],
+          "description": "Whether `date` falls on a Saturday or Sunday, per JS's `Date.getDay()`\nconvention (Sunday = 0 .. Saturday = 6) — note this differs from Python's\n`calendar` module (Monday = 0), which the original reference\nimplementation this component's layout is based on used."
+        },
+        {
+          "kind": "function",
+          "name": "readCalendarEntryElement",
+          "return": {
+            "type": {
+              "text": "CalendarEntryData"
+            }
+          },
+          "parameters": [
+            {
+              "name": "el",
+              "type": {
+                "text": "CalendarEntry"
+              }
+            }
+          ],
+          "description": "Reads a `calendar-entry` element's properties and named text slots into plain data."
+        },
+        {
+          "kind": "function",
+          "name": "resolveEntry",
+          "return": {
+            "type": {
+              "text": "ResolvedCalendarEntry | null"
+            }
+          },
+          "parameters": [
+            {
+              "name": "data",
+              "type": {
+                "text": "CalendarEntryData"
+              }
+            }
+          ],
+          "description": "Resolves a `CalendarEntryData`'s date strings to `Date`s. Returns `null`\nwhen `start` is missing or unparseable — such entries are dropped\nsilently rather than thrown, since this reads declarative markup a\nconsumer authored, not validated user input. A blank `end` defaults to\n`start` (single-day entry); an `end` before `start` is clamped up to\n`start` rather than treated as an error."
+        },
+        {
+          "kind": "function",
+          "name": "overlapsRange",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "entry",
+              "type": {
+                "text": "ResolvedCalendarEntry"
+              }
+            },
+            {
+              "name": "rangeStart",
+              "type": {
+                "text": "Date"
+              }
+            },
+            {
+              "name": "rangeEnd",
+              "type": {
+                "text": "Date"
+              }
+            }
+          ],
+          "description": "Whether `entry`'s inclusive date range intersects the inclusive `[rangeStart, rangeEnd]` range."
+        },
+        {
+          "kind": "function",
+          "name": "assignLanes",
+          "return": {
+            "type": {
+              "text": "{\n  entries: LanedEntry[];\n  laneCount: number;\n}"
+            }
+          },
+          "parameters": [
+            {
+              "name": "entries",
+              "type": {
+                "text": "ResolvedCalendarEntry[]"
+              }
+            }
+          ],
+          "description": "Assigns each entry a 0-based stacking lane via greedy interval\npartitioning (\"meeting rooms II\"): entries are sorted by start date, then\neach is placed in the lowest-numbered lane whose current occupant ends\nstrictly before the entry starts. Because entry ranges are\ninclusive-inclusive, an entry ending on day X and one starting on day X\nboth occupy day X and must not share a lane — hence the strict `<`.\n\nLane assignment is meant to be computed independently per `calendar-month`\n(from only the entries overlapping that month); an entry spanning a month\nboundary may therefore land in a different lane in adjacent months. This\nis an accepted v1 limitation, not a bug."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "CALENDAR_ENTRY_ATTRIBUTES",
+          "declaration": {
+            "name": "CALENDAR_ENTRY_ATTRIBUTES",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "daysInMonth",
+          "declaration": {
+            "name": "daysInMonth",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseIsoDate",
+          "declaration": {
+            "name": "parseIsoDate",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "toIsoDate",
+          "declaration": {
+            "name": "toIsoDate",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "monthName",
+          "declaration": {
+            "name": "monthName",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "WEEKDAY_ABBR",
+          "declaration": {
+            "name": "WEEKDAY_ABBR",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isWeekend",
+          "declaration": {
+            "name": "isWeekend",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "readCalendarEntryElement",
+          "declaration": {
+            "name": "readCalendarEntryElement",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "resolveEntry",
+          "declaration": {
+            "name": "resolveEntry",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "overlapsRange",
+          "declaration": {
+            "name": "overlapsRange",
+            "module": "src/utils/calendar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "assignLanes",
+          "declaration": {
+            "name": "assignLanes",
+            "module": "src/utils/calendar.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/color.ts",