@lupinum/board-core 1.0.0-beta.2 → 1.0.0-beta.4

package/README.md

@@ -17,6 +17,30 @@
 
 Use this package for board state, commands, selection, grouping, camera control, snapping, guards, events, and first-party plugin hooks.
 
+<!-- BEGIN:consumer-onboarding -->
+
+## Use a coding agent
+
+A coding agent is a development tool that can inspect and change your project.
+
+Copy this task prompt into your application agent:
+
+```text
+Use the installed Nuxt Board packages to implement my requested feature.
+Read the application's instructions first. Resolve @lupinum/board-core/agent-docs
+and each installed Board package’s agent-docs entry from this application
+directory. Read the relevant local pages.
+Preserve the existing AGENTS.md. If it has no equivalent guidance, append
+one short note to resolve installed package docs before integration work
+and after dependency changes. Do not install a consumer skill.
+Check the completed feature using this project's normal commands.
+```
+
+The installed documentation matches the package version. If an older version
+has no documentation export, use its README, types and matching release docs.
+
+<!-- END:consumer-onboarding -->
+
 ## Requirements
 
 The package is framework independent. Use `@lupinum/vue-board` or `@lupinum/nuxt-board` when you need rendering.

package/dist/agent/AGENTS.md

@@ -0,0 +1,63 @@
+# @lupinum/board-core
+
+Documentation for installed version 1.0.0-beta.4.
+
+Read the relevant local pages before changing this package’s integration.
+Project instructions govern architecture, style and permissions.
+
+## Start here
+
+- [Installation](./pages/docs/start-building/installation.md) — /docs/start-building/installation
+- [@lupinum/board-core](./pages/docs/reference/board-core.md) — /docs/reference/board-core
+
+## Find a page
+
+The index below maps public documentation routes to this installed snapshot.
+For links to this documentation site, use the matching local page in manifest.json
+instead of fetching a possibly different website version. Preserve URL fragments.
+External dependencies have their own versioned contracts. Report missing guidance.
+
+- [Nuxt Board documentation](./pages/docs.md) — /docs
+- [Connections](./pages/docs/build-features/connections.md) — /docs/build-features/connections
+- [Custom renderers](./pages/docs/build-features/custom-node-renderers.md) — /docs/build-features/custom-node-renderers
+- [Group nodes](./pages/docs/build-features/groups-and-nesting.md) — /docs/build-features/groups-and-nesting
+- [Performance](./pages/docs/build-features/performance.md) — /docs/build-features/performance
+- [First-party features and command guards](./pages/docs/build-features/read-only-and-command-guards.md) — /docs/build-features/read-only-and-command-guards
+- [Serialization](./pages/docs/build-features/save-and-load.md) — /docs/build-features/save-and-load
+- [Selection and interaction](./pages/docs/build-features/selection-and-keyboard.md) — /docs/build-features/selection-and-keyboard
+- [SSR deterministic scene](./pages/docs/build-features/ssr-and-deterministic-state.md) — /docs/build-features/ssr-and-deterministic-state
+- [Theming](./pages/docs/build-features/theming.md) — /docs/build-features/theming
+- [History](./pages/docs/build-features/undo-and-redo.md) — /docs/build-features/undo-and-redo
+- [Design decisions](./pages/docs/evaluate/design-decisions.md) — /docs/evaluate/design-decisions
+- [How Nuxt Board works](./pages/docs/evaluate/how-nuxt-board-works.md) — /docs/evaluate/how-nuxt-board-works
+- [Why Nuxt Board](./pages/docs/evaluate/why-nuxt-board.md) — /docs/evaluate/why-nuxt-board
+- [Contributing](./pages/docs/project/contributing.md) — /docs/project/contributing
+- [Support and security](./pages/docs/project/support-and-security.md) — /docs/project/support-and-security
+- [@lupinum/board-core types](./pages/docs/reference/board-core-types.md) — /docs/reference/board-core-types
+- [@lupinum/board-core](./pages/docs/reference/board-core.md) — /docs/reference/board-core
+- [@lupinum/board-connections](./pages/docs/reference/connections.md) — /docs/reference/connections
+- [Events and subscriptions](./pages/docs/reference/events-and-errors.md) — /docs/reference/events-and-errors
+- [Glossary](./pages/docs/reference/glossary.md) — /docs/reference/glossary
+- [@lupinum/board-history](./pages/docs/reference/history.md) — /docs/reference/history
+- [@lupinum/vue-board/minimap](./pages/docs/reference/minimap.md) — /docs/reference/minimap
+- [@lupinum/nuxt-board](./pages/docs/reference/nuxt-board.md) — /docs/reference/nuxt-board
+- [Package overview](./pages/docs/reference/package-overview.md) — /docs/reference/package-overview
+- [@lupinum/vue-board](./pages/docs/reference/vue-board.md) — /docs/reference/vue-board
+- [Vue composables](./pages/docs/reference/vue-composables.md) — /docs/reference/vue-composables
+- [Mind map](./pages/docs/solutions/mind-map.md) — /docs/solutions/mind-map
+- [Nuxt auto-imports](./pages/docs/solutions/nuxt-application.md) — /docs/solutions/nuxt-application
+- [Planning board](./pages/docs/solutions/planning-board.md) — /docs/solutions/planning-board
+- [Read-only viewer](./pages/docs/solutions/read-only-viewer.md) — /docs/solutions/read-only-viewer
+- [Workflow renderer demo](./pages/docs/solutions/workflow-builder.md) — /docs/solutions/workflow-builder
+- [Add connections and history](./pages/docs/start-building/add-connections-and-history.md) — /docs/start-building/add-connections-and-history
+- [Customize your first node](./pages/docs/start-building/customize-your-first-node.md) — /docs/start-building/customize-your-first-node
+- [Installation](./pages/docs/start-building/installation.md) — /docs/start-building/installation
+- [Your first board](./pages/docs/start-building/your-first-board.md) — /docs/start-building/your-first-board
+- [Camera and coordinates](./pages/docs/understand-the-system/camera-and-coordinates.md) — /docs/understand-the-system/camera-and-coordinates
+- [Commands and transactions](./pages/docs/understand-the-system/commands-and-transactions.md) — /docs/understand-the-system/commands-and-transactions
+- [Document and session state](./pages/docs/understand-the-system/document-and-session-state.md) — /docs/understand-the-system/document-and-session-state
+- [Nodes and hierarchy](./pages/docs/understand-the-system/nodes-and-hierarchy.md) — /docs/understand-the-system/nodes-and-hierarchy
+- [Packages and plugins](./pages/docs/understand-the-system/packages-and-plugins.md) — /docs/understand-the-system/packages-and-plugins
+- [Persistence and JSON Canvas](./pages/docs/understand-the-system/persistence-and-json-canvas.md) — /docs/understand-the-system/persistence-and-json-canvas
+- [Rendering and interaction](./pages/docs/understand-the-system/rendering-and-interaction.md) — /docs/understand-the-system/rendering-and-interaction
+- [The engine](./pages/docs/understand-the-system/the-engine.md) — /docs/understand-the-system/the-engine

