@myrmidon/gve-core 6.1.5 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/gve-core",
-  "version": "6.1.5",
+  "version": "7.0.0",
   "description": "Cadmus - GVE Angular frontend core components.",
   "keywords": [
     "GVE"
@@ -14,14 +14,14 @@
     "name": "Daniele Fusi"
   },
   "peerDependencies": {
-    "@angular/common": "^21.2.7",
-    "@angular/core": "^21.2.7",
-    "@angular/material": "^21.2.5",
+    "@angular/common": "^21.2.10",
+    "@angular/core": "^21.2.10",
+    "@angular/material": "^21.2.8",
     "@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",
-    "gsap": "^3.14.2",
+    "@myrmidon/gve-snapshot-rendition": "^1.0.1",
+    "gsap": "^3.15.0",
     "monaco-editor": "^0.34.1",
     "nanoid": "^5.1.7"
   },

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.
      */
-    taggedNodes: {
-        [key: string]: CharNode[];
+    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.
+     */
+    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[];
     };
 }
 /**
@@ -818,6 +822,12 @@ interface FeatureDefinitions {
  * - ▶️ `operation` (`CharChainOperation`): the operation to edit.
  * - ▶️ `snapshot` (`Snapshot`): the snapshot the operation refers to.
  * - ▶️ `hidePreview` (`boolean`): whether to hide the preview request button.
+ * - ▶️ `sourceIds` (`LabeledId[]`): the list of source IDs, when using a closed list.
+ * - ▶️ `sourceTypes` (`LabeledId[]`): the list of source types, when using a closed list.
+ * - ▶️ `featureDefs` (`FeatureDefinitions`): definitions for features, including
+ * names and values.
+ * - ▶️ `rangePatch` (`BaseTextRange`): when set, the edited operation's text
+ * range (at and run) will be patched with the provided one.
  * - 🔥 `operationChange` (`CharChainOperation`): emitted when the operation
  * is changed.
  * - 🔥 `operationPreview` (`CharChainOperation`): emitted when the operation
@@ -892,6 +902,14 @@ declare class ChainOperationEditorComponent implements OnInit, OnDestroy {
      * values to it. Passed down to feature editors.
      */
     readonly multiValuedFeatureIds: _angular_core.InputSignal<string[] | undefined>;
+    /**
+     * The list of source IDs when it's a closed set.
+     */
+    readonly sourceIds: _angular_core.InputSignal<LabeledId[] | undefined>;
+    /**
+     * The list of source types when it's a closed set.
+     */
+    readonly sourceTypes: _angular_core.InputSignal<LabeledId[] | undefined>;
     /**
      * Emitted when the operation is changed.
      */
@@ -949,7 +967,7 @@ declare class ChainOperationEditorComponent implements OnInit, OnDestroy {
     requestPreview(): void;
     save(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChainOperationEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChainOperationEditorComponent, "gve-chain-operation-editor", never, { "operation": { "alias": "operation"; "required": false; "isSignal": true; }; "snapshot": { "alias": "snapshot"; "required": false; "isSignal": true; }; "hidePreview": { "alias": "hidePreview"; "required": false; "isSignal": true; }; "featureDefs": { "alias": "featureDefs"; "required": false; "isSignal": true; }; "rangePatch": { "alias": "rangePatch"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; }, { "operation": "operationChange"; "operationChange": "operationChange"; "operationPreview": "operationPreview"; "operationCancel": "operationCancel"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChainOperationEditorComponent, "gve-chain-operation-editor", never, { "operation": { "alias": "operation"; "required": false; "isSignal": true; }; "snapshot": { "alias": "snapshot"; "required": false; "isSignal": true; }; "hidePreview": { "alias": "hidePreview"; "required": false; "isSignal": true; }; "featureDefs": { "alias": "featureDefs"; "required": false; "isSignal": true; }; "rangePatch": { "alias": "rangePatch"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; "sourceIds": { "alias": "sourceIds"; "required": false; "isSignal": true; }; "sourceTypes": { "alias": "sourceTypes"; "required": false; "isSignal": true; }; }, { "operation": "operationChange"; "operationChange": "operationChange"; "operationPreview": "operationPreview"; "operationCancel": "operationCancel"; }, never, never, true, never>;
 }
 
 /**
@@ -988,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
@@ -1205,6 +1232,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.
  */
@@ -1259,6 +1294,18 @@ declare class SnapshotEditorComponent {
      * values to it. Passed down to feature editors.
      */
     readonly multiValuedFeatureIds: _angular_core.InputSignal<string[] | undefined>;
+    /**
+     * 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.
+     */
+    readonly sourceIds: _angular_core.InputSignal<LabeledId[] | undefined>;
+    /**
+     * 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.
+     */
+    readonly sourceTypes: _angular_core.InputSignal<LabeledId[] | undefined>;
     /**
      * Settings for rendering the snapshot. These are passed to the snapshot rendition
      * component.
@@ -1475,7 +1522,7 @@ declare class SnapshotEditorComponent {
      */
     save(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SnapshotEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SnapshotEditorComponent, "gve-snapshot-editor", never, { "snapshot": { "alias": "snapshot"; "required": false; "isSignal": true; }; "batchOps": { "alias": "batchOps"; "required": false; "isSignal": true; }; "noSave": { "alias": "noSave"; "required": false; "isSignal": true; }; "debug": { "alias": "debug"; "required": false; "isSignal": true; }; "noDecoration": { "alias": "noDecoration"; "required": false; "isSignal": true; }; "featureDefs": { "alias": "featureDefs"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; "renditionSettings": { "alias": "renditionSettings"; "required": false; "isSignal": true; }; "opListMaxHeight": { "alias": "opListMaxHeight"; "required": false; "isSignal": true; }; }, { "snapshot": "snapshotChange"; "snapshotCancel": "snapshotCancel"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SnapshotEditorComponent, "gve-snapshot-editor", never, { "snapshot": { "alias": "snapshot"; "required": false; "isSignal": true; }; "batchOps": { "alias": "batchOps"; "required": false; "isSignal": true; }; "noSave": { "alias": "noSave"; "required": false; "isSignal": true; }; "debug": { "alias": "debug"; "required": false; "isSignal": true; }; "noDecoration": { "alias": "noDecoration"; "required": false; "isSignal": true; }; "featureDefs": { "alias": "featureDefs"; "required": false; "isSignal": true; }; "multiValuedFeatureIds": { "alias": "multiValuedFeatureIds"; "required": false; "isSignal": true; }; "sourceIds": { "alias": "sourceIds"; "required": false; "isSignal": true; }; "sourceTypes": { "alias": "sourceTypes"; "required": false; "isSignal": true; }; "renditionSettings": { "alias": "renditionSettings"; "required": false; "isSignal": true; }; "opListMaxHeight": { "alias": "opListMaxHeight"; "required": false; "isSignal": true; }; }, { "snapshot": "snapshotChange"; "snapshotCancel": "snapshotCancel"; }, never, never, true, never>;
 }
 
 /**