@blueprint-chart/lib 0.1.35 → 0.3.0

package/dist/transitions/frame-geometry.d.ts

@@ -0,0 +1,53 @@
+import { SceneTransition } from './scene-transition';
+/** Plot rectangle in chart-area coordinates: origin + inner size. */
+export interface PlotRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface FrameGeometryOptions {
+    /** The chart-area `<g>` whose `transform` carries the plot origin. */
+    group: SVGGElement;
+    /** The plot clip rect, if any (width/height interpolate with the plot size). */
+    clipRect: SVGRectElement | null;
+    from: PlotRect;
+    to: PlotRect;
+}
+/**
+ * Ease the plot frame geometry (chart-area group origin + clip size) from the
+ * prior scene's rect to the new one on the orchestrator's `bc-scene` clock.
+ *
+ * The new render has already placed the group/clip at the NEW geometry, so the
+ * tween first resets them to `from` and eases to `to`. The group `transform`
+ * uses the point-wise interpolator (d3's default string interp mangles it);
+ * clip width/height are numeric and use d3's default attr tween.
+ *
+ * Registers a buffered flush, so call it during `committing` (e.g. inside
+ * `SceneTransition.run`). On the snap path (duration 0 / reduced motion) the
+ * geometry is set directly to `to`.
+ */
+export interface PlotFrameOptions {
+    /** The chart's `<svg>` (used to find the clip rect by id). */
+    svg: SVGSVGElement;
+    /** The plot clip-path id (its `rect` size interpolates with the plot). */
+    clipId: string;
+    /** The chart-area `<g>` whose `transform` carries the plot origin. */
+    group: SVGGElement;
+    /** The prior scene's plot rect (from the transition cache), if any. */
+    from: PlotRect | undefined;
+    /** This render's plot rect. */
+    to: PlotRect;
+    /** Only ease when true (same-type transition with prior marks to tween from). */
+    active: boolean;
+}
+/**
+ * Renderer-facing wrapper over {@link tweenFrameGeometry}: resolves the clip
+ * rect from `svg`/`clipId` and eases from the cached prior plot rect to this
+ * render's rect. No-ops unless `active` and a prior rect exist. Using the cached
+ * prior rect (rather than reconstructing it from margins) keeps the `from`
+ * geometry exact even when a chart's plot height differs from its inner height
+ * (e.g. a category-label band) or carries clip inflation.
+ */
+export declare function tweenPlotFrame(orch: SceneTransition, opts: PlotFrameOptions): void;
+export declare function tweenFrameGeometry(orch: SceneTransition, opts: FrameGeometryOptions): void;

package/dist/transitions/index.d.ts

@@ -2,6 +2,9 @@ export { SceneTransition, getSceneTransition } from './scene-transition';
 export { BC_TRANSITION_NAME } from './types';
 export type { CommitOptions } from './scene-transition';
 export { featureJoin } from './feature-join';
+export { interpolatePath } from './interpolate-path';
+export { tweenFrameGeometry, tweenPlotFrame } from './frame-geometry';
+export type { PlotRect, FrameGeometryOptions, PlotFrameOptions } from './frame-geometry';
 export { roleScan, tagsCompatible, shouldEscalateToFade, ROLE_MATCH_THRESHOLD } from './role-matcher';
 export { snapshotLiveAttrs } from './snapshot';
 export type { TransitionMode, SceneTransitionState, FeatureRole, FeatureJoinConfig, AttrMap, AttrValue, } from './types';

package/dist/transitions/interpolate-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Interpolate two SVG path `d` strings point-wise.
+ *
+ * d3's default `interpolateString` pairs numbers by document order and
+ * fuses/garbles them when the two paths have different counts — observed
+ * producing ~1e11 coordinates during area resizes. This splits each path
+ * into a command skeleton + number list; when the skeletons match it
+ * interpolates the numbers pairwise, otherwise it hard-switches at the
+ * midpoint so a malformed blend is never emitted.
+ */
+export declare function interpolatePath(a: string, b: string): (t: number) => string;

package/dist/transitions/types.d.ts

@@ -17,7 +17,7 @@ export type SceneTransitionState = 'idle' | 'committing' | 'animating';
  * `'axis-tick.value'`. The role-matcher (future plan) acts on this tag;
  * v1 stores it without acting on it for cross-type.
  */
-export type FeatureRole = 'mark-per-category' | 'mark-per-cell' | 'series-path' | 'axis-tick.value' | 'axis-tick.category' | 'value-label' | 'annotation.point' | 'annotation.range' | 'annotation.free';
+export type FeatureRole = 'mark-per-category' | 'mark-per-cell' | 'series-path' | 'series-area' | 'series-line' | 'axis-tick.value' | 'axis-tick.category' | 'value-label' | 'annotation.point' | 'annotation.range' | 'annotation.free';
 /** Subset of SVG / HTML attribute values we tween. */
 export type AttrValue = string | number;
 /** Map of attribute name → value. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueprint-chart/lib",
-  "version": "0.1.35",
+  "version": "0.3.0",
   "description": "DSL-driven charting library built on D3. Define charts as text, render them anywhere.",
   "keywords": [
     "chart",