@molecule/app-bonds-default-react 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,371 @@
+<!--
+AUTO-GENERATED — DO NOT EDIT THIS FILE.
+Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
+Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
+To change this document, edit the module-level JSDoc in src/index.ts.
+Generated: 2026-08-06T06:01:29.248Z
+-->
+
+# @molecule/app-bonds-default-react
+
+> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
+> It is written to be read by coding agents as much as by people, and is generated from this
+> package's source — edit `src/index.ts` JSDoc, not this file.
+
+`@molecule/app-bonds-default-react` — default app-side bond wirings for the
+React fleet stack, replacing the byte-identical per-app files:
+
+- `bootstrapApp({ App, authClient, setupProviders, registerPWA? })` — the
+  whole scaffolded `src/main.tsx`: awaits `setupProviders()` BEFORE the
+  first render, kicks off `authClient.initialize()` (best-effort), mounts
+  `<App />` in StrictMode on `#root`, then registers the PWA.
+- `setupAllDefaultBonds()` — wires the SEVEN universal bonds in one call:
+  fonts-arimo, routing-react-router, storage-localstorage, styling-tailwind
+  (registers the tailwind-merge class merger), theme-css-variables
+  (light + dark via `getDefaultThemeProvider()`), ui-tailwind ClassMap,
+  icons-molecule. Each also exists as an individual `setupApp*()` for apps
+  that wire a la carte (per-app `app/src/bonds/<name>.ts` files stay 1-line
+  re-exports of these).
+- **Optional provider wirings live behind subpaths**, one module per pair:
+  `@molecule/app-bonds-default-react/optional/<pair>.js` — `realtime-socketio`,
+  `keyboard-shortcuts-hotkeys`, `command-palette-cmdk`, `code-editor-monaco`,
+  `virtual-scroll-tanstack`, `drag-drop-dndkit`, `charts-chartjs`,
+  `maps-leaflet`, `video-hls`. Import ONLY the ones the app installs.
+- Auth/http factories — `createDefaultAuthClient(authConfig)` returns
+  `{ authClient, setupAuthDefault }`; the `...WithHttpSync` /
+  `...WithFetchClient` variants also keep the bonded http client's bearer
+  token in sync with auth events.
+
+## Quick Start
+
+```tsx
+// src/main.tsx
+import {
+  bootstrapApp,
+  createDefaultAuthClientWithHttpSync,
+  setupAllDefaultBonds,
+} from '@molecule/app-bonds-default-react'
+// Optional providers come from their own subpath — see @remarks.
+import { setupAppCodeEditorMonaco } from '@molecule/app-bonds-default-react/optional/code-editor-monaco.js'
+
+import { App } from './App.js'
+import { authConfig } from './config.js'
+
+const { authClient, setupAuthDefault } = createDefaultAuthClientWithHttpSync(authConfig)
+
+bootstrapApp({
+  App,
+  authClient,
+  // Async so optional async bonds are AWAITED before the first render.
+  setupProviders: async () => {
+    setupAllDefaultBonds()
+    setupAuthDefault()
+    await setupAppCodeEditorMonaco() // only if the app uses the code editor
+  },
+})
+```
+
+## Type
+
+`feature`
+
+## Installation
+
+```bash
+npm install @molecule/app-bonds-default-react @molecule/app-auth @molecule/app-charts @molecule/app-charts-chartjs @molecule/app-code-editor @molecule/app-code-editor-monaco @molecule/app-command-palette @molecule/app-command-palette-cmdk @molecule/app-drag-drop @molecule/app-drag-drop-dndkit @molecule/app-fonts @molecule/app-fonts-arimo @molecule/app-http @molecule/app-icons @molecule/app-icons-molecule @molecule/app-keyboard-shortcuts @molecule/app-keyboard-shortcuts-hotkeys @molecule/app-maps @molecule/app-maps-leaflet @molecule/app-realtime @molecule/app-realtime-socketio @molecule/app-routing @molecule/app-routing-react-router @molecule/app-storage @molecule/app-storage-localstorage @molecule/app-styling-tailwind @molecule/app-theme @molecule/app-theme-css-variables @molecule/app-ui @molecule/app-ui-tailwind @molecule/app-video @molecule/app-video-hls @molecule/app-virtual-scroll @molecule/app-virtual-scroll-tanstack react react-dom
+npm install -D @types/react @types/react-dom
+```
+
+## API
+
+### Functions
+
+#### `bootstrapApp(opts)`
+
+Boot the React app: wire bonds, kick off auth initialization, mount
+`<App />` inside `<StrictMode>` to `#root`, and (optionally) register
+the PWA service worker.
+
+Replaces the 20-line per-app `src/main.tsx` that 97 fleet apps shipped
+byte-identically.
+
+```typescript
+function bootstrapApp(opts: {
+  App: ComponentType
+  authClient: { initialize: () => Promise<void> }
+  setupProviders: () => void | Promise<void>
+  registerPWA?: () => void
+}): void
+```
+
+#### `createDefaultAuthClient(authConfig)`
+
+Builds the default JWT auth client + wires it into `@molecule/app-auth`.
+
+Replaces the 16-line per-app `bonds/auth-default.ts` that 93 fleet
+apps shipped byte-identically. Apps pass their own `authConfig`
+(which lives in `src/config.ts`).
+
+```typescript
+function createDefaultAuthClient(authConfig: AuthClientConfig): {
+  authClient: AuthClient<TUser>
+  setupAuthDefault: () => void
+}
+```
+
+#### `createDefaultAuthClientWithFetchClient(authConfig, fetchClientOptions)`
+
+Most aggressive variant — bonds a fetch-based HTTP client with the
+given `baseURL` (so molecule pkg `useGet('/path')` calls hit
+`${baseURL}/path` instead of the SPA's catch-all route), AND keeps
+its bearer token in sync with auth events.
+
+Used by apps where molecule packages render pricing / billing /
+other authed JSON-fetching screens that need both behaviors.
+
+```typescript
+function createDefaultAuthClientWithFetchClient(
+  authConfig: AuthClientConfig,
+  fetchClientOptions: { baseURL: string; withCredentials?: boolean },
+): { authClient: AuthClient<TUser>; setupAuthDefault: () => void }
+```
+
+#### `createDefaultAuthClientWithHttpSync(authConfig)`
+
+Variant of `createDefaultAuthClient` that also keeps the bonded
+`@molecule/app-http` client's bearer token in sync with auth events
+(login / register / refresh / logout). Required by apps whose http
+client must carry the JWT on every request — without this wiring,
+authed endpoints return 401 after page reloads or token refresh.
+
+Hydrates the HTTP client's token from the persisted auth state
+on setup, then listens for auth events to keep them aligned.
+
+```typescript
+function createDefaultAuthClientWithHttpSync(authConfig: AuthClientConfig): {
+  authClient: AuthClient<TUser>
+  setupAuthDefault: () => void
+}
+```
+
+#### `createDefaultHttpClient(baseURL)`
+
+Builds the default fetch-based HTTP client + wires it into
+`@molecule/app-http`. Replaces the per-app `bonds/http-default.ts`
+shipped by ~52 fleet apps.
+
+```typescript
+function createDefaultHttpClient(baseURL: string): {
+  httpClient: HttpClient
+  setupHttpDefault: () => void
+}
+```
+
+#### `createDefaultHttpClientWithAuthBearer(opts)`
+
+Variant of `createDefaultHttpClient` that adds a request interceptor
+injecting the JWT bearer token from the auth client AND (optionally)
+stripping a leading `/api/` from request URLs.
+
+Replaces ~20 per-app `bonds/http-default.ts` files that hand-roll
+this same wiring. Pass `stripApiPrefix: true` when the app uses
+`baseURL: '/api'` to handle pages that pass `/api/`-prefixed paths
+(would otherwise resolve to `/api/api/...` and 404).
+
+```typescript
+function createDefaultHttpClientWithAuthBearer(opts: {
+  baseURL: string
+  withCredentials?: boolean
+  stripApiPrefix?: boolean
+  getToken: () => string | null | undefined
+}): { httpClient: HttpClient; setupHttpDefault: () => void }
+```
+
+#### `getDefaultThemeProvider()`
+
+Returns (and lazily constructs) the shared default CSS-variables theme provider.
+
+```typescript
+function getDefaultThemeProvider(): ThemeProvider
+```
+
+#### `setupAllDefaultBonds()`
+
+Wires all 7 universal app-side bonds in one call — fonts, routing,
+storage, styling, theme, UI ClassMap, icons (in that order). Auth
+
+- i18n stay per-app because they need app-specific config.
+
+Replaces 9 individual setupX() calls in per-app `bonds/index.ts`.
+
+```typescript
+function setupAllDefaultBonds(): void
+```
+
+#### `setupAppFontsArimo()`
+
+Wires `@molecule/app-fonts-arimo` to `@molecule/app-fonts`.
+
+```typescript
+function setupAppFontsArimo(): void
+```
+
+#### `setupAppIconsMolecule()`
+
+Wires `@molecule/app-icons-molecule` to `@molecule/app-icons`.
+
+```typescript
+function setupAppIconsMolecule(): void
+```
+
+#### `setupAppRoutingReactRouter()`
+
+Wires `@molecule/app-routing-react-router` to `@molecule/app-routing`.
+
+```typescript
+function setupAppRoutingReactRouter(): void
+```
+
+#### `setupAppStorageLocalstorage()`
+
+Wires `@molecule/app-storage-localstorage` to `@molecule/app-storage`.
+
+```typescript
+function setupAppStorageLocalstorage(): void
+```
+
+#### `setupAppStylingTailwind()`
+
+Wires `@molecule/app-styling-tailwind`: registers `tailwind-merge` as the
+class merger for `@molecule/app-styling`'s `cn()`, so conflicting Tailwind
+utilities resolve (last wins). Tailwind itself is configured via env vars +
+the Vite plugin; this is the one runtime hook the framework-agnostic styling
+core needs so it carries no Tailwind dependency of its own.
+
+```typescript
+function setupAppStylingTailwind(): void
+```
+
+#### `setupAppThemeCssVariables()`
+
+Wires the default light + dark CSS-variables theme provider to `@molecule/app-theme`.
+
+```typescript
+function setupAppThemeCssVariables(): void
+```
+
+#### `setupAppUiTailwind()`
+
+Wires `@molecule/app-ui-tailwind` `classMap` to `@molecule/app-ui`.
+
+```typescript
+function setupAppUiTailwind(): void
+```
+
+## Injection Notes
+
+### Requirements
+
+Peer dependencies:
+
+- `@molecule/app-auth` ^1.0.1
+- `@molecule/app-charts` ^1.0.1
+- `@molecule/app-charts-chartjs` ^1.0.1
+- `@molecule/app-code-editor` ^1.0.1
+- `@molecule/app-code-editor-monaco` ^1.0.1
+- `@molecule/app-command-palette` ^1.0.1
+- `@molecule/app-command-palette-cmdk` ^1.0.1
+- `@molecule/app-drag-drop` ^1.0.1
+- `@molecule/app-drag-drop-dndkit` ^1.0.1
+- `@molecule/app-fonts` ^1.0.1
+- `@molecule/app-fonts-arimo` ^1.0.1
+- `@molecule/app-http` ^1.0.1
+- `@molecule/app-icons` ^1.0.1
+- `@molecule/app-icons-molecule` ^1.0.1
+- `@molecule/app-keyboard-shortcuts` ^1.0.1
+- `@molecule/app-keyboard-shortcuts-hotkeys` ^1.0.1
+- `@molecule/app-maps` ^1.0.1
+- `@molecule/app-maps-leaflet` ^1.0.1
+- `@molecule/app-realtime` ^1.0.1
+- `@molecule/app-realtime-socketio` ^1.0.1
+- `@molecule/app-routing` ^1.0.1
+- `@molecule/app-routing-react-router` ^1.0.1
+- `@molecule/app-storage` ^1.0.1
+- `@molecule/app-storage-localstorage` ^1.0.1
+- `@molecule/app-styling-tailwind` ^1.0.1
+- `@molecule/app-theme` ^1.0.1
+- `@molecule/app-theme-css-variables` ^1.0.1
+- `@molecule/app-ui` ^1.0.1
+- `@molecule/app-ui-tailwind` ^1.0.1
+- `@molecule/app-video` ^1.0.1
+- `@molecule/app-video-hls` ^1.0.1
+- `@molecule/app-virtual-scroll` ^1.0.1
+- `@molecule/app-virtual-scroll-tanstack` ^1.0.1
+- `react` ^18.0.0 || ^19.0.0
+- `react-dom` ^18.0.0 || ^19.0.0
+
+### Runtime Dependencies
+
+- `@molecule/app-auth`
+- `@molecule/app-charts`
+- `@molecule/app-charts-chartjs`
+- `@molecule/app-code-editor`
+- `@molecule/app-code-editor-monaco`
+- `@molecule/app-command-palette`
+- `@molecule/app-command-palette-cmdk`
+- `@molecule/app-drag-drop`
+- `@molecule/app-drag-drop-dndkit`
+- `@molecule/app-fonts`
+- `@molecule/app-fonts-arimo`
+- `@molecule/app-http`
+- `@molecule/app-icons`
+- `@molecule/app-icons-molecule`
+- `@molecule/app-keyboard-shortcuts`
+- `@molecule/app-keyboard-shortcuts-hotkeys`
+- `@molecule/app-maps`
+- `@molecule/app-maps-leaflet`
+- `@molecule/app-realtime`
+- `@molecule/app-realtime-socketio`
+- `@molecule/app-routing`
+- `@molecule/app-routing-react-router`
+- `@molecule/app-storage`
+- `@molecule/app-storage-localstorage`
+- `@molecule/app-styling-tailwind`
+- `@molecule/app-theme`
+- `@molecule/app-theme-css-variables`
+- `@molecule/app-ui`
+- `@molecule/app-ui-tailwind`
+- `@molecule/app-video`
+- `@molecule/app-video-hls`
+- `@molecule/app-virtual-scroll`
+- `@molecule/app-virtual-scroll-tanstack`
+- `react`
+- `react-dom`
+
+- **Optional setups are NOT exported from the package root.** Import each from
+  its own subpath — `@molecule/app-bonds-default-react/optional/maps-leaflet.js`,
+  not `from '@molecule/app-bonds-default-react'`. A bundler must RESOLVE every
+  `import()` in a module it pulls into the graph, before tree-shaking can drop
+  anything, so while these lived in the barrel every app inherited all 18
+  optional providers and any app that had not installed all of them failed to
+  build with `Rolldown failed to resolve import "@molecule/app-maps"`. Only
+  import a subpath whose provider pair the app actually installs.
+- `setupAllDefaultBonds()` does NOT wire the optional bonds. Those ship as
+  separate ASYNC setups — `setupAppRealtimeSocketio`,
+  `setupAppKeyboardShortcutsHotkeys`, `setupAppCommandPaletteCmdk`,
+  `setupAppCodeEditorMonaco`, `setupAppVirtualScrollTanstack`,
+  `setupAppDragDropDndkit`, `setupAppChartsChartjs`, `setupAppMapsLeaflet`,
+  `setupAppVideoHls` — and MUST be awaited inside `setupProviders`
+  (make it async). `bootstrapApp` awaits `setupProviders()` before mounting
+  so bonded providers exist by a component's first effect; a fire-and-forget
+  async setup races the mount and intermittently loses.
+- Plain `createDefaultAuthClient` does NOT attach the JWT to the bonded
+  http client. If molecule packages call authed `/api` endpoints, use
+  `createDefaultAuthClientWithHttpSync` (or `...WithFetchClient` to also
+  bond a fetch client with a `baseURL`) — otherwise those endpoints return
+  401 after a page reload or token refresh.
+- `getDefaultThemeProvider()` constructs lazily because the CSS-variables
+  theme provider touches `localStorage` at construction — importing this
+  package is SSR/test-safe, but only CALL it in a DOM environment. Apps
+  with custom themes build their own provider and skip
+  `setupAppThemeCssVariables()`.

package/dist/index.d.ts

@@ -13,6 +13,11 @@
  *   icons-molecule. Each also exists as an individual `setupApp*()` for apps
  *   that wire a la carte (per-app `app/src/bonds/<name>.ts` files stay 1-line
  *   re-exports of these).
+ * - **Optional provider wirings live behind subpaths**, one module per pair:
+ *   `@molecule/app-bonds-default-react/optional/<pair>.js` — `realtime-socketio`,
+ *   `keyboard-shortcuts-hotkeys`, `command-palette-cmdk`, `code-editor-monaco`,
+ *   `virtual-scroll-tanstack`, `drag-drop-dndkit`, `charts-chartjs`,
+ *   `maps-leaflet`, `video-hls`. Import ONLY the ones the app installs.
  * - Auth/http factories — `createDefaultAuthClient(authConfig)` returns
  *   `{ authClient, setupAuthDefault }`; the `...WithHttpSync` /
  *   `...WithFetchClient` variants also keep the bonded http client's bearer
@@ -25,8 +30,9 @@
  *   bootstrapApp,
  *   createDefaultAuthClientWithHttpSync,
  *   setupAllDefaultBonds,
- *   setupAppCodeEditorMonaco,
  * } from '@molecule/app-bonds-default-react'
+ * // Optional providers come from their own subpath — see @remarks.
+ * import { setupAppCodeEditorMonaco } from '@molecule/app-bonds-default-react/optional/code-editor-monaco.js'
  *
  * import { App } from './App.js'
  * import { authConfig } from './config.js'
@@ -47,6 +53,14 @@
  * ```
  *
  * @remarks
+ * - **Optional setups are NOT exported from the package root.** Import each from
+ *   its own subpath — `@molecule/app-bonds-default-react/optional/maps-leaflet.js`,
+ *   not `from '@molecule/app-bonds-default-react'`. A bundler must RESOLVE every
+ *   `import()` in a module it pulls into the graph, before tree-shaking can drop
+ *   anything, so while these lived in the barrel every app inherited all 18
+ *   optional providers and any app that had not installed all of them failed to
+ *   build with `Rolldown failed to resolve import "@molecule/app-maps"`. Only
+ *   import a subpath whose provider pair the app actually installs.
  * - `setupAllDefaultBonds()` does NOT wire the optional bonds. Those ship as
  *   separate ASYNC setups — `setupAppRealtimeSocketio`,
  *   `setupAppKeyboardShortcutsHotkeys`, `setupAppCommandPaletteCmdk`,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AAEH,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AAEH,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -13,6 +13,11 @@
  *   icons-molecule. Each also exists as an individual `setupApp*()` for apps
  *   that wire a la carte (per-app `app/src/bonds/<name>.ts` files stay 1-line
  *   re-exports of these).
+ * - **Optional provider wirings live behind subpaths**, one module per pair:
+ *   `@molecule/app-bonds-default-react/optional/<pair>.js` — `realtime-socketio`,
+ *   `keyboard-shortcuts-hotkeys`, `command-palette-cmdk`, `code-editor-monaco`,
+ *   `virtual-scroll-tanstack`, `drag-drop-dndkit`, `charts-chartjs`,
+ *   `maps-leaflet`, `video-hls`. Import ONLY the ones the app installs.
  * - Auth/http factories — `createDefaultAuthClient(authConfig)` returns
  *   `{ authClient, setupAuthDefault }`; the `...WithHttpSync` /
  *   `...WithFetchClient` variants also keep the bonded http client's bearer
@@ -25,8 +30,9 @@
  *   bootstrapApp,
  *   createDefaultAuthClientWithHttpSync,
  *   setupAllDefaultBonds,
- *   setupAppCodeEditorMonaco,
  * } from '@molecule/app-bonds-default-react'
+ * // Optional providers come from their own subpath — see @remarks.
+ * import { setupAppCodeEditorMonaco } from '@molecule/app-bonds-default-react/optional/code-editor-monaco.js'
  *
  * import { App } from './App.js'
  * import { authConfig } from './config.js'
@@ -47,6 +53,14 @@
  * ```
  *
  * @remarks
