@fluentui/web-components 3.0.0-beta.11 → 3.0.0-beta.111

package/dist/esm/utils/behaviors/match-media-stylesheet-behavior.d.ts

@@ -0,0 +1,124 @@
+import type { ElementStyles, HostBehavior, HostController } from '@microsoft/fast-element';
+/**
+ * An event listener fired by a {@link https://developer.mozilla.org/en-US/docs/Web/API/MediaQueryList | MediaQueryList }.
+ * @public
+ */
+export type MediaQueryListListener = (this: MediaQueryList, ev?: MediaQueryListEvent) => void;
+/**
+ * An abstract behavior to react to media queries. Implementations should implement
+ * the `constructListener` method to perform some action based on media query changes.
+ *
+ * @public
+ */
+export declare abstract class MatchMediaBehavior implements HostBehavior {
+    /**
+     * The behavior needs to operate on element instances but elements might share a behavior instance.
+     * To ensure proper attachment / detachment per instance, we construct a listener for
+     * each bind invocation and cache the listeners by element reference.
+     */
+    private listenerCache;
+    /**
+     * The media query that the behavior operates on.
+     */
+    readonly query: MediaQueryList;
+    /**
+     *
+     * @param query - The media query to operate from.
+     */
+    constructor(query: MediaQueryList);
+    /**
+     * Constructs a function that will be invoked with the MediaQueryList context
+     * @param controller - The host controller orchestrating this behavior.
+     */
+    protected abstract constructListener(controller: HostController): MediaQueryListListener;
+    /**
+     * Binds the behavior to the element.
+     * @param controller - The host controller orchestrating this behavior.
+     */
+    connectedCallback(controller: HostController): void;
+    /**
+     * Unbinds the behavior from the element.
+     * @param controller - The host controller orchestrating this behavior.
+     */
+    disconnectedCallback(controller: HostController): void;
+}
+/**
+ * A behavior to add or remove a stylesheet from an element based on a media query. The behavior ensures that
+ * styles are applied while the a query matches the environment and that styles are not applied if the query does
+ * not match the environment.
+ *
+ * @public
+ */
+export declare class MatchMediaStyleSheetBehavior extends MatchMediaBehavior {
+    /**
+     * The media query that the behavior operates on.
+     */
+    readonly query: MediaQueryList;
+    /**
+     * The styles object to be managed by the behavior.
+     */
+    readonly styles: ElementStyles;
+    /**
+     * Constructs a {@link MatchMediaStyleSheetBehavior} instance.
+     * @param query - The media query to operate from.
+     * @param styles - The styles to coordinate with the query.
+     */
+    constructor(query: MediaQueryList, styles: ElementStyles);
+    /**
+     * Defines a function to construct {@link MatchMediaStyleSheetBehavior | MatchMediaStyleSheetBehaviors} for
+     * a provided query.
+     * @param query - The media query to operate from.
+     *
+     * @public
+     * @example
+     *
+     * ```ts
+     * import { css } from "@microsoft/fast-element";
+     * import { MatchMediaStyleSheetBehavior } from "@fluentui/web-components";
+     *
+     * const landscapeBehavior = MatchMediaStyleSheetBehavior.with(
+     *   window.matchMedia("(orientation: landscape)")
+     * );
+     *
+     * const styles = css`
+     *   :host {
+     *     width: 200px;
+     *     height: 400px;
+     *   }
+     * `
+     * .withBehaviors(landscapeBehavior(css`
+     *   :host {
+     *     width: 400px;
+     *     height: 200px;
+     *   }
+     * `))
+     * ```
+     */
+    static with(query: MediaQueryList): (styles: ElementStyles) => MatchMediaStyleSheetBehavior;
+    /**
+     * Constructs a match-media listener for a provided element.
+     * @param source - the element for which to attach or detach styles.
+     */
+    protected constructListener(controller: HostController): MediaQueryListListener;
+    /**
+     * Unbinds the behavior from the element.
+     * @param controller - The host controller orchestrating this behavior.
+     * @internal
+     */
+    removedCallback(controller: HostController<any>): void;
+}
+/**
+ * This can be used to construct a behavior to apply a forced-colors only stylesheet.
+ * @public
+ */
+export declare const forcedColorsStylesheetBehavior: (styles: ElementStyles) => MatchMediaStyleSheetBehavior;
+/**
+ * This can be used to construct a behavior to apply a prefers color scheme: dark only stylesheet.
+ * @public
+ */
+export declare const darkModeStylesheetBehavior: (styles: ElementStyles) => MatchMediaStyleSheetBehavior;
+/**
+ * This can be used to construct a behavior to apply a prefers color scheme: light only stylesheet.
+ * @public
+ */
+export declare const lightModeStylesheetBehavior: (styles: ElementStyles) => MatchMediaStyleSheetBehavior;

