ngwr 9.1.0 → 10.0.0

package/types/ngwr-popconfirm.d.ts

@@ -43,6 +43,7 @@ declare class WrPopconfirm {
     readonly cancelled: _angular_core.OutputEmitterRef<void>;
     private readonly host;
     private readonly overlay;
+    private readonly outsideClick;
     private readonly vcr;
     private readonly scrollStrategies;
     private readonly destroyRef;

package/types/ngwr-popover.d.ts

@@ -51,6 +51,7 @@ declare class WrPopover {
     readonly closed: _angular_core.OutputEmitterRef<void>;
     private readonly host;
     private readonly overlay;
+    private readonly outsideClick;
     private readonly responsiveConfig;
     private readonly vcr;
     private readonly scrollStrategies;

package/types/ngwr-select.d.ts

@@ -499,6 +499,7 @@ declare class WrSelect implements FormValueControl<unknown>, WrSelectContext {
     protected readonly searchDisplay: _angular_core.Signal<string>;
     private readonly host;
     private readonly overlay;
+    private readonly outsideClick;
     private readonly responsiveConfig;
     private readonly vcr;
     private readonly scrollStrategies;
@@ -591,6 +592,11 @@ declare class WrOption {
 declare class WrOptionGroup {
     /** Section heading shown above the options. */
     readonly label: _angular_core.InputSignal<string>;
+    /**
+     * `role="group"` alone announces an unnamed group — the visible heading has to
+     * be wired to it for the name to reach a screen reader.
+     */
+    protected readonly labelId: string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WrOptionGroup, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<WrOptionGroup, "wr-option-group", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }

package/types/ngwr-theme.d.ts

@@ -116,7 +116,14 @@ declare class WrTheme {
  */
 
 /**
- * Configure {@link WrTheme}. Partial — merged with defaults.
+ * Configure and activate {@link WrTheme}. Config is partial — merged with
+ * defaults.
+ *
+ * Calling this is all it takes: the initializer instantiates {@link WrTheme},
+ * whose constructor effect mirrors the resolved theme onto `<html>`. Without
+ * that, the service (a tree-shakable `@Service()`) would only be created once
+ * something injected it, so `[data-theme]` was never written and an app that
+ * followed the docs silently ignored `defaultMode: 'auto'`.
  *
  * @example
  * ```ts

package/types/ngwr-tree.d.ts

@@ -138,6 +138,7 @@ declare class WrTree<TId = string> implements FormValueControl<unknown> {
     readonly touch: _angular_core.OutputEmitterRef<void>;
     private readonly host;
     private readonly overlay;
+    private readonly outsideClick;
     private readonly vcr;
     private readonly scrollStrategies;
     private readonly destroyRef;

package/types/ngwr-version.d.ts

@@ -16,7 +16,7 @@ import { InjectionToken } from '@angular/core';
  * Distinct from `Version` exported by `@angular/core`, which reports the
  * loaded Angular runtime version (e.g. `'21.2.13'`), not ngwr's.
  */
-declare const NGWR_VERSION = "9.1.0";
+declare const NGWR_VERSION = "10.0.0";
 
 /**
  * @license

package/types/ngwr-waves.d.ts

@@ -53,6 +53,16 @@ declare class WrWaves {
     private bounding;
     private readonly mouse;
     private rafId;
+    /**
+     * Flips once the canvas has drawn, which retires the CSS stand-in grid.
+     *
+     * A canvas cannot be prerendered, so on an SSR'd or prerendered page this
+     * element is simply blank until the bundle has loaded and hydration has run —
+     * measured at ~2.8s on ngwr.dev's own home page. The stylesheet paints a static
+     * grid of the same colour and pitch in the meantime, straight from the
+     * prerendered HTML, and this hands over to the real thing.
+     */
+    protected readonly painted: _angular_core.WritableSignal<boolean>;
     constructor();
     private boot;
     private setSize;

package/waves/styles/_index.scss

@@ -4,6 +4,9 @@
 
 .wr-waves {
   --wr-waves-line-color: rgba(var(--wr-color-on-surface-rgb), 0.12);
+  // Mirrors the `xGap` input; the component publishes it so the stand-in below
+  // lands on the same pitch as the real grid.
+  --wr-waves-x-gap: 10px;
 
   position: absolute;
   inset: 0;
@@ -12,6 +15,24 @@
   padding: 0;
   overflow: hidden;
 
+  // Stand-in grid, shown until the canvas has painted.
+  //
+  // A canvas cannot be prerendered, so on an SSR'd or prerendered page this
+  // element is blank until the JS bundle has loaded and hydrated — measured at
+  // ~2.8s on ngwr.dev's own home page, where it reads as the background hanging
+  // and then popping in. These are straight lines rather than the drifting
+  // curves, at the same colour and pitch, so the handover reads as the grid
+  // coming alive rather than as content appearing.
+  background-image: repeating-linear-gradient(
+    to right,
+    var(--wr-waves-line-color) 0 1px,
+    transparent 1px var(--wr-waves-x-gap)
+  );
+
+  &--painted {
+    background-image: none;
+  }
+
   &__canvas {
     display: block;
     width: 100%;