@meridianlabs/inspect-scout-viewer 0.4.38 → 0.4.39

package/lib/src/app/transcripts/columnSizing/useColumnSizing.d.ts

@@ -0,0 +1,34 @@
+import { ColumnSizingState, OnChangeFn } from '@tanstack/react-table';
+import { TranscriptInfo } from '../../../types/api-types';
+import { ColumnSizingStrategyKey } from '../../components/columnSizing';
+import { TranscriptColumn } from '../columns';
+interface UseColumnSizingOptions {
+    /** Column definitions */
+    columns: TranscriptColumn[];
+    /** Reference to the table element for DOM measurement */
+    tableRef: React.RefObject<HTMLTableElement | null>;
+    /** Current data for content measurement */
+    data: TranscriptInfo[];
+}
+interface UseColumnSizingResult {
+    /** Current column sizing state */
+    columnSizing: ColumnSizingState;
+    /** Handler for column sizing changes with min/max enforcement */
+    handleColumnSizingChange: OnChangeFn<ColumnSizingState>;
+    /** Current sizing strategy key */
+    sizingStrategy: ColumnSizingStrategyKey;
+    /** Set the sizing strategy */
+    setSizingStrategy: (strategy: ColumnSizingStrategyKey) => void;
+    /** Apply auto-sizing based on current strategy (preserves manually resized columns) */
+    applyAutoSizing: () => void;
+    /** Reset a single column to its auto-calculated size */
+    resetColumnSize: (columnId: string) => void;
+    /** Reset all column sizing and clear manual resize tracking */
+    clearColumnSizing: () => void;
+}
+/**
+ * Hook for managing column sizing with min/max constraints and auto-sizing.
+ * Manually resized columns are preserved during auto-sizing operations.
+ */
+export declare function useColumnSizing({ columns, tableRef, data, }: UseColumnSizingOptions): UseColumnSizingResult;
+export {};

package/lib/src/app/transcripts/columns.d.ts

@@ -0,0 +1,37 @@
+import { ColumnDef } from '@tanstack/react-table';
+import { FilterType } from '../../state/store';
+import { TranscriptInfo } from '../../types/api-types';
+import { AvailableColumn } from '../components/columnFilter';
+export declare const COLUMN_LABELS: Record<keyof TranscriptInfo, string>;
+export declare const COLUMN_HEADER_TITLES: Record<keyof TranscriptInfo, string>;
+export type TranscriptColumn = ColumnDef<TranscriptInfo> & {
+    meta?: {
+        align?: "left" | "center" | "right";
+        filterable?: boolean;
+        filterType?: FilterType;
+    };
+    /** Returns string for tooltip display */
+    titleValue?: (value: unknown) => string;
+    /** Returns string representation for column width measurement. Return null to skip content measurement. */
+    textValue?: (value: unknown) => string | null;
+    /** Minimum column width in pixels */
+    minSize?: number;
+    /** Maximum column width in pixels */
+    maxSize?: number;
+    /** Tooltip text for the column header */
+    headerTitle?: string;
+};
+export declare const ALL_COLUMNS: Record<keyof TranscriptInfo, TranscriptColumn>;
+export declare const DEFAULT_COLUMN_ORDER: Array<keyof TranscriptInfo>;
+export declare const DEFAULT_VISIBLE_COLUMNS: Array<keyof TranscriptInfo>;
+/**
+ * Get columns for the TranscriptsGrid.
+ * @param visibleColumnKeys - Optional list of column keys to display. If not provided, returns all columns in default order.
+ * @returns Array of column definitions in the order specified or default order.
+ */
+export declare function getTranscriptColumns(visibleColumnKeys?: Array<keyof TranscriptInfo>): TranscriptColumn[];
+/**
+ * Extract title value for tooltip from a cell.
+ */
+export declare function getCellTitleValue(cell: any, columnDef: TranscriptColumn): string;
+export declare const FILTER_COLUMNS: AvailableColumn[];

