@vvfx/artis 0.0.1-alpha.0

package/dist/artis/wiring/setup-event-bindings.d.ts

@@ -0,0 +1,16 @@
+import type { WiringContext } from './wiring-context';
+/**
+ * 绑定各核心服务事件转发（视口 / 渲染 / 选区 / 状态）。
+ */
+export declare function setupCoreEventBindings(ctx: WiringContext): void;
+/**
+ * 绑定 Selection 事件转发（选中变化 / 预选变化）。
+ *
+ * Selection 由 GestureHandler 在 init 阶段创建，构造 BaseArtis 时还不存在，
+ * 故本函数必须在装配后调用（由 BaseArtis.prepareGizmo 在 initGizmo 之后触发），
+ * 不能放进构造期执行的 {@link setupCoreEventBindings}。
+ *
+ * Selection 对外 emit 的是 'selectionchange' / 'preselectchange'，
+ * 这里翻译回 Artis 历史的 'selectedItemChange' / 'preSelectedItemChange' 事件名，保持外部 API 不变。
+ */
+export declare function setupSelectionBindings(ctx: WiringContext): void;

package/dist/artis/wiring/setup-keybindings.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 内置快捷键注册 - wiring
+ *
+ * 把"按键 → 指令"的内置映射登记到 KeyBindingController。多数内置绑定走 handler 旁路：
+ * 在按键时动态取当前选中 / 视口 / 历史上下文，再委托 CommandService.execute，
+ * 因为这些命令的 args 依赖运行时选区（不可静态透传）。
+ *
+ * 决策②全量基础指令；key 用平台无关抽象修饰符 ctrl（mac=metaKey / win=ctrlKey，由 matcher 解释）。
+ * Esc 复用：selection.deselect（global，非文本态取消选择）+ text.exit（editing，文本态退出编辑），
+ * 同 combo 不同 scope，运行时互斥，不触发冲突报错。
+ */
+import type { Selection } from '@vvfx/gizmo';
+import type { CommandService } from '../../core/command';
+import type { ItemService } from '../../core/service';
+import type { Store } from '../../core/store';
+import type { ViewService } from '../../core/service/view-service';
+import type { HistoryManager } from '../../core/history';
+import type { StateManager } from '../../core/state';
+import { KeyBindingController } from '../../core/keybinding/key-binding-controller';
+import type { WiringContext } from './wiring-context';
+/** wiring 上下文：与 registerCommands 范式一致（getter 延迟求值），补充 history / gestureHandler / stateManager。 */
+export type KeyBindingWiringContext = {
+    commandService: CommandService;
+    getItemService: () => ItemService;
+    store: Store;
+    getSelection: () => Selection;
+    viewService: ViewService;
+    history: HistoryManager;
+    leaveTextEditing: () => void;
+    stateManager: StateManager;
+};
+/**
+ * 装配内置快捷键：构造 LocalStorageKeyBindingStore + KeyBindingController（构造期订阅 GestureHandler
+ * 的 keyDown 命中注册组合即执行对应 command/handler），注册全部内置绑定，返回 controller 供 BaseArtis 持有。由 BaseArtis 装配期调用。
+ *
+ * GestureHandler 会先发 keyDown 给快捷键注册表，未 accept 时才继续派发给 Gizmo。
+ */
+export declare function setupKeyBindings(wiringCtx: WiringContext): KeyBindingController;

package/dist/artis/wiring/setup-plugins.d.ts

@@ -0,0 +1,5 @@
+import type { WiringContext } from './wiring-context';
+/**
+ * 注册并激活内置插件（当前为 IOPlugin）。
+ */
+export declare function setupPlugins(ctx: WiringContext): void;

package/dist/artis/wiring/wiring-context.d.ts

@@ -0,0 +1,34 @@
+import { type CommandService, type HistoryManager, type PluginSystem, type AssetManager, type Renderer, type ViewService, type ItemService, type Store, type InteractionService, type BaseArtisEvents, type StateChangeEvent } from '../../core';
+import type { StateGizmoController } from '../../core/gizmo/state-gizmo-controller';
+import type { GestureHandler, Selection } from '@vvfx/gizmo';
+import type { StateManager } from '../../core/state';
+/**
+ * Wiring 阶段所需的最小上下文：BaseArtis 已装配好的核心服务集合 + 事件转发出口。
+ *
+ * 这些 setup 函数只做「把已建服务接起来」的胶水工作，不持有状态，
+ * 也不构造任何服务——故装配必须在调用前完成。
+ *
+ * 注意：selection 由 GestureHandler 在 init 阶段创建，构造时还不存在。
+ * - {@link setupCommands} 用 getter 延迟求值（命令工厂在装配后执行）；
+ * - {@link setupSelectionBindings} 必须在装配后调用（由 BaseArtis.prepareGizmo 触发）。
+ */
+export type WiringContext = {
+    readonly commandService: CommandService;
+    readonly historyManager: HistoryManager;
+    readonly pluginSystem: PluginSystem;
+    readonly assetManager: AssetManager;
+    readonly renderer: Renderer;
+    readonly selection: Selection;
+    readonly viewService: ViewService;
+    readonly stateManager: StateManager;
+    readonly stateGizmos: StateGizmoController;
+    readonly itemService: ItemService;
+    readonly store: Store;
+    readonly interactionService: InteractionService;
+    readonly gestureHandler: GestureHandler;
+    leaveTextEditing(): void;
+    handleRendererContextLost(): void;
+    handleRendererContextRestored(): void;
+    handleStateChange(event: StateChangeEvent): void;
+    emit<K extends keyof BaseArtisEvents>(event: K, ...args: BaseArtisEvents[K]): void;
+};