@makhmudov.kay/az-editor 0.1.0-beta.2 → 0.1.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +70 -70
  2. package/dist/az-editor.js +283 -208
  3. package/dist/library/hujjat/table-grid.d.ts +8 -0
  4. package/docs/integration.ru.md +896 -875
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -1,70 +1,70 @@
1
- # Az Editor
2
-
3
- React-библиотека для редактирования DOCX и HTML-документов с постраничным интерфейсом.
4
- Приложение управляет файлами, сохранением, авторизацией и подключением PDF-сервиса.
5
-
6
- **[Полное руководство по интеграции →](docs/integration.ru.md)**
7
-
8
- Установка, React + Vite, Next.js, DOCX, HTML-черновики, применение и отмена правок,
9
- переменные, JSON, PDF, шрифты, интерфейс, справочник API и устранение ошибок.
10
-
11
- ## Установка
12
-
13
- ```sh
14
- npm install @makhmudov.kay/az-editor@beta
15
- ```
16
-
17
- Для воспроизводимой установки опубликованной версии:
18
-
19
- ```sh
20
- npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.2
21
- ```
22
-
23
- Требуются React и React DOM 19, Node.js `^24.15.0 || >=26.0.0` для установки/сборки,
24
- браузерный сборщик с поддержкой CSS, шрифтов и WASM. Пакет — ESM с TypeScript-декларациями.
25
- Редактор работает в браузере; SSR компонента отключают.
26
-
27
- ## Минимальное подключение
28
-
29
- ```tsx
30
- import { AzDocumentEditor } from '@makhmudov.kay/az-editor';
31
- import '@makhmudov.kay/az-editor/styles.css';
32
-
33
- export function Editor() {
34
- return <AzDocumentEditor document="blank" title="document.docx" style={{ height: 700 }} />;
35
- }
36
- ```
37
-
38
- Для HTML используйте `AzHtmlEditor` с `initialHtml` и асинхронным `exportHtml()`.
39
- Открытие, сохранение и обработка ошибок подробно разобраны в [руководстве](docs/integration.ru.md).
40
-
41
- ## Примеры для копирования
42
-
43
- - [DOCX: открытие, сохранение, несохранённые правки](examples/integration/DocxEditorExample.tsx)
44
- - [HTML: форма и отдельный черновик](examples/integration/HtmlFormExample.tsx)
45
- - [HTML: применение, отмена и диагностика](examples/integration/HtmlDraft.tsx)
46
- - [Свой API и PDF-сервис](examples/integration/server-api.ts)
47
- - [Загрузка собственных шрифтов](examples/integration/loadFonts.ts)
48
-
49
- Это исходники для копирования в приложение, а не дополнительные экспорты npm-пакета.
50
-
51
- ## Разработка и сборка
52
-
53
- ```sh
54
- npm ci
55
- npm run dev
56
- npm run build
57
- npm pack
58
- ```
59
-
60
- Демо: `http://127.0.0.1:5173`. Сборка автономна. `npm pack` включает руководство,
61
- примеры, JS, CSS, типы и лицензии зависимостей.
62
-
63
- ## Ограничения и лицензия
64
-
65
- Внешний вид и переносы могут отличаться от Microsoft Word или серверного PDF.
66
- HTML поддерживает ограниченный набор тегов и стилей; потери возвращаются в диагностике.
67
- Подробности и лимиты — в [руководстве](docs/integration.ru.md).
68
-
69
- Собственный код: [UNLICENSED](LICENSE). Публичная доступность не предоставляет открытую
70
- лицензию. Лицензии зависимостей: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
1
+ # Az Editor
2
+
3
+ React-библиотека для редактирования DOCX и HTML-документов с постраничным интерфейсом.
4
+ Приложение управляет файлами, сохранением, авторизацией и подключением PDF-сервиса.
5
+
6
+ **[Полное руководство по интеграции →](docs/integration.ru.md)**
7
+
8
+ Установка, React + Vite, Next.js, DOCX, HTML-черновики, применение и отмена правок,
9
+ переменные, JSON, PDF, шрифты, интерфейс, справочник API и устранение ошибок.
10
+
11
+ ## Установка
12
+
13
+ ```sh
14
+ npm install @makhmudov.kay/az-editor@beta
15
+ ```
16
+
17
+ Для воспроизводимой установки опубликованной версии:
18
+
19
+ ```sh
20
+ npm install --save-exact @makhmudov.kay/az-editor@0.1.0-beta.3
21
+ ```
22
+
23
+ Требуются React и React DOM 19, Node.js `^24.15.0 || >=26.0.0` для установки/сборки,
24
+ браузерный сборщик с поддержкой CSS, шрифтов и WASM. Пакет — ESM с TypeScript-декларациями.
25
+ Редактор работает в браузере; SSR компонента отключают.
26
+
27
+ ## Минимальное подключение
28
+
29
+ ```tsx
30
+ import { AzDocumentEditor } from '@makhmudov.kay/az-editor';
31
+ import '@makhmudov.kay/az-editor/styles.css';
32
+
33
+ export function Editor() {
34
+ return <AzDocumentEditor document="blank" title="document.docx" style={{ height: 700 }} />;
35
+ }
36
+ ```
37
+
38
+ Для HTML используйте `AzHtmlEditor` с `initialHtml` и асинхронным `exportHtml()`.
39
+ Открытие, сохранение и обработка ошибок подробно разобраны в [руководстве](docs/integration.ru.md).
40
+
41
+ ## Примеры для копирования
42
+
43
+ - [DOCX: открытие, сохранение, несохранённые правки](examples/integration/DocxEditorExample.tsx)
44
+ - [HTML: форма и отдельный черновик](examples/integration/HtmlFormExample.tsx)
45
+ - [HTML: применение, отмена и диагностика](examples/integration/HtmlDraft.tsx)
46
+ - [Свой API и PDF-сервис](examples/integration/server-api.ts)
47
+ - [Загрузка собственных шрифтов](examples/integration/loadFonts.ts)
48
+
49
+ Это исходники для копирования в приложение, а не дополнительные экспорты npm-пакета.
50
+
51
+ ## Разработка и сборка
52
+
53
+ ```sh
54
+ npm ci
55
+ npm run dev
56
+ npm run build
57
+ npm pack
58
+ ```
59
+
60
+ Демо: `http://127.0.0.1:5173`. Сборка автономна. `npm pack` включает руководство,
61
+ примеры, JS, CSS, типы и лицензии зависимостей.
62
+
63
+ ## Ограничения и лицензия
64
+
65
+ Внешний вид и переносы могут отличаться от Microsoft Word или серверного PDF.
66
+ HTML поддерживает ограниченный набор тегов и стилей; потери возвращаются в диагностике.
67
+ Подробности и лимиты — в [руководстве](docs/integration.ru.md).
68
+
69
+ Собственный код: [UNLICENSED](LICENSE). Публичная доступность не предоставляет открытую
70
+ лицензию. Лицензии зависимостей: [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).