@atolljs/react-island 0.1.1 → 0.1.2

package/README.md

@@ -5,7 +5,7 @@ The React shell surface for `@atolljs/islands` — mount a worker-hosted React
 app. The worker's render loop produces a serialized op stream; this package's
 components own the mount lifecycle and replay it onto a real `div`.
 
-**[Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/#/quickstart)**
+**[Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/quickstart/)**
 
 ## Install
 
@@ -111,9 +111,9 @@ the SAME worker (separate reconcilers, op queues, and pids — one OS thread).
 
 ## Documentation
 
-- [Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/#/quickstart)
-- [Worker islands for React](https://jwhenry3.github.io/atolljs/consumer/#/fw-react/worker-islands)
-- [Worker islands](https://jwhenry3.github.io/atolljs/consumer/#/islands) —
+- [Atoll — package documentation](https://jwhenry3.github.io/atolljs/consumer/quickstart/)
+- [Worker islands for React](https://jwhenry3.github.io/atolljs/consumer/fw-react/worker-islands/)
+- [Worker islands](https://jwhenry3.github.io/atolljs/consumer/islands/) —
   `mountIsland` options, `IslandHandle`, island rules
 - In-repo internals: [`docs/islands.md`](../../docs/islands.md),
   [`docs/islands-worker.md`](../../docs/islands-worker.md)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@atolljs/react-island",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "React shell components for atoll-islands islands — <Island/>, islandComponent, lazyIsland",
-  "homepage": "https://jwhenry3.github.io/atolljs/consumer/#/quickstart",
+  "homepage": "https://jwhenry3.github.io/atolljs/consumer/quickstart/",
   "type": "module",
   "exports": {
     ".": "./src/index.tsx",
@@ -16,8 +16,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
-    "@atolljs/core": "0.1.1",
-    "@atolljs/islands": "0.1.1",
+    "@atolljs/core": "0.1.2",
+    "@atolljs/islands": "0.1.2",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "react-reconciler": "^0.34.0"

package/src/index.tsx

@@ -82,8 +82,13 @@ export interface IslandProps<A = string>
    */
   worker?: (() => Worker) | URL;
   client?: IslandClient;
-  /** Extra pool options — concurrency, taskTimeout, respawn… (poolSize stays 1). */
-  workerOptions?: IslandWorkerOptions;
+  /**
+   * Extra pool options — concurrency, taskTimeout, respawn… (poolSize stays
+   * 1). `doorbell: false` builds the shorthand client message-only — no
+   * SharedArrayBuffer, no COOP/COEP requirement (same as `mode: 'poll'` on
+   * a direct `mountIsland` shorthand mount).
+   */
+  workerOptions?: IslandWorkerOptions & { doorbell?: boolean };
   /**
    * Initial flush mode — 'push' (default) drives op replay off the
    * shared-memory doorbell (needs cross-origin isolation); 'poll' drains on
@@ -272,7 +277,8 @@ export interface IslandShellProps {
   /** How to reach the worker — see IslandProps.worker/client. */
   worker?: (() => Worker) | URL;
   client?: IslandClient;
-  workerOptions?: IslandWorkerOptions;
+  /** See IslandProps.workerOptions — `doorbell` included. */
+  workerOptions?: IslandWorkerOptions & { doorbell?: boolean };
   /** Initial flush mode — see IslandProps.mode. */
   mode?: Mode;
   /** Island → shell channel: every `emit` op lands here. */
@@ -323,12 +329,14 @@ const splitProxyProps = (
 
 /* ── Shared proxy implementation ─────────────────────────────────────────── */
 
-type LazyModule<A> = A | { default: A } | { app: A; worker?: (() => Worker) | URL };
+type LazyModule<A> = A | { default: A } | { app: A | string; worker?: (() => Worker) | URL };
 
 /** Cached state for a lazy loader. One cache entry per loader function. */
 interface LazyState {
   promise: Promise<unknown>;
-  value?: IslandAppLike;
+  // Contract modules may carry a registry-key string instead of the app —
+  // `Island`'s `app` prop accepts `IslandAppRef` (name or reference).
+  value?: IslandAppLike | string;
   worker?: (() => Worker) | URL;
   error?: unknown;
 }
@@ -337,7 +345,7 @@ const lazyCache = new WeakMap<() => Promise<LazyModule<IslandAppLike>>, LazyStat
 
 /** Resolve a lazy module through Suspense; reused across re-renders. */
 function useLazyApp(loader: () => Promise<LazyModule<IslandAppLike>>): {
-  app?: IslandAppLike;
+  app?: IslandAppLike | string;
   worker?: (() => Worker) | URL;
 } {
   let state = lazyCache.get(loader);

package/src/worker.ts

@@ -97,9 +97,10 @@ export interface ReactPolyWorkerRegistry {
   /**
    * Name → React component (or `{ imperative }` app) registry, mirroring
    * `definePolyWorker({ apps })`. Components pass through `reactIslandApp`;
-   * imperative defs register as-is.
+   * imperative defs and already-wrapped apps (e.g. `reactIsland()` results)
+   * register as-is.
    */
-  apps: Record<string, AnyComponent | ImperativeIslandApp>;
+  apps: Record<string, AnyComponent | ImperativeIslandApp | RenderedIslandApp>;
   /** Doorbell contract override — forwarded to `definePolyWorker`. */
   sharedMemory?: SharedMemory<DoorbellSpec>;
 }
@@ -129,7 +130,7 @@ export function defineReactPolyWorker(
  * component (or `{ imperative }` app), the isolated-bundle host shape.
  */
 export function defineReactMonoWorker(
-  app: AnyComponent | ImperativeIslandApp,
+  app: AnyComponent | ImperativeIslandApp | RenderedIslandApp,
   options?: { sharedMemory?: SharedMemory<DoorbellSpec> },
 ): WorkerDefinition<DoorbellSpec, IslandWorkerMethods> {
   return typeof app === 'function'