package/lib/src/app/transcripts/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Infinite Scroll Tuning
+ *
+ * Goal: user never hits bottom while waiting for next page.
+ *
+ * Formula: threshold >= scroll_speed × fetch_duration
+ *
+ * Assumptions:
+ *   row_height = 29px
+ *   fetch_duration = 300-1000ms (variable with fixed overhead)
+ *   max_scroll_speed = 1500px/s (typical fast scroller)
+ *
+ * Check at typical speed (1500px/s):
+ *   runway_time = 2000px / 1500px/s = 1333ms
+ *   worst_case_fetch = 1000ms
+ *   margin = 333ms ✓
+ *
+ * Check at extreme speed (5000px/s):
+ *   runway_time = 2000px / 5000px/s = 400ms
+ *   median_fetch = ~350ms
+ *   margin = 50ms (tight but ok) ✓
+ *
+ * Why large pageSize? Fetch duration is mostly fixed overhead, so larger
+ * pages = fewer fetches = fewer stall opportunities. 500 rows gives ~9.7s
+ * of scrolling per page at 1500px/s.
+ *
+ * Note: If threshold > pageSize_px, the next page is prefetched immediately
+ * after the current page loads. This is fine for maximum smoothness.
+ */
+export declare const TRANSCRIPTS_INFINITE_SCROLL_CONFIG: {
+    /** Number of rows to fetch per page (500 rows = 14,500px at 29px/row) */
+    readonly pageSize: 500;
+    /** Distance from bottom (in px) at which to trigger fetch (~69 rows) */
+    readonly threshold: 2000;
+};

package/lib/src/app/types.d.ts

@@ -0,0 +1,111 @@
+import { ChatMessage, Event, JsonValue, ModelUsage } from '@tsmono/inspect-common/types';
+import { EventType } from '@tsmono/inspect-components/transcript';
+import { ScannerInput, ScannerInputResponse, Transcript } from '../types/api-types';
+export interface ScanResultSummary {
+    identifier: string;
+    uuid?: string;
+    explanation?: string;
+    label?: string;
+    timestamp?: string;
+    inputType: ScannerInputResponse["input_type"];
+    eventReferences: ScanResultReference[];
+    messageReferences: ScanResultReference[];
+    validationResult: boolean | Record<string, boolean>;
+    validationTarget: JsonValue;
+    value: string | boolean | number | null | unknown[] | object;
+    valueType: ScanResultValueType;
+    scanError?: string;
+    scanErrorRefusal?: boolean;
+    transcriptSourceId: string;
+    transcriptTaskSet?: string;
+    transcriptTaskId?: string | number;
+    transcriptTaskRepeat?: number;
+    transcriptModel?: string;
+    transcriptMetadata: Record<string, JsonValue>;
+}
+export interface ScanResultData extends ScanResultSummary {
+    answer?: string;
+    inputIds: string[];
+    metadata: Record<string, JsonValue>;
+    scanError?: string;
+    scanErrorTraceback?: string;
+    scanErrorRefusal?: boolean;
+    scanEvents?: Event[];
+    scanId: string;
+    scanMetadata: Record<string, JsonValue>;
+    scanModelUsage: Record<string, ModelUsage>;
+    scanTags: string[];
+    scanTotalTokens: number;
+    scannerFile: string;
+    scannerKey: string;
+    scannerName: string;
+    scannerParams: Record<string, JsonValue>;
+    transcriptId: string;
+    transcriptSourceUri: string;
+    transcriptDate?: string;
+    transcriptAgent?: string;
+    transcriptAgentArgs?: Record<string, unknown>;
+    transcriptScore?: JsonValue;
+    transcriptSuccess?: boolean;
+    transcriptMessageCount?: number;
+    transcriptTotalTime?: number;
+    transcriptTotalTokens?: number;
+    transcriptError?: string;
+    transcriptLimit?: string;
+}
+export interface ScanResultReference {
+    type: "message" | "event";
+    id: string;
+    cite?: string;
+}
+export interface SortColumn {
+    column: string;
+    direction: "asc" | "desc";
+}
+export type ErrorScope = "scans" | "scanner" | "dataframe" | "dataframe_input" | "transcripts";
+export type ResultGroup = "source" | "label" | "id" | "epoch" | "model" | "none";
+export type ScanResultValueType = "boolean" | "number" | "string" | "array" | "object" | "null";
+export declare function isStringValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "string";
+    value: string;
+};
+export declare function isNumberValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "number";
+    value: number;
+};
+export declare function isBooleanValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "boolean";
+    value: boolean;
+};
+export declare function isNullValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "null";
+    value: null;
+};
+export declare function isArrayValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "array";
+    value: unknown[];
+};
+export declare function isObjectValue(result: ScanResultSummary): result is ScanResultSummary & {
+    valueType: "object";
+    value: Record<string, unknown>;
+};
+export declare function isTranscriptInput(input: ScannerInput): input is ScannerInput & {
+    input_type: "transcript";
+    input: Transcript;
+};
+export declare function isMessageInput(input: ScannerInput): input is ScannerInput & {
+    input_type: "message";
+    input: ChatMessage;
+};
+export declare function isMessagesInput(input: ScannerInput): input is ScannerInput & {
+    input_type: "messages";
+    input: ChatMessage[];
+};
+export declare function isEventInput(input: ScannerInput): input is ScannerInput & {
+    input_type: "event";
+    input: EventType;
+};
+export declare function isEventsInput(input: ScannerInput): input is ScannerInput & {
+    input_type: "events";
+    input: Event[];
+};

