ngx-dynamic-entity 0.0.1

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

@@ -0,0 +1,19 @@
+import { ValidatorFn } from '@angular/forms';
+import * as i0 from "@angular/core";
+/**
+ * ValidatorRegistryService — resolves validator key strings to Angular ValidatorFns.
+ * Built-in validators: 'required', 'email', 'min:N', 'max:N', 'minLength:N', 'maxLength:N'.
+ * Consumers can register custom validators via provideNgxDynamicEntity({ validators: {...} }).
+ */
+export declare class ValidatorRegistryService {
+    private readonly consumerRegistry;
+    /**
+     * Resolve a validator key to a ValidatorFn.
+     * Supports parameterized built-ins like 'min:0', 'maxLength:255'.
+     */
+    resolve(validatorKey: string): ValidatorFn | null;
+    /** Resolve multiple validator keys into a ValidatorFn[] */
+    resolveAll(validatorKeys?: string[]): ValidatorFn[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidatorRegistryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ValidatorRegistryService>;
+}

package/lib/services/version.service.d.ts

@@ -0,0 +1,26 @@
+import type { VersionedRecord, EntityConfig } from '@dynamic-entity/core';
+import * as i0 from "@angular/core";
+/**
+ * VersionService — checks config version staleness and migration strategy.
+ * ADR-005: Frontend strategy is 'strict' | 'graceful' only. Never 'auto'.
+ */
+export declare class VersionService {
+    private readonly strategy;
+    /**
+     * Check if a record is stale compared to the current config version.
+     * Returns true if the record needs migration.
+     */
+    needsMigration(record: Partial<VersionedRecord>, config: EntityConfig): boolean;
+    /**
+     * Get the effective migration strategy for frontend use.
+     * Only 'strict' or 'graceful' — never 'auto' (ADR-005).
+     */
+    getStrategy(): 'strict' | 'graceful';
+    /**
+     * Determine if form submission should be blocked for a stale record.
+     * 'strict' → block; 'graceful' → allow with warning.
+     */
+    shouldBlockSubmit(record: Partial<VersionedRecord>, config: EntityConfig): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VersionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VersionService>;
+}

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

@@ -0,0 +1,56 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import type { EntityConfig, VersionedRecord } from '@dynamic-entity/core';
+import * as i0 from "@angular/core";
+/**
+ * DynamicTableComponent — renders entity records as a searchable, sortable, paginated table.
+ * Columns determined by FieldConfig.tableColumn === true.
+ * Cell masking applied via RbacService (defense-in-depth).
+ * Pagination, sort, and search emit events — parent controls data fetching (smart/dumb pattern).
+ */
+export declare class DynamicTableComponent implements OnChanges {
+    config: EntityConfig;
+    data: VersionedRecord[];
+    userRoles: string[];
+    language: string;
+    loading: boolean;
+    error: string | null;
+    totalRecords: number;
+    pageSize: number;
+    currentPage: number;
+    rowClick: EventEmitter<VersionedRecord>;
+    rowEdit: EventEmitter<VersionedRecord>;
+    rowDelete: EventEmitter<VersionedRecord>;
+    pageChange: EventEmitter<number>;
+    pageSizeChange: EventEmitter<number>;
+    sortChange: EventEmitter<{
+        field: string;
+        dir: 'asc' | 'desc';
+    }>;
+    searchChange: EventEmitter<string>;
+    private readonly rbacService;
+    private readonly versionService;
+    readonly sortField: import("@angular/core").WritableSignal<string>;
+    readonly sortDir: import("@angular/core").WritableSignal<"asc" | "desc">;
+    readonly searchTerm: import("@angular/core").WritableSignal<string>;
+    readonly tableColumns: import("@angular/core").Signal<import("@dynamic-entity/core").FieldConfig[]>;
+    get permissions(): {
+        canView: boolean;
+        canEdit: boolean;
+        canDelete: boolean;
+    };
+    get totalPages(): number;
+    ngOnChanges(_changes: SimpleChanges): void;
+    private columnMaskCache;
+    private _resolveColumnMasks;
+    isCellMasked(fieldId: string): boolean;
+    getCellValue(record: VersionedRecord, fieldId: string): string;
+    needsMigration(record: VersionedRecord): boolean;
+    getColumnLabel(fieldId: string): string;
+    onSort(fieldId: string): void;
+    onSearch(event: Event): void;
+    onPageChange(page: number): void;
+    onEdit(event: Event, record: VersionedRecord): void;
+    onDelete(event: Event, record: VersionedRecord): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicTableComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicTableComponent, "ngx-dynamic-table", never, { "config": { "alias": "config"; "required": false; }; "data": { "alias": "data"; "required": false; }; "userRoles": { "alias": "userRoles"; "required": false; }; "language": { "alias": "language"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "error": { "alias": "error"; "required": false; }; "totalRecords": { "alias": "totalRecords"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; }, { "rowClick": "rowClick"; "rowEdit": "rowEdit"; "rowDelete": "rowDelete"; "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; "sortChange": "sortChange"; "searchChange": "searchChange"; }, never, never, true, never>;
+}

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

@@ -0,0 +1,16 @@
+import { InjectionToken } from '@angular/core';
+import type { Type } from '@angular/core';
+/** Base URL for the dynamic-entity-server API */
+export declare const DYNAMIC_ENTITY_API_URL: InjectionToken<string>;
+/** Roles that see XXXXXXXXX for masked fields (ADR-003) */
+export declare const MASKED_ROLES: InjectionToken<string[]>;
+/** Migration strategy for the frontend — 'strict' | 'graceful' only (ADR-005, never 'auto') */
+export declare const MIGRATION_STRATEGY: InjectionToken<"strict" | "graceful">;
+/** Registry: fieldType string → Angular component class */
+export declare const FIELD_TYPE_REGISTRY: InjectionToken<Map<string, Type<any>>>;
+/** Registry: entity key → async () => options[] loader function */
+export declare const ENTITY_REF_REGISTRY: InjectionToken<Map<string, () => Promise<any[]>>>;
+/** Registry: validator key → ValidatorFn */
+export declare const VALIDATOR_REGISTRY: InjectionToken<Map<string, any>>;
+/** Registry: hook key → async (data, context) => data */
+export declare const HOOK_REGISTRY: InjectionToken<Map<string, Function>>;

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "ngx-dynamic-entity",
+  "version": "0.0.1",
+  "description": "Angular 17 standalone UI library for dynamic entity forms and tables.",
+  "peerDependencies": {
+    "@angular/common": "^17.0.0",
+    "@angular/core": "^17.0.0",
+    "@angular/forms": "^17.0.0",
+    "@dynamic-entity/core": "0.0.1",
+    "rxjs": "^7.0.0"
+  },
+  "keywords": [
+    "angular",
+    "dynamic-entity",
+    "dynamic-forms",
+    "dynamic-table",
+    "rbac"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "module": "fesm2022/ngx-dynamic-entity.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/ngx-dynamic-entity.mjs",
+      "esm": "./esm2022/ngx-dynamic-entity.mjs",
+      "default": "./fesm2022/ngx-dynamic-entity.mjs"
+    }
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  }
+}

package/public-api.d.ts

@@ -0,0 +1,21 @@
+export * from './lib/tokens/injection-tokens';
+export * from './lib/providers/provide-ngx-dynamic-entity';
+export * from './lib/services/config.service';
+export * from './lib/services/field-registry.service';
+export * from './lib/services/hook-registry.service';
+export * from './lib/services/validator-registry.service';
+export * from './lib/services/entity-ref-registry.service';
+export * from './lib/services/version.service';
+export * from './lib/services/rbac.service';
+export * from './lib/form/dynamic-form.component';
+export * from './lib/form/dynamic-field/dynamic-field.component';
+export * from './lib/table/dynamic-table.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/checkbox-field.component';
+export * from './lib/field-types/date-field.component';
+export * from './lib/field-types/dropdown-field.component';
+export * from './lib/field-types/multi-select-field.component';
+export * from './lib/field-types/entity-ref-field.component';
+export type { EntityConfig, FieldConfig, TabConfig, DropdownOption, FieldDependency, EntityHooks, VersionedRecord, EntityPermissions, RbacContext, MigrationStrategy, QueryOptions, PaginatedResult, } from '@dynamic-entity/core';