@acorex/components 20.7.37 → 20.7.39

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "20.7.37",
+  "version": "20.7.39",
   "peerDependencies": {
-    "@acorex/core": "20.7.37",
-    "@acorex/cdk": "20.7.37",
+    "@acorex/core": "20.7.39",
+    "@acorex/cdk": "20.7.39",
     "polytype": ">=0.17.0",
     "angular-imask": ">=7.6.1",
     "gridstack": ">=12.0.0",
@@ -72,6 +72,10 @@
       "types": "./aspect-ratio/index.d.ts",
       "default": "./fesm2022/acorex-components-aspect-ratio.mjs"
     },
+    "./audio-wave": {
+      "types": "./audio-wave/index.d.ts",
+      "default": "./fesm2022/acorex-components-audio-wave.mjs"
+    },
     "./autocomplete": {
       "types": "./autocomplete/index.d.ts",
       "default": "./fesm2022/acorex-components-autocomplete.mjs"
@@ -80,10 +84,6 @@
       "types": "./avatar/index.d.ts",
       "default": "./fesm2022/acorex-components-avatar.mjs"
     },
-    "./audio-wave": {
-      "types": "./audio-wave/index.d.ts",
-      "default": "./fesm2022/acorex-components-audio-wave.mjs"
-    },
     "./badge": {
       "types": "./badge/index.d.ts",
       "default": "./fesm2022/acorex-components-badge.mjs"
@@ -428,6 +428,10 @@
       "types": "./switch/index.d.ts",
       "default": "./fesm2022/acorex-components-switch.mjs"
     },
+    "./tabs": {
+      "types": "./tabs/index.d.ts",
+      "default": "./fesm2022/acorex-components-tabs.mjs"
+    },
     "./tag": {
       "types": "./tag/index.d.ts",
       "default": "./fesm2022/acorex-components-tag.mjs"
@@ -436,9 +440,9 @@
       "types": "./tag-box/index.d.ts",
       "default": "./fesm2022/acorex-components-tag-box.mjs"
     },
