v2.9.1

includeFiles now accepts string | {from, to} entries. The object form
allows specifying a custom serve path (e.g. ./html/index.html -> index.html)
for base64ts bundled content.

changelog.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 2026-03-05 - 2.9.1 - fix(mod_custom)
+use absolute smartfs entry.path instead of joining with dirPath when building fullPath
+
+- entry.path is already absolute (from smartfs); avoid joining it with dirPath which produced incorrect paths
+- Fixes file copy path construction so plugins.fs.file(fullPath).copy(destPath) uses the correct source path
+
+## 2026-02-24 - 2.9.0 - feat(exports)
+expose mod_custom, mod_output and interfaces from entry; make processSingleBundle public
+
+- Exported ./mod_custom, ./mod_output and ./interfaces from ts/index.ts to expose these modules in the public API.
+- Changed processSingleBundle in ts/mod_custom/index.ts from private to public to allow programmatic invocation.
+- Non-breaking API expansion; recommend a minor version bump.
+
+## 2026-02-24 - 2.8.4 - fix()
+no changes — empty diff, nothing to commit
+
+- Diff contained no modifications; no release required
+
+## 2026-01-23 - 2.8.3 - fix(mod_output)
+use pattern base dir when computing relative paths for files to serve
+
+- Compute relativePath using the pattern base directory (dirPath) instead of this.cwd to ensure correct web-serving paths for absolute or relative entry.path values.
+- File changed: ts/mod_output/index.ts — replaces plugins.path.relative(this.cwd, fullPath) with plugins.path.relative(dirPath, fullPath) and adds clarifying comment.
+
+## 2026-01-23 - 2.8.2 - fix(mod_output)
+resolve absolute and relative entry.path correctly when adding files
+
+- Add check for plugins.path.isAbsolute(entry.path) to avoid incorrectly joining absolute paths with dirPath
+- Use entry.path directly when it's absolute, otherwise join with dirPath
+- Ensures correct relativePath calculation and prevents invalid file reads
+
+## 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
+
+- Add optional maxLineLength?: number to IBundleConfig to control max characters per line for base64ts output (0 or undefined = unlimited).
+- Support splitting base64 strings when maxLineLength is specified; generateTypeScript(maxLineLength?) and writeToFile(outputPath, maxLineLength?) updated to accept and apply this setting.
+- Pass bundleConfig.maxLineLength through in mod_custom so base64ts output respects bundle configuration.
+- Wrap TsBundle.build in mod_custom with try/catch to log failures and skip output handling when build fails.
+- tsbundle.class now rejects the bundle promise when the child process exits with a non-zero status.
+- mod_esbuild child process now awaits builds, exits with appropriate success/failure codes, and formats esbuild errors for clearer console output.
+
+## 2026-01-12 - 2.7.4 - fix(deps)
+bump @push.rocks/smartcli dependency to ^4.0.20
+
+- @push.rocks/smartcli: ^4.0.19 → ^4.0.20
+- Patch-level dependency update with no breaking changes
+
 ## 2026-01-12 - 2.7.3 - fix(mod_output)
 wrap long base64 file contents and format generated TypeScript output to avoid extremely long lines
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git.zone/tsbundle",
-  "version": "2.7.3",
+  "version": "2.9.1",
   "private": false,
   "description": "a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects",
   "main": "dist_ts/index.js",
