@themarioga/grid-editor 9.0.0-beta.1 → 9.0.0-beta.3

package/CHANGELOG.md

@@ -5,6 +5,34 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 
+## [9.0.0-beta.3] - 2026-10-20
+
+### Added
+- history: a plugin for undo and redo. Ctrl+Z goes back a step and Ctrl+Y or
+  Ctrl+Shift+Z comes forward (⌘ on a Mac), and two buttons on the right of the
+  toolbar do the same. A step is the canvas `delay` ms after the last change,
+  and the node selected and the target are chosen again by where they were.
+  `history: { shortcuts, buttons, max, delay }`; `undo()`, `redo()`,
+  `canUndo()`, `canRedo()` and `clearHistory()`; the events `after-undo`,
+  `after-redo` and `history-change`.
+- A feature plugin's `toolbar` item can have an `action` in place of `create`:
+  a button that does something instead of adding a block, and `disabled`.
+- The plugin handle has `setSelected(node)` and `setActiveTarget(node)`.
+
+## [9.0.0-beta.2] - 2026-10-20
+
+### Added
+- clipboard: Ctrl+C and Ctrl+V (⌘C and ⌘V) with `active_target`, and so with
+  the sidebar. Ctrl+C copies the node selected or the target; Ctrl+V pastes
+  into the target, or the node selected, by the paste rules the toolbar and
+  the tools already have. The keys stay the browser's while a field or a
+  text is edited, while text is selected, or while a panel or a dialog is
+  open. They use the plugin's own store, never the system clipboard, and go
+  to the editor used last. `clipboard: { shortcuts: false }` turns them off;
+  `after-copy` says `source: 'shortcut'` for them.
+- The plugin handle has `getSelected()`, `getActiveTarget()`, `panelOpen()`
+  and `contains(node)`.
+
 ## [9.0.0-beta.1] - 2026-10-20
 
 ### Changed

package/README.md

