---
docgen:
  source: npm/rules/doc-files/js/units-js.mjs
  crc: 58b898cc
  score: 100
---

# units-js.mjs

## Огляд

Файл парсить програму, ітеруючи по її елементах для збору юнітів. Для кожної декларації визначається опис. Для функцій та класів збираються виклики інших юнітів через ребра викликів.

## Поведінка

1. Парсинг програми.
2. Ітерація по тілу програми.
3. Збір юнітів.
4. Для кожної декларації визначається опис.
5. Для функцій та класів збираються виклики інших юнітів.
6. Вибираються виклики інших юнітів з ребрами викликів.

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

extractUnitsJs — Юніт-шар для js/mjs/ts: top-level функції/класи/const-функції з тілом, JSDoc, прапором експорту і ребрами call-graph (виклики ІНШИХ юнітів у тілі).

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

- Read-only: файл не виконує операцій запису у файлову систему.
- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
- Не звертається до мережі.
