@arsedizioni/ars-utils 21.2.305 → 21.2.306

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "21.2.305",
+  "version": "21.2.306",
   "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-ui.application.d.ts

@@ -1,6 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, DoCheck, ElementRef } from '@angular/core';
-import { Searchable, SearchBag, NameValueItem, DateInterval, SearchFilterMetadata, FileInfo } from '@arsedizioni/ars-utils/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';
 import { DialogService } from '@arsedizioni/ars-utils/ui';
@@ -1339,5 +1339,100 @@ declare class FilterBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "filter-bar", never, { "filters": { "alias": "filters"; "required": false; "isSignal": true; }; "canFilterByText": { "alias": "canFilterByText"; "required": false; "isSignal": true; }; "canFilterByText2": { "alias": "canFilterByText2"; "required": false; "isSignal": true; }; "canFilterByText3": { "alias": "canFilterByText3"; "required": false; "isSignal": true; }; "initialText": { "alias": "initialText"; "required": false; "isSignal": true; }; "initialText2": { "alias": "initialText2"; "required": false; "isSignal": true; }; "initialText3": { "alias": "initialText3"; "required": false; "isSignal": true; }; "textName": { "alias": "textName"; "required": false; "isSignal": true; }; "text2Name": { "alias": "text2Name"; "required": false; "isSignal": true; }; "text3Name": { "alias": "text3Name"; "required": false; "isSignal": true; }; "textLength": { "alias": "textLength"; "required": false; "isSignal": true; }; "text2Length": { "alias": "text2Length"; "required": false; "isSignal": true; }; "text3Length": { "alias": "text3Length"; "required": false; "isSignal": true; }; "showTextSearchButton": { "alias": "showTextSearchButton"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "text2": { "alias": "text2"; "required": false; "isSignal": true; }; "text3": { "alias": "text3"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "text": "textChange"; "text2": "text2Change"; "text3": "text3Change"; }, 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 };
+declare class TreePickerComponent {
+    /** Nested tree data to display. */
+    readonly tree: _angular_core.InputSignal<INode[]>;
+    /** 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>;
+    /** Maximum number of tree levels to display (default: 3). */
+    readonly maxDepth: _angular_core.InputSignal<number>;
+    /**
+     * Number of levels to auto-expand on load.
+     * 0 or undefined = only top level visible (no expansion);
+     * 1 = expand depth-0 nodes; 2 = expand depth-0 and depth-1 nodes; etc.
+     * Must be less than maxDepth.
+     */
+    readonly minDepth: _angular_core.InputSignal<number>;
+    /**
+     * Emits the count of visible selected nodes whenever the selection changes.
+     * Emits 0 when nothing is selected (meaning all items are implicitly included).
+     */
+    readonly selectionCount: _angular_core.OutputEmitterRef<number>;
+    /** Emits void whenever the user changes the selection (toggle, remove, clear). */
+    readonly changed: _angular_core.OutputEmitterRef<void>;
+    private readonly _treeRef;
+    /** 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. */
+    private readonly _selectedSet;
+    /** True when at least one node is explicitly selected. */
+    protected readonly hasSelection: _angular_core.Signal<boolean>;
+    /** Count of selected nodes within the visible levels (depth 0 to maxDepth-1), shown in the tab label. */
+    protected readonly selectedVisibleCount: _angular_core.Signal<number>;
+    readonly treeChildrenAccessor: (node: INode) => INode[];
+    readonly hasChild: (_: number, node: INode) => boolean;
+    constructor();
+    /** Expands all visible nodes in the tree. */
+    protected expandAll(): void;
+    /** Collapses all nodes in the tree. */
+    protected collapseAll(): void;
+    /** Clears the entire selection. */
+    protected clearAll(): void;
+    /**
+     * Returns true when the node is in the active selection.
+     * @param node - tree node to check
+     * @returns true if selected
+     */
+    protected isSelected(node: INode): boolean;
+    /**
+     * Returns true when a subset (but not all) of the node's descendants are selected,
+     * producing the indeterminate checkbox state.
+     * @param node - tree node to evaluate
+     * @returns true if the node is in a partial-selection (indeterminate) state
+     */
+    protected isIndeterminate(node: INode): boolean;
+    /**
+     * Toggles the node and all its descendants; then syncs the ancestor chain.
+     * @param node - the node that was clicked
+     */
+    protected toggleNode(node: INode): void;
+    /**
+     * Deselects the node and all its descendants. Called by the chip remove button.
+     * @param node - the node to remove from the selection
+     */
+    protected removeNode(node: INode): void;
+    /**
+     * Returns the INode for the given id, or undefined if not found.
+     * @param id - node id to look up
+     * @returns the matching INode
+     */
+    protected nodeById(id: string): INode | undefined;
+    /**
+     * Returns true when the node at the given id is within the visible depth range
+     * and should appear in the chip list.
+     * @param id - node id to check
+     * @returns true if the node depth is less than maxDepth
+     */
+    protected isChipVisible(id: string): boolean;
+    /**
+     * Returns all descendants of node in depth-first order, including nodes
+     * beyond the 3-level display limit.
+     * @param node - root of the subtree to traverse
+     * @returns flat array of all descendant INodes
+     */
+    private _getDescendants;
+    /**
+     * Walks up the ancestor chain from node, selecting a parent only when all
+     * its descendants are in the set, deselecting it otherwise.
+     * @param node - starting node for the upward traversal
+     * @param set - mutable selection set updated in place
+     */
+    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; }; }, { "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 };
 export type { ButtonToggleInfo, FilePreviewDialogData, FilterGroup, FilterItem, ISelectableItem, PromptDateDialogResult, PromptDialogData, PromptDialogResult, PromptOtpDialogResult, PromptTimeDialogData, SelectDialogAppend, SelectDialogData, SelectDialogDelete, SelectDialogEdit, SelectDialogFilter, SelectDialogLookup, SelectDialogResult, SelectFile, SelectFileDialogData, SelectFileOption, SelectPictureFileDialogData, SelectTreeDialogAppend, SelectTreeDialogData, SelectTreeDialogResult, SelectableFilter, SendToDialogData, SendToDialogResult, SendToPopulateData };