+ * - **Optional setups are NOT exported from the package root.** Import each from
+ *   its own subpath — `@molecule/app-bonds-default-react/optional/maps-leaflet.js`,
+ *   not `from '@molecule/app-bonds-default-react'`. A bundler must RESOLVE every
+ *   `import()` in a module it pulls into the graph, before tree-shaking can drop
+ *   anything, so while these lived in the barrel every app inherited all 18
+ *   optional providers and any app that had not installed all of them failed to
+ *   build with `Rolldown failed to resolve import "@molecule/app-maps"`. Only
+ *   import a subpath whose provider pair the app actually installs.
  * - `setupAllDefaultBonds()` does NOT wire the optional bonds. Those ship as
  *   separate ASYNC setups — `setupAppRealtimeSocketio`,
  *   `setupAppKeyboardShortcutsHotkeys`, `setupAppCommandPaletteCmdk`,

package/dist/optional/charts-chartjs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wiring for the optional `@molecule/app-charts` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/**
+ * Wires `@molecule/app-charts-chartjs` (Chart.js) to `@molecule/app-charts` — real
+ * line/bar/pie/etc. charts instead of the core's placeholder panel.
+ */
+export declare function setupAppChartsChartjs(): Promise<void>;
+//# sourceMappingURL=charts-chartjs.d.ts.map

