@flipdish/ui-library 0.29.0 → 0.30.0

package/dist/hooks/__internal__/useHotkeyHint/useHotkeyHint.d.ts

@@ -0,0 +1,22 @@
+export interface HotkeyHintOptions {
+    /**
+     * Which devices press ⌘ for `mod`. `mac` matches `react-hotkeys-hook`, which uses ⌘ on macOS only.
+     * `apple` matches editors built on ProseMirror, which also use ⌘ on iPhone and iPad.
+     * @default "mac"
+     */
+    commandOn?: 'mac' | 'apple';
+}
+/**
+ * Turns a shortcut into the label for the user's device: `mod+k` and `⌘K` both read `⌘K` on macOS and
+ * `Ctrl K` elsewhere. Serves every shortcut label in the library, whether the value is a real hotkey or
+ * display text: text that is not a hotkey (`Hold to talk`) is returned exactly as written. Reads as
+ * the non-Mac form on the server and during hydration.
+ *
+ * @param hotkey `react-hotkeys-hook` syntax (`mod+k`, `mod+slash`, a sequence such as `g>p`), the symbol
+ * shorthand (`⌘K`), a shortcut written out (`Ctrl+K`), or any other text.
+ * @returns The label, or `undefined` when nothing is given.
+ *
+ * @summary format a hotkey as a platform-aware label such as ⌘K or Ctrl K
+ */
+export declare const useHotkeyHint: (hotkey: string | null | undefined, { commandOn }?: HotkeyHintOptions) => string | undefined;
+//# sourceMappingURL=useHotkeyHint.d.ts.map

package/dist/hooks/__internal__/useHotkeyHint/useHotkeyHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkeyHint.d.ts","sourceRoot":"","sources":["../../../../src/hooks/__internal__/useHotkeyHint/useHotkeyHint.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,gBAAuB,iBAAsB,KAAG,MAAM,GAAG,SAIzH,CAAC"}

package/dist/hooks/__internal__/useHotkeyHint/useHotkeyHint.js

@@ -0,0 +1,22 @@
+import { usePlatform } from '@flipdish/ui-library/hooks/usePlatform';
+import { formatHotkeyLabel } from '../../../utilities/__internal__/hotkeysUtils/hotkeys.utils.js';
+
+/**
+ * Turns a shortcut into the label for the user's device: `mod+k` and `⌘K` both read `⌘K` on macOS and
+ * `Ctrl K` elsewhere. Serves every shortcut label in the library, whether the value is a real hotkey or
+ * display text: text that is not a hotkey (`Hold to talk`) is returned exactly as written. Reads as
+ * the non-Mac form on the server and during hydration.
+ *
+ * @param hotkey `react-hotkeys-hook` syntax (`mod+k`, `mod+slash`, a sequence such as `g>p`), the symbol
+ * shorthand (`⌘K`), a shortcut written out (`Ctrl+K`), or any other text.
+ * @returns The label, or `undefined` when nothing is given.
+ *
+ * @summary format a hotkey as a platform-aware label such as ⌘K or Ctrl K
+ */
+const useHotkeyHint = (hotkey, { commandOn = 'mac' } = {}) => {
+    const { isMac, isApple } = usePlatform();
+    return hotkey ? formatHotkeyLabel(hotkey, commandOn === 'apple' ? isApple : isMac) : undefined;
+};
+
+export { useHotkeyHint };
+//# sourceMappingURL=useHotkeyHint.js.map

package/dist/hooks/__internal__/useHotkeyHint/useHotkeyHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkeyHint.js","sources":["../../../../src/hooks/__internal__/useHotkeyHint/useHotkeyHint.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAcA;;;;;;;;;;;AAWG;AACI,MAAM,aAAa,GAAG,CAAC,MAAiC,EAAE,EAAE,SAAS,GAAG,KAAK,EAAA,GAAwB,EAAE,KAAwB;IACpI,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;IAExC,OAAO,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC,GAAG,SAAS;AAChG;;;;"}

