@nindroidsystems/pluginator 2.3.0

package/dist/ui/hooks/useTags.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Tags Hook
+ *
+ * React hook for plugin tags state management.
+ *
+ * @since v1.28.0
+ */
+import { type Tag, type TagColor } from '../../core/tags/index.js';
+/**
+ * Hook return type
+ */
+interface UseTagsResult {
+    /** All defined tags */
+    tags: Tag[];
+    /** System tags only */
+    systemTags: Tag[];
+    /** Custom (user-created) tags */
+    customTags: Tag[];
+    /** Number of tags */
+    tagCount: number;
+    /** Get a tag by ID */
+    getTag: (id: string) => Tag | null;
+    /** Check if tag exists */
+    hasTag: (id: string) => boolean;
+    /** Create a new tag */
+    createTag: (name: string, color: TagColor, description?: string) => Tag;
+    /** Update a tag */
+    updateTag: (id: string, updates: Partial<Omit<Tag, 'id' | 'isSystem' | 'createdAt'>>) => void;
+    /** Delete a tag */
+    deleteTag: (id: string) => void;
+    /** Assign tag to plugin */
+    assignTag: (pluginName: string, tagId: string) => void;
+    /** Remove tag from plugin */
+    removeTag: (pluginName: string, tagId: string) => void;
+    /** Toggle tag on plugin */
+    toggleTag: (pluginName: string, tagId: string) => boolean;
+    /** Check if plugin has tag */
+    hasPluginTag: (pluginName: string, tagId: string) => boolean;
+    /** Get tags for a plugin */
+    getPluginTags: (pluginName: string) => Tag[];
+    /** Get tag IDs for a plugin */
+    getPluginTagIds: (pluginName: string) => string[];
+    /** Get plugins with a tag */
+    getPluginsByTag: (tagId: string) => string[];
+    /** Set all tags for a plugin */
+    setPluginTags: (pluginName: string, tagIds: string[]) => void;
+    /** Clear all tags from a plugin */
+    clearPluginTags: (pluginName: string) => void;
+    /** Get tag counts */
+    getTagCounts: () => Map<string, number>;
+    /** Serialize for persistence */
+    serialize: () => string;
+}
+/**
+ * Hook options
+ */
+interface UseTagsOptions {
+    /** Initial serialized data to load */
+    initialData?: string;
+}
+/**
+ * React hook for managing plugin tags
+ */
+export declare function useTags(options?: UseTagsOptions): UseTagsResult;
+export {};
+//# sourceMappingURL=useTags.d.ts.map

package/dist/ui/hooks/useTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTags.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTags.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,QAAQ,EAAc,MAAM,0BAA0B,CAAC;AAE/E;;GAEG;AACH,UAAU,aAAa;IACrB,uBAAuB;IACvB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,uBAAuB;IACvB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC;IACnC,0BAA0B;IAC1B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IAEhC,uBAAuB;IACvB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,GAAG,CAAC;IACxE,mBAAmB;IACnB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9F,mBAAmB;IACnB,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,2BAA2B;IAC3B,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,6BAA6B;IAC7B,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,2BAA2B;IAC3B,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1D,8BAA8B;IAC9B,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7D,4BAA4B;IAC5B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;IAC7C,+BAA+B;IAC/B,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAClD,6BAA6B;IAC7B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAE7C,gCAAgC;IAChC,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC9D,mCAAmC;IACnC,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAE9C,qBAAqB;IACrB,YAAY,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,gCAAgC;IAChC,SAAS,EAAE,MAAM,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAgI/D"}

package/dist/ui/hooks/useTerminalManagement.d.ts

