@rcarls/rc-combobox 0.6.0 → 0.7.0

package/dist/custom-elements.json

@@ -44,6 +44,13 @@
       "kind": "javascript-module",
       "path": "src/rc-combobox.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "DEFAULT_COMBOBOX_MESSAGES",
+          "type": {
+            "text": "Readonly<RCComboboxMessages>"
+          }
+        },
         {
           "kind": "class",
           "description": "Editable combobox with filtering and optional allow-create behavior, configured from\nnative option data and following the WAI-ARIA Combobox pattern.\n\nExtends `rc-select` by replacing the trigger `<div>` with a text `<input>`\nand adding: live filtering of the listbox, keyboard navigation from input,\nand an optional \"Create '{text}'\" option for new entries.",
@@ -87,22 +94,75 @@
             {
               "description": "Popup listbox border radius.",
               "name": "--rc-combobox-listbox-radius",
-              "default": "var(--rc-control-radius)"
+              "default": "var(--rc-popup-radius)"
+            },
+            {
+              "description": "Popup listbox open/close fade transition duration.",
+              "name": "--rc-combobox-listbox-duration",
+              "default": "150ms"
             },
             {
               "description": "Popup listbox border.",
               "name": "--rc-combobox-listbox-border",
-              "default": "var(--rc-border)"
+              "default": "var(--rc-popup-border)"
+            },
+            {
+              "description": "Popup listbox background.",
+              "name": "--rc-combobox-listbox-background",
+              "default": "var(--rc-popup-background)"
+            },
+            {
+              "description": "Popup listbox text color.",
+              "name": "--rc-combobox-listbox-color",
+              "default": "var(--rc-popup-color)"
             },
             {
               "description": "Popup listbox box shadow.",
               "name": "--rc-combobox-shadow",
-              "default": "var(--rc-shadow)"
+              "default": "var(--rc-popup-shadow)"
             },
             {
               "description": "Popup listbox block padding.",
               "name": "--rc-combobox-listbox-padding-block",
-              "default": "var(--rc-control-padding-block)"
+              "default": "var(--rc-popup-padding-block)"
+            },
+            {
+              "description": "Dialog search input border.",
+              "name": "--rc-combobox-dialog-input-border",
+              "default": "var(--rc-border)"
+            },
+            {
+              "description": "Dialog search input radius.",
+              "name": "--rc-combobox-dialog-input-radius",
+              "default": "var(--rc-control-radius)"
+            },
+            {
+              "description": "Dialog search input background.",
+              "name": "--rc-combobox-dialog-input-background",
+              "default": "var(--rc-field)"
+            },
+            {
+              "description": "Gap between fullscreen dialog regions.",
+              "name": "--rc-combobox-dialog-gap",
+              "default": "1rem"
+            },
+            {
+              "description": "Gap between fullscreen dialog header slots.",
+              "name": "--rc-combobox-dialog-header-gap",
+              "default": "0.5rem"
+            },
+            {
+              "description": "Gap between the dialog search label and input.",
+              "name": "--rc-combobox-dialog-search-gap",
+              "default": "0.25rem"
+            },
+            {
+              "description": "Visual-viewport inline space supplied by the anchor controller.",
+              "name": "--rc-anchor-viewport-inline-size"
+            },
+            {
+              "description": "Visual-viewport block space supplied by the anchor controller.",
+              "name": "--rc-anchor-viewport-block-size"
             },
             {
               "description": "Multi-select chip border radius.",
@@ -115,12 +175,17 @@
               "default": "0.1em"
             },
             {
-              "description": "Multi-select chip inline-axis padding.",
-              "name": "--rc-combobox-chip-padding-inline",
+              "description": "Multi-select chip leading padding.",
+              "name": "--rc-combobox-chip-padding-inline-start",
               "default": "0.3em"
             },
             {
-              "description": "Gap between chip label and remove icon.",
+              "description": "Multi-select chip trailing padding, including the remove affordance.",
+              "name": "--rc-combobox-chip-padding-inline-end",
+              "default": "calc(var(--rc-chip-remove-target-size, 1.5rem) + var(--rc-chip-remove-offset-inline, 0.125rem))"
+            },
+            {
+              "description": "Gap between chip content items.",
               "name": "--rc-combobox-chip-gap",
               "default": "calc(var(--rc-control-gap, 0.25em) * 0.8)"
             },
@@ -129,6 +194,26 @@
               "name": "--rc-combobox-chip-border",
               "default": "var(--rc-border)"
             },