package/lib/src/app/utils/arrow.d.ts

@@ -0,0 +1,2 @@
+import { ColumnTable } from 'arquero';
+export declare function expandResultsetRows(columnTable: ColumnTable): Promise<ColumnTable>;

package/lib/src/app/utils/arrowHelpers.d.ts

@@ -0,0 +1,4 @@
+import { ColumnTable } from 'arquero';
+import { ScanResultData, ScanResultSummary } from '../types';
+export declare const parseScanResultData: (filtered: ColumnTable) => Promise<ScanResultData>;
+export declare const parseScanResultSummaries: (rowData: object[]) => Promise<ScanResultSummary[]>;

package/lib/src/app/utils/autosizeTextarea.d.ts

@@ -0,0 +1,5 @@
+export type AutosizeTextareaConfig = {
+    minRows: number;
+    maxRows: number;
+};
+export declare function autosizeTextarea(el: HTMLElement, config: AutosizeTextareaConfig): void;

package/lib/src/app/utils/refs.d.ts

@@ -0,0 +1,6 @@
+import { MarkdownReference } from '@tsmono/react/components';
+import { ScannerInput } from '../../types/api-types';
+import { ScanResultSummary } from '../types';
+export type MakeReferenceUrl = (ref: string, type: "message" | "event") => string | undefined;
+export declare const useMarkdownRefs: (summary?: ScanResultSummary, inputData?: ScannerInput) => MarkdownReference[];
+export declare const toMarkdownRefs: (summary: ScanResultSummary, makeReferenceUrl: MakeReferenceUrl, inputData?: ScannerInput) => MarkdownReference[];

package/lib/src/app/utils/results.d.ts

@@ -0,0 +1,17 @@
+import { ScanResultSummary, SortColumn } from '../types';
+export interface IdentifierInfo {
+    taskSet?: string;
+    id: string | number;
+    secondaryId?: string | number;
+    epoch?: number;
+}
+export declare const resultIdentifierStr: (summary?: ScanResultSummary) => string | undefined;
+export declare const resultIdentifier: (summary?: ScanResultSummary) => IdentifierInfo;
+export declare const resultLog: (summary: ScanResultSummary) => string | undefined;
+/**
+ * Stringify a ScanResultSummary value for text search.
+ * Handles all valueType variants so search covers the displayed result content.
+ */
+export declare const stringifyValue: (s: ScanResultSummary) => string;
+export declare const sortValue: (a: ScanResultSummary, b: ScanResultSummary) => number;
+export declare const sortByColumns: (a: ScanResultSummary, b: ScanResultSummary, sortColumns: SortColumn[]) => number;

