@harnspec/ui 0.0.1

package/dist/lib/components/token-badge.d.ts

@@ -0,0 +1,9 @@
+interface TokenBadgeProps {
+    count?: number;
+    className?: string;
+    size?: 'sm' | 'md';
+    onClick?: () => void;
+    showIcon?: boolean;
+}
+export declare function TokenBadge({ count: initialCount, className, size, onClick, showIcon }: TokenBadgeProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/lib/components/token-progress-bar.d.ts

@@ -0,0 +1,8 @@
+interface TokenProgressBarProps {
+    current: number;
+    max?: number;
+    className?: string;
+    showBenchmarks?: boolean;
+}
+export declare function TokenProgressBar({ current, max, className, showBenchmarks }: TokenProgressBarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/lib/components/tooltip.d.ts

@@ -0,0 +1 @@
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from '../library';

package/dist/lib/components/umbrella-badge.d.ts

@@ -0,0 +1,7 @@
+interface UmbrellaBadgeProps {
+    className?: string;
+    count?: number;
+    iconOnly?: boolean;
+}
+export declare function UmbrellaBadge({ className, count, iconOnly }: UmbrellaBadgeProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/lib/components/validation-badge.d.ts

@@ -0,0 +1,12 @@
+import { ValidationStatus } from '../types/api';
+interface ValidationBadgeProps {
+    status?: ValidationStatus;
+    projectId?: string;
+    specName?: string;
+    errorCount?: number;
+    className?: string;
+    size?: 'sm' | 'md';
+    onClick?: () => void;
+}
+export declare function ValidationBadge({ status: initialStatus, errorCount: initialErrorCount, className, size, onClick }: ValidationBadgeProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/lib/components/wide-mode-toggle.d.ts

@@ -0,0 +1 @@
+export declare function WideModeToggle(): import("react/jsx-runtime").JSX.Element;

package/dist/lib/contexts/ChatContext.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+import { ChatThread } from '../lib/chat-api';
+interface ChatContextType {
+    isOpen: boolean;
+    sidebarWidth: number;
+    activeConversationId: string | null;
+    conversations: ChatThread[];
+    showHistory: boolean;
+    toggleSidebar: () => void;
+    setSidebarWidth: (width: number) => void;
+    selectConversation: (id: string | null) => void;
+    createConversation: () => Promise<void>;
+    deleteConversation: (id: string) => Promise<void>;
+    toggleHistory: () => void;
+    refreshConversations: () => Promise<void>;
+    isChatOpen: boolean;
+    openChat: () => void;
+    closeChat: () => void;
+    toggleChat: () => void;
+}
+export declare function ChatProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useChat(): ChatContextType;
+export {};

package/dist/lib/contexts/KeyboardShortcutsContext.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+/**
+ * Context value for keyboard shortcuts help dialog state.
+ */
+interface KeyboardShortcutsContextValue {
+    /** Whether the keyboard shortcuts help dialog is visible */
+    showHelp: boolean;
+    /** Toggle the keyboard shortcuts help dialog */
+    toggleHelp: () => void;
+}
+/**
+ * Provider for keyboard shortcuts help dialog state.
+ * Wraps the app to provide global keyboard shortcuts help functionality.
+ */
+export declare function KeyboardShortcutsProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access keyboard shortcuts context.
+ * Must be used within a KeyboardShortcutsProvider.
+ */
+export declare function useKeyboardShortcuts(): KeyboardShortcutsContextValue;
+export {};

package/dist/lib/contexts/ToastContext.d.ts

@@ -0,0 +1,15 @@
+export type ToastVariant = 'default' | 'success' | 'error';
+export interface ToastOptions {
+    title: string;
+    description?: string;
+    variant?: ToastVariant;
+    durationMs?: number;
+}
+interface ToastContextValue {
+    toast: (options: ToastOptions) => void;
+}
+export declare function ToastProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useToast(): ToastContextValue;
+export {};

package/dist/lib/contexts/index.d.ts

@@ -0,0 +1,3 @@
+export { KeyboardShortcutsProvider, useKeyboardShortcuts, } from './KeyboardShortcutsContext';
+export { ChatProvider, useChat } from './ChatContext';
+export { ToastProvider, useToast } from './ToastContext';

package/dist/lib/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useLocalStorage } from './use-local-storage';
+export { useDebounce, useDebouncedCallback } from './use-debounce';
+export { useSpecSync } from './use-spec-sync';

package/dist/lib/hooks/use-debounce.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook for debouncing a value
+ */
+export declare function useDebounce<T>(value: T, delay: number): T;
+/**
+ * Hook for debouncing a callback function
+ */
+export declare function useDebouncedCallback<T extends (...args: unknown[]) => unknown>(callback: T, delay: number): (...args: Parameters<T>) => void;

package/dist/lib/hooks/use-local-storage.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Hook for persisting state in localStorage
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((val: T) => T)) => void];

package/dist/lib/hooks/use-media-query.d.ts

@@ -0,0 +1 @@
+export declare function useMediaQuery(query: string): boolean;

package/dist/lib/hooks/use-spec-sync.d.ts

@@ -0,0 +1,12 @@
+export type SpecSyncEventType = 'created' | 'modified' | 'deleted';
+export interface SpecSyncEvent {
+    changeType: SpecSyncEventType;
+    path: string;
+}
+export interface SpecSyncOptions {
+    enabled?: boolean;
+    url?: string;
+    reconnectDelayMs?: number;
+    onChange?: (event: SpecSyncEvent) => void;
+}
+export declare function useSpecSync({ enabled, url, reconnectDelayMs, onChange, }?: SpecSyncOptions): void;

package/dist/lib/hooks/useAutoTitle.d.ts

@@ -0,0 +1,8 @@
+import { UIMessage } from '@ai-sdk/react';
+import { ChatThread } from '../lib/chat-api';
+export declare function useAutoTitle({ activeThreadId, messages, threads, onUpdate }: {
+    activeThreadId: string | null | undefined;
+    messages: UIMessage[];
+    threads: ChatThread[];
+    onUpdate?: () => void;
+}): void;

package/dist/lib/hooks/useCapabilities.d.ts

@@ -0,0 +1,180 @@
+export type ProjectSource = 'local' | 'git';
+export interface Capabilities {
+    projectSources: ProjectSource[];
+    readonly: boolean;
+}
+export declare function useCapabilities(): {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: Capabilities;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+} | {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: Capabilities;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+} | {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+} | {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+} | {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+} | {
+    capabilities: Capabilities;
+    hasSource: (source: ProjectSource) => boolean;
+    data: Capabilities;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<Capabilities, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<Capabilities>;
+};

package/dist/lib/hooks/useChatConfigQuery.d.ts

@@ -0,0 +1,44 @@
+import { ChatConfig, Provider, Model } from '../types/chat-config';
+export declare const chatConfigKeys: {
+    all: readonly ["chatConfig"];
+    config: () => readonly ["chatConfig", "config"];
+    storage: () => readonly ["chatConfig", "storage"];
+};
+/**
+ * Hook to fetch chat configuration
+ */
+export declare function useChatConfig(): import('@tanstack/react-query').UseQueryResult<ChatConfig, Error>;
+/**
+ * Hook to fetch chat storage info
+ */
+export declare function useChatStorageInfo(): import('@tanstack/react-query').UseQueryResult<import('../lib/backend-adapter').ChatStorageInfo, Error>;
+/**
+ * Mutation hooks for chat configuration
+ */
+export declare function useChatConfigMutations(): {
+    updateConfig: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, ChatConfig, unknown>;
+    updateProvider: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, {
+        config: ChatConfig;
+        provider: Provider;
+    }, unknown>;
+    deleteProvider: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, {
+        config: ChatConfig;
+        providerId: string;
+    }, unknown>;
+    updateModel: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, {
+        config: ChatConfig;
+        providerId: string;
+        model: Model;
+    }, unknown>;
+    deleteModel: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, {
+        config: ChatConfig;
+        providerId: string;
+        modelId: string;
+    }, unknown>;
+    updateDefaults: import('@tanstack/react-query').UseMutateAsyncFunction<ChatConfig, Error, {
+        config: ChatConfig;
+        field: "maxSteps" | "defaultProviderId" | "defaultModelId";
+        value: string | number;
+    }, unknown>;
+    isUpdating: boolean;
+};

package/dist/lib/hooks/useChatQuery.d.ts

@@ -0,0 +1,23 @@
+import { ChatThread } from '../lib/chat-api';
+import { UIMessage } from '@ai-sdk/react';
+export declare const chatKeys: {
+    all: readonly ["chat"];
+    threads: (projectId: string) => readonly ["chat", "threads", string];
+    messages: (threadId: string) => readonly ["chat", "messages", string];
+};
+export declare function useChatThreads(projectId: string | null): import('@tanstack/react-query').UseQueryResult<ChatThread[], Error>;
+export declare function useChatMessages(threadId: string | null | undefined): import('@tanstack/react-query').UseQueryResult<UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>[], Error>;
+export declare function useChatThreadMutations(projectId: string | null): {
+    createThread: import('@tanstack/react-query').UseMutateAsyncFunction<ChatThread, Error, {
+        model: {
+            providerId: string;
+            modelId: string;
+        };
+        initialMessages?: UIMessage[];
+    }, unknown>;
+    updateThread: import('@tanstack/react-query').UseMutateAsyncFunction<ChatThread, Error, {
+        id: string;
+        updates: Partial<ChatThread>;
+    }, unknown>;
+    deleteThread: import('@tanstack/react-query').UseMutateAsyncFunction<void, Error, string, unknown>;
+};

package/dist/lib/hooks/useKeyboardShortcuts.d.ts

@@ -0,0 +1,10 @@
+export interface KeyboardShortcut {
+    key: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    description: string;
+    action: () => void;
+}
+export declare function useKeyboardShortcuts(shortcuts: KeyboardShortcut[]): void;
+export declare function useGlobalShortcuts(): KeyboardShortcut[];

package/dist/lib/hooks/useModelsQuery.d.ts

@@ -0,0 +1,22 @@
+export declare const modelsKeys: {
+    all: readonly ["models"];
+    providers: (options?: {
+        agenticOnly?: boolean;
+    }) => readonly ["models", "providers", {
+        agenticOnly?: boolean;
+    } | undefined];
+};
+/**
+ * Mutation hooks for models registry
+ */
+export declare function useModelsRegistryMutations(): {
+    refreshRegistry: import('@tanstack/react-query').UseMutateAsyncFunction<void, Error, void, unknown>;
+    setApiKey: import('@tanstack/react-query').UseMutateAsyncFunction<void, Error, {
+        providerId: string;
+        apiKey: string;
+        baseUrl?: string;
+    }, unknown>;
+    invalidateAll: () => void;
+    isRefreshing: boolean;
+    isSettingKey: boolean;
+};

package/dist/lib/hooks/useProjectQuery.d.ts

@@ -0,0 +1,211 @@
+import { Project, ProjectValidationResponse, ProjectsResponse } from '../types/api';
+export declare const projectKeys: {
+    all: readonly ["projects"];
+    list: (scopeKey: string) => readonly ["projects", "list", string];
+};
+export declare function useProjects(): {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: ProjectsResponse;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+} | {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: ProjectsResponse;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+} | {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+} | {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+} | {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+} | {
+    projects: Project[];
+    availableProjects: Project[];
+    favoriteProjects: Project[];
+    storageKey: string;
+    data: ProjectsResponse;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import('@tanstack/react-query').RefetchOptions) => Promise<import('@tanstack/react-query').QueryObserverResult<ProjectsResponse, Error>>;
+    fetchStatus: import('@tanstack/react-query').FetchStatus;
+    promise: Promise<ProjectsResponse>;
+};
+export declare function useCurrentProject(): {
+    currentProject: Project | null;
+    loading: boolean;
+    error: Error | null;
+    storageKey: string;
+};
+export declare function useProjectMutations(): {
+    switchProject: (projectId: string) => Promise<void>;
+    addProject: (path: string, options?: {
+        favorite?: boolean;
+        color?: string;
+        name?: string;
+        description?: string | null;
+    }) => Promise<Project>;
+    updateProject: (projectId: string, updates: Partial<Pick<Project, "name" | "color" | "favorite" | "description">>) => Promise<Project | undefined>;
+    removeProject: (projectId: string) => Promise<void>;
+    toggleFavorite: (projectId: string) => Promise<void>;
+    validateProject: (projectId: string) => Promise<ProjectValidationResponse>;
+};

package/dist/lib/hooks/useProjectScopedStorage.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hook for persisting state in localStorage, scoped by project.
+ *
+ * Usage:
+ * ```tsx
+ * const [value, setValue] = useProjectScopedStorage('my-key', defaultValue);
+ * ```
+ *
+ * The actual localStorage key will be `my-key:project:{projectId}`.
+ * When switching projects, the value automatically updates to the new project's stored value.
+ */
+export declare function useProjectScopedStorage<T>(baseKey: string, initialValue: T): [T, (value: T | ((val: T) => T)) => void];