@chartgpu/chartgpu 0.2.5

package/dist/types/ChartGPU.d.ts

@@ -0,0 +1,99 @@
+import type { ChartGPUOptions, DataPoint, OHLCDataPoint } from './config/types';
+import type { PerformanceMetrics, PerformanceCapabilities } from './config/types';
+export interface ChartGPUInstance {
+    readonly options: Readonly<ChartGPUOptions>;
+    readonly disposed: boolean;
+    setOption(options: ChartGPUOptions): void;
+    /**
+     * Appends new points to a cartesian series at runtime (streaming).
+     *
+     * For candlestick series, pass `OHLCDataPoint[]`.
+     * For other cartesian series (line, area, bar, scatter), pass `DataPoint[]`.
+     * Pie series are non-cartesian and are not supported by streaming append.
+     */
+    appendData(seriesIndex: number, newPoints: DataPoint[] | OHLCDataPoint[]): void;
+    resize(): void;
+    dispose(): void;
+    on(eventName: 'crosshairMove', callback: ChartGPUCrosshairMoveCallback): void;
+    on(eventName: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    off(eventName: 'crosshairMove', callback: ChartGPUCrosshairMoveCallback): void;
+    off(eventName: ChartGPUEventName, callback: ChartGPUEventCallback): void;
+    /**
+     * Gets the current “interaction x” in domain units (or `null` when inactive).
+     *
+     * This is derived from pointer movement inside the plot grid and can also be driven
+     * externally via `setInteractionX(...)` (e.g. chart sync).
+     */
+    getInteractionX(): number | null;
+    /**
+     * Drives the chart’s crosshair + tooltip from a domain-space x value.
+     *
+     * Passing `null` clears the interaction (hides crosshair/tooltip).
+     */
+    setInteractionX(x: number | null, source?: unknown): void;
+    /**
+     * Alias for `setInteractionX(...)` for chart sync semantics.
+     */
+    setCrosshairX(x: number | null, source?: unknown): void;
+    /**
+     * Subscribes to interaction x changes (domain units).
+     *
+     * Returns an unsubscribe function.
+     */
+    onInteractionXChange(callback: (x: number | null, source?: unknown) => void): () => void;
+    /**
+     * Returns the current percent-space zoom window (or `null` when zoom is disabled).
+     */
+    getZoomRange(): Readonly<{
+        start: number;
+        end: number;
+    }> | null;
+    /**
+     * Sets the percent-space zoom window.
+     *
+     * No-op when zoom is disabled.
+     */
+    setZoomRange(start: number, end: number): void;
+    /**
+     * Gets the latest performance metrics.
+     * Returns exact FPS and detailed frame statistics.
+     *
+     * @returns Current performance metrics, or null if not available
+     */
+    getPerformanceMetrics(): Readonly<PerformanceMetrics> | null;
+    /**
+     * Gets the performance capabilities of the current environment.
+     * Indicates which performance features are supported.
+     *
+     * @returns Performance capabilities, or null if not initialized
+     */
+    getPerformanceCapabilities(): Readonly<PerformanceCapabilities> | null;
+    /**
+     * Registers a callback to be notified of performance metric updates.
+     * Callback is invoked every frame with the latest metrics.
+     *
+     * @param callback - Function to call with updated metrics
+     * @returns Unsubscribe function to remove the callback
+     */
+    onPerformanceUpdate(callback: (metrics: Readonly<PerformanceMetrics>) => void): () => void;
+}
+export type ChartGPU = ChartGPUInstance;
+export type ChartGPUEventName = 'click' | 'mouseover' | 'mouseout' | 'crosshairMove';
+export type ChartGPUEventPayload = Readonly<{
+    readonly seriesIndex: number | null;
+    readonly dataIndex: number | null;
+    readonly value: readonly [number, number] | null;
+    readonly seriesName: string | null;
+    readonly event: PointerEvent;
+}>;
+export type ChartGPUCrosshairMovePayload = Readonly<{
+    readonly x: number | null;
+    readonly source?: unknown;
+}>;
+export type ChartGPUEventCallback = (payload: ChartGPUEventPayload) => void;
+export type ChartGPUCrosshairMoveCallback = (payload: ChartGPUCrosshairMovePayload) => void;
+export declare function createChartGPU(container: HTMLElement, options: ChartGPUOptions): Promise<ChartGPUInstance>;
+export declare const ChartGPU: {
+    create: typeof createChartGPU;
+};
+//# sourceMappingURL=ChartGPU.d.ts.map

package/dist/types/ChartGPU.d.ts.map

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

package/dist/types/components/createDataZoomSlider.d.ts

@@ -0,0 +1,14 @@
+import type { ZoomState } from '../interaction/createZoomState';
+import type { ThemeConfig } from '../themes/types';
+export interface DataZoomSlider {
+    update(theme: ThemeConfig): void;
+    dispose(): void;
+}
+export interface DataZoomSliderOptions {
+    readonly height?: number;
+    readonly marginTop?: number;
+    readonly zIndex?: number;
+    readonly showPreview?: boolean;
+}
+export declare function createDataZoomSlider(container: HTMLElement, zoomState: ZoomState, options?: DataZoomSliderOptions): DataZoomSlider;
+//# sourceMappingURL=createDataZoomSlider.d.ts.map

package/dist/types/components/createDataZoomSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDataZoomSlider.d.ts","sourceRoot":"","sources":["../../../src/components/createDataZoomSlider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAgBD,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,EACtB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CA+RhB"}

package/dist/types/components/createLegend.d.ts

@@ -0,0 +1,9 @@
+import type { SeriesConfig } from '../config/types';
+import type { ThemeConfig } from '../themes/types';
+export type LegendPosition = 'top' | 'bottom' | 'left' | 'right';
+export interface Legend {
+    update(series: ReadonlyArray<SeriesConfig>, theme: ThemeConfig): void;
+    dispose(): void;
+}
+export declare function createLegend(container: HTMLElement, position?: LegendPosition): Legend;
+//# sourceMappingURL=createLegend.d.ts.map

package/dist/types/components/createLegend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLegend.d.ts","sourceRoot":"","sources":["../../../src/components/createLegend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,MAAM;IACrB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACtE,OAAO,IAAI,IAAI,CAAC;CACjB;AAwCD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,QAAQ,GAAE,cAAwB,GACjC,MAAM,CA0KR"}

package/dist/types/components/createTextOverlay.d.ts

@@ -0,0 +1,17 @@
+export type TextOverlayAnchor = 'start' | 'middle' | 'end';
+export interface TextOverlayLabelOptions {
+    readonly fontSize?: number;
+    readonly color?: string;
+    readonly anchor?: TextOverlayAnchor;
+    /**
+     * Rotation in degrees (CSS `rotate(<deg>deg)`).
+     */
+    readonly rotation?: number;
+}
+export interface TextOverlay {
+    clear(): void;
+    addLabel(text: string, x: number, y: number, options?: TextOverlayLabelOptions): HTMLSpanElement;
+    dispose(): void;
+}
+export declare function createTextOverlay(container: HTMLElement): TextOverlay;
+//# sourceMappingURL=createTextOverlay.d.ts.map

package/dist/types/components/createTextOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTextOverlay.d.ts","sourceRoot":"","sources":["../../../src/components/createTextOverlay.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,uBAAuB,GAChC,eAAe,CAAC;IACnB,OAAO,IAAI,IAAI,CAAC;CACjB;AAeD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAiFrE"}

package/dist/types/components/createTooltip.d.ts

@@ -0,0 +1,12 @@
+export interface Tooltip {
+    /**
+     * Show tooltip at container-local CSS pixel coordinates.
+     *
+     * `content` is treated as HTML (assigned via `innerHTML`).
+     */
+    show(x: number, y: number, content: string): void;
+    hide(): void;
+    dispose(): void;
+}
+export declare function createTooltip(container: HTMLElement): Tooltip;
+//# sourceMappingURL=createTooltip.d.ts.map

package/dist/types/components/createTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/createTooltip.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;CACjB;AASD,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAsL7D"}

package/dist/types/components/formatTooltip.d.ts

@@ -0,0 +1,19 @@
+import type { TooltipParams } from '../config/types';
+/**
+ * Default tooltip formatter for candlestick series in item mode.
+ * Renders O/H/L/C values with colored arrow and percentage change.
+ */
+export declare function formatCandlestickTooltip(params: TooltipParams): string;
+/**
+ * Default tooltip formatter for item mode.
+ * Returns a compact single-row HTML snippet: dot + series name + y value.
+ * For candlestick series, returns O/H/L/C with arrow and percentage change.
+ */
+export declare function formatTooltipItem(params: TooltipParams): string;
+/**
+ * Default tooltip formatter for axis mode.
+ * Renders an x header line then one row per series with the y value.
+ * Candlestick series show O/H/L/C values with arrow and percentage change.
+ */
+export declare function formatTooltipAxis(params: TooltipParams[]): string;
+//# sourceMappingURL=formatTooltip.d.ts.map

package/dist/types/components/formatTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatTooltip.d.ts","sourceRoot":"","sources":["../../../src/components/formatTooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAqIrD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAkBjE"}

package/dist/types/config/OptionResolver.d.ts

@@ -0,0 +1,134 @@
+import type { AreaStyleConfig, AxisConfig, CandlestickItemStyleConfig, CandlestickSeriesConfig, CandlestickStyle, ChartGPUOptions, GridConfig, LineStyleConfig, AreaSeriesConfig, BarSeriesConfig, LineSeriesConfig, PieDataItem, PieSeriesConfig, ScatterSeriesConfig, SeriesSampling } from './types';
+import type { ThemeConfig } from '../themes/types';
+export type ResolvedGridConfig = Readonly<Required<GridConfig>>;
+export type ResolvedLineStyleConfig = Readonly<Required<Omit<LineStyleConfig, 'color'>> & {
+    readonly color: string;
+}>;
+export type ResolvedAreaStyleConfig = Readonly<Required<Omit<AreaStyleConfig, 'color'>> & {
+    readonly color: string;
+}>;
+export type RawBounds = Readonly<{
+    xMin: number;
+    xMax: number;
+    yMin: number;
+    yMax: number;
+}>;
+export type ResolvedLineSeriesConfig = Readonly<Omit<LineSeriesConfig, 'color' | 'lineStyle' | 'areaStyle' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly lineStyle: ResolvedLineStyleConfig;
+    readonly areaStyle?: ResolvedAreaStyleConfig;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /**
+     * Original (unsampled) series data.
+     *
+     * Used at runtime for zoom-aware re-sampling so we can increase detail when zoomed-in without
+     * losing outliers or permanently discarding points.
+     */
+    readonly rawData: Readonly<LineSeriesConfig['data']>;
+    readonly data: Readonly<LineSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedAreaSeriesConfig = Readonly<Omit<AreaSeriesConfig, 'color' | 'areaStyle' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly areaStyle: ResolvedAreaStyleConfig;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<AreaSeriesConfig['data']>;
+    readonly data: Readonly<AreaSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedBarSeriesConfig = Readonly<Omit<BarSeriesConfig, 'color' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<BarSeriesConfig['data']>;
+    readonly data: Readonly<BarSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedScatterSeriesConfig = Readonly<Omit<ScatterSeriesConfig, 'color' | 'sampling' | 'samplingThreshold' | 'data' | 'mode' | 'binSize' | 'densityColormap' | 'densityNormalization'> & {
+    readonly color: string;
+    readonly sampling: SeriesSampling;
+    readonly samplingThreshold: number;
+    readonly mode: NonNullable<ScatterSeriesConfig['mode']>;
+    readonly binSize: number;
+    readonly densityColormap: NonNullable<ScatterSeriesConfig['densityColormap']>;
+    readonly densityNormalization: NonNullable<ScatterSeriesConfig['densityNormalization']>;
+    /** Original (unsampled) series data (see `ResolvedLineSeriesConfig.rawData`). */
+    readonly rawData: Readonly<ScatterSeriesConfig['data']>;
+    readonly data: Readonly<ScatterSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedPieDataItem = Readonly<Omit<PieDataItem, 'color'> & {
+    readonly color: string;
+}>;
+export type ResolvedPieSeriesConfig = Readonly<Omit<PieSeriesConfig, 'color' | 'data'> & {
+    readonly color: string;
+    readonly data: ReadonlyArray<ResolvedPieDataItem>;
+}>;
+export type ResolvedCandlestickItemStyleConfig = Readonly<Required<CandlestickItemStyleConfig>>;
+export type ResolvedCandlestickSeriesConfig = Readonly<Omit<CandlestickSeriesConfig, 'color' | 'style' | 'itemStyle' | 'barWidth' | 'barMinWidth' | 'barMaxWidth' | 'sampling' | 'samplingThreshold' | 'data'> & {
+    readonly color: string;
+    readonly style: CandlestickStyle;
+    readonly itemStyle: ResolvedCandlestickItemStyleConfig;
+    readonly barWidth: number | string;
+    readonly barMinWidth: number;
+    readonly barMaxWidth: number;
+    readonly sampling: 'none' | 'ohlc';
+    readonly samplingThreshold: number;
+    /** Original (unsampled) series data. */
+    readonly rawData: Readonly<CandlestickSeriesConfig['data']>;
+    readonly data: Readonly<CandlestickSeriesConfig['data']>;
+    /**
+     * Bounds computed from the original (unsampled) data. Used for axis auto-bounds so sampling
+     * cannot clip outliers.
+     */
+    readonly rawBounds?: RawBounds;
+}>;
+export type ResolvedSeriesConfig = ResolvedLineSeriesConfig | ResolvedAreaSeriesConfig | ResolvedBarSeriesConfig | ResolvedScatterSeriesConfig | ResolvedPieSeriesConfig | ResolvedCandlestickSeriesConfig;
+export interface ResolvedChartGPUOptions extends Omit<ChartGPUOptions, 'grid' | 'xAxis' | 'yAxis' | 'theme' | 'palette' | 'series'> {
+    readonly grid: ResolvedGridConfig;
+    readonly xAxis: AxisConfig;
+    readonly yAxis: AxisConfig;
+    readonly autoScroll: boolean;
+    readonly theme: ThemeConfig;
+    readonly palette: ReadonlyArray<string>;
+    readonly series: ReadonlyArray<ResolvedSeriesConfig>;
+}
+export declare function resolveOptions(userOptions?: ChartGPUOptions): ResolvedChartGPUOptions;
+/**
+ * Resolves chart options with slider bottom-space reservation.
+ *
+ * This function wraps `resolveOptions()` and applies additional grid bottom spacing
+ * when a slider-type dataZoom is configured. The reservation ensures x-axis labels
+ * and ticks are visible above the slider overlay.
+ *
+ * **Usage**: Use this function instead of `resolveOptions()` when creating charts
+ * (both main-thread and worker-based) to ensure consistent slider layout.
+ *
+ * @param userOptions - User-provided chart options
+ * @returns Resolved options with slider bottom-space applied if needed
+ */
+export declare function resolveOptionsForChart(userOptions?: ChartGPUOptions): ResolvedChartGPUOptions;
+export declare const OptionResolver: {
+    readonly resolve: typeof resolveOptions;
+};
+//# sourceMappingURL=OptionResolver.d.ts.map

package/dist/types/config/OptionResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionResolver.d.ts","sourceRoot":"","sources":["../../../src/config/OptionResolver.ts"],"names":[],"mappings":"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"}

package/dist/types/config/defaults.d.ts

@@ -0,0 +1,55 @@
+import type { CandlestickStyle } from './types';
+export declare const defaultGrid: {
+    readonly left: 60;
+    readonly right: 20;
+    readonly top: 40;
+    readonly bottom: 40;
+};
+export declare const defaultPalette: readonly ["#5470C6", "#91CC75", "#FAC858", "#EE6666", "#73C0DE", "#3BA272", "#FC8452", "#9A60B4", "#EA7CCC"];
+export declare const defaultLineStyle: {
+    readonly width: 2;
+    readonly opacity: 1;
+};
+export declare const defaultAreaStyle: {
+    readonly opacity: 0.25;
+};
+export declare const candlestickDefaults: {
+    readonly style: CandlestickStyle;
+    readonly itemStyle: {
+        readonly upColor: "#22c55e";
+        readonly downColor: "#ef4444";
+        readonly upBorderColor: "#22c55e";
+        readonly downBorderColor: "#ef4444";
+        readonly borderWidth: 1;
+    };
+    readonly barWidth: "80%";
+    readonly barMinWidth: 1;
+    readonly barMaxWidth: 50;
+    readonly sampling: "ohlc";
+    readonly samplingThreshold: 5000;
+};
+export declare const scatterDefaults: {
+    readonly mode: "points";
+    readonly binSize: 2;
+    readonly densityColormap: "viridis";
+    readonly densityNormalization: "log";
+};
+export declare const defaultOptions: {
+    readonly grid: {
+        readonly left: 60;
+        readonly right: 20;
+        readonly top: 40;
+        readonly bottom: 40;
+    };
+    readonly xAxis: {
+        readonly type: "value";
+    };
+    readonly yAxis: {
+        readonly type: "value";
+    };
+    readonly autoScroll: false;
+    readonly theme: "dark";
+    readonly palette: readonly ["#5470C6", "#91CC75", "#FAC858", "#EE6666", "#73C0DE", "#3BA272", "#FC8452", "#9A60B4", "#EA7CCC"];
+    readonly series: readonly [];
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/types/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,WAAW;;;;;CAKiB,CAAC;AAE1C,eAAO,MAAM,cAAc,8GAUjB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;CAGgC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;CAEgC,CAAC;AAE9D,eAAO,MAAM,mBAAmB;oBACV,gBAAgB;;;;;;;;;;;;;CAa5B,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAY1B,CAAC"}