@flipdish/ui-library 0.29.0 → 0.30.0

package/dist/utilities/__internal__/hotkeysUtils/hotkeys.utils.d.ts

@@ -16,15 +16,70 @@ export declare function mapCode(key: string): string;
 export declare function isHotkeyModifier(key: string): boolean;
 export declare function parseKeysHookInput(keys: string, delimiter?: string): string[];
 export declare function parseHotkey(hotkey: string, splitKey?: string, sequenceSplitKey?: string, useKey?: boolean, description?: string): Hotkey;
+/** The character a key name stands for (`slash` is `/`), or the name itself when it is not punctuation. */
+export declare const hotkeyCharacter: (key: string) => string;
 /**
- * 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.
+ * 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.
  */
-export declare const isApplePlatform: () => boolean;
+export declare const normalizeHotkey: (hotkey: string, { forDisplay }?: {
+    forDisplay?: boolean;
+}) => string;
+/**
+ * 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.
+ */
+export declare const toHotkeySteps: (shortcutKeys: string[], options?: {
+    forDisplay?: boolean;
+}) => string[];
+export type ItemHotkeyKind = 'combination' | 'guarded' | 'typed' | 'unsupported';
+/**
+ * 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.
+ */
+export declare const getItemHotkeyKind: (steps: string[]) => ItemHotkeyKind;
+/**
+ * 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.
+ */
+export declare const isTypingInField: (event: KeyboardEvent) => boolean;
+/**
+ * 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.
+ */
+export declare const advanceKeySequence: (typedKeys: string[], key: string, sequences: string[][]) => {
+    buffer: string[];
+    matched?: number;
+};
+/**
+ * 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.
+ */
+export declare const isRecognisedHotkey: (hotkey: string) => boolean;
 /**
  * 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.
+ */
+export declare const formatHotkeyHint: (hotkey: string, isMac: boolean) => string;
+/**
+ * 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.
  */
-export declare const formatHotkeyHint: (hotkey: string, isApple: boolean) => string;
+export declare const formatHotkeyLabel: (hotkey: string, isMac: boolean) => string;
 export {};
 //# sourceMappingURL=hotkeys.utils.d.ts.map

package/dist/utilities/__internal__/hotkeysUtils/hotkeys.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotkeys.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/hotkeysUtils/hotkeys.utils.ts"],"names":[],"mappings":"AAaA,UAAU,iBAAiB;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,MAAO,SAAQ,iBAAiB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAuBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,WAE3C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,EAAE,CAE1E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,EAAE,gBAAgB,SAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAmChI;AAOD;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAO,OACqF,CAAC;AAEzH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,SAAS,OAAO,KAAG,MAUnE,CAAC"}
+{"version":3,"file":"hotkeys.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/hotkeysUtils/hotkeys.utils.ts"],"names":[],"mappings":"AAcA,UAAU,iBAAiB;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,MAAO,SAAQ,iBAAiB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAuBD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,WAE3C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,EAAE,CAE1E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,EAAE,gBAAgB,SAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAmChI;AAmDD,2GAA2G;AAC3G,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAAyC,CAAC;AAExF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,iBAAwB;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,MAevG,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,cAAc,MAAM,EAAE,EAAE,UAAU;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,MAAM,EAiBhG,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;AAEjF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,KAAG,cAUnD,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,KAAG,OAC6D,CAAC;AAIrH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,EAAE,EAAE,KAAK,MAAM,EAAE,WAAW,MAAM,EAAE,EAAE,KAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAWhI,CAAC;AAuBF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,OAMnD,CAAC;AAqBF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAQjE,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAIlE,CAAC"}

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

