fibrae 0.1.1 → 0.1.2

package/dist/components.d.ts

@@ -1,13 +1,21 @@
-import * as Effect from "effect/Effect";
 import * as Context from "effect/Context";
-import { type VElement } from "./shared.js";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import { type ComponentError, type VElement } from "./shared.js";
 declare const ErrorBoundaryChannel_base: Context.TagClass<ErrorBoundaryChannel, "ErrorBoundaryChannel", {
+    /** Report an error to this boundary. Used by event handlers and stream subscriptions. */
     readonly reportError: (error: unknown) => Effect.Effect<void, never, never>;
+    /** Optional unique identifier for this boundary (for debugging/logging) */
+    readonly boundaryId?: string;
 }>;
 /**
- * Error boundary channel - a Deferred that async errors can fail to trigger fallback.
+ * Error boundary channel - used by ErrorBoundary for async error reporting.
  * Created by ErrorBoundary and provided via context to children.
- * Children (event handlers, stream subscriptions) can fail this to report errors.
+ * Children (event handlers, stream subscriptions) can report errors to this channel.
+ *
+ * The channel includes:
+ * - reportError: for async errors (event handlers, streams)
+ * - boundaryId: optional unique identifier for this boundary (for debugging)
  */
 export declare class ErrorBoundaryChannel extends ErrorBoundaryChannel_base {
 }
@@ -29,12 +37,38 @@ export declare const Suspense: (props: {
     children?: VElement | VElement[];
 }) => VElement;
 /**
- * ErrorBoundary - catches errors from children and renders fallback.
- * Returns a special VElement that renderVElementToDOM handles specially.
+ * Creates an Effect-native error boundary around children.
+ *
+ * Returns a `Stream<VElement, ComponentError, never>` that can be piped with
+ * `Stream.catchTags` for fully typed error handling.
+ *
+ * @example
+ * ```tsx
+ * // Create a boundary with typed error handlers as a wrapper component
+ * const SafeApp = () => ErrorBoundary(<App />).pipe(
+ *   Stream.catchTags({
+ *     RenderError: (e) => Stream.succeed(<div>Render failed: {e.componentName}</div>),
+ *     StreamError: (e) => Stream.succeed(<div>Stream failed: {e.phase}</div>),
+ *     EventHandlerError: (e) => Stream.succeed(<div>Event {e.eventType} failed</div>),
+ *   })
+ * );
+ *
+ * // Use it like any other component
+ * <SafeApp />
+ * ```
+ *
+ * **How it works:**
+ * 1. `ErrorBoundary()` returns a Stream that first emits a BOUNDARY marker element
+ * 2. The renderer detects this marker and sets up error handling
+ * 3. If any error occurs in the subtree, the Stream fails with that ComponentError
+ * 4. `Stream.catchTags` catches the error and produces a fallback Stream
+ * 5. The fallback VElement is rendered in place of the failed content
+ *
+ * **Nesting:** Boundaries nest naturally - inner boundary catches first, unhandled
+ * errors propagate to outer boundary following Effect/Stream error propagation rules.
+ *
+ * @param children - The VElement(s) to wrap in an error boundary
+ * @returns Stream<VElement, ComponentError, never> - pipe with Stream.catchTags to handle errors
  */
-export declare const ErrorBoundary: (props: {
-    fallback: VElement;
-    onError?: (cause: unknown) => void;
-    children?: VElement | VElement[];
-}) => VElement;
+export declare const ErrorBoundary: (children: VElement | VElement[]) => Stream.Stream<VElement, ComponentError, never>;
 export {};

package/dist/components.js

@@ -1,13 +1,18 @@
-import * as Effect from "effect/Effect";
 import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
 import {} from "./shared.js";
 // =============================================================================
 // Error Boundary Channel
 // =============================================================================
 /**
- * Error boundary channel - a Deferred that async errors can fail to trigger fallback.
+ * Error boundary channel - used by ErrorBoundary for async error reporting.
  * Created by ErrorBoundary and provided via context to children.
- * Children (event handlers, stream subscriptions) can fail this to report errors.
+ * Children (event handlers, stream subscriptions) can report errors to this channel.
+ *
+ * The channel includes:
+ * - reportError: for async errors (event handlers, streams)
+ * - boundaryId: optional unique identifier for this boundary (for debugging)
  */
 export class ErrorBoundaryChannel extends Context.Tag("ErrorBoundaryChannel")() {
 }
@@ -45,27 +50,76 @@ export const Suspense = (props) => {
         },
     };
 };
