Release v4.2.0 (#3072)

zbynekstara · web-flow · commit ddc6d9027b74 · 2025-11-10T12:39:40.000+01:00
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,73 @@
+10-11-2025 (v4.2.0)
+
+  * add new ELK layout example
+
+  @joint/core
+  * dia.Paper - introduce layers API
+  * dia.Paper - rework `autoFreeze` option
+  * dia.Paper - add `measureNode()` callback option
+  * dia.Paper - add `findClosestMagnetToPoint()` method
+  * dia.Paper - add `viewManagement` option for advanced view lifecycle management
+  * dia.Paper - add `cellVisibility()` callback option
+  * dia.Paper - add `disposeHiddenCellViews()` method
+  * dia.Paper - add `prioritizeCellViewMount()` and `prioritizeCellViewUnmount()` methods
+  * dia.Paper - add `updateCellVisibility()` and `updateCellsVisibility()` methods
+  * dia.Paper - add `isCellVisible()` method
+  * dia.Paper - fix to only trigger `'render:idle'` event after all updates are completed
+  * dia.Paper - fix generic view detachment when `viewport()` callback returns `false`
+  * dia.Paper - fix to trigger `'render:*'` events when paper model is reset with no cells
+  * dia.Paper - fix rendering of first batch of updates in `async` mode to be asynchronous
+  * dia.LinkView - allow link-to-link snap
+  * dia.LinkView - fix to prevent link snap to a magnet when only the host cell is close enough
+  * dia.LinkView - fix missing arrowheads in WKWebView
+  * dia.CellView - make `getNodeBBox()` method work for nodes outside the render tree
+  * dia.CellView - optimize measurements of nodes referenced by `ref` attribute
+  * dia.Graph - add `syncCells()` method
+  * dia.Graph - add `removeCell()` method
+  * dia.Element - add `filter` option to `fitToChildren()` and `fitParent()` methods
+  * dia.Element - add `minRect` option to `fitToChildren()` and `fitParent()` methods
+  * dia.Element - support port position `args` inside `position` property
+  * dia.Element - add `getPortBBox()` and `getPortCenter()` methods
+  * dia.Element - support custom `portLayoutNamespace` and `portLabelLayoutNamespace`
+  * dia.Element - support passing custom port label layout functions to `label.position`
+  * dia.Element - optimize cloning in `getPort()` method
+  * dia.Element - optimize `hasPort()` and `hasPorts()` methods
+  * dia.Element - fix to parse numeric strings in port position args
+  * dia.Cell - add `getCenter()` method
+  * dia.Cell - add cell attributes merge strategy
+  * dia.Cell - support array paths in `transition()` and `stopTransition()` methods
+  * dia.Cell - expose `getAttributeDefinition()` method
+  * dia.Cell - fix to always create deep copy of arrays in constructor
+  * dia.attributes - add `useNoBreakSpace` which reinstates `V.sanitizeText()` functionality
+  * dia.attributes - fix `textWrap` attribute when Paper is not in render tree
+  * dia.HighlighterView - `z` option now supports highlighter positioning within SVG
+  * dia.HighlighterView - add static `has()` method to check if CellView has a highlighter attached
+  * dia.HighlighterView - fix to prevent highlighting nodes outside cell view
+  * dia.HighlighterView - fix to prevent removing not-yet-mounted HighlighterViews on unmount
+  * elementTools - fix tools position when attached directly to ElementView
+  * linkTools.Vertices - fix to call blur when `redundancyRemoval: false`
+  * anchors - add `useModelGeometry` option to all anchors
+  * anchors - add support for `calc()` expressions in `dx`, `dy` options
+  * anchors.midSide - add `mode` and `preferenceThreshold` options
+  * connectionPoints - add `useModelGeometry` option to `bbox` and `rectangle`
+  * mvc.View - allow providing custom `cid` in constructor
+  * mvc.Collection - use a Map to store references
+  * Vectorizer - add `safe` option to `getTransformToElement()` method
+  * Vectorizer - add static `getCommonAncestor()` method
+  * Vectorizer - add `useNoBreakSpace` option to `text()` method
+  * Vectorizer - deprecate static `sanitizeText()` method
+  * Vectorizer - fix to preserve camelCase in `attributeName`, `repeatCount` attribute names
+  * Vectorizer - fix to handle implicit line coordinates in `convertToPathData()` method
+  * Geometry - add `moveAroundPoint()` method to `Rect`
+  * fix to keep `'use strict'` for minified files
+
+  @joint/layout-directed-graph
+  * layout.DirectedGraph - support `clusterPadding: 'default'`
+  * layout.DirectedGraph - expose Dagre `disableOptimalOrderHeuristic` and `customOrder` options
+
+  @joint/layout-msagl
+  * layout.MSAGL - add new layout package utilizing the Microsoft Automatic Graph Layout
+
 13-03-2025 (v4.1.4)
 
   @joint/layout-directed-graph
diff --git a/examples/anchors-ts/package.json b/examples/anchors-ts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-anchors-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/connection-points-ts/package.json b/examples/connection-points-ts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-connection-points-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/container/package.json b/examples/container/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-container",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "dist/bundle.js",
   "author": {
     "name": "client IO",
diff --git a/examples/decorators/package.json b/examples/decorators/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-decorators",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/dwdm/package.json b/examples/dwdm/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-dwdm",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/fta-js/package.json b/examples/fta-js/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-fta-js",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.js",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/isometric/package.json b/examples/isometric/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-isometric",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/layout-directed-graph/package.json b/examples/layout-directed-graph/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-layout-directed-graph",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - Directed Graph Layout Demo",
   "main": "./index.js",
   "homepage": "https://jointjs.com",
diff --git a/examples/layout-elk-ts/package.json b/examples/layout-elk-ts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-elk-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - ELK Layout Demo",
   "main": "dist/bundle.js",
   "homepage": "https://jointjs.com",
diff --git a/examples/layout-msagl/package.json b/examples/layout-msagl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-layout-msagl",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - MSAGL Demo",
   "main": "dist/bundle.js",
   "homepage": "https://jointjs.com",
diff --git a/examples/libavoid/package.json b/examples/libavoid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-libavoid-js",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.js",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/link-labels-ts/package.json b/examples/link-labels-ts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-link-labels-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/list/package.json b/examples/list/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-list",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/offscreen-rendering/package.json b/examples/offscreen-rendering/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-offscreen-rendering-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/shapes-general/package.json b/examples/shapes-general/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-shapes-general",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/examples/tree-of-life/package.json b/examples/tree-of-life/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-tree-of-life",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "main": "src/index.ts",
   "author": {
     "name": "client IO",
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "joint",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "sideEffects": false,
   "homepage": "https://jointjs.com",
   "author": {
diff --git a/packages/joint-core/demo/custom-shapes/package.json b/packages/joint-core/demo/custom-shapes/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-custom-shapes",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - Custom Shapes Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/demo/elk/package.json b/packages/joint-core/demo/elk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-elk-graph",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - Eclipse Layout Kernel Graph Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/demo/rough/package.json b/packages/joint-core/demo/rough/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-rough",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - RoughJS Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/demo/tree-shake/package.json b/packages/joint-core/demo/tree-shake/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-tree-shake",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - Tree Shake Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/demo/ts-demo/package.json b/packages/joint-core/demo/ts-demo/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-ts",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - TypeScript Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/demo/vuejs/package.json b/packages/joint-core/demo/vuejs/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@joint/demo-vuejs",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JointJS - VueJS Demo",
   "main": "index.html",
   "homepage": "https://jointjs.com",
diff --git a/packages/joint-core/package.json b/packages/joint-core/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/core",
   "title": "JointJS",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "JavaScript diagramming library",
   "sideEffects": false,
   "main": "./dist/joint.min.js",
@@ -34,7 +34,8 @@
     "hoistingLimits": "workspaces"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "module": "./dist/joint.js"
   },
   "scripts": {
     "prepublishOnly": "echo \"Publishing via NPM is not allowed!\" && exit 1",
diff --git a/packages/joint-decorators/package.json b/packages/joint-decorators/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/decorators",
   "title": "JointJS Decorators",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "Decorators module for JointJS",
   "main": "build/index.js",
   "types": "build/index.d.ts",
diff --git a/packages/joint-layout-directed-graph/package.json b/packages/joint-layout-directed-graph/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/layout-directed-graph",
   "title": "JointJS LayoutDirectedGraph",
-  "version": "4.1.4",
+  "version": "4.2.0",
   "description": "LayoutDirectedGraph module for JointJS",
   "main": "dist/DirectedGraph.js",
   "module": "./DirectedGraph.mjs",
diff --git a/packages/joint-layout-msagl/package.json b/packages/joint-layout-msagl/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/layout-msagl",
   "title": "JointJS LayoutMSAGL",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "LayoutMSAGL module for JointJS",
   "sideEffects": false,
   "main": "./dist/esm/index.mjs",
diff --git a/packages/joint-shapes-general-tools/package.json b/packages/joint-shapes-general-tools/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/shapes-general-tools",
   "title": "JointJS General Shapes Tools",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "General Shapes Tools module for JointJS",
   "main": "build/index.js",
   "types": "build/index.d.ts",
diff --git a/packages/joint-shapes-general/package.json b/packages/joint-shapes-general/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@joint/shapes-general",
   "title": "JointJS General Shapes",
-  "version": "4.1.3",
+  "version": "4.2.0",
   "description": "General Shapes module for JointJS",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-anchors-ts",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.ts",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-connection-points-ts",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.ts",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-container",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "dist/bundle.js",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "client IO",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-decorators",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.ts",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-dwdm",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.ts",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-fta-js",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.js",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-isometric",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"main": "src/index.ts",`
`5`	`5`	`"homepage": "https://jointjs.com",`
`6`	`6`	`"author": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-layout-directed-graph",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"description": "JointJS - Directed Graph Layout Demo",`
`5`	`5`	`"main": "./index.js",`
`6`	`6`	`"homepage": "https://jointjs.com",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@joint/demo-elk-ts",`
`3`		`- "version": "4.1.3",`
	`3`	`+ "version": "4.2.0",`
`4`	`4`	`"description": "JointJS - ELK Layout Demo",`
`5`	`5`	`"main": "dist/bundle.js",`
`6`	`6`	`"homepage": "https://jointjs.com",`