semiotic 3.8.5 → 3.8.7

package/dist/components/ai/SemioticVACPBridge.d.ts

@@ -0,0 +1,22 @@
+import { type CreateSemioticVACPBridgeOptions, type SemioticVACPBridgeInstallation } from "./vacpAdapter";
+type StoreBackedBridgeOption = "getSelections" | "getObservations" | "selectionActions";
+export interface SemioticVACPBridgeProps extends Omit<CreateSemioticVACPBridgeOptions, StoreBackedBridgeOption> {
+    /** Global property used for installation. Default `__vacp`. */
+    globalKey?: string;
+    /** Receives either the successful installation or its refusal result. */
+    onInstallationChange?: (installation: SemioticVACPBridgeInstallation) => void;
+}
+/**
+ * Installs a live VACP bridge for the nearest LinkedCharts stores.
+ *
+ * Render this component inside the same `<LinkedCharts>` instance as the
+ * charts it describes. That ensures agent mutations and human observations
+ * share the same SelectionStore and ObservationStore. The component renders
+ * no DOM, and installation only runs after a client commit.
+ *
+ * `appId`, `viewId`, `globalKey`, and `stateCacheSize` establish the mounted
+ * bridge's identity/lifecycle. Remount to change them. Other protocol inputs
+ * are read live without replacing the installed bridge.
+ */
+export declare function SemioticVACPBridge(props: SemioticVACPBridgeProps): null;
+export {};

package/dist/components/ai/chartCapabilities.d.ts

@@ -1,6 +1,7 @@
 import type { ChartCapability } from "./chartCapabilityTypes";
 import { LineChartCapability } from "../charts/xy/LineChart.capability";
 import { AreaChartCapability } from "../charts/xy/AreaChart.capability";
+import { BumpChartCapability } from "../charts/xy/BumpChart.capability";
 import { StackedAreaChartCapability } from "../charts/xy/StackedAreaChart.capability";
 import { ScatterplotCapability } from "../charts/xy/Scatterplot.capability";
 import { ConnectedScatterplotCapability } from "../charts/xy/ConnectedScatterplot.capability";
@@ -40,12 +41,13 @@ import { FlowMapCapability } from "../charts/geo/FlowMap.capability";
 import { DistanceCartogramCapability } from "../charts/geo/DistanceCartogram.capability";
 import { GaltonBoardChartCapability } from "../charts/physics/GaltonBoardChart.capability";
 import { EventDropChartCapability } from "../charts/physics/EventDropChart.capability";
-import { PhysicsPileChartCapability } from "../charts/physics/PhysicsPileChart.capability";
+import { UnitPileChartCapability } from "../charts/physics/UnitPileChart.capability";
 import { CollisionSwarmChartCapability } from "../charts/physics/CollisionSwarmChart.capability";
-import { PhysicalFlowChartCapability } from "../charts/physics/PhysicalFlowChart.capability";
+import { PacketFlowChartCapability } from "../charts/physics/PacketFlowChart.capability";
 import { ProcessFlowChartCapability } from "../charts/physics/ProcessFlowChart.capability";
 import { GauntletChartCapability } from "../charts/physics/GauntletChart.capability";
 import { CrucibleChartCapability } from "../charts/physics/CrucibleChart.capability";
+import { ChainReactionChartCapability } from "../charts/physics/ChainReactionChart.capability";
 /**
  * Register a capability for a chart (built-in or third-party). Re-registering by
  * component name replaces the previous descriptor — useful for overriding defaults.
@@ -60,4 +62,4 @@ export declare function unregisterChartCapability(component: string): void;
 export declare function getCapabilities(): ReadonlyArray<ChartCapability>;
 /** Look up a capability by component name. */
 export declare function getCapability(component: string): ChartCapability | undefined;
-export { 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, GaltonBoardChartCapability, EventDropChartCapability, PhysicsPileChartCapability, CollisionSwarmChartCapability, PhysicalFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, CrucibleChartCapability };
+export { LineChartCapability, AreaChartCapability, BumpChartCapability, 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, GaltonBoardChartCapability, EventDropChartCapability, UnitPileChartCapability, CollisionSwarmChartCapability, PacketFlowChartCapability, ProcessFlowChartCapability, GauntletChartCapability, CrucibleChartCapability, ChainReactionChartCapability };

