@meridianlabs/inspect-scout-viewer 0.4.21 → 0.4.38

package/lib/src/types/json-value.d.ts

@@ -1,12 +0,0 @@
-/**
- * JSON value type - any valid JSON value.
- *
- * Uses interfaces for array/object to avoid TS2589 "excessively deep"
- * errors with immer's type inference on recursive type aliases.
- */
-export type JsonValue = null | boolean | number | string | JsonArray | JsonObject;
-export interface JsonArray extends Array<JsonValue> {
-}
-export interface JsonObject {
-    [key: string]: JsonValue;
-}

package/lib/src/utils/ansi.d.ts

@@ -1,12 +0,0 @@
-/**
- * Detects if text contains ANSI escape sequences.
- *
- * This function checks for various ANSI escape codes including:
- * - CSI (Control Sequence Introducer) sequences: ESC [ ... (colors, cursor movement, etc.)
- * - OSC (Operating System Command) sequences: ESC ] ... (terminal titles, hyperlinks)
- * - Simple escape sequences: ESC followed by a single character
- *
- * @param text - The text to check for ANSI escape sequences
- * @returns true if ANSI escape sequences are detected, false otherwise
- */
-export declare const isAnsiOutput: (text: string) => boolean;

package/lib/src/utils/array.d.ts

@@ -1 +0,0 @@
-export declare const printArray: (arr: unknown[], size?: number) => string;

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

@@ -1,3 +0,0 @@
-import { ColumnTable } from 'arquero';
-export declare const decodeArrowBase64: (base64: string) => ColumnTable;
-export declare const decodeArrowBytes: (bytes: ArrayBuffer | Uint8Array) => ColumnTable;

package/lib/src/utils/asyncData.d.ts

@@ -1,66 +0,0 @@
-import { Brand } from './brand';
-/**
- * AsyncData represents the possible states of some asynchronous operation like
- * a network request to an API. When the request is first made, it's `loading`, but
- * once we get a response, it will either represent the requested `data` or maybe
- * the operation failed due to an `error`.
- *
- * @typeParam T - the data that will be returned
- */
-export type AsyncData<T> = AsyncDataLoading | AsyncDataNotLoading<T>;
-export type AsyncDataLoading = Brand<{
-    data?: undefined;
-    loading: true;
-    error?: undefined;
-}, "_please_use_AsyncData.loading_rather_than_your_own_instance_of_this_type_">;
-/**
- * The different states the async data can be in when loading is finished.
- *
- * @typeParam T - the data type that can be returned when error is undefined
- */
-export type AsyncDataNotLoading<T> = {
-    data: T;
-    loading: false;
-    error?: undefined;
-} | {
-    data?: undefined;
-    loading: false;
-    error: Error;
-};
-type AsyncDataMap<Mapping> = {
-    [K in keyof Mapping]: AsyncData<Mapping[K]>;
-};
-/**
- * The `compose` function allows a set of `AsyncData` values to be combined into
- * a single `AsyncData`. The complex type of the function represents a transformation
- * from an argument like this...
- *
- * ```typescript
- *   { a: AsyncData<A>, b: AsyncData<B>, c: AsyncData<C> }
- *```
- * ...to a return value like this...
- *```
- *   AsyncData<{ a: A, b: B, c: C }>
- *```
- *
- * In practice, this can be used to create hooks that depend on multiple API
- * calls.
- *
- */
-export declare function compose<Mapping>(hooks: AsyncDataMap<Mapping>): AsyncData<Mapping>;
-/**
- * The `data` function wraps the provided data in an `AsyncData` object, indicating
- * that the data is not loading and there is no error.
- *
- * @template T - The type of the data
- * @param {T} data - The data to wrap
- * @returns {AsyncData<T>} - An `AsyncData` object with `loading` set to `false`
- * and `data` set to the provided data
- */
-export declare function data<T>(data: T): AsyncData<T>;
-/**
- * The `loading` constant is an instance of `AsyncDataLoading` that can be shared
- * to provide identity stability. It represents the state when the data is loading.
- */
-export declare const loading: AsyncDataLoading;
-export {};

package/lib/src/utils/asyncDataFromQuery.d.ts

