@brftech/filex-core 0.41.4 → 0.42.1

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.1",
   "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

@@ -332,6 +332,10 @@ const files = ref<FileNode[]>([]);
 // RBAC effective level for the current directory ('' = ACL not enforced on
 // this storage → no gating). Drives which write/manage actions are offered.
 const dirPerm = ref<string>('');
+/** The listed folder sits on a read-only storage (`read_only` on the index
+ *  response). Folded into permCanEdit so every write affordance — toolbar,
+ *  sidebar menu, context menu, drop zone, editor mode — reads the same fact. */
+const dirReadOnly = ref(false);
 // The dead deep-link state: set to the requested path when a listing came
 // back 404 (folder doesn't exist) or 403 (RBAC-hidden — rendered identically
 // on purpose so a denied folder doesn't reveal that it exists). '' = none.
@@ -2034,6 +2038,14 @@ function onInspectorManage(n: FileNode) {
 // (the pre-RBAC default). Otherwise 'editor'/'owner' may write; only 'owner'
 // manages permissions. Enforcement is server-side; this just shapes the menu.
 function permCanEdit(p: string | undefined): boolean {
+  // A read-only storage refuses every write on the server (403 "storage is
+  // read-only") whatever level the ACL grants — an owner of a read-only mount
+  // is an owner who cannot write. Say so here rather than after the click:
+  // until this line the toolbar offered New folder / Upload and the sidebar's
+  // "+ New" menu on a read-only mount, and the user found out from the error
+  // (issue #30). The level itself is left alone: 'owner' still opens the
+  // permissions panel, sharing a read-only file is still allowed.
+  if (dirReadOnly.value) return false;
   // undefined = ACL not enforced (dev / unwired) → full access. In production
   // the backend always sends a level; 'none'/'viewer' cannot write, only
   // 'editor'/'owner' can.
@@ -2350,6 +2362,7 @@ async function load(path?: string) {
     adapter.value = resp.adapter;
     dirname.value = resp.dirname;
     dirPerm.value = (resp.perm as string) || '';
+    dirReadOnly.value = resp.read_only === true;
     /* wiring:e2 — backend tells us when this dir sits inside an encrypted
        subtree; '' resets on every plain folder. Drives the lock screen. */
     e2eRoot.value = typeof resp.e2e_root === 'string' ? resp.e2e_root : '';
@@ -3090,6 +3103,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 +3227,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 +6395,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 +6874,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/components/HomeView.vue

@@ -144,9 +144,12 @@ const storageTile = fileIconTile({ type: 'dir', mime_type: 'inode/storage' });
  * with the wrong size line says something false.
  */
 function storageCaption(s: HomeStorage): string {
-  return typeof s.usedBytes === 'number' && s.usedBytes >= 0
-    ? t('drive.storage.used_unlimited', { used: formatSize(s.usedBytes) })
-    : t('conn.guide.storage');
+  const base =
+    typeof s.usedBytes === 'number' && s.usedBytes >= 0
+      ? t('drive.storage.used_unlimited', { used: formatSize(s.usedBytes) })
+      : t('conn.guide.storage');
+  // A read-only mount says so on its card too (issue #30).
+  return s.readOnly ? `${base} · ${t('sidenav.storage.readOnly')}` : base;
 }
 
 /**

package/src/components/SideNav.vue

@@ -242,6 +242,16 @@ const views = computed(() => {
 
 const writable = computed(() => props.canWrite !== false);
 
+/**
+ * The storage the listing is in is mounted read-only. Its "+ New" menu is not
+ * disabled but GONE: on a read-only mount there is no folder where any of
+ * its rows could ever work, and a disabled menu invites the question a menu
+ * cannot answer. The row itself says why — see the tag on it (issue #30).
+ */
+const activeReadOnly = computed(
+  () => !!props.activeStorage && props.storages.some((s) => s.name === props.activeStorage && s.readOnly === true),
+);
+
 /**
  * Which row reads as the one you are standing on.
  *
@@ -426,6 +436,7 @@ const toggleLabel = computed(() => t('sidenav.close'));
            stand here behind `v-if="!newMenu"` (Upload + New folder) is gone:
            both verbs are the first two rows of this menu. -->
       <button
+        v-if="!activeReadOnly"
         ref="newBtnEl"
         type="button"
         class="fe-sidenav__new"
@@ -693,6 +704,17 @@ const toggleLabel = computed(() => t('sidenav.close'));
                 :aria-label="t('sidenav.storage.shared')"
                 >{{ t('sidenav.storage.shared') }}</span
               >
+              <!-- A read-only mount says so on the row, where the user looks
+                   for it. The admin list had an "RO" badge; the people it
+                   applied to never saw one (issue #30). -->
+              <span
+                v-if="showLabels && s.readOnly"
+                class="fe-sidenav__tag"
+                role="img"
+                data-testid="sidenav-storage-readonly"
+                :aria-label="t('sidenav.storage.readOnly')"
+                >{{ t('sidenav.storage.readOnly') }}</span
+              >
             </button>
           </li>
         </ul>

package/src/locales/en.ts

@@ -1047,6 +1047,7 @@ export const en: Record<string, string> = {
   // "expand" would promise a width change to something that has no width.
   'sidenav.open': 'Open navigation',
   'sidenav.storage.shared': 'Shared',
+  'sidenav.storage.readOnly': 'Read-only',
   // ⚠ `toolbar.nav` is GONE, and nothing replaced it. It was the one label on
   // the panel's collapse control, first as the noun "Navigation" — which names
   // the panel and never says the button does anything to it, so the owner

package/src/locales/tr.ts

@@ -1047,6 +1047,7 @@ export const tr: Record<string, string> = {
   // genişliği büyütmeyi vaat ederdi.
   'sidenav.open': 'Gezintiyi aç',
   'sidenav.storage.shared': 'Paylaşılan',
+  'sidenav.storage.readOnly': 'Salt okunur',
   // ⚠ `toolbar.nav` KALDIRILDI, yerine bir şey konmadı — bkz. en.ts'teki not.
   // Paneli daraltan tek denetimin etiketiydi; önce "Gezinti" (panelin adı,
   // düğmenin ne yaptığını söylemiyor), sonra "Gezintiyi göster/gizle" (sabit

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';