@omega.js/desktop 0.52.0 → 0.54.0

package/dist/defaults/config/omega.json5

@@ -1,13 +1,13 @@
-// config/omega.json5 — the single OMEGA config file (JSON5: comments + trailing commas OK).
+// config/omega.json5: the single OMEGA config file (JSON5: comments + trailing commas OK).
 //
 // Shape: SHARED sections at the top level (identical spelling in every OMEGA project
-// type — website, backend, extension, desktop), then a `targets` object whose KEY
+// type: website, backend, extension, desktop), then a `targets` object whose KEY
 // PRESENCE says which targets this brand enables and whose values hold target-scoped
 // settings. Any shared key may also appear inside a target entry to override it for
 // that surface only (e.g. a desktop-specific monitoring.providers.sentry.dsn
 // under targets.desktop).
 //
-// Secrets NEVER live here — they live in .env. The validator hard-fails on
+// Secrets NEVER live here: they live in .env. The validator hard-fails on
 // secret-shaped keys (…Secret, …privateKey).
 {
   brand: {
@@ -48,7 +48,7 @@
   // so the same human gets unified events across desktop + web + backend.
   analytics: {
     // Presence-driven: set `providers.google.id` to `G-XXXXXXXXXX` to enable analytics.
-    // Empty string = analytics disabled (matches @omega.js/backend convention — no redundant enabled flag).
+    // Empty string = analytics disabled (matches @omega.js/backend convention, no redundant enabled flag).
     providers: {
       google: {
         id: '',                               // 'G-XXXXXXXXXX' Measurement ID
@@ -56,7 +56,7 @@
     },
   },
 
-  // Payment — @omega.js/backend-shaped so the same product catalog can be referenced from backend
+  // Payment: @omega.js/backend-shaped so the same product catalog can be referenced from backend
   // + desktop. The schema enforces publishableKey shape when set; everything else is
   // freeform so apps can extend per their needs without @omega.js/desktop caring. Leave empty until
   // you're ready to wire payments.
@@ -69,9 +69,9 @@
   },
 
   // App/cloud platform role (provider-discriminated). `config` is the Firebase web
-  // SDK config — copy directly from Firebase Console → Project Settings → SDK setup
+  // SDK config: copy directly from Firebase Console → Project Settings → SDK setup
   // (Config option). Same shape every OMEGA target reads.
-  // Empty config {} disables Firebase Auth in the renderer (client-bridge logs a warn).
+  // Empty config {} disables Firebase Auth in the renderer (the auth lib logs a warn).
   cloud: {
     provider: 'firebase',
     config: {
@@ -86,10 +86,10 @@
     },
   },
 
-  // Appearance — the app's DEFAULT theme. 'system' follows the OS preference live;
-  // 'light'/'dark' are explicit overrides. A user's runtime choice (manager.theme.set
+  // Appearance: the app's DEFAULT theme. 'system' follows the OS preference live;
+  // 'light'/'dark' are explicit overrides. A user's runtime choice (omega.theme.set
   // or the [data-omega-theme-set] controls) persists in storage and wins over this on
-  // every boot. See docs/themes.md.
+  // every boot. See @omega.js/manager/docs/desktop/themes.md.
   theme: {
     appearance: 'system',
   },
@@ -102,7 +102,7 @@
     desktop: {
       type: 'desktop',
 
-      // App-level metadata — universal cross-platform fields. @omega.js/desktop auto-derives sensible
+      // App-level metadata: universal cross-platform fields. @omega.js/desktop auto-derives sensible
       // defaults from the BRAND: `appId` ← `certificates.providers.apple.bundleIdPrefix`
       // plus `brand.id` with its dashes as dots (`com.example` + `my-app` →
       // `com.example.my.app`), the same id the certificates service registers.
@@ -111,11 +111,11 @@
       // `productName` ← `brand.name`, `copyright` ← `© <year>, <brand.name>`.
       // Override any of these explicitly only if you must.
       //
-      // `category` is a generic high-level category — @omega.js/desktop maps it to per-platform values
+      // `category` is a generic high-level category. @omega.js/desktop maps it to per-platform values
       // (mac uses Apple's UTI strings, linux uses freedesktop categories). Allowed values:
       //   productivity (default) | developer-tools | utilities | media | social | network
       // Override the per-platform mapping in `platforms.<plat>.category` if you need
-      // something specific. See docs/installer-options.md for the full table.
+      // something specific. See @omega.js/manager/docs/desktop/installer-options.md for the full table.
       //
       // `copyright` accepts a `{YEAR}` token expanded at build time to the current year.
       // Default is `© {YEAR}, <brand.name>`. Set explicitly only to change the holder.
@@ -127,12 +127,12 @@
         languages:       ['en'],              // applied as mac.electronLanguages
         darkModeSupport: true,                // mac honors via NSRequiresAquaSystemAppearance; win/linux ignore
         // Icons are convention-only. Drop PNGs at:
-        //   config/icons/global/<slot>.png       — universal default for all platforms
+        //   config/icons/global/<slot>.png       : universal default for all platforms
         //   config/icons/mac/<slot>.png          : macOS override (beats global)
-        //   config/icons/windows/<slot>.png      — Windows override
-        //   config/icons/linux/<slot>.png        — Linux override (otherwise falls back to global → windows)
+        //   config/icons/windows/<slot>.png      : Windows override
+        //   config/icons/linux/<slot>.png        : Linux override (otherwise falls back to global → windows)
         // Slots: icon, tray (mac+win+linux); dmg (mac-only).
-        // Native size only — @omega.js/desktop downscales @1x variants from your @2x source automatically.
+        // Native size only: @omega.js/desktop downscales @1x variants from your @2x source automatically.
         // macOS tray must be 32×32; @omega.js/desktop renames the dist output to trayTemplate.png for the
         // OS dark-mode auto-inversion magic.
       },
@@ -145,7 +145,7 @@
       // beside `formats` are install knobs that map onto the same
       // electron-builder concepts (`mac.target`, `win.target`, `linux.target`),
       // but @omega.js/desktop owns the actual target list so auto-update keeps
-      // working (see docs/installer-options.md for why). Each block exposes only
+      // working (see @omega.js/manager/docs/desktop/installer-options.md for why). Each block exposes only
       // the knobs that exist for that platform: there is no cross-platform
       // analog for any of these.
       platforms: {
@@ -156,7 +156,7 @@
           formats: {
             dmg: {},
           },
-          arch: ['universal'],   // universal binary (x64 + arm64 lipo'd) — one .dmg/.zip for both
+          arch: ['universal'],   // universal binary (x64 + arm64 lipo'd), one .dmg/.zip for both
           // Entitlements override map. @omega.js/desktop ships sensible defaults (allow-jit,
           // allow-unsigned-executable-memory, disable-library-validation, network.client/server,
           // files.user-selected.read-write, allow-dyld-environment-variables). To override:
@@ -165,7 +165,7 @@
           // Output: dist/config/entitlements.mac.plist (auto-wired into electron-builder.yml).
           // Example: { 'com.apple.security.network.server': false, 'com.apple.security.device.audio-input': true }
           entitlements: {},
-          // MAS (Mac App Store) — STUBBED. Config is parsed but not yet implemented;
+          // MAS (Mac App Store): STUBBED. Config is parsed but not yet implemented;
           // setting `enabled: true` triggers an audit warning. Real implementation lands
           // in a future release. Reference plists from a working MAS-published Electron app
           // are archived at <em>/src/defaults/_mas/ for the eventual implementation.
@@ -189,12 +189,12 @@
           runAfterFinish:     true,
           perMachine:         false,       // per-user install (required for oneClick:true)
           // Code-signing strategy. Picked at workflow time to drive runner selection +
-          // job gating. See docs/signing.md.
-          //   self-hosted (default) — sign with signtool against an EV USB token (typically
+          // job gating. See @omega.js/manager/docs/desktop/signing.md.
+          //   self-hosted (default):  sign with signtool against an EV USB token (typically
           //                           on an framework-managed self-hosted GH Actions runner)
-          //   cloud                 — shell to a cloud signing provider's CLI (Azure /
-          //                           SSL.com / DigiCert) — provider configured in cloud.provider
-          //   local                 — skip CI signing; developer signs manually on their box
+          //   cloud:                  shell to a cloud signing provider's CLI (Azure /
+          //                           SSL.com / DigiCert), provider configured in cloud.provider
+          //   local:                  skip CI signing; developer signs manually on their box
           signing: {
             strategy: 'self-hosted',
             cloud:    { provider: null, options: {} },
@@ -225,23 +225,23 @@
         enabled:        true,
         autoDownload:   true,
         startupDelayMs:      10000,      // 10s after whenReady → first check
-        feedCheckIntervalMs: 3600000,    // 1h between feed polls (HTTP — keep slow)
+        feedCheckIntervalMs: 3600000,    // 1h between feed polls (HTTP, keep slow)
         idleEvalIntervalMs:  60000,      // 1m idle-install evaluator (cheap, in-process)
-        maxAgeMs:            2592000000, // 30d — once an update has been pending this long, force install
+        maxAgeMs:            2592000000, // 30d: once an update has been pending this long, force install
       },
       // Tray, menu, and context-menu are defined in JS files (full power, no DSL).
       // @omega.js/desktop looks for them at the conventional paths:
       //   src/integrations/tray/index.js
       //   src/integrations/menu/index.js
       //   src/integrations/context-menu/index.js
-      // To disable at runtime: call `manager.tray.disable()` / `manager.menu.disable()` /
-      // `manager.contextMenu.disable()` from your main entry. Idempotent.
+      // To disable at runtime: call `omega.tray.disable()` / `omega.menu.disable()` /
+      // `omega.contextMenu.disable()` from your main entry. Idempotent.
 
-      // Startup behavior — two independent knobs.
+      // Startup behavior: two independent knobs.
       //
       // `mode` controls how the app launches when THE USER opens it directly:
-      //   normal — main window appears, dock icon visible (typical app).
-      //   hidden — packaged builds bake LSUIElement=true into Info.plist on macOS:
+      //   normal:  main window appears, dock icon visible (typical app).
+      //   hidden:  packaged builds bake LSUIElement=true into Info.plist on macOS:
       //            zero dock bounce, no dock icon, not in Cmd+Tab. Tray + notifications
       //            + networking still work. Your main.js skips windows.create() at boot
       //            and surfaces UI later (typically from a tray click). When you do call
@@ -249,8 +249,8 @@
       //            appears alongside the window.
       //
       // `openAtLogin` controls auto-launch on OS login:
-      //   enabled — register the app with the OS to auto-launch (default true).
-      //   mode    — `hidden` (default) means at-login launches behave like `mode: 'hidden'`;
+      //   enabled:  register the app with the OS to auto-launch (default true).
+      //   mode:     `hidden` (default) means at-login launches behave like `mode: 'hidden'`;
       //             `normal` means the at-login launch shows UI like a normal launch.
       //   The login-launch mode applies ONLY when the OS launches the app. User-direct
       //   launches always use `startup.mode` above. So a "normal" app can still start
@@ -262,8 +262,8 @@
           mode:    'hidden',
         },
       },
-      // No `windows` block needed — @omega.js/desktop no longer auto-creates windows. Your main.js
-      // calls `manager.windows.create('main', { width: 1280, height: 800, ... })` when
+      // No `windows` block needed: @omega.js/desktop no longer auto-creates windows. Your main.js
+      // calls `omega.windows.create('main', { width: 1280, height: 800, ... })` when
       // you want UI to surface. Defaults baked in:
       //   main      → { width: 1024, height: 720, hideOnClose: true,  view: 'main' }
       //   any other → { width: 800,  height: 600, hideOnClose: false, view: name   }
@@ -276,17 +276,17 @@
       // `npx omega deploy`'s precheck auto-creates it if it doesn't exist (uses GH_TOKEN).
       // Artifact names carry NO version (MyApp-mac-dmg.dmg), so this repo also serves the marketing
       // site: https://github.com/<org>/<brand.id>-releases/releases/latest/download/<asset> never changes
-      // across versions, and the website derives its download buttons from it. See docs/releasing.md.
+      // across versions, and the website derives its download buttons from it. See @omega.js/manager/docs/desktop/releasing.md.
       releases: {
         enabled: true,
       },
       // Deep links: scheme is automatically `<brand.id>://...`. Built-in routes:
       //   auth/token  → @omega.js/client auth token handoff
-      //   app/show    → manager.windows.show(query.window || 'main')
+      //   app/show    → omega.windows.show(query.window || 'main')
       //   app/quit    → app.quit()
-      // Add custom routes at runtime: manager.deepLink.on('my-route', (ctx) => {...}) in main.
+      // Add custom routes at runtime: omega.deepLink.on('my-route', (ctx) => {...}) in main.
 
-      // "Hot config" — JSON document fetched from the brand site so app behavior
+      // "Hot config": JSON document fetched from the brand site so app behavior
       // can be flipped without shipping a new build (e.g. force-update gate, ads
       // toggle, default user agent strings, etc.). Default URL is derived as
       // `${brand.url}/data/resources/main.json` (legacy convention). Override the
@@ -296,11 +296,11 @@
         enabled: true,
         // url: 'https://brand.example/data/resources/main.json',   // default uses brand.url
       },
