@itssumitrai/fin-charter 0.2.0

package/dist/interactions/drawing-handler.d.ts

@@ -0,0 +1,39 @@
+import { EventHandler } from './event-router';
+import { ISeriesPrimitive } from '../core/types';
+import { DrawingPrimitive, DrawingContext } from '../drawings/base';
+export type DrawingHandlerState = 'IDLE' | 'SELECTING' | 'PLACING' | 'EDITING';
+export interface DrawingHandlerCallbacks {
+    getDrawings(): (ISeriesPrimitive & DrawingPrimitive)[];
+    getDrawingContext(): DrawingContext | null;
+    onDrawingCreated(drawing: ISeriesPrimitive & DrawingPrimitive): void;
+    onDrawingUpdated(drawing?: ISeriesPrimitive & DrawingPrimitive): void;
+    xToTime(x: number): number;
+    yToPrice(y: number): number;
+}
+/**
+ * Interaction handler for drawing tools.
+ * Manages placement of new drawings and selection/editing of existing drawings.
+ */
+export declare class DrawingHandler implements EventHandler {
+    private _state;
+    private _activeToolType;
+    private _callbacks;
+    private _placingDrawing;
+    private _placedPointCount;
+    private _nextId;
+    private _selectedDrawing;
+    private _editHit;
+    private _dragStartX;
+    private _dragStartY;
+    private _dragStartPoints;
+    constructor(callbacks: DrawingHandlerCallbacks);
+    get state(): DrawingHandlerState;
+    setActiveToolType(type: string | null): void;
+    onPointerDown(x: number, y: number, _pointerId: number): boolean;
+    onPointerMove(x: number, y: number, _pointerId: number): boolean;
+    onPointerUp(_pointerId: number): boolean;
+    onKeyDown(key: string, _shiftKey: boolean): boolean;
+    private _handlePlacementClick;
+    private _hitTestDrawings;
+    private _applyDrag;
+}

package/dist/interactions/event-router.d.ts

@@ -0,0 +1,37 @@
+export interface EventHandler {
+    /**
+     * Called on pointer down. Return `true` to consume the event and prevent
+     * subsequent handlers from receiving it; return `false` or `undefined` to
+     * let the event propagate.
+     */
+    onPointerDown?(x: number, y: number, pointerId: number): boolean | void;
+    onPointerMove?(x: number, y: number, pointerId: number): boolean | void;
+    onPointerUp?(pointerId: number): boolean | void;
+    onWheel?(x: number, y: number, deltaY: number): void;
+    onKeyDown?(key: string, shiftKey: boolean): boolean | void;
+    onContextMenu?(x: number, y: number): boolean | void;
+}
+export declare class EventRouter {
+    private _element;
+    private _handlers;
+    private _boundPointerDown;
+    private _boundPointerMove;
+    private _boundPointerUp;
+    private _boundPointerLeave;
+    private _boundWheel;
+    private _boundKeyDown;
+    private _boundContextMenu;
+    constructor();
+    attach(element: HTMLElement): void;
+    detach(): void;
+    addHandler(handler: EventHandler): void;
+    removeHandler(handler: EventHandler): void;
+    private _getLocalCoords;
+    private _handlePointerDown;
+    private _handlePointerMove;
+    private _handlePointerUp;
+    private _handlePointerLeave;
+    private _handleWheel;
+    private _handleKeyDown;
+    private _handleContextMenu;
+}

package/dist/interactions/keyboard-nav.d.ts

@@ -0,0 +1,11 @@
+import { EventHandler } from './event-router';
+import { TimeScale } from '../core/time-scale';
+export declare class KeyboardNavHandler implements EventHandler {
+    private _timeScale;
+    private _requestInvalidation;
+    constructor(timeScale: TimeScale, requestInvalidation: () => void);
+    onKeyDown(key: string, shiftKey: boolean): void;
+    /** Best-effort center x — 0 means zoom around left edge if width unknown. */
+    private _getCenterX;
+    private _scrollToStart;
+}