package/dist/optional/charts-chartjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts-chartjs.d.ts","sourceRoot":"","sources":["../../src/optional/charts-chartjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3D"}

package/dist/optional/charts-chartjs.js

@@ -0,0 +1,20 @@
+/**
+ * Wiring for the optional `@molecule/app-charts` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/**
+ * Wires `@molecule/app-charts-chartjs` (Chart.js) to `@molecule/app-charts` — real
+ * line/bar/pie/etc. charts instead of the core's placeholder panel.
+ */
+export async function setupAppChartsChartjs() {
+    const [{ setProvider: setCharts }, { provider }] = await Promise.all([
+        import('@molecule/app-charts'),
+        import('@molecule/app-charts-chartjs'),
+    ]);
+    setCharts(provider);
+}

package/dist/optional/code-editor-monaco.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-code-editor` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-code-editor-monaco` to `@molecule/app-code-editor`. */
+export declare function setupAppCodeEditorMonaco(): Promise<void>;
+//# sourceMappingURL=code-editor-monaco.d.ts.map

package/dist/optional/code-editor-monaco.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-editor-monaco.d.ts","sourceRoot":"","sources":["../../src/optional/code-editor-monaco.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9D"}

package/dist/optional/code-editor-monaco.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-code-editor` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-code-editor-monaco` to `@molecule/app-code-editor`. */
+export async function setupAppCodeEditorMonaco() {
+    const [{ setProvider: setEditor }, { provider }] = await Promise.all([
+        import('@molecule/app-code-editor'),
+        import('@molecule/app-code-editor-monaco'),
+    ]);
+    setEditor(provider);
+}

package/dist/optional/command-palette-cmdk.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-command-palette` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-command-palette-cmdk` to `@molecule/app-command-palette`. */
+export declare function setupAppCommandPaletteCmdk(): Promise<void>;
+//# sourceMappingURL=command-palette-cmdk.d.ts.map

package/dist/optional/command-palette-cmdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-cmdk.d.ts","sourceRoot":"","sources":["../../src/optional/command-palette-cmdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qFAAqF;AACrF,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhE"}

package/dist/optional/command-palette-cmdk.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-command-palette` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-command-palette-cmdk` to `@molecule/app-command-palette`. */
+export async function setupAppCommandPaletteCmdk() {
+    const [{ setProvider: setPalette }, { provider }] = await Promise.all([
+        import('@molecule/app-command-palette'),
+        import('@molecule/app-command-palette-cmdk'),
+    ]);
+    setPalette(provider);
+}

package/dist/optional/drag-drop-dndkit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-drag-drop` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-drag-drop-dndkit` to `@molecule/app-drag-drop`. */
+export declare function setupAppDragDropDndkit(): Promise<void>;
+//# sourceMappingURL=drag-drop-dndkit.d.ts.map

package/dist/optional/drag-drop-dndkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-drop-dndkit.d.ts","sourceRoot":"","sources":["../../src/optional/drag-drop-dndkit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5D"}

package/dist/optional/drag-drop-dndkit.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-drag-drop` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-drag-drop-dndkit` to `@molecule/app-drag-drop`. */
+export async function setupAppDragDropDndkit() {
+    const [{ setProvider: setDnd }, { provider }] = await Promise.all([
+        import('@molecule/app-drag-drop'),
+        import('@molecule/app-drag-drop-dndkit'),
+    ]);
+    setDnd(provider);
+}