-      // Restart Manager — external guardian app that relaunches this app if it
-      // crashes. @omega.js/desktop talks to it over a localhost HTTP protocol (docs/restart-manager.md):
+      // Restart Manager: external guardian app that relaunches this app if it
+      // crashes. @omega.js/desktop talks to it over a localhost HTTP protocol (@omega.js/manager/docs/desktop/restart-manager.md):
       // auto-registers ~15s after launch, heartbeats every 60s, deregisters on clean
       // quit, and silently installs RM when missing (mac zip / win silent NSIS /
-      // linux AppImage — no installer UI, no admin; RM then keeps itself updated via
+      // linux AppImage: no installer UI, no admin; RM then keeps itself updated via
       // its own standard @omega.js/desktop auto-updater). Set false to disable entirely. In dev
       // mode it's skipped unless OMEGA_RESTART_MANAGER_DEV=1.
       restartManager: {

package/dist/defaults/docs/README.md

@@ -1,10 +1,10 @@
 # Project docs
 
-Per-subsystem deep references live here. Keep `AGENTS.md` short — it should read as a **table of contents** that points at files in this directory.
+Per-subsystem deep references live here. Keep `AGENTS.md` short: it should read as a **table of contents** that points at files in this directory.
 
 ## Pattern
 
-When you find yourself adding more than a paragraph to `AGENTS.md`, create a new `docs/<topic>.md` instead and link to it from `AGENTS.md`. Goal: the project's `AGENTS.md` stays under ~250 lines (`CLAUDE.md` is only the one-line `@AGENTS.md` pointer).
+When you find yourself adding more than a paragraph to `AGENTS.md`, create a new `docs/<topic>.md` instead and link to it from `AGENTS.md`. Goal: the project's `AGENTS.md` stays under ~250 lines.
 
 Examples of good `docs/*.md` topics:
 - Subsystem deep-dives (one per area of the codebase)
@@ -14,4 +14,4 @@ Examples of good `docs/*.md` topics:
 
 ## See also
 
-The framework's own docs follow this same pattern — browse `node_modules/@omega.js/desktop/docs/` for the canonical examples.
+The framework's own docs follow this same pattern: browse `node_modules/@omega.js/manager/docs/desktop/` for the canonical examples.

package/dist/defaults/gulpfile.js

@@ -1,4 +1,4 @@
-// Consumer gulpfile — the framework's gulp pipeline, resolved through the
+// Consumer gulpfile: the framework's gulp pipeline, resolved through the
 // require climb so it works wherever npm hoists the framework (brand-root
 // node_modules in a monorepo, local node_modules standalone). The old
 // scripts hardcoded ./node_modules/@omega.js/desktop/... and broke under

package/dist/defaults/hooks/build/post.js

@@ -1,9 +1,9 @@
-// Optional consumer extension hook — called AFTER the build pipeline finishes, BEFORE
+// Optional consumer extension hook, called AFTER the build pipeline finishes, BEFORE
 // electron-builder packages anything. No-op by default.
 //
 // Use this for: post-build asset processing, additional file copies into dist/, generating
 // auxiliary files (changelog, license bundling, etc.).
 
 module.exports = async (ctx) => {
-  // ctx = { manager, mode, projectRoot, distDir }
+  // ctx = { build, mode, projectRoot, distDir }
 };

package/dist/defaults/hooks/build/pre.js

@@ -1,9 +1,9 @@
-// Optional consumer extension hook — called BEFORE the build pipeline runs (defaults →
+// Optional consumer extension hook, called BEFORE the build pipeline runs (defaults →
 // distribute → bundle → sass → html → audit → build-config). No-op by default.
 //
 // Use this for: pre-flight checks, generating build-time artifacts, mutating config before
 // the bundle / build-config tasks see it.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, mode, projectRoot }
+  // ctx = { build, mode, projectRoot }
 };