package/dist/hooks/__internal__/useKeySequences/useKeySequences.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+var React = require('react');
+var hotkeys_utils = require('../../../utilities/__internal__/hotkeysUtils/hotkeys.utils.cjs');
+var platform_utils = require('../../../utilities/__internal__/platformUtils/platform.utils.cjs');
+
+/**
+ * Listens for plain-key shortcuts typed anywhere on the page: single keys (`?`) and sequences
+ * (`g` then `p`), including sequences that share a first key, which `react-hotkeys-hook` cannot
+ * tell apart. Keys pressed with ⌘/Ctrl/Alt or Shift plus a letter, or while focus is in a field, are ignored so ordinary
+ * typing and other shortcuts are never hijacked. A sequence must be completed within `timeoutMs`
+ * of its previous key.
+ *
+ * @summary match single-key and multi-key plain shortcuts outside form fields
+ */
+const useKeySequences = (sequences, onMatch, timeoutMs = 1000) => {
+    const latest = React.useRef({ sequences, onMatch });
+    React.useEffect(() => {
+        latest.current = { sequences, onMatch };
+    });
+    const hasSequences = sequences.length > 0;
+    React.useEffect(() => {
+        if (!hasSequences)
+            return;
+        let buffer = [];
+        let lastKeyAt = 0;
+        const onKeyDown = (event) => {
+            // A key name longer than one character (Shift, Enter, ArrowDown) is not a typed character.
+            if (event.defaultPrevented || event.repeat || event.key.length !== 1 || hotkeys_utils.isTypingInField(event))
+                return;
+            // AltGr (reported as Ctrl+Alt on Windows) and Option on Apple keyboards type characters such as `@` or `[` on many layouts.
+            const os = platform_utils.getPlatformOs();
+            const typesCharacter = event.getModifierState('AltGraph') || ((os === 'macos' || os === 'ios') && event.altKey && !event.ctrlKey);
+            if (event.metaKey || ((event.ctrlKey || event.altKey) && !typesCharacter))
+                return;
+            // Shift plus a letter is its own shortcut (`⇧d`), not the letter.
+            if (event.shiftKey && event.key.toLowerCase() !== event.key.toUpperCase())
+                return;
+            const now = Date.now();
+            const result = hotkeys_utils.advanceKeySequence(now - lastKeyAt > timeoutMs ? [] : buffer, event.key.toLowerCase(), latest.current.sequences);
+            buffer = result.buffer;
+            lastKeyAt = now;
+            if (result.matched !== undefined) {
+                event.preventDefault();
+                latest.current.onMatch(result.matched);
+            }
+        };
+        document.addEventListener('keydown', onKeyDown);
+        return () => document.removeEventListener('keydown', onKeyDown);
+    }, [hasSequences, timeoutMs]);
+};
+
+exports.useKeySequences = useKeySequences;
+//# sourceMappingURL=useKeySequences.cjs.map

package/dist/hooks/__internal__/useKeySequences/useKeySequences.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeySequences.cjs","sources":["../../../../src/hooks/__internal__/useKeySequences/useKeySequences.ts"],"sourcesContent":[null],"names":["useRef","useEffect","isTypingInField","getPlatformOs","advanceKeySequence"],"mappings":";;;;;;AAMA;;;;;;;;AAQG;AACI,MAAM,eAAe,GAAG,CAAC,SAAqB,EAAE,OAAgC,EAAE,SAAS,GAAG,IAAI,KAAU;IACjH,MAAM,MAAM,GAAGA,YAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAC7CC,eAAS,CAAC,MAAK;QACb,MAAM,CAAC,OAAO,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE;AACzC,IAAA,CAAC,CAAC;AAEF,IAAA,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;IAEzCA,eAAS,CAAC,MAAK;AACb,QAAA,IAAI,CAAC,YAAY;YAAE;QAEnB,IAAI,MAAM,GAAa,EAAE;QACzB,IAAI,SAAS,GAAG,CAAC;AAEjB,QAAA,MAAM,SAAS,GAAG,CAAC,KAAoB,KAAI;;AAEzC,YAAA,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAIC,6BAAe,CAAC,KAAK,CAAC;gBAAE;;AAEhG,YAAA,MAAM,EAAE,GAAGC,4BAAa,EAAE;AAC1B,YAAA,MAAM,cAAc,GAAG,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AACjI,YAAA,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC;gBAAE;;AAE3E,YAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE;gBAAE;AAE3E,YAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,YAAA,MAAM,MAAM,GAAGC,gCAAkB,CAAC,GAAG,GAAG,SAAS,GAAG,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AAC/H,YAAA,MAAM,GAAG,MAAM,CAAC,MAAM;YACtB,SAAS,GAAG,GAAG;AAEf,YAAA,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE;gBAChC,KAAK,CAAC,cAAc,EAAE;gBACtB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACxC;AACF,QAAA,CAAC;AAED,QAAA,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/C,OAAO,MAAM,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC;AACjE,IAAA,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAC/B;;;;"}

