@brftech/filex-core 0.4.2 → 0.6.0

package/dist/index.d.ts

@@ -12,6 +12,39 @@ declare type __VLS_Props = {
     config: ExplorerConfig;
 };
 
+declare type __VLS_Props_10 = {
+    tabs: TabItem[];
+    activeId: string;
+    locale: LocaleCode;
+    /** false → the split toggle is hidden (narrow embeds). */
+    splitEnabled?: boolean;
+    /** true → the split toggle renders pressed (active tab has a pane). */
+    splitActive?: boolean;
+};
+
+declare type __VLS_Props_11 = {
+    api: FileApi;
+    /** Opening location, in the host's `currentPath` form. */
+    initialPath: string;
+    locale: LocaleCode;
+    /** Host's own qualify(): user path → wire `<adapter>://<rel>`. */
+    qualify: (p: string) => string;
+    /** Host's wire → user-path converter (multi-storage aware). */
+    toUser: (wire: string) => string;
+    /** Host's rootFloor clamp — keeps the pane inside the confine. */
+    clamp: (p: string) => string;
+    /** Label for the root crumb (adapter name / storage list). */
+    rootLabel: string;
+    /** rootFloor (user-path form, '' when unconfined) — trims crumbs. */
+    floor?: string;
+    /** Multi-storage mode: '' is the virtual drives root (no fetch). */
+    multiRoot?: boolean;
+    /** Synthesized storage rows for the virtual drives root. */
+    virtualRows?: () => FileNode[];
+    /** Active-panel highlight (keyboard target). */
+    active?: boolean;
+};
+
 declare type __VLS_Props_2 = {
     open: boolean;
     locale: LocaleCode;
@@ -71,6 +104,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 +232,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 +249,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 +576,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,17 +668,95 @@ 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;
+splitPaneRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+api: FileApi;
+initialPath: string;
+locale: LocaleCode;
+qualify: (p: string) => string;
+toUser: (wire: string) => string;
+clamp: (p: string) => string;
+rootLabel: string;
+floor?: string;
+multiRoot?: boolean;
+virtualRows?: () => FileNode[];
+active?: boolean;
+}> & Readonly<{
+onClose?: (() => any) | undefined;
+onNavigate?: ((path: string) => any) | undefined;
+onActivate?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
+onTransfer?: ((p: {
+sources: string[];
+targetWire: string;
+originWire?: string;
+}) => any) | undefined;
+}>, {
+reload: () => Promise<void>;
+goUp: () => void;
+selectAll: () => void;
+openSelected: () => void;
+selectedNodes: () => FileNode[];
+getPath: () => string;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+navigate: (path: string) => any;
+activate: () => any;
+"open-tab": (path: string) => any;
+transfer: (p: {
+sources: string[];
+targetWire: string;
+originWire?: string;
+}) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLElement, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+api: FileApi;
+initialPath: string;
+locale: LocaleCode;
+qualify: (p: string) => string;
+toUser: (wire: string) => string;
+clamp: (p: string) => string;
+rootLabel: string;
+floor?: string;
+multiRoot?: boolean;
+virtualRows?: () => FileNode[];
+active?: boolean;
+}> & Readonly<{
+onClose?: (() => any) | undefined;
+onNavigate?: ((path: string) => any) | undefined;
+onActivate?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
+onTransfer?: ((p: {
+sources: string[];
+targetWire: string;
+originWire?: string;
+}) => any) | undefined;
+}>, {
+reload: () => Promise<void>;
+goUp: () => void;
+selectAll: () => void;
+openSelected: () => void;
+selectedNodes: () => FileNode[];
+getPath: () => string;
+}, {}, {}, {}, {}> | null;
 ctxRef: CreateComponentPublicInstanceWithMixins<Readonly<{
 locale: LocaleCode;
 actions: ContextAction[];
@@ -673,11 +847,29 @@ 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. */
 export declare function getMonaco(): unknown | null;
 
+declare function getPath(): string;
+
 /**
  * One hit from the dedicated files-search endpoint. The backend returns raw
  * node rows (`{results: [...]}`), so `path` is the IN-STORAGE relative path
@@ -704,6 +896,8 @@ export declare interface GlobalSearchHit {
 
 export declare type GlobalSearchScope = 'name' | 'content' | 'all';
 
+declare function goUp(): void;
+
 /** A single ACL grant row (RBAC permissions panel). */
 declare interface Grant {
     id: number;
@@ -749,6 +943,20 @@ export declare function matchedInContent(matched: unknown): boolean;
 
 export declare const messages: Record<LocaleCode, Record<string, string>>;
 
+/** Mirrors backend `model.NodeComment` (GET /api/files/comments?node_id=…). */
+declare interface NodeComment {
+    id: number;
+    node_id: number;
+    user_id: number;
+    body: string;
+    created_at: string;
+    updated_at?: string;
+    /** Joined author display name (email fallback), filled by the backend. */
+    author_name?: string;
+    /** Whether the CURRENT caller may delete this row (author or admin). */
+    can_delete?: boolean;
+}
+
 /** Mirrors backend `model.NodeVersion` (GET /api/files/versions?node_id=…). */
 declare interface NodeVersion {
     id: number;
@@ -760,6 +968,91 @@ declare interface NodeVersion {
     created_at: string;
 }
 
+declare function openSelected(): void;
+
+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 +1132,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 +1159,12 @@ declare interface RecentNode {
     last_opened?: string;
 }
 
+declare function reload(): Promise<void>;
+
+export declare function resetAllShortcuts(): void;
+
+export declare function resetShortcut(id: string): void;
+
 declare interface ResolveEmailResponse {
     found: boolean;
     user?: {
@@ -877,8 +1186,46 @@ export declare function resolveEndpoints(config: ExplorerConfig): EndpointMap;
 /** Matched-in values the search contract allows on a hit. */
 export declare type SearchMatched = 'name' | 'content' | 'both';
 
+export declare const SecondaryPane: DefineComponent<__VLS_Props_11, {
+reload: typeof reload;
+goUp: typeof goUp;
+selectAll: typeof selectAll;
+openSelected: typeof openSelected;
+selectedNodes: typeof selectedNodes;
+getPath: typeof getPath;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+navigate: (path: string) => any;
+activate: () => any;
+"open-tab": (path: string) => any;
+transfer: (p: {
+sources: string[];
+targetWire: string;
+originWire?: string;
+}) => any;
+}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{
+onClose?: (() => any) | undefined;
+onNavigate?: ((path: string) => any) | undefined;
+onActivate?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
+onTransfer?: ((p: {
+sources: string[];
+targetWire: string;
+originWire?: string;
+}) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
+
+declare function selectAll(): void;
+
+declare function selectedNodes(): FileNode[];
+
 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 +1236,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 +1283,34 @@ export declare interface ShortcutHandlers {
     onGoUp?: () => void;
     onShowHelp?: () => void;
     onToggleInspector?: () => void;
+    onQuickLook?: () => void;
+    onTabNew?: () => void;
+    onTabClose?: () => void;
+    onTabNext?: () => void;
+    onTabPrev?: () => 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 +1340,48 @@ 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 TabBar: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: (id: string) => any;
+select: (id: string) => any;
+new: () => any;
+reorder: (from: number, to: number) => any;
+"toggle-split": () => any;
+}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{
+onClose?: ((id: string) => any) | undefined;
+onSelect?: ((id: string) => any) | undefined;
+onNew?: (() => any) | undefined;
+onReorder?: ((from: number, to: number) => any) | undefined;
+"onToggle-split"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+
+declare interface TabItem {
+    id: string;
+    label: string;
+    /** true → the tab carries a split pane (small accent dot). */
+    split: boolean;
+}
+
+export declare type TabsApi = ReturnType<typeof useTabs>;
+
+/** Per-tab split state — the secondary pane's own location. */
+export declare interface TabSplit {
+    path: string;
+}
+
+export declare interface TabState {
+    id: string;
+    /** Location snapshot in `currentPath` form (see module docs). */
+    path: string;
+    viewMode: ViewMode;
+    split: TabSplit | null;
+}
+
 export declare const TagPicker: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 error: (message: string) => any;
 change: (tags: string[]) => any;
@@ -944,8 +1390,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>;
 
@@ -1091,6 +1565,9 @@ export declare function useFileApi(config: ExplorerConfig): {
     listVersions: (nodeId: number) => Promise<NodeVersion[]>;
     restoreVersion: (nodeId: number, versionId: number, snapshotCurrent?: boolean) => Promise<void>;
     snapshotVersion: (nodeId: number) => Promise<void>;
+    listComments: (nodeId: number) => Promise<NodeComment[]>;
+    addComment: (nodeId: number, body: string) => Promise<NodeComment>;
+    deleteComment: (id: number) => Promise<void>;
     listPermissions: (path: string) => Promise<PermissionsResponse>;
     resolveEmail: (email: string) => Promise<ResolveEmailResponse>;
     searchUsers: (q: string) => Promise<UserSearchResponse>;
@@ -1157,6 +1634,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,10 +1784,45 @@ export declare function useSelection(items: () => FileNode[]): {
     nodes: ComputedRef<FileNode[]>;
 };
 
+/** Reactive, override-aware view of the registry (registry order). */
+export declare function useShortcutList(): ComputedRef<ShortcutView[]>;
+
+export declare function useTabs(opts: UseTabsOptions): {
+    tabs: Ref<TabState[], TabState[]>;
+    activeId: Ref<string, string>;
+    activeTab: ComputedRef<TabState | null>;
+    activeIndex: ComputedRef<number>;
+    hasMultiple: ComputedRef<boolean>;
+    restore: () => boolean;
+    seed: (path: string, viewMode: ViewMode) => void;
+    syncActive: (patch: Partial<Pick<TabState, "path" | "viewMode">>) => void;
+    openTab: (path: string, o: {
+        viewMode: ViewMode;
+        background?: boolean;
+        split?: TabSplit | null;
+    }) => TabState;
+    closeTab: (id: string) => TabState | null;
+    activate: (id: string) => TabState | null;
+    step: (delta: number) => TabState | null;
+    move: (from: number, to: number) => void;
+    setSplit: (split: TabSplit | null) => void;
+};
+
+declare interface UseTabsOptions {
+    /** localStorage key; null disables persistence entirely. */
+    storageKey: string | null;
+}
+
+/** 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>;
 };
 
-export declare type ViewMode = 'list' | 'grid';
+export declare type ViewMode = 'list' | 'grid' | 'gallery';
 
 export { }