@sekiui/elements 0.1.2 → 0.1.4

package/dist/collection/utils/label-association.js

@@ -0,0 +1,199 @@
+/**
+ * Label association for `seki-label` and `seki-field-label`.
+ *
+ * ## Why this exists
+ *
+ * Both labels render their text inside a shadow root. A native `<label for>`
+ * resolves its `for` id inside the tree the `<label>` lives in, so a `<label>`
+ * in our shadow root can never reach a control in the page's light DOM: clicks
+ * did nothing and the control had no accessible name (#329).
+ *
+ * The host element (`<seki-label>`) *does* live in the consumer's tree, so the
+ * wiring is done from the host in script, resolving the id against
+ * `host.getRootNode()` (the label's own root, which is where an author expects
+ * `for` to point, also when the label sits inside another component's shadow
+ * root together with its control).
+ *
+ * ## Behaviour
+ *
+ * - **Activation**: a click on the label forwards to the target the way a native
+ *   label would. Toggles (checkbox, switch, radio) are clicked, text-like
+ *   controls are focused. A click that originated on the control itself (the
+ *   wrapping form `<seki-label><seki-checkbox/> Text</seki-label>`) is ignored so
+ *   the control never toggles twice.
+ * - **Accessible name**: a shadow-DOM control hides its real focusable element
+ *   (`<button role="checkbox">`, `<input>`, ...) inside its own shadow root, and
+ *   an `aria-labelledby` id reference cannot cross a shadow boundary, so
+ *   pointing the host at the label would not name the inner element. SekiUI
+ *   controls all forward their `aria-label` attribute to that inner element, so
+ *   for them the label text is passed through as `aria-label`. For native
+ *   elements the reference does resolve, so we use `aria-labelledby` and the
+ *   name tracks the label's live content.
+ *   Anything the author set explicitly (`aria-label`, `aria-labelledby`) is
+ *   never overwritten; we only manage values we wrote ourselves, tracked with a
+ *   marker attribute so they can be updated and cleaned up.
+ *   `ElementInternals.ariaLabelledByElements` is deliberately not used: it is
+ *   unavailable in Firefox and older Safari, and cannot reach the inner element
+ *   of a shadow-DOM control either.
+ */
+/* global Document */
+const MANAGED_ATTR = 'data-seki-label-managed';
+/** SekiUI form controls that render their focusable element in a shadow root. */
+const SEKI_CONTROLS = [
+    'seki-input',
+    'seki-textarea',
+    'seki-checkbox',
+    'seki-switch',
+    'seki-select',
+    'seki-slider',
+    'seki-radio-group',
+    'seki-input-otp',
+    'seki-date-picker',
+    'seki-combobox',
+].join(',');
+const NATIVE_CONTROLS = 'input:not([type="hidden"]), select, textarea, button';
+let uid = 0;
+function focusInside(target) {
+    var _a, _b, _c;
+    const inner = (_a = target.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector('input:not([disabled]), textarea:not([disabled]), button:not([disabled]), [tabindex="0"]');
+    (_c = (_b = (inner !== null && inner !== void 0 ? inner : target)).focus) === null || _c === void 0 ? void 0 : _c.call(_b);
+}
+export class LabelBinding {
+    constructor(host, getFor) {
+        this.host = host;
+        this.getFor = getFor;
+        this.target = null;
+    }
+    /** Resolve the control this label is for, in the label's own root. */
+    resolveTarget() {
+        var _a, _b, _c;
+        const id = this.getFor();
+        if (id) {
+            const root = this.host.getRootNode();
+            return (_b = (_a = root.getElementById) === null || _a === void 0 ? void 0 : _a.call(root, id)) !== null && _b !== void 0 ? _b : null;
+        }
+        const controls = `${SEKI_CONTROLS}, ${NATIVE_CONTROLS}`;
+        // Implicit association: <seki-label><seki-checkbox></seki-checkbox> Text</seki-label>
+        const nested = this.host.querySelector(controls);
+        if (nested)
+            return nested;
+        // Inside <seki-field>, a label without `for` names the field's control.
+        if (this.host.getAttribute('slot') === 'label') {
+            const field = this.host.closest('seki-field');
+            return (_c = field === null || field === void 0 ? void 0 : field.querySelector(`:scope > :not([slot]):is(${controls})`)) !== null && _c !== void 0 ? _c : null;
+        }
+        return null;
+    }
+    /** Label text, without the text of a control nested inside the label. */
+    labelText(skip) {
+        const parts = [];
+        const walk = (node) => {
+            var _a;
+            if (node === skip)
+                return;
+            if (node.nodeType === Node.TEXT_NODE)
+                parts.push((_a = node.textContent) !== null && _a !== void 0 ? _a : '');
+            else
+                node.childNodes.forEach(walk);
+        };
+        this.host.childNodes.forEach(walk);
+        return parts.join(' ').replace(/\s+/g, ' ').trim();
+    }
+    /** (Re)apply the accessible name. Call on load, `for` change and slot change. */
+    sync() {
+        const next = this.resolveTarget();
+        if (next !== this.target) {
+            this.release();
+            this.target = next;
+        }
+        const target = this.target;
+        if (!target)
+            return;
+        const managed = target.getAttribute(MANAGED_ATTR);
+        const authored = (name) => target.hasAttribute(name) && managed !== name;
+        if (target.tagName.includes('-')) {
+            if (authored('aria-label'))
+                return;
+            const text = this.labelText(this.host.contains(target) ? target : null);
+            if (text) {
+                target.setAttribute('aria-label', text);
+                target.setAttribute(MANAGED_ATTR, 'aria-label');
+            }
+            return;
+        }
+        if (authored('aria-labelledby') || authored('aria-label'))
+            return;
+        if (!this.host.id)
+            this.host.id = `seki-label-${++uid}`;
+        target.setAttribute('aria-labelledby', this.host.id);
+        target.setAttribute(MANAGED_ATTR, 'aria-labelledby');
+    }
+    /** Remove anything this binding wrote on the current target. */
+    release() {
+        const target = this.target;
+        const managed = target === null || target === void 0 ? void 0 : target.getAttribute(MANAGED_ATTR);
+        if (target && managed) {
+            target.removeAttribute(managed);
+            target.removeAttribute(MANAGED_ATTR);
+        }
+        this.target = null;
+    }
+    /** Re-sync when the control is added after the label (async rendering). */
+    observe() {
+        if (this.observer || typeof MutationObserver === 'undefined')
+            return;
+        this.observer = new MutationObserver(() => {
+            if (this.resolveTarget() !== this.target)
+                this.sync();
+        });
+        this.observer.observe(this.host.getRootNode(), { childList: true, subtree: true });
+    }
+    disconnect() {
+        var _a;
+        (_a = this.observer) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.observer = undefined;
+        this.release();
+    }
+    /** Forward a click on the label to its control, as a native label would. */
+    handleClick(event) {
+        var _a, _b;
+        if (event.defaultPrevented)
+            return;
+        const target = this.resolveTarget();
+        if (!target)
+            return;
+        const path = event.composedPath();
+        // The click came from the control itself: it already handled it.
+        if (path.includes(target))
+            return;
+        // Don't hijack clicks on other interactive content placed inside the label.
+        for (const node of path) {
+            if (node === this.host)
+                break;
+            if (node instanceof HTMLElement && node.matches('a[href], button, input, select, textarea'))
+                return;
+        }
+        if (target.hasAttribute('disabled') || target.getAttribute('aria-disabled') === 'true')
+            return;
+        const toggle = (_a = target.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector('[role="checkbox"], [role="switch"]');
+        if (toggle) {
+            toggle.focus();
+            toggle.click();
+            return;
+        }
+        if (target instanceof HTMLInputElement &&
+            ['checkbox', 'radio', 'button', 'submit', 'reset'].includes(target.type)) {
+            target.focus();
+            target.click();
+            return;
+        }
+        if (target instanceof HTMLButtonElement) {
+            target.click();
+            return;
+        }
+        if (target.shadowRoot)
+            focusInside(target);
+        else
+            (_b = target.focus) === null || _b === void 0 ? void 0 : _b.call(target);
+    }
+}

package/dist/collection/utils/menu-navigation.js

@@ -0,0 +1,155 @@
+/**
+ * Shared keyboard navigation for menu-like content (dropdown-menu,
+ * context-menu, menubar).
+ *
+ * Menu items are *slotted light-DOM children* of the `*-content` host, so they
+ * must be collected from the host (`el.querySelectorAll`), never from a node
+ * inside the content's own shadow root (#322). Each item renders its focus
+ * target (`[role^="menuitem"]`) in its own shadow root, so focusing an item
+ * means focusing that inner element, not the host.
+ */
+/** Roles of the focus target an item renders in its shadow root. */
+const FOCUS_TARGET = '[role^="menuitem"]';
+function isDisabled(el) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return el.hasAttribute('disabled') || el.disabled === true;
+}
+/** Nearest submenu container of an item, or null for top-level items. */
+function scopeOf(el, cfg) {
+    return el.closest(cfg.subContentSelector);
+}
+/** All item hosts under `root` (any scope), including disabled ones. */
+function allItems(root, cfg) {
+    return Array.from(root.querySelectorAll(cfg.itemSelector));
+}
+/** Enabled items under `root` that share the given submenu scope. */
+export function getMenuItems(root, cfg, scope = null) {
+    return allItems(root, cfg).filter((el) => !isDisabled(el) && scopeOf(el, cfg) === scope);
+}
+/** Focus an item by focusing its inner `[role=menuitem*]` element. */
+export function focusMenuItem(item) {
+    var _a, _b;
+    if (!item)
+        return;
+    const target = (_b = (_a = item.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(FOCUS_TARGET)) !== null && _b !== void 0 ? _b : item;
+    target.focus();
+}
+/**
+ * Focus an item, retrying for a few frames until it is actually focused. A
+ * submenu's content only renders its slot once it is open, so the items are
+ * not focusable on the very frame the open was requested.
+ */
+export function focusMenuItemWhenReady(item, framesLeft = 10) {
+    var _a, _b;
+    if (!item)
+        return;
+    focusMenuItem(item);
+    const target = (_b = (_a = item.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelector(FOCUS_TARGET)) !== null && _b !== void 0 ? _b : item;
+    if (framesLeft > 0 && getDeepActiveElement() !== target) {
+        requestAnimationFrame(() => focusMenuItemWhenReady(item, framesLeft - 1));
+    }
+}
+/**
+ * Focus the first enabled top-level item. Waits for the item to be upgraded
+ * and rendered (and for the content's slot to render) first, so it works when tags are defined one at a time (#314).
+ */
+export async function focusFirstMenuItem(root, cfg) {
+    const first = getMenuItems(root, cfg)[0];
+    if (!first)
+        return;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const ready = first.componentOnReady;
+    if (typeof ready === 'function') {
+        try {
+            await ready.call(first);
+        }
+        catch (_a) {
+            /* fall through and focus whatever is there */
+        }
+    }
+    focusMenuItemWhenReady(first);
+}
+/** Deepest focused element, looking through shadow roots. */
+export function getDeepActiveElement() {
+    var _a, _b;
+    let active = document.activeElement;
+    while ((_a = active === null || active === void 0 ? void 0 : active.shadowRoot) === null || _a === void 0 ? void 0 : _a.activeElement) {
+        active = active.shadowRoot.activeElement;
+    }
+    return (_b = active) !== null && _b !== void 0 ? _b : null;
+}
+/** True when `node` is `ancestor` or a descendant of it, crossing shadow boundaries. */
+export function composedContains(ancestor, node) {
+    var _a, _b;
+    let current = node;
+    while (current) {
+        if (current === ancestor)
+            return true;
+        current = (_b = (_a = current.parentNode) !== null && _a !== void 0 ? _a : current.host) !== null && _b !== void 0 ? _b : null;
+    }
+    return false;
+}
+export function clearTypeahead(state) {
+    if (state.timer)
+        clearTimeout(state.timer);
+    state.timer = undefined;
+    state.buffer = '';
+}
+/**
+ * Handle ArrowDown / ArrowUp / Home / End / type-ahead for a menu. The current
+ * item is derived from the event itself, so mouse hover, click and Tab focus
+ * can never put a "focused index" out of sync with the DOM.
+ *
+ * Enter / Space are intentionally NOT handled here: every item activates
+ * itself from its own keydown handler, and doing it twice would select twice.
+ */
+export function handleMenuKeyDown(event, root, cfg, typeahead) {
+    var _a;
+    const everyItem = allItems(root, cfg);
+    const target = (_a = event.composedPath().find((n) => n instanceof HTMLElement && everyItem.includes(n))) !== null && _a !== void 0 ? _a : null;
+    const scope = target ? scopeOf(target, cfg) : null;
+    const items = getMenuItems(root, cfg, scope);
+    const result = { target, inSubmenu: scope !== null, handled: false };
+    if (event.altKey || event.ctrlKey || event.metaKey || items.length === 0)
+        return result;
+    const current = target ? items.indexOf(target) : -1;
+    let next = -1;
+    switch (event.key) {
+        case 'ArrowDown':
+            next = current < 0 ? 0 : (current + 1) % items.length;
+            break;
+        case 'ArrowUp':
+            next = current <= 0 ? items.length - 1 : current - 1;
+            break;
+        case 'Home':
+            next = 0;
+            break;
+        case 'End':
+            next = items.length - 1;
+            break;
+        default: {
+            if (event.key.length !== 1 || event.key === ' ')
+                return result;
+            if (typeahead.timer)
+                clearTimeout(typeahead.timer);
+            typeahead.buffer += event.key.toLowerCase();
+            typeahead.timer = setTimeout(() => clearTypeahead(typeahead), 500);
+            // Typing one character repeatedly cycles through the items starting with it.
+            const repeated = typeahead.buffer.length > 1 && typeahead.buffer.split('').every((c) => c === typeahead.buffer[0]);
+            const needle = repeated ? typeahead.buffer[0] : typeahead.buffer;
+            const start = typeahead.buffer.length === 1 || repeated ? current + 1 : Math.max(current, 0);
+            const ordered = [...items.slice(start), ...items.slice(0, start)];
+            const hit = ordered.find((el) => { var _a; return ((_a = el.textContent) !== null && _a !== void 0 ? _a : '').trim().toLowerCase().startsWith(needle); });
+            result.handled = true;
+            if (hit) {
+                event.preventDefault();
+                focusMenuItem(hit);
+            }
+            return result;
+        }
+    }
+    event.preventDefault();
+    focusMenuItem(items[next]);
+    result.handled = true;
+    return result;
+}

package/dist/components/index.js

@@ -1,7 +1,7 @@
 import { g as globalScripts } from './p-jMliCqbB.js';
 export { a as getAssetPath, r as render, s as setAssetPath, b as setNonce, c as setPlatformOptions } from './p-jMliCqbB.js';
-export { S as SekiSwitch } from './p-Bj7FnVct.js';
-export { S as SekiLabel } from './p-DZc1uUPr.js';
+export { S as SekiSwitch } from './p-Dh9pvFzL.js';
+export { S as SekiLabel } from './p-C3WFySZp.js';
 export { a as SekiSonner, S as SekiSonnerElement } from './p-D4LyQFQp.js';
 
 /**

package/dist/components/{p-DSgc4lp9.js → p--1ROPZet.js}

@@ -1,5 +1,6 @@
 import { p as proxyCustomElement, H, d as createEvent, h, e as Host } from './p-jMliCqbB.js';
 import { l as lockBodyScroll, u as unlockBodyScroll } from './p-D50kwTtW.js';
+import { p as publishContext } from './p-B4SOpX_A.js';
 
 const sekiDialogCss = ":host{--seki-neutral-50:hsl(0, 0%, 98%);--seki-neutral-100:hsl(0, 0%, 96.1%);--seki-neutral-200:hsl(0, 0%, 89.8%);--seki-neutral-300:hsl(0, 0%, 83.1%);--seki-neutral-400:hsl(0, 0%, 63.9%);--seki-neutral-500:hsl(0, 0%, 45.1%);--seki-neutral-600:hsl(0, 0%, 32.2%);--seki-neutral-700:hsl(0, 0%, 25.1%);--seki-neutral-800:hsl(0, 0%, 14.9%);--seki-neutral-900:hsl(0, 0%, 9%);--seki-neutral-950:hsl(0, 0%, 3.9%);--seki-primary-50:hsl(210, 100%, 97%);--seki-primary-100:hsl(210, 95%, 93%);--seki-primary-200:hsl(210, 95%, 85%);--seki-primary-300:hsl(210, 90%, 73%);--seki-primary-400:hsl(210, 85%, 58%);--seki-primary-500:hsl(210, 80%, 48%);--seki-primary-600:hsl(210, 75%, 40%);--seki-primary-700:hsl(210, 70%, 32%);--seki-primary-800:hsl(210, 65%, 25%);--seki-primary-900:hsl(210, 60%, 18%);--seki-primary-950:hsl(210, 55%, 10%);--seki-success-500:hsl(142, 71%, 45%);--seki-success-600:hsl(142, 71%, 35%);--seki-warning-500:hsl(38, 92%, 50%);--seki-warning-600:hsl(38, 92%, 40%);--seki-destructive-500:hsl(0, 84.2%, 60.2%);--seki-destructive-600:hsl(0, 72%, 41%);--seki-chart-1:hsl(12, 76%, 61%);--seki-chart-2:hsl(173, 58%, 39%);--seki-chart-3:hsl(197, 37%, 24%);--seki-chart-4:hsl(43, 74%, 66%);--seki-chart-5:hsl(27, 87%, 67%)}:host([data-theme='dark']){color-scheme:dark}:host([data-theme='light']){color-scheme:light}:host{--seki-background:light-dark(hsl(0, 0%, 100%), hsl(0, 0%, 3.9%));--seki-foreground:light-dark(hsl(0, 0%, 3.9%), hsl(0, 0%, 98%));--seki-muted:light-dark(hsl(0, 0%, 96.1%), hsl(0, 0%, 14.9%));--seki-muted-foreground:light-dark(hsl(0, 0%, 42%), hsl(0, 0%, 63.9%));--seki-card:light-dark(hsl(0, 0%, 100%), hsl(0, 0%, 3.9%));--seki-card-foreground:light-dark(hsl(0, 0%, 3.9%), hsl(0, 0%, 98%));--seki-popover:light-dark(hsl(0, 0%, 100%), hsl(0, 0%, 3.9%));--seki-popover-foreground:light-dark(hsl(0, 0%, 3.9%), hsl(0, 0%, 98%));--seki-border:light-dark(hsl(0, 0%, 89.8%), hsl(0, 0%, 14.9%));--seki-input:light-dark(hsl(0, 0%, 89.8%), hsl(0, 0%, 14.9%));--seki-primary:light-dark(hsl(0, 0%, 9%), hsl(0, 0%, 98%));--seki-primary-foreground:light-dark(hsl(0, 0%, 98%), hsl(0, 0%, 9%));--seki-primary-tint:light-dark(hsl(0, 0%, 9%, 0.06), hsl(0, 0%, 98%, 0.1));--seki-primary-tint-foreground:var(--seki-foreground);--seki-secondary:light-dark(hsl(0, 0%, 96.1%), hsl(0, 0%, 14.9%));--seki-secondary-foreground:light-dark(hsl(0, 0%, 9%), hsl(0, 0%, 98%));--seki-accent:light-dark(hsl(0, 0%, 96.1%), hsl(0, 0%, 14.9%));--seki-accent-foreground:light-dark(hsl(0, 0%, 9%), hsl(0, 0%, 98%));--seki-destructive:light-dark(hsl(0, 84.2%, 60.2%), hsl(0, 62.8%, 30.6%));--seki-destructive-foreground:hsl(0, 0%, 98%);--seki-destructive-bg:light-dark(hsl(0, 86%, 97%), rgba(239, 68, 68, 0.1));--seki-destructive-soft-foreground:light-dark(hsl(0, 63%, 31%), hsl(0, 91%, 71%));--seki-success:light-dark(hsl(142, 71%, 45%), hsl(142, 69%, 58%));--seki-success-foreground:light-dark(hsl(142, 64%, 24%), hsl(142, 69%, 58%));--seki-success-bg:light-dark(hsl(142, 76%, 97%), rgba(34, 197, 94, 0.1));--seki-warning:light-dark(hsl(38, 92%, 50%), hsl(43, 96%, 56%));--seki-warning-foreground:light-dark(hsl(21, 77%, 27%), hsl(43, 96%, 56%));--seki-warning-bg:light-dark(hsl(48, 96%, 96%), rgba(245, 158, 11, 0.1));--seki-info:light-dark(hsl(217, 91%, 60%), hsl(217, 92%, 68%));--seki-info-foreground:light-dark(hsl(224, 64%, 33%), hsl(217, 92%, 68%));--seki-info-bg:light-dark(hsl(214, 100%, 97%), rgba(59, 130, 246, 0.1));--seki-ring:light-dark(hsl(0, 0%, 3.9%), hsl(0, 0%, 83.1%));--seki-ring-shadow:hsl(0, 0%, 3.9%, 0.1);--seki-bg-primary:var(--seki-background);--seki-bg-secondary:var(--seki-muted);--seki-bg-tertiary:var(--seki-accent);--seki-text-primary:var(--seki-foreground);--seki-text-secondary:var(--seki-muted-foreground);--seki-text-tertiary:light-dark(var(--seki-neutral-400), var(--seki-neutral-600));--seki-border-default:var(--seki-border);--seki-border-emphasis:light-dark(var(--seki-neutral-300), var(--seki-neutral-700))}:host{--seki-button-primary-bg:var(--seki-primary);--seki-button-primary-text:var(--seki-primary-foreground);--seki-button-primary-border:transparent;--seki-button-primary-hover-bg:light-dark(hsl(0, 0%, 9%, 0.9), hsl(0, 0%, 98%, 0.9));--seki-button-primary-hover-text:var(--seki-primary-foreground);--seki-button-primary-hover-border:transparent;--seki-button-secondary-bg:var(--seki-secondary);--seki-button-secondary-text:var(--seki-secondary-foreground);--seki-button-secondary-border:transparent;--seki-button-secondary-hover-bg:light-dark(hsl(0, 0%, 96.1%, 0.8), hsl(0, 0%, 14.9%, 0.8));--seki-button-secondary-hover-text:var(--seki-secondary-foreground);--seki-button-secondary-hover-border:transparent;--seki-button-outline-bg:transparent;--seki-button-outline-text:var(--seki-foreground);--seki-button-outline-border:var(--seki-input);--seki-button-outline-hover-bg:var(--seki-accent);--seki-button-outline-hover-text:var(--seki-accent-foreground);--seki-button-outline-hover-border:var(--seki-input);--seki-button-ghost-bg:transparent;--seki-button-ghost-text:var(--seki-foreground);--seki-button-ghost-border:transparent;--seki-button-ghost-hover-bg:var(--seki-accent);--seki-button-ghost-hover-text:var(--seki-accent-foreground);--seki-button-ghost-hover-border:transparent;--seki-button-destructive-bg:var(--seki-destructive);--seki-button-destructive-text:var(--seki-destructive-foreground);--seki-button-destructive-border:transparent;--seki-button-destructive-hover-bg:hsl(0, 84.2%, 60.2%, 0.9);--seki-button-destructive-hover-border:transparent;--seki-button-sm-padding-x:var(--seki-spacing-3, 0.75rem);--seki-button-sm-padding-y:0.375rem;--seki-button-sm-font-size:var(--seki-text-sm, 0.875rem);--seki-button-sm-height:2.25rem;--seki-button-md-padding-x:var(--seki-spacing-4, 1rem);--seki-button-md-padding-y:var(--seki-spacing-2, 0.5rem);--seki-button-md-font-size:var(--seki-text-base, 1rem);--seki-button-md-height:2.5rem;--seki-button-lg-padding-x:2rem;--seki-button-lg-padding-y:0.5rem;--seki-button-lg-font-size:1rem;--seki-button-lg-height:2.75rem;--seki-button-icon-sm-size:2rem;--seki-button-icon-size:2.5rem;--seki-button-icon-lg-size:3rem;--seki-button-icon-gap:0.5rem;--seki-button-link-bg:transparent;--seki-button-link-text:var(--seki-primary);--seki-button-link-border:transparent;--seki-button-link-hover-bg:transparent;--seki-button-link-hover-text:var(--seki-primary);--seki-button-link-hover-border:transparent;--seki-button-radius:var(--seki-radius-md, 0.375rem);--seki-button-font-weight:var(--seki-font-medium, 500);--seki-button-transition-duration:150ms;--seki-button-transition-timing:ease-in-out;--seki-button-shadow:var(--seki-shadow-sm, 0 1px 2px 0 rgb(0 0 0 / 0.05));--seki-button-shadow-hover:var(--seki-shadow-md, 0 4px 6px -1px rgb(0 0 0 / 0.1));--seki-button-disabled-opacity:0.5;--seki-input-bg:var(--seki-background);--seki-input-border:var(--seki-border);--seki-input-text:var(--seki-foreground);--seki-input-placeholder:var(--seki-muted-foreground);--seki-input-ring:var(--seki-ring);--seki-input-invalid-border:var(--seki-destructive);--seki-input-invalid-ring:var(--seki-destructive);--seki-input-disabled-opacity:0.5;--seki-input-radius:var(--seki-radius-md);--seki-input-ring-offset:2px;--seki-select-trigger-bg:var(--seki-background);--seki-select-trigger-border:1px solid var(--seki-border);--seki-select-trigger-bg-hover:var(--seki-muted);--seki-select-trigger-radius:var(--seki-radius-md);--seki-select-trigger-min-height:2.5rem;--seki-select-trigger-padding:0.5rem 0.75rem;--seki-select-trigger-gap:0.5rem;--seki-select-content-bg:var(--seki-popover);--seki-select-content-border:1px solid var(--seki-border);--seki-select-content-shadow:0 10px 15px -3px rgb(0 0 0 / 0.1);--seki-select-content-radius:var(--seki-radius-md);--seki-select-content-padding:0.5rem 0;--seki-select-option-padding:0.5rem 0.75rem;--seki-select-option-gap:0.5rem;--seki-select-option-radius:var(--seki-radius-sm);--seki-select-option-bg-hover:var(--seki-muted);--seki-select-option-bg-selected:var(--seki-muted);--seki-select-group-label-padding:0.5rem 0.75rem;--seki-select-group-label-font-size:var(--seki-font-size-xs);--seki-select-group-label-font-weight:var(--seki-font-semibold);--seki-select-group-label-color:var(--seki-muted-foreground);--seki-select-group-separator:1px solid var(--seki-border)}:host{--seki-spacing-0:0;--seki-spacing-0-5:0.125rem;--seki-spacing-1:0.25rem;--seki-spacing-1-5:0.375rem;--seki-spacing-2:0.5rem;--seki-spacing-2-5:0.625rem;--seki-spacing-3:0.75rem;--seki-spacing-3-5:0.875rem;--seki-spacing-4:1rem;--seki-spacing-5:1.25rem;--seki-spacing-6:1.5rem;--seki-spacing-8:2rem;--seki-spacing-10:2.5rem;--seki-spacing-12:3rem;--seki-spacing-16:4rem;--seki-spacing-20:5rem;--seki-spacing-24:6rem;--seki-input-height-sm:2rem;--seki-input-height-md:2.5rem;--seki-input-height-lg:3rem;--seki-input-padding-x:0.75rem;--seki-input-padding-y:0.5rem;--seki-input-font-size:0.875rem;--seki-input-ring-offset:2px}:host{--seki-shadow-sm:0 1px 2px 0 rgb(0 0 0 / 0.05);--seki-shadow-md:0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1);--seki-shadow-lg:0 10px 15px -3px rgb(0 0 0 / 0.15), 0 4px 6px -4px rgb(0 0 0 / 0.1);--seki-shadow-xl:0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)}:host{--seki-font-sans:-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue',\n    Arial, sans-serif;--seki-font-mono:ui-monospace, SFMono-Regular, 'SF Mono', Menlo, Consolas, monospace;--seki-text-xs:0.75rem;--seki-text-sm:0.875rem;--seki-text-base:1rem;--seki-text-lg:1.125rem;--seki-text-xl:1.25rem;--seki-text-2xl:1.5rem;--seki-text-3xl:1.875rem;--seki-text-4xl:2.25rem;--seki-font-normal:400;--seki-font-medium:500;--seki-font-semibold:600;--seki-font-bold:700;--seki-leading-none:1;--seki-leading-tight:1.25;--seki-leading-normal:1.5;--seki-leading-relaxed:1.75}:host{--seki-radius-sm:0.25rem;--seki-radius-md:0.375rem;--seki-radius-lg:0.5rem;--seki-radius-xl:1rem;--seki-radius-full:9999px;}:host{--seki-sidebar-width:16rem;--seki-sidebar-width-icon:3rem;--seki-sidebar-width-mobile:18rem;--seki-sidebar-background:light-dark(hsl(0, 0%, 98%), hsl(240, 5.9%, 10%));--seki-sidebar-foreground:light-dark(hsl(240, 5.3%, 26.1%), hsl(240, 4.8%, 95.9%));--seki-sidebar-primary:light-dark(hsl(240, 5.9%, 10%), hsl(0, 0%, 98%));--seki-sidebar-primary-foreground:light-dark(hsl(0, 0%, 98%), hsl(240, 5.9%, 10%));--seki-sidebar-accent:light-dark(hsl(240, 4.8%, 95.9%), hsl(240, 3.7%, 15.9%));--seki-sidebar-accent-foreground:light-dark(hsl(240, 5.9%, 10%), hsl(240, 4.8%, 95.9%));--seki-sidebar-border:light-dark(hsl(220, 13%, 91%), hsl(240, 3.7%, 15.9%));--seki-sidebar-ring:hsl(217.2, 91.2%, 59.8%);--seki-sidebar-muted-foreground:light-dark(hsl(240, 3.8%, 46.1%), hsl(240, 5%, 64.9%));--seki-sidebar-menu-button-height:2rem;--seki-sidebar-menu-button-height-lg:3rem;--seki-sidebar-menu-button-padding:0.5rem;--seki-sidebar-menu-button-gap:0.5rem;--seki-sidebar-menu-button-radius:var(--seki-radius-md, 0.375rem);--seki-sidebar-menu-sub-padding-left:1.75rem;--seki-sidebar-menu-sub-border-width:1px;--seki-sidebar-group-padding:0.5rem;--seki-sidebar-group-label-height:2rem;--seki-sidebar-group-label-padding:0.5rem;--seki-sidebar-header-height:auto;--seki-sidebar-footer-height:auto;--seki-sidebar-header-padding:0.5rem;--seki-sidebar-footer-padding:0.5rem;--seki-sidebar-content-padding:0.5rem;--seki-sidebar-rail-width:1rem;--seki-sidebar-transition-duration:200ms;--seki-sidebar-transition-timing:ease-in-out;--seki-sidebar-mobile-breakpoint:768px;--seki-sidebar-overlay-bg:hsla(0, 0%, 0%, 0.8)}:host{--seki-animation-fast:150ms;--seki-animation-normal:200ms;--seki-animation-slow:300ms;--seki-ease-in:cubic-bezier(0.4, 0, 1, 1);--seki-ease-out:cubic-bezier(0, 0, 0.2, 1);--seki-ease-in-out:cubic-bezier(0.4, 0, 0.2, 1);--seki-accordion-content-height:auto}@keyframes seki-fade-in{from{opacity:0}to{opacity:1}}@keyframes seki-fade-out{from{opacity:1}to{opacity:0}}@keyframes seki-scale-in{from{opacity:0;transform:scale(0.95)}to{opacity:1;transform:scale(1)}}@keyframes seki-scale-out{from{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0.95)}}@keyframes seki-slide-in-from-top{from{transform:translateY(-100%)}to{transform:translateY(0)}}@keyframes seki-slide-out-to-top{from{transform:translateY(0)}to{transform:translateY(-100%)}}@keyframes seki-slide-in-from-bottom{from{transform:translateY(100%)}to{transform:translateY(0)}}@keyframes seki-slide-out-to-bottom{from{transform:translateY(0)}to{transform:translateY(100%)}}@keyframes seki-slide-in-from-left{from{transform:translateX(-100%)}to{transform:translateX(0)}}@keyframes seki-slide-out-to-left{from{transform:translateX(0)}to{transform:translateX(-100%)}}@keyframes seki-slide-in-from-right{from{transform:translateX(100%)}to{transform:translateX(0)}}@keyframes seki-slide-out-to-right{from{transform:translateX(0)}to{transform:translateX(100%)}}@keyframes seki-accordion-down{from{height:0;opacity:0}to{height:var(--seki-accordion-content-height);opacity:1}}@keyframes seki-accordion-up{from{height:var(--seki-accordion-content-height);opacity:1}to{height:0;opacity:0}}@keyframes seki-zoom-in{from{opacity:0;transform:scale(0.96)}to{opacity:1;transform:scale(1)}}@keyframes seki-zoom-out{from{opacity:1;transform:scale(1)}to{opacity:0;transform:scale(0.96)}}@keyframes seki-spin{from{transform:rotate(0deg)}to{transform:rotate(360deg)}}@keyframes seki-pulse{0%,100%{opacity:1}50%{opacity:0.5}}@keyframes seki-bounce{0%,100%{transform:translateY(-25%);animation-timing-function:cubic-bezier(0.8, 0, 1, 1)}50%{transform:translateY(0);animation-timing-function:cubic-bezier(0, 0, 0.2, 1)}}@keyframes seki-collapsible-open{from{height:0;overflow:hidden}to{height:var(--seki-collapsible-content-height, auto)}}@keyframes seki-collapsible-close{from{height:var(--seki-collapsible-content-height, auto)}to{height:0;overflow:hidden}}@keyframes seki-toast-slide-in-right{from{transform:translateX(calc(100% + 1rem))}to{transform:translateX(0)}}@keyframes seki-toast-slide-out-right{from{transform:translateX(0)}to{transform:translateX(calc(100% + 1rem))}}@keyframes seki-toast-swipe-out{from{transform:translateX(var(--seki-toast-swipe-end-x, 0))}to{transform:translateX(calc(100% + 1rem))}}.seki-animate-fade-in{animation:seki-fade-in var(--seki-animation-normal) var(--seki-ease-out)}.seki-animate-fade-out{animation:seki-fade-out var(--seki-animation-normal) var(--seki-ease-in)}.seki-animate-scale-in{animation:seki-scale-in var(--seki-animation-normal) var(--seki-ease-out)}.seki-animate-scale-out{animation:seki-scale-out var(--seki-animation-normal) var(--seki-ease-in)}.seki-animate-spin{animation:seki-spin 1s linear infinite}.seki-animate-pulse{animation:seki-pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite}.seki-animate-bounce{animation:seki-bounce 1s infinite}@media (prefers-reduced-motion: reduce){*,*::before,*::after{animation-duration:0.01ms !important;animation-iteration-count:1 !important;transition-duration:0.01ms !important}}[data-theme='dark']{color-scheme:dark}[data-theme='light']{color-scheme:light}:host{display:contents}.dialog{display:contents}";
 
@@ -11,6 +12,7 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
         }
         this.__attachShadow();
         this.sekiOpenChange = createEvent(this, "sekiOpenChange");
+        this.dialogContextChange = createEvent(this, "sekiContextChange");
         /**
          * Controlled open state
          */
@@ -31,6 +33,19 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
     }
     componentWillLoad() {
         this._isOpen = this.open || this.defaultOpen;
+        // Publish before the first render so parts that render with this dialog
+        // (or upgrade before it, under one-module-per-tag loading) see `open`
+        // declared in HTML (#323).
+        this.publish();
+    }
+    componentDidLoad() {
+        // A dialog declared open in HTML never went through openDialog().
+        if (this._isOpen && this.modal) {
+            lockBodyScroll();
+        }
+    }
+    handleModalChange() {
+        this.publish();
     }
     handleOpenPropChange(newValue) {
         // Honour controlled `open` updates after first render. Without this, setting
@@ -59,8 +74,7 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
         // Update context for child components before emitting, so that any listener
         // reading _dialogContext synchronously (e.g. seki-dialog-content) sees isOpen
         // already updated.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.el._dialogContext = this.getContext();
+        this.publish();
         this.sekiOpenChange.emit(true);
         if (this.modal) {
             lockBodyScroll();
@@ -77,8 +91,7 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
         // Update context for child components before emitting, so that any listener
         // reading _dialogContext synchronously (e.g. seki-dialog-content) sees isOpen
         // already updated.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.el._dialogContext = this.getContext();
+        this.publish();
         this.sekiOpenChange.emit(false);
         if (this.modal) {
             unlockBodyScroll();
@@ -100,13 +113,8 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
             close: () => this.closeDialog(),
         };
     }
-    componentDidLoad() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.el._dialogContext = this.getContext();
-    }
-    componentDidUpdate() {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this.el._dialogContext = this.getContext();
+    publish() {
+        publishContext(this.el, '_dialogContext', this.getContext(), this.dialogContextChange);
     }
     disconnectedCallback() {
         // Ensure body scroll is unlocked if component is removed while open
@@ -115,10 +123,11 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
         }
     }
     render() {
-        return (h(Host, { key: 'c0b5c16c3d4877691dd949cabbf3d3bad28b9743', "data-state": this._isOpen ? 'open' : 'closed' }, h("div", { key: 'bd6a709bdd992aefbecfbeae8ba24d1233872c4f', part: "dialog", class: "dialog" }, h("slot", { key: '7723c79670a33449a46bc697d5168b6fd6ccc7e5' }))));
+        return (h(Host, { key: 'a1aa2d420059b896076fc23e80ad0843c54ca6e9', "data-state": this._isOpen ? 'open' : 'closed' }, h("div", { key: 'c84e45a16884cc61fb26e4a5fd5b96547405bcea', part: "dialog", class: "dialog" }, h("slot", { key: '13f5b8cbae8ba716473dabdef44e5ea08f5a881b' }))));
     }
     get el() { return this; }
     static get watchers() { return {
+        "modal": ["handleModalChange"],
         "open": ["handleOpenPropChange"]
     }; }
     static get style() { return sekiDialogCss; }
@@ -130,6 +139,7 @@ const SekiDialog = /*@__PURE__*/ proxyCustomElement(class SekiDialog extends H {
         "openDialog": [64],
         "closeDialog": [64]
     }, [[0, "sekiDialogTriggerClick", "handleTriggerClick"], [0, "sekiDialogClose", "handleCloseRequest"]], {
+        "modal": ["handleModalChange"],
         "open": ["handleOpenPropChange"]
     }]);
 SekiDialog.instanceCount = 0;

package/dist/components/p-B4SOpX_A.js

@@ -0,0 +1,155 @@
+/**
+ * Context Bridge Utility
+ *
+ * Generalizes the "parent publishes state onto its host element + child
+ * subscribes via closest()" pattern used by compound components (select,
+ * toggle-group, combobox, dialog, popover, ...).
+ *
+ * Parent (provider) contract:
+ *   - call publishContext() from componentWillLoad(), so the context exists
+ *     before any child renders for the first time, and
+ *   - call it again on every state change, including changes that arrive as a
+ *     @Prop assignment (@Watch) rather than through a @Method or user input.
+ *
+ * Child (consumer) contract — use a ContextConsumer:
+ *   - call connect(this.el) from connectedCallback() (runs before the first
+ *     render, and again after the element is moved to a new parent), and
+ *   - call disconnect() from disconnectedCallback().
+ *   connect() invokes the callback once immediately, so a child that
+ *   upgrades after its parent already published still starts from the current
+ *   state; a child that upgrades before its parent (one-module-per-tag
+ *   loading, #314) hears the parent's first publish from componentWillLoad().
+ *
+ * subscribeToContextChange() is the older listener-only form (no immediate
+ * read, light-DOM closest() only); prefer ContextConsumer for new code.
+ *
+ * Extracted after the same bug (child freezes at mount-time state because
+ * nothing told it the parent changed) was independently fixed three times
+ * for select (#244/#253), toggle-group (#255/#257), and combobox (#258/#259).
+ */
+/**
+ * One event name shared by every compound-component family. Stencil's
+ * @Event() emits with { bubbles: true, composed: true } by default, so a
+ * nested compound (e.g. a toggle-group rendered inside a select) can cause an
+ * inner parent's event to bubble past an outer parent's own children. This is
+ * harmless today only because subscribeToContextChange()'s callback takes no
+ * payload and every handler re-reads its own closest() parent's live context
+ * rather than trusting event.detail — do not add a payload to this event or
+ * that bubbling becomes a real cross-family bug.
+ */
+const SEKI_CONTEXT_CHANGE_EVENT = 'sekiContextChange';
+/**
+ * Parent-side: publish a fresh context object onto the host element and
+ * notify subscribed children. Must assign a plain property, not a class
+ * accessor of the same name — in the dist-custom-elements build the class
+ * IS the host element, so an accessor collision throws (#254).
+ */
+function publishContext(el, propertyName, context, emitter) {
+    el[propertyName] = context;
+    emitter.emit();
+}
+/**
+ * Child-side: find the nearest ancestor matching parentSelector and listen
+ * for context-change notifications. onChange is called with no payload by
+ * design — children re-read the live context property via closest() rather
+ * than trusting a stale event.detail snapshot. No-ops safely (null parent,
+ * no-op unsubscribe) if no matching parent is found.
+ */
+function subscribeToContextChange(el, parentSelector, onChange) {
+    const parent = el.closest(parentSelector);
+    if (parent) {
+        parent.addEventListener(SEKI_CONTEXT_CHANGE_EVENT, onChange);
+    }
+    return {
+        parent,
+        unsubscribe: () => parent === null || parent === void 0 ? void 0 : parent.removeEventListener(SEKI_CONTEXT_CHANGE_EVENT, onChange),
+    };
+}
+/**
+ * Nearest ancestor matching `selector`, continuing past shadow roots: when the
+ * element's own tree has no match, the search resumes from the shadow host.
+ * This lets a part rendered inside another component's shadow tree still find
+ * the provider that wraps that component.
+ */
+function findContextProvider(el, selector) {
+    var _a;
+    let node = el;
+    while (node) {
+        const match = node.closest(selector);
+        if (match)
+            return match;
+        const root = node.getRootNode();
+        // A shadow root is a document fragment with a host (no global ShadowRoot
+        // reference, so this also runs under mock-doc / hydrate).
+        node = root.nodeType === 11 ? ((_a = root.host) !== null && _a !== void 0 ? _a : null) : null;
+    }
+    return null;
+}
+/**
+ * Child-side: tracks one provider (see findContextProvider) for a part.
+ *
+ *   private dialog = new ContextConsumer<DialogContext>('seki-dialog', '_dialogContext', () => this.sync());
+ *   connectedCallback() { this.dialog.connect(this.el); }
+ *   disconnectedCallback() { this.dialog.disconnect(); }
+ *
+ * connect() finds the provider, starts listening for its context-change
+ * notifications and calls `onChange` once right away, so the part starts from
+ * whatever is already published. `parent` and `context` are already set when
+ * that first call happens. Calling connect() from connectedCallback runs it
+ * before the first render and again after the part is moved to another
+ * provider.
+ *
+ * `onChange` gets no event payload by design (see SEKI_CONTEXT_CHANGE_EVENT):
+ * it reads the live `context`. Notifications bubbling up from a nested
+ * provider are ignored; only events dispatched by this part's own provider
+ * host (or retargeted to it from that host's shadow tree) count.
+ *
+ * Works whether or not the provider element has been upgraded yet: the
+ * listener sits on the element itself, so the provider's first
+ * publishContext() from componentWillLoad() reaches it.
+ */
+class ContextConsumer {
+    constructor(parentSelector, propertyName, onChange) {
+        this.parentSelector = parentSelector;
+        this.propertyName = propertyName;
+        this.onChange = onChange;
+        this.provider = null;
+        this.handleEvent = (event) => {
+            if (event.target === this.provider) {
+                this.onChange(this.context);
+            }
+        };
+    }
+    /** The provider element found by the last connect(), or null. */
+    get parent() {
+        return this.provider;
+    }
+    /** The provider's current context, or null when there is none yet. */
+    get context() {
+        return readContext(this.provider, this.propertyName);
+    }
+    connect(host) {
+        var _a;
+        this.disconnect();
+        this.provider = findContextProvider(host, this.parentSelector);
+        (_a = this.provider) === null || _a === void 0 ? void 0 : _a.addEventListener(SEKI_CONTEXT_CHANGE_EVENT, this.handleEvent);
+        this.onChange(this.context);
+    }
+    disconnect() {
+        var _a;
+        (_a = this.provider) === null || _a === void 0 ? void 0 : _a.removeEventListener(SEKI_CONTEXT_CHANGE_EVENT, this.handleEvent);
+        this.provider = null;
+    }
+}
+/**
+ * Read a context object a provider published with publishContext(). Returns
+ * null when there is no provider or it has not published yet.
+ */
+function readContext(parent, propertyName) {
+    var _a;
+    if (!parent)
+        return null;
+    return ((_a = parent[propertyName]) !== null && _a !== void 0 ? _a : null);
+}
+
+export { ContextConsumer as C, publishContext as p, subscribeToContextChange as s };