Animator docs, wait syntax in app.run keys

docs/examples/guide/animator/animation01.py

@@ -0,0 +1,19 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Static
+
+
+class AnimationApp(App):
+    def compose(self) -> ComposeResult:
+        self.box = Static("Hello, World!")
+        self.box.styles.background = "red"
+        self.box.styles.color = "black"
+        self.box.styles.padding = (1, 2)
+        yield self.box
+
+    def on_mount(self):
+        self.box.styles.animate("opacity", value=0.0, duration=2.0)
+
+
+if __name__ == "__main__":
+    app = AnimationApp()
+    app.run()

docs/examples/guide/animator/animation01_static.py

@@ -0,0 +1,16 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Static
+
+
+class AnimationApp(App):
+    def compose(self) -> ComposeResult:
+        self.box = Static("Hello, World!")
+        self.box.styles.background = "red"
+        self.box.styles.color = "black"
+        self.box.styles.padding = (1, 2)
+        yield self.box
+
+
+if __name__ == "__main__":
+    app = AnimationApp()
+    app.run()

docs/examples/guide/animator/animation02.py

@@ -0,0 +1,19 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Static
+
+
+class AnimationApp(App):
+    def compose(self) -> ComposeResult:
+        self.box = Static("Hello, World!")
+        self.box.styles.background = "red"
+        self.box.styles.color = "black"
+        self.box.styles.padding = (1, 2)
+        yield self.box
+
+    def on_mount(self):
+        self.box.styles.animate("opacity", value=0.0, duration=2.0, easing="linear")
+
+
+if __name__ == "__main__":
+    app = AnimationApp()
+    app.run()

docs/examples/guide/animator/animation03.py

@@ -0,0 +1,21 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Static
+
+
+class AnimationApp(App):
+    def compose(self) -> ComposeResult:
+        self.box = Static("Hello, World!")
+        self.box.styles.background = "red"
+        self.box.styles.color = "black"
+        self.box.styles.padding = (1, 2)
+        yield self.box
+
+    def on_mount(self):
+        self.box.styles.animate(
+            "opacity", value=0.0, duration=2.0, on_complete=self.bell
+        )
+
+
+if __name__ == "__main__":
+    app = AnimationApp()
+    app.run()