package/dist/hooks/__internal__/useKeySequences/useKeySequences.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Listens for plain-key shortcuts typed anywhere on the page: single keys (`?`) and sequences
+ * (`g` then `p`), including sequences that share a first key, which `react-hotkeys-hook` cannot
+ * tell apart. Keys pressed with ⌘/Ctrl/Alt or Shift plus a letter, or while focus is in a field, are ignored so ordinary
+ * typing and other shortcuts are never hijacked. A sequence must be completed within `timeoutMs`
+ * of its previous key.
+ *
+ * @summary match single-key and multi-key plain shortcuts outside form fields
+ */
+export declare const useKeySequences: (sequences: string[][], onMatch: (index: number) => void, timeoutMs?: number) => void;
+//# sourceMappingURL=useKeySequences.d.ts.map

package/dist/hooks/__internal__/useKeySequences/useKeySequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeySequences.d.ts","sourceRoot":"","sources":["../../../../src/hooks/__internal__/useKeySequences/useKeySequences.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,EAAE,EAAE,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAAE,kBAAgB,KAAG,IAsC3G,CAAC"}

package/dist/hooks/__internal__/useKeySequences/useKeySequences.js

@@ -0,0 +1,52 @@
+import { useRef, useEffect } from 'react';
+import { isTypingInField, advanceKeySequence } from '../../../utilities/__internal__/hotkeysUtils/hotkeys.utils.js';
+import { getPlatformOs } from '../../../utilities/__internal__/platformUtils/platform.utils.js';
+
+/**
+ * Listens for plain-key shortcuts typed anywhere on the page: single keys (`?`) and sequences
+ * (`g` then `p`), including sequences that share a first key, which `react-hotkeys-hook` cannot
+ * tell apart. Keys pressed with ⌘/Ctrl/Alt or Shift plus a letter, or while focus is in a field, are ignored so ordinary
+ * typing and other shortcuts are never hijacked. A sequence must be completed within `timeoutMs`
+ * of its previous key.
+ *
+ * @summary match single-key and multi-key plain shortcuts outside form fields
+ */
+const useKeySequences = (sequences, onMatch, timeoutMs = 1000) => {
+    const latest = useRef({ sequences, onMatch });
+    useEffect(() => {
+        latest.current = { sequences, onMatch };
+    });
+    const hasSequences = sequences.length > 0;
+    useEffect(() => {
+        if (!hasSequences)
+            return;
+        let buffer = [];
+        let lastKeyAt = 0;
+        const onKeyDown = (event) => {
+            // A key name longer than one character (Shift, Enter, ArrowDown) is not a typed character.
+            if (event.defaultPrevented || event.repeat || event.key.length !== 1 || isTypingInField(event))
+                return;
+            // AltGr (reported as Ctrl+Alt on Windows) and Option on Apple keyboards type characters such as `@` or `[` on many layouts.
+            const os = getPlatformOs();
+            const typesCharacter = event.getModifierState('AltGraph') || ((os === 'macos' || os === 'ios') && event.altKey && !event.ctrlKey);
+            if (event.metaKey || ((event.ctrlKey || event.altKey) && !typesCharacter))
+                return;
+            // Shift plus a letter is its own shortcut (`⇧d`), not the letter.
+            if (event.shiftKey && event.key.toLowerCase() !== event.key.toUpperCase())
+                return;
+            const now = Date.now();
+            const result = advanceKeySequence(now - lastKeyAt > timeoutMs ? [] : buffer, event.key.toLowerCase(), latest.current.sequences);
+            buffer = result.buffer;
+            lastKeyAt = now;
+            if (result.matched !== undefined) {
+                event.preventDefault();
+                latest.current.onMatch(result.matched);
+            }
+        };
+        document.addEventListener('keydown', onKeyDown);
+        return () => document.removeEventListener('keydown', onKeyDown);
+    }, [hasSequences, timeoutMs]);
+};
+
+export { useKeySequences };
+//# sourceMappingURL=useKeySequences.js.map

