61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# 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/1.%20Studio%20Shell%20and%20Workspace%20Layout%20Specification.md)
|
|
- [`../specs/2. Studio UI Foundations Specification.md`](../specs/2.%20Studio%20UI%20Foundations%20Specification.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
|