@brftech/filex-core 0.5.0 → 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;
@@ -648,6 +681,82 @@ onRefresh?: (() => 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[];
@@ -759,6 +868,8 @@ 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
@@ -785,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;
@@ -830,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;
@@ -841,6 +968,8 @@ declare interface NodeVersion {
     created_at: string;
 }
 
+declare function openSelected(): void;
+
 export declare interface Operation {
     /** `${group}:${id}` — unique across publishers. */
     key: string;
@@ -1030,6 +1159,8 @@ declare interface RecentNode {
     last_opened?: string;
 }
 
+declare function reload(): Promise<void>;
+
 export declare function resetAllShortcuts(): void;
 
 export declare function resetShortcut(id: string): void;
@@ -1055,6 +1186,39 @@ 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. */
@@ -1120,6 +1284,10 @@ export declare interface ShortcutHandlers {
     onShowHelp?: () => void;
     onToggleInspector?: () => void;
     onQuickLook?: () => void;
+    onTabNew?: () => void;
+    onTabClose?: () => void;
+    onTabNext?: () => void;
+    onTabPrev?: () => void;
     hasSelection?: () => boolean;
 }
 
@@ -1178,6 +1346,42 @@ onChange?: ((value: boolean) => any) | undefined;
  */
 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;
@@ -1361,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>;
@@ -1580,6 +1787,32 @@ export declare function useSelection(items: () => 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>;
@@ -1590,6 +1823,6 @@ 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 { }