@metadev/daga 1.5.5 → 1.5.7

package/index.d.ts

@@ -14,7 +14,8 @@ export { ACTION_QUEUE_SIZE, DiagramCanvas } from './lib/diagram-editor/diagram/d
 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 { DiagramDecorator, DiagramDecoratorSet } from './lib/diagram-editor/diagram/diagram-decorator';
-export { DiagramElement, DiagramEntity, DiagramEntitySet } from './lib/diagram-editor/diagram/diagram-element';
+export { DiagramElement, DiagramElementSet } from './lib/diagram-editor/diagram/diagram-element';
+export { DiagramEntity, DiagramEntitySet } from './lib/diagram-editor/diagram/diagram-entity';
 export { DiagramEvent } from './lib/diagram-editor/diagram/diagram-event';
 export { DiagramField, DiagramFieldSet } from './lib/diagram-editor/diagram/diagram-field';
 export { DiagramModel } from './lib/diagram-editor/diagram/diagram-model';

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

@@ -423,15 +423,15 @@ export interface FieldConfig {
      */
     fontSize?: number;
     /**
-     * The margin around the field in pixels.
+     * The margin around the field in pixels. May be a single value or an array, in which case the value is interpreted in the same way as in CSS margin.
      * @default 0
      */
-    margin?: number;
+    margin?: number | number[];
     /**
-     * The padding around the field in pixels.
+     * The padding around the field in pixels. May be a single value or an array, in which case the value is interpreted in the same way as in CSS padding.
      * @default 0
      */
-    padding?: number;
+    padding?: number | number[];
     /**
      * The font family of the text of this field.
      * @see {@link https://developer.mozilla.org/en-US/docs/Web/CSS/font-family |font-family}

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

@@ -2,7 +2,8 @@ import { Point } from '../../util/canvas-util';
 import { LineShape, LineStyle } from '../../util/line';
 import { Side } from '../../util/svg-util';
 import { ConnectionMarkerLook, ConnectionTypeConfig, FieldConfig } from './diagram-config';
-import { DiagramElement, DiagramEntity, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
+import { DiagramEntity, DiagramEntitySet } from './diagram-entity';
 import { DiagramModel } from './diagram-model';
 import { DiagramPort } from './diagram-port';
 import { PropertySet, ValueSet } from './diagram-property';
@@ -172,7 +173,7 @@ export declare class DiagramConnection extends DiagramElement {
     tighten(): void;
     getPriority(): number;
 }
-export declare class DiagramConnectionSet extends DiagramEntitySet<DiagramConnection> {
+export declare class DiagramConnectionSet extends DiagramElementSet<DiagramConnection> {
     private model;
     /**
      * Set of the possible types of connection that the connections of this set can have.

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

@@ -1,5 +1,5 @@
 import { Point } from '../../util/canvas-util';
-import { DiagramElement, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
 import { DiagramModel } from './diagram-model';
 import { DiagramNode } from './diagram-node';
 import { DiagramSection } from './diagram-section';
@@ -47,7 +47,7 @@ export declare class DiagramDecorator extends DiagramElement {
     move(coords: Point): void;
     getPriority(): number;
 }
-export declare class DiagramDecoratorSet extends DiagramEntitySet<DiagramDecorator> {
+export declare class DiagramDecoratorSet extends DiagramElementSet<DiagramDecorator> {
     private model;
     /**
      * Instance a set of decorators for the given model. This method is used internally.

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

@@ -1,23 +1,12 @@
 import * as d3 from 'd3';
-import { DiagramModel } from './diagram-model';
 import { CollabTimestamp } from './collab/primitives';
+import { DiagramEntity, DiagramEntitySet } from './diagram-entity';
+import { DiagramModel } from './diagram-model';
 /**
  * Default priority value for diagram elements.
  * @private
  */
 export declare const DEFAULT_PRIORITY = 0;
-/**
- * Represents an object which exists as part of a diagram model.
- * @public
- * @see DiagramModel
- */
-export interface DiagramEntity {
-    /**
-     * Identifier that uniquely identifies this entity within its diagram model.
-     * @public
-     */
-    get id(): string;
-}
 /**
  * Represents an object which exists as part of a specific diagram model and has a visual representation in a diagram canvas.
  * @public
@@ -61,7 +50,8 @@ export declare abstract class DiagramElement implements DiagramEntity {
     selfRemovedTimestamp: CollabTimestamp | null;
     constructor(model: DiagramModel, id: string);
     /**
-     * Whether this diagram element has been removed.
+     * Whether this diagram element has been soft removed, that is,
+     * it has been marked as removed but the data is still in the model.
      *
      * 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.
@@ -85,83 +75,18 @@ export declare abstract class DiagramElement implements DiagramEntity {
      */
     select(): d3.Selection<SVGGElement, unknown, null, unknown> | undefined;
 }
