orcasvn-react-diagrams 0.2.4 → 0.2.6

package/dist/index.d.ts

@@ -19,7 +19,16 @@ type ClientRectLike = {
 type DiagramContainer = {
     getBoundingClientRect: () => ClientRectLike;
 };
+type ViewportFitOptions = {
+    padding?: number;
+    minZoom?: number;
+    maxZoom?: number;
+};
 type MoveConstraint = 'free' | 'inside' | 'border';
+type TextInteractionPolicy = {
+    movable?: boolean;
+    editable?: boolean;
+};
 type BorderSide$1 = 'left' | 'right' | 'top' | 'bottom';
 type HostAnchorPreset = 'vertices' | 'cardinal';
 type PortLinkAttachMode = 'external' | 'internal';
@@ -173,10 +182,21 @@ type AnchorReference = 'top-left' | 'center';
 type RerouteLinksOptions = {
     includeManual?: boolean;
 };
-type ElementLayoutMode = 'manual' | 'horizontal' | 'vertical';
+type LinkRouteRefreshMode = 'mutation-only' | 'redraw-two-endpoint-change';
+type LinkRouteRefreshPolicy = {
+    mode?: LinkRouteRefreshMode;
+    includeManual?: boolean;
+};
+type LinkColorPoolPolicy = {
+    enabled?: boolean;
+    colors?: string[];
+};
+type ElementLayoutMode = 'manual' | 'horizontal' | 'vertical' | 'grid';
 type ElementLayoutAlign = 'start' | 'center' | 'end';
 type ElementLayoutChildFitMainAxis = 'none' | 'distribute';
 type ElementLayoutChildFitCrossAxis = 'none' | 'stretch';
+type ElementLayoutAutoResizeMode = 'grow' | 'grow-shrink';
+type ElementLayoutGridRowTemplate = number;
 type ElementLayoutLabelReservedSpaceMode = 'none' | 'fixed' | 'flexible';
 type ElementLayoutLabelReservedSpacePlacement = 'top';
 type ElementLayoutLabelReservedSpace = {
@@ -197,8 +217,15 @@ type ElementLayout = {
     };
     gap?: number;
     align?: ElementLayoutAlign;
+    autoResize?: ElementLayoutAutoResizeMode;
+    gridTemplate?: ElementLayoutGridRowTemplate[];
+    gridChildWidthResizeEnabled?: boolean;
     childFitMainAxis?: ElementLayoutChildFitMainAxis;
     childFitCrossAxis?: ElementLayoutChildFitCrossAxis;
+    childMinWidth?: number;
+    childMaxWidth?: number;
+    childMinHeight?: number;
+    childMaxHeight?: number;
     childFitMinSize?: Partial<Size>;
     childFitMaxSize?: Partial<Size>;
     labelReservedSpace?: ElementLayoutLabelReservedSpace;
@@ -283,6 +310,7 @@ type TextData = {
     size?: Size;
     style?: Record<string, unknown>;
     ownerId?: string | null;
+    interaction?: TextInteractionPolicy;
     layout?: TextLayout;
     displayContent?: string;
     displayOffset?: Point;
@@ -356,6 +384,19 @@ type ElementResizedEvent = {
     oldSize: Size;
     newSize: Size;
 };
+type GridLayoutChangedReason = 'child-resize-split' | 'child-resize-redistribute';
+type GridRowSnapshot = {
+    childIds: string[];
+};
+type GridLayoutChangedEvent = {
+    parentId: string;
+    triggerChildId: string;
+    reason: GridLayoutChangedReason;
+    beforeRows: GridRowSnapshot[];
+    afterRows: GridRowSnapshot[];
+    beforeGridTemplate?: ElementLayoutGridRowTemplate[];
+    afterGridTemplate: ElementLayoutGridRowTemplate[];
+};
 type ElementDeletedEvent = {
     elementId: string;
 };
@@ -424,6 +465,7 @@ type EngineEventMap = {
     elementDragged: ElementDropEvent;
     elementMoved: ElementMovedEvent;
     elementResized: ElementResizedEvent;
+    gridLayoutChanged: GridLayoutChangedEvent;
     elementDeleted: ElementDeletedEvent;
     portDeleted: PortDeletedEvent;
     linkDeleted: LinkDeletedEvent;
@@ -568,6 +610,7 @@ declare class TextModel {
     size?: Size;
     style?: Record<string, unknown>;
     ownerId?: string | null;
+    interaction?: TextData['interaction'];
     layout?: TextData['layout'];
     displayContent?: string;
     displayOffset?: Point;
@@ -646,6 +689,15 @@ type RouteEndpoint = {
     rect?: Rect;
     onEdgeSide?: 'left' | 'right' | 'top' | 'bottom';
 };
+type CommonAncestorCorridorHint = {
+    ancestorId: string;
+    bounds: Rect;
+    sourceBranchId: string;
+    targetBranchId: string;
+    sourceBranchRect: Rect;
+    targetBranchRect: Rect;
+    axis: 'horizontal' | 'vertical';
+};
 type RouteContext = {
     linkId: string;
     sourcePortId: string;
@@ -654,6 +706,7 @@ type RouteContext = {
     bounds?: Rect;
     sourceEndpoint?: RouteEndpoint;
     targetEndpoint?: RouteEndpoint;
+    commonAncestorCorridor?: CommonAncestorCorridorHint;
 };
 interface RouterStrategy {
     route(source: Point, target: Point, context?: RouteContext): Point[];
@@ -727,6 +780,8 @@ type DiagramEngineConfig = {
     snapper?: SnapStrategy;
     shapeRegistry?: ShapeRegistry;
     textMeasurer?: TextMeasurer;
+    linkRouteRefreshPolicy?: LinkRouteRefreshPolicy;
+    linkColorPoolPolicy?: LinkColorPoolPolicy;
 };
 declare const createDiagramEngine: (config: DiagramEngineConfig) => DiagramEngineHandle;
 
@@ -750,6 +805,8 @@ type DiagramEditorConfig = {
     onElementShapeHoverControlActivated?: (event: ElementShapeHoverControlActivationEvent) => void;
     onChange?: (event: EngineChangeEvent) => void;
     onSelection?: (event: EngineSelectionEvent) => void;
+    linkRouteRefreshPolicy?: LinkRouteRefreshPolicy;
+    linkColorPoolPolicy?: LinkColorPoolPolicy;
 };
 type DiagramImageExportOptions = {
     mimeType?: string;
@@ -769,6 +826,7 @@ type DiagramEditorHandle = DiagramEngineHandle & {
     completeLinkToPort: (targetPortId: string) => void;
     completeLinkToElement: (targetElementId: string, pointer: Point) => void;
     cancelLink: () => void;
+    zoomToFitElements: (options?: ViewportFitOptions) => void;
     exportImage: (options?: DiagramImageExportOptions) => string;
     resize: (width: number, height: number) => void;
     setElementShapeHoverControls: (controls?: ElementShapeHoverControls) => void;
@@ -776,4 +834,4 @@ type DiagramEditorHandle = DiagramEngineHandle & {
 };
 declare const createDiagramEditor: (config: DiagramEditorConfig) => DiagramEditorHandle;
 
-export { type AnchorReference, type BorderSide$1 as BorderSide, type ClientRectLike, type DiagramContainer, type DiagramEditorConfig, type DiagramEditorHandle, type DiagramEngineHandle, type DiagramImageExportOptions, type DiagramPatch, type DiagramState, type EdgeHoverControl, type ElementData, type ElementDeletedEvent, type ElementDropEvent, type ElementLayout, type ElementLayoutAlign, type ElementLayoutChildFitCrossAxis, type ElementLayoutChildFitMainAxis, type ElementLayoutLabelReservedSpace, type ElementLayoutLabelReservedSpaceMode, type ElementLayoutLabelReservedSpacePlacement, type ElementLayoutMode, type ElementLinkConnectingEvent, type ElementLinkEndedEvent, type ElementLinkStartedEvent, type ElementMovedEvent, type ElementPointerEvent, type ElementPortMovementPolicy, type ElementResizedEvent, type ElementSelectedEvent, type ElementShapeControlDragEvent, type ElementShapeControlEventType, type ElementShapeHoverControlActivationEvent, type ElementShapeHoverControlInteractionEvent, type ElementShapeHoverControls, EllipseMidPoint, type EngineChangeEvent, type EngineConfigEvent, type EngineEventMap, type EnginePointerInfo, type EngineSelectionEvent, type HostAnchorPreset, type HoverControlIcon, type LinkData, type LinkDeletedEvent, type LinkRoutingMode, type MoveConstraint, type OverlayShapeConfig, type OverlayShapeHandle, type PaperClickEvent, type Point, type PortAnchor, type PortAnchorConstraint, type PortBorderTransformContext, type PortBorderTransformResult, type PortData, type PortDeletedEvent, type PortLinkAttachMode, type PortMouseEvent, type PortMovedEvent, type PortPositionLimits, type PortSelectedEvent, type PositionAxisLimit, type Rect, type RerouteLinksOptions, type ResolvePortAnchorsOptions, type ShapeControlDefinition, type ShapeControlTargetKind, type ShapeControlVisibilityTrigger, type ShapeDrawContext, type ShapeEdgeTarget, type ShapeEllipseMidPointTarget, type ShapeHoverGeometry, type ShapeVertexTarget, type SimpleShape, type Size, type TextData, type TextDeletedEvent, type TextLayout, type TextLayoutBoundsMode, type TextLayoutOverflowMode, type TextLayoutWrapMode, type TextSelectedEvent, type TextUpdatedEvent, type VertexHoverControl, createDiagramEditor, createDiagramEngine };
+export { type AnchorReference, type BorderSide$1 as BorderSide, type ClientRectLike, type DiagramContainer, type DiagramEditorConfig, type DiagramEditorHandle, type DiagramEngineHandle, type DiagramImageExportOptions, type DiagramPatch, type DiagramState, type EdgeHoverControl, type ElementData, type ElementDeletedEvent, type ElementDropEvent, type ElementLayout, type ElementLayoutAlign, type ElementLayoutAutoResizeMode, type ElementLayoutChildFitCrossAxis, type ElementLayoutChildFitMainAxis, type ElementLayoutGridRowTemplate, type ElementLayoutLabelReservedSpace, type ElementLayoutLabelReservedSpaceMode, type ElementLayoutLabelReservedSpacePlacement, type ElementLayoutMode, type ElementLinkConnectingEvent, type ElementLinkEndedEvent, type ElementLinkStartedEvent, type ElementMovedEvent, type ElementPointerEvent, type ElementPortMovementPolicy, type ElementResizedEvent, type ElementSelectedEvent, type ElementShapeControlDragEvent, type ElementShapeControlEventType, type ElementShapeHoverControlActivationEvent, type ElementShapeHoverControlInteractionEvent, type ElementShapeHoverControls, EllipseMidPoint, type EngineChangeEvent, type EngineConfigEvent, type EngineEventMap, type EnginePointerInfo, type EngineSelectionEvent, type GridLayoutChangedEvent, type GridLayoutChangedReason, type GridRowSnapshot, type HostAnchorPreset, type HoverControlIcon, type LinkColorPoolPolicy, type LinkData, type LinkDeletedEvent, type LinkRouteRefreshMode, type LinkRouteRefreshPolicy, type LinkRoutingMode, type MoveConstraint, type OverlayShapeConfig, type OverlayShapeHandle, type PaperClickEvent, type Point, type PortAnchor, type PortAnchorConstraint, type PortBorderTransformContext, type PortBorderTransformResult, type PortData, type PortDeletedEvent, type PortLinkAttachMode, type PortMouseEvent, type PortMovedEvent, type PortPositionLimits, type PortSelectedEvent, type PositionAxisLimit, type Rect, type RerouteLinksOptions, type ResolvePortAnchorsOptions, type ShapeControlDefinition, type ShapeControlTargetKind, type ShapeControlVisibilityTrigger, type ShapeDrawContext, type ShapeEdgeTarget, type ShapeEllipseMidPointTarget, type ShapeHoverGeometry, type ShapeVertexTarget, type SimpleShape, type Size, type TextData, type TextDeletedEvent, type TextInteractionPolicy, type TextLayout, type TextLayoutBoundsMode, type TextLayoutOverflowMode, type TextLayoutWrapMode, type TextSelectedEvent, type TextUpdatedEvent, type VertexHoverControl, type ViewportFitOptions, createDiagramEditor, createDiagramEngine };

package/docs/API_CONTRACT.md

@@ -28,6 +28,8 @@ Primary definitions:
 - `onElementShapeHoverControlActivated?: (event: ElementShapeHoverControlActivationEvent) => void` (deprecated callback contract)
 - `onChange?: (event: EngineChangeEvent) => void`
 - `onSelection?: (event: EngineSelectionEvent) => void`
+- `linkRouteRefreshPolicy?: LinkRouteRefreshPolicy`
+- `linkColorPoolPolicy?: LinkColorPoolPolicy`
 
 ## Engine Config (`DiagramEngineConfig`)
 
@@ -40,6 +42,8 @@ Primary definitions:
 - `snapper?: SnapStrategy`
 - `shapeRegistry?: ShapeRegistry`
 - `textMeasurer?: TextMeasurer`
+- `linkRouteRefreshPolicy?: LinkRouteRefreshPolicy`
+- `linkColorPoolPolicy?: LinkColorPoolPolicy`
 
 Defaults:
 - `scheduler`: `RenderScheduler`
@@ -65,17 +69,41 @@ Defaults:
   - `parentId`: `null`
 
 ### `ElementLayout`
-- Required: `mode: 'manual' | 'horizontal' | 'vertical'`
+- Required: `mode: 'manual' | 'horizontal' | 'vertical' | 'grid'`
 - Optional: `padding?: number | { x: number; y: number }`, `gap?: number`, `align?: 'start' | 'center' | 'end'`
+- Optional: `autoResize?: 'grow' | 'grow-shrink'` (default: `'grow'`)
+- Optional grid controls: `gridTemplate?: number[]`
+- Optional grid interaction policy: `gridChildWidthResizeEnabled?: boolean` (default: `false`)
 - Optional fit controls: `childFitMainAxis?: 'none' | 'distribute'`, `childFitCrossAxis?: 'none' | 'stretch'`, `childFitMinSize?: Partial<Size>`, `childFitMaxSize?: Partial<Size>`
+- Optional child size aliases: `childMinWidth?: number`, `childMaxWidth?: number`, `childMinHeight?: number`, `childMaxHeight?: number`
+- Optional label reservation: `labelReservedSpace?: ElementLayoutLabelReservedSpace`
 - Layout defaults when `mode !== 'manual'`:
   - `padding`: `12` (or `{ x: 12, y: 12 }`)
   - `gap`: `12`
   - `align`: `'center'`
 
+### `ViewportFitOptions`
+- Optional `padding?: number` (default: `24`)
+- Optional `minZoom?: number` (default: `0.2`)
+- Optional `maxZoom?: number` (default: `3`)
+- Normalization rules:
+  - negative padding is clamped to `0`
+  - non-finite values fall back to defaults
+  - `minZoom`/`maxZoom` are clamped to positive values and normalized into ascending order
+
+### `TextInteractionPolicy`
+- Optional `movable?: boolean` (default behavior: `true`)
+- Optional `editable?: boolean` (default behavior: `true`)
+- Semantics:
+  - `movable: false` suppresses built-in pointer drag for that text label
+  - `editable: false` suppresses built-in double-click/tap editing for that text label
+  - omitted fields preserve existing built-in behavior
+  - programmatic `moveTextTo(...)` and `updateText(...)` remain allowed
+
 ### `ElementPortMovementPolicy`
 - `moveMode: 'free' | 'inside' | 'border' | 'anchors'`
 - Optional `anchorConstraint?: PortAnchorConstraint`
+- Optional `positionLimits?: PortPositionLimits`
 
 ### `PortAnchorConstraint`
 - `preset: 'vertices' | 'cardinal'`
@@ -83,7 +111,7 @@ Defaults:
 
 ### `PortData`
 - Required: `id`, `elementId`, `position`
-- Optional: `shapeId`, `size`, `style`, `textIds`, `moveMode`, `anchorCenter`, `orientToHostBorder`, `currentAnchorId`
+- Optional: `shapeId`, `size`, `style`, `textIds`, `moveMode`, `anchorCenter`, `orientToHostBorder`, `placementPoint`, `linkAttachPoint`, `externalLinkAttachPoint`, `internalLinkAttachPoint`, `rotationPivot`, `currentAnchorId`
 - Defaults at runtime/model:
   - `textIds`: `[]`
   - `anchorCenter`: `true`
@@ -96,9 +124,29 @@ Defaults:
   - `routing`: `'auto'`
   - `textIds`: `[]`
 
+### `LinkRouteRefreshPolicy`
+- Optional `mode?: 'mutation-only' | 'redraw-two-endpoint-change'` (default: `'mutation-only'`)
+- Optional `includeManual?: boolean` (default: `false`)
+- Applies to editor/engine configuration and controls redraw-cycle link refresh behavior.
+
+### `LinkColorPoolPolicy`
+- Optional `enabled?: boolean` (default: `false`)
+- Optional `colors?: string[]`
+- When enabled:
+  - link creation assigns `style.stroke` from the active pool if no explicit non-empty stroke is already provided
+  - empty/whitespace custom entries are ignored
+  - if resulting custom pool is empty, built-in 20-color pool is used
+
+### `GridLayoutChangedEvent`
+- Required: `parentId`, `triggerChildId`, `reason`, `beforeRows`, `afterRows`, `afterGridTemplate`
+- Optional: `beforeGridTemplate`
+- `reason`: `'child-resize-split' | 'child-resize-redistribute'`
+- `beforeRows` / `afterRows`: arrays of `{ childIds: string[] }` snapshots describing derived row membership before and after the topology change
+- Emitted only when enabled grid-child width resizing causes a real row-topology change
+
 ### `TextData`
 - Required: `id`, `content`, `position`
-- Optional: `size`, `style`, `ownerId`, `layout`, `displayContent`, `displayOffset`, `displayClipSize`
+- Optional: `size`, `style`, `ownerId`, `layout`, `interaction`, `displayContent`, `displayOffset`, `displayClipSize`
 - Defaults at runtime/model:
   - `ownerId`: `null`
   - `displayContent`: mirrors `content` at creation
@@ -139,10 +187,24 @@ Defaults:
 - Rendering: `registerShape`, `render`
 
 ### Editor Only (`DiagramEditorHandle`)
+- `startLinkFromPort(sourcePortId, pointer?)`
+- `updateLinkPreview(pointer)`
+- `completeLinkToPort(targetPortId)`
+- `completeLinkToElement(targetElementId, pointer)`
+- `cancelLink()`
+- `zoomToFitElements(options?)`
+- `exportImage(options?)`
 - `resize(width, height)`
 - `setElementShapeHoverControls(controls?)`
 - `destroy()`
 
+### `exportImage` Options (`DiagramImageExportOptions`)
+- Optional: `mimeType?: string`
+- Optional: `quality?: number`
+- Optional: `pixelRatio?: number`
+- Optional crop rectangle: `x?: number`, `y?: number`, `width?: number`, `height?: number`
+- Optional `fitToContent?: boolean | { padding?: number }`
+
 ### `registerShape` Definition Contract
 - Required: `id`
 - Optional behavior hooks:
@@ -173,6 +235,7 @@ Defaults:
 - `elementDragged: ElementDropEvent`
 - `elementMoved: ElementMovedEvent`
 - `elementResized: ElementResizedEvent`
+- `gridLayoutChanged: GridLayoutChangedEvent`
 - `elementDeleted: ElementDeletedEvent`
 - `portDeleted: PortDeletedEvent`
 - `linkDeleted: LinkDeletedEvent`
@@ -188,9 +251,16 @@ Defaults:
 
 - Missing IDs in most mutators are no-op (non-throwing).
 - `setViewport` emits a `change` patch with `entity: 'viewport'` and skips immediate render scheduling.
+- `zoomToFitElements` computes bounds from `elements[]` only, ignores ports/links/texts for fit expansion, and no-ops when no elements exist.
+- `zoomToFitElements` applies its result through `setViewport`, so hosts observe the standard viewport patch/change path.
 - `clientToWorld` uses: `world = (client - containerRect - pan) / zoom`, with zoom fallback to `1` when zoom is `0`.
 - `rerouteLinks(ids)` skips manual links unless `options.includeManual === true`.
+- `linkRouteRefreshPolicy.mode` defaults to `'mutation-only'`; `'redraw-two-endpoint-change'` enables redraw-cycle reroute checks for links whose two endpoints changed.
 - `updateLinkPoints` always marks the link as manual routing.
+- `linkColorPoolPolicy` is opt-in and applies only to newly created links; explicitly provided non-empty `style.stroke` values are preserved.
+- `gridLayoutChanged` is additive and does not replace standard `change` / `elementResized` flows.
+- `TextData.interaction.movable = false` blocks built-in drag only; selection still works and programmatic movement remains allowed.
+- `TextData.interaction.editable = false` blocks built-in textarea editing only; selection still works and programmatic text updates remain allowed.
 - Text layout/overflow resolution updates `displayContent` and emits `textUpdated` when `updateText` is called.
 - Deletion mutators emit cascading `portDeleted`/`linkDeleted`/`textDeleted` for removed dependent entities.
 

package/docs/CAPABILITIES.md

@@ -6,11 +6,19 @@
 - CRUD for elements, ports, links, and texts.
 - Nested elements with world/local coordinate resolution.
 - Link routing modes: `auto` and `manual`.
+- Optional redraw-cycle reroute policy for two-endpoint-change detection.
+- Hierarchy-aware cross-parent corridor preference for auto link routing.
 - Manual bend editing while preserving interior bends during endpoint moves.
 - Selection, marquee selection, and viewport pan/zoom.
+- Host-callable viewport fitting through `zoomToFitElements(options?)`.
 - Shape registration by canvas draw, custom node factory, or SVG path metadata.
 - Shape-aware host border projection and anchor-constrained port placement.
+- Auto-layout modes: `manual`, `horizontal`, `vertical`, and `grid` with template rows/columns.
+- Auto-layout parent resize policy (`grow` / `grow-shrink`) and child size constraints.
+- Optional grid-child width topology editing with `gridLayoutChanged` host events.
 - Element shape hover controls with edge/vertex/midpoint targets and interaction callbacks.
+- Optional random link color assignment from configurable pools during link creation.
+- Per-text interaction policy for suppressing built-in text drag and/or built-in text editing.
 - Overlay shapes for external drag ghosting and previews.
 - Event-driven host integration (`change`, `selection`, pointer/link lifecycle events).
 

package/docs/COMMANDS_EVENTS.md

@@ -6,6 +6,7 @@
 - Engine mutators route through command factories in `src/engine/EngineCommands.ts`.
 - Each command applies model mutation and returns one or more patches.
 - `emitChange` publishes `{ patches, state }` on `change`.
+- Editor helpers such as `zoomToFitElements(options?)` compose existing engine commands rather than introducing a separate patch type.
 
 ## Patch Entities
 - `element`
@@ -20,6 +21,10 @@
 - `add/move/resize/remove element`
   - Always `change`
   - Plus `elementMoved`, `elementResized`, or `elementDeleted` when applicable
+- `resize element` with enabled grid-child width topology editing
+  - Standard `change`
+  - Standard `elementResized` when size changes
+  - Plus `gridLayoutChanged` when row occupancy actually splits or redistributes
 - `add/move/remove port`
   - Always `change`
   - Plus `portMoved` on effective movement
@@ -35,6 +40,9 @@
   - `selection` plus derived selected entity events
 - `setViewport`
   - `change` with viewport patch (`render: false`)
+- `zoomToFitElements`
+  - delegates to `setViewport` when at least one element exists
+  - emits the same viewport `change` patch path
 - `setRouting/setSnapping/registerShape`
   - `config` events
 

package/docs/DOCUMENTATION_WORKFLOW.md

@@ -59,7 +59,7 @@ When resuming later:
 5. Re-run packaging verification.
 
 ## 6. Current Status
-- Last updated: 2026-04-25
+- Last updated: 2026-05-14
 - Last completed step: 10
 - Next step: 7 (optional additional fixture coverage for deeper nested/manual-route scenarios)
 - Owner: Codex (with repository maintainers)
@@ -82,3 +82,6 @@ When resuming later:
 - 2026-02-26: Added cross-page navigation and section-level links across core docs for human and AI readability.
 - 2026-04-25: Completed release-doc pass for `v0.2.2` including `v0.2.1` scope consolidation; refreshed API/event contracts in `docs/*` and `ai/*`.
 - 2026-04-25: Ran release validations: `npm run typecheck`, `npm test -- --watchAll=false`, `npm run build`, `npm run rollup-build-lib`, and `npm pack --dry-run`.
+- 2026-05-10: Completed release-doc pass for `v0.2.5`; refreshed release highlights, API contract updates (`linkRouteRefreshPolicy`, `linkColorPoolPolicy`, grid auto-layout fields), and machine-readable contract metadata.
+- 2026-05-10: Ran release validations: `npm run typecheck`, `npm test -- --watchAll=false`, `npm run build`, `npm run rollup-build-lib`, and `npm pack --dry-run`.
+- 2026-05-14: Completed release-doc pass for `v0.2.6`; refreshed release highlights, API contract updates (`zoomToFitElements`, `ViewportFitOptions`, `gridChildWidthResizeEnabled`, `gridLayoutChanged`, `TextInteractionPolicy`), and machine-readable contract metadata.

package/docs/INTEGRATION_PLAYBOOK.md

@@ -12,9 +12,12 @@ Embed this library into another diagram host while preserving deterministic stat
    - `selection` for host inspector panels
    - link/pointer events for UI workflows
    - deletion/text lifecycle events when host needs side-effects (`portDeleted`, `linkDeleted`, `textDeleted`, `textUpdated`)
+   - `gridLayoutChanged` when the host needs to observe resize-driven grid row topology edits
 3. Convert external pointer drops with `clientToWorld`.
 4. Use `createOverlayShape` during host drag previews.
 5. For shape controls, pass `elementShapeHoverControls` and handle `onElementShapeHoverControlInteraction`.
+6. Use `zoomToFitElements(options?)` when the host needs library-owned fit-to-elements navigation instead of recomputing viewport math externally.
+7. Set `TextData.interaction` when some labels must remain read-only or fixed in place while still using library selection behavior.
 
 ## Path B: Engine-Only Adapter
 1. Implement `Renderer`:

package/docs/STATE_INVARIANTS.md

@@ -39,6 +39,9 @@
 - `ownerId` can reference element, port, or link.
 - Owned text position is stored owner-relative.
 - Text with missing owner behaves as standalone world-position text.
+- Text interaction policy is persisted separately from style/layout metadata.
+- `interaction.movable = false` suppresses built-in drag without blocking selection or programmatic movement.
+- `interaction.editable = false` suppresses built-in editing without blocking selection or programmatic content updates.
 - Size is measured on add/update when using engine text measurer.
 - Text layout can compute derived `displayContent`, `displayOffset`, and `displayClipSize`.
 
@@ -47,6 +50,7 @@
   - `selection`
   - plus derived `elementSelected`/`portSelected`/`textSelected`
 - `setViewport` emits `change` with `entity=viewport` and does not force render directly.
+- `zoomToFitElements` derives viewport fit from `elements[]` bounds only and applies the result through `setViewport`.
 
 ## Failure Modes
 - Non-existent target IDs: operation is no-op.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orcasvn-react-diagrams",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "dependencies": {
     "eventemitter3": "^5.0.1",
     "flatten-js": "^0.6.9",