@atolljs/react-island 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Henry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,11 +1,15 @@
 # @atolljs/react-island
 
+[![CI](https://github.com/jwhenry3/atolljs/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jwhenry3/atolljs/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jwhenry3/atolljs/graph/badge.svg?branch=main)](https://codecov.io/gh/jwhenry3/atolljs)
+[![Socket Badge](https://badge.socket.dev/npm/package/@atolljs/react-island)](https://badge.socket.dev/npm/package/@atolljs/react-island)
+
 The React shell surface for `@atolljs/islands` — mount a worker-hosted React
 (or imperative proxy-DOM) tree as an ordinary element in a main-thread 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 +115,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.3",
   "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.3",
+    "@atolljs/islands": "0.1.3",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "react-reconciler": "^0.34.0"
@@ -34,5 +34,6 @@
   },
   "bugs": {
     "url": "https://github.com/jwhenry3/atolljs/issues"
-  }
+  },
+  "license": "MIT"
 }

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/reactInstance.ts

@@ -1,3 +1,4 @@
+/// <reference path="./react-reconciler.d.ts" />
 /**
  * The React-runtime half of a React island — `react`, `react-reconciler`
  * and the host config live HERE so a worker bundle whose registry holds only

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'