@veztraa/report-designer 0.3.1 → 0.3.3

package/README.md

@@ -2,7 +2,7 @@
 
 **[Documentation & Live Demo →](https://report-forge.veztraa.com)**
 
-Embeddable React drag-and-drop PDF report designer — a visual report builder you can drop into any React app. Give your users a Figma-like canvas for data-driven PDFs: drag-and-drop elements, live preview, undo/redo, dark mode, and `{{field}}` data bindings.
+Embeddable React drag-and-drop PDF report designer for any React app. Features a **signature element** (draw on pad, type in handwriting font, or upload an image), **multilingual text** (Chinese, Japanese, Korean, Arabic, Hebrew, Hindi, Thai via Noto fonts), **repeating container bands**, live PDF preview, 50-step undo/redo, dark mode, and `{{field}}` data bindings.
 
 Styles auto-inject on mount — no CSS import required.
 
@@ -105,13 +105,15 @@ Passed as the `elements` prop. Use `include` (whitelist) **or** `exclude` (black
 | `include` | `ElementType[]` | Only these types appear, in this order. |
 | `exclude` | `ElementType[]` | Hide these types (ignored when `include` is set). |
 
-`ElementType` is one of: `text`, `richtext`, `table`, `container`, `image`, `chart`, `barcode`, `qrcode`, `rectangle`, `line`, `pagebreak`.
+`ElementType` is one of: `text` · `richtext` · `table` · `container` · `image` · `chart` · `barcode` · `qrcode` · `rectangle` · `line` · `pagebreak` · `signature`
 
 ## Features
 
 - **Drag-and-drop canvas** — snap-to-grid with alignment guides, 8-handle resize, arrow-key nudge
 - **Live PDF preview rendered off the main thread** (Web Worker) — debounced 400ms with an adaptive loading UI, so even large multi-hundred-page reports never freeze the tab
 - **Repeating containers** (data-bound bands) with **automatic pagination** — tables, rich text, and bands flow across pages, keeping items together where they fit
+- **Signature element** — draw on a pad, type a name in a handwriting font (Great Vibes, Dancing Script, Pacifico, Sacramento), or upload an image; editable after creation
+- **Multilingual text** — set `fontFamily` to any Noto font to render Chinese, Japanese, Korean, Arabic, Hebrew, Hindi, Thai, or Latin/Cyrillic/Greek content in the same PDF
 - **50-step undo / redo**
 - **Light / dark theme** and a fully customizable accent color
 - Header, body, and footer sections
@@ -119,6 +121,36 @@ Passed as the `elements` prop. Use `include` (whitelist) **or** `exclude` (black
 - Data panel for `{{field}}` preview bindings
 - **JSON-first** — the designer is a visual editor for a plain `Template` object; load with `report`, save with `toolbar.onSave`
 
+## Signature element
+
+Add a signature block from the palette (or include `type: "signature"` in your template). In the Properties panel you can:
+
+- **Draw** — freehand on a signature pad, then click Use
+- **Type** — enter a name displayed in a handwriting font (Great Vibes, Dancing Script, Pacifico, or Sacramento)
+- **Upload** — paste or upload a signature image (PNG/JPEG)
+- Set signer **name**, **title**, **label**, and **date** sub-fields
+- Choose **alignment** (left / center / right), **ink color**, and **line color**
+- Toggle the baseline rule on/off
+
+Drawn signatures are stored as base64 PNGs inside the template JSON and render identically in the PDF.
+
+## Multilingual support
+
+Set `style.fontFamily` on any text element to a Noto family to render non-Latin scripts:
+
+| Font family | Script |
+|---|---|
+| `Noto Sans` | Latin, Cyrillic, Greek |
+| `Noto Sans SC` | Chinese Simplified |
+| `Noto Sans JP` | Japanese |
+| `Noto Sans KR` | Korean |
+| `Noto Sans Arabic` | Arabic |
+| `Noto Sans Hebrew` | Hebrew |
+| `Noto Sans Devanagari` | Hindi |
+| `Noto Sans Thai` | Thai |
+
+Fonts are loaded from CDN on first use and are available in both the canvas preview and the rendered PDF. CJK fonts include automatic per-character line-breaking.
+
 ## Keyboard shortcuts
 
 | Shortcut | Action |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@veztraa/report-designer",
-  "version": "0.3.1",
-  "description": "Embeddable React drag-and-drop PDF report designer — visual canvas, live preview, undo/redo, dark mode, and data-bound elements.",
+  "version": "0.3.3",
+  "description": "Embeddable React drag-and-drop PDF report designer — visual canvas, live preview, undo/redo, dark mode, signature element (draw/type/upload), handwriting fonts, multilingual Noto fonts, and data-bound repeating containers.",
   "keywords": [
     "pdf",
     "pdf-designer",
@@ -44,8 +44,8 @@
   },
   "dependencies": {
     "zustand": "^5.0.2",
-    "@veztraa/report-core": "0.3.1",
-    "@veztraa/report-renderer": "^0.3.1"
+    "@veztraa/report-core": "0.3.3",
+    "@veztraa/report-renderer": "^0.3.3"
   },
   "devDependencies": {
     "@react-pdf/renderer": "^4.1.6",