@@ -25,10 +25,10 @@
   "dependencies": {
     "@push.rocks/early": "^4.0.4",
     "@push.rocks/npmextra": "^5.1.3",
-    "@push.rocks/smartcli": "^4.0.19",
+    "@push.rocks/smartcli": "^4.0.20",
-    "@push.rocks/smartinteract": "^2.0.16",
     "@push.rocks/smartdelay": "^3.0.5",
     "@push.rocks/smartfs": "^1.1.3",
+    "@push.rocks/smartinteract": "^2.0.16",
     "@push.rocks/smartlog": "^3.1.8",
     "@push.rocks/smartlog-destination-local": "^9.0.2",
     "@push.rocks/smartpath": "^6.0.0",

pnpm-lock.yaml

@@ -15,8 +15,8 @@ importers:
         specifier: ^5.1.3
         version: 5.3.3
       '@push.rocks/smartcli':
-        specifier: ^4.0.19
+        specifier: ^4.0.20
-        version: 4.0.19
+        version: 4.0.20
       '@push.rocks/smartdelay':
         specifier: ^3.0.5
         version: 3.0.5
@@ -913,8 +913,8 @@ packages:
   '@push.rocks/smartchok@1.1.1':
     resolution: {integrity: sha512-WmNigGmn1muBJMANVuJb4F8x3TzgYrnn6YZm6ixTsG+0WFbYevivEwp+J4S7npobLHsR7ynf+Ky8LxRYmsL50A==}
 
-  '@push.rocks/smartcli@4.0.19':
+  '@push.rocks/smartcli@4.0.20':
-    resolution: {integrity: sha512-s1jZSgDZWi/az26AY4TJ2HPuG1qZzGC5R9fKWaECLmwnSpk6y9JXL5dnJAUohcdu50kdXCWEcRmLfYxOt81vEA==}
+    resolution: {integrity: sha512-gCo4ItvsPj8WoVAJw/6vkuoGA5FtIoACux2ktcCeH0nrFe7/xGR6waJ1aZcYAi7QN4gi52TlsgwuKz7BzXqhmQ==}
 
   '@push.rocks/smartclickhouse@2.0.17':
     resolution: {integrity: sha512-IYO8Obor/Ruam2KQ2B/+5uQ+rL0exU5KZoSgOc3jkkrfjn+zZenN2xoV8lVqavAtxZVfG7MfxFrcv6I7I9ZMmA==}
@@ -4853,7 +4853,7 @@ snapshots:
     dependencies:
       '@git.zone/tspublish': 1.10.3
       '@push.rocks/early': 4.0.4
-      '@push.rocks/smartcli': 4.0.19
+      '@push.rocks/smartcli': 4.0.20
       '@push.rocks/smartdelay': 3.0.5
       '@push.rocks/smartfile': 11.2.7
       '@push.rocks/smartlog': 3.1.10
@@ -4872,7 +4872,7 @@ snapshots:
   '@git.zone/tsbundle@2.5.2':
     dependencies:
       '@push.rocks/early': 4.0.4
-      '@push.rocks/smartcli': 4.0.19
+      '@push.rocks/smartcli': 4.0.20
       '@push.rocks/smartdelay': 3.0.5
       '@push.rocks/smartfile': 11.2.7
       '@push.rocks/smartlog': 3.1.10
@@ -4893,7 +4893,7 @@ snapshots:
   '@git.zone/tspublish@1.10.3':
     dependencies:
       '@push.rocks/consolecolor': 2.0.3
-      '@push.rocks/smartcli': 4.0.19
+      '@push.rocks/smartcli': 4.0.20
       '@push.rocks/smartdelay': 3.0.5
       '@push.rocks/smartfile': 11.2.7
       '@push.rocks/smartlog': 3.1.10
@@ -5428,7 +5428,7 @@ snapshots:
       chokidar: 4.0.3
       picomatch: 4.0.3
 
-  '@push.rocks/smartcli@4.0.19':
+  '@push.rocks/smartcli@4.0.20':
     dependencies:
       '@push.rocks/lik': 6.2.2
       '@push.rocks/smartlog': 3.1.10

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
       }
     ]
   }

ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@git.zone/tsbundle',
-  version: '2.7.3',
+  version: '2.9.1',
   description: 'a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects'
 }

ts/index.ts

@@ -11,4 +11,7 @@ early.stop();
 export * from './tsbundle.class.tsbundle.js';
 export * from './mod_assets/index.js';
 export * from './mod_html/index.js';
+export * from './mod_custom/index.js';
+export * from './mod_output/index.js';
+export * from './interfaces/index.js';
 export { runCli };

ts/interfaces/index.ts

