@myrmidon/cadmus-ui 15.0.0 → 15.1.1

package/index.d.ts

@@ -1,12 +1,14 @@
 import * as _angular_core from '@angular/core';
-import { OnInit, ElementRef, OnDestroy } from '@angular/core';
+import { OnInit, ElementRef, OnDestroy, Type } from '@angular/core';
 import { FormGroup, UntypedFormGroup, FormArray, FormControl, FormBuilder, UntypedFormControl, UntypedFormBuilder, ValidatorFn, AbstractControl } from '@angular/forms';
-import { TokenLocation, TextLayerService, FacetDefinition, FlagDefinition, LayerHint, DataPinInfo, IndexLookupDefinitions, Thesaurus, PartTypeIds, ThesaurusEntry, Part, Fragment, PartIdentity, FragmentIdentity, EditedObject } from '@myrmidon/cadmus-core';
+import { TokenLocation, TextLayerService, FacetDefinition, FlagDefinition, LayerHint, DataPinInfo, IndexLookupDefinitions, ThesaurusEntry as ThesaurusEntry$1, Thesaurus, PartTypeIds, Part, Fragment, PartIdentity, FragmentIdentity, EditedObject } from '@myrmidon/cadmus-core';
 import { DialogService } from '@myrmidon/ngx-mat-tools';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { ItemService, FacetService, UserService } from '@myrmidon/cadmus-api';
-import { NestedTreeControl } from '@angular/cdk/tree';
-import { MatTreeNestedDataSource } from '@angular/material/tree';
+import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import { PagedTreeStoreService, TreeNodeFilter, PagedTreeNode, PagedTreeStore, PageChangeRequest } from '@myrmidon/paged-data-browsers';
+import { DataPage } from '@myrmidon/ngx-tools';
+import { MatDialogRef } from '@angular/material/dialog';
 import { AuthJwtService, User } from '@myrmidon/auth-jwt-login';
 import { AppRepository } from '@myrmidon/cadmus-state';
 import { RefLookupService, RefLookupFilter } from '@myrmidon/cadmus-refs-lookup';
@@ -228,6 +230,168 @@ declare class LookupPinComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LookupPinComponent, "cadmus-lookup-pin", never, { "initialValue": { "alias": "initialValue"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "limit": { "alias": "limit"; "required": false; "isSignal": true; }; "resetOnPick": { "alias": "resetOnPick"; "required": false; "isSignal": true; }; "lookupKey": { "alias": "lookupKey"; "required": false; "isSignal": true; }; }, { "entryChange": "entryChange"; }, never, never, true, never>;
 }
 
