CharmPkk 0.4.0__tar.gz

charmpkk-0.4.0/CharmPkk.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: CharmPkk
+Version: 0.4.0
+Summary: Красивые, плавные и настраиваемые интерфейсы для Python: консоль (TUI) и оконные приложения (GUI) с акрилом, стеклом, частицами и эффектами.
+Author-email: Your Name <you@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourname/charmpkk
+Project-URL: Source, https://github.com/yourname/charmpkk
+Project-URL: Issues, https://github.com/yourname/charmpkk/issues
+Project-URL: Changelog, https://github.com/yourname/charmpkk/blob/main/CHANGELOG.md
+Keywords: ui,console,terminal,tui,tkinter,gui,acrylic,mica,glass,particles,animation,charmpkk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+CharmPkk — библиотека для создания красивых, плавных и кастомизируемых интерфейсов на чистом Python. Работает в двух режимах: в терминале (TUI — где кастомизации максимум) и в окне (GUI на базе tkinter, без внешних зависимостей). Всё построено вокруг идей «мягкого стекла», живых частиц и плавных анимаций.
+
+Возможности
+Консоль (TUI)
+
+Цвета и стили: ANSI/truecolor, 256-цветов, hex-цвета, градиенты, радуга, Style-контекст, готовые Palette-темы (dark, light, nord, dracula, gruvbox, tokyo_night, catppuccin, monokai).
+
+Текст и рамки: выравнивание, обрезка, обёртка; 8 стилей рамок (single, double, round, heavy, dashed, dotted, ascii, shadow, none), панели, баннеры, big_text для больших ASCII-заголовков.
+
+Виджеты: ProgressBar, FancyProgressBar (block/line/dots/star/arrow/square/shade/braille/heart), AnimatedProgressBar (плавно «догоняет» значение), MultiProgress, TaskList (как в CI), Spinner (9 пресетов кадров), Table (zebra, per-column alignment), списки, key_value, badge, statusline, tree.
+
+Графики: sparkline, bar_chart, gauge, histogram, heatmap.
+
+Интерактив: select, multiselect, tabs (стрелки + hotkeys), Form/Field с валидацией, Wizard/Step — пошаговые мастера.
+
+Уведомления и диалоги: info/success/warning/error, Log, ask, ask_password, ask_number, ask_choice, confirm.
+
+Markdown: render_markdown / print_md — заголовки, списки, цитаты, код, ссылки, inline-стили.
+
+Анимации: 17 easing-функций, tween, Transition, Live (перерисовка блока на месте), эффекты fade_in, wave, shimmer, glitch, marquee, neon, typewriter с курсором.
+
+Частицы (реальное время в терминале): Rain, Snow, Stars, Dust, Matrix, Bubbles, Fireflies + play()/play_preset() на N секунд на весь экран.
+
+Терминал: скрытие/показ курсора, позиционирование, save/restore, alt_screen, смена заголовка окна, bell, flash, OSC 8 гиперссылки, OSC 52 clipboard, определение truecolor/256.
+
+Окно (GUI, tkinter)
+
+Темы: 10 встроенных (dark, light, nord, gruvbox, dracula, tokyo_night, catppuccin, solarized_dark/light, monokai) + ThemeManager + свои Theme.
+
+Виджеты: StyledButton (7 вариантов × 3 размера), IconButton, StyledEntry (фокус-бордер, prefix/suffix, placeholder, password), TextArea, Toggle, Checkbox, RadioGroup, Slider, Combobox, SegmentedControl, Card, Badge, Divider, Tabs, Tooltip, Toast, Spinner, ProgressBar, TableView (сортировка, зебра, скролл, выбор строки).
+
+Диалоги: MessageDialog, ConfirmDialog, InputDialog + модальный Frost (морозный слой поверх окна).
+
+Композиция приложения: App с шапкой, действиями, сайдбаром, статус-баром, хелперами toast/message/confirm/input; Router/Screen — SPA-подобная навигация по одному окну; CommandPalette (Ctrl+K); ToastManager (очередь тостов в углу); Shortcuts (реестр горячих клавиш + окно-справка).
+
+Frameless-окно: FramelessWindow + CustomTitleBar — перетаскивание, минимизация, максимизация, кнопка закрытия, ресайз по краям.
+
+Стекло и акрил: apply_acrylic_win11 (Mica/Acrylic/Tabbed через DWMWA_SYSTEMBACKDROP_TYPE), apply_acrylic_win10 (SetWindowCompositionAttribute), make_glass_app(app) — универсальный one-call; GlassCard (градиент + светящаяся рамка + hover-glow), GlassPanel (слои-подложки), Frost (модальное затемнение).
+
+Анимации: Animator (tween/pulse/sequence/color), animate, sequence, fade_in, fade_out, slide_in, fade_in_after, fade_out_destroy.
+
+Эффекты: ripple (клик-волна на Canvas), Shimmer (скользящий блик), pulse, GradientFrame (вертикальный/горизонтальный градиент), NeonBorder, GlowText («дышащий» текст).
+
+Частицы: ParticleCanvas с режимами rain, snow, stars, dust, bubbles, fireflies, matrix, custom (свой emitter), spawn_burst(x, y) (вспышки-салюты), attach_background(parent, ...) для фона под UI.
+
+Философия
+Никаких тяжёлых зависимостей — только tkinter из стандартной библиотеки. Библиотека строится по слоям: colors/text/boxes → widgets/layout/charts → effects/anim/particles → screens/router/palette. Каждый слой можно использовать отдельно или собирать из них готовые приложения: установщик, конфигуратор, дашборд, CLI-утилита — что угодно.

