@trdrs/quickcharts 2.1.0 → 2.3.0

package/dist/index.d.ts

@@ -1,304 +1,13 @@
-import { al as en, C as ChartMessageKey, G as GlyphSourcePort, M as MagnetMode, d as CursorMode, L as LineStyle, I as IDrawing, m as DrawingCounts, D as DrawingStyle, Y as VisibilityPreset, U as ToolPreset, V as ToolTemplate, S as SerializedDrawing, o as DrawingPreferences, l as DrawingAssetPort } from './assets-DOuBBsOp.js';
-import { R as ResourceRef, C as ChartSaveLoadAdapter, q as ChartMeta, t as ChartBody, f as DrawingResourceContext, i as ResourceStore, u as DrawingsMeta, h as DrawingsBody, j as TemplateMeta, T as TemplateBody, v as LayoutMeta, w as LayoutBody, c as DrawingContextKind } from './resources-Le6flcEn.js';
-export { a as ChartLocalDrawingContext, D as DRAWING_CONTEXT_VERSION, b as DRAWING_DOCUMENT_VERSION, d as DrawingEntry, e as DrawingGroup, g 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-Le6flcEn.js';
+import { C as ChartDatafeed, F as FeedBar, S as SymbolRow, a as SearchClassNode } from './symbols-BL1fD4CS.js';
+export { B as BarMark, b as BarsEvent, D as DatafeedConfig, c as DatafeedSearchOptions, d as FeedUnavailableError, H as HistoryPage, M as MarkColorRole, e as MarkPlacement, f as MarkShape, O as OlderPageVerdict, g as SearchPage, h as SubscribeHandlers, i as SymbolNames, T as TimescaleMark, o as olderPageVerdict, s as symbolNames } from './symbols-BL1fD4CS.js';
+import { al as en, C as ChartMessageKey, G as GlyphSourcePort, M as MagnetMode, d as CursorMode, L as LineStyle, I as IDrawing, m as DrawingCounts, D as DrawingStyle, Y as VisibilityPreset, U as ToolPreset, V as ToolTemplate, S as SerializedDrawing, o as DrawingPreferences, l as DrawingAssetPort } from './assets-M5emOz5c.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 { LineData, UTCTimestamp, HistogramData, WhitespaceData, IChartApi, ISeriesApi, CreatePriceLineOptions, PriceLineOptions, ISeriesPrimitive, Time, PriceScaleMode, SeriesType, SeriesAttachedParameter, TickMarkType } from 'lightweight-charts';
-
-/** How one symbol's prices are WRITTEN, in five facts. Together they express
- *  every supported form: decimal, pip, fractional, fraction of a fraction, and variable tick.
- *
- *  - `pricescale` — price units per whole unit. 100 writes cents, 100000 writes FX pipettes,
- *    100000000 writes satoshis, 32 writes thirty-seconds. It alone sets the decimal column width.
- *  - `minmov` — the smallest move, in those units. It declares the grid a price moves on; it never
- *    widens or narrows the decimal column (ES at `{100, 25}` writes 4500.25, the same two decimals
- *    as `{100, 1}`).
- *  - `minmove2` — the further division of one `minmov` step for a fraction-of-a-fraction market:
- *    4 means quarters of a thirty-second.
- *  - `fractional` — write the sub-unit part as a counted fraction (110'16) instead of decimals.
- *  - `variableTickSize` — an ordered ladder of tick sizes by price band, written as a
- *    space-separated string: alternating tick and upper bound, ending with the tick that applies
- *    above the last bound. "0.01 10 0.02 100 0.05" means 0.01 below 10, 0.02 below 100, 0.05 at or
- *    above 100. The band a price falls in is a DECLARED fact of the symbol, not a guess from its
- *    magnitude. */
-interface PriceFormat {
-    pricescale: number;
-    minmov: number;
-    minmove2?: number;
-    fractional?: boolean;
-    variableTickSize?: string;
-}
-/** How live the served data is, in three states. `delayed_streaming` is a real
- *  stream behind a delay, not a degraded `streaming`. */
-type DataStatus = 'streaming' | 'endofday' | 'delayed_streaming';
-/** The subsession ids a symbol may name. `regular` is the weekly `session`; `premarket` and
- *  `postmarket` are the extended spans before and after it; `extended` is the whole span from
- *  pre-market open through post-market close. */
-type SubsessionId = 'regular' | 'extended' | 'premarket' | 'postmarket';
-/** One named session of a market with extended hours. `session`
- *  uses the grammar of `SymbolInfo.session`; `sessionCorrections` uses the grammar of
- *  `SymbolInfo.corrections` and lists only the days that shorten THIS subsession. `description`
- *  is a label a feed may state; the chart labels a subsession by its `id` from its own catalog. */
-interface Subsession {
-    id: SubsessionId;
-    session: string;
-    description?: string;
-    sessionCorrections?: string;
-}
-/** Resolved metadata for ONE symbol: everything the chart needs to title it, page it, session it,
- *  and write its prices.
- *
- *  `timezone`, `session`, `sessionHolidays`, `corrections` and `subsessions` are the
- *  exchange-hours facts and travel with the symbol. The chart's session model (`sessionModel.ts`)
- *  is built from them alone: market state, session shading, the regular-hours filter and the
- *  status popup all read what the feed said, and a feed that states no extended hours gets none. */
-interface SymbolInfo {
-    /** The symbol the datafeed answers to on every later call. */
-    ticker: string;
-    /** The short display identity, e.g. 'ESZ2026'. */
-    name: string;
-    /** The long human description, e.g. 'E-mini S&P 500 Dec 2026'. */
-    description: string;
-    /** The venue a UI attributes the symbol to. */
-    exchange: string;
-    /** The venue that actually lists it, when it differs from `exchange`. */
-    listedExchange: string;
-    /** The venue's own type token, e.g. 'futures', 'stock', 'crypto', 'forex'. */
-    type: string;
-    /** The resolutions this symbol serves, as chart timeframe tokens ('1m', '4h', '1d', '1mo'). An
-     *  EMPTY list declares no restriction: the feed serves any token the grammar admits (a futures
-     *  or spread feed says exactly this), and the chart never reads it as "serves nothing". A finite
-     *  list is a promise the chart may enforce. */
-    supportedResolutions: readonly string[];
-    /** The exchange's IANA zone, e.g. 'America/New_York'. */
-    timezone: string;
-    /** The session string, e.g. '1700-1600' or '0930-1600'. */
-    session: string;
-    /** The session-holidays string: comma-separated 'YYYYMMDD' full closures. */
-    sessionHolidays?: string;
-    /** The corrections string: `;`-separated `<session>:<dates>` entries, each a session in
-     *  the grammar of `session` that holds on the `,`-separated 'YYYYMMDD' trading days named. A
-     *  correction outranks a holiday on the same date. */
-    corrections?: string;
-    /** The symbol's named sessions, for a market whose exchange keeps extended hours. Absent for a
-     *  market with one continuous session. */
-    subsessions?: readonly Subsession[];
-    dataStatus: DataStatus;
-    /** ISO 4217 for a money-quoted symbol; absent when the quote unit is not a currency. */
-    currencyCode?: string;
-    /** The unit a non-currency symbol is quoted in, e.g. an energy or weight unit id. */
-    unitId?: string;
-    /** Decimal places for a volume value. 0 for a whole-contract market. */
-    volumePrecision: number;
-    format: PriceFormat;
-}
-/** One band of a `variableTickSize` ladder: `size` is the tick that applies to prices strictly below
- *  `below`, and the last band's `below` is `Infinity`. */
-interface TickBand {
-    /** The tick size in this band. */
-    size: number;
-    /** The exclusive upper bound of the band. */
-    below: number;
-}
-/** Parse the space-separated variable-tick ladder into ordered bands. Returns an
- *  empty array for a string the grammar cannot read, which is how a caller tells "no ladder" from
- *  "a ladder I must honour" without guessing at a half-parsed one. */
-declare function parseTickBands(variableTickSize: string): TickBand[];
-/** The band a price falls in, by the ladder's declared bounds (magnitude of the SYMBOL's own
- *  declared ladder, never a generic magnitude rule). Negative prices read on their absolute value,
- *  so a spread writes both sides in one column. */
-declare function tickBandFor(bands: readonly TickBand[], price: number): TickBand | null;
-
-/** The theme roles a mark may wear. A host names a meaning and the mode resolves the color, so a
- *  mark stays readable when the viewer switches to light. */
-type MarkColorRole = 'neutral' | 'up' | 'down' | 'info' | 'warning' | 'positive' | 'negative';
-/** Where a bar mark sits relative to its bar. */
-type MarkPlacement = 'above' | 'below';
-/** The glyph a bar mark draws. */
-type MarkShape = 'circle' | 'square' | 'arrowUp' | 'arrowDown';
-/** One mark on a bar. */
-interface BarMark {
-    /** Stable within one symbol and window, so a refetch replaces rather than duplicates. */
-    id: string;
-    /** Epoch SECONDS at the bar's bucket open, the same clock every bar uses. */
-    time: number;
-    color: MarkColorRole;
-    /** The letter or two the glyph carries. */
-    text?: string;
-    /** The longer words a host would show beside the mark. Carried, never drawn by the chart. */
-    label?: string;
-    shape?: MarkShape;
-    placement?: MarkPlacement;
-}
-/** One mark under the time scale. */
-interface TimescaleMark {
-    id: string;
-    /** Epoch SECONDS. */
-    time: number;
-    color: MarkColorRole;
-    label?: string;
-}
-
-/** One OHLCV bar on the wire: `t` = epoch SECONDS at bucket open (never milliseconds, never an
- *  update's wall time), strictly ascending within any batch, one bar per timestamp. */
-interface FeedBar {
-    t: number;
-    o: number;
-    h: number;
-    l: number;
-    c: number;
-    v: number;
-}
-/** A symbol-search result row. `exchange` names the venue the market lists on. `dataSource` names
- *  where the market's data comes from, and a row names one only when that source publishes the
- *  symbol's data. The row's source cell shows the venue, or the data source for a row with none. */
-interface SymbolRow {
-    symbol: string;
-    name: string;
-    exchange: string;
-    type: string;
-    dataSource?: string | null;
-    /** What the market is priced in, when the feed knows it here. A PAIR market writes itself as
-     *  `BASE / QUOTE` wherever it is named, and a ticker alone cannot say what the quote is; a row
-     *  without it keeps the name the feed sent instead. `resolve()` states the same fact for the
-     *  charted symbol, so a row and the legend that follows it agree. */
-    currencyCode?: string;
-}
-interface SearchPage {
-    hits: SymbolRow[];
-    /** Exact: another page exists at offset + hits.length (never a guess at a page boundary). */
-    hasMore: boolean;
-}
-interface HistoryPage {
-    bars: FeedBar[];
-    /** True when a countBack ask found NOTHING — the "no more history, stop scrolling back" signal.
-     *  Plain from/to asks never set it (an empty window can be a mid-history gap). */
-    noData: boolean;
-    /** OPTIONAL gap hint on an EMPTY page that is not the end of history: the epoch-seconds time of
-     *  the closest bar older than the asked window (a market holiday between `to` and the data).
-     *  A consumer may retry ONCE with `to = nextTime` to jump the gap instead of dead-ending —
-     *  {@link olderPageVerdict} is that rule. Feeds without the concept simply never set it. */
-    nextTime?: number;
-}
-type OlderPageVerdict = {
-    kind: 'bars';
-} | {
-    kind: 'hop';
-    to: number;
-} | {
-    kind: 'end';
-} | {
-    kind: 'stop';
-};
-/** The one scroll-back rule for an older-history page, shared by every paging consumer so the gap
- *  semantics can't drift between them:
- *  - `bars` — the page has data; prepend it (bars are never discarded, whatever flags ride along).
- *  - `hop` — empty but `nextTime` points strictly older and this ask wasn't already a hop: re-ask
- *    once anchored there (the session-gap answer). One hop per gap keeps a lying feed bounded —
- *    an honest hint names a real bar, so the hop can't come back empty.
- *  - `end` — empty, `noData`, and no hint: feed inception, the one verdict that seals scroll-back.
- *  - `stop` — every other empty page (a transient, or an unusable hint): end this flight WITHOUT
- *    sealing; the next gesture asks again. */
-declare function olderPageVerdict(page: HistoryPage, askedTo: number, alreadyHopped: boolean): OlderPageVerdict;
-/** Push events from a live bar subscription. A `snapshot` REPLACES the recent window (delivered on
- *  connect and on every transport reconnect — the feed's self-healing re-sync); a `bar` mutates the
- *  last bar or appends the next one (bucket-open time). */
-type BarsEvent = {
-    kind: 'snapshot';
-    bars: FeedBar[];
-} | {
-    kind: 'bar';
-    bar: FeedBar;
-};
-interface SubscribeHandlers {
-    onBars(e: BarsEvent): void;
-    /** Feed status codes: 'live' | 'no-data' | server codes ('not_entitled', 'feed_down', …). */
-    onStatus?(status: string): void;
-}
-/** Thrown by `history` when the backend has NO feed configured for the symbol — a TERMINAL state
- *  (the chart shows "market data unavailable" and closes the live subscription), unlike a transient
- *  fetch failure which is retried. */
-declare class FeedUnavailableError extends Error {
-    /** The server's typed refusal (e.g. not_entitled / feed_down),
-     *  when it sent one — lets the host name the actual cause instead of a generic "unavailable". */
-    readonly code: string | null;
-    constructor(message?: string, 
-    /** The server's typed refusal (e.g. not_entitled / feed_down),
-     *  when it sent one — lets the host name the actual cause instead of a generic "unavailable". */
-    code?: string | null);
-}
-/** One class in a feed's catalog that holds narrower classes: a `spot` class over its `usdc` and
- *  `usdt` quotes, say. `id` is the token the feed is searched with, as a plain string entry is, and
- *  `children` are the narrower classes, as tokens or nodes of their own. The search renders two
- *  levels, a top-level class and its children: a child's own `children` are not offered, and the
- *  child narrows by its `id` alone. */
-interface SearchClassNode {
-    readonly id: string;
-    readonly children?: readonly (string | SearchClassNode)[];
-}
-/** What a feed's `search` is asked with. `cls` and `classes` say which classes to narrow to; both
- *  absent is every class. */
-interface DatafeedSearchOptions {
-    /** One class to narrow to. When the viewer may select several classes it is set only while
-     *  exactly one is selected, so a feed that reads `cls` alone still narrows a single chip. */
-    cls?: string;
-    /** Every class to narrow to, sent only when the search lets the viewer select several classes at
-     *  once: a row matches when it is in any of them. A feed may ignore it and read `cls` alone. */
-    classes?: readonly string[];
-    limit?: number;
-    offset?: number;
-}
-/** A feed's coarse, feed-LEVEL capability declaration. Everything optional and the method itself
- *  optional: an ABSENT declaration means unconstrained, and a feed must only
- *  declare what is true — a finite `resolutions` list from a feed that serves any timeframe would
- *  be a lie the chart then enforces. Symbol-level truth (price format, resolutions, session) stays
- *  on {@link SymbolInfo}. */
-interface DatafeedConfig {
-    /** The wire timeframe tokens this feed can serve ('1m', '4h', '1d', …). Absent = any. */
-    resolutions?: readonly string[];
-    /** Asset-class tokens the catalog carries, in the order the search offers them. An entry is a
-     *  token, or a {@link SearchClassNode} whose children the search offers beneath it once it is
-     *  selected. Absent = unspecified. */
-    classes?: readonly (string | SearchClassNode)[];
-}
-/** The datafeed a chart consumes. Implementations must follow the bar rules on {@link FeedBar} and
- *  {@link BarsEvent}; everything else (transport, caching, auth) is the implementation's business. */
-interface ChartDatafeed {
-    /** OPTIONAL capability negotiation, read once at mount: the widget constrains itself to what the
-     *  feed declares (e.g. its initial timeframe must be servable). Omit it entirely when the feed
-     *  has no fixed capability set. */
-    config?(): Promise<DatafeedConfig>;
-    /** Server-side symbol search, paged. `cls` narrows to one asset class ('' / absent = all), and
-     *  `classes`, when present, to any of several (see {@link DatafeedSearchOptions}). */
-    search(q: string, opts?: DatafeedSearchOptions): Promise<SearchPage>;
-    /** Resolve one symbol's metadata; null when the symbol is unknown to the feed's catalogs. */
-    resolve(symbol: string): Promise<SymbolInfo | null>;
-    /** Historical sealed bars: a [from,to] window (epoch seconds, INCLUSIVE of both ends — the chart
-     *  pages with `to = oldest − 1` and never re-requests a bar it holds), or `countBack` = the LAST
-     *  N bars at/before `to` (outranks `from`; the count is an obligation — reach across closures).
-     *  No range = the feed's default recent window. Throws {@link FeedUnavailableError} when no feed
-     *  serves the symbol. */
-    history(symbol: string, tf: string, range?: {
-        from?: number;
-        to?: number;
-        countBack?: number;
-    }): Promise<HistoryPage>;
-    /** Live bar push for one (symbol, timeframe). Returns the unsubscribe. The transport owns
-     *  reconnection and re-syncs by emitting a fresh `snapshot`. */
-    subscribeBars(symbol: string, tf: string, handlers: SubscribeHandlers): () => void;
-    /** Server clock (epoch seconds) — countdown skew correction. Optional: a feed without one leaves
-     *  the chart on the client clock. */
-    serverTime?(): Promise<number>;
-    /** OPTIONAL depth of history for a symbol: the epoch seconds of its earliest available bar, or
-     *  null when the feed does not know. The range presets read it (a listing from last year offers
-     *  no five-year range); the chart never probes for it. Omit it entirely when the feed cannot
-     *  say, and every preset is offered. */
-    earliestBar?(symbol: string): Promise<number | null>;
-    /** OPTIONAL neutral bar marks over a window (epoch seconds, inclusive of both ends). A mark is a
-     *  note about a moment: its color is a theme role, its words are the host's, and the chart
-     *  draws it as given. Omit it entirely when the feed serves none. */
-    marks?(symbol: string, from: number, to: number, resolution: string): Promise<readonly BarMark[]>;
-    /** OPTIONAL neutral time-scale marks over the same window. */
-    timescaleMarks?(symbol: string, from: number, to: number, resolution: string): Promise<readonly TimescaleMark[]>;
-}
+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';
+import { PriceFormatter } from './format.js';
+export { NumericPunctuation, PriceFormatterOptions, createPriceFormatter } from './format.js';
 
 /** A feed that answers coarser grains than the one it wraps.
  *
@@ -1458,39 +1167,6 @@ declare function arrangementName(t: ChartTranslate, code: string, fallback: stri
  *  of the built-in codes, or a code the `locales` option registers. */
 declare function createChartI18n(initial?: string, options?: ChartI18nOptions): ChartI18n;
 
-/** How a formatted price is punctuated. A price localizes the decimal sign only, so
- *  `groupSign` defaults to '' (no thousands separator) and a host that wants grouping asks for it
- *  explicitly. */
-interface NumericPunctuation {
-    /** What separates the whole part from the decimals. Default '.', or the locale's sign when a
-     *  `locale` is given. */
-    decimalSign?: string;
-    /** What separates thousands in the whole part. Default '': a price is written ungrouped, because
-     *  a grouped price is harder to compare against the axis beside it. */
-    groupSign?: string;
-}
-interface PriceFormatterOptions {
-    /** A BCP 47 tag used ONCE, at construction, to derive the decimal sign. Anything explicit in
-     *  `numericPunctuation` wins over it. */
-    locale?: string;
-    numericPunctuation?: NumericPunctuation;
-}
-/** A resolved formatter for one symbol. `format` and `parse` are exact inverses over every price
- *  that lands on the symbol's own grid. */
-interface PriceFormatter {
-    /** The price as the symbol writes it. */
-    format(price: number): string;
-    /** The number a viewer typed, or null when the text is not a price in this symbol's format. */
-    parse(text: string): number | null;
-    /** How many digits `format` writes after the decimal sign. 0 for a fractional format, which
-     *  writes none; the widest band's width for a variable-tick format, so a column sized from it
-     *  never has to reflow. */
-    precision(): number;
-}
-/** Build the formatter for one symbol's price format. The result is stateless and reusable; a host
- *  resolves a symbol once and keeps its formatter for as long as the symbol is on screen. */
-declare function createPriceFormatter(format: PriceFormat, options?: PriceFormatterOptions): PriceFormatter;
-
 /** The session an instant classifies into. `extended` is trading outside regular hours when the
  *  symbol does not split it into pre-market and after-hours. */
 type SessionState = 'pre' | 'open' | 'extended' | 'after' | 'closed';
@@ -2772,6 +2448,22 @@ 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. */
 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. */
+interface ChartIconArtwork {
+    /** The grid the drawing is on. */
+    viewBox: string;
+    /** The markup inside the svg, every ink on `currentColor`. */
+    body: string;
+    /** The whole drawing as one standalone svg: the grid, no fill of its own (as the chart draws it),
+     *  and the body. */
+    svg: string;
+}
+/** Every drawing the chart paints for an icon, in the order its controls use them, each on its own
+ *  grid, so a host picks the one whose grid suits its box (the drawing toolbar's are on a 28 grid).
+ *  The chart's own artwork, whatever a host's `icons` draw instead. An icon the chart draws in its
+ *  theme's roles, an illustration, answers none, and so does an id it does not draw. */
+declare function chartIconArtwork(id: ChartIconId): readonly ChartIconArtwork[];
 
 /** A declared numeric input: `int`/`float` bound by min/max, `enum` an index into `options`. */
 interface ManifestInput {
@@ -3736,6 +3428,19 @@ interface LogicalRange {
     to: number;
 }
 
+/** The plot's box: the four distances an absolutely positioned element takes, each measured in from
+ *  the matching edge of the host's element, and the box's size. `right` is how far the plot's right
+ *  edge stands in from the element's right edge, which is the right price scale and anything beside
+ *  the chart; `bottom` is the time scale, any panes below the main one and anything beneath. */
+interface PlotArea {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    width: number;
+    height: number;
+}
+
 /** What went wrong, as a machine-readable code. */
 type ThemeDiagnosticCode = 'unknown-role' | 'empty-value' | 'invalid-value';
 /** One rejected entry of a host's custom palette. */
@@ -4357,8 +4062,18 @@ interface ChartHandle {
     zoom(factor: number): void;
     /** Fit the loaded data. */
     reset(): void;
-    /** Return to the live edge, keeping the current span. */
+    /** Return to the live edge, keeping the current span: a glide that eases into place, moving the
+     *  view sideways and never the zoom. A touch, a drag, a wheel or any other navigation ends it
+     *  where it stands. */
     goLive(): void;
+    /** Whether the view sits back from the live edge, scrolled more than a bar behind its resting
+     *  place, which is what a control offering the way back reads. A glide under way reads as
+     *  returned from its first frame, and bar replay, which has its own way back, reads as returned
+     *  throughout. The `liveEdge` event reports each change. */
+    awayFromLiveEdge(): boolean;
+    /** Where the main pane draws its bars, in the pixels of the element the host handed the widget,
+     *  or null before the chart has laid out. The `plotArea` event reports each change. */
+    plotArea(): PlotArea | null;
     scaleMode(): ScaleMode;
     setScaleMode(mode: ScaleMode): void;
     /** The viewer's display-timezone CHOICE: an IANA id from the chart's registry, or `exchange` to
@@ -4487,6 +4202,11 @@ interface ChartEvents {
     visibleRange(range: TimeRange): void;
     /** The visible logical (bar index) range moved. */
     logicalRange(range: LogicalRange): void;
+    /** The view left the live edge or came back to it: true while it sits back from it. Reported only
+     *  when the answer changes, so a scroll that stays away says nothing more. */
+    liveEdge(away: boolean): void;
+    /** The main pane's plot moved or resized within the host's element. */
+    plotArea(area: PlotArea): void;
     /** The chosen range preset changed, or navigation left the preset view. */
     rangePreset(key: string | null): void;
     /** A load, a page back or a live snapshot reshaped the bar series. */
@@ -4898,6 +4618,16 @@ interface SearchDisplayOptions {
      *  while exactly one is selected. */
     classSelection?: 'single' | 'multiple';
 }
+/** How the chart answers a finger, beyond what every chart does. */
+interface TouchOptions {
+    /** The chart as a canvas under the finger: a one-finger drag on the plot releases the main price
+     *  scale's framing, as a drag on the price scale does, so the price follows the finger as freely
+     *  as the time, and nothing re-frames while the viewer pans, flicks or pinches; a pinch zooms the
+     *  time and leaves the price where it stands. A double-tap on the price scale, a new market or
+     *  timeframe, and `goLive` frame the bars again. Off by default: a drag moves the time alone while
+     *  the price scale frames the bars on screen. */
+    freePan?: boolean;
+}
 /** Everything needed to construct a widget. `container` and `datafeed` are the two hard
  *  requirements; every other field has a working default. */
 interface ChartWidgetOptions extends MarkPainterHooks {
@@ -5143,6 +4873,8 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     /** Neutral bar marks and time-scale marks from the datafeed. On by default; `false` draws none
      *  even from a feed that serves them. */
     marks?: boolean;
+    /** How the chart answers a finger, beyond what every chart does. */
+    touch?: TouchOptions;
 }
 
 /** Host-owned activity, displayed with indicators but never saved as an indicator or plotted. */
@@ -5538,29 +5270,6 @@ 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 three ways one market is written, from one rule. */
-interface SymbolNames {
-    /** The compact mark a label wears at a glance: a pair closed up (`BTCUSDC`, `EURUSD`), otherwise
-     *  the bare ticker (`ES1!`, `AAPL`). A spread expression is its own mark, operators and all. */
-    mark: string;
-    /** The title a reading wears: a pair spaced (`BTC / USDC`), otherwise the feed's short name where
-     *  it stated one apart from the description, otherwise the bare ticker. */
-    title: string;
-    /** The description beside a mark: a pair spaced, otherwise the feed's long description, otherwise
-     *  the bare ticker, so a market never repeats its own mark for want of a name. */
-    description: string;
-}
-/** How a market is named, from a resolved `SymbolInfo`, a search row, or the feed symbol alone
- *  before either has landed.
- *
- *  A pair market reads as `BTC / USDC` or `EUR / USD`, both sides in the codes the market itself
- *  trades in, never a spelled-out currency name. The quote comes from `currencyCode`, and a ticker
- *  written as a slash pair (`BTC/USD`) needs no currency to say so. Before a symbol resolves there
- *  is no pair to write, so the bare ticker stands on its own rather than guessing at a quote. A
- *  market that is not a pair keeps the feed's own words: the short name as its title, the long
- *  description beside its mark. */
-declare function symbolNames(symbol: SymbolInfo | SymbolRow | string): SymbolNames;
-
 /** The `/symbols` fields this mapping reads. A server may send more; anything not listed here has
  *  no place in symbology. */
 interface UdfSymbolResponse {
@@ -5885,4 +5594,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 BarMark, type BarsEvent, type BuiltInIndicator, CHART_ICON_IDS, CHART_STYLES, COLLAPSED_H, COMPARE_COLORS, type CanvasTheme, type Capabilities, ChartBody, type ChartChrome, type ChartCompareApi, type ChartCustomLocale, type 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 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 CustomThemes, DEFAULT_OVERRIDES, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, type DataStatus, type DatafeedConfig, type DatafeedSearchOptions, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, type DrawingOwner, DrawingPreferences, type DrawingPresets, type DrawingReadOutcome, type DrawingRejection, type DrawingRejectionReason, DrawingResourceContext, DrawingsBody, type DrawingsEvents, type DrawingsHandle, DrawingsMeta, type DrawingsWorkflow, EXCHANGE_TIMEZONE, type FeatureConfig, type FeedBar, FeedUnavailableError, type FetchLike, FillBetweenPrimitive, type FullscreenApi, type FullscreenOptions, type HistoryChange, type HistoryEventState, type HistoryPage, 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 MarkColorRole, type MarkPainters, type MarkPlacement, type MarkShape, type MarketStatus, type MatchSegment, type MountedSymbolSearch, type MountedTimeframePicker, type NumericPunctuation, type OlderPageVerdict, type OpenResource, PRICE_SCALE_MODE, type PaneOp, type PanePlan, type PaneRect, type PaneState, type PartialOverrides, type PlacedImage, type PlotPoint, type PriceFormat, type PriceFormatter, type PriceFormatterOptions, 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, type SearchClassNode, type SearchController, type SearchControllerOptions, type SearchDisplayOptions, type 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 SubscribeHandlers, type Subsession, type SubsessionId, type SubsessionSource, type SymbolInfo, type SymbolMarkPainter, type SymbolNames, type SymbolPriceFormat, type 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, type TextEditSession, 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 TickBand, type TimeRange, type Timeframe, type TimeframeGroup, type TimeframePickerHandle, type TimeframePickerOptions, type TimeframeRestrictions, type TimeframeUnit, type TimescaleMark, type TimezoneRow, type ToolbarButton, type ToolbarButtonOptions, type ToolbarButtonState, type TopBarSlot, type TopBarUi, 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, clipToWindow, coerceChartStyle, coerceScaleMode, compareTimeframes, composeFormingBar, composeImage, createChart, createChartI18n, createPriceFormatter, 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, olderPageVerdict, openInputsEditor, openSymbolSearch, openTimeframePicker, overriddenManifest, parseSessionModel, parseTickBands, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subTimeframesFor, subsessionBarFilter, symbolNames, tfSeconds, tfToUdfResolution, tickBandFor, 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_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 CustomThemes, DEFAULT_OVERRIDES, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, DataStatus, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, 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, 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, type TextEditSession, 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 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 };