package/lib/src/app/utils/router.d.ts

@@ -0,0 +1 @@
+export declare const useTranscriptDirParams: () => string | undefined;

package/lib/src/app/utils/scan.d.ts

@@ -0,0 +1,12 @@
+import { Status } from '../../types/api-types';
+/**
+ * Gets the display name for a scan.
+ *
+ * Uses the relative path from the scans directory when available,
+ * providing a more informative title that includes the directory structure.
+ *
+ * @param scan - The scan status object, or undefined if loading
+ * @param scansDir - The base scans directory for computing relative paths
+ * @returns The scan display name, or undefined if scan is undefined
+ */
+export declare function getScanDisplayName(scan: Status | undefined, scansDir: string | undefined): string | undefined;

package/lib/src/app/utils/transcript.d.ts

@@ -0,0 +1,29 @@
+import { Transcript } from '../../types/api-types';
+interface TaskNameParts {
+    taskSet?: string | null;
+    taskId?: string | number | null;
+    taskRepeat?: number | null;
+}
+/**
+ * Formats task name parts into a display string.
+ *
+ * Produces a string like "taskSet/taskId (taskRepeat)" with optional parts:
+ * - If only taskSet: "taskSet"
+ * - If only taskId: "taskId"
+ * - If both: "taskSet/taskId"
+ * - With repeat: "taskSet/taskId (1)"
+ *
+ * @param parts - Object containing taskSet, taskId, and taskRepeat
+ * @returns Formatted task name string, or undefined if no parts are available
+ */
+export declare function formatTaskName(parts: TaskNameParts): string | undefined;
+/**
+ * Gets the display name for a transcript.
+ *
+ * Uses taskSet/taskId/taskRepeat when available, falls back to task_id.
+ *
+ * @param transcript - The transcript object, or undefined if loading
+ * @returns The transcript display name, or undefined if transcript is undefined
+ */
+export declare function getTranscriptDisplayName(transcript: Transcript | undefined): string | undefined;
+export {};

package/lib/src/app/utils/useScansDir.d.ts

@@ -0,0 +1,8 @@
+interface UseScansDirResult {
+    displayScansDir: string;
+    resolvedScansDir: string;
+    resolvedScansDirSource: "route" | "user" | "project" | "cli";
+    setScansDir: (path: string) => void;
+}
+export declare function useScansDir(useRouteParam?: boolean): UseScansDirResult;
+export {};

package/lib/src/app/utils/useTranscriptsDir.d.ts

@@ -0,0 +1,8 @@
+interface UseTranscriptsDirResult {
+    displayTranscriptsDir: string;
+    resolvedTranscriptsDir: string;
+    resolvedTranscriptsDirSource: "route" | "user" | "project" | "cli";
+    setTranscriptsDir: (path: string) => void;
+}
+export declare function useTranscriptsDir(useRouteParam?: boolean): UseTranscriptsDirResult;
+export {};

package/lib/src/app/validation/ValidationPanel.d.ts

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

package/lib/src/app/validation/components/CopyMoveCasesModal.d.ts

@@ -0,0 +1,24 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+interface CopyMoveCasesModalProps {
+    /** Whether to show the modal */
+    show: boolean;
+    /** Copy or move mode */
+    mode: "copy" | "move";
+    /** Source validation set URI */
+    sourceUri: string;
+    /** Selected case IDs */
+    selectedIds: string[];
+    /** Full case data for selected cases */
+    selectedCases: ValidationCase[];
+    /** Callback when modal is closed */
+    onHide: () => void;
+    /** Callback on successful operation (used to clear selection) */
+    onSuccess: () => void;
+}
+/**
+ * Modal for copying or moving validation cases to another validation set.
+ * Supports selecting an existing set or creating a new one.
+ */
+export declare const CopyMoveCasesModal: FC<CopyMoveCasesModalProps>;
+export {};

