captify 0.1.17 → 0.1.19

package/dist/charts/charts.constants.js

@@ -0,0 +1,407 @@
+/**
+ * Charts module constants
+ *
+ * Constants for chart configuration including default colors,
+ * dimensions, and error messages.
+ *
+ * Note: Type definitions (ChartType) are in charts.schemas.ts.
+ */
+// ============================================================================
+// Default Color Palette
+// ============================================================================
+/**
+ * Default chart colors (Tailwind-inspired palette).
+ * These colors are designed for good contrast and accessibility.
+ */
+export const DEFAULT_CHART_COLORS = [
+    "#3b82f6", // blue-500
+    "#10b981", // emerald-500
+    "#f59e0b", // amber-500
+    "#ef4444", // red-500
+    "#8b5cf6", // violet-500
+    "#06b6d4", // cyan-500
+    "#f97316", // orange-500
+    "#84cc16", // lime-500
+    "#ec4899", // pink-500
+    "#14b8a6", // teal-500
+];
+/**
+ * Theme-aware CSS variable colors for chart elements.
+ * These adapt automatically to light/dark mode.
+ */
+export const CHART_THEME_COLORS = {
+    /** Primary text color for labels and values */
+    FOREGROUND: "var(--foreground)",
+    /** Secondary/muted text color for axis labels */
+    MUTED_FOREGROUND: "var(--muted-foreground)",
+    /** Border and axis line color */
+    BORDER: "var(--border)",
+    /** Background color for contrast elements (e.g., cell strokes) */
+    BACKGROUND: "var(--background)",
+    /** Muted background for hover states */
+    MUTED: "var(--muted)",
+};
+// ============================================================================
+// Chart Dimension Defaults
+// ============================================================================
+/**
+ * Default chart dimensions and margins.
+ */
+export const CHART_DEFAULTS = {
+    /** Default chart height in pixels */
+    HEIGHT: 300,
+    /** Default margins for chart area */
+    MARGIN: {
+        top: 20,
+        right: 30,
+        bottom: 20,
+        left: 40,
+    },
+    /** Animation duration in milliseconds */
+    ANIMATION_DURATION: 400,
+};
+/**
+ * Pie chart specific defaults.
+ */
+export const PIE_CHART_DEFAULTS = {
+    /** Inner radius for donut charts (0 for solid pie) */
+    INNER_RADIUS: 0,
+    /** Outer radius as percentage of container */
+    OUTER_RADIUS: "80%",
+    /** Padding angle between slices */
+    PADDING_ANGLE: 2,
+};
+/**
+ * Radar chart specific defaults.
+ */
+export const RADAR_CHART_DEFAULTS = {
+    /** Outer radius as percentage of container */
+    OUTER_RADIUS: "80%",
+    /** Fill opacity for radar areas */
+    FILL_OPACITY: 0.3,
+    /** Stroke width for radar lines */
+    STROKE_WIDTH: 2,
+    /** Dot radius */
+    DOT_RADIUS: 4,
+    /** Angle at which the radius axis is displayed (in degrees) */
+    RADIUS_AXIS_ANGLE: 0,
+};
+/**
+ * Radial bar chart specific defaults.
+ */
+export const RADIAL_BAR_CHART_DEFAULTS = {
+    /** Inner radius in pixels */
+    INNER_RADIUS: 30,
+    /** Outer radius as percentage of container */
+    OUTER_RADIUS: "80%",
+    /** Start angle in degrees */
+    START_ANGLE: 90,
+    /** End angle in degrees */
+    END_ANGLE: -270,
+    /** Bar size */
+    BAR_SIZE: 12,
+    /** Corner radius for bars */
+    CORNER_RADIUS: 5,
+};
+/**
+ * Scatter chart specific defaults.
+ */
+export const SCATTER_CHART_DEFAULTS = {
+    /** Default point size */
+    POINT_SIZE: 60,
+};
+/**
+ * Treemap chart specific defaults.
+ */
+export const TREEMAP_CHART_DEFAULTS = {
+    /** Default aspect ratio (width/height) */
+    ASPECT_RATIO: 4 / 3,
+    /** Stroke color for treemap cells */
+    STROKE: CHART_THEME_COLORS.BACKGROUND,
+    /** Stroke width for treemap cells */
+    STROKE_WIDTH: 2,
+};
+// ============================================================================
+// Chart Display Options
+// ============================================================================
+/**
+ * Default display options for each chart type.
+ */
+export const CHART_DISPLAY_DEFAULTS = {
+    line: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    bar: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    pie: {
+        showLegend: true,
+        showGrid: false,
+        showTooltip: true,
+        animate: true,
+    },
+    area: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    composed: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    scatter: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    radar: {
+        showLegend: true,
+        showGrid: true,
+        showTooltip: true,
+        animate: true,
+    },
+    radialBar: {
+        showLegend: true,
+        showGrid: false,
+        showTooltip: true,
+        animate: true,
+    },
+    treemap: {
+        showLegend: false,
+        showGrid: false,
+        showTooltip: true,
+        animate: true,
+    },
+};
+// ============================================================================
+// Error Messages
+// ============================================================================
+/**
+ * Error messages for chart operations.
+ */
+export const CHART_ERROR_MESSAGES = {
+    // Specification errors
+    INVALID_SPEC: "Invalid chart specification",
+    INVALID_CHART_TYPE: "Invalid chart type. Must be line, bar, pie, area, composed, scatter, radar, radialBar, or treemap.",
+    MISSING_X_KEY: "X-axis key (xKey) is required for cartesian charts",
+    MISSING_Y_KEYS: "At least one Y-axis key (yKeys) is required",
+    MISSING_VALUE_KEY: "Value key (valueKey) is required for pie and radialBar charts",
+    MISSING_COMPOSED_SERIES: "Composed series configuration is required for composed charts",
+    // Data errors
+    NO_DATA: "No data available for chart",
+    INVALID_DATA: "Invalid data format",
+    EMPTY_DATA: "Data array is empty",
+    // Rendering errors
+    RENDER_FAILED: "Failed to render chart",
+    UNSUPPORTED_CHART_TYPE: "Unsupported chart type",
+};
+// ============================================================================
+// Tooltip & Legend Configuration
+// ============================================================================
+/**
+ * Tooltip configuration defaults.
+ * Uses inverted colors (foreground as background, background as text)
+ * for consistent visibility that adapts to light/dark themes.
+ */
+export const TOOLTIP_DEFAULTS = {
+    /** Tooltip cursor style */
+    CURSOR_STYLE: { fill: CHART_THEME_COLORS.MUTED, opacity: 0.1 },
+};
+/**
+ * Legend configuration defaults.
+ */
+export const LEGEND_DEFAULTS = {
+    /** Legend position */
+    VERTICAL_ALIGN: "bottom",
+    /** Legend alignment */
+    ALIGN: "center",
+    /** Height of legend area */
+    HEIGHT: 36,
+    /** Wrapper style */
+    WRAPPER_STYLE: { paddingTop: "10px" },
+};
+// ============================================================================
+// Grid Configuration
+// ============================================================================
+/**
+ * Grid configuration defaults.
+ */
+export const GRID_DEFAULTS = {
+    /** Stroke color for grid lines */
+    STROKE: CHART_THEME_COLORS.MUTED_FOREGROUND,
+    /** Stroke dash array for grid lines */
+    STROKE_DASH_ARRAY: "3 3",
+    /** Horizontal grid lines */
+    HORIZONTAL: true,
+    /** Vertical grid lines */
+    VERTICAL: false,
+};
+// ============================================================================
+// Rendering Defaults (Non-Classname)
+// ============================================================================
+/** Shared axis styling defaults for cartesian charts. */
+export const CARTESIAN_AXIS_DEFAULTS = {
+    TICK_FONT_SIZE: 12,
+    TICK_MARGIN: 8,
+    AXIS_LINE_STROKE: "currentColor",
+    Y_AXIS_WIDTH: 60,
+    X_AXIS_LABEL_POSITION: "bottom",
+    X_AXIS_TEXT_ANCHOR: "end",
+    Y_AXIS_LABEL_ANGLE: -90,
+    Y_AXIS_LABEL_POSITION: "insideLeft",
+};
+/** Shared cartesian series styling defaults (line/area/composed). */
+export const CARTESIAN_SERIES_DEFAULTS = {
+    LINE_TYPE: "monotone",
+    STROKE_WIDTH: 2,
+    AREA_FILL_OPACITY: 0.3,
+    DOT_RADIUS: 4,
+    ACTIVE_DOT_RADIUS: 6,
+    DOT_STROKE_WIDTH: 2,
+    BAR_RADIUS: [4, 4, 0, 0],
+    MAX_BAR_SIZE: 60,
+};
+/** Common field name defaults used across chart types. */
+export const CHART_KEY_DEFAULTS = {
+    VALUE: "value",
+    NAME: "name",
+};
+/** Shared label/text defaults used for fallbacks. */
+export const CHART_LABEL_DEFAULTS = {
+    ITEM_PREFIX: "Item",
+    INDEX_OFFSET: 1,
+};
+/** Shared chart center position for radial charts (pie/radar/radialBar). */
+export const RADIAL_CENTER_DEFAULTS = {
+    CX: "50%",
+    CY: "50%",
+};
+/** Defaults specific to radar chart rendering. */
+export const RADAR_RENDER_DEFAULTS = {
+    GRID_STROKE_OPACITY: 0.5,
+    ANGLE_AXIS_TICK_FONT_SIZE: 12,
+    RADIUS_AXIS_TICK_FONT_SIZE: 10,
+    DOT_STROKE_WIDTH: 2,
+};
+/** Defaults specific to scatter chart rendering. */
+export const SCATTER_RENDER_DEFAULTS = {
+    DEFAULT_X_KEY: "x",
+    DEFAULT_Y_AXIS_LABEL: "Value",
+    AUTO_DOMAIN: ["auto", "auto"],
+    DOMAIN_PADDING_RATIO: 0.1,
+    DOMAIN_PADDING_FALLBACK: 1,
+    TOOLTIP_CURSOR_STYLE: { strokeDasharray: GRID_DEFAULTS.STROKE_DASH_ARRAY },
+};
+/** Defaults specific to pie chart rendering. */
+export const PIE_RENDER_DEFAULTS = {
+    LABEL_PERCENT_MULTIPLIER: 100,
+    LABEL_PERCENT_DECIMALS: 0,
+    LABEL_DEFAULT_PERCENT: 0,
+    LABEL_SEPARATOR: ": ",
+    LABEL_SUFFIX: "%",
+    LABEL_LINE_STROKE_WIDTH: 1,
+    CELL_KEY_PREFIX: "cell-",
+    CELL_STROKE_WIDTH: 2,
+};
+/** Defaults specific to radial bar chart rendering. */
+export const RADIAL_BAR_RENDER_DEFAULTS = {
+    LABEL_POSITION: "insideStart",
+    LABEL_FONT_SIZE: 10,
+};
+/** Defaults specific to treemap chart rendering. */
+export const TREEMAP_RENDER_DEFAULTS = {
+    ROOT_CHILD_COUNT_FALLBACK: 1,
+    TOP_LEVEL_DEPTH_THRESHOLD: 2,
+    LEAF_TEXT_MIN_WIDTH: 50,
+    LEAF_TEXT_MIN_HEIGHT: 30,
+    LEAF_VALUE_MIN_WIDTH: 60,
+    LEAF_VALUE_MIN_HEIGHT: 45,
+    LEAF_NAME_TRUNCATE_MAX_LENGTH: 15,
+    LEAF_NAME_TRUNCATE_SLICE_LENGTH: 12,
+    LEAF_TEXT_SHADOW: "0 1px 2px rgba(0,0,0,0.3)",
+    LEAF_NAME_FONT_SIZE: 12,
+    LEAF_VALUE_FONT_SIZE: 11,
+    LEAF_NAME_Y_VALUE_OFFSET: 8,
+    LEAF_VALUE_Y_OFFSET: 12,
+    TRANSPARENT_FILL: "transparent",
+};
+// ============================================================================
+// i18n / Formatting Defaults
+// ============================================================================
+export const CHART_I18N = {
+    LOCALE: "en-US",
+};
+export const CHART_NUMBER_FORMAT_DEFAULTS = {
+    DECIMALS: 2,
+    COMPACT_THRESHOLD: 1000,
+    MIN_FRACTION_DIGITS: 0,
+};
+/** Common math constants used by chart services/rendering. */
+export const CHART_MATH_DEFAULTS = {
+    ZERO: 0,
+    PERCENT_MULTIPLIER: 100,
+};
+/** Display names for chart types, used in accessibility summaries. */
+export const CHART_TYPE_DISPLAY_NAMES = {
+    line: "Line",
+    bar: "Bar",
+    pie: "Pie",
+    area: "Area",
+    composed: "Composed",
+    scatter: "Scatter",
+    radar: "Radar",
+    radialBar: "Radial Bar",
+    treemap: "Treemap",
+};
+// ============================================================================
+// Agent Tool Prompts
+// ============================================================================
+/** Base description text for the AI SDK chart tool. Context is appended at runtime. */
+export const CHART_TOOL_BASE_DESCRIPTION = `Create interactive data visualizations from datasets.
+
+Chart Types:
+- "line": Time series data, trends over time, continuous data
+- "bar": Categorical comparisons, discrete values, rankings
+- "pie": Part-to-whole relationships, proportions, distributions
+- "area": Filled line charts, cumulative data, volume over time
+- "composed": Multiple chart types combined (line + bar + area)
+- "scatter": Correlation between two variables, data point distribution
+- "radar": Multi-dimensional data comparison, skill/attribute profiles
+- "radialBar": Circular progress bars, percentage comparisons
+- "treemap": Hierarchical data, nested proportions, space utilization
+
+Required Fields (by chart type):
+- All: type
+- Cartesian (line/bar/area/scatter): xKey + yKeys
+- Pie/RadialBar: valueKey + nameKey (or yKeys[0]/xKey fallback)
+- Composed: xKey + composedSeries
+- Treemap: dataKey + nameKey (or valueKey/yKeys[0]/xKey fallback)
+
+Data Input:
+- "data": Provide raw data array directly
+  Example: [{"month": "Jan", "sales": 100}, {"month": "Feb", "sales": 150}]
+
+  To chart data from the database, first use the dynamoDb tool to query the data,
+  then pass the results to this chart tool via the "data" parameter.
+
+Optional Fields:
+- title: Chart title
+- subtitle: Chart description
+- series: Array of {dataKey, label, color} for custom series styling
+- height: Chart height in pixels (100-800, default: 300)
+- showLegend: Show/hide legend (default: true)
+- showGrid: Show/hide grid lines (default: true for line/bar)
+- showTooltip: Show/hide tooltip on hover (default: true)
+- colors: Custom color palette array
+`;
+//# sourceMappingURL=charts.constants.js.map

