@meridianlabs/inspect-scout-viewer 0.4.6 → 0.4.7

package/lib/App.d.ts

@@ -2,4 +2,5 @@ import { FC } from 'react';
 export interface AppProps {
     mode?: "scans" | "workbench";
 }
+export declare const AppModeContext: import('react').Context<"scans" | "workbench" | undefined>;
 export declare const App: FC<AppProps>;

package/lib/AppRouter.d.ts

@@ -1,4 +1,6 @@
+import { AppConfig } from './types/api-types';
 export interface AppRouterConfig {
     mode: "scans" | "workbench";
+    config: AppConfig;
 }
 export declare const createAppRouter: (config: AppRouterConfig) => import('react-router-dom').DataRouter;

package/lib/api/api.d.ts

@@ -1,16 +1,28 @@
 import { StateStorage } from 'zustand/middleware';
 import { ScanResultInputData } from '../app/types';
 import { Condition, OrderByModel } from '../query';
-import { AppConfig, Pagination, ScansResponse, Status, Transcript, TranscriptsResponse } from '../types/api-types';
+import { ActiveScansResponse, AppConfig, Pagination, ProjectConfig, ProjectConfigInput, ScansResponse, Status, Transcript, TranscriptsResponse } from '../types/api-types';
 export type ClientStorage = StateStorage;
+export type ScalarValue = string | number | boolean | null;
 export interface ScanApi {
     getConfig(): Promise<AppConfig>;
     getTranscripts(transcriptsDir: string, filter?: Condition, orderBy?: OrderByModel | OrderByModel[], pagination?: Pagination): Promise<TranscriptsResponse>;
     getTranscript(transcriptsDir: string, id: string): Promise<Transcript>;
+    getTranscriptsColumnValues(transcriptsDir: string, column: string, filter: Condition | undefined): Promise<ScalarValue[]>;
     getScans(filter?: Condition, orderBy?: OrderByModel | OrderByModel[], pagination?: Pagination): Promise<ScansResponse>;
     getScan(scanLocation: string): Promise<Status>;
     getScannerDataframe(scanLocation: string, scanner: string): Promise<ArrayBuffer | Uint8Array>;
     getScannerDataframeInput(scanLocation: string, scanner: string, uuid: string): Promise<ScanResultInputData>;
+    getActiveScans(): Promise<ActiveScansResponse>;
+    postCode(condition: Condition): Promise<Record<string, string>>;
+    getProjectConfig(): Promise<{
+        config: ProjectConfig;
+        etag: string;
+    }>;
+    updateProjectConfig(config: ProjectConfigInput, etag: string | null): Promise<{
+        config: ProjectConfig;
+        etag: string;
+    }>;
     storage: ClientStorage;
     capability: "scans" | "workbench";
 }

package/lib/app/components/ActivityBarLayout.d.ts

@@ -1,5 +1,7 @@
 import { FC, ReactNode } from 'react';
