semiotic 3.8.0 → 3.8.1

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";

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

@@ -33,6 +33,12 @@ export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
 export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types";
 export { createHatchPattern } from "./charts/shared/hatchPattern";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";
+export type { HatchFill } from "./charts/shared/hatchFill";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn, } from "./charts/shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate, } from "./charts/shared/styleRules";
+export { AnnotationLabel, estimateLabelWidth } from "./charts/shared/AnnotationLabel";
+export type { AnnotationLabelBackground, AnnotationLabelBackgroundConfig, AnnotationLabelProps } from "./charts/shared/AnnotationLabel";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
 export type { BarChartProps } from "./charts/ordinal/BarChart";
 export type { StackedBarChartProps } from "./charts/ordinal/StackedBarChart";

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

@@ -54,3 +54,7 @@ export { compileDependencyMachine, routeDependencyTracks, createLogicalJoin, rep
 export type { DependencyAccessor, DependencyTaskStatus, DependencyMachineAccessors, CompileDependencyMachineOptions, DependencyMachineDiagnosticCode, DependencyMachineDiagnostic, DependencyMachineNode, DependencyMachineEdge, DependencyMachine, DependencyPoint, DependencyTrackDimensions, DependencyTrackOptions, DependencyTaskPlacement, DependencySocketPlacement, DependencyTrackRoute, DependencyTrackLayout, LogicalJoinSnapshot, LogicalJoin, DependencyReplayEvent, DependencyReplayClock, DependencyReplayState, BlockerAmplification, BlockerAmplificationOptions } from "./charts/physics/dependencyMachine";
 export { compileMotionEncoding, resolveMotionAccessor, resolveMotionAge, opacityFromAge, resolveMotionVector, deriveMotionVector } from "./charts/shared/motionEncoding";
 export type { MotionEncodingConstant, MotionEncodingAccessor, MotionTimeBasis, MotionTimeUnit, MotionCoordinateSpace, MotionTimeEncoding, MotionPlacementEncoding, MotionKinematicsEncoding, MotionProcessEncoding, MotionAccessibleEncoding, MotionEncoding, ResolvedMotionEncodingRow, MotionEncodingCompilation, CompileMotionEncodingOptions, ResolveMotionAgeOptions, ResolvedMotionAge, MotionAgeOpacityType, MotionAgeOpacityOptions, MotionPoint, ResolvedMotionVector } from "./charts/shared/motionEncoding";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, 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-rough.d.ts

@@ -0,0 +1,4 @@
+/** Optional Rough.js rendering adapter. Import from `semiotic/rough`. */
+export { createRoughRenderMode, stableRoughSeed } from "./rough/createRoughRenderMode";
+export type { RoughRenderMode, RoughRenderModeOptions } from "./rough/createRoughRenderMode";
+export type { SceneRenderBackend, SceneRenderMode } from "./stream/types";

package/dist/components/semiotic-utils-core.d.ts

@@ -14,6 +14,10 @@ export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils"
 export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
 export { createHatchPattern } from "./charts/shared/hatchPattern";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { isHatchFill, hatchFillId, hatchFillKey } from "./charts/shared/hatchFill";
+export type { HatchFill } from "./charts/shared/hatchFill";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn, } from "./charts/shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate, } from "./charts/shared/styleRules";
 export { validateProps } from "./charts/shared/validateProps";
 export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
 export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";

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

@@ -42,3 +42,7 @@ export type { QuadrantChartProps, QuadrantsConfig, QuadrantsConfigOverride, Quad
 export type { MultiAxisLineChartProps } from "./charts/xy/MultiAxisLineChart";
 export type { CandlestickChartProps } from "./charts/xy/CandlestickChart";
 export type { XYCustomChartProps } from "./charts/custom/XYCustomChart";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, 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.d.ts

@@ -52,7 +52,9 @@ export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, Custom
 export type { UseSelectionOptions, UseSelectionResult, UseSelectionActionsResult, UseLinkedHoverOptions, UseLinkedHoverResult, UseBrushSelectionOptions, UseBrushSelectionResult } from "./LinkedCharts";
 export { useChartObserver } from "./LinkedCharts";
 export type { UseChartObserverOptions, UseChartObserverResult } from "./LinkedCharts";
-export type { ChartObservation, OnObservationCallback } from "./store/ObservationStore";
+export type { ChartObservation, OnObservationCallback, ObservationInputType, FocusObservation, ActivateObservation, AnnotationActivateObservation } from "./store/ObservationStore";
+export { annotationStableId } from "./charts/shared/annotationActivation";
+export type { ChartAnnotation, AnnotationActivationEvent, OnAnnotationActivateCallback } from "./charts/shared/annotationActivation";
 export type { ResolutionMode, SelectionClause, Selection } from "./store/SelectionStore";
 export type { SemioticTheme } from "./ThemeProvider";
 export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME } from "./ThemeProvider";
