semiotic 3.5.3 → 3.6.0

package/dist/components/charts/realtime/RealtimeHeatmap.capability.d.ts

@@ -0,0 +1,2 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+export declare const RealtimeHeatmapCapability: StreamChartCapability;

package/dist/components/charts/realtime/RealtimeHistogram.capability.d.ts

@@ -0,0 +1,2 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+export declare const RealtimeHistogramCapability: StreamChartCapability;

package/dist/components/charts/realtime/RealtimeHistogram.d.ts

@@ -6,6 +6,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { ChartMode, ChartAccessor, SelectionConfig } from "../shared/types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { Datum } from "../shared/datumTypes";
+export type RealtimeHistogramDirection = "up" | "down";
 export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
     /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
     mode?: ChartMode;
@@ -44,6 +45,14 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
     timeExtent?: [number, number];
     /** Fixed value domain */
     valueExtent?: [number, number];
+    /**
+     * Direction bars grow from the baseline.
+     * "up" uses the normal y-domain. "down" flips the resolved value
+     * domain so bars grow downward from the top, useful for mirrored
+     * histogram layouts. Explicit valueExtent is reversed.
+     * @default "up"
+     */
+    direction?: RealtimeHistogramDirection;
     /** Extent padding factor */
     extentPadding?: number;
     /**
@@ -175,6 +184,19 @@ export declare const RealtimeHistogram: {
     <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };
+export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
+    /** Static data array for a bounded temporal histogram. */
+    data: TDatum[];
+}
+/**
+ * Static-data sibling for temporal histograms. Use this when the data is a
+ * bounded array rather than a ref-driven stream; the realtime push API is not
+ * part of this public surface.
+ */
+export declare function TemporalHistogram<TDatum extends Datum = Datum>(props: TemporalHistogramProps<TDatum>): import("react/jsx-runtime").JSX.Element;
+export declare namespace TemporalHistogram {
+    var displayName: string;
+}
 /** @deprecated Use `RealtimeHistogram` (the canonical public name) instead. The
  *  `RealtimeTemporalHistogram` alias is preserved for back-compat with code
  *  written before the rename and will be removed in a future major version. */

package/dist/components/charts/realtime/RealtimeLineChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+export declare const RealtimeLineChartCapability: StreamChartCapability;

package/dist/components/charts/realtime/RealtimeSwarmChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+export declare const RealtimeSwarmChartCapability: StreamChartCapability;

package/dist/components/charts/realtime/RealtimeWaterfallChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+export declare const RealtimeWaterfallChartCapability: StreamChartCapability;

package/dist/components/charts/realtime/TemporalHistogram.capability.d.ts

@@ -0,0 +1,7 @@
+import type { StreamChartCapability } from "../../ai/streamingTypes";
+/**
+ * TemporalHistogram is the bounded sibling of RealtimeHistogram — same chart
+ * but for static data with a fixed window. For stream selection it competes
+ * with RealtimeHistogram; the choice depends on retention.
+ */
+export declare const TemporalHistogramCapability: StreamChartCapability;

package/dist/components/charts/shared/chartSpecs.d.ts

@@ -1,37 +1,3 @@
-/**
- * Single source of truth for per-chart prop specifications.
- *
- * Three downstream consumers used to maintain their own per-chart entries:
- *   - `ai/schema.json`                                    (LLM tool definitions)
- *   - `src/components/charts/shared/validationMap.ts`     (runtime prop validation)
- *   - `ai/componentMetadata.cjs`                          (category buckets)
- *
- * Today, `ai/schema.json` is generated from this registry — run
- * `npm run docs:chart-specs:schema` to refresh it after editing a spec.
- * `validationMap.ts` and `ai/componentMetadata.cjs` are still hand-edited
- * but are gated for parity by the registry: `check:chart-specs` (run via
- * `npm run check:chart-specs`) regenerates each chart's schema/
- * validation/metadata entries with the pure functions in
- * `scripts/lib/chart-specs-generators.mjs` and fails the build on any
- * drift, including unexpected adds or removes that bypass the registry.
- *
- * Design notes:
- *   - Shared prop bags (common, xyAxis, ordinalAxis) live in `PROP_BAGS` and
- *     are referenced by name in each spec so common surface stays in one place.
- *   - The runtime PropType set ("string" | "number" | "boolean" | "array" |
- *     "object" | "function") is broader than JSON Schema's, but the schema
- *     generator emits whatever types this registry declares — including
- *     "function" inside type unions (canonical entries like
- *     `RidgelinePlot.tooltip: ["function", "object"]` and
- *     `SwimlaneChart.onBrush: "function"` already use this convention; LLMs
- *     read the union and pick a non-function alternative when they can't
- *     supply a function value). For props that are purely callbacks or
- *     escape hatches an LLM cannot meaningfully populate, tag the spec
- *     with `omitFromSchema: true` to keep it in validationMap but out of
- *     schema.json. `description` and `default` annotations surface in
- *     schema.json (and MCP responses) but are dropped from validationMap
- *     (which only reads `type` and `enum`).
- */
 export type PropType = "string" | "number" | "boolean" | "array" | "object" | "function";
 export type DataShape = "array" | "object" | "network" | "realtime" | "none";
 export type ChartCategory = "xy" | "ordinal" | "network" | "geo" | "realtime";

