@aceshooting/lyra-ui 2.0.0 → 2.2.0

package/dist/components/word-cloud/word-cloud.styles.js

@@ -7,14 +7,26 @@ export const styles = css `
        Data-driven literals, same rationale as lyra-heatmap's
        --lyra-heatmap-scale-lo/-hi -- exposed as retheme-able custom
        properties instead of hardcoded in word-cloud.ts. */
-    --lyra-word-cloud-color-1: #0969da;
-    --lyra-word-cloud-color-2: #1a7f37;
-    --lyra-word-cloud-color-3: #9a6700;
-    --lyra-word-cloud-color-4: #cf222e;
-    --lyra-word-cloud-color-5: #8250df;
-    --lyra-word-cloud-color-6: #bf3989;
-    --lyra-word-cloud-color-7: #0a7d91;
-    --lyra-word-cloud-color-8: #57606a;
+    --lyra-word-cloud-color-1: var(--lyra-color-brand);
+    --lyra-word-cloud-color-2: var(--lyra-color-success);
+    --lyra-word-cloud-color-3: var(--lyra-color-warning);
+    --lyra-word-cloud-color-4: var(--lyra-color-danger);
+    --lyra-word-cloud-color-5: var(--lyra-color-chart-1);
+    --lyra-word-cloud-color-6: var(--lyra-color-chart-2);
+    --lyra-word-cloud-color-7: var(--lyra-color-chart-3);
+    --lyra-word-cloud-color-8: var(--lyra-color-chart-4);
+  }
+  @media (prefers-color-scheme: dark) {
+    :host {
+      --lyra-word-cloud-color-1: var(--wa-color-brand-fill-loud, var(--lyra-color-brand));
+      --lyra-word-cloud-color-2: var(--wa-color-success-fill-loud, var(--lyra-color-success));
+      --lyra-word-cloud-color-3: var(--wa-color-warning-fill-loud, var(--lyra-color-warning));
+      --lyra-word-cloud-color-4: var(--wa-color-danger-fill-loud, var(--lyra-color-danger));
+      --lyra-word-cloud-color-5: var(--lyra-color-chart-5);
+      --lyra-word-cloud-color-6: var(--lyra-color-chart-6);
+      --lyra-word-cloud-color-7: var(--lyra-color-chart-7);
+      --lyra-word-cloud-color-8: var(--lyra-color-chart-8);
+    }
   }
   [part='base'] {
     display: flex;
@@ -34,7 +46,7 @@ export const styles = css `
   [part='word'] {
     cursor: pointer;
     font-family: var(--lyra-font);
-    font-weight: 600;
+    font-weight: var(--lyra-font-weight-semibold);
     text-anchor: middle;
     dominant-baseline: middle;
     transition: text-decoration-color var(--lyra-transition-fast);
@@ -46,11 +58,25 @@ export const styles = css `
   [part='focus-ring'] {
     fill: none;
     stroke: var(--lyra-focus-ring-color);
-    stroke-width: 2px;
+    stroke-width: var(--lyra-focus-ring-width);
     pointer-events: none;
   }
   [part='empty'] {
     color: var(--lyra-color-text-quiet);
-    font-size: 0.875rem;
+    font-size: var(--lyra-font-size-md-sm);
+  }
+  @media (prefers-reduced-motion: reduce) {
+    [part='word'] {
+      transition: none !important;
+    }
+  }
+  @media (forced-colors: active) {
+    [part='word'] {
+      fill: CanvasText;
+    }
+    [part='focus-ring'] {
+      stroke: Highlight;
+    }
   }
 `;
+//# sourceMappingURL=word-cloud.styles.js.map

package/dist/components/word-cloud/word-cloud.styles.js.map

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

package/dist/internal/a11y.d.ts

@@ -2,3 +2,4 @@
 export declare const nextId: (scope: string) => string;
 /** Visually-hidden-but-screen-reader-available helper class. */
 export declare const srOnly: import("lit").CSSResult;
+//# sourceMappingURL=a11y.d.ts.map

package/dist/internal/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/internal/a11y.ts"],"names":[],"mappings":"AAKA,+EAA+E;AAC/E,eAAO,MAAM,MAAM,UAAW,MAAM,KAAG,MAAsC,CAAC;AAE9E,gEAAgE;AAChE,eAAO,MAAM,MAAM,yBAYlB,CAAC"}

package/dist/internal/a11y.js

@@ -17,3 +17,4 @@ export const srOnly = css `
     border: 0;
   }
 `;
+//# sourceMappingURL=a11y.js.map

package/dist/internal/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","sourceRoot":"","sources":["../../src/internal/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AAE9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;CAYxB,CAAC"}

package/dist/internal/anchored-validity.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anchored-validity.d.ts.map

package/dist/internal/anchored-validity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchored-validity.d.ts","sourceRoot":"","sources":["../../src/internal/anchored-validity.ts"],"names":[],"mappings":""}

package/dist/internal/anchored-validity.js

@@ -0,0 +1,87 @@
+/** @internal */
+export const VALIDITY_ANCHOR = Symbol('lyra-validity-anchor');
+/** @internal */
+export const SET_ANCHORED_VALIDITY = Symbol('lyra-set-anchored-validity');
+/** @internal */
+export function resolveValidityAnchor(provider) {
+    if (!provider || (typeof provider !== 'object' && typeof provider !== 'function'))
+        return undefined;
+    const resolver = provider[VALIDITY_ANCHOR];
+    if (typeof resolver !== 'function')
+        return undefined;
+    return resolver.call(provider) ?? undefined;
+}
+/**
+ * Keeps ElementInternals validity synchronous while refreshing its focus
+ * anchor after every render. The refresh is required because validity can be
+ * computed before the first shadow render and because conditional templates
+ * can replace a previously registered anchor.
+ *
+ * @internal
+ */
+export class AnchoredValidityController {
+    constructor(host, internals, getAnchor) {
+        this.host = host;
+        this.internals = internals;
+        this.getAnchor = getAnchor;
+        this.flags = {};
+        this.message = '';
+        this.revision = 0;
+        this.refreshToken = 0;
+        host.addController(this);
+    }
+    setValidity(flags = {}, message = '') {
+        this.flags = { ...flags };
+        this.message = message;
+        this.revision += 1;
+        this.apply();
+    }
+    refreshAnchor() {
+        if (this.isInvalid())
+            this.apply();
+    }
+    hostUpdated() {
+        if (!this.isInvalid())
+            return;
+        const revision = this.revision;
+        const token = ++this.refreshToken;
+        // Rebind just after the host's update so focus side effects from an
+        // already-visible validation UI cannot schedule a new Lit update from
+        // inside hostUpdated(). This microtask runs before updateComplete settles.
+        queueMicrotask(() => {
+            if (token !== this.refreshToken || revision !== this.revision)
+                return;
+            if (this.apply())
+                return;
+            // Nested custom controls may render one microtask after their parent.
+            // Retry once so an outer form can anchor inside that nested shadow tree.
+            queueMicrotask(() => {
+                if (token === this.refreshToken && revision === this.revision)
+                    this.apply();
+            });
+        });
+    }
+    isInvalid() {
+        return Object.values(this.flags).some(Boolean);
+    }
+    /** Returns true when an invalid state was installed with a real anchor. */
+    apply() {
+        const anchor = this.isInvalid() ? this.getAnchor() : undefined;
+        if (anchor?.isConnected) {
+            try {
+                this.internals.setValidity(this.flags, this.message, anchor);
+                return true;
+            }
+            catch (error) {
+                // A stale or incorrectly provided non-descendant anchor must not
+                // break the host's update. Preserve validity and fall back to the
+                // host until the next fresh render resolves a legal descendant.
+                if (!(error instanceof DOMException) || error.name !== 'NotFoundError')
+                    throw error;
+            }
+        }
+        this.internals.setValidity(this.flags, this.message);
+        return false;
+    }
+}
+//# sourceMappingURL=anchored-validity.js.map

package/dist/internal/anchored-validity.js.map

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

package/dist/internal/announcer.d.ts

@@ -55,3 +55,4 @@ export declare class Announcer {
     cancel(): void;
     private flush;
 }
+//# sourceMappingURL=announcer.d.ts.map

package/dist/internal/announcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.d.ts","sourceRoot":"","sources":["../../src/internal/announcer.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;+CAE2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uEACmE;IACnE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,SAAS;IACpB;8DAC0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,YAAY,OAAO,EAAE,gBAAgB,EAGpC;IAED,2EAA2E;IAC3E,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,uEAAuE;IACvE,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAW1D;IAED,6EAA6E;IAC7E,MAAM,IAAI,IAAI,CAMb;IAED,OAAO,CAAC,KAAK;CASd"}

package/dist/internal/announcer.js

@@ -69,3 +69,4 @@ export class Announcer {
             this.onFlush(text);
     }
 }
