@brftech/filex-core 0.39.1 → 0.40.0

package/src/FileExplorer.vue

@@ -2029,9 +2029,39 @@ useKeyboardShortcuts(rootEl, {
   onTabNext: () => nextTab(),
   onTabPrev: () => prevTab(),
   /* /wiring:d1 */
+  /* tus:t1 — the menu verbs, routed through the SAME dispatcher the right-click
+   * menu and the toolbar use (dispatchItemAction), so a key and a click cannot
+   * drift apart. The ones that act on a selection do nothing without one, which
+   * is what the menu does too. */
+  onNewFolder: () => {
+    showNewFolder.value = true;
+  },
+  onUpload: () => triggerUpload(),
+  onRefresh: () => void load(),
+  onDownload: () => void dispatchItemAction('download', shortcutTargets()),
+  onPreview: () => void dispatchItemAction('preview', shortcutTargets()),
+  onShare: () => void dispatchItemAction('access', shortcutTargets()),
+  onTags: () => void dispatchItemAction('tags', shortcutTargets()),
+  onConvert: () => void dispatchItemAction('convert', shortcutTargets()),
+  onOpenTab: () => void dispatchItemAction('open-tab', shortcutTargets()),
+  onCopyPath: () => {
+    const n = shortcutTargets()[0];
+    if (n) void onCopyPath(n.path);
+  },
+  onCopyId: () => void dispatchItemAction('copy-id', shortcutTargets()),
+  onRestore: () => void dispatchItemAction('restore', shortcutTargets()),
+  /* /tus:t1 */
   hasSelection: () => !selection.isEmpty.value,
 });
 
+/* tus:t1 — which rows a keyboard verb acts on: the active pane's selection when
+ * the split pane has focus, otherwise the main listing's. Same rule the delete
+ * and rename shortcuts have followed since wiring:d1. */
+function shortcutTargets(): FileNode[] {
+  if (paneIsActive.value) return splitPaneRef.value?.selectedNodes() ?? [];
+  return selection.nodes.value;
+}
+
 // --------------------------------------------------------------------
 // Actions
 // --------------------------------------------------------------------

package/src/components/ContextMenu.vue

@@ -10,6 +10,7 @@ import { ref, computed, onMounted, onBeforeUnmount, nextTick } from 'vue';
 import type { LocaleCode, ThemeMode } from '../types/ExplorerConfig';
 import type { FileNode } from '../types/FileNode';
 import { useLocale } from '../composables/useLocale';