@@ -0,0 +1,31 @@
+/**
+ * useTerminalManagement Hook
+ *
+ * Manages terminal size tracking, resize handling, and screen clearing.
+ * Extracted from App.tsx for better separation of concerns.
+ */
+declare const MIN_TERMINAL_WIDTH = 140;
+declare const MIN_TERMINAL_HEIGHT = 40;
+declare const UI_CHROME_LINES = 8;
+export interface TerminalSize {
+    width: number;
+    height: number;
+}
+export interface UseTerminalManagementResult {
+    /** Current terminal dimensions */
+    terminalSize: TerminalSize;
+    /** Key that changes on resize to force React re-render */
+    resizeKey: number;
+    /** Whether terminal is below minimum required size */
+    isTooSmall: boolean;
+    /** Available height for content (terminal height minus UI chrome) */
+    contentHeight: number;
+    /** Clear the terminal screen */
+    clearScreen: () => void;
+}
+/**
+ * Hook for managing terminal size and screen clearing
+ */
+export declare function useTerminalManagement(): UseTerminalManagementResult;
+export { MIN_TERMINAL_HEIGHT, MIN_TERMINAL_WIDTH, UI_CHROME_LINES };
+//# sourceMappingURL=useTerminalManagement.d.ts.map

package/dist/ui/hooks/useTerminalManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTerminalManagement.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useTerminalManagement.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,QAAA,MAAM,kBAAkB,MAAM,CAAC;AAC/B,QAAA,MAAM,mBAAmB,KAAK,CAAC;AAG/B,QAAA,MAAM,eAAe,IAAI,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,kCAAkC;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,2BAA2B,CAoDnE;AAGD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}

package/dist/ui/hooks/useThrottle.d.ts

@@ -0,0 +1,65 @@
+/**
+ * useThrottle Hook
+ *
+ * Throttles a callback function, ensuring it can only be called
+ * once within a specified time window. The first call executes
+ * immediately, subsequent calls within the window are ignored.
+ */
+/**
+ * Options for the useThrottle hook
+ */
+export interface UseThrottleOptions {
+    /** Whether to call the function on the leading edge (default: true) */
+    leading?: boolean;
+    /** Whether to call the function on the trailing edge (default: false) */
+    trailing?: boolean;
+}
+/**
+ * Return type for useThrottle hook
+ */
+export interface UseThrottleResult<T extends (...args: unknown[]) => unknown> {
+    /** The throttled function */
+    throttledFn: (...args: Parameters<T>) => ReturnType<T> | undefined;
+    /** Whether the throttle is currently active (blocking calls) */
+    isThrottled: boolean;
+    /** Cancel any pending trailing call */
+    cancel: () => void;
+    /** Reset the throttle timer, allowing immediate next call */
+    reset: () => void;
+}
+/**
+ * Throttles a callback function to limit execution frequency
+ *
+ * @param callback - The function to throttle
+ * @param delay - Minimum time between calls in milliseconds
+ * @param options - Throttle options
+ * @returns Object with throttled function and control methods
+ *
+ * @example
+ * const { throttledFn } = useThrottle(scanServers, 500);
+ *
+ * // First call executes immediately
+ * throttledFn(); // Executes
+ *
+ * // Calls within 500ms are ignored
+ * throttledFn(); // Ignored
+ * throttledFn(); // Ignored
+ *
+ * // After 500ms, next call executes
+ * setTimeout(() => throttledFn(), 600); // Executes
+ */
+export declare function useThrottle<T extends (...args: unknown[]) => unknown>(callback: T, delay: number, options?: UseThrottleOptions): UseThrottleResult<T>;
+/**
+ * Simple throttle hook that just returns the throttled function
+ *
+ * @param callback - The function to throttle
+ * @param delay - Minimum time between calls in milliseconds
+ * @returns The throttled function
+ *
+ * @example
+ * const throttledScan = useThrottleFn(scanServers, 500);
+ * throttledScan(); // Use like normal function
+ */
+export declare function useThrottleFn<T extends (...args: unknown[]) => unknown>(callback: T, delay: number): (...args: Parameters<T>) => ReturnType<T> | undefined;
+export default useThrottle;
+//# sourceMappingURL=useThrottle.d.ts.map

package/dist/ui/hooks/useThrottle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThrottle.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useThrottle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO;IAC1E,6BAA6B;IAC7B,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAuFzJ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAG1J;AAED,eAAe,WAAW,CAAC"}

package/dist/ui/hooks/useUIState.d.ts