charmpkk-0.4.0/CharmPkk.egg-info/SOURCES.txt

@@ -0,0 +1,43 @@
+LICENSE
+README.md
+pyproject.toml
+CharmPkk.egg-info/PKG-INFO
+CharmPkk.egg-info/SOURCES.txt
+CharmPkk.egg-info/dependency_links.txt
+CharmPkk.egg-info/top_level.txt
+charmpkk/__init__.py
+charmpkk/version.py
+charmpkk/console/__init__.py
+charmpkk/console/anim.py
+charmpkk/console/banner.py
+charmpkk/console/boxes.py
+charmpkk/console/charts.py
+charmpkk/console/colors.py
+charmpkk/console/effects.py
+charmpkk/console/forms.py
+charmpkk/console/layout.py
+charmpkk/console/live.py
+charmpkk/console/markdown.py
+charmpkk/console/menu.py
+charmpkk/console/particles.py
+charmpkk/console/progress_ext.py
+charmpkk/console/terminal.py
+charmpkk/console/text.py
+charmpkk/console/themes.py
+charmpkk/console/widgets.py
+charmpkk/console/wizard.py
+charmpkk/window/__init__.py
+charmpkk/window/anim.py
+charmpkk/window/app.py
+charmpkk/window/command_palette.py
+charmpkk/window/custom_titlebar.py
+charmpkk/window/dialogs.py
+charmpkk/window/effects.py
+charmpkk/window/glass.py
+charmpkk/window/particles.py
+charmpkk/window/screens.py
+charmpkk/window/shortcuts.py
+charmpkk/window/table_view.py
+charmpkk/window/theme.py
+charmpkk/window/toast_manager.py
+charmpkk/window/widgets.py

charmpkk-0.4.0/CharmPkk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

charmpkk-0.4.0/CharmPkk.egg-info/top_level.txt

@@ -0,0 +1 @@
+charmpkk