package/dist/hooks/__internal__/useKeySequences/useKeySequences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeySequences.js","sources":["../../../../src/hooks/__internal__/useKeySequences/useKeySequences.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAMA;;;;;;;;AAQG;AACI,MAAM,eAAe,GAAG,CAAC,SAAqB,EAAE,OAAgC,EAAE,SAAS,GAAG,IAAI,KAAU;IACjH,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAC7C,SAAS,CAAC,MAAK;QACb,MAAM,CAAC,OAAO,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE;AACzC,IAAA,CAAC,CAAC;AAEF,IAAA,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;IAEzC,SAAS,CAAC,MAAK;AACb,QAAA,IAAI,CAAC,YAAY;YAAE;QAEnB,IAAI,MAAM,GAAa,EAAE;QACzB,IAAI,SAAS,GAAG,CAAC;AAEjB,QAAA,MAAM,SAAS,GAAG,CAAC,KAAoB,KAAI;;AAEzC,YAAA,IAAI,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC;gBAAE;;AAEhG,YAAA,MAAM,EAAE,GAAG,aAAa,EAAE;AAC1B,YAAA,MAAM,cAAc,GAAG,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AACjI,YAAA,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC;gBAAE;;AAE3E,YAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE;gBAAE;AAE3E,YAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,YAAA,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,GAAG,SAAS,GAAG,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;AAC/H,YAAA,MAAM,GAAG,MAAM,CAAC,MAAM;YACtB,SAAS,GAAG,GAAG;AAEf,YAAA,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE;gBAChC,KAAK,CAAC,cAAc,EAAE;gBACtB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACxC;AACF,QAAA,CAAC;AAED,QAAA,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/C,OAAO,MAAM,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC;AACjE,IAAA,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;AAC/B;;;;"}

package/dist/hooks/usePlatform/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var React = require('react');
+var platform_utils = require('../../utilities/__internal__/platformUtils/platform.utils.cjs');
+
+const subscribeToNothing = () => () => { };
+const getServerOs = () => 'unknown';
+/**
+ * Reports the operating system of the user's device, for wording that depends on it: a shortcut
+ * label, a download link, a help article. Detection reads the user agent, so treat it as a best
+ * guess and never as a reason to change behaviour; use `useBreakpoints` or feature detection for
+ * that. Every flag is `false` on the server and during hydration, then settles on the real device.
+ *
+ * @summary detect the user's operating system, safely across hydration
+ */
+const usePlatform = () => {
+    const os = React.useSyncExternalStore(subscribeToNothing, platform_utils.getPlatformOs, getServerOs);
+    return React.useMemo(() => ({ os, isMac: os === 'macos', isApple: os === 'macos' || os === 'ios', isWindows: os === 'windows' }), [os]);
+};
+
+exports.usePlatform = usePlatform;
+//# sourceMappingURL=index.cjs.map

package/dist/hooks/usePlatform/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../src/hooks/usePlatform/index.ts"],"sourcesContent":[null],"names":["useSyncExternalStore","getPlatformOs","useMemo"],"mappings":";;;;;AAmBA,MAAM,kBAAkB,GAAG,MAAM,MAAK,EAAE,CAAC;AACzC,MAAM,WAAW,GAAG,MAAkB,SAAS;AAE/C;;;;;;;AAOG;AACI,MAAM,WAAW,GAAG,MAAmB;IAC5C,MAAM,EAAE,GAAGA,0BAAoB,CAAC,kBAAkB,EAAEC,4BAAa,EAAE,WAAW,CAAC;AAE/E,IAAA,OAAOC,aAAO,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACnI;;;;"}

package/dist/hooks/usePlatform/index.d.ts

@@ -0,0 +1,22 @@
+import type { PlatformOs } from '../../utilities/__internal__/platformUtils/platform.utils';
+export type { PlatformOs };
+export interface PlatformInfo {
+    /** The operating system, or `unknown` on the server, during hydration and when it cannot be told. */
+    os: PlatformOs;
+    /** macOS only, where ⌘ is the primary shortcut modifier. Also true for an iPad in desktop mode, which reports itself as a Mac. */
+    isMac: boolean;
+    /** Any Apple device: macOS, iPhone or iPad. */
+    isApple: boolean;
+    /** Windows only, where the primary shortcut modifier is `ctrl`. */
+    isWindows: boolean;
+}
+/**
+ * Reports the operating system of the user's device, for wording that depends on it: a shortcut
+ * label, a download link, a help article. Detection reads the user agent, so treat it as a best
+ * guess and never as a reason to change behaviour; use `useBreakpoints` or feature detection for
+ * that. Every flag is `false` on the server and during hydration, then settles on the real device.
+ *
+ * @summary detect the user's operating system, safely across hydration
+ */
+export declare const usePlatform: () => PlatformInfo;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/usePlatform/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePlatform/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2DAA2D,CAAC;AAE5F,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,EAAE,EAAE,UAAU,CAAC;IACf,kIAAkI;IAClI,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAKD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,QAAO,YAI9B,CAAC"}

