@coderyo/ui-shell 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -1,17 +1,36 @@
 import * as _coderyo_data from '@coderyo/data';
 import { Interval, SymbolSearchHit } from '@coderyo/data';
+import { Locale, I18nDictionary } from '@coderyo/i18n';
 import { IndicatorConfig } from '@coderyo/indicators';
 import * as _coderyo_drawings from '@coderyo/drawings';
 import { DrawingRecord } from '@coderyo/drawings';
 import { StreamLanguage } from '@codemirror/language';
 
+interface I18nProvider {
+    t(key: string, fallback?: string, params?: Record<string, string | number>): string;
+    getLocale(): Locale;
+    setLocale(locale: Locale): void;
+    registerLocale(locale: Locale, dictionary: I18nDictionary): void;
+    subscribe(listener: (locale: Locale) => void): () => void;
+}
+declare function createI18nProvider(defaultLocale?: Locale): I18nProvider;
+
+interface LogoSlotOptions {
+    label?: string;
+    href?: string;
+    imageSrc?: string;
+}
+declare function mountLogoSlot(parent: HTMLElement, opts?: LogoSlotOptions): HTMLElement;
+
 declare const GRID_SETTING_KEY = "tradview:settings:showGrid";
 declare const RETURN_CURSOR_KEY = "tradview:settings:returnToCursorAfterDraw";
 declare function loadShowGridPreference(): boolean;
 declare function saveShowGridPreference(show: boolean): void;
 declare function loadReturnToCursorPreference(): boolean;
 declare function saveReturnToCursorPreference(v: boolean): void;
+/** @deprecated Prefer `@coderyo/core` `loadIndicatorConfig(storage, …)` when not using ui-shell. */
 declare function loadIndicatorConfig(symbol: string, interval: string): IndicatorConfig;
