@atom-js-org/electron 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,31 @@
+AtomJS Attribution License 1.0
+
+Copyright (c) 2026 AtomJS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the
+Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+1. Framework redistributions, forks, and modified framework distributions must
+   retain this license, the NOTICE file, and a reasonably visible attribution
+   that includes both the name "AtomJS" and the project link:
+   https://github.com/Atom-js-org/atom
+
+2. The attribution requirement applies to distributions of the AtomJS
+   framework itself or a derivative framework. It does not require applications
+   created with AtomJS to display AtomJS branding, notices, splash screens, or
+   user-interface credit.
+
+3. The names and logos of AtomJS may not be used to imply endorsement of a
+   modified distribution without prior permission. Forks may accurately state
+   that they are based on AtomJS.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# @atom-js-org/electron
+
+Electron-compatible imports for AtomJS. This package does **not** contain the Electron runtime and does not bundle Chromium.
+
+Install it under the local package name `electron`:
+
+```bash
+npm install electron@npm:@atom-js-org/electron@alpha
+npm install --save-dev @atom-js-org/cli@alpha
+```
+
+Existing code can continue to use:
+
+```js
+const { app, BrowserWindow } = require('electron');
+```
+
+Project: https://github.com/Atom-js-org/atom

package/index.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+const atom = require('@atom-js-org/runtime');
+
+installElectronProcessMarkers();
+
+function rendererOnlyApi(name) {
+  const fail = () => {
+    throw new Error(`${name} is a renderer-process Electron API. Use it from an AtomJS preload script.`);
+  };
+  return new Proxy({}, {
+    get(_target, property) {
+      if (property === Symbol.toStringTag) return name;
+      if (property === 'then') return undefined;
+      return fail;
+    }
+  });
+}
+
+function installElectronProcessMarkers() {
+  defineIfMissing(process.versions, 'atomjs', atom.app && atom.app.getVersion ? atom.app.getVersion() : '0.2.0');
+  // Presence of process.versions.electron is used by many Electron-oriented
+  // packages as a runtime capability check. This is an AtomJS compatibility
+  // version, not the version of the real Electron runtime.
+  defineIfMissing(process.versions, 'electron', '0.2.0-atomjs.0');
+  defineIfMissing(process, 'type', 'browser');
+  defineIfMissing(process, 'defaultApp', true);
+  defineIfMissing(process, 'resourcesPath', process.cwd());
+}
+
+function defineIfMissing(target, key, value) {
+  if (target[key] !== undefined) return;
+  try {
+    Object.defineProperty(target, key, {
+      configurable: true,
+      enumerable: true,
+      writable: false,
+      value
+    });
+  } catch {}
+}
+
+exports.app = atom.app;
+exports.BaseWindow = atom.BaseWindow;
+exports.BrowserWindow = atom.BrowserWindow;
+exports.BrowserView = atom.BrowserView;
+exports.WebContentsView = atom.WebContentsView;
+exports.View = atom.View;
+exports.ImageView = atom.ImageView;
+exports.Menu = atom.Menu;
+exports.MenuItem = atom.MenuItem;
+exports.Tray = atom.Tray;
+exports.Notification = atom.Notification;
+exports.TouchBar = atom.TouchBar;
+exports.MessageChannelMain = atom.MessageChannelMain;
+exports.MessagePortMain = atom.MessagePortMain;
+exports.ipcMain = atom.ipcMain;
+exports.ipcRenderer = rendererOnlyApi('ipcRenderer');
+exports.contextBridge = rendererOnlyApi('contextBridge');
+exports.webFrame = rendererOnlyApi('webFrame');
+exports.dialog = atom.dialog;
+exports.shell = atom.shell;
+exports.clipboard = atom.clipboard;
+exports.nativeTheme = atom.nativeTheme;
+exports.nativeImage = atom.nativeImage;
+exports.session = atom.session;
+exports.protocol = atom.protocol;
+exports.net = atom.net;
+exports.screen = atom.screen;
+exports.webContents = atom.webContents;
+exports.globalShortcut = atom.globalShortcut;
+exports.powerSaveBlocker = atom.powerSaveBlocker;
+exports.powerMonitor = atom.powerMonitor;
+exports.systemPreferences = atom.systemPreferences;
+exports.safeStorage = atom.safeStorage;
+exports.desktopCapturer = atom.desktopCapturer;
+exports.crashReporter = atom.crashReporter;
+exports.autoUpdater = atom.autoUpdater;
+exports.contentTracing = atom.contentTracing;
+exports.netLog = atom.netLog;
+exports.utilityProcess = atom.utilityProcess;
+exports.pushNotifications = atom.pushNotifications;
+exports.inAppPurchase = atom.inAppPurchase;
+exports.parentPort = atom.parentPort;
+exports.default = exports;

