`simvx.editor.workspace_tabs`¶

Workspace Tabs — Unified tab bar for scene and script tabs.

Data model and manager for the VS Code-style unified tab bar where scene tabs and script tabs coexist. Multiple scenes can be open simultaneously, each with its own undo/selection/camera state.

Module Contents¶

Classes¶

`SceneTabState`	Per-scene snapshot holding all scene-specific state.
`ScriptTabState`	Per-script tab state.
`WorkspaceTabs`	Unified tab manager for scene and script tabs.
`UnsavedChangesDialog`	Modal confirmation dialog shown when closing a tab with unsaved changes.
`NewSceneDialog`	Modal overlay for choosing a new scene root type.

Data¶

log

API¶

simvx.editor.workspace_tabs.log[source]¶: ‘getLogger(…)’

class simvx.editor.workspace_tabs.SceneTabState[source]¶

Per-scene snapshot holding all scene-specific state.

scene_tree: simvx.core.SceneTree¶: None

scene_path: pathlib.Path | None¶: None

selection: simvx.core.Selection¶: ‘field(…)’

undo_stack: simvx.core.UndoStack¶: ‘field(…)’

editor_camera: simvx.core.EditorCamera3D¶: ‘field(…)’

viewport_sub_mode: str¶: ‘3d’

modified: bool¶: False

saved_scene_data: dict | None¶: None

playing_root: simvx.core.Node | None¶: None

placeholder: simvx.core.Control¶: ‘field(…)’

tab_name: str¶: ‘Untitled’

property tab_widget: simvx.core.Control¶: The widget representing this tab in a TabContainer.

property is_dirty: bool¶: Whether this tab has unsaved changes.

save() → None[source]¶: Mark clean; actual file save is handled by EditorState/SceneFileOps.

classmethod create(root_type: type = Node, name: str = 'Root') → simvx.editor.workspace_tabs.SceneTabState[source]¶: Create a fresh scene tab with sensible defaults.

class simvx.editor.workspace_tabs.ScriptTabState[source]¶

Per-script tab state.

key: str¶: None

kind: str¶: None

node: simvx.core.Node¶: None

editor: simvx.core.CodeTextEdit¶: None

saved_text: str¶: None

tab_name: str¶: None

__post_init__()[source]¶

property tab_widget: simvx.core.Control¶: The widget representing this tab in a TabContainer.

property is_dirty: bool¶: Whether this tab has unsaved changes (O(1) hash check).

save() → None[source]¶: Persist the current editor text back to its source.

class simvx.editor.workspace_tabs.WorkspaceTabs[source]¶

Unified tab manager for scene and script tabs.

Initialization

MODIFIED_TEXT_COLOUR¶: (0.95, 0.78, 0.35, 1.0)

MODIFIED_PREFIX¶: ‘● ‘

bind(tab_container: simvx.core.TabContainer)[source]¶: Bind to a TabContainer widget for display.

property tab_count: int¶

property active_index: int¶

is_scene_tab(i: int) → bool[source]¶

is_script_tab(i: int) → bool[source]¶

add_scene_tab(state: simvx.editor.workspace_tabs.SceneTabState) → int[source]¶: Add a scene tab and return its index.

get_active_scene() → simvx.editor.workspace_tabs.SceneTabState | None[source]¶: Return the active scene tab state, or None if a script tab is active.