-    "./tabs": {
-      "types": "./tabs/index.d.ts",
-      "default": "./fesm2022/acorex-components-tabs.mjs"
+    "./text-area": {
+      "types": "./text-area/index.d.ts",
+      "default": "./fesm2022/acorex-components-text-area.mjs"
     },
     "./text-box": {
       "types": "./text-box/index.d.ts",
@@ -460,10 +464,6 @@
       "types": "./toolbar/index.d.ts",
       "default": "./fesm2022/acorex-components-toolbar.mjs"
     },
-    "./text-area": {
-      "types": "./text-area/index.d.ts",
-      "default": "./fesm2022/acorex-components-text-area.mjs"
-    },
     "./tooltip": {
       "types": "./tooltip/index.d.ts",
       "default": "./fesm2022/acorex-components-tooltip.mjs"
@@ -476,14 +476,14 @@
       "types": "./tree-view-legacy/index.d.ts",
       "default": "./fesm2022/acorex-components-tree-view-legacy.mjs"
     },
-    "./video-player": {
-      "types": "./video-player/index.d.ts",
-      "default": "./fesm2022/acorex-components-video-player.mjs"
-    },
     "./uploader": {
       "types": "./uploader/index.d.ts",
       "default": "./fesm2022/acorex-components-uploader.mjs"
     },
+    "./video-player": {
+      "types": "./video-player/index.d.ts",
+      "default": "./fesm2022/acorex-components-video-player.mjs"
+    },
     "./wysiwyg": {
       "types": "./wysiwyg/index.d.ts",
       "default": "./fesm2022/acorex-components-wysiwyg.mjs"

package/scheduler/index.d.ts

@@ -107,13 +107,14 @@ interface AXSchedulerSlotDropEvent extends NXEvent<AXSchedulerComponent> {
 }
 declare class AXSchedulerComponent extends NXComponent implements OnInit {
     #private;
-    private platformService;
     private unsubscriber;
     private formatService;
     private localeService;
     private calendarService;
     private schedulerService;
     private translationService;
+    private eventService;
+    private translationRevision;
     private viewModeSelectbox;
     private calendarPopover;
     private _calendarDayCellTemplate;
@@ -130,7 +131,7 @@ declare class AXSchedulerComponent extends NXComponent implements OnInit {
     currentDate: _angular_core.WritableSignal<AXDateTime>;
     private _appointments;
     appointments: _angular_core.Signal<AXSchedulerAppointment[]>;
-    protected rtl: _angular_core.WritableSignal<boolean>;
+    protected readonly rtl: _angular_core.Signal<boolean>;
     protected isFullScreen: _angular_core.WritableSignal<boolean>;
     protected viewsDataSource: _angular_core.WritableSignal<{
         id: string;
@@ -179,6 +180,12 @@ declare class AXSchedulerComponent extends NXComponent implements OnInit {
     protected handleAppointmentRightClickInternal(eventData: AXSchedulerAppointmentMouseEvent): void;
     protected handleAppointmentDropInternal(eventData: AXSchedulerSlotDropEvent): void;
     ngOnInit(): void;
+    /**
+     * Picks a stable anchor inside the visible week so re-aligning after a locale
+     * change does not drift when the previous week start was a Sunday/Monday edge.
+     */
+    private getWeekReanchorDate;
+    private syncCurrentDateAfterLocaleChange;
     private fillDataSource;
     private getGridDateRange;
     currentDateText: _angular_core.Signal<string>;
@@ -1054,6 +1061,7 @@ declare class AXSchedulerModule {
 declare class AXSchedulerService {
     private formatService;
     private calendarService;
+    private localeService;
     readonly HOURS_PER_DAY = 24;
     readonly MINUTES_PER_HOUR = 60;
     readonly BLOCK_DURATION_MINUTES = 30;
@@ -1130,6 +1138,16 @@ declare class AXSchedulerService {
      * @returns number - Day number (1-7, where 1 is Sunday).
      */
     getDayOfWeekNumber(dayName: AXDayOfWeekName): number;
+    /**
+     * Resolves the 0-based week-start index (0 = Sunday … 6 = Saturday) from locale or an override.
+     */
+    resolveWeekStartsOn(firstDayOfWeek?: AXDayOfWeekName): number;
+    /**
+     * Aligns a date to the start of its week using locale week layout and calendar weekday indexing.
+     */
+    alignToWeekStart(date: AXDateTime, options?: {
+        firstDayOfWeek?: AXDayOfWeekName;
+    }): AXDateTime;
     /**
      * Gets slot data for a given start date and view.
      *

package/tree-view/index.d.ts

@@ -97,6 +97,14 @@ interface AXTreeViewNodeToggleEvent extends AXHtmlEvent {
 }
 interface AXTreeViewNodeSelectEvent extends AXHtmlEvent {
     node: AXTreeViewNode;
+    /** When false, the selection change was applied programmatically (controlled sync, selectNode, etc.). */
+    isUserInteraction?: boolean;
+}
+type AXTreeViewSelectionSource = 'user' | 'programmatic';
+/** Options for {@link AXTreeViewComponent.selectAndReveal}. */
+interface AXTreeViewSelectAndRevealOptions {
+    /** Ancestor node ids from root to parent for each target id (parallel to nodeIds). */
+    ancestorPaths?: string[][];
 }
 interface AXTreeViewNodeDoubleClickEvent extends AXHtmlEvent {
     node: AXTreeViewNode;
@@ -106,6 +114,8 @@ interface AXTreeViewNodeClickEvent extends AXHtmlEvent {
 }
 interface AXTreeViewSelectionChangeEvent extends AXEvent {
     selectedNodes: AXTreeViewNode[];
+    selectedIds: string[];
+    source: AXTreeViewSelectionSource;
 }
 interface AXTreeViewDropEvent extends AXEvent {
     node: AXTreeViewNode;
@@ -260,6 +270,13 @@ declare class AXTreeViewComponent {
     readonly doubleClickDuration: _angular_core.InputSignal<number>;
     /** Duration in milliseconds for detecting double-clicks. Default: `50`. */
     readonly tooltipDelay: _angular_core.InputSignal<number>;
+    /**
+     * When true, {@link selectedIds} is the source of truth: the tree applies it on load/reload
+     * and emits updates on user interaction. Default: `false` (existing imperative API unchanged).
+     */
+    readonly controlledSelection: _angular_core.InputSignal<boolean>;
+    /** Selected node ids (two-way). Used when {@link controlledSelection} is true. */
+    readonly selectedIds: _angular_core.ModelSignal<string[]>;
     /** Emitted before a drop operation - set canceled to true to prevent drop */
     readonly onBeforeDrop: _angular_core.OutputEmitterRef<AXTreeViewBeforeDropEvent>;
     /** Emitted when a node is toggled (expanded/collapsed) */
@@ -297,6 +314,11 @@ declare class AXTreeViewComponent {
     protected readonly directionCollapsedIcon: _angular_core.Signal<string>;
     /** Flag to prevent infinite loops when syncing datasource */
     private isUpdatingFromDatasource;
+    /** Bumped when controlled selection changes so stale async sync is ignored. */
+    private selectionSyncRevision;
+    private pendingApplySelectedIdsTimeout?;
+    /** Prevents selectedIds effect from re-applying when the model was updated from the tree. */
+    private isUpdatingSelectedIdsModel;
     /** Computed to check if datasource is a function */
     private readonly isLazyDataSource;
     /** Computed: Returns true when selection is restricted to leaf nodes only */
@@ -423,6 +445,15 @@ declare class AXTreeViewComponent {
      * Get all selected nodes
      */
     getSelectedNodes(): AXTreeViewNode[];
+    /**
+     * Returns selected node ids (from {@link selectedIds} when controlled, otherwise from tree state).
+     */
+    getSelectedIds(): string[];
+    /**
+     * Expands ancestor paths (when provided) and applies selection.
+     * Intended for lazy trees with {@link controlledSelection}.
+     */
+    selectAndReveal(nodeIds: string[], options?: AXTreeViewSelectAndRevealOptions): Promise<void>;
     /**
      * Delete selected nodes from the tree
      */
@@ -659,6 +690,16 @@ declare class AXTreeViewComponent {
      * Emit selection change event with all selected nodes
      */
     private emitSelectionChange;
+    private bumpSelectionSyncRevision;
+    private isSelectionSyncCurrent;
+    private normalizeSelectedIdsForMode;
+    private areSelectedIdsEqual;
+    private setSelectedIdsModel;
+    private syncSelectedIdsModelFromTree;
+    private scheduleApplySelectedIdsToTree;
+    private applySelectedIdsToTree;
+    private applySelectedIdsToTreeWithRetry;
+    private expandAncestorPaths;
     /**
      * Handle node double click
      */
@@ -797,7 +838,7 @@ declare class AXTreeViewComponent {
      */
     private handleError;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXTreeViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXTreeViewComponent, "ax-tree-view", never, { "datasource": { "alias": "datasource"; "required": true; "isSignal": true; }; "selectMode": { "alias": "selectMode"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "dragArea": { "alias": "dragArea"; "required": false; "isSignal": true; }; "dragBehavior": { "alias": "dragBehavior"; "required": false; "isSignal": true; }; "showIcons": { "alias": "showIcons"; "required": false; "isSignal": true; }; "showChildrenBadge": { "alias": "showChildrenBadge"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "titleField": { "alias": "titleField"; "required": false; "isSignal": true; }; "tooltipField": { "alias": "tooltipField"; "required": false; "isSignal": true; }; "iconField": { "alias": "iconField"; "required": false; "isSignal": true; }; "expandedField": { "alias": "expandedField"; "required": false; "isSignal": true; }; "selectedField": { "alias": "selectedField"; "required": false; "isSignal": true; }; "indeterminateField": { "alias": "indeterminateField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "hiddenField": { "alias": "hiddenField"; "required": false; "isSignal": true; }; "childrenField": { "alias": "childrenField"; "required": false; "isSignal": true; }; "childrenCountField": { "alias": "childrenCountField"; "required": false; "isSignal": true; }; "dataField": { "alias": "dataField"; "required": false; "isSignal": true; }; "inheritDisabled": { "alias": "inheritDisabled"; "required": false; "isSignal": true; }; "expandOnDoubleClick": { "alias": "expandOnDoubleClick"; "required": false; "isSignal": true; }; "doubleClickDuration": { "alias": "doubleClickDuration"; "required": false; "isSignal": true; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; "isSignal": true; }; }, { "datasource": "datasourceChange"; "onBeforeDrop": "onBeforeDrop"; "onNodeToggle": "onNodeToggle"; "onNodeSelect": "onNodeSelect"; "onNodeDoubleClick": "onNodeDoubleClick"; "onNodeClick": "onNodeClick"; "onSelectionChange": "onSelectionChange"; "onOrderChange": "onOrderChange"; "onMoveChange": "onMoveChange"; "onItemsChange": "onItemsChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXTreeViewComponent, "ax-tree-view", never, { "datasource": { "alias": "datasource"; "required": true; "isSignal": true; }; "selectMode": { "alias": "selectMode"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "dragArea": { "alias": "dragArea"; "required": false; "isSignal": true; }; "dragBehavior": { "alias": "dragBehavior"; "required": false; "isSignal": true; }; "showIcons": { "alias": "showIcons"; "required": false; "isSignal": true; }; "showChildrenBadge": { "alias": "showChildrenBadge"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "titleField": { "alias": "titleField"; "required": false; "isSignal": true; }; "tooltipField": { "alias": "tooltipField"; "required": false; "isSignal": true; }; "iconField": { "alias": "iconField"; "required": false; "isSignal": true; }; "expandedField": { "alias": "expandedField"; "required": false; "isSignal": true; }; "selectedField": { "alias": "selectedField"; "required": false; "isSignal": true; }; "indeterminateField": { "alias": "indeterminateField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "hiddenField": { "alias": "hiddenField"; "required": false; "isSignal": true; }; "childrenField": { "alias": "childrenField"; "required": false; "isSignal": true; }; "childrenCountField": { "alias": "childrenCountField"; "required": false; "isSignal": true; }; "dataField": { "alias": "dataField"; "required": false; "isSignal": true; }; "inheritDisabled": { "alias": "inheritDisabled"; "required": false; "isSignal": true; }; "expandOnDoubleClick": { "alias": "expandOnDoubleClick"; "required": false; "isSignal": true; }; "doubleClickDuration": { "alias": "doubleClickDuration"; "required": false; "isSignal": true; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "controlledSelection"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; }, { "datasource": "datasourceChange"; "selectedIds": "selectedIdsChange"; "onBeforeDrop": "onBeforeDrop"; "onNodeToggle": "onNodeToggle"; "onNodeSelect": "onNodeSelect"; "onNodeDoubleClick": "onNodeDoubleClick"; "onNodeClick": "onNodeClick"; "onSelectionChange": "onSelectionChange"; "onOrderChange": "onOrderChange"; "onMoveChange": "onMoveChange"; "onItemsChange": "onItemsChange"; }, never, never, true, never>;
 }
 
 declare class AXTreeViewModule {
@@ -993,4 +1034,4 @@ declare class AXTreeViewService {
 }
 
 export { AXTreeViewComponent, AXTreeViewModule, AXTreeViewService };
-export type { AXTreeViewBeforeDropEvent, AXTreeViewCallback, AXTreeViewChildrenSelectionState, AXTreeViewDataSource, AXTreeViewDragArea, AXTreeViewDragBehavior, AXTreeViewDropEvent, AXTreeViewFlatNode, AXTreeViewItemTemplateContext, AXTreeViewNode, AXTreeViewNodeClickEvent, AXTreeViewNodeDoubleClickEvent, AXTreeViewNodeSelectEvent, AXTreeViewNodeToggleEvent, AXTreeViewSelectMode, AXTreeViewSelectionBehavior, AXTreeViewSelectionChangeEvent, AXTreeViewViewLook };
+export type { AXTreeViewBeforeDropEvent, AXTreeViewCallback, AXTreeViewChildrenSelectionState, AXTreeViewDataSource, AXTreeViewDragArea, AXTreeViewDragBehavior, AXTreeViewDropEvent, AXTreeViewFlatNode, AXTreeViewItemTemplateContext, AXTreeViewNode, AXTreeViewNodeClickEvent, AXTreeViewNodeDoubleClickEvent, AXTreeViewNodeSelectEvent, AXTreeViewNodeToggleEvent, AXTreeViewSelectAndRevealOptions, AXTreeViewSelectMode, AXTreeViewSelectionBehavior, AXTreeViewSelectionChangeEvent, AXTreeViewSelectionSource, AXTreeViewViewLook };