@@ -0,0 +1,91 @@
+/**
+ * useUIState Hook
+ *
+ * Derives the current UI state from component state.
+ * Used for input validation and state-aware behavior.
+ */
+import { type StateContext, type TabId } from '../state/index.js';
+/**
+ * Options for the useUIState hook
+ */
+export interface UseUIStateOptions {
+    /** Whether help overlay is shown */
+    showHelp: boolean;
+    /** Whether config view is shown */
+    showConfig: boolean;
+    /** Whether command palette is shown */
+    showCommandPalette: boolean;
+    /** Whether confirmation dialog is shown */
+    showConfirmDialog: boolean;
+    /** Current workflow type */
+    workflowType: 'sync' | 'backup' | 'download' | 'migrate' | null;
+    /** Whether batch menu is shown */
+    showBatchMenu: boolean;
+    /** Whether setup wizard is shown */
+    showSetup: boolean;
+    /** Whether account view is shown */
+    showAccountView: boolean;
+    /** Current download step (v1.50.5: extended with config-prompt and destination) */
+    downloadStep: 'config-prompt' | 'type' | 'version' | 'destination' | 'progress';
+    /** Sync operation loading state */
+    syncLoading: boolean;
+    /** Backup operation loading state */
+    backupLoading: boolean;
+    /** Download operation loading state */
+    downloadLoading: boolean;
+    /** Updates check loading state */
+    updatesLoading: boolean;
+    /** Servers scan loading state */
+    serversLoading: boolean;
+    /** Plugins loading state */
+    pluginsLoading: boolean;
+    /** Logs loading state */
+    logsLoading: boolean;
+    /** Active tab ID */
+    activeTab: TabId;
+    /** Network online status */
+    online: boolean;
+    /** Debug mode enabled */
+    debugEnabled: boolean;
+    /** Whether current operation can be cancelled */
+    canCancel?: boolean;
+    /** Whether first launch prompt is shown */
+    showFirstLaunchPrompt?: boolean;
+    /** Whether login dialog is shown */
+    showLoginDialog?: boolean;
+}
+/**
+ * Return type for useUIState hook
+ */
+export interface UseUIStateResult {
+    /** Current UI state context */
+    context: StateContext;
+    /** Whether input is currently enabled (not blocked by progress/setup) */
+    inputEnabled: boolean;
+    /** Whether any workflow is loading */
+    workflowLoading: boolean;
+    /** Whether any data is loading */
+    dataLoading: boolean;
+}
+/**
+ * Hook that derives the current UI state from component state
+ *
+ * @param options - Current component state values
+ * @returns Derived state context and computed flags
+ *
+ * @example
+ * const { context, inputEnabled } = useUIState({
+ *   showHelp,
+ *   showConfig,
+ *   showCommandPalette,
+ *   // ... other state values
+ * });
+ *
+ * // Use context.state for input validation
+ * if (context.state === 'idle') {
+ *   // Handle normal input
+ * }
+ */
+export declare function useUIState(options: UseUIStateOptions): UseUIStateResult;
+export default useUIState;
+//# sourceMappingURL=useUIState.d.ts.map

package/dist/ui/hooks/useUIState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUIState.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useUIState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAwD,MAAM,mBAAmB,CAAC;AAExH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2CAA2C;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,4BAA4B;IAC5B,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;IAChE,kCAAkC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IAChF,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,cAAc,EAAE,OAAO,CAAC;IACxB,4BAA4B;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB;IACpB,SAAS,EAAE,KAAK,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,oCAAoC;IACpC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,yEAAyE;IACzE,YAAY,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,eAAe,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CA8HvE;AAED,eAAe,UAAU,CAAC"}

