@brftech/filex-core 0.1.56 → 0.1.61

package/src/composables/useKeyboardShortcuts.ts

@@ -1,144 +1,144 @@
-/**
- * useKeyboardShortcuts — binds FileExplorer's keyboard affordances.
- *
- * Activated whenever the explorer is mounted (only one instance per
- * page is expected). Skips events that originate inside form controls
- * so the user can type filenames in the search box, modals, etc.
- */
-
-import { onMounted, onBeforeUnmount, type Ref } from 'vue';
-
-export interface ShortcutHandlers {
-  onDelete?: () => void;
-  onRename?: () => void; // F2
-  onSelectAll?: () => void; // Ctrl+A
-  onCut?: () => void; // Ctrl+X
-  onCopy?: () => void; // Ctrl+C
-  onPaste?: () => void; // Ctrl+V
-  onOpen?: () => void; // Enter
-  onClose?: () => void; // Escape
-  onFocusSearch?: () => void; // /
-  onDuplicate?: () => void; // Ctrl+D
-  onPathJump?: () => void; // Cmd+K / Ctrl+K
-  onGoUp?: () => void; // Alt+Up / Backspace (when nothing selected)
-  hasSelection?: () => boolean; // disambiguates Backspace
-}
-
-export function useKeyboardShortcuts(rootEl: Ref<HTMLElement | null>, handlers: ShortcutHandlers) {
-  function onKey(e: KeyboardEvent) {
-    const root = rootEl.value;
-    if (!root) return;
-
-    // Skip when the event originates inside a form control — don't
-    // want `Delete` while editing a filename, `/` while typing in the
-    // search box, etc. Escape always goes through so modals can close.
-    const target = e.target as HTMLElement | null;
-    if (
-      target &&
-      (target.tagName === 'INPUT' ||
-        target.tagName === 'TEXTAREA' ||
-        target.isContentEditable)
-    ) {
-      if (e.key !== 'Escape') return;
-    }
-
-    const ctrl = e.ctrlKey || e.metaKey;
-
-    switch (e.key) {
-      case 'Delete':
-        if (handlers.onDelete) {
-          e.preventDefault();
-          handlers.onDelete();
-        }
-        break;
-      case 'Backspace':
-        // Backspace = delete when something is selected (file-manager
-        // convention), parent-dir navigation otherwise. Without this
-        // disambiguation Backspace was firing onDelete with an empty
-        // selection and nothing happened, leaving users wondering why
-        // the obvious 'go back' key did nothing.
-        if (handlers.hasSelection?.() && handlers.onDelete) {
-          e.preventDefault();
-          handlers.onDelete();
-        } else if (handlers.onGoUp) {
-          e.preventDefault();
-          handlers.onGoUp();
-        }
-        break;
-      case 'F2':
-        if (handlers.onRename) {
-          e.preventDefault();
-          handlers.onRename();
-        }
-        break;
-      case 'Enter':
-        if (handlers.onOpen) {
-          handlers.onOpen();
-        }
-        break;
-      case 'Escape':
-        if (handlers.onClose) {
-          handlers.onClose();
-        }
-        break;
-      case '/':
-        if (handlers.onFocusSearch && !ctrl) {
-          e.preventDefault();
-          handlers.onFocusSearch();
-        }
-        break;
-      case 'a':
-      case 'A':
-        if (ctrl && handlers.onSelectAll) {
-          e.preventDefault();
-          handlers.onSelectAll();
-        }
-        break;
-      case 'x':
-      case 'X':
-        if (ctrl && handlers.onCut) {
-          e.preventDefault();
-          handlers.onCut();
-        }
-        break;
-      case 'c':
-      case 'C':
-        if (ctrl && handlers.onCopy) {
-          e.preventDefault();
-          handlers.onCopy();
-        }
-        break;
-      case 'v':
-      case 'V':
-        if (ctrl && handlers.onPaste) {
-          e.preventDefault();
-          handlers.onPaste();
-        }
-        break;
-      case 'd':
-      case 'D':
-        if (ctrl && handlers.onDuplicate) {
-          e.preventDefault();
-          handlers.onDuplicate();
-        }
-        break;
-      case 'k':
-      case 'K':
-        if (ctrl && handlers.onPathJump) {
-          e.preventDefault();
-          handlers.onPathJump();
-        }
-        break;
-      case 'ArrowUp':
-        // Alt+Up = parent dir (matches Finder / Files / Explorer).
-        if (e.altKey && handlers.onGoUp) {
-          e.preventDefault();
-          handlers.onGoUp();
-        }
-        break;
-    }
-  }
-
-  onMounted(() => window.addEventListener('keydown', onKey));
-  onBeforeUnmount(() => window.removeEventListener('keydown', onKey));
-}
+/**
+ * useKeyboardShortcuts — binds FileExplorer's keyboard affordances.
+ *
+ * Activated whenever the explorer is mounted (only one instance per
+ * page is expected). Skips events that originate inside form controls
+ * so the user can type filenames in the search box, modals, etc.
+ */
+
+import { onMounted, onBeforeUnmount, type Ref } from 'vue';
+
+export interface ShortcutHandlers {
+  onDelete?: () => void;
+  onRename?: () => void; // F2
+  onSelectAll?: () => void; // Ctrl+A
+  onCut?: () => void; // Ctrl+X
+  onCopy?: () => void; // Ctrl+C
+  onPaste?: () => void; // Ctrl+V
+  onOpen?: () => void; // Enter
+  onClose?: () => void; // Escape
+  onFocusSearch?: () => void; // /
+  onDuplicate?: () => void; // Ctrl+D
+  onPathJump?: () => void; // Cmd+K / Ctrl+K
+  onGoUp?: () => void; // Alt+Up / Backspace (when nothing selected)
+  hasSelection?: () => boolean; // disambiguates Backspace
+}
+
+export function useKeyboardShortcuts(rootEl: Ref<HTMLElement | null>, handlers: ShortcutHandlers) {
+  function onKey(e: KeyboardEvent) {
+    const root = rootEl.value;
+    if (!root) return;
+
+    // Skip when the event originates inside a form control — don't
+    // want `Delete` while editing a filename, `/` while typing in the
+    // search box, etc. Escape always goes through so modals can close.
+    const target = e.target as HTMLElement | null;
+    if (
+      target &&
+      (target.tagName === 'INPUT' ||
+        target.tagName === 'TEXTAREA' ||
+        target.isContentEditable)
+    ) {
+      if (e.key !== 'Escape') return;
+    }
+
+    const ctrl = e.ctrlKey || e.metaKey;
+
+    switch (e.key) {
+      case 'Delete':
+        if (handlers.onDelete) {
+          e.preventDefault();
+          handlers.onDelete();
+        }
+        break;
+      case 'Backspace':
+        // Backspace = delete when something is selected (file-manager
+        // convention), parent-dir navigation otherwise. Without this
+        // disambiguation Backspace was firing onDelete with an empty
+        // selection and nothing happened, leaving users wondering why
+        // the obvious 'go back' key did nothing.
+        if (handlers.hasSelection?.() && handlers.onDelete) {
+          e.preventDefault();
+          handlers.onDelete();
+        } else if (handlers.onGoUp) {
+          e.preventDefault();
+          handlers.onGoUp();
+        }
+        break;
+      case 'F2':
+        if (handlers.onRename) {
+          e.preventDefault();
+          handlers.onRename();
+        }
+        break;
+      case 'Enter':
+        if (handlers.onOpen) {
+          handlers.onOpen();
+        }
+        break;
+      case 'Escape':
+        if (handlers.onClose) {
+          handlers.onClose();
+        }
+        break;
+      case '/':
+        if (handlers.onFocusSearch && !ctrl) {
+          e.preventDefault();
+          handlers.onFocusSearch();
+        }
+        break;
+      case 'a':
+      case 'A':
+        if (ctrl && handlers.onSelectAll) {
+          e.preventDefault();
+          handlers.onSelectAll();
+        }
+        break;
+      case 'x':
+      case 'X':
+        if (ctrl && handlers.onCut) {
+          e.preventDefault();
+          handlers.onCut();
+        }
+        break;
+      case 'c':
+      case 'C':
+        if (ctrl && handlers.onCopy) {
+          e.preventDefault();
+          handlers.onCopy();
+        }
+        break;
+      case 'v':
+      case 'V':
+        if (ctrl && handlers.onPaste) {
+          e.preventDefault();
+          handlers.onPaste();
+        }
+        break;
+      case 'd':
+      case 'D':
+        if (ctrl && handlers.onDuplicate) {
+          e.preventDefault();
+          handlers.onDuplicate();
+        }
+        break;
+      case 'k':
+      case 'K':
+        if (ctrl && handlers.onPathJump) {
+          e.preventDefault();
+          handlers.onPathJump();
+        }
+        break;
+      case 'ArrowUp':
+        // Alt+Up = parent dir (matches Finder / Files / Explorer).
+        if (e.altKey && handlers.onGoUp) {
+          e.preventDefault();
+          handlers.onGoUp();
+        }
+        break;
+    }
+  }
+
+  onMounted(() => window.addEventListener('keydown', onKey));
+  onBeforeUnmount(() => window.removeEventListener('keydown', onKey));
+}

