@ethlete/core 5.0.0-next.72 → 5.0.0-next.73

package/types/ethlete-core.d.ts

@@ -891,193 +891,6 @@ export type ElementScrollState = {
 };
 export declare const signalElementScrollState: (el: SignalElementBindingType, options?: SignalElementScrollStateOptions) => Signal<ElementScrollState>;
 export declare const signalHostElementScrollState: () => Signal<ElementScrollState>;
-export declare const injectAngularRootElement: import("@ethlete/core").InjectFn<import("@angular/core").WritableSignal<HTMLElement | null>>;
-export declare const provideBoundaryElement: () => import("@angular/core").StaticProvider[];
-export declare const injectBoundaryElement: import("@ethlete/core").InjectFn<{
-  value: import("@angular/core").Signal<HTMLElement>;
-  override: import("@angular/core").WritableSignal<HTMLElement | null>;
-}>;
-export declare const BOUNDARY_ELEMENT_TOKEN: import("@angular/core").InjectionToken<{
-  value: import("@angular/core").Signal<HTMLElement>;
-  override: import("@angular/core").WritableSignal<HTMLElement | null>;
-}>;
-export type FileDownloadOptions = {
-  /**
-   * The file's body - a string, a `Blob`, or the parts to build one from. A `Blob` is re-wrapped, so
-   * {@link FileDownloadOptions.type} still decides the MIME type.
-   */
-  content: BlobPart | BlobPart[];
-  /** The name the browser saves the file under, extension included. */
-  filename: string;
-  /** MIME type of the generated blob, e.g. `application/json`. */
-  type?: string;
-};
-/**
- * Hands the user a file the browser downloads. Call it once from an injection context - a field
- * initializer - and the function it hands back can then be called from anywhere, including a click
- * handler.
- *
- * A no-op where there is no browser (server-side rendering), so a toolbar button needs no platform
- * check of its own. Use {@link createObjectUrlHandle} instead when the URL has to outlive the call.
- *
- * @example
- * private download = injectFileDownload();
- *
- * protected save() {
- *   this.download({ content: json, filename: 'session.json', type: 'application/json' });
- * }
- */
-export declare const injectFileDownload: () => (options: FileDownloadOptions) => void;
-export declare const provideFocusVisibleTracker: () => import("@angular/core").StaticProvider[];
-export declare const injectFocusVisibleTracker: import("@ethlete/core").InjectFn<{
-  isFocusVisible: import("@angular/core").Signal<boolean>;
-}>;
-export declare const FOCUS_VISIBLE_TRACKER_TOKEN: import("@angular/core").InjectionToken<{
-  isFocusVisible: import("@angular/core").Signal<boolean>;
-}>;
-/**
- * A label set, or a function building one for a locale. The function form is called again whenever
- * {@link injectLocale}'s `currentLocale` changes, so a locale switch re-renders the wording without
- * reloading - that is the seam an app's i18n library plugs into.
- */
-export type LabelsSource<T> = Partial<T> | ((locale: string) => Partial<T>);
-/** What {@link defineLabels} returns. */
-export type LabelsDefinition<T> = {
-  readonly provide: (labels: LabelsSource<T>) => Provider;
-  readonly inject: () => Signal<T>;
-  readonly token: InjectionToken<LabelsSource<T>>;
-};
-/**
- * The one mechanism for the strings a component renders or announces itself. Every domain in the UI
- * library that has such strings exposes exactly this pair - `provide<Domain>Labels` to localize a
- * subtree, `inject<Domain>Labels()` to read the result - so localizing an app is the same move
- * repeated per domain rather than a different one each time.
- *
- * `defaults` may itself be locale-derived, for a domain that ships more than one language (the
- * `@ethlete/query` error tables, say). Overrides are partial and layer on top of whatever the locale
- * resolved to, so translating into a third language while keeping a shipped one as the base is the
- * same call.
- *
- * The injector returns a **signal**, because both halves can change at runtime - read it in a
- * template or computed, never destructure it once.
- *
- * @example
- * export type BreadcrumbLabels = { navigation: string; overflow: string };
- *
- * export const DEFAULT_BREADCRUMB_LABELS: BreadcrumbLabels = {
- *   navigation: 'Breadcrumb',
- *   overflow: 'Show hidden levels',
- * };
- *
- * const BREADCRUMB_LABELS_DEF = defineLabels<BreadcrumbLabels>('BREADCRUMB_LABELS', DEFAULT_BREADCRUMB_LABELS);
- *
- * export const provideBreadcrumbLabels = toProvideFn(BREADCRUMB_LABELS_DEF);
- * export const injectBreadcrumbLabels = toInjectFn(BREADCRUMB_LABELS_DEF);
- * export const BREADCRUMB_LABELS = toToken(BREADCRUMB_LABELS_DEF);
- *
- * @example
- * // consumer, fixed wording
- * provideBreadcrumbLabels({ navigation: 'Brotkrumen' });
- *
- * // consumer, driven by the app's i18n and re-resolved on a locale change
- * provideBreadcrumbLabels((locale) => ({ navigation: translate('breadcrumb.nav', locale) }));
- */
-export declare const defineLabels: <T extends object>(name: string, defaults: T | ((locale: string) => T)) => LabelsDefinition<T>;
-type Locale = {
-  currentLocale: WritableSignal<string>;
-};
-/** Provides the app locale, starting at `locale` (default `'en'`). Change it later with `injectLocale().currentLocale.set(...)`. */
-export declare const provideLocale: (locale?: string) => StaticProvider[];
-export declare const injectLocale: () => Locale;
-export declare const provideRenderer: () => import("@angular/core").StaticProvider[];
-export declare const injectRenderer: import("@ethlete/core").InjectFn<{
-  addClass: (element: HTMLElement, ...classes: string[]) => void;
-  removeClass: (element: HTMLElement, ...classes: string[]) => void;
-  toggleClass: (element: HTMLElement, className: string, force?: boolean) => boolean;
-  setStyle: (element: HTMLElement, style: Partial<Record<keyof CSSStyleDeclaration, string | null>>, flags?: RendererStyleFlags2) => void;
-  removeStyle: (element: HTMLElement, style: keyof CSSStyleDeclaration | string, flags?: RendererStyleFlags2) => void;
-  removeStyles: (element: HTMLElement, ...styles: (keyof CSSStyleDeclaration | string)[]) => void;
-  setAttribute: (element: Element, name: string, value: string | null, namespace?: string | null) => void;
-  removeAttribute: (element: Element, ...names: string[]) => void;
-  setProperty: (element: HTMLElement, name: string, value: unknown) => void;
-  setProperties: (element: HTMLElement, properties: Record<string, unknown>) => void;
-  createElement: <K extends keyof HTMLElementTagNameMap>(tagName: K, namespace?: string | null) => HTMLElementTagNameMap[K];
-  createText: (value: string) => Text;
-  createComment: (value: string) => Comment;
-  appendChild: (parent: HTMLElement, newChild: Node) => void;
-  insertBefore: (parent: Node, newChild: Node, refChild: Node | null) => void;
-  removeChild: (parent: Node, oldChild: Node, isHostElement?: boolean) => void;
-  selectRootElement: (selectorOrNode: string | HTMLElement, preserveContent?: boolean) => HTMLElement;
-  parentNode: (node: Node) => Node | null;
-  nextSibling: (node: Node) => Node | null;
-  setValue: (node: Node, value: string) => void;
-  listen: (target: HTMLElement | Window | Document | "window" | "document" | "body", eventName: string, callback: (event: Event) => boolean | void) => (() => void);
-  destroyNode: (node: Node) => void;
-  replaceChild: (parent: Node, newChild: Node, oldChild: Node) => void;
-  empty: (element: HTMLElement) => void;
-  setTextContent: (element: HTMLElement, text: string) => void;
-  setAttributes: (element: HTMLElement, attributes: Record<string, string | null>, namespace?: string | null) => void;
-  setDataAttributes: (element: HTMLElement, data: Record<string, string | null>) => void;
-  setCssProperty: (element: HTMLElement, name: string, value: string | null) => void;
-  setCssProperties: (element: HTMLElement, properties: Record<string, string | null>) => void;
-  moveBefore: (config: {
-    newParent: HTMLElement;
-    child: HTMLElement;
-    before?: Node | null;
-  }) => void;
-  renderer: import("@angular/core").Renderer2;
-}>;
-export type AngularRenderer = NonNullable<ReturnType<typeof injectRenderer>>;
-export type StyleManager = {
-  mount: <TComponent>(component: Type<TComponent>) => ComponentRef<TComponent>;
-};
-export declare const provideStyleManager: () => import("@angular/core").StaticProvider[];
-export declare const injectStyleManager: import("@ethlete/core").InjectFn<StyleManager>;
-export type ConsentHandler = {
-  /** Signal that is `true` when consent has been granted. */
-  isGranted: Signal<boolean>;
-  /** Grants consent and writes the decision back to the source. */
-  grant: () => void;
-  /** Revokes consent and writes the decision back to the source. */
-  revoke?: () => void;
-};
-export type CreateUserConsentProviderOptions = {
-  /** The `InjectionToken` this consent provider should be associated with. */
-  for: InjectionToken<ConsentHandler | null>;
-  /**
-   * Factory executed inside the injection context that returns a `Signal<boolean>`.
-   *
-   * @example
-   * isGranted: () => inject(CookieService).hasMediaConsent
-   */
-  isGranted: () => Signal<boolean>;
-  /**
-   * Factory executed inside the injection context that returns the grant function.
-   *
-   * @example
-   * grant: () => () => inject(CookieService).acceptAll()
-   */
-  grant: () => () => void;
-  /**
-   * Factory executed inside the injection context that returns the revoke  function.
-   *
-   * @example
-   * revoke : () => () => inject(CookieService).revokeAll()
-   */
-  revoke?: () => () => void;
-};
-export declare const createUserConsentProvider: (options: CreateUserConsentProviderOptions) => Provider;
-/**
- * Declares the `et-visually-hidden` class as a styles-only component: content that stays in the
- * accessibility tree but is clipped out of the layout. Mount it from any component whose template
- * uses the class.
- */
-export declare class VisuallyHiddenStylesComponent {
-  static ɵfac: i0.ɵɵFactoryDeclaration<VisuallyHiddenStylesComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<VisuallyHiddenStylesComponent, "et-visually-hidden-styles", never, {}, {}, never, never, true, never>;
-}
-/** Mounts {@link VisuallyHiddenStylesComponent}. Call from an injection context. */
-export declare const mountVisuallyHidden: () => import("@angular/core").ComponentRef<VisuallyHiddenStylesComponent>;
 /** Inject a signal containing a boolean value indicating if the viewport is xs */
 export declare const injectIsXs: () => import("@angular/core").Signal<boolean>;
 /** Inject a signal containing a boolean value indicating if the viewport is sm */
