@malloy-publisher/sdk 0.0.137 → 0.0.139

package/dist/client/api.d.ts

@@ -161,43 +161,6 @@ export interface CompiledModel {
      */
     'queries'?: Array<Query>;
 }
-/**
- * Compiled Malloy notebook with cells, results, and execution data
- * @export
- * @interface CompiledNotebook
- */
-export interface CompiledNotebook {
-    /**
-     * Resource path to the notebook
-     * @type {string}
-     * @memberof CompiledNotebook
-     */
-    'resource'?: string;
-    /**
-     * Name of the package containing this notebook
-     * @type {string}
-     * @memberof CompiledNotebook
-     */
-    'packageName'?: string;
-    /**
-     * Relative path to the notebook file within its package directory
-     * @type {string}
-     * @memberof CompiledNotebook
-     */
-    'path'?: string;
-    /**
-     * Version of the Malloy compiler used to generate the notebook data
-     * @type {string}
-     * @memberof CompiledNotebook
-     */
-    'malloyVersion'?: string;
-    /**
-     * Array of notebook cells containing code, markdown, and execution results
-     * @type {Array<NotebookCell>}
-     * @memberof CompiledNotebook
-     */
-    'notebookCells'?: Array<NotebookCell>;
-}
 /**
  * Database connection configuration and metadata
  * @export
@@ -535,29 +498,65 @@ export interface NotebookCell {
      */
     'type'?: NotebookCellTypeEnum;
     /**
-     * Text contents of the notebook cell
+     * Text contents of the notebook cell (either markdown or Malloy code)
      * @type {string}
      * @memberof NotebookCell
      */
     'text'?: string;
     /**
-     * JSON string containing the execution result for this cell
+     * Array of JSON strings containing SourceInfo objects made available in this cell
+     * @type {Array<string>}
+     * @memberof NotebookCell
+     */
+    'newSources'?: Array<string>;
+    /**
+     * JSON string containing QueryInfo object for the query in this cell (if the cell contains a query)
      * @type {string}
      * @memberof NotebookCell
      */
+    'queryInfo'?: string;
+}
+export declare const NotebookCellTypeEnum: {
+    readonly Markdown: "markdown";
+    readonly Code: "code";
+};
+export type NotebookCellTypeEnum = typeof NotebookCellTypeEnum[keyof typeof NotebookCellTypeEnum];
+/**
+ * Result of executing a notebook cell
+ * @export
+ * @interface NotebookCellResult
+ */
+export interface NotebookCellResult {
+    /**
+     * Type of notebook cell
+     * @type {string}
+     * @memberof NotebookCellResult
+     */
+    'type'?: NotebookCellResultTypeEnum;
+    /**
+     * Text contents of the notebook cell
+     * @type {string}
+     * @memberof NotebookCellResult
+     */
+    'text'?: string;
+    /**
+     * JSON string containing the execution result for this cell
+     * @type {string}
+     * @memberof NotebookCellResult
+     */
     'result'?: string;
     /**
      * Array of JSON strings containing SourceInfo objects made available in this cell
      * @type {Array<string>}
-     * @memberof NotebookCell
+     * @memberof NotebookCellResult
      */
     'newSources'?: Array<string>;
 }
-export declare const NotebookCellTypeEnum: {
+export declare const NotebookCellResultTypeEnum: {
     readonly Markdown: "markdown";
     readonly Code: "code";
 };
-export type NotebookCellTypeEnum = typeof NotebookCellTypeEnum[keyof typeof NotebookCellTypeEnum];
+export type NotebookCellResultTypeEnum = typeof NotebookCellResultTypeEnum[keyof typeof NotebookCellResultTypeEnum];
 /**
  * Represents a Malloy package containing models, notebooks, and embedded databases
  * @export
@@ -782,6 +781,49 @@ export interface QueryResult {
      */
     'resource'?: string;
 }