+import { AppConfig } from '../../types/api-types';
 interface ActivityBarLayoutProps {
+    config: AppConfig;
     children: ReactNode;
 }
 /**

package/lib/app/components/Chip.d.ts

@@ -0,0 +1,12 @@
+interface ChipProps {
+    icon?: string;
+    label?: string;
+    value: string;
+    title?: string;
+    closeTitle?: string;
+    onClick?: () => void;
+    onClose?: (event?: React.MouseEvent | React.KeyboardEvent) => void;
+    className?: string | string[];
+}
+export declare const Chip: import('react').ForwardRefExoticComponent<ChipProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};

package/lib/app/components/ChipGroup.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+interface ChipGroupProps {
+    className?: string | string[];
+    children: React.ReactNode;
+}
+export declare const ChipGroup: FC<ChipGroupProps>;
+export {};

package/lib/app/components/NextPreviousNav.d.ts

@@ -0,0 +1,11 @@
+import { FC, ReactNode } from 'react';
+interface NextPreviousNavProps {
+    onPrevious?: () => void;
+    onNext?: () => void;
+    hasPrevious: boolean;
+    hasNext: boolean;
+    children?: ReactNode;
+    enableKeyboardNav?: boolean;
+}
+export declare const NextPreviousNav: FC<NextPreviousNavProps>;
+export {};

package/lib/app/components/ProjectBar.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { AppConfig } from '../../types/api-types';
+interface ProjectBarProps {
+    config: AppConfig;
+}
+export declare const ProjectBar: FC<ProjectBarProps>;
+export {};

package/lib/app/components/ScansNavbar.d.ts

@@ -1,6 +1,6 @@
 import { FC, ReactNode } from 'react';
 interface ScansNavbarProps {
-    scansDir?: string;
+    scansDir: string | null;
     setScansDir: (path: string) => void;
     children?: ReactNode;
     bordered?: boolean;

package/lib/app/components/ValidationResult.d.ts

@@ -1,6 +1,9 @@
 import { FC } from 'react';
+import { JsonValue } from '../../types/json-value';
 interface ValidationResultProps {
     result: boolean | Record<string, boolean>;
+    target?: JsonValue;
+    label?: string;
 }
 export declare const ValidationResult: FC<ValidationResultProps>;
 export {};

package/lib/app/hooks/useFilterConditions.d.ts

@@ -0,0 +1,6 @@
+import { Condition } from '../../query';
+/**
+ * Build a combined filter condition from column filters.
+ * @param excludeColumnId - Optional column ID to exclude from the condition
+ */
+export declare const useFilterConditions: (excludeColumnId?: string) => Condition | undefined;

package/lib/app/project/ProjectPanel.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { AppConfig } from '../../types/api-types';
+interface ProjectPanelProps {
+    config: AppConfig;
+}
+export declare const ProjectPanel: FC<ProjectPanelProps>;
+export {};

package/lib/app/project/SettingsContent.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { ProjectConfigInput } from '../../types/api-types';
+export interface SettingsContentProps {
+    config: Partial<ProjectConfigInput>;
+    onChange: (updates: Partial<ProjectConfigInput>) => void;
+}
+export declare const SettingsContent: FC<SettingsContentProps>;

package/lib/app/project/components/FormFields.d.ts

@@ -0,0 +1,67 @@
+import { FC, ReactNode } from 'react';
+interface TextFieldProps {
+    id?: string;
+    label: string;
+    helper?: ReactNode;
+    value: string | null | undefined;
+    onChange: (value: string | null) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** Optional validation function. Returns error message if invalid, null if valid. */
+    validate?: (value: string | null) => string | null;
+}
+export declare const TextField: FC<TextFieldProps>;
+interface TextAreaFieldProps {
+    id?: string;
+    label: string;
+    helper?: ReactNode;
+    value: string | null | undefined;
+    onChange: (value: string | null) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    rows?: number;
+}
+export declare const TextAreaField: FC<TextAreaFieldProps>;
+/**
+ * Convert an object or string to key=value lines for display.
+ */
+export declare function objectToKeyValueLines(value: Record<string, unknown> | string | null | undefined): string;
+/**
+ * Parse key=value lines into an object, or return as string if it looks like a path.
+ * Numeric values are preserved as numbers.
+ */
+export declare function parseKeyValueLines(text: string | null): Record<string, string | number> | string | null;
+interface KeyValueFieldProps {
+    id?: string;
+    label: string;
+    helper?: ReactNode;
+    value: Record<string, unknown> | string | null | undefined;
+    onChange: (value: Record<string, string | number> | string | null) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    rows?: number;
+}
+export declare const KeyValueField: FC<KeyValueFieldProps>;
+interface NumberFieldProps {
+    id?: string;
+    label: string;
+    helper?: ReactNode;
+    value: number | null | undefined;
+    onChange: (value: number | null) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    step?: number;
+}
+export declare const NumberField: FC<NumberFieldProps>;
+interface SelectFieldProps<T extends string> {
+    id?: string;
+    label: string;
+    helper?: ReactNode;
+    value: T | null | undefined;
+    options: readonly T[];
+    onChange: (value: T | null) => void;
+    disabled?: boolean;
+    defaultLabel?: string;
+}
+export declare function SelectField<T extends string>({ id, label, helper, value, options, onChange, disabled, defaultLabel, }: SelectFieldProps<T>): ReactNode;
+export {};

