pycascadeui 3.1.0__tar.gz → 3.3.0__tar.gz

{pycascadeui-3.1.0 → pycascadeui-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycascadeui
-Version: 3.1.0
+Version: 3.3.0
 Summary: Redux-inspired UI framework for discord.py
 Author-email: HollowTheSilver <hollow@users.noreply.github.com>
 License-Expression: MIT
@@ -30,14 +30,15 @@ Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
 Requires-Dist: black>=26.3; extra == "dev"
 Requires-Dist: isort>=8.0; extra == "dev"
+Requires-Dist: testcontainers[postgres]>=4.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: mkdocs>=1.5; extra == "docs"
 Requires-Dist: mkdocs-material>=9.0; extra == "docs"
 Requires-Dist: pymdown-extensions>=10.0; extra == "docs"
 Provides-Extra: sqlite
 Requires-Dist: aiosqlite>=0.19; extra == "sqlite"
-Provides-Extra: redis
-Requires-Dist: redis>=5.0; extra == "redis"
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.30; extra == "postgres"
 Dynamic: license-file
 
 <p align="center">
@@ -151,7 +152,8 @@ pip install pycascadeui
 Optional dependencies:
 
 ```bash
-pip install pycascadeui[sqlite]
+pip install pycascadeui[sqlite]      # single-process persistence
+pip install pycascadeui[postgres]    # multi-process persistence with LISTEN/NOTIFY
 ```
 
 Requirements:
@@ -226,22 +228,25 @@ class NotificationPanel(StatefulLayoutView):
 > Define `build_ui()` once. The library calls it on every relevant state change and ships the edit for you. No `on_state_changed()` override, no manual `refresh()`, no `message.edit()` plumbing.
 
 ```python
-class SettingsHub(StatefulLayoutView):
+class MyFleetView(StatefulLayoutView):
     state_scope = "user"
-    subscribed_actions = {"SETTINGS_UPDATED"}
+    subscribed_actions = {"FLEET_REROLLED"}
 
     def build_ui(self):
         self.clear_items()
-        settings = self.user_scoped_state()
-        self.add_item(card(
-            "## Settings",
-            key_value({
-                "Theme": settings.get("theme", "default").title(),
-                "Notifications": "On" if settings.get("notify") else "Off",
-            }),
+        grid = emoji_grid(10, 10, fill="\U0001f7e6", row_labels="alpha", col_labels="numeric")
+        for row, col in self.ship_cells():
+            grid[row, col] = "\U0001f6a2"
+
+        self.add_item(card("## My Fleet", divider(), grid, color=discord.Color.blue()))
+        self.add_item(ActionRow(
+            StatefulButton(label="Regenerate", emoji="\U0001f3b2", callback=self._reroll),
         ))
 
-# build_ui() is called automatically on state changes --
+    async def _reroll(self, interaction):
+        await self.dispatch("FLEET_REROLLED", {"cells": random_placement()})
+
+# build_ui() runs automatically on every FLEET_REROLLED dispatch --
 # no manual refresh() or on_state_changed() override needed.
 ```
 
@@ -300,18 +305,14 @@ class BattleshipView(StatefulLayoutView):
 
 ### Lifecycle Control
 
-> Control active sessions per user, guild, or globally with automatic cleanup, replacement policies, and view-capacity caps.
+> Cap active sessions per user, guild, or globally. Pick how a collision resolves and how the old view cleans up when a new one opens.
 
 ```python
-class DashboardView(TabLayoutView):
+class SettingsHubView(MenuLayoutView):
     instance_limit = 1               # Only one open at a time
     instance_scope = "user_guild"    # Per user per guild
     instance_policy = "replace"      # Exit the old one, open the new one
-
-
-class GameView(StatefulLayoutView):
-    participant_limit = 8           # Owner + 7 joiners maximum
-    auto_register_participants = True  # Claim slots from allowed_users on send()
+    exit_policy = "disable"          # Old view's buttons grey out, message stays
 ```
 
 ![V2 Instance Limiting](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-session-limiting.gif)
@@ -332,12 +333,18 @@ async def setup_hook(self):
     )
 ```
 
-Declare `persistent_slots` on any view that should carry application state to disk. The rest stays volatile:
+Subclass `PersistentRolesLayoutView` and declare your categories. The pattern handles button rendering, cardinality enforcement, and restart re-attachment. A stable `persistence_key` is the match identity the middleware uses to find this panel after restart:
 
 ```python