@@ -1980,53 +1793,240 @@ type OverlayRuntimeRef<TComponent extends object = object, TResult = unknown> =
   /** Adds or removes the backdrop of an open overlay. A closing overlay keeps the backdrop it has. */
   updateBackdrop(hasBackdrop: boolean): void;
 };
-export declare const FOCUSABLE_SELECTOR: string;
-export declare const isHTMLElement: (value: unknown) => value is HTMLElement;
-export declare const isElement: (value: unknown) => value is Element;
-export declare const isHTMLOrSVGElement: (value: unknown) => value is HTMLElement | SVGElement;
-/**
- * Whether the overlay rooted at `hostElement` is still the owner of DOM focus - focus is inside it, or
- * nothing is focused. False once the user has moved focus somewhere else.
- */
-export declare const ownsActiveElement: (hostElement: HTMLElement, document: Document) => boolean;
-export declare const isFocusable: (element: HTMLElement, document: Document) => boolean;
-/** The elements Tab stops on inside `container`, with each named radio group collapsed to its checked (else first) radio. */
-export declare const getFocusableElements: (container: HTMLElement, document: Document) => HTMLElement[];
-export declare const getHeadingElement: (container: HTMLElement) => HTMLElement | null;
-export declare const focusElement: (element: HTMLElement | null) => void;
-export declare const applyInitialFocus: (paneElement: HTMLElement, autoFocus: OverlayRuntimeAutoFocusTarget | string | false, document: Document) => void;
-export declare const setupFocusTrap: (paneElement: HTMLElement, overlayRef: OverlayRuntimeRef<object, unknown>, enabled: boolean, isTopMost: (ref: OverlayRuntimeRef<object, unknown>) => boolean, document: Document) => () => void;
-/**
- * Attribute an element uses to declare the stacking level it paints at. Its value is the z-index of
- * the runtime root an overlay opened from inside it mounts into, and the level every outside-pointer
- * close compares a press against.
- */
-export declare const OVERLAY_LAYER_ATTRIBUTE = "data-et-overlay-layer";
-/**
- * The stacking level overlays mount at when nothing above their origin declares another one. Near
- * int32 max, so an overlay outranks an arbitrary host application's own stacking.
- */
-export declare const DEFAULT_OVERLAY_LAYER = 2147483003;
-/**
- * The stacking level for an overlay opened from `element`: the one declared by the nearest ancestor
- * carrying `data-et-overlay-layer`, or {@link DEFAULT_OVERLAY_LAYER}.
- *
- * Put the attribute on anything that paints above the default overlay layer - a devtools panel, an
- * always-on-top widget - so a menu, tooltip or dialog opened inside it is not rendered behind the
- * thing that opened it, and so working in it does not close an overlay below it. Overlays sharing a
- * level share a runtime root and stack in open order.
- */
-export declare const resolveOverlayLayer: (element: Element | null | undefined) => number;
+export declare const FOCUSABLE_SELECTOR: string;
+export declare const isHTMLElement: (value: unknown) => value is HTMLElement;
+export declare const isElement: (value: unknown) => value is Element;
+export declare const isHTMLOrSVGElement: (value: unknown) => value is HTMLElement | SVGElement;
+/**
+ * Whether the overlay rooted at `hostElement` is still the owner of DOM focus - focus is inside it, or
+ * nothing is focused. False once the user has moved focus somewhere else.
+ */
+export declare const ownsActiveElement: (hostElement: HTMLElement, document: Document) => boolean;
+export declare const isFocusable: (element: HTMLElement, document: Document) => boolean;
+/** The elements Tab stops on inside `container`, with each named radio group collapsed to its checked (else first) radio. */
+export declare const getFocusableElements: (container: HTMLElement, document: Document) => HTMLElement[];
+export declare const getHeadingElement: (container: HTMLElement) => HTMLElement | null;
+export declare const focusElement: (element: HTMLElement | null) => void;
+export declare const applyInitialFocus: (paneElement: HTMLElement, autoFocus: OverlayRuntimeAutoFocusTarget | string | false, document: Document) => void;
+export declare const setupFocusTrap: (paneElement: HTMLElement, overlayRef: OverlayRuntimeRef<object, unknown>, enabled: boolean, isTopMost: (ref: OverlayRuntimeRef<object, unknown>) => boolean, document: Document) => () => void;
+/**
+ * Attribute an element uses to declare the stacking level it paints at. Its value is the z-index of
+ * the runtime root an overlay opened from inside it mounts into, and the level every outside-pointer
+ * close compares a press against.
+ */
+export declare const OVERLAY_LAYER_ATTRIBUTE = "data-et-overlay-layer";
+/**
+ * The stacking level overlays mount at when nothing above their origin declares another one. Near
+ * int32 max, so an overlay outranks an arbitrary host application's own stacking.
+ */
+export declare const DEFAULT_OVERLAY_LAYER = 2147483003;
+/**
+ * The stacking level for an overlay opened from `element`: the one declared by the nearest ancestor
+ * carrying `data-et-overlay-layer`, or {@link DEFAULT_OVERLAY_LAYER}.
+ *
+ * Put the attribute on anything that paints above the default overlay layer - a devtools panel, an
+ * always-on-top widget - so a menu, tooltip or dialog opened inside it is not rendered behind the
+ * thing that opened it, and so working in it does not close an overlay below it. Overlays sharing a
+ * level share a runtime root and stack in open order.
+ */
+export declare const resolveOverlayLayer: (element: Element | null | undefined) => number;
+/**
+ * Whether `target` sits on a stacking level above `layer` - a press inside the query devtools panel
+ * while an application overlay is open, for example.
+ *
+ * Every outside-pointer close asks this first: a press on a surface that paints over an overlay is
+ * aimed at that surface, not at the content the overlay covers, so it must not close the overlay.
+ * The level of a press inside another overlay resolves through that overlay's runtime root, so a
+ * menu opened from the devtools panel counts as part of the panel's level too.
+ */
+export declare const isOnHigherOverlayLayer: (target: EventTarget | null | undefined, layer: number) => boolean;
+export declare const injectAngularRootElement: import("@ethlete/core").InjectFn<import("@angular/core").WritableSignal<HTMLElement | null>>;
+export declare const provideBoundaryElement: () => import("@angular/core").StaticProvider[];
+export declare const injectBoundaryElement: import("@ethlete/core").InjectFn<{
+  value: import("@angular/core").Signal<HTMLElement>;
+  override: import("@angular/core").WritableSignal<HTMLElement | null>;
+}>;
+export declare const BOUNDARY_ELEMENT_TOKEN: import("@angular/core").InjectionToken<{
+  value: import("@angular/core").Signal<HTMLElement>;
+  override: import("@angular/core").WritableSignal<HTMLElement | null>;
+}>;
+export type FileDownloadOptions = {
+  /**
+   * The file's body - a string, a `Blob`, or the parts to build one from. A `Blob` is re-wrapped, so
+   * {@link FileDownloadOptions.type} still decides the MIME type.
+   */
+  content: BlobPart | BlobPart[];
+  /** The name the browser saves the file under, extension included. */
+  filename: string;
+  /** MIME type of the generated blob, e.g. `application/json`. */
+  type?: string;
+};
+/**
+ * Hands the user a file the browser downloads. Call it once from an injection context - a field
+ * initializer - and the function it hands back can then be called from anywhere, including a click
+ * handler.
+ *
+ * A no-op where there is no browser (server-side rendering), so a toolbar button needs no platform
+ * check of its own. Use {@link createObjectUrlHandle} instead when the URL has to outlive the call.
+ *
+ * @example
+ * private download = injectFileDownload();
+ *
+ * protected save() {
+ *   this.download({ content: json, filename: 'session.json', type: 'application/json' });
+ * }
+ */
+export declare const injectFileDownload: () => (options: FileDownloadOptions) => void;
+export declare const provideFocusVisibleTracker: () => import("@angular/core").StaticProvider[];
+export declare const injectFocusVisibleTracker: import("@ethlete/core").InjectFn<{
+  isFocusVisible: import("@angular/core").Signal<boolean>;
+}>;
+export declare const FOCUS_VISIBLE_TRACKER_TOKEN: import("@angular/core").InjectionToken<{
+  isFocusVisible: import("@angular/core").Signal<boolean>;
+}>;
+/**
+ * A label set, or a function building one for a locale. The function form is called again whenever
+ * {@link injectLocale}'s `currentLocale` changes, so a locale switch re-renders the wording without
+ * reloading - that is the seam an app's i18n library plugs into.
+ */
+export type LabelsSource<T> = Partial<T> | ((locale: string) => Partial<T>);
+/** What {@link defineLabels} returns. */
+export type LabelsDefinition<T> = {
+  readonly provide: (labels: LabelsSource<T>) => Provider;
+  readonly inject: () => Signal<T>;
+  readonly token: InjectionToken<LabelsSource<T>>;
+};
+/**
+ * The one mechanism for the strings a component renders or announces itself. Every domain in the UI
+ * library that has such strings exposes exactly this pair - `provide<Domain>Labels` to localize a
+ * subtree, `inject<Domain>Labels()` to read the result - so localizing an app is the same move
+ * repeated per domain rather than a different one each time.
+ *
+ * `defaults` may itself be locale-derived, for a domain that ships more than one language (the
+ * `@ethlete/query` error tables, say). Overrides are partial and layer on top of whatever the locale
+ * resolved to, so translating into a third language while keeping a shipped one as the base is the
+ * same call.
+ *
+ * The injector returns a **signal**, because both halves can change at runtime - read it in a
+ * template or computed, never destructure it once.
+ *
+ * @example
+ * export type BreadcrumbLabels = { navigation: string; overflow: string };
+ *
+ * export const DEFAULT_BREADCRUMB_LABELS: BreadcrumbLabels = {
+ *   navigation: 'Breadcrumb',
+ *   overflow: 'Show hidden levels',
+ * };
+ *
+ * const BREADCRUMB_LABELS_DEF = defineLabels<BreadcrumbLabels>('BREADCRUMB_LABELS', DEFAULT_BREADCRUMB_LABELS);
+ *
+ * export const provideBreadcrumbLabels = toProvideFn(BREADCRUMB_LABELS_DEF);
+ * export const injectBreadcrumbLabels = toInjectFn(BREADCRUMB_LABELS_DEF);
+ * export const BREADCRUMB_LABELS = toToken(BREADCRUMB_LABELS_DEF);
+ *
+ * @example
+ * // consumer, fixed wording
+ * provideBreadcrumbLabels({ navigation: 'Brotkrumen' });
+ *
+ * // consumer, driven by the app's i18n and re-resolved on a locale change
+ * provideBreadcrumbLabels((locale) => ({ navigation: translate('breadcrumb.nav', locale) }));
+ */
+export declare const defineLabels: <T extends object>(name: string, defaults: T | ((locale: string) => T)) => LabelsDefinition<T>;
+type Locale = {
+  currentLocale: WritableSignal<string>;
+};
+/** Provides the app locale, starting at `locale` (default `'en'`). Change it later with `injectLocale().currentLocale.set(...)`. */
+export declare const provideLocale: (locale?: string) => StaticProvider[];
+export declare const injectLocale: () => Locale;
+export declare const provideRenderer: () => import("@angular/core").StaticProvider[];
+export declare const injectRenderer: import("@ethlete/core").InjectFn<{
+  addClass: (element: HTMLElement, ...classes: string[]) => void;
+  removeClass: (element: HTMLElement, ...classes: string[]) => void;
+  toggleClass: (element: HTMLElement, className: string, force?: boolean) => boolean;
+  setStyle: (element: HTMLElement, style: Partial<Record<keyof CSSStyleDeclaration, string | null>>, flags?: RendererStyleFlags2) => void;
+  removeStyle: (element: HTMLElement, style: keyof CSSStyleDeclaration | string, flags?: RendererStyleFlags2) => void;
+  removeStyles: (element: HTMLElement, ...styles: (keyof CSSStyleDeclaration | string)[]) => void;
+  setAttribute: (element: Element, name: string, value: string | null, namespace?: string | null) => void;
+  removeAttribute: (element: Element, ...names: string[]) => void;
+  setProperty: (element: HTMLElement, name: string, value: unknown) => void;
+  setProperties: (element: HTMLElement, properties: Record<string, unknown>) => void;
+  createElement: <K extends keyof HTMLElementTagNameMap>(tagName: K, namespace?: string | null) => HTMLElementTagNameMap[K];
+  createText: (value: string) => Text;
+  createComment: (value: string) => Comment;
+  appendChild: (parent: HTMLElement, newChild: Node) => void;
+  insertBefore: (parent: Node, newChild: Node, refChild: Node | null) => void;
+  removeChild: (parent: Node, oldChild: Node, isHostElement?: boolean) => void;
+  selectRootElement: (selectorOrNode: string | HTMLElement, preserveContent?: boolean) => HTMLElement;
+  parentNode: (node: Node) => Node | null;
+  nextSibling: (node: Node) => Node | null;
+  setValue: (node: Node, value: string) => void;
+  listen: (target: HTMLElement | Window | Document | "window" | "document" | "body", eventName: string, callback: (event: Event) => boolean | void) => (() => void);
+  destroyNode: (node: Node) => void;
+  replaceChild: (parent: Node, newChild: Node, oldChild: Node) => void;
+  empty: (element: HTMLElement) => void;
+  setTextContent: (element: HTMLElement, text: string) => void;
+  setAttributes: (element: HTMLElement, attributes: Record<string, string | null>, namespace?: string | null) => void;
+  setDataAttributes: (element: HTMLElement, data: Record<string, string | null>) => void;
+  setCssProperty: (element: HTMLElement, name: string, value: string | null) => void;
+  setCssProperties: (element: HTMLElement, properties: Record<string, string | null>) => void;
+  moveBefore: (config: {
+    newParent: HTMLElement;
+    child: HTMLElement;
+    before?: Node | null;
+  }) => void;
+  renderer: import("@angular/core").Renderer2;
+}>;
+export type AngularRenderer = NonNullable<ReturnType<typeof injectRenderer>>;
+export type StyleManager = {
+  mount: <TComponent>(component: Type<TComponent>) => ComponentRef<TComponent>;
+};
+export declare const provideStyleManager: () => import("@angular/core").StaticProvider[];
+export declare const injectStyleManager: import("@ethlete/core").InjectFn<StyleManager>;
+export type ConsentHandler = {
+  /** Signal that is `true` when consent has been granted. */
+  isGranted: Signal<boolean>;
+  /** Grants consent and writes the decision back to the source. */
+  grant: () => void;
+  /** Revokes consent and writes the decision back to the source. */
+  revoke?: () => void;
+};
+export type CreateUserConsentProviderOptions = {
+  /** The `InjectionToken` this consent provider should be associated with. */
+  for: InjectionToken<ConsentHandler | null>;
+  /**
+   * Factory executed inside the injection context that returns a `Signal<boolean>`.
+   *
+   * @example
+   * isGranted: () => inject(CookieService).hasMediaConsent
+   */
+  isGranted: () => Signal<boolean>;
+  /**
+   * Factory executed inside the injection context that returns the grant function.
+   *
+   * @example
+   * grant: () => () => inject(CookieService).acceptAll()
+   */
+  grant: () => () => void;
+  /**
+   * Factory executed inside the injection context that returns the revoke  function.
+   *
+   * @example
+   * revoke : () => () => inject(CookieService).revokeAll()
+   */
+  revoke?: () => () => void;
+};
+export declare const createUserConsentProvider: (options: CreateUserConsentProviderOptions) => Provider;
 /**
- * Whether `target` sits on a stacking level above `layer` - a press inside the query devtools panel
- * while an application overlay is open, for example.
- *
- * Every outside-pointer close asks this first: a press on a surface that paints over an overlay is
- * aimed at that surface, not at the content the overlay covers, so it must not close the overlay.
- * The level of a press inside another overlay resolves through that overlay's runtime root, so a
- * menu opened from the devtools panel counts as part of the panel's level too.
+ * Declares the `et-visually-hidden` class as a styles-only component: content that stays in the
+ * accessibility tree but is clipped out of the layout. Mount it from any component whose template
+ * uses the class.
  */