package/dist/interactions/pan-zoom.d.ts

@@ -0,0 +1,39 @@
+import { EventHandler } from './event-router';
+import { TimeScale } from '../core/time-scale';
+/**
+ * Pan and zoom handler for chart navigation.
+ *
+ * Pan:
+ * - On pointer down: store scrollStartX and savedRightOffset
+ * - On pointer move: timeScale.scrollTo(scrollStartX, currentX, savedRightOffset)
+ * - Dragging right → x increases → shift is negative → rightOffset decreases
+ *   → chart moves toward future/recent data.
+ *
+ * Zoom (wheel):
+ * - TV negates deltaY and clamps to ±1 for the zoom scale.
+ * - timeScale.zoomAt(x, scale)
+ */
+export declare class PanZoomHandler implements EventHandler {
+    private _timeScale;
+    private _requestInvalidation;
+    private _scrollStartX;
+    private _savedRightOffset;
+    private _isPanning;
+    private _activePointerId;
+    /** Track last N positions for kinetic velocity calculation. */
+    private _positions;
+    private _kineticRafId;
+    constructor(timeScale: TimeScale, requestInvalidation: () => void);
+    onPointerDown(x: number, _y: number, pointerId: number): void;
+    onPointerMove(x: number, _y: number, pointerId: number): void;
+    onPointerUp(pointerId: number): void;
+    onWheel(x: number, _y: number, deltaY: number): void;
+    destroy(): void;
+    /**
+     * Compute velocity (pixels per millisecond) from tracked positions,
+     * then convert to pixels-per-frame (~16ms).
+     */
+    private _computeVelocity;
+    private _startKinetic;
+    private _cancelKinetic;
+}

package/dist/interactions/range-selection.d.ts

@@ -0,0 +1,103 @@
+import { EventHandler } from './event-router';
+import { TimeScale } from '../core/time-scale';
+import { PriceScale } from '../core/price-scale';
+import { ColumnStore } from '../core/types';
+export interface RangeSelectionStats {
+    fromTime: number;
+    toTime: number;
+    fromPrice: number;
+    toPrice: number;
+    high: number;
+    low: number;
+    priceChange: number;
+    percentChange: number;
+    barCount: number;
+    totalVolume: number;
+}
+export type RangeSelectionCallback = (stats: RangeSelectionStats | null) => void;
+/**
+ * RangeSelectionHandler — allows users to drag-select a time range on the
+ * chart and see summary statistics (high, low, change, volume).
+ *
+ * Activated by setting `active = true`. When active, pointer-down starts a
+ * selection; pointer-move extends it; pointer-up finalizes and fires the
+ * callback.
+ */
+export declare class RangeSelectionHandler implements EventHandler {
+    private _active;
+    private _selecting;
+    private _startX;
+    private _startY;
+    private _endX;
+    private _endY;
+    private _timeScale;
+    private _priceScale;
+    private _getStore;
+    private _requestRepaint;
+    private _callbacks;
+    constructor(timeScale: TimeScale, priceScale: PriceScale, getStore: () => ColumnStore | null, requestRepaint: () => void);
+    get active(): boolean;
+    set active(value: boolean);
+    get selecting(): boolean;
+    get startX(): number;
+    get startY(): number;
+    get endX(): number;
+    get endY(): number;
+    onRangeSelected(callback: RangeSelectionCallback): void;
+    offRangeSelected(callback: RangeSelectionCallback): void;
+    clear(): void;
+    onPointerDown(x: number, y: number): boolean | void;
+    onPointerMove(x: number, y: number): boolean | void;
+    onPointerUp(): boolean | void;
+    onKeyDown(key: string): boolean | void;
+    private _computeStats;
+}
+export interface MeasureResult {
+    fromTime: number;
+    toTime: number;
+    fromPrice: number;
+    toPrice: number;
+    priceChange: number;
+    percentChange: number;
+    barCount: number;
+    timeElapsed: number;
+}
+export type MeasureCallback = (result: MeasureResult | null) => void;
+/**
+ * MeasureHandler — click two points to see price change, % change, bar count,
+ * and time elapsed between them.
+ */
+export declare class MeasureHandler implements EventHandler {
+    private _active;
+    private _firstPoint;
+    private _secondPoint;
+    private _hovering;
+    private _hoverX;
+    private _hoverY;
+    private _timeScale;
+    private _priceScale;
+    private _getStore;
+    private _requestRepaint;
+    private _callbacks;
+    constructor(timeScale: TimeScale, priceScale: PriceScale, getStore: () => ColumnStore | null, requestRepaint: () => void);
+    get active(): boolean;
+    set active(value: boolean);
+    get firstPoint(): {
+        x: number;
+        y: number;
+    } | null;
+    get secondPoint(): {
+        x: number;
+        y: number;
+    } | null;
+    get hovering(): boolean;
+    get hoverX(): number;
+    get hoverY(): number;
+    onMeasure(callback: MeasureCallback): void;
+    offMeasure(callback: MeasureCallback): void;
+    clear(): void;
+    onPointerDown(x: number, y: number): boolean | void;
+    onPointerMove(x: number, y: number): boolean | void;
+    onKeyDown(key: string): boolean | void;
+    private _computeResult;
+}