-/**
- * Represents a collection of diagram entities of a type that exists as part of a diagram model.
- * @public
- * @see DiagramEntity
- * @see DiagramModel
- */
-export declare class DiagramEntitySet<E extends DiagramEntity> implements Iterable<E> {
-    /**
-     * The list of entities contained in this set.
-     * @private
-     */
-    protected entities: E[];
-    /**
-     * A mapping of entity ids to their corresponding entity in this set for quickly fetching entities based on their id.
-     * @private
-     */
-    protected entityMap: {
-        [id: string]: E;
-    };
-    /**
-     * The number of entities of this set.
-     * @public
-     */
-    get length(): number;
-    /**
-     * Gets all of the entities of this set.
-     * @public
-     * @returns An array containing all of the entities of this set.
-     */
-    all(): E[];
-    /**
-     * Adds an entity to this set if there are no entities with the same id. Has no effect if there already exists an entity with the same id as the given entity.
-     * For creating entities with relationships with other entities, the new() method should be used instead. The add() method adds an entity but doesn't take care of setting that entity's relationships with other entities.
-     * @private
-     * @param entity An entity to be added to this set.
-     */
-    add(entity: E): void;
-    /**
-     * Removes all the entities in this set.
-     * @public
-     */
-    clear(): void;
-    /**
-     * Checks if this set contains an entity with the given id.
-     * @public
-     * @param id An id.
-     * @returns `true` if this set contains an entity with the given id, `false` otherwise.
-     */
-    contains(id: string): boolean;
-    /**
-     * Gets all of the entities of this set filtered following given criteria.
-     * @public
-     * @returns An array containing the entities of this set that meet the given criteria.
-     */
-    filter(predicate: (value: E, index: number, array: E[]) => unknown): E[];
-    /**
-     * Gets an entity of this set matching specific criteria.
-     * @public
-     * @returns An entity of this set.
-     */
-    find(predicate: (value: E, index: number, array: E[]) => unknown): E | undefined;
-    /**
-     * Gets an entity from this set.
-     * @public
-     * @param id An id.
-     * @returns An entity with the given id, or `undefined` if there are no entities with the given id.
-     */
-    get(id: string): E | undefined;
-    /**
-     * Attempts to find and remove an entity with the given id. Has no effect if there are no entities with the given id.
-     * @public
-     * @param id An id.
-     */
-    remove(id: string): void;
-    /**
-     * Iterator to iterate over the entities of this set.
+export declare class DiagramElementSet<E extends DiagramElement> extends DiagramEntitySet<E> {
+    all(includeRemoved?: boolean): E[];
+    contains(id: string, includeRemoved?: boolean): boolean;
+    count(predicate: (value: E, index: number, array: E[]) => unknown, includeRemoved?: boolean): number;
+    filter(predicate: (value: E, index: number, array: E[]) => unknown, includeRemoved?: boolean): E[];
+    find(predicate: (value: E, index: number, array: E[]) => unknown, includeRemoved?: boolean): E | undefined;
+    get(id: string, includeRemoved?: boolean): E | undefined;
+    map<R>(callback: (value: E, index: number, array: E[]) => R, includeRemoved?: boolean): R[];
+    /**
+     * Gets the number of entities in this set.
      * @public
      */
-    [Symbol.iterator](): Iterator<E>;
+    size(includeRemoved?: boolean): number;
+    [Symbol.iterator](includeRemoved?: boolean): Iterator<E>;
 }

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