package/dist/components/charts/shared/gaugeGradient.d.ts

@@ -0,0 +1,62 @@
+import type { Datum } from "./datumTypes";
+export interface GaugeThresholdLike {
+    value: number;
+    color: string;
+    label?: string;
+}
+export interface GaugeGradientStop {
+    offset: number;
+    color: string;
+}
+export interface GaugeGradientFill {
+    colorStops: GaugeGradientStop[];
+}
+export interface GaugeArcDatum extends Datum {
+    category: string;
+    value: number;
+    _zone?: string;
+    _isFill: boolean;
+    _pctStart?: number;
+    _pct?: number;
+    _roundedEnds?: {
+        start?: boolean;
+        end?: boolean;
+    };
+    _nonInteractive?: boolean;
+    /** Pre-computed gradient colors for the rendered band. Each entry is
+     *  the color for one equal-angle slice across the band's full angular
+     *  span. The wedge renderer reads this and paints the slices itself
+     *  inside a clip-mask shaped like the wedge's rounded outline. */
+    _gradientBand?: {
+        colors: string[];
+    };
+}
+export interface GaugeArcModel {
+    gaugeData: GaugeArcDatum[];
+    pieceStyle: (d: Datum, category?: string) => {
+        fill: string;
+        opacity?: number;
+    };
+    gaugeAnnotations: Datum[];
+}
+interface BuildGaugeArcModelOptions {
+    min: number;
+    max: number;
+    value: number;
+    thresholds?: GaugeThresholdLike[];
+    fillColor?: string;
+    backgroundColor: string;
+    fillZones: boolean;
+    showScaleLabels: boolean;
+    gradientFill?: GaugeGradientFill;
+    gradientSteps?: number;
+}
+/**
+ * Build the synthetic wedge data model used by GaugeChart.
+ *
+ * When `gradientFill` is provided, the visible fill is split into many thin
+ * slices and sampled against the supplied color stops so color changes along
+ * the arc length rather than by threshold zone.
+ */
+export declare function buildGaugeArcModel(options: BuildGaugeArcModelOptions): GaugeArcModel;
+export {};

package/dist/components/charts/shared/hooks.d.ts

@@ -1,7 +1,7 @@
 import { createLegend } from "./legendUtils";
 import type { SelectionHookResult } from "./selectionUtils";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-import type { Accessor, SelectionConfig, LinkedHoverProp, ChartMode } from "./types";
+import type { Accessor, SelectionConfig, LinkedHoverProp, ChartMode, HoverHighlightMode } from "./types";
 import type { MarginType, PartialMargin } from "../../types/marginType";
 import type { TransitionConfig } from "../../stream/types";
 import type { Datum } from "./datumTypes";