package/dist/ui/hooks/useUpdates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * useUpdates Hook
+ *
+ * Manages update checking state with cache persistence.
+ * Update results persist across app restarts until cache expires or is cleared.
+ */
+import type { CombinedPlugin, Plugin, PluginUpdateInfo } from '../../core/types/index.js';
+import { type UpdateCheckProgress } from '../../workflows/update-check.js';
+/** Input can be either legacy Plugin[] or new CombinedPlugin[] */
+export type PluginInput = Plugin[] | CombinedPlugin[];
+export interface UseUpdatesOptions {
+    plugins?: PluginInput;
+}
+export interface UpdatesState {
+    updates: PluginUpdateInfo[];
+    upToDate: PluginUpdateInfo[];
+    errors: Array<{
+        pluginName: string;
+        error: string;
+    }>;
+    skipped: Array<{
+        pluginName: string;
+        reason: string;
+    }>;
+    checkProgress: UpdateCheckProgress | null;
+    loading: boolean;
+    error: string | null;
+    lastChecked: Date | null;
+    /** Check updates - accepts either Plugin[] or CombinedPlugin[] */
+    checkUpdates: (plugins: PluginInput) => Promise<void>;
+    /** Clear all update state and cache */
+    clearUpdates: () => Promise<void>;
+    removeFromUpdates: (pluginNames: string[]) => void;
+}
+/**
+ * Hook for managing update checks
+ */
+export declare function useUpdates({ plugins: initialPlugins }?: UseUpdatesOptions): UpdatesState;
+//# sourceMappingURL=useUpdates.d.ts.map

package/dist/ui/hooks/useUpdates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdates.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useUpdates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE1F,OAAO,EAAE,KAAK,mBAAmB,EAA2C,MAAM,iCAAiC,CAAC;AAEpH,kEAAkE;AAClE,MAAM,MAAM,WAAW,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;AAmDtD,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,MAAM,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,YAAY,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,uCAAuC;IACvC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAE,iBAAsB,GAAG,YAAY,CAuN5F"}

package/dist/ui/hooks/useUsage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * useUsage Hook
+ *
+ * React hook for managing usage tracking in the UI
+ */
+import { type LimitCheckResult, type UsageReport } from '../../core/tier/usage-service.js';
+export interface UseUsageReturn {
+    usage: UsageReport | null;
+    loading: boolean;
+    error: string | null;
+    refresh: () => Promise<void>;
+}
+export declare function useUsage(): UseUsageReturn;
+export interface UseCheckLimitReturn {
+    checkLimit: (action: 'check' | 'download' | 'sync') => Promise<LimitCheckResult>;
+    recordUsage: (action: 'check' | 'download' | 'sync') => Promise<void>;
+}
+export declare function useCheckLimit(): UseCheckLimitReturn;
+//# sourceMappingURL=useUsage.d.ts.map

package/dist/ui/hooks/useUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUsage.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useUsage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAmB,MAAM,kCAAkC,CAAC;AAE5G,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAgB,QAAQ,IAAI,cAAc,CAyBzC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjF,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,wBAAgB,aAAa,IAAI,mBAAmB,CAcnD"}

package/dist/ui/hooks/useVirtualList.d.ts

