ngx-dynamic-entity 1.0.0 → 1.2.0

package/lib/services/validator-registry.service.d.ts

@@ -1,4 +1,4 @@
-import { ValidatorFn } from '@angular/forms';
+import { AsyncValidatorFn, ValidatorFn } from '@angular/forms';
 import type { FieldValidators } from '@dynamic-entity/core';
 import * as i0 from "@angular/core";
 /**
@@ -6,6 +6,7 @@ import * as i0 from "@angular/core";
  */
 export declare class ValidatorRegistryService {
     private readonly consumerRegistry;
+    private readonly asyncRegistry;
     /**
      * Resolve a validator key string to a ValidatorFn.
      * Supports parameterized built-ins like 'min:0', 'maxLength:255'.
@@ -15,6 +16,17 @@ export declare class ValidatorRegistryService {
     resolveAll(validatorKeys?: string[]): ValidatorFn[];
     /** Resolve a FieldValidators object or string[] into ValidatorFn[] */
     resolveFromConfig(config?: FieldValidators | string[]): ValidatorFn[];
+    /**
+     * Resolve the async validators a field names, in `validators.customAsync`.
+     *
+     * Async validators are deliberately a separate registry and a separate config key: Angular
+     * attaches them through `setAsyncValidators`, runs them only once the synchronous ones
+     * pass, and holds the control in `pending` until they settle. Mixing them into the
+     * synchronous list would silently never run them.
+     *
+     * An unknown name is skipped rather than throwing, matching the synchronous behaviour.
+     */
+    resolveAsyncFromConfig(config?: FieldValidators | string[]): AsyncValidatorFn[];
     static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorRegistryService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ValidatorRegistryService>;
 }

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

@@ -1,8 +1,7 @@
 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) */
+/** Roles that see XXXXXXXXX for masked fields. Presentational only — enforce authz server-side. */
 export declare const MASKED_ROLES: InjectionToken<string[]>;
 /**
  * Consumer **overrides**: fieldType string → Angular component class.
@@ -43,10 +42,50 @@ 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[]>;
+/**
+ * Overrides for the messages shown under an invalid field, keyed by Angular error key
+ * (`required`, `minlength`, `pattern`, …) plus a few field-specific keys.
+ *
+ * The built-in messages are English literals. Registering here is what makes a non-English
+ * form possible without re-implementing every field component; unlisted keys keep their
+ * default, so overriding one does not mean supplying them all.
+ */
+export declare const VALIDATION_MESSAGES: InjectionToken<Record<string, any>>;
 /** Registry: validator key → ValidatorFn */
 export declare const VALIDATOR_REGISTRY: InjectionToken<Map<string, any>>;
+/**
+ * Registry: validator key → AsyncValidatorFn.
+ *
+ * Kept separate from VALIDATOR_REGISTRY because Angular applies the two differently: an async
+ * validator runs only once the synchronous ones pass, and puts the control into `pending`
+ * while it does. Name them from a schema with `validators: { customAsync: ['uniqueEmail'] }`.
+ */
+export declare const ASYNC_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
@@ -82,10 +121,6 @@ export declare const UPLOAD_HANDLER: InjectionToken<FileUploadHandler>;
  * { provide: ENTITY_REF_CACHE_STORE, useClass: SessionStorageRefCache }
  */
 export declare const ENTITY_REF_CACHE_STORE: InjectionToken<EntityRefCacheStore>;
-/**
- * Consumer-provided predicate function to check whether user roles can edit system default tabs or fields.
- * Defaults to allowing edits if not provided.
- */
 /**
  * Consumer-provided predicate function to check whether user roles can edit system default tabs or fields.
  * Defaults to allowing edits if not provided.

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.2.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.2.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

@@ -13,16 +13,28 @@ export * from './lib/services/lookup-registry.service';
 export * from './lib/services/rbac.service';
 export * from './lib/services/rules-evaluation.service';
 export * from './lib/services/config-source.service';
+export * from './lib/services/validation-messages.service';
 export * from './lib/form/dynamic-form.component';
 export * from './lib/form/dynamic-record-form.component';
 export * from './lib/form/dynamic-field/dynamic-field.component';
+export * from './lib/field-types/field-component.contract';
 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';