@@ -76,7 +76,7 @@ export declare function useChartSelection({ selection, linkedHover, fallbackFiel
         x: number;
         y: number;
     }) => void;
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     colorByField?: string;
 }): {
     activeSelectionHook: SelectionHookResult | null;

package/dist/components/charts/shared/streamPropsHelpers.d.ts

@@ -2,7 +2,7 @@ import type { ReactNode } from "react";
 import type { Datum } from "./datumTypes";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { HoverData } from "../../realtime/types";
-import type { LinkedHoverProp, SelectionConfig } from "./types";
+import type { HoverHighlightMode, LinkedHoverProp, SelectionConfig } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { AnimateProp } from "../../stream/pipelineTransitionUtils";
 /**
@@ -74,7 +74,7 @@ export declare function buildCustomBehaviorProps(input: {
         x: number;
         y: number;
     }) => void) | undefined;
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     customHoverBehavior: (d: Datum | null) => void;
     customClickBehavior: (d: Datum | null) => void;
     /**

package/dist/components/charts/shared/types.d.ts

@@ -43,6 +43,13 @@ export type LinkedBrushProp = string | {
  * User-provided props always override mode defaults.
  */
 export type ChartMode = "primary" | "context" | "sparkline";
+/**
+ * Hover highlighting mode.
+ * `true` and `"series"` both dim non-hovered series/categories; the string
+ * form is accepted for compatibility with wrapper libraries that expose a
+ * more explicit per-series mode.
+ */
+export type HoverHighlightMode = boolean | "series";
 /**
  * Base props shared across all chart components
  */
@@ -55,7 +62,9 @@ export interface BaseChartProps {
     height?: number;
     /** Margin around the chart. Accepts a number (same on all sides) or an object
      *  with any subset of `top`/`bottom`/`left`/`right`. Missing sides fall back
-     *  to the chart-mode defaults. */
+     *  to the chart-mode defaults. Use `"auto"` or `null` for a side to explicitly
+     *  allow chart auto-reservation, e.g. `margin={{ right: "auto" }}` with a
+     *  right-side legend. */
     margin?: PartialMargin;
     /** Auto-match width to parent container. Default: false */
     responsiveWidth?: boolean;
@@ -110,7 +119,7 @@ export interface BaseChartProps {
         y: number;
     }) => void;
     /** Dim non-hovered series when hovering a data mark. Requires `colorBy`. */
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     /** Max pixel distance for hover/click hit testing. Default 30. Increase for sparse charts, decrease for dense ones. */
     hoverRadius?: number;
     /** ID accessor for remove()/update() on XY charts. Extracts a unique identifier from each datum. */

package/dist/components/charts/shared/useChartSetup.d.ts

@@ -1,7 +1,7 @@
 import type { Datum } from "./datumTypes";
 import { useChartLegendAndMargin, useLegendInteraction, DEFAULT_COLOR } from "./hooks";
 import type { LegendInteractionMode, LegendPosition } from "./hooks";
-import type { Accessor, SelectionConfig, LinkedHoverProp } from "./types";
+import type { Accessor, SelectionConfig, LinkedHoverProp, HoverHighlightMode } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { PartialMargin } from "../../types/marginType";
 import type { SelectionHookResult } from "./selectionUtils";
@@ -57,7 +57,7 @@ export interface ChartSetupInput {
         y: number;
     }) => void;
     /** Dim non-hovered series on data mark hover */
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     /** Loading state */
     loading: boolean | undefined;
     /** Custom content rendered in place of the default skeleton while `loading` is true. */

package/dist/components/charts/shared/useCustomChartSetup.d.ts

@@ -3,7 +3,7 @@ import { useChartMode } from "./hooks";
 import { type ChartSetupResult } from "./useChartSetup";
 import type { ChartMode, SelectionConfig, LinkedHoverProp } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-import type { PartialMargin, MarginType } from "../../types/marginType";
+import { type PartialMargin, type MarginType } from "../../types/marginType";
 import type { Datum } from "./datumTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 /**

package/dist/components/charts/xy/AreaChart.capability.d.ts

@@ -0,0 +1,10 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+/**
+ * AreaChart is treated as a strictly single-series chart. Multi-series areas
+ * are an occlusion nightmare — when the data has 2+ series we subselect the
+ * leading series (largest cumulative y) and surface a caveat so the reader
+ * knows they're looking at one slice, not the whole dataset. For full multi-
+ * series comparison the engine routes callers to LineChart; for two-series
+ * comparison, to DifferenceChart.
+ */
+export declare const AreaChartCapability: ChartCapability;

package/dist/components/charts/xy/AreaChart.d.ts

@@ -6,6 +6,13 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { ForecastConfig, AnomalyConfig } from "../shared/statisticalOverlays";
+export interface SemanticGradientStop {
+    /** Percent from baseline to line/top. 0 = baseline, 100 = line/top. */
+    at: number;
+    color: string;
+    /** Optional opacity applied to this stop. */
+    opacity?: number;
+}
 /**
  * AreaChart component props
  */
@@ -90,6 +97,14 @@ export interface AreaChartProps<TDatum extends Datum = Datum> extends BaseChartP
             color: string;
         }>;
     };
