ngx-dynamic-entity 2.4.1 → 3.0.0-rc.1

package/README.md

@@ -258,6 +258,7 @@ rendering decision, not an access-control boundary.
 | `rules` | Pass the same rules the form uses, or a rule-hidden required field rejects rows the form would save. |
 | `lookups` | Option lists already resolved, merged over what `LOOKUP_REGISTRY` provides. |
 | `language` | Default `'en'`. |
+| `dateOrder` | `'DMY'` or `'MDY'`: the order of a date written in digits, such as `05/09/2026`. Without it, a date that reads two ways is an error, never a guess. With a server transport the server's order is the one applied: state it on the router, and the wizard reads its review with what the server reports. If you state one here too and it differs, the wizard refuses to commit. |
 | `templateFormat` | `'csv'` (default) or `'xlsx'`. `xlsx` needs a server transport. |
 
 | Output | Payload |

package/fesm2022/ngx-dynamic-entity.mjs

@@ -2,7 +2,7 @@ import * as i0 from '@angular/core';
 import { InjectionToken, makeEnvironmentProviders, inject, Injectable, signal, Input, ChangeDetectionStrategy, Component, ChangeDetectorRef, DestroyRef, Injector, isDevMode, ViewContainerRef, ViewChild, forwardRef, Optional, Inject, EventEmitter, ElementRef, computed, afterNextRender, HostListener, ViewChildren, Output } from '@angular/core';
 import * as i1 from '@angular/forms';
 import { ReactiveFormsModule, Validators, FormBuilder, FormGroup, FormArray, FormsModule } from '@angular/forms';
-import { resolveLabel, formatDisplayValue, normalizeLookupValues, lookupValuesToOptions, valuesMatch, resolveOptionLabel, resolveOptionValue, buildReferenceCacheKey, normalizeReferenceOptions, entityKeyFromCacheKey, applyCascadeFilter, resolveEffectiveMask, shouldMaskField, findTab, isValidUrl, isValidPhone, fileRefName, sliderBounds, ratingScale, normalizeHexColor, normalizeTags, evaluateFormRules, filterRulesForTab, evaluateFieldVisibility, fieldsUnderTab, getTabPath, fieldRefFor, flattenFieldValues, parseFieldRef, placeTabFields, normalizeArrayStructures, getTabData, getValueByPath, normalizeConfigOptions, migrateRecord, ambiguousFieldIds, toRefToken, collectFieldScopes, applyAutoPatch, refOf, isUnsafePath, valuesEqual, parseCsv, arrayBoundFor, deriveImportColumns, suggestMapping, cellText, applyMapping, decimalMarkFor, toCsv, stripIndices, CORE_VERSION, DEFAULT_ARRAY_ROWS, upgradeLegacyRefs, coerceCell, buildTemplateSpec, collectLeafTargets, formatConfigProblems } from '@dynamic-entity/core';
+import { resolveLabel, formatDisplayValue, normalizeLookupValues, lookupValuesToOptions, valuesMatch, resolveOptionLabel, resolveOptionValue, buildReferenceCacheKey, normalizeReferenceOptions, entityKeyFromCacheKey, applyCascadeFilter, resolveEffectiveMask, shouldMaskField, findTab, isValidUrl, isValidPhone, fileRefName, sliderBounds, ratingScale, normalizeHexColor, normalizeTags, evaluateFormRules, filterRulesForTab, evaluateFieldVisibility, fieldsUnderTab, getTabPath, fieldRefFor, flattenFieldValues, parseFieldRef, placeTabFields, normalizeArrayStructures, getTabData, getValueByPath, normalizeConfigOptions, migrateRecord, ambiguousFieldIds, toRefToken, collectFieldScopes, applyAutoPatch, refOf, isUnsafePath, valuesEqual, parseCsv, arrayBoundFor, deriveImportColumns, suggestMapping, cellText, applyMapping, decimalMarkFor, toCsv, stripIndices, CORE_VERSION, DEFAULT_ARRAY_ROWS, planForServer, upgradeLegacyRefs, coerceCell, buildTemplateSpec, collectLeafTargets, formatConfigProblems } from '@dynamic-entity/core';
 export { formatDisplayValue, normalizeConfig, normalizeOption, resolveLabel, resolveOptionLabel, resolveOptionValue, valuesMatch } from '@dynamic-entity/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import { Subject, isObservable, firstValueFrom } from 'rxjs';
