ngx-dynamic-entity 1.3.0 → 1.5.0

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

@@ -1,27 +0,0 @@
-import type { EntityFormConfig, NestedFieldConfig, NestedTabConfig } from '@dynamic-entity/core';
-import * as i0 from "@angular/core";
-/**
- * RbacService — ALL permission checks and masking logic live here.
- */
-export declare class RbacService {
-    private readonly maskedRoles;
-    /**
-     * Check if any of the user's roles satisfy the required roles.
-     * hasPermission(roles, undefined) → true (no restriction).
-     */
-    hasPermission(userRoles: string[], requiredRoles?: string[]): boolean;
-    /** 3-level OR resolution */
-    resolveEffectiveMask(formMask?: boolean, tabMask?: boolean, fieldMask?: boolean): boolean;
-    /** Check if the user's roles include any masked role */
-    isUserMaskedRole(userRoles: string[]): boolean;
-    /** Determine if a specific field should be masked for this user */
-    shouldMaskField(field: NestedFieldConfig, tab: NestedTabConfig | undefined, config: EntityFormConfig, userRoles: string[]): boolean;
-    /** Get view/edit/delete permissions for a config */
-    getPermissions(config: EntityFormConfig, userRoles: string[]): {
-        canView: boolean;
-        canEdit: boolean;
-        canDelete: boolean;
-    };
-    static ɵfac: i0.ɵɵFactoryDeclaration<RbacService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<RbacService>;
-}

package/lib/services/rules-evaluation.service.d.ts

@@ -1,17 +0,0 @@
-import type { EntityFormConfig, FormRule, RuleEvaluationResult } from '@dynamic-entity/core';
-import * as i0 from "@angular/core";
-/**
- * RulesEvaluationService — evaluates dynamic form rules against active reactive form state.
- */
-export declare class RulesEvaluationService {
-    /**
-     * Evaluate rules against form values and optional original baseline values.
-     */
-    evaluate(rules: FormRule[] | undefined | null, values: Record<string, unknown>, originalValues?: Record<string, unknown>): RuleEvaluationResult;
-    /**
-     * Filter rules pertinent to a single tab.
-     */
-    filterForTab(rules: FormRule[] | undefined | null, tabId: string, config: EntityFormConfig): FormRule[];
-    static ɵfac: i0.ɵɵFactoryDeclaration<RulesEvaluationService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<RulesEvaluationService>;
-}

package/lib/services/validation-messages.service.d.ts

@@ -1,43 +0,0 @@
-import type { ValidationErrors } from '@angular/forms';
-import * as i0 from "@angular/core";
-/**
- * Resolves an Angular `ValidationErrors` object to the message shown under a field.
- *
- * These strings used to be hardcoded English literals inside each field component, so a
- * German form meant re-implementing every field type — the labels honoured `language` while
- * the errors underneath them did not.
- *
- * A message is a plain string, or a function when it needs the error's own detail
- * (`minlength.requiredLength`, `min.min`, and so on). The active `language` is passed
- * through, so one registration can serve every locale:
- *
- * ```typescript
- * provideNgxDynamicEntity({
- *   validationMessages: {
- *     required: lang => (lang === 'de' ? 'Pflichtfeld.' : 'This field is required.'),
- *     minlength: (lang, err) => `Mindestens ${err['requiredLength']} Zeichen.`,
- *   },
- * });
- * ```
- *
- * Unregistered keys fall back to the defaults below, so overriding one message does not
- * mean supplying them all.
- */
-export type ValidationMessage = string | ((language: string, error: any) => string);
-/** The built-in English messages. Every key here can be overridden individually. */
-export declare const DEFAULT_VALIDATION_MESSAGES: Record<string, ValidationMessage>;
-export declare class ValidationMessagesService {
-    private readonly overrides;
-    /**
-     * The message for the first error present, in the order the caller lists.
-     *
-     * Order is the caller's because it is field-specific: a dropdown wants
-     * `requiredSelection` where a text input wants `required`, and the first match wins so the
-     * most specific message is the one shown.
-     */
-    resolve(errors: ValidationErrors | null | undefined, language: string, order: readonly (string | readonly [errorKey: string, messageKey: string])[], fallbackKey?: string): string;
-    /** One message by key, honouring an override before the default. */
-    messageFor(key: string, language: string, error: unknown): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ValidationMessagesService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<ValidationMessagesService>;
-}

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