package/dist/defaults/hooks/deploy/pre.js

@@ -6,5 +6,5 @@
 // that must happen before the publish reaches the release repo.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot, mode }
+  // ctx = { build, projectRoot, mode }
 };

package/dist/defaults/hooks/notarize/post.js

@@ -1,4 +1,4 @@
-// Optional consumer extension hook — called AFTER @omega.js/desktop's built-in macOS
+// Optional consumer extension hook, called AFTER @omega.js/desktop's built-in macOS
 // notarization has already run. No-op by default.
 //
 // Use this for: custom stapling, archiving the notarized .app, notifications, uploading the
@@ -8,7 +8,7 @@
 //
 // IMPORTANT: This file is NOT the notarization entrypoint. @omega.js/desktop's electron-builder integration
 // uses its own internal notarize hook as the afterSign entrypoint, then calls into this file
-// as a final step. You can never accidentally break notarization by editing this — at worst,
+// as a final step. You can never accidentally break notarization by editing this. At worst,
 // a thrown error here fails the build loudly.
 
 module.exports = async (context) => {

package/dist/defaults/hooks/release/post.js

@@ -1,9 +1,9 @@
-// Optional consumer extension hook — called AFTER the release publishes successfully (after
+// Optional consumer extension hook, called AFTER the release publishes successfully (after
 // electron-builder finishes). No-op by default.
 //
 // Use this for: posting to Slack/Discord, kicking off downstream workflows, updating a
 // changelog page on your marketing site, sending notification emails.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot, artifacts }   // artifacts: array of release/ paths
+  // ctx = { build, projectRoot, artifacts }   // artifacts: array of release/ paths
 };

