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

bootstack 0.1.0__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 (471) hide show

bootstack/__init__.py +157 -0
bootstack/__main__.py +5 -0
bootstack/_core/__init__.py +21 -0
bootstack/_core/capabilities/__init__.py +45 -0
bootstack/_core/capabilities/after.py +103 -0
bootstack/_core/capabilities/bind.py +192 -0
bootstack/_core/capabilities/bindtags.py +112 -0
bootstack/_core/capabilities/busy.py +72 -0
bootstack/_core/capabilities/clipboard.py +89 -0
bootstack/_core/capabilities/focus.py +118 -0
bootstack/_core/capabilities/grab.py +65 -0
bootstack/_core/capabilities/grid.py +211 -0
bootstack/_core/capabilities/localization.py +231 -0
bootstack/_core/capabilities/pack.py +140 -0
bootstack/_core/capabilities/place.py +113 -0
bootstack/_core/capabilities/selection.py +136 -0
bootstack/_core/capabilities/signals.py +244 -0
bootstack/_core/capabilities/winfo.py +315 -0
bootstack/_core/colorutils.py +234 -0
bootstack/_core/exceptions.py +25 -0
bootstack/_core/images.py +463 -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/paths.py +49 -0
bootstack/_core/publisher.py +149 -0
bootstack/_core/variables.py +62 -0
bootstack/_runtime/__init__.py +3 -0
bootstack/_runtime/app.py +930 -0
bootstack/_runtime/base_window.py +945 -0
bootstack/_runtime/events.py +399 -0
bootstack/_runtime/shortcuts.py +496 -0
bootstack/_runtime/tk_patch.py +43 -0
bootstack/_runtime/toplevel.py +276 -0
bootstack/_runtime/utility.py +457 -0
bootstack/_runtime/visual_focus.py +240 -0
bootstack/_runtime/window_utilities.py +1123 -0
bootstack/assets/__init__.py +21 -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/button-compact.png +0 -0
bootstack/assets/elements/button-default.png +0 -0
bootstack/assets/elements/buttongroup-after-h-compact.png +0 -0
bootstack/assets/elements/buttongroup-after-h-default.png +0 -0
bootstack/assets/elements/buttongroup-after-v-compact.png +0 -0
bootstack/assets/elements/buttongroup-after-v-default.png +0 -0
bootstack/assets/elements/buttongroup-before-h-compact.png +0 -0
bootstack/assets/elements/buttongroup-before-h-default.png +0 -0
bootstack/assets/elements/buttongroup-before-v-compact.png +0 -0
bootstack/assets/elements/buttongroup-before-v-default.png +0 -0
bootstack/assets/elements/buttongroup-center-h-compact.png +0 -0
bootstack/assets/elements/buttongroup-center-h-default.png +0 -0
bootstack/assets/elements/buttongroup-center-v-compact.png +0 -0
bootstack/assets/elements/buttongroup-center-v-default.png +0 -0
bootstack/assets/elements/card.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-addon-compact.png +0 -0
bootstack/assets/elements/input-addon-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/listrow-compact.png +0 -0
bootstack/assets/elements/listrow-default.png +0 -0
bootstack/assets/elements/manifest.toml +361 -0
bootstack/assets/elements/menu-item.png +0 -0
bootstack/assets/elements/navitem-compact.png +0 -0
bootstack/assets/elements/navitem-default.png +0 -0
bootstack/assets/elements/progressbar-h-compact.png +0 -0
bootstack/assets/elements/progressbar-h-default.png +0 -0
bootstack/assets/elements/progressbar-v-compact.png +0 -0
bootstack/assets/elements/progressbar-v-default.png +0 -0
bootstack/assets/elements/radiobutton.png +0 -0
bootstack/assets/elements/scrollbar-horizontal.png +0 -0
bootstack/assets/elements/scrollbar-vertical.png +0 -0
bootstack/assets/elements/slider-handle.png +0 -0
bootstack/assets/elements/slider-track-h.png +0 -0
bootstack/assets/elements/slider-track-v.png +0 -0
bootstack/assets/elements/switch-off.png +0 -0
bootstack/assets/elements/switch-on.png +0 -0
bootstack/assets/elements/tab-h.png +0 -0
bootstack/assets/elements/tab-v.png +0 -0
bootstack/assets/icons/bootstrap.ttf +0 -0
bootstack/assets/icons/glyphmap.json +2080 -0
bootstack/assets/icons/icon_metrics.json +12470 -0
bootstack/assets/locales/ar/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ar/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/bg/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/bg/LC_MESSAGES/bootstack.po +878 -0
bootstack/assets/locales/cs/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/cs/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/da/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/da/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/de/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/de/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/en/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/en/LC_MESSAGES/bootstack.po +878 -0
bootstack/assets/locales/es/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/es/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/fr/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/fr/LC_MESSAGES/bootstack.po +856 -0
bootstack/assets/locales/he/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/he/LC_MESSAGES/bootstack.po +854 -0
bootstack/assets/locales/hi/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/hi/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/it/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/it/LC_MESSAGES/bootstack.po +844 -0
bootstack/assets/locales/ja/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ja/LC_MESSAGES/bootstack.po +917 -0
bootstack/assets/locales/ko/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/ko/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/nb/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/nb/LC_MESSAGES/bootstack.po +844 -0
bootstack/assets/locales/nl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/nl/LC_MESSAGES/bootstack.po +844 -0
bootstack/assets/locales/pl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pl/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/pt/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pt/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/pt_BR/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/pt_BR/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/sl/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/sl/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/sv/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/sv/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/tr/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/tr/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/zh_CN/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/zh_CN/LC_MESSAGES/bootstack.po +845 -0
bootstack/assets/locales/zh_TW/LC_MESSAGES/bootstack.mo +0 -0
bootstack/assets/locales/zh_TW/LC_MESSAGES/bootstack.po +845 -0
bootstack/cli/__init__.py +133 -0
bootstack/cli/__main__.py +6 -0
bootstack/cli/add.py +395 -0
bootstack/cli/appicon.py +285 -0
bootstack/cli/build.py +115 -0
bootstack/cli/config.py +313 -0
bootstack/cli/demo.py +564 -0
bootstack/cli/dev.py +153 -0
bootstack/cli/doctor.py +195 -0
bootstack/cli/icons.py +98 -0
bootstack/cli/promote.py +120 -0
bootstack/cli/pyinstaller.py +268 -0
bootstack/cli/run.py +95 -0
bootstack/cli/start.py +117 -0
bootstack/cli/templates/__init__.py +931 -0
bootstack/clipboard.py +48 -0
bootstack/constants.py +318 -0
bootstack/data/README.md +615 -0
bootstack/data/__init__.py +78 -0
bootstack/data/_observable.py +276 -0
bootstack/data/base.py +780 -0
bootstack/data/file_source.py +367 -0
bootstack/data/memory_source.py +450 -0
bootstack/data/query.py +367 -0
bootstack/data/readers.py +289 -0
bootstack/data/sqlite_source.py +869 -0
bootstack/data/types.py +354 -0
bootstack/data/writers.py +232 -0
bootstack/dev/__init__.py +36 -0
bootstack/dev/_capture.py +141 -0
bootstack/dev/_env.py +43 -0
bootstack/dev/_registry.py +140 -0
bootstack/dev/_reloader.py +351 -0
bootstack/dev/_reset.py +50 -0
bootstack/dev/_watcher.py +91 -0
bootstack/dialogs/__init__.py +948 -0
bootstack/dialogs/_impl/__init__.py +47 -0
bootstack/dialogs/_impl/colorchooser.py +588 -0
bootstack/dialogs/_impl/datedialog.py +450 -0
bootstack/dialogs/_impl/dialog.py +594 -0
bootstack/dialogs/_impl/filterdialog.py +358 -0
bootstack/dialogs/_impl/fontdialog.py +364 -0
bootstack/dialogs/_impl/formdialog.py +564 -0
bootstack/dialogs/_impl/message.py +486 -0
bootstack/dialogs/_impl/query.py +570 -0
bootstack/errors.py +67 -0
bootstack/events/__init__.py +111 -0
bootstack/events/_event.py +135 -0
bootstack/events/_payloads.py +539 -0
bootstack/events/_subscription.py +38 -0
bootstack/i18n/README.md +77 -0
bootstack/i18n/__init__.py +23 -0
bootstack/i18n/catalog.py +121 -0
bootstack/i18n/intl_format.py +584 -0
bootstack/i18n/msgcat.py +425 -0
bootstack/i18n/specs.py +156 -0
bootstack/images.py +563 -0
bootstack/py.typed +1 -0
bootstack/scheduling/__init__.py +11 -0
bootstack/scheduling/_schedule.py +218 -0
bootstack/shortcuts.py +21 -0
bootstack/signals/README.md +98 -0
bootstack/signals/__init__.py +10 -0
bootstack/signals/integration.py +100 -0
bootstack/signals/signal.py +353 -0
bootstack/signals/types.py +6 -0
bootstack/store.py +286 -0
bootstack/streams/__init__.py +12 -0
bootstack/streams/_stream.py +321 -0
bootstack/style/__init__.py +38 -0
bootstack/style/builders/__init__.py +51 -0
bootstack/style/builders/badge.py +46 -0
bootstack/style/builders/button.py +339 -0
bootstack/style/builders/buttongroup.py +311 -0
bootstack/style/builders/calendar.py +271 -0
bootstack/style/builders/checkbutton.py +110 -0
bootstack/style/builders/combobox.py +113 -0
bootstack/style/builders/contextmenu.py +268 -0
bootstack/style/builders/entry.py +82 -0
bootstack/style/builders/expander.py +148 -0
bootstack/style/builders/field.py +335 -0
bootstack/style/builders/frame.py +50 -0
bootstack/style/builders/label.py +28 -0
bootstack/style/builders/labelframe.py +34 -0
bootstack/style/builders/listview.py +369 -0
bootstack/style/builders/menubar.py +91 -0
bootstack/style/builders/menubutton.py +359 -0
bootstack/style/builders/panedwindow.py +25 -0
bootstack/style/builders/progressbar.py +67 -0
bootstack/style/builders/radiobutton.py +99 -0
bootstack/style/builders/scale.py +64 -0
bootstack/style/builders/scrollbar.py +225 -0
bootstack/style/builders/separator.py +49 -0
bootstack/style/builders/sidenav.py +643 -0
bootstack/style/builders/sizegrip.py +15 -0
bootstack/style/builders/spinbox.py +119 -0
bootstack/style/builders/switch.py +70 -0
bootstack/style/builders/tabitem.py +204 -0
bootstack/style/builders/togglegroup.py +294 -0
bootstack/style/builders/toolbutton.py +275 -0
bootstack/style/builders/tooltip.py +26 -0
bootstack/style/builders/treeview.py +193 -0
bootstack/style/builders/utils.py +455 -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/fonts.py +123 -0
bootstack/style/style.py +609 -0
bootstack/style/style_builder_base.py +716 -0
bootstack/style/style_builder_mixed.py +93 -0
bootstack/style/style_builder_tk.py +109 -0
bootstack/style/style_builder_ttk.py +353 -0
bootstack/style/style_resolver.py +447 -0
bootstack/style/theme.py +245 -0
bootstack/style/theme_provider.py +471 -0
bootstack/style/themes/__init__.py +128 -0
bootstack/style/tk_patch.py +5 -0
bootstack/style/token_maps.py +41 -0
bootstack/style/types.py +32 -0
bootstack/style/typography.py +523 -0
bootstack/style/utility.py +746 -0
bootstack/types.py +39 -0
bootstack/validation/__init__.py +6 -0
bootstack/validation/types.py +15 -0
bootstack/validation/validation_result.py +17 -0
bootstack/validation/validation_rules.py +205 -0
bootstack/widgets/__init__.py +74 -0
bootstack/widgets/_core/__init__.py +31 -0
bootstack/widgets/_core/app_config.py +266 -0
bootstack/widgets/_core/base.py +461 -0
bootstack/widgets/_core/container.py +334 -0
bootstack/widgets/_core/context.py +35 -0
bootstack/widgets/_core/events.py +130 -0
bootstack/widgets/_core/field_mixin.py +353 -0
bootstack/widgets/_core/icon_image_props.py +72 -0
bootstack/widgets/_core/image_binding.py +93 -0
bootstack/widgets/_core/navmodel.py +345 -0
bootstack/widgets/_core/options.py +210 -0
bootstack/widgets/_core/selection_group.py +130 -0
bootstack/widgets/_core/window_controls.py +96 -0
bootstack/widgets/_core/window_menu.py +246 -0
bootstack/widgets/_impl/__init__.py +1 -0
bootstack/widgets/_impl/_internal/__init__.py +0 -0
bootstack/widgets/_impl/_internal/wrapper_base.py +307 -0
bootstack/widgets/_impl/_parts/__init__.py +11 -0
bootstack/widgets/_impl/_parts/numberentry_part.py +385 -0
bootstack/widgets/_impl/_parts/spinnerentry_part.py +434 -0
bootstack/widgets/_impl/_parts/textentry_part.py +406 -0
bootstack/widgets/_impl/composites/__init__.py +33 -0
bootstack/widgets/_impl/composites/_dateutils.py +33 -0
bootstack/widgets/_impl/composites/_image_fit.py +105 -0
bootstack/widgets/_impl/composites/accordion.py +381 -0
bootstack/widgets/_impl/composites/avatar.py +191 -0
bootstack/widgets/_impl/composites/buttongroup.py +371 -0
bootstack/widgets/_impl/composites/calendar.py +972 -0
bootstack/widgets/_impl/composites/carousel.py +567 -0
bootstack/widgets/_impl/composites/chart.py +882 -0
bootstack/widgets/_impl/composites/compositeframe.py +298 -0
bootstack/widgets/_impl/composites/contextmenu.py +1951 -0
bootstack/widgets/_impl/composites/dateentry.py +404 -0
bootstack/widgets/_impl/composites/dropdownbutton.py +325 -0
bootstack/widgets/_impl/composites/expander.py +515 -0
bootstack/widgets/_impl/composites/field.py +670 -0
bootstack/widgets/_impl/composites/form.py +1066 -0
bootstack/widgets/_impl/composites/gallery.py +551 -0
bootstack/widgets/_impl/composites/list/__init__.py +15 -0
bootstack/widgets/_impl/composites/list/listitem.py +802 -0
bootstack/widgets/_impl/composites/list/listview.py +1433 -0
bootstack/widgets/_impl/composites/menu/__init__.py +18 -0
bootstack/widgets/_impl/composites/menu/model.py +358 -0
bootstack/widgets/_impl/composites/menu/render_native.py +134 -0
bootstack/widgets/_impl/composites/menu/render_themed.py +134 -0
bootstack/widgets/_impl/composites/meter.py +860 -0
bootstack/widgets/_impl/composites/numericentry.py +201 -0
bootstack/widgets/_impl/composites/pagestack.py +395 -0
bootstack/widgets/_impl/composites/passwordentry.py +142 -0
bootstack/widgets/_impl/composites/pathentry.py +168 -0
bootstack/widgets/_impl/composites/picture.py +289 -0
bootstack/widgets/_impl/composites/radiogroup.py +511 -0
bootstack/widgets/_impl/composites/scrolledtext.py +375 -0
bootstack/widgets/_impl/composites/scrolledtext.pyi +186 -0
bootstack/widgets/_impl/composites/scrollview.py +764 -0
bootstack/widgets/_impl/composites/selectbox.py +1026 -0
bootstack/widgets/_impl/composites/shell/__init__.py +40 -0
bootstack/widgets/_impl/composites/shell/content_host.py +52 -0
bootstack/widgets/_impl/composites/shell/layout.py +335 -0
bootstack/widgets/_impl/composites/shell/nav_panel.py +345 -0
bootstack/widgets/_impl/composites/shell/providers.py +558 -0
bootstack/widgets/_impl/composites/shell/rail.py +117 -0
bootstack/widgets/_impl/composites/shell/shell.py +581 -0
bootstack/widgets/_impl/composites/shell/workspace.py +273 -0
bootstack/widgets/_impl/composites/sidenav/__init__.py +16 -0
bootstack/widgets/_impl/composites/sidenav/header.py +81 -0
bootstack/widgets/_impl/composites/sidenav/separator.py +44 -0
bootstack/widgets/_impl/composites/slider/__init__.py +7 -0
bootstack/widgets/_impl/composites/slider/_shared.py +195 -0
bootstack/widgets/_impl/composites/slider/rangeslider.py +982 -0
bootstack/widgets/_impl/composites/slider/slider.py +851 -0
bootstack/widgets/_impl/composites/spinnerentry.py +185 -0
bootstack/widgets/_impl/composites/tableview/__init__.py +5 -0
bootstack/widgets/_impl/composites/tableview/tableview.py +3388 -0
bootstack/widgets/_impl/composites/tableview/types.py +169 -0
bootstack/widgets/_impl/composites/tabs/__init__.py +23 -0
bootstack/widgets/_impl/composites/tabs/tabitem.py +389 -0
bootstack/widgets/_impl/composites/tabs/tabs.py +974 -0
bootstack/widgets/_impl/composites/tabs/tabview.py +650 -0
bootstack/widgets/_impl/composites/textarea/__init__.py +26 -0
bootstack/widgets/_impl/composites/textarea/change.py +46 -0
bootstack/widgets/_impl/composites/textarea/codeeditor.py +526 -0
bootstack/widgets/_impl/composites/textarea/core.py +495 -0
bootstack/widgets/_impl/composites/textarea/decoration.py +42 -0
bootstack/widgets/_impl/composites/textarea/diff.py +127 -0
bootstack/widgets/_impl/composites/textarea/extensions/__init__.py +1 -0
bootstack/widgets/_impl/composites/textarea/extensions/bracket_matcher.py +138 -0
bootstack/widgets/_impl/composites/textarea/extensions/indent_guides.py +158 -0
bootstack/widgets/_impl/composites/textarea/extensions/line_numbers.py +138 -0
bootstack/widgets/_impl/composites/textarea/extensions/pygments_highlighter.py +312 -0
bootstack/widgets/_impl/composites/textarea/extensions/smart_indent.py +177 -0
bootstack/widgets/_impl/composites/textarea/filter.py +171 -0
bootstack/widgets/_impl/composites/textarea/search_overlay.py +459 -0
bootstack/widgets/_impl/composites/textarea/sidebar.py +88 -0
bootstack/widgets/_impl/composites/textarea/style_registry.py +178 -0
bootstack/widgets/_impl/composites/textarea/textarea.py +606 -0
bootstack/widgets/_impl/composites/textarea/undo.py +217 -0
bootstack/widgets/_impl/composites/textentry.py +57 -0
bootstack/widgets/_impl/composites/timeentry.py +176 -0
bootstack/widgets/_impl/composites/toast.py +390 -0
bootstack/widgets/_impl/composites/toast_stack.py +156 -0
bootstack/widgets/_impl/composites/togglegroup.py +418 -0
bootstack/widgets/_impl/composites/toolbar.py +608 -0
bootstack/widgets/_impl/composites/tooltip.py +491 -0
bootstack/widgets/_impl/composites/tree/__init__.py +7 -0
bootstack/widgets/_impl/composites/tree/source_binding.py +136 -0
bootstack/widgets/_impl/composites/tree/treeitem.py +393 -0
bootstack/widgets/_impl/composites/tree/treenode.py +174 -0
bootstack/widgets/_impl/composites/tree/treeview.py +841 -0
bootstack/widgets/_impl/mixins/__init__.py +24 -0
bootstack/widgets/_impl/mixins/configure_mixin.py +216 -0
bootstack/widgets/_impl/mixins/entry_mixin.py +134 -0
bootstack/widgets/_impl/mixins/font_mixin.py +368 -0
bootstack/widgets/_impl/mixins/icon_mixin.py +61 -0
bootstack/widgets/_impl/mixins/localization_mixin.py +253 -0
bootstack/widgets/_impl/mixins/signal_mixin.py +268 -0
bootstack/widgets/_impl/mixins/validation_mixin.py +226 -0
bootstack/widgets/_impl/primitives/__init__.py +49 -0
bootstack/widgets/_impl/primitives/_menubutton.py +107 -0
bootstack/widgets/_impl/primitives/badge.py +45 -0
bootstack/widgets/_impl/primitives/button.py +76 -0
bootstack/widgets/_impl/primitives/card.py +45 -0
bootstack/widgets/_impl/primitives/checkbutton.py +124 -0
bootstack/widgets/_impl/primitives/checktoggle.py +62 -0
bootstack/widgets/_impl/primitives/combobox.py +156 -0
bootstack/widgets/_impl/primitives/entry.py +87 -0
bootstack/widgets/_impl/primitives/flexframe.py +448 -0
bootstack/widgets/_impl/primitives/frame.py +185 -0
bootstack/widgets/_impl/primitives/gridframe.py +546 -0
bootstack/widgets/_impl/primitives/label.py +84 -0
bootstack/widgets/_impl/primitives/labelframe.py +54 -0
bootstack/widgets/_impl/primitives/optionmenu.py +387 -0
bootstack/widgets/_impl/primitives/packframe.py +227 -0
bootstack/widgets/_impl/primitives/panedwindow.py +45 -0
bootstack/widgets/_impl/primitives/progressbar.py +83 -0
bootstack/widgets/_impl/primitives/radiobutton.py +115 -0
bootstack/widgets/_impl/primitives/radiotoggle.py +54 -0
bootstack/widgets/_impl/primitives/scrollbar.py +42 -0
bootstack/widgets/_impl/primitives/separator.py +43 -0
bootstack/widgets/_impl/primitives/sizegrip.py +33 -0
bootstack/widgets/_impl/primitives/spinbox.py +95 -0
bootstack/widgets/_impl/primitives/switch.py +44 -0
bootstack/widgets/_impl/primitives/treeview.py +69 -0
bootstack/widgets/app.py +371 -0
bootstack/widgets/appshell.py +1179 -0
bootstack/widgets/avatar.py +140 -0
bootstack/widgets/boolean_controls.py +455 -0
bootstack/widgets/button.py +224 -0
bootstack/widgets/buttongroup.py +239 -0
bootstack/widgets/calendar.py +195 -0
bootstack/widgets/card.py +159 -0
bootstack/widgets/carousel.py +241 -0
bootstack/widgets/chart.py +302 -0
bootstack/widgets/codeeditor.py +675 -0
bootstack/widgets/contextmenu.py +371 -0
bootstack/widgets/datatable.py +688 -0
bootstack/widgets/datefield.py +395 -0
bootstack/widgets/divider.py +60 -0
bootstack/widgets/expander.py +579 -0
bootstack/widgets/form.py +200 -0
bootstack/widgets/gallery.py +250 -0
bootstack/widgets/gauge.py +168 -0
bootstack/widgets/grid.py +121 -0
bootstack/widgets/groupbox.py +162 -0
bootstack/widgets/label.py +229 -0
bootstack/widgets/listview.py +354 -0
bootstack/widgets/menubutton.py +419 -0
bootstack/widgets/numberfield.py +431 -0
bootstack/widgets/pagestack.py +345 -0
bootstack/widgets/passwordfield.py +383 -0
bootstack/widgets/pathfield.py +454 -0
bootstack/widgets/picture.py +251 -0
bootstack/widgets/progressbar.py +106 -0
bootstack/widgets/radio_variants.py +271 -0
bootstack/widgets/radiogroup.py +228 -0
bootstack/widgets/scrollbar.py +64 -0
bootstack/widgets/scrollview.py +186 -0
bootstack/widgets/select.py +302 -0
bootstack/widgets/selectbutton.py +182 -0
bootstack/widgets/sidebar_toggle.py +130 -0
bootstack/widgets/sizegrip.py +42 -0
bootstack/widgets/slider.py +408 -0
bootstack/widgets/spinbox.py +147 -0
bootstack/widgets/spinnerfield.py +413 -0
bootstack/widgets/splash.py +367 -0
bootstack/widgets/splitview.py +482 -0
bootstack/widgets/stacks.py +249 -0
bootstack/widgets/statusbar.py +189 -0
bootstack/widgets/tabs.py +425 -0
bootstack/widgets/textarea.py +459 -0
bootstack/widgets/textfield.py +410 -0
bootstack/widgets/theme_toggle.py +92 -0
bootstack/widgets/timefield.py +340 -0
bootstack/widgets/toast.py +314 -0
bootstack/widgets/togglegroup.py +231 -0
bootstack/widgets/toolbar.py +347 -0
bootstack/widgets/tooltip.py +94 -0
bootstack/widgets/tree.py +648 -0
bootstack/widgets/types.py +305 -0
bootstack/widgets/window.py +307 -0
bootstack-0.1.0.dist-info/METADATA +301 -0
bootstack-0.1.0.dist-info/RECORD +471 -0
bootstack-0.1.0.dist-info/WHEEL +5 -0
bootstack-0.1.0.dist-info/entry_points.txt +2 -0
bootstack-0.1.0.dist-info/licenses/LICENSE +21 -0
bootstack-0.1.0.dist-info/licenses/NOTICE +10 -0
bootstack-0.1.0.dist-info/top_level.txt +1 -0