package/src/composables/useLocale.ts

@@ -1,60 +1,60 @@
-/**
- * useLocale — tr/en string table with a tiny `t()` helper.
- *
- * No i18n library — the catalogue is small enough to ship inline (see
- * src/locales).
- */
-
-import { computed, type Ref } from 'vue';
-import type { LocaleCode } from '../types/ExplorerConfig';
-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;
-  });
-
-  function t(key: string, vars: Record<string, string | number> = {}): string {
-    const raw = lookup.value[key] ?? key;
-    return Object.entries(vars).reduce(
-      (acc, [k, v]) => acc.replaceAll(`{${k}}`, String(v)),
-      raw,
-    );
-  }
-
-  function formatSize(bytes: number | undefined | null): string {
-    if (bytes == null || bytes <= 0) return '—';
-    const units: Array<[number, string]> = [
-      [1024 ** 4, 'unit.tb'],
-      [1024 ** 3, 'unit.gb'],
-      [1024 ** 2, 'unit.mb'],
-      [1024, 'unit.kb'],
-      [1, 'unit.bytes'],
-    ];
-    for (const [div, key] of units) {
-      if (bytes >= div) {
-        const val = bytes / div;
-        const rounded = val >= 100 ? Math.round(val) : val.toFixed(val >= 10 ? 1 : 2);
-        return `${rounded} ${t(key)}`;
-      }
-    }
-    return `${bytes} ${t('unit.bytes')}`;
-  }
-
-  /**
-   * Render a FileNode's basename with locale-aware overrides:
-   *   - `.trash` directory → "Çöp Kutusu" / "Trash"
-   *   - Trash entries are stored as `<Ymd-His>-<rand>__<original>` so
-   *     listings inside .trash/ would otherwise show timestamps. Strip
-   *     that prefix so the user sees the original basename.
-   */
-  function nodeDisplayName(node: { basename: string }): string {
-    if (node.basename === '.trash') return t('node.trash');
-    const m = node.basename.match(/^\d{8}-\d{6}-[A-Za-z0-9]+__(.+)$/);
-    if (m) return m[1];
-    return node.basename;
-  }
-
-  return { t, formatSize, nodeDisplayName };
-}
+/**
+ * useLocale — tr/en string table with a tiny `t()` helper.
+ *
+ * No i18n library — the catalogue is small enough to ship inline (see
+ * src/locales).
+ */
+
+import { computed, type Ref } from 'vue';
+import type { LocaleCode } from '../types/ExplorerConfig';
+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;
+  });
+
+  function t(key: string, vars: Record<string, string | number> = {}): string {
+    const raw = lookup.value[key] ?? key;
+    return Object.entries(vars).reduce(
+      (acc, [k, v]) => acc.replaceAll(`{${k}}`, String(v)),
+      raw,
+    );
+  }
+
+  function formatSize(bytes: number | undefined | null): string {
+    if (bytes == null || bytes <= 0) return '—';
+    const units: Array<[number, string]> = [
+      [1024 ** 4, 'unit.tb'],
+      [1024 ** 3, 'unit.gb'],
+      [1024 ** 2, 'unit.mb'],
+      [1024, 'unit.kb'],
+      [1, 'unit.bytes'],
+    ];
+    for (const [div, key] of units) {
+      if (bytes >= div) {
+        const val = bytes / div;
+        const rounded = val >= 100 ? Math.round(val) : val.toFixed(val >= 10 ? 1 : 2);
+        return `${rounded} ${t(key)}`;
+      }
+    }
+    return `${bytes} ${t('unit.bytes')}`;
+  }
+
+  /**
+   * Render a FileNode's basename with locale-aware overrides:
+   *   - `.trash` directory → "Çöp Kutusu" / "Trash"
+   *   - Trash entries are stored as `<Ymd-His>-<rand>__<original>` so
+   *     listings inside .trash/ would otherwise show timestamps. Strip
+   *     that prefix so the user sees the original basename.
+   */
+  function nodeDisplayName(node: { basename: string }): string {
+    if (node.basename === '.trash') return t('node.trash');
+    const m = node.basename.match(/^\d{8}-\d{6}-[A-Za-z0-9]+__(.+)$/);
+    if (m) return m[1];
+    return node.basename;
+  }
+
+  return { t, formatSize, nodeDisplayName };
+}

