@brftech/filex-core 0.4.1 → 0.5.0

package/dist/index.d.ts

@@ -71,6 +71,53 @@ declare type __VLS_Props_5 = {
     refreshKey?: number | string;
 };
 
+declare type __VLS_Props_6 = {
+    open: boolean;
+    locale: LocaleCode;
+    /** Host mode (forwarded to Modal so the backdrop themes correctly). */
+    theme?: ThemeMode;
+    /** Resolved mode — decides which variant the preview cards paint. */
+    dark: boolean;
+    /** Currently selected theme id. */
+    current: string;
+};
+
+declare type __VLS_Props_7 = {
+    open: boolean;
+    locale: LocaleCode;
+    theme?: 'light' | 'dark' | 'auto';
+};
+
+declare type __VLS_Props_8 = {
+    open: boolean;
+    locale: LocaleCode;
+    file: FileNode | null;
+    previewUrl: (path: string) => string;
+    downloadUrl: (path: string) => string;
+    onlyOfficeBase?: string | null;
+    onlyOfficeConfigEndpoint?: string | null;
+    authHeaders?: () => Record<string, string>;
+    authCredentials?: RequestCredentials;
+    drawioUrl?: string | null;
+    pdfWorkerUrl?: string | null;
+    viewerBaseUrl?: string | null;
+    theme?: 'light' | 'dark' | 'auto';
+};
+
+declare type __VLS_Props_9 = {
+    center: OperationsStore;
+    locale: LocaleCode;
+    narrow?: boolean;
+};
+
+/**
+ * Set (or clear, for the default theme) the selected theme's tokens as
+ * inline CSS variables on the explorer root element, resolved to the
+ * active variant. Inline style wins over every stylesheet rule, so the
+ * root subtree is always correct regardless of host CSS.
+ */
+export declare function applyThemeToEl(el: HTMLElement, id: string, dark: boolean): void;
+
 export declare interface ArchiveEntry {
     name: string;
     size: number;
@@ -152,6 +199,13 @@ export declare interface ClipboardState {
     sourcePath: string | null;
 }
 
+/**
+ * Canonical combo for a keyboard event, or null for a bare modifier
+ * press. Meta folds into Ctrl; Shift is dropped for printable symbols
+ * because the produced character already encodes it (`?` not `Shift+?`).
+ */
+export declare function comboFromEvent(e: KeyboardEvent): string | null;
+
 declare interface ContextAction {
     key: string;
     label: string;
@@ -162,8 +216,13 @@ declare interface ContextAction {
     divider?: boolean;
 }
 
+export declare const DEFAULT_THEME_ID = "default";
+
 declare type Density = 'comfortable' | 'compact';
 
+/** Current combo for an action ('' = unbound). */
+export declare function effectiveCombo(id: string): string;
+
 /** English UI strings. */
 export declare const en: Record<string, string>;
 
@@ -484,27 +543,31 @@ inspectorOpen?: boolean;
 }> & Readonly<{
 onAction?: ((key: string) => any) | undefined;
 onUpload?: (() => any) | undefined;
+"onGo-up"?: (() => any) | undefined;
 "onUpdate:viewMode"?: ((v: ViewMode) => any) | undefined;
 "onUpdate:searchQuery"?: ((v: string) => any) | undefined;
 "onNew-folder"?: (() => any) | undefined;
 onRefresh?: (() => any) | undefined;
-"onGo-up"?: (() => any) | undefined;
 "onOpen-recents"?: (() => any) | undefined;
 "onUpdate:density"?: ((v: Density) => any) | undefined;
 "onToggle-inspector"?: (() => any) | undefined;
+"onOpen-theme"?: (() => any) | undefined;
+"onOpen-shortcut-settings"?: (() => any) | undefined;
 }>, {
 focusSearch: () => Promise<void>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 action: (key: string) => any;
 upload: () => any;
+"go-up": () => any;
 "update:viewMode": (v: ViewMode) => any;
 "update:searchQuery": (v: string) => any;
 "new-folder": () => any;
 refresh: () => any;
-"go-up": () => any;
 "open-recents": () => any;
 "update:density": (v: Density) => any;
 "toggle-inspector": () => any;
+"open-theme": () => any;
+"open-shortcut-settings": () => any;
 }, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
 searchEl: HTMLInputElement;
 moreBtnEl: HTMLButtonElement;
@@ -572,14 +635,16 @@ inspectorOpen?: boolean;
 }> & Readonly<{
 onAction?: ((key: string) => any) | undefined;
 onUpload?: (() => any) | undefined;
+"onGo-up"?: (() => any) | undefined;
 "onUpdate:viewMode"?: ((v: ViewMode) => any) | undefined;
 "onUpdate:searchQuery"?: ((v: string) => any) | undefined;
 "onNew-folder"?: (() => any) | undefined;
 onRefresh?: (() => any) | undefined;
-"onGo-up"?: (() => any) | undefined;
 "onOpen-recents"?: (() => any) | undefined;
 "onUpdate:density"?: ((v: Density) => any) | undefined;
 "onToggle-inspector"?: (() => any) | undefined;
+"onOpen-theme"?: (() => any) | undefined;
+"onOpen-shortcut-settings"?: (() => any) | undefined;
 }>, {
 focusSearch: () => Promise<void>;
 }, {}, {}, {}, {}> | null;
