@omega.js/desktop 0.51.0 → 0.53.0

package/dist/lib/tray.js

@@ -3,7 +3,7 @@
 // @omega.js/desktop looks for the consumer's `src/integrations/tray/index.js` and calls it with a builder API:
 //
 //   // src/integrations/tray/index.js
-//   module.exports = ({ manager, tray }) => {
+//   module.exports = ({ omega, tray }) => {
 //     tray.icon('src/assets/icons/tray-Template.png');
 //     tray.tooltip('MyApp');
 //
@@ -11,11 +11,11 @@
 //     tray.useDefaults();
 //
 //     // ...or build from scratch:
-//     tray.item({ id: 'open', label: 'Open', click: () => manager.windows.show('main') });
+//     tray.item({ id: 'open', label: 'Open', click: () => omega.windows.show('main') });
 //     tray.separator();
 //     tray.item({ id: 'quit', label: 'Quit', click: () => require('electron').app.quit() });
 //
-//     // Mutate by id (works during definition AND at runtime via `manager.tray.*`):
+//     // Mutate by id (works during definition AND at runtime via `omega.tray.*`):
 //     tray.insertAfter('open', { id: 'preferences', label: 'Preferences...', click: ... });
 //     tray.update('check-for-updates', { label: 'Updates' });
 //     tray.remove('website');
@@ -28,12 +28,12 @@
 //   tray.useDefaults()        — populate with @omega.js/desktop's default template
 //   tray.clear()              — start over
 //
-// Id-path API (during definition AND at runtime via `manager.tray.*`):
+// Id-path API (during definition AND at runtime via `omega.tray.*`):
 //   .find / .has / .update / .remove / .enable / .show / .hide /
 //   .insertBefore / .insertAfter / .appendTo
 //
 // Items support dynamic labels (function) and dynamic enabled/visible/checked.
-// Call `manager.tray.refresh()` after mutating state to re-render the menu.
+// Call `omega.tray.refresh()` after mutating state to re-render the menu.
 //
 // Default template ids (flat — no `tray/` prefix; the lib namespace is implicit):
 //   title              — disabled label showing the app name
@@ -42,7 +42,7 @@
 //   website            — opens brand.url in external browser (only if configured)
 //   quit               — quits the app
 //
-// Disabling at runtime: call `manager.tray.disable()` from anywhere in main —
+// Disabling at runtime: call `omega.tray.disable()` from anywhere in main,
 // idempotent, tears down any existing Tray + clears items. There is no config
 // flag for this; default is "enabled, looks at the conventional path."
 
@@ -56,7 +56,7 @@ const logger = new LoggerLite('tray');
 
 const tray = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
   _tray:        null,    // electron Tray instance
   _items:       [],      // raw item descriptors
   _icon:        null,    // resolved abs path
