@opendata-ai/openchart-core 8.0.0-rc.7 → 8.0.0-rc.9

package/src/types/index.ts

@@ -95,6 +95,7 @@ export type {
   SankeyLayout,
   SankeyLinkMark,
   SankeyNodeMark,
+  ScaleInvert,
   SizeLegendCircle,
   SizeLegendLayout,
   SortState,

package/src/types/layout.ts

@@ -747,8 +747,9 @@ export interface BaseLegendLayout {
    * read them silently pick whichever comes first.
    */
   channel?: LegendChannel;
-  /** Where the legend is positioned relative to the chart area. */
-  position: 'top' | 'right' | 'bottom' | 'bottom-right' | 'inline';
+  /** Where the legend is positioned relative to the chart area. `'top-left'`
+   *  is a map-only overlay position (floats inside the map area). */
+  position: 'top' | 'top-left' | 'right' | 'bottom' | 'bottom-right' | 'inline';
   /** Bounding box for the legend (pixel coordinates). */
   bounds: Rect;
   /** Entry label style. */
@@ -1133,6 +1134,24 @@ export interface YouDrawItYInvert {
   bottomData: number;
 }
 
+/**
+ * Scale inversion anchors serialized from the engine so the vanilla layer
+ * can convert pixel positions to data-space values without holding d3
+ * scale objects. Generalizes the YouDrawItYInvert pattern to both axes.
+ */
+export interface ScaleInvert {
+  /** For continuous scales: two reference pixel-to-data anchor points. */
+  topPixel: number;
+  bottomPixel: number;
+  topData: number;
+  bottomData: number;
+  /** Scale type so the vanilla layer applies the correct inverse transform. */
+  scaleType?: 'linear' | 'log' | 'pow' | 'sqrt' | 'symlog' | 'time';
+  /** For band/point scales: ordered domain values and their pixel centers. */
+  domain?: (string | number)[];
+  positions?: number[];
+}
+
 /**
  * Resolved geometry and config for the "you draw it" interactive format
  * (`youDrawIt`). The vanilla adapter uses this to render the hatched drawing
@@ -1266,6 +1285,10 @@ export interface ChartLayout {
   crosshair: boolean;
   /** Real text measurement function from the adapter (for accurate SVG text wrapping). */
   measureText?: MeasureTextFn;
+  /** Scale inversion anchors for the x axis. Used by anchor drag to convert pixel to data-space. */
+  xInvert?: ScaleInvert;
+  /** Scale inversion anchors for the y axis. Used by anchor drag to convert pixel to data-space. */
+  yInvert?: ScaleInvert;
   /** Faceted (small-multiples) layout. When present, renderers iterate panels instead of using top-level marks/axes. */
   facet?: FacetLayout;
 }

package/src/types/spec.ts

@@ -1789,7 +1789,12 @@ interface BaseChartSpec<TData extends DataRow = DataRow> {
   darkMode?: DarkMode;
   /** Whether to show the tryOpenData.ai watermark. Defaults to true. */
   watermark?: boolean;
-  /** Series names to hide from rendering. Hidden series remain in the legend but are visually dimmed. */
+  /**
+   * Series names to hide from rendering by default. This is the authored
+   * persistence target for legend visibility. Runtime legend toggles
+   * (legend-toggle edit events) layer on top of this via ephemeral runtime
+   * sets but never modify it.
+   */
   hiddenSeries?: string[];
   /** Per-series visual overrides, keyed by series name (the color field value). */
   seriesStyles?: Record<string, SeriesStyle>;
@@ -2109,7 +2114,16 @@ export interface LayerSpec<TData extends DataRow = DataRow> {
   height?: number;
   /** Accepted for Vega-Lite compatibility and ignored (with a compile warning). */
   $schema?: string;
-  /** Annotations on the layered view. */
+  /**
+   * Annotations for the layered chart. When present, these are the
+   * annotations rendered and available for editing. When absent, falls back
+   * to the first leaf layer's annotations. Annotations on second and later
+   * leaf layers are not rendered.
+   *
+   * For edit persistence: the `data-annotation-index` stamped on each
+   * rendered annotation maps to this array (or the first leaf's if this is
+   * unset). Place annotations here for reliable index-based edit matching.
+   */
   annotations?: Annotation[];
   /** Label display configuration. `false` disables all labels, `true` uses defaults. */
   labels?: LabelSpec;
@@ -2125,7 +2139,12 @@ export interface LayerSpec<TData extends DataRow = DataRow> {
   watermark?: boolean;
   /** Resolution strategy for shared scales/axes/legends. */
   resolve?: ResolveConfig;
-  /** Hidden series names. */
+  /**
+   * Series names to hide from rendering by default. This is the authored
+   * persistence target for legend visibility. Runtime legend toggles
+   * (legend-toggle edit events) layer on top of this via ephemeral runtime
+   * sets but never modify it.
+   */
   hiddenSeries?: string[];
   /** Endpoint labels column, inherited by child layers that don't set their own. */
   endpointLabels?: boolean | EndpointLabelsConfig;