package/dist/agent/manifest.json

@@ -0,0 +1,320 @@
+{
+  "schemaVersion": 1,
+  "name": "@lupinum/board-core",
+  "version": "1.0.0-beta.4",
+  "entrySha256": "8bb3494aaab14b693dbbb72cd0a9c82627c17e0a4a54d51a359b75942aed8991",
+  "startRoutes": [
+    "/docs/start-building/installation",
+    "/docs/reference/board-core"
+  ],
+  "pages": [
+    {
+      "title": "Nuxt Board documentation",
+      "route": "/docs",
+      "url": "https://nuxt-board.lupinum.com/docs",
+      "file": "pages/docs.md",
+      "sha256": "12aaf7fa607f2941e1dd2ca3f7edd2472e09ba8152a8792d5cb11b26ef3cecfd"
+    },
+    {
+      "title": "Connections",
+      "route": "/docs/build-features/connections",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/connections",
+      "file": "pages/docs/build-features/connections.md",
+      "sha256": "f28b76bb85f27a3424f2e17cfa0a94382f8f42c37a3f8d4fc88888a2c515b0f7"
+    },
+    {
+      "title": "Custom renderers",
+      "route": "/docs/build-features/custom-node-renderers",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/custom-node-renderers",
+      "file": "pages/docs/build-features/custom-node-renderers.md",
+      "sha256": "5dcf0f3aeabbd8c2e2336ec56b8242d8241aac670674b12eb773cade0a0292f1"
+    },
+    {
+      "title": "Group nodes",
+      "route": "/docs/build-features/groups-and-nesting",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/groups-and-nesting",
+      "file": "pages/docs/build-features/groups-and-nesting.md",
+      "sha256": "b2f18338dddfcedb7be0d64224c5b4ff36fa1bb8faeae1b3e537366207051a8e"
+    },
+    {
+      "title": "Performance",
+      "route": "/docs/build-features/performance",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/performance",
+      "file": "pages/docs/build-features/performance.md",
+      "sha256": "3d8ece5404eb2dd61446d1b750c4e5447b19f4a681fceb8f9c285bc3b6e1853f"
+    },
+    {
+      "title": "First-party features and command guards",
+      "route": "/docs/build-features/read-only-and-command-guards",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/read-only-and-command-guards",
+      "file": "pages/docs/build-features/read-only-and-command-guards.md",
+      "sha256": "38c06b1175089a47425ad4cc5e2f31785e934d00cf2dc02e4ef818781074ddbf"
+    },
+    {
+      "title": "Serialization",
+      "route": "/docs/build-features/save-and-load",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/save-and-load",
+      "file": "pages/docs/build-features/save-and-load.md",
+      "sha256": "e0a558f4827b1dfa28014a7301f91c9194bf8579d0b24b8409c0670c4bffbc79"
+    },
+    {
+      "title": "Selection and interaction",
+      "route": "/docs/build-features/selection-and-keyboard",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/selection-and-keyboard",
+      "file": "pages/docs/build-features/selection-and-keyboard.md",
+      "sha256": "b6e7cc4b87910ab2e955f4159a9a9d2a938bb576282e5142c9bc6f2a9fcd425c"
+    },
+    {
+      "title": "SSR deterministic scene",
+      "route": "/docs/build-features/ssr-and-deterministic-state",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/ssr-and-deterministic-state",
+      "file": "pages/docs/build-features/ssr-and-deterministic-state.md",
+      "sha256": "20f3a7e0c97889335f1b9a34e1403d02caaded9301953e09f6d1e7ac75a2a995"
+    },
+    {
+      "title": "Theming",
+      "route": "/docs/build-features/theming",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/theming",
+      "file": "pages/docs/build-features/theming.md",
+      "sha256": "1809f4e51693340e777b13a24d17be7adeb50e14f1cfbdbba35150bfbbb85a67"
+    },
+    {
+      "title": "History",
+      "route": "/docs/build-features/undo-and-redo",
+      "url": "https://nuxt-board.lupinum.com/docs/build-features/undo-and-redo",
+      "file": "pages/docs/build-features/undo-and-redo.md",
+      "sha256": "b5e743162727210e404afa9f34ec0642d5084887bd4d502d33a3320abcbdff93"
+    },
+    {
+      "title": "Design decisions",
+      "route": "/docs/evaluate/design-decisions",
+      "url": "https://nuxt-board.lupinum.com/docs/evaluate/design-decisions",
+      "file": "pages/docs/evaluate/design-decisions.md",
+      "sha256": "cefccf196ec4a9eb2caf37dfec2da1d69dff81e7c42ab74d531d94af8070f49a"
+    },
+    {
+      "title": "How Nuxt Board works",
+      "route": "/docs/evaluate/how-nuxt-board-works",
+      "url": "https://nuxt-board.lupinum.com/docs/evaluate/how-nuxt-board-works",
+      "file": "pages/docs/evaluate/how-nuxt-board-works.md",
+      "sha256": "b7094845c580b764661bf7a12c22e29826e8632f095b76f08b16e5ee244d9a56"
+    },
+    {
+      "title": "Why Nuxt Board",
+      "route": "/docs/evaluate/why-nuxt-board",
+      "url": "https://nuxt-board.lupinum.com/docs/evaluate/why-nuxt-board",
+      "file": "pages/docs/evaluate/why-nuxt-board.md",
+      "sha256": "284375805ad6f0a8351dab4ce391519e4e516ae732951dfee69148f637d3406e"
+    },
+    {
+      "title": "Contributing",
+      "route": "/docs/project/contributing",
+      "url": "https://nuxt-board.lupinum.com/docs/project/contributing",
+      "file": "pages/docs/project/contributing.md",
+      "sha256": "ec5c9d0295538c7354caf9b314f5bdc6a33e31cb42dbc1eaf9e2761bab08bdb9"
+    },
+    {
+      "title": "Support and security",
+      "route": "/docs/project/support-and-security",
+      "url": "https://nuxt-board.lupinum.com/docs/project/support-and-security",
+      "file": "pages/docs/project/support-and-security.md",
+      "sha256": "b5619172ef92dbc503b7568bd4f32f45e9911e52909b0bcd21c9503eea462779"
+    },
+    {
+      "title": "@lupinum/board-core types",
+      "route": "/docs/reference/board-core-types",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/board-core-types",
+      "file": "pages/docs/reference/board-core-types.md",
+      "sha256": "82994a98bf1afbab16149e6fa3a6285998c986c36047114f7f5728cbdd21a856"
+    },
+    {
+      "title": "@lupinum/board-core",
+      "route": "/docs/reference/board-core",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/board-core",
+      "file": "pages/docs/reference/board-core.md",
+      "sha256": "56f9e8c73d0cd03a3aee573b4e654d506514e1aed60c2e849f2e74f4e2200f6c"
+    },
+    {
+      "title": "@lupinum/board-connections",
+      "route": "/docs/reference/connections",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/connections",
+      "file": "pages/docs/reference/connections.md",
+      "sha256": "afa0a0d6a480999dec9888cc69d032822943bd31ae4787dd98d6a44e65bae8a0"
+    },
+    {
+      "title": "Events and subscriptions",
+      "route": "/docs/reference/events-and-errors",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/events-and-errors",
+      "file": "pages/docs/reference/events-and-errors.md",
+      "sha256": "45be4331a1aba94e1766b07655bcfd315522d7814e70957585bc9646adb119e3"
+    },
+    {
+      "title": "Glossary",
+      "route": "/docs/reference/glossary",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/glossary",
+      "file": "pages/docs/reference/glossary.md",
+      "sha256": "ae65c10dbfe65bf9e525c8e7e14ad9d7c45e72915c3e74be7715a24f51c692fd"
+    },
+    {
+      "title": "@lupinum/board-history",
+      "route": "/docs/reference/history",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/history",
+      "file": "pages/docs/reference/history.md",
+      "sha256": "944d6245cb0b9a6194d84b5f0a243dcbb51dd7d618eae4e1cce3408520206770"
+    },
+    {
+      "title": "@lupinum/vue-board/minimap",
+      "route": "/docs/reference/minimap",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/minimap",
+      "file": "pages/docs/reference/minimap.md",
+      "sha256": "970f22a864dc84fedfea12edbe4fb780aa53c18714bae6d503876f2e2fc30c26"
+    },
+    {
+      "title": "@lupinum/nuxt-board",
+      "route": "/docs/reference/nuxt-board",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/nuxt-board",
+      "file": "pages/docs/reference/nuxt-board.md",
+      "sha256": "4514aa3f51777b71e24785876fca146100ce4ca1c9dff3857d6807c166c5eeca"
+    },
+    {
+      "title": "Package overview",
+      "route": "/docs/reference/package-overview",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/package-overview",
+      "file": "pages/docs/reference/package-overview.md",
+      "sha256": "135d1326da46de41cf6405e8e846f02bb397089dc6b5a8000515ed7cccb5604e"
+    },
+    {
+      "title": "@lupinum/vue-board",
+      "route": "/docs/reference/vue-board",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/vue-board",
+      "file": "pages/docs/reference/vue-board.md",
+      "sha256": "fb58c66c279c57feaa74c808c00ed64971c638faa7867dbd85704b7cc42b71a3"
+    },
+    {
+      "title": "Vue composables",
+      "route": "/docs/reference/vue-composables",
+      "url": "https://nuxt-board.lupinum.com/docs/reference/vue-composables",
+      "file": "pages/docs/reference/vue-composables.md",
+      "sha256": "e8226d7cce8ca005382ffd2d53ecf9e6fce2f52dda7d8c7c1f9bc14d88625736"
+    },
+    {
+      "title": "Mind map",
+      "route": "/docs/solutions/mind-map",
+      "url": "https://nuxt-board.lupinum.com/docs/solutions/mind-map",
+      "file": "pages/docs/solutions/mind-map.md",
+      "sha256": "5a9eba776aab3fc4492ce181a295e6f45c37eba7dc58fe198398a152f58c2f1a"
+    },
+    {
+      "title": "Nuxt auto-imports",
+      "route": "/docs/solutions/nuxt-application",
+      "url": "https://nuxt-board.lupinum.com/docs/solutions/nuxt-application",
+      "file": "pages/docs/solutions/nuxt-application.md",
+      "sha256": "0f855165d85ce0da750cb434916a9a0a9114dc8460e632f8afd799edbdb58b38"
+    },
+    {
+      "title": "Planning board",
+      "route": "/docs/solutions/planning-board",
+      "url": "https://nuxt-board.lupinum.com/docs/solutions/planning-board",
+      "file": "pages/docs/solutions/planning-board.md",
+      "sha256": "9033d0a52106920e3a08695ed2b9de53d718ee876bca29d28c7a7463ecfc6a2c"
+    },
+    {
+      "title": "Read-only viewer",
+      "route": "/docs/solutions/read-only-viewer",
+      "url": "https://nuxt-board.lupinum.com/docs/solutions/read-only-viewer",
+      "file": "pages/docs/solutions/read-only-viewer.md",
+      "sha256": "a8a8a5a62a420c734ab3e0ead6a0648304d6ddb99ecc73d5cc9a39bcbe88e014"
+    },
+    {
+      "title": "Workflow renderer demo",
+      "route": "/docs/solutions/workflow-builder",
+      "url": "https://nuxt-board.lupinum.com/docs/solutions/workflow-builder",
+      "file": "pages/docs/solutions/workflow-builder.md",
+      "sha256": "9a16bc300abf99c28514b99119f30c79dec010cedf9e4b8b3b4cf0fac8dac382"
+    },
+    {
+      "title": "Add connections and history",
+      "route": "/docs/start-building/add-connections-and-history",
+      "url": "https://nuxt-board.lupinum.com/docs/start-building/add-connections-and-history",
+      "file": "pages/docs/start-building/add-connections-and-history.md",
+      "sha256": "77db54ed7c65f365da0a89654a4545142b4ccf83755989e0a5d90d3c9412d963"
+    },
+    {
+      "title": "Customize your first node",
+      "route": "/docs/start-building/customize-your-first-node",
+      "url": "https://nuxt-board.lupinum.com/docs/start-building/customize-your-first-node",
+      "file": "pages/docs/start-building/customize-your-first-node.md",
+      "sha256": "e63461480fc5d41ad4944e17b90484a5d7656fad30211cc745e4de4d229642a2"
+    },
+    {
+      "title": "Installation",
+      "route": "/docs/start-building/installation",
+      "url": "https://nuxt-board.lupinum.com/docs/start-building/installation",
+      "file": "pages/docs/start-building/installation.md",
+      "sha256": "2b264cf614455ed93eb1a83be0ad2d3d8959fcb3bf9191be0cea7565b20c00a1"
+    },
+    {
+      "title": "Your first board",
+      "route": "/docs/start-building/your-first-board",
+      "url": "https://nuxt-board.lupinum.com/docs/start-building/your-first-board",
+      "file": "pages/docs/start-building/your-first-board.md",
+      "sha256": "e49f81d90233da1dca3e786cd16215e3a12e308cff029194b6bce67d8ce25445"
+    },
+    {
+      "title": "Camera and coordinates",
+      "route": "/docs/understand-the-system/camera-and-coordinates",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/camera-and-coordinates",
+      "file": "pages/docs/understand-the-system/camera-and-coordinates.md",
+      "sha256": "098b553aba9d20ccedc9b942f68fdfebde5c1a1c12c032a74d8cdb5b41f477b8"
+    },
+    {
+      "title": "Commands and transactions",
+      "route": "/docs/understand-the-system/commands-and-transactions",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/commands-and-transactions",
+      "file": "pages/docs/understand-the-system/commands-and-transactions.md",
+      "sha256": "c79e309fbeb811bab40eb69fa1703335f42ccf2894c5325e2e54e61a32184da2"
+    },
+    {
+      "title": "Document and session state",
+      "route": "/docs/understand-the-system/document-and-session-state",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/document-and-session-state",
+      "file": "pages/docs/understand-the-system/document-and-session-state.md",
+      "sha256": "0b0c222cd2a5eb47028bbca8071fd199c794716617e3edbb3f15d85d343881f7"
+    },
+    {
+      "title": "Nodes and hierarchy",
+      "route": "/docs/understand-the-system/nodes-and-hierarchy",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/nodes-and-hierarchy",
+      "file": "pages/docs/understand-the-system/nodes-and-hierarchy.md",
+      "sha256": "948b7b1df90813d9769c40476302e1d78dd148755632339763d9036b6e53bfd5"
+    },
+    {
+      "title": "Packages and plugins",
+      "route": "/docs/understand-the-system/packages-and-plugins",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/packages-and-plugins",
+      "file": "pages/docs/understand-the-system/packages-and-plugins.md",
+      "sha256": "83b3f9513afc6cc958438541d0636f3f5fd17bd59f457a779527164ab2d334c7"
+    },
+    {
+      "title": "Persistence and JSON Canvas",
+      "route": "/docs/understand-the-system/persistence-and-json-canvas",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/persistence-and-json-canvas",
+      "file": "pages/docs/understand-the-system/persistence-and-json-canvas.md",
+      "sha256": "ca23f4626f0bbe533f3f1299e33e304ba261a9659648006d1473a168ac38eca6"
+    },
+    {
+      "title": "Rendering and interaction",
+      "route": "/docs/understand-the-system/rendering-and-interaction",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/rendering-and-interaction",
+      "file": "pages/docs/understand-the-system/rendering-and-interaction.md",
+      "sha256": "94241704d8af88395152a9887a981d2b4da7f19485f34c209928255d1427a9a0"
+    },
+    {
+      "title": "The engine",
+      "route": "/docs/understand-the-system/the-engine",
+      "url": "https://nuxt-board.lupinum.com/docs/understand-the-system/the-engine",
+      "file": "pages/docs/understand-the-system/the-engine.md",
+      "sha256": "8a0464454adfda7cf3b14f0afb7facc17a849f083e09d2226340fbf4fdb76b7a"
+    }
+  ]
+}

