Compare commits

..

23 Commits

Author SHA1 Message Date
jkunz 7e98ba083e v2.10.2
Default (tags) / security (push) Failing after 1s
Default (tags) / test (push) Failing after 1s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-05-09 12:34:01 +00:00
jkunz e5b2f2ba30 fix(config): update .smartconfig.json handling and harden bundler runtime compatibility 2026-05-09 12:34:00 +00:00
jkunz f19c7c69af v2.10.1
Default (tags) / security (push) Failing after 1s
Default (tags) / test (push) Failing after 1s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-04-30 12:52:26 +00:00
jkunz 3b2e0bebcd fix(mod_custom): make base64ts bundle output deterministic and clean up generated temp sourcemaps 2026-04-30 12:52:26 +00:00
jkunz 7f5de8797c v2.10.0
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 18:15:30 +00:00
jkunz aea86bd8f5 feat(config): migrate project configuration to smartconfig.json and update bundler dependencies 2026-03-24 18:15:30 +00:00
jkunz ad5e0c1afc v2.9.3
Default (tags) / security (push) Failing after 0s
Default (tags) / test (push) Failing after 0s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-24 15:06:01 +00:00
jkunz cb5d827420 fix(config): migrate configuration loading and init output from npmextra.json to smartconfig.json 2026-03-24 15:06:01 +00:00
jkunz 5a5f6c6944 v2.9.2
Default (tags) / security (push) Successful in 43s
Default (tags) / test (push) Failing after 38s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-11 19:34:52 +00:00
jkunz 54ac7e7188 fix(mod_esbuild): preserve function and class names in esbuild output by enabling keepNames in both dev and prod configs 2026-03-11 19:34:52 +00:00
jkunz 5f0507b2c7 v2.9.1
Default (tags) / security (push) Successful in 41s
Default (tags) / test (push) Failing after 34s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-03-05 16:47:47 +00:00
jkunz ecfd7600e2 fix(mod_custom): use absolute smartfs entry.path instead of joining with dirPath when building fullPath 2026-03-05 16:47:47 +00:00
jkunz 9cf173293d v2.9.0
Default (tags) / security (push) Successful in 43s
Default (tags) / test (push) Failing after 39s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-02-24 19:00:42 +00:00
jkunz 3a53fffe3d feat(exports): expose mod_custom, mod_output and interfaces from entry; make processSingleBundle public 2026-02-24 19:00:42 +00:00
jkunz 8f129527d9 v2.8.4
Default (tags) / security (push) Successful in 41s
Default (tags) / test (push) Failing after 36s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-02-24 17:03:04 +00:00
jkunz 5d9052018e fix(): no changes — empty diff, nothing to commit 2026-02-24 17:03:04 +00:00
jkunz 12c5655251 feat(includeFiles): support {from, to} object form for custom serve paths
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.
2026-02-24 17:02:46 +00:00
jkunz 801cab9001 v2.8.3
Default (tags) / security (push) Successful in 31s
Default (tags) / test (push) Failing after 35s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-23 19:12:30 +00:00
jkunz 971cb685a7 fix(mod_output): use pattern base dir when computing relative paths for files to serve 2026-01-23 19:12:30 +00:00
jkunz 0900d1a605 v2.8.2
Default (tags) / security (push) Successful in 39s
Default (tags) / test (push) Failing after 37s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-23 19:08:55 +00:00
jkunz f0fb99c8ae fix(mod_output): resolve absolute and relative entry.path correctly when adding files 2026-01-23 19:08:55 +00:00
jkunz 6d88adcd1e v2.8.1
Default (tags) / security (push) Successful in 40s
Default (tags) / test (push) Failing after 34s
Default (tags) / release (push) Has been skipped
Default (tags) / metadata (push) Has been skipped
2026-01-12 02:03:38 +00:00
jkunz 4349571112 fix(readme): document maxLineLength option for base64ts output and add example and tip 2026-01-12 02:03:38 +00:00
27 changed files with 3571 additions and 4588 deletions
+1 -1
View File
@@ -5,7 +5,7 @@
"githost": "gitlab.com",
"gitscope": "gitzone",
"gitrepo": "tsbundle",
"description": "a bundler using rollup for painless bundling of web projects",
"description": "a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects",
"npmPackagename": "@git.zone/tsbundle",
"license": "MIT",
"projectDomain": "git.zone"
+1 -1
View File
@@ -1,7 +1,7 @@
{
"json.schemas": [
{
"fileMatch": ["/npmextra.json"],
"fileMatch": ["/.smartconfig.json"],
"schema": {
"type": "object",
"properties": {
+1 -1
View File
@@ -3,7 +3,7 @@
"target": "ES2022",
"module": "ES2022",
"moduleResolution": "node12",
"preserveValueImports": true,
"verbatimModuleSyntax": true,
"esModuleInterop": true
}
}
+76
View File
@@ -1,5 +1,81 @@
# Changelog
## 2026-05-09 - 2.10.2 - fix(config)
update .smartconfig.json handling and harden bundler runtime compatibility
- switch init, CLI, docs, and custom config loading references from smartconfig.json to .smartconfig.json
- add guards for missing transportOptions and missing rspack stats in spawned bundler processes
- align TypeScript and test fixtures with newer decorator and module syntax requirements
- adjust rspack module output configuration and refactor asset/html option handling for safer processing
## 2026-04-30 - 2.10.1 - fix(mod_custom)
make base64ts bundle output deterministic and clean up generated temp sourcemaps
- Use a stable temporary bundle filename instead of a timestamp-based name so repeated base64ts builds produce identical output.
- Delete the generated temporary sourcemap alongside the temp bundle to avoid leftover build artifacts.
- Add a test covering deterministic base64ts output generation.
- Update package scripts to use pnpm for tests and remove the allowimplicitany build flag.
## 2026-03-24 - 2.10.0 - feat(config)
migrate project configuration to smartconfig.json and update bundler dependencies
- replace npmextra.json with .smartconfig.json and update CLI, init, and custom bundle loading references
- rename the smartconfig plugin export and load tsbundle configuration through the new config file
- update rolldown output settings to use codeSplitting: false instead of the deprecated inlineDynamicImports option
- refresh core build and bundler dependencies including rolldown, rspack, esbuild, TypeScript, and smartfs
- revise README documentation to reflect smartconfig.json usage and current bundler capabilities
## 2026-03-24 - 2.9.3 - fix(config)
migrate configuration loading and init output from npmextra.json to smartconfig.json
- replace @push.rocks/npmextra with @push.rocks/smartconfig
- load project configuration via Smartconfig in the custom module
- update init wizard to read from and write to smartconfig.json and adjust user-facing messages accordingly
## 2026-03-11 - 2.9.2 - fix(mod_esbuild)
preserve function and class names in esbuild output by enabling keepNames in both dev and prod configs
- Added keepNames: true to esbuild options in ts/mod_esbuild/index.child.ts for the non-minified/dev build
- Added keepNames: true to esbuild options in ts/mod_esbuild/index.child.ts for the minified/production build to improve stack traces, debugging, and runtime reflection
## 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
Regular → Executable
View File
+21 -24
View File
@@ -1,45 +1,45 @@
{
"name": "@git.zone/tsbundle",
"version": "2.8.0",
"version": "2.10.2",
"private": false,
"description": "a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects",
"main": "dist_ts/index.js",
"typings": "dist_ts/index.d.ts",
"type": "module",
"author": "Lossless GmbH",
"author": "Task Venture Capital GmbH",
"license": "MIT",
"scripts": {
"test": "npm run build && (tstest test/ --verbose)",
"build": "(tsbuild --web --allowimplicitany)",
"test": "pnpm run build && (tstest test/ --verbose)",
"build": "(tsbuild --web)",
"buildDocs": "tsdoc"
},
"bin": {
"tsbundle": "cli.js"
},
"devDependencies": {
"@git.zone/tsbuild": "^3.1.2",
"@git.zone/tsrun": "^2.0.0",
"@git.zone/tstest": "^3.1.3",
"@types/node": "^24.10.1"
"@git.zone/tsbuild": "^4.4.0",
"@git.zone/tsrun": "^2.0.3",
"@git.zone/tstest": "^3.6.5",
"@types/node": "^25.6.2"
},
"dependencies": {
"@push.rocks/early": "^4.0.4",
"@push.rocks/npmextra": "^5.1.3",
"@push.rocks/smartcli": "^4.0.20",
"@push.rocks/smartdelay": "^3.0.5",
"@push.rocks/smartfs": "^1.1.3",
"@push.rocks/smartcli": "^4.0.21",
"@push.rocks/smartconfig": "^6.1.1",
"@push.rocks/smartdelay": "^3.1.0",
"@push.rocks/smartfs": "^1.5.1",
"@push.rocks/smartinteract": "^2.0.16",
"@push.rocks/smartlog": "^3.1.8",
"@push.rocks/smartlog": "^3.2.2",
"@push.rocks/smartlog-destination-local": "^9.0.2",
"@push.rocks/smartpath": "^6.0.0",
"@push.rocks/smartpromise": "^4.2.3",
"@push.rocks/smartspawn": "^3.0.3",
"@rspack/core": "^1.6.5",
"@push.rocks/smartpromise": "^4.2.4",
"@push.rocks/smartspawn": "^3.0.4",
"@rspack/core": "^2.0.2",
"@types/html-minifier": "^4.0.6",
"esbuild": "^0.27.0",
"esbuild": "^0.28.0",
"html-minifier": "^4.0.0",
"rolldown": "1.0.0-beta.52",
"typescript": "5.9.3"
"rolldown": "1.0.0",
"typescript": "6.0.3"
},
"files": [
"ts/**/*",
@@ -50,7 +50,7 @@
"dist_ts_web/**/*",
"assets/**/*",
"cli.js",
"npmextra.json",
".smartconfig.json",
"readme.md"
],
"browserslist": [
@@ -64,8 +64,5 @@
"bugs": {
"url": "https://gitlab.com/gitzone/tsbundle/issues"
},
"homepage": "https://gitlab.com/gitzone/tsbundle#readme",
"pnpm": {
"overrides": {}
}
"homepage": "https://gitlab.com/gitzone/tsbundle#readme"
}
+3238 -4351
View File
File diff suppressed because it is too large Load Diff
+18 -41
View File
@@ -1,12 +1,15 @@
# tsbundle Hints and Findings
## Recent Updates (2025-11-23)
## Recent Updates (2026-03-24)
- Migrated from @push.rocks/smartfile v11 to @push.rocks/smartfs v1.1.0
- All filesystem operations now use async smartfs API
- Removed @push.rocks/tapbundle (now imported from @git.zone/tstest/tapbundle)
- All bundlers (esbuild, rolldown, rspack) updated to latest versions
- Removed deprecated rolldown experimental.enableComposingJsPlugins option
- Upgraded all dependencies to latest versions
- Migrated from npmextra.json to smartconfig.json (renamed file, updated all references)
- Renamed `npmextra` import to `smartconfig` in plugins.ts
- Fixed rolldown deprecation: `inlineDynamicImports` replaced with `codeSplitting: false`
- Major version bumps: tsbuild ^3.1.2 -> ^4.3.0, TypeScript 5.9.3 -> 6.0.2
- Rolldown upgraded from 1.0.0-beta.52 to 1.0.0-rc.11
- @rspack/core upgraded from ^1.6.5 to ^1.7.10
- @types/node upgraded from ^24.10.1 to ^25.5.0
## Bundler Architecture
@@ -16,41 +19,16 @@
## Bundler Implementations
- **esbuild** (default): Fully implemented, production ready, 3.9K minified
- **rolldown**: Implemented and working (beta v1.0.0-beta.51), produces smallest bundles (1.0K minified)
- **rspack**: Implemented and working (v1.6.4), webpack-compatible API, 6.3K minified
- **rollup**: Removed (was never implemented)
- **parcel**: Removed (was never implemented)
- **esbuild** (default): Fully implemented, production ready
- **rolldown**: Implemented and working (1.0.0-rc.11), produces smallest bundles
- **rspack**: Implemented and working (v1.7.10), webpack-compatible API
## Adding New Bundlers
## Configuration
To add a new bundler, you need:
1. Update `ICliOptions` interface to include the bundler name
2. Add case in `getBundlerPath()` switch statement
3. Create `mod_<bundler>/` directory with:
- `plugins.ts`: Import and re-export the bundler
- `index.child.ts`: Implement TsBundleProcess class with buildTest() and buildProduction()
4. Add bundler to package.json dependencies
## Rolldown Specific Notes
- Rolldown is in beta (v1.0.0-beta.18) but working well
- API: Use `rolldown()` function directly, not `rolldown.rolldown()`
- Output options go in the `write()` method, not the initial config
- Uses `dir` and `entryFileNames` instead of `file` for output (handles dynamic imports)
- Includes `inlineDynamicImports: true` to avoid chunk splitting issues
- Produces smaller minified bundles than esbuild (1.5K vs 2.2K in tests)
- Supports TypeScript via `resolve.tsconfigFilename`
## Rspack Specific Notes
- Rspack v1.3.15 - stable and production ready
- Uses webpack-compatible API (callback-based)
- Built-in SWC loader for TypeScript transpilation
- Produces larger bundles than esbuild/rolldown due to webpack runtime overhead
- Best choice if you need webpack compatibility or advanced features
- Supports ES modules output via `experiments.outputModule: true`
- Config file: `smartconfig.json` (previously `npmextra.json`)
- Config key: `@git.zone/tsbundle` with `bundles` array
- Supports `bundle` and `base64ts` output modes
- Interactive init wizard via `tsbundle init`
## CLI Usage
@@ -61,5 +39,4 @@ To add a new bundler, you need:
## Known Issues
- esbuild recently had splitting and tree-shaking disabled due to issues
- The README still mentions "a bundler using rollup" but uses esbuild by default
- Rolldown emits a warning about `preserveValueImports` in tsconfig - this is informational only
+55 -75
View File
@@ -1,6 +1,6 @@
# @git.zone/tsbundle
A powerful multi-bundler tool supporting **esbuild**, **rolldown**, and **rspack** for painless bundling of web projects. 🚀
A powerful multi-bundler tool supporting **esbuild**, **rolldown**, and **rspack** for painless bundling of web projects.
## Issue Reporting and Security
@@ -10,16 +10,13 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community
```bash
# Global installation for CLI usage
npm install -g @git.zone/tsbundle
pnpm add -g @git.zone/tsbundle
# Local installation for project usage
npm install --save-dev @git.zone/tsbundle
# Or with pnpm
pnpm add -g @git.zone/tsbundle
pnpm add --save-dev @git.zone/tsbundle
```
## Quick Start
## Quick Start
### Interactive Setup
@@ -29,11 +26,11 @@ The easiest way to get started is with the interactive wizard:
tsbundle init
```
This will guide you through setting up your bundle configuration with preset options:
This guides you through setting up your bundle configuration with preset options:
- **element** - Web component / element bundle (`./ts_web/index.ts` `./dist_bundle/bundle.js`)
- **website** - Full website with HTML and assets (`./ts_web/index.ts` `./dist_serve/bundle.js`)
- **npm** - NPM package bundle (`./ts/index.ts` `./dist_bundle/bundle.js`)
- **element** - Web component / element bundle (`./ts_web/index.ts` -> `./dist_bundle/bundle.js`)
- **website** - Full website with HTML and assets (`./ts_web/index.ts` -> `./dist_serve/bundle.js`)
- **npm** - NPM package bundle (`./ts/index.ts` -> `./dist_bundle/bundle.js`)
- **custom** - Configure everything manually
### Build Your Bundles
@@ -44,19 +41,19 @@ Once configured, simply run:
tsbundle
```
That's it! Your bundles will be built according to your `npmextra.json` configuration.
Your bundles will be built according to your `.smartconfig.json` configuration.
## CLI Commands
| Command | Description |
|---------|-------------|
| `tsbundle` | Build all bundles from `npmextra.json` configuration |
| `tsbundle` | Build all bundles from `.smartconfig.json` configuration |
| `tsbundle custom` | Same as above (explicit) |
| `tsbundle init` | Interactive wizard to create/update bundle configuration |
## Configuration 📝
## Configuration
tsbundle uses `npmextra.json` for configuration. Here's an example:
tsbundle uses `.smartconfig.json` for configuration. Here's an example:
```json
{
@@ -91,6 +88,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,20 +106,24 @@ export const files: { path: string; contentBase64: string }[] = [
];
```
## Available Bundlers 🔧
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.
tsbundle supports three modern bundlers:
## Available Bundlers
| Bundler | Speed | Best For |
|---------|-------|----------|
| **esbuild** | ⚡⚡⚡ Blazing fast | Development, quick iterations |
| **rolldown** | ⚡⚡ Fast | Production builds, tree-shaking |
| **rspack** | ⚡⚡ Fast | Webpack compatibility |
tsbundle supports three modern bundlers, each with different strengths:
| Bundler | Speed | Bundle Size | Best For |
|---------|-------|-------------|----------|
| **esbuild** | Fastest | Medium | Development, quick iterations |
| **rolldown** | Fast | Smallest | Production builds, tree-shaking |
| **rspack** | Fast | Largest (webpack runtime) | Webpack compatibility |
## API Usage
### TsBundle Class
The core bundling class, usable programmatically:
```typescript
import { TsBundle } from '@git.zone/tsbundle';
@@ -132,15 +134,17 @@ await bundler.build(
'./src/index.ts', // Entry point
'./dist/bundle.js', // Output path
{
bundler: 'esbuild',
bundler: 'esbuild', // 'esbuild' | 'rolldown' | 'rspack'
production: true
}
);
```
Each bundler runs in a separate child process via `smartspawn.ThreadSimple`, keeping the main process clean and isolated from bundler-specific dependencies.
### HtmlHandler Class
Process and minify HTML files:
Process and optionally minify HTML files:
```typescript
import { HtmlHandler } from '@git.zone/tsbundle';
@@ -156,7 +160,7 @@ await htmlHandler.processHtml({
### AssetsHandler Class
Handle static assets:
Copy static assets between directories:
```typescript
import { AssetsHandler } from '@git.zone/tsbundle';
@@ -169,59 +173,34 @@ await assetsHandler.processAssets({
});
```
## Complete Example 🎯
### Base64TsOutput Class
### 1. Initialize your project
```bash
tsbundle init
```
Select "website" preset for a full web application setup.
### 2. Your generated config
```json
{
"@git.zone/tsbundle": {
"bundles": [
{
"from": "./ts_web/index.ts",
"to": "./dist_serve/bundle.js",
"outputMode": "bundle",
"bundler": "esbuild",
"includeFiles": ["./html/**/*.html", "./assets/**/*"]
}
]
}
}
```
### 3. Create your entry point
Generate TypeScript files with base64-encoded content for embedding:
```typescript
// ts_web/index.ts
console.log('Hello from tsbundle! 🚀');
import { Base64TsOutput } from '@git.zone/tsbundle';
export const app = {
version: '1.0.0',
init() {
console.log('App initialized');
const output = new Base64TsOutput(process.cwd());
output.addFile('bundle.js', bundleBuffer);
await output.addFilesFromGlob('./html/**/*.html');
await output.writeToFile('./ts/embedded-bundle.ts', 200); // optional maxLineLength
```
### CustomBundleHandler Class
Process multiple bundle configurations from `.smartconfig.json`:
```typescript
import { CustomBundleHandler } from '@git.zone/tsbundle';
const handler = new CustomBundleHandler(process.cwd());
const hasConfig = await handler.loadConfig();
if (hasConfig) {
await handler.processAllBundles();
}
};
app.init();
```
### 4. Build
```bash
tsbundle
```
Your bundle is ready in `./dist_serve/bundle.js` along with any HTML and assets!
## Embedding for Deno Compile 🦕
## Embedding for Deno Compile
For single-executable scenarios with Deno:
@@ -241,7 +220,8 @@ Config:
"outputMode": "base64ts",
"bundler": "esbuild",
"production": true,
"includeFiles": ["./html/index.html"]
"includeFiles": ["./html/index.html"],
"maxLineLength": 200
}
]
}
@@ -260,7 +240,7 @@ const bundleContent = atob(bundle.contentBase64);
const htmlContent = atob(html.contentBase64);
```
## Project Structure Recommendations 📁
## Project Structure Recommendations
```
your-project/
@@ -273,12 +253,12 @@ your-project/
├── assets/ # Static assets (images, fonts, etc.)
├── dist_bundle/ # Output for element/npm bundles
├── dist_serve/ # Output for website bundles
└── npmextra.json # tsbundle configuration
└── .smartconfig.json # tsbundle configuration
```
## License and Legal Information
This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./license) file.
**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+25
View File
@@ -1,5 +1,6 @@
import { expect, tap } from '@git.zone/tstest/tapbundle';
import * as tsbundle from '../dist_ts/index.js';
import { CustomBundleHandler } from '../dist_ts/mod_custom/index.js';
import * as path from 'path';
import * as fs from 'fs';
@@ -61,6 +62,30 @@ tap.test('should bundle with rspack in production mode', async () => {
await testBundler('rspack', 'production');
});
tap.test('should generate deterministic base64ts output', async () => {
const testDir = path.join(process.cwd(), 'test');
const outputPath = path.join(testDir, 'dist_manual/base64-output.ts');
const bundleConfig = {
from: './ts_web/index.ts',
to: './dist_manual/base64-output.ts',
outputMode: 'base64ts' as const,
bundler: 'esbuild' as const,
};
const handler = new CustomBundleHandler(testDir);
if (fs.existsSync(outputPath)) {
fs.rmSync(outputPath, { force: true });
}
await handler.processSingleBundle(bundleConfig);
const firstOutput = fs.readFileSync(outputPath, 'utf8');
await handler.processSingleBundle(bundleConfig);
const secondOutput = fs.readFileSync(outputPath, 'utf8');
expect(secondOutput).toEqual(firstOutput);
});
// Test size comparison
tap.test('should show bundle size comparison', async () => {
const testDir = path.join(process.cwd(), 'test');
+4 -5
View File
@@ -1,16 +1,15 @@
// Test file to verify decorator functionality
const decoratedClasses: Function[] = [];
function trackClass(constructor: Function) {
decoratedClasses.push(constructor);
return constructor;
function trackClass(value: Function, _context: ClassDecoratorContext) {
decoratedClasses.push(value);
}
function logMethod(_target: any, context: ClassMethodDecoratorContext) {
function logMethod(method: Function, context: ClassMethodDecoratorContext) {
const methodName = String(context.name);
return function (this: any, ...args: any[]) {
console.log(`Calling method: ${methodName}`);
return (_target as Function).apply(this, args);
return method.apply(this, args);
};
}
+2 -2
View File
@@ -11,10 +11,10 @@ export class MyElement extends LitElement {
`;
@property({ type: String })
name = 'World';
accessor name = 'World';
@property({ type: Number })
count = 0;
accessor count = 0;
render() {
return html`
+3 -3
View File
@@ -4,9 +4,9 @@ const myConst: string = 'hello';
await smartdelay.delayFor(1000);
function sealed(constructor: Function) {
Object.seal(constructor);
Object.seal(constructor.prototype);
function sealed(value: Function, _context: ClassDecoratorContext) {
Object.seal(value);
Object.seal(value.prototype);
}
@sealed
+1 -1
View File
@@ -3,6 +3,6 @@
*/
export const commitinfo = {
name: '@git.zone/tsbundle',
version: '2.8.0',
version: '2.10.2',
description: 'a multi-bundler tool supporting esbuild, rolldown, and rspack for painless bundling of web projects'
}
+3
View File
@@ -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 };
+3 -1
View File
@@ -17,13 +17,15 @@ 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)
}
+8 -10
View File
@@ -40,29 +40,27 @@ export class AssetsHandler {
// copies the html
public async processAssets(optionsArg?: { from?: string; to?: string }) {
// lets assemble the options
optionsArg = {
...{
const options = {
from: this.defaultFromDirPath,
to: this.defaultToDirPath,
},
...(optionsArg || {}),
};
await this.ensureAssetsDir();
optionsArg.from = plugins.smartpath.transform.toAbsolute(
optionsArg.from,
options.from = plugins.smartpath.transform.toAbsolute(
options.from,
paths.cwd,
) as string;
optionsArg.to = plugins.smartpath.transform.toAbsolute(
optionsArg.to,
options.to = plugins.smartpath.transform.toAbsolute(
options.to,
paths.cwd,
) as string;
// lets clean the target directory
const toExists = await plugins.fs.directory(optionsArg.to).exists();
const toExists = await plugins.fs.directory(options.to).exists();
if (toExists) {
await plugins.fs.directory(optionsArg.to).delete();
await plugins.fs.directory(options.to).delete();
}
await this.copyDirectoryRecursive(optionsArg.from, optionsArg.to);
await this.copyDirectoryRecursive(options.from, options.to);
}
}
+21 -10
View File
@@ -9,18 +9,18 @@ const TEMP_DIR = '.nogit/tsbundle-temp';
export class CustomBundleHandler {
private cwd: string;
private config: interfaces.ITsbundleConfig;
private config!: interfaces.ITsbundleConfig;
constructor(cwd: string = paths.cwd) {
this.cwd = cwd;
}
/**
* Load configuration from npmextra.json
* Load configuration from .smartconfig.json
*/
public async loadConfig(): Promise<boolean> {
const npmextraInstance = new plugins.npmextra.Npmextra(this.cwd);
this.config = npmextraInstance.dataFor<interfaces.ITsbundleConfig>('@git.zone/tsbundle', {
const smartconfigInstance = new plugins.smartconfig.Smartconfig(this.cwd);
this.config = smartconfigInstance.dataFor<interfaces.ITsbundleConfig>('@git.zone/tsbundle', {
bundles: [],
});
@@ -48,13 +48,13 @@ 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';
// Determine temp output path
const tempDir = plugins.path.join(this.cwd, TEMP_DIR);
const tempBundlePath = plugins.path.join(tempDir, `bundle-${Date.now()}.js`);
const tempBundlePath = plugins.path.join(tempDir, 'bundle.js');
// Ensure temp directory exists
await plugins.fs.directory(tempDir).create();
@@ -88,6 +88,11 @@ export class CustomBundleHandler {
if (tempFileExists) {
await plugins.fs.file(tempBundlePath).delete();
}
const tempSourceMapPath = `${tempBundlePath}.map`;
const tempSourceMapExists = await plugins.fs.file(tempSourceMapPath).exists();
if (tempSourceMapExists) {
await plugins.fs.file(tempSourceMapPath).delete();
}
}
/**
@@ -105,8 +110,12 @@ export class CustomBundleHandler {
// Add included files
if (bundleConfig.includeFiles && bundleConfig.includeFiles.length > 0) {
for (const pattern of bundleConfig.includeFiles) {
await base64Output.addFilesFromGlob(pattern);
for (const entry of bundleConfig.includeFiles) {
if (typeof entry === 'string') {
await base64Output.addFilesFromGlob(entry);
} else {
await base64Output.addFileWithServePath(entry.from, entry.to);
}
}
}
@@ -135,7 +144,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);
}
}
@@ -171,7 +181,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();
+7 -3
View File
@@ -43,6 +43,7 @@ export class TsBundleProcess {
sourcemap: true,
format: 'esm',
target: 'es2022',
keepNames: true,
entryNames: plugins.path.parse(toArg).name,
outdir: plugins.path.parse(toArg).dir,
splitting: false,
@@ -67,6 +68,7 @@ export class TsBundleProcess {
format: 'esm',
target: 'es2022',
minify: true,
keepNames: true,
entryNames: plugins.path.parse(toArg).name,
outdir: plugins.path.parse(toArg).dir,
tsconfig: paths.tsconfigPath,
@@ -81,9 +83,11 @@ export class TsBundleProcess {
const run = async () => {
try {
console.log('running spawned compilation process');
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(
process.env.transportOptions,
);
const transportOptionsJson = process.env.transportOptions;
if (!transportOptionsJson) {
throw new Error('Missing transportOptions environment variable');
}
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(transportOptionsJson);
console.log('=======> ESBUILD');
console.log(transportOptions);
process.chdir(transportOptions.cwd);
+10 -12
View File
@@ -21,30 +21,28 @@ export class HtmlHandler {
to?: string;
minify?: boolean;
}) {
optionsArg = {
...{
const options = {
from: this.defaultFromPath,
to: this.defaultToPath,
minify: false,
},
...optionsArg,
};
if (await this.checkIfExists()) {
console.log(`${optionsArg.from} replaces file at ${optionsArg.to}`);
console.log(`${options.from} replaces file at ${options.to}`);
}
optionsArg.from = plugins.smartpath.transform.toAbsolute(
optionsArg.from,
options.from = plugins.smartpath.transform.toAbsolute(
options.from,
paths.cwd,
) as string;
optionsArg.to = plugins.smartpath.transform.toAbsolute(
optionsArg.to,
options.to = plugins.smartpath.transform.toAbsolute(
options.to,
paths.cwd,
) as string;
let fileString = (await plugins.fs
.file(optionsArg.from)
.file(options.from)
.encoding('utf8')
.read()) as string;
if (optionsArg.minify) {
if (options.minify) {
fileString = plugins.htmlMinifier.minify(fileString, {
minifyCSS: true,
minifyJS: true,
@@ -56,9 +54,9 @@ export class HtmlHandler {
removeComments: true,
});
}
const toDir = plugins.path.dirname(optionsArg.to);
const toDir = plugins.path.dirname(options.to);
await plugins.fs.directory(toDir).create();
await plugins.fs.file(optionsArg.to).encoding('utf8').write(fileString);
await plugins.fs.file(options.to).encoding('utf8').write(fileString);
console.log(`html processing succeeded!`);
}
}
+23 -21
View File
@@ -36,20 +36,20 @@ const PRESETS: Record<string, { description: string; config: interfaces.IBundleC
export class InitHandler {
private cwd: string;
private npmextraPath: string;
private smartconfigPath: string;
constructor(cwd: string = paths.cwd) {
this.cwd = cwd;
this.npmextraPath = plugins.path.join(this.cwd, 'npmextra.json');
this.smartconfigPath = plugins.path.join(this.cwd, '.smartconfig.json');
}
/**
* Load existing npmextra.json or create empty config
* Load existing .smartconfig.json or create empty config
*/
private async loadExistingConfig(): Promise<any> {
const fileExists = await plugins.fs.file(this.npmextraPath).exists();
const fileExists = await plugins.fs.file(this.smartconfigPath).exists();
if (fileExists) {
const content = (await plugins.fs.file(this.npmextraPath).encoding('utf8').read()) as string;
const content = (await plugins.fs.file(this.smartconfigPath).encoding('utf8').read()) as string;
try {
return JSON.parse(content);
} catch {
@@ -60,12 +60,12 @@ export class InitHandler {
}
/**
* Save config to npmextra.json
* Save config to .smartconfig.json
*/
private async saveConfig(config: any): Promise<void> {
const content = JSON.stringify(config, null, 2);
await plugins.fs.file(this.npmextraPath).encoding('utf8').write(content);
console.log(`\n✅ Configuration saved to npmextra.json`);
await plugins.fs.file(this.smartconfigPath).encoding('utf8').write(content);
console.log(`\n✅ Configuration saved to .smartconfig.json`);
}
/**
@@ -73,15 +73,15 @@ export class InitHandler {
*/
public async runWizard(): Promise<void> {
console.log('\n🚀 tsbundle configuration wizard\n');
console.log('This wizard will help you configure bundle settings in npmextra.json.\n');
console.log('This wizard will help you configure bundle settings in .smartconfig.json.\n');
const npmextraJson = await this.loadExistingConfig();
const smartconfigJson = await this.loadExistingConfig();
if (!npmextraJson['@git.zone/tsbundle']) {
npmextraJson['@git.zone/tsbundle'] = { bundles: [] };
if (!smartconfigJson['@git.zone/tsbundle']) {
smartconfigJson['@git.zone/tsbundle'] = { bundles: [] };
}
const existingBundles = npmextraJson['@git.zone/tsbundle'].bundles || [];
const existingBundles = smartconfigJson['@git.zone/tsbundle'].bundles || [];
if (existingBundles.length > 0) {
console.log(`Found ${existingBundles.length} existing bundle configuration(s):\n`);
@@ -95,7 +95,7 @@ export class InitHandler {
while (addMore) {
const bundle = await this.configureSingleBundle();
if (bundle) {
npmextraJson['@git.zone/tsbundle'].bundles.push(bundle);
smartconfigJson['@git.zone/tsbundle'].bundles.push(bundle);
console.log(`\n✅ Bundle configuration added!`);
}
@@ -112,10 +112,10 @@ export class InitHandler {
addMore = answers.getAnswerFor('addAnother');
}
await this.saveConfig(npmextraJson);
await this.saveConfig(smartconfigJson);
console.log('\n📋 Final configuration:\n');
const bundles = npmextraJson['@git.zone/tsbundle'].bundles;
const bundles = smartconfigJson['@git.zone/tsbundle'].bundles;
bundles.forEach((bundle: interfaces.IBundleConfig, i: number) => {
console.log(` Bundle ${i + 1}:`);
console.log(` From: ${bundle.from}`);
@@ -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[]> {
const includeFiles: string[] = [];
private async configureIncludeFiles(prefill?: interfaces.TIncludeFile[]): Promise<interfaces.TIncludeFile[]> {
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([
+20 -2
View File
@@ -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);
const relativePath = plugins.path.relative(this.cwd, fullPath);
// entry.path may be absolute or relative - handle both cases
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);
}
+7 -5
View File
@@ -53,7 +53,7 @@ export class TsBundleProcess {
entryFileNames: outputFilename,
format: 'es',
sourcemap: true,
inlineDynamicImports: true,
codeSplitting: false,
});
}
@@ -83,16 +83,18 @@ export class TsBundleProcess {
format: 'es',
sourcemap: true,
minify: true,
inlineDynamicImports: true,
codeSplitting: false,
});
}
}
const run = async () => {
console.log('running spawned compilation process');
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(
process.env.transportOptions,
);
const transportOptionsJson = process.env.transportOptions;
if (!transportOptionsJson) {
throw new Error('Missing transportOptions environment variable');
}
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(transportOptionsJson);
console.log('=======> ROLLDOWN');
console.log(transportOptions);
process.chdir(transportOptions.cwd);
+15 -9
View File
@@ -52,6 +52,7 @@ export class TsBundleProcess {
output: {
path: outputDir,
filename: outputFilename,
module: true,
library: {
type: 'module' as const,
},
@@ -86,9 +87,6 @@ export class TsBundleProcess {
},
],
},
experiments: {
outputModule: true,
},
};
return new Promise((resolve, reject) => {
@@ -98,6 +96,10 @@ export class TsBundleProcess {
reject(err);
return;
}
if (!stats) {
reject(new Error('Rspack did not return stats'));
return;
}
if (stats.hasErrors()) {
console.error(stats.toString());
@@ -140,6 +142,7 @@ export class TsBundleProcess {
output: {
path: outputDir,
filename: outputFilename,
module: true,
library: {
type: 'module' as const,
},
@@ -184,9 +187,6 @@ export class TsBundleProcess {
usedExports: true,
sideEffects: true,
},
experiments: {
outputModule: true,
},
};
return new Promise((resolve, reject) => {
@@ -196,6 +196,10 @@ export class TsBundleProcess {
reject(err);
return;
}
if (!stats) {
reject(new Error('Rspack did not return stats'));
return;
}
if (stats.hasErrors()) {
console.error(stats.toString());
@@ -221,9 +225,11 @@ export class TsBundleProcess {
const run = async () => {
console.log('running spawned compilation process');
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(
process.env.transportOptions,
);
const transportOptionsJson = process.env.transportOptions;
if (!transportOptionsJson) {
throw new Error('Missing transportOptions environment variable');
}
const transportOptions: interfaces.IEnvTransportOptions = JSON.parse(transportOptionsJson);
console.log('=======> RSPACK');
console.log(transportOptions);
process.chdir(transportOptions.cwd);
+2 -2
View File
@@ -4,7 +4,7 @@ import * as path from 'path';
export { path };
// pushrocks scope
import * as npmextra from '@push.rocks/npmextra';
import * as smartconfig from '@push.rocks/smartconfig';
import * as smartcli from '@push.rocks/smartcli';
import * as smartfs from '@push.rocks/smartfs';
import * as smartinteract from '@push.rocks/smartinteract';
@@ -15,7 +15,7 @@ import * as smartpromise from '@push.rocks/smartpromise';
import * as smartspawn from '@push.rocks/smartspawn';
export {
npmextra,
smartconfig,
smartcli,
smartfs,
smartinteract,
+1 -1
View File
@@ -5,7 +5,7 @@ import { runInit } from './mod_init/index.js';
export const runCli = async () => {
const tsBundleCli = new plugins.smartcli.Smartcli();
// Default command: run custom bundles from npmextra.json
// Default command: run custom bundles from .smartconfig.json
tsBundleCli.standardCommand().subscribe(async (argvArg) => {
await runCustomBundles();
});
+1 -3
View File
@@ -4,9 +4,7 @@
"module": "NodeNext",
"moduleResolution": "NodeNext",
"esModuleInterop": true,
"verbatimModuleSyntax": true,
"baseUrl": ".",
"paths": {}
"verbatimModuleSyntax": true
},
"exclude": ["dist_*/**/*.d.ts"]
}