@aura3d/editor-runtime

中文文档

4.7.0发布于 2026/10/31MITTypeScriptES Module

Runtime editor command history, selection state, picking, inspector models, play-mode snapshots, material variants, and transform gizmos for Aura3D.

文档目录3 节

Public API
Platform Scope
Verification

@aura3d/editor-runtime

@aura3d/editor-runtime owns editor command history, selection state, picking, inspector models, play-mode snapshots, and transform gizmos for runtime editor workflows.

Public API

EditorRuntime, EditorMode: mode switching, public selection methods, command execution, inspector edit execution, picking, translate-gizmo drag execution, diagnostics snapshots, material variant workflow ownership, and disposal.
Command, CommandHistory, CommandContext: execute/undo/redo contracts with rollback on failed command execution.
Selection: ordered selection state and listener notifications.
PickingService: deterministic target hit selection and pick result ordering.
InspectorModel: editable inspector property projection and typed set-property command creation.
MaterialVariantWorkflow: editor-owned glTF/material variant selection state and render-resource option projection.
PlayModeBridge: snapshot capture/restore for edit/play mode boundaries.
Gizmo, TranslateGizmo, RotateGizmo, ScaleGizmo: transform handles, hit testing, and drag application.
createStaticExportHtml, createStaticExportRuntime: package-owned static export shell/runtime generation for checked editor-authored project smoke tests without loading the editor app.
CreateNodeCommand, DeleteNodeCommand, SetPropertyCommand, TransformCommand: built-in editor commands.

Platform Scope

Browser-only. @aura3d/editor-runtime has no Desktop shell, no Tauri integration, and no native file-system or windowing bindings: the bounded root surface (editor.undo/redo/gizmo/playMode/outliner, capability label editor) runs inside the browser createAuraApp page. A Desktop/Tauri editor is roadmap, not a current capability — do not claim it.

Verification

Editor selection, command rollback, undo/redo, inspector edits, material variant workflow selection, picking, play-mode snapshots, translate/rotate/scale gizmos, keyboard shortcut contracts, browser editor pixels, editor public-runtime boundary enforcement, editor-authored provenance, and package-owned static export runtime generation are covered by tests/unit/workstream5-input-audio-scripting-editor.test.ts, packages/editor-runtime/tests/editor-runtime.test.ts, tests/unit/editor/project-serializer.test.ts, tests/unit/editor/public-runtime-boundary.test.ts, tests/integration/editor-authored-project-replay.test.ts, tests/browser/editor-browser.spec.ts, and tests/visual/editor-app-pixels.spec.ts. Export and import consistency is covered by pnpm verify:exports and pnpm verify:imports.

版本与发布记录

@aura3d/editor-runtime 共发布 47 个版本，首次发布于 2026/06/06；过去 12 个月发布了 47 个版本。

版本	发布日期	距今
`4.7.0`latest	2026/10/31	3 天前
`4.6.2`	2026/10/30	4 天前
`4.6.1`	2026/10/30	4 天前
`4.6.0`	2026/10/30	4 天前
`4.5.0`	2026/10/29	5 天前
`4.3.7`	2026/10/28	6 天前

关于 @aura3d/editor-runtime 的常见问题

@aura3d/editor-runtime 是什么？

运行时编辑器命令历史，选择状态，挑选，检查器模型，播放模式快照，材料变体，以及Aura3D的转换小工具。

如何安装 @aura3d/editor-runtime？

在项目目录运行 npm install @aura3d/editor-runtime，或使用 pnpm add / yarn add / bun add。

@aura3d/editor-runtime 支持 TypeScript 吗？

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

@aura3d/editor-runtime 支持 ESM 还是 CommonJS？

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

@aura3d/editor-runtime 可以商用吗？

@aura3d/editor-runtime 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@aura3d/editor-runtime 还在维护吗？

最新版本 4.7.0 发布于 2026/10/31（3 天前）；至今共发布 47 个版本，其中过去 12 个月发布了 47 个；首次发布于 2026/06/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。