marko 5.37.25 → 5.37.26

package/dist/node_modules/@internal/create-readable/index-browser.js

@@ -2,7 +2,6 @@
 var noop = function () {};
 
 module.exports = function (data) {
-
   var transformStream = new TransformStream();
   var writer = transformStream.writable.getWriter();
   var facade = {

package/dist/runtime/html/AsyncStream.js

@@ -232,6 +232,23 @@ var proto = AsyncStream.prototype = {
     };
   },
 
+  toReadable() {
+    return new ReadableStream({
+      async start(ctrl) {
+        const encoder = new TextEncoder();
+        try {
+          for await (const chunk of this) {
+            ctrl.enqueue(encoder.encode(chunk));
+          }
+
+          ctrl.close();
+        } catch (err) {
+          ctrl.error(err);
+        }
+      }
+    });
+  },
+
   sync: function () {
     this._sync = true;
   },

package/index.d.ts

@@ -28,8 +28,28 @@ declare global {
       $global?: Global;
     };
 
+    /** The result of calling `template.render`. */
+    export type RenderedTemplate<
+      Component extends Marko.Component = Marko.Component,
+    > = Promise<RenderResult<Component>> &
+      AsyncIterable<string> & {
+        toReadable(): ReadableStream<Uint8Array<ArrayBufferLike>>;
+        pipe(stream: {
+          write(chunk: string): unknown;
+          end(): unknown;
+          flush?(): void;
+        }): void;
+        toString(): string;
+      };
+
+    /** The result of calling `template.mount`. */
+    export type MountedTemplate<Input = unknown> = {
+      update(input: Marko.TemplateInput<Input>): void;
+      destroy(): void;
+    };
+
     export interface Out<Component extends Marko.Component = Marko.Component>
-      extends PromiseLike<RenderResult<Component>> {
+      extends Marko.RenderedTemplate<Component> {
       /** The underlying ReadableStream Marko is writing into. */
       stream: unknown;
       /** A mutable global object for the current render. */
@@ -42,8 +62,6 @@ declare global {
       write(val: string | void): this;
       /** Write javascript content to be merged with the scripts Marko sends out on the next flush. */
       script(val: string | void): this;
-      /** Returns the currently rendered html content. */
-      toString(): string;
       /** Starts a new async/forked stream. */
       beginAsync(options?: {
         name?: string;
@@ -65,8 +83,6 @@ declare global {
       ): this;
       /** Register a callback executed when the last async out has completed. */
       onLast(listener: (next: () => void) => unknown): this;
-      /** Pipe Marko's stream to another stream. */
-      pipe(stream: unknown): this;
       /** Emits an error on the stream. */
       error(e: Error): this;
       /** Schedules a Marko to flush buffered html to the underlying stream. */
@@ -256,6 +272,13 @@ declare global {
       abstract stream(
         input: Marko.TemplateInput<Input>,
       ): ReadableStream<string> & NodeJS.ReadableStream;
+
+      /** Render and attach the template to a DOM node. */
+      abstract mount(
+        input: Marko.TemplateInput<Input>,
+        reference: Node,
+        position?: "afterbegin" | "afterend" | "beforebegin" | "beforeend",
+      ): Marko.MountedTemplate<typeof input>;
       /** @marko-overload-end */
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marko",
-  "version": "5.37.25",
+  "version": "5.37.26",
   "description": "UI Components + streaming, async, high performance, HTML templating for Node.js and the browser.",
   "keywords": [
     "front-end",

package/src/node_modules/@internal/create-readable/index-browser.js

@@ -2,7 +2,6 @@ var encoder = new TextEncoder();
 var noop = function () {};
 
 module.exports = function (data) {
-   
   var transformStream = new TransformStream();
   var writer = transformStream.writable.getWriter();
   var facade = {

package/src/runtime/html/AsyncStream.js

@@ -232,6 +232,23 @@ var proto = (AsyncStream.prototype = {
     });
   },
 
+  toReadable() {
+    return new ReadableStream({
+      async start(ctrl) {
+        const encoder = new TextEncoder();
+        try {
+          for await (const chunk of this) {
+            ctrl.enqueue(encoder.encode(chunk));
+          }
+
+          ctrl.close();
+        } catch (err) {
+          ctrl.error(err);
+        }
+      },
+    });
+  },
+
   sync: function () {
     this._sync = true;
   },