ng-hub-ui-forms 22.33.0 → 22.33.2

package/README.md

@@ -748,6 +748,23 @@ import { HubSignalFieldControl, hubSignalErrorMessages } from 'ng-hub-ui-forms/s
 ## ♿ Accessibility
 
 - Labels are associated with their control (`for`/`id`); required fields are marked.
+- **`labelType="visually-hidden"` names a control that has no room for a visible label.** A
+  toolbar search box or a compact grid cell cannot repeat the same word down every row, and the
+  alternative was a control with no accessible name at all — a placeholder is not a name. The
+  label is still rendered and still bound to the control; only the pixels go, clipped out of the
+  page rather than removed with `display: none`, which would take the name with them. Honoured by
+  every field, checkboxes and switches included.
+
+    ```html
+    <hub-input formControlName="q" label="Search orders" labelType="visually-hidden" placeholder="Search" />
+    ```
+
+    A hidden label rather than an `aria-label` on purpose: a label stays *associated* with its
+  control, so it is one string in the template that both the eye and the screen reader can be
+  given or denied, and it never silently replaces a name the application set for itself. The two
+  exceptions are `hub-otp-input` and `hub-segmented`, which render a group rather than a single
+  control: a `<label for>` aimed at a `<div>` names nothing, so those two carry the text on the
+  group as `aria-label`.
 - `required` — set inline or derived from `Validators.required`, with `formControlName` **or** a direct `[formControl]` binding — is reflected as `aria-required` on every field, including the select's combobox search input, the segmented `radiogroup` and each OTP cell. On a reactive binding the control's validators decide: an inline `required` is overwritten by them, so declare it on the validators. Template-driven bindings (`ngModel`) keep honouring the inline input.
 - Validation errors render in an `role="alert"` region tied to the field.
 - The select exposes correct combobox/listbox semantics; the datepicker is fully keyboard-navigable.

package/fesm2022/ng-hub-ui-forms.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { input, model, Directive, inject, TemplateRef, InjectionToken, makeEnvironmentProviders, ElementRef, ChangeDetectorRef, contentChild, contentChildren, computed, signal, effect, booleanAttribute, numberAttribute, output, DestroyRef, viewChild, ViewEncapsulation, ChangeDetectionStrategy, Component, viewChildren, PLATFORM_ID, afterRenderEffect, afterNextRender, Injectable, Renderer2, NgZone, afterEveryRender, HostAttributeToken, linkedSignal, forwardRef, Injector, HostListener, LOCALE_ID, ViewContainerRef, Pipe } from '@angular/core';
+import { input, model, Directive, inject, TemplateRef, InjectionToken, makeEnvironmentProviders, ElementRef, ChangeDetectorRef, contentChild, contentChildren, computed, signal, effect, booleanAttribute, numberAttribute, output, DestroyRef, viewChild, ViewEncapsulation, ChangeDetectionStrategy, Component, viewChildren, PLATFORM_ID, afterRenderEffect, afterNextRender, Injectable, isDevMode, Renderer2, NgZone, afterEveryRender, HostAttributeToken, linkedSignal, forwardRef, Injector, HostListener, LOCALE_ID, ViewContainerRef, Pipe } from '@angular/core';
 import * as i1 from '@angular/forms';
 import { FormControlName, FormControlDirective, Validators, FormControl, NgControl, ControlContainer, FormsModule, NG_VALUE_ACCESSOR } from '@angular/forms';
 import { Subject, takeUntil, tap, Observable, animationFrameScheduler, asapScheduler, fromEvent } from 'rxjs';
@@ -3098,8 +3098,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
 
 // @ts-nocheck -- vendored ng-select source (type-checked upstream); see ../PATCHES.md
 class ConsoleService {
+    /**
+     * The engine's write-value diagnostics are advice for whoever wrote the form, so they are
+     * kept — a dropped model is worse in silence — but held to development, where that person
+     * is the one reading, and attributed so the message is traceable to this package.
+     */
     warn(message) {
-        console.warn(message);
+        if (!isDevMode()) {
+            return;
+        }
+        console.warn(`[ng-hub-ui-forms] ${message}`);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ConsoleService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: ConsoleService, providedIn: 'root' });