@flipdish/ui-library 0.31.5 → 0.31.6

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

@@ -12,11 +12,45 @@ interface Hotkey extends KeyboardModifiers {
     description?: string;
     isSequence: boolean;
 }
+/**
+ * Maps a key name or `KeyboardEvent.code` to the lowercase name the parser matches on (`esc` is `escape`, `KeyK` is `k`).
+ *
+ * @param key A key name from a hotkey string or a physical key code; surrounding spaces are ignored.
+ * @returns The canonical lowercase key name.
+ */
 export declare function mapCode(key: string): string;
+/**
+ * Reports whether a parsed key is a modifier rather than a key of its own.
+ *
+ * @param key A lowercase key name as produced by `mapCode`.
+ * @returns `true` for `shift`, `alt`, `meta`, `mod`, `ctrl` and `control`.
+ */
 export declare function isHotkeyModifier(key: string): boolean;
+/**
+ * Splits a hook input into its alternative hotkeys (`mod+k,ctrl+k`).
+ *
+ * @param keys The hotkey string passed to `react-hotkeys-hook`.
+ * @param delimiter The character that separates alternatives.
+ * @returns Each alternative, lowercased.
+ */
 export declare function parseKeysHookInput(keys: string, delimiter?: string): string[];
+/**
+ * Parses one hotkey into its modifier flags and keys, as `react-hotkeys-hook` does before matching.
+ *
+ * @param hotkey A single alternative, either a combination (`mod+k`) or a sequence (`g>p`).
+ * @param splitKey The character joining the keys of a combination.
+ * @param sequenceSplitKey The character separating the steps of a sequence; its presence makes the hotkey a sequence.
+ * @param useKey Whether matching uses the produced character rather than the physical key; carried through unchanged.
+ * @param description Text describing the hotkey; carried through unchanged.
+ * @returns The modifier flags, the non-modifier keys, and whether the hotkey is a sequence.
+ */
 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. */
