ngwr 10.2.1 → 11.0.0

package/fesm2022/ngwr-marquee.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngwr-marquee.mjs","sources":["../../../projects/lib/marquee/marquee.ts","../../../projects/lib/marquee/marquee.html","../../../projects/lib/marquee/ngwr-marquee.ts"],"sourcesContent":["/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n *\n * Angular adaptation of the LogoLoop effect by David Haz / reactbits.dev.\n * Original: https://www.reactbits.dev/animations/logo-loop\n *\n * Renamed `wr-marquee` in ngwr — same rAF-driven infinite carousel,\n * supports image + template items, optional fade/scale/pause-on-hover.\n */\n\nimport { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport { NgTemplateOutlet, isPlatformBrowser } from '@angular/common';\nimport {\n  Component,\n  DestroyRef,\n  ElementRef,\n  PLATFORM_ID,\n  ViewEncapsulation,\n  afterNextRender,\n  computed,\n  effect,\n  inject,\n  input,\n  signal,\n  viewChild,\n} from '@angular/core';\n\nimport { numAttr } from 'ngwr/utils';\n\nimport type { WrMarqueeNode, WrMarqueeItem } from './interfaces';\n\nconst SMOOTH_TAU = 0.25;\nconst MIN_COPIES = 2;\nconst COPY_HEADROOM = 2;\n\nfunction isNode(item: WrMarqueeItem): item is WrMarqueeNode {\n  return 'node' in item;\n}\n\n/**\n * Endless horizontal marquee. Auto-duplicates the items list until it\n * covers the container width, then animates the track with a smooth\n * rAF-driven scroll. Optional edge fades, scale-on-hover, and pause /\n * variable-speed hover behaviour.\n *\n * @example\n * ```html\n * <wr-marquee\n *   [items]=\"logos\"\n *   [speed]=\"80\"\n *   [gap]=\"48\"\n *   [itemHeight]=\"36\"\n *   [fadeOut]=\"true\"\n *   [scaleOnHover]=\"true\"\n *   [pauseOnHover]=\"true\"\n * />\n * ```\n *\n * @see https://www.reactbits.dev/animations/logo-loop\n */\n@Component({\n  selector: 'wr-marquee',\n  templateUrl: './marquee.html',\n  styleUrl: './marquee.scss',\n  encapsulation: ViewEncapsulation.None,\n  imports: [NgTemplateOutlet],\n  host: {\n    class: 'wr-marquee',\n    '[class.wr-marquee--fade]': 'fadeOut()',\n    '[class.wr-marquee--scale-hover]': 'scaleOnHover()',\n    '[style.--wr-marquee-gap.px]': 'gap()',\n    '[style.--wr-marquee-height.px]': 'itemHeight()',\n    '[style.--wr-marquee-fade-color]': 'fadeOutColor() || null',\n    '[attr.role]': '\"region\"',\n    '[attr.aria-label]': 'ariaLabel()',\n  },\n})\nexport class WrMarquee {\n  /** Items to display. Each entry is either an image source or a TemplateRef node. */\n  readonly items = input.required<readonly WrMarqueeItem[]>();\n\n  /** Scroll speed in pixels per second. Negative reverses direction. @default 120 */\n  readonly speed = input(120, { transform: numAttr(120) });\n\n  /** Track direction. @default 'left' */\n  readonly direction = input<'left' | 'right'>('left');\n\n  /** Item height in pixels. @default 28 */\n  readonly itemHeight = input(28, { transform: numAttr(28) });\n\n  /** Gap between items in pixels. @default 32 */\n  readonly gap = input(32, { transform: numAttr(32) });\n\n  /** Pause the loop on hover. @default false */\n  readonly pauseOnHover = input(false, { transform: coerceBooleanProperty });\n\n  /** Custom speed (px/s) when hovered. Overrides `pauseOnHover`. */\n  readonly hoverSpeed = input<number | undefined>(undefined, {\n    transform: (v: unknown): number | undefined => (v == null || v === '' ? undefined : coerceNumberProperty(v, 0)),\n  });\n\n  /** Apply edge fade-out gradients. @default false */\n  readonly fadeOut = input(false, { transform: coerceBooleanProperty });\n\n  /** CSS colour for the fade-out gradient. Defaults to the page background. */\n  readonly fadeOutColor = input<string>('');\n\n  /** Scale individual items up on hover. @default false */\n  readonly scaleOnHover = input(false, { transform: coerceBooleanProperty });\n\n  /** Accessible label for the carousel region. @default 'Marquee' */\n  readonly ariaLabel = input('Marquee');\n\n  private readonly trackEl = viewChild.required<ElementRef<HTMLElement>>('track');\n\n  private readonly host = inject<ElementRef<HTMLElement>>(ElementRef);\n  private readonly destroyRef = inject(DestroyRef);\n  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));\n\n  protected readonly seqWidth = signal(0);\n  protected readonly copyCount = signal(MIN_COPIES);\n  protected readonly isHovered = signal(false);\n\n  protected readonly copyIndices = computed(() => Array.from({ length: this.copyCount() }, (_, i) => i));\n\n  /** Resolved hover speed: `hoverSpeed` overrides, else 0 when `pauseOnHover`, else live. */\n  private readonly effectiveHoverSpeed = computed<number | undefined>(() => {\n    const explicit = this.hoverSpeed();\n    if (explicit !== undefined) return explicit;\n    return this.pauseOnHover() ? 0 : undefined;\n  });\n\n  /** Target velocity in px/s, sign baked in. */\n  private readonly targetVelocity = computed(() => {\n    const s = this.speed();\n    const sign = this.direction() === 'left' ? 1 : -1;\n    return Math.abs(s) * sign * (s < 0 ? -1 : 1);\n  });\n\n  constructor() {\n    if (!this.isBrowser) return;\n\n    afterNextRender(() => {\n      this.measure();\n      this.watchResize();\n      this.watchImageLoads();\n      this.startLoop();\n    });\n\n    // Re-measure on input changes that affect layout (items, gap, height).\n    effect(() => {\n      this.items();\n      this.gap();\n      this.itemHeight();\n      queueMicrotask(() => this.measure());\n    });\n  }\n\n  protected onEnter(): void {\n    if (this.effectiveHoverSpeed() !== undefined) this.isHovered.set(true);\n  }\n  protected onLeave(): void {\n    if (this.effectiveHoverSpeed() !== undefined) this.isHovered.set(false);\n  }\n  protected isNodeItem = isNode;\n\n  // Internals\n\n  /** Read first sequence width + decide how many copies cover the viewport. */\n  private measure(): void {\n    const hostEl = this.host.nativeElement;\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (!seqEl) return;\n    const seqWidth = Math.ceil(seqEl.getBoundingClientRect().width);\n    if (seqWidth <= 0) return;\n    this.seqWidth.set(seqWidth);\n    const containerWidth = hostEl.clientWidth || seqWidth;\n    const copies = Math.max(MIN_COPIES, Math.ceil(containerWidth / seqWidth) + COPY_HEADROOM);\n    this.copyCount.set(copies);\n  }\n\n  private watchResize(): void {\n    const hostEl = this.host.nativeElement;\n    if (typeof ResizeObserver === 'undefined') {\n      const onResize = (): void => this.measure();\n      window.addEventListener('resize', onResize);\n      this.destroyRef.onDestroy(() => window.removeEventListener('resize', onResize));\n      return;\n    }\n    const ro = new ResizeObserver(() => this.measure());\n    ro.observe(hostEl);\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (seqEl) ro.observe(seqEl);\n    this.destroyRef.onDestroy(() => ro.disconnect());\n  }\n\n  private watchImageLoads(): void {\n    const hostEl = this.host.nativeElement;\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (!seqEl) return;\n    const imgs = seqEl.querySelectorAll('img');\n    if (imgs.length === 0) return;\n    let remaining = imgs.length;\n    const onDone = (): void => {\n      remaining -= 1;\n      if (remaining === 0) this.measure();\n    };\n    imgs.forEach(img => {\n      if (img.complete) onDone();\n      else {\n        img.addEventListener('load', onDone, { once: true });\n        img.addEventListener('error', onDone, { once: true });\n      }\n    });\n  }\n\n  private startLoop(): void {\n    const track = this.trackEl().nativeElement;\n    let raf = 0;\n    let lastTs: number | null = null;\n    let offset = 0;\n    let velocity = 0;\n\n    const tick = (ts: number): void => {\n      lastTs ??= ts;\n      const dt = Math.max(0, ts - lastTs) / 1000;\n      lastTs = ts;\n\n      const target = this.isHovered() ? (this.effectiveHoverSpeed() ?? this.targetVelocity()) : this.targetVelocity();\n      const ease = 1 - Math.exp(-dt / SMOOTH_TAU);\n      velocity += (target - velocity) * ease;\n\n      const w = this.seqWidth();\n      if (w > 0) {\n        offset = (((offset + velocity * dt) % w) + w) % w;\n        track.style.transform = `translate3d(${-offset}px, 0, 0)`;\n      }\n      raf = requestAnimationFrame(tick);\n    };\n\n    raf = requestAnimationFrame(tick);\n    this.destroyRef.onDestroy(() => cancelAnimationFrame(raf));\n  }\n}\n\nexport type { WrMarqueeImage, WrMarqueeNode, WrMarqueeItem } from './interfaces';\n","<div class=\"wr-marquee__track\" #track (mouseenter)=\"onEnter()\" (mouseleave)=\"onLeave()\">\n  @for (copyIndex of copyIndices(); track copyIndex) {\n    <ul class=\"wr-marquee__list\" role=\"list\" [attr.aria-hidden]=\"copyIndex > 0\" [attr.data-copy]=\"copyIndex\">\n      @for (item of items(); track $index) {\n        <li class=\"wr-marquee__item\" role=\"listitem\">\n          @if (item.href) {\n            <a\n              class=\"wr-marquee__link\"\n              [href]=\"item.href\"\n              [attr.aria-label]=\"\n                isNodeItem(item) ? item.ariaLabel || item.title || 'link' : item.alt || item.title || 'link'\n              \"\n              target=\"_blank\"\n              rel=\"noreferrer noopener\"\n            >\n              <ng-container *ngTemplateOutlet=\"content; context: { $implicit: item }\" />\n            </a>\n          } @else {\n            <ng-container *ngTemplateOutlet=\"content; context: { $implicit: item }\" />\n          }\n        </li>\n      }\n    </ul>\n  }\n</div>\n\n<ng-template #content let-item>\n  @if (isNodeItem(item)) {\n    <span class=\"wr-marquee__node\" [attr.aria-hidden]=\"!!item.href && !item.ariaLabel\">\n      <ng-container *ngTemplateOutlet=\"item.node\" />\n    </span>\n  } @else {\n    <img\n      [src]=\"item.src\"\n      [srcset]=\"item.srcSet || null\"\n      [sizes]=\"item.sizes || null\"\n      [width]=\"item.width || null\"\n      [height]=\"item.height || null\"\n      [alt]=\"item.alt || ''\"\n      [title]=\"item.title || null\"\n      loading=\"lazy\"\n      decoding=\"async\"\n      draggable=\"false\"\n    />\n  }\n</ng-template>\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ngwr-marquee.mjs","sources":["../../../projects/lib/marquee/marquee.ts","../../../projects/lib/marquee/marquee.html","../../../projects/lib/marquee/ngwr-marquee.ts"],"sourcesContent":["/**\n * @license\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE\n *\n * Angular adaptation of the LogoLoop effect by David Haz / reactbits.dev.\n * Original: https://www.reactbits.dev/animations/logo-loop\n *\n * Renamed `wr-marquee` in ngwr — same rAF-driven infinite carousel,\n * supports image + template items, optional fade/scale/pause-on-hover.\n */\n\nimport { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport { NgTemplateOutlet, isPlatformBrowser } from '@angular/common';\nimport {\n  Component,\n  DestroyRef,\n  ElementRef,\n  PLATFORM_ID,\n  ViewEncapsulation,\n  afterNextRender,\n  computed,\n  effect,\n  inject,\n  input,\n  signal,\n  viewChild,\n} from '@angular/core';\n\nimport { useI18nText } from 'ngwr/i18n';\nimport { numAttr } from 'ngwr/utils';\n\nimport type { WrMarqueeNode, WrMarqueeItem } from './interfaces';\n\nconst SMOOTH_TAU = 0.25;\nconst MIN_COPIES = 2;\nconst COPY_HEADROOM = 2;\n\nfunction isNode(item: WrMarqueeItem): item is WrMarqueeNode {\n  return 'node' in item;\n}\n\n/**\n * Endless horizontal marquee. Auto-duplicates the items list until it\n * covers the container width, then animates the track with a smooth\n * rAF-driven scroll. Optional edge fades, scale-on-hover, and pause /\n * variable-speed hover behaviour.\n *\n * @example\n * ```html\n * <wr-marquee\n *   [items]=\"logos\"\n *   [speed]=\"80\"\n *   [gap]=\"48\"\n *   [itemHeight]=\"36\"\n *   [fadeOut]=\"true\"\n *   [scaleOnHover]=\"true\"\n *   [pauseOnHover]=\"true\"\n * />\n * ```\n *\n * @see https://www.reactbits.dev/animations/logo-loop\n */\n@Component({\n  selector: 'wr-marquee',\n  templateUrl: './marquee.html',\n  styleUrl: './marquee.scss',\n  encapsulation: ViewEncapsulation.None,\n  imports: [NgTemplateOutlet],\n  host: {\n    class: 'wr-marquee',\n    '[class.wr-marquee--fade]': 'fadeOut()',\n    '[class.wr-marquee--scale-hover]': 'scaleOnHover()',\n    '[style.--wr-marquee-gap.px]': 'gap()',\n    '[style.--wr-marquee-height.px]': 'itemHeight()',\n    '[style.--wr-marquee-fade-color]': 'fadeOutColor() || null',\n    '[attr.role]': '\"region\"',\n    '[attr.aria-label]': 'resolvedAriaLabel()',\n  },\n})\nexport class WrMarquee {\n  /** Items to display. Each entry is either an image source or a TemplateRef node. */\n  readonly items = input.required<readonly WrMarqueeItem[]>();\n\n  /** Scroll speed in pixels per second. Negative reverses direction. @default 120 */\n  readonly speed = input(120, { transform: numAttr(120) });\n\n  /** Track direction. @default 'left' */\n  readonly direction = input<'left' | 'right'>('left');\n\n  /** Item height in pixels. @default 28 */\n  readonly itemHeight = input(28, { transform: numAttr(28) });\n\n  /** Gap between items in pixels. @default 32 */\n  readonly gap = input(32, { transform: numAttr(32) });\n\n  /** Pause the loop on hover. @default false */\n  readonly pauseOnHover = input(false, { transform: coerceBooleanProperty });\n\n  /** Custom speed (px/s) when hovered. Overrides `pauseOnHover`. */\n  readonly hoverSpeed = input<number | undefined>(undefined, {\n    transform: (v: unknown): number | undefined => (v == null || v === '' ? undefined : coerceNumberProperty(v, 0)),\n  });\n\n  /** Apply edge fade-out gradients. @default false */\n  readonly fadeOut = input(false, { transform: coerceBooleanProperty });\n\n  /** CSS colour for the fade-out gradient. Defaults to the page background. */\n  readonly fadeOutColor = input<string>('');\n\n  /** Scale individual items up on hover. @default false */\n  readonly scaleOnHover = input(false, { transform: coerceBooleanProperty });\n\n  /**\n   * Accessible name for the region. Falls back to `marquee.label`, then\n   * `'Marquee'`.\n   */\n  readonly ariaLabel = input<string | null>(null);\n\n  protected readonly resolvedAriaLabel = useI18nText(this.ariaLabel, 'marquee.label', 'Marquee');\n\n  /**\n   * Name used for an item that links somewhere but carries no text of its own.\n   * Falls back to `marquee.link`, then `'link'` — a bare `'link'` in English was\n   * what a screen reader announced for every unlabelled logo in the strip.\n   */\n  protected readonly resolvedLinkLabel = useI18nText(signal(null).asReadonly(), 'marquee.link', 'link');\n\n  private readonly trackEl = viewChild.required<ElementRef<HTMLElement>>('track');\n\n  private readonly host = inject<ElementRef<HTMLElement>>(ElementRef);\n  private readonly destroyRef = inject(DestroyRef);\n  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));\n\n  protected readonly seqWidth = signal(0);\n  protected readonly copyCount = signal(MIN_COPIES);\n  protected readonly isHovered = signal(false);\n\n  protected readonly copyIndices = computed(() => Array.from({ length: this.copyCount() }, (_, i) => i));\n\n  /** Resolved hover speed: `hoverSpeed` overrides, else 0 when `pauseOnHover`, else live. */\n  private readonly effectiveHoverSpeed = computed<number | undefined>(() => {\n    const explicit = this.hoverSpeed();\n    if (explicit !== undefined) return explicit;\n    return this.pauseOnHover() ? 0 : undefined;\n  });\n\n  /** Target velocity in px/s, sign baked in. */\n  private readonly targetVelocity = computed(() => {\n    const s = this.speed();\n    const sign = this.direction() === 'left' ? 1 : -1;\n    return Math.abs(s) * sign * (s < 0 ? -1 : 1);\n  });\n\n  constructor() {\n    if (!this.isBrowser) return;\n\n    afterNextRender(() => {\n      this.measure();\n      this.watchResize();\n      this.watchImageLoads();\n      this.startLoop();\n    });\n\n    // Re-measure on input changes that affect layout (items, gap, height).\n    effect(() => {\n      this.items();\n      this.gap();\n      this.itemHeight();\n      queueMicrotask(() => this.measure());\n    });\n  }\n\n  protected onEnter(): void {\n    if (this.effectiveHoverSpeed() !== undefined) this.isHovered.set(true);\n  }\n  protected onLeave(): void {\n    if (this.effectiveHoverSpeed() !== undefined) this.isHovered.set(false);\n  }\n  protected isNodeItem = isNode;\n\n  // Internals\n\n  /** Read first sequence width + decide how many copies cover the viewport. */\n  private measure(): void {\n    const hostEl = this.host.nativeElement;\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (!seqEl) return;\n    const seqWidth = Math.ceil(seqEl.getBoundingClientRect().width);\n    if (seqWidth <= 0) return;\n    this.seqWidth.set(seqWidth);\n    const containerWidth = hostEl.clientWidth || seqWidth;\n    const copies = Math.max(MIN_COPIES, Math.ceil(containerWidth / seqWidth) + COPY_HEADROOM);\n    this.copyCount.set(copies);\n  }\n\n  private watchResize(): void {\n    const hostEl = this.host.nativeElement;\n    if (typeof ResizeObserver === 'undefined') {\n      const onResize = (): void => this.measure();\n      window.addEventListener('resize', onResize);\n      this.destroyRef.onDestroy(() => window.removeEventListener('resize', onResize));\n      return;\n    }\n    const ro = new ResizeObserver(() => this.measure());\n    ro.observe(hostEl);\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (seqEl) ro.observe(seqEl);\n    this.destroyRef.onDestroy(() => ro.disconnect());\n  }\n\n  private watchImageLoads(): void {\n    const hostEl = this.host.nativeElement;\n    const seqEl = hostEl.querySelector<HTMLElement>('.wr-marquee__list');\n    if (!seqEl) return;\n    const imgs = seqEl.querySelectorAll('img');\n    if (imgs.length === 0) return;\n    let remaining = imgs.length;\n    const onDone = (): void => {\n      remaining -= 1;\n      if (remaining === 0) this.measure();\n    };\n    imgs.forEach(img => {\n      if (img.complete) onDone();\n      else {\n        img.addEventListener('load', onDone, { once: true });\n        img.addEventListener('error', onDone, { once: true });\n      }\n    });\n  }\n\n  private startLoop(): void {\n    const track = this.trackEl().nativeElement;\n    let raf = 0;\n    let lastTs: number | null = null;\n    let offset = 0;\n    let velocity = 0;\n\n    const tick = (ts: number): void => {\n      lastTs ??= ts;\n      const dt = Math.max(0, ts - lastTs) / 1000;\n      lastTs = ts;\n\n      const target = this.isHovered() ? (this.effectiveHoverSpeed() ?? this.targetVelocity()) : this.targetVelocity();\n      const ease = 1 - Math.exp(-dt / SMOOTH_TAU);\n      velocity += (target - velocity) * ease;\n\n      const w = this.seqWidth();\n      if (w > 0) {\n        offset = (((offset + velocity * dt) % w) + w) % w;\n        track.style.transform = `translate3d(${-offset}px, 0, 0)`;\n      }\n      raf = requestAnimationFrame(tick);\n    };\n\n    raf = requestAnimationFrame(tick);\n    this.destroyRef.onDestroy(() => cancelAnimationFrame(raf));\n  }\n}\n\nexport type { WrMarqueeImage, WrMarqueeNode, WrMarqueeItem } from './interfaces';\n","<div class=\"wr-marquee__track\" #track (mouseenter)=\"onEnter()\" (mouseleave)=\"onLeave()\">\n  @for (copyIndex of copyIndices(); track copyIndex) {\n    <ul class=\"wr-marquee__list\" role=\"list\" [attr.aria-hidden]=\"copyIndex > 0\" [attr.data-copy]=\"copyIndex\">\n      @for (item of items(); track $index) {\n        <li class=\"wr-marquee__item\" role=\"listitem\">\n          @if (item.href) {\n            <a\n              class=\"wr-marquee__link\"\n              [href]=\"item.href\"\n              [attr.aria-label]=\"\n                (isNodeItem(item) ? item.ariaLabel || item.title : item.alt || item.title) || resolvedLinkLabel()\n              \"\n              target=\"_blank\"\n              rel=\"noreferrer noopener\"\n            >\n              <ng-container *ngTemplateOutlet=\"content; context: { $implicit: item }\" />\n            </a>\n          } @else {\n            <ng-container *ngTemplateOutlet=\"content; context: { $implicit: item }\" />\n          }\n        </li>\n      }\n    </ul>\n  }\n</div>\n\n<ng-template #content let-item>\n  @if (isNodeItem(item)) {\n    <span class=\"wr-marquee__node\" [attr.aria-hidden]=\"!!item.href && !item.ariaLabel\">\n      <ng-container *ngTemplateOutlet=\"item.node\" />\n    </span>\n  } @else {\n    <img\n      [src]=\"item.src\"\n      [srcset]=\"item.srcSet || null\"\n      [sizes]=\"item.sizes || null\"\n      [width]=\"item.width || null\"\n      [height]=\"item.height || null\"\n      [alt]=\"item.alt || ''\"\n      [title]=\"item.title || null\"\n      loading=\"lazy\"\n      decoding=\"async\"\n      draggable=\"false\"\n    />\n  }\n</ng-template>\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngwr-mention-testing.mjs