package/dist/defaults/hooks/release/pre.js

@@ -1,9 +1,9 @@
-// Optional consumer extension hook — called BEFORE electron-builder runs the sign + notarize
+// Optional consumer extension hook, called BEFORE electron-builder runs the sign + notarize
 // + publish flow. No-op by default.
 //
 // Use this for: bumping version files in extra places, last-mile validations, archiving the
 // previous release before overwriting.
 
 module.exports = async (ctx) => {
-  // ctx = { manager, projectRoot }
+  // ctx = { build, projectRoot }
 };

package/dist/defaults/src/assets/js/components/about/index.js

@@ -1,10 +1,8 @@
 // About window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
     logger.log('About window initialized!');
   });

package/dist/defaults/src/assets/js/components/main/index.js

@@ -1,11 +1,9 @@
 // Main window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger, ipc, storage, omega } = manager;
+    const { logger, desktop } = omega;
 
     // Add your main-window UI logic here.
     // ...

package/dist/defaults/src/assets/js/components/settings/index.js

@@ -1,10 +1,8 @@
 // Settings window renderer entry.
-const Manager = require('@omega.js/desktop/renderer');
+import omega from '@omega.js/desktop/renderer';
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
     logger.log('Settings window initialized!');
   });

package/dist/defaults/src/assets/scss/pages/about.scss

