@vanduo-oss/vd3-flowchart 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,33 @@
 
 All notable changes to `@vanduo-oss/vd3-flowchart` are documented here.
 
+## 1.5.0 — 2026-10-25
+
+### Added
+
+- Opt-in `minScale` and `maxScale` (default `0.35` and `3`) and `minNodeSize`
+  and `maxNodeSize` (default `56` and `420`). Junctions stay fixed-size.
+  Hosts that need a closer and wider view, including Oolaflow, can pass
+  `0.05`–`20` and `6`–`4800`.
+- Viewport scale is stored to four decimal places, so a zoom step still moves
+  near 5%. Other geometry stays at two decimal places.
+- Nodes smaller than their default size scale text, wrapping, radius, stroke,
+  markers, curve arms, orthogonal routes, labels, and inline editors in
+  proportion. Larger nodes do not grow that chrome.
+- A wider camera range uses a 240,000-unit grid with spacing that stays
+  readable at 5% and 2000%. The default range keeps the 12,000-unit grid.
+- `fitNode(nodeId, padding?)` frames one visible node. Unknown and hidden
+  nodes do nothing.
+
+### Compatibility
+
+- No methods were removed. Omitting the new options keeps 1.4.0 camera and
+  node limits.
+- `FLOWCHART_DOCUMENT_VERSION` stays `1.3.0`. Older 1.x documents still load.
+  A 1.5.0 document still loads in 1.4.0, where the old clamps apply.
+- This release does not add nested containers, suggestion overlays, floating
+  panels, or an export API.
+
 ## 1.4.0 — 2026-10-03
 
 ### Changed

package/README.md

@@ -6,7 +6,7 @@ Vanduo **flowchart** for Vue 3: a node/edge editor with undo/redo, layout
 modes, and a framework-agnostic core. Extracted 1-to-1 from
 `@vanduo-oss/vd3-cbun` flowchart **1.2.0**.
 
-**Status: 1.4.0.** `VD_FLOWCHART_VERSION` tracks the package release.
+**Status: 1.5.0.** `VD_FLOWCHART_VERSION` tracks the package release.
 `FLOWCHART_DOCUMENT_VERSION` (currently `1.3.0`) is the value `toJSON()`
 writes. Do not reset either independently without a compatibility plan.
 
@@ -50,7 +50,7 @@ if anything but `vue` is externalized. The package declares
 
 ## Version policy
 
-`package.json` version **is** `VD_FLOWCHART_VERSION` (`1.4.0`). Bump those
+`package.json` version **is** `VD_FLOWCHART_VERSION` (`1.5.0`). Bump those
 together for a package release. Keep `FLOWCHART_DOCUMENT_VERSION` unchanged
 unless the serialized schema changes; add fixtures and explicit compatibility
 rules for a format change. Unversioned 1.x documents through 1.3.0 still load;
@@ -100,6 +100,29 @@ follows mind-map tools such as XMind and MindNode:
 Ctrl/Cmd+Enter saves. A node plus its edge is one undo step, and naming a
 just-inserted node joins that step.
 
+## Camera and node bounds
+
+`minScale` / `maxScale` default to `0.35` / `3`, and `minNodeSize` /
+`maxNodeSize` default to `56` / `420`. Pass a finite pair to widen either
+range; an invalid pair falls back to those defaults. Junctions stay 28×28.
+`fitNode(id, padding)` frames one visible node. Padding is screen pixels.
+Scale is stored to four decimal places. Nodes smaller than their default size
+scale their text, markers, and routes down with them. The default grid stays
+12,000 units; a wider camera uses a 240,000-unit grid.
+
+```js
+new VdFlowchartCore({
+  element: '#editor',
+  minScale: 0.05,
+  maxScale: 20,
+  minNodeSize: 6,
+  maxNodeSize: 4800,
+});
+```
+
+The same four names are Vue props. The document format is unchanged: scale and
+size remain plain numbers.
+
 ## Theming
 
 Flowchart chrome renders against Vanduo `--vd-*` design tokens — the same
@@ -169,9 +192,11 @@ pnpm test:e2e      # Playwright Chromium (needs dist/)
 `pnpm build` first**. Chromium must be installed once:
 `pnpm exec playwright install chromium`.
 
-The published package declares a consumer-friendly `engines.node >=20.19.0`;
-the dev/CI toolchain pins Node 24 via `packageManager` +
-`.github/workflows/ci.yml`.
+Node 24 LTS is the supported development and CI runtime; run `nvm use` to select
+it for this repository from `.nvmrc`. The existing `engines.node >=20.19.0`
+range remains a temporary consumer compatibility floor, tested on a best-effort
+basis until the next major release; it is not the recommended development
+runtime.
 
 ## Documentation
 

package/SKILL.md

@@ -47,6 +47,15 @@ label. Shift+click, Shift+drag, and Cmd/Ctrl+A select several nodes (the
 current tree or radial layout after insertions. Saved JSON uses document
 format 1.3.0, which adds `collapsed: true` on collapsed nodes only.
 
+## Deep zoom
+
+`minScale` and `maxScale` default to `0.35` and `3`. `minNodeSize` and
+`maxNodeSize` default to `56` and `420`. Pass both ends of a pair to opt into
+a wider camera or smaller and larger nodes. Junctions stay fixed-size.
+`getInstance().fitNode(id, padding)` frames one visible node. A node smaller
+than its default size scales its text, markers, and connectors with it. Saved
+JSON stays document format 1.3.0.
+
 ## Verification
 
 Add a node, toggle read-only, and confirm the edit remains. Undo/redo, save/reload,

package/dist/core.d.ts

@@ -237,6 +237,14 @@ export interface VdFlowchartOptions {
   minimap?: boolean;
   /** Re-run the current tree or radial layout after insertions, in the same undo step (default false). */
   autoLayout?: boolean;
+  /** Lowest camera scale. Default `0.35`. Pair with `maxScale`. */
+  minScale?: number;
+  /** Highest camera scale. Default `3`. Pair with `minScale`. */
+  maxScale?: number;
+  /** Smallest resizable-node side. Default `56`. Junctions stay fixed. Pair with `maxNodeSize`. */
+  minNodeSize?: number;
+  /** Largest resizable-node side. Default `420`. Pair with `minNodeSize`. */
+  maxNodeSize?: number;
 }
 
 export class VdFlowchart {
@@ -330,6 +338,8 @@ export class VdFlowchart {
   zoomTo(scale: number): this;
   /** Pan just enough to bring a node into view. */
   revealNode(nodeId: string): void;
+  /** Centre and frame one visible node. Padding is screen pixels. */
+  fitNode(nodeId: string, padding?: number): this;
   /** Show or hide the minimap. */
   setMinimapEnabled(enabled: boolean): this;
   /** Pan so a world point is at the centre of the view. */
@@ -364,6 +374,10 @@ export class VdFlowchart {
       | 'snapGuides'
       | 'minimap'
       | 'autoLayout'
+      | 'minScale'
+      | 'maxScale'
+      | 'minNodeSize'
+      | 'maxNodeSize'
     >,
   ): this;
   destroy(): void;