@@ -0,0 +1,87 @@
+/**
+ * useVirtualList Hook
+ *
+ * Enhanced virtual list hook with overscan support for smoother scrolling
+ * and pinToEnd mode for log tailing. This is the successor to useScrollableList.
+ *
+ * @since v1.9.0
+ * @since v1.50.6 - Added scrollMode option for center-scroll behavior
+ */
+/**
+ * Scroll mode for the virtual list
+ * - 'item-by-item': Scrolls one item at a time when selection reaches edge (default)
+ * - 'center': Keeps selection centered in viewport (Claude Code style)
+ */
+export type ScrollMode = 'item-by-item' | 'center';
+/**
+ * Options for the useVirtualList hook
+ */
+export interface VirtualListOptions {
+    /** Total number of items in the list */
+    itemCount: number;
+    /** Number of visible items in the viewport */
+    viewportHeight: number;
+    /** Currently selected/focused index */
+    selectedIndex: number;
+    /** Number of extra items to render above/below viewport (default: 2) */
+    overscan?: number;
+    /** Pin scroll to end of list - useful for log tailing (default: false) */
+    pinToEnd?: boolean;
+    /** Dependencies that should reset scroll position when changed */
+    resetDeps?: unknown[];
+    /** Scroll mode: 'item-by-item' (default) or 'center' (v1.50.6) */
+    scrollMode?: ScrollMode;
+}
+/**
+ * State returned by the useVirtualList hook
+ */
+export interface VirtualListState {
+    /** First item index to render (includes overscan) */
+    startIndex: number;
+    /** Last item index to render - exclusive (includes overscan) */
+    endIndex: number;
+    /** Number of items hidden above the logical viewport */
+    hiddenAbove: number;
+    /** Number of items hidden below the logical viewport */
+    hiddenBelow: number;
+    /** Current scroll offset (first visible item index, not including overscan) */
+    scrollOffset: number;
+    /** Number of items in the logical viewport */
+    visibleCount: number;
+    /** Function to scroll to a specific index */
+    scrollTo: (index: number) => void;
+}
+/**
+ * Pure function to calculate new scroll offset based on selection
+ * Compatible with useScrollableList for easy migration.
+ *
+ * @param prevOffset - Previous scroll offset
+ * @param selectedIndex - Currently selected item index
+ * @param itemCount - Total number of items
+ * @param viewportHeight - Number of visible items
+ * @param scrollMode - Scroll mode: 'item-by-item' or 'center' (v1.50.6)
+ */
+export declare function calculateScrollOffsetWithOverscan(prevOffset: number, selectedIndex: number, itemCount: number, viewportHeight: number, scrollMode?: ScrollMode): number;
+/**
+ * Pure function to calculate visible window with overscan support
+ */
+export declare function calculateVirtualWindow(scrollOffset: number, options: VirtualListOptions): Omit<VirtualListState, 'scrollTo'>;
+/**
+ * Hook for managing virtual list state with overscan and pinToEnd support
+ *
+ * @example
+ * ```tsx
+ * const { startIndex, endIndex, scrollTo } = useVirtualList({
+ *   itemCount: items.length,
+ *   viewportHeight: 10,
+ *   selectedIndex,
+ *   overscan: 2,
+ *   resetDeps: [searchQuery],
+ * });
+ *
+ * const visibleItems = items.slice(startIndex, endIndex);
+ * ```
+ */
+export declare function useVirtualList(options: VirtualListOptions): VirtualListState;
+export default useVirtualList;
+//# sourceMappingURL=useVirtualList.d.ts.map

package/dist/ui/hooks/useVirtualList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../../src/ui/hooks/useVirtualList.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,kEAAkE;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAE,UAA2B,GAAG,MAAM,CAsBvL;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,CA+C5H;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAmE5E;AAED,eAAe,cAAc,CAAC"}

package/dist/ui/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * UI Module Exports
+ *
+ * Main entry point for the Terminal UI
+ */
+export { App, type AppProps } from './App.js';
+export { ThemeProvider, useTheme, getTheme, defaultTheme, mergeTheme, type ThemeProviderProps, } from './themes/index.js';
+export type { Theme, ThemeColors, ThemeSpacing, ThemeContextValue } from './themes/types.js';
+export { Header, StatusBar, Spinner, ProgressBar, MiniProgress, Card, Table, SelectableList, Notification, NotificationList, HelpOverlay, DEFAULT_SHORTCUTS, ErrorBoundary, type Tab, type HeaderProps, type StatusBarProps, type SpinnerType, type SpinnerProps, type ProgressBarProps, type MiniProgressProps, type CardProps, type TableColumn, type TableProps, type ListItem, type SelectableListProps, type NotificationType, type NotificationProps, type NotificationListProps, type Shortcut, type HelpOverlayProps, type ErrorBoundaryProps, } from './components/index.js';
+export { HomeView, ServersView, PluginsView, UpdatesView, ConfigView, type HomeViewProps, type ServersViewProps, type PluginsViewProps, type UpdatesViewProps, type ConfigViewProps, } from './views/index.js';
+export { useKeyboardNav, useTabNav, useNotifications, usePlugins, useServers, useUpdates, type UseKeyboardNavOptions, type KeyboardNavState, type UseTabNavOptions, type TabNavState, type AppNotification, type UseNotificationsOptions, type NotificationsState, type UsePluginsOptions, type PluginsState, type UseUpdatesOptions, type UpdatesState, type VersionDifference, type PluginComparison, type ServerStats, type ServersState, } from './hooks/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG7F,OAAO,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,QAAQ,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC"}

