@solidjs/web 2.0.0-beta.25 → 2.0.0-beta.26

package/server-functions/dist/client.cjs

@@ -219,15 +219,15 @@ class ChunkReader {
     }
   }
   async next() {
-    if (this.buffer.length === 0) {
+    while (this.buffer.length < 12) {
       if (this.done) {
-        return {
+        if (this.buffer.length === 0) return {
           done: true,
           value: undefined
         };
+        throw new Error("Malformed server function stream.");
       }
       await this.readChunk();
-      return await this.next();
     }
     const head = new TextDecoder().decode(this.buffer.subarray(1, 11));
     const bytes = Number.parseInt(head, 16);

package/server-functions/dist/client.js

@@ -217,15 +217,15 @@ class ChunkReader {
     }
   }
   async next() {
-    if (this.buffer.length === 0) {
+    while (this.buffer.length < 12) {
       if (this.done) {
-        return {
+        if (this.buffer.length === 0) return {
           done: true,
           value: undefined
         };
+        throw new Error("Malformed server function stream.");
       }
       await this.readChunk();
-      return await this.next();
     }
     const head = new TextDecoder().decode(this.buffer.subarray(1, 11));
     const bytes = Number.parseInt(head, 16);

package/server-functions/dist/server.cjs

@@ -249,15 +249,15 @@ class ChunkReader {
     }
   }
   async next() {
-    if (this.buffer.length === 0) {
+    while (this.buffer.length < 12) {
       if (this.done) {
-        return {
+        if (this.buffer.length === 0) return {
           done: true,
           value: undefined
         };
+        throw new Error("Malformed server function stream.");
       }
       await this.readChunk();
-      return await this.next();
     }
     const head = new TextDecoder().decode(this.buffer.subarray(1, 11));
     const bytes = Number.parseInt(head, 16);

package/server-functions/dist/server.js

@@ -247,15 +247,15 @@ class ChunkReader {
     }
   }
   async next() {
-    if (this.buffer.length === 0) {
+    while (this.buffer.length < 12) {
       if (this.done) {
-        return {
+        if (this.buffer.length === 0) return {
           done: true,
           value: undefined
         };
+        throw new Error("Malformed server function stream.");
       }
       await this.readChunk();
-      return await this.next();
     }
     const head = new TextDecoder().decode(this.buffer.subarray(1, 11));
     const bytes = Number.parseInt(head, 16);

package/types/frames/client.d.ts

@@ -1,4 +1,4 @@
-export { createFrame, createFrameHost, createFrameInsertable, FRAME_APPLIED_EVENT } from "./frame-client.js";
+export { createFrame, createFrameHost, createFrameElement, FRAME_APPLIED_EVENT } from "./frame-client.js";
 export { FRAME_STREAM_HEADER, applyFrameResponse, isFrameStreamResponse, createServerComponentHandler } from "./frame-transport.js";
 export { createJSONDataTable } from "./serializer.js";
 export declare function getFrameHost(): any;

package/types/frames/frame-client.d.ts

@@ -41,15 +41,6 @@ export type FrameChunk =
       inlineStyles?: { id: string; content?: string; attrs?: Record<string, string> }[];
     }
   | { type: "slot"; id: string; version: number; key: string; args: Record<string, unknown> }
-  | { type: "template"; id: string; version: number; key: string; html: string; fields: string[] }
-  | {
-      type: "block";
-      id: string;
-      version: number;
-      key: string;
-      template: string;
-      values: unknown[];
-    }
   | { type: "complete"; id: string; version: number }
   | { type: "error"; id: string; version: number; key?: string; error: unknown };
 
@@ -170,7 +161,7 @@ export interface FrameHostOptions {
 
 export function createFrameHost(options?: FrameHostOptions): FrameHost;
 
-/** Options for `createFrame` / `createFrameInsertable`. */
+/** Options for `createFrame` / `createFrameElement`. */
 export interface FrameOptions {
   /** Register with this host under `id`, receiving routed/buffered chunks. */
   host?: FrameHost;
@@ -194,29 +185,44 @@ export interface FrameOptions {
    * streamed chunks).
    */
   ownerScope?<T>(fn: () => T): T;
+  /**
+   * Boundary-driven segment reveal. When present, `#revealSegment` hands the
+   * placeholder seam to this hook instead of swapping imperatively: the binding
+   * reconstructs a client `<Loading>` there — `fallback` is the placeholder's
+   * own template content (shown while holding), `content()` materializes the
+   * segment and renders its client fills INSIDE the boundary so their readiness
+   * gates the reveal — and inserts it before `before`. An unboundaried async
+   * fill suspends up to that boundary and is covered instead of orphaned; one
+   * boundary per revealed segment, i.e. per author-placed `<Loading>`. Omit it
+   * for the framework-agnostic imperative swap (no reactive reveal).
+   */
+  reveal?(seam: { before: Node; fallback: Node[]; content: () => Node | DocumentFragment }): void;
 }
 
-/** A frame rendering into an element boundary. */
+/**
+ * A frame rendering into an EXISTING element boundary. Pass `adopt: true` for
+ * the document-SSR path: the element already holds server-rendered content,
+ * so the first apply morphs against it and slots sync immediately (hydration
+ * attach), claiming their server-rendered DOM — a document boot needs no
+ * chunk.
+ */
 export function createFrame(boundary: Element, options?: FrameOptions): Frame;
 
+/** The default boundary/region element tag and its id attribute — the DOM
+ *  contract the producer emits at t=0 and the consumer creates/adopts. */
+export const FRAME_TAG: "dx-frame";
+export const FRAME_ID_ATTR: "data-fid";
+
 /**
- * A branded frame-insertable value: the client runtime's `insert` recognizes
- * it (registered `$$FRAME` symbol) and calls the mount handler the value
- * carries — a comment range is established at the insertion point and a
- * host-registered frame binds to it. One static mount per value; lifecycle
- * belongs to the creator via `dispose()` (register it with your owner's
- * cleanup).
+ * Create a boundary/region ELEMENT and bind a host-registered frame to it.
+ * The frame mounts INTO the element (server content is its children, morphed
+ * in place). Because the boundary is a real node, `insert` places the
+ * returned `element` in any position — single, array, or fragment — with no
+ * special-casing. One frame per element; lifecycle belongs to the creator via
+ * `dispose()` (register it with your owner's cleanup).
  */
-export function createFrameInsertable(options: FrameOptions): {
-  readonly frame: Frame | null;
+export function createFrameElement(options: FrameOptions): {
+  readonly element: Element;
+  readonly frame: Frame;
   dispose(): void;
 };
-
-/**
- * Binds a frame to an EXISTING marker range — the document-SSR adoption
- * path: the page already holds the server-rendered boundary between
- * `frame:<id>:start`/`:end` comments; the frame constructed over it treats
- * that content as its own (first stream morphs rather than materializes)
- * and slots sync immediately, claiming their server-rendered DOM.
- */
-export function adoptFrameRange(start: Comment, end: Comment, options?: FrameOptions): Frame;

package/types-cjs/frames/client.d.cts

@@ -1,4 +1,4 @@
-export { createFrame, createFrameHost, createFrameInsertable, FRAME_APPLIED_EVENT } from "./frame-client.cjs";
+export { createFrame, createFrameHost, createFrameElement, FRAME_APPLIED_EVENT } from "./frame-client.cjs";
 export { FRAME_STREAM_HEADER, applyFrameResponse, isFrameStreamResponse, createServerComponentHandler } from "./frame-transport.cjs";
 export { createJSONDataTable } from "./serializer.cjs";
 export declare function getFrameHost(): any;

package/types-cjs/frames/frame-client.d.cts

@@ -41,15 +41,6 @@ export type FrameChunk =
       inlineStyles?: { id: string; content?: string; attrs?: Record<string, string> }[];
     }
   | { type: "slot"; id: string; version: number; key: string; args: Record<string, unknown> }
-  | { type: "template"; id: string; version: number; key: string; html: string; fields: string[] }
-  | {
-      type: "block";
-      id: string;
-      version: number;
-      key: string;
-      template: string;
-      values: unknown[];
-    }
   | { type: "complete"; id: string; version: number }
   | { type: "error"; id: string; version: number; key?: string; error: unknown };
 
@@ -170,7 +161,7 @@ export interface FrameHostOptions {
 
 export function createFrameHost(options?: FrameHostOptions): FrameHost;
 
-/** Options for `createFrame` / `createFrameInsertable`. */
+/** Options for `createFrame` / `createFrameElement`. */
 export interface FrameOptions {
   /** Register with this host under `id`, receiving routed/buffered chunks. */
   host?: FrameHost;
@@ -194,29 +185,44 @@ export interface FrameOptions {
    * streamed chunks).
    */
   ownerScope?<T>(fn: () => T): T;
+  /**
+   * Boundary-driven segment reveal. When present, `#revealSegment` hands the
+   * placeholder seam to this hook instead of swapping imperatively: the binding
+   * reconstructs a client `<Loading>` there — `fallback` is the placeholder's
+   * own template content (shown while holding), `content()` materializes the
+   * segment and renders its client fills INSIDE the boundary so their readiness
+   * gates the reveal — and inserts it before `before`. An unboundaried async
+   * fill suspends up to that boundary and is covered instead of orphaned; one
+   * boundary per revealed segment, i.e. per author-placed `<Loading>`. Omit it
+   * for the framework-agnostic imperative swap (no reactive reveal).
+   */
+  reveal?(seam: { before: Node; fallback: Node[]; content: () => Node | DocumentFragment }): void;
 }
 
-/** A frame rendering into an element boundary. */
+/**
+ * A frame rendering into an EXISTING element boundary. Pass `adopt: true` for
+ * the document-SSR path: the element already holds server-rendered content,
+ * so the first apply morphs against it and slots sync immediately (hydration
+ * attach), claiming their server-rendered DOM — a document boot needs no
+ * chunk.
+ */
 export function createFrame(boundary: Element, options?: FrameOptions): Frame;
 
+/** The default boundary/region element tag and its id attribute — the DOM
+ *  contract the producer emits at t=0 and the consumer creates/adopts. */
+export const FRAME_TAG: "dx-frame";
+export const FRAME_ID_ATTR: "data-fid";
+
 /**
- * A branded frame-insertable value: the client runtime's `insert` recognizes
- * it (registered `$$FRAME` symbol) and calls the mount handler the value
- * carries — a comment range is established at the insertion point and a
- * host-registered frame binds to it. One static mount per value; lifecycle
- * belongs to the creator via `dispose()` (register it with your owner's
- * cleanup).
+ * Create a boundary/region ELEMENT and bind a host-registered frame to it.
+ * The frame mounts INTO the element (server content is its children, morphed
+ * in place). Because the boundary is a real node, `insert` places the
+ * returned `element` in any position — single, array, or fragment — with no
+ * special-casing. One frame per element; lifecycle belongs to the creator via
+ * `dispose()` (register it with your owner's cleanup).
  */
-export function createFrameInsertable(options: FrameOptions): {
-  readonly frame: Frame | null;
+export function createFrameElement(options: FrameOptions): {
+  readonly element: Element;
+  readonly frame: Frame;
   dispose(): void;
 };
-
-/**
- * Binds a frame to an EXISTING marker range — the document-SSR adoption
- * path: the page already holds the server-rendered boundary between
- * `frame:<id>:start`/`:end` comments; the frame constructed over it treats
- * that content as its own (first stream morphs rather than materializes)
- * and slots sync immediately, claiming their server-rendered DOM.
- */
-export function adoptFrameRange(start: Comment, end: Comment, options?: FrameOptions): Frame;