+/**
+ * Raw Malloy notebook with unexecuted cell contents
+ * @export
+ * @interface RawNotebook
+ */
+export interface RawNotebook {
+    /**
+     * Resource path to the notebook
+     * @type {string}
+     * @memberof RawNotebook
+     */
+    'resource'?: string;
+    /**
+     * Name of the package containing this notebook
+     * @type {string}
+     * @memberof RawNotebook
+     */
+    'packageName'?: string;
+    /**
+     * Relative path to the notebook file within its package directory
+     * @type {string}
+     * @memberof RawNotebook
+     */
+    'path'?: string;
+    /**
+     * Version of the Malloy compiler used to generate the notebook data
+     * @type {string}
+     * @memberof RawNotebook
+     */
+    'malloyVersion'?: string;
+    /**
+     * Array of notebook cells containing raw markdown and code content
+     * @type {Array<NotebookCell>}
+     * @memberof RawNotebook
+     */
+    'notebookCells'?: Array<NotebookCell>;
+    /**
+     * Array of file-level (##) annotations attached to the notebook
+     * @type {Array<string>}
+     * @memberof RawNotebook
+     */
+    'annotations'?: Array<string>;
+}
 /**
  * A schema name in a Connection.
  * @export
@@ -1947,8 +1989,20 @@ export declare class ModelsApi extends BaseAPI {
  */
 export declare const NotebooksApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook is compiled using the specified version of the Malloy compiler. This endpoint provides access to the notebook\'s structure, cells, and execution results for use in applications.