package/dist/optional/keyboard-shortcuts-hotkeys.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-keyboard-shortcuts` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-keyboard-shortcuts-hotkeys` to `@molecule/app-keyboard-shortcuts`. */
+export declare function setupAppKeyboardShortcutsHotkeys(): Promise<void>;
+//# sourceMappingURL=keyboard-shortcuts-hotkeys.d.ts.map

package/dist/optional/keyboard-shortcuts-hotkeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-shortcuts-hotkeys.d.ts","sourceRoot":"","sources":["../../src/optional/keyboard-shortcuts-hotkeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8FAA8F;AAC9F,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtE"}

package/dist/optional/keyboard-shortcuts-hotkeys.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-keyboard-shortcuts` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-keyboard-shortcuts-hotkeys` to `@molecule/app-keyboard-shortcuts`. */
+export async function setupAppKeyboardShortcutsHotkeys() {
+    const [{ setProvider: setKbd }, { provider }] = await Promise.all([
+        import('@molecule/app-keyboard-shortcuts'),
+        import('@molecule/app-keyboard-shortcuts-hotkeys'),
+    ]);
+    setKbd(provider);
+}

package/dist/optional/maps-leaflet.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Wiring for the optional `@molecule/app-maps` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale. `@molecule/app-maps` is the import that first exposed the problem:
+ * it is the alphabetically-first unresolvable provider, so it is the one Rolldown
+ * named while the other 14 were equally broken.
+ *
+ * @module
+ */
+/**
+ * Wires `@molecule/app-maps-leaflet` (Leaflet + OpenStreetMap, no API key) to
+ * `@molecule/app-maps` — a real slippy map instead of the core's grey placeholder.
+ * REQUIRES `import 'leaflet/dist/leaflet.css'` once in the app entry (the scaffolded
+ * `bonds/app-maps-leaflet.ts` does this); without it tiles + markers mis-position.
+ */
+export declare function setupAppMapsLeaflet(): Promise<void>;
+//# sourceMappingURL=maps-leaflet.d.ts.map

package/dist/optional/maps-leaflet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-leaflet.d.ts","sourceRoot":"","sources":["../../src/optional/maps-leaflet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzD"}

package/dist/optional/maps-leaflet.js

@@ -0,0 +1,24 @@
+/**
+ * Wiring for the optional `@molecule/app-maps` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale. `@molecule/app-maps` is the import that first exposed the problem:
+ * it is the alphabetically-first unresolvable provider, so it is the one Rolldown
+ * named while the other 14 were equally broken.
+ *
+ * @module
+ */
+/**
+ * Wires `@molecule/app-maps-leaflet` (Leaflet + OpenStreetMap, no API key) to
+ * `@molecule/app-maps` — a real slippy map instead of the core's grey placeholder.
+ * REQUIRES `import 'leaflet/dist/leaflet.css'` once in the app entry (the scaffolded
+ * `bonds/app-maps-leaflet.ts` does this); without it tiles + markers mis-position.
+ */
+export async function setupAppMapsLeaflet() {
+    const [{ setProvider: setMaps }, { provider }] = await Promise.all([
+        import('@molecule/app-maps'),
+        import('@molecule/app-maps-leaflet'),
+    ]);
+    setMaps(provider);
+}

package/dist/optional/realtime-socketio.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Wiring for the optional `@molecule/app-realtime` bond.
+ *
+ * Lives in its own module, reachable only via the
+ * `@molecule/app-bonds-default-react/optional/realtime-socketio.js` subpath, because
+ * a bundler must RESOLVE every `import()` in a module it pulls into the graph —
+ * before tree-shaking can drop anything. While these wirings sat in `setup.ts`
+ * (re-exported from the barrel), importing `bootstrapApp` dragged all 18 optional
+ * providers into the graph, and any app that had not installed all of them failed
+ * to build:
+ *
+ * ```
+ * [vite]: Rolldown failed to resolve import "@molecule/app-maps"
+ *         from ".../app-bonds-default-react/dist/setup.js"
+ * ```
+ *
+ * One module per provider pair means an app pays for exactly the providers it
+ * imports — which is what made them optional in the first place.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-realtime-socketio` to `@molecule/app-realtime`. */
+export declare function setupAppRealtimeSocketio(): Promise<void>;
+//# sourceMappingURL=realtime-socketio.d.ts.map

package/dist/optional/realtime-socketio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-socketio.d.ts","sourceRoot":"","sources":["../../src/optional/realtime-socketio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,2EAA2E;AAC3E,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9D"}

package/dist/optional/realtime-socketio.js

@@ -0,0 +1,29 @@
+/**
+ * Wiring for the optional `@molecule/app-realtime` bond.
+ *
+ * Lives in its own module, reachable only via the
+ * `@molecule/app-bonds-default-react/optional/realtime-socketio.js` subpath, because
+ * a bundler must RESOLVE every `import()` in a module it pulls into the graph —
+ * before tree-shaking can drop anything. While these wirings sat in `setup.ts`
+ * (re-exported from the barrel), importing `bootstrapApp` dragged all 18 optional
+ * providers into the graph, and any app that had not installed all of them failed
+ * to build:
+ *
+ * ```
+ * [vite]: Rolldown failed to resolve import "@molecule/app-maps"
+ *         from ".../app-bonds-default-react/dist/setup.js"
+ * ```
+ *
+ * One module per provider pair means an app pays for exactly the providers it
+ * imports — which is what made them optional in the first place.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-realtime-socketio` to `@molecule/app-realtime`. */
+export async function setupAppRealtimeSocketio() {
+    const [{ setProvider: setRealtime }, { provider }] = await Promise.all([
+        import('@molecule/app-realtime'),
+        import('@molecule/app-realtime-socketio'),
+    ]);
+    setRealtime(provider);
+}

package/dist/optional/video-hls.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-video` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-video-hls` (hls.js — HLS streaming everywhere) to `@molecule/app-video`. */
+export declare function setupAppVideoHls(): Promise<void>;
+//# sourceMappingURL=video-hls.d.ts.map

