@trdrs/quickcharts 4.1.0 → 5.0.1

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as ChartDatafeed, F as FeedBar, S as SymbolRow, D as DatafeedSearchOptions, a as SearchPage, b as SearchClassNode } from './symbols-6V22WaRX.js';
-export { B as BarMark, c as BarsEvent, d as DatafeedConfig, e as FeedUnavailableError, H as HistoryPage, M as MarkColorRole, f as MarkPlacement, g as MarkShape, O as OlderPageVerdict, h as SubscribeHandlers, i as SymbolNames, T as TimescaleMark, o as olderPageVerdict, s as symbolNames } from './symbols-6V22WaRX.js';
-import { ao as en, C as ChartMessageKey, G as GlyphSourcePort, M as MagnetMode, d as CursorMode, Q as TextEditFrame, N as TextDraft, L as LineStyle, I as IDrawing, m as DrawingCounts, D as DrawingStyle, $ as VisibilityPreset, X as ToolPreset, Y as ToolTemplate, S as SerializedDrawing, o as DrawingPreferences, l as DrawingAssetPort } from './assets-BF-NDyHl.js';
-import { b as ResourceRef, C as ChartSaveLoadAdapter, q as ChartMeta, t as ChartBody, h as DrawingResourceContext, R as ResourceStore, u as DrawingsMeta, j as DrawingsBody, T as TemplateMeta, a as TemplateBody, v as LayoutMeta, w as LayoutBody, e as DrawingContextKind } from './resources-C0cYryO9.js';
-export { c as ChartLocalDrawingContext, D as DRAWING_CONTEXT_VERSION, d as DRAWING_DOCUMENT_VERSION, f as DrawingEntry, g as DrawingGroup, i as DrawingTombstone, L as LayoutSharedDrawingContext, M as MemoryResourcesOptions, x as ResourceAbortError, S as SymbolGlobalDrawingContext, y as TemplateKind, W as WriteOutcome, k as drawingContextKey, l as emptyDrawingDocument, m as liveDrawingEntries, n as liveDrawingGroups, z as memorySaveLoadAdapter, o as mergeDrawingDocuments, p as parseDrawingDocument, r as reviseDrawingDocument, s as sameDrawingContext } from './resources-C0cYryO9.js';
+import { C as ChartDatafeed, M as MarkIconId, F as FeedBar, S as SymbolRow, D as DatafeedSearchOptions, a as SearchPage, b as SearchClassNode } from './symbols-DdHLHQFC.js';
+export { B as BarMark, c as BarsEvent, d as DatafeedConfig, e as FeedUnavailableError, H as HistoryPage, f as MarkColor, g as MarkColorPair, h as MarkColorRole, i as MarkLine, j as MarkLineStyle, k as MarkPlacement, l as MarkShape, O as OlderPageVerdict, P as PricesHandlers, m as SubscribeHandlers, n as SymbolNames, o as SymbolPrices, T as TimescaleMark, p as olderPageVerdict, s as symbolNames } from './symbols-DdHLHQFC.js';
+import { ao as en, C as ChartMessageKey, G as GlyphSourcePort, M as MagnetMode, d as CursorMode, Q as TextEditFrame, N as TextDraft, L as LineStyle, I as IDrawing, m as DrawingCounts, D as DrawingStyle, $ as VisibilityPreset, X as ToolPreset, Y as ToolTemplate, S as SerializedDrawing, o as DrawingPreferences, l as DrawingAssetPort } from './assets-DF3nozNV.js';
+import { b as ResourceRef, C as ChartSaveLoadAdapter, q as ChartMeta, t as ChartBody, h as DrawingResourceContext, R as ResourceStore, u as DrawingsMeta, j as DrawingsBody, T as TemplateMeta, a as TemplateBody, v as LayoutMeta, w as LayoutBody, e as DrawingContextKind } from './resources-XglhzzW0.js';
+export { c as ChartLocalDrawingContext, D as DRAWING_CONTEXT_VERSION, d as DRAWING_DOCUMENT_VERSION, f as DrawingEntry, g as DrawingGroup, i as DrawingTombstone, L as LayoutSharedDrawingContext, M as MemoryResourcesOptions, x as ResourceAbortError, S as SymbolGlobalDrawingContext, y as TemplateKind, W as WriteOutcome, k as drawingContextKey, l as emptyDrawingDocument, m as liveDrawingEntries, n as liveDrawingGroups, z as memorySaveLoadAdapter, o as mergeDrawingDocuments, p as parseDrawingDocument, r as reviseDrawingDocument, s as sameDrawingContext } from './resources-XglhzzW0.js';
 import { LineData, UTCTimestamp, HistogramData, WhitespaceData, IChartApi, ISeriesApi, CreatePriceLineOptions, PriceLineOptions, ISeriesPrimitive, Time, PriceScaleMode, SeriesType, SeriesAttachedParameter, TickMarkType } from 'lightweight-charts';
 import { D as DataStatus, S as SymbolInfo, P as PriceFormat } from './symbology-D3SLclrU.js';
 export { a as Subsession, b as SubsessionId, T as TickBand, p as parseTickBands, t as tickBandFor } from './symbology-D3SLclrU.js';