+/** @deprecated Prefer `@coderyo/core` `saveIndicatorConfig(storage, …)` when not using ui-shell. */
 declare function saveIndicatorConfig(symbol: string, interval: string, config: IndicatorConfig): void;
 
 interface SettingsPanelOptions {
@@ -21,10 +40,25 @@ interface SettingsPanelOptions {
     onReturnToCursorChange?: (v: boolean) => void;
     indicatorConfig?: IndicatorConfig;
     onIndicatorConfigChange?: (config: IndicatorConfig) => void;
+    onClearAllIndicators?: () => void;
+    onClearAllDrawings?: () => void;
 }
 declare function mountSettingsPanel(parent: HTMLElement, opts?: SettingsPanelOptions): HTMLElement;
 
-type SymbolInputMode = 'manual' | 'search' | 'none';
+type ThemeId = 'dark' | 'light';
+declare const THEME_STORAGE_KEY = "tradview:theme";
+declare function loadTheme(): ThemeId;
+declare function saveTheme(theme: ThemeId): void;
+declare function applyThemeToDocument(theme: ThemeId, root?: HTMLElement): void;
+interface ThemeProvider {
+    getTheme(): ThemeId;
+    setTheme(theme: ThemeId): void;
+    toggle(): ThemeId;
+    subscribe(listener: (theme: ThemeId) => void): () => void;
+}
+declare function createThemeProvider(initial?: ThemeId): ThemeProvider;
+
+type SymbolInputMode = 'manual' | 'search' | 'dialog' | 'none';
 interface TopBarOptions {
     intervals?: Interval[];
     /** Highlighted interval button (defaults to first in `intervals`). */
@@ -34,6 +68,10 @@ interface TopBarOptions {
     onSymbolSelect?: (symbol: string) => void;
     onIntervalChange?: (interval: Interval) => void;
     onThemeToggle?: () => void;
+    onThemeChange?: (theme: 'dark' | 'light') => void;
+    themeProvider?: ThemeProvider;
+    i18n?: I18nProvider;
+    logo?: LogoSlotOptions | false;
     onFullscreen?: () => void;
     onScreenshot?: () => void;
     settings?: SettingsPanelOptions;
@@ -45,6 +83,31 @@ declare function mountTopBar(parent: HTMLElement, opts?: TopBarOptions): {
     setActiveInterval: (interval: Interval) => void;
 };
 
+interface ThemeToggleOptions {
+    themeProvider: ThemeProvider;
+    i18n?: I18nProvider;
+    onThemeChange?: (theme: ThemeId) => void;
+}
+declare function mountThemeToggle(parent: HTMLElement, opts: ThemeToggleOptions): HTMLButtonElement;
+
+interface SymbolSearchDialogOptions {
+    onSearch: (query: string) => Promise<SymbolSearchHit[]>;
+    onSelect: (symbol: string) => void;
+    initialSymbol?: string;
+    i18n?: I18nProvider;
+}
+interface SymbolSearchDialogHandle {
+    open(): void;
+    close(): void;
+    destroy(): void;
+}
+declare function createSymbolSearchDialog(opts: SymbolSearchDialogOptions): SymbolSearchDialogHandle;
+/** TopBar trigger: shows current symbol and opens the dialog. */
+declare function mountSymbolSearchDialogTrigger(parent: HTMLElement, dialog: SymbolSearchDialogHandle, opts: {
+    initialSymbol?: string;
+    i18n?: I18nProvider;
+}): HTMLElement;
+
 interface ContextMenuAction {
     id: string;
     label: string;
@@ -112,7 +175,7 @@ interface LayoutFeatures {
     showSettings?: boolean;
     showShortcuts?: boolean;
     /** When TopBar is on and no search API: manual symbol input (default). */
-    symbolInput?: 'manual' | 'search' | 'none';
+    symbolInput?: 'manual' | 'search' | 'dialog' | 'none';
 }
 interface ResolvedLayoutFeatures {
     showTopBar: boolean;
@@ -124,7 +187,7 @@ interface ResolvedLayoutFeatures {
     showContextMenu: boolean;
     showSettings: boolean;
     showShortcuts: boolean;
-    symbolInput: 'manual' | 'search' | 'none';
+    symbolInput: 'manual' | 'search' | 'dialog' | 'none';
 }
 declare const DEFAULT_LAYOUT_FEATURES: ResolvedLayoutFeatures;
 declare function resolveLayoutFeatures(opts?: ChartLayoutOptions): ResolvedLayoutFeatures;
@@ -134,6 +197,8 @@ declare function createDemoLayoutOptions(partial?: ChartLayoutOptions): ChartLay
 
 type DrawingToolId = 'cursor' | 'trendline' | 'hline' | 'vline' | 'rectangle' | 'fibonacci' | 'text';
 interface ChartLayoutOptions extends TopBarOptions {
+    themeProvider?: ThemeProvider;
+    i18n?: I18nProvider;
     showTopBar?: boolean;
     showLeftToolbar?: boolean;
     showBottomToolbar?: boolean;
@@ -148,7 +213,7 @@ interface ChartLayoutOptions extends TopBarOptions {
     showContextMenu?: boolean;
     showSettings?: boolean;
     showShortcuts?: boolean;
-    symbolInput?: 'manual' | 'search' | 'none';
+    symbolInput?: 'manual' | 'search' | 'dialog' | 'none';
     onDrawingStyleChange?: (patch: {
         color?: string;
         lineWidth?: number;
@@ -210,4 +275,4 @@ declare function mountPineEditorPanel(parent: HTMLElement, opts?: PineEditorPane
 
 declare const pineLanguage: StreamLanguage<{}>;
 
-export { type ChartLayoutOptions, type ContextMenuAction, type ContextMenuOptions, type CrosshairLegendOptions, DEFAULT_LAYOUT_FEATURES, type DrawingContextMenuHandlers, type DrawingPropertiesPanelOptions, type DrawingToolId, GRID_SETTING_KEY, type LayoutFeatures, type OhlcvSnapshot, PINE_SCRIPT_STORAGE_KEY, type PineEditorPanelOptions, RETURN_CURSOR_KEY, type ResolvedLayoutFeatures, type SettingsPanelOptions as SettingsMenuOptions, type SettingsPanelOptions, type StatusBarOptions, type SymbolInputMode, type SymbolSearchOptions, type TopBarOptions, attachChartContextMenu, bindShortcutsModal, createDemoLayoutOptions, loadIndicatorConfig, loadPineScriptPreference, loadReturnToCursorPreference, loadShowGridPreference, mergeLayoutFeatures, mountChartLayout, mountCodeSnippetPanel, mountCrosshairLegend, mountDrawingPropertiesPanel, mountPineEditorPanel, mountSettingsPanel as mountSettingsMenu, mountSettingsPanel, mountStatusBar, mountSymbolSearch, mountTopBar, openDrawingContextMenu, openShortcutsModal, pineLanguage, resolveLayoutFeatures, saveIndicatorConfig, savePineScriptPreference, saveReturnToCursorPreference, saveShowGridPreference };
+export { type ChartLayoutOptions, type ContextMenuAction, type ContextMenuOptions, type CrosshairLegendOptions, DEFAULT_LAYOUT_FEATURES, type DrawingContextMenuHandlers, type DrawingPropertiesPanelOptions, type DrawingToolId, GRID_SETTING_KEY, type I18nProvider, type LayoutFeatures, type LogoSlotOptions, type OhlcvSnapshot, PINE_SCRIPT_STORAGE_KEY, type PineEditorPanelOptions, RETURN_CURSOR_KEY, type ResolvedLayoutFeatures, type SettingsPanelOptions as SettingsMenuOptions, type SettingsPanelOptions, type StatusBarOptions, type SymbolInputMode, type SymbolSearchDialogHandle, type SymbolSearchDialogOptions, type SymbolSearchOptions, THEME_STORAGE_KEY, type ThemeId, type ThemeProvider, type ThemeToggleOptions, type TopBarOptions, applyThemeToDocument, attachChartContextMenu, bindShortcutsModal, createDemoLayoutOptions, createI18nProvider, createSymbolSearchDialog, createThemeProvider, loadIndicatorConfig, loadPineScriptPreference, loadReturnToCursorPreference, loadShowGridPreference, loadTheme, mergeLayoutFeatures, mountChartLayout, mountCodeSnippetPanel, mountCrosshairLegend, mountDrawingPropertiesPanel, mountLogoSlot, mountPineEditorPanel, mountSettingsPanel as mountSettingsMenu, mountSettingsPanel, mountStatusBar, mountSymbolSearch, mountSymbolSearchDialogTrigger, mountThemeToggle, mountTopBar, openDrawingContextMenu, openShortcutsModal, pineLanguage, resolveLayoutFeatures, saveIndicatorConfig, savePineScriptPreference, saveReturnToCursorPreference, saveShowGridPreference, saveTheme };