update shell

This commit is contained in:
2026-03-24 13:42:39 +00:00
parent 824a39436a
commit 0e6a79020e
26 changed files with 1498 additions and 105 deletions
@@ -0,0 +1,60 @@
# 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
@@ -0,0 +1,64 @@
# PR-04b - New Project Wizard
## Briefing
The current project launcher can create a project directly from an inline text field.
This PR replaces that minimal path with a dedicated wizard so project creation becomes a guided flow rather than a single-form action.
## Objective
Introduce a new project wizard that guides project creation before opening the Studio shell.
## 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`
- `PR-04a - Project Launcher Window Lifecycle`
## Scope
- replace inline project creation with a wizard flow
- support at least:
- project name
- project location
- final confirmation
- create the project through the existing project service layer
- open the project after successful creation
## Non-Goals
- full template marketplace or template system
- advanced preset configuration
- remote project provisioning
## Execution Method
1. Introduce a `New Project Wizard` surface from the launcher.
2. Split project creation into explicit steps.
3. Validate project name and location before final confirmation.
4. Reuse the existing project creation service instead of duplicating creation logic in the UI.
5. Open the created project after the wizard completes successfully.
6. Keep the wizard aligned with Studio theming and i18n rules.
## Acceptance Criteria
- `Create New Project` opens a wizard instead of creating inline immediately
- the wizard supports name, location, and confirmation steps
- invalid project data is blocked before creation
- successful completion creates the project and opens it
- the flow remains consistent with the launcher/project-entry model
## Validation
- compile validation of `prometeu-studio`
- smoke validation of wizard opening and step progression
- test or smoke coverage for successful project creation
## Affected Artifacts
- launcher UI
- project creation flow
- project service integration
- entry transition from launcher to shell
+2
View File
@@ -41,3 +41,5 @@ The current Studio execution queue is:
1. [`PR-01-studio-event-bus-foundation.md`](./PR-01-studio-event-bus-foundation.md)
2. [`PR-02-studio-shell-components-wave-1.md`](./PR-02-studio-shell-components-wave-1.md)
3. [`PR-03-project-launcher-and-project-entry-shell.md`](./PR-03-project-launcher-and-project-entry-shell.md)
4. [`PR-04a-project-launcher-window-lifecycle.md`](./PR-04a-project-launcher-window-lifecycle.md)
5. [`PR-04b-new-project-wizard.md`](./PR-04b-new-project-wizard.md)