@backtest-kit/cli 3.3.2 → 3.3.5

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 
-var backtestKit = require('backtest-kit');
+var BacktestKit = require('backtest-kit');
 var functoolsKit = require('functools-kit');
 var fs = require('fs');
 var stackTrace = require('stack-trace');
@@ -23,6 +23,8 @@ var MarkdownIt = require('markdown-it');
 var sanitizeHtml = require('sanitize-html');
 var jsdom = require('jsdom');
 var Mustache = require('mustache');
+var standalone = require('@babel/standalone');
+var pluginUMD = require('@babel/plugin-transform-modules-umd');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceDefault(e) {
@@ -42,6 +44,7 @@ function _interopNamespaceDefault(e) {
     return Object.freeze(n);
 }
 
+var BacktestKit__namespace = /*#__PURE__*/_interopNamespaceDefault(BacktestKit);
 var stackTrace__namespace = /*#__PURE__*/_interopNamespaceDefault(stackTrace);
 
 /**
@@ -75,22 +78,22 @@ var stackTrace__namespace = /*#__PURE__*/_interopNamespaceDefault(stackTrace);
 }
 
 {
-    backtestKit.Storage.enable();
-    backtestKit.Notification.enable();
+    BacktestKit.Storage.enable();
+    BacktestKit.Notification.enable();
 }
 {
-    backtestKit.Markdown.disable();
-    backtestKit.Report.enable();
+    BacktestKit.Markdown.disable();
+    BacktestKit.Report.enable();
 }
 {
-    backtestKit.StorageLive.usePersist();
-    backtestKit.StorageBacktest.useMemory();
+    BacktestKit.StorageLive.usePersist();
+    BacktestKit.StorageBacktest.useMemory();
 }
 {
-    backtestKit.NotificationLive.usePersist();
-    backtestKit.NotificationBacktest.useMemory();
+    BacktestKit.NotificationLive.usePersist();
+    BacktestKit.NotificationBacktest.useMemory();
 }
