From 43495711123cb9f1c8937bdf89720b8f99262700 Mon Sep 17 00:00:00 2001
From: Juergen Kunz <juergen@foss.global>
Date: Mon, 12 Jan 2026 02:03:38 +0000
Subject: [PATCH] fix(readme): document maxLineLength option for base64ts
 output and add example and tip

---
 changelog.md             | 7 +++++++
 readme.md                | 6 +++++-
 ts/00_commitinfo_data.ts | 2 +-
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/changelog.md b/changelog.md
index 246bedd..a0a16a1 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## 2026-01-12 - 2.8.1 - fix(readme)
+document maxLineLength option for base64ts output and add example and tip
+
+- Add documented `maxLineLength` configuration option (number, default 0 = unlimited) for `base64ts` output.
+- Include example config showing `maxLineLength: 200`.
+- Add a tip recommending setting `maxLineLength` to split long base64 strings when using AI tools with line-length limits.
+
 ## 2026-01-12 - 2.8.0 - feat(tsbundle)
 add configurable maxLineLength for base64ts output and improve build/error handling in child builds
 
diff --git a/readme.md b/readme.md
index 5b85560..019d00d 100644
--- a/readme.md
+++ b/readme.md
@@ -91,6 +91,7 @@ tsbundle uses `npmextra.json` for configuration. Here's an example:
 | `bundler` | `"esbuild"` \| `"rolldown"` \| `"rspack"` | `"esbuild"` | Which bundler to use |
 | `production` | `boolean` | `false` | Enable minification |
 | `includeFiles` | `string[]` | `[]` | Glob patterns for additional files (HTML, assets) |
+| `maxLineLength` | `number` | `0` (unlimited) | For `base64ts` mode: max chars per line in output |
 
 ### Output Modes
 
@@ -108,6 +109,8 @@ export const files: { path: string; contentBase64: string }[] = [
 ];
 ```
 
+**Tip:** If you're working with AI tools that have line length limitations, set `maxLineLength` (e.g., `200`) to split long base64 strings across multiple lines.
+
 ## Available Bundlers 🔧
 
 tsbundle supports three modern bundlers:
@@ -241,7 +244,8 @@ Config:
         "outputMode": "base64ts",
         "bundler": "esbuild",
         "production": true,
-        "includeFiles": ["./html/index.html"]
+        "includeFiles": ["./html/index.html"],
+        "maxLineLength": 200
       }
     ]
   }
diff --git a/ts/00_commitinfo_data.ts b/ts/00_commitinfo_data.ts
index 6269877..075ddc9 100644
--- a/ts/00_commitinfo_data.ts
+++ b/ts/00_commitinfo_data.ts
@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/tsbundle',
-  version: '2.8.0',
+  version: '2.8.1',
   description: 'a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects'
 }