package/dist/hooks/usePlatform/index.js

@@ -0,0 +1,20 @@
+import { useSyncExternalStore, useMemo } from 'react';
+import { getPlatformOs } from '../../utilities/__internal__/platformUtils/platform.utils.js';
+
+const subscribeToNothing = () => () => { };
+const getServerOs = () => 'unknown';
+/**
+ * Reports the operating system of the user's device, for wording that depends on it: a shortcut
+ * label, a download link, a help article. Detection reads the user agent, so treat it as a best
+ * guess and never as a reason to change behaviour; use `useBreakpoints` or feature detection for
+ * that. Every flag is `false` on the server and during hydration, then settles on the real device.
+ *
+ * @summary detect the user's operating system, safely across hydration
+ */
+const usePlatform = () => {
+    const os = useSyncExternalStore(subscribeToNothing, getPlatformOs, getServerOs);
+    return useMemo(() => ({ os, isMac: os === 'macos', isApple: os === 'macos' || os === 'ios', isWindows: os === 'windows' }), [os]);
+};
+
+export { usePlatform };
+//# sourceMappingURL=index.js.map

package/dist/hooks/usePlatform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/hooks/usePlatform/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAmBA,MAAM,kBAAkB,GAAG,MAAM,MAAK,EAAE,CAAC;AACzC,MAAM,WAAW,GAAG,MAAkB,SAAS;AAE/C;;;;;;;AAOG;AACI,MAAM,WAAW,GAAG,MAAmB;IAC5C,MAAM,EAAE,GAAG,oBAAoB,CAAC,kBAAkB,EAAE,aAAa,EAAE,WAAW,CAAC;AAE/E,IAAA,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,OAAO,IAAI,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AACnI;;;;"}

package/dist/native/hooks/usePlatform/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `usePlatform` has no React Native implementation.
+ *
+ * This is a generated types-only stub (scripts/emit-native-stubs.mjs). It exists so
+ * that importing `@flipdish/ui-library/hooks/usePlatform` from React Native fails at
+ * compile time rather than resolving to the web build's types. There is no
+ * matching `index.js`, so Metro cannot bundle this module either.
+ *
+ * To make `usePlatform` available on React Native, add an `index.native.tsx` beside
+ * its `index.tsx` — the build picks it up automatically and this stub disappears.
+ */
+export declare const __NO_REACT_NATIVE_IMPLEMENTATION__: never;

package/dist/utilities/__internal__/hotkeysUtils/hotkeys.utils.cjs

@@ -8,7 +8,8 @@
  * package directly. Keep it in sync with the source rather than editing it:
  * https://github.com/JohannesKlauss/react-hotkeys-hook/blob/main/packages/react-hotkeys-hook/src/lib/parseHotkeys.ts
  *