package/lib/app/project/configUtils.d.ts

@@ -0,0 +1,30 @@
+import { ProjectConfigInput } from '../../types/api-types';
+/**
+ * Deep equality check for config objects using JSON serialization.
+ */
+export declare function configsEqual(a: Partial<ProjectConfigInput> | null, b: Partial<ProjectConfigInput> | null): boolean;
+/**
+ * Check if a value is "empty" (null, undefined, or empty object/array).
+ */
+export declare function isEmpty(value: unknown): boolean;
+/**
+ * Filter out null and undefined values from an object.
+ */
+export declare function filterNullValues<T extends Record<string, unknown>>(obj: T): Partial<T>;
+/**
+ * Deep copy an object using JSON serialization.
+ * Note: Only works for JSON-serializable types (objects, arrays, primitives).
+ * Loses functions, Symbols, undefined values. Circular references will throw.
+ */
+export declare function deepCopy<T>(obj: T): T;
+/**
+ * Compute the config to save by comparing edited values against original server state.
+ * Only includes values that have changed or have content.
+ */
+export declare function computeConfigToSave(edited: Partial<ProjectConfigInput>, original: Partial<ProjectConfigInput>, serverConfig: ProjectConfigInput): ProjectConfigInput;
+/**
+ * Initialize edited config from server config.
+ * Extracts the relevant fields for editing.
+ * All fields are normalized to null (not undefined) for consistent comparison.
+ */
+export declare function initializeEditedConfig(serverConfig: ProjectConfigInput): Partial<ProjectConfigInput>;

package/lib/app/project/hooks/useNestedConfig.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook for managing nested config sections like cache and batch.
+ *
+ * These configs can be:
+ * - null/undefined (disabled)
+ * - true (enabled with defaults)
+ * - number (for batch: simple size value)
+ * - object (enabled with specific settings)
+ *
+ * @param configValue The current config value (from parent generate_config)
+ * @param updateParent Function to update the parent config with new nested value
+ */
+export declare function useNestedConfig<T extends Record<string, unknown>>(configValue: T | boolean | number | null | undefined, updateParent: (value: T | boolean | null) => void): {
+    enabled: boolean;
+    config: Partial<T>;
+    setEnabled: (newEnabled: boolean) => void;
+    updateConfig: (updates: Partial<T>) => void;
+};
+/**
+ * Hook specifically for batch config which can also be a simple number (size).
+ */
+export declare function useBatchConfig<T extends Record<string, unknown>>(configValue: T | boolean | number | null | undefined, updateParent: (value: T | boolean | null) => void): {
+    updateConfig: (updates: Partial<T>) => void;
+    currentBatchSize: number | undefined;
+    enabled: boolean;
+    config: Partial<T>;
+    setEnabled: (newEnabled: boolean) => void;
+};

package/lib/app/runScan/ActiveScanView.d.ts

@@ -0,0 +1,6 @@
+import { FC } from 'react';
+interface Props {
+    scanId: string | undefined;
+}
+export declare const ActiveScanView: FC<Props>;
+export {};

package/lib/app/runScan/DefineScannerSection.d.ts

@@ -0,0 +1,6 @@
+import { FC } from 'react';
+interface Props {
+    onScanStarted: (scanId: string) => void;
+}
+export declare const DefineScannerSection: FC<Props>;
+export {};

package/lib/app/runScan/RunScanPanel.d.ts