+//# sourceMappingURL=announcer.js.map

package/dist/internal/announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcer.js","sourceRoot":"","sources":["../../src/internal/announcer.ts"],"names":[],"mappings":"AAgBA,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,SAAS;IASpB,YAAY,OAAyB;QACnC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,2EAA2E;IAC3E,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,uEAAuE;IACvE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAO,GAAoB,EAAE;QAClD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,8CAA8C;QAC9C,IAAI,CAAC,KAAK,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,6EAA6E;IAC7E,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAEO,KAAK;QACX,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/internal/form-associated.d.ts

@@ -8,9 +8,16 @@ export interface FormAssociatedInterface {
     disabled: boolean;
     required: boolean;
     readonly effectiveDisabled: boolean;
+    readonly form: HTMLFormElement | null;
+    readonly labels: NodeList;
+    readonly validity: ValidityState;
+    readonly validationMessage: string;
+    readonly willValidate: boolean;
     setFormValue(next: string): void;
     checkValidity(): boolean;
     reportValidity(): boolean;
+    formResetCallback(): void;
+    formStateRestoreCallback(state: string | File | FormData | null, mode?: 'restore' | 'autocomplete'): void;
 }
 /**
  * Mixin that turns a Lit component into a form-associated custom element via
@@ -25,3 +32,4 @@ export interface FormAssociatedInterface {
  */
 export declare function FormAssociated<T extends Constructor<LitElement>>(Base: T): T & Constructor<FormAssociatedInterface>;
 export {};