charmpkk-0.4.0/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: CharmPkk
+Version: 0.4.0
+Summary: Красивые, плавные и настраиваемые интерфейсы для Python: консоль (TUI) и оконные приложения (GUI) с акрилом, стеклом, частицами и эффектами.
+Author-email: Your Name <you@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourname/charmpkk
+Project-URL: Source, https://github.com/yourname/charmpkk
+Project-URL: Issues, https://github.com/yourname/charmpkk/issues
+Project-URL: Changelog, https://github.com/yourname/charmpkk/blob/main/CHANGELOG.md
+Keywords: ui,console,terminal,tui,tkinter,gui,acrylic,mica,glass,particles,animation,charmpkk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+CharmPkk — библиотека для создания красивых, плавных и кастомизируемых интерфейсов на чистом Python. Работает в двух режимах: в терминале (TUI — где кастомизации максимум) и в окне (GUI на базе tkinter, без внешних зависимостей). Всё построено вокруг идей «мягкого стекла», живых частиц и плавных анимаций.
+
+Возможности
+Консоль (TUI)
+
+Цвета и стили: ANSI/truecolor, 256-цветов, hex-цвета, градиенты, радуга, Style-контекст, готовые Palette-темы (dark, light, nord, dracula, gruvbox, tokyo_night, catppuccin, monokai).
+
+Текст и рамки: выравнивание, обрезка, обёртка; 8 стилей рамок (single, double, round, heavy, dashed, dotted, ascii, shadow, none), панели, баннеры, big_text для больших ASCII-заголовков.
+
+Виджеты: ProgressBar, FancyProgressBar (block/line/dots/star/arrow/square/shade/braille/heart), AnimatedProgressBar (плавно «догоняет» значение), MultiProgress, TaskList (как в CI), Spinner (9 пресетов кадров), Table (zebra, per-column alignment), списки, key_value, badge, statusline, tree.
+
+Графики: sparkline, bar_chart, gauge, histogram, heatmap.
+
+Интерактив: select, multiselect, tabs (стрелки + hotkeys), Form/Field с валидацией, Wizard/Step — пошаговые мастера.
+
+Уведомления и диалоги: info/success/warning/error, Log, ask, ask_password, ask_number, ask_choice, confirm.
+
+Markdown: render_markdown / print_md — заголовки, списки, цитаты, код, ссылки, inline-стили.
+
+Анимации: 17 easing-функций, tween, Transition, Live (перерисовка блока на месте), эффекты fade_in, wave, shimmer, glitch, marquee, neon, typewriter с курсором.
+
+Частицы (реальное время в терминале): Rain, Snow, Stars, Dust, Matrix, Bubbles, Fireflies + play()/play_preset() на N секунд на весь экран.
+
+Терминал: скрытие/показ курсора, позиционирование, save/restore, alt_screen, смена заголовка окна, bell, flash, OSC 8 гиперссылки, OSC 52 clipboard, определение truecolor/256.
+
+Окно (GUI, tkinter)
+
+Темы: 10 встроенных (dark, light, nord, gruvbox, dracula, tokyo_night, catppuccin, solarized_dark/light, monokai) + ThemeManager + свои Theme.
+
+Виджеты: StyledButton (7 вариантов × 3 размера), IconButton, StyledEntry (фокус-бордер, prefix/suffix, placeholder, password), TextArea, Toggle, Checkbox, RadioGroup, Slider, Combobox, SegmentedControl, Card, Badge, Divider, Tabs, Tooltip, Toast, Spinner, ProgressBar, TableView (сортировка, зебра, скролл, выбор строки).
+
+Диалоги: MessageDialog, ConfirmDialog, InputDialog + модальный Frost (морозный слой поверх окна).
+
+Композиция приложения: App с шапкой, действиями, сайдбаром, статус-баром, хелперами toast/message/confirm/input; Router/Screen — SPA-подобная навигация по одному окну; CommandPalette (Ctrl+K); ToastManager (очередь тостов в углу); Shortcuts (реестр горячих клавиш + окно-справка).
+
+Frameless-окно: FramelessWindow + CustomTitleBar — перетаскивание, минимизация, максимизация, кнопка закрытия, ресайз по краям.
+
+Стекло и акрил: apply_acrylic_win11 (Mica/Acrylic/Tabbed через DWMWA_SYSTEMBACKDROP_TYPE), apply_acrylic_win10 (SetWindowCompositionAttribute), make_glass_app(app) — универсальный one-call; GlassCard (градиент + светящаяся рамка + hover-glow), GlassPanel (слои-подложки), Frost (модальное затемнение).
+
+Анимации: Animator (tween/pulse/sequence/color), animate, sequence, fade_in, fade_out, slide_in, fade_in_after, fade_out_destroy.
+
+Эффекты: ripple (клик-волна на Canvas), Shimmer (скользящий блик), pulse, GradientFrame (вертикальный/горизонтальный градиент), NeonBorder, GlowText («дышащий» текст).
+
+Частицы: ParticleCanvas с режимами rain, snow, stars, dust, bubbles, fireflies, matrix, custom (свой emitter), spawn_burst(x, y) (вспышки-салюты), attach_background(parent, ...) для фона под UI.
+
+Философия
+Никаких тяжёлых зависимостей — только tkinter из стандартной библиотеки. Библиотека строится по слоям: colors/text/boxes → widgets/layout/charts → effects/anim/particles → screens/router/palette. Каждый слой можно использовать отдельно или собирать из них готовые приложения: установщик, конфигуратор, дашборд, CLI-утилита — что угодно.

