@themarioga/grid-editor 8.10.1 → 9.0.0-beta.2

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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.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
+- **BREAKING:** `settings_panel: 'sidebar'` turns `active_target` on. A click
+  in a column or a section is also where the toolbar's buttons add, as with
+  `active_target: true`, instead of the end of the canvas.
+- **BREAKING:** `settings_panel: 'sidebar'` with `active_target: false` throws
+  a `TypeError` from the constructor, which builds nothing.
+
 ## [8.10.1] - 2026-10-13
 
 ### Fixed

package/README.md

@@ -182,7 +182,7 @@ has, with the options it was made with, and warns once.
 | `destroy` | — | `this` | Deinit, drop the controls, unbind, forget the instance |
 | `changeView` | `breakpoint` | `this` | `'xs'`…`'xxl'`, or `'all'` to edit every breakpoint at once, with one class |
 | `getView` | — | `String` | The view the editor is in |
-| `getActiveTarget` | — | `Element` | With `active_target`, the column or section the toolbar adds to, or `null` |
+| `getActiveTarget` | — | `Element` | With `active_target` - which the `'sidebar'` panel turns on - the column or section the toolbar adds to, or `null` |
 | `setActiveTarget` | `node` | `this` | Make a column or section - an element or a selector - the one the toolbar adds to, or `null` for none |
 | `getSelected` | — | `Element` | With `settings_panel: 'sidebar'`, the node whose settings the sidebar shows, or `null`. Always `null` without it |
 | `setSelected` | `node` | `this` | With `settings_panel: 'sidebar'`, show the settings of a node with settings - an element or a selector - or `null` for none. It does not unfold a sidebar that is folded away, and does nothing without the `'sidebar'` panel |
@@ -398,7 +398,7 @@ new GridEditor('#myGrid', {
 });
 ```
 
-__`active_target`:__ Whether a click in a column or a section makes it where the toolbar's buttons add. Default `false`, and the toolbar adds at the end of the canvas. With `true`, the column or section clicked last - marked with a dashed outline - gets what a button makes at its end, as if the button had been dropped there: a text or a container goes into a column as it is, and into a section in a row of its own; a row goes into a column as a nested row; a section, which only the canvas takes, goes to the canvas just after the block the target is in. The toolbar's paste button pastes there too. Escape, a click in the canvas on no column or section, a click again on the target's own background or drawer (not on a tool or on what it holds), or deleting the target clears it, and the toolbar adds at the end of the canvas again; dragging a button still drops it where it is let go.
+__`active_target`:__ Whether a click in a column or a section makes it where the toolbar's buttons add. Default `false`, and the toolbar adds at the end of the canvas. With `settings_panel: 'sidebar'` it is on without being asked, and giving `false` with the sidebar throws a `TypeError`: both follow the node last clicked. With `true`, the column or section clicked last - marked with a dashed outline - gets what a button makes at its end, as if the button had been dropped there: a text or a container goes into a column as it is, and into a section in a row of its own; a row goes into a column as a nested row; a section, which only the canvas takes, goes to the canvas just after the block the target is in. The toolbar's paste button pastes there too. Escape, a click in the canvas on no column or section, a click again on the target's own background or drawer (not on a tool or on what it holds), or deleting the target clears it, and the toolbar adds at the end of the canvas again; dragging a button still drops it where it is let go.
 
 ```javascript
 const ge = new GridEditor('#myGrid', { active_target: true });
@@ -479,7 +479,7 @@ __`settings_panel`:__ Where the settings a gear opens are shown - a node's id, i
 | `'popover'` | A Bootstrap popover under the gear, or over it when there is more room there; a press anywhere else puts it away |
 | `'modal'` | A Bootstrap modal |
 | `'inline'` | Unfolded in the drawer itself |
-| `'sidebar'` | An offcanvas that stays on the right while you edit, and makes room for itself on the page. A click on any node of the canvas shows its settings, and there is no gear |
+| `'sidebar'` | An offcanvas that stays on the right while you edit, and makes room for itself on the page. A click on any node of the canvas shows its settings, and there is no gear. It turns `active_target` on, so the node clicked is also where the toolbar adds; `active_target: false` with it is an error |
 
 Each is titled after its node ("Column settings"), the node is outlined while its settings are open, and Escape closes them. The editor opens and places them itself, with Bootstrap's markup and css: a page needs neither Popper nor Bootstrap's javascript, and the modal is Bootstrap's own when Bootstrap is there. [example/utilities.html](example/utilities.html) switches between the four.
 
@@ -844,6 +844,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:

package/UPGRADING.md

@@ -1,3 +1,22 @@
+Upgrading from grid-editor `8.x` to `9.0`
+=========================================
+
+* __`settings_panel: 'sidebar'` turns `active_target` on.__ A click on a
+  column or a section is now also where the toolbar's buttons add - a text, a
+  row, a container, a paste - instead of the end of the canvas. There is no
+  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`.
+
+
 Upgrading from grid-editor `7.x` to `8.0`
 =========================================