@vielzeug/codex 26.10.14 → 26.10.15

package/data/refine.json

@@ -1728,6 +1728,186 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "CARD_TAG",
+    "type": {
+      "text": "'ore-card'"
+    },
+    "default": "'ore-card'",
+    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions."
+  },
+  {
+    "kind": "class",
+    "name": "OreCardElement",
+    "tagName": "ore-card",
+    "customElement": true,
+    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "variant",
+        "type": {
+          "text": "'solid' | 'flat' | 'frost'"
+        },
+        "description": "Visual variant: 'solid' | 'flat' | 'frost'"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      },
+      {
+        "name": "padding",
+        "type": {
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
+        },
+        "description": "Internal padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
+      },
+      {
+        "name": "elevation",
+        "type": {
+          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
+        },
+        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
+      },
+      {
+        "name": "orientation",
+        "type": {
+          "text": "string"
+        },
+        "description": "Card layout: 'horizontal'"
+      },
+      {
+        "name": "interactive",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Enable pointer/keyboard activation"
+      },
+      {
+        "name": "disabled",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Disable card interaction"
+      },
+      {
+        "name": "loading",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Show loading progress bar"
+      }
+    ],
+    "events": [
+      {
+        "name": "activate",
+        "description": "Emitted when an interactive card is activated. detail: { originalEvent: MouseEvent | KeyboardEvent; trigger: 'pointer' | 'keyboard' }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "media",
+        "description": "Media content displayed at top/left"
+      },
+      {
+        "name": "header",
+        "description": "Card header (title, subtitle)"
+      },
+      {
+        "name": "",
+        "description": "Main card content"
+      },
+      {
+        "name": "footer",
+        "description": "Card footer content"
+      },
+      {
+        "name": "actions",
+        "description": "Action buttons or links"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "card",
+        "description": "Card root container."
+      },
+      {
+        "name": "loading-bar",
+        "description": "Loading progress bar."
+      },
+      {
+        "name": "media",
+        "description": "Media slot container."
+      },
+      {
+        "name": "body",
+        "description": "Body content container."
+      },
+      {
+        "name": "header",
+        "description": "Header container."
+      },
+      {
+        "name": "content",
+        "description": "Content container."
+      },
+      {
+        "name": "footer",
+        "description": "Footer container."
+      },
+      {
+        "name": "actions",
+        "description": "Actions slot container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--card-bg",
+        "description": "Background color"
+      },
+      {
+        "name": "--card-color",
+        "description": "Text color"
+      },
+      {
+        "name": "--card-border",
+        "description": "Border width"
+      },
+      {
+        "name": "--card-border-color",
+        "description": "Border color"
+      },
+      {
+        "name": "--card-radius",
+        "description": "Border radius"
+      },
+      {
+        "name": "--card-padding",
+        "description": "Internal padding"
+      },
+      {
+        "name": "--card-shadow",
+        "description": "Box shadow"
+      },
+      {
+        "name": "--card-hover-shadow",
+        "description": "Shadow on hover"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-card elevation=\"2\"><h3 slot=\"header\">Title</h3><p>Content</p></ore-card>\n<ore-card interactive color=\"primary\"><h3 slot=\"header\">Click me</h3></ore-card>\n<ore-card variant=\"frost\" color=\"secondary\">Frosted card</ore-card>\n```"
+      }
+    ]
+  },
   {
     "kind": "function",
     "name": "syncCoverflow",
@@ -1993,186 +2173,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "CARD_TAG",
-    "type": {
-      "text": "'ore-card'"
-    },
-    "default": "'ore-card'",
-    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions."
-  },
-  {
-    "kind": "class",
-    "name": "OreCardElement",
-    "tagName": "ore-card",
-    "customElement": true,
-    "description": "A versatile card container with semantic slots for media, header, body, footer, and actions.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'frost'"
-        },
-        "description": "Visual variant: 'solid' | 'flat' | 'frost'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      },
-      {
-        "name": "padding",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
-        },
-        "description": "Internal padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
-      },
-      {
-        "name": "elevation",
-        "type": {
-          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
-        },
-        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
-      },
-      {
-        "name": "orientation",
-        "type": {
-          "text": "string"
-        },
-        "description": "Card layout: 'horizontal'"
-      },
-      {
-        "name": "interactive",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Enable pointer/keyboard activation"
-      },
-      {
-        "name": "disabled",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Disable card interaction"
-      },
-      {
-        "name": "loading",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Show loading progress bar"
-      }
-    ],
-    "events": [
-      {
-        "name": "activate",
-        "description": "Emitted when an interactive card is activated. detail: { originalEvent: MouseEvent | KeyboardEvent; trigger: 'pointer' | 'keyboard' }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "media",
-        "description": "Media content displayed at top/left"
-      },
-      {
-        "name": "header",
-        "description": "Card header (title, subtitle)"
-      },
-      {
-        "name": "",
-        "description": "Main card content"
-      },
-      {
-        "name": "footer",
-        "description": "Card footer content"
-      },
-      {
-        "name": "actions",
-        "description": "Action buttons or links"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "card",
-        "description": "Card root container."
-      },
-      {
-        "name": "loading-bar",
-        "description": "Loading progress bar."
-      },
-      {
-        "name": "media",
-        "description": "Media slot container."
-      },
-      {
-        "name": "body",
-        "description": "Body content container."
-      },
-      {
-        "name": "header",
-        "description": "Header container."
-      },
-      {
-        "name": "content",
-        "description": "Content container."
-      },
-      {
-        "name": "footer",
-        "description": "Footer container."
-      },
-      {
-        "name": "actions",
-        "description": "Actions slot container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--card-bg",
-        "description": "Background color"
-      },
-      {
-        "name": "--card-color",
-        "description": "Text color"
-      },
-      {
-        "name": "--card-border",
-        "description": "Border width"
-      },
-      {
-        "name": "--card-border-color",
-        "description": "Border color"
-      },
-      {
-        "name": "--card-radius",
-        "description": "Border radius"
-      },
-      {
-        "name": "--card-padding",
-        "description": "Internal padding"
-      },
-      {
-        "name": "--card-shadow",
-        "description": "Box shadow"
-      },
-      {
-        "name": "--card-hover-shadow",
-        "description": "Shadow on hover"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-card elevation=\"2\"><h3 slot=\"header\">Title</h3><p>Content</p></ore-card>\n<ore-card interactive color=\"primary\"><h3 slot=\"header\">Click me</h3></ore-card>\n<ore-card variant=\"frost\" color=\"secondary\">Frosted card</ore-card>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "CHAT_MESSAGE_STATUSES",
@@ -4892,211 +4892,79 @@
     "description": "A container for accordion items with single or multiple selection modes."
   },
   {
-    "kind": "class",
-    "name": "OreAccordionElement",
-    "tagName": "ore-accordion",
-    "customElement": true,
-    "description": "A container for accordion items with single or multiple selection modes.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "selection-mode",
-        "type": {
-          "text": "'single' | 'multiple'"
-        },
-        "description": "Selection mode: 'single' | 'multiple'"
-      },
-      {
-        "name": "size",
-        "type": {
-          "text": "'sm' | 'md' | 'lg'"
-        },
-        "description": "Size for all items: 'sm' | 'md' | 'lg' (propagated to children)"
-      },
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'text' | 'frost'"
-        },
-        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'text' | 'frost' (propagated to children)"
-      }
-    ],
-    "events": [
-      {
-        "name": "expand",
-        "description": "Emitted when an item expands. detail: { expanded: boolean; item: HTMLElement }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      },
-      {
-        "name": "change",
-        "description": "Emitted when selection changes (single mode). detail: { expandedItem: HTMLElement }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "`ore-accordion-item` elements"
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--accordion-bg",
-        "description": "Container background color (solid/flat/frost variants)"
-      },
-      {
-        "name": "--accordion-border-color",
-        "description": "Container border color (solid/flat variants)"
-      },
-      {
-        "name": "--accordion-divider-color",
-        "description": "Divider color between items (text variant)"
-      },
-      {
-        "name": "--accordion-shadow",
-        "description": "Container box shadow"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-accordion selection-mode=\"single\">\n  <ore-accordion-item>\n    <span slot=\"title\">What is Refine?</span>\n    <p>Refine is a headless web component library.</p>\n  </ore-accordion-item>\n  <ore-accordion-item>\n    <span slot=\"title\">How do I install it?</span>\n    <p>Run <code>npm install @vielzeug/refine</code>.</p>\n  </ore-accordion-item>\n</ore-accordion>\n<ore-accordion variant=\"bordered\" selection-mode=\"multiple\">\n  <ore-accordion-item expanded><span slot=\"title\">Open by default</span><p>Content</p></ore-accordion-item>\n</ore-accordion>\n```"
-      }
-    ]
-  },
-  {
-    "kind": "variable",
-    "name": "TAB_ITEM_TAG",
-    "type": {
-      "text": "'ore-tab-item'"
-    },
-    "default": "'ore-tab-item'",
-    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`."
-  },
-  {
-    "kind": "class",
-    "name": "OreTabItemElement",
-    "tagName": "ore-tab-item",
-    "customElement": true,
-    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "value",
-        "type": {
-          "text": "string"
-        },
-        "description": "Unique identifier, matches the corresponding ore-tab-panel value"
-      },
-      {
-        "name": "active",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Set by the parent ore-tabs when this tab is selected"
-      },
-      {
-        "name": "disabled",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Prevents selection"
-      },
+    "kind": "class",
+    "name": "OreAccordionElement",
+    "tagName": "ore-accordion",
+    "customElement": true,
+    "description": "A container for accordion items with single or multiple selection modes.",
+    "summary": "",
+    "attributes": [
       {
-        "name": "density",
+        "name": "selection-mode",
         "type": {
-          "text": "'default' | 'compact'"
+          "text": "'single' | 'multiple'"
         },
-        "description": "Inherited spatial density: 'default' | 'compact'"
+        "description": "Selection mode: 'single' | 'multiple'"
       },
       {
         "name": "size",
         "type": {
           "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "'sm' | 'md' | 'lg'"
+        "description": "Size for all items: 'sm' | 'md' | 'lg' (propagated to children)"
       },
       {
         "name": "variant",
         "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
-        },
-        "description": "Inherited from ore-tabs: 'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "'solid' | 'flat' | 'bordered' | 'text' | 'frost'"
         },
-        "description": "Inherited from ore-tabs: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'text' | 'frost' (propagated to children)"
       }
     ],
-    "slots": [
-      {
-        "name": "prefix",
-        "description": "Icon or content before the label"
-      },
+    "events": [
       {
-        "name": "",
-        "description": "Tab label"
+        "name": "expand",
+        "description": "Emitted when an item expands. detail: { expanded: boolean; item: HTMLElement }",
+        "type": {
+          "text": "CustomEvent"
+        }
       },
       {
-        "name": "suffix",
-        "description": "Badge or count after the label"
+        "name": "change",
+        "description": "Emitted when selection changes (single mode). detail: { expandedItem: HTMLElement }",
+        "type": {
+          "text": "CustomEvent"
+        }
       }
     ],
-    "cssParts": [
+    "slots": [
       {
-        "name": "tab",
-        "description": "Tab trigger element."
+        "name": "",
+        "description": "`ore-accordion-item` elements"
       }
     ],
     "cssProperties": [
       {
-        "name": "--tab-item-radius",
-        "description": "Button border radius"
-      },
-      {
-        "name": "--tab-item-transition",
-        "description": "Transition duration/easing"
-      },
-      {
-        "name": "--tab-item-padding",
-        "description": "Button padding"
-      },
-      {
-        "name": "--tab-item-font-size",
-        "description": "Button font size"
-      },
-      {
-        "name": "--tab-item-color",
-        "description": "Default text color"
-      },
-      {
-        "name": "--tab-item-hover-bg",
-        "description": "Background on hover"
+        "name": "--accordion-bg",
+        "description": "Container background color (solid/flat/frost variants)"
       },
       {
-        "name": "--tab-item-active-bg",
-        "description": "Background when active/selected"
+        "name": "--accordion-border-color",
+        "description": "Container border color (solid/flat variants)"
       },
       {
-        "name": "--tab-item-active-color",
-        "description": "Text color when active/selected"
+        "name": "--accordion-divider-color",
+        "description": "Divider color between items (text variant)"
       },
       {
-        "name": "--tab-item-active-shadow",
-        "description": "Box shadow when active/selected"
+        "name": "--accordion-shadow",
+        "description": "Container box shadow"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-tab-item slot=\"tabs\" value=\"overview\">Overview</ore-tab-item>\n<ore-tab-item slot=\"tabs\" value=\"settings\" disabled>Settings</ore-tab-item>\n```"
+        "description": "```html\n<ore-accordion selection-mode=\"single\">\n  <ore-accordion-item>\n    <span slot=\"title\">What is Refine?</span>\n    <p>Refine is a headless web component library.</p>\n  </ore-accordion-item>\n  <ore-accordion-item>\n    <span slot=\"title\">How do I install it?</span>\n    <p>Run <code>npm install @vielzeug/refine</code>.</p>\n  </ore-accordion-item>\n</ore-accordion>\n<ore-accordion variant=\"bordered\" selection-mode=\"multiple\">\n  <ore-accordion-item expanded><span slot=\"title\">Open by default</span><p>Content</p></ore-accordion-item>\n</ore-accordion>\n```"
       }
     ]
   },