package/dist/components/ai/conversationArc.d.ts

@@ -1,179 +1,6 @@
+import type { ConversationArcEvent, ConversationArcEventInput } from "./conversationArcTypes";
 import type { AnnotationStatus } from "./annotationProvenance";
-export type ConversationArcEventType = "suggestion-shown" | "suggestion-chosen" | "audience-set" | "chart-rendered" | "chart-edited" | "chart-replaced" | "chart-exported" | "chart-abandoned" | "interrogation-asked" | "interrogation-answered" | "nav-node-focused" | "nav-branch-expanded" | "annotation-status-changed";
-interface ConversationArcEventBase {
-    /** Discriminator for the event variant. */
-    type: ConversationArcEventType;
-    /** `Date.now()` at the moment the event was recorded. Stamped by the store. */
-    timestamp: number;
-    /** Stable ID for the enabled session — survives until `disableConversationArc()` or `reset()`. */
-    sessionId: string;
-    /** Optional opaque correlation key that threads a single arc together. */
-    arcId?: string;
-    /** Free-form bag for context the talk-track doesn't need a typed slot for. */
-    meta?: Record<string, unknown>;
-}
-export interface SuggestionShownEvent extends ConversationArcEventBase {
-    type: "suggestion-shown";
-    /**
-     * Intent label fed into `suggestCharts` (e.g. "trend", "distribution").
-     * Accepts a single intent or an array — mirrors `SuggestChartsOptions.intent`.
-     */
-    intent?: string | ReadonlyArray<string>;
-    /** Ranked component names in the order the suggester returned them. */
-    components: string[];
-    /** Top suggestion's composite score, if known. */
-    topScore?: number;
-    /** Audience target active when the suggestion ran. */
-    audience?: string;
-}
-export interface SuggestionChosenEvent extends ConversationArcEventBase {
-    type: "suggestion-chosen";
-    component: string;
-    /** 1-based rank in the matching `suggestion-shown` event, if known. */
-    rank?: number;
-    /** Who picked the suggestion: a human, an agent loop, or a default-fall-through. */
-    source?: "user" | "agent" | "auto";
-}
-export interface AudienceSetEvent extends ConversationArcEventBase {
-    type: "audience-set";
-    audience: string;
-    previous?: string;
-}
-export interface ChartRenderedEvent extends ConversationArcEventBase {
-    type: "chart-rendered";
-    component: string;
-    chartId?: string;
-}
-export interface ChartEditedEvent extends ConversationArcEventBase {
-    type: "chart-edited";
-    component: string;
-    chartId?: string;
-    /** Names of props that changed in this edit. */
-    changedProps?: string[];
-}
-export interface ChartReplacedEvent extends ConversationArcEventBase {
-    type: "chart-replaced";
-    from: string;
-    to: string;
-    /** Why the swap happened — `"repair"`, `"variant"`, `"user-rejected"`, etc. */
-    reason?: string;
-}
-export interface ChartExportedEvent extends ConversationArcEventBase {
-    type: "chart-exported";
-    component: string;
-    /** What was exported: `"jsx"`, `"svg"`, `"png"`, `"json"`, `"url"`, etc. */
-    format: string;
-}
-export interface ChartAbandonedEvent extends ConversationArcEventBase {
-    type: "chart-abandoned";
-    component?: string;
-    reason?: string;
-}
-export interface InterrogationAskedEvent extends ConversationArcEventBase {
-    type: "interrogation-asked";
-    /** Chart the question was directed at, if known. */
-    component?: string;
-    /**
-     * Question text. The `useChartInterrogation` instrumentation
-     * truncates to ~500 chars before recording so the ring buffer
-     * stays bounded; callers stamping their own events should do the
-     * same.
-     */
-    query: string;
-    /** Optional payload size hint (e.g. summary token count) for diagnostics. */
-    contextSize?: number;
-}
-export interface InterrogationAnsweredEvent extends ConversationArcEventBase {
-    type: "interrogation-answered";
-    /** Chart the answer was directed at, if known. */
-    component?: string;
-    /**
-     * Answer text. The `useChartInterrogation` instrumentation
-     * truncates to ~2000 chars before recording so multi-kilobyte LLM
-     * responses don't bloat the ring buffer. Callers stamping their
-     * own events should follow the same convention.
-     */
-    answer?: string;
-    /** Number of annotations the response attached, if known. */
-    annotationCount?: number;
-    /**
-     * Round-trip latency in ms from ask to answer, clamped to ≥ 0.
-     * The instrumentation measures via `performance.now()` when
-     * available; the `Date.now()` fallback can produce negative
-     * deltas under clock changes, hence the clamp.
-     */
-    latencyMs?: number;
-    /** Set when the response was an error rather than a successful answer. */
-    error?: boolean;
-}
-/**
- * A reader focused a node in an `AccessibleNavTree` (keyboard or click). The
- * first *reception*-side behavioral signal in the arc — which structural nodes
- * a non-visual (or AI) reader actually visits, the dependent measure visualization-
- * literacy studies usually lack. Emitted only on genuine tree interaction, not
- * when the active node is driven externally (canvas → tree sync).
- */
-export interface NavNodeFocusedEvent extends ConversationArcEventBase {
-    type: "nav-node-focused";
-    /** `chartId` of the chart the tree describes, when correlated. */
-    chartId?: string;
-    /** Tree node id that gained focus. */
-    nodeId: string;
-    /** Node role: `"chart" | "axis" | "series" | "datum"`. */
-    role: string;
-    /** 1-based depth (aria-level). */
-    level: number;
-    /** The node's announced label (the emitter truncates to ~200 chars). */
-    label?: string;
-}
-/** A reader expanded or collapsed a branch in an `AccessibleNavTree`. */
-export interface NavBranchExpandedEvent extends ConversationArcEventBase {
-    type: "nav-branch-expanded";
-    /** `chartId` of the chart the tree describes, when correlated. */
-    chartId?: string;
-    /** Tree node id that was toggled. */
-    nodeId: string;
-    /** Node role of the toggled branch. */
-    role: string;
-    /** 1-based depth (aria-level). */
-    level: number;
-    /** `true` on expand, `false` on collapse. */
-    expanded: boolean;
-}
-/**
- * An annotation's editorial status transitioned (M7). The accept / dispute /
- * retract / propose flow is what turns an annotation into the durable,
- * observable node of the conversation arc (IDID §13.4): the note is the unit
- * the arc is *about*, not chart chrome.
- *
- * `fromStatus`/`toStatus` are deliberately not named `from`/`to` — `summarizeArc`
- * reads `from`/`to` as chart-component names (the `chart-replaced` shape), so a
- * status value there would pollute `componentsSeen`.
- */
-export interface AnnotationStatusChangedEvent extends ConversationArcEventBase {
-    type: "annotation-status-changed";
-    /** `provenance.stableId` of the annotation whose status changed, when known. */
-    annotationId?: string;
-    /** Previous editorial status, if known. */
-    fromStatus?: AnnotationStatus;
-    /** New editorial status. */
-    toStatus: AnnotationStatus;
-    /** `chartId` of the chart carrying the annotation, when correlated. */
-    chartId?: string;
-}
-export type ConversationArcEvent = SuggestionShownEvent | SuggestionChosenEvent | AudienceSetEvent | ChartRenderedEvent | ChartEditedEvent | ChartReplacedEvent | ChartExportedEvent | ChartAbandonedEvent | InterrogationAskedEvent | InterrogationAnsweredEvent | NavNodeFocusedEvent | NavBranchExpandedEvent | AnnotationStatusChangedEvent;
-/**
- * Input shape accepted by `record()`: the event variant without the
- * stamped fields (`timestamp` and `sessionId`). Callers may still
- * provide them to backfill historical events.
- *
- * Implemented as a distributive conditional so each member of the
- * discriminated union keeps its variant-specific payload (e.g.
- * `SuggestionShownEvent.components`). A non-distributive
- * `Omit<ConversationArcEvent, ...>` collapses to the union's common
- * fields and rejects every variant-specific key.
- */
-export type ConversationArcEventInput = ConversationArcEvent extends infer E ? E extends ConversationArcEvent ? Omit<E, "timestamp" | "sessionId"> & Partial<Pick<E, "timestamp" | "sessionId">> : never : never;
+export type { AnnotationStatusChangedEvent, AudienceSetEvent, ChartAbandonedEvent, ChartEditedEvent, ChartExportedEvent, ChartRenderedEvent, ChartReplacedEvent, ConversationArcEvent, ConversationArcEventInput, ConversationArcEventType, InterrogationAnsweredEvent, InterrogationAskedEvent, NavBranchExpandedEvent, NavNodeFocusedEvent, ProposalRefusedEvent, RenderEvidenceEvent, SuggestionChosenEvent, SuggestionShownEvent, } from "./conversationArcTypes";
 export type ConversationArcListener = (event: ConversationArcEvent) => void;
 export interface ConversationArcSink {
     /**
@@ -376,4 +203,3 @@ export declare function disableConversationArc(): void;
  * empty arrays, `subscribe()` returns a no-op unsubscriber.
  */
 export declare function getConversationArcStore(): ConversationArcStore;
-export {};

package/dist/components/ai/conversationArcTypes.d.ts

@@ -0,0 +1,202 @@
+import type { AnnotationStatus } from "./annotationProvenance";
+export type ConversationArcEventType = "suggestion-shown" | "suggestion-chosen" | "audience-set" | "proposal-refused" | "chart-rendered" | "render-evidence" | "chart-edited" | "chart-replaced" | "chart-exported" | "chart-abandoned" | "interrogation-asked" | "interrogation-answered" | "nav-node-focused" | "nav-branch-expanded" | "annotation-status-changed";
+interface ConversationArcEventBase {
+    /** Discriminator for the event variant. */
+    type: ConversationArcEventType;
+    /** `Date.now()` at the moment the event was recorded. Stamped by the store. */
+    timestamp: number;
+    /** Stable ID for the enabled session — survives until `disableConversationArc()` or `reset()`. */
+    sessionId: string;
+    /** Optional opaque correlation key that threads a single arc together. */
+    arcId?: string;
+    /** Free-form bag for context the talk-track doesn't need a typed slot for. */
+    meta?: Record<string, unknown>;
+}
+export interface SuggestionShownEvent extends ConversationArcEventBase {
+    type: "suggestion-shown";
+    /**
+     * Intent label fed into `suggestCharts` (e.g. "trend", "distribution").
+     * Accepts a single intent or an array — mirrors `SuggestChartsOptions.intent`.
+     */
+    intent?: string | ReadonlyArray<string>;
+    /** Ranked component names in the order the suggester returned them. */
+    components: string[];
+    /** Top suggestion's composite score, if known. */
+    topScore?: number;
+    /** Audience target active when the suggestion ran. */
+    audience?: string;
+}
+export interface SuggestionChosenEvent extends ConversationArcEventBase {
+    type: "suggestion-chosen";
+    component: string;
+    /** 1-based rank in the matching `suggestion-shown` event, if known. */
+    rank?: number;
+    /** Who picked the suggestion: a human, an agent loop, or a default-fall-through. */
+    source?: "user" | "agent" | "auto";
+}
+export interface AudienceSetEvent extends ConversationArcEventBase {
+    type: "audience-set";
+    audience: string;
+    previous?: string;
+}
+/**
+ * The deterministic trust loop declined to paint a model proposal.
+ * `stage` identifies which gate stopped it and `codes` preserves the
+ * machine-readable reasons an agent can use for repair.
+ */
+export interface ProposalRefusedEvent extends ConversationArcEventBase {
+    type: "proposal-refused";
+    component?: string;
+    stage: "validation" | "diagnosis" | "fit" | "render";
+    codes: string[];
+    alternatives?: string[];
+}
+export interface ChartRenderedEvent extends ConversationArcEventBase {
+    type: "chart-rendered";
+    component: string;
+    chartId?: string;
+}
+/**
+ * Render evidence captured after a chart attempt. Unlike `chart-rendered`, this
+ * records whether the output was actually non-empty and free of error findings.
+ */
+export interface RenderEvidenceEvent extends ConversationArcEventBase {
+    type: "render-evidence";
+    component: string;
+    chartId?: string;
+    markCount: number;
+    empty: boolean;
+    /** Stable warning codes emitted by `renderChartWithEvidence`. */
+    warnings: string[];
+}
+export interface ChartEditedEvent extends ConversationArcEventBase {
+    type: "chart-edited";
+    component: string;
+    chartId?: string;
+    /** Names of props that changed in this edit. */
+    changedProps?: string[];
+}
+export interface ChartReplacedEvent extends ConversationArcEventBase {
+    type: "chart-replaced";
+    from: string;
+    to: string;
+    /** Why the swap happened — `"repair"`, `"variant"`, `"user-rejected"`, etc. */
+    reason?: string;
+}
+export interface ChartExportedEvent extends ConversationArcEventBase {
+    type: "chart-exported";
+    component: string;
+    /** What was exported: `"jsx"`, `"svg"`, `"png"`, `"json"`, `"url"`, etc. */
+    format: string;
+}
+export interface ChartAbandonedEvent extends ConversationArcEventBase {
+    type: "chart-abandoned";
+    component?: string;
+    reason?: string;
+}
+export interface InterrogationAskedEvent extends ConversationArcEventBase {
+    type: "interrogation-asked";
+    /** Chart the question was directed at, if known. */
+    component?: string;
+    /**
+     * Question text. The `useChartInterrogation` instrumentation
+     * truncates to ~500 chars before recording so the ring buffer
+     * stays bounded; callers stamping their own events should do the
+     * same.
+     */
+    query: string;
+    /** Optional payload size hint (e.g. summary token count) for diagnostics. */
+    contextSize?: number;
+}
+export interface InterrogationAnsweredEvent extends ConversationArcEventBase {
+    type: "interrogation-answered";
+    /** Chart the answer was directed at, if known. */
+    component?: string;
+    /**
+     * Answer text. The `useChartInterrogation` instrumentation
+     * truncates to ~2000 chars before recording so multi-kilobyte LLM
+     * responses don't bloat the ring buffer. Callers stamping their
+     * own events should follow the same convention.
+     */
+    answer?: string;
+    /** Number of annotations the response attached, if known. */
+    annotationCount?: number;
+    /**
+     * Round-trip latency in ms from ask to answer, clamped to ≥ 0.
+     * The instrumentation measures via `performance.now()` when
+     * available; the `Date.now()` fallback can produce negative
+     * deltas under clock changes, hence the clamp.
+     */
+    latencyMs?: number;
+    /** Set when the response was an error rather than a successful answer. */
+    error?: boolean;
+}
+/**
+ * A reader focused a node in an `AccessibleNavTree` (keyboard or click). The
+ * first *reception*-side behavioral signal in the arc — which structural nodes
+ * a non-visual (or AI) reader actually visits, the dependent measure visualization-
+ * literacy studies usually lack. Emitted only on genuine tree interaction, not
+ * when the active node is driven externally (canvas → tree sync).
+ */
+export interface NavNodeFocusedEvent extends ConversationArcEventBase {
+    type: "nav-node-focused";
+    /** `chartId` of the chart the tree describes, when correlated. */
+    chartId?: string;
+    /** Tree node id that gained focus. */
+    nodeId: string;
+    /** Node role: `"chart" | "axis" | "series" | "datum"`. */
+    role: string;
+    /** 1-based depth (aria-level). */
+    level: number;
+    /** The node's announced label (the emitter truncates to ~200 chars). */
+    label?: string;
+}
+/** A reader expanded or collapsed a branch in an `AccessibleNavTree`. */
+export interface NavBranchExpandedEvent extends ConversationArcEventBase {
+    type: "nav-branch-expanded";
+    /** `chartId` of the chart the tree describes, when correlated. */
+    chartId?: string;
+    /** Tree node id that was toggled. */
+    nodeId: string;
+    /** Node role of the toggled branch. */
+    role: string;
+    /** 1-based depth (aria-level). */
+    level: number;
+    /** `true` on expand, `false` on collapse. */
+    expanded: boolean;
+}
+/**
+ * An annotation's editorial status transitioned (M7). The accept / dispute /
+ * retract / propose flow is what turns an annotation into the durable,
+ * observable node of the conversation arc (IDID §13.4): the note is the unit
+ * the arc is *about*, not chart chrome.
+ *
+ * `fromStatus`/`toStatus` are deliberately not named `from`/`to` — `summarizeArc`
+ * reads `from`/`to` as chart-component names (the `chart-replaced` shape), so a
+ * status value there would pollute `componentsSeen`.
+ */
+export interface AnnotationStatusChangedEvent extends ConversationArcEventBase {
+    type: "annotation-status-changed";
+    /** `provenance.stableId` of the annotation whose status changed, when known. */
+    annotationId?: string;
+    /** Previous editorial status, if known. */
+    fromStatus?: AnnotationStatus;
+    /** New editorial status. */
+    toStatus: AnnotationStatus;
+    /** `chartId` of the chart carrying the annotation, when correlated. */
+    chartId?: string;
+}
+export type ConversationArcEvent = SuggestionShownEvent | SuggestionChosenEvent | AudienceSetEvent | ProposalRefusedEvent | ChartRenderedEvent | RenderEvidenceEvent | ChartEditedEvent | ChartReplacedEvent | ChartExportedEvent | ChartAbandonedEvent | InterrogationAskedEvent | InterrogationAnsweredEvent | NavNodeFocusedEvent | NavBranchExpandedEvent | AnnotationStatusChangedEvent;
+/**
+ * Input shape accepted by `record()`: the event variant without the
+ * stamped fields (`timestamp` and `sessionId`). Callers may still
+ * provide them to backfill historical events.
+ *
+ * Implemented as a distributive conditional so each member of the
+ * discriminated union keeps its variant-specific payload (e.g.
+ * `SuggestionShownEvent.components`). A non-distributive
+ * `Omit<ConversationArcEvent, ...>` collapses to the union's common
+ * fields and rejects every variant-specific key.
+ */
+export type ConversationArcEventInput = ConversationArcEvent extends infer E ? E extends ConversationArcEvent ? Omit<E, "timestamp" | "sessionId"> & Partial<Pick<E, "timestamp" | "sessionId">> : never : never;
+export {};

package/dist/components/ai/readerGrounding.d.ts

@@ -142,9 +142,21 @@ export interface ChartReaderGrounding {
     structure?: NavTreeNode;
     /** Physics-specific runtime grounding for simulation charts. */
     physics?: PhysicsReaderGrounding;
+    /**
+     * Exact source facts for chart families whose visual/navigation summary
+     * does not enumerate their scalar, edge, hierarchy, or simulation inputs.
+     * These statements report supplied props only; they never infer causes,
+     * forecasts, or runtime outcomes.
+     */
+    facts?: ChartReaderGroundingFacts;
     /** L1–L4 joined into one prose blob an LLM can read directly. */
     text: string;
 }
+export interface ChartReaderGroundingFacts {
+    source: "chart-props";
+    statements: string[];
+    text: string;
+}
 /**
  * Build the combined reader-grounding payload for a chart config. See the
  * module docstring; pass a `capability` (or a resolved context) for the most

package/dist/components/ai/vacpAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { CreateSemioticVACPBridgeOptions, InstallSemioticVACPBridgeOptions, SemioticVACPBridge, SemioticVACPBridgeInstallation } from "./vacpAdapterTypes";
+export { SEMIOTIC_VACP_ACTIVATE_NAVIGATION_ACTION, SEMIOTIC_VACP_CLEAR_SELECTION_ACTION, SEMIOTIC_VACP_INSPECT_DATA_ACTION, SEMIOTIC_VACP_SET_INTERVAL_SELECTION_ACTION, SEMIOTIC_VACP_SET_POINT_SELECTION_ACTION, type CreateSemioticVACPBridgeOptions, type InstallSemioticVACPBridgeOptions, type SemioticVACPCustomAction, type SemioticVACPBridge, type SemioticVACPBridgeInstallation, type SemioticVACPChart, type SemioticVACPDataAccess, type SemioticVACPNavigationBinding, type SemioticVACPRefs, type SemioticVACPSelectionActions, type SemioticVACPSelectionBinding, type SemioticVACPSelectionMode, } from "./vacpAdapterTypes";
+/**
+ * Create a dependency-free, SSR-safe bridge matching VACP's documented 0.1.0
+ * in-page shape. The returned object does not touch `window`; installation is
+ * an explicit separate step.
+ */
+export declare function createSemioticVACPBridge(options: CreateSemioticVACPBridgeOptions): SemioticVACPBridge;
+/**
+ * Install without clobbering an existing foreign bridge. Cleanup is
+ * ownership-safe: it never deletes a value installed by somebody else later.
+ */
+export declare function installSemioticVACPBridge(bridge: SemioticVACPBridge, options?: InstallSemioticVACPBridgeOptions): SemioticVACPBridgeInstallation;

package/dist/components/ai/vacpAdapterActions.d.ts

@@ -0,0 +1,2 @@
+import { type CreateSemioticVACPBridgeOptions, type RuntimeAction, type RuntimeModelBase, type SemioticVACPRefs } from "./vacpAdapterTypes";
+export declare function buildRuntimeActions(model: RuntimeModelBase, options: CreateSemioticVACPBridgeOptions, refs: SemioticVACPRefs): RuntimeAction[];

package/dist/components/ai/vacpAdapterModel.d.ts

@@ -0,0 +1,7 @@
+import type { NavTreeNode } from "./navigationTree";
+import { type CreateSemioticVACPBridgeOptions, type RuntimeModelBase, type SemioticVACPRefs } from "./vacpAdapterTypes";
+export declare function createRefs(appId: string, viewId: string): SemioticVACPRefs;
+export declare function clock(options: CreateSemioticVACPBridgeOptions): string;
+export declare function findTreeNode(tree: NavTreeNode, id: string | undefined): NavTreeNode | undefined;
+export declare function matchFromNode(node: NavTreeNode, fields: readonly string[]): Record<string, unknown> | undefined;
+export declare function buildRuntimeModelBase(options: CreateSemioticVACPBridgeOptions, refs: SemioticVACPRefs): RuntimeModelBase;

package/dist/components/ai/vacpAdapterRuntime.d.ts

@@ -0,0 +1,26 @@
+import type { VacpCapabilitiesRequest, VacpCapabilitiesSnapshot, VacpDataSchemaDetail, VacpDataSchemaResult, VacpRef, VacpStateDeltaPayload, VacpStateRequest, VacpStateSnapshot } from "./vacpTypes";
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Convert application values to bounded, JSON-compatible data. Functions,
+ * symbols, React elements, and cyclic references are intentionally omitted.
+ */
+export declare function jsonSafe(value: unknown, options?: {
+    maxDepth?: number;
+    maxArrayLength?: number;
+}): unknown;
+export declare function safeRecord(value: unknown): Record<string, unknown>;
+export declare function stableStringify(value: unknown): string;
+export declare function stableHash(value: unknown): string;
+export declare function stateToken(snapshot: VacpStateSnapshot): string;
+export declare function scopeStateSnapshot(snapshot: VacpStateSnapshot, request: VacpStateRequest): {
+    snapshot: VacpStateSnapshot;
+    refs?: VacpRef[];
+};
+export declare function diffStateSnapshots(baseline: VacpStateSnapshot, current: VacpStateSnapshot): VacpStateDeltaPayload;
+export declare function scopeCapabilitiesSnapshot(snapshot: VacpCapabilitiesSnapshot, request: VacpCapabilitiesRequest): VacpCapabilitiesSnapshot;
+export declare function buildDataSchema(args: {
+    handleRef: VacpRef;
+    rows: readonly unknown[];
+    detail: VacpDataSchemaDetail;
+    sampleRows: number;
+}): VacpDataSchemaResult;

package/dist/components/ai/vacpAdapterState.d.ts

@@ -0,0 +1,3 @@
+import type { CreateSemioticVACPBridgeOptions, RuntimeModelBase, SemioticVACPRefs } from "./vacpAdapterTypes";
+import { type VacpStateSnapshot } from "./vacpTypes";
+export declare function buildStateSnapshot(model: RuntimeModelBase, options: CreateSemioticVACPBridgeOptions, refs: SemioticVACPRefs): VacpStateSnapshot;