udi-yac 0.1.0

package/dist/data/readme.md

@@ -0,0 +1,41 @@
+# YAC Dataset Format Examples
+
+YAC expects data to be in the form of multiple related tables. The information about the tables and their relationships must be recorded in a frictionless data package file.
+
+Frictionless Data Package: https://datapackage.org/
+
+Frictionless data packages support multiple different types of data resources. However, the only kind that YAC currently supports are Tables
+
+Frictionless Table Schema: https://datapackage.org/standard/table-schema/
+
+YAC expects a few additional fields. They are all prepended with `udi:` for the universal discovery interface project.
+
+At the top level:
+| Field | Description |
+|-------------|----------------------------------------------------------------------------------------------------------------|
+| `udi:name` | The name of the full data resource. Can be the same as `name`. |
+| `udi:path` | The path of the data resources. It is assumed that all data resources are relative to this path. This can be a relative path, or a full remote URL. |
+
+For each table resource:
+| Field | Description |
+|----------------------|--------------------------------------------------|
+| `udi:row_count` | The number of rows in the table. |
+| `udi:column_count` | The number of data columns in the table. |
+
+For each data field:
+| Field | Description |
+|-------------------------|---------------------------------------------------------------------------------------------------------------------|
+| `udi:cardinality` | The number of unique values in the column. |
+| `udi:unique` | `true` if the value is unique for each row, `false` otherwise. |
+| `udi:data_type` | One of `quantitative`, `ordinal`, or `nominal`. |
+| `udi:overlapping_fields`| List of fields that are non-null on at least one row together. If all fields overlap, this should be `all`. |
+
+This directory contains several examples that work with YAC.
+| Path | Description | Tables |
+|----------------------------------------------------|--------------------------------------------------------------------|--------------|
+| `./penguins/datapackage.json` | The classic Palmer Penguins test dataset. | Single Table |
+| `./hubmap_avr/datapackage.json` | An export from the HuBMAP Antibody Validation Report. | Single Table |
+| `./hubmap_2025-05-05/datapackage_udi.json` | An export from the HuBMAP TSV APIs. | Three Tables |
+| `./MetabolomicsWorkBench/C2M2_datapackage_udi.json`| A C2M2 export from the MetabolomicsWorkbench project. | 22 Tables |
+| `./MoTrPAC/C2M2_datapackage_udi.json` | A C2M2 export from the MoTrPAC project. | 14 Tables |
+| `./SenNet/C2M2_datapackage_udi.json` | A C2M2 export from the SenNet project. | 6 Tables |

package/dist/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-49.64" y="2.03" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-45.045" y="20.029" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-43.513" y="21.178" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="15.756" y="-17.901" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-27.636" y="-22.853" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="20.116" y="-38.415" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="24.641" y="-11.323" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="8.244" y="-2.416" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="18.713" y="10.588" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter></defs></svg>

package/dist/features/chat/api/completions.d.ts

@@ -0,0 +1,12 @@
+import { Message } from '../../../types/messages';
+export interface QueryConfig {
+    apiBaseUrl: string;
+    authToken?: string;
+    openAiKey?: string;
+    model?: string;
+}
+export interface ToolCallResponse {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export declare function queryLLM(config: QueryConfig, messages: Message[], dataSchema: string, dataDomains: string): Promise<ToolCallResponse[]>;

package/dist/features/chat/components/ApiKeyInput.d.ts

@@ -0,0 +1,5 @@
+interface ApiKeyInputProps {
+    onSubmit: (key: string) => void;
+}
+export declare function ApiKeyInput({ onSubmit }: ApiKeyInputProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/components/ChatHeaderBar.d.ts

@@ -0,0 +1,19 @@
+import { QueryConfig } from '../api/completions';
+interface ChatHeaderBarProps {
+    config: QueryConfig;
+    hasApiKey: boolean;
+    onClearApiKey: () => void;
+    showDrawerToggle?: boolean;
+    onToggleDrawer?: () => void;
+    onReset: () => void;
+    onExampleClick: (prompt: string) => void;
+    isLoading: boolean;
+}
+/**
+ * Top toolbar of the chat panel: drawer toggle, title, example prompts
+ * dialog, API key indicator, debug export buttons, and reset button.
+ * Owns `debugMode` subscription so that toggling it does not re-render
+ * MessageList, ChatInput, or ClosedVisualizationsPanel.
+ */
+export declare function ChatHeaderBar({ config, hasApiKey, onClearApiKey, showDrawerToggle, onToggleDrawer, onReset, onExampleClick, isLoading, }: ChatHeaderBarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/components/ChatInput.d.ts

@@ -0,0 +1,7 @@
+interface ChatInputProps {
+    onSend: (text: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+}
+export declare function ChatInput({ onSend, disabled, placeholder }: ChatInputProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/components/ChatPanel.d.ts

@@ -0,0 +1,13 @@
+import { QueryConfig } from '../api/completions';
+interface ChatPanelProps {
+    config: QueryConfig;
+    needsApiKey: boolean;
+    hasApiKey: boolean;
+    onSetApiKey: (key: string) => void;
+    onClearApiKey: () => void;
+    showDrawerToggle?: boolean;
+    drawerOpen?: boolean;
+    onToggleDrawer?: () => void;
+}
+export declare function ChatPanel({ config, needsApiKey, hasApiKey, onSetApiKey, onClearApiKey, showDrawerToggle, onToggleDrawer, }: ChatPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/components/ClosedVisualizationsPanel.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Renders a strip of recently-closed visualizations with per-item restore
+ * buttons. Subscribes to `memoryBank.closedVisualizations` in isolation so
+ * that closing/restoring a viz does not re-render the parent ChatPanel.
+ */
+export declare function ClosedVisualizationsPanel(): import("react/jsx-runtime").JSX.Element | null;

package/dist/features/chat/components/ConversationList.d.ts

@@ -0,0 +1 @@
+export declare function ConversationList(): import("react/jsx-runtime").JSX.Element;

package/dist/features/chat/components/DebugToggleSection.d.ts

@@ -0,0 +1,13 @@
+interface DebugToggleSectionProps {
+    showSystemPrompts: boolean;
+    onShowSystemPromptsChange: (value: boolean) => void;
+}
+/**
+ * Debug-mode-only toggle row for controlling the visibility of system
+ * messages in the transcript. Gated internally on `global.debugMode` and
+ * subscribes to `conversation.messages` only to detect whether system
+ * messages exist — both subscriptions are kept here so the parent
+ * ChatPanel does not re-render when debug mode toggles or messages change.
+ */
+export declare function DebugToggleSection({ showSystemPrompts, onShowSystemPromptsChange, }: DebugToggleSectionProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/features/chat/components/MessageBubble.d.ts

@@ -0,0 +1,8 @@
+import { Message } from '../../../types/messages';
+interface MessageBubbleProps {
+    message: Message;
+    messageIndex: number;
+    onSelectSuggestion?: (suggestion: string) => void;
+}
+export declare function MessageBubble({ message, messageIndex, onSelectSuggestion }: MessageBubbleProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/components/MessageList.d.ts

@@ -0,0 +1,7 @@
+interface MessageListProps {
+    isLoading: boolean;
+    showSystemPrompts?: boolean;
+    onSelectSuggestion?: (suggestion: string) => void;
+}
+export declare function MessageList({ isLoading, showSystemPrompts, onSelectSuggestion, }: MessageListProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/chat/hooks/useChatApi.d.ts

@@ -0,0 +1,6 @@
+import { QueryConfig } from '../api/completions';
+export declare function useChatApi(config: QueryConfig): {
+    sendMessage: (text: string) => Promise<void>;
+    isLoading: boolean;
+    error: string | null;
+};

package/dist/features/chat/hooks/useDebugExports.d.ts

@@ -0,0 +1,11 @@
+import { QueryConfig } from '../api/completions';
+/**
+ * Bundles the debug-mode export buttons: save conversation, export test case,
+ * download data domains, download data schema.
+ */
+export declare function useDebugExports(config: QueryConfig): {
+    handleSaveConversation: () => void;
+    handleExportTestCase: () => void;
+    handleDownloadDataDomains: () => void;
+    handleDownloadDataSchema: () => void;
+};

package/dist/features/chat/hooks/useExamplePrompts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fetches example prompts from the UDI agent's /v1/yac/examples endpoint.
+ * Returns an empty list until the fetch resolves or if the endpoint is unavailable.
+ */
+export declare function useExamplePrompts(apiBaseUrl: string | undefined): {
+    examplePrompts: string[];
+};

package/dist/features/chat/hooks/useResetHandlers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bundles the "reset everything" action — clears the active conversation,
+ * all pinned visualizations, selections, the closed-viz memory bank, and
+ * all cross-chart filters.
+ */
+export declare function useResetHandlers(): {
+    handleReset: () => void;
+};

package/dist/features/chat/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Public API of the `chat` feature. Cross-feature and app-layer imports must
+ * go through this barrel (enforced by eslint-plugin-project-structure's
+ * independent-modules rule); intra-feature imports should use relative paths.
+ */
+export { ChatPanel } from './components/ChatPanel';
+export { ConversationList } from './components/ConversationList';
+export { createConversationStore, type ConversationState } from './stores/conversationStore';
+export type { QueryConfig } from './api/completions';

package/dist/features/chat/stores/conversationStore.d.ts

@@ -0,0 +1,10 @@
+import { Message } from '../../../types/messages';
+export interface ConversationState {
+    messages: Message[];
+    addMessage: (message: Message) => void;
+    newConversation: () => void;
+    getMessagesFormattedForLLM: () => Message[];
+    loadConversation: (messages: Message[]) => void;
+    exportConversation: () => string;
+}
+export declare function createConversationStore(): import('zustand').StoreApi<ConversationState>;

package/dist/features/chat/stores/conversationStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/dashboard/components/DashboardCard.d.ts

@@ -0,0 +1,9 @@
+import { DataSelections } from 'udi-toolkit/react';
+import { PinnedVisualization } from '../stores/dashboardStore';
+interface DashboardCardProps {
+    vizKey: string;
+    viz: PinnedVisualization;
+    selections: DataSelections;
+}
+export declare function DashboardCard({ vizKey, viz, selections }: DashboardCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/dashboard/components/DashboardPanel.d.ts

@@ -0,0 +1 @@
+export declare function DashboardPanel(): import("react/jsx-runtime").JSX.Element;

package/dist/features/dashboard/components/DataCounts.d.ts

@@ -0,0 +1 @@
+export declare function DataCounts(): import("react/jsx-runtime").JSX.Element | null;

package/dist/features/dashboard/components/DownloadButton.d.ts

@@ -0,0 +1 @@
+export declare function DownloadButton(): import("react/jsx-runtime").JSX.Element;

package/dist/features/dashboard/components/FilterToolbar.d.ts

@@ -0,0 +1 @@
+export declare function FilterToolbar(): import("react/jsx-runtime").JSX.Element;

package/dist/features/dashboard/components/VizTweakComponent.d.ts

@@ -0,0 +1,8 @@
+import { UDIGrammar } from 'udi-toolkit/react';
+interface VizTweakComponentProps {
+    spec: UDIGrammar;
+    messageIndex: number;
+    toolCallIndex: number;
+}
+export declare function VizTweakComponent({ spec, messageIndex, toolCallIndex }: VizTweakComponentProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/features/dashboard/components/VizTweakComponent.types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Narrow structural shapes used by VizTweakComponent when walking a
+ * UDIGrammar spec's representation layers. These deliberately mirror a
+ * subset of the grammar's layer/mapping types so the component can
+ * introspect without depending on the full upstream type graph.
+ */
+export interface TweakableParam {
+    field: string;
+    encoding: string;
+    options: string[];
+}
+export interface MappingLike {
+    field?: string;
+    encoding?: string;
+    type?: string;
+}
+export interface LayerLike {
+    mark?: string;
+    mapping?: MappingLike | MappingLike[];
+}

package/dist/features/dashboard/components/WelcomeSplash.d.ts

@@ -0,0 +1 @@
+export declare function WelcomeSplash(): import("react/jsx-runtime").JSX.Element;

package/dist/features/dashboard/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public API of the `dashboard` feature. Cross-feature and app-layer imports
+ * must go through this barrel; intra-feature imports use relative paths.
+ */
+export { DashboardPanel } from './components/DashboardPanel';
+export { VizTweakComponent } from './components/VizTweakComponent';
+export { createDashboardStore, extractAllUdiSpecsFromMessage, type DashboardState, type PinnedVisualization, } from './stores/dashboardStore';
+export { createDataFiltersStore, extractFilterSpecFromMessage, messageFilterKeyWithToolCall, messageFilterKey, type DataFiltersState, type DataSelection, type DataSelections, } from './stores/dataFiltersStore';
+export { createSelectionsStore, type SelectionsState } from './stores/selectionsStore';
+export { createMemoryBankStore, type MemoryBankState } from './stores/memoryBankStore';

package/dist/features/dashboard/stores/dashboardStore.d.ts

@@ -0,0 +1,70 @@
+import { StoreApi } from 'zustand/vanilla';
+import { UDIGrammar } from 'udi-toolkit/react';
+import { Message } from '../../../types/messages';
+import { DataFiltersState } from './dataFiltersStore';
+import { DataPackageState } from '../../data-package';
+import { MemoryBankState } from './memoryBankStore';
+export interface PinnedVisualization {
+    index: number;
+    toolCallIndex: number;
+    spec: UDIGrammar;
+    interactiveSpec: UDIGrammar;
+    userPrompt: string;
+    title?: string;
+    uuid: string;
+}
+export interface ExtractedSpec {
+    spec: object;
+    toolCallIndex: number;
+    title?: string;
+}
+export interface DashboardState {
+    pinnedVisualizations: Map<string, PinnedVisualization>;
+    filterAllNullValues: boolean;
+    expandedVisualizations: Set<string>;
+    tableViewKeys: Set<string>;
+    hoveredVisualizationIndex: string | null;
+    pinKey: (messageIndex: number, toolCallIndex: number) => string;
+    pinVisualization: (index: number, toolCallIndex: number, spec: UDIGrammar, userPrompt: string, sourceFields: Record<string, string[]> | null, title?: string) => void;
+    pinVisualizationBatch: (items: Array<{
+        index: number;
+        toolCallIndex: number;
+        spec: UDIGrammar;
+        userPrompt: string;
+        sourceFields: Record<string, string[]> | null;
+        title?: string;
+    }>) => void;
+    unpinVisualization: (key: string, memoryBankStore?: StoreApi<MemoryBankState>) => void;
+    restoreFromMemoryBank: (key: string, memoryBankStore: StoreApi<MemoryBankState>) => void;
+    isPinned: (key: string) => boolean;
+    clearAllVisualizations: () => void;
+    setFilterAllNullValues: (value: boolean) => void;
+    toggleExpanded: (key: string) => void;
+    isExpanded: (key: string) => boolean;
+    toggleTableView: (key: string) => void;
+    isTableView: (key: string) => boolean;
+    setHoveredVisualizationIndex: (key: string | null) => void;
+    isHovered: (key: string) => boolean;
+    updateSpecFilters: (dataFiltersStore: StoreApi<DataFiltersState>, dataPackageStore: StoreApi<DataPackageState>) => void;
+    getNamedFilters: (filterIdList: string[], currentSourceName: string, dataFiltersStore: StoreApi<DataFiltersState>, dataPackageStore: StoreApi<DataPackageState>) => object[];
+    getFilterIds: (dataFiltersStore: StoreApi<DataFiltersState>) => string[];
+    updatePinnedVisualizationSpec: (key: string, newSpec: UDIGrammar, sourceFields: Record<string, string[]> | null) => void;
+}
+interface InteractiveSpec extends UDIGrammar {
+    config?: {
+        hideActions?: boolean;
+    };
+}
+export declare function injectInteractivity(spec: UDIGrammar, id: string, sourceFields: Record<string, string[]> | null): InteractiveSpec;
+export declare function createDashboardStore(): StoreApi<DashboardState>;
+export declare function normalizeToolCalls(message: Message): {
+    originalIndex: number;
+    name: string;
+    arguments: import('../../../types/messages').Arguments;
+}[];
+export declare function parseSpecFromToolCall(toolCall: {
+    name: string;
+    arguments: Record<string, unknown>;
+}): object | null;
+export declare function extractAllUdiSpecsFromMessage(message: Message): ExtractedSpec[];
+export {};

package/dist/features/dashboard/stores/dashboardStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/dashboard/stores/dataFiltersStore.d.ts

@@ -0,0 +1,34 @@
+import { DataSelection, DataSelections } from 'udi-toolkit/react';
+import { Message } from '../../../types/messages';
+import { FilterDataArgs } from '../../tool-calls';
+export type { DataSelection, DataSelections };
+export interface ExtractedFilter {
+    args: FilterDataArgs;
+    toolCallIndex: number;
+}
+interface ValidateFilterFn {
+    isValidIntervalFilter: (entity: string, field: string) => {
+        isValid: string;
+    };
+    isValidPointFilter: (entity: string, field: string, values: unknown[]) => {
+        isValid: string;
+    };
+}
+export interface DataFiltersState {
+    dataSelections: DataSelections;
+    internalDataSelections: DataSelections;
+    getValidDataSelections: (validate: ValidateFilterFn) => DataSelections;
+    syncFiltersFromMessages: (messages: Message[], validate: ValidateFilterFn) => void;
+    syncSelectionsBackToMessages: (messages: Message[]) => void;
+    updateInternalDataSelections: (newFilters: DataSelections) => void;
+    clearFilter: (key: string) => void;
+    resetFilters: () => void;
+    setDataSelection: (key: string, selection: DataSelection) => void;
+}
+export declare function messageFilterKeyWithToolCall(messageIndex: number, toolCallIndex: number, message?: Message): string;
+export declare function messageFilterKey(messageIndex: number, message?: Message): string;
+export declare function containsFilterCall(message: Message): boolean;
+export declare function extractAllFilterSpecsFromMessage(message: Message): ExtractedFilter[];
+export declare function extractFilterSpecFromMessage(message: Message): FilterDataArgs | null;
+export declare function generateFilterMessage(key: string, selection: DataSelection): Message | null;
+export declare function createDataFiltersStore(): import('zustand').StoreApi<DataFiltersState>;

package/dist/features/dashboard/stores/dataFiltersStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/dashboard/stores/memoryBankStore.d.ts

@@ -0,0 +1,8 @@
+import { PinnedVisualization } from './dashboardStore';
+export interface MemoryBankState {
+    closedVisualizations: Map<string, PinnedVisualization>;
+    addToMemoryBank: (key: string, viz: PinnedVisualization) => void;
+    removeFromMemoryBank: (key: string) => void;
+    clearMemoryBank: () => void;
+}
+export declare function createMemoryBankStore(): import('zustand').StoreApi<MemoryBankState>;

package/dist/features/dashboard/stores/memoryBankStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/dashboard/stores/selectionsStore.d.ts

@@ -0,0 +1,7 @@
+import { DataSelections } from 'udi-toolkit/react';
+export interface SelectionsState {
+    selections: DataSelections;
+    updateSelections: (newSelections: DataSelections) => void;
+    clearSelections: () => void;
+}
+export declare function createSelectionsStore(): import('zustand').StoreApi<SelectionsState>;

package/dist/features/dashboard/stores/selectionsStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/data-package/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public API of the `data-package` feature. Cross-feature and app-layer imports
+ * must go through this barrel; intra-feature imports use relative paths.
+ */
+export { createDataPackageStore, type DataPackageState, type LoadingPhase, } from './stores/dataPackageStore';
+export { joinDataPath } from './utils/joinDataPath';
+export { evaluateStructuredText, hasStructuredReferences } from './utils/structuredTextParser';

package/dist/features/data-package/stores/dataPackageStore.d.ts

@@ -0,0 +1,25 @@
+import { DataFieldDomain, DataPackage, ValidStatus, EntityRelationship, ExportRowSet } from '../../../types/dataPackage';
+export type LoadingPhase = 'idle' | 'fetching' | 'domains' | 'ready' | 'error';
+export interface DataPackageState {
+    dataPackage: DataPackage | null;
+    dataFieldDomains: DataFieldDomain[];
+    loadingPhase: LoadingPhase;
+    error: string | null;
+    sourceFields: Record<string, string[]> | null;
+    quantitativeSourceFields: Record<string, string[]> | null;
+    categoricalSourceFields: Record<string, string[]> | null;
+    entityNames: string[];
+    dataPackageString: string;
+    dataDomainsString: string;
+    /** Maps entity names to canonical data URLs (from udi:path + resource.path). */
+    sourceResolver: Record<string, string>;
+    filteredData: Map<string, ExportRowSet>;
+    fetchDataPackage: (path: string, fetchOptions?: RequestInit) => Promise<void>;
+    setDataPackage: (dataPackage: DataPackage, precomputedDomains?: DataFieldDomain[], fetchOptions?: RequestInit) => Promise<void>;
+    getDomainForField: (entity: string, field: string) => DataFieldDomain | undefined;
+    isValidIntervalFilter: (entity: string, field: string) => ValidStatus;
+    isValidPointFilter: (entity: string, field: string, values: unknown[]) => ValidStatus;
+    getEntityRelationship: (originSource: string, targetSource: string) => EntityRelationship | null;
+    setFilteredData: (entity: string, data: ExportRowSet) => void;
+}
+export declare function createDataPackageStore(): import('zustand').StoreApi<DataPackageState>;

package/dist/features/data-package/stores/dataPackageStore.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/data-package/types.d.ts

@@ -0,0 +1,27 @@
+import { DataFieldDomain } from '../../types/dataPackage';
+export interface ResourceInput {
+    entityName: string;
+    /** Pre-fetched CSV/TSV text content. */
+    csvText: string;
+    delimiter: string;
+    fieldDescriptions: Record<string, string>;
+}
+export interface ComputeDomainsRequest {
+    type: 'compute';
+    resources: ResourceInput[];
+}
+export interface EntityDomainsResult {
+    type: 'entity-domains';
+    entityName: string;
+    domains: DataFieldDomain[];
+}
+export interface DoneResult {
+    type: 'done';
+}
+export interface ErrorResult {
+    type: 'error';
+    entityName: string;
+    message: string;
+}
+export type WorkerMessage = ComputeDomainsRequest;
+export type WorkerResponse = EntityDomainsResult | DoneResult | ErrorResult;

package/dist/features/data-package/utils/joinDataPath.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Join a base path (udi:path) with a resource path, handling:
+ * - Base with or without trailing slash
+ * - Resource with or without leading slash
+ * - HTTP(S) URLs and local relative paths
+ */
+export declare function joinDataPath(basePath: string, resourcePath: string): string;

package/dist/features/data-package/utils/joinDataPath.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/data-package/utils/structuredTextParser.d.ts

@@ -0,0 +1,7 @@
+import { DataPackageState } from '..';
+export interface StructuredTextSegment {
+    type: 'text' | 'value';
+    content: string;
+}
+export declare function evaluateStructuredText(text: string, store: DataPackageState): StructuredTextSegment[];
+export declare function hasStructuredReferences(text: string): boolean;

package/dist/features/data-package/utils/structuredTextParser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/features/data-package/workers/domainWorker.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Web Worker for computing data field domains from pre-fetched CSV/TSV text.
+ *
+ * The main thread fetches the CSV text (priming the browser HTTP cache for
+ * UDIVis to reuse) and sends it here for the expensive parsing + domain
+ * computation, keeping the main thread responsive.
+ *
+ * Message protocol:
+ *   Main → Worker:  ComputeDomainsRequest  (one message with pre-fetched text)
+ *   Worker → Main:  EntityDomainsResult     (one per resource, streamed)
+ *   Worker → Main:  DoneResult | ErrorResult (termination)
+ */
+export {};

package/dist/features/tool-calls/components/ClarifyVariable.d.ts

@@ -0,0 +1,6 @@
+import { ClarifyVariableArgs } from '../types';
+interface ClarifyVariableProps extends ClarifyVariableArgs {
+    onSelectSuggestion?: (value: string) => void;
+}
+export declare function ClarifyVariable({ message, ambiguous_variables, onSelectSuggestion, }: ClarifyVariableProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/tool-calls/components/FilterComponent.d.ts

@@ -0,0 +1,9 @@
+import { Message } from '../../../types/messages';
+interface FilterComponentProps {
+    message: Message;
+    messageIndex: number;
+    toolCallIndex?: number;
+    tweakable?: boolean;
+}
+export declare function FilterComponent({ message, messageIndex, toolCallIndex, tweakable, }: FilterComponentProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/features/tool-calls/components/FreeTextExplain.d.ts

@@ -0,0 +1,2 @@
+import { FreeTextExplainArgs } from '../types';
+export declare function FreeTextExplain({ text, has_structured_elements }: FreeTextExplainArgs): import("react/jsx-runtime").JSX.Element;

package/dist/features/tool-calls/components/IntervalFilterComponent.d.ts

@@ -0,0 +1,9 @@
+import { DataSelection } from '../../dashboard';
+interface IntervalFilterComponentProps {
+    dataSelection: DataSelection;
+    fieldIndex: number;
+    tweakable: boolean;
+    filterKey: string;
+}
+export declare function IntervalFilterComponent({ dataSelection, fieldIndex, tweakable, filterKey, }: IntervalFilterComponentProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/tool-calls/components/PointFilterComponent.d.ts

@@ -0,0 +1,8 @@
+import { DataSelection } from '../../dashboard';
+interface PointFilterComponentProps {
+    dataSelection: DataSelection;
+    tweakable: boolean;
+    filterKey: string;
+}
+export declare function PointFilterComponent({ dataSelection, tweakable, filterKey, }: PointFilterComponentProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/features/tool-calls/components/RebuffNotice.d.ts

@@ -0,0 +1,7 @@
+interface RebuffNoticeProps {
+    message: string;
+    suggestions: string[];
+    onSelectSuggestion?: (suggestion: string) => void;
+}
+export declare function RebuffNotice({ message, suggestions, onSelectSuggestion }: RebuffNoticeProps): import("react/jsx-runtime").JSX.Element;
+export {};