semiotic 3.5.3 → 3.5.4

package/dist/components/stream/renderers/wedgePathBuilder.d.ts

@@ -54,3 +54,34 @@ export interface AnnularPathOptions {
  *     unrounded so the path stays well-formed.
  */
 export declare function annularSectorPath(opts: AnnularPathOptions): string;
+/**
+ * Build the clip outline + slice paths for a gauge gradient band.
+ *
+ * The band is rendered as one rounded annular sector used as a clip
+ * mask, with N unrounded slice sectors painted inside. Each slice
+ * extends from its own start angle out to the band's full end angle,
+ * so adjacent colors overpaint each other's trailing edge — eliminates
+ * subpixel AA gaps between slices without an explicit overlap epsilon
+ * and means the staircase reveals one color per `sliceAngle` of arc.
+ *
+ * Canvas and SVG renderers both consume this: canvas builds Path2D
+ * objects from the strings, SVG drops them straight into `<path d="…"/>`.
+ */
+export interface GaugeGradientGeometryOptions {
+    innerRadius: number;
+    outerRadius: number;
+    startAngle: number;
+    endAngle: number;
+    cornerRadius?: number;
+    roundStart?: boolean;
+    roundEnd?: boolean;
+    colors: string[];
+}
+export interface GaugeGradientGeometry {
+    clipPath: string;
+    slices: {
+        d: string;
+        color: string;
+    }[];
+}
+export declare function buildGaugeGradientGeometry(opts: GaugeGradientGeometryOptions): GaugeGradientGeometry;

package/dist/components/stream/types.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { ScaleLinear } from "d3-scale";
 import type { AnimateProp } from "./pipelineTransitionUtils";
-import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
 import type { ArrowOfTime, WindowMode, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, HoverAnnotationConfig, HoverData, AnnotationContext, AnnotationAnchorMode } from "../realtime/types";
 import type { Datum } from "../charts/shared/datumTypes";
 import type { CoercibleNumber } from "./accessorUtils";
@@ -651,6 +651,7 @@ export interface StreamXYFrameProps<T = Datum> {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     /** Accessor used to report the current legend category domain in push mode. */
     legendCategoryAccessor?: string | ((d: T) => string);
     /** Fires when the current legend category domain changes after scene rebuilds. */

package/dist/components/types/legendTypes.d.ts

@@ -31,6 +31,20 @@ export declare function isLegendConfig(value: unknown): value is {
 export declare function isGradientLegendConfig(value: unknown): value is {
     gradient: GradientLegendConfig;
 };
+export interface LegendLayout {
+    /** Horizontal alignment for top/bottom legends within the plot width */
+    align?: "start" | "center" | "end" | "left" | "right";
+    /** Width/height of categorical swatches in pixels */
+    swatchSize?: number;
+    /** Gap between a swatch and its label in pixels */
+    labelGap?: number;
+    /** Gap between horizontal legend items in pixels */
+    itemGap?: number;
+    /** Vertical row height for stacked legend items in pixels */
+    rowHeight?: number;
+    /** Override the alignment width used for top/bottom legends */
+    maxWidth?: number;
+}
 export interface LegendProps {
     legendGroups?: LegendGroup[];
     customClickBehavior?: (item: LegendItem) => void;
@@ -46,4 +60,5 @@ export interface LegendProps {
     height?: number;
     orientation?: string;
     position?: "left" | "right";
+    legendLayout?: LegendLayout;
 }

package/dist/components/types/marginType.d.ts

@@ -8,8 +8,22 @@ export interface MarginType {
     left: number;
     right: number;
 }
+/** Public margin side value. Numbers pin a side to an exact pixel value.
+ *  `"auto"` and `null` explicitly leave that side to chart defaults plus
+ *  auto-reservation such as legends. */
+export type MarginSide = number | "auto" | null | undefined;
 /** Public-API margin shape. Users can pass any subset of sides (`{ left: 120 }`
  *  for wide y-axis labels is a common pattern) or a single number as shorthand
- *  for "same on all sides". The frame fills missing sides from the chart-mode
- *  defaults before handing a fully-resolved `MarginType` to the layout code. */
-export type PartialMargin = number | Partial<MarginType>;
+ *  for "same on all sides". Pass a side as `"auto"` or `null` to explicitly
+ *  opt back into chart auto-reservation for that side, e.g.
+ *  `{ right: "auto" }` with a right-side legend. The frame fills missing/auto
+ *  sides from chart-mode defaults before handing a fully-resolved
+ *  `MarginType` to the layout code. */
+export type PartialMargin = number | {
+    top?: MarginSide;
+    right?: MarginSide;
+    bottom?: MarginSide;
+    left?: MarginSide;
+};
+export declare function resolveMarginSide(value: MarginSide, fallback: number): number;
+export declare function normalizePartialMargin(m: PartialMargin | undefined): Partial<MarginType> | undefined;