@cordwainer/cw-elements 1.5.0-alpha.2 → 1.5.0-alpha.4

package/dist/custom-elements.json

@@ -4,118 +4,178 @@
   "modules": [
     {
       "kind": "javascript-module",
-      "path": "components/alert/alert.js",
+      "path": "components/accordion/accordion.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CwAlert",
+          "name": "CwAccordion",
           "cssParts": [
             {
               "description": "The component's base wrapper.",
               "name": "base"
-            },
-            {
-              "description": "The container that wraps the optional icon.",
-              "name": "icon"
-            },
-            {
-              "description": "The container that wraps the alert's main content.",
-              "name": "message"
-            },
-            {
-              "description": "The close button, an `<cw-icon-button>`.",
-              "name": "close-button"
-            },
-            {
-              "description": "The close button's exported `base` part.",
-              "name": "close-button__base"
             }
           ],
           "slots": [
             {
-              "description": "The alert's main content.",
+              "description": "One or more `<cw-accordion-item>` elements to display.",
               "name": ""
-            },
-            {
-              "description": "An icon to show in the alert. Works best with `<cw-icon>`.",
-              "name": "icon"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "defaultSlot",
               "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ 'cw-icon-button': CwIconButton }"
+                "text": "HTMLSlotElement"
+              }
             },
             {
               "kind": "field",
-              "name": "autoHideTimeout",
+              "name": "multiple",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "default": "false",
+              "description": "When set, more than one accordion item can be open at the same time. By default, opening one closes the rest.",
+              "attribute": "multiple",
+              "reflects": true
             },
             {
-              "kind": "field",
-              "name": "remainingTimeInterval",
-              "type": {
-                "text": "number"
-              },
-              "privacy": "private"
+              "kind": "method",
+              "name": "getItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CwAccordionItem[]"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "countdownAnimation",
+              "kind": "method",
+              "name": "handleItemShow",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CwShowEvent"
+                  }
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "multiple",
               "type": {
-                "text": "Animation | undefined"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "default": "false",
+              "description": "When set, more than one accordion item can be open at the same time. By default, opening one closes the rest.",
+              "fieldName": "multiple"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Accordions group multiple [accordion items](/components/accordion-item), optionally keeping only one\nexpanded at a time.",
+          "tagNameWithoutPrefix": "accordion",
+          "tagName": "cw-accordion",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Accordions group multiple [accordion items](/components/accordion-item), optionally keeping only one\n *  expanded at a time.\n * @documentation https://cordwainer.dev/components/accordion\n * @status experimental\n * @since 1.5\n *\n * @slot - One or more `<cw-accordion-item>` elements to display.\n *\n * @csspart base - The component's base wrapper.\n */",
+          "documentation": "https://cordwainer.dev/components/accordion",
+          "status": "experimental",
+          "since": "1.5"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwAccordion",
+            "module": "components/accordion/accordion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/accordion-item/accordion-item.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwAccordionItem",
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
             },
             {
-              "kind": "field",
-              "name": "hasSlotController",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new HasSlotController(this, 'icon', 'suffix')"
+              "description": "The header that wraps both the summary and the expand/collapse icon.",
+              "name": "header"
             },
             {
-              "kind": "field",
-              "name": "localize",
-              "privacy": "private",
-              "readonly": true,
-              "default": "new LocalizeController(this)"
+              "description": "The container that wraps the summary.",
+              "name": "summary"
+            },
+            {
+              "description": "The container that wraps the expand/collapse icons.",
+              "name": "summary-icon"
+            },
+            {
+              "description": "The accordion item's content.",
+              "name": "content"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The accordion item's main content.",
+              "name": ""
             },
+            {
+              "description": "The accordion item's summary. Alternatively, you can use the `summary` attribute.",
+              "name": "summary"
+            },
+            {
+              "description": "Optional expand icon to use instead of the default. Works best with `<cw-icon>`.",
+              "name": "expand-icon"
+            },
+            {
+              "description": "Optional collapse icon to use instead of the default. Works best with `<cw-icon>`.",
+              "name": "collapse-icon"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "currentToastStack",
+              "name": "dependencies",
               "type": {
-                "text": "HTMLDivElement"
+                "text": "object"
               },
-              "privacy": "private",
-              "static": true
+              "static": true,
+              "default": "{ 'cw-icon': CwIcon }"
             },
             {
               "kind": "field",
-              "name": "toastStack",
+              "name": "localize",
               "privacy": "private",
-              "static": true,
-              "readonly": true
+              "readonly": true,
+              "default": "new LocalizeController(this)"
             },
             {
               "kind": "field",
-              "name": "base",
+              "name": "header",
               "type": {
                 "text": "HTMLElement"
               }
             },
             {
               "kind": "field",
-              "name": "countdownElement",
+              "name": "body",
               "type": {
                 "text": "HTMLElement"
               }
@@ -127,124 +187,84 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+              "description": "Indicates whether or not the accordion item is open. You can toggle this attribute to show and hide the item, or\nyou can use the `show()` and `hide()` methods and this attribute will reflect the item's open state.",
               "attribute": "open",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "closable",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Enables a close button that allows the user to dismiss the alert.",
-              "attribute": "closable",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "variant",
+              "name": "summary",
               "type": {
-                "text": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'"
+                "text": "string"
               },
-              "default": "'primary'",
-              "description": "The alert's theme variant.",
-              "attribute": "variant",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "duration",
-              "default": "Infinity",
-              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
-              "attribute": "duration"
+              "description": "The summary to show in the header. If you need to display HTML, use the `summary` slot instead.",
+              "attribute": "summary"
             },
             {
               "kind": "field",
-              "name": "countdown",
+              "name": "disabled",
               "type": {
-                "text": "'rtl' | 'ltr' | undefined"
+                "text": "boolean"
               },
-              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-              "attribute": "countdown",
+              "default": "false",
+              "description": "Disables the accordion item so it can't be toggled.",
+              "attribute": "disabled",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "remainingTime",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "restartAutoHide",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "pauseAutoHide",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "resumeAutoHide",
-              "privacy": "private"
-            },
             {
               "kind": "method",
-              "name": "handleCountdownChange",
+              "name": "handleHeaderClick",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleCloseClick",
-              "privacy": "private"
+              "name": "handleHeaderKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
               "name": "handleOpenChange"
             },
-            {
-              "kind": "method",
-              "name": "handleDurationChange"
-            },
             {
               "kind": "method",
               "name": "show",
-              "description": "Shows the alert."
+              "description": "Shows the accordion item."
             },
             {
               "kind": "method",
               "name": "hide",
-              "description": "Hides the alert"
-            },
-            {
-              "kind": "method",
-              "name": "toast",
-              "description": "Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden."
+              "description": "Hides the accordion item."
             }
           ],
           "events": [
             {
-              "description": "Emitted when the alert opens.",
+              "description": "Emitted when the accordion item opens.",
               "name": "cw-show",
               "reactName": "onCwShow",
               "eventName": "CwShowEvent"
             },
             {
-              "description": "Emitted after the alert opens and all animations are complete.",
+              "description": "Emitted after the accordion item opens and all animations are complete.",
               "name": "cw-after-show",
               "reactName": "onCwAfterShow",
               "eventName": "CwAfterShowEvent"
             },
             {
-              "description": "Emitted when the alert closes.",
+              "description": "Emitted when the accordion item closes.",
               "name": "cw-hide",
               "reactName": "onCwHide",
               "eventName": "CwHideEvent"
             },
             {
-              "description": "Emitted after the alert closes and all animations are complete.",
+              "description": "Emitted after the accordion item closes and all animations are complete.",
               "name": "cw-after-hide",
               "reactName": "onCwAfterHide",
               "eventName": "CwAfterHideEvent"
@@ -257,65 +277,50 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+              "description": "Indicates whether or not the accordion item is open. You can toggle this attribute to show and hide the item, or\nyou can use the `show()` and `hide()` methods and this attribute will reflect the item's open state.",
               "fieldName": "open"
             },
             {
-              "name": "closable",
+              "name": "summary",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Enables a close button that allows the user to dismiss the alert.",
-              "fieldName": "closable"
+              "description": "The summary to show in the header. If you need to display HTML, use the `summary` slot instead.",
+              "fieldName": "summary"
             },
             {
-              "name": "variant",
+              "name": "disabled",
               "type": {
-                "text": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'"
-              },
-              "default": "'primary'",
-              "description": "The alert's theme variant.",
-              "fieldName": "variant"
-            },
-            {
-              "name": "duration",
-              "default": "Infinity",
-              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
-              "fieldName": "duration"
-            },
-            {
-              "name": "countdown",
-              "type": {
-                "text": "'rtl' | 'ltr' | undefined"
+                "text": "boolean"
               },
-              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-              "fieldName": "countdown"
+              "default": "false",
+              "description": "Disables the accordion item so it can't be toggled.",
+              "fieldName": "disabled"
             }
           ],
           "superclass": {
             "name": "CwElement",
             "module": "/src/internal/cw-element.js"
           },
-          "summary": "Alerts are used to display important messages inline or as toast notifications.",
-          "tagNameWithoutPrefix": "alert",
-          "tagName": "cw-alert",
+          "summary": "Accordion items are collapsible panels used inside an [accordion](/components/accordion) — each shows a\nbrief summary and expands to show additional content.",
+          "tagNameWithoutPrefix": "accordion-item",
+          "tagName": "cw-accordion-item",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Alerts are used to display important messages inline or as toast notifications.\n * @documentation https://cordwainer.dev/components/alert\n * @status stable\n * @since 1.0\n *\n * @dependency cw-icon-button\n *\n * @slot - The alert's main content.\n * @slot icon - An icon to show in the alert. Works best with `<cw-icon>`.\n *\n * @event cw-show - Emitted when the alert opens.\n * @event cw-after-show - Emitted after the alert opens and all animations are complete.\n * @event cw-hide - Emitted when the alert closes.\n * @event cw-after-hide - Emitted after the alert closes and all animations are complete.\n *\n * @csspart base - The component's base wrapper.\n * @csspart icon - The container that wraps the optional icon.\n * @csspart message - The container that wraps the alert's main content.\n * @csspart close-button - The close button, an `<cw-icon-button>`.\n * @csspart close-button__base - The close button's exported `base` part.\n *\n * @animation alert.show - The animation to use when showing the alert.\n * @animation alert.hide - The animation to use when hiding the alert.\n */",
-          "documentation": "https://cordwainer.dev/components/alert",
-          "status": "stable",
-          "since": "1.0",
+          "jsDoc": "/**\n * @summary Accordion items are collapsible panels used inside an [accordion](/components/accordion) — each shows a\n *  brief summary and expands to show additional content.\n * @documentation https://cordwainer.dev/components/accordion-item\n * @status experimental\n * @since 1.5\n *\n * @dependency cw-icon\n *\n * @slot - The accordion item's main content.\n * @slot summary - The accordion item's summary. Alternatively, you can use the `summary` attribute.\n * @slot expand-icon - Optional expand icon to use instead of the default. Works best with `<cw-icon>`.\n * @slot collapse-icon - Optional collapse icon to use instead of the default. Works best with `<cw-icon>`.\n *\n * @event cw-show - Emitted when the accordion item opens.\n * @event cw-after-show - Emitted after the accordion item opens and all animations are complete.\n * @event cw-hide - Emitted when the accordion item closes.\n * @event cw-after-hide - Emitted after the accordion item closes and all animations are complete.\n *\n * @csspart base - The component's base wrapper.\n * @csspart header - The header that wraps both the summary and the expand/collapse icon.\n * @csspart summary - The container that wraps the summary.\n * @csspart summary-icon - The container that wraps the expand/collapse icons.\n * @csspart content - The accordion item's content.\n *\n * @animation accordion-item.show - The animation to use when showing the accordion item.\n * @animation accordion-item.hide - The animation to use when hiding the accordion item.\n */",
+          "documentation": "https://cordwainer.dev/components/accordion-item",
+          "status": "experimental",
+          "since": "1.5",
           "dependencies": [
-            "cw-icon-button"
+            "cw-icon"
           ],
           "animations": [
             {
-              "name": "alert.show",
-              "description": "The animation to use when showing the alert."
+              "name": "accordion-item.show",
+              "description": "The animation to use when showing the accordion item."
             },
             {
-              "name": "alert.hide",
-              "description": "The animation to use when hiding the alert."
+              "name": "accordion-item.hide",
+              "description": "The animation to use when hiding the accordion item."
             }
           ]
         }