@@ -0,0 +1,2 @@
+import { FC } from 'react';
+export declare const RunScanPanel: FC;

package/lib/app/scannerResult/result/ResultBody.d.ts

@@ -1,7 +1,7 @@
 import { FC } from 'react';
 import { ScanResultInputData, ScanResultData } from '../../types';
 export interface ResultBodyProps {
-    resultData?: ScanResultData;
-    inputData?: ScanResultInputData;
+    resultData: ScanResultData;
+    inputData: ScanResultInputData;
 }
 export declare const ResultBody: FC<ResultBodyProps>;

package/lib/app/scannerResult/result/ResultPanel.d.ts

@@ -1,7 +1,8 @@
 import { FC } from 'react';
-import { ScanResultData } from '../../types';
+import { ScanResultData, ScanResultInputData } from '../../types';
 interface ResultPanelProps {
-    resultData?: ScanResultData;
+    resultData: ScanResultData;
+    inputData: ScanResultInputData | undefined;
 }
 export declare const ResultPanel: FC<ResultPanelProps>;
 export {};

package/lib/app/scans/ScansGrid.d.ts

@@ -1,6 +1,6 @@
 import { FC } from 'react';
-import { Status } from '../../types/api-types';
+import { ScanStatusWithActiveInfo } from '../../types/api-types';
 export declare const ScansGrid: FC<{
-    scans: Status[];
+    scans: ScanStatusWithActiveInfo[];
     resultsDir: string | undefined;
 }>;

package/lib/app/server/useActiveScan.d.ts

@@ -0,0 +1,3 @@
+import { ActiveScanInfo } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+export declare const useActiveScan: (scanId: string | undefined) => AsyncData<ActiveScanInfo | undefined>;

package/lib/app/server/useActiveScans.d.ts

@@ -0,0 +1,3 @@
+import { ActiveScanInfo } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+export declare const useActiveScans: () => AsyncData<Record<string, ActiveScanInfo>>;

package/lib/app/server/useAdjacentTranscriptIds.d.ts

@@ -0,0 +1,10 @@
+import { SortingState } from '@tanstack/react-table';
+import { Condition } from '../../query';
+import { AsyncData } from '../../utils/asyncData';
+/**
+ * Returns prev/next transcript IDs relative to the given ID.
+ *
+ * Note: prev is undefined when viewing the first loaded item.
+ * Reverse paging not yet supported - will need backend prev_cursor.
+ */
+export declare const useAdjacentTranscriptIds: (id: string, location?: string | null, pageSize?: number, filter?: Condition, sorting?: SortingState) => AsyncData<[string | undefined, string | undefined]>;

package/lib/app/server/useCode.d.ts

@@ -0,0 +1,4 @@
+import { skipToken } from '@tanstack/react-query';
+import { Condition } from '../../query/types';
+import { AsyncData } from '../../utils/asyncData';
+export declare const useCode: (condition: Condition | typeof skipToken) => AsyncData<Record<string, string>>;

package/lib/app/server/useConfig.d.ts

@@ -16,3 +16,4 @@ export declare const useConfigAsync: () => AsyncData<AppConfig>;
  * Throws if data not yet available.
  */
 export declare const useConfig: () => AppConfig;
+export declare function appAliasedPath(appConfig: AppConfig, path: string | null): string | null;

package/lib/app/server/useProjectConfig.d.ts

@@ -0,0 +1,30 @@
+import { DefaultError, UseMutationResult } from '@tanstack/react-query';
+import { ProjectConfig, ProjectConfigInput } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+export type ProjectConfigWithEtag = {
+    config: ProjectConfig;
+    etag: string;
+};
+/**
+ * Loads project configuration from scout.yaml.
+ *
+ * Returns both the config and an etag for optimistic concurrency control.
+ *
+ * Automatic refetching is disabled to support optimistic locking:
+ * - External changes are detected via etag mismatch on save (412 error)
+ * - User explicitly chooses to reload or force save on conflict
+ */
+export declare const useProjectConfig: () => AsyncData<ProjectConfigWithEtag>;
+/**
+ * Mutation hook for updating project configuration.
+ *
+ * Updates scout.yaml while preserving comments and formatting.
+ * Requires the current etag for optimistic concurrency control.
+ *
+ * On success, updates the query cache with the new config and etag.
+ * On 412 Precondition Failed, the config was modified externally.
+ */
+export declare const useUpdateProjectConfig: () => UseMutationResult<ProjectConfigWithEtag, DefaultError, {
+    config: ProjectConfigInput;
+    etag: string | null;
+}>;

