@cordwainer/cw-elements 1.5.0-alpha.1 → 1.5.0-alpha.3

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,22 +277,336 @@
                 "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'"
+                "text": "boolean"
+              },
+              "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": "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 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"
+          ],
+          "animations": [
+            {
+              "name": "accordion-item.show",
+              "description": "The animation to use when showing the accordion item."
+            },
+            {
+              "name": "accordion-item.hide",
+              "description": "The animation to use when hiding the accordion item."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwAccordionItem",
+            "module": "components/accordion-item/accordion-item.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/alert/alert.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwAlert",
+          "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.",
+              "name": ""
+            },
+            {
+              "description": "An icon to show in the alert. Works best with `<cw-icon>`.",
+              "name": "icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'cw-icon-button': CwIconButton }"
+            },
+            {
+              "kind": "field",
+              "name": "autoHideTimeout",
+              "type": {
+                "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": "countdownElement",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "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.",
+              "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",
+              "type": {
+                "text": "'primary' | 'success' | 'neutral' | 'warning' | 'danger'"
+              },
+              "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"
+            },
+            {
+              "kind": "field",
+              "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.",
+              "attribute": "countdown",
+              "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",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "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 alert opens.",
+              "name": "cw-show",
+              "reactName": "onCwShow",
+              "eventName": "CwShowEvent"
+            },
+            {
+              "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": "open",
+              "type": {
+                "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.",
+              "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.",
@@ -13230,7 +13564,211 @@
           "jsDoc": "/**\n * @summary The Mutation Observer component offers a thin, declarative interface to the [`MutationObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).\n * @documentation https://cordwainer.dev/components/mutation-observer\n * @status stable\n * @since 1.0\n *\n * @event {{ mutationList: MutationRecord[] }} cw-mutation - Emitted when a mutation occurs.\n *\n * @slot - The content to watch for mutations.\n */",
           "documentation": "https://cordwainer.dev/components/mutation-observer",
           "status": "stable",
-          "since": "1.0"
+          "since": "1.0"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwMutationObserver",
+            "module": "components/mutation-observer/mutation-observer.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/option/option.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwOption",
+          "cssParts": [
+            {
+              "description": "The checked icon, an `<cw-icon>` element.",
+              "name": "checked-icon"
+            },
+            {
+              "description": "The component's base wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The option's label.",
+              "name": "label"
+            },
+            {
+              "description": "The container that wraps the prefix.",
+              "name": "prefix"
+            },
+            {
+              "description": "The container that wraps the suffix.",
+              "name": "suffix"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The option's label.",
+              "name": ""
+            },
+            {
+              "description": "Used to prepend an icon or similar element to the menu item.",
+              "name": "prefix"
+            },
+            {
+              "description": "Used to append an icon or similar element to the menu item.",
+              "name": "suffix"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'cw-icon': CwIcon }"
+            },
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "isInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "defaultSlot",
+              "type": {
+                "text": "HTMLSlotElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "current",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasHover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draws the option in a disabled state, preventing selection.",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "handleDefaultSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleMouseEnter",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleMouseLeave",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleDisabledChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleSelectedChange"
+            },
+            {
+              "kind": "method",
+              "name": "handleValueChange"
+            },
+            {
+              "kind": "method",
+              "name": "getTextLabel",
+              "description": "Returns a plain text label based on the option's content."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+              "fieldName": "value"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Draws the option in a disabled state, preventing selection.",
+              "fieldName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Options define the selectable items within various form controls such as [select](/components/select).",
+          "tagNameWithoutPrefix": "option",
+          "tagName": "cw-option",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Options define the selectable items within various form controls such as [select](/components/select).\n * @documentation https://cordwainer.dev/components/option\n * @status stable\n * @since 1.0\n *\n * @dependency cw-icon\n *\n * @slot - The option's label.\n * @slot prefix - Used to prepend an icon or similar element to the menu item.\n * @slot suffix - Used to append an icon or similar element to the menu item.\n *\n * @csspart checked-icon - The checked icon, an `<cw-icon>` element.\n * @csspart base - The component's base wrapper.\n * @csspart label - The option's label.\n * @csspart prefix - The container that wraps the prefix.\n * @csspart suffix - The container that wraps the suffix.\n */",
+          "documentation": "https://cordwainer.dev/components/option",
+          "status": "stable",
+          "since": "1.0",
+          "dependencies": [
+            "cw-icon"
+          ]
         }
       ],
       "exports": [
@@ -13238,54 +13776,48 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CwMutationObserver",
-            "module": "components/mutation-observer/mutation-observer.js"
+            "name": "CwOption",
+            "module": "components/option/option.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/option/option.js",
+      "path": "components/pagination/pagination.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CwOption",
+          "name": "CwPagination",
           "cssParts": [
             {
-              "description": "The checked icon, an `<cw-icon>` element.",
-              "name": "checked-icon"
-            },
-            {
-              "description": "The component's base wrapper.",
+              "description": "The component's base wrapper, a `<nav>` element.",
               "name": "base"
             },
             {
-              "description": "The option's label.",
-              "name": "label"
+              "description": "The container that wraps the page buttons and ellipses.",
+              "name": "pages"
             },
             {
-              "description": "The container that wraps the prefix.",
-              "name": "prefix"
+              "description": "An individual page button.",
+              "name": "page"
             },
             {
-              "description": "The container that wraps the suffix.",
-              "name": "suffix"
-            }
-          ],
-          "slots": [
+              "description": "Applied to the page button for the current page.",
+              "name": "page--active"
+            },
             {
-              "description": "The option's label.",
-              "name": ""
+              "description": "An ellipsis shown in place of collapsed page buttons.",
+              "name": "ellipsis"
             },
             {
-              "description": "Used to prepend an icon or similar element to the menu item.",
-              "name": "prefix"
+              "description": "The button that navigates to the previous page.",
+              "name": "previous-button"
             },
             {
-              "description": "Used to append an icon or similar element to the menu item.",
-              "name": "suffix"
+              "description": "The button that navigates to the next page.",
+              "name": "next-button"
             }
           ],
           "members": [
@@ -13296,7 +13828,7 @@
                 "text": "object"
               },
               "static": true,
-              "default": "{ 'cw-icon': CwIcon }"
+              "default": "{ 'cw-icon-button': CwIconButton }"
             },
             {
               "kind": "field",
@@ -13307,53 +13839,64 @@
             },
             {
               "kind": "field",
-              "name": "isInitialized",
+              "name": "totalItems",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "0",
+              "description": "The total number of items being paginated.",
+              "attribute": "total-items"
             },
             {
               "kind": "field",
-              "name": "defaultSlot",
+              "name": "pageSize",
               "type": {
-                "text": "HTMLSlotElement"
-              }
+                "text": "number"
+              },
+              "default": "10",
+              "description": "The number of items shown per page. Used with `total-items` to determine the total number of pages.",
+              "attribute": "page-size"
             },
             {
               "kind": "field",
-              "name": "current",
+              "name": "page",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false"
+              "default": "1",
+              "description": "The current page, 1-based.",
+              "attribute": "page",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "selected",
+              "name": "siblingCount",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false"
+              "default": "1",
+              "description": "The number of page buttons to show on either side of the current page.",
+              "attribute": "sibling-count"
             },
             {
               "kind": "field",
-              "name": "hasHover",
+              "name": "boundaryCount",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false"
+              "default": "1",
+              "description": "The number of page buttons to always show at the start and end of the page list.",
+              "attribute": "boundary-count"
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "size",
               "type": {
-                "text": "string"
+                "text": "'small' | 'medium' | 'large'"
               },
-              "default": "''",
-              "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
-              "attribute": "value",
+              "default": "'medium'",
+              "description": "The pagination's size.",
+              "attribute": "size",
               "reflects": true
             },
             {
@@ -13363,52 +13906,115 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws the option in a disabled state, preventing selection.",
+              "description": "Disables the pagination control.",
               "attribute": "disabled",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "totalPages",
+              "description": "The total number of pages, derived from `total-items` and `page-size`.",
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "handleDefaultSlotChange",
-              "privacy": "private"
+              "name": "setPage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "page",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "handleMouseEnter",
+              "name": "handlePreviousClick",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleMouseLeave",
+              "name": "handleNextClick",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleDisabledChange"
+              "name": "handlePageClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "page",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the current page changes as a result of user interaction.",
+              "name": "cw-change",
+              "reactName": "onCwChange",
+              "eventName": "CwChangeEvent"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "total-items",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "The total number of items being paginated.",
+              "fieldName": "totalItems"
             },
             {
-              "kind": "method",
-              "name": "handleSelectedChange"
+              "name": "page-size",
+              "type": {
+                "text": "number"
+              },
+              "default": "10",
+              "description": "The number of items shown per page. Used with `total-items` to determine the total number of pages.",
+              "fieldName": "pageSize"
             },
             {
-              "kind": "method",
-              "name": "handleValueChange"
+              "name": "page",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "The current page, 1-based.",
+              "fieldName": "page"
             },
             {
-              "kind": "method",
-              "name": "getTextLabel",
-              "description": "Returns a plain text label based on the option's content."
-            }
-          ],
-          "attributes": [
+              "name": "sibling-count",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "The number of page buttons to show on either side of the current page.",
+              "fieldName": "siblingCount"
+            },
             {
-              "name": "value",
+              "name": "boundary-count",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
-              "fieldName": "value"
+              "default": "1",
+              "description": "The number of page buttons to always show at the start and end of the page list.",
+              "fieldName": "boundaryCount"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "'small' | 'medium' | 'large'"
+              },
+              "default": "'medium'",
+              "description": "The pagination's size.",
+              "fieldName": "size"
             },
             {
               "name": "disabled",
@@ -13416,7 +14022,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Draws the option in a disabled state, preventing selection.",
+              "description": "Disables the pagination control.",
               "fieldName": "disabled"
             }
           ],
