apexcharts 7.3.0 → 7.4.0

package/src/modules/weave/PluginAPI.js

@@ -25,12 +25,17 @@
  * tooltip and its `dataPoint*` events; before this a plugin either re-derived
  * it from raw pixels or did without.
  *
+ * v5 added `api.info.stroke`, the caller's own `stroke.dashArray`. That option
+ * is indexed by series position, so a plugin that wants its own derived series
+ * dashed must write the whole array; reporting the current value is what lets
+ * it put back what it found instead of flattening the caller's dashed lines.
+ *
  * Feature-detect rather than bumping `apiVersion` unless the plugin genuinely
  * cannot work without the new surface: a plugin declaring v3 is SKIPPED
  * outright on a v2 host, so `apiVersion: 2` plus `typeof api.reserve ===
  * 'function'` keeps one build working on both.
  */
-export const WEAVE_API_VERSION = 4
+export const WEAVE_API_VERSION = 5
 
 /**
  * Public chart methods safe to expose to plugins (each bound to ctx). Excludes
@@ -307,6 +312,21 @@ export function buildPluginAPI(host, record) {
             ? w.config.dataLabels.enabledOnSeries.slice()
             : null,
         }),
+        // The caller's own dashing, reported for the same reason and against
+        // the same trap (v5). `stroke.dashArray` is indexed by series position
+        // with no per-series escape hatch, so a plugin that wants ITS OWN
+        // computed series dashed has to write the whole array, and writing one
+        // without knowing what was there discards the caller's dashed lines
+        // with nothing to restore them from.
+        //
+        // A scalar applies to every series and an array is per series. There is
+        // no "unset" to report: the option defaults to 0, and 0 already means
+        // no dashing, so restoring it restores exactly what was there.
+        stroke: Object.freeze({
+          dashArray: Array.isArray(w.config.stroke && w.config.stroke.dashArray)
+            ? w.config.stroke.dashArray.slice()
+            : (w.config.stroke && w.config.stroke.dashArray) || 0,
+        }),
       })
     },
 

package/src/ssr/DOMShim.js

@@ -4,6 +4,14 @@
  * Provides just enough SVG element emulation to create chart structure without full DOM
  */
 
+// Approximate sans-serif metrics, in em, used to estimate SVG text bounds when
+// no font engine is available to measure the glyphs.
+const CHAR_WIDTH_EM = 0.55
+const ASCENT_EM = 0.917
+const DESCENT_EM = 0.25
+const LINE_HEIGHT_EM = 1.1
+const DEFAULT_FONT_SIZE = 11
+
 /**
  * Mock SVG element for SSR environment
  */
@@ -148,6 +156,48 @@ class SSRElement {
     }
   }
 
+  getBBox() {
+    if (this.nodeName !== 'text' && this.nodeName !== 'tspan') {
+      return { x: 0, y: 0, width: 0, height: 0 }
+    }
+
+    const lines = this._textLines()
+    const longest = lines.reduce((acc, line) => Math.max(acc, line.length), 0)
+    if (!longest) {
+      return { x: 0, y: 0, width: 0, height: 0 }
+    }
+
+    const fontSize =
+      parseFloat(this.attributes.get('font-size')) || DEFAULT_FONT_SIZE
+    const width = longest * fontSize * CHAR_WIDTH_EM
+    const height =
+      fontSize * (ASCENT_EM + DESCENT_EM) +
+      (lines.length - 1) * fontSize * LINE_HEIGHT_EM
+
+    const anchor = this.attributes.get('text-anchor')
+    const x = parseFloat(this.attributes.get('x')) || 0
+    const y = parseFloat(this.attributes.get('y')) || 0
+
+    return {
+      x: anchor === 'middle' ? x - width / 2 : anchor === 'end' ? x - width : x,
+      y: y - fontSize * ASCENT_EM,
+      width,
+      height,
+    }
+  }
+
+  /**
+   * Text of this element, one entry per rendered line
+   * @returns {string[]}
+   */
+  _textLines() {
+    const tspans = this.children.filter((child) => child.nodeName === 'tspan')
+    if (tspans.length) {
+      return tspans.map((tspan) => String(tspan.textContent ?? ''))
+    }
+    return [String(this.textContent ?? '')]
+  }
+
   getRootNode() {
     /** @type {SSRElement} */
     let root = this

package/src/types/internal.d.ts

@@ -802,7 +802,7 @@ export interface ChartContext {
   eventList: string[]
 
   // Public methods on the ApexCharts instance
-  update(options?: any): Promise<any>
+  update(options?: any, overwriteInitialSeries?: boolean): Promise<any>
   getSyncedCharts(): any[]
   getGroupedCharts(): any[]
   fastUpdate(animate?: boolean, prevAxisScaleSig?: string): Promise<any>

package/src/utils/Utils.js

@@ -75,15 +75,12 @@ class Utils {
   }
 
   // A per-series shallow copy: the series OBJECTS are copied, their data arrays
-  // are shared. Almost every internal "mutation" of a series' data is a
-  // property REPLACEMENT (`series[i].data = []` on legend collapse,
-  // `series[i] = 0` for non-axis charts), and those cannot reach a copy made
-  // this way because the series object was copied at capture time. The
-  // exception is appendData(), whose push loop grows the shared data array in
-  // place, so a copy taken before it does see the appended points; see the
-  // note above defineLazyInitialSeries(). This is the same cheap shape
-  // `globals.initialSeries` captures, so snapshotting a config stays O(n)
-  // instead of deep-cloning every point.
+  // are shared. Every internal "mutation" of a series' data is a property
+  // REPLACEMENT (`series[i].data = []` on legend collapse, `series[i] = 0` for
+  // non-axis charts, appendData's concat), and those cannot reach a copy made
+  // this way because the series object was copied at capture time. This is the
+  // same cheap shape `globals.initialSeries` captures, so snapshotting a config
+  // stays O(n) instead of deep-cloning every point.
   /**
    * @param {any} series
    */

package/types/apexcharts.d.ts

@@ -1878,6 +1878,17 @@ type ApexChart = {
      * @default 'auto'
      */
     pinch?: boolean | 'auto'
+    /**
+     * The way back out of a zoom on a chart whose toolbar is hidden. While the
+     * chart is zoomed and nothing else on screen can reset it, one reset
+     * control is drawn where the toolbar would have been, and it goes when the
+     * range does; `Escape` resets the zoom as well. `'auto'` supplies both only
+     * where there is no reset button already, `true` also forces the control on
+     * where `toolbar.tools.reset` is off, and `false` turns both off for a page
+     * that supplies its own reset. Requires `enabled: true`.
+     * @default 'auto'
+     */
+    resetControl?: boolean | 'auto'
     zoomedArea?: {
       fill?: {
         color?: string
@@ -2656,6 +2667,12 @@ type ApexPlotOptions = {
     distributed?: boolean
     borderRadius?: number;
     borderRadiusApplication?: 'around' | 'end';
+    /**
+     * Which segments of a stack round. 'all' (default) caps both ends of the
+     * stack, the baseline and the far end; 'last' caps only the far end so
+     * the stack sits square on the baseline. Stacked bar/column only.
+     */
+    borderRadiusWhenStacked?: 'all' | 'last';
     hideZeroBarsWhenGrouped?: boolean
     rangeBarOverlap?: boolean
     rangeBarGroupRows?: boolean