-     * @summary Get compiled Malloy notebook
+     * Executes a specific cell in a Malloy notebook by index. For code cells, this compiles and runs the Malloy code, returning query results and any new sources defined. For markdown cells, this simply returns the cell content.
+     * @summary Execute a specific notebook cell
+     * @param {string} projectName Name of the project
+     * @param {string} packageName Name of the package
+     * @param {string} path Path to notebook within the package
+     * @param {number} cellIndex Index of the cell to execute (0-based)
+     * @param {string} [versionId] Version identifier for the package
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    executeNotebookCell: (projectName: string, packageName: string, path: string, cellIndex: number, versionId?: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Retrieves a Malloy notebook with its raw cell contents (markdown and code). Cell execution should be done separately via the execute-notebook-cell endpoint.
+     * @summary Get Malloy notebook cells
      * @param {string} projectName Name of the project
      * @param {string} packageName Name of the package
      * @param {string} path Path to notebook within the package.
@@ -1974,8 +2028,20 @@ export declare const NotebooksApiAxiosParamCreator: (configuration?: Configurati
  */
 export declare const NotebooksApiFp: (configuration?: Configuration) => {
     /**
-     * Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook is compiled using the specified version of the Malloy compiler. This endpoint provides access to the notebook\'s structure, cells, and execution results for use in applications.
-     * @summary Get compiled Malloy notebook
+     * Executes a specific cell in a Malloy notebook by index. For code cells, this compiles and runs the Malloy code, returning query results and any new sources defined. For markdown cells, this simply returns the cell content.
+     * @summary Execute a specific notebook cell
+     * @param {string} projectName Name of the project
+     * @param {string} packageName Name of the package
+     * @param {string} path Path to notebook within the package
+     * @param {number} cellIndex Index of the cell to execute (0-based)
+     * @param {string} [versionId] Version identifier for the package
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    executeNotebookCell(projectName: string, packageName: string, path: string, cellIndex: number, versionId?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NotebookCellResult>>;
+    /**
+     * Retrieves a Malloy notebook with its raw cell contents (markdown and code). Cell execution should be done separately via the execute-notebook-cell endpoint.
+     * @summary Get Malloy notebook cells
      * @param {string} projectName Name of the project
      * @param {string} packageName Name of the package
      * @param {string} path Path to notebook within the package.
@@ -1983,7 +2049,7 @@ export declare const NotebooksApiFp: (configuration?: Configuration) => {
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CompiledNotebook>>;
+    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<RawNotebook>>;
     /**
      * Retrieves a list of all Malloy notebooks within the specified package. Each notebook entry includes the relative path, package name, and any compilation errors. This endpoint is useful for discovering available notebooks and checking their status.
      * @summary List package notebooks
@@ -2001,8 +2067,20 @@ export declare const NotebooksApiFp: (configuration?: Configuration) => {
  */
 export declare const NotebooksApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook is compiled using the specified version of the Malloy compiler. This endpoint provides access to the notebook\'s structure, cells, and execution results for use in applications.
-     * @summary Get compiled Malloy notebook
+     * Executes a specific cell in a Malloy notebook by index. For code cells, this compiles and runs the Malloy code, returning query results and any new sources defined. For markdown cells, this simply returns the cell content.
+     * @summary Execute a specific notebook cell
+     * @param {string} projectName Name of the project
+     * @param {string} packageName Name of the package
+     * @param {string} path Path to notebook within the package
+     * @param {number} cellIndex Index of the cell to execute (0-based)
+     * @param {string} [versionId] Version identifier for the package
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    executeNotebookCell(projectName: string, packageName: string, path: string, cellIndex: number, versionId?: string, options?: RawAxiosRequestConfig): AxiosPromise<NotebookCellResult>;
+    /**
+     * Retrieves a Malloy notebook with its raw cell contents (markdown and code). Cell execution should be done separately via the execute-notebook-cell endpoint.
+     * @summary Get Malloy notebook cells
      * @param {string} projectName Name of the project
      * @param {string} packageName Name of the package
      * @param {string} path Path to notebook within the package.
@@ -2010,7 +2088,7 @@ export declare const NotebooksApiFactory: (configuration?: Configuration, basePa
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): AxiosPromise<CompiledNotebook>;
+    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): AxiosPromise<RawNotebook>;
     /**
      * Retrieves a list of all Malloy notebooks within the specified package. Each notebook entry includes the relative path, package name, and any compilation errors. This endpoint is useful for discovering available notebooks and checking their status.
      * @summary List package notebooks
@@ -2030,8 +2108,21 @@ export declare const NotebooksApiFactory: (configuration?: Configuration, basePa
  */
 export declare class NotebooksApi extends BaseAPI {
     /**
-     * Retrieves a compiled Malloy notebook with its cells, results, and metadata. The notebook is compiled using the specified version of the Malloy compiler. This endpoint provides access to the notebook\'s structure, cells, and execution results for use in applications.
-     * @summary Get compiled Malloy notebook
+     * Executes a specific cell in a Malloy notebook by index. For code cells, this compiles and runs the Malloy code, returning query results and any new sources defined. For markdown cells, this simply returns the cell content.
+     * @summary Execute a specific notebook cell
+     * @param {string} projectName Name of the project
+     * @param {string} packageName Name of the package
+     * @param {string} path Path to notebook within the package
+     * @param {number} cellIndex Index of the cell to execute (0-based)
+     * @param {string} [versionId] Version identifier for the package
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof NotebooksApi
+     */
+    executeNotebookCell(projectName: string, packageName: string, path: string, cellIndex: number, versionId?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<NotebookCellResult, any, {}>>;
+    /**
+     * Retrieves a Malloy notebook with its raw cell contents (markdown and code). Cell execution should be done separately via the execute-notebook-cell endpoint.
+     * @summary Get Malloy notebook cells
      * @param {string} projectName Name of the project
      * @param {string} packageName Name of the package
      * @param {string} path Path to notebook within the package.
@@ -2040,7 +2131,7 @@ export declare class NotebooksApi extends BaseAPI {
      * @throws {RequiredError}
      * @memberof NotebooksApi
      */
-    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<CompiledNotebook, any, {}>>;
+    getNotebook(projectName: string, packageName: string, path: string, versionId?: string, options?: RawAxiosRequestConfig): Promise< AxiosResponse<RawNotebook, any, {}>>;
     /**
      * Retrieves a list of all Malloy notebooks within the specified package. Each notebook entry includes the relative path, package name, and any compilation errors. This endpoint is useful for discovering available notebooks and checking their status.
      * @summary List package notebooks

package/dist/client/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../ServerProvider-lXAaPKBb.cjs.js");exports.AttachedDatabaseTypeEnum=o.AttachedDatabaseTypeEnum;exports.Configuration=o.Configuration;exports.ConnectionStatusStatusEnum=o.ConnectionStatusStatusEnum;exports.ConnectionTypeEnum=o.ConnectionTypeEnum;exports.ConnectionsApi=o.ConnectionsApi;exports.ConnectionsApiAxiosParamCreator=o.ConnectionsApiAxiosParamCreator;exports.ConnectionsApiFactory=o.ConnectionsApiFactory;exports.ConnectionsApiFp=o.ConnectionsApiFp;exports.ConnectionsTestApi=o.ConnectionsTestApi;exports.ConnectionsTestApiAxiosParamCreator=o.ConnectionsTestApiAxiosParamCreator;exports.ConnectionsTestApiFactory=o.ConnectionsTestApiFactory;exports.ConnectionsTestApiFp=o.ConnectionsTestApiFp;exports.DatabaseTypeEnum=o.DatabaseTypeEnum;exports.DatabasesApi=o.DatabasesApi;exports.DatabasesApiAxiosParamCreator=o.DatabasesApiAxiosParamCreator;exports.DatabasesApiFactory=o.DatabasesApiFactory;exports.DatabasesApiFp=o.DatabasesApiFp;exports.ModelsApi=o.ModelsApi;exports.ModelsApiAxiosParamCreator=o.ModelsApiAxiosParamCreator;exports.ModelsApiFactory=o.ModelsApiFactory;exports.ModelsApiFp=o.ModelsApiFp;exports.NotebookCellTypeEnum=o.NotebookCellTypeEnum;exports.NotebooksApi=o.NotebooksApi;exports.NotebooksApiAxiosParamCreator=o.NotebooksApiAxiosParamCreator;exports.NotebooksApiFactory=o.NotebooksApiFactory;exports.NotebooksApiFp=o.NotebooksApiFp;exports.PackagesApi=o.PackagesApi;exports.PackagesApiAxiosParamCreator=o.PackagesApiAxiosParamCreator;exports.PackagesApiFactory=o.PackagesApiFactory;exports.PackagesApiFp=o.PackagesApiFp;exports.ProjectsApi=o.ProjectsApi;exports.ProjectsApiAxiosParamCreator=o.ProjectsApiAxiosParamCreator;exports.ProjectsApiFactory=o.ProjectsApiFactory;exports.ProjectsApiFp=o.ProjectsApiFp;exports.PublisherApi=o.PublisherApi;exports.PublisherApiAxiosParamCreator=o.PublisherApiAxiosParamCreator;exports.PublisherApiFactory=o.PublisherApiFactory;exports.PublisherApiFp=o.PublisherApiFp;exports.ServerProvider=o.ServerProvider;exports.WatchModeApi=o.WatchModeApi;exports.WatchModeApiAxiosParamCreator=o.WatchModeApiAxiosParamCreator;exports.WatchModeApiFactory=o.WatchModeApiFactory;exports.WatchModeApiFp=o.WatchModeApiFp;exports.globalQueryClient=o.globalQueryClient;exports.useServer=o.useServer;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../ServerProvider-Bzid56gJ.cjs.js");exports.AttachedDatabaseTypeEnum=o.AttachedDatabaseTypeEnum;exports.Configuration=o.Configuration;exports.ConnectionStatusStatusEnum=o.ConnectionStatusStatusEnum;exports.ConnectionTypeEnum=o.ConnectionTypeEnum;exports.ConnectionsApi=o.ConnectionsApi;exports.ConnectionsApiAxiosParamCreator=o.ConnectionsApiAxiosParamCreator;exports.ConnectionsApiFactory=o.ConnectionsApiFactory;exports.ConnectionsApiFp=o.ConnectionsApiFp;exports.ConnectionsTestApi=o.ConnectionsTestApi;exports.ConnectionsTestApiAxiosParamCreator=o.ConnectionsTestApiAxiosParamCreator;exports.ConnectionsTestApiFactory=o.ConnectionsTestApiFactory;exports.ConnectionsTestApiFp=o.ConnectionsTestApiFp;exports.DatabaseTypeEnum=o.DatabaseTypeEnum;exports.DatabasesApi=o.DatabasesApi;exports.DatabasesApiAxiosParamCreator=o.DatabasesApiAxiosParamCreator;exports.DatabasesApiFactory=o.DatabasesApiFactory;exports.DatabasesApiFp=o.DatabasesApiFp;exports.ModelsApi=o.ModelsApi;exports.ModelsApiAxiosParamCreator=o.ModelsApiAxiosParamCreator;exports.ModelsApiFactory=o.ModelsApiFactory;exports.ModelsApiFp=o.ModelsApiFp;exports.NotebookCellResultTypeEnum=o.NotebookCellResultTypeEnum;exports.NotebookCellTypeEnum=o.NotebookCellTypeEnum;exports.NotebooksApi=o.NotebooksApi;exports.NotebooksApiAxiosParamCreator=o.NotebooksApiAxiosParamCreator;exports.NotebooksApiFactory=o.NotebooksApiFactory;exports.NotebooksApiFp=o.NotebooksApiFp;exports.PackagesApi=o.PackagesApi;exports.PackagesApiAxiosParamCreator=o.PackagesApiAxiosParamCreator;exports.PackagesApiFactory=o.PackagesApiFactory;exports.PackagesApiFp=o.PackagesApiFp;exports.ProjectsApi=o.ProjectsApi;exports.ProjectsApiAxiosParamCreator=o.ProjectsApiAxiosParamCreator;exports.ProjectsApiFactory=o.ProjectsApiFactory;exports.ProjectsApiFp=o.ProjectsApiFp;exports.PublisherApi=o.PublisherApi;exports.PublisherApiAxiosParamCreator=o.PublisherApiAxiosParamCreator;exports.PublisherApiFactory=o.PublisherApiFactory;exports.PublisherApiFp=o.PublisherApiFp;exports.ServerProvider=o.ServerProvider;exports.WatchModeApi=o.WatchModeApi;exports.WatchModeApiAxiosParamCreator=o.WatchModeApiAxiosParamCreator;exports.WatchModeApiFactory=o.WatchModeApiFactory;exports.WatchModeApiFp=o.WatchModeApiFp;exports.globalQueryClient=o.globalQueryClient;exports.useServer=o.useServer;

package/dist/client/index.es.js

@@ -1,4 +1,4 @@
-import { A as o, Q as e, a as i, C as t, e as r, b as p, d as A, c as n, j as c, f as C, i as P, h as F, D as b, n as m, k as u, m as y, l, q as d, M as x, p as h, o as k, N as M, v as T, r as g, t as D, s as E, y as N, P as j, x as S, w as W, F as v, z as f, E as Q, B as q, J as w, G as z, I as B, H as G, S as H, O as I, W as J, L as K, K as L, g as O, u as R } from "../ServerProvider-BGGK1ZQ_.es.js";
+import { A as o, R as e, a as i, C as t, f as r, c as p, e as A, d as n, k as c, h as C, j as P, i as F, D as b, o as l, l as m, n as u, m as y, r as d, M as k, q as x, p as h, b as M, N as T, w as g, s as D, v as E, t as N, z as j, P as S, y as W, x as v, G as f, B as Q, F as R, E as q, K as w, H as z, J as B, I as G, S as H, Q as I, W as J, O as K, L, g as O, u as U } from "../ServerProvider-D-y63tG0.es.js";
 export {
   o as AttachedDatabaseTypeEnum,
   e as Configuration,
@@ -13,26 +13,27 @@ export {
   P as ConnectionsTestApiFactory,
   F as ConnectionsTestApiFp,
   b as DatabaseTypeEnum,
-  m as DatabasesApi,
-  u as DatabasesApiAxiosParamCreator,
-  y as DatabasesApiFactory,
-  l as DatabasesApiFp,
+  l as DatabasesApi,
+  m as DatabasesApiAxiosParamCreator,
+  u as DatabasesApiFactory,
+  y as DatabasesApiFp,
   d as ModelsApi,
-  x as ModelsApiAxiosParamCreator,
-  h as ModelsApiFactory,
-  k as ModelsApiFp,
-  M as NotebookCellTypeEnum,
-  T as NotebooksApi,
-  g as NotebooksApiAxiosParamCreator,
-  D as NotebooksApiFactory,
-  E as NotebooksApiFp,
-  N as PackagesApi,
-  j as PackagesApiAxiosParamCreator,
-  S as PackagesApiFactory,
-  W as PackagesApiFp,
-  v as ProjectsApi,
-  f as ProjectsApiAxiosParamCreator,
-  Q as ProjectsApiFactory,
+  k as ModelsApiAxiosParamCreator,
+  x as ModelsApiFactory,
+  h as ModelsApiFp,
+  M as NotebookCellResultTypeEnum,
+  T as NotebookCellTypeEnum,
+  g as NotebooksApi,
+  D as NotebooksApiAxiosParamCreator,
+  E as NotebooksApiFactory,
+  N as NotebooksApiFp,
+  j as PackagesApi,
+  S as PackagesApiAxiosParamCreator,
+  W as PackagesApiFactory,
+  v as PackagesApiFp,
+  f as ProjectsApi,
+  Q as ProjectsApiAxiosParamCreator,
+  R as ProjectsApiFactory,
   q as ProjectsApiFp,
   w as PublisherApi,
   z as PublisherApiAxiosParamCreator,
@@ -44,5 +45,5 @@ export {
   K as WatchModeApiFactory,
   L as WatchModeApiFp,
   O as globalQueryClient,
-  R as useServer
+  U as useServer
 };

package/dist/components/Notebook/Notebook.d.ts

@@ -1,6 +1,9 @@
+import { RetrievalFunction } from '../filter/DimensionFilter';
 interface NotebookProps {
     resourceUri: string;
     maxResultSize?: number;
+    /** Optional retrieval function for semantic search filters */
+    retrievalFn?: RetrievalFunction;
 }
-export default function Notebook({ resourceUri, maxResultSize, }: NotebookProps): import("react/jsx-runtime").JSX.Element;
+export default function Notebook({ resourceUri, maxResultSize, retrievalFn, }: NotebookProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Notebook/NotebookCell.d.ts

@@ -1,6 +1,6 @@
-import { NotebookCell as ClientNotebookCell } from '../../client';
+import { EnhancedNotebookCell } from './types';
 interface NotebookCellProps {
-    cell: ClientNotebookCell;
+    cell: EnhancedNotebookCell;
     expandCodeCell?: boolean;
     hideCodeCellIcon?: boolean;
     expandEmbedding?: boolean;

package/dist/components/Notebook/types.d.ts

@@ -0,0 +1,21 @@
+import { NotebookCell as ClientNotebookCell } from '../../client';
+/**
+ * Enhanced notebook cell that extends the base API cell with execution results.
+ * The base ClientNotebookCell only contains type and text (raw content).
+ * This interface adds the runtime execution data.
+ */
+export interface EnhancedNotebookCell extends ClientNotebookCell {
+    /**
+     * Name of the query that was executed (for code cells that run queries)
+     */
+    queryName?: string;
+    /**
+     * JSON string containing the query execution results
+     */
+    result?: string;
+    /**
+     * Array of JSON strings containing SourceInfo objects for data sources
+     * that become available in this cell (e.g., from imports or source definitions)
+     */
+    newSources?: string[];
+}

package/dist/components/filter/DimensionFilter.d.ts

@@ -0,0 +1,43 @@
+import { DimensionSpec, DimensionValue } from '../../hooks/useDimensionalFilterRangeData';
+import { FilterSelection } from '../../hooks/useDimensionFilters';
+/**
+ * Type for the retrieval function used by Retrieval filter type
+ */
+export type RetrievalFunction = (query: string, spec: DimensionSpec) => Promise<DimensionValue[]>;
+/**
+ * Props for DimensionFilter component
+ */
+export interface DimensionFilterProps {
+    /** The dimension specification */
+    spec: DimensionSpec;
+    /** Available values for this dimension */
+    values: DimensionValue[];
+    /** Current filter selection (optional) */
+    selection?: FilterSelection | null;
+    /** Callback when filter changes */
+    onChange: (selection: FilterSelection | null) => void;
+    /** Retrieval function for semantic search (required for Retrieval filter type) */
+    retrievalFn?: RetrievalFunction;
+}
+/**
+ * DimensionFilter component - Renders appropriate filter UI based on dimension type
+ *
+ * This component dynamically renders the appropriate filter UI based on the dimension's
+ * filter type and selected match type. It supports:
+ * - Star filters: Dropdown selection or text search
+ * - MinMax filters: Numeric input with comparison operators
+ * - DateMinMax filters: Date pickers with date comparison operators
+ *
+ * @param props - Component props including spec, values, selection, and onChange callback
+ *
+ * @example
+ * ```tsx
+ * <DimensionFilter
+ *   spec={{ dimensionName: "category", filterType: "Star" }}
+ *   values={categoryValues}
+ *   selection={currentSelection}
+ *   onChange={(selection) => updateFilter("category", selection)}
+ * />
+ * ```
+ */
+export declare function DimensionFilter({ spec, values, selection, onChange, retrievalFn, }: DimensionFilterProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/filter/index.d.ts

@@ -0,0 +1,4 @@
+export { DimensionFilter } from './DimensionFilter';
+export type { DimensionFilterProps, RetrievalFunction, } from './DimensionFilter';
+export { extractDimensionSpecs, extractSourceFromQuery, generateFilterClause, getJoinedSources, injectWhereClause, parseAllSourceInfos, parseDimensionFilterAnnotation, parseNotebookFilterAnnotation, } from './utils';
+export type { DimensionFilterAnnotation, FilterSpec, NotebookFilterConfig, } from './utils';

package/dist/components/filter/utils.d.ts

@@ -0,0 +1,75 @@
+import { DimensionSpec, FilterType } from '../../hooks/useDimensionalFilterRangeData';
+import { FilterSelection } from '../../hooks/useDimensionFilters';
+import * as Malloy from "@malloydata/malloy-interfaces";
+/**
+ * A single filter specification with source and dimension
+ * Parsed from "source.dimension" string format
+ */
+export interface FilterSpec {
+    source: string;
+    dimension: string;
+}
+/**
+ * Configuration parsed from notebook ##(filter) annotation
+ */
+export interface NotebookFilterConfig {
+    filters: FilterSpec[];
+}
+/**
+ * Filter annotation parsed from dimension #(filter) tag
+ */
+export interface DimensionFilterAnnotation {
+    type: FilterType;
+}
+/**
+ * Get the names of all sources that are joined into a given source
+ * Looks for fields with kind: "join" in the SourceInfo
+ */
+export declare function getJoinedSources(sourceInfo: Malloy.SourceInfo): Set<string>;
+/**
+ * Parse ##(filter) annotation from notebook annotations
+ * Format: ##(filters) ["source.dimension", "source2.dimension2", ...]
+ * Returns the filter config or null if not found
+ */
+export declare function parseNotebookFilterAnnotation(annotations: string[] | undefined): NotebookFilterConfig | null;
+/**
+ * Parse #(filter) annotation from a dimension annotation string
+ * Returns the filter annotation or null if not found
+ */
+export declare function parseDimensionFilterAnnotation(annotation: string): DimensionFilterAnnotation | null;
+/**
+ * Parse all source infos from notebook cells and create a map of source_name -> SourceInfo
+ * Also returns the model path from the first import statement found
+ */
+export declare function parseAllSourceInfos(cells: Array<{
+    type?: string;
+    newSources?: string[];
+    text?: string;
+}>): {
+    sourceInfoMap: Map<string, Malloy.SourceInfo>;
+    modelPath: string;
+};
+/**
+ * Extract dimension specs from SourceInfo map based on filter specs from notebook annotation
+ * Looks for #(filter) annotations on the dimensions to determine filter types
+ * Each spec includes source and model for proper query routing
+ */
+export declare function extractDimensionSpecs(sourceInfoMap: Map<string, Malloy.SourceInfo>, filterSpecs: FilterSpec[], modelPath: string): DimensionSpec[];
+/**
+ * Generate a Malloy WHERE clause filter string from filter selections
+ * Uses source.dimension format only for joined sources (not the query's main source)
+ */
+export declare function generateFilterClause(activeFilters: FilterSelection[], dimensionToSourceMap: Map<string, string>, querySourceName: string | null): string;
+/**
+ * Extract the source name from a Malloy query
+ * Handles patterns like:
+ * - "run: source_name -> ..."
+ * - "run: source_name->view_name"
+ * Returns null if no source name can be extracted
+ */
+export declare function extractSourceFromQuery(query: string): string | null;
+/**
+ * Injects a where clause into a Malloy query by appending "+ {where: ...}"
+ * Uses Malloy's refinement syntax which works with any query pattern.
+ */
+export declare function injectWhereClause(query: string, filterClause: string): string;

package/dist/components/index.d.ts

@@ -1,14 +1,15 @@
+export { AnalyzePackageButton } from './AnalyzePackageButton';
+export { useRouterClickHandler } from './click_helper';
+export * from './filter';
+export * from './Home';
+export * from './Loading';
 export * from './Model';
 export * from './Notebook';
-export * from './Workbook';
 export * from './Package';
 export * from './Project';
 export * from './QueryResult';
-export * from './Home';
-export * from './Loading';
-export { useRouterClickHandler } from './click_helper';
+export * from './RenderedResult';
 export { ServerProvider, useServer } from './ServerProvider';
 export type { ServerContextValue, ServerProviderProps } from './ServerProvider';
-export { AnalyzePackageButton } from './AnalyzePackageButton';
+export * from './Workbook';
 export type { WorkbookStorage } from './Workbook';
-export * from './RenderedResult';

package/dist/components/styles.d.ts

@@ -3,9 +3,9 @@ import { CardOwnProps, Theme, CardContentOwnProps, CardMediaOwnProps } from '@mu
 import { CommonProps } from '@mui/material/OverridableComponent';
 import { DetailedHTMLProps, HTMLAttributes } from 'react';
 import { MUIStyledCommonProps } from '@mui/system';
-export declare const StyledCard: StyledComponent< CardOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "sx" | "variant" | "square" | "elevation" | "raised"> & MUIStyledCommonProps<Theme>, {}, {}>;
+export declare const StyledCard: StyledComponent< CardOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "elevation" | "square" | "sx" | "variant" | "raised"> & MUIStyledCommonProps<Theme>, {}, {}>;
 export declare const StyledCardContent: StyledComponent< CardContentOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "sx"> & MUIStyledCommonProps<Theme>, {}, {}>;
-export declare const StyledCardMedia: StyledComponent< CardMediaOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "sx" | "image" | "src"> & MUIStyledCommonProps<Theme>, {}, {}>;
+export declare const StyledCardMedia: StyledComponent< CardMediaOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "image" | "children" | "sx" | "src"> & MUIStyledCommonProps<Theme>, {}, {}>;
 export declare const CleanNotebookContainer: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const CleanNotebookHeader: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const CleanNotebookSection: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
@@ -17,7 +17,7 @@ export declare const StyledExplorerPage: StyledComponent<MUIStyledCommonProps<Th
 export declare const StyledExplorerBanner: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const StyledExplorerContent: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const StyledExplorerPanel: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
-export declare const PackageCard: StyledComponent< CardOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "sx" | "variant" | "square" | "elevation" | "raised"> & MUIStyledCommonProps<Theme>, {}, {}>;
+export declare const PackageCard: StyledComponent< CardOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "elevation" | "square" | "sx" | "variant" | "raised"> & MUIStyledCommonProps<Theme>, {}, {}>;
 export declare const PackageCardContent: StyledComponent< CardContentOwnProps & CommonProps & Omit< DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "style" | "classes" | "children" | "sx"> & MUIStyledCommonProps<Theme>, {}, {}>;
 export declare const PackageSectionTitle: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
 export declare const PackageContainer: StyledComponent<MUIStyledCommonProps<Theme>, DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/dist/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useDimensionFilters, type DimensionFilterState, type FilterSelection, type MatchType, type UseDimensionFiltersParams, type UseDimensionFiltersResult, } from './useDimensionFilters';
+export { useDimensionFiltersFromSpec, type DimensionFiltersConfig, type UseDimensionFiltersFromSpecOptions, } from './useDimensionFiltersFromSpec';
+export { useDimensionFiltersQuery, type DimensionFiltersQueryResult, type UseDimensionFiltersQueryParams, } from './useDimensionFiltersQuery';
+export { useDimensionalFilterRangeData, type DimensionalFilterRangeDataResult, type DimensionSpec, type DimensionValue, type DimensionValues, type FilterType, type UseDimensionalFilterRangeDataParams, } from './useDimensionalFilterRangeData';