+// =============================================================================
+// Effect-Native Error Boundary
+// =============================================================================
+// Counter for generating unique boundary IDs
+let boundaryIdCounter = 0;
 /**
- * ErrorBoundary - catches errors from children and renders fallback.
- * Returns a special VElement that renderVElementToDOM handles specially.
+ * Normalize children to an array of VElements.
  */
-export const ErrorBoundary = (props) => {
-    const childrenArray = Array.isArray(props.children)
-        ? props.children
-        : props.children
-            ? [props.children]
-            : [];
+const normalizeChildren = (children) => Array.isArray(children) ? children : [children];
+/**
+ * Creates an Effect-native error boundary around children.
+ *
+ * Returns a `Stream<VElement, ComponentError, never>` that can be piped with
+ * `Stream.catchTags` for fully typed error handling.
+ *
+ * @example
+ * ```tsx
+ * // Create a boundary with typed error handlers as a wrapper component
+ * const SafeApp = () => ErrorBoundary(<App />).pipe(
+ *   Stream.catchTags({
+ *     RenderError: (e) => Stream.succeed(<div>Render failed: {e.componentName}</div>),
+ *     StreamError: (e) => Stream.succeed(<div>Stream failed: {e.phase}</div>),
+ *     EventHandlerError: (e) => Stream.succeed(<div>Event {e.eventType} failed</div>),
+ *   })
+ * );
+ *
+ * // Use it like any other component
+ * <SafeApp />
+ * ```
+ *
+ * **How it works:**
+ * 1. `ErrorBoundary()` returns a Stream that first emits a BOUNDARY marker element
+ * 2. The renderer detects this marker and sets up error handling
+ * 3. If any error occurs in the subtree, the Stream fails with that ComponentError
+ * 4. `Stream.catchTags` catches the error and produces a fallback Stream
+ * 5. The fallback VElement is rendered in place of the failed content
+ *
+ * **Nesting:** Boundaries nest naturally - inner boundary catches first, unhandled
+ * errors propagate to outer boundary following Effect/Stream error propagation rules.
+ *
+ * @param children - The VElement(s) to wrap in an error boundary
+ * @returns Stream<VElement, ComponentError, never> - pipe with Stream.catchTags to handle errors
+ */
+export const ErrorBoundary = (children) => {
+    const boundaryId = `boundary-${++boundaryIdCounter}`;
+    const childrenArray = normalizeChildren(children);
     if (childrenArray.length === 0) {
-        throw new Error("ErrorBoundary requires at least one child");
+        return Stream.die("ErrorBoundary() requires at least one child");
     }
-    // Return a special marker element that renderVElementToDOM will handle
-    return {
-        type: "ERROR_BOUNDARY",
-        props: {
-            fallback: props.fallback,
-            onError: props.onError,
-            children: childrenArray,
-        },
-    };
+    // Create a stream that:
+    // 1. Emits the BOUNDARY marker with an onError callback
+    // 2. When onError is called, the stream fails with that error
+    // 3. Stream stays open until error or unmount
+    return Stream.async((emit) => {
+        // Create the BOUNDARY marker with error callback wired to stream failure
+        const boundaryElement = {
+            type: "BOUNDARY",
+            props: {
+                children: childrenArray,
+                boundaryId,
+                // When renderer detects an error in subtree, it calls this
+                onError: (error) => {
+                    void emit.fail(error);
+                },
+            },
+        };
+        // Emit the marker immediately
+        void emit.single(boundaryElement);
+        // Stream stays open - it will fail when onError is called
+        // or be cancelled when the component unmounts
+    });
 };
 //# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -1 +1 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAiB,MAAM,aAAa,CAAC;AAE5C,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAK1E;CAAG;AAEN,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAIxB,EAAY,EAAE;IACb,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC,KAAK,CAAC,QAAQ;YACd,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAClB,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,IAAI,EAAE,UAAmB;QACzB,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;YACjC,QAAQ,EAAE,aAAa;SACxB;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAI7B,EAAY,EAAE;IACb,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC,KAAK,CAAC,QAAQ;YACd,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAClB,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,IAAI,EAAE,gBAAyB;QAC/B,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,aAAa;SACxB;KACF,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAsC,MAAM,aAAa,CAAC;AAEjE,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,EAQ1E;CAAG;AAEN,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAIxB,EAAY,EAAE;IACb,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,KAAK,CAAC,QAAQ;QAChB,CAAC,CAAC,KAAK,CAAC,QAAQ;YACd,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAClB,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,IAAI,EAAE,UAAmB;QACzB,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;YACjC,QAAQ,EAAE,aAAa;SACxB;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,gFAAgF;AAChF,+BAA+B;AAC/B,gFAAgF;AAEhF,6CAA6C;AAC7C,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,QAA+B,EAAc,EAAE,CACxE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,QAA+B,EACiB,EAAE;IAClD,MAAM,UAAU,GAAG,YAAY,EAAE,iBAAiB,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IACnE,CAAC;IAED,wBAAwB;IACxB,wDAAwD;IACxD,8DAA8D;IAC9D,8CAA8C;IAC9C,OAAO,MAAM,CAAC,KAAK,CAA2B,CAAC,IAAI,EAAE,EAAE;QACrD,yEAAyE;QACzE,MAAM,eAAe,GAAa;YAChC,IAAI,EAAE,UAAmB;YACzB,KAAK,EAAE;gBACL,QAAQ,EAAE,aAAa;gBACvB,UAAU;gBACV,2DAA2D;gBAC3D,OAAO,EAAE,CAAC,KAAqB,EAAE,EAAE;oBACjC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;aACF;SACF,CAAC;QAEF,8BAA8B;QAC9B,KAAK,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAElC,0DAA0D;QAC1D,8CAA8C;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/dom.d.ts

@@ -1,4 +1,6 @@
+import * as Effect from "effect/Effect";
 import { FibraeRuntime } from "./runtime.js";
+import { EventHandlerError } from "./shared.js";
 /**
  * Property update strategies for different DOM properties
  */
@@ -12,5 +14,6 @@ export declare const setDomProperty: (el: HTMLElement, name: string, value: unkn
 /**
  * Attach event listeners to a DOM element.
  * Uses runForkWithRuntime to get the full application context.
+ * When an event handler Effect fails, converts to EventHandlerError and calls onError callback.
  */
-export declare const attachEventListeners: (el: HTMLElement, props: Record<string, unknown>, runtime: FibraeRuntime) => void;
+export declare const attachEventListeners: (el: HTMLElement, props: Record<string, unknown>, runtime: FibraeRuntime, onError?: (error: EventHandlerError) => Effect.Effect<unknown, never, unknown>) => void;

package/dist/dom.js

@@ -1,5 +1,7 @@
 import * as Effect from "effect/Effect";
+import * as Cause from "effect/Cause";
 import { FibraeRuntime, runForkWithRuntime } from "./runtime.js";
+import { EventHandlerError } from "./shared.js";
 // =============================================================================
 // DOM Property Handling
 // =============================================================================
@@ -48,8 +50,9 @@ export const setDomProperty = (el, name, value) => {
 /**
  * Attach event listeners to a DOM element.
  * Uses runForkWithRuntime to get the full application context.
+ * When an event handler Effect fails, converts to EventHandlerError and calls onError callback.
  */
-export const attachEventListeners = (el, props, runtime) => {
+export const attachEventListeners = (el, props, runtime, onError) => {
     for (const [key, handler] of Object.entries(props)) {
         if (isEvent(key) && typeof handler === "function") {
             const eventType = key.toLowerCase().substring(2);
@@ -57,7 +60,17 @@ export const attachEventListeners = (el, props, runtime) => {
                 const result = handler(event);
                 if (Effect.isEffect(result)) {
                     // Use runForkWithRuntime to get the full application context
-                    const effectWithErrorHandling = result.pipe(Effect.catchAllCause((cause) => Effect.logError("Event handler error", cause)));
+                    const effectWithErrorHandling = result.pipe(Effect.catchAllCause((cause) => {
+                        // Convert to EventHandlerError with the event type
+                        const error = new EventHandlerError({
+                            cause: Cause.squash(cause),
+                            eventType,
+                        });
+                        if (onError) {
+                            return onError(error);
+                        }
+                        return Effect.logError("Event handler error", error);
+                    }));
                     runForkWithRuntime(runtime)(effectWithErrorHandling);
                 }
             });

package/dist/dom.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"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"}

package/dist/fiber-render.d.ts

@@ -25,9 +25,11 @@ import { FibraeRuntime } from "./runtime.js";
  */
 export declare const renderFiber: (element: VElement, container: HTMLElement) => Effect.Effect<never, never, FibraeRuntime>;
 /**
- * Hydrate an existing DOM tree with a VElement tree.
+ * Hydrate an existing DOM tree by building a fiber tree that references
+ * the existing DOM nodes. This enables event handlers and reactivity
+ * without replacing the DOM.
  *
- * This walks the existing DOM and builds a fiber tree that matches it,
- * enabling reactive updates without re-creating the DOM.
+ * Uses cursor-based DOM walking (like React) to match VElement tree
+ * against existing DOM, skipping whitespace-only text nodes and comments.
  */
 export declare const hydrateFiber: (element: VElement, container: HTMLElement) => Effect.Effect<never, unknown, FibraeRuntime>;