@vielzeug/codex 26.10.12 → 26.10.14

package/data/refine.json

@@ -735,7 +735,7 @@
     },
     "parameters": [
       {
-        "name": "{\n  boundary,\n  getDir,\n  getFloating,\n  getOffsetPx = () => 0,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  onPlacementChange,\n  padding = 6,\n  useClippingAncestor = true,\n}",
+        "name": "{\n  boundary,\n  getDir,\n  getFloating,\n  getOffsetPx = () => 0,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  onPlacementChange,\n  padding = 6,\n  shiftMainAxis = false,\n  useClippingAncestor = true,\n}",
         "type": {
           "text": "DropdownPositionerOptions"
         }
@@ -1729,182 +1729,48 @@
     ]
   },
   {
-    "kind": "variable",
-    "name": "CARD_TAG",
-    "type": {
-      "text": "'ore-card'"
+    "kind": "function",
+    "name": "syncCoverflow",
+    "return": {
+      "type": {
+        "text": "void"
+      }
     },
-    "default": "'ore-card'",
-    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions."
-  },
-  {
-    "kind": "class",
-    "name": "OreCardElement",
-    "tagName": "ore-card",
-    "customElement": true,
-    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'frost'"
-        },
-        "description": "Visual variant: 'solid' | 'flat' | 'frost'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      },
-      {
-        "name": "padding",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
-        },
-        "description": "Internal padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
-      },
-      {
-        "name": "elevation",
-        "type": {
-          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
-        },
-        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
-      },
-      {
-        "name": "orientation",
-        "type": {
-          "text": "string"
-        },
-        "description": "Card layout: 'horizontal'"
-      },
+    "parameters": [
       {
-        "name": "interactive",
+        "name": "slides",
         "type": {
-          "text": "boolean"
-        },
-        "description": "Enable pointer/keyboard activation"
+          "text": "HTMLElement[]"
+        }
       },
       {
-        "name": "disabled",
+        "name": "current",
         "type": {
-          "text": "boolean"
-        },
-        "description": "Disable card interaction"
+          "text": "number"
+        }
       },
       {
-        "name": "loading",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Show loading progress bar"
-      }
-    ],
-    "events": [
-      {
-        "name": "activate",
-        "description": "Emitted when an interactive card is activated. detail: { originalEvent: MouseEvent | KeyboardEvent; trigger: 'pointer' | 'keyboard' }",
+        "name": "options",
         "type": {
-          "text": "CustomEvent"
+          "text": "{ extent: number; horizontal: boolean; loop: boolean; rtl: boolean; size: number; spacing: number }"
         }
       }
-    ],
-    "slots": [
-      {
-        "name": "media",
-        "description": "Media content displayed at top/left"
-      },
-      {
-        "name": "header",
-        "description": "Card header (title, subtitle)"
-      },
-      {
-        "name": "",
-        "description": "Main card content"
-      },
-      {
-        "name": "footer",
-        "description": "Card footer content"
-      },
-      {
-        "name": "actions",
-        "description": "Action buttons or links"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "card",
-        "description": "Card root container."
-      },
-      {
-        "name": "loading-bar",
-        "description": "Loading progress bar."
-      },
-      {
-        "name": "media",
-        "description": "Media slot container."
-      },
-      {
-        "name": "body",
-        "description": "Body content container."
-      },
-      {
-        "name": "header",
-        "description": "Header container."
-      },
-      {
-        "name": "content",
-        "description": "Content container."
-      },
-      {
-        "name": "footer",
-        "description": "Footer container."
-      },
-      {
-        "name": "actions",
-        "description": "Actions slot container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--card-bg",
-        "description": "Background color"
-      },
-      {
-        "name": "--card-color",
-        "description": "Text color"
-      },
-      {
-        "name": "--card-border",
-        "description": "Border width"
-      },
-      {
-        "name": "--card-border-color",
-        "description": "Border color"
-      },
-      {
-        "name": "--card-radius",
-        "description": "Border radius"
-      },
-      {
-        "name": "--card-padding",
-        "description": "Internal padding"
-      },
-      {
-        "name": "--card-shadow",
-        "description": "Box shadow"
-      },
-      {
-        "name": "--card-hover-shadow",
-        "description": "Shadow on hover"
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "clearCoverflow",
+    "return": {
+      "type": {
+        "text": "void"
       }
-    ],
-    "demos": [
+    },
+    "parameters": [
       {
-        "url": "",
-        "description": "```html\n<ore-card elevation=\"2\"><h3 slot=\"header\">Title</h3><p>Content</p></ore-card>\n<ore-card interactive color=\"primary\"><h3 slot=\"header\">Click me</h3></ore-card>\n<ore-card variant=\"frost\" color=\"secondary\">Frosted card</ore-card>\n```"
+        "name": "slide",
+        "type": {
+          "text": "HTMLElement"
+        }
       }
     ]
   },
@@ -1937,9 +1803,9 @@
     "kind": "variable",
     "name": "CAROUSEL_VARIANTS",
     "type": {
-      "text": "['default', 'fade', 'filmstrip', 'gallery']"
+      "text": "['default', 'fade', 'filmstrip', 'gallery', 'coverflow']"
     },
-    "default": "['default', 'fade', 'filmstrip', 'gallery']"
+    "default": "['default', 'fade', 'filmstrip', 'gallery', 'coverflow']"
   },
   {
     "kind": "variable",
@@ -2003,9 +1869,9 @@
       {
         "name": "variant",
         "type": {
-          "text": "'default' | 'fade' | 'filmstrip' | 'gallery'"
+          "text": "'default' | 'fade' | 'filmstrip' | 'gallery' | 'coverflow'"
         },
-        "description": "'default' | 'fade' | 'filmstrip' | 'gallery'"
+        "description": "'default' | 'fade' | 'filmstrip' | 'gallery' | 'coverflow'"
       },
       {
         "name": "show-controls",
@@ -2106,6 +1972,18 @@
       {
         "name": "--carousel-gallery-gap",
         "description": "Gap between slides in gallery mode (default var(--size-2))"
+      },
+      {
+        "name": "--carousel-coverflow-size",
+        "description": "Card extent along the navigation axis (default var(--size-40))"
+      },
+      {
+        "name": "--carousel-coverflow-spacing",
+        "description": "Distance between cover centers (default var(--size-12))"
+      },
+      {
+        "name": "--carousel-coverflow-perspective",
+        "description": "Coverflow perspective (default calc(var(--size-64) * 4))"
       }
     ],
     "demos": [
@@ -2117,79 +1995,259 @@
   },
   {
     "kind": "variable",
-    "name": "CHAT_MESSAGE_STATUSES",
-    "type": {
-      "text": "['error', 'sending', 'sent']"
-    },
-    "default": "['error', 'sending', 'sent']"
-  },
-  {
-    "kind": "variable",
-    "name": "CHAT_MESSAGE_TAG",
+    "name": "CARD_TAG",
     "type": {
-      "text": "'ore-chat-message'"
+      "text": "'ore-card'"
     },
-    "default": "'ore-chat-message'",
-    "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\n\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time."
+    "default": "'ore-card'",
+    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions."
   },
   {
     "kind": "class",
-    "name": "OreChatMessageElement",
-    "tagName": "ore-chat-message",
+    "name": "OreCardElement",
+    "tagName": "ore-card",
     "customElement": true,
-    "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time.",
+    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions.",
     "summary": "",
     "attributes": [
       {
-        "name": "sender",
+        "name": "variant",
         "type": {
-          "text": "'user' | 'assistant' | 'system'"
+          "text": "'solid' | 'flat' | 'frost'"
         },
-        "description": "Who sent the message: 'user' | 'assistant' | 'system' (default 'assistant')"
+        "description": "Visual variant: 'solid' | 'flat' | 'frost'"
       },
       {
-        "name": "name",
+        "name": "color",
         "type": {
-          "text": "string"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Display name shown above the bubble"
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "timestamp",
+        "name": "padding",
         "type": {
-          "text": "string"
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
         },
-        "description": "ISO 8601 timestamp, rendered as a localized short time"
+        "description": "Internal padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
       },
       {
-        "name": "status",
+        "name": "elevation",
         "type": {
-          "text": "'sending' | 'sent' | 'error'"
+          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
         },
-        "description": "Delivery status: 'sending' | 'sent' | 'error'"
+        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
       },
       {
-        "name": "error",
+        "name": "orientation",
         "type": {
           "text": "string"
         },
-        "description": "Error detail shown beneath the bubble when status=\"error\""
+        "description": "Card layout: 'horizontal'"
       },
       {
-        "name": "streaming",
+        "name": "interactive",
         "type": {
           "text": "boolean"
         },
-        "description": "Append a blinking cursor after the content"
-      }
-    ],
-    "events": [
+        "description": "Enable pointer/keyboard activation"
+      },
       {
-        "name": "retry",
-        "description": "Fired when the retry action is activated. detail: { originalEvent }",
+        "name": "disabled",
         "type": {
-          "text": "CustomEvent"
-        }
+          "text": "boolean"
+        },
+        "description": "Disable card interaction"
+      },
+      {
+        "name": "loading",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Show loading progress bar"
+      }
+    ],
+    "events": [
+      {
+        "name": "activate",
+        "description": "Emitted when an interactive card is activated. detail: { originalEvent: MouseEvent | KeyboardEvent; trigger: 'pointer' | 'keyboard' }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "media",
+        "description": "Media content displayed at top/left"
+      },
+      {
+        "name": "header",
+        "description": "Card header (title, subtitle)"
+      },
+      {
+        "name": "",
+        "description": "Main card content"
+      },
+      {
+        "name": "footer",
+        "description": "Card footer content"
+      },
+      {
+        "name": "actions",
+        "description": "Action buttons or links"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "card",
+        "description": "Card root container."
+      },
+      {
+        "name": "loading-bar",
+        "description": "Loading progress bar."
+      },
+      {
+        "name": "media",
+        "description": "Media slot container."
+      },
+      {
+        "name": "body",
+        "description": "Body content container."
+      },
+      {
+        "name": "header",
+        "description": "Header container."
+      },
+      {
+        "name": "content",
+        "description": "Content container."
+      },
+      {
+        "name": "footer",
+        "description": "Footer container."
+      },
+      {
+        "name": "actions",
+        "description": "Actions slot container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--card-bg",
+        "description": "Background color"
+      },
+      {
+        "name": "--card-color",
+        "description": "Text color"
+      },
+      {
+        "name": "--card-border",
+        "description": "Border width"
+      },
+      {
+        "name": "--card-border-color",
+        "description": "Border color"
+      },
+      {
+        "name": "--card-radius",
+        "description": "Border radius"
+      },
+      {
+        "name": "--card-padding",
+        "description": "Internal padding"
+      },
+      {
+        "name": "--card-shadow",
+        "description": "Box shadow"
+      },
+      {
+        "name": "--card-hover-shadow",
+        "description": "Shadow on hover"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-card elevation=\"2\"><h3 slot=\"header\">Title</h3><p>Content</p></ore-card>\n<ore-card interactive color=\"primary\"><h3 slot=\"header\">Click me</h3></ore-card>\n<ore-card variant=\"frost\" color=\"secondary\">Frosted card</ore-card>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "CHAT_MESSAGE_STATUSES",
+    "type": {
+      "text": "['error', 'sending', 'sent']"
+    },
+    "default": "['error', 'sending', 'sent']"
+  },
+  {
+    "kind": "variable",
+    "name": "CHAT_MESSAGE_TAG",
+    "type": {
+      "text": "'ore-chat-message'"
+    },
+    "default": "'ore-chat-message'",
+    "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\n\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time."
+  },
+  {
+    "kind": "class",
+    "name": "OreChatMessageElement",
+    "tagName": "ore-chat-message",
+    "customElement": true,
+    "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "sender",
+        "type": {
+          "text": "'user' | 'assistant' | 'system'"
+        },
+        "description": "Who sent the message: 'user' | 'assistant' | 'system' (default 'assistant')"
+      },
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        },
+        "description": "Display name shown above the bubble"
+      },
+      {
+        "name": "timestamp",
+        "type": {
+          "text": "string"
+        },
+        "description": "ISO 8601 timestamp, rendered as a localized short time"
+      },
+      {
+        "name": "status",
+        "type": {
+          "text": "'sending' | 'sent' | 'error'"
+        },
+        "description": "Delivery status: 'sending' | 'sent' | 'error'"
+      },
+      {
+        "name": "error",
+        "type": {
+          "text": "string"
+        },
+        "description": "Error detail shown beneath the bubble when status=\"error\""
+      },
+      {
+        "name": "streaming",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Append a blinking cursor after the content"
+      }
+    ],
+    "events": [
+      {
+        "name": "retry",
+        "description": "Fired when the retry action is activated. detail: { originalEvent }",
+        "type": {
+          "text": "CustomEvent"
+        }
       }
     ],
     "slots": [
@@ -3586,10 +3644,10 @@
     "kind": "variable",
     "name": "SPEECH_RATES",
     "type": {
-      "text": "[1, 0.85, 1.15]"
+      "text": "[1, 0.85, 1.15, 1.5]"
     },
-    "default": "[1, 0.85, 1.15]",
-    "description": "The rate steps the speed control cycles through: normal, slow, fast."
+    "default": "[1, 0.85, 1.15, 1.5]",
+    "description": "The playback multipliers the speed control cycles through."
   },
   {
     "kind": "function",
@@ -3616,14 +3674,14 @@
       "text": "'ore-speech-player'"
     },
     "default": "'ore-speech-player'",