-class BattleshipView(StatefulLayoutView):
-    scoped_slot = "battleship_stats"       # per-subsystem bucket
-    persistent_slots = ("battleship_stats",)  # opt this slot into persistence
+class GuildRoles(PersistentRolesLayoutView):
+    categories = [
+        RoleCategory(name="Color Roles", exclusive=True, roles={"Red": 123, "Blue": 456}),
+        RoleCategory(name="Pronouns", required=True, roles={"He/Him": 789, "She/Her": 12}),
+    ]
+
+# Same key in, same panel out -- across bot restarts.
+panel = GuildRoles(context=ctx, persistence_key=f"roles:{ctx.guild.id}")
+await panel.send()
 ```
 
 ![Persistence](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-persistence-restart.gif)
@@ -349,8 +356,9 @@ class BattleshipView(StatefulLayoutView):
 > Snapshot-based state history per session with built-in undo and redo support.
 
 ```python
-class SettingsHub(StatefulLayoutView):
+class NotificationsView(StatefulLayoutView):
     enable_undo = True   # Every dispatch captures a snapshot
+    undo_limit = 10      # Stack depth cap (self.undo_depth / self.redo_depth read live)
 
     async def _undo(self, interaction):
         await self.undo()   # Restore previous snapshot
@@ -490,7 +498,13 @@ await view.send()
 # Persistent variant -- admin-posted panel that survives bot restarts
 # and re-fetches live data on every restore.
 class PersistentBoard(PersistentLeaderboardLayoutView):
-    persistence_key = "battleship-leaderboard-main"
+    pass
+
+panel = PersistentBoard(
+    context=ctx,
+    persistence_key="battleship-leaderboard-main",
+)
+await panel.send()
 ```
 
 ![Leaderboards](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-leaderboard.gif)
@@ -602,8 +616,6 @@ for row in rows:
     view.add_item(row)
 ```
 
-![Button Grid](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-button-grid.PNG)
-
 <div align="center">
   <img src="https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-emoji-grid.PNG" width="30%" alt="Emoji Grid" style="border-radius: 8px; margin: 5px;" />
   <img src="https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-button-grid.PNG" width="30%" alt="Button Grid" style="border-radius: 8px; margin: 5px;" />
@@ -630,7 +642,7 @@ for row in rows:
 ### Views
 - V2 layout-based system for structured, container-driven interfaces
 - Full support for traditional discord.py Views (V1)
-- Pre-built patterns: menus, tabs, wizards, forms, pagination, leaderboards
+- Pre-built patterns: menus, tabs, wizards, forms, pagination, leaderboards, roles
 - `PaginatedView.from_cursor()` for lazy cursor-driven pagination with LRU page cache
 - `DisplayLayoutView` for one-shot V2 sends from a pre-built container
 - Automatic state-driven rebuilds: define `build_ui()`, the library handles the edit (≈ React `render()`)
@@ -639,7 +651,7 @@ for row in rows:
 ### Components
 - Stateful buttons, selects, and modals with state integration
 - Select callbacks can opt into a `values` second parameter
-- V2 builders: `card()`, `stats_card()`, `action_section()`, `toggle_section()`, `image_section()`, `link_section()`, `confirm_section()`, `button_row()`, `cycle_button()`, `toggle_button()`, `tab_nav()`, `key_value()`, `alert()`, `progress_bar()`, `divider()`, `gap()`, `gallery()`
+- V2 builders: `card()`, `stats_card()`, `action_section()`, `toggle_section()`, `image_section()`, `link_section()`, `confirm_section()`, `button_row()`, `cycle_button()`, `toggle_button()`, `tab_nav()`, `key_value()`, `alert()`, `progress_bar()`, `divider()`, `gap()`, `gallery()`, `file_attachment()`
 - Grid helpers: `emoji_grid()` and `button_grid()`
 - Typed modal fields (`text`, `integer`, `float`, `date`) with per-field validation
 - Declarative `FormSchema` and `WizardSchema` base classes
@@ -666,7 +678,8 @@ for row in rows:
 ### Persistence
 - Persistent views that survive bot restarts with automatic message re-attachment
 - Opt-in per slot via `persistent_slots = (...)` (≈ `redux-persist`)