@@ -13424,16 +14030,16 @@
             "name": "CwElement",
             "module": "/src/internal/cw-element.js"
           },
-          "summary": "Options define the selectable items within various form controls such as [select](/components/select).",
-          "tagNameWithoutPrefix": "option",
-          "tagName": "cw-option",
+          "summary": "Pagination lets users navigate between pages of content.",
+          "tagNameWithoutPrefix": "pagination",
+          "tagName": "cw-pagination",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Options define the selectable items within various form controls such as [select](/components/select).\n * @documentation https://cordwainer.dev/components/option\n * @status stable\n * @since 1.0\n *\n * @dependency cw-icon\n *\n * @slot - The option's label.\n * @slot prefix - Used to prepend an icon or similar element to the menu item.\n * @slot suffix - Used to append an icon or similar element to the menu item.\n *\n * @csspart checked-icon - The checked icon, an `<cw-icon>` element.\n * @csspart base - The component's base wrapper.\n * @csspart label - The option's label.\n * @csspart prefix - The container that wraps the prefix.\n * @csspart suffix - The container that wraps the suffix.\n */",
-          "documentation": "https://cordwainer.dev/components/option",
-          "status": "stable",
-          "since": "1.0",
+          "jsDoc": "/**\n * @summary Pagination lets users navigate between pages of content.\n * @documentation https://cordwainer.dev/components/pagination\n * @status experimental\n * @since 1.1\n *\n * @dependency cw-icon-button\n *\n * @event cw-change - Emitted when the current page changes as a result of user interaction.\n *\n * @csspart base - The component's base wrapper, a `<nav>` element.\n * @csspart pages - The container that wraps the page buttons and ellipses.\n * @csspart page - An individual page button.\n * @csspart page--active - Applied to the page button for the current page.\n * @csspart ellipsis - An ellipsis shown in place of collapsed page buttons.\n * @csspart previous-button - The button that navigates to the previous page.\n * @csspart next-button - The button that navigates to the next page.\n */",
+          "documentation": "https://cordwainer.dev/components/pagination",
+          "status": "experimental",
+          "since": "1.1",
           "dependencies": [
-            "cw-icon"
+            "cw-icon-button"
           ]
         }
       ],
