@fuentis/phoenix-ui 0.0.9-alpha.658 → 0.0.9-alpha.660

package/index.d.ts

@@ -7,7 +7,6 @@ import * as rxjs from 'rxjs';
 import { Subject, Subscription, Observable } from 'rxjs';
 import { Router } from '@angular/router';
 import { Table } from 'primeng/table';
-import * as _angular_forms from '@angular/forms';
 import { FormGroup, FormBuilder, AbstractControl } from '@angular/forms';
 import { HttpClient } from '@angular/common/http';
 import { DynamicDialogRef, DynamicDialogConfig } from 'primeng/dynamicdialog';
@@ -1436,143 +1435,96 @@ interface MetaFormV2Config {
 }
 
 type AccordionValue = string | number | string[] | number[] | null | undefined;
-declare class MetaFormV2Component implements OnChanges, OnDestroy {
-    /** Form instance created/owned by the parent (dialog/page) */
-    form: FormGroup;
-    /**
-     * V2 metadata/config:
-     * - controls (grouped or flat)
-     * - initialValues
-     * - submitValidators (run on submit only)
-     * - setupDependencies (optional runtime bindings)
-     */
-    config: MetaFormV2Config;
-    /**
-     * Page-level readOnly state controlled by parent.
-     * Used both for rendering and for "enter edit mode" behavior.
-     */
-    readOnly: boolean;
-    /** Optional layout customization for inner content wrapper */
-    contentStyle: Record<string, any> | null;
-    /** Optional class name(s) applied to inner content wrapper */
-    contentClass: string | null;
-    /** Builds/ensures controls exist (ensures validators & default values are wired) */
+/**
+ * V2 form host. Signal-based (OnPush): inputs are `input()` signals, the
+ * template-facing structure (`hasControls`/`isGrouped`/`groupedControls`/
+ * `controlRows`) is `computed()` (so `splitControlsIntoRows` runs only when the
+ * config changes, not on every CD pass), and `expandedGroupIds` is a signal.
+ *
+ * Reactive forms aren't signal-native, so control building stays imperative: the
+ * first build runs synchronously in `ngOnInit` (controls exist before first
+ * paint), and an `effect()` re-runs the same build when `config`/`form`/`readOnly`
+ * change — with the same change-detection semantics the old `ngOnChanges` had.
+ */
+declare class MetaFormV2Component implements OnInit, OnDestroy {
+    /** Form instance created/owned by the parent (dialog/page). */
+    readonly form: i0.InputSignal<FormGroup<any>>;
+    /** V2 metadata/config (controls, initialValues, submitValidators, setupDependencies). */
+    readonly config: i0.InputSignal<MetaFormV2Config>;
+    /** Page-level readOnly state (rendering + "enter edit mode" behavior). */
+    readonly readOnly: i0.InputSignal<boolean>;
+    /** Optional layout customization for the inner content wrapper. */
+    readonly contentStyle: i0.InputSignal<Record<string, any> | null>;
+    /** Optional class name(s) for the inner content wrapper. */
+    readonly contentClass: i0.InputSignal<string | null>;
     private fb;
-    /** Registers and executes submit-only validators (async validation on submit) */
     private submitValidator;
-    /** Used for validator localization (lang-dependent validators / messages) */
     private translate;
-    /**
-     * A lightweight signature of the current metadata structure.
-     * Used to detect when the form schema changes (and avoid unnecessary resets).
-     */
+    /** Signature of the current schema (key+type only) to detect real schema changes. */
     private lastSignature;
-    /**
-     * Cleanup function returned by setupDependencies (if any).
-     * Called only when metadata structure changes or on destroy.
-     */
+    /** Cleanup from setupDependencies; called on schema change or destroy. */
     private depCleanup?;
+    /** Previous input references, to reproduce the old SimpleChanges semantics. */
+    private prevConfig;
+    private prevForm;
+    private prevReadOnly;
+    private initialized;
+    /** PrimeNG Accordion opened-panel ids. */
+    readonly expandedGroupIds: i0.WritableSignal<string[]>;
+    readonly hasControls: i0.Signal<boolean>;
+    /** Heuristic: grouped config has "ctrl" on the first element. */
+    readonly isGrouped: i0.Signal<boolean>;
+    readonly groupedControls: i0.Signal<any[]>;
+    readonly flatControls: i0.Signal<any[]>;
+    /** Flat schema split into rows, honoring `style.newRow` hard breaks. */
+    readonly controlRows: i0.Signal<any[][]>;
+    constructor();
+    ngOnInit(): void;
     /**
-     * PrimeNG Accordion "value" for opened panels.
-     * For multiple panels, PrimeNG expects an array of ids.
-     */
-    expandedGroupIds: string[];
-    ngOnChanges(changes: SimpleChanges): void;
-    /**
-     * PrimeNG Accordion emits value as:
-     * - single id (string/number)
-     * - array of ids
-     * We normalize everything into string[] for stable internal state.
+     * Ensures controls, patches initial values, wires validators/dependencies and
+     * initializes accordion state — only when config/form/readOnly actually change
+     * (same early-exit the old ngOnChanges had).
      */
+    private rebuild;
+    /** Normalizes PrimeNG Accordion value into a stable string[]. */
     onAccordionValueChange(v: AccordionValue): void;
-    /** Normalizes Accordion value into a stable string[] representation */
     private normalizeAccordionValue;
-    /** True when metadata contains at least one control definition */
-    get hasControls(): boolean;
-    /**
-     * Heuristic: grouped config has "ctrl" on first element.
-     * (Keeps template simple and avoids extra schema fields.)
-     */
-    get isGrouped(): boolean;
-    /** Returns grouped schema structure (accordion groups) */
-    get groupedControls(): any[];
-    /** Returns flat schema structure (grid mode) */
-    get flatControls(): any[];
-    /**
-     * Flat schema split into row chunks, honoring `style.newRow` hard breaks.
-     * Used by the non-grouped grid template.
-     */
-    get controlRows(): any[][];
-    /** TrackBy for group rendering */
+    /** TrackBy for group rendering. */
     groupTrack(g: any, idx: number): any;
-    /**
-     * PrimeNG accordion panel `value` must match accordion `value` type.
-     * We always convert group id to string for consistent behavior.
-     */
+    /** Group id as a string (matches the accordion `value` type). */
     panelValue(g: any): string;
-    /**
-     * Marks & validates ONLY controls that already have meaningful values.
-     * This is used when switching from readOnly -> edit mode to avoid:
-     * - triggering "required" errors for empty fields
-     * - expanding groups based on empty mandatory fields on CREATE dialogs
-     */
+    /** Marks & validates ONLY controls that already have meaningful values. */
     private touchAndValidateOnlyFilledControls;
-    /**
-     * Defines what counts as a "meaningful" value:
-     * - non-empty strings
-     * - numbers / booleans
-     * - non-empty arrays
-     * - objects with common identifiers (key/uuid/id) or any own keys
-     */
+    /** What counts as a "meaningful" value (non-empty string/number/boolean/array/object). */
     private hasMeaningfulValue;
-    /**
-     * "Visible invalid" means:
-     * - invalid
-     * - AND user has interacted with it (touched or dirty)
-     * This matches typical UI behavior: show errors only after interaction.
-     */
+    /** "Visible invalid" = invalid AND interacted with (touched/dirty). */
     private isVisibleInvalid;
-    /**
-     * Checks if a group contains at least one visible invalid control.
-     * Used to auto-expand groups when entering edit mode.
-     */
     private groupHasVisibleInvalid;
-    /**
-     * Expands all groups that contain visible invalid controls,
-     * while preserving any groups already expanded by the user.
-     */
+    /** Expands groups with visible-invalid controls, preserving user-expanded ones. */
     private expandVisibleInvalidGroupsUnion;
-    /** Cleanup dependency subscriptions when component is destroyed */
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MetaFormV2Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MetaFormV2Component, "phoenix-meta-form-v2", never, { "form": { "alias": "form"; "required": true; }; "config": { "alias": "config"; "required": true; }; "readOnly": { "alias": "readOnly"; "required": false; }; "contentStyle": { "alias": "contentStyle"; "required": false; }; "contentClass": { "alias": "contentClass"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MetaFormV2Component, "phoenix-meta-form-v2", never, { "form": { "alias": "form"; "required": true; "isSignal": true; }; "config": { "alias": "config"; "required": true; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "contentStyle": { "alias": "contentStyle"; "required": false; "isSignal": true; }; "contentClass": { "alias": "contentClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Renders one meta field. Signal-based (OnPush): every template-facing value is a
+ * `computed()` so it is memoized and recomputed only when its inputs actually
+ * change — instead of a plain method re-running on every change-detection pass.
+ * Control state (value/status) is bridged into a signal (`controlTick`), so the
+ * error helpers stay reactive without a manual `markForCheck()`.
+ */
 declare class MetaFormFieldV2Component {
     /** Metadata definition of the field (type, key, options, styles, flags, etc.) */
-    field: MetaFieldConfig;
-    /** Parent FormGroup that contains the FormControl for this field */
-    form: FormGroup;
-    /**
-     * Page-level read-only flag.
-     * When true, the component renders ReadOnlyInputV2Component instead of editable controls.
-     */
-    readOnly: boolean;
-    /**
-     * Global disable flag (e.g. parent dialog toggles entire form disabled).
-     * This is merged with field-level disable configuration.
-     */
-    disableForm: boolean;
-    /** Used to manually trigger change detection for OnPush strategy */
-    private cdr;
-    /** Used to automatically unsubscribe from value/status streams on destroy */
-    private dr;
-    /** Translation service for validation and display labels */
+    readonly field: i0.InputSignal<MetaFieldConfig>;
+    /** Parent FormGroup that contains the FormControl for this field. */
+    readonly form: i0.InputSignal<FormGroup<any>>;
+    /** Page-level read-only flag (renders the read-only view). */
+    readonly readOnly: i0.InputSignal<boolean>;
+    /** Global disable flag (merged with the field-level disable config). */
+    readonly disableForm: i0.InputSignal<boolean>;
     private translate;
-    /**
-     * Exposed enum-like mapping of MetaFieldType for template usage.
-     * Keeps templates readable and avoids magic strings.
-     */
+    /** Enum-like map for the template `@switch`. */
     readonly MetaFieldType: Readonly<{
         TEXT: "TEXT";
         URL: "URL";
@@ -1599,62 +1551,40 @@ declare class MetaFormFieldV2Component {
         LINKS_DATA: "LINKS_DATA";
         SLOT: "SLOT";
     }>;
-    /** Control key resolved from MetaFieldConfig */
-    get key(): string;
-    /** Field type resolved from MetaFieldConfig */
-    get type(): MetaFieldType;
-    /** Column width class for grid layout (falls back to default if not provided) */
-    get colClass(): string;
-    ngOnInit(): void;
-    /** Human-friendly label defined in metadata (already localized key) */
-    userFriendlyMessage(): string | null;
-    /** Optional placeholder i18n key defined in metadata */
-    placeholderKey(): string | null;
-    /**
-     * Resolves final read-only state for this field:
-     * - page-level readOnly OR field-level readOnly
-     */
-    isReadOnly(): boolean;
-    /**
-     * Resolves final disabled state for this field:
-     * - page-level disable OR field-level disable
-     */
-    isDisabled(): boolean;
-    /** Shortcut to underlying FormControl */
-    ctrl(): _angular_forms.AbstractControl<any, any, any> | null;
-    /**
-     * Minimal value formatter for legacy read-only rendering.
-     * Kept intentionally simple to match V1 behavior.
-     */
+    readonly key: i0.Signal<string>;
+    readonly type: i0.Signal<MetaFieldType>;
+    readonly colClass: i0.Signal<string>;
+    readonly userFriendlyMessage: i0.Signal<string | null>;
+    readonly placeholderKey: i0.Signal<string | null>;
+    readonly isReadOnly: i0.Signal<boolean>;
+    readonly isDisabled: i0.Signal<boolean>;
+    readonly isCheckbox: i0.Signal<boolean>;
+    /** The underlying FormControl for this field (recomputed if form/key change). */
+    readonly ctrl: i0.Signal<AbstractControl<any, any, any> | null>;
+    /**
+     * Bridge the current control's value/status stream into a signal so the error
+     * helpers below recompute reactively (reactive forms aren't signal-native yet).
+     * Re-subscribes when the control identity changes.
+     */
+    private readonly controlTick;
+    /** Bumped for silent (emitEvent:false) programmatic writes, e.g. the date field. */
+    private readonly manualTick;
+    /** Track the active language so translated error text refreshes on lang change. */
+    private readonly lang;
+    /** Show validation only after interaction (touched/dirty). */
+    readonly showError: i0.Signal<boolean>;
+    /** Normalized error key for the current control. */
+    readonly errorKey: i0.Signal<string | null>;
+    /** Translated validation message (the single place that owns error UX text). */
+    readonly errorText: i0.Signal<string>;
+    /** Minimal value formatter for legacy read-only rendering (not used in template). */
     displayValue(): any;
-    /**
-     * Determines whether validation error should be displayed.
-     * Errors are shown only after user interaction (touched or dirty).
-     */
-    showError(): boolean;
-    /**
-     * Maps control error object to a normalized error key.
-     * Supports:
-     * - Angular built-in validators
-     * - Phoenix custom validators
-     * - Submit-only async validators
-     */
-    errorKey(): string | null;
-    /**
-     * Resolves translated error message based on errorKey().
-     * This is the single place responsible for validation message UX.
-     */
-    errorText(): string;
-    /**
-     * Lightweight text formatter for simple read-only display use cases.
-     * This is used mainly for inline displays and summary UIs.
-     */
+    /** Lightweight text formatter for simple read-only/summary display. */
     valueText(): string;
-    isCheckbox(): boolean;
     onDateSelected(val: any): void;
     onDateCleared(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MetaFormFieldV2Component, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MetaFormFieldV2Component, "phoenix-meta-form-field-v2", never, { "field": { "alias": "field"; "required": true; }; "form": { "alias": "form"; "required": true; }; "readOnly": { "alias": "readOnly"; "required": false; }; "disableForm": { "alias": "disableForm"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MetaFormFieldV2Component, "phoenix-meta-form-field-v2", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "form": { "alias": "form"; "required": true; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "disableForm": { "alias": "disableForm"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class MetaFormGroupV2Component {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuentis/phoenix-ui",
-  "version": "0.0.9-alpha.658",
+  "version": "0.0.9-alpha.660",
   "description": "Phoenix UI Angular component library",
   "license": "MIT",
   "peerDependencies": {