-- Built-in SQLite and in-memory backends; custom backends via capability-flag `Protocol`
+- Built-in SQLite, PostgreSQL, and in-memory backends; custom backends via capability-flag `Protocol`
+- Cross-process scoped invalidation through PostgreSQL `LISTEN`/`NOTIFY` (multi-worker bots)
 - Named scoped buckets via `scoped_slot` for per-subsystem persistence
 - Two-namespace model (`registry` and `application`) with per-namespace debounce and retry backoff
 - Undo and redo via snapshot-based state history (opt in with `enable_undo`)
@@ -677,20 +690,6 @@ for row in rows:
 
 ---
 
-## V1 Components
-
-> CascadeUI supports traditional discord.py Views and embeds.
-
-Use V1 when you need:
-- Embed-specific features such as fields or timestamps
-- Simpler layouts without containers
-
-All core features such as navigation, persistence, and undo/redo are supported.
-
-![Ticket System](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v1-ticket-system.gif)
-
----
-
 ## Examples
 
 > The <a href="https://hollowthesilver.github.io/CascadeUI/examples/"><strong>documentation</strong></a> includes full implementations demonstrating practical usage:
@@ -703,6 +702,22 @@ All core features such as navigation, persistence, and undo/redo are supported.
 - Multi-user games with shared state, hidden information, and challenge flows (TicTacToe, Battleship)
 - Open-join lobbies with capacity caps and host-vs-participant authority (Werewolf-style)
 
+![Examples](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-hero.gif)
+
+---
+
+## V1 Components
+
+> CascadeUI supports traditional discord.py Views and embeds.
+
+Use V1 when you need:
+- Embed-specific features such as fields or timestamps
+- Simpler layouts without containers
+
+All core features such as navigation, persistence, and undo/redo are supported.
+
+![Ticket System](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v1-ticket-system.gif)
+
 ---
 
 ## Documentation
@@ -734,7 +749,7 @@ isort cascadeui/
 
 ## Developer's Note
 
-> I built CascadeUI with over **ten years** of Python, and roughly fifteen years of developement experience. All documentation, docstrings and test modules are written and designed using custom **Anthropic Opus** sub-agents. I do not attempt to conceal this fact. I'm a proponent of efficient and responsible agent application in software design. That experience is what makes these tools effective. They're amplifiers, not substitutes.
+> I built CascadeUI with over **ten years** of Python, and roughly fifteen years of development experience. All documentation, docstrings and test modules are written and designed using custom **Anthropic Opus** sub-agents. I do not attempt to conceal this fact. I'm a proponent of efficient and responsible agent application in software design. That experience is what makes these tools effective. They're amplifiers, not substitutes.
 >
 > *-- Hollow*
 

{pycascadeui-3.1.0 → pycascadeui-3.3.0}/README.md

@@ -109,7 +109,8 @@ pip install pycascadeui
 Optional dependencies:
 
 ```bash
-pip install pycascadeui[sqlite]
+pip install pycascadeui[sqlite]      # single-process persistence
+pip install pycascadeui[postgres]    # multi-process persistence with LISTEN/NOTIFY
 ```
 
 Requirements:
@@ -184,22 +185,25 @@ class NotificationPanel(StatefulLayoutView):
 > Define `build_ui()` once. The library calls it on every relevant state change and ships the edit for you. No `on_state_changed()` override, no manual `refresh()`, no `message.edit()` plumbing.
 
 ```python
-class SettingsHub(StatefulLayoutView):
+class MyFleetView(StatefulLayoutView):
     state_scope = "user"
-    subscribed_actions = {"SETTINGS_UPDATED"}
+    subscribed_actions = {"FLEET_REROLLED"}
 
     def build_ui(self):
         self.clear_items()
-        settings = self.user_scoped_state()
-        self.add_item(card(
-            "## Settings",
-            key_value({
-                "Theme": settings.get("theme", "default").title(),
-                "Notifications": "On" if settings.get("notify") else "Off",
-            }),
+        grid = emoji_grid(10, 10, fill="\U0001f7e6", row_labels="alpha", col_labels="numeric")
+        for row, col in self.ship_cells():
+            grid[row, col] = "\U0001f6a2"
+
+        self.add_item(card("## My Fleet", divider(), grid, color=discord.Color.blue()))
+        self.add_item(ActionRow(
+            StatefulButton(label="Regenerate", emoji="\U0001f3b2", callback=self._reroll),
         ))
 
-# build_ui() is called automatically on state changes --
+    async def _reroll(self, interaction):
+        await self.dispatch("FLEET_REROLLED", {"cells": random_placement()})
+
+# build_ui() runs automatically on every FLEET_REROLLED dispatch --
 # no manual refresh() or on_state_changed() override needed.
 ```
 