@@ -1,13 +0,0 @@
-import { QueryKey, UseQueryOptions } from '@tanstack/react-query';
-import { AsyncData } from './asyncData';
-/**
- * Custom hook that retrieves data using `useQuery` from the `@tanstack/react-query`
- * library. It wraps the `QueryResult` from the hook in a simpler `AsyncData`.
- *
- * @param options - An object of type `UseQueryOptions`.
- * @returns An object of type `AsyncData`. If the query is pending, it returns a
- * loading state. If there's an error, it returns an object with the error and loading
- * state as false. If the query is successful, it returns the data and loading state
- * as false.
- */
-export declare function useAsyncDataFromQuery<TQueryFnData = unknown, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey>(options: UseQueryOptions<TQueryFnData, Error, TData, TQueryKey>): AsyncData<TData>;

package/lib/src/utils/base64.d.ts

@@ -1,4 +0,0 @@
-/**
- * Determines whether a string is a base64 encoded string
- */
-export declare const maybeBase64: (str: string, minLen?: number) => boolean;

package/lib/src/utils/base64url.d.ts

@@ -1,38 +0,0 @@
-/**
- * Encodes a UTF-8 string to base64url format (RFC 4648 Section 5).
- *
- * Base64url is a URL-safe variant of base64 that uses `-` instead of `+`,
- * `_` instead of `/`, and omits padding `=` characters. This makes encoded
- * values safe for use in URLs and filenames without percent-encoding.
- *
- * Used throughout the app to encode directory paths for URL path segments,
- * e.g., `/scans/{dir}` where `{dir}` is a base64url-encoded path like
- * `/Users/alice/scans` -> `L1VzZXJzL2FsaWNlL3NjYW5z`.
- *
- * @param value - The UTF-8 string to encode
- * @returns The base64url-encoded string (no padding)
- *
- * @example
- * encodeBase64Url("/tmp/scans")  // "L3RtcC9zY2Fucw"
- * encodeBase64Url("hello world") // "aGVsbG8gd29ybGQ"
- */
-export declare const encodeBase64Url: (value: string) => string;
-/**
- * Decodes a base64url-encoded string back to UTF-8 (RFC 4648 Section 5).
- *
- * Reverses the base64url encoding by converting URL-safe characters back
- * to standard base64 (`-` -> `+`, `_` -> `/`), restoring padding, and
- * decoding to the original UTF-8 string.
- *
- * Used to decode URL path segments back to filesystem paths, e.g.,
- * extracting the scans directory from `/scans/{dir}` route parameters.
- *
- * @param value - The base64url-encoded string (with or without padding)
- * @returns The decoded UTF-8 string
- * @throws {DOMException} If the input is not valid base64url
- *
- * @example
- * decodeBase64Url("L3RtcC9zY2Fucw")  // "/tmp/scans"
- * decodeBase64Url("aGVsbG8gd29ybGQ") // "hello world"
- */
-export declare const decodeBase64Url: (value: string) => string;

package/lib/src/utils/brand.d.ts

@@ -1,70 +0,0 @@
-/**
- * Branded types for nominal typing in TypeScript.
- *
- * Branded types create distinct types from the same base type,
- * preventing accidental misuse at compile time with zero runtime overhead.
- *
- * @example
- * ```ts
- * type UserId = Brand<number, "UserId">;
- * type PostId = Brand<number, "PostId">;
- *
- * const makeUserId = make<UserId>();
- * const makePostId = make<PostId>();
- *
- * const userId = makeUserId(42);
- * const postId = makePostId(42);
- * getUser(postId);  // ✗ compile error - PostId !== UserId
- * ```
- *
- * @module
- */
-declare const __brand: unique symbol;
-/**
- * Creates a branded type from a base type.
- *
- * The brand exists only at compile time—no runtime overhead.
- *
- * @typeParam Base - The underlying primitive or object type
- * @typeParam Branding - A unique type used to distinguish this brand (often the entity type itself)
- *
- * @example
- * ```ts
- * type UserId = Brand<number, User>;
- * type PostId = Brand<number, Post>;
- * // UserId and PostId are incompatible even though both are numbers
- * ```
- */
-export type Brand<Base, Branding> = Base & {
-    [__brand]: Branding;
-};
-/**
- * Extracts the base type from a branded type.
- *
- * @typeParam B - A branded type
- * @returns The underlying base type without the brand
- *
- * @example
- * ```ts
- * type UserId = Brand<number, User>;
- * type Base = BaseOf<UserId>;  // number
- * ```
- */
-type BaseOf<B extends Brand<unknown, unknown>> = Omit<B, typeof __brand>;
-/** A function that converts a base value into a branded value. */
-type Brander<B extends Brand<unknown, unknown>> = (value: BaseOf<B>) => B;
-/**
- * Creates a brander function for a given branded type.
- *
- * @typeParam B - The branded type to produce
- * @returns A function that casts base values to the branded type
- *
- * @example
- * ```ts
- * type UserId = Brand<number, "UserId">;
- * const makeUserId = make<UserId>();
- * const id = makeUserId(42);
- * ```
- */
-export declare function make<B extends Brand<unknown, unknown>>(): Brander<B>;
-export {};

