@aglyn/besigner

中文文档
1.19.0发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 9673

Besigner,Aglyn的视觉编辑器的逻辑,其中没有UI:编辑器应用和界面状态,选择和徘徊,拖放规则,元素和样式剪贴板,和节点移动. 如果您在 Aglyn 节点上建起自己的编辑器, 请安装它

中文使用文档
文档目录5 节
  1. 安装
  2. 里面有什么东西
  3. 使用量
  4. 怎样才合适
  5. 许可证

@aglyn/ 签名人

Besigner的逻辑,Aglyn的视觉编辑器,里面没有UI:编辑应用程序和 界面状态、选择和徘徊、拖放规则、元素和 样式剪贴板和节点移动。 安装它,如果你正在建造自己的 在Aglyn的节点模型上编辑 UI. 如果你想让编辑像船一样飞,就拿 @aglyn/besigner-ui,它基于此软件包.

从Aglyn monorepo出版到npm. 随后的版本 语义版本。 。 。 .

安装

npm install @aglyn/besigner

同伴依赖性 :

  • react (仅用于参考类型;软件包不产生)

这是"只有逻辑"的消费者故事: @aglyn/besigner 合并 @aglyn/aglyn 安装为 react 作为唯一的同伴。 它需要没有 next,没有 SDK基地,没有MUI和没有 @aglyn/besigner-ui. 框架同行 @aglyn/aglyn 这些都是可选的.

里面有什么东西

编辑器应用程序和接口状态 :

  • initializeBesignerApp, (中文(简体) ), getBesignerApp, (中文(简体) ), doesBesignerAppExist 财务报告和审定财务报表 deleteBesignerApp 管理命名的编辑器应用实例 (单位:千美元)BesignerAppController) (中文(简体) ). 没有名称,则使用默认的应用程序.
  • BesignerInterfaceController 持有编辑器的旗帜和面板状态. setBesignerFlag, (中文(简体) ), setBesignerFlags, (中文(简体) ), setBesignerPanel 财务报告和审定财务报表 setBesignerPanels 更新给给定的应用程序 .
  • 该状态的常数和类型: InteractionModeFlag, (中文(简体) ), BesignerDeviceFlag, (中文(简体) ), BesignerPanelViewFlag, (中文(简体) ), BesignerPanelTabFlag, (中文(简体) ), BesignerContext 和旗和面板键类型.

管理者,在 @aglyn/aglyn数字 :

  • focus 是选择、徘徊和扩展树的状态: setSelectedNode, (中文(简体) ), getSelected, (中文(简体) ), rangeSelectNode, (中文(简体) ), clearSelection, (中文(简体) ), setHoveredNode, (中文(简体) ), expandNode, (中文(简体) ), collapseNode 还有其他.
  • dnd 是一个 DndManager 实例跟踪当前拖放目标 空降区。 再说一遍 confirmValidLinealRelationship检查 (b) 某一项目是否属于某一父项目(线性规则), 和空投区域几何帮助,例如 determineDropRegion。 。 。 .
  • clipboard 副本和粘贴元素(copyNodes, (中文(简体) ), pasteInto, (中文(简体) ), hasContent, (中文(简体) ), clear),以及 styleClipboard 样式也一样。 这个 剪贴板镜像本身进入 localStorage。 。 。 .
  • moveNodeIn, (中文(简体) ), moveNodeOut, (中文(简体) ), canMoveNodeIn, (中文(简体) ), canMoveNodeOut, (中文(简体) ), resolveMoveIn 财务报告和审定财务报表 resolveMoveOut 将节点一个关卡移动入或出 它的邻居.
  • pick 是“ 在画布上选择一个元素” 模式 : startPick, (中文(简体) ), cancelPick, (中文(简体) ), isPicking, (中文(简体) ), handlePickClick。 。 。 .
  • refs 将节点ID图到他们完成的DOM refs上,一个UI填充.
  • isTextEntryElement 财务报告和审定财务报表 isTextEntryFocused 告诉快捷键处理器 用户正在输入.
  • devicePreviewWidth 财务报告和审定财务报表 isRootElementId 他们是小帮手.

每个文件下 src/lib 也可以通过子路径达到,例如 @aglyn/besigner/focus-manager/focus-manager。 。 。 .

使用量

import { canvas } from '@aglyn/aglyn'
import {
  canMoveNodeOut,
  clipboard,
  focus,
  initializeBesignerApp,
  moveNodeOut,
} from '@aglyn/besigner'

const app = initializeBesignerApp()

// `nodes` is a NodesMap loaded from a stored screen version
canvas.setNodes(nodes)

const [first] = canvas.rootNode.children
focus.setSelectedNode(first)

clipboard.copyNodes(focus.getSelected())
const pasted = clipboard.pasteInto(canvas.rootNode)
if (pasted.error) console.warn(pasted.error)

if (canMoveNodeOut(first)) moveNodeOut(first)

一个完整的应用程序是这样构建的, 有自己的大纲、工具栏和预览, 实值 examples/consumers/logic-only 在单体。 它安装这个软件包 @aglyn/aglyn 从 npm 改为 react aglyn的CI在浏览器里建立并运行它 在每一个释放.

怎样才合适

这是 besigner 包映射的范围:设计者的逻辑, 无需UI即可发布. 进口核心@aglyn/aglyn)和 常规 @aglyn/shared-* 只有软件包。 它从不进口设计师UI 渲染器或插件 . @aglyn/besigner-ui 上面是反应表面,还有 插件也可能导入它 .

许可证

阿帕奇2.0 (英语). 资料来源: https://github.com/aglyn/aglyn/tree/main/libs/besigner/core 页面存档备份,存于互联网档案馆

版本与发布记录

@aglyn/besigner 共发布 159 个版本,首次发布于 2026/09/21;过去 12 个月发布了 159 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.19.0latest2026/11/07今天
1.18.02026/11/07今天
1.17.02026/11/07今天
1.16.02026/11/07今天
1.15.22026/11/061 天前
1.15.12026/11/061 天前

其他发布通道:beta → 1.0.0-beta.296。

关于 @aglyn/besigner 的常见问题

@aglyn/besigner 是什么?

Besigner,Aglyn的视觉编辑器的逻辑,其中没有UI:编辑器应用和界面状态,选择和徘徊,拖放规则,元素和样式剪贴板,和节点移动. 如果您在 Aglyn 节点上建起自己的编辑器, 请安装它

如何安装 @aglyn/besigner?

在项目目录运行 npm install @aglyn/besigner,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.2.8)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aglyn/besigner 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aglyn/besigner 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@aglyn/besigner 可以商用吗?

@aglyn/besigner 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aglyn/besigner 的下载量有多少?

根据 npm 官方下载统计,@aglyn/besigner 在 2026/10/05 – 2026/11/03 这 30 天内被下载 9,673 次,日均约 322 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aglyn/besigner 还在维护吗?

最新版本 1.19.0 发布于 2026/11/07(今天);至今共发布 159 个版本,其中过去 12 个月发布了 159 个;首次发布于 2026/09/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。