+            {
+              "description": "Inherited remove-target width reserved by generated multi-select chips.",
+              "name": "--rc-chip-remove-target-size",
+              "default": "1.5rem"
+            },
+            {
+              "description": "Inherited edge offset reserved by generated multi-select chips.",
+              "name": "--rc-chip-remove-offset-inline",
+              "default": "0.125rem"
+            },
+            {
+              "description": "Space returned between wrapped chip rows after a touch target overlaps the field's leading padding.",
+              "name": "--rc-chip-touch-target-overlap-block-start",
+              "default": "0px"
+            },
+            {
+              "description": "Space returned between wrapped chip rows after a touch target overlaps the field's trailing padding.",
+              "name": "--rc-chip-touch-target-overlap-block-end",
+              "default": "0px"
+            },
             {
               "description": "Inline size of the toggle button's icon area.",
               "name": "--rc-combobox-toggle-size",
@@ -167,6 +252,46 @@
             {
               "description": "The `<rc-listbox>` popup element.",
               "name": "listbox"
+            },
+            {
+              "description": "Dialog popup surface.",
+              "name": "dialog"
+            },
+            {
+              "description": "Dialog title and action row.",
+              "name": "dialog-header"
+            },
+            {
+              "description": "Visible dialog title.",
+              "name": "dialog-title"
+            },
+            {
+              "description": "Scrollable selected-chip region.",
+              "name": "dialog-selected"
+            },
+            {
+              "description": "Dialog search field wrapper.",
+              "name": "dialog-search"
+            },
+            {
+              "description": "Dialog search input.",
+              "name": "dialog-input"
+            },
+            {
+              "description": "Dialog option list.",
+              "name": "dialog-listbox"
+            },
+            {
+              "description": "Dialog action group.",
+              "name": "dialog-actions"
+            },
+            {
+              "description": "Commits pending dialog selection and closes the dialog.",
+              "name": "dialog-confirm"
+            },
+            {
+              "description": "Discards pending dialog selection and closes the dialog. Built-in text follows the element's own `lang`, else `<html lang>`: per element through `messages`, or for every combobox through `registerMessages()` from `@rcarls/rc-common` under `rc-combobox`. Text registered under `rc-select` applies too, below the combobox's own. The \"Create\" option reads `rc-listbox`.",
+              "name": "dialog-cancel"
             }
           ],
           "slots": [
@@ -180,6 +305,23 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "messages",
+              "type": {
+                "text": "Partial<RCComboboxMessages> | undefined"
+              },
+              "description": "Built-in text overrides; unset keys fall back to registered text, then English."
+            },
+            {
+              "kind": "field",
+              "name": "_text",
+              "type": {
+                "text": "RCComboboxMessages"
+              },
+              "privacy": "protected",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "allowCreate",
@@ -204,10 +346,18 @@
               "kind": "field",
               "name": "_$trigger",
               "type": {
-                "text": "HTMLInputElement"
+                "text": "HTMLElement"
               },
               "privacy": "protected"
             },
+            {
+              "kind": "field",
+              "name": "_$dialogInput",
+              "type": {
+                "text": "HTMLInputElement | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "_filterText",
@@ -226,6 +376,39 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "_provisionalOptions",
+              "privacy": "private",
+              "default": "new Map<string, { value: string; label: string }>()"
+            },
+            {
+              "kind": "field",
+              "name": "_preDialogOptions",
+              "type": {
+                "text": "typeof this._options | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_$filterInput",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_$activeDescendantHost",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "protected",
+              "readonly": true
+            },
             {
               "kind": "method",
               "name": "openPopup"
@@ -284,6 +467,42 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_handleDialogAnchorClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleDialogTriggerKeyDown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_updateCreateOption",
@@ -358,6 +577,87 @@
               },
               "privacy": "private",
               "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_syncAccessibleName",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "$select",
+                  "type": {
+                    "text": "HTMLSelectElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_focusDialogContent",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_prepareDialogCommit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_commitDialogSelection",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_discardDialogSelection",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_finishDialogClose",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "returnFocus",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_renderDialogBody",
+              "privacy": "protected"
             }
           ],
           "events": [
@@ -380,6 +680,10 @@
               "default": "false",
               "fieldName": "allowCreate"
             },
+            {
+              "description": "Inherited from `rc-select`; mirrors the slotted native `<select>`'s own `required`, for `aria-required` on the input trigger.",
+              "name": "required"
+            },
             {
               "description": "How option labels are matched against typed input.\n\n- Forwarded to the internal `rc-listbox`.\n- Defaults to `'contains'` (substring).\n- Set to `'prefix'` for starts-with matching, or\n- Pass a custom `(label, query) => boolean` predicate.\n\nFunction values are JS-only; string values may be set via the `filter-strategy` attribute.",
               "name": "filter-strategy",
@@ -388,6 +692,10 @@
               },
               "default": "'contains'",
               "fieldName": "filterStrategy"
+            },
+            {
+              "description": "Presents options in an anchored `popover` (default) or modal `dialog`.",
+              "name": "popup-mode"
             }
           ],
           "superclass": {
@@ -399,6 +707,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "DEFAULT_COMBOBOX_MESSAGES",
+          "declaration": {
+            "name": "DEFAULT_COMBOBOX_MESSAGES",
+            "module": "src/rc-combobox.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "RCCombobox",