@brftech/filex-core 0.41.2 → 0.42.0

package/dist/index.d.ts

@@ -484,6 +484,7 @@ readonly authHeaders?: (() => Record<string, string> | Promise<Record<string, st
 readonly authCredentials?: RequestCredentials | undefined;
 readonly e2eActive?: boolean | undefined;
 readonly bodyOverride?: boolean | undefined;
+readonly openTrigger?: "single" | "double" | undefined;
 } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
 $attrs: Attrs;
 $refs: {
@@ -548,6 +549,7 @@ authHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
 authCredentials?: RequestCredentials;
 e2eActive?: boolean;
 bodyOverride?: boolean;
+openTrigger?: "single" | "double";
 }> & Readonly<{
 [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
 }>, {
@@ -566,6 +568,7 @@ trashVisible: boolean;
 showCrumbs: boolean;
 showFilterBar: boolean;
 showViewSwitcher: boolean;
+openTrigger: "single" | "double";
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
 beforeCreate?: (() => void) | (() => void)[];
 created?: (() => void) | (() => void)[];
@@ -655,6 +658,7 @@ trashVisible: boolean;
 showCrumbs: boolean;
 showFilterBar: boolean;
 showViewSwitcher: boolean;
+openTrigger: "single" | "double";
 }> & Omit<Readonly<{
 paneId: PaneId;
 api: FileApi;
@@ -706,9 +710,10 @@ authHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
 authCredentials?: RequestCredentials;
 e2eActive?: boolean;
 bodyOverride?: boolean;
+openTrigger?: "single" | "double";
 }> & Readonly<{
 [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
-}>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher")> & {
+}>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher" | "openTrigger")> & {
 reload: () => Promise<void>;
 goUp: () => void;
 getPath: () => string;
@@ -780,6 +785,7 @@ readonly authHeaders?: (() => Record<string, string> | Promise<Record<string, st
 readonly authCredentials?: RequestCredentials | undefined;
 readonly e2eActive?: boolean | undefined;
 readonly bodyOverride?: boolean | undefined;
+readonly openTrigger?: "single" | "double" | undefined;
 } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
 $attrs: Attrs;
 $refs: {
@@ -844,6 +850,7 @@ authHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
 authCredentials?: RequestCredentials;
 e2eActive?: boolean;
 bodyOverride?: boolean;
+openTrigger?: "single" | "double";
 }> & Readonly<{
 [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
 }>, {
@@ -862,6 +869,7 @@ trashVisible: boolean;
 showCrumbs: boolean;
 showFilterBar: boolean;
 showViewSwitcher: boolean;
+openTrigger: "single" | "double";
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
 beforeCreate?: (() => void) | (() => void)[];
 created?: (() => void) | (() => void)[];
@@ -951,6 +959,7 @@ trashVisible: boolean;
 showCrumbs: boolean;
 showFilterBar: boolean;
 showViewSwitcher: boolean;
+openTrigger: "single" | "double";
 }> & Omit<Readonly<{
 paneId: PaneId;
 api: FileApi;
@@ -1002,9 +1011,10 @@ authHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
 authCredentials?: RequestCredentials;
 e2eActive?: boolean;
 bodyOverride?: boolean;
+openTrigger?: "single" | "double";
 }> & Readonly<{
 [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
-}>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher")> & {
+}>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher" | "openTrigger")> & {
 reload: () => Promise<void>;
 goUp: () => void;
 getPath: () => string;
@@ -1081,6 +1091,7 @@ trashVisible: boolean;
 showCrumbs: boolean;
 showFilterBar: boolean;
 showViewSwitcher: boolean;
+openTrigger: "single" | "double";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
 
 declare type __VLS_Props = {
@@ -1284,6 +1295,10 @@ declare type __VLS_Props_15 = {
      *  encrypted lock screen) — those are WINDOW states with no listing
      *  behind them, so the pane's own state chain must not also run. */
     bodyOverride?: boolean;
+    /** Mouse open gesture — 'double' (single selects, double opens) or
+     *  'single' (first click opens). Touch always opens on tap; the checkbox
+     *  always selects. See onViewClick. */
+    openTrigger?: 'single' | 'double';
 };
 
 declare type __VLS_Props_16 = {
@@ -1979,6 +1994,7 @@ declare function __VLS_template(): {
                 readonly authCredentials?: RequestCredentials | undefined;
                 readonly e2eActive?: boolean | undefined;
                 readonly bodyOverride?: boolean | undefined;
+                readonly openTrigger?: "single" | "double" | undefined;
             } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
             $attrs: Attrs;
             $refs: {
@@ -2043,6 +2059,7 @@ declare function __VLS_template(): {
             authCredentials?: RequestCredentials;
             e2eActive?: boolean;
             bodyOverride?: boolean;
+            openTrigger?: "single" | "double";
             }> & Readonly<{
             [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
             }>, {
@@ -2061,6 +2078,7 @@ declare function __VLS_template(): {
             showCrumbs: boolean;
             showFilterBar: boolean;
             showViewSwitcher: boolean;
+            openTrigger: "single" | "double";
             }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
                 beforeCreate?: (() => void) | (() => void)[];
                 created?: (() => void) | (() => void)[];
@@ -2150,6 +2168,7 @@ declare function __VLS_template(): {
             showCrumbs: boolean;
             showFilterBar: boolean;
             showViewSwitcher: boolean;
+            openTrigger: "single" | "double";
         }> & Omit<Readonly<{
             paneId: PaneId;
             api: FileApi;
@@ -2201,9 +2220,10 @@ declare function __VLS_template(): {
             authCredentials?: RequestCredentials;
             e2eActive?: boolean;
             bodyOverride?: boolean;
+            openTrigger?: "single" | "double";
         }> & Readonly<{
             [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
-        }>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher")> & {
+        }>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher" | "openTrigger")> & {
             reload: () => Promise<void>;
             goUp: () => void;
             getPath: () => string;
@@ -2275,6 +2295,7 @@ declare function __VLS_template(): {
                 readonly authCredentials?: RequestCredentials | undefined;
                 readonly e2eActive?: boolean | undefined;
                 readonly bodyOverride?: boolean | undefined;
+                readonly openTrigger?: "single" | "double" | undefined;
             } & VNodeProps & AllowedComponentProps & ComponentCustomProps;
             $attrs: Attrs;
             $refs: {
@@ -2339,6 +2360,7 @@ declare function __VLS_template(): {
             authCredentials?: RequestCredentials;
             e2eActive?: boolean;
             bodyOverride?: boolean;
+            openTrigger?: "single" | "double";
             }> & Readonly<{
             [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
             }>, {
@@ -2357,6 +2379,7 @@ declare function __VLS_template(): {
             showCrumbs: boolean;
             showFilterBar: boolean;
             showViewSwitcher: boolean;
+            openTrigger: "single" | "double";
             }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
                 beforeCreate?: (() => void) | (() => void)[];
                 created?: (() => void) | (() => void)[];
@@ -2446,6 +2469,7 @@ declare function __VLS_template(): {
             showCrumbs: boolean;
             showFilterBar: boolean;
             showViewSwitcher: boolean;
+            openTrigger: "single" | "double";
         }> & Omit<Readonly<{
             paneId: PaneId;
             api: FileApi;
@@ -2497,9 +2521,10 @@ declare function __VLS_template(): {
             authCredentials?: RequestCredentials;
             e2eActive?: boolean;
             bodyOverride?: boolean;
+            openTrigger?: "single" | "double";
         }> & Readonly<{
             [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
-        }>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher")> & {
+        }>, "reload" | "dirPerm" | "goUp" | "getPath" | "visibleNodes" | "loadFolder" | "rowCount" | "rowPaths" | ("trashVisible" | "showCrumbs" | "showFilterBar" | "showViewSwitcher" | "openTrigger")> & {
             reload: () => Promise<void>;
             goUp: () => void;
             getPath: () => string;
@@ -4188,6 +4213,36 @@ export declare interface ExplorerConfig {
      * Starred row that then disappears. A value here wins over the server's.
      */
     callerKind?: 'user' | 'app';
+    /**
+     * How a mouse opens an item.
+     *
+     *   'double' (default) — a single click SELECTS, a double click OPENS
+     *                        (classic desktop file-manager). This is a
+     *                        per-viewer preference the host may expose as a
+     *                        setting.
+     *   'single'           — a single click OPENS (the item is opened on the
+     *                        first click; the checkbox is still the one click
+     *                        that selects).
+     *
+     * ⚠ TOUCH is not governed by this: a finger tap always opens (the mobile
+     * convention, and there is no hover-to-select on a touchscreen). The
+     * checkbox always selects, on every device and in either mode. See
+     * FilePane.onViewClick + composables/useRowTouch.
+     */
+    openTrigger?: 'single' | 'double';
+    /**
+     * Hand the OPEN of a file to the host instead of opening the in-page
+     * preview/editor overlay. When true, opening a file emits `file-opened`
+     * (path + basename) and the explorer does NOT mount its own PreviewModal —
+     * the host decides what to do (the desktop app opens the file in its own
+     * window per document). Directories still navigate inline, and Space
+     * quick-look still peeks in-page. Default false (web/embeds preview inline).
+     *
+     * ⚠ Ignored inside an unlocked E2E-encrypted folder: the host window would
+     * fetch raw server bytes (ciphertext), so those keep the in-page decrypted
+     * preview.
+     */
+    openInHost?: boolean;
     /** Default view. */
     viewMode?: 'list' | 'grid';
     /**