@@ -258,18 +262,14 @@ class BattleshipView(StatefulLayoutView):
 
 ### Lifecycle Control
 
-> Control active sessions per user, guild, or globally with automatic cleanup, replacement policies, and view-capacity caps.
+> Cap active sessions per user, guild, or globally. Pick how a collision resolves and how the old view cleans up when a new one opens.
 
 ```python
-class DashboardView(TabLayoutView):
+class SettingsHubView(MenuLayoutView):
     instance_limit = 1               # Only one open at a time
     instance_scope = "user_guild"    # Per user per guild
     instance_policy = "replace"      # Exit the old one, open the new one
-
-
-class GameView(StatefulLayoutView):
-    participant_limit = 8           # Owner + 7 joiners maximum
-    auto_register_participants = True  # Claim slots from allowed_users on send()
+    exit_policy = "disable"          # Old view's buttons grey out, message stays
 ```
 
 ![V2 Instance Limiting](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-session-limiting.gif)
@@ -290,12 +290,18 @@ async def setup_hook(self):
     )
 ```
 
-Declare `persistent_slots` on any view that should carry application state to disk. The rest stays volatile:
+Subclass `PersistentRolesLayoutView` and declare your categories. The pattern handles button rendering, cardinality enforcement, and restart re-attachment. A stable `persistence_key` is the match identity the middleware uses to find this panel after restart:
 
 ```python
-class BattleshipView(StatefulLayoutView):
-    scoped_slot = "battleship_stats"       # per-subsystem bucket
-    persistent_slots = ("battleship_stats",)  # opt this slot into persistence
+class GuildRoles(PersistentRolesLayoutView):
+    categories = [
+        RoleCategory(name="Color Roles", exclusive=True, roles={"Red": 123, "Blue": 456}),
+        RoleCategory(name="Pronouns", required=True, roles={"He/Him": 789, "She/Her": 12}),
+    ]
+
+# Same key in, same panel out -- across bot restarts.
+panel = GuildRoles(context=ctx, persistence_key=f"roles:{ctx.guild.id}")
+await panel.send()
 ```
 
 ![Persistence](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-persistence-restart.gif)
@@ -307,8 +313,9 @@ class BattleshipView(StatefulLayoutView):
 > Snapshot-based state history per session with built-in undo and redo support.
 
 ```python
-class SettingsHub(StatefulLayoutView):
+class NotificationsView(StatefulLayoutView):
     enable_undo = True   # Every dispatch captures a snapshot
+    undo_limit = 10      # Stack depth cap (self.undo_depth / self.redo_depth read live)
 
     async def _undo(self, interaction):
         await self.undo()   # Restore previous snapshot
@@ -448,7 +455,13 @@ await view.send()
 # Persistent variant -- admin-posted panel that survives bot restarts
 # and re-fetches live data on every restore.
 class PersistentBoard(PersistentLeaderboardLayoutView):
-    persistence_key = "battleship-leaderboard-main"
+    pass
+
+panel = PersistentBoard(
+    context=ctx,
+    persistence_key="battleship-leaderboard-main",
+)
+await panel.send()
 ```
 
 ![Leaderboards](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-leaderboard.gif)
@@ -560,8 +573,6 @@ for row in rows:
     view.add_item(row)
 ```
 
-![Button Grid](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-button-grid.PNG)
-
 <div align="center">
   <img src="https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-emoji-grid.PNG" width="30%" alt="Emoji Grid" style="border-radius: 8px; margin: 5px;" />
   <img src="https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/pngs/v2-button-grid.PNG" width="30%" alt="Button Grid" style="border-radius: 8px; margin: 5px;" />
@@ -588,7 +599,7 @@ for row in rows:
 ### Views
 - V2 layout-based system for structured, container-driven interfaces
 - Full support for traditional discord.py Views (V1)
-- Pre-built patterns: menus, tabs, wizards, forms, pagination, leaderboards
+- Pre-built patterns: menus, tabs, wizards, forms, pagination, leaderboards, roles
 - `PaginatedView.from_cursor()` for lazy cursor-driven pagination with LRU page cache
 - `DisplayLayoutView` for one-shot V2 sends from a pre-built container
 - Automatic state-driven rebuilds: define `build_ui()`, the library handles the edit (≈ React `render()`)
@@ -597,7 +608,7 @@ for row in rows:
 ### Components
 - Stateful buttons, selects, and modals with state integration
 - Select callbacks can opt into a `values` second parameter