@@ -83,6 +85,12 @@ export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartCon
 export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
 export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";
+export type { HatchFill } from "./charts/shared/hatchFill";
+export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn, styleRulesToPieceStyle, styleRulesToXYStyle, styleRulesToNodeStyle, } from "./charts/shared/styleRules";
+export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate, } from "./charts/shared/styleRules";
+export { AnnotationLabel, estimateLabelWidth } from "./charts/shared/AnnotationLabel";
+export type { AnnotationLabelBackground, AnnotationLabelBackgroundConfig, AnnotationLabelProps } from "./charts/shared/AnnotationLabel";
 export { smartTickFormat, adaptiveTimeTicks } from "./charts/shared/formatUtils";
 export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
 export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "./Tooltip/Tooltip";

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

@@ -0,0 +1,37 @@
+export interface SharpPipeline {
+    resize(width: number, height: number): SharpPipeline;
+    ensureAlpha(): SharpPipeline;
+    raw(): SharpPipeline;
+    jpeg(options: {
+        quality: number;
+    }): SharpPipeline;
+    png(): SharpPipeline;
+    toBuffer(): Promise<Buffer>;
+}
+export type SharpFactory = (input: Uint8Array, options?: {
+    density: number;
+}) => SharpPipeline;
+export type SharpModule = SharpFactory & {
+    default?: SharpFactory;
+};
+export type GifPalette = number[][] | Uint8Array;
+export interface GifEncoder {
+    writeFrame(indexedPixels: Uint8Array, width: number, height: number, options: {
+        palette: GifPalette;
+        delay: number;
+        repeat: number;
+    }): void;
+    finish(): void;
+    bytes(): Uint8Array;
+}
+export interface GifencExports {
+    GIFEncoder?: () => GifEncoder;
+    quantize?: (pixels: Uint8Array, maxColors: number) => GifPalette;
+    applyPalette?: (pixels: Uint8Array, palette: GifPalette) => Uint8Array;
+    default?: GifencExports;
+}
+export interface GifencRuntimeExports extends GifencExports {
+    GIFEncoder: () => GifEncoder;
+    quantize: (pixels: Uint8Array, maxColors: number) => GifPalette;
+    applyPalette: (pixels: Uint8Array, palette: GifPalette) => Uint8Array;
+}

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

@@ -1,15 +1,19 @@
 import type { Datum } from "../charts/shared/datumTypes";
 export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
+export type ServerAccessorValue = string | number | boolean | Date | null | undefined;
+export type ServerAccessor = string | ((datum: Datum) => ServerAccessorValue);
+export type ServerColorScheme = string | string[] | Record<string, string> | undefined;
+export type ServerChartData = Datum | Datum[] | null | undefined;
 export interface ChartConfig {
     frameType: FrameType;
     /** Build frame props from HOC-level props */
-    buildProps: (data: any, colorBy: any, colorScheme: any, common: Datum, rest: Datum) => Datum;
+    buildProps: (data: ServerChartData, colorBy: ServerAccessor | undefined, colorScheme: ServerColorScheme, common: Datum, rest: Datum) => Datum;
 }
-export declare function accessorValue(accessor: any, fallback: string, d: Datum): any;
-export declare function numericValue(value: any): number;
+export declare function accessorValue(accessor: ServerAccessor | undefined, fallback: string, d: Datum): ServerAccessorValue;
+export declare function numericValue(value: ServerAccessorValue): number;
 export declare function viridisColor(i: number, n: number): string;
