@synergy-design-system/components 3.15.6 → 3.16.0

package/dist/components/button-group/button-group.component.js

@@ -1,16 +1,16 @@
 import {
   SynButtonGroup
-} from "../../chunks/chunk.N3B52ZU7.js";
+} from "../../chunks/chunk.HMQ7L5C5.js";
 import "../../chunks/chunk.34RGILSE.js";
 import "../../chunks/chunk.CX7IEDUW.js";
-import "../../chunks/chunk.4I2RJVH5.js";
-import "../../chunks/chunk.Z4QAGMQF.js";
-import "../../chunks/chunk.PTC76IOL.js";
+import "../../chunks/chunk.L3E7LAEB.js";
+import "../../chunks/chunk.WCUWW5GN.js";
+import "../../chunks/chunk.BNSX6OTG.js";
 import "../../chunks/chunk.JIHDB74M.js";
-import "../../chunks/chunk.QDG5AJZX.js";
+import "../../chunks/chunk.W4CT6NKC.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   SynButtonGroup as default
 };

package/dist/components/button-group/button-group.custom.styles.js

@@ -1,7 +1,7 @@
 import {
   button_group_custom_styles_default
 } from "../../chunks/chunk.34RGILSE.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   button_group_custom_styles_default as default
 };

package/dist/components/button-group/button-group.js

@@ -1,17 +1,17 @@
 import {
   button_group_default
-} from "../../chunks/chunk.DJIAGYRX.js";
-import "../../chunks/chunk.N3B52ZU7.js";
+} from "../../chunks/chunk.MK3YZ7NC.js";
+import "../../chunks/chunk.HMQ7L5C5.js";
 import "../../chunks/chunk.34RGILSE.js";
 import "../../chunks/chunk.CX7IEDUW.js";
-import "../../chunks/chunk.4I2RJVH5.js";
-import "../../chunks/chunk.Z4QAGMQF.js";
-import "../../chunks/chunk.PTC76IOL.js";
+import "../../chunks/chunk.L3E7LAEB.js";
+import "../../chunks/chunk.WCUWW5GN.js";
+import "../../chunks/chunk.BNSX6OTG.js";
 import "../../chunks/chunk.JIHDB74M.js";
-import "../../chunks/chunk.QDG5AJZX.js";
+import "../../chunks/chunk.W4CT6NKC.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   button_group_default as default
 };

package/dist/components/button-group/button-group.styles.js

@@ -1,7 +1,7 @@
 import {
   button_group_styles_default
 } from "../../chunks/chunk.CX7IEDUW.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   button_group_styles_default as default
 };

package/dist/components/card/card.component.js

@@ -1,11 +1,11 @@
 import {
   SynCard
-} from "../../chunks/chunk.H6Y2KI6V.js";
+} from "../../chunks/chunk.25Y2GDP4.js";
 import "../../chunks/chunk.QCHIEOZ2.js";
 import "../../chunks/chunk.CHFWLQN5.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   SynCard as default
 };

package/dist/components/card/card.js

@@ -1,12 +1,12 @@
 import {
   card_default
-} from "../../chunks/chunk.W4V4LBQ5.js";
-import "../../chunks/chunk.H6Y2KI6V.js";
+} from "../../chunks/chunk.6QFGQ5L2.js";
+import "../../chunks/chunk.25Y2GDP4.js";
 import "../../chunks/chunk.QCHIEOZ2.js";
 import "../../chunks/chunk.CHFWLQN5.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   card_default as default
 };

package/dist/components/card/card.styles.js

@@ -1,7 +1,7 @@
 import {
   card_styles_default
 } from "../../chunks/chunk.QCHIEOZ2.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   card_styles_default as default
 };

package/dist/components/chart/chart.component.d.ts

@@ -1,14 +1,14 @@
 import { type EChartsType } from 'echarts/core.js';
 import type { CSSResultGroup, PropertyValues } from 'lit';
 import SynergyElement from '../../internal/synergy-element.js';