@@ -325,44 +330,50 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CwAlert",
-            "module": "components/alert/alert.js"
+            "name": "CwAccordionItem",
+            "module": "components/accordion-item/accordion-item.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/animated-image/animated-image.js",
+      "path": "components/alert/alert.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CwAnimatedImage",
-          "cssProperties": [
+          "name": "CwAlert",
+          "cssParts": [
             {
-              "description": "The size of the icon box.",
-              "name": "--control-box-size"
+              "description": "The component's base wrapper.",
+              "name": "base"
             },
             {
-              "description": "The size of the play/pause icons.",
-              "name": "--icon-size"
-            }
-          ],
-          "cssParts": [
+              "description": "The container that wraps the optional icon.",
+              "name": "icon"
+            },
             {
-              "description": "The container that surrounds the pause/play icons and provides their background.",
-              "name": "control-box"
+              "description": "The container that wraps the alert's main content.",
+              "name": "message"
+            },
+            {
+              "description": "The close button, an `<cw-icon-button>`.",
+              "name": "close-button"
+            },
+            {
+              "description": "The close button's exported `base` part.",
+              "name": "close-button__base"
             }
           ],
           "slots": [
             {
-              "description": "Optional play icon to use instead of the default. Works best with `<cw-icon>`.",
-              "name": "play-icon"
+              "description": "The alert's main content.",
+              "name": ""
             },
             {
-              "description": "Optional pause icon to use instead of the default. Works best with `<cw-icon>`.",
-              "name": "pause-icon"
+              "description": "An icon to show in the alert. Works best with `<cw-icon>`.",
+              "name": "icon"
             }
           ],
           "members": [
@@ -373,105 +384,428 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'cw-icon': CwIcon }"
+              "default": "{ 'cw-icon-button': CwIconButton }"
             },
             {
               "kind": "field",
-              "name": "animatedImage",
+              "name": "autoHideTimeout",
               "type": {
-                "text": "HTMLImageElement"
+                "text": "number"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "remainingTimeInterval",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "countdownAnimation",
+              "type": {
+                "text": "Animation | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "hasSlotController",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new HasSlotController(this, 'icon', 'suffix')"
+            },
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "currentToastStack",
+              "type": {
+                "text": "HTMLDivElement"
+              },
+              "privacy": "private",
+              "static": true
+            },
+            {
+              "kind": "field",
+              "name": "toastStack",
+              "privacy": "private",
+              "static": true,
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "base",
+              "type": {
+                "text": "HTMLElement"
               }
             },
             {
               "kind": "field",
-              "name": "frozenFrame",
+              "name": "countdownElement",
               "type": {
-                "text": "string"
+                "text": "HTMLElement"
               }
             },
             {
               "kind": "field",
-              "name": "isLoaded",
+              "name": "open",
               "type": {
                 "text": "boolean"
               },
-              "default": "false"
+              "default": "false",
+              "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+              "attribute": "open",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "src",
+              "name": "closable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "The path to the image to load.",
-              "attribute": "src"
+              "default": "false",
+              "description": "Enables a close button that allows the user to dismiss the alert.",
+              "attribute": "closable",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "alt",
+              "name": "variant",
               "type": {
-                "text": "string"
+                "text": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'"
               },
-              "description": "A description of the image used by assistive devices.",
-              "attribute": "alt"
+              "default": "'primary'",
+              "description": "The alert's theme variant.",
+              "attribute": "variant",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "play",
+              "name": "duration",
+              "default": "Infinity",
+              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
+              "attribute": "duration"
+            },
+            {
+              "kind": "field",
+              "name": "countdown",
               "type": {
-                "text": "boolean"
+                "text": "'rtl' | 'ltr' | undefined"
               },
-              "description": "Plays the animation. When this attribute is remove, the animation will pause.",
-              "attribute": "play",
+              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+              "attribute": "countdown",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "remainingTime",
+              "privacy": "private"
+            },
             {
               "kind": "method",
-              "name": "handleClick",
+              "name": "restartAutoHide",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleLoad",
+              "name": "pauseAutoHide",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleError",
+              "name": "resumeAutoHide",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handlePlayChange"
+              "name": "handleCountdownChange",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleSrcChange"
+              "name": "handleCloseClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleOpenChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleDurationChange"
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "description": "Shows the alert."
+            },
+            {
+              "kind": "method",
+              "name": "hide",
+              "description": "Hides the alert"
+            },
+            {
+              "kind": "method",
+              "name": "toast",
+              "description": "Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden."
             }
           ],
           "events": [
             {
-              "description": "Emitted when the image loads successfully.",
-              "name": "cw-load",
-              "reactName": "onCwLoad",
-              "eventName": "CwLoadEvent"
+              "description": "Emitted when the alert opens.",
+              "name": "cw-show",
+              "reactName": "onCwShow",
+              "eventName": "CwShowEvent"
             },
             {
-              "description": "Emitted when the image fails to load.",
-              "name": "cw-error",
-              "reactName": "onCwError",
-              "eventName": "CwErrorEvent"
+              "description": "Emitted after the alert opens and all animations are complete.",
+              "name": "cw-after-show",
+              "reactName": "onCwAfterShow",
+              "eventName": "CwAfterShowEvent"
+            },
+            {
+              "description": "Emitted when the alert closes.",
+              "name": "cw-hide",
+              "reactName": "onCwHide",
+              "eventName": "CwHideEvent"
+            },
+            {
+              "description": "Emitted after the alert closes and all animations are complete.",
+              "name": "cw-after-hide",
+              "reactName": "onCwAfterHide",
+              "eventName": "CwAfterHideEvent"
             }
           ],
           "attributes": [
             {
-              "name": "src",
+              "name": "open",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "The path to the image to load.",
-              "fieldName": "src"
-            },
+              "default": "false",
+              "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+              "fieldName": "open"
+            },
+            {
+              "name": "closable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables a close button that allows the user to dismiss the alert.",
+              "fieldName": "closable"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'"
+              },
+              "default": "'primary'",
+              "description": "The alert's theme variant.",
+              "fieldName": "variant"
+            },
+            {
+              "name": "duration",
+              "default": "Infinity",
+              "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
+              "fieldName": "duration"
+            },
+            {
+              "name": "countdown",
+              "type": {
+                "text": "'rtl' | 'ltr' | undefined"
+              },
+              "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+              "fieldName": "countdown"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Alerts are used to display important messages inline or as toast notifications.",
+          "tagNameWithoutPrefix": "alert",
+          "tagName": "cw-alert",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Alerts are used to display important messages inline or as toast notifications.\n * @documentation https://cordwainer.dev/components/alert\n * @status stable\n * @since 1.0\n *\n * @dependency cw-icon-button\n *\n * @slot - The alert's main content.\n * @slot icon - An icon to show in the alert. Works best with `<cw-icon>`.\n *\n * @event cw-show - Emitted when the alert opens.\n * @event cw-after-show - Emitted after the alert opens and all animations are complete.\n * @event cw-hide - Emitted when the alert closes.\n * @event cw-after-hide - Emitted after the alert closes and all animations are complete.\n *\n * @csspart base - The component's base wrapper.\n * @csspart icon - The container that wraps the optional icon.\n * @csspart message - The container that wraps the alert's main content.\n * @csspart close-button - The close button, an `<cw-icon-button>`.\n * @csspart close-button__base - The close button's exported `base` part.\n *\n * @animation alert.show - The animation to use when showing the alert.\n * @animation alert.hide - The animation to use when hiding the alert.\n */",
+          "documentation": "https://cordwainer.dev/components/alert",
+          "status": "stable",
+          "since": "1.0",
+          "dependencies": [
+            "cw-icon-button"
+          ],
+          "animations": [
+            {
+              "name": "alert.show",
+              "description": "The animation to use when showing the alert."
+            },
+            {
+              "name": "alert.hide",
+              "description": "The animation to use when hiding the alert."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwAlert",
+            "module": "components/alert/alert.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/animated-image/animated-image.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwAnimatedImage",
+          "cssProperties": [
+            {
+              "description": "The size of the icon box.",
+              "name": "--control-box-size"
+            },
+            {
+              "description": "The size of the play/pause icons.",
+              "name": "--icon-size"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The container that surrounds the pause/play icons and provides their background.",
+              "name": "control-box"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Optional play icon to use instead of the default. Works best with `<cw-icon>`.",
+              "name": "play-icon"
+            },
+            {
+              "description": "Optional pause icon to use instead of the default. Works best with `<cw-icon>`.",
+              "name": "pause-icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'cw-icon': CwIcon }"
+            },
+            {
+              "kind": "field",
+              "name": "animatedImage",
+              "type": {
+                "text": "HTMLImageElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "frozenFrame",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "isLoaded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "src",
+              "type": {
+                "text": "string"
+              },
+              "description": "The path to the image to load.",
+              "attribute": "src"
+            },
+            {
+              "kind": "field",
+              "name": "alt",
+              "type": {
+                "text": "string"
+              },
+              "description": "A description of the image used by assistive devices.",
+              "attribute": "alt"
+            },
+            {
+              "kind": "field",
+              "name": "play",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Plays the animation. When this attribute is remove, the animation will pause.",
+              "attribute": "play",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "handleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleLoad",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleError",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handlePlayChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleSrcChange"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the image loads successfully.",
+              "name": "cw-load",
+              "reactName": "onCwLoad",
+              "eventName": "CwLoadEvent"
+            },
+            {
+              "description": "Emitted when the image fails to load.",
+              "name": "cw-error",
+              "reactName": "onCwError",
+              "eventName": "CwErrorEvent"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "src",
+              "type": {
+                "text": "string"
+              },
+              "description": "The path to the image to load.",
+              "fieldName": "src"
+            },
             {
               "name": "alt",
               "type": {
@@ -19664,57 +19998,557 @@
               "default": "0"
             },
             {
-              "kind": "field",
-              "name": "resizeObserver",
-              "type": {
-                "text": "ResizeObserver"
-              },
-              "privacy": "private"
+              "kind": "field",
+              "name": "resizeObserver",
+              "type": {
+                "text": "ResizeObserver"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "divider",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "number"
+              },
+              "default": "50",
+              "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
+              "attribute": "position",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "positionInPixels",
+              "type": {
+                "text": "number"
+              },
+              "description": "The current position of the divider from the primary panel's edge in pixels.",
+              "attribute": "position-in-pixels"
+            },
+            {
+              "kind": "field",
+              "name": "vertical",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
+              "attribute": "vertical",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "primary",
+              "type": {
+                "text": "'start' | 'end' | undefined"
+              },
+              "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
+              "attribute": "primary"
+            },
+            {
+              "kind": "field",
+              "name": "snapValue",
+              "type": {
+                "text": "string | SnapFunction"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "snapFunction",
+              "type": {
+                "text": "SnapFunction"
+              },
+              "privacy": "private",
+              "default": "SNAP_NONE"
+            },
+            {
+              "kind": "method",
+              "name": "toSnapFunction",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "snap",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "The snap string."
+                }
+              ],
+              "description": "Converts a string containing either a series of fixed/repeated snap points (e.g. \"repeat(20%)\", \"100px 200px 800px\", or \"10% 50% repeat(10px)\") into a SnapFunction. `SnapFunction`s take in a `SnapFunctionOpts` and return the position that the split panel should snap to."
+            },
+            {
+              "kind": "field",
+              "name": "snap",
+              "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
+              "type": {
+                "text": "string | SnapFunction"
+              },
+              "attribute": "snap",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "snapThreshold",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "How close the divider must be to a snap point until snapping occurs.",
+              "attribute": "snap-threshold"
+            },
+            {
+              "kind": "method",
+              "name": "detectSize",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "percentageToPixels",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "pixelsToPercentage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleDrag",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "PointerEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleResize",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "entries",
+                  "type": {
+                    "text": "ResizeObserverEntry[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handlePositionChange"
+            },
+            {
+              "kind": "method",
+              "name": "handlePositionInPixelsChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleVerticalChange"
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the divider's position changes.",
+              "name": "cw-reposition",
+              "reactName": "onCwReposition",
+              "eventName": "CwRepositionEvent"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "position",
+              "type": {
+                "text": "number"
+              },
+              "default": "50",
+              "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
+              "fieldName": "position"
+            },
+            {
+              "name": "position-in-pixels",
+              "type": {
+                "text": "number"
+              },
+              "description": "The current position of the divider from the primary panel's edge in pixels.",
+              "fieldName": "positionInPixels"
+            },
+            {
+              "name": "vertical",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
+              "fieldName": "vertical"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "primary",
+              "type": {
+                "text": "'start' | 'end' | undefined"
+              },
+              "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
+              "fieldName": "primary"
+            },
+            {
+              "name": "snap",
+              "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
+              "type": {
+                "text": "string | SnapFunction"
+              },
+              "fieldName": "snap"
+            },
+            {
+              "name": "snap-threshold",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "How close the divider must be to a snap point until snapping occurs.",
+              "fieldName": "snapThreshold"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Split panels display two adjacent panels, allowing the user to reposition them.",
+          "tagNameWithoutPrefix": "split-panel",
+          "tagName": "cw-split-panel",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Split panels display two adjacent panels, allowing the user to reposition them.\n * @documentation https://cordwainer.dev/components/split-panel\n * @status stable\n * @since 1.0\n *\n * @event cw-reposition - Emitted when the divider's position changes.\n *\n * @slot start - Content to place in the start panel.\n * @slot end - Content to place in the end panel.\n * @slot divider - The divider. Useful for slotting in a custom icon that renders as a handle.\n *\n * @csspart start - The start panel.\n * @csspart end - The end panel.\n * @csspart panel - Targets both the start and end panels.\n * @csspart divider - The divider that separates the start and end panels.\n *\n * @cssproperty [--divider-width=4px] - The width of the visible divider.\n * @cssproperty [--divider-hit-area=12px] - The invisible region around the divider where dragging can occur. This is\n *  usually wider than the divider to facilitate easier dragging.\n * @cssproperty [--min=0] - The minimum allowed size of the primary panel.\n * @cssproperty [--max=100%] - The maximum allowed size of the primary panel.\n */",
+          "documentation": "https://cordwainer.dev/components/split-panel",
+          "status": "stable",
+          "since": "1.0"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SNAP_NONE",
+          "declaration": {
+            "name": "SNAP_NONE",
+            "module": "components/split-panel/split-panel.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwSplitPanel",
+            "module": "components/split-panel/split-panel.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/stepper/stepper.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwStepper",
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            }
+          ],
+          "slots": [
+            {
+              "description": "One or more `<cw-stepper-item>` elements to display.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "defaultSlot",
+              "type": {
+                "text": "HTMLSlotElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "default": "'horizontal'",
+              "description": "The orientation the steps are laid out in.",
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "linear",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "In linear mode, a step can only be activated if every step before it is completed (or it's the very next step\nafter the last completed one) — this prevents jumping ahead in a required sequence. Off by default, so any step\ncan be activated at any time.",
+              "attribute": "linear",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "getItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CwStepperItem[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "syncItems",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleOrientationChange"
+            },
+            {
+              "kind": "method",
+              "name": "canActivateInLinearMode",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "CwStepperItem"
+                  }
+                },
+                {
+                  "name": "items",
+                  "type": {
+                    "text": "CwStepperItem[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleItemShow",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "CwShowEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "handleKeyDown",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "orientation",
+              "type": {
+                "text": "'horizontal' | 'vertical'"
+              },
+              "default": "'horizontal'",
+              "description": "The orientation the steps are laid out in.",
+              "fieldName": "orientation"
+            },
+            {
+              "name": "linear",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "In linear mode, a step can only be activated if every step before it is completed (or it's the very next step\nafter the last completed one) — this prevents jumping ahead in a required sequence. Off by default, so any step\ncan be activated at any time.",
+              "fieldName": "linear"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Steppers show progress through a sequence of steps — a step indicator for multi-step forms, checkouts,\nand onboarding flows.",
+          "tagNameWithoutPrefix": "stepper",
+          "tagName": "cw-stepper",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Steppers show progress through a sequence of steps — a step indicator for multi-step forms, checkouts,\n *  and onboarding flows.\n * @documentation https://cordwainer.dev/components/stepper\n * @status experimental\n * @since 1.5\n *\n * @slot - One or more `<cw-stepper-item>` elements to display.\n *\n * @csspart base - The component's base wrapper.\n */",
+          "documentation": "https://cordwainer.dev/components/stepper",
+          "status": "experimental",
+          "since": "1.5"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwStepper",
+            "module": "components/stepper/stepper.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/stepper-item/stepper-item.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwStepperItem",
+          "cssParts": [
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The clickable header containing the indicator and label.",
+              "name": "header"
+            },
+            {
+              "description": "The circular indicator showing the step number, or a completed/error icon.",
+              "name": "indicator"
+            },
+            {
+              "description": "The container that wraps the step's label.",
+              "name": "label"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The step's label.",
+              "name": ""
+            },
+            {
+              "description": "Optional icon to use instead of the default checkmark when the step is completed.",
+              "name": "completed-icon"
             },
+            {
+              "description": "Optional icon to use instead of the default when the step has an error.",
+              "name": "error-icon"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "size",
+              "name": "dependencies",
               "type": {
-                "text": "number"
+                "text": "object"
               },
-              "privacy": "private"
+              "static": true,
+              "default": "{ 'cw-icon': CwIcon }"
             },
             {
               "kind": "field",
-              "name": "divider",
+              "name": "header",
               "type": {
                 "text": "HTMLElement"
               }
             },
             {
               "kind": "field",
-              "name": "position",
+              "name": "active",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "50",
-              "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
-              "attribute": "position",
+              "default": "false",
+              "description": "Indicates whether or not this is the current step. Only one step in a `<cw-stepper>` should be active at a time\n— the stepper manages this for you as steps are activated, but you can also set it directly.",
+              "attribute": "active",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "positionInPixels",
-              "type": {
-                "text": "number"
-              },
-              "description": "The current position of the divider from the primary panel's edge in pixels.",
-              "attribute": "position-in-pixels"
-            },
-            {
-              "kind": "field",
-              "name": "vertical",
+              "name": "completed",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
-              "attribute": "vertical",
+              "description": "Indicates that this step has been completed. Steppers in `linear` mode use this to gate which steps can be reached.",
+              "attribute": "completed",
               "reflects": true
             },
             {
@@ -19724,194 +20558,125 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+              "description": "Disables the step so it can't be activated.",
               "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "primary",
+              "name": "error",
               "type": {
-                "text": "'start' | 'end' | undefined"
+                "text": "boolean"
               },
-              "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
-              "attribute": "primary"
+              "default": "false",
+              "description": "Indicates that this step has an error, shown as a distinct visual state on the indicator.",
+              "attribute": "error",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "snapValue",
+              "name": "index",
               "type": {
-                "text": "string | SnapFunction"
+                "text": "number"
               },
-              "privacy": "private",
-              "default": "''"
+              "default": "1",
+              "description": "The step's position within its `<cw-stepper>`, 1-based. Set automatically by the parent stepper — you shouldn't\nneed to set this yourself.",
+              "attribute": "index"
             },
             {
               "kind": "field",
-              "name": "snapFunction",
+              "name": "orientation",
               "type": {
-                "text": "SnapFunction"
+                "text": "'horizontal' | 'vertical'"
               },
-              "privacy": "private",
-              "default": "SNAP_NONE"
+              "default": "'horizontal'",
+              "description": "The orientation of the stepper this item belongs to, used to draw the connecting line to the next step. Set\nautomatically by the parent stepper — you shouldn't need to set this yourself.",
+              "attribute": "orientation",
+              "reflects": true
             },
             {
               "kind": "method",
-              "name": "toSnapFunction",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": ""
-                }
-              },
+              "name": "focus",
               "parameters": [
                 {
-                  "name": "snap",
+                  "name": "options",
+                  "optional": true,
                   "type": {
-                    "text": "string"
-                  },
-                  "description": "The snap string."
+                    "text": "FocusOptions"
+                  }
                 }
               ],
-              "description": "Converts a string containing either a series of fixed/repeated snap points (e.g. \"repeat(20%)\", \"100px 200px 800px\", or \"10% 50% repeat(10px)\") into a SnapFunction. `SnapFunction`s take in a `SnapFunctionOpts` and return the position that the split panel should snap to."
-            },
-            {
-              "kind": "field",
-              "name": "snap",
-              "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
-              "type": {
-                "text": "string | SnapFunction"
-              },
-              "attribute": "snap",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "snapThreshold",
-              "type": {
-                "text": "number"
-              },
-              "default": "12",
-              "description": "How close the divider must be to a snap point until snapping occurs.",
-              "attribute": "snap-threshold"
+              "description": "Moves focus to the step's header."
             },
             {
               "kind": "method",
-              "name": "detectSize",
-              "privacy": "private"
+              "name": "blur",
+              "description": "Removes focus from the step's header."
             },
             {
               "kind": "method",
-              "name": "percentageToPixels",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
+              "name": "handleHeaderClick",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "pixelsToPercentage",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
+              "name": "handleActiveChange"
             },
             {
               "kind": "method",
-              "name": "handleDrag",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "PointerEvent"
-                  }
-                }
-              ]
+              "name": "show",
+              "description": "Activates the step, making it the current one."
             },
             {
               "kind": "method",
-              "name": "handleKeyDown",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ]
-            },
+              "name": "hide",
+              "description": "Deactivates the step. Only the parent `<cw-stepper>` normally needs to call this."
+            }
+          ],
+          "events": [
             {
-              "kind": "method",
-              "name": "handleResize",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "entries",
-                  "type": {
-                    "text": "ResizeObserverEntry[]"
-                  }
-                }
-              ]
+              "description": "Emitted when the step becomes active.",
+              "name": "cw-show",
+              "reactName": "onCwShow",
+              "eventName": "CwShowEvent"
             },
             {
-              "kind": "method",
-              "name": "handlePositionChange"
+              "description": "Emitted after the step becomes active.",
+              "name": "cw-after-show",
+              "reactName": "onCwAfterShow",
+              "eventName": "CwAfterShowEvent"
             },
             {
-              "kind": "method",
-              "name": "handlePositionInPixelsChange"
+              "description": "Emitted when the step is no longer active.",
+              "name": "cw-hide",
+              "reactName": "onCwHide",
+              "eventName": "CwHideEvent"
             },
             {
-              "kind": "method",
-              "name": "handleVerticalChange"
-            }
-          ],
-          "events": [
-            {
-              "description": "Emitted when the divider's position changes.",
-              "name": "cw-reposition",
-              "reactName": "onCwReposition",
-              "eventName": "CwRepositionEvent"
+              "description": "Emitted after the step is no longer active.",
+              "name": "cw-after-hide",
+              "reactName": "onCwAfterHide",
+              "eventName": "CwAfterHideEvent"
             }
           ],
           "attributes": [
             {
-              "name": "position",
-              "type": {
-                "text": "number"
-              },
-              "default": "50",
-              "description": "The current position of the divider from the primary panel's edge as a percentage 0-100. Defaults to 50% of the\ncontainer's initial size.",
-              "fieldName": "position"
-            },
-            {
-              "name": "position-in-pixels",
+              "name": "active",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "description": "The current position of the divider from the primary panel's edge in pixels.",
-              "fieldName": "positionInPixels"
+              "default": "false",
+              "description": "Indicates whether or not this is the current step. Only one step in a `<cw-stepper>` should be active at a time\n— the stepper manages this for you as steps are activated, but you can also set it directly.",
+              "fieldName": "active"
             },
             {
-              "name": "vertical",
+              "name": "completed",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws the split panel in a vertical orientation with the start and end panels stacked.",
-              "fieldName": "vertical"
+              "description": "Indicates that this step has been completed. Steppers in `linear` mode use this to gate which steps can be reached.",
+              "fieldName": "completed"
             },
             {
               "name": "disabled",
@@ -19919,64 +20684,61 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables resizing. Note that the position may still change as a result of resizing the host element.",
+              "description": "Disables the step so it can't be activated.",
               "fieldName": "disabled"
             },
             {
-              "name": "primary",
+              "name": "error",
               "type": {
-                "text": "'start' | 'end' | undefined"
+                "text": "boolean"
               },
-              "description": "If no primary panel is designated, both panels will resize proportionally when the host element is resized. If a\nprimary panel is designated, it will maintain its size and the other panel will grow or shrink as needed when the\nhost element is resized.",
-              "fieldName": "primary"
+              "default": "false",
+              "description": "Indicates that this step has an error, shown as a distinct visual state on the indicator.",
+              "fieldName": "error"
             },
             {
-              "name": "snap",
-              "description": "Either one or more space-separated values at which the divider should snap, in pixels, percentages, or repeat expressions e.g. `'100px 50% 500px' or `repeat(50%) 10px`,\nor a function which takes in a `SnapFunctionParams`, and returns a position to snap to, e.g. `({ pos }) => Math.round(pos / 8) * 8`.",
+              "name": "index",
               "type": {
-                "text": "string | SnapFunction"
+                "text": "number"
               },
-              "fieldName": "snap"
+              "default": "1",
+              "description": "The step's position within its `<cw-stepper>`, 1-based. Set automatically by the parent stepper — you shouldn't\nneed to set this yourself.",
+              "fieldName": "index"
             },
             {
-              "name": "snap-threshold",
+              "name": "orientation",
               "type": {
-                "text": "number"
+                "text": "'horizontal' | 'vertical'"
               },
-              "default": "12",
-              "description": "How close the divider must be to a snap point until snapping occurs.",
-              "fieldName": "snapThreshold"
+              "default": "'horizontal'",
+              "description": "The orientation of the stepper this item belongs to, used to draw the connecting line to the next step. Set\nautomatically by the parent stepper — you shouldn't need to set this yourself.",
+              "fieldName": "orientation"
             }
           ],
           "superclass": {
             "name": "CwElement",
             "module": "/src/internal/cw-element.js"
           },