@@ -673,6 +738,22 @@ export declare interface FileNode {
     [k: string]: unknown;
 }
 
+/**
+ * Does `combo` already trigger another action? Checks both effective
+ * combos and the reserved fixed combos (Backspace, Esc). Returns null
+ * when free.
+ */
+export declare function findShortcutConflict(combo: string, excludeId: string): ShortcutConflict | null;
+
+/**
+ * Generate a stylesheet that mirrors styles/variables.css' selector
+ * cascade 1:1 (light base → explicit-dark selectors → prefers-dark media
+ * block) with the theme's palette. Appended after the bundled CSS it
+ * overrides every surface — teleported context menus, modal backdrops —
+ * in whichever mode they resolve to, without JS having to track them.
+ */
+export declare function generateThemeCss(theme: ThemeDef): string;
+
 export declare function getHighlight(): unknown | null;
 
 /** Synchronous cached lookup — null if Monaco not yet ready or absent. */
@@ -760,6 +841,89 @@ declare interface NodeVersion {
     created_at: string;
 }
 
+export declare interface Operation {
+    /** `${group}:${id}` — unique across publishers. */
+    key: string;
+    kind: OperationKind;
+    name: string;
+    percent: number | null;
+    status: OperationStatus;
+    error: string | null;
+    queued: boolean;
+    doneCount: number | null;
+    totalCount: number | null;
+    uploadedBytes: number | null;
+    totalBytes: number | null;
+    cancellable: boolean;
+    retryable: boolean;
+    startedAt: number;
+    settledAt: number | null;
+}
+
+export declare interface OperationActions {
+    cancel?: () => void;
+    /** Clean the row out of the OWNING source list (called on retire/dismiss). */
+    dismiss?: () => void;
+    retry?: () => void;
+}
+
+/** What a publisher hands to `sync()` for one row. */
+export declare interface OperationInput {
+    /** Stable id within the group (upload uuid / ops row id). */
+    id: string | number;
+    kind: OperationKind;
+    /** Primary label — file name or target path. '' → renderer falls back to the kind verb. */
+    name: string;
+    /** 0..100, or null for indeterminate (renderer shows a spinner). */
+    percent: number | null;
+    status: OperationStatus;
+    error?: string | null;
+    /** Queue op accepted but not started yet ("Sırada"). */
+    queued?: boolean;
+    /** Progress counters for queue ops (3/5 items). */
+    doneCount?: number;
+    totalCount?: number;
+    /** Byte progress for uploads. */
+    uploadedBytes?: number;
+    totalBytes?: number;
+    cancellable?: boolean;
+    retryable?: boolean;
+}
+
+/**
+ * useOperations — unified long-running-operation store (wiring:c3).
+ *
+ * One presentation-level aggregation point for everything that used to be
+ * scattered across corner UIs:
+ *   - uploads        (useUploadChunked jobs / legacy multipart rows)
+ *   - ops-queue jobs (usePendingOps copy/move/delete worker ops)
+ *   - future kinds   (convert / archive — same `sync()` contract, own group)
+ *
+ * The store does NOT talk to the network. Publishers (renderless
+ * UploadProgress / PendingOpsTray adapters) reconcile their reactive source
+ * lists into the store via `sync(group, items)`; OperationsCenter renders the
+ * merged picture (badge + panel). Action callbacks (cancel/retry/dismiss)
+ * 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):
+ *   - running rows live in `active`;
+ *   - done/aborted rows linger in `active` for DONE_LINGER_MS ("bitti"
+ *     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
+ *     (usePendingOps drops terminal ops after its RETAIN window).
+ */
+export declare type OperationKind = 'upload' | 'copy' | 'move' | 'delete' | 'convert' | 'archive';
+
+export declare const OperationsCenter: DefineComponent<__VLS_Props_9, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+rootEl: HTMLDivElement;
+}, any>;
+
+export declare type OperationsStore = ReturnType<typeof useOperations>;
+
+export declare type OperationStatus = 'running' | 'done' | 'error' | 'aborted';
+
 export declare interface PendingOp {
     id: number;
     op_type: 'copy' | 'move' | 'delete';
@@ -839,6 +1003,16 @@ monacoEl: HTMLDivElement;
 officeEl: HTMLDivElement;
 }, any>;
 
