Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • 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.

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.

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.

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 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.

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.

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.

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.