charmpkk-0.4.0/README.md

@@ -0,0 +1,47 @@
+CharmPkk — библиотека для создания красивых, плавных и кастомизируемых интерфейсов на чистом Python. Работает в двух режимах: в терминале (TUI — где кастомизации максимум) и в окне (GUI на базе tkinter, без внешних зависимостей). Всё построено вокруг идей «мягкого стекла», живых частиц и плавных анимаций.
+
+Возможности
+Консоль (TUI)
+
+Цвета и стили: ANSI/truecolor, 256-цветов, hex-цвета, градиенты, радуга, Style-контекст, готовые Palette-темы (dark, light, nord, dracula, gruvbox, tokyo_night, catppuccin, monokai).
+
+Текст и рамки: выравнивание, обрезка, обёртка; 8 стилей рамок (single, double, round, heavy, dashed, dotted, ascii, shadow, none), панели, баннеры, big_text для больших ASCII-заголовков.
+
+Виджеты: ProgressBar, FancyProgressBar (block/line/dots/star/arrow/square/shade/braille/heart), AnimatedProgressBar (плавно «догоняет» значение), MultiProgress, TaskList (как в CI), Spinner (9 пресетов кадров), Table (zebra, per-column alignment), списки, key_value, badge, statusline, tree.
+
+Графики: sparkline, bar_chart, gauge, histogram, heatmap.
+
+Интерактив: select, multiselect, tabs (стрелки + hotkeys), Form/Field с валидацией, Wizard/Step — пошаговые мастера.
+
+Уведомления и диалоги: info/success/warning/error, Log, ask, ask_password, ask_number, ask_choice, confirm.
+
+Markdown: render_markdown / print_md — заголовки, списки, цитаты, код, ссылки, inline-стили.
+
+Анимации: 17 easing-функций, tween, Transition, Live (перерисовка блока на месте), эффекты fade_in, wave, shimmer, glitch, marquee, neon, typewriter с курсором.
+
+Частицы (реальное время в терминале): Rain, Snow, Stars, Dust, Matrix, Bubbles, Fireflies + play()/play_preset() на N секунд на весь экран.
+
+Терминал: скрытие/показ курсора, позиционирование, save/restore, alt_screen, смена заголовка окна, bell, flash, OSC 8 гиперссылки, OSC 52 clipboard, определение truecolor/256.
+
+Окно (GUI, tkinter)
+
+Темы: 10 встроенных (dark, light, nord, gruvbox, dracula, tokyo_night, catppuccin, solarized_dark/light, monokai) + ThemeManager + свои Theme.
+
+Виджеты: StyledButton (7 вариантов × 3 размера), IconButton, StyledEntry (фокус-бордер, prefix/suffix, placeholder, password), TextArea, Toggle, Checkbox, RadioGroup, Slider, Combobox, SegmentedControl, Card, Badge, Divider, Tabs, Tooltip, Toast, Spinner, ProgressBar, TableView (сортировка, зебра, скролл, выбор строки).
+
+Диалоги: MessageDialog, ConfirmDialog, InputDialog + модальный Frost (морозный слой поверх окна).
+
+Композиция приложения: App с шапкой, действиями, сайдбаром, статус-баром, хелперами toast/message/confirm/input; Router/Screen — SPA-подобная навигация по одному окну; CommandPalette (Ctrl+K); ToastManager (очередь тостов в углу); Shortcuts (реестр горячих клавиш + окно-справка).
+
+Frameless-окно: FramelessWindow + CustomTitleBar — перетаскивание, минимизация, максимизация, кнопка закрытия, ресайз по краям.
+
+Стекло и акрил: apply_acrylic_win11 (Mica/Acrylic/Tabbed через DWMWA_SYSTEMBACKDROP_TYPE), apply_acrylic_win10 (SetWindowCompositionAttribute), make_glass_app(app) — универсальный one-call; GlassCard (градиент + светящаяся рамка + hover-glow), GlassPanel (слои-подложки), Frost (модальное затемнение).
+
+Анимации: Animator (tween/pulse/sequence/color), animate, sequence, fade_in, fade_out, slide_in, fade_in_after, fade_out_destroy.
+
+Эффекты: ripple (клик-волна на Canvas), Shimmer (скользящий блик), pulse, GradientFrame (вертикальный/горизонтальный градиент), NeonBorder, GlowText («дышащий» текст).
+
+Частицы: ParticleCanvas с режимами rain, snow, stars, dust, bubbles, fireflies, matrix, custom (свой emitter), spawn_burst(x, y) (вспышки-салюты), attach_background(parent, ...) для фона под UI.
+
+Философия
+Никаких тяжёлых зависимостей — только tkinter из стандартной библиотеки. Библиотека строится по слоям: colors/text/boxes → widgets/layout/charts → effects/anim/particles → screens/router/palette. Каждый слой можно использовать отдельно или собирать из них готовые приложения: установщик, конфигуратор, дашборд, CLI-утилита — что угодно.