@@ -55,6 +55,11 @@ declare const THEME_ROLES: readonly [{
     readonly family: "canvas";
     readonly kind: "color";
     readonly description: "The divider between stacked panes and around the plot area.";
+}, {
+    readonly id: "canvas.watermark";
+    readonly family: "canvas";
+    readonly kind: "color";
+    readonly description: "The text a watermark writes large behind the bars.";
 }, {
     readonly id: "series.up";
     readonly family: "series";
@@ -183,6 +188,15 @@ declare const THEME_ROLES: readonly [{
         readonly over: "control.neutral";
         readonly min: 4.5;
     }];
+}, {
+    readonly id: "text.caption";
+    readonly family: "text";
+    readonly kind: "color";
+    readonly description: "Ink of a dialog's section heading and of the hint line under a setting, which stand on the dialog's own surface and never under the pointer.";
+    readonly contrast: readonly [{
+        readonly over: "overlay.surface";
+        readonly min: 4.5;
+    }];
 }, {
     readonly id: "text.disabled";
     readonly family: "text";
@@ -242,7 +256,7 @@ declare const THEME_ROLES: readonly [{
     readonly id: "text.fontSizeAxis";
     readonly family: "text";
     readonly kind: "length";
-    readonly description: "Size of scale and crosshair labels drawn into the canvas.";
+    readonly description: "Size of the legend's reading of the bar. The price and time scales take their text size from the chart settings.";
 }, {
     readonly id: "text.fontSizeTitle";
     readonly family: "text";
@@ -341,6 +355,20 @@ declare const THEME_ROLES: readonly [{
     readonly family: "overlay";
     readonly kind: "color";
     readonly description: "The backdrop that dims the chart behind a modal dialog.";
+}, {
+    readonly id: "overlay.tooltip";
+    readonly family: "overlay";
+    readonly kind: "color";
+    readonly description: "The fill of a short tooltip line.";
+}, {
+    readonly id: "overlay.tooltipInk";
+    readonly family: "overlay";
+    readonly kind: "color";
+    readonly description: "The ink of a tooltip line.";
+    readonly contrast: readonly [{
+        readonly over: "overlay.tooltip";
+        readonly min: 4.5;
+    }];
 }, {
     readonly id: "state.accent";
     readonly family: "state";
@@ -542,6 +570,20 @@ declare const THEME_ROLES: readonly [{
     readonly family: "control";
     readonly kind: "color";
     readonly description: "The fill of a field that is read-only or disabled.";
+}, {
+    readonly id: "control.tipMark";
+    readonly family: "control";
+    readonly kind: "color";
+    readonly description: "The mark of a tip beside a setting's label, such as a question mark, at rest.";
+}, {
+    readonly id: "control.tipMarkHover";
+    readonly family: "control";
+    readonly kind: "color";
+    readonly description: "The mark of a tip under the pointer.";
+    readonly contrast: readonly [{
+        readonly over: "overlay.surface";
+        readonly min: 3;
+    }];
 }, {
     readonly id: "status.positive";
     readonly family: "status";
@@ -871,7 +913,7 @@ interface DictionaryLoader<Source extends Catalog, Code extends string = ChartLo
     has(code: Code): boolean;
 }
 
-declare const KEYS_ADDED_IN_MAJOR: readonly ["drawing.distance", "drawing.drawingMenu", "drawing.hintRemove"];
+declare const KEYS_ADDED_IN_MAJOR: readonly ["chrome.autoScale", "chrome.autoScaleMark", "chrome.currencyAndUnit", "chrome.deletePane", "chrome.logScale", "chrome.logScaleMark", "chrome.paneButtons", "chrome.priceLevelMenu", "chrome.scaleAsk", "chrome.scaleBid", "chrome.scaleHigh", "chrome.scaleLow", "chrome.scaleModes", "command.drawingPlaceHorizontalLine", "command.marksRefresh", "history.changeMovePane", "legend.movePaneDown", "legend.movePaneUp", "menu.drawHorizontalLine"];
 type KeyAddedInMajor = (typeof KEYS_ADDED_IN_MAJOR)[number];
 
 type ChartTranslate = Translate<typeof en>;
@@ -925,19 +967,143 @@ declare const chartDictionaries: DictionaryLoader<{
         readonly other: "{count} indicators in this saved chart are not available here and were left out.";
     };
     readonly 'settings.menu': "Chart settings";
-    readonly 'settings.sectionAppearance': "Appearance";
+    readonly 'settings.pageSymbol': "Symbol";
+    readonly 'settings.pageStatusLine': "Status line";
+    readonly 'settings.pageScales': "Scales and lines";
+    readonly 'settings.pageCanvas': "Canvas";
+    readonly 'settings.pageEvents': "Events";
+    readonly 'settings.headingCandles': "Candles";
+    readonly 'settings.headingHollowCandles': "Hollow candles";
+    readonly 'settings.headingBars': "Bars";
+    readonly 'settings.headingLine': "Line";
+    readonly 'settings.headingStepLine': "Step line";
+    readonly 'settings.headingArea': "Area";
+    readonly 'settings.headingBaseline': "Baseline";
+    readonly 'settings.colorOnPreviousClose': "Color bars based on previous close";
+    readonly 'settings.body': "Body";
+    readonly 'settings.borders': "Borders";
+    readonly 'settings.wick': "Wick";
+    readonly 'settings.hlcBars': "HLC bars";
+    readonly 'settings.upColor': "Up color";
+    readonly 'settings.downColor': "Down color";
+    readonly 'settings.thinBars': "Thin bars";
+    readonly 'settings.priceSource': "Price source";
+    readonly 'settings.sourceOpen': "Open";
+    readonly 'settings.sourceHigh': "High";
+    readonly 'settings.sourceLow': "Low";
+    readonly 'settings.sourceClose': "Close";
+    readonly 'settings.sourceHl2': "(H + L)/2";
+    readonly 'settings.sourceHlc3': "(H + L + C)/3";
+    readonly 'settings.sourceOhlc4': "(O + H + L + C)/4";
+    readonly 'settings.sourceHlcc4': "(H + L + C + C)/4";
+    readonly 'settings.lineRow': "Line";
+    readonly 'settings.colorSolid': "Solid";
+    readonly 'settings.colorGradient': "Gradient";
+    readonly 'settings.fill': "Fill";
+    readonly 'settings.topLine': "Top line";
+    readonly 'settings.bottomLine': "Bottom line";
+    readonly 'settings.fillTopArea': "Fill top area";
+    readonly 'settings.fillBottomArea': "Fill bottom area";
+    readonly 'settings.baseLevel': "Base level";
+    readonly 'settings.headingDataModification': "Data modification";
+    readonly 'settings.session': "Session";
+    readonly 'settings.sessionRegular': "Regular";
+    readonly 'settings.sessionExtended': "Extended";
+    readonly 'settings.sessionAllHours': "24 hours";
+    readonly 'settings.extendedHoursBackground': "Pre/post market hours background";
+    readonly 'settings.allHoursBackground': "Pre/post/night market hours background";
+    readonly 'settings.preMarket': "Pre-market";
+    readonly 'settings.postMarket': "Post-market";
+    readonly 'settings.night': "Night";
+    readonly 'settings.precision': "Precision";
+    readonly 'settings.precisionDefault': "Default";
+    readonly 'settings.precisionInteger': "Integer";
+    readonly 'settings.precisionDecimals': {
+        readonly one: "{count} decimal";
+        readonly other: "{count} decimals";
+    };
+    readonly 'settings.headingInstrument': "Instrument";
+    readonly 'settings.logo': "Logo";
+    readonly 'settings.title': "Title";
+    readonly 'settings.titleName': "Name";
+    readonly 'settings.titleSymbol': "Symbol";
+    readonly 'settings.titleSymbolAndName': "Symbol and name";
+    readonly 'settings.chartValues': "Chart values";
+    readonly 'settings.barChangeValues': "Bar change values";
+    readonly 'settings.volume': "Volume";
+    readonly 'settings.lastDayChangeValues': "Last day change values";
+    readonly 'settings.headingIndicators': "Indicators";
+    readonly 'settings.indicatorTitles': "Titles";
+    readonly 'settings.indicatorInputs': "Inputs";
+    readonly 'settings.indicatorValues': "Values";
     readonly 'settings.background': "Background";
-    readonly 'settings.upCandles': "Up candles";
-    readonly 'settings.downCandles': "Down candles";
-    readonly 'settings.upBorders': "Up borders";
-    readonly 'settings.downBorders': "Down borders";
-    readonly 'settings.upWicks': "Up wicks";
-    readonly 'settings.downWicks': "Down wicks";
-    readonly 'settings.sectionDisplay': "Display";
-    readonly 'settings.gridLines': "Grid lines";
-    readonly 'settings.sessionShading': "Session shading";
     readonly 'settings.sectionScale': "Price scale";
-    readonly 'settings.sectionTheme': "Theme";
+    readonly 'settings.currencyAndUnit': "Currency and Unit";
+    readonly 'settings.scaleModes': "Scale modes (A and L)";
+    readonly 'settings.visibleOnMouseOver': "Visible on mouse over";
+    readonly 'settings.alwaysVisible': "Always visible";
+    readonly 'settings.alwaysInvisible': "Always invisible";
+    readonly 'settings.lockPriceToBarRatio': "Lock price to bar ratio";
+    readonly 'settings.scalesPlacement': "Scales placement";
+    readonly 'settings.placementLeft': "Stack on the left";
+    readonly 'settings.placementRight': "Stack on the right";
+    readonly 'settings.placementAuto': "Auto";
+    readonly 'settings.headingPriceLabels': "Price labels & lines";
+    readonly 'settings.noOverlappingLabels': "No overlapping labels";
+    readonly 'settings.plusButton': "Plus button";
+    readonly 'settings.plusButtonTip': "Shows a plus beside the price under the crosshair, which opens the menu for that price";
+    readonly 'settings.countdown': "Countdown to bar close";
+    readonly 'settings.symbolLabel': "Symbol";
+    readonly 'settings.labelName': "Name";
+    readonly 'settings.labelValue': "Value";
+    readonly 'settings.labelLine': "Line";
+    readonly 'settings.hidden': "Hidden";
+    readonly 'settings.lastValueMode': "Last value label";
+    readonly 'settings.valueByScale': "Value according to scale";
+    readonly 'settings.priceAndPercent': "Price and percentage value";
+    readonly 'settings.indicatorsAndFinancials': "Indicators and financials";
+    readonly 'settings.extendedHoursLabels': "Pre/post/night market";
+    readonly 'settings.previousDayClose': "Previous day close";
+    readonly 'settings.highAndLow': "High and low";
+    readonly 'settings.bidAndAsk': "Bid and ask";
+    readonly 'settings.bid': "Bid";
+    readonly 'settings.ask': "Ask";
+    readonly 'settings.headingTimeScale': "Time scale";
+    readonly 'settings.dayOfWeek': "Day of week on labels";
+    readonly 'settings.dateFormat': "Date format";
+    readonly 'settings.timeHoursFormat': "Time hours format";
+    readonly 'settings.hours24': "24-hours";
+    readonly 'settings.hours12': "12-hours";
+    readonly 'settings.keepLeftEdge': "Save chart left edge position when changing interval";
+    readonly 'settings.headingChartStyles': "Chart basic styles";
+    readonly 'settings.verticalGrid': "Vertical grid lines";
+    readonly 'settings.horizontalGrid': "Horizontal grid lines";
+    readonly 'settings.crosshair': "Crosshair";
+    readonly 'settings.watermark': "Watermark";
+    readonly 'settings.watermarkTicker': "Ticker";
+    readonly 'settings.watermarkInterval': "Interval";
+    readonly 'settings.watermarkDescription': "Description";
+    readonly 'settings.watermarkReplay': "Replay mode";
+    readonly 'settings.headingScales': "Scales";
+    readonly 'settings.scaleText': "Text";
+    readonly 'settings.scaleLines': "Lines";
+    readonly 'settings.headingButtons': "Buttons";
+    readonly 'settings.navigationButtons': "Navigation";
+    readonly 'settings.paneButtons': "Pane";
+    readonly 'settings.headingMargins': "Margins";
+    readonly 'settings.marginTop': "Top";
+    readonly 'settings.marginBottom': "Bottom";
+    readonly 'settings.marginRight': "Right";
+    readonly 'settings.unitPercent': "%";
+    readonly 'settings.unitBars': "bars";
+    readonly 'settings.sessionBreaks': "Session breaks";
+    readonly 'settings.upColorOf': "{name} up color";
+    readonly 'settings.downColorOf': "{name} down color";
+    readonly 'settings.topColorOf': "{name} top color";
+    readonly 'settings.bottomColorOf': "{name} bottom color";
+    readonly 'settings.learnMore': "Learn more";
+    readonly 'settings.saveTemplate': "Save chart template";
+    readonly 'settings.deleteTemplateBody': "Doing this will permanently delete your \"{name}\" chart template.";
     readonly 'settings.indicatorTitle': "{name} settings";
     readonly 'settings.tabInputs': "Inputs";
     readonly 'settings.tabStyle': "Style";
@@ -952,8 +1118,6 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'settings.lineStyleSolid': "Solid";
     readonly 'settings.lineStyleDashed': "Dashed";
     readonly 'settings.lineStyleDotted': "Dotted";
-    readonly 'settings.precision': "Precision";
-    readonly 'settings.precisionDefault': "Default";
     readonly 'settings.labelsOnPriceScale': "Labels on price scale";
     readonly 'settings.showIndicator': "Show this indicator";
     readonly 'picker.title': "Indicators";
@@ -979,13 +1143,14 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'history.changeTimeframe': "timeframe change";
     readonly 'history.changeChartStyle': "chart style change";
     readonly 'history.changePriceScale': "price scale change";
-    readonly 'history.changeAppearance': "appearance change";
+    readonly 'history.changeSettings': "settings change";
     readonly 'history.changeAddCompare': "add comparison";
     readonly 'history.changeRemoveCompare': "remove comparison";
     readonly 'history.changeCompare': "comparison change";
     readonly 'history.changeAddIndicator': "add indicator";
     readonly 'history.changeRemoveIndicator': "remove indicator";
     readonly 'history.changeIndicator': "indicator change";
+    readonly 'history.changeMovePane': "move pane";
     readonly 'history.changeAddDrawing': "add drawing";
     readonly 'history.changeRemoveDrawing': "remove drawing";
     readonly 'history.changeDrawing': "drawing change";
@@ -1002,6 +1167,19 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'chrome.sessionsHeading': "Sessions";
     readonly 'chrome.navigation': "Chart navigation";
     readonly 'chrome.activeChart': "{symbol}, {timeframe}";
+    readonly 'chrome.scaleHigh': "High";
+    readonly 'chrome.scaleLow': "Low";
+    readonly 'chrome.scaleBid': "Bid";
+    readonly 'chrome.scaleAsk': "Ask";
+    readonly 'chrome.scaleModes': "Scale modes";
+    readonly 'chrome.autoScale': "Auto scale";
+    readonly 'chrome.autoScaleMark': "A";
+    readonly 'chrome.logScale': "Logarithmic scale";
+    readonly 'chrome.logScaleMark': "L";
+    readonly 'chrome.currencyAndUnit': "{currency} · {unit}";
+    readonly 'chrome.priceLevelMenu': "Price actions";
+    readonly 'chrome.paneButtons': "Pane";
+    readonly 'chrome.deletePane': "Delete pane";
     readonly 'command.extension': "Host command";
     readonly 'command.viewReset': "Reset view";
     readonly 'command.viewGoLive': "Go to the live edge";
@@ -1010,6 +1188,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.viewScrollLeft': "Scroll back";
     readonly 'command.viewScrollRight': "Scroll forward";
     readonly 'command.priceCopy': "Copy price";
+    readonly 'command.marksRefresh': "Refresh marks";
     readonly 'command.symbolSet': "Change symbol";
     readonly 'command.styleCandles': "Candles";
     readonly 'command.styleHollow': "Hollow candles";
@@ -1018,8 +1197,8 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.styleArea': "Area";
     readonly 'command.styleBaseline': "Baseline";
     readonly 'command.styleStepline': "Step line";
-    readonly 'command.appearanceApply': "Chart appearance";
-    readonly 'command.appearanceReset': "Reset defaults";
+    readonly 'command.settingsApply': "Apply chart settings";
+    readonly 'command.settingsReset': "Apply defaults";
     readonly 'command.scaleNormal': "Regular price scale";
     readonly 'command.scaleLog': "Logarithmic price scale";
     readonly 'command.scalePercent': "Percentage price scale";
@@ -1059,6 +1238,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.drawingSettings': "Drawing settings";
     readonly 'command.drawingCommitEdit': "Apply drawing settings";
     readonly 'command.drawingPlaceImage': "Place image";
+    readonly 'command.drawingPlaceHorizontalLine': "Place horizontal line";
     readonly 'command.drawingTemplateApply': "Apply drawing template";
     readonly 'command.drawingTemplateSave': "Save drawing template";
     readonly 'command.drawingTemplateRemove': "Remove drawing template";
@@ -1091,6 +1271,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.themeDark': "Dark theme";
     readonly 'command.themeToggle': "Switch theme";
     readonly 'command.themeSet': "Set theme";
+    readonly 'command.settingsOpen': "Chart settings";
     readonly 'command.localeSet': "Language";
     readonly 'command.fullscreenEnter': "Fullscreen";
     readonly 'command.fullscreenExit': "Exit fullscreen";
@@ -1652,6 +1833,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'range.restoreChart': "Restore chart";
     readonly 'timezone.title': "Chart timezone";
     readonly 'timezone.exchange': "Exchange";
+    readonly 'timezone.quarter': "Q{quarter}";
     readonly 'timeframe.title': "Timeframe";
     readonly 'timeframe.all': "All timeframes";
     readonly 'timeframe.unitTicks': "Ticks";
@@ -1947,6 +2129,7 @@ declare const chartDictionaries: DictionaryLoader<{
         readonly other: "Remove {count} drawings";
     };
     readonly 'menu.settings': "Settings…";
+    readonly 'menu.drawHorizontalLine': "Draw horizontal line at {price}";
     readonly 'tool.trend_line': "Trend line";
     readonly 'tool.ray': "Ray";
     readonly 'tool.info_line': "Info line";
@@ -2041,12 +2224,15 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'legend.low': "L";
     readonly 'legend.close': "C";
     readonly 'legend.change': "{change} ({percent}%)";
+    readonly 'legend.volume': "Vol";
     readonly 'legend.indicatorSettings': "Indicator settings";
     readonly 'legend.showRows': "Show indicator rows";
     readonly 'legend.hideRows': "Hide indicator rows";
     readonly 'legend.restorePane': "Restore pane";
     readonly 'legend.collapsePane': "Collapse pane";
     readonly 'legend.maximizePane': "Maximize pane";
+    readonly 'legend.movePaneUp': "Move pane up";
+    readonly 'legend.movePaneDown': "Move pane down";
     readonly 'legend.showIndicator': "Show indicator";
     readonly 'legend.hideIndicator': "Hide indicator";
     readonly 'legend.scaleNormal': "Reg";
@@ -2255,42 +2441,246 @@ interface Glyph {
     size?: number;
 }
 
-interface ChartOverrides {
-    appearance: {
-        background: string;
+/** When an on-chart control shows: while the pointer is over its area, always, or never. */
+type ChartControlVisibility = 'hover' | 'always' | 'never';
+/** How a line is stroked. */
+type ChartStrokeStyle = 'solid' | 'dashed' | 'dotted';
+/** Which bar value a single-value style draws. */
+type ChartPriceSource = 'open' | 'high' | 'low' | 'close' | 'hl2' | 'hlc3' | 'ohlc4' | 'hlcc4';
+/** How prices are written: the symbol's own precision, a fixed count of decimals (0 to 15), or a
+ *  fraction of a whole (halves through 320ths). */
+type ChartPricePrecision = 'default' | `${0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15}` | `1/${2 | 4 | 8 | 16 | 32 | 64 | 128 | 320}`;
+/** The text a legend titles the symbol with. */
+type ChartTitleSource = 'name' | 'symbol' | 'symbolAndName';
+/** What the symbol's last-value label on the price scale holds: the value as the scale states it,
+ *  or the price with its percentage change beneath it. */
+type ChartLastValueMode = 'scale' | 'priceAndPercent';
+/** Where the price scales stand: stacked on the left, stacked on the right, or wherever each
+ *  series' scale belongs. */
+type ChartScalePlacement = 'left' | 'right' | 'auto';
+/** How the crosshair's time label writes a date, in the date's own order and separators. `qq` is the
+ *  quarter (Q3), `MMM` the month's short name, `MM` and `dd` two-digit numbers, `d` the day without a
+ *  leading zero, `yyyy` the whole year and `'yy` an apostrophe before its last two digits. The
+ *  weekday is not a part of any pattern: `timeScale.dayOfWeek` writes it before the date. */
+type ChartDateFormat = "qq 'yy" | 'qq yyyy' | "dd MMM 'yy" | "MMM 'yy" | 'MMM dd, yyyy' | 'MMM d, yyyy' | 'MMM yyyy' | 'MMM dd' | 'dd MMM' | 'yyyy-MM-dd' | 'yy-MM-dd' | 'yy/MM/dd' | 'yyyy/MM/dd' | 'dd-MM-yyyy' | 'dd-MM-yy' | 'dd/MM/yy' | 'dd/MM/yyyy' | 'MM/dd/yy' | 'MM/dd/yyyy';
+/** The date formats the time label writes, in the order a picker offers them. */
+declare const CHART_DATE_FORMATS: readonly ChartDateFormat[];
+/** A clock of 24 hours or of 12 with a day half. */
+type ChartHoursFormat = '24' | '12';
+/** The chart's background: one color, or a vertical gradient from the top color to the bottom. */
+type ChartBackgroundType = 'solid' | 'gradient';
+/** How a single-value line is colored: one color, or a vertical gradient from the top color at the
+ *  highest price on screen to the bottom color at the lowest. */
+type ChartLineColorType = 'solid' | 'gradient';
+/** Which trading hours an intraday chart shows: regular hours alone, regular hours with the pre-
+ *  and post-market stretches, or every stretch the symbol trades including the overnight one. */
+type ChartSessionHours = 'regular' | 'extended' | 'allHours';
+/** A single-value line style: the line and the step line share it. */
+interface LineStyleSettings {
+    priceSource: ChartPriceSource;
+    colorType: ChartLineColorType;
+    /** The solid color. */
+    color: string;
+    /** The gradient's color at the highest price on screen. */
+    gradientTopColor: string;
+    /** The gradient's color at the lowest price on screen. */
+    gradientBottomColor: string;
+    lineStyle: ChartStrokeStyle;
+    lineWidth: number;
+}
+/** The candle family: candles and hollow candles share it. */
+interface CandleStyleSettings {
+    /** Color each bar by its close against the previous bar's close, rather than against its own open. */
+    colorOnPreviousClose: boolean;
+    /** Fill the body. Off leaves the body hollow, so only its border and wick stand. */
+    body: boolean;
+    upColor: string;
+    downColor: string;
+    borders: boolean;
+    borderUpColor: string;
+    borderDownColor: string;
+    wick: boolean;
+    wickUpColor: string;
+    wickDownColor: string;
+}
+/** Every setting of a chart. */
+interface ChartSettings {
+    candles: CandleStyleSettings;
+    hollowCandles: Omit<CandleStyleSettings, 'colorOnPreviousClose'>;
+    bars: {
+        colorOnPreviousClose: boolean;
+        /** Draw high, low and close only: the open tick is left off. */
+        hlcBars: boolean;
         upColor: string;
         downColor: string;
-        /** Candle anatomy: the border ring and the wick are their OWN colors per direction. They do
-         *  NOT follow upColor/downColor; each is set independently. */
-        borderUpColor: string;
-        borderDownColor: string;
-        wickUpColor: string;
-        wickDownColor: string;
-        grid: boolean;
-        /** Shade pre-market / after-hours / overnight stretches. */
-        sessions: boolean;
-        /** Bar-close countdown pill on the price scale. */
+        thinBars: boolean;
+    };
+    line: LineStyleSettings;
+    stepLine: LineStyleSettings;
+    area: {
+        priceSource: ChartPriceSource;
+        lineColor: string;
+        lineStyle: ChartStrokeStyle;
+        lineWidth: number;
+        /** The fill's color at the line, fading to `bottomColor` at the pane's foot. */
+        topColor: string;
+        bottomColor: string;
+    };
+    baseline: {
+        priceSource: ChartPriceSource;
+        topLineColor: string;
+        topLineWidth: number;
+        /** The fill above the base level: its color at the line, fading to the second at the base. */
+        topFillColor1: string;
+        topFillColor2: string;
+        bottomLineColor: string;
+        bottomLineWidth: number;
+        /** The fill below the base level: its color at the base, deepening to the second at the line. */
+        bottomFillColor1: string;
+        bottomFillColor2: string;
+        /** Where the base level stands, as a percentage of the pane's height from its foot. */
+        baseLevelPercentage: number;
+    };
+    /** Settings of the charted symbol that hold whatever its style. */
+    symbol: {
+        /** Which trading hours an intraday chart shows. A stretch outside regular hours is shaded in its
+         *  own color below. */
+        session: ChartSessionHours;
+        /** The shading over the pre-market stretch. */
+        preMarketColor: string;
+        /** The shading over the post-market stretch. */
+        postMarketColor: string;
+        /** The shading over the overnight stretch, under `allHours`. */
+        nightColor: string;
+        precision: ChartPricePrecision;
+    };
+    /** The legend over the pane that names the symbol and states its values. */
+    statusLine: {
+        logo: boolean;
+        title: boolean;
+        titleSource: ChartTitleSource;
+        /** The bar's open, high, low and close. */
+        chartValues: boolean;
+        /** The bar's change and percentage change. */
+        barChange: boolean;
+        volume: boolean;
+        /** The change since the previous session's close, from the datafeed's quotes. */
+        lastDayChange: boolean;
+        /** An indicator row's title. */
+        indicatorTitles: boolean;
+        /** An indicator row's inputs, after its title. */
+        indicatorInputs: boolean;
+        /** An indicator row's values. */
+        indicatorValues: boolean;
+        background: boolean;
+        /** The background's opacity, 0 to 100. */
+        backgroundOpacity: number;
+    };
+    priceScale: {
+        /** The currency and unit box at the top of the price scale. */
+        currencyAndUnit: ChartControlVisibility;
+        /** The auto-scale and logarithmic buttons at the foot of the price scale. */
+        scaleModeButtons: ChartControlVisibility;
+        /** Hold the price-to-bar ratio while the time scale zooms. */
+        lockPriceToBarRatio: boolean;
+        /** The held ratio, or null to take the ratio the chart shows when the lock engages. */
+        priceToBarRatio: number | null;
+        placement: ChartScalePlacement;
+    };
+    priceLabels: {
+        /** Move price-scale labels apart so none overlaps another. */
+        noOverlappingLabels: boolean;
+        /** The add button beside the crosshair's price label, opening the price-level menu. */
+        plusButton: boolean;
+        /** The time left until the bar closes, under the last-value label. */
         countdown: boolean;
+        symbolName: boolean;
+        symbolValue: boolean;
+        symbolLine: boolean;
+        /** Null follows the last bar's color. */
+        symbolLineColor: string | null;
+        symbolLineWidth: number;
+        symbolValueMode: ChartLastValueMode;
+        /** An indicator's name label on the price scale. */
+        indicatorLabelName: boolean;
+        /** An indicator's value label on the price scale. */
+        indicatorLabelValue: boolean;
+        /** The last value of the pre-market, post-market or overnight stretch on the price scale. */
+        extendedHoursValue: boolean;
+        extendedHoursLine: boolean;
+        preMarketLabelColor: string;
+        postMarketLabelColor: string;
+        nightLabelColor: string;
+        previousCloseValue: boolean;
+        previousCloseLine: boolean;
+        previousCloseColor: string;
+        previousCloseLineWidth: number;
+        highLowValue: boolean;
+        highLowLine: boolean;
+        /** One color for the high and low lines and labels, or null for the factory pair: grey lines
+         *  and navy labels. */
+        highLowColor: string | null;
+        highLowLineWidth: number;
+        /** Bid and ask come from the datafeed's quotes. */
+        bidAskValue: boolean;
+        bidAskLine: boolean;
+        bidColor: string;
+        askColor: string;
+    };
+    timeScale: {
+        dayOfWeek: boolean;
+        dateFormat: ChartDateFormat;
+        hoursFormat: ChartHoursFormat;
+        /** Keep the chart's left edge at the same time when the timeframe changes. */
+        keepLeftEdge: boolean;
+    };
+    canvas: {
+        backgroundType: ChartBackgroundType;
+        /** The solid color, or the gradient's top. */
+        background: string;
+        /** The gradient's bottom. */
+        backgroundBottom: string;
+        verticalGrid: boolean;
+        verticalGridColor: string;
+        verticalGridStyle: ChartStrokeStyle;
+        horizontalGrid: boolean;
+        horizontalGridColor: string;
+        horizontalGridStyle: ChartStrokeStyle;
+        crosshairColor: string;
+        crosshairStyle: ChartStrokeStyle;
+        crosshairWidth: number;
+        /** The watermark's parts, written large behind the bars. */
+        watermarkTicker: boolean;
+        watermarkInterval: boolean;
+        watermarkDescription: boolean;
+        /** Name bar replay in the watermark while it runs. */
+        watermarkReplay: boolean;
+        watermarkColor: string;
+        scaleTextColor: string;
+        scaleTextSize: number;
+        scaleLineColor: string;
+        navigationButtons: ChartControlVisibility;
+        paneButtons: ChartControlVisibility;
+        /** Space above the highest bar, as a percentage of the pane's height. */
+        marginTop: number;
+        /** Space below the lowest bar, as a percentage of the pane's height. */
+        marginBottom: number;
+        /** Empty bar slots after the last bar. */
+        marginRight: number;
+    };
+    events: {
+        sessionBreaks: boolean;
+        sessionBreaksColor: string;
+        sessionBreaksStyle: ChartStrokeStyle;
+        sessionBreaksWidth: number;
     };
 }
-/** The brand palette, single-sourced: a host's own surfaces on the chart read these (an
- *  extension's lines among them), and a rebrand edits two strings. The candle bodies keep their
- *  own pair; see the note on DEFAULT_OVERRIDES for why. */
-declare const BRAND_UP = "#4c98fb";
-declare const BRAND_DOWN = "#f23645";
-declare const DEFAULT_OVERRIDES: ChartOverrides;
-/** A recursive partial of the tree — what a host supplies. */
-type PartialOverrides = {
-    [S in keyof ChartOverrides]?: Partial<ChartOverrides[S]>;
+/** A section's name. */
+type ChartSettingsSection = keyof ChartSettings;
+/** What a host or a viewer supplies: any leaves of any sections. */
+type PartialChartSettings = {
+    [S in ChartSettingsSection]?: Partial<ChartSettings[S]>;
 };
-/** Deep-fill a partial over the defaults. One level of nesting by design — the tree is two levels
- *  (section → leaf) and stays that way; new leaves are additive. */
-declare function mergeOverrides(partial?: PartialOverrides | null): ChartOverrides;
-/** The precedence composer: deep-fill any number of partials over an explicit BASE, later layers
- *  winning leaf by leaf. The widget's look resolves through this — its theme-derived floor, then
- *  the host's constructor partial, then runtime applyAppearance calls: one ladder where runtime
- *  beats constructor beats theme, expressed as one pure function. */
-declare function layerOverrides(base: ChartOverrides, ...partials: (PartialOverrides | null | undefined)[]): ChartOverrides;
 
 /** One resolved role as it is written to the DOM. */
 interface ThemeDeclaration {
@@ -2310,12 +2700,14 @@ interface ThemeRootStyle {
     /** One entry per role, ordered by role id. */
     declarations: readonly ThemeDeclaration[];
 }
-/** The theme values the canvas renderer draws with. The chart appearance ladder sits above these:
- *  a host override of a series color wins over `up` and `down` here, which are the mode's defaults
- *  for anything the appearance tree does not name. */
+/** The theme values the canvas renderer draws with. The chart settings sit above these: a host or a
+ *  viewer setting of a series color wins over `up` and `down` here, which are the mode's defaults
+ *  for anything the settings do not name. */
 interface CanvasTheme {
     background: string;
     paneBorder: string;
+    /** The ink a watermark writes behind the bars. */
+    watermark: string;
     grid: string;
     axisText: string;
     axisBackground: string;
@@ -2541,13 +2933,14 @@ interface ChartIconDiagnostic {
 }
 
 /** The glyphs of the chart's own controls, by meaning, each with every drawing that carries it. */
-declare const CONTROL_ICONS: Readonly<Record<"info" | "search" | "bold" | "indicators" | "visible" | "textColor" | "lineColor" | "open" | "close" | "template" | "fillColor" | "italic" | "locked" | "sync" | "caret" | "measure" | "image" | "eraser" | "delete" | "remove" | "hidden" | "copy" | "pause" | "play" | "reset" | "scroll" | "magnet" | "compare" | "replay" | "settings" | "fullscreen" | "marketStatus" | "paneCollapse" | "paneRestore" | "paneMaximize" | "replayStatus" | "replayMark" | "replayCut" | "undo" | "redo" | "tileMaximize" | "tileRestore" | "download" | "chevronDown" | "chevronUp" | "chevronLeft" | "chevronRight" | "check" | "clear" | "goLive" | "stepForward" | "stepBack" | "calendar" | "selectBar" | "firstAvailable" | "randomBar" | "clock" | "cursorCross" | "cursorDot" | "cursorArrow" | "magnetStrong" | "drawingsShown" | "drawingsHidden" | "indicatorsShown" | "indicatorsHidden" | "allShown" | "allHidden" | "zoomIn" | "grip" | "tableAddColumn" | "tableAddRow" | "favoritesBar" | "lineSolid" | "lineDashed" | "lineDotted" | "lineThickness1" | "lineThickness2" | "lineThickness3" | "lineThickness4" | "lineEndNormal" | "lineEndArrow" | "fullscreenExit" | "collapse" | "zoomOut" | "add" | "rename" | "duplicate" | "favorite" | "favorited" | "sortAscending" | "sortDescending" | "flyout" | "submenu" | "more" | "emptySearch" | "emptyCompare" | "operatorsShow" | "operatorsHide" | "operatorAdd" | "operatorSubtract" | "operatorMultiply" | "operatorDivide" | "operatorPower" | "operatorReciprocal" | "selectDate" | "zoomTool" | "stayInMode" | "stayInModeOn" | "unlocked" | "hide" | "glyphTools" | "visualOrder", readonly Glyph[]>>;
+declare const CONTROL_ICONS: Readonly<Record<"info" | "search" | "bold" | "open" | "close" | "volume" | "indicators" | "copy" | "textColor" | "visible" | "lineColor" | "template" | "fillColor" | "italic" | "locked" | "sync" | "caret" | "tip" | "measure" | "image" | "eraser" | "delete" | "remove" | "hidden" | "pause" | "play" | "reset" | "scroll" | "magnet" | "collapse" | "paneCollapse" | "paneRestore" | "paneMaximize" | "marketStatus" | "replayStatus" | "replayMark" | "replayCut" | "replay" | "undo" | "redo" | "settings" | "fullscreen" | "tileMaximize" | "tileRestore" | "download" | "chevronDown" | "chevronUp" | "chevronLeft" | "chevronRight" | "check" | "clear" | "goLive" | "stepForward" | "stepBack" | "calendar" | "selectBar" | "firstAvailable" | "randomBar" | "clock" | "cursorCross" | "cursorDot" | "cursorArrow" | "magnetStrong" | "drawingsShown" | "drawingsHidden" | "indicatorsShown" | "indicatorsHidden" | "allShown" | "allHidden" | "zoomIn" | "grip" | "tableAddColumn" | "tableAddRow" | "favoritesBar" | "lineSolid" | "lineDashed" | "lineDotted" | "lineThickness1" | "lineThickness2" | "lineThickness3" | "lineThickness4" | "lineEndNormal" | "lineEndArrow" | "settingsSymbol" | "settingsStatusLine" | "settingsScales" | "settingsCanvas" | "settingsEvents" | "compare" | "fullscreenExit" | "paneMoveUp" | "paneMoveDown" | "zoomOut" | "add" | "rename" | "duplicate" | "favorite" | "favorited" | "sortAscending" | "sortDescending" | "flyout" | "submenu" | "more" | "emptySearch" | "emptyCompare" | "operatorsShow" | "operatorsHide" | "operatorAdd" | "operatorSubtract" | "operatorMultiply" | "operatorDivide" | "operatorPower" | "operatorReciprocal" | "selectDate" | "zoomTool" | "stayInMode" | "stayInModeOn" | "unlocked" | "hide" | "glyphTools" | "visualOrder" | "volumeMuted", readonly Glyph[]>>;
 /** An icon of one of the chart's own controls. */
 type ControlIconId = keyof typeof CONTROL_ICONS;
 /** Every icon a host may draw: a control's glyph by its meaning, a chart style by its id, a drawing
- *  tool by its registry type, and a layout arrangement by its code. Exactly the ids in
- *  `CHART_ICON_IDS`, so an id the chart does not draw is a type error before it is a refusal. */
-type ChartIconId = ControlIconId | `style.${ChartStyleId}` | `tool.${MiniatureTool}` | `layout.${ArrangementGlyphCode}`;
+ *  tool by its registry type, a layout arrangement by its code, and a time-scale mark's glyph by its
+ *  shape. Exactly the ids in `CHART_ICON_IDS`, so an id the chart does not draw is a type error
+ *  before it is a refusal. */
+type ChartIconId = ControlIconId | `style.${ChartStyleId}` | `tool.${MiniatureTool}` | `layout.${ArrangementGlyphCode}` | MarkIconId;
 /** A host's drawings for the chart's icons, by id. An icon left out keeps the chart's own. */
 type ChartIcons = {
     readonly [K in ChartIconId]?: ChartIconFactory;
@@ -2556,7 +2949,7 @@ type ChartIcons = {
  *  draws the left-to-right form of these. */
 declare const MIRRORED_ICONS: ReadonlySet<ChartIconId>;
 /** Every published icon id, in catalog order: the controls, then the styles, the tools and the
- *  layouts in their registries' orders. */
+ *  layouts in their registries' orders, then the mark glyphs. */
 declare const CHART_ICON_IDS: readonly ChartIconId[];
 /** The chart's own drawing of an icon, as markup a host draws without the chart: a toolbar of its
  *  own, a native view. */
@@ -2700,6 +3093,8 @@ interface IndicatorPlots {
         valuesInStatusLine?: boolean;
         inputsInStatusLine?: boolean;
     };
+    /** The name written beside each plot's value label on the price scale. Absent writes none. */
+    scaleTitle?: string;
     /** Set when the indicator can't be computed from the current feed (e.g. no volume) — no plots
      *  are drawn and the host may surface the note. */
     unavailable?: string;
@@ -2805,8 +3200,187 @@ declare function attachIndicators(chart: IChartApi, options?: {
      *  live, so a theme switch repaints the levels with everything else; the built-in dark palette's
      *  neutral stands in for a host that supplies none. */
     neutral?: () => string;
+    /** The index of the pane the main series stands in, where overlays are drawn and which is never
+     *  swept. A viewer may move it below another pane; the first pane when absent. */
+    mainPane?: () => number;
 }): IndicatorsRenderer;
 
+/** The chart's own pages, in rail order. */
+type ChartSettingsPageId = 'symbol' | 'statusLine' | 'scales' | 'canvas' | 'events';
+/** Paints an icon into a box and answers the disposer that empties it. */
+type ChartSettingsIconPainter = (box: HTMLElement) => () => void;
+/** One choice of a select. */
+interface ChartSettingsOption<V extends string> {
+    value: V;
+    label: string;
+}
+/** A tip beside a label: a short line on hover, or a card with a title and a body. */
+type ChartSettingsTip = {
+    kind: 'hint';
+    text: string;
+    href?: string;
+} | {
+    kind: 'card';
+    title: string;
+    body: string;
+    href?: string;
+};
+/** A row's handle, for a row whose state another row decides. */
+interface ChartSettingsRowHandle {
+    setDisabled(disabled: boolean): void;
+}
+/** The form a page is built with. Every builder appends a row to the page in call order, and the
+ *  row's `id` names it for a contribution placed before it. The chart's own rows are named by the
+ *  leaf they edit (`background` on the Status line page, for one), and a section the chart shows
+ *  only in some contexts by its own name (`indicators` on the Status line page).
+ *
+ *  A checkbox row that is unchecked disables its own controls and every row indented under it, and
+ *  a disabled row stands its checkbox and its label back. */
+interface ChartSettingsForm {
+    /** A section heading, written in capitals. Every heading after a page's first stands clear of the
+     *  section before it. */
+    heading(text: string): void;
+    /** A checkbox row. `indent` makes it a sub-row of the row above, and `hint` is the grey line
+     *  under it. `controls` builds the row's controls after its label. */
+    check(row: {
+        id: string;
+        label: string;
+        checked: boolean;
+        onChange(checked: boolean): void;
+        hint?: string;
+        tip?: ChartSettingsTip;
+        indent?: boolean;
+        disabled?: boolean;
+        controls?(controls: ChartSettingsControls): void;
+    }): ChartSettingsRowHandle;
+    /** A labelled row whose label is plain text and whose controls follow it. */
+    field(row: {
+        id: string;
+        label: string;
+        tip?: ChartSettingsTip;
+        indent?: boolean;
+        disabled?: boolean;
+        controls(controls: ChartSettingsControls): void;
+    }): ChartSettingsRowHandle;
+}
+/** The controls a row holds, laid out after its label in call order. A control is named for a
+ *  reader by its row's label unless `label` names it, as each of two colors on one row needs. */
+interface ChartSettingsControls {
+    /** A color swatch. `opacity` adds the picker's opacity slider; `lineStyle` and `lineWidth` make
+     *  it a color and line swatch whose picker also sets them. A null color follows the bars. */
+    color(control: {
+        color: string | null;
+        onColor(color: string): void;
+        opacity?: boolean;
+        lineStyle?: {
+            value: 'solid' | 'dashed' | 'dotted';
+            onChange(style: 'solid' | 'dashed' | 'dotted'): void;
+        };
+        lineWidth?: {
+            value: number;
+            options: readonly number[];
+            onChange(width: number): void;
+        };
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    select<V extends string>(control: {
+        value: V;
+        options: readonly ChartSettingsOption<V>[];
+        width: number;
+        onChange(value: V): void;
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    /** A select whose list checks any number of its options, and whose button joins the checked
+     *  labels or reads `none` when none is checked. The labels after the first are joined in lower
+     *  case unless `asWritten`. */
+    multiSelect<V extends string>(control: {
+        values: readonly V[];
+        options: readonly ChartSettingsOption<V>[];
+        width: number;
+        none: string;
+        onChange(values: readonly V[]): void;
+        asWritten?: boolean;
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    /** A number field, 100 pixels wide unless `width` says otherwise, and the unit after it. The value
+     *  is reported when the field is left or a stepper is pressed. NaN leaves the field empty. */
+    number(control: {
+        value: number;
+        min: number;
+        max: number;
+        step: number;
+        suffix?: string;
+        width?: number;
+        onChange(value: number): void;
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    /** A line's thickness on its own, as a field wearing the thickness, whose list offers `options`. */
+    lineWidth(control: {
+        value: number;
+        options: readonly number[];
+        onChange(width: number): void;
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    /** A level from 0 to 1, as a volume with a speaker before it or as an opacity over its color. A
+     *  drag reports every step it passes. */
+    slider(control: {
+        value: number;
+        kind: 'volume' | {
+            opacity: string;
+        };
+        onChange(value: number): void;
+        label?: string;
+        disabled?: boolean;
+    }): void;
+    /** Start a second line of controls under the first, in the controls' column. */
+    nextLine(): void;
+}
+/** A host's contribution to the settings dialog. */
+interface ChartSettingsContribution {
+    /** Either a page of the host's own, placed after another page (or last), or rows appended to one
+     *  of the chart's pages, before one of its rows (or at its end). `before` may name several rows or
+     *  sections: the rows land before the first of them the page holds, so a placement survives a
+     *  section the page shows only in some contexts (the Status line page's `indicators`).
+     *
+     *  `after` names the page to follow: one of the chart's (a `ChartSettingsPageId`) or another
+     *  contributed page's id. A list names several, and the first of them the dialog holds wins, so
+     *  `after: ['trading', 'canvas']` follows a contributed `trading` page where there is one and the
+     *  Canvas page otherwise. The order is read once every contribution is known, so a page stands
+     *  after the contributed page it names whichever attached first. Pages that name the same
+     *  page stand after it in the order their extensions attach, each followed by the pages that name
+     *  it: the order of the widget's `extensions` (an extension attached again on a symbol switch
+     *  keeps its place), and one extension's pages in the order it contributes them. A page whose
+     *  `after` names no page the dialog holds, or is absent, stands last in the same order. */
+    place: {
+        page: {
+            id: string;
+            label: string;
+            icon: ChartSettingsIconPainter;
+            after?: string | readonly string[];
+        };
+    } | {
+        into: ChartSettingsPageId;
+        before?: string | readonly string[];
+    };
+    /** Build the rows. The dialog calls it whenever the page is drawn, including after every change
+     *  a row reports, so it reads the host's current state each time. */
+    build(form: ChartSettingsForm): void;
+    /** The dialog opened: answer the state that Cancel restores. */
+    open?(): unknown;
+    /** The viewer cancelled: restore the state `open` answered. Changes preview as they are made, so
+     *  this is the only undo. */
+    cancel?(state: unknown): void;
+    /** The viewer pressed Ok. */
+    commit?(): void;
+    /** The viewer chose "Apply defaults": return every setting this contribution owns to its default. */
+    applyDefaults?(): void;
+}
+
 /** Price display as an extension reads it — the chart's own formatter, so an overlay's label and the
  *  axis beside it can never disagree about what a number looks like. */
 interface ChartPriceFormatter {
@@ -2924,9 +3498,10 @@ interface ChartExtensionMenuItem {
     checked?: boolean;
     /** The row's glyph. Omitted leaves the gutter empty and the label still aligned. */
     icon?: ChartExtensionIcon;
-    /** Where the row sits. `level` (the default) is an action on the price the pointer landed on and
-     *  joins the group under Copy price and Paste; `view` is a switch over what the chart shows and
-     *  joins the group under the remove rows. */
+    /** Where the row sits. `level` (the default) is an action on the price the pointer landed on: it
+     *  joins the group under Copy price and Paste, and the price menu the price scale's plus opens,
+     *  where each extension's rows stand together; `view` is a switch over what the chart shows and
+     *  joins the group under the remove rows, and the price menu leaves it out. */
     group?: 'level' | 'view';
     run(): void;
 }
@@ -2959,6 +3534,42 @@ interface ChartExtensionHideLayerHandle {
     /** Withdraw the layer from the eye. Detach withdraws it either way. */
     remove(): void;
 }
+/** A row of an extension's own in the pane's legend: an element the extension builds and keeps,
+ *  which the chart places under the symbol's reading and above the indicator rows. The row wears the
+ *  status line's backdrop like the legend's own parts, and takes the pointer, so its controls are
+ *  pressed rather than the chart under them. Whether it shows, and what it holds, is the
+ *  extension's own state: it hides or fills the element as it likes. */
+interface ChartExtensionLegendRow {
+    element: HTMLElement;
+    /** Where the row stands among contributed rows: a lower rank first, then the rows of one rank
+     *  as they were contributed. Absent reads as 0. */
+    rank?: number;
+}
+/** The frame a contribution paints an image of the chart in. */
+interface ChartExtensionCaptureFrame {
+    /** The chart element's width in CSS pixels. */
+    width: number;
+    /** The chart element's height in CSS pixels. */
+    height: number;
+    /** Image pixels per CSS pixel. */
+    pixelRatio: number;
+}
+/** An extension's part in an image of the chart. Every image the chart produces of itself (a
+ *  download, a copy, `image.capture()`) is taken through the contributions of the extensions
+ *  attached to it: each `before` runs, the renderer draws the image, each `paint` paints over it,
+ *  and each restore runs, the last answered first. A contribution that throws is contained: the
+ *  image is still produced and every restore still runs. */
+interface ChartExtensionCapture {
+    /** Runs synchronously before the chart draws into the image; answer the restore, run after it is
+     *  taken. The renderer draws every pending change before it takes the image, so what a `before`
+     *  changed through the chart's capabilities (a price line it updated, a primitive it asked to
+     *  redraw) is drawn as it now stands. */
+    before?(): (() => void) | void;
+    /** Runs after the bitmap is taken: paint over it. The origin is the chart element's top left,
+     *  which is the top left of the context's `container`; pixelRatio is image pixels per CSS pixel.
+     *  The context arrives untransformed, and the chart puts back its state after each paint. */
+    paint?(target: CanvasRenderingContext2D, frame: ChartExtensionCaptureFrame): void;
+}
 /** Builds an extension's context menu rows. The chart calls it on every raise with that moment's
  *  context, so the rows can depend on the level that was pressed. An empty list contributes nothing
  *  and costs nothing. */
@@ -2987,8 +3598,8 @@ interface ChartExtensionContext {
      *  over every pane and over whatever the page stacks around the widget mounts HERE, at viewport
      *  coordinates; the context menu does the same. */
     layer: HTMLElement;
-    /** The chart's effective canvas palette: the mode's resolved theme with any applied appearance
-     *  overrides on top, projected onto the values a canvas draws with. */
+    /** The chart's effective canvas palette: the mode's resolved theme under the chart settings
+     *  in effect, projected onto the values a canvas draws with. */
     theme(): CanvasTheme;
     formatter(): ChartPriceFormatter;
     /** The name symbology gives the charted market, for a surface that prints it; `chart.symbol()`
@@ -3020,6 +3631,21 @@ interface ChartExtensionContext {
     contributeContextMenu(build: ChartExtensionMenuBuilder): () => void;
     contributeCommands(commands: readonly ChartExtensionCommand[]): () => void;
     contributeHideLayer(layer: ChartExtensionHideLayer): ChartExtensionHideLayerHandle;
+    /** Add a page of the extension's own to the chart settings dialog, or rows to one of the chart's
+     *  pages. The dialog lists what the active chart's extensions contribute when it opens; the
+     *  returned function withdraws the contribution, and detach withdraws it either way. */
+    contributeSettings(contribution: ChartSettingsContribution): () => void;
+    /** Place a row of the extension's own in the pane's legend. The returned function takes it out,
+     *  and detach takes it out either way; the element is the extension's to keep. */
+    contributeLegendRow(row: ChartExtensionLegendRow): () => void;
+    /** Ask the datafeed for the chart's bar marks and time-scale marks again, now, and draw what it
+     *  answers: for an extension whose own setting changes what the feed serves, such as a row it
+     *  contributes to the settings dialog, so the change shows while the dialog is open. */
+    refreshMarks(): void;
+    /** Take part in every image of the chart: hold out what the extension draws while the image is
+     *  taken, or paint over the image what the chart's canvases do not carry. The returned function
+     *  withdraws the contribution, and detach withdraws it either way. */
+    contributeCapture(capture: ChartExtensionCapture): () => void;
 }
 /** What an extension gives back at attach. `detach` is required; the two state methods are the
  *  opt-in for anything the viewer would expect a saved chart to bring back. */
@@ -3162,8 +3788,10 @@ declare function clipToWindow(bars: readonly FeedBar[], window: {
     to: number;
 } | null): FeedBar[];
 /** Placement → where the series goes. Pane index for 'new-pane' is resolved at add time (the
- *  chart's CURRENT pane count), matching the indicator renderer's rule. */
-declare function seriesTargetOf(placement: ComparePlacement, paneCount: number): {
+ *  chart's CURRENT pane count), matching the indicator renderer's rule. A 'new-scale' series takes
+ *  the side the main series does not stand on, the left unless named. The other two stand in the
+ *  main pane, the first unless a viewer moved it. */
+declare function seriesTargetOf(placement: ComparePlacement, paneCount: number, secondScale?: 'left' | 'right', mainPane?: number): {
     paneIndex: number;
     priceScaleId?: string;
 };
@@ -3179,6 +3807,12 @@ interface CompareDeps {
     } | null;
     /** How many bars a fresh compare asks for when the main window is not yet known. */
     seedCountBack?: number;
+    /** The side the main series' price scale stands on; the right when absent. A 'new-scale'
+     *  comparison takes the other side. */
+    mainScale?(): 'left' | 'right';
+    /** The index of the pane the main series stands in, which a 'same-percent' or 'new-scale'
+     *  comparison shares; the first pane when absent. */
+    mainPane?(): number;
     /** Entries changed (add/remove/visibility/color) or a comparison's latest value moved — hosts
      *  re-render their legend from `list()` / `latest()`. */
     onChange?(): void;
@@ -3208,9 +3842,9 @@ interface CompareHandle {
     list(): CompareEntry[];
     /** The latest clipped close for one comparison, or null (no bars in window / unknown symbol). */
     latest(symbol: string): number | null;
-    /** The pane the comparison's series currently lives on (0 = the main pane), or null for an
-     *  unknown symbol — how a host places the comparison's legend row in the right pane's group. Read
-     *  live from the series, because 'new-pane' indices shift as other panes come and go. */
+    /** The pane the comparison's series currently lives on, or null for an unknown symbol: how a host
+     *  places the comparison's legend row in the right pane's group. Read live from the series,
+     *  because pane indices shift as other panes come, go and move. */
     paneIndexOf(symbol: string): number | null;
     /** Percent change across the clipped window (last close vs the window's FIRST in-window close —
      *  the loaded-window approximation of the percent scale's first-visible-bar base), or null with
@@ -3224,6 +3858,9 @@ interface CompareHandle {
     sync(): void;
     /** The chart's timeframe changed: every comparison refetches at the new bucket size. */
     setTimeframe(): void;
+    /** The main series' price scale moved to the other side: every 'new-scale' comparison moves to
+     *  the side it left, and that side shows while one lives. */
+    scaleMoved(): void;
     serialize(): CompareSnapshot[];
     /** Replace the whole set from a snapshot (restore path). Unknown placements are dropped. */
     restore(snapshot: readonly unknown[]): void;
@@ -3519,7 +4156,7 @@ interface ChartSaveLoadApi {
 }
 
 /** What one step says changed, in the order a diff asks. */
-type HistoryChange = 'symbol' | 'timeframe' | 'style' | 'priceScale' | 'appearance' | 'compareAdd' | 'compareRemove' | 'compareChange' | 'indicatorAdd' | 'indicatorRemove' | 'indicatorChange' | 'drawingAdd' | 'drawingRemove' | 'drawingChange';
+type HistoryChange = 'symbol' | 'timeframe' | 'style' | 'priceScale' | 'settings' | 'compareAdd' | 'compareRemove' | 'compareChange' | 'indicatorAdd' | 'indicatorRemove' | 'indicatorChange' | 'paneMove' | 'drawingAdd' | 'drawingRemove' | 'drawingChange';
 /** The undo surface a control and a command read. */
 interface ChartHistoryApi {
     canUndo(): boolean;
@@ -3613,8 +4250,12 @@ interface CommandSpec {
     labelText?: string;
     /** The default shortcut, in `KeyboardEvent` terms (e.g. `Alt+KeyR`). */
     shortcut?: string;
-    /** Whether the command can run right now, from capability and chart state. */
-    available(): boolean;
+    /** Whether the command can run right now, from capability and chart state. A command whose one id
+     *  spans many subjects reads the argument it would run with, and answers for that subject: the
+     *  top pane cannot move up. Asked with none, it answers whether any subject could, unless a run
+     *  with none acts on a subject of its own, as the horizontal line at the crosshair's price does,
+     *  and then for that subject. */
+    available(arg?: unknown): boolean;
     /** Whether the access policy refuses this argument, for a command whose one id spans many
      *  subjects (the tool to arm). A refused argument answers `denied`, as a refused id does. */
     refuses?(arg: unknown): boolean;
@@ -3643,8 +4284,8 @@ interface CommandRegistry {
     /** Every registered command, in registration order. Unavailable and denied commands are listed:
      *  a menu decides whether to draw a disabled row, and hiding one would leave the host guessing. */
     list(): readonly CommandSpec[];
-    /** Whether `execute` would run this command right now. */
-    available(id: string): boolean;
+    /** Whether `execute` would run this command right now, with this argument where it takes one. */
+    available(id: string, arg?: unknown): boolean;
     execute(id: string, arg?: unknown): CommandResult;
     /** Remap a shortcut, or clear it with null. */
     setShortcut(id: string, shortcut: string | null): void;
@@ -3999,6 +4640,8 @@ interface DrawingsHandle {
     setVisibilityPreset(preset: VisibilityPreset): void;
     /** Drop a ready picture onto the chart, centred in view, selected. */
     placeImage(image: PlacedImage): void;
+    /** Place a horizontal line at a price in the tool's default look, selected. */
+    placeHorizontalLine(price: number): void;
     /** Blank every drawing (the eye), without touching any drawing's own switch. */
     setAllHidden(hidden: boolean): void;
     allHidden(): boolean;
@@ -4157,7 +4800,7 @@ declare function mountContextMenu(container: HTMLElement, run: (id: ChartMenuAct
  *  timeframe, tick, price format, teardown) and minus the session verbs only the package's own
  *  surfaces use (the live `IDrawing`, the preview and edit session, the inline text session, the
  *  presets). The public surface grows on demand, not by exposure. */
-type ChartDrawingsApi = Omit<DrawingsHandle, 'setSymbol' | 'setTimeframe' | 'setTick' | 'setCurrency' | 'setPriceFormatter' | 'destroy' | 'selectedDrawing' | 'commitEdit' | 'beginPreview' | 'endPreview' | 'textEdit' | 'commitText' | 'cancelText' | 'presets'>;
+type ChartDrawingsApi = Omit<DrawingsHandle, 'setSymbol' | 'setTimeframe' | 'setTick' | 'setCurrency' | 'setPriceFormatter' | 'destroy' | 'selectedDrawing' | 'commitEdit' | 'beginPreview' | 'endPreview' | 'textEdit' | 'commitText' | 'cancelText' | 'presets' | 'placeHorizontalLine'>;
 
 /** What a preset frames: seconds of history, the year to date, or everything loaded. */
 type RangeSpan = number | 'ytd' | 'all';
@@ -4336,14 +4979,24 @@ interface ChartHandle {
     /** Stepping back and forward through this chart's own content. Each step is one reading of the
      *  content, so a step back puts the whole reading back rather than reversing one verb. */
     history: ChartHistoryApi;
-    /** The EFFECTIVE appearance tree: the mode's floor, the constructor partial, then every runtime
-     *  layer. */
-    appearance(): ChartOverrides;
-    /** Apply an appearance partial at RUNTIME: the top of the precedence ladder. Later calls layer
-     *  over earlier ones leaf by leaf, so two hosts' calls compose instead of clobbering. */
-    applyAppearance(partial: PartialOverrides): void;
+    /** The EFFECTIVE settings tree: the theme's factory values, the host's constructor partial, then
+     *  the viewer's own leaves. */
+    settings(): ChartSettings;
+    /** Apply a partial to the viewer's own leaves: the top of the precedence ladder. Later calls layer
+     *  over earlier ones leaf by leaf, so two callers compose instead of clobbering. A leaf the tree
+     *  does not have, or a value its leaf cannot hold, is ignored. The change is a content change: it
+     *  marks the chart for saving and is a step of its history. */
+    applySettings(partial: PartialChartSettings): void;
+    /** Drop the viewer's own leaves and put the price scale back to normal. The theme's values and the
+     *  host's partial stand; the viewport and every other preference are untouched. */
+    resetSettings(): void;
     /** The chart's one price formatter, in the chart's language and on the symbol's own grid. */
     formatter(): PriceFormatter;
+    /** Ask the datafeed for this chart's bar marks and time-scale marks again, now, over the window
+     *  the chart holds, and draw what it answers in place of what is drawn. A host calls it when a
+     *  change of its own changes what its feed serves, so the change shows at once. A chart that draws
+     *  no marks, or holds no bars yet, asks nothing. */
+    refreshMarks(): void;
     saveLoad: ChartSaveLoadApi;
     /** Pane-composition sync primitives, which a layout drives. */
     sync: ChartPaneSyncApi;
@@ -4739,6 +5392,8 @@ interface Capabilities {
     /** The feed serves neutral bar marks / time-scale marks. */
     marks: boolean;
     timescaleMarks: boolean;
+    /** The feed serves a symbol's live prices: its bid, ask, last and previous close. */
+    prices: boolean;
     /** How live the active symbol's data is; null until it resolves. */
     dataStatus: DataStatus | null;
     /** Which saved-resource families the adapter carries. All false without an adapter. */
@@ -5072,10 +5727,11 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     drawingPersistence?: DrawingPersistenceOptions;
     /** The product theme: which built-in mode, and any custom semantic palettes. */
     theme?: ThemeOptions;
-    /** Chart appearance: the typed override tree over the mode's defaults. This is the other
-     *  precedence ladder, and it wins over the palette wherever both could reach the same pixel:
-     *  runtime `applyAppearance` beats this, and this beats what the theme resolves to. */
-    appearance?: PartialOverrides;
+    /** The chart settings this host opens every chart with: any leaves of any sections, over the
+     *  theme's factory values. This is the other precedence ladder, and it wins over the palette
+     *  wherever both could reach the same pixel: the viewer's own settings (`applySettings`, the
+     *  settings dialog, a saved chart) beat this, and this beats what the theme resolves to. */
+    settings?: PartialChartSettings;
     /** Which chart behavior exists. */
     features?: FeatureConfig;
     /** Which of the chart's own controls render. */
@@ -5421,6 +6077,9 @@ interface PaneState {
     heights: Readonly<Record<number, number>>;
     /** Heights remembered from BEFORE the pane's current collapse/maximize, by pane index. */
     remembered: Readonly<Record<number, number>>;
+    /** The index of the main pane, which a viewer may move below another pane. The first when
+     *  absent. */
+    main?: number;
 }
 interface PanePlan {
     /** Heights to apply, by pane index (only entries that change). */
@@ -5429,7 +6088,7 @@ interface PanePlan {
     remembered: Record<number, number>;
 }
 /** Plan one pane operation. The TOTAL height is conserved exactly — the space a pane gives up goes
- *  to the main pane (0) and vice versa, because the chart's own height is fixed by its container;
+ *  to the main pane and vice versa, because the chart's own height is fixed by its container;
  *  handing back a different sum would make the renderer redistribute unpredictably. */
 declare function planPaneOp(state: PaneState, op: PaneOp): PanePlan;
 /** Whether a pane currently reads as collapsed (drives which control the legend shows).
@@ -5450,14 +6109,32 @@ declare const SESSION_LABEL: Readonly<Record<SessionState, string>>;
  *  against the theme in effect, so the marker follows light or dark and a host's custom palette
  *  instead of carrying a color of its own. */
 declare const SESSION_DOT: Readonly<Record<SessionState, ThemeRoleId>>;
-/** A series primitive that shades every non-regular-hours stretch of the visible chart. Bars are
- *  read back from the price series (no second feed), classified under the symbol's CURRENT session
- *  model, merged into runs, and drawn as full-height rects UNDER the main series (zOrder bottom).
- *  Re-renders with every chart paint, so it tracks pan/zoom for free. An UNKNOWN model (null)
- *  never bands: drawing nothing is the only honest render before the symbol resolves. A continuous
- *  market never bands (it is always open), and bands render on INTRADAY timeframes only: a daily or
- *  larger bar spans whole sessions, so classifying its single timestamp would shade entire days by
- *  whichever session that instant fell in. */
+/** The bar times among `times` (ascending) that open a new trading day: each bar whose trading day,
+ *  read in the exchange zone, differs from the bar before it. The first bar opens nothing, because
+ *  the day before it is not on screen. */
+declare function sessionBreakTimes(model: SessionModel, times: readonly number[]): number[];
+/** How the bands look under the chart settings: the shading of each stretch outside regular hours
+ *  (null leaves it clear) and the line at each session's start (null draws none). The closed
+ *  stretch keeps its theme role. */
+interface SessionLook {
+    pre: string | null;
+    after: string | null;
+    extended: string | null;
+    breaks: {
+        color: string;
+        width: number;
+        style: ChartStrokeStyle;
+    } | null;
+}
+/** A series primitive that shades every non-regular-hours stretch of the visible chart and draws a
+ *  vertical line where each trading day starts. Bars are read back from the price series (no
+ *  second feed), classified under the symbol's CURRENT session model, merged into runs, and drawn as
+ *  full-height rects UNDER the main series (zOrder bottom). Re-renders with every chart paint, so it
+ *  tracks pan/zoom for free. An UNKNOWN model (null) draws nothing: drawing nothing is the only
+ *  honest render before the symbol resolves. A continuous market never bands (it is always open),
+ *  though its days still break. Both render on INTRADAY timeframes only: a daily or larger bar spans
+ *  whole sessions, so classifying its single timestamp would shade entire days by whichever session
+ *  that instant fell in, and every bar would start a day. */
 interface SessionBandsPrimitive {
     paneViews(): unknown[];
     attached(param: {
@@ -5470,9 +6147,14 @@ interface SessionBandsPrimitive {
      *  repaint (on a quiet market: never). */
     refresh(): void;
 }
-declare function createSessionBands(chart: IChartApi, series: ISeriesApi<SeriesType>, enabled: () => boolean, model: () => SessionModel | null, intraday: () => boolean, 
+declare function createSessionBands(chart: IChartApi, series: ISeriesApi<SeriesType>, 
+/** Whether the stretches outside regular hours are shaded. */
+enabled: () => boolean, model: () => SessionModel | null, intraday: () => boolean, 
 /** The theme in effect. Read at draw time, so a mode switch repaints the bands with the pane. */
-theme: () => SemanticTheme): SessionBandsPrimitive;
+theme: () => SemanticTheme, 
+/** The colors and the session breaks the chart settings ask for. Without it each stretch wears
+ *  its theme role and no break is drawn. */
+look?: () => SessionLook): SessionBandsPrimitive;
 
 /** The compact editor beside `rect` inside `container`, its glyphs drawn from the chart's own
  *  artwork. */
@@ -5486,6 +6168,61 @@ declare function openInputsEditor(container: HTMLElement, rect: {
  *  field's name and an enum's options are the manifest's own vocabulary and are not translated. */
 strings?: ChartI18n): void;
 
+/** The chart settings a chart opens with under a resolved theme, before any host or viewer names a
+ *  leaf. */
+declare function chartSettingsDefaults(theme: SemanticTheme): ChartSettings;
+/** Every section of the tree, in its order. */
+declare const CHART_SETTINGS_SECTIONS: readonly ChartSettingsSection[];
+/** What reading a stored partial kept, and the `section.leaf` paths it had to drop because the value
+ *  was not one the leaf can hold. A path the tree does not have at all is ignored rather than
+ *  reported: it is a leaf this build does not know, not a broken one. */
+interface ReadChartSettings {
+    settings: PartialChartSettings;
+    rejected: string[];
+}
+/** Read a stored or supplied partial. `isColor` decides whether a string is a color the renderer can
+ *  paint; the portable parser is the default. */
+declare function readPartialChartSettings(raw: unknown, isColor?: (value: string) => boolean): ReadChartSettings;
+/** Layer partials over a complete tree, later partials winning leaf by leaf. A leaf the tree does
+ *  not have is ignored. */
+declare function layerChartSettings(base: ChartSettings, ...partials: (PartialChartSettings | null | undefined)[]): ChartSettings;
+
+/** The chart settings' factory colors that are the same in both modes. */
+interface ChartFactoryColors {
+    /** A single-value line drawn in one color, and the area style's line. */
+    line: string;
+    /** A single-value line drawn as a gradient: its color at the highest price on screen. */
+    lineGradientTop: string;
+    /** Its color at the lowest price on screen. */
+    lineGradientBottom: string;
+    /** The area style's fill at its line, fading to the second at the pane's foot. */
+    areaTop: string;
+    areaBottom: string;
+    /** The vertical line at each session's start. */
+    sessionBreaks: string;
+    /** The previous session's close on the price scale. */
+    previousClose: string;
+    /** The visible range's high and low: their lines across the plot, and their labels on the scale,
+     *  while the setting names no color of its own. */
+    highLowLine: string;
+    highLowLabel: string;
+    bid: string;
+    ask: string;
+    /** The text on every colored value label the price scale wears, and on the tag beside it. */
+    scaleLabelText: string;
+    /** The last values of the pre-market, post-market and overnight stretches on the price scale. */
+    preMarketLabel: string;
+    postMarketLabel: string;
+    nightLabel: string;
+}
+/** The factory colors of the chart settings that do not change with the mode. */
+declare const CHART_FACTORY_COLORS: Readonly<ChartFactoryColors>;
+/** The brand pair: what a host's own surfaces on the chart read, an extension's lines among them,
+ *  so a rebrand edits two strings. The candles keep the series pair, because candles are the market
+ *  and the brand pair marks what a host draws on top of it. */
+declare const BRAND_UP = "#4c98fb";
+declare const BRAND_DOWN = "#f23645";
+
 /** The `/symbols` fields this mapping reads. A server may send more; anything not listed here has
  *  no place in symbology. */
 interface UdfSymbolResponse {
@@ -5668,12 +6405,34 @@ declare function timezoneLabel(zone: string, at?: Date): string;
  *  `tag`. */
 declare function formatClock(tag: string, zone: string, at?: Date): string;
 /** The time-axis tick-mark formatter for lightweight-charts: each mark granularity written in the
- *  zone and the language. Assign it to `timeScale.tickMarkFormatter`. */
-declare function makeTickMarkFormatter(tag: string, zone: string): (time: Time, tickMarkType: TickMarkType) => string;
+ *  zone and the language, the times on a clock of 24 hours or of 12. Assign it to
+ *  `timeScale.tickMarkFormatter`. */
+declare function makeTickMarkFormatter(tag: string, zone: string, hours?: ChartHoursFormat): (time: Time, tickMarkType: TickMarkType) => string;
+/** How the crosshair's time label writes a moment: the date's pattern, whether the weekday leads it,
+ *  the clock, and the words the quarter of a year is written with. */
+interface TimeLabelFormat {
+    dateFormat: ChartDateFormat;
+    dayOfWeek: boolean;
+    hoursFormat: ChartHoursFormat;
+    /** The quarter, 1 to 4, as the reader's language writes it (Q3). */
+    quarter(quarter: number): string;
+}
+/** A date written by a pattern, in the zone and the language: the month's name from the language,
+ *  every number in Latin digits. */
+declare function formatChartDate(at: Date, zone: string, tag: string, pattern: ChartDateFormat, quarter: (quarter: number) => string): string;
+/** A pattern written on the sample date, in the reader's language, with or without the weekday:
+ *  what a date-format picker shows for each choice ("Mon 29 Sep '97"). */
+declare function chartDateSample(format: ChartDateFormat, options: {
+    locale: string;
+    dayOfWeek: boolean;
+    t: ChartTranslate;
+}): string;
 /** The crosshair time label for lightweight-charts: the date always, the wall time only when
  *  `withTime` (an intraday chart). A daily or larger bar's timestamp is a session date, and a
- *  shifted midnight would misread as a fill time. Assign it to `localization.timeFormatter`. */
-declare function makeCrosshairTimeFormatter(tag: string, zone: string, withTime: boolean): (time: Time) => string;
+ *  shifted midnight would misread as a fill time. With a `format` the date follows its pattern,
+ *  weekday and clock; without one it is the language's own short date with its weekday, on a clock
+ *  of 24 hours. Assign it to `localization.timeFormatter`. */
+declare function makeCrosshairTimeFormatter(tag: string, zone: string, withTime: boolean, format?: TimeLabelFormat): (time: Time) => string;
 /** One row of the timezone picker: the choice it selects and the text it wears. */
 interface TimezoneRow {
     readonly id: string;
@@ -5810,4 +6569,4 @@ declare function mountTimeframePicker(options: TimeframePickerOptions & {
     container: HTMLElement;
 }): MountedTimeframePicker;
 
-export { ARRANGEMENTS, type AccessPolicy, type ActiveSubsession, type Arrangement, type AttachDrawingsOptions, BRAND_DOWN, BRAND_UP, BUILT_IN_INDICATORS, BUILT_IN_LOCALES, type BuiltInIndicator, CHART_ICON_IDS, CHART_STYLES, COLLAPSED_H, COMPARE_COLORS, type CanvasTheme, type Capabilities, ChartBody, type ChartChrome, type ChartCompareApi, type ChartCustomLocale, ChartDatafeed, type ChartDictionary, type ChartDrawingsApi, type ChartEvents, type ChartExtension, type ChartExtensionChart, type ChartExtensionCommand, type ChartExtensionContext, type ChartExtensionHandle, type ChartExtensionIcon, type ChartExtensionIconPath, type ChartExtensionMenuBuilder, type ChartExtensionMenuContext, type ChartExtensionMenuItem, type ChartExtensionPane, type ChartExtensionPriceLine, type ChartExtensionReplayState, type ChartExtensionScope, type ChartExtensionSeries, type ChartHandle, type ChartHistoryApi, type ChartI18n, type ChartI18nOptions, type ChartIconArtwork, type ChartIconContext, type ChartIconDiagnostic, type ChartIconFactory, type ChartIconFailure, type ChartIconId, type ChartIcons, type ChartLegendRow, type ChartLocale, type ChartLocaleCode, type ChartMenuAction, type ChartMenuContext, type ChartMenuIcon, type ChartMenuRow, ChartMessageKey, ChartMeta, type ChartOverrides, type ChartPaneSyncApi, type ChartPreferences, type ChartPriceFormatter, type ChartReplayApi, ChartSaveLoadAdapter, type ChartSaveLoadApi, type ChartStorage, type ChartStyleId, type ChartTimezone, type ChartTranslate, type ChartWidget, type ChartWidgetOptions, type CommandRegistry, type CommandResult, type CommandScope, type CommandSpec, type CompareDeps, type CompareEntry, type CompareHandle, type ComparePlacement, type CompareSnapshot, type CompareSymbol, type ContextMenuHandle, type CrosshairUi, type CustomThemes, DEFAULT_OVERRIDES, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, DataStatus, DatafeedSearchOptions, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, type DrawingInks, type DrawingOwner, DrawingPreferences, type DrawingPresets, type DrawingReadOutcome, type DrawingRejection, type DrawingRejectionReason, DrawingResourceContext, DrawingsBody, type DrawingsEvents, type DrawingsHandle, DrawingsMeta, type DrawingsWorkflow, EXCHANGE_TIMEZONE, type FeatureConfig, FeedBar, type FetchLike, FillBetweenPrimitive, type FullscreenApi, type FullscreenOptions, type HistoryChange, type HistoryEventState, IMAGE_HEADER_H, type ImageApi, type ImageEvent, type ImageHeader, type ImageOptions, type ImageTextRun, type ImageTile, type IndicatorCategory, type IndicatorDefinition, type IndicatorEvent, type IndicatorFill, type IndicatorInstance, type IndicatorLevel, type IndicatorManifest, type IndicatorOverrides, type IndicatorPickerAction, type IndicatorPickerBuiltInState, type IndicatorPickerCollection, type IndicatorPickerItem, type IndicatorPickerSource, type IndicatorPlot, type IndicatorPlots, type IndicatorsApi, type IndicatorsRenderer, LAYOUT_MENU_ROWS, type LayoutApi, LayoutBody, type LayoutEvent, LayoutMeta, type LayoutOptions, type LayoutSaveLoadApi, type LayoutSyncFlags, type LegendUi, type LogicalRange, MAIN_MIN_H, MIN_BAR_SPACING, MIRRORED_ICONS, type ManifestFill, type ManifestInput, type ManifestLevel, type ManifestPlot, type ManifestRun, type MarkPainters, type MarketStatus, type MatchSegment, type MountedSymbolSearch, type MountedTimeframePicker, type OpenResource, PRICE_SCALE_MODE, type PaneOp, type PanePlan, type PaneRect, type PaneState, type PartialOverrides, type PlacedImage, type PlotArea, type PlotPoint, PriceFormat, PriceFormatter, RANGE_PRESETS, RECENT_SYMBOLS_CAP, REPLAY_SPEEDS, type RangeFrameTarget, type RangePreset, type RangeSpan, type RecentsPort, type ReplayEventState, type ReplaySpeed, type ResourceLoadOutcome, ResourceRef, type ResourceRemoveOutcome, type ResourceSaveOutcome, ResourceStore, SCALE_MODES, SCALE_MODE_OPTIONS, SCROLL_STEP_BARS, SESSION_DOT, SESSION_LABEL, SESSION_STATE_TITLE, SPREAD_OPERATORS, type SaveConflictInfo, type ScaleMode, type SearchClassFilter, SearchClassNode, type SearchController, type SearchControllerOptions, type SearchDisplayOptions, SearchPage, type SearchScope, type SearchState, type SelectedDrawing, type SemanticTheme, type SessionBandsPrimitive, type SessionModel, type SessionSchedule, type SessionSegment, type SessionSource, type SessionState, type SessionTimeline, type SettingsMenuUi, ShadePrimitive, type SpreadOperator, type SpreadOperatorId, type SubsessionSource, SymbolInfo, type SymbolMarkPainter, type SymbolPriceFormat, SymbolRow, type SymbolSearchCache, type SymbolSearchHandle, type SymbolSearchOptions, THEME_ROLES, TIMEFRAME_MAX, TIMEFRAME_PRESETS, TIMEFRAME_PRESET_TOKENS, TIMEFRAME_UNITS, TIMEFRAME_UNIT_NAME, TIMEFRAME_UNIT_SECONDS, TIMEZONES, TOP_BAR_SLOTS, TemplateBody, TemplateMeta, TextDraft, TextEditFrame, type TextEditSession, type TextInlineEdit, type ThemeChangeListener, type ThemeController, type ThemeControllerOptions, type ThemeDeclaration, type ThemeDiagnostic, type ThemeDiagnosticCode, type ThemeMode, type ThemeOptions, type ThemeRole, type ThemeRoleFamily, type ThemeRoleId, type ThemeRoleKind, type ThemeRootStyle, type TimeRange, type Timeframe, type TimeframeGroup, type TimeframePickerHandle, type TimeframePickerOptions, type TimeframeRestrictions, type TimeframeUnit, type TimezoneRow, type ToolbarButton, type ToolbarButtonOptions, type ToolbarButtonState, type TopBarSlot, type TopBarUi, type TouchOptions, type TransitionOptions, type UdfDatafeedOptions, type UdfSymbolResponse, type UiConfig, type VenueMarkPainter, type WidgetEvents, ZOOM_FACTOR, type ZoneClock, allowedTimeframes, applyBar, applyPlotOverrides, arrangementName, arrangementOf, attachCompare, attachDrawings, attachIndicators, autoTimeframeFor, buildManifestPlots, canvasTheme, canvasToBlob, chartContextMenu, chartDictionaries, chartIconArtwork, clipToWindow, coerceChartStyle, coerceScaleMode, compareTimeframes, composeFormingBar, composeImage, createChart, createChartI18n, createSearchController, createSessionBands, createSymbolSearchCache, createThemeController, createUdfDatafeed, effectivePlotColor, exchangeTimezoneText, formatClock, formatDuration, formatTimeframe, frameRange, hasExtendedHours, imageFileName, imageHeaderRuns, imageLayoutHeaderRuns, imageTileRuns, indicatorHidden, isChartStyle, isCollapsed, isIntradayTimeframe, isSymbolPair, isTimezoneChoice, latestPlotValue, layerOverrides, looksLikeSpread, makeCrosshairTimeFormatter, makeTickMarkFormatter, manifestInputDefaults, marketStatus, marketStatusFor, marketStatusText, marketStatusTitle, matchSegments, memoryChartStorage, memoryRecents, mergeOverrides, mountContextMenu, mountSymbolSearch, mountTimeframePicker, nextSessionChange, openInputsEditor, openSymbolSearch, openTimeframePicker, overriddenManifest, parseSessionModel, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subTimeframesFor, subsessionBarFilter, tfSeconds, tfToUdfResolution, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };
+export { ARRANGEMENTS, type AccessPolicy, type ActiveSubsession, type Arrangement, type AttachDrawingsOptions, BRAND_DOWN, BRAND_UP, BUILT_IN_INDICATORS, BUILT_IN_LOCALES, type BuiltInIndicator, CHART_DATE_FORMATS, CHART_FACTORY_COLORS, CHART_ICON_IDS, CHART_SETTINGS_SECTIONS, CHART_STYLES, COLLAPSED_H, COMPARE_COLORS, type CandleStyleSettings, type CanvasTheme, type Capabilities, type ChartBackgroundType, ChartBody, type ChartChrome, type ChartCompareApi, type ChartControlVisibility, type ChartCustomLocale, ChartDatafeed, type ChartDateFormat, type ChartDictionary, type ChartDrawingsApi, type ChartEvents, type ChartExtension, type ChartExtensionCapture, type ChartExtensionCaptureFrame, type ChartExtensionChart, type ChartExtensionCommand, type ChartExtensionContext, type ChartExtensionHandle, type ChartExtensionIcon, type ChartExtensionIconPath, type ChartExtensionLegendRow, type ChartExtensionMenuBuilder, type ChartExtensionMenuContext, type ChartExtensionMenuItem, type ChartExtensionPane, type ChartExtensionPriceLine, type ChartExtensionReplayState, type ChartExtensionScope, type ChartExtensionSeries, type ChartFactoryColors, type ChartHandle, type ChartHistoryApi, type ChartHoursFormat, type ChartI18n, type ChartI18nOptions, type ChartIconArtwork, type ChartIconContext, type ChartIconDiagnostic, type ChartIconFactory, type ChartIconFailure, type ChartIconId, type ChartIcons, type ChartLastValueMode, type ChartLegendRow, type ChartLineColorType, type ChartLocale, type ChartLocaleCode, type ChartMenuAction, type ChartMenuContext, type ChartMenuIcon, type ChartMenuRow, ChartMessageKey, ChartMeta, type ChartPaneSyncApi, type ChartPreferences, type ChartPriceFormatter, type ChartPricePrecision, type ChartPriceSource, type ChartReplayApi, ChartSaveLoadAdapter, type ChartSaveLoadApi, type ChartScalePlacement, type ChartSessionHours, type ChartSettings, type ChartSettingsContribution, type ChartSettingsControls, type ChartSettingsForm, type ChartSettingsIconPainter, type ChartSettingsOption, type ChartSettingsPageId, type ChartSettingsRowHandle, type ChartSettingsSection, type ChartSettingsTip, type ChartStorage, type ChartStrokeStyle, type ChartStyleId, type ChartTimezone, type ChartTitleSource, type ChartTranslate, type ChartWidget, type ChartWidgetOptions, type CommandRegistry, type CommandResult, type CommandScope, type CommandSpec, type CompareDeps, type CompareEntry, type CompareHandle, type ComparePlacement, type CompareSnapshot, type CompareSymbol, type ContextMenuHandle, type CrosshairUi, type CustomThemes, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, DataStatus, DatafeedSearchOptions, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, type DrawingInks, type DrawingOwner, DrawingPreferences, type DrawingPresets, type DrawingReadOutcome, type DrawingRejection, type DrawingRejectionReason, DrawingResourceContext, DrawingsBody, type DrawingsEvents, type DrawingsHandle, DrawingsMeta, type DrawingsWorkflow, EXCHANGE_TIMEZONE, type FeatureConfig, FeedBar, type FetchLike, FillBetweenPrimitive, type FullscreenApi, type FullscreenOptions, type HistoryChange, type HistoryEventState, IMAGE_HEADER_H, type ImageApi, type ImageEvent, type ImageHeader, type ImageOptions, type ImageTextRun, type ImageTile, type IndicatorCategory, type IndicatorDefinition, type IndicatorEvent, type IndicatorFill, type IndicatorInstance, type IndicatorLevel, type IndicatorManifest, type IndicatorOverrides, type IndicatorPickerAction, type IndicatorPickerBuiltInState, type IndicatorPickerCollection, type IndicatorPickerItem, type IndicatorPickerSource, type IndicatorPlot, type IndicatorPlots, type IndicatorsApi, type IndicatorsRenderer, LAYOUT_MENU_ROWS, type LayoutApi, LayoutBody, type LayoutEvent, LayoutMeta, type LayoutOptions, type LayoutSaveLoadApi, type LayoutSyncFlags, type LegendUi, type LineStyleSettings, type LogicalRange, MAIN_MIN_H, MIN_BAR_SPACING, MIRRORED_ICONS, type ManifestFill, type ManifestInput, type ManifestLevel, type ManifestPlot, type ManifestRun, MarkIconId, type MarkPainters, type MarketStatus, type MatchSegment, type MountedSymbolSearch, type MountedTimeframePicker, type OpenResource, PRICE_SCALE_MODE, type PaneOp, type PanePlan, type PaneRect, type PaneState, type PartialChartSettings, type PlacedImage, type PlotArea, type PlotPoint, PriceFormat, PriceFormatter, RANGE_PRESETS, RECENT_SYMBOLS_CAP, REPLAY_SPEEDS, type RangeFrameTarget, type RangePreset, type RangeSpan, type ReadChartSettings, type RecentsPort, type ReplayEventState, type ReplaySpeed, type ResourceLoadOutcome, ResourceRef, type ResourceRemoveOutcome, type ResourceSaveOutcome, ResourceStore, SCALE_MODES, SCALE_MODE_OPTIONS, SCROLL_STEP_BARS, SESSION_DOT, SESSION_LABEL, SESSION_STATE_TITLE, SPREAD_OPERATORS, type SaveConflictInfo, type ScaleMode, type SearchClassFilter, SearchClassNode, type SearchController, type SearchControllerOptions, type SearchDisplayOptions, SearchPage, type SearchScope, type SearchState, type SelectedDrawing, type SemanticTheme, type SessionBandsPrimitive, type SessionLook, type SessionModel, type SessionSchedule, type SessionSegment, type SessionSource, type SessionState, type SessionTimeline, type SettingsMenuUi, ShadePrimitive, type SpreadOperator, type SpreadOperatorId, type SubsessionSource, SymbolInfo, type SymbolMarkPainter, type SymbolPriceFormat, SymbolRow, type SymbolSearchCache, type SymbolSearchHandle, type SymbolSearchOptions, THEME_ROLES, TIMEFRAME_MAX, TIMEFRAME_PRESETS, TIMEFRAME_PRESET_TOKENS, TIMEFRAME_UNITS, TIMEFRAME_UNIT_NAME, TIMEFRAME_UNIT_SECONDS, TIMEZONES, TOP_BAR_SLOTS, TemplateBody, TemplateMeta, TextDraft, TextEditFrame, type TextEditSession, type TextInlineEdit, type ThemeChangeListener, type ThemeController, type ThemeControllerOptions, type ThemeDeclaration, type ThemeDiagnostic, type ThemeDiagnosticCode, type ThemeMode, type ThemeOptions, type ThemeRole, type ThemeRoleFamily, type ThemeRoleId, type ThemeRoleKind, type ThemeRootStyle, type TimeLabelFormat, type TimeRange, type Timeframe, type TimeframeGroup, type TimeframePickerHandle, type TimeframePickerOptions, type TimeframeRestrictions, type TimeframeUnit, type TimezoneRow, type ToolbarButton, type ToolbarButtonOptions, type ToolbarButtonState, type TopBarSlot, type TopBarUi, type TouchOptions, type TransitionOptions, type UdfDatafeedOptions, type UdfSymbolResponse, type UiConfig, type VenueMarkPainter, type WidgetEvents, ZOOM_FACTOR, type ZoneClock, allowedTimeframes, applyBar, applyPlotOverrides, arrangementName, arrangementOf, attachCompare, attachDrawings, attachIndicators, autoTimeframeFor, buildManifestPlots, canvasTheme, canvasToBlob, chartContextMenu, chartDateSample, chartDictionaries, chartIconArtwork, chartSettingsDefaults, clipToWindow, coerceChartStyle, coerceScaleMode, compareTimeframes, composeFormingBar, composeImage, createChart, createChartI18n, createSearchController, createSessionBands, createSymbolSearchCache, createThemeController, createUdfDatafeed, effectivePlotColor, exchangeTimezoneText, formatChartDate, formatClock, formatDuration, formatTimeframe, frameRange, hasExtendedHours, imageFileName, imageHeaderRuns, imageLayoutHeaderRuns, imageTileRuns, indicatorHidden, isChartStyle, isCollapsed, isIntradayTimeframe, isSymbolPair, isTimezoneChoice, latestPlotValue, layerChartSettings, looksLikeSpread, makeCrosshairTimeFormatter, makeTickMarkFormatter, manifestInputDefaults, marketStatus, marketStatusFor, marketStatusText, marketStatusTitle, matchSegments, memoryChartStorage, memoryRecents, mountContextMenu, mountSymbolSearch, mountTimeframePicker, nextSessionChange, openInputsEditor, openSymbolSearch, openTimeframePicker, overriddenManifest, parseSessionModel, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, readPartialChartSettings, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionBreakTimes, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subTimeframesFor, subsessionBarFilter, tfSeconds, tfToUdfResolution, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };