@aiquants/contact-map 0.1.1

package/dist/client.d.ts

@@ -0,0 +1,399 @@
+import * as react from "react";
+import { CSSProperties, ReactNode, RefObject, PointerEvent, MouseEvent } from "react";
+import { UseFuzzySearchOptions } from "@aiquants/fuzzy-search/react";
+import { C as ContactRecord, a as ContactMapStreamPhase, b as ContactMapSearchOutletContext, c as ContactMapOutletContext, d as ContactMapLogger, S as SerializedContactStreamRow } from "./wire-BxEK32O0.js";
+import * as _aiquants_virtualscroll from "@aiquants/virtualscroll";
+import { DirectoryTreeVirtualScrollOptions } from "@aiquants/directory-tree";
+import * as _aiquants_fuzzy_search from "@aiquants/fuzzy-search";
+import { UseFuzzySearchOptions as UseFuzzySearchOptions$1, UnifiedWorkerStats } from "@aiquants/fuzzy-search";
+import { R as ResponsiveLayoutSpec, a as ResponsiveThresholds, C as ContactMapDirectoryEntry, b as ContactRecordForTree } from "./tree-types-Dl6iBQze.js";
+import * as TabsPrimitive from "@radix-ui/react-tabs";
+interface AdvancedSearchSettingsProps {
+    searchOptions: UseFuzzySearchOptions;
+    setSearchOptions: React.Dispatch<React.SetStateAction<UseFuzzySearchOptions>>;
+}
+declare const AdvancedSearchSettings: react.NamedExoticComponent<AdvancedSearchSettingsProps>;
+interface BasicSearchSettingsProps {
+    searchOptions: UseFuzzySearchOptions;
+    setSearchOptions: React.Dispatch<React.SetStateAction<UseFuzzySearchOptions>>;
+    enableHighlighting: boolean;
+    setEnableHighlighting: React.Dispatch<React.SetStateAction<boolean>>;
+    openEmailsWithGmail: boolean;
+    setOpenEmailsWithGmail: React.Dispatch<React.SetStateAction<boolean>>;
+}
+declare const BasicSearchSettings: react.NamedExoticComponent<BasicSearchSettingsProps>;
+type PopupCloseOptions = {
+    suppressLongPress?: boolean;
+    cancelLongPressTimer?: boolean;
+};
+type ContactDetailPopupProps = {
+    contactData: ContactRecord;
+    openEmailsWithGmail: boolean;
+    openGmailCompose: (email: string) => void;
+    onRequestClose: (options?: PopupCloseOptions) => void;
+};
+declare const ContactDetailPopup: ({ contactData, openEmailsWithGmail, openGmailCompose, onRequestClose }: ContactDetailPopupProps) => react.ReactPortal | null;
+interface ContactDetailGridProps {
+    contactData: ContactRecord;
+    searchTerm: string;
+    enableHighlighting: boolean;
+    openEmailsWithGmail: boolean;
+    openGmailCompose: (email: string) => void;
+    isPopupVisible: boolean;
+    onRequestClose: (options?: PopupCloseOptions) => void;
+}
+declare const ContactDetailGrid: ({ contactData, searchTerm, enableHighlighting, openEmailsWithGmail, openGmailCompose, isPopupVisible, onRequestClose }: ContactDetailGridProps) => react.JSX.Element;
+type ContactDetailPanelProps = {
+    contact: ContactRecord | null;
+    searchTerm?: string;
+    enableHighlighting?: boolean;
+    style?: CSSProperties;
+    className?: string;
+};
+declare const ContactDetailPanel: ({ contact, searchTerm, enableHighlighting, style, className }: ContactDetailPanelProps) => react.JSX.Element;
+interface ContactDetailRowLayoutProps {
+    fullName: ReactNode;
+    title?: ReactNode;
+    companyName?: ReactNode;
+    department?: ReactNode;
+    phoneNumber?: ReactNode;
+    email?: ReactNode;
+    updatedAtText?: ReactNode;
+}
+declare const ContactDetailRowLayout: ({ fullName, title, companyName, department, phoneNumber, email, updatedAtText }: ContactDetailRowLayoutProps) => react.JSX.Element;
+interface ContactMapAnnotationProps {
+    recordCount: number;
+    companyCount: number;
+    phase: ContactMapStreamPhase;
+    loadedCount: number;
+    totalCount: number | null;
+    errorMessage: string | null;
+    onRetry?: () => void;
+}
+declare const ContactMapAnnotation: react.NamedExoticComponent<ContactMapAnnotationProps>;
+interface ContactMapAppViewProps {
+    renderHeader?: (props: {
+        title: string;
+        annotation: ReactNode;
+    }) => ReactNode;
+    title?: string;
+    streamEndpoint?: string;
+    workerUrls?: {
+        indexWorker?: string;
+        levenshteinWorker?: string;
+        treeWorker?: string;
+    };
+    onFooterVisibilityChange?: (mode: "visible" | "mobile-hidden") => void;
+}
+declare const ContactMapAppView: (props: ContactMapAppViewProps) => react.JSX.Element;
+declare const LIST_PANEL_MIN_WIDTH: number;
+declare const LIST_DETAIL_PANEL_MIN_WIDTH: number;
+declare const LIST_RESIZE_HANDLE_THICKNESS: number;
+declare const LIST_COLLAPSE_THRESHOLD: number;
+declare const LIST_EXPAND_THRESHOLD: number;
+type ContactDetailGridSkeletonProps = {
+    contactData: ContactRecord | null;
+};
+type PanelSizingResult = {
+    normalizedViewportHeight: number;
+    normalizedDetailHeight: number;
+    panelSizingStyle: CSSProperties;
+};
+declare const useContactPanelSizing: (isSearchTabActive: boolean, containerRef: RefObject<HTMLDivElement | null>, listColumnRef: RefObject<HTMLDivElement | null>) => PanelSizingResult;
+declare const useRowPopupRegistry: () => {
+    isAnyPopupVisible: boolean;
+    handlePopupVisibilityChange: (personId: number, isVisible: boolean) => void;
+};
+declare const useReportPopupVisibility: (personId: number | null, isVisible: boolean, onVisibilityChange: (personId: number, isVisible: boolean) => void) => void;
+type ContactMapSearchListViewProps = {
+    context: ContactMapSearchOutletContext;
+};
+declare const ContactMapSearchListView: ({ context }: ContactMapSearchListViewProps) => react.JSX.Element;
+type ContactMapTab = "search" | "settings" | "statistics";
+interface ContactMapSearchPageProps {
+    streamState?: ContactMapOutletContext;
+    workerUrls?: {
+        indexWorker?: string;
+        levenshteinWorker?: string;
+    };
+    onFooterVisibilityChange?: (mode: "visible" | "mobile-hidden") => void;
+    children?: (context: ContactMapSearchOutletContext) => ReactNode;
+}
+declare const ContactMapSearchPage: ({ streamState, workerUrls, onFooterVisibilityChange, children }?: ContactMapSearchPageProps) => react.JSX.Element;
+interface ContactMapSearchTabGroupProps {
+    context: ContactMapSearchOutletContext;
+}
+declare const ContactMapSearchTabGroup: ({ context }: ContactMapSearchTabGroupProps) => react.JSX.Element;
+declare const TREE_PANEL_MIN_WIDTH: number;
+declare const TREE_DETAIL_PANEL_MIN_WIDTH: number;
+declare const TREE_RESIZE_HANDLE_THICKNESS: number;
+declare const TREE_COLLAPSE_THRESHOLD: number;
+declare const TREE_EXPAND_THRESHOLD: number;
+interface ContactMapSearchTreeViewProps {
+    context: ContactMapSearchOutletContext;
+    controlsContainer?: HTMLDivElement | null;
+}
+declare const composeTreeVirtualScrollOptions: <T extends DirectoryTreeVirtualScrollOptions>(base: T, viewportHeight: number, isPopupOpen: boolean) => T & {
+    viewportHeightOverride: number;
+    behaviorOptions: {
+        enablePointerDrag: boolean;
+        enableKeyboardNavigation: boolean;
+        pointerDragInputs?: _aiquants_virtualscroll.ScrollPaneProps["pointerDragInputs"];
+        enableEscapeRowReturn?: boolean;
+        wheelSpeedMultiplier?: number;
+        inertiaOptions?: _aiquants_virtualscroll.ScrollPaneProps["inertiaOptions"];
+        overscrollBehavior?: _aiquants_virtualscroll.ScrollPaneProps["overscrollBehavior"];
+        clipItemHeight?: boolean;
+        resetOnGetItemHeightChange?: boolean;
+    };
+};
+declare const ContactMapSearchTreeView: ({ context, controlsContainer }: ContactMapSearchTreeViewProps) => react.JSX.Element;
+interface HighlightedTextProps {
+    text: string;
+    query: string;
+    enabled?: boolean;
+}
+declare const HighlightedText: react.NamedExoticComponent<HighlightedTextProps>;
+interface IndexWorkerSettingsProps {
+    searchOptions: UseFuzzySearchOptions;
+    setSearchOptions: React.Dispatch<React.SetStateAction<UseFuzzySearchOptions>>;
+}
+declare const IndexWorkerSettings: react.NamedExoticComponent<IndexWorkerSettingsProps>;
+interface LevenshteinWorkerSettingsProps {
+    searchOptions: UseFuzzySearchOptions;
+    setSearchOptions: React.Dispatch<React.SetStateAction<UseFuzzySearchOptions>>;
+}
+declare const LevenshteinWorkerSettings: react.NamedExoticComponent<LevenshteinWorkerSettingsProps>;
+type SearchOptionsPanelTab = "basic" | "advanced" | "index" | "levenshtein";
+interface SearchOptionsPanelProps {
+    searchOptions: UseFuzzySearchOptions$1;
+    setSearchOptions: React.Dispatch<React.SetStateAction<UseFuzzySearchOptions$1>>;
+    enableHighlighting: boolean;
+    setEnableHighlighting: React.Dispatch<React.SetStateAction<boolean>>;
+    openEmailsWithGmail: boolean;
+    setOpenEmailsWithGmail: React.Dispatch<React.SetStateAction<boolean>>;
+    activeTab: SearchOptionsPanelTab;
+    onTabChange: (tab: SearchOptionsPanelTab) => void;
+}
+declare const SearchOptionsPanel: react.NamedExoticComponent<SearchOptionsPanelProps>;
+interface StatItemProps {
+    label: string;
+    value: string | number;
+    unit?: string;
+    color?: string;
+}
+declare const StatItem: react.NamedExoticComponent<StatItemProps>;
+interface StatisticsPanelProps {
+    performanceMetrics: {
+        totalSearches: number;
+        averageSearchTime: number;
+        itemCount: number;
+        resultsCount: number;
+        workerStats?: {
+            index?: _aiquants_fuzzy_search.UnifiedWorkerStats;
+            levenshtein?: _aiquants_fuzzy_search.UnifiedWorkerStats;
+        };
+    };
+    searchTerm: string;
+    totalDataCount: number;
+    resultsCount: number;
+    resetStats: () => Promise<void>;
+    rebuildIndex: () => Promise<void>;
+    isIndexBuilding: boolean;
+    activeTab: StatisticsPanelTab;
+    onTabChange: (tab: StatisticsPanelTab) => void;
+}
+type StatisticsPanelTab = "overview" | "index" | "levenshtein";
+declare const StatisticsPanel: react.NamedExoticComponent<StatisticsPanelProps>;
+interface WorkerStatsSectionProps {
+    title: string;
+    icon: string;
+    stats: UnifiedWorkerStats | undefined;
+    color: string;
+}
+declare const WorkerStatsSection: react.NamedExoticComponent<WorkerStatsSectionProps>;
+interface ContactMapConfig {
+    streamEndpoint?: string;
+    openEmailsWithGmail?: boolean;
+    treeWorkerFactory?: () => Worker;
+    workerUrls?: {
+        indexWorker?: string;
+        levenshteinWorker?: string;
+        treeWorker?: string;
+    };
+    fuzzyWorkerUrls?: {
+        indexWorkerUrl?: string;
+        levenshteinWorkerUrl?: string;
+    };
+    layoutSpec?: Partial<ResponsiveLayoutSpec>;
+}
+declare function ContactMapConfigProvider({ config, children }: {
+    config?: ContactMapConfig;
+    children: ReactNode;
+}): react.JSX.Element;
+declare function useContactMapConfig(): ContactMapConfig;
+type ContactMapStreamState = {
+    records: ContactRecord[];
+    loadedCount: number;
+    totalCount: number | null;
+    isLoading: boolean;
+    isComplete: boolean;
+    phase: ContactMapStreamPhase;
+    error: Error | null;
+};
+type ContactMapStreamClientDeps = {
+    fetchFn?: typeof fetch;
+    endpoint?: string;
+    initialRetryDelayMs?: number;
+    maxRetryDelayMs?: number;
+    maxConsecutiveFailures?: number;
+    logger?: ContactMapLogger;
+};
+declare const deserializeStreamRecord: (row: SerializedContactStreamRow) => ContactRecord;
+declare class ContactMapStreamClient {
+    private readonly recordMap;
+    private readonly listeners;
+    private readonly fetchFn;
+    private readonly endpoint;
+    private readonly initialRetryDelayMs;
+    private readonly maxRetryDelayMs;
+    private readonly maxConsecutiveFailures;
+    private readonly logger;
+    private lastCursor;
+    private consecutiveFailures;
+    private started;
+    private disposed;
+    private activeController;
+    private wakeRetryWait;
+    private state;
+    constructor(deps?: ContactMapStreamClientDeps);
+    getState(): ContactMapStreamState;
+    getRecordMap(): ReadonlyMap<number, ContactRecord>;
+    subscribe(listener: (state: ContactMapStreamState) => void): () => void;
+    start(): void;
+    retry(): void;
+    retryNow(): void;
+    dispose(): void;
+    private readonly handleOnline;
+    private setState;
+    private publishRecords;
+    private runStreamLoop;
+    private waitBeforeRetry;
+    private buildStreamUrl;
+    private streamOnce;
+}
+declare const useAnimatedNumber: (targetValue: number, durationMs?: number) => number;
+declare const getContactMapStreamClient: (endpoint?: string) => ContactMapStreamClient;
+declare const resetContactMapStreamClientForTesting: () => void;
+declare const getContactMapRecordMap: () => ReadonlyMap<number, ContactRecord>;
+declare function useContactMapStream(endpointOverride?: string): ContactMapStreamState & {
+    retryNow: () => void;
+};
+interface UseDynamicViewportHeightOptions {
+    enableMutationObserver?: boolean;
+    bottomGap?: number;
+    minFallbackHeight?: number;
+}
+interface UseDynamicViewportHeightResult {
+    viewportHeight: number;
+    updateViewportHeight: () => void;
+}
+declare const useDynamicViewportHeight: (containerRef: RefObject<HTMLDivElement | null>, options?: UseDynamicViewportHeightOptions) => UseDynamicViewportHeightResult;
+interface UseHorizontalDragScrollOptions {
+    dragThreshold?: number;
+}
+interface HorizontalDragScrollHandlers {
+    setScrollableRef: (element: HTMLDivElement | null) => void;
+    onPointerDown: (event: PointerEvent<HTMLDivElement>) => void;
+    onPointerMove: (event: PointerEvent<HTMLDivElement>) => void;
+    onPointerUp: (event: PointerEvent<HTMLDivElement>) => void;
+    onPointerLeave: (event: PointerEvent<HTMLDivElement>) => void;
+    onPointerCancel: (event: PointerEvent<HTMLDivElement>) => void;
+    onClickCapture: (event: MouseEvent<HTMLDivElement>) => void;
+}
+declare const useHorizontalDragScroll: (options?: UseHorizontalDragScrollOptions) => HorizontalDragScrollHandlers;
+type UseLongPressPopupOptions<T> = {
+    ref: React.RefObject<HTMLElement | null>;
+    onSelect?: (item: T) => void;
+    resolveItem?: (target: EventTarget) => T | null;
+    item?: T;
+};
+interface UseLongPressPopupReturn<T> {
+    isPopupVisible: boolean;
+    popupItem: T | null;
+    handleClosePopup: (options?: PopupCloseOptions) => void;
+}
+declare const useLongPressPopup: <T>({ ref, onSelect, resolveItem, item }: UseLongPressPopupOptions<T>) => UseLongPressPopupReturn<T>;
+interface UseResponsiveTwoColumnLayoutOptions {
+    mediaQuery?: string;
+}
+interface UseResponsiveTwoColumnLayoutResult {
+    isTwoColumn: boolean;
+    isContainerNarrow: boolean;
+    isMediaMatches: boolean;
+    containerWidth: number;
+}
+declare function useResponsiveTwoColumnLayout(containerRef: RefObject<HTMLElement | null>, thresholds: Pick<ResponsiveThresholds, "collapseThreshold" | "expandThreshold">, options?: UseResponsiveTwoColumnLayoutOptions): UseResponsiveTwoColumnLayoutResult;
+interface TreeWorkerSnapshot {
+    tree: ContactMapDirectoryEntry[];
+    directoryPaths?: string[];
+    consumedRecords: number;
+    uniquePersonCount: number;
+    isIdle: boolean;
+    rebuildEpoch: number;
+}
+interface TreeWorkerState {
+    snapshot: TreeWorkerSnapshot | null;
+    isBuilding: boolean;
+}
+declare class TreeWorkerSession {
+    private worker;
+    private generation;
+    private postedCount;
+    private latestSnapshot;
+    private workerNeedsReset;
+    private lastSyncedRecords;
+    private consecutiveFailures;
+    private finalizeRequested;
+    private retryTimer;
+    private readonly listeners;
+    private readonly workerFactory;
+    private state;
+    constructor(workerFactory: () => Worker);
+    getState: () => TreeWorkerState;
+    private updateState;
+    subscribe: (listener: () => void) => (() => void);
+    private notify;
+    private ensureWorker;
+    private readonly handleMessage;
+    private readonly handleFailure;
+    syncRecords(records: readonly ContactRecordForTree[]): void;
+    finalize(): void;
+    dispose(): void;
+}
+declare const getTreeWorkerSession: (factory?: () => Worker, treeWorkerUrl?: string) => TreeWorkerSession;
+declare const syncTreeWorkerRecords: (records: readonly ContactRecordForTree[]) => void;
+declare const finalizeTreeWorker: () => void;
+declare const resetTreeWorkerSessionForTesting: () => void;
+declare function useTreeWorker(records: readonly ContactRecordForTree[], isComplete?: boolean): TreeWorkerState;
+declare function contactMapShouldRevalidate(): boolean;
+type ProgressProps = react.ComponentPropsWithoutRef<"div"> & {
+    value?: number;
+    max?: number;
+    indicatorClassName?: string;
+};
+declare function Progress({ value, max, className, indicatorClassName, ...props }: ProgressProps): react.JSX.Element;
+interface SwipeOverlayProps {
+    isOpen: boolean;
+    onClose: () => void;
+    children: ReactNode;
+    className?: string;
+    title?: string;
+    direction?: "bottom" | "top" | "left" | "right";
+}
+declare const SwipeOverlay: ({ isOpen, onClose, children, className, title }: SwipeOverlayProps) => react.JSX.Element | null;
+declare const Tabs: react.ForwardRefExoticComponent<TabsPrimitive.TabsProps & react.RefAttributes<HTMLDivElement>>;
+declare const TabsList: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsListProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+declare const TabsTrigger: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
+declare const TabsContent: react.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+export { AdvancedSearchSettings, type AdvancedSearchSettingsProps, BasicSearchSettings, type BasicSearchSettingsProps, ContactDetailGrid, type ContactDetailGridProps, type ContactDetailGridSkeletonProps, ContactDetailPanel, type ContactDetailPanelProps, ContactDetailPopup, type ContactDetailPopupProps, ContactDetailRowLayout, type ContactDetailRowLayoutProps, ContactMapAnnotation, type ContactMapAnnotationProps, ContactMapAppView, type ContactMapAppViewProps, type ContactMapConfig, ContactMapConfigProvider, ContactMapSearchListView, ContactMapSearchPage, type ContactMapSearchPageProps, ContactMapSearchTabGroup, type ContactMapSearchTabGroupProps, ContactMapSearchTreeView, type ContactMapSearchTreeViewProps, ContactMapStreamClient, type ContactMapStreamClientDeps, ContactMapStreamPhase, type ContactMapStreamState, type ContactMapTab, HighlightedText, type HighlightedTextProps, type HorizontalDragScrollHandlers, IndexWorkerSettings, type IndexWorkerSettingsProps, LIST_COLLAPSE_THRESHOLD, LIST_DETAIL_PANEL_MIN_WIDTH, LIST_EXPAND_THRESHOLD, LIST_PANEL_MIN_WIDTH, LIST_RESIZE_HANDLE_THICKNESS, LevenshteinWorkerSettings, type LevenshteinWorkerSettingsProps, type PopupCloseOptions, Progress, type ProgressProps, SearchOptionsPanel, type SearchOptionsPanelProps, type SearchOptionsPanelTab, StatItem, type StatItemProps, StatisticsPanel, type StatisticsPanelProps, type StatisticsPanelTab, SwipeOverlay, type SwipeOverlayProps, TREE_COLLAPSE_THRESHOLD, TREE_DETAIL_PANEL_MIN_WIDTH, TREE_EXPAND_THRESHOLD, TREE_PANEL_MIN_WIDTH, TREE_RESIZE_HANDLE_THICKNESS, Tabs, TabsContent, TabsList, TabsTrigger, TreeWorkerSession, type TreeWorkerSnapshot, type TreeWorkerState, type UseDynamicViewportHeightOptions, type UseDynamicViewportHeightResult, type UseHorizontalDragScrollOptions, type UseLongPressPopupOptions, type UseLongPressPopupReturn, type UseResponsiveTwoColumnLayoutOptions, type UseResponsiveTwoColumnLayoutResult, WorkerStatsSection, type WorkerStatsSectionProps, composeTreeVirtualScrollOptions, contactMapShouldRevalidate, deserializeStreamRecord, finalizeTreeWorker, getContactMapRecordMap, getContactMapStreamClient, getTreeWorkerSession, resetContactMapStreamClientForTesting, resetTreeWorkerSessionForTesting, syncTreeWorkerRecords, useAnimatedNumber, useContactMapConfig, useContactMapStream, useContactPanelSizing, useDynamicViewportHeight, useHorizontalDragScroll, useLongPressPopup, useReportPopupVisibility, useResponsiveTwoColumnLayout, useRowPopupRegistry, useTreeWorker };