package/src/composables/useMonacoLoader.ts

@@ -1,98 +1,98 @@
-/**
- * useMonacoLoader — fire-and-forget Monaco preloader.
- *
- * The preview/edit flow wants Monaco when available (best-in-class
- * editor) and highlight.js for read-only syntax colour as a graceful
- * fallback. Monaco is heavy (~5 MB), so we kick off the dynamic import
- * at module-init time — by the time the user clicks "edit" on a code
- * file (typically several seconds in), the chunk is already cached.
- *
- *   - `monacoPromise`     resolves to the Monaco namespace, or `null`
- *                         if the package is not installed (peer
- *                         missing) / load fails.
- *   - `highlightPromise`  resolves to the highlight.js export, or
- *                         `null` similarly.
- *   - `getMonaco()`       returns the cached module synchronously
- *                         (after `await monacoPromise`) so a click
- *                         handler doesn't re-trigger the import.
- *
- * Both modules are externalized in the bundler config — the consumer
- * either declares them as direct deps (Monaco UX) or doesn't (the
- * highlight.js read-only path takes over). No build-time hard dep here.
- */
-
-let monacoPromise: Promise<unknown | null> | null = null;
-let highlightPromise: Promise<unknown | null> | null = null;
-let monacoCached: unknown | null = null;
-let highlightCached: unknown | null = null;
-
-/**
- * Kick off the Monaco import the first time someone calls
- * `preloadEditor()` (typically the FileExplorer onMounted hook). Cheap
- * to call repeatedly — only the first call actually triggers the
- * dynamic import.
- */
-export function preloadEditor(): void {
-  if (!monacoPromise) {
-    monacoPromise = import(/* @vite-ignore */ 'monaco-editor')
-      .then((mod) => {
-        monacoCached = (mod as { default?: unknown }).default ?? mod;
-        return monacoCached;
-      })
-      .catch(() => {
-        monacoCached = null;
-        return null;
-      });
-  }
-  if (!highlightPromise) {
-    highlightPromise = import(/* @vite-ignore */ 'highlight.js')
-      .then((mod) => {
-        highlightCached = (mod as { default?: unknown }).default ?? mod;
-        return highlightCached;
-      })
-      .catch(() => {
-        highlightCached = null;
-        return null;
-      });
-  }
-}
-
-/**
- * Resolve Monaco. If preload hasn't been kicked off yet, this triggers
- * it (and pays the load cost on the spot). Returns `null` when the
- * package isn't installed.
- */
-export async function ensureMonaco(): Promise<unknown | null> {
-  if (!monacoPromise) preloadEditor();
-  return monacoPromise!;
-}
-
-export async function ensureHighlight(): Promise<unknown | null> {
-  if (!highlightPromise) preloadEditor();
-  return highlightPromise!;
-}
-
-/** Synchronous cached lookup — null if Monaco not yet ready or absent. */
-export function getMonaco(): unknown | null {
-  return monacoCached;
-}
-
-export function getHighlight(): unknown | null {
-  return highlightCached;
-}
-
-/**
- * Composable wrapper — components that want reactive "is Monaco ready
- * yet?" semantics can read the resolved promise. The implementation is
- * intentionally tiny: components don't need anything fancier than
- * `await ensureMonaco()` inside the click handler.
- */
-export function useMonacoLoader() {
-  preloadEditor();
-  return {
-    ensureMonaco,
-    ensureHighlight,
-    getMonaco,
-    getHighlight,
-  };
-}
+/**
+ * useMonacoLoader — fire-and-forget Monaco preloader.
+ *
+ * The preview/edit flow wants Monaco when available (best-in-class
+ * editor) and highlight.js for read-only syntax colour as a graceful
+ * fallback. Monaco is heavy (~5 MB), so we kick off the dynamic import
+ * at module-init time — by the time the user clicks "edit" on a code
+ * file (typically several seconds in), the chunk is already cached.
+ *
+ *   - `monacoPromise`     resolves to the Monaco namespace, or `null`
+ *                         if the package is not installed (peer
+ *                         missing) / load fails.
+ *   - `highlightPromise`  resolves to the highlight.js export, or
+ *                         `null` similarly.
+ *   - `getMonaco()`       returns the cached module synchronously
+ *                         (after `await monacoPromise`) so a click
+ *                         handler doesn't re-trigger the import.
+ *
+ * Both modules are externalized in the bundler config — the consumer
+ * either declares them as direct deps (Monaco UX) or doesn't (the
+ * highlight.js read-only path takes over). No build-time hard dep here.
+ */
+
+let monacoPromise: Promise<unknown | null> | null = null;
+let highlightPromise: Promise<unknown | null> | null = null;
+let monacoCached: unknown | null = null;
+let highlightCached: unknown | null = null;
+
+/**
+ * Kick off the Monaco import the first time someone calls
+ * `preloadEditor()` (typically the FileExplorer onMounted hook). Cheap
+ * to call repeatedly — only the first call actually triggers the
+ * dynamic import.
+ */
+export function preloadEditor(): void {
+  if (!monacoPromise) {
+    monacoPromise = import(/* @vite-ignore */ 'monaco-editor')
+      .then((mod) => {
+        monacoCached = (mod as { default?: unknown }).default ?? mod;
+        return monacoCached;
+      })
+      .catch(() => {
+        monacoCached = null;
+        return null;
+      });
+  }
+  if (!highlightPromise) {
+    highlightPromise = import(/* @vite-ignore */ 'highlight.js')
+      .then((mod) => {
+        highlightCached = (mod as { default?: unknown }).default ?? mod;
+        return highlightCached;
+      })
+      .catch(() => {
+        highlightCached = null;
+        return null;
+      });
+  }
+}
+
+/**
+ * Resolve Monaco. If preload hasn't been kicked off yet, this triggers
+ * it (and pays the load cost on the spot). Returns `null` when the
+ * package isn't installed.
+ */
+export async function ensureMonaco(): Promise<unknown | null> {
+  if (!monacoPromise) preloadEditor();
+  return monacoPromise!;
+}
+
+export async function ensureHighlight(): Promise<unknown | null> {
+  if (!highlightPromise) preloadEditor();
+  return highlightPromise!;
+}
+
+/** Synchronous cached lookup — null if Monaco not yet ready or absent. */
+export function getMonaco(): unknown | null {
+  return monacoCached;
+}
+
+export function getHighlight(): unknown | null {
+  return highlightCached;
+}
+
+/**
+ * Composable wrapper — components that want reactive "is Monaco ready
+ * yet?" semantics can read the resolved promise. The implementation is
+ * intentionally tiny: components don't need anything fancier than
+ * `await ensureMonaco()` inside the click handler.
+ */
+export function useMonacoLoader() {
+  preloadEditor();
+  return {
+    ensureMonaco,
+    ensureHighlight,
+    getMonaco,
+    getHighlight,
+  };
+}