-import { type SynChartPalette } from './chart.palettes.js';
-import type { ECConfig } from './types.js';
+import { type ChartPalette } from './chart.palettes.js';
+import type { ChartConfigType } from './types.js';
 /**
  * @summary The `<syn-chart>` component is a container for displaying charts. It provides a structured layout and styling for chart elements, allowing for consistent presentation across different types of charts. The chart component is based on [Apache ECharts](https://echarts.apache.org)
  *
  * @documentation https://synergy-design-system.github.io/?path=/docs/charting-syn-chart--docs
  * @status experimental
- * @since 0.0.0
+ * @since 3.15.0
  *
  * @csspart base - The component's base wrapper.
  */
@@ -17,30 +17,57 @@ export default class SynChart extends SynergyElement {
     private chartContainer;
     private chartInstance;
     private resizeObserver;
+    private resolvedConfig;
     /**
-     * The ECharts configuration option object.
+     * The ECharts configuration input.
      *
-     * This property maps 1:1 to the ECharts `option` parameter passed to `setOption()`.
+     * This property accepts either:
+     * - a plain `ECConfig` object, or
+     * - a callback that receives a typed preset handle and applies chart presets.
+     *
+     * The resolved result maps 1:1 to the ECharts `option` parameter passed to
+     * `setOption()`.
      * Consult the [ECharts option documentation](https://echarts.apache.org/en/option.html)
-     * and assign the object directly to this property.
+     * and assign either the object directly or build it through the handle.
      *
      * > **Note:** Currently only **line charts** (`series[].type: 'line'`) are supported.
      * > Support for additional chart types (bar, pie, etc.) will be added in future releases or can be requested.
      *
-     * Assigning a new object completely replaces the previous chart configuration (`notMerge: true`).
+     * Assigning a new config input completely replaces the previous chart
+     * configuration (`notMerge: true`).
      * To update only parts of the chart, access the underlying ECharts instance directly and
      * call `setOption()` with custom merge options.
      *
      * @example
      * ```js
+     * // Using a plain object
      * chart.config = {
      *   xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
      *   yAxis: { type: 'value' },
      *   series: [{ type: 'line', data: [150, 230, 224] }],
      * };
+     *
+     * // Using the handle with method chaining
+     * chart.config = (handle) => handle
+     *   .baseConfig({
+     *     xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
+     *     yAxis: { type: 'value' },
+     *     series: [{ type: 'line', data: [150, 230, 224] }],
+     *   })
+     *   .axesShowSplitLines();
+     *
+     * // Using the handle with sequential calls
+     * chart.config = (handle) => {
+     *   handle.baseConfig({
+     *     xAxis: { type: 'category', data: ['Mon', 'Tue', 'Wed'] },
+     *     yAxis: { type: 'value' },
+     *     series: [{ type: 'line', data: [150, 230, 224] }],
+     *   });
+     *   handle.axesShowSplitLines();
+     * };
      * ```
      */
-    config: ECConfig;
+    config: ChartConfigType;
     /**
      * The color palette to apply to chart series.
      *
@@ -53,10 +80,11 @@ export default class SynChart extends SynergyElement {
      * The palette sets the ECharts `color` array. If `config.color` is explicitly provided,
      * it takes precedence over the palette.
      */
-    palette: SynChartPalette;
+    palette: ChartPalette;
     /** Resolves palette CSS custom properties to computed color values and applies them to the chart. */
     private applyPalette;
     protected updated(changedProperties: PropertyValues<this>): void;
+    connectedCallback(): void;
     protected firstUpdated(_changedProperties: PropertyValues): void;
     disconnectedCallback(): void;
     /**

package/dist/components/chart/chart.component.js

@@ -1,11 +1,18 @@
 import {
   SynChart
-} from "../../chunks/chunk.4LPRLZEC.js";
-import "../../chunks/chunk.VJIXW4Z5.js";
+} from "../../chunks/chunk.LFO32QIM.js";
 import "../../chunks/chunk.KPO6RJLG.js";
+import "../../chunks/chunk.MLDHXUGM.js";
+import "../../chunks/chunk.JOYNXTII.js";
+import "../../chunks/chunk.UOCJ2U5N.js";
+import "../../chunks/chunk.FVE47CHN.js";
+import "../../chunks/chunk.VCDIUHSK.js";
+import "../../chunks/chunk.KMZLWOXI.js";
+import "../../chunks/chunk.DKVCRWJF.js";
+import "../../chunks/chunk.T3OQKYCT.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   SynChart as default
 };

package/dist/components/chart/chart.js

@@ -1,11 +1,18 @@
 import {
   SynChart
-} from "../../chunks/chunk.4LPRLZEC.js";
-import "../../chunks/chunk.VJIXW4Z5.js";
+} from "../../chunks/chunk.LFO32QIM.js";
 import "../../chunks/chunk.KPO6RJLG.js";
+import "../../chunks/chunk.MLDHXUGM.js";
+import "../../chunks/chunk.JOYNXTII.js";
+import "../../chunks/chunk.UOCJ2U5N.js";
+import "../../chunks/chunk.FVE47CHN.js";
+import "../../chunks/chunk.VCDIUHSK.js";
+import "../../chunks/chunk.KMZLWOXI.js";
+import "../../chunks/chunk.DKVCRWJF.js";
+import "../../chunks/chunk.T3OQKYCT.js";
 import "../../chunks/chunk.2NT3B5WJ.js";
-import "../../chunks/chunk.7YCUXELV.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.SVQL2UJA.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 
 // src/components/chart/chart.ts
 var chart_default = SynChart;

package/dist/components/chart/chart.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../src/components/chart/chart.ts"],
   "sourcesContent": ["import SynChart from './chart.component.js';\n\nexport * from './chart.component.js';\nexport default SynChart;\n\nSynChart.define('syn-chart');\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n    // @ts-ignore \u2013 false positive: conflict between source and dist declaration\n    'syn-chart': SynChart;\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;AAGA,IAAO,gBAAQ;AAEf,SAAS,OAAO,WAAW;",
+  "mappings": ";;;;;;;;;;;;;;;;;AAGA,IAAO,gBAAQ;AAEf,SAAS,OAAO,WAAW;",
   "names": []
 }

package/dist/components/chart/chart.palettes.d.ts

@@ -7,6 +7,6 @@
  *   (`01`=primary, `02`=accent, `03`=muted, `04`=purple, `05`=teal, `06`=magenta, `07`=neutral)
  * - `sequential-status-critical/error/info/success/warning` — 10-step status color ramps, ordered from darkest to brightest
  */
-export type SynChartPalette = 'categorical' | 'sequential-01' | 'sequential-02' | 'sequential-03' | 'sequential-04' | 'sequential-05' | 'sequential-06' | 'sequential-07' | 'sequential-status-critical' | 'sequential-status-error' | 'sequential-status-info' | 'sequential-status-success' | 'sequential-status-warning';
+export type ChartPalette = 'categorical' | 'sequential-01' | 'sequential-02' | 'sequential-03' | 'sequential-04' | 'sequential-05' | 'sequential-06' | 'sequential-07' | 'sequential-status-critical' | 'sequential-status-error' | 'sequential-status-info' | 'sequential-status-success' | 'sequential-status-warning';
 /** Maps each palette name to the ordered list of CSS custom property names to resolve. */
-export declare const PALETTE_TOKENS: Record<SynChartPalette, string[]>;
+export declare const PALETTE_TOKENS: Record<ChartPalette, string[]>;

package/dist/components/chart/chart.palettes.js

@@ -1,7 +1,7 @@
 import {
   PALETTE_TOKENS
-} from "../../chunks/chunk.VJIXW4Z5.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+} from "../../chunks/chunk.JOYNXTII.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   PALETTE_TOKENS
 };

