| Composable | Package | Role |
|---|---|---|
useApplicationManager | core | App registry: launch, windows, commands. |
useDesktopManager | core | Runtime shell config (setConfig), default app per feature. |
useWorkspaceManager | core | Overview keyboard shortcuts, HTML5 workspace edge drops. |
useApplicationEntries | core | Launcher entries / categories. |
useDesktopDialogs | core | Alert / confirm / prompt via inject or browser fallback. |
useToggleWindowMaximize | core | Maximize/restore with optional work area. |
useDesktopShellIdentity | core | Shell user + VFS home — see Shell identity. |
useDesktopShellOptions | core | systemBar, startButton from config. |
useDesktopSession | core | End session → theme start route. |
useWorkspaceEdgeDrop | core | Edge drag between workspaces. |
useWorkspaceOverviewLiveScale | core | Overview live DOM scale. |
useExplorerStore | module-fs | Explorer selection, nav state (headless VFS). |
createExplorerWindowMenuItems | module-fs | Explorer window menu model. |
Prefer composables over reaching into Pinia stores from apps when a composable already wraps the use case.
PrimeVue dialog implementation: createDesktopDialogs in @owdproject/kit-primevue (not core).
| Store | Role |
|---|---|
useDesktopStore | Personalization, default apps map, shell flags. |
useDesktopWorkspaceStore | Active workspace, overview mode. |
useDesktopWindowStore | Global z-index counter. |
Per-app state lives in application controllers and app-specific stores registered by each app module.
| Old | New |
|---|---|
useDesktopExplorerStore (core) | useExplorerStore (in @owdproject/module-fs) |
CoreDesktop, CoreWindow, … | DesktopCore, DesktopWindow, … |
useWorkspaceOverview | useWorkspaceManager |
OWD_DIALOG_PROVIDER_KEY (core) | DESKTOP_DIALOG_PROVIDER_KEY (core) |
Shell composables in kit-theme | @owdproject/core/runtime/composables/ |
createDesktopDialogs in kit-theme | @owdproject/kit-primevue |
Pinia store IDs starting with owd/ | Store IDs starting with desktop/ |
kit-fs / kit-explorer / kit-theme | core + @owdproject/module-fs + @owdproject/kit-primevue |
When upgrading themes, grep for old package paths and align peerDependencies to ^3.4.0 (core) and add @owdproject/kit-primevue for PV UI/dialogs.