@effing/satori 0.9.0 → 0.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 > Part of the [**Effing**](../../README.md) family — programmatic video creation with TypeScript.
 
-A thin wrapper around [Satori](https://github.com/vercel/satori) that renders JSX to PNG buffers. Includes built-in emoji support with multiple emoji styles.
+A thin wrapper around [Satori](https://github.com/vercel/satori) that renders JSX to PNG buffers. Includes built-in emoji support with multiple emoji styles, standalone SVG/rasterization functions, and an optional worker pool for parallelized rendering.
 
 ## Installation
 
@@ -12,6 +12,12 @@ A thin wrapper around [Satori](https://github.com/vercel/satori) that renders JS
 npm install @effing/satori
 ```
 
+For worker pool support (optional):
+
+```bash
+npm install @effing/satori react tinypool
+```
+
 ## Quick Start
 
 ```typescript
@@ -62,6 +68,8 @@ JSX → Satori → SVG → Resvg → PNG Buffer
 1. **Satori** converts JSX with CSS-like styles to SVG
 2. **Resvg** renders the SVG to a PNG buffer
 
+The pipeline is also available as standalone functions (`svgFromSatori` and `rasterizeSvg`) for cases where you need the intermediate SVG or want to rasterize SVGs from other sources.
+
 ### Font Loading
 
 Satori requires font data to render text. You must provide fonts as ArrayBuffers:
@@ -90,6 +98,28 @@ The package automatically loads emoji SVGs from CDNs. Supported styles:
 | `fluent`     | Microsoft Fluent Emoji (color) |
 | `fluentFlat` | Microsoft Fluent Emoji (flat)  |
 
+### Worker Pool
+
+When rendering many frames (e.g. for animations), you can parallelize rendering across CPU cores using the worker pool. This can provide up to 4x speedups depending on render complexity.
+
+The pool handles React element serialization automatically — you pass JSX in and get PNG/SVG buffers out, just like the single-threaded API.
+
+```typescript
+import { createSatoriPool } from "@effing/satori/pool";
+
+const pool = createSatoriPool({ maxThreads: 4 });
+
+const png = await pool.renderToPng(
+  <div style={{ fontSize: 48 }}>Hello from a worker!</div>,
+  { width: 800, height: 600, fonts }
+);
+
+// Clean up when done
+await pool.destroy();
+```
+
+**Peer dependencies:** The pool and serde sub-paths require `react` and `tinypool` to be installed. They are listed as optional peer dependencies so the main `@effing/satori` entry works without them.
+
 ## API Overview
 
 ### `pngFromSatori(template, options)`
@@ -99,11 +129,30 @@ Render a JSX template to a PNG buffer.
 ```typescript
 function pngFromSatori(
   template: React.ReactNode,
-  options: PngFromSatoriOptions,
+  options: SatoriOptions,
 ): Promise<Buffer>;
 ```
 
-**Options:**
+### `svgFromSatori(template, options)`
+
+Render a JSX template to an SVG string.
+
+```typescript
+function svgFromSatori(
+  template: React.ReactNode,
+  options: SatoriOptions,
+): Promise<string>;
+```
+
+### `rasterizeSvg(svg)`
+
+Rasterize an SVG string to a PNG buffer using Resvg.
+
+```typescript
+function rasterizeSvg(svg: string): Buffer;
+```
+
+### Options
 
 | Option   | Type         | Required | Description                        |
 | -------- | ------------ | -------- | ---------------------------------- |
@@ -112,6 +161,38 @@ function pngFromSatori(
 | `fonts`  | `FontData[]` | Yes      | Font data for text rendering       |
 | `emoji`  | `EmojiStyle` | No       | Emoji style (default: `"twemoji"`) |
 
+### `@effing/satori/pool`
+
+#### `createSatoriPool(options?)`
+
+Create a worker pool for parallelized rendering.
+
+```typescript
+function createSatoriPool(options?: SatoriPoolOptions): SatoriPool;
+```
+
+**Pool options:**
+
+| Option       | Type     | Default            | Description            |
+| ------------ | -------- | ------------------ | ---------------------- |
+| `minThreads` | `number` | `1`                | Minimum worker threads |
+| `maxThreads` | `number` | `os.cpus().length` | Maximum worker threads |
+
+**`SatoriPool` methods:**
+
+- `renderToPng(element, options)` — Render JSX to PNG buffer
+- `renderToSvg(element, options)` — Render JSX to SVG string
+- `rasterizeSvgToPng(svg, options?)` — Rasterize SVG to PNG buffer
+- `destroy()` — Shut down the pool
+
+### `@effing/satori/serde`
+
+React element serialization for cross-thread communication. Used internally by the pool, but available for custom worker setups.
+
+- `expandElement(node)` — Recursively flatten function components to intrinsic elements
+- `serializeElement(node)` — Make a React element tree structured-clone-safe
+- `deserializeElement(data)` — Reconstruct React elements from serialized data
+
 ### Types
 
 ```typescript
@@ -165,6 +246,46 @@ async function* generateFrames() {
 const stream = annieStream(generateFrames());
 ```
 
+### Pool-Based Frame Generation
+
+For animation workloads with many frames, the worker pool provides significant speedups:
+
+```typescript
+import { createSatoriPool } from "@effing/satori/pool";
+import { annieStream } from "@effing/annie";
+
+const pool = createSatoriPool();
+
+async function* generateFrames() {
+  const frames = Array.from({ length: 90 }, (_, i) => i / 89);
+
+  const results = await Promise.all(
+    frames.map((progress) =>
+      pool.renderToPng(
+        <div style={{
+          width: 1080,
+          height: 1920,
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "center",
+          transform: `scale(${1 + 0.3 * progress})`,
+          fontSize: 72,
+          color: "white",
+        }}>
+          ✨ Animated! ✨
+        </div>,
+        { width: 1080, height: 1920, fonts }
+      )
+    )
+  );
+
+  for (const frame of results) yield frame;
+}
+
+const stream = annieStream(generateFrames());
+await pool.destroy();
+```
+
 ### Multiple Font Weights
 
 ```typescript

package/dist/chunk-H5M6ZFOA.js

@@ -0,0 +1,84 @@
+// src/serde/index.ts
+import React from "react";
+var ELEMENT_MARKER = "__react_element__";
+function expandElement(node) {
+  if (node == null || typeof node === "boolean") return node;
+  if (typeof node === "string" || typeof node === "number") return node;
+  if (Array.isArray(node)) return node.map(expandElement);
+  if (!React.isValidElement(node)) return node;
+  const element = node;
+  if (typeof element.type === "function") {
+    const result = element.type(
+      element.props
+    );
+    return expandElement(result);
+  }
+  const props = Object.assign({}, element.props);
+  if (props.children != null) {
+    props.children = expandElement(props.children);
+  }
+  return React.createElement(element.type, {
+    ...props,
+    key: element.key
+  });
+}
+function serializeElement(node) {
+  if (node == null || typeof node === "boolean") return node;
+  if (typeof node === "string" || typeof node === "number") return node;
+  if (Array.isArray(node)) return node.map(serializeElement);
+  if (!React.isValidElement(node)) return node;
+  const element = node;
+  if (typeof element.type === "function") {
+    throw new Error(
+      `Cannot serialize function component "${element.type.name || "anonymous"}". Call expandElement first.`
+    );
+  }
+  const props = {};
+  for (const [key, value] of Object.entries(
+    element.props
+  )) {
+    if (key === "children") {
+      props.children = serializeElement(value);
+    } else if (value instanceof Buffer) {
+      props[key] = { __buffer__: true, data: Array.from(value) };
+    } else {
+      props[key] = value;
+    }
+  }
+  return {
+    [ELEMENT_MARKER]: true,
+    type: element.type,
+    key: element.key,
+    props
+  };
+}
+function deserializeElement(data) {
+  if (data == null || typeof data === "boolean") return data;
+  if (typeof data === "string" || typeof data === "number") return data;
+  if (Array.isArray(data)) return data.map(deserializeElement);
+  if (typeof data === "object" && data !== null && ELEMENT_MARKER in data) {
+    const serialized = data;
+    const props = {};
+    for (const [key, value] of Object.entries(serialized.props)) {
+      if (key === "children") {
+        props.children = deserializeElement(value);
+      } else if (typeof value === "object" && value !== null && "__buffer__" in value) {
+        props[key] = Buffer.from(value.data);
+      } else {
+        props[key] = value;
+      }
+    }
+    return React.createElement(serialized.type, {
+      ...props,
+      key: serialized.key
+    });
+  }
+  return data;
+}
+
+export {
+  expandElement,
+  serializeElement,
+  deserializeElement
+};
+//# sourceMappingURL=chunk-H5M6ZFOA.js.map

package/dist/chunk-H5M6ZFOA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/serde/index.ts"],"sourcesContent":["import React, { type ReactElement, type ReactNode } from \"react\";\n\nconst ELEMENT_MARKER = \"__react_element__\";\n\ntype SerializedElement = {\n  [ELEMENT_MARKER]: true;\n  type: string;\n  key: string | null;\n  props: Record<string, unknown>;\n};\n\n/**\n * Recursively expand all function components in a React element tree\n * until only intrinsic elements (div, svg, path, img, etc.) remain.\n */\nexport function expandElement(node: ReactNode): ReactNode {\n  if (node == null || typeof node === \"boolean\") return node;\n  if (typeof node === \"string\" || typeof node === \"number\") return node;\n  if (Array.isArray(node)) return node.map(expandElement);\n\n  if (!React.isValidElement(node)) return node;\n\n  const element = node as ReactElement;\n\n  if (typeof element.type === \"function\") {\n    const result = (element.type as (props: unknown) => ReactNode)(\n      element.props,\n    );\n    return expandElement(result);\n  }\n\n  // Intrinsic element — recursively expand children\n  const props = Object.assign({}, element.props) as Record<string, unknown>;\n  if (props.children != null) {\n    props.children = expandElement(props.children as ReactNode);\n  }\n  return React.createElement(element.type as string, {\n    ...props,\n    key: element.key,\n  });\n}\n\n/**\n * Serialize an expanded React element tree to a structured-clone-safe format.\n * All function components must already be expanded to intrinsic elements.\n */\nexport function serializeElement(node: ReactNode): unknown {\n  if (node == null || typeof node === \"boolean\") return node;\n  if (typeof node === \"string\" || typeof node === \"number\") return node;\n  if (Array.isArray(node)) return node.map(serializeElement);\n\n  if (!React.isValidElement(node)) return node;\n\n  const element = node as ReactElement;\n\n  if (typeof element.type === \"function\") {\n    throw new Error(\n      `Cannot serialize function component \"${element.type.name || \"anonymous\"}\". ` +\n        \"Call expandElement first.\",\n    );\n  }\n\n  const props: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(\n    element.props as Record<string, unknown>,\n  )) {\n    if (key === \"children\") {\n      props.children = serializeElement(value as ReactNode);\n    } else if (value instanceof Buffer) {\n      props[key] = { __buffer__: true, data: Array.from(value) };\n    } else {\n      props[key] = value;\n    }\n  }\n\n  return {\n    [ELEMENT_MARKER]: true,\n    type: element.type as string,\n    key: element.key,\n    props,\n  } satisfies SerializedElement;\n}\n\n/**\n * Deserialize a serialized element tree back into React elements.\n */\nexport function deserializeElement(data: unknown): ReactNode {\n  if (data == null || typeof data === \"boolean\") return data as ReactNode;\n  if (typeof data === \"string\" || typeof data === \"number\") return data;\n  if (Array.isArray(data)) return data.map(deserializeElement);\n\n  if (typeof data === \"object\" && data !== null && ELEMENT_MARKER in data) {\n    const serialized = data as SerializedElement;\n    const props: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(serialized.props)) {\n      if (key === \"children\") {\n        props.children = deserializeElement(value);\n      } else if (\n        typeof value === \"object\" &&\n        value !== null &&\n        \"__buffer__\" in value\n      ) {\n        props[key] = Buffer.from((value as unknown as { data: number[] }).data);\n      } else {\n        props[key] = value;\n      }\n    }\n    return React.createElement(serialized.type, {\n      ...props,\n      key: serialized.key,\n    });\n  }\n\n  return data as ReactNode;\n}\n"],"mappings":";AAAA,OAAO,WAAkD;AAEzD,IAAM,iBAAiB;AAahB,SAAS,cAAc,MAA4B;AACxD,MAAI,QAAQ,QAAQ,OAAO,SAAS,UAAW,QAAO;AACtD,MAAI,OAAO,SAAS,YAAY,OAAO,SAAS,SAAU,QAAO;AACjE,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,IAAI,aAAa;AAEtD,MAAI,CAAC,MAAM,eAAe,IAAI,EAAG,QAAO;AAExC,QAAM,UAAU;AAEhB,MAAI,OAAO,QAAQ,SAAS,YAAY;AACtC,UAAM,SAAU,QAAQ;AAAA,MACtB,QAAQ;AAAA,IACV;AACA,WAAO,cAAc,MAAM;AAAA,EAC7B;AAGA,QAAM,QAAQ,OAAO,OAAO,CAAC,GAAG,QAAQ,KAAK;AAC7C,MAAI,MAAM,YAAY,MAAM;AAC1B,UAAM,WAAW,cAAc,MAAM,QAAqB;AAAA,EAC5D;AACA,SAAO,MAAM,cAAc,QAAQ,MAAgB;AAAA,IACjD,GAAG;AAAA,IACH,KAAK,QAAQ;AAAA,EACf,CAAC;AACH;AAMO,SAAS,iBAAiB,MAA0B;AACzD,MAAI,QAAQ,QAAQ,OAAO,SAAS,UAAW,QAAO;AACtD,MAAI,OAAO,SAAS,YAAY,OAAO,SAAS,SAAU,QAAO;AACjE,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,IAAI,gBAAgB;AAEzD,MAAI,CAAC,MAAM,eAAe,IAAI,EAAG,QAAO;AAExC,QAAM,UAAU;AAEhB,MAAI,OAAO,QAAQ,SAAS,YAAY;AACtC,UAAM,IAAI;AAAA,MACR,wCAAwC,QAAQ,KAAK,QAAQ,WAAW;AAAA,IAE1E;AAAA,EACF;AAEA,QAAM,QAAiC,CAAC;AACxC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO;AAAA,IAChC,QAAQ;AAAA,EACV,GAAG;AACD,QAAI,QAAQ,YAAY;AACtB,YAAM,WAAW,iBAAiB,KAAkB;AAAA,IACtD,WAAW,iBAAiB,QAAQ;AAClC,YAAM,GAAG,IAAI,EAAE,YAAY,MAAM,MAAM,MAAM,KAAK,KAAK,EAAE;AAAA,IAC3D,OAAO;AACL,YAAM,GAAG,IAAI;AAAA,IACf;AAAA,EACF;AAEA,SAAO;AAAA,IACL,CAAC,cAAc,GAAG;AAAA,IAClB,MAAM,QAAQ;AAAA,IACd,KAAK,QAAQ;AAAA,IACb;AAAA,EACF;AACF;AAKO,SAAS,mBAAmB,MAA0B;AAC3D,MAAI,QAAQ,QAAQ,OAAO,SAAS,UAAW,QAAO;AACtD,MAAI,OAAO,SAAS,YAAY,OAAO,SAAS,SAAU,QAAO;AACjE,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,IAAI,kBAAkB;AAE3D,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,kBAAkB,MAAM;AACvE,UAAM,aAAa;AACnB,UAAM,QAAiC,CAAC;AACxC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,KAAK,GAAG;AAC3D,UAAI,QAAQ,YAAY;AACtB,cAAM,WAAW,mBAAmB,KAAK;AAAA,MAC3C,WACE,OAAO,UAAU,YACjB,UAAU,QACV,gBAAgB,OAChB;AACA,cAAM,GAAG,IAAI,OAAO,KAAM,MAAwC,IAAI;AAAA,MACxE,OAAO;AACL,cAAM,GAAG,IAAI;AAAA,MACf;AAAA,IACF;AACA,WAAO,MAAM,cAAc,WAAW,MAAM;AAAA,MAC1C,GAAG;AAAA,MACH,KAAK,WAAW;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/emoji-CtRDUFb8.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Emoji style options for rendering
+ */
+type EmojiStyle = "twemoji" | "openmoji" | "blobmoji" | "noto" | "fluent" | "fluentFlat";
+
+export type { EmojiStyle as E };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import satori from 'satori';
+import { E as EmojiStyle } from './emoji-CtRDUFb8.js';
 
 /**
  * Font data for satori rendering
@@ -10,13 +11,9 @@ type FontData = {
     style: "normal" | "italic";
 };
 /**
- * Emoji style options for rendering
+ * Options for satori rendering functions
  */
-type EmojiStyle = "twemoji" | "openmoji" | "blobmoji" | "noto" | "fluent" | "fluentFlat";
-/**
- * Options for pngFromSatori
- */
-type PngFromSatoriOptions = {
+type SatoriOptions = {
     /** Frame width in pixels */
     width: number;
     /** Frame height in pixels */
@@ -26,6 +23,25 @@ type PngFromSatoriOptions = {
     /** Emoji style to use (default: "twemoji") */
     emoji?: EmojiStyle;
 };
+/**
+ * @deprecated Use `SatoriOptions` instead
+ */
+type PngFromSatoriOptions = SatoriOptions;
+/**
+ * Render a React/JSX template to an SVG string using Satori
+ *
+ * @param template React element to render
+ * @param options Rendering options
+ * @returns SVG markup as a string
+ */
+declare function svgFromSatori(template: Parameters<typeof satori>[0], { width, height, fonts, emoji }: SatoriOptions): Promise<string>;
+/**
+ * Rasterize an SVG string to a PNG buffer using Resvg
+ *
+ * @param svg SVG markup string
+ * @returns PNG image as a Buffer
+ */
+declare function rasterizeSvg(svg: string): Buffer;
 /**
  * Render a React/JSX template to a PNG buffer using Satori
  *
@@ -41,6 +57,6 @@ type PngFromSatoriOptions = {
  * );
  * ```
  */
-declare function pngFromSatori(template: Parameters<typeof satori>[0], { width, height, fonts, emoji }: PngFromSatoriOptions): Promise<Buffer>;
+declare function pngFromSatori(template: Parameters<typeof satori>[0], options: SatoriOptions): Promise<Buffer>;
 
-export { type EmojiStyle, type FontData, type PngFromSatoriOptions, pngFromSatori };
+export { EmojiStyle, type FontData, type PngFromSatoriOptions, type SatoriOptions, pngFromSatori, rasterizeSvg, svgFromSatori };

package/dist/index.js

@@ -1,6 +1,8 @@
 // src/index.ts
 import { Resvg } from "@resvg/resvg-js";
 import satori from "satori";
+
+// src/emoji.ts
 var emojiApis = {
   twemoji: (code) => `https://cdnjs.cloudflare.com/ajax/libs/twemoji/16.0.1/svg/${code.toLowerCase()}.svg`,
   openmoji: "https://cdn.jsdelivr.net/npm/@svgmoji/openmoji@2.0.0/svg/",
@@ -42,22 +44,35 @@ async function loadEmoji(type, code) {
     (r) => r.text()
   );
 }
-async function pngFromSatori(template, { width, height, fonts, emoji = "twemoji" }) {
-  const overlaySvg = await satori(template, {
+function makeLoadAdditionalAsset(emoji) {
+  return async (code, segment) => {
+    if (code === "emoji") {
+      return "data:image/svg+xml;base64," + btoa(await loadEmoji(emoji, getEmojiCode(segment)));
+    }
+    return segment;
+  };
+}
+
+// src/index.ts
+async function svgFromSatori(template, { width, height, fonts, emoji = "twemoji" }) {
+  return satori(template, {
     width,
     height,
     fonts,
-    loadAdditionalAsset: async (code, segment) => {
-      if (code === "emoji") {
-        return "data:image/svg+xml;base64," + btoa(await loadEmoji(emoji, getEmojiCode(segment)));
-      }
-      return segment;
-    }
+    loadAdditionalAsset: makeLoadAdditionalAsset(emoji)
   });
-  const resvg = new Resvg(overlaySvg, { font: { loadSystemFonts: false } });
+}
+function rasterizeSvg(svg) {
+  const resvg = new Resvg(svg, { font: { loadSystemFonts: false } });
   return resvg.render().asPng();
 }
+async function pngFromSatori(template, options) {
+  const svg = await svgFromSatori(template, options);
+  return rasterizeSvg(svg);
+}
 export {
-  pngFromSatori
+  pngFromSatori,
+  rasterizeSvg,
+  svgFromSatori
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { Resvg } from \"@resvg/resvg-js\";\nimport satori from \"satori\";\n\n/**\n * Font data for satori rendering\n */\nexport type FontData = {\n  name: string;\n  data: Buffer | ArrayBuffer;\n  weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n  style: \"normal\" | \"italic\";\n};\n\n/**\n * Emoji style options for rendering\n */\nexport type EmojiStyle =\n  | \"twemoji\"\n  | \"openmoji\"\n  | \"blobmoji\"\n  | \"noto\"\n  | \"fluent\"\n  | \"fluentFlat\";\n\nconst emojiApis: Record<EmojiStyle, string | ((code: string) => string)> = {\n  twemoji: (code: string) =>\n    `https://cdnjs.cloudflare.com/ajax/libs/twemoji/16.0.1/svg/${code.toLowerCase()}.svg`,\n  openmoji: \"https://cdn.jsdelivr.net/npm/@svgmoji/openmoji@2.0.0/svg/\",\n  blobmoji: \"https://cdn.jsdelivr.net/npm/@svgmoji/blob@2.0.0/svg/\",\n  noto: \"https://cdn.jsdelivr.net/gh/svgmoji/svgmoji/packages/svgmoji__noto/svg/\",\n  fluent: (code: string) =>\n    `https://cdn.jsdelivr.net/gh/shuding/fluentui-emoji-unicode/assets/${code.toLowerCase()}_color.svg`,\n  fluentFlat: (code: string) =>\n    `https://cdn.jsdelivr.net/gh/shuding/fluentui-emoji-unicode/assets/${code.toLowerCase()}_flat.svg`,\n};\n\nconst U200D = String.fromCharCode(8205);\nconst UFE0Fg = /\\uFE0F/g;\n\nfunction getEmojiCode(char: string): string {\n  return toCodePoint(char.indexOf(U200D) < 0 ? char.replace(UFE0Fg, \"\") : char);\n}\n\nfunction toCodePoint(unicodeSurrogates: string): string {\n  const r: string[] = [];\n  let c = 0,\n    p = 0,\n    i = 0;\n\n  while (i < unicodeSurrogates.length) {\n    c = unicodeSurrogates.charCodeAt(i++);\n    if (p) {\n      r.push((65536 + ((p - 55296) << 10) + (c - 56320)).toString(16));\n      p = 0;\n    } else if (55296 <= c && c <= 56319) {\n      p = c;\n    } else {\n      r.push(c.toString(16));\n    }\n  }\n  return r.join(\"-\");\n}\n\nconst emojiCache: Record<string, Promise<string>> = {};\n\nasync function loadEmoji(type: EmojiStyle, code: string): Promise<string> {\n  const key = type + \":\" + code;\n  if (key in emojiCache) return emojiCache[key];\n\n  const api = emojiApis[type];\n  if (typeof api === \"function\") {\n    return (emojiCache[key] = fetch(api(code)).then((r) => r.text()));\n  }\n  return (emojiCache[key] = fetch(`${api}${code.toUpperCase()}.svg`).then((r) =>\n    r.text(),\n  ));\n}\n\n/**\n * Options for pngFromSatori\n */\nexport type PngFromSatoriOptions = {\n  /** Frame width in pixels */\n  width: number;\n  /** Frame height in pixels */\n  height: number;\n  /** Font data for text rendering */\n  fonts: FontData[];\n  /** Emoji style to use (default: \"twemoji\") */\n  emoji?: EmojiStyle;\n};\n\n/**\n * Render a React/JSX template to a PNG buffer using Satori\n *\n * @param template React element to render\n * @param options Rendering options\n * @returns PNG image as a Buffer\n *\n * @example\n * ```tsx\n * const png = await pngFromSatori(\n *   <div style={{ fontSize: 48, color: \"white\" }}>Hello World</div>,\n *   { width: 1080, height: 1080, fonts: [myFont] }\n * );\n * ```\n */\nexport async function pngFromSatori(\n  template: Parameters<typeof satori>[0],\n  { width, height, fonts, emoji = \"twemoji\" }: PngFromSatoriOptions,\n): Promise<Buffer> {\n  const overlaySvg = await satori(template, {\n    width,\n    height,\n    fonts,\n    loadAdditionalAsset: async (code: string, segment: string) => {\n      if (code === \"emoji\") {\n        return (\n          \"data:image/svg+xml;base64,\" +\n          btoa(await loadEmoji(emoji, getEmojiCode(segment)))\n        );\n      }\n      return segment;\n    },\n  });\n  const resvg = new Resvg(overlaySvg, { font: { loadSystemFonts: false } });\n  return resvg.render().asPng();\n}\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,OAAO,YAAY;AAuBnB,IAAM,YAAqE;AAAA,EACzE,SAAS,CAAC,SACR,6DAA6D,KAAK,YAAY,CAAC;AAAA,EACjF,UAAU;AAAA,EACV,UAAU;AAAA,EACV,MAAM;AAAA,EACN,QAAQ,CAAC,SACP,qEAAqE,KAAK,YAAY,CAAC;AAAA,EACzF,YAAY,CAAC,SACX,qEAAqE,KAAK,YAAY,CAAC;AAC3F;AAEA,IAAM,QAAQ,OAAO,aAAa,IAAI;AACtC,IAAM,SAAS;AAEf,SAAS,aAAa,MAAsB;AAC1C,SAAO,YAAY,KAAK,QAAQ,KAAK,IAAI,IAAI,KAAK,QAAQ,QAAQ,EAAE,IAAI,IAAI;AAC9E;AAEA,SAAS,YAAY,mBAAmC;AACtD,QAAM,IAAc,CAAC;AACrB,MAAI,IAAI,GACN,IAAI,GACJ,IAAI;AAEN,SAAO,IAAI,kBAAkB,QAAQ;AACnC,QAAI,kBAAkB,WAAW,GAAG;AACpC,QAAI,GAAG;AACL,QAAE,MAAM,SAAU,IAAI,SAAU,OAAO,IAAI,QAAQ,SAAS,EAAE,CAAC;AAC/D,UAAI;AAAA,IACN,WAAW,SAAS,KAAK,KAAK,OAAO;AACnC,UAAI;AAAA,IACN,OAAO;AACL,QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAAA,IACvB;AAAA,EACF;AACA,SAAO,EAAE,KAAK,GAAG;AACnB;AAEA,IAAM,aAA8C,CAAC;AAErD,eAAe,UAAU,MAAkB,MAA+B;AACxE,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,OAAO,WAAY,QAAO,WAAW,GAAG;AAE5C,QAAM,MAAM,UAAU,IAAI;AAC1B,MAAI,OAAO,QAAQ,YAAY;AAC7B,WAAQ,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;AAAA,EACjE;AACA,SAAQ,WAAW,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,KAAK,YAAY,CAAC,MAAM,EAAE;AAAA,IAAK,CAAC,MACvE,EAAE,KAAK;AAAA,EACT;AACF;AA+BA,eAAsB,cACpB,UACA,EAAE,OAAO,QAAQ,OAAO,QAAQ,UAAU,GACzB;AACjB,QAAM,aAAa,MAAM,OAAO,UAAU;AAAA,IACxC;AAAA,IACA;AAAA,IACA;AAAA,IACA,qBAAqB,OAAO,MAAc,YAAoB;AAC5D,UAAI,SAAS,SAAS;AACpB,eACE,+BACA,KAAK,MAAM,UAAU,OAAO,aAAa,OAAO,CAAC,CAAC;AAAA,MAEtD;AACA,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACD,QAAM,QAAQ,IAAI,MAAM,YAAY,EAAE,MAAM,EAAE,iBAAiB,MAAM,EAAE,CAAC;AACxE,SAAO,MAAM,OAAO,EAAE,MAAM;AAC9B;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/emoji.ts"],"sourcesContent":["import { Resvg } from \"@resvg/resvg-js\";\nimport satori from \"satori\";\n\nimport { makeLoadAdditionalAsset } from \"./emoji.ts\";\nimport type { EmojiStyle } from \"./emoji.ts\";\n\nexport type { EmojiStyle } from \"./emoji.ts\";\n\n/**\n * Font data for satori rendering\n */\nexport type FontData = {\n  name: string;\n  data: Buffer | ArrayBuffer;\n  weight: 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n  style: \"normal\" | \"italic\";\n};\n\n/**\n * Options for satori rendering functions\n */\nexport type SatoriOptions = {\n  /** Frame width in pixels */\n  width: number;\n  /** Frame height in pixels */\n  height: number;\n  /** Font data for text rendering */\n  fonts: FontData[];\n  /** Emoji style to use (default: \"twemoji\") */\n  emoji?: EmojiStyle;\n};\n\n/**\n * @deprecated Use `SatoriOptions` instead\n */\nexport type PngFromSatoriOptions = SatoriOptions;\n\n/**\n * Render a React/JSX template to an SVG string using Satori\n *\n * @param template React element to render\n * @param options Rendering options\n * @returns SVG markup as a string\n */\nexport async function svgFromSatori(\n  template: Parameters<typeof satori>[0],\n  { width, height, fonts, emoji = \"twemoji\" }: SatoriOptions,\n): Promise<string> {\n  return satori(template, {\n    width,\n    height,\n    fonts,\n    loadAdditionalAsset: makeLoadAdditionalAsset(emoji),\n  });\n}\n\n/**\n * Rasterize an SVG string to a PNG buffer using Resvg\n *\n * @param svg SVG markup string\n * @returns PNG image as a Buffer\n */\nexport function rasterizeSvg(svg: string): Buffer {\n  const resvg = new Resvg(svg, { font: { loadSystemFonts: false } });\n  return resvg.render().asPng();\n}\n\n/**\n * Render a React/JSX template to a PNG buffer using Satori\n *\n * @param template React element to render\n * @param options Rendering options\n * @returns PNG image as a Buffer\n *\n * @example\n * ```tsx\n * const png = await pngFromSatori(\n *   <div style={{ fontSize: 48, color: \"white\" }}>Hello World</div>,\n *   { width: 1080, height: 1080, fonts: [myFont] }\n * );\n * ```\n */\nexport async function pngFromSatori(\n  template: Parameters<typeof satori>[0],\n  options: SatoriOptions,\n): Promise<Buffer> {\n  const svg = await svgFromSatori(template, options);\n  return rasterizeSvg(svg);\n}\n","/**\n * Emoji style options for rendering\n */\nexport type EmojiStyle =\n  | \"twemoji\"\n  | \"openmoji\"\n  | \"blobmoji\"\n  | \"noto\"\n  | \"fluent\"\n  | \"fluentFlat\";\n\nexport const emojiApis: Record<\n  EmojiStyle,\n  string | ((code: string) => string)\n> = {\n  twemoji: (code: string) =>\n    `https://cdnjs.cloudflare.com/ajax/libs/twemoji/16.0.1/svg/${code.toLowerCase()}.svg`,\n  openmoji: \"https://cdn.jsdelivr.net/npm/@svgmoji/openmoji@2.0.0/svg/\",\n  blobmoji: \"https://cdn.jsdelivr.net/npm/@svgmoji/blob@2.0.0/svg/\",\n  noto: \"https://cdn.jsdelivr.net/gh/svgmoji/svgmoji/packages/svgmoji__noto/svg/\",\n  fluent: (code: string) =>\n    `https://cdn.jsdelivr.net/gh/shuding/fluentui-emoji-unicode/assets/${code.toLowerCase()}_color.svg`,\n  fluentFlat: (code: string) =>\n    `https://cdn.jsdelivr.net/gh/shuding/fluentui-emoji-unicode/assets/${code.toLowerCase()}_flat.svg`,\n};\n\nconst U200D = String.fromCharCode(8205);\nconst UFE0Fg = /\\uFE0F/g;\n\nexport function getEmojiCode(char: string): string {\n  return toCodePoint(char.indexOf(U200D) < 0 ? char.replace(UFE0Fg, \"\") : char);\n}\n\nexport function toCodePoint(unicodeSurrogates: string): string {\n  const r: string[] = [];\n  let c = 0,\n    p = 0,\n    i = 0;\n\n  while (i < unicodeSurrogates.length) {\n    c = unicodeSurrogates.charCodeAt(i++);\n    if (p) {\n      r.push((65536 + ((p - 55296) << 10) + (c - 56320)).toString(16));\n      p = 0;\n    } else if (55296 <= c && c <= 56319) {\n      p = c;\n    } else {\n      r.push(c.toString(16));\n    }\n  }\n  return r.join(\"-\");\n}\n\nconst emojiCache: Record<string, Promise<string>> = {};\n\nexport async function loadEmoji(\n  type: EmojiStyle,\n  code: string,\n): Promise<string> {\n  const key = type + \":\" + code;\n  if (key in emojiCache) return emojiCache[key];\n\n  const api = emojiApis[type];\n  if (typeof api === \"function\") {\n    return (emojiCache[key] = fetch(api(code)).then((r) => r.text()));\n  }\n  return (emojiCache[key] = fetch(`${api}${code.toUpperCase()}.svg`).then((r) =>\n    r.text(),\n  ));\n}\n\nexport function makeLoadAdditionalAsset(emoji: EmojiStyle) {\n  return async (code: string, segment: string) => {\n    if (code === \"emoji\") {\n      return (\n        \"data:image/svg+xml;base64,\" +\n        btoa(await loadEmoji(emoji, getEmojiCode(segment)))\n      );\n    }\n    return segment;\n  };\n}\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,OAAO,YAAY;;;ACUZ,IAAM,YAGT;AAAA,EACF,SAAS,CAAC,SACR,6DAA6D,KAAK,YAAY,CAAC;AAAA,EACjF,UAAU;AAAA,EACV,UAAU;AAAA,EACV,MAAM;AAAA,EACN,QAAQ,CAAC,SACP,qEAAqE,KAAK,YAAY,CAAC;AAAA,EACzF,YAAY,CAAC,SACX,qEAAqE,KAAK,YAAY,CAAC;AAC3F;AAEA,IAAM,QAAQ,OAAO,aAAa,IAAI;AACtC,IAAM,SAAS;AAER,SAAS,aAAa,MAAsB;AACjD,SAAO,YAAY,KAAK,QAAQ,KAAK,IAAI,IAAI,KAAK,QAAQ,QAAQ,EAAE,IAAI,IAAI;AAC9E;AAEO,SAAS,YAAY,mBAAmC;AAC7D,QAAM,IAAc,CAAC;AACrB,MAAI,IAAI,GACN,IAAI,GACJ,IAAI;AAEN,SAAO,IAAI,kBAAkB,QAAQ;AACnC,QAAI,kBAAkB,WAAW,GAAG;AACpC,QAAI,GAAG;AACL,QAAE,MAAM,SAAU,IAAI,SAAU,OAAO,IAAI,QAAQ,SAAS,EAAE,CAAC;AAC/D,UAAI;AAAA,IACN,WAAW,SAAS,KAAK,KAAK,OAAO;AACnC,UAAI;AAAA,IACN,OAAO;AACL,QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAAA,IACvB;AAAA,EACF;AACA,SAAO,EAAE,KAAK,GAAG;AACnB;AAEA,IAAM,aAA8C,CAAC;AAErD,eAAsB,UACpB,MACA,MACiB;AACjB,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,OAAO,WAAY,QAAO,WAAW,GAAG;AAE5C,QAAM,MAAM,UAAU,IAAI;AAC1B,MAAI,OAAO,QAAQ,YAAY;AAC7B,WAAQ,WAAW,GAAG,IAAI,MAAM,IAAI,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC;AAAA,EACjE;AACA,SAAQ,WAAW,GAAG,IAAI,MAAM,GAAG,GAAG,GAAG,KAAK,YAAY,CAAC,MAAM,EAAE;AAAA,IAAK,CAAC,MACvE,EAAE,KAAK;AAAA,EACT;AACF;AAEO,SAAS,wBAAwB,OAAmB;AACzD,SAAO,OAAO,MAAc,YAAoB;AAC9C,QAAI,SAAS,SAAS;AACpB,aACE,+BACA,KAAK,MAAM,UAAU,OAAO,aAAa,OAAO,CAAC,CAAC;AAAA,IAEtD;AACA,WAAO;AAAA,EACT;AACF;;;ADrCA,eAAsB,cACpB,UACA,EAAE,OAAO,QAAQ,OAAO,QAAQ,UAAU,GACzB;AACjB,SAAO,OAAO,UAAU;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA,qBAAqB,wBAAwB,KAAK;AAAA,EACpD,CAAC;AACH;AAQO,SAAS,aAAa,KAAqB;AAChD,QAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,MAAM,EAAE,iBAAiB,MAAM,EAAE,CAAC;AACjE,SAAO,MAAM,OAAO,EAAE,MAAM;AAC9B;AAiBA,eAAsB,cACpB,UACA,SACiB;AACjB,QAAM,MAAM,MAAM,cAAc,UAAU,OAAO;AACjD,SAAO,aAAa,GAAG;AACzB;","names":[]}

package/dist/pool/index.d.ts

@@ -0,0 +1,67 @@
+import satori from 'satori';
+import { E as EmojiStyle } from '../emoji-CtRDUFb8.js';
+
+type SatoriPoolOptions = {
+    /** Minimum number of worker threads (default: 1) */
+    minThreads?: number;
+    /** Maximum number of worker threads (default: os.cpus().length) */
+    maxThreads?: number;
+};
+type SatoriPool = {
+    /** Render a serialized React element to PNG via the worker pool */
+    renderToPng(element: Parameters<typeof satori>[0], options: {
+        width: number;
+        height: number;
+        fonts: Array<{
+            name: string;
+            data: Buffer;
+            weight: number;
+            style: string;
+        }>;
+        emoji?: EmojiStyle;
+    }): Promise<Buffer>;
+    /** Render a serialized React element to SVG via the worker pool */
+    renderToSvg(element: Parameters<typeof satori>[0], options: {
+        width: number;
+        height: number;
+        fonts: Array<{
+            name: string;
+            data: Buffer;
+            weight: number;
+            style: string;
+        }>;
+        emoji?: EmojiStyle;
+    }): Promise<string>;
+    /** Rasterize an SVG string to PNG via the worker pool */
+    rasterizeSvgToPng(svg: string, options?: {
+        fitTo?: {
+            mode: "original";
+        } | {
+            mode: "width";
+            value: number;
+        } | {
+            mode: "height";
+            value: number;
+        } | {
+            mode: "zoom";
+            value: number;
+        };
+        crop?: {
+            left: number;
+            top: number;
+            right?: number;
+            bottom?: number;
+        };
+    }): Promise<Buffer>;
+    /** Shut down the worker pool */
+    destroy(): Promise<void>;
+};
+/**
+ * Create a worker pool for parallelized satori rendering.
+ *
+ * @param options Pool configuration
+ * @returns A `SatoriPool` with `renderToPng`, `renderToSvg`, `rasterizeSvgToPng`, and `destroy`
+ */
+declare function createSatoriPool(options?: SatoriPoolOptions): SatoriPool;
+
+export { type SatoriPool, type SatoriPoolOptions, createSatoriPool };

package/dist/pool/index.js

@@ -0,0 +1,64 @@
+import {
+  expandElement,
+  serializeElement
+} from "../chunk-H5M6ZFOA.js";
+
+// src/pool/index.ts
+import os from "os";
+import { fileURLToPath } from "url";
+import path from "path";
+import Tinypool from "tinypool";
+function createSatoriPool(options) {
+  const workerFile = path.resolve(
+    path.dirname(fileURLToPath(import.meta.url)),
+    "../worker/index.js"
+  );
+  const pool = new Tinypool({
+    filename: workerFile,
+    minThreads: options?.minThreads ?? 1,
+    maxThreads: options?.maxThreads ?? os.cpus().length
+  });
+  return {
+    async renderToPng(element, opts) {
+      const serialized = serializeElement(expandElement(element));
+      const result = await pool.run(
+        {
+          element: serialized,
+          width: opts.width,
+          height: opts.height,
+          fonts: opts.fonts,
+          emoji: opts.emoji
+        },
+        { name: "renderToPng" }
+      );
+      return Buffer.from(result);
+    },
+    async renderToSvg(element, opts) {
+      const serialized = serializeElement(expandElement(element));
+      return pool.run(
+        {
+          element: serialized,
+          width: opts.width,
+          height: opts.height,
+          fonts: opts.fonts,
+          emoji: opts.emoji
+        },
+        { name: "renderToSvg" }
+      );
+    },
+    async rasterizeSvgToPng(svg, opts) {
+      const result = await pool.run(
+        { svg, options: opts },
+        { name: "rasterizeSvgToPng" }
+      );
+      return Buffer.from(result);
+    },
+    async destroy() {
+      await pool.destroy();
+    }
+  };
+}
+export {
+  createSatoriPool
+};
+//# sourceMappingURL=index.js.map

package/dist/pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/pool/index.ts"],"sourcesContent":["import os from \"os\";\nimport { fileURLToPath } from \"url\";\nimport path from \"path\";\n\nimport type { ReactNode } from \"react\";\nimport type satori from \"satori\";\nimport Tinypool from \"tinypool\";\n\nimport type { EmojiStyle } from \"../emoji.ts\";\nimport { expandElement, serializeElement } from \"../serde/index.ts\";\n\nexport type SatoriPoolOptions = {\n  /** Minimum number of worker threads (default: 1) */\n  minThreads?: number;\n  /** Maximum number of worker threads (default: os.cpus().length) */\n  maxThreads?: number;\n};\n\nexport type SatoriPool = {\n  /** Render a serialized React element to PNG via the worker pool */\n  renderToPng(\n    element: Parameters<typeof satori>[0],\n    options: {\n      width: number;\n      height: number;\n      fonts: Array<{\n        name: string;\n        data: Buffer;\n        weight: number;\n        style: string;\n      }>;\n      emoji?: EmojiStyle;\n    },\n  ): Promise<Buffer>;\n\n  /** Render a serialized React element to SVG via the worker pool */\n  renderToSvg(\n    element: Parameters<typeof satori>[0],\n    options: {\n      width: number;\n      height: number;\n      fonts: Array<{\n        name: string;\n        data: Buffer;\n        weight: number;\n        style: string;\n      }>;\n      emoji?: EmojiStyle;\n    },\n  ): Promise<string>;\n\n  /** Rasterize an SVG string to PNG via the worker pool */\n  rasterizeSvgToPng(\n    svg: string,\n    options?: {\n      fitTo?:\n        | { mode: \"original\" }\n        | { mode: \"width\"; value: number }\n        | { mode: \"height\"; value: number }\n        | { mode: \"zoom\"; value: number };\n      crop?: {\n        left: number;\n        top: number;\n        right?: number;\n        bottom?: number;\n      };\n    },\n  ): Promise<Buffer>;\n\n  /** Shut down the worker pool */\n  destroy(): Promise<void>;\n};\n\n/**\n * Create a worker pool for parallelized satori rendering.\n *\n * @param options Pool configuration\n * @returns A `SatoriPool` with `renderToPng`, `renderToSvg`, `rasterizeSvgToPng`, and `destroy`\n */\nexport function createSatoriPool(options?: SatoriPoolOptions): SatoriPool {\n  const workerFile = path.resolve(\n    path.dirname(fileURLToPath(import.meta.url)),\n    \"../worker/index.js\",\n  );\n\n  const pool = new Tinypool({\n    filename: workerFile,\n    minThreads: options?.minThreads ?? 1,\n    maxThreads: options?.maxThreads ?? os.cpus().length,\n  });\n\n  return {\n    async renderToPng(element, opts) {\n      const serialized = serializeElement(expandElement(element as ReactNode));\n      const result = await pool.run(\n        {\n          element: serialized,\n          width: opts.width,\n          height: opts.height,\n          fonts: opts.fonts,\n          emoji: opts.emoji,\n        },\n        { name: \"renderToPng\" },\n      );\n      return Buffer.from(result);\n    },\n\n    async renderToSvg(element, opts) {\n      const serialized = serializeElement(expandElement(element as ReactNode));\n      return pool.run(\n        {\n          element: serialized,\n          width: opts.width,\n          height: opts.height,\n          fonts: opts.fonts,\n          emoji: opts.emoji,\n        },\n        { name: \"renderToSvg\" },\n      );\n    },\n\n    async rasterizeSvgToPng(svg, opts) {\n      const result = await pool.run(\n        { svg, options: opts },\n        { name: \"rasterizeSvgToPng\" },\n      );\n      return Buffer.from(result);\n    },\n\n    async destroy() {\n      await pool.destroy();\n    },\n  };\n}\n"],"mappings":";;;;;;AAAA,OAAO,QAAQ;AACf,SAAS,qBAAqB;AAC9B,OAAO,UAAU;AAIjB,OAAO,cAAc;AAyEd,SAAS,iBAAiB,SAAyC;AACxE,QAAM,aAAa,KAAK;AAAA,IACtB,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAAA,IAC3C;AAAA,EACF;AAEA,QAAM,OAAO,IAAI,SAAS;AAAA,IACxB,UAAU;AAAA,IACV,YAAY,SAAS,cAAc;AAAA,IACnC,YAAY,SAAS,cAAc,GAAG,KAAK,EAAE;AAAA,EAC/C,CAAC;AAED,SAAO;AAAA,IACL,MAAM,YAAY,SAAS,MAAM;AAC/B,YAAM,aAAa,iBAAiB,cAAc,OAAoB,CAAC;AACvE,YAAM,SAAS,MAAM,KAAK;AAAA,QACxB;AAAA,UACE,SAAS;AAAA,UACT,OAAO,KAAK;AAAA,UACZ,QAAQ,KAAK;AAAA,UACb,OAAO,KAAK;AAAA,UACZ,OAAO,KAAK;AAAA,QACd;AAAA,QACA,EAAE,MAAM,cAAc;AAAA,MACxB;AACA,aAAO,OAAO,KAAK,MAAM;AAAA,IAC3B;AAAA,IAEA,MAAM,YAAY,SAAS,MAAM;AAC/B,YAAM,aAAa,iBAAiB,cAAc,OAAoB,CAAC;AACvE,aAAO,KAAK;AAAA,QACV;AAAA,UACE,SAAS;AAAA,UACT,OAAO,KAAK;AAAA,UACZ,QAAQ,KAAK;AAAA,UACb,OAAO,KAAK;AAAA,UACZ,OAAO,KAAK;AAAA,QACd;AAAA,QACA,EAAE,MAAM,cAAc;AAAA,MACxB;AAAA,IACF;AAAA,IAEA,MAAM,kBAAkB,KAAK,MAAM;AACjC,YAAM,SAAS,MAAM,KAAK;AAAA,QACxB,EAAE,KAAK,SAAS,KAAK;AAAA,QACrB,EAAE,MAAM,oBAAoB;AAAA,MAC9B;AACA,aAAO,OAAO,KAAK,MAAM;AAAA,IAC3B;AAAA,IAEA,MAAM,UAAU;AACd,YAAM,KAAK,QAAQ;AAAA,IACrB;AAAA,EACF;AACF;","names":[]}

package/dist/serde/index.d.ts

@@ -0,0 +1,18 @@
+import { ReactNode } from 'react';
+
+/**
+ * Recursively expand all function components in a React element tree
+ * until only intrinsic elements (div, svg, path, img, etc.) remain.
+ */
+declare function expandElement(node: ReactNode): ReactNode;
+/**
+ * Serialize an expanded React element tree to a structured-clone-safe format.
+ * All function components must already be expanded to intrinsic elements.
+ */
+declare function serializeElement(node: ReactNode): unknown;
+/**
+ * Deserialize a serialized element tree back into React elements.
+ */
+declare function deserializeElement(data: unknown): ReactNode;
+
+export { deserializeElement, expandElement, serializeElement };

package/dist/serde/index.js

@@ -0,0 +1,11 @@
+import {
+  deserializeElement,
+  expandElement,
+  serializeElement
+} from "../chunk-H5M6ZFOA.js";
+export {
+  deserializeElement,
+  expandElement,
+  serializeElement
+};
+//# sourceMappingURL=index.js.map

package/dist/serde/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}