kivydk 0.0.3.dev2__tar.gz

kivydk-0.0.3.dev2/LICENSE

@@ -0,0 +1,21 @@
+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.

kivydk-0.0.3.dev2/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src/kivydk/data *

kivydk-0.0.3.dev2/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: kivydk
+Version: 0.0.3.dev2
+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: 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: 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_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.3.dev2/README.md

@@ -0,0 +1,5 @@
+# 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.3.dev2/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=82", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kivydk"
+version = "0.0.3.dev2"
+description = "Kivy Desktop Kit — A desktop-focused UI toolkit for Kivy"
+authors = [{ name = "ASI" }]
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.12"
+keywords = ["kivy", "kivydk", "desktop", "kit", "ui", "uix", "material"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: End Users/Desktop",
+  "Intended Audience :: Information Technology",
+  "Intended Audience :: Science/Research",
+  "Natural Language :: English",
+  "Operating System :: OS Independent",
+  "Operating System :: Microsoft :: Windows",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Topic :: Artistic Software",
+  "Topic :: Games/Entertainment",
+  "Topic :: Multimedia :: Graphics :: 3D Rendering",
+  "Topic :: Multimedia :: Graphics :: Capture :: Digital Camera",
+  "Topic :: Multimedia :: Graphics :: Presentation",
+  "Topic :: Multimedia :: Graphics :: Viewers",
+  "Topic :: Multimedia :: Sound/Audio :: Players :: MP3",
+  "Topic :: Multimedia :: Video :: Display",
+  "Topic :: Scientific/Engineering :: Human Machine Interfaces",
+  "Topic :: Scientific/Engineering :: Visualization",
+  "Topic :: Software Development :: Libraries :: Application Frameworks",
+  "Topic :: Software Development :: User Interfaces",
+]
+dependencies = [
+    "kivy>=2.3.1",
+    "Pygments>=2.19.2",
+    "pillow>=12.1.0",
+]
+
+[project.urls]
+Source = "https://github.com/kmcasi/KivyDK"
+Issues = "https://github.com/kmcasi/KivyDK/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+license-files = []
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+kivydk = ["data/**/*"]
+
+[project.optional-dependencies]
+docs = [
+    "sphinx",
+    "sphinx-copybutton",
+    "sphinx_design",
+    "sphinx_localtoc",
+    "furo",
+]

kivydk-0.0.3.dev2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kivydk-0.0.3.dev2/src/kivydk/__init__.py

@@ -0,0 +1,48 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 14 Jan 2026. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+"""
+The ``kivydk`` module provides the core infrastructure, global configuration and shared resources used throughout
+the KivyDK framework. While most functionality is implemented in submodules, the top-level package exposes a small
+set of global paths that define the runtime environment for all KivyDK components.
+"""
+__all__ = ("DIR_ROOT", "DIR_DATA", "DIR_FONTS")
+
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| KivyDK monkey-patch's
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+# from kivydk.tools.monkey.patch import MonkeyPatchAll
+
+# MonkeyPatchAll()
+
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| KivyDK directories
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+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__)
+
+#: The base directory containing framework data files such as fonts, themes and other assets.
+DIR_DATA: Traversable = DIR_ROOT / "data"
+
+#: Directory containing all font resources automatically registered at startup.
+DIR_FONTS: Traversable = DIR_DATA / "fonts"
+
+
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| KivyDK initialization helpers
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+from kivydk.core.resources.fonts import _auto_register_fonts  # noqa: E402
+
+_auto_register_fonts(DIR_FONTS)
+
+
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| KivyDK initialization log
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+from kivydk._version import VERSION_STRING  # noqa: E402
+from kivydk.logger import Logger  # noqa: E402
+
+Logger.InfoS(version=VERSION_STRING, root_directory=DIR_ROOT)

kivydk-0.0.3.dev2/src/kivydk/_version.py

@@ -0,0 +1,31 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 21 Jan 2026. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+__all__ = (
+    "MAJOR", "MINOR", "MICRO", "REVISION",
+    "RELEASE", "VERSION_STRING"
+)
+
+#//| Version variables
+#//|>--------------------------------------------------------<|
+MAJOR: int = 0
+MINOR: int = 0
+MICRO: int = 3
+VERSION_STRING: str = f"{MAJOR}.{MINOR}.{MICRO}"
+
+
+#//| Development | Revision variables
+#//|>--------------------------------------------------------<|
+REVISION: int = 0
+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)}")
+elif REVISION:
+    VERSION_STRING.join(f".{REVISION}")
+
+
+#//| exec'd from setup.py ?
+#//|>--------------------------------------------------------<|
+__version__: str = VERSION_STRING

kivydk-0.0.3.dev2/src/kivydk/core/__init__.py

@@ -0,0 +1,19 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 17 Apr 2026. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+"""
+This ``core`` package contains the low-level building blocks that power the entire KivyDK framework.
+The module provide fundamental logic and system utilities that higher-level UI components rely on.
+
+The purpose of ``core`` is to centralize functionality that must remain lightweight, reusable and independent of any
+specific editor or widget. Most editors and UI components in KivyDK depend on these modules to provide
+consistent behavior across the entire ecosystem.
+
+.. caution::
+    Unlike the widgets found in :mod:`kivydk.uix`, the classes and functions in ``core`` are **not** intended to be
+    used directly as visual elements. They represent internal mechanisms that support the framework’s behavior.
+
+.. important::
+    If a feature appears to be missing at the widget level, consider checking :mod:`kivydk.uix` first before
+    relying on ``core``.
+"""

