semiotic 3.0.0-beta.4 → 3.0.0-beta.6

package/dist/stream/SceneGraph.d.ts

@@ -1,6 +1,6 @@
 import type { SceneNode, LineSceneNode, AreaSceneNode, PointSceneNode, RectSceneNode, HeatcellSceneNode, Style, StreamScales } from "./types";
 export declare function buildLineNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, style: Style, group?: string): LineSceneNode;
-export declare function buildAreaNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, baselineY: number, style: Style, group?: string): AreaSceneNode;
+export declare function buildAreaNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Record<string, any>) => number): AreaSceneNode;
 export declare function buildStackedAreaNodes(groups: {
     key: string;
     data: Record<string, any>[];

package/dist/stream/keyboardNav.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Keyboard navigation utilities for Stream Frames.
+ *
+ * Extracts navigable data points from the scene graph, sorts them
+ * spatially, and provides an index-based iteration API for arrow-key
+ * navigation. Reuses the existing hover/tooltip system — keyboard
+ * focus sets the same HoverData state that mouse hover does.
+ */
+import type { HoverData } from "../realtime/types";
+export interface NavPoint {
+    x: number;
+    y: number;
+    datum: any;
+}
+/**
+ * Extract navigable data points from XY scene nodes.
+ * Points/rects yield one point each. Lines/areas yield their path points
+ * paired with the underlying data. Sorted left-to-right by x.
+ */
+export declare function extractXYNavPoints(scene: any[]): NavPoint[];
+/**
+ * Extract navigable points from ordinal scene nodes.
+ * Sorted left-to-right (horizontal) or top-to-bottom (vertical).
+ */
+export declare function extractOrdinalNavPoints(scene: any[]): NavPoint[];
+/**
+ * Extract navigable points from network scene nodes.
+ * Node-only (edges are not individually navigable).
+ */
+export declare function extractNetworkNavPoints(scene: any[]): NavPoint[];
+/**
+ * Compute the next focus index given a key and current index.
+ * Returns -1 to clear focus.
+ */
+export declare function nextIndex(key: string, current: number, total: number): number | null;
+/**
+ * Convert a NavPoint to HoverData for the tooltip system.
+ */
+export declare function navPointToHover(point: NavPoint): HoverData;

package/dist/stream/networkTypes.d.ts

@@ -338,6 +338,8 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     nodeLabel?: string | ((d: any) => string);
     showLabels?: boolean;
     size?: [number, number];
+    responsiveWidth?: boolean;
+    responsiveHeight?: boolean;
     margin?: {
         top?: number;
         right?: number;

package/dist/stream/ordinalTypes.d.ts

@@ -169,6 +169,8 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     categoryAccessor?: string | ((d: T) => string);
     projection?: "vertical" | "horizontal" | "radial";
     size?: [number, number];
+    responsiveWidth?: boolean;
+    responsiveHeight?: boolean;
     margin?: {
         top?: number;
         right?: number;

package/dist/stream/types.d.ts

@@ -92,6 +92,11 @@ export interface AreaSceneNode {
     style: Style;
     datum: any;
     group?: string;
+    /** Vertical gradient fill: opacity fades from topOpacity at the line to bottomOpacity at the baseline */
+    fillGradient?: {
+        topOpacity: number;
+        bottomOpacity: number;
+    };
     /** When false, skip hit testing (used for decorative bounds areas) */
     interactive?: boolean;
 }
@@ -207,6 +212,21 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
      * When set, an uncertainty band is drawn ± this offset from the line.
      */
     boundsAccessor?: string | ((d: T) => number);
+    /**
+     * Per-point area baseline accessor. When set, area charts fill between
+     * yAccessor (top) and y0Accessor (bottom) instead of filling to the axis.
+     * Use for percentile bands, confidence ribbons, or any band/ribbon chart.
+     */
+    y0Accessor?: string | ((d: T) => number);
+    /**
+     * Gradient fill for area charts. The fill fades from topOpacity at the line
+     * to bottomOpacity at the baseline. Set to `true` for default (0.8 → 0.05)
+     * or `{ topOpacity, bottomOpacity }` for custom values.
+     */
+    gradientFill?: boolean | {
+        topOpacity: number;
+        bottomOpacity: number;
+    };
     /**
      * Style for bounds/uncertainty areas.
      * If omitted, defaults to the line color at 0.2 opacity.
@@ -228,6 +248,10 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
     extentPadding?: number;
     sizeRange?: [number, number];
     size?: [number, number];
+    /** Auto-match width to container. Requires a sized parent element. */
+    responsiveWidth?: boolean;
+    /** Auto-match height to container. Requires a parent with explicit height. */
+    responsiveHeight?: boolean;
     margin?: {
         top?: number;
         right?: number;

package/dist/stream/useResponsiveSize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Hook that measures the parent container and returns responsive dimensions.
+ * Uses ResizeObserver to track container size changes.
+ *
+ * @param baseSize - The default [width, height] from the size prop
+ * @param responsiveWidth - Whether width should follow container width
+ * @param responsiveHeight - Whether height should follow container height
+ * @returns [containerRef, effectiveSize] — attach the ref to the container div
+ */
+export declare function useResponsiveSize(baseSize: [number, number], responsiveWidth?: boolean, responsiveHeight?: boolean): [React.RefObject<HTMLDivElement>, [number, number]];