@joint/core 4.2.0 → 4.2.2

package/dist/vectorizer.js

@@ -1,4 +1,4 @@
-/*! JointJS v4.2.0 (2025-11-10) - JavaScript diagramming library
+/*! JointJS v4.2.2 (2025-12-16) - JavaScript diagramming library
 
 This Source Code Form is subject to the terms of the Mozilla Public
 License, v. 2.0. If a copy of the MPL was not distributed with this

package/dist/vectorizer.min.js

@@ -1,4 +1,4 @@
-/*! JointJS v4.2.0 (2025-11-10) - JavaScript diagramming library
+/*! JointJS v4.2.2 (2025-12-16) - JavaScript diagramming library
 
 This Source Code Form is subject to the terms of the Mozilla Public
 License, v. 2.0. If a copy of the MPL was not distributed with this

package/dist/version.mjs

@@ -1,3 +1,3 @@
-var version = "4.2.0";
+var version = "4.2.2";
 
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@joint/core",
   "title": "JointJS",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "description": "JavaScript diagramming library",
   "sideEffects": false,
   "main": "./dist/joint.min.js",

package/src/dia/Graph.mjs

@@ -29,6 +29,13 @@ export const Graph = Model.extend({
      */
     defaultLayerId: DEFAULT_LAYER_ID,
 