package/lib/src/utils/chatMessage.d.ts

@@ -1,3 +0,0 @@
-import { ChatMessage } from '../types/api-types';
-export declare const lastAssistantMessage: (messages: ChatMessage[]) => ChatMessage | undefined;
-export declare const firstUserMessage: (messages: ChatMessage[]) => ChatMessage | undefined;

package/lib/src/utils/date.d.ts

@@ -1,34 +0,0 @@
-/**
- * Utilities for working with dates and native HTML5 date/datetime inputs.
- */
-/**
- * Formats a date value for use with native HTML5 date input (type="date").
- * Returns format: YYYY-MM-DD
- *
- * @param value - The date value (Date, ISO string, or timestamp)
- * @returns Formatted date string in YYYY-MM-DD format, or empty string if invalid
- */
-export declare function formatDateForInput(value: Date | string | number | null | undefined): string;
-/**
- * Formats a datetime value for use with native HTML5 datetime-local input (type="datetime-local").
- * Returns format: YYYY-MM-DDTHH:mm
- *
- * @param value - The datetime value (Date, ISO string, or timestamp)
- * @returns Formatted datetime string in YYYY-MM-DDTHH:mm format, or empty string if invalid
- */
-export declare function formatDateTimeForInput(value: Date | string | number | null | undefined): string;
-/**
- * Parses a date or datetime string from native HTML5 inputs and returns an ISO string.
- * Handles both date (YYYY-MM-DD) and datetime-local (YYYY-MM-DDTHH:mm) formats.
- *
- * @param value - The date/datetime string from the native input
- * @returns ISO 8601 datetime string, or undefined if invalid
- */
-export declare function parseDateFromInput(value: string): string | undefined;
-/**
- * Checks if a value is a valid date.
- *
- * @param value - The value to check
- * @returns true if the value is a valid date
- */
-export declare function isValidDate(value: Date | string | number | null | undefined): boolean;

package/lib/src/utils/dom.d.ts

@@ -1 +0,0 @@
-export declare const useResizeObserver: (callback: (entry: ResizeObserverEntry) => void) => import('react').RefObject<HTMLDivElement | null>;

package/lib/src/utils/format.d.ts

@@ -1,53 +0,0 @@
-/**
- * Converts an array or a single value to a comma-separated string.
- */
-export declare const arrayToString: (val: string | string[]) => string;
-/**
- * Formats dataset information into a string.
- */
-export declare const formatDataset: (samples: number, epochs: number, name: string | null) => string;
-/**
- * Formats a duration given in seconds into a human-readable string.
- */
-export declare const formatTime: (seconds: number) => string;
-/**
- * Formats a number to a string with specific decimal places for prettiness.
- */
-export declare function formatPrettyDecimal(num: number, maxDecimals?: number): string;
-/**
- * Formats a number to a string without trailing zeroes after the decimal point.
- */
-export declare function formatDecimalNoTrailingZeroes(num: number): string;
-/**
- * Converts a string to title case.
- */
-export declare function toTitleCase(str: string): string;
-/**
- * Formats a number to a string with no decimals
- */
-export declare function formatNoDecimal(num: number): string;
-/**
- * Formats a number to a string
- */
-export declare function formatNumber(num: number): string;
-/**
- * Formats a number to a string without trailing zeroes after the decimal point.
- */
-export declare function formatDateTime(date: Date): string;
-/**
- * Returns the formatted duration between two dates.
- */
-export declare function formatDuration(start: Date, end: Date): string;
-/**
- * Compact duration format: "45s", "4m", "2h 5m".
- * Drops zero-valued trailing units and uses single-char suffixes.
- */
-export declare function formatDurationShort(start: Date, end: Date): string;
-/**
- * Truncates a string from the center, showing start and end with ellipsis in the middle.
- * @param str - The string to truncate
- * @param maxLength - Maximum length of the output string (default: 50)
- * @returns The truncated string with ellipsis in the middle if needed
- */
-export declare function centerTruncate(str: string, maxLength?: number): string;
-export declare function formatPercent(value: number, maxDecimals?: number): string;