@@ -13442,270 +14048,325 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CwOption",
-            "module": "components/option/option.js"
+            "name": "CwPagination",
+            "module": "components/pagination/pagination.js"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "components/pagination/pagination.js",
+      "path": "components/popover/popover.js",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "CwPagination",
-          "cssParts": [
-            {
-              "description": "The component's base wrapper, a `<nav>` element.",
-              "name": "base"
-            },
+          "name": "CwPopover",
+          "cssProperties": [
             {
-              "description": "The container that wraps the page buttons and ellipses.",
-              "name": "pages"
+              "description": "The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used.",
+              "name": "--arrow-size",
+              "default": "6px"
             },
             {
-              "description": "An individual page button.",
-              "name": "page"
-            },
+              "description": "The color of the arrow.",
+              "name": "--arrow-color",
+              "default": "var(--cw-color-neutral-0)"
+            }
+          ],
+          "cssParts": [
             {
-              "description": "Applied to the page button for the current page.",
-              "name": "page--active"
+              "description": "The container that wraps the trigger.",
+              "name": "trigger"
             },
             {
-              "description": "An ellipsis shown in place of collapsed page buttons.",
-              "name": "ellipsis"
+              "description": "The popup's container, the element the native Popover API and floating-ui both act on.",
+              "name": "popup"
             },
             {
-              "description": "The button that navigates to the previous page.",
-              "name": "previous-button"
+              "description": "The arrow's container, present only when the `arrow` attribute is set.",
+              "name": "arrow"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The popover's content.",
+              "name": ""
             },
             {
-              "description": "The button that navigates to the next page.",
-              "name": "next-button"
+              "description": "The element that anchors and toggles the popover, usually a `<cw-button>`.",
+              "name": "trigger"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "cleanup",
               "type": {
-                "text": "object"
+                "text": "ReturnType<typeof autoUpdate> | undefined"
               },
-              "static": true,
-              "default": "{ 'cw-icon-button': CwIconButton }"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "localize",
+              "name": "closeWatcher",
+              "type": {
+                "text": "CloseWatcher | null"
+              },
               "privacy": "private",
-              "readonly": true,
-              "default": "new LocalizeController(this)"
+              "default": "null"
             },
             {
               "kind": "field",
-              "name": "totalItems",
+              "name": "trigger",
               "type": {
-                "text": "number"
+                "text": "HTMLSlotElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "popup",
+              "type": {
+                "text": "HTMLElement"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "arrowEl",
+              "type": {
+                "text": "HTMLElement"
               },
-              "default": "0",
-              "description": "The total number of items being paginated.",
-              "attribute": "total-items"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "pageSize",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "10",
-              "description": "The number of items shown per page. Used with `total-items` to determine the total number of pages.",
-              "attribute": "page-size"
+              "default": "false",
+              "description": "Indicates whether or not the popover is open. You can toggle this attribute to show and hide the popover, or you\ncan use the `show()` and `hide()` methods. Clicking outside the popover or pressing Escape closes it too.",
+              "attribute": "open",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "page",
+              "name": "placement",
               "type": {
-                "text": "number"
+                "text": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'"
               },
-              "default": "1",
-              "description": "The current page, 1-based.",
-              "attribute": "page",
+              "default": "'top'",
+              "description": "The preferred placement of the popover. Note that the actual placement may vary as needed to keep the popover\ninside of the viewport.",
+              "attribute": "placement",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "siblingCount",
+              "name": "disabled",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "1",
-              "description": "The number of page buttons to show on either side of the current page.",
-              "attribute": "sibling-count"
+              "default": "false",
+              "description": "Disables the popover so it can't be opened.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "boundaryCount",
+              "name": "distance",
               "type": {
                 "text": "number"
               },
-              "default": "1",
-              "description": "The number of page buttons to always show at the start and end of the page list.",
-              "attribute": "boundary-count"
+              "default": "0",
+              "description": "The distance in pixels from which to offset the popover away from its trigger.",
+              "attribute": "distance"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "skidding",
               "type": {
-                "text": "'small' | 'medium' | 'large'"
+                "text": "number"
               },
-              "default": "'medium'",
-              "description": "The pagination's size.",
-              "attribute": "size",
-              "reflects": true
+              "default": "0",
+              "description": "The distance in pixels from which to offset the popover along its trigger.",
+              "attribute": "skidding"
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "arrow",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the pagination control.",
-              "attribute": "disabled",
+              "description": "Attaches an arrow to the popover, pointing at the trigger. The arrow's size and color can be customized using\nthe `--arrow-size` and `--arrow-color` custom properties, or via `::part(arrow)`.",
+              "attribute": "arrow",
               "reflects": true
             },
             {
-              "kind": "field",
-              "name": "totalPages",
-              "description": "The total number of pages, derived from `total-items` and `page-size`.",
-              "readonly": true
+              "kind": "method",
+              "name": "show",
+              "description": "Shows the popover."
             },
             {
               "kind": "method",
-              "name": "setPage",
+              "name": "hide",
+              "description": "Hides the popover."
+            },
+            {
+              "kind": "method",
+              "name": "reposition",
+              "description": "Instructs the popover to recalculate and update its position. Useful if the trigger's size or position changes."
+            },
+            {
+              "kind": "method",
+              "name": "getAnchor",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "page",
-                  "type": {
-                    "text": "number"
-                  }
+              "return": {
+                "type": {
+                  "text": "HTMLElement | undefined"
                 }
-              ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "handleTriggerClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDocumentMouseDown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "handleDocumentKeyDown",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handlePreviousClick",
+              "name": "addOpenListeners",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handleNextClick",
+              "name": "removeOpenListeners",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "handlePageClick",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "page",
-                  "type": {
-                    "text": "number"
-                  }
-                }
-              ]
+              "name": "handleOpenChange"
             }
           ],
           "events": [
             {
-              "description": "Emitted when the current page changes as a result of user interaction.",
-              "name": "cw-change",
-              "reactName": "onCwChange",
-              "eventName": "CwChangeEvent"
+              "description": "Emitted when the popover opens.",
+              "name": "cw-show",
+              "reactName": "onCwShow",
+              "eventName": "CwShowEvent"
+            },
+            {
+              "description": "Emitted after the popover opens and all animations are complete.",
+              "name": "cw-after-show",
+              "reactName": "onCwAfterShow",
+              "eventName": "CwAfterShowEvent"
+            },
+            {
+              "description": "Emitted when the popover closes, whether via `hide()`/toggling `open`, or dismissed natively (clicking outside, pressing Escape).",
+              "name": "cw-hide",
+              "reactName": "onCwHide",
+              "eventName": "CwHideEvent"
+            },
+            {
+              "description": "Emitted after the popover closes and all animations are complete.",
+              "name": "cw-after-hide",
+              "reactName": "onCwAfterHide",
+              "eventName": "CwAfterHideEvent"
             }
           ],
           "attributes": [
             {
-              "name": "total-items",
+              "name": "open",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "0",
-              "description": "The total number of items being paginated.",
-              "fieldName": "totalItems"
+              "default": "false",
+              "description": "Indicates whether or not the popover is open. You can toggle this attribute to show and hide the popover, or you\ncan use the `show()` and `hide()` methods. Clicking outside the popover or pressing Escape closes it too.",
+              "fieldName": "open"
             },
             {
-              "name": "page-size",
+              "name": "placement",
               "type": {
-                "text": "number"
+                "text": "| 'top'\n    | 'top-start'\n    | 'top-end'\n    | 'bottom'\n    | 'bottom-start'\n    | 'bottom-end'\n    | 'right'\n    | 'right-start'\n    | 'right-end'\n    | 'left'\n    | 'left-start'\n    | 'left-end'"
               },
-              "default": "10",
-              "description": "The number of items shown per page. Used with `total-items` to determine the total number of pages.",
-              "fieldName": "pageSize"
+              "default": "'top'",
+              "description": "The preferred placement of the popover. Note that the actual placement may vary as needed to keep the popover\ninside of the viewport.",
+              "fieldName": "placement"
             },
             {
-              "name": "page",
+              "name": "disabled",
               "type": {
-                "text": "number"
+                "text": "boolean"
               },
-              "default": "1",
-              "description": "The current page, 1-based.",
-              "fieldName": "page"
+              "default": "false",
+              "description": "Disables the popover so it can't be opened.",
+              "fieldName": "disabled"
             },
             {
-              "name": "sibling-count",
+              "name": "distance",
               "type": {
                 "text": "number"
               },
-              "default": "1",
-              "description": "The number of page buttons to show on either side of the current page.",
-              "fieldName": "siblingCount"
+              "default": "0",
+              "description": "The distance in pixels from which to offset the popover away from its trigger.",
+              "fieldName": "distance"
             },
             {
-              "name": "boundary-count",
+              "name": "skidding",
               "type": {
                 "text": "number"
               },
-              "default": "1",
-              "description": "The number of page buttons to always show at the start and end of the page list.",
-              "fieldName": "boundaryCount"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'small' | 'medium' | 'large'"
-              },
-              "default": "'medium'",
-              "description": "The pagination's size.",
-              "fieldName": "size"
+              "default": "0",
+              "description": "The distance in pixels from which to offset the popover along its trigger.",
+              "fieldName": "skidding"
             },
             {
-              "name": "disabled",
+              "name": "arrow",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the pagination control.",
-              "fieldName": "disabled"
+              "description": "Attaches an arrow to the popover, pointing at the trigger. The arrow's size and color can be customized using\nthe `--arrow-size` and `--arrow-color` custom properties, or via `::part(arrow)`.",
+              "fieldName": "arrow"
             }
           ],
           "superclass": {
             "name": "CwElement",
             "module": "/src/internal/cw-element.js"
           },
