Dictionary.mapKeyedValuesを導入する

Dictionary に、クロージャがキーと値の両方を受け取る mapKeyedValues(_:) と compactMapKeyedValues(_:) を追加します。既存のキーをそのまま流用するため、ハッシュテーブルの再構築は不要で、値の変換だけが走ります。

extension Dictionary {
    public func mapKeyedValues<T, E>(
        _ transform: (Key, Value) throws(E) -> T
    ) throws(E) -> Dictionary<Key, T>

    public func compactMapKeyedValues<T, E>(
        _ transform: (Key, Value) throws(E) -> T?
    ) throws(E) -> Dictionary<Key, T>
}

compactMapKeyedValues は当初の提案には含まれておらず（reduce でも書けるうえ、mapKeyedValues のようなハッシュテーブル再利用による性能上の利点が得られないため）代替案として触れられていただけでしたが、それでも有用な操作であり、名前を与える価値があるとレビューで判断され、受理時に追加されました。

使い方は、mapValues / compactMapValues に渡すクロージャの引数を2つ（キーと値）にした形です。

let balances: [Currency: Int64] = [.USD: 13, .EUR: 15]

// キーを使って表示用文字列に変換
let displayText: [Currency: String] = balances.mapKeyedValues { key, value in
    "\(key.alpha3) balance: \(value)"
}

// キーに応じて値を捨てる／残す
let positiveUSD: [Currency: Int64] = balances.compactMapKeyedValues { key, value in
    key == .USD && value > 0 ? value : nil
}

mapKeyedValues は変換後もキーが必ず元の辞書と同じなので、Dictionary はキーの配列とハッシュテーブルをそのまま引き継ぎ、値の配列だけを作り直します。init(uniqueKeysWithValues:) や reduce(into:) による書き換えで発生していた再ハッシュ・再確保のコストがなくなり、キーを使わない既存の mapValues と同じオーダーで動きます（compactMapKeyedValues は結果のキー集合が変わり得るため、この最適化の恩恵は受けません）。

なぜ mapValues のオーバーロードではなく別名なのか

当初の草案では、既存の mapValues にキーと値を受け取るクロージャのオーバーロードを追加する案でした。しかしこれは、値がタプル型 (Key, Value) の辞書に対して既存の mapValues を呼んでいた稀なコードで、呼び出しが新しいオーバーロードに解決されてしまい、ソース互換性を壊すことが判明しました。そこで衝突を避けるため、mapKeyedValues という別名のメソッドとして追加する形に落ち着いています。