package/lib/src/utils/html.d.ts

@@ -1,5 +0,0 @@
-/**
- * Escapes special characters in a string to make it safe for use in a CSS selector.
- */
-export declare function escapeSelector(id: string): string;
-export declare const decodeHtmlEntities: (text: string) => string;

package/lib/src/utils/json-worker.d.ts

@@ -1,2 +0,0 @@
-export declare const asyncJsonParse: <T>(text: string) => Promise<T>;
-export declare const jsonParse: <T>(text: string) => Promise<T>;

package/lib/src/utils/json.d.ts

@@ -1,4 +0,0 @@
-export declare const isJson: (text: string) => boolean;
-export declare const asJsonObjArray: (text: string) => object[] | undefined;
-export declare const parsedJson: (text: string) => unknown;
-export declare function estimateSize(list: unknown[], frequency?: number): number;

package/lib/src/utils/logger.d.ts

@@ -1,7 +0,0 @@
-export declare const createLogger: (namespace: string) => {
-    debug: (message: string, ...args: unknown[]) => void;
-    info: (message: string, ...args: unknown[]) => void;
-    warn: (message: string, ...args: unknown[]) => void;
-    error: (message: string, ...args: unknown[]) => void;
-    debugIf: (fn: () => string) => void;
-};

package/lib/src/utils/mime.d.ts

@@ -1 +0,0 @@
-export declare const isImage: (mimeType: string) => boolean;

package/lib/src/utils/object.d.ts

@@ -1 +0,0 @@
-export declare const printObject: (val: object, size?: number) => string;

package/lib/src/utils/path.d.ts

@@ -1,28 +0,0 @@
-/**
- * Extracts the filename without extension from a given path.
- */
-export declare const filename: (path: string) => string;
-export declare const basename: (path: string) => string;
-/**
- * Extracts the directory name from a given path.
- */
-export declare const dirname: (path: string) => string;
-/**
- * Tests whether the given path is in the specified directory.
- */
-export declare const isInDirectory: (path: string, directory: string) => boolean;
-export declare const ensureTrailingSlash: (path?: string) => string;
-/**
- * Converts an absolute path to a relative path based on the basePath directory.
- * Handles nested subdirectories within the basePath directory.
- * For example:
- * ```
- * toRelativePath("/Users/user/scans/subdir/scan_id=123", "/Users/user/scans") === "subdir/scan_id=123"
- * ```
- */
-export declare const toRelativePath: (absolutePath: string | undefined, basePath: string | undefined) => string;
-/**
- * Converts a relative path to an absolute path based on the results directory.
- * For example: "subdir/scan_id=123" + "/Users/user/scans/" -> "/Users/user/scans/subdir/scan_id=123"
- */
-export declare const toAbsolutePath: (relativePath: string, baseDir: string) => string;

package/lib/src/utils/python.d.ts

@@ -1,11 +0,0 @@
-/**
- * Extracts the package and module names from a fully qualified Python module path
- *
- * @param name - A Python import path that may include a package name
- * @returns An object containing the package and module names
- */
-export declare const parsePackageName: (name: string) => PythonName;
-export interface PythonName {
-    package: string;
-    module: string;
-}

package/lib/src/utils/react-query.d.ts

@@ -1,4 +0,0 @@
-declare global {
-    var __TEST_DISABLE_RETRY: boolean | undefined;
-}
-export declare const defaultRetry: (failureCount: number, error: Error) => boolean;

package/lib/src/utils/react.d.ts

@@ -1,6 +0,0 @@
-/**
- * Stable empty object reference to avoid unnecessary re-renders.
- * Use as a default value when a nullable object prop needs a fallback.
- */
-export declare const STABLE_EMPTY_OBJECT: Record<string, never>;
-export declare const useWhyDidYouUpdate: (componentName: string, props: any) => void;

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

