@backtest-kit/cli 3.3.0 → 3.3.4

package/README.md

@@ -340,6 +340,10 @@ export default class {
   onBreakeven(event) {
     console.log('Breakeven triggered', event.symbol);
   }
+
+  onAverageBuy(event) {
+    console.log('Cost averaging (DCA)', event.symbol);
+  }
 }
 ```
 
@@ -356,6 +360,57 @@ export default class MyModule implements ILiveModule {
 }
 ```
 
+## 📦 Supported Entry Point Formats
+
+`@backtest-kit/cli` automatically detects the format of your strategy file and loads it with the appropriate runtime — no flags or configuration required.
+
+| Format | Extension | Runtime | Use Case |
+|--------|-----------|---------|----------|
+| **TypeScript** | `.ts` | [`tsx`](https://tsx.is/) via `tsImport()` | TypeScript strategies with cross-imports (ESM ↔ CJS) |
+| **ES Module** | `.mjs` | Native `import()` | Modern JavaScript with top-level `await` and ESM syntax |
+| **CommonJS** | `.cjs` | Native `require()` | Legacy or dual-package strategies |
+
+### TypeScript (`.ts`)
+
+Run TypeScript strategy files directly — no `tsc` compilation step needed. Powered by `tsx`, which handles cross-format imports transparently:
+
+```json
+{
+  "scripts": {
+    "backtest": "npx @backtest-kit/cli --backtest ./src/index.ts"
+  },
+  "dependencies": {
+    "@backtest-kit/cli": "latest",
+    "backtest-kit": "latest",
+    "tsx": "latest"
+  }
+}
+```
+
+### ES Module (`.mjs`)
+
+Standard ESM format. Supports top-level `await`, named exports, and `import` syntax:
+
+```json
+{
+  "scripts": {
+    "backtest": "npx @backtest-kit/cli --backtest ./src/index.mjs"
+  }
+}
+```
+
+### CommonJS (`.cjs`)
+
+For projects that compile to or use CommonJS. Loaded via `require()`:
+
+```json
+{
+  "scripts": {
+    "backtest": "npx @backtest-kit/cli --backtest ./dist/index.cjs"
+  }
+}
+```
+
 ## 🌍 Environment Variables
 
 Create a `.env` file in your project root:

package/build/index.cjs

@@ -249,7 +249,15 @@ const REQUIRE_ENTRY_FACTORY = (filePath) => {
 const IMPORT_ENTRY_FACTORY = async (filePath) => {
     await import(url.pathToFileURL(filePath).href);
 };
+const TSX_ENTRY_FACTORY = async (filePath) => {
+    const { tsImport } = await import('tsx/esm/api');
+    await tsImport(url.pathToFileURL(filePath).href, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+};
 const LOAD_ENTRY_FN = async (filePath) => {
+    if (filePath.endsWith('.ts') || filePath.endsWith('.tsx')) {
+        await TSX_ENTRY_FACTORY(filePath);
+        return;
+    }
     if (!REQUIRE_ENTRY_FACTORY(filePath)) {
         await IMPORT_ENTRY_FACTORY(filePath);
     }

package/build/index.mjs

@@ -227,7 +227,15 @@ const REQUIRE_ENTRY_FACTORY = (filePath) => {
 const IMPORT_ENTRY_FACTORY = async (filePath) => {
     await import(pathToFileURL(filePath).href);
 };
+const TSX_ENTRY_FACTORY = async (filePath) => {
+    const { tsImport } = await import('tsx/esm/api');
+    await tsImport(pathToFileURL(filePath).href, import.meta.url);
+};
 const LOAD_ENTRY_FN = async (filePath) => {
+    if (filePath.endsWith('.ts') || filePath.endsWith('.tsx')) {
+        await TSX_ENTRY_FACTORY(filePath);
+        return;
+    }
     if (!REQUIRE_ENTRY_FACTORY(filePath)) {
         await IMPORT_ENTRY_FACTORY(filePath);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "3.3.0",
+  "version": "3.3.4",
   "description": "Zero-boilerplate CLI runner for backtest-kit strategies. Run backtests, paper trading, and live bots with candle cache warming, web dashboard, and Telegram notifications — no setup code required.",
   "author": {
     "name": "Petr Tripolsky",
@@ -58,7 +58,7 @@
     "default": "./build/index.cjs"
   },
   "devDependencies": {
-    "@backtest-kit/ui": "3.3.0",
+    "@backtest-kit/ui": "3.3.2",
     "markdown-it": "14.1.1",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -66,7 +66,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "3.3.1",
+    "backtest-kit": "3.3.2",
     "glob": "11.0.1",
     "rimraf": "6.0.1",
     "rollup": "3.29.5",
@@ -75,13 +75,15 @@
     "ts-morph": "27.0.2",
     "tslib": "2.7.0",
     "typedoc": "0.27.9",
+    "tsx": "4.19.3",
     "worker-testbed": "1.0.12"
   },
   "peerDependencies": {
     "typescript": "^5.0.0",
-    "@backtest-kit/ui": "^3.3.0",
-    "backtest-kit": "^3.3.1",
-    "markdown-it": "^14.1.1"
+    "@backtest-kit/ui": "^3.3.2",
+    "backtest-kit": "^3.3.2",
+    "markdown-it": "^14.1.1",
+    "tsx": "^4.19.3"
   },
   "dependencies": {
     "ccxt": "4.5.39",

package/template/average-buy.mustache

@@ -1,4 +1,4 @@
-**➗ Averaging Entry (DCA)**
+**🪓 Averaging Entry (DCA)**
 
 **Symbol:** `{{symbol}}` ({{position}})