+//# sourceMappingURL=form-associated.d.ts.map

package/dist/internal/form-associated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-associated.d.ts","sourceRoot":"","sources":["../../src/internal/form-associated.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAOtC,KAAK,WAAW,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEhD,2FAA2F;AAC3F,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,IAAI,OAAO,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC;IAC1B,iBAAiB,IAAI,IAAI,CAAC;IAC1B,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,IAAI,CAAC;CAG3G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAC9D,IAAI,EAAE,CAAC,GACN,CAAC,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAuN1C"}

package/dist/internal/form-associated.js

@@ -1,3 +1,4 @@
+import { AnchoredValidityController, SET_ANCHORED_VALIDITY, VALIDITY_ANCHOR, } from './anchored-validity.js';
 /**
  * Mixin that turns a Lit component into a form-associated custom element via
  * `ElementInternals`, so it participates in native `<form>` submission,
@@ -15,13 +16,13 @@ export function FormAssociated(Base) {
         static { this.properties = {
             name: { reflect: true, noAccessor: true },
             value: { noAccessor: true },
-            disabled: { type: Boolean, reflect: true },
+            disabled: { type: Boolean, reflect: true, noAccessor: true },
             required: { type: Boolean, reflect: true, noAccessor: true },
         }; }
         constructor(...args) {
             super(...args);
-            this.disabled = false;
             this._fieldsetDisabled = false;
+            this._disabled = false;
             // Hand-written accessor (mirrors `value`/`required` below): native form
             // submission for a form-associated custom element keys its `FormData`
             // entry off the `name` *content attribute*, read synchronously at
@@ -42,11 +43,35 @@ export function FormAssociated(Base) {
             this._defaultValue = '';
             this._required = false;
             this.internals = this.attachInternals();
+            this.validityController = new AnchoredValidityController(this, this.internals, () => this[VALIDITY_ANCHOR]());
             // Native <input> always has a submission value ("") from construction —
             // without this, a control whose `value` is never touched is entirely
             // absent from FormData instead of present as "".
             this.internals.setFormValue('');
         }
+        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("input:not([type='hidden']), textarea, select, button, [tabindex]:not([tabindex='-1'])") ?? null;
+        }
+        /** @internal */
+        [SET_ANCHORED_VALIDITY](flags, message = '') {
+            this.validityController.setValidity(flags, message);
+        }
         get name() {
             return this._name;
         }