-- V2 builders: `card()`, `stats_card()`, `action_section()`, `toggle_section()`, `image_section()`, `link_section()`, `confirm_section()`, `button_row()`, `cycle_button()`, `toggle_button()`, `tab_nav()`, `key_value()`, `alert()`, `progress_bar()`, `divider()`, `gap()`, `gallery()`
+- V2 builders: `card()`, `stats_card()`, `action_section()`, `toggle_section()`, `image_section()`, `link_section()`, `confirm_section()`, `button_row()`, `cycle_button()`, `toggle_button()`, `tab_nav()`, `key_value()`, `alert()`, `progress_bar()`, `divider()`, `gap()`, `gallery()`, `file_attachment()`
 - Grid helpers: `emoji_grid()` and `button_grid()`
 - Typed modal fields (`text`, `integer`, `float`, `date`) with per-field validation
 - Declarative `FormSchema` and `WizardSchema` base classes
@@ -624,7 +635,8 @@ for row in rows:
 ### Persistence
 - Persistent views that survive bot restarts with automatic message re-attachment
 - Opt-in per slot via `persistent_slots = (...)` (≈ `redux-persist`)
-- Built-in SQLite and in-memory backends; custom backends via capability-flag `Protocol`
+- Built-in SQLite, PostgreSQL, and in-memory backends; custom backends via capability-flag `Protocol`
+- Cross-process scoped invalidation through PostgreSQL `LISTEN`/`NOTIFY` (multi-worker bots)
 - Named scoped buckets via `scoped_slot` for per-subsystem persistence
 - Two-namespace model (`registry` and `application`) with per-namespace debounce and retry backoff
 - Undo and redo via snapshot-based state history (opt in with `enable_undo`)
@@ -635,20 +647,6 @@ for row in rows:
 
 ---
 
-## V1 Components
-
-> CascadeUI supports traditional discord.py Views and embeds.
-
-Use V1 when you need:
-- Embed-specific features such as fields or timestamps
-- Simpler layouts without containers
-
-All core features such as navigation, persistence, and undo/redo are supported.
-
-![Ticket System](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v1-ticket-system.gif)
-
----
-
 ## Examples
 
 > The <a href="https://hollowthesilver.github.io/CascadeUI/examples/"><strong>documentation</strong></a> includes full implementations demonstrating practical usage:
@@ -661,6 +659,22 @@ All core features such as navigation, persistence, and undo/redo are supported.
 - Multi-user games with shared state, hidden information, and challenge flows (TicTacToe, Battleship)
 - Open-join lobbies with capacity caps and host-vs-participant authority (Werewolf-style)
 
