@trdrs/quickcharts 5.4.0 → 5.6.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 5.6.0
+
+The currency and unit box holds its words in a 24px row inside its outline, at the row's start, 3px in from each end on a radius of 3. With `scaleUnitMenu` the row ends in a 7 by 5 caret and lights under the pointer, and `ScaleUnitMenuRequest.expanded(open)` lets the host say its menu stands open, which keeps the row lit and turns the caret up. The auto-scale and logarithmic buttons stand 4px apart, the pair centred on the scale.
+
+## 5.5.0
+
+The indicator picker's rail offers Favorites only while something is starred, and keeps it while it is open. The author and count columns stand only while a listed row fills them, so a list of starred built-ins reads as stars and names. Items a host answers for the `builtin` collection list in Technicals after the shipped definitions, under the host's own kinds. `IndicatorPickerCollection.empty` gives a collection an empty state: a title, text, a mark drawn 120px square from the 28-unit glyph grid, and one action that reaches `act` with a `collection` target. `IndicatorPickerEmpty` is exported. `chart.indicators.open` takes a `kind` beside `collection` and opens with that kind's filter pressed.
+
 ## 5.4.0
 
 What is drawn over the canvas reads its ink from the canvas's lightness. Over a canvas of the other mode's lightness, such as a white canvas in dark mode, the legend, the scales' boxes and buttons, the pane and navigation buttons and the corner mark wear that mode's built-in colors, and the factory scale text and lines, grid and watermark are that mode's, so they read dark on a light canvas and light on a dark one. A color the host or the viewer named stays theirs.

package/README.md

@@ -1603,20 +1603,26 @@ part in each through `contributeCapture` (see Extensions).
 ### Indicator picker content
 
 The Indicators button and `commands.execute('chart.indicators.open')` open the same picker.
-Pass `{ collection: 'saved' }` as the command argument to open a declared host collection directly.
+Pass `{ collection: 'saved' }` as the command argument to open a declared host collection directly,
+and `kind` beside it (`{ collection: 'builtin', kind: 'template' }`) to open with that kind's filter
+pressed; a kind neither the chart's `indicator` nor one your source declares leaves every kind listed.
 An unknown collection falls back to the shipped catalog. Reopening an already open picker keeps its current selection and query.
 The picker opens on the same search field as the symbol search. Beside its list stands a rail of
-collections: Favorites under Personal, and the 23 shipped definitions as Technicals under Built-in.
-Pressing a definition's row adds a new instance to the currently active chart and keeps the picker
-open. Favorites use your `ChartStorage` port. The list reads as a table of each row's star, name,
-author, favorite count and actions; the shipped catalog shows the star, the name and the actions.
-Escape and a press outside the box close the picker.
+collections: Favorites under Personal while anything is starred, and the 23 shipped definitions as
+Technicals under Built-in. Favorites stays in the rail while it is open, so unstarring the last row
+there leaves the trader where they are. Pressing a definition's row adds a new instance to the
+currently active chart and keeps the picker open. Favorites use your `ChartStorage` port. The list
+reads as a table of each row's star, name, author, favorite count and actions; the author and count
+columns stand only while a listed row fills them, so the shipped catalog shows the star, the name
+and the actions. Escape and a press outside the box close the picker.
 
 Supply `ChartWidgetOptions.indicatorPicker` to include additional localized collections and rows
 in that picker. You supply data and opaque actions, not DOM, indicator definitions, or a renderer.
 Built-in annotations can add favorite state, counts and actions; they cannot replace a definition,
-its name, or Add, and their counts show wherever the list is a table (Favorites, and your table
-collections). Without a source, the picker has only shipped built-ins and Favorites.
+its name, or Add, and their counts show wherever the list is a table. Items you answer for the
+`builtin` collection list in Technicals after the shipped definitions, so a kind of your own (see
+`kinds` below) can stand beside the chart's indicators there. Without a source, the picker has only
+shipped built-ins and Favorites.
 
 ```ts
 import type { IndicatorPickerSource } from '@trdrs/quickcharts'
@@ -1679,6 +1685,23 @@ const withTemplates: IndicatorPickerSource = {
 }
 ```
 
+A collection can carry an `empty` state for the list to show while it lists nothing and no search
+is typed: a `title`, optional `text`, an optional `icon` drawn 120px square from the same 28-unit
+grid as every contributed glyph, and an optional `action`, a button whose press reaches `act` with
+the target `{ kind: 'collection', id }`. The kind filters step aside while it shows. Without one, an
+empty collection reads the chart's own no-matches line.
+
+```ts
+import type { IndicatorPickerCollection } from '@trdrs/quickcharts'
+
+const scripts: IndicatorPickerCollection = {
+  id: 'scripts',
+  label: 'My scripts',
+  layout: 'list',
+  empty: { title: 'No scripts yet', text: 'Write one and it lists here.', action: { id: 'create', label: 'Create script' } },
+}
+```
+
 A favorite action receives the requested next boolean. Successful actions refresh the current
 collection unless they return `close: true`. Refusals and exceptions keep the picker open with
 plain text, never rendered markup. Icons reuse `ChartExtensionIcon`; invalid icons draw no glyph.
@@ -2439,7 +2462,9 @@ the same in both modes, in `CHART_FACTORY_COLORS`. The sections and what stands
   `scaleUnitMenu` option the box is a button titled with the setting's name: a press hands your
   handler a `ScaleUnitMenuRequest` (the chart, the box's place in viewport pixels, and whether the
   keyboard pressed it) so your own currency and unit menu opens against it, and the box stays
-  while the pointer rests on it. Without the option the box is a label that takes no pointer, so
+  while the pointer rests on it. Call the request's `expanded(true)` as your menu opens and
+  `expanded(false)` as it closes: while it stands open the box stays lit and the caret at the end
+  of its row points up. Without the option the box is a label that takes no pointer, so
   the scale under it still drags. The price-to-bar
   ratio lock (`lockPriceToBarRatio`) holds the price one bar's width spans: engaging it with no
   `priceToBarRatio` of its own takes the ratio on screen into that leaf, the scale stops framing

