docs(wiki): sync bundled runtime support notes

wiki/index.md

@@ -19,7 +19,9 @@ Read this file before exploring raw sources.
 ## Packages
 
 - [Egg Bundler](./packages/egg-bundler.md) - Tooling package that bundles Egg applications and backs `egg-bin bundle`.
+- [Onerror Plugin](./packages/onerror.md) - Default Egg error-handling plugin and configurable response negotiation layer.
 - [Typings Package](./packages/typings.md) - Shared TypeScript type surface for cross-package Egg typings.
+- [Utils Package](./packages/utils.md) - Shared utility package for module loading and bundled module-loader integration.
 
 ## Sources
 

wiki/log.md

@@ -1,5 +1,11 @@
 # Wiki Log
 
+## [2026-05-06] package | sync bundled runtime support changes
+
+- sources touched: `tools/egg-bundler/src/lib/ExternalsResolver.ts`, `packages/utils/src/import.ts`, `plugins/onerror/src/lib/onerror.ts`
+- pages updated: `wiki/index.md`, `wiki/log.md`, `wiki/packages/egg-bundler.md`, `wiki/packages/utils.md`, `wiki/packages/onerror.md`
+- note: Recorded native optional platform package externalization, the opaque native dynamic import fallback used by bundled `importModule()`, and the local `@eggjs/onerror` implementation that avoids `koa-onerror` template reads.
+
 ## [2026-05-03] package | record egg bundler runtime path mapping
 
 - sources touched: `tools/egg-bundler/src/lib/EntryGenerator.ts`, `tools/egg-bundler/docs/output-structure.md`

wiki/packages/egg-bundler.md

@@ -6,9 +6,10 @@ source_files:
   - tools/egg-bundler/src/index.ts
   - tools/egg-bundler/src/lib/Bundler.ts
   - tools/egg-bundler/src/lib/EntryGenerator.ts
+  - tools/egg-bundler/src/lib/ExternalsResolver.ts
   - tools/egg-bin/src/commands/bundle.ts
   - tools/egg-bundler/docs/output-structure.md
-updated_at: 2026-05-03
+updated_at: 2026-05-06
 status: active
 ---
 

wiki/packages/onerror.md

@@ -0,0 +1,39 @@
+---
+title: Onerror Plugin
+type: package
+summary: Default Egg error-handling plugin and configurable response negotiation layer.
+source_files:
+  - plugins/onerror/README.md
+  - plugins/onerror/src/app.ts
+  - plugins/onerror/src/lib/onerror.ts
+  - plugins/onerror/src/lib/error_view.ts
+  - plugins/onerror/src/config/config.default.ts
+updated_at: 2026-05-06
+status: active
+---
+
+# Onerror Plugin
+
+`@eggjs/onerror` is the default Egg error-handling plugin. It installs
+`ctx.onerror` and supports configurable handlers for HTML, text, JSON, JSONP,
+redirect, and catch-all error responses.
+
+## Public Configuration
+
+- `errorPageUrl` redirects production HTML requests after unexpected errors.
+- `accepts` customizes content negotiation.
+- `all`, `html`, `text`, `json`, and `jsonp` customize response handling for
+  specific response types.
+- `appErrorFilter` can suppress logging for selected errors.
+
+## Current Behavior
+
+The plugin owns its Koa-style `onerror()` implementation in
+`plugins/onerror/src/lib/onerror.ts` instead of importing it from
+`koa-onerror`. This keeps the response behavior local to the plugin and avoids
+reading `koa-onerror` package templates when the plugin app boot hook is
+imported, which is important for static bundling.
+
+Default HTML error-page rendering still flows through `ErrorView` and the
+plugin's local default template. Applications can continue to provide custom
+templates and handlers through the documented `config.onerror` options.

wiki/packages/utils.md

@@ -0,0 +1,38 @@
+---
+title: Utils Package
+type: package
+summary: Shared utility package for Egg module loading, config/plugin helpers, and bundled module-loader integration.
+source_files:
+  - packages/utils/README.md
+  - packages/utils/src/import.ts
+  - packages/utils/test/bundle-import.test.ts
+updated_at: 2026-05-06
+status: active
+---
+
+# Utils Package
+
+`@eggjs/utils` is a shared utility package used across Egg packages.
+
+## Public Surfaces
+
+- `getPlugins(options)`, `getLoadUnits(options)`, `getConfig(options)`, and
+  `getFrameworkPath(options)` expose application/framework discovery helpers.
+- `importModule(filepath, options)` and `importResolve(filepath, options)`
+  centralize runtime module loading.
+- `setBundleModuleLoader(loader)` registers the bundled runtime loader hook.
+
+## Bundled Module Loading
+
+`setBundleModuleLoader(loader)` stores the hook on `globalThis` so bundled and
+external copies of `@eggjs/utils` share the same loader. The loader receives the
+original `importModule()` filepath after POSIX separator normalization, or a
+virtual specifier. Returning `undefined` falls back to the normal resolution
+path; other return values follow the same default-export unwrapping rules as
+`importModule()`.
+
+When a bundle loader is installed and `importModule()` falls through to native
+ESM loading, `packages/utils/src/import.ts` uses an opaque native dynamic import
+created with `new Function('specifier', 'return import(specifier);')`. This
+prevents bundlers such as Turbopack from rewriting non-static dynamic import
+expressions and preserves Node's native fallback for external ESM modules.