+export declare const QuickLook: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+nav: (delta: number) => any;
+"open-full": () => any;
+}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{
+onClose?: (() => any) | undefined;
+onNav?: ((delta: number) => any) | undefined;
+"onOpen-full"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
 export declare const RecentlyOpened: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 error: (message: string) => any;
 open: (node: RecentNode) => any;
@@ -856,6 +1030,10 @@ declare interface RecentNode {
     last_opened?: string;
 }
 
+export declare function resetAllShortcuts(): void;
+
+export declare function resetShortcut(id: string): void;
+
 declare interface ResolveEmailResponse {
     found: boolean;
     user?: {
@@ -879,6 +1057,11 @@ export declare type SearchMatched = 'name' | 'content' | 'both';
 
 declare type SelectionMode_2 = 'none' | 'single-file' | 'single-dir' | 'multi';
 
+/** Set (or clear back to default) a user override. '' unbinds. */
+export declare function setShortcutOverride(id: string, combo: string): void;
+
+export declare function setTheme(id: string): void;
+
 export declare interface ShareInfo {
     uuid: string;
     url: string;
@@ -889,6 +1072,38 @@ export declare interface ShareInfo {
     created_at?: string;
 }
 
+/** Registry order = help/settings display order. */
+export declare const SHORTCUT_ACTIONS: ShortcutActionDef[];
+
+/** One remappable action in the shortcut registry. */
+export declare interface ShortcutActionDef {
+    /** Stable id — also the localStorage override key. */
+    id: string;
+    /** Default combo in canonical form. */
+    defaultCombo: string;
+    /**
+     * Extra built-in combos that also trigger the action but are NOT
+     * remappable (e.g. Backspace on go-up, which carries the
+     * selection-dependent dual behaviour). Shown in the help sheet and
+     * reserved in conflict detection.
+     */
+    fixedCombos?: string[];
+    labelKey: string;
+    groupKey: string;
+    /** false → the combo can't be remapped (Esc). Default true. */
+    customizable?: boolean;
+    /** false → don't preventDefault on match (Enter / Esc). Default true. */
+    prevent?: boolean;
+    /** true → fires even when focus sits in a form control (Esc). */
+    inForms?: boolean;
+}
+
+export declare interface ShortcutConflict {
+    id: string;
+    /** true → the clash is with a fixed (non-remappable) combo. */
+    fixed: boolean;
+}
+
 export declare interface ShortcutHandlers {
     onDelete?: () => void;
     onRename?: () => void;
@@ -904,9 +1119,30 @@ export declare interface ShortcutHandlers {
     onGoUp?: () => void;
     onShowHelp?: () => void;
     onToggleInspector?: () => void;
+    onQuickLook?: () => void;
     hasSelection?: () => boolean;
 }
 
+export declare const ShortcutSettings: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{
+onClose?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare interface ShortcutView {
+    id: string;
+    /** Current (possibly remapped) combo, '' = unbound. */
+    combo: string;
+    /** Non-remappable extra combos (display + reservation only). */
+    fixedCombos: string[];
+    /** Display combos: [combo, ...fixedCombos] minus empties. */
+    keys: string[];
+    labelKey: string;
+    groupKey: string;
+    customizable: boolean;
+    overridden: boolean;
+}
+
 /**
  * Snippet segment parser — the search backend returns content snippets as
  * PLAIN TEXT with matched words wrapped in «guillemets» (contract: no HTML
@@ -936,6 +1172,12 @@ onError?: ((message: string) => any) | undefined;
 onChange?: ((value: boolean) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLButtonElement>;
 
+/**
+ * Create/update/empty the singleton `<style data-filex-theme>` element in
+ * <head>. Idempotent — safe to call from every explorer instance.
+ */
+export declare function syncThemeStyle(id: string): void;
+
 export declare const TagPicker: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 error: (message: string) => any;
 change: (tags: string[]) => any;
@@ -944,8 +1186,36 @@ onError?: ((message: string) => any) | undefined;
 onChange?: ((tags: string[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
+export declare const THEME_LS_KEY = "filex.theme";
+
+export declare function themeById(id: string | null | undefined): ThemeDef | undefined;
+
+export declare interface ThemeDef {
+    /** Stable id — persisted in localStorage, never shown to users. */
+    id: string;
+    /** i18n catalogue key for the display name (tr + en). */
+    nameKey: string;
+    /** Palette applied when the resolved mode is light. */
+    light: ThemeTokenMap;
+    /** Palette applied when the resolved mode is dark. */
+    dark: ThemeTokenMap;
+}
+
+export declare const ThemeGallery: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+select: (id: string) => any;
+}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{
+onClose?: (() => any) | undefined;
+onSelect?: ((id: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
 export declare type ThemeMode = 'light' | 'dark' | 'auto';
 
+export declare const THEMES: ThemeDef[];
+
+/** Map of `--fe-*` custom property → value. */
+export declare type ThemeTokenMap = Record<string, string>;
+
 /** Turkish UI strings. */
 export declare const tr: Record<string, string>;
 
@@ -1157,6 +1427,87 @@ export declare function useMonacoLoader(): {
     getHighlight: typeof getHighlight;
 };
 
+export declare function useOperations(): {
+    active: Ref<    {
+    key: string;
+    kind: OperationKind;
+    name: string;
+    percent: number | null;
+    status: OperationStatus;
+    error: string | null;
+    queued: boolean;
+    doneCount: number | null;
+    totalCount: number | null;
+    uploadedBytes: number | null;
+    totalBytes: number | null;
+    cancellable: boolean;
+    retryable: boolean;
+    startedAt: number;
+    settledAt: number | null;
+    }[], Operation[] | {
+    key: string;
+    kind: OperationKind;
+    name: string;
+    percent: number | null;
+    status: OperationStatus;
+    error: string | null;
+    queued: boolean;
+    doneCount: number | null;
+    totalCount: number | null;
+    uploadedBytes: number | null;
+    totalBytes: number | null;
+    cancellable: boolean;
+    retryable: boolean;
+    startedAt: number;
+    settledAt: number | null;
+    }[]>;
+    history: Ref<    {
+    key: string;
+    kind: OperationKind;
+    name: string;
+    percent: number | null;
+    status: OperationStatus;
+    error: string | null;
+    queued: boolean;
+    doneCount: number | null;
+    totalCount: number | null;
+    uploadedBytes: number | null;
+    totalBytes: number | null;
+    cancellable: boolean;
+    retryable: boolean;
+    startedAt: number;
+    settledAt: number | null;
+    }[], Operation[] | {
+    key: string;
+    kind: OperationKind;
+    name: string;
+    percent: number | null;
+    status: OperationStatus;
+    error: string | null;
+    queued: boolean;
+    doneCount: number | null;
+    totalCount: number | null;
+    uploadedBytes: number | null;
+    totalBytes: number | null;
+    cancellable: boolean;
+    retryable: boolean;
+    startedAt: number;
+    settledAt: number | null;
+    }[]>;
+    runningCount: ComputedRef<number>;
+    errorCount: ComputedRef<number>;
+    hasError: ComputedRef<boolean>;
+    overallPercent: ComputedRef<number | null>;
+    sync: (group: string, items: Array<{
+        input: OperationInput;
+        actions?: OperationActions;
+    }>) => void;
+    cancel: (key: string) => void;
+    retry: (key: string) => void;
+    dismiss: (key: string) => void;
+    clearHistory: () => void;
+};
+
 export declare function usePendingOps(config: ExplorerConfig, api: FileApi, opts?: UsePendingOpsOptions): {
     ops: Ref<    {
     id: number;
@@ -1226,6 +1577,15 @@ export declare function useSelection(items: () => FileNode[]): {
     nodes: ComputedRef<FileNode[]>;
 };
 
+/** Reactive, override-aware view of the registry (registry order). */
+export declare function useShortcutList(): ComputedRef<ShortcutView[]>;
+
+/** Reactive handle for components: `{ themeId, setTheme }`. */
+export declare function useThemeState(): {
+    themeId: Ref<string>;
+    setTheme: (id: string) => void;
+};
+
 export declare function useUploadChunked(config: ExplorerConfig, api: FileApi): {
     uploadFile: (opts: UploadOptions) => Promise<UploadFinalizeResponse>;
 };