apexify.js 5.1.0 → 5.2.0

package/dist/esm/Canvas/utils/Charts/barchart.d.ts

@@ -0,0 +1,230 @@
+import { SKRSContext2D } from "@napi-rs/canvas";
+import type { gradient } from "../types";
+/**
+ * Enhanced text styling for chart labels
+ */
+export interface EnhancedTextStyle {
+    fontPath?: string;
+    fontName?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    shadow?: {
+        color?: string;
+        offsetX?: number;
+        offsetY?: number;
+        blur?: number;
+        opacity?: number;
+    };
+    stroke?: {
+        color?: string;
+        width?: number;
+        gradient?: gradient;
+    };
+    glow?: {
+        color?: string;
+        intensity?: number;
+        opacity?: number;
+    };
+}
+/**
+ * Interface for a single bar segment (used in grouped/stacked charts)
+ */
+export interface BarSegment {
+    value: number;
+    color?: string;
+    gradient?: gradient;
+    label?: string;
+    valueColor?: string;
+    showValue?: boolean;
+    opacity?: number;
+    shadow?: {
+        color?: string;
+        offsetX?: number;
+        offsetY?: number;
+        blur?: number;
+    };
+    stroke?: {
+        color?: string;
+        width?: number;
+        gradient?: gradient;
+    };
+}
+/**
+ * Interface for bar chart data with X-axis range
+ * For standard charts: single value per bar
+ * For grouped/stacked charts: multiple values per bar
+ */
+export interface BarChartData {
+    label: string;
+    value?: number;
+    values?: BarSegment[];
+    xStart: number;
+    xEnd: number;
+    color?: string;
+    gradient?: gradient;
+    labelColor?: string;
+    labelPosition?: 'top' | 'left' | 'right' | 'inside' | 'bottom';
+    valueColor?: string;
+    showValue?: boolean;
+    opacity?: number;
+    shadow?: {
+        color?: string;
+        offsetX?: number;
+        offsetY?: number;
+        blur?: number;
+    };
+    stroke?: {
+        color?: string;
+        width?: number;
+        gradient?: gradient;
+    };
+}
+/**
+ * Chart types
+ */
+export type BarChartType = 'standard' | 'grouped' | 'stacked' | 'waterfall' | 'lollipop';
+/**
+ * Interface for legend entry
+ */
+export interface LegendEntry {
+    color?: string;
+    gradient?: gradient;
+    label: string;
+}
+/**
+ * Axis configuration
+ */
+export interface AxisConfig {
+    label?: string;
+    labelColor?: string;
+    range?: {
+        min?: number;
+        max?: number;
+        step?: number;
+    };
+    values?: number[];
+    color?: string;
+    width?: number;
+    tickFontSize?: number;
+    valueSpacing?: number;
+}
+/**
+ * Bar chart configuration - organized by category
+ */
+export interface BarChartOptions {
+    type?: BarChartType;
+    waterfall?: {
+        initialValue?: number;
+    };
+    dimensions?: {
+        width?: number;
+        height?: number;
+        padding?: {
+            top?: number;
+            right?: number;
+            bottom?: number;
+            left?: number;
+        };
+    };
+    appearance?: {
+        backgroundColor?: string;
+        backgroundGradient?: gradient;
+        backgroundImage?: string;
+        axisColor?: string;
+        axisWidth?: number;
+        arrowSize?: number;
+    };
+    axes?: {
+        x?: AxisConfig;
+        y?: AxisConfig & {
+            baseline?: number;
+        };
+    };
+    labels?: {
+        title?: {
+            text?: string;
+            fontSize?: number;
+            color?: string;
+            gradient?: gradient;
+            textStyle?: EnhancedTextStyle;
+        };
+        barLabelDefaults?: {
+            show?: boolean;
+            defaultPosition?: 'top' | 'left' | 'right' | 'inside' | 'bottom';
+            fontSize?: number;
+            defaultColor?: string;
+            gradient?: gradient;
+            textStyle?: EnhancedTextStyle;
+        };
+        valueLabelDefaults?: {
+            show?: boolean;
+            fontSize?: number;
+            defaultColor?: string;
+            gradient?: gradient;
+            textStyle?: EnhancedTextStyle;
+        };
+    };
+    legend?: {
+        show?: boolean;
+        entries?: LegendEntry[];
+        position?: 'top' | 'bottom' | 'left' | 'right';
+        spacing?: number;
+        fontSize?: number;
+        backgroundColor?: string;
+        backgroundGradient?: gradient;
+        borderColor?: string;
+        textColor?: string;
+        textGradient?: gradient;
+        textStyle?: EnhancedTextStyle;
+        padding?: number;
+        maxWidth?: number;
+        wrapText?: boolean;
+    };
+    grid?: {
+        show?: boolean;
+        color?: string;
+        width?: number;
+    };
+    bars?: {
+        spacing?: number;
+        minWidth?: number;
+        groupSpacing?: number;
+        segmentSpacing?: number;
+        lineWidth?: number;
+        dotSize?: number;
+        opacity?: number;
+        shadow?: {
+            color?: string;
+            offsetX?: number;
+            offsetY?: number;
+            blur?: number;
+        };
+        stroke?: {
+            color?: string;
+            width?: number;
+            gradient?: gradient;
+        };
+    };
+}
+/**
+ * Draws x and y axes with arrows on a white background
+ * @param width Canvas width
+ * @param height Canvas height
+ * @param options Chart options
+ * @returns Canvas buffer and context
+ */
+export declare function drawAxes(width?: number, height?: number, options?: BarChartOptions): {
+    buffer: Buffer;
+    ctx: SKRSContext2D;
+    canvas: any;
+};
+/**
+ * Creates a single bar chart with X-axis range support
+ * @param data Array of bar chart data with X-axis ranges
+ * @param options Chart options
+ * @returns Canvas buffer
+ */
+export declare function createBarChart(data: BarChartData[], options?: BarChartOptions): Promise<Buffer>;
+//# sourceMappingURL=barchart.d.ts.map

package/dist/esm/Canvas/utils/Charts/barchart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barchart.d.ts","sourceRoot":"","sources":["../../../../../lib/Canvas/utils/Charts/barchart.ts"],"names":[],"mappings":"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"}