+    /**
+     * Semantic area gradient stops expressed in user-facing percentages:
+     * `at: 0` is the baseline and `at: 100` is the line/top of the area.
+     * This is converted to `gradientFill.colorStops`, whose raw offsets use
+     * the renderer coordinate convention (`0` = top, `1` = baseline).
+     * When set, this takes precedence over `gradientFill`.
+     */
+    semanticGradient?: SemanticGradientStop[];
     /**
      * Area opacity (flat fill, ignored when gradientFill is set)
      * @default 0.7

package/dist/components/charts/xy/BubbleChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const BubbleChartCapability: ChartCapability;

package/dist/components/charts/xy/CandlestickChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const CandlestickChartCapability: ChartCapability;

package/dist/components/charts/xy/ConnectedScatterplot.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const ConnectedScatterplotCapability: ChartCapability;

package/dist/components/charts/xy/DifferenceChart.capability.d.ts

@@ -0,0 +1,8 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+/**
+ * DifferenceChart's native shape is two series. When the input has 2+ series
+ * we subselect the top two by total y and pivot them into the wide form the
+ * chart expects — same "narrow the dataset to make the chart honest" pattern
+ * AreaChart uses for its single-series fallback.
+ */
+export declare const DifferenceChartCapability: ChartCapability;

package/dist/components/charts/xy/Heatmap.capability.d.ts

@@ -0,0 +1,9 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+/**
+ * Heatmap is a matrix: categorical × categorical (or temporal × categorical),
+ * with a numeric encoded as color. Without two genuine discrete dimensions
+ * for the axes, a heatmap of raw rows is sparse and unreadable. Tuned in
+ * Phase 2.1 after the scorecard surfaced Heatmap winning unsuitable
+ * compare-categories rankings.
+ */
+export declare const HeatmapCapability: ChartCapability;

package/dist/components/charts/xy/LineChart.capability.d.ts

@@ -0,0 +1,9 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+/**
+ * LineChart capability — declares what data shapes LineChart serves well,
+ * what intents it answers, and what variants change those answers.
+ *
+ * Read alongside `LineChart.tsx`; this file is what makes the chart
+ * "self-aware" for suggestion and interrogation flows.
+ */
+export declare const LineChartCapability: ChartCapability;

package/dist/components/charts/xy/MinimapChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const MinimapChartCapability: ChartCapability;

package/dist/components/charts/xy/MultiAxisLineChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const MultiAxisLineChartCapability: ChartCapability;

package/dist/components/charts/xy/QuadrantChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const QuadrantChartCapability: ChartCapability;

package/dist/components/charts/xy/QuadrantChart.d.ts

@@ -30,6 +30,9 @@ export interface QuadrantsConfig {
     bottomRight: QuadrantConfig;
     bottomLeft: QuadrantConfig;
 }
+export type QuadrantsConfigOverride = {
+    [TQuadrant in keyof QuadrantsConfig]?: Partial<QuadrantsConfig[TQuadrant]>;
+};
 /**
  * Centerline style configuration
  */
@@ -55,8 +58,8 @@ export interface QuadrantChartProps<TDatum extends Datum = Datum> extends BaseCh
     xCenter?: number;
     /** Y-coordinate of the horizontal center line. Defaults to midpoint of y domain. */
     yCenter?: number;
-    /** Quadrant configuration: labels and colors for each of the four quadrants */
-    quadrants: QuadrantsConfig;
+    /** Optional quadrant overrides. Omitted quadrants and quadrant fields fall back to built-in defaults. */
+    quadrants?: QuadrantsConfigOverride;
     /** Style for the center lines */
     centerlineStyle?: CenterlineStyle;
     /** Show quadrant labels @default true */

package/dist/components/charts/xy/QuadrantChart.defaults.d.ts

@@ -0,0 +1,2 @@
+import type { QuadrantsConfig } from "./QuadrantChart";
+export declare const DEFAULT_QUADRANTS: QuadrantsConfig;

package/dist/components/charts/xy/Scatterplot.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const ScatterplotCapability: ChartCapability;

package/dist/components/charts/xy/StackedAreaChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const StackedAreaChartCapability: ChartCapability;

package/dist/components/data/DataSummarizer.d.ts

