@funnest/charts-ui 0.0.0-stage → 0.1.0

package/dist/storage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Small persistence helper for UI preferences (favorite intervals, recent searches).
+ * Uses localStorage under `prefix:` when available; `prefix: null` keeps everything in memory
+ * (e.g. when the host app syncs preferences to its own account storage via callbacks).
+ */
+export interface WidgetStorage {
+    get<T>(key: string, fallback: T): T;
+    set(key: string, value: unknown): void;
+}
+export declare function createStorage(prefix: string | null): WidgetStorage;

package/dist/store.d.ts

@@ -0,0 +1,10 @@
+/** Minimal observable state shared by the toolbar and overlay render roots. */
+export declare class Store<T extends object> {
+    private state;
+    private readonly listeners;
+    constructor(state: T);
+    get(): T;
+    set(patch: Partial<T>): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare function useStore<T extends object>(store: Store<T>): T;

package/dist/styles.d.ts

@@ -0,0 +1 @@
+export declare function injectStyles(doc?: Document): void;

package/dist/trading-chart.d.ts

@@ -0,0 +1,83 @@
+/** @jsxImportSource preact */
+import { type Chart, type ChartOptions, type ChartType, type Datafeed, type Locale, type ChartState, type Resolution, type ThemeTokens } from '@funnest/charts';
+import type { IntervalGroup, SearchCategory } from './context';
+/** Interval menu: 분 | 시간 | 일. '12M' is shown as 1년. */
+export declare const DEFAULT_INTERVAL_GROUPS: readonly IntervalGroup[];
+/** Toolbar chips until the user stars their own. */
+export declare const DEFAULT_FAVORITE_INTERVALS: readonly Resolution[];
+/** Symbol search tabs, derived from `SymbolInfo.type` / `country`. */
+export declare const DEFAULT_SEARCH_CATEGORIES: readonly SearchCategory[];
+export interface TradingChartOptions extends Omit<ChartOptions, 'datafeed'> {
+    datafeed: Datafeed;
+    symbol: string;
+    /** Default '1D'. */
+    resolution?: Resolution;
+    /** Interval menu groups (분 | 시간 | 일). */
+    intervalGroups?: readonly IntervalGroup[];
+    /** Initial toolbar chips; the user changes them with ★. Default: 1분 5분 15분 1시간 4시간 일. */
+    favoriteIntervals?: readonly Resolution[];
+    /** Called when the user stars/unstars an interval (e.g. to sync to their account). */
+    onFavoriteIntervalsChange?: (intervals: Resolution[]) => void;
+    /** Symbol search tabs. */
+    searchCategories?: readonly SearchCategory[];
+    /**
+     * localStorage key prefix for UI preferences (favorite intervals, recent searches).
+     * Default 'funnest-charts'. Pass null to keep them in memory only.
+     */
+    storageKey?: string | null;
+    /** Ctrl/⌘ + K opens symbol search. Default true. */
+    searchHotkey?: boolean;
+    /** Show symbol logos (SymbolInfo.logoUrl, or an initial avatar). Default true. */
+    symbolLogo?: boolean;
+    /** Show the left drawing tool bar. Default true. */
+    drawingToolbar?: boolean;
+    /** Initial chart type. Default 'candles'. */
+    chartType?: ChartType;
+    /**
+     * Funnest logo badge in the bottom-left corner of the chart, linking to charts.funnest.xyz.
+     * Default true. Free to turn off (Apache-2.0); keeping it on is how you say thanks.
+     */
+    attribution?: boolean;
+    /**
+     * Base palette. 'system' (default) follows the OS light/dark setting and switches live.
+     * `theme` overrides are applied on top of whichever base is active.
+     */
+    colorScheme?: ColorScheme;
+}
+export type ColorScheme = 'light' | 'dark' | 'system';
+/**
+ * Empty elements inside the widget layout where the host app mounts its own UI (any framework):
+ * market stats, account info, status bars… They inherit the widget's `--fnc-*` theme variables
+ * and collapse when empty.
+ */
+export interface TradingChartSlots {
+    /** In the toolbar row, after the interval buttons. */
+    readonly toolbar: HTMLElement;
+    /** Right end of the toolbar, next to the settings (gear) button — for extra icon buttons. */
+    readonly toolbarEnd: HTMLElement;
+    /** A full-width row under the toolbar. */
+    readonly belowToolbar: HTMLElement;
+    /** A full-width row under the chart. */
+    readonly footer: HTMLElement;
+}
+export interface TradingChart {
+    /** The underlying engine, for anything the widget doesn't wrap. */
+    readonly chart: Chart;
+    readonly slots: TradingChartSlots;
+    setSymbol(symbol: string, resolution?: Resolution): Promise<void>;
+    setResolution(resolution: Resolution): Promise<void>;
+    setLocale(locale: Locale): void;
+    /** Override theme tokens (kept across light/dark switches). */
+    setTheme(theme: Partial<ThemeTokens>): void;
+    setColorScheme(scheme: ColorScheme): void;
+    /** Layout snapshot (symbol, interval, chart type, settings, indicators, drawings, view). */
+    save(): ChartState;
+    /** Restores a layout from `save()` / stored JSON. */
+    load(state: ChartState | unknown): Promise<void>;
+    destroy(): void;
+}
+/**
+ * Full trading chart widget: toolbar (symbol search, intervals, screenshot, fullscreen),
+ * legend, navigation controls and the canvas engine. Framework-agnostic: mount into any element.
+ */
+export declare function createTradingChart(container: HTMLElement, options: TradingChartOptions): TradingChart;

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@funnest/charts-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Pro trading UI (toolbar, drawing tools, sheets) for Funnest Charts. Framework-agnostic.",
+  "keywords": [
+    "chart",
+    "trading",
+    "widget",
+    "toolbar",
+    "drawing-tools",
+    "indicators",
+    "candlestick"
+  ],
+  "license": "Apache-2.0",
+  "author": "Funnest",
+  "homepage": "https://charts.funnest.xyz",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funnest-xyz/funnest-charts.git",
+    "directory": "packages/ui"
+  },
+  "bugs": {
+    "url": "https://github.com/funnest-xyz/funnest-charts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "funnest-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@funnest/charts": "0.1.0"
+  },
+  "devDependencies": {
+    "preact": "^11.2.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }