PyPI - bootstack - Versions diffs - 0.1.0a1__py3-none-any.whl - Mend

bootstack 0.1.0a1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (419) hide show

bootstack/__init__.py +249 -0
bootstack/__main__.py +5 -0
bootstack/api/__init__.py +127 -0
bootstack/api/app.py +30 -0
bootstack/api/constants.py +3 -0
bootstack/api/data.py +23 -0
bootstack/api/dialogs.py +44 -0
bootstack/api/i18n.py +17 -0
bootstack/api/localization.py +16 -0
bootstack/api/menu.py +7 -0
bootstack/api/style.py +23 -0
bootstack/api/utils.py +24 -0
bootstack/api/widgets.py +137 -0
bootstack/assets/__init__.py +24 -0
bootstack/assets/bootstack-transparent.png +0 -0
bootstack/assets/bootstack.ico +0 -0
bootstack/assets/bootstack.png +0 -0
bootstack/assets/elements/__init__.py +0 -0
bootstack/assets/elements/badge-pill.png +0 -0
bootstack/assets/elements/badge-square.png +0 -0
bootstack/assets/elements/border.png +0 -0
bootstack/assets/elements/button-compact.png +0 -0
bootstack/assets/elements/button-default.png +0 -0
bootstack/assets/elements/button-group-horizontal-after-compact.png +0 -0
bootstack/assets/elements/button-group-horizontal-after-default.png +0 -0
bootstack/assets/elements/button-group-horizontal-before-compact.png +0 -0
bootstack/assets/elements/button-group-horizontal-before-default.png +0 -0
bootstack/assets/elements/button-group-horizontal-center-compact.png +0 -0
bootstack/assets/elements/button-group-horizontal-center-default.png +0 -0
bootstack/assets/elements/button-group-vertical-after-compact.png +0 -0
bootstack/assets/elements/button-group-vertical-after-default.png +0 -0
bootstack/assets/elements/button-group-vertical-before-compact.png +0 -0
bootstack/assets/elements/button-group-vertical-before-default.png +0 -0
bootstack/assets/elements/button-group-vertical-center-compact.png +0 -0
bootstack/assets/elements/button-group-vertical-center-default.png +0 -0
bootstack/assets/elements/checkbox-checked.png +0 -0
bootstack/assets/elements/checkbox-indeterminate.png +0 -0
bootstack/assets/elements/checkbox-unchecked.png +0 -0
bootstack/assets/elements/field.png +0 -0
bootstack/assets/elements/input-after-compact.png +0 -0
bootstack/assets/elements/input-after-default.png +0 -0
bootstack/assets/elements/input-before-compact.png +0 -0
bootstack/assets/elements/input-before-default.png +0 -0
bootstack/assets/elements/input-compact.png +0 -0
bootstack/assets/elements/input-default.png +0 -0
bootstack/assets/elements/list-item-separated.png +0 -0
bootstack/assets/elements/list-item.png +0 -0
bootstack/assets/elements/manifest.toml +480 -0
bootstack/assets/elements/menu-item.png +0 -0
bootstack/assets/elements/nav-button-compact.png +0 -0
bootstack/assets/elements/nav-button-default.png +0 -0
bootstack/assets/elements/nav-icon-button-compact.png +0 -0
bootstack/assets/elements/nav-icon-button-default.png +0 -0
bootstack/assets/elements/notebook-client-border.png +0 -0
bootstack/assets/elements/notebook-tab-active.png +0 -0
bootstack/assets/elements/notebook-tab-bar.png +0 -0
bootstack/assets/elements/notebook-tab-normal.png +0 -0
bootstack/assets/elements/notebook-tab-pill.png +0 -0
bootstack/assets/elements/progress-bar-horizontal-striped.png +0 -0
bootstack/assets/elements/progress-bar-solid.png +0 -0
bootstack/assets/elements/progress-bar-thin.png +0 -0
bootstack/assets/elements/progress-bar-vertical-striped.png +0 -0
bootstack/assets/elements/radio-selected.png +0 -0
bootstack/assets/elements/radio-unselected.png +0 -0
bootstack/assets/elements/scrollbar-horizontal.png +0 -0
bootstack/assets/elements/scrollbar-vertical.png +0 -0
bootstack/assets/elements/slider-handle-focus.png +0 -0
bootstack/assets/elements/slider-handle.png +0 -0
bootstack/assets/elements/slider-track-horizontal.png +0 -0
bootstack/assets/elements/slider-track-vertical.png +0 -0
bootstack/assets/elements/switch-off.png +0 -0
bootstack/assets/elements/switch-on.png +0 -0
bootstack/assets/elements/tabs-bar-horizontal.png +0 -0
bootstack/assets/elements/tabs-bar-vertical.png +0 -0
bootstack/assets/elements/tabs-pill.png +0 -0
bootstack/assets/locales/ar/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ar/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/bg/LC_MESSAGES/bootstack.po +875 -0
bootstack/assets/locales/cs/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/cs/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/da/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/da/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/de/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/de/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/en/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/en/LC_MESSAGES/bootstack.po +875 -0
bootstack/assets/locales/es/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/es/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/fr/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/fr/LC_MESSAGES/bootstack.po +853 -0
bootstack/assets/locales/he/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/he/LC_MESSAGES/bootstack.po +851 -0
bootstack/assets/locales/hi/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/hi/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/it/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/it/LC_MESSAGES/bootstack.po +841 -0
bootstack/assets/locales/ja/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ja/LC_MESSAGES/bootstack.po +914 -0
bootstack/assets/locales/ko/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ko/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/nb/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/nb/LC_MESSAGES/bootstack.po +841 -0
bootstack/assets/locales/nl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/nl/LC_MESSAGES/bootstack.po +841 -0
bootstack/assets/locales/pl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pl/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/pt/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pt/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/pt_BR/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pt_BR/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/sl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/sl/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/sv/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/sv/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/tr/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/tr/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/zh_CN/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/zh_CN/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/locales/zh_TW/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/zh_TW/LC_MESSAGES/bootstack.po +842 -0
bootstack/assets/themes/__init__.py +0 -0
bootstack/assets/themes/amber-dark.json +32 -0
bootstack/assets/themes/amber-light.json +32 -0
bootstack/assets/themes/aurora-dark.json +32 -0
bootstack/assets/themes/aurora-light.json +32 -0
bootstack/assets/themes/bootstrap-dark.json +32 -0
bootstack/assets/themes/bootstrap-light.json +32 -0
bootstack/assets/themes/classic-dark.json +32 -0
bootstack/assets/themes/classic-light.json +32 -0
bootstack/assets/themes/docs-dark.json +32 -0
bootstack/assets/themes/docs-light.json +32 -0
bootstack/assets/themes/forest-dark.json +32 -0
bootstack/assets/themes/forest-light.json +32 -0
bootstack/assets/themes/ocean-dark.json +32 -0
bootstack/assets/themes/ocean-light.json +32 -0
bootstack/assets/themes/rose-dark.json +32 -0
bootstack/assets/themes/rose-light.json +32 -0
bootstack/assets/widgets/__init__.py +0 -0
bootstack/assets/widgets/badge-default.png +0 -0
bootstack/assets/widgets/badge-pill.png +0 -0
bootstack/assets/widgets/border.png +0 -0
bootstack/assets/widgets/button-group-horizontal-after.png +0 -0
bootstack/assets/widgets/button-group-horizontal-before.png +0 -0
bootstack/assets/widgets/button-group-horizontal-center.png +0 -0
bootstack/assets/widgets/button-group-vertical-after.png +0 -0
bootstack/assets/widgets/button-group-vertical-before.png +0 -0
bootstack/assets/widgets/button-group-vertical-center.png +0 -0
bootstack/assets/widgets/button.png +0 -0
bootstack/assets/widgets/checkbox-checked.png +0 -0
bootstack/assets/widgets/checkbox-indeterminate.png +0 -0
bootstack/assets/widgets/checkbox-unchecked.png +0 -0
bootstack/assets/widgets/field.png +0 -0
bootstack/assets/widgets/icon-button.png +0 -0
bootstack/assets/widgets/input-inner.png +0 -0
bootstack/assets/widgets/input-prefix.png +0 -0
bootstack/assets/widgets/input-suffix.png +0 -0
bootstack/assets/widgets/input.png +0 -0
bootstack/assets/widgets/list-item-focus.png +0 -0
bootstack/assets/widgets/list-item-separated.png +0 -0
bootstack/assets/widgets/menu-item-separated.png +0 -0
bootstack/assets/widgets/notebook-client-border.png +0 -0
bootstack/assets/widgets/notebook-pill-active.png +0 -0
bootstack/assets/widgets/notebook-pill-inactive.png +0 -0
bootstack/assets/widgets/notebook-tab-active.png +0 -0
bootstack/assets/widgets/notebook-tab-border.png +0 -0
bootstack/assets/widgets/notebook-tab-normal.png +0 -0
bootstack/assets/widgets/notebook-underline.png +0 -0
bootstack/assets/widgets/progress-bar-horizontal-default.png +0 -0
bootstack/assets/widgets/progress-bar-horizontal-striped.png +0 -0
bootstack/assets/widgets/progress-bar-vertical-default.png +0 -0
bootstack/assets/widgets/progress-bar-vertical-striped.png +0 -0
bootstack/assets/widgets/progress-trough-horizontal.png +0 -0
bootstack/assets/widgets/progress-trough-vertical.png +0 -0
bootstack/assets/widgets/radio-selected.png +0 -0
bootstack/assets/widgets/radio-unselected.png +0 -0
bootstack/assets/widgets/scrollbar-horizontal-rounded.png +0 -0
bootstack/assets/widgets/scrollbar-vertical-rounded.png +0 -0
bootstack/assets/widgets/separator-horizontal.png +0 -0
bootstack/assets/widgets/separator-vertical.png +0 -0
bootstack/assets/widgets/slider-handle-focus.png +0 -0
bootstack/assets/widgets/slider-handle.png +0 -0
bootstack/assets/widgets/slider-track-horizontal.png +0 -0
bootstack/assets/widgets/slider-track-vertical.png +0 -0
bootstack/assets/widgets/switch-off.png +0 -0
bootstack/assets/widgets/switch-on.png +0 -0
bootstack/assets/widgets/tabs-bar-horizontal.png +0 -0
bootstack/assets/widgets/tabs-bar-vertical.png +0 -0
bootstack/assets/widgets/tabs-pill.png +0 -0
bootstack/cli/__init__.py +124 -0
bootstack/cli/__main__.py +6 -0
bootstack/cli/add.py +439 -0
bootstack/cli/build.py +115 -0
bootstack/cli/config.py +287 -0
bootstack/cli/demo.py +1267 -0
bootstack/cli/doctor.py +195 -0
bootstack/cli/list_cmd.py +71 -0
bootstack/cli/promote.py +120 -0
bootstack/cli/pyinstaller.py +246 -0
bootstack/cli/run.py +99 -0
bootstack/cli/start.py +105 -0
bootstack/cli/templates/__init__.py +861 -0
bootstack/constants.py +325 -0
bootstack/core/__init__.py +34 -0
bootstack/core/capabilities/__init__.py +45 -0
bootstack/core/capabilities/after.py +103 -0
bootstack/core/capabilities/bind.py +154 -0
bootstack/core/capabilities/bindtags.py +112 -0
bootstack/core/capabilities/busy.py +61 -0
bootstack/core/capabilities/clipboard.py +88 -0
bootstack/core/capabilities/focus.py +118 -0
bootstack/core/capabilities/grab.py +65 -0
bootstack/core/capabilities/grid.py +188 -0
bootstack/core/capabilities/localization.py +231 -0
bootstack/core/capabilities/pack.py +119 -0
bootstack/core/capabilities/place.py +92 -0
bootstack/core/capabilities/selection.py +136 -0
bootstack/core/capabilities/signals.py +242 -0
bootstack/core/capabilities/winfo.py +315 -0
bootstack/core/colorutils.py +234 -0
bootstack/core/exceptions.py +95 -0
bootstack/core/images.py +283 -0
bootstack/core/localization/README.md +90 -0
bootstack/core/localization/__init__.py +13 -0
bootstack/core/localization/intl_format.py +580 -0
bootstack/core/localization/msgcat.py +425 -0
bootstack/core/localization/specs.py +143 -0
bootstack/core/mixins/__init__.py +1 -0
bootstack/core/mixins/ttk_state.py +35 -0
bootstack/core/mixins/widget.py +132 -0
bootstack/core/publisher.py +147 -0
bootstack/core/signals/README.md +112 -0
bootstack/core/signals/__init__.py +8 -0
bootstack/core/signals/integration.py +100 -0
bootstack/core/signals/signal.py +317 -0
bootstack/core/signals/types.py +4 -0
bootstack/core/validation/__init__.py +5 -0
bootstack/core/validation/types.py +13 -0
bootstack/core/validation/validation_result.py +17 -0
bootstack/core/validation/validation_rules.py +112 -0
bootstack/core/variables.py +62 -0
bootstack/datasource/README.md +607 -0
bootstack/datasource/__init__.py +51 -0
bootstack/datasource/base.py +474 -0
bootstack/datasource/file_source.py +541 -0
bootstack/datasource/memory_source.py +482 -0
bootstack/datasource/sqlite_source.py +453 -0
bootstack/datasource/types.py +259 -0
bootstack/dialogs/__init__.py +56 -0
bootstack/dialogs/colorchooser.py +674 -0
bootstack/dialogs/colordropper.py +257 -0
bootstack/dialogs/datedialog.py +404 -0
bootstack/dialogs/dialog.py +514 -0
bootstack/dialogs/filterdialog.py +358 -0
bootstack/dialogs/fontdialog.py +339 -0
bootstack/dialogs/formdialog.py +541 -0
bootstack/dialogs/message.py +489 -0
bootstack/dialogs/query.py +561 -0
bootstack/py.typed +1 -0
bootstack/runtime/__init__.py +3 -0
bootstack/runtime/app.py +879 -0
bootstack/runtime/base_window.py +786 -0
bootstack/runtime/events.py +399 -0
bootstack/runtime/menu.py +510 -0
bootstack/runtime/shortcuts.py +423 -0
bootstack/runtime/tk_patch.py +31 -0
bootstack/runtime/toplevel.py +131 -0
bootstack/runtime/utility.py +371 -0
bootstack/runtime/visual_focus.py +228 -0
bootstack/runtime/window_utilities.py +1043 -0
bootstack/style/__init__.py +5498 -0
bootstack/style/bootstyle.py +507 -0
bootstack/style/bootstyle_builder_base.py +752 -0
bootstack/style/bootstyle_builder_mixed.py +93 -0
bootstack/style/bootstyle_builder_tk.py +109 -0
bootstack/style/bootstyle_builder_ttk.py +354 -0
bootstack/style/builders/__init__.py +51 -0
bootstack/style/builders/badge.py +44 -0
bootstack/style/builders/button.py +453 -0
bootstack/style/builders/buttongroup.py +344 -0
bootstack/style/builders/calendar.py +271 -0
bootstack/style/builders/checkbutton.py +95 -0
bootstack/style/builders/combobox.py +112 -0
bootstack/style/builders/contextmenu.py +268 -0
bootstack/style/builders/entry.py +83 -0
bootstack/style/builders/expander.py +171 -0
bootstack/style/builders/field.py +312 -0
bootstack/style/builders/frame.py +27 -0
bootstack/style/builders/label.py +28 -0
bootstack/style/builders/labelframe.py +41 -0
bootstack/style/builders/listview.py +267 -0
bootstack/style/builders/menubar.py +74 -0
bootstack/style/builders/menubutton.py +408 -0
bootstack/style/builders/notebook.py +316 -0
bootstack/style/builders/panedwindow.py +25 -0
bootstack/style/builders/progressbar.py +71 -0
bootstack/style/builders/radiobutton.py +68 -0
bootstack/style/builders/scale.py +66 -0
bootstack/style/builders/scrollbar.py +360 -0
bootstack/style/builders/separator.py +45 -0
bootstack/style/builders/sidenav.py +313 -0
bootstack/style/builders/sizegrip.py +15 -0
bootstack/style/builders/spinbox.py +119 -0
bootstack/style/builders/switch.py +67 -0
bootstack/style/builders/tabitem.py +205 -0
bootstack/style/builders/toolbutton.py +260 -0
bootstack/style/builders/tooltip.py +26 -0
bootstack/style/builders/treeview.py +269 -0
bootstack/style/builders/utils.py +404 -0
bootstack/style/builders_tk/__init__.py +16 -0
bootstack/style/builders_tk/defaults.py +229 -0
bootstack/style/element.py +173 -0
bootstack/style/style.py +499 -0
bootstack/style/theme_provider.py +449 -0
bootstack/style/tk_patch.py +5 -0
bootstack/style/token_maps.py +42 -0
bootstack/style/types.py +32 -0
bootstack/style/typography.py +527 -0
bootstack/style/utility.py +696 -0
bootstack/themes/__init__.py +12 -0
bootstack/themes/standard.py +415 -0
bootstack/themes/user.py +45 -0
bootstack/widgets/__init__.py +53 -0
bootstack/widgets/composites/__init__.py +38 -0
bootstack/widgets/composites/accordion.py +385 -0
bootstack/widgets/composites/appshell.py +445 -0
bootstack/widgets/composites/buttongroup.py +391 -0
bootstack/widgets/composites/calendar.py +914 -0
bootstack/widgets/composites/compositeframe.py +282 -0
bootstack/widgets/composites/contextmenu.py +1754 -0
bootstack/widgets/composites/dateentry.py +261 -0
bootstack/widgets/composites/dropdownbutton.py +190 -0
bootstack/widgets/composites/expander.py +508 -0
bootstack/widgets/composites/field.py +448 -0
bootstack/widgets/composites/floodgauge.py +434 -0
bootstack/widgets/composites/form.py +983 -0
bootstack/widgets/composites/labeledscale.py +209 -0
bootstack/widgets/composites/list/__init__.py +15 -0
bootstack/widgets/composites/list/listitem.py +733 -0
bootstack/widgets/composites/list/listview.py +1507 -0
bootstack/widgets/composites/menubar.py +303 -0
bootstack/widgets/composites/meter.py +882 -0
bootstack/widgets/composites/numericentry.py +183 -0
bootstack/widgets/composites/pagestack.py +330 -0
bootstack/widgets/composites/passwordentry.py +149 -0
bootstack/widgets/composites/pathentry.py +223 -0
bootstack/widgets/composites/radiogroup.py +466 -0
bootstack/widgets/composites/scrolledtext.py +388 -0
bootstack/widgets/composites/scrolledtext.pyi +186 -0
bootstack/widgets/composites/scrollview.py +675 -0
bootstack/widgets/composites/selectbox.py +544 -0
bootstack/widgets/composites/sidenav/__init__.py +24 -0
bootstack/widgets/composites/sidenav/group.py +485 -0
bootstack/widgets/composites/sidenav/header.py +83 -0
bootstack/widgets/composites/sidenav/item.py +413 -0
bootstack/widgets/composites/sidenav/separator.py +51 -0
bootstack/widgets/composites/sidenav/view.py +919 -0
bootstack/widgets/composites/spinnerentry.py +232 -0
bootstack/widgets/composites/tableview/__init__.py +5 -0
bootstack/widgets/composites/tableview/tableview.py +2254 -0
bootstack/widgets/composites/tableview/types.py +169 -0
bootstack/widgets/composites/tabs/__init__.py +6 -0
bootstack/widgets/composites/tabs/tabitem.py +372 -0
bootstack/widgets/composites/tabs/tabs.py +478 -0
bootstack/widgets/composites/tabs/tabview.py +352 -0
bootstack/widgets/composites/textentry.py +90 -0
bootstack/widgets/composites/timeentry.py +189 -0
bootstack/widgets/composites/toast.py +364 -0
bootstack/widgets/composites/togglegroup.py +382 -0
bootstack/widgets/composites/toolbar.py +393 -0
bootstack/widgets/composites/tooltip.py +404 -0
bootstack/widgets/internal/__init__.py +0 -0
bootstack/widgets/internal/wrapper_base.py +304 -0
bootstack/widgets/mixins/__init__.py +25 -0
bootstack/widgets/mixins/configure_mixin.py +186 -0
bootstack/widgets/mixins/entry_mixin.py +70 -0
bootstack/widgets/mixins/font_mixin.py +346 -0
bootstack/widgets/mixins/icon_mixin.py +38 -0
bootstack/widgets/mixins/localization_mixin.py +255 -0
bootstack/widgets/mixins/signal_mixin.py +272 -0
bootstack/widgets/mixins/validation_mixin.py +204 -0
bootstack/widgets/parts/__init__.py +11 -0
bootstack/widgets/parts/numberentry_part.py +345 -0
bootstack/widgets/parts/spinnerentry_part.py +394 -0
bootstack/widgets/parts/textentry_part.py +344 -0
bootstack/widgets/primitives/__init__.py +55 -0
bootstack/widgets/primitives/badge.py +44 -0
bootstack/widgets/primitives/button.py +89 -0
bootstack/widgets/primitives/card.py +66 -0
bootstack/widgets/primitives/checkbutton.py +124 -0
bootstack/widgets/primitives/checktoggle.py +53 -0
bootstack/widgets/primitives/combobox.py +165 -0
bootstack/widgets/primitives/entry.py +98 -0
bootstack/widgets/primitives/frame.py +206 -0
bootstack/widgets/primitives/gridframe.py +479 -0
bootstack/widgets/primitives/label.py +95 -0
bootstack/widgets/primitives/labelframe.py +63 -0
bootstack/widgets/primitives/menubutton.py +118 -0
bootstack/widgets/primitives/notebook.py +551 -0
bootstack/widgets/primitives/optionmenu.py +248 -0
bootstack/widgets/primitives/packframe.py +228 -0
bootstack/widgets/primitives/panedwindow.py +58 -0
bootstack/widgets/primitives/progressbar.py +95 -0
bootstack/widgets/primitives/radiobutton.py +115 -0
bootstack/widgets/primitives/radiotoggle.py +50 -0
bootstack/widgets/primitives/scale.py +85 -0
bootstack/widgets/primitives/scrollbar.py +56 -0
bootstack/widgets/primitives/separator.py +56 -0
bootstack/widgets/primitives/sizegrip.py +47 -0
bootstack/widgets/primitives/spinbox.py +91 -0
bootstack/widgets/primitives/switch.py +41 -0
bootstack/widgets/primitives/treeview.py +77 -0
bootstack/widgets/types.py +20 -0
bootstack-0.1.0a1.dist-info/METADATA +196 -0
bootstack-0.1.0a1.dist-info/RECORD +419 -0
bootstack-0.1.0a1.dist-info/WHEEL +5 -0
bootstack-0.1.0a1.dist-info/entry_points.txt +2 -0
bootstack-0.1.0a1.dist-info/licenses/LICENSE +22 -0
bootstack-0.1.0a1.dist-info/licenses/NOTICE +10 -0
bootstack-0.1.0a1.dist-info/top_level.txt +1 -0

