@aceshooting/lyra-ui 2.1.0 → 2.2.0

package/dist/components/streaming-text/streaming-text.js

@@ -1,224 +1,6 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { html, nothing } from 'lit';
-import { property, state } from 'lit/decorators.js';
-import { LyraElement } from '../../internal/lyra-element.js';
+export * from './streaming-text.class.js';
+import { LyraStreamingText } from './streaming-text.class.js';
 import { defineElement } from '../../internal/prefix.js';
-import { Announcer } from '../../internal/announcer.js';
-import '../markdown/markdown.js';
-import { styles } from './streaming-text.styles.js';
-const DEFAULT_COALESCE_MS = 50;
-/**
- * Lightweight, deliberately-imperfect signals that the currently-displayed
- * text contains Markdown syntax worth routing through `<lyra-markdown>`
- * rather than a plain `white-space: pre-wrap` node. Checked in order against
- * the whole string; the first match short-circuits. None of these need to be
- * airtight -- a false positive just renders ordinary prose through
- * `<lyra-markdown>` (which renders plain prose fine); a false negative just
- * renders literal `**`/backticks/etc. as plain text until more of the stream
- * arrives.
- */
-const MARKDOWN_PATTERNS = [
-    /^ {0,3}#{1,6}\s+\S/m, // ATX heading: "# Heading"
-    /```/, // fenced code block
-    /\*\*[^*\n]+\*\*/, // **bold**
-    /(?:^|[^\w])_[^_\n]+_(?:[^\w]|$)/, // _italic_
-    /`[^`\n]+`/, // inline code
-    /^ {0,3}[-*+]\s+\S/m, // bullet list item
-    /^ {0,3}\d+\.\s+\S/m, // numbered list item
-    /\[[^\]]+\]\([^)\s]+\)/, // [text](url)
-    /^ {0,3}>\s?\S/m, // blockquote
-];
-/** Runs {@link MARKDOWN_PATTERNS} against `text`, used whenever `markdown`
- *  is left unset (auto-detect). Exported so the heuristic is directly
- *  testable without going through the component's render cycle. */
-export function looksLikeMarkdown(text) {
-    if (!text)
-        return false;
-    return MARKDOWN_PATTERNS.some((pattern) => pattern.test(text));
-}
-/**
- * Tri-state boolean attribute converter for `markdown`. Lit's built-in
- * `type: Boolean` converter is presence-based and can only ever represent
- * two states (attribute present -> `true`, absent -> `false`) -- there's no
- * way for it to also represent "not specified, auto-detect instead", which
- * is the actual default this property needs. `markdown` (no value, or
- * `="true"`) -> `true`; `markdown="false"` -> `false`; attribute entirely
- * absent -> `undefined`.
- */
-const optionalBooleanConverter = {
-    fromAttribute(value) {
-        if (value === null)
-            return undefined;
-        return value !== 'false';
-    },
-    toAttribute(value) {
-        if (value === undefined)
-            return null;
-        return value ? '' : 'false';
-    },
-};
-/**
- * `<lyra-streaming-text>` — a token-coalescing incremental text renderer for
- * streaming assistant output, with an optional blinking cursor and
- * auto-detected Markdown rendering.
- *
- * The host is expected to assign the *entire* current text on every update
- * to `content`, not a delta -- this component does no accumulation or
- * ordering of its own. That matches how most streaming-UI state (SSE/
- * WebSocket token accumulation into a growing string in application state)
- * is already managed.
- *
- * Token-by-token streaming can update `content` far faster than a human can
- * usefully perceive a re-render -- dozens of times a second for a fast
- * model. Re-rendering on every single assignment thrashes layout for no
- * visible benefit, so updates funnel through `Announcer`
- * (`../../internal/announcer.js`), reused here purely as the generic
- * "coalesce rapid calls, flush the latest" timing primitive its own class
- * doc says other components should reuse -- with none of its usual
- * DOM/ARIA plumbing (that's `<lyra-live-region>`'s job, not this
- * component's). Within any `coalesce-ms` window, only the *last* `content`
- * value assigned actually reaches the rendered DOM. Two cases always bypass
- * the throttle and flush immediately instead of waiting out the window: the
- * very first `content` assignment after mount (so an already-complete
- * message never shows an artificial startup delay), and any transition of
- * `streaming` between `true` and `false` in either direction (so the final
- * chunk of a finished stream can never be left stranded mid-window, and a
- * stream restarting on a reused element can never keep showing the
- * previous stream's stale final content for the length of the window).
- *
- * `markdown` is a tri-state property, not a plain boolean: left unset (the
- * default), it auto-detects via a lightweight regex heuristic (see
- * `looksLikeMarkdown`) run against whatever text is currently displayed --
- * good enough to route obviously-Markdown output through `<lyra-markdown>`
- * without the host needing to know or declare it up front, at the cost of
- * an occasional one-time mode flip if Markdown syntax only appears partway
- * through a stream. Explicitly setting `markdown` to `true`/`false` always
- * wins over the heuristic. Rendering itself is never reimplemented here:
- * Markdown mode composes `<lyra-markdown>` (`../markdown/markdown.js`)
- * directly, forwarding this component's own `streaming` through as that
- * component's own forward-compatible `streaming` hint prop; plain-text mode
- * renders into a `white-space: pre-wrap` span instead.
- *
- * The blinking cursor (shown only while `streaming` is `true`) degrades to
- * a static, always-visible bar under `prefers-reduced-motion: reduce`
- * rather than disabling the animation into an invisible frozen frame --
- * the same pattern `<lyra-typing-indicator>`'s own `cursor` variant uses. In
- * plain-text mode the cursor sits inline at the tail of the final
- * character, since the text is one continuous inline flow; in Markdown
- * mode it renders as its own trailing block below the rendered content
- * instead of attempting to splice into whatever nested block Markdown
- * happens to end with (a paragraph, a table cell, a list item, a fenced
- * code block, …) -- genuinely interleaving into arbitrary rendered Markdown
- * without reaching across `<lyra-markdown>`'s own shadow boundary isn't a
- * tractable general solution, so this component doesn't attempt it.
- *
- * Purely presentational: no events, driven entirely by its properties. It
- * also doesn't announce anything to assistive tech itself -- a host that
- * needs streamed text announced already has `<lyra-live-region>` for that
- * (composed, for example, inside `<lyra-chat-message>`).
- *
- * @customElement lyra-streaming-text
- * @csspart base - The root container.
- * @csspart cursor - The blinking (or, under reduced motion, static) cursor bar. Only rendered while `streaming` is `true`.
- */
-export class LyraStreamingText extends LyraElement {
-    static { this.styles = [LyraElement.styles, styles]; }
-    constructor() {
-        super();
-        /** The full current text so far -- always the complete string, never a
-         *  delta to append. */
-        this.content = '';
-        /** Shows the blinking cursor after the rendered text. Reflects, so a host
-         *  can also target `lyra-streaming-text[streaming]` in CSS. */
-        this.streaming = false;
-        /** Trailing-edge coalesce window, in ms, for `content` updates -- see the
-         *  class doc. */
-        this.coalesceMs = DEFAULT_COALESCE_MS;
-        // The coalesced value actually rendered -- lags `content` by up to
-        // `coalesceMs` (or zero, for the immediate-flush cases documented above).
-        this.displayedContent = '';
-        this.lastScannedResult = false;
-        // Built in the constructor (not a class-field initializer) so it reads
-        // `this.coalesceMs` only after that property's own field initializer has
-        // already run and set the declared default -- same ordering rationale as
-        // lyra-live-region's identical constructor-built Announcer.
-        this.coalescer = new Announcer({
-            throttleMs: this.coalesceMs,
-            onFlush: (text) => {
-                this.displayedContent = text;
-            },
-        });
-    }
-    willUpdate(changed) {
-        if (changed.has('coalesceMs')) {
-            this.coalescer.throttleMs = this.coalesceMs;
-        }
-        if (changed.has('content')) {
-            // The very first content assignment after mount always flushes
-            // immediately -- an already-complete message (or the first chunk of a
-            // new one) shouldn't show an artificial startup delay just because a
-            // coalescing window technically applies to it.
-            this.coalescer.announce(this.content, { force: !this.hasUpdated });
-        }
-        // Neither a stream finishing nor a stream (re)starting on a reused
-        // element may leave stale content stranded inside an in-progress
-        // coalescing window -- force whatever `content` currently holds through
-        // immediately in both directions. Without the restart side of this, a
-        // reused element would keep showing the *previous* stream's final
-        // content for up to a full coalesce-ms window after a new stream had
-        // already begun. `changed.get('streaming')` is only defined for a real
-        // transition (never the initial mount value, per Lit's documented
-        // first-change semantics), so this can't misfire on connect.
-        if (changed.has('streaming') &&
-            changed.get('streaming') !== undefined &&
-            changed.get('streaming') !== this.streaming) {
-            this.coalescer.announce(this.content, { force: true });
-        }
-        if (changed.has('displayedContent') && this.displayedContent !== this.lastScannedContent) {
-            this.lastScannedContent = this.displayedContent;
-            this.lastScannedResult = looksLikeMarkdown(this.displayedContent);
-        }
-    }
-    disconnectedCallback() {
-        super.disconnectedCallback();
-        this.coalescer.cancel();
-    }
-    /** Whether Markdown mode is actually in effect right now, resolving the
-     *  tri-state `markdown` property against the memoized `looksLikeMarkdown`
-     *  result for the currently-displayed content (see `lastScannedContent`/
-     *  `lastScannedResult` above). */
-    get effectiveMarkdown() {
-        return this.markdown ?? this.lastScannedResult;
-    }
-    render() {
-        return html `
-      <div part="base">
-        ${this.effectiveMarkdown
-            ? html `<lyra-markdown .content=${this.displayedContent} .streaming=${this.streaming}></lyra-markdown>`
-            : html `<span class="plain">${this.displayedContent}</span>`}
-        ${this.streaming ? html `<span part="cursor" aria-hidden="true"></span>` : nothing}
-      </div>
-    `;
-    }
-}
-__decorate([
-    property()
-], LyraStreamingText.prototype, "content", void 0);
-__decorate([
-    property({ type: Boolean, reflect: true })
-], LyraStreamingText.prototype, "streaming", void 0);
-__decorate([
-    property({ type: Number, attribute: 'coalesce-ms' })
-], LyraStreamingText.prototype, "coalesceMs", void 0);
-__decorate([
-    property({ attribute: 'markdown', converter: optionalBooleanConverter })
-], LyraStreamingText.prototype, "markdown", void 0);
-__decorate([
-    state()
-], LyraStreamingText.prototype, "displayedContent", void 0);
+import "../markdown/markdown.js";
 defineElement('streaming-text', LyraStreamingText);