@@ -0,0 +1,513 @@
+import { ComponentHarness, HarnessPredicate, TestKey } from '@angular/cdk/testing';
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/**
+ * Test harness for one suggestion inside a `[wrMention]` panel.
+ *
+ * Reach these through {@link WrMentionHarness.getOptions}, never off the document:
+ * the panel is a portal in the shared overlay container, so a bare query answers
+ * with whichever mention field opened first.
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrMentionOptionHarness extends ComponentHarness {
+    /** One `<li role="option">` in the panel's listbox. */
+    static hostSelector = '.wr-mention-panel__option';
+    /** Build a predicate that narrows the query. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrMentionOptionHarness, options)
+            .addOption('text', options.text, (harness, text) => HarnessPredicate.stringMatches(harness.getText(), text))
+            .addOption('active', options.active, async (harness, active) => (await harness.isActive()) === active);
+    }
+    /** The suggestion's label — whatever `displayWith` returned for the item. */
+    async getText() {
+        return (await this.host()).text();
+    }
+    /**
+     * Whether the cursor is on this suggestion.
+     *
+     * Read from `aria-selected` rather than from the `--active` modifier class. The
+     * two are set from the same index, so they agree — but the ARIA state is what a
+     * screen reader is told, and the class is only what the highlight is painted
+     * with.
+     */
+    async isActive() {
+        return (await (await this.host()).getAttribute('aria-selected')) === 'true';
+    }
+    /**
+     * The suggestion's id — the value the field names in `aria-activedescendant`.
+     *
+     * The only link between the two DOM trees: the panel is in the overlay
+     * container, not inside the field, so this id is how the reference reaches it
+     * at all.
+     */
+    async getId() {
+        return (await this.host()).getAttribute('id');
+    }
+    /**
+     * Pick this suggestion with the mouse.
+     *
+     * Needs no layout, so it works here: the panel commits on `mousedown` —
+     * deliberately, so the field never loses focus and the caret stays put — and
+     * the CDK's no-arg click dispatches `mousedown` at the head of its sequence
+     * without any hit test.
+     */
+    async click() {
+        return (await this.host()).click();
+    }
+    /**
+     * Move the pointer onto this suggestion, which makes it the active one.
+     *
+     * Hover and the arrow keys drive the same single cursor, so a spec can assert
+     * the mouse path through {@link WrMentionHarness.getActiveOptionLabel} exactly
+     * as it does the keyboard one.
+     */
+    async hover() {
+        return (await this.host()).hover();
+    }
+}
+
+/**
+ * @license
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
+ */
+/** How long {@link WrMentionHarness.blur} waits for the deferred close, in ms. Generous next to the 120ms grace period. */
+const CLOSE_TIMEOUT = 1000;
+/** How often it re-checks, in ms. */
+const POLL_STEP = 10;
+/**
+ * The real `setTimeout`, captured at module load — before a spec can install fake
+ * timers.
+ *
+ * {@link WrMentionHarness.blur} has to let REAL time pass: the close on blur is a
+ * plain `setTimeout` inside the directive, and under zoneless change detection
+ * `whenStable()` resolves without waiting for a macrotask. Reading a faked global
+ * instead would mean the sleep never fires and the harness hangs where it should
+ * fail with the message it prepared.
+ */
+const realSetTimeout = globalThis.setTimeout;
+function sleep(ms) {
+    return new Promise(resolve => {
+        realSetTimeout(resolve, ms);
+    });
+}
+/**
+ * Test harness for `[wrMention]` — the field, and the suggestion panel it opens
+ * at the caret.
+ *
+ * The harness matches the FIELD, because that is the only part of a mention in the
+ * fixture: the panel is a `ComponentPortal` in the shared overlay container, a
+ * sibling of the whole app. Suggestions are read through the document root, scoped
+ * by the id the field publishes as `aria-controls` — which is what keeps two
+ * mention fields on one page from answering with each other's suggestions.
+ *
+ * **The field is not a combobox, and it has no `aria-expanded`.** Both are
+ * deliberate (the source spells out why: it holds prose, `role="combobox"` is
+ * disallowed on `<textarea>` and would drop `aria-multiline`, and `aria-expanded`
+ * is not a supported state of `role="textbox"`), and both shape this harness.
+ * `aria-controls` is STATIC — it names the listbox even while there is no listbox —
+ * so {@link isOpen} asks whether the listbox EXISTS instead of reading a state
+ * flag, and "a list appeared" reaches a screen reader through the live region that
+ * {@link getStatusMessage} reads.
+ *
+ * **The panel's POSITION is not testable in jsdom, so nothing here reports it.**
+ * `caret.ts` places the panel by measuring a mirror `<div>` with
+ * `getBoundingClientRect`, and jsdom has no layout: every rect is zeros, so the
+ * measurement collapses to the origin. The overlay still lands on finite numbers —
+ * `line-height` computes to `normal` there, so `caret.ts` falls back to
+ * `font-size * 1.2` and the pane is offset by that alone (a measured
+ * `margin-top: 23.2px`, `margin-left: 0px` on a default fixture) — which is
+ * precisely the problem: every one of them is an artefact of the environment
+ * rather than a fact about the component. Assert placement in a real browser.
+ *
+ * @example
+ * ```ts
+ * const mention = await loader.getHarness(WrMentionHarness);
+ *
+ * await mention.type('hey @al');
+ * expect(await mention.getOptionLabels()).toEqual(['Alan Turing', 'Linus Torvalds']);
+ *
+ * await mention.commit();
+ * expect(await mention.getValue()).toBe('hey @Alan Turing ');
+ * ```
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrMentionHarness extends ComponentHarness {
+    /** The directive's host. Both tags, since the directive drives either one. */
+    static hostSelector = 'input[wrMention], textarea[wrMention]';
+    /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrMentionHarness, options)
+            .addOption('value', options.value, (harness, value) => HarnessPredicate.stringMatches(harness.getValue(), value))
+            .addOption('placeholder', options.placeholder, (harness, placeholder) => HarnessPredicate.stringMatches(harness.getPlaceholder(), placeholder))
+            .addOption('open', options.open, async (harness, open) => (await harness.isOpen()) === open);
+    }
+    /** The field's whole text, mention fragments and prose alike. */
+    async getValue() {
+        return (await this.host()).getProperty('value');
+    }
+    /** The field's placeholder, or `''` when it has none. */
+    async getPlaceholder() {
+        return (await this.host()).getProperty('placeholder');
+    }
+    /**
+     * Type into the field one keystroke at a time, APPENDING to whatever is there.
+     *
+     * The realistic path, and the one that exercises detection the way a person
+     * does: the directive re-reads the text before the caret on every `input`, so
+     * `type('hey @al')` opens the panel on the `@` and then narrows it twice.
+     *
+     * Focuses the field, which BLURS whatever was focused before — and a blurred
+     * mention field closes its own panel. Use {@link setValue} when a spec needs two
+     * fields suggesting at the same time.
+     */
+    async type(text) {
+        return (await this.host()).sendKeys(text);
+    }
+    /**
+     * Replace the field's whole text and let the directive detect once.
+     *
+     * The `input` event is dispatched by hand rather than through keystrokes so the
+     * field is never focused — which is the only way to get two mention panels open
+     * at once, since focusing one field blurs the other and blur closes its panel.
+     * The caret lands at the end of the new text, where detection looks.
+     */
+    async setValue(text) {
+        const host = await this.host();
+        await host.setInputValue(text);
+        await host.dispatchEvent('input');
+    }
+    /** Empty the field. The panel goes with it — there is no trigger char left to detect. */
+    async clear() {
+        return (await this.host()).clear();
+    }
+    /**
+     * Click the field.
+     *
+     * Re-opens the suggestions when the caret is still sitting inside a mention —
+     * the directive re-detects on click, which is how a user who pressed Escape (or
+     * clicked away and back) gets the panel again without retyping. Needs no layout:
+     * the CDK dispatches the event on the element rather than hit-testing a point.
+     */
+    async click() {
+        return (await this.host()).click();
+    }
+    /**
+     * Whether the panel is offering suggestions.
+     *
+     * Asks whether this field's listbox exists, because the field publishes no
+     * open/closed state to read: `aria-expanded` is not a supported state of
+     * `role="textbox"` (axe rates it a critical violation), and `aria-controls` is
+     * static here, so its presence says nothing.
+     */
+    async isOpen() {
+        return (await this.listboxOrNull()) !== null;
+    }
+    /**
+     * The field's `aria-autocomplete` — `'list'`, permanently.
+     *
+     * A capability, not a state: ARIA says authors should not toggle it to signal
+     * that suggestions are showing, and being static is what makes the feature
+     * discoverable on focus, before a trigger char is ever typed. {@link isOpen}
+     * answers the state.
+     */
+    async getAutocomplete() {
+        return (await this.host()).getAttribute('aria-autocomplete');
+    }
+    /**
+     * The role the field PROMISES its popup will announce, from `aria-haspopup` —
+     * `'listbox'`. Required alongside `aria-autocomplete="list"`, and it has to name
+     * the popup's real role, which {@link getListboxRole} reads back off the panel.
+     */
+    async getPopupRole() {
+        return (await this.host()).getAttribute('aria-haspopup');
+    }
+    /** The role the open panel announces — `'listbox'`. Throws while the panel is closed. */
+    async getListboxRole() {
+        return (await this.listbox()).getAttribute('role');
+    }
+    /**
+     * The panel's accessible name.
+     *
+     * ARIA requires a `role="listbox"` to have one, and a consumer never renders the
+     * panel themselves — so the directive supplies it from the i18n catalog
+     * (`mention.listbox`).
+     */
+    async getListboxLabel() {
+        return (await this.listbox()).getAttribute('aria-label');
+    }
+    /**
+     * The suggestions on offer, in DOM order.
+     *
+     * The whole list a user can reach, not a window onto a longer one: the directive
+     * slices the matches at `maxResults` (8 by default) before rendering, which is
+     * why this panel needs no virtualisation.
+     *
+     * Throws while the panel is closed — the options do not exist anywhere until the
+     * portal is attached, and an empty array reads like a panel that rendered
+     * nothing.
+     */
+    async getOptions(filters = {}) {
+        const loader = await this.listboxLoader();
+        return loader.getAllHarnesses(WrMentionOptionHarness.with(filters));
+    }
+    /** The labels of the suggestions on offer, in DOM order. */
+    async getOptionLabels() {
+        const options = await this.getOptions();
+        return Promise.all(options.map(option => option.getText()));
+    }
+    /**
+     * The id the field names in `aria-activedescendant`, or `null` when it names
+     * nothing.
+     *
+     * The strict half of the field's two references. `aria-controls` is allowed to
+     * dangle (see {@link isOpen}); this one is not — naming an element that is not
+     * in the document is an author error no browser reports, it simply stops
+     * announcing options. So `null` is the CORRECT answer while the panel is closed,
+     * and worth asserting there.
+     */
+    async getActiveOptionId() {
+        return (await this.host()).getAttribute('aria-activedescendant');
+    }
+    /**
+     * The label a screen reader announces as the active suggestion.
+     *
+     * Resolved through `aria-activedescendant` the way an assistive technology
+     * would, rather than by hunting for the active class — which is why it throws on
+     * a reference that resolves to nothing instead of quietly reporting what the
+     * class says.
+     */
+    async getActiveOptionLabel() {
+        const active = await this.activeOption('getActiveOptionLabel');
+        return active.text();
+    }
+    /**
+     * Where the active suggestion sits in {@link getOptions}, 0-based.
+     *
+     * Matched by id rather than counted by class, so the answer is the one
+     * `aria-activedescendant` actually points at.
+     */
+    async getActiveOptionIndex() {
+        const id = await this.requireActiveOptionId('getActiveOptionIndex');
+        const options = await this.getOptions();
+        for (let index = 0; index < options.length; index++) {
+            if ((await options[index].getId()) === id)
+                return index;
+        }
+        throw new Error(`WrMentionHarness.getActiveOptionIndex(): aria-activedescendant names "${id}", which is not one of ` +
+            `the ${options.length} suggestions on offer.`);
+    }
+    /**
+     * Move the cursor down one suggestion, wrapping past the last back to the first.
+     *
+     * ArrowDown — and `aria-activedescendant` is the whole navigation model here,
+     * because the options are never focused: focus stays in the field so the user can
+     * keep typing the query.
+     *
+     * Throws while the panel is closed, where ArrowDown belongs to the field.
+     */
+    async nextOption() {
+        await this.requireOpen('nextOption');
+        return (await this.host()).sendKeys(TestKey.DOWN_ARROW);
+    }
+    /** Move the cursor up one suggestion, wrapping past the first round to the last. */
+    async previousOption() {
+        await this.requireOpen('previousOption');
+        return (await this.host()).sendKeys(TestKey.UP_ARROW);
+    }
+    /**
+     * Insert the active suggestion with Enter.
+     *
+     * The trigger char and the query are replaced by `valueWith(item, trigger)`
+     * (`@Label` by default) plus a trailing space, the caret lands after that space,
+     * the panel closes and `(wrMentionSelected)` fires with the item, the trigger
+     * char and the query.
+     *
+     * Throws while the panel is closed — Enter is the field's own key there (a
+     * newline in a `<textarea>`), and swallowing it would be the bug.
+     */
+    async commit() {
+        await this.requireOpen('commit');
+        return (await this.host()).sendKeys(TestKey.ENTER);
+    }
+    /**
+     * Insert the active suggestion with Tab instead.
+     *
+     * The same commit: the directive takes Tab as a second confirm key and
+     * `preventDefault`s it, so focus stays in the field rather than leaving for the
+     * next control.
+     */
+    async commitWithTab() {
+        await this.requireOpen('commitWithTab');
+        return (await this.host()).sendKeys(TestKey.TAB);
+    }
+    /**
+     * Pick the first suggestion matching the filters, with the mouse.
+     *
+     * Opens nothing by itself — type a trigger char first. Names what the panel does
+     * offer when nothing matches, since a silent no-op here surfaces as an
+     * unexplained unchanged field further down the spec.
+     */
+    async pick(filters) {
+        const [option] = await this.getOptions(filters);
+        if (!option) {
+            const offered = await this.getOptionLabels();
+            throw new Error(`WrMentionHarness.pick(): no suggestion matched ${JSON.stringify(filters)}. ` +
+                `The panel offers: ${offered.join(', ')}.`);
+        }
+        return option.click();
+    }
+    /**
+     * Dismiss the panel with Escape, leaving the typed text — trigger char and
+     * query included — exactly as it is. A closed panel is left alone.
+     *
+     * Sends the WHOLE keystroke, keydown and keyup, as a real Escape is. That
+     * matters here: the caret has not moved, so a keyup the directive re-detected on
+     * would reopen the panel this just closed, and a harness that dispatched only
+     * the keydown would report a dismissal the user never got.
+     */
+    async dismiss() {
+        if (!(await this.isOpen()))
+            return;
+        return (await this.host()).sendKeys(TestKey.ESCAPE);
+    }
+    /**
+     * Blur the field and wait for the panel to go.
+     *
+     * The close is deferred by 120ms so a `mousedown` on a suggestion lands first,
+     * and that is a real `setTimeout`: under zoneless change detection nothing
+     * flushes it for us, so this waits out REAL time. A spec on fake timers should
+     * drive its own clock and read {@link isOpen} instead of calling this.
+     */
+    async blur(timeout = CLOSE_TIMEOUT) {
+        await (await this.host()).blur();
+        for (let waited = 0; waited <= timeout; waited += POLL_STEP) {
+            if (!(await this.isOpen()))
+                return;
+            await sleep(POLL_STEP);
+            await this.forceStabilize();
+        }
+        throw new Error(`WrMentionHarness.blur(): the panel is still showing ${timeout}ms after the blur. The close is ` +
+            'deferred so that a click on a suggestion lands first, and this wait uses real time — a spec on ' +
+            'fake timers has to advance the clock itself and read isOpen().');
+    }
+    /**
+     * What the live region currently says.
+     *
+     * This is the announcement channel the field has INSTEAD of ARIA state, and
+     * three things reach a screen reader only through it: how many suggestions
+     * appeared, that NOTHING matched — the panel closes in that case, so there is no
+     * DOM left to inspect and no state on the field to read — and what was inserted
+     * on commit.
+     *
+     * Throws when more than one mention field is mounted. The region is parked on
+     * `<body>` rather than in the panel (which is disposed on every keystroke that
+     * leaves a mention, and a live region has to pre-exist its own text to be
+     * announced at all), and it carries no id tying it to a field — so with two
+     * fields around, the harness genuinely cannot tell which region is this one's.
+     * Answering with whichever came first would be worse than refusing: assert
+     * announcements in a fixture holding a single mention field.
+     */
+    async getStatusMessage() {
+        const regions = await this.documentRootLocatorFactory().locatorForAll('.wr-mention__status')();
+        if (regions.length === 0) {
+            throw new Error('WrMentionHarness.getStatusMessage(): no mention live region is in the document. The directive ' +
+                'appends it to <body> in the browser only, so there is none under SSR.');
+        }
+        if (regions.length > 1) {
+            throw new Error(`WrMentionHarness.getStatusMessage(): ${regions.length} mention live regions are in the document ` +
+                'and none of them names the field it belongs to, so this cannot say which one is yours. Assert ' +
+                'the announcement in a fixture with a single mention field.');
+        }
+        return regions[0].text();
+    }
+    /** Move keyboard focus to the field. Focusing alone opens nothing — the panel needs a trigger char. */
+    async focus() {
+        return (await this.host()).focus();
+    }
+    /** Whether the field holds keyboard focus. It keeps it while the panel is open, by design. */
+    async isFocused() {
+        return (await this.host()).isFocused();
+    }
+    /**
+     * A loader scoped to THIS field's listbox.
+     *
+     * Scoped by the id the field publishes as `aria-controls`, never by
+     * `.wr-mention-panel`: the overlay container is shared by every mention on the
+     * page, so a class query would answer with whichever field opened first.
+     */
+    async listboxLoader() {
+        // Resolve the element first, so a closed panel fails with the message below
+        // rather than with the CDK's generic "expected to find element" error.
+        await this.listbox();
+        return this.documentRootLocatorFactory().harnessLoaderFor(`#${await this.listboxId()}`);
+    }
+    /** This field's listbox in the overlay. Throws when the panel is closed. */
+    async listbox() {
+        const listbox = await this.listboxOrNull();
+        if (!listbox) {
+            throw new Error('WrMentionHarness: no suggestions are showing, so there is nothing inside the panel to read. It ' +
+                'exists only while the caret sits after a trigger char that matched something — type() one in ' +
+                'first. (The field publishes aria-controls whether or not the panel is up, so that attribute is ' +
+                'not the check.)');
+        }
+        return listbox;
+    }
+    /** This field's listbox, or `null` when the panel is closed. */
+    async listboxOrNull() {
+        return this.documentRootLocatorFactory().locatorForOptional(`#${await this.listboxId()}`)();
+    }
+    /** The id the field names in `aria-controls`, which its listbox carries. */
+    async listboxId() {
+        const id = await (await this.host()).getAttribute('aria-controls');
+        if (!id) {
+            throw new Error('WrMentionHarness: this field publishes no aria-controls. That is a static host binding on ' +
+                '[wrMention] — rendered even under SSR — so the element matched here is probably not a mention ' +
+                'field at all.');
+        }
+        return id;
+    }
+    /** The element `aria-activedescendant` points at, or a targeted failure. */
+    async activeOption(method) {
+        const id = await this.requireActiveOptionId(method);
+        const active = await this.documentRootLocatorFactory().locatorForOptional(`#${id}`)();
+        if (!active) {
+            throw new Error(`WrMentionHarness.${method}(): aria-activedescendant names "${id}", which is not in the document. ` +
+                'A dangling reference stops a screen reader announcing options and no browser reports it, so it ' +
+                'is a real failure rather than a harness one.');
+        }
+        return active;
+    }
+    /** The active option's id, or a targeted failure. */
+    async requireActiveOptionId(method) {
+        const id = await this.getActiveOptionId();
+        if (!id) {
+            throw new Error(`WrMentionHarness.${method}(): the field names no active suggestion. That is the correct state ` +
+                'while the panel is closed — check isOpen() first.');
+        }
+        return id;
+    }
+    /** Refuse a keystroke that would mean something else entirely with the panel closed. */
+    async requireOpen(method) {
+        if (await this.isOpen())
+            return;
+        throw new Error(`WrMentionHarness.${method}(): no suggestions are showing, so this key belongs to the field itself ` +
+            '— Enter is a newline, Tab leaves for the next control, and the arrows move the caret. Type a ' +
+            'trigger char first.');
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { WrMentionHarness, WrMentionOptionHarness };
+//# sourceMappingURL=ngwr-mention-testing.mjs.map