@aiquants/contact-map 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Quants
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+# @aiquants/contact-map
+
+Reusable, host-agnostic business contact map and corporate directory feature package.
+再利用可能かつホスト非依存の名刺・連絡先マップおよび組織ディレクトリ機能パッケージ。
+
+---
+
+## Overview / 概要
+
+`@aiquants/contact-map` provides a complete full-stack contact directory solution featuring:
+`@aiquants/contact-map` は以下の特徴を備えたフルスタックの連絡先ディレクトリ機能を提供します:
+
+- **Isomorphic Core (`@aiquants/contact-map`)**:
+  - Shared domain models (`ContactRecord`), Zod wire-validation schemas, and NDJSON streaming serializers/deserializers.
+  - 共有ドメインモデル (`ContactRecord`)、Zod ワイヤ検証スキーマ、および NDJSON ストリーミングのシリアライザー/デシリアライザー。
+  - Incremental tree builder (`IncrementalTreeBuilder`) and hierarchical Japanese department parser (`StandardDepartmentParser`, `TitleBasedDepartmentParser`).
+  - インクリメンタルツリービルダー (`IncrementalTreeBuilder`) および日本語組織階層パーサー。
+  - Deterministic layout geometry calculations with hysteresis deadband (`calculateResponsiveThresholds`, `getHysteresisBreakpointState`).
+  - ヒステリシス不感帯を備えた決定論的レイアウト幾何学計算。
+
+- **Client Layer (`@aiquants/contact-map/client`)**:
+  - Resilient NDJSON streaming client (`ContactMapStreamClient`) with keyset cursor resume, exponential backoff, and offline awareness.
+  - キーセットカーソル再開、指数バックオフ、オフライン復帰検知を備えた堅牢な NDJSON ストリームクライアント。
+  - High-performance virtualized list view with swipe gestures and detail popups.
+  - スワイプジェスチャおよび詳細ポップアップを備えた高性能仮想スクロール一覧ビュー。
+  - Dedicated background Web Worker (`treeWorkerCore`) for incremental directory tree synthesis without UI blocking.
+  - メインスレッドを阻害しない増分ディレクトリツリー合成用バックグラウンド Web Worker。
+  - Mathematical 2-column responsive layout with resize handles (`@aiquants/resize-panels`).
+  - リサイズハンドルを備えた数学的 2 カラムレスポンシブレイアウト。
+  - Multi-script fuzzy search and normalization (`@aiquants/fuzzy-search`, `@aiquants/select-box`).
+  - 多言語・クロス表記対応のあいまい検索および入力正規化。
+
+- **Server Layer (`@aiquants/contact-map/server`)**:
+  - Dependency Injection (DI) port architecture decouples database connections, schemas, authentication, and loggers from host apps.
+  - DB接続、スキーマ、認証、ロガーをホストアプリから疎結合化する DI ポート設計。
+  - Streaming keyset pagination handler (`createContactMapStreamHandler`) preserving millisecond UTC precision (`datetime2(3)`).
+  - ミリ秒精度 (`datetime2(3)`) を維持したストリーミングキーセットパジネーションハンドラー。
+
+---
+
+## Installation / インストール
+
+```bash
+pnpm add @aiquants/contact-map
+```
+
+Peer dependencies:
+
+```json
+{
+  "peerDependencies": {
+    "@aiquants/directory-tree": "workspace:^",
+    "@aiquants/fuzzy-search": "workspace:^",
+    "@aiquants/resize-panels": "workspace:^",
+    "@aiquants/select-box": "workspace:^",
+    "@aiquants/swipe-overlay": "workspace:^",
+    "@aiquants/virtualscroll": "workspace:^",
+    "drizzle-orm": ">=1.0.0-beta.4 <2.0.0",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "react-router": "^7.0.0 || ^8.0.0",
+    "zod": ">=3.25.0 <5.0.0"
+  }
+}
+```
+
+---
+
+## Architecture & Entry Points / アーキテクチャとエントリポイント
+
+| Entry Point | Target | Contents |
+| --- | --- | --- |
+| `@aiquants/contact-map` | Universal | Domain types, Zod schemas, wire protocols, geometry, parsers, and tree builders. |
+| `@aiquants/contact-map/client` | Browser / SSR | React components (`ContactMapSearchPage`, `ContactMapSearchListView`, `ContactMapSearchTreeView`), hooks, and Worker clients. |
+| `@aiquants/contact-map/server` | Node / Server | DI port interfaces (`ContactMapServerPorts`), streaming handlers, and Drizzle MSSQL service queries. |
+| `@aiquants/contact-map/styles/contact-map.standalone.css` | CSS | Pre-compiled Tailwind v4 standalone utility styles. |
+
+---
+
+## Usage / 使用方法
+
+### 1. Server Route Setup / サーバー側ストリーミングルートの設定
+
+```typescript
+// app/routes/api.contact_map.stream.ts
+import { createContactMapStreamHandler } from "@aiquants/contact-map/server"
+import { db } from "~/services/drizzle-db/client.server.ts"
+import { contactTable } from "~/services/drizzle-db/schema/contacts.table.ts"
+import { authenticateInLoader } from "~/services/auth.server.ts"
+
+const handler = createContactMapStreamHandler({
+    db,
+    table: contactTable,
+    authenticate: async (request) => {
+        const user = await authenticateInLoader(request)
+        return { user }
+    },
+})
+
+export async function loader({ request }: { request: Request }) {
+    return handler(request)
+}
+```
+
+### 2. Client Page Setup / クライアント側ページの設定
+
+```tsx
+// app/routes/contact_map.tsx
+import { ContactMapConfigProvider, ContactMapSearchPage } from "@aiquants/contact-map/client"
+import "@aiquants/contact-map/styles/contact-map.standalone.css"
+
+export default function ContactMapRoute() {
+    return (
+        <ContactMapConfigProvider
+            config={{
+                streamEndpoint: "/api/contact_map/stream",
+                openEmailsWithGmail: true,
+            }}
+        >
+            <ContactMapSearchPage />
+        </ContactMapConfigProvider>
+    )
+}
+```
+
+---
+
+## License / ライセンス
+
+MIT

package/dist/client.d.mts

@@ -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.mjs";
+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.mjs";
+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 };