package/dist/components/chart/chart.styles.js

@@ -1,7 +1,7 @@
 import {
   chart_styles_default
 } from "../../chunks/chunk.KPO6RJLG.js";
-import "../../chunks/chunk.MO2GTRUM.js";
+import "../../chunks/chunk.VK2FVWOF.js";
 export {
   chart_styles_default as default
 };

package/dist/components/chart/configs/axes/presets.d.ts

@@ -0,0 +1,86 @@
+import { type ConfigModifier } from '../utilities.js';
+import type { AxesUpdateOptions, AxisLabelIconOptions, AxisUpdateOptions } from './types.js';
+/**
+ * Shows horizontal split lines at each y-axis tick.
+ *
+ * @param {AxisUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @see https://echarts.apache.org/en/option.html#yAxis.splitLine
+ */
+export declare const axesShowYSplitLines: ({ axisIndex }?: AxisUpdateOptions) => ConfigModifier;
+/**
+ * Shows vertical split lines at each x-axis tick.
+ *
+ * @param {AxisUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @see https://echarts.apache.org/en/option.html#xAxis.splitLine
+ */
+export declare const axesShowXSplitLines: ({ axisIndex }?: AxisUpdateOptions) => ConfigModifier;
+/**
+ * Shows split lines on both xAxis and yAxis.
+ *
+ * @param {AxesUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.xAxisIndex] X-axis index or indices to update. If omitted, applies to the preset default x-axis selection.
+ * @param {number | number[]} [options.yAxisIndex] Y-axis index or indices to update. If omitted, applies to the preset default y-axis selection.
+ * @see https://echarts.apache.org/en/option.html#xAxis.axisLine
+ * @see https://echarts.apache.org/en/option.html#yAxis.axisLine
+ * @see https://echarts.apache.org/en/option.html#xAxis.splitLine
+ * @see https://echarts.apache.org/en/option.html#yAxis.splitLine
+ */
+export declare const axesShowSplitLines: ({ xAxisIndex, yAxisIndex }?: AxesUpdateOptions) => ConfigModifier;
+/**
+ * Hides axis labels on x-axis.
+ *
+ * @param {AxisUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @see https://echarts.apache.org/en/option.html#xAxis.axisLabel
+ * @see https://echarts.apache.org/en/option.html#xAxis.nameGap
+ */
+export declare const axesHideXLabels: ({ axisIndex }?: AxisUpdateOptions) => ConfigModifier;
+/**
+ * Hides axis labels on y-axis.
+ *
+ * @param {AxisUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @see https://echarts.apache.org/en/option.html#yAxis.axisLabel
+ * @see https://echarts.apache.org/en/option.html#yAxis.nameTextStyle
+ */
+export declare const axesHideYLabels: ({ axisIndex }?: AxisUpdateOptions) => ConfigModifier;
+/**
+ * Hides axis labels on x-axis and y-axis.
+ *
+ * @param {AxesUpdateOptions} options Preset options.
+ * @param {number | number[]} [options.xAxisIndex] X-axis index or indices to update. If omitted, applies to the preset default x-axis selection.
+ * @param {number | number[]} [options.yAxisIndex] Y-axis index or indices to update. If omitted, applies to the preset default y-axis selection.
+ */
+export declare const axesHideLabels: ({ xAxisIndex, yAxisIndex }?: AxesUpdateOptions) => ConfigModifier;
+/**
+ * Adds icons to x-axis labels.
+ *
+ * @param {AxisLabelIconOptions<'xAxis'>} options Preset options.
+ * @param {string[]} options.iconUrls SVG data URLs applied to labels in label order.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @param {'top' | 'bottom'} [options.iconPosition] Position of the icon relative to labels. Defaults to `'top'`.
+ * @param {string} [options.iconColor] Icon color. Should be a valid CSS color string (e.g. `#ff0000`, `rgb(255, 0, 0)`, `red`). Uses a Synergy default when omitted.
+ * @param {AxisLabelRich} [options.iconsStyle] Rich style object applied to all icons.
+ * @param {AxisLabelRich} [options.labelsStyle] Rich style object applied to all labels.
+ * @see https://echarts.apache.org/en/option.html#xAxis.axisLabel
+ * @see https://echarts.apache.org/en/option.html#xAxis.axisLabel.rich
+ * @see https://echarts.apache.org/en/option.html#xAxis.axisLabel.formatter
+ */
+export declare const axesAddXLabelIcons: (options: AxisLabelIconOptions<"xAxis">) => ConfigModifier;
+/**
+ * Adds icons to y-axis labels.
+ *
+ * @param {AxisLabelIconOptions<'yAxis'>} options Preset options.
+ * @param {string[]} options.iconUrls SVG data URLs applied to labels in label order.
+ * @param {number | number[]} [options.axisIndex] Axis index or indices to update. If omitted, applies to the preset default axis selection.
+ * @param {'left' | 'right'} [options.iconPosition] Position of the icon relative to labels. Defaults to `'left'`.
+ * @param {string} [options.iconColor] Icon color. Should be a valid CSS color string (e.g. `#ff0000`, `rgb(255, 0, 0)`, `red`). Uses a Synergy default when omitted.
+ * @param {AxisLabelRich} [options.iconsStyle] Rich style object applied to all icons.
+ * @param {AxisLabelRich} [options.labelsStyle] Rich style object applied to all labels.
+ * @see https://echarts.apache.org/en/option.html#yAxis.axisLabel
+ * @see https://echarts.apache.org/en/option.html#yAxis.axisLabel.rich
+ * @see https://echarts.apache.org/en/option.html#yAxis.axisLabel.formatter
+ */
+export declare const axesAddYLabelIcons: (options: AxisLabelIconOptions<"yAxis">) => ConfigModifier;