charmpkk-0.4.0/charmpkk/__init__.py

@@ -0,0 +1,12 @@
+"""CharmPkk — красивые интерфейсы для Python: консоль и окно."""
+from .version import __version__
+from . import console
+
+__all__ = ["console", "__version__"]
+
+try:
+    from . import window  # noqa: F401
+    __all__.append("window")
+except Exception:
+    # tkinter может отсутствовать (например, headless-сервер)
+    pass

charmpkk-0.4.0/charmpkk/console/__init__.py

@@ -0,0 +1,95 @@
+from . import colors, text, boxes, layout, widgets, charts, menu
+from . import anim, particles, effects, live as _live_mod
+from . import terminal as terminal_mod
+from . import themes as console_themes
+from . import banner as banner_mod
+from . import forms as forms_mod
+from . import wizard as wizard_mod
+from . import markdown as markdown_mod
+from . import progress_ext
+from .colors import (
+    colorize, fg_rgb, bg_rgb, fg_hex, bg_hex, fg_256, bg_256,
+    gradient_text, rainbow_text, Style,
+    enable, disable, is_enabled, strip_ansi,
+    BOLD, DIM, ITALIC, UNDERLINE, BLINK, REVERSE, HIDDEN, STRIKE, RESET,
+    BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE,
+    BRIGHT_BLACK, BRIGHT_RED, BRIGHT_GREEN, BRIGHT_YELLOW,
+    BRIGHT_BLUE, BRIGHT_MAGENTA, BRIGHT_CYAN, BRIGHT_WHITE,
+)
+from .text import wrap, align, center, pad, truncate, typewriter, indent, visible_len
+from .boxes import box, rule, section, panel, banner, STYLES
+from .layout import columns, rows, grid, sidebar
+from .widgets import (
+    ProgressBar, MultiProgress, Spinner, Table,
+    bullet_list, numbered_list, key_value, badge, statusline, tree,
+    notify, info, success, warning, error, Log,
+    ask, ask_password, ask_number, confirm, ask_choice,
+)
+from .charts import sparkline, bar_chart, gauge, histogram, heatmap
+from .menu import select, multiselect, tabs
+
+from .anim import (
+    ease, tween, lerp, lerp_color, Transition, EASINGS,
+    ease_in_quad, ease_out_quad, ease_in_out_quad,
+    ease_in_cubic, ease_out_cubic, ease_in_out_cubic,
+    ease_in_quart, ease_out_quart, ease_in_out_sine,
+    ease_in_expo, ease_out_expo,
+    ease_out_back, ease_out_elastic, ease_out_bounce,
+)
+from .particles import (
+    Canvas as ParticleCanvas, ParticleSystem,
+    Rain, Snow, Stars, Dust, Matrix, Bubbles, Fireflies,
+    play as play_particles, play_preset, PRESETS as PARTICLE_PRESETS,
+)
+from .effects import (
+    typewriter as typewriter_fx, fade_in, wave, shimmer,
+    glitch, marquee, neon,
+)
+from .live import Live, animate_to
+
+from .terminal import Terminal, terminal
+from .themes import Palette, REGISTRY as THEMES, get as get_theme, list_names as list_themes
+from .banner import big as big_text
+from .forms import Form, Field
+from .wizard import Wizard, Step
+from .markdown import render as render_markdown, print_md
+from .progress_ext import FancyProgressBar, AnimatedProgressBar, TaskList
+
+__all__ = [
+    "colors", "colorize", "fg_rgb", "bg_rgb", "fg_hex", "bg_hex", "fg_256", "bg_256",
+    "gradient_text", "rainbow_text", "Style", "enable", "disable", "is_enabled",
+    "strip_ansi",
+    "BOLD", "DIM", "ITALIC", "UNDERLINE", "BLINK", "REVERSE", "HIDDEN", "STRIKE", "RESET",
+    "BLACK", "RED", "GREEN", "YELLOW", "BLUE", "MAGENTA", "CYAN", "WHITE",
+    "BRIGHT_BLACK", "BRIGHT_RED", "BRIGHT_GREEN", "BRIGHT_YELLOW",
+    "BRIGHT_BLUE", "BRIGHT_MAGENTA", "BRIGHT_CYAN", "BRIGHT_WHITE",
+    "text", "wrap", "align", "center", "pad", "truncate", "typewriter", "indent", "visible_len",
+    "boxes", "box", "rule", "section", "panel", "banner", "STYLES",
+    "layout", "columns", "rows", "grid", "sidebar",
+    "widgets", "ProgressBar", "MultiProgress", "Spinner", "Table",
+    "bullet_list", "numbered_list", "key_value", "badge", "statusline", "tree",
+    "notify", "info", "success", "warning", "error", "Log",
+    "ask", "ask_password", "ask_number", "confirm", "ask_choice",
+    "charts", "sparkline", "bar_chart", "gauge", "histogram", "heatmap",
+    "menu", "select", "multiselect", "tabs",
+    "anim", "ease", "tween", "lerp", "lerp_color", "Transition", "EASINGS",
+    "ease_in_quad", "ease_out_quad", "ease_in_out_quad",
+    "ease_in_cubic", "ease_out_cubic", "ease_in_out_cubic",
+    "ease_in_quart", "ease_out_quart", "ease_in_out_sine",
+    "ease_in_expo", "ease_out_expo",
+    "ease_out_back", "ease_out_elastic", "ease_out_bounce",
+    "particles", "ParticleCanvas", "ParticleSystem",
+    "Rain", "Snow", "Stars", "Dust", "Matrix", "Bubbles", "Fireflies",
+    "play_particles", "play_preset", "PARTICLE_PRESETS",
+    "effects", "typewriter_fx", "fade_in", "wave", "shimmer",
+    "glitch", "marquee", "neon",
+    "Live", "animate_to",
+    # 0.4.0
+    "terminal_mod", "Terminal", "terminal",
+    "console_themes", "Palette", "THEMES", "get_theme", "list_themes",
+    "banner_mod", "big_text",
+    "forms_mod", "Form", "Field",
+    "wizard_mod", "Wizard", "Step",
+    "markdown_mod", "render_markdown", "print_md",
+    "progress_ext", "FancyProgressBar", "AnimatedProgressBar", "TaskList",
+]