@@ -1,3 +1,3 @@
-// About window — page-specific styles. Compiled to dist/assets/css/components/about.bundle.css.
+// About window: page-specific styles. Compiled to dist/assets/css/components/about.bundle.css.
 
 // Add your page-only styles below.

package/dist/defaults/src/assets/scss/pages/main.scss

@@ -1,4 +1,4 @@
-// Main window — page-specific styles. Compiled to dist/assets/css/components/main.bundle.css
+// Main window: page-specific styles. Compiled to dist/assets/css/components/main.bundle.css
 // and loaded only on the main window's HTML page.
 
 // Add your page-only styles below.

package/dist/defaults/src/assets/scss/pages/settings.scss

@@ -1,3 +1,3 @@
-// Settings window — page-specific styles. Compiled to dist/assets/css/components/settings.bundle.css.
+// Settings window: page-specific styles. Compiled to dist/assets/css/components/settings.bundle.css.
 
 // Add your page-only styles below.

package/dist/defaults/src/integrations/context-menu/index.js

@@ -1,24 +1,24 @@
 // Context-menu definition. Called by @omega.js/desktop EVERY time the user right-clicks.
 //
-// `manager`     — the running @omega.js/desktop Manager.
-// `menu`        — per-event builder API + id-path API.
-// `params`      — Electron's context-menu params (selectionText, isEditable, linkURL,
+// `omega`: the running @omega.js/desktop main-process instance.
+// `menu`:         per-event builder API + id-path API.
+// `params`:       Electron's context-menu params (selectionText, isEditable, linkURL,
 //                 srcURL, mediaType, editFlags, x, y, etc.).
