@brftech/filex-core 0.32.0 → 0.34.0

package/src/components/CommandPalette.vue

@@ -16,7 +16,7 @@
  * bul:s3 additions:
  *   4. "Everywhere" group — ≥3-char queries also hit the global files-search
  *      endpoint (debounced 250ms, max 8 rows) via the `globalSearch` prop.
- *      Content matches get an "İçerikte" badge + a «»-highlighted snippet
+ *      Content matches get an "In content" badge + a «»-highlighted snippet
  *      rendered as pure text nodes (no innerHTML).
  *   5. Saved searches — localStorage-backed (`filex.saved-searches`, max 10);
  *      "save current query" command + per-row delete.
@@ -140,7 +140,7 @@ const commandItems = computed<PaletteItem[]>(() => {
   const defs: Array<{ command: string; label: string; icon: string; enabled: boolean }> = [
     { command: 'new-folder', label: t('toolbar.new_folder'), icon: '📁', enabled: props.canWrite !== false },
     { command: 'upload', label: t('toolbar.upload'), icon: '⬆', enabled: props.canWrite !== false },
-    { command: 'toggle-view', label: t('cmd.view_toggle'), icon: props.viewMode === 'list' ? '▦' : props.viewMode === 'grid' ? '▣' : '☰', enabled: true /* wiring:d2 — sıradaki mod ikonu (list→grid→galeri→list) */ },
+    { command: 'toggle-view', label: t('cmd.view_toggle'), icon: props.viewMode === 'list' ? '▦' : props.viewMode === 'grid' ? '▣' : '☰', enabled: true /* wiring:d2 — icon of the NEXT mode (list→grid→gallery→list) */ },
     { command: 'open-trash', label: t('cmd.trash'), icon: '🗑', enabled: true },
     { command: 'refresh', label: t('toolbar.refresh'), icon: '⟳', enabled: true },
     { command: 'go-up', label: t('toolbar.go_up'), icon: '↑', enabled: props.canGoUp !== false },
@@ -148,7 +148,7 @@ const commandItems = computed<PaletteItem[]>(() => {
     { command: 'open-theme', label: t('theme.menu'), icon: '🎨', enabled: true },
     { command: 'open-shortcut-settings', label: t('shortcuts.settings.menu'), icon: '⌨', enabled: true },
     { command: 'start-tour', label: t('tour.restart'), icon: '🎓', enabled: true },
-    /* wiring:d1 — sekme + split */
+    /* wiring:d1 — tabs + split */
     { command: 'tab-new', label: t('cmd.tab_new'), icon: '⧉', enabled: true },
     { command: 'split-toggle', label: t('cmd.split_toggle'), icon: '◫', enabled: props.splitEnabled !== false },
   ];

package/src/components/ConnectionsPanel.vue

@@ -40,6 +40,7 @@ import S3KeysPanel from './S3KeysPanel.vue';
 import SSHKeysPanel from './SSHKeysPanel.vue';
 import NFSExportsPanel from './NFSExportsPanel.vue';
 import TokensPanel from './TokensPanel.vue';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   config: ExplorerConfig;
@@ -56,7 +57,7 @@ const emit = defineEmits<{
   (e: 'error', err: { message: string }): void;
 }>();
 
-const locale = computed<LocaleCode>(() => props.config.locale ?? 'tr');
+const locale = computed<LocaleCode>(() => resolveLocale(props.config.locale));
 const { t } = useLocale(locale);
 
 // Destructured on purpose: Vue only auto-unwraps refs that are top-level in

package/src/components/GalleryView.vue

@@ -43,8 +43,8 @@ const props = defineProps<{
    * leaves that view out — a shared app token has no single person behind it,
    * so "your starred files" is one list shown to strangers — offering to star
    * something is offering to write into that same shared list. Owner's call,
-   * 2026-09-05: "yıldızlı yeri gözükmüyorsa o zaman yıldızla/yıldızı kaldır da
-   * gözükmemeli".
+   * 2026-09-05, verbatim (translated from Turkish): "if the starred place is
+   * not visible, then star/unstar should not be visible either".
    */
   starEnabled?: boolean;
   apiBase?: string;
@@ -159,7 +159,7 @@ function parentDir(path: string): string {
 function specialEmojiFor(n: FileNode): string | null {
   if (n.basename === '.trash') return '🗑';
   if (n.mime_type === 'inode/storage') return '💾';
-  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — şifreli klasör rozeti */
+  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — encrypted-folder badge */
   return null;
 }
 

package/src/components/GridView.vue

@@ -41,8 +41,8 @@ const props = defineProps<{
    * leaves that view out — a shared app token has no single person behind it,
    * so "your starred files" is one list shown to strangers — offering to star
    * something is offering to write into that same shared list. Owner's call,
-   * 2026-09-05: "yıldızlı yeri gözükmüyorsa o zaman yıldızla/yıldızı kaldır da
-   * gözükmemeli".
+   * 2026-09-05, verbatim (translated from Turkish): "if the starred place is
+   * not visible, then star/unstar should not be visible either".
    */
   starEnabled?: boolean;
   apiBase?: string;
@@ -197,7 +197,7 @@ function keepGlyph(b: 'kept' | 'syncing' | 'cloud' | 'partial'): string {
 function specialEmojiFor(n: FileNode): string | null {
   if (n.basename === '.trash') return '🗑';
   if (n.mime_type === 'inode/storage') return '💾';
-  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — şifreli klasör rozeti */
+  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — encrypted-folder badge */
   return null;
 }
 
@@ -246,7 +246,7 @@ function snippetTitle(snippet: string): string {
       role="option"
       :aria-selected="isSelected(n) ? 'true' : 'false'"
       :aria-label="nodeDisplayName(n) /* wiring:c4 */"
-      :data-fe-path="n.path /* wiring:d1 — orta-tık yeni sekme delegasyonu */"
+      :data-fe-path="n.path /* wiring:d1 — middle-click open-in-new-tab delegation */"
       draggable="true"
       @click="onClick(n, $event)"
       @dblclick="onDbl(n)"

package/src/components/ListView.vue

@@ -38,8 +38,8 @@ const props = defineProps<{
    * leaves that view out — a shared app token has no single person behind it,
    * so "your starred files" is one list shown to strangers — offering to star
    * something is offering to write into that same shared list. Owner's call,
-   * 2026-09-05: "yıldızlı yeri gözükmüyorsa o zaman yıldızla/yıldızı kaldır da
-   * gözükmemeli".
+   * 2026-09-05, verbatim (translated from Turkish): "if the starred place is
+   * not visible, then star/unstar should not be visible either".
    */
   starEnabled?: boolean;
   /** Backend base URL + auth header builder forwarded to StarButton
@@ -154,7 +154,7 @@ function cancelPress() {
 function specialEmojiFor(n: FileNode): string | null {
   if (n.basename === '.trash') return '🗑';
   if (n.mime_type === 'inode/storage') return '💾';
-  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — şifreli klasör rozeti */
+  if (n.type === 'dir' && n.e2e === true) return '🔒'; /* wiring:e2 — encrypted-folder badge */
   return null;
 }
 
@@ -384,7 +384,7 @@ const segments = computed<Segment[]>(() => {
         tabindex="0"
         :aria-selected="isSelected(n) ? 'true' : 'false'"
         :aria-label="nodeDisplayName(n) /* wiring:c4 */"
-        :data-fe-path="n.path /* wiring:d1 — orta-tık yeni sekme delegasyonu */"
+        :data-fe-path="n.path /* wiring:d1 — middle-click open-in-new-tab delegation */"
         draggable="true"
         @click="onRowClick(n, $event)"
         @dblclick="onRowDbl(n)"

package/src/components/NFSExportsPanel.vue

@@ -17,6 +17,7 @@ import type { ExplorerConfig, LocaleCode } from '../types/ExplorerConfig';
 import type { NFSExport } from '../types/NFSExports';
 import { useLocale } from '../composables/useLocale';
 import { useNFSExports } from '../composables/useNFSExports';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   config: ExplorerConfig;
@@ -28,7 +29,7 @@ const emit = defineEmits<{
   (e: 'active', v: { host: string; port: number; enabled: boolean; path?: string; readOnly: boolean }): void;
 }>();
 
-const locale = computed<LocaleCode>(() => props.config.locale ?? 'tr');
+const locale = computed<LocaleCode>(() => resolveLocale(props.config.locale));
 const { t } = useLocale(locale);
 
 const {

package/src/components/PendingOpsTray.vue

@@ -5,7 +5,7 @@
  * Historically a bottom-left toast list for queued copy/move/delete. Since
  * the unified operations center it renders NOTHING: it reconciles the
  * usePendingOps rows into the shared useOperations store; OperationsCenter
- * draws them. Terminal-state lingering ("bitti" flash → history) and sticky
+ * draws them. Terminal-state lingering ("done" flash → history) and sticky
  * errors are handled by the store — note usePendingOps sweeps terminal rows
  * after its RETAIN window, which the store treats as "move to history"
  * (errors stay pinned until the user dismisses them).

package/src/components/PresenceBar.vue

@@ -11,6 +11,7 @@ import type { PresenceUser } from '../lib/realtime';
 import type { LocaleCode } from '../types/ExplorerConfig';
 import { useLocale } from '../composables/useLocale';
 import PresenceAvatar from './PresenceAvatar.vue';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   users: PresenceUser[];
@@ -18,7 +19,7 @@ const props = defineProps<{
   locale?: LocaleCode;
 }>();
 
-const { t } = useLocale(() => props.locale ?? 'tr');
+const { t } = useLocale(() => resolveLocale(props.locale));
 
 const others = computed(() =>
   (props.users ?? []).filter((u) => props.selfId == null || u.id !== props.selfId),
@@ -87,7 +88,7 @@ function label(u: PresenceUser): string {
         <span v-if="others.length > 5" class="fx-presence-more">+{{ others.length - 5 }}</span>
       </div>
       <span class="fx-presence-text" :title="others.map(label).join(', ')">
-        {{ others.length === 1 ? others[0].name : `${others.length} kişi` }}
+        {{ others.length === 1 ? others[0].name : t('presence.others', { n: others.length }) }}
         <template v-if="others.length === 1 && others[0].file">
           · <span class="fx-presence-file">{{ others[0].file }}</span>
         </template>

package/src/components/S3KeysPanel.vue

@@ -22,6 +22,7 @@ import type { ExplorerConfig, LocaleCode } from '../types/ExplorerConfig';
 import type { S3AccessKey } from '../types/S3Keys';
 import { useLocale } from '../composables/useLocale';
 import { useS3Keys } from '../composables/useS3Keys';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   config: ExplorerConfig;
@@ -34,7 +35,7 @@ const emit = defineEmits<{
   (e: 'active', v: { accessKeyID: string; secret?: string; endpoint: string; pathStyle: boolean }): void;
 }>();
 
-const locale = computed<LocaleCode>(() => props.config.locale ?? 'tr');
+const locale = computed<LocaleCode>(() => resolveLocale(props.config.locale));
 const { t } = useLocale(locale);
 
 const {

package/src/components/SSHKeysPanel.vue

@@ -18,6 +18,7 @@ import type { ExplorerConfig, LocaleCode } from '../types/ExplorerConfig';
 import type { FTPSFacts, SSHPublicKey } from '../types/SSHKeys';
 import { useLocale } from '../composables/useLocale';
 import { useSSHKeys } from '../composables/useSSHKeys';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   config: ExplorerConfig;
@@ -47,7 +48,7 @@ const emit = defineEmits<{
   }): void;
 }>();
 
-const locale = computed<LocaleCode>(() => props.config.locale ?? 'tr');
+const locale = computed<LocaleCode>(() => resolveLocale(props.config.locale));
 const { t } = useLocale(locale);
 
 const { keys, connection, loading, error, canAdd, hasUsableKey, load, add, setDisabled, remove } =

package/src/components/SecondaryPane.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 /**
- * SecondaryPane — wiring:d1 split görünümün sağ (ikincil) paneli.
+ * SecondaryPane — wiring:d1 the right-hand (secondary) pane of the split view.
  *
  * Deliberately LIGHT: its own path + its own listing — fetched through
  * the SAME FileApi instance the host already constructed (`api.index`,
@@ -79,11 +79,12 @@ const emit = defineEmits<{
   (e: 'close'): void;
   (e: 'open-tab', path: string): void;
   (e: 'transfer', p: { sources: string[]; targetWire: string; originWire?: string }): void;
-  /* ui-fix — yan panelde sağ-tık: menü ana bileşende (FileExplorer) açılır.
-   * node=null → boş alana sağ-tık (seçimsiz, yalnız Yapıştır). */
+  /* ui-fix — right-click inside the side pane: the menu is opened by the main
+   * component (FileExplorer). node=null → right-click on empty space (nothing
+   * selected, so "Paste" only). */
   (e: 'context', node: FileNode | null, ev: MouseEvent): void;
-  /* ui-fix — çöp kutusu satırı açıldığında: trash görünümü ana panele aittir
-   * (geri yükleme aksiyonlarıyla), host loadTrash() ile açar. */
+  /* ui-fix — when the trash row is opened: the trash view belongs to the main
+   * panel (it carries the restore actions), so the host opens it via loadTrash(). */
   (e: 'open-trash'): void;
 }>();
 
@@ -144,7 +145,7 @@ async function loadPane(target?: string): Promise<void> {
 void loadPane(props.initialPath ?? '');
 
 // ------------------------------------------------------------------
-// Breadcrumb (kırıntı)
+// Breadcrumb
 // ------------------------------------------------------------------
 
 interface Crumb {
@@ -204,12 +205,12 @@ function onViewContext(n: FileNode, ev: MouseEvent) {
   emit('context', n, ev);
 }
 
-/* ui-fix — boş alana (arka plan) sağ-tık: seçimsiz menü (yalnız Yapıştır)
- * → boş klasöre / mevcut klasöre dosya yapıştırma. Satır menüsü stopProp
- * ettiğinden bu yalnız gerçek boş alanda tetiklenir. */
+/* ui-fix — right-click on empty space (the background): a selection-less menu
+ * ("Paste" only) → pasting files into an empty / into the current folder. The
+ * row menu calls stopProp, so this only fires on genuinely empty space. */
 function onBgContext(ev: MouseEvent) {
   ev.preventDefault();
-  ev.stopPropagation(); // FileExplorer kökündeki canvas menüsüne bubble etmesin
+  ev.stopPropagation(); // don't bubble into the canvas menu on the FileExplorer root
   emit('activate');
   selected.value = new Set();
   emit('context', null, ev);
@@ -399,8 +400,8 @@ defineExpose({ reload, goUp, selectAll, openSelected, selectedNodes, getPath });
       <div v-else-if="files.length === 0" class="fe-split__state">
         {{ t('empty.folder') }}
       </div>
-      <!-- ui-fix — aynı görünüm bileşenleri (list/grid/gallery), pane'in
-           kendi viewMode'uyla; eski düz fe-split__list kalktı. -->
+      <!-- ui-fix — the same view components (list/grid/gallery), driven by the
+           pane's own viewMode; the old flat fe-split__list is gone. -->
       <ListView
         v-else-if="(viewMode ?? 'list') === 'list'"
         :files="files"

package/src/components/StarButton.vue

@@ -10,6 +10,7 @@ import { ref, watch, computed } from 'vue';
 import { setNodeStarred } from '../lib/star';
 import { useLocale } from '../composables/useLocale';
 import type { LocaleCode } from '../types/ExplorerConfig';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   starred: boolean;
@@ -45,7 +46,7 @@ const emit = defineEmits<{
 const local = ref(props.starred);
 watch(() => props.starred, (v) => { local.value = v; });
 
-const { t } = useLocale(() => props.locale ?? 'tr');
+const { t } = useLocale(() => resolveLocale(props.locale));
 const label = computed(() => t(local.value ? 'ctx.unstar' : 'ctx.star'));
 
 async function toggle() {

package/src/components/TabBar.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 /**
- * TabBar — wiring:d1 sekme şeridi.
+ * TabBar — wiring:d1 the tab strip.
  *
  * Thin strip that sits ABOVE the toolbar. The host renders it only when
  * 2+ tabs exist (embed pixel-parity: a single tab shows nothing at all).
@@ -8,7 +8,7 @@
  *
  * Interactions:
  *   click tab      → select
- *   × / middle-tık → close
+ *   ×/middle-click → close
  *   +              → new tab (clone of the current location)
  *   drag           → reorder (HTML5 DnD; live-swap while dragging)
  *   ⫿ (split)      → toggle the active tab's secondary pane

package/src/components/ThemeGallery.vue

@@ -6,7 +6,7 @@
  * toolbar chips + sample rows) painted with that theme's tokens for the
  * CURRENTLY resolved light/dark mode — so the card shows exactly what
  * you'd get. Click applies instantly (live preview behind the modal) and
- * persists; the selected card carries a ✓. "Varsayılana dön" resets.
+ * persists; the selected card carries a ✓. "Reset to default" resets.
  *
  * Presentational only — selection state + persistence live in
  * lib/themes.ts (shared across instances); the parent forwards `select`.

package/src/components/TokensPanel.vue

@@ -30,6 +30,7 @@ import type { ExplorerConfig, LocaleCode } from '../types/ExplorerConfig';
 import type { ApiToken } from '../types/Tokens';
 import { useLocale } from '../composables/useLocale';
 import { useTokens } from '../composables/useTokens';
+import { resolveLocale } from '../locales/resolve';
 
 const props = defineProps<{
   config: ExplorerConfig;
@@ -50,7 +51,7 @@ const emit = defineEmits<{
   (e: 'active', v: { hasToken: boolean }): void;
 }>();
 
-const locale = computed<LocaleCode>(() => props.config.locale ?? 'tr');
+const locale = computed<LocaleCode>(() => resolveLocale(props.config.locale));
 const { t } = useLocale(locale);
 
 const { tokens, loading, error, canMint, revealed, load, create, remove, dismiss } = useTokens(

package/src/components/Toolbar.vue

@@ -3,7 +3,7 @@
  * Toolbar — selection-aware action row.
  *
  * Layout:
- *   - No selection            → [📁 Yeni Klasör]   [search | ⬆ ↻]   [☰ ▦]
+ *   - No selection            → [📁 New Folder]    [search | ⬆ ↻]   [☰ ▦]
  *   - 1 file selected         → [👁 ⬇ 🔗 ✎ 🗑]    [search | ⬆ ↻]   [☰ ▦]
  *   - 1 folder selected       → [↗ ✎ 🗑]          [search | ⬆ ↻]   [☰ ▦]
  *   - Multi selection         → [✂ ❐ 🗑]          [search | ⬆ ↻]   [☰ ▦]
@@ -334,8 +334,8 @@ const utilityActions = computed<ContextAction[]>(() => {
         : t('toolbar.density.compact'),
     icon: '⇅',
   });
-  /* wiring:d2 — dar mod ⋯ menüsü: aktif olmayan İKİ görünüm de listelenir
-     (list/grid/gallery); eski tekli toggle üç modda eksik kalıyordu. */
+  /* wiring:d2 — narrow-mode ⋯ menu: BOTH inactive views are listed
+     (list/grid/gallery); the old single toggle fell short with three modes. */
   if (props.viewMode !== 'list' && offersView('list')) list.push({ key: 'view-list', label: t('toolbar.view.list'), icon: '☰' });
   if (props.viewMode !== 'grid' && offersView('grid')) list.push({ key: 'view-grid', label: t('toolbar.view.grid'), icon: '▦' });
   if (props.viewMode !== 'gallery' && offersView('gallery')) list.push({ key: 'view-gallery', label: t('toolbar.view.gallery'), icon: '▣' });
@@ -347,7 +347,7 @@ const utilityActions = computed<ContextAction[]>(() => {
   }
   /* koru:k1 — inspector toggle also reachable from the narrow overflow menu */
   list.push({ key: 'inspector', label: t('toolbar.inspector'), icon: 'ℹ' });
-  /* wiring:c1 — tema galerisi de dar modda ⋯ menüsünden açılır */
+  /* wiring:c1 — the theme gallery is opened from the ⋯ menu in narrow mode too */
   list.push({ key: 'theme', label: t('theme.menu'), icon: '🎨' });
   list.push({ key: 'shortcut-settings', label: t('shortcuts.settings.menu'), icon: '⌨' }) /* wiring:c2 */;
   list.push({ key: 'tour', label: t('tour.restart'), icon: '🎓' }); /* wiring:c4 */
@@ -539,8 +539,8 @@ function onMoreSelect(a: ContextAction) {
         <span class="fe-btn__label">{{ a.label }}</span>
       </button>
 
-      <!-- ui-fix — sığmayan aksiyonlar tek satırı korumak için ⋯ menüsüne
-           katlanır (arama/görünüm kontrolleri artık alt satıra düşmez). -->
+      <!-- ui-fix — actions that don't fit fold into the ⋯ menu so the row stays
+           a single line (search/view controls no longer drop to a second row). -->
       <button
         v-if="overflowToolbarItems.length > 0"
         ref="wideMoreBtnEl"
@@ -554,8 +554,8 @@ function onMoreSelect(a: ContextAction) {
         <span class="fe-icon">⋯</span>
       </button>
 
-      <!-- Görünmez ölçüm şeridi: TÜM aksiyonlar her zaman burada render
-           edilir; katlama hesabı gerçek genişliklerden yapılır. -->
+      <!-- Invisible measuring strip: EVERY action is always rendered here, so
+           the fold calculation runs off real measured widths. -->
       <div ref="measureEl" class="fe-toolbar__measure" aria-hidden="true">
         <button
           v-for="a in toolbarItems"
@@ -969,7 +969,7 @@ function onMoreSelect(a: ContextAction) {
       />
     </template>
 
-    <!-- ui-fix — wide modda katlanan aksiyonların ⋯ menüsü -->
+    <!-- ui-fix — ⋯ menu for the actions folded away in wide mode -->
     <ContextMenu
       v-if="!narrow"
       ref="wideMoreRef"

package/src/composables/useFileApi.ts

@@ -22,6 +22,7 @@
  */
 
 import type { ExplorerConfig, AuthConfig, EndpointMap } from '../types/ExplorerConfig';
+import { resolveLocale } from '../locales/resolve';
 import type {
   FileNode,
   ShareInfo,
@@ -336,9 +337,10 @@ export function useFileApi(config: ExplorerConfig) {
 
   // Map an HTTP status to a short, human-readable message in the explorer's
   // locale. The raw JSON body is attached as `.detail` for debugging but never
-  // shown in the toast (Ada: "404/403 falan verince ham json görüyorum").
+  // shown in the toast (Ada, translated from Turkish: "when it gives a 404/403
+  // or whatever, I see raw json").
   function statusMessage(status: number): string {
-    const tr = (config.locale ?? 'tr') !== 'en';
+    const tr = resolveLocale(config.locale) !== 'en';
     const m: Record<number, [string, string]> = {
       400: ['Geçersiz istek', 'Bad request'],
       401: ['Oturum gerekli, tekrar giriş yapın', 'Sign-in required'],

package/src/composables/useLocale.ts

@@ -12,7 +12,7 @@ import { messages } from '../locales';
 export function useLocale(localeRef: Ref<LocaleCode> | (() => LocaleCode)) {
   const lookup = computed(() => {
     const code = typeof localeRef === 'function' ? localeRef() : localeRef.value;
-    return messages[code] ?? messages.tr;
+    return messages[code] ?? messages.en;
   });
 
   function t(key: string, vars: Record<string, string | number> = {}): string {

package/src/composables/useOperations.ts

@@ -14,9 +14,9 @@
  * are registered per row so the panel can route user intent back to the
  * owning surface without the store knowing any transport details.
  *
- * Lifecycle rules (per the İşlem Merkezi contract):
+ * Lifecycle rules (per the Operations Center contract):
  *   - running rows live in `active`;
- *   - done/aborted rows linger in `active` for DONE_LINGER_MS ("bitti"
+ *   - done/aborted rows linger in `active` for DONE_LINGER_MS ("done"
  *     flash) then move to `history` (session-only, capped);
  *   - error rows are STICKY: they stay in `active` until the user
  *     dismisses or retries them — even after the source list swept them
@@ -39,7 +39,7 @@ export interface OperationInput {
   percent: number | null;
   status: OperationStatus;
   error?: string | null;
-  /** Queue op accepted but not started yet ("Sırada"). */
+  /** Queue op accepted but not started yet ("Queued"). */
   queued?: boolean;
   /** Progress counters for queue ops (3/5 items). */
   doneCount?: number;

package/src/composables/usePendingOps.ts

@@ -4,7 +4,7 @@
  * Backend POST /files/{copy,move,delete} returns `{op}` immediately
  * (status='pending') and the actual S3 work runs in a worker. The
  * client polls `/files/ops` every 2s while there's anything still
- * pending or running so the user gets live feedback ("3/5 kopyalandı").
+ * pending or running so the user gets live feedback ("3/5 copied").
  *
  * Polling is reference-counted: callers `register(op)` after starting a
  * new op; an interval ticks while the registered set has any non-

package/src/composables/useRealtime.ts

@@ -8,8 +8,15 @@
 
 import { ref, type Ref } from 'vue';
 import { RealtimeClient, type PresenceUser, type PresenceMessage } from '../lib/realtime';
+import { burstDebounce } from '../lib/burstDebounce';
 
 const RELOAD_DEBOUNCE_MS = 200;
+// Ceiling on how long a run of change frames may postpone the reload it is
+// waiting for — see burstDebounce for the starvation this exists to stop.
+// Measured in a real browser on 2026-09-06, watching a folder while a
+// 5 000-file zip was extracted into it: the first re-listing came 114 s into
+// the job, and there was a 40 s gap in the middle.
+const RELOAD_MAX_WAIT_MS = 2_000;
 const POLL_INTERVAL_MS = 12_000;
 
 export interface RealtimeApi {
@@ -28,19 +35,12 @@ export function useRealtime(api: RealtimeApi, opts: { reload: () => void }) {
 
   let client: RealtimeClient | null = null;
   let pendingSubscribe: string | null = null;
-  let reloadTimer: ReturnType<typeof setTimeout> | null = null;
+  const debouncedReload = burstDebounce(() => opts.reload(), {
+    wait: RELOAD_DEBOUNCE_MS,
+    maxWait: RELOAD_MAX_WAIT_MS,
+  });
   let pollTimer: ReturnType<typeof setInterval> | null = null;
 
-  function debouncedReload(): void {
-    // A burst of change frames (e.g. a multi-file upload) collapses into one
-    // soft reload of the current folder.
-    if (reloadTimer) clearTimeout(reloadTimer);
-    reloadTimer = setTimeout(() => {
-      reloadTimer = null;
-      opts.reload();
-    }, RELOAD_DEBOUNCE_MS);
-  }
-
   function onPresence(msg: PresenceMessage): void {
     // Ignore late frames for a folder we've already navigated away from.
     if (pendingSubscribe && msg.path && msg.path !== pendingSubscribe) return;
@@ -85,10 +85,7 @@ export function useRealtime(api: RealtimeApi, opts: { reload: () => void }) {
   }
 
   function stop(): void {
-    if (reloadTimer) {
-      clearTimeout(reloadTimer);
-      reloadTimer = null;
-    }
+    debouncedReload.cancel();
     if (pollTimer) {
       clearInterval(pollTimer);
       pollTimer = null;

package/src/composables/useTabs.ts

@@ -1,5 +1,5 @@
 /**
- * useTabs — wiring:d1 sekmeler (çalışma alanı tab şeridi).
+ * useTabs — wiring:d1 tabs (the workspace tab strip).
  *
  * A LAYER ABOVE FileExplorer's location state, never a replacement for
  * it: each tab is a location snapshot `{ id, path, viewMode, split }`.

package/src/composables/useUploadChunked.ts

@@ -85,10 +85,17 @@ export interface UploadOptions {
   onDone?: (job: UploadJob, result: UploadResult) => void;
   onError?: (job: UploadJob, err: Error) => void;
   /**
-   * Wait for the backend transfer before resolving. Default false: the node is
-   * listed the moment the commit is accepted, which is the whole point of
-   * staging. `true` is for a caller that must not report success until the
-   * bytes are on the driver.
+   * Wait for the backend transfer before resolving. Defaults to TRUE, because
+   * "the server has the bytes" and "the storage has the bytes" are different
+   * claims and only the second one is an upload.
+   *
+   * ⚠ It used to default to false and no caller ever set it, so the job went
+   * straight to `done` on the 202 — a transfer that failed afterwards in the
+   * ops worker left the user looking at a finished upload for a file that was
+   * never stored (issue #16: every file over the chunk threshold, on every S3
+   * backend). The `transferring` phase is short for a healthy storage and is
+   * the only place a failure can still be shown, so it is the default; pass
+   * false to opt out where the wait is genuinely unwanted.
    */
   waitForTransfer?: boolean;
 }
@@ -389,7 +396,7 @@ export function useUploadChunked(
       job.opId = result?.op_id;
       job.nodeId = result?.node_id;
 
-      if (opts.waitForTransfer && result?.op_id && api.endpoints.opsShow) {
+      if (opts.waitForTransfer !== false && result?.op_id && api.endpoints.opsShow) {
         job.status = 'transferring';
         report();
         await waitForOp(result.op_id);
@@ -484,17 +491,31 @@ export function useUploadChunked(
       if (!tmpl) return;
       const url = tmpl.replace('{id}', String(opId));
       let delay = 200;
+      // ⚠ A tray read that keeps failing must not park the upload in
+      // `transferring` for ever. One hiccup is not a verdict, but a row we
+      // cannot read at all (purged, or the endpoint is gone) is unknowable, so
+      // after a bounded run of failures the wait ends and the job settles the
+      // way it did before the wait existed — optimistic, but not hung.
+      let misses = 0;
       for (;;) {
         if (cancelled) throw new DOMException('Aborted by user', 'AbortError');
         try {
           const op = await api.jsonFetch<{ status?: string; error?: string }>(url);
           if (op?.status === 'ok') return;
           if (op?.status === 'failed' || op?.status === 'partial') {
-            throw new Error(op.error || 'transfer failed');
+            throw new TransferFailedError(op.error || 'transfer failed');
           }
+          misses = 0;
         } catch (err) {
-          if ((err as Error).message === 'transfer failed' || (err as Error).name === 'AbortError') throw err;
+          // ⚠ The verdict is told apart from the hiccup by TYPE, not by
+          // message. It used to be `message === 'transfer failed'`, which only
+          // matched when the server sent NO error text: the moment it sent a
+          // real one — which is every interesting failure — the throw above was
+          // swallowed here and the poll span for ever. Harmless while nothing
+          // set waitForTransfer; a hang the moment anything did.
+          if (err instanceof TransferFailedError || (err as Error).name === 'AbortError') throw err;
           /* a hiccup reading the tray is not a failed transfer */
+          if (++misses >= MAX_OP_POLL_MISSES) return;
         }
         await sleep(delay);
         delay = Math.min(delay * 2, 2000);
@@ -514,6 +535,17 @@ export function useUploadChunked(
   };
 }
 
+/** How many consecutive unreadable op polls end the transfer wait (~7s). */
+const MAX_OP_POLL_MISSES = 6;
+
+/** The backend said the transfer failed — as opposed to "I could not ask". */
+class TransferFailedError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'TransferFailedError';
+  }
+}
+
 function sleep(ms: number): Promise<void> {
   return new Promise((r) => setTimeout(r, ms));
 }

package/src/index.ts

@@ -98,7 +98,7 @@ export {
 } from './composables/useMonacoLoader';
 
 // ——— Locale catalogue (consumers may merge their own keys) ———
-export { messages, tr, en } from './locales';
+export { messages, tr, en, resolveLocale, detectLocale } from './locales';
 
 /* wiring:c1 — theme registry + gallery (hosts can list/apply themes programmatically) */
 export {
@@ -150,7 +150,7 @@ export type { TabState, TabSplit, TabsApi } from './composables/useTabs';
 export { default as TabBar } from './components/TabBar.vue';
 export { default as SecondaryPane } from './components/SecondaryPane.vue';
 /* /wiring:d1 */
-/* wiring:e2 — uçtan uca şifreli klasörler (WebCrypto; docs/E2E-ENCRYPTION.md) */
+/* wiring:e2 — end-to-end encrypted folders (WebCrypto; docs/E2E-ENCRYPTION.md) */
 export {
   E2E_MARKER_NAME,
   E2E_MAGIC,