@trdrs/quickcharts 5.8.0 → 5.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +204 -26
  3. package/dist/{ar-N6ZTWN65.js → ar-CFMLQMWS.js} +99 -13
  4. package/dist/ar-CFMLQMWS.js.map +1 -0
  5. package/dist/{assets-BFaYQSN_.d.ts → assets-_zQbuobs.d.ts} +149 -18
  6. package/dist/{ca_ES-VHYHWEYE.js → ca_ES-OTOMJJ2G.js} +99 -13
  7. package/dist/ca_ES-OTOMJJ2G.js.map +1 -0
  8. package/dist/{chunk-6OLK55Q2.js → chunk-3GGBHQAE.js} +1 -1
  9. package/dist/chunk-3GGBHQAE.js.map +1 -0
  10. package/dist/{chunk-ETG46YGK.js → chunk-NWUGE6XN.js} +57 -69
  11. package/dist/chunk-NWUGE6XN.js.map +1 -0
  12. package/dist/{de-IYDL4R7X.js → de-BJ5E7LGZ.js} +98 -12
  13. package/dist/de-BJ5E7LGZ.js.map +1 -0
  14. package/dist/drawings.d.ts +2 -2
  15. package/dist/drawings.js +1 -1
  16. package/dist/{es-LBKNPA3H.js → es-PO36YPXJ.js} +99 -13
  17. package/dist/es-PO36YPXJ.js.map +1 -0
  18. package/dist/feature-manifest.json +84 -1
  19. package/dist/format.d.ts +2 -2
  20. package/dist/format.js +1 -1
  21. package/dist/{fr-MHNDYCBF.js → fr-A4WAZ3K4.js} +99 -13
  22. package/dist/fr-A4WAZ3K4.js.map +1 -0
  23. package/dist/{he_IL-BMEFQ3ZN.js → he_IL-Q3BO4MEG.js} +99 -13
  24. package/dist/he_IL-Q3BO4MEG.js.map +1 -0
  25. package/dist/{id_ID-TXN53FZX.js → id_ID-K22OKQPH.js} +99 -13
  26. package/dist/id_ID-K22OKQPH.js.map +1 -0
  27. package/dist/index.d.ts +506 -229
  28. package/dist/index.js +1808 -1051
  29. package/dist/index.js.map +1 -1
  30. package/dist/{it-OGBC7TOS.js → it-DPPNAWOV.js} +99 -13
  31. package/dist/it-DPPNAWOV.js.map +1 -0
  32. package/dist/{ja-53733PVE.js → ja-U7C5N3LG.js} +98 -12
  33. package/dist/ja-U7C5N3LG.js.map +1 -0
  34. package/dist/{ko-3VKR42AF.js → ko-5LFLZG7S.js} +99 -13
  35. package/dist/ko-5LFLZG7S.js.map +1 -0
  36. package/dist/{ms_MY-MS365YCK.js → ms_MY-H75T2Q5A.js} +99 -13
  37. package/dist/ms_MY-H75T2Q5A.js.map +1 -0
  38. package/dist/{pl-LW3WQV2B.js → pl-3YOKB2BS.js} +99 -13
  39. package/dist/pl-3YOKB2BS.js.map +1 -0
  40. package/dist/{pt-ODOVBTAY.js → pt-PEX6C6L5.js} +99 -13
  41. package/dist/pt-PEX6C6L5.js.map +1 -0
  42. package/dist/quickcharts.css +482 -214
  43. package/dist/{ru-IPHJS4OI.js → ru-4NPNXA7E.js} +99 -13
  44. package/dist/ru-4NPNXA7E.js.map +1 -0
  45. package/dist/{sv-EPVCTIWY.js → sv-BY5AK2AT.js} +99 -13
  46. package/dist/sv-BY5AK2AT.js.map +1 -0
  47. package/dist/{symbology-D3SLclrU.d.ts → symbology-BfPxIJjT.d.ts} +8 -5
  48. package/dist/{symbols-CCYUK8MU.d.ts → symbols-BxtRs6Uu.d.ts} +6 -1
  49. package/dist/symbols.d.ts +2 -2
  50. package/dist/{th-QONC4EYZ.js → th-ITZ7VOMZ.js} +99 -13
  51. package/dist/th-ITZ7VOMZ.js.map +1 -0
  52. package/dist/theme-manifest.json +163 -20
  53. package/dist/{tr-JIO34LZJ.js → tr-D4GW77TN.js} +99 -13
  54. package/dist/tr-D4GW77TN.js.map +1 -0
  55. package/dist/{vi-6TAWAJKM.js → vi-H4RJW4FL.js} +99 -13
  56. package/dist/vi-H4RJW4FL.js.map +1 -0
  57. package/dist/{zh-2BABI2QN.js → zh-3QGRRBGK.js} +98 -12
  58. package/dist/zh-3QGRRBGK.js.map +1 -0
  59. package/dist/{zh_TW-L2X3VH4E.js → zh_TW-45CVENDQ.js} +98 -12
  60. package/dist/zh_TW-45CVENDQ.js.map +1 -0
  61. package/package.json +1 -1
  62. package/dist/ar-N6ZTWN65.js.map +0 -1
  63. package/dist/ca_ES-VHYHWEYE.js.map +0 -1
  64. package/dist/chunk-6OLK55Q2.js.map +0 -1
  65. package/dist/chunk-ETG46YGK.js.map +0 -1
  66. package/dist/de-IYDL4R7X.js.map +0 -1
  67. package/dist/es-LBKNPA3H.js.map +0 -1
  68. package/dist/fr-MHNDYCBF.js.map +0 -1
  69. package/dist/he_IL-BMEFQ3ZN.js.map +0 -1
  70. package/dist/id_ID-TXN53FZX.js.map +0 -1
  71. package/dist/it-OGBC7TOS.js.map +0 -1
  72. package/dist/ja-53733PVE.js.map +0 -1
  73. package/dist/ko-3VKR42AF.js.map +0 -1
  74. package/dist/ms_MY-MS365YCK.js.map +0 -1
  75. package/dist/pl-LW3WQV2B.js.map +0 -1
  76. package/dist/pt-ODOVBTAY.js.map +0 -1
  77. package/dist/ru-IPHJS4OI.js.map +0 -1
  78. package/dist/sv-EPVCTIWY.js.map +0 -1
  79. package/dist/th-QONC4EYZ.js.map +0 -1
  80. package/dist/tr-JIO34LZJ.js.map +0 -1
  81. package/dist/vi-6TAWAJKM.js.map +0 -1
  82. package/dist/zh-2BABI2QN.js.map +0 -1
  83. package/dist/zh_TW-L2X3VH4E.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,32 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ A pane's own buttons at its top right are where a pane is moved, collapsed and maximized, and a legend row carries its eye, its settings and its remove. The buttons fade in while the pointer is anywhere over their pane, its legend and the buttons themselves included, and stand still as the pointer moves onto them. A collapsed pane is a strip of its legend and its buttons that paints nothing else, all four buttons kept and its collapse pressed. A maximized pane, the main one included, takes the chart's whole height while the other panes, their legend rows and buttons, and the dividers stand hidden; it keeps its moves and its restore, which gives every pane back the share it held, a collapsed one its strip. A pressed button stands inverted. A hidden indicator keeps its pane and its legend row and paints none of its plots, levels and fills, and an indicator kept off the timeframe on screen does the same. The buttons wear new glyphs, and a move's arrow, a collapse and a maximize stir on hover. The line between stacked panes takes the new role `canvas.paneDivider`, `#222222` in the dark palette and `#ebebeb` in the light one, and the new role `canvas.paneDividerHover` colors the band over it under the pointer.
