semiotic 3.6.0 → 3.7.1

package/dist/semiotic-ai.d.ts

@@ -41,6 +41,7 @@ export { RealtimeHistogram, TemporalHistogram } from "./components/charts/realti
 export { RealtimeSwarmChart } from "./components/charts/realtime/RealtimeSwarmChart";
 export { RealtimeWaterfallChart } from "./components/charts/realtime/RealtimeWaterfallChart";
 export { RealtimeHeatmap } from "./components/charts/realtime/RealtimeHeatmap";
+export { BigNumber } from "./components/charts/value/BigNumber";
 export { TooltipProvider } from "./components/store/TooltipStore";
 export { MultiLineTooltip } from "./components/Tooltip/Tooltip";
 export { ThemeProvider, useTheme } from "./components/ThemeProvider";
@@ -59,6 +60,8 @@ export { validateProps } from "./components/charts/shared/validateProps";
 export type { ValidationResult } from "./components/charts/shared/validateProps";
 export { diagnoseConfig } from "./components/charts/shared/diagnoseConfig";
 export type { Diagnosis, DiagnosisResult } from "./components/charts/shared/diagnoseConfig";
+export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./components/charts/shared/auditAccessibility";
+export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./components/charts/shared/auditAccessibility";
 export type { AnomalyConfig, ForecastConfig } from "./components/charts/shared/statisticalOverlays";
 export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./components/export/chartConfig";
 export type { ChartConfig, ToConfigOptions, CopyFormat } from "./components/export/chartConfig";
@@ -67,40 +70,60 @@ export type { SerializedSelections, SerializedSelection, SerializedFieldSelectio
 export { fromVegaLite } from "./components/data/fromVegaLite";
 export type { VegaLiteSpec, VegaLiteEncoding } from "./components/data/fromVegaLite";
 export { useChartInterrogation } from "./components/store/useChartInterrogation";
-export type { UseChartInterrogationOptions, UseChartInterrogationResult, InterrogationContext, InterrogationFocus, InterrogationResult, InterrogationQuery, InterrogationMessage, } from "./components/store/useChartInterrogation";
+export type { UseChartInterrogationOptions, UseChartInterrogationResult, InterrogationContext, InterrogationFocus, InterrogationResult, InterrogationQuery, InterrogationMessage } from "./components/store/useChartInterrogation";
 export { useChartFocus } from "./components/store/useChartFocus";
 export type { UseChartFocusOptions } from "./components/store/useChartFocus";
 export { summarizeData } from "./components/data/DataSummarizer";
-export type { DataSummary, FieldSummary, FieldType, NumericFieldSummary, DateFieldSummary, CategoricalFieldSummary, UnknownFieldSummary, SummarizeOptions, } from "./components/data/DataSummarizer";
+export { describeChart, resolveCommunicativeAct, communicativeActForIntent } from "./components/ai/describeChart";
+export type { DescribeChartResult, DescribeChartOptions, DescribeLevel, CommunicativeAct, DescribeCapabilityContext } from "./components/ai/describeChart";
+export { buildReaderGrounding } from "./components/ai/readerGrounding";
+export type { ChartReaderGrounding, ChartReaderGroundingOptions, ChartReaderGroundingIntent } from "./components/ai/readerGrounding";
+export { buildNavigationTree, flattenVisible, countNodes } from "./components/ai/navigationTree";
+export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./components/ai/navigationTree";
+export { AccessibleNavTree } from "./components/AccessibleNavTree";
+export type { AccessibleNavTreeProps } from "./components/AccessibleNavTree";
+export { useNavigationSync } from "./components/ai/useNavigationSync";
+export type { UseNavigationSyncOptions, UseNavigationSyncResult } from "./components/ai/useNavigationSync";
+export type { DataSummary, FieldSummary, FieldType, NumericFieldSummary, DateFieldSummary, CategoricalFieldSummary, UnknownFieldSummary, SummarizeOptions } from "./components/data/DataSummarizer";
 export { profileData } from "./components/ai/profileData";
 export type { ProfileDataOptions } from "./components/ai/profileData";
-export { suggestCharts, scoreChart, explainCapabilityFit } from "./components/ai/suggestCharts";
-export type { SuggestChartsOptions, RejectedCapability, ExplainCapabilityFitResult, } from "./components/ai/suggestCharts";
+export { suggestCharts, suggestChartsGrouped, scoreChart, explainCapabilityFit } from "./components/ai/suggestCharts";
+export type { SuggestChartsOptions, RejectedCapability, ExplainCapabilityFitResult } from "./components/ai/suggestCharts";
+export { DEFAULT_SCALE_THRESHOLDS, applyScaleBias, classifyRowBand, classifyCardinalityBand, classifyFieldBand, compareBands, computeEffectiveScale, resolveRowsToNumber, resolveCardinalityToNumber, scaleHints } from "./components/ai/dataScaleProfile";
+export type { DataScaleProfile, DataQualityProfile, ScaleBand, CardinalityBand, FieldBand, ScaleThresholds, ChartScalePreference, EffectiveScale, ScaleBiasResult, ScaleFitFn, ScaleFitResult, QualityFitFn, ScaleHintInput } from "./components/ai/dataScaleProfile";
 export { inferIntent } from "./components/ai/inferIntent";
 export type { InferIntentResult } from "./components/ai/inferIntent";
 export { suggestDashboard } from "./components/ai/suggestDashboard";
-export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions, } from "./components/ai/suggestDashboard";
-export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, } from "./components/ai/audienceProfile";
-export type { AudienceProfile, AudienceTarget, AudienceBiasResult, } from "./components/ai/audienceProfile";
-export { executivePersona, analystPersona, dataScientistPersona, BUILT_IN_AUDIENCES, } from "./components/ai/audiences";
+export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } from "./components/ai/suggestDashboard";
+export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, receivabilityBias } from "./components/ai/audienceProfile";
+export type { AudienceProfile, AudienceTarget, AudienceBiasResult, ReceptionModality, ReceivabilitySignal } from "./components/ai/audienceProfile";
+export { executivePersona, analystPersona, dataScientistPersona, BUILT_IN_AUDIENCES } from "./components/ai/audiences";
 export { suggestStretchCharts } from "./components/ai/suggestStretchCharts";
