@opendata-ai/openchart-core 8.0.0 → 8.1.1

package/README.md

@@ -90,7 +90,7 @@ import type {
 
 // Store the spec shape without data
 const stored: ChartSpecWithoutData = {
-  type: 'line',
+  mark: 'line',
   encoding: {
     x: { field: 'date', type: 'temporal' },
     y: { field: 'value', type: 'quantitative' },

package/dist/index.d.ts

@@ -725,7 +725,13 @@ interface ScaleConfig {
     reverse?: boolean;
     /** Clamp output to the range. */
     clamp?: boolean;
-    /** Padding for band/point scales. */
+    /**
+     * Padding for band/point scales. Point-scale default (a categorical x/y on a
+     * line/area/point mark) is 0 for line and area marks (the trend runs flush
+     * to the plot edges) and 0.5 for other marks (e.g. scatter, so points don't
+     * collide with the axis). `paddingOuter` is accepted as an alias here since
+     * point scales have no inner bands.
+     */
     padding?: number;
     /** Inner padding for band scales. */
     paddingInner?: number;
@@ -2094,7 +2100,11 @@ interface BaseChartSpec<TData extends DataRow = DataRow> {
     theme?: ThemeConfig;
     /** Dark mode behavior. Defaults to "off". */
     darkMode?: DarkMode;
-    /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
+    /**
+     * Whether to show the tryOpenData.ai watermark. Defaults to true; auto-hides
+     * when the container is under 200px tall (the cramped height class) unless
+     * explicitly set.
+     */
     watermark?: boolean;
     /**
      * Series names to hide from rendering by default. This is the authored
@@ -2431,6 +2441,26 @@ interface GraphSpec {
     layout?: GraphLayoutConfig;
     /** Per-node visual overrides, keyed by node id. */
     nodeOverrides?: Record<string, NodeOverride>;
+    /**
+     * Node treated as the graph's seed/root: gets a distinct ring and an
+     * always-on label without needing a `nodeOverrides` entry, and stays lit when
+     * a category highlight or legend filter dims everything else.
+     *
+     * String shorthand is the node id; the object form adds styling that layers
+     * under any `nodeOverrides` entry for the same id (an explicit override
+     * always wins). The seed's radius is deliberately left to the `nodeSize`
+     * encoding — set `style.radius` to make it bigger.
+     *
+     * NOT related to `layout.seed`, which is the deterministic RNG seed for the
+     * force layout. This field names a node; `layout.seed` is a number.
+     *
+     * An id that isn't in `nodes` warns and is ignored (it does not throw), so a
+     * filtered or paginated node update can't crash the host.
+     */
+    seedNode?: string | {
+        id: string;
+        style?: NodeOverride;
+    };
     /** Editorial chrome. */
     chrome?: Chrome;
     /** Annotations. */
@@ -3482,6 +3512,14 @@ interface AxisTick {
     fullLabel?: string;
     /** Secondary label text from axis.labelField. */
     subtitle?: string;
+    /**
+     * Pixel position the LABEL is drawn at, set only when it differs from
+     * `position` because the label was nudged inward to stay inside the
+     * container. Point/band x-scales run flush to the plot edges, so a label
+     * centered on the outermost tick can spill past the SVG. Gridlines, marks
+     * and transitions still key off `position`; only the text moves.
+     */
+    labelPosition?: number;
 }
 /** A single gridline with computed positions. */
 interface Gridline {

package/dist/index.js

@@ -1939,6 +1939,17 @@ function footnoteBandHeight(count, theme) {
 }
 function computeChrome(chrome, theme, width, measureText, chromeMode = "full", padding, watermark = true, bottomLegendHeight = 0) {
   if (!chrome || chromeMode === "hidden") {
+    if (watermark && width >= BRAND_MIN_WIDTH) {
+      const hiddenPad = padding ?? theme.spacing.padding;
+      const brandHeight = estimateTextHeight(BRAND_FONT_SIZE, 1);
+      return {
+        topHeight: 0,
+        bottomHeight: theme.spacing.chartToFooter + brandHeight + hiddenPad + bottomLegendHeight
+      };
+    }
+    if (bottomLegendHeight > 0) {
+      return { topHeight: 0, bottomHeight: bottomLegendHeight };
+    }
     return { topHeight: 0, bottomHeight: 0 };
   }
   const pad2 = padding ?? theme.spacing.padding;