backtest-kit 11.8.0 → 12.0.0

package/package.json

@@ -1,86 +1,86 @@
-{
-  "name": "backtest-kit",
-  "version": "11.8.0",
-  "description": "A TypeScript library for trading system backtest",
-  "author": {
-    "name": "Petr Tripolsky",
-    "email": "tripolskypetr@gmail.com",
-    "url": "https://github.com/tripolskypetr"
-  },
-  "funding": {
-    "type": "individual",
-    "url": "http://paypal.me/tripolskypetr"
-  },
-  "license": "MIT",
-  "homepage": "https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html",
-  "keywords": [
-    "backtesting",
-    "backtest",
-    "finance",
-    "trading",
-    "candles",
-    "indicators",
-    "multi value",
-    "multi symbol",
-    "framework"
-  ],
-  "files": [
-    "build",
-    "types.d.ts",
-    "README.md"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/tripolskypetr/backtest-kit",
-    "documentation": "https://github.com/tripolskypetr/backtest-kit/tree/master/docs"
-  },
-  "bugs": {
-    "url": "https://github.com/tripolskypetr/backtest-kit/issues"
-  },
-  "scripts": {
-    "build": "rollup -c",
-    "test": "npm run build && node ./test/index.mjs",
-    "build:docs": "rimraf docs && mkdir docs && node ./scripts/dts-docs.cjs ./types.d.ts ./docs",
-    "docs:gpt": "npm run build && node ./tools/gpt-docs/index.mjs",
-    "docs:uml": "npm run build && node ./scripts/uml.mjs",
-    "docs:www": "rimraf docs/wwwroot && node ./tools/typedoc-packages-docs/index.mjs && typedoc && node ./tools/typedoc-yandex-metrica/index.mjs",
-    "repl": "dotenv -e .env -- npm run build && node -e \"import('./scripts/repl.mjs')\" --interactive"
-  },
-  "main": "build/index.cjs",
-  "module": "build/index.mjs",
-  "source": "src/index.ts",
-  "types": "./types.d.ts",
-  "exports": {
-    "require": "./build/index.cjs",
-    "types": "./types.d.ts",
-    "import": "./build/index.mjs",
-    "default": "./build/index.cjs"
-  },
-  "devDependencies": {
-    "@rollup/plugin-typescript": "11.1.6",
-    "@types/node": "22.9.0",
-    "glob": "11.0.1",
-    "plantuml": "0.0.2",
-    "rimraf": "6.0.1",
-    "rollup": "3.29.5",
-    "rollup-plugin-dts": "6.1.1",
-    "rollup-plugin-peer-deps-external": "2.2.4",
-    "ts-morph": "27.0.2",
-    "tslib": "2.7.0",
-    "typedoc": "0.27.9",
-    "worker-testbed": "2.0.0"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
-  },
-  "dependencies": {
-    "di-kit": "^1.1.1",
-    "di-scoped": "^1.0.21",
-    "di-singleton": "^1.0.5",
-    "functools-kit": "^2.3.0",
-    "get-moment-stamp": "^2.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "backtest-kit",
+  "version": "12.0.0",
+  "description": "A TypeScript library for trading system backtest",
+  "author": {
+    "name": "Petr Tripolsky",
+    "email": "tripolskypetr@gmail.com",
+    "url": "https://github.com/tripolskypetr"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "http://paypal.me/tripolskypetr"
+  },
+  "license": "MIT",
+  "homepage": "https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html",
+  "keywords": [
+    "backtesting",
+    "backtest",
+    "finance",
+    "trading",
+    "candles",
+    "indicators",
+    "multi value",
+    "multi symbol",
+    "framework"
+  ],
+  "files": [
+    "build",
+    "types.d.ts",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tripolskypetr/backtest-kit",
+    "documentation": "https://github.com/tripolskypetr/backtest-kit/tree/master/docs"
+  },
+  "bugs": {
+    "url": "https://github.com/tripolskypetr/backtest-kit/issues"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "test": "npm run build && node ./test/index.mjs",
+    "build:docs": "rimraf docs && mkdir docs && node ./scripts/dts-docs.cjs ./types.d.ts ./docs",
+    "docs:gpt": "npm run build && node ./tools/gpt-docs/index.mjs",
+    "docs:uml": "npm run build && node ./scripts/uml.mjs",
+    "docs:www": "rimraf docs/wwwroot && node ./tools/typedoc-packages-docs/index.mjs && typedoc && node ./tools/typedoc-yandex-metrica/index.mjs",
+    "repl": "dotenv -e .env -- npm run build && node -e \"import('./scripts/repl.mjs')\" --interactive"
+  },
+  "main": "build/index.cjs",
+  "module": "build/index.mjs",
+  "source": "src/index.ts",
+  "types": "./types.d.ts",
+  "exports": {
+    "require": "./build/index.cjs",
+    "types": "./types.d.ts",
+    "import": "./build/index.mjs",
+    "default": "./build/index.cjs"
+  },
+  "devDependencies": {
+    "@rollup/plugin-typescript": "11.1.6",
+    "@types/node": "22.9.0",
+    "glob": "11.0.1",
+    "plantuml": "0.0.2",
+    "rimraf": "6.0.1",
+    "rollup": "3.29.5",
+    "rollup-plugin-dts": "6.1.1",
+    "rollup-plugin-peer-deps-external": "2.2.4",
+    "ts-morph": "27.0.2",
+    "tslib": "2.7.0",
+    "typedoc": "0.27.9",
+    "worker-testbed": "2.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "di-kit": "^1.1.1",
+    "di-scoped": "^1.0.21",
+    "di-singleton": "^1.0.5",
+    "functools-kit": "^2.3.0",
+    "get-moment-stamp": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/types.d.ts

@@ -73,6 +73,8 @@ type FrameInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "
 interface IFrameParams extends IFrameSchema {
     /** Logger service for debug output */
     logger: ILogger;
+    /** Frame name for identification */
+    interval: FrameInterval;
 }
 /**
  * Callbacks for frame lifecycle events.
@@ -113,8 +115,8 @@ interface IFrameSchema {
     frameName: FrameName;
     /** Optional developer note for documentation */
     note?: string;
-    /** Interval for timestamp generation */
-    interval: FrameInterval;
+    /** Interval for time range generation. Defaults to "1m" if not specified */
+    interval?: FrameInterval;
     /** Start of backtest period (inclusive) */
     startDate: Date;
     /** End of backtest period (inclusive) */
@@ -4669,6 +4671,24 @@ interface BacktestStatisticsModel {
     avgWinDuration: number | null;
     /** Average duration in minutes of losing trades. */
     avgLossDuration: number | null;
+    /** Median |close[i] - close[i-1]| / close[i-1] across trade closes, in %. Robust to outliers. */
+    medianStepSize: number | null;
+    /** Fraction of up-moves among decisive close-to-close moves. 0..1. Higher = buyers more frequent. */
+    buyerPressure: number | null;
+    /** Fraction of down-moves among decisive moves. 0..1. Equals 1 - buyerPressure. */
+    sellerPressure: number | null;
+    /** Share of upward absolute movement in total close-to-close movement. 0..1. */
+    buyerStrength: number | null;
+    /** Share of downward absolute movement in total close-to-close movement. 0..1. */
+    sellerStrength: number | null;
+    /** buyerStrength - sellerStrength ∈ [-1, 1]. Positive = bullish bias on magnitude. */
+    pressureImbalance: number | null;
+    /** Bivariate trend classification (slope × R²). */
+    trend: "bullish" | "bearish" | "sideways" | "neutral" | null;
+    /** Log-price regression slope, in %/day. */
+    trendStrength: number | null;
+    /** R² of the log-price regression, in [0, 1]. */
+    trendConfidence: number | null;
 }
 
 /**
@@ -9718,6 +9738,42 @@ declare function getNextCandles(symbol: string, interval: CandleInterval, limit:
  */
 declare function getAggregatedTrades(symbol: string, limit?: number): Promise<IAggregatedTradeData[]>;
 
+/**
+ * Interface for runtime information and range used in backtesting and strategy execution.
+ * The interface defines the time range for the backtest while executing a strategy in backtest mode
+ */
+interface IRuntimeRange {
+    /** Start date of the runtime range */
+    from: Date;
+    /** End date of the runtime range */
+    to: Date;
+}
+/**
+ * Interface for runtime information returned by the RuntimeMetaService.
+ * This includes the symbol being traded, the time range of the backtest, any additional info defined by the strategy,
+ * and contextual information about the exchange, strategy, and frame being used.
+ */
+interface IRuntimeInfo<Data extends RuntimeData = RuntimeData> {
+    /** Trading pair symbol (e.g., "BTCUSDT") */
+    symbol: string;
+    /** Time range for the backtest, null if running in live mode */
+    range: IRuntimeRange | null;
+    /** Additional runtime information defined by the strategy, can be used for custom monitoring or reporting */
+    info: Data | null;
+    /** Contextual information about the current execution environment */
+    context: {
+        exchangeName: ExchangeName;
+        strategyName: StrategyName;
+        frameName: FrameName;
+    };
+    /** Timestamp of the current candle or tick */
+    when: Date;
+    /** Current market price for the symbol at the time of execution */
+    currentPrice: number;
+    /** Whether the strategy is running in backtest mode */
+    backtest: boolean;
+}
+
 /**
  * Gets the current date from execution context.
  *
@@ -9792,6 +9848,30 @@ declare function getSymbol(): Promise<string>;
  * ```
  */
 declare function getContext(): Promise<IMethodContext>;
+/**
+ * Gets runtime information about the current execution environment.
+ *
+ * This includes details such as the current symbol, exchange, timeframe, strategy, and whether it's a backtest or live run.
+ *
+ * @returns Promise resolving to an object containing runtime information
+ * @throws Error if method context or execution context is not active
+ *
+ * @example
+ * ```typescript
+ * const runtimeInfo = await getRuntimeInfo();
+ * console.log(runtimeInfo);
+ * // {
+ * //   symbol: "BTCUSDT",
+ * //   context: {,
+ * //     exchangeName: "Binance",
+ * //     frameName: "1m",
+ * //     strategyName: "MyStrategy",
+ * //   },
+ * //   backtest: false
+ * // }
+ * ```
+ */
+declare function getRuntimeInfo<Data extends RuntimeData = RuntimeData>(): Promise<IRuntimeInfo<Data>>;
 
 type Dispatch$1<Value extends object = object> = (value: Value) => Value | Promise<Value>;
 /**
@@ -10790,6 +10870,24 @@ interface IHeatmapRow {
     expectedYearlyReturns: number | null;
     /** Observed trade frequency extrapolated to one year (signals × 365 / calendarSpanDays). */
     tradesPerYear: number | null;
+    /** Median |close[i] - close[i-1]| / close[i-1] across trade closes, in %. Robust to outliers. */
+    medianStepSize: number | null;
+    /** Fraction of up-moves among decisive close-to-close moves. 0..1. Higher = buyers more frequent. */
+    buyerPressure: number | null;
+    /** Fraction of down-moves among decisive moves. 0..1. Equals 1 - buyerPressure. */
+    sellerPressure: number | null;
+    /** Share of upward absolute movement in total close-to-close movement. 0..1. */
+    buyerStrength: number | null;
+    /** Share of downward absolute movement in total close-to-close movement. 0..1. */
+    sellerStrength: number | null;
+    /** buyerStrength - sellerStrength ∈ [-1, 1]. Positive = bullish bias on magnitude. */
+    pressureImbalance: number | null;
+    /** Bivariate trend classification (slope × R²). */
+    trend: "bullish" | "bearish" | "sideways" | "neutral" | null;
+    /** Log-price regression slope, in %/day. */
+    trendStrength: number | null;
+    /** R² of the log-price regression, in [0, 1]. */
+    trendConfidence: number | null;
 }
 
 /**
@@ -12682,6 +12780,24 @@ interface LiveStatisticsModel {
     avgWinDuration: number | null;
     /** Average duration in minutes of losing trades. */
     avgLossDuration: number | null;
+    /** Median |close[i] - close[i-1]| / close[i-1] across trade closes, in %. Robust to outliers. */
+    medianStepSize: number | null;
+    /** Fraction of up-moves among decisive close-to-close moves. 0..1. Higher = buyers more frequent. */
+    buyerPressure: number | null;
+    /** Fraction of down-moves among decisive moves. 0..1. Equals 1 - buyerPressure. */
+    sellerPressure: number | null;
+    /** Share of upward absolute movement in total close-to-close movement. 0..1. */
+    buyerStrength: number | null;
+    /** Share of downward absolute movement in total close-to-close movement. 0..1. */
+    sellerStrength: number | null;
+    /** buyerStrength - sellerStrength ∈ [-1, 1]. Positive = bullish bias on magnitude. */
+    pressureImbalance: number | null;
+    /** Bivariate trend classification (slope × R²). */
+    trend: "bullish" | "bearish" | "sideways" | "neutral" | null;
+    /** Log-price regression slope, in %/day. */
+    trendStrength: number | null;
+    /** R² of the log-price regression, in [0, 1]. */
+    trendConfidence: number | null;
 }
 
 /**
@@ -26250,42 +26366,6 @@ declare class IntervalUtils {
  */
 declare const Interval: IntervalUtils;
 
-/**
- * Interface for runtime information and range used in backtesting and strategy execution.
- * The interface defines the time range for the backtest while executing a strategy in backtest mode
- */
-interface IRuntimeRange {
-    /** Start date of the runtime range */
-    from: Date;
-    /** End date of the runtime range */
-    to: Date;
-}
-/**
- * Interface for runtime information returned by the RuntimeMetaService.
- * This includes the symbol being traded, the time range of the backtest, any additional info defined by the strategy,
- * and contextual information about the exchange, strategy, and frame being used.
- */
-interface IRuntimeInfo<Data extends RuntimeData = RuntimeData> {
-    /** Trading pair symbol (e.g., "BTCUSDT") */
-    symbol: string;
-    /** Time range for the backtest, null if running in live mode */
-    range: IRuntimeRange | null;
-    /** Additional runtime information defined by the strategy, can be used for custom monitoring or reporting */
-    info: Data | null;
-    /** Contextual information about the current execution environment */
-    context: {
-        exchangeName: ExchangeName;
-        strategyName: StrategyName;
-        frameName: FrameName;
-    };
-    /** Timestamp of the current candle or tick */
-    when: Date;
-    /** Current market price for the symbol at the time of execution */
-    currentPrice: number;
-    /** Whether the strategy is running in backtest mode */
-    backtest: boolean;
-}
-
 /**
  * Callback signature for a cron entry handler.
  *
@@ -33138,6 +33218,7 @@ declare class StrategyCoreService implements TStrategy {
     private readonly strategyValidationService;
     private readonly exchangeValidationService;
     private readonly frameValidationService;
+    private readonly actionValidationService;
     /**
      * Validates strategy and associated risk configuration.
      *
@@ -34782,6 +34863,18 @@ declare class WalkerCommandService implements TWalkerLogicPublicService {
     private readonly strategySchemaService;
     private readonly riskValidationService;
     private readonly actionValidationService;
+    /**
+     * Validates walker and associated strategy configurations.
+     * Memoized to avoid redundant validations for the same walker-exchange-frame combination.
+     *
+     * Strategy/risk/action validation is performed explicitly here in addition to the
+     * cascade inside WalkerValidationService — this is critical-path code and the
+     * redundant check is intentional defense-in-depth.
+     *
+     * @param context - Context with walkerName, exchangeName and frameName
+     * @param methodName - Name of the calling method for error tracking
+     */
+    private validate;
     /**
      * Runs walker comparison for a symbol with context propagation.
      *
@@ -35177,6 +35270,14 @@ declare class LiveCommandService implements TLiveLogicPublicService {
     private readonly strategySchemaService;
     private readonly riskValidationService;
     private readonly actionValidationService;
+    /**
+     * Validates strategy and associated risk configuration.
+     * Memoized to avoid redundant validations for the same strategy-exchange combination.
+     *
+     * @param context - Context with strategyName, exchangeName
+     * @param methodName - Name of the calling method for error tracking
+     */
+    private validate;
     /**
      * Runs live trading for a symbol with context propagation.
      *
@@ -35225,6 +35326,14 @@ declare class BacktestCommandService implements TBacktestLogicPublicService {
     private readonly strategyValidationService;
     private readonly exchangeValidationService;
     private readonly frameValidationService;
+    /**
+     * Validates strategy and associated risk configuration.
+     * Memoized to avoid redundant validations for the same strategy-exchange-frame combination.
+     *
+     * @param context - Context with strategyName, exchangeName and frameName
+     * @param methodName - Name of the calling method for error tracking
+     */
+    private validate;
     /**
      * Runs backtest for a symbol with context propagation.
      *
@@ -35461,6 +35570,36 @@ declare class WalkerValidationService {
      * Injected logger service instance
      */
     private readonly loggerService;
+    /**
+     * @private
+     * @readonly
+     * Injected walker schema service instance
+     */
+    private readonly walkerSchemaService;
+    /**
+     * @private
+     * @readonly
+     * Injected strategy validation service instance
+     */
+    private readonly strategyValidationService;
+    /**
+     * @private
+     * @readonly
+     * Injected strategy schema service instance
+     */
+    private readonly strategySchemaService;
+    /**
+     * @private
+     * @readonly
+     * Injected risk validation service instance
+     */
+    private readonly riskValidationService;
+    /**
+     * @private
+     * @readonly
+     * Injected action validation service instance
+     */
+    private readonly actionValidationService;
     /**
      * @private
      * Map storing walker schemas by walker name
@@ -35473,9 +35612,12 @@ declare class WalkerValidationService {
      */
     addWalker: (walkerName: WalkerName, walkerSchema: IWalkerSchema) => void;
     /**
-     * Validates the existence of a walker
+     * Validates the existence of a walker and its associated strategy configurations.
+     * Each strategy referenced by the walker is validated via StrategyValidationService,
+     * which in turn validates the strategy's risk profiles and actions.
      * @public
      * @throws {Error} If walkerName is not found
+     * @throws {Error} If any referenced strategy (or its risk/actions) is invalid
      * Memoized function to cache validation results
      */
     validate: (walkerName: WalkerName, source: string) => void;
@@ -35724,6 +35866,10 @@ declare class PartialGlobalService implements TPartial {
      * Frame validation service for validating frame existence.
      */
     private readonly frameValidationService;
+    /**
+     * Action validation service for validating action existence.
+     */
+    private readonly actionValidationService;
     /**
      * Validates strategy and associated risk configuration.
      * Memoized to avoid redundant validations for the same strategy-exchange-frame combination.
@@ -35841,6 +35987,10 @@ declare class BreakevenGlobalService implements TBreakeven {
      * Frame validation service for validating frame existence.
      */
     private readonly frameValidationService;
+    /**
+     * Action validation service for validating frame existence.
+     */
+    private readonly actionValidationService;
     /**
      * Validates strategy and associated risk configuration.
      * Memoized to avoid redundant validations for the same strategy-exchange-frame combination.
@@ -37171,4 +37321,13 @@ declare const getTotalClosed: (signal: Signal) => {
     remainingCostBasis: number;
 };
 
-export { ActionBase, type ActivateScheduledCommit, type ActivateScheduledCommitNotification, type ActivePingContract, type AfterEndContract, type AverageBuyCommit, type AverageBuyCommitNotification, Backtest, type BacktestStatisticsModel, type BeforeStartContract, Breakeven, type BreakevenAvailableNotification, type BreakevenCommit, type BreakevenCommitNotification, type BreakevenContract, type BreakevenData, type BreakevenEvent, type BreakevenStatisticsModel, Broker, type BrokerAverageBuyPayload, BrokerBase, type BrokerBreakevenPayload, type BrokerPartialLossPayload, type BrokerPartialProfitPayload, type BrokerSignalClosePayload, type BrokerSignalOpenPayload, type BrokerTrailingStopPayload, type BrokerTrailingTakePayload, Cache, type CancelScheduledCommit, type CancelScheduledCommitNotification, type CandleData, type CandleInterval, type ClosePendingCommit, type ClosePendingCommitNotification, type ColumnConfig, type ColumnModel, type CommitPayload, Constant, type CriticalErrorNotification, Cron, type CronCallback, type CronEntry, type CronHandle, type DoneContract, Dump, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, HighestProfit, type HighestProfitContract, type HighestProfitEvent, type HighestProfitStatisticsModel, type IActionSchema, type IActivateScheduledCommitRow, type IAggregatedTradeData, type IBidData, type IBreakevenCommitRow, type IBroker, type ICandleData, type ICommitRow, type IDumpContext, type IDumpInstance, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type ILog, type ILogEntry, type ILogger, type IMarkdownDumpOptions, type IMemoryInstance, type INotificationUtils, type IOrderBookData, type IPartialLossCommitRow, type IPartialProfitCommitRow, type IPersistBase, type IPersistBreakevenInstance, type IPersistCandleInstance, type IPersistIntervalInstance, type IPersistLogInstance, type IPersistMeasureInstance, type IPersistMemoryInstance, type IPersistNotificationInstance, type IPersistPartialInstance, type IPersistRecentInstance, type IPersistRiskInstance, type IPersistScheduleInstance, type IPersistSessionInstance, type IPersistSignalInstance, type IPersistStateInstance, type IPersistStorageInstance, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IRecentUtils, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IRuntimeInfo, type IRuntimeRange, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISessionInstance, type ISignalDto, type ISignalIntervalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingParams, type ISizingParamsATR, type ISizingParamsFixedPercentage, type ISizingParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStateInstance, type IStorageSignalRow, type IStorageUtils, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IStrategyTickResultWaiting, type ITrailingStopCommitRow, type ITrailingTakeCommitRow, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type IdlePingContract, type InfoErrorNotification, Interval, type IntervalData, Live, type LiveStatisticsModel, Log, type LogData, Lookup, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, MarkdownWriter, MaxDrawdown, type MaxDrawdownContract, type MaxDrawdownEvent, type MaxDrawdownStatisticsModel, type MeasureData, Memory, MemoryBacktest, MemoryBacktestAdapter, type MemoryData, MemoryLive, MemoryLiveAdapter, type MessageModel, type MessageRole, type MessageToolCall, MethodContextService, type MetricStats, Notification, NotificationBacktest, type NotificationData, NotificationLive, type NotificationModel, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossAvailableNotification, type PartialLossCommit, type PartialLossCommitNotification, type PartialLossContract, type PartialProfitAvailableNotification, type PartialProfitCommit, type PartialProfitCommitNotification, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistBreakevenInstance, PersistCandleAdapter, PersistCandleInstance, PersistIntervalAdapter, PersistIntervalInstance, PersistLogAdapter, PersistLogInstance, PersistMeasureAdapter, PersistMeasureInstance, PersistMemoryAdapter, PersistMemoryInstance, PersistNotificationAdapter, PersistNotificationInstance, PersistPartialAdapter, PersistPartialInstance, PersistRecentAdapter, PersistRecentInstance, PersistRiskAdapter, PersistRiskInstance, PersistScheduleAdapter, PersistScheduleInstance, PersistSessionAdapter, PersistSessionInstance, PersistSignalAdapter, PersistSignalInstance, PersistStateAdapter, PersistStateInstance, PersistStorageAdapter, PersistStorageInstance, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Recent, RecentBacktest, type RecentData, RecentLive, Reflect, Report, ReportBase, type ReportName, ReportWriter, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, type RuntimeData, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, Session, SessionBacktest, type SessionData, SessionLive, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInfoContract, type SignalInfoNotification, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, State, StateBacktest, StateBacktestAdapter, type StateData, StateLive, StateLiveAdapter, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, System, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TPersistBreakevenInstanceCtor, type TPersistCandleInstanceCtor, type TPersistIntervalInstanceCtor, type TPersistLogInstanceCtor, type TPersistMeasureInstanceCtor, type TPersistMemoryInstanceCtor, type TPersistNotificationInstanceCtor, type TPersistPartialInstanceCtor, type TPersistRecentInstanceCtor, type TPersistRiskInstanceCtor, type TPersistScheduleInstanceCtor, type TPersistSessionInstanceCtor, type TPersistSignalInstanceCtor, type TPersistStateInstanceCtor, type TPersistStorageInstanceCtor, type TRecentUtilsCtor, type TReportBase, type TSessionInstanceCtor, type TStateInstanceCtor, type TStorageUtilsCtor, type TickEvent, type TrailingStopCommit, type TrailingStopCommitNotification, type TrailingTakeCommit, type TrailingTakeCommitNotification, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, beginContext, beginTime, cacheCandles, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, createSignalState, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getClosePrice, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getRawCandles, getRiskSchema, getScheduledSignal, getSessionData, getSignalState, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, intervalStepMs, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenAfterEnd, listenAfterEndOnce, listenBacktestProgress, listenBeforeStart, listenBeforeStartOnce, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, setSessionData, setSignalState, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toPlainString, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, waitForReady, warmCandles, writeMemory };
+/**
+ * Derives the number of decimal places to show for a price based on the
+ * magnitude of its integer part. Larger prices need fewer decimals; sub-dollar
+ * prices keep full precision.
+ * @param value - The price to derive the decimal scale for
+ * @returns The number of digits after the decimal point
+ */
+declare const getPriceScale: (value: number) => number;
+
+export { ActionBase, type ActivateScheduledCommit, type ActivateScheduledCommitNotification, type ActivePingContract, type AfterEndContract, type AverageBuyCommit, type AverageBuyCommitNotification, Backtest, type BacktestStatisticsModel, type BeforeStartContract, Breakeven, type BreakevenAvailableNotification, type BreakevenCommit, type BreakevenCommitNotification, type BreakevenContract, type BreakevenData, type BreakevenEvent, type BreakevenStatisticsModel, Broker, type BrokerAverageBuyPayload, BrokerBase, type BrokerBreakevenPayload, type BrokerPartialLossPayload, type BrokerPartialProfitPayload, type BrokerSignalClosePayload, type BrokerSignalOpenPayload, type BrokerTrailingStopPayload, type BrokerTrailingTakePayload, Cache, type CancelScheduledCommit, type CancelScheduledCommitNotification, type CandleData, type CandleInterval, type ClosePendingCommit, type ClosePendingCommitNotification, type ColumnConfig, type ColumnModel, type CommitPayload, Constant, type CriticalErrorNotification, Cron, type CronCallback, type CronEntry, type CronHandle, type DoneContract, Dump, type EntityId, Exchange, ExecutionContextService, type FrameInterval, type GlobalConfig, Heat, type HeatmapStatisticsModel, HighestProfit, type HighestProfitContract, type HighestProfitEvent, type HighestProfitStatisticsModel, type IActionSchema, type IActivateScheduledCommitRow, type IAggregatedTradeData, type IBidData, type IBreakevenCommitRow, type IBroker, type ICandleData, type ICommitRow, type IDumpContext, type IDumpInstance, type IExchangeSchema, type IFrameSchema, type IHeatmapRow, type ILog, type ILogEntry, type ILogger, type IMarkdownDumpOptions, type IMemoryInstance, type INotificationUtils, type IOrderBookData, type IPartialLossCommitRow, type IPartialProfitCommitRow, type IPersistBase, type IPersistBreakevenInstance, type IPersistCandleInstance, type IPersistIntervalInstance, type IPersistLogInstance, type IPersistMeasureInstance, type IPersistMemoryInstance, type IPersistNotificationInstance, type IPersistPartialInstance, type IPersistRecentInstance, type IPersistRiskInstance, type IPersistScheduleInstance, type IPersistSessionInstance, type IPersistSignalInstance, type IPersistStateInstance, type IPersistStorageInstance, type IPositionSizeATRParams, type IPositionSizeFixedPercentageParams, type IPositionSizeKellyParams, type IPublicAction, type IPublicCandleData, type IPublicSignalRow, type IRecentUtils, type IReportDumpOptions, type IRiskActivePosition, type IRiskCheckArgs, type IRiskSchema, type IRiskSignalRow, type IRiskValidation, type IRiskValidationFn, type IRiskValidationPayload, type IRuntimeInfo, type IRuntimeRange, type IScheduledSignalCancelRow, type IScheduledSignalRow, type ISessionInstance, type ISignalDto, type ISignalIntervalDto, type ISignalRow, type ISizingCalculateParams, type ISizingCalculateParamsATR, type ISizingCalculateParamsFixedPercentage, type ISizingCalculateParamsKelly, type ISizingParams, type ISizingParamsATR, type ISizingParamsFixedPercentage, type ISizingParamsKelly, type ISizingSchema, type ISizingSchemaATR, type ISizingSchemaFixedPercentage, type ISizingSchemaKelly, type IStateInstance, type IStorageSignalRow, type IStorageUtils, type IStrategyPnL, type IStrategyResult, type IStrategySchema, type IStrategyTickResult, type IStrategyTickResultActive, type IStrategyTickResultCancelled, type IStrategyTickResultClosed, type IStrategyTickResultIdle, type IStrategyTickResultOpened, type IStrategyTickResultScheduled, type IStrategyTickResultWaiting, type ITrailingStopCommitRow, type ITrailingTakeCommitRow, type IWalkerResults, type IWalkerSchema, type IWalkerStrategyResult, type IdlePingContract, type InfoErrorNotification, Interval, type IntervalData, Live, type LiveStatisticsModel, Log, type LogData, Lookup, Markdown, MarkdownFileBase, MarkdownFolderBase, type MarkdownName, MarkdownWriter, MaxDrawdown, type MaxDrawdownContract, type MaxDrawdownEvent, type MaxDrawdownStatisticsModel, type MeasureData, Memory, MemoryBacktest, MemoryBacktestAdapter, type MemoryData, MemoryLive, MemoryLiveAdapter, type MessageModel, type MessageRole, type MessageToolCall, MethodContextService, type MetricStats, Notification, NotificationBacktest, type NotificationData, NotificationLive, type NotificationModel, Partial$1 as Partial, type PartialData, type PartialEvent, type PartialLossAvailableNotification, type PartialLossCommit, type PartialLossCommitNotification, type PartialLossContract, type PartialProfitAvailableNotification, type PartialProfitCommit, type PartialProfitCommitNotification, type PartialProfitContract, type PartialStatisticsModel, Performance, type PerformanceContract, type PerformanceMetricType, type PerformanceStatisticsModel, PersistBase, PersistBreakevenAdapter, PersistBreakevenInstance, PersistCandleAdapter, PersistCandleInstance, PersistIntervalAdapter, PersistIntervalInstance, PersistLogAdapter, PersistLogInstance, PersistMeasureAdapter, PersistMeasureInstance, PersistMemoryAdapter, PersistMemoryInstance, PersistNotificationAdapter, PersistNotificationInstance, PersistPartialAdapter, PersistPartialInstance, PersistRecentAdapter, PersistRecentInstance, PersistRiskAdapter, PersistRiskInstance, PersistScheduleAdapter, PersistScheduleInstance, PersistSessionAdapter, PersistSessionInstance, PersistSignalAdapter, PersistSignalInstance, PersistStateAdapter, PersistStateInstance, PersistStorageAdapter, PersistStorageInstance, Position, PositionSize, type ProgressBacktestContract, type ProgressWalkerContract, Recent, RecentBacktest, type RecentData, RecentLive, Reflect, Report, ReportBase, type ReportName, ReportWriter, Risk, type RiskContract, type RiskData, type RiskEvent, type RiskRejectionNotification, type RiskStatisticsModel, type RuntimeData, Schedule, type ScheduleData, type SchedulePingContract, type ScheduleStatisticsModel, type ScheduledEvent, Session, SessionBacktest, type SessionData, SessionLive, type SignalCancelledNotification, type SignalCloseContract, type SignalClosedNotification, type SignalData, type SignalInfoContract, type SignalInfoNotification, type SignalInterval, type SignalOpenContract, type SignalOpenedNotification, type SignalScheduledNotification, type SignalSyncCloseNotification, type SignalSyncContract, type SignalSyncOpenNotification, State, StateBacktest, StateBacktestAdapter, type StateData, StateLive, StateLiveAdapter, Storage, StorageBacktest, type StorageData, StorageLive, Strategy, type StrategyActionType, type StrategyCancelReason, type StrategyCloseReason, type StrategyCommitContract, type StrategyEvent, type StrategyStatisticsModel, Sync, type SyncEvent, type SyncStatisticsModel, System, type TBrokerCtor, type TDumpInstanceCtor, type TLogCtor, type TMarkdownBase, type TMemoryInstanceCtor, type TNotificationUtilsCtor, type TPersistBase, type TPersistBaseCtor, type TPersistBreakevenInstanceCtor, type TPersistCandleInstanceCtor, type TPersistIntervalInstanceCtor, type TPersistLogInstanceCtor, type TPersistMeasureInstanceCtor, type TPersistMemoryInstanceCtor, type TPersistNotificationInstanceCtor, type TPersistPartialInstanceCtor, type TPersistRecentInstanceCtor, type TPersistRiskInstanceCtor, type TPersistScheduleInstanceCtor, type TPersistSessionInstanceCtor, type TPersistSignalInstanceCtor, type TPersistStateInstanceCtor, type TPersistStorageInstanceCtor, type TRecentUtilsCtor, type TReportBase, type TSessionInstanceCtor, type TStateInstanceCtor, type TStorageUtilsCtor, type TickEvent, type TrailingStopCommit, type TrailingStopCommitNotification, type TrailingTakeCommit, type TrailingTakeCommitNotification, type ValidationErrorNotification, Walker, type WalkerCompleteContract, type WalkerContract, type WalkerMetric, type SignalData$1 as WalkerSignalData, type WalkerStatisticsModel, addActionSchema, addExchangeSchema, addFrameSchema, addRiskSchema, addSizingSchema, addStrategySchema, addWalkerSchema, alignToInterval, beginContext, beginTime, cacheCandles, checkCandles, commitActivateScheduled, commitAverageBuy, commitBreakeven, commitCancelScheduled, commitClosePending, commitPartialLoss, commitPartialLossCost, commitPartialProfit, commitPartialProfitCost, commitSignalNotify, commitTrailingStop, commitTrailingStopCost, commitTrailingTake, commitTrailingTakeCost, createSignalState, dumpAgentAnswer, dumpError, dumpJson, dumpRecord, dumpTable, dumpText, emitters, formatPrice, formatQuantity, get, getActionSchema, getAggregatedTrades, getAveragePrice, getBacktestTimeframe, getBreakeven, getCandles, getClosePrice, getColumns, getConfig, getContext, getDate, getDefaultColumns, getDefaultConfig, getEffectivePriceOpen, getExchangeSchema, getFrameSchema, getLatestSignal, getMaxDrawdownDistancePnlCost, getMaxDrawdownDistancePnlPercentage, getMinutesSinceLatestSignalCreated, getMode, getNextCandles, getOrderBook, getPendingSignal, getPositionActiveMinutes, getPositionCountdownMinutes, getPositionDrawdownMinutes, getPositionEffectivePrice, getPositionEntries, getPositionEntryOverlap, getPositionEstimateMinutes, getPositionHighestMaxDrawdownPnlCost, getPositionHighestMaxDrawdownPnlPercentage, getPositionHighestPnlCost, getPositionHighestPnlPercentage, getPositionHighestProfitBreakeven, getPositionHighestProfitDistancePnlCost, getPositionHighestProfitDistancePnlPercentage, getPositionHighestProfitMinutes, getPositionHighestProfitPrice, getPositionHighestProfitTimestamp, getPositionInvestedCost, getPositionInvestedCount, getPositionLevels, getPositionMaxDrawdownMinutes, getPositionMaxDrawdownPnlCost, getPositionMaxDrawdownPnlPercentage, getPositionMaxDrawdownPrice, getPositionMaxDrawdownTimestamp, getPositionPartialOverlap, getPositionPartials, getPositionPnlCost, getPositionPnlPercent, getPositionWaitingMinutes, getPriceScale, getRawCandles, getRiskSchema, getRuntimeInfo, getScheduledSignal, getSessionData, getSignalState, getSizingSchema, getStrategySchema, getSymbol, getTimestamp, getTotalClosed, getTotalCostClosed, getTotalPercentClosed, getWalkerSchema, hasNoPendingSignal, hasNoScheduledSignal, hasTradeContext, intervalStepMs, investedCostToPercent, backtest as lib, listExchangeSchema, listFrameSchema, listMemory, listRiskSchema, listSizingSchema, listStrategySchema, listWalkerSchema, listenActivePing, listenActivePingOnce, listenAfterEnd, listenAfterEndOnce, listenBacktestProgress, listenBeforeStart, listenBeforeStartOnce, listenBreakevenAvailable, listenBreakevenAvailableOnce, listenDoneBacktest, listenDoneBacktestOnce, listenDoneLive, listenDoneLiveOnce, listenDoneWalker, listenDoneWalkerOnce, listenError, listenExit, listenHighestProfit, listenHighestProfitOnce, listenIdlePing, listenIdlePingOnce, listenMaxDrawdown, listenMaxDrawdownOnce, listenPartialLossAvailable, listenPartialLossAvailableOnce, listenPartialProfitAvailable, listenPartialProfitAvailableOnce, listenPerformance, listenRisk, listenRiskOnce, listenSchedulePing, listenSchedulePingOnce, listenSignal, listenSignalBacktest, listenSignalBacktestOnce, listenSignalLive, listenSignalLiveOnce, listenSignalNotify, listenSignalNotifyOnce, listenSignalOnce, listenStrategyCommit, listenStrategyCommitOnce, listenSync, listenSyncOnce, listenValidation, listenWalker, listenWalkerComplete, listenWalkerOnce, listenWalkerProgress, overrideActionSchema, overrideExchangeSchema, overrideFrameSchema, overrideRiskSchema, overrideSizingSchema, overrideStrategySchema, overrideWalkerSchema, parseArgs, percentDiff, percentToCloseCost, percentValue, readMemory, removeMemory, roundTicks, runInMockContext, searchMemory, set, setColumns, setConfig, setLogger, setSessionData, setSignalState, shutdown, slPercentShiftToPrice, slPriceToPercentShift, stopStrategy, toPlainString, toProfitLossDto, tpPercentShiftToPrice, tpPriceToPercentShift, validate, validateCommonSignal, validatePendingSignal, validateScheduledSignal, validateSignal, waitForCandle, waitForReady, warmCandles, writeMemory };