semiotic 3.8.0 → 3.8.2

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

@@ -1,4 +1,5 @@
 import * as React from "react";
+import type { Datum, DatumValue } from "./datumTypes";
 interface SafeRenderProps {
     componentName: string;
     width: number;
@@ -25,7 +26,7 @@ export declare function SafeRender({ componentName, width, height, children }: S
  * Renders a "No data available" placeholder when data is empty.
  * Returns null when data is present or emptyContent is `false`.
  */
-export declare function renderEmptyState(data: any[] | undefined | null, width: number, height: number, emptyContent?: React.ReactNode | false): React.ReactElement | null;
+export declare function renderEmptyState(data: Datum[] | undefined | null, width: number, height: number, emptyContent?: React.ReactNode | false): React.ReactElement | null;
 /**
  * Renders a loading placeholder while `loading` is true.
  *
@@ -39,7 +40,7 @@ export declare function renderEmptyState(data: any[] | undefined | null, width:
  */
 export declare function renderLoadingState(loading: boolean | undefined, width: number, height: number, loadingContent?: React.ReactNode | false): React.ReactElement | null;
 /** Warn if a string accessor isn't found in the first data element */
-export declare function warnMissingField(componentName: string, data: any[] | undefined, accessorName: string, accessorValue: any): void;
+export declare function warnMissingField(componentName: string, data: Datum[] | undefined, accessorName: string, accessorValue: DatumValue): void;
 /** Warn if data looks like the wrong shape for this chart type */
-export declare function warnDataShape(componentName: string, data: any[] | undefined, expectedKeys: string[], hint: string): void;
+export declare function warnDataShape(componentName: string, data: Array<Datum | string | number | boolean | null | undefined> | undefined, expectedKeys: string[], hint: string): void;
 export {};

package/dist/components/charts/value/targetPresentation.d.ts

@@ -0,0 +1,22 @@
+import type { BigNumberFormat, BigNumberTarget } from "./types";
+export interface TargetPresentation {
+    label: string | undefined;
+    percent: string | null;
+    formattedValue: string;
+    text: string;
+}
+interface UseTargetPresentationOptions {
+    target: BigNumberTarget | undefined;
+    value: number | null | undefined;
+    format: BigNumberFormat | undefined;
+    locale: string | undefined;
+    currency: string | undefined;
+    precision: number | undefined;
+}
+/**
+ * Format a finite target once for both visible chrome and the accessible
+ * sentence. Invalid target values are omitted rather than announcing NaN or
+ * infinity.
+ */
+export declare function useTargetPresentation({ target, value, format, locale, currency, precision }: UseTargetPresentationOptions): TargetPresentation | null;
+export {};

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

@@ -70,7 +70,7 @@ export interface BigNumberThreshold {
     level: BigNumberLevel;
     /** Explicit colour override; otherwise `var(--semiotic-{level})`. */
     color?: string;
-    /** Optional label surfaced in tooltips, the ARIA sentence, and capability output. */
+    /** Optional label appended to the generated ARIA sentence. */
     label?: string;
 }
 /**
@@ -252,11 +252,10 @@ export interface BigNumberProps<_TDatum extends Datum = Datum> {
      *  full-width and stacks the chart at full card width under the delta
      *  row. */
     trendSlot?: BigNumberSlot;
-    /** **Square** chart embedded beside the value — e.g. a `DonutChart` /
-     *  `PieChart` / `Scatterplot` / `Treemap`. When set, the card splits
-     *  into a left column (header + value + delta) and a right column
-     *  (the square chart). Compose with `trendSlot` to get both
-     *  (square chart on the right, wide trend along the bottom). */
+    /** **Square** chart anchored as a top-right card decoration — e.g. a
+     *  `DonutChart` / `PieChart` / `Scatterplot` / `Treemap`. The header
+     *  reserves its corner; choose `chartSize` to leave room for large values
+     *  or compose with `trendSlot` for a wide chart along the bottom. */
     chartSlot?: BigNumberSlot;
     /** Reserved pixel size (square) for `chartSlot`. Defaults are
      *  mode-keyed for sparkline scale — 44 px for `tile`, 80 px for

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
 import type { ForecastConfig, AnomalyConfig } from "../shared/statisticalOverlays";
 export interface SemanticGradientStop {
     /** Percent from baseline to line/top. 0 = baseline, 100 = line/top. */
@@ -65,6 +66,13 @@ export interface AreaChartProps<TDatum extends Datum = Datum> extends BaseChartP
      * @default "category10"
      */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware area styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins. Per-SERIES (resolves against the series'
+     * sample datum). A rule `fill` may be a color or a HatchFill — hatch an
+     * "uncertain"/"projected" series. Layers over the resolved series color.
+     */
+    styleRules?: StyleRule[];
     /**
      * Curve interpolation type
      * @default "monotoneX"

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
 import { type RegressionProp } from "../shared/regressionUtils";
 /**
  * BubbleChart component props
@@ -56,6 +57,14 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
      * @default "category10"
      */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware bubble styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins per property. `when` accepts a predicate
+     * (`ctx` = `{ value, x, y, size, category }`), a declarative threshold
+     * (`{ axis: "x"|"y", gt, … }`), or `true`. A rule's `fill` may be a color or
+     * a HatchFill. Layers over the resolved base color.
+     */
+    styleRules?: StyleRule[];
     /**
      * Bubble opacity
      * @default 0.6

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 import { type RegressionProp } from "../shared/regressionUtils";
 import type { ForecastConfig, AnomalyConfig } from "../shared/statisticalOverlays";
 /**
@@ -25,6 +26,12 @@ export interface ConnectedScatterplotProps<TDatum extends Datum = Datum> extends
     orderAccessor?: string | ((d: TDatum) => number | Date);
     /** Label for the ordering metric in tooltips @default "Order" or the accessor field name */
     orderLabel?: string;
+    /**
+     * Declarative, threshold-aware point styling (see Scatterplot). Ordered
+     * `{ when, style }` rules; last applicable rule wins. Layers over the
+     * order-derived base fill.
+     */
+    styleRules?: StyleRule[];
     /** Point radius @default 4 */
     pointRadius?: number;
     /** Enable hover annotations @default true */

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+export { computeDifferenceSegments } from "./differenceSegments";
 /**
  * DifferenceChart props
  */
@@ -75,57 +76,6 @@ export interface DifferenceChartProps<TDatum extends Datum = Datum> extends Base
     /** Pass-through StreamXYFrame props. */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
-/**
- * Crossover-segmented record used by the area pipeline. One row per
- * vertex along either the upper or lower boundary; `__diffSegment` is a
- * group key per segment so the area scene builder produces one polygon
- * per id with the correct fill color.
- */
-interface SegmentRow {
-    __x: number;
-    /** Upper boundary y value (max of A, B). The area pipeline reads this. */
-    __y: number;
-    /** Lower boundary y value (min of A, B) — picked up as per-datum y0. */
-    __y0: number;
-    /** Segment id. Format: `"seg-<index>-<winner>"`. */
-    __diffSegment: string;
-    /** Which series is on top in this segment ("A" or "B"). Drives fill. */
-    __diffWinner: "A" | "B";
-    /** Original A value at this x (or interpolated at crossovers). */
-    __valA: number;
-    /** Original B value at this x (or interpolated at crossovers). */
-    __valB: number;
-    /** Original datum (for tooltip lookup at non-crossover vertices). */
-    __sourceDatum?: Datum;
-}
-/**
- * Walk sorted data, splitting at each A↔B crossover. Inserts an
- * interpolated vertex on BOTH sides of every crossover so adjacent
- * segments meet at a zero-width point (no jagged edges).
- *
- * Non-finite rows are skipped; the algorithm tracks the most recent
- * VALID non-tie row (not the index neighbor) for crossover detection,
- * so a non-finite gap doesn't drop a crossover that straddles it.
- *
- * Tie rows (a === b) are handled distinctly from non-tie rows:
- *
- *   - When a tie row sits BETWEEN two non-tie rows with the SAME
- *     winner, the tie is emitted in that winner's segment as a
- *     zero-width vertex.
- *   - When a tie row sits between non-tie rows with DIFFERENT winners,
- *     the FIRST tie of the run becomes the crossover vertex. The old
- *     segment closes at the tie's x, the new segment opens at the same
- *     point, and any subsequent tie rows (multi-tie runs) carry into
- *     the new segment as zero-width vertices.
- *
- * This preserves the data's actual zero-difference point: if the user
- * supplied a tie row explicitly, the fill switches color exactly at
- * that x rather than at a linear-interpolated x that ignored the tie.
- *
- * Exported for direct unit-testing — the area pipeline depends on the
- * exact crossover-vertex shape produced here.
- */
-export declare function computeDifferenceSegments<TDatum extends Datum>(raw: TDatum[], getX: (d: TDatum) => number, getA: (d: TDatum) => number, getB: (d: TDatum) => number): SegmentRow[];
 /**
  * DifferenceChart — fills the area between two series with a color
  * that switches based on which series is higher at each x. Crossover
@@ -169,4 +119,3 @@ export declare const DifferenceChart: {
     <TDatum extends Datum = Datum>(props: DifferenceChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };
-export {};

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

@@ -43,7 +43,7 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
     /**
      * Format function for x-axis tick labels
      */
-    xFormat?: (d: any, index?: number, allTicks?: number[]) => string;
+    xFormat?: (d: string | number | Date, index?: number, allTicks?: number[]) => string;
     /**
      * Format function for y-axis tick labels
      */
@@ -64,7 +64,7 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
      * customColorScale={scaleSequential(interpolatePlasma).domain([0, 100])}
      * ```
      */
-    customColorScale?: any;
+    customColorScale?: (value: number) => string;
     /**
      * Show values in cells
      * @default false

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
 import type { AnomalyConfig, ForecastConfig } from "../shared/statisticalOverlays";
 /**
  * LineChart component props
@@ -74,6 +75,16 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
      * @default "category10"
      */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware line styling. Ordered `{ when, style }`
+     * rules; last applicable rule wins per property. NOTE: line styles resolve
+     * per-SERIES against the series' first data point, so a rule's `ctx.x`/`ctx.y`
+     * reflect that sample, not every vertex (use it to recolor a whole series by
+     * a representative value). `when` accepts a predicate, a threshold
+     * (`{ axis: "x"|"y", … }`), or `true`. A rule `stroke`/`fill` may be a color
+     * or a HatchFill. Layers over the resolved series color.
+     */
+    styleRules?: StyleRule[];
     /**
      * Curve interpolation type
      * @default "linear"

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 /**
  * Quadrant label and color configuration
  */
@@ -70,6 +71,12 @@ export interface QuadrantChartProps<TDatum extends Datum = Datum> extends BaseCh
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme for categorical data @default "category10" */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware point styling (see Scatterplot). Ordered
+     * `{ when, style }` rules; last applicable rule wins. Layers over the
+     * quadrant-derived base fill; `frameProps.pointStyle` still overrides.
+     */
+    styleRules?: StyleRule[];
     /** Field name or function to determine point size */
     sizeBy?: ChartAccessor<TDatum, number>;
     /** Min and max radius for points @default [3, 15] */

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

@@ -6,6 +6,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import { type StyleRule } from "../shared/styleRules";
 import { type RegressionProp } from "../shared/regressionUtils";
 import type { ForecastConfig, AnomalyConfig } from "../shared/statisticalOverlays";
 /**
@@ -26,6 +27,15 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme for categorical data or custom colors array @default "category10" */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware point styling. Ordered `{ when, style }`
+     * rules; the last applicable rule wins per property. `when` accepts a
+     * predicate `(datum, ctx) => boolean` (`ctx` = `{ value, x, y, category }`),
+     * a declarative threshold (`{ axis: "x"|"y", gt, lte, within, in, … }` —
+     * target either axis regardless of accessor field name), or `true`. A rule's
+     * `fill` may be a color or a HatchFill. Layers over the resolved base color.
+     */
+    styleRules?: StyleRule[];
     /** Field name or function to determine point size */
     sizeBy?: ChartAccessor<TDatum, number>;
     /** Min and max radius for points @default [3, 15] */

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

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
 /**
  * StackedAreaChart component props
  */
@@ -56,6 +57,12 @@ export interface StackedAreaChartProps<TDatum extends Datum = Datum> extends Bas
      * @default "category10"
      */
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Declarative, threshold-aware styling for the stacked series. Ordered
+     * `{ when, style }` rules; last applicable rule wins. Per-SERIES. A rule
+     * `fill` may be a color or a HatchFill. Layers over the resolved series color.
+     */
+    styleRules?: StyleRule[];
     /**
      * Curve interpolation type
      * @default "monotoneX"

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

@@ -0,0 +1,49 @@
+import type { Datum } from "../shared/datumTypes";
+/**
+ * Crossover-segmented record used by the area pipeline. One row per
+ * vertex along either the upper or lower boundary; `__diffSegment` is a
+ * group key per segment so the area scene builder produces one polygon
+ * per id with the correct fill color.
+ */
+export interface SegmentRow {
+    __x: number;
+    /** Upper boundary y value (max of A, B). The area pipeline reads this. */
+    __y: number;
+    /** Lower boundary y value (min of A, B) — picked up as per-datum y0. */
+    __y0: number;
+    /** Segment id. Format: `"seg-<index>-<winner>"`. */
+    __diffSegment: string;
+    /** Which series is on top in this segment ("A" or "B"). Drives fill. */
+    __diffWinner: "A" | "B";
+    /** Original A value at this x (or interpolated at crossovers). */
+    __valA: number;
+    /** Original B value at this x (or interpolated at crossovers). */
+    __valB: number;
+    /** Original datum (for tooltip lookup at non-crossover vertices). */
+    __sourceDatum?: Datum;
+}
+/**
+ * Walk sorted data, splitting at each A↔B crossover. Inserts an
+ * interpolated vertex on BOTH sides of every crossover so adjacent
+ * segments meet at a zero-width point (no jagged edges).
+ *
+ * Non-finite rows are skipped; the algorithm tracks the most recent
+ * VALID non-tie row (not the index neighbor) for crossover detection,
+ * so a non-finite gap doesn't drop a crossover that straddles it.
+ *
+ * Tie rows (a === b) are handled distinctly from non-tie rows:
+ *
+ *   - When a tie row sits BETWEEN two non-tie rows with the SAME
+ *     winner, the tie is emitted in that winner's segment as a
+ *     zero-width vertex.
+ *   - When a tie row sits between non-tie rows with DIFFERENT winners,
+ *     the FIRST tie of the run becomes the crossover vertex. The old
+ *     segment closes at the tie's x, the new segment opens at the same
+ *     point, and any subsequent tie rows (multi-tie runs) carry into
+ *     the new segment as zero-width vertices.
+ *
+ * This preserves the data's actual zero-difference point: if the user
+ * supplied a tie row explicitly, the fill switches color exactly at
+ * that x rather than at a linear-interpolated x that ignored the tie.
+ */
+export declare function computeDifferenceSegments<TDatum extends Datum>(raw: TDatum[], getX: (d: TDatum) => number, getA: (d: TDatum) => number, getB: (d: TDatum) => number): SegmentRow[];

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

@@ -0,0 +1,12 @@
+import type { D3BrushEvent } from "d3-brush";
+import type { Datum } from "../shared/datumTypes";
+export interface ScatterplotMatrixHoverInfo {
+    datum: Datum;
+    xField: string;
+    yField: string;
+    colIndex: number;
+    rowIndex: number;
+    px: number;
+    py: number;
+}
+export declare function isTwoDimensionalBrushSelection(selection: D3BrushEvent<Datum>["selection"]): selection is [[number, number], [number, number]];

package/dist/components/controls/SentenceFilter.d.ts

@@ -0,0 +1,97 @@
+import * as React from "react";
+export type SentenceFilterPrimitive = string | number | boolean | null;
+export type SentenceFilterValue = SentenceFilterPrimitive | string[] | number[] | [number, number];
+export interface SentenceFilterOption<T = SentenceFilterPrimitive> {
+    value: T;
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    count?: number;
+    disabled?: boolean;
+    keywords?: string[];
+}
+export interface SentenceFilterBaseDefinition<T = SentenceFilterValue> {
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    emptyLabel?: React.ReactNode;
+    accent?: string;
+    formatValue?: (value: T, filters: Record<string, SentenceFilterValue>) => React.ReactNode;
+    getAccessibleValue?: (value: T, filters: Record<string, SentenceFilterValue>) => string;
+}
+export interface SentenceFilterSelectDefinition extends SentenceFilterBaseDefinition {
+    type: "select";
+    options: SentenceFilterOption[];
+    searchable?: boolean;
+}
+export interface SentenceFilterMultiSelectDefinition extends SentenceFilterBaseDefinition {
+    type: "multiselect";
+    options: SentenceFilterOption[];
+    searchable?: boolean;
+    conjunction?: "and" | "or";
+}
+export interface SentenceFilterNumberDefinition extends SentenceFilterBaseDefinition<number> {
+    type: "number";
+    min?: number;
+    max?: number;
+    step?: number;
+    inputMode?: "input" | "slider" | "both";
+}
+export interface SentenceFilterRangeDefinition extends SentenceFilterBaseDefinition<[number, number]> {
+    type: "range";
+    min: number;
+    max: number;
+    step?: number;
+}
+export interface SentenceFilterToggleDefinition extends SentenceFilterBaseDefinition<boolean> {
+    type: "toggle";
+    trueLabel?: React.ReactNode;
+    falseLabel?: React.ReactNode;
+}
+export interface SentenceFilterTextDefinition extends SentenceFilterBaseDefinition<string> {
+    type: "text";
+    suggestions?: SentenceFilterOption<string>[];
+    placeholder?: string;
+}
+export type SentenceFilterDefinition = SentenceFilterSelectDefinition | SentenceFilterMultiSelectDefinition | SentenceFilterNumberDefinition | SentenceFilterRangeDefinition | SentenceFilterToggleDefinition | SentenceFilterTextDefinition;
+export interface SentenceFilterChangeMeta {
+    key: string;
+    previousValue: SentenceFilterValue;
+    value: SentenceFilterValue;
+    source: "pointer" | "keyboard" | "input" | "clear" | "programmatic";
+}
+export interface SentenceFilterRenderContext {
+    key: string;
+    value: SentenceFilterValue;
+    filters: Record<string, SentenceFilterValue>;
+    definition: SentenceFilterDefinition;
+    setValue: (value: SentenceFilterValue, source?: SentenceFilterChangeMeta["source"]) => void;
+    close: () => void;
+}
+export interface SentenceFilterProps {
+    sentence: string;
+    /** Controlled filter values. */
+    filters?: Record<string, SentenceFilterValue>;
+    /** Initial values for the optional uncontrolled form. */
+    defaultFilters?: Record<string, SentenceFilterValue>;
+    definitions: Record<string, SentenceFilterDefinition>;
+    onChange?: (filters: Record<string, SentenceFilterValue>, meta: SentenceFilterChangeMeta) => void;
+    as?: React.ElementType;
+    className?: string;
+    style?: React.CSSProperties;
+    size?: "small" | "medium" | "large" | "inherit";
+    align?: "start" | "center" | "end";
+    wrap?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    ariaLabel?: string;
+    id?: string;
+    renderControl?: (context: SentenceFilterRenderContext) => React.ReactNode;
+    onOpenChange?: (key: string | null) => void;
+}
+/**
+ * An editorial, natural-language filter control. Values are native inline
+ * buttons and their editors open in an accessible non-modal dialog.
+ */
+export declare function SentenceFilter({ sentence, filters: controlledFilters, defaultFilters, definitions, onChange, as: As, className, style, size, align, wrap, disabled, readOnly, ariaLabel, id, renderControl, onOpenChange, }: SentenceFilterProps): React.ReactElement;
+export default SentenceFilter;

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Vega-Lite to Semiotic translator.
  * Converts a Vega-Lite spec into a Semiotic ChartConfig.
@@ -13,26 +14,25 @@ export interface VegaLiteEncoding {
     aggregate?: string;
     scale?: {
         scheme?: string;
-        range?: any;
-        domain?: any;
+        range?: Array<string | number>;
+        domain?: Array<string | number | boolean | Date>;
     };
     axis?: {
         title?: string;
         labelAngle?: number;
     };
-    value?: any;
+    value?: string | number | boolean | null;
     bin?: boolean | {
         maxbins?: number;
     };
     stack?: boolean | string | null;
 }
 export interface VegaLiteSpec {
-    mark: string | {
+    mark: string | ({
         type: string;
-        [key: string]: any;
-    };
+    } & Datum);
     data?: {
-        values?: any[];
+        values?: Datum[];
         url?: string;
     };
     encoding?: Record<string, VegaLiteEncoding>;
@@ -41,8 +41,18 @@ export interface VegaLiteSpec {
     title?: string | {
         text: string;
     };
-    transform?: any[];
-    [key: string]: any;
+    transform?: Datum[];
+    layer?: VegaLiteSpec[];
+    hconcat?: VegaLiteSpec[];
+    vconcat?: VegaLiteSpec[];
+    concat?: VegaLiteSpec[];
+    facet?: Datum;
+    repeat?: Datum | string[];
+    params?: Datum[];
+    selection?: Datum;
+    usermeta?: Datum & {
+        idid?: Datum;
+    };
 }
 /** Strictness for the typed, experimental Vega-Lite import result. */
 export interface FromVegaLiteOptions {

package/dist/components/rough/createRoughRenderMode.d.ts

@@ -0,0 +1,46 @@
+import type { SceneDatum, SceneRenderBackend, Style } from "../stream/types";
+import type { Datum } from "../charts/shared/datumTypes";
+type RoughSceneNode = Datum & {
+    type?: string;
+    style?: Style;
+    datum?: SceneDatum;
+};
+export interface RoughRenderModeOptions {
+    /** Base seed. Each scene identity derives a stable non-zero Rough.js seed. @default 1 */
+    seed?: number;
+    roughness?: number;
+    bowing?: number;
+    maxRandomnessOffset?: number;
+    curveFitting?: number;
+    curveTightness?: number;
+    curveStepCount?: number;
+    fillStyle?: "hachure" | "solid" | "zigzag" | "cross-hatch" | "dots" | "dashed" | "zigzag-line";
+    fillWeight?: number;
+    hachureAngle?: number;
+    hachureGap?: number;
+    dashOffset?: number;
+    dashGap?: number;
+    zigzagOffset?: number;
+    disableMultiStroke?: boolean;
+    disableMultiStrokeFill?: boolean;
+    preserveVertices?: boolean;
+    simplification?: number;
+    fixedDecimalPlaceDigits?: number;
+    /** Maximum reusable drawables retained by this mode instance. @default 1000 */
+    cacheSize?: number;
+}
+export interface RoughRenderMode extends SceneRenderBackend<RoughSceneNode> {
+    readonly id: "roughjs";
+    readonly seed: number;
+    readonly cacheEntries: number;
+    clearCache(): void;
+}
+/** Deterministic FNV-1a seed helper suitable for Rough.js's non-zero seed range. */
+export declare function stableRoughSeed(value: unknown): number;
+/**
+ * Create an explicit optional Rough.js scene backend. Keep one instance (for
+ * example with `useMemo`) so its deterministic drawables can be reused across
+ * hover, selection, and Canvas repaints.
+ */
+export declare function createRoughRenderMode(options?: RoughRenderModeOptions): RoughRenderMode;
+export {};

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

@@ -172,6 +172,8 @@ export { enableConversationArc, disableConversationArc, getConversationArcStore,
 export type { ConversationArcEvent, ConversationArcEventType, ConversationArcEventInput, ConversationArcStore, ConversationArcListener, ConversationArcSink, ConversationArcStorageLike, EnableConversationArcOptions, LoadConversationArcOptions, LocalStorageConversationArcSinkOptions, IndexedDBConversationArcSinkOptions, ConversationArcWebhookFetch, WebhookConversationArcSinkOptions, SuggestionShownEvent, SuggestionChosenEvent, AudienceSetEvent, ChartRenderedEvent, ChartEditedEvent, ChartReplacedEvent, ChartExportedEvent, ChartAbandonedEvent, InterrogationAskedEvent, InterrogationAnsweredEvent, NavNodeFocusedEvent, NavBranchExpandedEvent, AnnotationStatusChangedEvent } from "./ai/conversationArc";
 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";
+export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation, ObservationInputType, FocusObservation, ActivateObservation, AnnotationActivateObservation } from "./store/ObservationStore";
+export { annotationStableId } from "./charts/shared/annotationActivation";
+export type { ChartAnnotation, AnnotationActivationEvent, OnAnnotationActivateCallback } from "./charts/shared/annotationActivation";
 export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
 export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";

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

@@ -8,6 +8,8 @@
  */
 export { DirectManipulationControl, } from "./DirectManipulationControl";
 export type { DirectManipulationControlProps, } from "./DirectManipulationControl";
+export { SentenceFilter } from "./controls/SentenceFilter";
+export type { SentenceFilterBaseDefinition, SentenceFilterChangeMeta, SentenceFilterDefinition, SentenceFilterMultiSelectDefinition, SentenceFilterNumberDefinition, SentenceFilterOption, SentenceFilterPrimitive, SentenceFilterProps, SentenceFilterRangeDefinition, SentenceFilterRenderContext, SentenceFilterSelectDefinition, SentenceFilterTextDefinition, SentenceFilterToggleDefinition, SentenceFilterValue, } from "./controls/SentenceFilter";
 export { createControlObservationAdapter, VISUALIZATION_CONTROL_TYPES, } from "./controls/controlContract";
 export type { ControlInputSource, ControlObservation, ControlObservationAdapterOptions, ControlObservationCallback, ControlObservationPhase, VisualizationControlDefinition, VisualizationControlType, VisualizationControlValue, } from "./controls/controlContract";
 export { auditVisualizationControls } from "./controls/controlAudit";

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

@@ -29,3 +29,7 @@ export type { ProportionalSymbolMapProps } from "./charts/geo/ProportionalSymbol
 export type { FlowMapProps } from "./charts/geo/FlowMap";
 export type { DistanceCartogramProps } from "./charts/geo/DistanceCartogram";
 export type { GeoCustomChartProps } from "./charts/custom/GeoCustomChart";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeNodeRuleContext, composeStyleRules } from "./charts/shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate } from "./charts/shared/styleRules";
+export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";
+export type { HatchFill } from "./charts/shared/hatchFill";

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

@@ -39,3 +39,7 @@ export type { NetworkCustomChartProps } from "./charts/custom/NetworkCustomChart
 export type { NetworkCustomLayout, NetworkLayoutContext, NetworkLayoutResult, NetworkHtmlMark, } from "./stream/networkCustomLayout";
 export { validateProcessSankey, formatProcessSankeyIssue, } from "./charts/network/processSankey/algorithm";
 export type { ProcessSankeyNode as ProcessSankeyValidatorNode, ProcessSankeyEdge as ProcessSankeyValidatorEdge, ProcessSankeyIssue, } from "./charts/network/processSankey/algorithm";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeNodeRuleContext, composeStyleRules } from "./charts/shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate } from "./charts/shared/styleRules";
+export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";
+export type { HatchFill } from "./charts/shared/hatchFill";