Merge branch 'master' into release/2.0.0

# Conflicts:
#	packages/core/src/utils/graph.ts

Author: bcakmakoglu

.github/workflows/build-and-test.yml

@@ -15,7 +15,9 @@ concurrency:
 jobs:
   build-and-test:
     runs-on: ${{ matrix.os }}
-
+    env:
+      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
+      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
     strategy:
       matrix:
         os: [ubuntu-latest]
@@ -34,23 +36,14 @@ jobs:
       - name: Install Dependencies 👨🏻‍💻
         uses: ./.github/actions/install-dependencies
 
-      - name: Setup Turbo cache 🏎️
-        id: turbo-cache
-        uses: actions/cache@v4
-        with:
-          path: .turbo
-          key: turbo-${{ runner.os }}-${{ github.sha }}
-          restore-keys: |
-            turbo-${{ runner.os }}-
-
       - name: Run linter 🧹
-        run: pnpm run lint --cache-dir=.turbo
+        run: pnpm run lint
 
       - name: Build Library 👷
-        run: pnpm run build --cache-dir=.turbo
+        run: pnpm run build
 
       - name: Run tests 🧪
         uses: cypress-io/github-action@v6
         with:
           install-command: pnpm cypress install
-          command: pnpm run test --cache-dir=.turbo
+          command: pnpm run test

CHANGELOG.md