-export declare function prepareConnectedScatterplotData(data: any, rest: Datum): {
-    data: any;
+export declare function prepareConnectedScatterplotData(data: ServerChartData, rest: Datum): {
+    data: ServerChartData;
     orderMap: WeakMap<Datum, {
         idx: number;
         total: number;

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

@@ -14,15 +14,15 @@ export declare const CHART_CONFIGS: {
     CandlestickChart: ChartConfig;
     BubbleChart: {
         frameType: "xy";
-        buildProps: (data: any, colorBy: any, colorScheme: any, common: import("../stream/networkColorAccessors").Datum, rest: import("../stream/networkColorAccessors").Datum) => {
+        buildProps: (data: import("./serverChartConfigShared").ServerChartData, colorBy: import("./serverChartConfigShared").ServerAccessor | undefined, colorScheme: import("./serverChartConfigShared").ServerColorScheme, common: import("../stream/networkColorAccessors").Datum, rest: import("../stream/networkColorAccessors").Datum) => {
             chartType: string;
-            data: any;
+            data: import("./serverChartConfigShared").ServerChartData;
             xAccessor: any;
             yAccessor: any;
-            colorAccessor: any;
+            colorAccessor: import("./serverChartConfigShared").ServerAccessor | undefined;
             sizeAccessor: any;
             sizeRange: any;
-            colorScheme: any;
+            colorScheme: import("./serverChartConfigShared").ServerColorScheme;
         };
     };
     ConnectedScatterplot: ChartConfig;

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

@@ -1,4 +1,4 @@
-import type { Datum } from "../charts/shared/datumTypes";
+import type { Datum, DatumValue } from "../charts/shared/datumTypes";
 /**
  * Static annotation rendering for server-side SVG.
  *
@@ -9,8 +9,8 @@ import * as React from "react";
 import type { SemioticTheme } from "../store/ThemeStore";
 import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
 interface AnnotationScales {
-    x?: (v: any) => number;
-    y?: (v: any) => number;
+    x?: AnnotationScale;
+    y?: AnnotationScale;
     /** For ordinal charts: band scale */
     o?: {
         (v: string): number | undefined;
@@ -25,6 +25,9 @@ interface AnnotationScales {
      */
     geoProjection?: (coords: [number, number]) => [number, number] | null;
 }
+type AnnotationScale = {
+    bivarianceHack(value: DatumValue): number;
+}["bivarianceHack"];
 interface AnnotationLayout {
     width: number;
     height: number;

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

@@ -71,5 +71,5 @@ export declare function renderStaticGradientLegend(config: StaticGradientLegendC
 /**
  * Extract unique categories from data using an accessor.
  */
-export declare function extractCategories(data: any[], accessor: string | ((d: Datum) => string) | undefined): string[];
+export declare function extractCategories(data: Datum[], accessor: string | ((d: Datum) => string) | undefined): string[];
 export {};

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

@@ -1,8 +1,8 @@
-import type { Datum } from "../charts/shared/datumTypes";
+import type { Datum, DatumValue } from "../charts/shared/datumTypes";
 import type { NetworkPipelineConfig, RealtimeNode, RealtimeEdge, StreamNetworkFrameProps } from "../stream/networkTypes";
 import { type EvidenceSink } from "./renderEvidence";
 import type { ThemeAwareProps } from "./staticSVGChrome";
-export declare function resolveAccessor(accessor: string | ((d: Datum) => any) | undefined, defaultKey: string): (d: Datum) => any;
-export declare function buildRealtimeNodes(propsNodes: any[], config: NetworkPipelineConfig): RealtimeNode[];
-export declare function buildRealtimeEdges(propsEdges: any[], config: NetworkPipelineConfig): RealtimeEdge[];
+export declare function resolveAccessor(accessor: string | ((d: Datum) => DatumValue) | undefined, defaultKey: string): (d: Datum) => DatumValue;
+export declare function buildRealtimeNodes(propsNodes: Datum[], config: NetworkPipelineConfig): RealtimeNode[];
+export declare function buildRealtimeEdges(propsEdges: Datum[], config: NetworkPipelineConfig): RealtimeEdge[];
 export declare function renderNetworkFrame(props: StreamNetworkFrameProps & ThemeAwareProps, sink?: EvidenceSink): string;