@acorex/platform 21.0.0-next.75 → 21.0.0-next.76

package/fesm2022/acorex-platform-core.mjs

@@ -4,6 +4,7 @@ import { AXTranslationService, resolveMultiLanguageString } from '@acorex/core/t
 import { AXDataSource } from '@acorex/cdk/common';
 import { isPlainObject, get, set, isNil, isEmpty, isArray, merge, isObjectLike, transform, isEqual, differenceWith, union, cloneDeep, has, sortBy, isUndefined, endsWith, startsWith, includes, lte, gte, lt, gt, orderBy } from 'lodash-es';
 import { signalStore, withState, withComputed, withMethods, patchState } from '@ngrx/signals';
+import { AXFormatService } from '@acorex/core/format';
 import * as i1 from '@acorex/components/skeleton';
 import { AXSkeletonModule } from '@acorex/components/skeleton';
 import { Subject, interval, fromEvent } from 'rxjs';
@@ -1486,6 +1487,98 @@ const AXPContextStore = signalStore(withState(() => ({
 }));
 //#endregion
 
+//#region ---- Imports ----
+//#endregion
+//#region ---- Pipe normalization ----
+/** Normalizes shorthand pipe names to `{ type, options? }` specs. */
+function normalizeContextEvalPipes(pipes) {
+    return pipes.map((pipe) => (typeof pipe === 'string' ? { type: pipe } : pipe));
+}
+//#endregion
+//#region ---- Pipe application ----
+/**
+ * Applies a left-to-right formatter pipeline via {@link AXFormatService}.
+ * Unknown formatters fall back to a trimmed string representation.
+ */
+function applyContextEvalPipes(value, pipes, formatService) {
+    if (!pipes?.length) {
+        return value;
+    }
+    let current = value;
+    for (const pipe of normalizeContextEvalPipes(pipes)) {
+        try {
+            current = formatService.format(current, pipe.type, pipe.options);
+        }
+        catch {
+            current = current == null ? '' : String(current);
+        }
+    }
+    return current;
+}
+/** Reads a nested path from data and optionally applies display pipes. */
+function contextEvalWithPipes(data, path, formatService, pipes) {
+    return applyContextEvalPipes(get(data, path), pipes, formatService);
+}
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+/**
+ * Builds sync `context.eval(path, { pipes })` functions backed by {@link AXFormatService}.
+ * Supports built-in and custom formatters registered on {@link AXFormatModule}.
+ */
+class AXPContextEvalFactory {
+    constructor() {
+        //#region ---- Services & Dependencies ----
+        this.formatService = inject(AXFormatService);
+    }
+    //#endregion
+    //#region ---- Factory ----
+    /** Creates a sync eval function for the given record/context data object. */
+    create(data) {
+        return (path, options) => {
+            const raw = get(data, path);
+            return applyContextEvalPipes(raw, options?.pipes, this.formatService);
+        };
+    }
+    /** Creates `{ eval }` scope object for expression evaluator scopes. */
+    createScope(data) {
+        return { eval: this.create(data) };
+    }
+    /**
+     * Display-tier scope that re-reads data on each eval (for live stores / changing row context).
+     */
+    createLiveScope(getData) {
+        return {
+            eval: (path, options) => this.create(getData())(path, options),
+        };
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPContextEvalFactory, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPContextEvalFactory, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPContextEvalFactory, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Types ----
+//#endregion
+
+//#region ---- Template normalization ----
+/**
+ * Normalizes display templates before {@link AXPExpressionEvaluatorService} evaluation.
+ * Converts simple dot paths (e.g. `{{ position.title }}`) to `context.eval("position.title")`
+ * so row data is read from scope.context instead of bare JavaScript identifiers.
+ */
+function normalizeExpressionTemplate(template) {
+    let normalized = template.replace(/\{\{\s*context\.eval\(['"]([^'"]+)['"]\)\s*\}\}/g, '{{ context.eval("$1") }}');
+    if (!normalized.includes('{{')) {
+        normalized = normalized.replace(/\{/g, '{{').replace(/\}/g, '}}');
+    }
+    return normalized.replace(/\{\{\s*(?!context\.)([\w]+(?:\.[\w]+)*)\s*\}\}/g, '{{ context.eval("$1") }}');
+}
+//#endregion
+
 class AXPExpressionEvaluatorScopeProviderContext {
     constructor() {
         this.scopes = {};
@@ -1595,8 +1688,9 @@ class AXPExpressionEvaluatorService {
         }
     }
     async evaluateStringExpression(templateExpression, scope) {
+        const normalizedTemplate = normalizeExpressionTemplate(templateExpression);
         // Check if the input is exactly a single {{ ... }} expression (handle multiline)
-        const exactMatch = templateExpression.match(/^\s*\{\{\s*([\s\S]*?)\s*\}\}\s*$/);
+        const exactMatch = normalizedTemplate.match(/^\s*\{\{\s*([\s\S]*?)\s*\}\}\s*$/);
         if (exactMatch) {
             const expression = exactMatch[1];
             const sandbox = this.getOrCompileFunction(expression);
@@ -1608,7 +1702,7 @@ class AXPExpressionEvaluatorService {
         // Collect all matches and their positions
         const matches = [];
         let match;
-        while ((match = regex.exec(templateExpression)) !== null) {
+        while ((match = regex.exec(normalizedTemplate)) !== null) {
             matches.push({
                 expression: match[1],
                 start: match.index,
@@ -1625,12 +1719,12 @@ class AXPExpressionEvaluatorService {
         let result = '';
         let lastIndex = 0;
         matches.forEach((m, i) => {
-            result += templateExpression.slice(lastIndex, m.start);
+            result += normalizedTemplate.slice(lastIndex, m.start);
             const value = values[i];
             result += value !== undefined && value !== null ? value : '';
             lastIndex = m.end;
         });
-        result += templateExpression.slice(lastIndex);
+        result += normalizedTemplate.slice(lastIndex);
         return result;
     }
     isExpression(expression) {
@@ -3813,6 +3907,115 @@ function searchInMultiLanguageString(value, query, locale) {
 }
 //#endregion
 
+//#region ---- Imports ----
+//#endregion
+//#region ---- Constants ----
+const DEFAULT_IDLE_TIMEOUT_MS = 2_000;
+const DEFAULT_MIN_IDLE_MS = 16;
+//#endregion
+//#region ---- Service ----
+/**
+ * Schedules low-priority work during browser idle periods.
+ * Pauses when the tab is hidden or when explicitly paused (e.g. user-initiated seeding).
+ */
+class AXPIdleSchedulerService {
+    constructor() {
+        //#region ---- State ----
+        this.pausedState = signal(false, ...(ngDevMode ? [{ debugName: "pausedState" }] : /* istanbul ignore next */ []));
+        this.paused = this.pausedState.asReadonly();
+        this.queue = [];
+        this.running = false;
+    }
+    //#endregion
+    //#region ---- Public API ----
+    pause() {
+        this.pausedState.set(true);
+    }
+    resume() {
+        this.pausedState.set(false);
+        void this.drainQueue();
+    }
+    /**
+     * Resolves after the browser reports idle time, or after timeoutMs (whichever comes first).
+     */
+    waitForIdle(options) {
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        const minIdleMs = options?.minIdleMs ?? DEFAULT_MIN_IDLE_MS;
+        if (this.pausedState() || typeof document !== 'undefined' && document.visibilityState === 'hidden') {
+            return this.delay(timeoutMs);
+        }
+        return new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve();
+            };
+            const timeoutId = setTimeout(finish, timeoutMs);
+            if (typeof requestIdleCallback === 'function') {
+                requestIdleCallback(() => {
+                    clearTimeout(timeoutId);
+                    finish();
+                }, { timeout: timeoutMs });
+            }
+            else {
+                clearTimeout(timeoutId);
+                setTimeout(finish, minIdleMs);
+            }
+        });
+    }
+    /** Enqueues async work processed sequentially during idle slices. */
+    enqueue(task, options) {
+        if (options?.key) {
+            this.queue = this.queue.filter((item) => item.key !== options.key);
+        }
+        this.queue.push({ key: options?.key, task });
+        void this.drainQueue();
+    }
+    //#endregion
+    //#region ---- Private ----
+    async drainQueue() {
+        if (this.running || this.pausedState()) {
+            return;
+        }
+        this.running = true;
+        try {
+            while (this.queue.length > 0 && !this.pausedState()) {
+                const next = this.queue.shift();
+                if (!next)
+                    break;
+                await this.waitForIdle();
+                try {
+                    await next.task();
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    console.error('[AXPIdleScheduler] Task failed:', message);
+                }
+            }
+        }
+        finally {
+            this.running = false;
+            if (this.queue.length > 0 && !this.pausedState()) {
+                void this.drainQueue();
+            }
+        }
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPIdleSchedulerService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPIdleSchedulerService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPIdleSchedulerService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Idle scheduler types ----
+//#endregion
+
 //#region ----   Tag Types   ----
 //#endregion
 
@@ -5742,5 +5945,5 @@ function generateKebabCase(title) {
  * Generated bundle index. Do not edit.
  */
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextDefinitionProviderService, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPImageUrlLogoConfig, AXPKeyboardShortcutPriority, AXPKeyboardShortcutRegistry, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformCoreDataSourceKeys, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, buildLocaleTextMapValue, captureFormContextBaseline, chordToKbdItemKeys, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getSmart, getSystemActions, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, isFormContextDirty, isFormValueEqual, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isLocaleStringMap, isMacPlatform, isSelectionValueEqual, isVisibleOverlayElement, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeDefinitionCategories, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseKeyboardShortcutChord, provideLazyProvider, resolveActionLook, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolvePlatformScopeKey, resolvePlatformScopeName, resolveSemanticDirectionalKey, searchInMultiLanguageString, setSmart, shouldDeferEscapeToOpenOverlay, shouldUseLocaleMapShape, sortByMultiLanguageString, unwrapValueProperty };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPCatalogScopeDefinitionProviderService, AXPCatalogScopeDefinitionsDataSourceDefinition, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextDefinitionProviderService, AXPContextEvalFactory, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPIdleSchedulerService, AXPImageUrlLogoConfig, AXPKeyboardShortcutPriority, AXPKeyboardShortcutRegistry, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformCoreDataSourceKeys, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_CATALOG_SCOPE_DEFINITION_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_CONTEXT_DEFINITION_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, AX_OVERLAY_CONTAINER_SELECTOR, AX_OVERLAY_PANE_SELECTOR, applyContextEvalPipes, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, buildLocaleTextMapValue, captureFormContextBaseline, chordToKbdItemKeys, cleanDeep, coerceUnknownToBoolean, coerceUnknownToDate, coerceUnknownToFiniteNumber, coerceUnknownToTrimmedString, compareMultiLanguageStrings, containsHtmlMarkup, contextEvalWithPipes, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, findOverlayContainerAncestor, formatKeyboardShortcutChord, formatKeyboardShortcutChords, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getNestedVisibleOverlayPanes, getPrimaryKeyboardShortcutChord, getSmart, getSystemActions, getTopVisibleOverlayContainer, getVisibleAnchoredOverlayPanes, getVisibleOverlayContainers, hasForegroundOverlayLayer, isFormContextDirty, isFormValueEqual, isHorizontalDirectionalShortcutKey, isKeyboardTargetInsideEditableField, isLocaleStringMap, isMacPlatform, isSelectionValueEqual, isVisibleOverlayElement, matchesKeyboardShortcutChord, mirrorHorizontalDirectionalKey, normalizeContextEvalPipes, normalizeDefinitionCategories, normalizeExpressionTemplate, normalizeKeyboardShortcut, normalizeKeyboardShortcuts, objectKeyValueTransforms, parseKeyboardShortcutChord, provideLazyProvider, resolveActionLook, resolveDisplayShortcutChord, resolveEffectiveDirectionBehavior, resolvePlatformScopeKey, resolvePlatformScopeName, resolveSemanticDirectionalKey, searchInMultiLanguageString, setSmart, shouldDeferEscapeToOpenOverlay, shouldUseLocaleMapShape, sortByMultiLanguageString, unwrapValueProperty };
 //# sourceMappingURL=acorex-platform-core.mjs.map