@arsedizioni/ars-utils 22.5.38 → 22.5.39

package/types/arsedizioni-ars-utils-ui.controls.tree.d.ts

@@ -0,0 +1,136 @@
+import * as _angular_forms_signals from '@angular/forms/signals';
+import * as _angular_core from '@angular/core';
+import { INode } from '@arsedizioni/ars-utils/core';
+
+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>;
+    /** 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>;
+    /**
+     * List of node IDs at depth >= maxDepth that unlock selection for themselves
+     * and all their descendants, regardless of depth.
+     */
+    readonly maxDepthOverrides: _angular_core.InputSignal<string[]>;
+    /**
+     * 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;
+    private readonly _elRef;
+    /**
+     * Set of all node IDs selectable via overrides: each listed root and all its descendants.
+     * Recomputed whenever the tree data or the override list changes.
+     */
+    private readonly _overrideSubtreeSet;
+    /** 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 selectable levels (depth < maxDepth or in overrides), shown in the tab label. */
+    protected readonly selectedVisibleCount: _angular_core.Signal<number>;
+    readonly treeChildrenAccessor: (node: INode) => INode[];
+    readonly hasChild: (_: number, node: INode) => boolean;
+    /** Returns true when the node can be selected: depth < maxDepth or explicitly listed in maxDepthOverrides. */
+    protected isSelectable(node: INode): boolean;
+    private _isSelectableNode;
+    /** Current filter text. */
+    protected readonly filterText: _angular_core.WritableSignal<string>;
+    /** Root signal form bound to the filter text input. */
+    protected readonly filterForm: _angular_forms_signals.FieldTree<string, string | number, "writable">;
+    /** 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;
+    /** Collapses all nodes in the tree. */
+    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
+     * @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 only the selectable descendants of node (depth < maxDepth or in overrides),
+     * used for indeterminate state and parent auto-selection logic.
+     * @param node - root of the subtree to traverse
+     * @returns flat array of selectable descendant INodes
+     */
+    private _getSelectableDescendants;
+    /**
+     * 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; }; "descriptionEmpty": { "alias": "descriptionEmpty"; "required": false; "isSignal": true; }; "maxDepth": { "alias": "maxDepth"; "required": false; "isSignal": true; }; "maxDepthOverrides": { "alias": "maxDepthOverrides"; "required": false; "isSignal": true; }; "minDepth": { "alias": "minDepth"; "required": false; "isSignal": true; }; }, { "selection": "selectionChange"; "selectionCount": "selectionCount"; "changed": "changed"; }, never, never, true, never>;
+}
+
+export { TreePickerComponent };

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

@@ -459,7 +459,7 @@ declare class NavigationBarComponent {
      * `compact` wraps the icon only (56x32 pill), `wide` wraps icon and label
      * together, exactly as described by the M3 Expressive specs.
      */
-    protected readonly indicatorMode: _angular_core.Signal<"compact" | "wide">;
+    protected readonly indicatorMode: _angular_core.Signal<"wide" | "compact">;
     /** Tooltip placement derived from the variant and from the anchoring edge. */
     protected readonly tooltipPosition: _angular_core.Signal<TooltipPosition>;
     /** Inline width override for the rail / drawer, or `undefined` to keep the spec default. */