@brftech/filex-core 0.39.0 → 0.40.0

package/dist/index.d.ts

@@ -624,6 +624,9 @@ export declare interface ClipboardState {
  */
 export declare function comboFromEvent(e: KeyboardEvent): string | null;
 
+/** Canonical combo → what a human should see. '' stays ''. */
+export declare function comboLabel(combo: string): string;
+
 export declare const ConnectionGuideView: DefineComponent<__VLS_Props_17, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_17> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 export declare type ConnectionsApi = ReturnType<typeof useConnections>;
@@ -679,6 +682,12 @@ declare 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;
 }
 
 export declare interface CreatedFolder {
@@ -1081,6 +1090,14 @@ export declare type EscrowOfferState = 'n/a' | 'offer' | 'declined';
 
 export declare function escrowOfferState(m: E2eMarker | null, installationKid: string | null | undefined): EscrowOfferState;
 
+/**
+ * Does this event fire the given registry action? For overlays that
+ * handle their own keys (the quick-look peek) rather than going through
+ * the global binder — without this they keep answering to the DEFAULT
+ * key after the user has remapped the action.
+ */
+export declare function eventMatchesShortcut(e: KeyboardEvent, id: string): boolean;
+
 export declare interface ExplorerConfig {
     /**
      * Modern shorthand: URL prefix for the standard /api/files/* layout.
@@ -1624,10 +1641,10 @@ scopeLabel?: string;
 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;
+"onUpdate:viewMode"?: ((v: ViewMode) => any) | undefined;
+"onUpdate:searchQuery"?: ((v: string) => any) | undefined;
 "onOpen-recents"?: (() => any) | undefined;
 "onUpdate:density"?: ((v: Density) => any) | undefined;
 "onToggle-inspector"?: (() => any) | undefined;
@@ -1641,10 +1658,10 @@ focusSearch: () => Promise<void>;
 action: (key: string) => any;
 upload: () => any;
 "go-up": () => any;
-"update:viewMode": (v: ViewMode) => any;
-"update:searchQuery": (v: string) => any;
 "new-folder": () => any;
 refresh: () => any;
+"update:viewMode": (v: ViewMode) => any;
+"update:searchQuery": (v: string) => any;
 "open-recents": () => any;
 "update:density": (v: Density) => any;
 "toggle-inspector": () => any;
@@ -1767,10 +1784,10 @@ scopeLabel?: string;
 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;
+"onUpdate:viewMode"?: ((v: ViewMode) => any) | undefined;
+"onUpdate:searchQuery"?: ((v: string) => any) | undefined;
 "onOpen-recents"?: (() => any) | undefined;
 "onUpdate:density"?: ((v: Density) => any) | undefined;
 "onToggle-inspector"?: (() => any) | undefined;
@@ -1805,10 +1822,10 @@ targetWire: string;
 originWire?: string;
 }) => any) | undefined;
 onClose?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
 onNavigate?: ((path: string) => any) | undefined;
 "onOpen-trash"?: (() => any) | undefined;
 onActivate?: (() => any) | undefined;
-"onOpen-tab"?: ((path: string) => any) | undefined;
 onContext?: ((node: FileNode | null, ev: MouseEvent) => any) | undefined;
 }>, {
 reload: () => Promise<void>;
@@ -1824,10 +1841,10 @@ targetWire: string;
 originWire?: string;
 }) => any;
 close: () => any;
+"open-tab": (path: string) => any;
 navigate: (path: string) => any;
 "open-trash": () => any;
 activate: () => any;
-"open-tab": (path: string) => any;
 context: (node: FileNode | null, ev: MouseEvent) => any;
 }, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLElement, ComponentProvideOptions, {
 P: {};
@@ -1860,10 +1877,10 @@ targetWire: string;
 originWire?: string;
 }) => any) | undefined;
 onClose?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
 onNavigate?: ((path: string) => any) | undefined;
 "onOpen-trash"?: (() => any) | undefined;
 onActivate?: (() => any) | undefined;
-"onOpen-tab"?: ((path: string) => any) | undefined;
 onContext?: ((node: FileNode | null, ev: MouseEvent) => any) | undefined;
 }>, {
 reload: () => Promise<void>;
@@ -2179,10 +2196,20 @@ declare interface InviteResponse {
  */
 export declare function isExternalUsable(s: ExternalServiceStatus | undefined): boolean;
 
+/**
+ * Is this a Mac-style keyboard? Only affects how a combo is PRINTED —
+ * the canonical form folds Meta into Ctrl, so one saved combo works on
+ * every platform and only the label differs.
+ */
+export declare function isMacLike(): boolean;
+
 /** True when the deployment is not on TLS — several clients refuse that,
  *  and Windows refuses it silently, which is worse. */
 export declare function isPlainHttp(origin: string): boolean;
 
+/** Does the browser eat this combo before the page can see it? */
+export declare function isReservedCombo(combo: string): boolean;
+
 /** True when the staged protocol is simply not there. */
 export declare function isStagedUnsupported(err: unknown): boolean;
 
@@ -2226,6 +2253,25 @@ export declare function markerHasRecovery(m: E2eMarker | null): boolean;
 /** True when the hit matched (at least partly) inside file CONTENT. */
 export declare function matchedInContent(matched: unknown): boolean;
 
+/**
+ * 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 declare const MENU_ACTION_SHORTCUTS: Record<string, string>;
+
+/**
+ * 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 declare function menuShortcutHint(menuKey: string): string;
+
 export declare const messages: Record<LocaleCode, Record<string, string>>;
 
 /** Where an NFS client should point, reported by the server. */
@@ -2726,10 +2772,10 @@ targetWire: string;
 originWire?: string;
 }) => any;
 close: () => any;