-export declare const isOnHigherOverlayLayer: (target: EventTarget | null | undefined, layer: number) => boolean;
+export declare class VisuallyHiddenStylesComponent {
+  static ɵfac: i0.ɵɵFactoryDeclaration<VisuallyHiddenStylesComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VisuallyHiddenStylesComponent, "et-visually-hidden-styles", never, {}, {}, never, never, true, never>;
+}
+/** Mounts {@link VisuallyHiddenStylesComponent}. Call from an injection context. */
+export declare const mountVisuallyHidden: () => import("@angular/core").ComponentRef<VisuallyHiddenStylesComponent>;
 export declare const applyCenteredPosition: (hostElement: HTMLElement, paneElement: HTMLElement, renderer: AngularRenderer, _config: OverlayRuntimeCenteredPosition) => void;
 export declare const applyGlobalPosition: (hostElement: HTMLElement, paneElement: HTMLElement, renderer: AngularRenderer, config: OverlayRuntimeGlobalPosition) => void;
 export declare const setupPositioning: (config: OverlayRuntimeMountConfig<object>, hostElement: HTMLElement, paneElement: HTMLElement, overlayRef: OverlayRuntimeRef<object, unknown>, renderer: AngularRenderer) => () => void;
@@ -2434,14 +2434,6 @@ export declare class NormalizeMatchScorePipe implements PipeTransform {
   static ɵfac: i0.ɵɵFactoryDeclaration<NormalizeMatchScorePipe, never>;
   static ɵpipe: i0.ɵɵPipeDeclaration<NormalizeMatchScorePipe, "etNormalizeMatchScore", true>;
 }