-          "summary": "Pagination lets users navigate between pages of content.",
-          "tagNameWithoutPrefix": "pagination",
-          "tagName": "cw-pagination",
+          "summary": "Popovers display rich content anchored to a trigger, positioned with floating-ui and rendered via the\nnative Popover API's top layer — a good fit for content that doesn't belong in a tooltip (hover-only) or a\ndropdown (menu-focused).",
+          "tagNameWithoutPrefix": "popover",
+          "tagName": "cw-popover",
           "customElement": true,
-          "jsDoc": "/**\n * @summary Pagination lets users navigate between pages of content.\n * @documentation https://cordwainer.dev/components/pagination\n * @status experimental\n * @since 1.1\n *\n * @dependency cw-icon-button\n *\n * @event cw-change - Emitted when the current page changes as a result of user interaction.\n *\n * @csspart base - The component's base wrapper, a `<nav>` element.\n * @csspart pages - The container that wraps the page buttons and ellipses.\n * @csspart page - An individual page button.\n * @csspart page--active - Applied to the page button for the current page.\n * @csspart ellipsis - An ellipsis shown in place of collapsed page buttons.\n * @csspart previous-button - The button that navigates to the previous page.\n * @csspart next-button - The button that navigates to the next page.\n */",
-          "documentation": "https://cordwainer.dev/components/pagination",
+          "jsDoc": "/**\n * @summary Popovers display rich content anchored to a trigger, positioned with floating-ui and rendered via the\n *  native Popover API's top layer — a good fit for content that doesn't belong in a tooltip (hover-only) or a\n *  dropdown (menu-focused).\n * @documentation https://cordwainer.dev/components/popover\n * @status experimental\n * @since 1.5\n *\n * @slot - The popover's content.\n * @slot trigger - The element that anchors and toggles the popover, usually a `<cw-button>`.\n *\n * @event cw-show - Emitted when the popover opens.\n * @event cw-after-show - Emitted after the popover opens and all animations are complete.\n * @event cw-hide - Emitted when the popover closes, whether via `hide()`/toggling `open`, or dismissed natively\n *  (clicking outside, pressing Escape).\n * @event cw-after-hide - Emitted after the popover closes and all animations are complete.\n *\n * @csspart trigger - The container that wraps the trigger.\n * @csspart popup - The popup's container, the element the native Popover API and floating-ui both act on.\n * @csspart arrow - The arrow's container, present only when the `arrow` attribute is set.\n *\n * @cssproperty [--arrow-size=6px] - The size of the arrow. Note that an arrow won't be shown unless the `arrow`\n *  attribute is used.\n * @cssproperty [--arrow-color=var(--cw-color-neutral-0)] - The color of the arrow.\n *\n * @animation popover.show - The animation to use when showing the popover.\n * @animation popover.hide - The animation to use when hiding the popover.\n */",
+          "documentation": "https://cordwainer.dev/components/popover",
           "status": "experimental",
-          "since": "1.1",
-          "dependencies": [
-            "cw-icon-button"
+          "since": "1.5",
+          "animations": [
+            {
+              "name": "popover.show",
+              "description": "The animation to use when showing the popover."
+            },
+            {
+              "name": "popover.hide",
+              "description": "The animation to use when hiding the popover."
+            }
           ]
         }
       ],
@@ -13714,8 +14375,8 @@
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "CwPagination",
-            "module": "components/pagination/pagination.js"
+            "name": "CwPopover",
+            "module": "components/popover/popover.js"
           }
         }
       ]
@@ -24026,7 +24687,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.1",
+    "version": "1.5.0-alpha.3",
     "author": "Matt Hand",
     "homepage": "https://cordwainer.dev",
     "license": "MIT"