@metadev/daga 1.4.2 → 1.5.0

package/index.d.ts

@@ -3,23 +3,23 @@ export { DagaModule } from './lib/daga.module';
 export { DiagramButtonsComponent } from './lib/diagram-buttons/diagram-buttons.component';
 export { DiagramEditorComponent } from './lib/diagram-editor/diagram-editor.component';
 export { CollabClient } from './lib/diagram-editor/diagram/collab/collab-client';
-export { CollabTimestamp as LogicalTimestamp } from './lib/diagram-editor/diagram/collab/primitives';
+export { CollabTimestamp, CollabTimestampSet } from './lib/diagram-editor/diagram/collab/primitives';
 export { DagaExporter } from './lib/diagram-editor/diagram/converters/daga-exporter';
 export { DagaImporter } from './lib/diagram-editor/diagram/converters/daga-importer';
 export { DagaModel } from './lib/diagram-editor/diagram/converters/daga-model';
 export { DiagramModelExporter } from './lib/diagram-editor/diagram/converters/diagram-model-exporter';
 export { DiagramModelImporter } from './lib/diagram-editor/diagram/converters/diagram-model-importer';
-export { ActionQueue, AddConnectionAction, AddNodeAction, DiagramAction, DiagramActions, EditFieldAction, MoveNodeAction, RemoveAction, StretchNodeAction, UpdateValuesAction } from './lib/diagram-editor/diagram/diagram-action';
+export { ActionQueue, AddConnectionAction, AddNodeAction, DiagramAction, DiagramActions, EditFieldAction, RemoveAction, SetGeometryAction, UpdateValuesAction } from './lib/diagram-editor/diagram/diagram-action';
 export { ACTION_QUEUE_SIZE, DiagramCanvas } from './lib/diagram-editor/diagram/diagram-canvas';
 export { ButtonsComponentConfig, ComponentsConfig, ConnectionMarkerLook, ConnectionTemplateConfig, ConnectionTypeConfig, DiagramConfig, ErrorsComponentConfig, FieldConfig, NodeImageLook, NodeShapedLook, NodeStretchableImageLook, NodeTemplateConfig, NodeTypeConfig, PaletteComponentConfig, PaletteSectionConfig, PortConfig, PropertyEditorComponentConfig, SectionConfig, SectionGridConfig, UserActionConfig } from './lib/diagram-editor/diagram/diagram-config';
 export { DiagramConnection, DiagramConnectionSet, DiagramConnectionType } from './lib/diagram-editor/diagram/diagram-connection';
 export { DiagramElement, DiagramEntity, DiagramEntitySet } from './lib/diagram-editor/diagram/diagram-element';
 export { DiagramField, DiagramFieldSet } from './lib/diagram-editor/diagram/diagram-field';
 export { DiagramModel } from './lib/diagram-editor/diagram/diagram-model';
-export { DiagramNode, DiagramNodeSet, DiagramNodeType } from './lib/diagram-editor/diagram/diagram-node';
+export { DiagramNode, DiagramNodeSet, DiagramNodeType, DiagramNodeGeometry } from './lib/diagram-editor/diagram/diagram-node';
 export { DiagramPort, DiagramPortSet } from './lib/diagram-editor/diagram/diagram-port';
 export { Property, PropertySet, Type, ValueSet } from './lib/diagram-editor/diagram/diagram-property';
-export { DiagramSection, DiagramSectionSet } from './lib/diagram-editor/diagram/diagram-section';
+export { DiagramSection, DiagramSectionSet, DiagramSectionGeometry } from './lib/diagram-editor/diagram/diagram-section';
 export { AdjacencyLayout } from './lib/diagram-editor/diagram/layout/adjacency-layout';
 export { BreadthAdjacencyLayout } from './lib/diagram-editor/diagram/layout/breadth-adjacency-layout';
 export { BreadthLayout } from './lib/diagram-editor/diagram/layout/breadth-layout';

package/lib/diagram-editor/diagram/collab/collab-action.d.ts

@@ -1,6 +1,8 @@
 import { Canvas } from '../../../interfaces/canvas';
 import { Point } from '../../../util/canvas-util';
 import { CollabTimestamp } from './primitives';