package/dist/agent/pages/docs/build-features/connections.md

@@ -0,0 +1,241 @@
+---
+title: "Connections"
+description: "Add edges between nodes with the connections plugin — anchors, routing styles, and the SVG connection layer."
+url: "https://nuxt-board.lupinum.com/docs/build-features/connections"
+route: "/docs/build-features/connections"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+# Connections
+
+> Add edges between nodes with the connections plugin — anchors, routing styles, and the SVG connection layer.
+
+Connections draw edges between nodes. Install the plugin, create edges, and the connection layer renders them as SVG paths with five routing styles.
+
+> Component omitted: `connections-board-demo`.
+> This page contains an interactive or site-specific block that has no agent markdown serializer yet.
+
+## Setup
+
+Install the package when your board needs edges:
+
+```bash
+pnpm add @lupinum/board-connections
+```
+
+Then install the connections plugin during engine creation and render the SVG
+layer under `BoardRoot`:
+
+```ts
+import { createBoardEngine } from '@lupinum/board-core'
+import { connectionsPlugin } from '@lupinum/board-connections'
+import { BoardConnectionLayer } from '@lupinum/board-connections/vue'
+
+const engine = createBoardEngine({
+  plugins: [connectionsPlugin({ routing: 'bezier' })],
+})
+```
+
+```vue
+<template>
+  <BoardRoot :engine="engine" style="height: 100vh">
+    <BoardConnectionLayer />
+  </BoardRoot>
+</template>
+```
+
+Both pieces are required: the plugin owns edge state, and
+`BoardConnectionLayer` renders and edits that state.
+
+---
+
+## Creating edges
+
+Create edges after the endpoint nodes exist:
+
+```ts
+const edge = engine.plugins.connections.createEdge({
+  from: sourceNodeId,
+  to: targetNodeId,
+  label: 'depends on',
+  data: {},
+})
+```
+
+For a complete minimal scene:
+
+```ts
+const source = engine.createNode({
+  type: 'text',
+  x: 80,
+  y: 100,
+  text: 'Source',
+})
+
+const target = engine.createNode({
+  type: 'text',
+  x: 420,
+  y: 100,
+  text: 'Target',
+})
+
+engine.plugins.connections.createEdge({
+  from: source.id,
+  to: target.id,
+  label: 'depends on',
+  data: {},
+})
+```
+
+### With anchors
+
+Specify where the edge attaches on each node:
+
+```ts
+engine.plugins.connections.createEdge({
+  from: nodeA,
+  to: nodeB,
+  fromAnchor: { side: 'right', offset: 0.5 }, // middle of right edge
+  toAnchor: { side: 'left', offset: 0.5 }, // middle of left edge
+  data: {},
+})
+```
+
+Anchor `offset` is 0–1 along the side (0.5 = center). If omitted, the connection layer auto-picks the best side from node geometry, keeps it stable while nodes move, and attaches at the center of that side.
+
+Use non-center offsets for precise manual anchors:
+
+```ts
+engine.plugins.connections.createEdge({
+  from: nodeA,
+  to: nodeB,
+  fromAnchor: { side: 'bottom', offset: 0.2 },
+  toAnchor: { side: 'top', offset: 0.8 },
+  data: {},
+})
+```
+
+---
+
+## Querying edges
+
+```ts
+// All edges
+const edges = engine.plugins.connections.getEdges()
+
+// Edges from a specific node
+const outgoing = engine.plugins.connections.getEdgesFrom(nodeId)
+
+// Edges to a specific node
+const incoming = engine.plugins.connections.getEdgesTo(nodeId)
+
+// Edges between two nodes
+const between = engine.plugins.connections.getEdgesBetween(nodeA, nodeB)
+
+// A specific edge
+const edge = engine.plugins.connections.getEdge(edgeId)
+```
+
+---
+
+## Updating edges
+
+Reconnect or restyle an existing edge with `updateEdge()`:
+
+```ts
+engine.plugins.connections.updateEdge(edgeId, {
+  to: otherNodeId,
+  toAnchor: undefined, // clear explicit anchor so the new node side auto-resolves
+})
+```
+
+The connection layer uses the same API internally when you drag an endpoint handle to another node.
+
+---
+
+## Deleting edges
+
+```ts
+engine.plugins.connections.deleteEdge(edgeId)
+```
+
+<note>
+Edges are also automatically deleted when either endpoint node is removed.
+</note>
+
+---
+
+## Rendering with BoardConnectionLayer
+
+Render `BoardConnectionLayer` anywhere under `BoardRoot`. It uses the board context, teleports its SVG layer to the root element, and applies the camera transform itself:
+
+```vue
+<script setup lang="ts">
+import { BoardRoot } from '@lupinum/vue-board'
+import { BoardConnectionLayer } from '@lupinum/board-connections/vue'
+</script>
+
+<template>
+  <BoardRoot :engine="engine" style="height: 100vh">
+    <BoardConnectionLayer />
+  </BoardRoot>
+</template>
+```
+
+Hover a card edge to reveal a filled connection handle, then drag from it to another card to create a new edge. Dropping a new connection on empty space cancels by default; pass `createNodeForConnection` if your app wants empty-drop creation to create a node and connect it. The callback runs synchronously inside the same board batch as edge creation. A rejected edge rolls back node changes made through that engine; it cannot roll back external effects from the callback. A callback that returns `null` keeps its existing cancellation behavior. Hover an edge or select it to reveal draggable endpoint handles for reconnecting existing edges; dropping a reconnect on empty space cancels it.
+
+UI-created edges use automatic endpoints by default. The edge stores no `fromAnchor` or `toAnchor`, so the connection layer keeps choosing the best side as nodes move. Dragging an existing endpoint onto a node side locks that endpoint to the exact side offset under the pointer. Select the edge and use the reset anchor actions to clear manual anchors back to auto. Set `endpointMode="manual"` on `BoardConnectionLayer`, or `connectionsPlugin({ endpointMode: 'manual' })`, when newly created edges should also lock to the side points the user chose.
+
+### Routing styles
+
+Toggle the demo above to compare routing styles. Set the routing on `BoardConnectionLayer`:
+
+```vue
+<BoardConnectionLayer routing="step" />
+```
+
+| Style | Purpose |
+| --- | --- |
+| `bezier` (default) | Smooth cubic bezier curve. Best for organic-looking graphs. |
+| `smooth-step` | Rounded orthogonal connector. Clean and readable. |
+| `step` | Right-angle stepped path. Good for pipeline and workflow layouts. |
+| `straight` | Direct straight line. Simple and lightweight. |
+| `arc` | Curved arc route for sketch-style or hand-drawn edge rendering. |
+
+### Custom edge rendering
+
+Use the `edge` slot for full control over edge appearance:
+
+```vue
+<BoardConnectionLayer>
+  <template #edge="{ edge, route }">
+    <path :d="route.path" stroke="#3b82f6" stroke-width="2" fill="none" />
+    <text :x="route.labelPoint.x" :y="route.labelPoint.y" text-anchor="middle">
+      {{ edge.label }}
+    </text>
+  </template>
+</BoardConnectionLayer>
+```
+
+---
+
+## Events
+
+```ts
+engine.on('edge:created', (edge) => {
+  console.log('Edge created:', edge.from, '→', edge.to)
+})
+
+engine.on('edge:updated', (edge, prev) => {
+  console.log('Edge moved from', prev.to, 'to', edge.to)
+})
+
+engine.on('edge:deleted', (edgeId) => {
+  console.log('Edge deleted:', edgeId)
+})
+```
+
+---