@goodandready/dsh-kanban 0.2.19 → 0.2.20

package/lib/client.js

@@ -1,12 +1,11 @@
-// Браузерная половина dsh-kanban: экран доски и карточка настроек.
+// Browser half of dsh-kanban: board screen and settings card.
 //
-// Идентификатор ниже обязан совпадать с `name` в package.json и с `name:` в
-// cordis.patch.yml. Расхождение НЕ даёт ошибки в журнале: загрузчик молча не
-// разрешает пакет, серверная половина работает, интерфейса нет.
+// The identifier below must match `name` in package.json and `name:` in
+// cordis.patch.yml. A mismatch produces NO log error: the loader silently fails
+// to resolve the package, the server half works, and the UI never appears.
 //
-// Модуль грузится загрузчиком и импортировать файлы репозитория не может,
-// поэтому чистые помощники живут здесь же и выставляются наружу как `helpers`
-// — тесты поднимают этот файл через node:vm и проверяют их без браузера.
+// This module is loaded by ModuleLoader and cannot import repository files;
+// pure helpers live here and are exported as `helpers` for node:vm testing.
 window.__ModuleLoader__.load({
   id: '@goodandready/dsh-kanban',
   factory: (require) => {
@@ -25,8 +24,8 @@ window.__ModuleLoader__.load({
 
 
     /**
-     * Соседи для переноса карточки. Хранилище работает не с числовым индексом,
-     * а с парой соседей: `afterId` — карточка выше, `beforeId` — ниже.
+     * Neighbours for card repositioning. The store operates on relative neighbours
+     * rather than numeric indexes: `afterId` above, `beforeId` below.
      */
     function neighboursFor(columnTasks, dragId, index) {
       const rest = (columnTasks || []).filter((t) => t.id !== dragId)
@@ -42,13 +41,11 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Порядок задач внутри колонки.
+     * Task ordering within a column.
      *
-     * `manual` — как прислал сервер: ручной порядок плюс живое вперёд.
-     * `old`/`new` сортируют по дате заведения, но НЕ ломают ни группировку по
-     * проектам, ни «живое вперёд»: карточки переставляются внутри своего
-     * проекта, а идущая работа остаётся наверху группы. Иначе заголовки
-     * проектов пришлось бы рисовать над каждой карточкой.
+     * `manual` — server-provided order: manual order with active tasks on top.
+     * `old`/`new` sort by creation date while preserving project grouping
+     * and "active work first".
      */
     function sortTasks(tasks, order) {
       const list = tasks || []
@@ -71,21 +68,18 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Карточки одной сессии: номер и общее число.
+     * Session task batch progress: sequence index and total count.
      *
-     * Пять карточек, запущенных пачкой, выглядят несвязанными, и очередь
-     * понятна только тому, кто её запускал, и только пока помнит. Порядок тот
-     * же, в каком агент их берёт: идущая первой, дальше по времени постановки.
+     * Orders matching the agent execution order: active task first,
+     * followed by queue time.
      *
-     * @returns {Object<string, {at: number, total: number}>} по идентификатору задачи
+     * @returns {Object<string, {at: number, total: number}>} keyed by task id
      */
     /**
-     * Применить одно действие ко всем отмеченным.
+     * Apply a single batch action across all selected tasks.
      *
-     * Отдельного группового маршрута не заводим: это те же действия, что для
-     * одной задачи. Отказ части не срывает остальные — задачи независимы, — но
-     * и не съедается молча: итог называется числом, иначе человек останется
-     * уверен, что в архиве десять карточек, а их там семь.
+     * Failures on individual tasks do not abort remaining tasks;
+     * completed count is reported to the user.
      *
      * @returns {Promise<{done: number, failed: number}>}
      */
@@ -99,12 +93,10 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Чем запускали в прошлый раз, на эту доску.
+     * Remembered launch settings in browser localStorage.
      *
-     * Живёт у человека в браузере, а не в настройках плагина: это привычка
-     * одного, а не свойство доски. Хранилище может быть недоступно (закрытое
-     * окно, запрет на данные сайта) — тогда просто нечего вспомнить, и окно
-     * запуска обязано открыться как обычно.
+     * Stored per user browser rather than plugin settings. Handles storage
+     * errors gracefully if localStorage is disabled or restricted.
      */
     const RECALL_KEY = 'dsh-kanban:launch:'
 
@@ -123,13 +115,11 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Подставить запомненное, но только то, что ядро всё ещё предлагает.
+     * Re-apply remembered preset only if still available in active runtime.
      *
-     * Исчезнувший из сборки уровень доступа или профиль подставлять нельзя:
-     * задача пошла бы не с теми правами или не собралась бы вовсе. Тогда
-     * возвращаемся к тому, что предлагает харнесс.
+     * Avoids applying obsolete profiles or permission ranks removed from the build.
      *
-     * @param {Array<string>} known допустимые значения
+     * @param {Array<string>} known valid choices
      */
     function stillOffered(value, known, fallback) {
       return typeof value === 'string' && (known || []).indexOf(value) >= 0 ? value : fallback
@@ -153,11 +143,10 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Разложить колонку по ответственным.
+     * Group column tasks by assignee.
      *
-     * Группа «никто» идёт первой: свободные задачи — то, ради чего в эту
-     * раскладку и заглядывают. Дальше по алфавиту, чтобы порядок не плясал от
-     * того, кто первым попался в списке.
+     * Unassigned group ('Nobody') is placed first to highlight available work,
+     * followed alphabetically by assignee username.
      *
      * @returns {Array<{who: string, tasks: object[]}>}
      */
@@ -180,13 +169,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Проект и номер задачи РАЗДЕЛЬНО.
+     * Project repository and issue number rendered separately.
      *
-     * Слипшиеся, они читаются как один непонятный идентификатор, а это две
-     * разные вещи: имя проекта — принадлежность, номер — адрес.
-     *
-     * Номер становится ссылкой на issue: чаще всего она нужна именно с
-     * карточки, а раньше пряталась в окне задачи.
+     * Issue number links directly to the remote issue.
      */
     function taskRef(task, t) {
       if (!task || !task.repo) return null
@@ -218,11 +203,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Короткая строка плана для карточки: «3 из 7 · пишу тесты».
+     * Compact plan summary line for card badge: "3 of 7 · writing tests".
      *
-     * План из одного пункта и план из двадцати выглядят одинаково, потому что
-     * на карточку едут только числа и текущий пункт; сам список остаётся в
-     * окне задачи.
+     * Only progress numbers and current item description are shown on cards.
      */
     function planLine(task, t) {
       const progress = task && task.plan && task.plan.progress
@@ -232,10 +215,7 @@ window.__ModuleLoader__.load({
       return progress.text ? counter + ' · ' + progress.text : counter
     }
 
-    /**
-     * Подпись состояния. Ожидание рисуется отдельной точкой и здесь молчит,
-     * иначе одно и то же сказано дважды.
-     */
+    /** Status badge text. Waiting indicator is rendered separately. */
     function stateLabel(task, t) {
       const state = task && task.state
       if (state === 'running') return t('state.running')
@@ -244,14 +224,13 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Свёрнута ли колонка.
+     * Determine whether column is collapsed.
      *
-     * Пустая сжимается сама: шесть колонок по 220 пикселей не помещаются на
-     * ноутбуке. Ручное решение человека сильнее автоматики в обе стороны —
-     * иначе развёрнутая пустая колонка схлопывалась бы у него на глазах.
+     * Empty columns collapse automatically to save horizontal space;
+     * explicit user toggle overrides automatic behavior.
      *
-     * @param {object} column колонка из ответа доски
-     * @param {object} manual карта id -> явное решение человека
+     * @param {object} column column data from board response
+     * @param {object} manual map of column id -> boolean user preference
      */
     function isCollapsed(column, manual) {
       const own = manual && manual[column.id]
@@ -260,12 +239,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Относительное время одной строкой: «5 мин», «3 ч», «3 дня».
+     * Relative elapsed time string: "5m", "3h", "3d".
      *
-     * Разбор на единицу и число делает сервер незачем — правило простое и без
-     * настроек, а лишний круг данных дороже пяти строк здесь. Абсолютную дату
-     * отдаём подсказкой при наведении: точная дата требует чтения и сравнения
-     * с сегодняшним числом, а на доску смотрят ради скорости.
+     * Computed client-side with full ISO timestamp displayed on hover tooltip.
      */
     function agoText(now, then, t) {
       if (typeof then !== 'number' || then <= 0) return ''
@@ -278,7 +254,7 @@ window.__ModuleLoader__.load({
       return t('time.day', { n: Math.floor(hours / 24) })
     }
 
-    /** Дата без времени: «26 авг». Год добавляем, только когда он не нынешний. */
+    /** Date formatted without time. Year is included only when not the current year. */
     function shortDate(then) {
       if (typeof then !== 'number' || then <= 0) return ''
       try {
@@ -290,17 +266,16 @@ window.__ModuleLoader__.load({
       } catch { return '' }
     }
 
-    /** Абсолютная дата для подсказки. Нечитаемая отметка — пустая подсказка. */
+    /** Exact timestamp for tooltip. Empty tooltip if timestamp is invalid. */
     function exactAt(then) {
       if (typeof then !== 'number' || then <= 0) return ''
       try { return new Date(then).toLocaleString() } catch { return '' }
     }
 
     /**
-     * Что сказать о сверке.
+     * Sync telemetry status message.
      *
-     * Доска, переставшая обновляться, не имеет права молчать: отличить
-     * «ничего не изменилось» от «мы ослепли» иначе нечем.
+     * Alerts user when synchronization has halted or encountered errors.
      *
      * @returns {{tone: 'ok'|'bad'|'idle', text: string, title: string}}
      */
@@ -329,13 +304,11 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Каким цветом писать поверх фона метки.
+     * Accessible text color over label background color.
      *
-     * Считаем воспринимаемую яркость и выбираем чёрный либо белый — так же
-     * делает сам Gitea. Без этого `priority/low` на светло-зелёном становится
-     * нечитаемой, а `type/security` на тёмно-красном сливается.
+     * Computes perceived brightness and picks black or white accordingly.
      *
-     * @param {string} hex шесть шестнадцатеричных цифр без решётки
+     * @param {string} hex 6-character hex code without '#'
      */
     function readableOn(hex) {
       const n = parseInt(String(hex || ''), 16)
@@ -347,11 +320,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Цвет полосы срочности слева на карточке.
+     * Color accent stripe on left border of card for priority.
      *
-     * Только `priority`: полоса одна, и отдавать её первой попавшейся метке
-     * нельзя. Задача без срочности остаётся без полосы, а не получает серую —
-     * пустая полоса читалась бы как «низкий приоритет», а это неправда.
+     * Only applies to `priority/*` labels. Tasks without priority display no stripe.
      */
     function priorityColor(task) {
       const values = (task && task.facets && task.facets.priority) || []
@@ -362,7 +333,7 @@ window.__ModuleLoader__.load({
       return ''
     }
 
-    /** Стиль метки. Без цвета — прежний нейтральный вид, а не чёрный прямоугольник. */
+    /** Tag style helper. Neutral style when color is not defined. */
     function tagStyle(task, name) {
       const hex = task && task.labelColors ? task.labelColors[name] : undefined
       if (!hex) return undefined
@@ -370,12 +341,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Отрисовать разобранное тело задачи.
+     * Render parsed task body tree safely using React elements.
      *
-     * Собираем ЭЛЕМЕНТАМИ, а не строкой HTML. Тело пишет кто угодно, и
-     * `dangerouslySetInnerHTML` здесь означал бы выполнение чужого кода в
-     * интерфейсе владельца. При сборке элементами подстановка невозможна по
-     * построению — не потому, что кто-то не забыл про экранирование.
+     * Constructs DOM elements rather than using dangerouslySetInnerHTML to prevent XSS.
      */
     function renderSpans(spans, keyBase) {
       return (spans || []).map((span, i) => {
@@ -418,18 +386,12 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Подпись пространства меток.
+     * Label namespace display title.
      *
-     * Ключа нет — показываем имя как есть. Это не пропуск, а решение: набор
-     * меток в Gitea меняют без нас, и подставлять свой перевод новому
-     * пространству значило бы врать о том, чего мы не знаем.
+     * Falls back to raw namespace name when no translation key exists.
      */
     /**
-     * Название колонки: своё, если задано в настройках, иначе переведённое.
-     *
-     * Настройка одна на все колонки — парами `идентификатор=Название` через
-     * запятую. Шесть отдельных полей ради переименования, которое делают раз в
-     * жизни, засорили бы карточку настроек сильнее, чем помогли.
+     * Column title: custom override if configured, otherwise localized default.
      */
     function columnTitle(col, t) {
       const own = col && col.name
@@ -443,11 +405,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Название доски.
+     * Board title.
      *
-     * Заведённые нами `main` и `simple` переводим по идентификатору: их
-     * названия лежат в базе на одном языке и на другом интерфейсе остались бы
-     * чужими. Переименованную человеком доску не трогаем — это его слово.
+     * Default 'main' and 'simple' boards use localized titles; custom board names are preserved verbatim.
      */
     function boardTitle(board, t) {
       const key = 'boardName.' + (board && board.id)
@@ -474,18 +434,14 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /** Отбор по репозиторию стоит в одном ряду с метками; имя должно совпадать с сервером. */
+    /** Repository facet filter key matching backend dimension. */
     const REPO_FACET = 'repo'
 
     /**
-     * Подходит ли задача под выбранное.
-     *
-     * Между пространствами — И, внутри пространства — ИЛИ: срочность у задачи
-     * одна, и «И» внутри пространства всегда давало бы пусто.
+     * Check whether task matches active facet filters.
      *
-     * Метки уже разобраны сервером и приезжают в `task.facets`. Разбирать их
-     * здесь во второй раз значило бы завести вторую правду о том, где кончается
-     * пространство и начинается значение.
+     * AND across namespaces, OR within each namespace.
+     * Uses pre-parsed task.facets from server response.
      */
     function matchesFilters(task, selected) {
       const keys = Object.keys(selected || {})
@@ -500,14 +456,14 @@ window.__ModuleLoader__.load({
       return true
     }
 
-    /** Выбрано ли что-нибудь: пустой набор доску не сужает. */
+    /** True if any filter is active. */
     function anySelected(selected) {
       const keys = Object.keys(selected || {})
       for (const ns of keys) if ((selected[ns] || []).length > 0) return true
       return false
     }
 
-    /** Переключить значение. Новая карта, а не правка на месте: иначе React не перерисует. */
+    /** Toggle filter value, returning a new map for React immutability. */
     function toggleValue(selected, ns, value) {
       const current = (selected || {})[ns] || []
       const next = current.indexOf(value) >= 0
@@ -519,10 +475,7 @@ window.__ModuleLoader__.load({
       return out
     }
 
-    /**
-     * Человеческая причина отказа. Пустой список без объяснения читается как
-     * «issue нет», и человек идёт искать несуществующую проблему.
-     */
+    /** Human-readable explanation for empty state or error. */
     function errorKey(error) {
       switch (error) {
         case 'gitea-absent': return 'error.giteaAbsent'
@@ -539,13 +492,9 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Открыть чат поднятой сессии.
-     *
-     * Служба сессий берётся через `get`, а не объявляется в `inject`: если её в
-     * сборке не окажется, доска обязана сказать об этом человеку, а не
-     * отказаться загружаться целиком.
+     * Open session conversation in chat panel.
      *
-     * @returns {boolean} удалось ли открыть
+     * @returns {boolean} true if session opened successfully
      */
     function openSession(ctx, sessionId) {
       if (!sessionId) return false
@@ -559,10 +508,7 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /**
-     * Подпись репозитория в списке: имя и сколько в нём открытых задач.
-     * Архивный помечается словом, а не только положением в списке.
-     */
+    /** Repository option label with open issue count; marks archived repositories. */
     function repoOption(r, t) {
       const full = r.fullName || ((r.owner || '') + '/' + (r.repo || ''))
       const parts = [full]
@@ -571,12 +517,7 @@ window.__ModuleLoader__.load({
       return parts.join(' ')
     }
 
-    /**
-     * Разобрать `владелец/репозиторий` в пару.
-     *
-     * Владельца отдельным полем не спрашиваем: он однозначно следует из
-     * выбранного репозитория, а лишнее поле — лишний способ ошибиться.
-     */
+    /** Parse 'owner/repo' string into separate parts. */
     function splitFullName(fullName) {
       const parts = String(fullName || '').split('/')
       if (parts.length !== 2 || parts[0] === '' || parts[1] === '') return undefined
@@ -584,10 +525,7 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Отбор карточек по строке поиска: заголовок, репозиторий, номер issue.
-     *
-     * Фильтр держится на стороне браузера намеренно: доска и так вся в памяти,
-     * а поход на сервер за каждой буквой сделал бы набор дёрганым.
+     * Filter cards by client-side text search query: title, repo, issue number.
      */
     function matchesQuery(task, query) {
       const needle = String(query || '').trim().toLowerCase()
@@ -601,10 +539,7 @@ window.__ModuleLoader__.load({
       return hay.indexOf(needle) >= 0
     }
 
-    /**
-     * Идентификатор сессии для чипа. Ядро отдаёт его либо свойством, либо
-     * через useSession — берём первое, что есть.
-     */
+    /** Retrieve session ID for header chip. */
     function chipSessionId(props, session) {
       return String((props && props.sessionId) || (session && (session.sessionId || session.id)) || '').trim()
     }
@@ -2036,7 +1971,7 @@ window.__ModuleLoader__.load({
       return h('li', { className: 'dkb-card dkb-cardOpen' }, head, h('div', { className: 'dkb-body' }, body))
     }
 
-    /** Стрелка влево для кнопки возврата: 14x14, обводка цветом текста. */
+    /** Back button arrow icon: 14x14 stroke currentColor. */
     const BACK_ICON = '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor"'
       + ' stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">'
       + '<path d="M10 3.5 5.5 8l4.5 4.5"/></svg>'
@@ -2192,14 +2127,8 @@ window.__ModuleLoader__.load({
     })
 
     /**
-     * Чем запускать: профиль агента и уровень доступа.
-     *
-     * Одни и те же поля стоят и в окне задачи, и в окне пачки — пачка идёт
-     * ОДНОЙ сессией, значит и профиль с доступом у неё один. Две копии полей
-     * разошлись бы при первой правке.
-     *
-     * Пустого списка не бывает наполовину: службы у ядра необязательны, и если
-     * выбирать не из чего, поле не рисуется вовсе.
+     * Execution options: agent preset and permission rank.
+     * Shared across single-task and batch launch modals.
      */
     function LaunchFields(props) {
       const t = props.t
@@ -2483,10 +2412,7 @@ window.__ModuleLoader__.load({
       }, [load, t])
 
       /**
-       * Спросить о переносе и, получив согласие, выполнить его.
-       *
-       * Общая для мыши и для меню на карточке: путь другой, последствия те же,
-       * и разойтись им нельзя.
+       * Confirm and execute card move transition.
        */
       const askMove = React.useCallback((task, column, where) => {
         if (!task) return
@@ -4312,9 +4238,7 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Чип задачи в шапке чата. Большинство сессий подняты не с доски, и это
-     * штатное положение: тогда чип не рисуется вовсе. Пока ответ не пришёл,
-     * тоже ничего — мигающая заглушка в шапке хуже её отсутствия.
+     * Header task chip in chat conversation. Only rendered when session is linked to a task.
      */
     function TaskChip(props) {
       const t = props.t || fallbackT
@@ -4413,7 +4337,7 @@ window.__ModuleLoader__.load({
       + ' stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">'
       + '<rect x="2" y="2.5" width="12" height="11" rx="1.5"/><path d="M2 6.5h12M6.5 6.5v7"/></svg>'
 
-    /** Открыта ли доска. Крошечное хранилище: подписки нужны и строке, и экрану. */
+    /** Board visibility state manager. */
     /** @see helpers.createToggle */
     function createToggle() {
       let open = false
@@ -4427,12 +4351,12 @@ window.__ModuleLoader__.load({
           for (const fn of listeners) fn()
         },
         toggle() { this.set(!open) },
-        /** Открыть доску на конкретной задаче. */
+        /** Open board focused on a specific task. */
         show(taskId, boardId) {
           wanted = { id: String(taskId || ''), board: String(boardId || 'main') }
           if (open) { for (const fn of listeners) fn() } else this.set(true)
         },
-        /** Забрать просьбу. Читается один раз: повтор открывал бы окно снова. */
+        /** Consume requested focus task ID (cleared after first read). */
         takeWanted() {
           const asked = wanted
           wanted = undefined
@@ -4442,12 +4366,7 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /**
-     * Родная кнопка «Новая сессия».
-     *
-     * Отсеиваем узлы, у которых в классах есть `newSessionLabel`: это подпись
-     * внутри кнопки, а не сама кнопка.
-     */
+    /** Find native 'New Session' sidebar button. */
     function nativeButton() {
       const nodes = document.querySelectorAll('button[class*="newSession"]')
       for (const node of nodes) {
@@ -4457,11 +4376,7 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Кнопка доски: КЛОН родной кнопки со своими подписью и значком.
-     *
-     * Классы оболочки берутся у самой оболочки, а не переписываются у себя:
-     * повторять чужие стили руками — значит расходиться с ними при первом же
-     * обновлении интерфейса. Соседний плагин «Мастерская» поступает так же.
+     * Kanban entry button cloning native button styles to match host theme.
      */
     function createEntry(target, toggle, label) {
       const entry = target.cloneNode(true)
@@ -4491,7 +4406,7 @@ window.__ModuleLoader__.load({
       return entry
     }
 
-    /** Встать последней среди уже вставленных чужих кнопок, а не влезать между. */
+    /** Place button at end of injected extension entries. */
     function placeEntry(target, entry) {
       let anchor = target
       let next = target.nextElementSibling
@@ -4504,7 +4419,7 @@ window.__ModuleLoader__.load({
       return true
     }
 
-    /** Кнопка в боковой панели, переживающая перерисовку оболочки. */
+    /** Sidebar entry button persistent across shell re-renders. */
     function mountSidebarEntry(toggle, label) {
       if (typeof document === 'undefined') return () => {}
 
@@ -4538,7 +4453,7 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /** Экран доски поверх колонки разговора. */
+    /** Board overlay container mounted over conversation column. */
     function mountBoard(ctx, toggle) {
       if (typeof document === 'undefined') return () => {}
       let root
@@ -4597,15 +4512,9 @@ window.__ModuleLoader__.load({
 
 
     /**
-     * Зарегистрировать компонент в первый слот, который его примет.
-     *
-     * Имя слота в сборке подтвердить нельзя: строки слотов в собранном
-     * интерфейсе не литеральны. Регистрация в несуществующий слот проходит
-     * молча и без ошибки в журнале, поэтому единственный надёжный способ —
-     * перебрать кандидатов и запомнить, какой сработал. Соседний плагин
-     * dsh-gitea поступает так же со своей карточкой настроек.
+     * Register component into first available UI slot.
      *
-     * @returns {string|undefined} имя сработавшего слота
+     * @returns {string|undefined} name of successfully resolved slot
      */
     function registerFirst(ctx, candidates, component) {
       for (const entry of candidates) {