fusuma 3.11.0 → 3.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55410ba5fd5d7543fe4089aa09f2af2229400d49be8d9572f1e6d41af79b1079
-  data.tar.gz: fcf73fd3254b1f9ba58cf61ba5705bbbd76d8448e91a2d12a12fc08116325367
+  metadata.gz: '064986ef807ceb1aa5ce1d021cdaf8931e44a1099fe8b72cd6aee283bc7ccf3a'
+  data.tar.gz: 31d80cdd2c54c1f12a4e55005c4393ae4c3683ed0a0c3a4e506090cc2c0f4f73
 SHA512:
-  metadata.gz: fac06a520334b1ff98e9467f06633e801c2bd86e56860232c54bfd0a36df2cec77bc8fa1f97a8ceafbb6561221fb5ea9bd4766e58e37b780c9ba450a8ec2fdd2
-  data.tar.gz: 28098f90c6aadef6f44f4f0cc6c3e8244e9921f9e70a1dc18293f9374d1e4d3a7c0d340458e2d758bfa9a5fb0e8c2fa124170f40e8c4b3fee03de142ed1c7196
+  metadata.gz: f27789347f194611db15b63f8cd8f04c47e3737ad2349950ab2a9210612f76a96f166c50a136bd2e4e22cce8dd9e640f89a7f8be19f2c282b4a071650cc26af1
+  data.tar.gz: 86d0e0bac6c527e7453f4495bde1e58b4b74942b3670ee313d1a7f0323c7a4f9e5ed44c33f64614357ff8b38bbf9e265e074abbd6ce5915925233e3c7f3adc01

data/lib/fusuma/device.rb

@@ -41,9 +41,7 @@ module Fusuma
       def all
         @all ||= fetch_devices.partition do |d|
           d.capabilities.match?(/gesture/)
-        end.flatten.tap do |devices|
-          log_if_changed(devices)
-        end
+        end.flatten
       end
 
       # @return [Array]
@@ -59,22 +57,10 @@ module Fusuma
       def reset
         @all = nil
         @available = nil
-        @previous_device_ids = nil
       end
 
       private
 
-      # Log device list only when it changes
-      # @param devices [Array<Device>]
-      #: (Array[Device]) -> void
-      def log_if_changed(devices)
-        device_ids = devices.map(&:id).sort
-        return if @previous_device_ids == device_ids
-
-        MultiLogger.debug(detected_devices: devices.map { |d| {id: d.id, name: d.name} })
-        @previous_device_ids = device_ids
-      end
-
       # @return [Array]
       #: () -> Array[Device]
       def fetch_devices

data/lib/fusuma/plugin/base.rb

@@ -8,8 +8,8 @@ module Fusuma
   module Plugin
     # Create a Plugin Class with extending this class
     class Base
-      # when inherited from subclass
-      #: (Class) -> Array[untyped]
+      # Callback when a subclass inherits from this class.
+      # Registers the subclass with the plugin manager.
       def self.inherited(subclass)
         super
 
@@ -18,7 +18,11 @@ module Fusuma
           raise "Plugin class #{subclass.name} must be defined in a file."
         end
 
-        subclass_path = locations.first.path
+        subclass_path = locations.first&.path
+        if subclass_path.nil?
+          raise "Plugin class #{subclass.name} must have a valid file path."
+        end
+
         Manager.add(plugin_class: subclass, plugin_path: subclass_path)
       end
 
@@ -29,13 +33,12 @@ module Fusuma
       end
 
       # @abstract override `#shutdown` to implement
-      #: () -> nil
+      #: () -> void
       def shutdown
       end
 
       # config parameter name and Type of the value of parameter
       # @return [Hash]
-      #: () -> Hash[Symbol, Array[Class] | Class]
       def config_param_types
         raise NotImplementedError, "override #{self.class.name}##{__method__}"
       end
@@ -43,7 +46,8 @@ module Fusuma
       # @param key [Symbol]
       # @param base [Config::Index]
       # @return [Object]
-      #: (?Symbol?) -> (String | Hash[untyped, untyped] | Float | bool)?
+      #: () -> Hash[untyped, untyped]
+      #: (Symbol) -> untyped
       def config_params(key = nil)
         @config_params ||= {}
         if @config_params["#{config_index.cache_key},#{key}"]

data/lib/fusuma/plugin/manager.rb

@@ -86,9 +86,13 @@ module Fusuma
         #                              Detectors::PinchDetector,
         #                              Detectors::SwipeDetector]}
 
-        # @param plugin_class [Class]
-        # return [Hash, false]
-        #: (plugin_class: Class, plugin_path: String) -> Array[untyped]?
+        # Register a plugin class with the manager.
+        # @param plugin_class [Class] the plugin class to register
+        # @param plugin_path [String] the file path of the plugin
+        # @return [false] if plugin already exists
+        # @return [nil] if search_key was already required
+        # @return [Array<String>] loaded plugin paths from gems
+        #: (plugin_class: Class, plugin_path: String) -> (Array[String] | false | nil)
         def add(plugin_class:, plugin_path:)
           return false if exist?(plugin_class: plugin_class, plugin_path: plugin_path)
 
@@ -110,7 +114,7 @@ module Fusuma
           manager.require_siblings_from_gems
         end
 
-        #: () -> void
+        #: () -> bool
         def require_base_plugins
           require_relative "base"
           require_relative "events/event"
@@ -122,7 +126,7 @@ module Fusuma
           require_relative "executors/executor"
         end
 
-        #: () -> Hash[untyped, untyped]
+        #: () -> Hash[String, Array[Class]]
         def plugins
           @plugins ||= {}
         end
@@ -138,10 +142,16 @@ module Fusuma
           @load_paths ||= []
         end
 
-        # @param plugin_class [Class]
-        # @return [Boolean]
+        # Check if a plugin class is already registered.
+        # Note: This intentionally returns false if only the path is registered,
+        # allowing multiple plugin classes from the same file (e.g., subclasses).
+        # @param plugin_class [Class] the plugin class to check
+        # @param plugin_path [String] the file path of the plugin (not used for existence check)
+        # @return [Boolean] true if plugin class is already registered
         #: (plugin_class: Class, plugin_path: String) -> bool
         def exist?(plugin_class:, plugin_path:)
+          # Skip existence check if path is already in load_paths
+          # This allows multiple classes from the same file to be registered
           return false if load_paths.include?(plugin_path)
 
           base = plugin_class.superclass.name

data/lib/fusuma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fusuma
-  VERSION = "3.11.0"
+  VERSION = "3.11.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusuma
 version: !ruby/object:Gem::Version
-  version: 3.11.0
+  version: 3.11.1
 platform: ruby
 authors:
 - iberianpig
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 2026-01-10 00:00:00.000000000 Z
 dependencies: []
 description: Fusuma is multitouch gesture recognizer. This gem makes your touchpad
   on Linux able to recognize swipes or pinchs and assign command to them. Read installation