@brftech/filex-core 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -1472,6 +1472,7 @@ export declare interface ShortcutHandlers {
     onGoUp?: () => void;
     onShowHelp?: () => void;
     onToggleInspector?: () => void;
+    onToggleHidden?: () => void;
     onQuickLook?: () => void;
     onTabNew?: () => void;
     onTabClose?: () => void;

package/package.json

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

package/src/FileExplorer.vue

@@ -90,7 +90,9 @@ import {
    internal-entry filter + virtual `.trash` row must be identical in both
    panes or split view shows mismatched rows). */
 import {
-  filterInternalEntries,
+  filterListing,
+  showHiddenFiles,
+  setShowHiddenFiles,
   injectTrashRow,
   hydrateTrashRow as hydrateTrashRowShared,
 } from './lib/listing';
@@ -274,12 +276,26 @@ const trashMode = ref(false);
 const trashOrigin = ref<string>('');
 const trashActive = computed(() => trashMode.value);
 
+// When the caller can see exactly ONE storage, the multi-storage root is a
+// one-row list that carries no information — the user clicks through it every
+// single time. Treat that storage as the floor instead: open it directly and
+// stop offering an "up" that only leads back to the one row.
+//
+// Empty string means "not in that situation" (single-storage mode, or more
+// than one storage visible), which leaves every existing path untouched.
+const soleStorageName = computed(() => {
+  if (!multiStorageRoot.value) return '';
+  const list = props.config.storages ?? [];
+  return list.length === 1 ? list[0].name : '';
+});
+
 // canGoUp/goUp — toolbar's "↑ Up one level" button. In single-storage
 // mode "" means the storage root; in multi-storage mode "" means
 // the global root (storage list). Both → no parent → button hidden.
 const canGoUp = computed(() => {
   const p = (currentPath.value ?? '').replace(/^\/+|\/+$/g, '');
   if (rootFloor && p === rootFloor) return false; // at the confined floor — nowhere above
+  if (soleStorageName.value && p === soleStorageName.value) return false;
   return p.length > 0;
 });
 
@@ -300,6 +316,8 @@ function goUp() {
   }
   const cur = (currentPath.value ?? '').replace(/^\/+|\/+$/g, '');
   if (!cur || cur === rootFloor) return;
+  // The button is hidden here, but Alt+↑ / Backspace still route through.
+  if (soleStorageName.value && cur === soleStorageName.value) return;
   const idx = cur.lastIndexOf('/');
   let parent = idx === -1 ? '' : cur.slice(0, idx);
   // Never step above the confined floor.
@@ -674,6 +692,16 @@ function virtualStorageRows(): FileNode[] {
   } as unknown as FileNode));
 }
 
