ngwr 10.2.1 → 11.0.0

package/fesm2022/ngwr-carousel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngwr-carousel.mjs","sources":["../../../projects/lib/carousel/carousel-slide.ts","../../../projects/lib/carousel/carousel.ts","../../../projects/lib/carousel/carousel.html","../../../projects/lib/carousel/ngwr-carousel.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\nimport { Component, ViewEncapsulation } from '@angular/core';\n\n/**\n * One slide in a {@link WrCarousel}. Holds whatever content you\n * project — image, card, video, anything.\n */\n@Component({\n  selector: 'wr-carousel-slide',\n  template: '<ng-content />',\n  encapsulation: ViewEncapsulation.None,\n  host: { class: 'wr-carousel-slide', role: 'group', 'aria-roledescription': 'slide' },\n})\nexport class WrCarouselSlide {}\n","/**\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\nimport { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport {\n  Component,\n  DestroyRef,\n  ViewEncapsulation,\n  computed,\n  contentChildren,\n  effect,\n  inject,\n  input,\n  model,\n  signal,\n} from '@angular/core';\n\nimport { useI18nText } from 'ngwr/i18n';\n\nimport { WrCarouselSlide } from './carousel-slide';\n\n/**\n * Slide carousel. Project `<wr-carousel-slide>` children — the carousel\n * snaps between them with prev/next buttons and optional dots / autoplay.\n *\n * @example\n * ```html\n * <wr-carousel [(active)]=\"i\" autoplay>\n *   <wr-carousel-slide><img src=\"a.jpg\" /></wr-carousel-slide>\n *   <wr-carousel-slide><img src=\"b.jpg\" /></wr-carousel-slide>\n *   <wr-carousel-slide><img src=\"c.jpg\" /></wr-carousel-slide>\n * </wr-carousel>\n * ```\n *\n * @see https://ngwr.dev/reference/components/carousel\n */\n@Component({\n  selector: 'wr-carousel',\n  templateUrl: './carousel.html',\n  encapsulation: ViewEncapsulation.None,\n  host: { class: 'wr-carousel' },\n})\nexport class WrCarousel {\n  /** Active slide index. Two-way bindable. @default 0 */\n  /** Accessible name of the previous-slide button. Falls back to `carousel.prev`. */\n  readonly prevLabel = input<string | null>(null);\n\n  /** Accessible name of the next-slide button. Falls back to `carousel.next`. */\n  readonly nextLabel = input<string | null>(null);\n\n  /** Accessible name of the dot group. Falls back to `carousel.pagination`. */\n  readonly paginationLabel = input<string | null>(null);\n\n  protected readonly resolvedPrevLabel = useI18nText(this.prevLabel, 'carousel.prev', 'Previous slide');\n  protected readonly resolvedNextLabel = useI18nText(this.nextLabel, 'carousel.next', 'Next slide');\n  protected readonly resolvedPaginationLabel = useI18nText(\n    this.paginationLabel,\n    'carousel.pagination',\n    'Carousel pagination'\n  );\n\n  readonly active = model(0);\n\n  /** Show prev / next arrow buttons. @default true */\n  readonly showArrows = input(true, { transform: coerceBooleanProperty });\n\n  /** Show dot indicators below the slides. @default true */\n  readonly showDots = input(true, { transform: coerceBooleanProperty });\n\n  /** Auto-advance slides. @default false */\n  readonly autoplay = input(false, { transform: coerceBooleanProperty });\n\n  /** Autoplay interval (ms). @default 4000 */\n  readonly intervalMs = input(4000, {\n    transform: (v: unknown): number => Math.max(500, coerceNumberProperty(v, 4000)),\n  });\n\n  /** Wrap around at the ends. @default true */\n  readonly loop = input(true, { transform: coerceBooleanProperty });\n\n  protected readonly slides = contentChildren(WrCarouselSlide);\n  protected readonly count = computed(() => this.slides().length);\n\n  /** Live horizontal drag offset (px) during a touch swipe. */\n  protected readonly dragX = signal(0);\n  protected readonly dragging = signal(false);\n\n  /** CSS transform for the track — the per-slide offset plus any live drag. */\n  protected readonly trackStyle = computed(() => {\n    const base = -this.active() * 100;\n    const drag = this.dragX();\n    return drag === 0 ? `translateX(${base}%)` : `translateX(calc(${base}% + ${drag}px))`;\n  });\n\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly paused = signal(false);\n  private readonly destroyRef = inject(DestroyRef);\n\n  constructor() {\n    effect(() => {\n      if (this.timer) clearInterval(this.timer);\n      this.timer = null;\n      if (!this.autoplay() || this.paused() || this.count() < 2) return;\n      const interval = this.intervalMs();\n      this.timer = setInterval(() => this.next(), interval);\n    });\n\n    this.destroyRef.onDestroy(() => {\n      if (this.timer) clearInterval(this.timer);\n    });\n  }\n\n  protected onMouseEnter(): void {\n    this.paused.set(true);\n  }\n\n  protected onMouseLeave(): void {\n    this.paused.set(false);\n  }\n\n  // Imperative\n\n  goTo(index: number): void {\n    const max = this.count() - 1;\n    if (max < 0) return;\n    if (this.loop()) {\n      const next = ((index % this.count()) + this.count()) % this.count();\n      this.active.set(next);\n    } else {\n      this.active.set(Math.min(Math.max(0, index), max));\n    }\n  }\n\n  next(): void {\n    this.goTo(this.active() + 1);\n  }\n\n  prev(): void {\n    this.goTo(this.active() - 1);\n  }\n\n  // Swipe navigation — the track follows the finger; releasing past ~20% of the\n  // viewport advances a slide (left = next, right = prev), otherwise snaps back.\n\n  private swipeStartX = 0;\n\n  protected onSwipeStart(event: TouchEvent): void {\n    const touch = event.touches[0];\n    if (!touch) return;\n    this.swipeStartX = touch.clientX;\n    this.dragging.set(true);\n    this.paused.set(true); // hold autoplay while dragging\n  }\n\n  protected onSwipeMove(event: TouchEvent): void {\n    if (!this.dragging()) return;\n    const touch = event.touches[0];\n    if (!touch) return;\n    this.dragX.set(touch.clientX - this.swipeStartX);\n  }\n\n  protected onSwipeEnd(event: TouchEvent, viewport: HTMLElement): void {\n    if (!this.dragging()) return;\n    this.dragging.set(false);\n    const dx = this.dragX();\n    this.dragX.set(0);\n    this.paused.set(false);\n    const threshold = (viewport.offsetWidth || 0) * 0.2;\n    if (dx <= -threshold) this.next();\n    else if (dx >= threshold) this.prev();\n  }\n}\n","<div\n  #viewport\n  class=\"wr-carousel__viewport\"\n  aria-roledescription=\"carousel\"\n  (mouseenter)=\"onMouseEnter()\"\n  (mouseleave)=\"onMouseLeave()\"\n  (touchstart)=\"onSwipeStart($event)\"\n  (touchmove)=\"onSwipeMove($event)\"\n  (touchend)=\"onSwipeEnd($event, viewport)\"\n  (touchcancel)=\"onSwipeEnd($event, viewport)\"\n>\n  <div class=\"wr-carousel__track\" [style.transform]=\"trackStyle()\" [style.transition]=\"dragging() ? 'none' : null\">\n    <ng-content />\n  </div>\n</div>\n\n@if (showArrows() && count() > 1) {\n  <button\n    type=\"button\"\n    class=\"wr-carousel__nav wr-carousel__nav--prev\"\n    [attr.aria-label]=\"resolvedPrevLabel()\"\n    (click)=\"prev()\"\n  >\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 14 14\" aria-hidden=\"true\">\n      <path d=\"M9 2 L4 7 L9 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" />\n    </svg>\n  </button>\n  <button\n    type=\"button\"\n    class=\"wr-carousel__nav wr-carousel__nav--next\"\n    [attr.aria-label]=\"resolvedNextLabel()\"\n    (click)=\"next()\"\n  >\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 14 14\" aria-hidden=\"true\">\n      <path d=\"M5 2 L10 7 L5 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" />\n    </svg>\n  </button>\n}\n\n@if (showDots() && count() > 1) {\n  <div class=\"wr-carousel__dots\" role=\"group\" [attr.aria-label]=\"resolvedPaginationLabel()\">\n    @for (slide of slides(); track $index) {\n      <button\n        type=\"button\"\n        class=\"wr-carousel__dot\"\n        [class.wr-carousel__dot--active]=\"$index === active()\"\n        [attr.aria-current]=\"$index === active() ? 'true' : null\"\n        [attr.aria-label]=\"`Go to slide ${$index + 1}`\"\n        (click)=\"goTo($index)\"\n      ></button>\n    }\n  </div>\n}\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-carousel.mjs","sources":["../../../projects/lib/carousel/carousel-slide.ts","../../../projects/lib/carousel/carousel.ts","../../../projects/lib/carousel/carousel.html","../../../projects/lib/carousel/ngwr-carousel.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\nimport { Component, ViewEncapsulation } from '@angular/core';\n\n/**\n * One slide in a {@link WrCarousel}. Holds whatever content you\n * project — image, card, video, anything.\n */\n@Component({\n  selector: 'wr-carousel-slide',\n  template: '<ng-content />',\n  encapsulation: ViewEncapsulation.None,\n  host: { class: 'wr-carousel-slide', role: 'group', 'aria-roledescription': 'slide' },\n})\nexport class WrCarouselSlide {}\n","/**\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\nimport { Directionality } from '@angular/cdk/bidi';\nimport { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport { isPlatformBrowser } from '@angular/common';\nimport {\n  Component,\n  DestroyRef,\n  PLATFORM_ID,\n  ViewEncapsulation,\n  computed,\n  contentChildren,\n  effect,\n  inject,\n  input,\n  model,\n  signal,\n} from '@angular/core';\n\nimport { useI18nFormatter, useI18nText } from 'ngwr/i18n';\n\nimport { WrCarouselSlide } from './carousel-slide';\n\n/**\n * Slide carousel. Project `<wr-carousel-slide>` children — the carousel\n * snaps between them with prev/next buttons and optional dots / autoplay.\n *\n * @example\n * ```html\n * <wr-carousel [(active)]=\"i\" autoplay>\n *   <wr-carousel-slide><img src=\"a.jpg\" /></wr-carousel-slide>\n *   <wr-carousel-slide><img src=\"b.jpg\" /></wr-carousel-slide>\n *   <wr-carousel-slide><img src=\"c.jpg\" /></wr-carousel-slide>\n * </wr-carousel>\n * ```\n *\n * @see https://ngwr.dev/reference/components/carousel\n */\n@Component({\n  selector: 'wr-carousel',\n  templateUrl: './carousel.html',\n  encapsulation: ViewEncapsulation.None,\n  // On the HOST, not the viewport: the arrows and dots are the viewport's siblings, so\n  // viewport-scoped listeners let a slide change under a cursor aiming at an arrow.\n  // `focusin` / `focusout` are the keyboard half — WCAG 2.2.2 wants a way to stop\n  // moving content, and hovering is not one for someone who never uses a mouse.\n  host: {\n    class: 'wr-carousel',\n    '(mouseenter)': 'onPauseIn()',\n    '(mouseleave)': 'onPauseOut()',\n    '(focusin)': 'onPauseIn()',\n    '(focusout)': 'onPauseOut()',\n  },\n})\nexport class WrCarousel {\n  /** Accessible name of the previous-slide button. Falls back to `carousel.prev`. */\n  readonly prevLabel = input<string | null>(null);\n\n  /** Accessible name of the next-slide button. Falls back to `carousel.next`. */\n  readonly nextLabel = input<string | null>(null);\n\n  /** Accessible name of the dot group. Falls back to `carousel.pagination`. */\n  readonly paginationLabel = input<string | null>(null);\n\n  protected readonly resolvedPrevLabel = useI18nText(this.prevLabel, 'carousel.prev', 'Previous slide');\n  protected readonly resolvedNextLabel = useI18nText(this.nextLabel, 'carousel.next', 'Next slide');\n  protected readonly resolvedPaginationLabel = useI18nText(\n    this.paginationLabel,\n    'carousel.pagination',\n    'Carousel pagination'\n  );\n\n  /** Accessible name of the carousel itself. Falls back to `carousel.label`. */\n  readonly ariaLabel = input<string | null>(null);\n\n  protected readonly resolvedAriaLabel = useI18nText(this.ariaLabel, 'carousel.label', 'Carousel');\n\n  // The three labels above route through the catalog; this one was a hard-coded\n  // English template, so a localized app got two languages in one pagination strip.\n  protected readonly slideLabel = useI18nFormatter('carousel.goToSlide', 'Go to slide {{index}}');\n\n  /** Active slide index. Two-way bindable. @default 0 */\n  readonly active = model(0);\n\n  /** Show prev / next arrow buttons. @default true */\n  readonly showArrows = input(true, { transform: coerceBooleanProperty });\n\n  /** Show dot indicators below the slides. @default true */\n  readonly showDots = input(true, { transform: coerceBooleanProperty });\n\n  /** Auto-advance slides. @default false */\n  readonly autoplay = input(false, { transform: coerceBooleanProperty });\n\n  /** Autoplay interval (ms). @default 4000 */\n  readonly intervalMs = input(4000, {\n    transform: (v: unknown): number => Math.max(500, coerceNumberProperty(v, 4000)),\n  });\n\n  /** Wrap around at the ends. @default true */\n  readonly loop = input(true, { transform: coerceBooleanProperty });\n\n  protected readonly slides = contentChildren(WrCarouselSlide);\n  protected readonly count = computed(() => this.slides().length);\n\n  /** Live horizontal drag offset (px) during a touch swipe. */\n  protected readonly dragX = signal(0);\n  protected readonly dragging = signal(false);\n\n  private readonly dir = inject(Directionality, { optional: true });\n\n  /**\n   * Reading direction of the track. `Directionality` is root-provided, so this\n   * always resolves — `optional` only guards a consumer who has deliberately\n   * torn the provider out. It reads the document once at construction; a\n   * subtree that overrides the direction does it with the CDK's `Dir`\n   * directive, which writes `valueSignal`, so `trackStyle` re-renders instead\n   * of leaving the track parked on the old side.\n   */\n  private readonly isRtl = computed(() => this.dir?.valueSignal() === 'rtl');\n\n  /** CSS transform for the track — the per-slide offset plus any live drag. */\n  protected readonly trackStyle = computed(() => {\n    // `translateX` is PHYSICAL while the slides are laid out on the inline axis:\n    // under `dir=\"rtl\"` the flex track runs right-to-left, so slide 1 sits to the\n    // LEFT of slide 0 and reaching it means moving the track the other way. Left\n    // unsigned, every RTL carousel translated itself off into blank space.\n    const base = (this.isRtl() ? 1 : -1) * this.active() * 100;\n    // The drag stays physical on purpose: it is the finger's own displacement,\n    // and the track follows the finger in both directions.\n    const drag = this.dragX();\n    return drag === 0 ? `translateX(${base}%)` : `translateX(calc(${base}% + ${drag}px))`;\n  });\n\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private readonly paused = signal(false);\n  private readonly destroyRef = inject(DestroyRef);\n  private readonly isBrowser = isPlatformBrowser(inject(PLATFORM_ID));\n\n  constructor() {\n    effect(() => {\n      if (this.timer) clearInterval(this.timer);\n      this.timer = null;\n      // `isBrowser` first: without it the prerender ran the timer too, doing work\n      // nobody will ever see on a slide index that then gets serialized.\n      if (!this.isBrowser || !this.autoplay() || this.paused() || this.count() < 2) return;\n      const interval = this.intervalMs();\n      this.timer = setInterval(() => this.next(), interval);\n    });\n\n    // `active` is a plain `model`, so `[(active)]` and a shrinking slide list both\n    // write into it unchecked — a filtered list left it pointing past the end,\n    // translating the track into blank space with no dot lit.\n    effect(() => {\n      const max = this.count() - 1;\n      if (max < 0) return;\n      const clamped = Math.min(Math.max(0, this.active()), max);\n      if (clamped !== this.active()) this.active.set(clamped);\n    });\n\n    this.destroyRef.onDestroy(() => {\n      if (this.timer) clearInterval(this.timer);\n    });\n  }\n\n  protected onPauseIn(): void {\n    this.paused.set(true);\n  }\n\n  protected onPauseOut(): void {\n    this.paused.set(false);\n  }\n\n  // Imperative\n\n  goTo(index: number): void {\n    const max = this.count() - 1;\n    if (max < 0) return;\n    if (this.loop()) {\n      const next = ((index % this.count()) + this.count()) % this.count();\n      this.active.set(next);\n    } else {\n      this.active.set(Math.min(Math.max(0, index), max));\n    }\n  }\n\n  next(): void {\n    this.goTo(this.active() + 1);\n  }\n\n  prev(): void {\n    this.goTo(this.active() - 1);\n  }\n\n  // Swipe navigation — the track follows the finger; releasing past ~20% of the\n  // viewport advances a slide, otherwise snaps back. Which way that is follows\n  // the reading direction: dragging toward the inline start (left in LTR, right\n  // in RTL) pulls the next slide into view.\n\n  private swipeStartX = 0;\n\n  protected onSwipeStart(event: TouchEvent): void {\n    const touch = event.touches[0];\n    if (!touch) return;\n    this.swipeStartX = touch.clientX;\n    this.dragging.set(true);\n    this.paused.set(true); // hold autoplay while dragging\n  }\n\n  protected onSwipeMove(event: TouchEvent): void {\n    if (!this.dragging()) return;\n    const touch = event.touches[0];\n    if (!touch) return;\n    this.dragX.set(touch.clientX - this.swipeStartX);\n  }\n\n  protected onSwipeEnd(event: TouchEvent, viewport: HTMLElement): void {\n    if (!this.dragging()) return;\n    this.dragging.set(false);\n    const dx = this.dragX();\n    this.dragX.set(0);\n    this.paused.set(false);\n    const threshold = (viewport.offsetWidth || 0) * 0.2;\n    // `dx` is a physical delta. The next slide sits to the physical RIGHT in LTR\n    // and to the LEFT in RTL, so the drag that pulls it into view — and with it\n    // the sign that advances — turns around with the direction. The buttons keep\n    // their semantics either way; only the gesture is physical.\n    const advance = this.isRtl() ? dx >= threshold : dx <= -threshold;\n    const retreat = this.isRtl() ? dx <= -threshold : dx >= threshold;\n    if (advance) this.next();\n    else if (retreat) this.prev();\n  }\n}\n","<div\n  #viewport\n  class=\"wr-carousel__viewport\"\n  role=\"group\"\n  aria-roledescription=\"carousel\"\n  [attr.aria-label]=\"resolvedAriaLabel()\"\n  (touchstart)=\"onSwipeStart($event)\"\n  (touchmove)=\"onSwipeMove($event)\"\n  (touchend)=\"onSwipeEnd($event, viewport)\"\n  (touchcancel)=\"onSwipeEnd($event, viewport)\"\n>\n  <div class=\"wr-carousel__track\" [style.transform]=\"trackStyle()\" [style.transition]=\"dragging() ? 'none' : null\">\n    <ng-content />\n  </div>\n</div>\n\n@if (showArrows() && count() > 1) {\n  <button\n    type=\"button\"\n    class=\"wr-carousel__nav wr-carousel__nav--prev\"\n    [attr.aria-label]=\"resolvedPrevLabel()\"\n    (click)=\"prev()\"\n  >\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 14 14\" aria-hidden=\"true\">\n      <path d=\"M9 2 L4 7 L9 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" />\n    </svg>\n  </button>\n  <button\n    type=\"button\"\n    class=\"wr-carousel__nav wr-carousel__nav--next\"\n    [attr.aria-label]=\"resolvedNextLabel()\"\n    (click)=\"next()\"\n  >\n    <svg width=\"14\" height=\"14\" viewBox=\"0 0 14 14\" aria-hidden=\"true\">\n      <path d=\"M5 2 L10 7 L5 12\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" />\n    </svg>\n  </button>\n}\n\n@if (showDots() && count() > 1) {\n  <div class=\"wr-carousel__dots\" role=\"group\" [attr.aria-label]=\"resolvedPaginationLabel()\">\n    @for (slide of slides(); track $index) {\n      <button\n        type=\"button\"\n        class=\"wr-carousel__dot\"\n        [class.wr-carousel__dot--active]=\"$index === active()\"\n        [attr.aria-current]=\"$index === active() ? 'true' : null\"\n        [attr.aria-label]=\"slideLabel({ index: $index + 1 })\"\n        (click)=\"goTo($index)\"\n      ></button>\n    }\n  </div>\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;AAAA;;;;;AAKG;AAIH;;;AAGG;MAOU,eAAe,CAAA;uGAAf,eAAe,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAAf,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,eAAe,8LAJhB,gBAAgB,EAAA,QAAA,EAAA,IAAA,EAAA,aAAA,EAAA,EAAA,CAAA,iBAAA,CAAA,IAAA,EAAA,CAAA;;2FAIf,eAAe,EAAA,UAAA,EAAA,CAAA;kBAN3B,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,QAAQ,EAAE,mBAAmB;AAC7B,oBAAA,QAAQ,EAAE,gBAAgB;oBAC1B,aAAa,EAAE,iBAAiB,CAAC,IAAI;AACrC,oBAAA,IAAI,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE;AACrF,iBAAA;;;AClBD;;;;;AAKG;AAuBH;;;;;;;;;;;;;;AAcG;MAiBU,UAAU,CAAA;;IAEZ,SAAS,GAAG,KAAK,CAAgB,IAAI;kFAAC;;IAGtC,SAAS,GAAG,KAAK,CAAgB,IAAI;kFAAC;;IAGtC,eAAe,GAAG,KAAK,CAAgB,IAAI;wFAAC;IAElC,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,gBAAgB,CAAC;IAClF,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,CAAC;IAC9E,uBAAuB,GAAG,WAAW,CACtD,IAAI,CAAC,eAAe,EACpB,qBAAqB,EACrB,qBAAqB,CACtB;;IAGQ,SAAS,GAAG,KAAK,CAAgB,IAAI;kFAAC;IAE5B,iBAAiB,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,UAAU,CAAC;;;AAI7E,IAAA,UAAU,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;;IAGtF,MAAM,GAAG,KAAK,CAAC,CAAC;+EAAC;;IAGjB,UAAU,GAAG,KAAK,CAAC,IAAI,kFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;;IAG9D,QAAQ,GAAG,KAAK,CAAC,IAAI,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;;IAG5D,QAAQ,GAAG,KAAK,CAAC,KAAK,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;;IAG7D,UAAU,GAAG,KAAK,CAAC,IAAI,EAAA,EAAA,IAAA,SAAA,GAAA,EAAA,SAAA,EAAA,YAAA,EAAA,8BAAA,EAAA,CAAA,EAC9B,SAAS,EAAE,CAAC,CAAU,KAAa,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAA,CAC/E;;IAGO,IAAI,GAAG,KAAK,CAAC,IAAI,4EAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;IAE9C,MAAM,GAAG,eAAe,CAAC,eAAe;+EAAC;IACzC,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM;8EAAC;;IAG5C,KAAK,GAAG,MAAM,CAAC,CAAC;8EAAC;IACjB,QAAQ,GAAG,MAAM,CAAC,KAAK;iFAAC;IAE1B,GAAG,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAEjE;;;;;;;AAOG;AACc,IAAA,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,KAAK;8EAAC;;AAGvD,IAAA,UAAU,GAAG,QAAQ,CAAC,MAAK;;;;;QAK5C,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG;;;AAG1D,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE;AACzB,QAAA,OAAO,IAAI,KAAK,CAAC,GAAG,CAAA,WAAA,EAAc,IAAI,CAAA,EAAA,CAAI,GAAG,CAAA,gBAAA,EAAmB,IAAI,CAAA,IAAA,EAAO,IAAI,MAAM;IACvF,CAAC;mFAAC;IAEM,KAAK,GAA0C,IAAI;IAC1C,MAAM,GAAG,MAAM,CAAC,KAAK;+EAAC;AACtB,IAAA,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAC/B,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEnE,IAAA,WAAA,GAAA;QACE,MAAM,CAAC,MAAK;YACV,IAAI,IAAI,CAAC,KAAK;AAAE,gBAAA,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;AACzC,YAAA,IAAI,CAAC,KAAK,GAAG,IAAI;;;YAGjB,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE;AAC9E,YAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE;AAClC,YAAA,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC;AACvD,QAAA,CAAC,CAAC;;;;QAKF,MAAM,CAAC,MAAK;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;YAC5B,IAAI,GAAG,GAAG,CAAC;gBAAE;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;AACzD,YAAA,IAAI,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE;AAAE,gBAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;AACzD,QAAA,CAAC,CAAC;AAEF,QAAA,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,MAAK;YAC7B,IAAI,IAAI,CAAC,KAAK;AAAE,gBAAA,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;AAC3C,QAAA,CAAC,CAAC;IACJ;IAEU,SAAS,GAAA;AACjB,QAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;IACvB;IAEU,UAAU,GAAA;AAClB,QAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;IACxB;;AAIA,IAAA,IAAI,CAAC,KAAa,EAAA;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC;QAC5B,IAAI,GAAG,GAAG,CAAC;YAAE;AACb,QAAA,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE;AACnE,YAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACvB;aAAO;YACL,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACpD;IACF;IAEA,IAAI,GAAA;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B;IAEA,IAAI,GAAA;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B;;;;;IAOQ,WAAW,GAAG,CAAC;AAEb,IAAA,YAAY,CAAC,KAAiB,EAAA;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9B,QAAA,IAAI,CAAC,KAAK;YAAE;AACZ,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO;AAChC,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB;AAEU,IAAA,WAAW,CAAC,KAAiB,EAAA;AACrC,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAAE;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9B,QAAA,IAAI,CAAC,KAAK;YAAE;AACZ,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC;IAClD;IAEU,UAAU,CAAC,KAAiB,EAAE,QAAqB,EAAA;AAC3D,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAAE;AACtB,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;AACxB,QAAA,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;AACvB,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACjB,QAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACtB,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,IAAI,GAAG;;;;;AAKnD,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS;AACjE,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,EAAE,IAAI,SAAS;AACjE,QAAA,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE;AACnB,aAAA,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE;IAC/B;uGAhLW,UAAU,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;2FAAV,UAAU,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,aAAA,EAAA,MAAA,EAAA,EAAA,SAAA,EAAA,EAAA,iBAAA,EAAA,WAAA,EAAA,UAAA,EAAA,WAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,SAAA,EAAA,EAAA,iBAAA,EAAA,WAAA,EAAA,UAAA,EAAA,WAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,eAAA,EAAA,EAAA,iBAAA,EAAA,iBAAA,EAAA,UAAA,EAAA,iBAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,SAAA,EAAA,EAAA,iBAAA,EAAA,WAAA,EAAA,UAAA,EAAA,WAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,MAAA,EAAA,EAAA,iBAAA,EAAA,QAAA,EAAA,UAAA,EAAA,QAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,UAAA,EAAA,EAAA,iBAAA,EAAA,YAAA,EAAA,UAAA,EAAA,YAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,QAAA,EAAA,EAAA,iBAAA,EAAA,UAAA,EAAA,UAAA,EAAA,UAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,QAAA,EAAA,EAAA,iBAAA,EAAA,UAAA,EAAA,UAAA,EAAA,UAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,UAAA,EAAA,EAAA,iBAAA,EAAA,YAAA,EAAA,UAAA,EAAA,YAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,IAAA,EAAA,EAAA,iBAAA,EAAA,MAAA,EAAA,UAAA,EAAA,MAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,EAAA,OAAA,EAAA,EAAA,MAAA,EAAA,cAAA,EAAA,EAAA,IAAA,EAAA,EAAA,SAAA,EAAA,EAAA,YAAA,EAAA,aAAA,EAAA,YAAA,EAAA,cAAA,EAAA,SAAA,EAAA,aAAA,EAAA,UAAA,EAAA,cAAA,EAAA,EAAA,cAAA,EAAA,aAAA,EAAA,EAAA,OAAA,EAAA,CAAA,EAAA,YAAA,EAAA,QAAA,EAAA,SAAA,EA+CuB,eAAe,EAAA,QAAA,EAAA,IAAA,EAAA,CAAA,EAAA,QAAA,EAAA,EAAA,EAAA,QAAA,EC1G7D,yzDAqDA,EAAA,aAAA,EAAA,EAAA,CAAA,iBAAA,CAAA,IAAA,EAAA,CAAA;;2FDMa,UAAU,EAAA,UAAA,EAAA,CAAA;kBAhBtB,SAAS;AACE,YAAA,IAAA,EAAA,CAAA,EAAA,QAAA,EAAA,aAAa,EAAA,aAAA,EAER,iBAAiB,CAAC,IAAI,EAAA,IAAA,EAK/B;AACJ,wBAAA,KAAK,EAAE,aAAa;AACpB,wBAAA,cAAc,EAAE,aAAa;AAC7B,wBAAA,cAAc,EAAE,cAAc;AAC9B,wBAAA,WAAW,EAAE,aAAa;AAC1B,wBAAA,YAAY,EAAE,cAAc;AAC7B,qBAAA,EAAA,QAAA,EAAA,yzDAAA,EAAA;qnCAiD2C,eAAe,CAAA,EAAA,EAAA,QAAA,EAAA,IAAA,EAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA;;AE1G7D;;AAEG;;;;"}

package/fesm2022/ngwr-cascader-testing.mjs

@@ -0,0 +1,534 @@
+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 option inside a `<wr-cascader>` column.
+ *
+ * An option is either a BRANCH (it has children, so clicking it opens the next
+ * column) or a LEAF (clicking it commits the whole path and closes the panel).
+ * {@link hasChildren} is the only way to tell them apart, and it reads the
+ * chevron the template draws for branches — the option carries no
+ * `aria-haspopup` / `aria-expanded`, so a screen-reader user is told nothing
+ * about a branch either. Reported here rather than papered over.
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrCascaderOptionHarness extends ComponentHarness {
+    /** The `<li role="menuitem">` a column renders per option. */
+    static hostSelector = '.wr-cascader__opt';
+    /** Build a predicate that narrows the query. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrCascaderOptionHarness, options)
+            .addOption('text', options.text, (harness, text) => HarnessPredicate.stringMatches(harness.getText(), text))
+            .addOption('disabled', options.disabled, async (harness, disabled) => (await harness.isDisabled()) === disabled)
+            .addOption('active', options.active, async (harness, active) => (await harness.isActive()) === active)
+            .addOption('hasChildren', options.hasChildren, async (harness, hasChildren) => (await harness.hasChildren()) === hasChildren);
+    }
+    /** The option's label, trimmed. The branch chevron contributes no text. */
+    async getText() {
+        return (await this.locatorFor('.wr-cascader__opt-label')()).text();
+    }
+    /** The role the option announces — `menuitem`. */
+    async getRole() {
+        return (await this.host()).getAttribute('role');
+    }
+    /** Whether the option refuses selection, from the state a screen reader is given. */
+    async isDisabled() {
+        return (await (await this.host()).getAttribute('aria-disabled')) === 'true';
+    }
+    /**
+     * Whether this is the option its column is currently drilled into — the one
+     * whose children the column to the right is showing, or the committed segment
+     * at this level.
+     *
+     * Read from the `--active` modifier because nothing else says it: the option
+     * has no `aria-selected` and no `aria-expanded`, so the class is both the
+     * whole visual answer and the only one available.
+     */
+    async isActive() {
+        return (await this.host()).hasClass('wr-cascader__opt--active');
+    }
+    /** Whether the option opens a deeper level rather than ending the path. */
+    async hasChildren() {
+        return (await this.locatorForOptional('.wr-cascader__opt-arrow')()) !== null;
+    }
+    /**
+     * The option's tab index — `0` for every enabled option, `-1` for a disabled
+     * one.
+     *
+     * Worth asking: a cascader column is NOT a roving-cursor listbox. Every
+     * enabled option is its own tab stop, in every column, which is the documented
+     * reason virtual scrolling is deferred for this component — there is no
+     * container-owned arrow-nav model to hang a window off.
+     *
+     * Read as the element's `tabIndex` PROPERTY rather than the attribute, so an
+     * option that carried no `tabindex` at all answers `-1` — what the DOM says of a
+     * bare `<li>` — instead of a made-up `0` that would report an unfocusable option
+     * as a tab stop if this component ever moved to a roving cursor.
+     */
+    async getTabIndex() {
+        return (await this.host()).getProperty('tabIndex');
+    }
+    /**
+     * Click the option: a branch opens its children to the right, a leaf commits
+     * the path and closes the panel.
+     *
+     * A disabled option is clickable here on purpose — the component refuses it in
+     * its own handler rather than through `pointer-events`, so the click a spec
+     * dispatches is exactly as ineffective as one in a browser.
+     */
+    async click() {
+        return (await this.host()).click();
+    }
+    /**
+     * Activate the option from the keyboard (Enter; Space is bound to the same
+     * handler).
+     *
+     * This is the component's entire keyboard model — the columns bind
+     * `keydown.enter` / `keydown.space` per option and nothing else, so there are
+     * no arrow keys to walk levels with. A keyboard user reaches the option they
+     * want with Tab and presses Enter — and Tab is a long way round: the panel is a
+     * portal in the overlay container at the end of the document, and nothing moves
+     * focus into it on open, so the first option is not the next stop after the
+     * trigger.
+     */
+    async selectByKeyboard() {
+        return (await this.host()).sendKeys(TestKey.ENTER);
+    }
+    /**
+     * Move the pointer onto the option.
+     *
+     * Deliberately does NOT expand a branch: this cascader drills down on CLICK
+     * only, unlike the hover-to-expand cascaders elsewhere. Kept because a spec
+     * may want to pin that, and because the option's hover tint is styled.
+     */
+    async hover() {
+        return (await this.host()).hover();
+    }
+    /** Move keyboard focus to the option. */
+    async focus() {
+        return (await this.host()).focus();
+    }
+    /** Whether the option holds keyboard focus. */
+    async isFocused() {
+        return (await this.host()).isFocused();
+    }
+}
+
+/**
+ * @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 COLUMN of an open `<wr-cascader>` panel.
+ *
+ * A column is a level of the tree: column 0 holds the root options, and each
+ * further column holds the children of the active option in the column before
+ * it. Which columns exist is therefore a function of what is expanded — the
+ * relationship this harness exists to let a spec assert. Column 0 is always
+ * there; a column only appears once there are children to put in it, so a leaf
+ * adds none.
+ *
+ * @example
+ * ```ts
+ * const [countries, cities] = await cascader.getColumns();
+ *
+ * expect(await countries.getActiveOptionText()).toBe('Germany');
+ * expect(await cities.getOptionLabels()).toEqual(['Berlin']);
+ * ```
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrCascaderColumnHarness extends ComponentHarness {
+    /** The `<ul role="menu">` the panel renders per level. */
+    static hostSelector = '.wr-cascader__col';
+    /** Build a predicate that narrows the query. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrCascaderColumnHarness, options).addOption('optionText', options.optionText, async (harness, text) => {
+            for (const label of await harness.getOptionLabels()) {
+                if (await HarnessPredicate.stringMatches(label, text))
+                    return true;
+            }
+            return false;
+        });
+    }
+    /** The role the column announces — `menu`. */
+    async getRole() {
+        return (await this.host()).getAttribute('role');
+    }
+    /** The options this level offers, in order. */
+    async getOptions(filters = {}) {
+        return this.locatorForAll(WrCascaderOptionHarness.with(filters))();
+    }
+    /** The labels this level offers, in order. */
+    async getOptionLabels() {
+        const options = await this.getOptions();
+        return Promise.all(options.map(option => option.getText()));
+    }
+    /**
+     * The first option matching the filters.
+     *
+     * Throws rather than answering `null`, and names what the column does offer:
+     * a missing option here almost always means the level is not the one the spec
+     * thought it was, and that is far easier to see with the alternatives listed.
+     */
+    async getOption(filters) {
+        const [option] = await this.getOptions(filters);
+        if (!option) {
+            throw new Error(`WrCascaderColumnHarness.getOption(): no option matched ${JSON.stringify(filters)}. ` +
+                `This column offers: ${(await this.getOptionLabels()).join(', ')}.`);
+        }
+        return option;
+    }
+    /** The option this level is drilled into, or `null` when nothing here is expanded. */
+    async getActiveOption() {
+        const [active] = await this.getOptions({ active: true });
+        return active ?? null;
+    }
+    /** The label of the option this level is drilled into, or `null`. */
+    async getActiveOptionText() {
+        const active = await this.getActiveOption();
+        return active ? active.getText() : null;
+    }
+}
+
+/**
+ * @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 `<wr-cascader>` — the trigger, and the panel of COLUMNS it
+ * opens. Root of a small family: {@link WrCascaderColumnHarness} for one level,
+ * `WrCascaderOptionHarness` for one option in it.
+ *
+ * A cascader is not a select with extra steps. Its value is the whole PATH from
+ * root to leaf (`['eu', 'de', 'ber']`, not `'ber'`), and the panel shows one
+ * column per level, so which columns exist depends on what is expanded — column
+ * 0 is the roots, and every further column holds the children of the active
+ * option in the column to its left. That relationship is the component, so it is
+ * what {@link getColumns} and {@link getColumnLabels} are for.
+ *
+ * The panel is NOT inside the cascader: it is a template portal in the overlay
+ * container, a sibling of the whole app. Every read of it goes through the
+ * document root scoped by the `aria-controls` id the trigger publishes, so two
+ * cascaders on one page can never answer with each other's columns.
+ *
+ * @example
+ * ```ts
+ * const cascader = await loader.getHarness(WrCascaderHarness);
+ *
+ * await cascader.selectPath(['Europe', 'Germany', 'Berlin']);
+ *
+ * expect(await cascader.getValueText()).toBe('Europe / Germany / Berlin');
+ * expect(await cascader.isOpen()).toBe(false);
+ * ```
+ *
+ * @see https://ngwr.dev/guides/testing
+ */
+class WrCascaderHarness extends ComponentHarness {
+    static hostSelector = 'wr-cascader';
+    /** Build a predicate that narrows the query. */
+    static with(options = {}) {
+        return new HarnessPredicate(WrCascaderHarness, options)
+            .addOption('text', options.text, (harness, text) => HarnessPredicate.stringMatches(harness.getValueText(), text))
+            .addOption('placeholder', options.placeholder, (harness, placeholder) => HarnessPredicate.stringMatches(harness.getPlaceholder(), placeholder))
+            .addOption('disabled', options.disabled, async (harness, disabled) => (await harness.isDisabled()) === disabled)
+            .addOption('open', options.open, async (harness, open) => (await harness.isOpen()) === open);
+    }
+    trigger = this.locatorFor('.wr-cascader__trigger');
+    /**
+     * Whether the panel is showing.
+     *
+     * From the trigger's `aria-expanded` rather than the host's `--open` class:
+     * both exist, and the ARIA state is the one a screen-reader user is told.
+     */
+    async isOpen() {
+        return (await (await this.trigger()).getAttribute('aria-expanded')) === 'true';
+    }
+    /**
+     * Whether the cascader refuses interaction.
+     *
+     * From the trigger's native `disabled`, which is what actually stops a pointer
+     * and what assistive tech reports; the host's `--disabled` class only mirrors
+     * it for styling.
+     */
+    async isDisabled() {
+        return (await this.trigger()).getProperty('disabled');
+    }
+    /**
+     * What the trigger displays as the selection: the labels of the whole path
+     * joined by the `separator` (`'Europe / Germany / Berlin'` by default), or `''`
+     * while nothing is selected and the placeholder is showing.
+     *
+     * The joined string is all the DOM has — the separator is not published
+     * anywhere on its own, so the harness will not pretend it can split the path
+     * back apart. Assert against the bound value, or against
+     * {@link getActiveTrail} while the panel is open, when the segments matter.
+     */
+    async getValueText() {
+        const value = await this.locatorForOptional('.wr-cascader__value')();
+        return value ? value.text() : '';
+    }
+    /**
+     * The placeholder, or `null` when a selection is hiding it.
+     *
+     * `''` is a real answer, not an absence: a cascader with no `placeholder` still
+     * renders the element while unselected.
+     */
+    async getPlaceholder() {
+        const placeholder = await this.locatorForOptional('.wr-cascader__placeholder')();
+        return placeholder ? placeholder.text() : null;
+    }
+    /**
+     * The trigger's accessible name — the `ariaLabel` input, falling back to the
+     * placeholder and then to the i18n catalog, because a `role="combobox"` with
+     * nothing selected and no placeholder would otherwise have no name at all.
+     */
+    async getAccessibleName() {
+        return (await this.trigger()).getAttribute('aria-label');
+    }
+    /** The kind of popup the trigger promises via `aria-haspopup` — `menu`. */
+    async getPopupRole() {
+        return (await this.trigger()).getAttribute('aria-haspopup');
+    }
+    /** The role the panel announces — `menu`, matching what the trigger promised. */
+    async getPanelRole() {
+        return (await this.panel()).getAttribute('role');
+    }
+    /**
+     * The id the trigger publishes as `aria-controls`.
+     *
+     * Published unconditionally, open or closed — so while the panel is closed this
+     * id resolves to nothing in the document. Exposed so a spec can pin that
+     * (dangling or not) rather than have the harness quietly decide for it; every
+     * panel read goes through the same id but refuses to run while closed.
+     */
+    async getPanelId() {
+        return (await this.trigger()).getAttribute('aria-controls');
+    }
+    /**
+     * Whether the panel now in the overlay is the one this trigger claims to
+     * control — `aria-controls` resolving to a real element that carries that id.
+     *
+     * With several cascaders on a page it is also the check that the reference lands
+     * on THIS instance's panel rather than a neighbour's: the overlay container is
+     * shared, so panels sit side by side in it with nothing but their ids to tell
+     * them apart.
+     */
+    async isPanelWiredToTrigger() {
+        const rendered = await (await this.panel()).getAttribute('id');
+        return rendered !== null && rendered === (await this.getPanelId());
+    }
+    /**
+     * Open the panel.
+     *
+     * Clicks the trigger, because that is the only gesture the component binds. The
+     * trigger is a native `<button>`, so a browser turns Enter / Space on it into
+     * the same click — there is no separate keyboard route to model here, and jsdom
+     * does not synthesise button activation from a key, so an `openByKeyboard()`
+     * would only be able to lie.
+     */
+    async open() {
+        if (await this.isOpen())
+            return;
+        await (await this.trigger()).click();
+        if (await this.isOpen())
+            return;
+        throw new Error('WrCascaderHarness.open(): the panel did not open. A disabled cascader refuses the click — ' +
+            'check isDisabled().');
+    }
+    /**
+     * Close the panel with Escape. A closed cascader is left alone.
+     *
+     * Escape reaches the panel through the CDK's keyboard dispatcher rather than
+     * through the DOM tree, which is why sending it to the trigger works even
+     * though the panel is somewhere else entirely.
+     */
+    async close() {
+        if (!(await this.isOpen()))
+            return;
+        await (await this.trigger()).sendKeys(TestKey.ESCAPE);
+        if (await this.isOpen()) {
+            throw new Error('WrCascaderHarness.close(): Escape did not close the panel.');
+        }
+    }
+    /** Click the trigger once, whatever that does — opens a closed panel, closes an open one. */
+    async clickTrigger() {
+        return (await this.trigger()).click();
+    }
+    /**
+     * The columns of the open panel, left to right: column 0 is the root options,
+     * and each further one holds the children of its neighbour's active option.
+     *
+     * Throws while the panel is closed. The columns do not exist anywhere until the
+     * portal is attached, and an empty array reads like a panel that rendered
+     * nothing — a confusing failure three lines later instead of here.
+     */
+    async getColumns(filters = {}) {
+        const loader = await this.panelLoader();
+        return loader.getAllHarnesses(WrCascaderColumnHarness.with(filters));
+    }
+    /** How many levels the panel is currently showing. */
+    async getColumnCount() {
+        return (await this.getColumns()).length;
+    }
+    /**
+     * One column by its 0-based level. Throws when the level is not showing, which
+     * is the interesting failure: it means the option before it has no children, or
+     * has not been expanded yet.
+     */
+    async getColumn(index) {
+        const columns = await this.getColumns();
+        const column = columns[index];
+        if (!column) {
+            throw new Error(`WrCascaderHarness.getColumn(): no column at level ${index} — the panel is showing ` +
+                `${columns.length}. A deeper column appears only once a parent with children is expanded.`);
+        }
+        return column;
+    }
+    /** The labels offered by every column, outer array left to right. */
+    async getColumnLabels() {
+        const columns = await this.getColumns();
+        return Promise.all(columns.map(column => column.getOptionLabels()));
+    }
+    /**
+     * The expanded trail — the label of the active option in each column, root
+     * first.
+     *
+     * This is the panel's own idea of where the user is, which is NOT always the
+     * committed value: drilling into a branch moves the trail without committing
+     * anything unless `changeOnSelect` is on. Once a leaf is picked the two agree,
+     * and this is the only place the path's segments exist separately in the DOM.
+     */
+    async getActiveTrail() {
+        const trail = [];
+        for (const column of await this.getColumns()) {
+            const active = await column.getActiveOptionText();
+            if (active !== null)
+                trail.push(active);
+        }
+        return trail;
+    }
+    /**
+     * The first option matching the filters, anywhere in the panel. Throws when
+     * nothing matches, naming what is on offer.
+     *
+     * Use {@link getColumn} when the level matters — the same label can legitimately
+     * appear at more than one level.
+     */
+    async getOption(filters) {
+        for (const column of await this.getColumns()) {
+            const [option] = await column.getOptions(filters);
+            if (option)
+                return option;
+        }
+        throw new Error(`WrCascaderHarness.getOption(): no option matched ${JSON.stringify(filters)}. ` +
+            `The panel offers: ${(await this.getColumnLabels()).map(labels => labels.join(', ')).join(' | ')}.`);
+    }
+    /**
+     * Walk a path by label, opening the panel first if needed: each label is
+     * clicked in the column it belongs to, so `['Europe', 'Germany', 'Berlin']`
+     * drills two levels and commits the third.
+     *
+     * Clicking is the only way down — this cascader does not expand on hover, so
+     * neither does the harness. A path that ends on a BRANCH just leaves that
+     * branch expanded: the component commits nothing on the way down unless
+     * `changeOnSelect` is on, and only a leaf closes the panel.
+     */
+    async selectPath(labels) {
+        if (labels.length === 0) {
+            throw new Error('WrCascaderHarness.selectPath(): the path is empty. Pass at least one label, or call clear() ' +
+                'to unset the selection.');
+        }
+        await this.open();
+        for (let level = 0; level < labels.length; level++) {
+            const label = labels[level];
+            const columns = await this.getColumns();
+            const column = columns[level];
+            if (!column) {
+                throw new Error(`WrCascaderHarness.selectPath(): "${label}" would be at level ${level}, but the panel is ` +
+                    `showing ${columns.length} column(s) — the step before it opened no deeper level.`);
+            }
+            const option = await column.getOption({ text: label });
+            if (await option.isDisabled()) {
+                throw new Error(`WrCascaderHarness.selectPath(): "${label}" is disabled, so no path can pass through it.`);
+            }
+            const isLast = level === labels.length - 1;
+            if (!isLast && !(await option.hasChildren())) {
+                throw new Error(`WrCascaderHarness.selectPath(): "${label}" is a leaf, so the path cannot continue to ` +
+                    `"${labels[level + 1]}" — picking it commits and closes the panel.`);
+            }
+            await option.click();
+        }
+    }
+    /**
+     * Click the clear (×) control on the trigger.
+     *
+     * Throws when there is none, and both reasons are worth failing on: the
+     * cascader is not `clearable`, or nothing is selected — the control is not
+     * rendered at all in either case (nor while disabled).
+     */
+    async clear() {
+        const clear = await this.locatorForOptional('.wr-cascader__clear')();
+        if (!clear) {
+            throw new Error('WrCascaderHarness.clear(): this cascader shows no clear control — it is rendered only when ' +
+                '`clearable` is on, something is selected, and the control is enabled.');
+        }
+        await clear.click();
+    }
+    /** Move keyboard focus to the trigger. */
+    async focus() {
+        return (await this.trigger()).focus();
+    }
+    /** Take focus off the trigger, which is what makes a bound form field touched. */
+    async blur() {
+        return (await this.trigger()).blur();
+    }
+    /** Whether the trigger holds keyboard focus. */
+    async isFocused() {
+        return (await this.trigger()).isFocused();
+    }
+    /** This cascader's panel element in the overlay — the single-element scoped read. */
+    async panel() {
+        return this.documentRootLocatorFactory().locatorFor(`#${await this.panelId()}`)();
+    }
+    /**
+     * A loader scoped to THIS cascader's panel — the list scoped read.
+     *
+     * Scoped by the published id rather than by `.wr-cascader-panel`: the overlay
+     * container is shared with every other overlay in the app, so a bare class
+     * query would answer with whichever panel happened to be open.
+     */
+    async panelLoader() {
+        return this.documentRootLocatorFactory().harnessLoaderFor(`#${await this.panelId()}`);
+    }
+    /** The panel id, refusing to hand it out while there is no panel to find. */
+    async panelId() {
+        if (!(await this.isOpen())) {
+            throw new Error('WrCascaderHarness: the panel is closed, so there are no columns to read — call open() or ' +
+                'selectPath() first. The trigger publishes `aria-controls` even while closed, so the id ' +
+                'alone is not proof the panel exists.');
+        }
+        const id = await this.getPanelId();
+        if (!id) {
+            throw new Error('WrCascaderHarness: the trigger publishes no `aria-controls`, so its panel cannot be found.');
+        }
+        return id;
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { WrCascaderColumnHarness, WrCascaderHarness, WrCascaderOptionHarness };
+//# sourceMappingURL=ngwr-cascader-testing.mjs.map