package/lib/app/server/useScan.d.ts

@@ -0,0 +1,4 @@
+import { skipToken } from '@tanstack/react-query';
+import { Status } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+export declare const useScan: (location: string | typeof skipToken) => AsyncData<Status>;

package/lib/app/server/useScanDataframe.d.ts

@@ -0,0 +1,9 @@
+import { skipToken } from '@tanstack/react-query';
+import { ColumnTable } from 'arquero';
+import { AsyncData } from '../../utils/asyncData';
+type ScanDataframeParams = {
+    location: string;
+    scanner: string;
+};
+export declare const useScanDataframe: (params: ScanDataframeParams | typeof skipToken) => AsyncData<ColumnTable>;
+export {};

package/lib/app/server/useScanDataframeInput.d.ts

@@ -0,0 +1,10 @@
+import { skipToken } from '@tanstack/react-query';
+import { AsyncData } from '../../utils/asyncData';
+import { ScanResultInputData } from '../types';
+type ScanDataframeInputParams = {
+    location: string;
+    scanner: string;
+    uuid: string;
+};
+export declare const useScanDataframeInput: (params: ScanDataframeInputParams | typeof skipToken) => AsyncData<ScanResultInputData>;
+export {};

package/lib/app/server/useScans.d.ts

@@ -0,0 +1,3 @@
+import { ScanStatusWithActiveInfo } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+export declare const useScans: () => AsyncData<ScanStatusWithActiveInfo[]>;

package/lib/app/server/{useServerScansInfinite.d.ts → useScansInfinite.d.ts}

@@ -3,4 +3,4 @@ import { SortingState } from '@tanstack/react-table';
 import { Condition } from '../../query';
 import { ScansResponse } from '../../types/api-types';
 import { CursorType } from '.';
-export declare const useServerScansInfinite: (pageSize?: number, filter?: Condition, sorting?: SortingState) => UseInfiniteQueryResult<InfiniteData<ScansResponse, CursorType | undefined>, Error>;
+export declare const useScansInfinite: (pageSize?: number, filter?: Condition, sorting?: SortingState) => UseInfiniteQueryResult<InfiniteData<ScansResponse, CursorType | undefined>, Error>;

package/lib/app/server/useServerTranscriptsInfinite.d.ts

@@ -1,6 +1,13 @@
-import { UseInfiniteQueryResult, InfiniteData } from '@tanstack/react-query';
+import { UseInfiniteQueryResult, InfiniteData, skipToken } from '@tanstack/react-query';
 import { SortingState } from '@tanstack/react-table';
 import { Condition } from '../../query';
 import { TranscriptsResponse } from '../../types/api-types';
 import { CursorType } from '.';
-export declare const useServerTranscriptsInfinite: (location?: string | null, pageSize?: number, filter?: Condition, sorting?: SortingState) => UseInfiniteQueryResult<InfiniteData<TranscriptsResponse, CursorType | undefined>, Error>;
+type ServerTranscriptsInfiniteParams = {
+    location: string;
+    pageSize?: number;
+    filter?: Condition;
+    sorting?: SortingState;
+};
+export declare const useServerTranscriptsInfinite: (params: ServerTranscriptsInfiniteParams | typeof skipToken) => UseInfiniteQueryResult<InfiniteData<TranscriptsResponse, CursorType | undefined>, Error>;
+export {};

