kivydk 0.0.6.dev1__tar.gz → 0.10.5.dev1__tar.gz

{kivydk-0.0.6.dev1/kivydk.egg-info → kivydk-0.10.5.dev1}/PKG-INFO

@@ -1,73 +1,73 @@
-Metadata-Version: 2.4
-Name: kivydk
-Version: 0.0.6.dev1
-Summary: Kivy Desktop Kit — A desktop-focused UI toolkit for Kivy
-Author: ASI
-License: MIT License
-        
-        Copyright (c) 2026 Afanase Ioan (ASI)
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-Project-URL: Documentation, https://kmcasi.github.io/KivyDK/
-Project-URL: Source, https://github.com/kmcasi/KivyDK
-Project-URL: Issues, https://github.com/kmcasi/KivyDK/issues
-Keywords: kivy,kivydk,desktop,kit,ui,uix,material
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: End Users/Desktop
-Classifier: Intended Audience :: Information Technology
-Classifier: Intended Audience :: Science/Research
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Artistic Software
-Classifier: Topic :: Games/Entertainment
-Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
-Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera
-Classifier: Topic :: Multimedia :: Graphics :: Presentation
-Classifier: Topic :: Multimedia :: Graphics :: Viewers
-Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
-Classifier: Topic :: Multimedia :: Video :: Display
-Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
-Classifier: Topic :: Scientific/Engineering :: Visualization
-Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Classifier: Topic :: Software Development :: User Interfaces
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: kivy>=2.3.1
-Requires-Dist: Pygments>=2.19.2
-Requires-Dist: pillow>=12.1.0
-Provides-Extra: docs
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx-copybutton; extra == "docs"
-Requires-Dist: sphinx_design; extra == "docs"
-Requires-Dist: sphinx-doclang; extra == "docs"
-Requires-Dist: sphinx-localtoc; extra == "docs"
-Requires-Dist: furo; extra == "docs"
-
-# KivyDK — Kivy Desktop Kit
-    # WIP - Work in progress
-
-KivyDK is a desktop-focused UI toolkit for Kivy, designed to support multi-monitor workflows, editor-inspired widgets, and advanced behaviors like hover, click and bind.
-
+Metadata-Version: 2.4
+Name: kivydk
+Version: 0.10.5.dev1
+Summary: Kivy Desktop Kit — A desktop-focused UI toolkit for Kivy
+Author: ASI
+License: MIT License
+        
+        Copyright (c) 2026 Afanase Ioan (ASI)
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Project-URL: Documentation, https://kmcasi.github.io/KivyDK/
+Project-URL: Source, https://github.com/kmcasi/KivyDK
+Project-URL: Issues, https://github.com/kmcasi/KivyDK/issues
+Keywords: kivy,kivydk,desktop,kit,ui,uix,material
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Artistic Software
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera
+Classifier: Topic :: Multimedia :: Graphics :: Presentation
+Classifier: Topic :: Multimedia :: Graphics :: Viewers
+Classifier: Topic :: Multimedia :: Sound/Audio :: Players :: MP3
+Classifier: Topic :: Multimedia :: Video :: Display
+Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: kivy>=2.3.1
+Requires-Dist: Pygments>=2.19.2
+Requires-Dist: pillow>=12.1.0
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-copybutton; extra == "docs"
+Requires-Dist: sphinx_design; extra == "docs"
+Requires-Dist: sphinx-doclang; extra == "docs"
+Requires-Dist: sphinx-localtoc; extra == "docs"
+Requires-Dist: furo; extra == "docs"
+
+# KivyDK — Kivy Desktop Kit
+    # WIP - Work in progress
+
+KivyDK is a desktop-focused UI toolkit for Kivy, designed to support multi-monitor workflows, editor-inspired widgets, and advanced behaviors like hover, click and bind.
+

{kivydk-0.0.6.dev1 → kivydk-0.10.5.dev1}/kivydk/__init__.py

@@ -18,8 +18,8 @@ __all__ = ("DIR_ROOT", "DIR_DATA", "DIR_FONTS")
 #//|>-----------------------------------------------------------------------------------------------------------------<|
 #//| KivyDK directories
 #//|>-----------------------------------------------------------------------------------------------------------------<|
-from importlib.resources import files  # noqa: E402
-from importlib.resources.abc import Traversable  # noqa: E402
+from importlib.resources import files               # noqa: E402
+from importlib.resources.abc import Traversable     # noqa: E402
 
 #: The root directory of the KivyDK package.
 DIR_ROOT: Traversable = files(__name__)
@@ -43,6 +43,6 @@ _auto_register_fonts(DIR_FONTS)
 #//| KivyDK initialization log
 #//|>-----------------------------------------------------------------------------------------------------------------<|
 from kivydk._version import VERSION_STRING  # noqa: E402
-from kivydk.logger import Logger  # noqa: E402
+from kivydk.logger import Logger            # noqa: E402
 
 Logger.InfoS(version=VERSION_STRING, root_directory=DIR_ROOT)

{kivydk-0.0.6.dev1 → kivydk-0.10.5.dev1}/kivydk/_version.py