@@ -6,7 +6,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 = {
@@ -71,28 +72,227 @@ 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
 
-export { formatHotkeyHint, isApplePlatform, isHotkeyModifier, mapCode, parseHotkey, parseKeysHookInput };
+export { advanceKeySequence, formatHotkeyHint, formatHotkeyLabel, getItemHotkeyKind, hotkeyCharacter, isHotkeyModifier, isRecognisedHotkey, isTypingInField, mapCode, normalizeHotkey, parseHotkey, parseKeysHookInput, toHotkeySteps };
 //# sourceMappingURL=hotkeys.utils.js.map

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

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

package/dist/utilities/__internal__/platformUtils/platform.utils.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+/**
+ * Works out the operating system from a user-agent string. Best effort: an iPad in desktop mode
+ * reports itself as a Mac, and ChromeOS reads as Linux. The iOS and Mac tests mirror the rule
+ * `react-hotkeys-hook` uses for `mod`, so `macos` is exactly where ⌘ fires a `mod` hotkey.
+ */
+const detectPlatformOs = (userAgent) => {
+    if (/iphone|ipad|ipod/i.test(userAgent))
+        return 'ios';
+    if (/mac/i.test(userAgent))
+        return 'macos';
+    if (/android/i.test(userAgent))
+        return 'android';
+    if (/windows|win32|win64/i.test(userAgent))
+        return 'windows';
+    if (/linux|x11|\bcros\b/i.test(userAgent))
+        return 'linux';
+    return 'unknown';
+};
+/** The operating system of the current device; `unknown` when there is no browser user agent, as on the server. */
+const getPlatformOs = () => (typeof navigator === 'undefined' ? 'unknown' : detectPlatformOs(navigator.userAgent ?? ''));
+
+exports.detectPlatformOs = detectPlatformOs;
+exports.getPlatformOs = getPlatformOs;
+//# sourceMappingURL=platform.utils.cjs.map

package/dist/utilities/__internal__/platformUtils/platform.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.utils.cjs","sources":["../../../../src/utilities/__internal__/platformUtils/platform.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,SAAiB,KAAgB;AAChE,IAAA,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,KAAK;AACrD,IAAA,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,OAAO;AAC1C,IAAA,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,SAAS;AAChD,IAAA,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,SAAS;AAC5D,IAAA,IAAI,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,OAAO;AACzD,IAAA,OAAO,SAAS;AAClB;AAEA;AACO,MAAM,aAAa,GAAG,OAAmB,OAAO,SAAS,KAAK,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;;;;;"}

package/dist/utilities/__internal__/platformUtils/platform.utils.d.ts

@@ -0,0 +1,10 @@
+export type PlatformOs = 'macos' | 'ios' | 'windows' | 'android' | 'linux' | 'unknown';
+/**
+ * Works out the operating system from a user-agent string. Best effort: an iPad in desktop mode
+ * reports itself as a Mac, and ChromeOS reads as Linux. The iOS and Mac tests mirror the rule
+ * `react-hotkeys-hook` uses for `mod`, so `macos` is exactly where ⌘ fires a `mod` hotkey.
+ */
+export declare const detectPlatformOs: (userAgent: string) => PlatformOs;
+/** The operating system of the current device; `unknown` when there is no browser user agent, as on the server. */
+export declare const getPlatformOs: () => PlatformOs;
+//# sourceMappingURL=platform.utils.d.ts.map

package/dist/utilities/__internal__/platformUtils/platform.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/platformUtils/platform.utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,UAOpD,CAAC;AAEF,mHAAmH;AACnH,eAAO,MAAM,aAAa,QAAO,UAA0G,CAAC"}

package/dist/utilities/__internal__/platformUtils/platform.utils.js

@@ -0,0 +1,23 @@
+/**
+ * Works out the operating system from a user-agent string. Best effort: an iPad in desktop mode
+ * reports itself as a Mac, and ChromeOS reads as Linux. The iOS and Mac tests mirror the rule
+ * `react-hotkeys-hook` uses for `mod`, so `macos` is exactly where ⌘ fires a `mod` hotkey.
+ */
+const detectPlatformOs = (userAgent) => {
+    if (/iphone|ipad|ipod/i.test(userAgent))
+        return 'ios';
+    if (/mac/i.test(userAgent))
+        return 'macos';
+    if (/android/i.test(userAgent))
+        return 'android';
+    if (/windows|win32|win64/i.test(userAgent))
+        return 'windows';
+    if (/linux|x11|\bcros\b/i.test(userAgent))
+        return 'linux';
+    return 'unknown';
+};
+/** The operating system of the current device; `unknown` when there is no browser user agent, as on the server. */
+const getPlatformOs = () => (typeof navigator === 'undefined' ? 'unknown' : detectPlatformOs(navigator.userAgent ?? ''));
+
+export { detectPlatformOs, getPlatformOs };
+//# sourceMappingURL=platform.utils.js.map

package/dist/utilities/__internal__/platformUtils/platform.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.utils.js","sources":["../../../../src/utilities/__internal__/platformUtils/platform.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,SAAiB,KAAgB;AAChE,IAAA,IAAI,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,KAAK;AACrD,IAAA,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,OAAO;AAC1C,IAAA,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,SAAS;AAChD,IAAA,IAAI,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,SAAS;AAC5D,IAAA,IAAI,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC;AAAE,QAAA,OAAO,OAAO;AACzD,IAAA,OAAO,SAAS;AAClB;AAEA;AACO,MAAM,aAAa,GAAG,OAAmB,OAAO,SAAS,KAAK,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flipdish/ui-library",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Flipdish Design System — atomic-design component library (Tailwind v4 + UntitledUI + React Aria).",
   "type": "module",
   "imports": {