| Term | Meaning |
|---|---|
| Core | @owdproject/core — engine Nuxt module, window manager, core Desktop* components. |
| Kit | Shared package (e.g. kit-primevue for PrimeVue demos). Shell/explorer APIs live in core since 3.4. |
| Desktop (shell) | Nuxt project (e.g. desktop/) importing core + desktop.config.ts. |
| Theme | Nuxt module defining shell UI (“OS” look); exposes Desktop.vue. |
| App (OWD) | Nuxt module registering programs via defineDesktopApp. |
| Extension module | Extra Nuxt module in desktop.config.ts → modules (e.g. module-fs) — not an “app”. |
desktop.config.ts | Declarative config: theme, modules, apps, plus shell keys. |
owd.config.ts | Legacy filename; still supported. |
defineDesktopConfig | Typed helper for the desktop config default export. |
defineDesktopApp | Registers an application with the application manager (in app plugin.ts). |
defineDesktopModule | Nuxt module wrapper for apps/extensions with configKey → public.desktop[key]. |
defineDesktopTheme | Nuxt module wrapper for themes; merges shell defaults into public.desktop. |
useDesktopExtension(key) | Auto-imported composable; reads public.desktop[key] (extension namespaces). |
hasDesktopModule(pkg) | Auto-imported; true when desktop.modules includes the package name. |
ApplicationConfig | Schema: id, windows, entries, commands. |
DesktopCore | Core shell wrapper component (formerly CoreDesktop). |
useExplorerStore | Explorer UI state in core runtime/explorer/. |
useDesktopDialogs | Dialog provider accessor in core; PV impl in kit-primevue. |
useDesktopShellIdentity | Shell user display + VFS userHome; Guest by default — Shell identity. |
ShellIdentity | { userId, displayName, avatarUrl, userHome } from useDesktopShellIdentity. |
| Playground | Mini Nuxt app beside module source for isolated development. |
nuxt-module-build | Builds Nuxt modules to dist/module.mjs. |
workspace:* | pnpm specifier linking to a package in the same monorepo — see Package linking. |
defu | UnJS deep-default merge; user config wins over theme defaults. |