prometeu-studio/docs/studio/pull-requests/PR-04a-project-launcher-window-lifecycle.md

PR-04a - Project Launcher Window Lifecycle

Briefing

The current project launcher already exists as a view before the main shell.

This PR evolves that flow into a separate launcher window so project selection and project editing no longer compete for the same application stage.

Objective

Move the project launcher into its own window lifecycle and define how it coordinates with the main Studio project window.

Dependencies

• ../specs/1. Studio Shell and Workspace Layout Specification.md
• ../specs/2. Studio UI Foundations Specification.md
• PR-03 - Project Launcher and Project Entry Shell

Scope

• introduce a dedicated launcher Stage
• open the main Studio shell in a separate project window
• define launcher visibility behavior when a project window opens
• define launcher restoration behavior when a project window closes
• keep event publication aligned with the Studio event model

Non-Goals

• redesigning the launcher content model
• implementing the new project wizard itself
• supporting multiple simultaneous project windows unless needed by the chosen lifecycle

Execution Method

1. Extract launcher-stage creation from the current single-window flow.
2. Open the main Studio shell in its own project window after project selection or creation.
3. Hide the launcher window when a project window opens.
4. Restore or reshow the launcher window when the project window closes.
5. Keep the transition between launcher and project window intentional and easy to follow.
6. Preserve theme and i18n behavior in both windows.

Acceptance Criteria

• the launcher runs in its own window
• the Studio shell runs in a separate project window
• opening or creating a project transitions from launcher to project window cleanly
• closing the project window returns the user to the launcher window
• the flow remains aligned with current project-open and project-created events

Validation

• compile validation of prometeu-studio
• smoke validation of launcher window opening
• smoke validation of launcher hide/show behavior when a project window opens or closes

Affected Artifacts

• prometeu-studio application entry and stage lifecycle
• launcher and shell composition
• project-open window behavior