package/dist/interactions/touch-gestures.d.ts

@@ -0,0 +1,36 @@
+import { EventHandler } from './event-router';
+import { TimeScale } from '../core/time-scale';
+export interface TouchGestureOptions {
+    /** Enable pinch-to-zoom (default: true). */
+    pinchZoom?: boolean;
+    /** Enable two-finger pan (default: true). */
+    twoFingerPan?: boolean;
+    /** Enable momentum scrolling after pan release (default: true). */
+    momentum?: boolean;
+    /** Momentum friction factor 0–1 (default: 0.95). */
+    momentumFriction?: number;
+}
+/**
+ * TouchGestureHandler — detects pinch-to-zoom and two-finger pan
+ * on touch devices and applies them to the chart's TimeScale.
+ */
+export declare class TouchGestureHandler implements EventHandler {
+    private _options;
+    private _timeScale;
+    private _requestRepaint;
+    private _activeTouches;
+    private _initialPinchDistance;
+    private _initialBarSpacing;
+    private _lastPanX;
+    private _velocityX;
+    private _momentumRafId;
+    constructor(timeScale: TimeScale, requestRepaint: () => void, options?: TouchGestureOptions);
+    get activeTouchCount(): number;
+    onPointerDown(x: number, y: number, pointerId: number): boolean | void;
+    onPointerMove(x: number, y: number, pointerId: number): boolean | void;
+    onPointerUp(pointerId: number): boolean | void;
+    dispose(): void;
+    private _distance;
+    private _startMomentum;
+    private _stopMomentum;
+}

package/dist/logo.svg

