AGENTS.md@packages/client/src/host-shims git:20261021.ae7647aA

Immutable. This exact content never changes and is served at /api/v1/blob/8d88803324fb506d.

# DOX — packages/client/src/host-shims

Files in this directory. One row per source file. Each shim is a rollup `input` of `vite.config.ts`, built as `dist/host/<name>.js` and named by the server's static import map (`shared/.../host-import-map.ts`). Shims re-export the app's OWN module instance (shared chunk) so a runtime plugin and the shell share one React / one runtime.

| File | Purpose |
|------|---------|
| `__tests__/host-shims.test.ts` | Parity: each shim's named exports == package's, same object identities; `runtime.ts` names == `public.ts` names (never the `./host` surface); every import-map target has a shim source (8 shims); embedded-app/app-kit-react/wouter shims == their packages' exports, same identities. See change: decouple-plugins-from-core. |
| `app-kit-react.ts` | `export *` of `@blackbelt-technology/pi-dashboard-app-kit/react` (ESM). One `AppHostProvider` context for shell + runtime apps. See change: decouple-plugins-from-core (task 7.1). |
| `embedded-app.ts` | Named re-export of `EmbeddedApp` (+ `EmbeddedAppProps`) from `dashboard-plugin-runtime/src/embedded-app.js`. See change: decouple-plugins-from-core (task 7.1). |
| `react-dom-client.ts` | `react-dom/client` shim (`createRoot`, `hydrateRoot`, `version`, default). See change: decouple-plugins-from-core (task 6.3). |
| `react-dom.ts` | `react-dom` shim: explicit named list (React is CJS; `export *` drops names) + default. See change: decouple-plugins-from-core (task 6.3). |
| `react-jsx-runtime.ts` | `react/jsx-runtime` shim (`Fragment`, `jsx`, `jsxs`). See change: decouple-plugins-from-core (task 6.3). |
| `react.ts` | `react` shim: explicit named list + default. See change: decouple-plugins-from-core (task 6.3). |
| `wouter.ts` | `export *` of `wouter` (ESM). One router context for `<EmbeddedApp>` and runtime apps. See change: decouple-plugins-from-core (task 7.1). |
| `runtime.ts` | `export *` of `dashboard-plugin-runtime/src/public.ts` ONLY. See change: decouple-plugins-from-core (task 6.3). |