package/dist/ui/keyboard/accessibility-service.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Keyboard Accessibility Service
+ *
+ * Manages accessibility features like sticky keys, slow keys, and announcements.
+ *
+ * @since v1.58.5
+ */
+import type { AccessibilityConfig, Announcement } from './accessibility-types.js';
+/**
+ * Key event from keyboard
+ */
+export interface KeyEvent {
+    key: string;
+    type: 'keydown' | 'keyup';
+    modifiers: string[];
+    timestamp: number;
+}
+/**
+ * Processed key result
+ */
+export interface ProcessedKeyResult {
+    /** The key(s) to process */
+    key: string;
+    /** Active modifiers */
+    modifiers: string[];
+    /** Whether to process the key */
+    shouldProcess: boolean;
+    /** Reason if not processing */
+    reason?: 'slow-key-pending' | 'repeat-blocked';
+    /** Visual feedback to show */
+    visualFeedback?: string[];
+    /** Announcement to make */
+    announcement?: Announcement;
+}
+/**
+ * Accessibility Service
+ */
+export declare class AccessibilityService {
+    private config;
+    private stickyState;
+    private slowState;
+    private repeatState;
+    private visualState;
+    private announcements;
+    private onVisualFeedback?;
+    private onAnnounce?;
+    private onKeyAccepted?;
+    constructor(config?: Partial<AccessibilityConfig>, callbacks?: {
+        onVisualFeedback?: (keys: string[], isFlash: boolean) => void;
+        onAnnounce?: (message: string) => void;
+        onKeyAccepted?: (key: string, modifiers: string[]) => void;
+    });
+    /**
+     * Process a key event
+     */
+    processKey(event: KeyEvent): ProcessedKeyResult;
+    /**
+     * Handle sticky keys
+     */
+    private handleStickyKeys;
+    /**
+     * Get current active modifiers
+     */
+    private getCurrentModifiers;
+    /**
+     * Clear non-locked sticky modifiers
+     */
+    private clearStickyModifiers;
+    /**
+     * Reset sticky timeout
+     */
+    private resetStickyTimeout;
+    /**
+     * Get modifier visual feedback
+     */
+    private getModifierVisualFeedback;
+    /**
+     * Handle slow keys
+     */
+    private handleSlowKeys;
+    /**
+     * Clear slow key state
+     */
+    private clearSlowKeyState;
+    /**
+     * Handle key repeat
+     */
+    private handleKeyRepeat;
+    /**
+     * Handle key up (for repeat state)
+     */
+    handleKeyUp(key: string): void;
+    /**
+     * Show key press visual
+     */
+    private showKeyPress;
+    /**
+     * Flash screen
+     */
+    flash(): void;
+    /**
+     * Announce a message
+     */
+    announce(message: string, priority?: number, interrupt?: boolean): void;
+    /**
+     * Announce navigation
+     */
+    announceNavigation(view: string, item?: string): void;
+    /**
+     * Announce action result
+     */
+    announceAction(action: string, result: 'success' | 'failure' | 'cancelled', details?: string): void;
+    /**
+     * Announce error
+     */
+    announceError(error: string): void;
+    /**
+     * Remap key for single-hand mode
+     */
+    private remapForSingleHand;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<AccessibilityConfig>): void;
+    /**
+     * Get configuration
+     */
+    getConfig(): AccessibilityConfig;
+    /**
+     * Enable/disable specific feature
+     */
+    setFeatureEnabled(feature: keyof AccessibilityConfig, enabled: boolean): void;
+    /**
+     * Check tier access
+     */
+    private isTierAllowed;
+    /**
+     * Reset all states
+     */
+    reset(): void;
+}
+/**
+ * Create an accessibility service instance
+ */
+export declare function createAccessibilityService(config?: Partial<AccessibilityConfig>, callbacks?: {
+    onVisualFeedback?: (keys: string[], isFlash: boolean) => void;
+    onAnnounce?: (message: string) => void;
+    onKeyAccepted?: (key: string, modifiers: string[]) => void;
+}): AccessibilityService;
+//# sourceMappingURL=accessibility-service.d.ts.map

package/dist/ui/keyboard/accessibility-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-service.d.ts","sourceRoot":"","sources":["../../../src/ui/keyboard/accessibility-service.ts"],"names":[],"mappings":"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"}