@@ -0,0 +1,109 @@
+/**
+ * Represents an object which exists as part of a diagram model.
+ * @public
+ * @see DiagramModel
+ */
+export interface DiagramEntity {
+    /**
+     * Identifier that uniquely identifies this entity within its diagram model.
+     * @public
+     */
+    get id(): string;
+}
+/**
+ * Represents a collection of diagram entities of a type that exists as part of a diagram model.
+ * @public
+ * @see DiagramEntity
+ * @see DiagramModel
+ */
+export declare class DiagramEntitySet<E extends DiagramEntity> implements Iterable<E> {
+    /**
+     * The list of entities contained in this set.
+     * @private
+     */
+    protected entities: E[];
+    /**
+     * A mapping of entity ids to their corresponding entity in this set for quickly fetching entities based on their id.
+     * @private
+     */
+    protected entityMap: {
+        [id: string]: E;
+    };
+    /**
+     * The number of entities in this set.
+     * @public
+     */
+    get length(): number;
+    /**
+     * Gets all of the entities of this set.
+     * @public
+     * @returns An array containing all of the entities of this set.
+     */
+    all(): E[];
+    /**
+     * Adds an entity to this set if there are no entities with the same id. Has no effect if there already exists an entity with the same id as the given entity.
+     * For creating entities with relationships with other entities, the new() method should be used instead. The add() method adds an entity but doesn't take care of setting that entity's relationships with other entities.
+     * @private
+     * @param entity An entity to be added to this set.
+     */
+    add(entity: E): void;
+    /**
+     * Removes all the entities in this set.
+     * @public
+     */
+    clear(): void;
+    /**
+     * Checks if this set contains an entity with the given id.
+     * @public
+     * @param id An id.
+     * @returns `true` if this set contains an entity with the given id, `false` otherwise.
+     */
+    contains(id: string): boolean;
+    /**
+     * Counts the number of entities of this set following the given criteria.
+     * @public
+     * @returns The number of entities of this set following the given criteria.
+     */
+    count(predicate: (value: E, index: number, array: E[]) => unknown): number;
+    /**
+     * Gets all of the entities of this set filtered following given criteria.
+     * @public
+     * @returns An array containing the entities of this set that meet the given criteria.
+     */
+    filter(predicate: (value: E, index: number, array: E[]) => unknown): E[];
+    /**
+     * Gets an entity of this set matching specific criteria.
+     * @public
+     * @returns An entity of this set.
+     */
+    find(predicate: (value: E, index: number, array: E[]) => unknown): E | undefined;
+    /**
+     * Gets an entity from this set.
+     * @public
+     * @param id An id.
+     * @returns An entity with the given id, or `undefined` if there are no entities with the given id.
+     */
+    get(id: string): E | undefined;
+    /**
+     * Gets all of the entities of this set mapped to the result of the given function applied to them.
+     * @public
+     * @returns An array containing the entities of this set that meet the given criteria.
+     */
+    map<R>(callback: (value: E, index: number, array: E[]) => R): R[];
+    /**
+     * Attempts to find and remove an entity with the given id. Has no effect if there are no entities with the given id.
+     * @public
+     * @param id An id.
+     */
+    remove(id: string): void;
+    /**
+     * Gets the number of entities in this set.
+     * @public
+     */
+    size(): number;
+    /**
+     * Iterator to iterate over the entities of this set.
+     * @public
+     */
+    [Symbol.iterator](): Iterator<E>;
+}

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

@@ -1,7 +1,8 @@
 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 { FieldConfig } from './diagram-config';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
 import { DiagramModel } from './diagram-model';
 import { DiagramNode } from './diagram-node';
 import { DiagramPort } from './diagram-port';
@@ -120,7 +121,7 @@ export declare class DiagramField extends DiagramElement {
     move(coords: Point): void;
     getPriority(): number;
 }