@@ -2,6 +2,209 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.48.0] - 2025-11-21
+
+[ff69823](ff69823b9db45da9dd012852b8b7ec50bb45c6a9)...[09cb136](09cb136ab7326da269f2e97f926880be0605cff6)
+
+### Bug Fixes
+
+- Unwrap disableKeyboardA11y to check if keyboard movement is allowed (#1988) ([ce4a8fb](ce4a8fb00107edefc2cea7ac27b3c527fa396608))
+- Use position instead of computedPos as keyboard move pos (#1989) ([0ced769](0ced7692367d9bdeb927de4c339a6767e593e4b6))
+
+### Miscellaneous Tasks
+
+- Remove duplicate showZoom prop description ([04d9e59](04d9e591c73a6b2f168898ff1432dbad03859ac3))
+- Update showcase ([62a1d41](62a1d41a4336fa3596f1f82cfdcabfffdbd00c65))
+
+### Refactor
+
+- Separate import and export objects and interfaces (#1978) ([6008d63](6008d6330418ef2be99238b6789025808a819551))
+
+## [1.47.0] - 2025-10-02
+
+[9e2359c](9e2359c98a38b771d7f44f4a77615d6d7cf5bbbe)...[ff69823](ff69823b9db45da9dd012852b8b7ec50bb45c6a9)
+
+### Features
+
+- Replace fitView option offset with expressive padding (#1967) ([cca5ab8](cca5ab8c44abc409ac3b80e99ddc8f0cde18ee27))
+
+## [1.46.5] - 2025-09-22
+
+[dee75dd](dee75ddc1ad912eac67467ad52d71fd0bce93391)...[9e2359c](9e2359c98a38b771d7f44f4a77615d6d7cf5bbbe)
+
+### Bug Fixes
+
+- Unwrap connection line status ref (#1962) ([7729eff](7729eff1f0cd1462af0aaae17c2599292a343048))
+
+### Miscellaneous Tasks
+
+- Cleanup ([f3dc522](f3dc5226184df08d155b2eecb84dd70351960150))
+
+## [1.46.4] - 2025-09-11
+
+[c9c9040](c9c9040fb85a425081adbc4cdddf17df3c7b5a38)...[dee75dd](dee75ddc1ad912eac67467ad52d71fd0bce93391)
+
+### Bug Fixes
+
+- Remove node border styles from required styles (#1954) ([2ebe3d9](2ebe3d9088bc64524fe97cd88b3c9d32e0fe6643))
+
+## [1.46.3] - 2025-09-05
+
+[ed35bde](ed35bdeb0cefcdd16d543a1145b3770dd1053fc8)...[c9c9040](c9c9040fb85a425081adbc4cdddf17df3c7b5a38)
+
+### Bug Fixes
+
+- Add nullish operator to check visibility (#1942) ([67832e5](67832e528d9ff993773844a7bcb13026135c8492))
+
+## [1.46.2] - 2025-08-31
+
+[7a46a74](7a46a746acb8f3db09c01f31f76b6749032ad2fe)...[ed35bde](ed35bdeb0cefcdd16d543a1145b3770dd1053fc8)
+
+### Bug Fixes
+
+- Only emit position changes if  change occurred (#1939) ([2bacaa8](2bacaa8b2df18f924302af2a4b39cdcdc4b1bc41))
+
+## [1.46.1] - 2025-08-31
+
+[e293519](e293519ee2ec3fd8103707491cbbc401e1be09af)...[7a46a74](7a46a746acb8f3db09c01f31f76b6749032ad2fe)
+
+### Bug Fixes
+
+- Use valid handle result as connecting handle (#1932) ([dd48e47](dd48e47d02a81cfabc2ba32f0bf24bc9b1f09f76))
+- Correctly check if an event has any listeners bound to it (#1935) ([e9f0cdf](e9f0cdff3d26141a01cfcad0e355d9607210a68d))
+- Skip resize handler if node not visible (#1936) ([c9c26d0](c9c26d02f6c2e875381a9eb93b774857658b2d31))
+- Prevent multi touch from aborting connections (#1938) ([490473d](490473d997120ab640a25a7012f34c223f6d41a7))
+
+### Documentation
+
+- Remove info on pointer events removal when elements selectable is false ([3c96b38](3c96b385c31f005b04460165817d8c803504772a))
+
+### Refactor
+
+- Avoid passing reactive values to position changes (#1937) ([bd606b9](bd606b98a205a6fe9f40be76a57a025a7605e424))
+
+## [1.46.0] - 2025-08-15
+
+[e094426](e0944266bf1ed813db0cf70fb46fac7c87aa17c5)...[e293519](e293519ee2ec3fd8103707491cbbc401e1be09af)
+
+### Bug Fixes
+
+- Use 1 as zoomstep for minimap and apply factor based on macOs (#1923) ([58a52e1](58a52e137421e5939313760c91f6da2791d3777d))
+- Fetch correct source and target nodes for isValidConnection (#1922) ([c2aad1e](c2aad1e43bd5c3bc661b2a4f907591468ab49006))
+
+### Documentation
+
+- Helper lines (#1915) ([5dc276a](5dc276af52994f83ecd96e86ddcf8dd1a339ac80))
+
+### Features
+
+- Expose wheelDelta utility (#1918) ([5fbbc82](5fbbc826e5929d10c01605192ea4598e0a520883))
+
+### Refactor
+
+- Use event target for Handle pointer down events (#1924) ([299a045](299a04531e20a626494e32ee4d92a1cf5bbda07b))
+
+## [1.45.1] - 2025-08-07
+
+[45225bf](45225bf973bccca97183da9f8105dcc6a3b0bf89)...[e094426](e0944266bf1ed813db0cf70fb46fac7c87aa17c5)
+
+### Bug Fixes
+
+- Use correct handlesuffix in getHandleConnections  (#1880) ([a43da6f](a43da6f1ec2320fa17c3b8cdfcfd70348b1b2681))
+- Add `type="button"` to avoid form submissions (#1911) (#1912) ([dfae661](dfae6619e2ec9827ca29f4a760820402c3e2f630))
+- Emit node drag-start, drag and drag-end events on selection drag (#1913) ([ed18865](ed18865525545ff66ef752e0f588a87610c235ce))
+- Calculate overlapping area correctly (#1914) ([e97a65b](e97a65b6b56ee2168b329cd23ee0e9d9099af146))
+
+### Documentation
+
+- Code errors in "Updating Node Data" (#1900) ([b5c4c0e](b5c4c0e3f5b595e2cbb99968f1ccb826d94338ce))
+
+### Examples
+
+- Cleanup basic example ([e094426](e0944266bf1ed813db0cf70fb46fac7c87aa17c5))
+
+### Refactor
+
+- Add auto-scale prop & scale resize controls with zoom level (#1872) ([f4e139f](f4e139f1bcd6038b54efeff83328b06847feeda3))
+
+## [1.45.0] - 2025-06-10
+
+[a16d851](a16d851894e2c4d7053e34cefd9aa3dc7522ad95)...[45225bf](45225bf973bccca97183da9f8105dcc6a3b0bf89)
+
+### Documentation
+
+- Add vitepress plugin llms (#1865) ([eec568c](eec568cbb77c863857af5508b287d4b1db34493c))
+
+### Features
+
+- Add dom attributes option for nodes (#1861) ([4c1b064](4c1b06423052923d759ecdb331f57cb0f59d18de))
+- Add dom attributes option for nodes and edges (#1869) ([8fa7010](8fa70107a008de4bd9ff62763e5a242ce2a60277))
+
+## [1.44.0] - 2025-05-19
+
+[7ecca61](7ecca6141f7dd817b00517cee4e549fb5c783c45)...[a16d851](a16d851894e2c4d7053e34cefd9aa3dc7522ad95)
+
+### Features
+
+- Add ease option to viewport transform functions  (#1848) ([00bc28b](00bc28bf1b675d856f3613c6a30802d7ea9628ba))
+- Add interpolate option to viewport transforming functions  (#1851) ([505fbfe](505fbfef7488d8fe98a3f2b459135794b8110633))
+
+### Refactor
+
+- Use shallowRef where possible (#1847) ([b792d7f](b792d7f536ec224c51aaf822cdb96baf158fb0c2))
+
+## [1.43.2] - 2025-05-15
+
+[96e07ee](96e07eeb9db83defd04369522e6cb2171285948e)...[7ecca61](7ecca6141f7dd817b00517cee4e549fb5c783c45)
+
+### Bug Fixes
+
+- Allow multiselect when input is focused (#1842) ([666e4ea](666e4eababac0b5c99e269eaa217f9f93d6d77e0))
+- Use whole handle for snapping area (#1843) ([735c81c](735c81c63f4eab13b5660211c9696078e754c03b))
+
+## [1.43.1] - 2025-04-24
+
+[78e29f2](78e29f225950c956f936c76ffb2dc29013ddc915)...[96e07ee](96e07eeb9db83defd04369522e6cb2171285948e)
+
+### Bug Fixes
+
+- Add missing vue-flow__container class to marker defs (#1833) ([ae9c6a0](ae9c6a0fe2e40d62c2d663d5b68772dda8c62403))
+
+### Ci
+
+- Use turbo remote cache ([00e2146](00e21465547aafe64fe06da83ccccab62b07107f))
+
+## [1.43.0] - 2025-04-23
+
+[c24ba07](c24ba071f16f95e7149e876624b790cbc9341071)...[78e29f2](78e29f225950c956f936c76ffb2dc29013ddc915)
+
+### Bug Fixes
+
+- Add aria hidden to markers (#1817) ([cb588c8](cb588c8aa9dc0d9962e8be62f7e08b5b24cb836a))
+- Subtract container bounds when getting pointer position (#1829) ([265f928](265f928f13c95a4944acd1f4c387941cea99c5bb))
+- Fall back to changedTouches for touchend events (#1830) ([cc65f12](cc65f12af9e2fe550270acde75a759be6cc37550))
+
+### Documentation
+
+- Correct template syntax (#1797) ([8f5f573](8f5f57381501c0c0e1f0dd6e5248cc7eed2e13da))
+
+### Miscellaneous Tasks
+
+- Cleanup getHandleBounds  (#1828) ([7d9ffe3](7d9ffe3f356d9300041e7f15cf3fc9bd63d13eb9))
+
+### Refactor
+
+- Allow passing null/undefined to use node connection args (#1820) ([7a09afa](7a09afa12acab084d849c7134fcbbb1367ff456d))
+
+## [1.42.5] - 2025-03-29
+
+[f49e509](f49e50996f4d9e294b45b0125e45231acc45b3be)...[c24ba07](c24ba071f16f95e7149e876624b790cbc9341071)
+
+### Bug Fixes
+
+- Add button to elements to ignore in useKeyPress (#1807) ([967569a](967569aa6d75945fd5375fbaee6a4c2507af29f4))
+- Filter hidden nodes from bounds (#1808) ([da6dc8b](da6dc8bdf9004fb8394c75a5fd24cc3f46ebcbd5))
+
 ## [1.42.4] - 2025-03-17
 
 [e9168d3](e9168d30841ec0cdb15c4034a3fe89f26657b5dc)...[f49e509](f49e50996f4d9e294b45b0125e45231acc45b3be)

docs/components/home/Showcase.vue

@@ -7,30 +7,31 @@
   >
     <div class="max-w-5/6 2xl:max-w-7xl mx-auto py-12 md:py-16">
       <div class="flex flex-col items-center justify-center gap-2">
-        <h1>Putting Ideas into Action: The Showcase</h1>
+        <h1 class="text-center">Putting Ideas into Action - The Showcase</h1>
 
         <p class="font-medium max-w-3/4 text-center">
           Whether you're a seasoned developer or just starting your journey with Vue Flow, this showcase offers inspiration and
           insights into what's possible. Dive in and discover the potential of Vue Flow for your next project.
         </p>
 
         <div
-          class="divide-y divide-secondary md:divide-y-0 flex flex-col md:flex-row justify-between items-center gap-12 mt-8 text-center md:text-left"
+          class="divide-y divide-secondary md:divide-y-0 flex flex-col md:flex-row justify-between items-start gap-12 mt-8 text-center md:text-left"
         >
           <div class="flex-1 flex flex-col items-center md:items-start">
             <div
               class="h-[200px] md:min-h-[300px] w-full shadow-xl rounded-xl font-mono uppercase border-1 border-gray overflow-hidden"
             >
-              <img class="object-cover h-full w-full" src="/assets/octai.png" alt="Octai" />
+              <img class="object-cover h-full w-full" src="/assets/n8n.webp" alt="n8n" />
             </div>
 
             <div class="px-1">
-              <a href="https://octai.com" target="_blank">
-                <h2 class="text-3xl mt-6 font-semibold inline-block">Octai</h2>
+              <a href="https://n8n.io" target="_blank">
+                <h2 class="text-3xl mt-6 font-semibold inline-block">n8n</h2>
               </a>
 
               <h3 class="text-lg">
-                A Machine-Learning NoCode platform using a node-based UI for Data Scientists and Developers.
+                n8n is an open-source workflow automation platform that lets you connect apps, APIs, and services to create
+                automated processes using a visual, node-based interface.
               </h3>
             </div>
           </div>
@@ -47,7 +48,10 @@
                 <h2 class="text-3xl mt-6 font-semibold inline-block">Kestra</h2>
               </a>
 
-              <h3 class="text-lg">An open-source orchestrator that makes both scheduled and event-driven workflows easy.</h3>
+              <h3 class="text-lg">
+                Kestra is an open-source, declarative orchestration and workflow automation platform that enables you to define,
+                schedule, and govern complex processes as code (YAML) with UI support.
+              </h3>
             </div>
           </div>
         </div>

docs/examples/helper-lines/App.vue

@@ -0,0 +1,46 @@
+<script setup lang="ts">
+import type { GraphNode, Node, NodeChange } from '@vue-flow/core'
+import { VueFlow, useVueFlow } from '@vue-flow/core'
+import { ref } from 'vue'
+import HelperLines from './HelperLines.vue'
+import { getHelperLines } from './utils'
+import { initialNodes } from './initialElements'
+
+const { applyNodeChanges } = useVueFlow()
+
+const nodes = ref<Node[]>(initialNodes)
+
+const helperLineHorizontal = ref<number | undefined>(undefined)
+const helperLineVertical = ref<number | undefined>(undefined)
+
+function updateHelperLines(changes: NodeChange[], nodes: GraphNode[]) {
+  helperLineHorizontal.value = undefined
+  helperLineVertical.value = undefined
+
+  if (changes.length === 1 && changes[0].type === 'position' && changes[0].dragging && changes[0].position) {
+    const helperLines = getHelperLines(changes[0], nodes)
+
+    // if we have a helper line, we snap the node to the helper line position
+    // this is being done by manipulating the node position inside the change object
+    changes[0].position.x = helperLines.snapPosition.x ?? changes[0].position.x
+    changes[0].position.y = helperLines.snapPosition.y ?? changes[0].position.y
+
+    // if helper lines are returned, we set them so that they can be displayed
+    helperLineHorizontal.value = helperLines.horizontal
+    helperLineVertical.value = helperLines.vertical
+  }
+
+  return changes
+}
+
+function onNodesChange(changes: NodeChange[]) {
+  const updatedChanges = updateHelperLines(changes, nodes.value as GraphNode[])
+  nodes.value = applyNodeChanges(updatedChanges)
+}
+</script>
+
+<template>
+  <VueFlow :nodes="nodes" fit-view-on-init @nodes-change="onNodesChange">
+    <HelperLines :horizontal="helperLineHorizontal" :vertical="helperLineVertical" />
+  </VueFlow>
+</template>