Inno.Editor.Interactions
Section titled “Inno.Editor.Interactions”
- Presentation-independent actions, menus, selection, drag and drop, history and extension activation.
Interactions defines the language shared by Editor features: stable area/action/panel strings, an optional target, a lightweight EditorInteraction, and discovered Actions, menus, shortcuts and drops. It does not reference ImGui, Assets, Scene, Scripting features or a panel project.
Start with a task
Section titled “Start with a task”- Register an action and menu.
- Select targets and move data.
- Record undoable changes.
- Preserve extension state.
- Understand generation activation.
Shared interaction model
Section titled “Shared interaction model”A feature owns its stable area/action constants. An area describes where interaction occurs; an action describes the semantic operation. Passing an area to For or an attribute uses it without a separate registration table. Blank IDs fail and matching is ordinal.
The actual target determines typed action/drop matching. Resolution considers exact area, target-type distance and declared priority. Features use the same resolver through menus, shortcuts and toolbars. They do not introduce an additional command/context service or a marker type solely to identify an area.
Generation and lifetime contracts
Section titled “Generation and lifetime contracts”The runtime constructs a candidate extension catalog from one TypeCache snapshot. Identity conflicts and failed construction reject the candidate. Activation, compensation, quarantine and shutdown follow the shared generation protocol.
Deferred targets, focus, selection and drag data resolve through Core Identity before use. A stale generation is rejected. Temporary domain registration borrows an allocator and returns an owner-thread routing lease; it does not own allocator destruction or copy its object table. Duplicate registration, a wrong thread or registration after retirement fails. Release the route only after restoring its previous selection/owner state successfully.
History stores neutral protocol data and current-generation handlers, not collectible delegates. Documents are owned independently of whether a visible panel currently presents them. Neither transient interactions nor an Undo stack become project layout data.
Document ownership
Section titled “Document ownership”IEditorDocumentService manages shared authoring drafts, including identity, dirty state, Save/Revert/Close, restoration and provider-generation reconnection. A Shader editor or Inspector presents the draft; the service does not create an extra visible panel.
Both persistent asset ID and normalized source path must remain unique. A clean stale context can retire after provider callbacks. A context with unsaved changes rejects replacement until the user explicitly saves, reverts or closes it. Reconnection must not silently discard the draft.
Host and Editor script surfaces
Section titled “Host and Editor script surfaces”Host source uses Inno.Editor.Interactions. Selected Editor scripts use InnoEditor.Interactions, with only explicitly exported contracts. Router internals, catalog snapshots, host selection coordination and temporary History isolation are not inferred script capabilities.
IEditorSelectionCoordinator is a host integration boundary for atomic instance replacement. Ordinary panels select through EditorInteraction.Select. BeginHistoryIsolation is also host-only: a temporary session borrows an isolated empty branch, then restores the complete previous Undo/Redo/fault state when its scope ends. Isolated entries remain subject to the same memory and disk budgets.
API reference
Section titled “API reference”Exact overloads, immutable models, protected action/drop hooks and failure contracts are derived from the selected source surface. A declaration’s presence does not certify its script projection or a product journey.
Browse Editor Interaction types.
Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Editor.Interactions
Source: src/composition/editor/framework/Inno.Editor.Interactions/Inno.Editor.Interactions.csproj
| Type | API | Description |
|---|---|---|
| EditorAction | engine | Defines one automatically discovered editor operation and owns its complete multi-frame lifecycle. |
| EditorActionArgumentContext<TArgument> | engine | Provides a strongly typed action argument to a targetless editor action. |
| EditorActionAttribute | engine | Registers an editor action for automatic discovery and dispatch. |
| EditorActionContext | engine | Provides contextual state to an editor action. |
| EditorActionContext<TTarget> | engine | Provides a strongly typed target to an editor action implementation. |
| EditorActionContext<TTarget, TArgument> | engine | Provides a strongly typed target and action argument to an editor action. |
| EditorActionState | engine | Describes the current presentation and availability of an editor action. |
| EditorAction<TTarget> | engine | Defines a discoverable action whose target must be assignable to a specific reference type. |
| EditorAction<TTarget, TArgument> | engine | Defines a target action that requires one strongly typed command argument. |
| EditorArgumentAction<TArgument> | engine | Defines a targetless editor action that requires one strongly typed command argument. |
| EditorDocumentCloseMode | engine | Selects how a dirty document responds to a close request. |
| EditorDocumentContext | engine | Stores only stable, reload-safe document identity and provider-owned draft parameters. |
| EditorDocumentProvider | engine | Implements one reloadable asset-document kind without owning presentation or source identity. |
| EditorDragContext | engine | Provides contextual state while beginning an editor drag. |
| EditorDragData | engine | Contains the transient identity and preview label for one editor drag operation. |
| EditorDrop | engine | Defines one discoverable typed editor drop operation. |
| EditorDropAttribute | engine | Registers a typed editor drop handler for an optional exact area. |
| EditorDropContext | engine | Provides contextual state to an editor drop handler. |
| EditorDropContext<TSource, TTarget> | engine | Provides strongly typed source and target values to a drop operation. |
| EditorDropPlacement | engine | Describes the requested placement relative to an editor drop target. |
| EditorDropResult | engine | Describes the observable result of a completed editor drop. |
| EditorDropStatus | engine | Describes whether and how a target accepts the active drag. |
| EditorDropVisual | engine | Defines the standard visual used for a compatible drop target. |
| EditorDrop<TSource, TTarget> | engine | Defines a typed drop operation for one managed source and target pair. |
| EditorEditGesture | engine | Owns one continuous edit transaction without retaining edited objects, setters or extension instances. |
| EditorHistoryAvailability | engine | Describes whether a history change can currently move in one direction. |
| EditorHistoryChange | engine | Describes one neutral reload-safe mutation interpreted by an attribute-discovered history handler. |
| EditorHistoryContext | engine | Provides current-generation editor services to a history change handler. |
| EditorHistoryDirection | engine | Identifies the direction in which an editor history change is being applied. |
| EditorHistoryHandler | engine | Interprets neutral editor history payloads for one current-generation feature protocol. |
| EditorHistoryHandlerAttribute | engine | Registers a stateless editor history handler for one stable change protocol. |
| EditorHistoryOptions | engine | Configures retention and payload storage for one editor history. |
| EditorHistoryPayload | engine | Owns immutable neutral bytes used by a reload-safe editor history change. |
| EditorHistoryResult | engine | Describes the outcome of applying, undoing, or redoing an editor history operation. |
| EditorHistoryTransaction | engine | Collects several history operations into one atomic undo and redo entry. |
| EditorInteraction | engine | Provides a fluent handle that borrows an optional target for a synchronous interaction request. |
| EditorInteractionRuntime | engine | Hosts attribute-discovered editor extensions without depending on a presentation backend. |
| EditorInteractions | engine | Provides the single presentation-independent entry point for editor actions, menus, selection, focus, and drag-and-drop. |
| EditorMenuAttribute | engine | Places an editor action at an arbitrary path on a menu surface. |
| EditorMenuBuilder | engine | Collects dynamic menu item placements. |
| EditorMenuContext | engine | Provides contextual state while constructing an editor menu. |
| EditorMenuItem | engine | Represents one immutable contextual menu node. |
| EditorMenuModel | engine | Contains a complete immutable menu tree. |
| EditorMenuSource | engine | Contributes dynamic entries to one or more editor menu surfaces. |
| EditorMenuSourceAttribute | engine | Registers a dynamic editor menu source. |
| EditorModalExtension | engine | Describes one active modal extension. |
| EditorModalExtension.Presentation | engine | Stores immutable modal window policy values read from one extension generation. |
| EditorOperationPreparingEvent | engine | Synchronously closes transient edits before command execution or an extension-handler generation switch. |
| EditorPanelExtension | engine | Describes one active dockable panel extension. |
| EditorPlanarNavigation | engine | Shares captured planar gestures and mouse-anchored zoom math between scene and graph canvases. |
| EditorPresentationAction<TTarget, TPresentation> | engine | Defines a target action with a typed presentation-only argument. |
| EditorSelectionSnapshot | engine | Captures ordered selection identities without retaining any domain object or extension instance. |
| EditorSelectionState | engine | Owns ordered transient selection through domain-qualified identities instead of retaining live objects. |
| EditorShortcutAttribute | engine | Associates an editor action with a keyboard shortcut. |
| EditorToolbarIcon | engine | Identifies a presentation-independent symbol for an editor toolbar command. |
| EditorToolbarItem | engine | Describes one resolved toolbar command. |
| EditorToolbarItemAttribute | engine | Places an editor action on a compact toolbar surface. |
| EditorToolbarModel | engine | Contains an immutable resolved toolbar for one interaction area. |
| EditorValidationResult | engine | Describes whether a requested editor operation is valid and carries a diagnostic when it is rejected. |
| EditorViewportCursor | engine | Selects a presentation-independent cursor requested by a viewport tool. |
| EditorViewportPointerEvent | engine | Contains one immutable viewport pointer sample in screen and world coordinates. |
| EditorViewportPointerPhase | engine | Selects the lifecycle phase of one viewport pointer sample. |
| EditorViewportShortcut | engine | Contains one presentation-independent shortcut sample for a focused viewport tool. |
| EditorViewportTool | engine | Defines one presentation-independent, reloadable viewport editing tool. |
| EditorViewportToolContext | engine | Coordinates pointer capture, transforms, and one history transaction for a viewport gesture. |
| EditorViewportToolSession | engine | Routes focused viewport input to one active tool while enforcing pointer-capture ownership. |
| HotKeyGesture | engine | Describes one keyboard gesture used to invoke an editor command. |
| IEditorDocumentService | engine | Owns single-instance editor documents independently from reloadable providers and presentation. |
| IEditorHistory | engine | Exposes reload-safe Undo and Redo operations based exclusively on neutral history changes. |
| IEditorHistoryIsolation | engine | Creates temporary history branches for transient editor workflows without exposing history internals. |
| IEditorSelectionCoordinator | engine | Coordinates host-owned selection and the Core identity lifetime of temporary presentations. |
| IEditorViewportCoordinateConverter | engine | Converts coordinates for one viewport camera without exposing its presentation backend. |
| EditorAction | Editor | Defines one automatically discovered editor operation and owns its complete multi-frame lifecycle. |
| EditorActionArgumentContext<TArgument> | Editor | Provides a strongly typed action argument to a targetless editor action. |
| EditorActionAttribute | Editor | Registers an editor action for automatic discovery and dispatch. |
| EditorActionContext | Editor | Provides contextual state to an editor action. |
| EditorActionContext<TTarget> | Editor | Provides a strongly typed target to an editor action implementation. |
| EditorActionContext<TTarget, TArgument> | Editor | Provides a strongly typed target and action argument to an editor action. |
| EditorActionState | Editor | Describes the current presentation and availability of an editor action. |
| EditorAction<TTarget> | Editor | Defines a discoverable action whose target must be assignable to a specific reference type. |
| EditorAction<TTarget, TArgument> | Editor | Defines a target action that requires one strongly typed command argument. |
| EditorArgumentAction<TArgument> | Editor | Defines a targetless editor action that requires one strongly typed command argument. |
| EditorDocumentCloseMode | Editor | Selects how a dirty document responds to a close request. |
| EditorDocumentContext | Editor | Stores only stable, reload-safe document identity and provider-owned draft parameters. |
| EditorDocumentProvider | Editor | Implements one reloadable asset-document kind without owning presentation or source identity. |
| EditorDragContext | Editor | Provides contextual state while beginning an editor drag. |
| EditorDragData | Editor | Contains the transient identity and preview label for one editor drag operation. |
| EditorDrop | Editor | Defines one discoverable typed editor drop operation. |
| EditorDropAttribute | Editor | Registers a typed editor drop handler for an optional exact area. |
| EditorDropContext | Editor | Provides contextual state to an editor drop handler. |
| EditorDropContext<TSource, TTarget> | Editor | Provides strongly typed source and target values to a drop operation. |
| EditorDropPlacement | Editor | Describes the requested placement relative to an editor drop target. |
| EditorDropResult | Editor | Describes the observable result of a completed editor drop. |
| EditorDropStatus | Editor | Describes whether and how a target accepts the active drag. |
| EditorDropVisual | Editor | Defines the standard visual used for a compatible drop target. |
| EditorDrop<TSource, TTarget> | Editor | Defines a typed drop operation for one managed source and target pair. |
| EditorEditGesture | Editor | Owns one continuous edit transaction without retaining edited objects, setters or extension instances. |
| EditorHistoryAvailability | Editor | Describes whether a history change can currently move in one direction. |
| EditorHistoryChange | Editor | Describes one neutral reload-safe mutation interpreted by an attribute-discovered history handler. |
| EditorHistoryContext | Editor | Provides current-generation editor services to a history change handler. |
| EditorHistoryDirection | Editor | Identifies the direction in which an editor history change is being applied. |
| EditorHistoryHandler | Editor | Interprets neutral editor history payloads for one current-generation feature protocol. |
| EditorHistoryHandlerAttribute | Editor | Registers a stateless editor history handler for one stable change protocol. |
| EditorHistoryPayload | Editor | Owns immutable neutral bytes used by a reload-safe editor history change. |
| EditorHistoryResult | Editor | Describes the outcome of applying, undoing, or redoing an editor history operation. |
| EditorHistoryTransaction | Editor | Collects several history operations into one atomic undo and redo entry. |
| EditorInteraction | Editor | Provides a fluent handle that borrows an optional target for a synchronous interaction request. |
| EditorInteractions | Editor | Provides the single presentation-independent entry point for editor actions, menus, selection, focus, and drag-and-drop. |
| EditorMenuAttribute | Editor | Places an editor action at an arbitrary path on a menu surface. |
| EditorMenuBuilder | Editor | Collects dynamic menu item placements. |
| EditorMenuContext | Editor | Provides contextual state while constructing an editor menu. |
| EditorMenuItem | Editor | Represents one immutable contextual menu node. |
| EditorMenuModel | Editor | Contains a complete immutable menu tree. |
| EditorMenuSource | Editor | Contributes dynamic entries to one or more editor menu surfaces. |
| EditorMenuSourceAttribute | Editor | Registers a dynamic editor menu source. |
| EditorPlanarNavigation | Editor | Shares captured planar gestures and mouse-anchored zoom math between scene and graph canvases. |
| EditorPresentationAction<TTarget, TPresentation> | Editor | Defines a target action with a typed presentation-only argument. |
| EditorSelectionSnapshot | Editor | Captures ordered selection identities without retaining any domain object or extension instance. |
| EditorSelectionState | Editor | Owns ordered transient selection through domain-qualified identities instead of retaining live objects. |
| EditorShortcutAttribute | Editor | Associates an editor action with a keyboard shortcut. |
| EditorToolbarIcon | Editor | Identifies a presentation-independent symbol for an editor toolbar command. |
| EditorToolbarItem | Editor | Describes one resolved toolbar command. |
| EditorToolbarItemAttribute | Editor | Places an editor action on a compact toolbar surface. |
| EditorToolbarModel | Editor | Contains an immutable resolved toolbar for one interaction area. |
| EditorValidationResult | Editor | Describes whether a requested editor operation is valid and carries a diagnostic when it is rejected. |
| EditorViewportCursor | Editor | Selects a presentation-independent cursor requested by a viewport tool. |
| EditorViewportPointerEvent | Editor | Contains one immutable viewport pointer sample in screen and world coordinates. |
| EditorViewportPointerPhase | Editor | Selects the lifecycle phase of one viewport pointer sample. |
| EditorViewportShortcut | Editor | Contains one presentation-independent shortcut sample for a focused viewport tool. |
| EditorViewportTool | Editor | Defines one presentation-independent, reloadable viewport editing tool. |
| EditorViewportToolContext | Editor | Coordinates pointer capture, transforms, and one history transaction for a viewport gesture. |
| EditorViewportToolSession | Editor | Routes focused viewport input to one active tool while enforcing pointer-capture ownership. |
| HotKeyGesture | Editor | Describes one keyboard gesture used to invoke an editor command. |
| IEditorDocumentService | Editor | Owns single-instance editor documents independently from reloadable providers and presentation. |
| IEditorHistory | Editor | Exposes reload-safe Undo and Redo operations based exclusively on neutral history changes. |
| IEditorViewportCoordinateConverter | Editor | Converts coordinates for one viewport camera without exposing its presentation backend. |