@ngneers/controls 0.0.1-next.1 → 0.0.1-next.2

package/types/ngneers-controls-errors.d.ts

@@ -1,7 +1,45 @@
 import * as _angular_core from '@angular/core';
 import { Signal, InjectionToken, Provider } from '@angular/core';
-import { NgnHint } from '@ngneers/controls/hint';
 import { ValidationErrors } from '@angular/forms';
+import { NgnHint } from '@ngneers/controls/hint';
+
+/**
+ * A paradigm-agnostic, reactive view of the form control sitting on the host
+ * element — the compatibility layer `ngnErrors` reads so it never has to branch
+ * on which form paradigm is in play.
+ *
+ * Angular 22 has no single signal API spanning the three paradigms, so this
+ * bridges them onto one shape:
+ * - **Reactive** (`formControl` / `formControlName`) and **template-driven**
+ *   (`ngModel`) both expose an `NgControl` → `AbstractControl`.
+ * - **Signal forms** (`[formField]`) provide the same `NgControl` via interop,
+ *   backed by the field's `errors()` / `touched()` / `dirty()` / `pending()`.
+ * - **No form**: there is no `AbstractControl`, so `touched` falls back to the
+ *   control's own `touched` signal (also reflecting an external `[touched]`
+ *   binding), OR-ed with its `touch` output (blur) for controls that only report
+ *   blur that way.
+ *
+ * `AbstractControl` isn't signal-based; its single `events` stream (value /
+ * status / touched / pristine) is the one subscription that keeps these signals
+ * live — replacing separate `valueChanges` + `statusChanges` watches.
+ */
+interface NgnControlState {
+    /** Host control name, used to match relevant parent/group errors. */
+    readonly name: string | number | null;
+    /** Validation errors of the host control (all paradigms), or `null`. */
+    readonly errors: Signal<ValidationErrors | null>;
+    /** Validation errors of the parent group, when distinct from the host. */
+    readonly parentErrors: Signal<ValidationErrors | null>;
+    readonly touched: Signal<boolean>;
+    readonly dirty: Signal<boolean>;
+    readonly pending: Signal<boolean>;
+    readonly submitted: Signal<boolean>;
+}
+/**
+ * Resolves and reactively tracks the {@link NgnControlState} of the host
+ * element. Must be called in an injection context (field/directive constructor).
+ */
+declare function injectNgnControlState(): NgnControlState;
 
 /**
  * Origin of a normalized validation error.
@@ -76,6 +114,24 @@ interface NgnErrorsState {
     message: string | null;
 }
 
+/**
+ * Resolves validation errors for the control it sits on and exposes them as
+ * normalized, message-mapped signals — ready to bridge into an {@link NgnHint}
+ * via {@link NgnErrors.ngnErrorsHint}.
+ *
+ * Which form paradigm is in play is abstracted away by {@link injectNgnControlState}:
+ * template-driven (`ngModel`), reactive (`formControl` / `formControlName`) and
+ * signal forms (`[formField]`) all surface as one reactive state, including
+ * relevant parent-group errors and a no-form `touched` fallback.
+ *
+ * `ngnErrorsCustom` layers on additional errors independently of any form, and
+ * {@link NgnErrors.ngnErrorsShowOn} controls when messages surface (defaults to
+ * `touched`). Error keys map onto the shared message table; signal-forms
+ * `minLength` / `maxLength` kinds have their own table entries alongside the
+ * classic lowercase `minlength` / `maxlength`.
+ *
+ * @category control
+ */
 declare class NgnErrors {
     /**
      * Hint instance that receives the resolved validation state.
@@ -102,30 +158,52 @@ declare class NgnErrors {
      * @category inputs
      */
     readonly ngnErrorsCustom: _angular_core.InputSignal<NgnErrorsCustom>;
-    private readonly _ngControl;
-    private readonly _selfContainer;
-    private readonly _parentContainer;
-    private readonly _ngnControl;
+    /** Paradigm-agnostic view of the host control (see {@link injectNgnControlState}). */
+    private readonly _state;
+    private readonly _i18n;
     private readonly _globalMessages;
-    private readonly _version;
     readonly errors: Signal<readonly NgnError[]>;
     readonly firstError: Signal<NgnError | null>;
     readonly pending: Signal<boolean>;
+    /**
+     * Whether the i18n error defaults are loaded. Probes a core key that every
+     * locale defines — until the async translation import lands, `_translate`
+     * echoes the key path back, which this detects.
+     */
+    private readonly _i18nReady;
+    /**
+     * Whether display should wait: some visible error depends on the i18n default
+     * (no instance / carried / global message) and translations aren't loaded yet.
+     */
+    private readonly _awaitingI18n;
     readonly visible: Signal<boolean>;
     readonly message: Signal<string | null>;
     readonly state: Signal<NgnErrorsState>;
     constructor();
-    private _watchControl;
-    private _hostControl;
-    private _parentControl;
-    private _rootControl;
-    private _submittedSource;
-    private _submitted;
     private _normalizeGroupErrors;
     private _normalizeCustomErrors;
     private _normalizeErrors;
     private _createCustomEntryError;
     private _createError;
+    /**
+     * Resolves a display message for an error, in priority order:
+     * per-instance {@link ngnErrorsMessages} → a message carried on the error
+     * itself → globally provided messages → the i18n `errors.*` default → the key.
+     */
+    private _resolveMessage;
+    /**
+     * Whether an error's message can only come from the i18n default (or the raw
+     * key fallback) — i.e. no per-instance, carried, or global message applies.
+     * Such errors are held from display until translations load (see
+     * {@link _awaitingI18n}); all others show immediately.
+     */
+    private _dependsOnI18n;
+    /**
+     * Looks up the i18n `errors.<key>` default, interpolating the error params.
+     * Returns `undefined` when the key is unknown or translations aren't loaded —
+     * `signal-translate` echoes the flat path back in that case, which we detect.
+     */
+    private _translate;
     private _isGroupErrorRelevant;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnErrors, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgnErrors, "[ngnErrors]", ["ngnErrors"], { "ngnErrorsHint": { "alias": "ngnErrorsHint"; "required": false; "isSignal": true; }; "ngnErrorsShowOn": { "alias": "ngnErrorsShowOn"; "required": false; "isSignal": true; }; "ngnErrorsMode": { "alias": "ngnErrorsMode"; "required": false; "isSignal": true; }; "ngnErrorsMessages": { "alias": "ngnErrorsMessages"; "required": false; "isSignal": true; }; "ngnErrorsCustom": { "alias": "ngnErrorsCustom"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -146,10 +224,21 @@ declare function provideNgnErrorsMessages(messages: NgnErrorsMessages): Provider
  * @category providers
  */
 declare function injectNgnErrorsMessages(): NgnErrorsMessages;
-declare const defaultNgnErrorsMessages: NgnErrorsMessages;
-declare function resolveNgnErrorMessage(context: NgnErrorsMessageContext, messages: NgnErrorsMessages): string;
+/**
+ * Resolves a message for the context's key from a user-provided message map,
+ * or `undefined` if the map has no (non-null) entry for it. Function resolvers
+ * that return `null`/`undefined` are treated as "no message" so resolution can
+ * fall through to the next source.
+ */
+declare function resolveUserMessage(context: NgnErrorsMessageContext, messages: NgnErrorsMessages): string | undefined;
+/**
+ * A message carried on the error itself — a plain-string error value, or a
+ * `message` field on the error object (e.g. a signal-forms validator's
+ * `{ message }`, or a group error). `undefined` when the error carries none.
+ */
+declare function carriedMessage(value: unknown): string | undefined;
 declare function paramsFromValue(value: unknown): Record<string, unknown>;
 declare function isRecord(value: unknown): value is Record<string, unknown>;
 
-export { NGN_ERRORS_MESSAGES, NgnErrors, defaultNgnErrorsMessages, injectNgnErrorsMessages, isRecord, paramsFromValue, provideNgnErrorsMessages, resolveNgnErrorMessage };
-export type { NgnError, NgnErrorsCustom, NgnErrorsCustomEntry, NgnErrorsMessage, NgnErrorsMessageContext, NgnErrorsMessages, NgnErrorsMode, NgnErrorsShowOn, NgnErrorsSource, NgnErrorsState };
+export { NGN_ERRORS_MESSAGES, NgnErrors, carriedMessage, injectNgnControlState, injectNgnErrorsMessages, isRecord, paramsFromValue, provideNgnErrorsMessages, resolveUserMessage };
+export type { NgnControlState, NgnError, NgnErrorsCustom, NgnErrorsCustomEntry, NgnErrorsMessage, NgnErrorsMessageContext, NgnErrorsMessages, NgnErrorsMode, NgnErrorsShowOn, NgnErrorsSource, NgnErrorsState };

package/types/ngneers-controls-filter.d.ts

@@ -55,28 +55,28 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
         readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
     }, {
         readonly class: "input-field";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
             readonly class: "input";
             readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
             readonly projected: true;
         }]>;
     }, {
         readonly class: "value";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
             readonly class: "input";
             readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
             readonly projected: true;
         }]>;
     }, {
         readonly class: "operator";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
             readonly class: "input";
             readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
             readonly projected: true;
         }]>;
     }, {
         readonly class: "list-select";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "empty", "placeholder", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
             readonly class: "popover";
             readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
         }, {
@@ -90,7 +90,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             }]>;
         }, {
             readonly class: "filter";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                 readonly class: "input";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                 readonly projected: true;
@@ -98,7 +98,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
         }]>;
     }, {
         readonly class: "operator-select";
-        readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
+        readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "empty", "placeholder", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
             readonly class: "popover";
             readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
         }, {
@@ -112,7 +112,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             }]>;
         }, {
             readonly class: "filter";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                 readonly class: "input";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                 readonly projected: true;
@@ -137,7 +137,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             readonly template: _ngneers_controls_themes.ControlTemplate<"button", ["root", "inline", "loading", `kind-${string}`, `color-${string}`], readonly []>;
         }, {
             readonly class: "current-month";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "empty", "placeholder", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
                 readonly class: "popover";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
             }, {
@@ -151,7 +151,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
                 }]>;
             }, {
                 readonly class: "filter";
-                readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+                readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                     readonly class: "input";
                     readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                     readonly projected: true;
@@ -159,7 +159,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             }]>;
         }, {
             readonly class: "current-year";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"select", ["root", "combobox", "empty", "placeholder", "input", "icon", "input-editable", "popover-content", "filter-icon", "list-box-empty"], readonly [{
                 readonly class: "popover";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"popover", ["root", "content", "content-closing"], readonly []>;
             }, {
@@ -173,7 +173,7 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
                 }]>;
             }, {
                 readonly class: "filter";
-                readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+                readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                     readonly class: "input";
                     readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                     readonly projected: true;
@@ -181,14 +181,14 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             }]>;
         }, {
             readonly class: "current-month-field";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                 readonly class: "input";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                 readonly projected: true;
             }]>;
         }, {
             readonly class: "current-year-field";
-            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+            readonly template: _ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
                 readonly class: "input";
                 readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
                 readonly projected: true;
@@ -370,6 +370,8 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -378,6 +380,18 @@ declare class NgnFilter<T = unknown> extends ValueControlBase<'filter', NgnFilte
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     protected readonly unsafeI18n: (key: string) => _angular_core.Signal<string>;
     private readonly _destroyRef;

package/types/ngneers-controls-hint.d.ts

@@ -60,6 +60,13 @@ declare class NgnHint extends NgnBase<'hint'> {
     private readonly _activeValidationState;
     private readonly _userContentTemplate;
     protected readonly hasIconOnlyTooltipContent: _angular_core.Signal<boolean>;
+    /**
+     * Whether to collapse the host. Only auto-hides when the hint is wired as a
+     * validation hint (has a validation state) that is currently not visible and
+     * carries no static content of its own — i.e. an empty error slot. Plain hints
+     * (no validation state) never auto-hide.
+     */
+    protected readonly isHidden: _angular_core.Signal<boolean>;
     /**
      * Bridge validation state from a companion directive such as ngnErrors.
      * @category methods
@@ -79,7 +86,7 @@ declare class NgnHint extends NgnBase<'hint'> {
      * The icon registry key of the default icon for the current kind, or
      * `undefined` for the neutral `default` kind.
      */
-    protected readonly defaultIconKey: _angular_core.Signal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
+    protected readonly defaultIconKey: _angular_core.Signal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "rating-full" | "rating-empty" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "stepper-completed" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnHint, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgnHint, "ngn-hint", never, { "controlId": { "alias": "controlId"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "validationState": { "alias": "validationState"; "required": false; "isSignal": true; }; }, {}, ["_userContentTemplate"], ["*"], true, never>;
 }

package/types/ngneers-controls-i18n-translations-de.d.ts

@@ -154,6 +154,8 @@ declare const de: {
         selectedCount: string;
         page: string;
         resultCount: string;
+        retry: string;
+        loadError: string;
     };
     state: {
         loading: string;
@@ -162,6 +164,18 @@ declare const de: {
         error: string;
         cancelled: string;
     };
+    errors: {
+        pending: string;
+        required: string;
+        email: string;
+        minlength: string;
+        maxlength: string;
+        minLength: string;
+        maxLength: string;
+        min: string;
+        max: string;
+        pattern: string;
+    };
 };
 
 export { de };

package/types/ngneers-controls-i18n-translations-en.d.ts

@@ -154,6 +154,8 @@ declare const en: {
         selectedCount: string;
         page: string;
         resultCount: string;
+        retry: string;
+        loadError: string;
     };
     state: {
         loading: string;
@@ -162,6 +164,18 @@ declare const en: {
         error: string;
         cancelled: string;
     };
+    errors: {
+        pending: string;
+        required: string;
+        email: string;
+        minlength: string;
+        maxlength: string;
+        minLength: string;
+        maxLength: string;
+        min: string;
+        max: string;
+        pattern: string;
+    };
 };
 
 export { en };

package/types/ngneers-controls-i18n.d.ts

@@ -158,6 +158,8 @@ declare const en: {
         selectedCount: string;
         page: string;
         resultCount: string;
+        retry: string;
+        loadError: string;
     };
     state: {
         loading: string;
@@ -166,6 +168,18 @@ declare const en: {
         error: string;
         cancelled: string;
     };
+    errors: {
+        pending: string;
+        required: string;
+        email: string;
+        minlength: string;
+        maxlength: string;
+        minLength: string;
+        maxLength: string;
+        min: string;
+        max: string;
+        pattern: string;
+    };
 };
 
 declare const supportedLanguages: readonly ["en", "de"];

package/types/ngneers-controls-icon.d.ts

@@ -26,7 +26,7 @@ declare class GlobalIconTemplate implements OnDestroy {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<GlobalIconTemplate>;
 }
 
-declare const NGN_ICON_KEYS: readonly ["accordion-collapse", "accordion-expand", "breadcrumb-separator", "breadcrumb-overflow", "calendar-trigger", "calendar-previous-month", "calendar-next-month", "checkbox-checked", "checkbox-indeterminate", "chip-remove", "dialog-close", "drawer-close", "dropdown-toggle", "edit-confirm", "filter-active", "filter-inactive", "filter-remove", "hint-info", "hint-success", "hint-warning", "hint-error", "input-clear", "menu-submenu", "paginator-previous", "paginator-next", "search", "sort-neutral", "sort-ascending", "sort-descending", "spin-decrement", "spin-increment", "table-group-toggle", "tabs-scroll-left", "tabs-scroll-right", "toast-close", "snackbar-close", "upload-trigger", "upload-done", "upload-failed", "upload-retry", "upload-cancel", "upload-remove"];
+declare const NGN_ICON_KEYS: readonly ["accordion-collapse", "accordion-expand", "breadcrumb-separator", "breadcrumb-overflow", "calendar-trigger", "calendar-previous-month", "calendar-next-month", "checkbox-checked", "checkbox-indeterminate", "chip-remove", "dialog-close", "drawer-close", "dropdown-toggle", "edit-confirm", "filter-active", "filter-inactive", "filter-remove", "hint-info", "hint-success", "hint-warning", "hint-error", "input-clear", "menu-submenu", "paginator-previous", "paginator-next", "rating-full", "rating-empty", "search", "sort-neutral", "sort-ascending", "sort-descending", "spin-decrement", "spin-increment", "stepper-completed", "table-group-toggle", "tabs-scroll-left", "tabs-scroll-right", "toast-close", "snackbar-close", "upload-trigger", "upload-done", "upload-failed", "upload-retry", "upload-cancel", "upload-remove"];
 type NgnIconKey = (typeof NGN_ICON_KEYS)[number];
 type NgnIconRegistry = Record<NgnIconKey, IconifyIcon | NgnIconEntry>;
 type NgnCustomIconRegistry = Record<NgnIconKey, IconType>;
@@ -48,7 +48,7 @@ declare class NgnIcon extends NgnBase<'icon'> {
      * Used as a fallback when {@link icon} is not provided; requires an icon registry.
      * @default undefined
      */
-    readonly defaultIcon: _angular_core.InputSignal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
+    readonly defaultIcon: _angular_core.InputSignal<"accordion-collapse" | "accordion-expand" | "breadcrumb-separator" | "breadcrumb-overflow" | "calendar-trigger" | "calendar-previous-month" | "calendar-next-month" | "checkbox-checked" | "checkbox-indeterminate" | "chip-remove" | "dialog-close" | "drawer-close" | "dropdown-toggle" | "edit-confirm" | "filter-active" | "filter-inactive" | "filter-remove" | "hint-info" | "hint-success" | "hint-warning" | "hint-error" | "input-clear" | "menu-submenu" | "paginator-previous" | "paginator-next" | "rating-full" | "rating-empty" | "search" | "sort-neutral" | "sort-ascending" | "sort-descending" | "spin-decrement" | "spin-increment" | "stepper-completed" | "table-group-toggle" | "tabs-scroll-left" | "tabs-scroll-right" | "toast-close" | "snackbar-close" | "upload-trigger" | "upload-done" | "upload-failed" | "upload-retry" | "upload-cancel" | "upload-remove" | undefined>;
     /**
      * The icon to render. Accepts an Iconify data object, a registered icon entry, or a
      * custom value resolved via the {@link GlobalIconTemplate}. Takes precedence over {@link defaultIcon}.

package/types/ngneers-controls-input-field.d.ts

@@ -10,7 +10,7 @@ import { NgnBase } from '@ngneers/controls/base';
  * @category control
  */
 declare class NgnInputField extends NgnBase<'inputField'> {
-    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`], readonly [{
+    protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"input-field", ["root", "host", "filled", "disabled", "readonly", "invalid", "label", "clear-button", `labelKind-${string}`, `kind-${string}`], readonly [{
         readonly class: "input";
         readonly template: _ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>;
         readonly projected: true;
@@ -171,6 +171,8 @@ declare class NgnInputField extends NgnBase<'inputField'> {
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -179,6 +181,18 @@ declare class NgnInputField extends NgnBase<'inputField'> {
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     /**
      * Label for the input field
@@ -217,7 +231,10 @@ declare class NgnInputField extends NgnBase<'inputField'> {
      */
     readonly tabindex: _angular_core.InputSignal<number>;
     /**
-     * Explicitly apply invalid state styling
+     * Explicitly apply invalid state styling on the field chrome. The field does
+     * not compute validity — it also reflects its projected control's own invalid
+     * state (the child's gated `aria-invalid`) via the theme. Set this only to
+     * force the invalid look regardless of the child.
      * @default false
      */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -239,6 +256,12 @@ declare class NgnInputField extends NgnBase<'inputField'> {
      * their placement/order never shadows the actual input.
      */
     readonly control: _angular_core.Signal<NgnBase<never> | undefined>;
+    /**
+     * Whether the projected control holds content. Drives float-label detection
+     * component-side (from the control's `empty` signal) so it works for every
+     * field control — select, calendar, mask-input — not just native inputs.
+     */
+    protected readonly filled: _angular_core.Signal<boolean>;
     /** The primary control's element when it is a native input/textarea. */
     private readonly _inputElement;
     constructor();

package/types/ngneers-controls-input.d.ts

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import { AfterViewInit } from '@angular/core';
 import * as _ngneers_controls_api_ng from '@ngneers/controls/api/ng';
 import * as _ngneers_controls_themes from '@ngneers/controls-themes';
-import { NgnBase } from '@ngneers/controls/base';
+import { NgnBase, NgnInvalidTrigger } from '@ngneers/controls/base';
 
 /**
  * @category control
@@ -10,21 +10,53 @@ import { NgnBase } from '@ngneers/controls/base';
 declare class NgnInput extends NgnBase<'input'> implements AfterViewInit {
     readonly isFieldControl = true;
     protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"input", ["root", "invalid", "empty"], readonly []>>;
+    readonly empty: _angular_core.Signal<boolean>;
     /**
-     * Explicitly apply invalid state styling
+     * The raw invalid flag (bound from a signal-forms field's validity, or set
+     * explicitly). Whether it *shows* is gated by {@link invalidOn} — read
+     * {@link invalidState}.
      * @default false
      */
     readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * When the input surfaces its invalid styling.
+     * @default touched
+     */
+    readonly invalidOn: _angular_core.InputSignal<NgnInvalidTrigger>;
+    /**
+     * Touched state. A bound signal-forms field writes it in (`FormUiControl`
+     * `touched` input); the input also sets it on blur, and reports blur out
+     * through {@link touch}.
+     */
+    readonly touched: _angular_core.ModelSignal<boolean>;
+    /**
+     * The invalid state the theme renders: {@link invalid} gated by
+     * {@link invalidOn}. (Dirty tracking isn't wired for the bare directive, so the
+     * `dirty` trigger behaves like `immediate` here.)
+     */
+    protected readonly invalidState: _angular_core.Signal<boolean>;
     /**
      * The current value of the input, kept in sync with the native element in both directions.
      * @default ''
      */
     readonly value: _angular_core.ModelSignal<string | null>;
+    /**
+     * Emits on blur so a bound signal-forms field is marked touched (the
+     * `FormUiControl` `touch` contract) — enables `ngnErrorsShowOn="touched"`.
+     */
+    readonly touch: _angular_core.OutputEmitterRef<void>;
     private readonly _input;
     ngAfterViewInit(): void;
     constructor();
+    /**
+     * Marks the input touched on blur: flips {@link touched} for local consumers
+     * (e.g. `ngnErrors`) and emits {@link touch} so a bound signal-forms field is
+     * marked too. Mirrors `ValueControlBase.markTouched`, which this directive
+     * can't inherit (it extends {@link NgnBase} as a native-element directive).
+     */
+    private markTouched;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgnInput, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgnInput, "input[ngnInput], textarea[ngnInput]", ["ngnInput"], { "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgnInput, "input[ngnInput], textarea[ngnInput]", ["ngnInput"], { "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "invalidOn": { "alias": "invalidOn"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "touched": "touchedChange"; "value": "valueChange"; "touch": "touch"; }, never, never, true, never>;
 }
 
 export { NgnInput };

package/types/ngneers-controls-list-box.d.ts

@@ -237,6 +237,8 @@ declare class NgnListBox<Items extends readonly NgnItem[], Multiple extends bool
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -245,6 +247,18 @@ declare class NgnListBox<Items extends readonly NgnItem[], Multiple extends bool
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     protected readonly theme: _ngneers_controls_api_ng.ControlTemplateInfo<_ngneers_controls_themes.ControlTemplate<"list-box", ["root", "empty", "invalid", "item", "group", "default-item", "default-group", "item-selected", "item-highlighted", "item-disabled"], readonly [{
         readonly class: "checkbox";

package/types/ngneers-controls-mask-input.d.ts

@@ -221,6 +221,8 @@ declare class NgnMaskInput extends ValueControlBase<'maskInput', string | null>
             selectedCount: string;
             page: string;
             resultCount: string;
+            retry: string;
+            loadError: string;
         };
         state: {
             loading: string;
@@ -229,6 +231,18 @@ declare class NgnMaskInput extends ValueControlBase<'maskInput', string | null>
             error: string;
             cancelled: string;
         };
+        errors: {
+            pending: string;
+            required: string;
+            email: string;
+            minlength: string;
+            maxlength: string;
+            minLength: string;
+            maxLength: string;
+            min: string;
+            max: string;
+            pattern: string;
+        };
     }, "_">;
     /**
      * The mask to apply to the input. Can be a predefined mask key or a custom mask configuration.