@brftech/filex-core 0.41.4 → 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';
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brftech/filex-core",
-  "version": "0.41.4",
+  "version": "0.42.0",
   "description": "filex core — Vue 3 source of truth for the filex file manager (FileExplorer + ConnectionsPanel SFCs, composables, types)",
   "type": "module",
   "main": "./dist/filex-core.umd.cjs",

package/src/FileExplorer.vue

@@ -3090,6 +3090,16 @@ function openNode(n: FileNode) {
   }
   if (e2eLocked.value && n.type === 'file') return;
   /* /wiring:e2 */
+  // Host-owned open (desktop app): a file opens in the host's OWN window per
+  // document, not in the in-page overlay. Emit and stop — the host listens on
+  // `file-opened` and spawns the window. Directories still navigate inline
+  // (handled above); Space quick-look still peeks in-page. E2E files fell into
+  // the decrypted in-page branch above, so a host window never gets ciphertext.
+  if (props.config.openInHost && n.type === 'file') {
+    emit('file-opened', { path: n.path, basename: n.basename });
+    void markRecent(n);
+    return;
+  }
   // "Aç" / double-click contract: open in a new tab against the
   // standalone editor route, regardless of file type. The editor page
   // picks the right viewer (OnlyOffice for office, Monaco for code/
@@ -3204,6 +3214,13 @@ function openNodeInNewTab(n: FileNode) {
     return;
   }
   /* /wiring:e2 */
+  // Host-owned open (desktop): the context-menu "Aç" opens the host window
+  // too, so Enter/double-click/"Aç" are ONE open path — not a window here and
+  // a system-browser tab there. openNode carries the `file-opened` emit.
+  if (props.config.openInHost) {
+    openNode(n);
+    return;
+  }
   // RBAC: a viewer (no edit on this item) can't use the editable "Aç"
   // surface — drop to the read-only in-page preview instead.
   if (!permCanEdit((n.perm as string) ?? dirPerm.value)) {
@@ -6365,6 +6382,7 @@ function closeRecoveryKey() {
       :order="listingOrder"
       :view-mode="viewMode"
       :view-modes="allowedViewModes"
+      :open-trigger="props.config.openTrigger"
       :show-crumbs="navView !== 'home' /* Home has no address: its cards come
              from every folder in every storage, so a trail would have to name
              one */"
@@ -6843,6 +6861,7 @@ function closeRecoveryKey() {
       :nav-offers-trash="navOffersTrash"
       :view-mode="paneViewMode"
       :view-modes="allowedViewModes"
+      :open-trigger="props.config.openTrigger"
       :clipped="clippedPaths"
       :can-write="canWriteHere"
       :can-paste="!!clipboard.mode"

package/src/components/FilePane.vue

@@ -217,12 +217,18 @@ const props = withDefaults(
      *  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';
   }>(),
   {
     showCrumbs: true,
     showFilterBar: true,
     showViewSwitcher: true,
     trashVisible: true,
+    openTrigger: 'double',
   },
 );
 
@@ -458,22 +464,31 @@ function withinOpenGuard(): boolean {
 
 function onViewClick(n: FileNode, mod: ClickMod) {
   if (withinOpenGuard()) return;
-  /* issue #26, fourth round — the reporter's rule, on every device: "only
-   * clicking on checkbox selects it, any other click will open". The checkbox
-   * is the one click that reaches the selection; a click or tap anywhere else
-   * on the item opens it, Ctrl/Shift held or not, selection or not. See
-   * composables/useRowTouch. */
+  /* The checkbox is the one click that always reaches the selection — issue
+   * #26's rule, kept on every device and in either open mode. A shift-tick
+   * still extends the range; a plain tick toggles (ctrl: true). */
   if (mod.check) {
     emit('activate');
     emit('click-row', n, { ctrl: true, shift: mod.shift });
     return;
   }
-  openedAt = Date.now();
-  onRowOpen(n);
+  /* A finger tap always OPENS (the mobile convention — there is no
+   * hover-to-select on a touchscreen). For a mouse the host's `openTrigger`
+   * decides: 'single' opens on this click; 'double' (default) makes a single
+   * click SELECT and leaves opening to onViewDbl. issue #26's "any click
+   * opens" is `openTrigger: 'single'`. */
+  if (mod.touch || props.openTrigger === 'single') {
+    openedAt = Date.now();
+    onRowOpen(n);
+    return;
+  }
+  emit('activate');
+  emit('click-row', n, { ctrl: mod.ctrl, shift: mod.shift });
 }
 
 function onViewDbl(n: FileNode) {
   if (withinOpenGuard()) return;
+  openedAt = Date.now();
   onRowOpen(n);
 }
 

package/src/types/ExplorerConfig.ts

@@ -454,6 +454,38 @@ export interface ExplorerConfig {
   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';