ngx-dynamic-entity 2.4.0 → 2.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dynamic-entity",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Angular standalone UI library for rendering dynamic entity forms.",
   "//typings": "Local workspace resolution only: ng-packagr 21 writes types/ngx-dynamic-entity.d.ts into dist/package.json. Do NOT add a 'main' field here — ng-packagr does not generate one, so it would be copied verbatim and resolve wrongly in the published package.",
   "typings": "types/ngx-dynamic-entity.d.ts",
@@ -8,7 +8,7 @@
     "@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": "^2.4.0",
+    "@dynamic-entity/core": "^2.5.0",
     "rxjs": "^7.0.0"
   },
   "keywords": [

package/types/ngx-dynamic-entity.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, Type, EnvironmentProviders, WritableSignal, OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, Provider } from '@angular/core';
-import { ReferenceOption, LocalizedText, EntityFormConfig, FormRule, ImportLookups, MappingPlan, CsvDelimiter, ImportResult, TemplateSpec, SheetGrid, CommonModuleEntry, EntityReferenceLoader, LookupListSource, RecordMigration, FileUploadHandler, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, DropdownOption, LookupListValue, NestedTabConfig, RuleEvaluationResult, FieldScopeEntry, EvaluateFormRulesOptions, ImportColumn, MappingEntry, UnsupportedColumn, ImportRowError, SliderBounds } from '@dynamic-entity/core';
+import { ReferenceOption, LocalizedText, EntityFormConfig, FormRule, ImportLookups, DateOrder, MappingPlan, CsvDelimiter, ImportResult, TemplateSpec, SheetGrid, CommonModuleEntry, EntityReferenceLoader, LookupListSource, RecordMigration, FileUploadHandler, FieldValidators, NestedFieldConfig, ReferenceLoaderContext, DropdownOption, LookupListValue, NestedTabConfig, RuleEvaluationResult, FieldScopeEntry, EvaluateFormRulesOptions, ImportColumn, MappingEntry, UnsupportedColumn, ImportRowError, SliderBounds } from '@dynamic-entity/core';
 export { AutoPatchConfig, CommonModuleEntry, ComponentClass, DropdownOption, EntityFormConfig, EntityPermissions, EntityReferenceConfig, EntityReferenceLoader, FieldTableConfig, FieldValidators, FileRef, FormRule, LocalizedText, NestedFieldConfig, NestedTabConfig, PatchOnTrueMapping, RbacContext, ReferenceLoaderContext, ReferenceOption, RichFieldType, RuleAction, RuleCondition, RuleEvaluationResult, VersionedRecord, formatDisplayValue, normalizeConfig, normalizeOption, resolveLabel, resolveOptionLabel, resolveOptionValue, valuesMatch } from '@dynamic-entity/core';
 import { ValidatorFn, AsyncValidatorFn, AbstractControl, ValidationErrors, FormGroup, FormArray } from '@angular/forms';
 import * as rxjs from 'rxjs';