-export declare const MatchStateType: {
-  readonly PREPARING_ROUND: "preparingRound";
-  readonly PRE_MATCH: "preMatch";
-  readonly LIVE: "live";
-  readonly POST_MATCH: "postMatch";
-  readonly AUTO_WIN: "autoWin";
-};
-export type MatchStateType = (typeof MatchStateType)[keyof typeof MatchStateType];
 export type NormalizedMatchScore = {
   home: {
     score: string | number | null;
@@ -2479,6 +2471,14 @@ export declare const getGroupMatchPoints: (match: MatchListView | null | undefin
     isWinner: boolean;
   };
 } | null;
+export declare const MatchStateType: {
+  readonly PREPARING_ROUND: "preparingRound";
+  readonly PRE_MATCH: "preMatch";
+  readonly LIVE: "live";
+  readonly POST_MATCH: "postMatch";
+  readonly AUTO_WIN: "autoWin";
+};
+export type MatchStateType = (typeof MatchStateType)[keyof typeof MatchStateType];
 export declare class NormalizeMatchStatePipe implements PipeTransform {
   transform: (match: MatchListView | null | undefined) => "preparingRound" | "preMatch" | "live" | "postMatch" | "autoWin" | null;
   static ɵfac: i0.ɵɵFactoryDeclaration<NormalizeMatchStatePipe, never>;
@@ -3302,27 +3302,6 @@ export declare const injectColorThemes: import("@ethlete/core").InjectFn<ColorTh
 export declare const ɵProvideColorThemesPrefix: (valueOverride?: string | undefined) => import("@angular/core").StaticProvider[];
 export declare const injectColorThemesPrefix: import("@ethlete/core").InjectFn<string>;
 export declare const provideColorThemesWithTailwind4: (themes: ColorTheme[], prefix?: string) => import("@angular/core").StaticProvider[][];
-/**
- * The color theme name that draws `chosenName` on `surface`: the surface's `colorThemeVariants` entry for it,
- * else `chosenName` itself. Always pass the chosen accent, never an already swapped one.
- */
-export declare const resolveColorThemeVariant: (surface: SurfaceTheme | null | undefined, chosenName: string, themes: ColorTheme[] | null | undefined) => string;
-/**
- * A signal of the color theme for `type` on the surface this element renders on: the first registered theme
- * of that `type`, swapped for the nearest surface's `colorThemeVariants` entry. Reading it throws when the app
- * registered no theme of that `type`, so read it only for a state that renders.
- *
- * @example
- * protected successTheme = injectSemanticColorTheme('success');
- * // <span [etProvideColor]="successTheme()">+12%</span>
- */
-export declare const injectSemanticColorTheme: (type: ColorThemeType) => Signal<ColorTheme>;
-/** @deprecated Use `injectSemanticColorTheme('error')`, which follows the surface the element renders on. */
-export declare const injectErrorTheme: () => ColorTheme;
-/** @deprecated Use `injectSemanticColorTheme('warning')`, which follows the surface the element renders on. */
-export declare const injectWarningTheme: () => ColorTheme;
-/** @deprecated Use `injectSemanticColorTheme('success')`, which follows the surface the element renders on. */
-export declare const injectSuccessTheme: () => ColorTheme;
 export declare const injectDefaultColorTheme: () => ColorTheme;
 export declare const SURFACE_TYPE: {
   readonly LIGHT: "light";
@@ -3418,6 +3397,50 @@ export declare const provideSurfaceThemesWithTailwind4: (themes: SurfaceTheme[],
  * For the theme the root paints right now, use `injectRootSurfaceTheme()`.
  */
 export declare const injectDefaultSurfaceTheme: (type?: SurfaceType) => SurfaceTheme | null;
+export declare const COLOR_PROVIDER: InjectionToken<ProvideColorDirective>;
+/**
+ * The color provider attached to a bootstrapped root component (e.g. `ProvideColorDirective` in
+ * the app component's `hostDirectives`), if any. Detached DOM such as overlay panes can't reach
+ * it through element DI, so overlay containers fall back to this when resolving the provider to
+ * `syncWithProvider()` - resolve at sync time, not at injection time, since root components only
+ * register with `ApplicationRef` once bootstrap completes.
+ */
+export declare const resolveAppRootColorProvider: (appRef: ApplicationRef) => ProvideColorDirective | null;
+export declare class ProvideColorDirective {
+  private themes;
+  private prefix;
+  private injector;
+  private rootSurfaceTheme;
+  private parentProvider;
+  private appRef;
+  private currentProviderSync;
+  private forcedColor;
+  color: InputSignal<ColorThemeInput | undefined>;
+  effectiveColor: Signal<ColorThemeInput | undefined>;
+  /**
+   * The color that actually applies at this provider's location: its own effective color, or -
+   * when this provider is passive (no input, nothing forced) - the nearest ancestor provider's.
+   * Mirrors the CSS cascade, which falls through a provider's `-color--inherited` scope class;
+   * consumers that re-apply context across detached DOM (overlay panes) must use this instead
+   * of `effectiveColor` or a passive in-between provider (e.g. a form field's) erases the theme.
+   */
+  resolvedColor: Signal<ColorThemeInput | undefined>;
+  colorName: Signal<string | undefined>;
+  private paintedColorName;
+  protected themeClass: Signal<string>;
+  syncWithProvider(provider: ProvideColorDirective): void;
+  stopSyncWithProvider(): void;
+  forceColor(color: ColorThemeInput): void;
+  clearForcedColor(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ProvideColorDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<ProvideColorDirective, "[etProvideColor]", never, {
+    "color": {
+      "alias": "etProvideColor";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 export declare const SURFACE_PROVIDER: InjectionToken<ProvideSurfaceDirective>;
 export declare class ProvideSurfaceDirective {
   private themes;
@@ -3596,6 +3619,11 @@ export declare const provideColorScheme: (config?: ColorSchemeConfig) => Environ
  * `provideColorScheme()`.
  */
 export declare const injectRootSurfaceTheme: () => Signal<SurfaceTheme | null>;
+/**
+ * The color theme name that draws `chosenName` on `surface`: the surface's `colorThemeVariants` entry for it,
+ * else `chosenName` itself. Always pass the chosen accent, never an already swapped one.
+ */
+export declare const resolveColorThemeVariant: (surface: SurfaceTheme | null | undefined, chosenName: string, themes: ColorTheme[] | null | undefined) => string;
 /**
  * @deprecated Migrate to Tailwind v4. Intent to remove in v6.
  */
@@ -3631,50 +3659,22 @@ export declare const createTailwindColorThemes: (themes: ColorTheme[], prefix?:
  * @deprecated Use provideColorThemesWithTailwind4 instead after migrating to Tailwind CSS v4. Intent to remove in v6.
  */
 export declare const provideColorThemes: (themes: ColorTheme[]) => import("@angular/core").StaticProvider[][];
-export declare const COLOR_PROVIDER: InjectionToken<ProvideColorDirective>;
 /**
- * The color provider attached to a bootstrapped root component (e.g. `ProvideColorDirective` in
- * the app component's `hostDirectives`), if any. Detached DOM such as overlay panes can't reach
- * it through element DI, so overlay containers fall back to this when resolving the provider to
- * `syncWithProvider()` - resolve at sync time, not at injection time, since root components only
- * register with `ApplicationRef` once bootstrap completes.
+ * A signal of the color theme for `type` on the surface this element renders on: the first registered theme
+ * of that `type`, swapped for the nearest surface's `colorThemeVariants` entry. Reading it throws when the app
+ * registered no theme of that `type`, so read it only for a state that renders.
+ *
+ * @example
+ * protected successTheme = injectSemanticColorTheme('success');
+ * // <span [etProvideColor]="successTheme()">+12%</span>
  */
-export declare const resolveAppRootColorProvider: (appRef: ApplicationRef) => ProvideColorDirective | null;
-export declare class ProvideColorDirective {
-  private themes;
-  private prefix;
-  private injector;
-  private rootSurfaceTheme;
-  private parentProvider;
-  private appRef;
-  private currentProviderSync;
-  private forcedColor;
-  color: InputSignal<ColorThemeInput | undefined>;
-  effectiveColor: import("@angular/core").Signal<ColorThemeInput | undefined>;
-  /**
-   * The color that actually applies at this provider's location: its own effective color, or -
-   * when this provider is passive (no input, nothing forced) - the nearest ancestor provider's.
-   * Mirrors the CSS cascade, which falls through a provider's `-color--inherited` scope class;
-   * consumers that re-apply context across detached DOM (overlay panes) must use this instead
-   * of `effectiveColor` or a passive in-between provider (e.g. a form field's) erases the theme.
-   */
-  resolvedColor: import("@angular/core").Signal<ColorThemeInput | undefined>;
-  colorName: import("@angular/core").Signal<string | undefined>;
-  private paintedColorName;
-  protected themeClass: import("@angular/core").Signal<string>;
-  syncWithProvider(provider: ProvideColorDirective): void;
-  stopSyncWithProvider(): void;
-  forceColor(color: ColorThemeInput): void;
-  clearForcedColor(): void;
-  static ɵfac: i0.ɵɵFactoryDeclaration<ProvideColorDirective, never>;
-  static ɵdir: i0.ɵɵDirectiveDeclaration<ProvideColorDirective, "[etProvideColor]", never, {
-    "color": {
-      "alias": "etProvideColor";
-      "required": false;
-      "isSignal": true;
-    };
-  }, {}, never, never, true, never>;
-}
+export declare const injectSemanticColorTheme: (type: ColorThemeType) => Signal<ColorTheme>;
+/** @deprecated Use `injectSemanticColorTheme('error')`, which follows the surface the element renders on. */
+export declare const injectErrorTheme: () => ColorTheme;
+/** @deprecated Use `injectSemanticColorTheme('warning')`, which follows the surface the element renders on. */
+export declare const injectWarningTheme: () => ColorTheme;
+/** @deprecated Use `injectSemanticColorTheme('success')`, which follows the surface the element renders on. */
+export declare const injectSuccessTheme: () => ColorTheme;
 export type SurfaceContextEntry = {
   id: string;
   type: SurfaceType;
@@ -3775,6 +3775,32 @@ export declare const injectUnsavedChangesCoordinator: import("@ethlete/core").In
   runCheck: (runner: (context: UnsavedChangesConfirmContext) => Promise<boolean>) => Promise<boolean>;
   register: (registration: UnsavedChangesRegistration) => () => void;
 }>;
+/**
+ * Decides whether a value with unsaved changes may be discarded. Called with the current value when
+ * (and only when) changes exist. Return a truthy value / resolved Promise / emitted Observable value
+ * to allow the discard, falsy to keep the changes. Typically opens a confirm dialog.
+ *
+ * The second argument carries an {@link UnsavedChangesConfirmContext.signal} that aborts when the
+ * session ends underneath the confirm (a logout) - close your dialog when it fires.
+ */
+export type UnsavedChangesConfirmFn<T> = (value: T, context: UnsavedChangesConfirmContext) => boolean | Promise<boolean> | Observable<boolean> | unknown;
+/** The confirm an unsaved-changes tracker or guard runs when its own config has none. */
+export declare const UNSAVED_CHANGES_CONFIRM: InjectionToken<UnsavedChangesConfirmFn<unknown>>;
+/**
+ * Sets the confirm every unsaved-changes tracker and guard below this injector runs when its config has no
+ * `confirm`. `factory` runs once, in an injection context, and returns the confirm.
+ *
+ * @example
+ * provideUnsavedChangesConfirm(() => {
+ *   const dialogs = inject(MyDialogs);
+ *   return () => dialogs.confirmDiscard();
+ * });
+ */
+export declare const provideUnsavedChangesConfirm: (factory: () => UnsavedChangesConfirmFn<unknown>) => Provider;
+export declare const UNSAVED_CHANGES_ERROR_CODES: {
+  /** An unsaved-changes tracker or guard has no `confirm`, and no `provideUnsavedChangesConfirm()` is in scope. */
+  readonly MISSING_CONFIRM: 9100;
+};
 /**
  * The value source an unsaved-changes tracker watches. In order of preference:
  *
@@ -3886,15 +3912,6 @@ export type UnsavedChangesTabLockRef = {
  * ```
  */
 export declare const createUnsavedChangesTabLock: (config: CreateUnsavedChangesTabLockConfig) => UnsavedChangesTabLockRef;
-/**
- * Decides whether a value with unsaved changes may be discarded. Called with the current value when
- * (and only when) changes exist. Return a truthy value / resolved Promise / emitted Observable value
- * to allow the discard, falsy to keep the changes. Typically opens a confirm dialog.
- *
- * The second argument carries an {@link UnsavedChangesConfirmContext.signal} that aborts when the
- * session ends underneath the confirm (a logout) - close your dialog when it fires.
- */
-export type UnsavedChangesConfirmFn<T> = (value: T, context: UnsavedChangesConfirmContext) => boolean | Promise<boolean> | Observable<boolean> | unknown;
 export type CreateUnsavedChangesTrackerConfig<T> = {
   /** The form / value to watch. See {@link UnsavedChangesSource}. */
   source: UnsavedChangesSource<T>;
@@ -3975,23 +3992,6 @@ export type UnsavedChangesTrackerRef<T> = {
  * on this - use them when you want the guard wired to a close/navigation event automatically.
  */
 export declare const createUnsavedChangesTracker: <T>(config: CreateUnsavedChangesTrackerConfig<T>) => UnsavedChangesTrackerRef<T>;
-/** The confirm an unsaved-changes tracker or guard runs when its own config has none. */
-export declare const UNSAVED_CHANGES_CONFIRM: InjectionToken<UnsavedChangesConfirmFn<unknown>>;
-/**
- * Sets the confirm every unsaved-changes tracker and guard below this injector runs when its config has no
- * `confirm`. `factory` runs once, in an injection context, and returns the confirm.
- *
- * @example
- * provideUnsavedChangesConfirm(() => {
- *   const dialogs = inject(MyDialogs);
- *   return () => dialogs.confirmDiscard();
- * });
- */
-export declare const provideUnsavedChangesConfirm: (factory: () => UnsavedChangesConfirmFn<unknown>) => Provider;
-export declare const UNSAVED_CHANGES_ERROR_CODES: {
-  /** An unsaved-changes tracker or guard has no `confirm`, and no `provideUnsavedChangesConfirm()` is in scope. */
-  readonly MISSING_CONFIRM: 9100;
-};
 export type CreateUnsavedChangesGuardConfig<T> = CreateUnsavedChangesTrackerConfig<T>;
 export type UnsavedChangesGuardRef<T> = UnsavedChangesTrackerRef<T> & {
   /**
@@ -4012,5 +4012,5 @@ export type UnsavedChangesGuardRef<T> = UnsavedChangesTrackerRef<T> & {
  */
 export declare const createUnsavedChangesGuard: <T>(config: CreateUnsavedChangesGuardConfig<T>) => UnsavedChangesGuardRef<T>;
 /** The version of `@ethlete/core` this build was cut from. */
-export declare const CORE_VERSION = "5.0.0-next.72";
+export declare const CORE_VERSION = "5.0.0-next.73";
 export { json_ld_d_exports as JsonLD, type OverlayRuntimeRef, type OverlayRuntimeState };