+"open-tab": (path: string) => any;
 navigate: (path: string) => any;
 "open-trash": () => any;
 activate: () => any;
-"open-tab": (path: string) => any;
 context: (node: FileNode | null, ev: MouseEvent) => any;
 }, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{
 onTransfer?: ((p: {
@@ -2738,10 +2784,10 @@ targetWire: string;
 originWire?: string;
 }) => any) | undefined;
 onClose?: (() => any) | undefined;
+"onOpen-tab"?: ((path: string) => any) | undefined;
 onNavigate?: ((path: string) => any) | undefined;
 "onOpen-trash"?: (() => any) | undefined;
 onActivate?: (() => any) | undefined;
-"onOpen-tab"?: ((path: string) => any) | undefined;
 onContext?: ((node: FileNode | null, ev: MouseEvent) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
 
@@ -2823,9 +2869,36 @@ export declare interface ShortcutHandlers {
     onTabClose?: () => void;
     onTabNext?: () => void;
     onTabPrev?: () => void;
+    onNewFolder?: () => void;
+    onUpload?: () => void;
+    onRefresh?: () => void;
+    onDownload?: () => void;
+    onPreview?: () => void;
+    onShare?: () => void;
+    onTags?: () => void;
+    onConvert?: () => void;
+    onOpenTab?: () => void;
+    onCopyPath?: () => void;
+    onCopyId?: () => void;
+    onRestore?: () => void;
     hasSelection?: () => boolean;
 }
 
+/**
+ * The one way a hint may name a key.
+ *
+ * ⚠ Never write a key into a hint by hand — not in a template, not in a
+ * locale string. Every combo in this registry is remappable, so a
+ * hardcoded "Ctrl+K" is true only until someone opens the shortcut
+ * settings, and then it is a label that tells the user to press a key
+ * that does nothing. Call this instead and interpolate the result;
+ * `web/tests/ui/shortcutHints.test.ts` fails the build on a literal.
+ *
+ * Returns '' when the action is unbound, so a caller can drop the whole
+ * segment rather than print an empty key cap.
+ */
+export declare function shortcutHint(id: string): string;
+
 export declare const ShortcutSettings: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 close: () => any;
 }, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{