ovr 4.2.7 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/app/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAe,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,YAAY,CAAC;AAGpB,KAAK,MAAM,GAAG,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,KAAK,GAAG,CAAC,OAAO,CAAC;AAoBhE,qBAAa,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;;IAC7C,gFAAgF;IAChF,GAAG,EAAE,OAAO,CAAC;IAEb,4EAA4E;IAC5E,GAAG,EAAE,GAAG,CAAC;IAET;;;;;;;OAOG;IACH,MAAM,EAAG,CAAC,CAAC;IAEX,oCAAoC;IACpC,KAAK,EAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAM/B,gFAAgF;IAChF,OAAO,UAAiB;IAUxB,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEvB,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAK7B,IAAI,mEAAkB;gBAYrB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;IAU7B,gFAAgF;IAChF,IAAI,MAAM,uBAET;IACD,IAAI,MAAM,CAAC,MAAM,oBAAA,EAGhB;IAED,+FAA+F;IAC/F,IAAI,IAAI,oBAEP;IACD,IAAI,IAAI,CAAC,IAAI,iBAAA,EAGZ;IAED,6BAA6B;IAC7B,IAAI,IAAI,WAEP;IACD,IAAI,IAAI,CAAC,IAAI,QAAA,EAGZ;IAED;;;;;OAKG;IACH,GAAG,CACF,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,IAAI,CAAC,EAAE;QACN;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,gFAAgF;QAChF,OAAO,CAAC,EAAE,WAAW,CAAC;KACtB;IAYF;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM;IAO3C;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAO/B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAOpC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS;IAK1E;;OAEG;IACH,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;IAK9B;;OAEG;IACH,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE;IAK1B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IA6DvC;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM;IAed;;OAEG;IACH,KAAK;IA2BL;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,GAAG;CAUV"}
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/app/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAY,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,YAAY,CAAC;AAGpB,KAAK,MAAM,GAAG,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,KAAK,GAAG,CAAC,OAAO,CAAC;AAoBhE,qBAAa,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;;IAC7C,gFAAgF;IAChF,GAAG,EAAE,OAAO,CAAC;IAEb,4EAA4E;IAC5E,GAAG,EAAE,GAAG,CAAC;IAET;;;;;;;OAOG;IACH,MAAM,EAAG,CAAC,CAAC;IAEX,oCAAoC;IACpC,KAAK,EAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAM/B,gFAAgF;IAChF,OAAO,UAAiB;IAUxB,8BAA8B;IAC9B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEvB,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAK7B,IAAI,mEAAkB;gBASrB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,aAAa,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC;IAU7B,gFAAgF;IAChF,IAAI,MAAM,uBAET;IACD,IAAI,MAAM,CAAC,MAAM,oBAAA,EAGhB;IAED,+FAA+F;IAC/F,IAAI,IAAI,oBAEP;IACD,IAAI,IAAI,CAAC,IAAI,iBAAA,EAGZ;IAED,6BAA6B;IAC7B,IAAI,IAAI,WAEP;IACD,IAAI,IAAI,CAAC,IAAI,QAAA,EAGZ;IAED;;;;;OAKG;IACH,GAAG,CACF,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,IAAI,CAAC,EAAE;QACN;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB,gFAAgF;QAChF,OAAO,CAAC,EAAE,WAAW,CAAC;KACtB;IAYF;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM;IAO3C;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM;IAO/B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAOpC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,GAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAS;IAK1E;;OAEG;IACH,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;IAK9B;;OAEG;IACH,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE;IAK1B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM;IAyCvC;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM;IAed;;OAEG;IACH,KAAK;IA2BL;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,GAAG;CAUV"}
@@ -1,5 +1,5 @@
1
1
  import { Chunk } from "../jsx/chunk/index.js";
2
- import { toGenerator } from "../jsx/index.js";
2
+ import { toStream } from "../jsx/index.js";
3
3
  import { hash } from "../util/hash.js";
4
4
  import { App, } from "./index.js";
5
5
  import { Memo } from "./memo/index.js";
