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

package/dist/grideditor.d.ts

@@ -161,7 +161,7 @@ export interface GridEditorOptions {
     drawer_overflow?: 'menu' | 'wrap';
     /** The add buttons in categories - rows, content, and a plugin's own - one shown at a time, chosen with tabs. Default false. */
     toolbar_groups?: boolean;
-    /** A click in a column or a section makes it where the toolbar's buttons add. Default false. */
+    /** A click in a column or a section makes it where the toolbar's buttons add. Default false, and true with settings_panel 'sidebar', which throws if it is given false. */
     active_target?: boolean;
     /** The plugins to use, of any kind; null is every one loaded. */
     plugins?: string[] | null;
@@ -178,6 +178,8 @@ export interface GridEditorOptions {
     elements?: { enabled?: boolean | 'auto'; selector?: string; auto?: boolean; types?: ElementType[] };
     /** The autosave plugin: what is edited, kept in the browser's storage as it changes. */
     autosave?: AutosaveOptions;
+    /** The clipboard plugin. `shortcuts`: Ctrl+C and Ctrl+V on the node selected or the target; default active_target. */
+    clipboard?: { shortcuts?: boolean };
     custom_filter?: CustomFilter | CustomFilter[] | '';
     valid_col_sizes?: ColumnSize[];
     valid_col_offsets?: number[];
@@ -195,7 +197,7 @@ export interface GridEditorOptions {
     locale_strings?: Record<string, string>;
     callbacks?: Partial<GridEditorCallbacks>;
     confirm_delete?: boolean;
-    /** Where a node's settings open. 'sidebar' is a panel that stays on the right while editing, showing the selected node's; one editor per page has it. */
+    /** Where a node's settings open. 'sidebar' is a panel that stays on the right while editing, showing the selected node's; one editor per page has it. It turns active_target on, and the constructor throws a TypeError if active_target is false. */
     settings_panel?: 'offcanvas' | 'popover' | 'modal' | 'inline' | 'sidebar';
     /** The 'sidebar' panel. */
     sidebar?: SidebarSettings;
@@ -271,7 +273,7 @@ export interface Payload {
     parent: HTMLElement | null;
     canvas: HTMLElement;
     breakpoint: View;
-    source: 'api' | 'tool' | 'dragdrop' | 'paste' | 'panel' | string;
+    source: 'api' | 'tool' | 'dragdrop' | 'paste' | 'panel' | 'shortcut' | string;
     /** A pane inside a container. */
     container?: HTMLElement;
 }
@@ -487,7 +489,7 @@ export declare class GridEditor {
     /** Take the editor off: the markup stays, everything else goes. */
     destroy(): this;
     changeView(view: View): this;
-    /** The column or region the toolbar adds to, or null. Null without active_target. */
+    /** The column or region the toolbar adds to, or null. Null without active_target, which settings_panel 'sidebar' turns on. */
     getActiveTarget(): HTMLElement | null;
     /** Make a column or region, or the first a selector matches, where the toolbar adds; null for none. */
     setActiveTarget(target: HTMLElement | string | null): this;

package/dist/grideditor.esm.js

@@ -604,7 +604,7 @@ function build(instance, baseElem, optionsOrMethod) {
     "toolbar_groups": false,
     // The add buttons in categories, one shown at a time, picked with tabs
     "active_target": false,
-    // A click in a column makes it where the toolbar's buttons add
+    // A click in a column makes it where the toolbar's buttons add. The 'sidebar' panel turns it on
     "element_tools": [],
     // Host tools on element drawers, same shape as row_tools
     "element_classes": [],
@@ -662,6 +662,12 @@ function build(instance, baseElem, optionsOrMethod) {
   Object.keys(NESTED_SETTINGS).forEach(function(name) {
     settings[name] = Object.assign({}, NESTED_SETTINGS[name], settings[name]);
   });
+  if (settings.settings_panel === "sidebar") {
+    if (optionsOrMethod && optionsOrMethod.active_target === false) {
+      throw new TypeError('grid-editor: settings_panel "sidebar" needs active_target; leave it out or set it to true');
+    }
+    settings.active_target = true;
+  }
   var canvas, mainControls, wrapper, addRowGroup, addContainerGroup, layoutDropdown, htmlTextArea;
   var curView = settings.default_view;
   var confirmDialog = null;
@@ -2343,6 +2349,41 @@ function build(instance, baseElem, optionsOrMethod) {
       refreshToolbar,
       toolbarItems: function(name) {
         return mainControls ? all(mainControls, '[data-ge-toolbar="feature"][data-ge-feature="' + name + '"]') : [];
+      },
+      getSelected: function() {
+        return panelMode() === "sidebar" ? selected : null;
+      },
+      getActiveTarget: function() {
+        return settings.active_target ? activeTarget : null;
+      },
+      // What keeps Escape from the selection and the target, and an
+      // inline panel unfolded in a drawer, which Escape leaves alone
+      panelOpen: function() {
+        if (openSettingsState || dialogState) {
+          return true;
+        }
+        if (confirmDialog && hasClass(confirmDialog, "show")) {
+          return true;
+        }
+        return panelMode() === "inline" && all(canvas, ".ge-tools-drawer > .ge-details").some(visible);
+      },
+      // The toolbar and the settings panels are outside the canvas
+      contains: function(node) {
+        if (!node || node.nodeType !== 1) {
+          return false;
+        }
+        if (canvas.contains(node) || mainControls && mainControls.contains(node)) {
+          return true;
+        }
+        if (dialogPanel && dialogPanel.contains(node)) {
+          return true;
+        }
+        if (confirmDialog && confirmDialog.contains(node)) {
+          return true;
+        }
+        return Object.keys(settingsPanels).some(function(mode) {
+          return settingsPanels[mode].contains(node);
+        });
       }
     };
   }
@@ -5107,7 +5148,7 @@ GridEditor.t = translate;
 GridEditor._plainHtml = plainHtml;
 GridEditor.Sortable = null;
 GridEditor.bootstrap = null;
-GridEditor.version = false ? "dev" : "8.10.1";
+GridEditor.version = false ? "dev" : "9.0.0-beta.2";
 GridEditor.locales = {
   en: {
     "tool.move": "Move",

package/dist/grideditor.js

@@ -605,7 +605,7 @@
       "toolbar_groups": false,
       // The add buttons in categories, one shown at a time, picked with tabs
       "active_target": false,
-      // A click in a column makes it where the toolbar's buttons add
+      // A click in a column makes it where the toolbar's buttons add. The 'sidebar' panel turns it on
       "element_tools": [],
       // Host tools on element drawers, same shape as row_tools
       "element_classes": [],
@@ -663,6 +663,12 @@
     Object.keys(NESTED_SETTINGS).forEach(function(name) {
       settings[name] = Object.assign({}, NESTED_SETTINGS[name], settings[name]);
     });
+    if (settings.settings_panel === "sidebar") {
+      if (optionsOrMethod && optionsOrMethod.active_target === false) {
+        throw new TypeError('grid-editor: settings_panel "sidebar" needs active_target; leave it out or set it to true');
+      }
+      settings.active_target = true;
+    }
     var canvas, mainControls, wrapper, addRowGroup, addContainerGroup, layoutDropdown, htmlTextArea;
     var curView = settings.default_view;
     var confirmDialog = null;
@@ -2344,6 +2350,41 @@
         refreshToolbar,
         toolbarItems: function(name) {
           return mainControls ? all(mainControls, '[data-ge-toolbar="feature"][data-ge-feature="' + name + '"]') : [];
+        },
+        getSelected: function() {
+          return panelMode() === "sidebar" ? selected : null;
+        },
+        getActiveTarget: function() {
+          return settings.active_target ? activeTarget : null;
+        },
+        // What keeps Escape from the selection and the target, and an
+        // inline panel unfolded in a drawer, which Escape leaves alone
+        panelOpen: function() {
+          if (openSettingsState || dialogState) {
+            return true;
+          }
+          if (confirmDialog && hasClass(confirmDialog, "show")) {
+            return true;
+          }
+          return panelMode() === "inline" && all(canvas, ".ge-tools-drawer > .ge-details").some(visible);
+        },
+        // The toolbar and the settings panels are outside the canvas
+        contains: function(node) {
+          if (!node || node.nodeType !== 1) {
+            return false;
+          }
+          if (canvas.contains(node) || mainControls && mainControls.contains(node)) {
+            return true;
+          }
+          if (dialogPanel && dialogPanel.contains(node)) {
+            return true;
+          }
+          if (confirmDialog && confirmDialog.contains(node)) {
+            return true;
+          }
+          return Object.keys(settingsPanels).some(function(mode) {
+            return settingsPanels[mode].contains(node);
+          });
         }
       };
     }
@@ -5108,7 +5149,7 @@
   GridEditor._plainHtml = plainHtml;
   GridEditor.Sortable = null;
   GridEditor.bootstrap = null;
-  GridEditor.version = false ? "dev" : "8.10.1";
+  GridEditor.version = false ? "dev" : "9.0.0-beta.2";
   GridEditor.locales = {
     en: {
       "tool.move": "Move",