orcasvn-react-diagrams 0.2.12 → 0.2.13

package/dist/esm/types/api/createDiagramEditor.d.ts

@@ -1,4 +1,4 @@
-import { DiagramEngineHandle, Point, DiagramState, ElementShapeHoverControlActivationEvent, ElementShapeHoverControlInteractionEvent, ElementShapeHoverControls, EngineChangeEvent, EngineSelectionEvent, LinkTargetPortCreationHandler, LinkColorPoolPolicy, LinkRouteRefreshPolicy, ViewportFitOptions } from './types';
+import { DiagramEngineHandle, Point, DiagramState, ElementShapeHoverControlActivationEvent, ElementShapeHoverControlInteractionEvent, ElementShapeHoverControls, EngineChangeEvent, EngineSelectionEvent, LinkTargetPortCreationHandler, LinkColorPoolPolicy, LinkRouteRefreshPolicy, FocusElementOptions, ViewportFitOptions } from './types';
 import { type BuiltInShapeKind } from '../shapes';
 export type SimpleShape = {
     id: string;
@@ -41,6 +41,7 @@ export type DiagramEditorHandle = DiagramEngineHandle & {
     completeLinkToElement: (targetElementId: string, pointer: Point) => void;
     cancelLink: () => void;
     zoomToFitElements: (options?: ViewportFitOptions) => void;
+    focusElement: (elementId: string, options?: FocusElementOptions) => void;
     exportImage: (options?: DiagramImageExportOptions) => string;
     resize: (width: number, height: number) => void;
     setElementShapeHoverControls: (controls?: ElementShapeHoverControls) => void;

package/dist/esm/types/api/types.d.ts

@@ -24,6 +24,9 @@ export type ViewportFitOptions = {
     minZoom?: number;
     maxZoom?: number;
 };
+export type FocusElementOptions = {
+    zoom?: number;
+};
 export type MoveConstraint = 'free' | 'inside' | 'border';
 export type TextInteractionPolicy = {
     movable?: boolean;
@@ -394,6 +397,11 @@ export type ElementPointerEvent = {
     pointer: EnginePointerInfo;
     isMulti: boolean;
 };
+export type ElementDoubleClickEvent = {
+    elementId: string;
+    pointer: EnginePointerInfo;
+    isMulti: boolean;
+};
 export type ElementMovedEvent = {
     elementId: string;
     oldWorld: Point;
@@ -418,18 +426,55 @@ export type GridLayoutChangedEvent = {
     beforeGridTemplate?: ElementLayoutGridRowTemplate[];
     afterGridTemplate: ElementLayoutGridRowTemplate[];
 };
+export type DeletionTrigger = 'direct' | 'selection' | 'cascade';
+export type DeletionRootRef = {
+    entity: 'element' | 'port' | 'link' | 'text';
+    id: string;
+};
+export type ElementDeletingEvent = {
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 export type ElementDeletedEvent = {
     elementId: string;
 };
+export type PortDeletingEvent = {
+    portId: string;
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 export type PortDeletedEvent = {
     portId: string;
     elementId: string;
 };
+export type LinkDeletingEvent = {
+    linkId: string;
+    sourcePortId: string;
+    targetPortId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 export type LinkDeletedEvent = {
     linkId: string;
     sourcePortId: string;
     targetPortId: string;
 };
+export type TextDeletingEvent = {
+    textId: string;
+    ownerId?: string | null;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 export type TextDeletedEvent = {
     textId: string;
     ownerId?: string | null;
@@ -483,13 +528,18 @@ export type EngineEventMap = {
     portMoved: PortMovedEvent;
     portSelected: PortSelectedEvent;
     elementClick: ElementPointerEvent;
+    elementDoubleClick: ElementDoubleClickEvent;
     elementDragged: ElementDropEvent;
     elementMoved: ElementMovedEvent;
     elementResized: ElementResizedEvent;
     gridLayoutChanged: GridLayoutChangedEvent;
+    elementDeleting: ElementDeletingEvent;
     elementDeleted: ElementDeletedEvent;
+    portDeleting: PortDeletingEvent;
     portDeleted: PortDeletedEvent;
+    linkDeleting: LinkDeletingEvent;
     linkDeleted: LinkDeletedEvent;
+    textDeleting: TextDeletingEvent;
     textDeleted: TextDeletedEvent;
     textUpdated: TextUpdatedEvent;
     elementSelected: ElementSelectedEvent;

package/dist/esm/types/displaybox/demos/deletionEventsDemo.d.ts

@@ -1,2 +1,4 @@
+import type { DiagramState } from '../../api';
 import type { DemoConfig } from '../types';
+export declare const createDeletionEventsState: () => DiagramState;
 export declare const deletionEventsDemoConfig: DemoConfig;

package/dist/esm/types/displaybox/demos/focusElementDemo.d.ts

@@ -0,0 +1,4 @@
+import type { DiagramState } from '../../api';
+import type { DemoConfig } from '../types';
+export declare const createFocusElementState: () => DiagramState;
+export declare const focusElementDemoConfig: DemoConfig;

package/dist/esm/types/engine/DiagramEngine.d.ts

@@ -120,6 +120,7 @@ export default class DiagramEngine {
     emitPortMouseDown(event: PortMouseEvent): void;
     emitPortMouseUp(event: PortMouseEvent): void;
     emitElementClick(elementId: string, pointer: EnginePointerInfo, isMulti: boolean): void;
+    emitElementDoubleClick(elementId: string, pointer: EnginePointerInfo, isMulti: boolean): void;
     emitElementLinkStarted(event: {
         sourcePortId: string;
         sourceElementId: string;
@@ -172,6 +173,14 @@ export default class DiagramEngine {
     private refreshLinksForRenderCycle;
     private normalizePortsForHostPolicies;
     private computeRemovalDiff;
+    private resolveDeletionRoot;
+    private applyRemovalCommand;
+    private planRemoval;
+    private emitDeletionLifecycleEvents;
+    private emitElementDeleting;
+    private emitPortDeleting;
+    private emitLinkDeleting;
+    private emitTextDeleting;
     private emitEntityDeletionEvents;
 }
 export declare const createDiagramEngine: (config: DiagramEngineConfig) => DiagramEngineHandle;

package/dist/examples.d.ts

@@ -26,6 +26,9 @@ type ViewportFitOptions = {
     minZoom?: number;
     maxZoom?: number;
 };
+type FocusElementOptions = {
+    zoom?: number;
+};
 type MoveConstraint = 'free' | 'inside' | 'border';
 type TextInteractionPolicy = {
     movable?: boolean;
@@ -353,6 +356,11 @@ type ElementPointerEvent = {
     pointer: EnginePointerInfo;
     isMulti: boolean;
 };
+type ElementDoubleClickEvent = {
+    elementId: string;
+    pointer: EnginePointerInfo;
+    isMulti: boolean;
+};
 type ElementMovedEvent = {
     elementId: string;
     oldWorld: Point;
@@ -377,18 +385,55 @@ type GridLayoutChangedEvent = {
     beforeGridTemplate?: ElementLayoutGridRowTemplate[];
     afterGridTemplate: ElementLayoutGridRowTemplate[];
 };
+type DeletionTrigger = 'direct' | 'selection' | 'cascade';
+type DeletionRootRef = {
+    entity: 'element' | 'port' | 'link' | 'text';
+    id: string;
+};
+type ElementDeletingEvent = {
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type ElementDeletedEvent = {
     elementId: string;
 };
+type PortDeletingEvent = {
+    portId: string;
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type PortDeletedEvent = {
     portId: string;
     elementId: string;
 };
+type LinkDeletingEvent = {
+    linkId: string;
+    sourcePortId: string;
+    targetPortId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type LinkDeletedEvent = {
     linkId: string;
     sourcePortId: string;
     targetPortId: string;
 };
+type TextDeletingEvent = {
+    textId: string;
+    ownerId?: string | null;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type TextDeletedEvent = {
     textId: string;
     ownerId?: string | null;
@@ -442,13 +487,18 @@ type EngineEventMap = {
     portMoved: PortMovedEvent;
     portSelected: PortSelectedEvent;
     elementClick: ElementPointerEvent;
+    elementDoubleClick: ElementDoubleClickEvent;
     elementDragged: ElementDropEvent;
     elementMoved: ElementMovedEvent;
     elementResized: ElementResizedEvent;
     gridLayoutChanged: GridLayoutChangedEvent;
+    elementDeleting: ElementDeletingEvent;
     elementDeleted: ElementDeletedEvent;
+    portDeleting: PortDeletingEvent;
     portDeleted: PortDeletedEvent;
+    linkDeleting: LinkDeletingEvent;
     linkDeleted: LinkDeletedEvent;
+    textDeleting: TextDeletingEvent;
     textDeleted: TextDeletedEvent;
     textUpdated: TextUpdatedEvent;
     elementSelected: ElementSelectedEvent;
@@ -569,6 +619,7 @@ type DiagramEditorHandle = DiagramEngineHandle & {
     completeLinkToElement: (targetElementId: string, pointer: Point) => void;
     cancelLink: () => void;
     zoomToFitElements: (options?: ViewportFitOptions) => void;
+    focusElement: (elementId: string, options?: FocusElementOptions) => void;
     exportImage: (options?: DiagramImageExportOptions) => string;
     resize: (width: number, height: number) => void;
     setElementShapeHoverControls: (controls?: ElementShapeHoverControls) => void;

package/dist/index.d.ts

@@ -24,6 +24,9 @@ type ViewportFitOptions = {
     minZoom?: number;
     maxZoom?: number;
 };
+type FocusElementOptions = {
+    zoom?: number;
+};
 type MoveConstraint = 'free' | 'inside' | 'border';
 type TextInteractionPolicy = {
     movable?: boolean;
@@ -394,6 +397,11 @@ type ElementPointerEvent = {
     pointer: EnginePointerInfo;
     isMulti: boolean;
 };
+type ElementDoubleClickEvent = {
+    elementId: string;
+    pointer: EnginePointerInfo;
+    isMulti: boolean;
+};
 type ElementMovedEvent = {
     elementId: string;
     oldWorld: Point;
@@ -418,18 +426,55 @@ type GridLayoutChangedEvent = {
     beforeGridTemplate?: ElementLayoutGridRowTemplate[];
     afterGridTemplate: ElementLayoutGridRowTemplate[];
 };
+type DeletionTrigger = 'direct' | 'selection' | 'cascade';
+type DeletionRootRef = {
+    entity: 'element' | 'port' | 'link' | 'text';
+    id: string;
+};
+type ElementDeletingEvent = {
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type ElementDeletedEvent = {
     elementId: string;
 };
+type PortDeletingEvent = {
+    portId: string;
+    elementId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type PortDeletedEvent = {
     portId: string;
     elementId: string;
 };
+type LinkDeletingEvent = {
+    linkId: string;
+    sourcePortId: string;
+    targetPortId: string;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type LinkDeletedEvent = {
     linkId: string;
     sourcePortId: string;
     targetPortId: string;
 };
+type TextDeletingEvent = {
+    textId: string;
+    ownerId?: string | null;
+    trigger: DeletionTrigger;
+    root: DeletionRootRef;
+    cancel: () => void;
+    cancelled: boolean;
+};
 type TextDeletedEvent = {
     textId: string;
     ownerId?: string | null;
@@ -483,13 +528,18 @@ type EngineEventMap = {
     portMoved: PortMovedEvent;
     portSelected: PortSelectedEvent;
     elementClick: ElementPointerEvent;
+    elementDoubleClick: ElementDoubleClickEvent;
     elementDragged: ElementDropEvent;
     elementMoved: ElementMovedEvent;
     elementResized: ElementResizedEvent;
     gridLayoutChanged: GridLayoutChangedEvent;
+    elementDeleting: ElementDeletingEvent;
     elementDeleted: ElementDeletedEvent;
+    portDeleting: PortDeletingEvent;
     portDeleted: PortDeletedEvent;
+    linkDeleting: LinkDeletingEvent;
     linkDeleted: LinkDeletedEvent;
+    textDeleting: TextDeletingEvent;
     textDeleted: TextDeletedEvent;
     textUpdated: TextUpdatedEvent;
     elementSelected: ElementSelectedEvent;
@@ -857,6 +907,7 @@ type DiagramEditorHandle = DiagramEngineHandle & {
     completeLinkToElement: (targetElementId: string, pointer: Point) => void;
     cancelLink: () => void;
     zoomToFitElements: (options?: ViewportFitOptions) => void;
+    focusElement: (elementId: string, options?: FocusElementOptions) => void;
     exportImage: (options?: DiagramImageExportOptions) => string;
     resize: (width: number, height: number) => void;
     setElementShapeHoverControls: (controls?: ElementShapeHoverControls) => void;
@@ -864,4 +915,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 ElementChildInteractionPolicy, 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 LinkTargetPortCreationContext, type LinkTargetPortCreationHandler, type LinkTargetPortCreationPhase, type LinkTargetPortCreationResult, type LinkTargetPortDraft, 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 };
+export { type AnchorReference, type BorderSide$1 as BorderSide, type ClientRectLike, type DeletionRootRef, type DeletionTrigger, type DiagramContainer, type DiagramEditorConfig, type DiagramEditorHandle, type DiagramEngineHandle, type DiagramImageExportOptions, type DiagramPatch, type DiagramState, type EdgeHoverControl, type ElementChildInteractionPolicy, type ElementData, type ElementDeletedEvent, type ElementDeletingEvent, type ElementDoubleClickEvent, 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 FocusElementOptions, type GridLayoutChangedEvent, type GridLayoutChangedReason, type GridRowSnapshot, type HostAnchorPreset, type HoverControlIcon, type LinkColorPoolPolicy, type LinkData, type LinkDeletedEvent, type LinkDeletingEvent, type LinkRouteRefreshMode, type LinkRouteRefreshPolicy, type LinkRoutingMode, type LinkTargetPortCreationContext, type LinkTargetPortCreationHandler, type LinkTargetPortCreationPhase, type LinkTargetPortCreationResult, type LinkTargetPortDraft, type MoveConstraint, type OverlayShapeConfig, type OverlayShapeHandle, type PaperClickEvent, type Point, type PortAnchor, type PortAnchorConstraint, type PortBorderTransformContext, type PortBorderTransformResult, type PortData, type PortDeletedEvent, type PortDeletingEvent, 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 TextDeletingEvent, 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

@@ -105,6 +105,12 @@ Defaults:
   - non-finite values fall back to defaults
   - `minZoom`/`maxZoom` are clamped to positive values and normalized into ascending order
 
+### `FocusElementOptions`
+- Optional `zoom?: number`
+- Semantics:
+  - omitted `zoom` preserves the current viewport zoom
+  - provided `zoom` is clamped to the same normalized min/max range used by viewport fit helpers
+
 ### `TextInteractionPolicy`
 - Optional `movable?: boolean` (default behavior: `true`)
 - Optional `editable?: boolean` (default behavior: `true`)
@@ -197,6 +203,36 @@ Defaults:
 - `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
 
+### `ElementDoubleClickEvent`
+- Required: `elementId`, `pointer`, `isMulti`
+- Emitted for eligible element-body double click / double tap
+- Observational only; does not cancel or replace the normal click-selection flow
+
+### `DeletionTrigger`
+- `'direct' | 'selection' | 'cascade'`
+
+### `DeletionRootRef`
+- Required: `entity`, `id`
+- `entity`: `'element' | 'port' | 'link' | 'text'`
+- `id` is the original requested delete root for the active delete pass
+
+### `ElementDeletingEvent`
+- Required: `elementId`, `trigger`, `root`, `cancel`, `cancelled`
+- Emitted before an element deletion commits, including descendant element cascades
+
+### `PortDeletingEvent`
+- Required: `portId`, `elementId`, `trigger`, `root`, `cancel`, `cancelled`
+- Emitted before a port deletion commits, including cascades caused by parent element removal
+
+### `LinkDeletingEvent`
+- Required: `linkId`, `sourcePortId`, `targetPortId`, `trigger`, `root`, `cancel`, `cancelled`
+- Emitted before a link deletion commits, including cascades caused by element or port removal
+
+### `TextDeletingEvent`
+- Required: `textId`, `trigger`, `root`, `cancel`, `cancelled`
+- Optional: `ownerId?: string | null`
+- Emitted before a text deletion commits, including cascades caused by owner deletion
+
 ### `TextData`
 - Required: `id`, `content`, `position`
 - Optional: `size`, `style`, `ownerId`, `layout`, `interaction`, `displayContent`, `displayOffset`, `displayClipSize`
@@ -251,6 +287,7 @@ Defaults:
 - `completeLinkToElement(targetElementId, pointer)`
 - `cancelLink()`
 - `zoomToFitElements(options?)`
+- `focusElement(elementId, options?)`
 - `exportImage(options?)`
 - `resize(width, height)`
 - `setElementShapeHoverControls(controls?)`
@@ -290,13 +327,18 @@ Defaults:
 - `portMoved: PortMovedEvent`
 - `portSelected: PortSelectedEvent`
 - `elementClick: ElementPointerEvent`
+- `elementDoubleClick: ElementDoubleClickEvent`
 - `elementDragged: ElementDropEvent`
 - `elementMoved: ElementMovedEvent`
 - `elementResized: ElementResizedEvent`
 - `gridLayoutChanged: GridLayoutChangedEvent`
+- `elementDeleting: ElementDeletingEvent`
 - `elementDeleted: ElementDeletedEvent`
+- `portDeleting: PortDeletingEvent`
 - `portDeleted: PortDeletedEvent`
+- `linkDeleting: LinkDeletingEvent`
 - `linkDeleted: LinkDeletedEvent`
+- `textDeleting: TextDeletingEvent`
 - `textDeleted: TextDeletedEvent`
 - `textUpdated: TextUpdatedEvent`
 - `elementSelected: ElementSelectedEvent`
@@ -312,8 +354,11 @@ Defaults:
 - `zoomToFitElements` computes bounds from `elements[]` only, ignores ports/links/texts for fit expansion, and no-ops when no elements exist.
 - `zoomToFitElements` ignores hidden elements when computing fit bounds.
 - `zoomToFitElements` applies its result through `setViewport`, so hosts observe the standard viewport patch/change path.
+- `focusElement(elementId, options?)` centers the target element bounds in the current editor viewport and preserves the current zoom unless `options.zoom` is provided.
+- `focusElement(...)` no-ops when the target id does not resolve to an element world position.
 - `exportImage({ fitToContent })` derives crop bounds from visible scene entities only.
 - Built-in empty-paper panning now starts from plain primary-button drag and no longer requires `panKey`; marquee selection uses `Shift + primary drag`.
+- `elementDoubleClick` is observational; normal click selection still runs, and text double click keeps built-in text-edit precedence instead of also emitting `elementDoubleClick`.
 - `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.
@@ -326,6 +371,8 @@ Defaults:
 - Link labels use the existing text lifecycle and event surface: `addText(...)`, `moveTextTo(...)`, `updateText(...)`, `removeText(...)`, `textUpdated`, and `textDeleted`.
 - Link-owned text defaults to unconstrained layout unless `TextLayout.boundsMode` is explicitly set; element-only owner-width defaults do not apply to link labels.
 - `gridLayoutChanged` is additive and does not replace standard `change` / `elementResized` flows.
+- Deletion mutators emit cancellable `elementDeleting` / `portDeleting` / `linkDeleting` / `textDeleting` before commit and matching `...Deleted` events after successful removal.
+- Canceling any dependent `...Deleting` event aborts the current root deletion request; `deleteSelection()` still continues evaluating unrelated selected roots.
 - `ElementData.visible = false` hides only the element body from built-in renderer sync, hit testing, marquee selection, persisted selection, and fit/export helpers.
 - Descendant element visibility is not suppressed by hidden ancestors; direct-owned parent ports/texts still follow the hidden parent, and links remain visible whenever both endpoint ports are visible.
 - `ElementData.selectable = false` blocks built-in element-body selection while still allowing visible owned ports to participate in their normal interaction flows.
@@ -334,7 +381,7 @@ Defaults:
 - `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.
+- Successful cascade removal still emits the matching dependent `...Deleted` events for removed entities.
 
 ## Verification References
 - `src/api/__tests__/createDiagramEditor.test.ts`

package/docs/ARCHITECTURE.md

@@ -3,8 +3,8 @@
 > Sections: [Module Boundaries](#module-boundaries) | [Runtime Flow](#runtime-flow) | [Integration Boundary](#integration-boundary) | [Key Sources](#key-sources)
 
 ## Module Boundaries
-- `src/api/`: public entry points and type contracts.
-- `src/engine/`: command execution, event bus, selection, viewport, routing/snap integration.
+- `src/api/`: public entry points, type contracts, and editor-only helpers such as `zoomToFitElements(...)` and `focusElement(...)`.
+- `src/engine/`: command execution, event bus, selection, viewport, routing/snap integration, and delete-lifecycle orchestration.
 - `src/engine/`: `DiagramEngine` orchestration plus extracted services (`TextLayoutService`, `AutoLayoutService`, `LinkRoutingService`, `MutationPipeline`).
 - `src/models/`: in-memory state graph for elements/ports/links/texts.
 - `src/renderer/`: renderer interface and shape registry contracts.
@@ -14,15 +14,17 @@
 - `src/utils/`: geometry, patch helpers, guards, ids.
 
 ## Runtime Flow
-1. Host calls API mutator.
-2. Engine executes command(s) against model.
-3. Engine emits patches + latest state via `change`.
-4. Scheduler requests render.
-5. Renderer syncs model to view nodes.
+1. Host calls API mutator or editor helper.
+2. Interaction or API helper resolves target intent and any required lifecycle hooks.
+3. Engine executes command(s) against model or applies viewport state updates.
+4. Engine emits patches + latest state via `change`.
+5. Scheduler requests render.
+6. Renderer syncs model to view nodes.
 
 ## Integration Boundary
 - Engine core does not require Konva if you use `createDiagramEngine` with a custom `Renderer`.
 - `createDiagramEditor` wires Konva stage, hit testing, and interaction defaults.
+- The Konva-backed editor surface also owns editor-only navigation helpers such as `focusElement(...)`.
 
 ## Key Sources
 - `src/api/createDiagramEditor.ts`

package/docs/CAPABILITIES.md

@@ -18,7 +18,10 @@
 - Optional grid-child width topology editing with `gridLayoutChanged` host events.
 - Parent-owned direct-child drag suppression through `ElementData.childElementInteraction`.
 - Element-level visibility/selectability policy through `ElementData.visible` and `ElementData.selectable`, with element-body-only hiding, direct-owned port/text suppression, and visible descendants that keep their own links/rendering behavior.
+- Host-callable viewport focus through `focusElement(elementId, options?)`.
 - Element shape hover controls with edge/vertex/midpoint targets and interaction callbacks.
+- Observational `elementDoubleClick` event for element-body double click / double tap.
+- Cancellable delete lifecycle events (`elementDeleting`, `portDeleting`, `linkDeleting`, `textDeleting`) before direct, selection, and cascade removals commit.
 - Link labels through link-owned `TextData`, including midpoint-relative attachment that follows reroute and endpoint movement.
 - Optional host callback for shaping auto-created destination ports during link-to-element preview and commit.
 - Optional random link color assignment from configurable pools during link creation, plus opt-in load-time fill for links missing `style.stroke`.

package/docs/COMMANDS_EVENTS.md

@@ -6,7 +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.
+- Editor helpers such as `zoomToFitElements(options?)` and `focusElement(elementId, options?)` compose existing viewport updates rather than introducing separate patch types.
 
 ## Patch Entities
 - `element`
@@ -20,7 +20,7 @@
 ## Mutation To Events Mapping
 - `add/move/resize/remove element`
   - Always `change`
-  - Plus `elementMoved`, `elementResized`, or `elementDeleted` when applicable
+  - Plus `elementMoved`, `elementResized`, `elementDeleting`, or `elementDeleted` when applicable
 - `resize element` with enabled grid-child width topology editing
   - Standard `change`
   - Standard `elementResized` when size changes
@@ -28,22 +28,26 @@
 - `add/move/remove port`
   - Always `change`
   - Plus `portMoved` on effective movement
-  - Plus `portDeleted` on removal (including cascade removal)
+  - Plus `portDeleting` before removal and `portDeleted` on successful removal (including cascade removal)
 - `add/update/remove link`
   - Always `change`
-  - Plus `linkDeleted` on removal (including cascade removal)
+  - Plus `linkDeleting` before removal and `linkDeleted` on successful removal (including cascade removal)
 - `add/update/move/remove text`
   - Always `change`
   - Plus `textUpdated` when `updateText` resolves display layout
-  - Plus `textDeleted` on removal (including cascade removal)
+  - Plus `textDeleting` before removal and `textDeleted` on successful removal (including cascade removal)
 - `setSelection/toggleSelection/deleteSelection`
   - `selection` plus derived selected entity events
+  - `deleteSelection` evaluates each selected root independently, so a vetoed root can be skipped while unrelated roots still delete
   - hidden element bodies, direct-owned hidden artifacts, and `selectable:false` element IDs are filtered out before selection persists/emits
 - `setViewport`
   - `change` with viewport patch (`render: false`)
 - `zoomToFitElements`
   - delegates to `setViewport` when at least one visible element exists
   - emits the same viewport `change` patch path
+- `focusElement`
+  - delegates to `setViewport` when the target element resolves
+  - preserves the current zoom unless `options.zoom` is supplied
 - `setRouting/setSnapping/registerShape`
   - `config` events
 
@@ -53,6 +57,8 @@
   - legacy `element-drop`
   - `elementDragged`
 - Click paper: `paperClick`
+- Double click/tap element body:
+  - `elementDoubleClick`
 - Linking:
   - `elementLinkStarted`
   - optional `onCreateLinkTargetPort(...)` preview/commit shaping for link-to-element completion
@@ -60,13 +66,16 @@
   - `elementLinkEnded`
 
 ## Preconditions
-- Events are emitted only after engine state transition logic.
+- Events are emitted only after engine state transition logic resolves a valid action.
+- Cancellable `...Deleting` events emit before the corresponding mutation commits.
 - Derived events require selected IDs to resolve to known entity types.
 
 ## Failure Modes
 - Unknown IDs do not emit entity-specific movement/selection events.
 - Canceled link creation emits `elementLinkEnded` with `cancelled=true` and no link creation.
+- `focusElement(...)` emits no viewport change when the target element id does not resolve.
 - Built-in element-body selection emits no persisted element selection when the target element is hidden or sets `selectable = false`.
+- Text double click continues text editing precedence and does not also emit `elementDoubleClick`.
 - Built-in drag on a direct child element emits no move/drop mutation when its parent sets `childElementInteraction.movable = false`.
 - `textUpdated` emits only when target text exists; missing IDs remain no-op.
 

package/docs/DOCUMENTATION_WORKFLOW.md

@@ -59,7 +59,7 @@ When resuming later:
 5. Re-run packaging verification.
 
 ## 6. Current Status
-- Last updated: 2026-06-26
+- Last updated: 2026-07-07
 - Last completed step: 10
 - Next step: 7 (optional additional fixture coverage for deeper nested/manual-route scenarios)
 - Owner: Codex (with repository maintainers)
@@ -93,3 +93,5 @@ When resuming later:
 - 2026-06-20: Ran release validations: `npm run typecheck`, `npm test -- --watchAll=false`, `npm run build`, `npm run rollup-build-lib`, and `npm pack --dry-run`.
 - 2026-06-26: Completed release-doc pass for `v0.2.12`; refreshed release highlights, link-created target-port callback contract text, integration guidance, and machine-readable contract metadata.
 - 2026-06-26: Ran release validations: `npm run typecheck`, `npm test -- --watchAll=false`, `npm run build`, `npm run rollup-build-lib`, and `npm pack --dry-run`.
+- 2026-07-07: Completed release-doc pass for `v0.2.13`; refreshed release highlights, focus/navigation and delete-lifecycle API/event docs, and machine-readable contract metadata.
+- 2026-07-07: Ran release validations: `npm run typecheck`, `npm test -- --watchAll=false`, `npm run build`, `npm run rollup-build-lib`, and `npm pack --dry-run`.

package/docs/INTEGRATION_PLAYBOOK.md

@@ -23,6 +23,8 @@ Embed this library into another diagram host while preserving deterministic stat
 10. Set `linkColorPoolPolicy` when hosts want random link colors on creation and optional load-time backfill for loaded links whose `style.stroke` is missing or blank.
 11. Create link labels with ordinary `TextData` by setting `ownerId` to the target link id; the stored `position` is midpoint-relative for link-owned text rather than a free world-space coordinate.
 12. Set `onCreateLinkTargetPort` when hosts need to customize the auto-created destination port for link-to-element drops; keep using `elementLinkConnecting` when the host needs to cancel the drop entirely.
+13. Use `focusElement(elementId, options?)` when the host needs to center one editor element in response to navigation, search, or external selection.
+14. Subscribe to `elementDoubleClick` and cancellable `...Deleting` events when the host needs double-click intent or pre-delete confirmation/guard logic.
 
 ## Path B: Engine-Only Adapter
 1. Implement `Renderer`:
@@ -42,9 +44,11 @@ Embed this library into another diagram host while preserving deterministic stat
   - host edge label -> `TextData` with `ownerId = link.id`
 - Event mapping:
   - host click -> `setSelection` / `emitElementClick`-equivalent behavior
+  - host double click / double tap -> `elementDoubleClick`
   - host drag end -> `emitElementDrop`-equivalent payload
   - host link gesture -> `elementLinkStarted/Connecting/Ended` lifecycle
   - optional host target-port shaping -> `onCreateLinkTargetPort(...)` for link-to-element preview/commit only
+  - host delete confirmation / veto surface -> cancellable `elementDeleting` / `portDeleting` / `linkDeleting` / `textDeleting`
 
 ## Behavioral Checklist Per Integration Step
 - Preconditions

package/docs/PORTING_CHECKLIST.md

@@ -32,14 +32,17 @@
 - Ensure host can emulate:
   - `elementDrop` + legacy `element-drop`
   - `paperClick`
+  - `elementDoubleClick`
   - `elementLinkStarted/Connecting/Ended`
   - `portMouseDown/portMouseUp`
-  - deletion and text lifecycle events (`portDeleted`, `linkDeleted`, `textDeleted`, `textUpdated`)
+  - cancellable delete lifecycle events (`elementDeleting`, `portDeleting`, `linkDeleting`, `textDeleting`)
+  - post-delete and text lifecycle events (`elementDeleted`, `portDeleted`, `linkDeleted`, `textDeleted`, `textUpdated`)
 
 ## 6. Verify Cascading Deletes
 - Deleting element should remove descendant ports, connected links, owned texts.
 - Deleting port should remove connected links and owned texts.
 - Deleting link should remove owned texts.
+- A veto from any `...Deleting` handler should abort that root delete request before mutation commit.
 
 ## 7. Run Fixture-Based Validation
 - Load fixtures from `fixtures/*.json`.

package/package.json

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