bootstack/style/style_builder_base.py ADDED Viewed

@@ -0,0 +1,716 @@
+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 bootstack.style.theme_provider import ThemeProvider, use_theme
+from bootstack.style.utility import best_foreground, color_to_hsl, darken_color, lighten_color, mix_colors, \
+    muted_foreground as _muted_foreground, 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 StyleBuilderBase:
+    """Shared base for TTK and Tk style builders.
+    Centralizes theme provider plumbing and color utilities so both
+    StyleBuilder (TTK) and StyleBuilderTk (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 -----
+    @staticmethod
+    def default(value: Optional[str] = None):
+        if value == 'default':
+            return None
+        return value
+    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+(?:\.\d+)?', part):
+                    # Fractional steps allowed (e.g. "+0.85") for fine surface
+                    # tints; elevate() blends continuously, so floats are exact.
+                    rel = float(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, success, warning, danger, "
+                    f"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, success, warning, danger, "
+                    f"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."""
+        if token and token.startswith('#'):
+            base_color = token
+        else:
+            parsed = self._parse_color_token(token)
+            if parsed:
+                base_key = parsed["head"]
+                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)
+            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":
+            # Prefer the precomputed per-semantic emphasis token (a readable,
+            # accent-tinted text color), else darken/lighten the base.
+            emphasis = self.colors.get(f"{token}_emphasis") if isinstance(token, str) else None
+            if emphasis:
+                return emphasis
+            if self.provider.mode == "light":
+                return darken_color(base_color, 0.25)
+            else:
+                return lighten_color(base_color, 0.25)
+        else:  # background
+            # Blend the accent into the surface — surface-relative, so the wash
+            # reads in BOTH modes (a pure shade like [900] is surface-blind and
+            # lands darker than a dark surface, making the selection recede). Use
+            # the mode's accent stop: [500] (the bright anchor) on light, [400]
+            # (the dark-optimized, brighter accent) on dark so low-luminance hues
+            # like blue still lift off the dark surface. A gentler blend on light
+            # (the surface is bright, so a little tint reads); a touch more on
+            # dark where the wash must lift to register.
+            if self.provider.mode == "light":
+                stop, fraction = "500", 0.14
+            else:
+                stop, fraction = "400", 0.20
+            anchor = self.colors.get(f"{token}[{stop}]") if isinstance(token, str) else None
+            blend_into = anchor if anchor else base_color
+            return mix_colors(blend_into, surface_val, fraction)
+    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
+            # Never force white when white is actually unreadable. A bright but
+            # mid-luminance accent like cyan (info) or yellow (warning) has far
+            # higher contrast with black than white, so it must take dark text —
+            # the luminance buckets alone would wrongly pick white. Gate the
+            # light-text bias on white clearing a real WCAG threshold.
+            #
+            # Use the large-text / UI threshold (3.0), not the normal-text 4.5:
+            # accent text is button/pill/badge labels (bold, >=14pt), so 3.0 is the
+            # correct WCAG bar. 4.5 was too strict and sent saturated mid-tone
+            # accents (e.g. dracula-light's purple primary, white ~3.7) to black,
+            # making them inconsistent with the same accent in dark mode (white).
+            contrast_white = 1.05 / (lum + 0.05)  # ratio of #ffffff vs the color
+            white_ok = contrast_white >= 3.0
+            # Saturated / dark-ish accents prefer white text — but only when it
+            # is legible; otherwise fall through to a contrast-chosen dark color.
+            if (accent_force_light or lum <= 0.55) and white_ok:
+                candidates = ["#ffffff"]
+            # Mid-light colors (e.g., warning, info): let contrast choose, with a
+            # bias toward the theme foreground.
+            elif lum <= 0.80:
+                candidates = [foreground, "#000000", "#ffffff"]
+            # 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)
+        chosen = best_foreground(color, unique)
+        # Safety floor (3.0 = the large/bold WCAG bar that accent labels meet).
+        # An accent sitting near a luminance-bucket boundary can land on a biased
+        # candidate that is actually unreadable (e.g. a light amber `warning` just
+        # under the dark-mode 0.45 cutoff takes white at ~2:1). If the biased pick
+        # misses the bar, fall back to the higher-contrast of pure black/white.
+        def _ratio(fg: str) -> float:
+            try:
+                lf = relative_luminance(fg)
+            except Exception:
+                return 0.0
+            hi, lo = max(lf, lum), min(lf, lum)
+            return (hi + 0.05) / (lo + 0.05)
+        if _ratio(chosen) < 3.0:
+            chosen = "#000000" if _ratio("#000000") >= _ratio("#ffffff") else "#ffffff"
+        return chosen
+    def muted_foreground(self, background: str, min_contrast: float = 4.5) -> str:
+        """Return a muted foreground color with adequate contrast against background."""
+        return _muted_foreground(background, min_contrast)
+    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 _resolve_icon_color(self, color: Any) -> str | None:
+        """Resolve an icon-spec color, turning a theme token into a hex value.
+        A hex value passes through; a theme token (such as `'primary'`) is
+        resolved against the active theme; any other string (e.g. a named color
+        like `'white'`) is left for the renderer to interpret.
+        """
+        if not color:
+            return None
+        try:
+            return self.color(color)
+        except Exception:
+            return color
+    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 = self._resolve_icon_color(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'] = self._resolve_icon_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
+            from bootstack._core.images import _ImageService
+            img = _ImageService.get_icon(name, size, color or "black")
+            cache[key] = img
+            return img
+        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