docs: added more details to the text-processor README.md and tests (#256)

Author: JoshuaKGoldberg

projects/arrays/text-processor/README.md

@@ -13,6 +13,10 @@ I'd like to set up code that can turn those pieces of text into print-ready line
 Before we can do any of our fancy typography work on text, we need to split text into lines.
 Much of our text data is stored in strings where the only whitespace is a single `" "` space between words.
 
+More specifically: I'm going to give you an array of lines - each represented as a string.
+For each of those lines, give me back an array of strings (so the final result is an array of array of strings).
+Each of the strings in the array has as many of the words from the first line as it can fit, as long as there's a `" "` space between them.
+
 Additionally, for each line, I'll need the ability to align it to the left, middle, or right.
 Alignment means adding spaces to the beginning and/or end of the string to fit it to a specified character width.
 
@@ -47,19 +51,46 @@ Parameters:
 
 Return type: An array of array of strings.
 
-### Example
+### Examples
+
+In this first example, each output string must be 3 characters long.
+The first string can fit `"ab"` but can't fit the additional word `"c"` because that would be 4 characters (`"ab c"`).
+The second string can git `"c"` and `"d"` with a space between them.
+
+- Input: `alignTexts(["ab c d"], { width: 3 })`
+- Output:
+
+  ```json
+  [["ab ", "c d"]]
+  ```
+
+Here, there are three lines to be split, and each becomes one of the arrays in the output array.
+`align: "right"` indicates that spaces must be added before characters (to their left), not after them (to their right).
+The first line can only fit one word (first `"ab"`, then `"cd"`) in the allowed 4 spaces.
+The second line again can only fit one word in its allowed spaces.
+The third line is the only one that can fit two words together: `"a"` and `"bc"`, which together with a space take up 4 characters.
 
-- Input: `alignTexts(["ab cd", "abc def", "abcd ef"], { width: 4 })`
+- Input: `alignTexts(["ab cd", "abc def", "a bc def"], { align: "right", width: 4 })`
 - Output:
 
   ```json
   [
-  	["ab  ", "cd  "],
-  	["abc ", "def "],
-  	["abcd", "ef  "]
+  	["  ab", "  cd"],
+  	[" abc", " def"],
+  	["a bc", " def"]
   ]
   ```
 
+This last example shows aligning text to the middle.
+If there's an extra space, it's added to the right (at the end).
+
+- Input: `alignTexts(["a", "ab", "abc", "abcd"], { align: "middle", width: 4 })`
+- Output:
+
+  ```json
+  [[" a  "], [" ab "], ["abc "], ["abcd"]]
+  ```
+
 ## Files
 
 - `index.ts`: Add your `alignTexts` function and type annotations here

projects/arrays/text-processor/src/index.test.ts

@@ -4,6 +4,8 @@ import { expectType } from "tsd";
 import * as index from "./index";
 import * as solution from "./solution";
 
+process.env.TEST_SOLUTIONS = "1";
+
 const { alignTexts } = process.env.TEST_SOLUTIONS ? solution : index;
 
 describe(alignTexts, () => {
@@ -75,6 +77,11 @@ describe(alignTexts, () => {
 		[["abc def"], { align: "left", width: 9 }, [["abc def  "]]],
 		[["abc def"], { align: "left", width: 10 }, [["abc def   "]]],
 		[["abc def"], { align: "left", width: 11 }, [["abc def    "]]],
+		[
+			["a", "ab", "abc", "abcd"],
+			{ align: "middle", width: 4 },
+			[[" a  "], [" ab "], ["abc "], ["abcd"]],
+		],
 		[[""], { align: "middle", width: 0 }, [[""]]],
 		[[""], { align: "middle", width: 1 }, [[" "]]],
 		[[""], { align: "middle", width: 2 }, [["  "]]],