---
type: JS Module
title: main.mjs
resource: npm/rules/doc-files/docgen-extract/main.mjs
docgen:
  crc: 1b240028
  model: omlx/gemma-4-e4b-it-OptiQ-4bit
  score: 100
  issues: judge:inaccurate:0.99
  judgeModel: openai-codex/gpt-5.4-mini
---

## Огляд

Екстрагує факти за допомогою функції `extractFacts`, звертаючись до мережі та використовуючи кешування в межах одного прогону. При цьому ігнорує каталоги, такі як `.github`, `.git`, `node_modules`, `base/`, `ua/` та `.firebase`.

## Поведінка

1. Аналізує вміст коду для створення детального набору фактів про файл.
2. Визначає словник і визначає, чи є код написаний на JavaScript, TypeScript або TypeScript (ESM).
3. Витягує загальний опис файлу, якщо він присутній у верхньому блоці коментарів.
4. Визначає всі функції, які є публічно доступними (експортованими), разом із їхніми описами та параметрами.
5. Класифікує імпорти на внутрішні, сторонні (npm) та вбудовані (stdlib).
6. Визначає, чи є код:
   - Стійким до винятків (catchesErrors).
   - Здатним працювати без доступу до мережі (readOnly).
   - Використовуючи механізми кешування (caches).
   - Згодом повертаючи хибні значення у випадку помилки (returnsFalsyOnFail).
7. Ігнорує шляхи, що відповідають шаблонам: .github, .git, node_modules, base/, ua/, .firebase.

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

extractFacts — витягує з коду файлу список значущих тверджень (фактів).

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

- Кешує результати в межах одного прогону.
- Свідомо пропускає шляхи: `.github`, `.git`, `node_modules`, `base/`, `ua/`, `.firebase`.