+//# sourceMappingURL=streaming-text.js.map

package/dist/components/streaming-text/streaming-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-text.js","sourceRoot":"","sources":["../../../src/components/streaming-text/streaming-text.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,yBAAyB,CAAC;AACjC,aAAa,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC"}

package/dist/components/streaming-text/streaming-text.styles.d.ts

@@ -1 +1,2 @@
 export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=streaming-text.styles.d.ts.map

package/dist/components/streaming-text/streaming-text.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-text.styles.d.ts","sourceRoot":"","sources":["../../../src/components/streaming-text/streaming-text.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBA6DlB,CAAC"}

package/dist/components/streaming-text/streaming-text.styles.js

@@ -8,12 +8,12 @@ export const styles = css `
        defines its own scoped custom properties, exactly the way
        lyra-typing-indicator's --lyra-typing-cursor-width/-height do for its
        own (near-identical) blinking cursor. */
-    --lyra-streaming-text-cursor-width: 0.125rem;
-    --lyra-streaming-text-cursor-height: 1em;
+    --lyra-streaming-text-cursor-width: var(--lyra-size-0-125rem);
+    --lyra-streaming-text-cursor-height: var(--lyra-size-1em);
   }
 
   [part='base'] {
-    line-height: 1.6;
+    line-height: var(--lyra-line-height-loose);
   }
 
   /* Plain-text path only (Markdown mode never renders this element) -- see
@@ -61,3 +61,4 @@ export const styles = css `
     }
   }
 `;
+//# sourceMappingURL=streaming-text.styles.js.map

package/dist/components/streaming-text/streaming-text.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-text.styles.js","sourceRoot":"","sources":["../../../src/components/streaming-text/streaming-text.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DxB,CAAC"}

package/dist/components/switch/switch.class.d.ts

@@ -0,0 +1,109 @@
+import { type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+/**
+ * `<lyra-switch>` — a boolean toggle-switch form control. Structurally the
+ * same idea as a checkbox (form-associated via `ElementInternals`, click and
+ * Space/Enter both toggle) but with switch semantics: `role="switch"` +
+ * `aria-checked` read to assistive tech as an on/off state rather than a
+ * checked/unchecked one, and there is no indeterminate state.
+ *
+ * `checked` is not a plain string, so this attaches `ElementInternals`
+ * directly and implements its own `updateValidity()` rather than using the
+ * `FormAssociated` mixin (that mixin's `value` accessor assumes a string —
+ * see `<lyra-combobox>` for the same direct-`ElementInternals` shape with a
+ * non-string value).
+ *
+ * @customElement lyra-switch
+ * @slot - Label text, rendered next to the track. Clicking it toggles the
+ * switch, the same as clicking a checkbox's associated `<label>`. If left
+ * empty, set `aria-label` on the host so the control still has an
+ * accessible name.
+ * @event lyra-change - The user toggled the switch (click or Space/Enter). `detail: { checked }`.
+ * @csspart base - The whole interactive control (`role="switch"`); wraps the track and label.
+ * @csspart track - The pill-shaped background.
+ * @csspart thumb - The circular knob that slides across the track.
+ * @csspart label - The wrapper around the default slot.
+ */
+export interface LyraSwitchEventMap {
+    'lyra-change': CustomEvent<{
+        checked: boolean;
+    }>;
+}
+export declare class LyraSwitch extends LyraElement<LyraSwitchEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    static formAssociated: boolean;
+    static properties: {
+        checked: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        name: {
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        required: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        value: {
+            noAccessor: boolean;
+        };
+    };
+    private hasLabelSlot;
+    private internals;
+    private validityController;
+    private _defaultChecked;
+    private _defaultCaptured;
+    private _fieldsetDisabled;
+    private _name;
+    private _checked;
+    private _disabled;
+    private _required;
+    private _value;
+    /** Whether the control is disabled explicitly or by an ancestor fieldset. */
+    get effectiveDisabled(): boolean;
+    get checked(): boolean;
+    set checked(next: boolean);
+    get disabled(): boolean;
+    set disabled(next: boolean);
+    /** The form submission key, reflected synchronously for native form APIs. */
+    get name(): string;
+    set name(next: string);
+    get required(): boolean;
+    set required(next: boolean);
+    get value(): string;
+    set value(next: string);
+    constructor();
+    get form(): HTMLFormElement | null;
+    get labels(): NodeList;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    connectedCallback(): void;
+    protected willUpdate(): void;
+    private updateValidity;
+    private syncFormState;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null, _mode?: 'restore' | 'autocomplete'): void;
+    formDisabledCallback(disabled: boolean): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    private toggle;
+    private onClick;
+    private onKeyDown;
+    private onSlotChange;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-switch': LyraSwitch;
+    }
+}
+//# sourceMappingURL=switch.class.d.ts.map

package/dist/components/switch/switch.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.class.d.ts","sourceRoot":"","sources":["../../../src/components/switch/switch.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAI7D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAClD;AACD,qBAAa,UAAW,SAAQ,WAAW,CAAC,kBAAkB,CAAC;IAC7D,MAAM,CAAC,MAAM,iCAAgC;IAC7C,MAAM,CAAC,cAAc,UAAQ;IAE7B,MAAM,CAAC,UAAU;QACf,OAAO;YAAI,IAAI;YAAW,OAAO;YAAQ,UAAU;;QACnD,QAAQ;YAAI,IAAI;YAAW,OAAO;YAAQ,UAAU;;QACpD,IAAI;YAAI,OAAO;YAAQ,UAAU;;QACjC,QAAQ;YAAI,IAAI;YAAW,OAAO;YAAQ,UAAU;;QACpD,KAAK;YAAI,UAAU;;MACnB;IAUO,OAAO,CAAC,YAAY,CAAS;IAEtC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,kBAAkB,CAA6B;IAUvD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAQ;IAEtB,6EAA6E;IAC7E,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,EAKxB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAKzB;IAED,6EAA6E;IAC7E,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EASpB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAMzB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,EAKrB;IAED,cAKC;IAED,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IACD,IAAI,MAAM,IAAI,QAAQ,CAErB;IACD,IAAI,QAAQ,IAAI,aAAa,CAE5B;IACD,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IACD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAOD,iBAAiB,IAAI,IAAI,CAOxB;IAED,SAAS,CAAC,UAAU,IAAI,IAAI,CAQ3B;IAED,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IAKrB,iBAAiB,IAAI,IAAI,CAExB;IACD,wBAAwB,CACtB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EACtC,KAAK,CAAC,EAAE,SAAS,GAAG,cAAc,GACjC,IAAI,CAEN;IACD,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAG5C;IACD,aAAa,IAAI,OAAO,CAEvB;IACD,cAAc,IAAI,OAAO,CAExB;IAED,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,OAAO,CAEb;IAEF,OAAO,CAAC,SAAS,CAUf;IAEF,OAAO,CAAC,YAAY,CAGlB;IAEF,MAAM,IAAI,cAAc,CAqBvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,aAAa,EAAE,UAAU,CAAC;KAC3B;CACF"}

package/dist/components/switch/switch.class.js

@@ -0,0 +1,225 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing } from 'lit';
+import { state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { AnchoredValidityController, VALIDITY_ANCHOR } from '../../internal/anchored-validity.js';
+import { styles } from './switch.styles.js';
+export class LyraSwitch extends LyraElement {
+    static { this.styles = [LyraElement.styles, styles]; }
+    static { this.formAssociated = true; }
+    static { this.properties = {
+        checked: { type: Boolean, reflect: true, noAccessor: true },
+        disabled: { type: Boolean, reflect: true, noAccessor: true },
+        name: { reflect: true, noAccessor: true },
+        required: { type: Boolean, reflect: true, noAccessor: true },
+        value: { noAccessor: true },
+    }; }
+    /** Whether the control is disabled explicitly or by an ancestor fieldset. */
+    get effectiveDisabled() {
+        return this.disabled || this._fieldsetDisabled;
+    }
+    get checked() {
+        return this._checked;
+    }
+    set checked(next) {
+        const old = this._checked;
+        this._checked = Boolean(next);
+        this.syncFormState();
+        this.requestUpdate('checked', old);
+    }
+    get disabled() {
+        return this._disabled;
+    }
+    set disabled(next) {
+        const old = this._disabled;
+        this._disabled = Boolean(next);
+        this.toggleAttribute('disabled', this._disabled);
+        this.requestUpdate('disabled', old);
+    }
+    /** The form submission key, reflected synchronously for native form APIs. */
+    get name() {
+        return this._name;
+    }
+    set name(next) {
+        const old = this._name;
+        this._name = next ?? '';
+        if (this._name) {
+            this.setAttribute('name', this._name);
+        }
+        else {
+            this.removeAttribute('name');
+        }
+        this.requestUpdate('name', old);
+    }
+    get required() {
+        return this._required;
+    }
+    set required(next) {
+        const old = this._required;
+        this._required = Boolean(next);
+        this.toggleAttribute('required', this._required);
+        this.updateValidity();
+        this.requestUpdate('required', old);
+    }
+    get value() {
+        return this._value;
+    }
+    set value(next) {
+        const old = this._value;
+        this._value = next ?? 'on';
+        this.syncFormState();
+        this.requestUpdate('value', old);
+    }
+    constructor() {
+        super();
+        // Tracks whether the default slot carries any real (non-whitespace)
+        // content, so the label wrapper — and the `gap` next to the track — can
+        // collapse to nothing for an icon-only/aria-label-only switch instead of
+        // leaving a stray empty gap. See combobox/date-input's `hasHintSlot`-style
+        // state fields; this one checks `assignedNodes` rather than
+        // `assignedElements` because a plain slotted text label (the expected
+        // common case here, e.g. `<lyra-switch>Enable notifications</lyra-switch>`)
+        // is a text node, which `assignedElements` would silently ignore.
+        this.hasLabelSlot = false;
+        // What `form.reset()` restores to — captured once from the declarative
+        // `checked` content attribute at first connect. A pre-connect `.checked`
+        // property assignment changes live state but not the reset default, matching
+        // native `checked`/`defaultChecked` semantics. `checked` reflects, so unlike
+        // `FormAssociated`'s non-reflecting `value` this can't be captured from
+        // `attributeChangedCallback` alone — that would also fire (and wrongly
+        // redefine the default) every time the property setter itself reflects a
+        // later user toggle back into the attribute. Guarding with a one-shot flag
+        // instead mirrors `<lyra-combobox>`'s `_defaultCaptured`/`_defaultSelected`.
+        this._defaultChecked = false;
+        this._defaultCaptured = false;
+        this._fieldsetDisabled = false;
+        this._name = '';
+        this._checked = false;
+        this._disabled = false;
+        this._required = false;
+        this._value = 'on';
+        this.onClick = () => {
+            this.toggle();
+        };
+        this.onKeyDown = (e) => {
+            if (this.effectiveDisabled)
+                return;
+            // Space/Enter both activate, matching `<lyra-table>`'s sortable
+            // header/row convention (`table.ts`'s `onHeaderKeyDown`/`onRowKeyDown`)
+            // for role-based clickable elements — bound to `keydown` rather than
+            // `keyup`/native `click`-forwarding like the rest of this library.
+            if (e.key === ' ' || e.key === 'Spacebar' || e.key === 'Enter') {
+                e.preventDefault();
+                this.toggle();
+            }
+        };
+        this.onSlotChange = (e) => {
+            const nodes = e.target.assignedNodes({ flatten: true });
+            this.hasLabelSlot = nodes.some((n) => (n.textContent ?? '').trim().length > 0);
+        };
+        this.internals = this.attachInternals();
+        this.validityController = new AnchoredValidityController(this, this.internals, () => this[VALIDITY_ANCHOR]());
+        this.syncFormState();
+    }
+    get form() {
+        return this.internals.form;
+    }
+    get labels() {
+        return this.internals.labels;
+    }
+    get validity() {
+        return this.internals.validity;
+    }
+    get validationMessage() {
+        return this.internals.validationMessage;
+    }
+    get willValidate() {
+        return this.internals.willValidate;
+    }
+    /** @internal */
+    [VALIDITY_ANCHOR]() {
+        return this.renderRoot?.querySelector('[part="base"]') ?? null;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (!this._defaultCaptured) {
+            this._defaultCaptured = true;
+            this._defaultChecked = this.hasAttribute('checked');
+        }
+        this.updateValidity();
+    }
+    willUpdate() {
+        // Seed `hasLabelSlot` from the light-DOM children synchronously before
+        // the very first render (same `!hasUpdated` guard as combobox/date-input's
+        // `hasHintSlot` etc.) so declaratively-provided label text doesn't flash
+        // hidden for one frame while waiting on the first `slotchange` event.
+        if (!this.hasUpdated) {
+            this.hasLabelSlot = Array.from(this.childNodes).some((n) => (n.textContent ?? '').trim().length > 0);
+        }
+    }
+    updateValidity() {
+        if (this.required && !this.checked) {
+            this.validityController.setValidity({ valueMissing: true }, 'Please turn this on.');
+        }
+        else {
+            this.validityController.setValidity({});
+        }
+    }
+    syncFormState() {
+        this.internals.setFormValue(this.checked ? this.value : null, this.checked ? 'checked' : 'unchecked');
+        this.updateValidity();
+    }
+    formResetCallback() {
+        this.checked = this._defaultChecked;
+    }
+    formStateRestoreCallback(state, _mode) {
+        this.checked = state === 'checked';
+    }
+    formDisabledCallback(disabled) {
+        this._fieldsetDisabled = disabled;
+        this.requestUpdate();
+    }
+    checkValidity() {
+        return this.internals.checkValidity();
+    }
+    reportValidity() {
+        return this.internals.reportValidity();
+    }
+    toggle() {
+        if (this.effectiveDisabled)
+            return;
+        this.checked = !this.checked;
+        this.emit('lyra-change', { checked: this.checked });
+    }
+    render() {
+        return html `
+      <span
+        part="base"
+        role="switch"
+        tabindex=${this.effectiveDisabled ? '-1' : '0'}
+        aria-checked=${this.checked ? 'true' : 'false'}
+        aria-required=${this.required ? 'true' : nothing}
+        aria-disabled=${this.effectiveDisabled ? 'true' : nothing}
+        aria-label=${this.getAttribute('aria-label') || nothing}
+        @click=${this.onClick}
+        @keydown=${this.onKeyDown}
+      >
+        <span part="track">
+          <span part="thumb"></span>
+        </span>
+        <span part="label" ?hidden=${!this.hasLabelSlot}>
+          <slot @slotchange=${this.onSlotChange}></slot>
+        </span>
+      </span>
+    `;
+    }
+}
+__decorate([
+    state()
+], LyraSwitch.prototype, "hasLabelSlot", void 0);
+//# sourceMappingURL=switch.class.js.map

package/dist/components/switch/switch.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.class.js","sourceRoot":"","sources":["../../../src/components/switch/switch.class.ts"],"names":[],"mappings":"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"}