package/dist/charts/charts.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.constants.js","sourceRoot":"","sources":["../../lib/charts/charts.constants.ts"],"names":[],"mappings":"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"}

package/dist/charts/charts.interfaces.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Charts module interfaces
+ *
+ * TypeScript interfaces for chart configuration and rendering.
+ * This module contains component props and service-specific interfaces.
+ *
+ * Note: Entity types (ChartType, ChartSpecSchema, ChartDataPointSchema, etc.)
+ * are derived from Zod schemas in charts.schemas.ts - import them from there.
+ */
+import type { ChartDataPointSchema, ChartSpecSchema } from "./charts.schemas";
+/**
+ * Marker interface for chart tool output.
+ * This is a serializable object that tool UIs can detect and render as a chart.
+ */
+export interface ChartToolOutput {
+    __type: "chart";
+    spec: ChartSpecSchema;
+    data: ChartDataPointSchema[];
+}
+/**
+ * Props for ChartWrapper component.
+ * Main entry point for rendering charts.
+ */
+export interface ChartWrapperProps {
+    /** Chart specification */
+    spec: ChartSpecSchema;
+    /** Data to render */
+    data: ChartDataPointSchema[];
+    /** Additional CSS classes */
+    className?: string;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Error state */
+    error?: Error | null;
+}
+/**
+ * Props for individual chart type components (internal).
+ */
+export interface ChartContentProps {
+    /** Chart specification */
+    spec: ChartSpecSchema;
+    /** Data to render */
+    data: ChartDataPointSchema[];
+}
+/**
+ * Props for ChartSkeleton component.
+ */
+export interface ChartSkeletonProps {
+    /** Height of the skeleton in pixels */
+    height?: number;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Props for ChartError component.
+ */
+export interface ChartErrorProps {
+    /** Error message to display */
+    message: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Props for ChartEmpty component.
+ */
+export interface ChartEmptyProps {
+    /** Message to display when no data */
+    message?: string;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Entry in tooltip payload array.
+ * Represents a single data point in the tooltip.
+ */
+export interface TooltipPayloadEntry {
+    /** The value of the data point */
+    value?: number | string;
+    /** The name/label of the series */
+    name?: string;
+    /** The data key used to extract the value */
+    dataKey?: string | number;
+    /** The color associated with this series */
+    color?: string;
+}
+/**
+ * Props for ChartTooltip component.
+ * Custom tooltip component for Recharts.
+ */
+export interface ChartTooltipProps {
+    /** Whether the tooltip is active/visible */
+    active?: boolean;
+    /** Array of data entries to display */
+    payload?: TooltipPayloadEntry[];
+    /** The label for the tooltip (typically x-axis value) */
+    label?: string | number;
+    /** Custom formatter for the label */
+    labelFormatter?: (label: string) => string;
+}
+/**
+ * Props for TreemapContent component.
+ * Used for custom rendering of treemap cells.
+ */
+export interface TreemapContentProps {
+    /** X position of the cell */
+    x: number;
+    /** Y position of the cell */
+    y: number;
+    /** Width of the cell */
+    width: number;
+    /** Height of the cell */
+    height: number;
+    /** Name/label of the cell */
+    name: string;
+    /** Value of the cell */
+    value: number;
+    /** Index of the cell in the data array */
+    index: number;
+    /** Array of colors for the treemap */
+    colors: string[];
+    /** Depth level in the hierarchy (0 = root, 1 = top-level items, 2+ = nested) */
+    depth: number;
+    /** Reference to the tree root node (used for proportional calculations like color distribution) */
+    root?: {
+        children?: ReadonlyArray<unknown>;
+    };
+    /** Children of the current node - null/undefined/empty for leaf nodes */
+    children?: ReadonlyArray<unknown> | null;
+}
+//# sourceMappingURL=charts.interfaces.d.ts.map

package/dist/charts/charts.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.interfaces.d.ts","sourceRoot":"","sources":["../../lib/charts/charts.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAMD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,qBAAqB;IACrB,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAC7B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,qBAAqB;IACrB,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,qCAAqC;IACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C"}

package/dist/charts/charts.interfaces.js

@@ -0,0 +1,11 @@
+/**
+ * Charts module interfaces
+ *
+ * TypeScript interfaces for chart configuration and rendering.
+ * This module contains component props and service-specific interfaces.
+ *
+ * Note: Entity types (ChartType, ChartSpecSchema, ChartDataPointSchema, etc.)
+ * are derived from Zod schemas in charts.schemas.ts - import them from there.
+ */
+export {};
+//# sourceMappingURL=charts.interfaces.js.map

package/dist/charts/charts.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.interfaces.js","sourceRoot":"","sources":["../../lib/charts/charts.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}