Extensions now support defining keyboard shortcuts (aseprite#1403, aseprite#3239)

Author: dacap

data/strings/en.ini

@@ -1282,6 +1282,7 @@ download_themes = Download Themes
 open_theme_folder = Open &Folder
 language_extensions = Languages
 theme_extensions = Themes
+keys_extensions = Keyboard Shortcuts
 script_extensions = Scripts
 palette_extensions = Palettes
 dithering_matrix_extensions = Dithering Matrices

src/app/app_menus.cpp

@@ -1,5 +1,5 @@
 // Aseprite
-// Copyright (C) 2019-2020  Igara Studio S.A.
+// Copyright (C) 2019-2022  Igara Studio S.A.
 // Copyright (C) 2001-2018  David Capello
 //
 // This program is distributed under the terms of
@@ -16,6 +16,7 @@
 #include "app/commands/commands.h"
 #include "app/commands/params.h"
 #include "app/console.h"
+#include "app/extensions.h"
 #include "app/gui_xml.h"
 #include "app/i18n/strings.h"
 #include "app/recent_files.h"
@@ -417,10 +418,22 @@ void AppMenus::reload()
     .FirstChild("gui")
     .FirstChild("keyboard").ToElement();
 
+  // From a fresh start, load the default keys
   KeyboardShortcuts::instance()->clear();
   KeyboardShortcuts::instance()->importFile(xmlKey, KeySource::Original);
 
-  // Load user settings
+  // Load extension-defined keys
+  for (const Extension* ext : App::instance()->extensions()) {
+    if (ext->isEnabled() &&
+        ext->hasKeys()) {
+      for (const auto& kv : ext->keys()) {
+        KeyboardShortcuts::instance()->importFile(
+          kv.second, KeySource::ExtensionDefined);
+      }
+    }
+  }
+
+  // Load user-defined keys
   {
     ResourceFinder rf;
     rf.includeUserDir("user.aseprite-keys");

src/app/commands/cmd_keyboard_shortcuts.cpp

@@ -58,7 +58,7 @@ using namespace ui;
 
 namespace {
 
-typedef std::map<AppMenuItem*, KeyPtr> MenuKeys;
+using MenuKeys = std::map<AppMenuItem*, KeyPtr>;
 
 class HeaderSplitter : public Splitter {
 public:
@@ -195,7 +195,7 @@ class KeyItem : public ListItem {
     window.openWindowInForeground();
 
     if (window.isModified()) {
-      m_key->disableAccel(origAccel);
+      m_key->disableAccel(origAccel, KeySource::UserDefined);
       if (!window.accel().isEmpty())
         m_key->add(window.accel(), KeySource::UserDefined, m_keys);
     }
@@ -215,7 +215,7 @@ class KeyItem : public ListItem {
             accel.toString())) != 1)
       return;
 
-    m_key->disableAccel(accel);
+    m_key->disableAccel(accel, KeySource::UserDefined);
     window()->layout();
   }
 

src/app/commands/cmd_options.cpp

@@ -1277,6 +1277,10 @@ class OptionsWindow : public app::gen::Options {
     if (extensionsList()->getItemsCount() > 0)
       return;
 
+    loadExtensionsByCategory(
+      Extension::Category::Keys,
+      Strings::options_keys_extensions());
+
     loadExtensionsByCategory(
       Extension::Category::Languages,
       Strings::options_language_extensions());

src/app/extensions.cpp

@@ -257,6 +257,12 @@ void Extension::executeExitActions()
 #endif // ENABLE_SCRIPTING
 }
 
+void Extension::addKeys(const std::string& id, const std::string& path)
+{
+  m_keys[id] = path;
+  updateCategory(Category::Keys);
+}
+
 void Extension::addLanguage(const std::string& id, const std::string& path)
 {
   m_languages[id] = path;
@@ -456,8 +462,10 @@ bool Extension::isDefaultTheme() const
 
 void Extension::updateCategory(const Category newCategory)
 {
-  if (m_category == Category::None)
+  if (m_category == Category::None ||
+      m_category == Category::Keys) {
     m_category = newCategory;
+  }
   else if (m_category != newCategory)
     m_category = Category::Multiple;
 }
@@ -1016,6 +1024,24 @@ Extension* Extensions::loadExtension(const std::string& path,
 
   auto contributes = json["contributes"];
   if (contributes.is_object()) {
+    // Keys
+    auto keys = contributes["keys"];
+    if (keys.is_array()) {
+      for (const auto& key : keys.array_items()) {
+        std::string keyId = key["id"].string_value();
+        std::string keyPath = key["path"].string_value();
+
+        // The path must be always relative to the extension
+        keyPath = base::join_path(path, keyPath);
+
+        LOG("EXT: New keyboard shortcuts '%s' in '%s'\n",
+            keyId.c_str(),
+            keyPath.c_str());
+
+        extension->addKeys(keyId, keyPath);
+      }
+    }
+
     // Languages
     auto languages = contributes["languages"];
     if (languages.is_array()) {
@@ -1130,6 +1156,7 @@ Extension* Extensions::loadExtension(const std::string& path,
 
 void Extensions::generateExtensionSignals(Extension* extension)
 {
+  if (extension->hasKeys()) KeysChange(extension);
   if (extension->hasLanguages()) LanguagesChange(extension);
   if (extension->hasThemes()) ThemesChange(extension);
   if (extension->hasPalettes()) PalettesChange(extension);

src/app/extensions.h

@@ -1,5 +1,5 @@
 // Aseprite
-// Copyright (C) 2020  Igara Studio S.A.
+// Copyright (C) 2020-2022  Igara Studio S.A.
 // Copyright (C) 2017-2018  David Capello
 //
 // This program is distributed under the terms of
@@ -36,6 +36,7 @@ namespace app {
   public:
     enum class Category {
       None,
+      Keys,
       Languages,
       Themes,
       Scripts,
@@ -78,10 +79,12 @@ namespace app {
     const std::string& displayName() const { return m_displayName; }
     const Category category() const { return m_category; }
 
+    const ExtensionItems& keys() const { return m_keys; }
     const ExtensionItems& languages() const { return m_languages; }
     const ExtensionItems& themes() const { return m_themes; }
     const ExtensionItems& palettes() const { return m_palettes; }
 
+    void addKeys(const std::string& id, const std::string& path);
     void addLanguage(const std::string& id, const std::string& path);
     void addTheme(const std::string& id, const std::string& path);
     void addPalette(const std::string& id, const std::string& path);
@@ -98,6 +101,7 @@ namespace app {
     bool canBeDisabled() const;
     bool canBeUninstalled() const;
 
+    bool hasKeys() const { return !m_keys.empty(); }
     bool hasLanguages() const { return !m_languages.empty(); }
     bool hasThemes() const { return !m_themes.empty(); }
     bool hasPalettes() const { return !m_palettes.empty(); }
@@ -119,6 +123,7 @@ namespace app {
     void exitScripts();
 #endif
 
+    ExtensionItems m_keys;
     ExtensionItems m_languages;
     ExtensionItems m_themes;
     ExtensionItems m_palettes;
@@ -180,6 +185,7 @@ namespace app {
     std::vector<Extension::DitheringMatrixInfo> ditheringMatrices();
 
     obs::signal<void(Extension*)> NewExtension;
+    obs::signal<void(Extension*)> KeysChange;
     obs::signal<void(Extension*)> LanguagesChange;
     obs::signal<void(Extension*)> ThemesChange;
     obs::signal<void(Extension*)> PalettesChange;

src/app/ui/key.h

@@ -1,5 +1,5 @@
 // Aseprite
-// Copyright (C) 2018  Igara Studio S.A.
+// Copyright (C) 2018-2022  Igara Studio S.A.
 // Copyright (C) 2001-2018  David Capello
 //
 // This program is distributed under the terms of
@@ -15,6 +15,7 @@
 #include "ui/accelerator.h"
 
 #include <memory>
+#include <utility>
 #include <vector>
 
 namespace ui {
@@ -31,6 +32,7 @@ namespace app {
 
   enum class KeySource {
     Original,
+    ExtensionDefined,
     UserDefined
   };
 
@@ -98,20 +100,20 @@ namespace app {
     return KeyAction(int(a) & int(b));
   }
 
+  using KeySourceAccelList = std::vector<std::pair<KeySource, ui::Accelerator>>;
+
   class Key {
   public:
+    Key(const Key& key);
     Key(Command* command, const Params& params, KeyContext keyContext);
     Key(KeyType type, tools::Tool* tool);
     explicit Key(KeyAction action);
     explicit Key(WheelAction action);
 
     KeyType type() const { return m_type; }
-    const ui::Accelerators& accels() const {
-      return (m_useUsers ? m_users: m_accels);
-    }
-    const ui::Accelerators& origAccels() const { return m_accels; }
-    const ui::Accelerators& userAccels() const { return m_users; }
-    const ui::Accelerators& userRemovedAccels() const { return m_userRemoved; }
+    const ui::Accelerators& accels() const;
+    const KeySourceAccelList addsKeys() const { return m_adds; }
+    const KeySourceAccelList delsKeys() const { return m_dels; }
 
     void add(const ui::Accelerator& accel,
              const KeySource source,
@@ -122,9 +124,15 @@ namespace app {
     bool isLooselyPressed() const;
 
     bool hasAccel(const ui::Accelerator& accel) const;
-    void disableAccel(const ui::Accelerator& accel);
+    bool hasUserDefinedAccels() const;
+
+    // The KeySource indicates from where the key was disabled
+    // (e.g. if it was removed from an extension-defined file, or from
+    // user-defined).
+    void disableAccel(const ui::Accelerator& accel,
+                      const KeySource source);
 
-    // Resets user accelerators to the original ones.
+    // Resets user accelerators to the original & extension-defined ones.
     void reset();
 
     void copyOriginalToUser();
@@ -144,10 +152,11 @@ namespace app {
 
   private:
     KeyType m_type;
-    ui::Accelerators m_accels;      // Default accelerators (from gui.xml)
-    ui::Accelerators m_users;       // User-defined accelerators
-    ui::Accelerators m_userRemoved; // Default accelerators removed by user
-    bool m_useUsers;
+    KeySourceAccelList m_adds;
+    KeySourceAccelList m_dels;
+    // Final list of accelerators after processing the
+    // addition/deletion of extension-defined & user-defined keys.
+    mutable std::unique_ptr<ui::Accelerators> m_accels;
     KeyContext m_keycontext;
 
     // for KeyType::Command
@@ -161,8 +170,8 @@ namespace app {
     WheelAction m_wheelAction;
   };
 
-  typedef std::shared_ptr<Key> KeyPtr;
-  typedef std::vector<KeyPtr> Keys;
+  using KeyPtr = std::shared_ptr<Key> ;
+  using Keys = std::vector<KeyPtr>;
 
   std::string convertKeyContextToString(KeyContext keyContext);
   std::string convertKeyContextToUserFriendlyString(KeyContext keyContext);