@myrmidon/cadmus-refs-asserted-ids 10.0.17 → 11.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/cadmus-refs-asserted-ids",
-  "version": "10.0.17",
+  "version": "11.0.1",
   "description": "Cadmus - asserted IDs components.",
   "keywords": [
     "Cadmus",
@@ -15,13 +15,15 @@
     "name": "Daniele Fusi"
   },
   "peerDependencies": {
-    "@angular/common": "^20.0.0 || ^21.0.0",
-    "@angular/core": "^20.0.0 || ^21.0.0",
-    "@angular/material": "^20.0.0 || ^21.0.0",
-    "@myrmidon/ngx-mat-tools": "^1.0.2",
-    "@myrmidon/cadmus-api": "^14.0.7",
-    "@myrmidon/cadmus-refs-assertion": "^10.0.6",
-    "@myrmidon/cadmus-thesaurus-store": "^0.1.0"
+    "@angular/common": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "@angular/material": "^22.0.0",
+    "@myrmidon/ngx-mat-tools": "^2.0.0",
+    "@myrmidon/cadmus-api": "^15.0.0",
+    "@myrmidon/cadmus-refs-assertion": "^11.0.0",
+    "@myrmidon/cadmus-thesaurus-store": "^1.0.0",
+    "@myrmidon/taxo-store-api": "^1.0.1",
+    "@myrmidon/taxo-store-picker": "^1.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"
@@ -37,5 +39,6 @@
       "types": "./types/myrmidon-cadmus-refs-asserted-ids.d.ts",
       "default": "./fesm2022/myrmidon-cadmus-refs-asserted-ids.mjs"
     }
-  }
+  },
+  "type": "module"
 }

package/types/myrmidon-cadmus-refs-asserted-ids.d.ts

@@ -5,6 +5,8 @@ import { RamStorageService } from '@myrmidon/ngx-tools';
 import { Assertion } from '@myrmidon/cadmus-refs-assertion';
 import { Item, DataPinInfo, Part, IndexLookupDefinitions, IndexLookupDefinition, ThesaurusEntry } from '@myrmidon/cadmus-core';
 import { RefLookupService, RefLookupFilter, RefLookupConfig, LookupProviderOptions, RefLookupSetEvent } from '@myrmidon/cadmus-refs-lookup';
+import { TaxoStoreNode } from '@myrmidon/taxo-store-api';
+import { FlagOption } from '@myrmidon/taxo-store-picker';
 import { Observable } from 'rxjs';
 import { ItemService, ThesaurusService } from '@myrmidon/cadmus-api';
 import { MatSnackBar } from '@angular/material/snack-bar';