@@ -50,8 +50,6 @@ export class Context {
50
50
  memo = this.#memo.use;
51
51
  /** Check if the `Response` has been built already */
52
52
  #finalized = false;
53
- /** Used across requests */
54
- static #encoder = new TextEncoder();
55
53
  static #headClose = "</head>";
56
54
  static #bodyClose = "</body>";
57
55
  constructor(req, url, trailingSlash, base, error, notFound) {
@@ -182,7 +180,7 @@ export class Context {
182
180
  for (let i = this.#layouts.length - 1; i >= 0; i--) {
183
181
  Page = this.#layouts[i]({ children: Page });
184
182
  }
185
- let gen;
183
+ let stream;
186
184
  if (this.base) {
187
185
  // inject into base
188
186
  const elements = this.base.split(Context.#headClose);
@@ -201,27 +199,13 @@ export class Context {
201
199
  }
202
200
  elements[3] = bodyParts[0];
203
201
  elements.push(Page, Context.#bodyClose + bodyParts[1]);
204
- gen = toGenerator(elements.map((el) => typeof el === "string" ? new Chunk(el, true) : el));
202
+ stream = toStream(elements.map((el) => typeof el === "string" ? new Chunk(el, true) : el));
205
203
  }
206
204
  else {
207
205
  // HTML partial - just use the layouts + page
208
- gen = toGenerator(Page);
206
+ stream = toStream(Page);
209
207
  }
210
- this.html(new ReadableStream({
211
- async pull(c) {
212
- const result = await gen.next();
213
- if (result.done) {
214
- c.close();
215
- gen.return();
216
- return;
217
- }
218
- // need to encode for Node JS (ex: during prerendering)
219
- c.enqueue(Context.#encoder.encode(result.value.value));
220
- },
221
- cancel() {
222
- gen.return();
223
- },
224
- }), status);
208
+ this.html(stream, status);
225
209
  }
226
210
  /**
227
211
  * Generates an etag from a hash of the string provided.
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { jsx, toGenerator, toString, type JSX } from "./jsx/index.js";
1
+ export { jsx, toGenerator, toStream, toString, type JSX } from "./jsx/index.js";
2
2
  export { Chunk } from "./jsx/chunk/index.js";
3
3
  export { Trie, Route } from "./trie/index.js";
4
4
  export { App, type Middleware } from "./app/index.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}
package/dist/index.js CHANGED
@@ -1,4 +1,4 @@
1
- export { jsx, toGenerator, toString } from "./jsx/index.js";
1
+ export { jsx, toGenerator, toStream, toString } from "./jsx/index.js";
2
2
  export { Chunk } from "./jsx/chunk/index.js";
3
3
  export { Trie, Route } from "./trie/index.js";
4
4
  export { App } from "./app/index.js";
@@ -31,7 +31,7 @@ export declare function Fragment(props?: {
31
31
  }): AsyncGenerator<Chunk, void, unknown>;
32
32
  /**
33
33
  * @param element
34
- * @yields Chunks of HTML as the `Element` resolves.
34
+ * @yields `Chunk`s of HTML as the `Element` resolves.
35
35
  */
36
36
  export declare function toGenerator(element: JSX.Element): AsyncGenerator<Chunk, void, unknown>;
37
37
  /**
@@ -46,4 +46,12 @@ export declare function toGenerator(element: JSX.Element): AsyncGenerator<Chunk,
46
46
  * @returns Concatenated HTML
47
47
  */
48
48
  export declare const toString: (element: JSX.Element) => Promise<string>;
49
+ /**
50
+ * `toGenerator` piped into a `ReadableStream`.
51
+ * Use `toGenerator` when possible to avoid the overhead of the stream.
52
+ *
53
+ * @param element
54
+ * @returns `ReadableStream` of HTML
55
+ */
56
+ export declare const toStream: (element: JSX.Element) => ReadableStream<Uint8Array<ArrayBufferLike>>;
49
57
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAIvE,wBAAwB;AACxB,yBAAiB,GAAG,CAAC;IACpB,6BAA6B;IAC7B,UAAiB,iBAAkB,SAAQ,EAAE;KAAG;IAEhD,kBAAkB;IAClB,KAAY,OAAO,GAAG,aAAa,CAClC,YAAY,CACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,SAAS,GACT,MAAM,GACN,QAAQ,CAAC,OAAO,CAAC,GACjB,aAAa,CAAC,OAAO,CAAC,CACxB,CACD,CAAC;CACF;AAED,+BAA+B;AAC/B,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AAuBhD;;;;;;;GAOG;AACH,wBAAuB,GAAG,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EACjD,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,EACzC,KAAK,EAAE,CAAC,wCAmCR;AAED;;;;;GAKG;AACH,wBAAuB,QAAQ,CAAC,KAAK,GAAE;IAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CAAO,wCAErE;AAED;;;GAGG;AACH,wBAAuB,WAAW,CACjC,OAAO,EAAE,GAAG,CAAC,OAAO,GAClB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAyGtC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAU,SAAS,GAAG,CAAC,OAAO,oBACI,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsx/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAIvE,wBAAwB;AACxB,yBAAiB,GAAG,CAAC;IACpB,6BAA6B;IAC7B,UAAiB,iBAAkB,SAAQ,EAAE;KAAG;IAEhD,kBAAkB;IAClB,KAAY,OAAO,GAAG,aAAa,CAClC,YAAY,CACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,IAAI,GACJ,SAAS,GACT,MAAM,GACN,QAAQ,CAAC,OAAO,CAAC,GACjB,aAAa,CAAC,OAAO,CAAC,CACxB,CACD,CAAC;CACF;AAED,+BAA+B;AAC/B,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AAuBhD;;;;;;;GAOG;AACH,wBAAuB,GAAG,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EACjD,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,MAAM,EACzC,KAAK,EAAE,CAAC,wCAmCR;AAED;;;;;GAKG;AACH,wBAAuB,QAAQ,CAAC,KAAK,GAAE;IAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,OAAO,CAAA;CAAO,wCAErE;AAED;;;GAGG;AACH,wBAAuB,WAAW,CACjC,OAAO,EAAE,GAAG,CAAC,OAAO,GAClB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAyGtC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAU,SAAS,GAAG,CAAC,OAAO,oBACI,CAAC;AAKxD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,GAAG,CAAC,OAAO,gDAwB5C,CAAC"}
package/dist/jsx/index.js CHANGED
@@ -69,7 +69,7 @@ export async function* Fragment(props = {}) {
69
69
  }
70
70
  /**
71
71
  * @param element
72
- * @yields Chunks of HTML as the `Element` resolves.
72
+ * @yields `Chunk`s of HTML as the `Element` resolves.
73
73
  */
74
74
  export async function* toGenerator(element) {
75
75
  // modifications
@@ -178,3 +178,32 @@ export async function* toGenerator(element) {
178
178
  * @returns Concatenated HTML
179
179
  */
180
180
  export const toString = async (element) => (await Array.fromAsync(toGenerator(element))).join("");
181
+ /** Single encoder to use across requests. */
182
+ const encoder = new TextEncoder();
183
+ /**
184
+ * `toGenerator` piped into a `ReadableStream`.
185
+ * Use `toGenerator` when possible to avoid the overhead of the stream.
186
+ *
187
+ * @param element
188
+ * @returns `ReadableStream` of HTML
189
+ */
190
+ export const toStream = (element) => {
191
+ const gen = toGenerator(element);
192
+ return new ReadableStream({
193
+ async pull(c) {
194
+ const result = await gen.next();
195
+ if (result.done) {
196
+ c.close();
197
+ gen.return();
198
+ return;
199
+ }
200
+ c.enqueue(
201
+ // need to encode for Node JS (ex: during prerendering)
202
+ // faster than piping through a `TextEncoderStream`
203
+ encoder.encode(result.value.value));
204
+ },
205
+ cancel() {
206
+ gen.return();
207
+ },
208
+ });
209
+ };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "ovr",
3
3
  "description": "Progressive HTML Rendering",
4
- "version": "4.2.7",
4
+ "version": "4.3.0",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
@@ -1,5 +1,5 @@
1
1
  import { Chunk } from "../jsx/chunk/index.js";
2
- import { type JSX, toGenerator } from "../jsx/index.js";
2
+ import { type JSX, toStream } from "../jsx/index.js";
3
3
  import type { Params, Route } from "../trie/index.js";
4
4
  import { hash } from "../util/hash.js";
5
5
  import {
@@ -80,9 +80,6 @@ export class Context<P extends Params = Params> {
80
80
  /** Check if the `Response` has been built already */
81
81
  #finalized = false;
82
82
 
83
- /** Used across requests */
84
- static readonly #encoder = new TextEncoder();
85
-
86
83
  static readonly #headClose = "</head>";
87
84
  static readonly #bodyClose = "</body>";
88
85
 
@@ -242,7 +239,7 @@ export class Context<P extends Params = Params> {
242
239
  Page = this.#layouts[i]!({ children: Page });
243
240
  }
244
241
 
245
- let gen: AsyncGenerator<Chunk, void>;
242
+ let stream: ReadableStream<Uint8Array>;
246
243
 
247
244
  if (this.base) {
248
245
  // inject into base
@@ -265,37 +262,17 @@ export class Context<P extends Params = Params> {
265
262
  elements[3] = bodyParts[0];
266
263
  elements.push(Page, Context.#bodyClose + bodyParts[1]);
267
264
 
268
- gen = toGenerator(
265
+ stream = toStream(
269
266
  elements.map((el) =>
270
267
  typeof el === "string" ? new Chunk(el, true) : el,
271
268
  ),
272
269
  );
273
270
  } else {
274
271
  // HTML partial - just use the layouts + page
275
- gen = toGenerator(Page);
272
+ stream = toStream(Page);
276
273
  }
277
274
 
278
- this.html(
279
- new ReadableStream<Uint8Array>({
280
- async pull(c) {
281
- const result = await gen.next();
282
-
283
- if (result.done) {
284
- c.close();
285
- gen.return();
286
- return;
287
- }
288
-
289
- // need to encode for Node JS (ex: during prerendering)
290
- c.enqueue(Context.#encoder.encode(result.value.value));
291
- },
292
-
293
- cancel() {
294
- gen.return();
295
- },
296
- }),
297
- status,
298
- );
275
+ this.html(stream, status);
299
276
  }
300
277
 
301
278
  /**
package/src/index.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { jsx, toGenerator, toString, type JSX } from "./jsx/index.js";
1
+ export { jsx, toGenerator, toStream, toString, type JSX } from "./jsx/index.js";
2
2
  export { Chunk } from "./jsx/chunk/index.js";
3
3
  export { Trie, Route } from "./trie/index.js";
4
4
  export { App, type Middleware } from "./app/index.js";
package/src/jsx/index.ts CHANGED
@@ -109,7 +109,7 @@ export async function* Fragment(props: { children?: JSX.Element } = {}) {
109
109
 
110
110
  /**
111
111
  * @param element
112
- * @yields Chunks of HTML as the `Element` resolves.
112
+ * @yields `Chunk`s of HTML as the `Element` resolves.
113
113
  */
114
114
  export async function* toGenerator(
115
115
  element: JSX.Element,
@@ -233,3 +233,39 @@ export async function* toGenerator(
233
233
  */
234
234
  export const toString = async (element: JSX.Element) =>
235
235
  (await Array.fromAsync(toGenerator(element))).join("");
236
+
237
+ /** Single encoder to use across requests. */
238
+ const encoder = new TextEncoder();
239
+
240
+ /**
241
+ * `toGenerator` piped into a `ReadableStream`.
242
+ * Use `toGenerator` when possible to avoid the overhead of the stream.
243
+ *
244
+ * @param element
245
+ * @returns `ReadableStream` of HTML
246
+ */
247
+ export const toStream = (element: JSX.Element) => {
248
+ const gen = toGenerator(element);
249
+
250
+ return new ReadableStream<Uint8Array>({
251
+ async pull(c) {
252
+ const result = await gen.next();
253
+
254
+ if (result.done) {
255
+ c.close();
256
+ gen.return();
257
+ return;
258
+ }
259
+
260
+ c.enqueue(
261
+ // need to encode for Node JS (ex: during prerendering)
262
+ // faster than piping through a `TextEncoderStream`
263
+ encoder.encode(result.value.value),
264
+ );
265
+ },
266
+
267
+ cancel() {
268
+ gen.return();
269
+ },
270
+ });
271
+ };