+![Examples](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v2-hero.gif)
+
+---
+
+## V1 Components
+
+> CascadeUI supports traditional discord.py Views and embeds.
+
+Use V1 when you need:
+- Embed-specific features such as fields or timestamps
+- Simpler layouts without containers
+
+All core features such as navigation, persistence, and undo/redo are supported.
+
+![Ticket System](https://raw.githubusercontent.com/HollowTheSilver/CascadeUI/main/assets/gifs/v1-ticket-system.gif)
+
 ---
 
 ## Documentation
@@ -692,7 +706,7 @@ isort cascadeui/
 
 ## Developer's Note
 
-> I built CascadeUI with over **ten years** of Python, and roughly fifteen years of developement experience. All documentation, docstrings and test modules are written and designed using custom **Anthropic Opus** sub-agents. I do not attempt to conceal this fact. I'm a proponent of efficient and responsible agent application in software design. That experience is what makes these tools effective. They're amplifiers, not substitutes.
+> I built CascadeUI with over **ten years** of Python, and roughly fifteen years of development experience. All documentation, docstrings and test modules are written and designed using custom **Anthropic Opus** sub-agents. I do not attempt to conceal this fact. I'm a proponent of efficient and responsible agent application in software design. That experience is what makes these tools effective. They're amplifiers, not substitutes.
 >
 > *-- Hollow*
 

{pycascadeui-3.1.0 → pycascadeui-3.3.0}/cascadeui/__init__.py

@@ -11,7 +11,7 @@ import logging as _logging
 
 _logging.getLogger(__name__).addHandler(_logging.NullHandler())
 
-from .components.base import StatefulButton, StatefulSelect
+from .components.base import DynamicPersistentButton, StatefulButton, StatefulSelect
 from .components.inputs import Checkbox, CheckboxGroup, FileUpload, Modal, RadioGroup, TextInput
 from .components.patterns import (
     ConfirmationButtons,
@@ -28,6 +28,7 @@ from .components.patterns import (
     cycle_button,
     divider,
     emoji_grid,
+    file_attachment,
     gallery,
     gap,
     image_section,
@@ -39,6 +40,7 @@ from .components.patterns import (
     toggle_button,
     toggle_section,
 )
+from .components.types import EmojiInput, MediaInput
 from .components.v1_composition import CompositeComponent, get_component, register_component
 from .components.wrappers import with_confirmation, with_cooldown, with_loading_state
 from .devtools import DevToolsCog, InspectorView
@@ -81,8 +83,9 @@ from .theming.core import Theme, get_default_theme, get_theme, register_theme, s
 from .theming.themes import dark_theme, default_theme, light_theme
 from .utils.decorators import cascade_component, cascade_reducer
 from .utils.errors import safe_execute, with_error_boundary, with_retry
-from .utils.helpers import slugify
+from .utils.fetch import fetch_as_file
 from .utils.logging import setup_logging
+from .utils.strings import slugify
 from .utils.tasks import get_task_manager
 from .validation import (
     ValidationResult,
@@ -105,12 +108,20 @@ from .views.patterns import (
     PaginatedLayoutView,
     PaginatedView,
     PersistentLeaderboardLayoutView,
+    PersistentRolesLayoutView,
+    RolesLayoutView,
     TabLayoutView,
     TabView,
     WizardLayoutView,
     WizardView,
 )
-from .views.patterns.types import FormField, FormSchema, WizardSchema, WizardStep
+from .views.patterns.types import (
+    FormField,
+    FormSchema,
+    RoleCategory,
+    WizardSchema,
+    WizardStep,
+)
 from .views.persistent import PersistentLayoutView, PersistentView
 from .views.view import StatefulView
 
@@ -121,7 +132,7 @@ if "SQLiteBackend" in _persistence_all:
 # // ========================================( Script )======================================== // #
 
 
-__version__ = "3.1.0"
+__version__ = "3.3.0"
 
 # Export public API
 __all__ = [
@@ -160,11 +171,14 @@ __all__ = [
     "MenuLayoutView",
     "PaginatedLayoutView",
     "PersistentLeaderboardLayoutView",
+    "PersistentRolesLayoutView",
+    "RolesLayoutView",
     "TabLayoutView",
     "WizardLayoutView",
     # Components
     "StatefulButton",
     "StatefulSelect",
+    "DynamicPersistentButton",
     "CompositeComponent",
     "ConfirmationButtons",
     "PaginationControls",
@@ -183,6 +197,9 @@ __all__ = [
     "with_loading_state",
     "with_confirmation",
     "with_cooldown",
+    # Type aliases
+    "EmojiInput",
+    "MediaInput",
     # V2 Cards & Sections
     "card",
     "action_section",
@@ -206,6 +223,7 @@ __all__ = [
     "tab_nav",
     # V2 Media
     "gallery",
+    "file_attachment",
     # V2 Grids
     "EmojiGrid",
     "emoji_grid",
@@ -228,6 +246,7 @@ __all__ = [
     # Typed schemas
     "FormField",
     "FormSchema",
+    "RoleCategory",
     "WizardStep",
     "WizardSchema",
     # Validation
@@ -262,6 +281,7 @@ __all__ = [
     "cascade_reducer",
     "cascade_component",
     "slugify",
+    "fetch_as_file",
     # DevTools
     "InspectorView",
     "DevToolsCog",

{pycascadeui-3.1.0 → pycascadeui-3.3.0}/cascadeui/components/__init__.py

@@ -23,6 +23,7 @@ from .patterns import (
     confirm_section,
     cycle_button,
     divider,
+    file_attachment,
     gallery,
     gap,
     image_section,
@@ -35,6 +36,7 @@ from .patterns import (
     toggle_section,
 )
 from .selects import ChannelSelect, Dropdown, MentionableSelect, RoleSelect, UserSelect
+from .types import EmojiInput, MediaInput
 from .v1_composition import CompositeComponent, get_component, register_component
 from .wrappers import with_confirmation, with_cooldown, with_loading_state
 
@@ -101,4 +103,8 @@ __all__ = [
     "tab_nav",
     # V2 media
     "gallery",
+    "file_attachment",
+    # Type aliases
+    "EmojiInput",
+    "MediaInput",
 ]