- * The display section below it is ours: platform detection and hint formatting built on that parser.
+ * The display section below it is ours: normalising and formatting hotkeys for labels, built on that parser.
+ * Platform detection lives in `platformUtils/platform.utils.ts`.
  */
 const reservedModifierKeywords = ['shift', 'alt', 'meta', 'mod', 'ctrl', 'control'];
 const mappedKeys = {
@@ -73,33 +74,239 @@ function parseHotkey(hotkey, splitKey = '+', sequenceSplitKey = '>', useKey = fa
 }
 // #endregion
 // #region Display
-const APPLE_MODIFIERS = { mod: '⌘', meta: '⌘', ctrl: '⌃', control: '⌃', alt: '⌥', shift: '⇧' };
+const MAC_MODIFIERS = { mod: '⌘', meta: '⌘', ctrl: '⌃', control: '⌃', alt: '⌥', shift: '⇧' };
 const OTHER_MODIFIERS = { mod: 'Ctrl', meta: 'Win', ctrl: 'Ctrl', control: 'Ctrl', alt: 'Alt', shift: 'Shift' };
+const LEGACY_SYMBOLS = { '⌘': 'mod', '⌃': 'ctrl', '⌥': 'alt', '⇧': 'shift' };
+// `react-hotkeys-hook` matches the physical key, so it knows punctuation by name (`slash`), never by character (`/`).
+const PUNCTUATION_KEY_NAMES = {
+    '/': 'slash',
+    ',': 'comma',
+    '.': 'period',
+    ';': 'semicolon',
+    "'": 'quote',
+    '[': 'bracketleft',
+    ']': 'bracketright',
+    '\\': 'backslash',
+    '-': 'minus',
+    '=': 'equal',
+    '`': 'backquote',
+};
+const KEY_NAME_CHARACTERS = Object.fromEntries(Object.entries(PUNCTUATION_KEY_NAMES).map(([character, name]) => [name, character]));
+// Characters typed with Shift on a US layout, and the key they sit on.
+const SHIFTED_KEYS = {
+    '?': 'slash',
+    '<': 'comma',
+    '>': 'period',
+    ':': 'semicolon',
+    '"': 'quote',
+    '{': 'bracketleft',
+    '}': 'bracketright',
+    '|': 'backslash',
+    _: 'minus',
+    '~': 'backquote',
+    '!': '1',
+    '@': '2',
+    '#': '3',
+    $: '4',
+    '%': '5',
+    '^': '6',
+    '&': '7',
+    '*': '8',
+    '(': '9',
+    ')': '0',
+};
+/** The character a key name stands for (`slash` is `/`), or the name itself when it is not punctuation. */
+const hotkeyCharacter = (key) => KEY_NAME_CHARACTERS[key] ?? key;
+/**
+ * Accepts a hotkey in `react-hotkeys-hook` format (`mod+k`) or the symbol shorthand (`⌘K`, `⌘⇧P`,
+ * `⌘+Shift+K`) and returns the hook format. `⌘` becomes `mod`, so it also works with Ctrl outside
+ * macOS. Within a token, leading symbols are modifiers and whatever follows them is one key.
+ * Punctuation becomes the key name the hook matches on (`⌘/` is `mod+slash`).
+ *
+ * `forDisplay` keeps a shifted symbol as written (`⌘?`). Without it, a shifted symbol in a combination
+ * becomes Shift plus its key (`mod+shift+slash`), which is the form that can be registered.
+ */
+const normalizeHotkey = (hotkey, { forDisplay = false } = {}) => {
+    const keys = hotkey
+        .split('+')
+        .flatMap((token) => {
+        const characters = [...token.trim()];
+        const symbolCount = characters.findIndex((character) => !(character in LEGACY_SYMBOLS));
+        const symbols = symbolCount === -1 ? characters : characters.slice(0, symbolCount);
+        const key = symbolCount === -1 ? '' : characters.slice(symbolCount).join('');
+        return [...symbols.map((symbol) => LEGACY_SYMBOLS[symbol]), PUNCTUATION_KEY_NAMES[key] ?? key.toLowerCase()];
+    })
+        .filter(Boolean);
+    // On its own a shifted symbol stays a character, so it is matched as typed on any keyboard layout.
+    const expandShifted = !forDisplay && keys.some(isHotkeyModifier);
+    return [...new Set(keys.flatMap((key) => (expandShifted && key in SHIFTED_KEYS ? ['shift', SHIFTED_KEYS[key]] : [key])))].join('+');
+};
+/**
+ * Turns an item's `shortcutKeys` into hook-format steps. Each entry is one step (`['⌘e']` is a combination,
+ * `['g', 'p']` is G then P), except that an entry holding only modifiers joins the entry after it, so the
+ * older `['⌘', 'H']` spelling still means ⌘H.
+ */
+const toHotkeySteps = (shortcutKeys, options) => {
+    const steps = [];
+    let pendingModifiers = [];
+    for (const entry of shortcutKeys) {
+        const normalized = normalizeHotkey(entry, options);
+        if (!normalized)
+            continue;
+        if (normalized.split('+').every(isHotkeyModifier)) {
+            pendingModifiers.push(normalized);
+            continue;
+        }
+        steps.push([...pendingModifiers, normalized].join('+'));
+        pendingModifiers = [];
+    }
+    return pendingModifiers.length ? [...steps, pendingModifiers.join('+')] : steps;
+};
+/**
+ * Sorts an item shortcut by how it can be triggered:
+ * - `combination`: one step held with ⌘/Ctrl/Alt, safe to fire even while the user is typing.
+ * - `guarded`: one step that typing could produce (Shift+A) or a named key (F1), so it is ignored in fields.
+ * - `typed`: character keys pressed in turn (`?`, G then P), also ignored in fields.
+ * - `unsupported`: several steps with a modifier or named key, which no handler can match.
+ */
+const getItemHotkeyKind = (steps) => {
+    const stepKeys = steps.map((step) => step.split('+'));
+    const keys = stepKeys.flat();
+    const modifiers = keys.filter(isHotkeyModifier);
+    // A step with no key of its own would fire on every press of the modifier.
+    if (stepKeys.some((step) => step.every(isHotkeyModifier)))
+        return 'unsupported';
+    if (modifiers.length === 0 && keys.every((key) => hotkeyCharacter(key).length === 1))
+        return 'typed';
+    if (steps.length !== 1)
+        return 'unsupported';
+    return modifiers.some((modifier) => modifier !== 'shift') ? 'combination' : 'guarded';
+};
+const EDITABLE_TAGS = ['INPUT', 'TEXTAREA', 'SELECT'];
+const EDITABLE_ROLES = ['textbox', 'searchbox', 'combobox', 'spinbutton'];
+const isEditable = (target) => target instanceof HTMLElement &&
+    (target.isContentEditable || EDITABLE_TAGS.includes(target.tagName) || EDITABLE_ROLES.includes(target.getAttribute('role') ?? ''));
+const deepActiveElement = () => {
+    let element = document.activeElement;
+    while (element?.shadowRoot?.activeElement)
+        element = element.shadowRoot.activeElement;
+    return element;
+};
 /**
- * Whether `mod` means ⌘ on this device. Mirrors `react-hotkeys-hook`'s own rule exactly (macOS only, not
- * iOS/iPadOS) so a hint always names the key that fires the hotkey. Always `false` on the server.
+ * Whether a key event happened while the user is typing in a field, including one inside a shadow root.
+ * Checks the focused element as well as the event target, because react-aria re-dispatches keys typed
+ * in a combobox onto its list.
  */
-const isApplePlatform = () => typeof navigator !== 'undefined' && /mac/i.test(navigator.userAgent) && !/iphone|ipad|ipod/i.test(navigator.userAgent);
+const isTypingInField = (event) => isEditable(event.composedPath()[0] ?? event.target) || isEditable(event.target) || isEditable(deepActiveElement());
+const startsWith = (sequence, prefix) => prefix.every((key, index) => sequence[index] === key);
+/**
+ * Feeds one typed key into the keys typed so far and reports whether a sequence is now complete.
+ * Returns the index of the matched sequence and an empty buffer, or the buffer to carry forward:
+ * the longest run of recent keys that still begins some sequence.
+ */
+const advanceKeySequence = (typedKeys, key, sequences) => {
+    const typed = [...typedKeys, key];
+    for (let start = 0; start < typed.length; start++) {
+        const candidate = typed.slice(start);
+        const matched = sequences.findIndex((sequence) => sequence.length === candidate.length && startsWith(sequence, candidate));
+        if (matched !== -1)
+            return { buffer: [], matched };
+        if (sequences.some((sequence) => startsWith(sequence, candidate)))
+            return { buffer: candidate };
+    }
+    return { buffer: [] };
+};
+const NAMED_KEYS = new Set([
+    'enter',
+    'escape',
+    'tab',
+    'space',
+    'backspace',
+    'delete',
+    'insert',
+    'home',
+    'end',
+    'pageup',
+    'pagedown',
+    'arrowup',
+    'arrowdown',
+    'arrowleft',
+    'arrowright',
+    ...Object.values(PUNCTUATION_KEY_NAMES),
+]);
+const FUNCTION_KEY = /^f([1-9]|1\d|2[0-4])$/;
+/**
+ * Whether a normalised hotkey is made only of modifiers and real keys. Display props accept any text
+ * (`"Ctrl K"`, `"Hold to talk"`), and formatting text that is not a hotkey would mangle it.
+ */
+const isRecognisedHotkey = (hotkey) => {
+    const keys = hotkey.split('+').map(mapCode).filter(Boolean);
+    const isKey = (key) => [...key].length === 1 || FUNCTION_KEY.test(key) || NAMED_KEYS.has(key);
+    // A hotkey with no key of its own is usually one whose `+` key was lost in parsing (`⌘+`), so leave it alone.
+    return keys.some(isKey) && keys.every((key) => isHotkeyModifier(key) || isKey(key));
+};
+const KEY_LABELS = {
+    escape: 'Esc',
+    arrowup: '↑',
+    arrowdown: '↓',
+    arrowleft: '←',
+    arrowright: '→',
+    pageup: 'Page Up',
+    pagedown: 'Page Down',
+};
+const keyLabel = (key) => {
+    const character = hotkeyCharacter(key);
+    if (character.length === 1 || FUNCTION_KEY.test(key))
+        return character.toUpperCase();
+    return KEY_LABELS[key] ?? `${key[0].toUpperCase()}${key.slice(1)}`;
+};
+// Outside macOS, modifiers are conventionally written Win, Ctrl, Alt, Shift whatever order the author used.
+const MODIFIER_ORDER = ['meta', 'mod', 'ctrl', 'control', 'alt', 'shift'];
 /**
  * Formats a hotkey for display: `mod+k` reads `⌘K` on macOS and `Ctrl K` elsewhere.
- * When several comma-separated alternatives are given, only the first is shown.
+ * `isMac` says whether `mod` is ⌘. For a `react-hotkeys-hook` key that is macOS only (not iOS).
+ * Formats one hotkey: of several comma-separated alternatives it draws only the first. `formatHotkeyLabel`
+ * is the entry point that draws them all.
  */
-const formatHotkeyHint = (hotkey, isApple) => {
-    const modifiers = isApple ? APPLE_MODIFIERS : OTHER_MODIFIERS;
+const formatHotkeyHint = (hotkey, isMac) => {
+    const modifiers = isMac ? MAC_MODIFIERS : OTHER_MODIFIERS;
     const [firstHotkey = ''] = parseKeysHookInput(hotkey);
-    return firstHotkey
-        .split('+')
-        .map(mapCode)
-        .filter(Boolean)
-        .map((key) => (isHotkeyModifier(key) ? modifiers[key] : key.toUpperCase()))
-        .join(isApple ? '' : ' ');
+    const keys = firstHotkey.split('+').map(mapCode).filter(Boolean);
+    const heldKeys = keys.filter(isHotkeyModifier);
+    const orderedModifiers = isMac ? heldKeys : [...heldKeys].sort((first, second) => MODIFIER_ORDER.indexOf(first) - MODIFIER_ORDER.indexOf(second));
+    return [...orderedModifiers.map((key) => modifiers[key]), ...keys.filter((key) => !isHotkeyModifier(key)).map(keyLabel)].join(isMac ? '' : ' ');
+};
+// `>` or `->` separates the steps of a sequence, unless `>` is itself the key (`mod+>`).
+const SEQUENCE_SEPARATOR = /(?<=[^+\s])\s*(?:->|>)\s*(?=\S)/;
+const ALTERNATIVE_SEPARATOR = /,(?=\s*\S)/;
+const formatSteps = (hotkey, isMac) => {
+    const steps = hotkey.split(SEQUENCE_SEPARATOR).map((step) => normalizeHotkey(step, { forDisplay: true }));
+    return steps.every(isRecognisedHotkey) ? steps.map((step) => formatHotkeyHint(step, isMac)).join(' → ') : undefined;
+};
+/**
+ * Labels a shortcut for the platform. Accepts `react-hotkeys-hook` syntax (`mod+k`, `g>p`), the symbol
+ * shorthand (`⌘K`) or a shortcut written out (`Ctrl+K`), and draws each distinct comma-separated alternative.
+ * Text that is not a hotkey (`Hold to talk`) is returned exactly as written, so a display prop can take
+ * any label.
+ */
+const formatHotkeyLabel = (hotkey, isMac) => {
+    const alternatives = hotkey.split(ALTERNATIVE_SEPARATOR).map((alternative) => formatSteps(alternative, isMac));
+    // `mod+k, ctrl+k` is two keys on a Mac but one label elsewhere, so repeats are dropped.
+    return alternatives.every((alternative) => alternative !== undefined) ? [...new Set(alternatives)].join(', ') : hotkey;
 };
 // #endregion
 
+exports.advanceKeySequence = advanceKeySequence;
 exports.formatHotkeyHint = formatHotkeyHint;
-exports.isApplePlatform = isApplePlatform;
+exports.formatHotkeyLabel = formatHotkeyLabel;
+exports.getItemHotkeyKind = getItemHotkeyKind;
+exports.hotkeyCharacter = hotkeyCharacter;
 exports.isHotkeyModifier = isHotkeyModifier;
+exports.isRecognisedHotkey = isRecognisedHotkey;
+exports.isTypingInField = isTypingInField;
 exports.mapCode = mapCode;
+exports.normalizeHotkey = normalizeHotkey;
 exports.parseHotkey = parseHotkey;
 exports.parseKeysHookInput = parseKeysHookInput;
+exports.toHotkeySteps = toHotkeySteps;
 //# sourceMappingURL=hotkeys.utils.cjs.map

package/dist/utilities/__internal__/hotkeysUtils/hotkeys.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hotkeys.utils.cjs","sources":["../../../../src/utilities/__internal__/hotkeysUtils/hotkeys.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"hotkeys.utils.cjs","sources":["../../../../src/utilities/__internal__/hotkeysUtils/hotkeys.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}