---
docgen:
  source: npm/scripts/lib/timing-summary.mjs
  crc: f21a9b91
---

# timing-summary.mjs

## Огляд

Цей файл генерує табличне резюме часу виконання для команд `fix` та `lint`, які використовуються в orchestrator. Він підсумовує час виконання окремих правил та скриптів linting, надаючи інформацію для аналізу продуктивності. Результат представлений у вигляді рядка, який можна вивести для відображення користувачеві.

## Поведінка

formatDurationMs: Перетворює мілісекунди на рядок у форматі `<ціла>.<десята>s`.
formatTimingSummary: Формує таблицю-резюме часу виконання з масиву записів, виводячи їх у текстовому форматі.

## Публічний API

- formatDurationMs — Форматує значення тривалості в форматі `<сек>.<десята>с`. Округлення виконується вниз (floor), щоб забезпечити консистентність результатів незалежно від платформи.
- formatTimingSummary — Створює багаторядковий текст у форматі таблиці-резюме для виведення в консоль (stdout).

## Гарантії поведінки

❌ Якщо `ok` дорівнює `false`, повертає `null`.
❌ Якщо час виконання перевищує 5 секунд, повертає `null`.
Повертає рядок, що містить таблицю з часом виконання.
Час виконання виражається у форматі `<ціла>.<десята>s`.
Повертає рядок з символом `\n` в кінці.
Не використовує кешування.
