@dmitryvim/form-builder 0.2.17 → 0.2.19

package/README.md

@@ -289,8 +289,10 @@ See [Integration Guide](docs/integration.md) for detailed setup instructions.
 - **Textarea**: Multi-line with configurable rows
 - **Number**: Numeric input with min/max/step/decimals
 - **Select**: Dropdown with options and default values
+- **Switcher**: Segmented button group (all options visible, ≤4) — same data model as Select
 - **Colour**: Colour picker with hex values (single or palette)
 - **Slider**: Range slider with linear/exponential scales (v0.2.7+)
+- **Table**: 2D editable grid with cell merging, keyboard navigation, readonly mode
 - **File**: Single file upload with preview and type restrictions
 - **Files**: Multiple file upload with grid layout and drag-and-drop
 - **Container**: Nested containers with repeatable array support
@@ -653,6 +655,62 @@ The `enableIf` system is designed for future expansion:
 }
 ```
 
+### Table Element
+
+An editable 2D grid with plain-text cells, cell merging, and full keyboard navigation.
+
+**Schema:**
+
+```json
+{
+  "type": "table",
+  "key": "data",
+  "label": "Data Table",
+  "columns": 4,
+  "rows": 5
+}
+```
+
+**Data format** — a 2D array of strings with optional merge definitions:
+
+```json
+{
+  "cells": [
+    ["Product", "Q1", "Q2", "Q3"],
+    ["Widget A", "100", "120", "140"],
+    ["Widget B", "80", "90", "95"]
+  ],
+  "merges": [
+    { "row": 0, "col": 0, "rowspan": 1, "colspan": 2 }
+  ]
+}
+```
+
+**Keyboard shortcuts:**
+
+- **Tab / Shift+Tab** — move to next/previous cell
+- **Arrow keys** — navigate between cells
+- **Enter** — confirm cell and move down
+- **Escape** — cancel edit
+- **Ctrl+M** — merge selected cells
+- **Ctrl+Shift+M** — split merged cell
+
+**Properties:**
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `columns` | `number` | `3` | Initial column count |
+| `rows` | `number` | `3` | Initial row count |
+
+**Features:**
+
+- Plain-text cell editing via `contentEditable`
+- First row visually highlighted as header
+- Add/remove rows and columns at runtime
+- Cell merging (colspan/rowspan) with Ctrl+M
+- Readonly mode renders a static `<table>`
+- Full i18n support (6 translation keys: `tableAddRow`, `tableAddColumn`, `tableRemoveRow`, `tableRemoveColumn`, `tableMergeCells`, `tableSplitCell`)
+
 ## Documentation
 
 - **API Reference** - See above for core methods and theming