import { sprintf, s__ } from '~/locale'; /** * Combines each given item into a noun series sentence fragment. It does this * in a way that supports i18n by giving context and punctuation to the locale * functions. * * **Examples:** * * - `["A", "B"] => "A and B"` * - `["A", "B", "C"] => "A, B, and C"` * * **Why only nouns?** * * Some languages need a bit more context to translate other series. * * @param {String[]} items */ export const toNounSeriesText = (items, { onlyCommas = false } = {}) => { if (items.length === 0) { return ''; } else if (items.length === 1) { return sprintf(s__(`nounSeries|%{item}`), { item: items[0] }, false); } else if (items.length === 2 && !onlyCommas) { return sprintf( s__('nounSeries|%{firstItem} and %{lastItem}'), { firstItem: items[0], lastItem: items[1], }, false, ); } return items.reduce((item, nextItem, idx) => idx === items.length - 1 && !onlyCommas ? sprintf(s__('nounSeries|%{item}, and %{lastItem}'), { item, lastItem: nextItem }, false) : sprintf(s__('nounSeries|%{item}, %{nextItem}'), { item, nextItem }, false), ); }; export default { toNounSeriesText, };