@@ -36,6 +36,7 @@ from any web server, or from GitHub Pages, with no build step.
 | [example/summernote.html](example/summernote.html) | Summernote instead of tinyMCE | [live](https://themarioga.github.io/grid-editor/example/summernote.html) |
 | [example/clipboard.html](example/clipboard.html) | Copy and paste, within an editor, between two, and between tabs | [live](https://themarioga.github.io/grid-editor/example/clipboard.html) |
 | [example/wrap_content.html](example/wrap_content.html) | Non-bootstrap markup wrapped into the grid | [live](https://themarioga.github.io/grid-editor/example/wrap_content.html) |
+| [example/history.html](example/history.html) | The history plugin: undo and redo, with the keyboard and the toolbar | [live](https://themarioga.github.io/grid-editor/example/history.html) |
 | [example/autosave.html](example/autosave.html) | The autosave plugin: drafts kept as the user edits, offered back after a reload; import and export | [live](https://themarioga.github.io/grid-editor/example/autosave.html) |
 | [example/adapter.html](example/adapter.html) | A page written for 6.x, with jQuery, running unchanged through the adapter | [live](https://themarioga.github.io/grid-editor/example/adapter.html) |
 
@@ -844,6 +845,24 @@ A paste is an add like any other: `before-add-*` and `after-add-*` with
 `source: 'paste'`, and canceling the first turns it away. A copy fires
 `grideditor:after-copy`.
 
+With `active_target` - which `settings_panel: 'sidebar'` turns on - there are
+shortcuts too, Ctrl+C and Ctrl+V (⌘C and ⌘V on a Mac). Ctrl+C copies the node
+selected in the sidebar or, with none, the target, as its *Copy* tool would.
+Ctrl+V pastes into the target as the toolbar's paste button would - a row at
+its end, a section after the block it is in - and a text, a container or an
+element at the end of a target column, as its *Paste* tool would; with no
+target, into the node selected, as its *Paste* tool would. What does not fit
+there is not pasted anywhere else. They go to the editor used last, and leave
+the keys to the browser while a field or a text is being edited, while text
+is selected (for Ctrl+C), while a settings panel, a dialog or the delete
+confirmation is open, and outside editing. They use the same store as the
+tools: the system clipboard is not read or written. `after-copy` says
+`source: 'shortcut'` for a copy made with them.
+
+__`clipboard`:__ `{ shortcuts }`, the plugin's settings. `shortcuts` defaults to
+`active_target`; `false` turns them off, and `true` without `active_target`
+warns and does nothing.
+
 ### Autosave
 
 A plugin:
@@ -910,6 +929,57 @@ version of grid-editor reads it*, so one saved before an upgrade that changes
 what `getHtml` gives is not offered after it. Drafts are a safety net, not a
 place to keep work.
 
+### Undo and redo
+
+A plugin:
+
+```html
+<script src="grid-editor/dist/plugins/grideditor.history.min.js"></script>
+```
+
+What is edited is kept, step by step, in memory. <kbd>Ctrl</kbd>+<kbd>Z</kbd>
+(<kbd>⌘</kbd>+<kbd>Z</kbd> on a Mac) goes back one step, and
+<kbd>Ctrl</kbd>+<kbd>Y</kbd> or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Z</kbd>
+comes forward again; two buttons on the right of the toolbar do the same. A
+step is what the canvas is `delay` milliseconds after the last change, so a
+drag, a resize or a burst of typing is one. A change made after going back ends
+what could be redone. The steps go with the page: they are not kept in the
+storage, and a draft restored by the autosave plugin is one more step.
+
+```javascript
+new GridEditor('#myGrid', {
+    history: {
+        shortcuts: true,   // the keys; false leaves them to the browser
+        buttons: true,     // the toolbar's buttons
+        max: 50,           // the steps that can be undone
+        delay: 500,        // milliseconds after the last change that make a step
+    },
+});
+```
+
+The keys stay the browser's, or the text editor's, while a field or a text is
+edited, while a panel or a dialog is open, and while the canvas is in preview or
+showing its source; what was typed becomes a step when it is done. They go to
+the editor used last. Going to a step makes the canvas again, so an open text
+closes, and the node selected in the sidebar and the target are chosen again by
+where they were: nothing is selected if there is no node there any more.
+
+| Method | Returns | What it does |
+| --- | --- | --- |
+| `undo()` | `Boolean` | Goes back a step; `false` when there is none, or the canvas is not being edited or a drag is going on |
+| `redo()` | `Boolean` | Comes forward a step |
+| `canUndo()` | `Boolean` | Whether there is a step to go back to. A change not yet a step counts |
+| `canRedo()` | `Boolean` | Whether there is one to come forward to |
+| `clearHistory()` | `Boolean` | What there is now is the first step, with nothing before it or after it: for a page that loads another document |
+
+The methods are there only when the plugin is loaded.
+
+| Event | Payload | Fires |
+| --- | --- | --- |
+| `grideditor:after-undo` | `canvas`, `html`, `source` (`shortcut`, `tool` or `api`) | after the canvas went back a step |
+| `grideditor:after-redo` | `canvas`, `html`, `source` | after it came forward |
+| `grideditor:history-change` | `canvas`, `canUndo`, `canRedo` | when either changed: for a page with buttons of its own, which `buttons: false` leaves to it |
+
 ### Containers
 
 Tabs, accordions, popups, carousels and cards. A tabs, accordion, popup or

package/UPGRADING.md

@@ -7,6 +7,11 @@ Upgrading from grid-editor `8.x` to `9.0`
   setting to have the sidebar without it. Clicking the canvas's background, or
   pressing Escape, clears the target and the toolbar adds at the end of the
   canvas again, as before.
+* __With the clipboard plugin and `active_target`, Ctrl+C and Ctrl+V copy
+  and paste nodes.__ They act on the node selected or the target, and leave
+  the keys alone while a field or a text has the focus or text is selected.
+  `clipboard: { shortcuts: false }` turns them off. This came in
+  `9.0.0-beta.2`.
 * __`settings_panel: 'sidebar'` with `active_target: false` throws.__ The
   constructor raises a `TypeError` and builds nothing. Leave `active_target`
   out, or give it `true`.