package/lib/app/server/useStartScan.d.ts

@@ -0,0 +1,3 @@
+import { DefaultError, UseMutationResult } from '@tanstack/react-query';
+import { ScanJobConfig, Status } from '../../types/api-types';
+export declare const useStartScan: () => UseMutationResult<Status, DefaultError, ScanJobConfig>;

package/lib/app/server/useTranscript.d.ts

@@ -0,0 +1,9 @@
+import { skipToken } from '@tanstack/react-query';
+import { Transcript } from '../../types/api-types';
+import { AsyncData } from '../../utils/asyncData';
+type TranscriptParams = {
+    location: string;
+    id: string;
+};
+export declare const useTranscript: (params: TranscriptParams | typeof skipToken) => AsyncData<Transcript>;
+export {};

package/lib/app/server/useTranscriptsColumnValues.d.ts

@@ -0,0 +1,11 @@
+import { skipToken } from '@tanstack/react-query';
+import { ScalarValue } from '../../api/api';
+import { Condition } from '../../query';
+import { AsyncData } from '../../utils/asyncData';
+type TranscriptsColumnValuesParams = {
+    location: string;
+    column: string;
+    filter: Condition | undefined;
+};
+export declare const useTranscriptsColumnValues: (params: TranscriptsColumnValuesParams | typeof skipToken) => AsyncData<ScalarValue[]>;
+export {};

package/lib/app/transcript/TranscriptBody.d.ts

@@ -1,7 +1,8 @@
-import { FC } from 'react';
+import { FC, RefObject } from 'react';
 import { Transcript } from '../../types/api-types';
 interface TranscriptBodyProps {
     transcript: Transcript;
+    scrollRef: RefObject<HTMLDivElement | null>;
 }
 export declare const TranscriptBody: FC<TranscriptBodyProps>;
 export {};

package/lib/app/transcript/TranscriptNav.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { Transcript } from '../../types/api-types';
+interface TranscriptNavProps {
+    transcriptsDir: string;
+    transcript?: Transcript;
+    prevId?: string;
+    nextId?: string;
+}
+export declare const TranscriptNav: FC<TranscriptNavProps>;
+export {};

package/lib/app/transcripts/TranscriptColumnsButton.d.ts

@@ -0,0 +1,6 @@
+interface TranscriptColumnsButtonProps {
+    isOpen: boolean;
+    onClick: () => void;
+}
+export declare const TranscriptColumnsButton: import('react').ForwardRefExoticComponent<TranscriptColumnsButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+export {};

package/lib/app/transcripts/TranscriptColumnsPopover.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+export interface TranscriptColumnsPopoverProps {
+    positionEl: HTMLElement | null;
+    isOpen: boolean;
+    setIsOpen: (open: boolean) => void;
+}
+export declare const TranscriptColumnsPopover: FC<TranscriptColumnsPopoverProps>;

package/lib/app/transcripts/TranscriptFilterBar.d.ts

@@ -0,0 +1,7 @@
+import { FC } from 'react';
+import { ScalarValue } from '../../api/api';
+export declare const TranscriptFilterBar: FC<{
+    filterCodeValues?: Record<string, string>;
+    filterSuggestions?: ScalarValue[];
+    onFilterColumnChange?: (columnId: string | null) => void;
+}>;

package/lib/app/transcripts/TranscriptsGrid.d.ts

@@ -1,4 +1,5 @@
 import { FC } from 'react';
