@myrmidon/gve-core 5.0.0 → 5.0.2

package/index.d.ts

@@ -1,8 +1,8 @@
 import { MatDialogConfig, MatDialogRef, MatDialog } from '@angular/material/dialog';
 import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy, AfterViewInit, ElementRef } from '@angular/core';
+import { OnInit, OnDestroy, ElementRef, AfterViewInit } from '@angular/core';
 import { FormControl, FormGroup, FormBuilder } from '@angular/forms';
-import { GveAnimationTimeline, GveAnimationTween, TweenType, CharNode, Feature, CharChainOperation, OperationFeature, SnapshotBase, OperationSource, OperationType, LabeledId, FeatureSetPolicy, SnapshotViewComponent, Snapshot, SnapshotViewData, GveVisualEvent, SnapshotViewRenderEvent } from '@myrmidon/gve-snapshot-view';
+import { GveAnimationTimeline, GveAnimationTween, TweenType, CharNode, Feature, CharChainOperation, OperationFeature, LabeledId, FeatureSetPolicy, SnapshotBase, OperationSource, OperationType, SnapshotViewComponent, Snapshot, SnapshotViewData, GveVisualEvent, SnapshotViewRenderEvent } from '@myrmidon/gve-snapshot-view';
 import { DialogService } from '@myrmidon/ngx-mat-tools';
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
@@ -250,7 +250,7 @@ interface VarBaseTextRange {
  * - 🔥 `rangePick` (`VarBaseTextRange`): emitted when a range is picked.
  */
 declare class BaseTextViewComponent {
-    private _lastSelectedChar?;
+    private _lastSelectedPosition?;
     /**
      * The default color for the text.
      */
@@ -291,11 +291,31 @@ declare class BaseTextViewComponent {
      * The range is inclusive.
      */
     readonly rangePick: _angular_core.OutputEmitterRef<VarBaseTextRange>;
-    readonly lines: _angular_core.WritableSignal<BaseTextChar[][]>;
+    /**
+     * The base characters organized by lines, computed from text input.
+     */
+    private readonly baseLines;
+    /**
+     * Signal for tracking selected range state.
+     */
+    private readonly selectedRange;
+    /**
+     * The lines with selection state applied, computed from base lines and selection.
+     */
+    readonly lines: _angular_core.Signal<BaseTextChar[][]>;
     constructor();
     private buildLines;
-    private resetColors;
     onCharPick(event: BaseTextCharEvent): void;
+    /**
+     * Find the position (index in flat array) of a character by its ID.
+     * Returns -1 if not found.
+     */
+    private findCharPosition;
+    /**
+     * Get the character ID at a specific position in the flat array.
+     * Returns the ID or -1 if position is out of bounds.
+     */
+    private getCharIdAtPosition;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseTextViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BaseTextViewComponent, "gve-base-text-view", never, { "defaultColor": { "alias": "defaultColor"; "required": false; "isSignal": true; }; "defaultBorderColor": { "alias": "defaultBorderColor"; "required": false; "isSignal": true; }; "selectionColor": { "alias": "selectionColor"; "required": false; "isSignal": true; }; "hasLineNumber": { "alias": "hasLineNumber"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "colorCallback": { "alias": "colorCallback"; "required": false; "isSignal": true; }; "borderColorCallback": { "alias": "borderColorCallback"; "required": false; "isSignal": true; }; }, { "charPick": "charPick"; "rangePick": "rangePick"; }, never, never, true, never>;
 }
@@ -606,6 +626,97 @@ declare class SettingsService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<SettingsService>;
 }
 
+/**
+ * Features map. This is used for features from closed sets,
+ * and lists the possible values for each feature.
+ * The key is the feature name, and the value is an array of
+ * labeled IDs representing the allowed values for that feature.
+ */
+interface FeatureMap {
+    [key: string]: LabeledId[];
+}
+/**
+ * 🔑 `gve-feature-editor`
+ *
+ * Component for editing a single feature, whose model is a name=value
+ * pair, plus a set policy value which defines the desired behavior
+ * when adding that feature to a set.
+ * Used by `gve-feature-set-editor`.
+ *
+ * - ▶️ `feature` (`Feature`): the feature to edit.
+ * - ▶️ `featNames` (`LabeledId[]`): the list of feature names to display
+ * in the _name_ selection. This is used when you have a closed list of
+ * features. Each item in the list is an object with _id_ and _label_
+ * properties.
+ * - ▶️ `featValues` (`FeatureMap`): the feature values map. When
+ * specified and the user selects a feature name present in the map keys,
+ * the corresponding values will be used to populate the value selection.
+ * - 🔥 `featureChange` (`Feature`): emitted when feature has changed.
+ * - 🔥 `featureCancel`: emitted when the user cancels the feature editing.
+ */
+declare class FeatureEditorComponent implements OnInit, OnDestroy {
+    private _sub?;
+    private _frozen?;
+    nameControl?: ElementRef;
+    /**
+     * The list of feature names to display in the name selection.
+     * This is used when you have a closed list of features.
+     */
+    readonly featNames: _angular_core.InputSignal<LabeledId[] | undefined>;
+    /**
+     * The feature values map. When specified and the user selects a feature
+     * name present in the map keys, the corresponding values will be used
+     * to populate the value selection.
+     */
+    readonly featValues: _angular_core.InputSignal<FeatureMap | undefined>;
+    /**
+     * The feature to edit.
+     */
+    readonly feature: _angular_core.ModelSignal<Feature | OperationFeature | undefined>;
+    /**
+     * True if the feature is a variant operation feature, which has
+     * additional properties like negation, global, and short-lived.
+     */
+    readonly isVar: _angular_core.InputSignal<boolean>;
+    /**
+     * Event emitted when the user cancels the feature editing.
+     */
+    readonly featureCancel: _angular_core.OutputEmitterRef<void>;
+    readonly nameIds: _angular_core.WritableSignal<LabeledId[] | undefined>;
+    name: FormControl<string>;
+    value: FormControl<string>;
+    setPolicy: FormControl<FeatureSetPolicy>;
+    isNegated: FormControl<boolean>;
+    isGlobal: FormControl<boolean>;
+    isShortLived: FormControl<boolean>;
+    form: FormGroup;
+    constructor(formBuilder: FormBuilder);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private getLabeledIdsFor;
+    private updateForm;
+    cancel(): void;
+    save(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FeatureEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FeatureEditorComponent, "gve-feature-editor", never, { "featNames": { "alias": "featNames"; "required": false; "isSignal": true; }; "featValues": { "alias": "featValues"; "required": false; "isSignal": true; }; "feature": { "alias": "feature"; "required": false; "isSignal": true; }; "isVar": { "alias": "isVar"; "required": false; "isSignal": true; }; }, { "feature": "featureChange"; "featureCancel": "featureCancel"; }, never, never, true, never>;
+}
+
+/**
+ * Definitions for features, including names and values.
+ */
+interface FeatureDefinitions {
+    /**
+     * The list of feature names to display in the name selection.
+     * This is used when you have a closed list of features.
+     */
+    names?: LabeledId[];
+    /**
+     * The feature values map. When specified and the user selects a feature
+     * name present in the map keys, the corresponding values will be used
+     * to populate the value selection.
+     */
+    values?: FeatureMap;
+}
 /**
  * 🔑 `gve-chain-operation-editor`
  *
@@ -677,6 +788,22 @@ declare class ChainOperationEditorComponent implements OnInit, OnDestroy {
      * Whether to hide the preview request button.
      */
     readonly hidePreview: _angular_core.InputSignal<boolean | undefined>;
+    /**
+     * Definitions for features, including names and values.
+     */
+    readonly featureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
+    /**
+     * Definitions for element features, including names and values.
+     */
+    readonly elementFeatureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
+    /**
+     * Definitions for diplomatic features, including names and values.
+     */
+    readonly diplomaticFeatureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
+    /**
+     * Set when the edited operation's text range is to be patched.
+     */
+    readonly rangePatch: _angular_core.InputSignal<VarBaseTextRange | undefined>;
     /**
      * Emitted when the operation is changed.
      */
@@ -720,6 +847,7 @@ declare class ChainOperationEditorComponent implements OnInit, OnDestroy {
     constructor(formBuilder: FormBuilder, _clipboard: Clipboard, _settings: SettingsService, _dialogService: DialogService);
     ngOnInit(): void;
     ngOnDestroy(): void;
+    private toggleLfEscape;
     private hasTextChanges;
     onCreateEditor(editor: monaco.editor.IEditor): void;
     onFeaturesChange(features: OperationFeature[]): void;
@@ -746,7 +874,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; }; }, { "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; }; "elementFeatureDefs": { "alias": "elementFeatureDefs"; "required": false; "isSignal": true; }; "diplomaticFeatureDefs": { "alias": "diplomaticFeatureDefs"; "required": false; "isSignal": true; }; "rangePatch": { "alias": "rangePatch"; "required": false; "isSignal": true; }; }, { "operation": "operationChange"; "operationChange": "operationChange"; "operationPreview": "operationPreview"; "operationCancel": "operationCancel"; }, never, never, true, never>;
 }
 
 /**
@@ -784,6 +912,17 @@ declare class ChainResultViewComponent implements OnInit, OnDestroy, AfterViewIn
     readonly step: _angular_core.WritableSignal<ChainOperationContextStep | undefined>;
     readonly selection: _angular_core.WritableSignal<string | undefined>;
     readonly selectionFeatures: _angular_core.WritableSignal<OperationFeature[]>;
+    readonly selectionRange: _angular_core.WritableSignal<VarBaseTextRange | undefined>;
+    /**
+     * True to disable range picking. For instance the snapshot editor,
+     * which uses rangePick to set the edited operation's range, disables
+     * this when no operation is being edited.
+     */
+    readonly disabledRangePick: _angular_core.InputSignal<boolean>;
+    /**
+     * Emitted when a range is picked.
+     */
+    readonly rangePick: _angular_core.OutputEmitterRef<VarBaseTextRange>;
     versionTag: FormControl<string | null>;
     tag: FormControl<string | null>;
     constructor(formBuilder: FormBuilder);
@@ -801,8 +940,9 @@ declare class ChainResultViewComponent implements OnInit, OnDestroy, AfterViewIn
     onTextCharPick(event: BaseTextCharEvent): void;
     onTextRangePick(range: VarBaseTextRange): void;
     onStepChange(step?: ChainOperationContextStep): void;
+    pickRange(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChainResultViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChainResultViewComponent, "gve-chain-result-view", never, { "result": { "alias": "result"; "required": false; "isSignal": true; }; "initialStepIndex": { "alias": "initialStepIndex"; "required": false; "isSignal": true; }; }, { "stepPick": "stepPick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChainResultViewComponent, "gve-chain-result-view", never, { "result": { "alias": "result"; "required": false; "isSignal": true; }; "initialStepIndex": { "alias": "initialStepIndex"; "required": false; "isSignal": true; }; "disabledRangePick": { "alias": "disabledRangePick"; "required": false; "isSignal": true; }; }, { "stepPick": "stepPick"; "rangePick": "rangePick"; }, never, never, true, never>;
 }
 
 type GraphvizRankdir = 'TB' | 'LR' | 'BT' | 'RL';
@@ -859,81 +999,6 @@ declare class ChainViewComponent implements OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChainViewComponent, "gve-chain-view", never, { "chain": { "alias": "chain"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "selectedTags": { "alias": "selectedTags"; "required": false; "isSignal": true; }; }, { "selectedTags": "selectedTagsChange"; }, never, never, true, never>;
 }
 
-/**
- * Features map. This is used for features from closed sets,
- * and lists the possible values for each feature.
- * The key is the feature name, and the value is an array of
- * labeled IDs representing the allowed values for that feature.
- */
-interface FeatureMap {
-    [key: string]: LabeledId[];
-}
-/**
- * 🔑 `gve-feature-editor`
- *
- * Component for editing a single feature, whose model is a name=value
- * pair, plus a set policy value which defines the desired behavior
- * when adding that feature to a set.
- * Used by `gve-feature-set-editor`.
- *
- * - ▶️ `feature` (`Feature`): the feature to edit.
- * - ▶️ `featNames` (`LabeledId[]`): the list of feature names to display
- * in the _name_ selection. This is used when you have a closed list of
- * features. Each item in the list is an object with _id_ and _label_
- * properties.
- * - ▶️ `featValues` (`FeatureMap`): the feature values map. When
- * specified and the user selects a feature name present in the map keys,
- * the corresponding values will be used to populate the value selection.
- * - 🔥 `featureChange` (`Feature`): emitted when feature has changed.
- * - 🔥 `featureCancel`: emitted when the user cancels the feature editing.
- */
-declare class FeatureEditorComponent implements OnInit, OnDestroy {
-    private _sub?;
-    private _frozen?;
-    nameControl?: ElementRef;
-    /**
-     * The list of feature names to display in the name selection.
-     * This is used when you have a closed list of features.
-     */
-    readonly featNames: _angular_core.InputSignal<LabeledId[] | undefined>;
-    /**
-     * The feature values map. When specified and the user selects a feature
-     * name present in the map keys, the corresponding values will be used
-     * to populate the value selection.
-     */
-    readonly featValues: _angular_core.InputSignal<FeatureMap | undefined>;
-    /**
-     * The feature to edit.
-     */
-    readonly feature: _angular_core.ModelSignal<Feature | OperationFeature | undefined>;
-    /**
-     * True if the feature is a variant operation feature, which has
-     * additional properties like negation, global, and short-lived.
-     */
-    readonly isVar: _angular_core.InputSignal<boolean>;
-    /**
-     * Event emitted when the user cancels the feature editing.
-     */
-    readonly featureCancel: _angular_core.OutputEmitterRef<void>;
-    readonly nameIds: _angular_core.WritableSignal<LabeledId[] | undefined>;
-    name: FormControl<string>;
-    value: FormControl<string>;
-    setPolicy: FormControl<FeatureSetPolicy>;
-    isNegated: FormControl<boolean>;
-    isGlobal: FormControl<boolean>;
-    isShortLived: FormControl<boolean>;
-    form: FormGroup;
-    constructor(formBuilder: FormBuilder);
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    private getLabeledIdsFor;
-    private updateForm;
-    cancel(): void;
-    save(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FeatureEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FeatureEditorComponent, "gve-feature-editor", never, { "featNames": { "alias": "featNames"; "required": false; "isSignal": true; }; "featValues": { "alias": "featValues"; "required": false; "isSignal": true; }; "feature": { "alias": "feature"; "required": false; "isSignal": true; }; "isVar": { "alias": "isVar"; "required": false; "isSignal": true; }; }, { "feature": "featureChange"; "featureCancel": "featureCancel"; }, never, never, true, never>;
-}
-
 /**
  * 🔑 `gve-feature-set-editor`
  *
@@ -960,7 +1025,8 @@ declare class FeatureSetEditorComponent implements OnInit, OnDestroy {
     private _sub?;
     readonly POLICIES: string[];
     /**
-     * True if the features are variable features.
+     * True if the feature is a variant operation feature, which has
+     * additional properties like negation, global, and short-lived.
      */
     readonly isVar: _angular_core.InputSignal<boolean>;
     /**
@@ -1184,6 +1250,18 @@ declare class SnapshotEditorComponent {
      * features in nodes.
      */
     readonly noDecoration: _angular_core.InputSignal<boolean | undefined>;
+    /**
+     * Definitions for features, including names and values.
+     */
+    readonly featureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
+    /**
+     * Definitions for element features, including names and values.
+     */
+    readonly elementFeatureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
+    /**
+     * Definitions for diplomatic features, including names and values.
+     */
+    readonly diplomaticFeatureDefs: _angular_core.InputSignal<FeatureDefinitions | undefined>;
     /**
      * Emitted when the user cancels the snapshot editing.
      */
@@ -1211,6 +1289,7 @@ declare class SnapshotEditorComponent {
     defs: FormControl<string | null>;
     timelines: FormControl<GveAnimationTimeline[]>;
     readonly showChain: FormControl<boolean>;
+    readonly featDetails: FormControl<boolean>;
     readonly chain: _angular_core.WritableSignal<CharChain | undefined>;
     readonly opTags: _angular_core.WritableSignal<string[]>;
     readonly opElementIds: _angular_core.WritableSignal<string[]>;
@@ -1218,6 +1297,7 @@ declare class SnapshotEditorComponent {
     readonly lineCount: _angular_core.WritableSignal<number>;
     readonly editedOp: _angular_core.WritableSignal<CharChainOperation | undefined>;
     readonly editedOpIndex: _angular_core.WritableSignal<number>;
+    readonly editedOpRangePatch: _angular_core.WritableSignal<VarBaseTextRange | undefined>;
     readonly busy: _angular_core.WritableSignal<boolean>;
     readonly opTypeMap: {
         0: string;
@@ -1255,8 +1335,9 @@ declare class SnapshotEditorComponent {
     /**
      * Handle the event fired by the base text editor to pick a text range.
      * @param range The picked range.
+     * @param applyToOp True to also apply the picked range to the edited operation.
      */
-    onRangePick(range?: VarBaseTextRange): void;
+    onRangePick(range?: VarBaseTextRange, applyToOp?: boolean): void;
     /**
      * Update the lists of operation output tags and element IDs by collecting
      * all the operation tags and the IDs of the elements in their diplomatic.g
@@ -1421,7 +1502,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; }; }, { "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; }; "elementFeatureDefs": { "alias": "elementFeatureDefs"; "required": false; "isSignal": true; }; "diplomaticFeatureDefs": { "alias": "diplomaticFeatureDefs"; "required": false; "isSignal": true; }; }, { "snapshot": "snapshotChange"; "snapshotCancel": "snapshotCancel"; }, never, never, true, never>;
 }
 
 /**
@@ -1499,4 +1580,4 @@ declare class StepsMapComponent implements AfterViewInit {
 }
 
 export { AnimationTimelineComponent, AnimationTimelineSetComponent, AnimationTweenComponent, BaseTextCharComponent, BaseTextEditorComponent, BaseTextViewComponent, BatchOperationEditorComponent, ChainOperationEditorComponent, ChainResultViewComponent, ChainViewComponent, FeatureEditorComponent, FeatureSetEditorComponent, FeatureSetViewComponent, GveApiService, GveGraphvizService, LnHeightsEditorComponent, OperationSourceEditorComponent, SettingsService, SnapshotEditorComponent, SnapshotTextEditorComponent, StepsMapComponent };
-export type { BaseTextChar, BaseTextCharEvent, ChainOperationContextStep, ChainOperationTags, CharChain, CharChainLink, CharChainNode, CharChainResult, FeatureMap, GraphvizRankdir, PayloadMatDialogConfig, ResultWrapper, VarBaseTextRange };
+export type { BaseTextChar, BaseTextCharEvent, ChainOperationContextStep, ChainOperationTags, CharChain, CharChainLink, CharChainNode, CharChainResult, FeatureDefinitions, FeatureMap, GraphvizRankdir, PayloadMatDialogConfig, ResultWrapper, VarBaseTextRange };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/gve-core",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "Cadmus - GVE Angular frontend core components.",
   "keywords": [
     "GVE"
@@ -20,10 +20,10 @@
     "@cisstech/nge": "^18.2.1",
     "@myrmidon/ngx-mat-tools": "^1.0.0",
     "@myrmidon/ngx-tools": "^2.0.0",
-    "@myrmidon/gve-snapshot-view": "^1.2.0",
+    "@myrmidon/gve-snapshot-view": "^1.2.1",
     "@svgdotjs/svg.js": "^3.2.5",
     "gsap": "^3.13.0",
-    "monaco-editor": "^0.53.0",
+    "monaco-editor": "^0.54.0",
     "nanoid": "^5.1.5"
   },
   "dependencies": {