package/lib/src/app/validation/components/ValidationBulkActions.d.ts

@@ -0,0 +1,16 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+interface ValidationBulkActionsProps {
+    cases: ValidationCase[];
+    selectedIds: string[];
+    onBulkSplitChange: (ids: string[], split: string | null) => void;
+    onBulkDelete: (ids: string[]) => void;
+    isUpdating?: boolean;
+    isDeleting?: boolean;
+}
+/**
+ * Bulk actions for selected validation cases.
+ * Includes split assignment and delete functionality.
+ */
+export declare const ValidationBulkActions: FC<ValidationBulkActionsProps>;
+export {};

package/lib/src/app/validation/components/ValidationCaseCard.d.ts

@@ -0,0 +1,23 @@
+import { CSSProperties, FC } from 'react';
+import { TranscriptInfo, ValidationCase } from '../../../types/api-types';
+interface ValidationCaseCardProps {
+    validationCase: ValidationCase;
+    transcript?: TranscriptInfo;
+    transcriptsDir: string | undefined;
+    validationSetUri?: string;
+    isSelected: boolean;
+    onSelectionChange: (selected: boolean) => void;
+    existingSplits: string[];
+    onSplitChange?: (split: string | null) => void;
+    onDelete?: () => void;
+    isUpdating?: boolean;
+    isDeleting?: boolean;
+    showLabels?: boolean;
+    showTarget?: boolean;
+    gridStyle?: CSSProperties;
+}
+/**
+ * Card component for displaying a single validation case.
+ */
+export declare const ValidationCaseCard: FC<ValidationCaseCardProps>;
+export {};

package/lib/src/app/validation/components/ValidationCaseEditor.d.ts

@@ -0,0 +1,25 @@
+import { default as React, FC } from 'react';
+interface ValidationCaseEditorProps {
+    transcriptId: string;
+    taskId?: string | null;
+    taskRepeat?: number | null;
+    className?: string | string[];
+}
+export declare const ValidationCaseEditor: FC<ValidationCaseEditorProps>;
+interface SidebarPanelProps {
+    children: React.ReactNode;
+}
+export declare const SidebarPanel: FC<SidebarPanelProps>;
+interface SidebarHeaderProps {
+    icon?: string;
+    title?: string;
+    secondary?: string;
+    actions?: React.ReactNode;
+    onClose?: () => void;
+}
+export declare const SidebarHeader: FC<SidebarHeaderProps>;
+export declare const SecondaryDisplayValue: FC<{
+    label: string;
+    value: string;
+}>;
+export {};

package/lib/src/app/validation/components/ValidationCaseLabelsEditor.d.ts

@@ -0,0 +1,20 @@
+import { FC } from 'react';
+interface ValidationCaseLabelsEditorProps {
+    /** Current labels for the validation case (null means no labels set) */
+    labels: {
+        [key: string]: boolean;
+    } | null;
+    /** Unique label keys from other cases for autocomplete suggestions */
+    availableLabels: string[];
+    /** Callback when labels change */
+    onChange: (labels: {
+        [key: string]: boolean;
+    } | null) => void;
+}
+/**
+ * Editor component for managing labels on a validation case.
+ * Displays existing labels as chips with remove buttons,
+ * and provides an "Add" chip to add new labels via popover.
+ */
+export declare const ValidationCaseLabelsEditor: FC<ValidationCaseLabelsEditorProps>;
+export {};

package/lib/src/app/validation/components/ValidationCasePredicateSelector.d.ts

