@nodebraid/interaction-api

Package 尚未公开发布

该名称表示当前源码模块边界，不代表可以从 npm 安装。请按 Quick Start 从源码验证。

解决的问题

瞬态 Drag/Pan Preview 需要进入 Renderer，但不应把 Runtime 状态机、DOM Event 或具体后端对象写进 Renderer API。该 package 只拥有 NodeBraid 的不可变 Projection 值，让 Interaction 行为与 Renderer Provider 通过一条稳定值 seam 对接。

提供的能力

• InteractionProjection：node-drag | viewport-pan | box-selection | connection-preview discriminated union；
• NodeDragInteractionProjection：规范 Node ID、base position 与绝对 candidate position；
• ViewportPanInteractionProjection：base Viewport 与绝对 candidate Viewport；
• WorldRect 与 BoxSelectionInteractionProjection：方向无关的 World-space 框选矩形；
• createWorldRect：从两个 World Point 构造冻结的方向无关 World Rect，保留水平或垂直零面积语义；
• NodeDragProjectionNode：单个拖动 Node 的局部 evidence 与候选位置。
• ConnectionAnchorIdentity：Node ID 与 source/target role 组成的 backend-neutral Anchor 身份；
• ConnectionPreviewInteractionProjection：source、Pointer World Point 与 none | valid | invalid target。

import type { InteractionProjection } from '@nodebraid/interaction-api';

const preview: InteractionProjection = {
  type: 'viewport-pan',
  baseViewport: { x: 0, y: 0, zoom: 1 },
  viewport: { x: 24, y: 12, zoom: 1 },
};

依赖与边界

Package 只依赖 @nodebraid/kernel 的 Node ID/Point 与 @nodebraid/session-api 的 Viewport。它不依赖 Renderer、Runtime、Plugin Host、DOM、具体 Provider 或 @nodebraid/core，也不拥有 Active Gesture、Command、Selection 或 lifecycle。

@nodebraid/renderer-api 消费这些值作为 Provider update contract，@nodebraid/plugin-interaction 创建它们，@nodebraid/plugin-renderer 中介唯一写入者。

限制与验证

当前包含 Node Drag、Viewport Pan、Box Selection 与可选 portId 的 Connection Preview identity，不提供 Port Runtime 注册、hover、lasso、snapping、Tool Registry 或任意后端 handle。Port 值与 Runtime 分别由 @nodebraid/port-api 和 @nodebraid/plugin-port 拥有；类型/声明检查拒绝 Renderer、DOM 与具体 Provider 泄漏。