@trdrs/quickcharts 1.2.0 → 1.3.0

package/dist/index.d.ts

@@ -225,6 +225,27 @@ declare class FeedUnavailableError extends Error {
      *  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
@@ -233,8 +254,10 @@ declare class FeedUnavailableError extends Error {
 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
@@ -1708,9 +1728,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';
@@ -2275,7 +2297,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 rail'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 +2756,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
@@ -3215,7 +3277,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 browser lists: every one, or those `builtInIndicators`
+     *  offers. */
     list(request: {
         collection: string;
         query: string;
@@ -3424,8 +3488,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 +3509,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 +3549,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). */
@@ -3752,7 +3825,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;
 }
 
@@ -3996,6 +4071,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. */
@@ -4144,6 +4225,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 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;
+
 /** The compare surface a host drives. */
 interface ChartCompareApi {
     add(symbol: string, opts: {
@@ -4203,10 +4336,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 +4363,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. */
@@ -4406,12 +4541,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. */
@@ -4512,8 +4648,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 +4687,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 rail'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 browser; 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 +4729,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. */
@@ -4658,9 +4826,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;
@@ -4700,6 +4871,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 +4919,147 @@ 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 is not a style of 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 is not a timeframe of 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 interval is left out reads its span at the smallest listed
+     *  timeframe at or above that interval, 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 is not a range of 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 interval `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 is not a timezone of 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 is not an arrangement of 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`, `interval`, `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 rail keeps its own groups and sections.
+     *
+     *  A tool left out is not a tool of this chart for creating drawings. It is not drawn anywhere a
+     *  tool is chosen: not in its group's flyout, not as a group's face (which wears the first tool
+     *  the group offers), not on the favorites bar and not on the rail (`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;
@@ -4753,6 +5084,31 @@ interface ChartWidgetOptions extends MarkPainterHooks {
     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 browser keeps its own.
+     *
+     *  A built-in left out is not one this chart adds. The indicator browser does not list it: not
+     *  among the built-ins, not among the favorites (a starred one keeps its star in storage), not in
+     *  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 studies 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 +5122,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>>;
@@ -4960,6 +5317,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, rail 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 browser 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. */
@@ -5393,58 +5759,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 +5774,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 +5795,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 +5826,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 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 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, 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 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, 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, 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, subIntervalsFor, subsessionBarFilter, symbolNames, tfSeconds, tfToUdfResolution, tickBandFor, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };