@brftech/filex-core 0.41.1 → 0.41.4

package/dist/index.d.ts

@@ -5263,6 +5263,37 @@ export declare type OperationsStore = ReturnType<typeof useOperations>;
 
 export declare type OperationStatus = 'running' | 'done' | 'error' | 'aborted';
 
+/** 0–100, or `null` when there is no honest number to draw. */
+export declare function opPercent(op: OpProgressLike): number | null;
+
+/**
+ * opProgress — the one rule for "how far along is this queued operation".
+ *
+ * Both progress surfaces read it: the explorer's operations center
+ * (PendingOpsTray → OperationsCenter) and the admin app's bottom-right tray.
+ * Two copies of this rule are how one tray starts saying something the other
+ * does not (filex lesson #119).
+ *
+ * Issue #27: a queued op counts SOURCES, so moving one large file — or one
+ * folder of a thousand files — is "0 of 1" until the very end. Drawn as a
+ * percentage that is a bar frozen at 0% that then vanishes, which the reporter
+ * read as stuck. So:
+ *
+ *   - a running cross-storage transfer reports bytes (`bytes_done` /
+ *     `bytes_total`); when the total is known that is the percentage;
+ *   - bytes moving with no total yet, or a single source with nothing but a
+ *     source count, has NO honest percentage: `null`, and the surface shows
+ *     an indeterminate indicator instead of a fake 0%;
+ *   - several sources still report per source, as before.
+ */
+export declare interface OpProgressLike {
+    status: string;
+    progress_total: number;
+    progress_done: number;
+    bytes_total?: number;
+    bytes_done?: number;
+}
+
 declare type PaneId = 'main' | 'split';
 
 /**
@@ -5294,6 +5325,9 @@ export declare interface PendingOp {
     status: 'pending' | 'running' | 'done' | 'error';
     progress_total: number;
     progress_done: number;
+    /** Running cross-storage transfer's bytes (issue #27); absent otherwise. */
+    bytes_total?: number;
+    bytes_done?: number;
     target_path: string | null;
     source_dir: string | null;
     source_count: number;
@@ -7012,6 +7046,8 @@ export declare function usePendingOps(config: ExplorerConfig, api: FileApi, opts
     status: "pending" | "running" | "done" | "error";
     progress_total: number;
     progress_done: number;
+    bytes_total?: number | undefined;
+    bytes_done?: number | undefined;
     target_path: string | null;
     source_dir: string | null;
     source_count: number;
@@ -7025,6 +7061,8 @@ export declare function usePendingOps(config: ExplorerConfig, api: FileApi, opts
     status: "pending" | "running" | "done" | "error";
     progress_total: number;
     progress_done: number;
+    bytes_total?: number | undefined;
+    bytes_done?: number | undefined;
     target_path: string | null;
     source_dir: string | null;
     source_count: number;