satori 0.16.2 → 0.18.0

package/README.md

@@ -204,7 +204,7 @@ Satori uses the same Flexbox [layout engine](https://yogalayout.com) as React Na
 
 <tr><td rowspan="7">Background</td></tr>
 <tr><td><code>backgroundColor</code></td><td>Supported, single value</td><td></td></tr>
-<tr><td><code>backgroundImage</code></td><td><code>linear-gradient</code>, <code>radial-gradient</code>, <code>url</code>, single value</td><td></td></tr>
+<tr><td><code>backgroundImage</code></td><td><code>linear-gradient</code>, <code>repeating-linear-gradient</code>, <code>radial-gradient</code>, <code>repeating-radial-gradient</code>, <code>url</code>, single value</td><td></td></tr>
 <tr><td><code>backgroundPosition</code></td><td>Support single value</td><td></td></tr>
 <tr><td><code>backgroundSize</code></td><td>Support two-value size i.e. <code>10px 20%</code></td><td></td></tr>
 <tr><td><code>backgroundClip</code></td><td><code>border-box</code>, <code>text</code></td><td></td></tr>
@@ -228,6 +228,12 @@ Satori uses the same Flexbox [layout engine](https://yogalayout.com) as React Na
 <td></td>
 </tr>
 
+<tr>
+<td colspan="2"><code>objectPosition</code></td>
+<td>Support keywords: <code>top</code>, <code>bottom</code>, <code>left</code>, <code>right</code>, <code>center</code>, and combinations like <code>top left</code>. Defaults to <code>center</code>.</td>
+<td></td>
+</tr>
+
 <tr>
 <td colspan="2"><code>opacity</code></td>
 <td>Supported</td>
@@ -396,7 +402,29 @@ await satori(
 
 ### Runtime Support
 
-Satori can be used in browser, Node.js (>= 16), and Web Workers.
+Satori can be directly used in browser, Node.js (>= 16), and Web Workers. It bundles its underlying WASM dependencies as base64-encoded strings and loads them at runtime.
+
+If there is a limitation on dynamically loading WASM (e.g. Cloudflare Workers), you can use the Standalone Build which is mentioned below.
+
+#### Standalone Build of Satori
+
+Satori's standalone build doesn't include Yoga's WASM binary by default, and you need to load it manually before using Satori.
+
+First, you need to download the `yoga.wasm` binary from (Satori build)[https://unpkg.com/satori/] and provide it yourself. Let's use `fetch` to load it directly from the CDN as an example:
+
+```jsx
+import satori, { init } from 'satori/standalone'
+
+const res = await fetch('https://unpkg.com/satori/yoga.wasm')
+const yogaWasm = await res.arrayBuffer()
+
+await init(yogaWasm)
+
+// Now you can use satori as usual
+const svg = await satori(...)
+```
+
+Of course, you can also load the `yoga.wasm` file from your local disk via `fs.readFile` in Node.js or other methods.
 
 ### Font Embedding