@@ -71,6 +96,17 @@ export function FormAssociated(Base) {
             this.updateValidity();
             this.requestUpdate('value', old);
         }
+        get disabled() {
+            return this._disabled;
+        }
+        set disabled(next) {
+            const old = this._disabled;
+            this._disabled = Boolean(next);
+            // FACE omission and barred validation are driven by the live host
+            // attribute, so reflection must happen before same-tick form APIs run.
+            this.toggleAttribute('disabled', this._disabled);
+            this.requestUpdate('disabled', old);
+        }
         get required() {
             return this._required;
         }
@@ -107,10 +143,10 @@ export function FormAssociated(Base) {
          */
         updateValidity() {
             if (this.required && this._value === '') {
-                this.internals.setValidity({ valueMissing: true }, 'Please fill out this field.');
+                this[SET_ANCHORED_VALIDITY]({ valueMissing: true }, 'Please fill out this field.');
             }
             else {
-                this.internals.setValidity({});
+                this[SET_ANCHORED_VALIDITY]({});
             }
         }
         checkValidity() {
@@ -124,6 +160,9 @@ export function FormAssociated(Base) {
             // semantics) — previously this unconditionally blanked the field.
             this.value = this._defaultValue;
         }
+        formStateRestoreCallback(state, _mode) {
+            this.value = typeof state === 'string' ? state : '';
+        }
         /**
          * Called by the browser when an ancestor `<fieldset disabled>` toggles.
          * Tracked separately from the consumer's own `disabled` (see
@@ -145,3 +184,4 @@ export function FormAssociated(Base) {
     }
     return FormAssociatedElement;
 }
+//# sourceMappingURL=form-associated.js.map

package/dist/internal/form-associated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-associated.js","sourceRoot":"","sources":["../../src/internal/form-associated.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AA0BhC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAO;IAEP,MAAM,qBAAsB,SAAQ,IAAI;iBAC/B,mBAAc,GAAG,IAAI,AAAP,CAAQ;iBAEtB,eAAU,GAAG;YAClB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YACzC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC3B,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;YAC5D,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;SAC7D,AALgB,CAKf;QA8BF,YAAY,GAAG,IAAW;YACxB,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;YA1BT,sBAAiB,GAAG,KAAK,CAAC;YAC1B,cAAS,GAAG,KAAK,CAAC;YAE1B,wEAAwE;YACxE,sEAAsE;YACtE,kEAAkE;YAClE,sEAAsE;YACtE,iEAAiE;YACjE,yCAAyC;YACjC,UAAK,GAAG,EAAE,CAAC;YAEX,WAAM,GAAG,EAAE,CAAC;YACpB,qEAAqE;YACrE,mEAAmE;YACnE,mEAAmE;YACnE,8DAA8D;YAC9D,4DAA4D;YAC5D,kEAAkE;YAClE,kEAAkE;YAClE,qEAAqE;YACrE,+DAA+D;YACvD,kBAAa,GAAG,EAAE,CAAC;YAEnB,cAAS,GAAG,KAAK,CAAC;YAIxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACxC,IAAI,CAAC,kBAAkB,GAAG,IAAI,0BAA0B,CACtD,IAAI,EACJ,IAAI,CAAC,SAAS,EACd,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAC9B,CAAC;YACF,wEAAwE;YACxE,qEAAqE;YACrE,iDAAiD;YACjD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,MAAM;YACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,IAAI,QAAQ;YACV,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;QACjC,CAAC;QAED,IAAI,iBAAiB;YACnB,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;QAC1C,CAAC;QAED,IAAI,YAAY;YACd,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;QACrC,CAAC;QAED,gBAAgB;QAChB,CAAC,eAAe,CAAC;YACf,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,CACnC,uFAAuF,CACxF,IAAI,IAAI,CAAC;QACZ,CAAC;QAED,gBAAgB;QAChB,CAAC,qBAAqB,CAAC,CAAC,KAAyB,EAAE,OAAO,GAAG,EAAE;YAC7D,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,IAAI,IAAI,CAAC,IAAY;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,KAAK;YACP,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,KAAK,CAAC,IAAY;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,QAAQ;YACV,OAAO,IAAI,CAAC,SAAS,CAAC;QACxB,CAAC;QAED,IAAI,QAAQ,CAAC,IAAa;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/B,kEAAkE;YAClE,uEAAuE;YACvE,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACjD,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,QAAQ;YACV,OAAO,IAAI,CAAC,SAAS,CAAC;QACxB,CAAC;QAED,IAAI,QAAQ,CAAC,IAAa;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QAED;;oFAE4E;QAC5E,IAAI,iBAAiB;YACnB,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,iBAAiB,CAAC;QACjD,CAAC;QAED,wBAAwB,CAAC,IAAY,EAAE,GAAkB,EAAE,KAAoB;YAC7E,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrB,iEAAiE;gBACjE,gEAAgE;gBAChE,sDAAsD;gBACtD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;YACnC,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,YAAY,CAAC,IAAY;YACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED;;;;WAIG;QACO,cAAc;YACtB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;gBACxC,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,6BAA6B,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,aAAa;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;QACxC,CAAC;QAED,cAAc;YACZ,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QACzC,CAAC;QAED,iBAAiB;YACf,+DAA+D;YAC/D,kEAAkE;YAClE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC;QAClC,CAAC;QAED,wBAAwB,CACtB,KAAsC,EACtC,KAAkC;YAElC,IAAI,CAAC,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;QAED;;;;;;WAMG;QACH,oBAAoB,CAAC,gBAAyB;YAC5C,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;YAC1C,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;QAED,iBAAiB;YACf,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,mEAAmE;YACnE,kEAAkE;YAClE,iBAAiB;YACjB,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;KACF;IAED,OAAO,qBAA4E,CAAC;AACtF,CAAC"}

package/dist/internal/group-by-recency.d.ts

@@ -48,3 +48,4 @@ export interface RecencyBucket<T> {
  * is the more honest home for it than the newest one.
  */
 export declare function groupByRecency<T>(items: T[], options?: GroupByRecencyOptions<T>): RecencyBucket<T>[];
+//# sourceMappingURL=group-by-recency.d.ts.map

package/dist/internal/group-by-recency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-recency.d.ts","sourceRoot":"","sources":["../../src/internal/group-by-recency.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC;;;;;oEAKgE;IAChE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD;;;qEAGiE;IACjE,GAAG,CAAC,EAAE,IAAI,CAAC;IACX;2CACuC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,GAAE,qBAAqB,CAAC,CAAC,CAAM,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CA6CxG"}

package/dist/internal/group-by-recency.js

@@ -78,3 +78,4 @@ export function groupByRecency(items, options = {}) {
         buckets.push({ label: labels.older, items: older });
     return buckets;
 }
+//# sourceMappingURL=group-by-recency.js.map

package/dist/internal/group-by-recency.js.map

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

package/dist/internal/icons.d.ts

@@ -11,3 +11,4 @@ export declare function pauseIcon(): SVGTemplateResult;
 export declare function calendarIcon(): SVGTemplateResult;
 /** A four-corner "expand to fullscreen" glyph. */
 export declare function expandIcon(): SVGTemplateResult;
+//# sourceMappingURL=icons.d.ts.map

package/dist/internal/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/internal/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,iBAAiB,EAAE,MAAM,KAAK,CAAC;AAqClD,yFAAyF;AACzF,wBAAgB,WAAW,IAAI,iBAAiB,CAE/C;AAED,gCAAgC;AAChC,wBAAgB,SAAS,IAAI,iBAAiB,CAK7C;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,IAAI,iBAAiB,CAE5C;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,IAAI,iBAAiB,CAK7C;AAED,oEAAoE;AACpE,wBAAgB,YAAY,IAAI,iBAAiB,CAOhD;AAED,kDAAkD;AAClD,wBAAgB,UAAU,IAAI,iBAAiB,CAO9C"}

package/dist/internal/icons.js

@@ -71,3 +71,4 @@ export function expandIcon() {
     <line x1="3" y1="21" x2="10" y2="14"></line>
   `);
 }
+//# sourceMappingURL=icons.js.map

package/dist/internal/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/internal/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAA0B,MAAM,KAAK,CAAC;AAElD;;;;;;;;;;;;;GAaG;AAEH,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,SAAS,IAAI,CAAC,KAAwB;IACpC,OAAO,GAAG,CAAA;;;;gBAII,QAAQ;;;qBAGH,YAAY;;;;;OAK1B,KAAK;GACT,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,GAAG,CAAA,+CAA+C,CAAC,CAAC;AAClE,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,GAAG,CAAA;;;GAGd,CAAC,CAAC;AACL,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,CAAC,GAAG,CAAA,iDAAiD,CAAC,CAAC;AACpE,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,GAAG,CAAA;;;GAGd,CAAC,CAAC;AACL,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,GAAG,CAAA;;;;;GAKd,CAAC,CAAC;AACL,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,GAAG,CAAA;;;;;GAKd,CAAC,CAAC;AACL,CAAC"}

package/dist/internal/localization.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The message keys used by Lyra's built-in labels. Applications can register
+ * additional keys as well; components may use a component-specific key when
+ * a message is not part of this common set.
+ */
+export type LyraMessageKey = 'noData' | 'noColumns' | 'loadMore' | 'showAllColumns' | 'showFewerColumns' | 'clear' | 'openCalendar' | 'open' | 'close' | 'closeNavigation' | 'openNavigation' | 'resizeNavigation' | 'copy' | 'copyJson' | 'copied' | 'expand' | 'collapse' | 'expandMessage' | 'collapseMessage' | 'showMore' | 'showLess' | 'retry' | 'remove' | 'loading' | 'loadingDocument' | 'noMatches' | 'previous' | 'next' | 'cancel' | 'confirm' | 'search' | 'circularReference' | 'items' | 'item' | 'keys' | 'key' | 'trendOf' | 'wordCloud';
+export type LyraLocaleStrings = Partial<Record<LyraMessageKey, string>> & Record<string, string | undefined>;
+/** Register or extend messages for a locale. */
+export declare function registerLyraLocale(locale: string, strings: LyraLocaleStrings): void;
+/** Set the page-level locale used by Lyra components without an explicit locale. */
+export declare function setLyraLocale(locale: string): void;
+/** Return the current page-level locale. */
+export declare function getLyraLocale(): string;
+/** Subscribe to locale changes. The returned function is safe to call repeatedly. */
+export declare function subscribeLyraLocale(listener: () => void): () => void;
+/** Resolve the locale inherited by a component host. */
+export declare function resolveLyraLocale(host: Element): string;
+/** Resolve the direction inherited by a component host. */
+export declare function resolveLyraDirection(host: Element): 'ltr' | 'rtl';
+/**
+ * Resolve a message for a component. An explicit per-component override wins,
+ * followed by a non-empty component property fallback, registered locale
+ * messages, and finally the built-in English message.
+ */
+export declare function resolveLyraString(host: Element, key: string, overrides?: LyraLocaleStrings, fallback?: string, values?: Record<string, string | number>): string;
+export declare const LYRA_DEFAULT_STRINGS: Record<LyraMessageKey, string>;
+//# sourceMappingURL=localization.d.ts.map

package/dist/internal/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../src/internal/localization.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,kBAAkB,GAClB,OAAO,GACP,cAAc,GACd,MAAM,GACN,OAAO,GACP,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,eAAe,GACf,iBAAiB,GACjB,UAAU,GACV,UAAU,GACV,OAAO,GACP,QAAQ,GACR,SAAS,GACT,iBAAiB,GACjB,WAAW,GACX,UAAU,GACV,MAAM,GACN,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,mBAAmB,GACnB,OAAO,GACP,MAAM,GACN,MAAM,GACN,KAAK,GACL,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAiE7G,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAKnF;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKlD;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGpE;AAiBD,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,iBAAiB,EAC7B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,MAAM,CAeR;AAED,eAAO,MAAM,oBAAoB,gCAAkB,CAAC"}

package/dist/internal/localization.js

@@ -0,0 +1,141 @@
+const DEFAULT_STRINGS = {
+    noData: 'No data',
+    noColumns: 'No columns configured',
+    loadMore: 'Load more',
+    showAllColumns: 'Show all columns',
+    showFewerColumns: 'Show fewer columns',
+    clear: 'Clear',
+    openCalendar: 'Open calendar',
+    open: 'Open',
+    close: 'Close',
+    closeNavigation: 'Close navigation',
+    openNavigation: 'Open navigation',
+    resizeNavigation: 'Resize navigation',
+    copy: 'Copy',
+    copyJson: 'Copy JSON to clipboard',
+    copied: 'Copied!',
+    expand: 'Expand',
+    collapse: 'Collapse',
+    expandMessage: 'Expand message',
+    collapseMessage: 'Collapse message',
+    showMore: 'Show more',
+    showLess: 'Show less',
+    retry: 'Retry',
+    remove: 'Remove',
+    loading: 'Loading…',
+    loadingDocument: 'Loading document…',
+    noMatches: 'No matches',
+    previous: 'Previous',
+    next: 'Next',
+    cancel: 'Cancel',
+    confirm: 'Confirm',
+    search: 'Search',
+    circularReference: 'Circular reference',
+    items: 'items',
+    item: 'item',
+    keys: 'keys',
+    key: 'key',
+    trendOf: 'Trend of {count} values, last {value}',
+    wordCloud: 'Word cloud of {count} {word}',
+};
+const locales = new Map();
+const listeners = new Set();
+let activeLocale = '';
+function normalizeLocale(locale) {
+    return locale.trim().replace(/_/g, '-').toLowerCase();
+}
+function localeCandidates(locale) {
+    const normalized = normalizeLocale(locale);
+    const candidates = [];
+    if (normalized)
+        candidates.push(normalized);
+    const language = normalized.split('-')[0];
+    if (language && language !== normalized)
+        candidates.push(language);
+    if (!candidates.includes('en'))
+        candidates.push('en');
+    return candidates;
+}
+function notify() {
+    for (const listener of [...listeners])
+        listener();
+}
+/** Register or extend messages for a locale. */
+export function registerLyraLocale(locale, strings) {
+    const key = normalizeLocale(locale);
+    if (!key)
+        throw new TypeError('A locale is required.');
+    locales.set(key, { ...(locales.get(key) ?? {}), ...strings });
+    if (normalizeLocale(activeLocale) === key || normalizeLocale(activeLocale).startsWith(`${key}-`))
+        notify();
+}
+/** Set the page-level locale used by Lyra components without an explicit locale. */
+export function setLyraLocale(locale) {
+    const next = locale.trim();
+    if (activeLocale === next)
+        return;
+    activeLocale = next;
+    notify();
+}
+/** Return the current page-level locale. */
+export function getLyraLocale() {
+    return activeLocale;
+}
+/** Subscribe to locale changes. The returned function is safe to call repeatedly. */
+export function subscribeLyraLocale(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+function inheritedLocale(host) {
+    const explicit = host.getAttribute('locale') || host.getAttribute('lang');
+    if (explicit)
+        return explicit;
+    let parent = host.parentElement;
+    while (parent) {
+        const locale = parent.getAttribute('locale') || parent.getAttribute('lang');
+        if (locale)
+            return locale;
+        parent = parent.parentElement;
+    }
+    if (typeof document !== 'undefined') {
+        return document.documentElement.getAttribute('lang') || activeLocale || 'en';
+    }
+    return activeLocale || 'en';
+}
+/** Resolve the locale inherited by a component host. */
+export function resolveLyraLocale(host) {
+    return inheritedLocale(host);
+}
+/** Resolve the direction inherited by a component host. */
+export function resolveLyraDirection(host) {
+    const explicit = host.getAttribute('dir');
+    if (explicit === 'rtl' || explicit === 'ltr')
+        return explicit;
+    if (typeof getComputedStyle === 'function')
+        return getComputedStyle(host).direction === 'rtl' ? 'rtl' : 'ltr';
+    return 'ltr';
+}
+/**
+ * Resolve a message for a component. An explicit per-component override wins,
+ * followed by a non-empty component property fallback, registered locale
+ * messages, and finally the built-in English message.
+ */
+export function resolveLyraString(host, key, overrides, fallback, values) {
+    const own = overrides?.[key];
+    let message = own ?? fallback;
+    if (message === undefined) {
+        for (const candidate of localeCandidates(resolveLyraLocale(host))) {
+            const registered = locales.get(candidate)?.[key];
+            if (registered !== undefined) {
+                message = registered;
+                break;
+            }
+        }
+    }
+    message ??= DEFAULT_STRINGS[key] ?? key;
+    if (!values)
+        return message;
+    return message.replace(/\{(\w+)\}/g, (_match, name) => String(values[name] ?? `{${name}}`));
+}
+export const LYRA_DEFAULT_STRINGS = DEFAULT_STRINGS;
+//# sourceMappingURL=localization.js.map

package/dist/internal/localization.js.map

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

package/dist/internal/lyra-element.d.ts

@@ -1,11 +1,35 @@
 import { LitElement, type CSSResultGroup } from 'lit';
+import { type LyraLocaleStrings } from './localization.js';
+export interface LyraEmitOptions {
+    /** Set only for events whose listener may veto an operation before it runs. */
+    cancelable?: boolean;
+}
+export type LyraEventMap = Record<string, Event>;
 /**
  * Shared base for every Lyra component. Supplies the design-token layer
  * (Web Awesome `--wa-*` tokens with `--lyra-*` fallbacks). RTL is handled by
  * components using CSS logical properties rather than a forced `dir`.
  */
-export declare class LyraElement extends LitElement {
+export declare class LyraElement<Events = LyraEventMap> extends LitElement {
     static styles: CSSResultGroup;
-    /** Dispatch a composed, bubbling `lyra-*` custom event. */
-    protected emit<T = unknown>(name: string, detail?: T): CustomEvent<T>;
+    /** Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used. */
+    locale: string;
+    /** Per-instance message overrides, useful for application-specific wording. */
+    strings: LyraLocaleStrings;
+    private stopLocaleSubscription?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Resolve a localized message using this component's overrides and locale. */
+    protected localize(key: string, fallback?: string, values?: Record<string, string | number>): string;
+    /** The effective locale used by this component. */
+    protected get effectiveLocale(): string;
+    /** The effective text direction, including inherited CSS direction. */
+    protected get effectiveDirection(): 'ltr' | 'rtl';
+    addEventListener<K extends keyof Events & string>(type: K, listener: (this: this, event: Events[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof Events & string>(type: K, listener: (this: this, event: Events[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    /** Dispatch a composed, bubbling custom event; notifications are not veto points by default. */
+    protected emit<T = unknown>(name: string, detail?: T, options?: LyraEmitOptions): CustomEvent<T>;
 }
+//# sourceMappingURL=lyra-element.d.ts.map