@trdrs/quickcharts 1.2.0 → 2.0.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-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-ySndlUS3.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-Ch8eA1Mw.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-Ch8eA1Mw.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-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 { 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
@@ -147,15 +147,15 @@ interface FeedBar {
     c: number;
     v: number;
 }
-/** A symbol-search result row. `provider`/`via` carry the data-source truth a UI may attribute —
- *  a row names a provider ONLY when that provider actually publishes the symbol's data. */
+/** 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;
-    provider?: string | null;
-    via?: string | null;
+    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
@@ -217,24 +217,47 @@ interface SubscribeHandlers {
  *  (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. feed_requires_connection / feed_capacity / feed_displaced),
+    /** 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. feed_requires_connection / feed_capacity / feed_displaced),
+    /** 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 (today's behavior), and a feed must only
- *  declare what is true — a finite `resolutions` list from a feed that serves any interval would
+ *  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. Absent = unspecified. */
-    classes?: 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. */
@@ -243,12 +266,9 @@ interface ChartDatafeed {
      *  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). */
-    search(q: string, opts?: {
-        cls?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<SearchPage>;
+    /** 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
@@ -274,7 +294,7 @@ interface ChartDatafeed {
     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
-     *  neither interprets nor acts on it. Omit it entirely when the feed serves none. */
+     *  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[]>;
@@ -360,8 +380,7 @@ interface LocaleDefinition<Code extends string = string> {
 type ChartLocaleCode = 'en' | 'de' | 'fr' | 'es' | 'it' | 'ca_ES' | 'pl' | 'sv' | 'tr' | 'ru' | 'pt' | 'id_ID' | 'ms_MY' | 'th' | 'vi' | 'ja' | 'ko' | 'zh' | 'zh_TW' | 'ar' | 'he_IL';
 type ChartLocale = LocaleDefinition<ChartLocaleCode>;
 /** English first, then the Latin-script languages, then the others. Endonyms let every reader find
- *  their own language in a picker. `scripts/i18n.mjs` reads this table by its line shape, and
- *  `scripts/test/i18n-inventory.test.ts` pins it equal to the app runtime's inventory. */
+ *  their own language in a picker. `scripts/i18n.mjs` reads this table by its line shape. */
 declare const BUILT_IN_LOCALES: readonly ChartLocale[];
 
 type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
@@ -579,7 +598,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.drawingBringForward': "Bring drawing forward";
     readonly 'command.drawingSendBackward': "Send drawing backward";
     readonly 'command.drawingHideSelected': "Hide drawing";
-    readonly 'command.drawingVisibility': "Drawing visibility on intervals";
+    readonly 'command.drawingVisibility': "Drawing visibility on timeframes";
     readonly 'command.drawingSettings': "Drawing settings";
     readonly 'command.drawingCommitEdit': "Apply drawing settings";
     readonly 'command.drawingPlaceImage': "Place image";
@@ -603,7 +622,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'command.replayStepBack': "Step back";
     readonly 'command.replayGoLive': "Replay to the live edge";
     readonly 'command.replaySpeed': "Replay speed";
-    readonly 'command.replayInterval': "Replay update interval";
+    readonly 'command.replayTimeframe': "Replay update timeframe";
     readonly 'command.timeframeSet': "Timeframe";
     readonly 'command.subsessionRegular': "Regular hours";
     readonly 'command.subsessionExtended': "Extended hours";
@@ -732,7 +751,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'drawing.more': "More";
     readonly 'drawing.moreActions': "More drawing actions";
     readonly 'drawing.visualOrder': "Visual order";
-    readonly 'drawing.visibilityOnIntervals': "Visibility on intervals";
+    readonly 'drawing.visibilityOnTimeframes': "Visibility on timeframes";
     readonly 'drawing.clone': "Clone";
     readonly 'drawing.copy': "Copy";
     readonly 'drawing.modifierControl': "Ctrl";
@@ -754,10 +773,10 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'drawing.sendToBack': "Send to back";
     readonly 'drawing.bringForward': "Bring forward";
     readonly 'drawing.sendBackward': "Send backward";
-    readonly 'drawing.visCurrentAndAbove': "Current interval and above";
-    readonly 'drawing.visCurrentAndBelow': "Current interval and below";
-    readonly 'drawing.visCurrentOnly': "Current interval only";
-    readonly 'drawing.visAll': "All intervals";
+    readonly 'drawing.visCurrentAndAbove': "Current timeframe and above";
+    readonly 'drawing.visCurrentAndBelow': "Current timeframe and below";
+    readonly 'drawing.visCurrentOnly': "Current timeframe only";
+    readonly 'drawing.visAll': "All timeframes";
     readonly 'drawing.saveTemplate': "Save drawing template";
     readonly 'drawing.templateName': "Template name";
     readonly 'drawing.save': "Save";
@@ -916,7 +935,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'drawing.unitDays': "Days";
     readonly 'drawing.unitWeeks': "Weeks";
     readonly 'drawing.unitMonths': "Months";
-    readonly 'drawing.intervalPinnedNote': "A drawing stays on at least one interval, so it can always be reached again.";
+    readonly 'drawing.timeframePinnedNote': "A drawing stays on at least one timeframe, so it can always be reached again.";
     readonly 'drawing.colorSwatch': "Color {hex}";
     readonly 'drawing.customColor': "Custom color";
     readonly 'drawing.saturationValue': "Saturation and brightness";
@@ -1025,7 +1044,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'range.oneYear': "1 Year";
     readonly 'range.fiveYears': "5 Years";
     readonly 'range.all': "All data";
-    readonly 'range.tip': "{range} · {interval} bars";
+    readonly 'range.tip': "{range} · {timeframe} bars";
     readonly 'range.zoomIn': "Zoom in";
     readonly 'range.zoomOut': "Zoom out";
     readonly 'range.scrollLeft': "Scroll left";
@@ -1193,17 +1212,17 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'layouts.arrangement': "Chart arrangement";
     readonly 'layouts.syncInLayout': "Sync in layout";
     readonly 'layouts.syncSymbol': "Symbol";
-    readonly 'layouts.syncInterval': "Interval";
+    readonly 'layouts.syncTimeframe': "Timeframe";
     readonly 'layouts.syncCrosshair': "Crosshair";
     readonly 'layouts.syncTime': "Time";
     readonly 'layouts.syncDateRange': "Date range";
     readonly 'layouts.syncSymbolTip': "Symbol changes on all charts within the layout";
-    readonly 'layouts.syncIntervalTip': "Interval changes on all charts within the layout";
+    readonly 'layouts.syncTimeframeTip': "Timeframe changes on all charts within the layout";
     readonly 'layouts.syncCrosshairTip': "Crosshair is synced across all charts within the layout";
     readonly 'layouts.syncTimeTip': "When a chart is clicked, all charts within the layout display the same point of time";
     readonly 'layouts.syncDateRangeTip': "Date range changes on all charts within the layout";
     readonly 'layouts.syncSymbolToggle': "Sync symbol";
-    readonly 'layouts.syncIntervalToggle': "Sync interval";
+    readonly 'layouts.syncTimeframeToggle': "Sync timeframe";
     readonly 'layouts.syncCrosshairToggle': "Sync crosshair";
     readonly 'layouts.syncTimeToggle': "Sync time";
     readonly 'layouts.syncDateRangeToggle': "Sync date range";
@@ -1235,7 +1254,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'layouts.loading': "Loading";
     readonly 'layouts.emptyNone': "No saved layouts yet.";
     readonly 'layouts.openLayoutRow': "Open layout…";
-    readonly 'layouts.listingFacts': "{symbol}, {interval}";
+    readonly 'layouts.listingFacts': "{symbol}, {timeframe}";
     readonly 'layouts.listingDated': "{facts} ({date})";
     readonly 'layouts.dialogTitle': "Layouts";
     readonly 'layouts.search': "Search";
@@ -1300,11 +1319,11 @@ declare const chartDictionaries: DictionaryLoader<{
         readonly one: "1 update per {count} second";
         readonly other: "1 update per {count} seconds";
     };
-    readonly 'replay.interval': "Update interval";
-    readonly 'replay.intervalHelp': "How much time each replay update advances. Finer than the chart interval, each bar forms from real finer bars.";
-    readonly 'replay.intervalNone': "No finer interval for this chart interval";
+    readonly 'replay.timeframe': "Update timeframe";
+    readonly 'replay.timeframeHelp': "How much time each replay update advances. Finer than the chart timeframe, each bar forms from real finer bars.";
+    readonly 'replay.timeframeNone': "No finer timeframe for this chart timeframe";
     readonly 'replay.auto': "Auto";
-    readonly 'replay.autoSelectInterval': "Auto select interval";
+    readonly 'replay.autoSelectTimeframe': "Auto select timeframe";
     readonly 'menu.resetView': "Reset chart view";
     readonly 'menu.copyPrice': "Copy price {price}";
     readonly 'menu.paste': "Paste";
@@ -1413,8 +1432,8 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'legend.close': "C";
     readonly 'legend.change': "{change} ({percent}%)";
     readonly 'legend.indicatorSettings': "Indicator settings";
-    readonly 'legend.showRows': "Show study rows";
-    readonly 'legend.hideRows': "Hide study rows";
+    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";
@@ -1425,7 +1444,7 @@ declare const chartDictionaries: DictionaryLoader<{
     readonly 'legend.scalePercent': "%";
     readonly 'legend.scaleIndexed': "100";
     readonly 'legend.changeSymbol': "Change symbol";
-    readonly 'legend.removeCompare': "Remove compare";
+    readonly 'legend.removeCompare': "Remove comparison";
     readonly 'legend.removeIndicator': "Remove indicator";
 }, ChartLocaleCode>;
 /** A drawing tool's display name for a registry `type`: the catalog's when it knows the type, else
@@ -1461,7 +1480,7 @@ interface PriceFormatterOptions {
 interface PriceFormatter {
     /** The price as the symbol writes it. */
     format(price: number): string;
-    /** The number a user typed, or null when the text is not a price in this symbol's format. */
+    /** 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
@@ -1538,8 +1557,8 @@ declare const DEFAULT_SUBSESSION: ActiveSubsession;
 declare function hasExtendedHours(model: SessionModel): boolean;
 /** The bar filter for the active subsession: under `regular`, on a symbol with extended hours,
  *  keep the bars whose open falls in regular hours; otherwise nothing is filtered (null). For
- *  intraday intervals only: a daily bar spans whole sessions, so a caller applies the filter on
- *  intraday intervals and shows every daily bar. */
+ *  intraday timeframes only: a daily bar spans whole sessions, so a caller applies the filter on
+ *  intraday timeframes and shows every daily bar. */
 declare function subsessionBarFilter(model: SessionModel, active: ActiveSubsession): ((epochSecs: number) => boolean) | null;
 /** The session state at an instant (epoch seconds), under the symbol's exchange clock. */
 declare function sessionStateAt(model: SessionModel, epochSecs: number): SessionState;
@@ -1613,9 +1632,9 @@ type VenueMarkPainter = (request: {
     host: HTMLElement;
     size: number;
 }) => (() => void) | void;
-/** Paints the mark of a data provider, where a row names a provider rather than a venue. */
-type ProviderMarkPainter = (request: {
-    provider: string;
+/** Paints the mark of a data source, where a row names a data source rather than a venue. */
+type DataSourceMarkPainter = (request: {
+    dataSource: string;
     host: HTMLElement;
     size: number;
 }) => (() => void) | void;
@@ -1623,7 +1642,7 @@ type ProviderMarkPainter = (request: {
 interface MarkPainters {
     readonly symbol: SymbolMarkPainter | null;
     readonly venue: VenueMarkPainter | null;
-    readonly provider: ProviderMarkPainter | null;
+    readonly dataSource: DataSourceMarkPainter | null;
 }
 /** The host's hooks, as an entry point takes them. Each is the host's to lend or withhold, and
  *  every entry point that paints marks takes exactly these, so a host writes them once and hands
@@ -1631,7 +1650,7 @@ interface MarkPainters {
 interface MarkPainterHooks {
     /** The host's mark for a market, called WHEREVER the chart names one: each chart's legend, the
      *  compare rows under it, every row of the symbol search and compare dialogs, and the market tag
-     *  a trading notice wears. It receives the element to paint into and the symbol it stands for,
+     *  an extension's notice wears. It receives the element to paint into and the symbol it stands for,
      *  and returns a disposer that takes the mark down again.
      *
      *  One hook rather than one per surface, so a market wears the same mark everywhere it appears and
@@ -1643,9 +1662,9 @@ interface MarkPainterHooks {
      *  into and the size of the box, and returns a disposer; absent, a venue wears its initial on the
      *  neutral disc the package draws itself. */
     venueMark?: VenueMarkPainter;
-    /** The host's mark for the data provider a row names where it names no venue, painted in that
-     *  row's source cell the same way. Absent, the provider wears its initial on the neutral disc. */
-    providerMark?: ProviderMarkPainter;
+    /** The host's mark for the data source a row names where it names no venue, painted in that
+     *  row's source cell the same way. Absent, a data source wears its initial on a neutral disc. */
+    dataSourceMark?: DataSourceMarkPainter;
 }
 
 /** One glyph: its own grid and the inner markup drawn on it. */
@@ -1677,9 +1696,9 @@ interface ChartOverrides {
         countdown: boolean;
     };
 }
-/** The brand palette, single-sourced: any surface that speaks for trdrs reads these (the trading
- *  extension's buy line among them), and a rebrand edits two strings. The pair does not reach the
- *  candle bodies; see the note on DEFAULT_OVERRIDES for why. */
+/** 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;
@@ -1708,9 +1727,11 @@ interface ThemeDeclaration {
  *  add a third. A host that keeps named brand presets resolves each preset to a custom light or
  *  dark palette before passing it in. */
 type ThemeMode = 'light' | 'dark';
-/** What a role's value is written as. Every value is a CSS token string, so `length` is `'4px'` and
- *  `duration` is `'150ms'`; the kind says which tokens are valid, and validation enforces it. */
-type ThemeRoleKind = 'color' | 'length' | 'font' | 'duration' | 'shadow';
+/** What a role's value is written as. Every value is a CSS token string, so `length` is `'4px'`,
+ *  `duration` is `'150ms'`, `easing` is a timing function such as `'ease-out'`, and `scale` is a
+ *  unitless factor such as `'0.97'`; the kind says which tokens are valid, and validation enforces
+ *  it. */
+type ThemeRoleKind = 'color' | 'length' | 'font' | 'duration' | 'easing' | 'scale' | 'shadow';
 /** The grouping a role belongs to. Families organize the manual and the manifest; they are not part
  *  of a role's identity. */
 type ThemeRoleFamily = 'canvas' | 'series' | 'scale' | 'text' | 'chrome' | 'overlay' | 'state' | 'control' | 'status' | 'illustration' | 'drawing' | 'motion';
@@ -1752,17 +1773,17 @@ declare const THEME_ROLES: readonly [{
     readonly id: "series.up";
     readonly family: "series";
     readonly kind: "color";
-    readonly description: "A rising value: up volume, a rising study tint, a positive series default.";
+    readonly description: "A rising value: up volume, a rising indicator tint, a positive series default.";
 }, {
     readonly id: "series.down";
     readonly family: "series";
     readonly kind: "color";
-    readonly description: "A falling value: down volume, a falling study tint, a negative series default.";
+    readonly description: "A falling value: down volume, a falling indicator tint, a negative series default.";
 }, {
     readonly id: "series.neutral";
     readonly family: "series";
     readonly kind: "color";
-    readonly description: "A series or level with no direction, such as a study level line.";
+    readonly description: "A series or level with no direction, such as an indicator level line.";
 }, {
     readonly id: "scale.grid";
     readonly family: "scale";
@@ -1957,7 +1978,7 @@ declare const THEME_ROLES: readonly [{
     readonly id: "chrome.surface";
     readonly family: "chrome";
     readonly kind: "color";
-    readonly description: "The fill of toolbars, rails, bars, and panels.";
+    readonly description: "The fill of toolbars, bars, and panels.";
 }, {
     readonly id: "chrome.surfaceRaised";
     readonly family: "chrome";
@@ -2275,7 +2296,47 @@ declare const THEME_ROLES: readonly [{
     readonly id: "motion.durationBase";
     readonly family: "motion";
     readonly kind: "duration";
-    readonly description: "An ordinary transition, such as a menu opening.";
+    readonly description: "An ordinary transition: a modal dialog and its backdrop opening and closing, and the replay row entering and leaving.";
+}, {
+    readonly id: "motion.durationModerate";
+    readonly family: "motion";
+    readonly kind: "duration";
+    readonly description: "A control moving to its new state, such as a switch knob sliding.";
+}, {
+    readonly id: "motion.durationSlow";
+    readonly family: "motion";
+    readonly kind: "duration";
+    readonly description: "A small mark settling, such as a disclosure caret turning or a checkbox filling.";
+}, {
+    readonly id: "motion.durationSlower";
+    readonly family: "motion";
+    readonly kind: "duration";
+    readonly description: "A larger mark turning, such as the drawing toolbar's chevron.";
+}, {
+    readonly id: "motion.easingStandard";
+    readonly family: "motion";
+    readonly kind: "easing";
+    readonly description: "The timing of an ordinary transition: a modal dialog box, the replay row, a caret dip, a checkbox fill.";
+}, {
+    readonly id: "motion.easingOut";
+    readonly family: "motion";
+    readonly kind: "easing";
+    readonly description: "The timing of a motion that settles as it ends: a modal backdrop fading, a switch knob sliding.";
+}, {
+    readonly id: "motion.easingLinear";
+    readonly family: "motion";
+    readonly kind: "easing";
+    readonly description: "The timing of a color or opacity change under the pointer.";
+}, {
+    readonly id: "motion.easingSpring";
+    readonly family: "motion";
+    readonly kind: "easing";
+    readonly description: "The timing of a mark that turns with a slight overshoot, such as a caret or chevron.";
+}, {
+    readonly id: "motion.scaleEnter";
+    readonly family: "motion";
+    readonly kind: "scale";
+    readonly description: "The scale a modal dialog box grows from as it opens and returns to as it closes.";
 }];
 /** Every role id in the inventory. */
 type ThemeRoleId = (typeof THEME_ROLES)[number]['id'];
@@ -2694,7 +2755,7 @@ 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" | "indicators" | "visible" | "textColor" | "lineColor" | "open" | "close" | "template" | "fillColor" | "locked" | "sync" | "measure" | "image" | "eraser" | "delete" | "remove" | "copy" | "pause" | "play" | "reset" | "scroll" | "hidden" | "add" | "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" | "selectBar" | "firstAvailable" | "randomBar" | "cursorCross" | "cursorDot" | "cursorArrow" | "magnetStrong" | "drawingsShown" | "drawingsHidden" | "indicatorsShown" | "indicatorsHidden" | "allShown" | "allHidden" | "zoomIn" | "grip" | "favoritesBar" | "lineSolid" | "lineDashed" | "lineDotted" | "lineThickness1" | "lineThickness2" | "lineThickness3" | "lineThickness4" | "lineEndNormal" | "lineEndArrow" | "fullscreenExit" | "caret" | "collapse" | "zoomOut" | "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" | "indicators" | "visible" | "textColor" | "lineColor" | "open" | "close" | "template" | "fillColor" | "locked" | "sync" | "measure" | "image" | "eraser" | "delete" | "remove" | "hidden" | "copy" | "pause" | "play" | "reset" | "scroll" | "add" | "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" | "selectBar" | "firstAvailable" | "randomBar" | "cursorCross" | "cursorDot" | "cursorArrow" | "magnetStrong" | "drawingsShown" | "drawingsHidden" | "indicatorsShown" | "indicatorsHidden" | "allShown" | "allHidden" | "zoomIn" | "grip" | "favoritesBar" | "lineSolid" | "lineDashed" | "lineDotted" | "lineThickness1" | "lineThickness2" | "lineThickness3" | "lineThickness4" | "lineEndNormal" | "lineEndArrow" | "fullscreenExit" | "caret" | "collapse" | "zoomOut" | "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[]>>;
 /** 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
@@ -2878,7 +2939,7 @@ declare function indicatorHidden(ov: IndicatorOverrides | undefined): boolean;
 /** The manifest's default input values ({ period: 20, source: 0, … }). */
 declare function manifestInputDefaults(m: IndicatorManifest): Record<string, number>;
 /** The effective color of a plot spec under an instance: override → declared → the instance's
- *  rotated color. A legend dot and a save-as-default snapshot both read THIS, so what the user
+ *  rotated color. A legend dot and a save-as-default snapshot both read THIS, so what the viewer
  *  sees is what persists. */
 declare function effectivePlotColor(m: IndicatorManifest, key: string, ov: IndicatorOverrides | undefined, instanceColor: string): string;
 /** A manifest with an instance's STYLE overrides folded into its declared specs — colors, widths,
@@ -2898,8 +2959,8 @@ interface ManifestRun {
     shadeColors?: readonly (string | null)[];
     barColors?: readonly (string | null)[];
 }
-/** The ONE walker from a computed run to the render-agnostic spec — built-ins, user scripts, and
- *  widget definitions all render through this, so plot semantics can never drift between them.
+/** The ONE walker from a computed run to the render-agnostic spec: built-ins and host
+ *  definitions all render through this, so plot semantics can never drift between them.
  *  `fallbackColor` is the instance's rotated color, used by any plot channel that doesn't declare
  *  its own. */
 declare function buildManifestPlots(run: ManifestRun, times: readonly UTCTimestamp[], title: string, fallbackColor: string): IndicatorPlots;
@@ -2908,7 +2969,7 @@ declare function buildManifestPlots(run: ManifestRun, times: readonly UTCTimesta
  *  defensively. */
 declare function latestPlotValue(data: readonly unknown[] | undefined): number | null;
 
-/** The symbol's price format, as a study scale falls back to it when the manifest declares no
+/** The symbol's price format, as an indicator scale falls back to it when the manifest declares no
  *  precision: the formatter writes the scale labels, `minMove` is the symbol's smallest move, and
  *  `key` changes whenever either does so the scale re-applies. */
 interface SymbolPriceFormat {
@@ -2935,8 +2996,8 @@ interface IndicatorsRenderer {
 }
 declare function attachIndicators(chart: IChartApi, options?: {
     candles?: () => ISeriesApi<'Candlestick'> | null;
-    /** The symbol's price format for studies that declare no precision. A host that supplies none
-     *  leaves those scales on the library's own default formatting. */
+    /** The symbol's price format for indicators that declare no precision. A host that supplies
+     *  none leaves those scales on the library's own default formatting. */
     symbolPriceFormat?: () => SymbolPriceFormat;
     /** The undirected ink a level line takes when the manifest declares no color of its own. Read
      *  live, so a theme switch repaints the levels with everything else; the built-in dark palette's
@@ -2989,8 +3050,8 @@ interface ChartExtensionReplayState {
     cursor: number;
     total: number;
 }
-/** The chart an extension is attached to, read-only. It answers what is on screen; it does not let
- *  an extension steer the chart, because a host that wants to steer already holds the widget. */
+/** The chart an extension is attached to, read-only. It answers what is on screen, and a host
+ *  steers the chart through the widget it already holds. */
 interface ChartExtensionChart {
     /** Same value as `pane().id` — the chart and its pane are one thing to an extension. */
     id: string;
@@ -3046,7 +3107,7 @@ interface ChartExtensionIcon {
      *  the row reads exactly as a row that contributed no glyph at all. */
     paths: readonly ChartExtensionIconPath[];
 }
-/** A row an extension adds to the chart's level menu. It carries its own action: the chart routes
+/** A row an extension adds to the chart's context menu. It carries its own action: the chart routes
  *  nothing, so a contributed row cannot collide with a built-in id. */
 interface ChartExtensionMenuItem {
     id: string;
@@ -3061,9 +3122,9 @@ interface ChartExtensionMenuItem {
     group?: 'level' | 'view';
     run(): void;
 }
-/** A layer an extension draws that the rail's eye can blank. It joins the eye's menu after the
- *  chart's own layers and before "Hide all", which blanks it too, and it wears the layer's own two
- *  marks on the eye while it is the chosen subject. */
+/** A layer an extension draws that the drawing toolbar's eye can blank. It joins the eye's menu
+ *  after the chart's own layers and before "Hide all", which blanks it too, and it wears the
+ *  layer's own two marks on the eye while it is the chosen subject. */
 interface ChartExtensionHideLayer {
     /** Unique within one chart; the mode the hide command names for this layer. */
     id: string;
@@ -3082,16 +3143,18 @@ interface ChartExtensionHideLayer {
     apply(hidden: boolean): void;
 }
 /** The chart's side of a contributed layer: read whether it is blanked and flip it, through the
- *  same eye the rail drives, so a switch on the extension's own surface and the eye agree. */
+ *  same eye the drawing toolbar drives, so a switch on the extension's own surface and the eye
+ *  agree. */
 interface ChartExtensionHideLayerHandle {
     hidden(): boolean;
     setHidden(hidden: boolean): void;
     /** Withdraw the layer from the eye. Detach withdraws it either way. */
     remove(): void;
 }
-/** Asked on every raise, so rows can depend on the level that was pressed. Returning an empty list
- *  contributes nothing and costs nothing. */
-type ChartExtensionMenuProvider = (context: ChartExtensionMenuContext) => readonly ChartExtensionMenuItem[];
+/** 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. */
+type ChartExtensionMenuBuilder = (context: ChartExtensionMenuContext) => readonly ChartExtensionMenuItem[];
 /** A named action an extension offers the host. The minimal shape: an id, a label, whether it can
  *  run now, and how to run it. */
 interface ChartExtensionCommand {
@@ -3114,7 +3177,7 @@ interface ChartExtensionContext {
     overlay: HTMLElement;
     /** The widget's layer on the document body, themed as the root is. A popover that must stand
      *  over every pane and over whatever the page stacks around the widget mounts HERE, at viewport
-     *  coordinates; the level menu does the same. */
+     *  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. */
@@ -3146,7 +3209,7 @@ interface ChartExtensionContext {
     onActiveChange(callback: (active: boolean) => void): () => void;
     /** The chart is going away. Fires before the handle's own `detach()`. */
     onDispose(callback: () => void): () => void;
-    contributeContextMenu(provider: ChartExtensionMenuProvider): () => void;
+    contributeContextMenu(build: ChartExtensionMenuBuilder): () => void;
     contributeCommands(commands: readonly ChartExtensionCommand[]): () => void;
     contributeHideLayer(layer: ChartExtensionHideLayer): ChartExtensionHideLayerHandle;
 }
@@ -3174,7 +3237,7 @@ interface ChartExtension {
     attach(context: ChartExtensionContext): ChartExtensionHandle;
 }
 
-/** Localized metadata for one optional collection in the chart-owned indicator browser. */
+/** Localized metadata for one optional collection in the chart-owned indicator picker. */
 interface IndicatorPickerCollection {
     /** Stable opaque id. `builtin` and `favorites` belong to the chart. */
     id: string;
@@ -3184,7 +3247,7 @@ interface IndicatorPickerCollection {
     /** Catalog columns by default; a personal list can omit author and favorite columns. */
     layout?: 'table' | 'list';
 }
-/** A host action is an opaque verb, not an indicator definition or executable chart script. */
+/** A host action is an opaque verb: the source's `act` runs it, and the chart only names it. */
 interface IndicatorPickerAction {
     /** Unique within its row. `add` and `favorite` belong to the chart. */
     id: string;
@@ -3215,7 +3278,9 @@ interface IndicatorPickerBuiltInState {
 }
 interface IndicatorPickerSource {
     collections: readonly IndicatorPickerCollection[];
-    /** The host supplies localized text. A new query or collection aborts the previous read. */
+    /** The host supplies localized text. A new query or collection aborts the previous read.
+     *  `builtInIds` are the built-ins the picker lists: every one, or those `builtInIndicators`
+     *  offers. */
     list(request: {
         collection: string;
         query: string;
@@ -3252,21 +3317,21 @@ interface CompareSymbol {
     symbol: string;
     title: string;
 }
-/** One active compare, as hosts read it (legend rows, dialogs, serialization). */
+/** One active comparison, as hosts read it (legend rows, dialogs, serialization). */
 interface CompareEntry {
     symbol: string;
     placement: ComparePlacement;
     color: string;
     visible: boolean;
     /** Style beyond the palette color, absent until a settings edit sets it (2 / solid are the
-     *  series defaults). Carried here so a styled compare round-trips through the snapshot. */
+     *  series defaults). Carried here so a styled comparison round-trips through the snapshot. */
     lineWidth?: number;
     lineStyle?: 'solid' | 'dashed' | 'dotted';
 }
 /** The serialized form carried inside the chart content blob — and the shape host STATE holds.
- *  Only the identity is required: color and visibility are the ORGAN's to deal (the palette pick,
+ *  Only the identity is required: color and visibility are the MODULE's to deal (the palette pick,
  *  the eye's default), so a host can state membership — "compare MSFT on a new scale" — before
- *  the organ has dealt them, and the organ's report back fills them in. `serialize` always emits
+ *  the module has dealt them, and the module's report back fills them in. `serialize` always emits
  *  the dealt fields; `restore`/`apply` accept either form. */
 interface CompareSnapshot {
     symbol: string;
@@ -3277,13 +3342,13 @@ interface CompareSnapshot {
     lineStyle?: 'solid' | 'dashed' | 'dotted';
 }
 /** The compare line palette, in assignment order. Assigned by first
- *  unused slot, so removing a compare frees its color for the next one. */
+ *  unused slot, so removing a comparison frees its color for the next one. */
 declare const COMPARE_COLORS: readonly string[];
 /** First palette color not already worn; wraps past the palette by reuse (better a repeat than an
  *  invented hue the theme never approved). */
 declare function pickCompareColor(used: readonly string[], palette?: readonly string[]): string;
 /** Clip bars to the main series' window (inclusive). Null window ⇒ nothing renders yet — the main
- *  series has no bars, and a compare must never be the thing that gives the axis its range. */
+ *  series has no bars, and a comparison must never be the thing that gives the axis its range. */
 declare function clipToWindow(bars: readonly FeedBar[], window: {
     from: number;
     to: number;
@@ -3299,14 +3364,14 @@ interface CompareDeps {
     /** The chart's CURRENT timeframe — read per fetch, never captured. */
     tf(): string;
     /** The MAIN series' loaded bar window (epoch seconds, inclusive), or null before first paint.
-     *  The organ clips every compare to it; the host calls `sync()` whenever it changes shape. */
+     *  The module clips every comparison to it; the host calls `sync()` whenever it changes shape. */
     mainWindow(): {
         from: number;
         to: number;
     } | null;
     /** How many bars a fresh compare asks for when the main window is not yet known. */
     seedCountBack?: number;
-    /** Entries changed (add/remove/visibility/color) or a compare's latest value moved — hosts
+    /** Entries changed (add/remove/visibility/color) or a comparison's latest value moved — hosts
      *  re-render their legend from `list()` / `latest()`. */
     onChange?(): void;
 }
@@ -3320,11 +3385,11 @@ interface CompareHandle {
     }): void;
     remove(symbol: string): void;
     setVisible(symbol: string, visible: boolean): void;
-    /** A host-side hide ANDed with the eye (interval visibility, a plot-visibility override) —
+    /** A host-side hide ANDed with the eye (timeframe visibility, a plot-visibility override) —
      *  never serialized and never touching `visible`, so a timeframe switch that suppresses a
-     *  compare cannot flip the trader's eye state. */
+     *  compare cannot flip the viewer's eye state. */
     suppress(symbol: string, on: boolean): void;
-    /** Restyle one compare's line (a settings edit). Omitted fields keep their current value;
+    /** Restyle one comparison's line (a settings edit). Omitted fields keep their current value;
      *  `priceLabel` is the price-scale label+line pair. Identical values are a no-op (no notify). */
     restyle(symbol: string, style: {
         color?: string;
@@ -3333,11 +3398,11 @@ interface CompareHandle {
         priceLabel?: boolean;
     }): void;
     list(): CompareEntry[];
-    /** The latest clipped close for one compare, or null (no bars in window / unknown symbol). */
+    /** The latest clipped close for one comparison, or null (no bars in window / unknown symbol). */
     latest(symbol: string): number | null;
-    /** The pane the compare's series currently lives on (0 = the main pane), or null for an unknown
-     *  symbol — how a host places the compare'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 (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. */
     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
@@ -3349,7 +3414,7 @@ interface CompareHandle {
      *  reshaped nothing): re-clip, and fetch older compare history only where the window now starts
      *  earlier than anything already asked for. */
     sync(): void;
-    /** The chart's timeframe changed: every compare refetches at the new bucket size. */
+    /** The chart's timeframe changed: every comparison refetches at the new bucket size. */
     setTimeframe(): void;
     serialize(): CompareSnapshot[];
     /** Replace the whole set from a snapshot (restore path). Unknown placements are dropped. */
@@ -3361,7 +3426,7 @@ declare function attachCompare(chart: IChartApi, deps: CompareDeps): CompareHand
 type ScaleMode = 'normal' | 'log' | 'percent' | 'indexed';
 declare const SCALE_MODES: readonly ScaleMode[];
 /** Settings-control chips, in render order. Each names its own catalog key, so a control that
- *  renders them reads the trader's language rather than an English word compiled into a public
+ *  renders them reads the viewer's language rather than an English word compiled into a public
  *  export. */
 declare const SCALE_MODE_OPTIONS: readonly {
     id: ScaleMode;
@@ -3379,24 +3444,24 @@ type ReplaySpeed = (typeof REPLAY_SPEEDS)[number];
  *  nominal seconds; 0 for ticks and for a token the grammar cannot read. A tick bar has no fixed
  *  duration, so it can neither be subdivided nor stand as a subdivision of a time bar. */
 declare function tfSeconds(tf: string): number;
-/** The update intervals a chart timeframe offers.
+/** The update timeframes a chart timeframe offers.
  *
- *  A rung qualifies when it divides the chart's interval evenly and is no coarser than it, drawn
+ *  A rung qualifies when it divides the chart's timeframe evenly and is no coarser than it, drawn
  *  from the chart's OWN unit group and the group below it. That bound is what keeps the list
  *  readable: every minute rung divides a day evenly, but a day played a minute at a time is 1,440
  *  updates per bar, so a daily chart offers hours. Seconds join any intraday chart, which is how a
  *  minute chart gets a grain at all. A week or a month plays in whole days and nothing else.
  *
- *  The chart's own interval is ON the list when it is a rung, and choosing it is how a viewer asks
+ *  The chart's own timeframe is ON the list when it is a rung, and choosing it is how a viewer asks
  *  for whole-bar updates. A timeframe that is not a rung (17m, say) simply has no rung of its own,
  *  and the list is whatever divides it. */
-declare function subIntervalsFor(chartTf: string): {
+declare function subTimeframesFor(chartTf: string): {
     tf: string;
     sec: number;
 }[];
-/** Auto = the COARSEST interval on offer, which is the chart's own whenever that is a rung. Replay
+/** Auto = the COARSEST timeframe on offer, which is the chart's own whenever that is a rung. Replay
  *  then advances a whole bar per update until a viewer asks for a finer grain. */
-declare function autoIntervalFor(chartTf: string): {
+declare function autoTimeframeFor(chartTf: string): {
     tf: string;
     sec: number;
 } | null;
@@ -3424,8 +3489,11 @@ interface SearchControllerOptions {
 }
 interface SearchState {
     readonly query: string;
-    /** The asset-class filter the feed narrowed to; '' is every class. */
+    /** The asset-class filter the feed narrowed to; '' is every class. With a list filter it is the
+     *  one class the list holds, or '' when it holds several. */
     readonly cls: string;
+    /** The list filter the feed narrowed to, when the search was asked with one. */
+    readonly classes?: readonly string[];
     /** Every row loaded so far for the query, in the feed's order. */
     readonly hits: readonly SymbolRow[];
     /** A page for THIS query is in flight and nothing cached answers it yet. Rows of the previous
@@ -3442,17 +3510,21 @@ interface SearchController {
     subscribe(listener: (state: SearchState) => void): () => void;
     /** Ask for a query. A cached answer shows at once and a single-page entry revalidates in the
      *  background; a miss keeps the previous rows, marks loading, and fetches after the debounce.
-     *  A newer query cancels an older one's result. */
-    search(query: string, cls?: string): void;
+     *  A newer query cancels an older one's result. `cls` is one class ('' is every class), or a
+     *  list of classes: the feed hears a list as `classes`, and as `cls` too when it holds exactly
+     *  one. An empty list is every class. */
+    search(query: string, cls?: SearchClassFilter): void;
     /** Append the next page of the current query while `hasMore` holds. One page in flight at a
      *  time; rows already shown are never repeated even when a revalidation shifted a page edge. */
     loadMore(): void;
     /** Warm the cache for a query without changing the current one, so its first open is instant.
      *  A failure is dropped; the query fetches on open as it would have. */
-    prefetch(query?: string, cls?: string): void;
+    prefetch(query?: string, cls?: SearchClassFilter): void;
     /** Stop timers; later results are ignored. */
     dispose(): void;
 }
+/** Which classes a search narrows to: one class token ('' is every class), or a list of them. */
+type SearchClassFilter = string | readonly string[];
 declare function createSearchController(datafeed: Pick<ChartDatafeed, 'search'>, options?: SearchControllerOptions): SearchController;
 /** How many recent picks a search surface lists. */
 declare const RECENT_SYMBOLS_CAP = 10;
@@ -3478,8 +3550,10 @@ interface MatchSegment {
 declare function matchSegments(text: string, query: string): MatchSegment[];
 /** One spread operator a search input offers. It TYPES into the query; the feed parses and
  *  evaluates the expression, because the whole expression is the instrument. */
+/** The name of one spread operator, as a host lists the operators a search offers. */
+type SpreadOperatorId = 'division' | 'subtraction' | 'addition' | 'multiplication' | 'exponentiation' | 'reciprocal';
 interface SpreadOperator {
-    readonly id: 'division' | 'subtraction' | 'addition' | 'multiplication' | 'exponentiation' | 'reciprocal';
+    readonly id: SpreadOperatorId;
     /** What it inserts. */
     readonly insert: string;
     /** Inserted before the query rather than after it (the reciprocal form). */
@@ -3681,7 +3755,7 @@ type ThemeChangeListener = (theme: SemanticTheme, mode: ThemeMode) => void;
 interface ThemeController {
     /** The mode in effect. */
     mode(): ThemeMode;
-    /** Switch modes. The chart keeps its symbol, timeframe, range, drawings, and studies. */
+    /** Switch modes. The chart keeps its symbol, timeframe, range, drawings, and indicators. */
     setMode(mode: ThemeMode): void;
     /** The complete resolved theme in effect. */
     get(): SemanticTheme;
@@ -3726,7 +3800,8 @@ interface CommandSpec {
     execute(arg?: unknown): void | Promise<void>;
 }
 /** What running a command answers. A refusal is a value, never a throw: a menu row, a shortcut and
- *  an operator all need to tell "nothing by that name" from "not allowed" without a try block. */
+ *  an automation adapter all need to tell "nothing by that name" from "not allowed" without a try
+ *  block. */
 type CommandResult = {
     kind: 'ok';
 } | {
@@ -3752,7 +3827,9 @@ interface CommandRegistry {
     execute(id: string, arg?: unknown): CommandResult;
     /** Remap a shortcut, or clear it with null. */
     setShortcut(id: string, shortcut: string | null): void;
-    /** Fires when the registered set or a shortcut changes. Returns the unsubscribe. */
+    /** Fires when the registered set or a shortcut changes, and when the host says its access policy
+     *  may answer differently (`widget.refreshAccess()`), since what `available` answers may have
+     *  moved with it. Returns the unsubscribe. */
     onChange(cb: () => void): () => void;
 }
 
@@ -3858,7 +3935,7 @@ interface DrawingPresets {
     subscribe(listener: () => void): () => void;
 }
 /** Why a low-level document operation refused. Machine-readable on purpose: these answer a host's
- *  code, not a trader, so nothing here is a sentence to render. */
+ *  code, not a viewer, so nothing here is a sentence to render. */
 type DrawingDocumentRefusal = 
 /** The widget runs in combined mode: its drawings ride whatever saves the chart, and there is no
  *  separate document to get, apply or reload. */
@@ -3870,7 +3947,7 @@ type DrawingDocumentRefusal =
  *  layout, chart or symbol that has moved on. Nothing was changed. */
  | 'stale';
 /** Why one drawing in a document was not applied. The rest of the document still applies: one
- *  unusable row is not a reason to leave the trader with an empty chart. */
+ *  unusable row is not a reason to leave the viewer with an empty chart. */
 type DrawingRejectionReason = 
 /** Its owning source is not on this chart (an indicator that is gone, a series never added). */
 'missing-source'
@@ -3932,7 +4009,7 @@ interface DrawingsEvents {
     onSelectionChange?: (id: string | null) => void;
     /** A write of a symbol's document was refused: the stored document moved on (`current` is the
      *  ref that stands now) or vanished (null). The layer merges the stored document over its own
-     *  work and writes again at the adopted ref; the host decides what to tell the trader. */
+     *  work and writes again at the adopted ref; the host decides what to tell the viewer. */
     onSaveConflict?: (info: {
         symbol: string;
         current: ResourceRef | null;
@@ -3952,7 +4029,7 @@ interface AttachDrawingsOptions {
      *  the keyboard verbs stay scoped to this widget instead of the whole page. */
     container: HTMLElement;
     symbol: string;
-    /** Timeframe token ('5m', '1d', ...), which drives per-interval drawing visibility. */
+    /** Timeframe token ('5m', '1d', ...), which drives per-timeframe drawing visibility. */
     timeframe?: string;
     /** SEPARATE-drawing persistence: which drawing-resource context a symbol's document is keyed by,
      *  and the store for that context. Absent is the COMBINED mode: the layer keeps its documents in
@@ -3996,6 +4073,12 @@ interface AttachDrawingsOptions {
      *  a cursor beside it would be a second claim about the same point. This layer writes the plot's
      *  cursor as an inline style, so it is the only place that can stand it down. */
     pointerSuppressed?: () => boolean;
+    /** Whether a new drawing may be made as a copy of a drawing of this type. Clone, paste and a
+     *  modifier-drag duplicate each make a new drawing, so a host that does not offer a tool refuses
+     *  them for its drawings: clone and paste make nothing, `canPaste` answers false, and the drag
+     *  moves the drawing itself. Copying to the clipboard is never refused. Absent, every copy is
+     *  made. */
+    copies?: (type: string) => boolean;
     events?: DrawingsEvents;
 }
 /** The running drawing layer a host holds. */
@@ -4052,7 +4135,7 @@ interface DrawingsHandle {
     };
     /** Hide the selection (its own `visible` switch) and deselect it. */
     hideSelected(): void;
-    /** Apply one of the quick per-interval visibility rules to the selection, against the current
+    /** Apply one of the quick per-timeframe visibility rules to the selection, against the current
      *  timeframe. */
     setVisibilityPreset(preset: VisibilityPreset): void;
     /** Drop a ready picture onto the chart, centred in view, selected. */
@@ -4107,16 +4190,16 @@ interface ChartReplayApi {
     setSpeed(speed: ReplaySpeed): void;
     /** Jump the cursor to the live edge. Playback pauses; replay stays on. */
     goLive(): void;
-    /** The update grain: `auto`, or one of the finer timeframe tokens `subIntervals()` lists. */
-    interval(): string;
+    /** The update grain: `auto`, or one of the finer timeframe tokens `subTimeframes()` lists. */
+    timeframe(): string;
     /** Set the grain. A token the chart timeframe cannot form from is refused. */
-    setInterval(token: string): void;
+    setTimeframe(token: string): void;
     /** The grain updates actually use, with `auto` resolved to the token it chose. Empty when the
      *  chart's timeframe has nothing finer to form from, so updates advance whole bars. */
-    resolvedInterval(): string;
+    resolvedTimeframe(): string;
     /** The finer timeframe tokens the chart timeframe can form bars from; empty means whole-bar
      *  updates only. */
-    subIntervals(): readonly string[];
+    subTimeframes(): readonly string[];
     state(): {
         on: boolean;
         playing: boolean;
@@ -4144,6 +4227,58 @@ type ReplayPhase = 'off' | 'arming' | 'on';
  *  presets). The public surface grows on demand, not by exposure. */
 type ChartDrawingsApi = Omit<DrawingsHandle, 'setSymbol' | 'setTimeframe' | 'setTick' | 'setPriceFormatter' | 'destroy' | 'selectedDrawing' | 'commitEdit' | 'beginPreview' | 'endPreview' | 'textEdit' | 'commitText' | 'cancelText' | 'presets'>;
 
+/** What a preset frames: seconds of history, the year to date, or everything loaded. */
+type RangeSpan = number | 'ytd' | 'all';
+interface RangePreset {
+    /** The preset's identity and the text its chip wears ('1D', 'YTD', 'All'). It stays as written
+     *  in every language; a host names the preset by it. */
+    readonly key: string;
+    readonly span: RangeSpan;
+    /** The timeframe token the preset switches the chart to. */
+    readonly tf: string;
+    /** The catalog key of the preset's full name, for its tooltip. */
+    readonly label: ChartMessageKey;
+}
+/** The nine presets, in bar order. */
+declare const RANGE_PRESETS: readonly RangePreset[];
+/** The seconds a span covers back from `nowSecs`; null for 'all', which has no span. */
+declare function rangeSpanSeconds(span: RangeSpan, nowSecs: number): number | null;
+/** Whether a preset is offered for a symbol whose earliest bar is at `earliestBarSecs`: a preset
+ *  deeper than the history that exists is withheld (a listing from last year has no 5Y), 'All'
+ *  always stays, and an unknown depth (null) withholds nothing. The depth itself is the host's to
+ *  learn from its feed; the chart does not probe. */
+declare function rangeAvailable(preset: RangePreset, earliestBarSecs: number | null | undefined, nowSecs?: number): boolean;
+/** A preset's tooltip: what it frames, and the bars it frames it in. */
+declare function rangePresetTip(t: ChartTranslate, preset: RangePreset): string;
+/** The part of a chart the framing needs: a time scale that takes a logical range. */
+interface RangeFrameTarget {
+    timeScale(): {
+        setVisibleLogicalRange(range: {
+            from: number;
+            to: number;
+        }): void;
+    };
+}
+/** Frame a pane on a span, anchored on its LAST REAL bar: a series also carries a future
+ *  whitespace horizon for right-margin drawing, so fitting to content would frame a screen of
+ *  empty space. The bar count comes from the pane's own timeframe, because the same span is a
+ *  different number of bars on a one-minute pane than on a daily one. An empty series, or a token
+ *  the grammar cannot read, frames nothing rather than a bogus window. */
+declare function frameRange(chart: RangeFrameTarget, series: {
+    data(): readonly unknown[];
+}, span: RangeSpan, tf: string, nowSecs?: number): void;
+/** One zoom step multiplies or divides the bar spacing by this. */
+declare const ZOOM_FACTOR = 1.25;
+/** The bar spacing a zoom-out never goes below. */
+declare const MIN_BAR_SPACING = 0.5;
+/** How far one scroll step moves, in bars. */
+declare const SCROLL_STEP_BARS = 10;
+/** The bar spacing after one zoom step from `spacing`. */
+declare function zoomedBarSpacing(spacing: number, direction: 'in' | 'out'): number;
+/** The time-scale scroll position after one scroll step from `position` (positive is right, as
+ *  lightweight-charts counts it). */
+declare function scrolledPosition(position: number, direction: 'left' | 'right'): number;
+
 /** The compare surface a host drives. */
 interface ChartCompareApi {
     add(symbol: string, opts: {
@@ -4152,7 +4287,7 @@ interface ChartCompareApi {
     remove(symbol: string): void;
     setVisible(symbol: string, visible: boolean): void;
     list(): CompareEntry[];
-    /** Latest in-window close for one compare, or null. */
+    /** Latest in-window close for one comparison, or null. */
     latest(symbol: string): number | null;
     /** The host-supplied curated quick-add list, for the compare dialog. */
     symbols(): CompareSymbol[];
@@ -4169,7 +4304,7 @@ declare function applyBar(bars: FeedBar[], bar: FeedBar): FeedBar[] | null;
  *  viewer's, so a later feed that serves the preferred timeframe gets it back. Exported for tests. */
 declare function resolveInitialTf(sticky: string, declared: readonly string[] | undefined): string;
 /** Pane-composition primitives: the raw mirrors a layout syncs charts with. Subscriptions report
- *  USER-driven changes only, so a chart being driven through the setters never re-reports the
+ *  VIEWER-driven changes only, so a chart being driven through the setters never re-reports the
  *  change and two mirrored charts cannot echo each other into a loop. Times are the feed's unix
  *  seconds. */
 interface ChartPaneSyncApi {
@@ -4203,10 +4338,12 @@ interface ChartHandle {
      *  that guessed from the string would be inventing a quote the feed never stated. */
     symbolInfo(): SymbolInfo | null;
     timeframe(): string;
+    /** Switch the timeframe. A timeframe the widget does not offer is ignored. */
     setTimeframe(timeframe: string): void;
     style(): ChartStyleId;
     /** Switch the main-series style. Presentation only: nothing refetches, and the indicators,
-     *  drawings, comparisons and visible range all survive. */
+     *  drawings, comparisons and visible range all survive. A style the widget does not offer is
+     *  ignored. */
     setStyle(id: ChartStyleId): void;
     visibleRange(): TimeRange | null;
     /** The range preset currently framing this chart, or null after other navigation. */
@@ -4228,7 +4365,7 @@ interface ChartHandle {
      *  follow whatever venue the symbol resolves to. */
     timezone(): string;
     /** Set the choice. A value the chart's registry does not carry is refused, because the axis
-     *  formatters could not label a tick with it. */
+     *  formatters could not label a tick with it, and so is one the widget does not offer. */
     setTimezone(choice: string): void;
     /** The zone the choice resolves to for the symbol on screen: the chosen IANA id, or the exchange
      *  zone the resolved symbol declared. Null while `exchange` is chosen and no symbol has resolved. */
@@ -4373,7 +4510,7 @@ interface ChartEvents {
 /** Which changes replay across the layout. All off by default. */
 interface LayoutSyncFlags {
     symbol: boolean;
-    interval: boolean;
+    timeframe: boolean;
     crosshair: boolean;
     time: boolean;
     dateRange: boolean;
@@ -4406,12 +4543,13 @@ interface LayoutSaveLoadApi {
 interface LayoutApi {
     arrangement(): string;
     /** Re-tile. Surviving charts keep their state; new charts clone pane 0's safe presentation;
-     *  excess charts are torn down. */
+     *  excess charts are torn down. An arrangement the widget does not offer is ignored. */
     setArrangement(code: string): void;
     /** The index of the active chart. */
     active(): number;
     setActive(index: number): void;
     sync(): LayoutSyncFlags;
+    /** Set sync switches. A switch the widget does not offer keeps its value. */
     setSync(partial: Partial<LayoutSyncFlags>): void;
     /** The chart standing alone, or null while every chart is tiled. Presentation, not content: a
      *  maximize is a way of LOOKING at a layout, so it rides no blob and a re-tile clears it. */
@@ -4470,7 +4608,7 @@ interface UiConfig {
     topBar?: boolean | TopBarUi;
     /** The bottom bar: range presets, the clock, the timezone picker and the session view. */
     bottomBar?: boolean;
-    /** The drawing rail: the tool groups, cursor, measure and zoom, magnet, lock, the eye, sync,
+    /** The drawing toolbar: the tool groups, cursor, measure and zoom, magnet, lock, the eye, sync,
      *  remove and the favorites star. */
     drawingToolbar?: boolean;
     /** The floating favorite-tools bar. */
@@ -4479,7 +4617,7 @@ interface UiConfig {
     legend?: boolean | LegendUi;
     /** The on-chart navigation cluster: zoom, scroll and reset. */
     navigation?: boolean;
-    /** The chart's own right-click level menu. */
+    /** The chart's own right-click context menu. */
     contextMenu?: boolean;
     /** The replay transport row: play, pause, step, speed and exit. */
     replayTransport?: boolean;
@@ -4489,7 +4627,7 @@ interface UiConfig {
      *  and `chart.symbol.search`. Off, the symbol still changes through `chart.symbol.set`. The
      *  compare dialog belongs to `features.compare`. */
     symbolSearch?: boolean;
-    /** The indicator browser, and its doors: the Indicators button and `chart.indicators.open`. Off,
+    /** The indicator picker, and its doors: the Indicators button and `chart.indicators.open`. Off,
      *  indicators are still added through `chart.indicators.add`. */
     indicatorPicker?: boolean;
     /** The full indicator settings dialog. Off, the legend's gear opens the inputs-only editor, and
@@ -4512,8 +4650,16 @@ interface TopBarUi {
     replay?: boolean;
     /** Undo and redo. */
     history?: boolean;
-    /** The layout setup menu and the saved-layouts menu. */
+    /** The layout setup menu and the saved-layouts menu. `false` hides both, whatever `layoutSetup`
+     *  and `savedLayouts` say. */
     layouts?: boolean;
+    /** The layout setup menu: the arrangement grid and the sync switches. Not shown when the widget
+     *  offers nothing to choose there (see `ChartWidgetOptions.layouts`). */
+    layoutSetup?: boolean;
+    /** The saved-layouts menu: the layout's name with Save, and the menu that saves, copies, renames,
+     *  creates and opens layouts. Not shown without a layouts store (`saveLoad.layouts`), since every
+     *  row saves or reads one; Download chart data then sits in the image menu. */
+    savedLayouts?: boolean;
     /** The chart settings menu. `false` removes it; an object hides part of it. */
     settings?: boolean | SettingsMenuUi;
     /** The fullscreen button. */
@@ -4543,13 +4689,37 @@ interface LegendUi {
 interface AccessPolicy {
     /** Whether a command id may run. A refused command answers `denied` from every surface. */
     command?(id: string): boolean;
-    /** Whether a drawing tool id may be armed. */
+    /** Whether a drawing tool id may be armed. Placing an image (`placeImage`, the picker, a paste)
+     *  asks it for `image`. A copy is a new drawing, so a drawing of a refused tool is not cloned,
+     *  pasted or duplicated by a modifier-drag. A restore (a saved chart, a layout load, an undo, a
+     *  drawings document) puts drawings of a refused tool back like any other, and on the chart they
+     *  stay whole: they select, restyle, lock, hide and delete as any drawing does. */
     drawingTool?(id: string): boolean;
     /** Whether an indicator definition may be added, asked by its DEFINITION id (`manifest.id`; a
      *  built-in's is the catalog id the picker lists, such as `sma`), never by an instance id. Every
-     *  door asks the same id: the picker row, `indicators.add`, and a restore. A definition that
-     *  declares no id is not gated. */
+     *  door that adds asks the same id: the picker row, `indicators.add`, and `indicators.set` for an
+     *  instance the chart does not hold. The policy refuses adding, never restoring: a saved chart, a
+     *  layout load, an undo or a redo puts an instance of a refused definition back like any other.
+     *  An instance of a refused definition the chart holds stays whole: `indicators.set` and
+     *  `chart.indicators.update` edit it, an edit that would move it onto a refused definition leaves
+     *  it as it stands, and every remove door removes it. A definition that declares no id is not
+     *  gated. */
     indicator?(id: string): boolean;
+    /** How the chart's own controls present what the predicates refuse. `'disable'` (the default)
+     *  draws a refused control disabled, which suits an offer the viewer can unlock. `'hide'` leaves
+     *  it out: a refused drawing tool is not in the drawing toolbar's flyouts, on the favorites bar
+     *  or in the glyph picker, and a section or group it empties goes with it; a refused indicator is
+     *  not in the indicator picker; and a control or menu row whose command is refused is not drawn.
+     *
+     *  Only a refusal hides. A permitted command that cannot run now (nothing to undo, no bars
+     *  loaded, nothing selected) is still drawn disabled. Like the predicates it is read whenever a
+     *  control is drawn or synced, and again on `widget.refreshAccess()`, so the controls follow a
+     *  policy that changes. Nothing stored is
+     *  rewritten: a viewer's favorite keeps its star and returns when the policy permits it again,
+     *  and drawings and indicators already on the chart render as they do under either value. Every
+     *  other door (the keyboard, `widget.commands`, the chart handles) refuses exactly as it does
+     *  under `'disable'`. Any other value is a setup error thrown from `createChart`. */
+    refused?: 'disable' | 'hide';
 }
 /** ── PREFERENCES ─────────────────────────────────────────────────────────────────────────────
  *  The viewer's own values: what the storage port persists and restores. A host supplies initial
@@ -4561,7 +4731,7 @@ interface ChartPreferences {
     style: ChartStyleId;
     scaleMode: ScaleMode;
     /** The display timezone: an IANA id from the chart's registry, or `exchange` to follow whatever
-     *  venue the symbol resolves to. */
+     *  venue the symbol resolves to. One that `timezones` leaves out opens on the first listed. */
     timezone: string;
     /** Which subsession intraday bars are shown for. A symbol with no extended hours has one, so a
      *  stored `extended` on such a symbol falls back rather than filtering to nothing. */
@@ -4570,9 +4740,9 @@ interface ChartPreferences {
     hiddenIndicators: readonly string[];
     replaySpeed: ReplaySpeed;
     /** The replay update grain: `auto` or a finer timeframe token. */
-    replayInterval: string;
-    /** The standing drawing choices: cursor, magnet, stay-in-mode, favorites, per-group rail tools.
-     *  The drawing models own what each one means; the chart only persists the record. */
+    replayTimeframe: string;
+    /** The standing drawing choices: cursor, magnet, stay-in-mode, favorites, per-group toolbar
+     *  tools. The drawing models own what each one means; the chart only persists the record. */
     drawings: DrawingPreferences;
     /** The timeframe tokens the top bar shows as quick-select chips. */
     savedTimeframes: readonly string[];
@@ -4636,7 +4806,7 @@ interface ImageOptions {
     header?: boolean;
 }
 /** ── DRAWING PERSISTENCE ─────────────────────────────────────────────────────────────────────
- *  Where the trader's drawings are stored. Two modes, and the host picks one HERE, at construction:
+ *  Where the viewer's drawings are stored. Two modes, and the host picks one HERE, at construction:
  *
  *    combined  (the default) the drawings ride the chart's own saved content, so saving a chart or
  *              a layout saves the drawings that are on it.
@@ -4658,9 +4828,12 @@ interface DrawingPersistenceOptions {
 }
 /** The multi-chart arrangement the widget opens with. */
 interface LayoutOptions {
-    /** An arrangement code from the catalog (default `s`, one chart). Unknown codes throw. */
+    /** An arrangement code from the catalog (default `s`, one chart, or the first of
+     *  `ChartWidgetOptions.layouts` when the host lists them). Unknown codes throw, and with `layouts`
+     *  the code must be one of them. */
     arrangement?: string;
-    /** Per-chart starting symbol and timeframe, index-aligned to the arrangement's panes. */
+    /** Per-chart starting symbol and timeframe, index-aligned to the arrangement's panes. A timeframe
+     *  must be one the widget offers. */
     charts?: {
         symbol?: string;
         timeframe?: string;
@@ -4690,8 +4863,8 @@ interface IndicatorInstance {
     title?: string;
     overrides?: IndicatorOverrides;
 }
-/** The set of symbols a search answers from, as the host names it: a portfolio, a broker, a
- *  watchlist or any other scope its datafeed applies. `mark` paints the scope's own mark into the
+/** The set of symbols a search answers from, as the host names it: a portfolio, a watchlist or
+ *  any other scope its datafeed applies. `mark` paints the scope's own mark into the
  *  box the chart owns and returns what takes it down; absent, the scope wears its initial. */
 interface SearchScope {
     readonly label: string;
@@ -4700,6 +4873,31 @@ interface SearchScope {
         size: number;
     }) => (() => void) | void;
 }
+/** How the symbol search offers its class filter and its spread operators. Every field is optional,
+ *  and a host that sets none gets the default search: all six operators, an All chip, and one class
+ *  selected at a time. */
+interface SearchDisplayOptions {
+    /** The spread operators and the expression rows. `true` (the default) offers every operator.
+     *  `false` offers no operator toggle, no operator and no expression row, and searches your feed
+     *  with the query exactly as typed. `{ operators }` keeps spreads on and offers only the listed
+     *  operators, in the listed order; an empty list offers no operator toggle while a typed
+     *  expression still reads as one. The compare dialog offers no operator buttons either way. */
+    spreads?: boolean | {
+        readonly operators: readonly SpreadOperatorId[];
+    };
+    /** The class strip's All chip. `false` offers none: with one class selected at a time the first
+     *  declared class starts selected, and with several, no selection means every class. `{ label }`
+     *  writes the chip with your label. Absent, the chip wears the catalog's own label. A class's own
+     *  row of narrower classes always opens with its all chip, written the same way. */
+    allClasses?: false | {
+        readonly label: string;
+    };
+    /** How many classes the viewer selects at once. `single` (the default) makes the chips a choice
+     *  of one, and your feed hears it as `cls`. `multiple` makes each chip a toggle, the All chip
+     *  clears the selection, and your feed hears `classes` with every selected class, and `cls` too
+     *  while exactly one is selected. */
+    classSelection?: 'single' | 'multiple';
+}
 /** 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 {
@@ -4723,12 +4921,148 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     storage?: ChartStorage;
     /** The symbol to open on. */
     symbol?: string;
-    /** The timeframe token to open on. */
+    /** The timeframe token to open on. With `timeframes` or `customTimeframes: false` it must be one
+     *  the chart offers. */
     timeframe?: string;
-    /** The main-series style to open on. */
+    /** The main-series style to open on. It must be one of `styles`. */
     style?: ChartStyleId;
+    /** The main-series styles the chart offers, in this order. Absent, every style in `CHART_STYLES`
+     *  is offered and the picker groups them by family.
+     *
+     *  A style left out stays off this chart: it has no `chart.style.<id>` command, so no
+     *  menu, shortcut or host control reaches it, and `setStyle` ignores it. The picker lists the
+     *  offered styles in the order given, and is not shown when one style is offered, since there is
+     *  nothing to choose. `ui.topBar.styles: false` hides the picker on its own terms.
+     *
+     *  A saved layout, saved chart or stored preference that names a style outside the list opens on
+     *  the FIRST offered style, and the rest of it restores. An empty list, an id outside
+     *  `CHART_STYLES`, a repeated id, and a `style` outside the list are setup errors thrown from
+     *  `createChart`. */
+    styles?: readonly ChartStyleId[];
+    /** The timeframe tokens the chart offers. Absent, every preset in `TIMEFRAME_PRESETS` is offered
+     *  and the viewer may compose custom timeframes. Any token the grammar reads may be listed,
+     *  preset or not (`2m`). The order given does not matter: the picker lists each unit's group
+     *  smallest first.
+     *
+     *  A token left out stays off this chart. A preset left out has no
+     *  `chart.timeframe.<token>` command, `chart.timeframe.set` and `setTimeframe` ignore a token
+     *  left out, and the picker shows no chip and no row for it. A group with no listed token is not
+     *  shown, a listed token beyond the presets sits in its unit's group, and there is no
+     *  custom-timeframe composer. The viewer's saved chips show where they are listed. When the list
+     *  leaves none of them, the chips are the first five listed tokens, and the viewer's stored chips
+     *  are kept unchanged for a chart that offers them. The picker is not shown when one timeframe is
+     *  offered, since there is nothing to choose. `ui.topBar.timeframes: false` hides the picker on
+     *  its own terms. A range preset whose timeframe is left out reads its span at the smallest
+     *  listed timeframe at or above that timeframe, else at the largest listed.
+     *
+     *  A saved layout, saved chart or stored preference that names a token outside the list opens on
+     *  the SMALLEST listed timeframe, and the rest of it restores. An empty list, a token the grammar
+     *  cannot read, a repeated token, a `timeframe` or `layout.charts[].timeframe` outside the list,
+     *  and `customTimeframes: true` beside a list are setup errors thrown from `createChart`. */
+    timeframes?: readonly string[];
+    /** Whether the viewer may compose custom timeframes beyond the presets (default true). `false`
+     *  offers the 26 presets alone: the picker has no composer and lists none of the viewer's custom
+     *  timeframes, and `chart.timeframe.set` and `setTimeframe` ignore a token that is not a preset.
+     *  A stored token beyond the presets opens on `1m`, and a `timeframe` beyond them is a setup
+     *  error. A `timeframes` list offers nothing beyond itself, so `false` beside one changes nothing
+     *  and `true` beside one is a setup error.
+     *
+     *  This switch is not `preferences.customTimeframes`, which is the list of custom tokens a
+     *  first-run viewer starts with. */
+    customTimeframes?: boolean;
+    /** The range presets the chart's bottom bar offers, by the key `RANGE_PRESETS` gives each
+     *  (`1D`, `5D`, `1M`, `3M`, `6M`, `YTD`, `1Y`, `5Y`, `All`), in this order. Absent, all nine
+     *  are offered in their own order.
+     *
+     *  A preset left out stays off this chart: it has no `chart.range.<key>` command, so no
+     *  menu, shortcut or host control reaches it, `chart.range.set` ignores its key, and the bottom
+     *  bar draws no button for it. An empty list offers no preset: the bottom bar keeps its clock,
+     *  timezone picker and session view, and `chart.range.set` still takes an explicit window.
+     *  `ui.bottomBar: false` removes the whole bar. A preset whose timeframe `timeframes` leaves out
+     *  reads its span at the nearest coarser timeframe the chart offers. A non-list, a key that names
+     *  no preset and a repeated key are setup errors thrown from `createChart`. */
+    ranges?: readonly string[];
+    /** The display timezones the chart offers: zone ids `TIMEZONES` lists, and `exchange` for the
+     *  charted symbol's own zone. Absent, every zone and the exchange choice are offered. The
+     *  timezone picker keeps its own order (UTC, the exchange choice, then every zone by its current
+     *  offset); the order given decides only which choice is first.
+     *
+     *  A choice left out stays off this chart: it has no `chart.timezone.<id>` command (or
+     *  `chart.timezone.exchange`), `chart.timezone.set` and `setTimezone` ignore it, and the picker
+     *  lists no row for it. With one choice offered the picker is not shown, since there is nothing to
+     *  choose, and the bottom bar's clock still reads the time in that zone.
+     *
+     *  A chart opens on the viewer's stored choice, else `preferences.timezone`, when the list offers
+     *  it, and otherwise on the FIRST choice listed. A stored choice outside the list is not
+     *  rewritten until the viewer chooses, so a chart that offers it again opens on it. The exported
+     *  registry (`TIMEZONES`, `isTimezoneChoice`, `timezoneListing`) is never filtered. A non-list,
+     *  an empty list, an id that names no zone and a repeated id are setup errors thrown from
+     *  `createChart`. */
+    timezones?: readonly string[];
     /** The multi-chart arrangement. One chart when omitted. */
     layout?: LayoutOptions;
+    /** The arrangement codes the chart offers (`ARRANGEMENTS`). Absent, all 55 are offered. The
+     *  layout opens on `layout.arrangement`, else on the first code listed. The layout setup menu
+     *  keeps its own rows by chart count and shows only the listed arrangements, and the order given
+     *  breaks ties when a saved layout falls back (below).
+     *
+     *  An arrangement left out stays off this chart: no tile shows it, and
+     *  `widget.layout.setArrangement` and the `widget.layout.setArrangement` command ignore it. With
+     *  one arrangement offered the layout setup menu is not shown, since there is nothing to choose,
+     *  unless that arrangement holds several charts and a sync switch is offered (`layoutSync`): the
+     *  menu then holds the switches alone. `['s']` is a single chart with no layout setup menu.
+     *  `ui.topBar.layoutSetup: false` hides the menu on its own terms.
+     *
+     *  A saved layout whose arrangement is left out opens on the offered arrangement with the most
+     *  charts not above the saved layout's count, the first listed winning a tie. When every offered
+     *  arrangement holds more charts, it opens on the one with the fewest, and the panes past the
+     *  saved charts are filled as a re-tile fills new panes, from the first chart. Saved charts past
+     *  the ones shown are not dropped: the layout carries them, with the saved arrangement and its
+     *  divider positions, and a save of it writes them back unchanged beside the shown charts as they
+     *  are now, so a chart that offers the saved arrangement again opens all of them. A re-tile the
+     *  viewer or the host makes is a new arrangement, and what was carried goes with the charts it
+     *  tears down. A saved active chart among the hidden ones leaves the first chart active. Sync
+     *  switches restore as saved, apart from those `layoutSync` leaves out.
+     *
+     *  An empty list, an unknown code, a repeated code and a `layout.arrangement` outside the list
+     *  are setup errors thrown from `createChart`. */
+    layouts?: readonly string[];
+    /** The sync switches the viewer may change (`symbol`, `timeframe`, `crosshair`, `time`,
+     *  `dateRange`). Absent, every one. A switch left out holds the value `layout.sync` gives it, or
+     *  off: the layout setup menu does not show it, `widget.layout.setSync` and its command leave it
+     *  as it is, and a saved layout cannot change it. An empty list fixes every switch and leaves the
+     *  layout setup menu the arrangements alone. An unknown or repeated switch is a setup error thrown
+     *  from `createChart`. */
+    layoutSync?: readonly (keyof LayoutSyncFlags)[];
+    /** The drawing tools the chart offers, by the type `access.drawingTool` and the `tool.<type>`
+     *  icon ids use: any type `drawingTools.all()` lists, `zoom` or `eraser`. Absent, every tool is
+     *  offered. The order given does not matter: the drawing toolbar keeps its own groups and
+     *  sections.
+     *
+     *  A tool left out stays off this chart for creating drawings, and every place a tool is chosen
+     *  leaves it out: its group's flyout, a group's face (which wears the first tool the group
+     *  offers), the favorites bar and the drawing toolbar (`measure`, `zoom`). A section
+     *  or group it empties goes with it. The glyph picker's kinds are the `emoji`, `sticker` and
+     *  `icon` tools, and a kind left out has no tab. `chart.drawings.arm`, `armTool`, `placeImage` and
+     *  an image pasted over the chart refuse it. A copy of a drawing of it is refused too, since a
+     *  copy is a new drawing: `chart.drawings.clone` and `chart.drawings.paste` are unavailable for
+     *  one, `clone` and `paste` make nothing, and a modifier-drag moves the drawing instead of
+     *  duplicating it. Copying one to the clipboard, to paste on a chart that offers it, is not
+     *  refused.
+     *
+     *  Drawings of a tool left out that are already on the chart (from a saved chart or layout, a
+     *  drawings document or another host) render and stay fully editable: they select, restyle
+     *  through the selection's bar and the settings dialog, lock, hide and delete as any drawing
+     *  does. The eraser is always offered, listed or not, because it removes rather than creates, so
+     *  `['eraser']` is a chart whose viewers keep and remove what is on it and make nothing new.
+     *
+     *  It composes with `access`: a tool is offered when it is listed AND the policy permits it, and a
+     *  listed tool the policy refuses is drawn as `access.refused` says. Nothing stored is rewritten:
+     *  a starred tool left out keeps its star, and a group's remembered face is kept, for a chart that
+     *  offers them. `features.drawings: false` removes drawing altogether whatever the list says. An
+     *  empty list, a type that names no tool and a repeated type are setup errors thrown from
+     *  `createChart`. */
+    drawingTools?: readonly string[];
     /** Where the drawings are stored: with the chart's own saved content (the default) or in their
      *  own documents through the adapter's drawings family. */
     drawingPersistence?: DrawingPersistenceOptions;
@@ -4749,10 +5083,35 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     access?: AccessPolicy;
     /** Initial viewer preferences, for a first-run chart. A stored value wins once there is one. */
     preferences?: Partial<ChartPreferences>;
-    /** Optional localized content and actions in the chart-owned indicator browser. */
+    /** Optional localized content and actions in the chart-owned indicator picker. */
     indicatorPicker?: IndicatorPickerSource;
     /** Indicator instances on the chart at mount. */
     indicators?: IndicatorInstance[];
+    /** The built-in indicators the chart offers, by the definition id `access.indicator` receives:
+     *  any id `BUILT_IN_INDICATORS` lists, such as `sma`. Absent, every built-in is offered. The order
+     *  given does not matter: the indicator picker keeps its own.
+     *
+     *  A built-in left out stays off this chart. The indicator picker leaves it out of the built-ins,
+     *  the favorites (a starred one keeps its star in storage) and the search results, and the host's
+     *  `indicatorPicker` listing is handed only the offered ids. Every
+     *  door that would add one refuses: `chart.indicators.add` answers `denied`, `indicators.add`
+     *  adds nothing, `indicators.set` leaves out an instance of it the chart does not already hold,
+     *  and a new pane a re-tile adds copies the first chart's indicators without it. There is no
+     *  duplicate verb for an indicator; adding a second instance is adding.
+     *
+     *  Instances of a built-in left out that are already on the chart (from a saved chart or layout,
+     *  an undo step or another host sharing the store) render and stay fully editable and removable:
+     *  the settings dialog, `chart.indicators.update`, the legend's eye and remove, remove all and
+     *  `indicators.remove` all work on them, and an edit that would move one onto another left-out
+     *  built-in keeps it as it stands. Nothing saved is rewritten because of the list.
+     *
+     *  A definition whose `manifest.id` names no built-in is the host's own and is never filtered, nor
+     *  is what an `indicatorPicker` source lists. It composes with `access`: a built-in is offered
+     *  when it is listed AND the policy permits it, and a listed one the policy refuses is drawn as
+     *  `access.refused` says. A non-list, an empty list, an id that names no built-in, a repeated id
+     *  and an `indicators` instance whose built-in is not listed are setup errors thrown from
+     *  `createChart`. */
+    builtInIndicators?: readonly string[];
     /** A built-in interface language for the chart's chrome and its date formatting. */
     locale?: ChartLocaleCode;
     /** A host-owned localization adapter. When supplied it replaces `locale`, and the host owns its
@@ -4766,9 +5125,10 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     image?: ImageOptions;
     /** The symbol picker's host inputs. The chart owns the search controller (its debounce, cache and
      *  cancellation); a host supplies only what it alone knows: where the viewer's recent symbols
-     *  live, and what its feed's asset classes are called. Absent, recents last the page and a
-     *  class's filter chip wears the class token as written. */
-    search?: {
+     *  live, what its feed's asset classes are called, and how the classes and the spread operators
+     *  are offered. Absent, recents last the page, a class's filter chip wears the class token as
+     *  written, and the search offers its default class strip and operators. */
+    search?: SearchDisplayOptions & {
         recents?: RecentsPort;
         /** Display names for the asset-class tokens the feed's `config()` declares in `classes`. */
         classNames?: Readonly<Record<string, string>>;
@@ -4785,7 +5145,7 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     marks?: boolean;
 }
 
-/** Host-owned activity, displayed with studies but never saved as an indicator or plotted. */
+/** Host-owned activity, displayed with indicators but never saved as an indicator or plotted. */
 interface ChartLegendRow {
     id: string;
     title: string;
@@ -4924,7 +5284,8 @@ type TopBarSlot = (typeof TOP_BAR_SLOTS)[number];
  *  A slot is live for as long as the widget is. A host appends its own node and takes that node back
  *  out again; the slot itself belongs to the chart and is never removed or replaced. */
 interface ChartChrome {
-    /** Transient host activity in this chart's native study list. Does not affect chart content. */
+    /** Transient host activity in this chart's native indicator list. Does not affect chart
+     *  content. */
     legendRows(chartId: string, rows: readonly ChartLegendRow[]): void;
     /** One named place in the top bar. Null when the top bar is hidden, which is the answer a host
      *  checks before composing a door it would have nowhere to put. */
@@ -4960,6 +5321,15 @@ interface ChartWidget {
     /** The chrome's host slots. A host that composes its own doors puts them here rather than beside
      *  the chart, so a service the chart does not own still reads as part of the same toolbar. */
     chrome: ChartChrome;
+    /** Ask the access policy again, now. The chart's own controls read `access` whenever they sync
+     *  and whenever a menu opens; call this when the policy's answers changed with nothing on the
+     *  chart changing (a viewer's plan changed mid-session). Every control, menu row, drawing toolbar
+     *  tool and group, the favorites bar, the glyph picker, the legend's row controls and every menu,
+     *  flyout and dialog that is open (the indicator picker among them) read the policy again: shown
+     *  or left out under `access.refused`, enabled or disabled. Listeners of `commands.onChange` hear
+     *  it too, so a host's own controls can read `commands.available` again. Nothing stored and
+     *  nothing on the chart changes. Inert after `dispose`. */
+    refreshAccess(): void;
     on<K extends keyof WidgetEvents>(name: K, callback: WidgetEvents[K]): () => void;
     /** Tear down every chart, subscription, timer and DOM resource. Idempotent, and every handle and
      *  subscription is inert afterwards. */
@@ -4995,7 +5365,7 @@ declare class FillBetweenPrimitive implements ISeriesPrimitive<Time> {
     private lower;
     private colors;
     /** Nothing until the first `setData`, which every render path makes before a draw. A tint chosen
-     *  here would be a second study default with no owner. */
+     *  here would be a second indicator default with no owner. */
     private color;
     attached(param: SeriesAttachedParameter<Time>): void;
     detached(): void;
@@ -5024,7 +5394,7 @@ declare class ShadePrimitive implements ISeriesPrimitive<Time> {
  *  isCollapsed would deny the restore affordance forever. */
 declare const COLLAPSED_H = 30;
 /** The main pane never shrinks below this, whatever a maximize asks for: an unreadable price pane
- *  is worse than an unmaximized study. */
+ *  is worse than an unmaximized indicator. */
 declare const MAIN_MIN_H = 80;
 type PaneOp = {
     kind: 'collapse';
@@ -5139,7 +5509,7 @@ declare const SESSION_DOT: Readonly<Record<SessionState, ThemeRoleId>>;
  *  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 intervals only: a daily or
+ *  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. */
 interface SessionBandsPrimitive {
@@ -5256,9 +5626,9 @@ interface Timeframe {
     readonly count: number;
     readonly unit: TimeframeUnit;
 }
-/** Every unit, smallest first: the custom-interval picker's unit rows and the sort order. */
+/** Every unit, smallest first: the custom-timeframe picker's unit rows and the sort order. */
 declare const TIMEFRAME_UNITS: readonly TimeframeUnit[];
-/** The inclusive per-unit count ceiling. A token past it parses as null, so a custom-interval
+/** The inclusive per-unit count ceiling. A token past it parses as null, so a custom-timeframe
  *  input disables Add and a feed is never asked for it. */
 declare const TIMEFRAME_MAX: Readonly<Record<TimeframeUnit, number>>;
 /** Nominal seconds per unit: exact for the fixed-duration units (s/m/h/d/w), a coarse nominal for
@@ -5274,7 +5644,7 @@ declare function formatTimeframe(tf: Timeframe): string | null;
  *  count). */
 declare function timeframeSeconds(tf: Timeframe): number;
 /** True for a sub-daily token (ticks, seconds, minutes, hours). Session bands and the
- *  regular-hours filter engage on intraday intervals only, because a daily or larger bar spans
+ *  regular-hours filter engage on intraday timeframes only, because a daily or larger bar spans
  *  whole sessions. A token the grammar cannot read is NOT intraday: mis-shading a chart is worse
  *  than not shading it. */
 declare function isIntradayTimeframe(token: string): boolean;
@@ -5298,18 +5668,18 @@ interface TimeframeGroup {
 /** The 26 preset timeframes, grouped as the picker shows them. Weeks and months share the Days
  *  group. The count is a release inventory: it moves only by decision. */
 declare const TIMEFRAME_PRESETS: readonly TimeframeGroup[];
-/** Every preset token across the groups. A custom interval that already exists as a preset is
+/** Every preset token across the groups. A custom timeframe that already exists as a preset is
  *  refused rather than listed twice. */
 declare const TIMEFRAME_PRESET_TOKENS: ReadonlySet<string>;
-/** The unit's own name in the chart catalog: a picker group's heading and the custom-interval
+/** The unit's own name in the chart catalog: a picker group's heading and the custom-timeframe
  *  unit rows. */
 declare const TIMEFRAME_UNIT_NAME: Readonly<Record<TimeframeUnit, ChartMessageKey>>;
 /** A readable label for a token in the chart's language: '5t' reads "5 Ticks", '1h' reads
  *  "1 Hour". A token the grammar cannot read is returned as written, which is what the feed calls
  *  it, never a blank. */
 declare function timeframeLabel(t: ChartTranslate, token: string): string;
-/** What a symbol and its feed declare about the intervals they serve. Both lists are optional and
- *  an EMPTY list is no restriction: a feed or symbol that serves any interval says nothing rather
+/** What a symbol and its feed declare about the timeframes they serve. Both lists are optional and
+ *  an EMPTY list is no restriction: a feed or symbol that serves any timeframe says nothing rather
  *  than listing everything. `supportedResolutions` is the symbol's own list (`SymbolInfo`);
  *  `resolutions` is the feed-level list (`DatafeedConfig`). A token must pass every list given. */
 interface TimeframeRestrictions {
@@ -5329,10 +5699,10 @@ interface ChartTimezone {
     /** The display city, as the timezone picker writes it. */
     readonly city: string;
 }
-/** The selectable zones: one city per offset region a trader picks. The count is a release
+/** The selectable zones: one city per offset region a viewer picks. The count is a release
  *  inventory: it moves only by decision. */
 declare const TIMEZONES: readonly ChartTimezone[];
-/** The zone a chart displays in before a host or a trader chooses one. */
+/** The zone a chart displays in before a host or a viewer chooses one. */
 declare const DEFAULT_TIMEZONE = "Etc/UTC";
 /** The timezone choice that follows the charted symbol's exchange: a display preference resolves
  *  it per symbol through {@link resolveDisplayTimezone}. */
@@ -5393,58 +5763,6 @@ declare function timezoneListing(t: ChartTranslate, options?: {
     at?: Date;
 }): TimezoneRow[];
 
-/** What a preset frames: seconds of history, the year to date, or everything loaded. */
-type RangeSpan = number | 'ytd' | 'all';
-interface RangePreset {
-    /** The preset's identity and the text its chip wears ('1D', 'YTD', 'All'). It stays as written
-     *  in every language; a host names the preset by it. */
-    readonly key: string;
-    readonly span: RangeSpan;
-    /** The timeframe token the preset switches the chart to. */
-    readonly tf: string;
-    /** The catalog key of the preset's full name, for its tooltip. */
-    readonly label: ChartMessageKey;
-}
-/** The nine presets, in bar order. */
-declare const RANGE_PRESETS: readonly RangePreset[];
-/** The seconds a span covers back from `nowSecs`; null for 'all', which has no span. */
-declare function rangeSpanSeconds(span: RangeSpan, nowSecs: number): number | null;
-/** Whether a preset is offered for a symbol whose earliest bar is at `earliestBarSecs`: a preset
- *  deeper than the history that exists is withheld (a listing from last year has no 5Y), 'All'
- *  always stays, and an unknown depth (null) withholds nothing. The depth itself is the host's to
- *  learn from its feed; the chart does not probe. */
-declare function rangeAvailable(preset: RangePreset, earliestBarSecs: number | null | undefined, nowSecs?: number): boolean;
-/** A preset's tooltip: what it frames, and the bars it frames it in. */
-declare function rangePresetTip(t: ChartTranslate, preset: RangePreset): string;
-/** The part of a chart the framing needs: a time scale that takes a logical range. */
-interface RangeFrameTarget {
-    timeScale(): {
-        setVisibleLogicalRange(range: {
-            from: number;
-            to: number;
-        }): void;
-    };
-}
-/** Frame a pane on a span, anchored on its LAST REAL bar: a series also carries a future
- *  whitespace horizon for right-margin drawing, so fitting to content would frame a screen of
- *  empty space. The bar count comes from the pane's own interval, because the same span is a
- *  different number of bars on a one-minute pane than on a daily one. An empty series, or a token
- *  the grammar cannot read, frames nothing rather than a bogus window. */
-declare function frameRange(chart: RangeFrameTarget, series: {
-    data(): readonly unknown[];
-}, span: RangeSpan, tf: string, nowSecs?: number): void;
-/** One zoom step multiplies or divides the bar spacing by this. */
-declare const ZOOM_FACTOR = 1.25;
-/** The bar spacing a zoom-out never goes below. */
-declare const MIN_BAR_SPACING = 0.5;
-/** How far one scroll step moves, in bars. */
-declare const SCROLL_STEP_BARS = 10;
-/** The bar spacing after one zoom step from `spacing`. */
-declare function zoomedBarSpacing(spacing: number, direction: 'in' | 'out'): number;
-/** The time-scale scroll position after one scroll step from `position` (positive is right, as
- *  lightweight-charts counts it). */
-declare function scrolledPosition(position: number, direction: 'left' | 'right'): number;
-
 /** A catalog kept warm between opens, from `createSymbolSearchCache`. Completed pages outlive a
  *  dialog, so the second open of a picker, and the first one on a page that warmed it, stands on
  *  what the viewer already saw instead of a loading line. Query state and in-flight work never pass
@@ -5460,7 +5778,7 @@ declare function createSymbolSearchCache(options: {
     datafeed: Pick<ChartDatafeed, 'search'>;
     pageSize?: number;
 }): SymbolSearchCache;
-interface SymbolSearchOptions extends MarkPainterHooks {
+interface SymbolSearchOptions extends MarkPainterHooks, SearchDisplayOptions {
     /** The feed the search runs against: the one a chart takes, or anything that answers `search`. */
     datafeed: Pick<ChartDatafeed, 'search'>;
     /** A catalog warmed over that same feed. Absent, this picker searches from cold and its pages go
@@ -5481,8 +5799,9 @@ interface SymbolSearchOptions extends MarkPainterHooks {
     icons?: ChartIcons;
     /** Where recent picks are read and written. Default: a list that lives as long as the dialog. */
     recents?: RecentsPort;
-    /** The asset classes the feed declares, for the filter strip. Absent, there is no strip. */
-    classes?: readonly string[] | null;
+    /** The asset classes the feed declares, for the filter strip, as a feed's `config()` declares
+     *  them. Absent, there is no strip. */
+    classes?: readonly (string | SearchClassNode)[] | null;
     /** Display names for those classes. A class without one wears its token. */
     classNames?: Readonly<Record<string, string>>;
     /** The query the field opens holding, selected so that typing replaces it. */
@@ -5511,4 +5830,59 @@ declare function mountSymbolSearch(options: SymbolSearchOptions & {
     container: HTMLElement;
 }): MountedSymbolSearch;
 
-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 ChartExtensionMenuContext, type ChartExtensionMenuItem, type ChartExtensionMenuProvider, 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 DataStatus, type DatafeedConfig, 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 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, type ProviderMarkPainter, 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 SearchController, type SearchControllerOptions, 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 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 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, autoIntervalFor, 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, nextSessionChange, olderPageVerdict, openInputsEditor, openSymbolSearch, overriddenManifest, parseSessionModel, parseTickBands, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subIntervalsFor, subsessionBarFilter, symbolNames, tfSeconds, tfToUdfResolution, tickBandFor, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };
+interface TimeframePickerOptions {
+    /** Where the picked timeframe goes. The drop-down closes on the pick. */
+    onPick(timeframe: string): void;
+    /** The timeframe the list opens on, checked: the page's current value. Absent, no row is checked.
+     *  It must be one the list offers. */
+    timeframe?: string;
+    /** The timeframes the list offers, as a chart's `timeframes` names them: any tokens the grammar
+     *  reads, in any order, drawn smallest first in their units' groups, with no composer. */
+    timeframes?: readonly string[];
+    /** Whether the list offers composing a custom timeframe, as a chart's `customTimeframes` says.
+     *  Default true; `false` offers the presets alone. */
+    customTimeframes?: boolean;
+    /** The resolutions the feed serves, as a feed's `config()` declares them. A timeframe outside
+     *  them is left out of the list, as the chart's list leaves it out, and is never composed. */
+    resolutions?: readonly string[] | null;
+    /** The resolutions the symbol serves, as its `supportedResolutions` declares them, with the same
+     *  effect. */
+    supportedResolutions?: readonly string[] | null;
+    /** The element the drop-down's layer mounts in. Default: the document body, where the list stands
+     *  over the page rather than inside whatever box opened it. */
+    container?: HTMLElement;
+    /** Mode and palettes, as a chart takes them. Default: dark. */
+    theme?: ThemeControllerOptions;
+    /** The language, as a chart takes it. */
+    locale?: string;
+    /** A prepared runtime, when the page already has the chart's. It wins over `locale`. */
+    i18n?: ChartI18n;
+    /** The host's drawings for the list's glyphs, as a chart takes them. */
+    icons?: ChartIcons;
+    /** Called once the list is gone, however it went. */
+    onClose?(): void;
+}
+interface TimeframePickerHandle {
+    /** Close it from the outside. Closing twice is safe, and the list's own close is the same door. */
+    close(): void;
+}
+/** Drop the chart's timeframe list from a control the page owns, with no chart behind it. */
+declare function openTimeframePicker(options: TimeframePickerOptions & {
+    anchor: HTMLElement;
+}): TimeframePickerHandle;
+interface MountedTimeframePicker {
+    /** The element the list was built into, for a page that measures or animates its own box. */
+    element: HTMLElement;
+    /** Put focus on the checked row, or the first, for a page whose box has just opened. */
+    focus(): void;
+    /** Take it down: the element goes. */
+    dispose(): void;
+}
+/** The same list with no drop-down around it, built into a box the page owns and positions: a
+ *  phone's card, a panel in a page's own chrome. The page decides where it stands and when it goes;
+ *  picking hands the timeframe back, then calls `onClose`, which is the page's cue to close its box. */
+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 };