README.md

# react-ag-qeditor

> Made with create-react-library

[![NPM](https://img.shields.io/npm/v/react-ag-qeditor.svg)](https://www.npmjs.com/package/react-ag-qeditor) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

## Install

```bash
npm install --save git+https://gitlab.atma.company/lib/react-ag-qeditor.git
```

## Usage

```jsx
import React, { Component } from 'react'

import QEditor from 'react-ag-qeditor'
import 'react-ag-qeditor/dist/index.css'

class Example extends Component {
  render() {
    return <QEditor />
  }
}
```

## License

MIT © [atma](https://github.com/atma)

## Сборка пакета

Собранный `dist/` в репозиторий не коммитится — он появляется на установке
через `prepare` → `microbundle-crl`. Отсюда требование к воспроизводимости:
у двух разработчиков должен получаться один и тот же файл.

```
node    >= 18   (проверено на 22)
yarn    1.x
```

```sh
yarn install --frozen-lockfile
yarn build     # microbundle-crl --no-compress --format modern,cjs --css-modules false
```

Версии всего, что влияет на СОДЕРЖИМОЕ сборки — `microbundle-crl`, `@babel/core`,
`@babel/preset-env`, `@babel/plugin-syntax-object-rest-spread`, `npm-run-all` —
закреплены точно, без `^`. Остальные devDependencies (линтеры, gh-pages)
на результат не влияют и оставлены диапазонами.

**Проверка воспроизводимости** — сравнить хеши после чистой установки:

```sh
shasum -a 256 dist/index.css dist/index.js
```

28.08.2026 сборка, выполненная yarn при установке в AtmaGuru, и локальная
сборка дали побайтово одинаковые `index.css` и `index.js`.

## Грабли

**Никогда не запускайте `yarn add` с рабочим каталогом внутри ЭТОГО
репозитория.** Пакет пропишется в собственные `dependencies`, и установка
в проект начнёт зависать: yarn при разрешении дерева тянет пакет, находит его
же в его зависимостях и уходит по кругу. Двадцать минут на 95% CPU, потом
убитый процесс. Так уже было 28.08.2026, коммит 073acec.

Признак — строка с собственным именем в `dependencies`. Проверка после
установки в проекте:

```sh
grep -o 'resolved "git+[^"]*"' yarn.lock | grep qeditor
```