@@ -1 +0,0 @@
-export declare function useRequiredParams<T extends string>(...keys: T[]): Record<T, string>;

package/lib/src/utils/sync.d.ts

@@ -1,21 +0,0 @@
-/**
- * Delays the execution of code for a specified number of milliseconds.
- */
-export declare function sleep(ms: number): Promise<void>;
-/**
- * Creates a throttled version of a function that only invokes the original function
- * at most once per every `wait` milliseconds. The throttled function will run as much
- * as it can, without ever going more than once per `wait` duration.
- */
-export declare function throttle<T extends (...args: unknown[]) => unknown>(func: T, wait: number, options?: {
-    leading?: boolean;
-    trailing?: boolean;
-}): (...args: Parameters<T>) => ReturnType<T>;
-/**
- * Creates a debounced version of a function that delays invoking the function
- * until after `wait` milliseconds have passed since the last time it was invoked.
- */
-export declare function debounce<T extends (...args: any[]) => unknown>(func: T, wait: number, options?: {
-    leading?: boolean;
-    trailing?: boolean;
-}): (...args: Parameters<T>) => ReturnType<T>;

package/lib/src/utils/type.d.ts

@@ -1,15 +0,0 @@
-/**
- * Checks if a given value is numeric.
- */
-export declare const isNumeric: (n: unknown) => boolean;
-/**
- * Ensures the value is an array
- *
- * @param {*} val - The value to ensure is an array.
- * @returns {Array} - an Array
- */
-export declare const toArray: <T>(val: T | T[]) => Array<T>;
-/**
- * Checks if a given value is a Record.
- */
-export declare const isRecord: (value: unknown) => value is Record<string, unknown>;

package/lib/src/utils/uri.d.ts

@@ -1,19 +0,0 @@
-export declare const directoryRelativeUrl: (file: string, dir?: string) => string;
-export declare const join: (file: string, dir?: string) => string;
-/**
- * Encodes the path segments of a URL or relative path to ensure special characters
- * (like `+`, spaces, etc.) are properly encoded without affecting legal characters like `/`.
- *
- * This function will encode file names and path portions of both absolute URLs and
- * relative paths. It ensures that components of a full URL, such as the protocol and
- * query parameters, remain intact, while only encoding the path.
- */
-export declare function encodePathParts(url: string): string;
-/**
- * Tests whether a string is a valid URI.
- *
- * @param value - The string to test
- * @returns true if the string is a valid URI, false otherwise
- */
-export declare const isUri: (value: string) => boolean;
-export declare const prettyDirUri: (uri: string) => string;

package/lib/src/utils/useDebouncedCallback.d.ts

@@ -1,20 +0,0 @@
-import { DebouncedFunc } from 'lodash-es';
-/**
- * Creates a debounced version of a callback that always calls the latest version.
- *
- * Unlike `useMemo(() => debounce(fn), [])`, this hook ensures the debounced function
- * always invokes the most recent callback, eliminating the need for refs to access
- * current state values.
- *
- * @param callback - The function to debounce. Can close over current state/props.
- * @param delay - Debounce delay in milliseconds
- * @returns A stable debounced function that calls the latest callback
- *
- * @example
- * const debouncedSave = useDebouncedCallback(() => {
- *   // Access current state directly - no refs needed
- *   if (!workingCase) return;
- *   mutation.mutate({ data: workingCase });
- * }, 600);
- */
-export declare function useDebouncedCallback<T extends (...args: unknown[]) => unknown>(callback: T, delay: number): DebouncedFunc<(...args: Parameters<T>) => void>;

package/lib/src/utils/vscode.d.ts

@@ -1,20 +0,0 @@
-/**
- * Type definition for the VS Code API object
- * Note: This is a minimal definition - expand based on your needs
- */
-export interface VSCodeApi {
-    postMessage(message: unknown): void;
-    getState(): unknown;
-    setState(state: unknown): void;
-}
-declare global {
-    interface Window {
-        acquireVsCodeApi?: () => VSCodeApi;
-    }
-}
-/**
- * Gets or initializes the VS Code API instance
- * @returns {VSCodeApi | undefined} The VS Code API instance if in VS Code environment, undefined otherwise
- */
-export declare const getVscodeApi: () => VSCodeApi | undefined;
-export declare const isVscode: () => boolean;