@@ -0,0 +1,45 @@
+import type { Datum } from "../charts/shared/datumTypes";
+export type FieldType = "numeric" | "categorical" | "date" | "unknown";
+export interface NumericFieldSummary {
+    type: "numeric";
+    min: number;
+    max: number;
+    mean: number;
+    median: number;
+}
+export interface DateFieldSummary {
+    type: "date";
+    min: string;
+    max: string;
+}
+export interface CategoricalFieldSummary {
+    type: "categorical";
+    distinctCount: number;
+    topValues: ReadonlyArray<{
+        value: string;
+        count: number;
+    }>;
+    distinctValues?: ReadonlyArray<string>;
+}
+export interface UnknownFieldSummary {
+    type: "unknown";
+}
+export type FieldSummary = NumericFieldSummary | DateFieldSummary | CategoricalFieldSummary | UnknownFieldSummary;
+export interface DataSummary {
+    rowCount: number;
+    fields: Record<string, FieldSummary>;
+    sample: ReadonlyArray<Datum>;
+}
+export interface SummarizeOptions {
+    maxDistinct?: number;
+    sampleSize?: number;
+    /** Scan up to this many rows when discovering field keys (handles ragged rows). */
+    keyScanRows?: number;
+}
+/**
+ * Summarize a dataset for an LLM. Returns row count, per-field statistics, and a small sample.
+ *
+ * Designed so a model can answer questions about ranges, peaks, distributions, and categories
+ * without seeing the full dataset.
+ */
+export declare function summarizeData(data: ReadonlyArray<Datum> | null | undefined, options?: SummarizeOptions): DataSummary;

package/dist/components/semiotic-ai.d.ts

@@ -37,7 +37,7 @@ export { Treemap } from "./charts/network/Treemap";
 export { CirclePack } from "./charts/network/CirclePack";
 export { OrbitDiagram } from "./charts/network/OrbitDiagram";
 export { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-export { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+export { RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 export { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 export { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
@@ -66,6 +66,41 @@ export { serializeSelections, deserializeSelections } from "./export/selectionSe
 export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
 export { fromVegaLite } from "./data/fromVegaLite";
 export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { useChartInterrogation } from "./store/useChartInterrogation";
+export type { UseChartInterrogationOptions, UseChartInterrogationResult, InterrogationContext, InterrogationFocus, InterrogationResult, InterrogationQuery, InterrogationMessage, } from "./store/useChartInterrogation";
+export { useChartFocus } from "./store/useChartFocus";
+export type { UseChartFocusOptions } from "./store/useChartFocus";
+export { summarizeData } from "./data/DataSummarizer";
+export type { DataSummary, FieldSummary, FieldType, NumericFieldSummary, DateFieldSummary, CategoricalFieldSummary, UnknownFieldSummary, SummarizeOptions, } from "./data/DataSummarizer";
+export { profileData } from "./ai/profileData";
+export type { ProfileDataOptions } from "./ai/profileData";
+export { suggestCharts, scoreChart, explainCapabilityFit } from "./ai/suggestCharts";
+export type { SuggestChartsOptions, RejectedCapability, ExplainCapabilityFitResult, } from "./ai/suggestCharts";
+export { inferIntent } from "./ai/inferIntent";
+export type { InferIntentResult } from "./ai/inferIntent";
+export { suggestDashboard } from "./ai/suggestDashboard";
+export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions, } from "./ai/suggestDashboard";
+export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, } from "./ai/audienceProfile";
+export type { AudienceProfile, AudienceTarget, AudienceBiasResult, } from "./ai/audienceProfile";
+export { executivePersona, analystPersona, dataScientistPersona, BUILT_IN_AUDIENCES, } from "./ai/audiences";
+export { suggestStretchCharts } from "./ai/suggestStretchCharts";
+export type { StretchSuggestion, SuggestStretchChartsOptions, } from "./ai/suggestStretchCharts";
+export { suggestStreamCharts, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities, } from "./ai/suggestStreamCharts";
+export type { SuggestStreamChartsOptions } from "./ai/suggestStreamCharts";
+export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamChartCapability, StreamIntentScorer, StreamSuggestion, } from "./ai/streamingTypes";
+export { diffProfile } from "./ai/diffProfile";
+export type { ProfileDiff, FieldTypeChange, PrimaryRoleChange, PrimaryRole } from "./ai/diffProfile";
+export { repairChartConfig } from "./ai/repairChartConfig";
+export type { RepairResult, RepairOkResult, RepairAlternativeResult, RepairUnknownResult, RepairOptions, } from "./ai/repairChartConfig";
+export { runQualityScorecard } from "./ai/qualityScorecard";
+export type { ScorecardFixture, ScorecardReport, PerCapabilityScore, PerFixtureScore, } from "./ai/qualityScorecard";
+export { CANONICAL_FIXTURES } from "./ai/qualityFixtures";
+export { useChartSuggestions } from "./ai/useChartSuggestions";
+export type { UseChartSuggestionsOptions, UseChartSuggestionsResult } from "./ai/useChartSuggestions";
+export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability, } from "./ai/chartCapabilities";
+export type { ChartCapability, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, Suggestion, } from "./ai/chartCapabilityTypes";
+export { listIntents, getIntent, registerIntent, BUILT_IN_INTENT_IDS } from "./ai/intents";
+export type { BuiltInIntentId, IntentId, IntentDescriptor } from "./ai/intents";
 export { useChartObserver } from "./store/useObservation";
 export type { UseChartObserverOptions, UseChartObserverResult } from "./store/useObservation";
 export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation } from "./store/ObservationStore";