@@ -0,0 +1,19 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+type Predicate = "gt" | "gte" | "lt" | "lte" | "eq" | "ne" | "contains" | "startswith" | "endswith" | "icontains" | "iequals";
+interface ValidationCasePredicateSelectorProps {
+    value: Predicate | null;
+    onChange: (predicate: Predicate) => void;
+    disabled?: boolean;
+    existingPredicates?: Predicate[];
+}
+/**
+ * Dropdown component for selecting a validation case predicate.
+ */
+export declare const ValidationCasePredicateSelector: FC<ValidationCasePredicateSelectorProps>;
+/**
+ * Extracts unique predicate values from a list of validation cases.
+ * Returns sorted array of non-empty split values.
+ */
+export declare const extractUniquePredicates: (cases: ValidationCase[]) => Predicate[];
+export {};

package/lib/src/app/validation/components/ValidationCaseTargetEditor.d.ts

@@ -0,0 +1,13 @@
+import { FC } from 'react';
+import { JsonValue } from '@tsmono/inspect-common/types';
+interface ValidationCaseTargetEditorProps {
+    target?: JsonValue;
+    onChange: (newTarget: string) => void;
+    /** Called when the mode changes (e.g., user selects "other" radio) */
+    onModeChange?: (isOtherMode: boolean) => void;
+}
+/**
+ * Editor component for modifying the target of a validation case.
+ */
+export declare const ValidationCaseTargetEditor: FC<ValidationCaseTargetEditorProps>;
+export {};

package/lib/src/app/validation/components/ValidationCasesList.d.ts

@@ -0,0 +1,19 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+interface ValidationCasesListProps {
+    cases: ValidationCase[];
+    transcriptsDir: string | undefined;
+    sourceUri: string | undefined;
+    onBulkSplitChange?: (ids: string[], split: string | null) => void;
+    onBulkDelete?: (ids: string[]) => void;
+    onSingleSplitChange?: (caseId: string, split: string | null) => void;
+    onSingleDelete?: (caseId: string) => void;
+    isUpdating?: boolean;
+    isDeleting?: boolean;
+}
+/**
+ * List component for displaying and managing validation cases.
+ * Includes filtering, selection, and individual case cards.
+ */
+export declare const ValidationCasesList: FC<ValidationCasesListProps>;
+export {};

package/lib/src/app/validation/components/ValidationFilterBar.d.ts

@@ -0,0 +1,14 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+interface ValidationFilterBarProps {
+    cases: ValidationCase[];
+    splitFilter: string | undefined;
+    onSplitFilterChange: (split: string | undefined) => void;
+    searchText: string | undefined;
+    onSearchTextChange: (text: string | undefined) => void;
+}
+/**
+ * Filter bar with split dropdown and ID search.
+ */
+export declare const ValidationFilterBar: FC<ValidationFilterBarProps>;
+export {};

package/lib/src/app/validation/components/ValidationSetSelector.d.ts

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+import { AppConfig } from '../../../types/api-types';
+interface ValidationSetSelectorProps {
+    validationSets: string[];
+    selectedUri: string | undefined;
+    onSelect: (uri: string | undefined) => void;
+    /** Size trigger to fit longest option (default: false) */
+    autoSize?: boolean;
+    /** Adds a create new option the dropown */
+    allowCreate?: boolean;
+    onCreate?: (name: string) => void;
+    /** Whether a create operation is currently in progress */
+    createPending?: boolean;
+    /** Project directory path for displaying full file path in create modal */
+    appConfig?: AppConfig;
+}
+/**
+ * Select-box component for selecting validation sets.
+ * Shows collapsed trigger with 2-line display (filename + path).
+ * Opens dropdown on click with keyboard navigation support.
+ */
+export declare const ValidationSetSelector: FC<ValidationSetSelectorProps>;
+export {};

package/lib/src/app/validation/components/ValidationSplitSelector.d.ts

