@threadlabs/looma 0.1.23 → 0.1.24

package/dist/collection/components/ui-menu/ui-menu.js

@@ -2,10 +2,12 @@ import { Host, h } from "@stencil/core";
 import { eventToTrigger } from "../../utils/events";
 import { dispatchDetail } from "../../utils/events";
 import { closeOverlay, openOverlay, requestTopOverlayClose } from "../../overlay/manager";
+import { controlledOrDefault, isControlled } from "../../utils/controlled-state";
 import { createAnchoredSurface, } from "../../overlay/positioning";
 export class UIMenu {
     host;
-    open = false;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open;
     defaultOpen = false;
     /** Id of the control that anchors this menu in the top layer. */
     for;
@@ -16,7 +18,8 @@ export class UIMenu {
     anchor = null;
     surface = null;
     syncFromProp() {
-        this.internalOpen = this.open;
+        if (isControlled(this.open))
+            this.internalOpen = this.open;
     }
     resetSurface() {
         this.setupSurface();
@@ -43,8 +46,7 @@ export class UIMenu {
         }
     }
     componentDidLoad() {
-        this.syncFromProp();
-        this.internalOpen = this.internalOpen || this.defaultOpen;
+        this.internalOpen = controlledOrDefault(this.open, this.defaultOpen);
         this.host.addEventListener('click', this.onItemClick);
         this.host.addEventListener('keydown', this.onKeydown);
         this.setupSurface();
@@ -77,7 +79,8 @@ export class UIMenu {
     closeMenu(reason, trigger) {
         if (!this.internalOpen)
             return;
-        this.internalOpen = false;
+        if (!isControlled(this.open))
+            this.internalOpen = false;
         dispatchDetail(this.host, 'close', {
             open: false,
             reason: reason,
@@ -108,7 +111,8 @@ export class UIMenu {
             reason: 'action',
             trigger: eventToTrigger(e),
         });
-        this.internalOpen = false;
+        if (!isControlled(this.open))
+            this.internalOpen = false;
     };
     onKeydown = (e) => {
         if (e.key === 'Escape') {
@@ -131,7 +135,8 @@ export class UIMenu {
                     reason: 'action',
                     trigger: 'keyboard',
                 });
-                this.internalOpen = false;
+                if (!isControlled(this.open))
+                    this.internalOpen = false;
             }
             return;
         }
@@ -148,7 +153,7 @@ export class UIMenu {
         }
     };
     render() {
-        return (h(Host, { key: '25ae79e914820dfc470fa03d8c843646c3c060d9', role: "menu", "aria-orientation": "vertical", "data-open": this.internalOpen ? '' : undefined }, h("slot", { key: 'b3a8b130e55610d948bc3e4603dede59dd560d05' })));
+        return (h(Host, { key: 'c5af7acaf41b75165e9f7cf47d65b7a1dcd4d1c0', role: "menu", "aria-orientation": "vertical", "data-open": this.internalOpen ? '' : undefined }, h("div", { key: '058fff9a00a1dcba26f6db425096e7a96d889896', class: "menu__surface" }, h("slot", { key: 'dbbf9eb4ba2a348b6d85049e229ed0562ee17318' }))));
     }
     static get is() { return "ui-menu"; }
     static get encapsulation() { return "shadow"; }
@@ -173,16 +178,15 @@ export class UIMenu {
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Controlled open state. Omit it to use defaultOpen and local interaction state."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "open",
-                "defaultValue": "false"
+                "attribute": "open"
             },
             "defaultOpen": {
                 "type": "boolean",

package/dist/collection/components/ui-menu-item/ui-menu-item.css

@@ -1,6 +1,12 @@
 :host {
   display: block;
   width: 100%;
+}
+
+.menu-item__surface {
+  display: block;
+  box-sizing: border-box;
+  width: 100%;
   padding: var(--ui-space-2) var(--ui-space-3);
   text-align: left;
   background: none;
@@ -15,12 +21,12 @@
     color var(--ui-motion-fast) var(--ui-motion-ease);
 }
 
-:host(:hover:not([aria-disabled='true']):not([disabled])) {
+:host(:hover:not([aria-disabled='true']):not([disabled])) .menu-item__surface {
   background: var(--ui-surface-subtle);
 }
 
-:host([aria-disabled='true']),
-:host([disabled]) {
+:host([aria-disabled='true']) .menu-item__surface,
+:host([disabled]) .menu-item__surface {
   opacity: 0.6;
   cursor: not-allowed;
 }

package/dist/collection/components/ui-menu-item/ui-menu-item.js

@@ -3,7 +3,7 @@ export class UIMenuItem {
     disabled = false;
     value = '';
     render() {
-        return (h(Host, { key: 'ebd7c5aa5c8fdce2d2349aef7f1a4505b9190852', role: "menuitem", tabIndex: this.disabled ? -1 : 0, "aria-disabled": this.disabled ? 'true' : undefined, "data-value": this.value || undefined }, h("slot", { key: '7b55a8545034b055f8cbd047a0f16ea729af097e' })));
+        return (h(Host, { key: 'f8a1721f8e516af04f901b53c3a66ce1de932608', role: "menuitem", tabIndex: this.disabled ? -1 : 0, "aria-disabled": this.disabled ? 'true' : undefined, "data-value": this.value || undefined }, h("span", { key: '6483d0b3ce1be06aed214f626b2d6a2963a44ade', class: "menu-item__surface" }, h("slot", { key: 'db470b1cbb54d56a14d05c0d7f72c43e37f4263e' }))));
     }
     static get is() { return "ui-menu-item"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-popover/ui-popover.css

@@ -1,16 +1,25 @@
 :host {
   --ui-popover-viewport-gap: var(--ui-space-2, 0.5rem);
-  padding: var(--ui-space-3);
-  background: var(--ui-surface-elevated);
-  border: 1px solid var(--ui-border-default);
-  border-radius: var(--ui-radius-3);
-  box-shadow: var(--ui-shadow-lg);
+  box-sizing: border-box;
   max-inline-size: min(
     20rem,
     calc(100vw - (var(--ui-popover-viewport-gap) * 2))
   );
   max-block-size: calc(100dvh - (var(--ui-popover-viewport-gap) * 2));
   overflow: auto;
+  padding: 0;
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+  box-shadow: var(--ui-shadow-lg);
+}
+
+.popover__surface {
+  box-sizing: border-box;
+  padding: var(--ui-space-3);
+  background: var(--ui-surface-elevated);
+  border: 1px solid var(--ui-border-default);
+  border-radius: var(--ui-radius-3);
 }
 
 :host(:not([data-open])) {

package/dist/collection/components/ui-popover/ui-popover.js

@@ -1,10 +1,12 @@
 import { Host, h } from "@stencil/core";
 import { openOverlay, closeOverlay, requestTopOverlayClose } from "../../overlay/manager";
 import { dispatchDetail } from "../../utils/events";
+import { controlledOrDefault, isControlled } from "../../utils/controlled-state";
 import { createAnchoredSurface, } from "../../overlay/positioning";
 export class UIPopover {
     host;
-    open = false;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open;
     defaultOpen = false;
     /** Optional id of the element this popover follows in the top layer. */
     for;
@@ -14,7 +16,8 @@ export class UIPopover {
     anchor = null;
     surface = null;
     syncFromProp() {
-        this.internalOpen = this.open;
+        if (isControlled(this.open))
+            this.internalOpen = this.open;
     }
     onOpenChange() {
         this.syncOverlay();
@@ -73,8 +76,7 @@ export class UIPopover {
         }
     }
     componentDidLoad() {
-        this.syncFromProp();
-        this.internalOpen = this.internalOpen || this.defaultOpen;
+        this.internalOpen = controlledOrDefault(this.open, this.defaultOpen);
         this.host.addEventListener('keydown', this.onKeydown);
         this.setupSurface();
         this.syncOverlay();
@@ -89,7 +91,8 @@ export class UIPopover {
         this.syncOverlay();
     }
     handleRequestClose(reason, trigger) {
-        this.internalOpen = false;
+        if (!isControlled(this.open))
+            this.internalOpen = false;
         dispatchDetail(this.host, 'close', {
             open: false,
             reason: reason,
@@ -102,7 +105,7 @@ export class UIPopover {
         }
     };
     render() {
-        return (h(Host, { key: 'cd957cb9fd5d1c05da7729a16d4cb229bc1deffa', "data-open": this.internalOpen ? '' : undefined, onKeyDown: this.onKeydown }, h("slot", { key: 'd14960a1471948120f7173e18adae8d86e4fabb7' })));
+        return (h(Host, { key: '6a38873f2e4d085f733fa116057b1f55418e23ed', "data-open": this.internalOpen ? '' : undefined, onKeyDown: this.onKeydown }, h("div", { key: '6fef6e37921e8c52994617719f1ebb6d9bd54ee2', class: "popover__surface" }, h("slot", { key: '5ee4269592219035a3185f8f06fd71ecb12e4e71' }))));
     }
     static get is() { return "ui-popover"; }
     static get encapsulation() { return "shadow"; }
@@ -127,16 +130,15 @@ export class UIPopover {
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Controlled open state. Omit it to use defaultOpen and local interaction state."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "open",
-                "defaultValue": "false"
+                "attribute": "open"
             },
             "defaultOpen": {
                 "type": "boolean",

package/dist/collection/components/ui-radio/ui-radio.js

@@ -1,30 +1,35 @@
 import { Host, h } from "@stencil/core";
 import { eventToTrigger } from "../../utils/events";
 import { dispatchDetail } from "../../utils/events";
+import { controlledOrDefault, isControlled } from "../../utils/controlled-state";
 export class UIRadio {
     host;
-    checked = false;
+    /** Controlled checked state. Omit it to use defaultChecked and local interaction state. */
+    checked;
     defaultChecked = false;
     disabled = false;
     name = '';
     required = false;
     value = 'on';
+    internalChecked = false;
     slotRef;
+    syncFromProp() {
+        if (isControlled(this.checked))
+            this.internalChecked = this.checked;
+    }
     syncToInput() {
         const input = this.getInput();
         if (!input)
             return;
         this.host.toggleAttribute('data-disabled', this.disabled);
-        input.checked = this.checked;
+        input.checked = this.internalChecked;
         input.disabled = this.disabled;
         input.name = this.name;
         input.required = this.required;
         input.value = this.value;
     }
     componentDidLoad() {
-        if (!this.checked && this.defaultChecked) {
-            this.checked = true;
-        }
+        this.internalChecked = controlledOrDefault(this.checked, this.defaultChecked);
         this.slotRef?.addEventListener('slotchange', () => this.syncToInput());
         this.syncToInput();
         const input = this.getInput();
@@ -46,6 +51,10 @@ export class UIRadio {
         const input = e.target;
         if (!input || !input.checked)
             return;
+        if (!isControlled(this.checked))
+            this.internalChecked = true;
+        else
+            this.syncToInput();
         dispatchDetail(this.host, 'change', {
             checked: true,
             value: this.value,
@@ -53,7 +62,7 @@ export class UIRadio {
         });
     };
     render() {
-        return (h(Host, { key: '898869b84429366e43c075723e884f34da6fc6df', role: "radio", "aria-checked": String(this.checked), "aria-disabled": String(this.disabled), "data-disabled": this.disabled ? '' : undefined }, h("slot", { key: '3f3b881175f25d439807ec9f8f0dd59a1acd6a90', ref: (el) => (this.slotRef = el) })));
+        return (h(Host, { key: 'a5220e72dbf1b55ca73a3e6234f31c99d806433a', role: "radio", "aria-checked": String(this.internalChecked), "aria-disabled": String(this.disabled), "data-disabled": this.disabled ? '' : undefined }, h("slot", { key: '687e94b2036107c807e0319c3620bca7c06cbb26', ref: (el) => (this.slotRef = el) })));
     }
     static get is() { return "ui-radio"; }
     static get encapsulation() { return "shadow"; }
@@ -78,16 +87,15 @@ export class UIRadio {
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Controlled checked state. Omit it to use defaultChecked and local interaction state."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "checked",
-                "defaultValue": "false"
+                "attribute": "checked"
             },
             "defaultChecked": {
                 "type": "boolean",
@@ -191,11 +199,16 @@ export class UIRadio {
             }
         };
     }
+    static get states() {
+        return {
+            "internalChecked": {}
+        };
+    }
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
                 "propName": "checked",
-                "methodName": "syncToInput"
+                "methodName": "syncFromProp"
             }, {
                 "propName": "disabled",
                 "methodName": "syncToInput"

package/dist/collection/components/ui-radio-group/ui-radio-group.js

@@ -102,7 +102,7 @@ export class UIRadioGroup {
         }
     };
     render() {
-        return (h(Host, { key: 'e80e01600d499d1b8e3410060433dac2bb8cf38a', role: "radiogroup", "aria-orientation": this.orientation, "data-orientation": this.orientation, "data-disabled": this.disabled ? '' : undefined }, h("slot", { key: 'e60dcfa1b174b1a4c9092567e6ec4d9f5bcd9ffe' })));
+        return (h(Host, { key: '28c6eb6cc9520b570f40d2193d0c64a7a6c7db01', role: "radiogroup", "aria-orientation": this.orientation, "data-orientation": this.orientation, "data-disabled": this.disabled ? '' : undefined }, h("slot", { key: '97814378181be78bfac6090ff173459e1f539728' })));
     }
     static get is() { return "ui-radio-group"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-search-result-row/ui-search-result-row.js

@@ -31,7 +31,7 @@ export class UISearchResultRow {
         this.hasTrailing = slotHasContent(this.trailingSlot);
     };
     render() {
-        return (h(Host, { key: '8ef897782b50f1ecb129a51a25631d3d2bafe1e3' }, h("button", { key: '5b4fb4ac4968551a191e80bde7b991391d931220', class: "search-result-row", type: "button", disabled: this.disabled, part: "button" }, h("span", { key: '5f5988d87bcf754d8a521e19e0e2a490dd868bd2', class: "search-result-row__leading", part: "leading", hidden: !this.hasLeading }, h("slot", { key: 'a7671c75c28d71ab843dcbb1fcdd9f4d0e0f7361', name: "leading", ref: (el) => (this.leadingSlot = el), onSlotchange: this.syncSlots })), h("span", { key: '4ed60057e10ade9d7771812ad28aa25a017d34d8', class: "search-result-row__content", part: "content" }, h("span", { key: '37fa74ef4980ffd0b576ff824532d1267420461c', class: "search-result-row__title", part: "title" }, h("slot", { key: '187df950b39702723fa456b09e220e2b7587f00a', name: "title" })), h("span", { key: '6d2476c57d7c9c7530c3796a723f47f5f4859d71', class: "search-result-row__meta", part: "meta", hidden: !this.hasMeta }, h("slot", { key: 'd53329dd6865bbda005b0d25a2b9bc7b7a597452', name: "meta", ref: (el) => (this.metaSlot = el), onSlotchange: this.syncSlots })), h("span", { key: '8846c9669c0f65a739b770f41a93ddd4bef3f6bd', class: "search-result-row__excerpt", part: "excerpt", hidden: !this.hasExcerpt }, h("slot", { key: 'b63f70371538901aaff481a9e524bf817883cee6', name: "excerpt", ref: (el) => (this.excerptSlot = el), onSlotchange: this.syncSlots }))), h("span", { key: '1e8f94c3d83c3f649595c2843522b0973590a8d5', class: "search-result-row__trailing", part: "trailing", hidden: !this.hasTrailing }, h("slot", { key: 'cfba9301ad97c1130a01f78c16052fc26e249f4b', name: "trailing", ref: (el) => (this.trailingSlot = el), onSlotchange: this.syncSlots })))));
+        return (h(Host, { key: '01e795d1c723c4e56f5648c429b40fc7841ff9b5' }, h("button", { key: '7bdde5075c5a3112d14741aa87937e69a8f5fea9', class: "search-result-row", type: "button", disabled: this.disabled, part: "button" }, h("span", { key: '39ba47af68a23875eebdbdf8f87ca7d94d42ec43', class: "search-result-row__leading", part: "leading", hidden: !this.hasLeading }, h("slot", { key: 'f108b1c5d284057d5979bf4897f056543a1ff092', name: "leading", ref: (el) => (this.leadingSlot = el), onSlotchange: this.syncSlots })), h("span", { key: '0daeb171b7010f37d959c91f2a87c1ae7e96a56f', class: "search-result-row__content", part: "content" }, h("span", { key: 'd7ec1b67a15fa9c79ea0fd23db73bd7bca40a8ce', class: "search-result-row__title", part: "title" }, h("slot", { key: '8c4a45511580a655e0593c8c57fd98838f2cb896', name: "title" })), h("span", { key: '0d30a58a7079ea0c8992c9b0b02b516a65350425', class: "search-result-row__meta", part: "meta", hidden: !this.hasMeta }, h("slot", { key: '8de66e3b6adf89ed765ccc1c341ccac1b5513a6f', name: "meta", ref: (el) => (this.metaSlot = el), onSlotchange: this.syncSlots })), h("span", { key: '7c24542b9bb634a55530952c329242a351e813c3', class: "search-result-row__excerpt", part: "excerpt", hidden: !this.hasExcerpt }, h("slot", { key: 'a5bfc4fd17b8535aa996e792498b33f25dd30ecd', name: "excerpt", ref: (el) => (this.excerptSlot = el), onSlotchange: this.syncSlots }))), h("span", { key: '25c74d8508a0b3b527ef5529a02e54e407cae5ae', class: "search-result-row__trailing", part: "trailing", hidden: !this.hasTrailing }, h("slot", { key: 'cba6f957de902b9ed3dc05c8b20794c9b69c85c6', name: "trailing", ref: (el) => (this.trailingSlot = el), onSlotchange: this.syncSlots })))));
     }
     static get is() { return "ui-search-result-row"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-search-shell/ui-search-shell.js

@@ -23,7 +23,7 @@ export class UISearchShell {
         this.hasFooter = slotHasContent(this.footerSlot);
     };
     render() {
-        return (h("div", { key: '2a09e1ee81d04c0af5420887a9fa0dfb8057040c', class: "search-shell", part: "base" }, h("slot", { key: '9124af2e3e73b686a73b11c7fe8c9d40986e98c1', name: "backdrop" }), h("div", { key: 'cec39a8cbbfe99b7bbeb37ce32655a88cee2bec3', class: "search-shell__panel", part: "panel" }, h("div", { key: '8168eda720e031daf350800ac48dcf445be0c417', class: "search-shell__search", part: "search" }, h("slot", { key: 'b220c9670a6a53cd93fa434dc97dc9d2582bec08', name: "search" })), h("div", { key: '24386da67dd8ab5e865519e5b0b70fe9c8924010', class: "search-shell__status", part: "status", hidden: !this.hasStatus }, h("slot", { key: '7a0dfada13aca3275961667dadc9623729fbf644', name: "status", ref: (el) => (this.statusSlot = el), onSlotchange: this.syncSlots })), h("div", { key: 'e06b7da6219c7a71d69662c5bdcc24e6baa52aa9', class: "search-shell__body", part: "body" }, h("slot", { key: 'fabdea16cf443b57a826fc748b24342ff214b918', name: "body" })), h("div", { key: 'd38662a77f19fd59315b1882cda0a55680cc5a0b', class: "search-shell__footer", part: "footer", hidden: !this.hasFooter }, h("slot", { key: '56eb386e22ae033939cdbdf3c6b6edf68594ceb5', name: "footer", ref: (el) => (this.footerSlot = el), onSlotchange: this.syncSlots })))));
+        return (h("div", { key: 'c3a4366e1f22b249233e42fdc83f1620613cce52', class: "search-shell", part: "base" }, h("slot", { key: '4f22e4a44fe7ae190a80a6e5cd695c15eb4f029d', name: "backdrop" }), h("div", { key: 'bf452dae29f0ab31266d848a4dd4b794997b34a7', class: "search-shell__panel", part: "panel" }, h("div", { key: 'c0ef7d1d8ea95853404d39ddac1bff566d38d18e', class: "search-shell__search", part: "search" }, h("slot", { key: '462532250d8ba36aad1d31fe10da642d79e59faf', name: "search" })), h("div", { key: '4f7d91272d15f6e37df6fba4ae563efae5701b93', class: "search-shell__status", part: "status", hidden: !this.hasStatus }, h("slot", { key: 'd761691c1dd2c3012075163bb7eb9ce7e5bf3ef4', name: "status", ref: (el) => (this.statusSlot = el), onSlotchange: this.syncSlots })), h("div", { key: '1427a10b3f43ea31c2a482beb17f78d70b5fb2cf', class: "search-shell__body", part: "body" }, h("slot", { key: '6d6e8c2b4ee4833b5476795d4c7e184dda07f81e', name: "body" })), h("div", { key: '8f7d36040f7d21489c703b53581e392a2616963b', class: "search-shell__footer", part: "footer", hidden: !this.hasFooter }, h("slot", { key: '08b84f01091d95895ee8693e9b322511bf614342', name: "footer", ref: (el) => (this.footerSlot = el), onSlotchange: this.syncSlots })))));
     }
     static get is() { return "ui-search-shell"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-select/ui-select.js

@@ -72,7 +72,7 @@ export class UISelect {
         });
     };
     render() {
-        return (h(Host, { key: '5ac54353f467b70e94fce0ae661dc86c305befe7', "data-invalid": this.invalid ? '' : undefined }, h("slot", { key: '1386f3e4912720ab597f4567112e9c8b4166bcc6', ref: (el) => (this.slotRef = el) })));
+        return (h(Host, { key: '9a83a040bbad98355999c8099a78c6eba3ffc995', "data-invalid": this.invalid ? '' : undefined }, h("slot", { key: '4a70aa44651132899e283e45c32213cf3f00be24', ref: (el) => (this.slotRef = el) })));
     }
     static get is() { return "ui-select"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-switch/ui-switch.js

@@ -1,26 +1,30 @@
 import { Host, h } from "@stencil/core";
 import { dispatchDetail } from "../../utils/events";
+import { controlledOrDefault, isControlled } from "../../utils/controlled-state";
 export class UISwitch {
     host;
-    checked = false;
+    /** Controlled checked state. Omit it to use defaultChecked and local interaction state. */
+    checked;
     defaultChecked = false;
     disabled = false;
     required = false;
     value = 'on';
     internalChecked = false;
     syncFromProp() {
-        this.internalChecked = this.checked;
+        if (isControlled(this.checked))
+            this.internalChecked = this.checked;
     }
     componentDidLoad() {
-        this.syncFromProp();
-        this.internalChecked = this.internalChecked || this.defaultChecked;
+        this.internalChecked = controlledOrDefault(this.checked, this.defaultChecked);
     }
     toggle = (trigger) => {
         if (this.disabled)
             return;
-        this.internalChecked = !this.internalChecked;
+        const checked = !this.internalChecked;
+        if (!isControlled(this.checked))
+            this.internalChecked = checked;
         dispatchDetail(this.host, 'change', {
-            checked: this.internalChecked,
+            checked,
             value: this.value,
             trigger,
         });
@@ -37,14 +41,19 @@ export class UISwitch {
         this.toggle('pointer');
     };
     render() {
-        return (h(Host, { key: '14205d2856f8fb49b72d69d40f10ac1473a80c04', role: "switch", "aria-checked": String(this.internalChecked), "aria-disabled": String(this.disabled), "data-disabled": this.disabled ? '' : undefined, tabIndex: this.disabled ? -1 : 0, onKeyDown: this.onKeydown, onClick: this.onClick }, h("input", { key: '974f8e487c8bf9196c05420e1817139dd6b4138c', type: "checkbox", checked: this.internalChecked, disabled: this.disabled, required: this.required, value: this.value, "aria-hidden": "true", tabIndex: -1, onChange: (e) => {
-                this.internalChecked = e.target.checked;
+        return (h(Host, { key: 'e11500e37da6a52c0cb4e143254363f85911aac1', role: "switch", "aria-checked": String(this.internalChecked), "aria-disabled": String(this.disabled), "data-disabled": this.disabled ? '' : undefined, tabIndex: this.disabled ? -1 : 0, onKeyDown: this.onKeydown, onClick: this.onClick }, h("input", { key: '777310a90b66f67e6a8eb0f77da5274e32f10db0', type: "checkbox", checked: this.internalChecked, disabled: this.disabled, required: this.required, value: this.value, "aria-hidden": "true", tabIndex: -1, onChange: (e) => {
+                const input = e.target;
+                const checked = input.checked;
+                if (!isControlled(this.checked))
+                    this.internalChecked = checked;
                 dispatchDetail(this.host, 'change', {
-                    checked: this.internalChecked,
+                    checked,
                     value: this.value,
                     trigger: 'pointer',
                 });
-            } }), h("slot", { key: 'd1cd89aa2d5312cff8845364cdee64821977cb44' })));
+                if (isControlled(this.checked))
+                    input.checked = this.internalChecked;
+            } }), h("slot", { key: '7d72db5b720c0af0c4561b485ca558de61e1ce6e' })));
     }
     static get is() { return "ui-switch"; }
     static get encapsulation() { return "shadow"; }
@@ -69,16 +78,15 @@ export class UISwitch {
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Controlled checked state. Omit it to use defaultChecked and local interaction state."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "checked",
-                "defaultValue": "false"
+                "attribute": "checked"
             },
             "defaultChecked": {
                 "type": "boolean",

package/dist/collection/components/ui-tabs/ui-tabs.js

@@ -1,14 +1,17 @@
 import { Host, h } from "@stencil/core";
 import { eventToTrigger } from "../../utils/events";
 import { dispatchDetail } from "../../utils/events";
+import { controlledOrDefault, isControlled } from "../../utils/controlled-state";
 export class UITabs {
     host;
-    value = '';
+    /** Controlled selected tab value. Omit it to use defaultValue and local interaction state. */
+    value;
     defaultValue = '';
     orientation = 'horizontal';
     internalValue = '';
     syncFromProp() {
-        this.internalValue = this.value;
+        if (isControlled(this.value))
+            this.internalValue = this.value;
     }
     syncState() {
         const tabs = this.getTabs();
@@ -29,11 +32,8 @@ export class UITabs {
         });
     }
     componentDidLoad() {
-        this.syncFromProp();
-        if (!this.internalValue && this.defaultValue) {
-            this.internalValue = this.defaultValue;
-        }
-        if (!this.internalValue) {
+        this.internalValue = controlledOrDefault(this.value, this.defaultValue);
+        if (!isControlled(this.value) && !this.internalValue) {
             const tabs = this.getTabs();
             if (tabs.length > 0) {
                 this.internalValue = tabs[0]?.id ?? tabs[0]?.getAttribute('aria-controls') ?? '';
@@ -58,7 +58,8 @@ export class UITabs {
         if (!newValue)
             return;
         const prev = this.internalValue;
-        this.internalValue = newValue;
+        if (!isControlled(this.value))
+            this.internalValue = newValue;
         this.syncState();
         dispatchDetail(this.host, 'select', { value: newValue, previousValue: prev || undefined, trigger });
     }
@@ -91,7 +92,7 @@ export class UITabs {
         }
     };
     render() {
-        return (h(Host, { key: 'ca8671f06914de2bd6b412caf11e385d67ae722b', orientation: this.orientation, "data-orientation": this.orientation }, h("slot", { key: '49beb3783c8f6a330d25164c82933c2bf6345b1e' })));
+        return (h(Host, { key: '8681e699c6afdbafd59ed986b8bf3c815b32cd1c', orientation: this.orientation, "data-orientation": this.orientation }, h("slot", { key: '673f4db2ae0aded3bd40934c1fff518cf6f83837' })));
     }
     static get is() { return "ui-tabs"; }
     static get encapsulation() { return "shadow"; }
@@ -116,16 +117,15 @@ export class UITabs {
                     "references": {}
                 },
                 "required": false,
-                "optional": false,
+                "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Controlled selected tab value. Omit it to use defaultValue and local interaction state."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": false,
-                "attribute": "value",
-                "defaultValue": "''"
+                "attribute": "value"
             },
             "defaultValue": {
                 "type": "string",

package/dist/collection/components/ui-textarea/ui-textarea.js

@@ -71,7 +71,7 @@ export class UITextarea {
         });
     };
     render() {
-        return (h(Host, { key: '9ccc0464bca55b3364645ea90df3890f9ed9d697', "data-invalid": this.invalid ? '' : undefined }, h("slot", { key: '81c4df31064d4dcd2b2e27dfcf3141cc9f18f54e', ref: (el) => (this.slotRef = el) })));
+        return (h(Host, { key: '6ce80349ca316f7a44d08e83862125f6b4d736a6', "data-invalid": this.invalid ? '' : undefined }, h("slot", { key: '2c1ce87c9019d8346673ae5e7dd8a543d1bcb91c', ref: (el) => (this.slotRef = el) })));
     }
     static get is() { return "ui-textarea"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/ui-toast-region/ui-toast-region.js

@@ -5,10 +5,12 @@ import { createViewportSurface } from "../../overlay/positioning";
 export class UIToastRegion {
     host;
     open = true;
-    internalOpen = true;
+    internalOpen = false;
     surface = null;
+    contentObserver = null;
+    pendingDismiss = null;
     syncFromProp() {
-        this.internalOpen = this.open;
+        this.syncContents();
     }
     syncSurface() {
         if (this.internalOpen)
@@ -18,22 +20,39 @@ export class UIToastRegion {
     }
     componentDidLoad() {
         this.surface = createViewportSurface(this.host);
-        this.syncFromProp();
+        this.contentObserver = new MutationObserver(this.syncContents);
+        this.contentObserver.observe(this.host, { childList: true, subtree: true });
+        this.syncContents();
         this.syncSurface();
         this.host.addEventListener('click', this.onClick);
     }
     disconnectedCallback() {
         this.host.removeEventListener('click', this.onClick);
+        this.contentObserver?.disconnect();
+        this.contentObserver = null;
         this.surface?.destroy();
         this.surface = null;
     }
     getToasts() {
         return Array.from(this.host.querySelectorAll('[data-ui-toast]'));
     }
-    updateOpenState() {
-        const toasts = this.getToasts();
-        this.internalOpen = toasts.length > 0;
-    }
+    syncContents = () => {
+        const nextOpen = this.open && this.getToasts().length > 0;
+        const wasOpen = this.internalOpen;
+        const completedDismiss = this.pendingDismiss && !this.host.contains(this.pendingDismiss.toast)
+            ? this.pendingDismiss
+            : null;
+        this.internalOpen = nextOpen;
+        if (wasOpen && !nextOpen && completedDismiss) {
+            dispatchDetail(this.host, 'close', {
+                open: false,
+                reason: 'action',
+                trigger: completedDismiss.trigger,
+            });
+        }
+        if (completedDismiss || !this.open)
+            this.pendingDismiss = null;
+    };
     onClick = (e) => {
         const dismissBtn = e.target.closest?.('[data-ui-toast-dismiss]');
         if (!dismissBtn)
@@ -42,24 +61,16 @@ export class UIToastRegion {
         if (!toast)
             return;
         const id = toast.id ?? '';
-        toast.setAttribute('aria-hidden', 'true');
-        toast.remove();
+        const trigger = eventToTrigger(e);
+        this.pendingDismiss = { toast: toast, trigger };
         dispatchDetail(this.host, 'dismiss', {
             id,
             reason: 'action',
-            trigger: eventToTrigger(e),
+            trigger,
         });
-        this.updateOpenState();
-        if (this.getToasts().length === 0) {
-            dispatchDetail(this.host, 'close', {
-                open: false,
-                reason: 'action',
-                trigger: eventToTrigger(e),
-            });
-        }
     };
     render() {
-        return (h(Host, { key: '9ec1cc51ecc4e7a256be5d89a09a10788e46db53', role: "region", "aria-label": "Notifications", "data-open": this.internalOpen ? '' : undefined }, h("slot", { key: '7b08656f3745a02f8e9f0935e47d6f2cffd88f9b' })));
+        return (h(Host, { key: 'b4430aceacb7a66202c6a43ad7b0bbe31c51eb94', role: "region", "aria-label": "Notifications", "aria-live": "polite", "data-open": this.internalOpen ? '' : undefined }, h("slot", { key: '8bfb02d38366fab29a1668a53b7834ccd1a9aa65' })));
     }
     static get is() { return "ui-toast-region"; }
     static get encapsulation() { return "shadow"; }