package/dist/components/semiotic-realtime.d.ts

@@ -7,13 +7,13 @@ import StreamNetworkFrame from "./stream/StreamNetworkFrame";
 import { RingBuffer } from "./realtime/RingBuffer";
 import { IncrementalExtent } from "./realtime/IncrementalExtent";
 import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-import { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
+export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
 export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
-export type { RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

package/dist/components/semiotic-server.d.ts

@@ -1,5 +1,6 @@
 export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG, renderGeoToStaticSVG, renderChart, renderToImage, renderDashboard, } from "./server/renderToStaticSVG";
 export type { RenderToImageOptions, DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
+export type { LegendLayout } from "./types/legendTypes";
 export { renderToAnimatedGif, generateFrameSVGs, generateFrameSequence } from "./server/animatedGif";
 export type { AnimatedGifOptions } from "./server/animatedGif";
 export { resolveTheme, themeStyles } from "./server/themeResolver";

package/dist/components/semiotic-xy.d.ts

@@ -21,14 +21,14 @@ export { XYCustomChart } from "./charts/custom/XYCustomChart";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
 export type { CustomLayout, LayoutContext, LayoutResult } from "./stream/customLayout";
 export type { LineChartProps } from "./charts/xy/LineChart";
-export type { AreaChartProps } from "./charts/xy/AreaChart";
+export type { AreaChartProps, SemanticGradientStop } from "./charts/xy/AreaChart";
 export type { DifferenceChartProps } from "./charts/xy/DifferenceChart";
 export type { StackedAreaChartProps } from "./charts/xy/StackedAreaChart";
 export type { ScatterplotProps } from "./charts/xy/Scatterplot";
 export type { ConnectedScatterplotProps } from "./charts/xy/ConnectedScatterplot";
 export type { BubbleChartProps } from "./charts/xy/BubbleChart";
 export type { HeatmapProps } from "./charts/xy/Heatmap";
-export type { QuadrantChartProps } from "./charts/xy/QuadrantChart";
+export type { QuadrantChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle } from "./charts/xy/QuadrantChart";
 export type { MultiAxisLineChartProps } from "./charts/xy/MultiAxisLineChart";
 export type { CandlestickChartProps } from "./charts/xy/CandlestickChart";
 export type { XYCustomChartProps } from "./charts/custom/XYCustomChart";

package/dist/components/semiotic.d.ts

@@ -19,12 +19,13 @@ import { Tooltip, MultiLineTooltip, normalizeTooltip } from "./Tooltip/Tooltip";
 import { RingBuffer } from "./realtime/RingBuffer";
 import { IncrementalExtent } from "./realtime/IncrementalExtent";
 import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
-export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
+export type { LegendLayout } from "./types/legendTypes";
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, SemanticGradientStop, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
 export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn, XYFrameAxisConfig, BandConfig } from "./stream/types";
 export type { StreamRendererFn } from "./stream/renderers/types";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
@@ -57,7 +58,7 @@ export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
 export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "./Tooltip/Tooltip";
 export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, AnnotationAnchorMode, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
 export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
-export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

package/dist/components/server/renderToStaticSVG.d.ts

@@ -1,4 +1,5 @@
 import type { Datum } from "../charts/shared/datumTypes";
+import type { LegendLayout } from "../types/legendTypes";
 /**
  * Server-side rendering of Semiotic charts to standalone SVG strings.
  *
@@ -33,6 +34,7 @@ interface ThemeAwareProps {
     background?: string;
     className?: string;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     /** Prefix for SVG element IDs — used by renderDashboard to avoid collisions */
     _idPrefix?: string;
 }