@arsedizioni/ars-utils 21.2.310 → 21.2.313

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "21.2.310",
+  "version": "21.2.313",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1025,7 +1025,7 @@ declare class ClipperDocumentMenuComponent {
     /** Internal counter incremented on each external selection-model change to drive signal re-evaluation. */
     private readonly selectionChangeTick;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"bag" | "selection" | "none">;
+    readonly selectionSource: _angular_core.InputSignal<"selection" | "bag" | "none">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

package/types/arsedizioni-ars-utils-help.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnInit, OnDestroy, AfterViewInit } from '@angular/core';
+import { OnDestroy } from '@angular/core';
 import { Folder, ApiResult } from '@arsedizioni/ars-utils/core';
 import { BreakpointObserver } from '@angular/cdk/layout';
 import { MatSidenav } from '@angular/material/sidenav';
@@ -61,10 +61,9 @@ declare class IndexTreeDataSource implements OnDestroy {
     static ɵfac: i0.ɵɵFactoryDeclaration<IndexTreeDataSource, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<IndexTreeDataSource>;
 }
-declare class HelpViewerComponent implements OnInit, OnDestroy, AfterViewInit {
+declare class HelpViewerComponent {
     readonly indexPane: i0.Signal<MatSidenav>;
-    private readonly unsubscribe;
-    private readonly changeDetector;
+    private readonly destroyRef;
     private readonly dialogRef;
     protected readonly dialogData: HelpViewerDialogData;
     private readonly dialogService;
@@ -85,9 +84,7 @@ declare class HelpViewerComponent implements OnInit, OnDestroy, AfterViewInit {
     protected readonly flatNodes: i0.WritableSignal<IndexNode[]>;
     private folders?;
     protected hasChild: (_: number, _node: IndexNode) => boolean;
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    ngAfterViewInit(): void;
+    constructor();
     /**
   * Handle filter pane visibility
   */

package/types/arsedizioni-ars-utils-support.ui.d.ts

@@ -1,10 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, AfterViewInit } from '@angular/core';
 import { MatPaginator, PageEvent } from '@angular/material/paginator';
 import { ScreenService, SelectableModel } from '@arsedizioni/ars-utils/core';
 import { SupportNotificationInfo, SupportNotificationsSearchParams } from '@arsedizioni/ars-utils/support.common';
 
-declare class SupportNotificationsBrowserComponent implements OnInit, AfterViewInit {
+declare class SupportNotificationsBrowserComponent {
     readonly paginator: _angular_core.Signal<MatPaginator>;
     protected readonly screenService: ScreenService;
     private readonly supportService;
@@ -15,8 +14,7 @@ declare class SupportNotificationsBrowserComponent implements OnInit, AfterViewI
     protected searchParams: SupportNotificationsSearchParams;
     protected total: _angular_core.WritableSignal<number>;
     protected items: _angular_core.WritableSignal<SupportNotificationInfo[]>;
-    ngOnInit(): void;
-    ngAfterViewInit(): void;
+    constructor();
     /**
      * Scrolls the notifications list back to the top.
      */

package/types/arsedizioni-ars-utils-ui.application.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy, DoCheck, ElementRef } from '@angular/core';
+import { OnDestroy, DoCheck, ElementRef } from '@angular/core';
 import { Searchable, SearchBag, NameValueItem, DateInterval, SearchFilterMetadata, FileInfo, INode } from '@arsedizioni/ars-utils/core';
 import { MatFormFieldAppearance, MatFormFieldControl } from '@angular/material/form-field';
 import { MatDialogRef } from '@angular/material/dialog';
@@ -373,7 +373,7 @@ interface SelectTreeDialogAppend {
     parent?: ItemNode;
     owner?: any;
 }
-declare class SelectTreeDialogComponent implements OnInit {
+declare class SelectTreeDialogComponent {
     /** Emitted when the user confirms a selection. */
     readonly done: _angular_core.OutputEmitterRef<SelectTreeDialogResult>;
     /** Emitted when the user requests to append a new node. */
@@ -383,6 +383,7 @@ declare class SelectTreeDialogComponent implements OnInit {
     /** Dialog configuration, injected and exposed as a signal. */
     protected readonly dialogData: _angular_core.WritableSignal<SelectTreeDialogData>;
     private readonly tree;
+    private readonly _elRef;
     /** Reference to the Material tree component. */
     protected readonly matTree: _angular_core.Signal<MatTree<ItemNode, ItemNode>>;
     /** Provides children of a tree node to the tree component. */
@@ -391,15 +392,19 @@ declare class SelectTreeDialogComponent implements OnInit {
     protected readonly treeNodes: _angular_core.WritableSignal<ItemNode[]>;
     /** Currently selected tree node. */
     protected readonly currentNode: _angular_core.WritableSignal<ItemNode>;
-    /** Current filter text, bound via ngModel. */
-    protected filterText: string;
+    /** Current filter text. */
+    protected readonly filterText: _angular_core.WritableSignal<string>;
     /** Nodes matching the current filter text. */
     protected readonly filteredItems: _angular_core.WritableSignal<ItemNode[]>;
-    /** Index of the currently highlighted filtered node. */
+    /** Index of the currently highlighted filtered node (-1 = none). */
     protected readonly filterIndex: _angular_core.WritableSignal<number>;
+    /** The currently highlighted filtered node, or null. */
+    protected readonly filteredNode: _angular_core.Signal<ItemNode>;
     protected readonly canAppend: _angular_core.WritableSignal<boolean>;
+    /** Flat node map rebuilt whenever treeNodes changes. */
+    private readonly _nodeMap;
     protected hasChild: (_: number, node: ItemNode) => boolean;
-    ngOnInit(): void;
+    constructor();
     /**
      * Confirm the current selection and close the dialog.
      */
@@ -415,26 +420,30 @@ declare class SelectTreeDialogComponent implements OnInit {
      */
     protected clearFilter(): void;
     /**
-     * Filter the tree nodes by name.
-     * @param text - Optional text to set as the filter before applying.
+     * Filter the tree nodes by name (minimum 3 characters).
      */
-    protected doFilter(text?: string): void;
+    protected doFilter(): void;
     /**
      * Advance to the next matching filtered node and scroll it into view.
      */
     protected nextFiltered(): void;
+    /**
+     * Returns true when the node is the currently highlighted filter match.
+     * @param node - tree node to check.
+     */
+    protected isFilteredNode(node: ItemNode): boolean;
+    /**
+     * Expands ancestors of the target node and scrolls it into view.
+     * @param index - index within `items` to scroll to.
+     * @param items - current filtered items array.
+     */
+    private _scrollToFiltered;
     /**
      * Expand a node and all of its parent nodes.
      * @param node - The node to expand.
      * @returns Always false.
      */
     expand(node: ItemNode): boolean;
-    /**
-     * Recursively get all nodes in depth-first order.
-     * @param nodes - Root nodes to traverse.
-     * @param result - Accumulator array.
-     */
-    private getAllNodes;
     /**
      * Recursively find a node by id.
      * @param nodes - Nodes to search.
@@ -1138,9 +1147,8 @@ declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldCont
     set disabled(value: boolean);
     get placeholder(): string;
     set placeholder(value: string);
-    /** The currently displayed file name. Can be bound from outside or updated on file selection. */
-    readonly fileName: _angular_core.InputSignal<string>;
-    readonly fileNameInput: _angular_core.OutputEmitterRef<string>;
+    /** The currently displayed file name. Can be bound two-way from outside or updated on file selection. */
+    readonly fileName: _angular_core.ModelSignal<string>;
     readonly maxSizeMb: _angular_core.InputSignal<number>;
     readonly minSizeMb: _angular_core.InputSignal<number>;
     readonly isNew: _angular_core.InputSignal<boolean>;
@@ -1220,7 +1228,7 @@ declare class FileInputComponent implements OnDestroy, DoCheck, MatFormFieldCont
      */
     protected previewFile(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileInputComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileInputComponent, "file-input", never, { "required": { "alias": "required"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "isNew": { "alias": "isNew"; "required": false; "isSignal": true; }; "canPreview": { "alias": "canPreview"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; }, { "fileNameInput": "fileNameInput"; "changed": "changed"; "download": "download"; "preview": "preview"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileInputComponent, "file-input", never, { "required": { "alias": "required"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; "isSignal": true; }; "minSizeMb": { "alias": "minSizeMb"; "required": false; "isSignal": true; }; "isNew": { "alias": "isNew"; "required": false; "isSignal": true; }; "canPreview": { "alias": "canPreview"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; }, { "fileName": "fileNameChange"; "changed": "changed"; "download": "download"; "preview": "preview"; }, never, never, true, never>;
 }
 
 interface FilePreviewDialogData {
@@ -1343,12 +1351,12 @@ declare class FilterBarComponent {
 declare class TreePickerComponent {
     /** Nested tree data to display. */
     readonly tree: _angular_core.InputSignal<INode[]>;
-    /** Currently selected node ids. */
-    readonly selection: _angular_core.InputSignal<string[]>;
-    /** Emits the updated selection array whenever it changes. */
-    readonly selectionInput: _angular_core.OutputEmitterRef<string[]>;
+    /** Currently selected node ids. Supports two-way binding via [(selection)]. */
+    readonly selection: _angular_core.ModelSignal<string[]>;
     /** When true, checkboxes and chip remove buttons are disabled (mirrors Material convention). */
     readonly disabled: _angular_core.InputSignal<boolean>;
+    /** Description to display when no selection is made. */
+    readonly descriptionEmpty: _angular_core.InputSignal<string>;
     /** Maximum number of tree levels to display (default: 3). */
     readonly maxDepth: _angular_core.InputSignal<number>;
     /**
@@ -1366,6 +1374,7 @@ declare class TreePickerComponent {
     /** Emits void whenever the user changes the selection (toggle, remove, clear). */
     readonly changed: _angular_core.OutputEmitterRef<void>;
     private readonly _treeRef;
+    private readonly _elRef;
     /** All three maps rebuilt lazily as a single computed whenever taxonomy changes. */
     private readonly _maps;
     /** O(1) set of selected ids, rebuilt only when selection changes. */
@@ -1376,6 +1385,14 @@ declare class TreePickerComponent {
     protected readonly selectedVisibleCount: _angular_core.Signal<number>;
     readonly treeChildrenAccessor: (node: INode) => INode[];
     readonly hasChild: (_: number, node: INode) => boolean;
+    /** Current filter text. */
+    protected readonly filterText: _angular_core.WritableSignal<string>;
+    /** Nodes matching the current filter text, in nodeMap iteration order. */
+    protected readonly filteredItems: _angular_core.WritableSignal<INode[]>;
+    /** Index of the currently highlighted filtered node (-1 = none). */
+    protected readonly filterIndex: _angular_core.WritableSignal<number>;
+    /** The currently highlighted filtered node, or null. */
+    protected readonly filteredNode: _angular_core.Signal<INode>;
     constructor();
     /** Expands all visible nodes in the tree. */
     protected expandAll(): void;
@@ -1383,6 +1400,16 @@ declare class TreePickerComponent {
     protected collapseAll(): void;
     /** Clears the entire selection. */
     protected clearAll(): void;
+    /** Searches nodes by text and moves to the first match. */
+    protected doFilter(): void;
+    /** Clears the filter and restores the original tree state. */
+    protected clearFilter(): void;
+    /** Moves to the next matching node, cycling back to the first. */
+    protected nextFiltered(): void;
+    /** Returns true when the node is the currently highlighted filter match. */
+    protected isFilteredNode(node: INode): boolean;
+    /** Expands ancestors of the target node and scrolls it into view. */
+    private _scrollToFiltered;
     /**
      * Returns true when the node is in the active selection.
      * @param node - tree node to check
@@ -1434,7 +1461,7 @@ declare class TreePickerComponent {
      */
     private _syncParentsInSet;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreePickerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreePickerComponent, "tree-picker", never, { "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; "minDepth": { "alias": "minDepth"; "required": false; "isSignal": true; }; }, { "selectionInput": "selectionInput"; "selectionCount": "selectionCount"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreePickerComponent, "tree-picker", never, { "tree": { "alias": "tree"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "descriptionEmpty": { "alias": "descriptionEmpty"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; "minDepth": { "alias": "minDepth"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "selectionCount": "selectionCount"; "changed": "changed"; }, never, never, true, never>;
 }
 
 export { ApplicationDialogService, ArsUIApplicationModule, ButtonSelectorComponent, ButtonToggleComponent, CalendarEmptyHeader, ChipsSelectorComponent, CurrentFilter, CurrentFilterChanged, CurrentFilterItem, FileInputComponent, FilePreviewComponent, FilterBarComponent, Filters, ItemNode, PromptDateDialogComponent, PromptDialogComponent, PromptDialogType, PromptOtpDialogComponent, PromptTimeDialogComponent, ResizeTableColumnDirective, SelectDialogComponent, SelectFileDialogComponent, SelectPictureDialogComponent, SelectTreeDialogComponent, SelectableItem, SelectableNode, SendToDialogComponent, TreeDataSource, TreePickerComponent };