package/dist/components/chart/configs/axes/presets.js

@@ -0,0 +1,25 @@
+import {
+  axesAddXLabelIcons,
+  axesAddYLabelIcons,
+  axesHideLabels,
+  axesHideXLabels,
+  axesHideYLabels,
+  axesShowSplitLines,
+  axesShowXSplitLines,
+  axesShowYSplitLines
+} from "../../../../chunks/chunk.VCDIUHSK.js";
+import "../../../../chunks/chunk.KMZLWOXI.js";
+import "../../../../chunks/chunk.DKVCRWJF.js";
+import "../../../../chunks/chunk.T3OQKYCT.js";
+import "../../../../chunks/chunk.VK2FVWOF.js";
+export {
+  axesAddXLabelIcons,
+  axesAddYLabelIcons,
+  axesHideLabels,
+  axesHideXLabels,
+  axesHideYLabels,
+  axesShowSplitLines,
+  axesShowXSplitLines,
+  axesShowYSplitLines
+};
+//# sourceMappingURL=presets.js.map

package/dist/components/chart/configs/axes/presets.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/components/chart/configs/axes/types.d.ts

@@ -0,0 +1,86 @@
+import type { XAXisOption } from 'echarts/types/dist/shared';
+import type { ECConfig } from '../../types.js';
+export type AxisLabel = NonNullable<XAXisOption['axisLabel']>;
+export type AxisLabelRich = NonNullable<AxisLabel['rich']>[string];
+export type AxisKey = 'xAxis' | 'yAxis';
+type UnpackedArray<T> = T extends Array<infer U> ? U : T;
+export type AxisOption<T extends AxisKey> = UnpackedArray<NonNullable<ECConfig[T]>>;
+/**
+ * A single axis index or a list of axis indices.
+ */
+export type AxisIndices = number | number[];
+/**
+ * Options for presets that update one axis type (e.g. x-axis) at a time.
+ */
+export type AxisUpdateOptions = {
+    /**
+     * Axis index or indices to update.
+     *
+     * When omitted, the preset applies its own default axis selection.
+     */
+    axisIndex?: AxisIndices;
+};
+/**
+ * Options for presets that can update x-axis and y-axis configurations in one step.
+ */
+export type AxesUpdateOptions = {
+    /**
+     * X-axis index or indices to update.
+     *
+     * When omitted, the preset applies its own default x-axis selection.
+     */
+    xAxisIndex?: AxisIndices;
+    /**
+     * Y-axis index or indices to update.
+     *
+     * When omitted, the preset applies its own default y-axis selection.
+     */
+    yAxisIndex?: AxisIndices;
+};
+/**
+ * Options for adding icons to axis labels.
+ */
+export type AxisLabelIconOptions<T extends AxisKey> = {
+    /**
+     * Axis index or indices whose labels should receive icons.
+     *
+     * When omitted, the preset applies its own default axis selection.
+     */
+    axisIndex?: AxisIndices;
+    /**
+     * Icon color. Should be a valid CSS color string (e.g. `#ff0000`, `rgb(255, 0, 0)`, `red`).
+     *
+     * When omitted, the Synergy default color is used.
+     */
+    iconColor?: string;
+    /**
+     * Position of the icons relative to the axis labels.
+     *  The generic axis type determines which icon positions are allowed:
+     * - `xAxis`: `top` or `bottom`
+     * - `yAxis`: `left` or `right`
+     *
+     * When omitted, the Synergy default position is used.
+     */
+    iconPosition?: T extends 'xAxis' ? 'top' | 'bottom' : 'left' | 'right';
+    /**
+     * SVG data URLs applied to labels in label order.
+     *
+     * If there are fewer icons than labels, the remaining labels stay unchanged.
+     */
+    iconUrls: string[];
+    /**
+     * Optional styles applied to all icons.
+     */
+    iconsStyle?: AxisLabelRich;
+    /**
+     * Optional styles applied to all labels.
+     */
+    labelsStyle?: AxisLabelRich;
+};
+type IconLabelPosition = 'top' | 'bottom' | 'left' | 'right';
+export type AxisLabelIconsConfig = Omit<AxisLabelIconOptions<'xAxis'>, 'iconPosition' | 'axisIndex'> & {
+    config: ECConfig;
+    iconColor: string;
+    iconPosition: IconLabelPosition;
+};
+export {};