kivydk-0.0.3.dev2/src/kivydk/core/mapping/__init__.py

@@ -0,0 +1,19 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 12 Jan 2026. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+"""
+This package contains lightweight semantic mappings used throughout KivyDK to make common
+framework constants easier to discover and work with. The goal of these mappings is not to
+abstract platform behavior, but to provide clean, IDE‑friendly namespaces that group related
+identifiers into readable structures.
+
+They exist purely to make the KivyDK API more expressive, discoverable and pleasant to use.
+"""
+__all__ = (
+    "CursorDefault", "CursorWindows",
+    "Icon"
+)
+
+#// IMPORT
+from .cursors import CursorDefault, CursorWindows
+from .icons import Icon

kivydk-0.0.3.dev2/src/kivydk/core/mapping/cursors.py

@@ -0,0 +1,121 @@
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+#//| Copyright (c) 21 May 2025. All rights are reserved by ASI
+#//|>-----------------------------------------------------------------------------------------------------------------<|
+"""
+This module defines the cursor‑mapping layer used by KivyDK to provide a consistent and extensible way of
+managing system cursors across different platforms. It abstracts Kivy’s low‑level cursor handling and exposes
+a small, stable API for setting or resetting the active cursor within the application.
+
+These mappings allow widgets, behaviors and higher‑level components to request semantic cursor types
+(e.g., “resize horizontal”, “busy”, “text selection”) without needing to know the exact string identifiers
+used by the underlying system.
+"""
+__all__ = ("CursorBase", "CursorDefault", "CursorWindows")
+
+#// IMPORT
+# TODO: Extend `kivydk.core.window_adapter.WindowAdapter` to implement cursor functionality in `panda3d` system.
+from kivy.core.window import Window
+
+
+#// LOGIC
+class CursorBase:
+    """
+    Lightweight base class for all cursor‑mapping groups in KivyDK.
+
+    This class provides the minimal functionality required to apply or restore a system
+    cursor using Kivy’s window provider. Subclasses define semantic cursor names, while
+    :class:`CursorBase` handles the actual call to :func:`Window.set_system_cursor`.
+    """
+    # Private variables
+    __default_cursor: str | None = None
+
+    @staticmethod
+    def set(cursor: str | None) -> None:
+        """
+        Applies the given cursor using Kivy’s window provider.
+
+        This method is a thin wrapper around :func:`Window.set_system_cursor` used by all
+        cursor mapping classes to activate a specific cursor. It accepts ``None`` as a safe no‑op,
+        allowing subclasses to call :meth:`reset` even if their default cursor value has not been initialized yet.
+
+        This function does not validate the cursor name; it assumes that subclasses provide
+        valid identifiers based on Kivy’s built‑in cursor strings.
+        """
+        if cursor is not None:
+            Window.set_system_cursor(cursor)
+
+    @staticmethod
+    def reset() -> None:
+        """
+        Restores the default cursor defined by the active cursor mapping class.
+
+        The default cursor is stored internally on :class:`CursorBase` and overridden by
+        subclasses. Calling this method ensures that the application returns to a predictable cursor state
+        after temporary cursor changes (e.g., during drag operations or hover interactions).
+        """
+        CursorBase.set(CursorBase.__default_cursor)
+
+
+class CursorDefault(CursorBase):
+    """
+    Default cursor mapping used by KivyDK.
+
+    A nested :class:`Size` namespace contains the resize‑related cursor identifiers.
+
+    The default cursor for this mapping is :attr:`Arrow`, which is restored when calling
+    :meth:`CursorDefault.reset()`.
+    """
+    Arrow = "arrow"
+    Crosshair = "crosshair"
+    Hand = "hand"
+    I_Beam = "ibeam"
+    No = "no"
+    Wait = "wait"
+    Wait_Arrow = "wait_arrow"
+
+    class Size:
+        NWSE = "size_nwse"
+        NESW = "size_nesw"
+        WE = "size_we"
+        NS = "size_ns"
+        All = "size_all"
+
+    # Set the default cursor what will be used on the `reset` function
+    CursorBase._CursorBase__default_cursor = Arrow
+
+
+class CursorWindows(CursorBase):
+    """
+    Windows‑style cursor mapping for developers who prefer familiar naming conventions.
+
+    This class provides semantic cursor names that resemble those commonly used on
+    Microsoft Windows (e.g., ``Busy``, ``Move``, ``Unavailable``). Internally, these
+    names still map to Kivy’s built‑in cursor identifiers; the goal is to improve
+    readability and autocompletion, not to emulate native Windows cursor behavior.
+
+    Two nested namespaces :class:`Select` and :class:`Resize` group related cursor types
+    for text selection and directional resizing.
+
+    The default cursor for this mapping is :attr:`Normal`, restored via
+    :meth:`CursorWindows.reset()`.
+    """
+    Busy = "wait"
+    Move = "size_all"
+    Normal = "arrow"
+    Unavailable = "no"
+    Working_In_Background = Busy_In_Background = "wait_arrow"
+
+    class Select:
+        Link = "hand"
+        Normal = "arrow"
+        Precision = "crosshair"
+        Text = "ibeam"
+
+    class Resize:
+        Diagonal_Left = "size_nwse"
+        Diagonal_Right = "size_nesw"
+        Horizontal = "size_we"
+        Vertical = "size_ns"
+
+    # Set the default cursor what will be used on the `reset` function
+    CursorBase._CursorBase__default_cursor = Normal