+import { DiagramNodeGeometry } from '../diagram-node';
+import { ValueSet } from '../diagram-property';
 /**
  * An action taken by a local or remote user.
  *
@@ -29,14 +31,14 @@ export interface CollabAction {
 /**
  * @private
  */
-export type CollabActionSerialized = AddNodeSerialized | MoveNodeSerialized;
+export type CollabActionSerialized = AddNodeSerialized | SetGeometrySerialized | AddConnectionSerialized | EditFieldSerialized | UpdateValuesSerialized | SetSelfRemovedSerialized;
 /**
  * @private
  */
 export type AddNodeSerialized = {
-    type: 'add';
+    type: 'addNode';
     id: string;
-    nodeTypeId: string;
+    typeId: string;
     coords: Point;
     label?: string;
     values?: {
@@ -49,17 +51,17 @@ export type AddNodeSerialized = {
  * @private
  */
 export declare class AddNodeCollabAction implements CollabAction {
-    canvas: Canvas;
-    id: string;
-    nodeTypeId: string;
-    coords: Point;
-    label?: string;
-    values?: {
+    readonly canvas: Canvas;
+    readonly id: string;
+    readonly typeId: string;
+    readonly coords: Point;
+    readonly label?: string | undefined;
+    readonly values?: {
         [key: string]: unknown;
-    };
-    constructor(canvas: Canvas, id: string, nodeTypeId: string, coords: Point, label?: string, values?: {
+    } | undefined;
+    constructor(canvas: Canvas, id: string, typeId: string, coords: Point, label?: string | undefined, values?: {
         [key: string]: unknown;
-    });
+    } | undefined);
     do(): void;
     serialize(): AddNodeSerialized;
     static deserialize(canvas: Canvas, serialized: AddNodeSerialized): AddNodeCollabAction;
@@ -67,24 +69,144 @@ export declare class AddNodeCollabAction implements CollabAction {
 /**
  * @private
  */
-export type MoveNodeSerialized = {
-    type: 'move';
+export type SetGeometrySerialized = {
+    type: 'setGeometry';
     nodeId: string;
-    to: Point;
+    to: DiagramNodeGeometry;
     timestamp: CollabTimestamp;
 };
 /**
- * Collaborative action which consists of moving a node.
- * @see MoveNodeAction
+ * Collaborative action which consists of changing a node's geometry: moving, stretching, or stretching sections.
+ * @see SetGeometryAction
  * @private
  */
-export declare class MoveNodeCollabAction implements CollabAction {
+export declare class SetGeometryCollabAction implements CollabAction {
     readonly canvas: Canvas;
     readonly nodeId: string;
-    readonly to: Point;
+    readonly to: DiagramNodeGeometry;
     readonly timestamp: CollabTimestamp;
-    constructor(canvas: Canvas, nodeId: string, to: Point, timestamp: CollabTimestamp);
+    constructor(canvas: Canvas, nodeId: string, to: DiagramNodeGeometry, timestamp: CollabTimestamp);
     do(): void;
-    serialize(): MoveNodeSerialized;
-    static deserialize(canvas: Canvas, serialized: MoveNodeSerialized): MoveNodeCollabAction;
+    serialize(): SetGeometrySerialized;
+    static deserialize(canvas: Canvas, serialized: SetGeometrySerialized): SetGeometryCollabAction;
+}
+/**
+ * @private
+ */
+export type AddConnectionSerialized = {
+    type: 'addConnection';
+    id: string;
+    typeId: string;
+    startId: string;
+    endId: string;
+};
+/**
+ * Collaborative action which consists of adding a connection.
+ * @see AddConnectionAction
+ * @private
+ */
+export declare class AddConnectionCollabAction implements CollabAction {
+    readonly canvas: Canvas;
+    readonly id: string;
+    readonly typeId: string;
+    readonly startId: string;
+    readonly endId: string;
+    constructor(canvas: Canvas, id: string, typeId: string, startId: string, endId: string);
+    do(): void;
+    serialize(): AddConnectionSerialized;
+    static deserialize(canvas: Canvas, serialized: AddConnectionSerialized): AddConnectionCollabAction;
+}
+/**
+ * @private
+ */
+export type EditFieldSerialized = {
+    type: 'editField';
+    fieldId: string;
+    to: string;
+    timestamp: CollabTimestamp;
+};
+/**
+ * Collaborative action which consists of editing the text of a field.
+ * @see EditFieldAction
+ * @private
+ */
+export declare class EditFieldCollabAction implements CollabAction {
+    readonly canvas: Canvas;
+    readonly fieldId: string;
+    readonly to: string;
+    readonly timestamp: CollabTimestamp;
+    constructor(canvas: Canvas, fieldId: string, to: string, timestamp: CollabTimestamp);
+    do(): void;
+    serialize(): EditFieldSerialized;
+    static deserialize(canvas: Canvas, serialized: EditFieldSerialized): EditFieldCollabAction;
+}
+/**
+ * @private
+ */
+export type UpdateValuesSerialized = {
+    type: 'updateValues';
+    id: string | undefined;
+    to: {
+        [key: string]: unknown;
+    };
+    timestamp: CollabTimestamp;
+};
+/**
+ * Collaborative action which consists of editing the values of a value set.
+ * @see UpdateValuesAction
+ * @private
+ */
+export declare class UpdateValuesCollabAction implements CollabAction {
+    readonly canvas: Canvas;
+    readonly id: string | undefined;
+    readonly to: {
+        [key: string]: unknown;
+    };
+    readonly timestamp: CollabTimestamp;
+    constructor(canvas: Canvas, id: string | undefined, to: {
+        [key: string]: unknown;
+    }, timestamp: CollabTimestamp);
+    getValueSet(): ValueSet | undefined;
+    do(): void;
+    serialize(): UpdateValuesSerialized;
+    static deserialize(canvas: Canvas, serialized: UpdateValuesSerialized): UpdateValuesCollabAction;
+}
+/**
+ * @private
+ */
+export type SetSelfRemovedSerialized = {
+    type: 'setSelfRemoved';
+    nodeIds: string[];
+    sectionIds: string[];
+    portIds: string[];
+    connectionIds: string[];
+    fieldIds: string[];
+    removed: boolean;
+    timestamp: CollabTimestamp;
+};
+/**
+ * Collaborative action which consists of removing or un-removing elements.
+ *
+ * Specifically, the action sets the `selfRemoved` field for elements that are
+ * explicitly removed/unremoved. This causes the `removed` fields for those elements
+ * and their transitive dependents to update automatically.
+ * For example, self-removing a node also removes all of its sections/connections/etc.
+ *
+ * @see RemoveAction
+ * @private
+ */
+export declare class SetSelfRemovedCollabAction implements CollabAction {
+    readonly canvas: Canvas;
+    readonly nodeIds: string[];
+    readonly sectionIds: string[];
+    readonly portIds: string[];
+    readonly connectionIds: string[];
+    readonly fieldIds: string[];
+    readonly selfRemoved: boolean;
+    readonly timestamp: CollabTimestamp;
+    constructor(canvas: Canvas, nodeIds: string[], sectionIds: string[], portIds: string[], connectionIds: string[], fieldIds: string[], selfRemoved: boolean, timestamp: CollabTimestamp);
+    private doOne;
+    do(): void;
+    serialize(): CollabActionSerialized;
+    static deserialize(canvas: Canvas, serialized: SetSelfRemovedSerialized): SetSelfRemovedCollabAction;
 }

package/lib/diagram-editor/diagram/collab/primitives.d.ts

@@ -9,7 +9,14 @@ export type CollabTimestamp = [clock: number, replicaId: string];
 /**
  * Returns whether the incoming timestamp wins over the existing timestamp.
  *
- * In the DiagramModel, timestamps that have never been set are left undefined;
+ * In the DiagramModel, timestamps that have never been set are left null;
  * `timestampWins` treats that as an "initial timestamp" that loses to all LogicalTimestamps.
  */
-export declare function timestampWins(incoming: CollabTimestamp, existing: CollabTimestamp | undefined): boolean;
+export declare function timestampWins(incoming: CollabTimestamp, existing: CollabTimestamp | null | undefined): boolean;
+/**
+ * A nested collection of CollabTimestamps associated to a ValueSet.
+ * @see ValueSet
+ */
+export type CollabTimestampSet = {
+    [key: string]: CollabTimestamp | CollabTimestampSet;
+};

package/lib/diagram-editor/diagram/converters/daga-exporter.d.ts

@@ -6,5 +6,5 @@ import { DiagramModelExporter } from './diagram-model-exporter';
  * @public
  */
 export declare class DagaExporter implements DiagramModelExporter<DagaModel> {
-    export(model: DiagramModel): DagaModel;
+    export(model: DiagramModel, includeCollabMeta?: boolean): DagaModel;
 }

package/lib/diagram-editor/diagram/converters/daga-model.d.ts

@@ -1,6 +1,6 @@
 import { Point } from '../../../util/canvas-util';
 import { Side } from '../../../util/svg-util';
-import { CollabTimestamp } from '../collab/primitives';
+import { CollabTimestamp, CollabTimestampSet } from '../collab/primitives';
 export declare const DAGA_FILE_VERSION = 1;
 /**
  * Representation of a diagram model in a serialized format.
@@ -19,7 +19,6 @@ export interface DagaModel {
     createdAt: Date;
     updatedAt: Date;
     updatedDaysAgo?: string;
-    logicalClock?: number;
     nodes: {
         id: string;
         type: string;
@@ -30,6 +29,17 @@ export interface DagaModel {
                 coords: Point;
                 direction: Side;
                 label: string;
+                collabMeta?: {
+                    removed: boolean;
+                    selfRemoved: boolean;
+                    selfRemovedTimestamp: CollabTimestamp | null;
+                    label?: {
+                        removed: boolean;
+                        selfRemoved: boolean;
+                        selfRemovedTimestamp: CollabTimestamp | null;
+                        textTimestamp: CollabTimestamp | null;
+                    };
+                };
             }[];
             label: string;
             indexXInNode: number;
@@ -37,21 +47,55 @@ export interface DagaModel {
             coords: Point;
             width: number;
             height: number;
+            collabMeta?: {
+                removed: boolean;
+                selfRemoved: boolean;
+                selfRemovedTimestamp: CollabTimestamp | null;
+                label?: {
+                    removed: boolean;
+                    selfRemoved: boolean;
+                    selfRemovedTimestamp: CollabTimestamp | null;
+                    textTimestamp: CollabTimestamp | null;
+                };
+            };
         }[];
         ports?: {
             id: string;
             coords: Point;
             direction: Side;
             label: string;
+            collabMeta?: {
+                removed: boolean;
+                selfRemoved: boolean;
+                selfRemovedTimestamp: CollabTimestamp | null;
+                label?: {
+                    removed: boolean;
+                    selfRemoved: boolean;
+                    selfRemovedTimestamp: CollabTimestamp | null;
+                    textTimestamp: CollabTimestamp | null;
+                };
+            };
         }[];
         label: string;
         coords: Point;
-        coordsTimestamp?: CollabTimestamp;
         width: number;
         height: number;
         data: {
             [key: string]: unknown;
         };
+        collabMeta?: {
+            removed: boolean;
+            selfRemoved: boolean;
+            selfRemovedTimestamp: CollabTimestamp | null;
+            geometryTimestamp: CollabTimestamp | null;
+            dataTimestamps: CollabTimestampSet;
+            label?: {
+                removed: boolean;
+                selfRemoved: boolean;
+                selfRemovedTimestamp: CollabTimestamp | null;
+                textTimestamp: CollabTimestamp | null;
+            };
+        };
     }[];
     connections: {
         id: string;
@@ -65,8 +109,18 @@ export interface DagaModel {
         data: {
             [key: string]: unknown;
         };
+        collabMeta?: {
+            removed: boolean;
+            selfRemoved: boolean;
+            selfRemovedTimestamp: CollabTimestamp | null;
+            dataTimestamps: CollabTimestampSet;
+        };
     }[];
     data: {
         [key: string]: unknown;
     };
+    collabMeta?: {
+        logicalClock: number;
+        dataTimestamps: CollabTimestampSet;
+    };
 }

package/lib/diagram-editor/diagram/diagram-action.d.ts

@@ -1,10 +1,7 @@
 import { Canvas } from '../../interfaces/canvas';
 import { Point } from '../../util/canvas-util';
-import { Side } from '../../util/svg-util';
 import { DiagramConnectionType } from './diagram-connection';
-import { DiagramModel } from './diagram-model';
-import { DiagramNodeType } from './diagram-node';
-import { ValueSet } from './diagram-property';
+import { DiagramNodeType, DiagramNodeGeometry } from './diagram-node';
 /**
  * A queue of recent actions taken by the user that can be undone and redone.
  * @private
@@ -96,7 +93,7 @@ export declare enum DiagramActions {
     EditField = "edit-field",
     /**
      * Action that corresponds to moving a node.
-     * @see MoveNodeAction
+     * @see SetGeometryAction
      * @public
      */
     MoveNode = "move-node",
@@ -108,13 +105,13 @@ export declare enum DiagramActions {
     Remove = "remove",
     /**
      * Action that corresponds to altering a node's dimensions.
-     * @see StretchNodeAction
+     * @see SetGeometryActionAction
      * @public
      */
     StretchNode = "stretch-node",
     /**
      * Action that corresponds to altering a sections's dimensions.
-     * @see StretchSectionAction
+     * @see SetGeometryAction
      * @public
      */
     StretchSection = "stretch-section",
@@ -152,48 +149,17 @@ export declare class AddNodeAction implements DiagramAction {
     redo(): void;
 }
 /**
- * Action which consists of moving a node.
+ * Action which consists of changing a node's geometry: moving, stretching, or stretching sections.
  * @see DiagramNode
  * @private
  */
-export declare class MoveNodeAction implements DiagramAction {
+export declare class SetGeometryAction implements DiagramAction {
     canvas: Canvas;
+    intent: DiagramActions.MoveNode | DiagramActions.StretchNode | DiagramActions.StretchSection;
     nodeId: string;
-    from: Point;
-    to: Point;
-    constructor(canvas: Canvas, nodeId: string, from: Point, to: Point);
-    do(): void;
-    undo(): void;
-    redo(): void;
-}
-/**
- * Action which consists of changing the dimensions of a node in a given direction.
- * @see DiagramNode
- * @private
- */
-export declare class StretchNodeAction implements DiagramAction {
-    canvas: Canvas;
-    nodeId: string;
-    direction: Side;
-    from: number;
-    to: number;
-    constructor(canvas: Canvas, nodeId: string, direction: Side, from: number, to: number);
-    do(): void;
-    undo(): void;
-    redo(): void;
-}
-/**
- * Action which consists of changing the dimensions of a section in a given direction.
- * @see DiagramSection
- * @private
- */
-export declare class StretchSectionAction implements DiagramAction {
-    canvas: Canvas;
-    sectionId: string;
-    direction: Side;
-    from: number;
-    to: number;
-    constructor(canvas: Canvas, sectionId: string, direction: Side, from: number, to: number);
+    from: DiagramNodeGeometry;
+    to: DiagramNodeGeometry;
+    constructor(canvas: Canvas, intent: DiagramActions.MoveNode | DiagramActions.StretchNode | DiagramActions.StretchSection, nodeId: string, from: DiagramNodeGeometry, to: DiagramNodeGeometry);
     do(): void;
     undo(): void;
     redo(): void;
@@ -208,8 +174,8 @@ export declare class AddConnectionAction implements DiagramAction {
     type: DiagramConnectionType;
     startId: string;
     endId: string;
-    id?: string;
-    constructor(canvas: Canvas, type: DiagramConnectionType, startId: string, endId: string, id?: string);
+    id: string;
+    constructor(canvas: Canvas, type: DiagramConnectionType, startId: string, endId: string);
     do(): void;
     undo(): void;
     redo(): void;
@@ -235,7 +201,7 @@ export declare class EditFieldAction implements DiagramAction {
  * @private
  */
 export declare class UpdateValuesAction implements DiagramAction {
-    model: DiagramModel;
+    canvas: Canvas;
     id: string | undefined;
     from: {
         [key: string]: unknown;
@@ -243,28 +209,34 @@ export declare class UpdateValuesAction implements DiagramAction {
     to: {
         [key: string]: unknown;
     };
-    constructor(model: DiagramModel, id: string | undefined, from: {
+    constructor(canvas: Canvas, id: string | undefined, from: {
         [key: string]: unknown;
     }, to: {
         [key: string]: unknown;
     });
-    getValueSet(): ValueSet | undefined;
     do(): void;
     undo(): void;
     redo(): void;
 }
 /**
  * Action which consists of removing elements from a diagram.
+ *
+ * You should only include an element in this action if the element itself is explicitly removed.
+ * Elements removed as a consequence of a removing another element
+ * (e.g., removing a node removes all of its sections)
+ * will be handled automatically, in a way that converges in the case
+ * of concurrent collaborative actions.
+ *
  * @private
  */
 export declare class RemoveAction implements DiagramAction {
-    model: DiagramModel;
+    canvas: Canvas;
     nodeIds: string[];
     sectionIds: string[];
     portIds: string[];
     connectionIds: string[];
     fieldIds: string[];
-    constructor(model: DiagramModel, nodeIds: string[], sectionIds: string[], portIds: string[], connectionIds: string[], fieldIds: string[]);
+    constructor(canvas: Canvas, nodeIds: string[], sectionIds: string[], portIds: string[], connectionIds: string[], fieldIds: string[]);
     do(): void;
     undo(): void;
     redo(): void;

package/lib/diagram-editor/diagram/diagram-connection.d.ts

@@ -25,6 +25,22 @@ export declare const DIAGRAM_CONNECTION_TYPE_DEFAULTS: {
     selectedColor: string;
     properties: never[];
 };
+/**
+ * Whether a connection can have the same port as both its start port and its end port.
+ */
+export declare const CAN_A_CONNECTION_END_ON_THE_SAME_PORT_IT_STARTS = false;
+/**
+ * Whether a connection can have the same ports as another connection.
+ */
+export declare const CAN_A_CONNECTION_HAVE_THE_SAME_PORTS_AS_ANOTHER = false;
+/**
+ * Whether a port can have multiple connections.
+ */
+export declare const CAN_CONNECTIONS_SHARE_PORTS = true;
+/**
+ * Whether tightening connections is allowed.
+ */
+export declare const CAN_TIGHTEN_CONNECTIONS = true;
 /**
  * A connection type, which holds properties that connections of this type share in common.
  * @see ConnectionTypeConfig
@@ -131,7 +147,8 @@ export declare class DiagramConnection extends DiagramElement {
      */
     get name(): string;
     set name(name: string);
-    constructor(model: DiagramModel, type: DiagramConnectionType, start?: DiagramPort, end?: DiagramPort, id?: string);
+    constructor(model: DiagramModel, type: DiagramConnectionType, start: DiagramPort | undefined, end: DiagramPort | undefined, id: string);
+    get removed(): boolean;
     updateInView(): void;
     /**
      * Set the start of this connection to the given port or reset this connection's starting port if `undefined`.
@@ -173,9 +190,9 @@ export declare class DiagramConnectionSet extends DiagramEntitySet<DiagramConnec
      * @param type The type of the connection given as either the type itself or the id of the type.
      * @param start The start port of the connection.
      * @param end The end port of the connection.
-     * @param id The id of the connection. Should be left undefined unless a specific id is required.
+     * @param id The id of the connection.
      * @returns The instanced connection.
      */
-    new(type: DiagramConnectionType | string, start?: DiagramPort, end?: DiagramPort, id?: string | undefined): DiagramConnection;
+    new(type: DiagramConnectionType | string, start: DiagramPort | undefined, end: DiagramPort | undefined, id: string): DiagramConnection;
     remove(id: string): void;
 }

package/lib/diagram-editor/diagram/diagram-element.d.ts

@@ -1,5 +1,6 @@
 import * as d3 from 'd3';
 import { DiagramModel } from './diagram-model';
+import { CollabTimestamp } from './collab/primitives';
 /**
  * Default priority value for diagram elements.
  * @private
@@ -42,11 +43,32 @@ export declare abstract class DiagramElement implements DiagramEntity {
      */
     selected: boolean;
     /**
-     * Whether this diagram element has been removed.
+     * Whether this diagram element has itself been explicitly removed.
+     *
+     * Override the `removed` getter so that it returns true if and only if:
+     * - `selfRemoved` is true, or
+     * - `removed` is true for any of this element's dependencies.
+     *
+     * For example, a DiagramConnection is removed if either of its ports are removed,
+     * even if the connection's own `selfRemoved` field is false.
+     * @private
+     */
+    selfRemoved: boolean;
+    /**
+     * Collaborative timestamp for selfRemoved.
      * @private
      */
-    removed: boolean;
+    selfRemovedTimestamp: CollabTimestamp | null;
     constructor(model: DiagramModel, id: string);
+    /**
+     * Whether this diagram element has been removed.
+     *
+     * An element can be removed because it was explicitly removed, or because one of
+     * its dependencies was removed. For example, a DiagramConnection depends on both of its ports.
+     *
+     * @private
+     */
+    abstract readonly removed: boolean;
     /**
      * Get the priority of this element to calculate whether it should be filtered out in the view or not.
      * @public

package/lib/diagram-editor/diagram/diagram-field.d.ts

@@ -1,5 +1,6 @@
 import { Point } from '../../util/canvas-util';
 import { HorizontalAlign, VerticalAlign } from '../../util/svg-util';
+import { CollabTimestamp } from './collab/primitives';
 import { DiagramElement, DiagramEntitySet } from './diagram-element';
 import { DiagramModel } from './diagram-model';
 import { DiagramNode } from './diagram-node';
@@ -92,6 +93,11 @@ export declare class DiagramField extends DiagramElement {
      */
     get text(): string;
     set text(value: string);
+    /**
+     * Collaborative timestamp for text.
+     * @public
+     */
+    textTimestamp: CollabTimestamp | null;
     /**
      * Whether this field's text can be edited by the user.
      * @public
@@ -102,8 +108,9 @@ export declare class DiagramField extends DiagramElement {
      * @public
      */
     fit: boolean;
-    constructor(model: DiagramModel, rootElement: DiagramNode | DiagramSection | DiagramPort | undefined, coords: Point, width: number, height: number, fontSize: number, fontFamily: string | null, color: string, selectedColor: string, horizontalAlign: HorizontalAlign, verticalAlign: VerticalAlign, text: string, editable: boolean, fit: boolean, id?: string);
+    constructor(model: DiagramModel, rootElement: DiagramNode | DiagramSection | DiagramPort | undefined, coords: Point, width: number, height: number, fontSize: number, fontFamily: string | null, color: string, selectedColor: string, horizontalAlign: HorizontalAlign, verticalAlign: VerticalAlign, text: string, editable: boolean, fit: boolean);
     select(): d3.Selection<SVGGElement, unknown, null, unknown> | undefined;
+    get removed(): boolean;
     updateInView(): void;
     /**
      * Change the coordinates of this field to the given coordinates.
@@ -124,6 +131,6 @@ export declare class DiagramFieldSet extends DiagramEntitySet<DiagramField> {
      * Instance a new field and add it to this set. This method is normally called when instancing an element with a field and it is rarely called by itself.
      * @private
      */
-    new(rootElement: DiagramNode | DiagramSection | DiagramPort | undefined, coords: Point, fontSize: number, fontFamily: string | null, color: string, selectedColor: string, width: number, height: number, horizontalAlign: HorizontalAlign, verticalAlign: VerticalAlign, text: string, editable: boolean, fit: boolean, id?: string | undefined): DiagramField;
+    new(rootElement: DiagramNode | DiagramSection | DiagramPort | undefined, coords: Point, fontSize: number, fontFamily: string | null, color: string, selectedColor: string, width: number, height: number, horizontalAlign: HorizontalAlign, verticalAlign: VerticalAlign, text: string, editable: boolean, fit: boolean): DiagramField;
     remove(id: string): void;
 }