package/dist/optional/video-hls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-hls.d.ts","sourceRoot":"","sources":["../../src/optional/video-hls.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oGAAoG;AACpG,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD"}

package/dist/optional/video-hls.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-video` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-video-hls` (hls.js — HLS streaming everywhere) to `@molecule/app-video`. */
+export async function setupAppVideoHls() {
+    const [{ setProvider: setVideo }, { provider }] = await Promise.all([
+        import('@molecule/app-video'),
+        import('@molecule/app-video-hls'),
+    ]);
+    setVideo(provider);
+}

package/dist/optional/virtual-scroll-tanstack.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Wiring for the optional `@molecule/app-virtual-scroll` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-virtual-scroll-tanstack` to `@molecule/app-virtual-scroll`. */
+export declare function setupAppVirtualScrollTanstack(): Promise<void>;
+//# sourceMappingURL=virtual-scroll-tanstack.d.ts.map

package/dist/optional/virtual-scroll-tanstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-scroll-tanstack.d.ts","sourceRoot":"","sources":["../../src/optional/virtual-scroll-tanstack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,uFAAuF;AACvF,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnE"}

package/dist/optional/virtual-scroll-tanstack.js

@@ -0,0 +1,17 @@
+/**
+ * Wiring for the optional `@molecule/app-virtual-scroll` bond.
+ *
+ * Its own module + subpath export so a bundler only resolves these providers when
+ * an app actually imports them — see `./realtime-socketio.js` for the full
+ * rationale.
+ *
+ * @module
+ */
+/** Wires `@molecule/app-virtual-scroll-tanstack` to `@molecule/app-virtual-scroll`. */
+export async function setupAppVirtualScrollTanstack() {
+    const [{ setProvider: setScroll }, { provider }] = await Promise.all([
+        import('@molecule/app-virtual-scroll'),
+        import('@molecule/app-virtual-scroll-tanstack'),
+    ]);
+    setScroll(provider);
+}

package/dist/setup.d.ts

@@ -35,32 +35,6 @@ export declare function setupAppStylingTailwind(): void;
 export declare function setupAppThemeCssVariables(): void;
 /** Wires `@molecule/app-ui-tailwind` `classMap` to `@molecule/app-ui`. */
 export declare function setupAppUiTailwind(): void;
-/** Wires `@molecule/app-realtime-socketio` to `@molecule/app-realtime`. */
-export declare function setupAppRealtimeSocketio(): Promise<void>;
-/** Wires `@molecule/app-keyboard-shortcuts-hotkeys` to `@molecule/app-keyboard-shortcuts`. */
-export declare function setupAppKeyboardShortcutsHotkeys(): Promise<void>;
-/** Wires `@molecule/app-command-palette-cmdk` to `@molecule/app-command-palette`. */
-export declare function setupAppCommandPaletteCmdk(): Promise<void>;
-/** Wires `@molecule/app-code-editor-monaco` to `@molecule/app-code-editor`. */
-export declare function setupAppCodeEditorMonaco(): Promise<void>;
-/** Wires `@molecule/app-virtual-scroll-tanstack` to `@molecule/app-virtual-scroll`. */
-export declare function setupAppVirtualScrollTanstack(): Promise<void>;
-/** Wires `@molecule/app-drag-drop-dndkit` to `@molecule/app-drag-drop`. */
-export declare function setupAppDragDropDndkit(): Promise<void>;
-/**
- * Wires `@molecule/app-charts-chartjs` (Chart.js) to `@molecule/app-charts` — real
- * line/bar/pie/etc. charts instead of the core's placeholder panel.
- */
-export declare function setupAppChartsChartjs(): Promise<void>;
-/**
- * Wires `@molecule/app-maps-leaflet` (Leaflet + OpenStreetMap, no API key) to
- * `@molecule/app-maps` — a real slippy map instead of the core's grey placeholder.
- * REQUIRES `import 'leaflet/dist/leaflet.css'` once in the app entry (the scaffolded
- * `bonds/app-maps-leaflet.ts` does this); without it tiles + markers mis-position.
- */
-export declare function setupAppMapsLeaflet(): Promise<void>;
-/** Wires `@molecule/app-video-hls` (hls.js — HLS streaming everywhere) to `@molecule/app-video`. */
-export declare function setupAppVideoHls(): Promise<void>;
 /**
  * Wires all 7 universal app-side bonds in one call — fonts, routing,
  * storage, styling, theme, UI ClassMap, icons (in that order). Auth

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EACL,+BAA+B,EAGhC,MAAM,mCAAmC,CAAA;AAe1C,uFAAuF;AACvF,wBAAgB,uBAAuB,IAAI,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAS5F;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,2EAA2E;AAC3E,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED,8FAA8F;AAC9F,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,qFAAqF;AACrF,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhE;AAED,+EAA+E;AAC/E,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM9D;AAED,uFAAuF;AACvF,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnE;AAED,2EAA2E;AAC3E,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM5D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3D;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzD;AAED,oGAAoG;AACpG,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,EACL,+BAA+B,EAGhC,MAAM,mCAAmC,CAAA;AAe1C,uFAAuF;AACvF,wBAAgB,uBAAuB,IAAI,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAS5F;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAQ3C"}

package/dist/setup.js

@@ -81,86 +81,6 @@ export function setupAppThemeCssVariables() {
 export function setupAppUiTailwind() {
     setClassMap(classMap);
 }
-/** Wires `@molecule/app-realtime-socketio` to `@molecule/app-realtime`. */
-export async function setupAppRealtimeSocketio() {
-    const [{ setProvider: setRealtime }, { provider }] = await Promise.all([
-        import('@molecule/app-realtime'),
-        import('@molecule/app-realtime-socketio'),
-    ]);
-    setRealtime(provider);
-}
-/** Wires `@molecule/app-keyboard-shortcuts-hotkeys` to `@molecule/app-keyboard-shortcuts`. */
-export async function setupAppKeyboardShortcutsHotkeys() {
-    const [{ setProvider: setKbd }, { provider }] = await Promise.all([
-        import('@molecule/app-keyboard-shortcuts'),
-        import('@molecule/app-keyboard-shortcuts-hotkeys'),
-    ]);
-    setKbd(provider);
-}
-/** Wires `@molecule/app-command-palette-cmdk` to `@molecule/app-command-palette`. */
-export async function setupAppCommandPaletteCmdk() {
-    const [{ setProvider: setPalette }, { provider }] = await Promise.all([
-        import('@molecule/app-command-palette'),
-        import('@molecule/app-command-palette-cmdk'),
-    ]);
-    setPalette(provider);
-}
-/** Wires `@molecule/app-code-editor-monaco` to `@molecule/app-code-editor`. */
-export async function setupAppCodeEditorMonaco() {
-    const [{ setProvider: setEditor }, { provider }] = await Promise.all([
-        import('@molecule/app-code-editor'),
-        import('@molecule/app-code-editor-monaco'),
-    ]);
-    setEditor(provider);
-}
-/** Wires `@molecule/app-virtual-scroll-tanstack` to `@molecule/app-virtual-scroll`. */
-export async function setupAppVirtualScrollTanstack() {
-    const [{ setProvider: setScroll }, { provider }] = await Promise.all([
-        import('@molecule/app-virtual-scroll'),
-        import('@molecule/app-virtual-scroll-tanstack'),
-    ]);
-    setScroll(provider);
-}
-/** Wires `@molecule/app-drag-drop-dndkit` to `@molecule/app-drag-drop`. */
-export async function setupAppDragDropDndkit() {
-    const [{ setProvider: setDnd }, { provider }] = await Promise.all([
-        import('@molecule/app-drag-drop'),
-        import('@molecule/app-drag-drop-dndkit'),
-    ]);
-    setDnd(provider);
-}
-/**
- * Wires `@molecule/app-charts-chartjs` (Chart.js) to `@molecule/app-charts` — real
- * line/bar/pie/etc. charts instead of the core's placeholder panel.
- */
-export async function setupAppChartsChartjs() {
-    const [{ setProvider: setCharts }, { provider }] = await Promise.all([
-        import('@molecule/app-charts'),
-        import('@molecule/app-charts-chartjs'),
-    ]);
-    setCharts(provider);
-}
-/**
- * Wires `@molecule/app-maps-leaflet` (Leaflet + OpenStreetMap, no API key) to
- * `@molecule/app-maps` — a real slippy map instead of the core's grey placeholder.
- * REQUIRES `import 'leaflet/dist/leaflet.css'` once in the app entry (the scaffolded
- * `bonds/app-maps-leaflet.ts` does this); without it tiles + markers mis-position.
- */
-export async function setupAppMapsLeaflet() {
-    const [{ setProvider: setMaps }, { provider }] = await Promise.all([
-        import('@molecule/app-maps'),
-        import('@molecule/app-maps-leaflet'),
-    ]);
-    setMaps(provider);
-}
-/** Wires `@molecule/app-video-hls` (hls.js — HLS streaming everywhere) to `@molecule/app-video`. */
-export async function setupAppVideoHls() {
-    const [{ setProvider: setVideo }, { provider }] = await Promise.all([
-        import('@molecule/app-video'),
-        import('@molecule/app-video-hls'),
-    ]);
-    setVideo(provider);
-}
 /**
  * Wires all 7 universal app-side bonds in one call — fonts, routing,
  * storage, styling, theme, UI ClassMap, icons (in that order). Auth

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-bonds-default-react",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Default app-side bond wirings for React+Tailwind+react-router+localStorage+Arimo font+molecule icons. 5 setup functions consolidating 665 byte-identical per-app bond wiring files across the fleet.",
   "type": "module",
   "main": "dist/index.js",
@@ -14,10 +14,15 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./optional/*.js": {
+      "types": "./dist/optional/*.d.ts",
+      "import": "./dist/optional/*.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "keywords": [
     "molecule",
@@ -26,36 +31,41 @@
     "react"
   ],
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/molecule-dev/molecule.git",
+    "directory": "packages/app/infrastructure/bonds-default-react"
+  },
   "devDependencies": {
-    "@molecule/app-auth": "1.0.0",
-    "@molecule/app-charts-chartjs": "1.0.0",
-    "@molecule/app-code-editor": "1.0.0",
-    "@molecule/app-code-editor-monaco": "1.0.0",
-    "@molecule/app-command-palette": "1.0.0",
-    "@molecule/app-command-palette-cmdk": "1.0.0",
-    "@molecule/app-drag-drop": "1.0.0",
-    "@molecule/app-drag-drop-dndkit": "1.0.0",
-    "@molecule/app-fonts": "1.0.0",
-    "@molecule/app-fonts-arimo": "1.0.0",
-    "@molecule/app-http": "1.0.0",
-    "@molecule/app-icons": "1.0.0",
-    "@molecule/app-icons-molecule": "1.0.0",
-    "@molecule/app-keyboard-shortcuts": "1.0.0",
-    "@molecule/app-keyboard-shortcuts-hotkeys": "1.0.0",
-    "@molecule/app-maps-leaflet": "1.0.0",
-    "@molecule/app-realtime": "1.0.0",
-    "@molecule/app-realtime-socketio": "1.0.0",
-    "@molecule/app-routing": "1.0.0",
-    "@molecule/app-routing-react-router": "1.0.0",
-    "@molecule/app-storage": "1.0.0",
-    "@molecule/app-storage-localstorage": "1.0.0",
-    "@molecule/app-theme": "1.0.0",
-    "@molecule/app-theme-css-variables": "1.0.0",
-    "@molecule/app-ui": "1.0.0",
-    "@molecule/app-ui-tailwind": "1.0.0",
-    "@molecule/app-video-hls": "1.0.0",
-    "@molecule/app-virtual-scroll": "1.0.0",
-    "@molecule/app-virtual-scroll-tanstack": "1.0.0",
+    "@molecule/app-auth": "1.0.1",
+    "@molecule/app-charts-chartjs": "1.0.1",
+    "@molecule/app-code-editor": "1.0.1",
+    "@molecule/app-code-editor-monaco": "1.0.1",
+    "@molecule/app-command-palette": "1.0.1",
+    "@molecule/app-command-palette-cmdk": "1.0.1",
+    "@molecule/app-drag-drop": "1.0.1",
+    "@molecule/app-drag-drop-dndkit": "1.0.1",
+    "@molecule/app-fonts": "1.0.1",
+    "@molecule/app-fonts-arimo": "1.0.1",
+    "@molecule/app-http": "1.0.1",
+    "@molecule/app-icons": "1.0.1",
+    "@molecule/app-icons-molecule": "1.0.1",
+    "@molecule/app-keyboard-shortcuts": "1.0.1",
+    "@molecule/app-keyboard-shortcuts-hotkeys": "1.0.1",
+    "@molecule/app-maps-leaflet": "1.0.1",
+    "@molecule/app-realtime": "1.0.1",
+    "@molecule/app-realtime-socketio": "1.0.1",
+    "@molecule/app-routing": "1.0.1",
+    "@molecule/app-routing-react-router": "1.0.1",
+    "@molecule/app-storage": "1.0.1",
+    "@molecule/app-storage-localstorage": "1.0.1",
+    "@molecule/app-theme": "1.0.1",
+    "@molecule/app-theme-css-variables": "1.0.1",
+    "@molecule/app-ui": "1.0.1",
+    "@molecule/app-ui-tailwind": "1.0.1",
+    "@molecule/app-video-hls": "1.0.1",
+    "@molecule/app-virtual-scroll": "1.0.1",
+    "@molecule/app-virtual-scroll-tanstack": "1.0.1",
     "@types/node": "26.1.2",
     "@types/react": "19.2.17",
     "@types/react-dom": "19.2.3",
@@ -66,40 +76,46 @@
     "vitest": "4.1.10"
   },
   "peerDependencies": {
-    "@molecule/app-auth": "^1.0.0",
-    "@molecule/app-charts-chartjs": "1.0.0",
-    "@molecule/app-code-editor": "^1.0.0",
-    "@molecule/app-code-editor-monaco": "^1.0.0",
-    "@molecule/app-command-palette": "^1.0.0",
-    "@molecule/app-command-palette-cmdk": "^1.0.0",
-    "@molecule/app-drag-drop": "^1.0.0",
-    "@molecule/app-drag-drop-dndkit": "^1.0.0",
-    "@molecule/app-fonts": "^1.0.0",
-    "@molecule/app-fonts-arimo": "^1.0.0",
-    "@molecule/app-http": "^1.0.0",
-    "@molecule/app-icons": "^1.0.0",
-    "@molecule/app-icons-molecule": "^1.0.0",
-    "@molecule/app-keyboard-shortcuts": "^1.0.0",
-    "@molecule/app-keyboard-shortcuts-hotkeys": "^1.0.0",
-    "@molecule/app-maps-leaflet": "1.0.0",
-    "@molecule/app-realtime": "^1.0.0",
-    "@molecule/app-realtime-socketio": "^1.0.0",
-    "@molecule/app-routing": "^1.0.0",
-    "@molecule/app-routing-react-router": "^1.0.0",
-    "@molecule/app-storage": "^1.0.0",
-    "@molecule/app-storage-localstorage": "^1.0.0",
-    "@molecule/app-styling-tailwind": "^1.0.0",
-    "@molecule/app-theme": "^1.0.0",
-    "@molecule/app-theme-css-variables": "^1.0.0",
-    "@molecule/app-ui": "^1.0.0",
-    "@molecule/app-ui-tailwind": "^1.0.0",
-    "@molecule/app-video-hls": "1.0.0",
-    "@molecule/app-virtual-scroll": "^1.0.0",
-    "@molecule/app-virtual-scroll-tanstack": "^1.0.0",
+    "@molecule/app-auth": "^1.0.1",
+    "@molecule/app-charts": "^1.0.1",
+    "@molecule/app-charts-chartjs": "^1.0.1",
+    "@molecule/app-code-editor": "^1.0.1",
+    "@molecule/app-code-editor-monaco": "^1.0.1",
+    "@molecule/app-command-palette": "^1.0.1",
+    "@molecule/app-command-palette-cmdk": "^1.0.1",
+    "@molecule/app-drag-drop": "^1.0.1",
+    "@molecule/app-drag-drop-dndkit": "^1.0.1",
+    "@molecule/app-fonts": "^1.0.1",
+    "@molecule/app-fonts-arimo": "^1.0.1",
+    "@molecule/app-http": "^1.0.1",
+    "@molecule/app-icons": "^1.0.1",
+    "@molecule/app-icons-molecule": "^1.0.1",
+    "@molecule/app-keyboard-shortcuts": "^1.0.1",
+    "@molecule/app-keyboard-shortcuts-hotkeys": "^1.0.1",
+    "@molecule/app-maps": "^1.0.1",
+    "@molecule/app-maps-leaflet": "^1.0.1",
+    "@molecule/app-realtime": "^1.0.1",
+    "@molecule/app-realtime-socketio": "^1.0.1",
+    "@molecule/app-routing": "^1.0.1",
+    "@molecule/app-routing-react-router": "^1.0.1",
+    "@molecule/app-storage": "^1.0.1",
+    "@molecule/app-storage-localstorage": "^1.0.1",
+    "@molecule/app-styling-tailwind": "^1.0.1",
+    "@molecule/app-theme": "^1.0.1",
+    "@molecule/app-theme-css-variables": "^1.0.1",
+    "@molecule/app-ui": "^1.0.1",
+    "@molecule/app-ui-tailwind": "^1.0.1",
+    "@molecule/app-video": "^1.0.1",
+    "@molecule/app-video-hls": "^1.0.1",
+    "@molecule/app-virtual-scroll": "^1.0.1",
+    "@molecule/app-virtual-scroll-tanstack": "^1.0.1",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
+    "@molecule/app-charts": {
+      "optional": true
+    },
     "@molecule/app-charts-chartjs": {
       "optional": true
     },
@@ -127,6 +143,9 @@
     "@molecule/app-keyboard-shortcuts-hotkeys": {
       "optional": true
     },
+    "@molecule/app-maps": {
+      "optional": true
+    },
     "@molecule/app-maps-leaflet": {
       "optional": true
     },
@@ -136,6 +155,9 @@
     "@molecule/app-realtime-socketio": {
       "optional": true
     },
+    "@molecule/app-video": {
+      "optional": true
+    },
     "@molecule/app-video-hls": {
       "optional": true
     },