+/**
+ * The prefix added to custom entries' IDs.
+ */
+declare const CUSTOM_ENTRY_PREFIX = "$";
+/**
+ * A picker component for thesaurus entries.
+ * This component allows picking one or more entries from a given thesaurus.
+ * In its collapsed state, it shows the picked entries as chips; when
+ * expanded, it shows the thesaurus tree to pick from. Custom entries
+ * (not in the thesaurus) can be optionally allowed.
+ */
+declare class ThesEntriesPickerComponent {
+    /**
+     * The thesaurus entries to pick from (required).
+     */
+    readonly availableEntries: _angular_core.InputSignal<ThesaurusEntry$1[]>;
+    /**
+     * The picked entries.
+     */
+    readonly entries: _angular_core.ModelSignal<ThesaurusEntry$1[]>;
+    /**
+     * True to show the entries with labels shortened according to
+     * their hierarchy.
+     */
+    readonly hierarchicLabels: _angular_core.InputSignal<boolean>;
+    /**
+     * True to automatically sort entries (disables drag-and-drop).
+     * When false, entries can be manually reordered via drag-and-drop.
+     */
+    readonly autoSort: _angular_core.InputSignal<boolean>;
+    /**
+     * True to allow custom values (not in the entries list).
+     */
+    readonly allowCustom: _angular_core.InputSignal<boolean>;
+    /**
+     * The minimum number of entries to pick.
+     */
+    readonly minEntries: _angular_core.InputSignal<number>;
+    /**
+     * The maximum number of entries to pick (0=unlimited).
+     */
+    readonly maxEntries: _angular_core.InputSignal<number>;
+    /**
+     * True when the picker is expanded (showing the entries list).
+     */
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    /**
+     * The message to show when there are no picked entries.
+     */
+    readonly emptyMessage: _angular_core.InputSignal<string>;
+    /**
+     * The number of remaining entries that can be picked (0=unlimited).
+     * This is displayed only if maxEntries > 1.
+     */
+    readonly remaining: _angular_core.Signal<number>;
+    id: FormControl<string>;
+    value: FormControl<string>;
+    form: FormGroup;
+    constructor(formBuilder: FormBuilder);
+    renderLabel: (label: string) => string;
+    private sortEntries;
+    onEntryChange(entry: ThesaurusEntry$1): void;
+    addCustomEntry(): void;
+    removeEntry(entry: ThesaurusEntry$1): void;
+    clear(): void;
+    onDrop(event: CdkDragDrop<ThesaurusEntry$1[]>): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThesEntriesPickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThesEntriesPickerComponent, "cadmus-thes-entries-picker", never, { "availableEntries": { "alias": "availableEntries"; "required": true; "isSignal": true; }; "entries": { "alias": "entries"; "required": false; "isSignal": true; }; "hierarchicLabels": { "alias": "hierarchicLabels"; "required": false; "isSignal": true; }; "autoSort": { "alias": "autoSort"; "required": false; "isSignal": true; }; "allowCustom": { "alias": "allowCustom"; "required": false; "isSignal": true; }; "minEntries": { "alias": "minEntries"; "required": false; "isSignal": true; }; "maxEntries": { "alias": "maxEntries"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; }, { "entries": "entriesChange"; "expanded": "expandedChange"; }, never, never, true, never>;
+}
+
+interface ThesaurusEntry {
+    id: string;
+    value: string;
+}
+/**
+ * The filter for thesaurus entry nodes. The only filtered property is
+ * the node's label.
+ */
+interface ThesEntryNodeFilter extends TreeNodeFilter {
+    label?: string;
+}
+/**
+ * The tree node for thesaurus entries in a paging tree node.
+ */
+interface ThesEntryPagedTreeNode extends PagedTreeNode<ThesEntryNodeFilter> {
+    key: string;
+    value: string;
+}
+/**
+ * A label rendering function which removes from a label
+ * all the characters past the last colon, trimming the result.
+ * This is a typical rendering when dealing with hierarchical
+ * thesaurus entries, e.g. "furniture: table: color", where
+ * we can shorten the label to just "color", as "furniture"
+ * and "table" are its ancestors.
+ */
+declare const renderLabelFromLastColon: (label: string) => string;
+/**
+ * A static paged tree store service for thesaurus entries.
+ * This builds the tree nodes from the thesaurus entries, assuming
+ * that entry IDs are hierarchical and separated by dots (.).
+ */
+declare class StaticThesPagedTreeStoreService implements PagedTreeStoreService<ThesEntryNodeFilter> {
+    private _renderLabel?;
+    private _nodes;
+    private _built;
+    private readonly _entries;
+    constructor(entries: ThesaurusEntry[], _renderLabel?: ((label: string) => string) | undefined);
+    private ensureNodes;
+    /**
+     * Get the specified page of nodes.
+     * @param filter The filter.
+     * @param pageNumber The page number.
+     * @param pageSize The page size.
+     * @param hasMockRoot Whether the root node is a mock node. Not used here.
+     */
+    getNodes(filter: ThesEntryNodeFilter, pageNumber: number, pageSize: number, hasMockRoot?: boolean): Observable<DataPage<ThesEntryPagedTreeNode>>;
+}
+
+declare class ThesPagedTreeBrowserComponent implements OnInit, OnDestroy {
+    private _dialog;
+    private _sub?;
+    /**
+     * The service to use to load the nodes.
+     */
+    readonly service: _angular_core.InputSignal<StaticThesPagedTreeStoreService>;
+    /**
+     * Emitted when a node is clicked.
+     */
+    readonly nodePick: _angular_core.OutputEmitterRef<ThesEntryPagedTreeNode>;
+    /**
+     * The store instance, built from the service.
+     */
+    readonly store: _angular_core.Signal<PagedTreeStore<ThesEntryPagedTreeNode, ThesEntryNodeFilter>>;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    debug: FormControl<boolean>;
+    hideLoc: FormControl<boolean>;
+    hideFilter: FormControl<boolean>;
+    filter$: Observable<Readonly<ThesEntryNodeFilter>>;
+    nodes$: Observable<Readonly<ThesEntryPagedTreeNode[]>>;
+    label: FormControl<string | null>;
+    form: FormGroup<{
+        label: FormControl<string | null>;
+    }>;
+    constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    reset(): void;
+    onToggleExpanded(node: ThesEntryPagedTreeNode): void;
+    onPageChangeRequest(request: PageChangeRequest): void;
+    onFilterChange(filter: ThesEntryNodeFilter | null | undefined): void;
+    onEditFilterRequest(node: ThesEntryPagedTreeNode): void;
+    expandAll(): void;
+    collapseAll(): void;
+    clear(): void;
+    onNodeClick(node: ThesEntryPagedTreeNode): void;
+    findLabels(): void;
+    removeHilites(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThesPagedTreeBrowserComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThesPagedTreeBrowserComponent, "cadmus-thes-paged-tree-browser", never, { "service": { "alias": "service"; "required": false; "isSignal": true; }; }, { "nodePick": "nodePick"; }, never, never, true, never>;
+}
+
 declare enum PartBadgeType {
     partAndRole = 0,
     partOnly = 1,
@@ -286,23 +450,29 @@ declare class PartBadgeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PartBadgeComponent, "cadmus-part-badge", never, { "badgeType": { "alias": "badgeType"; "required": false; "isSignal": true; }; "typeThesaurus": { "alias": "typeThesaurus"; "required": false; "isSignal": true; }; "facetDefinition": { "alias": "facetDefinition"; "required": false; "isSignal": true; }; "partTypeIds": { "alias": "partTypeIds"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-interface TreeNode {
-    id: string;
-    label: string;
-    originalLabel?: string;
-    parent?: TreeNode;
-    children?: TreeNode[];
-    clickable?: boolean;
-}
 /**
- * A label rendering function which removes from a label
- * all the characters past the last colon, trimming the result.
- * This is a typical rendering when dealing with hierarchical
- * thesaurus entries, e.g. "furniture: table: color", where
- * we can shorten the label to just "color", as "furniture"
- * and "table" are its ancestors.
+ * A filter to be used for thesaurus paged tree browsers.
  */
-declare const renderLabelFromLastColon: (label: string) => string;
+declare class ThesPagedTreeFilterComponent implements OnInit {
+    readonly dialogRef: MatDialogRef<ThesPagedTreeFilterComponent, any> | null;
+    readonly data: any;
+    /**
+     * The filter.
+     */
+    readonly filter: _angular_core.ModelSignal<ThesEntryNodeFilter | null | undefined>;
+    readonly wrapped: _angular_core.WritableSignal<boolean>;
+    label: FormControl<string | null>;
+    form: FormGroup;
+    constructor();
+    ngOnInit(): void;
+    private updateForm;
+    private getFilter;
+    reset(): void;
+    apply(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThesPagedTreeFilterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThesPagedTreeFilterComponent, "cadmus-thes-paged-tree-filter", never, { "filter": { "alias": "filter"; "required": false; "isSignal": true; }; }, { "filter": "filterChange"; }, never, never, true, never>;
+}
+
 /**
  * Thesaurus tree component.
  * This component displays a set of hierarchical thesaurus entries
@@ -316,54 +486,30 @@ declare const renderLabelFromLastColon: (label: string) => string;
  * event is emitted. Note that even if you specify a label renderer
  * function, the event always emits the original label.
  */
-declare class ThesaurusTreeComponent implements OnInit {
+declare class ThesaurusTreeComponent {
     /**
      * The thesaurus entries.
      */
     readonly entries: _angular_core.InputSignal<ThesaurusEntry[] | undefined>;
-    /**
-     * The label for the root node.
-     */
-    readonly rootLabel: _angular_core.InputSignal<string>;
     /**
      * The optional node label rendering function.
      */
-    readonly renderLabel: _angular_core.InputSignal<((label: string) => string) | undefined>;
+    readonly renderLabel: _angular_core.InputSignal<(label: string) => string>;
     /**
      * Fired when a thesaurus entry is selected.
      */
     readonly entryChange: _angular_core.OutputEmitterRef<ThesaurusEntry>;
-    root: TreeNode;
-    treeControl: NestedTreeControl<TreeNode>;
-    treeDataSource: MatTreeNestedDataSource<TreeNode>;
-    filter: FormControl<string | null>;
-    form: FormGroup;
-    foundNodes: TreeNode[] | undefined;
-    hasChildren: (index: number, node: TreeNode) => boolean | undefined;
-    isRoot: (index: number, node: TreeNode) => boolean;
-    constructor(formBuilder: FormBuilder);
-    ngOnInit(): void;
-    private initTree;
-    private getLabel;
-    private addNode;
-    /**
-     * Build a tree model from a list of name=value pairs,
-     * where each value can include one or more components separated by
-     * the specified separator.
-     * @param entries The entries to add.
-     * @param separator string The separator string to use for values.
-     */
-    buildTreeModel(entries: ThesaurusEntry[], separator?: string): TreeNode;
-    onTreeNodeClick(node: TreeNode): void;
-    expandAll(): void;
-    collapseAll(): void;
-    private expandFromNode;
-    private expandMatchingNodes;
-    find(): void;
-    resetFilter(): void;
-    isFoundNode(node: TreeNode): boolean;
+    /**
+     * The tree store service, dependent on the current entries and renderLabel.
+     */
+    readonly service: _angular_core.Signal<StaticThesPagedTreeStoreService>;
+    /**
+     * The filter component class to use.
+     */
+    readonly filterComponent: Type<ThesPagedTreeFilterComponent>;
+    onNodePick(node: ThesEntryPagedTreeNode): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThesaurusTreeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThesaurusTreeComponent, "cadmus-thesaurus-tree", never, { "entries": { "alias": "entries"; "required": false; "isSignal": true; }; "rootLabel": { "alias": "rootLabel"; "required": false; "isSignal": true; }; "renderLabel": { "alias": "renderLabel"; "required": false; "isSignal": true; }; }, { "entryChange": "entryChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThesaurusTreeComponent, "cadmus-thesaurus-tree", never, { "entries": { "alias": "entries"; "required": false; "isSignal": true; }; "renderLabel": { "alias": "renderLabel"; "required": false; "isSignal": true; }; }, { "entryChange": "entryChange"; }, never, never, true, never>;
 }
 
 /**
@@ -570,5 +716,5 @@ declare const extractTouchedChanges: (control: ObjectLike<AbstractControl, "mark
  */
 declare const extractPristineChanges: (control: ObjectLike<AbstractControl, "markAsPristine" | "markAsDirty">) => Observable<boolean>;
 
-export { CloseSaveButtonsComponent, ColorService, CustomValidators, DecoratedTokenTextComponent, ErrorListComponent, FacetBadgeComponent, FlagsBadgeComponent, JsonValidators, LayerHintsComponent, LookupPinComponent, ModelEditorComponentBase, PartBadgeComponent, PartBadgeType, ThesaurusTreeComponent, UserRefLookupService, extractPristineChanges, extractTouchedChanges, getPartIdName, renderLabelFromLastColon };
-export type { ArgumentsType, FacetBadgeData, FlagsBadgeData, UserWithRoles };
+export { CUSTOM_ENTRY_PREFIX, CloseSaveButtonsComponent, ColorService, CustomValidators, DecoratedTokenTextComponent, ErrorListComponent, FacetBadgeComponent, FlagsBadgeComponent, JsonValidators, LayerHintsComponent, LookupPinComponent, ModelEditorComponentBase, PartBadgeComponent, PartBadgeType, StaticThesPagedTreeStoreService, ThesEntriesPickerComponent, ThesPagedTreeBrowserComponent, ThesaurusTreeComponent, UserRefLookupService, extractPristineChanges, extractTouchedChanges, getPartIdName, renderLabelFromLastColon };
+export type { ArgumentsType, FacetBadgeData, FlagsBadgeData, ThesEntryNodeFilter, ThesEntryPagedTreeNode, ThesaurusEntry, UserWithRoles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/cadmus-ui",
-  "version": "15.0.0",
+  "version": "15.1.1",
   "description": "Cadmus - general UI components.",
   "keywords": [
     "Cadmus"
@@ -18,7 +18,7 @@
     "@angular/core": "^20.0.0",
     "@angular/material": "^20.0.0",
     "@myrmidon/ngx-tools": "^2.0.0",
-    "@myrmidon/cadmus-refs-lookup": "^10.0.3",
+    "@myrmidon/cadmus-refs-lookup": "^10.0.5",
     "@myrmidon/cadmus-core": "^12.0.2"
   },
   "dependencies": {