@@ -0,0 +1,23 @@
+import { FC } from 'react';
+interface ValidationSplitSelectorProps {
+    /** Current split value (null means no split) */
+    value: string | null;
+    /** Available splits for the dropdown */
+    existingSplits: string[];
+    /** Callback when split changes */
+    onChange: (split: string | null) => void;
+    /** Disable the selector */
+    disabled?: boolean;
+    /** Additional className for the select element */
+    className?: string;
+    /** Label for "no split" option */
+    noSplitLabel?: string;
+    /** Label for "new split" option */
+    newSplitLabel?: string;
+}
+/**
+ * Reusable split selector component with built-in "New Split" modal.
+ * Style-agnostic: consumers control styling via className prop.
+ */
+export declare const ValidationSplitSelector: FC<ValidationSplitSelectorProps>;
+export {};

package/lib/src/app/validation/components/ValidationSummary.d.ts

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+import { ValidationCase } from '../../../types/api-types';
+interface ValidationSummaryProps {
+    cases: ValidationCase[];
+}
+/**
+ * Displays summary statistics for a validation set in a compact inline format:
+ * N cases | splits: [badge] [badge]
+ */
+export declare const ValidationSummary: FC<ValidationSummaryProps>;
+export {};

package/lib/src/app/validation/hooks/useTranscriptsByIds.d.ts

@@ -0,0 +1,13 @@
+import { TranscriptInfo } from '../../../types/api-types';
+/**
+ * Hook to fetch transcripts by their IDs using an IN query.
+ * Returns a map of transcript_id -> TranscriptInfo for quick lookups.
+ * Also returns sourceIds for staleness detection - consumers should only
+ * trust lookups when the requested ID was in the sourceIds set.
+ */
+export declare const useTranscriptsByIds: (transcriptsDir: string | undefined, ids: string[]) => {
+    data: Map<string, TranscriptInfo> | undefined;
+    sourceIds: Set<string> | undefined;
+    loading: boolean;
+    error: Error | null;
+};

package/lib/src/app/validation/utils.d.ts

@@ -0,0 +1,55 @@
+import { ValidationCase } from '../../types/api-types';
+/** Valid file extensions for validation set files */
+export declare const VALIDATION_SET_EXTENSIONS: string[];
+/**
+ * Check if a filename has a valid validation set extension.
+ */
+export declare const hasValidationSetExtension: (name: string) => boolean;
+/**
+ * Converts a validation case ID to a display string.
+ * Handles both single string IDs and composite (array) IDs.
+ */
+export declare const getIdText: (id: string | string[]) => string;
+/**
+ * Converts a validation case ID to a unique key for use in Maps/Sets.
+ * Uses "|" as separator for composite IDs.
+ */
+export declare const getCaseKey: (id: string | string[]) => string;
+/**
+ * Extracts unique label keys from a list of validation cases.
+ * Returns sorted array of label key names.
+ */
+export declare const extractUniqueLabels: (cases: ValidationCase[]) => string[];
+/**
+ * Extracts unique split values from a list of validation cases.
+ * Returns sorted array of non-empty split values.
+ */
+export declare const extractUniqueSplits: (cases: ValidationCase[]) => string[];
+/**
+ * Extracts the filename from a URI/path.
+ * @param uri - The full URI or path
+ * @param stripExtension - If true, removes common validation file extensions
+ */
+export declare const getFilenameFromUri: (uri: string, stripExtension?: boolean) => string;
+/**
+ * Extracts the directory portion of a URI (everything before the filename).
+ * @param uri - The full URI (e.g., "file:///path/to/file.csv")
+ * @returns The directory URI without trailing slash
+ */
+export declare const getDirFromUri: (uri: string) => string;
+/**
+ * Generates a new file URI in the same directory as the source with given name.
+ * @param sourceUri - The source file URI
+ * @param newName - The new filename (without extension)
+ * @returns New file URI with .csv extension
+ */
+export declare const generateNewSetUri: (sourceUri: string, newName: string) => string;
+/**
+ * Validates a filename for invalid characters.
+ * @param name - The filename to validate (without extension)
+ * @returns Object with isValid and optional error message
+ */
+export declare const isValidFilename: (name: string) => {
+    isValid: boolean;
+    error?: string;
+};