@@ -17,13 +17,16 @@ export interface IEnvTransportOptions {
 export type TOutputMode = 'bundle' | 'base64ts';
 export type TBundler = 'esbuild' | 'rolldown' | 'rspack';
 
+export type TIncludeFile = string | { from: string; to: string };
+
 export interface IBundleConfig {
   from: string;
   to: string;
   outputMode?: TOutputMode;
   bundler?: TBundler;
   production?: boolean;
-  includeFiles?: string[];
+  includeFiles?: TIncludeFile[];
+  maxLineLength?: number; // For base64ts output: max chars per line. 0 or undefined = unlimited (default)
 }
 
 export interface ITsbundleConfig {

ts/mod_custom/index.ts

@@ -48,7 +48,7 @@ export class CustomBundleHandler {
   /**
    * Process a single bundle configuration
    */
-  private async processSingleBundle(bundleConfig: interfaces.IBundleConfig): Promise<void> {
+  public async processSingleBundle(bundleConfig: interfaces.IBundleConfig): Promise<void> {
     const outputMode = bundleConfig.outputMode || 'bundle';
     const bundler = bundleConfig.bundler || 'esbuild';
 
@@ -61,6 +61,7 @@ export class CustomBundleHandler {
 
     // Build the bundle to temp location
     const tsbundle = new TsBundle();
+    try {
       await tsbundle.build(
         this.cwd,
         bundleConfig.from,
@@ -70,6 +71,11 @@ export class CustomBundleHandler {
           production: bundleConfig.production || false,
         }
       );
+    } catch (error: any) {
+      console.error(`\n\x1b[31m❌ Bundle failed: ${bundleConfig.from} -> ${bundleConfig.to}\x1b[0m`);
+      // Don't re-print error details - they were already shown by the child process
+      return; // Skip output handling since build failed
+    }
 
     if (outputMode === 'base64ts') {
       await this.handleBase64TsOutput(bundleConfig, tempBundlePath);
@@ -99,13 +105,17 @@ export class CustomBundleHandler {
 
     // Add included files
     if (bundleConfig.includeFiles && bundleConfig.includeFiles.length > 0) {
-      for (const pattern of bundleConfig.includeFiles) {
+      for (const entry of bundleConfig.includeFiles) {
-        await base64Output.addFilesFromGlob(pattern);
+        if (typeof entry === 'string') {
+          await base64Output.addFilesFromGlob(entry);
+        } else {
+          await base64Output.addFileWithServePath(entry.from, entry.to);
+        }
       }
     }
 
     // Write the TypeScript output
-    await base64Output.writeToFile(bundleConfig.to);
+    await base64Output.writeToFile(bundleConfig.to, bundleConfig.maxLineLength);
   }
 
   /**
@@ -129,7 +139,8 @@ export class CustomBundleHandler {
       const htmlHandler = new HtmlHandler();
       const outputDir = plugins.path.dirname(toPath);
 
-      for (const pattern of bundleConfig.includeFiles) {
+      for (const entry of bundleConfig.includeFiles) {
+        const pattern = typeof entry === 'string' ? entry : entry.from;
         await this.copyIncludedFiles(pattern, outputDir);
       }
     }
@@ -165,7 +176,8 @@ export class CustomBundleHandler {
 
       for (const entry of entries) {
         if (!entry.isDirectory && regex.test(entry.name)) {
-          const fullPath = plugins.path.join(dirPath, entry.path);
+          // entry.path is already absolute from smartfs
+          const fullPath = entry.path;
           const relativePath = plugins.path.relative(this.cwd, fullPath);
           const destPath = plugins.path.join(outputDir, plugins.path.basename(entry.path));
           await plugins.fs.directory(plugins.path.dirname(destPath)).create();

ts/mod_esbuild/index.child.ts

@@ -79,6 +79,7 @@ export class TsBundleProcess {
 }
 
 const run = async () => {
+  try {
     console.log('running spawned compilation process');
     const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(
       process.env.transportOptions,
@@ -90,7 +91,7 @@ const run = async () => {
     const tsbundleProcessInstance = new TsBundleProcess();
     if (transportOptions.mode === 'test') {
       console.log('building for test:');
-    tsbundleProcessInstance.buildTest(
+      await tsbundleProcessInstance.buildTest(
         plugins.smartpath.transform.makeAbsolute(
           transportOptions.from,
           process.cwd(),
@@ -103,7 +104,7 @@ const run = async () => {
       );
     } else {
       console.log('building for production:');
-    tsbundleProcessInstance.buildProduction(
+      await tsbundleProcessInstance.buildProduction(
         plugins.smartpath.transform.makeAbsolute(
           transportOptions.from,
           process.cwd(),
@@ -115,6 +116,29 @@ const run = async () => {
         transportOptions.argv,
       );
     }
+    process.exit(0);
+  } catch (error: any) {
+    console.error('\n\x1b[31m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m');
+    console.error('\x1b[31m❌ BUILD FAILED\x1b[0m');
+    console.error('\x1b[31m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');
+
+    if (error.errors && Array.isArray(error.errors)) {
+      // esbuild errors - format them nicely
+      console.error(`Found ${error.errors.length} error(s):\n`);
+      for (const err of error.errors) {
+        const file = err.location?.file || 'unknown';
+        const line = err.location?.line || '?';
+        const column = err.location?.column || '?';
+        console.error(`  \x1b[36m${file}\x1b[0m:\x1b[33m${line}\x1b[0m:\x1b[33m${column}\x1b[0m`);
+        console.error(`    ${err.text}\n`);
+      }
+    } else {
+      console.error(error.message || error);
+    }
+
+    console.error('\x1b[31m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\x1b[0m\n');
+    process.exit(1);
+  }
 };
 
 run();

ts/mod_init/index.ts

@@ -123,7 +123,8 @@ export class InitHandler {
       console.log(`    Mode: ${bundle.outputMode || 'bundle'}`);
       console.log(`    Bundler: ${bundle.bundler || 'esbuild'}`);
       if (bundle.includeFiles && bundle.includeFiles.length > 0) {
-        console.log(`    Include: ${bundle.includeFiles.join(', ')}`);
+        const display = bundle.includeFiles.map(f => typeof f === 'string' ? f : `${f.from} -> ${f.to}`);
+        console.log(`    Include: ${display.join(', ')}`);
       }
       console.log('');
     });
@@ -168,7 +169,8 @@ export class InitHandler {
     console.log(`    Mode: ${preset.config.outputMode}`);
     console.log(`    Bundler: ${preset.config.bundler}`);
     if (preset.config.includeFiles && preset.config.includeFiles.length > 0) {
-      console.log(`    Include: ${preset.config.includeFiles.join(', ')}`);
+      const display = preset.config.includeFiles.map(f => typeof f === 'string' ? f : `${f.from} -> ${f.to}`);
+      console.log(`    Include: ${display.join(', ')}`);
     }
 
     const confirmInteract = new plugins.smartinteract.SmartInteract();
@@ -293,14 +295,14 @@ export class InitHandler {
   /**
    * Configure files to include
    */
-  private async configureIncludeFiles(prefill?: string[]): Promise<string[]> {
+  private async configureIncludeFiles(prefill?: interfaces.TIncludeFile[]): Promise<interfaces.TIncludeFile[]> {
-    const includeFiles: string[] = [];
+    const includeFiles: interfaces.TIncludeFile[] = [];
     let addMore = true;
 
     // If we have prefilled values, show them first
     if (prefill && prefill.length > 0) {
       console.log('\nPre-configured include patterns:');
-      prefill.forEach((p) => console.log(`  - ${p}`));
+      prefill.forEach((p) => console.log(`  - ${typeof p === 'string' ? p : `${p.from} -> ${p.to}`}`));
 
       const keepInteract = new plugins.smartinteract.SmartInteract();
       keepInteract.addQuestions([

ts/mod_output/index.ts

@@ -22,6 +22,20 @@ export class Base64TsOutput {
     });
   }
 
+  /**
+   * Add a file with a custom serve path
+   */
+  public async addFileWithServePath(fromPath: string, servePath: string): Promise<void> {
+    const absolutePath = plugins.smartpath.transform.toAbsolute(fromPath, this.cwd) as string;
+    const fileExists = await plugins.fs.file(absolutePath).exists();
+    if (!fileExists) {
+      console.log(`File does not exist: ${absolutePath}`);
+      return;
+    }
+    const content = await plugins.fs.file(absolutePath).read();
+    this.addFile(servePath, content);
+  }
+
   /**
    * Add files matching a glob pattern
    */
@@ -56,8 +70,12 @@ export class Base64TsOutput {
 
       for (const entry of entries) {
         if (!entry.isDirectory && regex.test(entry.name)) {
-          const fullPath = plugins.path.join(dirPath, entry.path);
+          // entry.path may be absolute or relative - handle both cases
-          const relativePath = plugins.path.relative(this.cwd, fullPath);
+          const fullPath = plugins.path.isAbsolute(entry.path)
+            ? entry.path
+            : plugins.path.join(dirPath, entry.path);
+          // Use path relative to pattern's base dir (not cwd) for web serving
+          const relativePath = plugins.path.relative(dirPath, fullPath);
           const content = await plugins.fs.file(fullPath).read();
           this.addFile(relativePath, content);
         }
@@ -77,18 +95,26 @@ export class Base64TsOutput {
 
   /**
    * Generate TypeScript file content
+   * @param maxLineLength - Max chars per line for base64 strings. 0 or undefined = unlimited (default)
    */
-  public generateTypeScript(): string {
+  public generateTypeScript(maxLineLength?: number): string {
-    const MAX_LINE_LENGTH = 200;
+    // Default behavior: no line splitting (unlimited)
+    if (!maxLineLength || maxLineLength <= 0) {
+      const filesJson = JSON.stringify(this.files, null, 2);
+      return `// Auto-generated by tsbundle - do not edit
+export const files: { path: string; contentBase64: string }[] = ${filesJson};
+`;
+    }
 
+    // Split base64 strings into chunks when maxLineLength is specified
     const formatBase64 = (base64: string): string => {
-      if (base64.length <= MAX_LINE_LENGTH) {
+      if (base64.length <= maxLineLength) {
         return `"${base64}"`;
       }
 
       const chunks: string[] = [];
-      for (let i = 0; i < base64.length; i += MAX_LINE_LENGTH) {
+      for (let i = 0; i < base64.length; i += maxLineLength) {
-        chunks.push(base64.slice(i, i + MAX_LINE_LENGTH));
+        chunks.push(base64.slice(i, i + maxLineLength));
       }
 
       return `"" +\n      "${chunks.join('" +\n      "')}"`;
@@ -110,12 +136,14 @@ ${filesFormatted}
 
   /**
    * Write the TypeScript file to disk
+   * @param outputPath - Output file path
+   * @param maxLineLength - Max chars per line for base64 strings. 0 or undefined = unlimited (default)
    */
-  public async writeToFile(outputPath: string): Promise<void> {
+  public async writeToFile(outputPath: string, maxLineLength?: number): Promise<void> {
     const absolutePath = plugins.smartpath.transform.toAbsolute(outputPath, this.cwd) as string;
     const outputDir = plugins.path.dirname(absolutePath);
     await plugins.fs.directory(outputDir).create();
-    const content = this.generateTypeScript();
+    const content = this.generateTypeScript(maxLineLength);
     await plugins.fs.file(absolutePath).encoding('utf8').write(content);
     console.log(`Generated base64ts output: ${outputPath}`);
   }

ts/tsbundle.class.tsbundle.ts

@@ -45,7 +45,11 @@ export class TsBundle {
     );
     const childProcess = await threadsimple.start();
     childProcess.on('exit', (status) => {
+      if (status !== 0) {
+        done.reject(new Error(`Bundle build failed with exit code ${status}`));
+      } else {
         done.resolve();
+      }
     });
     await done.promise;
   }