-          "summary": "Split panels display two adjacent panels, allowing the user to reposition them.",
-          "tagNameWithoutPrefix": "split-panel",
-          "tagName": "cw-split-panel",
+          "summary": "Stepper items are individual steps used inside a [stepper](/components/stepper) — a step indicator for\nmulti-step forms, checkouts, and onboarding flows.",
+          "tagNameWithoutPrefix": "stepper-item",
+          "tagName": "cw-stepper-item",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Split panels display two adjacent panels, allowing the user to reposition them.\n * @documentation https://cordwainer.dev/components/split-panel\n * @status stable\n * @since 1.0\n *\n * @event cw-reposition - Emitted when the divider's position changes.\n *\n * @slot start - Content to place in the start panel.\n * @slot end - Content to place in the end panel.\n * @slot divider - The divider. Useful for slotting in a custom icon that renders as a handle.\n *\n * @csspart start - The start panel.\n * @csspart end - The end panel.\n * @csspart panel - Targets both the start and end panels.\n * @csspart divider - The divider that separates the start and end panels.\n *\n * @cssproperty [--divider-width=4px] - The width of the visible divider.\n * @cssproperty [--divider-hit-area=12px] - The invisible region around the divider where dragging can occur. This is\n *  usually wider than the divider to facilitate easier dragging.\n * @cssproperty [--min=0] - The minimum allowed size of the primary panel.\n * @cssproperty [--max=100%] - The maximum allowed size of the primary panel.\n */",
-          "documentation": "https://cordwainer.dev/components/split-panel",
-          "status": "stable",
-          "since": "1.0"
+          "jsDoc": "/**\n * @summary Stepper items are individual steps used inside a [stepper](/components/stepper) — a step indicator for\n *  multi-step forms, checkouts, and onboarding flows.\n * @documentation https://cordwainer.dev/components/stepper-item\n * @status experimental\n * @since 1.5\n *\n * @dependency cw-icon\n *\n * @slot - The step's label.\n * @slot completed-icon - Optional icon to use instead of the default checkmark when the step is completed.\n * @slot error-icon - Optional icon to use instead of the default when the step has an error.\n *\n * @event cw-show - Emitted when the step becomes active.\n * @event cw-after-show - Emitted after the step becomes active.\n * @event cw-hide - Emitted when the step is no longer active.\n * @event cw-after-hide - Emitted after the step is no longer active.\n *\n * @csspart base - The component's base wrapper.\n * @csspart header - The clickable header containing the indicator and label.\n * @csspart indicator - The circular indicator showing the step number, or a completed/error icon.\n * @csspart label - The container that wraps the step's label.\n */",
+          "documentation": "https://cordwainer.dev/components/stepper-item",
+          "status": "experimental",
+          "since": "1.5",
+          "dependencies": [
+            "cw-icon"
+          ]
         }
       ],
       "exports": [
-        {
-          "kind": "js",
-          "name": "SNAP_NONE",
-          "declaration": {
-            "name": "SNAP_NONE",
-            "module": "components/split-panel/split-panel.js"
-          }
-        },
         {
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CwSplitPanel",
-            "module": "components/split-panel/split-panel.js"
+            "name": "CwStepperItem",
+            "module": "components/stepper-item/stepper-item.js"
           }
         }
       ]
@@ -24353,7 +25115,7 @@
   "package": {
     "name": "@cordwainer/cw-elements",
     "description": "Cordwainer Elements — Web Component Library, a hard fork of Shoelace (@shoelace-style/shoelace).",
-    "version": "1.5.0-alpha.2",
+    "version": "1.5.0-alpha.4",
     "author": "Matt Hand",
     "homepage": "https://cordwainer.dev",
     "license": "MIT"