package/dist/components/chart/configs/axes/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/components/chart/configs/axes/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/components/chart/configs/axes/utilities.d.ts

@@ -0,0 +1,117 @@
+import type { ECConfig } from '../../types.js';
+import type { AxisKey, AxisLabel, AxisLabelIconsConfig, AxisOption, AxisUpdateOptions } from './types.js';
+/**
+ * Colors an SVG data URL by replacing `currentColor` with the provided color string.
+ * Returns the original data URL unchanged if decoding or re-encoding fails.
+ *
+ * @param dataUrl - A data URL containing a base64-encoded SVG image.
+ * @param color - The replacement color (e.g. `#ff0000` or `red`).
+ * @returns A new SVG data URL with `currentColor` substituted.
+ */
+export declare function colorSvgDataUrl(dataUrl: string, color: string): string;
+/**
+ * Extracts the strings that will appear as y-axis labels from the current config.
+ *
+ * - Category axes: uses the explicit `yAxis.data` array.
+ * - Value axes: approximates with the min/max of all numeric series data points,
+ *   which tends to represent the widest labels ECharts will render.
+ * - Multiple y-axes: combines label candidates from all configured y-axis entries.
+ *
+ * @param config - The current chart config.
+ * @returns Label texts that can be used for width estimation of rich y-axis labels.
+ */
+export declare function extractYAxisLabelTexts(config: ECConfig): string[];
+/**
+ * Measures the maximum rendered pixel width of the given strings using a canvas.
+ * Returns `0` if the canvas API is unavailable (e.g. SSR or test environments).
+ *
+ * @param texts - The strings to measure.
+ * @param font - A CSS font string (e.g. `'12px sans-serif'`) matching the target rendering context.
+ * @returns The ceiling of the widest measured text in CSS pixels.
+ */
+export declare function measureMaxTextWidth(texts: string[], font: string): number;
+/**
+ * Merges a partial patch into one axis config (`xAxis` or `yAxis`) and returns
+ * the updated value for that axis key.
+ *
+ * Supports both single-axis objects and axis arrays. When `axisIndex` is set,
+ * only the selected axis entries are updated. For non-array axis configs,
+ * index `0` is used.
+ *
+ * @param config - ECharts config object.
+ * @param axisKey - Axis key to update (`xAxis` or `yAxis`).
+ * @param patch - Partial axis config merged into the selected axis entries.
+ * @param options - Optional axis selection settings.
+ * @returns The updated axis config at `config[axisKey]`, preserving its original shape.
+ *
+ * @example
+ * ```ts
+ * const nextXAxis = updateAxisConfig(
+ *   config,
+ *   'xAxis',
+ *   { axisLabel: { show: false } },
+ *   { axisIndex: [0, 2] },
+ * );
+ *
+ * // nextXAxis
+ * [
+ *   { ...config.xAxis[0], axisLabel: { ...config.xAxis[0].axisLabel, show: false } },
+ *   config.xAxis[1],
+ *   { ...config.xAxis[2], axisLabel: { ...config.xAxis[2].axisLabel, show: false } },
+ * ]
+ * ```
+ */
+export declare const updateAxisConfig: <T extends AxisKey>(config: ECConfig, axisKey: T, patch: AxisOption<T>, options?: AxisUpdateOptions) => ECConfig[T];
+/**
+ * Builds an ECharts `axisLabel` config that renders a per-tick SVG icon next to the label text.
+ *
+ * The function merges Synergy defaults with caller overrides, colorizes each icon by replacing
+ * `currentColor` in the provided SVG data URLs, and emits a rich-text configuration compatible
+ * with ECharts axis label formatting.
+ *
+ * @param options - Fully resolved icon-label configuration, including chart config and position.
+ * @returns An `axisLabel` object ready to be merged into an x-axis or y-axis config.
+ */
+export declare const buildAxisLabelConfigWithIcon: ({ config, iconColor, iconPosition, iconsStyle, iconUrls, labelsStyle, }: AxisLabelIconsConfig) => AxisLabel;
+/**
+ * Preprocessor to apply default styles to x and y axes based on the Synergy theme.
+ * This is needed because ECharts does not provide a way to set specific styles for x and y axis, only for axis types.
+ * If the user already provided specific styles for these properties, those will be respected and not overridden.
+ *
+ * @param option - The ECharts config option object that is being processed before rendering.
+ */
+export declare const applyAxisDefaultsPreprocessor: (option: ECConfig) => void;
+/**
+ * Default styling for all axes.
+ * This is done as function to ensure that the real style values are read at runtime and not at build time, which allows them to be dynamic based on the current theme.
+ */
+export declare const axisCommonStyles: () => {
+    alignTicks: boolean;
+    axisLabel: {
+        color: string;
+        fontFamily: string;
+        fontSize: string;
+        fontWeight: string;
+    };
+    axisLine: {
+        lineStyle: {
+            color: string;
+            width: number;
+        };
+        show: boolean;
+    };
+    minorSplitLine: {
+        lineStyle: {};
+    };
+    nameTextStyle: {
+        color: string;
+        fontSize: string;
+        fontWeight: string;
+    };
+    splitLine: {
+        lineStyle: {
+            color: string;
+        };
+        show: boolean;
+    };
+};