@atolljs/react-island 0.1.14 → 0.1.15

package/dist/{chunk-Q7NIXFLZ.js → chunk-FMZWTAST.js}

@@ -21,6 +21,7 @@ function Island({
   slots,
   onReady,
   onError,
+  boundary,
   ref,
   ...rest
 }) {
@@ -92,7 +93,8 @@ function Island({
           props: propsRef.current ?? {},
           onEvent: (name, payload) => onEventRef.current?.(name, payload),
           onActivity: () => onActivityRef.current?.(),
-          slots: slotProxy
+          slots: slotProxy,
+          boundary
         });
         if (cancelled) {
           handle.destroy();
@@ -139,6 +141,7 @@ var SHELL_PROP_KEYS = /* @__PURE__ */ new Set([
   "onError",
   "slots",
   "fallback",
+  "boundary",
   "containerProps"
 ]);
 var splitProxyProps = (raw) => {
@@ -201,6 +204,7 @@ function ProxyIsland({
           setReady(true);
         },
         onError: shell.onError,
+        boundary: shell.boundary,
         ...shell.containerProps
       }
     )

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
-import type { IslandAppLike, IslandAppProps, IslandClient, IslandContract, IslandContractEventHandler, IslandContractProps, IslandHandle, IslandWorkerOptions, Mode } from '@atolljs/islands';
+import type { IslandAppLike, IslandAppProps, IslandBoundary, IslandClient, IslandContract, IslandContractEventHandler, IslandContractProps, IslandHandle, IslandWorkerOptions, Mode } from '@atolljs/islands';
 export type { IslandAppLike, IslandAppProps, IslandHandle };
 /** What `app` accepts: the registry name, or a component/def to resolve. */
 export type IslandAppRef<A> = A | string;
@@ -53,10 +53,17 @@ export interface IslandProps<A = string> extends Omit<HTMLAttributes<HTMLDivElem
     onReady?: (island: IslandHandle) => void;
     /** Mount/update errors surface here instead of an unhandled rejection. */
     onError?: (err: unknown) => void;
+    /**
+     * Error boundary — `loading`/`error` render functions (DOM nodes) plus a
+     * retry policy covering mount failures and runtime worker crashes. The
+     * render fns are framework-free; to fall back to JSX, render into a
+     * detached node with createRoot or portal it in yourself.
+     */
+    boundary?: IslandBoundary;
     /** The container div (React 19 ref-as-prop). */
     ref?: Ref<HTMLDivElement>;
 }
-export declare function Island<A = string>({ app, worker, client: clientProp, workerOptions, mode, framework, props, onEvent, onActivity, slots, onReady, onError, ref, ...rest }: IslandProps<A>): ReactElement;
+export declare function Island<A = string>({ app, worker, client: clientProp, workerOptions, mode, framework, props, onEvent, onActivity, slots, onReady, onError, boundary, ref, ...rest }: IslandProps<A>): ReactElement;
 /**
  * Props consumed by a proxy component itself — everything else forwards to
  * the island as its props.
@@ -83,6 +90,8 @@ export interface IslandShellProps {
     onError?: (err: unknown) => void;
     /** Transclusion slots — see IslandProps.slots. */
     slots?: Record<string, ReactNode>;
+    /** Error boundary — see IslandProps.boundary. */
+    boundary?: IslandBoundary;
     /** Rendered while the worker mounts — the lazy-side fallback. */
     fallback?: ReactNode;
     /**

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   index_default,
   islandComponent,
   lazyIsland
-} from "./chunk-Q7NIXFLZ.js";
+} from "./chunk-FMZWTAST.js";
 export {
   Island,
   index_default as default,

package/dist/worker.js

@@ -2,7 +2,7 @@ import {
   Island,
   islandComponent,
   lazyIsland
-} from "./chunk-Q7NIXFLZ.js";
+} from "./chunk-FMZWTAST.js";
 
 // src/worker.ts
 import { createElement } from "react";

package/package.json

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

package/src/index.tsx

@@ -62,6 +62,7 @@ import {
 import type {
   IslandAppLike,
   IslandAppProps,
+  IslandBoundary,
   IslandClient,
   IslandContract,
   IslandContractEventHandler,
@@ -127,6 +128,13 @@ export interface IslandProps<A = string>
   onReady?: (island: IslandHandle) => void;
   /** Mount/update errors surface here instead of an unhandled rejection. */
   onError?: (err: unknown) => void;
+  /**
+   * Error boundary — `loading`/`error` render functions (DOM nodes) plus a
+   * retry policy covering mount failures and runtime worker crashes. The
+   * render fns are framework-free; to fall back to JSX, render into a
+   * detached node with createRoot or portal it in yourself.
+   */
+  boundary?: IslandBoundary;
   /** The container div (React 19 ref-as-prop). */
   ref?: Ref<HTMLDivElement>;
 }
@@ -144,6 +152,7 @@ export function Island<A = string>({
   slots,
   onReady,
   onError,
+  boundary,
   ref,
   ...rest
 }: IslandProps<A>): ReactElement {
@@ -242,6 +251,7 @@ export function Island<A = string>({
           onEvent: (name, payload) => onEventRef.current?.(name, payload),
           onActivity: () => onActivityRef.current?.(),
           slots: slotProxy,
+          boundary,
         });
         if (cancelled) {
           handle.destroy();
@@ -322,6 +332,8 @@ export interface IslandShellProps {
   onError?: (err: unknown) => void;
   /** Transclusion slots — see IslandProps.slots. */
   slots?: Record<string, ReactNode>;
+  /** Error boundary — see IslandProps.boundary. */
+  boundary?: IslandBoundary;
   /** Rendered while the worker mounts — the lazy-side fallback. */
   fallback?: ReactNode;
   /**
@@ -343,6 +355,7 @@ const SHELL_PROP_KEYS: ReadonlySet<string> = new Set([
   'onError',
   'slots',
   'fallback',
+  'boundary',
   'containerProps',
 ]);
 
@@ -445,6 +458,7 @@ function ProxyIsland({
           setReady(true);
         }}
         onError={shell.onError}
+        boundary={shell.boundary}
         {...shell.containerProps}
       />
     </>