react-word-docx 1.0.0

package/README.md

@@ -0,0 +1,361 @@
+# react-word-docx
+
+> Convert a simple JSON **Block Schema** into a fully-featured, native `.docx` file — entirely in the browser. No server, no canvas tricks, no HTML-to-Word hacks.
+
+Built on top of the excellent [`docx`](https://github.com/dolanmiu/docx) library with a high-level JSON API that handles all the Word-specific quirks for you (half-point font math, real list numbering, heading hierarchy, table headers, and more).
+
+---
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Installation](#installation)
+- [API Reference](#api-reference)
+- [Block Type Reference](#block-type-reference)
+- [Styling Properties](#styling-properties)
+- [Smart Layer — What DocxEngine Does Automatically](#smart-layer--what-docxengine-does-automatically)
+- [Using in a React Component](#using-in-a-react-component)
+- [Advanced: Getting the Raw Blob](#advanced-getting-the-raw-blob)
+- [TypeScript Types](#typescript-types)
+- [Compatibility](#compatibility)
+
+---
+
+## Quick Start
+
+```tsx
+import { downloadDocx } from "react-word-docx";
+
+const blocks = [
+  { type: "h1", text: "My Report" },
+  { type: "p", text: "Generated entirely in the browser." },
+  {
+    type: "table",
+    rows: [
+      ["Name", "Score"],
+      ["Alice", "98"],
+      ["Bob", "87"],
+    ],
+  },
+  { type: "ul", li: ["Fast", "Native", "No server required"] },
+];
+
+// Triggers a browser download of "my-report.docx"
+await downloadDocx(blocks, "my-report");
+```
+
+---
+
+## Installation
+
+```bash
+npm install react-word-docx docx
+# or
+yarn add react-word-docx docx
+# or
+pnpm add react-word-docx docx
+```
+
+> **Note:** `docx` is a peer dependency. You must install it alongside this package.
+
+---
+
+## API Reference
+
+### `downloadDocx(blocks, filename?)`
+
+Converts the block array into a `.docx` file and triggers an instant browser download.
+
+| Parameter  | Type      | Default      | Description                                                      |
+| ---------- | --------- | ------------ | ---------------------------------------------------------------- |
+| `blocks`   | `Block[]` | —            | The array of content blocks to render.                           |
+| `filename` | `string`  | `"document"` | The file name. `.docx` is appended automatically if not present. |
+
+```ts
+await downloadDocx(blocks, "quarterly-report");
+// → downloads "quarterly-report.docx"
+```
+
+---
+
+### `blocksToBlob(blocks)`
+
+Returns the raw `Blob` without triggering a download. Useful for server uploads, IndexedDB storage, or custom download handlers.
+
+```ts
+const blob = await blocksToBlob(blocks);
+
+// Upload to a server
+const formData = new FormData();
+formData.append("file", blob, "report.docx");
+await fetch("/api/upload", { method: "POST", body: formData });
+```
+
+---
+
+## Block Type Reference
+
+Every element in the `blocks` array is a **Block** object. The `type` property selects the element; all other properties are optional styling overrides.
+
+| `type`       | Purpose                 | Key Properties           | Notes                                              |
+| ------------ | ----------------------- | ------------------------ | -------------------------------------------------- |
+| `p`          | Paragraph (default)     | `text`                   | Used when `type` is omitted.                       |
+| `h1`         | Heading level 1         | `text`                   | Appears in Word's Navigation Pane.                 |
+| `h2`         | Heading level 2         | `text`                   | Appears in Word's Navigation Pane.                 |
+| `h3`         | Heading level 3         | `text`                   | Appears in Word's Navigation Pane.                 |
+| `h4`         | Heading level 4         | `text`                   | Appears in Word's Navigation Pane.                 |
+| `h5`         | Heading level 5         | `text`                   | Appears in Word's Navigation Pane.                 |
+| `table`      | Data table              | `rows`                   | Row 0 is auto-formatted as a bold header row.      |
+| `ol`         | Ordered / numbered list | `li`                     | True Word list — auto-increments and auto-indents. |
+| `ul`         | Unordered / bullet list | `li`                     | True Word list — bullet `•` with hanging indent.   |
+| `image`      | Embedded image          | `src`, `width`, `height` | URL or base64 data URI; fetched at render time.    |
+| `page-break` | Hard page break         | _(none)_                 | Inserts a `<w:br w:type="page"/>` break.           |
+
+---
+
+## Styling Properties
+
+These properties are available on most block types (see the table above for exceptions).
+
+| Property    | Type                                         | Default   | Description                                                                 |
+| ----------- | -------------------------------------------- | --------- | --------------------------------------------------------------------------- |
+| `text`      | `string`                                     | `""`      | Text content for `p` and heading blocks.                                    |
+| `rows`      | `string[][]`                                 | `[]`      | 2-D array of cell strings for `table` blocks.                               |
+| `li`        | `string[]`                                   | `[]`      | Array of list item strings for `ol` / `ul` blocks.                          |
+| `align`     | `"left" \| "center" \| "right" \| "justify"` | `"left"`  | Text alignment.                                                             |
+| `font`      | `string`                                     | `"Arial"` | Font family name (any font installed on the reader's machine).              |
+| `fontSize`  | `number`                                     | `12`      | Font size **in typographic points**. DocxEngine multiplies by 2 internally. |
+| `bold`      | `boolean`                                    | `false`   | Bold text.                                                                  |
+| `italic`    | `boolean`                                    | `false`   | Italic text.                                                                |
+| `underline` | `boolean`                                    | `false`   | Single underline.                                                           |
+| `color`     | `string`                                     | _(none)_  | Hex colour — `"#FF0000"` or `"FF0000"` (the `#` is stripped automatically). |
+| `src`       | `string`                                     | —         | Image source — absolute URL or `data:image/…;base64,…` URI. (`image` only)  |
+| `width`     | `number`                                     | `400`     | Image render width in pixels. (`image` only)                                |
+| `height`    | `number`                                     | `300`     | Image render height in pixels. (`image` only)                               |
+
+---
+
+## Smart Layer — What DocxEngine Does Automatically
+
+DocxEngine is not just a thin wrapper. It applies a set of opinionated defaults so your output looks professional out of the box:
+
+### 1 — Font Math (half-points)
+
+Microsoft Word stores font sizes in **half-points**, not points. A 12 pt font is stored as `24`. DocxEngine handles this conversion automatically.
+
+```
+You write:  fontSize: 14
+Word gets:  size: 28
+```
+
+You never have to think about this.
+
+---
+
+### 2 — Heading Styles → Navigation Pane
+
+`h1`–`h5` are mapped to Word's **built-in `Heading 1`–`Heading 5` styles**. This means:
+
+- Word's **Navigation Pane** (`View → Navigation Pane`) works immediately.
+- You can generate a **Table of Contents** (`References → Table of Contents`) without any extra work.
+- The document outline structure is preserved when converting to PDF.
+
+---
+
+### 3 — Real Word Lists
+
+`ol` and `ul` use Word's native **Numbering XML** (`numbering.xml`), not simulated indentation with spaces. This means:
+
+- Numbers auto-increment correctly even when items are added or removed.
+- Bullets survive copy-paste between Word documents without breaking.
+- The indent is a proper hanging indent (`left: 0.5"`, `hanging: 0.25"`).
+
+---
+
+### 4 — Table Header Row
+
+For `table` blocks, row 0 is automatically promoted to a **header row**:
+
+- Text is **bold**.
+- Background is set to **`#F2F2F2`** (light gray).
+- The `tableHeader` flag is set so Word repeats the row at the top of multi-page tables.
+
+---
+
+### 5 — Default Paragraph Spacing
+
+All paragraphs receive `spacing: { before: 120, after: 120 }` (120 twips = 6 pt). This prevents the "wall of text" look you get when every element is crammed together without breathing room. List items use tighter `60/60` spacing so they feel cohesive.
+
+---
+
+## Using in a React Component
+
+```tsx
+import React, { useState } from "react";
+import { downloadDocx } from "react-word-docx";
+import type { Block } from "react-word-docx";
+
+const MY_BLOCKS: Block[] = [
+  { type: "h1", text: "Invoice #1042" },
+  { type: "p", text: "Issued: February 2026", italic: true },
+  {
+    type: "table",
+    rows: [
+      ["Item", "Qty", "Unit Price", "Total"],
+      ["Widget Pro", "3", "$29.99", "$89.97"],
+      ["Support Plan", "1", "$199.00", "$199.00"],
+    ],
+  },
+  { type: "p", text: "Grand Total: $288.97", bold: true, align: "right" },
+];
+
+export function InvoiceButton() {
+  const [busy, setBusy] = useState(false);
+
+  async function generate() {
+    setBusy(true);
+    try {
+      await downloadDocx(MY_BLOCKS, "invoice-1042");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <button onClick={generate} disabled={busy}>
+      {busy ? "Generating…" : "Download Invoice (.docx)"}
+    </button>
+  );
+}
+```
+
+---
+
+## Watermarks
+
+Stamp an optional text or image watermark on **every page** by passing a `WatermarkOptions` object as the third argument to `downloadDocx` (or the second argument to `blocksToBlob`).
+
+### Text watermark
+
+```tsx
+await downloadDocx(blocks, "report", {
+  text: "DRAFT",
+  color: "#C0C0C0", // light gray — default
+  fontSize: 72,     // points — default
+});
+```
+
+### Image watermark
+
+The image is fetched (URL) or decoded (base64 data URI) at generation time and floated **behind** the document content, centred on the page.
+
+```tsx
+await downloadDocx(blocks, "report", {
+  image: "https://example.com/logo.png",
+  imageWidth: 300,  // pixels — default
+  imageHeight: 200, // pixels — default
+});
+```
+
+### Text + image together
+
+Both options can be combined in a single call — they both appear in the document header on every page:
+
+```tsx
+await downloadDocx(blocks, "report", {
+  text: "CONFIDENTIAL",
+  color: "#FFB3B3",
+  fontSize: 54,
+  image: "https://example.com/stamp.png",
+  imageWidth: 200,
+  imageHeight: 133,
+});
+```
+
+### `WatermarkOptions` reference
+
+| Property      | Type        | Default              | Description                                                    |
+|---------------|-------------|----------------------|----------------------------------------------------------------|
+| `text`        | `string`    | —                    | Text stamped on every page (e.g. `"DRAFT"`).                   |
+| `color`       | `string`    | `"#C0C0C0"`          | Hex colour of the text watermark.                              |
+| `fontSize`    | `number`    | `72`                 | Text watermark font size in typographic points.                |
+| `image`       | `string`    | —                    | URL or base64 data URI of an image watermark.                  |
+| `imageWidth`  | `number`    | `300`                | Image watermark width in pixels.                               |
+| `imageHeight` | `number`    | `200`                | Image watermark height in pixels.                              |
+| `imageType`   | `ImageType` | auto-detected        | Override the detected format (`"jpg"`, `"png"`, `"gif"`, `"bmp"`). |
+
+---
+
+## Advanced: Getting the Raw Blob
+
+If you need the `Blob` for further processing instead of an automatic download:
+
+```tsx
+import { blocksToBlob } from "react-word-docx";
+
+// Upload directly to an S3-compatible endpoint
+async function saveToCloud(blocks: Block[]) {
+  const blob = await blocksToBlob(blocks);
+
+  const { url } = await fetch("/api/presigned-url").then((r) => r.json());
+  await fetch(url, {
+    method: "PUT",
+    body: blob,
+    headers: {
+      "Content-Type":
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    },
+  });
+}
+```
+
+---
+
+## TypeScript Types
+
+Full type definitions are bundled with the package. Import them directly:
+
+```ts
+import type { Block, BlockType, AlignValue } from "react-word-docx";
+```
+
+### `Block` (interface)
+
+```ts
+interface Block {
+  type?: BlockType; // "p" | "h1" | … | "page-break"
+  text?: string;
+  rows?: string[][];
+  li?: string[];
+  align?: AlignValue; // "left" | "center" | "right" | "justify"
+  font?: string;
+  fontSize?: number; // points — doubled internally for Word
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  color?: string; // hex with or without "#"
+  src?: string; // image — URL or data URI
+  width?: number; // image pixels
+  height?: number; // image pixels
+}
+```
+
+---
+
+## Compatibility
+
+| Environment       | `downloadDocx` | `blocksToBlob` |
+| ----------------- | :------------: | :------------: |
+| Modern browsers   |       ✅       |       ✅       |
+| React 17 / 18     |       ✅       |       ✅       |
+| Next.js (client)  |       ✅       |       ✅       |
+| Next.js (SSR/RSC) |      ❌\*      |       ✅       |
+| Node.js           |      ❌\*      |       ✅       |
+
+> \* `downloadDocx` requires `document` and `URL.createObjectURL` — browser-only APIs. Call it inside a client component or `useEffect`. Use `blocksToBlob` on the server and stream the blob to the response.
+
+---
+
+## License
+
+MIT — use freely in commercial and open-source projects.

package/dist/DocxEngine.d.ts

@@ -0,0 +1,118 @@
+/**
+ * DocxEngine.ts
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Converts a simple JSON "Block Schema" array into a fully-featured native
+ * .docx file and triggers a browser download — no server required.
+ *
+ * Dependencies: docx ^8.x
+ * Browser:      Yes  (uses URL.createObjectURL)
+ * Node / SSR:   blocksToBlob() works; downloadDocx() requires a browser DOM.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+/** All recognised block element types. */
+export type BlockType = "p" | "h1" | "h2" | "h3" | "h4" | "h5" | "table" | "ol" | "ul" | "image" | "page-break";
+/** Text alignment options. */
+export type AlignValue = "left" | "center" | "right" | "justify";
+/**
+ * Image format types supported by docx v9's ImageRun (non-SVG raster formats).
+ * SVG requires a raster fallback image and is not supported by the simple `src` flow.
+ */
+export type ImageType = "jpg" | "png" | "gif" | "bmp";
+/**
+ * A single content block fed to DocxEngine.
+ * All properties are optional — supply only what you need.
+ */
+export interface Block {
+    /**
+     * Element type.
+     * @default "p"
+     */
+    type?: BlockType;
+    /** Text content — used by: p, h1, h2, h3, h4, h5. */
+    text?: string;
+    /**
+     * 2-D array of cell strings — used by: table.
+     * @example [["Name","Age"],["Alice","30"],["Bob","25"]]
+     */
+    rows?: string[][];
+    /**
+     * Array of list item strings — used by: ol, ul.
+     * @example ["First item", "Second item"]
+     */
+    li?: string[];
+    /** Horizontal text alignment. */
+    align?: AlignValue;
+    /**
+     * Font family name.
+     * @default "Arial"
+     */
+    font?: string;
+    /**
+     * Font size in typographic points (e.g. 12).
+     * DocxEngine automatically converts to Word's half-point unit (×2).
+     * @example 14  →  28 half-points inside the .docx
+     */
+    fontSize?: number;
+    /** Bold text. */
+    bold?: boolean;
+    /** Italic text. */
+    italic?: boolean;
+    /** Single underline. */
+    underline?: boolean;
+    /**
+     * Text colour as a hex string.
+     * The leading "#" is optional — both "#FF0000" and "FF0000" are accepted.
+     */
+    color?: string;
+    /**
+     * Image source — used by: image.
+     * Accepts an absolute URL or a base64 data URI.
+     * @example "https://example.com/logo.png"
+     * @example "data:image/png;base64,iVBOR..."
+     */
+    src?: string;
+    /**
+     * Rendered image width in pixels — used by: image.
+     * @default 400
+     */
+    width?: number;
+    /**
+     * Rendered image height in pixels — used by: image.
+     * @default 300
+     */
+    height?: number;
+    /**
+     * Override the auto-detected image format — used by: image.
+     * DocxEngine detects the format from the URL or data URI; set this when
+     * auto-detection produces the wrong result.
+     * @default auto-detected from `src`
+     */
+    imageType?: ImageType;
+}
+/**
+ * Convert an array of Block objects to a `.docx` Blob.
+ *
+ * Use this when you need the raw Blob — e.g. to upload to a server,
+ * store in IndexedDB, or pass to a custom download handler.
+ *
+ * @param blocks  Array of Block descriptors.
+ * @returns       A Blob of MIME type `application/vnd.openxmlformats-officedocument.wordprocessingml.document`.
+ *
+ * @example
+ * const blob = await blocksToBlob(blocks);
+ * await uploadToServer("/api/docs", blob);
+ */
+export declare function blocksToBlob(blocks: Block[]): Promise<Blob>;
+/**
+ * Convert an array of Block objects into a `.docx` file and trigger a
+ * browser download — zero server round-trips.
+ *
+ * @param blocks    Array of Block descriptors.
+ * @param filename  Desired file name. `.docx` is appended automatically if omitted.
+ *
+ * @example
+ * await downloadDocx(myBlocks, "quarterly-report");
+ * // → downloads "quarterly-report.docx"
+ */
+export declare function downloadDocx(blocks: Block[], filename?: string): Promise<void>;
+//# sourceMappingURL=DocxEngine.d.ts.map

package/dist/DocxEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocxEngine.d.ts","sourceRoot":"","sources":["../src/DocxEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuBH,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,OAAO,GACP,YAAY,CAAC;AAEjB,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAGtD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAElB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IAEd,iCAAiC;IACjC,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,iBAAiB;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAoUD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CASjE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,SAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/DocxEngine.js

@@ -0,0 +1,357 @@
+"use strict";
+/**
+ * DocxEngine.ts
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Converts a simple JSON "Block Schema" array into a fully-featured native
+ * .docx file and triggers a browser download — no server required.
+ *
+ * Dependencies: docx ^8.x
+ * Browser:      Yes  (uses URL.createObjectURL)
+ * Node / SSR:   blocksToBlob() works; downloadDocx() requires a browser DOM.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blocksToBlob = blocksToBlob;
+exports.downloadDocx = downloadDocx;
+const docx_1 = require("docx");
+// ─── Internal Constants ───────────────────────────────────────────────────────
+const DEFAULT_FONT = "Arial";
+/** 12 pt expressed in Word half-points. */
+const DEFAULT_SIZE_HP = 24;
+/** Paragraph spacing applied to every block (in twips, 1 pt = 20 twips). */
+const PARA_SPACING = { before: 120, after: 120 };
+/** Lighter spacing inside list items so they feel tighter than block gaps. */
+const LIST_SPACING = { before: 60, after: 60 };
+/** Minimal spacing inside table cells. */
+const CELL_SPACING = { before: 80, after: 80 };
+/** numbering.xml reference IDs — must be unique per document. */
+const OL_REF = "docx-engine-ordered";
+const UL_REF = "docx-engine-unordered";
+// ─── Lookup Maps ──────────────────────────────────────────────────────────────
+const ALIGNMENT_MAP = {
+    left: docx_1.AlignmentType.LEFT,
+    center: docx_1.AlignmentType.CENTER,
+    right: docx_1.AlignmentType.RIGHT,
+    justify: docx_1.AlignmentType.JUSTIFIED,
+};
+const HEADING_MAP = {
+    h1: docx_1.HeadingLevel.HEADING_1,
+    h2: docx_1.HeadingLevel.HEADING_2,
+    h3: docx_1.HeadingLevel.HEADING_3,
+    h4: docx_1.HeadingLevel.HEADING_4,
+    h5: docx_1.HeadingLevel.HEADING_5,
+};
+// ─── Numbering Configuration ──────────────────────────────────────────────────
+// Injected once per document. Produces proper Word list numbering so that
+// items auto-indent, auto-increment, and survive copy-paste into other docs.
+const NUMBERING_CONFIG = {
+    config: [
+        {
+            reference: OL_REF,
+            levels: [
+                {
+                    level: 0,
+                    format: docx_1.LevelFormat.DECIMAL,
+                    text: "%1.",
+                    alignment: docx_1.AlignmentType.LEFT,
+                    style: {
+                        paragraph: {
+                            indent: {
+                                left: (0, docx_1.convertInchesToTwip)(0.5),
+                                hanging: (0, docx_1.convertInchesToTwip)(0.25),
+                            },
+                        },
+                    },
+                },
+            ],
+        },
+        {
+            reference: UL_REF,
+            levels: [
+                {
+                    level: 0,
+                    format: docx_1.LevelFormat.BULLET,
+                    text: "\u2022", // •
+                    alignment: docx_1.AlignmentType.LEFT,
+                    style: {
+                        paragraph: {
+                            indent: {
+                                left: (0, docx_1.convertInchesToTwip)(0.5),
+                                hanging: (0, docx_1.convertInchesToTwip)(0.25),
+                            },
+                        },
+                    },
+                },
+            ],
+        },
+    ],
+};
+// ─── Utility Helpers ──────────────────────────────────────────────────────────
+/**
+ * Strip an optional leading "#" from a hex colour string and upper-case it.
+ * Returns undefined if the input is falsy, preserving optional semantics.
+ */
+function normalizeColor(color) {
+    if (!color)
+        return undefined;
+    const raw = color.startsWith("#") ? color.slice(1) : color;
+    return raw.toUpperCase();
+}
+/**
+ * Resolve the half-point font size to pass to TextRun.
+ * Returns undefined for headings without an explicit override so that Word's
+ * built-in heading style governs the size (keeps Navigation Pane hierarchy).
+ */
+function resolveSize(block, isHeading) {
+    if (block.fontSize !== undefined)
+        return block.fontSize * 2;
+    return isHeading ? undefined : DEFAULT_SIZE_HP;
+}
+/**
+ * Build a styled TextRun from a block's formatting properties.
+ * Shared by list items and reusable wherever a single run suffices.
+ */
+function makeTextRun(text, block, bold) {
+    var _a;
+    return new docx_1.TextRun({
+        text,
+        font: (_a = block.font) !== null && _a !== void 0 ? _a : DEFAULT_FONT,
+        size: block.fontSize ? block.fontSize * 2 : DEFAULT_SIZE_HP,
+        bold: bold !== null && bold !== void 0 ? bold : block.bold,
+        italics: block.italic,
+        underline: block.underline ? { type: docx_1.UnderlineType.SINGLE } : undefined,
+        color: normalizeColor(block.color),
+    });
+}
+// ─── Block Builders ───────────────────────────────────────────────────────────
+/** Build a Paragraph node for "p" and "h1"–"h5" blocks. */
+function buildParagraph(block) {
+    var _a, _b, _c, _d;
+    const type = (_a = block.type) !== null && _a !== void 0 ? _a : "p";
+    const isHeading = type !== "p" && type in HEADING_MAP;
+    return new docx_1.Paragraph({
+        heading: isHeading ? HEADING_MAP[type] : undefined,
+        alignment: block.align ? ALIGNMENT_MAP[block.align] : docx_1.AlignmentType.LEFT,
+        spacing: PARA_SPACING,
+        children: [
+            new docx_1.TextRun({
+                text: (_b = block.text) !== null && _b !== void 0 ? _b : "",
+                font: (_c = block.font) !== null && _c !== void 0 ? _c : DEFAULT_FONT,
+                size: resolveSize(block, isHeading),
+                // For headings: let Word's style govern boldness unless the caller
+                // explicitly sets bold. For "p" blocks default to non-bold.
+                bold: (_d = block.bold) !== null && _d !== void 0 ? _d : (isHeading ? undefined : false),
+                italics: block.italic,
+                underline: block.underline ? { type: docx_1.UnderlineType.SINGLE } : undefined,
+                color: normalizeColor(block.color),
+            }),
+        ],
+    });
+}
+/** Build one Paragraph per list item with the correct numbering reference. */
+function buildListItems(block, listType) {
+    var _a;
+    const ref = listType === "ol" ? OL_REF : UL_REF;
+    return ((_a = block.li) !== null && _a !== void 0 ? _a : []).map((item) => new docx_1.Paragraph({
+        numbering: { reference: ref, level: 0 },
+        spacing: LIST_SPACING,
+        children: [makeTextRun(item, block)],
+    }));
+}
+/**
+ * Build a full-width Table.
+ * The first row is automatically styled as a header:
+ *   • Bold text
+ *   • Light gray background (#F2F2F2)
+ *   • tableHeader flag set so Word repeats it on multi-page tables
+ */
+function buildTable(block) {
+    var _a;
+    const rows = (_a = block.rows) !== null && _a !== void 0 ? _a : [];
+    return new docx_1.Table({
+        width: { size: 100, type: docx_1.WidthType.PERCENTAGE },
+        rows: rows.map((row, rowIndex) => {
+            const isHeader = rowIndex === 0;
+            return new docx_1.TableRow({
+                tableHeader: isHeader,
+                children: row.map((cellText) => new docx_1.TableCell({
+                    shading: isHeader
+                        ? {
+                            fill: "F2F2F2",
+                            type: docx_1.ShadingType.CLEAR,
+                            color: "auto",
+                        }
+                        : undefined,
+                    children: [
+                        new docx_1.Paragraph({
+                            spacing: CELL_SPACING,
+                            children: [makeTextRun(cellText, block, isHeader ? true : block.bold)],
+                        }),
+                    ],
+                })),
+            });
+        }),
+    });
+}
+/**
+ * Infer the image format from a URL path or data URI MIME type.
+ * docx v9 requires an explicit `type` discriminator on every ImageRun.
+ * Falls back to "png" — the safest raster format for Word's renderer.
+ */
+function detectImageType(src) {
+    const lower = src.toLowerCase();
+    if (lower.includes("image/jpeg") || /\.jpe?g(\?|$|#)/.test(lower))
+        return "jpg";
+    if (lower.includes("image/gif") || /\.gif(\?|$|#)/.test(lower))
+        return "gif";
+    if (lower.includes("image/bmp") || /\.bmp(\?|$|#)/.test(lower))
+        return "bmp";
+    if (lower.includes("image/png") || /\.png(\?|$|#)/.test(lower))
+        return "png";
+    return "png"; // safe default
+}
+/**
+ * Fetch or decode an image block and wrap it in a Paragraph > ImageRun.
+ *
+ * Supports:
+ *   - Absolute URLs  (fetched via the browser's fetch API)
+ *   - base64 data URIs  (decoded to raw base64 without the header)
+ *
+ * If the image cannot be loaded a warning is logged and an empty Paragraph
+ * is returned so the rest of the document renders without throwing.
+ */
+async function buildImage(block) {
+    var _a, _b, _c;
+    if (!block.src) {
+        console.warn("[DocxEngine] Image block is missing a `src` property — skipping.");
+        return new docx_1.Paragraph({ children: [] });
+    }
+    // docx v9 requires an explicit type discriminator on ImageRun.
+    const type = (_a = block.imageType) !== null && _a !== void 0 ? _a : detectImageType(block.src);
+    let data;
+    if (block.src.startsWith("data:")) {
+        // ── base64 data URI ───────────────────────────────────────────────────────
+        const commaIdx = block.src.indexOf(",");
+        if (commaIdx === -1) {
+            console.warn("[DocxEngine] Malformed data URI in image block — skipping.");
+            return new docx_1.Paragraph({ children: [] });
+        }
+        // docx's ImageRun accepts raw base64 (no "data:…;base64," prefix).
+        data = block.src.slice(commaIdx + 1);
+    }
+    else {
+        // ── Remote URL ────────────────────────────────────────────────────────────
+        try {
+            const response = await fetch(block.src);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status} ${response.statusText}`);
+            }
+            data = await response.arrayBuffer();
+        }
+        catch (err) {
+            console.warn("[DocxEngine] Failed to fetch image:", err, "— skipping.");
+            return new docx_1.Paragraph({ children: [] });
+        }
+    }
+    return new docx_1.Paragraph({
+        alignment: block.align ? ALIGNMENT_MAP[block.align] : docx_1.AlignmentType.LEFT,
+        spacing: PARA_SPACING,
+        children: [
+            new docx_1.ImageRun({
+                type,
+                data,
+                transformation: {
+                    width: (_b = block.width) !== null && _b !== void 0 ? _b : 400,
+                    height: (_c = block.height) !== null && _c !== void 0 ? _c : 300,
+                },
+            }),
+        ],
+    });
+}
+/** Insert a hard page break as a zero-content Paragraph. */
+function buildPageBreak() {
+    return new docx_1.Paragraph({ children: [new docx_1.PageBreak()] });
+}
+// ─── Document Assembly ────────────────────────────────────────────────────────
+/**
+ * Walk the blocks array and dispatch each block to its builder.
+ * Returns a flat array of docx child nodes ready to place in a Section.
+ */
+async function assembleChildren(blocks) {
+    var _a;
+    const children = [];
+    for (const block of blocks) {
+        const type = (_a = block.type) !== null && _a !== void 0 ? _a : "p";
+        switch (type) {
+            case "page-break":
+                children.push(buildPageBreak());
+                break;
+            case "table":
+                children.push(buildTable(block));
+                break;
+            case "ol":
+            case "ul":
+                children.push(...buildListItems(block, type));
+                break;
+            case "image":
+                children.push(await buildImage(block));
+                break;
+            // "p" | "h1" | "h2" | "h3" | "h4" | "h5"
+            default:
+                children.push(buildParagraph(block));
+        }
+    }
+    return children;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Convert an array of Block objects to a `.docx` Blob.
+ *
+ * Use this when you need the raw Blob — e.g. to upload to a server,
+ * store in IndexedDB, or pass to a custom download handler.
+ *
+ * @param blocks  Array of Block descriptors.
+ * @returns       A Blob of MIME type `application/vnd.openxmlformats-officedocument.wordprocessingml.document`.
+ *
+ * @example
+ * const blob = await blocksToBlob(blocks);
+ * await uploadToServer("/api/docs", blob);
+ */
+async function blocksToBlob(blocks) {
+    const children = await assembleChildren(blocks);
+    const doc = new docx_1.Document({
+        numbering: NUMBERING_CONFIG,
+        sections: [{ children }],
+    });
+    return docx_1.Packer.toBlob(doc);
+}
+/**
+ * Convert an array of Block objects into a `.docx` file and trigger a
+ * browser download — zero server round-trips.
+ *
+ * @param blocks    Array of Block descriptors.
+ * @param filename  Desired file name. `.docx` is appended automatically if omitted.
+ *
+ * @example
+ * await downloadDocx(myBlocks, "quarterly-report");
+ * // → downloads "quarterly-report.docx"
+ */
+async function downloadDocx(blocks, filename = "document") {
+    const blob = await blocksToBlob(blocks);
+    const name = filename.endsWith(".docx") ? filename : `${filename}.docx`;
+    const url = URL.createObjectURL(blob);
+    try {
+        const anchor = document.createElement("a");
+        anchor.href = url;
+        anchor.download = name;
+        anchor.style.display = "none";
+        document.body.appendChild(anchor);
+        anchor.click();
+        document.body.removeChild(anchor);
+    }
+    finally {
+        // Always release the object URL to prevent memory leaks.
+        URL.revokeObjectURL(url);
+    }
+}
+//# sourceMappingURL=DocxEngine.js.map

package/dist/DocxEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocxEngine.js","sourceRoot":"","sources":["../src/DocxEngine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * react-word-docx
+ * Public surface — re-export everything a consumer needs.
+ */
+export { blocksToBlob, downloadDocx } from "./DocxEngine";
+export type { AlignValue, Block, BlockType, ImageType } from "./DocxEngine";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadDocx = exports.blocksToBlob = void 0;
+/**
+ * react-word-docx
+ * Public surface — re-export everything a consumer needs.
+ */
+var DocxEngine_1 = require("./DocxEngine");
+Object.defineProperty(exports, "blocksToBlob", { enumerable: true, get: function () { return DocxEngine_1.blocksToBlob; } });
+Object.defineProperty(exports, "downloadDocx", { enumerable: true, get: function () { return DocxEngine_1.downloadDocx; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,2CAA0D;AAAjD,0GAAA,YAAY,OAAA;AAAE,0GAAA,YAAY,OAAA"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "react-word-docx",
+  "version": "1.0.0",
+  "description": "Convert a simple JSON Block Schema into a native .docx file from any React / browser app.",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "type-check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "dependencies": {
+    "docx": "^9.5.3"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "typescript": "^5.4.0",
+    "vite": "^7.3.1"
+  },
+  "keywords": [
+    "docx",
+    "word",
+    "react",
+    "typescript",
+    "document",
+    "export"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JayBeeLearn/react-word-docx"
+  }
+}