@overdoser/react-toolkit 0.0.13 → 0.0.15

package/components/Chart/TradingChart.d.ts

@@ -5,9 +5,14 @@ export interface TradingChartProps {
     symbol: string;
     resolution: Resolution;
     /**
-     * Visible time-range window (e.g. `'1D'`, `'5D'`, `'1M'`, `'1Y'`, `'5Y'`).
-     * When set, the chart fetches bars for the last `period` of time and the
-     * initial visible range covers the whole window. Overrides `initialLookback`.
+     * Visible time-range window (e.g. `'1D'`, `'5D'`, `'1M'`, `'1Y'`, `'5Y'`,
+     * `'10Y'`, `'20Y'`, `'MAX'`). When set, the chart fetches bars for the last `period` of time
+     * and the initial visible range covers the whole window. Overrides
+     * `initialLookback`.
+     *
+     * `'MAX'` requests `from: 0` (epoch) — the chart renders whatever the
+     * datafeed returns. Pair with a coarse `resolution` (`'W'` or `'M'`) so the
+     * bar count stays manageable.
      *
      * The chart does not auto-adjust `resolution` when `period` changes — use
      * `suggestResolutionForPeriod()` / `suggestPeriodForResolution()` if you
@@ -47,6 +52,30 @@ export interface TradingChartProps {
      * here in the future. @default true
      */
     showConfigPanel?: boolean;
+    /**
+     * When `true`, the top cursor-value badge is tinted by bar direction
+     * (`upColor` for `close >= open`, `downColor` otherwise) with white text.
+     * When `false`, the badge uses the same neutral palette as the bottom
+     * datetime badge. @default false
+     */
+    priceBadgeColorByDirection?: boolean;
+    /**
+     * When `true`, the top cursor-value badge appends a date (for `'D'` /
+     * `'W'` / `'M'` resolutions) or a weekday+date+time (for intraday
+     * resolutions) after the price, separated by ` · `. Honours `timezone`.
+     * Default formats:
+     *   - D / W / M  → `17 Sep 2025`
+     *   - intraday    → `Wed 17 Sep 14:30`
+     * @default false
+     */
+    priceBadgeShowTime?: boolean;
+    /**
+     * Optional override for the time portion when `priceBadgeShowTime` is on.
+     * Receives the bar's unix-seconds time, the current `resolution`, and the
+     * chart's `timezone`. Return whatever string you want appended after the
+     * price. Returning an empty string suppresses the suffix for that hover.
+     */
+    priceBadgeTimeFormat?: (unixSec: number, resolution: Resolution, timezone: Timezone) => string;
     /** Fired when the crosshair moves (`null` when leaving the chart). */
     onCrosshair?: (info: CrosshairInfo | null) => void;
     /** Fired after pan / zoom / data updates. */
@@ -78,7 +107,7 @@ export interface TradingChartProps {
  *   ]}
  * />
  */
-export declare function TradingChart({ datafeed, symbol, resolution, period, seriesType, indicators, precision, initialLookback, height, upColor, downColor, lineColor, timezone, defaultTimezone, onTimezoneChange, showConfigPanel, onCrosshair, onVisibleRangeChange, className, style, }: TradingChartProps): import("react/jsx-runtime").JSX.Element;
+export declare function TradingChart({ datafeed, symbol, resolution, period, seriesType, indicators, precision, initialLookback, height, upColor, downColor, lineColor, timezone, defaultTimezone, onTimezoneChange, showConfigPanel, priceBadgeColorByDirection, priceBadgeShowTime, priceBadgeTimeFormat, onCrosshair, onVisibleRangeChange, className, style, }: TradingChartProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Full crosshair date/time label with a timezone tag.
  * Format: `YYYY-MM-DD HH:MM:SS <tz>` — `<tz>` is `+HH:MM` for local,

package/components/Chart/trading/period.d.ts

@@ -3,6 +3,9 @@ import { Period, Resolution } from './types';
  * Convert a `Period` string to seconds. Accepts the typed presets as well as
  * any `<n><unit>` string where unit is `h` / `d` / `w` / `m` / `y`
  * (case-insensitive). Falls back to 30 days on unparseable input.
+ *
+ * `'MAX'` is reported as 100 years — large enough to cover any realistic
+ * asset history. The chart special-cases it to fetch `from: 0` (epoch).
  */
 export declare function periodToSeconds(period: Period): number;
 /**

package/components/Chart/trading/types.d.ts

@@ -26,8 +26,12 @@ export type Resolution = '1' | '3' | '5' | '15' | '30' | '60' | '120' | '240' |
  * Visible time-range window. Drives the initial X-axis span of the chart.
  * Common presets are typed; any other `<n><unit>` string (`'30d'`, `'2y'`,
  * `'48h'`, …) is accepted and parsed.
+ *
+ * `'MAX'` is a special preset: the chart requests bars `from: 0` (epoch) to
+ * now and renders whatever range the datafeed supplies. Best paired with a
+ * coarse `resolution` ('W' or 'M') so the bar count stays reasonable.
  */
-export type Period = '1D' | '5D' | '1M' | '3M' | '6M' | '1Y' | '5Y' | (string & {});
+export type Period = '1D' | '5D' | '1M' | '3M' | '6M' | '1Y' | '5Y' | '10Y' | '20Y' | 'MAX' | (string & {});
 /**
  * Timezone used to render the crosshair date/time label.
  * - `'local'` — the user's local timezone (offset shown as `+HH:MM`).