@opendata-ai/openchart-core 6.7.1 → 6.9.0

package/dist/index.d.ts

@@ -547,9 +547,17 @@ interface RefLineAnnotation extends AnnotationBase {
 type Annotation = TextAnnotation | RangeAnnotation | RefLineAnnotation;
 /**
  * Dark mode behavior.
- * - "auto": respect system preference (prefers-color-scheme)
- * - "force": always render in dark mode
- * - "off": always render in light mode (default)
+ *
+ * - `"auto"` - Checks the `prefers-color-scheme` media query to detect the
+ *   user's system-level preference. This does NOT detect class-based dark mode
+ *   toggles (e.g. `document.documentElement.classList.toggle('dark')`). If your
+ *   app uses class-based dark mode, use VizThemeProvider with `"force"` or
+ *   `"off"` instead of `"auto"` and toggle based on your app's state.
+ * - `"force"` - Always render in dark mode regardless of system preference.
+ * - `"off"` - Always render in light mode (default).
+ *
+ * All components (Chart, Sankey, Graph) inherit darkMode from VizThemeProvider
+ * when no explicit prop is passed.
  */
 type DarkMode = 'auto' | 'force' | 'off';
 /**
@@ -626,6 +634,8 @@ interface LegendConfig {
     columns?: number;
     /** Max number of legend entries before truncation. Remaining entries show as "+N more". */
     symbolLimit?: number;
+    /** Maximum number of rows for top-positioned legends before truncation. Defaults to 2. */
+    maxRows?: number;
 }
 /** Data row: a plain object with string keys. */
 type DataRow = Record<string, unknown>;
@@ -931,6 +941,15 @@ interface SankeySpec {
     iterations?: number;
     /** Link coloring strategy. Defaults to 'gradient'. */
     linkStyle?: SankeyLinkColor;
+    /** Link fill opacity (0-1). Defaults to 0.5 in light mode, 0.75 in dark mode. */
+    linkOpacity?: number;
+    /**
+     * Which side of each node to place labels. 'auto' uses the default heuristic
+     * (left-column right, right-column left, middle right). 'right' forces all
+     * labels to the right of their nodes. 'left' forces all labels to the left.
+     * Defaults to 'auto'.
+     */
+    nodeLabelAlign?: 'auto' | 'left' | 'right';
     /** Editorial chrome (title, subtitle, source, byline, footer). */
     chrome?: Chrome;
     /** Legend display configuration. */
@@ -941,6 +960,14 @@ interface SankeySpec {
     darkMode?: DarkMode;
     /** Animation configuration for entrance animations. */
     animation?: AnimationSpec;
+    /**
+     * d3-format string applied to flow values in tooltips and ARIA labels.
+     * Uses the literal suffix extension: ".0f%" appends "%" to the formatted
+     * number (data value 28 renders as "28%"). For currency: "$,.0f" or "$~s".
+     * For SI suffixes: "~s" (renders 1000 as "1k"). When not set, values use
+     * the default number formatter.
+     */
+    valueFormat?: string;
 }
 /**
  * Top-level visualization spec: union discriminated by structural shape.

package/dist/index.js

@@ -1077,6 +1077,12 @@ function buildTextStyle(defaults, fontFamily, textColor, width, overrides) {
 }
 function estimateLineCount(text, style, maxWidth, _measureText) {
   if (maxWidth <= 0) return 1;
+  const segments = text.split("\n");
+  if (segments.length > 1) {
+    return segments.reduce((total, segment) => {
+      return total + (segment.length === 0 ? 1 : estimateLineCount(segment, style, maxWidth, _measureText));
+    }, 0);
+  }
   const charWidth = estimateCharWidth(style.fontSize, style.fontWeight);
   const maxChars = Math.floor(maxWidth / charWidth);
   if (text.length <= maxChars) return 1;