-export declare class DiagramFieldSet extends DiagramEntitySet<DiagramField> {
+export declare class DiagramFieldSet extends DiagramElementSet<DiagramField> {
     private model;
     /**
      * Instance a set of fields for the given model. This method is used internally.
@@ -134,3 +135,11 @@ export declare class DiagramFieldSet extends DiagramEntitySet<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;
 }
+export declare const getBottomMargin: (config?: FieldConfig | null) => number;
+export declare const getLeftMargin: (config?: FieldConfig | null) => number;
+export declare const getRightMargin: (config?: FieldConfig | null) => number;
+export declare const getTopMargin: (config?: FieldConfig | null) => number;
+export declare const getBottomPadding: (config?: FieldConfig | null) => number;
+export declare const getLeftPadding: (config?: FieldConfig | null) => number;
+export declare const getRightPadding: (config?: FieldConfig | null) => number;
+export declare const getTopPadding: (config?: FieldConfig | null) => number;

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

@@ -4,7 +4,8 @@ import { CollabTimestamp } from './collab/primitives';
 import { FieldConfig, NodeImageLook, NodeShapedLook, NodeStretchableImageLook, NodeTypeConfig, PortConfig, SectionGridConfig } from './diagram-config';
 import { DiagramConnection } from './diagram-connection';
 import { DiagramDecorator } from './diagram-decorator';
-import { DiagramElement, DiagramEntity, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
+import { DiagramEntity, DiagramEntitySet } from './diagram-entity';
 import { DiagramField } from './diagram-field';
 import { DiagramModel } from './diagram-model';
 import { DiagramPort } from './diagram-port';
@@ -148,25 +149,25 @@ export declare class DiagramNode extends DiagramElement {
      * @public
      * @returns A list of connections.
      */
-    getIncomingConnections(): DiagramConnection[];
+    getIncomingConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Get all outgoing connections of all ports of this node, not including outgoing connections of sections of this node.
      * @public
      * @returns A list of connections.
      */
-    getOutgoingConnections(): DiagramConnection[];
+    getOutgoingConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Get all connections of all ports of this node, not including connections of sections of this node.
      * @public
      * @returns A list of connections.
      */
-    getConnections(): DiagramConnection[];
+    getConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Get all nodes that have a direct connection to this node, not including nodes that have a direct connection to sections of this node.
      * @public
      * @returns A list of nodes.
      */
-    getAdjacentNodes(): DiagramNode[];
+    getAdjacentNodes(includeRemoved?: boolean): DiagramNode[];
     /**
      * Change the coordinates of this node to the given coordinates and move its sections, ports and labels correspondingly.
      * @public
@@ -200,7 +201,7 @@ export declare class DiagramNode extends DiagramElement {
      */
     setGeometry(geometry: DiagramNodeGeometry): void;
 }
-export declare class DiagramNodeSet extends DiagramEntitySet<DiagramNode> {
+export declare class DiagramNodeSet extends DiagramElementSet<DiagramNode> {
     private model;
     /**
      * Set of the possible types of node that the nodes of this set can have.

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

@@ -1,5 +1,5 @@
 import { Point } from '../../util/canvas-util';
-import { DiagramElement, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
 import { DiagramModel } from './diagram-model';
 /**
  * A foreign object which is inserted with arbitrary html into a diagram.
@@ -36,7 +36,7 @@ export declare class DiagramObject extends DiagramElement {
     move(coords: Point): void;
     getPriority(): number;
 }
-export declare class DiagramObjectSet extends DiagramEntitySet<DiagramObject> {
+export declare class DiagramObjectSet extends DiagramElementSet<DiagramObject> {
     private model;
     /**
      * Instance a set of objects for the given model. This method is used internally.

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

@@ -1,7 +1,7 @@
 import { Point } from '../../util/canvas-util';
 import { Side } from '../../util/svg-util';
 import { DiagramConnection } from './diagram-connection';
-import { DiagramElement, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
 import { DiagramField } from './diagram-field';
 import { DiagramModel } from './diagram-model';
 import { DiagramNode } from './diagram-node';
@@ -84,7 +84,7 @@ export declare class DiagramPort extends DiagramElement {
     move(coords: Point): void;
     distanceTo(coords: Point): number;
 }
-export declare class DiagramPortSet extends DiagramEntitySet<DiagramPort> {
+export declare class DiagramPortSet extends DiagramElementSet<DiagramPort> {
     private model;
     /**
      * Instance a set of ports for the given model. This method is used internally.

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

@@ -3,7 +3,7 @@ import { Side } from '../../util/svg-util';
 import { NodeShapedLook, SectionConfig } from './diagram-config';
 import { DiagramConnection } from './diagram-connection';
 import { DiagramDecorator } from './diagram-decorator';
-import { DiagramElement, DiagramEntitySet } from './diagram-element';
+import { DiagramElement, DiagramElementSet } from './diagram-element';
 import { DiagramField } from './diagram-field';
 import { DiagramModel } from './diagram-model';
 import { DiagramNode } from './diagram-node';
@@ -129,19 +129,19 @@ export declare class DiagramSection extends DiagramElement {
      * @public
      * @returns A list of connections.
      */
-    getIncomingConnections(): DiagramConnection[];
+    getIncomingConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Get all outgoing connections of all ports of this section.
      * @public
      * @returns A list of connections.
      */
-    getOutgoingConnections(): DiagramConnection[];
+    getOutgoingConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Get all connections of all ports of this section.
      * @public
      * @returns A list of connections.
      */
-    getConnections(): DiagramConnection[];
+    getConnections(includeRemoved?: boolean): DiagramConnection[];
     /**
      * Change the coordinates of this section to the given coordinates and move its ports and labels correspondingly.
      * @public
@@ -166,7 +166,7 @@ export declare class DiagramSection extends DiagramElement {
      */
     setGeometry(geometry: DiagramSectionGeometry): void;
 }
-export declare class DiagramSectionSet extends DiagramEntitySet<DiagramSection> {
+export declare class DiagramSectionSet extends DiagramElementSet<DiagramSection> {
     private model;
     /**
      * Instance a set of sections for the given model. This method is used internally.

package/lib/property-editor/property-editor.component.d.ts

@@ -4,6 +4,10 @@ import { ValueSet } from '../diagram-editor/diagram/diagram-property';
 import { PropertyEditor } from '../interfaces/property-editor';
 import { Corner, Side } from '../util/svg-util';
 import * as i0 from "@angular/core";
+/**
+ * Duration of the highlight property animation in milliseconds.
+ */
+export declare const HIGHLIGHT_ANIMATION_DURATION_MS = 1000;
 /**
  * Editor of the values of a value set.
  * @see ValueSet

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@metadev/daga",
   "description": "Diagramming engine for editing models on the Web. Made by Metadev.",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "author": "Metadev (https://metadev.pro)",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": "git+https://github.com/metadevpro/daga-tutorial.git",