+import { menuShortcutHint } from '../composables/useKeyboardShortcuts';
 
 export interface ContextAction {
   key: string;
@@ -19,6 +20,12 @@ export interface ContextAction {
   disabled?: boolean;
   hidden?: boolean;
   divider?: boolean;
+  /**
+   * tus:t1 — registry action id whose key this row should print. Optional:
+   * rows whose `key` already matches the registry (rename, delete, copy…)
+   * are resolved from the shared map and need nothing here.
+   */
+  shortcutId?: string;
 }
 
 const props = defineProps<{
@@ -48,6 +55,12 @@ const emit = defineEmits<{
 
 const { t } = useLocale(() => props.locale); // bag:b4 — sheet aria labels need t()
 
+/* tus:t1 — a row's key label. `shortcutId` wins when an embedder sets one;
+ * otherwise the row's own key is looked up in the shared menu map. */
+function hintFor(a: ContextAction): string {
+  return menuShortcutHint(a.shortcutId ?? a.key);
+}
+
 const open = ref(false);
 const x = ref(0);
 const y = ref(0);
@@ -320,6 +333,7 @@ defineExpose({ show, hide });
               >
                 <span v-if="a.icon" class="fe-ctx__icon" aria-hidden="true">{{ a.icon }}</span>
                 <span class="fe-ctx__label">{{ a.label }}</span>
+                <span v-if="hintFor(a)" class="fe-ctx__key" aria-hidden="true">{{ hintFor(a) }}</span>
               </button>
             </template>
           </div>
@@ -347,6 +361,10 @@ defineExpose({ show, hide });
             >
               <span v-if="a.icon" class="fe-ctx__icon" aria-hidden="true">{{ a.icon }}</span>
               <span class="fe-ctx__label">{{ a.label }}</span>
+              <!-- tus:t1 — the key that does this from the keyboard, read from
+                   the registry so a remap reaches it. Empty for a verb with no
+                   binding, and the span then does not render at all. -->
+              <span v-if="hintFor(a)" class="fe-ctx__key" aria-hidden="true">{{ hintFor(a) }}</span>
             </button>
           </template>
         </div>

package/src/components/QuickLook.vue

@@ -6,11 +6,15 @@
  * mode), so every viewer the modal knows (image/video/pdf/office/code/
  * 3D/archive/…) works in quick-look for free. What this layer adds:
  *
- *   - Space closes again (macOS Quick Look convention)
+ *   - the quick-look key closes the peek again (Space by default — macOS
+ *     Quick Look convention), and the open key promotes it into the full
+ *     open flow (Enter by default, emit 'open-full'). Both come from the
+ *     shortcut registry rather than from a comparison against the default
+ *     key, so a remap reaches the overlay too
  *   - ← ↑ / → ↓ ask the host to move the selection; the host keeps the
- *     `file` prop in sync so the preview follows the selection
- *   - Enter promotes the peek into the full open flow (emit 'open-full')
- *   - a small floating hint bar with the key legend
+ *     `file` prop in sync so the preview follows the selection. These are
+ *     the peek's own arrows, not registry actions
+ *   - a small floating hint bar naming those keys, read from the registry
  *
  * Keys are handled in window CAPTURE phase with stopPropagation so the
  * global shortcut registry never double-handles them; events that

package/src/components/ShortcutSettings.vue

@@ -24,6 +24,7 @@ import {
   comboFromEvent,
   effectiveCombo,
   findShortcutConflict,
+  isReservedCombo,
   resetAllShortcuts,
   resetShortcut,
   setShortcutOverride,
@@ -66,6 +67,8 @@ const anyOverridden = computed(() => list.value.some((s) => s.overridden));
 
 const capturingId = ref<string | null>(null);
 const conflict = ref<{ id: string; combo: string; conflictId: string; fixed: boolean } | null>(null);
+/* tus:t1 — the user pressed something the browser keeps for itself. */
+const reserved = ref<{ id: string; combo: string } | null>(null);
 
 function labelOf(id: string): string {
   const def = SHORTCUT_ACTIONS.find((a) => a.id === id);
@@ -74,6 +77,7 @@ function labelOf(id: string): string {
 
 function beginCapture(id: string) {
   conflict.value = null;
+  reserved.value = null;
   capturingId.value = id;
 }
 
@@ -84,6 +88,13 @@ function cancelCapture() {
 function attemptAssign(id: string, combo: string) {
   capturingId.value = null;
   if (combo === effectiveCombo(id)) return; // unchanged
+  /* tus:t1 — a combo the browser takes before the page sees it would be a key
+   * that does nothing where the user is standing. Refuse it and say why,
+   * rather than storing a binding that never fires. */
+  if (isReservedCombo(combo)) {
+    reserved.value = { id, combo };
+    return;
+  }
   const clash = findShortcutConflict(combo, id);
   if (clash) {
     conflict.value = { id, combo, conflictId: clash.id, fixed: clash.fixed };
@@ -104,13 +115,19 @@ function dismissConflict() {
   conflict.value = null;
 }
 
+function dismissReserved() {
+  reserved.value = null;
+}
+
 function onReset(id: string) {
   conflict.value = null;
+  reserved.value = null;
   resetShortcut(id);
 }
 
 function onResetAll() {
   conflict.value = null;
+  reserved.value = null;
   capturingId.value = null;
   resetAllShortcuts();
 }
@@ -145,6 +162,7 @@ watch(
       window.removeEventListener('keydown', onWindowKeydown, true);
       capturingId.value = null;
       conflict.value = null;
+      reserved.value = null;
     }
   },
 );
@@ -201,6 +219,14 @@ function onClose() {
                 </span>
                 <template v-for="(combo, i) in s.keys" v-else :key="combo">
                   <kbd class="fe-kbd">{{ combo }}</kbd>
+                  <!-- tus:t1 — this combo never reaches a browser tab. Say so
+                       on the row rather than letting the user discover it by
+                       pressing the key and watching nothing happen. -->
+                  <span
+                    v-if="isReservedCombo(combo)"
+                    class="fe-shortset__reserved"
+                    :title="t('shortcuts.settings.reserved_title')"
+                  >{{ t('shortcuts.settings.reserved_badge') }}</span>
                   <span v-if="i < s.keys.length - 1" class="fe-shortcuts__or" aria-hidden="true">/</span>
                 </template>
               </template>
@@ -260,6 +286,17 @@ function onClose() {
               </button>
             </span>
           </div>
+          <div v-if="reserved && reserved.id === s.id" class="fe-shortset__conflict" role="alert">
+            <span class="fe-shortset__conflict-msg">
+              <kbd class="fe-kbd">{{ reserved.combo }}</kbd>
+              {{ t('shortcuts.settings.reserved') }}
+            </span>
+            <span class="fe-shortset__conflict-actions">
+              <button type="button" class="fe-btn fe-shortset__btn" @click="dismissReserved">
+                {{ t('shortcuts.settings.conflict_cancel') }}
+              </button>
+            </span>
+          </div>
         </div>
       </section>
     </div>

package/src/components/Toolbar.vue

@@ -17,7 +17,7 @@ import type { LocaleCode, ThemeMode } from '../types/ExplorerConfig';
 import ContextMenu, { type ContextAction } from './ContextMenu.vue';
 import ViewSwitcher from './ViewSwitcher.vue';
 import { useLocale } from '../composables/useLocale';
-import { eventMatchesShortcut, shortcutHint } from '../composables/useKeyboardShortcuts';
+import { eventMatchesShortcut, menuShortcutHint, shortcutHint } from '../composables/useKeyboardShortcuts';
 
 export type SelectionMode = 'none' | 'single-file' | 'single-dir' | 'multi';
 
@@ -389,6 +389,14 @@ const moreActions = computed<ContextAction[]>(() => {
  * that key. */
 const paletteCombo = computed(() => shortcutHint('palette'));
 
+/* tus:t1 — a button's tooltip names its key. Same source as the right-click
+ * menu's key column, so the two can only ever say the same thing, and a verb
+ * with no binding gets its plain label back rather than an empty bracket. */
+function withKey(label: string, key: string): string {
+  const combo = menuShortcutHint(key);
+  return combo ? `${label} (${combo})` : label;
+}
+
 const drivePlaceholder = computed(() =>
   props.scopeLabel
     ? t('drive.search.placeholder', { scope: props.scopeLabel })
@@ -509,7 +517,7 @@ function onMoreSelect(a: ContextAction) {
         v-if="canGoUp"
         type="button"
         class="fe-btn fe-btn--icon-only"
-        :title="t('toolbar.go_up')"
+        :title="withKey(t('toolbar.go_up'), 'go-up')"
         :aria-label="t('toolbar.go_up')"
         @click="emit('go-up')"
       >
@@ -523,7 +531,7 @@ function onMoreSelect(a: ContextAction) {
         v-if="shell !== 'drive' && mode === 'none' && !trashActive && !atVirtualRoot && canWrite !== false"
         type="button"
         class="fe-btn fe-btn--primary"
-        :title="t('toolbar.new_folder')"
+        :title="withKey(t('toolbar.new_folder'), 'new-folder')"
         @click="emit('new-folder')"
       >
         <span class="fe-icon">📁</span>
@@ -537,7 +545,7 @@ function onMoreSelect(a: ContextAction) {
         class="fe-btn fe-btn--fold"
         :class="{ 'fe-btn--danger': a.danger, 'is-disabled': a.disabled }"
         :disabled="a.disabled"
-        :title="a.label"
+        :title="withKey(a.label, a.key)"
         @click="fire(a.key)"
       >
         <span class="fe-icon">{{ a.icon }}</span>
@@ -578,7 +586,7 @@ function onMoreSelect(a: ContextAction) {
         v-if="pasteEnabled && mode === 'none' && !trashActive && !atVirtualRoot && canWrite !== false"
         type="button"
         class="fe-btn"
-        :title="t('ctx.paste')"
+        :title="withKey(t('ctx.paste'), 'paste')"
         @click="fire('paste')"
       >
         <span class="fe-icon">📋</span>
@@ -641,7 +649,7 @@ function onMoreSelect(a: ContextAction) {
         v-if="shell !== 'drive' && !atVirtualRoot && canWrite !== false"
         type="button"
         class="fe-btn fe-btn--icon-only"
-        :title="t('toolbar.upload')"
+        :title="withKey(t('toolbar.upload'), 'upload')"
         :aria-label="t('toolbar.upload') /* wiring:c4 */"
         @click="emit('upload')"
       >
@@ -650,7 +658,7 @@ function onMoreSelect(a: ContextAction) {
       <button
         type="button"
         class="fe-btn fe-btn--icon-only"
-        :title="t('toolbar.refresh')"
+        :title="withKey(t('toolbar.refresh'), 'refresh')"
         :aria-label="t('toolbar.refresh') /* wiring:c4 */"
         @click="emit('refresh')"
       >
@@ -722,7 +730,7 @@ function onMoreSelect(a: ContextAction) {
       class="fe-btn fe-btn--icon-only fe-toolbar__inspector"
       :class="{ 'is-active': inspectorOpen }"
       :aria-pressed="!!inspectorOpen"
-      :title="t('toolbar.inspector')"
+      :title="withKey(t('toolbar.inspector'), 'inspector')"
       :aria-label="t('toolbar.inspector')"
       @click="emit('toggle-inspector')"
     >
@@ -922,7 +930,7 @@ function onMoreSelect(a: ContextAction) {
           v-if="canGoUp"
           type="button"
           class="fe-btn fe-btn--icon-only"
-          :title="t('toolbar.go_up')"
+          :title="withKey(t('toolbar.go_up'), 'go-up')"
           :aria-label="t('toolbar.go_up')"
           @click="emit('go-up')"
         >
@@ -935,7 +943,7 @@ function onMoreSelect(a: ContextAction) {
           type="button"
           class="fe-btn fe-btn--icon-only fe-toolbar__search-toggle"
           :class="{ 'is-active': !!localSearch }"
-          :title="t('toolbar.search')"
+          :title="withKey(t('toolbar.search'), 'search')"
           :aria-label="t('toolbar.search')"
           @click="openSearch"
         >
@@ -945,7 +953,7 @@ function onMoreSelect(a: ContextAction) {
           v-if="!atVirtualRoot && canWrite !== false"
           type="button"
           class="fe-btn fe-btn--icon-only"
-          :title="t('toolbar.upload')"
+          :title="withKey(t('toolbar.upload'), 'upload')"
           :aria-label="t('toolbar.upload')"
           @click="emit('upload')"
         >

package/src/composables/useKeyboardShortcuts.ts

@@ -47,6 +47,22 @@ export interface ShortcutHandlers {
   onTabNext?: () => void; // Ctrl+Tab
   onTabPrev?: () => void; // Ctrl+Shift+Tab
   /* /wiring:d1 */
+  /* tus:t1 — the verbs that were only ever reachable from the menus. Every
+   * one of them is remappable like the rest; the ones that ship unbound are
+   * there so the user can give them a key, not because they do less. */
+  onNewFolder?: () => void; // Shift+N
+  onUpload?: () => void; // U
+  onRefresh?: () => void; // R
+  onDownload?: () => void; // D
+  onPreview?: () => void; // P
+  onShare?: () => void; // Shift+S
+  onTags?: () => void; // T
+  onConvert?: () => void; // (unbound)
+  onOpenTab?: () => void; // (unbound)
+  onCopyPath?: () => void; // (unbound)
+  onCopyId?: () => void; // (unbound)
+  onRestore?: () => void; // (unbound)
+  /* /tus:t1 */
   hasSelection?: () => boolean; // disambiguates Backspace
 }
 
@@ -77,6 +93,33 @@ export interface ShortcutActionDef {
   inForms?: boolean;
 }
 
+/**
+ * Combos the BROWSER takes before the page sees them. `preventDefault()`
+ * cannot stop these in an ordinary tab — Chrome and Firefox handle them at
+ * the window level — so an action bound to one of them only ever fires in
+ * the desktop app, an installed PWA or a kiosk window.
+ *
+ * They are not forbidden as DEFAULTS (the tab actions have shipped on
+ * Ctrl+T/W/Tab since wiring:d1 and work in the desktop app), but the
+ * settings modal refuses to let a user assign one: choosing a key that
+ * silently does nothing where you are standing is not a choice, it is a
+ * trap. `isReservedCombo` is the one place that list lives.
+ */
+const RESERVED_COMBOS = new Set([
+  'Ctrl+N', 'Ctrl+Shift+N',
+  'Ctrl+T', 'Ctrl+Shift+T',
+  'Ctrl+W', 'Ctrl+Shift+W',
+  'Ctrl+Tab', 'Ctrl+Shift+Tab',
+  'Ctrl+Q',
+  'Ctrl+Shift+I', 'Ctrl+Shift+J', 'Ctrl+Shift+C',
+  'F11', 'F12',
+]);
+
+/** Does the browser eat this combo before the page can see it? */
+export function isReservedCombo(combo: string): boolean {
+  return RESERVED_COMBOS.has(combo);
+}
+
 /** Registry order = help/settings display order. */
 export const SHORTCUT_ACTIONS: ShortcutActionDef[] = [
   // Navigation
@@ -109,6 +152,25 @@ export const SHORTCUT_ACTIONS: ShortcutActionDef[] = [
   { id: 'tab-next', defaultCombo: 'Ctrl+Tab', labelKey: 'shortcuts.tab_next', groupKey: 'shortcuts.group.tabs' },
   { id: 'tab-prev', defaultCombo: 'Ctrl+Shift+Tab', labelKey: 'shortcuts.tab_prev', groupKey: 'shortcuts.group.tabs' },
   /* /wiring:d1 */
+  /* tus:t1 — the rest of the menu verbs. Until now these were reachable only
+   * by right-clicking, and the right-click menu named no keys at all, so 16 of
+   * the registry's actions were invisible unless somebody opened the `?` sheet
+   * on their own. The ones with no default are deliberate: they are rare
+   * enough that taking a key from the user by default is the wrong trade, and
+   * they are in the registry so the user can take one. */
+  { id: 'new-folder', defaultCombo: 'Shift+N', labelKey: 'shortcuts.new_folder', groupKey: 'shortcuts.group.file' },
+  { id: 'upload', defaultCombo: 'U', labelKey: 'shortcuts.upload', groupKey: 'shortcuts.group.file' },
+  { id: 'refresh', defaultCombo: 'R', labelKey: 'shortcuts.refresh', groupKey: 'shortcuts.group.nav' },
+  { id: 'download', defaultCombo: 'D', labelKey: 'shortcuts.download', groupKey: 'shortcuts.group.file' },
+  { id: 'preview', defaultCombo: 'P', labelKey: 'shortcuts.preview', groupKey: 'shortcuts.group.nav' },
+  { id: 'share', defaultCombo: 'Shift+S', labelKey: 'shortcuts.share', groupKey: 'shortcuts.group.file' },
+  { id: 'tags', defaultCombo: 'T', labelKey: 'shortcuts.tags', groupKey: 'shortcuts.group.file' },
+  { id: 'convert', defaultCombo: '', labelKey: 'shortcuts.convert', groupKey: 'shortcuts.group.file' },
+  { id: 'open-tab', defaultCombo: '', labelKey: 'shortcuts.open_tab', groupKey: 'shortcuts.group.tabs' },
+  { id: 'copy-path', defaultCombo: '', labelKey: 'shortcuts.copy_path', groupKey: 'shortcuts.group.file' },
+  { id: 'copy-id', defaultCombo: '', labelKey: 'shortcuts.copy_id', groupKey: 'shortcuts.group.file' },
+  { id: 'restore', defaultCombo: '', labelKey: 'shortcuts.restore', groupKey: 'shortcuts.group.file' },
+  /* /tus:t1 */
 ];
 
 /** action id → ShortcutHandlers callback name. */
@@ -134,6 +196,19 @@ const HANDLER_KEY: Record<string, keyof ShortcutHandlers> = {
   'tab-close': 'onTabClose',
   'tab-next': 'onTabNext',
   'tab-prev': 'onTabPrev',
+  /* tus:t1 */
+  'new-folder': 'onNewFolder',
+  upload: 'onUpload',
+  refresh: 'onRefresh',
+  download: 'onDownload',
+  preview: 'onPreview',
+  share: 'onShare',
+  tags: 'onTags',
+  convert: 'onConvert',
+  'open-tab': 'onOpenTab',
+  'copy-path': 'onCopyPath',
+  'copy-id': 'onCopyId',
+  restore: 'onRestore',
 };
 
 // --------------------------------------------------------------------
@@ -336,6 +411,53 @@ export function comboLabel(combo: string): string {
   return isMacLike() ? combo.replace(/\bCtrl\b/g, '⌘') : combo;
 }
 
+/**
+ * Menu action key → registry action id.
+ *
+ * The right-click menu, the toolbar and the keyboard all name the same verbs,
+ * but the menu's `key` and the registry's `id` are separate vocabularies and
+ * two of them genuinely differ (`access` is the share dialog, `details` is the
+ * inspector). One map, in one place: a second copy is a second chance to
+ * forget, and the symptom would be a menu row that silently stops naming its
+ * key while every other row keeps working.
+ */
+export const MENU_ACTION_SHORTCUTS: Record<string, string> = {
+  open: 'open',
+  'open-tab': 'open-tab',
+  preview: 'preview',
+  download: 'download',
+  convert: 'convert',
+  access: 'share',
+  details: 'inspector',
+  'copy-id': 'copy-id',
+  'copy-path': 'copy-path',
+  rename: 'rename',
+  cut: 'cut',
+  copy: 'copy',
+  paste: 'paste',
+  star: 'star',
+  tags: 'tags',
+  delete: 'delete',
+  restore: 'restore',
+  'new-folder': 'new-folder',
+  'toggle-hidden': 'toggle-hidden',
+  upload: 'upload',
+  refresh: 'refresh',
+};
+
+/**
+ * What a menu row or a toolbar button should print beside its label: the
+ * current combo for the verb it triggers, or '' when it has none (unbound, or
+ * not a registry action at all — `keep-local`, the E2E entries and so on).
+ */
+export function menuShortcutHint(menuKey: string): string {
+  /* Fall back to the key itself: the toolbar's own buttons (go-up, upload,
+   * refresh…) pass a registry id directly, and an id nothing knows returns ''
+   * rather than throwing. */
+  const id = MENU_ACTION_SHORTCUTS[menuKey] ?? menuKey;
+  return SHORTCUT_ACTIONS.some((a) => a.id === id) ? shortcutHint(id) : '';
+}
+
 /**
  * The one way a hint may name a key.
  *

package/src/index.ts

@@ -146,6 +146,11 @@ export {
   comboLabel,
   eventMatchesShortcut,
   isMacLike,
+  /* tus:t1 — menu/toolbar rows name their key from the same registry, and the
+   * combos a browser tab never receives are declared in one place. */
+  menuShortcutHint,
+  MENU_ACTION_SHORTCUTS,
+  isReservedCombo,
 } from './composables/useKeyboardShortcuts';
 export type {
   ShortcutActionDef,

package/src/lib/themes.ts

@@ -83,7 +83,11 @@ export const THEMES: ThemeDef[] = [
       '--fe-text': '#1a1e27',
       '--fe-text-muted': '#5a6475',
       '--fe-text-on-primary': '#ffffff',
-      '--fe-primary': '#3b82f6',
+      /* ⚠ Mirrors styles/variables.css. It drifted once: the stock primary was
+       * darkened to #2f6fe0 for WCAG AA against white text and this preview
+       * map kept the old #3b82f6, so the gallery card advertised a blue the
+       * product no longer used. */
+      '--fe-primary': '#2f6fe0',
       '--fe-primary-hover': '#2563eb',
       '--fe-danger': '#dc2626',
       '--fe-danger-hover': '#b91c1c',
@@ -97,7 +101,9 @@ export const THEMES: ThemeDef[] = [
       '--fe-border-strong': '#3a4453',
       '--fe-text': '#e5e9f0',
       '--fe-text-muted': '#8b95a7',
-      '--fe-text-on-primary': '#ffffff',
+      /* Dark ink, not white: white on #60a5fa measures 2.54 against the 4.5
+       * this file claims. Mirrors styles/variables.css. */
+      '--fe-text-on-primary': '#0f1419',
       '--fe-primary': '#60a5fa',
       '--fe-primary-hover': '#3b82f6',
       '--fe-danger': '#f87171',
@@ -355,6 +361,94 @@ export const THEMES: ThemeDef[] = [
       '--fe-font': 'ui-monospace, "SF Mono", Consolas, Menlo, monospace',
     },
   },
+  {
+    /**
+     * Drive — the palette of the end-user shell alfatm built on top of filex
+     * and put on a demo stand for review (GitHub #14). The drive profile's
+     * layout came out of their mockups; this is the colour and shape half of
+     * the same look, mapped onto our own tokens so every surface the explorer
+     * has — not just the drive shell — can wear it.
+     *
+     * Measured from their demo rather than eyeballed: 43 custom properties,
+     * of which the ones with a home here are the palette, the radii (6/8/10)
+     * and the per-file-type accents. Inter leads the font stack because that
+     * is what the demo uses; nothing is downloaded for it, so a machine
+     * without Inter installed falls back to the same system face as every
+     * other theme.
+     */
+    id: 'drive',
+    nameKey: 'theme.name.drive',
+    light: {
+      '--fe-bg': '#ffffff',
+      '--fe-bg-elev': '#f7f8fb',
+      '--fe-bg-hover': '#f3f4f6',
+      '--fe-bg-selected': '#eef3ff',
+      '--fe-border': '#e5e7eb',
+      '--fe-border-strong': '#d1d5db',
+      '--fe-text': '#1f2937',
+      '--fe-text-muted': '#6b7280',
+      '--fe-text-on-primary': '#ffffff',
+      '--fe-primary': '#2f6ceb',
+      '--fe-primary-hover': '#2559c9',
+      '--fe-danger': '#dc2626',
+      '--fe-danger-hover': '#b91c1c',
+      '--fe-font': 'Inter, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+      '--fe-radius-sm': '6px',
+      '--fe-radius': '8px',
+      '--fe-radius-md': '10px',
+      '--fe-radius-lg': '12px',
+      '--fe-shadow': '0 20px 60px rgba(17, 24, 39, 0.18)',
+      '--fe-shadow-sm': '0 8px 24px rgba(17, 24, 39, 0.12)',
+      '--fe-icon-folder': '#f4b400',
+      '--fe-icon-image': '#2f6ceb',
+      '--fe-icon-video': '#7c3aed',
+      '--fe-icon-audio': '#0d9488',
+      '--fe-icon-pdf': '#dc2626',
+      '--fe-icon-doc': '#2f6ceb',
+      '--fe-icon-sheet': '#16a34a',
+      '--fe-icon-slides': '#ea580c',
+      '--fe-icon-archive': '#6b7280',
+      '--fe-icon-code': '#2f6ceb',
+      '--fe-icon-text': '#374151',
+      '--fe-icon-unknown': '#6b7280',
+    },
+    dark: {
+      '--fe-bg': '#15171c',
+      '--fe-bg-elev': '#1a1d23',
+      '--fe-bg-hover': '#1f232a',
+      '--fe-bg-selected': '#1c2740',
+      '--fe-border': '#2e333c',
+      '--fe-border-strong': '#3d444f',
+      '--fe-text': '#e6e8ec',
+      '--fe-text-muted': '#888f9b',
+      /* Dark ink on a light-blue button: white on #5b8cff measures 3.16, and
+       * the bar this file documents is 4.5. */
+      '--fe-text-on-primary': '#15171c',
+      '--fe-primary': '#5b8cff',
+      '--fe-primary-hover': '#7ba3ff',
+      '--fe-danger': '#f87171',
+      '--fe-danger-hover': '#ef4444',
+      '--fe-font': 'Inter, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif',
+      '--fe-radius-sm': '6px',
+      '--fe-radius': '8px',
+      '--fe-radius-md': '10px',
+      '--fe-radius-lg': '12px',
+      '--fe-shadow': '0 20px 60px rgba(0, 0, 0, 0.6)',
+      '--fe-shadow-sm': '0 8px 24px rgba(0, 0, 0, 0.5)',
+      '--fe-icon-folder': '#f4b400',
+      '--fe-icon-image': '#4d7ff0',
+      '--fe-icon-video': '#9061f0',
+      '--fe-icon-audio': '#2dd4bf',
+      '--fe-icon-pdf': '#e05252',
+      '--fe-icon-doc': '#4d7ff0',
+      '--fe-icon-sheet': '#2eab63',
+      '--fe-icon-slides': '#fb923c',
+      '--fe-icon-archive': '#79808d',
+      '--fe-icon-code': '#4d7ff0',
+      '--fe-icon-text': '#5b6472',
+      '--fe-icon-unknown': '#79808d',
+    },
+  },
 ];
 
 export function themeById(id: string | null | undefined): ThemeDef | undefined {

package/src/locales/en.ts

@@ -306,6 +306,7 @@ export const en: Record<string, string> = {
   'theme.name.contrast': 'High Contrast',
   'theme.name.gray': 'Soft Gray',
   'theme.name.terminal': 'Terminal Green',
+  'theme.name.drive': 'Drive',
   /* === wiring:c2 — customizable shortcuts + quick look === */
   'shortcuts.quicklook': 'Quick look',
   'shortcuts.customize': 'Customize',
@@ -395,6 +396,24 @@ export const en: Record<string, string> = {
   'shortcuts.tab_close': 'Close tab',
   'shortcuts.tab_next': 'Next tab',
   'shortcuts.tab_prev': 'Previous tab',
+  /* tus:t1 — the menu verbs */
+  'shortcuts.new_folder': 'New folder',
+  'shortcuts.upload': 'Upload files',
+  'shortcuts.refresh': 'Refresh the listing',
+  'shortcuts.download': 'Download',
+  'shortcuts.preview': 'Preview',
+  'shortcuts.share': 'Share / permissions',
+  'shortcuts.tags': 'Tags',
+  'shortcuts.convert': 'Convert',
+  'shortcuts.open_tab': 'Open in a new tab',
+  'shortcuts.copy_path': 'Copy path',
+  'shortcuts.copy_id': 'Copy id',
+  'shortcuts.restore': 'Restore from trash',
+  'shortcuts.settings.reserved':
+    'is taken by the browser before the page sees it, so it would do nothing here. Pick another key.',
+  'shortcuts.settings.reserved_badge': 'Desktop app only',
+  'shortcuts.settings.reserved_title':
+    'The browser handles this combination itself. It fires in the desktop app and in an installed PWA, not in a browser tab.',
   'cmd.tab_new': 'Open a new tab',
   'cmd.split_toggle': 'Toggle split view',
   'split.pane': 'Secondary pane',