@myrmidon/cadmus-ui 15.1.0 → 15.1.2

package/index.d.ts

@@ -1,10 +1,12 @@
 import * as _angular_core 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, Part, Fragment, PartIdentity, FragmentIdentity, EditedObject } from '@myrmidon/cadmus-core';
+import * as _myrmidon_cadmus_core 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 { 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';
@@ -229,6 +231,76 @@ 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;
@@ -344,7 +416,6 @@ declare function getPartIdName(typeId: string, roleId?: string | null, typeThesa
  */
 declare class PartBadgeComponent {
     private _facetService;
-    private _colorService;
     /**
      * The badge type: 0=part and role, 1=part only, 2=role only.
      */
@@ -361,20 +432,31 @@ declare class PartBadgeComponent {
      * The part type IDs.
      */
     readonly partTypeIds: _angular_core.InputSignal<PartTypeIds | undefined>;
-    readonly typeName: _angular_core.WritableSignal<string | undefined>;
-    readonly roleName: _angular_core.WritableSignal<string | undefined>;
-    readonly color: _angular_core.WritableSignal<string>;
-    readonly contrastColor: _angular_core.WritableSignal<string>;
-    constructor(_facetService: FacetService, _colorService: ColorService);
+    /**
+     * The part type name.
+     */
+    readonly typeName: _angular_core.Signal<string | undefined>;
+    /**
+     * The part role name.
+     */
+    readonly roleName: _angular_core.Signal<string | undefined>;
+    /**
+     * The part badge color.
+     */
+    readonly color: _angular_core.Signal<string>;
+    /**
+     * The part definition matching the part type ID and role ID.
+     */
+    readonly partDefinition: _angular_core.Signal<_myrmidon_cadmus_core.PartDefinition | undefined>;
+    constructor(_facetService: FacetService);
     private getPartColor;
     /**
      * Get the role's human-friendly name from its ID.
      * @param roleId The role ID.
      * @param typeThesaurus The types thesaurus.
-     * @returns The name.?
+     * @returns The name or undefined.
      */
     private getRoleIdName;
-    private updateBadge;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PartBadgeComponent, never>;
     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>;
 }
@@ -645,5 +727,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, StaticThesPagedTreeStoreService, ThesPagedTreeBrowserComponent, ThesaurusTreeComponent, UserRefLookupService, extractPristineChanges, extractTouchedChanges, getPartIdName, renderLabelFromLastColon };
+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.1.0",
+  "version": "15.1.2",
   "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": {