-export type { StretchSuggestion, SuggestStretchChartsOptions, } from "./components/ai/suggestStretchCharts";
-export { suggestStreamCharts, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities, } from "./components/ai/suggestStreamCharts";
+export type { StretchSuggestion, SuggestStretchChartsOptions } from "./components/ai/suggestStretchCharts";
+export { suggestStreamCharts, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./components/ai/suggestStreamCharts";
 export type { SuggestStreamChartsOptions } from "./components/ai/suggestStreamCharts";
-export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamChartCapability, StreamIntentScorer, StreamSuggestion, } from "./components/ai/streamingTypes";
+export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./components/ai/streamingTypes";
 export { diffProfile } from "./components/ai/diffProfile";
 export type { ProfileDiff, FieldTypeChange, PrimaryRoleChange, PrimaryRole } from "./components/ai/diffProfile";
 export { repairChartConfig } from "./components/ai/repairChartConfig";
-export type { RepairResult, RepairOkResult, RepairAlternativeResult, RepairUnknownResult, RepairOptions, } from "./components/ai/repairChartConfig";
+export type { RepairResult, RepairOkResult, RepairAlternativeResult, RepairUnknownResult, RepairOptions } from "./components/ai/repairChartConfig";
 export { runQualityScorecard } from "./components/ai/qualityScorecard";
-export type { ScorecardFixture, ScorecardReport, PerCapabilityScore, PerFixtureScore, } from "./components/ai/qualityScorecard";
+export type { ScorecardFixture, ScorecardReport, PerCapabilityScore, PerFixtureScore } from "./components/ai/qualityScorecard";
 export { CANONICAL_FIXTURES } from "./components/ai/qualityFixtures";
 export { useChartSuggestions } from "./components/ai/useChartSuggestions";
 export type { UseChartSuggestionsOptions, UseChartSuggestionsResult } from "./components/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 "./components/ai/chartCapabilities";
-export type { ChartCapability, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, Suggestion, } from "./components/ai/chartCapabilityTypes";
+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 "./components/ai/chartCapabilities";
+export type { ChartCapability, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, ScaledSuggestionGroups, Suggestion, SuggestionScaleRange } from "./components/ai/chartCapabilityTypes";
 export { listIntents, getIntent, registerIntent, BUILT_IN_INTENT_IDS } from "./components/ai/intents";
 export type { BuiltInIntentId, IntentId, IntentDescriptor } from "./components/ai/intents";
+export { proposeVariant, evaluateVariantProposal, registerVariantDiscovery, getRegisteredVariantDiscovery, clearVariantDiscovery } from "./components/ai/variantDiscovery";
+export type { VariantProposal, VariantProposalSource, VariantScore, VariantRejectionReason, VariantDiscoveryContext, EvaluateVariantProposalOptions, ProposeVariantFn, EvaluateVariantProposalFn } from "./components/ai/variantDiscovery";
+export { withProvenance, withCurrentProvenance, currentTimestamp, computeAnnotationFreshness, applyAnnotationLifecycle, applyAnnotationStatus, filterAnnotationsByStatus, annotationFreshnessFor, bandFromAge, DEFAULT_LIFECYCLE_THRESHOLDS } from "./components/ai/annotationProvenance";
+export type { AnnotationProvenance, AnnotationSource, AnnotationActorKind, AnnotationBasis, AnnotationLifecycle, AnnotationFreshness, AnnotationStatus, AnnotationAnchor, Annotated, ComputeAnnotationFreshnessOptions, AnnotationLifecycleTreatment, ApplyAnnotationLifecycleOptions, AnnotationStatusTreatment, AnnotationStatusVisibility, LifecycleBand, LifecycleBandThresholds } from "./components/ai/annotationProvenance";
+export { useConversationArc, summarizeArc } from "./components/ai/useConversationArc";
+export type { UseConversationArcOptions, UseConversationArcResult, ConversationArcSummary } from "./components/ai/useConversationArc";
+export { enableConversationArc, disableConversationArc, getConversationArcStore, subscribeToConversationArcChange, registerConversationArcSink, createLocalStorageConversationArcSink, createIndexedDBConversationArcSink, createWebhookConversationArcSink, loadConversationArc, replayConversationArc, recordAudienceChange, recordAnnotationStatusChange } from "./components/ai/conversationArc";
+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 "./components/ai/conversationArc";
 export { useChartObserver } from "./components/store/useObservation";
 export type { UseChartObserverOptions, UseChartObserverResult } from "./components/store/useObservation";
 export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation } from "./components/store/ObservationStore";