-// `webContents` — the webContents that fired the event.
+// `webContents`:  the webContents that fired the event.
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working context menu.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working context menu.
 //
 // @omega.js/desktop ships a default template (built per-event from params) with these ids (flat):
-//   undo, redo                                   — when params.editFlags allow
+//   undo, redo:                                    when params.editFlags allow
 //   cut, copy, paste, paste-and-match-style,
-//   select-all                                   — when params.isEditable
-//   copy                                          — when params.selectionText (read-only)
-//   open-link, copy-link                          — when params.linkURL
-//   reload                                        — always
-//   inspect, toggle-devtools                      — dev mode only
+//   select-all:                                    when params.isEditable
+//   copy:                                           when params.selectionText (read-only)
+//   open-link, copy-link:                           when params.linkURL
+//   reload:                                         always
+//   inspect, toggle-devtools:                       dev mode only
 
-module.exports = ({ manager, menu, params, webContents }) => {
-  // Start from @omega.js/desktop's default template. Don't add anything by default — leave it
+module.exports = ({ omega, menu, params, webContents }) => {
+  // Start from @omega.js/desktop's default template. Don't add anything by default: leave it
   // identical to what the framework would do without this file.
   menu.useDefaults();
 

package/dist/defaults/src/integrations/menu/index.js

@@ -1,10 +1,10 @@
 // Application menu definition. Called by @omega.js/desktop during boot.
 //
-// `manager`  — the running @omega.js/desktop Manager.
-// `menu`     — builder API + id-path API (find/update/remove/insertAfter/etc.).
-// `defaults` — the platform-aware default template (an array you can mutate manually if needed).
+// `omega`: the running @omega.js/desktop main-process instance.
+// `menu`:      builder API + id-path API (find/update/remove/insertAfter/etc.).
+// `defaults`:  the platform-aware default template (an array you can mutate manually if needed).
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working application menu.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working application menu.
 //
 // @omega.js/desktop ships a default menu template with stable id paths. Highlights:
 //   main/about, main/check-for-updates, main/preferences (hidden), main/services,
@@ -18,15 +18,15 @@
 //   development/{open-exe-folder, open-user-data, open-logs, open-app-config,
 //                test-error}                                                       (dev only)
 
-module.exports = ({ manager, menu, defaults }) => {
+module.exports = ({ omega, menu, defaults }) => {
   // Start from the platform-appropriate default template. Don't add anything
-  // by default — leave it identical to what the framework would do without
+  // by default: leave it identical to what the framework would do without
   // this file. Add your own customizations below.
   menu.useDefaults();
 
   // ───────── Examples (uncomment to use) ─────────
   //
-  // // Show the Preferences item (hidden by default — flip its visibility once you
+  // // Show the Preferences item (hidden by default, flip its visibility once you
   // // wire up your settings window):
   // menu.show(process.platform === 'darwin' ? 'main/preferences' : 'file/preferences');
   //
@@ -34,7 +34,7 @@ module.exports = ({ manager, menu, defaults }) => {
   // menu.insertAfter('main/check-for-updates', {
   //   id: 'main/account',
   //   label: 'Account...',
-  //   click: () => manager.windows.show('account'),
+  //   click: () => omega.windows.show('account'),
   // });
   //
   // // Rename an existing item:

package/dist/defaults/src/integrations/tray/index.js

@@ -1,7 +1,7 @@
 // Tray definition. Called by @omega.js/desktop during boot.
 //
-// `manager` — the running @omega.js/desktop Manager.
-// `tray`    — builder API + id-path API (find/update/remove/insertAfter/etc.).
+// `omega`: the running @omega.js/desktop main-process instance.
+// `tray`: builder API + id-path API (find/update/remove/insertAfter/etc.).
 //
 // @omega.js/desktop auto-resolves the tray icon by convention (most specific wins):
 //   1. config/icons/<platform>/tray.png   (platform-specific override)
@@ -10,16 +10,16 @@
 //   4. @omega.js/desktop bundled default
 // And auto-sets the tooltip to config.app.productName.
 //
-// Default items shipped by @omega.js/desktop (flat ids — no `tray/` prefix needed):
-//   title              — disabled label showing the app name
-//   open               — "Open <app>"
-//   check-for-updates  — wired to autoUpdater (label/enabled auto-updated)
-//   website            — opens brand.url in external browser (only if configured)
-//   quit               — quits the app
+// Default items shipped by @omega.js/desktop (flat ids, no `tray/` prefix needed):
+//   title:               disabled label showing the app name
+//   open:                "Open <app>"
+//   check-for-updates:   wired to autoUpdater (label/enabled auto-updated)
+//   website:             opens brand.url in external browser (only if configured)
+//   quit:                quits the app
 //
-// This file is OPTIONAL — delete it and @omega.js/desktop still ships a working tray.
+// This file is OPTIONAL: delete it and @omega.js/desktop still ships a working tray.
 
-module.exports = ({ manager, tray }) => {
+module.exports = ({ omega, tray }) => {
   // Use @omega.js/desktop's default template + auto-resolved icon + auto-resolved tooltip.
   tray.useDefaults();
 
@@ -36,7 +36,7 @@ module.exports = ({ manager, tray }) => {
   // tray.insertAfter('open', {
   //   id: 'dashboard',
   //   label: 'Open Dashboard',
-  //   click: () => manager.windows.show('dashboard'),
+  //   click: () => omega.windows.show('dashboard'),
   // });
   //
   // // Rename an existing item:
@@ -51,7 +51,7 @@ module.exports = ({ manager, tray }) => {
   // // Disable without removing (sets enabled:false):
   // tray.enable('quit', false);
   //
-  // // Add a submenu — items inside addressable as 'account/sign-out' etc.
+  // // Add a submenu: items inside addressable as 'account/sign-out' etc.
   // tray.insertBefore('quit', {
   //   id: 'account', label: 'Account', submenu: [
   //     { id: 'sign-out', label: 'Sign out', click: () => {} },

package/dist/defaults/src/main.js

@@ -1,16 +1,14 @@
 // Main-process entry. Config is auto-loaded from config/omega.json5 (resolved for the desktop target).
-const Manager = require('@omega.js/desktop/main');
+const omega = require('@omega.js/desktop/main');
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger, ipc, storage, windows, tray, menu, contextMenu, deepLink, autoUpdater, omega, appState, sentry, startup } = manager;
+    const { logger, ipc, storage, windows, tray, menu, contextMenu, deepLink, autoUpdater, auth, appState, sentry, startup } = omega;
 
     // ─────────────────────────────────────────────────────────────────────────────
     // 1. Create the main window
     // ─────────────────────────────────────────────────────────────────────────────
-    // Always create `main` — @omega.js/desktop uses its presence in the registry to surface UI when
+    // Always create `main`: @omega.js/desktop uses its presence in the registry to surface UI when
     // the user double-clicks the dock icon (macOS) or relaunches the app (win/linux).
     // In hidden launches (agent / menubar apps with `startup.mode = 'hidden'`, or auto-
     // launch at login), pass `show: false` so the window is registered but invisible:
@@ -45,7 +43,7 @@ manager.initialize()
     //   },
     // });
 
-    // Secondary windows — built-in defaults (800x600, hideOnClose:false) are good
+    // Secondary windows: built-in defaults (800x600, hideOnClose:false) are good
     // enough for most cases. Examples:
     //
     //   windows.create('settings');                                  // baked defaults

package/dist/defaults/src/preload.js

@@ -1,13 +1,11 @@
 // Preload entry. Exposes window.desktop to the renderer via contextBridge.
-const Manager = require('@omega.js/desktop/preload');
+const omega = require('@omega.js/desktop/preload');
 
-const manager = new Manager();
-
-manager.initialize()
+omega.initialize()
   .then(() => {
-    const { logger } = manager;
+    const { logger } = omega;
 
-    // Add any extra contextBridge-exposed APIs here. Be careful — anything you expose runs
+    // Add any extra contextBridge-exposed APIs here. Be careful: anything you expose runs
     // in the renderer's context, so don't pass through privileged Node APIs without care.
     // ...