Merge branch 'master' into jason-crow-fix-register-namespace-errors

Author: jason-crow

common/changes/@itwin/certa/nam-vcb-00-public-callbacks_2026-08-25-12-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "comment": "Expose Certa backend callback helpers through a public callbacks entry point.",
+      "type": "none",
+      "packageName": "@itwin/certa"
+    }
+  ],
+  "packageName": "@itwin/certa"
+}

common/changes/@itwin/core-electron/nam-vcb-00-electron-entries_2026-08-21-12-45.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "comment": "Add conditional renderer and CommonJS main-process entry points.",
+      "type": "none",
+      "packageName": "@itwin/core-electron"
+    }
+  ],
+  "packageName": "@itwin/core-electron"
+}

core/electron/.npmignore

@@ -6,5 +6,6 @@
 !lib/**/*.d.ts.map
 !lib/**/*.js
 !lib/**/*.js.map
+!lib/**/package.json
 
 lib/**/test/**

core/electron/README.md

@@ -6,6 +6,10 @@ Copyright © Bentley Systems, Incorporated. All rights reserved. See LICENSE.md
 
 The __@itwin/core-electron__ package contains the electron utilities to write an iTwin.js application based on Electron.
 
+## Process-specific entry points
+
+Import the renderer API from `@itwin/core-electron/renderer` and the main-process API from `@itwin/core-electron/main`. The renderer entry resolves to the ESM build for `import` and to CommonJS for `require`; its relative imports are explicit so Node ESM and browser bundlers can resolve it. The main-process entry remains CommonJS in both cases.
+
 ## Documentation
 
 See the [iTwin.js](https://www.itwinjs.org) documentation for more information.

core/electron/package.json

@@ -2,10 +2,40 @@
   "name": "@itwin/core-electron",
   "version": "5.14.0-dev.7",
   "description": "iTwin.js ElectronHost and ElectronApp",
+  "exports": {
+    "./renderer": {
+      "import": {
+        "types": "./lib/esm/ElectronFrontend.d.ts",
+        "default": "./lib/esm/ElectronFrontend.js"
+      },
+      "require": {
+        "types": "./lib/cjs/ElectronFrontend.d.ts",
+        "default": "./lib/cjs/ElectronFrontend.js"
+      }
+    },
+    "./main": {
+      "types": "./lib/cjs/ElectronBackend.d.ts",
+      "import": "./lib/cjs/ElectronBackend.js",
+      "require": "./lib/cjs/ElectronBackend.js"
+    },
+    "./lib/cjs/*.js": "./lib/cjs/*.js",
+    "./lib/cjs/*": {
+      "types": "./lib/cjs/*.d.ts",
+      "default": "./lib/cjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "renderer": ["lib/cjs/ElectronFrontend.d.ts"],
+      "main": ["lib/cjs/ElectronBackend.d.ts"]
+    }
+  },
   "license": "MIT",
   "scripts": {
-    "build": "npm run -s build:cjs && npm run -s webpack:test && npm run -s copy:test-assets",
+    "build": "npm run -s build:cjs && npm run -s build:esm && npm run -s webpack:test && npm run -s copy:test-assets",
     "build:cjs": "tsc 1>&2 --outDir lib/cjs",
+    "build:esm": "rimraf -g lib/esm && tsc 1>&2 -p tsconfig.esm.json && node -e \"require('node:fs').writeFileSync('lib/esm/package.json', JSON.stringify({ type: 'module' }) + '\\n')\"",
     "copy:test-assets": "cpx \"./src/test/assets/**/*\" ./lib/cjs/test/assets",
     "clean": "rimraf -g lib .rush/temp/package-deps*.json",
     "docs": "betools docs --json=../../generated-docs/core/core-electron/file.json --tsIndexFile=./core-electron.ts --onlyJson",

core/electron/src/ElectronBackend.ts

@@ -3,4 +3,4 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 
-export * from "./backend/ElectronHost";
+export * from "./backend/ElectronHost.js";

core/electron/src/ElectronFrontend.ts

@@ -3,4 +3,4 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 
-export * from "./frontend/ElectronApp";
+export * from "./frontend/ElectronApp.js";

core/electron/src/backend/ElectronHost.ts

@@ -16,8 +16,8 @@ import * as path from "path";
 import { AsyncMethodsOf, BeDuration, IModelStatus, ProcessDetector } from "@itwin/core-bentley";
 import { IpcHandler, IpcHost, NativeHost, NativeHostOpts } from "@itwin/core-backend";
 import { IModelError, IpcListener, IpcSocketBackend, RemoveFunction, RpcConfiguration, RpcInterfaceDefinition } from "@itwin/core-common";
-import { ElectronRpcConfiguration, ElectronRpcManager } from "../common/ElectronRpcManager";
-import { electronIpcStrings } from "../common/ElectronIpcInterface";
+import { ElectronRpcConfiguration, ElectronRpcManager } from "../common/ElectronRpcManager.js";
+import { electronIpcStrings } from "../common/ElectronIpcInterface.js";
 
 // cSpell:ignore signin devserver webcontents copyfile unmaximize eopt
 

core/electron/src/backend/ElectronPreload.ts

@@ -4,7 +4,7 @@
 *--------------------------------------------------------------------------------------------*/
 
 import { contextBridge, ipcRenderer } from "electron";
-import type { ElectronListener, ITwinElectronApi } from "../common/ITwinElectronApi";
+import type { ElectronListener, ITwinElectronApi } from "../common/ITwinElectronApi.js";
 
 /**
  * This file is loaded as an Electron preload script

core/electron/src/common/ElectronIpcTransport.ts

@@ -7,9 +7,9 @@ import { BentleyError, BentleyStatus, ProcessDetector } from "@itwin/core-bentle
 import {
   IModelError, iTwinChannel, RpcPushChannel, RpcPushConnection, RpcRequestFulfillment, RpcSerializedValue, SerializedRpcRequest,
 } from "@itwin/core-common";
-import { ElectronPushConnection, ElectronPushTransport } from "./ElectronPush";
-import { ElectronRpcConfiguration } from "./ElectronRpcManager";
-import { ElectronRpcProtocol } from "./ElectronRpcProtocol";
+import { ElectronPushConnection, ElectronPushTransport } from "./ElectronPush.js";
+import { ElectronRpcConfiguration } from "./ElectronRpcManager.js";
+import { ElectronRpcProtocol } from "./ElectronRpcProtocol.js";
 
 const OBJECTS_CHANNEL = iTwinChannel("rpc.objects");
 const DATA_CHANNEL = iTwinChannel("rpc.data");