package/dist/esm/utils/behaviors/match-media-stylesheet-behavior.js.map

@@ -1 +1 @@
-{"version":3,"file":"match-media-stylesheet-behavior.js","sourceRoot":"","sources":["../../../../src/utils/behaviors/match-media-stylesheet-behavior.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,OAAgB,kBAAkB;IAatC;;;OAGG;IACH,YAAY,KAAqB;QAhBjC;;;;WAIG;QACK,kBAAa,GAAG,IAAI,OAAO,EAA0C,CAAC;QAY5E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAQD;;;OAGG;IACH,iBAAiB,CAAC,UAA0B;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElD,IAAI,CAAC,QAAQ,EAAE;YACb,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;SAC9C;QAED,2DAA2D;QAC3D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,oBAAoB,CAAC,UAA0B;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,QAAQ,EAAE;YACZ,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SACpD;IACH,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,4BAA6B,SAAQ,kBAAkB;IAWlE;;;;OAIG;IACH,YAAY,KAAqB,EAAE,MAAqB;QACtD,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACI,MAAM,CAAC,IAAI,CAAC,KAAqB;QACtC,OAAO,CAAC,MAAqB,EAAE,EAAE;YAC/B,OAAO,IAAI,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACO,iBAAiB,CAAC,UAA0B;QACpD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,OAAO,SAAS,QAAQ;YACtB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;YAEzB,IAAI,OAAO,IAAI,CAAC,QAAQ,EAAE;gBACxB,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAC7B,QAAQ,GAAG,OAAO,CAAC;aACpB;iBAAM,IAAI,CAAC,OAAO,IAAI,QAAQ,EAAE;gBAC/B,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBAChC,QAAQ,GAAG,OAAO,CAAC;aACpB;QACH,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,UAA+B;QACpD,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEtH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC,IAAI,CACzE,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAClD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,4BAA4B,CAAC,IAAI,CAC1E,MAAM,CAAC,UAAU,CAAC,+BAA+B,CAAC,CACnD,CAAC"}
+{"version":3,"file":"match-media-stylesheet-behavior.js","sourceRoot":"","sources":["../../../../src/utils/behaviors/match-media-stylesheet-behavior.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/benchmark-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark-wrapper.js","sourceRoot":"","sources":["../../../src/utils/benchmark-wrapper.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,WAAW,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE;IAC3C,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE7B,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAS,EAAE,EAAE;QACrC,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;CACH;AAED,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,CAAC"}
+{"version":3,"file":"benchmark-wrapper.js","sourceRoot":"","sources":["../../../src/utils/benchmark-wrapper.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,cAAc;AACd,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,WAAW,GAAG,CAAC,IAAS,EAAE,IAAS,EAAE,EAAE;IAC3C,QAAQ,CAAC,aAAa,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE7B,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAS,EAAE,EAAE;QACrC,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,YAAY,IAAI,KAAK,EAAE,CAAC"}

package/dist/esm/utils/converters.d.ts

@@ -0,0 +1,17 @@
+import type { ValueConverter } from '@microsoft/fast-element';
+/**
+ * A {@link ValueConverter} that makes sure the attribute and property values
+ * are a string representation of a number, e.g. `'10'` instead of `10`.
+ *
+ * @remarks
+ * This converter allows any data type, but if the data is evaluated as `NaN`
+ * by `Number.isNaN()`, it’d be converted to an empty string. Otherwise, the
+ * converted value is a string of number.
+ *
+ * It is useful for somm  custom element’s attributes and properties, e.g.
+ * `min`, `max`, `step` on an `<input type=range>`-like element, to align with
+ * the built-in HTML element behavior, those property values should be strings.
+ *
+ * @public
+ */
+export declare const numberLikeStringConverter: ValueConverter;

package/dist/esm/utils/converters.js

@@ -0,0 +1,26 @@
+/**
+ * A {@link ValueConverter} that makes sure the attribute and property values
+ * are a string representation of a number, e.g. `'10'` instead of `10`.
+ *
+ * @remarks
+ * This converter allows any data type, but if the data is evaluated as `NaN`
+ * by `Number.isNaN()`, it’d be converted to an empty string. Otherwise, the
+ * converted value is a string of number.
+ *
+ * It is useful for somm  custom element’s attributes and properties, e.g.
+ * `min`, `max`, `step` on an `<input type=range>`-like element, to align with
+ * the built-in HTML element behavior, those property values should be strings.
+ *
+ * @public
+ */
+export const numberLikeStringConverter = {
+    fromView(value) {
+        const valueAsNumber = parseFloat(value);
+        return Number.isNaN(valueAsNumber) ? '' : valueAsNumber.toString();
+    },
+    toView(value) {
+        const valueAsNumber = parseFloat(value);
+        return Number.isNaN(valueAsNumber) ? undefined : valueAsNumber.toString();
+    },
+};
+//# sourceMappingURL=converters.js.map

package/dist/esm/utils/converters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.js","sourceRoot":"","sources":["../../../src/utils/converters.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,QAAQ,CAAC,KAAa;QACpB,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,CAAC,KAAU;QACf,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;IAC5E,CAAC;CACF,CAAC"}

package/dist/esm/utils/direction.js

@@ -9,7 +9,6 @@ import { Direction } from '@microsoft/fast-web-utilities';
  * @public
  */
 export const getDirection = (rootNode) => {
-    var _a;
-    return ((_a = rootNode.closest('[dir]')) === null || _a === void 0 ? void 0 : _a.dir) === 'rtl' ? Direction.rtl : Direction.ltr;
+    return rootNode.closest('[dir]')?.dir === 'rtl' ? Direction.rtl : Direction.ltr;
 };
 //# sourceMappingURL=direction.js.map

package/dist/esm/utils/direction.js.map

@@ -1 +1 @@
-{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../src/utils/direction.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAqB,EAAa,EAAE;;IAC/D,OAAO,CAAA,MAAA,QAAQ,CAAC,OAAO,CAAc,OAAO,CAAC,0CAAE,GAAG,MAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;AAC/F,CAAC,CAAC"}
+{"version":3,"file":"direction.js","sourceRoot":"","sources":["../../../src/utils/direction.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAqB,EAAa,EAAE;IAC/D,OAAO,QAAQ,CAAC,OAAO,CAAc,OAAO,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;AAC/F,CAAC,CAAC"}

package/dist/esm/utils/display.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Define all possible CSS display values.
+ * @public
+ */
+export type CSSDisplayPropertyValue = 'block' | 'contents' | 'flex' | 'grid' | 'inherit' | 'initial' | 'inline' | 'inline-block' | 'inline-flex' | 'inline-grid' | 'inline-table' | 'list-item' | 'none' | 'run-in' | 'table' | 'table-caption' | 'table-cell' | 'table-column' | 'table-column-group' | 'table-footer-group' | 'table-header-group' | 'table-row' | 'table-row-group';
+/**
+ * A CSS fragment to set `display: none;` when the host is hidden using the [hidden] attribute.
+ * @public
+ */
+export declare const hidden = ":host([hidden]){display:none}";
+/**
+ * Applies a CSS display property.
+ * Also adds CSS rules to not display the element when the [hidden] attribute is applied to the element.
+ * @param display - The CSS display property value
+ * @public
+ */
+export declare function display(displayValue: CSSDisplayPropertyValue): string;

package/dist/esm/utils/element-internals.d.ts

@@ -0,0 +1,54 @@
+import { CustomStatesSetSupported } from './support.js';
+/**
+ * Inference type for a CSS custom state selector.
+ * @public
+ */
+export type StateSelector<S> = S extends string ? `:state(${S})` | `[state--${S}]` : never;
+export { CustomStatesSetSupported };
+/**
+ * Returns a string that represents a CSS custom state selector.
+ *
+ * @param state - the state value.
+ * @returns a string that represents a CSS state selector, or a custom attribute selector if the browser does not
+ * support Custom States.
+ *
+ * @public
+ */
+export declare function stateSelector<S extends string>(state: S): StateSelector<S>;
+/**
+ * This function is used to toggle a state on the control. If the browser supports Custom States, the state is toggled
+ * on the `ElementInternals.states` set. If the browser does not support Custom States, the state is toggled on the host
+ * element as an attribute with the format `state--{state}`.
+ *
+ * @see The {@link https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet | CustomStateSet} interface
+ * @see The {@link https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals | ElementInternals} interface
+ * @see The CSS {@link https://developer.mozilla.org/en-US/docs/Web/CSS/:state | `:state()`} pseudo-class
+ *
+ * @param elementInternals - the `ElementInternals` instance for the component
+ * @param state - the state to toggle
+ * @param force - force the state to be toggled on or off
+ * @internal
+ */
+export declare function toggleState(elementInternals: ElementInternals | undefined, state: string | undefined, force?: boolean): void;
+/**
+ * Check if a given attribute value is a valid state. Attribute values are often kebab-cased, so this function converts
+ * the kebab-cased `state` to camelCase and checks if it exists in as a key in the `States` object.
+ *
+ * @param States  - the object containing valid states for the attribute
+ * @param state - the state to check
+ * @returns true if the state is in the States object
+ * @internal
+ */
+export declare function hasMatchingState(States: Record<string, string> | undefined, state: string | undefined): boolean;
+/**
+ * Swap an old state for a new state.
+ *
+ * @param elementInternals - the `ElementInternals` instance for the component
+ * @param prev - the previous state to remove
+ * @param next - the new state to add
+ * @param States - the object containing valid states for the attribute
+ * @param prefix - an optional prefix to add to the state
+ *
+ * @internal
+ */
+export declare function swapStates(elementInternals: ElementInternals, prev?: string | undefined, next?: string | undefined, States?: Record<string, string>, prefix?: string): void;

package/dist/esm/utils/element-internals.js

@@ -0,0 +1,96 @@
+import { CustomStatesSetSupported } from './support.js';
+export { CustomStatesSetSupported };
+/**
+ * Map to store the state values.
+ * @internal
+ */
+const statesMap = new Map();
+/**
+ * Returns a string that represents a CSS custom state selector.
+ *
+ * @param state - the state value.
+ * @returns a string that represents a CSS state selector, or a custom attribute selector if the browser does not
+ * support Custom States.
+ *
+ * @public
+ */
+export function stateSelector(state) {
+    return (statesMap.get(state) ??
+        statesMap
+            .set(state, CustomStatesSetSupported ? `:state(${state})` : `[state--${state}]`)
+            .get(state));
+}
+/**
+ * This function is used to toggle a state on the control. If the browser supports Custom States, the state is toggled
+ * on the `ElementInternals.states` set. If the browser does not support Custom States, the state is toggled on the host
+ * element as an attribute with the format `state--{state}`.
+ *
+ * @see The {@link https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet | CustomStateSet} interface
+ * @see The {@link https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals | ElementInternals} interface
+ * @see The CSS {@link https://developer.mozilla.org/en-US/docs/Web/CSS/:state | `:state()`} pseudo-class
+ *
+ * @param elementInternals - the `ElementInternals` instance for the component
+ * @param state - the state to toggle
+ * @param force - force the state to be toggled on or off
+ * @internal
+ */
+export function toggleState(elementInternals, state, force) {
+    if (!state || !elementInternals) {
+        return;
+    }
+    if (!CustomStatesSetSupported) {
+        elementInternals.shadowRoot.host.toggleAttribute(`state--${state}`, force);
+        return;
+    }
+    // @ts-expect-error - Baseline 2024
+    if (force ?? !elementInternals.states.has(state)) {
+        // @ts-expect-error - Baseline 2024
+        elementInternals.states.add(state);
+        return;
+    }
+    // @ts-expect-error - Baseline 2024
+    elementInternals.states.delete(state);
+}
+/**
+ * A weak map to store the valid states for attributes.
+ * @internal
+ */
+const matchingStateMap = new WeakMap();
+/**
+ * Check if a given attribute value is a valid state. Attribute values are often kebab-cased, so this function converts
+ * the kebab-cased `state` to camelCase and checks if it exists in as a key in the `States` object.
+ *
+ * @param States  - the object containing valid states for the attribute
+ * @param state - the state to check
+ * @returns true if the state is in the States object
+ * @internal
+ */
+export function hasMatchingState(States, state) {
+    if (!States || !state) {
+        return false;
+    }
+    if (matchingStateMap.has(States)) {
+        return matchingStateMap.get(States).has(state);
+    }
+    const stateSet = new Set(Object.values(States));
+    matchingStateMap.set(States, stateSet);
+    return stateSet.has(state);
+}
+/**
+ * Swap an old state for a new state.
+ *
+ * @param elementInternals - the `ElementInternals` instance for the component
+ * @param prev - the previous state to remove
+ * @param next - the new state to add
+ * @param States - the object containing valid states for the attribute
+ * @param prefix - an optional prefix to add to the state
+ *
+ * @internal
+ */
+export function swapStates(elementInternals, prev = '', next = '', States, prefix = '') {
+    toggleState(elementInternals, `${prefix}${prev}`, false);
+    if (!States || hasMatchingState(States, next)) {
+        toggleState(elementInternals, `${prefix}${next}`, true);
+    }
+}
+//# sourceMappingURL=element-internals.js.map

package/dist/esm/utils/element-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-internals.js","sourceRoot":"","sources":["../../../src/utils/element-internals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAQxD,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC;;;GAGG;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;AAE3D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAmB,KAAQ;IACtD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAC1B,SAAS;aACN,GAAG,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC;aAC/E,GAAG,CAAC,KAAK,CAAC,CAAqB,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CACzB,gBAA8C,EAC9C,KAAyB,EACzB,KAAe;IAEf,IAAI,CAAC,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,gBAAgB,CAAC,UAAW,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IACD,mCAAmC;IACnC,IAAI,KAAK,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,mCAAmC;QACnC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,mCAAmC;IACnC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAuC,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA0C,EAAE,KAAyB;IACpG,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,gBAAkC,EAClC,OAA2B,EAAE,EAC7B,OAA2B,EAAE,EAC7B,MAA+B,EAC/B,SAAiB,EAAE;IAEnB,WAAW,CAAC,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IAEzD,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9C,WAAW,CAAC,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}

package/dist/esm/utils/focusable-element.d.ts

@@ -0,0 +1,3 @@
+export declare const isARIADisabledElement: (el: Element) => boolean;
+export declare const isHiddenElement: (el: Element) => boolean;
+export declare const isFocusableElement: (el: Element) => boolean;

package/dist/esm/utils/focusable-element.js

@@ -0,0 +1,10 @@
+export const isARIADisabledElement = (el) => {
+    return el.getAttribute('aria-disabled') === 'true';
+};
+export const isHiddenElement = (el) => {
+    return el.hasAttribute('hidden');
+};
+export const isFocusableElement = (el) => {
+    return !isARIADisabledElement(el) && !isHiddenElement(el);
+};
+//# sourceMappingURL=focusable-element.js.map

package/dist/esm/utils/focusable-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusable-element.js","sourceRoot":"","sources":["../../../src/utils/focusable-element.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EAAW,EAAW,EAAE;IAC5D,OAAO,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,KAAK,MAAM,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAW,EAAW,EAAE;IACtD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAW,EAAW,EAAE;IACzD,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC,CAAC"}

package/dist/esm/utils/get-initials.js

@@ -75,9 +75,9 @@ export function getInitials(displayName, isRtl, options) {
     displayName = cleanupDisplayName(displayName);
     // For names containing CJK characters, and phone numbers, we don't display initials
     if (UNSUPPORTED_TEXT_REGEX.test(displayName) ||
-        (!(options === null || options === void 0 ? void 0 : options.allowPhoneInitials) && PHONENUMBER_REGEX.test(displayName))) {
+        (!options?.allowPhoneInitials && PHONENUMBER_REGEX.test(displayName))) {
         return '';
     }
-    return getInitialsLatin(displayName, isRtl, options === null || options === void 0 ? void 0 : options.firstInitialOnly);
+    return getInitialsLatin(displayName, isRtl, options?.firstInitialOnly);
 }
 //# sourceMappingURL=get-initials.js.map

package/dist/esm/utils/get-initials.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-initials.js","sourceRoot":"","sources":["../../../src/utils/get-initials.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE;;GAEG;AAEH;;;GAGG;AACH,MAAM,yBAAyB,GAAW,6BAA6B,CAAC;AAExE;;;GAGG;AACH,4CAA4C;AAC5C,MAAM,oBAAoB,GAAW,4DAA4D,CAAC;AAElG;;;GAGG;AACH,MAAM,iBAAiB,GAAW,+BAA+B,CAAC;AAElE,sDAAsD;AACtD,MAAM,0BAA0B,GAAW,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,2BAA2B;AAC3B,MAAM,sBAAsB,GAAW,4MAA4M,CAAC;AAEpP,SAAS,gBAAgB,CAAC,WAAmB,EAAE,KAAc,EAAE,gBAA0B;IACvF,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,MAAM,MAAM,GAAa,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACvB,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;KAC/C;IAED,IAAI,CAAC,gBAAgB,EAAE;QACrB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;YACvB,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC/C;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC/C;KACF;IAED,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QAChC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAChD;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACjE,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC5D,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IACnE,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAEjC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,WAAsC,EACtC,KAAc,EACd,OAMC;IAED,IAAI,CAAC,WAAW,EAAE;QAChB,OAAO,EAAE,CAAC;KACX;IAED,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE9C,oFAAoF;IACpF,IACE,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,kBAAkB,CAAA,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EACrE;QACA,OAAO,EAAE,CAAC;KACX;IAED,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,gBAAgB,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"get-initials.js","sourceRoot":"","sources":["../../../src/utils/get-initials.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE;;GAEG;AAEH;;;GAGG;AACH,MAAM,yBAAyB,GAAW,6BAA6B,CAAC;AAExE;;;GAGG;AACH,4CAA4C;AAC5C,MAAM,oBAAoB,GAAW,4DAA4D,CAAC;AAElG;;;GAGG;AACH,MAAM,iBAAiB,GAAW,+BAA+B,CAAC;AAElE,sDAAsD;AACtD,MAAM,0BAA0B,GAAW,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,2BAA2B;AAC3B,MAAM,sBAAsB,GAC1B,4MAA4M,CAAC;AAE/M,SAAS,gBAAgB,CAAC,WAAmB,EAAE,KAAc,EAAE,gBAA0B;IACvF,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,MAAM,MAAM,GAAa,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB;IAC7C,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACjE,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC5D,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IACnE,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAEjC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,WAAsC,EACtC,KAAc,EACd,OAMC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE9C,oFAAoF;IACpF,IACE,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,EACrE,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACzE,CAAC"}

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './converters.js';
+export * from './direction.js';
+export * from './typings.js';
+export * from './template-helpers.js';
+export * from './whitespace-filter.js';
+export * from './display.js';
+export * from './behaviors/match-media-stylesheet-behavior.js';
+export * from './support.js';

package/dist/esm/utils/index.js

@@ -1,7 +1,9 @@
+export * from './converters.js';
 export * from './direction.js';
 export * from './typings.js';
 export * from './template-helpers.js';
 export * from './whitespace-filter.js';
 export * from './display.js';
 export * from './behaviors/match-media-stylesheet-behavior.js';
+export * from './support.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gDAAgD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,gDAAgD,CAAC;AAC/D,cAAc,cAAc,CAAC"}

package/dist/esm/utils/language.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Determines the current language code of an element.
+ *
+ * @param rootNode - the HTMLElement to begin the query from, usually "this" when used in a component controller
+ * @returns the language code of the element
+ *
+ * @public
+ */
+export declare function getLanguage(rootNode: HTMLElement): Intl.BCP47LanguageTag;

package/dist/esm/utils/language.js

@@ -0,0 +1,12 @@
+/**
+ * Determines the current language code of an element.
+ *
+ * @param rootNode - the HTMLElement to begin the query from, usually "this" when used in a component controller
+ * @returns the language code of the element
+ *
+ * @public
+ */
+export function getLanguage(rootNode) {
+    return rootNode.closest('[lang]')?.lang ?? 'en';
+}
+//# sourceMappingURL=language.js.map

package/dist/esm/utils/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../../src/utils/language.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAc,QAAQ,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;AAC/D,CAAC"}

package/dist/esm/utils/root-active-element.d.ts

@@ -0,0 +1 @@
+export declare function getRootActiveElement(element: Element): Element | null;

package/dist/esm/utils/root-active-element.js

@@ -0,0 +1,9 @@
+// returns the active element in the shadow context of the element in question.
+export function getRootActiveElement(element) {
+    const rootNode = element.getRootNode();
+    if (rootNode instanceof ShadowRoot) {
+        return rootNode.activeElement;
+    }
+    return document.activeElement;
+}
+//# sourceMappingURL=root-active-element.js.map

package/dist/esm/utils/root-active-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-active-element.js","sourceRoot":"","sources":["../../../src/utils/root-active-element.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,QAAQ,YAAY,UAAU,EAAE,CAAC;QACnC,OAAO,QAAQ,CAAC,aAAa,CAAC;IAChC,CAAC;IAED,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC"}

package/dist/esm/utils/support.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Check if the browser supports CSS Anchor Positioning.
+ * @public
+ */
+export declare const AnchorPositioningCSSSupported: boolean;
+/**
+ * Check if the browser supports HTML Anchor Positioning.
+ * @public
+ */
+export declare const AnchorPositioningHTMLSupported: boolean;
+/**
+ * Check if the browser supports Custom States.
+ * @public
+ */
+export declare const CustomStatesSetSupported: boolean;

package/dist/esm/utils/support.js

@@ -0,0 +1,16 @@
+/**
+ * Check if the browser supports CSS Anchor Positioning.
+ * @public
+ */
+export const AnchorPositioningCSSSupported = CSS.supports('anchor-name: --a');
+/**
+ * Check if the browser supports HTML Anchor Positioning.
+ * @public
+ */
+export const AnchorPositioningHTMLSupported = 'anchor' in HTMLElement.prototype;
+/**
+ * Check if the browser supports Custom States.
+ * @public
+ */
+export const CustomStatesSetSupported = CSS.supports('selector(:state(g))');
+//# sourceMappingURL=support.js.map

package/dist/esm/utils/support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support.js","sourceRoot":"","sources":["../../../src/utils/support.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,QAAQ,IAAI,WAAW,CAAC,SAAS,CAAC;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/esm/utils/template-helpers.d.ts

@@ -0,0 +1,15 @@
+import { type CaptureType, type HTMLDirective, type SyntheticViewTemplate } from '@microsoft/fast-element';
+/**
+ * A value that can be statically composed into a
+ * foundation template.
+ * @remarks
+ * When providing a string, take care to ensure that it is
+ * safe and will not enable an XSS attack.
+ * @public
+ */
+export type StaticallyComposableHTML<TSource = any, TParent = any> = string | HTMLDirective | SyntheticViewTemplate<TSource, TParent> | undefined;
+/**
+ * A function to compose template options.
+ * @public
+ */
+export declare function staticallyCompose<TSource = any, TParent = any>(item: StaticallyComposableHTML<TSource, TParent>): CaptureType<TSource, TParent>;

package/dist/esm/utils/template-helpers.js

@@ -1,5 +1,5 @@
 //Copied from @microsoft/fast-foundation
-import { InlineTemplateDirective } from '@microsoft/fast-element';
+import { InlineTemplateDirective, } from '@microsoft/fast-element';
 /**
  * A function to compose template options.
  * @public

package/dist/esm/utils/template-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-helpers.js","sourceRoot":"","sources":["../../../src/utils/template-helpers.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAA8B,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAiB9F;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgD;IAEhD,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,uBAAuB,CAAC,KAAK,CAAC;KACtC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAC5B,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;KAC1C;IAED,IAAI,QAAQ,IAAI,IAAI,EAAE;QACpB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;KACtB;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"template-helpers.js","sourceRoot":"","sources":["../../../src/utils/template-helpers.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAGL,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAgBjC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgD;IAEhD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,uBAAuB,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/utils/typings.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helper for enumerating a type from a const object
+ * Example: export type Foo = ValuesOf\<typeof Foo\>
+ * @public
+ */
+export type ValuesOf<T> = T[keyof T];

package/dist/esm/utils/unique-id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates a unique element id.
+ *
+ * @param prefix - The prefix to use for the unique id.
+ * @returns A unique id.
+ *
+ * @public
+ */
+export declare function uniqueId(prefix?: string): string;

package/dist/esm/utils/unique-id.js

@@ -0,0 +1,14 @@
+let uniqueIdCounter = 0;
+/**
+ * Generates a unique element id.
+ *
+ * @param prefix - The prefix to use for the unique id.
+ * @returns A unique id.
+ *
+ * @public
+ */
+export function uniqueId(prefix = 'id-') {
+    const str = `${prefix}${uniqueIdCounter++}`;
+    return document.getElementById(str) ? uniqueId(prefix) : str;
+}
+//# sourceMappingURL=unique-id.js.map

package/dist/esm/utils/unique-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique-id.js","sourceRoot":"","sources":["../../../src/utils/unique-id.ts"],"names":[],"mappings":"AAAA,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAM,GAAG,KAAK;IACrC,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,eAAe,EAAE,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAC/D,CAAC"}

package/dist/esm/utils/whitespace-filter.js

@@ -9,5 +9,5 @@
  *
  * @public
  */
-export const whitespaceFilter = value => { var _a; return value.nodeType !== Node.TEXT_NODE || !!((_a = value.nodeValue) === null || _a === void 0 ? void 0 : _a.trim().length); };
+export const whitespaceFilter = value => value.nodeType !== Node.TEXT_NODE || !!value.nodeValue?.trim().length;
 //# sourceMappingURL=whitespace-filter.js.map

package/dist/esm/utils/whitespace-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"whitespace-filter.js","sourceRoot":"","sources":["../../../src/utils/whitespace-filter.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB,KAAK,CAAC,EAAE,WACtD,OAAA,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAA,MAAA,KAAK,CAAC,SAAS,0CAAE,IAAI,GAAG,MAAM,CAAA,CAAA,EAAA,CAAC"}
+{"version":3,"file":"whitespace-filter.js","sourceRoot":"","sources":["../../../src/utils/whitespace-filter.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB,KAAK,CAAC,EAAE,CACtD,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC"}