@@ -1,32 +0,0 @@
-import { AsyncValidatorFn, ValidatorFn } from '@angular/forms';
-import type { FieldValidators } from '@dynamic-entity/core';
-import * as i0 from "@angular/core";
-/**
- * ValidatorRegistryService — resolves validator configs / key strings to Angular ValidatorFns.
- */
-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'.
-     */
-    resolve(validatorKey: string): ValidatorFn | null;
-    /** Resolve multiple validator keys into a ValidatorFn[] */
-    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,134 +0,0 @@
-import { InjectionToken } from '@angular/core';
-import type { Type } from '@angular/core';
-import { type EntityRefCacheStore } from '../services/entity-ref-cache';
-/** 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.
- * Highest priority — beats anything registered through `provideFieldTypes()`.
- */
-export declare const FIELD_TYPE_REGISTRY: InjectionToken<Map<string, Type<any>>>;
-/**
- * Multi-provider of field-type sets, contributed by `provideFieldTypes()` /
- * `provideBuiltInFieldTypes()`. Multi so several calls compose instead of clobbering;
- * later sets win on key collision. This is the seam that keeps unused field components
- * out of the bundle — nothing is imported until a set names it.
- */
-export declare const FIELD_TYPE_SETS: InjectionToken<Record<string, Type<any>>[]>;
-/**
- * Registry: entity key → option loader.
- *
- * A loader receives a `ReferenceLoaderContext` (`parentValue`, `filters`, `lang`) and may
- * return an array, a Promise, or an Observable of `ReferenceOption[]`. `ctx` is optional,
- * so a zero-arg loader (`() => svc.list()`) is still a valid registration.
- */
-export declare const ENTITY_REF_REGISTRY: InjectionToken<Map<string, EntityReferenceLoader>>;
-/**
- * Registry: list name → the values of a named master list (`field.listName`).
- *
- * A source may be the values themselves (array / Promise / Observable) or a **loader function**,
- * which is what you want for anything fetched: a bare Promise is created when the provider is
- * built, so every list would load whether or not a form uses it.
- *
- * Values are normalised by `normalizeLookupValues` — bare strings and `LocalizedText` are
- * accepted alongside the full `{ code, name, sortOrder }` shape.
- *
- * @example
- * provideNgxDynamicEntity({
- *   lookups: {
- *     employeeStatus: () => listService.getByName('employeeStatus'),
- *     grades: ['Junior', 'Senior'],
- *   },
- * })
- */
-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, HookFn>>;
-/**
- * Consumer-registered list of common module tabs (documents, audit, tasks, etc.).
- * The library ships no built-in implementations. Consumers provide their own list
- * so the builder's module-picker and the renderer's tab switcher know what's available.
- *
- * @example
- * providers: [
- *   {
- *     provide: COMMON_MODULES_REGISTRY,
- *     useValue: [
- *       { id: 'documents', label: { en: 'Documents' }, component: 'app-documents-view' },
- *       { id: 'audit',     label: { en: 'Audit Log'  }, component: 'app-audit' },
- *     ] satisfies CommonModuleEntry[]
- *   }
- * ]
- */
-export declare const COMMON_MODULES_REGISTRY: InjectionToken<CommonModuleEntry[]>;
-/**
- * Consumer-provided file/image upload handler.
- * When supplied, image-field and file-field call it to persist the File and receive a stable
- * URL back. Without it the field stores `{ file, name, size, mimeType }` for the consumer to
- * upload on submit. May return the result directly, as a Promise, or as an Observable.
- *
- * @example
- * { provide: UPLOAD_HANDLER, useFactory: () => (file: File) => myUploadService.upload(file) }
- */
-export declare const UPLOAD_HANDLER: InjectionToken<FileUploadHandler>;
-/**
- * Backing store for the entity-reference options cache. Defaults to in-memory.
- * Provide your own to make the cache outlive a page refresh.
- *
- * @example
- * { 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.
- */
-export declare const SYSTEM_DEFAULT_CAN_EDIT: InjectionToken<(roles: string[]) => boolean>;
-export type ConfigSourceHandler = (entityKey: string) => any;
-/**
- * Registry/Resolver for resolving an EntityFormConfig by entity key across entities (Phase 8).
- * Enables cross-entity field referencing (`isReferenced`, `referencedEntityKey`, `referencedFieldId`, `hasDrift`).
- */
-export declare const CONFIG_SOURCE: InjectionToken<ConfigSourceHandler>;

package/public-api.d.ts

@@ -1,42 +0,0 @@
-export * from './lib/tokens/injection-tokens';
-export * from './lib/providers/provide-ngx-dynamic-entity';
-export * from './lib/providers/provide-field-types';
-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/entity-ref-selection.service';
-export * from './lib/services/cascade-data.service';
-export * from './lib/services/entity-reference.service';
-export * from './lib/services/entity-ref-cache';
-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/date-time-field.component';
-export * from './lib/field-types/time-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';