otomate 0.3.0 → 0.3.1

package/SKILL.md

@@ -298,6 +298,7 @@ These CSS properties are understood by `writeDocx` (via `@otomate/css-docx`). An
 | `font-style: italic` | `w:i` |
 | `color: #333` | `w:color` |
 | `background-color: yellow` | `w:shd` |
+| `background: #cee6ce` (shorthand) | `w:shd` — first color token wins |
 | `text-decoration: underline` | `w:u val="single"` |
 | `text-decoration: line-through` | `w:strike` |
 
@@ -310,7 +311,9 @@ These CSS properties are understood by `writeDocx` (via `@otomate/css-docx`). An
 | `line-height: 1.5` | `w:spacing line` |
 | `margin-left/right: 0.5in` | `w:ind left/right` (twips) |
 | `border: 1pt solid #000` (and `border-top/right/bottom/left`) | `w:pBdr` (per side) |
+| `border-style: solid` + `border-color: #5cb85c` + `border-width: 3px` (separated) | `w:pBdr` — each property accepts the 1–4 value CSS shorthand (top/right/bottom/left) |
 | `background-color: #fafafa` | `w:shd` |
+| `background: #fafafa` (shorthand) | `w:shd` — first color token wins |
 
 **Color formats accepted**: named colors, `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb()`, `rgba()`, `hsl()`, `hsla()`. Alpha is dropped (OOXML has no alpha channel).
 
@@ -319,7 +322,7 @@ These CSS properties are understood by `writeDocx` (via `@otomate/css-docx`). An
 ## Gotchas (ranked by how often they bite)
 
 1. **`writeDocx`, `readDocx`, `writeDiffDocx` are async.** Forgetting `await` leaves you holding a `Promise<Uint8Array>` instead of a buffer — `fs.writeFileSync` will then fail or write garbage. `readHtml`/`writeHtml` are synchronous; don't await them.
-2. **Node ≥20 only for the docx path.** `writer.ts` and `reader.ts` use `node:crypto` for the snapshot hash. The HTML-only path (`readHtml`/`writeHtml`) is browser-safe.
+2. **Works in both Node ≥20 and modern browsers** — the docx path uses the Web Crypto API internally (not `node:crypto`), so the library is fully universal. You can `readDocx`/`writeDocx` in a browser, a worker, Deno, Bun, or an edge runtime the same way you would in Node.
 3. **Pass a buffer, not a path.** `readDocx(buffer)` expects `Uint8Array` or `ArrayBuffer`. Call `fs.readFileSync("file.docx")` first.
 4. **Marks are flat.** Put bold on a text node via `text("x", [strong()])`, not `strong(text("x"))`. The builders enforce this — `strong()` returns a `Mark`, not a wrapper node.
 5. **CSS class names get sanitized for OOXML.** Only `[A-Za-z0-9_\-:]` survives and the result is clamped to 31 characters. A class like `"my class!"` becomes `"myclass"` in the generated Word style. Keep class names alphanumeric if you want 1:1 fidelity.