6
+
7
+ The indicator settings dialog stands in the drawing dialog's frame, with its fields: Inputs, Style and Visibility pages, then a Defaults menu, Cancel and Ok. Every edit previews on the chart at once, and Ok commits the session as one `chart.indicators.update`, so it is one step of the chart's history; Cancel, Escape, the corner close and a press outside put the indicator back. The dialog lays out any definition from its manifest. `ManifestInput` gains `title`, the words it is labelled with, `group`, the heading it stands under with the inputs beside it that name the same group, `step`, `enabledWhen`, the values of another input under which it applies (it stands disabled under the others), and the kind `bool`, a switch held as 1 or 0. `ManifestPlot`, `ManifestLevel` and `ManifestFill` gain `title`. The Style page shows every plot, level and fill behind the checkbox that shows it, with its color and its line, a level with its value and a plot drawn in two colors with a row for each, then the values the indicator writes on the price scale and in the status line. The Visibility page holds the drawing dialog's timeframe ranges, and `IndicatorOverrides.visibility` keeps an indicator off the timeframes it leaves out while its legend row stays. The Defaults menu resets the indicator to its definition's own settings, or keeps its inputs and look, in the chart's storage, as the ones the definition's next instance opens with when it is added with no inputs and no overrides of its own. The built-ins title and group their inputs as their settings show them, hold a switch where they held a No and Yes list, and read their sources as Close, Open, High, Low, (H + L)/2, (H + L + C)/3 and (O + H + L + C)/4. The legend's input readout leaves out a switch and an input that does not apply, and the inputs-only editor holds the dialog's Inputs page. The catalog gains `settings.growing`, `settings.falling`, `settings.outputValues`, `settings.inputValues`, `settings.valuesInStatusLine`, `settings.inputsInStatusLine`, `settings.defaults`, `settings.resetSettings`, `settings.saveAsDefault` and `settings.indicatorPinnedNote`.
8
+
9
+ ## 5.10.0
10
+
11
+ The legend's market status, its popup, the session shading and the trading-hours choice read each market from its own session facts. A `24x7` symbol is always open, offers no choice and shades nothing. A symbol with no subsessions has one weekly session: it offers no choice and shades nothing, and its status is open or closed with a countdown. An electronic day, a `regular` subsession that differs from the symbol's `session`, which then states the whole electronic trading day (`SessionModel.electronic`), classifies every stretch outside regular hours as `extended` and reads the whole day as open in the status, the timeline and the countdown; it offers Electronic trading hours and Regular trading hours, and shades every stretch outside regular hours in the one color of `symbol.electronicColor`. A split day states its regular hours as `session` with pre-market and post-market around them, and offers Regular, Extended and, for a symbol that declares the new `overnight` subsession (`SubsessionId`, read from a UDF feed too), 24 hours, which is `symbol.session` of `allHours` and shades the overnight stretch in the night color. A closed trading day the symbol lists in `sessionHolidays` with no correction is a holiday (`MarketStatus.holiday`).
12
+
13
+ `MarketStatus.phase` names what a status says: open, pre-market, post-market, overnight (the `extended` state of a split day that names pre-market and post-market or trades overnight), extended hours, closed or holiday, and `MarketStatus.next.phase` names the next one. `marketStatusSentence` says what the phase means, `marketStatusCountdown` counts down to the next transition named for where the market goes ("It'll close in 7 hours and 56 minutes."), and `marketStatusText` joins the two through `status.textPair`. `dataStatusNotice` words a delayed or end-of-day feed beside the market's phase, and `marketStatusTitle` names the market's phase whatever the feed's liveness. `SessionTimeline.before` and `SessionTimeline.after` state the minute either side of the day. `tradingHoursOptions` lists the trading-hours choices a symbol offers, each the `symbol.session` it writes with its name and short name as catalog keys, and `tradingHoursOption` finds the one a setting stands for.
14
+
15
+ The legend wears a status mark after the symbol's facts, an 18px round badge with the phase's glyph in its ink over a circle of its tint, and a second one 4px beside it for a delayed or end-of-day feed. The popup they open is 344px wide with one section per mark, the market's first: the badge, the title in the phase's ink, the sentence with the countdown in bold, the exchange day's timeline with each stretch rounded on its own, closed stretches in the track's color, the now marker cut out of the track, the start and end of the stretch now stands in, and the exchange timezone. The data's section stands under a rule. The price scale's menu gains a Session flyout after the plus, with the trading hours the symbol offers and the active one checked, the bottom bar's picker names the trading hours shown as ETH, RTH or 24H, and the bottom bar, the flyout and the settings page list the same choices in the symbol's own words. `chart.subsession.extended` is offered from 24 hours as well.
16
+
17
+ The icon inventory gains `marketPreMarket`, `marketAfterHours` (post-market, overnight and extended hours), `marketClosed`, `marketHoliday`, `dataDelayed` and `dataEndOfDay`, and `marketStatus` draws the open market's dot. The status roles take new values (`status.sessionPreMarket` `#ff9100` and `#ef6c00`, `status.sessionOpen` `#42bda8` and `#056656`, `status.sessionExtended` `#ba68c8` and `#8e24aa`, `status.sessionAfterHours` `#82b1ff` and `#143eb2`, `status.sessionClosed` `#b8b8b8` and `#464646`, dark and light), and the theme gains a tint role for each (`status.sessionPreMarketTint`, `status.sessionOpenTint`, `status.sessionExtendedTint`, `status.sessionAfterHoursTint`, `status.sessionClosedTint`), `status.sessionTrack`, `status.dataDelayed`, `status.dataDelayedTint`, `status.dataEndOfDay`, `status.dataEndOfDayTint` and `scale.sessionElectronic`, `rgba(41, 98, 255, 0.08)` in both modes. `SESSION_LABEL.after` and `session.after` read Post-market, the countdown's two units join with "and", and the end-of-day title and sentence read End-of-day data and "Prices update once a day, after the session ends." The catalog gains `status.delayedTitle`, `status.delayedText`, `status.overnightTitle`, `status.holidayTitle`, `status.openText`, `status.preText`, `status.postText`, `status.overnightText`, `status.closedText`, `status.holidayText`, `status.closesIn`, `status.postMarketIn`, `status.overnightIn`, `status.extendedIn`, `status.preMarketIn`, `status.opensFullyIn`, `status.opensPreMarketIn`, `status.opensIn`, `status.textPair`, `chrome.sessionShortExtended`, `chrome.sessionShortRegular`, `chrome.sessionShortAllHours`, `settings.sessionElectronic`, `settings.sessionRegularHours`, `settings.electronicHoursBackground` and `settings.electronic`.
18
+
19
+ Every native browser tooltip gives way to one name bubble per widget, standing in its layer on the document body over the root, the layer its menus and dialogs open in, and every bar a page mounts in a frame of its own; each of these surfaces carries `data-qc-tips`, the symbol search and timeframe list a page opens on its own stand one in their own marked layer, and no element the chart draws carries a `title`. A control's bubble says its `data-qc-tip`, else its accessible name; one whose visible words already say it, one marked `data-no-tip` (a close X, a stepper, a field that shows its value) and one standing over the popup it opened raise none. The first shows after a 400ms rest and the next at once, for 600ms after one hides; leaving, a press, a scroll and the window losing focus put it away, a finger raises none, and the bottom bar also answers keyboard focus. It opens 4px from its control, sideways toward the room from the drawing toolbar, below the top bar, above the bottom bar and above elsewhere where there is room, held inside the chart's box and the window, its 4px ear centred on the control. `overlay.tooltip` takes `#222222` in the light palette and `#303030` in the dark one. A host's or an extension's control names its bubble with the same two attributes.
20
+
21
+ The bubbles say a control's name alone where its accessible name carries more: Search symbol, Compare symbols, a timeframe in a sentence ("1 minute"), Chart interval, the style's own name, Indicators and strategies, Layout setup, All changes saved or Save, Settings, Fullscreen mode and Take a snapshot on the top bar; the tool a face wears, the group a chevron opens, Magnets, Keep drawing, Hide all drawings, Hide options, Remove objects, Remove options and Show favorite drawing tools toolbar on the drawing toolbar, whose magnet explains what it snaps to; a range in a sentence ("5 days in 5 minute intervals"), Timezone and the trading hours shown on the bottom bar; an indicator's full name over its legend row, and Hide, Show, Settings and Remove on the row's buttons; the market's full name over the legend's name; Auto (fits data to screen) and Logarithmic on the price scale; Expand or Collapse on a grouped search row's pill and the source's name on its mark; and Add to favorites or Remove from favorites on an indicator picker star, whose rows raise none. Accessible names stand as they were. `rangePresetTip` answers that sentence. The catalog gains `chrome.compareTip`, `chrome.indicatorsTip`, `chrome.settingsTip`, `chrome.fullscreenTip`, `chrome.imageTip`, `timeframe.intervalTip`, `timeframe.tipTicks`, `timeframe.tipSeconds`, `timeframe.tipMinutes`, `timeframe.tipHours`, `timeframe.tipDays`, `timeframe.tipWeeks`, `timeframe.tipMonths`, `range.tipIntervals`, `range.intervalTicks`, `range.intervalSeconds`, `range.intervalMinutes`, `range.intervalHours`, `range.intervalDays`, `range.intervalWeeks`, `range.intervalMonths`, `range.tipOneDay`, `range.tipFiveDays`, `range.tipOneMonth`, `range.tipThreeMonths`, `range.tipSixMonths`, `range.tipOneYear`, `range.tipFiveYears`, `drawing.tipCursors`, `drawing.tipFibGann`, `drawing.tipForecast`, `drawing.tipShapes`, `drawing.tipAnnotations`, `drawing.tipMagnet`, `drawing.tipMagnets`, `drawing.tipKeepDrawing`, `drawing.tipHideAll`, `drawing.tipShowAll`, `drawing.tipHideOptions`, `drawing.tipRemoveObjects`, `drawing.tipRemoveOptions`, `drawing.tipShowFavorites`, `drawing.tipHideFavorites`, `legend.show`, `search.expand`, `search.collapse`, `timezone.tip`, `picker.favoriteTip` and `picker.unfavoriteTip`.
22
+
23
+ A compare search row under the pointer shows its three placements, Same % scale, New price scale and New pane, as 24px pills 8px apart where the source's name stood, the source's mark staying at the row's end.
24
+
25
+ ## 5.9.0
26
+
27
+ `SymbolRow.group`: rows that share a group are one instrument listed on several venues, and the symbol search lists them as one row, where the first of them stands as the feed lists them. That row reads exactly as the first member's own row, with a pill between its source's name and mark: `+` and the number of other venues, and a chevron pointing down while the group is closed and up while it is open. A group whose members list on more than one venue piles its mark over the edges of two discs under it. Pressing the pill, a button Tab reaches, opens the group: its other members stand right under its row as rows of their own, without a mark, their text where every row's text starts, and the group's row and its members share one rounded panel. A row, or Enter on it, picks the market it names, the first member from the group's row, and the member picked is the one recorded in the recents. The arrow keys move through every row, members included, and a new query, class or scope closes every group. A member on a later page joins its group's row, a group of one reads as the row without a group, recent picks stay a row each beside the whole group, and the compare dialog lists a row per market. The catalog gains `search.moreListings`.
28
+
29
+ A search row writes its source's name before the source's mark, in the description's ink and size, and the written name is what a screen reader hears, so the mark beside it only shows. A row's text starts 16px past its mark, where it started 8px past it.
30
+
5
31
  ## 5.8.0