charmpkk-0.4.0/charmpkk/console/anim.py

@@ -0,0 +1,120 @@
+"""Easing, tween, интерполяция — для плавных консольных анимаций."""
+import math
+
+
+# ---------- easing ----------
+
+def linear(t): return t
+def ease_in_quad(t): return t * t
+def ease_out_quad(t): return 1 - (1 - t) ** 2
+def ease_in_out_quad(t): return 2 * t * t if t < 0.5 else 1 - (-2 * t + 2) ** 2 / 2
+def ease_in_cubic(t): return t ** 3
+def ease_out_cubic(t): return 1 - (1 - t) ** 3
+def ease_in_out_cubic(t): return 4 * t ** 3 if t < 0.5 else 1 - (-2 * t + 2) ** 3 / 2
+def ease_in_quart(t): return t ** 4
+def ease_out_quart(t): return 1 - (1 - t) ** 4
+def ease_in_out_sine(t): return -(math.cos(math.pi * t) - 1) / 2
+def ease_in_expo(t): return 0 if t == 0 else 2 ** (10 * t - 10)
+def ease_out_expo(t): return 1 if t == 1 else 1 - 2 ** (-10 * t)
+
+
+def ease_out_back(t):
+    c1, c3 = 1.70158, 2.70158
+    return 1 + c3 * (t - 1) ** 3 + c1 * (t - 1) ** 2
+
+
+def ease_out_elastic(t):
+    if t in (0.0, 1.0):
+        return t
+    c4 = (2 * math.pi) / 3
+    return 2 ** (-10 * t) * math.sin((t * 10 - 0.75) * c4) + 1
+
+
+def ease_out_bounce(t):
+    n1, d1 = 7.5625, 2.75
+    if t < 1 / d1:
+        return n1 * t * t
+    if t < 2 / d1:
+        t -= 1.5 / d1
+        return n1 * t * t + 0.75
+    if t < 2.5 / d1:
+        t -= 2.25 / d1
+        return n1 * t * t + 0.9375
+    t -= 2.625 / d1
+    return n1 * t * t + 0.984375
+
+
+EASINGS = {
+    "linear": linear,
+    "in_quad": ease_in_quad, "out_quad": ease_out_quad, "in_out_quad": ease_in_out_quad,
+    "in_cubic": ease_in_cubic, "out_cubic": ease_out_cubic, "in_out_cubic": ease_in_out_cubic,
+    "in_quart": ease_in_quart, "out_quart": ease_out_quart,
+    "in_out_sine": ease_in_out_sine,
+    "in_expo": ease_in_expo, "out_expo": ease_out_expo,
+    "out_back": ease_out_back, "out_elastic": ease_out_elastic, "out_bounce": ease_out_bounce,
+}
+
+
+def ease(t, kind="out_cubic"):
+    return EASINGS.get(kind, ease_out_cubic)(max(0.0, min(1.0, t)))
+
+
+def tween(duration=1.0, fps=30, kind="out_cubic"):
+    """Генератор значений 0..1 (с плавным easing)."""
+    n = max(int(duration * fps), 1)
+    for i in range(n + 1):
+        yield ease(i / n, kind)
+
+
+def lerp(a, b, t):
+    return a + (b - a) * t
+
+
+def _hex_to_rgb(h):
+    h = h.lstrip("#")
+    if len(h) == 3:
+        h = "".join(c * 2 for c in h)
+    return tuple(int(h[i:i + 2], 16) for i in (0, 2, 4))
+
+
+def _rgb_to_hex(rgb):
+    return "#{:02x}{:02x}{:02x}".format(*(max(0, min(255, int(c))) for c in rgb))
+
+
+def lerp_color(c1, c2, t):
+    """c1, c2 — hex-строки, возвращает hex."""
+    a, b = _hex_to_rgb(c1), _hex_to_rgb(c2)
+    return _rgb_to_hex((a[i] + (b[i] - a[i]) * t for i in range(3)))
+
+
+class Transition:
+    """Плавно переводит число из текущего значения в целевое."""
+
+    def __init__(self, value=0.0, kind="out_cubic"):
+        self.value = value
+        self.target = value
+        self.start = value
+        self.kind = kind
+        self._t = 0.0
+        self._duration = 0.0
+
+    def to(self, target, duration=0.5, kind=None):
+        self.start = self.value
+        self.target = target
+        self._duration = max(duration, 1e-6)
+        self._t = 0.0
+        if kind:
+            self.kind = kind
+        return self
+
+    def step(self, dt):
+        if self._duration <= 0:
+            self.value = self.target
+            return self.value
+        self._t = min(self._t + dt / self._duration, 1.0)
+        self.value = lerp(self.start, self.target, ease(self._t, self.kind))
+        return self.value
+
+    @property
+    def done(self):
+        return self._t >= 1.0

