feat: Toasts (#2111)

Co-authored-by: Carson Sievert <cpsievert1@gmail.com>

Author: gadenbuie

.gitignore

@@ -130,3 +130,4 @@ test-results.xml
 results-inspect-ai/
 test-results-inspect-ai/
 tests/inspect-ai/scripts/test_metadata.json
+/.claude/

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### New features
 
+* Added toast notification system with `ui.toast()`, `ui.toast_header()`, `ui.show_toast()`, and `ui.hide_toast()`. Toast notifications are temporary, non-intrusive messages that support multiple semantic types (success, warning, error, etc.), flexible positioning (9 positions: top/middle/bottom × left/center/right), auto-hide with configurable duration, optional headers with icons, and programmatic control. (#2111)
+
 * Added a new `input_submit_textarea()` input element, which is similar to `input_text_area()`, but includes a submit button to only submit the text changes to the server on click. This is especially useful when the input text change triggers a long-running operation and/or the user wants to type longer-form input and review it before submitting it. (#2099)
 
 ### Bug fixes

Makefile

@@ -112,6 +112,10 @@ format-isort: FORCE
 	@echo "-------- Sorting imports with isort --------"
 	isort .
 
+test-update-snapshots: FORCE ## Update test snapshots
+	@echo "-------- Updating test snapshots ----------"
+	pytest --snapshot-update
+
 docs: FORCE ## docs: build docs with quartodoc
 	@echo "-------- Building docs with quartodoc ------"
 	@cd docs && make quartodoc

docs/_quartodoc-core.yml

@@ -237,6 +237,10 @@ quartodoc:
         - ui.help_text
         - ui.notification_show
         - ui.notification_remove
+        - ui.toast
+        - ui.toast_header
+        - ui.show_toast
+        - ui.hide_toast
         - ui.modal
         - ui.modal_show
         - ui.modal_remove

docs/_quartodoc-express.yml

@@ -148,6 +148,10 @@ quartodoc:
         - express.ui.help_text
         - express.ui.notification_show
         - express.ui.notification_remove
+        - express.ui.toast
+        - express.ui.toast_header
+        - express.ui.show_toast
+        - express.ui.hide_toast
         - express.ui.modal
         - express.ui.modal_show
         - express.ui.modal_remove

docs/_quartodoc-testing.yml

@@ -20,6 +20,7 @@ quartodoc:
         - playwright.controller.Card
         - playwright.controller.Popover
         - playwright.controller.Sidebar
+        - playwright.controller.Toast
         - playwright.controller.Tooltip
     - title: UI Inputs
       desc: Methods for interacting with Shiny app input value controller.

pyproject.toml

@@ -128,7 +128,7 @@ add-test = [
     "chatlas[anthropic,openai]",
     "openai>=1.104.1",
     "anthropic>=0.62.0",
-    "inspect-ai>=0.3.129",
+    "inspect-ai>=0.3.129;python_version>='3.10'",
     "pytest-timeout",
     "pytest>=6.2.4",
     "pytest-playwright>=0.5.2",

shiny/_docstring.py

@@ -228,6 +228,7 @@ def __init__(
         dir: str,
         type: Optional[Literal["core", "express"]] = None,
     ) -> None:
+        super().__init__(type, file_names, dir)
         self.type = type or os.environ.get("SHINY_MODE", "core")
         self.file_names = [file_names] if isinstance(file_names, str) else file_names
         self.dir = dir
@@ -250,8 +251,9 @@ def __init__(
         self,
         file_names: list[str] | str,
         dir: str,
+        type: Literal["express"] = "express",
     ) -> None:
-        super().__init__(file_names, dir, "express")
+        super().__init__(file_names, dir, type)
 
 
 def app_choose_core_or_express(

shiny/_versions.py

@@ -1,5 +1,5 @@
 shiny_html_deps = "1.11.1.9001"
-bslib = "0.9.0.9000"
+bslib = "0.9.0.9002"
 htmltools = "0.5.8.9000"
 bootstrap = "5.3.1"
 requirejs = "2.3.6"