@metadev/daga 4.2.2 → 4.2.4

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

@@ -26,15 +26,10 @@ export interface DiagramConfig {
      */
     canvas?: CanvasConfig;
     /**
-     * When true, connections made by the user will have their type assumed based on the type of the source and target nodes.
-     * @default false
-     */
-    inferConnectionType?: boolean;
-    /**
-     * Id of the type of connection that is initially selected for the user to draw when drawing connections. By default, no type is selected.
-     * @default undefined
+     * Configuration regarding the general settings of connections.
+     * @default {}
      */
-    defaultConnection?: string;
+    connectionSettings?: ConnectionSettingsConfig;
     /**
      * Name of the layout format used to arrange the nodes of this diagram when pressing the layout button in the diagram buttons component.
      * @default undefined
@@ -88,6 +83,47 @@ export interface DiagramConfig {
      */
     properties?: Property[];
 }
+/**
+ * Configuration regarding the general settings of connections.
+ * @public
+ */
+export interface ConnectionSettingsConfig {
+    /**
+     * When true, connections made by the user will have their type assumed based on the type of the source and target nodes.
+     * @default false
+     */
+    inferConnectionType?: boolean;
+    /**
+     * Id of the type of connection that is initially selected for the user to draw when drawing connections. By default, no type is selected.
+     * @default undefined
+     */
+    defaultConnection?: string;
+    /**
+     * Automatically try to change the start and end ports of a connection to minimize the distance between them.
+     * @default true
+     */
+    autoTighten?: boolean;
+    /**
+     * Whether a connection can use the same port as start and end.
+     * @default false
+     */
+    allowLoops?: boolean;
+    /**
+     * Whether the same port can be used by two different connections.
+     * @default true
+     */
+    sharePorts?: boolean;
+    /**
+     * Whether two connections can use the same ports.
+     * @default false
+     */
+    shareBothPorts?: boolean;
+    /**
+     * Within what radius the closest port may be highlighted when drawing a new connection as a guide to the user.
+     * @default 100
+     */
+    portHighlightRadius?: number;
+}
 /**
  * Configuration for which user actions are allowed in a diagram.
  * @public
@@ -314,6 +350,11 @@ export interface FieldConfig {
      * @default '#000000'
      */
     color?: string;
+    /**
+     * The background color of the text of this field.
+     * @default '#00000000'
+     */
+    backgroundColor?: string;
     /**
      * The color of the text of this field when selected.
      * @default '#000000'

package/src/lib/diagram/config/diagram-look-config.d.ts

@@ -71,20 +71,29 @@ export interface ShapedLook extends Look {
     lookType: 'shaped-look';
     /**
      * Shape of nodes using this look.
+     * @default 'rectangle'
      */
-    shape: ClosedShape | ShapeFunction;
+    shape?: ClosedShape | ShapeFunction;
     /**
      * Background color of this look.
+     * @default '#FFFFFF'
      */
-    fillColor: string;
+    fillColor?: string;
     /**
      * Border color of this look.
+     * @default '#000000'
      */
-    borderColor: string;
+    borderColor?: string;
     /**
      * Border thickness of this look in diagram units.
+     * @default 1
+     */
+    borderThickness?: number;
+    /**
+     * Border style of this look.
+     * @default 'solid'
      */
-    borderThickness: number;
+    borderStyle?: LineStyle;
 }
 /**
  * Configuration for a look given by an image.
@@ -201,20 +210,20 @@ export interface ConnectionLook extends Look {
      * Color of the line of connections of this type.
      * @default '#000000'
      */
-    color: string;
+    color?: string;
     /**
      * Thickness of the line of connections of this type in diagram units.
      * @default 1
      */
-    thickness: number;
+    thickness?: number;
     /**
      * Shape of the line of connections of this type.
      * @default 'straight'
      */
-    shape: LineShape | LineFunction;
+    shape?: LineShape | LineFunction;
     /**
      * Style of the line of connections of this type.
      * @default 'solid'
      */
-    style: LineStyle;
+    style?: LineStyle;
 }

package/src/lib/diagram/model/diagram-connection.d.ts

@@ -36,22 +36,6 @@ export declare const DIAGRAM_CONNECTION_TYPE_DEFAULTS: {
     endTypes: never[];
     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;
 /**
  * The types allowed for the look of the markers of a connection.
  * @public

package/src/lib/diagram/model/diagram-field.d.ts

@@ -17,6 +17,7 @@ export declare const DIAGRAM_FIELD_DEFAULTS: {
     fontFamily: string;
     color: string;
     selectedColor: string;
+    backgroundColor: string;
     horizontalAlign: HorizontalAlign;
     verticalAlign: VerticalAlign;
     orientation: Side;

package/src/lib/diagram/property/property.d.ts

@@ -6,9 +6,13 @@
  */
 export declare class Property {
     /**
-     * The name of this property. Used to distinguish this property from others.
+     * The name of this property. Used to distinguish this property from others. Must be unique.
      */
     name: string;
+    /**
+     * The label of this property. Used when displaying this property to the user.
+     */
+    label?: string;
     /**
      * The type of this property, which indicates the possible values that this property can have.
      */
@@ -20,13 +24,15 @@ export declare class Property {
     defaultValue?: unknown;
     /**
      * Whether this property should always appear in the property editor component.
+     * @default true
      * @see PropertyEditorComponent
      */
-    basic: boolean;
+    basic?: boolean;
     /**
      * Whether the value of this property can be edited.
+     * @default true
      */
-    editable: boolean;
+    editable?: boolean;
     /**
      * Which attribute of the parent component the value of this property is linked to. By default, it is not linked to any.
      * @default undefined
@@ -44,7 +50,7 @@ export declare class Property {
      * @default undefined
      */
     properties?: Property[];
-    constructor(name: string, type: Type, defaultValue: unknown, basic: boolean, editable: boolean, rootAttribute?: string[] | string);
+    constructor(name: string, label: string | undefined, type: Type, defaultValue: unknown, basic: boolean | undefined, editable: boolean | undefined, rootAttribute?: string[] | string);
 }
 /**
  * Each of the possible values that a property of type option can have.

package/src/lib/interfaces/canvas.d.ts

@@ -98,15 +98,40 @@ export interface Canvas {
      * @public
      */
     inferConnectionType: boolean;
-    /**
-     * If true, the next drag action will create a multiple selection rectangle.
-     */
-    multipleSelectionOn: boolean;
     /**
      * When a new connection is made, it should have this type.
      * @public
      */
     connectionType?: DiagramConnectionType;
+    /**
+     * Whether the start and end ports should automatically change to try to minimize the distance between them.
+     * @public
+     */
+    autoTightenConnections: boolean;
+    /**
+     * Whether a connection can use the same port as start and end.
+     * @public
+     */
+    allowConnectionLoops: boolean;
+    /**
+     * Whether the same port can be used by two different connections.
+     * @public
+     */
+    allowSharingPorts: boolean;
+    /**
+     * Whether two connections can use the same ports.
+     * @public
+     */
+    allowSharingBothPorts: boolean;
+    /**
+     * Within what radius the closest port may be highlighted when drawing a new connection as a guide to the user.
+     * @public
+     */
+    portHighlightRadius: number;
+    /**
+     * If true, the next drag action will create a multiple selection rectangle.
+     */
+    multipleSelectionOn: boolean;
     /**
      * Identifier of the current layout format used by the diagram.
      * @public