@omega.js/desktop 0.52.0 → 0.54.0

package/dist/assets/themes/newsflash/js/pages/test/libraries/layers/index.js

@@ -1,6 +1,6 @@
 // /test — Theme (newsflash) page JS — the #theme layer.
 // Runs AFTER #main, BEFORE #project. Turns the "js-theme" dot green.
-export default ({ manager, options }) => {
+export default ({ omega, options }) => {
   const dot = document.querySelector('.layer-dot[data-layer="js-theme"]');
   if (dot) {
     dot.style.background = '#30a46c'; // green

package/dist/build.js

@@ -1,96 +1,71 @@
+// The build-time module: one plain object of functions every gulp task, verb
+// and consumer hook reads (`const build = require('@omega.js/desktop/build')`).
+// No class and no `new`, the shape @omega.js/web's and @omega.js/extension's
+// build modules share.
+
 // Libraries
 const path = require('path');
 const jetpack = require('fs-jetpack');
 const { setEnvironment, buildLaneEnvironment } = require('./vendor/config/environment.js');
 const fs = require('fs');
 const JSON5 = require('json5');
-const { force, execute } = require('node-powertools');
+const { force } = require('node-powertools');
 const { parseArgv } = require('./vendor/devkit/argv.js');
+const { getEnvironment, isDevelopment, isProduction, isTesting, getVersion } = require('./utils/mode-helpers.js');
 
-// Class
-function Manager() {
-  const self = this;
-
-  // Properties
-  self._logger = null;
-
-  // Return
-  return self;
+// Logger: a named build logger
+function logger(name) {
+  return new (require('./vendor/devkit/logger.js'))(name);
 }
 
-// Initialize (build-time hook)
-Manager.prototype.initialize = function () {
-  console.log('initialize:');
-};
-
-// Logger
-Manager.prototype.logger = function (name) {
-  // Static-style call
-  if (!(this instanceof Manager)) {
-    return new (require('./lib/logger'))(name);
-  }
-
-  // Cache one logger per Manager instance
-  if (!this._logger) {
-    this._logger = new (require('./lib/logger'))(name);
-  }
-
-  return this._logger;
-};
-
 // argv: the gulp lane's own parse. It is spawned with the TASK NAME alone
 // (`npm run gulp -- build`), so `debug` is the one flag it declares.
-Manager.getArguments = function () {
+function getArguments() {
   const options = parseArgv(process.argv.slice(2), { booleans: ['debug'] });
 
   options.debug = force(options.debug === undefined ? false : options.debug, 'boolean');
 
   return options;
-};
-Manager.prototype.getArguments = Manager.getArguments;
+}
 
-// Report build errors with notification (parity with BXM)
-Manager.reportBuildError = function (error, callback) {
-  const logger = new (require('./lib/logger'))('build-error');
+// Report build errors with notification (parity with @omega.js/extension)
+function reportBuildError(error, callback) {
+  const log = logger('build-error');
   const errorMessage = error.message || error.toString() || 'Unknown error';
   const errorPlugin = error.plugin || 'Build';
 
-  logger.error(`[${errorPlugin}] ${errorMessage}`);
+  log.error(`[${errorPlugin}] ${errorMessage}`);
 
   if (callback) {
     return callback(error);
   }
 
   return (cb) => cb ? cb(error) : error;
-};
-Manager.prototype.reportBuildError = Manager.reportBuildError;
+}
 
 // Mode flags
-Manager.isBuildMode = function () {
+function isBuildMode() {
   return process.env.OMEGA_BUILD_MODE === 'true';
-};
-Manager.prototype.isBuildMode = Manager.isBuildMode;
+}
 
-Manager.isPublishMode = function () {
+function isPublishMode() {
   return process.env.OMEGA_IS_PUBLISH === 'true';
-};
-Manager.prototype.isPublishMode = Manager.isPublishMode;
+}
 
-Manager.isServerMode = function () {
+function isServerMode() {
   return process.env.OMEGA_IS_SERVER === 'true';
-};
-Manager.prototype.isServerMode = Manager.isServerMode;
+}
 
-Manager.actLikeProduction = function () {
-  return Boolean(Manager.isBuildMode() || process.env.OMEGA_AUDIT_FORCE === 'true');
-};
-Manager.prototype.actLikeProduction = Manager.actLikeProduction;
+function actLikeProduction() {
+  return Boolean(isBuildMode() || process.env.OMEGA_AUDIT_FORCE === 'true');
+}
 
 // The environment is the ONE module's (@omega.js/config's environment.js,
 // [#817](https://github.com/Omega-JS-Stack/omega/issues/817)), reachable from
-// all four @omega.js/desktop Manager entry points (main / renderer / preload /
-// build) through the mode-helpers attachTo() call at the bottom of each, so
-// every context resolves it identically. It reads ONE input and never guesses.
+// all four @omega.js/desktop entry points (the main / renderer / preload `Omega`
+// classes and this build module) through the same plain functions in
+// utils/mode-helpers.js, so every context resolves it identically. It reads ONE
+// input and never guesses.
 //
 // THIS FILE IS THE NODE LANE'S ONE SETTER, and it runs at load, before any
 // gulp task, verb or getConfig() asks. Two rules, no sniffing:
@@ -108,19 +83,18 @@ Manager.prototype.actLikeProduction = Manager.actLikeProduction;
 // The electron app this lane spawns inherits the variable; a PACKAGED app has
 // no parent env, so main.js sets it from the baked config instead (the same
 // word, written into the artifact by the bundle task).
-setEnvironment(buildLaneEnvironment(Manager.isBuildMode()));
+setEnvironment(buildLaneEnvironment(isBuildMode()));
 
-Manager.getMode = function () {
+function getMode() {
   return {
-    build:   Manager.isBuildMode(),
-    publish: Manager.isPublishMode(),
-    server:  Manager.isServerMode(),
-    environment: Manager.getEnvironment(),
+    build:   isBuildMode(),
+    publish: isPublishMode(),
+    server:  isServerMode(),
+    environment: getEnvironment(),
   };
-};
-Manager.prototype.getMode = Manager.getMode;
+}
 
-// Config — the consumer's config/omega.json5 resolved for the desktop target via
+// Config: the consumer's config/omega.json5 resolved for the desktop target via
 // @omega.js/config: shared sections (brand, cloud, analytics, payment, monitoring,
 // theme) at the top level, targets.desktop overlaid onto them (so app/platforms/startup/
 // releases/... land at the top level here), and in a brand monorepo the brand root's
@@ -136,7 +110,7 @@ Manager.prototype.getMode = Manager.getMode;
 //   app.productName ← brand.name if not set
 // These keep the consumer's config minimal: setting `brand: { id: 'foo', name: 'Foo',
 // url: 'https://foo.com' }` is enough; appId/productName flow through automatically.
-Manager.getConfig = function () {
+function getConfig() {
   const { hasOmegaConfig, loadConfig, composeBundleId, deriveBundleIdPrefix } = require('./vendor/config/index.js');
 
   // WHICH environment overlay composes
@@ -147,7 +121,7 @@ Manager.getConfig = function () {
   // every other read in the process answers from, so the overlay that composes
   // and the environment the artifact records can never be two different words.
   // Same rule, same shape, in @omega.js/extension's getConfig.
-  const environment = Manager.getEnvironment();
+  const environment = getEnvironment();
 
   // No config at all (fresh dir, non-consumer cwd) → seeded empty shape below; the
   // schema validation in audit/boot reports what's actually missing.
@@ -184,11 +158,10 @@ Manager.getConfig = function () {
   if (!config.app.productName && config.brand.name) config.app.productName = config.brand.name;
 
   return config;
-};
-Manager.prototype.getConfig = Manager.getConfig;
+}
 
 // package.json
-Manager.getPackage = function (type) {
+function getPackage(type) {
   const basePath = type === 'project'
     ? process.cwd()
     : path.resolve(__dirname, '..');
@@ -201,35 +174,31 @@ Manager.getPackage = function (type) {
   }
 
   return JSON5.parse(raw);
-};
-Manager.prototype.getPackage = Manager.getPackage;
+}
 
 // Root path
-Manager.getRootPath = function (type) {
+function getRootPath(type) {
   return type === 'project'
     ? process.cwd()
     : path.resolve(__dirname, '..');
-};
-Manager.prototype.getRootPath = Manager.getRootPath;
+}
 
 // Live reload port
-Manager.getLiveReloadPort = function () {
+function getLiveReloadPort() {
   process.env.OMEGA_LIVERELOAD_PORT = process.env.OMEGA_LIVERELOAD_PORT || 35729;
   return parseInt(process.env.OMEGA_LIVERELOAD_PORT, 10);
-};
-Manager.prototype.getLiveReloadPort = Manager.getLiveReloadPort;
+}
 
 // Windows signing strategy. Config-only: `platforms.windows.signing.strategy`
 // (targets.desktop.platforms.windows in the raw omega.json5). Default 'self-hosted'.
-Manager.getWindowsSignStrategy = function () {
-  const config = Manager.getConfig();
+function getWindowsSignStrategy() {
+  const config = getConfig();
   return config?.platforms?.windows?.signing?.strategy || 'self-hosted';
-};
-Manager.prototype.getWindowsSignStrategy = Manager.getWindowsSignStrategy;
+}
 
 // Touch files to trigger a rebuild watcher
-Manager.triggerRebuild = function (files, logger) {
-  logger = this?._logger || logger || console;
+function triggerRebuild(files, log) {
+  log = log || console;
 
   if (typeof files === 'string') {
     files = [files];
@@ -238,7 +207,7 @@ Manager.triggerRebuild = function (files, logger) {
   } else if (typeof files === 'object' && files !== null) {
     files = Object.keys(files);
   } else {
-    logger.error('Invalid files for triggerRebuild()');
+    log.error('Invalid files for triggerRebuild()');
     return;
   }
 
@@ -247,24 +216,15 @@ Manager.triggerRebuild = function (files, logger) {
   files.forEach((file) => {
     try {
       fs.utimesSync(file, now, now);
-      logger.log(`Triggered build: ${file}`);
+      log.log(`Triggered build: ${file}`);
     } catch (e) {
-      logger.error(`Failed to trigger build ${file}`, e);
+      log.error(`Failed to trigger build ${file}`, e);
     }
   });
-};
-Manager.prototype.triggerRebuild = Manager.triggerRebuild;
-
-// Generic require passthrough (lets gulp tasks dynamically load lib modules).
-// Only ever called from gulp tasks (release / package / bundle), which run
-// un-bundled — so plain require is fine.
-Manager.require = function (p) {
-  return require(p);
-};
-Manager.prototype.require = Manager.require;
+}
 
 // Memory usage
-Manager.getMemoryUsage = function () {
+function getMemoryUsage() {
   const used = process.memoryUsage();
   return {
     rss:       Math.round(used.rss / 1024 / 1024),
@@ -272,19 +232,35 @@ Manager.getMemoryUsage = function () {
     heapUsed:  Math.round(used.heapUsed / 1024 / 1024),
     external:  Math.round(used.external / 1024 / 1024),
   };
-};
-Manager.prototype.getMemoryUsage = Manager.getMemoryUsage;
-
-Manager.logMemory = function (logger, label) {
-  const mem = Manager.getMemoryUsage();
-  logger.log(`[Memory ${label}] RSS: ${mem.rss}MB | Heap Used: ${mem.heapUsed}MB / ${mem.heapTotal}MB | External: ${mem.external}MB`);
-};
-Manager.prototype.logMemory = Manager.logMemory;
+}
 
-// Mix in shared cross-context helpers — same code path used in main, renderer, preload.
-// All four contexts share the exact same implementation.
-require('./utils/mode-helpers.js').attachTo(Manager);
-require('./utils/url-helpers.js').attachTo(Manager);
+function logMemory(log, label) {
+  const mem = getMemoryUsage();
+  log.log(`[Memory ${label}] RSS: ${mem.rss}MB | Heap Used: ${mem.heapUsed}MB / ${mem.heapTotal}MB | External: ${mem.external}MB`);
+}
 
-// Export
-module.exports = Manager;
+// Export: the environment four + getVersion() come from the same plain
+// functions the runtime `Omega` classes call
+module.exports = {
+  logger,
+  getArguments,
+  reportBuildError,
+  isBuildMode,
+  isPublishMode,
+  isServerMode,
+  actLikeProduction,
+  getMode,
+  getConfig,
+  getPackage,
+  getRootPath,
+  getLiveReloadPort,
+  getWindowsSignStrategy,
+  triggerRebuild,
+  getMemoryUsage,
+  logMemory,
+  getEnvironment,
+  isDevelopment,
+  isProduction,
+  isTesting,
+  getVersion,
+};

package/dist/cli-run.js

@@ -9,7 +9,7 @@
 const BOOLEAN_FLAGS = [
   'extended', 'local', 'quick', 'q', 'direct', 'dry-run', 'secrets',
   'smoke', 'verify-only', 'find-window-id', 'publish', 'open', 'tail', 'f', 'strict',
-  'apply', 'major', 'force-fresh',
+  'major', 'force-fresh',
 ];
 
 async function run() {
@@ -39,3 +39,6 @@ async function run() {
 }
 
 module.exports = { run, BOOLEAN_FLAGS };
+
+// Runnable as a file: the package's own `npm test` calls it directly, never through the dispatcher
+if (require.main === module) run();

package/dist/cli.js

@@ -19,7 +19,7 @@ const { isBoxVerbArgv } = require('./vendor/devkit/omega-bin.js');
 // reading of it, covering the bare verb and its `--` flag spelling alike.
 if (!isBoxVerbArgv(process.argv.slice(2))) {
   require('./utils/load-env.js').loadDesktopEnv(process.cwd(), {
-    logger: new (require('./lib/logger.js'))('env'),
+    logger: new (require('./vendor/devkit/logger.js'))('env'),
   });
 }
 
@@ -36,14 +36,14 @@ module.exports = createCliRouter({
   defaultCommand: 'help',
   aliases: {
     clean:            ['-c', '--clean'],
-    install:          ['-i', 'i', '--install'],
+    dev:              ['serve', 'start', '--dev'],
     version:          ['-v', '--version'],
     build:            ['-b', '--build'],
     deploy:           ['-d', '--deploy'],
     publish:          ['-p', '--publish'],
     release:          ['-r', '--release'],
     test:             ['-t', '--test'],
-    update:           ['-u', '--update', 'outdated', 'out'],
+    update:           ['-u', '--update'],
     logs:             ['--logs', 'log'],
     'validate-certs': ['certs', '--validate-certs'],
     'sign-windows':   ['--sign-windows'],

package/dist/commands/build.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('build');
+const build = require('../build.js');
+const logger = build.logger('build');
 const { runPipeline } = require('../utils/build-pipeline.js');
 const { ensureTarget } = require('./lib/ensure-target.js');
 

package/dist/commands/cdp/capture.js

@@ -21,7 +21,7 @@
 const { execFileSync } = require('child_process');
 const client = require('./client');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const SRGB_PROFILE = '/System/Library/ColorSync/Profiles/sRGB Profile.icc';
 
@@ -65,7 +65,7 @@ module.exports = async function (options) {
     throw new Error('mgr cdp capture is macOS-only (screencapture/sips/osascript)');
   }
 
-  const names = client.appNames(Manager.getConfig());
+  const names = client.appNames(build.getConfig());
 
   if (options['find-window-id'] || options.findWindowId) {
     console.log(findWindowIds(names) || `no windows found (tried: ${names.join(', ')})`);

package/dist/commands/cdp/client.js

@@ -7,7 +7,7 @@
 // matcher instead of a "selected page"; the main window's document is always
 // at `dist/views/main/` (the MAIN_VIEW default matcher).
 //
-// See docs/cdp-debugging.md for the full toolkit reference.
+// See docs/desktop/cdp-debugging.md for the full toolkit reference.
 
 // The main window's view path — @omega.js/desktop's templating convention, so it holds for
 // every consumer. Subcommands that need "the app's main renderer" (status,

package/dist/commands/cdp/quit.js

@@ -9,7 +9,7 @@
 const { execFileSync } = require('child_process');
 const client = require('./client');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
@@ -77,7 +77,7 @@ async function quitAndDrain(names) {
 }
 
 module.exports = async function (options) {
-  const wasRunning = await quitAndDrain(client.appNames(Manager.getConfig()));
+  const wasRunning = await quitAndDrain(client.appNames(build.getConfig()));
   console.log(wasRunning ? 'quit running app' : 'app was not running');
 };
 

package/dist/commands/cdp/relaunch.js

@@ -17,7 +17,7 @@ const { spawn } = require('child_process');
 const client = require('./client');
 const { quitAndDrain } = require('./quit');
 
-const Manager = new (require('../../build.js'))();
+const build = require('../../build.js');
 
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
@@ -42,7 +42,7 @@ async function waitForBoot(matcher) {
 }
 
 module.exports = async function (options) {
-  const config = Manager.getConfig();
+  const config = build.getConfig();
 
   const wasRunning = await quitAndDrain(client.appNames(config));
   console.log(wasRunning ? 'quit running app' : 'app was not running');

package/dist/commands/cdp/theme.js

@@ -1,5 +1,5 @@
 // `npx omega cdp theme <dark|light|system>` — flip the app's theme live
-// (manager.theme via the main window's renderer).
+// (omega.theme via the main window's renderer).
 //
 // Flips every renderer (BrowserWindows AND WebContentsViews) with no restart —
 // nativeTheme.themeSource → prefers-color-scheme → the preload applier

package/dist/commands/cdp.js

@@ -16,7 +16,7 @@
 // MANGLES quoted eval expressions (cross-env strips inner quotes), so a
 // pinned-port script must pass the port as a flag instead. Targets are
 // matched by URL substring (the main window is always `/views/main/`).
-// Full reference: docs/cdp-debugging.md.
+// Full reference: docs/desktop/cdp-debugging.md.
 
 const path = require('path');
 

package/dist/commands/clean.js

@@ -1,6 +1,6 @@
 // Libraries
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('clean');
+const build = require('../build.js');
+const logger = build.logger('clean');
 const { cleanDirs } = require('../vendor/devkit/clean-dirs.js');
 const { ensureTarget } = require('./lib/ensure-target.js');
 
@@ -13,9 +13,8 @@ const dirs = [
 ];
 
 module.exports = async function (options) {
-  // The local scaffold (#675): the consumer `start` script is
-  // `omega clean && npm run gulp --`, and gulp itself is one of the peer
-  // deps the ensure installs — clean is the only verb that runs before it.
+  // The local scaffold: dev, build and package clean before gulp runs,
+  // and gulp itself is one of the peer deps the ensure installs.
   await ensureTarget({ log: (line) => logger.log(line), warn: (line) => logger.warn(line) });
 
   // Quick mode used to keep `dist/` so "the next gulp run is incremental" —

package/dist/commands/deploy.js

@@ -18,8 +18,8 @@
  * most; a linked brand now packs its frameworks into the snapshot instead.
  */
 const path = require('node:path');
-const Manager = new (require('../build.js'));
-const logger = Manager.logger('deploy');
+const build = require('../build.js');
+const logger = build.logger('deploy');
 const attachLogFile = require('../utils/attach-log-file.js');
 const { assertBrandVersion } = require('../vendor/devkit/brand-version.js');
 const { targetNameFromDir } = require('../vendor/config/index.js');
@@ -62,9 +62,9 @@ module.exports = async function (options) {
   if (dryRun) {
     logger.log('DRY RUN, skipping hook "deploy/pre"');
   } else {
-    // The one ctx shape every OMEGA hook takes, `{ manager, projectRoot, mode }`,
+    // The one ctx shape every OMEGA hook takes, `{ build, projectRoot, mode }`,
     // and a deploy's mode is PRODUCTION: what it is about to publish is a release.
-    await runConsumerHook('deploy/pre', { manager: Manager, projectRoot: projectDir, mode: 'production' });
+    await runConsumerHook('deploy/pre', { build, projectRoot: projectDir, mode: 'production' });
   }
 
   // The direct lane: build + sign + publish from THIS machine, for this

package/dist/commands/dev.js

@@ -0,0 +1,25 @@
+// Libraries
+const build = require('../build.js');
+const logger = build.logger('dev');
+const { runPipeline } = require('../utils/build-pipeline.js');
+
+// The local dev loop the target's `start` script runs: clean (which runs the
+// local scaffold), then the gulp default task, build then launch electron. The
+// `--` flags it was given ride to the gulp lane (`--debug`, `--remote-debugging-port=<n>`).
+function plan(options, argv = process.argv.slice(2)) {
+  return {
+    env: {},
+    steps: [
+      { type: 'clean' },
+      { type: 'gulp', task: 'default', args: argv.filter((arg) => arg.startsWith('--')) },
+    ],
+  };
+}
+
+module.exports = async function (options) {
+  logger.log('Starting the dev loop...');
+
+  await runPipeline(plan(options), options);
+};
+
+module.exports.plan = plan;

package/dist/commands/finalize-release.js

@@ -27,9 +27,9 @@ const jetpack = require('fs-jetpack');
 
 const { getOctokit } = require('../utils/github.js');
 const { releasesRepo } = require('../vendor/config/index.js');
-const Manager = new (require('../build.js'));
+const build = require('../build.js');
 
-const logger = Manager.logger('finalize-release');
+const logger = build.logger('finalize-release');
 
 module.exports = async function finalizeRelease(options = {}) {
   const argv = options._ || [];
@@ -42,8 +42,8 @@ module.exports = async function finalizeRelease(options = {}) {
   }
 
   const projectRoot = process.cwd();
-  const config      = Manager.getConfig() || {};
-  const pkgVersion  = (Manager.getPackage('project') || {}).version;
+  const config      = build.getConfig() || {};
+  const pkgVersion  = (build.getPackage('project') || {}).version;
 
   if (!pkgVersion) {
     throw new Error('finalize-release: package.json version not found');

package/dist/commands/launch.js

@@ -31,8 +31,8 @@ const fs       = require('fs');
 const jetpack  = require('fs-jetpack');
 const { spawn } = require('child_process');
 
-const Manager = new (require('../build.js'));
-const logger  = Manager.logger('launch');
+const build = require('../build.js');
+const logger  = build.logger('launch');
 
 module.exports = async function (options) {
   options = options || {};

package/dist/commands/lib/deploy-precheck.js

@@ -22,14 +22,14 @@
  * The RUNNER is `@omega.js/devkit/deploy-precheck` (one copy for every
  * framework); this file is desktop's STEPS.
  */
-const Manager = new (require('../../build.js'));
+const build = require('../../build.js');
 const { runDeployPrecheck } = require('../../vendor/devkit/deploy-precheck.js');
 const { releasesRepo } = require('../../vendor/config/index.js');
 const { publishTargetSecrets } = require('../../vendor/devkit/target-secrets.js');
 const { resolveToken } = require('../../vendor/devkit/deploy.js');
 const { updateManager } = require('./dependencies.js');
 
-const package = Manager.getPackage('main');
+const package = build.getPackage('main');
 
 /**
  * Auto-provision the brand's ONE public releases repo, addressed by
@@ -57,7 +57,7 @@ const package = Manager.getPackage('main');
 async function provisionReleaseRepos({ log, warn, config, execFn, dryRun }) {
   const { ensureRepo } = require('../../vendor/devkit/github-repo.js');
 
-  const resolved = config || Manager.getConfig() || {};
+  const resolved = config || build.getConfig() || {};
   if (resolved.releases?.enabled === false) return;
 
   const releases = releasesRepo(resolved);