@@ -64,15 +64,15 @@ const tray = {
   _electron:    null,
   _definitionFn: null,   // consumer's exported fn (or null)
 
-  initialize(manager) {
+  initialize(omega) {
     if (tray._initialized) {
       return;
     }
 
-    tray._manager = manager;
+    tray._omega = omega;
 
     if (tray._disabled) {
-      logger.log('initialize — disabled via manager.tray.disable() called pre-init');
+      logger.log('initialize — disabled via omega.tray.disable() called pre-init');
       tray._initialized = true;
       return;
     }
@@ -87,7 +87,7 @@ const tray = {
 
     if (fs.existsSync(absPath)) {
       const loadConsumerFile = require('../utils/load-consumer-file.js');
-      const loaded = loadConsumerFile(absPath, logger);
+      const loaded = loadConsumerFile(absPath);
       if (typeof loaded === 'function') {
         tray._definitionFn = loaded;
       } else if (loaded != null) {
@@ -103,7 +103,7 @@ const tray = {
 
     if (tray._definitionFn) {
       try {
-        tray._definitionFn({ manager, tray: builder });
+        tray._definitionFn({ omega, tray: builder });
       } catch (e) {
         logger.error('tray definition fn threw:', e);
       }
@@ -116,14 +116,14 @@ const tray = {
     // back to sensible framework defaults so a consumer file is truly optional —
     // someone with no `src/integrations/tray/index.js` still gets a working tray.
     if (!tray._icon)    tray._icon    = tray._defaultIconPath();
-    if (!tray._tooltip) tray._tooltip = manager.config.app?.productName || manager.config.brand.name;
+    if (!tray._tooltip) tray._tooltip = omega.config.app?.productName || omega.config.brand.name;
 
     // Create the Tray now that items/icon/tooltip are in place.
     tray._render();
 
     // Reflect current auto-updater state into the tray check-for-updates item if present.
-    if (manager.autoUpdater._updateTrayItem) {
-      manager.autoUpdater._updateTrayItem();
+    if (omega.autoUpdater._updateTrayItem) {
+      omega.autoUpdater._updateTrayItem();
     }
 
     logger.log(`initialize — items=${tray._items.length} icon=${tray._icon || '(none)'}`);
@@ -207,9 +207,9 @@ const tray = {
 
   // Default template — id-tagged so consumers can target each item.
   _defaultTemplate() {
-    const m = tray._manager;
-    const productName = m.config.app?.productName || m.config.brand.name;
-    const brandUrl    = m.config.brand.url || null;
+    const omega = tray._omega;
+    const productName = omega.config.app?.productName || omega.config.brand.name;
+    const brandUrl    = omega.config.brand.url || null;
 
     const items = [
       { id: 'title', label: productName, enabled: false },
@@ -218,17 +218,17 @@ const tray = {
         id: 'open',
         label: `Open ${productName}`,
         click: () => {
-          m.windows.show('main');
+          omega.windows.show('main');
         },
       },
       {
         id: 'check-for-updates',
         label: 'Check for Updates...',
         click: () => {
-          if (!m || !m.autoUpdater) return;
-          const status = m.autoUpdater.getStatus();
-          if (status.code === 'downloaded') m.autoUpdater.installNow();
-          else m.autoUpdater.checkNow({ userInitiated: true });
+          if (!omega || !omega.autoUpdater) return;
+          const status = omega.autoUpdater.getStatus();
+          if (status.code === 'downloaded') omega.autoUpdater.installNow();
+          else omega.autoUpdater.checkNow({ userInitiated: true });
         },
       },
     ];
@@ -241,7 +241,7 @@ const tray = {
           const { shell } = require('electron');
           // Route through getWebsiteUrl() so dev runs open localhost:4000 instead
           // of punching out to the live brand site.
-          const safe = sanitizeURL(m.getWebsiteUrl());
+          const safe = sanitizeURL(omega.getWebsiteUrl());
           if (safe) shell.openExternal(safe);
         },
       });
@@ -349,7 +349,7 @@ const tray = {
       throw new Error('tray.define: fn must be a function');
     }
     tray._items = [];
-    fn({ manager: tray._manager, tray: tray._buildBuilder() });
+    fn({ omega: tray._omega, tray: tray._buildBuilder() });
     tray._render();
   },
 
@@ -391,7 +391,7 @@ const tray = {
   // Disable the tray entirely. Idempotent. Safe to call before OR after initialize:
   //   - Pre-init: marks the lib as disabled, initialize() short-circuits.
   //   - Post-init: tears down the live Tray + clears items.
-  // No way to re-enable after disable() — call manager.tray.define() if you want a fresh
+  // No way to re-enable after disable(): call omega.tray.define() if you want a fresh
   // tray, then it'll re-render on next refresh.
   disable() {
     tray._disabled = true;
@@ -405,7 +405,7 @@ const tray = {
   isDisabled() { return Boolean(tray._disabled); },
 };
 
-// Mix the id-path API onto the singleton so `manager.tray.update(...)` works at runtime.
+// Mix the id-path API onto the singleton so `omega.tray.update(...)` works at runtime.
 Object.assign(tray, buildIdApi({
   getItems: () => tray._items,
   render:   () => tray._render(),

package/dist/lib/usage.js

@@ -1,6 +1,6 @@
 // Usage tracking — opens (= launchCount) + hours-of-use accumulation.
 // Sister of legacy @omega.js/desktop's Usage library, but without the
-// electron-store-cwd hack (uses our manager.storage instead).
+// electron-store-cwd hack (uses our omega.storage instead).
 //
 // Persisted shape (storage.usage):
 //   {
@@ -37,17 +37,17 @@ const STORAGE_KEY = 'usage';
 
 const usage = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
   _sessionStart: null,
   _snapshot:    null,
 
-  initialize(manager) {
+  initialize(omega) {
     if (usage._initialized) return;
     usage._initialized = true;
-    usage._manager = manager;
+    usage._omega = omega;
     usage._sessionStart = Date.now();
 
-    const previous = manager.storage.get(STORAGE_KEY) || {};
+    const previous = omega.storage.get(STORAGE_KEY) || {};
     const now = new Date();
 
     // Step 2: credit prior session if it ended cleanly.
@@ -69,15 +69,15 @@ const usage = {
       lastQuitAt:   null,                                 // cleared; will be set on quit
     };
 
-    manager.storage.set(STORAGE_KEY, next);
+    omega.storage.set(STORAGE_KEY, next);
     usage._snapshot = next;
 
     // Wire the quit handler — single registration, idempotent if re-init runs.
     usage._wireQuitHandler();
 
     // IPC for renderer access to usage stats.
-    manager.ipc.unhandle('desktop:usage:get');
-    manager.ipc.handle('desktop:usage:get', () => usage.toJSON());
+    omega.ipc.unhandle('desktop:usage:get');
+    omega.ipc.handle('desktop:usage:get', () => usage.toJSON());
 
     logger.log(`usage initialized — opens=${next.opens} hoursTotal=${next.hoursTotal.toFixed(2)} installedAt=${next.installedAt}`);
   },
@@ -87,9 +87,9 @@ const usage = {
     usage._quitHandlerWired = true;
     const { app } = require('electron');
     app.on('before-quit', () => {
-      const cur = usage._manager.storage.get(STORAGE_KEY) || usage._snapshot || {};
+      const cur = usage._omega.storage.get(STORAGE_KEY) || usage._snapshot || {};
       cur.lastQuitAt = new Date().toISOString();
-      usage._manager.storage.set(STORAGE_KEY, cur);
+      usage._omega.storage.set(STORAGE_KEY, cur);
     });
   },
 
@@ -129,7 +129,7 @@ const usage = {
   // Test teardown.
   shutdown() {
     usage._initialized = false;
-    usage._manager     = null;
+    usage._omega       = null;
     usage._sessionStart = null;
     usage._snapshot    = null;
     // Note: we don't unwire `app.on('before-quit')` — Electron has no listener

package/dist/lib/window-manager.js

@@ -1,8 +1,8 @@
 // Window manager — named-window registry over BrowserWindow.
 //
 // **Lazy creation.** @omega.js/desktop does NOT auto-create any windows. Consumers call
-// `manager.windows.create('main', opts?)` from their main.js when they want UI
-// to surface — typically right after `manager.initialize()` resolves, but may
+// `omega.windows.create('main', opts?)` from their main.js when they want UI
+// to surface — typically right after `omega.initialize()` resolves, but may
 // be deferred (e.g. agent apps that only show UI when the user clicks the tray).
 //
 // Defaults baked in (no JSON config required):
@@ -10,8 +10,8 @@
 //   any other → { width: 800,  height: 600, hideOnClose: false, view: name   }
 //
 // Override at the call site:
-//   manager.windows.create('main',     { width: 1280, height: 800 });
-//   manager.windows.create('settings', { width: 600,  height: 480 });
+//   omega.windows.create('main',     { width: 1280, height: 800 });
+//   omega.windows.create('settings', { width: 600,  height: 480 });
 //
 // `view` resolves to `<projectRoot>/dist/views/<view>/index.html`.
 //
@@ -37,13 +37,13 @@ const SAVE_DEBOUNCE_MS = 250;
 
 const windowManager = {
   _initialized: false,
-  _manager:     null,
+  _omega:       null,
   _windows:     {}, // name -> BrowserWindow
   _saveTimers:  {}, // name -> debounce timer
   _electron:    null,
 
-  initialize(manager) {
-    windowManager._manager = manager;
+  initialize(omega) {
+    windowManager._omega = omega;
     windowManager._initialized = true;
 
     windowManager._electron = require('electron');
@@ -83,15 +83,15 @@ const windowManager = {
   // can configure entirely from main.js without touching JSON. Falls through to
   // createNamed which does the heavy lifting.
   async create(name, overrides) {
-    return windowManager.createNamed(name, windowManager._manager, overrides);
+    return windowManager.createNamed(name, windowManager._omega, overrides);
   },
 
   // Create or focus a named window. Args:
   //   name      — registry key + default view name + storage key for bounds.
-  //   manager   — Manager instance (defaults to the one passed to initialize()).
+  //   omega     : the omega instance (defaults to the one passed to initialize()).
   //   overrides — optional opts that take precedence over config.windows.<name>.
-  async createNamed(name, manager, overrides) {
-    manager = manager || windowManager._manager;
+  async createNamed(name, omega, overrides) {
+    omega = omega || windowManager._omega;
     overrides = overrides || {};
 
     // Single-instance dedup
@@ -119,7 +119,7 @@ const windowManager = {
     const defaults = isMain
       ? { width: 1024, height: 720, view: 'main', hideOnClose: true }
       : { width: 800,  height: 600, view: name,   hideOnClose: false };
-    const jsonConfig = manager.config.windows?.[name] || {};
+    const jsonConfig = omega.config.windows?.[name] || {};
     const config = { ...defaults, ...jsonConfig, ...overrides };
 
     logger.log(`createNamed: building "${name}" (show=${config.show !== false}, hideOnClose=${config.hideOnClose})`);
@@ -141,7 +141,7 @@ const windowManager = {
     };
     if (typeof config.x === 'number') defaultBounds.x = config.x;
     if (typeof config.y === 'number') defaultBounds.y = config.y;
-    const savedBounds = persistBounds ? windowManager._loadBounds(name, manager) : null;
+    const savedBounds = persistBounds ? windowManager._loadBounds(name, omega) : null;
     const bounds = savedBounds
       ? windowManager._clampToDisplays(savedBounds)
       : defaultBounds;
@@ -190,7 +190,7 @@ const windowManager = {
       show: false, // flicker prevention — show on ready-to-show
       // Tray-only apps suppress all taskbar/dock representation for their windows.
       skipTaskbar,
-      title: config.title || manager.config.app?.productName || name,
+      title: config.title || omega.config.app?.productName || name,
       backgroundColor: config.backgroundColor || '#ffffff',
       ...titleBarOpts,
       webPreferences: {
@@ -218,7 +218,7 @@ const windowManager = {
     }
 
     // Attach the context-menu listener so right-click works in this window.
-    manager.contextMenu.attach(win.webContents);
+    omega.contextMenu.attach(win.webContents);
 
     // ALL event listeners must attach BEFORE `await loadFile()` below — otherwise the
     // window can be in the registry but missing close/resize/etc. listeners during the
@@ -265,9 +265,9 @@ const windowManager = {
     // Consumers override per-window via config.windows.<name>.hideOnClose.
     //
     // Three escape hatches let a close-event ACTUALLY close:
-    //   1. `manager._allowQuit` — set by manager.quit({ force: true }) and by the
+    //   1. `omega._allowQuit` — set by omega.quit({ force: true }) and by the
     //      auto-updater before installNow().
-    //   2. `manager._isQuitting` — set by app.on('before-quit'), so any quit path
+    //   2. `omega._isQuitting` — set by app.on('before-quit'), so any quit path
     //      Electron knows about (Cmd+Q, role:'quit' menu, app.quit() programmatic,
     //      OS shutdown) flows through naturally.
     //   3. `win._emForceClose` — per-window override for one-off "close this for
@@ -275,8 +275,8 @@ const windowManager = {
     const hideOnClose = config.hideOnClose === true;
 
     win.on('close', (event) => {
-      const allowQuit  = manager._allowQuit  === true;
-      const isQuitting = manager._isQuitting === true;
+      const allowQuit  = omega._allowQuit  === true;
+      const isQuitting = omega._isQuitting === true;
       const force      = win._emForceClose === true;
 
       if (hideOnClose && !allowQuit && !isQuitting && !force) {
@@ -332,7 +332,7 @@ const windowManager = {
     const win = windowManager._windows[name];
     if (!win || win.isDestroyed()) return;
 
-    const storage = windowManager._manager.storage;
+    const storage = windowManager._omega.storage;
 
     // Use getNormalBounds when maximized/fullscreen so we restore to the underlying size on next launch.
     const isMaximized  = win.isMaximized();
@@ -353,8 +353,8 @@ const windowManager = {
     storage.set(`windows.${name}.bounds`, bounds);
   },
 
-  _loadBounds(name, manager) {
-    const storage = (manager || windowManager._manager).storage;
+  _loadBounds(name, omega) {
+    const storage = (omega || windowManager._omega).storage;
 
     const saved = storage.get(`windows.${name}.bounds`);
     if (!saved || typeof saved !== 'object') return null;
@@ -431,7 +431,7 @@ const windowManager = {
   // focus app-wide) is suppressed separately — main.js flips the app to the
   // accessory activation policy under the same predicate.
   _isStealth() {
-    return require('../utils/test-stealth.js')(windowManager._manager);
+    return require('../utils/test-stealth.js')(windowManager._omega);
   },
 
   // Surface a window: normal show (+ dock) — or stealth-show in Testing mode.
@@ -470,9 +470,9 @@ const windowManager = {
   // alone. No-op off macOS. Wired to every named window's 'hide' event.
   _maybeRehideDock() {
     if (process.platform !== 'darwin') return;
-    const manager = windowManager._manager;
-    if (manager.startup.getMode() !== 'hidden') return;
-    if (manager._isQuitting === true) return;
+    const omega = windowManager._omega;
+    if (omega.startup.getMode() !== 'hidden') return;
+    if (omega._isQuitting === true) return;
 
     const anyVisible = Object.values(windowManager._windows)
       .some((win) => !win.isDestroyed() && win.isVisible());