+/**
+ * The character a key name stands for (`slash` is `/`), or the name itself when it is not punctuation.
+ *
+ * @param key A lowercase key name in hook format.
+ * @returns The punctuation character, or `key` unchanged.
+ */
 export declare const hotkeyCharacter: (key: string) => string;
 /**
  * Accepts a hotkey in `react-hotkeys-hook` format (`mod+k`) or the symbol shorthand (`⌘K`, `⌘⇧P`,
@@ -26,6 +60,10 @@ export declare const hotkeyCharacter: (key: string) => string;
  *
  * `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.
+ *
+ * @param hotkey One step of a shortcut in either hook format or symbol shorthand.
+ * @param options `forDisplay` keeps shifted symbols as written instead of expanding them to Shift plus a key.
+ * @returns The hook-format hotkey with duplicate keys removed, or an empty string when `hotkey` holds no keys.
  */
 export declare const normalizeHotkey: (hotkey: string, { forDisplay }?: {
     forDisplay?: boolean;
@@ -34,6 +72,10 @@ export declare const normalizeHotkey: (hotkey: string, { forDisplay }?: {
  * 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.
+ *
+ * @param shortcutKeys The item's shortcut entries, in hook format or symbol shorthand.
+ * @param options Passed to `normalizeHotkey` for each entry; `forDisplay` keeps shifted symbols as written.
+ * @returns One hook-format hotkey per step; trailing modifiers with no key form a final step of their own.
  */
 export declare const toHotkeySteps: (shortcutKeys: string[], options?: {
     forDisplay?: boolean;
@@ -45,18 +87,29 @@ export type ItemHotkeyKind = 'combination' | 'guarded' | 'typed' | 'unsupported'
  * - `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.
+ *
+ * @param steps Hook-format steps as returned by `toHotkeySteps`.
+ * @returns The way the shortcut can be triggered.
  */
 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.
+ *
+ * @param event The key event to check.
+ * @returns `true` when the event target or the focused element is editable.
  */
 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.
+ *
+ * @param typedKeys The buffer carried forward from the previous call.
+ * @param key The character just typed.
+ * @param sequences The sequences to match against, each a list of characters pressed in turn.
+ * @returns The next buffer, plus the position in `sequences` of the match when one completed.
  */
 export declare const advanceKeySequence: (typedKeys: string[], key: string, sequences: string[][]) => {
     buffer: string[];
@@ -65,6 +118,9 @@ export declare const advanceKeySequence: (typedKeys: string[], key: string, sequ
 /**
  * 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.
+ *
+ * @param hotkey A single step already passed through `normalizeHotkey`.
+ * @returns `true` when it holds at least one real key and nothing that is neither a key nor a modifier.
  */
 export declare const isRecognisedHotkey: (hotkey: string) => boolean;
 /**
@@ -72,6 +128,10 @@ export declare const isRecognisedHotkey: (hotkey: string) => boolean;
  * `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.
+ *
+ * @param hotkey A hook-format hotkey; only its first comma-separated alternative is drawn.
+ * @param isMac Whether to draw macOS symbols (`⌘⇧K`) instead of spelled-out modifiers (`Ctrl Shift K`).
+ * @returns The display label for the first alternative.
  */
 export declare const formatHotkeyHint: (hotkey: string, isMac: boolean) => string;
 /**
@@ -79,6 +139,10 @@ export declare const formatHotkeyHint: (hotkey: string, isMac: boolean) => strin
  * 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.
+ *
+ * @param hotkey The shortcut in any accepted form, or arbitrary display text.
+ * @param isMac Whether `mod` reads as ⌘ and modifiers are drawn as macOS symbols.
+ * @returns The label for every distinct alternative, or `hotkey` unchanged when any part is not a hotkey.
  */
 export declare const formatHotkeyLabel: (hotkey: string, isMac: boolean) => string;
 export {};

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":"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"}
+{"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;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,WAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,EAAE,CAE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAM,EAAE,gBAAgB,SAAM,EAAE,MAAM,UAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAmChI;AAmDD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAAyC,CAAC;AAExF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,EAAE,iBAAwB;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,MAevG,CAAC;AAEF;;;;;;;;GAQG;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;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,KAAG,cAUnD,CAAC;AAeF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,KAAG,OAC6D,CAAC;AAIrH;;;;;;;;;GASG;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;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,KAAG,OAMnD,CAAC;AAqBF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAQjE,CAAC;AAWF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,KAAG,MAIlE,CAAC"}

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

@@ -28,15 +28,44 @@ const mappedKeys = {
     ControlLeft: 'ctrl',
     ControlRight: 'ctrl',
 };
+/**
+ * Maps a key name or `KeyboardEvent.code` to the lowercase name the parser matches on (`esc` is `escape`, `KeyK` is `k`).
+ *
+ * @param key A key name from a hotkey string or a physical key code; surrounding spaces are ignored.
+ * @returns The canonical lowercase key name.
+ */
 function mapCode(key) {
     return (mappedKeys[key.trim()] || key.trim()).toLowerCase().replace(/key|digit|numpad/, '');
 }
+/**
+ * Reports whether a parsed key is a modifier rather than a key of its own.
+ *
+ * @param key A lowercase key name as produced by `mapCode`.
+ * @returns `true` for `shift`, `alt`, `meta`, `mod`, `ctrl` and `control`.
+ */
 function isHotkeyModifier(key) {
     return reservedModifierKeywords.includes(key);
 }
+/**
+ * Splits a hook input into its alternative hotkeys (`mod+k,ctrl+k`).
+ *
+ * @param keys The hotkey string passed to `react-hotkeys-hook`.
+ * @param delimiter The character that separates alternatives.
+ * @returns Each alternative, lowercased.
+ */
 function parseKeysHookInput(keys, delimiter = ',') {
     return keys.toLowerCase().split(delimiter);
 }
+/**
+ * Parses one hotkey into its modifier flags and keys, as `react-hotkeys-hook` does before matching.
+ *
+ * @param hotkey A single alternative, either a combination (`mod+k`) or a sequence (`g>p`).
+ * @param splitKey The character joining the keys of a combination.
+ * @param sequenceSplitKey The character separating the steps of a sequence; its presence makes the hotkey a sequence.
+ * @param useKey Whether matching uses the produced character rather than the physical key; carried through unchanged.
+ * @param description Text describing the hotkey; carried through unchanged.
+ * @returns The modifier flags, the non-modifier keys, and whether the hotkey is a sequence.
+ */
 function parseHotkey(hotkey, splitKey = '+', sequenceSplitKey = '>', useKey = false, description) {
     let keys = [];
     let isSequence = false;
@@ -113,7 +142,12 @@ const SHIFTED_KEYS = {
     '(': '9',
     ')': '0',
 };
-/** The character a key name stands for (`slash` is `/`), or the name itself when it is not punctuation. */
+/**
+ * The character a key name stands for (`slash` is `/`), or the name itself when it is not punctuation.
+ *
+ * @param key A lowercase key name in hook format.
+ * @returns The punctuation character, or `key` unchanged.
+ */
 const hotkeyCharacter = (key) => KEY_NAME_CHARACTERS[key] ?? key;
 /**
  * Accepts a hotkey in `react-hotkeys-hook` format (`mod+k`) or the symbol shorthand (`⌘K`, `⌘⇧P`,
@@ -123,6 +157,10 @@ const hotkeyCharacter = (key) => KEY_NAME_CHARACTERS[key] ?? key;
  *
  * `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.
+ *
+ * @param hotkey One step of a shortcut in either hook format or symbol shorthand.
+ * @param options `forDisplay` keeps shifted symbols as written instead of expanding them to Shift plus a key.
+ * @returns The hook-format hotkey with duplicate keys removed, or an empty string when `hotkey` holds no keys.
  */
 const normalizeHotkey = (hotkey, { forDisplay = false } = {}) => {
     const keys = hotkey
@@ -143,6 +181,10 @@ const normalizeHotkey = (hotkey, { forDisplay = false } = {}) => {
  * 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.
+ *
+ * @param shortcutKeys The item's shortcut entries, in hook format or symbol shorthand.
+ * @param options Passed to `normalizeHotkey` for each entry; `forDisplay` keeps shifted symbols as written.
+ * @returns One hook-format hotkey per step; trailing modifiers with no key form a final step of their own.
  */
 const toHotkeySteps = (shortcutKeys, options) => {
     const steps = [];
@@ -166,6 +208,9 @@ const toHotkeySteps = (shortcutKeys, options) => {
  * - `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.
+ *
+ * @param steps Hook-format steps as returned by `toHotkeySteps`.
+ * @returns The way the shortcut can be triggered.
  */
 const getItemHotkeyKind = (steps) => {
     const stepKeys = steps.map((step) => step.split('+'));
@@ -194,6 +239,9 @@ const deepActiveElement = () => {
  * 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.
+ *
+ * @param event The key event to check.
+ * @returns `true` when the event target or the focused element is editable.
  */
 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);
@@ -201,6 +249,11 @@ const startsWith = (sequence, prefix) => prefix.every((key, index) => sequence[i
  * 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.
+ *
+ * @param typedKeys The buffer carried forward from the previous call.
+ * @param key The character just typed.
+ * @param sequences The sequences to match against, each a list of characters pressed in turn.
+ * @returns The next buffer, plus the position in `sequences` of the match when one completed.
  */
 const advanceKeySequence = (typedKeys, key, sequences) => {
     const typed = [...typedKeys, key];
@@ -236,6 +289,9 @@ 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.
+ *
+ * @param hotkey A single step already passed through `normalizeHotkey`.
+ * @returns `true` when it holds at least one real key and nothing that is neither a key nor a modifier.
  */
 const isRecognisedHotkey = (hotkey) => {
     const keys = hotkey.split('+').map(mapCode).filter(Boolean);
@@ -265,6 +321,10 @@ const MODIFIER_ORDER = ['meta', 'mod', 'ctrl', 'control', 'alt', 'shift'];
  * `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.
+ *
+ * @param hotkey A hook-format hotkey; only its first comma-separated alternative is drawn.
+ * @param isMac Whether to draw macOS symbols (`⌘⇧K`) instead of spelled-out modifiers (`Ctrl Shift K`).
+ * @returns The display label for the first alternative.
  */
 const formatHotkeyHint = (hotkey, isMac) => {
     const modifiers = isMac ? MAC_MODIFIERS : OTHER_MODIFIERS;
@@ -286,6 +346,10 @@ const formatSteps = (hotkey, isMac) => {
  * 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.
+ *
+ * @param hotkey The shortcut in any accepted form, or arbitrary display text.
+ * @param isMac Whether `mod` reads as ⌘ and modifiers are drawn as macOS symbols.
+ * @returns The label for every distinct alternative, or `hotkey` unchanged when any part is not a hotkey.
  */
 const formatHotkeyLabel = (hotkey, isMac) => {
     const alternatives = hotkey.split(ALTERNATIVE_SEPARATOR).map((alternative) => formatSteps(alternative, isMac));

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__/logUtils/log.utils.cjs

@@ -19,6 +19,9 @@ const seenWarnings = new Set();
  * href scheme, a missing account id) that must stay visible in production —
  * error-tracking tools pick console.warn up as breadcrumbs — without flooding
  * the console on re-renders.
+ *
+ * @param key Identifies the condition; later calls with the same key are silent.
+ * @param message The warning text, shown after the library prefix.
  */
 const warnOnce = (key, message) => {
     if (seenWarnings.has(key)) {

package/dist/utilities/__internal__/logUtils/log.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"log.utils.cjs","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;AAMG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;"}
+{"version":3,"file":"log.utils.cjs","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;;;;AASG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;"}

package/dist/utilities/__internal__/logUtils/log.utils.d.ts

@@ -16,6 +16,9 @@
  * href scheme, a missing account id) that must stay visible in production —
  * error-tracking tools pick console.warn up as breadcrumbs — without flooding
  * the console on re-renders.
+ *
+ * @param key Identifies the condition; later calls with the same key are silent.
+ * @param message The warning text, shown after the library prefix.
  */
 export declare const warnOnce: (key: string, message: string) => void;
 /** Test-only: clears the once-per-key warning memory. */

package/dist/utilities/__internal__/logUtils/log.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,IAMvD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,aAAa,QAAO,IAEhC,CAAC"}
+{"version":3,"file":"log.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,IAMvD,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,aAAa,QAAO,IAEhC,CAAC"}

package/dist/utilities/__internal__/logUtils/log.utils.js

@@ -17,6 +17,9 @@ const seenWarnings = new Set();
  * href scheme, a missing account id) that must stay visible in production —
  * error-tracking tools pick console.warn up as breadcrumbs — without flooding
  * the console on re-renders.
+ *
+ * @param key Identifies the condition; later calls with the same key are silent.
+ * @param message The warning text, shown after the library prefix.
  */
 const warnOnce = (key, message) => {
     if (seenWarnings.has(key)) {

package/dist/utilities/__internal__/logUtils/log.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.utils.js","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;AAMG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;"}
+{"version":3,"file":"log.utils.js","sources":["../../../../src/utilities/__internal__/logUtils/log.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;AAWG;AAEH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU;AAEtC;;;;;;;;;AASG;MACU,QAAQ,GAAG,CAAC,GAAW,EAAE,OAAe,KAAU;AAC7D,IAAA,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QACzB;IACF;AACA,IAAA,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;AACrB,IAAA,OAAO,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAA,CAAE,CAAC;AACnD;;"}

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

@@ -4,6 +4,9 @@
  * 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.
+ *
+ * @param userAgent The browser's user-agent string, usually `navigator.userAgent`.
+ * @returns The detected operating system, or `unknown` when no rule matches.
  */
 const detectPlatformOs = (userAgent) => {
     if (/iphone|ipad|ipod/i.test(userAgent))
@@ -18,7 +21,11 @@ const detectPlatformOs = (userAgent) => {
         return 'linux';
     return 'unknown';
 };
-/** The operating system of the current device; `unknown` when there is no browser user agent, as on the server. */
+/**
+ * The operating system of the current device.
+ *
+ * @returns The detected operating system; `unknown` when there is no browser user agent, as on the server.
+ */
 const getPlatformOs = () => (typeof navigator === 'undefined' ? 'unknown' : detectPlatformOs(navigator.userAgent ?? ''));
 
 exports.detectPlatformOs = detectPlatformOs;

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

@@ -1 +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;;;"}
+{"version":3,"file":"platform.utils.cjs","sources":["../../../../src/utilities/__internal__/platformUtils/platform.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;AAOG;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;;;;AAIG;AACI,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

@@ -3,8 +3,15 @@ export type PlatformOs = 'macos' | 'ios' | 'windows' | 'android' | 'linux' | 'un
  * 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.
+ *
+ * @param userAgent The browser's user-agent string, usually `navigator.userAgent`.
+ * @returns The detected operating system, or `unknown` when no rule matches.
  */
 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. */
+/**
+ * The operating system of the current device.
+ *
+ * @returns The detected operating system; `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

@@ -1 +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"}
+{"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;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,UAOpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,UAA0G,CAAC"}

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

@@ -2,6 +2,9 @@
  * 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.
+ *
+ * @param userAgent The browser's user-agent string, usually `navigator.userAgent`.
+ * @returns The detected operating system, or `unknown` when no rule matches.
  */
 const detectPlatformOs = (userAgent) => {
     if (/iphone|ipad|ipod/i.test(userAgent))
@@ -16,7 +19,11 @@ const detectPlatformOs = (userAgent) => {
         return 'linux';
     return 'unknown';
 };
-/** The operating system of the current device; `unknown` when there is no browser user agent, as on the server. */
+/**
+ * The operating system of the current device.
+ *
+ * @returns The detected operating system; `unknown` when there is no browser user agent, as on the server.
+ */
 const getPlatformOs = () => (typeof navigator === 'undefined' ? 'unknown' : detectPlatformOs(navigator.userAgent ?? ''));
 
 export { detectPlatformOs, getPlatformOs };

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

@@ -1 +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;;"}
+{"version":3,"file":"platform.utils.js","sources":["../../../../src/utilities/__internal__/platformUtils/platform.utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;AAOG;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;;;;AAIG;AACI,MAAM,aAAa,GAAG,OAAmB,OAAO,SAAS,KAAK,WAAW,GAAG,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;;"}

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.cjs

@@ -43,14 +43,28 @@ const safeRemove = (getStorage, key) => {
         return false;
     }
 };
-/** Reusable `validate` guard for a boolean item. */
+/**
+ * Reusable `validate` guard for a boolean item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a boolean.
+ */
 const isBoolean = (value) => typeof value === 'boolean';
-/** Reusable `validate` guard for a string item. */
+/**
+ * Reusable `validate` guard for a string item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a string.
+ */
 const isString = (value) => typeof value === 'string';
 /**
  * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
  * `errorMessage` for anything else so `WebStorageItem.get()` treats it as
  * invalid data and returns `null`.
+ *
+ * @param raw The string read from storage.
+ * @param errorMessage The message thrown when `raw` is neither `'true'` nor `'false'`.
+ * @returns The boolean the string spells.
  */
 const parseBooleanString = (raw, errorMessage) => {
     if (raw === 'true')
@@ -59,7 +73,14 @@ const parseBooleanString = (raw, errorMessage) => {
         return false;
     throw new Error(errorMessage);
 };
-/** Build a typed, failure-safe accessor for a single key in the given storage. */
+/**
+ * Build a typed, failure-safe accessor for a single key in the given storage.
+ *
+ * @param getStorage Returns the backing store on each access, so a throwing `window.*Storage` getter is caught.
+ * @param key The storage key the item reads and writes.
+ * @param options How values are serialised and validated, described on `WebStorageItemOptions`.
+ * @returns An accessor whose `get`, `set` and `clear` never throw.
+ */
 const createWebStorageItem = (getStorage, key, options = {}) => {
     const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
     return {

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"webStorage.utils.cjs","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;AAUG;AAKH,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAmB;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,IAAI;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,EAAE,KAAa,KAAa;IACnF,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;QACF,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAa;IACvE,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;AACF,QAAA,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAC5B,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAoBD;AACO,MAAM,SAAS,GAAG,CAAC,KAAc,KAAuB,OAAO,KAAK,KAAK;AAEhF;AACO,MAAM,QAAQ,GAAG,CAAC,KAAc,KAAsB,OAAO,KAAK,KAAK;AAE9E;;;;AAIG;MACU,kBAAkB,GAAG,CAAC,GAAW,EAAE,YAAoB,KAAa;IAC/E,IAAI,GAAG,KAAK,MAAM;AAAE,QAAA,OAAO,IAAI;IAC/B,IAAI,GAAG,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACjC,IAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B;AAEA;AACO,MAAM,oBAAoB,GAAG,CAAI,UAA2B,EAAE,GAAW,EAAE,OAAA,GAAoC,EAAE,KAAuB;AAC7I,IAAA,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC,KAA2B,EAAE,QAAQ,EAAE,GAAG,OAAO;IAExG,OAAO;QACL,GAAG,GAAA;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI;AAAE,gBAAA,OAAO,IAAI;AAC5B,YAAA,IAAI;AACF,gBAAA,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;AAC9B,gBAAA,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,oBAAA,OAAO,IAAI;AAC7C,gBAAA,OAAO,KAAK;YACd;AAAE,YAAA,MAAM;AACN,gBAAA,OAAO,IAAI;YACb;QACF,CAAC;AACD,QAAA,GAAG,CAAC,KAAK,EAAA;AACP,YAAA,IAAI;AACF,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;;;;gBAInC,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE;AACpC,gBAAA,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC;YACtC;AAAE,YAAA,MAAM;;;YAGR;QACF,CAAC;QACD,KAAK,GAAA;AACH,YAAA,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;QAC7B,CAAC;KACF;AACH;;;;;"}
+{"version":3,"file":"webStorage.utils.cjs","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;AAUG;AAKH,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAmB;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,IAAI;AAC9C,IAAA,IAAI;AACF,QAAA,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,UAA2B,EAAE,GAAW,EAAE,KAAa,KAAa;IACnF,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;QACF,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,UAA2B,EAAE,GAAW,KAAa;IACvE,IAAI,OAAO,MAAM,KAAK,WAAW;AAAE,QAAA,OAAO,KAAK;AAC/C,IAAA,IAAI;AACF,QAAA,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;AAC5B,QAAA,OAAO,IAAI;IACb;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;IACd;AACF,CAAC;AAoBD;;;;;AAKG;AACI,MAAM,SAAS,GAAG,CAAC,KAAc,KAAuB,OAAO,KAAK,KAAK;AAEhF;;;;;AAKG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAc,KAAsB,OAAO,KAAK,KAAK;AAE9E;;;;;;;;AAQG;MACU,kBAAkB,GAAG,CAAC,GAAW,EAAE,YAAoB,KAAa;IAC/E,IAAI,GAAG,KAAK,MAAM;AAAE,QAAA,OAAO,IAAI;IAC/B,IAAI,GAAG,KAAK,OAAO;AAAE,QAAA,OAAO,KAAK;AACjC,IAAA,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;AAC/B;AAEA;;;;;;;AAOG;AACI,MAAM,oBAAoB,GAAG,CAAI,UAA2B,EAAE,GAAW,EAAE,OAAA,GAAoC,EAAE,KAAuB;AAC7I,IAAA,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC,KAA2B,EAAE,QAAQ,EAAE,GAAG,OAAO;IAExG,OAAO;QACL,GAAG,GAAA;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;YACpC,IAAI,GAAG,IAAI,IAAI;AAAE,gBAAA,OAAO,IAAI;AAC5B,YAAA,IAAI;AACF,gBAAA,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;AAC9B,gBAAA,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,oBAAA,OAAO,IAAI;AAC7C,gBAAA,OAAO,KAAK;YACd;AAAE,YAAA,MAAM;AACN,gBAAA,OAAO,IAAI;YACb;QACF,CAAC;AACD,QAAA,GAAG,CAAC,KAAK,EAAA;AACP,YAAA,IAAI;AACF,gBAAA,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC;;;;gBAInC,IAAI,OAAO,UAAU,KAAK,QAAQ;oBAAE;AACpC,gBAAA,OAAO,CAAC,UAAU,EAAE,GAAG,EAAE,UAAU,CAAC;YACtC;AAAE,YAAA,MAAM;;;YAGR;QACF,CAAC;QACD,KAAK,GAAA;AACH,YAAA,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;QAC7B,CAAC;KACF;AACH;;;;;"}

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.d.ts

@@ -27,17 +27,38 @@ export interface WebStorageItemOptions<T> {
     /** Optional runtime guard; `get()` returns `null` when it fails. */
     validate?: (value: unknown) => value is T;
 }
-/** Reusable `validate` guard for a boolean item. */
+/**
+ * Reusable `validate` guard for a boolean item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a boolean.
+ */
 export declare const isBoolean: (value: unknown) => value is boolean;
-/** Reusable `validate` guard for a string item. */
+/**
+ * Reusable `validate` guard for a string item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a string.
+ */
 export declare const isString: (value: unknown) => value is string;
 /**
  * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
  * `errorMessage` for anything else so `WebStorageItem.get()` treats it as
  * invalid data and returns `null`.
+ *
+ * @param raw The string read from storage.
+ * @param errorMessage The message thrown when `raw` is neither `'true'` nor `'false'`.
+ * @returns The boolean the string spells.
  */
 export declare const parseBooleanString: (raw: string, errorMessage: string) => boolean;
-/** Build a typed, failure-safe accessor for a single key in the given storage. */
+/**
+ * Build a typed, failure-safe accessor for a single key in the given storage.
+ *
+ * @param getStorage Returns the backing store on each access, so a throwing `window.*Storage` getter is caught.
+ * @param key The storage key the item reads and writes.
+ * @param options How values are serialised and validated, described on `WebStorageItemOptions`.
+ * @returns An accessor whose `get`, `set` and `clear` never throw.
+ */
 export declare const createWebStorageItem: <T>(getStorage: StorageAccessor, key: string, options?: WebStorageItemOptions<T>) => WebStorageItem<T>;
 export {};
 //# sourceMappingURL=webStorage.utils.d.ts.map

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webStorage.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;AA+BrC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED,oDAAoD;AACpD,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F,mDAAmD;AACnD,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,OAItE,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,YAAY,eAAe,EAAE,KAAK,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,cAAc,CAAC,CAAC,CAgC1I,CAAC"}
+{"version":3,"file":"webStorage.utils.d.ts","sourceRoot":"","sources":["../../../../src/utilities/__internal__/webStorageUtils/webStorage.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qFAAqF;AACrF,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;AA+BrC,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,gFAAgF;IAChF,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChB,wEAAwE;IACxE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACjC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACjC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC;CAC3C;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,OAItE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EAAE,YAAY,eAAe,EAAE,KAAK,MAAM,EAAE,UAAS,qBAAqB,CAAC,CAAC,CAAM,KAAG,cAAc,CAAC,CAAC,CAgC1I,CAAC"}

package/dist/utilities/__internal__/webStorageUtils/webStorage.utils.js

@@ -41,14 +41,28 @@ const safeRemove = (getStorage, key) => {
         return false;
     }
 };
-/** Reusable `validate` guard for a boolean item. */
+/**
+ * Reusable `validate` guard for a boolean item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a boolean.
+ */
 const isBoolean = (value) => typeof value === 'boolean';
-/** Reusable `validate` guard for a string item. */
+/**
+ * Reusable `validate` guard for a string item.
+ *
+ * @param value The deserialised stored value.
+ * @returns `true` when the stored value is a string.
+ */
 const isString = (value) => typeof value === 'string';
 /**
  * Parse a plain `'true'`/`'false'` string (not JSON) into a boolean; throws
  * `errorMessage` for anything else so `WebStorageItem.get()` treats it as
  * invalid data and returns `null`.
+ *
+ * @param raw The string read from storage.
+ * @param errorMessage The message thrown when `raw` is neither `'true'` nor `'false'`.
+ * @returns The boolean the string spells.
  */
 const parseBooleanString = (raw, errorMessage) => {
     if (raw === 'true')
@@ -57,7 +71,14 @@ const parseBooleanString = (raw, errorMessage) => {
         return false;
     throw new Error(errorMessage);
 };
-/** Build a typed, failure-safe accessor for a single key in the given storage. */
+/**
+ * Build a typed, failure-safe accessor for a single key in the given storage.
+ *
+ * @param getStorage Returns the backing store on each access, so a throwing `window.*Storage` getter is caught.
+ * @param key The storage key the item reads and writes.
+ * @param options How values are serialised and validated, described on `WebStorageItemOptions`.
+ * @returns An accessor whose `get`, `set` and `clear` never throw.
+ */
 const createWebStorageItem = (getStorage, key, options = {}) => {
     const { serialize = JSON.stringify, deserialize = JSON.parse, validate } = options;
     return {