package/dist/feature-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.4.0",
+  "version": "5.6.0",
   "styles": [
     {
       "id": "candles",

package/dist/index.d.ts

@@ -3689,6 +3689,19 @@ interface IndicatorPickerCollection {
     group?: string;
     /** Catalog columns by default; a personal list can omit author and favorite columns. */
     layout?: 'table' | 'list';
+    /** What the list shows while the collection lists no row and no search is typed. Omitted, it
+     *  reads the chart's own no-matches line. */
+    empty?: IndicatorPickerEmpty;
+}
+/** A collection's empty state, centred where its list stands: a mark, a title, a line of text and
+ *  one action, which the source's `act` runs with a `collection` target. */
+interface IndicatorPickerEmpty {
+    title: string;
+    text?: string;
+    /** Drawn 120px square from the same 28-unit grid as every contributed glyph. */
+    icon?: ChartExtensionIcon;
+    /** The empty state's one button. `add` and `favorite` belong to the chart. */
+    action?: IndicatorPickerAction;
 }
 /** A kind of row a host lists beside the chart's indicators. The picker offers each declared kind as
  *  a filter under its search field, after All and the chart's own Indicators. */
@@ -3737,7 +3750,8 @@ interface IndicatorPickerSource {
     kinds?: readonly IndicatorPickerKind[];
     /** 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. */
+     *  offers. Items answered for `builtin` list after the shipped definitions, and items answered
+     *  for `favorites` list there when starred. */
     list(request: {
         collection: string;
         query: string;
@@ -3750,11 +3764,12 @@ interface IndicatorPickerSource {
         kind: 'unavailable';
         message: string;
     }>;
-    /** `favorite` carries the requested next value. Closing aborts pending work; hosts must also
-     *  check the signal before performing late UI effects. Add is never routed here. */
+    /** `favorite` carries the requested next value. A `collection` target is the empty state's action
+     *  in the collection of that id. Closing aborts pending work; hosts must also check the signal
+     *  before performing late UI effects. Add is never routed here. */
     act(request: {
         target: {
-            kind: 'builtin' | 'item';
+            kind: 'builtin' | 'item' | 'collection';
             id: string;
         };
         action: string;
@@ -5593,6 +5608,9 @@ interface ScaleUnitMenuRequest {
     };
     /** Whether the box was pressed from the keyboard, so the menu takes the focus. */
     readonly keyboard: boolean;
+    /** Say whether the menu stands open: `true` as it opens and `false` as it closes. While it is open
+     *  the box stays lit and its caret points up. */
+    expanded(open: boolean): void;
 }
 /** Everything needed to construct a widget. `container` and `datafeed` are the two hard
  *  requirements; every other field has a working default. */
@@ -6612,4 +6630,4 @@ declare function mountTimeframePicker(options: TimeframePickerOptions & {
     container: HTMLElement;
 }): MountedTimeframePicker;
 
-export { ARRANGEMENTS, type AccessPolicy, type ActiveSubsession, type Arrangement, type AttachDrawingsOptions, BRAND_DOWN, BRAND_UP, BUILT_IN_INDICATORS, BUILT_IN_LOCALES, type BuiltInIndicator, CHART_DATE_FORMATS, CHART_FACTORY_COLORS, CHART_ICON_IDS, CHART_SETTINGS_SECTIONS, CHART_STYLES, COLLAPSED_H, COMPARE_COLORS, type CandleStyleSettings, type CanvasTheme, type Capabilities, type ChartBackgroundType, ChartBody, type ChartChrome, type ChartCompareApi, type ChartControlVisibility, type ChartCustomLocale, ChartDatafeed, type ChartDateFormat, type ChartDictionary, type ChartDrawingsApi, type ChartEvents, type ChartExtension, type ChartExtensionCapture, type ChartExtensionCaptureFrame, type ChartExtensionChart, type ChartExtensionCommand, type ChartExtensionContext, type ChartExtensionHandle, type ChartExtensionIcon, type ChartExtensionIconPath, type ChartExtensionLegendRow, type ChartExtensionMenuBuilder, type ChartExtensionMenuContext, type ChartExtensionMenuItem, type ChartExtensionPane, type ChartExtensionPriceLine, type ChartExtensionReplayState, type ChartExtensionScope, type ChartExtensionSeries, type ChartFactoryColors, type ChartHandle, type ChartHistoryApi, type ChartHoursFormat, type ChartI18n, type ChartI18nOptions, type ChartIconArtwork, type ChartIconContext, type ChartIconDiagnostic, type ChartIconFactory, type ChartIconFailure, type ChartIconId, type ChartIcons, type ChartLastValueMode, type ChartLegendRow, type ChartLineColorType, type ChartLocale, type ChartLocaleCode, type ChartMenuAction, type ChartMenuContext, type ChartMenuIcon, type ChartMenuRow, ChartMessageKey, ChartMeta, type ChartPaneSyncApi, type ChartPreferences, type ChartPriceFormatter, type ChartPricePrecision, type ChartPriceSource, type ChartReplayApi, ChartSaveLoadAdapter, type ChartSaveLoadApi, type ChartScalePlacement, type ChartSessionHours, type ChartSettings, type ChartSettingsContribution, type ChartSettingsControls, type ChartSettingsForm, type ChartSettingsIconPainter, type ChartSettingsOption, type ChartSettingsPageId, type ChartSettingsRowHandle, type ChartSettingsSection, type ChartSettingsTip, type ChartStorage, type ChartStrokeStyle, type ChartStyleId, type ChartTimezone, type ChartTitleSource, type ChartTranslate, type ChartWidget, type ChartWidgetOptions, type CommandRegistry, type CommandResult, type CommandScope, type CommandSpec, type CompareDeps, type CompareEntry, type CompareHandle, type ComparePlacement, type CompareSnapshot, type CompareSymbol, type ContextMenuHandle, type CrosshairUi, type CustomThemes, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, DataStatus, DatafeedSearchOptions, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, type DrawingInks, type DrawingOwner, DrawingPreferences, type DrawingPresets, type DrawingReadOutcome, type DrawingRejection, type DrawingRejectionReason, DrawingResourceContext, DrawingsBody, type DrawingsEvents, type DrawingsHandle, DrawingsMeta, type DrawingsWorkflow, EXCHANGE_TIMEZONE, type FeatureConfig, FeedBar, type FetchLike, FillBetweenPrimitive, type FullscreenApi, type FullscreenOptions, type HistoryChange, type HistoryEventState, IMAGE_HEADER_H, type ImageApi, type ImageEvent, type ImageHeader, type ImageOptions, type ImageTextRun, type ImageTile, type IndicatorCategory, type IndicatorDefinition, type IndicatorEvent, type IndicatorFill, type IndicatorInstance, type IndicatorLevel, type IndicatorManifest, type IndicatorOverrides, type IndicatorPickerAction, type IndicatorPickerBuiltInState, type IndicatorPickerCollection, type IndicatorPickerItem, type IndicatorPickerKind, type IndicatorPickerSource, type IndicatorPlot, type IndicatorPlots, type IndicatorsApi, type IndicatorsRenderer, LAYOUT_MENU_ROWS, type LayoutApi, LayoutBody, type LayoutEvent, LayoutMeta, type LayoutOptions, type LayoutSaveLoadApi, type LayoutSyncFlags, type LegendUi, type LineStyleSettings, type LogicalRange, MAIN_MIN_H, MIN_BAR_SPACING, MIRRORED_ICONS, type ManifestFill, type ManifestInput, type ManifestLevel, type ManifestPlot, type ManifestRun, MarkIconId, type MarkPainters, type MarketStatus, type MatchSegment, type MountedSymbolSearch, type MountedTimeframePicker, type OpenResource, PRICE_SCALE_MODE, type PaneOp, type PanePlan, type PaneRect, type PaneState, type PartialChartSettings, type PlacedImage, type PlotArea, type PlotPoint, PriceFormat, PriceFormatter, RANGE_PRESETS, RECENT_SYMBOLS_CAP, REPLAY_SPEEDS, type RangeFrameTarget, type RangePreset, type RangeSpan, type ReadChartSettings, type RecentsPort, type ReplayEventState, type ReplaySpeed, type ResourceLoadOutcome, ResourceRef, type ResourceRemoveOutcome, type ResourceSaveOutcome, ResourceStore, SCALE_MODES, SCALE_MODE_OPTIONS, SCROLL_STEP_BARS, SESSION_DOT, SESSION_LABEL, SESSION_STATE_TITLE, SPREAD_OPERATORS, type SaveConflictInfo, type ScaleMode, type ScaleUnitMenuRequest, type SearchClassFilter, SearchClassNode, type SearchController, type SearchControllerOptions, type SearchDisplayOptions, SearchPage, type SearchScope, type SearchState, type SelectedDrawing, type SemanticTheme, type SessionBandsPrimitive, type SessionLook, type SessionModel, type SessionSchedule, type SessionSegment, type SessionSource, type SessionState, type SessionTimeline, type SettingsMenuUi, ShadePrimitive, type SpreadOperator, type SpreadOperatorId, type SubsessionSource, SymbolInfo, type SymbolMarkPainter, type SymbolPriceFormat, SymbolRow, type SymbolSearchCache, type SymbolSearchHandle, type SymbolSearchOptions, THEME_ROLES, TIMEFRAME_MAX, TIMEFRAME_PRESETS, TIMEFRAME_PRESET_TOKENS, TIMEFRAME_UNITS, TIMEFRAME_UNIT_NAME, TIMEFRAME_UNIT_SECONDS, TIMEZONES, TOP_BAR_SLOTS, TemplateBody, TemplateMeta, TextDraft, TextEditFrame, type TextEditSession, type TextInlineEdit, type ThemeChangeListener, type ThemeController, type ThemeControllerOptions, type ThemeDeclaration, type ThemeDiagnostic, type ThemeDiagnosticCode, type ThemeMode, type ThemeOptions, type ThemeRole, type ThemeRoleFamily, type ThemeRoleId, type ThemeRoleKind, type ThemeRootStyle, type TimeLabelFormat, type TimeRange, type Timeframe, type TimeframeGroup, type TimeframePickerHandle, type TimeframePickerOptions, type TimeframeRestrictions, type TimeframeUnit, type TimezoneRow, type ToolbarButton, type ToolbarButtonOptions, type ToolbarButtonState, type TopBarSlot, type TopBarUi, type TouchOptions, type TransitionOptions, type UdfDatafeedOptions, type UdfSymbolResponse, type UiConfig, type VenueMarkPainter, type WidgetEvents, ZOOM_FACTOR, type ZoneClock, allowedTimeframes, applyBar, applyPlotOverrides, arrangementName, arrangementOf, attachCompare, attachDrawings, attachIndicators, autoTimeframeFor, buildManifestPlots, canvasTheme, canvasToBlob, chartContextMenu, chartDateSample, chartDictionaries, chartIconArtwork, chartSettingsDefaults, clipToWindow, coerceChartStyle, coerceScaleMode, compareTimeframes, composeFormingBar, composeImage, createChart, createChartI18n, createSearchController, createSessionBands, createSymbolSearchCache, createThemeController, createUdfDatafeed, effectivePlotColor, exchangeTimezoneText, formatChartDate, formatClock, formatDuration, formatTimeframe, frameRange, hasExtendedHours, imageFileName, imageHeaderRuns, imageLayoutHeaderRuns, imageTileRuns, indicatorHidden, isChartStyle, isCollapsed, isIntradayTimeframe, isSymbolPair, isTimezoneChoice, latestPlotValue, layerChartSettings, looksLikeSpread, makeCrosshairTimeFormatter, makeTickMarkFormatter, manifestInputDefaults, marketStatus, marketStatusFor, marketStatusText, marketStatusTitle, matchSegments, memoryChartStorage, memoryRecents, mountContextMenu, mountSymbolSearch, mountTimeframePicker, nextSessionChange, openInputsEditor, openSymbolSearch, openTimeframePicker, overriddenManifest, parseSessionModel, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, readPartialChartSettings, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionBreakTimes, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subTimeframesFor, subsessionBarFilter, tfSeconds, tfToUdfResolution, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };
+export { ARRANGEMENTS, type AccessPolicy, type ActiveSubsession, type Arrangement, type AttachDrawingsOptions, BRAND_DOWN, BRAND_UP, BUILT_IN_INDICATORS, BUILT_IN_LOCALES, type BuiltInIndicator, CHART_DATE_FORMATS, CHART_FACTORY_COLORS, CHART_ICON_IDS, CHART_SETTINGS_SECTIONS, CHART_STYLES, COLLAPSED_H, COMPARE_COLORS, type CandleStyleSettings, type CanvasTheme, type Capabilities, type ChartBackgroundType, ChartBody, type ChartChrome, type ChartCompareApi, type ChartControlVisibility, type ChartCustomLocale, ChartDatafeed, type ChartDateFormat, type ChartDictionary, type ChartDrawingsApi, type ChartEvents, type ChartExtension, type ChartExtensionCapture, type ChartExtensionCaptureFrame, type ChartExtensionChart, type ChartExtensionCommand, type ChartExtensionContext, type ChartExtensionHandle, type ChartExtensionIcon, type ChartExtensionIconPath, type ChartExtensionLegendRow, type ChartExtensionMenuBuilder, type ChartExtensionMenuContext, type ChartExtensionMenuItem, type ChartExtensionPane, type ChartExtensionPriceLine, type ChartExtensionReplayState, type ChartExtensionScope, type ChartExtensionSeries, type ChartFactoryColors, type ChartHandle, type ChartHistoryApi, type ChartHoursFormat, type ChartI18n, type ChartI18nOptions, type ChartIconArtwork, type ChartIconContext, type ChartIconDiagnostic, type ChartIconFactory, type ChartIconFailure, type ChartIconId, type ChartIcons, type ChartLastValueMode, type ChartLegendRow, type ChartLineColorType, type ChartLocale, type ChartLocaleCode, type ChartMenuAction, type ChartMenuContext, type ChartMenuIcon, type ChartMenuRow, ChartMessageKey, ChartMeta, type ChartPaneSyncApi, type ChartPreferences, type ChartPriceFormatter, type ChartPricePrecision, type ChartPriceSource, type ChartReplayApi, ChartSaveLoadAdapter, type ChartSaveLoadApi, type ChartScalePlacement, type ChartSessionHours, type ChartSettings, type ChartSettingsContribution, type ChartSettingsControls, type ChartSettingsForm, type ChartSettingsIconPainter, type ChartSettingsOption, type ChartSettingsPageId, type ChartSettingsRowHandle, type ChartSettingsSection, type ChartSettingsTip, type ChartStorage, type ChartStrokeStyle, type ChartStyleId, type ChartTimezone, type ChartTitleSource, type ChartTranslate, type ChartWidget, type ChartWidgetOptions, type CommandRegistry, type CommandResult, type CommandScope, type CommandSpec, type CompareDeps, type CompareEntry, type CompareHandle, type ComparePlacement, type CompareSnapshot, type CompareSymbol, type ContextMenuHandle, type CrosshairUi, type CustomThemes, DEFAULT_SUBSESSION, DEFAULT_TIMEZONE, type DataSourceMarkPainter, DataStatus, DatafeedSearchOptions, type DrawingApplyOutcome, DrawingAssetPort, DrawingContextKind, type DrawingDocumentApi, type DrawingDocumentPort, type DrawingDocumentRefusal, type DrawingEvent, type DrawingInks, type DrawingOwner, DrawingPreferences, type DrawingPresets, type DrawingReadOutcome, type DrawingRejection, type DrawingRejectionReason, DrawingResourceContext, DrawingsBody, type DrawingsEvents, type DrawingsHandle, DrawingsMeta, type DrawingsWorkflow, EXCHANGE_TIMEZONE, type FeatureConfig, FeedBar, type FetchLike, FillBetweenPrimitive, type FullscreenApi, type FullscreenOptions, type HistoryChange, type HistoryEventState, IMAGE_HEADER_H, type ImageApi, type ImageEvent, type ImageHeader, type ImageOptions, type ImageTextRun, type ImageTile, type IndicatorCategory, type IndicatorDefinition, type IndicatorEvent, type IndicatorFill, type IndicatorInstance, type IndicatorLevel, type IndicatorManifest, type IndicatorOverrides, type IndicatorPickerAction, type IndicatorPickerBuiltInState, type IndicatorPickerCollection, type IndicatorPickerEmpty, type IndicatorPickerItem, type IndicatorPickerKind, type IndicatorPickerSource, type IndicatorPlot, type IndicatorPlots, type IndicatorsApi, type IndicatorsRenderer, LAYOUT_MENU_ROWS, type LayoutApi, LayoutBody, type LayoutEvent, LayoutMeta, type LayoutOptions, type LayoutSaveLoadApi, type LayoutSyncFlags, type LegendUi, type LineStyleSettings, type LogicalRange, MAIN_MIN_H, MIN_BAR_SPACING, MIRRORED_ICONS, type ManifestFill, type ManifestInput, type ManifestLevel, type ManifestPlot, type ManifestRun, MarkIconId, type MarkPainters, type MarketStatus, type MatchSegment, type MountedSymbolSearch, type MountedTimeframePicker, type OpenResource, PRICE_SCALE_MODE, type PaneOp, type PanePlan, type PaneRect, type PaneState, type PartialChartSettings, type PlacedImage, type PlotArea, type PlotPoint, PriceFormat, PriceFormatter, RANGE_PRESETS, RECENT_SYMBOLS_CAP, REPLAY_SPEEDS, type RangeFrameTarget, type RangePreset, type RangeSpan, type ReadChartSettings, type RecentsPort, type ReplayEventState, type ReplaySpeed, type ResourceLoadOutcome, ResourceRef, type ResourceRemoveOutcome, type ResourceSaveOutcome, ResourceStore, SCALE_MODES, SCALE_MODE_OPTIONS, SCROLL_STEP_BARS, SESSION_DOT, SESSION_LABEL, SESSION_STATE_TITLE, SPREAD_OPERATORS, type SaveConflictInfo, type ScaleMode, type ScaleUnitMenuRequest, type SearchClassFilter, SearchClassNode, type SearchController, type SearchControllerOptions, type SearchDisplayOptions, SearchPage, type SearchScope, type SearchState, type SelectedDrawing, type SemanticTheme, type SessionBandsPrimitive, type SessionLook, type SessionModel, type SessionSchedule, type SessionSegment, type SessionSource, type SessionState, type SessionTimeline, type SettingsMenuUi, ShadePrimitive, type SpreadOperator, type SpreadOperatorId, type SubsessionSource, SymbolInfo, type SymbolMarkPainter, type SymbolPriceFormat, SymbolRow, type SymbolSearchCache, type SymbolSearchHandle, type SymbolSearchOptions, THEME_ROLES, TIMEFRAME_MAX, TIMEFRAME_PRESETS, TIMEFRAME_PRESET_TOKENS, TIMEFRAME_UNITS, TIMEFRAME_UNIT_NAME, TIMEFRAME_UNIT_SECONDS, TIMEZONES, TOP_BAR_SLOTS, TemplateBody, TemplateMeta, TextDraft, TextEditFrame, type TextEditSession, type TextInlineEdit, type ThemeChangeListener, type ThemeController, type ThemeControllerOptions, type ThemeDeclaration, type ThemeDiagnostic, type ThemeDiagnosticCode, type ThemeMode, type ThemeOptions, type ThemeRole, type ThemeRoleFamily, type ThemeRoleId, type ThemeRoleKind, type ThemeRootStyle, type TimeLabelFormat, type TimeRange, type Timeframe, type TimeframeGroup, type TimeframePickerHandle, type TimeframePickerOptions, type TimeframeRestrictions, type TimeframeUnit, type TimezoneRow, type ToolbarButton, type ToolbarButtonOptions, type ToolbarButtonState, type TopBarSlot, type TopBarUi, type TouchOptions, type TransitionOptions, type UdfDatafeedOptions, type UdfSymbolResponse, type UiConfig, type VenueMarkPainter, type WidgetEvents, ZOOM_FACTOR, type ZoneClock, allowedTimeframes, applyBar, applyPlotOverrides, arrangementName, arrangementOf, attachCompare, attachDrawings, attachIndicators, autoTimeframeFor, buildManifestPlots, canvasTheme, canvasToBlob, chartContextMenu, chartDateSample, chartDictionaries, chartIconArtwork, chartSettingsDefaults, clipToWindow, coerceChartStyle, coerceScaleMode, compareTimeframes, composeFormingBar, composeImage, createChart, createChartI18n, createSearchController, createSessionBands, createSymbolSearchCache, createThemeController, createUdfDatafeed, effectivePlotColor, exchangeTimezoneText, formatChartDate, formatClock, formatDuration, formatTimeframe, frameRange, hasExtendedHours, imageFileName, imageHeaderRuns, imageLayoutHeaderRuns, imageTileRuns, indicatorHidden, isChartStyle, isCollapsed, isIntradayTimeframe, isSymbolPair, isTimezoneChoice, latestPlotValue, layerChartSettings, looksLikeSpread, makeCrosshairTimeFormatter, makeTickMarkFormatter, manifestInputDefaults, marketStatus, marketStatusFor, marketStatusText, marketStatusTitle, matchSegments, memoryChartStorage, memoryRecents, mountContextMenu, mountSymbolSearch, mountTimeframePicker, nextSessionChange, openInputsEditor, openSymbolSearch, openTimeframePicker, overriddenManifest, parseSessionModel, parseTimeframe, pickCompareColor, placeableByWidget, planPaneOp, promoteRecent, rangeAvailable, rangePresetTip, rangeSpanSeconds, readPartialChartSettings, resolveDisplayTimezone, resolveInitialTf, scrolledPosition, seriesTargetOf, sessionBreakTimes, sessionStateAt, sessionTimeline, spreadExpression, spreadSearchQuery, subTimeframesFor, subsessionBarFilter, tfSeconds, tfToUdfResolution, timeframeAllowed, timeframeGroupUnit, timeframeLabel, timeframeOrder, timeframeSeconds, timezoneCity, timezoneLabel, timezoneListing, toolName, tzOffsetLabel, tzOffsetMinutes, udfPriceFormat, udfResolutionToTf, udfSymbolInfo, valueShaped, withFoldedHistory, zoneClock, zoomedBarSpacing };

package/dist/index.js

@@ -8299,15 +8299,15 @@ var drawable = (shape) => {
   if (rule !== void 0 && rule !== "nonzero" && rule !== "evenodd") return false;
   return width === void 0 || Number.isFinite(width) && width > 0 && width <= GLYPH_LIMITS.strokeWidth;
 };
-function buildGlyph(icon) {
+function buildGlyph(icon, size = GRID) {
   try {
     const paths = icon && Array.isArray(icon.paths) ? icon.paths : [];
     if (paths.length === 0 || paths.length > GLYPH_LIMITS.shapes) return null;
     const shapes = paths.filter(drawable);
     if (shapes.length === 0) return null;
     const root = document.createElementNS(SVG_NS, "svg");
-    set(root, GLYPH_ATTRIBUTES.svg, "width", String(GRID));
-    set(root, GLYPH_ATTRIBUTES.svg, "height", String(GRID));
+    set(root, GLYPH_ATTRIBUTES.svg, "width", String(size));
+    set(root, GLYPH_ATTRIBUTES.svg, "height", String(size));
     set(root, GLYPH_ATTRIBUTES.svg, "viewBox", `0 0 ${GRID} ${GRID}`);
     set(root, GLYPH_ATTRIBUTES.svg, "fill", "none");
     set(root, GLYPH_ATTRIBUTES.svg, "aria-hidden", "true");
@@ -10205,6 +10205,9 @@ var ICONS = {
   /** The pickers' wide caret, on its native 16 by 8 grid: the trigger arrow, which
    *  renders half size beside a picker's text. */
   menuArrowWide: { viewBox: "0 0 16 8", body: solid(polyline([[0.6, 0.7], [8, 7], [15.4, 0.7]], 1.8)) },
+  /** The currency and unit box's caret, on its native 7 by 5 grid: a 1.2 stroke bent down at its
+   *  middle, drawn at its own size after the box's words. */
+  scaleUnitArrow: { viewBox: "0 0 7 5", body: '<path d="M1 1.5l2.5 2 2.5-2" stroke="currentColor" stroke-width="1.2"/>' },
   // Hairline weight: these two sit beside a label rather than alone in a 38px cell. A tray taking an
   // arrow, and two sheets, the back one broken where the front lies over it.
   download: { viewBox: "0 0 28 28", body: solid(bend([[6.5, 17], [6.5, 22.5], [22.5, 22.5], [22.5, 17]], 1) + line2([14.5, 6], [14.5, 18]) + polyline([[10.5, 14.5], [14.5, 18.5], [18.5, 14.5]])) },
@@ -18195,7 +18198,7 @@ var CONTROL_ICONS = byMeaning({
   image: [ICONS.camera],
   download: [ICONS.download],
   copy: [ICONS.copy],
-  caret: [ICONS.menuArrowWide],
+  caret: [ICONS.menuArrowWide, ICONS.scaleUnitArrow],
   info: [ICONS.info],
   // The legend.
   visible: [ICONS.legendEye],
@@ -20435,7 +20438,7 @@ function mountNavControls(deps) {
 }
 
 // src/ui/chrome/scaleControls.ts
-var BUTTON = { width: 20, height: 22, gap: 15, foot: 4 };
+var BUTTON = { width: 20, height: 22, gap: 4, foot: 4 };
 var UNIT_BOX = { inset: 4 };
 function mountScaleControls(deps) {
   const t = deps.i18n.t;
@@ -20445,12 +20448,15 @@ function mountScaleControls(deps) {
   modes.append(auto, log);
   stopPointer(modes);
   const door = deps.openUnitMenu;
-  const unit = door ? h("button", { type: "button", class: "qc-scale-unit", "data-role": "scale-unit" }) : h("div", { class: "qc-scale-unit", "data-role": "scale-unit" });
+  const unit = door ? h("button", { type: "button", class: "qc-scale-unit", "data-role": "scale-unit", "aria-haspopup": "menu", "aria-expanded": "false" }) : h("div", { class: "qc-scale-unit", "data-role": "scale-unit" });
+  const unitText = h("span", {});
+  unit.append(h("span", { class: "qc-scale-unit-row" }, unitText, door ? deps.icons.glyph(ICONS.scaleUnitArrow, { size: 7, height: 5, className: "qc-scale-unit-arrow" }) : null));
   if (door) {
     stopPointer(unit);
+    const expanded = (open2) => unit.setAttribute("aria-expanded", String(open2 === true));
     unit.addEventListener("click", (event) => {
       const box2 = unit.getBoundingClientRect();
-      door({ left: box2.left, top: box2.top, right: box2.right, bottom: box2.bottom }, event.detail === 0);
+      door({ left: box2.left, top: box2.top, right: box2.right, bottom: box2.bottom }, event.detail === 0, expanded);
     });
   }
   deps.chrome.appendChild(unit);
@@ -20569,7 +20575,7 @@ function mountScaleControls(deps) {
     const currency = named2?.currency?.trim() ?? "";
     const unitId = named2?.unit?.trim() ?? "";
     const text2 = currency && unitId ? t("chrome.currencyAndUnit", { currency, unit: unitId }) : currency || unitId;
-    unit.textContent = text2;
+    unitText.textContent = text2;
     unit.dataset.qcVisibility = visibility;
     unit.hidden = text2 === "" || visibility === "never" || visibility === "hover" && !overScale && !overControls;
     unit.style.top = `${Math.round(box2.top + UNIT_BOX.inset)}px`;
@@ -21072,7 +21078,13 @@ function registerChartCommands(deps) {
     scope: "chart",
     label: "chrome.indicators",
     available: () => ui.indicatorPicker,
-    execute: (arg) => deps.indicatorsOpen(arg && typeof arg === "object" && "collection" in arg && typeof arg.collection === "string" ? arg.collection : void 0)
+    execute: (arg) => {
+      const field = (key) => {
+        const value = arg && typeof arg === "object" ? arg[key] : void 0;
+        return typeof value === "string" ? value : void 0;
+      };
+      return deps.indicatorsOpen(field("collection"), field("kind"));
+    }
   });
   const isInstance = (arg) => !!arg && typeof arg === "object" && typeof arg.id === "string" && typeof arg.definition === "object";
   add({
@@ -22760,6 +22772,7 @@ function createChartInstance(deps) {
     chrome: chrome2,
     gestures,
     i18n,
+    icons: deps.icons,
     box: priceScaleBox,
     modeButtons: () => eff.priceScale.scaleModeButtons,
     unitBox: () => eff.priceScale.currencyAndUnit,
@@ -22776,7 +22789,7 @@ function createChartInstance(deps) {
     openPriceMenu: (anchor2, keyboard) => {
       menu2?.raisePriceMenu(anchor2, keyboard);
     },
-    ...deps.scaleUnitMenu ? { openUnitMenu: (anchor2, keyboard) => deps.scaleUnitMenu?.({ chart: handle, anchor: anchor2, keyboard }) } : {}
+    ...deps.scaleUnitMenu ? { openUnitMenu: (anchor2, keyboard, expanded) => deps.scaleUnitMenu?.({ chart: handle, anchor: anchor2, keyboard, expanded }) } : {}
   }) : null;
   scalePlus = scaleControls && menu2 ? attachScalePlus({
     chart,
@@ -23821,7 +23834,7 @@ function createChartInstance(deps) {
     crosshairLevel,
     formatter: () => symbolFormatter,
     compareOpen: (mode, changeFrom) => compare?.openDialog(mode, changeFrom),
-    indicatorsOpen: (collection) => deps.doors.showIndicatorPicker(collection),
+    indicatorsOpen: (collection, kind) => deps.doors.showIndicatorPicker(collection, kind),
     symbolSearchOpen: () => deps.doors.openSearch({ mode: "search", chart: handle }),
     drawingVerbs: () => drawings2.verbs
   });
@@ -25596,13 +25609,21 @@ function actions(value) {
   }
   return unique(result.map((a) => a.id)) ? result : null;
 }
+function emptyState2(value) {
+  if (!record2(value) || !text(value.title) || !optionalText(value.text)) return null;
+  const action = value.action === void 0 ? [] : actions([value.action]);
+  if (!action) return null;
+  return { title: value.title, ...value.text !== void 0 ? { text: value.text } : {}, ...value.icon !== void 0 ? { icon: value.icon } : {}, ...action[0] ? { action: action[0] } : {} };
+}
 function pickerCollections(value) {
   try {
     if (!Array.isArray(value)) return null;
     const result = [];
     for (const row2 of value) {
       if (!record2(row2) || !text(row2.id) || ["builtin", "favorites"].includes(row2.id) || !text(row2.label) || !optionalText(row2.group) || row2.layout !== void 0 && row2.layout !== "list" && row2.layout !== "table") return null;
-      result.push({ id: row2.id, label: row2.label, ...row2.icon !== void 0 ? { icon: row2.icon } : {}, ...row2.group !== void 0 ? { group: row2.group } : {}, ...row2.layout !== void 0 ? { layout: row2.layout } : {} });
+      const empty = row2.empty === void 0 ? void 0 : emptyState2(row2.empty);
+      if (empty === null) return null;
+      result.push({ id: row2.id, label: row2.label, ...row2.icon !== void 0 ? { icon: row2.icon } : {}, ...row2.group !== void 0 ? { group: row2.group } : {}, ...row2.layout !== void 0 ? { layout: row2.layout } : {}, ...empty ? { empty } : {} });
     }
     return unique(result.map((row2) => row2.id)) ? result : null;
   } catch {
@@ -25703,8 +25724,10 @@ function openIndicatorPicker(deps) {
   } catch {
   }
   let query = "";
-  let collection = deps.initialCollection === "favorites" || collections?.some((row2) => row2.id === deps.initialCollection) ? deps.initialCollection : "builtin";
-  let kind = null;
+  let hostStarred = false;
+  const starred = () => favorites.length > 0 || hostStarred;
+  let collection = deps.initialCollection === "favorites" && starred() || collections?.some((row2) => row2.id === deps.initialCollection) ? deps.initialCollection : "builtin";
+  let kind = deps.initialKind ?? null;
   let generation = 0;
   let controller = null;
   let busy = false;
@@ -25744,6 +25767,9 @@ function openIndicatorPicker(deps) {
       const strip = h("div", { class: "qc-search-classes" });
       const nav = h("nav", { class: "qc-picker-nav", "aria-label": t("picker.collections") });
       const list = h("div", { class: "qc-picker-list", role: "table", "aria-label": t("picker.title") });
+      const vacant = h("div", { class: "qc-picker-empty" });
+      vacant.hidden = true;
+      let railFavorites = false;
       const status2 = h("div", { class: "qc-picker-status qc-secondary", role: "status", "aria-live": "polite" });
       let pendingFocus = null;
       const actionButton = (label3, content, run, disabled = false, focusKey, className = "qc-picker-action") => {
@@ -25843,7 +25869,7 @@ function openIndicatorPicker(deps) {
         else if (focused && focused !== document.body) pendingFocus = null;
         const selected = (collections ?? []).find((row2) => row2.id === collection);
         list.classList.toggle("qc-picker-list--personal", selected?.layout === "list");
-        list.classList.toggle("qc-picker-list--catalog", collection === "builtin");
+        if (railFavorites !== (starred() || collection === "favorites")) renderNavigation();
         for (const button3 of nav.querySelectorAll("[data-picker-collection]")) button3.setAttribute("aria-pressed", String(button3.getAttribute("data-picker-collection") === collection));
         for (const chip of strip.querySelectorAll("[data-picker-kind]")) chip.setAttribute("aria-pressed", String((chip.getAttribute("data-picker-kind") || null) === kind));
         const headings = h("div", { role: "row", class: "qc-picker-headings" }, ...["", t("picker.name"), t("picker.author"), t("picker.favorites"), ""].map((label3) => h("span", { role: "columnheader" }, label3)));
@@ -25858,13 +25884,31 @@ function openIndicatorPicker(deps) {
             body.append(buildRow({ id: definition.id, kind: "builtin", title: t(definition.nameKey), description: t(definition.descriptionKey), favorite, count: metadata?.favoriteCount, hostedFavorite: metadata?.favorite !== void 0 || !!source3 && loading, actions: metadata?.actions ?? [], primary: () => add(definition), permitted: indicatorPermitted(deps.access, definition) && deps.commands.available("chart.indicators.add"), builtin: definition }));
           }
         }
-        if (collection !== "builtin") for (const item of rows2.items) {
+        for (const item of rows2.items) {
           if (collection === "favorites" && item.favorite !== true) continue;
           if (!admitted(item.kind ?? INDICATOR_KIND)) continue;
           const primary = item.actions.find((action) => action.id === item.primaryAction);
           body.append(buildRow({ id: item.id, kind: "item", title: item.title, description: item.description, author: item.author, favorite: item.favorite, count: item.favoriteCount, hostedFavorite: true, actions: item.actions, primary: () => void act({ kind: "item", id: item.id }, primary.id), permitted: !busy && !loading && !primary.disabled }));
         }
         replace(list, headings, body);
+        const filled = (cell2) => [...body.querySelectorAll(cell2)].some((node) => node.textContent !== "");
+        list.classList.toggle("qc-picker-list--authors", filled(".qc-picker-author"));
+        list.classList.toggle("qc-picker-list--counts", filled(".qc-picker-count"));
+        const empty = selected?.empty && !loading && available && query.trim() === "" && rows2.items.length === 0 ? selected.empty : null;
+        list.hidden = !!empty;
+        vacant.hidden = !empty;
+        strip.hidden = (kinds ?? []).length === 0 || !!empty;
+        if (empty) {
+          const action = empty.action;
+          const mark = buildGlyph(empty.icon, 120);
+          replace(
+            vacant,
+            mark ? h("span", { class: "qc-picker-empty-mark", "aria-hidden": "true" }, mark) : null,
+            h("strong", { class: "qc-picker-empty-title" }, empty.title),
+            empty.text ? h("p", { class: "qc-picker-empty-text" }, empty.text) : null,
+            action ? button2({ label: action.label, text: action.label, className: "qc-button--primary qc-drawing-footer-button qc-picker-empty-action", disabled: busy || action.disabled === true, onClick: () => void act({ kind: "collection", id: collection }, action.id) }) : null
+          );
+        } else replace(vacant);
         if (pendingFocus) {
           const target = [...list.querySelectorAll("[data-picker-focus]")].find((button3) => button3.dataset.pickerFocus === pendingFocus);
           if (target && !target.disabled) target.focus();
@@ -25873,7 +25917,7 @@ function openIndicatorPicker(deps) {
             input.focus();
           }
         }
-        status2.textContent = error || (loading ? t("picker.loading") : body.childElementCount === 0 ? t("picker.noMatches") : "");
+        status2.textContent = error || (loading ? t("picker.loading") : body.childElementCount === 0 && !empty ? t("picker.noMatches") : "");
         list.setAttribute("aria-busy", String(loading || busy));
       };
       const refresh = async () => {
@@ -25898,6 +25942,7 @@ function openIndicatorPicker(deps) {
           if (parsed) {
             rows2 = parsed;
             available = true;
+            hostStarred = parsed.builtIns.some((row2) => row2.favorite === true) || parsed.items.some((item) => item.favorite === true);
           } else error = result?.kind === "unavailable" && typeof result.message === "string" && result.message.trim() ? result.message : t("picker.unavailable");
         } catch {
           if (dialog.open() && revision === generation) error = t("picker.unavailable");
@@ -25915,8 +25960,9 @@ function openIndicatorPicker(deps) {
       };
       const renderNavigation = () => {
         replace(nav);
+        railFavorites = starred() || collection === "favorites";
         const personal = t("picker.personal");
-        const navigation = [{ id: "favorites", label: t("picker.favorites"), group: personal, icon: deps.icons.glyph(ICONS.pickerFavorites, { size: 28 }) }, ...(collections ?? []).map((row2) => ({ ...row2, icon: hostIcon(row2.icon) })), { id: "builtin", label: t("picker.technicals"), group: t("picker.builtin"), icon: deps.icons.glyph(ICONS.pickerTechnicals, { size: 28 }) }];
+        const navigation = [...railFavorites ? [{ id: "favorites", label: t("picker.favorites"), group: personal, icon: deps.icons.glyph(ICONS.pickerFavorites, { size: 28 }) }] : [], ...(collections ?? []).map((row2) => ({ ...row2, icon: hostIcon(row2.icon) })), { id: "builtin", label: t("picker.technicals"), group: t("picker.builtin"), icon: deps.icons.glyph(ICONS.pickerTechnicals, { size: 28 }) }];
         let section = null;
         let group;
         for (const item of navigation) {
@@ -25958,7 +26004,7 @@ function openIndicatorPicker(deps) {
           input.focus();
         } else if (roveFocus(list, event)) event.preventDefault();
       });
-      box2.append(searchField(deps.icons, input, clear), strip, h("div", { class: "qc-picker-body" }, nav, h("div", { class: "qc-picker-content" }, list, status2)));
+      box2.append(searchField(deps.icons, input, clear), strip, h("div", { class: "qc-picker-body" }, nav, h("div", { class: "qc-picker-content" }, list, vacant, status2)));
       renderKinds();
       renderNavigation();
       redraw = render;
@@ -30256,9 +30302,9 @@ function mountChrome(deps) {
   });
   deps.doors.notify = notify;
   let indicatorDialog = null;
-  deps.doors.showIndicatorPicker = (initialCollection) => {
+  deps.doors.showIndicatorPicker = (initialCollection, initialKind) => {
     if (!ui.indicatorPicker || indicatorDialog?.open()) return;
-    indicatorDialog = openIndicatorPicker({ ...ctx, storage: deps.storage, indicatorPicker: deps.indicatorPicker, initialCollection });
+    indicatorDialog = openIndicatorPicker({ ...ctx, storage: deps.storage, indicatorPicker: deps.indicatorPicker, initialCollection, initialKind });
   };
   disposers.push(() => {
     indicatorDialog?.close({ animate: false });