package/index.d.ts

@@ -0,0 +1,6 @@
+export * from "@atom-js-org/runtime";
+export const ipcRenderer: any;
+export const contextBridge: any;
+export const webFrame: any;
+declare const electron: Record<string, any>;
+export default electron;

package/index.mjs

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const electron = require('./index.cjs');
+
+export const app = electron.app;
+export const BaseWindow = electron.BaseWindow;
+export const BrowserWindow = electron.BrowserWindow;
+export const BrowserView = electron.BrowserView;
+export const WebContentsView = electron.WebContentsView;
+export const View = electron.View;
+export const ImageView = electron.ImageView;
+export const Menu = electron.Menu;
+export const MenuItem = electron.MenuItem;
+export const Tray = electron.Tray;
+export const Notification = electron.Notification;
+export const TouchBar = electron.TouchBar;
+export const MessageChannelMain = electron.MessageChannelMain;
+export const MessagePortMain = electron.MessagePortMain;
+export const ipcMain = electron.ipcMain;
+export const ipcRenderer = electron.ipcRenderer;
+export const contextBridge = electron.contextBridge;
+export const webFrame = electron.webFrame;
+export const dialog = electron.dialog;
+export const shell = electron.shell;
+export const clipboard = electron.clipboard;
+export const nativeTheme = electron.nativeTheme;
+export const nativeImage = electron.nativeImage;
+export const session = electron.session;
+export const protocol = electron.protocol;
+export const net = electron.net;
+export const screen = electron.screen;
+export const webContents = electron.webContents;
+export const globalShortcut = electron.globalShortcut;
+export const powerSaveBlocker = electron.powerSaveBlocker;
+export const powerMonitor = electron.powerMonitor;
+export const systemPreferences = electron.systemPreferences;
+export const safeStorage = electron.safeStorage;
+export const desktopCapturer = electron.desktopCapturer;
+export const crashReporter = electron.crashReporter;
+export const autoUpdater = electron.autoUpdater;
+export const contentTracing = electron.contentTracing;
+export const netLog = electron.netLog;
+export const utilityProcess = electron.utilityProcess;
+export const pushNotifications = electron.pushNotifications;
+export const inAppPurchase = electron.inAppPurchase;
+export const parentPort = electron.parentPort;
+
+export default electron;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@atom-js-org/electron",
+  "version": "0.2.0-alpha.0",
+  "description": "Electron-compatible API facade powered by AtomJS without bundling Electron or a private Chromium runtime.",
+  "main": "index.cjs",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    },
+    "./main": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    },
+    "./renderer": {
+      "types": "./renderer.d.ts",
+      "import": "./renderer.mjs",
+      "require": "./renderer.cjs"
+    },
+    "./common": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "require": "./index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.cjs",
+    "index.mjs",
+    "index.d.ts",
+    "renderer.cjs",
+    "renderer.mjs",
+    "renderer.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.12"
+  },
+  "dependencies": {
+    "@atom-js-org/runtime": "0.2.0-alpha.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Atom-js-org/atom.git",
+    "directory": "packages/electron-compat"
+  },
+  "homepage": "https://github.com/Atom-js-org/atom#readme",
+  "bugs": {
+    "url": "https://github.com/Atom-js-org/atom/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "license": "LicenseRef-AtomJS-1.0",
+  "atomjsElectronCompatibility": true
+}

package/renderer.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+const bridge = globalThis.__ATOMJS_INTERNAL__;
+if (!bridge) {
+  throw new Error("electron/renderer is only available inside an AtomJS WebView preload context.");
+}
+
+exports.ipcRenderer = bridge.ipcRenderer;
+exports.contextBridge = bridge.contextBridge;
+exports.webFrame = bridge.webFrame || {};
+exports.default = exports;

package/renderer.d.ts

@@ -0,0 +1,5 @@
+export const ipcRenderer: any;
+export const contextBridge: any;
+export const webFrame: any;
+declare const electronRenderer: { ipcRenderer: any; contextBridge: any; webFrame: any };
+export default electronRenderer;

package/renderer.mjs

@@ -0,0 +1,9 @@
+const bridge = globalThis.__ATOMJS_INTERNAL__;
+if (!bridge) {
+  throw new Error('electron/renderer is only available inside an AtomJS WebView preload context.');
+}
+
+export const ipcRenderer = bridge.ipcRenderer;
+export const contextBridge = bridge.contextBridge;
+export const webFrame = bridge.webFrame || {};
+export default { ipcRenderer, contextBridge, webFrame };