Function normalizedHotkeyStringFromParsed

packages/hotkeys/src/parse.ts:146–175

* Serializes a parsed hotkey to the canonical string form used for registration * and storage: `Mod` first when the platform allows, then `Alt`, then `Shift`; * otherwise full `Control+Alt+Shift+Meta` order.

(
  parsed: ParsedHotkey,
  platform: 'mac' | 'windows' | 'linux',
)

 * otherwise full `Control+Alt+Shift+Meta` order.
 */
function normalizedHotkeyStringFromParsed(
  parsed: ParsedHotkey,
  platform: 'mac' | 'windows' | 'linux',
): Hotkey {
  const canUseMod =
    platform === 'mac'
      ? parsed.meta && !parsed.ctrl
      : parsed.ctrl && !parsed.meta

  const parts: Array<string> = []

  if (canUseMod) {
    parts.push('Mod')
    if (parsed.alt) {
      parts.push('Alt')
    }
    if (parsed.shift) {
      parts.push('Shift')
    }
  } else {
    for (const modifier of MODIFIER_ORDER) {
      if (parsed.modifiers.includes(modifier)) {
        parts.push(modifier)
      }
    }
  }

  parts.push(normalizeKeyName(parsed.key))
  return parts.join('+') as Hotkey
}

/**
 * Normalizes a hotkey string to its canonical form.