clientIO · zbynekstara · Jul 24, 2026 · Aug 3, 2026
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -3,10 +3,11 @@ Thank you for submitting a pull request!
 
 Please verify that:
 * [ ] Code is up-to-date with the `master` branch
-* [ ] You've successfully run `grunt test` locally
+* [ ] You've successfully run `yarn test` locally
 * [ ] If applicable, there are new or updated unit tests validating the change
 * [ ] If applicable, there are new or updated @types
 * [ ] If applicable, documentation has been updated
+* [ ] You've declared a version bump with `yarn version-check` and committed the generated `.yarn/versions/*.yml` file (or the change needs no release)
 -->
 
 ## Description

diff --git a/.github/workflows/test-pr.yml b/.github/workflows/test-pr.yml
@@ -62,6 +62,13 @@ jobs:
         id: install-dependencies
         run: yarn install --immutable
 
+      # Ensure every PR declares version bumps for the packages it changes
+      # (deferred versioning: entries live in .yarn/versions/*.yml)
+      - name: Check version bumps
+        id: version-check
+        if: ${{ github.event_name == 'pull_request' }}
+        run: yarn version check
+
       # Build the joint project
       - name: Prepare joint
         id: prepare-joint

diff --git a/.yarnrc.yml b/.yarnrc.yml
@@ -1,5 +1,74 @@
 compressionLevel: mixed
 
+# Deferred versioning (`yarn version check` / `yarn version apply`).
+# `changesetBaseRefs` is the git ref the change detection diffs against;
+# `changesetIgnorePatterns` are paths that never require a version bump.
+changesetBaseRefs:
+  - master
+  - origin/master
+  - upstream/master
+
+changesetIgnorePatterns:
+  # A change to a publishable package requires a version bump ONLY when it
+  # touches distributed source, types, an entry file, or its package.json.
+  # = For reference, the following paths that ARE allowed to trigger a bump:
+  #- "**/src/**"                # source (all packages)
+  #- "**/types/**"              # @joint/core public type tree
+  #- "**/*.d.ts"                # hand-written type decls (svg.d.ts, DirectedGraph.d.ts)
+  #- "**/package.json"          # dependencies / exports / manifest
+  #- "**/wrappers/**"           # @joint/core build-time bundle wrappers
+  #- "**/mocks/**"              # @joint/vitest-plugin-mock-svg shipped mocks
+  #- "**/index.js"              # @joint/core entry
+  #- "**/index.mjs"             # @joint/eslint-config entry
+  #- "**/joint.mjs"             # @joint/core ESM entry
+  #- "**/DirectedGraph.mjs"     # @joint/layout-directed-graph entry
+  #- "**/eslint.config.*.mjs"   # @joint/eslint-config product configs
+  # = Everything below is IGNORED (never triggers a bump)
+
+  # Tests, mocks, benchmarks, demos, stories (not shipped)
+  - "**/*.test.{js,ts,mjs}"
+  - "**/test/**"
+  - "**/__mocks__/**"
+  - "**/bench/**"
+  - "**/demo/**"
+  - "**/stories/**"
+  - "**/.storybook/**"
+
+  # Generated build output & caches (produced from src/, git-ignored anyway)
+  - "**/dist/**"
+  - "**/build/**"
+  - "**/coverage/**"
+  - "**/coverage.json"
+  - "**/.tscache/**"
+
+  # Build & tooling scripts / config (do not change the published API)
+  - "**/scripts/**"
+  - "**/grunt/**"
+  - "**/Gruntfile.js"
+  - "**/Makefile"
+  - "**/rollup.config.*"
+  - "**/rollup.resources.mjs"
+  - "**/vite.config.*"
+  - "**/vitest.workspace.*"
+  - "**/jest.config.js"
+  - "**/jest.react18.config.mjs"
+  - "**/karma.conf.js"
+  - "**/tsconfig*.json"
+  - "**/dts-generator.config.js"
+  - "**/api-extractor.json"
+  - "**/knip.json"
+  - "**/typedoc.*"
+  - "**/.prettierrc*"
+  - "**/.gitignore"
+
+  # Per-package lint config only. @joint/eslint-config ships
+  # `eslint.config.<name>.mjs` files, which this exact pattern does NOT match.
+  - "**/eslint.config.mjs"
+
+  # Documentation & metadata
+  - "**/*.md"
+  - "**/LICENSE"
+
 enableGlobalCache: false
 
 logFilters:

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -72,6 +72,29 @@ Before submitting a PR, please verify:
 - [ ] If applicable, there are new or updated unit tests validating the change
 - [ ] If applicable, there are new or updated @types
 - [ ] If applicable, documentation has been updated
