@leanspec/ui 0.2.23 → 0.2.25

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];

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

@@ -0,0 +1,31 @@
+import { SessionMode } from '../types/api';
+export declare const sessionKeys: {
+    all: readonly ["sessions"];
+    list: (projectId: string) => readonly ["sessions", "list", string];
+    detail: (projectId: string, sessionId: string) => readonly ["sessions", "detail", string, string];
+};
+export declare function useSessions(projectId: string | null): import('@tanstack/react-query').UseQueryResult<import('../types/api').Session[], Error>;
+export declare function useSession(projectId: string | null, sessionId: string | null): import('@tanstack/react-query').UseQueryResult<import('../types/api').Session, Error>;
+export declare function useSessionMutations(projectId: string | null): {
+    createSession: import('@tanstack/react-query').UseMutateAsyncFunction<import('../types/api').Session, Error, {
+        projectPath: string;
+        specIds?: string[];
+        specId?: string | null;
+        prompt?: string | null;
+        runner?: string;
+        mode: SessionMode;
+    }, unknown>;
+    startSession: import('@tanstack/react-query').UseMutateAsyncFunction<import('../types/api').Session, Error, string, unknown>;
+    stopSession: import('@tanstack/react-query').UseMutateAsyncFunction<import('../types/api').Session, Error, string, unknown>;
+    pauseSession: import('@tanstack/react-query').UseMutateAsyncFunction<import('../types/api').Session, Error, string, unknown>;
+    resumeSession: import('@tanstack/react-query').UseMutateAsyncFunction<import('../types/api').Session, Error, string, unknown>;
+};
+/**
+ * Stream/poll sessions periodically.
+ * @param projectId - The project ID to poll sessions for
+ * @param options - Optional configuration
+ * @param options.enabled - Whether polling is enabled (default: true). Set to false to disable polling.
+ */
+export declare function useSessionsStream(projectId: string | null, options?: {
+    enabled?: boolean;
+}): void;

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

@@ -0,0 +1,14 @@
+import { SpecTokenResponse, SpecValidationResponse } from '../types/api';
+export declare function useSpecActionDialogs(projectId?: string): {
+    activeSpecName: string | null;
+    tokenDialogOpen: boolean;
+    tokenDialogLoading: boolean;
+    tokenDialogData: SpecTokenResponse | null;
+    closeTokenDialog: () => void;
+    handleTokenClick: (specName: string) => void;
+    validationDialogOpen: boolean;
+    validationDialogLoading: boolean;
+    validationDialogData: SpecValidationResponse | null;
+    closeValidationDialog: () => void;
+    handleValidationClick: (specName: string) => void;
+};

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

@@ -0,0 +1,44 @@
+import { api } from '../lib/api';
+import { Spec, ListParams } from '../types/api';
+export declare const specKeys: {
+    all: readonly ["specs"];
+    lists: () => readonly ["specs", "list"];
+    list: (projectId: string, params?: ListParams) => readonly ["specs", "list", string, ListParams | undefined];
+    details: () => readonly ["specs", "detail"];
+    detail: (projectId: string, specName: string) => readonly ["specs", "detail", string, string];
+    stats: (projectId: string) => readonly ["specs", "stats", string];
+    dependencies: (projectId: string, specName?: string) => readonly ["specs", "deps", string, string | undefined];
+};
+/**
+ * Hook to fetch specs list with automatic caching
+ */
+export declare function useSpecsList(projectId: string | null, params?: ListParams): import('@tanstack/react-query').UseQueryResult<Spec[], Error>;
+/**
+ * Hook to fetch specs with hierarchy (for board/tree views)
+ */
+export declare function useSpecsWithHierarchy(projectId: string | null, params?: ListParams): import('@tanstack/react-query').UseQueryResult<import('../types/api').ListSpecsResponse, Error>;
+/**
+ * Hook to fetch a single spec's details
+ */
+export declare function useSpecDetail(projectId: string | null, specName: string | null): import('@tanstack/react-query').UseQueryResult<import('../types/api').SpecDetail, Error>;
+/**
+ * Hook to fetch project stats
+ */
+export declare function useProjectStats(projectId: string | null): import('@tanstack/react-query').UseQueryResult<import('../types/api').Stats, Error>;
+/**
+ * Hook to fetch dependency graph
+ */
+export declare function useDependencyGraph(projectId: string | null, specName?: string): import('@tanstack/react-query').UseQueryResult<import('../types/api').DependencyGraph, Error>;
+/**
+ * Mutation hook for updating spec metadata
+ */
+export declare function useUpdateSpec(projectId: string | null): import('@tanstack/react-query').UseMutationResult<void, Error, {
+    specName: string;
+    updates: Parameters<typeof api.updateSpec>[1];
+}, {
+    previousSpecs: unknown;
+}>;
+/**
+ * Hook to invalidate all spec queries (for SSE/external updates)
+ */
+export declare function useInvalidateSpecs(): () => void;

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

@@ -0,0 +1 @@
+export declare function useSpecsSSE(): void;

package/dist/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * from './library';
+export { default as i18n } from './lib/i18n';