-    "description": "A text-to-speech player control: reads its `text` aloud through the Web Speech API.\n\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\nnormal/slow/fast. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it."
+    "description": "A text-to-speech player control: reads its `text` aloud through the Web Speech API.\n\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\n1×/0.85×/1.15×/1.5×. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it."
   },
   {
     "kind": "class",
     "name": "OreSpeechPlayerElement",
     "tagName": "ore-speech-player",
     "customElement": true,
-    "description": "A text-to-speech player control: reads its `text` aloud through the Web Speech API.\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\nnormal/slow/fast. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it.",
+    "description": "A text-to-speech player control: reads its `text` aloud through the Web Speech API.\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\n1×/0.85×/1.15×/1.5×. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it.",
     "summary": "",
     "attributes": [
       {
@@ -3652,7 +3710,7 @@
         "type": {
           "text": "number"
         },
-        "description": "Playback rate; the speed control cycles 1 → 0.85 → 1.15"
+        "description": "Playback rate; the speed control cycles 1 → 0.85 → 1.15 → 1.5"
       },
       {
         "name": "resume-at",
@@ -3753,70 +3811,231 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "readingWords",
+    "return": {
+      "type": {
+        "text": "ReadingWord[]"
+      }
+    },
+    "parameters": [
+      {
+        "name": "text",
+        "type": {
+          "text": "string"
+        }
+      },
+      {
+        "name": "locale",
+        "type": {
+          "text": "string"
+        }
+      }
+    ]
+  },
   {
     "kind": "variable",
-    "name": "STATS_TAG",
+    "name": "SPEED_READING_TAG",
     "type": {
-      "text": "'ore-stats'"
+      "text": "'ore-speed-reading'"
     },
-    "default": "'ore-stats'",
-    "description": "A focused metric card for a label, primary value, supporting context, trend, icon, and optional visual."
+    "default": "'ore-speed-reading'",
+    "description": "Optional, user-paced RSVP reading with a fixed focal letter and full-text alternative.\nNo autoplay, network access, persistence, or speech synchronization."
   },
   {
     "kind": "class",
-    "name": "OreStatsElement",
-    "tagName": "ore-stats",
+    "name": "OreSpeedReadingElement",
+    "tagName": "ore-speed-reading",
     "customElement": true,
-    "description": "A focused metric card for a label, primary value, supporting context, trend, icon, and optional visual.",
+    "description": "Optional, user-paced RSVP reading with a fixed focal letter and full-text alternative.\nNo autoplay, network access, persistence, or speech synchronization.",
     "summary": "",
     "attributes": [
       {
-        "name": "label",
+        "name": "text",
         "type": {
           "text": "string"
         },
-        "description": "Metric label"
+        "description": "Plain text to read"
       },
       {
-        "name": "value",
+        "name": "wpm",
         "type": {
-          "text": "string"
+          "text": "number"
         },
-        "description": "Primary metric value"
+        "description": "Base words per minute, 100–600 (default 250)"
       },
       {
-        "name": "description",
+        "name": "word-index",
         "type": {
-          "text": "string"
+          "text": "number"
         },
-        "description": "Supporting context"
+        "description": "Zero-based word position (default 0)"
       },
       {
-        "name": "trend",
+        "name": "state",
         "type": {
           "text": "string"
         },
-        "description": "Trend text"
-      },
+        "description": "Read-only playback state: idle | playing | paused | ended"
+      }
+    ],
+    "events": [
       {
-        "name": "trend-direction",
+        "name": "play",
+        "description": "Playback started",
         "type": {
-          "text": "'up' | 'down' | 'neutral'"
-        },
-        "description": "Trend direction: 'up' | 'down' | 'neutral'"
+          "text": "CustomEvent"
+        }
       },
       {
-        "name": "variant",
+        "name": "pause",
+        "description": "Playback paused",
         "type": {
-          "text": "'outlined' | 'plain' | 'solid'"
-        },
-        "description": "Visual variant: 'outlined' | 'plain' | 'solid'"
+          "text": "CustomEvent"
+        }
       },
       {
-        "name": "color",
+        "name": "end",
+        "description": "Reading finished after the final dwell or explicit overflow completion",
         "type": {
-          "text": "string"
-        },
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "progress",
+        "description": "Displayed token changed; detail: { index, total, start, end }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "wpm-change",
+        "description": "User changed speed; detail: { wpm }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "viewport",
+        "description": "Focusable reader viewport"
+      },
+      {
+        "name": "word",
+        "description": "Visual word, hidden from assistive technology"
+      },
+      {
+        "name": "focal",
+        "description": "Stationary focal grapheme"
+      },
+      {
+        "name": "controls",
+        "description": "Playback controls"
+      },
+      {
+        "name": "status",
+        "description": "Visible playback status and position"
+      },
+      {
+        "name": "full-text",
+        "description": "Ordinary selectable text"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--speed-reading-font-size",
+        "description": "Display type size (default var(--text-2xl))"
+      },
+      {
+        "name": "--speed-reading-min-font-size",
+        "description": "Minimum passage-fitted type size (default var(--text-base))"
+      },
+      {
+        "name": "--speed-reading-height",
+        "description": "Minimum display height (default var(--size-32))"
+      },
+      {
+        "name": "--speed-reading-gap",
+        "description": "Space between reader sections (default var(--size-4))"
+      },
+      {
+        "name": "--speed-reading-focal-color",
+        "description": "Focal letter color (default var(--color-primary))"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-speed-reading lang=\"en\" text=\"Read at your own pace. Pause for context.\"></ore-speed-reading>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "STATS_TAG",
+    "type": {
+      "text": "'ore-stats'"
+    },
+    "default": "'ore-stats'",
+    "description": "A focused metric card for a label, primary value, supporting context, trend, icon, and optional visual."
+  },
+  {
+    "kind": "class",
+    "name": "OreStatsElement",
+    "tagName": "ore-stats",
+    "customElement": true,
+    "description": "A focused metric card for a label, primary value, supporting context, trend, icon, and optional visual.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Metric label"
+      },
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Primary metric value"
+      },
+      {
+        "name": "description",
+        "type": {
+          "text": "string"
+        },
+        "description": "Supporting context"
+      },
+      {
+        "name": "trend",
+        "type": {
+          "text": "string"
+        },
+        "description": "Trend text"
+      },
+      {
+        "name": "trend-direction",
+        "type": {
+          "text": "'up' | 'down' | 'neutral'"
+        },
+        "description": "Trend direction: 'up' | 'down' | 'neutral'"
+      },
+      {
+        "name": "variant",
+        "type": {
+          "text": "'outlined' | 'plain' | 'solid'"
+        },
+        "description": "Visual variant: 'outlined' | 'plain' | 'solid'"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "string"
+        },
         "description": "Semantic theme color"
       },
       {
@@ -4749,6 +4968,138 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "TAB_ITEM_TAG",
+    "type": {
+      "text": "'ore-tab-item'"
+    },
+    "default": "'ore-tab-item'",
+    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`."
+  },
+  {
+    "kind": "class",
+    "name": "OreTabItemElement",
+    "tagName": "ore-tab-item",
+    "customElement": true,
+    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Unique identifier, matches the corresponding ore-tab-panel value"
+      },
+      {
+        "name": "active",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Set by the parent ore-tabs when this tab is selected"
+      },
+      {
+        "name": "disabled",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Prevents selection"
+      },
+      {
+        "name": "density",
+        "type": {
+          "text": "'default' | 'compact'"
+        },
+        "description": "Inherited spatial density: 'default' | 'compact'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'sm' | 'md' | 'lg'"
+        },
+        "description": "'sm' | 'md' | 'lg'"
+      },
+      {
+        "name": "variant",
+        "type": {
+          "text": "'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
+        },
+        "description": "Inherited from ore-tabs: 'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Inherited from ore-tabs: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      }
+    ],
+    "slots": [
+      {
+        "name": "prefix",
+        "description": "Icon or content before the label"
+      },
+      {
+        "name": "",
+        "description": "Tab label"
+      },
+      {
+        "name": "suffix",
+        "description": "Badge or count after the label"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "tab",
+        "description": "Tab trigger element."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--tab-item-radius",
+        "description": "Button border radius"
+      },
+      {
+        "name": "--tab-item-transition",
+        "description": "Transition duration/easing"
+      },
+      {
+        "name": "--tab-item-padding",
+        "description": "Button padding"
+      },
+      {
+        "name": "--tab-item-font-size",
+        "description": "Button font size"
+      },
+      {
+        "name": "--tab-item-color",
+        "description": "Default text color"
+      },
+      {
+        "name": "--tab-item-hover-bg",
+        "description": "Background on hover"
+      },
+      {
+        "name": "--tab-item-active-bg",
+        "description": "Background when active/selected"
+      },
+      {
+        "name": "--tab-item-active-color",
+        "description": "Text color when active/selected"
+      },
+      {
+        "name": "--tab-item-active-shadow",
+        "description": "Box shadow when active/selected"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-tab-item slot=\"tabs\" value=\"overview\">Overview</ore-tab-item>\n<ore-tab-item slot=\"tabs\" value=\"settings\" disabled>Settings</ore-tab-item>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "ACCORDION_ITEM_TAG",
@@ -4936,138 +5287,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "TAB_ITEM_TAG",
-    "type": {
-      "text": "'ore-tab-item'"
-    },
-    "default": "'ore-tab-item'",
-    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`."
-  },
-  {
-    "kind": "class",
-    "name": "OreTabItemElement",
-    "tagName": "ore-tab-item",
-    "customElement": true,
-    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "value",
-        "type": {
-          "text": "string"
-        },
-        "description": "Unique identifier, matches the corresponding ore-tab-panel value"
-      },
-      {
-        "name": "active",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Set by the parent ore-tabs when this tab is selected"
-      },
-      {
-        "name": "disabled",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Prevents selection"
-      },
-      {
-        "name": "density",
-        "type": {
-          "text": "'default' | 'compact'"
-        },
-        "description": "Inherited spatial density: 'default' | 'compact'"
-      },
-      {
-        "name": "size",
-        "type": {
-          "text": "'sm' | 'md' | 'lg'"
-        },
-        "description": "'sm' | 'md' | 'lg'"
-      },
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
-        },
-        "description": "Inherited from ore-tabs: 'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Inherited from ore-tabs: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      }
-    ],
-    "slots": [
-      {
-        "name": "prefix",
-        "description": "Icon or content before the label"
-      },
-      {
-        "name": "",
-        "description": "Tab label"
-      },
-      {
-        "name": "suffix",
-        "description": "Badge or count after the label"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "tab",
-        "description": "Tab trigger element."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--tab-item-radius",
-        "description": "Button border radius"
-      },
-      {
-        "name": "--tab-item-transition",
-        "description": "Transition duration/easing"
-      },
-      {
-        "name": "--tab-item-padding",
-        "description": "Button padding"
-      },
-      {
-        "name": "--tab-item-font-size",
-        "description": "Button font size"
-      },
-      {
-        "name": "--tab-item-color",
-        "description": "Default text color"
-      },
-      {
-        "name": "--tab-item-hover-bg",
-        "description": "Background on hover"
-      },
-      {
-        "name": "--tab-item-active-bg",
-        "description": "Background when active/selected"
-      },
-      {
-        "name": "--tab-item-active-color",
-        "description": "Text color when active/selected"
-      },
-      {
-        "name": "--tab-item-active-shadow",
-        "description": "Box shadow when active/selected"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-tab-item slot=\"tabs\" value=\"overview\">Overview</ore-tab-item>\n<ore-tab-item slot=\"tabs\" value=\"settings\" disabled>Settings</ore-tab-item>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "TAB_PANEL_TAG",