ngwr 13.0.1 → 14.0.1

package/fesm2022/ngwr-file-upload.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngwr-file-upload.mjs","sources":["../../../projects/lib/file-upload/file-upload.ts","../../../projects/lib/file-upload/file-upload.html","../../../projects/lib/file-upload/ngwr-file-upload.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 { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport {\n  Component,\n  type ElementRef,\n  ViewEncapsulation,\n  computed,\n  effect,\n  input,\n  model,\n  output,\n  signal,\n  untracked,\n  viewChild,\n} from '@angular/core';\nimport type { FormValueControl } from '@angular/forms/signals';\n\nimport { useFormFieldAria } from 'ngwr/form';\nimport { useI18nText } from 'ngwr/i18n';\n\nimport type { WrFileUploadRejection, WrFileUploadRejectionReason } from './interfaces';\n\n/** Human-readable byte size (e.g. `1.2 MB`). */\nfunction formatBytes(bytes: number): string {\n  if (!Number.isFinite(bytes) || bytes <= 0) return '0 B';\n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);\n  const v = bytes / 1024 ** i;\n  return `${v.toFixed(v >= 100 || i === 0 ? 0 : 1)} ${units[i]}`;\n}\n\n/** Does `file` match the `accept` attribute (extensions or MIME globs)? */\nfunction matchesAccept(file: File, accept: string): boolean {\n  if (!accept) return true;\n  const tokens = accept\n    .split(',')\n    .map(t => t.trim().toLowerCase())\n    .filter(Boolean);\n  if (tokens.length === 0) return true;\n  const name = file.name.toLowerCase();\n  const mime = file.type.toLowerCase();\n  return tokens.some(token => {\n    if (token.startsWith('.')) return name.endsWith(token);\n    if (token.endsWith('/*')) return mime.startsWith(token.slice(0, -1));\n    return mime === token;\n  });\n}\n\n/**\n * Drag-and-drop file upload zone. Click to browse, drag-and-drop to add,\n * with an optional file list + remove buttons.\n *\n * A signal-forms native control: it implements\n * `FormValueControl<File | readonly File[] | null>`, so `[formField]` binds\n * straight to its `value` model — no `ControlValueAccessor` in between.\n * `[(value)]` works standalone. The value shape follows `multiple`: a single\n * `File` (or `null`), or a `File[]` array.\n *\n * @example\n * ```html\n * <!-- signal forms -->\n * <wr-file-upload [formField]=\"form.files\" [multiple]=\"true\" accept=\"image/*\" />\n *\n * <!-- standalone two-way binding -->\n * <wr-file-upload [(value)]=\"avatar\" accept=\".png,.jpg\" [maxSize]=\"2 * 1024 * 1024\" />\n * ```\n *\n * @see https://ngwr.dev/reference/components/file-upload\n */\n@Component({\n  selector: 'wr-file-upload',\n  templateUrl: './file-upload.html',\n  encapsulation: ViewEncapsulation.None,\n  host: { '[class]': 'classes()' },\n  imports: [],\n})\nexport class WrFileUpload implements FormValueControl<File | readonly File[] | null> {\n  /** Allow multiple files. Single mode replaces on each add. @default false */\n  readonly multiple = input(false, { transform: coerceBooleanProperty });\n\n  /** `accept` attribute — comma-separated MIME types or extensions. @default '' */\n  readonly accept = input<string>('');\n\n  /** Max bytes per file. `0` disables the check. @default 0 */\n  readonly maxSize = input(0, { transform: (v: unknown): number => Math.max(0, coerceNumberProperty(v, 0)) });\n\n  /** Max files (multi mode only). `0` disables the check. @default 0 */\n  readonly maxFiles = input(0, { transform: (v: unknown): number => Math.max(0, coerceNumberProperty(v, 0)) });\n\n  /** Render the picked-files list below the zone. @default true */\n  readonly showList = input(true, { transform: coerceBooleanProperty });\n\n  /**\n   * Disable interaction. Bound automatically from the field's disabled state\n   * when used with `[formField]`.\n   *\n   * @default false\n   */\n  readonly disabled = input(false, { transform: coerceBooleanProperty });\n\n  /**\n   * Refuse changes to the selection while the zone stays focusable and the files\n   * still submit. Bound automatically from the field's readonly state when used\n   * with `[formField]`.\n   *\n   * The zone stops opening the picker, a drop is refused and the per-file remove\n   * buttons go inert — but the list stays readable, which is the point. No\n   * `aria-readonly`: the zone is a `role=\"button\"`, and ARIA does not define the\n   * state for that role, so `aria-disabled` would be the only mirror available\n   * and it would say the wrong thing.\n   *\n   * @default false\n   */\n  readonly readonly = input(false, { transform: coerceBooleanProperty });\n\n  /** The surrounding `<wr-form-field>`'s error state. @internal */\n  protected readonly fieldAria = useFormFieldAria();\n\n  /** Primary call-to-action label. Falls back to `fileUpload.browse`. */\n  readonly pickLabel = input<string | null>(null);\n\n  /** Secondary instruction below the CTA. Falls back to `fileUpload.dropZone`. */\n  readonly dropLabel = input<string | null>(null);\n\n  /** Drop-zone host aria-label. Falls back to `fileUpload.dropZoneLabel`. */\n  readonly dropZoneLabel = input<string | null>(null);\n\n  /** Remove-file button aria-label. Falls back to `fileUpload.removeFile`. */\n  readonly removeFileLabel = input<string | null>(null);\n\n  protected readonly resolvedPick = useI18nText(this.pickLabel, 'fileUpload.browse', 'Click to browse');\n  protected readonly resolvedDrop = useI18nText(this.dropLabel, 'fileUpload.dropZone', 'or drop files here');\n  protected readonly resolvedDropZone = useI18nText(\n    this.dropZoneLabel,\n    'fileUpload.dropZoneLabel',\n    'File upload drop zone — click or drop files'\n  );\n  protected readonly resolvedRemove = useI18nText(this.removeFileLabel, 'fileUpload.removeFile', 'Remove file');\n\n  /** Optional helper text shown below the labels (e.g. accepted formats). */\n  readonly helperText = input<string>('');\n\n  /**\n   * Selected file(s). Bound by `[formField]`, or two-way via `[(value)]`. Shape\n   * follows `multiple`: a single `File` (or `null`), or a `File[]` array.\n   */\n  readonly value = model<File | readonly File[] | null>(null);\n\n  /** Emitted when files are rejected for type / size / count reasons. */\n  readonly rejected = output<readonly WrFileUploadRejection[]>();\n\n  /** Emitted on commit so a bound field can mark itself touched. */\n  readonly touch = output<void>();\n\n  protected readonly picker = viewChild.required<ElementRef<HTMLInputElement>>('picker');\n\n  protected readonly files = signal<readonly File[]>([]);\n  protected readonly dragging = signal(false);\n\n  protected readonly classes = computed(() => {\n    const parts = ['wr-file-upload'];\n    if (this.dragging()) parts.push('wr-file-upload--dragging');\n    if (this.disabled()) parts.push('wr-file-upload--disabled');\n    else if (this.readonly()) parts.push('wr-file-upload--readonly');\n    return parts.join(' ');\n  });\n\n  protected readonly formatBytes = formatBytes;\n\n  constructor() {\n    // Rebuild the internal file list from an external `value` write (mirrors the\n    // old `writeValue`). Skipped when the value is merely the echo of an\n    // in-component edit, so re-syncing can never clobber a live selection.\n    effect(() => {\n      const v = this.value();\n      untracked(() => {\n        // Coerce null/undefined to `[]` — a classic-forms binding can write\n        // null, which the old `writeValue(v: … | null)` accepted too.\n        const next: readonly File[] = v === null || v === undefined ? [] : Array.isArray(v) ? v : [v as File];\n        const current = this.files();\n        if (current.length === next.length && current.every((file, i) => file === next[i])) return;\n        this.files.set(next);\n      });\n    });\n  }\n\n  // Template handlers\n\n  protected openPicker(): void {\n    if (this.disabled() || this.readonly()) return;\n    this.picker().nativeElement.click();\n  }\n\n  protected onZoneKey(event: KeyboardEvent): void {\n    if (event.key === 'Enter' || event.key === ' ') {\n      event.preventDefault();\n      this.openPicker();\n    }\n  }\n\n  protected onPickerChange(event: Event): void {\n    const target = event.target as HTMLInputElement;\n    if (target.files) this.acceptFiles(Array.from(target.files));\n    // Reset so picking the same file twice re-fires `change`.\n    target.value = '';\n  }\n\n  protected onDragEnter(event: DragEvent): void {\n    if (this.disabled() || this.readonly()) return;\n    event.preventDefault();\n    this.dragging.set(true);\n  }\n\n  protected onDragOver(event: DragEvent): void {\n    if (this.disabled() || this.readonly()) return;\n    event.preventDefault();\n    if (event.dataTransfer) event.dataTransfer.dropEffect = 'copy';\n  }\n\n  protected onDragLeave(event: DragEvent): void {\n    // Only clear when leaving the zone itself, not internal children.\n    if (event.currentTarget === event.target) this.dragging.set(false);\n  }\n\n  protected onDrop(event: DragEvent): void {\n    event.preventDefault();\n    this.dragging.set(false);\n    if (this.disabled() || this.readonly()) return;\n    const dropped = event.dataTransfer?.files ? Array.from(event.dataTransfer.files) : [];\n    if (dropped.length > 0) this.acceptFiles(dropped);\n  }\n\n  protected removeAt(index: number): void {\n    if (this.disabled() || this.readonly()) return;\n    const next = this.files().filter((_, i) => i !== index);\n    this.files.set(next);\n    this.emit();\n  }\n\n  // Internals\n\n  private acceptFiles(incoming: readonly File[]): void {\n    if (this.disabled() || this.readonly()) return;\n    const accept = this.accept();\n    const maxSize = this.maxSize();\n    const rejections: WrFileUploadRejection[] = [];\n    const accepted: File[] = [];\n\n    for (const file of incoming) {\n      const reason = this.reject(file, accept, maxSize);\n      if (reason) rejections.push({ file, reason });\n      else accepted.push(file);\n    }\n\n    let next: File[];\n    if (this.multiple()) {\n      next = [...this.files(), ...accepted];\n      const maxFiles = this.maxFiles();\n      if (maxFiles > 0 && next.length > maxFiles) {\n        const overflow = next.splice(maxFiles);\n        for (const file of overflow) rejections.push({ file, reason: 'count' });\n      }\n    } else {\n      // Single mode — last accepted wins, prior selection cleared.\n      next = accepted.length > 0 ? [accepted[accepted.length - 1]] : [...this.files()];\n    }\n\n    this.files.set(next);\n    this.touch.emit();\n    this.emit();\n    if (rejections.length > 0) this.rejected.emit(rejections);\n  }\n\n  private reject(file: File, accept: string, maxSize: number): WrFileUploadRejectionReason | null {\n    if (accept && !matchesAccept(file, accept)) return 'type';\n    if (maxSize > 0 && file.size > maxSize) return 'size';\n    return null;\n  }\n\n  private emit(): void {\n    const list = this.files();\n    if (this.multiple()) {\n      this.value.set(list);\n    } else {\n      this.value.set(list.length > 0 ? list[0] : null);\n    }\n  }\n}\n","<div\n  class=\"wr-file-upload__zone\"\n  role=\"button\"\n  tabindex=\"0\"\n  [attr.aria-label]=\"resolvedDropZone()\"\n  [attr.aria-disabled]=\"disabled() || null\"\n  [attr.aria-invalid]=\"fieldAria.ariaInvalid()\"\n  [attr.aria-describedby]=\"fieldAria.describedBy()\"\n  (click)=\"openPicker()\"\n  (keydown)=\"onZoneKey($event)\"\n  (dragenter)=\"onDragEnter($event)\"\n  (dragover)=\"onDragOver($event)\"\n  (dragleave)=\"onDragLeave($event)\"\n  (drop)=\"onDrop($event)\"\n>\n  <svg class=\"wr-file-upload__icon\" width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" aria-hidden=\"true\">\n    <path\n      d=\"M12 16V4M12 4l-4 4M12 4l4 4M4 16v2a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-2\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      stroke-width=\"1.5\"\n      stroke-linecap=\"round\"\n      stroke-linejoin=\"round\"\n    />\n  </svg>\n  <div class=\"wr-file-upload__hint\">\n    <strong>{{ resolvedPick() }}</strong>\n    <span>{{ resolvedDrop() }}</span>\n    @if (helperText()) {\n      <small>{{ helperText() }}</small>\n    }\n  </div>\n</div>\n\n<!--\n  The real <input type=\"file\"> is never operated directly — the zone above is\n  the control and forwards clicks here, so the input is visually hidden and kept\n  OUTSIDE the zone: inside, it nested one interactive element within another\n  (the zone is role=\"button\") and put two tab stops where users see one. It is\n  positioned absolutely and clipped, so being a sibling changes nothing visually.\n  aria-hidden must be paired with tabindex=\"-1\", or hiding a focusable element is\n  itself a violation.\n-->\n<input\n  #picker\n  class=\"wr-file-upload__picker\"\n  type=\"file\"\n  aria-hidden=\"true\"\n  tabindex=\"-1\"\n  [attr.accept]=\"accept() || null\"\n  [attr.multiple]=\"multiple() ? '' : null\"\n  [disabled]=\"disabled() || readonly()\"\n  (change)=\"onPickerChange($event)\"\n/>\n\n@if (showList() && files().length > 0) {\n  <ul class=\"wr-file-upload__list\">\n    @for (file of files(); track $index) {\n      <li class=\"wr-file-upload__item\">\n        <span class=\"wr-file-upload__name\" [title]=\"file.name\">{{ file.name }}</span>\n        <span class=\"wr-file-upload__size\">{{ formatBytes(file.size) }}</span>\n        <button\n          type=\"button\"\n          class=\"wr-file-upload__remove\"\n          [attr.aria-label]=\"resolvedRemove()\"\n          [disabled]=\"disabled() || readonly()\"\n          (click)=\"removeAt($index)\"\n        >\n          <svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" aria-hidden=\"true\">\n            <path\n              d=\"M2 2 L10 10 M10 2 L2 10\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              stroke-width=\"1.5\"\n              stroke-linecap=\"round\"\n            />\n          </svg>\n        </button>\n      </li>\n    }\n  </ul>\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-file-upload.mjs","sources":["../../../projects/lib/file-upload/file-upload.ts","../../../projects/lib/file-upload/file-upload.html","../../../projects/lib/file-upload/ngwr-file-upload.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 { coerceBooleanProperty, coerceNumberProperty } from '@angular/cdk/coercion';\nimport {\n  Component,\n  type ElementRef,\n  LOCALE_ID,\n  ViewEncapsulation,\n  computed,\n  effect,\n  inject,\n  input,\n  model,\n  output,\n  signal,\n  untracked,\n  viewChild,\n} from '@angular/core';\nimport type { FormValueControl } from '@angular/forms/signals';\n\nimport { useFormFieldAria } from 'ngwr/form';\nimport { readI18nText, useI18nFormatter, useI18nText } from 'ngwr/i18n';\n\nimport type { WrFileUploadRejection, WrFileUploadRejectionReason } from './interfaces';\n\n/** Does `file` match the `accept` attribute (extensions or MIME globs)? */\nfunction matchesAccept(file: File, accept: string): boolean {\n  if (!accept) return true;\n  const tokens = accept\n    .split(',')\n    .map(t => t.trim().toLowerCase())\n    .filter(Boolean);\n  if (tokens.length === 0) return true;\n  const name = file.name.toLowerCase();\n  const mime = file.type.toLowerCase();\n  return tokens.some(token => {\n    if (token.startsWith('.')) return name.endsWith(token);\n    if (token.endsWith('/*')) return mime.startsWith(token.slice(0, -1));\n    return mime === token;\n  });\n}\n\n/**\n * Drag-and-drop file upload zone. Click to browse, drag-and-drop to add,\n * with an optional file list + remove buttons.\n *\n * A signal-forms native control: it implements\n * `FormValueControl<File | readonly File[] | null>`, so `[formField]` binds\n * straight to its `value` model — no `ControlValueAccessor` in between.\n * `[(value)]` works standalone. The value shape follows `multiple`: a single\n * `File` (or `null`), or a `File[]` array.\n *\n * @example\n * ```html\n * <!-- signal forms -->\n * <wr-file-upload [formField]=\"form.files\" [multiple]=\"true\" accept=\"image/*\" />\n *\n * <!-- standalone two-way binding -->\n * <wr-file-upload [(value)]=\"avatar\" accept=\".png,.jpg\" [maxSize]=\"2 * 1024 * 1024\" />\n * ```\n *\n * @see https://ngwr.dev/reference/components/file-upload\n */\n@Component({\n  selector: 'wr-file-upload',\n  templateUrl: './file-upload.html',\n  encapsulation: ViewEncapsulation.None,\n  host: { '[class]': 'classes()' },\n  imports: [],\n})\nexport class WrFileUpload implements FormValueControl<File | readonly File[] | null> {\n  /** Allow multiple files. Single mode replaces on each add. @default false */\n  readonly multiple = input(false, { transform: coerceBooleanProperty });\n\n  /** `accept` attribute — comma-separated MIME types or extensions. @default '' */\n  readonly accept = input<string>('');\n\n  /** Max bytes per file. `0` disables the check. @default 0 */\n  readonly maxSize = input(0, { transform: (v: unknown): number => Math.max(0, coerceNumberProperty(v, 0)) });\n\n  /** Max files (multi mode only). `0` disables the check. @default 0 */\n  readonly maxFiles = input(0, { transform: (v: unknown): number => Math.max(0, coerceNumberProperty(v, 0)) });\n\n  /** Render the picked-files list below the zone. @default true */\n  readonly showList = input(true, { transform: coerceBooleanProperty });\n\n  /**\n   * Disable interaction. Bound automatically from the field's disabled state\n   * when used with `[formField]`.\n   *\n   * @default false\n   */\n  readonly disabled = input(false, { transform: coerceBooleanProperty });\n\n  /**\n   * Refuse changes to the selection while the zone stays focusable and the files\n   * still submit. Bound automatically from the field's readonly state when used\n   * with `[formField]`.\n   *\n   * The zone stops opening the picker, a drop is refused and the per-file remove\n   * buttons go inert — but the list stays readable, which is the point. No\n   * `aria-readonly`: the zone is a `role=\"button\"`, and ARIA does not define the\n   * state for that role, so `aria-disabled` would be the only mirror available\n   * and it would say the wrong thing.\n   *\n   * @default false\n   */\n  readonly readonly = input(false, { transform: coerceBooleanProperty });\n\n  /** The surrounding `<wr-form-field>`'s error state. @internal */\n  protected readonly fieldAria = useFormFieldAria();\n\n  /** Primary call-to-action label. Falls back to `fileUpload.browse`. */\n  readonly pickLabel = input<string | null>(null);\n\n  /** Secondary instruction below the CTA. Falls back to `fileUpload.dropZone`. */\n  readonly dropLabel = input<string | null>(null);\n\n  /** Drop-zone host aria-label. Falls back to `fileUpload.dropZoneLabel`. */\n  readonly dropZoneLabel = input<string | null>(null);\n\n  /** Remove-file button aria-label. Falls back to `fileUpload.removeFile`. */\n  readonly removeFileLabel = input<string | null>(null);\n\n  protected readonly resolvedPick = useI18nText(this.pickLabel, 'fileUpload.browse', 'Click to browse');\n  protected readonly resolvedDrop = useI18nText(this.dropLabel, 'fileUpload.dropZone', 'or drop files here');\n  protected readonly resolvedDropZone = useI18nText(\n    this.dropZoneLabel,\n    'fileUpload.dropZoneLabel',\n    'File upload drop zone — click or drop files'\n  );\n  protected readonly resolvedRemove = useI18nText(this.removeFileLabel, 'fileUpload.removeFile', 'Remove file');\n\n  /** Optional helper text shown below the labels (e.g. accepted formats). */\n  readonly helperText = input<string>('');\n\n  /**\n   * Selected file(s). Bound by `[formField]`, or two-way via `[(value)]`. Shape\n   * follows `multiple`: a single `File` (or `null`), or a `File[]` array.\n   */\n  readonly value = model<File | readonly File[] | null>(null);\n\n  /** Emitted when files are rejected for type / size / count reasons. */\n  readonly rejected = output<readonly WrFileUploadRejection[]>();\n\n  /** Emitted on commit so a bound field can mark itself touched. */\n  readonly touch = output<void>();\n\n  protected readonly picker = viewChild.required<ElementRef<HTMLInputElement>>('picker');\n\n  protected readonly files = signal<readonly File[]>([]);\n  protected readonly dragging = signal(false);\n\n  protected readonly classes = computed(() => {\n    const parts = ['wr-file-upload'];\n    if (this.dragging()) parts.push('wr-file-upload--dragging');\n    if (this.disabled()) parts.push('wr-file-upload--disabled');\n    else if (this.readonly()) parts.push('wr-file-upload--readonly');\n    return parts.join(' ');\n  });\n\n  /**\n   * Human-readable file size (e.g. `1.2 MB`).\n   *\n   * Every piece of this used to be English and unreachable: a module-level unit\n   * table with no catalog key, and `toFixed()`, which writes an ASCII decimal\n   * point whatever `LOCALE_ID` says. A Russian page showed translated drop-zone\n   * copy above `3.4 KB`. The number now goes through `Intl.NumberFormat` and the\n   * unit through the catalog, joined by a template the catalog also owns — so a\n   * locale controls the separator, the digits and whether a space sits before\n   * the unit.\n   *\n   * Not a `computed`: it is called per file, with the file's size as its\n   * argument. It still re-runs on a locale switch, because the formatters it\n   * calls are signals read during the same change detection that renders the row.\n   */\n  protected formatBytes(bytes: number): string {\n    if (!Number.isFinite(bytes) || bytes <= 0) {\n      return this.sizeText({ value: this.number(0, 0), unit: this.unitTexts[0]() });\n    }\n    const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), this.unitTexts.length - 1);\n    const v = bytes / 1024 ** i;\n    const digits = v >= 100 || i === 0 ? 0 : 1;\n    return this.sizeText({ value: this.number(v, digits), unit: this.unitTexts[i]() });\n  }\n\n  /** `{{value}} {{unit}}` — the join, so a locale owns the space too. */\n  private readonly sizeText = useI18nFormatter('fileUpload.size', '{{value}} {{unit}}');\n\n  /**\n   * One resolved signal per binary unit, indexed by the power of 1024 the\n   * arithmetic lands on.\n   *\n   * Spelled out rather than built from a key list: `i18n.spec.ts` reads every\n   * catalog key the library asks for out of the SOURCE, by matching a quoted\n   * dotted string inside the call, so a key built by interpolation is invisible\n   * to it. That spec fails rather than passing quietly, but either way the key\n   * would stop being checked.\n   */\n  private readonly unitTexts = [\n    readI18nText('fileUpload.unitByte', 'B'),\n    readI18nText('fileUpload.unitKb', 'KB'),\n    readI18nText('fileUpload.unitMb', 'MB'),\n    readI18nText('fileUpload.unitGb', 'GB'),\n    readI18nText('fileUpload.unitTb', 'TB'),\n  ] as const;\n\n  private readonly locale = inject(LOCALE_ID);\n\n  private number(value: number, digits: number): string {\n    return new Intl.NumberFormat(this.locale, {\n      minimumFractionDigits: digits,\n      maximumFractionDigits: digits,\n    }).format(value);\n  }\n\n  constructor() {\n    // Rebuild the internal file list from an external `value` write (mirrors the\n    // old `writeValue`). Skipped when the value is merely the echo of an\n    // in-component edit, so re-syncing can never clobber a live selection.\n    effect(() => {\n      const v = this.value();\n      untracked(() => {\n        // Coerce null/undefined to `[]` — a classic-forms binding can write\n        // null, which the old `writeValue(v: … | null)` accepted too.\n        const next: readonly File[] = v === null || v === undefined ? [] : Array.isArray(v) ? v : [v as File];\n        const current = this.files();\n        if (current.length === next.length && current.every((file, i) => file === next[i])) return;\n        this.files.set(next);\n      });\n    });\n  }\n\n  // Template handlers\n\n  protected openPicker(): void {\n    if (this.disabled() || this.readonly()) return;\n    this.picker().nativeElement.click();\n  }\n\n  protected onZoneKey(event: KeyboardEvent): void {\n    if (event.key === 'Enter' || event.key === ' ') {\n      event.preventDefault();\n      this.openPicker();\n    }\n  }\n\n  protected onPickerChange(event: Event): void {\n    const target = event.target as HTMLInputElement;\n    if (target.files) this.acceptFiles(Array.from(target.files));\n    // Reset so picking the same file twice re-fires `change`.\n    target.value = '';\n  }\n\n  protected onDragEnter(event: DragEvent): void {\n    if (this.disabled() || this.readonly()) return;\n    event.preventDefault();\n    this.dragging.set(true);\n  }\n\n  protected onDragOver(event: DragEvent): void {\n    if (this.disabled() || this.readonly()) return;\n    event.preventDefault();\n    if (event.dataTransfer) event.dataTransfer.dropEffect = 'copy';\n  }\n\n  protected onDragLeave(event: DragEvent): void {\n    // Only clear when leaving the zone itself, not internal children.\n    if (event.currentTarget === event.target) this.dragging.set(false);\n  }\n\n  protected onDrop(event: DragEvent): void {\n    event.preventDefault();\n    this.dragging.set(false);\n    if (this.disabled() || this.readonly()) return;\n    const dropped = event.dataTransfer?.files ? Array.from(event.dataTransfer.files) : [];\n    if (dropped.length > 0) this.acceptFiles(dropped);\n  }\n\n  protected removeAt(index: number): void {\n    if (this.disabled() || this.readonly()) return;\n    const next = this.files().filter((_, i) => i !== index);\n    this.files.set(next);\n    this.emit();\n  }\n\n  // Internals\n\n  private acceptFiles(incoming: readonly File[]): void {\n    if (this.disabled() || this.readonly()) return;\n    const accept = this.accept();\n    const maxSize = this.maxSize();\n    const rejections: WrFileUploadRejection[] = [];\n    const accepted: File[] = [];\n\n    for (const file of incoming) {\n      const reason = this.reject(file, accept, maxSize);\n      if (reason) rejections.push({ file, reason });\n      else accepted.push(file);\n    }\n\n    let next: File[];\n    if (this.multiple()) {\n      next = [...this.files(), ...accepted];\n      const maxFiles = this.maxFiles();\n      if (maxFiles > 0 && next.length > maxFiles) {\n        const overflow = next.splice(maxFiles);\n        for (const file of overflow) rejections.push({ file, reason: 'count' });\n      }\n    } else {\n      // Single mode — last accepted wins, prior selection cleared.\n      next = accepted.length > 0 ? [accepted[accepted.length - 1]] : [...this.files()];\n    }\n\n    this.files.set(next);\n    this.touch.emit();\n    this.emit();\n    if (rejections.length > 0) this.rejected.emit(rejections);\n  }\n\n  private reject(file: File, accept: string, maxSize: number): WrFileUploadRejectionReason | null {\n    if (accept && !matchesAccept(file, accept)) return 'type';\n    if (maxSize > 0 && file.size > maxSize) return 'size';\n    return null;\n  }\n\n  private emit(): void {\n    const list = this.files();\n    if (this.multiple()) {\n      this.value.set(list);\n    } else {\n      this.value.set(list.length > 0 ? list[0] : null);\n    }\n  }\n}\n","<div\n  class=\"wr-file-upload__zone\"\n  role=\"button\"\n  tabindex=\"0\"\n  [attr.aria-label]=\"resolvedDropZone()\"\n  [attr.aria-disabled]=\"disabled() || null\"\n  [attr.aria-invalid]=\"fieldAria.ariaInvalid()\"\n  [attr.aria-describedby]=\"fieldAria.describedBy()\"\n  (click)=\"openPicker()\"\n  (keydown)=\"onZoneKey($event)\"\n  (dragenter)=\"onDragEnter($event)\"\n  (dragover)=\"onDragOver($event)\"\n  (dragleave)=\"onDragLeave($event)\"\n  (drop)=\"onDrop($event)\"\n>\n  <svg class=\"wr-file-upload__icon\" width=\"32\" height=\"32\" viewBox=\"0 0 24 24\" aria-hidden=\"true\">\n    <path\n      d=\"M12 16V4M12 4l-4 4M12 4l4 4M4 16v2a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-2\"\n      fill=\"none\"\n      stroke=\"currentColor\"\n      stroke-width=\"1.5\"\n      stroke-linecap=\"round\"\n      stroke-linejoin=\"round\"\n    />\n  </svg>\n  <div class=\"wr-file-upload__hint\">\n    <strong>{{ resolvedPick() }}</strong>\n    <span>{{ resolvedDrop() }}</span>\n    @if (helperText()) {\n      <small>{{ helperText() }}</small>\n    }\n  </div>\n</div>\n\n<!--\n  The real <input type=\"file\"> is never operated directly — the zone above is\n  the control and forwards clicks here, so the input is visually hidden and kept\n  OUTSIDE the zone: inside, it nested one interactive element within another\n  (the zone is role=\"button\") and put two tab stops where users see one. It is\n  positioned absolutely and clipped, so being a sibling changes nothing visually.\n  aria-hidden must be paired with tabindex=\"-1\", or hiding a focusable element is\n  itself a violation.\n-->\n<input\n  #picker\n  class=\"wr-file-upload__picker\"\n  type=\"file\"\n  aria-hidden=\"true\"\n  tabindex=\"-1\"\n  [attr.accept]=\"accept() || null\"\n  [attr.multiple]=\"multiple() ? '' : null\"\n  [disabled]=\"disabled() || readonly()\"\n  (change)=\"onPickerChange($event)\"\n/>\n\n@if (showList() && files().length > 0) {\n  <ul class=\"wr-file-upload__list\">\n    @for (file of files(); track $index) {\n      <li class=\"wr-file-upload__item\">\n        <span class=\"wr-file-upload__name\" [title]=\"file.name\">{{ file.name }}</span>\n        <span class=\"wr-file-upload__size\">{{ formatBytes(file.size) }}</span>\n        <button\n          type=\"button\"\n          class=\"wr-file-upload__remove\"\n          [attr.aria-label]=\"resolvedRemove()\"\n          [disabled]=\"disabled() || readonly()\"\n          (click)=\"removeAt($index)\"\n        >\n          <svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" aria-hidden=\"true\">\n            <path\n              d=\"M2 2 L10 10 M10 2 L2 10\"\n              fill=\"none\"\n              stroke=\"currentColor\"\n              stroke-width=\"1.5\"\n              stroke-linecap=\"round\"\n            />\n          </svg>\n        </button>\n      </li>\n    }\n  </ul>\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;AAAA;;;;;AAKG;AAyBH;AACA,SAAS,aAAa,CAAC,IAAU,EAAE,MAAc,EAAA;AAC/C,IAAA,IAAI,CAAC,MAAM;AAAE,QAAA,OAAO,IAAI;IACxB,MAAM,MAAM,GAAG;SACZ,KAAK,CAAC,GAAG;AACT,SAAA,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;SAC/B,MAAM,CAAC,OAAO,CAAC;AAClB,IAAA,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;AACpC,IAAA,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,IAAG;AACzB,QAAA,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;AAAE,YAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AACtD,QAAA,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;AAAE,YAAA,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,IAAI,KAAK,KAAK;AACvB,IAAA,CAAC,CAAC;AACJ;AAEA;;;;;;;;;;;;;;;;;;;;AAoBG;MAQU,YAAY,CAAA;;IAEd,QAAQ,GAAG,KAAK,CAAC,KAAK,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;;IAG7D,MAAM,GAAG,KAAK,CAAS,EAAE;+EAAC;;IAG1B,OAAO,GAAG,KAAK,CAAC,CAAC,EAAA,EAAA,IAAA,SAAA,GAAA,EAAA,SAAA,EAAA,SAAA,EAAA,8BAAA,EAAA,CAAA,EAAI,SAAS,EAAE,CAAC,CAAU,KAAa,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAA,CAAG;;IAGlG,QAAQ,GAAG,KAAK,CAAC,CAAC,EAAA,EAAA,IAAA,SAAA,GAAA,EAAA,SAAA,EAAA,UAAA,EAAA,8BAAA,EAAA,CAAA,EAAI,SAAS,EAAE,CAAC,CAAU,KAAa,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAA,CAAG;;IAGnG,QAAQ,GAAG,KAAK,CAAC,IAAI,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;AAErE;;;;;AAKG;IACM,QAAQ,GAAG,KAAK,CAAC,KAAK,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;AAEtE;;;;;;;;;;;;AAYG;IACM,QAAQ,GAAG,KAAK,CAAC,KAAK,gFAAI,SAAS,EAAE,qBAAqB,EAAA,CAAG;;IAGnD,SAAS,GAAG,gBAAgB,EAAE;;IAGxC,SAAS,GAAG,KAAK,CAAgB,IAAI;kFAAC;;IAGtC,SAAS,GAAG,KAAK,CAAgB,IAAI;kFAAC;;IAGtC,aAAa,GAAG,KAAK,CAAgB,IAAI;sFAAC;;IAG1C,eAAe,GAAG,KAAK,CAAgB,IAAI;wFAAC;IAElC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;IAClF,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,qBAAqB,EAAE,oBAAoB,CAAC;IACvF,gBAAgB,GAAG,WAAW,CAC/C,IAAI,CAAC,aAAa,EAClB,0BAA0B,EAC1B,6CAA6C,CAC9C;IACkB,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,EAAE,uBAAuB,EAAE,aAAa,CAAC;;IAGpG,UAAU,GAAG,KAAK,CAAS,EAAE;mFAAC;AAEvC;;;AAGG;IACM,KAAK,GAAG,KAAK,CAAgC,IAAI;8EAAC;;IAGlD,QAAQ,GAAG,MAAM,EAAoC;;IAGrD,KAAK,GAAG,MAAM,EAAQ;AAEZ,IAAA,MAAM,GAAG,SAAS,CAAC,QAAQ,CAA+B,QAAQ;+EAAC;IAEnE,KAAK,GAAG,MAAM,CAAkB,EAAE;8EAAC;IACnC,QAAQ,GAAG,MAAM,CAAC,KAAK;iFAAC;AAExB,IAAA,OAAO,GAAG,QAAQ,CAAC,MAAK;AACzC,QAAA,MAAM,KAAK,GAAG,CAAC,gBAAgB,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,EAAE;AAAE,YAAA,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;QAC3D,IAAI,IAAI,CAAC,QAAQ,EAAE;AAAE,YAAA,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;aACtD,IAAI,IAAI,CAAC,QAAQ,EAAE;AAAE,YAAA,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC;AAChE,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxB,CAAC;gFAAC;AAEF;;;;;;;;;;;;;;AAcG;AACO,IAAA,WAAW,CAAC,KAAa,EAAA;AACjC,QAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE;YACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/E;AACA,QAAA,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3F,QAAA,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC;AAC3B,QAAA,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC1C,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpF;;AAGiB,IAAA,QAAQ,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;AAErF;;;;;;;;;AASG;AACc,IAAA,SAAS,GAAG;AAC3B,QAAA,YAAY,CAAC,qBAAqB,EAAE,GAAG,CAAC;AACxC,QAAA,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC;AACvC,QAAA,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC;AACvC,QAAA,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC;AACvC,QAAA,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC;KAC/B;AAEO,IAAA,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC;IAEnC,MAAM,CAAC,KAAa,EAAE,MAAc,EAAA;QAC1C,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE;AACxC,YAAA,qBAAqB,EAAE,MAAM;AAC7B,YAAA,qBAAqB,EAAE,MAAM;AAC9B,SAAA,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAClB;AAEA,IAAA,WAAA,GAAA;;;;QAIE,MAAM,CAAC,MAAK;AACV,YAAA,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;YACtB,SAAS,CAAC,MAAK;;;AAGb,gBAAA,MAAM,IAAI,GAAoB,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAS,CAAC;AACrG,gBAAA,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE;gBAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;oBAAE;AACpF,gBAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AACtB,YAAA,CAAC,CAAC;AACJ,QAAA,CAAC,CAAC;IACJ;;IAIU,UAAU,GAAA;QAClB,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE;IACrC;AAEU,IAAA,SAAS,CAAC,KAAoB,EAAA;AACtC,QAAA,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE;YAC9C,KAAK,CAAC,cAAc,EAAE;YACtB,IAAI,CAAC,UAAU,EAAE;QACnB;IACF;AAEU,IAAA,cAAc,CAAC,KAAY,EAAA;AACnC,QAAA,MAAM,MAAM,GAAG,KAAK,CAAC,MAA0B;QAC/C,IAAI,MAAM,CAAC,KAAK;AAAE,YAAA,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;AAE5D,QAAA,MAAM,CAAC,KAAK,GAAG,EAAE;IACnB;AAEU,IAAA,WAAW,CAAC,KAAgB,EAAA;QACpC,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;QACxC,KAAK,CAAC,cAAc,EAAE;AACtB,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;IACzB;AAEU,IAAA,UAAU,CAAC,KAAgB,EAAA;QACnC,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;QACxC,KAAK,CAAC,cAAc,EAAE;QACtB,IAAI,KAAK,CAAC,YAAY;AAAE,YAAA,KAAK,CAAC,YAAY,CAAC,UAAU,GAAG,MAAM;IAChE;AAEU,IAAA,WAAW,CAAC,KAAgB,EAAA;;AAEpC,QAAA,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,MAAM;AAAE,YAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;IACpE;AAEU,IAAA,MAAM,CAAC,KAAgB,EAAA;QAC/B,KAAK,CAAC,cAAc,EAAE;AACtB,QAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;QACxC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,EAAE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE;AACrF,QAAA,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;AAAE,YAAA,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;IACnD;AAEU,IAAA,QAAQ,CAAC,KAAa,EAAA;QAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC;AACvD,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE;IACb;;AAIQ,IAAA,WAAW,CAAC,QAAyB,EAAA;QAC3C,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE;AACxC,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE;AAC5B,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE;QAC9B,MAAM,UAAU,GAA4B,EAAE;QAC9C,MAAM,QAAQ,GAAW,EAAE;AAE3B,QAAA,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE;AAC3B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;AACjD,YAAA,IAAI,MAAM;gBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;AACxC,gBAAA,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1B;AAEA,QAAA,IAAI,IAAY;AAChB,QAAA,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE;YACnB,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC;AACrC,YAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE;YAChC,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE;gBAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACtC,KAAK,MAAM,IAAI,IAAI,QAAQ;oBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACzE;QACF;aAAO;;AAEL,YAAA,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAClF;AAEA,QAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;AACpB,QAAA,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QACjB,IAAI,CAAC,IAAI,EAAE;AACX,QAAA,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;AAAE,YAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;IAC3D;AAEQ,IAAA,MAAM,CAAC,IAAU,EAAE,MAAc,EAAE,OAAe,EAAA;QACxD,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC;AAAE,YAAA,OAAO,MAAM;QACzD,IAAI,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO;AAAE,YAAA,OAAO,MAAM;AACrD,QAAA,OAAO,IAAI;IACb;IAEQ,IAAI,GAAA;AACV,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE;AACzB,QAAA,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE;AACnB,YAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB;aAAO;YACL,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAClD;IACF;uGAvQW,YAAY,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;AAAZ,IAAA,OAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,YAAY,4+DC3EzB,8xFAkFA,EAAA,aAAA,EAAA,EAAA,CAAA,iBAAA,CAAA,IAAA,EAAA,CAAA;;2FDPa,YAAY,EAAA,UAAA,EAAA,CAAA;kBAPxB,SAAS;+BACE,gBAAgB,EAAA,aAAA,EAEX,iBAAiB,CAAC,IAAI,EAAA,IAAA,EAC/B,EAAE,SAAS,EAAE,WAAW,EAAE,EAAA,OAAA,EACvB,EAAE,EAAA,QAAA,EAAA,8xFAAA,EAAA;k+CAgFkE,QAAQ,EAAA,EAAA,QAAA,EAAA,IAAA,EAAA,CAAA,EAAA,CAAA,EAAA,EAAA,CAAA;;AEzJvF;;AAEG;;;;"}

package/fesm2022/ngwr-form-testing.mjs

@@ -130,8 +130,9 @@ class WrFormFieldHarness extends ContentContainerComponentHarness {
      *
      * `null` does not mean the consumer set no hint: the error block takes the
      * hint's slot outright, so a field with a visible message has no hint in the DOM
-     * at all. Note also that the hint carries no id and is NOT referenced by the
-     * control's `aria-describedby` — see {@link getAnnouncedDescription}.
+     * at all — which is also why the hint's id stops being published at the same
+     * moment. Whether the CONTROL announces it is a separate question, and one this
+     * harness answers through {@link getAnnouncedDescription}.
      */
     async getHint() {
         const hint = await this.locatorForOptional(HINT)();
@@ -251,11 +252,16 @@ class WrFormFieldHarness extends ContentContainerComponentHarness {
     /**
      * The ids the projected control names in `aria-describedby`, in order.
      *
-     * The field points this at the error block and nothing else — the hint has no
-     * id — so an empty list while a hint is showing is correct rather than a bug.
-     * That is not an oversight to fix from a harness either: `[wrInput]` derives
-     * `aria-invalid` from the same signal, so describing the hint would announce
-     * every hinted field as invalid.
+     * Which id that is depends on the CONTROL, not on the field, and the answer is
+     * worth knowing before reading a result. A control that composes the pair with
+     * `useFormFieldAria()` names the error block while one is showing and the hint
+     * otherwise. A control that reads the field's `describedBy` on its own — the
+     * `[wrInput]` directive, `wr-segmented` and `wr-slider` — names the error block
+     * and nothing else, so an empty list beside a visible hint is that control's
+     * answer rather than a broken field.
+     *
+     * The two are separate because folding the hint into the one signal announced
+     * every hinted field as invalid: those three derive `aria-invalid` from it.
      */
     async getDescribedByIds() {
         const value = await (await this.control()).getAttribute('aria-describedby');

package/fesm2022/ngwr-form-testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngwr-form-testing.mjs","sources":["../../../projects/lib/form/testing/wr-form-field-harness.ts","../../../projects/lib/form/testing/wr-form-item-harness.ts","../../../projects/lib/form/testing/ngwr-form-testing.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 {\n  ContentContainerComponentHarness,\n  type HarnessLoader,\n  HarnessPredicate,\n  type TestElement,\n} from '@angular/cdk/testing';\n\nimport type { WrFormFieldError, WrFormFieldHarnessFilters } from './interfaces';\n\n/**\n * The messages this field is showing, or the ones it is holding back.\n *\n * Anchored with `:scope >` because the field's own parts are all direct children\n * of its host: a `<wr-form-field>` nested in another one's control slot otherwise\n * has its error block matched by the OUTER field's query too, and the outer\n * answers with a sentence that is not its own.\n */\nconst MESSAGE = ':scope > .wr-form-field__errors > .wr-form-field__error';\nconst VISIBLE = `${MESSAGE}:not(.wr-form-field__error--hidden)`;\nconst SUPPRESSED = `${MESSAGE}.wr-form-field__error--hidden`;\n\n/** The control slot — every native control lookup is scoped through this. */\nconst SLOT = ':scope > .wr-form-field__control';\n\n/** The label and the hint, anchored for the same reason as {@link MESSAGE}. */\nconst LABEL = ':scope > .wr-form-field__label';\nconst HINT = ':scope > .wr-form-field__hint';\n\n/**\n * Test harness for `<wr-form-field>` — the label + control + hint + validation\n * copy block.\n *\n * The field's real job is the COPY CONTRACT, and this harness is built around it.\n * A message reaches the DOM one of two ways, and they are distinguishable there:\n *\n * - a `<wr-form-error key=\"…\">` the consumer wrote, which renders only while that\n *   key is failing — the others stay in the DOM carrying\n *   `wr-form-field__error--hidden`, which is why {@link getErrors} filters and\n *   {@link getSuppressedErrorKeys} exists. A raw `.wr-form-error` query answers\n *   with the held-back copy too, and reads green on the wrong sentence.\n * - a message the field RESOLVED for an error no markup claimed:\n *   `provideWrFormErrors()`, then the `ngwr/i18n` `validation.*` catalog, then a\n *   built-in English sentence. All three render the identical `<div>`, so\n *   `source` is `'resolved'` for every one of them — the DOM genuinely cannot say\n *   which link answered, and this harness does not pretend otherwise.\n *\n * Nothing renders at all until the projected control is touched or dirty, so a\n * spec has to reach that gate first: {@link blurControl} is the shortest way\n * (blur is what marks a bound control touched), and typing through the control's\n * own harness is the other.\n *\n * The field publishes no `aria-label` anywhere. Its `<label for>` pointing at the\n * projected control IS the naming story, and a control that does not adopt the\n * id leaves the field silently unlabelled — {@link isLabelLinkedToControl} is\n * what catches that. The other half is the reverse wiring: the control reads back\n * `aria-describedby` and `aria-invalid`, which is the only reason a screen reader\n * hears the message ({@link getAnnouncedDescription}).\n *\n * Harnesses loaded through this one resolve INSIDE the control slot, so the\n * control's own harness composes without a selector:\n *\n * @example\n * ```ts\n * const email = await loader.getHarness(WrFormFieldHarness.with({ label: 'Email' }));\n *\n * await (await email.getHarness(WrInputHarness)).setValue('nope');\n * await email.blurControl();\n *\n * expect(await email.getErrorTexts()).toEqual([\"That isn't a valid email.\"]);\n * expect(await email.getAnnouncedDescription()).toBe(\"That isn't a valid email.\");\n * ```\n *\n * @see https://ngwr.dev/guides/testing\n */\nexport class WrFormFieldHarness extends ContentContainerComponentHarness {\n  static hostSelector = 'wr-form-field';\n\n  /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */\n  static with(options: WrFormFieldHarnessFilters = {}): HarnessPredicate<WrFormFieldHarness> {\n    return new HarnessPredicate(WrFormFieldHarness, options)\n      .addOption('label', options.label, (harness, label) => HarnessPredicate.stringMatches(harness.getLabel(), label))\n      .addOption('hint', options.hint, (harness, hint) => HarnessPredicate.stringMatches(harness.getHint(), hint))\n      .addOption('required', options.required, async (harness, required) => (await harness.isRequired()) === required)\n      .addOption('invalid', options.invalid, async (harness, invalid) => (await harness.isInvalid()) === invalid)\n      .addOption('errorText', options.errorText, async (harness, text) => {\n        for (const shown of await harness.getErrorTexts()) {\n          if (await HarnessPredicate.stringMatches(shown, text)) return true;\n        }\n        return false;\n      });\n  }\n\n  /**\n   * The label text, or `null` when the field renders no label.\n   *\n   * The `*` and `(optional)` markers ride INSIDE the `<label>`, so they are\n   * excluded here — otherwise this answers `'Email *'` and every equality\n   * assertion has to know which marker the field happens to carry.\n   *\n   * `null` is not \"the consumer forgot\": `label=\"\"` renders no `<label>` element\n   * at all, which also means there is nothing naming the control.\n   */\n  async getLabel(): Promise<string | null> {\n    const label = await this.labelElement();\n    return label ? label.text({ exclude: '.wr-form-field__required, .wr-form-field__optional' }) : null;\n  }\n\n  /**\n   * Whether the field is marked required.\n   *\n   * Read from the host's `wr-form-field--required` modifier, not from the `*`:\n   * that marker is `aria-hidden=\"true\"` decoration, and it is only rendered when\n   * there is a label to hang it on — the modifier is set either way. Note what\n   * this does NOT mean: the field forwards nothing to the projected control, so\n   * `required` here is the field's own visual state. What announces the constraint\n   * is the forms layer — a `required` rule writes the native `required` attribute\n   * onto the control — and the two are set independently, so a field can carry the\n   * `*` with no validator behind it.\n   */\n  async isRequired(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-field--required');\n  }\n\n  /**\n   * Whether the label carries the `(optional)` marker.\n   *\n   * Read from the marker itself, because — unlike `required` — `optional` sets no\n   * host modifier. It is also the marker a screen reader actually reads: this one\n   * is not `aria-hidden`. `required` wins when both inputs are set, so a required\n   * field is never optional here however it was bound.\n   */\n  async isOptional(): Promise<boolean> {\n    return (await this.locatorForOptional(`${LABEL} .wr-form-field__optional`)()) !== null;\n  }\n\n  /**\n   * The hint text, or `null` when none is showing.\n   *\n   * `null` does not mean the consumer set no hint: the error block takes the\n   * hint's slot outright, so a field with a visible message has no hint in the DOM\n   * at all. Note also that the hint carries no id and is NOT referenced by the\n   * control's `aria-describedby` — see {@link getAnnouncedDescription}.\n   */\n  async getHint(): Promise<string | null> {\n    const hint = await this.locatorForOptional(HINT)();\n    return hint ? hint.text() : null;\n  }\n\n  /**\n   * Whether the field is painting the error state.\n   *\n   * The host's `wr-form-field--invalid` modifier — what the user sees. The\n   * screen-reader half lives on the control as `aria-invalid`, and the two are\n   * separate elements rather than two readings of one: {@link isControlInvalid}.\n   */\n  async isInvalid(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-field--invalid');\n  }\n\n  /**\n   * Every message the field is SHOWING, in DOM order — the consumer's markup\n   * first, then whatever the field resolved for the keys that markup left over.\n   *\n   * Only THIS field's own error block is read — its direct child, holding its\n   * direct children — so a `<wr-form-field>` nested in another one's control slot\n   * contributes nothing to the outer field's answer. Without that anchoring the\n   * outer field reports the inner one's copy as its own, which is the same class\n   * of break as reading a sibling field's messages.\n   */\n  async getErrors(): Promise<WrFormFieldError[]> {\n    const elements = await this.locatorForAll(VISIBLE)();\n\n    return Promise.all(\n      elements.map(async element => ({\n        key: await element.getAttribute('data-key'),\n        text: await element.text(),\n        // The consumer's copy is its own element; a resolved message is a plain\n        // `<div>` the field stamped out. That tag name is the whole of what the\n        // DOM knows about provenance.\n        source:\n          (await element.getProperty<string>('tagName')).toLowerCase() === 'wr-form-error'\n            ? ('projected' as const)\n            : ('resolved' as const),\n      }))\n    );\n  }\n\n  /** The visible messages as text, in DOM order. */\n  async getErrorTexts(): Promise<string[]> {\n    return (await this.getErrors()).map(error => error.text);\n  }\n\n  /**\n   * The visible message for one validator key.\n   *\n   * Throws rather than answering `null` when that key has no visible message: the\n   * two reasons are worth failing on and the message names both — the key is not\n   * in error at all, or its copy resolved to nothing.\n   */\n  async getErrorText(key: string): Promise<string> {\n    const errors = await this.getErrors();\n    const match = errors.find(error => error.key === key);\n    if (match) return match.text;\n\n    const shown = errors.map(error => error.key ?? '(keyless)');\n    const detail =\n      shown.length > 0\n        ? `Showing: ${shown.join(', ')}.`\n        : 'The field is showing nothing — it is either valid, or the control is still untouched and pristine.';\n\n    throw new Error(\n      `WrFormFieldHarness.getErrorText(${JSON.stringify(key)}): no visible message for that key. ${detail}`\n    );\n  }\n\n  /**\n   * The keys of the projected messages the field is holding BACK — copy that is in\n   * the DOM but hidden because its key is not among the failing ones.\n   *\n   * This is the gating contract seen from outside, and the reason a spec must not\n   * query `.wr-form-error` itself: the suppressed sentences sit right next to the\n   * live one.\n   */\n  async getSuppressedErrorKeys(): Promise<string[]> {\n    const hidden = await this.locatorForAll(SUPPRESSED)();\n    const keys = await Promise.all(hidden.map(element => element.getAttribute('data-key')));\n    return keys.filter((key): key is string => key !== null);\n  }\n\n  /**\n   * Whether the field is announcing an error it has no words for: invalid, with an\n   * error block that renders nothing.\n   *\n   * Worth a named check because it is invisible in review — the field still goes\n   * red, and `aria-describedby` still points at the block, so a screen reader is\n   * sent to an empty element. It happens when no link in the copy chain answers\n   * the key (`[autoErrors]=\"false\"` with no markup, or a key nothing has copy for\n   * — Signal Forms reports `minLength`, while the chain only knows Angular's\n   * lowercase `minlength`).\n   */\n  async hasEmptyErrorBlock(): Promise<boolean> {\n    if (!(await this.isInvalid())) return false;\n    return (await this.getErrors()).every(error => error.text.length === 0);\n  }\n\n  /** The id the `<label for>` points at, or `null` when there is no label. */\n  async getLabelFor(): Promise<string | null> {\n    const label = await this.labelElement();\n    return label ? label.getAttribute('for') : null;\n  }\n\n  /** The `id` the projected control actually answers to, or `null` when it has none. */\n  async getControlId(): Promise<string | null> {\n    return (await this.control()).getAttribute('id');\n  }\n\n  /**\n   * Whether the `<label for>` resolves to an element inside THIS field's control\n   * slot — the only thing that makes the field nameable.\n   *\n   * Scoped to the slot on purpose: ids are document-global, so a check that went\n   * through `getElementById` would also pass for a label pointing at a DIFFERENT\n   * field's control, and for a control that has been moved out of the field\n   * entirely. The failure this catches is quiet — a projected control that does\n   * not adopt the field's `controlId` (a bare `<input>` with no `[wrInput]`, say)\n   * leaves a `for` naming nothing, the field renders exactly as it always did, and\n   * nothing is labelled.\n   */\n  async isLabelLinkedToControl(): Promise<boolean> {\n    const id = await this.getLabelFor();\n    if (!id) return false;\n    return (await this.locatorForOptional(`${SLOT} [id=\"${id}\"]`)()) !== null;\n  }\n\n  /**\n   * The ids the projected control names in `aria-describedby`, in order.\n   *\n   * The field points this at the error block and nothing else — the hint has no\n   * id — so an empty list while a hint is showing is correct rather than a bug.\n   * That is not an oversight to fix from a harness either: `[wrInput]` derives\n   * `aria-invalid` from the same signal, so describing the hint would announce\n   * every hinted field as invalid.\n   */\n  async getDescribedByIds(): Promise<string[]> {\n    const value = await (await this.control()).getAttribute('aria-describedby');\n    return value ? value.split(/\\s+/).filter(Boolean) : [];\n  }\n\n  /**\n   * What a screen reader reads as the control's description: the text of the\n   * elements `aria-describedby` names, joined by a space. `null` when the control\n   * describes nothing.\n   *\n   * `''` is a real answer and the interesting one — the reference resolves to an\n   * element with no text in it, which is {@link hasEmptyErrorBlock}. Ids naming\n   * something outside this field are skipped (a consumer's own description is out\n   * of a field harness's reach); an id naming nothing anywhere throws, because a\n   * dangling reference is the bug this method exists to surface.\n   *\n   * Suppressed copy is excluded explicitly rather than left to CSS: a browser drops\n   * `display: none` subtrees from the accessibility tree, but a unit test loads no\n   * stylesheet at all, so the referenced block's raw `textContent` runs every\n   * held-back sentence together with the live one and this would answer with copy\n   * nobody can read.\n   */\n  async getAnnouncedDescription(): Promise<string | null> {\n    const ids = await this.getDescribedByIds();\n    if (ids.length === 0) return null;\n\n    const parts: string[] = [];\n    for (const id of ids) {\n      const inField = await this.locatorForOptional(`[id=\"${id}\"]`)();\n      if (inField) {\n        parts.push(await inField.text({ exclude: '.wr-form-field__error--hidden' }));\n        continue;\n      }\n      if ((await this.documentRootLocatorFactory().locatorForOptional(`[id=\"${id}\"]`)()) === null) {\n        throw new Error(\n          `WrFormFieldHarness.getAnnouncedDescription(): the control's aria-describedby names \"${id}\", which is not ` +\n            'an element anywhere in the document — a screen reader is pointed at nothing.'\n        );\n      }\n    }\n\n    return parts.join(' ');\n  }\n\n  /**\n   * Whether the control announces itself invalid.\n   *\n   * `aria-invalid` on the projected control, which is what assistive technology\n   * is told — the field's own red styling is {@link isInvalid}. Both are here\n   * because they live on different elements and travel in opposite directions: the\n   * field renders the message, the control reads back that there is one. A field\n   * that paints red while the control says nothing is a real (and silent) break.\n   */\n  async isControlInvalid(): Promise<boolean> {\n    return (await (await this.control()).getAttribute('aria-invalid')) === 'true';\n  }\n\n  /** Move focus to the projected control. */\n  async focusControl(): Promise<void> {\n    return (await this.control()).focus();\n  }\n\n  /**\n   * Blur the projected control, which is usually how a spec gets any message to\n   * appear at all: a bound control marks itself touched on blur, and the field\n   * renders nothing while the control is untouched AND pristine.\n   */\n  async blurControl(): Promise<void> {\n    return (await this.control()).blur();\n  }\n\n  /** The rendered `<label>`, or `null` when `label` is empty. */\n  private async labelElement(): Promise<TestElement | null> {\n    return this.locatorForOptional(LABEL)();\n  }\n\n  /**\n   * The control this field wraps.\n   *\n   * The element the label points at, when that resolves inside the slot — which\n   * covers a control nested inside a component (`<wr-input-number>`'s own\n   * `<input>` adopts the field's id, so the label names it, not the component\n   * element). Otherwise the first native control in the slot, so a field with no\n   * label still answers.\n   */\n  private async control(): Promise<TestElement> {\n    const id = await this.getLabelFor();\n    if (id) {\n      const labelled = await this.locatorForOptional(`${SLOT} [id=\"${id}\"]`)();\n      if (labelled) return labelled;\n    }\n\n    const native = await this.locatorForOptional(`${SLOT} input, ${SLOT} select, ${SLOT} textarea`)();\n    if (native) return native;\n\n    throw new Error(\n      'WrFormFieldHarness: this field wraps no control. Nothing in `.wr-form-field__control` answers to the ' +\n        \"label's `for`, and there is no <input> / <select> / <textarea> to fall back to.\"\n    );\n  }\n\n  /**\n   * The content loader every `HarnessLoader` method on this class runs through,\n   * scoped to the control slot.\n   *\n   * So `field.getHarness(WrInputHarness)` finds the control this field wraps and\n   * not a sibling field's — the loader is per-instance by construction, which is\n   * what a document-wide query for the same selector would lose.\n   */\n  protected override async getRootHarnessLoader(): Promise<HarnessLoader> {\n    return this.locatorFactory.harnessLoaderFor(SLOT);\n  }\n}\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 { ContentContainerComponentHarness, HarnessPredicate } from '@angular/cdk/testing';\n\nimport type { WrFormItemHarnessFilters } from './interfaces';\n\n/**\n * Test harness for `<wr-form-item>` — the layout-only field row.\n *\n * Deliberately a much smaller surface than {@link WrFormFieldHarness}, because\n * the component is a much smaller thing: it discovers no control, generates no\n * id, wires no `for` and no `aria-describedby`, and reads no validity. It paints\n * the error state it is TOLD to paint, via `[hasError]`, and everything else in\n * it belongs to the consumer — including the `<label>`, which is named here\n * rather than linked (nothing wires it; the consumer's own `for` is the only\n * thing that can).\n *\n * The one behavioural trap it is worth a harness for: a `<wr-form-error>` inside\n * a form-item renders UNCONDITIONALLY. `key` has no effect at all — the gating\n * lives in the surrounding `<wr-form-field>`, and with no field to ask, every\n * message decides it is the one to show. Markup moved from a field into an item\n * therefore starts printing every sentence at once, and {@link getErrorTexts}\n * is what says so.\n *\n * @example\n * ```ts\n * const item = await loader.getHarness(WrFormItemHarness.with({ label: 'Email' }));\n *\n * expect(await item.isInvalid()).toBe(true);\n * expect(await item.getErrorTexts()).toEqual(['Invalid email']);\n * await (await item.getHarness(WrInputHarness)).setValue('ada@example.test');\n * ```\n *\n * @see https://ngwr.dev/guides/testing\n */\nexport class WrFormItemHarness extends ContentContainerComponentHarness {\n  static hostSelector = 'wr-form-item';\n\n  /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */\n  static with(options: WrFormItemHarnessFilters = {}): HarnessPredicate<WrFormItemHarness> {\n    return new HarnessPredicate(WrFormItemHarness, options)\n      .addOption('label', options.label, (harness, label) => HarnessPredicate.stringMatches(harness.getLabel(), label))\n      .addOption('invalid', options.invalid, async (harness, invalid) => (await harness.isInvalid()) === invalid)\n      .addOption('errorText', options.errorText, async (harness, text) => {\n        for (const shown of await harness.getErrorTexts()) {\n          if (await HarnessPredicate.stringMatches(shown, text)) return true;\n        }\n        return false;\n      });\n  }\n\n  /**\n   * The text of the item's own `<label>` child, or `null` when it has none.\n   *\n   * Direct child only — that is what the item styles (`> label` is what turns red\n   * in the error state), so a label nested deeper is the consumer's own business\n   * and answering with it would describe something the item never touches.\n   */\n  async getLabel(): Promise<string | null> {\n    const label = await this.locatorForOptional(':scope > label')();\n    return label ? label.text() : null;\n  }\n\n  /**\n   * Whether the item is painting the error state.\n   *\n   * The `wr-form-item--error` modifier, which is driven entirely by the\n   * consumer's `[hasError]` — the item runs no validity check of its own, so this\n   * answers what it was told, not what the control thinks.\n   */\n  async isInvalid(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-item--error');\n  }\n\n  /**\n   * Every `<wr-form-error>` in the item, as text, in DOM order.\n   *\n   * All of them: nothing is gated here, `key` or no `key`. Nothing is ever\n   * hidden either, so there is no suppressed-message counterpart to this — see\n   * the class docs.\n   */\n  async getErrorTexts(): Promise<string[]> {\n    const errors = await this.locatorForAll('wr-form-error')();\n    return Promise.all(errors.map(error => error.text()));\n  }\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-form-testing.mjs","sources":["../../../projects/lib/form/testing/wr-form-field-harness.ts","../../../projects/lib/form/testing/wr-form-item-harness.ts","../../../projects/lib/form/testing/ngwr-form-testing.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 {\n  ContentContainerComponentHarness,\n  type HarnessLoader,\n  HarnessPredicate,\n  type TestElement,\n} from '@angular/cdk/testing';\n\nimport type { WrFormFieldError, WrFormFieldHarnessFilters } from './interfaces';\n\n/**\n * The messages this field is showing, or the ones it is holding back.\n *\n * Anchored with `:scope >` because the field's own parts are all direct children\n * of its host: a `<wr-form-field>` nested in another one's control slot otherwise\n * has its error block matched by the OUTER field's query too, and the outer\n * answers with a sentence that is not its own.\n */\nconst MESSAGE = ':scope > .wr-form-field__errors > .wr-form-field__error';\nconst VISIBLE = `${MESSAGE}:not(.wr-form-field__error--hidden)`;\nconst SUPPRESSED = `${MESSAGE}.wr-form-field__error--hidden`;\n\n/** The control slot — every native control lookup is scoped through this. */\nconst SLOT = ':scope > .wr-form-field__control';\n\n/** The label and the hint, anchored for the same reason as {@link MESSAGE}. */\nconst LABEL = ':scope > .wr-form-field__label';\nconst HINT = ':scope > .wr-form-field__hint';\n\n/**\n * Test harness for `<wr-form-field>` — the label + control + hint + validation\n * copy block.\n *\n * The field's real job is the COPY CONTRACT, and this harness is built around it.\n * A message reaches the DOM one of two ways, and they are distinguishable there:\n *\n * - a `<wr-form-error key=\"…\">` the consumer wrote, which renders only while that\n *   key is failing — the others stay in the DOM carrying\n *   `wr-form-field__error--hidden`, which is why {@link getErrors} filters and\n *   {@link getSuppressedErrorKeys} exists. A raw `.wr-form-error` query answers\n *   with the held-back copy too, and reads green on the wrong sentence.\n * - a message the field RESOLVED for an error no markup claimed:\n *   `provideWrFormErrors()`, then the `ngwr/i18n` `validation.*` catalog, then a\n *   built-in English sentence. All three render the identical `<div>`, so\n *   `source` is `'resolved'` for every one of them — the DOM genuinely cannot say\n *   which link answered, and this harness does not pretend otherwise.\n *\n * Nothing renders at all until the projected control is touched or dirty, so a\n * spec has to reach that gate first: {@link blurControl} is the shortest way\n * (blur is what marks a bound control touched), and typing through the control's\n * own harness is the other.\n *\n * The field publishes no `aria-label` anywhere. Its `<label for>` pointing at the\n * projected control IS the naming story, and a control that does not adopt the\n * id leaves the field silently unlabelled — {@link isLabelLinkedToControl} is\n * what catches that. The other half is the reverse wiring: the control reads back\n * `aria-describedby` and `aria-invalid`, which is the only reason a screen reader\n * hears the message ({@link getAnnouncedDescription}).\n *\n * Harnesses loaded through this one resolve INSIDE the control slot, so the\n * control's own harness composes without a selector:\n *\n * @example\n * ```ts\n * const email = await loader.getHarness(WrFormFieldHarness.with({ label: 'Email' }));\n *\n * await (await email.getHarness(WrInputHarness)).setValue('nope');\n * await email.blurControl();\n *\n * expect(await email.getErrorTexts()).toEqual([\"That isn't a valid email.\"]);\n * expect(await email.getAnnouncedDescription()).toBe(\"That isn't a valid email.\");\n * ```\n *\n * @see https://ngwr.dev/guides/testing\n */\nexport class WrFormFieldHarness extends ContentContainerComponentHarness {\n  static hostSelector = 'wr-form-field';\n\n  /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */\n  static with(options: WrFormFieldHarnessFilters = {}): HarnessPredicate<WrFormFieldHarness> {\n    return new HarnessPredicate(WrFormFieldHarness, options)\n      .addOption('label', options.label, (harness, label) => HarnessPredicate.stringMatches(harness.getLabel(), label))\n      .addOption('hint', options.hint, (harness, hint) => HarnessPredicate.stringMatches(harness.getHint(), hint))\n      .addOption('required', options.required, async (harness, required) => (await harness.isRequired()) === required)\n      .addOption('invalid', options.invalid, async (harness, invalid) => (await harness.isInvalid()) === invalid)\n      .addOption('errorText', options.errorText, async (harness, text) => {\n        for (const shown of await harness.getErrorTexts()) {\n          if (await HarnessPredicate.stringMatches(shown, text)) return true;\n        }\n        return false;\n      });\n  }\n\n  /**\n   * The label text, or `null` when the field renders no label.\n   *\n   * The `*` and `(optional)` markers ride INSIDE the `<label>`, so they are\n   * excluded here — otherwise this answers `'Email *'` and every equality\n   * assertion has to know which marker the field happens to carry.\n   *\n   * `null` is not \"the consumer forgot\": `label=\"\"` renders no `<label>` element\n   * at all, which also means there is nothing naming the control.\n   */\n  async getLabel(): Promise<string | null> {\n    const label = await this.labelElement();\n    return label ? label.text({ exclude: '.wr-form-field__required, .wr-form-field__optional' }) : null;\n  }\n\n  /**\n   * Whether the field is marked required.\n   *\n   * Read from the host's `wr-form-field--required` modifier, not from the `*`:\n   * that marker is `aria-hidden=\"true\"` decoration, and it is only rendered when\n   * there is a label to hang it on — the modifier is set either way. Note what\n   * this does NOT mean: the field forwards nothing to the projected control, so\n   * `required` here is the field's own visual state. What announces the constraint\n   * is the forms layer — a `required` rule writes the native `required` attribute\n   * onto the control — and the two are set independently, so a field can carry the\n   * `*` with no validator behind it.\n   */\n  async isRequired(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-field--required');\n  }\n\n  /**\n   * Whether the label carries the `(optional)` marker.\n   *\n   * Read from the marker itself, because — unlike `required` — `optional` sets no\n   * host modifier. It is also the marker a screen reader actually reads: this one\n   * is not `aria-hidden`. `required` wins when both inputs are set, so a required\n   * field is never optional here however it was bound.\n   */\n  async isOptional(): Promise<boolean> {\n    return (await this.locatorForOptional(`${LABEL} .wr-form-field__optional`)()) !== null;\n  }\n\n  /**\n   * The hint text, or `null` when none is showing.\n   *\n   * `null` does not mean the consumer set no hint: the error block takes the\n   * hint's slot outright, so a field with a visible message has no hint in the DOM\n   * at all — which is also why the hint's id stops being published at the same\n   * moment. Whether the CONTROL announces it is a separate question, and one this\n   * harness answers through {@link getAnnouncedDescription}.\n   */\n  async getHint(): Promise<string | null> {\n    const hint = await this.locatorForOptional(HINT)();\n    return hint ? hint.text() : null;\n  }\n\n  /**\n   * Whether the field is painting the error state.\n   *\n   * The host's `wr-form-field--invalid` modifier — what the user sees. The\n   * screen-reader half lives on the control as `aria-invalid`, and the two are\n   * separate elements rather than two readings of one: {@link isControlInvalid}.\n   */\n  async isInvalid(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-field--invalid');\n  }\n\n  /**\n   * Every message the field is SHOWING, in DOM order — the consumer's markup\n   * first, then whatever the field resolved for the keys that markup left over.\n   *\n   * Only THIS field's own error block is read — its direct child, holding its\n   * direct children — so a `<wr-form-field>` nested in another one's control slot\n   * contributes nothing to the outer field's answer. Without that anchoring the\n   * outer field reports the inner one's copy as its own, which is the same class\n   * of break as reading a sibling field's messages.\n   */\n  async getErrors(): Promise<WrFormFieldError[]> {\n    const elements = await this.locatorForAll(VISIBLE)();\n\n    return Promise.all(\n      elements.map(async element => ({\n        key: await element.getAttribute('data-key'),\n        text: await element.text(),\n        // The consumer's copy is its own element; a resolved message is a plain\n        // `<div>` the field stamped out. That tag name is the whole of what the\n        // DOM knows about provenance.\n        source:\n          (await element.getProperty<string>('tagName')).toLowerCase() === 'wr-form-error'\n            ? ('projected' as const)\n            : ('resolved' as const),\n      }))\n    );\n  }\n\n  /** The visible messages as text, in DOM order. */\n  async getErrorTexts(): Promise<string[]> {\n    return (await this.getErrors()).map(error => error.text);\n  }\n\n  /**\n   * The visible message for one validator key.\n   *\n   * Throws rather than answering `null` when that key has no visible message: the\n   * two reasons are worth failing on and the message names both — the key is not\n   * in error at all, or its copy resolved to nothing.\n   */\n  async getErrorText(key: string): Promise<string> {\n    const errors = await this.getErrors();\n    const match = errors.find(error => error.key === key);\n    if (match) return match.text;\n\n    const shown = errors.map(error => error.key ?? '(keyless)');\n    const detail =\n      shown.length > 0\n        ? `Showing: ${shown.join(', ')}.`\n        : 'The field is showing nothing — it is either valid, or the control is still untouched and pristine.';\n\n    throw new Error(\n      `WrFormFieldHarness.getErrorText(${JSON.stringify(key)}): no visible message for that key. ${detail}`\n    );\n  }\n\n  /**\n   * The keys of the projected messages the field is holding BACK — copy that is in\n   * the DOM but hidden because its key is not among the failing ones.\n   *\n   * This is the gating contract seen from outside, and the reason a spec must not\n   * query `.wr-form-error` itself: the suppressed sentences sit right next to the\n   * live one.\n   */\n  async getSuppressedErrorKeys(): Promise<string[]> {\n    const hidden = await this.locatorForAll(SUPPRESSED)();\n    const keys = await Promise.all(hidden.map(element => element.getAttribute('data-key')));\n    return keys.filter((key): key is string => key !== null);\n  }\n\n  /**\n   * Whether the field is announcing an error it has no words for: invalid, with an\n   * error block that renders nothing.\n   *\n   * Worth a named check because it is invisible in review — the field still goes\n   * red, and `aria-describedby` still points at the block, so a screen reader is\n   * sent to an empty element. It happens when no link in the copy chain answers\n   * the key (`[autoErrors]=\"false\"` with no markup, or a key nothing has copy for\n   * — Signal Forms reports `minLength`, while the chain only knows Angular's\n   * lowercase `minlength`).\n   */\n  async hasEmptyErrorBlock(): Promise<boolean> {\n    if (!(await this.isInvalid())) return false;\n    return (await this.getErrors()).every(error => error.text.length === 0);\n  }\n\n  /** The id the `<label for>` points at, or `null` when there is no label. */\n  async getLabelFor(): Promise<string | null> {\n    const label = await this.labelElement();\n    return label ? label.getAttribute('for') : null;\n  }\n\n  /** The `id` the projected control actually answers to, or `null` when it has none. */\n  async getControlId(): Promise<string | null> {\n    return (await this.control()).getAttribute('id');\n  }\n\n  /**\n   * Whether the `<label for>` resolves to an element inside THIS field's control\n   * slot — the only thing that makes the field nameable.\n   *\n   * Scoped to the slot on purpose: ids are document-global, so a check that went\n   * through `getElementById` would also pass for a label pointing at a DIFFERENT\n   * field's control, and for a control that has been moved out of the field\n   * entirely. The failure this catches is quiet — a projected control that does\n   * not adopt the field's `controlId` (a bare `<input>` with no `[wrInput]`, say)\n   * leaves a `for` naming nothing, the field renders exactly as it always did, and\n   * nothing is labelled.\n   */\n  async isLabelLinkedToControl(): Promise<boolean> {\n    const id = await this.getLabelFor();\n    if (!id) return false;\n    return (await this.locatorForOptional(`${SLOT} [id=\"${id}\"]`)()) !== null;\n  }\n\n  /**\n   * The ids the projected control names in `aria-describedby`, in order.\n   *\n   * Which id that is depends on the CONTROL, not on the field, and the answer is\n   * worth knowing before reading a result. A control that composes the pair with\n   * `useFormFieldAria()` names the error block while one is showing and the hint\n   * otherwise. A control that reads the field's `describedBy` on its own — the\n   * `[wrInput]` directive, `wr-segmented` and `wr-slider` — names the error block\n   * and nothing else, so an empty list beside a visible hint is that control's\n   * answer rather than a broken field.\n   *\n   * The two are separate because folding the hint into the one signal announced\n   * every hinted field as invalid: those three derive `aria-invalid` from it.\n   */\n  async getDescribedByIds(): Promise<string[]> {\n    const value = await (await this.control()).getAttribute('aria-describedby');\n    return value ? value.split(/\\s+/).filter(Boolean) : [];\n  }\n\n  /**\n   * What a screen reader reads as the control's description: the text of the\n   * elements `aria-describedby` names, joined by a space. `null` when the control\n   * describes nothing.\n   *\n   * `''` is a real answer and the interesting one — the reference resolves to an\n   * element with no text in it, which is {@link hasEmptyErrorBlock}. Ids naming\n   * something outside this field are skipped (a consumer's own description is out\n   * of a field harness's reach); an id naming nothing anywhere throws, because a\n   * dangling reference is the bug this method exists to surface.\n   *\n   * Suppressed copy is excluded explicitly rather than left to CSS: a browser drops\n   * `display: none` subtrees from the accessibility tree, but a unit test loads no\n   * stylesheet at all, so the referenced block's raw `textContent` runs every\n   * held-back sentence together with the live one and this would answer with copy\n   * nobody can read.\n   */\n  async getAnnouncedDescription(): Promise<string | null> {\n    const ids = await this.getDescribedByIds();\n    if (ids.length === 0) return null;\n\n    const parts: string[] = [];\n    for (const id of ids) {\n      const inField = await this.locatorForOptional(`[id=\"${id}\"]`)();\n      if (inField) {\n        parts.push(await inField.text({ exclude: '.wr-form-field__error--hidden' }));\n        continue;\n      }\n      if ((await this.documentRootLocatorFactory().locatorForOptional(`[id=\"${id}\"]`)()) === null) {\n        throw new Error(\n          `WrFormFieldHarness.getAnnouncedDescription(): the control's aria-describedby names \"${id}\", which is not ` +\n            'an element anywhere in the document — a screen reader is pointed at nothing.'\n        );\n      }\n    }\n\n    return parts.join(' ');\n  }\n\n  /**\n   * Whether the control announces itself invalid.\n   *\n   * `aria-invalid` on the projected control, which is what assistive technology\n   * is told — the field's own red styling is {@link isInvalid}. Both are here\n   * because they live on different elements and travel in opposite directions: the\n   * field renders the message, the control reads back that there is one. A field\n   * that paints red while the control says nothing is a real (and silent) break.\n   */\n  async isControlInvalid(): Promise<boolean> {\n    return (await (await this.control()).getAttribute('aria-invalid')) === 'true';\n  }\n\n  /** Move focus to the projected control. */\n  async focusControl(): Promise<void> {\n    return (await this.control()).focus();\n  }\n\n  /**\n   * Blur the projected control, which is usually how a spec gets any message to\n   * appear at all: a bound control marks itself touched on blur, and the field\n   * renders nothing while the control is untouched AND pristine.\n   */\n  async blurControl(): Promise<void> {\n    return (await this.control()).blur();\n  }\n\n  /** The rendered `<label>`, or `null` when `label` is empty. */\n  private async labelElement(): Promise<TestElement | null> {\n    return this.locatorForOptional(LABEL)();\n  }\n\n  /**\n   * The control this field wraps.\n   *\n   * The element the label points at, when that resolves inside the slot — which\n   * covers a control nested inside a component (`<wr-input-number>`'s own\n   * `<input>` adopts the field's id, so the label names it, not the component\n   * element). Otherwise the first native control in the slot, so a field with no\n   * label still answers.\n   */\n  private async control(): Promise<TestElement> {\n    const id = await this.getLabelFor();\n    if (id) {\n      const labelled = await this.locatorForOptional(`${SLOT} [id=\"${id}\"]`)();\n      if (labelled) return labelled;\n    }\n\n    const native = await this.locatorForOptional(`${SLOT} input, ${SLOT} select, ${SLOT} textarea`)();\n    if (native) return native;\n\n    throw new Error(\n      'WrFormFieldHarness: this field wraps no control. Nothing in `.wr-form-field__control` answers to the ' +\n        \"label's `for`, and there is no <input> / <select> / <textarea> to fall back to.\"\n    );\n  }\n\n  /**\n   * The content loader every `HarnessLoader` method on this class runs through,\n   * scoped to the control slot.\n   *\n   * So `field.getHarness(WrInputHarness)` finds the control this field wraps and\n   * not a sibling field's — the loader is per-instance by construction, which is\n   * what a document-wide query for the same selector would lose.\n   */\n  protected override async getRootHarnessLoader(): Promise<HarnessLoader> {\n    return this.locatorFactory.harnessLoaderFor(SLOT);\n  }\n}\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 { ContentContainerComponentHarness, HarnessPredicate } from '@angular/cdk/testing';\n\nimport type { WrFormItemHarnessFilters } from './interfaces';\n\n/**\n * Test harness for `<wr-form-item>` — the layout-only field row.\n *\n * Deliberately a much smaller surface than {@link WrFormFieldHarness}, because\n * the component is a much smaller thing: it discovers no control, generates no\n * id, wires no `for` and no `aria-describedby`, and reads no validity. It paints\n * the error state it is TOLD to paint, via `[hasError]`, and everything else in\n * it belongs to the consumer — including the `<label>`, which is named here\n * rather than linked (nothing wires it; the consumer's own `for` is the only\n * thing that can).\n *\n * The one behavioural trap it is worth a harness for: a `<wr-form-error>` inside\n * a form-item renders UNCONDITIONALLY. `key` has no effect at all — the gating\n * lives in the surrounding `<wr-form-field>`, and with no field to ask, every\n * message decides it is the one to show. Markup moved from a field into an item\n * therefore starts printing every sentence at once, and {@link getErrorTexts}\n * is what says so.\n *\n * @example\n * ```ts\n * const item = await loader.getHarness(WrFormItemHarness.with({ label: 'Email' }));\n *\n * expect(await item.isInvalid()).toBe(true);\n * expect(await item.getErrorTexts()).toEqual(['Invalid email']);\n * await (await item.getHarness(WrInputHarness)).setValue('ada@example.test');\n * ```\n *\n * @see https://ngwr.dev/guides/testing\n */\nexport class WrFormItemHarness extends ContentContainerComponentHarness {\n  static hostSelector = 'wr-form-item';\n\n  /** Build a predicate that narrows the query — pass to `getHarness` / `getAllHarnesses`. */\n  static with(options: WrFormItemHarnessFilters = {}): HarnessPredicate<WrFormItemHarness> {\n    return new HarnessPredicate(WrFormItemHarness, options)\n      .addOption('label', options.label, (harness, label) => HarnessPredicate.stringMatches(harness.getLabel(), label))\n      .addOption('invalid', options.invalid, async (harness, invalid) => (await harness.isInvalid()) === invalid)\n      .addOption('errorText', options.errorText, async (harness, text) => {\n        for (const shown of await harness.getErrorTexts()) {\n          if (await HarnessPredicate.stringMatches(shown, text)) return true;\n        }\n        return false;\n      });\n  }\n\n  /**\n   * The text of the item's own `<label>` child, or `null` when it has none.\n   *\n   * Direct child only — that is what the item styles (`> label` is what turns red\n   * in the error state), so a label nested deeper is the consumer's own business\n   * and answering with it would describe something the item never touches.\n   */\n  async getLabel(): Promise<string | null> {\n    const label = await this.locatorForOptional(':scope > label')();\n    return label ? label.text() : null;\n  }\n\n  /**\n   * Whether the item is painting the error state.\n   *\n   * The `wr-form-item--error` modifier, which is driven entirely by the\n   * consumer's `[hasError]` — the item runs no validity check of its own, so this\n   * answers what it was told, not what the control thinks.\n   */\n  async isInvalid(): Promise<boolean> {\n    return (await this.host()).hasClass('wr-form-item--error');\n  }\n\n  /**\n   * Every `<wr-form-error>` in the item, as text, in DOM order.\n   *\n   * All of them: nothing is gated here, `key` or no `key`. Nothing is ever\n   * hidden either, so there is no suppressed-message counterpart to this — see\n   * the class docs.\n   */\n  async getErrorTexts(): Promise<string[]> {\n    const errors = await this.locatorForAll('wr-form-error')();\n    return Promise.all(errors.map(error => error.text()));\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;AAAA;;;;;AAKG;AAWH;;;;;;;AAOG;AACH,MAAM,OAAO,GAAG,yDAAyD;AACzE,MAAM,OAAO,GAAG,CAAA,EAAG,OAAO,qCAAqC;AAC/D,MAAM,UAAU,GAAG,CAAA,EAAG,OAAO,+BAA+B;AAE5D;AACA,MAAM,IAAI,GAAG,kCAAkC;AAE/C;AACA,MAAM,KAAK,GAAG,gCAAgC;AAC9C,MAAM,IAAI,GAAG,+BAA+B;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CG;AACG,MAAO,kBAAmB,SAAQ,gCAAgC,CAAA;AACtE,IAAA,OAAO,YAAY,GAAG,eAAe;;AAGrC,IAAA,OAAO,IAAI,CAAC,OAAA,GAAqC,EAAE,EAAA;AACjD,QAAA,OAAO,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,OAAO;aACpD,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC;aAC/G,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC;aAC1G,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC,MAAM,OAAO,CAAC,UAAU,EAAE,MAAM,QAAQ;aAC9G,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,MAAM,OAAO;AACzG,aAAA,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,OAAO,EAAE,IAAI,KAAI;YACjE,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE;gBACjD,IAAI,MAAM,gBAAgB,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC;AAAE,oBAAA,OAAO,IAAI;YACpE;AACA,YAAA,OAAO,KAAK;AACd,QAAA,CAAC,CAAC;IACN;AAEA;;;;;;;;;AASG;AACH,IAAA,MAAM,QAAQ,GAAA;AACZ,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE;AACvC,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC,GAAG,IAAI;IACrG;AAEA;;;;;;;;;;;AAWG;AACH,IAAA,MAAM,UAAU,GAAA;AACd,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,yBAAyB,CAAC;IAChE;AAEA;;;;;;;AAOG;AACH,IAAA,MAAM,UAAU,GAAA;AACd,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAA,EAAG,KAAK,CAAA,yBAAA,CAA2B,CAAC,EAAE,MAAM,IAAI;IACxF;AAEA;;;;;;;;AAQG;AACH,IAAA,MAAM,OAAO,GAAA;QACX,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;AAClD,QAAA,OAAO,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI;IAClC;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,SAAS,GAAA;AACb,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IAC/D;AAEA;;;;;;;;;AASG;AACH,IAAA,MAAM,SAAS,GAAA;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE;AAEpD,QAAA,OAAO,OAAO,CAAC,GAAG,CAChB,QAAQ,CAAC,GAAG,CAAC,OAAM,OAAO,MAAK;AAC7B,YAAA,GAAG,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC;AAC3C,YAAA,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE;;;;AAI1B,YAAA,MAAM,EACJ,CAAC,MAAM,OAAO,CAAC,WAAW,CAAS,SAAS,CAAC,EAAE,WAAW,EAAE,KAAK;AAC/D,kBAAG;AACH,kBAAG,UAAoB;SAC5B,CAAC,CAAC,CACJ;IACH;;AAGA,IAAA,MAAM,aAAa,GAAA;AACjB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC;IAC1D;AAEA;;;;;;AAMG;IACH,MAAM,YAAY,CAAC,GAAW,EAAA;AAC5B,QAAA,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE;AACrC,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC;AACrD,QAAA,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,IAAI;AAE5B,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,IAAI,WAAW,CAAC;AAC3D,QAAA,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,GAAG;cACX,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA,CAAA;cAC5B,oGAAoG;AAE1G,QAAA,MAAM,IAAI,KAAK,CACb,CAAA,gCAAA,EAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA,oCAAA,EAAuC,MAAM,CAAA,CAAE,CACtG;IACH;AAEA;;;;;;;AAOG;AACH,IAAA,MAAM,sBAAsB,GAAA;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE;QACrD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;AACvF,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,KAAoB,GAAG,KAAK,IAAI,CAAC;IAC1D;AAEA;;;;;;;;;;AAUG;AACH,IAAA,MAAM,kBAAkB,GAAA;AACtB,QAAA,IAAI,EAAE,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;AAAE,YAAA,OAAO,KAAK;QAC3C,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACzE;;AAGA,IAAA,MAAM,WAAW,GAAA;AACf,QAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE;AACvC,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI;IACjD;;AAGA,IAAA,MAAM,YAAY,GAAA;AAChB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC;IAClD;AAEA;;;;;;;;;;;AAWG;AACH,IAAA,MAAM,sBAAsB,GAAA;AAC1B,QAAA,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE;AACnC,QAAA,IAAI,CAAC,EAAE;AAAE,YAAA,OAAO,KAAK;AACrB,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAA,EAAG,IAAI,CAAA,MAAA,EAAS,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI;IAC3E;AAEA;;;;;;;;;;;;;AAaG;AACH,IAAA,MAAM,iBAAiB,GAAA;AACrB,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,kBAAkB,CAAC;AAC3E,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;IACxD;AAEA;;;;;;;;;;;;;;;;AAgBG;AACH,IAAA,MAAM,uBAAuB,GAAA;AAC3B,QAAA,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE;AAC1C,QAAA,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,IAAI;QAEjC,MAAM,KAAK,GAAa,EAAE;AAC1B,QAAA,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE;AACpB,YAAA,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAA,KAAA,EAAQ,EAAE,CAAA,EAAA,CAAI,CAAC,EAAE;YAC/D,IAAI,OAAO,EAAE;AACX,gBAAA,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC,CAAC;gBAC5E;YACF;AACA,YAAA,IAAI,CAAC,MAAM,IAAI,CAAC,0BAA0B,EAAE,CAAC,kBAAkB,CAAC,CAAA,KAAA,EAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE;AAC3F,gBAAA,MAAM,IAAI,KAAK,CACb,CAAA,oFAAA,EAAuF,EAAE,CAAA,gBAAA,CAAkB;AACzG,oBAAA,8EAA8E,CACjF;YACH;QACF;AAEA,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACxB;AAEA;;;;;;;;AAQG;AACH,IAAA,MAAM,gBAAgB,GAAA;AACpB,QAAA,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,cAAc,CAAC,MAAM,MAAM;IAC/E;;AAGA,IAAA,MAAM,YAAY,GAAA;QAChB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE;IACvC;AAEA;;;;AAIG;AACH,IAAA,MAAM,WAAW,GAAA;QACf,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE;IACtC;;AAGQ,IAAA,MAAM,YAAY,GAAA;AACxB,QAAA,OAAO,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE;IACzC;AAEA;;;;;;;;AAQG;AACK,IAAA,MAAM,OAAO,GAAA;AACnB,QAAA,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,EAAE;AACN,YAAA,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAA,EAAG,IAAI,CAAA,MAAA,EAAS,EAAE,CAAA,EAAA,CAAI,CAAC,EAAE;AACxE,YAAA,IAAI,QAAQ;AAAE,gBAAA,OAAO,QAAQ;QAC/B;AAEA,QAAA,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,CAAA,EAAG,IAAI,CAAA,QAAA,EAAW,IAAI,CAAA,SAAA,EAAY,IAAI,CAAA,SAAA,CAAW,CAAC,EAAE;AACjG,QAAA,IAAI,MAAM;AAAE,YAAA,OAAO,MAAM;QAEzB,MAAM,IAAI,KAAK,CACb,uGAAuG;AACrG,YAAA,iFAAiF,CACpF;IACH;AAEA;;;;;;;AAOG;AACgB,IAAA,MAAM,oBAAoB,GAAA;QAC3C,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC;IACnD;;;ACvZF;;;;;AAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BG;AACG,MAAO,iBAAkB,SAAQ,gCAAgC,CAAA;AACrE,IAAA,OAAO,YAAY,GAAG,cAAc;;AAGpC,IAAA,OAAO,IAAI,CAAC,OAAA,GAAoC,EAAE,EAAA;AAChD,QAAA,OAAO,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,OAAO;aACnD,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,KAAK,gBAAgB,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC;aAC/G,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,MAAM,OAAO;AACzG,aAAA,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,OAAO,EAAE,IAAI,KAAI;YACjE,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE;gBACjD,IAAI,MAAM,gBAAgB,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC;AAAE,oBAAA,OAAO,IAAI;YACpE;AACA,YAAA,OAAO,KAAK;AACd,QAAA,CAAC,CAAC;IACN;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,QAAQ,GAAA;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE;AAC/D,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI;IACpC;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,SAAS,GAAA;AACb,QAAA,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,qBAAqB,CAAC;IAC5D;AAEA;;;;;;AAMG;AACH,IAAA,MAAM,aAAa,GAAA;QACjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE;AAC1D,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD;;;ACzFF;;AAEG;;;;"}

package/fesm2022/ngwr-form.mjs

@@ -42,10 +42,10 @@ class WrFormItem {
         return parts.join(' ');
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "classes" }] : /* istanbul ignore next */ []));
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormItem, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.1.4", type: WrFormItem, isStandalone: true, selector: "wr-form-item", inputs: { hasError: { classPropertyName: "hasError", publicName: "hasError", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classes()" } }, ngImport: i0, template: '<ng-content />', isInline: true, encapsulation: i0.ViewEncapsulation.None });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormItem, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.1.5", type: WrFormItem, isStandalone: true, selector: "wr-form-item", inputs: { hasError: { classPropertyName: "hasError", publicName: "hasError", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classes()" } }, ngImport: i0, template: '<ng-content />', isInline: true, encapsulation: i0.ViewEncapsulation.None });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormItem, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormItem, decorators: [{
             type: Component,
             args: [{
                     selector: 'wr-form-item',
@@ -200,10 +200,10 @@ class WrFormError {
         return this.field.errorKeys().includes(key);
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "visible" }] : /* istanbul ignore next */ []));
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormError, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.1.4", type: WrFormError, isStandalone: true, selector: "wr-form-error", inputs: { key: { classPropertyName: "key", publicName: "key", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "alert" }, properties: { "attr.data-key": "key() ?? null", "class.wr-form-field__error--hidden": "!visible()" }, classAttribute: "wr-form-error wr-form-field__error" }, ngImport: i0, template: `<ng-content />`, isInline: true, encapsulation: i0.ViewEncapsulation.None });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormError, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.1.5", type: WrFormError, isStandalone: true, selector: "wr-form-error", inputs: { key: { classPropertyName: "key", publicName: "key", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "alert" }, properties: { "attr.data-key": "key() ?? null", "class.wr-form-field__error--hidden": "!visible()" }, classAttribute: "wr-form-error wr-form-field__error" }, ngImport: i0, template: `<ng-content />`, isInline: true, encapsulation: i0.ViewEncapsulation.None });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormError, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormError, decorators: [{
             type: Component,
             args: [{
                     selector: 'wr-form-error',
@@ -338,6 +338,21 @@ class WrFormField {
     /** @internal Read by the projected control so a screen reader is pointed at the message. */
     describedBy = computed(() => (this.hasError() ? `${this.controlId()}-errors` : null), /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "describedBy" }] : /* istanbul ignore next */ []));
+    /**
+     * @internal Read by the projected control so the hint is announced with the field.
+     *
+     * The hint used to carry no id at all, so the only thing `aria-describedby`
+     * could ever name was the error block: the sentence explaining what to type was
+     * on screen and reached a screen-reader user through no path whatsoever, and
+     * the one gate that could have said so does not exist — axe has no rule that
+     * visible help text must be programmatically associated.
+     *
+     * `null` while an error is showing, because the template swaps the hint out for
+     * the message; publishing the id anyway would point every control at an element
+     * that had just left the document.
+     */
+    hintId = computed(() => (!this.hasError() && this.hint() ? `${this.controlId()}-hint` : null), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "hintId" }] : /* istanbul ignore next */ []));
     /**
      * Render a catalog message for any error the markup does not already answer.
      *
@@ -392,16 +407,16 @@ class WrFormField {
         return parts.join(' ');
     }, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "classes" }] : /* istanbul ignore next */ []));
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormField, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.4", type: WrFormField, isStandalone: true, selector: "wr-form-field", inputs: { label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, hint: { classPropertyName: "hint", publicName: "hint", isSignal: true, isRequired: false, transformFunction: null }, required: { classPropertyName: "required", publicName: "required", isSignal: true, isRequired: false, transformFunction: null }, optional: { classPropertyName: "optional", publicName: "optional", isSignal: true, isRequired: false, transformFunction: null }, optionalLabel: { classPropertyName: "optionalLabel", publicName: "optionalLabel", isSignal: true, isRequired: false, transformFunction: null }, controlId: { classPropertyName: "controlId", publicName: "controlId", isSignal: true, isRequired: false, transformFunction: null }, autoErrors: { classPropertyName: "autoErrors", publicName: "autoErrors", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classes()" } }, providers: [
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormField, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.5", type: WrFormField, isStandalone: true, selector: "wr-form-field", inputs: { label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, hint: { classPropertyName: "hint", publicName: "hint", isSignal: true, isRequired: false, transformFunction: null }, required: { classPropertyName: "required", publicName: "required", isSignal: true, isRequired: false, transformFunction: null }, optional: { classPropertyName: "optional", publicName: "optional", isSignal: true, isRequired: false, transformFunction: null }, optionalLabel: { classPropertyName: "optionalLabel", publicName: "optionalLabel", isSignal: true, isRequired: false, transformFunction: null }, controlId: { classPropertyName: "controlId", publicName: "controlId", isSignal: true, isRequired: false, transformFunction: null }, autoErrors: { classPropertyName: "autoErrors", publicName: "autoErrors", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "class": "classes()" } }, providers: [
             {
                 provide: WR_FORM_FIELD,
                 // eslint-disable-next-line @angular-eslint/no-forward-ref
                 useExisting: forwardRef(() => WrFormField),
             },
-        ], queries: [{ propertyName: "ngControl", first: true, predicate: NgControl, descendants: true, isSignal: true }, { propertyName: "projectedErrors", predicate: WrFormError, isSignal: true }], ngImport: i0, template: "@if (label()) {\n  <label class=\"wr-form-field__label\" [attr.for]=\"labelFor()\">\n    {{ label() }}\n    @if (required()) {\n      <span class=\"wr-form-field__required\" aria-hidden=\"true\">*</span>\n    } @else if (optional()) {\n      <span class=\"wr-form-field__optional\">({{ resolvedOptional() }})</span>\n    }\n  </label>\n}\n\n<div class=\"wr-form-field__control\"><ng-content /></div>\n\n@if (hasError()) {\n  <div class=\"wr-form-field__errors\" [attr.id]=\"describedBy()\">\n    <ng-content select=\"wr-form-error\" />\n    @for (message of autoMessages(); track message.key) {\n      <div class=\"wr-form-error wr-form-field__error\" role=\"alert\" [attr.data-key]=\"message.key\">\n        {{ message.text }}\n      </div>\n    }\n  </div>\n} @else if (hint()) {\n  <small class=\"wr-form-field__hint\">{{ hint() }}</small>\n}\n", encapsulation: i0.ViewEncapsulation.None });
+        ], queries: [{ propertyName: "ngControl", first: true, predicate: NgControl, descendants: true, isSignal: true }, { propertyName: "projectedErrors", predicate: WrFormError, isSignal: true }], ngImport: i0, template: "@if (label()) {\n  <label class=\"wr-form-field__label\" [attr.for]=\"labelFor()\">\n    {{ label() }}\n    @if (required()) {\n      <span class=\"wr-form-field__required\" aria-hidden=\"true\">*</span>\n    } @else if (optional()) {\n      <span class=\"wr-form-field__optional\">({{ resolvedOptional() }})</span>\n    }\n  </label>\n}\n\n<div class=\"wr-form-field__control\"><ng-content /></div>\n\n@if (hasError()) {\n  <div class=\"wr-form-field__errors\" [attr.id]=\"describedBy()\">\n    <ng-content select=\"wr-form-error\" />\n    @for (message of autoMessages(); track message.key) {\n      <div class=\"wr-form-error wr-form-field__error\" role=\"alert\" [attr.data-key]=\"message.key\">\n        {{ message.text }}\n      </div>\n    }\n  </div>\n} @else if (hint()) {\n  <small class=\"wr-form-field__hint\" [attr.id]=\"hintId()\">{{ hint() }}</small>\n}\n", encapsulation: i0.ViewEncapsulation.None });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: WrFormField, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.5", ngImport: i0, type: WrFormField, decorators: [{
             type: Component,
             args: [{ selector: 'wr-form-field', encapsulation: ViewEncapsulation.None, host: { '[class]': 'classes()' }, providers: [
                         {
@@ -409,7 +424,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImpor
                             // eslint-disable-next-line @angular-eslint/no-forward-ref
                             useExisting: forwardRef(() => WrFormField),
                         },
-                    ], template: "@if (label()) {\n  <label class=\"wr-form-field__label\" [attr.for]=\"labelFor()\">\n    {{ label() }}\n    @if (required()) {\n      <span class=\"wr-form-field__required\" aria-hidden=\"true\">*</span>\n    } @else if (optional()) {\n      <span class=\"wr-form-field__optional\">({{ resolvedOptional() }})</span>\n    }\n  </label>\n}\n\n<div class=\"wr-form-field__control\"><ng-content /></div>\n\n@if (hasError()) {\n  <div class=\"wr-form-field__errors\" [attr.id]=\"describedBy()\">\n    <ng-content select=\"wr-form-error\" />\n    @for (message of autoMessages(); track message.key) {\n      <div class=\"wr-form-error wr-form-field__error\" role=\"alert\" [attr.data-key]=\"message.key\">\n        {{ message.text }}\n      </div>\n    }\n  </div>\n} @else if (hint()) {\n  <small class=\"wr-form-field__hint\">{{ hint() }}</small>\n}\n" }]
+                    ], template: "@if (label()) {\n  <label class=\"wr-form-field__label\" [attr.for]=\"labelFor()\">\n    {{ label() }}\n    @if (required()) {\n      <span class=\"wr-form-field__required\" aria-hidden=\"true\">*</span>\n    } @else if (optional()) {\n      <span class=\"wr-form-field__optional\">({{ resolvedOptional() }})</span>\n    }\n  </label>\n}\n\n<div class=\"wr-form-field__control\"><ng-content /></div>\n\n@if (hasError()) {\n  <div class=\"wr-form-field__errors\" [attr.id]=\"describedBy()\">\n    <ng-content select=\"wr-form-error\" />\n    @for (message of autoMessages(); track message.key) {\n      <div class=\"wr-form-error wr-form-field__error\" role=\"alert\" [attr.data-key]=\"message.key\">\n        {{ message.text }}\n      </div>\n    }\n  </div>\n} @else if (hint()) {\n  <small class=\"wr-form-field__hint\" [attr.id]=\"hintId()\">{{ hint() }}</small>\n}\n" }]
         }], ctorParameters: () => [], propDecorators: { label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }], hint: [{ type: i0.Input, args: [{ isSignal: true, alias: "hint", required: false }] }], required: [{ type: i0.Input, args: [{ isSignal: true, alias: "required", required: false }] }], optional: [{ type: i0.Input, args: [{ isSignal: true, alias: "optional", required: false }] }], optionalLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "optionalLabel", required: false }] }], controlId: [{ type: i0.Input, args: [{ isSignal: true, alias: "controlId", required: false }] }], ngControl: [{ type: i0.ContentChild, args: [i0.forwardRef(() => NgControl), { isSignal: true }] }], autoErrors: [{ type: i0.Input, args: [{ isSignal: true, alias: "autoErrors", required: false }] }], projectedErrors: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => WrFormError), { isSignal: true }] }] } });
 
 /**
@@ -419,18 +434,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImpor
  * found in the LICENSE file at https://github.com/thekhegay/ngwr/blob/main/LICENSE
  */
 /**
- * The two attributes that make a `<wr-form-field>`'s visible error reach a
- * screen reader — bind both on whichever element carries the control's role.
+ * The two attributes that make a `<wr-form-field>`'s visible text — its error
+ * message, or its hint — reach a screen reader. Bind both on whichever element
+ * carries the control's role.
  *
- * Without them the messages the field renders are visible and nothing else: the
- * control announces itself as valid, and the message is associated with nothing.
- * No automated gate catches that — axe has no rule that a visible error must be
- * programmatically associated with its control — so this helper exists to make
- * the wiring one line per control rather than three, and the specs are the gate.
+ * Without them the copy the field renders is visible and nothing else: the
+ * control announces itself as valid, and the text is associated with nothing.
+ * No automated gate catches that — axe has no rule that a visible error or hint
+ * must be programmatically associated with its control — so this helper exists
+ * to make the wiring one line per control rather than three, and the specs are
+ * the gate.
  *
- * `aria-invalid` is keyed on the message EXISTING rather than on `errorKeys()`,
- * because the field only publishes an id once it is showing something —
- * announcing "invalid" while pointing at nothing is worse than staying quiet.
+ * The field renders an error OR a hint, never both, so `describedBy` names
+ * whichever is on screen and `aria-invalid` is keyed SEPARATELY, on the field's
+ * `errorKeys()`. Deriving it from `describedBy` instead — which is what every
+ * control did while a hint had no id to name — makes a field with a plain hint
+ * announce its control as invalid the moment the hint becomes describable.
  *
  * Must be called from an injection context (a field initialiser or a
  * constructor). Returns inert signals outside a `<wr-form-field>`.
@@ -451,11 +470,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImpor
  */
 function useFormFieldAria(options) {
     const field = inject(WR_FORM_FIELD, { optional: true, skipSelf: options?.skipSelf ?? false });
-    const describedBy = computed(() => field?.describedBy() ?? null, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "describedBy" }] : /* istanbul ignore next */ []));
     return {
-        describedBy,
-        ariaInvalid: computed(() => (describedBy() ? 'true' : null)),
+        // `hintId` is optional on the interface so an app-provided field keeps
+        // compiling; one without it describes nothing but its errors, as before.
+        describedBy: computed(() => field?.describedBy() ?? field?.hintId?.() ?? null),
+        ariaInvalid: computed(() => ((field?.errorKeys().length ?? 0) > 0 ? 'true' : null)),
     };
 }