ngx-dynamic-entity 1.0.0 → 1.1.0

package/lib/field-types/dropdown-field.component.d.ts

@@ -14,7 +14,7 @@ export declare class DropdownFieldComponent {
     readonly: boolean;
     masked: boolean;
     /** Inline `options`, or the field's named list resolved through the registry (§6.3). */
-    readonly options: import("@angular/core").WritableSignal<import("@dynamic-entity/core").LocalizedText[]>;
+    readonly options: import("@angular/core").WritableSignal<DropdownOption[]>;
     readonly compareFn: (o1: any, o2: any) => boolean;
     isObjectVal(option: any): boolean;
     get label(): string;

package/lib/field-types/entity-ref-field.component.d.ts

@@ -1,6 +1,6 @@
 import { OnInit } from '@angular/core';
 import { AbstractControl } from '@angular/forms';
-import type { NestedFieldConfig, ReferenceOption } from '@dynamic-entity/core';
+import type { NestedFieldConfig } from '@dynamic-entity/core';
 import * as i0 from "@angular/core";
 /**
  * EntityRefFieldComponent — a select populated from a consumer-registered loader.

package/lib/field-types/multi-select-field.component.d.ts

@@ -14,7 +14,7 @@ export declare class MultiSelectFieldComponent {
     readonly: boolean;
     masked: boolean;
     /** Inline `options`, or the field's named list resolved through the registry (§6.3). */
-    readonly options: import("@angular/core").WritableSignal<import("@dynamic-entity/core").LocalizedText[]>;
+    readonly options: import("@angular/core").WritableSignal<DropdownOption[]>;
     readonly compareFn: (o1: any, o2: any) => boolean;
     isObjectVal(option: any): boolean;
     get label(): string;

package/lib/field-types/radio-field.component.d.ts

@@ -15,7 +15,7 @@ export declare class RadioFieldComponent {
     readonly: boolean;
     masked: boolean;
     /** Inline `options`, or the field's named list resolved through the registry (§6.3). */
-    readonly options: import("@angular/core").WritableSignal<import("@dynamic-entity/core").LocalizedText[]>;
+    readonly options: import("@angular/core").WritableSignal<DropdownOption[]>;
     get label(): string;
     getOptStoredVal(option: any): any;
     /**

package/lib/form/dynamic-form.component.d.ts

@@ -1,6 +1,7 @@
 import { EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { AbstractControl, FormArray, FormGroup } from '@angular/forms';
 import type { EntityFormConfig, FormRule, NestedFieldConfig, NestedTabConfig } from '@dynamic-entity/core';
+import { RbacService } from '../services/rbac.service';
 import * as i0 from "@angular/core";
 /**
  * DynamicFormComponent — the main form component.
@@ -49,6 +50,7 @@ export declare class DynamicFormComponent implements OnInit, OnChanges, OnDestro
     private readonly rulesEvaluation;
     private readonly entityRefSelection;
     private readonly commonModulesRegistry;
+    private readonly migrations;
     protected readonly Object: ObjectConstructor;
     readonly activeTab: import("@angular/core").WritableSignal<string>;
     readonly activeSubTab: import("@angular/core").WritableSignal<string>;
@@ -64,7 +66,7 @@ export declare class DynamicFormComponent implements OnInit, OnChanges, OnDestro
     /** Previous values, for detecting `patchOnTrue` false→true transitions. */
     private previousValues;
     handleKeyboardEvent(event: KeyboardEvent): void;
-    readonly ruleResult: import("@angular/core").Signal<import("@dynamic-entity/core").RuleEvaluationResult>;
+    readonly ruleResult: import("@angular/core").Signal<RuleEvaluationResult>;
     /**
      * Critical fields whose value differs from the session baseline.
      * These drive the deferred `VALUE_CHANGED` banner — a critical edit is announced once,
@@ -78,12 +80,49 @@ export declare class DynamicFormComponent implements OnInit, OnChanges, OnDestro
     get activeSubTabConfig(): NestedTabConfig | null;
     get activeTabModuleComponent(): any | null;
     get fieldsForActiveTab(): NestedFieldConfig[];
-    get permissions(): {
-        canView: boolean;
-        canEdit: boolean;
-        canDelete: boolean;
-    };
+    /**
+     * Entity-level permissions for the current roles.
+     *
+     * Cached rather than recomputed: this is read from the template several times per change
+     * detection pass, and a fresh object each time is both wasted allocation and a new
+     * identity for anything comparing by reference. Invalidated in `ngOnChanges` when
+     * `config` or `userRoles` change, which are its only inputs.
+     */
+    get permissions(): ReturnType<RbacService['getPermissions']>;
+    private permissionsCache;
+    /**
+     * Whether the current roles may see this record at all.
+     *
+     * `permissions.view` used to be computed and thrown away — a user whose roles failed it
+     * still received the complete form with every value in the DOM. It is honoured now.
+     *
+     * As with masking, this is presentational: it stops the browser rendering data, it does
+     * not stop the data reaching the browser. Authorize on the server.
+     */
+    get canView(): boolean;
+    /**
+     * Whether the current roles may delete this record.
+     *
+     * The library ships no delete affordance, so this is surfaced for the consumer to gate
+     * their own — exposed rather than dropped, because a permission the schema declares
+     * should be answerable.
+     */
+    get canDelete(): boolean;
     get canSubmit(): boolean;
+    /**
+     * Errors raised by `validation` rules, keyed by the target they point at.
+     *
+     * A rule can declare the record invalid independently of Angular's validators, so form
+     * validity alone is not the whole picture. `DynamicRecordFormComponent.saveSection()`
+     * has always honoured these; `submit()` did not, which meant the same rule blocked one
+     * save path and merely painted a banner on the other — and anything wiring
+     * `(formSubmit)` to persistence wrote records the rules engine had already rejected.
+     */
+    get ruleValidationErrors(): Record<string, string>;
+    /** True when a `validation` rule is currently blocking submission. */
+    get hasRuleErrors(): boolean;
+    /** Single source of truth for both the submit guard and the button's disabled state. */
+    get submitBlocked(): boolean;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -113,7 +152,31 @@ export declare class DynamicFormComponent implements OnInit, OnChanges, OnDestro
      */
     createArrayRow(field: NestedFieldConfig, value?: unknown): AbstractControl;
     private buildArrayRow;
+    /**
+     * Bring a record up to the config's `version` before it reaches the form.
+     *
+     * Done here because this is the one place a record enters the renderer, so a consumer
+     * cannot forget it. Migration is a no-op unless the consumer registered steps *and* the
+     * record is behind — an unstamped record is deliberately left alone (see `migrateRecord`).
+     *
+     * A missing or broken step throws from core. That is not swallowed: rendering a
+     * half-understood record would write it back in a shape matching neither schema.
+     */
+    private upgradeRecord;
     private patchForm;
+    /**
+     * A record is nested by tab id (`{ tabId: { fieldId: value } }`) unless the tab sets
+     * `flatData: true`. Handing a flat record to a nested tab finds nothing, so the fields
+     * stay empty — with no error and no clue. That silent miss is the most expensive way to
+     * lose an hour with this library, so name it in dev builds.
+     *
+     * Only top-level keys that match a known field id are reported: anything else is assumed
+     * to be the consumer's own record metadata (ids, timestamps, `_configVersion`) and is not
+     * our business.
+     */
+    private warnUnconsumedInitialData;
+    /** Warn once per key per form instance — patchForm re-runs on every initialData change. */
+    private readonly warnedUnconsumedKeys;
     /** Assemble full nested record from per-tab FormGroups, respecting flatData, refererField & arrays. */
     extractRecord(): Record<string, any>;
     private flattenFormValues;
@@ -130,6 +193,30 @@ export declare class DynamicFormComponent implements OnInit, OnChanges, OnDestro
     private runPatchOnTrue;
     /** Prefer a control declared on the configured target tab; fall back to a top-level control. */
     private resolveTargetControl;
+    /**
+     * The fields the render filter operates on — a tab's own fields, at every tab depth.
+     * Deliberately not `allFields()`: `group` and `array` children are shown or hidden with
+     * their parent, and toggling a child's state independently would fight the parent's.
+     */
+    private tabFields;
+    /**
+     * Keep a hidden field's control out of form validity.
+     *
+     * A field hidden by a rule or a `showWhen` condition is filtered out of the render, but
+     * its validators stay attached — so a hidden *required* field holds `form.invalid` true
+     * forever, permanently disabling Save with nothing on screen to explain why.
+     *
+     * Disabling is the fix rather than stripping validators: Angular excludes disabled
+     * controls from validity, and the field's own validators survive intact for when it
+     * comes back. Values are untouched — `flattenFormValues` and `extractRecord` both read
+     * `control.value`, which a disabled control still carries, so rule evaluation and the
+     * emitted record see exactly what they saw before. That also keeps this from feeding
+     * back on itself: hiding a field cannot change the values the rules are evaluated over.
+     *
+     * The visibility predicate is the same one `fieldsForActiveTab` filters with, so what is
+     * rendered and what counts toward validity cannot drift apart.
+     */
+    private syncHiddenFieldState;
     /** Every field in the config, including `group`/`array` children. */
     private allFields;
     /** An empty `originalData` counts as "not supplied" — fall back to the captured baseline. */

package/lib/form/dynamic-record-form.component.d.ts

@@ -70,7 +70,7 @@ export declare class DynamicRecordFormComponent implements OnChanges {
      * building a row's FormGroup inside the tab view races the tab's own initialisation, so
      * the row form is kept detached and only pushed into the FormArray on save.
      */
-    readonly inlineRowField: import("@angular/core").WritableSignal<NestedFieldConfig>;
+    readonly inlineRowField: import("@angular/core").WritableSignal<any>;
     readonly inlineRowIndex: import("@angular/core").WritableSignal<number>;
     inlineRowForm: FormGroup | null;
     /** `array` fields on the tab currently shown, so the template can list their rows. */
@@ -153,7 +153,18 @@ export declare class DynamicRecordFormComponent implements OnChanges {
     toggleHeaderStatus(): void;
     /** Locate a field's control wherever it lives, since header fields may be on any tab. */
     private controlFor;
-    /** A field's current value, read from the record so it is stable during render. */
+    /**
+     * A field's current value, read from the record so it is stable during render.
+     *
+     * Resolved through `getTabData` so it honours exactly the nesting contract the form
+     * patches with — `{ tabId: { fieldId } }`, or the record root when the tab sets
+     * `flatData`. Reading the record flat instead is not a shortcut: it makes the summary
+     * display values the form never loaded, which reads as "the data is there" while every
+     * control behind it is empty.
+     *
+     * Walks sub-tabs as well: a summary, header, or profile field may sit on any tab at any
+     * depth.
+     */
     private fieldValue;
     readonly isModified: import("@angular/core").Signal<boolean>;
     readonly summaryFields: import("@angular/core").Signal<NestedFieldConfig[]>;

package/lib/providers/provide-ngx-dynamic-entity.d.ts

@@ -1,5 +1,6 @@
 import { EnvironmentProviders, Type } from '@angular/core';
-import type { EntityReferenceLoader, LookupListSource } from '@dynamic-entity/core';
+import type { EntityReferenceLoader, LookupListSource, RecordMigration } from '@dynamic-entity/core';
+import { type HookFn } from '../tokens/injection-tokens';
 export interface NgxDynamicEntityConfig {
     /** Roles that see masked field values as XXXXXXXXX */
     maskedRoles?: string[];
@@ -19,7 +20,12 @@ export interface NgxDynamicEntityConfig {
     /** Custom validator functions keyed by validator name */
     validators?: Record<string, any>;
     /** Hook functions keyed by hook name */
-    hooks?: Record<string, Function>;
+    hooks?: Record<string, HookFn>;
+    /**
+     * Ordered steps that upgrade a saved record when `EntityFormConfig.version` moves ahead
+     * of the record's `_configVersion`. Applied to `initialData` before the form is patched.
+     */
+    migrations?: RecordMigration[];
 }
 /**
  * Provider function for ngx-dynamic-entity.

package/lib/tokens/injection-tokens.d.ts

@@ -1,6 +1,5 @@
 import { InjectionToken } from '@angular/core';
 import type { Type } from '@angular/core';
-import type { CommonModuleEntry, EntityReferenceLoader, FileUploadHandler, LookupListSource } from '@dynamic-entity/core';
 import { type EntityRefCacheStore } from '../services/entity-ref-cache';
 /** Roles that see XXXXXXXXX for masked fields (ADR-003) */
 export declare const MASKED_ROLES: InjectionToken<string[]>;
@@ -43,10 +42,33 @@ export declare const ENTITY_REF_REGISTRY: InjectionToken<Map<string, EntityRefer
  * })
  */
 export declare const LOOKUP_REGISTRY: InjectionToken<Map<string, LookupListSource>>;
+/**
+ * Ordered steps that move a saved record forward when a config's `version` increases.
+ *
+ * Without these, `EntityFormConfig.version` and `VersionedRecord._configVersion` are
+ * declarations nothing acts on: a schema can be edited freely while records keep their old
+ * shape, and nothing reconciles the two. Registering migrations makes the version numbers
+ * mean something.
+ *
+ * @example
+ * provideNgxDynamicEntity({
+ *   migrations: [
+ *     { from: 1, to: 2, description: 'split name', migrate: r => ({ ...r, firstName: r['name'] }) },
+ *   ],
+ * })
+ */
+export declare const RECORD_MIGRATIONS: InjectionToken<RecordMigration[]>;
 /** Registry: validator key → ValidatorFn */
 export declare const VALIDATOR_REGISTRY: InjectionToken<Map<string, any>>;
+/**
+ * A registered hook: receives the payload, returns it (or a replacement), sync or async.
+ *
+ * Spelled out rather than typed as `Function`, which accepts class declarations and any
+ * arity and gives a consumer no signature to write against.
+ */
+export type HookFn = (data: any, context?: unknown) => unknown | Promise<unknown>;
 /** Registry: hook key → async (data, context) => data */
-export declare const HOOK_REGISTRY: InjectionToken<Map<string, Function>>;
+export declare const HOOK_REGISTRY: InjectionToken<Map<string, HookFn>>;
 /**
  * Consumer-registered list of common module tabs (documents, audit, tasks, etc.).
  * The library ships no built-in implementations. Consumers provide their own list

package/package.json

@@ -1,35 +1,34 @@
 {
   "name": "ngx-dynamic-entity",
-  "version": "1.0.0",
-  "description": "Angular 17 standalone UI library for dynamic entity forms and tables.",
+  "version": "1.1.0",
+  "description": "Angular standalone UI library for rendering dynamic entity forms.",
+  "//typings": "Local workspace resolution only: ng-packagr overwrites this with the correct in-tarball path ('index.d.ts') when generating dist/package.json. Do NOT add a 'main' field here — ng-packagr does not generate one, so it would be copied verbatim and resolve to dist/dist/... in the published package.",
   "typings": "index.d.ts",
-  "main": "./dist/fesm2022/ngx-dynamic-entity.mjs",
   "peerDependencies": {
-    "@angular/cdk": "^17.0.0",
-    "@angular/common": "^17.0.0",
-    "@angular/core": "^17.0.0",
-    "@angular/forms": "^17.0.0",
-    "@angular/material": "^17.0.0",
-    "@dynamic-entity/core": "^1.0.0",
+    "@angular/common": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@angular/forms": "^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0 || ^22.0.0",
+    "@dynamic-entity/core": "^1.1.0",
     "rxjs": "^7.0.0"
   },
-  "peerDependenciesMeta": {
-    "@angular/cdk": {
-      "optional": true
-    },
-    "@angular/material": {
-      "optional": true
-    }
-  },
   "keywords": [
     "angular",
     "dynamic-entity",
     "dynamic-forms",
-    "dynamic-table",
     "rbac"
   ],
   "license": "MIT",
   "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/berserker5619/Dynamic-Entity.git",
+    "directory": "packages/ngx-dynamic-entity"
+  },
+  "homepage": "https://github.com/berserker5619/Dynamic-Entity/tree/main/packages/ngx-dynamic-entity#readme",
+  "bugs": {
+    "url": "https://github.com/berserker5619/Dynamic-Entity/issues"
+  },
+  "author": "Nizamudeen",
   "module": "fesm2022/ngx-dynamic-entity.mjs",
   "exports": {
     "./package.json": {

package/public-api.d.ts

@@ -19,10 +19,20 @@ export * from './lib/form/dynamic-field/dynamic-field.component';
 export * from './lib/field-types/text-field.component';
 export * from './lib/field-types/textarea-field.component';
 export * from './lib/field-types/number-field.component';
+export * from './lib/field-types/currency-field.component';
+export * from './lib/field-types/email-field.component';
+export * from './lib/field-types/password-field.component';
 export * from './lib/field-types/checkbox-field.component';
+export * from './lib/field-types/boolean-field.component';
 export * from './lib/field-types/date-field.component';
+export * from './lib/field-types/month-year-field.component';
 export * from './lib/field-types/dropdown-field.component';
+export * from './lib/field-types/radio-field.component';
 export * from './lib/field-types/multi-select-field.component';
 export * from './lib/field-types/entity-ref-field.component';
+export * from './lib/field-types/group-field.component';
+export * from './lib/field-types/array-field.component';
+export * from './lib/field-types/image-field.component';
+export * from './lib/field-types/file-field.component';
 export { resolveLabel, resolveOptionLabel, resolveOptionValue, formatDisplayValue, valuesMatch, normalizeOption, normalizeConfig, } from '@dynamic-entity/core';
 export type { EntityFormConfig, NestedTabConfig, NestedFieldConfig, FieldTableConfig, RichFieldType, LocalizedText, DropdownOption, VersionedRecord, EntityPermissions, RbacContext, FieldValidators, EntityReferenceConfig, EntityReferenceLoader, ReferenceOption, ReferenceLoaderContext, AutoPatchConfig, PatchOnTrueMapping, FileRef, FormRule, RuleCondition, RuleAction, RuleEvaluationResult, CommonModuleEntry, } from '@dynamic-entity/core';