+    /**
+     * @protected
+     * @description If `true`, layer functionality is disabled
+     * and all cells are assigned to the default layer.
+     */
+    ignoreLayers: false,
+
     initialize: function(attrs, options = {}) {
 
         const layerCollection = this.layerCollection = new GraphLayerCollection([], {
@@ -52,6 +59,11 @@ export const Graph = Model.extend({
         // Controller that manages communication between the graph and its layers.
         this.layersController = new GraphLayersController({ graph: this });
 
+        // Option to ignore layers altogether.
+        if (options.ignoreLayers) {
+            this.ignoreLayers = true;
+        }
+
         // `Graph` keeps an internal data structure (an adjacency list)
         // for fast graph queries. All changes that affect the structure of the graph
         // must be reflected in the `al` object. This object provides fast answers to
@@ -156,7 +168,7 @@ export const Graph = Model.extend({
         // Backward compatibility: prior v4.2, z-index was not set during reset.
         if (opt && opt.ensureZIndex) {
             if (cellAttributes.z === undefined) {
-                const layerId = cellAttributes[config.layerAttribute] || this.defaultLayerId;
+                const layerId = this.getCellLayerId(cellInit);
                 const zIndex = this.maxZIndex(layerId) + 1;
                 if (cellInit[CELL_MARKER]) {
                     // Set with event in case there is a listener
@@ -268,6 +280,10 @@ export const Graph = Model.extend({
         if (!cellInit) {
             throw new Error('dia.Graph: No cell provided.');
         }
+        if (this.ignoreLayers) {
+            // When layers are ignored, all cells belong to the default layer.
+            return this.defaultLayerId;
+        }
         const cellAttributes = cellInit[CELL_MARKER]
             ? cellInit.attributes
             : cellInit;

package/types/joint.d.ts

@@ -25,6 +25,11 @@ type _DeepPartial<T> = {
 
 type DeepPartial<T> = _DeepPartial<_DeepRequired<T>>;
 
+/**
+ * A type that makes all properties of T nullable.
+ */
+type Nullable<T> = { [K in keyof T]: T[K] | null };
+
 // We use `DOMElement` later in the code, to avoid conflicts with the `dia.Element` type.
 type DOMElement = Element;
 
@@ -318,6 +323,7 @@ export namespace dia {
         constructor(attributes?: Graph.Attributes, opt?: {
             cellNamespace?: any,
             layerNamespace?: any,
+            ignoreLayers?: boolean,
             /** @deprecated use cellNamespace instead */
             cellModel?: typeof Cell
         });
@@ -493,7 +499,7 @@ export namespace dia {
         }
 
         interface Selectors {
-            [selector: string]: attributes.SVGAttributes | undefined;
+            [selector: string]: Nullable<attributes.SVGAttributes> | undefined;
         }
 
         interface Attributes extends GenericAttributes<Selectors> {
@@ -546,7 +552,7 @@ export namespace dia {
         }
 
         interface ExportOptions {
-            ignoreDefault?: boolean | string[];
+            ignoreDefaults?: boolean | string[];
             ignoreEmptyAttributes?: boolean;
         }
 
@@ -918,18 +924,7 @@ export namespace dia {
             connector?: connectors.Connector | connectors.ConnectorJSON;
         }
 
-        interface LinkSelectors extends Cell.Selectors {
-            '.connection'?: attributes.SVGPathAttributes;
-            '.connection-wrap'?: attributes.SVGPathAttributes;
-            '.marker-source'?: attributes.SVGPathAttributes;
-            '.marker-target'?: attributes.SVGPathAttributes;
-            '.labels'?: attributes.SVGAttributes;
-            '.marker-vertices'?: attributes.SVGAttributes;
-            '.marker-arrowheads'?: attributes.SVGAttributes;
-            '.link-tools'?: attributes.SVGAttributes;
-        }
-
-        interface Attributes extends Cell.GenericAttributes<LinkSelectors> {
+        interface Attributes extends Cell.GenericAttributes<Cell.Selectors> {
         }
 
         interface LabelPosition {
@@ -2740,43 +2735,43 @@ export namespace highlighters {
 export namespace shapes {
 
     interface SVGTextSelector extends dia.Cell.Selectors {
-        text?: attributes.SVGTextAttributes;
+        text?: Nullable<attributes.SVGTextAttributes>;
     }
 
     interface SVGRectSelector extends dia.Cell.Selectors {
-        rect?: attributes.SVGRectAttributes;
+        rect?: Nullable<attributes.SVGRectAttributes>;
     }
 
     interface SVGCircleSelector extends dia.Cell.Selectors {
-        circle?: attributes.SVGCircleAttributes;
+        circle?: Nullable<attributes.SVGCircleAttributes>;
     }
 
     interface SVGEllipseSelector extends dia.Cell.Selectors {
-        ellipse?: attributes.SVGEllipseAttributes;
+        ellipse?: Nullable<attributes.SVGEllipseAttributes>;
     }
 
     interface SVGPolygonSelector extends dia.Cell.Selectors {
-        polygon?: attributes.SVGPolygonAttributes;
+        polygon?: Nullable<attributes.SVGPolygonAttributes>;
     }
 
     interface SVGPolylineSelector extends dia.Cell.Selectors {
-        polyline?: attributes.SVGPolylineAttributes;
+        polyline?: Nullable<attributes.SVGPolylineAttributes>;
     }
 
     interface SVGImageSelector extends dia.Cell.Selectors {
-        image?: attributes.SVGImageAttributes;
+        image?: Nullable<attributes.SVGImageAttributes>;
     }
 
     interface SVGPathSelector extends dia.Cell.Selectors {
-        path?: attributes.SVGPathAttributes;
+        path?: Nullable<attributes.SVGPathAttributes>;
     }
 
     namespace standard {
 
         interface RectangleSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGRectAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGRectAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type RectangleAttributes = dia.Element.GenericAttributes<RectangleSelectors>;
@@ -2785,9 +2780,9 @@ export namespace shapes {
         }
 
         interface CircleSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGCircleAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGCircleAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type CircleAttributes = dia.Element.GenericAttributes<CircleSelectors>;
@@ -2796,9 +2791,9 @@ export namespace shapes {
         }
 
         interface EllipseSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGEllipseAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGEllipseAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type EllipseAttributes = dia.Element.GenericAttributes<EllipseSelectors>;
@@ -2807,9 +2802,9 @@ export namespace shapes {
         }
 
         interface PathSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGPathAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGPathAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type PathAttributes = dia.Element.GenericAttributes<PathSelectors>;
@@ -2818,9 +2813,9 @@ export namespace shapes {
         }
 
         interface PolygonSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGPolygonAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGPolygonAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type PolygonAttributes = dia.Element.GenericAttributes<PolygonSelectors>;
@@ -2829,9 +2824,9 @@ export namespace shapes {
         }
 
         interface PolylineSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGPolylineAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGPolylineAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type PolylineAttributes = dia.Element.GenericAttributes<PolylineSelectors>;
@@ -2840,9 +2835,9 @@ export namespace shapes {
         }
 
         interface ImageSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            image?: attributes.SVGImageAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            image?: Nullable<attributes.SVGImageAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type ImageAttributes = dia.Element.GenericAttributes<ImageSelectors>;
@@ -2851,11 +2846,11 @@ export namespace shapes {
         }
 
         interface BorderedImageSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            border?: attributes.SVGRectAttributes;
-            background?: attributes.SVGRectAttributes;
-            image?: attributes.SVGImageAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            border?: Nullable<attributes.SVGRectAttributes>;
+            background?: Nullable<attributes.SVGRectAttributes>;
+            image?: Nullable<attributes.SVGImageAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type BorderedImageAttributes = dia.Element.GenericAttributes<BorderedImageSelectors>;
@@ -2864,10 +2859,10 @@ export namespace shapes {
         }
 
         interface EmbeddedImageSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGRectAttributes;
-            image?: attributes.SVGImageAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGRectAttributes>;
+            image?: Nullable<attributes.SVGImageAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type EmbeddedImageAttributes = dia.Element.GenericAttributes<EmbeddedImageSelectors>;
@@ -2876,11 +2871,11 @@ export namespace shapes {
         }
 
         interface InscribedImageSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            border?: attributes.SVGEllipseAttributes;
-            background?: attributes.SVGEllipseAttributes;
-            image?: attributes.SVGImageAttributes;
-            label?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            border?: Nullable<attributes.SVGEllipseAttributes>;
+            background?: Nullable<attributes.SVGEllipseAttributes>;
+            image?: Nullable<attributes.SVGImageAttributes>;
+            label?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type InscribedImageAttributes = dia.Element.GenericAttributes<InscribedImageSelectors>;
@@ -2889,11 +2884,11 @@ export namespace shapes {
         }
 
         interface HeaderedRectangleSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGRectAttributes;
-            header?: attributes.SVGRectAttributes;
-            headerText?: attributes.SVGTextAttributes;
-            bodyText?: attributes.SVGTextAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGRectAttributes>;
+            header?: Nullable<attributes.SVGRectAttributes>;
+            headerText?: Nullable<attributes.SVGTextAttributes>;
+            bodyText?: Nullable<attributes.SVGTextAttributes>;
         }
 
         type HeaderedRectangleAttributes = dia.Element.GenericAttributes<HeaderedRectangleSelectors>;
@@ -2906,9 +2901,9 @@ export namespace shapes {
         }
 
         interface CylinderSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
             body?: CylinderBodyAttributes;
-            top?: attributes.SVGEllipseAttributes;
+            top?: Nullable<attributes.SVGEllipseAttributes>;
         }
 
         type CylinderAttributes = dia.Element.GenericAttributes<CylinderSelectors>;
@@ -2919,13 +2914,13 @@ export namespace shapes {
         }
 
         interface TextBlockSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            body?: attributes.SVGRectAttributes;
-            label?: {
+            root?: Nullable<attributes.SVGAttributes>;
+            body?: Nullable<attributes.SVGRectAttributes>;
+            label?: Nullable<{
                 text?: string;
                 style?: { [key: string]: any };
                 [key: string]: any;
-            };
+            }>;
         }
 
         type TextBlockAttributes = dia.Element.GenericAttributes<TextBlockSelectors>;
@@ -2934,9 +2929,9 @@ export namespace shapes {
         }
 
         interface LinkSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            line?: attributes.SVGPathAttributes;
-            wrapper?: attributes.SVGPathAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            line?: Nullable<attributes.SVGPathAttributes>;
+            wrapper?: Nullable<attributes.SVGPathAttributes>;
         }
 
         type LinkAttributes = dia.Link.GenericAttributes<LinkSelectors>;
@@ -2945,9 +2940,9 @@ export namespace shapes {
         }
 
         interface DoubleLinkSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            line?: attributes.SVGPathAttributes;
-            outline?: attributes.SVGPathAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            line?: Nullable<attributes.SVGPathAttributes>;
+            outline?: Nullable<attributes.SVGPathAttributes>;
         }
 
         type DoubleLinkAttributes = dia.Link.GenericAttributes<DoubleLinkSelectors>;
@@ -2956,9 +2951,9 @@ export namespace shapes {
         }
 
         interface ShadowLinkSelectors extends dia.Cell.Selectors {
-            root?: attributes.SVGAttributes;
-            line?: attributes.SVGPathAttributes;
-            shadow?: attributes.SVGPathAttributes;
+            root?: Nullable<attributes.SVGAttributes>;
+            line?: Nullable<attributes.SVGPathAttributes>;
+            shadow?: Nullable<attributes.SVGPathAttributes>;
         }
 
         type ShadowLinkAttributes = dia.Link.GenericAttributes<ShadowLinkSelectors>;
@@ -2966,52 +2961,6 @@ export namespace shapes {
         class ShadowLink extends dia.Link<ShadowLinkAttributes> {
         }
     }
-
-    namespace devs {
-
-        interface ModelSelectors extends dia.Cell.Selectors {
-            '.label'?: attributes.SVGTextAttributes;
-            '.body'?: attributes.SVGRectAttributes;
-        }
-
-        interface ModelAttributes extends dia.Element.GenericAttributes<ModelSelectors> {
-            inPorts?: string[];
-            outPorts?: string[];
-        }
-
-        class Model extends dia.Element {
-
-            constructor(attributes?: ModelAttributes, opt?: { [key: string]: any });
-
-            changeInGroup(properties: any, opt?: any): boolean;
-
-            changeOutGroup(properties: any, opt?: any): boolean;
-
-            createPortItem(group: string, port: string): any;
-
-            createPortItems(group: string, ports: string[]): any[];
-
-            addOutPort(port: string, opt?: any): this;
-
-            addInPort(port: string, opt?: any): this;
-
-            removeOutPort(port: string, opt?: any): this;
-
-            removeInPort(port: string, opt?: any): this;
-        }
-
-        class Coupled extends Model {
-
-        }
-
-        class Atomic extends Model {
-
-        }
-
-        class Link extends dia.Link {
-
-        }
-    }
 }
 
 // util
@@ -3370,9 +3319,17 @@ export namespace layout {
             angle: number;
         };
 
-        type LayoutFunction = (ports: Array<dia.Element.Port>, elBBox: g.Rect, opt: Options) => Array<Transformation>;
+        interface LayoutOptions {
+            [key: string]: any;
+        }
 
-        interface Options {
+        type LayoutFunction<T = LayoutOptions> = (
+            portsArgs: Array<T>,
+            elBBox: g.Rect,
+            portGroupArgs: LayoutOptions
+        ) => Array<Partial<Transformation>>;
+
+        interface Options extends LayoutOptions {
             x?: number | string;
             y?: number | string;
             dx?: number;
@@ -3383,19 +3340,20 @@ export namespace layout {
             startAngle?: number;
             step?: number;
             compensateRotation?: boolean;
-            [key: string]: any;
         }
 
-        export var absolute: LayoutFunction;
+        /** @todo define Options types per-layout */
+        export var absolute: LayoutFunction<Options>;
+        export var line: LayoutFunction<Options>;
+        export var left: LayoutFunction<Options>;
+        export var right: LayoutFunction<Options>;
+        export var top: LayoutFunction<Options>;
+        export var bottom: LayoutFunction<Options>;
+        export var ellipseSpread: LayoutFunction<Options>;
+        export var ellipse: LayoutFunction<Options>;
+
         /** @deprecated */
-        export var fn: LayoutFunction;
-        export var line: LayoutFunction;
-        export var left: LayoutFunction;
-        export var right: LayoutFunction;
-        export var top: LayoutFunction;
-        export var bottom: LayoutFunction;
-        export var ellipseSpread: LayoutFunction;
-        export var ellipse: LayoutFunction;
+        export var fn: LayoutFunction<Options>;
     }
 
     export namespace PortLabel {