@tradecanvas/chart 1.26.0 → 1.27.0

package/dist/widget/widgetFeatures.d.ts

@@ -7,7 +7,7 @@ import { DrawingMenuAction } from './drawingMenu.js';
  * its menu entries, its command, its keys); a dotted name is one place.
  * The names are a contract: new ones are added, none is renamed.
  */
-export declare const WIDGET_FEATURES: readonly ["toolbar", "sidebar", "statusBar", "alerts", "objectTree", "symbolInfo", "symbolSearch", "settings", "indicatorSettings", "drawingSettings", "dataWindow", "commandPalette", "hotkeySheet", "goToDate", "replay", "screenshot", "copyImage", "shareView", "autoFib", "themeToggle", "fullscreen", "accountPanel", "orderTicket", "bracketOrders", "depthLadder", "layouts", "indicatorTemplates", "compare", "indicatorLegend", "navigation", "customTimeframes", "intervalTyping", "dragDropImport", "hotkeys", "toasts", "toolbar.symbol", "toolbar.symbolInfo", "toolbar.timeframes", "toolbar.timeframeMenu", "toolbar.chartType", "toolbar.indicators", "toolbar.layouts", "toolbar.replay", "toolbar.bracketOrders", "toolbar.depthLadder", "toolbar.accountPanel", "toolbar.objectTree", "toolbar.alerts", "toolbar.screenshot", "toolbar.settings", "toolbar.themeToggle", "toolbar.fullscreen", "sidebar.cursor", "sidebar.favorites", "sidebar.lines", "sidebar.fibonacci", "sidebar.patterns", "sidebar.forecasting", "sidebar.annotation", "sidebar.style", "sidebar.magnet", "sidebar.eraser", "sidebar.zoomArea", "sidebar.stayInDrawing", "sidebar.undo", "sidebar.redo", "sidebar.clear", "statusBar.range", "statusBar.goToDate", "statusBar.market", "statusBar.connection", "statusBar.symbol", "indicatorLegend.values", "indicatorLegend.visibility", "indicatorLegend.settings", "indicatorLegend.remove", "indicatorLegend.more", "pane.move", "pane.collapse", "pane.maximize", "navigation.zoom", "navigation.scroll", "navigation.reset", "menu.chart", "menu.chart.alert", "menu.chart.order", "menu.chart.orderTicket", "menu.chart.horizontalLine", "menu.chart.resetView", "menu.chart.drawings", "menu.chart.exportData", "menu.chart.settings", "menu.chart.scale", "menu.chart.goToDate", "menu.chart.paneScale", "menu.priceAxisAdd", "menu.drawing", "menu.drawing.settings", "menu.drawing.alert", "menu.drawing.order", "menu.drawing.group", "menu.drawing.lock", "menu.drawing.hide", "menu.drawing.duplicate", "menu.drawing.delete", "selectionToolbar", "hotkeys.commandPalette", "hotkeys.symbolSearch", "hotkeys.save", "hotkeys.tools", "hotkeys.invertScale", "hotkeys.goToDate", "hotkeys.help"];
+export declare const WIDGET_FEATURES: readonly ["toolbar", "sidebar", "statusBar", "alerts", "objectTree", "symbolInfo", "symbolSearch", "settings", "indicatorSettings", "drawingSettings", "dataWindow", "commandPalette", "hotkeySheet", "goToDate", "replay", "screenshot", "copyImage", "shareView", "autoFib", "themeToggle", "fullscreen", "accountPanel", "orderTicket", "bracketOrders", "depthLadder", "layouts", "indicatorTemplates", "compare", "indicatorLegend", "navigation", "customTimeframes", "intervalTyping", "dragDropImport", "hotkeys", "toasts", "toolbar.symbol", "toolbar.symbolInfo", "toolbar.timeframes", "toolbar.timeframeMenu", "toolbar.chartType", "toolbar.indicators", "toolbar.layouts", "toolbar.replay", "toolbar.bracketOrders", "toolbar.depthLadder", "toolbar.accountPanel", "toolbar.objectTree", "toolbar.alerts", "toolbar.screenshot", "toolbar.settings", "toolbar.themeToggle", "toolbar.fullscreen", "sidebar.cursor", "sidebar.favorites", "sidebar.lines", "sidebar.fibonacci", "sidebar.patterns", "sidebar.forecasting", "sidebar.annotation", "sidebar.style", "sidebar.magnet", "sidebar.eraser", "sidebar.zoomArea", "sidebar.stayInDrawing", "sidebar.undo", "sidebar.redo", "sidebar.clear", "statusBar.range", "statusBar.goToDate", "statusBar.market", "statusBar.connection", "statusBar.symbol", "statusBar.rangeTimeframe", "indicatorLegend.values", "indicatorLegend.visibility", "indicatorLegend.settings", "indicatorLegend.remove", "indicatorLegend.more", "pane.move", "pane.collapse", "pane.maximize", "navigation.zoom", "navigation.scroll", "navigation.reset", "menu.chart", "menu.chart.alert", "menu.chart.order", "menu.chart.orderTicket", "menu.chart.horizontalLine", "menu.chart.resetView", "menu.chart.drawings", "menu.chart.exportData", "menu.chart.settings", "menu.chart.scale", "menu.chart.goToDate", "menu.chart.paneScale", "menu.priceAxisAdd", "menu.drawing", "menu.drawing.settings", "menu.drawing.alert", "menu.drawing.order", "menu.drawing.group", "menu.drawing.lock", "menu.drawing.hide", "menu.drawing.duplicate", "menu.drawing.delete", "selectionToolbar", "hotkeys.commandPalette", "hotkeys.symbolSearch", "hotkeys.save", "hotkeys.tools", "hotkeys.invertScale", "hotkeys.goToDate", "hotkeys.help"];
 export type WidgetFeature = (typeof WIDGET_FEATURES)[number];
 /** Switches to turn on (`true`) or off (`false`), by name. */
 export type WidgetFeatures = Partial<Record<WidgetFeature, boolean>>;
