Improved by giving it a more fluent interface.

Author: petercv

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 All notable changes to this project will be documented in this file.
 
+## v1.3.2 - 2025-08-25
+- Improved `AttributedStringBuilder` by giving it a more fluent interface.
+
 ## v1.3.1 - 2025-08-24
 - Improved usability of `AttributedStringBuilder` outside parser context.
 

src/MarkupKit/Core/String/AttributeContainer.php

@@ -44,7 +44,6 @@ public function withAttribute(Attribute $attribute): self
 
     /**
      * @param class-string<Attribute>|(Attribute&UnitEnum) $attribute
-     * @return self
      */
     public function withoutAttribute(string|Attribute $attribute): self
     {

src/MarkupKit/Core/String/AttributedStringBuilder.php

@@ -107,35 +107,39 @@ private function normalizeTrailingSpace(): array
     /**
      * @param AttributeContainer|array<int, Attribute> $attributes
      */
-    public function appendString(string $string, AttributeContainer|array $attributes = []): void
+    public function appendString(string $string, AttributeContainer|array $attributes = []): self
     {
         $string = $this->normalizeSpace($string, end($this->elements) ?: null);
         if (strlen($string) === 0) {
-            return;
+            return $this;
         }
 
         $this->elements[] = new AttributedSubstring($string, $attributes);
+        return $this;
     }
 
     /**
      * @param AttributeContainer|array<int, Attribute> $attributes
      */
-    public function appendLineBreak(AttributeContainer|array $attributes = []): void
+    public function appendLineBreak(AttributeContainer|array $attributes = []): self
     {
         $this->elements[] = new AttributedSubstring("\n", $attributes);
+        return $this;
     }
 
-    public function appendAttachment(Attachment $attachment): void
+    public function appendAttachment(Attachment $attachment): self
     {
         if (!$this->trimWhitespaceAroundAttachments) {
             $this->elements[] = $attachment;
-            return;
+            return $this;
         }
 
         $this->elements = [
             ...$this->normalizeTrailingSpace(),
             $attachment
         ];
+
+        return $this;
     }
 
     public function isEmpty(): bool