-backtestKit.setConfig({
+BacktestKit.setConfig({
     CC_MAX_NOTIFICATIONS: 5000,
     CC_MAX_SIGNALS: 750,
 });
@@ -191,6 +194,7 @@ const baseServices$1 = {
     errorService: Symbol('errorService'),
     loggerService: Symbol('loggerService'),
     resolveService: Symbol('resolveService'),
+    babelService: Symbol('babelService'),
 };
 const connectionServices$1 = {
     moduleConnectionService: Symbol('moduleConnectionService'),
@@ -234,8 +238,8 @@ const TYPES = {
 
 const entrySubject = new functoolsKit.BehaviorSubject();
 
-const __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-const __dirname$1 = path.dirname(__filename$1);
+const __filename$2 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const __dirname$1 = path.dirname(__filename$2);
 const require$2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
 const REQUIRE_ENTRY_FACTORY = (filePath) => {
     try {
@@ -247,17 +251,37 @@ const REQUIRE_ENTRY_FACTORY = (filePath) => {
     }
 };
 const IMPORT_ENTRY_FACTORY = async (filePath) => {
-    await import(url.pathToFileURL(filePath).href);
+    {
+        return false;
+    }
+};
+const BABEL_ENTRY_FACTORY = async (filePath, self) => {
+    const code = await fs$1.readFile(filePath, "utf-8");
+    try {
+        await self.babelService.transpileAndRun(code);
+        return true;
+    }
+    catch {
+        return false;
+    }
 };
-const LOAD_ENTRY_FN = async (filePath) => {
-    if (!REQUIRE_ENTRY_FACTORY(filePath)) {
-        await IMPORT_ENTRY_FACTORY(filePath);
+const LOAD_ENTRY_FN = async (filePath, self) => {
+    if (REQUIRE_ENTRY_FACTORY(filePath)) {
+        return;
+    }
+    if (await IMPORT_ENTRY_FACTORY()) {
+        return;
     }
+    if (await BABEL_ENTRY_FACTORY(filePath, self)) {
+        return;
+    }
+    throw new Error(`Failed to load entry point: ${filePath}`);
 };
 let _is_launched = false;
 class ResolveService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
+        this.babelService = inject(TYPES.babelService);
         this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname$1, '..', 'template');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
@@ -274,7 +298,7 @@ class ResolveService {
                 process.chdir(moduleRoot);
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
-                await LOAD_ENTRY_FN(absolutePath);
+                await LOAD_ENTRY_FN(absolutePath, this);
                 await entrySubject.next(absolutePath);
             }
             _is_launched = true;
@@ -304,7 +328,7 @@ var ExchangeName$1 = ExchangeName;
 const ADD_EXCHANGE_FN = (self) => {
     self.loggerService.log("Adding CCXT Binance as a default exchange schema");
     console.warn("Warning: The default exchange schema is set to CCXT Binance. Please make sure to update it according to your needs using --exchange cli param.");
-    backtestKit.addExchangeSchema({
+    BacktestKit.addExchangeSchema({
         exchangeName: ExchangeName$1.DefaultExchange,
         getCandles: async (symbol, interval, since, limit) => {
             const exchange = await getExchange();
@@ -323,7 +347,7 @@ const ADD_EXCHANGE_FN = (self) => {
             const market = exchange.market(symbol);
             const tickSize = market.limits?.price?.min || market.precision?.price;
             if (tickSize !== undefined) {
-                return backtestKit.roundTicks(price, tickSize);
+                return BacktestKit.roundTicks(price, tickSize);
             }
             return exchange.priceToPrecision(symbol, price);
         },
@@ -332,7 +356,7 @@ const ADD_EXCHANGE_FN = (self) => {
             const market = exchange.market(symbol);
             const stepSize = market.limits?.amount?.min || market.precision?.amount;
             if (stepSize !== undefined) {
-                return backtestKit.roundTicks(quantity, stepSize);
+                return BacktestKit.roundTicks(quantity, stepSize);
             }
             return exchange.amountToPrecision(symbol, quantity);
         },
@@ -361,7 +385,7 @@ class ExchangeSchemaService {
         this.loggerService = inject(TYPES.loggerService);
         this.addSchema = functoolsKit.singleshot(async () => {
             this.loggerService.log("exchangeSchemaService addSchema");
-            const { length } = await backtestKit.listExchangeSchema();
+            const { length } = await BacktestKit.listExchangeSchema();
             !length && ADD_EXCHANGE_FN(this);
         });
     }
@@ -438,7 +462,7 @@ const getArgs = functoolsKit.singleshot(() => {
 const ADD_FRAME_FN = (self) => {
     self.loggerService.log("Adding February 2024 as a default frame schema");
     console.warn("Warning: The default frame schema is set to February 2024. Please make sure to update it according to your needs using --frame cli param.");
-    backtestKit.addFrameSchema({
+    BacktestKit.addFrameSchema({
         frameName: FrameName$1.DefaultFrame,
         interval: "1m",
         startDate: new Date("2024-02-01T00:00:00Z"),
@@ -453,7 +477,7 @@ class FrameSchemaService {
             if (!getArgs().values.backtest) {
                 return;
             }
-            const { length } = await backtestKit.listFrameSchema();
+            const { length } = await BacktestKit.listFrameSchema();
             !length && ADD_FRAME_FN(this);
         });
     }
@@ -473,11 +497,11 @@ class SymbolSchemaService {
 
 const notifyFinish = functoolsKit.singleshot(() => {
     let disposeRef;
-    const unLive = backtestKit.listenDoneLive(() => {
+    const unLive = BacktestKit.listenDoneLive(() => {
         console.log("Live trading finished");
         disposeRef && disposeRef();
     });
-    const unBacktest = backtestKit.listenDoneBacktest(() => {
+    const unBacktest = BacktestKit.listenDoneBacktest(() => {
         console.log("Backtest trading finished");
         disposeRef && disposeRef();
     });
@@ -491,7 +515,7 @@ const getEntry = (metaUrl) => {
 
 const notifyVerbose = functoolsKit.singleshot(() => {
     console.log("Using verbose logging...");
-    backtestKit.listenSignal((event) => {
+    BacktestKit.listenSignal((event) => {
         if (event.action === "scheduled") {
             console.log(`[POSITION SCHEDULED] ${event.symbol}`);
             console.log(`  Strategy: ${event.strategyName}`);
@@ -571,9 +595,9 @@ class BacktestMainService {
                 this.frameSchemaService.addSchema();
             }
             const symbol = payload.symbol || "BTCUSDT";
-            const [defaultStrategyName = null] = await backtestKit.listStrategySchema();
-            const [defaultExchangeName = null] = await backtestKit.listExchangeSchema();
-            const [defaultFrameName = null] = await backtestKit.listFrameSchema();
+            const [defaultStrategyName = null] = await BacktestKit.listStrategySchema();
+            const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
+            const [defaultFrameName = null] = await BacktestKit.listFrameSchema();
             const strategyName = payload.strategy || defaultStrategyName?.strategyName;
             if (!strategyName) {
                 throw new Error("Strategy name is required");
@@ -594,7 +618,7 @@ class BacktestMainService {
                 });
             }
             if (payload.verbose) {
-                backtestKit.overrideExchangeSchema({
+                BacktestKit.overrideExchangeSchema({
                     exchangeName,
                     callbacks: {
                         onCandleData(symbol, interval, since) {
@@ -604,7 +628,7 @@ class BacktestMainService {
                 });
                 notifyVerbose();
             }
-            backtestKit.Backtest.background(symbol, {
+            BacktestKit.Backtest.background(symbol, {
                 strategyName,
                 frameName,
                 exchangeName,
@@ -663,8 +687,8 @@ class LiveMainService {
                 this.symbolSchemaService.addSchema();
             }
             const symbol = payload.symbol || "BTCUSDT";
-            const [defaultStrategyName = null] = await backtestKit.listStrategySchema();
-            const [defaultExchangeName = null] = await backtestKit.listExchangeSchema();
+            const [defaultStrategyName = null] = await BacktestKit.listStrategySchema();
+            const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
             const strategyName = payload.strategy || defaultStrategyName?.strategyName;
             if (!strategyName) {
                 throw new Error("Strategy name is required");
@@ -674,7 +698,7 @@ class LiveMainService {
                 throw new Error("Exchange name is required");
             }
             if (payload.verbose) {
-                backtestKit.overrideExchangeSchema({
+                BacktestKit.overrideExchangeSchema({
                     exchangeName,
                     callbacks: {
                         onCandleData(symbol, interval, since) {
@@ -684,7 +708,7 @@ class LiveMainService {
                 });
                 notifyVerbose();
             }
-            backtestKit.Live.background(symbol, {
+            BacktestKit.Live.background(symbol, {
                 strategyName,
                 exchangeName,
             });
@@ -734,8 +758,8 @@ class PaperMainService {
                 this.symbolSchemaService.addSchema();
             }
             const symbol = payload.symbol || "BTCUSDT";
-            const [defaultStrategyName = null] = await backtestKit.listStrategySchema();
-            const [defaultExchangeName = null] = await backtestKit.listExchangeSchema();
+            const [defaultStrategyName = null] = await BacktestKit.listStrategySchema();
+            const [defaultExchangeName = null] = await BacktestKit.listExchangeSchema();
             const strategyName = payload.strategy || defaultStrategyName?.strategyName;
             if (!strategyName) {
                 throw new Error("Strategy name is required");
@@ -745,7 +769,7 @@ class PaperMainService {
                 throw new Error("Exchange name is required");
             }
             if (payload.verbose) {
-                backtestKit.overrideExchangeSchema({
+                BacktestKit.overrideExchangeSchema({
                     exchangeName,
                     callbacks: {
                         onCandleData(symbol, interval, since) {
@@ -755,7 +779,7 @@ class PaperMainService {
                 });
                 notifyVerbose();
             }
-            backtestKit.Live.background(symbol, {
+            BacktestKit.Live.background(symbol, {
                 strategyName,
                 exchangeName,
             });
@@ -865,7 +889,7 @@ class TelegramProviderService {
 
 const CANDLES_LIMIT = 160;
 const GET_CONFIG_FN = async (symbol, interval) => {
-    const candles = await backtestKit.getCandles(symbol, interval, CANDLES_LIMIT);
+    const candles = await BacktestKit.getCandles(symbol, interval, CANDLES_LIMIT);
     const labels = candles.map(({ timestamp }) => new Date(timestamp).toLocaleTimeString("en-US", {
         hour: "2-digit",
         minute: "2-digit",
@@ -1281,7 +1305,7 @@ class TelegramWebService {
 }
 
 const GET_TIMEFRAME_RANGE_FN = async (frameName) => {
-    const frameList = await backtestKit.listFrameSchema();
+    const frameList = await BacktestKit.listFrameSchema();
     const frameSchema = frameList.find((frameSchema) => frameSchema.frameName === frameName);
     if (!frameSchema) {
         throw new Error(`Frame with name ${frameName} not found`);
@@ -1292,7 +1316,7 @@ const GET_TIMEFRAME_RANGE_FN = async (frameName) => {
 const CACHE_CANDLES_FN = functoolsKit.retry(async (interval, dto) => {
     try {
         console.log(`Checking candles cache for ${dto.symbol} ${interval} from ${dto.from} to ${dto.to}`);
-        await backtestKit.checkCandles({
+        await BacktestKit.checkCandles({
             exchangeName: dto.exchangeName,
             from: dto.from,
             to: dto.to,
@@ -1302,7 +1326,7 @@ const CACHE_CANDLES_FN = functoolsKit.retry(async (interval, dto) => {
     }
     catch (error) {
         console.log(`Caching candles for ${dto.symbol} ${interval} from ${dto.from} to ${dto.to}`);
-        await backtestKit.warmCandles({
+        await BacktestKit.warmCandles({
             symbol: dto.symbol,
             exchangeName: dto.exchangeName,
             from: dto.from,
@@ -1459,10 +1483,10 @@ class TelegramLogicService {
         };
         this.connect = functoolsKit.singleshot(() => {
             this.loggerService.log("telegramLogicService connect");
-            const unRisk = backtestKit.listenRisk(async (event) => {
+            const unRisk = BacktestKit.listenRisk(async (event) => {
                 await this.notifyRisk(event);
             });
-            const unSignal = backtestKit.listenSignal(async (event) => {
+            const unSignal = BacktestKit.listenSignal(async (event) => {
                 if (event.action === "scheduled") {
                     await this.notifyScheduled(event);
                     return;
@@ -1480,7 +1504,7 @@ class TelegramLogicService {
                     return;
                 }
             });
-            const unCommit = backtestKit.listenStrategyCommit(async (event) => {
+            const unCommit = BacktestKit.listenStrategyCommit(async (event) => {
                 if (event.action === "trailing-take") {
                     await this.notifyTrailingTake(event);
                     return;
@@ -1623,9 +1647,16 @@ const REQUIRE_MODULE_FACTORY = (fileName) => {
     return null;
 };
 const IMPORT_MODULE_FACTORY = async (fileName) => {
+    {
+        return null;
+    }
+};
+const BABEL_MODULE_FACTORY = async (fileName, self) => {
     for (const variant of getExtVariants(fileName)) {
         try {
-            return await import(variant);
+            const code = await fs$1.readFile(variant, "utf-8");
+            const exports = self.babelService.transpileAndRun(code);
+            return exports.default ?? exports;
         }
         catch {
             continue;
@@ -1645,7 +1676,10 @@ const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
     if ((Ctor = REQUIRE_MODULE_FACTORY(resolvedFile))) {
         return typeof Ctor === "function" ? new Ctor() : Ctor;
     }
-    if ((Ctor = await IMPORT_MODULE_FACTORY(resolvedFile))) {
+    if ((Ctor = await IMPORT_MODULE_FACTORY())) {
+        return typeof Ctor === "function" ? new Ctor() : Ctor;
+    }
+    if ((Ctor = await BABEL_MODULE_FACTORY(resolvedFile, self))) {
         return typeof Ctor === "function" ? new Ctor() : Ctor;
     }
     throw new Error(`Module module import failed for file: ${resolvedFile}`);
@@ -1654,6 +1688,7 @@ class ModuleConnectionService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
+        this.babelService = inject(TYPES.babelService);
         this.getInstance = functoolsKit.memoize(([fileName]) => `${fileName}`, async (fileName) => {
             this.loggerService.log("moduleConnectionService getInstance", {
                 fileName,
@@ -1780,10 +1815,10 @@ class LiveProviderService {
                 console.log("No ./modules/live.module.mjs found, live trading failed to initialize");
                 process.exit(-1);
             });
-            const unRisk = backtestKit.listenRisk(async (event) => {
+            const unRisk = BacktestKit.listenRisk(async (event) => {
                 await this.handleRisk(event);
             });
-            const unSignal = backtestKit.listenSignal(async (event) => {
+            const unSignal = BacktestKit.listenSignal(async (event) => {
                 if (event.action === "scheduled") {
                     await this.handleScheduled(event);
                     return;
@@ -1801,7 +1836,7 @@ class LiveProviderService {
                     return;
                 }
             });
-            const unCommit = backtestKit.listenStrategyCommit(async (event) => {
+            const unCommit = BacktestKit.listenStrategyCommit(async (event) => {
                 if (event.action === "trailing-take") {
                     await this.handleTrailingTake(event);
                     return;
@@ -1847,6 +1882,55 @@ class LiveProviderService {
     }
 }
 
+standalone.registerPlugin("plugin-transform-modules-umd", pluginUMD);
+module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+const __filename$1 = url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+path.dirname(__filename$1);
+const BacktestKitCli = new Proxy({}, {
+    get(_target, prop) {
+        throw new Error(`@backtest-kit/cli is not available in this context (accessed: ${String(prop)})`);
+    },
+});
+class BabelService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.transpile = (code) => {
+            this.loggerService.log("babelService transpile", { codeLen: code.length });
+            const result = standalone.transform(code, {
+                filename: "index.ts",
+                presets: ["env", "typescript"],
+                plugins: [
+                    [
+                        "plugin-transform-modules-umd",
+                        {
+                            globals: {
+                                "backtest-kit": "BacktestKit",
+                                "@backtest-kit/cli": "BacktestKitCli",
+                            },
+                            moduleId: "Executor",
+                        },
+                    ],
+                ],
+                parserOpts: { strictMode: false },
+            });
+            if (!result.code) {
+                throw new Error("BabelService transpile failed");
+            }
+            return result.code;
+        };
+        this.transpileAndRun = (code) => {
+            this.loggerService.log("babelService transpileAndRun", {
+                codeLen: code.length,
+            });
+            const module = { exports: {} };
+            eval(this.transpile(code));
+            return module.exports;
+        };
+    }
+}
+globalThis.BacktestKit = BacktestKit__namespace;
+globalThis.BacktestKitCli = BacktestKitCli;
+
 {
     provide(TYPES.quickchartApiService, () => new QuickchartApiService());
     provide(TYPES.telegramApiService, () => new TelegramApiService());
@@ -1855,6 +1939,7 @@ class LiveProviderService {
     provide(TYPES.errorService, () => new ErrorService());
     provide(TYPES.loggerService, () => new LoggerService());
     provide(TYPES.resolveService, () => new ResolveService());
+    provide(TYPES.babelService, () => new BabelService());
 }
 {
     provide(TYPES.moduleConnectionService, () => new ModuleConnectionService());
@@ -1893,6 +1978,7 @@ const baseServices = {
     errorService: inject(TYPES.errorService),
     loggerService: inject(TYPES.loggerService),
     resolveService: inject(TYPES.resolveService),
+    babelService: inject(TYPES.babelService),
 };
 const connectionServices = {
     moduleConnectionService: inject(TYPES.moduleConnectionService),
@@ -1941,7 +2027,7 @@ const notifyShutdown = functoolsKit.singleshot(async () => {
 
 const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$4);
-    const [running = null] = await backtestKit.Backtest.list();
+    const [running = null] = await BacktestKit.Backtest.list();
     if (!running) {
         return;
     }
@@ -1950,7 +2036,7 @@ const BEFORE_EXIT_FN$4 = functoolsKit.singleshot(async () => {
     if (status === "fulfilled") {
         return;
     }
-    backtestKit.Backtest.stop(symbol, {
+    BacktestKit.Backtest.stop(symbol, {
         exchangeName,
         strategyName,
         frameName,
@@ -1974,7 +2060,7 @@ main$4();
 
 const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$3);
-    const [running = null] = await backtestKit.Live.list();
+    const [running = null] = await BacktestKit.Live.list();
     if (!running) {
         return;
     }
@@ -1983,7 +2069,7 @@ const BEFORE_EXIT_FN$3 = functoolsKit.singleshot(async () => {
     if (status === "fulfilled") {
         return;
     }
-    backtestKit.Live.stop(symbol, {
+    BacktestKit.Live.stop(symbol, {
         exchangeName,
         strategyName,
     });
@@ -2006,7 +2092,7 @@ main$3();
 
 const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     process.off("SIGINT", BEFORE_EXIT_FN$2);
-    const [running = null] = await backtestKit.Live.list();
+    const [running = null] = await BacktestKit.Live.list();
     if (!running) {
         return;
     }
@@ -2015,11 +2101,11 @@ const BEFORE_EXIT_FN$2 = functoolsKit.singleshot(async () => {
     if (status === "fulfilled") {
         return;
     }
-    backtestKit.Live.stop(symbol, {
+    BacktestKit.Live.stop(symbol, {
         exchangeName,
         strategyName,
     });
-    backtestKit.listenDoneLive(cli.liveProviderService.disable);
+    BacktestKit.listenDoneLive(cli.liveProviderService.disable);
 });
 const listenGracefulShutdown$2 = functoolsKit.singleshot(() => {
     process.on("SIGINT", BEFORE_EXIT_FN$2);

package/build/index.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import * as BacktestKit from 'backtest-kit';
 import { Storage, Notification, Markdown, Report, StorageLive, StorageBacktest, NotificationLive, NotificationBacktest, setConfig, listExchangeSchema, addExchangeSchema, roundTicks, listFrameSchema, addFrameSchema, listenDoneLive, listenDoneBacktest, listenSignal, listStrategySchema, overrideExchangeSchema, Backtest, Live, getCandles, checkCandles, warmCandles, listenRisk, listenStrategyCommit } from 'backtest-kit';
 import { getErrorMessage, errorData, singleshot, str, BehaviorSubject, compose, execpool, queued, sleep, randomString, createAwaiter, TIMEOUT_SYMBOL, typo, retry, memoize, trycatch } from 'functools-kit';
 import fs, { constants } from 'fs';
@@ -21,6 +22,8 @@ import MarkdownIt from 'markdown-it';
 import sanitizeHtml from 'sanitize-html';
 import { JSDOM } from 'jsdom';
 import Mustache from 'mustache';
+import { registerPlugin, transform } from '@babel/standalone';
+import pluginUMD from '@babel/plugin-transform-modules-umd';
 
 /**
  * Fix for `Attempted to assign to readonly property (at redactToken)`
@@ -169,6 +172,7 @@ const baseServices$1 = {
     errorService: Symbol('errorService'),
     loggerService: Symbol('loggerService'),
     resolveService: Symbol('resolveService'),
+    babelService: Symbol('babelService'),
 };
 const connectionServices$1 = {
     moduleConnectionService: Symbol('moduleConnectionService'),
@@ -212,30 +216,50 @@ const TYPES = {
 
 const entrySubject = new BehaviorSubject();
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const require$1 = createRequire(import.meta.url);
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename$1);
+createRequire(import.meta.url);
 const REQUIRE_ENTRY_FACTORY = (filePath) => {
+    {
+        return false;
+    }
+};
+const IMPORT_ENTRY_FACTORY = async (filePath) => {
     try {
-        require$1(filePath);
+        await import(pathToFileURL(filePath).href);
         return true;
     }
     catch {
         return false;
     }
 };
-const IMPORT_ENTRY_FACTORY = async (filePath) => {
-    await import(pathToFileURL(filePath).href);
+const BABEL_ENTRY_FACTORY = async (filePath, self) => {
+    const code = await fs$1.readFile(filePath, "utf-8");
+    try {
+        await self.babelService.transpileAndRun(code);
+        return true;
+    }
+    catch {
+        return false;
+    }
 };
-const LOAD_ENTRY_FN = async (filePath) => {
-    if (!REQUIRE_ENTRY_FACTORY(filePath)) {
-        await IMPORT_ENTRY_FACTORY(filePath);
+const LOAD_ENTRY_FN = async (filePath, self) => {
+    if (REQUIRE_ENTRY_FACTORY()) {
+        return;
+    }
+    if (await IMPORT_ENTRY_FACTORY(filePath)) {
+        return;
+    }
+    if (await BABEL_ENTRY_FACTORY(filePath, self)) {
+        return;
     }
+    throw new Error(`Failed to load entry point: ${filePath}`);
 };
 let _is_launched = false;
 class ResolveService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
+        this.babelService = inject(TYPES.babelService);
         this.DEFAULT_TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
         this.OVERRIDE_TEMPLATE_DIR = path.resolve(process.cwd(), 'template');
         this.OVERRIDE_MODULES_DIR = path.resolve(process.cwd(), 'modules');
@@ -252,7 +276,7 @@ class ResolveService {
                 process.chdir(moduleRoot);
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
-                await LOAD_ENTRY_FN(absolutePath);
+                await LOAD_ENTRY_FN(absolutePath, this);
                 await entrySubject.next(absolutePath);
             }
             _is_launched = true;
@@ -1583,16 +1607,21 @@ class TelegramTemplateService {
     }
 }
 
-const require = createRequire(import.meta.url);
+createRequire(import.meta.url);
 const getExtVariants = (fileName) => {
     const ext = path.extname(fileName);
     const base = ext ? fileName.slice(0, -ext.length) : fileName;
     return [fileName, `${base}.cjs`, `${base}.mjs`];
 };
 const REQUIRE_MODULE_FACTORY = (fileName) => {
+    {
+        return null;
+    }
+};
+const IMPORT_MODULE_FACTORY = async (fileName) => {
     for (const variant of getExtVariants(fileName)) {
         try {
-            return require(variant);
+            return await import(pathToFileURL(variant).href);
         }
         catch {
             continue;
@@ -1600,10 +1629,12 @@ const REQUIRE_MODULE_FACTORY = (fileName) => {
     }
     return null;
 };
-const IMPORT_MODULE_FACTORY = async (fileName) => {
+const BABEL_MODULE_FACTORY = async (fileName, self) => {
     for (const variant of getExtVariants(fileName)) {
         try {
-            return await import(variant);
+            const code = await fs$1.readFile(variant, "utf-8");
+            const exports = self.babelService.transpileAndRun(code);
+            return exports.default ?? exports;
         }
         catch {
             continue;
@@ -1620,18 +1651,22 @@ const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
         .then(() => true)
         .catch(() => false);
     const resolvedFile = hasOverride ? overridePath : targetPath;
-    if ((Ctor = REQUIRE_MODULE_FACTORY(resolvedFile))) {
+    if ((Ctor = REQUIRE_MODULE_FACTORY())) {
         return typeof Ctor === "function" ? new Ctor() : Ctor;
     }
     if ((Ctor = await IMPORT_MODULE_FACTORY(resolvedFile))) {
         return typeof Ctor === "function" ? new Ctor() : Ctor;
     }
+    if ((Ctor = await BABEL_MODULE_FACTORY(resolvedFile, self))) {
+        return typeof Ctor === "function" ? new Ctor() : Ctor;
+    }
     throw new Error(`Module module import failed for file: ${resolvedFile}`);
 };
 class ModuleConnectionService {
     constructor() {
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
+        this.babelService = inject(TYPES.babelService);
         this.getInstance = memoize(([fileName]) => `${fileName}`, async (fileName) => {
             this.loggerService.log("moduleConnectionService getInstance", {
                 fileName,
@@ -1825,6 +1860,55 @@ class LiveProviderService {
     }
 }
 
+registerPlugin("plugin-transform-modules-umd", pluginUMD);
+createRequire(import.meta.url);
+const __filename = fileURLToPath(import.meta.url);
+path.dirname(__filename);
+const BacktestKitCli = new Proxy({}, {
+    get(_target, prop) {
+        throw new Error(`@backtest-kit/cli is not available in this context (accessed: ${String(prop)})`);
+    },
+});
+class BabelService {
+    constructor() {
+        this.loggerService = inject(TYPES.loggerService);
+        this.transpile = (code) => {
+            this.loggerService.log("babelService transpile", { codeLen: code.length });
+            const result = transform(code, {
+                filename: "index.ts",
+                presets: ["env", "typescript"],
+                plugins: [
+                    [
+                        "plugin-transform-modules-umd",
+                        {
+                            globals: {
+                                "backtest-kit": "BacktestKit",
+                                "@backtest-kit/cli": "BacktestKitCli",
+                            },
+                            moduleId: "Executor",
+                        },
+                    ],
+                ],
+                parserOpts: { strictMode: false },
+            });
+            if (!result.code) {
+                throw new Error("BabelService transpile failed");
+            }
+            return result.code;
+        };
+        this.transpileAndRun = (code) => {
+            this.loggerService.log("babelService transpileAndRun", {
+                codeLen: code.length,
+            });
+            const module = { exports: {} };
+            eval(this.transpile(code));
+            return module.exports;
+        };
+    }
+}
+globalThis.BacktestKit = BacktestKit;
+globalThis.BacktestKitCli = BacktestKitCli;
+
 {
     provide(TYPES.quickchartApiService, () => new QuickchartApiService());
     provide(TYPES.telegramApiService, () => new TelegramApiService());
@@ -1833,6 +1917,7 @@ class LiveProviderService {
     provide(TYPES.errorService, () => new ErrorService());
     provide(TYPES.loggerService, () => new LoggerService());
     provide(TYPES.resolveService, () => new ResolveService());
+    provide(TYPES.babelService, () => new BabelService());
 }
 {
     provide(TYPES.moduleConnectionService, () => new ModuleConnectionService());
@@ -1871,6 +1956,7 @@ const baseServices = {
     errorService: inject(TYPES.errorService),
     loggerService: inject(TYPES.loggerService),
     resolveService: inject(TYPES.resolveService),
+    babelService: inject(TYPES.babelService),
 };
 const connectionServices = {
     moduleConnectionService: inject(TYPES.moduleConnectionService),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "3.3.2",
+  "version": "3.3.5",
   "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,8 +58,10 @@
     "default": "./build/index.cjs"
   },
   "devDependencies": {
+    "@babel/plugin-transform-modules-umd": "7.27.1",
+    "@babel/standalone": "7.29.1",
     "@backtest-kit/ui": "3.3.2",
-    "markdown-it": "14.1.1",
+    "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
     "@types/jsdom": "21.1.7",
@@ -68,6 +70,7 @@
     "@types/stack-trace": "0.0.33",
     "backtest-kit": "3.3.2",
     "glob": "11.0.1",
+    "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
     "rollup": "3.29.5",
     "rollup-plugin-dts": "6.1.1",
@@ -78,10 +81,12 @@
     "worker-testbed": "1.0.12"
   },
   "peerDependencies": {
-    "typescript": "^5.0.0",
+    "@babel/plugin-transform-modules-umd": "^7.27.1",
+    "@babel/standalone": "^7.29.1",
     "@backtest-kit/ui": "^3.3.2",
     "backtest-kit": "^3.3.2",
-    "markdown-it": "^14.1.1"
+    "markdown-it": "^14.1.1",
+    "typescript": "^5.0.0"
   },
   "dependencies": {
     "ccxt": "4.5.39",

package/types.d.ts

@@ -1,4 +1,5 @@
 import * as functools_kit from 'functools-kit';
+import * as BacktestKit from 'backtest-kit';
 import { CandleInterval, TrailingTakeCommit, TrailingStopCommit, BreakevenCommit, PartialProfitCommit, PartialLossCommit, IStrategyTickResultScheduled, IStrategyTickResultCancelled, IStrategyTickResultOpened, IStrategyTickResultClosed, RiskContract, AverageBuyCommit } from 'backtest-kit';
 import { Input } from 'telegraf';
 
@@ -85,8 +86,22 @@ declare class FrameSchemaService {
     addSchema: (() => Promise<void>) & functools_kit.ISingleshotClearable;
 }
 
+declare const BacktestKitCli: {};
+declare global {
+    interface Window {
+        BacktestKit: typeof BacktestKit;
+        BacktestKitCli: typeof BacktestKitCli;
+    }
+}
+declare class BabelService {
+    readonly loggerService: LoggerService;
+    transpile: (code: string) => any;
+    transpileAndRun: (code: string) => Record<string, unknown>;
+}
+
 declare class ResolveService {
-    private readonly loggerService;
+    readonly loggerService: LoggerService;
+    readonly babelService: BabelService;
     readonly DEFAULT_TEMPLATE_DIR: string;
     readonly OVERRIDE_TEMPLATE_DIR: string;
     readonly OVERRIDE_MODULES_DIR: string;
@@ -203,6 +218,7 @@ type TBaseModuleCtor = new () => BaseModule;
 declare class ModuleConnectionService {
     readonly loggerService: LoggerService;
     readonly resolveService: ResolveService;
+    readonly babelService: BabelService;
     getInstance: ((fileName: string) => Promise<BaseModule>) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, Promise<Partial<ILiveModule>>>;
 }
 
@@ -243,6 +259,7 @@ declare const cli: {
     errorService: ErrorService;
     loggerService: LoggerService;
     resolveService: ResolveService;
+    babelService: BabelService;
     telegramApiService: TelegramApiService;
     quickchartApiService: QuickchartApiService;
 };