charmpkk-0.4.0/charmpkk/console/banner.py

@@ -0,0 +1,80 @@
+"""Большие ASCII-заголовки (минимальный FIGlet-подобный рендер)."""
+from .colors import colorize, gradient_text
+
+# 5-строчные глифы (только заглавные + цифры + базовые знаки).
+_FONT = {
+    "A": ["  ▄▀█  ", " █▀█  ", " ▀ ▀  "],
+    "B": [" █▀▄  ", " █▀▄  ", " ▀▀   "],
+    "C": [" █▀▀  ", " █    ", " ▀▀▀  "],
+    "D": [" █▀▄  ", " █ █  ", " ▀▀   "],
+    "E": [" █▀▀  ", " █▀   ", " ▀▀▀  "],
+    "F": [" █▀▀  ", " █▀   ", " ▀    "],
+    "G": [" █▀▀  ", " █ █  ", " ▀▀▀  "],
+    "H": [" █ █  ", " █▀█  ", " ▀ ▀  "],
+    "I": [" █  ", " █  ", " ▀  "],
+    "J": ["   █  ", "   █  ", " ▀▀   "],
+    "K": [" █ █  ", " █▀▄  ", " ▀ ▀  "],
+    "L": [" █    ", " █    ", " ▀▀▀  "],
+    "M": [" █▀▄▀█  ", " █ ▀ █  ", " ▀   ▀  "],
+    "N": [" █▄ █  ", " █ ▀█  ", " ▀  ▀  "],
+    "O": [" █▀█  ", " █ █  ", " ▀▀▀  "],
+    "P": [" █▀█  ", " █▀▀  ", " ▀    "],
+    "Q": [" █▀█  ", " █ █  ", " ▀▀▀▄ "],
+    "R": [" █▀▄  ", " █▀▄  ", " ▀ ▀  "],
+    "S": [" █▀▀  ", " ▀▀█  ", " ▀▀▀  "],
+    "T": [" █▀█  ", "  █   ", "  ▀   "],
+    "U": [" █ █  ", " █ █  ", " ▀▀▀  "],
+    "V": [" █ █  ", " █ █  ", "  ▀   "],
+    "W": [" █ █ █  ", " █ █ █  ", "  ▀ ▀   "],
+    "X": [" █ █  ", "  █   ", " ▀ ▀  "],
+    "Y": [" █ █  ", "  █   ", "  ▀   "],
+    "Z": [" ▀▀█  ", " ▄▀   ", " ▀▀▀  "],
+    "0": [" █▀█  ", " █ █  ", " ▀▀▀  "],
+    "1": [" ▄█  ", "  █  ", " ▀▀▀ "],
+    "2": [" █▀█  ", " ▄▀   ", " ▀▀▀  "],
+    "3": [" ▀▀█  ", " ▀▀█  ", " ▀▀▀  "],
+    "4": [" █ █  ", " ▀▀█  ", "   ▀  "],
+    "5": [" █▀▀  ", " ▀▀▄  ", " ▀▀▀  "],
+    "6": [" █▀▀  ", " █▀▄  ", " ▀▀▀  "],
+    "7": [" ▀▀█  ", "   █  ", "   ▀  "],
+    "8": [" █▀█  ", " █▀█  ", " ▀▀▀  "],
+    "9": [" █▀█  ", " ▀▀█  ", " ▀▀▀  "],
+    " ": ["     ", "     ", "     "],
+    "!": [" █  ", " █  ", " ▀  "],
+    "?": [" █▀█  ", "  ▄▀  ", "  ▀   "],
+    ".": ["    ", "    ", " ▀  "],
+    ",": ["    ", "    ", " ▀  "],
+    "-": ["      ", " ▀▀▀  ", "      "],
+    "_": ["      ", "      ", " ▀▀▀  "],
+    ":": ["    ", " ▀  ", " ▀  "],
+}
+
+_TEMPLATES = {
+    "block": ["▄▀█", "█▀█", "▀ ▀"],   # не используется напрямую, но идея та же
+}
+
+
+def _render(text):
+    text = text.upper()
+    lines = ["", "", ""]
+    for ch in text:
+        glyph = _FONT.get(ch, _FONT["?"])
+        w = max(len(g) for g in glyph)
+        for i, g in enumerate(glyph):
+            lines[i] += g.ljust(w) + " "
+    return [l.rstrip() for l in lines]
+
+
+def big(text, fg=None, gradient=None, align="left", width=None):
+    """Крупный заголовок. Если передан gradient=(start_hex, end_hex) —
+    каждая строка окрашивается градиентом."""
+    lines = _render(text)
+    if width:
+        from .text import align as _a
+        lines = [_a(l, width, align) for l in lines]
+    if gradient:
+        return "\n".join(gradient_text(l, gradient[0], gradient[1])
+                         for l in lines)
+    if fg:
+        return "\n".join(colorize(l, fg=fg) for l in lines)
+    return "\n".join(lines)