+import { ScalarValue } from '../../api/api';
 import { TranscriptInfo } from '../../types/api-types';
 interface TranscriptGridProps {
     transcripts: TranscriptInfo[];
@@ -11,6 +12,10 @@ interface TranscriptGridProps {
     /** Distance from bottom (in px) at which to trigger callback. */
     fetchThreshold: number;
     loading?: boolean;
+    /** Autocomplete suggestions for the currently editing filter column */
+    filterSuggestions?: ScalarValue[];
+    /** Called when a filter column starts/stops being edited */
+    onFilterColumnChange?: (columnId: string | null) => void;
 }
 export declare const TranscriptsGrid: FC<TranscriptGridProps>;
 export {};

package/lib/app/transcripts/columnFilter/ColumnFilterButton.d.ts

@@ -0,0 +1,6 @@
+export interface ColumnFilterButtonProps {
+    columnId: string;
+    isActive: boolean;
+    onClick: (event: React.MouseEvent<HTMLButtonElement>) => void;
+}
+export declare const ColumnFilterButton: import('react').ForwardRefExoticComponent<ColumnFilterButtonProps & import('react').RefAttributes<HTMLButtonElement>>;

package/lib/app/transcripts/columnFilter/ColumnFilterControl.d.ts

@@ -0,0 +1,16 @@
+import { FC } from 'react';
+import { ScalarValue } from '../../../api/api';
+import { SimpleCondition } from '../../../query/types';
+import { FilterType } from '../../../state/store';
+interface ColumnFilterControlProps {
+    columnId: string;
+    filterType: FilterType;
+    condition: SimpleCondition | null;
+    onChange: (condition: SimpleCondition | null) => void;
+    /** Autocomplete suggestions for the filter value */
+    suggestions?: ScalarValue[];
+    /** Called when the popover opens/closes (for fetching suggestions) */
+    onOpenChange?: (columnId: string | null) => void;
+}
+export declare const ColumnFilterControl: FC<ColumnFilterControlProps>;
+export {};

package/lib/app/transcripts/columnFilter/ColumnFilterEditor.d.ts

@@ -0,0 +1,18 @@
+import { FC } from 'react';
+import { ScalarValue } from '../../../api/api';
+import { OperatorModel } from '../../../query';
+import { FilterType } from '../../../state/store';
+export interface ColumnFilterEditorProps {
+    columnId: string;
+    filterType: FilterType;
+    operator: OperatorModel;
+    operatorOptions: OperatorModel[];
+    rawValue: string;
+    isValueDisabled: boolean;
+    onOperatorChange: (operator: OperatorModel) => void;
+    onValueChange: (value: string) => void;
+    onCommit?: () => void;
+    onCancel?: () => void;
+    suggestions?: ScalarValue[];
+}
+export declare const ColumnFilterEditor: FC<ColumnFilterEditorProps>;

package/lib/app/transcripts/columnFilter/index.d.ts

@@ -0,0 +1,7 @@
+export { ColumnFilterControl } from './ColumnFilterControl';
+export { ColumnFilterButton } from './ColumnFilterButton';
+export { ColumnFilterEditor } from './ColumnFilterEditor';
+export { useColumnFilter } from './useColumnFilter';
+export type { UseColumnFilterParams, UseColumnFilterReturn, } from './useColumnFilter';
+export type { ColumnFilterEditorProps } from './ColumnFilterEditor';
+export type { ColumnFilterButtonProps } from './ColumnFilterButton';

package/lib/app/transcripts/columnFilter/useColumnFilter.d.ts

@@ -0,0 +1,19 @@
+import { OperatorModel } from '../../../query';
+import { SimpleCondition } from '../../../query/types';
+import { FilterType } from '../../../state/store';
+export interface UseColumnFilterParams {
+    columnId: string;
+    filterType: FilterType;
+    condition: SimpleCondition | null;
+    isOpen: boolean;
+}
+export interface UseColumnFilterReturn {
+    operator: OperatorModel;
+    setOperator: (operator: OperatorModel) => void;
+    operatorOptions: OperatorModel[];
+    value: string;
+    setValue: (value: string) => void;
+    usesValue: boolean;
+    buildCondition: (operator: OperatorModel, value: string) => SimpleCondition | null | undefined;
+}
+export declare function useColumnFilter({ columnId, filterType, condition, isOpen, }: UseColumnFilterParams): UseColumnFilterReturn;