tintkit 0.1.0__tar.gz

tintkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lasha Kandelaki
+
+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.

tintkit-0.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: tintkit
+Version: 0.1.0
+Summary: A small, themeable Tkinter widget kit — a dark/light photo-tool look with one live theme.
+Author: Lasha Kandelaki
+License: MIT License
+        
+        Copyright (c) 2026 Lasha Kandelaki
+        
+        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: Homepage, https://github.com/kandelucky/tintkit
+Project-URL: Repository, https://github.com/kandelucky/tintkit
+Project-URL: Issues, https://github.com/kandelucky/tintkit/issues
+Keywords: tkinter,ui,widgets,theme,gui,dark-mode,lucide
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Environment :: X11 Applications
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: icons
+Requires-Dist: pillow; extra == "icons"
+Dynamic: license-file
+
+# TintKit
+
+A small, themeable **tkinter** UI kit — a dark/light photo-tool look as reusable
+controls. One theme drives every colour, widgets reuse each other, and the look
+switches live with no restart.
+
+![Python](https://img.shields.io/badge/python-3.8%2B-blue) ![License](https://img.shields.io/badge/license-MIT-green) ![UI](https://img.shields.io/badge/ui-tkinter-informational)
+
+![TintKit — dark theme](https://raw.githubusercontent.com/kandelucky/tintkit/main/docs/UI-Dark.jpg)
+![TintKit — light theme](https://raw.githubusercontent.com/kandelucky/tintkit/main/docs/UI-Light.jpg)
+
+## Run the gallery
+
+```bash
+python gallery.py
+```
+
+Every component in one scrollable window, with a live **Dark / Light + accent**
+switcher at the top — the whole window repaints instantly. (The handlers are
+demos; the controls themselves are genuinely interactive.)
+
+## Install
+
+```bash
+pip install git+https://github.com/kandelucky/tintkit
+```
+
+Pure-stdlib tkinter — **zero required dependencies**. For the bundled
+[Lucide](https://lucide.dev/) icons (recoloured per theme) also `pip install
+pillow`; without it widgets still work and shapes stay anti-aliased (drawn in
+pure Tk) — only the glyphs are skipped. Point at your own icons with
+`set_icon_dir("…/my_icons")`.
+
+## Use it
+
+```python
+import tkinter as tk
+from tintkit import Theme, setup_dpi, Button, Toggle
+
+root = tk.Tk()
+setup_dpi(root)                       # crisp icons on high-DPI screens
+theme = Theme(scheme="dark", accent="#8fae9b")
+
+Button(root, theme, "Save", icon="save", command=lambda: print("saved")).pack()
+Toggle(root, theme, value=True, command=lambda on: print(on)).pack()
+root.mainloop()
+```
+
+Every widget takes the same first two args — the parent and the shared `theme` —
+and returns an object you `.pack()` / `.grid()` like any tk widget. One theme is
+the single source of truth; change it and the whole tree repaints:
+
+```python
+theme.set(scheme="light")             # dark <-> light
+theme.set(accent="#c08457")           # any accent; shades derived for you
+theme.toggle_scheme()
+```
+
+Read any token anywhere with `theme["accent"]`, `theme["panel"]`,
+`theme["r_control"]` …
+
+## What's inside
+
+| module | what it holds |
+|---|---|
+| `tintkit/theme.py` | dark/light schemes, accent + danger/warn derivation, repaint observer |
+| `tintkit/icons.py` | the Lucide icon loader (recoloured per theme) |
+| `tintkit/primitives.py` | `rounded_rect`, the `CanvasControl` base, themed `Surface` / `Label` |
+| `tintkit/controls.py` | Button, Slider, Toggle, Radio, Checkbox, SegmentedTabs, Dropdown, Badge, Tag, ProgressBar, Tooltip, TextField |
+| `tintkit/containers.py` | Card, dialog, callout, section header, drag sashes, scrollbar |
+| `tintkit/composites.py` | toolbar, tool rail, folder nav + tree, selection views, settings window |
+| `gallery.py` | the style guide window + live switcher |
+
+**Design rules:** no widget hard-codes a colour (each reads `theme[...]` and
+repaints on change); one radius scale — `r_control` / `r_pill` / `r_card`, no
+magic numbers; widgets reuse widgets; all glyphs are
+[Lucide](https://lucide.dev/) PNGs (ISC) recoloured at load.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

tintkit-0.1.0/README.md

@@ -0,0 +1,81 @@
+# TintKit
+
+A small, themeable **tkinter** UI kit — a dark/light photo-tool look as reusable
+controls. One theme drives every colour, widgets reuse each other, and the look
+switches live with no restart.
+
+![Python](https://img.shields.io/badge/python-3.8%2B-blue) ![License](https://img.shields.io/badge/license-MIT-green) ![UI](https://img.shields.io/badge/ui-tkinter-informational)
+
+![TintKit — dark theme](https://raw.githubusercontent.com/kandelucky/tintkit/main/docs/UI-Dark.jpg)
+![TintKit — light theme](https://raw.githubusercontent.com/kandelucky/tintkit/main/docs/UI-Light.jpg)
+
+## Run the gallery
+
+```bash
+python gallery.py
+```
+
+Every component in one scrollable window, with a live **Dark / Light + accent**
+switcher at the top — the whole window repaints instantly. (The handlers are
+demos; the controls themselves are genuinely interactive.)
+
+## Install
+
+```bash
+pip install git+https://github.com/kandelucky/tintkit
+```
+
+Pure-stdlib tkinter — **zero required dependencies**. For the bundled
+[Lucide](https://lucide.dev/) icons (recoloured per theme) also `pip install
+pillow`; without it widgets still work and shapes stay anti-aliased (drawn in
+pure Tk) — only the glyphs are skipped. Point at your own icons with
+`set_icon_dir("…/my_icons")`.
+
+## Use it
+
+```python
+import tkinter as tk
+from tintkit import Theme, setup_dpi, Button, Toggle
+
+root = tk.Tk()
+setup_dpi(root)                       # crisp icons on high-DPI screens
+theme = Theme(scheme="dark", accent="#8fae9b")
+
+Button(root, theme, "Save", icon="save", command=lambda: print("saved")).pack()
+Toggle(root, theme, value=True, command=lambda on: print(on)).pack()
+root.mainloop()
+```
+
+Every widget takes the same first two args — the parent and the shared `theme` —
+and returns an object you `.pack()` / `.grid()` like any tk widget. One theme is
+the single source of truth; change it and the whole tree repaints:
+
+```python
+theme.set(scheme="light")             # dark <-> light
+theme.set(accent="#c08457")           # any accent; shades derived for you
+theme.toggle_scheme()
+```
+
+Read any token anywhere with `theme["accent"]`, `theme["panel"]`,
+`theme["r_control"]` …
+
+## What's inside
+
+| module | what it holds |
+|---|---|
+| `tintkit/theme.py` | dark/light schemes, accent + danger/warn derivation, repaint observer |
+| `tintkit/icons.py` | the Lucide icon loader (recoloured per theme) |
+| `tintkit/primitives.py` | `rounded_rect`, the `CanvasControl` base, themed `Surface` / `Label` |
+| `tintkit/controls.py` | Button, Slider, Toggle, Radio, Checkbox, SegmentedTabs, Dropdown, Badge, Tag, ProgressBar, Tooltip, TextField |
+| `tintkit/containers.py` | Card, dialog, callout, section header, drag sashes, scrollbar |
+| `tintkit/composites.py` | toolbar, tool rail, folder nav + tree, selection views, settings window |
+| `gallery.py` | the style guide window + live switcher |
+
+**Design rules:** no widget hard-codes a colour (each reads `theme[...]` and
+repaints on change); one radius scale — `r_control` / `r_pill` / `r_card`, no
+magic numbers; widgets reuse widgets; all glyphs are
+[Lucide](https://lucide.dev/) PNGs (ISC) recoloured at load.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

tintkit-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tintkit"
+version = "0.1.0"
+description = "A small, themeable Tkinter widget kit — a dark/light photo-tool look with one live theme."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { file = "LICENSE" }
+authors = [{ name = "Lasha Kandelaki" }]
+keywords = ["tkinter", "ui", "widgets", "theme", "gui", "dark-mode", "lucide"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: User Interfaces",
+    "Environment :: X11 Applications",
+]
+
+# Zero required dependencies — the kit is pure-stdlib tkinter and runs as-is.
+dependencies = []
+
+[project.optional-dependencies]
+# Pillow is only needed to recolour the bundled Lucide icons. Without it every
+# widget still works and the shapes are still anti-aliased; the glyphs are just
+# skipped. Install with:  pip install tintkit[icons]
+icons = ["pillow"]
+
+[project.urls]
+Homepage = "https://github.com/kandelucky/tintkit"
+Repository = "https://github.com/kandelucky/tintkit"
+Issues = "https://github.com/kandelucky/tintkit/issues"
+
+[tool.setuptools]
+packages = ["tintkit"]
+
+[tool.setuptools.package-data]
+tintkit = ["icons/*.png"]

tintkit-0.1.0/setup.cfg

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

tintkit-0.1.0/tintkit/__init__.py

@@ -0,0 +1,99 @@
+"""TintKit — a small, themeable Tkinter widget kit.
+
+A dark/light photo-tool look as reusable controls. One theme drives every
+colour; controls reuse each other; everything is interactive.
+
+    import tkinter as tk
+    from tintkit import Theme, Button, setup_dpi
+
+    root = tk.Tk()
+    setup_dpi(root)                       # crisp icons on high-DPI screens
+    theme = Theme(scheme="dark", accent="#8fae9b")
+    Button(root, theme, "Save", icon="save", command=lambda: None).pack()
+    root.mainloop()
+
+Switch the look at any time — the whole window repaints::
+
+    theme.set(scheme="light")
+    theme.set(accent="#c08457")
+
+See ``gallery.py`` for every component rendered together with a live switcher.
+"""
+
+from . import icons
+from .icons import set_icon_dir
+from .scaling import s, set_scale
+from .theme import (Theme, mix, lighten, darken, on_color,
+                    SCHEMES, DEFAULT_ACCENT)
+from .primitives import (CanvasControl, Surface, Label, IconLabel,
+                         rounded_rect, put_icon, font, measure, FONT_FAMILY)
+from .controls import (Button, IconButton, Slider, Toggle, Radio, RadioGroup,
+                       Checkbox, SegmentedTabs, Badge, Tag, ProgressBar,
+                       Tooltip, TextField, Dropdown, MultiDropdown)
+from .containers import (Card, SectionHeader, hero_line, callout, dialog,
+                         v_sash, h_sash, themed_scrollbar)
+from .composites import (toolbar, tool_rail, FolderNav, folder_tree,
+                         SelectTile, SelectRow, MultiSelectRow,
+                         multiselect_list, SettingsWindow)
+
+__all__ = [
+    "Theme", "mix", "lighten", "darken", "on_color", "SCHEMES",
+    "DEFAULT_ACCENT", "icons", "set_icon_dir", "setup_dpi",
+    "enable_dpi_awareness", "s", "set_scale",
+    "CanvasControl", "Surface", "Label", "IconLabel",
+    "rounded_rect", "put_icon", "font", "measure", "FONT_FAMILY",
+    "Button", "IconButton", "Slider", "Toggle", "Radio", "RadioGroup",
+    "Checkbox", "SegmentedTabs", "Badge", "Tag", "ProgressBar", "Tooltip",
+    "TextField", "Dropdown", "MultiDropdown",
+    "Card", "SectionHeader", "hero_line", "callout", "dialog",
+    "v_sash", "h_sash", "themed_scrollbar",
+    "toolbar", "tool_rail", "FolderNav", "folder_tree", "SelectTile",
+    "SelectRow", "MultiSelectRow", "multiselect_list", "SettingsWindow",
+]
+
+
+def enable_dpi_awareness():
+    """Tell Windows this process draws at the real screen resolution.
+
+    MUST run before the first ``tk.Tk()`` — otherwise Tk caches the virtualised
+    96 DPI and everything renders tiny. The kit calls this automatically on
+    import, so importing ``tintkit`` before creating the root is enough.
+    """
+    import sys
+    if sys.platform != "win32":
+        return
+    try:
+        import ctypes
+        ctypes.windll.shcore.SetProcessDpiAwareness(2)   # per-monitor aware
+    except Exception:
+        try:
+            ctypes.windll.user32.SetProcessDPIAware()     # older fallback
+        except Exception:
+            pass
+
+
+def setup_dpi(root, zoom=1.0):
+    """Scale fonts + icons + geometry to the screen. Returns the scale factor.
+
+    Call once, right after creating the root window and BEFORE building the
+    Theme. ``zoom`` is an extra comfort multiplier on top of the screen DPI
+    (1.0 = true size; raise it to make the whole UI bigger).
+
+    * Tk text scaling → ``(screen_dpi / 72) * zoom`` (fonts + text measurement).
+    * The kit's geometry scale ``S`` → ``(screen_dpi / 96) * zoom`` (canvas px).
+    """
+    from . import scaling
+    enable_dpi_awareness()                 # idempotent; real fix is at import
+    try:
+        fpix = root.winfo_fpixels("1i")
+        root.tk.call("tk", "scaling", (fpix / 72.0) * zoom)
+        factor = max(1.0, fpix / 96.0) * zoom
+    except Exception:
+        factor = zoom
+    scaling.set_scale(factor)
+    icons.DPI = factor
+    return factor
+
+
+# Set DPI awareness at import — before any tk.Tk() the caller creates.
+enable_dpi_awareness()