@@ -19,7 +19,7 @@ export declare const LEGACY_FEATURE_OPTIONS: {
     readonly drawingTools: readonly ["sidebar", "drawingSettings", "hotkeys.tools", "menu.chart.horizontalLine"];
     readonly settings: readonly ["settings"];
     readonly statusBar: readonly ["statusBar", "goToDate"];
-    readonly rangeBar: readonly ["statusBar.range", "goToDate"];
+    readonly rangeBar: readonly ["statusBar.range", "statusBar.rangeTimeframe", "goToDate"];
     readonly indicatorLegend: readonly ["indicatorLegend"];
     readonly fullscreen: readonly ["fullscreen"];
     readonly alerts: readonly ["alerts"];

package/dist/widget/widgetFeatures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetFeatures.d.ts","sourceRoot":"","sources":["../../src/widget/widgetFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,2nEAmClB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AACrE,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AAI1E,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAiB0B,CAAC;AAE9D,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,OAAO,sBAAsB,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAEvF,wGAAwG;AACxG,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC,CAsB3F,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,SAAS,aAAa,EAAE,CAAC,CAc/F,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CASpE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAYjE;AAED,2GAA2G;AAC3G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,CAOlH;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7D;AAeD,0HAA0H;AAC1H,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAEzE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAE1D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CA4BvG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EACjD,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,aAAa,EAAE,CAAC,CAAC,EAC1D,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,EAAE,CAYpB"}
+{"version":3,"file":"widgetFeatures.d.ts","sourceRoot":"","sources":["../../src/widget/widgetFeatures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,upEAqClB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AACrE,+BAA+B;AAC/B,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;AAI1E,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;CAiB0B,CAAC;AAE9D,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,OAAO,sBAAsB,CAAC,CAAC,EAAE,OAAO;CAAE,CAAC;AAEvF,wGAAwG;AACxG,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC,CAsB3F,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,SAAS,aAAa,EAAE,CAAC,CAc/F,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CASpE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAYjE;AAED,2GAA2G;AAC3G,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,CAOlH;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAE7D;AAeD,0HAA0H;AAC1H,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,IAAI,CAEzE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,CAE1D;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CA4BvG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,SAAS,MAAM,EACjD,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,aAAa,EAAE,CAAC,CAAC,EAC1D,KAAK,EAAE,kBAAkB,GACxB,gBAAgB,EAAE,CAYpB"}

package/dist/widget/widgetTimeframes.d.ts

@@ -25,4 +25,32 @@ export declare function initialTimeframeFavorites(available: TimeFrame[], hostDe
 export declare function parseTimeframeInput(text: string): TimeFrame | null;
 /** `list` plus `extra`, without repeats, leaving out what the whitelist excludes, shortest first. */
 export declare function withExtraTimeframes(list: TimeFrame[], extra: TimeFrame[], whitelist?: TimeFrame[]): TimeFrame[];
+/** A range should give each bar at least this many pixels, to read as a candle. */
+export declare const RANGE_MIN_BAR_PX = 2;
+export interface RangeTimeframeQuery {
+    /** The range's span, ms. */
+    spanMs: number;
+    /** Bars of the current timeframe in that span. */
+    barsInSpan: number;
+    /** The plot's width, px. */
+    width: number;
+    current: TimeFrame;
+    /** The timeframe the user picked: a range never goes finer than it. */
+    chosen: TimeFrame;
+    /** The timeframes on offer. */
+    available: readonly TimeFrame[];
+    /** The share of calendar days a daily series has bars on: 5/7 (weekdays) unless said. */
+    dayShare?: number;
+}
+/**
+ * The timeframe a range on the range bar shows in: the finest, from the
+ * user's own up, whose bars for the span get `RANGE_MIN_BAR_PX` each. Five
+ * years of days go to weeks, decades to months; a short range afterwards
+ * comes back to the user's. Bars are counted from the current ones: scaled
+ * for intraday steps (sessions stay the same), from the calendar for days
+ * and longer (days the market trades: `dayShare`). Only the bars loaded
+ * count, so 'All' is the history on hand. None fits: the coarsest. Tick
+ * timeframes stay as they are.
+ */
+export declare function timeframeForRange(q: RangeTimeframeQuery): TimeFrame;
 //# sourceMappingURL=widgetTimeframes.d.ts.map

package/dist/widget/widgetTimeframes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widgetTimeframes.d.ts","sourceRoot":"","sources":["../../src/widget/widgetTimeframes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAAyE,CAAC;AAEnH,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,EAAE,SAAS,EAA0C,CAAC;AAI7F,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAGpD;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAMlG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,EAAE,EACtB,YAAY,CAAC,EAAE,SAAS,EAAE,EAC1B,aAAa,UAAQ,GACpB,SAAS,EAAE,CAKb;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkBlE;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAI/G"}
+{"version":3,"file":"widgetTimeframes.d.ts","sourceRoot":"","sources":["../../src/widget/widgetTimeframes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAAyE,CAAC;AAEnH,iDAAiD;AACjD,eAAO,MAAM,0BAA0B,EAAE,SAAS,EAA0C,CAAC;AAI7F,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAGpD;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAMlG;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,EAAE,EACtB,YAAY,CAAC,EAAE,SAAS,EAAE,EAC1B,aAAa,UAAQ,GACpB,SAAS,EAAE,CAKb;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAkBlE;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAI/G;AAED,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAMlC,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE,SAAS,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAoBnE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradecanvas/chart",
-  "version": "1.26.0",
+  "version": "1.27.0",
   "type": "module",
   "description": "High-performance canvas trading chart with built-in indicators, drawing tools, and real-time streaming. Zero external dependencies.",
   "license": "MIT",
@@ -58,8 +58,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@tradecanvas/commons": "1.26.0",
-    "@tradecanvas/core": "1.26.0"
+    "@tradecanvas/commons": "1.27.0",
+    "@tradecanvas/core": "1.27.0"
   },
   "devDependencies": {
     "jsdom": "^25.0.1",