@@ -129,6 +129,8 @@ declare const DEFAULT_UI_TEXT: {
     importDelimiterComma: string;
     importDelimiterSemicolon: string;
     importDelimiterTab: string;
+    importDateOrderMismatch: string;
+    importDateOrderUnconfirmed: string;
     importRowRejected: string;
     importRunImport: string;
     importImporting: string;
@@ -272,6 +274,15 @@ interface ImportContext {
     /** Values for any `listName` field, already resolved — core cannot reach `LOOKUP_REGISTRY`. */
     lookups?: ImportLookups;
     lang?: string;
+    /**
+     * The order of a date written in digits, such as `05/09/2026`: `DMY` for day first, `MDY`
+     * for month first. Without it, a date that reads two ways fails its row; it is never guessed.
+     *
+     * The local transport reads cells with it. A server transport reads with whatever its own
+     * router was given, so state the same order on both, or the review step shows one reading
+     * and the server stores another.
+     */
+    dateOrder?: DateOrder;
 }
 /** What a first look at an uploaded file yields. */
 interface ImportPreview {
@@ -289,7 +300,26 @@ interface ImportPreview {
     arrayBound?: number;
     /** The field separator a delimited-text file used. Absent for a workbook. */
     delimiter?: CsvDelimiter;
+    /**
+     * The order this transport will read a date written in digits in when it commits. Absent
+     * when it will read with none, or cannot say.
+     *
+     * The wizard reads the review sample with it, so the review shows what the commit will
+     * store. When the host stated a different order the wizard refuses to commit, and when the
+     * host stated one and the transport reports none it warns.
+     */
+    dateOrder?: DateOrder;
 }
+/**
+ * How the order the host states compares with the one the transport reports it reads with.
+ *
+ * - `mismatch`: both state one and they differ. Committing would store dates read one way
+ *   after a review that showed them the other, so nothing may be committed.
+ * - `unconfirmed`: the host states one and the transport reports none. The transport reads the
+ *   file, so the host's order is not applied: worth a warning, not a refusal.
+ * - `agreed`: anything else. Only the transport stating one is fine: it is the one that reads.
+ */
+declare function compareDateOrders(stated: DateOrder | undefined, reported: DateOrder | undefined): 'agreed' | 'mismatch' | 'unconfirmed';
 /**
  * Where the work happens.
  *
@@ -2092,16 +2122,21 @@ interface HttpImportTransportOptions {
      */
     warn?: (message: string) => void;
 }
-/**
- * Not `@Injectable`, and registered by value rather than by class.
- *
- * Its constructor takes options rather than dependencies, so there is nothing for an injector
- * to resolve — and a consumer who wants two of them, pointed at two backends, gets that for
- * free.
- */
 declare class HttpImportTransport implements ImportTransport {
     private readonly options;
+    /**
+     * The date order each previewed file's server reported, for `commit` to compare against.
+     * Keyed on the `File`, so it lives exactly as long as the file does.
+     */
+    private readonly reported;
     constructor(options: HttpImportTransportOptions);
+    private warn;
+    /**
+     * The server reads the file, so its date order is the one that is applied. When the host
+     * stated one and the server confirms none, the host's order does nothing there: say so, and
+     * say what the server will do instead, which depends on how old it is.
+     */
+    private checkDateOrder;
     private get base();
     private get send();
     private entityOf;
@@ -2162,6 +2197,16 @@ declare class EntityImportComponent {
      */
     lookups?: ImportLookups;
     language: string;
+    /**
+     * The order of a date written in digits in the sheets this wizard imports: `DMY` for day
+     * first, `MDY` for month first. Without it, a date that reads two ways (`05/09/2026`) is
+     * shown, and imported, as an error rather than guessed.
+     *
+     * The transport reads the file, so the order it reports at preview is the one applied, and
+     * the one the review step shows. If that differs from this, the wizard refuses to commit;
+     * if the transport reports none, the wizard warns that this order is not being applied.
+     */
+    dateOrder?: DateOrder;
     /** Format asked of the transport when a template is downloaded. */
     templateFormat: TemplateFormat;
     /** The finished import, once it has run. */
@@ -2178,6 +2223,8 @@ declare class EntityImportComponent {
     protected readonly rowCount: i0.WritableSignal<number>;
     /** The separator a delimited file turned out to use, so the user can see how it was read. */
     protected readonly delimiter: i0.WritableSignal<CsvDelimiter>;
+    /** The date order the transport said it will read with at commit, from its preview. */
+    protected readonly reportedDateOrder: i0.WritableSignal<DateOrder>;
     protected readonly fileName: i0.WritableSignal<string>;
     protected readonly plan: i0.WritableSignal<MappingPlan>;
     protected readonly result: i0.WritableSignal<ImportResult>;
@@ -2229,13 +2276,20 @@ declare class EntityImportComponent {
      * exact and `failed` is absent.
      */
     protected failedRowCount(result: ImportResult): number;
+    /** How the order the host states compares with the one the transport reads with. */
+    protected dateOrderCheck(): 'agreed' | 'mismatch' | 'unconfirmed';
+    /** The two orders, for a message that names them. Only asked for when they do not agree. */
+    protected dateOrders(): {
+        stated: string;
+        reported: string;
+    };
     /** The decimal mark the commit will read numbers with, so the preview reads them the same. */
     protected decimal(): '.' | ',';
     /** How the file's columns were split, in words — or nothing for a workbook. */
     protected delimiterText(): string | null;
     protected restart(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<EntityImportComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<EntityImportComponent, "ngx-entity-import", never, { "config": { "alias": "config"; "required": true; }; "rules": { "alias": "rules"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "language": { "alias": "language"; "required": false; }; "templateFormat": { "alias": "templateFormat"; "required": false; }; }, { "importComplete": "importComplete"; "templateReady": "templateReady"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EntityImportComponent, "ngx-entity-import", never, { "config": { "alias": "config"; "required": true; }; "rules": { "alias": "rules"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "language": { "alias": "language"; "required": false; }; "dateOrder": { "alias": "dateOrder"; "required": false; }; "templateFormat": { "alias": "templateFormat"; "required": false; }; }, { "importComplete": "importComplete"; "templateReady": "templateReady"; }, never, never, true, never>;
 }
 
 /** One target field, and which of the sheet's columns feeds it. */
@@ -2365,13 +2419,15 @@ declare class ImportPreviewComponent implements OnChanges {
     language: string;
     /** The decimal mark number cells use — the one the commit will read them with. */
     decimal: '.' | ',';
+    /** The order of a date written in digits — the one the commit will read them in. */
+    dateOrder?: DateOrder;
     protected readonly ui: UiTextService;
     /** The columns this plan fills, in the plan's own order. */
     protected readonly columns: i0.WritableSignal<ImportColumn[]>;
     protected readonly grid: i0.WritableSignal<PreviewRow[]>;
     ngOnChanges(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ImportPreviewComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ImportPreviewComponent, "ngx-import-preview", never, { "config": { "alias": "config"; "required": true; }; "plan": { "alias": "plan"; "required": true; }; "rows": { "alias": "rows"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "language": { "alias": "language"; "required": false; }; "decimal": { "alias": "decimal"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImportPreviewComponent, "ngx-import-preview", never, { "config": { "alias": "config"; "required": true; }; "plan": { "alias": "plan"; "required": true; }; "rows": { "alias": "rows"; "required": false; }; "lookups": { "alias": "lookups"; "required": false; }; "rules": { "alias": "rules"; "required": false; }; "language": { "alias": "language"; "required": false; }; "decimal": { "alias": "decimal"; "required": false; }; "dateOrder": { "alias": "dateOrder"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /** One field offered for the template, with the guidance that belongs to it. */
@@ -3607,5 +3663,5 @@ declare class TagsFieldComponent implements OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<TagsFieldComponent, "ngx-tags-field", never, { "field": { "alias": "field"; "required": false; }; "language": { "alias": "language"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "masked": { "alias": "masked"; "required": false; }; "control": { "alias": "control"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { ASYNC_VALIDATOR_REGISTRY, ArrayFieldComponent, BooleanFieldComponent, COMMON_MODULES_REGISTRY, CONFIG_SOURCE, CascadeDataService, CheckboxFieldComponent, ColorFieldComponent, ConfigSourceService, CurrencyFieldComponent, DEFAULT_UI_TEXT, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityImportComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, HttpImportTransport, IMPORT_TRANSPORT, ImageFieldComponent, ImportErrorsComponent, ImportMapperComponent, ImportPreviewComponent, ImportTemplateComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LocalImportTransport, LookupRegistryService, MARKDOWN_RENDERER, MASKED_PLACEHOLDER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, PhoneFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RatingFieldComponent, RbacService, RulesEvaluationService, SHEET_PARSER, SYSTEM_DEFAULT_CAN_EDIT, SliderFieldComponent, TagsFieldComponent, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UI_TEXT, UPLOAD_HANDLER, UiTextService, UrlFieldComponent, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, defaultSheetParser, fieldDescribedBy, fieldDomId, nextFieldInstanceId, phoneValidator, provideBuiltInFieldTypes, provideFieldTypes, provideHttpImportTransport, provideNgxDynamicEntity, refreshChoiceOptions, resolveUiText, urlValidator };
+export { ASYNC_VALIDATOR_REGISTRY, ArrayFieldComponent, BooleanFieldComponent, COMMON_MODULES_REGISTRY, CONFIG_SOURCE, CascadeDataService, CheckboxFieldComponent, ColorFieldComponent, ConfigSourceService, CurrencyFieldComponent, DEFAULT_UI_TEXT, DEFAULT_VALIDATION_MESSAGES, DateFieldComponent, DateTimeFieldComponent, DropdownFieldComponent, DynamicFieldComponent, DynamicFormComponent, DynamicRecordFormComponent, ENTITY_REF_CACHE_STORE, ENTITY_REF_REGISTRY, EmailFieldComponent, EntityImportComponent, EntityRefFieldComponent, EntityRefRegistryService, EntityRefSelectionService, EntityReferenceService, FIELD_TYPE_REGISTRY, FIELD_TYPE_SETS, FieldRegistryService, FileFieldComponent, GroupFieldComponent, HOOK_REGISTRY, HookRegistryService, HttpImportTransport, IMPORT_TRANSPORT, ImageFieldComponent, ImportErrorsComponent, ImportMapperComponent, ImportPreviewComponent, ImportTemplateComponent, InMemoryEntityRefCacheStore, LOOKUP_REGISTRY, LocalImportTransport, LookupRegistryService, MARKDOWN_RENDERER, MASKED_PLACEHOLDER, MASKED_ROLES, MarkdownFieldComponent, MonthYearFieldComponent, MultiSelectFieldComponent, NumberFieldComponent, PasswordFieldComponent, PhoneFieldComponent, RECORD_MIGRATIONS, RadioFieldComponent, RatingFieldComponent, RbacService, RulesEvaluationService, SHEET_PARSER, SYSTEM_DEFAULT_CAN_EDIT, SliderFieldComponent, TagsFieldComponent, TextFieldComponent, TextareaFieldComponent, TimeFieldComponent, UI_TEXT, UPLOAD_HANDLER, UiTextService, UrlFieldComponent, VALIDATION_MESSAGES, VALIDATOR_REGISTRY, ValidationMessagesService, ValidatorRegistryService, builtInFieldTypes, compareDateOrders, defaultSheetParser, fieldDescribedBy, fieldDomId, nextFieldInstanceId, phoneValidator, provideBuiltInFieldTypes, provideFieldTypes, provideHttpImportTransport, provideNgxDynamicEntity, refreshChoiceOptions, resolveUiText, urlValidator };
 export type { ChoiceOptionHost, ConfigSourceHandler, DynamicFieldComponentContract, EntityRefCacheStore, EntityRefSelection, HookFn, HttpImportTransportOptions, ImportContext, ImportPreview, ImportTransport, InvalidField, MessageOrderEntry, NgxDynamicEntityConfig, RuleSyncContext, SheetParser, TemplateFormat, UiTextKey, UiTextOverrides, UiTextOverridesFor, UiTextParams, UiTextResolver, UiTextResolverFor, UiTextValue, ValidationMessage };