more words

Author: willmcgugan

docs/blog/posts/release1.0.0.md

@@ -3,7 +3,7 @@ draft: true
 date: 2024-12-05
 categories:
   - Release
-title: "Three algorithms for high performance terminal apps"
+title: "Algorithms for high performance terminal apps"
 authors:
   - willmcgugan
 ---
@@ -20,9 +20,11 @@ I've had the fortune of being able to work fulltime on a FOSS project for the la
 Textual has been a constant source of programming challenges.
 Often frustrating but never boring, the challenges arise because the terminal "specification" says nothing about how to build a modern User Interface.
 The building blocks are there: after some effort you can move the cursor, write colored text, read keys and mouse movements, but that's about it.
-Everything else we had to build from scratch, from the most basic [button](https://textual.textualize.io/widget_gallery/#button) to a syntax highlighted [TextArea](https://textual.textualize.io/widget_gallery/#textarea), and everything along the way.
+Everything else we had to build from scratch. From the most basic [button](https://textual.textualize.io/widget_gallery/#button) to a syntax highlighted [TextArea](https://textual.textualize.io/widget_gallery/#textarea), and everything along the way.
 
-I wanted to write-up some of the more interesting solutions we came up with, and the 1.0 milestone we just passed makes this a perfect time.
+I wanted to write-up some of the solutions we came up with, and the 1.0 milestone we just passed makes this a perfect time.
+
+<!-- more -->
 
 If you haven't followed along with Textual's development, here is a demo of what it can do.
 This is a Textual app, running remotely, served by your browser:
@@ -41,11 +43,10 @@ uvx --python 3.12 textual-demo
 
 ## The Compositor
 
-The first component of Textual I want to cover is the *compositor*.
-The job of the compositor is to combine widgets in to a single view.
+The first component of Textual I want to cover is the [compositor](https://github.com/Textualize/textual/blob/main/src/textual/_compositor.py).
+The job of the compositor is to combine content from multiple sources into a single view.
 
 We do this because the terminal itself has no notion of overlapping windows in the way a desktop does.
-If an app wants to display overlapping components we must first combine (or compose) them into a single update.
 
 Here's a video I generated over a year ago, demonstrating the compositor:
 
@@ -64,12 +65,11 @@ Some characters such as those in Asian languages and many emoji are double the w
 
 Textual's way of handling this is inherited from [Rich](https://github.com/Textualize/rich).
 Anything you print in Rich, first generates a list of [Segments](https://github.com/Textualize/rich/blob/master/rich/segment.py) which consist of a string and associated style.
-These Segments are only converted into text with [ansi escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code) at the very last moment.
+These Segments are only converted into text with [ansi escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code) at the very end of the process.
 
 
-Textual builds its output from the same Segment object.
 The compositor takes lists of segments generated by widgets and further processes them, by dividing and combining, to produce the final output. 
-In fact almost everything Textual does involves processing these segments in one way or another,.
+In fact almost everything Textual does involves processing these segments in one way or another.
 
 !!! tip "Switch the Primitive"
 
@@ -263,6 +263,14 @@ The useful property of this algorithm is that as the number of widgets increases
 
 The code for our `SpatialMap` isn't part of the public API and therefore not in the docs, but if you are interested you can check it out here: [_spacial_map.py](https://github.com/Textualize/textual/blob/main/src/textual/_spatial_map.py).
 
+## Wrapping up
+
+If any of the code discussed here interests you, you have my blessing to [steal the code](./steal-this-code.md)!
+
+As always, if you want to discuss this or Textual in general, we can be found on our [Discord server](https://discord.gg/Enf6Z3qhVr).
+
+
+
 [^1]: A term I coined for the structure in Textual. There may be other unconnected things known as spatial maps.
 [^2]: The [grid](https://www.youtube.com/watch?v=lILHEnz8fTk&ab_channel=DaftPunk-Topic).
 [^3]: If you scroll the screen up, it moves *down* relative to the widgets.