@nstudio/ncharts 1.0.0

package/common.d.ts

@@ -0,0 +1,300 @@
+import { View, Property, Color } from '@nativescript/core';
+import type { ChartAnimation, LegendConfig, XAxisConfig, YAxisConfigDual, YAxisConfig, ChartDescription, MarkerConfig, Highlight, LineChartData, BarChartData, PieChartData, ScatterChartData, BubbleChartData, CandleChartData, RadarChartData, CombinedChartData, ChartColor } from './types';
+export * from './types';
+/**
+ * Global configuration for @nstudio/ncharts
+ */
+export declare class NCharts {
+    /**
+     * Enable debug logging for the ncharts plugin.
+     * Set to true to see detailed console logs.
+     * @default false
+     */
+    static debug: boolean;
+}
+/**
+ * Internal logging helper - only logs when NCharts.debug is true
+ */
+export declare function nchartsLog(...args: any[]): void;
+/**
+ * Internal error logging helper - only logs when NCharts.debug is true
+ */
+export declare function nchartsError(...args: any[]): void;
+/**
+ * Convert ChartColor to native Color
+ */
+export declare function parseColor(color: ChartColor | undefined): Color | undefined;
+/**
+ * Convert ChartColor to platform-specific format
+ * Android: ARGB integer
+ * iOS: UIColor (handled by Color class)
+ */
+export declare function toPlatformColor(color: ChartColor | undefined): any;
+/**
+ * Base class for all chart views
+ * Provides common functionality shared across all chart types
+ */
+export declare abstract class ChartViewBase extends View {
+    protected _nativeChart: any;
+    /** Animation configuration */
+    animation: ChartAnimation | undefined;
+    /** Chart background color */
+    chartBackgroundColor: ChartColor | undefined;
+    /** Chart grid background color */
+    chartGridBackgroundColor: ChartColor | undefined;
+    /** Enable logging */
+    logEnabled: boolean;
+    /** Text displayed when no data */
+    noDataText: string;
+    /** Color of no data text */
+    noDataTextColor: ChartColor | undefined;
+    /** Enable touch gestures */
+    touchEnabled: boolean;
+    /** Enable drag deceleration */
+    dragDecelerationEnabled: boolean;
+    /** Drag deceleration friction (0-1) */
+    dragDecelerationFrictionCoef: number;
+    /** Enable highlight on tap */
+    highlightPerTapEnabled: boolean;
+    /** Chart description */
+    chartDescription: ChartDescription | undefined;
+    /** Legend configuration */
+    legend: LegendConfig | undefined;
+    /** X-axis configuration */
+    xAxis: XAxisConfig | undefined;
+    /** Marker configuration */
+    marker: MarkerConfig | undefined;
+    /** Highlighted values */
+    highlights: Highlight[] | undefined;
+    /** Select event name */
+    static selectEvent: string;
+    /** Deselect event name */
+    static deselectEvent: string;
+    /** Gesture event name */
+    static gestureEvent: string;
+    /**
+     * Get the native chart instance
+     */
+    abstract get nativeChart(): any;
+    /**
+     * Apply data to the chart
+     */
+    abstract applyData(): void;
+    /**
+     * Animate chart
+     */
+    animate(animation?: ChartAnimation): void;
+    /**
+     * Highlight values programmatically
+     */
+    highlightValues(highlights: Highlight[] | null): void;
+    /**
+     * Clear all highlights
+     */
+    clearHighlights(): void;
+    /**
+     * Invalidate and redraw chart
+     */
+    invalidate(): void;
+    protected abstract _applyAnimation(animation: ChartAnimation): void;
+    protected abstract _applyHighlights(highlights: Highlight[] | null): void;
+    protected abstract _invalidateChart(): void;
+    protected abstract _applyLegend(legend: LegendConfig): void;
+    protected abstract _applyXAxis(xAxis: XAxisConfig): void;
+    protected abstract _applyDescription(description: ChartDescription): void;
+    protected abstract _applyMarker(marker: MarkerConfig): void;
+    protected onAnimationChange(): void;
+    protected onLegendChange(): void;
+    protected onXAxisChange(): void;
+    protected onDescriptionChange(): void;
+    protected onMarkerChange(): void;
+    protected onHighlightsChange(): void;
+}
+/**
+ * Base class for Line, Bar, Scatter, Bubble, Candlestick, Combined charts
+ */
+export declare abstract class BarLineChartViewBase extends ChartViewBase {
+    /** Maximum highlight distance */
+    maxHighlightDistance: number;
+    /** Draw grid background */
+    drawGridBackground: boolean;
+    /** Grid background color */
+    gridBackgroundColor: ChartColor | undefined;
+    /** Draw chart borders */
+    drawBorders: boolean;
+    /** Border color */
+    borderColor: ChartColor | undefined;
+    /** Border width */
+    borderWidth: number;
+    /** Minimum offset from edges */
+    minOffset: number;
+    /** Maximum visible value count */
+    maxVisibleValueCount: number;
+    /** Auto scale min/max */
+    autoScaleMinMaxEnabled: boolean;
+    /** Keep position on rotation */
+    keepPositionOnRotation: boolean;
+    /** Enable highlight on drag */
+    highlightPerDragEnabled: boolean;
+    /** Enable scaling */
+    scaleEnabled: boolean;
+    /** Enable X-axis scaling */
+    scaleXEnabled: boolean;
+    /** Enable Y-axis scaling */
+    scaleYEnabled: boolean;
+    /** Enable dragging */
+    dragEnabled: boolean;
+    /** Enable pinch zoom */
+    pinchZoom: boolean;
+    /** Enable double tap zoom */
+    doubleTapToZoomEnabled: boolean;
+    /** Y-axis configuration */
+    yAxis: YAxisConfigDual | undefined;
+    protected abstract _applyYAxis(yAxis: YAxisConfigDual): void;
+    protected onYAxisChange(): void;
+    /**
+     * Move view to specific X value
+     */
+    moveViewToX(xValue: number): void;
+    /**
+     * Move view to specific X,Y value
+     */
+    moveViewTo(xValue: number, yValue: number, axisDependency?: 'LEFT' | 'RIGHT'): void;
+    /**
+     * Center view on specific X,Y value
+     */
+    centerViewTo(xValue: number, yValue: number, axisDependency?: 'LEFT' | 'RIGHT'): void;
+    /**
+     * Zoom to specific scale and position
+     */
+    zoom(scaleX: number, scaleY: number, xValue: number, yValue: number, axisDependency?: 'LEFT' | 'RIGHT'): void;
+    /**
+     * Reset zoom to original
+     */
+    fitScreen(): void;
+    protected abstract _moveViewToX(xValue: number): void;
+    protected abstract _moveViewTo(xValue: number, yValue: number, axisDependency: string): void;
+    protected abstract _centerViewTo(xValue: number, yValue: number, axisDependency: string): void;
+    protected abstract _zoom(scaleX: number, scaleY: number, xValue: number, yValue: number, axisDependency: string): void;
+    protected abstract _fitScreen(): void;
+}
+/**
+ * Base class for Pie and Radar charts
+ */
+export declare abstract class PieRadarChartViewBase extends ChartViewBase {
+    /** Rotation angle */
+    rotationAngle: number;
+    /** Enable rotation */
+    rotationEnabled: boolean;
+    /** Minimum offset */
+    minOffset: number;
+}
+/**
+ * Line Chart
+ */
+export declare abstract class LineChartBase extends BarLineChartViewBase {
+    data: LineChartData | undefined;
+}
+/**
+ * Bar Chart
+ */
+export declare abstract class BarChartBase extends BarLineChartViewBase {
+    data: BarChartData | undefined;
+}
+/**
+ * Horizontal Bar Chart
+ */
+export declare abstract class HorizontalBarChartBase extends BarLineChartViewBase {
+    data: BarChartData | undefined;
+}
+/**
+ * Pie Chart
+ */
+export declare abstract class PieChartBase extends PieRadarChartViewBase {
+    data: PieChartData | undefined;
+    /** Draw hole in center */
+    drawHole: boolean;
+    /** Hole radius as percentage */
+    holeRadius: number;
+    /** Transparent circle radius */
+    transparentCircleRadius: number;
+    /** Hole color */
+    holeColor: ChartColor | undefined;
+    /** Transparent circle color */
+    transparentCircleColor: ChartColor | undefined;
+    /** Draw center text */
+    drawCenterText: boolean;
+    /** Center text */
+    centerText: string;
+    /** Center text color */
+    centerTextColor: ChartColor | undefined;
+    /** Center text size */
+    centerTextSize: number;
+    /** Draw slice labels */
+    drawSliceText: boolean;
+    /** Slice label text size */
+    sliceTextSize: number;
+    /** Slice label text color */
+    sliceTextColor: ChartColor | undefined;
+    /** Use percentage values */
+    usePercentValues: boolean;
+    /** Maximum angle */
+    maxAngle: number;
+}
+/**
+ * Scatter Chart
+ */
+export declare abstract class ScatterChartBase extends BarLineChartViewBase {
+    data: ScatterChartData | undefined;
+}
+/**
+ * Bubble Chart
+ */
+export declare abstract class BubbleChartBase extends BarLineChartViewBase {
+    data: BubbleChartData | undefined;
+}
+/**
+ * Candlestick Chart
+ */
+export declare abstract class CandleStickChartBase extends BarLineChartViewBase {
+    data: CandleChartData | undefined;
+}
+/**
+ * Radar Chart
+ */
+export declare abstract class RadarChartBase extends PieRadarChartViewBase {
+    data: RadarChartData | undefined;
+    /** Y-axis configuration */
+    yAxis: YAxisConfig | undefined;
+    /** Draw web lines */
+    drawWeb: boolean;
+    /** Web line width */
+    webLineWidth: number;
+    /** Web line width inner */
+    webLineWidthInner: number;
+    /** Web alpha (0-255) */
+    webAlpha: number;
+    /** Web color */
+    webColor: ChartColor | undefined;
+    /** Web color inner */
+    webColorInner: ChartColor | undefined;
+    /** Skip web line count */
+    skipWebLineCount: number;
+}
+/**
+ * Combined Chart
+ */
+export declare abstract class CombinedChartBase extends BarLineChartViewBase {
+    data: CombinedChartData | undefined;
+}
+export declare const dataProperty: Property<ChartViewBase, any>;
+export declare const animationProperty: Property<ChartViewBase, ChartAnimation>;
+export declare const legendProperty: Property<ChartViewBase, LegendConfig>;
+export declare const xAxisProperty: Property<ChartViewBase, XAxisConfig>;
+export declare const yAxisProperty: Property<BarLineChartViewBase, YAxisConfigDual>;
+export declare const chartDescriptionProperty: Property<ChartViewBase, ChartDescription>;
+export declare const markerProperty: Property<ChartViewBase, MarkerConfig>;
+export declare const highlightsProperty: Property<ChartViewBase, Highlight[]>;
+export declare const drawHoleProperty: Property<PieChartBase, boolean>;
+export declare const holeRadiusProperty: Property<PieChartBase, number>;
+export declare const rotationAngleProperty: Property<PieRadarChartViewBase, number>;