@blueprint-chart/lib 0.1.35 → 0.3.0

package/dist/charts/motion.d.ts

@@ -1,3 +1,12 @@
+/**
+ * @deprecated As of the Scene Transition Orchestrator, mark rendering has fully
+ * migrated to `packages/lib/src/transitions/` (SceneTransition + featureJoin +
+ * tweenFrameGeometry): the legacy `reinsertWithOffset` mark-translate wrapper is
+ * gone. What remains here is the cross-type fade path and the transition-duration
+ * flag: every renderer and the axis subsystem still call `setRenderTransition` /
+ * `getDefaultTransitionMs`, and cross-type transitions use `snapshotForFadeOut` /
+ * `commitFadeOut` / `fadeIn`. This file can be deleted once those move too.
+ */
 /**
  * Returns 0 when the user prefers reduced motion, otherwise returns the input duration.
  */
@@ -13,15 +22,6 @@ export declare function setRenderTransition(enabled: boolean): void;
  * Returns 0 when not in a scene transition (i.e. setRenderTransition(false) was last called).
  */
 export declare function getDefaultTransitionMs(): number;
-/**
- * Reinsert prior elements into a parent, wrapping them in a compensating
- * `<g translate(dx,dy)>` that transitions to identity over the default
- * duration.  This corrects for chartArea origin shifts (e.g. when legend
- * toggles change margins) so that prior elements don't visually jump.
- *
- * When dx/dy are both 0, elements are appended directly without a wrapper.
- */
-export declare function reinsertWithOffset(parent: Element, elements: Element[], dx: number, dy: number): void;
 /**
  * Fade an element in using the Web Animations API.
  * Respects `prefers-reduced-motion` via `getTransitionDuration`.

package/dist/charts/plugins/plugin-host.d.ts

@@ -0,0 +1,16 @@
+import { D3Blueprint } from 'd3-blueprint';
+import * as d3 from 'd3';
+/**
+ * Minimal D3Blueprint host whose only job is to carry the legacy plugins
+ * (tooltip, crosshair, annotations) that consume the `.use()` / `.draw()` API.
+ *
+ * Marks are rendered through the SceneTransition orchestrator's featureJoin, not
+ * this class — so `initialize` defines no layers. Renderers that have migrated
+ * their marks but still host plugins use `createPluginHost` instead of declaring
+ * a per-file empty subclass.
+ */
+declare class PluginHost extends D3Blueprint<unknown> {
+    initialize(): void;
+}
+export declare function createPluginHost(selection: d3.Selection<SVGGElement, unknown, null, undefined>): PluginHost;
+export {};

package/dist/charts/transition-cache.d.ts

@@ -2,6 +2,17 @@ import { Margin } from './types';
 export interface CachedChart {
     chartType: string;
     margin?: Margin;
+    /**
+     * The plot rect (origin + size) this render used for its marks/clip, so the
+     * next same-type transition can ease the frame geometry from the exact prior
+     * rect instead of reconstructing it from margins. Shape matches `PlotRect`.
+     */
+    plotRect?: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
 }
 export declare function getCachedChart(container: HTMLElement): CachedChart | undefined;
 export declare function setCachedChart(container: HTMLElement, entry: CachedChart): void;

package/dist/dsl/types.d.ts

@@ -11,55 +11,75 @@ export interface PropertyNode {
      * real data category; only the unquoted `series = ...` row names columns.
      */
     quotedKey?: boolean;
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface DataNode {
     type: DslNodeType.Data;
     entries: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface ColorizeNode {
     type: DslNodeType.Colorize;
     target: string;
     properties: PropertyNode[];
     fromHighlight?: boolean;
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface HighlightNode {
     type: DslNodeType.Highlight;
     target: string;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface AreaFillNode {
     type: DslNodeType.AreaFill;
     from: string;
     to: string;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface PointAnnotationNode {
     type: DslNodeType.Annotation;
     kind: AnnotationKind.Point;
     target: string;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface RangeAnnotationNode {
     type: DslNodeType.Annotation;
     kind: AnnotationKind.Range;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface FreeAnnotationNode {
     type: DslNodeType.Annotation;
     kind: AnnotationKind.Free;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export type AnnotationNode = PointAnnotationNode | RangeAnnotationNode | FreeAnnotationNode;
 export interface SeriesNode {
     type: DslNodeType.Series;
     name: string;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface AnnotationVisibilityNode {
     type: DslNodeType.AnnotationVisibility;
     action: AnnotationAction;
     kind: AnnotationKind;
     id: string;
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface SceneNode {
     type: DslNodeType.Scene;
@@ -73,11 +93,15 @@ export interface SceneNode {
     annotationVisibility: AnnotationVisibilityNode[];
     series: SeriesNode[];
     transforms: TransformNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface TransformNode {
     type: DslNodeType.Transform;
     transformType: string;
     properties: PropertyNode[];
+    /** `//` comment lines authored immediately above this node, text only (no `//`). */
+    leadingComments?: string[];
 }
 export interface ChartNode {
     type: DslNodeType.Chart;