@brftech/filex-core 0.39.0 → 0.39.1

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>;
@@ -1081,6 +1084,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.
@@ -2179,6 +2190,13 @@ 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;
@@ -2826,6 +2844,21 @@ export declare interface ShortcutHandlers {
     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<{