+- [ ] You've declared a version bump with `yarn version-check` and committed the generated `.yarn/versions/*.yml` file (or the change needs no release — e.g. tests/docs only)
+
+### Versioning Your Change
+
+We use [Yarn's deferred versioning](https://yarnpkg.com/features/release-workflow). Instead of
+editing `"version"` in `package.json`, you declare *what kind* of release your change is and let
+Yarn apply the actual bumps at release time.
+
+Before opening a PR, run from the repo root:
+
+```bash
+yarn version-check   # opens an interactive prompt (yarn version check --interactive)
+```
+
+Pick a bump for each changed package and commit the file Yarn writes under `.yarn/versions/`:
+
+- **patch** — a bug fix (`4.3.0` → `4.3.1`)
+- **minor** — a new backwards-compatible feature (`4.3.0` → `4.4.0`)
+- **major** — a breaking change (`4.3.0` → `5.0.0`)
+
+Your conventional-commit type is a good hint: `fix` → patch, `feat` → minor, a breaking change → major. When you bump a package, the prompt lists its dependents and asks you to decide, for each, whether they should be bumped too. Even though Yarn flags them all, you should `decline` them when the new version of the modified package matches the published range. For example, patch bump in `@joint/core` needs no dependent bumps, while a minor bump in `@joint/core` needs none from `@joint/react` but does from the rest. Note that this is a one-way consideration — dependent packages (e.g. `@joint/react`) may be bumped independently of packages they depend on.
+
+Changes to ignored paths (tests, docs, `examples/`) need no bump. CI runs `yarn version check` on every PR and will fail if a changed package is missing its version entry.
 
 ### Commit Message Format
 

diff --git a/examples/absolute-port-layout-dynamic-port-sizes-js/package.json b/examples/absolute-port-layout-dynamic-port-sizes-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-absolute-port-layout-dynamic-port-sizes-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/activity-diagram-js/package.json b/examples/activity-diagram-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-activity-diagram-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/anchors-ts/package.json b/examples/anchors-ts/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-anchors-ts",
-  "version": "4.3.1",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/angular-element-view-ts/package.json b/examples/angular-element-view-ts/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-angular-element-view-ts",
-  "version": "4.3.1",
   "private": true,
   "scripts": {
     "ng": "ng",

diff --git a/examples/animated-process-flow-diagram-js/package.json b/examples/animated-process-flow-diagram-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-animated-process-flow-diagram-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/bezier-js/package.json b/examples/bezier-js/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-bezier-js",
-  "version": "4.3.1",
   "main": "src/index.js",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/callouts-js/package.json b/examples/callouts-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-callouts-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/chatgpt-timeline-js/package.json b/examples/chatgpt-timeline-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-chatgpt-timeline-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/circular-layout-js/package.json b/examples/circular-layout-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-circular-layout-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/connection-points-ts/package.json b/examples/connection-points-ts/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-connection-points-ts",
-  "version": "4.3.1",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/connector-arrows-js/package.json b/examples/connector-arrows-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-connector-arrows-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/container/package.json b/examples/container/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-container",
-  "version": "4.3.1",
   "main": "dist/bundle.js",
   "author": {
     "name": "client IO",

diff --git a/examples/content-driven-shapes-js/package.json b/examples/content-driven-shapes-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-content-driven-shapes-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/control-tool-js/package.json b/examples/control-tool-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-control-tool-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/counters-js/package.json b/examples/counters-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-counters-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/curve-connector-js/package.json b/examples/curve-connector-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-curve-connector-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/decorators/package.json b/examples/decorators/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-decorators",
-  "version": "4.3.1",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/different-views-of-the-same-graph-js/package.json b/examples/different-views-of-the-same-graph-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-different-views-of-the-same-graph-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/drop-image-as-shape-js/package.json b/examples/drop-image-as-shape-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-drop-image-as-shape-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/dwdm/package.json b/examples/dwdm/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-dwdm",
-  "version": "4.3.1",
   "main": "src/index.ts",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/dynamic-font-size-js/package.json b/examples/dynamic-font-size-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-dynamic-font-size-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/dynamic-status-icons-js/package.json b/examples/dynamic-status-icons-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-dynamic-status-icons-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/electric-generator-js/package.json b/examples/electric-generator-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-electric-generator-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/element-connect-tool-js/package.json b/examples/element-connect-tool-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-element-connect-tool-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/element-port-and-link-label-markup-js/package.json b/examples/element-port-and-link-label-markup-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-element-port-and-link-label-markup-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/element-tags-and-badges-js/package.json b/examples/element-tags-and-badges-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-element-tags-and-badges-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/external-svg-images-js/package.json b/examples/external-svg-images-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-external-svg-images-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/fault-tree-analysis-js/package.json b/examples/fault-tree-analysis-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-fault-tree-analysis-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/fills-js/package.json b/examples/fills-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-fills-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/find-all-cells-between-2-elements-js/package.json b/examples/find-all-cells-between-2-elements-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-find-all-cells-between-2-elements-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/foreign-object-magnet-js/package.json b/examples/foreign-object-magnet-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-foreign-object-magnet-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/fta-js/package.json b/examples/fta-js/package.json
@@ -1,6 +1,5 @@
 {
   "name": "@joint/demo-fta-js",
-  "version": "4.3.1",
   "main": "src/index.js",
   "homepage": "https://jointjs.com",
   "author": {

diff --git a/examples/genogram-ts/package.json b/examples/genogram-ts/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-genogram-directed-graph-ts",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",

diff --git a/examples/hexagonal-grid-js/package.json b/examples/hexagonal-grid-js/package.json
@@ -1,7 +1,6 @@
 {
     "name": "@joint/demo-hexagonal-grid-js",
     "private": true,
-    "version": "4.3.1",
     "type": "module",
     "scripts": {
         "dev": "vite",