6
32
 
7
33
  `ChartHandle.setVisibleRange` pages in older history for a window that starts before the oldest loaded bar: it asks the datafeed with the same older-page `to` and `countBack` asks a scroll back makes, page after page until the bars reach the window's start, the feed states the end of its history or the chart holds 20,000 bars, and then frames the window. A window inside the loaded bars frames at once, as before. A page that fails frames the window over the bars already loaded, and a symbol or timeframe switch, any other navigation or a disposal while a page is away leaves the window unframed. The `chart.range.set` command with an explicit window does the same.
package/README.md CHANGED
@@ -835,8 +835,7 @@ const picker = BUILT_IN_INDICATORS.map((definition) => ({
835
835
  ```
836
836
 
837
837
  An instance's `inputs` override the manifest defaults by key (`{ period: 21, source: 5 }` for an
838
- RSI over HLC3). A built-in's `plotTitles` and `inputTitles` label its plots and inputs in a
839
- settings surface.
838
+ RSI over HLC3). A built-in's `plotTitles` and `inputTitles` are its manifest's titles by key.
840
839
 
841
840
  ### Your own definitions
842
841
 
@@ -865,6 +864,46 @@ export const smaDefinition: IndicatorDefinition = {
865
864
  }
866
865
  ```
867
866
 
867
+ ### How the settings dialog lays a definition out
868
+
869
+ The settings dialog reads everything it shows from the manifest, so a host definition lays out by
870
+ the same rules as a built-in:
871
+
872
+ - **Inputs** lists every input in declaration order. A number is a field with steppers bounded by
873
+ `min`, `max` and `step`, an `enum` is a list of its `options`, and a `bool` (held as 1 or 0) is
874
+ a checkbox row. `title` labels it, else its key read as words (`fastLength` reads "Fast
875
+ Length"). Inputs that name the same `group` in a run stand under one heading. `enabledWhen`
876
+ names another input and the values under which this one applies, and it stands disabled under
877
+ the others.
878
+ - **Style** shows every plot, then every level, then every fill, each behind the checkbox that
879
+ shows it, labelled by its `title`: a line with its color, thickness and style, a histogram drawn
880
+ `up` and `down` with a row for each color, a level with its color, style and value, and a fill
881
+ with its color. The precision and the values the price scale and the status line write follow.
882
+ - **Visibility** holds the timeframes the instance draws on.
883
+
884
+ ```ts
885
+ import type { IndicatorDefinition } from '@trdrs/quickcharts'
886
+
887
+ const manifest = {
888
+ id: 'trend-filter',
889
+ pane: 'pane',
890
+ inputs: {
891
+ length: { kind: 'int', default: 20, min: 1, title: 'Length' },
892
+ smoothing: { kind: 'enum', default: 0, options: ['None', 'SMA', 'EMA'], title: 'Type', group: 'Smoothing' },
893
+ smoothingLength: { kind: 'int', default: 9, min: 1, title: 'Length', group: 'Smoothing', enabledWhen: { input: 'smoothing', values: [1, 2] } },
894
+ showZero: { kind: 'bool', default: 1, title: 'Show zero line' },
895
+ },
896
+ plots: { trend: { kind: 'line', lineWidth: 2, title: 'Trend' } },
897
+ levels: { zero: { price: 0, lineStyle: 'dashed', title: 'Zero Line' } },
898
+ } satisfies IndicatorDefinition['manifest']
899
+ ```
900
+
901
+ Every edit previews on the chart, and Ok commits the session as one `chart.indicators.update`. Its
902
+ Defaults menu resets an instance to the definition's own settings, or keeps its inputs and look in
903
+ the chart's storage as the ones the definition's next instance opens with, when that instance is
904
+ added with no inputs and no overrides of its own. `ui.indicatorSettings: false` turns the dialog
905
+ off, and the legend's gear then opens the inputs-only editor, the dialog's Inputs page in a popover.
906
+
868
907
  Wire instances through `ChartWidgetOptions.indicators`:
869
908
 
870
909
  ```ts
@@ -1764,12 +1803,13 @@ chrome is painted from it and renders nothing without it.
1764
1803
  nothing, and the widget's theme API and theme commands are untouched. Fullscreen and the image menu (Download image, Copy image where the browser can, and
1765
1804
  Download chart data when there is no layouts store) close the bar.
1766
1805
  - **The bottom bar.** The range presets the chart offers, the clock in the display zone with the
1767
- list of the timezones it offers (UTC and the exchange choice first), and the session view for a
1768
- symbol that trades outside regular hours.
1806
+ list of the timezones it offers (UTC and the exchange choice first), and the trading-hours choice
1807
+ for a symbol that offers one, named by its short form (ETH, RTH or 24H) and listing the choices
1808
+ in the symbol's own words (see Timezones and sessions).
1769
1809
  - **Around the charts.** A navigation cluster (zoom, scroll, reset) sits at the bottom of each
1770
1810
  pane, and past one tile it carries a sixth control that fills the layout with the active tile or
1771
1811
  gives the layout back, over `widget.layout.toggleMaximize`, the same verb the Alt press on a tile
1772
- and the `Alt+Enter` chord run. It wears the mark and the name for what the next press does. The market-status popup opens behind the legend's dot. From the moment replay is
1812
+ and the `Alt+Enter` chord run. It wears the mark and the name for what the next press does. The market-status popup opens behind the legend's status marks. From the moment replay is
1773
1813
  entered, one reserved
1774
1814
  transport row spans the widget below the chart grid and above the bottom bar. The first chart to
1775
1815
  enter replay owns that row until it exits or is removed; activating or starting another chart
@@ -1908,6 +1948,46 @@ restores focus; every control carries an accessible name and its state; the root
1908
1948
  language's reading direction, so the chrome mirrors for Arabic and Hebrew; motion flattens under
1909
1949
  `prefers-reduced-motion`.
1910
1950
 
1951
+ ### Name bubbles
1952
+
1953
+ Every control the chart draws names itself in one bubble, the widget's own, standing in its layer on
1954
+ the document body. It covers the widget's root, the layer its menus and dialogs open in, and every bar
1955
+ a page mounts in a frame of its own (`toolbarContainer`, `drawingToolbarContainer`), and the chart
1956
+ marks each of these surfaces `data-qc-tips`, so a page's own tooltips can leave `.qc-root` and
1957
+ `[data-qc-tips]` to it. The symbol search and the timeframe list a page opens on its own
1958
+ (`openSymbolSearch`, `openTimeframePicker`) stand a bubble of their own in their own marked layer,
1959
+ over their scrim. No element the chart draws carries a native `title`, so the browser's own tooltip
1960
+ never stands beside the bubble.
1961
+
1962
+ A control's bubble says its `data-qc-tip` when it has one and its accessible name otherwise. A
1963
+ control whose own visible words already say that (a dialog's Ok, a worded chip) raises none, and so
1964
+ does one marked `data-no-tip` (a close X, a field that shows its value, a stepper) and one standing
1965
+ expanded over the menu or dialog it opened. The first bubble shows after the pointer rests 400ms on a
1966
+ control; once one has shown, the next control's shows at once, and for 600ms after one hides. The
1967
+ pointer leaving, a press, a scroll and the window losing focus put it away, and a finger raises none.
1968
+ The bottom bar also shows its bubbles for keyboard focus.
1969
+
1970
+ It opens 4px from its control, centred on it and held inside the chart's box and the window: the
1971
+ drawing toolbar's (a vertical toolbar) sideways toward the room, the top bar's and a pane legend's
1972
+ below (a host control in a legend slot too), the bottom bar's above, and every other one's above
1973
+ where there is room and below otherwise. Its ear, 4px deep and 12px
1974
+ wide, faces the control and stays centred on it however far the bubble moved to fit. It paints 13px
1975
+ on 18px in `overlay.tooltipInk` on `overlay.tooltip`, padded 3px by 8px on a 2px corner and at most
1976
+ 310px wide, which is how a hovered time-scale mark's words paint too.
1977
+
1978
+ A control a host or an extension places among the chart's own (a top bar slot, a legend row, a panel
1979
+ of its own inside the root) names its bubble the same way: `data-qc-tip` for words that differ from
1980
+ its accessible name, and `data-no-tip` for none.
1981
+
1982
+ ```ts
1983
+ const tradeButton = document.createElement('button')
1984
+ tradeButton.setAttribute('aria-label', 'Buy at market')
1985
+ tradeButton.dataset.qcTip = 'Buy'
1986
+ const closeButton = document.createElement('button')
1987
+ closeButton.setAttribute('aria-label', 'Close')
1988
+ closeButton.setAttribute('data-no-tip', '')
1989
+ ```
1990
+
1911
1991
  ### Icons
1912
1992
 
1913
1993
  `icons` draws the glyphs of the chart's own controls. Each key is a published icon id and each value
@@ -2070,7 +2150,10 @@ them, and asks for none.
2070
2150
  nothing on screen points at one.
2071
2151
  - **Session bands** (`features.sessions: false` opts out). While the chart's trading hours show
2072
2152
  the stretches outside regular hours (`symbol.session` of `extended` or `allHours`), each shades
2073
- under the bars in the color the settings give it, and the `events.sessionBreaks` setting draws a
2153
+ under the bars in the color the settings give it: pre-market and post-market in their own colors,
2154
+ and the overnight stretch in the night color under `allHours` only. On an electronic day every
2155
+ stretch outside regular hours wears one color, `symbol.electronicColor`. A symbol with one weekly
2156
+ session has no stretch outside regular hours and shades none. The `events.sessionBreaks` setting draws a
2074
2157
  line at each trading day's start, driven by the session model built from the symbol's own
2075
2158
  `session`, `sessionHolidays`, `corrections` and `subsessions` in `resolve()`'s answer (see
2076
2159
  Timezones and sessions). A continuous market never bands; intraday only; an UNRESOLVED symbol
@@ -2090,8 +2173,11 @@ them, and asks for none.
2090
2173
  retain focus during value updates. Indicator values read the first plot, using declared precision
2091
2174
  or the symbol formatter; Volume reads bar volume using resolved volume precision. The row-list
2092
2175
  toggle, indicator eye and pane collapse are independent controls. Pane restore remembers indicator
2093
- identity across pane removal. The status control opens session details, retains an unknown-session
2094
- state and is hidden during replay. Price-scale chips use the same commands as `setScaleMode`.
2176
+ identity across pane removal. After the venue the legend wears its status marks: an 18px round
2177
+ badge for the market's phase (open, pre-market, post-market, overnight, extended hours, closed or
2178
+ holiday), each glyph in its phase's ink over a circle of its tint, and beside it a second badge
2179
+ for a delayed or end-of-day feed. The marks ride one control that opens the market-status popup,
2180
+ show one muted mark while the session is unknown and are hidden during replay. Price-scale chips use the same commands as `setScaleMode`.
2095
2181
  - **An interface language** (`locale`, English by default), one of the 21 the package ships.
2096
2182
  `BUILT_IN_LOCALES` lists them for a picker: each carries its stable code, its canonical BCP 47
2097
2183
  `tag`, its reading direction (`ar` and `he_IL` are `rtl`), and its endonym. The chart's own chrome
@@ -2207,6 +2293,8 @@ among the others `THEME_ROLES` lists:
2207
2293
  | `chrome.radiusDialog` | `12px` | `12px` | The corners of a dialog. A menu or panel rounds on `chrome.radiusLarge`, `6px`. |
2208
2294
  | `overlay.separator` | `#ebebeb` | `#464646` | The rule under a dialog header and over its footer, and between menu groups. |
2209
2295
  | `overlay.scrim` | `rgba(156, 156, 156, 0.5)` | `rgba(0, 0, 0, 0.5)` | The veil behind a modal dialog. |
2296
+ | `overlay.tooltip` | `#222222` | `#303030` | The fill of a name bubble and of a hovered time-scale mark's words. |
2297
+ | `overlay.tooltipInk` | `#f2f2f2` | `#f2f2f2` | The words on it. |
2210
2298
  | `text.primary` | `#000000` | `#dbdbdb` | The ink of rows, labels and values. |
2211
2299
  | `text.muted` | `#6a6a6a` | `#9b9b9b` | A section title, a hint, a placeholder. |
2212
2300
  | `chrome.caret` | `#707070` | `#8c8c8c` | The chevron of a select and the arrow that opens a flyout. |
@@ -2443,8 +2531,10 @@ the same in both modes, in `CHART_FACTORY_COLORS`. The sections and what stands
2443
2531
  look) is stroked from its top color at the highest price on screen to its bottom color at the
2444
2532
  lowest, and a baseline whose halves differ in width strokes each at its own.
2445
2533
  - `symbol`: the trading hours (`session`: `regular`, `extended` or `allHours`), which are the
2446
- chart's subsession, with the shading of the pre-market, post-market and overnight stretches; and
2447
- the precision every price is written at, through the chart's one formatter.
2534
+ chart's subsession, offered with the choices and words the symbol's own sessions give it (see
2535
+ Timezones and sessions), with the shading of the pre-market, post-market and overnight stretches
2536
+ and of an electronic day's stretches outside regular hours (`electronicColor`); and the
2537
+ precision every price is written at, through the chart's one formatter.
2448
2538
  - `statusLine`: the legend's mark, its title and whether the title is the name, the symbol or both,
2449
2539
  the bar's values, its change and its volume, the latest price's change since the previous
2450
2540
  session's close (`lastDayChange`) in its direction's color, the indicator rows' titles, inputs
@@ -2489,7 +2579,8 @@ the same in both modes, in `CHART_FACTORY_COLORS`. The sections and what stands
2489
2579
  and `invertScale` stands it upside down, higher prices lower on the pane. A button in the corner
2490
2580
  where the main scale meets the time scale opens the scale's menu, above the corner on the scale's
2491
2581
  side: reset the scale, its framing, the ratio lock, `scalePriceChartOnly`, `invertScale`, the four
2492
- modes, the other side, flyouts for its labels and lines, the plus, and the Scales page of the
2582
+ modes, the other side, flyouts for its labels and lines, the plus, a Session flyout with the
2583
+ trading hours the symbol offers (left out for a symbol with no choice), and the Scales page of the
2493
2584
  settings. A chart without its context menu shows no button. `Alt+P` and `Alt+L` turn the percent
2494
2585
  and logarithmic modes on and off, and `Alt+I` inverts the scale.
2495
2586
  - `timeScale`: the crosshair label's date format (`CHART_DATE_FORMATS`), the weekday before it, and
@@ -2501,9 +2592,13 @@ the same in both modes, in `CHART_FACTORY_COLORS`. The sections and what stands
2501
2592
  crosshair's color, stroke and width; the watermark's parts and ink; the scales' text and lines;
2502
2593
  when the navigation buttons show; when each pane's own buttons show (`paneButtons`): at a pane's
2503
2594
  top right, move it up or down past its neighbour, delete it, collapse or open it, and maximize or
2504
- restore it, through the same pane operations and move verbs the legend's rows run, the main pane
2505
- moving too and otherwise carrying maximize alone while another pane stands; and the margins, the
2506
- right one in bars. The order the panes stand in is saved with the chart.
2595
+ restore it, the main pane moving too and otherwise carrying maximize alone while another pane
2596
+ stands. A collapsed pane is a strip of its legend and its buttons that paints nothing else, all
2597
+ four buttons kept and its collapse pressed. A maximized pane takes the chart's whole height, the
2598
+ other panes and the dividers hidden, and keeps its moves and its restore, which gives every pane
2599
+ back the share it held, a collapsed one its strip. These buttons are where a pane is moved,
2600
+ collapsed and maximized: a legend row carries its eye, its settings and its remove. And the
2601
+ margins, the right one in bars. The order the panes stand in is saved with the chart.
2507
2602
  - `events`: a line at each trading day's start, in its own stroke.
2508
2603
 
2509
2604
  ## Compare
@@ -2607,12 +2702,34 @@ current offset, so daylight-saving changes reorder the list on their own.
2607
2702
  A symbol's session facts build a session model: `session` in the session grammar (`0930-1600`,
2608
2703
  `1700-1600:23456` with `1` as Sunday, `24x7`, several stretches per day, previous-day markers),
2609
2704
  `sessionHolidays` as `YYYYMMDD` full closures, and `corrections` as `SESSION:YYYYMMDD` overrides
2610
- that outrank a holiday. `subsessions` (`regular`, `extended`, `premarket`, `postmarket`, each
2611
- with its own session string and `sessionCorrections`) split extended hours into pre-market,
2612
- regular and after-hours; a symbol without them has one continuous session. The model answers the
2613
- session state at an instant, the next change and the exchange-local day's timeline, and the
2614
- market status combines the state with the feed's `dataStatus`: an end-of-day feed is its own
2615
- state, never an open market.
2705
+ that outrank a holiday. `subsessions` (`regular`, `extended`, `premarket`, `postmarket` and
2706
+ `overnight`, each with its own session string and `sessionCorrections`) name the stretches around
2707
+ regular hours; a symbol without them has one weekly session. The model answers the session state at
2708
+ an instant, the next change and the exchange-local day's timeline, all read from the symbol's own
2709
+ facts and never from its type.
2710
+
2711
+ The subsessions give a day one of two shapes. A split day states its regular hours as `session`,
2712
+ with `premarket`, `postmarket` and, optionally, `overnight` around them (an equity: regular
2713
+ `0930-1600`, pre-market `0400-0930`, post-market `1600-2000`). An electronic day states its
2714
+ whole electronic trading day as `session` and its regular hours as a `regular` subsession that
2715
+ differs from it (a futures exchange: `session` `1700-1600:23456`, regular `0830-1515`), and
2716
+ `SessionModel.electronic` says so. Every stretch of an electronic day outside regular hours
2717
+ classifies as `extended`, and the market status reads the whole day as open. `marketStatus`
2718
+ answers the phase a status names (`MarketStatus.phase`): open, pre-market, post-market, overnight
2719
+ (the `extended` state of a split day that names pre-market and post-market or trades overnight),
2720
+ extended hours (a bare `extended` subsession), closed, or holiday, a closed trading day the symbol
2721
+ lists in `sessionHolidays` with no correction (`MarketStatus.holiday`). A continuous market is
2722
+ always open. `marketStatusTitle` names the phase, `marketStatusSentence` says what it means and
2723
+ `marketStatusCountdown` counts down to the next transition, named for where the market goes;
2724
+ `marketStatusText` joins the two. The feed's `dataStatus` is a notice of its own beside the
2725
+ market's phase, never a market state: `dataStatusNotice` words a delayed or end-of-day feed and
2726
+ answers null for a live stream.
2727
+
2728
+ The legend's status marks and the popup behind them read the same status: one section per mark,
2729
+ the market's first with its title, its sentence and its countdown in bold, the exchange day's
2730
+ timeline with the start and end of the stretch now stands in, and the exchange timezone; then a
2731
+ section for a delayed or end-of-day feed. The countdown and the now marker move every minute while
2732
+ the popup stands open.
2616
2733
 
2617
2734
  ```ts
2618
2735
  import { createChartI18n, marketStatus, marketStatusText, marketStatusTitle, parseSessionModel, sessionStateAt } from '@trdrs/quickcharts'
@@ -2624,7 +2741,7 @@ if (model) {
2624
2741
  sessionStateAt(model, now) // 'open'
2625
2742
  const status = marketStatus(model, 'streaming', now)
2626
2743
  marketStatusTitle(t, status) // 'Market open'
2627
- marketStatusText(t, status, now) // 'Market is open for regular trading. Closes in 6 hours.'
2744
+ marketStatusText(t, status, now) // "All's well, market is open. It'll close in 6 hours."
2628
2745
  }
2629
2746
  parseSessionModel({ timezone: 'Etc/UTC', session: 'later' }) // null: the chart claims no session it cannot read
2630
2747
  ```
@@ -2632,11 +2749,18 @@ parseSessionModel({ timezone: 'Etc/UTC', session: 'later' }) // null: the chart
2632
2749
  Which named session a chart displays is its subsession, the chart's `symbol.session` setting, with
2633
2750
  `regular` as the factory value: `chart.subsession()` reads it and `chart.setSubsession()` writes it
2634
2751
  as the viewer's own. On a symbol with extended hours, `regular` filters intraday bars to
2635
- regular hours and `extended` shows every bar; a symbol with one continuous session has nothing to
2636
- filter.
2752
+ regular hours and `extended` shows every bar; a symbol with one weekly session has nothing to
2753
+ filter. `tradingHoursOptions` lists the trading-hours choices a symbol offers, each with the
2754
+ `symbol.session` value it writes and its name and short name as catalog keys, which the bottom
2755
+ bar's picker, the price scale's Session flyout and the settings page all show: an electronic day's
2756
+ Electronic trading hours (`extended`, ETH) and Regular trading hours (`regular`, RTH); a split
2757
+ day's Regular, Extended and, where it declares an `overnight` subsession, 24 hours (`allHours`,
2758
+ 24H). A continuous market and a symbol with one weekly session offer none. `tradingHoursOption`
2759
+ finds the one a setting stands for, the extended hours for `allHours` where a symbol offers no 24
2760
+ hours.
2637
2761
 
2638
2762
  ```ts
2639
- import { DEFAULT_SUBSESSION, hasExtendedHours, parseSessionModel, subsessionBarFilter } from '@trdrs/quickcharts'
2763
+ import { DEFAULT_SUBSESSION, hasExtendedHours, parseSessionModel, subsessionBarFilter, tradingHoursOptions } from '@trdrs/quickcharts'
2640
2764
 
2641
2765
  const equity = parseSessionModel({
2642
2766
  timezone: 'America/New_York',
@@ -2650,9 +2774,10 @@ const equity = parseSessionModel({
2650
2774
  })
2651
2775
  if (equity) {
2652
2776
  hasExtendedHours(equity) // true
2653
- const keep = subsessionBarFilter(equity, DEFAULT_SUBSESSION) // a function: regular hours only
2777
+ const keep = subsessionBarFilter(equity, 'regular') // a function: regular hours only
2654
2778
  keep?.(Date.UTC(2026, 6, 13, 14) / 1000) // true, 10:00 in New York
2655
- subsessionBarFilter(equity, 'extended') // null: nothing to filter
2779
+ subsessionBarFilter(equity, DEFAULT_SUBSESSION) // null: extended hours filter nothing
2780
+ tradingHoursOptions(equity).map((option) => option.hours) // ['regular', 'extended']
2656
2781
  }
2657
2782
  ```
2658
2783
 
@@ -2874,6 +2999,59 @@ const scoped = createChart({
2874
2999
  void scoped
2875
3000
  ```
2876
3001
 
3002
+ ### One instrument on several venues
3003
+
3004
+ Rows that share a `group` are one instrument listed on several venues, and the symbol search lists
3005
+ them as one row, where the first of them stands as your feed lists them. That row reads exactly as
3006
+ the first member's own row: its mark, its ticker, its description and kind, and its source's name
3007
+ and mark. Between the source's name and its mark stands a pill: `+2` for two other venues, and a
3008
+ chevron pointing down while the group is closed and up while it is open. A group whose members list on
3009
+ more than one venue piles its mark over the edges of two discs under it, so the row says there are
3010
+ other venues before it is opened.
3011
+
3012
+ Pressing the pill opens the group, and pressing it again closes it. An open group lists its other
3013
+ members right under its row, as your feed lists them, each a row of its own without a mark: its
3014
+ ticker, its description and kind, and its source's name and mark, its text starting where every
3015
+ row's text starts. The group's row and its members stand on one shared panel. Pressing a row, or
3016
+ Enter while it is highlighted, picks the market that row names: the first member from the group's
3017
+ row, and that member from a member's row. The member picked is the one recorded in the recents.
3018
+
3019
+ The pill is a button the keyboard reaches with Tab and presses with Enter or Space, and its
3020
+ accessible name says how many other venues it opens, "2 more listings" in the viewer's language,
3021
+ with `aria-expanded` saying whether they are showing. The arrow keys move through every row,
3022
+ members included, and leave Left and Right to the field's caret. A group stays open while the
3023
+ dialog is, and a new query, class or scope closes every group.
3024
+
3025
+ The dialog groups every page loaded so far, so a member that arrives on a later page joins the row
3026
+ its group already has. A group with one member reads exactly as the row without a group, and a row
3027
+ with no `group`, or an empty one, is a row of its own. Recent picks stay a row each, and a grouped
3028
+ row still lists every venue when a recent names one of them. The compare dialog lists a row per
3029
+ market, grouped or not.
3030
+
3031
+ ```ts
3032
+ import type { ChartDatafeed, SymbolRow } from '@trdrs/quickcharts'
3033
+
3034
+ declare const venuesFeed: ChartDatafeed
3035
+
3036
+ // One row in the symbol search, reading BTCUSDT on Alpha with a +2 pill that opens Beta and Gamma.
3037
+ const bitcoin: SymbolRow[] = [
3038
+ { symbol: 'ALPHA:BTCUSDT', ticker: 'BTCUSDT', name: 'Bitcoin', exchange: 'Alpha', type: 'crypto', group: 'BTC' },
3039
+ { symbol: 'BETA:BTCUSD', ticker: 'BTCUSD', name: 'Bitcoin', exchange: 'Beta', type: 'crypto', group: 'BTC' },
3040
+ { symbol: 'GAMMA:BTCUSDC', ticker: 'BTCUSDC', name: 'Bitcoin', exchange: 'Gamma', type: 'crypto', group: 'BTC' },
3041
+ ]
3042
+
3043
+ const groupedFeed: ChartDatafeed = {
3044
+ ...venuesFeed,
3045
+ async search(query, options) {
3046
+ const page = await venuesFeed.search(query, options)
3047
+ // Name each row's instrument, so its venues share one row.
3048
+ return { ...page, hits: page.hits.map((row) => ({ ...row, group: myBackend.instrumentOf(row.symbol) })) }
3049
+ },
3050
+ }
3051
+ void bitcoin
3052
+ void groupedFeed
3053
+ ```
3054
+
2877
3055
  ### The picker, away from a chart
2878
3056
 
2879
3057
  A page that picks a market where no chart is mounted opens the same dialog the chart's symbol pill