+// Flip dot-file visibility. Both panes filter at load time rather than in a
+// computed, so the listings are re-fetched instead of re-filtered — that keeps
+// selection and the operations that read `files` working on exactly what is
+// on screen.
+function toggleHiddenFiles() {
+  setShowHiddenFiles(!showHiddenFiles.value);
+  void load();
+  void splitPaneRef.value?.reload();
+}
+
 async function load(path?: string) {
   loading.value = true;
   // Any normal navigation exits trash mode (the trash view is entered only
@@ -694,6 +722,10 @@ async function load(path?: string) {
     // Multi-storage virtual root — synthesize a list of storages
     // instead of calling the backend.
     if (multiStorageRoot.value && !virtualToWire(requested)) {
+      // One visible storage → skip the one-row list and open it. Recursion is
+      // bounded: the recursive call carries a non-empty path, so
+      // virtualToWire() resolves and this branch is not re-entered.
+      if (soleStorageName.value) return await load(soleStorageName.value);
       currentPath.value = '';
       adapter.value = '';
       dirname.value = '';
@@ -716,7 +748,7 @@ async function load(path?: string) {
        subtree; '' resets on every plain folder. Drives the lock screen. */
     e2eRoot.value = typeof resp.e2e_root === 'string' ? resp.e2e_root : '';
     /* /wiring:e2 */
-    files.value = filterInternalEntries(resp.files);
+    files.value = filterListing(resp.files);
     // Inject virtual `.trash` entry at root only — shared helper so the
     // split-view secondary pane shows the exact same row (no row-offset).
     if (injectTrashRow(files.value, resp.adapter, resp.dirname, props.config.trashVisible !== false)) {
@@ -1147,6 +1179,7 @@ useKeyboardShortcuts(rootEl, {
   },
   /* /cila:c wiring */
   onQuickLook: () => quickLookToggle() /* wiring:c2 */,
+  onToggleHidden: () => toggleHiddenFiles(),
   onToggleInspector: () => toggleInspector() /* koru:k1 */,
   /* wiring:d1 — sekme aksiyonları (registry: tab-new/close/next/prev) */
   onTabNew: () => newTabHere(),
@@ -1463,10 +1496,20 @@ const contextActions = computed<ContextAction[]>(() => {
   // Empty background right-click: folder-level actions only. Viewers (no edit
   // on this dir) get nothing here.
   if (!any) {
-    if (!permCanEdit(dirPerm.value)) return [];
+    // Showing hidden files is a VIEW preference, so it stays available to
+    // viewers too — the edit gate below only covers the mutating actions.
+    const view: ContextAction[] = [
+      {
+        key: 'toggle-hidden',
+        label: showHiddenFiles.value ? t('ctx.hide_hidden') : t('ctx.show_hidden'),
+        icon: showHiddenFiles.value ? '🙈' : '👁',
+      },
+    ];
+    if (!permCanEdit(dirPerm.value)) return view;
     return [
       { key: 'new-folder', label: t('toolbar.new_folder'), icon: '📁' },
       { key: 'paste', label: t('ctx.paste'), icon: '📋', disabled: !clipboard.value.mode },
+      ...view,
     ];
   }
 
@@ -1633,6 +1676,9 @@ async function dispatchItemAction(key: string, targets: FileNode[]) {
     case 'restore':
       if (targets.length > 0) await restoreSelection(targets);
       break;
+    case 'toggle-hidden':
+      toggleHiddenFiles();
+      break;
     case 'new-folder':
       mutationInPane.value = ctxMode.value === 'pane'; /* ui-fix */
       showNewFolder.value = true;

package/src/components/SecondaryPane.vue

@@ -21,7 +21,7 @@ import type { FileApi } from '../composables/useFileApi';
 import type { FileNode, ViewMode } from '../types/FileNode';
 import type { LocaleCode } from '../types/ExplorerConfig';
 import { useLocale } from '../composables/useLocale';
-import { filterInternalEntries, injectTrashRow, hydrateTrashRow } from '../lib/listing';
+import { filterListing, injectTrashRow, hydrateTrashRow } from '../lib/listing';
 import ListView from './ListView.vue';
 import GridView from './GridView.vue';
 import GalleryView from './GalleryView.vue';
@@ -110,7 +110,7 @@ async function loadPane(target?: string): Promise<void> {
     const resp = await props.api.index(props.qualify(requested));
     // Same internal-entry filter + virtual `.trash` row as the main panel
     // (shared helpers → both split panes list identical rows, no offset).
-    files.value = filterInternalEntries(resp.files);
+    files.value = filterListing(resp.files);
     if (injectTrashRow(files.value, resp.adapter, resp.dirname, props.trashVisible !== false)) {
       void hydrateTrashRow(files.value, resp.adapter, props.api);
     }

package/src/composables/useKeyboardShortcuts.ts

@@ -37,6 +37,7 @@ export interface ShortcutHandlers {
   onGoUp?: () => void; // Alt+Up / Backspace (when nothing selected)
   onShowHelp?: () => void; // ? (Shift+/ on most layouts)
   onToggleInspector?: () => void; // i (koru:k1 details panel)
+  onToggleHidden?: () => void; // Ctrl+Shift+. — dot-file visibility
   onQuickLook?: () => void; // Space (wiring:c2 quick-look overlay)
   /* wiring:d1 — tab strip actions */
   onTabNew?: () => void; // Ctrl+T
@@ -85,6 +86,7 @@ export const SHORTCUT_ACTIONS: ShortcutActionDef[] = [
   { id: 'close', defaultCombo: 'Esc', customizable: false, prevent: false, inForms: true, labelKey: 'shortcuts.close', groupKey: 'shortcuts.group.nav' },
   { id: 'inspector', defaultCombo: 'I', labelKey: 'shortcuts.inspector', groupKey: 'shortcuts.group.nav' } /* koru:k1 */,
   { id: 'help', defaultCombo: '?', labelKey: 'shortcuts.help', groupKey: 'shortcuts.group.nav' },
+  { id: 'toggle-hidden', defaultCombo: 'Ctrl+Shift+.', labelKey: 'shortcuts.toggle_hidden', groupKey: 'shortcuts.group.nav' },
   // Selection
   { id: 'select-all', defaultCombo: 'Ctrl+A', labelKey: 'shortcuts.select_all', groupKey: 'shortcuts.group.selection' },
   // File operations
@@ -112,6 +114,7 @@ const HANDLER_KEY: Record<string, keyof ShortcutHandlers> = {
   quicklook: 'onQuickLook',
   close: 'onClose',
   inspector: 'onToggleInspector',
+  'toggle-hidden': 'onToggleHidden',
   help: 'onShowHelp',
   'select-all': 'onSelectAll',
   rename: 'onRename',

package/src/lib/listing.ts

@@ -6,6 +6,8 @@
  * must be identical in both, otherwise split view shows mismatched rows
  * (the trash row missing on one side → visible row-offset).
  */
+import { ref } from 'vue';
+
 import type { FileNode } from '../types/FileNode';
 import { E2E_MARKER_NAME } from './e2ecrypto';
 
@@ -31,6 +33,52 @@ export function filterInternalEntries(files: FileNode[]): FileNode[] {
   });
 }
 
+const SHOW_HIDDEN_LS_KEY = 'filex.showHidden';
+
+function readShowHidden(): boolean {
+  try {
+    return localStorage.getItem(SHOW_HIDDEN_LS_KEY) === '1';
+  } catch {
+    return false; // private mode / no storage → hidden, the safe default
+  }
+}
+
+/**
+ * Whether dot-prefixed entries are listed. Off by default, like every other
+ * file manager. Shared by both panes so split view can't disagree with itself.
+ */
+export const showHiddenFiles = ref(readShowHidden());
+
+export function setShowHiddenFiles(v: boolean): void {
+  showHiddenFiles.value = v;
+  try {
+    localStorage.setItem(SHOW_HIDDEN_LS_KEY, v ? '1' : '0');
+  } catch {
+    /* preference just won't persist */
+  }
+}
+
+/**
+ * Hide dot-prefixed entries unless the user asked to see them.
+ *
+ * These are mostly not the user's files at all: a Mac writing over WebDAV
+ * leaves a `.DS_Store` in every folder it opens and an AppleDouble `._name`
+ * beside every file carrying extended attributes. Finder hides its own litter
+ * locally, so seeing it reappear in the web UI reads as corruption.
+ *
+ * A toggle rather than a blocklist, because they ARE real files: hiding them
+ * outright would leave the ones already uploaded unreachable and undeletable.
+ */
+export function filterHiddenEntries(files: FileNode[], showHidden: boolean): FileNode[] {
+  if (showHidden) return files || [];
+  return (files || []).filter((f) => !(f.basename || '').startsWith('.'));
+}
+
+/** filterInternalEntries + filterHiddenEntries — what both panes render. */
+export function filterListing(files: FileNode[]): FileNode[] {
+  return filterHiddenEntries(filterInternalEntries(files), showHiddenFiles.value);
+}
+
 /** True when `dirname` (adapter-qualified) is the storage root, where the
  *  virtual trash row belongs. */
 export function isStorageRootDir(dirname: string): boolean {

package/src/locales/en.ts

@@ -21,6 +21,8 @@ export const en: Record<string, string> = {
   'ctx.move': 'Move',
   'ctx.copy': 'Copy',
   'ctx.cut': 'Cut',
+  'ctx.show_hidden': 'Show hidden files',
+  'ctx.hide_hidden': 'Hide hidden files',
   'ctx.paste': 'Paste',
   'ctx.info': 'Info',
   'ctx.duplicate': 'Duplicate',
@@ -163,6 +165,7 @@ export const en: Record<string, string> = {
   'shortcuts.go_up': 'Go up one level',
   'shortcuts.open': 'Open selected item',
   'shortcuts.close': 'Close / cancel',
+  'shortcuts.toggle_hidden': 'Show/hide hidden files',
   'shortcuts.help': 'This help dialog',
   'shortcuts.select_all': 'Select all',
   'shortcuts.rename': 'Rename',

package/src/locales/tr.ts

@@ -21,6 +21,8 @@ export const tr: Record<string, string> = {
   'ctx.move': 'Taşı',
   'ctx.copy': 'Kopyala',
   'ctx.cut': 'Kes',
+  'ctx.show_hidden': 'Gizli dosyaları göster',
+  'ctx.hide_hidden': 'Gizli dosyaları gizle',
   'ctx.paste': 'Yapıştır',
   'ctx.info': 'Bilgi',
   'ctx.duplicate': 'Kopyasını Oluştur',
@@ -163,6 +165,7 @@ export const tr: Record<string, string> = {
   'shortcuts.go_up': 'Üst klasöre çık',
   'shortcuts.open': 'Seçili öğeyi aç',
   'shortcuts.close': 'Kapat / vazgeç',
+  'shortcuts.toggle_hidden': 'Gizli dosyaları göster/gizle',
   'shortcuts.help': 'Bu yardım penceresi',
   'shortcuts.select_all': 'Tümünü seç',
   'shortcuts.rename': 'Yeniden adlandır',