@@ -124,6 +126,19 @@ declare class PinTargetLookupComponent implements OnInit, OnDestroy {
      * The target to be edited.
      */
     readonly target: _angular_core.ModelSignal<PinTarget | undefined>;
+    /**
+     * True to hide the internal "external" target source checkbox,
+     * letting the parent component fully command the source mode via
+     * externalMode.
+     */
+    readonly hideTargetSelector: _angular_core.InputSignal<boolean>;
+    /**
+     * When set, commands whether the target source is external (true)
+     * or internal (false), overriding the internal heuristic based on
+     * the target's itemId. Leave unset to let this component decide on
+     * its own, as before.
+     */
+    readonly externalMode: _angular_core.InputSignal<boolean | undefined>;
     /**
      * The default value for part type key when the by-type mode is active.
      */
@@ -192,9 +207,50 @@ declare class PinTargetLookupComponent implements OnInit, OnDestroy {
     close(): void;
     save(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PinTargetLookupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PinTargetLookupComponent, "cadmus-pin-target-lookup", never, { "pinByTypeMode": { "alias": "pinByTypeMode"; "required": false; "isSignal": true; }; "canSwitchMode": { "alias": "canSwitchMode"; "required": false; "isSignal": true; }; "canEditTarget": { "alias": "canEditTarget"; "required": false; "isSignal": true; }; "lookupDefinitions": { "alias": "lookupDefinitions"; "required": false; "isSignal": true; }; "extLookupConfigs": { "alias": "extLookupConfigs"; "required": false; "isSignal": true; }; "lookupProviderOptions": { "alias": "lookupProviderOptions"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "defaultPartTypeKey": { "alias": "defaultPartTypeKey"; "required": false; "isSignal": true; }; }, { "pinByTypeMode": "pinByTypeModeChange"; "canSwitchMode": "canSwitchModeChange"; "lookupDefinitions": "lookupDefinitionsChange"; "target": "targetChange"; "editorClose": "editorClose"; "extMoreRequest": "extMoreRequest"; "extLookupConfigChange": "extLookupConfigChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PinTargetLookupComponent, "cadmus-pin-target-lookup", never, { "pinByTypeMode": { "alias": "pinByTypeMode"; "required": false; "isSignal": true; }; "canSwitchMode": { "alias": "canSwitchMode"; "required": false; "isSignal": true; }; "canEditTarget": { "alias": "canEditTarget"; "required": false; "isSignal": true; }; "lookupDefinitions": { "alias": "lookupDefinitions"; "required": false; "isSignal": true; }; "extLookupConfigs": { "alias": "extLookupConfigs"; "required": false; "isSignal": true; }; "lookupProviderOptions": { "alias": "lookupProviderOptions"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "hideTargetSelector": { "alias": "hideTargetSelector"; "required": false; "isSignal": true; }; "externalMode": { "alias": "externalMode"; "required": false; "isSignal": true; }; "defaultPartTypeKey": { "alias": "defaultPartTypeKey"; "required": false; "isSignal": true; }; }, { "pinByTypeMode": "pinByTypeModeChange"; "canSwitchMode": "canSwitchModeChange"; "lookupDefinitions": "lookupDefinitionsChange"; "target": "targetChange"; "editorClose": "editorClose"; "extMoreRequest": "extMoreRequest"; "extLookupConfigChange": "extLookupConfigChange"; }, never, never, true, never>;
 }
 
+/**
+ * The mode used to source the target of an asserted composite ID:
+ * - internal: the target points to a pin/item in this database.
+ * - external: the target is a free GID/label pair.
+ * - taxonomy: the target is picked from a taxonomy tree (TaxoStorePicker).
+ */
+type AssertedCompositeIdTargetMode = 'internal' | 'external' | 'taxonomy';
+/**
+ * The prefix prepended to the GID of any target sourced from a taxonomy
+ * tree, so that it can be told apart from a plain external GID when
+ * reloading an existing ID.
+ */
+declare const TAXONOMY_GID_PREFIX = "@TX:";
+/**
+ * The key used to retrieve the taxonomy lookup configurations via
+ * RamStorageService.
+ */
+declare const LOOKUP_TAXOSTORE_CONFIGS_KEY = "cadmus-refs-asserted-ids.taxostore-configs";
+/**
+ * Configuration for a taxonomy tree to be used as a lookup source for
+ * an asserted composite ID's target.
+ */
+interface TaxoStoreLookupConfig {
+    /**
+     * The ID of the taxonomy tree to pick nodes from.
+     */
+    treeId: string;
+    /**
+     * A human-friendly name for this source, used both in the source
+     * selector and as the label for the taxonomy lookup component.
+     */
+    treeName: string;
+    hasTopNodeFilter?: boolean;
+    hasFlagsFilter?: boolean;
+    availableFlags?: FlagOption[];
+    canEdit?: boolean;
+    canAdd?: boolean;
+    canDelete?: boolean;
+    hideLoc?: boolean;
+    hideFilter?: boolean;
+}
 /**
  * An asserted composite ID. This can be an external ID, having only the ID value
  * as its target.gid property; or a lookup ID, with a pin-based target.
@@ -210,7 +266,7 @@ interface AssertedCompositeId {
 }
 /**
  * An asserted composite ID editor. This allows the user to edit an asserted
- * composite ID, which can be an external ID or a lookup ID.
+ * composite ID, which can be an external ID, a lookup ID or a taxonomy ID.
  */
 declare class AssertedCompositeIdComponent {
     lookupService: PinRefLookupService;
@@ -219,6 +275,24 @@ declare class AssertedCompositeIdComponent {
     private _lookupConfigDirty;
     readonly extLookupConfigs: _angular_core.WritableSignal<RefLookupConfig[]>;
     readonly targetExpanded: _angular_core.WritableSignal<boolean>;
+    /**
+     * The taxonomy lookup configurations, if any.
+     */
+    readonly taxoLookupConfigs: _angular_core.WritableSignal<TaxoStoreLookupConfig[]>;
+    /**
+     * True if at least 1 taxonomy lookup configuration is available, so
+     * that the taxonomy source mode can be selected.
+     */
+    readonly hasTaxonomy: _angular_core.Signal<boolean>;
+    /**
+     * The currently selected target source mode.
+     */
+    readonly targetMode: _angular_core.WritableSignal<AssertedCompositeIdTargetMode>;
+    /**
+     * The taxonomy lookup configuration currently selected when
+     * targetMode is 'taxonomy'.
+     */
+    readonly selectedTaxoConfig: _angular_core.WritableSignal<TaxoStoreLookupConfig | undefined>;
     target: FormControl<PinTarget | null>;
     scope: FormControl<string | null>;
     tag: FormControl<string | null>;
@@ -289,7 +363,31 @@ declare class AssertedCompositeIdComponent {
     onEntriesChange(entries: ThesaurusEntry[]): void;
     onAssertionChange(assertion: Assertion | undefined): void;
     onTargetChange(target?: PinTarget): void;
+    /**
+     * Reset the target to an empty value without collapsing the target
+     * panel. This is used when switching source mode, as opposed to
+     * onTargetChange, which is used when the user has actually picked a
+     * target and the panel can be collapsed.
+     */
+    private resetTarget;
     private updateForm;
+    /**
+     * Detect the target source mode from the target itself, and update
+     * targetMode and selectedTaxoConfig accordingly.
+     */
+    private updateTargetMode;
+    /**
+     * Called when the user changes the target source mode.
+     */
+    onTargetModeChange(mode: AssertedCompositeIdTargetMode): void;
+    /**
+     * Called when the user changes the taxonomy tree to pick nodes from.
+     */
+    onTaxoConfigChange(config: TaxoStoreLookupConfig): void;
+    /**
+     * Called when the user picks a node from the taxonomy picker.
+     */
+    onTaxoNodePick(node: TaxoStoreNode | null): void;
     private getId;
     emitIdChange(): void;
     onEditorClose(): void;
@@ -503,5 +601,5 @@ declare class ScopedPinLookupComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScopedPinLookupComponent, "cadmus-scoped-pin-lookup", never, { "lookupProviderOptions": { "alias": "lookupProviderOptions"; "required": false; "isSignal": true; }; }, { "idPick": "idPick"; }, never, never, true, never>;
 }
 
-export { AssertedCompositeIdComponent, AssertedCompositeIdsComponent, AssertedIdComponent, AssertedIdsComponent, ItemRefLookupService, PinRefLookupService, PinTargetLookupComponent, ScopedPinLookupComponent };
-export type { AssertedCompositeId, AssertedId, PinLookupData, PinRefLookupFilter, PinTarget };
+export { AssertedCompositeIdComponent, AssertedCompositeIdsComponent, AssertedIdComponent, AssertedIdsComponent, ItemRefLookupService, LOOKUP_TAXOSTORE_CONFIGS_KEY, PinRefLookupService, PinTargetLookupComponent, ScopedPinLookupComponent, TAXONOMY_GID_PREFIX };
+export type { AssertedCompositeId, AssertedCompositeIdTargetMode, AssertedId, PinLookupData, PinRefLookupFilter, PinTarget, TaxoStoreLookupConfig };