@bpmn-nova/react 0.3.5-preview → 0.3.7-preview

package/llms.txt

@@ -67,7 +67,7 @@ Use `engine="flowable"` or `engine="activiti"` explicitly from the host workflow
 
 Studio modes are presentation state: `design` means editable process design, `viewer` means read-only process viewing, and `instance` means approval trace. Observe the actual Shell state through `subscribeMode()` or framework mode events; never store it in the BPMN model.
 
-Node geometry is also presentation, not DI normalization. Loading server XML via the component parses its BPMN DI Bounds; XML export already writes model dimensions. The `0.3.5-preview` gateway/data fix scales standard shells to fit those bounds and docks display endpoints without rewriting model geometry or waypoints. Do not resize stored nodes, recreate them, or patch internal CSS to compensate. See [Node DI and visual geometry](docs/API.md#节点-di-与视觉尺寸) and the customization section in the co-located `llms-full.txt`; `node-geometry` is internal, not another installable package.
+Node geometry is also presentation, not DI normalization. Loading server XML via the component parses its BPMN DI Bounds; XML export already writes model dimensions. The `0.3.5-preview` gateway/data fix scales standard shells to fit those bounds and docks display endpoints without rewriting model geometry or waypoints. Do not resize stored nodes, recreate them, or patch internal CSS to compensate. See [Node DI and visual geometry](docs/src/api/index.md#节点-di-与视觉尺寸) and the customization section in the co-located `llms-full.txt`; `node-geometry` is internal, not another installable package.
 
 ## 4. Mount a minimal integration
 
@@ -228,7 +228,7 @@ Core Shell and framework handles expose `getConfig()` and `setConfig()`. The set
 
 ### 4.2 Sidebar layout and collapse (0.3.5-preview)
 
-Read `SOURCE: docs/CUSTOMIZATION.md`, section `侧栏布局与平滑折叠`, in the co-located `llms-full.txt` before integrating the sidebar interfaces introduced in `0.3.5-preview`. They are not available in the older `0.3.4-preview` package. The host must still provide a computable container height.
+Read `SOURCE: docs/src/customization/index.md`, section `侧栏布局与平滑折叠`, in the co-located `llms-full.txt` before integrating the sidebar interfaces introduced in `0.3.5-preview`. They are not available in the older `0.3.4-preview` package. The host must still provide a computable container height.
 
 - Configure `config.ui.leftPanel/rightPanel.collapsible` (default `true`) and `defaultCollapsed` (wide-layout initialization only, default `false`). `config.ui.rightPanel.layout` defaults to `flex`: Nova supplies a bounded column, the host arranges fixed regions and a `flex: 1; min-height: 0; overflow: auto` body. Use `scroll` for Nova-owned scrolling of the entire content; avoid nested scroll containers unless intentional.
 - Core `slots.right`, Vue `#right`, and React `right` replace only content. Native slots preserve the host application tree and win over same-name Core DOM slots. Do not create another framework root or patch Nova classes. Header/Right contexts share `state`, `mode`, `ui`, and `panelSelection`, plus `studio`, `shell`, and `actions`.
@@ -260,7 +260,7 @@ Use `allowedModes` to expose only host-authorized workbench modes. Runtime chang
 
 Runtime snapshots store asset references only. The host supplies `runtimeAssetResolver`. BPMN Nova does not execute workflow engines, submit approvals, upload/store attachments, issue permissions, or export PNG/PDF.
 
-For approval-trace integration, read the complete `SOURCE: docs/RUNTIME-INTEGRATION.md` section in the co-located `llms-full.txt` before mapping backend records. It covers instance-bound XML, stable work-item/visit identities, Flowable/Activiti mapping limits, complete approval scenarios, request cancellation, and assets. Runtime data stays top-level; only Studio display configuration belongs in `config.viewer`. Finish this branch only after the guide's relevant integration checks pass; report missing history instead of inventing facts.
+For approval-trace integration, read the complete `SOURCE: docs/src/guide/runtime.md` section in the co-located `llms-full.txt` before mapping backend records. It covers instance-bound XML, stable work-item/visit identities, Flowable/Activiti mapping limits, complete approval scenarios, request cancellation, and assets. Runtime data stays top-level; only Studio display configuration belongs in `config.viewer`. Finish this branch only after the guide's relevant integration checks pass; report missing history instead of inventing facts.
 
 Named Runtime type re-exports from the Vue/React facade start in `0.3.5-preview`. Check the installed declarations before using them; the guide gives a Props-based type fallback for older releases. Keep the one-direct-package rule rather than adding Studio for these types.
 
@@ -292,6 +292,8 @@ Before changing Nova package versions, publishing, or recovering a partial relea
 ## Reference
 
 - `README.md`: human-facing product overview and quick start.
+- `docs/src/`: authoritative public documentation for VitePress; maintain detailed integration instructions here.
+- `docs/src/examples/`: example guides with code imported from `examples/website/`; these shared snippets are expanded in `llms-full.txt`.
 - `llms-full.txt`: complete generated AI context containing setup, component, Interface, customization, publishing, and architecture documentation.
-- `docs/RUNTIME-INTEGRATION.md`: authoritative approval-trace guide in the source repository; the full content also ships inside every public package's `llms-full.txt`.
+- `docs/src/guide/runtime.md`: authoritative approval-trace guide in the source repository; the full content also ships inside every public package's `llms-full.txt`.
 - `docs/NPM-PACKAGES.md`: authoritative global version and full-release policy, including partial-release recovery.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmn-nova/react",
-  "version": "0.3.5-preview",
+  "version": "0.3.7-preview",
   "description": "React components and hooks for BPMN Nova Designer, Viewer, Studio and Properties.",
   "keywords": [
     "bpmn",
@@ -42,7 +42,7 @@
     "react-dom": ">=18"
   },
   "dependencies": {
-    "@bpmn-nova/studio": "0.3.5-preview"
+    "@bpmn-nova/studio": "0.3.7-preview"
   },
   "engines": {
     "node": ">=18"