bootstack/style/bootstyle_builder_base.py ADDED Viewed

@@ -0,0 +1,752 @@
+from __future__ import annotations
+import re
+from collections.abc import Sequence
+from typing import List, Optional, Tuple, Union
+from typing_extensions import Any, TypedDict
+from ttkbootstrap_icons_bs import BootstrapIcon
+from ttkbootstrap_icons_bs.provider import BootstrapFontProvider
+from ttkbootstrap_icons.providers import BaseFontProvider
+from ttkbootstrap_icons.icon import Icon
+# Custom y_bias for better vertical alignment in compound buttons.
+# Default Bootstrap provider uses 0.02.
+_ICON_Y_BIAS = 0.02
+_icon_provider_initialized = False
+class _TtkBootstrapIconProvider(BootstrapFontProvider):
+    """Custom Bootstrap icon provider with adjusted y_bias for bootstack.
+    The default Bootstrap provider uses y_bias=0.02, but bootstack buttons
+    need y_bias=0.08 for proper vertical alignment of icons with text.
+    """
+    def __init__(self):
+        # Bypass BootstrapFontProvider.__init__ and call BaseFontProvider directly
+        # to allow setting a custom y_bias value
+        BaseFontProvider.__init__(
+            self,
+            name="bootstrap",
+            display_name="Bootstrap Icons",
+            package="ttkbootstrap_icons_bs.assets",
+            homepage="https://icons.getbootstrap.com/",
+            license_url="https://github.com/twbs/icons/blob/main/LICENSE",
+            icon_version="1.13.1",
+            default_style="outline",
+            y_bias=_ICON_Y_BIAS,
+            styles={
+                "fill": {"filename": "bootstrap.ttf", "predicate": BootstrapFontProvider._is_fill_style},
+                "outline": {"filename": "bootstrap.ttf", "predicate": BootstrapFontProvider._is_outline_style},
+            }
+        )
+def _ensure_icon_provider():
+    """Initialize the custom icon provider if not already done."""
+    global _icon_provider_initialized
+    if _icon_provider_initialized:
+        return
+    provider = _TtkBootstrapIconProvider()
+    Icon.initialize_with_provider(provider)
+    _icon_provider_initialized = True
+from bootstack.style.theme_provider import ThemeProvider, use_theme
+from bootstack.style.utility import best_foreground, color_to_hsl, darken_color, lighten_color, mix_colors, \
+    relative_luminance
+from bootstack.runtime.utility import scale_size
+# Source images are created at this resolution multiplier (e.g., 2x)
+# This allows measurements from source images to be used directly in code
+SOURCE_RESOLUTION = 2.0
+class IconSpec(TypedDict, total=False):
+    name: str
+    size: Optional[int]
+    color: Optional[str]
+    state: Sequence[tuple[str, str | IconStateMap]]
+class IconStateMap(TypedDict, total=False):
+    name: Optional[str]
+    color: Optional[str]
+ForegroundStateSpec = tuple[str, str | dict[str, str]]
+class BootstyleBuilderBase:
+    """Shared base for TTK and Tk bootstyle builders.
+    Centralizes theme provider plumbing and color utilities so both
+    BootstyleBuilder (TTK) and BootstyleBuilderTk (Tk) can inherit and
+    avoid duplication.
+    """
+    _RE_TOKEN = re.compile(r"^\s*(?P<head>[a-zA-Z_][\w-]*)(?P<brackets>(?:\[[^]]*])*)\s*$")
+    def __init__(self, theme_provider: ThemeProvider | None = None, style_instance: Any | None = None):  # noqa: ANN401
+        # If no provider given, try to derive from style_instance
+        if theme_provider is None and style_instance is not None:
+            try:
+                theme_provider = style_instance.theme_provider  # type: ignore[attr-defined]
+            except Exception:
+                theme_provider = None
+        self._provider = theme_provider or use_theme()
+        self._style = style_instance
+    def set_style_instance(self, style_instance: Any) -> None:  # noqa: ANN401
+        self._style = style_instance
+    @property
+    def provider(self) -> ThemeProvider:
+        return self._provider
+    @property
+    def style(self) -> Any | None:  # noqa: ANN401
+        return self._style
+    @property
+    def colors(self) -> dict:
+        return self.provider.colors
+    # ----- Color Utilities & Transformers -----
+    def _parse_color_token(self, token: str):
+        """Parse a color token into head and ordered list of modifiers.
+        Returns a dict with:
+            - head: The base color name (e.g., "primary")
+            - modifiers: List of (type, value) tuples in order
+        """
+        m = self._RE_TOKEN.match(token)
+        if not m:
+            return None
+        head = m.group("head")
+        brackets_raw = m.group("brackets")
+        modifiers = []  # List of (type, value) tuples in order
+        if brackets_raw:
+            # Extract all bracket contents: [content1][content2] -> ["content1", "content2"]
+            bracket_contents = re.findall(r'\[([^]]*)]', brackets_raw)
+            # Process each bracket in order for pipeline
+            for bracket in bracket_contents:
+                part = bracket.strip().lower()
+                if not part:
+                    continue
+                if part.isdigit():
+                    modifiers.append(("shade", int(part)))
+                elif re.fullmatch(r'[+-]\s*\d+', part):
+                    rel = int(part.replace(" ", ""))
+                    modifiers.append(("elevation", rel))
+                elif part == "subtle":
+                    modifiers.append(("subtle", None))
+                elif part == "muted":
+                    modifiers.append(("muted", None))
+        return {"head": head, "modifiers": modifiers}
+    def color(self, token: str, surface: str | None = None, role: str = "background") -> str:
+        """Resolve a color token with optional chained modifiers.
+        Modifiers are applied as a pipeline from left to right:
+        - primary[100][muted] → lookup primary[100], then apply muted
+        - background[+1][muted] → lookup background, elevate it, then apply muted
+        Args:
+            token: Color token (e.g., "primary", "primary[100][muted]")
+                   Can also be a hex color string (e.g., "#ff0000")
+            surface: Optional surface color for subtle modifier
+            role: Role for subtle modifier ("background" or "text")
+        Returns:
+            The resolved color value as a hex string
+        Raises:
+            ValueError: If the color token cannot be resolved to a valid color.
+        """
+        # If token is already a hex color, return it directly
+        if token and token.startswith('#'):
+            return token
+        # Fast path: exact key (e.g., "blue[100]" or "primary")
+        direct = self.colors.get(token)
+        if direct is not None:
+            return direct
+        parsed = self._parse_color_token(token)
+        if not parsed:
+            result = self.colors.get(token)
+            if result is None:
+                raise ValueError(
+                    f"Invalid color token: '{token}'. "
+                    f"Valid color tokens include: primary, secondary, success, info, warning, danger, "
+                    f"light, dark, background, foreground, or a hex color like '#ff0000'."
+                )
+            return result
+        head = parsed["head"]
+        modifiers = parsed["modifiers"]
+        # Determine base lookup key
+        # If first modifier is a shade, use it for lookup and remove from pipeline
+        base_key = head
+        if modifiers and modifiers[0][0] == "shade":
+            shade_value = modifiers[0][1]
+            base_key = f"{head}[{shade_value}]"
+            modifiers = modifiers[1:]  # Remove shade from pipeline
+        # Get the base color
+        current_color = self.colors.get(base_key)
+        if current_color is None:
+            # Unknown base; fall back
+            result = self.colors.get(token)
+            if result is None:
+                raise ValueError(
+                    f"Invalid color token: '{token}'. "
+                    f"Valid color tokens include: primary, secondary, success, info, warning, danger, "
+                    f"light, dark, background, foreground, or a hex color like '#ff0000'."
+                )
+            return result
+        # Apply each modifier in order as a pipeline transformation
+        for mod_type, mod_value in modifiers:
+            if mod_type == "elevation":
+                current_color = self.elevate(current_color, mod_value)
+            elif mod_type == "subtle":
+                # Subtle needs special handling - it does its own lookup
+                # Use the base_key for lookup, not the current transformed color
+                current_color = self.subtle(base_key, surface, role)
+            elif mod_type == "muted":
+                # Muted transforms whatever color we currently have
+                current_color = self.muted_foreground(current_color)
+        return current_color
+    def subtle(self, token: str, surface: str | None = None, role: str = "background") -> str:
+        """Return a subtle instance of this color for background or text."""
+        # Parse token to handle compound tokens like 'primary[subtle]' or 'primary[100]'
+        parsed = self._parse_color_token(token)
+        if parsed:
+            base_key = parsed["head"]
+            # If first modifier is a shade, include it in the lookup key
+            modifiers = parsed["modifiers"]
+            if modifiers and modifiers[0][0] == "shade":
+                base_key = f"{base_key}[{modifiers[0][1]}]"
+            base_color = self.colors.get(base_key)
+        else:
+            base_color = self.colors.get(token)
+        # Fallback if lookup failed
+        if base_color is None:
+            base_color = self.colors.get(token) or self.colors.get('foreground')
+        surface_val = surface or self.colors.get('background')
+        if role == "text":
+            if self.provider.mode == "light":
+                return darken_color(base_color, 0.25)
+            else:
+                return lighten_color(base_color, 0.25)
+        else:  # background
+            if self.provider.mode == "light":
+                return mix_colors(base_color, surface_val, 0.08)
+            else:
+                return mix_colors(base_color, surface_val, 0.10)
+    def active(self, color: str) -> str:
+        return self._state_color(color, "active")
+    def pressed(self, color: str) -> str:
+        return self._state_color(color, "pressed")
+    def focus(self, color: str) -> str:
+        return self._state_color(color, "focus")
+    def selected(self, color: str) -> str:
+        return self._state_color(color, "selected")
+    def focus_border(self, color: str) -> str:
+        lum = relative_luminance(color)
+        if self.provider.mode == "dark":
+            return lighten_color(color, 0.1)
+        else:
+            return darken_color(color, 0.2 if lum > 0.5 else 0.1)
+    def focus_ring(self, color: str, surface: str | None = None) -> str:
+        surface = surface or self.color(color)
+        lum = relative_luminance(color)
+        if self.provider.mode == "dark":
+            if lum < 0.3:
+                brightened = lighten_color(color, 0.2)
+                mixed = mix_colors(brightened, surface, 0.2)
+            else:
+                mixed = mix_colors(color, surface, 0.3)
+        else:
+            if lum > 0.5:
+                blended = mix_colors(color, surface, 0.2)
+                mixed = darken_color(blended, 0.15)
+            else:
+                brightened = lighten_color(color, 0.25)
+                mixed = mix_colors(brightened, surface, 0.25)
+        return mixed
+    def focus_inner(self, fill: str) -> str:
+        """Internal focus line (2–3px), slightly brighter but not glowy."""
+        from bootstack.style.utility import contrast_ratio, hex_to_rgb
+        on = self.on_color(fill)
+        # Brighter defaults
+        w = 0.26 if self.provider.mode == "light" else 0.20
+        ring = mix_colors(on, fill, w)
+        # If still not distinct enough, bump once (bounded)
+        try:
+            bg = hex_to_rgb(fill)
+            fg = hex_to_rgb(ring)
+            if contrast_ratio(bg, fg) < 2.4:
+                w2 = min(w + 0.08, 0.34 if self.provider.mode == "light" else 0.28)
+                ring = mix_colors(on, fill, w2)
+        except Exception:
+            pass
+        return ring
+    def border(self, color: str, strength: float = 0.84) -> str:
+        """Derive a stroke color for a given surface by blending toward the surface's
+        computed on-color (text/icon color).
+        """
+        fg = self.on_color(color)
+        return mix_colors(color, fg, strength)
+    def on_color(self, color: str) -> str:
+        """Return a readable foreground color for the given background.
+        This is intentionally biased so that *dark-ish* accents get light
+        text rather than the mathematically highest-contrast dark text,
+        which tends to look wrong on buttons and pills.
+        """
+        background = self.color("background")
+        foreground = self.color("foreground")
+        try:
+            lum = relative_luminance(color)
+        except Exception:
+            candidates = [foreground, background, "#000000", "#ffffff"]
+            return best_foreground(color, candidates)
+        # Optional HSL-based accent detection to handle saturated mid-tone
+        # colors (like teal) that visually need light text even when their
+        # raw luminance is not very low.
+        hue = sat = hsl_lum = None
+        try:
+            hue, sat, hsl_lum = color_to_hsl(color, model="hex")
+        except Exception:
+            pass
+        if self.provider.mode == "light":
+            accent_force_light = False
+            if hue is not None and sat is not None and hsl_lum is not None:
+                # Treat saturated accents as needing light text when they are
+                # not extremely light overall. This catches teal/cyan/etc. but
+                # avoids triggering on near-white tinted backgrounds.
+                if sat >= 40 and hsl_lum <= 80:
+                    # Strong teal/cyan/blue band (e.g., teal[600], cyan[600])
+                    if 140 <= hue <= 220:
+                        accent_force_light = True
+                    # Other saturated accents, excluding the yellow/orange band,
+                    # when not extremely light.
+                    elif hsl_lum <= 70 and not (35 <= hue <= 70):
+                        accent_force_light = True
+            # Saturated accents: force pure white text so contrast decisions
+            # don't accidentally favor dark foreground on mid-tone accents.
+            if accent_force_light:
+                candidates = ["#ffffff"]
+            # Anything darker than ~55% luminance is treated as a dark surface:
+            # always use light text, even if contrast math slightly prefers dark.
+            elif lum <= 0.55:
+                candidates = ["#ffffff"]
+            # Mid-light colors (e.g., warning/info) can work with either;
+            # allow contrast to choose, but still bias toward theme foreground.
+            elif lum <= 0.80:
+                candidates = [foreground, "#ffffff", "#000000"]
+            # Very light backgrounds -> dark text
+            else:
+                candidates = [foreground, "#000000"]
+        else:
+            # Dark mode: inverse bias.
+            if lum >= 0.75:
+                # Very light chips / badges -> dark text
+                candidates = ["#000000", foreground]
+            elif lum >= 0.45:
+                # Mid tones -> let contrast pick, but include light text
+                candidates = ["#ffffff", foreground, "#000000"]
+            else:
+                # Very dark surfaces -> light text
+                candidates = ["#ffffff", foreground]
+        # Deduplicate and remove empty candidates
+        unique: list[str] = []
+        for c in candidates:
+            if c and c not in unique:
+                unique.append(c)
+        return best_foreground(color, unique)
+    def muted_foreground(self, background: str, min_contrast: float = 4.5) -> str:
+        """Return a muted foreground color with adequate contrast.
+        Generates a subdued text color that maintains readability across
+        varying backgrounds by ensuring minimum WCAG contrast requirements.
+        Args:
+            background: The background color to contrast against.
+            min_contrast: Minimum WCAG contrast ratio (4.5 for AA, 7.0 for AAA).
+                         Default is 4.5 (AA standard for normal text).
+        Returns:
+            A muted foreground color with adequate contrast against the background.
+        """
+        from bootstack.style.utility import hex_to_rgb, contrast_ratio
+        lum = relative_luminance(background)
+        bg_rgb = hex_to_rgb(background)
+        # Determine if we need light or dark muted text
+        if lum > 0.5:
+            # Light background -> use muted dark text
+            base_color = "#495057"  # Dark gray
+        else:
+            # Dark background -> use muted light text
+            base_color = "#adb5bd"  # Light gray
+        # Check if base muted color has adequate contrast
+        fg_rgb = hex_to_rgb(base_color)
+        ratio = contrast_ratio(bg_rgb, fg_rgb)
+        if ratio >= min_contrast:
+            return base_color
+        # If not enough contrast, adjust toward pure black/white
+        target = "#000000" if lum > 0.5 else "#ffffff"
+        # Binary search for minimum adjustment needed
+        for weight in [0.2, 0.4, 0.6, 0.8, 1.0]:
+            adjusted = mix_colors(target, base_color, weight)
+            adjusted_rgb = hex_to_rgb(adjusted)
+            ratio = contrast_ratio(bg_rgb, adjusted_rgb)
+            if ratio >= min_contrast:
+                return adjusted
+        # Fallback to pure contrast
+        return target
+    def disabled(self, role: str = "background", surface: str | None = None) -> str:
+        """Return a disabled color mixed with the surface.
+        Args:
+            role: 'background' for surfaces, 'text' for foregrounds.
+            surface: Optional surface color to mix against. If omitted,
+                     uses the theme background.
+        """
+        surface = surface or self.color('background')
+        if role == "text":
+            if self.provider.mode == "light":
+                gray = "#6c757d"
+                mix_ratio = 0.35
+            else:
+                gray = "#adb5bd"
+                mix_ratio = 0.25
+        elif role == "background":
+            if self.provider.mode == "light":
+                gray = "#dee2e6"
+                mix_ratio = 0.15
+            else:
+                gray = "#495057"
+                mix_ratio = 0.20
+        else:
+            raise ValueError(f"Invalid role: {role}. Expected 'text' or 'background'.")
+        return mix_colors(gray, surface, mix_ratio)
+    def elevate(self, color: str, elevation: int = 0, max_elevation: int = 5) -> str:
+        if elevation <= 0:
+            return color
+        blend_target = "#000000" if self.provider.mode == "light" else "#ffffff"
+        weight = min(elevation / max_elevation, 1.0) * 0.3
+        return mix_colors(blend_target, color, weight)
+    @staticmethod
+    def _state_color(color: str, state: str) -> str:
+        if state == "focus":
+            return color
+        delta = {
+            "active": 0.08,
+            "selected": 0.18,  # was effectively ~0.10–0.16; bump a bit
+            "pressed": 0.12,
+            "focus": 0.08,
+        }[state]
+        # Selected should read as "latched": always darken.
+        if state == "selected":
+            return darken_color(color, delta)
+        lum = relative_luminance(color)
+        if lum < 0.5:
+            return lighten_color(color, delta)
+        return darken_color(color, delta)
+    @staticmethod
+    def scale(value: Union[int, List, Tuple]):
+        return scale_size(value)
+    @staticmethod
+    def scale_from_source(value: Union[int, float, List, Tuple]):
+        """Scale a value measured in source image pixels.
+        Source images are created at SOURCE_RESOLUTION (2x). This method
+        converts source pixel measurements to 1x values, then applies DPI scaling.
+        Use this when you measure border, padding, or other values directly
+        from your source image assets.
+        Args:
+            value: Pixel measurement from source image (int, float, or sequence)
+        Returns:
+            DPI-scaled value appropriate for the current display
+        Example:
+            # If your source image has 10px corners:
+            border=b.scale_from_source(10)  # Correctly scales for all DPIs
+        """
+        if isinstance(value, (int, float)):
+            return scale_size(int(value / SOURCE_RESOLUTION + 0.5))
+        elif isinstance(value, (tuple, list)):
+            scaled = [int(v / SOURCE_RESOLUTION + 0.5) for v in value]
+            return scale_size(scaled)
+        return scale_size(value)
+    # ----- Icon Utilities -----
+    @staticmethod
+    def normalize_icon_spec(icon: str | IconSpec, default_size: int = 18) -> IconSpec:
+        """
+            If the icon is a string, then create a icon spec where the name is known and the size is set to default_size.
+            If the there is an icon spec, map the default size if one is not already specified in the spec.
+            Icon sizes are automatically scaled based on DPI settings. The default size of 20px provides
+            a balanced appearance, being slightly larger than the visible text (16px) but not overwhelming.
+        """
+        from bootstack.runtime.utility import scale_size
+        # Apply DPI scaling to default size
+        scaled_default = scale_size(default_size)
+        if isinstance(icon, str):
+            return dict(name=icon, size=scaled_default)
+        else:
+            # Create a copy to avoid mutating the original dict
+            # This prevents size from growing on each theme change
+            result = icon.copy()
+            if 'size' not in result or result.get('size') is None:
+                result['size'] = scaled_default
+            elif result.get('size'):
+                # Scale user-provided size too
+                result['size'] = scale_size(result['size'])
+            return result
+    def map_stateful_icons(self, icon: IconSpec, foreground_spec: Sequence[tuple]):
+        """
+        Build and return a TTK image state map for icons, using the
+        configured icon provider.
+        Parameters:
+            icon (IconSpec):
+                Base icon spec with default `name` and optional `size`/`color`.
+                Optional `state` provides per-state overrides where the value
+                can be either a string (state-specific icon name) or a dict
+                with `name` and/or `color`.
+            foreground_spec (Sequence[tuple]):
+                A sequence of state → foreground color items computed by the
+                builder, e.g.:
+                    [
+                        ('disabled', '#fafafa'),
+                        ('pressed !disabled', '#63f3f3'),
+                        ('hover !disabled', '#f2fa5d'),
+                    ]
+        Behavior:
+            - If `icon.color` is provided at the root, use it as the default
+              color for all states unless a per-state override is provided.
+            - If `icon.color` is not provided, the icon color follows the
+              widget's foreground color provided by `foreground_spec`, unless
+              a per-state override is provided in `icon.state`.
+            - If a per-state override provides `name`, use that icon name for
+              the state; otherwise, fallback to the base icon `name`.
+            - Identical (name, size, color) combinations reuse the same image.
+        Returns:
+            list[tuple[str, str]]: List of (state, image_name) tuples suitable
+            for `ttk.Style.element_create(..., 'image', default, (state, image) ...)`.
+        """
+        # Normalize base values
+        base_name: str = icon.get('name')  # type: ignore[assignment]
+        if not base_name:
+            # Nothing we can do without an icon name
+            return []
+        base_size: int = int(icon.get('size') or 20)
+        base_color: str | None = icon.get('color')
+        # Build per-state override lookup: {state_str: {'name':..., 'color':...}}
+        state_overrides: dict[str, IconStateMap] = {}
+        for entry in icon.get('state', []) or []:
+            try:
+                st, ov = entry  # type: ignore[misc]
+            except Exception:
+                continue
+            if isinstance(ov, str):
+                state_overrides[st] = {'name': ov}
+            elif isinstance(ov, dict):
+                # Only keep known keys
+                override: IconStateMap = {}
+                if 'name' in ov and ov['name']:
+                    override['name'] = ov['name']  # type: ignore[assignment]
+                if 'color' in ov and ov['color']:
+                    override['color'] = ov['color']  # type: ignore[assignment]
+                if override:
+                    state_overrides[st] = override
+        # Obtain the provider callable (class or function). The provider itself
+        # is called as the icon constructor: provider(name, size, color) -> icon
+        def _resolve_fg(value: Any) -> str | None:  # noqa: ANN401
+            """Extract a color string from the foreground state spec value."""
+            if isinstance(value, str):
+                return value
+            if isinstance(value, dict):
+                # Try common keys in order
+                for k in ('foreground', 'text', 'color'):
+                    v = value.get(k)
+                    if isinstance(v, str):
+                        return v
+            return None
+        # Cache icons by (name, size, color) to avoid duplicates
+        cache: dict[tuple[str, int, str | None], Any] = {}
+        def _image_for(name: str, size: int, color: str | None):
+            key = (name, size, color)
+            if key in cache:
+                return cache[key]
+            # Special case: 'empty' creates a transparent placeholder image
+            if name == 'empty':
+                from bootstack.style.utility import create_transparent_image
+                img = create_transparent_image(size, size)
+                cache[key] = img
+                return img
+            # Ensure our custom icon provider is initialized with the correct y_bias
+            _ensure_icon_provider()
+            # Call the provider directly; it returns an icon object with `.image`
+            try:
+                icon_obj = BootstrapIcon(name=name, size=size, color=color)  # type: ignore[misc]
+            except TypeError:
+                icon_obj = BootstrapIcon(name, size, color)  # type: ignore[misc]
+            if icon_obj is None:
+                return None
+            cache[key] = icon_obj.image
+            return icon_obj.image
+        state_image_specs: list[tuple[str, Any]] = []
+        def _match_override(expr: str) -> IconStateMap | None:
+            # 1) Exact expression match (e.g., 'hover !disabled')
+            if expr in state_overrides:
+                return state_overrides[expr]
+            # 2) Token match: treat state keywords as tokens; ignore negations like '!disabled'
+            tokens = {t for t in expr.split() if t and not t.startswith('!')}
+            for key, ov in state_overrides.items():
+                if not key:
+                    # skip empty-key overrides here; apply only to '' base state
+                    continue
+                if key in tokens:
+                    return ov
+            # 3) No match
+            return None
+        # Build ordered list of states to map
+        base_states: list[str] = [s for s, _ in foreground_spec]
+        fg_lookup: dict[str, Any] = {s: v for s, v in foreground_spec}
+        # Ensure typical derivations for overrides exist (e.g., 'hover' -> 'hover !disabled')
+        def _derive_expr(k: str) -> str:
+            if not k:
+                return ''
+            if ' ' in k or '!' in k:
+                return k
+            if k in ('pressed', 'active'):
+                return 'pressed !disabled'
+            if k == 'selected':
+                return 'selected !disabled'
+            if k == 'hover':
+                return 'hover !disabled'
+            return k
+        extra_states: list[str] = []
+        seen = set(base_states)
+        default_present = '' in seen
+        if default_present:
+            # Exclude default for ordering; add back later
+            base_states_no_default = [s for s in base_states if s != '']
+        else:
+            base_states_no_default = base_states[:]
+        # Add override-derived states if not already present
+        for k in state_overrides.keys():
+            expr = _derive_expr(k)
+            if expr not in seen:
+                extra_states.append(expr)
+                seen.add(expr)
+        # Compose final order: base (without ''), then extras, then default ''
+        ordered_states = base_states_no_default + extra_states
+        if default_present:
+            ordered_states.append('')
+        for state_expr in ordered_states:
+            fg_val = fg_lookup.get(state_expr)
+            # Derive per-state name/color
+            override = _match_override(state_expr) or {}
+            name = override.get('name', base_name)  # type: ignore[assignment]
+            # Determine color priority: per-state override > base_color > foreground state color
+            color = override.get('color')  # type: ignore[assignment]
+            if color is None:
+                if base_color is not None:
+                    color = base_color
+                else:
+                    color = _resolve_fg(fg_val)
+            # Build or reuse the image
+            img_or_photo = _image_for(name, base_size, color)
+            if img_or_photo is not None:
+                state_image_specs.append((state_expr, img_or_photo))
+        return state_image_specs