@@ -9,8 +9,8 @@ __all__ = (
 #//| Version variables
 #//|>--------------------------------------------------------<|
 MAJOR: int = 0
-MINOR: int = 0
-MICRO: int = 6
+MINOR: int = 10
+MICRO: int = 5
 VERSION_STRING: str = f"{MAJOR}.{MINOR}.{MICRO}"
 
 
@@ -21,9 +21,9 @@ RELEASE: bool = False
 
 # If is not the stable release, update `VERSION_STRING` to reflect that
 if not RELEASE:
-    VERSION_STRING.join(f".dev{max(1, REVISION)}")
+    VERSION_STRING = f"{VERSION_STRING}.dev{max(1, REVISION)}"
 elif REVISION:
-    VERSION_STRING.join(f".rev{REVISION}")
+    VERSION_STRING = f"{VERSION_STRING}.rev{REVISION}"
 
 
 #//| exec'd from setup.py ?

kivydk-0.10.5.dev1/kivydk/app.py

@@ -0,0 +1,49 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 25 Sep 2026. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+# noinspection SpellCheckingInspection
+"""
+This module provides the KivyDK-specific :class:`App` implementation responsible for preparing
+and maintaining the runtime environment required by KivyDK. It initializes internal managers,
+registers event systems such as the :class:`PointerManager` and serves as the integration point
+for framework-level features including the settings panel, theme management and tool execution utilities.
+"""
+__all__ = ("App",)
+
+#// IMPORT
+from kivy.app import App as App_kivy
+
+from kivydk.manager.pointer import PointerManager
+from kivydk.manager.tooltip import TooltipManager
+
+
+#// LOGIC
+class App(App_kivy):
+    """
+    KiviDK application class extending Kivy's :class:`~kivy.app.App`.
+
+    It ensures that KiviDK specific managers are properly initialized and registered with the
+    window system, allowing the framework's internal logic such as pointer routing or tooltip
+    to operate correctly during the application's lifecycle.
+    """
+
+    def __init__(self, **kwargs) -> None:
+        super().__init__(**kwargs)
+
+        # Private variables
+        self.__kdk_pointer_manager: PointerManager = PointerManager()
+        self.__kdk_tooltip_manager: TooltipManager = TooltipManager()
+
+    def _run_prepare(self) -> None:
+        """ Prepare the current application for the main loop. """
+        super()._run_prepare()
+
+        self.root_window.register_event_manager(self.__kdk_pointer_manager)
+        self.root_window.register_event_manager(self.__kdk_tooltip_manager)
+
+    def _stop(self, *args) -> None:
+        """ Stop the current application by leaving the main loop. """
+        self.root_window.unregister_event_manager(self.__kdk_pointer_manager)
+        self.root_window.unregister_event_manager(self.__kdk_tooltip_manager)
+
+        super()._stop(*args)

kivydk-0.10.5.dev1/kivydk/debug.py

@@ -0,0 +1,63 @@
+#// IMPORT
+from kivy.uix.button import Button
+from kivy.uix.boxlayout import BoxLayout
+
+from kivydk.uix.behavior.tooltip import TooltipBehavior
+from kivydk.uix.tooltip import Tooltip
+
+
+#// LOGIC
+class MyButton(TooltipBehavior, Button):
+    pass
+
+
+class TestTooltip(BoxLayout):
+    def __init__(self, **kwargs):
+        super().__init__(spacing=16, size_hint_y=None, height=128, **kwargs)
+
+        # Default tooltip
+        self.add_widget(
+            MyButton(
+                text="Default tooltip",
+                tooltip_text="This is a simple tooltip.",
+            )
+        )
+
+        # Tooltip on the cursor position
+        self.add_widget(
+            MyButton(
+                text="Cursor tooltip",
+                tooltip_text="Tooltip shown on the cursor side.",
+                tooltip_side="cursor",
+            )
+        )
+
+        # Custom tooltip widget
+        custom_tooltip = Tooltip(
+            background_color=[0.2, 0.2, 0.2, 1.0],
+            foreground_color=[0.9, 0.9, 0.9, 1.0],
+            font_size="24sp",
+            size_max=(256, 64)
+        )
+
+        self.add_widget(
+            MyButton(
+                text="Custom tooltip",
+                tooltip_text="This tooltip is interactive and uses a custom widget.",
+                tooltip_template=custom_tooltip,
+                tooltip_side="left",
+                tooltip_interactive=True,
+                tooltip_offset="24sp",
+            )
+        )
+
+
+#// RUN FILE
+if __name__ == "__main__":
+    from kivydk.app import App
+
+    class Example(App):
+        def build(self):
+            return TestTooltip()
+
+    Example().run()

{kivydk-0.0.6.dev1/kivydk/uix → kivydk-0.10.5.dev1/kivydk}/manager/__init__.py

@@ -11,7 +11,3 @@ complex interactions work consistently across the framework without requiring ma
     These modules are not intended for direct use. All managers are created and controlled internally by KivyDK
     and developers typically never need to interact with them directly.
 """
-__all__ = ("HoverManager",)
-
-#// IMPORT
-from kivydk.uix.manager.hover import HoverManager