@yogiswara/honcho-editor-ui 3.3.4 → 3.4.1

package/dist/hooks/useAdjustmentHistoryBatch.d.ts

@@ -1,4 +1,4 @@
-import { AdjustmentState, Controller } from './editor/type';
+import { AdjustmentState, Controller, ColorAdjustment } from './editor/type';
 export interface HistoryAdjustmentBatch {
     imageId: string;
     currentHistoryEntryId: string;
@@ -43,17 +43,17 @@ interface BatchHistoryOptions {
     devWarnings?: boolean;
     /** Default adjustment state for new images */
     defaultAdjustmentState?: Partial<AdjustmentState>;
-    /** Controller for backend operations */
-    controller?: Controller;
-    /** Firebase UID for backend operations */
-    firebaseUid?: string;
-    /** Event ID for backend operations */
-    eventId?: string;
 }
 /**
- * Information about the current batch history state
+ * State for batch history management
  */
-export interface BatchHistoryInfo {
+export interface BatchHistoryState {
+    /** Current batch adjustment state */
+    currentBatch: BatchAdjustmentState;
+    /** Currently selected image IDs */
+    selectedIds: string[];
+    /** All image IDs being managed */
+    allImageIds: string[];
     /** Whether undo operation is available for selected images */
     canUndo: boolean;
     /** Whether redo operation is available for selected images */
@@ -76,21 +76,31 @@ export interface BatchHistoryActions {
     /** Apply adjustment deltas to selected images */
     adjustSelected: (delta: Partial<AdjustmentState>) => void;
     /** Apply preset values directly to selected images (preserves history) */
-    adjustSelectedWithPreset: (presetAdjustments: AdjustmentState) => void;
+    adjustSelectedWithPreset: (presetAdjustments: AdjustmentState, presetId: string) => void;
+    /** Apply partial adjustment values directly to selected images (only updates specified properties) */
+    adjustSelectedWithPaste: (adjustments: Partial<AdjustmentState>) => void;
     /** Undo last changes to selected images */
     undo: () => void;
     /** Redo next changes to selected images */
     redo: () => void;
-    /** Reset selected images to default state */
+    /** Reset selected images to default state (creates new history entry that can be undone) */
     reset: (imageIds?: string[]) => void;
     /** Set selection with optional initial adjustments per image */
     setSelection: (configs: ImageAdjustmentConfig[]) => void;
+    /** Initialize images from pagination data without backend sync */
+    initializeFromPagination: (configs: ImageAdjustmentConfig[]) => void;
     /** Sync/replace adjustment for images (clears their history) */
     syncAdjustment: (configs: ImageAdjustmentConfig[]) => void;
     /** Check for gallery updates and sync history for updated images */
     syncGalleryUpdates: () => Promise<void>;
+    /** Sync history for a specific image from backend */
+    syncFromBackend: (imageId: string) => Promise<void>;
+    /** Sync history for all images that have updates since last timestamp */
+    syncHistoryFromBackendAll: () => Promise<void>;
+    /** Clear the synced history cache (forces re-sync on next selection) */
+    clearSyncedHistoryCache: () => void;
     /** Add or remove image from selection */
-    toggleSelection: (imageId: string) => void;
+    toggleSelection: (imageId: string) => Promise<void>;
     /** Select all images */
     selectAll: () => void;
     /** Clear selection */
@@ -103,32 +113,21 @@ export interface BatchHistoryActions {
     getCurrentBatch: () => BatchAdjustmentState;
     /** Sync entire batch state */
     syncBatch: (newBatch: BatchAdjustmentState, targetIndex?: number) => void;
-}
-/**
- * Configuration actions for runtime adjustment
- */
-export interface BatchHistoryConfig {
     /** Set maximum history size */
     setMaxSize: (size: number | 'unlimited') => void;
     /** Get current memory usage estimate */
     getMemoryUsage: () => number;
+    /** Update state from socket - syncs history if image is selected, updates state if not selected */
+    updateFromSocket: (imageId: string, adjustmentTaskId: string, adjustment: ColorAdjustment, preset_id?: string) => Promise<void>;
 }
 /**
  * Return type for the useAdjustmentHistoryBatch hook
  */
 export interface UseAdjustmentHistoryBatchReturn {
-    /** Current batch adjustment state */
-    currentBatch: BatchAdjustmentState;
-    /** Currently selected image IDs */
-    selectedIds: string[];
-    /** All image IDs being managed */
-    allImageIds: string[];
-    /** Information about history state */
-    historyInfo: BatchHistoryInfo;
-    /** Available history actions */
+    /** All state information */
+    state: BatchHistoryState;
+    /** Available actions */
     actions: BatchHistoryActions;
-    /** Configuration options */
-    config: BatchHistoryConfig;
 }
 /**
  * Advanced hook for managing batch AdjustmentState history with selective undo/redo functionality.
@@ -147,7 +146,7 @@ export interface UseAdjustmentHistoryBatchReturn {
  *
  * **Typical Usage Flow:**
  * ```typescript
- * const { actions, currentBatch, selectedIds } = useAdjustmentHistoryBatch();
+ * const { state, actions } = useAdjustmentHistoryBatch(controller, firebaseUid, eventId);
  *
  * // Select images (new images get default state automatically)
  * actions.setSelection(['img1', 'img2', 'img3']);
@@ -170,8 +169,11 @@ export interface UseAdjustmentHistoryBatchReturn {
  * - `currentBatch.allImages`: All images that have been selected/adjusted (persistent)
  * - `selectedIds`: Array of currently selected image IDs
  *
+ * @param controller - Controller for backend operations
+ * @param firebaseUid - Firebase UID for backend operations
+ * @param eventId - Event ID for backend operations
  * @param options - Configuration options for history behavior
- * @returns Object with current batch, selection, history info, actions, and config
+ * @returns Object with state and actions
  */
-export declare function useAdjustmentHistoryBatch(options?: BatchHistoryOptions): UseAdjustmentHistoryBatchReturn;
+export declare function useAdjustmentHistoryBatch(controller: Controller, firebaseUid: string, eventId: string, options?: BatchHistoryOptions): UseAdjustmentHistoryBatchReturn;
 export {};