@myrmidon/gve-core 6.1.6 → 7.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/gve-core",
-  "version": "6.1.6",
+  "version": "7.0.1",
   "description": "Cadmus - GVE Angular frontend core components.",
   "keywords": [
     "GVE"
@@ -14,16 +14,16 @@
     "name": "Daniele Fusi"
   },
   "peerDependencies": {
-    "@angular/common": "^21.2.9",
-    "@angular/core": "^21.2.9",
-    "@angular/material": "^21.2.6",
+    "@angular/common": "^21.2.11",
+    "@angular/core": "^21.2.11",
+    "@angular/material": "^21.2.9",
     "@cisstech/nge": "^18.3.0",
     "@myrmidon/ngx-mat-tools": "^1.0.2",
-    "@myrmidon/ngx-tools": "^2.0.2",
-    "@myrmidon/gve-snapshot-rendition": "^0.0.8",
+    "@myrmidon/ngx-tools": "^2.0.3",
+    "@myrmidon/gve-snapshot-rendition": "^1.0.2",
     "gsap": "^3.15.0",
     "monaco-editor": "^0.34.1",
-    "nanoid": "^5.1.7"
+    "nanoid": "^5.1.11"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/myrmidon-gve-core.d.ts

@@ -108,11 +108,13 @@ interface CharChainOperation extends OperationMetadata {
  */
 interface CharNode {
     id: number;
-    index: number;
+    index?: number;
     label: string;
     data: string;
     sourceTag?: string;
-    features?: Feature[];
+    features?: {
+        [tag: string]: Feature[];
+    } | null;
 }
 /**
  * A text snapshot, including the base text and the operations that
@@ -431,17 +433,6 @@ interface ChainOperationContextStep {
      * version.
      */
     result?: string;
-    /**
-     * The features emitted up to the executed operation.
-     * These are the features of the text as a whole, and
-     * those belonging to specific nodes, each keyed under
-     * a string built with `v` + output version tag + `_`
-     * + node ID (e.g. `v1_2` for node with ID 2 at version 1).
-     */
-    featureSet: {
-        features: OperationFeature[];
-        nodeFeatures: Record<string, OperationFeature[]>;
-    };
     /**
      * The reference node IDs of the operation which was
      * executed.
@@ -471,14 +462,27 @@ interface CharChainResult {
      */
     chainTags: string[];
     /**
-     * The sets of nodes in their order, for each version tag.
-     * These nodes are collected by following the path defined
-     * by the set of links of each version tag; so each of the
-     * sets contains only the nodes used at that step to build
-     * the text version, with their features up to that stage.
+     * All nodes in the chain regardless of version, including deleted
+     * nodes. Each node's `features` is keyed by version tag; the value
+     * is the list of features for that node at that version. `features`
+     * is `null` when the node has no features in any version.
+     */
+    nodes: CharNode[];
+    /**
+     * For each version tag (including v0), the ordered sequence of node
+     * IDs that make up that version's text. Use together with `nodes`
+     * (looked up by `id`) to reconstruct any version.
      */
-    taggedNodes: {
-        [key: string]: CharNode[];
+    versionNodeIds: {
+        [tag: string]: number[];
+    };
+    /**
+     * For each version tag (including v0), the accumulated global
+     * (chain-level) features at the end of that version.
+     * The v0 entry is always an empty array.
+     */
+    globalFeatures: {
+        [tag: string]: OperationFeature[];
     };
 }
 /**
@@ -1002,6 +1006,15 @@ declare class ChainResultViewComponent implements OnInit, OnDestroy, AfterViewIn
     readonly selection: _angular_core.WritableSignal<string | undefined>;
     readonly selectionFeatures: _angular_core.WritableSignal<OperationFeature[]>;
     readonly selectionRange: _angular_core.WritableSignal<BaseTextRange | undefined>;
+    /**
+     * Ordered nodes for the current step's version, resolved from
+     * `result.versionNodeIds` and `result.nodes`.
+     */
+    readonly stepNodes: _angular_core.Signal<CharNode[]>;
+    /**
+     * Global features for the current step's output version.
+     */
+    readonly stepGlobalFeatures: _angular_core.Signal<OperationFeature[]>;
     /**
      * True to disable range picking. For instance the snapshot editor,
      * which uses rangePick to set the edited operation's range, disables
@@ -1057,6 +1070,9 @@ declare class ChainResultViewComponent implements OnInit, OnDestroy, AfterViewIn
  * will allow adding multiple values to it.
  * - ▶️ `isVar`: true if the feature is a variant operation feature, which
  * has additional properties like negation, global, and short-lived.
+ * - ▶️ `hasCloseButton`: true if a close button should be shown to allow closing
+ * the editor.
+ * - 🔥 `close`: emitted when the user clicks the close button.
  * - 🔥 `featuresChange` (`Feature[]`): emitted when features have changed.
  */
 declare class FeatureSetEditorComponent implements OnInit, OnDestroy {
@@ -1091,6 +1107,15 @@ declare class FeatureSetEditorComponent implements OnInit, OnDestroy {
      * values to it.
      */
     readonly multiValuedFeatureIds: _angular_core.InputSignal<string[] | undefined>;
+    /**
+     * True if a close button should be shown to allow closing the editor
+     * without saving.
+     */
+    readonly hasCloseButton: _angular_core.InputSignal<boolean>;
+    /**
+     * Emitted when the user clicks the close button.
+     */
+    readonly close: _angular_core.OutputEmitterRef<void>;
     /**
      * The features to edit.
      */
@@ -1110,7 +1135,7 @@ declare class FeatureSetEditorComponent implements OnInit, OnDestroy {
     onFeatureChange(feature?: Feature | OperationFeature): void;
     onFeatureCancel(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FeatureSetEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FeatureSetEditorComponent, "gve-feature-set-editor", never, { "isVar": { "alias": "isVar"; "required": false; "isSignal": true; }; "featNames": { "alias": "featNames"; "required": false; "isSignal": true; }; "featValues": { "alias": "featValues"; "required": false; "isSignal": true; }; "filterThreshold": { "alias": "filterThreshold"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; "features": { "alias": "features"; "required": false; "isSignal": true; }; }, { "features": "featuresChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FeatureSetEditorComponent, "gve-feature-set-editor", never, { "isVar": { "alias": "isVar"; "required": false; "isSignal": true; }; "featNames": { "alias": "featNames"; "required": false; "isSignal": true; }; "featValues": { "alias": "featValues"; "required": false; "isSignal": true; }; "filterThreshold": { "alias": "filterThreshold"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; "hasCloseButton": { "alias": "hasCloseButton"; "required": false; "isSignal": true; }; "features": { "alias": "features"; "required": false; "isSignal": true; }; }, { "close": "close"; "features": "featuresChange"; }, never, never, true, never>;
 }
 
 /**
@@ -1219,6 +1244,14 @@ declare class OperationSourceEditorComponent {
  * - ▶️ `snapshot` (`Snapshot`): the snapshot to edit.
  * - ▶️ `batchOps` (`string`): the batch operations text to set for the editor.
  * - ▶️ `noSave` (`boolean`): true to disable saving.
+ * - ▶️ `debug` (`boolean`): true to enable debug mode for view rendition.
+ * - ▶️ `noDecoration` (`boolean`): true to not show character decoration according to the trace features in nodes.
+ * - ▶️ `featureDefs` (`FeatureDefinitions`): definitions for features, including names and values.
+ * - ▶️ `multiValuedFeatureIds` (`string[]`): the IDs of the features that are multi-valued. If a feature being edited is in this list, the feature editor will allow adding multiple values to it. Passed down to feature editors.
+ * - ▶️ `sourceIds` (`LabeledId[]`): the list of source IDs when it's a closed set. Passed down to the operation source editor, which will show a dropdown to select from these IDs. When not specified, the source ID can be freely typed in the source editor.
+ * - ▶️ `sourceTypes` (`LabeledId[]`): the list of source types when it's a closed set. Passed down to the operation source editor, which will show a dropdown to select from these types. When not specified, the source type can be freely typed in the source editor.
+ * - ▶️ `renditionSettings` (`GveRenditionSettings`): settings for rendering the snapshot. These are passed to the snapshot rendition component.
+ * - ▶️ `opListMaxHeight` (`string`): optional maximum height for the operations list. When set, the operations list will have a vertical scrollbar if its content exceeds this height.
  * - 🔥 `snapshotChange` (`Snapshot`): emitted when the user saves the edited snapshot.
  * - 🔥 `snapshotCancel` (`void`): emitted when the user cancels the snapshot editing.
  */
@@ -1325,6 +1358,11 @@ declare class SnapshotEditorComponent {
     readonly result: _angular_core.WritableSignal<CharChainResult | undefined>;
     readonly resultOperationId: _angular_core.WritableSignal<string | undefined>;
     readonly initialStepIndex: _angular_core.WritableSignal<number>;
+    readonly editFeatsRange: FormControl<string | null>;
+    readonly editFeatsForm: FormGroup;
+    readonly operationFeats: _angular_core.WritableSignal<Feature[] | undefined>;
+    readonly featsOpNumbers: _angular_core.WritableSignal<number[] | undefined>;
+    readonly featsRangeLabel: _angular_core.WritableSignal<string | undefined>;
     constructor(formBuilder: FormBuilder, _api: GveApiService, _dialog: MatDialog, _dialogService: DialogService, _snackbar: MatSnackBar);
     /**
      * Initialize rendition settings and event listeners when the element becomes available.
@@ -1369,6 +1407,21 @@ declare class SnapshotEditorComponent {
      * @param index The operation index.
      */
     editOperation(index: number): void;
+    /**
+     * Parse a range string into a sorted array of 1-based operation ordinal
+     * numbers. Accepts comma-separated segments where each segment is either
+     * a single number N or a range N-M (N ≤ M). Returns null when any segment
+     * is syntactically invalid or out of bounds.
+     */
+    private parseOpRange;
+    /**
+     * Open a feature set editor to edit all features of the operations
+     * specified by the editFeatsRange form control value.
+     * Supports comma-separated segments like "2, 5-7, 9".
+     */
+    editOperationsFeats(): void;
+    saveOperationsFeats(features: Feature[]): void;
+    closeOperationFeats(): void;
     /**
      * Close the currently edited operation.
      */