@@ -930,6 +930,8 @@ const DEFAULT_UI_TEXT = {
     importDelimiterComma: 'Columns are separated by commas.',
     importDelimiterSemicolon: 'Columns are separated by semicolons, and numbers use a decimal comma.',
     importDelimiterTab: 'Columns are separated by tabs.',
+    importDateOrderMismatch: 'This page reads dates as {stated} but the import reads them as {reported}. Nothing can be imported until both use the same date order.',
+    importDateOrderUnconfirmed: 'The import did not confirm the date order {stated}, so it is not applied. A date such as 05/09/2026 is refused, or read month first by a server older than 2.5.0.',
     importRowRejected: 'This row will not be imported: {reason}',
     importRunImport: 'Import {count} row(s)',
     importImporting: 'Importing…',
@@ -10086,6 +10088,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImpo
  * on a server because their files have fifty thousand rows. Collapsing them into one option
  * would make each answer imply the other.
  */
+/**
+ * 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.
+ */
+function compareDateOrders(stated, reported) {
+    if (!stated || stated === reported)
+        return 'agreed';
+    return reported ? 'mismatch' : 'unconfirmed';
+}
 
 /**
  * sheet-parser.ts — the built-in CSV reader, and the reason it is the only one.
@@ -10162,6 +10178,10 @@ class LocalImportTransport {
         pending.catch(() => this.parsed.delete(file));
         return pending;
     }
+    /**
+     * The suggestion made here is always plan v2, and the return type says so. The contract's is
+     * a plan in either shape, because a 2.x server sends the older one.
+     */
     async preview(file, context) {
         const sheet = await this.read(file);
         // Sized from the headers exactly as the server sizes them, so both offer the same slots.
@@ -10176,6 +10196,8 @@ class LocalImportTransport {
             suggestion: suggestMapping(sheet.headers, columns, context.config?.entity ?? ''),
             arrayBound,
             ...(sheet.delimiter ? { delimiter: sheet.delimiter } : {}),
+            // What `commit` below will read with, so the review step reads its sample the same way.
+            ...(context.dateOrder ? { dateOrder: context.dateOrder } : {}),
         };
     }
     async commit(file, plan, context) {
@@ -10186,6 +10208,8 @@ class LocalImportTransport {
             lookups: context.lookups,
             // A `;` file means `1,5` is one and a half — the same call the server makes.
             decimal: decimalMarkFor(sheet.delimiter),
+            // Stated by the host, never inferred: a date that reads two ways fails without it.
+            dateOrder: context.dateOrder,
         });
     }
     async template(spec, format) {
@@ -10294,11 +10318,52 @@ function selectionOf(spec, context, fields) {
  * to resolve — and a consumer who wants two of them, pointed at two backends, gets that for
  * free.
  */
+/** What a Dynamic Entity server calls its adapter in the `adapter` stamp on every answer. */
+const ADAPTER_NAME = 'dynamic-entity';
+/** The first release whose server says which date order it reads with, and refuses to guess one. */
+const DATE_ORDER_SINCE = [2, 5];
+/** Whether an engine version is from before the server stopped reading dates month first. */
+function readsMonthFirst(version) {
+    if (!version)
+        return true;
+    const [major, minor] = version.split('.').map(Number);
+    return major < DATE_ORDER_SINCE[0] || (major === DATE_ORDER_SINCE[0] && minor < DATE_ORDER_SINCE[1]);
+}
 class HttpImportTransport {
     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.
+     */
+    reported = new WeakMap();
+    /**
+     * The plan versions each previewed file's server said it reads. A file with no entry was
+     * never previewed here, and one whose server said nothing is from before plan v2: either
+     * way `commit` sends nothing that only a v2 reader would understand.
+     */
+    planVersions = new WeakMap();
     constructor(options) {
         this.options = options;
     }
+    warn(message) {
+        (this.options.warn ?? ((text) => console.warn(text)))(message);
+    }
+    /**
+     * 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.
+     */
+    checkDateOrder(stated, reported, version) {
+        if (compareDateOrders(stated, reported) !== 'unconfirmed')
+            return;
+        this.warn(`[ngx-dynamic-entity] This app states the date order ${stated}, but the import server did not confirm one, ` +
+            (readsMonthFirst(version)
+                ? `and runs @dynamic-entity/core ${version ?? '(unreported)'}, from before 2.5.0. A server that old reads a ` +
+                    'date such as 05/09/2026 month first, whatever this app states. Upgrade the server and state ' +
+                    'the same dateOrder on its router.'
+                : 'so it will refuse a date such as 05/09/2026 that could be day first or month first. ' +
+                    'State the same dateOrder on its router.'));
+    }
     get base() {
         return trimSlash(this.options.baseUrl);
     }
@@ -10325,11 +10390,26 @@ class HttpImportTransport {
         // scroll past the warning that does matter.
         if (!version || sameLine(version, CORE_VERSION))
             return;
-        const warn = this.options.warn ?? ((message) => console.warn(message));
-        warn(`[ngx-dynamic-entity] The import server runs @dynamic-entity/core ${version}; this app ` +
+        this.warn(`[ngx-dynamic-entity] The import server runs @dynamic-entity/core ${version}; this app ` +
             `was built against ${CORE_VERSION}. The two halves of an import are supposed to be the ` +
             'same engine — bring them into step before trusting a difference in what they produce.');
     }
+    /**
+     * Warn when the server runs another adapter, or this one at another major version.
+     *
+     * Since 3.0 a server says which adapter turned its rows into records. A server from before
+     * that says nothing, and `checkEngine` has already compared the one version it does report.
+     */
+    checkAdapter(adapter) {
+        if (!adapter)
+            return;
+        const major = (version) => String(version ?? '').split('.')[0];
+        if (adapter.name === ADAPTER_NAME && major(adapter.version) === major(CORE_VERSION))
+            return;
+        this.warn(`[ngx-dynamic-entity] The import server reads rows with the adapter ${adapter.name} ${adapter.version}; ` +
+            `this app expects ${ADAPTER_NAME} ${major(CORE_VERSION)}.x. What the server imports may differ from ` +
+            'what the review step showed. Bring the two into step.');
+    }
     async preview(file, context) {
         const body = new FormData();
         body.append('file', file, file.name || 'upload');
@@ -10342,6 +10422,10 @@ class HttpImportTransport {
             throw await failureOf(response);
         const preview = (await response.json());
         this.checkEngine(preview.engineVersion);
+        this.checkAdapter(preview.adapter);
+        this.planVersions.set(file, Array.isArray(preview.planVersions) ? preview.planVersions : undefined);
+        this.reported.set(file, preview.dateOrder);
+        this.checkDateOrder(context?.dateOrder, preview.dateOrder, preview.engineVersion);
         return {
             headers: preview.headers ?? [],
             sample: preview.sample ?? [],
@@ -10350,14 +10434,32 @@ class HttpImportTransport {
             // A server older than 2.3 does not say, and always sized for the default.
             arrayBound: preview.arrayBound ?? DEFAULT_ARRAY_ROWS,
             ...(preview.delimiter ? { delimiter: preview.delimiter } : {}),
+            ...(preview.dateOrder ? { dateOrder: preview.dateOrder } : {}),
         };
     }
     async commit(file, plan, context) {
+        // Before a byte is sent. The review this user approved read dates one way and the server
+        // would store them another, and a streaming import cannot be taken back.
+        const reported = this.reported.get(file);
+        if (compareDateOrders(context?.dateOrder, reported) === 'mismatch') {
+            throw new Error(`This app reads dates as ${context.dateOrder} but the import server reads them as ${reported}. ` +
+                'Nothing was imported. Set the same dateOrder on the wizard and on the server\'s router.');
+        }
+        // Also before a byte is sent. A server from before plan v2 ignores what it does not know,
+        // so a plan that groups rows would import one record per row there and report success.
+        const sendable = planForServer(plan, this.planVersions.get(file));
+        if (sendable.refused) {
+            throw new Error(`This mapping uses ${sendable.refused.join(', ')}, which the import server does not read: it is from ` +
+                'before mapping plan v2 and would ignore it. Nothing was imported. Upgrade the server to ' +
+                '@dynamic-entity/server 3.0 or later.');
+        }
         const body = new FormData();
         // **The plan first, and the file second.** The server starts importing while the file is
         // still arriving — that is the whole reason it exists — so the plan has to have arrived
         // already. `FormData` preserves append order, so this ordering is the contract.
-        body.append('plan', JSON.stringify(plan));
+        // As written for a server that reads plan v2, and in 2.x form (`entity`, `configVersion`)
+        // for one that does not: the same mapping, in the words that server knows.
+        body.append('plan', JSON.stringify(sendable.plan));
         body.append('file', file, file.name || 'upload');
         const response = await this.send(`${this.base}/${this.entityOf(context)}/import`, {
             method: 'POST',
@@ -10368,6 +10470,7 @@ class HttpImportTransport {
             throw await failureOf(response);
         const result = (await response.json());
         this.checkEngine(result.engineVersion);
+        this.checkAdapter(result.adapter);
         return {
             // Empty, and not because nothing was imported. The server streamed the file precisely so
             // that fifty thousand records never had to exist at once; sending them back would undo
@@ -10381,6 +10484,8 @@ class HttpImportTransport {
             errorCount: result.errorCount ?? result.errors?.length ?? 0,
             truncated: result.truncated ?? false,
             planProblems: result.planProblems ?? [],
+            // Only a 3.0 server sends them, and only a run with something to warn about has any.
+            ...(result.warnings?.length ? { warnings: result.warnings } : {}),
         };
     }
     async template(spec, format, context, fields) {
@@ -10525,10 +10630,10 @@ const CONSTANT = -1;
 class ImportMapperComponent {
     config;
     headers = [];
-    /** The starting point, normally `suggestMapping`'s output. */
+    /** The starting point, normally `suggestMapping`'s output. A stored 2.x plan is taken too. */
     plan = null;
     language = 'en';
-    /** Emitted whenever the user changes a selection. */
+    /** Emitted whenever the user changes a selection. Always plan v2, whichever shape came in. */
     planChange = new EventEmitter();
     ui = inject(UiTextService);
     rows = signal([], ...(ngDevMode ? [{ debugName: "rows" }] : /* istanbul ignore next */ []));
@@ -10641,6 +10746,10 @@ class ImportMapperComponent {
      * Every entry of the incoming plan survives in its own position — a fixed value, a ref the
      * config no longer has — unless the user changed or removed it, and an untouched entry is
      * emitted exactly as it arrived. New selections follow, in field order.
+     *
+     * What is emitted is plan v2, whichever shape came in: `target` and `schemaVersion`, where a
+     * 2.x plan said `entity` and `configVersion`. Anything else the incoming plan carried, such
+     * as its lists and its grouping, is kept.
      */
     toPlan() {
         const rowByRef = new Map(this.rows().map(row => [row.column.ref, row]));
@@ -10678,10 +10787,13 @@ class ImportMapperComponent {
             if (entry)
                 entries.push(entry);
         }
+        // The 2.x names go: a plan carrying both is one the reader has to warn about.
+        const kept = Object.fromEntries(Object.entries(this.incoming ?? {}).filter(([key]) => key !== 'entity' && key !== 'configVersion'));
         return {
-            ...this.incoming,
-            entity: this.config?.entity ?? '',
-            configVersion: this.config?.version,
+            ...kept,
+            planVersion: 2,
+            target: this.config?.entity ?? '',
+            schemaVersion: this.config?.version,
             sourceHeaders: [...this.headers],
             entries,
         };
@@ -10938,6 +11050,8 @@ class ImportPreviewComponent {
     language = 'en';
     /** 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;
     ui = inject(UiTextService);
     /** The columns this plan fills, in the plan's own order. */
     columns = signal([], ...(ngDevMode ? [{ debugName: "columns" }] : /* istanbul ignore next */ []));
@@ -10961,6 +11075,7 @@ class ImportPreviewComponent {
             lookups: this.lookups,
             rules: this.rules,
             decimal: this.decimal,
+            dateOrder: this.dateOrder,
             stamp: false,
             firstRowNumber: 0,
         });
@@ -10977,6 +11092,8 @@ class ImportPreviewComponent {
                     lang: this.language,
                     lookups: this.lookups,
                     decimal: this.decimal,
+                    // The column's own order when its plan entry states one, as the commit reads it.
+                    dateOrder: entry.dateOrder ?? this.dateOrder,
                 });
                 if ('error' in outcome)
                     return { text: outcome.error, failed: true };
@@ -10988,7 +11105,7 @@ class ImportPreviewComponent {
         })));
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: ImportPreviewComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.25", type: ImportPreviewComponent, isStandalone: true, selector: "ngx-import-preview", inputs: { config: "config", plan: "plan", rows: "rows", lookups: "lookups", rules: "rules", language: "language", decimal: "decimal" }, usesOnChanges: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.25", type: ImportPreviewComponent, isStandalone: true, selector: "ngx-import-preview", inputs: { config: "config", plan: "plan", rows: "rows", lookups: "lookups", rules: "rules", language: "language", decimal: "decimal", dateOrder: "dateOrder" }, usesOnChanges: true, ngImport: i0, template: `
     <section class="ngx-import-preview" data-testid="import-preview">
       <h4 class="ngx-import-preview__heading">
         {{ ui.text('importPreviewHeading', language, { count: rows.length }) }}
@@ -11081,6 +11198,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImpo
                 type: Input
             }], decimal: [{
                 type: Input
+            }], dateOrder: [{
+                type: Input
             }] } });
 
 /**
@@ -11283,6 +11402,16 @@ class EntityImportComponent {
      */
     lookups;
     language = 'en';
+    /**
+     * 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;
     /** Format asked of the transport when a template is downloaded. */
     templateFormat = 'csv';
     /** The finished import, once it has run. */
@@ -11299,6 +11428,8 @@ class EntityImportComponent {
     rowCount = signal(0, ...(ngDevMode ? [{ debugName: "rowCount" }] : /* istanbul ignore next */ []));
     /** The separator a delimited file turned out to use, so the user can see how it was read. */
     delimiter = signal(undefined, ...(ngDevMode ? [{ debugName: "delimiter" }] : /* istanbul ignore next */ []));
+    /** The date order the transport said it will read with at commit, from its preview. */
+    reportedDateOrder = signal(undefined, ...(ngDevMode ? [{ debugName: "reportedDateOrder" }] : /* istanbul ignore next */ []));
     fileName = signal('', ...(ngDevMode ? [{ debugName: "fileName" }] : /* istanbul ignore next */ []));
     plan = signal(null, ...(ngDevMode ? [{ debugName: "plan" }] : /* istanbul ignore next */ []));
     result = signal(null, ...(ngDevMode ? [{ debugName: "result" }] : /* istanbul ignore next */ []));
@@ -11317,6 +11448,7 @@ class EntityImportComponent {
             rules: this.rules,
             lookups: this.resolvedLookups(),
             lang: this.language,
+            dateOrder: this.dateOrder,
         };
     }
     /**
@@ -11384,6 +11516,7 @@ class EntityImportComponent {
             this.sample.set(preview.sample);
             this.rowCount.set(preview.rowCount);
             this.delimiter.set(preview.delimiter);
+            this.reportedDateOrder.set(preview.dateOrder);
             this.plan.set(preview.suggestion);
             this.step.set('map');
         }
@@ -11402,6 +11535,12 @@ class EntityImportComponent {
             this.problem.set(this.ui.text('importNeedFile', this.language));
             return;
         }
+        // Never on a mismatch: the review showed dates read one way and the commit would store
+        // them read another. The button is disabled too; this is for whatever calls it anyway.
+        if (this.dateOrderCheck() === 'mismatch') {
+            this.problem.set(this.ui.text('importDateOrderMismatch', this.language, this.dateOrders()));
+            return;
+        }
         this.busy.set(true);
         this.problem.set(null);
         try {
@@ -11467,6 +11606,14 @@ class EntityImportComponent {
     failedRowCount(result) {
         return result.failed ?? new Set(result.errors.map(error => error.row)).size;
     }
+    /** How the order the host states compares with the one the transport reads with. */
+    dateOrderCheck() {
+        return compareDateOrders(this.dateOrder, this.reportedDateOrder());
+    }
+    /** The two orders, for a message that names them. Only asked for when they do not agree. */
+    dateOrders() {
+        return { stated: String(this.dateOrder), reported: String(this.reportedDateOrder()) };
+    }
     /** The decimal mark the commit will read numbers with, so the preview reads them the same. */
     decimal() {
         return decimalMarkFor(this.delimiter());
@@ -11497,7 +11644,7 @@ class EntityImportComponent {
         this.step.set('upload');
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: EntityImportComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.25", type: EntityImportComponent, isStandalone: true, selector: "ngx-entity-import", inputs: { config: "config", rules: "rules", lookups: "lookups", language: "language", templateFormat: "templateFormat" }, outputs: { importComplete: "importComplete", templateReady: "templateReady" }, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.25", type: EntityImportComponent, isStandalone: true, selector: "ngx-entity-import", inputs: { config: "config", rules: "rules", lookups: "lookups", language: "language", dateOrder: "dateOrder", templateFormat: "templateFormat" }, outputs: { importComplete: "importComplete", templateReady: "templateReady" }, ngImport: i0, template: `
     <div class="ngx-import" data-testid="entity-import">
       <ol class="ngx-import__steps" data-testid="import-steps">
         @for (name of steps; track name) {
@@ -11556,6 +11703,18 @@ class EntityImportComponent {
           @if (delimiterText(); as separator) {
             <p class="ngx-entity-import__delimiter" data-testid="import-delimiter">{{ separator }}</p>
           }
+          @switch (dateOrderCheck()) {
+            @case ('mismatch') {
+              <p class="ngx-entity-import__problem" role="alert" data-testid="import-date-order-mismatch">
+                {{ ui.text('importDateOrderMismatch', language, dateOrders()) }}
+              </p>
+            }
+            @case ('unconfirmed') {
+              <p class="ngx-entity-import__delimiter" data-testid="import-date-order-unconfirmed">
+                {{ ui.text('importDateOrderUnconfirmed', language, dateOrders()) }}
+              </p>
+            }
+          }
           @if (plan(); as current) {
             <ngx-import-preview
               [config]="config"
@@ -11565,12 +11724,13 @@ class EntityImportComponent {
               [rules]="rules"
               [language]="language"
               [decimal]="decimal()"
+              [dateOrder]="reportedDateOrder()"
             />
           }
           <button
             type="button"
             data-testid="import-commit"
-            [disabled]="busy()"
+            [disabled]="busy() || dateOrderCheck() === 'mismatch'"
             (click)="commit()"
           >
             {{
@@ -11617,7 +11777,7 @@ class EntityImportComponent {
         }
       }
     </div>
-  `, isInline: true, styles: [".ngx-import{display:flex;flex-direction:column;gap:var(--ngx-gap, 16px);color:var(--ngx-color-text, #1f2937);font-size:var(--ngx-font-size, 14px)}.ngx-import__steps{display:flex;flex-wrap:wrap;gap:8px;list-style:none;margin:0;padding:0}.ngx-import__step{padding:4px 12px;border:1px solid var(--ngx-color-border, #e5e7eb);border-radius:var(--ngx-radius-sm, 6px);color:var(--ngx-color-muted, #6b7280);background:var(--ngx-color-surface-alt, #f9fafb)}.ngx-import__step--current{color:var(--ngx-color-accent, #4f46e5);border-color:var(--ngx-color-accent, #4f46e5);background:var(--ngx-color-accent-soft, #e0e7ff);font-weight:600}.ngx-import__problem{margin:0;padding:10px 12px;border:1px solid var(--ngx-color-border, #fecaca);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-error-soft, #fef2f2);color:var(--ngx-color-error, #b91c1c);overflow-wrap:anywhere}.ngx-import__file{display:flex;flex-direction:column;gap:6px;padding:14px;border:1px dashed var(--ngx-color-border, #d1d5db);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-surface, #ffffff)}.ngx-import button{align-self:flex-start;padding:8px 16px;border:1px solid var(--ngx-color-border, #d1d5db);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-surface, #ffffff);color:inherit;font:inherit;cursor:pointer}.ngx-import button:hover:not(:disabled){border-color:var(--ngx-color-accent, #4f46e5);background:var(--ngx-color-accent-soft, #e0e7ff)}.ngx-import button:disabled{opacity:.55;cursor:not-allowed}\n"], dependencies: [{ kind: "component", type: ImportTemplateComponent, selector: "ngx-import-template", inputs: ["config", "language"], outputs: ["download"] }, { kind: "component", type: ImportMapperComponent, selector: "ngx-import-mapper", inputs: ["config", "headers", "plan", "language"], outputs: ["planChange"] }, { kind: "component", type: ImportPreviewComponent, selector: "ngx-import-preview", inputs: ["config", "plan", "rows", "lookups", "rules", "language", "decimal"] }, { kind: "component", type: ImportErrorsComponent, selector: "ngx-import-errors", inputs: ["errors", "language"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+  `, isInline: true, styles: [".ngx-import{display:flex;flex-direction:column;gap:var(--ngx-gap, 16px);color:var(--ngx-color-text, #1f2937);font-size:var(--ngx-font-size, 14px)}.ngx-import__steps{display:flex;flex-wrap:wrap;gap:8px;list-style:none;margin:0;padding:0}.ngx-import__step{padding:4px 12px;border:1px solid var(--ngx-color-border, #e5e7eb);border-radius:var(--ngx-radius-sm, 6px);color:var(--ngx-color-muted, #6b7280);background:var(--ngx-color-surface-alt, #f9fafb)}.ngx-import__step--current{color:var(--ngx-color-accent, #4f46e5);border-color:var(--ngx-color-accent, #4f46e5);background:var(--ngx-color-accent-soft, #e0e7ff);font-weight:600}.ngx-import__problem{margin:0;padding:10px 12px;border:1px solid var(--ngx-color-border, #fecaca);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-error-soft, #fef2f2);color:var(--ngx-color-error, #b91c1c);overflow-wrap:anywhere}.ngx-import__file{display:flex;flex-direction:column;gap:6px;padding:14px;border:1px dashed var(--ngx-color-border, #d1d5db);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-surface, #ffffff)}.ngx-import button{align-self:flex-start;padding:8px 16px;border:1px solid var(--ngx-color-border, #d1d5db);border-radius:var(--ngx-radius-sm, 6px);background:var(--ngx-color-surface, #ffffff);color:inherit;font:inherit;cursor:pointer}.ngx-import button:hover:not(:disabled){border-color:var(--ngx-color-accent, #4f46e5);background:var(--ngx-color-accent-soft, #e0e7ff)}.ngx-import button:disabled{opacity:.55;cursor:not-allowed}\n"], dependencies: [{ kind: "component", type: ImportTemplateComponent, selector: "ngx-import-template", inputs: ["config", "language"], outputs: ["download"] }, { kind: "component", type: ImportMapperComponent, selector: "ngx-import-mapper", inputs: ["config", "headers", "plan", "language"], outputs: ["planChange"] }, { kind: "component", type: ImportPreviewComponent, selector: "ngx-import-preview", inputs: ["config", "plan", "rows", "lookups", "rules", "language", "decimal", "dateOrder"] }, { kind: "component", type: ImportErrorsComponent, selector: "ngx-import-errors", inputs: ["errors", "language"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImport: i0, type: EntityImportComponent, decorators: [{
             type: Component,
@@ -11685,6 +11845,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImpo
           @if (delimiterText(); as separator) {
             <p class="ngx-entity-import__delimiter" data-testid="import-delimiter">{{ separator }}</p>
           }
+          @switch (dateOrderCheck()) {
+            @case ('mismatch') {
+              <p class="ngx-entity-import__problem" role="alert" data-testid="import-date-order-mismatch">
+                {{ ui.text('importDateOrderMismatch', language, dateOrders()) }}
+              </p>
+            }
+            @case ('unconfirmed') {
+              <p class="ngx-entity-import__delimiter" data-testid="import-date-order-unconfirmed">
+                {{ ui.text('importDateOrderUnconfirmed', language, dateOrders()) }}
+              </p>
+            }
+          }
           @if (plan(); as current) {
             <ngx-import-preview
               [config]="config"
@@ -11694,12 +11866,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImpo
               [rules]="rules"
               [language]="language"
               [decimal]="decimal()"
+              [dateOrder]="reportedDateOrder()"
             />
           }
           <button
             type="button"
             data-testid="import-commit"
-            [disabled]="busy()"
+            [disabled]="busy() || dateOrderCheck() === 'mismatch'"
             (click)="commit()"
           >
             {{
@@ -11756,6 +11929,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.25", ngImpo
                 type: Input
             }], language: [{
                 type: Input
+            }], dateOrder: [{
+                type: Input
             }], templateFormat: [{
                 type: Input
             }], importComplete: [{
@@ -11793,5 +11968,5 @@ function saveBlob(blob, filename) {
  * Generated bundle index. Do not edit.
  */
 
-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 };
 //# sourceMappingURL=ngx-dynamic-entity.mjs.map