@@ -0,0 +1,40 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" fill="none">
+  <defs>
+    <linearGradient id="g1" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#2962ff"/>
+      <stop offset="100%" stop-color="#00bcd4"/>
+    </linearGradient>
+    <linearGradient id="g2" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#26a69a"/>
+      <stop offset="100%" stop-color="#1b5e20"/>
+    </linearGradient>
+    <linearGradient id="g3" x1="0" y1="1" x2="0" y2="0">
+      <stop offset="0%" stop-color="#ef5350"/>
+      <stop offset="100%" stop-color="#b71c1c"/>
+    </linearGradient>
+  </defs>
+  <!-- Background rounded square -->
+  <rect x="16" y="16" width="480" height="480" rx="64" fill="#0d1117"/>
+  <!-- Grid lines (subtle) -->
+  <line x1="80" y1="100" x2="432" y2="100" stroke="#1a2332" stroke-width="1"/>
+  <line x1="80" y1="180" x2="432" y2="180" stroke="#1a2332" stroke-width="1"/>
+  <line x1="80" y1="260" x2="432" y2="260" stroke="#1a2332" stroke-width="1"/>
+  <line x1="80" y1="340" x2="432" y2="340" stroke="#1a2332" stroke-width="1"/>
+  <line x1="80" y1="420" x2="432" y2="420" stroke="#1a2332" stroke-width="1"/>
+  <!-- Candlestick 1 (green/up) -->
+  <line x1="140" y1="140" x2="140" y2="380" stroke="url(#g2)" stroke-width="4" stroke-linecap="round"/>
+  <rect x="120" y="200" width="40" height="120" rx="4" fill="url(#g2)"/>
+  <!-- Candlestick 2 (red/down) -->
+  <line x1="220" y1="100" x2="220" y2="360" stroke="url(#g3)" stroke-width="4" stroke-linecap="round"/>
+  <rect x="200" y="140" width="40" height="140" rx="4" fill="url(#g3)"/>
+  <!-- Candlestick 3 (green/up, tall) -->
+  <line x1="300" y1="80" x2="300" y2="340" stroke="url(#g2)" stroke-width="4" stroke-linecap="round"/>
+  <rect x="280" y="120" width="40" height="160" rx="4" fill="url(#g2)"/>
+  <!-- Candlestick 4 (green/up) -->
+  <line x1="380" y1="100" x2="380" y2="300" stroke="url(#g2)" stroke-width="4" stroke-linecap="round"/>
+  <rect x="360" y="140" width="40" height="100" rx="4" fill="url(#g2)"/>
+  <!-- Trend line overlay -->
+  <line x1="120" y1="320" x2="400" y2="130" stroke="url(#g1)" stroke-width="3" stroke-linecap="round" stroke-dasharray="8 4" opacity="0.8"/>
+  <!-- Glow effect on trend line -->
+  <line x1="120" y1="320" x2="400" y2="130" stroke="#2962ff" stroke-width="8" stroke-linecap="round" opacity="0.15"/>
+</svg>

package/dist/market/exchange-map.d.ts

@@ -0,0 +1,3 @@
+import { MarketDefinition } from './market-definition';
+export declare function getMarketForExchange(exchangeCode: string): MarketDefinition | undefined;
+export declare function registerExchange(exchangeCode: string, marketId: string): void;

package/dist/market/index.d.ts

@@ -0,0 +1,4 @@
+export { getMarket, registerMarket, US_MARKET, UK_MARKET, JP_MARKET, DE_MARKET, AU_MARKET, CRYPTO_MARKET, } from './market-definition';
+export type { MarketDefinition, MarketHoliday } from './market-definition';
+export { isMarketDate, getNextOpen, isEarlyClose } from './market-calendar';
+export { getMarketForExchange, registerExchange } from './exchange-map';

package/dist/market/market-calendar.d.ts

@@ -0,0 +1,4 @@
+import { MarketDefinition } from './market-definition';
+export declare function isMarketDate(dateStr: string, market: MarketDefinition): boolean;
+export declare function isEarlyClose(dateStr: string, market: MarketDefinition): number | null;
+export declare function getNextOpen(timestampSec: number, market: MarketDefinition): number;

package/dist/market/market-definition.d.ts

@@ -0,0 +1,22 @@
+import { MarketSession } from '../core/market-session';
+export interface MarketHoliday {
+    date: string;
+    name?: string;
+    earlyClose?: number;
+}
+export interface MarketDefinition {
+    id: string;
+    name: string;
+    timezone: string;
+    currency: string;
+    sessions: MarketSession[];
+    holidays: MarketHoliday[];
+}
+export declare const US_MARKET: MarketDefinition;
+export declare const UK_MARKET: MarketDefinition;
+export declare const JP_MARKET: MarketDefinition;
+export declare const DE_MARKET: MarketDefinition;
+export declare const AU_MARKET: MarketDefinition;
+export declare const CRYPTO_MARKET: MarketDefinition;
+export declare function getMarket(id: string): MarketDefinition | undefined;
+export declare function registerMarket(market: MarketDefinition): void;