@@ -5287,6 +5155,138 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "TAB_ITEM_TAG",
+    "type": {
+      "text": "'ore-tab-item'"
+    },
+    "default": "'ore-tab-item'",
+    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`."
+  },
+  {
+    "kind": "class",
+    "name": "OreTabItemElement",
+    "tagName": "ore-tab-item",
+    "customElement": true,
+    "description": "Individual tab trigger. Must be placed in the `tabs` slot of `ore-tabs`.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Unique identifier, matches the corresponding ore-tab-panel value"
+      },
+      {
+        "name": "active",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Set by the parent ore-tabs when this tab is selected"
+      },
+      {
+        "name": "disabled",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Prevents selection"
+      },
+      {
+        "name": "density",
+        "type": {
+          "text": "'default' | 'compact'"
+        },
+        "description": "Inherited spatial density: 'default' | 'compact'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'sm' | 'md' | 'lg'"
+        },
+        "description": "'sm' | 'md' | 'lg'"
+      },
+      {
+        "name": "variant",
+        "type": {
+          "text": "'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
+        },
+        "description": "Inherited from ore-tabs: 'solid' | 'flat' | 'bordered' | 'ghost' | 'frost'"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Inherited from ore-tabs: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      }
+    ],
+    "slots": [
+      {
+        "name": "prefix",
+        "description": "Icon or content before the label"
+      },
+      {
+        "name": "",
+        "description": "Tab label"
+      },
+      {
+        "name": "suffix",
+        "description": "Badge or count after the label"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "tab",
+        "description": "Tab trigger element."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--tab-item-radius",
+        "description": "Button border radius"
+      },
+      {
+        "name": "--tab-item-transition",
+        "description": "Transition duration/easing"
+      },
+      {
+        "name": "--tab-item-padding",
+        "description": "Button padding"
+      },
+      {
+        "name": "--tab-item-font-size",
+        "description": "Button font size"
+      },
+      {
+        "name": "--tab-item-color",
+        "description": "Default text color"
+      },
+      {
+        "name": "--tab-item-hover-bg",
+        "description": "Background on hover"
+      },
+      {
+        "name": "--tab-item-active-bg",
+        "description": "Background when active/selected"
+      },
+      {
+        "name": "--tab-item-active-color",
+        "description": "Text color when active/selected"
+      },
+      {
+        "name": "--tab-item-active-shadow",
+        "description": "Box shadow when active/selected"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-tab-item slot=\"tabs\" value=\"overview\">Overview</ore-tab-item>\n<ore-tab-item slot=\"tabs\" value=\"settings\" disabled>Settings</ore-tab-item>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "TAB_PANEL_TAG",
@@ -6050,6 +6050,10 @@
       {
         "name": "chip",
         "description": "Shadow part for the `chip` element."
+      },
+      {
+        "name": "label",
+        "description": "Text label, available for wrapping overrides."
       }
     ],
     "cssProperties": [
@@ -9746,19 +9750,20 @@
         }
       },
       {
-        "name": "key",
+        "name": "{ key, value }",
         "type": {
-          "text": "string"
+          "text": "QueryToken"
         }
       },
       {
-        "name": "value",
+        "name": "selection",
+        "default": "'single'",
         "type": {
-          "text": "string"
+          "text": "'single' | 'multiple'"
         }
       }
     ],
-    "description": "One value per key: a second token replaces the first and keeps the pill's slot."
+    "description": "Adds a distinct value, or replaces a single-selection key in its existing slot."
   },
   {
     "kind": "function",
@@ -9768,6 +9773,30 @@
         "text": "QueryState"
       }
     },
+    "parameters": [
+      {
+        "name": "state",
+        "type": {
+          "text": "QueryState"
+        }
+      },
+      {
+        "name": "token",
+        "type": {
+          "text": "QueryToken"
+        }
+      }
+    ],
+    "description": "Removes only the exact key/value pair, preserving other values of the same key."
+  },
+  {
+    "kind": "function",
+    "name": "clearTokens",
+    "return": {
+      "type": {
+        "text": "QueryState"
+      }
+    },
     "parameters": [
       {
         "name": "state",
@@ -9781,14 +9810,15 @@
           "text": "string"
         }
       }
-    ]
+    ],
+    "description": "Clears all restrictions for one key."
   },
   {
     "kind": "function",
-    "name": "tokenValue",
+    "name": "tokenValues",
     "return": {
       "type": {
-        "text": "string | undefined"
+        "text": "string[]"
       }
     },
     "parameters": [
@@ -9878,7 +9908,7 @@
       "text": "'ore-query-bar'"
     },
     "default": "'ore-query-bar'",
-    "description": "A search field that accepts free text and `key:value` tokens together, in the\ngrammar GitHub's pull-request search made familiar. Committed tokens render as\nremovable pills inside the field; a suggestion dropdown lists the vocabulary's\nkeys and matching values while typing, so phones never need to type a colon.\n\nThe bar is state-driven: `vocabulary` defines the token keys and their accepted\nvalues, `state` carries `{ text, tokens }`, and every edit emits `input` +\n`change` with the new state readable from the element's `state` property. Omit\n`state` for uncontrolled use. External `state` writes whose `tokens` array is\nidentical to the current one are treated as echoes — only token changes are\nadopted — so text-only round-trips never wipe the field's live draft.\n\nThe dropdown opens while the field holds focus (and reopens on typing after\nEscape) and overlays the page from the top layer. Picking a key suggestion\nstarts composing `key:`; picking a value commits its pill. Typing a complete\n`key:value` commits immediately. Backspace on an empty field removes the last\npill. A draft whose value matches nothing shows a \"searching as text\" row\ninstead of closing; on blur, a bare `key:` fragment reverts and a dead draft\ndegrades into the searched text, so the field never carries silent residue."
+    "description": "A search field that accepts free text and `key:value` tokens together, in the\ngrammar GitHub's pull-request search made familiar. Applied filters stay inside\nthe field. A drawer edits filters without typing; curated quick filters toggle\nimmediately. Each vocabulary key chooses single or multiple selection; repeated\nkeys accumulate distinct values only in multiple mode. Typed suggestions and\nthe drawer share one vocabulary and state.\n\nThe bar is state-driven: `vocabulary` defines the token keys and their accepted\nvalues, `state` carries `{ text, tokens }`, and every edit emits `input` +\n`change` with the new state readable from the element's `state` property. Omit\n`state` for uncontrolled use. Equivalent external states preserve live drafts;\nactual external changes replace both text and tokens and dismiss pending edits.\n\nThe dropdown opens while the field holds focus (and reopens on typing after\nEscape) and overlays the page from the top layer. Picking a key suggestion\nstarts composing `key:`; picking a value commits its pill. Typing a complete\n`key:value` commits immediately. Backspace on an empty field removes the last\npill. A draft whose value matches nothing shows a \"searching as text\" row\ninstead of closing; on blur, a bare `key:` fragment reverts and a dead draft\ndegrades into the searched text, so the field never carries silent residue."
   },
   {
     "kind": "variable",
@@ -10103,6 +10133,10 @@
       {
         "name": "items",
         "description": "Items container."
+      },
+      {
+        "name": "legend",
+        "description": "Group label."
       }
     ],
     "cssProperties": [